hikoutei 0.2.0

package/dist/adapter/sheets/providers/apps-script-gateway/transport/operationSyncGateway.js

@@ -0,0 +1,343 @@
+/**
+ * Runtime adapter for the thin, generic Apps Script operation gateway.
+ *
+ * The current Code.gs exposes a generic signed operation dispatcher. Fast
+ * append stays on its low-cost operation, while regular effects and recovery
+ * reads use separate operations with their own typed decoders.
+ */
+import { SYNC_GATEWAY_ERROR_CODES, SyncGatewayContractError, } from "../../../../../application/sync/gateway/errors.js";
+import { requireSyncGatewayNonEmptyList, requireSyncGatewayNonNegativeSafeInteger, requireSyncGatewayPositiveSafeInteger, requireSyncGatewayProjection, requireSyncGatewayText, } from "../../../../../application/sync/gateway/validation.js";
+import { isRecord } from "../../../../../shared/encoding/typeGuards.js";
+import { createFastAppendRowsOperation } from "../operations/write/fastAppendOperation.js";
+import { createReadTableRowsOperation } from "../operations/read/tableReadOperation.js";
+import { createApplyEffectsOperation, createReadEffectPostconditionOperation, createReadEffectPostconditionsOperation, } from "../operations/effect/effectOperation.js";
+import { createEnsureRowAnchorsOperation, createObserveSnapshotOperation, createReadSnapshotOperation, } from "../operations/observation/observationOperation.js";
+import { invalidOperationResponse } from "../errors.js";
+/**
+ * Adapts the generic Apps Script operation transport to the sync worker's
+ * fast and regular effect gateway boundaries.
+ */
+export class AppsScriptOperationSyncGateway {
+    operationGateway;
+    definitions;
+    constructor(options) {
+        if (options.definitions.length === 0) {
+            throw new SyncGatewayContractError(SYNC_GATEWAY_ERROR_CODES.INVALID_PROVISIONING_DEFINITIONS, "Apps Script operation sync gateway requires a projection definition");
+        }
+        this.operationGateway = options.operationGateway;
+        this.definitions = options.definitions;
+    }
+    /**
+     * Creates or verifies the registered tabs and their header rows remotely.
+     *
+     * The operation is idempotent: the remote source only creates missing tabs
+     * and rejects a nonblank header row that differs from SQLite's schema.
+     */
+    async provisionRegistry(registrations) {
+        requireSyncGatewayNonEmptyList(registrations, "Apps Script operation provisioning registrations", SYNC_GATEWAY_ERROR_CODES.INVALID_PROVISIONING_DEFINITIONS);
+        const operation = {
+            fn: PROVISION_SOURCE,
+            args: {
+                registrations: registrations.map(toProvisionRegistrationWire),
+            },
+            decode: decodeProvisionResult,
+        };
+        const [result] = await this.operationGateway.applyOperations([operation]);
+        return result;
+    }
+    /**
+     * Appends new System_State rows with one remote setValues operation.
+     *
+     * No row metadata, receipt, snapshot, CAS, or postcondition work is
+     * performed here. Reconciliation owns drift detection after this write.
+     */
+    async fastAppendRows(request) {
+        const definition = this.definitionForPhysicalSheet(request.physicalSheetId);
+        validateRoute(request, definition);
+        const operation = createFastAppendRowsOperation({
+            sheetName: request.sheetName,
+            headers: definition.headers,
+            rows: request.rows,
+        });
+        const [result] = await this.operationGateway.applyOperations([operation]);
+        return result;
+    }
+    /** Reads one registered table with values only; no metadata, lock, or CAS work is performed. */
+    async readRows(request) {
+        const [result] = await this.readRowsBatch([request]);
+        if (result === undefined) {
+            throw new SyncGatewayContractError(SYNC_GATEWAY_ERROR_CODES.INVALID_GATEWAY_RESPONSE, "Apps Script table read returned no result");
+        }
+        return result;
+    }
+    /** Reads several registered tables through one signed Apps Script request. */
+    async readRowsBatch(requests) {
+        const operations = requests.map((request) => {
+            const definition = this.definitionForPhysicalSheet(request.physicalSheetId);
+            validateRoute(request, definition);
+            return createReadTableRowsOperation({
+                sheetName: request.sheetName,
+                registeredRange: request.registeredRange,
+                headers: definition.headers,
+            });
+        });
+        if (operations.length === 0)
+            return [];
+        const results = await this.operationGateway.applyOperations(operations);
+        return results;
+    }
+    /** Applies regular update/delete effects through the full operation path. */
+    async applyEffects(request) {
+        const definition = this.definitionForPhysicalSheet(request.physicalSheetId);
+        validateRoute(request, definition);
+        const operation = createApplyEffectsOperation({
+            ...request,
+            ...effectRouteOptions(definition),
+        });
+        const [result] = await this.operationGateway.applyOperations([operation]);
+        return result;
+    }
+    /** Reads one regular-effect postcondition after an uncertain response. */
+    async readEffectPostcondition(effect) {
+        const definition = this.definitionForPhysicalSheet(effect.physicalSheetId);
+        const request = {
+            physicalSheetId: effect.physicalSheetId,
+            sheetName: effect.payload.sheetName,
+            registeredRange: effect.payload.registeredRange,
+            projection: effect.projection,
+            schemaVersion: effect.payload.schemaVersion,
+            effect,
+        };
+        validateRoute(request, definition);
+        const operation = createReadEffectPostconditionOperation({
+            ...request,
+            ...effectRouteOptions(definition),
+        });
+        const [result] = await this.operationGateway.applyOperations([operation]);
+        return result;
+    }
+    /** Reads several regular-effect postconditions with one Sheet scan. */
+    async readEffectPostconditions(request) {
+        const definition = this.definitionForPhysicalSheet(request.physicalSheetId);
+        validateRoute(request, definition);
+        const operation = createReadEffectPostconditionsOperation({
+            ...request,
+            ...effectRouteOptions(definition),
+        });
+        const [result] = await this.operationGateway.applyOperations([operation]);
+        return result;
+    }
+    /** Assigns missing row anchors through the observation operation. */
+    async ensureRowAnchors(request) {
+        const definition = this.definitionForPhysicalSheet(request.physicalSheetId);
+        validateRoute(request, definition);
+        const operation = createEnsureRowAnchorsOperation({
+            ...request,
+            ...observationRouteOptions(definition),
+        });
+        const [result] = await this.operationGateway.applyOperations([operation]);
+        return result;
+    }
+    /** Reads a normalized, anchor-aware snapshot for polling and reconciliation. */
+    async readSnapshot(request) {
+        const definition = this.definitionForPhysicalSheet(request.physicalSheetId);
+        validateRoute(request, definition);
+        const operation = createReadSnapshotOperation({
+            ...request,
+            ...observationRouteOptions(definition),
+        });
+        const [result] = await this.operationGateway.applyOperations([operation]);
+        return result;
+    }
+    /** Assigns anchors and reads one snapshot under one remote lock/request. */
+    async observeSnapshot(request) {
+        const [result] = await this.observeSnapshots([request]);
+        if (result === undefined) {
+            throw new SyncGatewayContractError(SYNC_GATEWAY_ERROR_CODES.INVALID_GATEWAY_RESPONSE, "Apps Script observation returned no result");
+        }
+        return result;
+    }
+    /** Reads several projections through one signed Apps Script request. */
+    async observeSnapshots(requests) {
+        const operations = requests.map((request) => {
+            const definition = this.definitionForPhysicalSheet(request.physicalSheetId);
+            validateRoute(request, definition);
+            return createObserveSnapshotOperation({
+                ...request,
+                ...observationRouteOptions(definition),
+            });
+        });
+        if (operations.length === 0)
+            return [];
+        const results = await this.operationGateway.applyOperations(operations);
+        return results;
+    }
+    /**
+     * Reads a projection for setup checks and operational verification.
+     *
+     * This is intentionally not part of the old SyncSheetGateway contract; it
+     * is a small read operation for callers that need to verify row counts.
+     */
+    async readProjection(sheetName) {
+        const operation = {
+            fn: READ_PROJECTION_SOURCE,
+            args: { sheetName },
+            decode: decodeProjectionStatus,
+        };
+        const [result] = await this.operationGateway.applyOperations([operation]);
+        return result;
+    }
+    definitionForPhysicalSheet(physicalSheetId) {
+        const definition = this.definitions.find((candidate) => candidate.sheet.physicalSheetId === physicalSheetId);
+        if (definition === undefined) {
+            throw new SyncGatewayContractError(SYNC_GATEWAY_ERROR_CODES.INVALID_PROVISIONING_DEFINITIONS, "no projection definition exists for " + physicalSheetId);
+        }
+        return definition;
+    }
+}
+function toProvisionRegistrationWire(registration) {
+    return {
+        sheetName: registration.sheetName,
+        registeredRange: registration.registeredRange,
+        projection: registration.projection,
+        schemaVersion: registration.schemaVersion,
+        headers: registration.headers,
+        ...(registration.identityField === undefined
+            ? {}
+            : { identityField: registration.identityField }),
+        ...(registration.checkboxHeaders === undefined
+            ? {}
+            : { checkboxHeaders: registration.checkboxHeaders }),
+    };
+}
+function decodeProvisionResult(value) {
+    const record = requireRecord(value, "provisioning result");
+    if (!Array.isArray(record.registrations)) {
+        return invalidOperationResponse("Apps Script operation", "provisioning registrations must be an array");
+    }
+    return {
+        registrations: record.registrations.map((entry, index) => decodeProvisionedRoute(entry, index)),
+        createdSheets: requireStringArray(record.createdSheets, "provisioning createdSheets"),
+        initializedHeaders: requireStringArray(record.initializedHeaders, "provisioning initializedHeaders"),
+    };
+}
+function decodeProvisionedRoute(value, index) {
+    const record = requireRecord(value, "provisioning registrations[" + index + "]");
+    const identityField = optionalString(record.identityField, "provisioning registrations[" + index + "].identityField");
+    const checkboxHeaders = record.checkboxHeaders === undefined
+        ? undefined
+        : requireStringArray(record.checkboxHeaders, "provisioning registrations[" + index + "].checkboxHeaders");
+    return {
+        sheetName: requireSyncGatewayText(record.sheetName, "provisioning registrations[" + index + "].sheetName", SYNC_GATEWAY_ERROR_CODES.INVALID_GATEWAY_RESPONSE),
+        registeredRange: requireSyncGatewayText(record.registeredRange, "provisioning registrations[" + index + "].registeredRange", SYNC_GATEWAY_ERROR_CODES.INVALID_GATEWAY_RESPONSE),
+        projection: requireSyncGatewayProjection(record.projection, "provisioning registrations[" + index + "].projection", SYNC_GATEWAY_ERROR_CODES.INVALID_GATEWAY_RESPONSE),
+        schemaVersion: requireSyncGatewayPositiveSafeInteger(record.schemaVersion, "provisioning registrations[" + index + "].schemaVersion", SYNC_GATEWAY_ERROR_CODES.INVALID_GATEWAY_RESPONSE),
+        ...(identityField === undefined ? {} : { identityField }),
+        ...(checkboxHeaders === undefined ? {} : { checkboxHeaders }),
+    };
+}
+function decodeProjectionStatus(value) {
+    const record = requireRecord(value, "projection result");
+    return {
+        sheetName: requireSyncGatewayText(record.sheetName, "projection result sheetName", SYNC_GATEWAY_ERROR_CODES.INVALID_GATEWAY_RESPONSE),
+        headers: requireStringArray(record.headers, "projection result headers"),
+        rowCount: requireSyncGatewayNonNegativeSafeInteger(record.rowCount, "projection result rowCount", SYNC_GATEWAY_ERROR_CODES.INVALID_GATEWAY_RESPONSE),
+        ids: requireStringArray(record.ids, "projection result ids"),
+    };
+}
+function requireStringArray(value, label) {
+    if (!Array.isArray(value)) {
+        return invalidOperationResponse("Apps Script operation", label + " must be an array");
+    }
+    return value.map((entry, index) => requireSyncGatewayText(entry, label + "[" + index + "]", SYNC_GATEWAY_ERROR_CODES.INVALID_GATEWAY_RESPONSE));
+}
+function optionalString(value, label) {
+    if (value === undefined)
+        return undefined;
+    return requireSyncGatewayText(value, label, SYNC_GATEWAY_ERROR_CODES.INVALID_GATEWAY_RESPONSE);
+}
+function validateRoute(request, definition) {
+    if (request.sheetName !== definition.sheet.tabName ||
+        request.registeredRange !== definition.sheet.registeredRange ||
+        request.projection !== definition.sheet.projection ||
+        request.schemaVersion !== definition.sheet.schemaVersion) {
+        throw new SyncGatewayContractError(SYNC_GATEWAY_ERROR_CODES.INVALID_EFFECT_PAYLOAD, "sync gateway request does not match the registered projection " +
+            request.physicalSheetId);
+    }
+}
+function effectRouteOptions(definition) {
+    return {
+        ...(definition.sheet.projection === "system_state"
+            ? { identityField: definition.sheet.businessKeyField }
+            : {}),
+        ...(definition.checkboxHeaders === undefined
+            ? {}
+            : { checkboxHeaders: definition.checkboxHeaders }),
+    };
+}
+function observationRouteOptions(definition) {
+    return definition.checkboxHeaders === undefined
+        ? {}
+        : { checkboxHeaders: definition.checkboxHeaders };
+}
+function requireRecord(value, label) {
+    if (!isRecord(value)) {
+        return invalidOperationResponse("Apps Script operation", label + " must be an object");
+    }
+    return value;
+}
+const PROVISION_SOURCE = [
+    "function (spreadsheet, args) {",
+    "  if (!args || !Array.isArray(args.registrations) || args.registrations.length === 0) {",
+    '    throw new Error("operational provisioning registrations are required");',
+    "  }",
+    "  var createdSheets = [];",
+    "  var initializedHeaders = [];",
+    "  args.registrations.forEach(function (registration) {",
+    "    var sheet = spreadsheet.getSheetByName(registration.sheetName);",
+    "    if (sheet === null) {",
+    "      sheet = spreadsheet.insertSheet(registration.sheetName);",
+    "      createdSheets.push(registration.sheetName);",
+    "    }",
+    "    if (sheet.getLastRow() === 0 && sheet.getLastColumn() === 0) {",
+    "      sheet.getRange(1, 1, 1, registration.headers.length).setValues([registration.headers]);",
+    "      initializedHeaders.push(registration.sheetName);",
+    "      return;",
+    "    }",
+    "    var actual = sheet.getRange(1, 1, 1, registration.headers.length).getValues()[0];",
+    "    for (var index = 0; index < registration.headers.length; index += 1) {",
+    '      if (String(actual[index]) !== String(registration.headers[index])) {',
+    '        throw new Error("operational provisioning header mismatch: " + registration.sheetName);',
+    "      }",
+    "    }",
+    "  });",
+    "  return {",
+    "    registrations: args.registrations.map(function (registration) {",
+    "      return {",
+    "        sheetName: registration.sheetName,",
+    "        registeredRange: registration.registeredRange,",
+    "        projection: registration.projection,",
+    "        schemaVersion: registration.schemaVersion,",
+    "        identityField: registration.identityField,",
+    "      };",
+    "    }),",
+    "    createdSheets: createdSheets,",
+    "    initializedHeaders: initializedHeaders,",
+    "  };",
+    "}",
+].join("\n");
+const READ_PROJECTION_SOURCE = [
+    "function (spreadsheet, args) {",
+    '  var sheet = spreadsheet.getSheetByName(args.sheetName);',
+    '  if (sheet === null) throw new Error("operational sheet was not found: " + args.sheetName);',
+    "  var lastRow = sheet.getLastRow();",
+    "  var lastColumn = sheet.getLastColumn();",
+    "  var headers = lastColumn === 0 ? [] : sheet.getRange(1, 1, 1, lastColumn).getValues()[0];",
+    "  var rowCount = Math.max(0, lastRow - 1);",
+    "  var ids = rowCount === 0",
+    "    ? []",
+    "    : sheet.getRange(2, 1, rowCount, 1).getValues().map(function (row) { return String(row[0]); });",
+    "  return { sheetName: args.sheetName, headers: headers, rowCount: rowCount, ids: ids };",
+    "}",
+].join("\n");
+//# sourceMappingURL=operationSyncGateway.js.map

