hikoutei 0.2.0

package/dist/application/orm/mapping/identity.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Stable identity derivation for mapped entities.
+ *
+ * These helpers keep entity IDs, row anchors, and shared row-binding IDs
+ * deterministic across the system_state and user_input projections.
+ */
+import type { TypedSheetsEntityMapping } from "./contracts.js";
+/** Derives the stable row-binding ID shared by an entity's physical projections. */
+export declare function typedSheetsEntityRowBindingId(mapping: TypedSheetsEntityMapping, entityId: string): string;
+/** Derives and validates the projection anchor for one canonical entity. */
+export declare function typedSheetsEntityAnchor(mapping: TypedSheetsEntityMapping, entityId: string): string;
+/** Reads the mapping's string primary key from a pending entity change. */
+export declare function typedSheetsEntityId(mapping: TypedSheetsEntityMapping, entity: object): string;
+//# sourceMappingURL=identity.d.ts.map

package/dist/application/orm/mapping/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../../../src/application/orm/mapping/identity.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAE/D,oFAAoF;AACpF,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,wBAAwB,EACjC,QAAQ,EAAE,MAAM,GACf,MAAM,CAMR;AAED,4EAA4E;AAC5E,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,wBAAwB,EACjC,QAAQ,EAAE,MAAM,GACf,MAAM,CAKR;AAED,2EAA2E;AAC3E,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,wBAAwB,EACjC,MAAM,EAAE,MAAM,GACb,MAAM,CASR"}

package/dist/application/orm/mapping/identity.js

@@ -0,0 +1,37 @@
+/**
+ * Stable identity derivation for mapped entities.
+ *
+ * These helpers keep entity IDs, row anchors, and shared row-binding IDs
+ * deterministic across the system_state and user_input projections.
+ */
+import { EMPTY_STRING_LENGTH_ZERO, stableHash, } from "../../../domain/index.js";
+import { TYPED_SHEETS_ORM_ERROR_CODES, TypedSheetsOrmError, } from "../errors.js";
+/** Derives the stable row-binding ID shared by an entity's physical projections. */
+export function typedSheetsEntityRowBindingId(mapping, entityId) {
+    const anchor = typedSheetsEntityAnchor(mapping, entityId);
+    return "binding:" + stableHash({
+        logicalSheetId: mapping.logicalSheetId,
+        physicalAnchor: anchor,
+    });
+}
+/** Derives and validates the projection anchor for one canonical entity. */
+export function typedSheetsEntityAnchor(mapping, entityId) {
+    requireText(entityId, "entity ID");
+    const anchor = mapping.anchorForEntity(entityId);
+    requireText(anchor, "row anchor");
+    return anchor;
+}
+/** Reads the mapping's string primary key from a pending entity change. */
+export function typedSheetsEntityId(mapping, entity) {
+    const value = entity[mapping.primaryKey];
+    if (typeof value !== "string" || value.length === EMPTY_STRING_LENGTH_ZERO) {
+        throw new TypedSheetsOrmError(TYPED_SHEETS_ORM_ERROR_CODES.ENTITY_PRIMARY_KEY_UNAVAILABLE, `${mapping.entityName}.${mapping.primaryKey} must be a non-empty string before flush.`);
+    }
+    return value;
+}
+function requireText(value, label) {
+    if (value.length === EMPTY_STRING_LENGTH_ZERO) {
+        throw new TypedSheetsOrmError(TYPED_SHEETS_ORM_ERROR_CODES.INVALID_ENTITY_MAPPING, `${label} is required`);
+    }
+}
+//# sourceMappingURL=identity.js.map

