hikoutei 0.2.0

package/dist/application/orm/persistence/support/businessKeys.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Business-key index maintenance for mapped entity persistence.
+ *
+ * The index is kept in the same SQLite transaction as the canonical entity
+ * write, so duplicate and rotated keys cannot become visible independently of
+ * the entity lifecycle change.
+ */
+import { type NormalizedCell } from "../../../../domain/index.js";
+import type { SqlExecutor } from "../../../../adapter/persistence/contracts/sql.js";
+import type { TypedSheetsEntityMapping } from "../../mapping/entityMapping.js";
+/** Claims the mapped entity's normalized business key during creation. */
+export declare function claimBusinessKey(sql: SqlExecutor, mapping: TypedSheetsEntityMapping, entityId: string, encodedEntity: Readonly<Record<string, NormalizedCell>>): Promise<void>;
+/** Rotates the indexed business key after an accepted entity update. */
+export declare function rotateBusinessKey(sql: SqlExecutor, mapping: TypedSheetsEntityMapping, entityId: string, encodedEntity: Readonly<Record<string, NormalizedCell>>): Promise<void>;
+/** Retires all business keys owned by a deleted mapped entity. */
+export declare function retireEntityBusinessKeys(sql: SqlExecutor, mapping: TypedSheetsEntityMapping, entityId: string): Promise<void>;
+//# sourceMappingURL=businessKeys.d.ts.map

package/dist/application/orm/persistence/support/businessKeys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"businessKeys.d.ts","sourceRoot":"","sources":["../../../../../src/application/orm/persistence/support/businessKeys.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kDAAkD,CAAC;AACpF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAgB/E,0EAA0E;AAC1E,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,wBAAwB,EACjC,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,GACtD,OAAO,CAAC,IAAI,CAAC,CAGf;AAED,wEAAwE;AACxE,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,wBAAwB,EACjC,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,GACtD,OAAO,CAAC,IAAI,CAAC,CA2Bf;AAED,kEAAkE;AAClE,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,wBAAwB,EACjC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAQf"}

package/dist/application/orm/persistence/support/businessKeys.js

@@ -0,0 +1,72 @@
+/**
+ * Business-key index maintenance for mapped entity persistence.
+ *
+ * The index is kept in the same SQLite transaction as the canonical entity
+ * write, so duplicate and rotated keys cannot become visible independently of
+ * the entity lifecycle change.
+ */
+import { stableHash } from "../../../../domain/index.js";
+import { TYPED_SHEETS_ORM_ERROR_CODES, TypedSheetsOrmError, } from "../../errors.js";
+import { INSERT_ACTIVE_BUSINESS_KEY_SQL, READ_ACTIVE_BUSINESS_KEY_SQL, READ_BUSINESS_KEY_OWNER_SQL, RETIRE_ACTIVE_BUSINESS_KEY_SQL, RETIRE_ENTITY_BUSINESS_KEYS_SQL, } from "./contracts.js";
+import { requireEncodedField } from "./helpers.js";
+/** Claims the mapped entity's normalized business key during creation. */
+export async function claimBusinessKey(sql, mapping, entityId, encodedEntity) {
+    const normalizedKey = businessKeyHash(mapping, encodedEntity);
+    await ensureBusinessKeyOwner(sql, mapping, entityId, normalizedKey);
+}
+/** Rotates the indexed business key after an accepted entity update. */
+export async function rotateBusinessKey(sql, mapping, entityId, encodedEntity) {
+    const current = await sql.get(READ_ACTIVE_BUSINESS_KEY_SQL, [
+        mapping.logicalSheetId,
+        mapping.businessKey.fieldName,
+        entityId,
+    ]);
+    if (current === undefined) {
+        throw new TypedSheetsOrmError(TYPED_SHEETS_ORM_ERROR_CODES.CANONICAL_COMMIT_REJECTED, `business-key index is unavailable for ${mapping.entityName}:${entityId}.`);
+    }
+    const nextNormalizedKey = businessKeyHash(mapping, encodedEntity);
+    if (current.normalized_key === nextNormalizedKey)
+        return;
+    const retired = await sql.run(RETIRE_ACTIVE_BUSINESS_KEY_SQL, [
+        mapping.logicalSheetId,
+        mapping.businessKey.fieldName,
+        current.normalized_key,
+        entityId,
+    ]);
+    if (retired.changes !== 1) {
+        throw new TypedSheetsOrmError(TYPED_SHEETS_ORM_ERROR_CODES.CANONICAL_COMMIT_REJECTED, `could not retire the previous business key for ${mapping.entityName}:${entityId}.`);
+    }
+    await ensureBusinessKeyOwner(sql, mapping, entityId, nextNormalizedKey);
+}
+/** Retires all business keys owned by a deleted mapped entity. */
+export async function retireEntityBusinessKeys(sql, mapping, entityId) {
+    const retired = await sql.run(RETIRE_ENTITY_BUSINESS_KEYS_SQL, [mapping.logicalSheetId, entityId]);
+    if (retired.changes !== 1) {
+        throw new TypedSheetsOrmError(TYPED_SHEETS_ORM_ERROR_CODES.CANONICAL_COMMIT_REJECTED, `could not retire the business key for ${mapping.entityName}:${entityId}.`);
+    }
+}
+async function ensureBusinessKeyOwner(sql, mapping, entityId, normalizedKey) {
+    const owner = await sql.get(READ_BUSINESS_KEY_OWNER_SQL, [
+        mapping.logicalSheetId,
+        mapping.businessKey.fieldName,
+        normalizedKey,
+    ]);
+    if (owner !== undefined) {
+        if (owner.entity_id === entityId)
+            return;
+        throw new TypedSheetsOrmError(TYPED_SHEETS_ORM_ERROR_CODES.CANONICAL_COMMIT_REJECTED, `business key for ${mapping.entityName} is already owned by ${owner.entity_id}.`);
+    }
+    const inserted = await sql.run(INSERT_ACTIVE_BUSINESS_KEY_SQL, [
+        mapping.logicalSheetId,
+        mapping.businessKey.fieldName,
+        normalizedKey,
+        entityId,
+    ]);
+    if (inserted.changes !== 1) {
+        throw new TypedSheetsOrmError(TYPED_SHEETS_ORM_ERROR_CODES.CANONICAL_COMMIT_REJECTED, `could not claim the business key for ${mapping.entityName}:${entityId}.`);
+    }
+}
+function businessKeyHash(mapping, encodedEntity) {
+    return stableHash(requireEncodedField(encodedEntity, mapping.businessKey));
+}
+//# sourceMappingURL=businessKeys.js.map

