@contentrail/publisher 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ContentRail contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,138 @@
-# Temporary Holding Version
+# `@contentrail/publisher`
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Server-only publishing engine for ContentRail.
+
+**Do not import from browser code.** Git tokens, R2 credentials and rebuild hook secrets stay in the host process (Worker, CI job, or private server).
+
+## Concepts
+
+| Term                | Meaning                                                       |
+| ------------------- | ------------------------------------------------------------- |
+| Publication request | Validated intent to publish entries for a site + collection   |
+| Publication version | Opaque version id activated after a successful provider write |
+| Provider revision   | Git commit SHA or R2 etag from the activation step            |
+| Rebuild             | Optional deploy hook — independent of publication success     |
+
+See ADR 013 in `docs/DECISIONS.md` for concurrency, retries, partial failure and rollback.
+
+## Requirements
+
+- Node.js **≥ 22** (server / CI / Worker host — not for browsers)
+- `@contentrail/core`
+
+## Install
+
+### Monorepo
+
+```sh
+pnpm install
+pnpm --filter @contentrail/publisher build
+```
+
+### From npm (upcoming `0.2.0` after authorized publish)
+
+```sh
+pnpm add @contentrail/core@0.2.0 @contentrail/publisher@0.2.0 zod@^4.6.7
+```
+
+## API
+
+```ts
+import { defineCollection } from "@contentrail/core";
+import {
+  createPublisher,
+  createGitPublishProvider,
+  createR2PublishProvider,
+  createRebuildHook,
+} from "@contentrail/publisher";
+import { z } from "zod";
+
+const articles = defineCollection({
+  name: "articles",
+  schema: z.object({
+    title: z.string().min(1),
+    slug: z.string().min(1),
+    published: z.boolean(),
+  }),
+});
+
+// Inject real clients in production. Examples/tests use memory fakes.
+const publisher = createPublisher({
+  provider: createR2PublishProvider({
+    client: r2Client,
+    keyPrefix: "sites",
+    hasCredential: Boolean(process.env.R2_ACCESS_KEY_ID),
+  }),
+  rebuild: createRebuildHook({
+    client: rebuildClient,
+    hasSecret: Boolean(process.env.REBUILD_HOOK_URL),
+  }),
+});
+
+const result = await publisher.publish({
+  siteId: "demo",
+  collection: articles,
+  expectedVersion: null, // first publish
+  entries: [
+    {
+      id: "welcome",
+      data: { title: "Welcome", slug: "welcome", published: true },
+    },
+  ],
+  idempotencyKey: "editor-save-1",
+});
+
+if (result.success) {
+  // Content is published. result.rebuild.state may still be "pending" or "failed".
+}
+```
+
+### Required `expectedVersion`
+
+Always pass the active version you read earlier, or `null` when none exists. Stale values throw `PublishConflictError`.
+
+### Providers
+
+#### Git (`createGitPublishProvider`)
+
+- Writes `{contentRoot}/{collection}/{id}.json`
+- Stores meta under `{contentRoot}/contentrail-meta/{siteId}/{collection}/meta.json`
+- Activation is a branch commit requiring the expected parent tip
+- Inject `GitRepositoryClient` (wrap GitHub/GitLab HTTP APIs yourself)
+
+Environment (example only — not committed secrets):
+
+```bash
+GITHUB_TOKEN=...          # server-only
+CONTENTRAIL_GIT_REPO=org/repo
+CONTENTRAIL_GIT_BRANCH=main
+```
+
+#### R2 (`createR2PublishProvider`)
+
+- Snapshot: `{prefix}/{siteId}/collections/{collection}/versions/{version}/...`
+- Pointer: `{prefix}/{siteId}/collections/{collection}/current.json`
+- Pointer uses conditional put (`if-match` / `if-none-match`)
+- Inject `ObjectStorageClient`
+
+```bash
+R2_ACCOUNT_ID=...
+R2_ACCESS_KEY_ID=...
+R2_SECRET_ACCESS_KEY=...
+R2_BUCKET=...
+```
+
+### Rebuild hooks
+
+`createRebuildHook` keeps the hook URL/secret server-side. A successful publish with `rebuild.state === "failed"` means **content was published** but the site rebuild was not confirmed.
+
+## Guarantees and limitations
+
+- Validated before write; no silent stale overwrites
+- No multi-object atomic transaction claim for Git or R2
+- Orphaned R2 snapshots may remain after a lost activation race
+- Tests use `createMemoryGitClient` / `createMemoryR2Client` — no live credentials
+
+## Auth
+
+Phase 3 does **not** implement authentication. Callers must only invoke this API from an already-trusted server context (Phase 4).