package/dist/application/orm/mapping/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../../../src/application/orm/mapping/identity.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,wBAAwB,EACxB,UAAU,GACX,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,4BAA4B,EAC5B,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAGtB,oFAAoF;AACpF,MAAM,UAAU,6BAA6B,CAC3C,OAAiC,EACjC,QAAgB;IAEhB,MAAM,MAAM,GAAG,uBAAuB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC1D,OAAO,UAAU,GAAG,UAAU,CAAC;QAC7B,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,cAAc,EAAE,MAAM;KACvB,CAAC,CAAC;AACL,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,uBAAuB,CACrC,OAAiC,EACjC,QAAgB;IAEhB,WAAW,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IACnC,MAAM,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;IACjD,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAClC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,mBAAmB,CACjC,OAAiC,EACjC,MAAc;IAEd,MAAM,KAAK,GAAI,MAA4C,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAChF,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,wBAAwB,EAAE,CAAC;QAC3E,MAAM,IAAI,mBAAmB,CAC3B,4BAA4B,CAAC,8BAA8B,EAC3D,GAAG,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,UAAU,2CAA2C,CACvF,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,WAAW,CAAC,KAAa,EAAE,KAAa;IAC/C,IAAI,KAAK,CAAC,MAAM,KAAK,wBAAwB,EAAE,CAAC;QAC9C,MAAM,IAAI,mBAAmB,CAC3B,4BAA4B,CAAC,sBAAsB,EACnD,GAAG,KAAK,cAAc,CACvB,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/application/orm/mapping/observationMapping.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Adapter-neutral conversion from an accepted canonical observation to an
+ * application entity mutation.
+ *
+ * The storage writer remains responsible for validating and committing the
+ * Sheet observation first. This helper only translates that already-approved
+ * canonical result, so an ORM adapter cannot accidentally promote a conflict
+ * or quarantined user edit into an entity-table write.
+ */
+import type { CanonicalCommitInput } from "../../../infrastructure/storage/index.js";
+import { type TypedSheetsEntityMapping } from "./entityMapping.js";
+/** Runtime kinds of entity-table mutations derived from accepted observations. */
+export declare const MAPPED_OBSERVATION_ENTITY_MUTATION_KINDS: {
+    readonly NONE: "none";
+    readonly INSERT: "insert";
+    readonly UPDATE: "update";
+    readonly DELETE: "delete";
+};
+/** A safe entity-table mutation derived only from a canonical commit. */
+export type MappedObservationEntityMutation = {
+    readonly kind: typeof MAPPED_OBSERVATION_ENTITY_MUTATION_KINDS.NONE;
+} | {
+    readonly kind: typeof MAPPED_OBSERVATION_ENTITY_MUTATION_KINDS.INSERT;
+    readonly entityId: string;
+    readonly data: Readonly<Record<string, unknown>>;
+} | {
+    readonly kind: typeof MAPPED_OBSERVATION_ENTITY_MUTATION_KINDS.UPDATE;
+    readonly entityId: string;
+    readonly data: Readonly<Record<string, unknown>>;
+} | {
+    readonly kind: typeof MAPPED_OBSERVATION_ENTITY_MUTATION_KINDS.DELETE;
+    readonly entityId: string;
+};
+/**
+ * Translates one accepted canonical commit into a local entity-table mutation.
+ *
+ * Insert and update values come exclusively from canonical field writes, never
+ * from a raw Sheet payload. This preserves the evaluator's per-field conflict
+ * decision when an observation has both accepted and conflicting fields.
+ */
+export declare function planMappedObservationEntityMutation(mapping: TypedSheetsEntityMapping, commit: CanonicalCommitInput): MappedObservationEntityMutation;
+//# sourceMappingURL=observationMapping.d.ts.map

package/dist/application/orm/mapping/observationMapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observationMapping.d.ts","sourceRoot":"","sources":["../../../../src/application/orm/mapping/observationMapping.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,oBAAoB,CAAC;AAM5B,kFAAkF;AAClF,eAAO,MAAM,wCAAwC;;;;;CAK3C,CAAC;AAEX,yEAAyE;AACzE,MAAM,MAAM,+BAA+B,GACvC;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,wCAAwC,CAAC,IAAI,CAAA;CAAE,GACvE;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,wCAAwC,CAAC,MAAM,CAAC;IACtE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAClD,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,wCAAwC,CAAC,MAAM,CAAC;IACtE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAClD,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,wCAAwC,CAAC,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzG;;;;;;GAMG;AACH,wBAAgB,mCAAmC,CACjD,OAAO,EAAE,wBAAwB,EACjC,MAAM,EAAE,oBAAoB,GAC3B,+BAA+B,CA2CjC"}

package/dist/application/orm/mapping/observationMapping.js

