@relayfile/adapter-core 0.1.20 → 0.2.1

package/dist/src/runtime/file-native-router.test.js

@@ -0,0 +1,294 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+import { classifyWrite, executeFileNativeWriteback, validatePayload, } from "./file-native-router.js";
+import { clearWritebackStatus, listWritebackStatus, recordWritebackStatus, } from "./writeback-status.js";
+const resources = [
+    {
+        name: "issues",
+        path: "/linear/issues",
+        pathPattern: /^\/linear\/issues(?:\/[^/]+(?:\.json)?)?$/,
+        idPattern: /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i,
+        schema: "discovery/linear/issues/.schema.json",
+        createExample: "discovery/linear/issues/.create.example.json",
+    },
+    {
+        name: "comments",
+        path: "/linear/issues/{issueId}/comments",
+        pathPattern: /^\/linear\/issues\/[^/]+\/comments(?:\/[^/]+(?:\.json)?)?$/,
+        idPattern: /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i,
+        schema: "discovery/linear/issues/{issueId}/comments/.schema.json",
+        createExample: "discovery/linear/issues/{issueId}/comments/.create.example.json",
+    },
+];
+const issueId = "11111111-1111-1111-1111-111111111111";
+test("classifyWrite maps canonical ids to patch and drafts to create", () => {
+    const patch = classifyWrite(`/linear/issues/${issueId}.json`, resources);
+    assert.equal(patch?.kind, "patch");
+    assert.equal(patch?.canonical, true);
+    assert.equal(patch?.id, issueId);
+    assert.equal(patch?.resource.name, "issues");
+    const create = classifyWrite("/linear/issues/draft-title.json", resources);
+    assert.equal(create?.kind, "create");
+    assert.equal(create?.canonical, false);
+    assert.equal(create?.id, "draft-title");
+    assert.equal(classifyWrite("/linear/issues", resources), null);
+});
+test("classifyWrite maps canonical delete events to delete", () => {
+    const deleted = classifyWrite(`/linear/issues/${issueId}.json`, resources, {
+        fsEvent: "delete",
+    });
+    assert.equal(deleted?.kind, "delete");
+    assert.equal(deleted?.canonical, true);
+    assert.equal(deleted?.id, issueId);
+    assert.equal(classifyWrite("/linear/issues/draft-title.json", resources, {
+        fsEvent: "delete",
+    }), null);
+});
+test("classifyWrite chooses the most specific matching resource", () => {
+    const route = classifyWrite(`/linear/issues/${issueId}/comments/draft-comment.json`, resources);
+    assert.equal(route?.kind, "create");
+    assert.equal(route?.resource.name, "comments");
+});
+test("validatePayload enforces create required fields", () => {
+    const schema = issueSchema();
+    const result = validatePayload({ priority: 2 }, schema, "create");
+    assert.equal(result.ok, false);
+    if (!result.ok) {
+        assert.deepEqual(result.errors.map((error) => [error.field, error.reason]), [["title", "required"]]);
+    }
+    assert.deepEqual(validatePayload({ priority: 2 }, schema, "patch"), {
+        ok: true,
+    });
+});
+test("validatePayload enforces additionalProperties false", () => {
+    const result = validatePayload({ title: "Issue", unexpected: true }, issueSchema(), "create");
+    assert.equal(result.ok, false);
+    if (!result.ok) {
+        assert.equal(result.errors[0]?.field, "unexpected");
+        assert.equal(result.errors[0]?.reason, "additionalProperties");
+    }
+});
+test("validatePayload rejects read-only fields", () => {
+    const result = validatePayload({ title: "Issue", id: issueId }, issueSchema(), "create");
+    assert.equal(result.ok, false);
+    if (!result.ok) {
+        assert.equal(result.errors[0]?.field, "id");
+        assert.equal(result.errors[0]?.reason, "readOnly");
+    }
+});
+test("validatePayload enforces field types and enums", () => {
+    const result = validatePayload({ title: 123, priority: 9 }, issueSchema(), "create");
+    assert.equal(result.ok, false);
+    if (!result.ok) {
+        assert.deepEqual(result.errors.map((error) => [error.field, error.reason]), [
+            ["title", "type"],
+            ["priority", "enum"],
+        ]);
+    }
+});
+test("writeback status sink records and filters entries", () => {
+    clearWritebackStatus();
+    recordWritebackStatus({
+        path: "/linear/issues/draft.json",
+        op: "create",
+        outcome: "validation_failed",
+        error: "Missing required field \"title\"",
+        field: "title",
+        timestamp: "2026-05-09T09:00:00.000Z",
+    });
+    recordWritebackStatus({
+        path: `/linear/issues/${issueId}.json`,
+        op: "patch",
+        outcome: "ok",
+        timestamp: "2026-05-09T09:01:00.000Z",
+    });
+    assert.equal(listWritebackStatus().length, 2);
+    assert.deepEqual(listWritebackStatus({ outcome: "validation_failed" }), [
+        {
+            path: "/linear/issues/draft.json",
+            op: "create",
+            outcome: "validation_failed",
+            error: "Missing required field \"title\"",
+            field: "title",
+            timestamp: "2026-05-09T09:00:00.000Z",
+        },
+    ]);
+});
+test("executeFileNativeWriteback validates, resolves create, records ok, and returns receipt", async () => {
+    clearWritebackStatus();
+    const result = await executeFileNativeWriteback({
+        path: "/linear/issues/draft-title.json",
+        content: JSON.stringify({ title: "Issue" }),
+        resources,
+        loadSchema: issueSchema,
+        now: () => new Date("2026-05-09T09:02:00.000Z"),
+        resolveWritebackRequest(path, content) {
+            assert.equal(path, "/linear/issues/draft-title.json");
+            assert.equal(JSON.parse(content).title, "Issue");
+            return {
+                action: "create_issue",
+                method: "POST",
+                endpoint: "/graphql",
+            };
+        },
+        applyWriteback(request, route) {
+            assert.equal(route.kind, "create");
+            assert.equal(request.action, "create_issue");
+            return { externalId: issueId };
+        },
+    });
+    assert.equal(result.ok, true);
+    if (result.ok) {
+        assert.equal(result.route.kind, "create");
+        assert.deepEqual(result.createReceipt, {
+            draftPath: "/linear/issues/draft-title.json",
+            canonicalPath: `/linear/issues/${issueId}.json`,
+            id: issueId,
+            resource: "issues",
+            createdAt: "2026-05-09T09:02:00.000Z",
+        });
+        assert.equal(result.status.outcome, "ok");
+    }
+    assert.deepEqual(listWritebackStatus({ path: "/linear/issues/draft-title.json" }), [
+        {
+            path: "/linear/issues/draft-title.json",
+            op: "create",
+            status: "accepted",
+            code: "OK",
+            outcome: "ok",
+            timestamp: "2026-05-09T09:02:00.000Z",
+        },
+    ]);
+});
+test("executeFileNativeWriteback records validation and read-only failures", async () => {
+    clearWritebackStatus();
+    const missingRequired = await executeFileNativeWriteback({
+        path: "/linear/issues/draft-title.json",
+        content: JSON.stringify({ priority: 2 }),
+        resources,
+        loadSchema: issueSchema,
+        now: () => new Date("2026-05-09T09:03:00.000Z"),
+        resolveWritebackRequest() {
+            throw new Error("resolver should not run after validation failure");
+        },
+    });
+    assert.equal(missingRequired.ok, false);
+    assert.equal(missingRequired.status?.status, "rejected");
+    assert.equal(missingRequired.status?.code, "VALIDATION_FAILED");
+    assert.equal(missingRequired.status?.outcome, "validation_failed");
+    assert.equal(missingRequired.status?.field, "title");
+    const readonly = await executeFileNativeWriteback({
+        path: `/linear/issues/${issueId}.json`,
+        content: JSON.stringify({ id: issueId }),
+        resources,
+        loadSchema: issueSchema,
+        now: () => new Date("2026-05-09T09:04:00.000Z"),
+        resolveWritebackRequest() {
+            throw new Error("resolver should not run after read-only failure");
+        },
+    });
+    assert.equal(readonly.ok, false);
+    assert.equal(readonly.status?.status, "rejected");
+    assert.equal(readonly.status?.code, "READ_ONLY_FIELD");
+    assert.equal(readonly.status?.outcome, "readonly_rejected");
+    assert.equal(readonly.status?.field, "id");
+    assert.deepEqual(listWritebackStatus().map((entry) => [
+        entry.op,
+        entry.status,
+        entry.code,
+        entry.outcome,
+        entry.field,
+    ]), [
+        ["create", "rejected", "VALIDATION_FAILED", "validation_failed", "title"],
+        ["patch", "rejected", "READ_ONLY_FIELD", "readonly_rejected", "id"],
+    ]);
+});
+test("executeFileNativeWriteback routes canonical deletes without schema validation", async () => {
+    clearWritebackStatus();
+    const result = await executeFileNativeWriteback({
+        path: `/linear/issues/${issueId}.json`,
+        resources,
+        fsEvent: "delete",
+        now: () => new Date("2026-05-09T09:05:00.000Z"),
+        resolveDeleteRequest(path) {
+            assert.equal(path, `/linear/issues/${issueId}.json`);
+            return {
+                action: "delete_issue",
+                method: "DELETE",
+                endpoint: `/issues/${issueId}`,
+            };
+        },
+    });
+    assert.equal(result.ok, true);
+    if (result.ok) {
+        assert.equal(result.route.kind, "delete");
+        assert.equal(result.request?.method, "DELETE");
+    }
+    assert.deepEqual(listWritebackStatus(), [
+        {
+            path: `/linear/issues/${issueId}.json`,
+            op: "delete",
+            status: "accepted",
+            code: "OK",
+            outcome: "ok",
+            timestamp: "2026-05-09T09:05:00.000Z",
+        },
+    ]);
+});
+test("executeFileNativeWriteback bypasses validation for schema-less create/patch resources", async () => {
+    clearWritebackStatus();
+    const emptySchema = {};
+    const create = await executeFileNativeWriteback({
+        path: "/linear/issues/draft.json",
+        content: JSON.stringify({ anything: "goes", id: "still-allowed-no-schema" }),
+        resources,
+        loadSchema: () => emptySchema,
+        now: () => new Date("2026-05-09T10:00:00.000Z"),
+        resolveWritebackRequest(path) {
+            assert.equal(path, "/linear/issues/draft.json");
+            return {
+                action: "create_issue",
+                method: "POST",
+                endpoint: "/issues",
+                body: { title: "from draft" },
+            };
+        },
+    });
+    assert.equal(create.ok, true);
+    if (create.ok) {
+        assert.equal(create.route.kind, "create");
+    }
+    const patch = await executeFileNativeWriteback({
+        path: `/linear/issues/${issueId}.json`,
+        content: JSON.stringify({ anything: "goes", id: "still-allowed-no-schema" }),
+        resources,
+        loadSchema: () => emptySchema,
+        now: () => new Date("2026-05-09T10:00:01.000Z"),
+        resolveWritebackRequest(path) {
+            assert.equal(path, `/linear/issues/${issueId}.json`);
+            return {
+                action: "update_issue",
+                method: "PUT",
+                endpoint: `/issues/${issueId}`,
+                body: { anything: "goes" },
+            };
+        },
+    });
+    assert.equal(patch.ok, true);
+    if (patch.ok) {
+        assert.equal(patch.route.kind, "patch");
+    }
+});
+function issueSchema() {
+    return {
+        type: "object",
+        required: ["title"],
+        additionalProperties: false,
+        properties: {
+            title: { type: "string" },
+            priority: { enum: [0, 1, 2, 3, 4] },
+            id: { type: "string", readOnly: true },
+        },
+    };
+}
+//# sourceMappingURL=file-native-router.test.js.map