package/dist/adapter/sheets/providers/apps-script-gateway/transport/operationSyncGateway.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operationSyncGateway.js","sourceRoot":"","sources":["../../../../../../src/adapter/sheets/providers/apps-script-gateway/transport/operationSyncGateway.ts"],"names":[],"mappings":"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"}

package/dist/application/index.d.ts

@@ -0,0 +1,4 @@
+/** Application services and public ORM entrypoints. */
+export * from "./orm/index.js";
+export * from "./sync/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/application/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/application/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC"}

package/dist/application/index.js

@@ -0,0 +1,4 @@
+/** Application services and public ORM entrypoints. */
+export * from "./orm/index.js";
+export * from "./sync/index.js";
+//# sourceMappingURL=index.js.map

package/dist/application/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/application/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC"}

package/dist/application/orm/api/TypedSheetsOrm.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Public entity-manager facade owned by typed-sheets.
+ *
+ * The facade keeps the application workflow stable while a replaceable
+ * execution engine handles SQLite-specific persistence details underneath.
+ */
+import type { TypedSheetsEntityData, TypedSheetsEntityEngine, TypedSheetsEntityEngineManager, TypedSheetsEntityFilter, TypedSheetsEntityReference, TypedSheetsFindOptions, TypedSheetsForkOptions, TypedSheetsFlushCoordinator } from "./contracts.js";
+/** Options for creating our public typed-sheets ORM around one execution engine. */
+export interface CreateTypedSheetsOrmOptions {
+    /** Plans canonical and Sheets outbox work for every durable entity flush. */
+    readonly flushCoordinator: TypedSheetsFlushCoordinator;
+}
+/**
+ * Root object for typed-sheets entity lifecycle operations.
+ *
+ * Its `em` property exposes our manager rather than an engine-specific one,
+ * so application code cannot bypass the canonical and outbox flush plan.
+ */
+export declare class TypedSheetsOrm {
+    private readonly engine;
+    private readonly flushCoordinator;
+    /** Root entity manager; call `fork()` before request or job-local work. */
+    readonly em: TypedSheetsEntityManager;
+    constructor(engine: TypedSheetsEntityEngine, flushCoordinator: TypedSheetsFlushCoordinator);
+    /** Closes resources owned by the underlying SQLite execution engine. */
+    close(force?: boolean): Promise<void>;
+    private createEntityManager;
+}
+/** Creates our public entity facade around a replaceable SQLite execution engine. */
+export declare function createTypedSheetsOrm(engine: TypedSheetsEntityEngine, options: CreateTypedSheetsOrmOptions): TypedSheetsOrm;
+/**
+ * Entity-manager facade with the familiar entity lifecycle method names.
+ *
+ * The current public subset intentionally focuses on lifecycle-safe reads and
+ * `persist` / `remove` / `flush` operations while mapping metadata is built.
+ */
+export declare class TypedSheetsEntityManager {
+    private readonly entityManager;
+    private readonly flushCoordinator;
+    constructor(entityManager: TypedSheetsEntityEngineManager, flushCoordinator: TypedSheetsFlushCoordinator);
+    /** Creates an isolated manager with its own identity map. */
+    fork(options?: TypedSheetsForkOptions): TypedSheetsEntityManager;
+    /** Creates a managed entity instance without writing it until `flush()`. */
+    create<Entity extends object>(entityName: TypedSheetsEntityReference<Entity>, data: TypedSheetsEntityData<Entity>): Entity;
+    /** Reads all entities matching one initial equality filter from SQLite. */
+    find<Entity extends object>(entityName: TypedSheetsEntityReference<Entity>, where: TypedSheetsEntityFilter<Entity>, options?: TypedSheetsFindOptions): Promise<readonly Entity[]>;
+    /** Reads one entity or returns null when no entity matches the filter. */
+    findOne<Entity extends object>(entityName: TypedSheetsEntityReference<Entity>, where: TypedSheetsEntityFilter<Entity>, options?: TypedSheetsFindOptions): Promise<Entity | null>;
+    /** Marks one entity or iterable of entities for insertion or update at the next flush. */
+    persist<Entity extends object>(entity: Entity | Iterable<Entity>): this;
+    /** Marks one entity or iterable of entities for removal at the next flush. */
+    remove<Entity extends object>(entity: Entity | Iterable<Entity>): this;
+    /**
+     * Persists all pending entity changes with their typed-sheets sync plan.
+     *
+     * An existing transaction is reused. Otherwise this method opens a SQLite
+     * transaction itself so entity rows and outbox work commit or roll back
+     * together.
+     */
+    flush(): Promise<void>;
+    /**
+     * Runs entity work in one transaction and flushes it automatically on success.
+     *
+     * The callback receives another typed-sheets manager, so its flush still
+     * coordinates canonical and Sheets outbox work.
+     */
+    transactional<Result>(operation: (entityManager: TypedSheetsEntityManager) => Promise<Result>): Promise<Result>;
+    /** Detaches every managed entity from this request or job-local manager. */
+    clear(): void;
+}
+//# sourceMappingURL=TypedSheetsOrm.d.ts.map