@@ -0,0 +1,65 @@
+/**
+ * Adapter-neutral conversion from an accepted canonical observation to an
+ * application entity mutation.
+ *
+ * The storage writer remains responsible for validating and committing the
+ * Sheet observation first. This helper only translates that already-approved
+ * canonical result, so an ORM adapter cannot accidentally promote a conflict
+ * or quarantined user edit into an entity-table write.
+ */
+import { ROW_OPERATIONS } from "../../../domain/index.js";
+import { decodeTypedSheetsEntityField, requireTypedSheetsEntityField, } from "./entityMapping.js";
+import { TYPED_SHEETS_ORM_ERROR_CODES, TypedSheetsOrmError, } from "../errors.js";
+/** Runtime kinds of entity-table mutations derived from accepted observations. */
+export const MAPPED_OBSERVATION_ENTITY_MUTATION_KINDS = {
+    NONE: "none",
+    INSERT: "insert",
+    UPDATE: "update",
+    DELETE: "delete",
+};
+/**
+ * Translates one accepted canonical commit into a local entity-table mutation.
+ *
+ * Insert and update values come exclusively from canonical field writes, never
+ * from a raw Sheet payload. This preserves the evaluator's per-field conflict
+ * decision when an observation has both accepted and conflicting fields.
+ */
+export function planMappedObservationEntityMutation(mapping, commit) {
+    if (commit.kind === ROW_OPERATIONS.DELETE) {
+        return {
+            kind: MAPPED_OBSERVATION_ENTITY_MUTATION_KINDS.DELETE,
+            entityId: commit.entityId,
+        };
+    }
+    const data = {};
+    if (commit.kind === ROW_OPERATIONS.INSERT) {
+        data[mapping.primaryKey] = commit.entityId;
+    }
+    for (const write of commit.fields) {
+        const field = requireTypedSheetsEntityField(mapping, write.fieldName);
+        const value = decodeTypedSheetsEntityField(mapping, field, write.value);
+        if (field.property === mapping.primaryKey) {
+            if (value !== commit.entityId) {
+                throw new TypedSheetsOrmError(TYPED_SHEETS_ORM_ERROR_CODES.ENTITY_PRIMARY_KEY_MISMATCH, `${mapping.entityName}.${mapping.primaryKey} does not match the canonical entity ID.`);
+            }
+            data[field.property] = value;
+            continue;
+        }
+        data[field.property] = value;
+    }
+    if (commit.kind === ROW_OPERATIONS.INSERT) {
+        return {
+            kind: MAPPED_OBSERVATION_ENTITY_MUTATION_KINDS.INSERT,
+            entityId: commit.entityId,
+            data,
+        };
+    }
+    return Object.keys(data).length === 0
+        ? { kind: MAPPED_OBSERVATION_ENTITY_MUTATION_KINDS.NONE }
+        : {
+            kind: MAPPED_OBSERVATION_ENTITY_MUTATION_KINDS.UPDATE,
+            entityId: commit.entityId,
+            data,
+        };
+}
+//# sourceMappingURL=observationMapping.js.map

package/dist/application/orm/mapping/observationMapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observationMapping.js","sourceRoot":"","sources":["../../../../src/application/orm/mapping/observationMapping.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EACL,4BAA4B,EAC5B,6BAA6B,GAE9B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,4BAA4B,EAC5B,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAEtB,kFAAkF;AAClF,MAAM,CAAC,MAAM,wCAAwC,GAAG;IACtD,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;CACR,CAAC;AAiBX;;;;;;GAMG;AACH,MAAM,UAAU,mCAAmC,CACjD,OAAiC,EACjC,MAA4B;IAE5B,IAAI,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC,MAAM,EAAE,CAAC;QAC1C,OAAO;YACL,IAAI,EAAE,wCAAwC,CAAC,MAAM;YACrD,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAA4B,EAAE,CAAC;IACzC,IAAI,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC,MAAM,EAAE,CAAC;QAC1C,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC;IAC7C,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,6BAA6B,CAAC,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QACtE,MAAM,KAAK,GAAG,4BAA4B,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QACxE,IAAI,KAAK,CAAC,QAAQ,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC;YAC1C,IAAI,KAAK,KAAK,MAAM,CAAC,QAAQ,EAAE,CAAC;gBAC9B,MAAM,IAAI,mBAAmB,CAC3B,4BAA4B,CAAC,2BAA2B,EACxD,GAAG,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,UAAU,0CAA0C,CACtF,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC;YAC7B,SAAS;QACX,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC;IAC/B,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC,MAAM,EAAE,CAAC;QAC1C,OAAO;YACL,IAAI,EAAE,wCAAwC,CAAC,MAAM;YACrD,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,IAAI;SACL,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QACnC,CAAC,CAAC,EAAE,IAAI,EAAE,wCAAwC,CAAC,IAAI,EAAE;QACzD,CAAC,CAAC;YACE,IAAI,EAAE,wCAAwC,CAAC,MAAM;YACrD,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,IAAI;SACL,CAAC;AACR,CAAC"}

package/dist/application/orm/mapping/projection.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Converts validated entity mappings into sync projection metadata.
+ *
+ * This module owns ownership manifests, projection headers, and registration
+ * payloads; it does not validate entity declarations or encode field values.
+ */
+import { type OwnershipManifest } from "../../../domain/index.js";
+import type { RegisterSyncSheetInput } from "../../../infrastructure/storage/index.js";
+import type { TypedSheetsEntityMapping, TypedSheetsEntityProjection, TypedSheetsEntityProjectionMapping, TypedSheetsMappedProjectionDefinition } from "./contracts.js";
+/** Returns the one physical route registered for the requested projection kind. */
+export declare function requireTypedSheetsEntityProjection(mapping: TypedSheetsEntityMapping, projection: TypedSheetsEntityProjection): TypedSheetsEntityProjectionMapping;
+/** Builds the core ownership manifest used by evaluation for this entity mapping. */
+export declare function createTypedSheetsEntityOwnershipManifest(mapping: TypedSheetsEntityMapping): OwnershipManifest;
+/** Serializes the logical ownership manifest in deterministic field-name order. */
+export declare function serializeTypedSheetsEntityOwnershipManifest(mapping: TypedSheetsEntityMapping): string;
+/** Returns the headers that setup must materialize for one physical projection. */
+export declare function typedSheetsEntityProjectionHeaders(mapping: TypedSheetsEntityMapping, projection: TypedSheetsEntityProjection): readonly string[];
+/** Creates one registry declaration for a validated mapping projection. */
+export declare function createTypedSheetsEntityProjectionRegistration(mapping: TypedSheetsEntityMapping, projection: TypedSheetsEntityProjectionMapping): RegisterSyncSheetInput;
+/** Returns every setup definition necessary to register and provision a mapping collection. */
+export declare function createTypedSheetsMappedProjectionDefinitions(mappings: readonly TypedSheetsEntityMapping[]): readonly TypedSheetsMappedProjectionDefinition[];
+//# sourceMappingURL=projection.d.ts.map