package/dist/src/runtime/file-native-router.test.js.map

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

package/dist/src/runtime/writeback-status.d.ts

@@ -0,0 +1,26 @@
+export type WritebackOperation = "patch" | "create" | "delete";
+export type WritebackOutcome = "ok" | "validation_failed" | "readonly_rejected" | "adapter_error";
+export type WritebackStatusState = "accepted" | "rejected";
+export type WritebackStatusCode = "OK" | "VALIDATION_FAILED" | "READ_ONLY_FIELD" | "ADAPTER_ERROR";
+export interface WritebackStatusEntry {
+    path: string;
+    op: WritebackOperation;
+    status?: WritebackStatusState;
+    code?: WritebackStatusCode;
+    outcome: WritebackOutcome;
+    error?: string;
+    field?: string;
+    timestamp: string;
+}
+export interface WritebackStatusFilter {
+    path?: string;
+    op?: WritebackOperation;
+    status?: WritebackStatusState;
+    code?: WritebackStatusCode;
+    outcome?: WritebackOutcome;
+    field?: string;
+}
+export declare function recordWritebackStatus(entry: WritebackStatusEntry): void;
+export declare function listWritebackStatus(filter?: WritebackStatusFilter): WritebackStatusEntry[];
+export declare function clearWritebackStatus(): void;
+//# sourceMappingURL=writeback-status.d.ts.map

