Lau 22 document storage port

[t1ffnyw]

Summary

• Introduce a provider-neutral storage port with canonical ObjectRef identities and targeted adapters for S3, Vercel Blob, UploadThing, database storage, and in-memory testing.
• Add the complete storage-deletion lifecycle: manifest/lineage tracking, coordinated and batched deletion, retries, tombstones, serve-gating, tenant checks, status/inventory APIs, rollout flags, and admin UI.
• Harden adapter/location identity handling and migrate upload/read paths to the storage port while preserving legacy URL compatibility.

Related

LAU-22 — Document storage port

Checklist

• pnpm check passes (lint + typecheck)
• pnpm --filter @launchstack/web test passes
• Changeset added (packages/core/ changed; changeset still needed)
• New env vars documented in .env.example and apps/web/src/env.ts
• UI changes exercised in a browser
• Docs updated if behavior changed

Testing

• pnpm --filter @launchstack/web typecheck
• Targeted Jest verification: 8 suites, 98 tests passed
• Verified adapter routing, database behavior, deletion outcomes, Adeu storage-port reads, and legacy URL promotion.
• Confirmed no production imports of fetchBlob or isPrivateBlobUrl remain outside the legacy module.

Notes for reviewers

• Database get(ref) intentionally uses authenticated internal HTTP through /api/files/{id} and requires APP_PUBLIC_URL.
• Legacy fetchFile(url) remains as a compatibility shim.
• A7 legacy backfill remains deferred.
• Full repository checks and browser-based UI verification still need to be run.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
launch-stack	Error		Aug 23, 2026 11:33pm
pdr-ai-v2	Error		Aug 23, 2026 11:33pm