package/dist/application/orm/mapping/projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../../../../src/application/orm/mapping/projection.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,sBAAsB,EAAwB,MAAM,0CAA0C,CAAC;AAK7G,OAAO,KAAK,EACV,wBAAwB,EACxB,2BAA2B,EAC3B,kCAAkC,EAClC,qCAAqC,EACtC,MAAM,gBAAgB,CAAC;AAExB,mFAAmF;AACnF,wBAAgB,kCAAkC,CAChD,OAAO,EAAE,wBAAwB,EACjC,UAAU,EAAE,2BAA2B,GACtC,kCAAkC,CASpC;AAED,qFAAqF;AACrF,wBAAgB,wCAAwC,CACtD,OAAO,EAAE,wBAAwB,GAChC,iBAAiB,CAgBnB;AAED,mFAAmF;AACnF,wBAAgB,2CAA2C,CACzD,OAAO,EAAE,wBAAwB,GAChC,MAAM,CAIR;AAED,mFAAmF;AACnF,wBAAgB,kCAAkC,CAChD,OAAO,EAAE,wBAAwB,EACjC,UAAU,EAAE,2BAA2B,GACtC,SAAS,MAAM,EAAE,CASnB;AAED,2EAA2E;AAC3E,wBAAgB,6CAA6C,CAC3D,OAAO,EAAE,wBAAwB,EACjC,UAAU,EAAE,kCAAkC,GAC7C,sBAAsB,CAYxB;AAED,+FAA+F;AAC/F,wBAAgB,4CAA4C,CAC1D,QAAQ,EAAE,SAAS,wBAAwB,EAAE,GAC5C,SAAS,qCAAqC,EAAE,CAOlD"}

package/dist/application/orm/mapping/projection.js

@@ -0,0 +1,74 @@
+/**
+ * Converts validated entity mappings into sync projection metadata.
+ *
+ * This module owns ownership manifests, projection headers, and registration
+ * payloads; it does not validate entity declarations or encode field values.
+ */
+import { FIELD_OWNERSHIPS, } from "../../../domain/index.js";
+import { SYNC_GATEWAY_PROJECTIONS } from "../../sync/gateway/constants.js";
+import { TYPED_SHEETS_ORM_ERROR_CODES, TypedSheetsOrmError, } from "../errors.js";
+/** Returns the one physical route registered for the requested projection kind. */
+export function requireTypedSheetsEntityProjection(mapping, projection) {
+    const result = mapping.projections.find((candidate) => candidate.projection === projection);
+    if (result === undefined) {
+        throw new TypedSheetsOrmError(TYPED_SHEETS_ORM_ERROR_CODES.INVALID_ENTITY_MAPPING, `${mapping.entityName} does not declare a ${projection} projection.`);
+    }
+    return result;
+}
+/** Builds the core ownership manifest used by evaluation for this entity mapping. */
+export function createTypedSheetsEntityOwnershipManifest(mapping) {
+    return new Map(mapping.fields.map((field) => [
+        field.fieldName,
+        {
+            fieldName: field.fieldName,
+            ownership: field.ownership,
+            projection: field.ownership === FIELD_OWNERSHIPS.USER
+                ? SYNC_GATEWAY_PROJECTIONS.USER_INPUT
+                : SYNC_GATEWAY_PROJECTIONS.SYSTEM_STATE,
+            type: field.cellKind,
+            required: field.required,
+            unique: field.unique,
+        },
+    ]));
+}
+/** Serializes the logical ownership manifest in deterministic field-name order. */
+export function serializeTypedSheetsEntityOwnershipManifest(mapping) {
+    const fields = [...createTypedSheetsEntityOwnershipManifest(mapping).values()]
+        .sort((left, right) => left.fieldName.localeCompare(right.fieldName));
+    return JSON.stringify({ fields });
+}
+/** Returns the headers that setup must materialize for one physical projection. */
+export function typedSheetsEntityProjectionHeaders(mapping, projection) {
+    const fieldNames = projection === SYNC_GATEWAY_PROJECTIONS.SYSTEM_STATE
+        ? mapping.fields.map((field) => field.fieldName)
+        : mapping.fields
+            .filter((field) => field.ownership === FIELD_OWNERSHIPS.USER)
+            .map((field) => field.fieldName);
+    return projection === SYNC_GATEWAY_PROJECTIONS.SYSTEM_STATE
+        ? [...fieldNames, mapping.tombstoneFieldName]
+        : fieldNames;
+}
+/** Creates one registry declaration for a validated mapping projection. */
+export function createTypedSheetsEntityProjectionRegistration(mapping, projection) {
+    return {
+        logicalSheetId: mapping.logicalSheetId,
+        physicalSheetId: projection.physicalSheetId,
+        spreadsheetId: projection.spreadsheetId,
+        tabName: projection.tabName,
+        registeredRange: projection.registeredRange,
+        projection: projection.projection,
+        schemaVersion: mapping.schemaVersion,
+        ownershipManifestJson: serializeTypedSheetsEntityOwnershipManifest(mapping),
+        businessKeyField: mapping.businessKey.fieldName,
+    };
+}
+/** Returns every setup definition necessary to register and provision a mapping collection. */
+export function createTypedSheetsMappedProjectionDefinitions(mappings) {
+    return mappings.flatMap((mapping) => mapping.projections.map((projection) => ({
+        mapping,
+        projection,
+        registration: createTypedSheetsEntityProjectionRegistration(mapping, projection),
+        headers: typedSheetsEntityProjectionHeaders(mapping, projection.projection),
+    })));
+}
+//# sourceMappingURL=projection.js.map