package/dist/application/orm/persistence/support/businessKeys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"businessKeys.js","sourceRoot":"","sources":["../../../../../src/application/orm/persistence/support/businessKeys.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAuB,MAAM,6BAA6B,CAAC;AAG9E,OAAO,EACL,4BAA4B,EAC5B,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,8BAA8B,EAC9B,4BAA4B,EAC5B,2BAA2B,EAC3B,8BAA8B,EAC9B,+BAA+B,GAGhC,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD,0EAA0E;AAC1E,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,GAAgB,EAChB,OAAiC,EACjC,QAAgB,EAChB,aAAuD;IAEvD,MAAM,aAAa,GAAG,eAAe,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IAC9D,MAAM,sBAAsB,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;AACtE,CAAC;AAED,wEAAwE;AACxE,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,GAAgB,EAChB,OAAiC,EACjC,QAAgB,EAChB,aAAuD;IAEvD,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,GAAG,CAA0B,4BAA4B,EAAE;QACnF,OAAO,CAAC,cAAc;QACtB,OAAO,CAAC,WAAW,CAAC,SAAS;QAC7B,QAAQ;KACT,CAAC,CAAC;IACH,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,mBAAmB,CAC3B,4BAA4B,CAAC,yBAAyB,EACtD,yCAAyC,OAAO,CAAC,UAAU,IAAI,QAAQ,GAAG,CAC3E,CAAC;IACJ,CAAC;IACD,MAAM,iBAAiB,GAAG,eAAe,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IAClE,IAAI,OAAO,CAAC,cAAc,KAAK,iBAAiB;QAAE,OAAO;IACzD,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,8BAA8B,EAAE;QAC5D,OAAO,CAAC,cAAc;QACtB,OAAO,CAAC,WAAW,CAAC,SAAS;QAC7B,OAAO,CAAC,cAAc;QACtB,QAAQ;KACT,CAAC,CAAC;IACH,IAAI,OAAO,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,mBAAmB,CAC3B,4BAA4B,CAAC,yBAAyB,EACtD,kDAAkD,OAAO,CAAC,UAAU,IAAI,QAAQ,GAAG,CACpF,CAAC;IACJ,CAAC;IACD,MAAM,sBAAsB,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CAAC;AAC1E,CAAC;AAED,kEAAkE;AAClE,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,GAAgB,EAChB,OAAiC,EACjC,QAAgB;IAEhB,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,+BAA+B,EAAE,CAAC,OAAO,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC,CAAC;IACnG,IAAI,OAAO,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,mBAAmB,CAC3B,4BAA4B,CAAC,yBAAyB,EACtD,yCAAyC,OAAO,CAAC,UAAU,IAAI,QAAQ,GAAG,CAC3E,CAAC;IACJ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,sBAAsB,CACnC,GAAgB,EAChB,OAAiC,EACjC,QAAgB,EAChB,aAAqB;IAErB,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,GAAG,CAAyB,2BAA2B,EAAE;QAC/E,OAAO,CAAC,cAAc;QACtB,OAAO,CAAC,WAAW,CAAC,SAAS;QAC7B,aAAa;KACd,CAAC,CAAC;IACH,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,IAAI,KAAK,CAAC,SAAS,KAAK,QAAQ;YAAE,OAAO;QACzC,MAAM,IAAI,mBAAmB,CAC3B,4BAA4B,CAAC,yBAAyB,EACtD,oBAAoB,OAAO,CAAC,UAAU,wBAAwB,KAAK,CAAC,SAAS,GAAG,CACjF,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,8BAA8B,EAAE;QAC7D,OAAO,CAAC,cAAc;QACtB,OAAO,CAAC,WAAW,CAAC,SAAS;QAC7B,aAAa;QACb,QAAQ;KACT,CAAC,CAAC;IACH,IAAI,QAAQ,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,mBAAmB,CAC3B,4BAA4B,CAAC,yBAAyB,EACtD,wCAAwC,OAAO,CAAC,UAAU,IAAI,QAAQ,GAAG,CAC1E,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CACtB,OAAiC,EACjC,aAAuD;IAEvD,OAAO,UAAU,CAAC,mBAAmB,CAAC,aAAa,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;AAC7E,CAAC"}

package/dist/application/orm/persistence/support/canonicalState.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Canonical SQLite helpers used by mapped entity lifecycle writes.
+ *
+ * These functions validate row bindings and revision contracts before the
+ * storage commit helper mutates canonical state and appends projection effects.
+ */
+import { type CanonicalCommitInput, type FencingContext } from "../../../../infrastructure/storage/index.js";
+import type { SqlExecutor } from "../../../../adapter/persistence/contracts/sql.js";
+import type { TypedSheetsEntityMapping } from "../../mapping/entityMapping.js";
+/** Creates the active row binding used by both physical projections. */
+export declare function insertActiveRowBinding(sql: SqlExecutor, mapping: TypedSheetsEntityMapping, rowBindingId: string, entityId: string, anchor: string): Promise<void>;
+/** Requires the active binding to still match the mapped entity identity. */
+export declare function requireActiveRowBinding(sql: SqlExecutor, mapping: TypedSheetsEntityMapping, rowBindingId: string, entityId: string, anchor: string): Promise<void>;
+/** Reads the current active canonical entity revision for an update or delete. */
+export declare function requireActiveCanonicalEntityRevision(sql: SqlExecutor, mapping: TypedSheetsEntityMapping, entityId: string): Promise<number>;
+/** Returns canonical field revisions indexed by field name for update CAS. */
+export declare function canonicalFieldRevisions(sql: SqlExecutor, entityId: string): Promise<ReadonlyMap<string, number>>;
+/** Applies a canonical commit or translates its stable result into an ORM error. */
+export declare function requireAppliedCanonicalCommit(sql: SqlExecutor, fence: FencingContext, commit: CanonicalCommitInput): Promise<void>;
+/** Tombstones a mapped row binding after the canonical delete has committed. */
+export declare function tombstoneActiveRowBinding(sql: SqlExecutor, mapping: TypedSheetsEntityMapping, rowBindingId: string, entityId: string): Promise<void>;
+//# sourceMappingURL=canonicalState.d.ts.map

