gazetta 0.6.0 → 0.8.0

package/dist/dep-sidecars.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Reverse-rooted dependency sidecars — per-edge zero-byte index for
+ * "which items depend on this target?" queries.
+ *
+ * Shape:
+ *   `{root}/.gazetta/{relation-root}/{target}/{encoded-source-item}`
+ *
+ * Where:
+ *   - `{relation-root}` is the directory name for the relationship kind
+ *      (e.g. `asset-refs`, `fragment-deps`)
+ *   - `{target}` is the depended-upon name (asset name, fragment name, …),
+ *      slashes encoded via `encodeRefName`
+ *   - `{encoded-source-item}` is `pages.{name}` or `fragments.{name}`,
+ *      with `/` → `.` and an optional `:locale` suffix for locale variants
+ *
+ * Files are zero bytes. Existence is the index.
+ *
+ * Why per-edge sidecars over an aggregate JSON file:
+ *   - Multi-instance correctness: two admin instances saving different
+ *     items both adding refs to `hero` write to *different paths*. No
+ *     race, no optimistic concurrency, no retry. Granularity solves the
+ *     write-contention problem an aggregate JSON would face.
+ *   - Pattern consistency: matches the existing `.gazetta/` namespace
+ *     for runtime-never-served metadata.
+ *   - Self-sufficient targets: same shape on source AND target so any
+ *     target promoted to source is immediately usable.
+ *
+ * Single responsibility: filename encoding + per-target directory I/O.
+ * Save handlers, publish flow, and reindex CLI compose this with their
+ * own walks.
+ */
+import type { ContentRoot } from './content-root.js';
+/**
+ * Loose manifest shape for `extract` callers. Page/fragment manifests
+ * (with their inline-component descendants) all satisfy this. Avoids
+ * coupling the generic dep-sidecar module to a specific manifest type.
+ */
+export type ManifestLike = {
+    readonly template?: string;
+    readonly content?: Record<string, unknown>;
+    readonly components?: readonly unknown[];
+};
+/**
+ * One kind of reverse dependency: a domain-specific extractor + the
+ * directory under `.gazetta/` where its sidecars live.
+ *
+ * Each shipping relation is a module-level constant (see
+ * `assets/asset-deps.ts`, `fragment-deps.ts`). Add a new relation by
+ * declaring another constant; this module needs no changes.
+ */
+export interface DepRelation {
+    /** Directory name under `.gazetta/`, e.g. `asset-refs`, `fragment-deps`. */
+    readonly rootName: string;
+    /**
+     * Extract the set of target names this manifest depends on. Pure;
+     * implementations must not perform I/O.
+     *
+     * Examples:
+     *   - asset-refs: walks content for `_asset` refs
+     *   - fragment-deps: walks components for `@fragment` refs
+     *   - template-deps (if added): emits the manifest's `template` field
+     */
+    readonly extract: (manifest: ManifestLike) => Set<string>;
+}
+/**
+ * Identity of a depending item. Distinct entries for each locale variant
+ * (per design-media.md → i18n: "Each referencing manifest, including
+ * locale variants, is a separate entry").
+ */
+export interface ItemRef {
+    source: 'page' | 'fragment';
+    /** Bare item name, e.g. `home` or `blog/[slug]`. */
+    name: string;
+    /** Locale code for locale variants; absent for the default-locale manifest. */
+    locale?: string;
+}
+/**
+ * Encode an `ItemRef` into a sidecar filename.
+ *   { source: 'page', name: 'home' } → 'pages.home'
+ *   { source: 'page', name: 'blog/[slug]' } → 'pages.blog.[slug]'
+ *   { source: 'fragment', name: 'header', locale: 'fr' } → 'fragments.header:fr'
+ */
+export declare function itemRefToFilename(ref: ItemRef): string;
+/**
+ * Parse a sidecar filename back to an `ItemRef`. Returns null for any
+ * filename that doesn't match the encoding shape so unrelated files
+ * accidentally placed in the directory don't poison reads.
+ */
+export declare function filenameToItemRef(filename: string): ItemRef | null;
+/** Directory path for one target's sidecars under a relation. */
+export declare function depDir(rel: DepRelation, contentRoot: ContentRoot, targetName: string): string;
+/** Path of one sidecar file inside its target's directory. */
+export declare function depSidecarPath(rel: DepRelation, contentRoot: ContentRoot, targetName: string, item: ItemRef): string;
+/**
+ * Read all `ItemRef`s currently sidecar-indexed for `targetName`.
+ * Returns empty when the directory is missing (no deps, or freshly-
+ * created site).
+ */
+export declare function readDepsFor(rel: DepRelation, contentRoot: ContentRoot, targetName: string): Promise<ItemRef[]>;
+/**
+ * Apply the diff for one item's deps in this relation.
+ *
+ * For each target in `oldTargets ∪ newTargets`:
+ *   - If new and not old → write the sidecar file (creating the target dir)
+ *   - If old and not new → remove the sidecar file
+ *   - If both or neither → no I/O
+ *
+ * Sidecar writes are idempotent (zero-byte files at fixed paths), so
+ * concurrent writes from multiple admin instances converge to the same
+ * final state. The diff is per (item × target): each instance's save
+ * updates only the sidecars for the item it just wrote.
+ */
+export declare function applyDepDiff(rel: DepRelation, contentRoot: ContentRoot, item: ItemRef, oldTargets: ReadonlySet<string>, newTargets: ReadonlySet<string>): Promise<void>;
+/**
+ * Rebuild the deps sidecars for one item by diffing old vs new manifest
+ * via the relation's `extract` function.
+ *
+ * Use cases:
+ *   - Save handler: pass `oldManifest` (loaded for history-recording);
+ *     module re-extracts both old and new dep sets.
+ *   - Reindex CLI: pass `oldManifest = null` to write fresh sidecars
+ *     for every dep the item now references.
+ *   - Delete handler: pass `newManifest = null` to tear down all this
+ *     item's sidecars in this relation.
+ */
+export declare function rebuildItemDeps(rel: DepRelation, contentRoot: ContentRoot, item: ItemRef, oldManifest: ManifestLike | null, newManifest: ManifestLike | null): Promise<void>;
+//# sourceMappingURL=dep-sidecars.d.ts.map

