feat: Add OrgSocialStrategy for Org Social network support

[tanrax]

Implements a new strategy to post messages to Org Social, a decentralized social network based on Org Mode files over HTTP.

Configuration:

• vfile: Virtual file URL with authentication token
• publicUrl: Public URL of the social.org file
• host: Optional Org Social Host instance (defaults to host.org-social.org)

All tests passing

[nzakas]

Thanks for the contribution. Please provide some documentation around Org Social and its API so I can review.

[tanrax]

@nzakas

Endpoint: POST /signup

Request:

curl -X POST https://host.org-social.org/signup \
  -H "Content-Type: application/json" \
  -d '{"nick": "your-nickname"}'

Response (Success):

{
  "type": "Success",
  "errors": [],
  "data": {
    "vfile": "http://host.org-social.org/vfile?token=YOUR_TOKEN&ts=TIMESTAMP&sig=SIGNATURE",
    "public-url": "http://host.org-social.org/your-nickname/social.org"
  }
}

Response (Error):

{
  "type": "Error",
  "errors": ["Nickname already exists"]
}

2. Upload/Update File

Endpoint: POST /upload

Request:

curl -X POST https://host.org-social.org/upload \
  -F "vfile=http://host.org-social.org/vfile?token=..." \
  -F "[email protected]"

Response (Success):

{
  "type": "Success",
  "errors": [],
  "data": {
    "message": "File uploaded successfully",
    "public-url": "http://host.org-social.org/your-nickname/social.org"
  }
}

3. Delete File

Endpoint: POST /delete

Request:

curl -X POST https://host.org-social.org/delete \
  -F "vfile=http://host.org-social.org/vfile?token=..."

4. Public Routes

Endpoint: GET /public-routes

Lists all active hosted files for community discovery.

How This Implementation Works

The OrgSocialStrategy class implements the following workflow:

1. Download: Fetches the current social.org file from the user's publicUrl (or creates a minimal template if it
   doesn't exist yet)
2. Insert Post: Appends the new post at the end of the file after the * Posts heading with:
   - Unique RFC 3339 timestamp ID (waits if duplicate exists)
   - Post content in Org Mode format
   - Proper spacing (first post: no blank line, subsequent posts: one blank line)
3. Upload: Sends the updated file to the host using the authenticated vfile URL via multipart/form-data

Authentication: The vfile URL contains a token, timestamp, and signature that authenticate the user. This is kept private and never shared.

Public Access: The publicUrl is the public, shareable URL where anyone can read the user's posts.

Testing

All tests are passing with 100% coverage:

• Unit tests for post insertion logic (orgsocial-insert.test.js)
• Integration tests with mocked HTTP requests (orgsocial.test.js)
• Tests for error handling, abort signals, and edge cases

References

• Org Social Specification: https://github.com/tanrax/org-social
• Org Social Host: https://github.com/tanrax/org-social-host
• Community Instance: https://org-social.org/social.org
• Official Host: https://host.org-social.org

Let me know if you need any clarification or would like me to add more documentation!