package/dist/application/orm/mapping/projection.js.map

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

package/dist/application/orm/mapping/registry.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Lookup registry for validated entity mappings.
+ *
+ * Registry construction is kept separate from mapping validation so route
+ * uniqueness and runtime lookup behavior can be read and tested independently.
+ */
+import type { TypedSheetsEntityMapping, TypedSheetsEntityMappingRegistry } from "./contracts.js";
+/**
+ * Creates lookup indexes for a group of entity mappings.
+ *
+ * Logical and physical routes are unique so one incoming Sheet observation can
+ * never be applied to two different application entity types.
+ */
+export declare function createTypedSheetsEntityMappingRegistry(mappings: readonly TypedSheetsEntityMapping[]): TypedSheetsEntityMappingRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/application/orm/mapping/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/application/orm/mapping/registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EACV,wBAAwB,EACxB,gCAAgC,EACjC,MAAM,gBAAgB,CAAC;AAExB;;;;;GAKG;AACH,wBAAgB,sCAAsC,CACpD,QAAQ,EAAE,SAAS,wBAAwB,EAAE,GAC5C,gCAAgC,CAwBlC"}

package/dist/application/orm/mapping/registry.js

@@ -0,0 +1,38 @@
+/**
+ * Lookup registry for validated entity mappings.
+ *
+ * Registry construction is kept separate from mapping validation so route
+ * uniqueness and runtime lookup behavior can be read and tested independently.
+ */
+import { TYPED_SHEETS_ORM_ERROR_CODES, TypedSheetsOrmError, } from "../errors.js";
+/**
+ * Creates lookup indexes for a group of entity mappings.
+ *
+ * Logical and physical routes are unique so one incoming Sheet observation can
+ * never be applied to two different application entity types.
+ */
+export function createTypedSheetsEntityMappingRegistry(mappings) {
+    const byEntityName = new Map();
+    const byLogicalSheetId = new Map();
+    const byPhysicalSheetId = new Map();
+    for (const mapping of mappings) {
+        insertUniqueMapping(byEntityName, mapping.entityName, mapping, "entity name");
+        insertUniqueMapping(byLogicalSheetId, mapping.logicalSheetId, mapping, "logical sheet ID");
+        for (const projection of mapping.projections) {
+            insertUniqueMapping(byPhysicalSheetId, projection.physicalSheetId, mapping, "physical sheet ID");
+        }
+    }
+    return {
+        mappings: [...mappings],
+        findByEntityName: (entityName) => byEntityName.get(entityName),
+        findByLogicalSheetId: (logicalSheetId) => byLogicalSheetId.get(logicalSheetId),
+        findByPhysicalSheetId: (physicalSheetId) => byPhysicalSheetId.get(physicalSheetId),
+    };
+}
+function insertUniqueMapping(index, key, mapping, label) {
+    if (index.has(key)) {
+        throw new TypedSheetsOrmError(TYPED_SHEETS_ORM_ERROR_CODES.DUPLICATE_ENTITY_MAPPING, `typed-sheets mappings cannot repeat ${label}: ${key}.`);
+    }
+    index.set(key, mapping);
+}
+//# sourceMappingURL=registry.js.map