package/dist/dep-sidecars.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dep-sidecars.d.ts","sourceRoot":"","sources":["../src/dep-sidecars.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAGpD;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC1C,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,OAAO,EAAE,CAAA;CACzC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW;IAC1B,4EAA4E;IAC5E,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB;;;;;;;;OAQG;IACH,QAAQ,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,GAAG,CAAC,MAAM,CAAC,CAAA;CAC1D;AAED;;;;GAIG;AACH,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,MAAM,GAAG,UAAU,CAAA;IAC3B,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAA;IACZ,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAKtD;AAID;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CASlE;AAED,iEAAiE;AACjE,wBAAgB,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAE7F;AAED,8DAA8D;AAC9D,wBAAgB,cAAc,CAAC,GAAG,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAEpH;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAiBpH;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,WAAW,EAChB,WAAW,EAAE,WAAW,EACxB,IAAI,EAAE,OAAO,EACb,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,EAC/B,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,GAC9B,OAAO,CAAC,IAAI,CAAC,CAWf;AAgBD;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,WAAW,EAChB,WAAW,EAAE,WAAW,EACxB,IAAI,EAAE,OAAO,EACb,WAAW,EAAE,YAAY,GAAG,IAAI,EAChC,WAAW,EAAE,YAAY,GAAG,IAAI,GAC/B,OAAO,CAAC,IAAI,CAAC,CAIf"}

package/dist/dep-sidecars.js