package/dist/application/orm/persistence/support/canonicalState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonicalState.d.ts","sourceRoot":"","sources":["../../../../../src/application/orm/persistence/support/canonicalState.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACpB,MAAM,6CAA6C,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kDAAkD,CAAC;AACpF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAgB/E,wEAAwE;AACxE,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,wBAAwB,EACjC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAqBf;AAED,6EAA6E;AAC7E,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,wBAAwB,EACjC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAcf;AAED,kFAAkF;AAClF,wBAAsB,oCAAoC,CACxD,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,wBAAwB,EACjC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CASjB;AAED,8EAA8E;AAC9E,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,WAAW,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAStC;AAED,oFAAoF;AACpF,wBAAsB,6BAA6B,CACjD,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAmBf;AAED,gFAAgF;AAChF,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,wBAAwB,EACjC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAcf"}

package/dist/application/orm/persistence/support/canonicalState.js

@@ -0,0 +1,88 @@
+/**
+ * Canonical SQLite helpers used by mapped entity lifecycle writes.
+ *
+ * These functions validate row bindings and revision contracts before the
+ * storage commit helper mutates canonical state and appends projection effects.
+ */
+import { POSITIVE_SAFE_INTEGER_MINIMUM } from "../../../../domain/index.js";
+import { ROW_BINDING_STATES } from "../../../../domain/model/constants.js";
+import { CANONICAL_COMMIT_RESULT_KINDS, commitCanonicalChangesWithSql, } from "../../../../infrastructure/storage/index.js";
+import { TYPED_SHEETS_ORM_ERROR_CODES, TypedSheetsOrmError, } from "../../errors.js";
+import { READ_ACTIVE_CANONICAL_ENTITY_SQL, READ_CANONICAL_FIELD_REVISIONS_SQL, READ_ROW_BINDING_SQL, INSERT_ACTIVE_ROW_BINDING_SQL, TOMBSTONE_ACTIVE_ROW_BINDING_SQL, } from "./contracts.js";
+/** Creates the active row binding used by both physical projections. */
+export async function insertActiveRowBinding(sql, mapping, rowBindingId, entityId, anchor) {
+    const existing = await sql.get(READ_ROW_BINDING_SQL, [rowBindingId]);
+    if (existing !== undefined) {
+        throw new TypedSheetsOrmError(TYPED_SHEETS_ORM_ERROR_CODES.ROW_BINDING_CONFLICT, `row binding ${rowBindingId} already exists for ${mapping.entityName}:${entityId}.`);
+    }
+    const inserted = await sql.run(INSERT_ACTIVE_ROW_BINDING_SQL, [
+        rowBindingId,
+        mapping.logicalSheetId,
+        anchor,
+        entityId,
+        ROW_BINDING_STATES.ACTIVE,
+    ]);
+    if (inserted.changes !== 1) {
+        throw new TypedSheetsOrmError(TYPED_SHEETS_ORM_ERROR_CODES.ROW_BINDING_CONFLICT, `could not create the row binding for ${mapping.entityName}:${entityId}.`);
+    }
+}
+/** Requires the active binding to still match the mapped entity identity. */
+export async function requireActiveRowBinding(sql, mapping, rowBindingId, entityId, anchor) {
+    const row = await sql.get(READ_ROW_BINDING_SQL, [rowBindingId]);
+    if (row === undefined ||
+        row.logical_sheet_id !== mapping.logicalSheetId ||
+        row.anchor_reference !== anchor ||
+        row.entity_id !== entityId ||
+        row.state !== ROW_BINDING_STATES.ACTIVE) {
+        throw new TypedSheetsOrmError(TYPED_SHEETS_ORM_ERROR_CODES.ROW_BINDING_CONFLICT, `active row binding is unavailable for ${mapping.entityName}:${entityId}.`);
+    }
+}
+/** Reads the current active canonical entity revision for an update or delete. */
+export async function requireActiveCanonicalEntityRevision(sql, mapping, entityId) {
+    const entity = await sql.get(READ_ACTIVE_CANONICAL_ENTITY_SQL, [entityId]);
+    if (entity === undefined || !isPositiveSafeInteger(entity.entity_revision)) {
+        throw new TypedSheetsOrmError(TYPED_SHEETS_ORM_ERROR_CODES.CANONICAL_COMMIT_REJECTED, `active canonical state is unavailable for ${mapping.entityName}:${entityId}.`);
+    }
+    return entity.entity_revision;
+}
+/** Returns canonical field revisions indexed by field name for update CAS. */
+export async function canonicalFieldRevisions(sql, entityId) {
+    const rows = await sql.all(READ_CANONICAL_FIELD_REVISIONS_SQL, [entityId]);
+    const revisions = new Map();
+    for (const row of rows) {
+        if (isPositiveSafeInteger(row.field_revision)) {
+            revisions.set(row.field_name, row.field_revision);
+        }
+    }
+    return revisions;
+}
+/** Applies a canonical commit or translates its stable result into an ORM error. */
+export async function requireAppliedCanonicalCommit(sql, fence, commit) {
+    const result = await commitCanonicalChangesWithSql(sql, fence, commit);
+    if (result.kind === CANONICAL_COMMIT_RESULT_KINDS.APPLIED)
+        return;
+    if (result.kind === CANONICAL_COMMIT_RESULT_KINDS.FENCED_OUT) {
+        throw new TypedSheetsOrmError(TYPED_SHEETS_ORM_ERROR_CODES.WRITER_LEASE_UNAVAILABLE, "the mapped entity writer lease was lost before canonical state could commit.");
+    }
+    if (result.kind === CANONICAL_COMMIT_RESULT_KINDS.STALE) {
+        throw new TypedSheetsOrmError(TYPED_SHEETS_ORM_ERROR_CODES.CANONICAL_COMMIT_REJECTED, `canonical ${result.target} state became stale while planning an entity flush.`);
+    }
+    throw new TypedSheetsOrmError(TYPED_SHEETS_ORM_ERROR_CODES.CANONICAL_COMMIT_REJECTED, `mapped canonical commit is invalid: ${result.reason}.`);
+}
+/** Tombstones a mapped row binding after the canonical delete has committed. */
+export async function tombstoneActiveRowBinding(sql, mapping, rowBindingId, entityId) {
+    const tombstoned = await sql.run(TOMBSTONE_ACTIVE_ROW_BINDING_SQL, [
+        ROW_BINDING_STATES.TOMBSTONED,
+        rowBindingId,
+        mapping.logicalSheetId,
+        entityId,
+        ROW_BINDING_STATES.ACTIVE,
+    ]);
+    if (tombstoned.changes !== 1) {
+        throw new TypedSheetsOrmError(TYPED_SHEETS_ORM_ERROR_CODES.ROW_BINDING_CONFLICT, `could not tombstone the row binding for ${mapping.entityName}:${entityId}.`);
+    }
+}
+function isPositiveSafeInteger(value) {
+    return Number.isSafeInteger(value) && value >= POSITIVE_SAFE_INTEGER_MINIMUM;
+}
+//# sourceMappingURL=canonicalState.js.map