package/dist/engine.d.ts

@@ -0,0 +1,34 @@
+import { type ContentCollection } from "@contentrail/core";
+import type { ActiveContentSnapshot, PublishProvider, PublishRequest, PublishResult, PublicationSummary, RebuildStatus } from "./types.js";
+export interface ContentPublisher {
+    publish<TCollection extends ContentCollection>(request: PublishRequest<TCollection>): Promise<PublishResult>;
+    getStatus(siteId: string, collectionName: string): Promise<{
+        activeVersion: string | null;
+        versions: PublicationSummary[];
+    }>;
+    readActiveContent(siteId: string, collectionName: string): Promise<ActiveContentSnapshot | null>;
+    listVersions(siteId: string, collectionName: string): Promise<PublicationSummary[]>;
+    rollback(input: {
+        siteId: string;
+        collectionName: string;
+        targetVersion: string;
+        expectedVersion: string | null;
+        publicationId?: string;
+    }): Promise<PublishResult>;
+}
+export interface CreatePublisherOptions {
+    readonly provider: PublishProvider;
+    readonly rebuild?: {
+        trigger(input: {
+            siteId: string;
+            collection: string;
+            version: string;
+            publicationId: string;
+        }): Promise<RebuildStatus>;
+    };
+}
+/**
+ * Creates a server-only publisher that validates content then delegates to a provider.
+ */
+export declare function createPublisher(options: CreatePublisherOptions): ContentPublisher;
+//# sourceMappingURL=engine.d.ts.map

package/dist/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAAiB,MAAM,mBAAmB,CAAC;AAG1E,OAAO,KAAK,EACV,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,aAAa,EAEd,MAAM,YAAY,CAAC;AAOpB,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,WAAW,SAAS,iBAAiB,EAC3C,OAAO,EAAE,cAAc,CAAC,WAAW,CAAC,GACnC,OAAO,CAAC,aAAa,CAAC,CAAC;IAC1B,SAAS,CACP,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC;QAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,QAAQ,EAAE,kBAAkB,EAAE,CAAA;KAAE,CAAC,CAAC;IAC7E,iBAAiB,CACf,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAAC;IACzC,YAAY,CACV,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE;QACd,MAAM,EAAE,MAAM,CAAC;QACf,cAAc,EAAE,MAAM,CAAC;QACvB,aAAa,EAAE,MAAM,CAAC;QACtB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;QAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAC5B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE;QACjB,OAAO,CAAC,KAAK,EAAE;YACb,MAAM,EAAE,MAAM,CAAC;YACf,UAAU,EAAE,MAAM,CAAC;YACnB,OAAO,EAAE,MAAM,CAAC;YAChB,aAAa,EAAE,MAAM,CAAC;SACvB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;KAC5B,CAAC;CACH;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,sBAAsB,GAC9B,gBAAgB,CA6MlB"}

package/dist/engine.js