package/dist/src/runtime/writeback-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeback-status.d.ts","sourceRoot":"","sources":["../../../src/runtime/writeback-status.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE/D,MAAM,MAAM,gBAAgB,GACxB,IAAI,GACJ,mBAAmB,GACnB,mBAAmB,GACnB,eAAe,CAAC;AAEpB,MAAM,MAAM,oBAAoB,GAAG,UAAU,GAAG,UAAU,CAAC;AAE3D,MAAM,MAAM,mBAAmB,GAC3B,IAAI,GACJ,mBAAmB,GACnB,iBAAiB,GACjB,eAAe,CAAC;AAEpB,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,kBAAkB,CAAC;IACvB,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAC3B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,kBAAkB,CAAC;IACxB,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAC3B,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAEvE;AAED,wBAAgB,mBAAmB,CACjC,MAAM,GAAE,qBAA0B,GACjC,oBAAoB,EAAE,CAwBxB;AAED,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C"}

package/dist/src/runtime/writeback-status.js

@@ -0,0 +1,33 @@
+const writebackStatusEntries = [];
+export function recordWritebackStatus(entry) {
+    writebackStatusEntries.push({ ...entry });
+}
+export function listWritebackStatus(filter = {}) {
+    return writebackStatusEntries
+        .filter((entry) => {
+        if (filter.path !== undefined && entry.path !== filter.path) {
+            return false;
+        }
+        if (filter.op !== undefined && entry.op !== filter.op) {
+            return false;
+        }
+        if (filter.status !== undefined && entry.status !== filter.status) {
+            return false;
+        }
+        if (filter.code !== undefined && entry.code !== filter.code) {
+            return false;
+        }
+        if (filter.outcome !== undefined && entry.outcome !== filter.outcome) {
+            return false;
+        }
+        if (filter.field !== undefined && entry.field !== filter.field) {
+            return false;
+        }
+        return true;
+    })
+        .map((entry) => ({ ...entry }));
+}
+export function clearWritebackStatus() {
+    writebackStatusEntries.length = 0;
+}
+//# sourceMappingURL=writeback-status.js.map