@@ -0,0 +1,122 @@
+import { encodeRefName } from './hash.js';
+/**
+ * Encode an `ItemRef` into a sidecar filename.
+ *   { source: 'page', name: 'home' } → 'pages.home'
+ *   { source: 'page', name: 'blog/[slug]' } → 'pages.blog.[slug]'
+ *   { source: 'fragment', name: 'header', locale: 'fr' } → 'fragments.header:fr'
+ */
+export function itemRefToFilename(ref) {
+    const prefix = ref.source === 'page' ? 'pages' : 'fragments';
+    const encodedName = encodeRefName(ref.name);
+    const base = `${prefix}.${encodedName}`;
+    return ref.locale ? `${base}:${ref.locale}` : base;
+}
+const FILENAME_RE = /^(pages|fragments)\.(.+?)(?::([a-z]{2}(?:-[a-z]+)?))?$/;
+/**
+ * Parse a sidecar filename back to an `ItemRef`. Returns null for any
+ * filename that doesn't match the encoding shape so unrelated files
+ * accidentally placed in the directory don't poison reads.
+ */
+export function filenameToItemRef(filename) {
+    const m = FILENAME_RE.exec(filename);
+    if (!m)
+        return null;
+    const source = m[1] === 'pages' ? 'page' : 'fragment';
+    // Decode `.` → `/` to recover the original name. encodeRefName rejects
+    // dots in input, so this is unambiguous: every `.` came from a slash.
+    const name = m[2].replace(/\./g, '/');
+    const locale = m[3];
+    return locale ? { source, name, locale } : { source, name };
+}
+/** Directory path for one target's sidecars under a relation. */
+export function depDir(rel, contentRoot, targetName) {
+    return contentRoot.path('.gazetta', rel.rootName, encodeRefName(targetName));
+}
+/** Path of one sidecar file inside its target's directory. */
+export function depSidecarPath(rel, contentRoot, targetName, item) {
+    return contentRoot.path('.gazetta', rel.rootName, encodeRefName(targetName), itemRefToFilename(item));
+}
+/**
+ * Read all `ItemRef`s currently sidecar-indexed for `targetName`.
+ * Returns empty when the directory is missing (no deps, or freshly-
+ * created site).
+ */
+export async function readDepsFor(rel, contentRoot, targetName) {
+    const dir = depDir(rel, contentRoot, targetName);
+    let entries;
+    try {
+        entries = await contentRoot.storage.readDir(dir);
+    }
+    catch {
+        // Missing directory — treat as no deps. Storage providers vary in
+        // exact error shape, so we accept any read failure here.
+        return [];
+    }
+    const refs = [];
+    for (const entry of entries) {
+        if (entry.isDirectory)
+            continue;
+        const ref = filenameToItemRef(entry.name);
+        if (ref)
+            refs.push(ref);
+    }
+    return refs;
+}
+/**
+ * Apply the diff for one item's deps in this relation.
+ *
+ * For each target in `oldTargets ∪ newTargets`:
+ *   - If new and not old → write the sidecar file (creating the target dir)
+ *   - If old and not new → remove the sidecar file
+ *   - If both or neither → no I/O
+ *
+ * Sidecar writes are idempotent (zero-byte files at fixed paths), so
+ * concurrent writes from multiple admin instances converge to the same
+ * final state. The diff is per (item × target): each instance's save
+ * updates only the sidecars for the item it just wrote.
+ */
+export async function applyDepDiff(rel, contentRoot, item, oldTargets, newTargets) {
+    const added = [];
+    const removed = [];
+    for (const t of newTargets)
+        if (!oldTargets.has(t))
+            added.push(t);
+    for (const t of oldTargets)
+        if (!newTargets.has(t))
+            removed.push(t);
+    // Adds first — order doesn't affect correctness, but adds-before-removes
+    // means a transient observer mid-update sees a superset of refs (safe
+    // for delete-blocking) rather than a subset.
+    await Promise.all(added.map(target => writeSidecar(rel, contentRoot, target, item)));
+    await Promise.all(removed.map(target => removeSidecar(rel, contentRoot, target, item)));
+}
+async function writeSidecar(rel, contentRoot, target, item) {
+    const dir = depDir(rel, contentRoot, target);
+    await contentRoot.storage.mkdir(dir).catch(() => {
+        // Already exists — fine.
+    });
+    await contentRoot.storage.writeFile(depSidecarPath(rel, contentRoot, target, item), '');
+}
+async function removeSidecar(rel, contentRoot, target, item) {
+    await contentRoot.storage.rm(depSidecarPath(rel, contentRoot, target, item)).catch(() => {
+        // Already gone — fine. rm is idempotent for our purposes.
+    });
+}
+/**
+ * Rebuild the deps sidecars for one item by diffing old vs new manifest
+ * via the relation's `extract` function.
+ *
+ * Use cases:
+ *   - Save handler: pass `oldManifest` (loaded for history-recording);
+ *     module re-extracts both old and new dep sets.
+ *   - Reindex CLI: pass `oldManifest = null` to write fresh sidecars
+ *     for every dep the item now references.
+ *   - Delete handler: pass `newManifest = null` to tear down all this
+ *     item's sidecars in this relation.
+ */
+export async function rebuildItemDeps(rel, contentRoot, item, oldManifest, newManifest) {
+    const oldTargets = oldManifest ? rel.extract(oldManifest) : new Set();
+    const newTargets = newManifest ? rel.extract(newManifest) : new Set();
+    await applyDepDiff(rel, contentRoot, item, oldTargets, newTargets);
+}
+//# sourceMappingURL=dep-sidecars.js.map