package/dist/application/orm/persistence/support/canonicalState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonicalState.js","sourceRoot":"","sources":["../../../../../src/application/orm/persistence/support/canonicalState.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,6BAA6B,EAAE,MAAM,6BAA6B,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EACL,6BAA6B,EAC7B,6BAA6B,GAG9B,MAAM,6CAA6C,CAAC;AAGrD,OAAO,EACL,4BAA4B,EAC5B,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,gCAAgC,EAChC,kCAAkC,EAClC,oBAAoB,EACpB,6BAA6B,EAC7B,gCAAgC,GAIjC,MAAM,gBAAgB,CAAC;AAExB,wEAAwE;AACxE,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,GAAgB,EAChB,OAAiC,EACjC,YAAoB,EACpB,QAAgB,EAChB,MAAc;IAEd,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,GAAG,CAAmB,oBAAoB,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;IACvF,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,IAAI,mBAAmB,CAC3B,4BAA4B,CAAC,oBAAoB,EACjD,eAAe,YAAY,uBAAuB,OAAO,CAAC,UAAU,IAAI,QAAQ,GAAG,CACpF,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,6BAA6B,EAAE;QAC5D,YAAY;QACZ,OAAO,CAAC,cAAc;QACtB,MAAM;QACN,QAAQ;QACR,kBAAkB,CAAC,MAAM;KAC1B,CAAC,CAAC;IACH,IAAI,QAAQ,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,mBAAmB,CAC3B,4BAA4B,CAAC,oBAAoB,EACjD,wCAAwC,OAAO,CAAC,UAAU,IAAI,QAAQ,GAAG,CAC1E,CAAC;IACJ,CAAC;AACH,CAAC;AAED,6EAA6E;AAC7E,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,GAAgB,EAChB,OAAiC,EACjC,YAAoB,EACpB,QAAgB,EAChB,MAAc;IAEd,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,GAAG,CAAmB,oBAAoB,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;IAClF,IACE,GAAG,KAAK,SAAS;QACjB,GAAG,CAAC,gBAAgB,KAAK,OAAO,CAAC,cAAc;QAC/C,GAAG,CAAC,gBAAgB,KAAK,MAAM;QAC/B,GAAG,CAAC,SAAS,KAAK,QAAQ;QAC1B,GAAG,CAAC,KAAK,KAAK,kBAAkB,CAAC,MAAM,EACvC,CAAC;QACD,MAAM,IAAI,mBAAmB,CAC3B,4BAA4B,CAAC,oBAAoB,EACjD,yCAAyC,OAAO,CAAC,UAAU,IAAI,QAAQ,GAAG,CAC3E,CAAC;IACJ,CAAC;AACH,CAAC;AAED,kFAAkF;AAClF,MAAM,CAAC,KAAK,UAAU,oCAAoC,CACxD,GAAgB,EAChB,OAAiC,EACjC,QAAgB;IAEhB,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,GAAG,CAAwB,gCAAgC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAClG,IAAI,MAAM,KAAK,SAAS,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,eAAe,CAAC,EAAE,CAAC;QAC3E,MAAM,IAAI,mBAAmB,CAC3B,4BAA4B,CAAC,yBAAyB,EACtD,6CAA6C,OAAO,CAAC,UAAU,IAAI,QAAQ,GAAG,CAC/E,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,eAAe,CAAC;AAChC,CAAC;AAED,8EAA8E;AAC9E,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,GAAgB,EAChB,QAAgB;IAEhB,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,GAAG,CAA+B,kCAAkC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IACzG,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC5C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,qBAAqB,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC;YAC9C,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,cAAc,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,GAAgB,EAChB,KAAqB,EACrB,MAA4B;IAE5B,MAAM,MAAM,GAAG,MAAM,6BAA6B,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IACvE,IAAI,MAAM,CAAC,IAAI,KAAK,6BAA6B,CAAC,OAAO;QAAE,OAAO;IAClE,IAAI,MAAM,CAAC,IAAI,KAAK,6BAA6B,CAAC,UAAU,EAAE,CAAC;QAC7D,MAAM,IAAI,mBAAmB,CAC3B,4BAA4B,CAAC,wBAAwB,EACrD,8EAA8E,CAC/E,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,6BAA6B,CAAC,KAAK,EAAE,CAAC;QACxD,MAAM,IAAI,mBAAmB,CAC3B,4BAA4B,CAAC,yBAAyB,EACtD,aAAa,MAAM,CAAC,MAAM,qDAAqD,CAChF,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,mBAAmB,CAC3B,4BAA4B,CAAC,yBAAyB,EACtD,uCAAuC,MAAM,CAAC,MAAM,GAAG,CACxD,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,GAAgB,EAChB,OAAiC,EACjC,YAAoB,EACpB,QAAgB;IAEhB,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,gCAAgC,EAAE;QACjE,kBAAkB,CAAC,UAAU;QAC7B,YAAY;QACZ,OAAO,CAAC,cAAc;QACtB,QAAQ;QACR,kBAAkB,CAAC,MAAM;KAC1B,CAAC,CAAC;IACH,IAAI,UAAU,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,mBAAmB,CAC3B,4BAA4B,CAAC,oBAAoB,EACjD,2CAA2C,OAAO,CAAC,UAAU,IAAI,QAAQ,GAAG,CAC7E,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAa;IAC1C,OAAO,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,6BAA6B,CAAC;AAC/E,CAAC"}