package/dist/src/runtime/writeback-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeback-status.js","sourceRoot":"","sources":["../../../src/runtime/writeback-status.ts"],"names":[],"mappings":"AAoCA,MAAM,sBAAsB,GAA2B,EAAE,CAAC;AAE1D,MAAM,UAAU,qBAAqB,CAAC,KAA2B;IAC/D,sBAAsB,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,SAAgC,EAAE;IAElC,OAAO,sBAAsB;SAC1B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;QAChB,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC;YAC5D,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,MAAM,CAAC,EAAE,KAAK,SAAS,IAAI,KAAK,CAAC,EAAE,KAAK,MAAM,CAAC,EAAE,EAAE,CAAC;YACtD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC;YAClE,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC;YAC5D,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC;YACrE,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC;YAC/D,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;SACD,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,sBAAsB,CAAC,MAAM,GAAG,CAAC,CAAC;AACpC,CAAC"}

package/dist/src/storage-bridge/discovery.d.ts

@@ -1,14 +1,6 @@
+import { ReadOnlyFieldError, type AdapterResourceConfig, type AdapterResourceOperation } from "../runtime/file-native-router.js";
 import type { JsonValue } from "./event.js";
-export interface AdapterResourceConfig {
-    readonly name: string;
-    readonly path: string;
-    readonly pathPattern: RegExp;
-    readonly idPattern: RegExp;
-    readonly schema: string;
-    readonly createExample: string;
-    readonly operations?: readonly AdapterResourceOperation[];
-}
-export type AdapterResourceOperation = "create" | "update" | "delete";
+export { ReadOnlyFieldError, type AdapterResourceConfig, type AdapterResourceOperation, };
 export interface JsonSchemaObject {
     readonly $schema?: string;
     readonly type?: string | readonly string[];
@@ -21,10 +13,6 @@ export interface JsonSchemaObject {
     readonly additionalProperties?: boolean | JsonSchemaObject;
     readonly [key: string]: unknown;
 }
-export declare class ReadOnlyFieldError extends Error {
-    readonly fields: readonly string[];
-    constructor(fields: readonly string[]);
-}
 export declare function findResourceByPath(resources: readonly AdapterResourceConfig[], path: string): AdapterResourceConfig | undefined;
 export declare function assertReadOnlyFieldsRejected(schema: JsonSchemaObject, patch: Record<string, unknown>): void;
 export declare function collectReadOnlyFields(schema: JsonSchemaObject, prefix?: string): string[];

package/dist/src/storage-bridge/discovery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../../src/storage-bridge/discovery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,wBAAwB,EAAE,CAAC;CAC3D;AAED,MAAM,MAAM,wBAAwB,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEtE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACvD,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC7C,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC7C,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC7C,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,GAAG,gBAAgB,CAAC;IAC3D,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;gBAEvB,MAAM,EAAE,SAAS,MAAM,EAAE;CAKtC;AAED,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,SAAS,qBAAqB,EAAE,EAC3C,IAAI,EAAE,MAAM,GACX,qBAAqB,GAAG,SAAS,CAGnC;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,IAAI,CAMN;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,gBAAgB,EACxB,MAAM,SAAK,GACV,MAAM,EAAE,CAeV;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAE/E"}
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../../src/storage-bridge/discovery.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC9B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,EACL,kBAAkB,EAClB,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,GAC9B,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACvD,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC7C,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC7C,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC7C,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,GAAG,gBAAgB,CAAC;IAC3D,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC;AAED,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,SAAS,qBAAqB,EAAE,EAC3C,IAAI,EAAE,MAAM,GACX,qBAAqB,GAAG,SAAS,CAGnC;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,IAAI,CAMN;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,gBAAgB,EACxB,MAAM,SAAK,GACV,MAAM,EAAE,CAeV;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAE/E"}

package/dist/src/storage-bridge/discovery.js

@@ -1,11 +1,5 @@
-export class ReadOnlyFieldError extends Error {
-    fields;
-    constructor(fields) {
-        super(`Writeback attempted to modify read-only fields: ${fields.join(", ")}`);
-        this.name = "ReadOnlyFieldError";
-        this.fields = fields;
-    }
-}
+import { ReadOnlyFieldError, } from "../runtime/file-native-router.js";
+export { ReadOnlyFieldError, };
 export function findResourceByPath(resources, path) {
     const normalizedPath = path.endsWith(".json") ? path : path.replace(/\/$/, "");
     return resources.find((resource) => resource.pathPattern.test(normalizedPath));
@@ -14,7 +8,7 @@ export function assertReadOnlyFieldsRejected(schema, patch) {
     const readOnlyFields = collectReadOnlyFields(schema);
     const rejected = readOnlyFields.filter((field) => hasPath(patch, field));
     if (rejected.length > 0) {
-        throw new ReadOnlyFieldError(rejected);
+        throw new ReadOnlyFieldError(rejected[0]);
     }
 }
 export function collectReadOnlyFields(schema, prefix = "") {

package/dist/src/storage-bridge/discovery.js.map

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

package/dist/tests/atomic-index/atomic-index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=atomic-index.test.d.ts.map

package/dist/tests/atomic-index/atomic-index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-index.test.d.ts","sourceRoot":"","sources":["../../../tests/atomic-index/atomic-index.test.ts"],"names":[],"mappings":""}

package/dist/tests/atomic-index/atomic-index.test.js

@@ -0,0 +1,182 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+import { AtomicIndexExhaustedError, isConflictError, upsertIndexAtomic, } from "../../src/atomic-index/index.js";
+class CasVfs {
+    files = new Map();
+    revisionCounter = 0;
+    options;
+    conflictWrites = [];
+    successfulWrites = [];
+    constructor(options = {}) {
+        this.options = options;
+    }
+    armConflicts(path, count) {
+        this.options.forceConflicts = { path, remaining: count };
+    }
+    readFile(path) {
+        const existing = this.files.get(path);
+        return existing ? { content: existing.content, revision: existing.revision } : undefined;
+    }
+    writeFile(path, content, options) {
+        if (this.options.forceConflicts &&
+            this.options.forceConflicts.path === path &&
+            this.options.forceConflicts.remaining > 0) {
+            this.options.forceConflicts.remaining -= 1;
+            this.conflictWrites.push(path);
+            throw conflictError(this.files.get(path)?.revision ?? "0", options?.baseRevision ?? "0");
+        }
+        const baseRevision = options?.baseRevision ?? "0";
+        const existing = this.files.get(path);
+        const currentRevision = existing?.revision ?? "0";
+        if (currentRevision !== baseRevision) {
+            this.conflictWrites.push(path);
+            throw conflictError(currentRevision, baseRevision);
+        }
+        this.revisionCounter += 1;
+        const nextRevision = `r${this.revisionCounter}`;
+        this.files.set(path, { content, revision: nextRevision });
+        this.successfulWrites.push(path);
+        return { revision: nextRevision };
+    }
+}
+function conflictError(currentRevision, expectedRevision) {
+    const error = new Error(`RevisionConflictError: expected ${expectedRevision}, current ${currentRevision}`);
+    Object.assign(error, {
+        name: "RevisionConflictError",
+        status: 409,
+        code: "revision_conflict",
+        expectedRevision,
+        currentRevision,
+    });
+    return error;
+}
+const PATH = "/example/_index.json";
+const PARSE_ROWS = (content) => {
+    if (!content) {
+        return [];
+    }
+    try {
+        const parsed = JSON.parse(content);
+        return Array.isArray(parsed) ? parsed : [];
+    }
+    catch {
+        return [];
+    }
+};
+const SERIALIZE_ROWS = (rows) => `${JSON.stringify(rows)}\n`;
+function upsertRow(rows, next) {
+    const map = new Map();
+    for (const row of rows) {
+        map.set(row.id, row);
+    }
+    map.set(next.id, next);
+    return [...map.values()].sort((left, right) => left.id.localeCompare(right.id));
+}
+test("isConflictError detects RevisionConflictError by name", () => {
+    const err = Object.assign(new Error("boom"), { name: "RevisionConflictError" });
+    assert.equal(isConflictError(err), true);
+});
+test("isConflictError detects 409 by status", () => {
+    assert.equal(isConflictError({ status: 409 }), true);
+    assert.equal(isConflictError({ statusCode: 409 }), true);
+});
+test("isConflictError detects revision_conflict by code", () => {
+    assert.equal(isConflictError({ code: "revision_conflict" }), true);
+});
+test("isConflictError returns false for unrelated errors", () => {
+    assert.equal(isConflictError(new Error("disk full")), false);
+    assert.equal(isConflictError({ status: 500 }), false);
+    assert.equal(isConflictError(undefined), false);
+    assert.equal(isConflictError(null), false);
+    assert.equal(isConflictError("conflict"), false);
+});
+test("isConflictError does not match unrelated codes that merely contain the word 'conflict'", () => {
+    // Regression: previous regex `/(revision_conflict|conflict)/i` matched
+    // any code with "conflict" as a substring, causing false retries on
+    // unrelated errors like merge_conflict / name_conflict.
+    assert.equal(isConflictError({ code: "merge_conflict" }), false);
+    assert.equal(isConflictError({ code: "name_conflict" }), false);
+    assert.equal(isConflictError({ code: "permission_conflict" }), false);
+    assert.equal(isConflictError({ code: "CONFLICT" }), false);
+});
+test("upsertIndexAtomic writes once on the happy path with no conflict", async () => {
+    const vfs = new CasVfs();
+    await upsertIndexAtomic(vfs, PATH, PARSE_ROWS, (rows) => upsertRow(rows, { id: "7", title: "Add login" }), SERIALIZE_ROWS, { sleep: async () => undefined });
+    assert.equal(vfs.successfulWrites.length, 1);
+    assert.equal(vfs.conflictWrites.length, 0);
+    const stored = vfs.readFile(PATH);
+    assert.ok(stored, "index file should exist");
+    const rows = JSON.parse(stored.content);
+    assert.equal(rows.length, 1);
+    assert.equal(rows[0]?.id, "7");
+});
+test("upsertIndexAtomic retries successfully after a single conflict", async () => {
+    const vfs = new CasVfs();
+    // seed with a row from a "competing" writer
+    vfs.writeFile(PATH, JSON.stringify([{ id: "5", title: "Existing" }]) + "\n", {
+        baseRevision: "0",
+    });
+    vfs.armConflicts(PATH, 1);
+    let invocations = 0;
+    await upsertIndexAtomic(vfs, PATH, PARSE_ROWS, (rows) => {
+        invocations += 1;
+        return upsertRow(rows, { id: "7", title: "New" });
+    }, SERIALIZE_ROWS, { sleep: async () => undefined, baseDelayMs: 0 });
+    assert.equal(invocations, 2, "merge should run on each attempt");
+    assert.equal(vfs.conflictWrites.length, 1);
+    const stored = vfs.readFile(PATH);
+    const rows = JSON.parse(stored.content);
+    const ids = rows.map((row) => row.id).sort();
+    // Both the pre-seeded "competing" row and the new row must survive.
+    assert.deepEqual(ids, ["5", "7"]);
+});
+test("upsertIndexAtomic throws AtomicIndexExhaustedError when conflicts persist past the budget", async () => {
+    const vfs = new CasVfs({
+        forceConflicts: { path: PATH, remaining: 100 },
+    });
+    await assert.rejects(upsertIndexAtomic(vfs, PATH, PARSE_ROWS, (rows) => upsertRow(rows, { id: "7", title: "Stuck" }), SERIALIZE_ROWS, { maxAttempts: 3, sleep: async () => undefined, baseDelayMs: 0 }), (error) => {
+        assert.ok(error instanceof AtomicIndexExhaustedError);
+        assert.equal(error.attempts, 3);
+        assert.equal(error.path, PATH);
+        return true;
+    });
+    assert.equal(vfs.successfulWrites.length, 0);
+});
+test("upsertIndexAtomic rethrows non-conflict errors without retrying", async () => {
+    const vfs = {
+        readFile() {
+            return undefined;
+        },
+        writeFile() {
+            const error = new Error("disk full");
+            Object.assign(error, { status: 500 });
+            throw error;
+        },
+    };
+    let attempts = 0;
+    await assert.rejects(upsertIndexAtomic(vfs, PATH, PARSE_ROWS, (rows) => {
+        attempts += 1;
+        return rows;
+    }, SERIALIZE_ROWS, { sleep: async () => undefined, maxAttempts: 5 }), /disk full/);
+    assert.equal(attempts, 1, "non-conflict errors must not trigger retry");
+});
+test("upsertIndexAtomic reports existedAtWrite=true when the file already existed at the winning read", async () => {
+    // Regression: callers that build an IngestResult-shaped accounting wrapper
+    // around upsertIndexAtomic (e.g. github's runAtomicIndexWrite) previously
+    // read existedBefore from a dedicated pre-CAS read. If a racing writer
+    // created the file between that read and the eventual successful CAS
+    // write, the wrapper reported filesWritten: 1 / filesUpdated: 0 even though
+    // the winning attempt actually updated an existing file. The fix moves the
+    // existed check inside upsertIndexAtomic where the read that produced the
+    // winning baseRevision is the source of truth.
+    const vfs = new CasVfs();
+    vfs.writeFile(PATH, JSON.stringify([{ id: "1", title: "One" }]) + "\n");
+    const { existedAtWrite } = await upsertIndexAtomic(vfs, PATH, PARSE_ROWS, (rows) => upsertRow(rows, { id: "2", title: "Two" }), SERIALIZE_ROWS, { sleep: async () => undefined, baseDelayMs: 0 });
+    assert.equal(existedAtWrite, true, "existedAtWrite must reflect the winning read");
+});
+test("upsertIndexAtomic reports existedAtWrite=false on first creation", async () => {
+    const vfs = new CasVfs();
+    const { existedAtWrite } = await upsertIndexAtomic(vfs, PATH, PARSE_ROWS, (rows) => upsertRow(rows, { id: "1", title: "One" }), SERIALIZE_ROWS, { sleep: async () => undefined, baseDelayMs: 0 });
+    assert.equal(existedAtWrite, false);
+});
+//# sourceMappingURL=atomic-index.test.js.map