package/dist/dep-sidecars.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dep-sidecars.js","sourceRoot":"","sources":["../src/dep-sidecars.ts"],"names":[],"mappings":"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"}

package/dist/deploy/cloudflare-workers.d.ts

@@ -0,0 +1,46 @@
+import type { WorkerCapableDeployAdapter } from './types.js';
+export interface CloudflareWorkersDeployOptions {
+    /** Cloudflare API token with Workers Scripts:Edit + R2 Read:Bucket permissions. */
+    apiToken: string;
+    /** Cloudflare account ID. */
+    accountId: string;
+    /** Worker name (also used as the workers.dev subdomain). */
+    name: string;
+    /** R2 bucket name the worker reads from at request time. */
+    bucket: string;
+}
+interface WranglerTomlInput {
+    name: string;
+    bucket: string;
+    siteUrl: string | undefined;
+}
+/**
+ * Render the wrangler.toml content. Pure function; unit-testable
+ * without mocking fs.
+ */
+export declare function renderWranglerToml(input: WranglerTomlInput): string;
+/**
+ * Render the worker entry-point code. Pure function. The
+ * `cloudflare-r2` adapter at `packages/gazetta/src/workers/` provides
+ * the actual request-handling logic; the entry is a thin re-export.
+ */
+export declare function renderWorkerEntry(): string;
+/**
+ * Extract the deployed URL from wrangler stdout. Pure function.
+ *
+ * Wrangler 4.x stdout opens with a telemetry banner URL pointing at
+ * github.com/cloudflare/workers-sdk; the actual deploy URL appears
+ * later as either:
+ *   - `*.workers.dev` — the default subdomain when `workers_dev = true`
+ *   - the route domain from `[[routes]]` in wrangler.toml (the
+ *     operator's `target.siteUrl`)
+ *
+ * Strategy: prefer the configured siteUrl when present in stdout
+ * (deploys with a custom route surface it as part of the "Published"
+ * line); otherwise pick the first `*.workers.dev` URL; fall through
+ * to the first non-github URL.
+ */
+export declare function extractDeployUrl(stdout: string, siteUrl: string | undefined): string | undefined;
+export declare function cloudflareWorkersDeploy(opts: CloudflareWorkersDeployOptions): WorkerCapableDeployAdapter;
+export {};
+//# sourceMappingURL=cloudflare-workers.d.ts.map

package/dist/deploy/cloudflare-workers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudflare-workers.d.ts","sourceRoot":"","sources":["../../src/deploy/cloudflare-workers.ts"],"names":[],"mappings":"AAmDA,OAAO,KAAK,EAIV,0BAA0B,EAE3B,MAAM,YAAY,CAAA;AAQnB,MAAM,WAAW,8BAA8B;IAC7C,mFAAmF;IACnF,QAAQ,EAAE,MAAM,CAAA;IAChB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAA;IACZ,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAA;CACf;AAED,UAAU,iBAAiB;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;CAC5B;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAmBnE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAiBhG;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,8BAA8B,GAAG,0BAA0B,CAwHxG"}

package/dist/deploy/cloudflare-workers.js