package/dist/application/orm/persistence/support/contracts.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Internal contracts shared by the mapped persistence modules.
+ *
+ * Public flush options are kept here as well so the coordinator entrypoint can
+ * stay focused on orchestration while row, projection, and SQL helpers share a
+ * single set of contracts.
+ */
+import { type EffectStatus } from "../../../../domain/index.js";
+import type { RegisteredSyncProjectionDefinition } from "../../../sync/gateway/SyncGatewayBootstrap.js";
+import type { SyncTimingSink } from "../../../sync/telemetry/syncTiming.js";
+import type { CanonicalCommitInput, CanonicalFieldWrite, FencingContext, NewEffect, RegisteredSyncSheet } from "../../../../infrastructure/storage/index.js";
+import type { SqlExecutor, SqlStorageAdapter } from "../../../../adapter/persistence/contracts/sql.js";
+import { TYPED_SHEETS_ENTITY_CHANGE_KINDS, type TypedSheetsEntityChange, type TypedSheetsFlushContext, type TypedSheetsFlushCoordinator } from "../../api/contracts.js";
+import type { TypedSheetsEntityFieldMapping, TypedSheetsEntityMapping, TypedSheetsEntityMappingRegistry } from "../../mapping/contracts.js";
+/** Default lease role used by mapped entity writes. */
+export declare const DEFAULT_MAPPED_WRITER_ROLE = "typed-sheets-entity-writer";
+/** Default lease duration used by mapped entity writes. */
+export declare const DEFAULT_MAPPED_WRITER_LEASE_DURATION_MS = 60000;
+/** Effect target kinds emitted by mapped entity persistence. */
+export declare const MAPPED_EFFECT_TARGET_KINDS: {
+    readonly ENTITY: "entity";
+    readonly PROJECTION_ROW: "projection_row";
+};
+/** Effect lifecycle states read while deriving the next projection baseline. */
+export declare const MAPPED_EFFECT_STATUSES: {
+    readonly PENDING: "pending";
+    readonly PROCESSING: "processing";
+    readonly APPLIED: "applied";
+};
+/** SQL used by mapped persistence to read and create row bindings. */
+export declare const READ_ROW_BINDING_SQL = "\n  SELECT logical_sheet_id, anchor_reference, entity_id, state\n  FROM row_binding\n  WHERE row_binding_id = ?\n";
+export declare const INSERT_ACTIVE_ROW_BINDING_SQL = "\n  INSERT INTO row_binding (\n    row_binding_id, logical_sheet_id, anchor_reference, entity_id, state\n  ) VALUES (?, ?, ?, ?, ?)\n";
+export declare const TOMBSTONE_ACTIVE_ROW_BINDING_SQL = "\n  UPDATE row_binding\n  SET state = ?\n  WHERE row_binding_id = ? AND logical_sheet_id = ? AND entity_id = ? AND state = ?\n";
+/** SQL used by mapped persistence to read canonical entity revisions. */
+export declare const READ_ACTIVE_CANONICAL_ENTITY_SQL = "\n  SELECT entity_revision\n  FROM entity_state\n  WHERE entity_id = ? AND status = 'active'\n";
+export declare const READ_CANONICAL_FIELD_REVISIONS_SQL = "\n  SELECT field_name, field_revision\n  FROM entity_field_state\n  WHERE entity_id = ?\n";
+/** SQL used by mapped persistence to manage unique business-key ownership. */
+export declare const READ_ACTIVE_BUSINESS_KEY_SQL = "\n  SELECT entity_id, normalized_key\n  FROM business_key_index\n  WHERE logical_sheet_id = ? AND field_name = ? AND entity_id = ? AND state = 'active'\n";
+export declare const READ_BUSINESS_KEY_OWNER_SQL = "\n  SELECT entity_id\n  FROM business_key_index\n  WHERE logical_sheet_id = ? AND field_name = ? AND normalized_key = ? AND state = 'active'\n";
+export declare const INSERT_ACTIVE_BUSINESS_KEY_SQL = "\n  INSERT INTO business_key_index (\n    logical_sheet_id, field_name, normalized_key, entity_id, state\n  ) VALUES (?, ?, ?, ?, 'active')\n";
+export declare const RETIRE_ACTIVE_BUSINESS_KEY_SQL = "\n  UPDATE business_key_index\n  SET state = 'inactive'\n  WHERE logical_sheet_id = ? AND field_name = ? AND normalized_key = ?\n    AND entity_id = ? AND state = 'active'\n";
+export declare const RETIRE_ENTITY_BUSINESS_KEYS_SQL = "\n  UPDATE business_key_index\n  SET state = 'inactive'\n  WHERE logical_sheet_id = ? AND entity_id = ? AND state = 'active'\n";
+/** SQL used to derive the next visible projection baseline. */
+export declare const READ_VISIBLE_PROJECTION_STATE_SQL = "\n  SELECT confirmed_snapshot_hash, confirmed_visible_revision\n  FROM sheet_visible_state\n  WHERE physical_sheet_id = ? AND projection = ? AND row_binding_id = ?\n";
+export declare const READ_LATEST_PROJECTION_EFFECT_SQL = "\n  SELECT physical_sheet_id, projection, status, payload_json,\n         expected_visible_revision, expected_visible_hash, stream_sequence\n  FROM sheet_effect_outbox\n  WHERE logical_sheet_id = ? AND target_kind = ? AND target_id = ?\n  ORDER BY stream_sequence DESC\n  LIMIT 1\n";
+/** Writer identity used to fence mapped entity lifecycle commits. */
+export interface TypedSheetsEntityWriterOptions {
+    /** Stable process or service identity that owns mapped entity writes. */
+    readonly writerId: string;
+    /** Lease role. It may differ from the effect worker's role. */
+    readonly role?: string;
+    /** Writer lease length in milliseconds. */
+    readonly leaseDurationMs?: number;
+    /** Injectable clock used for deterministic tests and fencing. */
+    readonly now?: () => number;
+    /** Injectable opaque-ID source used for commit and effect identities. */
+    readonly createId?: () => string;
+    /** Optional diagnostics sink for append/update/delete flush phases. */
+    readonly onTiming?: SyncTimingSink;
+}
+/** Options for deriving a built-in flush coordinator from mapping metadata. */
+export interface CreateMappedTypedSheetsFlushCoordinatorOptions {
+    readonly mappings: TypedSheetsEntityMappingRegistry | readonly TypedSheetsEntityMapping[];
+    readonly writer: TypedSheetsEntityWriterOptions;
+}
+/** A registered route with headers ready for Apps Script control-plane provisioning. */
+export interface RegisteredTypedSheetsMappedProjection {
+    readonly mapping: TypedSheetsEntityMapping;
+    readonly sheet: RegisteredSyncSheet;
+    readonly headers: readonly string[];
+}
+/** Normalized writer options used by all persistence helpers. */
+export interface ResolvedWriterOptions {
+    readonly writerId: string;
+    readonly role: string;
+    readonly leaseDurationMs: number;
+    readonly now: () => number;
+    readonly createId: () => string;
+    readonly onTiming: SyncTimingSink | undefined;
+}
+/** Raw row-binding row returned by SQLite. */
+export interface RowBindingSqlRow {
+    readonly logical_sheet_id: string;
+    readonly anchor_reference: string;
+    readonly entity_id: string | null;
+    readonly state: string;
+}
+/** Raw canonical entity revision row returned by SQLite. */
+export interface CanonicalEntitySqlRow {
+    readonly entity_revision: number;
+}
+/** Raw canonical field revision row returned by SQLite. */
+export interface CanonicalFieldRevisionSqlRow {
+    readonly field_name: string;
+    readonly field_revision: number;
+}
+/** Raw active business-key row returned by SQLite. */
+export interface ActiveBusinessKeySqlRow {
+    readonly entity_id: string;
+    readonly normalized_key: string;
+}
+/** Raw business-key owner row returned by SQLite. */
+export interface BusinessKeyOwnerSqlRow {
+    readonly entity_id: string;
+}
+/** Raw confirmed visible-state row returned by SQLite. */
+export interface VisibleProjectionSqlRow {
+    readonly confirmed_snapshot_hash: string;
+    readonly confirmed_visible_revision: number;
+}
+/** Raw latest projection effect row returned by SQLite. */
+export interface LatestProjectionEffectSqlRow {
+    readonly physical_sheet_id: string;
+    readonly projection: string;
+    readonly status: EffectStatus;
+    readonly payload_json: string;
+    readonly expected_visible_revision: number;
+    readonly expected_visible_hash: string;
+    readonly stream_sequence: number;
+}
+/** Confirmed or queued baseline used when creating the next projection effect. */
+export interface ProjectionBaseline {
+    readonly expectedVisibleRevision: number;
+    readonly expectedVisibleHash: string;
+    readonly createIfMissing: boolean;
+    readonly streamSequence: number;
+}
+/** One validated mapped entity lifecycle change and its selected fields. */
+export interface MappedChangePlan {
+    readonly mapping: TypedSheetsEntityMapping;
+    readonly change: TypedSheetsEntityChange;
+    readonly changedFields: readonly TypedSheetsEntityFieldMapping[];
+}
+/** Public coordinator shape re-exported by the persistence barrel. */
+export type { TypedSheetsFlushCoordinator, TypedSheetsFlushContext };
+/** Keeps the API imports used by persistence modules explicit in one contract file. */
+export type { CanonicalCommitInput, CanonicalFieldWrite, FencingContext, NewEffect, RegisteredSyncProjectionDefinition, RegisteredSyncSheet, SqlExecutor, SqlStorageAdapter, };
+export { TYPED_SHEETS_ENTITY_CHANGE_KINDS };
+//# sourceMappingURL=contracts.d.ts.map

