openwork/services/openwork-share

OpenWork Share Service (Publisher)

This is a tiny publisher service for OpenWork "share link" bundles.

It is designed to be deployed on Vercel and backed by Vercel Blob.

Endpoints

• POST /v1/bundles

  • Accepts JSON bundle payloads.
  • Stores bytes in Vercel Blob.
  • Returns { "url": "https://share.openwork.software/b/<id>" }.

• GET /b/:id

  • Proxies the stored object back to the caller.

Required Environment Variables

• BLOB_READ_WRITE_TOKEN
  • Vercel Blob token with read/write permissions.

Optional Environment Variables

• PUBLIC_BASE_URL

  • Default: https://share.openwork.software
  • Used to construct the returned share URL.

• MAX_BYTES

  • Default: 5242880 (5MB)
  • Hard upload limit.

Local development

This repo is intended for Vercel deployment. For local testing you can use:

cd services/openwork-share
pnpm install
vercel dev

Notes

• Links are public and unguessable (no auth, no encryption).
• Do not publish secrets in bundles.