package/dist/application/orm/mapping/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../../src/application/orm/mapping/registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,4BAA4B,EAC5B,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAMtB;;;;;GAKG;AACH,MAAM,UAAU,sCAAsC,CACpD,QAA6C;IAE7C,MAAM,YAAY,GAAG,IAAI,GAAG,EAAoC,CAAC;IACjE,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAoC,CAAC;IACrE,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAoC,CAAC;IAEtE,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,mBAAmB,CAAC,YAAY,EAAE,OAAO,CAAC,UAAU,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;QAC9E,mBAAmB,CAAC,gBAAgB,EAAE,OAAO,CAAC,cAAc,EAAE,OAAO,EAAE,kBAAkB,CAAC,CAAC;QAC3F,KAAK,MAAM,UAAU,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YAC7C,mBAAmB,CACjB,iBAAiB,EACjB,UAAU,CAAC,eAAe,EAC1B,OAAO,EACP,mBAAmB,CACpB,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC;QACvB,gBAAgB,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC;QAC9D,oBAAoB,EAAE,CAAC,cAAc,EAAE,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,cAAc,CAAC;QAC9E,qBAAqB,EAAE,CAAC,eAAe,EAAE,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC,eAAe,CAAC;KACnF,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAC1B,KAA4C,EAC5C,GAAW,EACX,OAAiC,EACjC,KAAa;IAEb,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACnB,MAAM,IAAI,mBAAmB,CAC3B,4BAA4B,CAAC,wBAAwB,EACrD,uCAAuC,KAAK,KAAK,GAAG,GAAG,CACxD,CAAC;IACJ,CAAC;IACD,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AAC1B,CAAC"}

package/dist/application/orm/mapping/values.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Converts mapped entity values to and from normalized Sheet cells.
+ *
+ * Custom codecs are accepted at this boundary, but every result is still
+ * checked against the declared normalized-cell contract before persistence.
+ */
+import { type NormalizedCell } from "../../../domain/index.js";
+import type { TypedSheetsEntityFieldMapping, TypedSheetsEntityMapping } from "./contracts.js";
+/** Encodes every mapped entity property into its canonical normalized-cell value. */
+export declare function encodeTypedSheetsEntity(mapping: TypedSheetsEntityMapping, entity: object): Readonly<Record<string, NormalizedCell>>;
+/** Encodes one mapped property while enforcing its declared normalized-cell contract. */
+export declare function encodeTypedSheetsEntityField(mapping: TypedSheetsEntityMapping, field: TypedSheetsEntityFieldMapping, value: unknown): NormalizedCell;
+/** Decodes one accepted canonical cell into the mapped application property value. */
+export declare function decodeTypedSheetsEntityField(mapping: TypedSheetsEntityMapping, field: TypedSheetsEntityFieldMapping, value: NormalizedCell): unknown;
+/** Finds the field declaration for one canonical field name or fails closed. */
+export declare function requireTypedSheetsEntityField(mapping: TypedSheetsEntityMapping, fieldName: string): TypedSheetsEntityFieldMapping;
+//# sourceMappingURL=values.d.ts.map

package/dist/application/orm/mapping/values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"values.d.ts","sourceRoot":"","sources":["../../../../src/application/orm/mapping/values.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,0BAA0B,CAAC;AASlC,OAAO,KAAK,EACV,6BAA6B,EAC7B,wBAAwB,EACzB,MAAM,gBAAgB,CAAC;AAExB,qFAAqF;AACrF,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,wBAAwB,EACjC,MAAM,EAAE,MAAM,GACb,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAU1C;AAED,yFAAyF;AACzF,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,wBAAwB,EACjC,KAAK,EAAE,6BAA6B,EACpC,KAAK,EAAE,OAAO,GACb,cAAc,CAKhB;AAED,sFAAsF;AACtF,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,wBAAwB,EACjC,KAAK,EAAE,6BAA6B,EACpC,KAAK,EAAE,cAAc,GACpB,OAAO,CAYT;AAED,gFAAgF;AAChF,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,wBAAwB,EACjC,SAAS,EAAE,MAAM,GAChB,6BAA6B,CAS/B"}

package/dist/application/orm/mapping/values.js