package/dist/application/orm/persistence/support/contracts.d.ts.map

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

package/dist/application/orm/persistence/support/contracts.js

@@ -0,0 +1,93 @@
+/**
+ * Internal contracts shared by the mapped persistence modules.
+ *
+ * Public flush options are kept here as well so the coordinator entrypoint can
+ * stay focused on orchestration while row, projection, and SQL helpers share a
+ * single set of contracts.
+ */
+import { TYPED_SHEETS_ENTITY_CHANGE_KINDS, } from "../../api/contracts.js";
+/** Default lease role used by mapped entity writes. */
+export const DEFAULT_MAPPED_WRITER_ROLE = "typed-sheets-entity-writer";
+/** Default lease duration used by mapped entity writes. */
+export const DEFAULT_MAPPED_WRITER_LEASE_DURATION_MS = 60_000;
+/** Effect target kinds emitted by mapped entity persistence. */
+export const MAPPED_EFFECT_TARGET_KINDS = {
+    ENTITY: "entity",
+    PROJECTION_ROW: "projection_row",
+};
+/** Effect lifecycle states read while deriving the next projection baseline. */
+export const MAPPED_EFFECT_STATUSES = {
+    PENDING: "pending",
+    PROCESSING: "processing",
+    APPLIED: "applied",
+};
+/** SQL used by mapped persistence to read and create row bindings. */
+export const READ_ROW_BINDING_SQL = `
+  SELECT logical_sheet_id, anchor_reference, entity_id, state
+  FROM row_binding
+  WHERE row_binding_id = ?
+`;
+export const INSERT_ACTIVE_ROW_BINDING_SQL = `
+  INSERT INTO row_binding (
+    row_binding_id, logical_sheet_id, anchor_reference, entity_id, state
+  ) VALUES (?, ?, ?, ?, ?)
+`;
+export const TOMBSTONE_ACTIVE_ROW_BINDING_SQL = `
+  UPDATE row_binding
+  SET state = ?
+  WHERE row_binding_id = ? AND logical_sheet_id = ? AND entity_id = ? AND state = ?
+`;
+/** SQL used by mapped persistence to read canonical entity revisions. */
+export const READ_ACTIVE_CANONICAL_ENTITY_SQL = `
+  SELECT entity_revision
+  FROM entity_state
+  WHERE entity_id = ? AND status = 'active'
+`;
+export const READ_CANONICAL_FIELD_REVISIONS_SQL = `
+  SELECT field_name, field_revision
+  FROM entity_field_state
+  WHERE entity_id = ?
+`;
+/** SQL used by mapped persistence to manage unique business-key ownership. */
+export const READ_ACTIVE_BUSINESS_KEY_SQL = `
+  SELECT entity_id, normalized_key
+  FROM business_key_index
+  WHERE logical_sheet_id = ? AND field_name = ? AND entity_id = ? AND state = 'active'
+`;
+export const READ_BUSINESS_KEY_OWNER_SQL = `
+  SELECT entity_id
+  FROM business_key_index
+  WHERE logical_sheet_id = ? AND field_name = ? AND normalized_key = ? AND state = 'active'
+`;
+export const INSERT_ACTIVE_BUSINESS_KEY_SQL = `
+  INSERT INTO business_key_index (
+    logical_sheet_id, field_name, normalized_key, entity_id, state
+  ) VALUES (?, ?, ?, ?, 'active')
+`;
+export const RETIRE_ACTIVE_BUSINESS_KEY_SQL = `
+  UPDATE business_key_index
+  SET state = 'inactive'
+  WHERE logical_sheet_id = ? AND field_name = ? AND normalized_key = ?
+    AND entity_id = ? AND state = 'active'
+`;
+export const RETIRE_ENTITY_BUSINESS_KEYS_SQL = `
+  UPDATE business_key_index
+  SET state = 'inactive'
+  WHERE logical_sheet_id = ? AND entity_id = ? AND state = 'active'
+`;
+/** SQL used to derive the next visible projection baseline. */
+export const READ_VISIBLE_PROJECTION_STATE_SQL = `
+  SELECT confirmed_snapshot_hash, confirmed_visible_revision
+  FROM sheet_visible_state
+  WHERE physical_sheet_id = ? AND projection = ? AND row_binding_id = ?
+`;
+export const READ_LATEST_PROJECTION_EFFECT_SQL = `
+  SELECT physical_sheet_id, projection, status, payload_json,
+         expected_visible_revision, expected_visible_hash, stream_sequence
+  FROM sheet_effect_outbox
+  WHERE logical_sheet_id = ? AND target_kind = ? AND target_id = ?
+  ORDER BY stream_sequence DESC
+  LIMIT 1
+`;
+export { TYPED_SHEETS_ENTITY_CHANGE_KINDS };
+//# sourceMappingURL=contracts.js.map