package/dist/application/orm/api/TypedSheetsOrm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypedSheetsOrm.d.ts","sourceRoot":"","sources":["../../../../src/application/orm/api/TypedSheetsOrm.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,uBAAuB,EACvB,8BAA8B,EAC9B,uBAAuB,EACvB,0BAA0B,EAC1B,sBAAsB,EACtB,sBAAsB,EACtB,2BAA2B,EAC5B,MAAM,gBAAgB,CAAC;AAExB,oFAAoF;AACpF,MAAM,WAAW,2BAA2B;IAC1C,6EAA6E;IAC7E,QAAQ,CAAC,gBAAgB,EAAE,2BAA2B,CAAC;CACxD;AAED;;;;;GAKG;AACH,qBAAa,cAAc;IAKvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IALnC,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,EAAE,wBAAwB,CAAC;gBAGnB,MAAM,EAAE,uBAAuB,EAC/B,gBAAgB,EAAE,2BAA2B;IAKhE,wEAAwE;IAClE,KAAK,CAAC,KAAK,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC,OAAO,CAAC,mBAAmB;CAK5B;AAED,qFAAqF;AACrF,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,uBAAuB,EAC/B,OAAO,EAAE,2BAA2B,GACnC,cAAc,CAEhB;AAED;;;;;GAKG;AACH,qBAAa,wBAAwB;IAEjC,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;gBADhB,aAAa,EAAE,8BAA8B,EAC7C,gBAAgB,EAAE,2BAA2B;IAKhE,6DAA6D;IAC7D,IAAI,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,wBAAwB;IAOhE,4EAA4E;IAC5E,MAAM,CAAC,MAAM,SAAS,MAAM,EAC1B,UAAU,EAAE,0BAA0B,CAAC,MAAM,CAAC,EAC9C,IAAI,EAAE,qBAAqB,CAAC,MAAM,CAAC,GAClC,MAAM;IAIT,2EAA2E;IACrE,IAAI,CAAC,MAAM,SAAS,MAAM,EAC9B,UAAU,EAAE,0BAA0B,CAAC,MAAM,CAAC,EAC9C,KAAK,EAAE,uBAAuB,CAAC,MAAM,CAAC,EACtC,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC;IAI7B,0EAA0E;IACpE,OAAO,CAAC,MAAM,SAAS,MAAM,EACjC,UAAU,EAAE,0BAA0B,CAAC,MAAM,CAAC,EAC9C,KAAK,EAAE,uBAAuB,CAAC,MAAM,CAAC,EACtC,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIzB,0FAA0F;IAC1F,OAAO,CAAC,MAAM,SAAS,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI;IAKvE,8EAA8E;IAC9E,MAAM,CAAC,MAAM,SAAS,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI;IAKtE;;;;;;OAMG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB5B;;;;;OAKG;IACG,aAAa,CAAC,MAAM,EACxB,SAAS,EAAE,CAAC,aAAa,EAAE,wBAAwB,KAAK,OAAO,CAAC,MAAM,CAAC,GACtE,OAAO,CAAC,MAAM,CAAC;IAUlB,4EAA4E;IAC5E,KAAK,IAAI,IAAI;CAGd"}