@@ -0,0 +1,196 @@
+import { validateEntry } from "@contentrail/core";
+import { PublishConflictError, PublishError } from "./errors.js";
+import { assertSafeSegment } from "./paths.js";
+import { createContentVersion, createPublicationId, publicationIdFromIdempotencyKey, } from "./version.js";
+/**
+ * Creates a server-only publisher that validates content then delegates to a provider.
+ */
+export function createPublisher(options) {
+    const { provider, rebuild } = options;
+    return {
+        async publish(request) {
+            const siteId = request.siteId;
+            const collection = request.collection;
+            assertSafeSegment(siteId, "site id");
+            assertSafeSegment(collection.name, "collection name");
+            if (!Array.isArray(request.entries) || request.entries.length === 0) {
+                throw new PublishError("VALIDATION", "Publish requests require a non-empty entries array.", { siteId, collection: collection.name });
+            }
+            if (!("expectedVersion" in request)) {
+                throw new PublishError("VALIDATION", 'Publish requests require "expectedVersion" (use null for the first publish).', { siteId, collection: collection.name });
+            }
+            const publicationId = createPublicationId(request.publicationId ??
+                (request.idempotencyKey !== undefined
+                    ? publicationIdFromIdempotencyKey(request.idempotencyKey)
+                    : undefined));
+            if (request.idempotencyKey !== undefined) {
+                const prior = await provider.readIdempotentResult(siteId, collection.name, request.idempotencyKey);
+                if (prior !== null) {
+                    return { ...prior, idempotentReplay: true };
+                }
+            }
+            const validated = validatePublishEntries(collection, request.entries, {
+                siteId,
+                publicationId,
+            });
+            const version = createContentVersion({
+                siteId,
+                collection: collection.name,
+                publicationId,
+                entries: validated,
+            });
+            if (request.idempotencyKey !== undefined) {
+                const recoveredEarly = await provider.recoverIdempotentPublish({
+                    siteId,
+                    collection: collection.name,
+                    idempotencyKey: request.idempotencyKey,
+                    publicationId,
+                    version,
+                });
+                if (recoveredEarly !== null) {
+                    return { ...recoveredEarly, idempotentReplay: true };
+                }
+            }
+            const activeVersion = await provider.getActiveVersion(siteId, collection.name);
+            if (activeVersion !== request.expectedVersion) {
+                if (request.idempotencyKey !== undefined) {
+                    const recovered = await provider.recoverIdempotentPublish({
+                        siteId,
+                        collection: collection.name,
+                        idempotencyKey: request.idempotencyKey,
+                        publicationId,
+                        version,
+                    });
+                    if (recovered !== null) {
+                        return { ...recovered, idempotentReplay: true };
+                    }
+                }
+                throw new PublishConflictError(`Stale expectedVersion for "${siteId}/${collection.name}": expected ${String(request.expectedVersion)}, current ${String(activeVersion)}.`, {
+                    siteId,
+                    collection: collection.name,
+                    publicationId,
+                    currentVersion: activeVersion,
+                    expectedVersion: request.expectedVersion,
+                });
+            }
+            let result;
+            try {
+                result = await provider.publishSnapshot({
+                    siteId,
+                    collection: collection.name,
+                    publicationId,
+                    version,
+                    previousVersion: activeVersion,
+                    expectedVersion: request.expectedVersion,
+                    entries: validated,
+                    ...(request.message !== undefined
+                        ? { message: request.message }
+                        : {}),
+                    ...(request.idempotencyKey !== undefined
+                        ? { idempotencyKey: request.idempotencyKey }
+                        : {}),
+                });
+            }
+            catch (error) {
+                if (request.idempotencyKey !== undefined &&
+                    error instanceof PublishError &&
+                    (error.code === "CONFLICT" || error.code === "PARTIAL_FAILURE")) {
+                    const recovered = await provider.recoverIdempotentPublish({
+                        siteId,
+                        collection: collection.name,
+                        idempotencyKey: request.idempotencyKey,
+                        publicationId,
+                        version,
+                    });
+                    if (recovered !== null) {
+                        return { ...recovered, idempotentReplay: true };
+                    }
+                }
+                if (error instanceof PublishError) {
+                    throw error;
+                }
+                throw new PublishError("PROVIDER", `Provider publish failed for "${siteId}/${collection.name}".`, { siteId, collection: collection.name, publicationId, cause: error });
+            }
+            if (rebuild !== undefined) {
+                try {
+                    const rebuildStatus = await rebuild.trigger({
+                        siteId,
+                        collection: collection.name,
+                        version: result.version,
+                        publicationId: result.publicationId,
+                    });
+                    return { ...result, rebuild: rebuildStatus };
+                }
+                catch (error) {
+                    return {
+                        ...result,
+                        rebuild: {
+                            state: "failed",
+                            detail: error instanceof Error
+                                ? error.message
+                                : "Rebuild trigger failed after successful publication.",
+                        },
+                    };
+                }
+            }
+            return result;
+        },
+        async getStatus(siteId, collectionName) {
+            assertSafeSegment(siteId, "site id");
+            assertSafeSegment(collectionName, "collection name");
+            const activeVersion = await provider.getActiveVersion(siteId, collectionName);
+            const versions = await provider.listVersions(siteId, collectionName);
+            return { activeVersion, versions };
+        },
+        async readActiveContent(siteId, collectionName) {
+            assertSafeSegment(siteId, "site id");
+            assertSafeSegment(collectionName, "collection name");
+            return provider.readActiveContent(siteId, collectionName);
+        },
+        async listVersions(siteId, collectionName) {
+            assertSafeSegment(siteId, "site id");
+            assertSafeSegment(collectionName, "collection name");
+            return provider.listVersions(siteId, collectionName);
+        },
+        async rollback(input) {
+            assertSafeSegment(input.siteId, "site id");
+            assertSafeSegment(input.collectionName, "collection name");
+            assertSafeSegment(input.targetVersion, "target version");
+            const publicationId = createPublicationId(input.publicationId);
+            return provider.rollback({
+                siteId: input.siteId,
+                collection: input.collectionName,
+                targetVersion: input.targetVersion,
+                expectedVersion: input.expectedVersion,
+                publicationId,
+            });
+        },
+    };
+}
+function validatePublishEntries(collection, entries, context) {
+    const seen = new Set();
+    const validated = [];
+    for (const entry of entries) {
+        assertSafeSegment(entry.id, "entry id");
+        if (seen.has(entry.id)) {
+            throw new PublishError("VALIDATION", `Duplicate entry id "${entry.id}" in publish request.`, {
+                siteId: context.siteId,
+                collection: collection.name,
+                publicationId: context.publicationId,
+            });
+        }
+        seen.add(entry.id);
+        const result = validateEntry(collection, entry.data);
+        if (!result.success) {
+            throw new PublishError("VALIDATION", `Invalid content for entry "${entry.id}": ${result.error.message}`, {
+                siteId: context.siteId,
+                collection: collection.name,
+                publicationId: context.publicationId,
+                cause: result.error,
+            });
+        }
+        validated.push({ id: entry.id, data: result.data });
+    }
+    return validated;
+}
+//# sourceMappingURL=engine.js.map