@@ -0,0 +1,213 @@
+/**
+ * Cloudflare Workers deploy adapter (Cut 3 of #203).
+ *
+ * Refactors the hardcoded `gazetta deploy` flow at
+ * `cli/index.ts:1230-1314` into a Pattern 1 Provider factory.
+ *
+ * Operator usage:
+ * ```ts
+ * import { defineSite, r2Storage, cloudflareWorkersDeploy } from 'gazetta'
+ *
+ * defineSite({
+ *   targets: {
+ *     production: {
+ *       type: 'dynamic',
+ *       storage: r2Storage({...}),
+ *       deploy: cloudflareWorkersDeploy({
+ *         apiToken: process.env.CLOUDFLARE_API_TOKEN!,
+ *         accountId: process.env.CLOUDFLARE_ACCOUNT_ID!,
+ *         name: 'my-site',
+ *         bucket: 'my-site',
+ *       }),
+ *     },
+ *   },
+ * })
+ * ```
+ *
+ * # WorkerCapableDeployAdapter
+ *
+ * Implements the capability extension: `workerRuntimeConfig()`
+ * returns the R2 binding metadata `gazetta build` needs.
+ *
+ * # supports
+ *
+ * `['dynamic']` in v1 — matches today's `TargetType = 'static' |
+ * 'dynamic'` enum where `'dynamic'` plays the ESI role per
+ * `getType()` semantics. Widens to `['esi']` when
+ * `design-rendering.md` Cut 1 splits the enum into three. Future
+ * `dynamic` (CF Workers + Node/Bun origin) deferred to v2.
+ *
+ * # SOLID
+ *
+ *   - SRP: adapter owns Cloudflare Workers deploy mechanics only;
+ *     pure helpers (renderWranglerToml, renderWorkerEntry) are
+ *     unit-testable independently.
+ *   - DIP: CLI depends on `WorkerCapableDeployAdapter` interface,
+ *     not on this factory directly. Future CF Pages + Functions
+ *     adapter substitutes through the same contract.
+ */
+import { execSync } from 'node:child_process';
+import { mkdir, rm, writeFile } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+import { DeployAuthError, DeployConfigError, DeployTransportError } from './errors.js';
+const ADAPTER_NAME = 'cloudflare-workers';
+const BUCKET_BINDING = 'SITE_BUCKET';
+const COMPAT_DATE = '2024-12-01';
+/**
+ * Render the wrangler.toml content. Pure function; unit-testable
+ * without mocking fs.
+ */
+export function renderWranglerToml(input) {
+    const { name, bucket, siteUrl } = input;
+    let out = `name = "${name}"\n` +
+        `main = "index.ts"\n` +
+        `compatibility_date = "${COMPAT_DATE}"\n` +
+        `workers_dev = true\n` +
+        `\n` +
+        `[[r2_buckets]]\n` +
+        `binding = "${BUCKET_BINDING}"\n` +
+        `bucket_name = "${bucket}"\n`;
+    if (siteUrl) {
+        const url = new URL(siteUrl);
+        const hostname = url.hostname;
+        out += `\n[[routes]]\npattern = "${hostname}/*"\nzone_name = "${hostname}"\n`;
+    }
+    return out;
+}
+/**
+ * Render the worker entry-point code. Pure function. The
+ * `cloudflare-r2` adapter at `packages/gazetta/src/workers/` provides
+ * the actual request-handling logic; the entry is a thin re-export.
+ */
+export function renderWorkerEntry() {
+    return `import { createWorker } from 'gazetta/workers/cloudflare-r2'\nexport default createWorker()\n`;
+}
+/**
+ * Extract the deployed URL from wrangler stdout. Pure function.
+ *
+ * Wrangler 4.x stdout opens with a telemetry banner URL pointing at
+ * github.com/cloudflare/workers-sdk; the actual deploy URL appears
+ * later as either:
+ *   - `*.workers.dev` — the default subdomain when `workers_dev = true`
+ *   - the route domain from `[[routes]]` in wrangler.toml (the
+ *     operator's `target.siteUrl`)
+ *
+ * Strategy: prefer the configured siteUrl when present in stdout
+ * (deploys with a custom route surface it as part of the "Published"
+ * line); otherwise pick the first `*.workers.dev` URL; fall through
+ * to the first non-github URL.
+ */
+export function extractDeployUrl(stdout, siteUrl) {
+    const urls = stdout.match(/https:\/\/[^\s]+/g) ?? [];
+    if (urls.length === 0)
+        return undefined;
+    // Strip trailing punctuation that often follows URLs in logs.
+    const clean = (u) => u.replace(/[.,;:!?)]+$/, '');
+    if (siteUrl) {
+        const hit = urls.map(clean).find(u => u.startsWith(siteUrl));
+        if (hit)
+            return hit;
+    }
+    const workersDev = urls.map(clean).find(u => /\.workers\.dev/.test(u));
+    if (workersDev)
+        return workersDev;
+    const nonGithub = urls.map(clean).find(u => !u.startsWith('https://github.com/'));
+    return nonGithub;
+}
+export function cloudflareWorkersDeploy(opts) {
+    // Construction-time validation per Q7 lock: factories validate
+    // operator-supplied input synchronously. Bad credentials surface
+    // at execute() as DeployAuthError, not here.
+    if (!opts.apiToken) {
+        throw new DeployConfigError('cloudflareWorkersDeploy requires `apiToken` (e.g., process.env.CLOUDFLARE_API_TOKEN)', ADAPTER_NAME);
+    }
+    if (!opts.accountId) {
+        throw new DeployConfigError('cloudflareWorkersDeploy requires `accountId` (e.g., process.env.CLOUDFLARE_ACCOUNT_ID)', ADAPTER_NAME);
+    }
+    if (!opts.name) {
+        throw new DeployConfigError('cloudflareWorkersDeploy requires `name` — the worker name + workers.dev subdomain', ADAPTER_NAME);
+    }
+    if (!opts.bucket) {
+        throw new DeployConfigError('cloudflareWorkersDeploy requires `bucket` — the R2 bucket the worker reads from', ADAPTER_NAME);
+    }
+    const { apiToken, accountId, name: workerName, bucket } = opts;
+    return {
+        name: ADAPTER_NAME,
+        // `TargetType` today is `'static' | 'dynamic'`; `'dynamic'` plays
+        // the ESI role per current `getType()` semantics. Widens to
+        // `['esi']` when design-rendering.md Cut 1 splits the enum.
+        supports: ['dynamic'],
+        workerRuntimeConfig() {
+            return {
+                bucketBinding: BUCKET_BINDING,
+                // Routes computed lazily from target.siteUrl at deploy time —
+                // not at config-eval. `gazetta build` reads the binding name
+                // here; the actual route pattern lands in wrangler.toml at
+                // deploy time via renderWranglerToml().
+            };
+        },
+        validate(_ctx) {
+            // No cross-field invariants in v1 beyond the construction-time
+            // checks above. Reserved for future operator-input validation
+            // (e.g., warn when target.siteUrl protocol is `http:`).
+            return [];
+        },
+        async execute(ctx) {
+            const { target, logger, signal } = ctx;
+            const tmpDir = join(process.cwd(), '.gazetta-deploy');
+            await rm(tmpDir, { recursive: true, force: true });
+            await mkdir(tmpDir, { recursive: true });
+            try {
+                const tomlBody = renderWranglerToml({
+                    name: workerName,
+                    bucket,
+                    siteUrl: target.siteUrl,
+                });
+                await writeFile(join(tmpDir, 'wrangler.toml'), tomlBody);
+                await writeFile(join(tmpDir, 'index.ts'), renderWorkerEntry());
+                await writeFile(join(tmpDir, 'package.json'), JSON.stringify({ type: 'module', dependencies: { gazetta: '*', hono: '*' } }));
+                if (signal.aborted)
+                    throw new DeployTransportError('Deploy aborted by signal', ADAPTER_NAME);
+                logger.info({ workerName, bucket }, 'Deploying worker to Cloudflare');
+                // Resolve the gazetta package install root for --install-links.
+                // import.meta.dirname is two levels above (src/deploy/).
+                const gazettaRoot = resolve(import.meta.dirname, '../..');
+                execSync(`npm install --install-links ${gazettaRoot}`, { cwd: tmpDir, stdio: 'pipe' });
+                if (signal.aborted)
+                    throw new DeployTransportError('Deploy aborted by signal', ADAPTER_NAME);
+                // Wrangler reads CLOUDFLARE_API_TOKEN + CLOUDFLARE_ACCOUNT_ID
+                // from env per its own convention; pass through.
+                const wranglerOut = execSync('npx wrangler deploy', {
+                    cwd: tmpDir,
+                    stdio: 'pipe',
+                    env: { ...process.env, CLOUDFLARE_API_TOKEN: apiToken, CLOUDFLARE_ACCOUNT_ID: accountId },
+                }).toString();
+                // Wrangler 4.x stdout opens with a telemetry banner pointing at
+                // github.com/cloudflare/workers-sdk; the actual deploy URL is
+                // either `*.workers.dev` (default subdomain) or the route domain
+                // from wrangler.toml. Prefer those over any other URL.
+                const url = extractDeployUrl(wranglerOut, target.siteUrl);
+                logger.info({ workerName, url }, 'Worker deployed');
+                return {
+                    url,
+                    details: { wranglerOutput: wranglerOut },
+                };
+            }
+            catch (err) {
+                if (err instanceof DeployTransportError)
+                    throw err;
+                const stderr = err.stderr?.toString() ?? err.message;
+                // Heuristic: wrangler exits with auth-related messages when
+                // the token is bad. Distinguish auth vs transport here.
+                if (/authentication|unauthorized|invalid token/i.test(stderr)) {
+                    throw new DeployAuthError(`Cloudflare rejected credentials: ${stderr}`, ADAPTER_NAME);
+                }
+                throw new DeployTransportError(`Wrangler deploy failed: ${stderr}`, ADAPTER_NAME);
+            }
+            finally {
+                await rm(tmpDir, { recursive: true, force: true });
+            }
+        },
+    };
+}
+//# sourceMappingURL=cloudflare-workers.js.map