@@ -0,0 +1,141 @@
+/**
+ * Converts mapped entity values to and from normalized Sheet cells.
+ *
+ * Custom codecs are accepted at this boundary, but every result is still
+ * checked against the declared normalized-cell contract before persistence.
+ */
+import { EMPTY_STRING_LENGTH_ZERO, } from "../../../domain/index.js";
+import { NORMALIZED_CELL_KINDS, } from "../../../shared/encoding/constants.js";
+import { TYPED_SHEETS_ORM_ERROR_CODES, TypedSheetsOrmError, } from "../errors.js";
+/** Encodes every mapped entity property into its canonical normalized-cell value. */
+export function encodeTypedSheetsEntity(mapping, entity) {
+    const encoded = {};
+    for (const field of mapping.fields) {
+        encoded[field.fieldName] = encodeTypedSheetsEntityField(mapping, field, readEntityProperty(entity, field.property));
+    }
+    return encoded;
+}
+/** Encodes one mapped property while enforcing its declared normalized-cell contract. */
+export function encodeTypedSheetsEntityField(mapping, field, value) {
+    const cell = field.encode === undefined
+        ? defaultEncode(field, value)
+        : field.encode(value);
+    return requireValidMappedCell(mapping, field, cell);
+}
+/** Decodes one accepted canonical cell into the mapped application property value. */
+export function decodeTypedSheetsEntityField(mapping, field, value) {
+    const cell = requireValidMappedCell(mapping, field, value);
+    if (field.decode !== undefined)
+        return field.decode(cell);
+    if (cell === null)
+        return null;
+    switch (cell.kind) {
+        case NORMALIZED_CELL_KINDS.STRING:
+        case NORMALIZED_CELL_KINDS.NUMBER:
+        case NORMALIZED_CELL_KINDS.BOOLEAN:
+            return cell.value;
+        case NORMALIZED_CELL_KINDS.DATE:
+            return new Date(cell.value);
+    }
+}
+/** Finds the field declaration for one canonical field name or fails closed. */
+export function requireTypedSheetsEntityField(mapping, fieldName) {
+    const field = mapping.fields.find((candidate) => candidate.fieldName === fieldName);
+    if (field === undefined) {
+        throw new TypedSheetsOrmError(TYPED_SHEETS_ORM_ERROR_CODES.INVALID_ENTITY_MAPPING, `${mapping.entityName} does not map canonical field ${fieldName}.`);
+    }
+    return field;
+}
+function readEntityProperty(entity, property) {
+    return entity[property];
+}
+function defaultEncode(field, value) {
+    if (value === null)
+        return null;
+    switch (field.cellKind) {
+        case NORMALIZED_CELL_KINDS.STRING:
+            return typeof value === "string"
+                ? { kind: NORMALIZED_CELL_KINDS.STRING, value }
+                : invalidMappedFieldValue(field, "must be a string or null");
+        case NORMALIZED_CELL_KINDS.NUMBER:
+            return typeof value === "number" && Number.isFinite(value)
+                ? { kind: NORMALIZED_CELL_KINDS.NUMBER, value }
+                : invalidMappedFieldValue(field, "must be a finite number or null");
+        case NORMALIZED_CELL_KINDS.BOOLEAN:
+            return typeof value === "boolean"
+                ? { kind: NORMALIZED_CELL_KINDS.BOOLEAN, value }
+                : invalidMappedFieldValue(field, "must be a boolean or null");
+        case NORMALIZED_CELL_KINDS.DATE:
+            return defaultDateCell(field, value);
+    }
+}
+function defaultDateCell(field, value) {
+    if (value instanceof Date) {
+        if (!Number.isFinite(value.getTime())) {
+            return invalidMappedFieldValue(field, "must be a valid Date or canonical ISO date string");
+        }
+        return { kind: NORMALIZED_CELL_KINDS.DATE, value: value.toISOString() };
+    }
+    if (typeof value === "string" && isCanonicalIsoDate(value)) {
+        return { kind: NORMALIZED_CELL_KINDS.DATE, value };
+    }
+    return invalidMappedFieldValue(field, "must be a valid Date or canonical ISO date string");
+}
+function requireValidMappedCell(mapping, field, cell) {
+    if (cell === null) {
+        if (field.required) {
+            throwInvalidFieldValue(mapping, field, "cannot be blank");
+        }
+        return cell;
+    }
+    if (!isNonNullNormalizedCell(cell)) {
+        throwInvalidFieldValue(mapping, field, "must encode as a normalized cell or null");
+    }
+    if (cell.kind !== field.cellKind) {
+        throwInvalidFieldValue(mapping, field, `must encode as ${field.cellKind}`);
+    }
+    if (field.required &&
+        cell.kind === NORMALIZED_CELL_KINDS.STRING &&
+        cell.value.length === EMPTY_STRING_LENGTH_ZERO) {
+        throwInvalidFieldValue(mapping, field, "cannot be an empty string");
+    }
+    if (cell.kind === NORMALIZED_CELL_KINDS.NUMBER && !Number.isFinite(cell.value)) {
+        throwInvalidFieldValue(mapping, field, "must be a finite number");
+    }
+    if (cell.kind === NORMALIZED_CELL_KINDS.DATE && !isCanonicalIsoDate(cell.value)) {
+        throwInvalidFieldValue(mapping, field, "must be a canonical ISO date string");
+    }
+    return cell;
+}
+function isCanonicalIsoDate(value) {
+    if (!/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$/.test(value))
+        return false;
+    const timestamp = Date.parse(value);
+    return Number.isFinite(timestamp) && new Date(timestamp).toISOString() === value;
+}
+function isNonNullNormalizedCell(value) {
+    if (!isRecord(value))
+        return false;
+    switch (value.kind) {
+        case NORMALIZED_CELL_KINDS.STRING:
+        case NORMALIZED_CELL_KINDS.DATE:
+            return typeof value.value === "string";
+        case NORMALIZED_CELL_KINDS.NUMBER:
+            return typeof value.value === "number";
+        case NORMALIZED_CELL_KINDS.BOOLEAN:
+            return typeof value.value === "boolean";
+        default:
+            return false;
+    }
+}
+/** Promotes unknown codec output to a non-array record before tag inspection. */
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function invalidMappedFieldValue(field, message) {
+    throw new TypedSheetsOrmError(TYPED_SHEETS_ORM_ERROR_CODES.INVALID_MAPPED_FIELD_VALUE, `${field.property} ${message}.`);
+}
+function throwInvalidFieldValue(mapping, field, message) {
+    throw new TypedSheetsOrmError(TYPED_SHEETS_ORM_ERROR_CODES.INVALID_MAPPED_FIELD_VALUE, `${mapping.entityName}.${field.property} ${message}.`);
+}
+//# sourceMappingURL=values.js.map

