@elytracms/studio 0.0.13 → 0.0.15

package/convex/publishing.ts

@@ -1,108 +0,0 @@
-import { makeFunctionReference } from 'convex/server'
-import { v } from 'convex/values'
-import { mutation, query } from './functions'
-import type { MutationCtx } from './functions'
-import { requireRole } from './guard'
-import { maintainGraphPublishedReferences } from './referenceMaintenance'
-
-// EC-223: the studio's convex functions are package-shipped and deployment-agnostic
-// — they address each other by STRING ref (resolved against the consumer's deployment),
-// never the per-deployment `_generated/api`. Mirrors the lib's `queryRef`/`actionRef`.
-const webhooksDeliver = makeFunctionReference<'action'>('webhooks:deliver')
-
-/**
- * Publishing state (EC-045). Single-environment (EC-179, vision AD-8): a
- * deployment IS one environment, so there is exactly ONE publishingState row —
- * see `env-is-deployment-boundary`.
- */
-
-/**
- * EC-180 / EC-146 — fire the host revalidation webhook on a publish-state change.
- *
- * A mutation cannot `fetch`, so we hand off to the `webhooks.deliver` internal
- * action (it signs + POSTs server-side; the secret never leaves Convex). A graph
- * publish/unpublish can affect any page, so the honest v1 invalidation is the
- * whole-project sweep tag `p:<scope>:project` — a mirror of
- * `projectSweepWebhookTag` (`src/lib/webhooks/tags.ts`) / `@elytracms/next`'s
- * `projectSweepTag`; the tests on those two sides pin the literal.
- *
- * `scope` must equal the host's `cache.scope` (its `ELYTRA_PROJECT_ID`) for the
- * tag to match what the host stamped on its cached fetches; it comes from the
- * `CANVAS_PROJECT_SCOPE` Convex env var. Unconfigured deployments (local dev,
- * no env) are a silent no-op — publishing must never depend on a reachable host.
- */
-async function scheduleRevalidate(
-  ctx: MutationCtx,
-  event: 'publishing.publish' | 'publishing.unpublish',
-): Promise<void> {
-  const env =
-    (globalThis as { process?: { env?: Record<string, string | undefined> } }).process?.env ?? {}
-  const scope = env['CANVAS_PROJECT_SCOPE']
-  if (!scope) return
-  await ctx.scheduler.runAfter(0, webhooksDeliver, {
-    projectId: scope,
-    event,
-    tags: [`p:${scope}:project`],
-  })
-}
-
-export const publish = mutation({
-  args: {
-    revisionId: v.string(),
-    revision: v.number(),
-    publishedAt: v.string(),
-  },
-  handler: async (ctx, args) => {
-    await requireRole(ctx, 'editor') // EC-150
-    const existing = await ctx.db.query('publishingState').first()
-    const record = {
-      status: 'published' as const,
-      publishedRevisionId: args.revisionId,
-      publishedRevision: args.revision,
-      publishedAt: args.publishedAt,
-      createdAt: existing?.createdAt ?? args.publishedAt,
-      updatedAt: args.publishedAt,
-    }
-    // EC-153 parity: republish preserves `createdAt`; return the stored record.
-    const id = existing ? existing._id : await ctx.db.insert('publishingState', record)
-    if (existing) await ctx.db.patch(existing._id, record)
-    // EC-277: the newly pinned revision becomes the published graph — reindex its
-    // published reference rows in-transaction (AD-6 "at the source").
-    await maintainGraphPublishedReferences(ctx)
-    // EC-180: drop the host's cached pages for this project (fire-and-forget).
-    await scheduleRevalidate(ctx, 'publishing.publish')
-    return ctx.db.get(id)
-  },
-})
-
-export const unpublish = mutation({
-  args: { updatedAt: v.string() },
-  handler: async (ctx, args) => {
-    await requireRole(ctx, 'editor') // EC-150
-    const existing = await ctx.db.query('publishingState').first()
-    if (!existing || existing.status !== 'published') {
-      throw new Error('invalid-transition: nothing is currently published')
-    }
-    await ctx.db.patch(existing._id, {
-      status: 'draft',
-      publishedRevisionId: undefined,
-      publishedRevision: undefined,
-      publishedAt: undefined,
-      updatedAt: args.updatedAt,
-    })
-    // EC-277: a graph going dark drops every published graph reference row.
-    await maintainGraphPublishedReferences(ctx)
-    // EC-180: a graph going dark must also drop the host's cached pages.
-    await scheduleRevalidate(ctx, 'publishing.unpublish')
-    // EC-153 parity: return the stored record (createdAt preserved).
-    return ctx.db.get(existing._id)
-  },
-})
-
-export const getState = query({
-  args: {},
-  handler: async (ctx) => {
-    await requireRole(ctx, 'viewer') // EC-150
-    return ctx.db.query('publishingState').first()
-  },
-})