@lockzero/vercel-integration

@lockzero/vercel-integration

Vercel Integration that syncs secrets from your LockZero vault directly into Vercel environment variables.

How it works

• User installs the integration from the Vercel marketplace.
• They provide their LockZero API key and the namespaces they want to sync.
• The integration fetches all credentials from each namespace and upserts them as Vercel environment variables on the configured project(s).
• A webhook listener keeps variables in sync when configuration changes.

Development

npm install
npm run build
npm start

Environment variables required at runtime:

Variable	Description
VERCEL_CLIENT_ID	Your integration's Client ID from Vercel
VERCEL_CLIENT_SECRET	Your integration's Client Secret from Vercel
VERCEL_REDIRECT_URI	OAuth redirect URI registered with Vercel
PORT	Port to listen on (default: 3000)

Submitting to the Vercel Marketplace

• Create an integration at https://vercel.com/dashboard/integrations/create
• Set:
  • Redirect URL: https://your-host/api/callback
  • Webhook URL: https://your-host/api/webhook
  • Scopes: read-write:environment-variables
• Upload vercel-integration.json as your integration configuration.
• Deploy this package to a public URL (Vercel, Railway, Render, etc.).
• Submit for review at https://vercel.com/integrations

Manual sync via API

curl -X POST https://your-host/api/sync \
  -H "Content-Type: application/json" \
  -d '{
    "lzApiKey":    "lz_live_...",
    "vercelToken": "your-vercel-token",
    "projectId":   "prj_...",
    "namespaces":  ["openai", "stripe"],
    "target":      "production"
  }'

Response:

{ "synced": 12, "errors": [] }