package/dist/engine.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,28 @@
+export type PublishErrorCode = "VALIDATION" | "CONFLICT" | "PATH_ESCAPE" | "PROVIDER" | "PARTIAL_FAILURE" | "CREDENTIALS" | "NOT_FOUND" | "REBUILD";
+export declare class PublishError extends Error {
+    readonly code: PublishErrorCode;
+    readonly siteId?: string;
+    readonly collection?: string;
+    readonly publicationId?: string;
+    readonly currentVersion?: string | null;
+    readonly expectedVersion?: string | null;
+    constructor(code: PublishErrorCode, message: string, options?: {
+        siteId?: string;
+        collection?: string;
+        publicationId?: string;
+        currentVersion?: string | null;
+        expectedVersion?: string | null;
+        cause?: unknown;
+    });
+}
+export declare class PublishConflictError extends PublishError {
+    constructor(message: string, options?: {
+        siteId?: string;
+        collection?: string;
+        publicationId?: string;
+        currentVersion?: string | null;
+        expectedVersion?: string | null;
+        cause?: unknown;
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GACxB,YAAY,GACZ,UAAU,GACV,aAAa,GACb,UAAU,GACV,iBAAiB,GACjB,aAAa,GACb,WAAW,GACX,SAAS,CAAC;AAEd,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;gBAGvC,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QACP,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC/B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAChC,KAAK,CAAC,EAAE,OAAO,CAAC;KACZ;CAwBT;AAED,qBAAa,oBAAqB,SAAQ,YAAY;gBAElD,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QACP,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC/B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAChC,KAAK,CAAC,EAAE,OAAO,CAAC;KACZ;CAKT"}

package/dist/errors.js

@@ -0,0 +1,35 @@
+export class PublishError extends Error {
+    code;
+    siteId;
+    collection;
+    publicationId;
+    currentVersion;
+    expectedVersion;
+    constructor(code, message, options = {}) {
+        super(message, options.cause !== undefined ? { cause: options.cause } : undefined);
+        this.name = "PublishError";
+        this.code = code;
+        if (options.siteId !== undefined) {
+            this.siteId = options.siteId;
+        }
+        if (options.collection !== undefined) {
+            this.collection = options.collection;
+        }
+        if (options.publicationId !== undefined) {
+            this.publicationId = options.publicationId;
+        }
+        if (options.currentVersion !== undefined) {
+            this.currentVersion = options.currentVersion;
+        }
+        if (options.expectedVersion !== undefined) {
+            this.expectedVersion = options.expectedVersion;
+        }
+    }
+}
+export class PublishConflictError extends PublishError {
+    constructor(message, options = {}) {
+        super("CONFLICT", message, options);
+        this.name = "PublishConflictError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAUA,MAAM,OAAO,YAAa,SAAQ,KAAK;IAC5B,IAAI,CAAmB;IACvB,MAAM,CAAU;IAChB,UAAU,CAAU;IACpB,aAAa,CAAU;IACvB,cAAc,CAAiB;IAC/B,eAAe,CAAiB;IAEzC,YACE,IAAsB,EACtB,OAAe,EACf,UAOI,EAAE;QAEN,KAAK,CACH,OAAO,EACP,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CACnE,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC/B,CAAC;QACD,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YACrC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACvC,CAAC;QACD,IAAI,OAAO,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;YACxC,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;QAC7C,CAAC;QACD,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;YACzC,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;QAC/C,CAAC;QACD,IAAI,OAAO,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;YAC1C,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;QACjD,CAAC;IACH,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,YAAY;IACpD,YACE,OAAe,EACf,UAOI,EAAE;QAEN,KAAK,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF"}

package/dist/fakes/memory-git.d.ts

@@ -0,0 +1,12 @@
+import type { GitRepositoryClient } from "../providers/git-client.js";
+/**
+ * Deterministic in-memory Git repository for tests. No network. No credentials.
+ */
+export declare function createMemoryGitClient(options?: {
+    branch?: string;
+    failNextCommit?: "conflict" | "timeout" | null;
+}): GitRepositoryClient & {
+    setFailNextCommit(mode: "conflict" | "timeout" | null): void;
+    filesAtTip(): Record<string, string>;
+};
+//# sourceMappingURL=memory-git.d.ts.map

package/dist/fakes/memory-git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-git.d.ts","sourceRoot":"","sources":["../../src/fakes/memory-git.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtE;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,UAAU,GAAG,SAAS,GAAG,IAAI,CAAC;CAChD,GAAG,mBAAmB,GAAG;IACxB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,GAAG,IAAI,GAAG,IAAI,CAAC;IAC7D,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC,CAoDA"}

package/dist/fakes/memory-git.js

@@ -0,0 +1,56 @@
+import { createHash, randomUUID } from "node:crypto";
+/**
+ * Deterministic in-memory Git repository for tests. No network. No credentials.
+ */
+export function createMemoryGitClient(options) {
+    const branch = options?.branch ?? "main";
+    let tip = createHash("sha1").update("root").digest("hex");
+    const filesByCommit = new Map([[tip, {}]]);
+    let failNext = options?.failNextCommit ?? null;
+    return {
+        setFailNextCommit(mode) {
+            failNext = mode;
+        },
+        filesAtTip() {
+            return { ...(filesByCommit.get(tip) ?? {}) };
+        },
+        async getBranchTip(requested) {
+            if (requested !== branch) {
+                throw new Error(`Unknown branch ${requested}`);
+            }
+            return tip;
+        },
+        async readFile(path, ref) {
+            const tree = filesByCommit.get(ref);
+            if (tree === undefined) {
+                return null;
+            }
+            return tree[path] ?? null;
+        },
+        async commitFiles(input) {
+            if (input.branch !== branch) {
+                throw new Error(`Unknown branch ${input.branch}`);
+            }
+            if (failNext === "timeout") {
+                failNext = null;
+                throw new Error("timeout");
+            }
+            if (failNext === "conflict" || input.expectedParentSha !== tip) {
+                failNext = null;
+                throw new Error("CONFLICT");
+            }
+            const parent = filesByCommit.get(tip) ?? {};
+            const next = { ...parent };
+            for (const file of input.files) {
+                next[file.path] = file.content;
+            }
+            const commitSha = createHash("sha1")
+                .update(`${tip}:${randomUUID()}:${input.message}`)
+                .digest("hex");
+            filesByCommit.set(commitSha, next);
+            tip = commitSha;
+            return { commitSha, branch };
+        },
+    };
+}
+//# sourceMappingURL=memory-git.js.map

package/dist/fakes/memory-git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-git.js","sourceRoot":"","sources":["../../src/fakes/memory-git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGrD;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAGrC;IAIC,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,MAAM,CAAC;IACzC,IAAI,GAAG,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1D,MAAM,aAAa,GAAG,IAAI,GAAG,CAAiC,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3E,IAAI,QAAQ,GAAkC,OAAO,EAAE,cAAc,IAAI,IAAI,CAAC;IAE9E,OAAO;QACL,iBAAiB,CAAC,IAAI;YACpB,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;QACD,UAAU;YACR,OAAO,EAAE,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QAC/C,CAAC;QACD,KAAK,CAAC,YAAY,CAAC,SAAS;YAC1B,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CAAC,kBAAkB,SAAS,EAAE,CAAC,CAAC;YACjD,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC;QACD,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG;YACtB,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACpC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,OAAO,IAAI,CAAC;YACd,CAAC;YACD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;QAC5B,CAAC;QACD,KAAK,CAAC,WAAW,CAAC,KAAK;YACrB,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;gBAC5B,MAAM,IAAI,KAAK,CAAC,kBAAkB,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;YACpD,CAAC;YACD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,QAAQ,GAAG,IAAI,CAAC;gBAChB,MAAM,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC;YAC7B,CAAC;YACD,IAAI,QAAQ,KAAK,UAAU,IAAI,KAAK,CAAC,iBAAiB,KAAK,GAAG,EAAE,CAAC;gBAC/D,QAAQ,GAAG,IAAI,CAAC;gBAChB,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC;YAC9B,CAAC;YAED,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YAC5C,MAAM,IAAI,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;YAC3B,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBAC/B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;YACjC,CAAC;YACD,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC;iBACjC,MAAM,CAAC,GAAG,GAAG,IAAI,UAAU,EAAE,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;iBACjD,MAAM,CAAC,KAAK,CAAC,CAAC;YACjB,aAAa,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YACnC,GAAG,GAAG,SAAS,CAAC;YAChB,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;QAC/B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/fakes/memory-r2.d.ts

@@ -0,0 +1,12 @@
+import type { ObjectStorageClient } from "../providers/r2-client.js";
+/**
+ * In-memory object store with conditional put support for tests.
+ */
+export declare function createMemoryR2Client(options?: {
+    failNextPut?: "conflict" | "timeout" | "error" | null;
+    failOnKeyIncludes?: string;
+}): ObjectStorageClient & {
+    setFailNextPut(mode: "conflict" | "timeout" | "error" | null): void;
+    dump(): Record<string, string>;
+};
+//# sourceMappingURL=memory-r2.d.ts.map

package/dist/fakes/memory-r2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-r2.d.ts","sourceRoot":"","sources":["../../src/fakes/memory-r2.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAErE;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE;IAC7C,WAAW,CAAC,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,IAAI,CAAC;IACtD,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,GAAG,mBAAmB,GAAG;IACxB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,IAAI,GAAG,IAAI,CAAC;IACpE,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC,CA6DA"}

package/dist/fakes/memory-r2.js

@@ -0,0 +1,59 @@
+import { createHash, randomUUID } from "node:crypto";
+/**
+ * In-memory object store with conditional put support for tests.
+ */
+export function createMemoryR2Client(options) {
+    const objects = new Map();
+    let failNext = options?.failNextPut ?? null;
+    return {
+        setFailNextPut(mode) {
+            failNext = mode;
+        },
+        dump() {
+            const out = {};
+            for (const [key, value] of objects) {
+                out[key] = value.body;
+            }
+            return out;
+        },
+        async getObject(key) {
+            return objects.get(key) ?? null;
+        },
+        async listKeys(prefix) {
+            return [...objects.keys()].filter((key) => key.startsWith(prefix)).sort();
+        },
+        async putObject(key, body, putOptions) {
+            if (options?.failOnKeyIncludes !== undefined &&
+                key.includes(options.failOnKeyIncludes) &&
+                failNext === null) {
+                // allow selective failure via setFailNextPut instead
+            }
+            if (failNext === "timeout") {
+                failNext = null;
+                throw new Error("timeout");
+            }
+            if (failNext === "error") {
+                failNext = null;
+                throw new Error("provider error");
+            }
+            if (failNext === "conflict") {
+                failNext = null;
+                throw new Error("CONFLICT");
+            }
+            const existing = objects.get(key);
+            if (putOptions?.ifNoneMatch === "*" && existing !== undefined) {
+                throw new Error("CONFLICT");
+            }
+            if (putOptions?.ifMatch !== undefined &&
+                (existing === undefined || existing.etag !== putOptions.ifMatch)) {
+                throw new Error("CONFLICT");
+            }
+            const etag = createHash("md5")
+                .update(`${key}:${body}:${randomUUID()}`)
+                .digest("hex");
+            objects.set(key, { body, etag });
+            return { etag };
+        },
+    };
+}
+//# sourceMappingURL=memory-r2.js.map

package/dist/fakes/memory-r2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-r2.js","sourceRoot":"","sources":["../../src/fakes/memory-r2.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGrD;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAGpC;IAIC,MAAM,OAAO,GAAG,IAAI,GAAG,EAA0C,CAAC;IAClE,IAAI,QAAQ,GACV,OAAO,EAAE,WAAW,IAAI,IAAI,CAAC;IAE/B,OAAO;QACL,cAAc,CAAC,IAAI;YACjB,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;QACD,IAAI;YACF,MAAM,GAAG,GAA2B,EAAE,CAAC;YACvC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;gBACnC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC;YACxB,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC;QACD,KAAK,CAAC,SAAS,CAAC,GAAG;YACjB,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;QAClC,CAAC;QACD,KAAK,CAAC,QAAQ,CAAC,MAAM;YACnB,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5E,CAAC;QACD,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,UAAU;YACnC,IACE,OAAO,EAAE,iBAAiB,KAAK,SAAS;gBACxC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,iBAAiB,CAAC;gBACvC,QAAQ,KAAK,IAAI,EACjB,CAAC;gBACD,qDAAqD;YACvD,CAAC;YACD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,QAAQ,GAAG,IAAI,CAAC;gBAChB,MAAM,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC;YAC7B,CAAC;YACD,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;gBACzB,QAAQ,GAAG,IAAI,CAAC;gBAChB,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC;YACpC,CAAC;YACD,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;gBAC5B,QAAQ,GAAG,IAAI,CAAC;gBAChB,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC;YAC9B,CAAC;YAED,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAClC,IAAI,UAAU,EAAE,WAAW,KAAK,GAAG,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC9D,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC;YAC9B,CAAC;YACD,IACE,UAAU,EAAE,OAAO,KAAK,SAAS;gBACjC,CAAC,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,IAAI,KAAK,UAAU,CAAC,OAAO,CAAC,EAChE,CAAC;gBACD,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC;YAC9B,CAAC;YAED,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC;iBAC3B,MAAM,CAAC,GAAG,GAAG,IAAI,IAAI,IAAI,UAAU,EAAE,EAAE,CAAC;iBACxC,MAAM,CAAC,KAAK,CAAC,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YACjC,OAAO,EAAE,IAAI,EAAE,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,CAAC"}