package/dist/deploy/cloudflare-workers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudflare-workers.js","sourceRoot":"","sources":["../../src/deploy/cloudflare-workers.ts"],"names":[],"mappings":"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"}

package/dist/deploy/errors.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Error taxonomy for the DeployAdapter Pattern 1 Provider surface.
+ *
+ * Cut 1 of the deploy contract. Per ADR-0004 Universal Provider
+ * Requirement #6 ("independent error taxonomy"), every Provider
+ * surface declares its own error classes for runtime branching.
+ *
+ * Adapters translate platform-SDK errors into these classes; the CLI
+ * catches `DeployError` and surfaces the `adapter` field plus a
+ * human-readable message. Debug logs include the underlying cause.
+ *
+ * Reference: `.claude/rules/design-deploy.md` "Error taxonomy" section.
+ */
+/**
+ * Base class for all deploy errors. Carries the adapter name so the
+ * CLI can surface "Cloudflare Workers deploy failed: ..." instead of
+ * a context-free error message.
+ */
+export declare class DeployError extends Error {
+    readonly adapter: string;
+    constructor(message: string, adapter: string);
+}
+/**
+ * Raised at factory construction (synchronous) when operator-supplied
+ * options are missing required fields or malformed. Surfaces in the
+ * IDE / at admin boot, not at deploy time.
+ *
+ * Example: `cloudflareWorkersDeploy({ name: 'foo' })` without
+ * `apiToken` throws `DeployConfigError` because the platform SDK
+ * can't proceed without credentials.
+ */
+export declare class DeployConfigError extends DeployError {
+    constructor(message: string, adapter: string);
+}
+/**
+ * Raised at `execute()` time when the platform rejects credentials.
+ * Adapters wrap platform-SDK auth failures (401 / 403 from the
+ * platform's API) in this class so operators see a consistent
+ * "credentials rejected" surface regardless of which platform.
+ */
+export declare class DeployAuthError extends DeployError {
+    constructor(message: string, adapter: string);
+}
+/**
+ * Raised at `execute()` time when the network or platform SDK call
+ * fails for transport reasons (timeout, DNS, 5xx from platform,
+ * unexpected protocol error). Distinct from auth failures because
+ * the operator's remediation differs: auth = check credentials;
+ * transport = retry or investigate platform status.
+ */
+export declare class DeployTransportError extends DeployError {
+    constructor(message: string, adapter: string);
+}
+/**
+ * Raised at `execute()` time when the adapter expects published
+ * content (e.g., a static-host adapter that reads from
+ * `target.storage`) but storage is empty.
+ *
+ * Per Q4 lock: the CLI doesn't gate on prior publish — adapters that
+ * need bytes surface this error themselves. Operator's remediation
+ * is `gazetta publish <target>` before retrying `gazetta deploy`.
+ */
+export declare class DeployContentError extends DeployError {
+    constructor(message: string, adapter: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/deploy/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/deploy/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;;GAIG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACpC,SAAgB,OAAO,EAAE,MAAM,CAAA;gBAEnB,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK7C;AAED;;;;;;;;GAQG;AACH,qBAAa,iBAAkB,SAAQ,WAAW;gBACpC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAI7C;AAED;;;;;GAKG;AACH,qBAAa,eAAgB,SAAQ,WAAW;gBAClC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAI7C;AAED;;;;;;GAMG;AACH,qBAAa,oBAAqB,SAAQ,WAAW;gBACvC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAI7C;AAED;;;;;;;;GAQG;AACH,qBAAa,kBAAmB,SAAQ,WAAW;gBACrC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAI7C"}