package/dist/application/orm/mapping/values.js.map

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

package/dist/application/orm/persistence/flush/flushCoordinator.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Public mapped persistence orchestration.
+ *
+ * This module collects entity changes, fences the flush with a writer lease,
+ * and delegates each lifecycle operation to the focused persistence helpers.
+ */
+import type { RegisteredSyncProjectionDefinition } from "../../../sync/gateway/SyncGatewayBootstrap.js";
+import type { SqlStorageAdapter } from "../../../../adapter/persistence/contracts/sql.js";
+import { type TypedSheetsFlushCoordinator } from "../../api/contracts.js";
+import { type TypedSheetsEntityMapping, type TypedSheetsEntityMappingRegistry } from "../../mapping/entityMapping.js";
+import { type CreateMappedTypedSheetsFlushCoordinatorOptions, type RegisteredTypedSheetsMappedProjection, type TypedSheetsEntityWriterOptions } from "../support/contracts.js";
+/**
+ * Creates the built-in planner that makes `em.persist()` / `em.flush()` durable
+ * in the entity table, canonical state, business-key index, and Sheets outbox
+ * together.
+ */
+export declare function createMappedTypedSheetsFlushCoordinator(options: CreateMappedTypedSheetsFlushCoordinatorOptions): TypedSheetsFlushCoordinator;
+/**
+ * Registers every mapping route under one writer fence.
+ *
+ * The return value can be passed directly to the existing gateway provisioning
+ * helper, so users never need to duplicate route names or header lists in Apps
+ * Script configuration.
+ */
+export declare function registerTypedSheetsEntityMappings(storage: SqlStorageAdapter, mappingsInput: TypedSheetsEntityMappingRegistry | readonly TypedSheetsEntityMapping[], writerInput: TypedSheetsEntityWriterOptions): Promise<readonly RegisteredTypedSheetsMappedProjection[]>;
+/** Converts registered mapping routes into gateway provisioning definitions. */
+export declare function registeredTypedSheetsProjectionDefinitions(registrations: readonly RegisteredTypedSheetsMappedProjection[]): readonly RegisteredSyncProjectionDefinition[];
+//# sourceMappingURL=flushCoordinator.d.ts.map

package/dist/application/orm/persistence/flush/flushCoordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flushCoordinator.d.ts","sourceRoot":"","sources":["../../../../../src/application/orm/persistence/flush/flushCoordinator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,+CAA+C,CAAC;AACxG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kDAAkD,CAAC;AAC1F,OAAO,EAIL,KAAK,2BAA2B,EACjC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAKL,KAAK,wBAAwB,EAC7B,KAAK,gCAAgC,EACtC,MAAM,gCAAgC,CAAC;AAKxC,OAAO,EAGL,KAAK,8CAA8C,EAEnD,KAAK,qCAAqC,EAE1C,KAAK,8BAA8B,EACpC,MAAM,yBAAyB,CAAC;AAQjC;;;;GAIG;AACH,wBAAgB,uCAAuC,CACrD,OAAO,EAAE,8CAA8C,GACtD,2BAA2B,CAmD7B;AAED;;;;;;GAMG;AACH,wBAAsB,iCAAiC,CACrD,OAAO,EAAE,iBAAiB,EAC1B,aAAa,EAAE,gCAAgC,GAAG,SAAS,wBAAwB,EAAE,EACrF,WAAW,EAAE,8BAA8B,GAC1C,OAAO,CAAC,SAAS,qCAAqC,EAAE,CAAC,CA2C3D;AAED,gFAAgF;AAChF,wBAAgB,0CAA0C,CACxD,aAAa,EAAE,SAAS,qCAAqC,EAAE,GAC9D,SAAS,kCAAkC,EAAE,CAE/C"}