package/dist/application/orm/api/TypedSheetsOrm.js

@@ -0,0 +1,116 @@
+/**
+ * Public entity-manager facade owned by typed-sheets.
+ *
+ * The facade keeps the application workflow stable while a replaceable
+ * execution engine handles SQLite-specific persistence details underneath.
+ */
+/**
+ * Root object for typed-sheets entity lifecycle operations.
+ *
+ * Its `em` property exposes our manager rather than an engine-specific one,
+ * so application code cannot bypass the canonical and outbox flush plan.
+ */
+export class TypedSheetsOrm {
+    engine;
+    flushCoordinator;
+    /** Root entity manager; call `fork()` before request or job-local work. */
+    em;
+    constructor(engine, flushCoordinator) {
+        this.engine = engine;
+        this.flushCoordinator = flushCoordinator;
+        this.em = this.createEntityManager(engine.fork());
+    }
+    /** Closes resources owned by the underlying SQLite execution engine. */
+    async close(force = false) {
+        await this.engine.close(force);
+    }
+    createEntityManager(entityManager) {
+        return new TypedSheetsEntityManager(entityManager, this.flushCoordinator);
+    }
+}
+/** Creates our public entity facade around a replaceable SQLite execution engine. */
+export function createTypedSheetsOrm(engine, options) {
+    return new TypedSheetsOrm(engine, options.flushCoordinator);
+}
+/**
+ * Entity-manager facade with the familiar entity lifecycle method names.
+ *
+ * The current public subset intentionally focuses on lifecycle-safe reads and
+ * `persist` / `remove` / `flush` operations while mapping metadata is built.
+ */
+export class TypedSheetsEntityManager {
+    entityManager;
+    flushCoordinator;
+    constructor(entityManager, flushCoordinator) {
+        this.entityManager = entityManager;
+        this.flushCoordinator = flushCoordinator;
+        this.entityManager.onFlush(async (context) => this.flushCoordinator.onFlush(context));
+    }
+    /** Creates an isolated manager with its own identity map. */
+    fork(options) {
+        return new TypedSheetsEntityManager(this.entityManager.fork(options), this.flushCoordinator);
+    }
+    /** Creates a managed entity instance without writing it until `flush()`. */
+    create(entityName, data) {
+        return this.entityManager.create(entityName, data);
+    }
+    /** Reads all entities matching one initial equality filter from SQLite. */
+    async find(entityName, where, options) {
+        return this.entityManager.find(entityName, where, options);
+    }
+    /** Reads one entity or returns null when no entity matches the filter. */
+    async findOne(entityName, where, options) {
+        return this.entityManager.findOne(entityName, where, options);
+    }
+    /** Marks one entity or iterable of entities for insertion or update at the next flush. */
+    persist(entity) {
+        this.entityManager.persist(entity);
+        return this;
+    }
+    /** Marks one entity or iterable of entities for removal at the next flush. */
+    remove(entity) {
+        this.entityManager.remove(entity);
+        return this;
+    }
+    /**
+     * Persists all pending entity changes with their typed-sheets sync plan.
+     *
+     * An existing transaction is reused. Otherwise this method opens a SQLite
+     * transaction itself so entity rows and outbox work commit or roll back
+     * together.
+     */
+    async flush() {
+        if (this.entityManager.isInTransaction()) {
+            await this.entityManager.flush();
+            return;
+        }
+        await this.entityManager.begin();
+        try {
+            await this.entityManager.flush();
+            await this.entityManager.commit();
+        }
+        catch (error) {
+            if (this.entityManager.isInTransaction()) {
+                await this.entityManager.rollback();
+            }
+            throw error;
+        }
+    }
+    /**
+     * Runs entity work in one transaction and flushes it automatically on success.
+     *
+     * The callback receives another typed-sheets manager, so its flush still
+     * coordinates canonical and Sheets outbox work.
+     */
+    async transactional(operation) {
+        return this.entityManager.transactional(async (transactionalEntityManager) => {
+            const manager = new TypedSheetsEntityManager(transactionalEntityManager, this.flushCoordinator);
+            return operation(manager);
+        });
+    }
+    /** Detaches every managed entity from this request or job-local manager. */
+    clear() {
+        this.entityManager.clear();
+    }
+}
+//# sourceMappingURL=TypedSheetsOrm.js.map

package/dist/application/orm/api/TypedSheetsOrm.js.map

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