package/dist/application/orm/persistence/support/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../../../../src/application/orm/persistence/support/contracts.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAqBH,OAAO,EACL,gCAAgC,GAIjC,MAAM,wBAAwB,CAAC;AAOhC,uDAAuD;AACvD,MAAM,CAAC,MAAM,0BAA0B,GAAG,4BAA4B,CAAC;AAEvE,2DAA2D;AAC3D,MAAM,CAAC,MAAM,uCAAuC,GAAG,MAAM,CAAC;AAE9D,gEAAgE;AAChE,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,MAAM,EAAE,QAAQ;IAChB,cAAc,EAAE,gBAAgB;CACmB,CAAC;AAEtD,gFAAgF;AAChF,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,YAAY;IACxB,OAAO,EAAE,SAAS;CAC6B,CAAC;AAElD,sEAAsE;AACtE,MAAM,CAAC,MAAM,oBAAoB,GAAG;;;;CAInC,CAAC;AAEF,MAAM,CAAC,MAAM,6BAA6B,GAAG;;;;CAI5C,CAAC;AAEF,MAAM,CAAC,MAAM,gCAAgC,GAAG;;;;CAI/C,CAAC;AAEF,yEAAyE;AACzE,MAAM,CAAC,MAAM,gCAAgC,GAAG;;;;CAI/C,CAAC;AAEF,MAAM,CAAC,MAAM,kCAAkC,GAAG;;;;CAIjD,CAAC;AAEF,8EAA8E;AAC9E,MAAM,CAAC,MAAM,4BAA4B,GAAG;;;;CAI3C,CAAC;AAEF,MAAM,CAAC,MAAM,2BAA2B,GAAG;;;;CAI1C,CAAC;AAEF,MAAM,CAAC,MAAM,8BAA8B,GAAG;;;;CAI7C,CAAC;AAEF,MAAM,CAAC,MAAM,8BAA8B,GAAG;;;;;CAK7C,CAAC;AAEF,MAAM,CAAC,MAAM,+BAA+B,GAAG;;;;CAI9C,CAAC;AAEF,+DAA+D;AAC/D,MAAM,CAAC,MAAM,iCAAiC,GAAG;;;;CAIhD,CAAC;AAEF,MAAM,CAAC,MAAM,iCAAiC,GAAG;;;;;;;CAOhD,CAAC;AAsHF,OAAO,EAAE,gCAAgC,EAAE,CAAC"}

package/dist/application/orm/persistence/support/helpers.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Small persistence helpers shared by the lifecycle and projection modules.
+ *
+ * Keeping these guards and presence constructors together makes the larger
+ * persistence flows read in terms of their domain operation instead of their
+ * repeated boundary checks.
+ */
+import { type Applicability, type NormalizedCell, type Presence } from "../../../../domain/index.js";
+import type { TypedSheetsEntityChange } from "../../api/contracts.js";
+import { type TypedSheetsEntityFieldMapping, type TypedSheetsEntityMapping, requireTypedSheetsEntityProjection } from "../../mapping/entityMapping.js";
+import type { ResolvedWriterOptions } from "./contracts.js";
+/** Wraps a value in the validated presence contract used by storage writes. */
+export declare function presentValue<T>(value: T): Presence<T>;
+/** Represents a value that is intentionally not applicable to an operation. */
+export declare function absentValue<T>(): Presence<T>;
+/** Wraps a value in the validated applicability contract used by storage writes. */
+export declare function applicableValue<T>(value: T): Applicability<T>;
+/** Returns a namespaced ID and rejects an invalid injected ID source. */
+export declare function identifiedValue(prefix: string, writer: ResolvedWriterOptions): string;
+/** Reads one mapped field and fails before an incomplete canonical commit. */
+export declare function requireEncodedField(encodedEntity: Readonly<Record<string, NormalizedCell>>, field: TypedSheetsEntityFieldMapping): NormalizedCell;
+/** Validates the entity identity collected by the underlying flush engine. */
+export declare function requireChangeEntityId(mapping: TypedSheetsEntityMapping, change: TypedSheetsEntityChange): string;
+/** Builds the stable target ID used by a physical projection row effect. */
+export declare function projectionRowTargetId(physicalSheetId: string, rowBindingId: string): string;
+/** Checks a positive SQLite revision or stream sequence. */
+export declare function isPositiveSafeInteger(value: number): boolean;
+/** Checks a revision that may validly start at zero. */
+export declare function isNonNegativeSafeInteger(value: number): boolean;
+/** Throws the common error used when a projection cannot safely be planned. */
+export declare function throwProjectionBlocked(mapping: TypedSheetsEntityMapping, projection: ReturnType<typeof requireTypedSheetsEntityProjection>, reason: string): never;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/application/orm/persistence/support/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../../../src/application/orm/persistence/support/helpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAKL,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,QAAQ,EACd,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EACV,uBAAuB,EACxB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,KAAK,6BAA6B,EAClC,KAAK,wBAAwB,EAC7B,kCAAkC,EAEnC,MAAM,gCAAgC,CAAC;AAKxC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAE5D,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAErD;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAE5C;AAED,oFAAoF;AACpF,wBAAgB,eAAe,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAE7D;AAED,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,qBAAqB,GAAG,MAAM,CASrF;AAED,8EAA8E;AAC9E,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,EACvD,KAAK,EAAE,6BAA6B,GACnC,cAAc,CAShB;AAED,8EAA8E;AAC9E,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,wBAAwB,EACjC,MAAM,EAAE,uBAAuB,GAC9B,MAAM,CAeR;AAED,4EAA4E;AAC5E,wBAAgB,qBAAqB,CAAC,eAAe,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAE3F;AAED,4DAA4D;AAC5D,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED,wDAAwD;AACxD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE/D;AAED,+EAA+E;AAC/E,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,wBAAwB,EACjC,UAAU,EAAE,UAAU,CAAC,OAAO,kCAAkC,CAAC,EACjE,MAAM,EAAE,MAAM,GACb,KAAK,CAKP"}

package/dist/application/orm/persistence/support/helpers.js

@@ -0,0 +1,66 @@
+/**
+ * Small persistence helpers shared by the lifecycle and projection modules.
+ *
+ * Keeping these guards and presence constructors together makes the larger
+ * persistence flows read in terms of their domain operation instead of their
+ * repeated boundary checks.
+ */
+import { APPLICABILITY_KINDS, EMPTY_STRING_LENGTH_ZERO, POSITIVE_SAFE_INTEGER_MINIMUM, PRESENCE_KINDS, } from "../../../../domain/index.js";
+import { typedSheetsEntityId, } from "../../mapping/entityMapping.js";
+import { TYPED_SHEETS_ORM_ERROR_CODES, TypedSheetsOrmError, } from "../../errors.js";
+/** Wraps a value in the validated presence contract used by storage writes. */
+export function presentValue(value) {
+    return { kind: PRESENCE_KINDS.PRESENT, value };
+}
+/** Represents a value that is intentionally not applicable to an operation. */
+export function absentValue() {
+    return { kind: PRESENCE_KINDS.ABSENT };
+}
+/** Wraps a value in the validated applicability contract used by storage writes. */
+export function applicableValue(value) {
+    return { kind: APPLICABILITY_KINDS.APPLICABLE, value };
+}
+/** Returns a namespaced ID and rejects an invalid injected ID source. */
+export function identifiedValue(prefix, writer) {
+    const value = writer.createId();
+    if (value.length === EMPTY_STRING_LENGTH_ZERO) {
+        throw new TypedSheetsOrmError(TYPED_SHEETS_ORM_ERROR_CODES.INVALID_ENTITY_MAPPING, "mapped writer createId must return a non-empty value.");
+    }
+    return `${prefix}:${value}`;
+}
+/** Reads one mapped field and fails before an incomplete canonical commit. */
+export function requireEncodedField(encodedEntity, field) {
+    const value = encodedEntity[field.fieldName];
+    if (value === undefined) {
+        throw new TypedSheetsOrmError(TYPED_SHEETS_ORM_ERROR_CODES.INVALID_MAPPED_FIELD_VALUE, `encoded value is unavailable for ${field.fieldName}.`);
+    }
+    return value;
+}
+/** Validates the entity identity collected by the underlying flush engine. */
+export function requireChangeEntityId(mapping, change) {
+    const entityId = typedSheetsEntityId(mapping, change.entity);
+    if (change.primaryKey.kind !== PRESENCE_KINDS.PRESENT) {
+        throw new TypedSheetsOrmError(TYPED_SHEETS_ORM_ERROR_CODES.ENTITY_PRIMARY_KEY_UNAVAILABLE, `${mapping.entityName} has no serialized primary key during flush.`);
+    }
+    if (change.primaryKey.value !== entityId) {
+        throw new TypedSheetsOrmError(TYPED_SHEETS_ORM_ERROR_CODES.ENTITY_PRIMARY_KEY_MISMATCH, `${mapping.entityName} primary-key metadata does not match its entity property.`);
+    }
+    return entityId;
+}
+/** Builds the stable target ID used by a physical projection row effect. */
+export function projectionRowTargetId(physicalSheetId, rowBindingId) {
+    return `projection-row:${physicalSheetId}:${rowBindingId}`;
+}
+/** Checks a positive SQLite revision or stream sequence. */
+export function isPositiveSafeInteger(value) {
+    return Number.isSafeInteger(value) && value >= POSITIVE_SAFE_INTEGER_MINIMUM;
+}
+/** Checks a revision that may validly start at zero. */
+export function isNonNegativeSafeInteger(value) {
+    return Number.isSafeInteger(value) && value >= 0;
+}
+/** Throws the common error used when a projection cannot safely be planned. */
+export function throwProjectionBlocked(mapping, projection, reason) {
+    throw new TypedSheetsOrmError(TYPED_SHEETS_ORM_ERROR_CODES.PROJECTION_OUTBOX_BLOCKED, `${mapping.entityName} ${projection.projection} projection is blocked: ${reason}.`);
+}
+//# sourceMappingURL=helpers.js.map

package/dist/application/orm/persistence/support/helpers.js.map

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

package/dist/application/orm/persistence/support/timing.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Timing helpers for mapped persistence diagnostics.
+ *
+ * Timing callbacks are deliberately best-effort: observability failures must
+ * never abort the entity transaction they describe.
+ */
+import { type SyncTimingOperationCounts, type SyncTimingOperationKind, type SyncTimingSink } from "../../../sync/telemetry/syncTiming.js";
+import { type TypedSheetsEntityChange } from "../../api/contracts.js";
+import type { MappedChangePlan, ResolvedWriterOptions } from "./contracts.js";
+/** Converts public entity lifecycle kinds into timing operation kinds. */
+export declare function timingOperationKind(value: TypedSheetsEntityChange["kind"]): SyncTimingOperationKind;
+/** Counts one lifecycle operation for aggregate diagnostics. */
+export declare function countsForOperationKind(operationKind: SyncTimingOperationKind): SyncTimingOperationCounts;
+/** Counts all mapped lifecycle plans in one flush. */
+export declare function countsForPlans(plans: readonly MappedChangePlan[]): SyncTimingOperationCounts;
+/** Lists only operation kinds represented by the supplied aggregate counts. */
+export declare function operationKindsForCounts(counts: SyncTimingOperationCounts): readonly SyncTimingOperationKind[];
+/** Emits diagnostics without allowing a faulty sink to affect persistence. */
+export declare function emitTiming(writer: ResolvedWriterOptions, event: Parameters<SyncTimingSink>[0]): void;
+//# sourceMappingURL=timing.d.ts.map

package/dist/application/orm/persistence/support/timing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.d.ts","sourceRoot":"","sources":["../../../../../src/application/orm/persistence/support/timing.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEL,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,cAAc,EACpB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAEL,KAAK,uBAAuB,EAE7B,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EACV,gBAAgB,EAChB,qBAAqB,EACtB,MAAM,gBAAgB,CAAC;AASxB,0EAA0E;AAC1E,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,uBAAuB,CAAC,MAAM,CAAC,GACrC,uBAAuB,CAEzB;AAED,gEAAgE;AAChE,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,uBAAuB,GACrC,yBAAyB,CAM3B;AAED,sDAAsD;AACtD,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,gBAAgB,EAAE,GAAG,yBAAyB,CAS5F;AAED,+EAA+E;AAC/E,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,yBAAyB,GAChC,SAAS,uBAAuB,EAAE,CAMpC;AAED,8EAA8E;AAC9E,wBAAgB,UAAU,CACxB,MAAM,EAAE,qBAAqB,EAC7B,KAAK,EAAE,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,GACnC,IAAI,CAMN"}