hikoutei 0.2.0

package/dist/application/orm/persistence/flush/flushCoordinator.js

@@ -0,0 +1,170 @@
+/**
+ * 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 { randomUUID } from "node:crypto";
+import { EMPTY_STRING_LENGTH_ZERO, POSITIVE_SAFE_INTEGER_MINIMUM, } from "../../../../domain/index.js";
+import { SYNC_TIMING_SCOPES } from "../../../sync/telemetry/syncTiming.js";
+import { WRITER_LEASE_CLAIM_RESULT_KINDS, claimWriterLeaseWithSql, registerSyncSheetWithSql, } from "../../../../infrastructure/storage/index.js";
+import { TYPED_SHEETS_ENTITY_CHANGE_KINDS, } from "../../api/contracts.js";
+import { createTypedSheetsEntityMappingRegistry, createTypedSheetsMappedProjectionDefinitions, typedSheetsEntityId, } from "../../mapping/entityMapping.js";
+import { TYPED_SHEETS_ORM_ERROR_CODES, TypedSheetsOrmError, } from "../../errors.js";
+import { DEFAULT_MAPPED_WRITER_LEASE_DURATION_MS, DEFAULT_MAPPED_WRITER_ROLE, } from "../support/contracts.js";
+import { applyMappedChange } from "../lifecycle/entityLifecycle.js";
+import { countsForPlans, emitTiming, operationKindsForCounts, } from "../support/timing.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 function createMappedTypedSheetsFlushCoordinator(options) {
+    const mappings = mappingRegistry(options.mappings);
+    const writer = resolveWriterOptions(options.writer);
+    return {
+        async onFlush(context) {
+            const flushStartedAt = Date.now();
+            const plans = collectMappedChanges(mappings, context.changes);
+            if (plans.length === 0)
+                return;
+            const operationCounts = countsForPlans(plans);
+            const leaseStartedAt = Date.now();
+            const now = writer.now();
+            const claim = await claimWriterLeaseWithSql(context.sql, {
+                role: writer.role,
+                writerId: writer.writerId,
+                leaseDurationMs: writer.leaseDurationMs,
+                now,
+            });
+            if (claim.kind !== WRITER_LEASE_CLAIM_RESULT_KINDS.CLAIMED) {
+                throw new TypedSheetsOrmError(TYPED_SHEETS_ORM_ERROR_CODES.WRITER_LEASE_UNAVAILABLE, `mapped entity writer lease is unavailable: ${claim.reason}.`);
+            }
+            emitTiming(writer, {
+                scope: SYNC_TIMING_SCOPES.ORM_FLUSH,
+                phase: "writer_lease_claim",
+                durationMs: Date.now() - leaseStartedAt,
+                operationKinds: operationKindsForCounts(operationCounts),
+                operationCounts,
+            });
+            const fence = {
+                role: claim.lease.role,
+                writerEpoch: claim.lease.writerEpoch,
+                fencingToken: claim.lease.fencingToken,
+                now,
+            };
+            for (const plan of plans) {
+                await applyMappedChange(context.sql, fence, writer, plan);
+            }
+            emitTiming(writer, {
+                scope: SYNC_TIMING_SCOPES.ORM_FLUSH,
+                phase: "flush_total",
+                durationMs: Date.now() - flushStartedAt,
+                operationKinds: operationKindsForCounts(operationCounts),
+                operationCounts,
+            });
+        },
+    };
+}
+/**
+ * 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 async function registerTypedSheetsEntityMappings(storage, mappingsInput, writerInput) {
+    const mappings = mappingRegistry(mappingsInput);
+    const writer = resolveWriterOptions(writerInput);
+    const definitions = createTypedSheetsMappedProjectionDefinitions(mappings.mappings);
+    return storage.transaction(async ({ sql }) => {
+        const now = writer.now();
+        const claim = await claimWriterLeaseWithSql(sql, {
+            role: writer.role,
+            writerId: writer.writerId,
+            leaseDurationMs: writer.leaseDurationMs,
+            now,
+        });
+        if (claim.kind !== WRITER_LEASE_CLAIM_RESULT_KINDS.CLAIMED) {
+            throw new TypedSheetsOrmError(TYPED_SHEETS_ORM_ERROR_CODES.WRITER_LEASE_UNAVAILABLE, `mapped projection registration lease is unavailable: ${claim.reason}.`);
+        }
+        const fence = {
+            role: claim.lease.role,
+            writerEpoch: claim.lease.writerEpoch,
+            fencingToken: claim.lease.fencingToken,
+            now,
+        };
+        const registered = [];
+        for (const definition of definitions) {
+            const result = await registerSyncSheetWithSql(sql, fence, definition.registration);
+            if (result.kind !== "registered") {
+                throw new TypedSheetsOrmError(TYPED_SHEETS_ORM_ERROR_CODES.WRITER_LEASE_UNAVAILABLE, `writer lease was lost while registering ${definition.projection.physicalSheetId}.`);
+            }
+            registered.push({
+                mapping: definition.mapping,
+                sheet: result.sheet,
+                headers: definition.headers,
+            });
+        }
+        return registered;
+    });
+}
+/** Converts registered mapping routes into gateway provisioning definitions. */
+export function registeredTypedSheetsProjectionDefinitions(registrations) {
+    return registrations.map(({ sheet, headers }) => ({ sheet, headers }));
+}
+function collectMappedChanges(mappings, changes) {
+    const plans = [];
+    for (const change of changes) {
+        const mapping = mappings.findByEntityName(change.entityName);
+        if (mapping === undefined)
+            continue;
+        const changedFields = changedMappingFields(mapping, change);
+        if (change.kind === TYPED_SHEETS_ENTITY_CHANGE_KINDS.UPDATE &&
+            changedFields.length === 0)
+            continue;
+        plans.push({ mapping, change, changedFields });
+    }
+    return plans;
+}
+function changedMappingFields(mapping, change) {
+    if (change.kind !== TYPED_SHEETS_ENTITY_CHANGE_KINDS.UPDATE)
+        return mapping.fields;
+    if (hasOwn(change.payload, mapping.primaryKey)) {
+        const nextPrimaryKey = change.payload[mapping.primaryKey];
+        const entityId = typedSheetsEntityId(mapping, change.entity);
+        if (nextPrimaryKey !== entityId) {
+            throw new TypedSheetsOrmError(TYPED_SHEETS_ORM_ERROR_CODES.ENTITY_PRIMARY_KEY_MUTATION, `${mapping.entityName}.${mapping.primaryKey} cannot change after it is mapped to Sheets.`);
+        }
+    }
+    return mapping.fields.filter((field) => hasOwn(change.payload, field.property));
+}
+function mappingRegistry(input) {
+    if ("findByEntityName" in input)
+        return input;
+    return createTypedSheetsEntityMappingRegistry(input);
+}
+function resolveWriterOptions(options) {
+    if (options.writerId.length === EMPTY_STRING_LENGTH_ZERO) {
+        throw new TypedSheetsOrmError(TYPED_SHEETS_ORM_ERROR_CODES.INVALID_ENTITY_MAPPING, "mapped writer ID is required.");
+    }
+    const role = options.role ?? DEFAULT_MAPPED_WRITER_ROLE;
+    const leaseDurationMs = options.leaseDurationMs ?? DEFAULT_MAPPED_WRITER_LEASE_DURATION_MS;
+    if (role.length === EMPTY_STRING_LENGTH_ZERO ||
+        !Number.isSafeInteger(leaseDurationMs) ||
+        leaseDurationMs < POSITIVE_SAFE_INTEGER_MINIMUM) {
+        throw new TypedSheetsOrmError(TYPED_SHEETS_ORM_ERROR_CODES.INVALID_ENTITY_MAPPING, "mapped writer role and lease duration must be valid.");
+    }
+    return {
+        writerId: options.writerId,
+        role,
+        leaseDurationMs,
+        now: options.now ?? (() => Date.now()),
+        createId: options.createId ?? randomUUID,
+        onTiming: options.onTiming,
+    };
+}
+function hasOwn(value, key) {
+    return Object.prototype.hasOwnProperty.call(value, key);
+}
+//# sourceMappingURL=flushCoordinator.js.map

package/dist/application/orm/persistence/flush/flushCoordinator.js.map

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

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

@@ -0,0 +1,9 @@
+/**
+ * Backward-compatible persistence entrypoint.
+ *
+ * The mapped flush implementation is split by responsibility, but existing
+ * imports from `mappedFlushCoordinator.ts` remain valid for callers and tests.
+ */
+export { createMappedTypedSheetsFlushCoordinator, registerTypedSheetsEntityMappings, registeredTypedSheetsProjectionDefinitions, } from "./flushCoordinator.js";
+export type { CreateMappedTypedSheetsFlushCoordinatorOptions, RegisteredTypedSheetsMappedProjection, TypedSheetsEntityWriterOptions, } from "../support/contracts.js";
+//# sourceMappingURL=mappedFlushCoordinator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mappedFlushCoordinator.d.ts","sourceRoot":"","sources":["../../../../../src/application/orm/persistence/flush/mappedFlushCoordinator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,uCAAuC,EACvC,iCAAiC,EACjC,0CAA0C,GAC3C,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,8CAA8C,EAC9C,qCAAqC,EACrC,8BAA8B,GAC/B,MAAM,yBAAyB,CAAC"}

package/dist/application/orm/persistence/flush/mappedFlushCoordinator.js

@@ -0,0 +1,8 @@
+/**
+ * Backward-compatible persistence entrypoint.
+ *
+ * The mapped flush implementation is split by responsibility, but existing
+ * imports from `mappedFlushCoordinator.ts` remain valid for callers and tests.
+ */
+export { createMappedTypedSheetsFlushCoordinator, registerTypedSheetsEntityMappings, registeredTypedSheetsProjectionDefinitions, } from "./flushCoordinator.js";
+//# sourceMappingURL=mappedFlushCoordinator.js.map

package/dist/application/orm/persistence/flush/mappedFlushCoordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mappedFlushCoordinator.js","sourceRoot":"","sources":["../../../../../src/application/orm/persistence/flush/mappedFlushCoordinator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,uCAAuC,EACvC,iCAAiC,EACjC,0CAA0C,GAC3C,MAAM,uBAAuB,CAAC"}

package/dist/application/orm/persistence/lifecycle/entityLifecycle.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Applies one mapped entity lifecycle change to canonical SQLite state.
+ *
+ * Each operation prepares its projection effects first, then commits canonical
+ * state and its outbox entries through the storage transaction boundary.
+ */
+import type { SqlExecutor } from "../../../../adapter/persistence/contracts/sql.js";
+import type { FencingContext } from "../support/contracts.js";
+import type { ResolvedWriterOptions, MappedChangePlan } from "../support/contracts.js";
+/** Applies one mapped change and emits append/update/delete phase timings. */
+export declare function applyMappedChange(sql: SqlExecutor, fence: FencingContext, writer: ResolvedWriterOptions, plan: MappedChangePlan): Promise<void>;
+//# sourceMappingURL=entityLifecycle.d.ts.map

package/dist/application/orm/persistence/lifecycle/entityLifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entityLifecycle.d.ts","sourceRoot":"","sources":["../../../../../src/application/orm/persistence/lifecycle/entityLifecycle.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAqBH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kDAAkD,CAAC;AACpF,OAAO,KAAK,EAAE,cAAc,EAA6C,MAAM,yBAAyB,CAAC;AACzG,OAAO,KAAK,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AA+BvF,8EAA8E;AAC9E,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,qBAAqB,EAC7B,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,IAAI,CAAC,CAmEf"}

package/dist/application/orm/persistence/lifecycle/entityLifecycle.js

@@ -0,0 +1,134 @@
+/**
+ * Applies one mapped entity lifecycle change to canonical SQLite state.
+ *
+ * Each operation prepares its projection effects first, then commits canonical
+ * state and its outbox entries through the storage transaction boundary.
+ */
+import { APPLICABILITY_KINDS, POSITIVE_SAFE_INTEGER_MINIMUM, ROW_OPERATIONS, stableHash, } from "../../../../domain/index.js";
+import { SYNC_TIMING_SCOPES } from "../../../sync/telemetry/syncTiming.js";
+import { TYPED_SHEETS_ENTITY_CHANGE_KINDS, } from "../../api/contracts.js";
+import { encodeTypedSheetsEntity, typedSheetsEntityAnchor, typedSheetsEntityRowBindingId, } from "../../mapping/entityMapping.js";
+import { claimBusinessKey, retireEntityBusinessKeys, rotateBusinessKey, } from "../support/businessKeys.js";
+import { canonicalFieldRevisions, insertActiveRowBinding, requireActiveCanonicalEntityRevision, requireActiveRowBinding, requireAppliedCanonicalCommit, tombstoneActiveRowBinding, } from "../support/canonicalState.js";
+import { projectionEffects } from "../projection/projectionEffects.js";
+import { countsForOperationKind, emitTiming, timingOperationKind, } from "../support/timing.js";
+import { identifiedValue, presentValue, requireChangeEntityId, requireEncodedField, } from "../support/helpers.js";
+import { TYPED_SHEETS_ORM_ERROR_CODES, TypedSheetsOrmError, } from "../../errors.js";
+/** Applies one mapped change and emits append/update/delete phase timings. */
+export async function applyMappedChange(sql, fence, writer, plan) {
+    const changeStartedAt = Date.now();
+    const { mapping, change, changedFields } = plan;
+    const operationKind = timingOperationKind(change.kind);
+    const entityId = requireChangeEntityId(mapping, change);
+    const rowBindingId = typedSheetsEntityRowBindingId(mapping, entityId);
+    const anchor = typedSheetsEntityAnchor(mapping, entityId);
+    const preparationStartedAt = Date.now();
+    const encodedEntity = encodeTypedSheetsEntity(mapping, change.entity);
+    emitTiming(writer, {
+        scope: SYNC_TIMING_SCOPES.ORM_FLUSH,
+        phase: "entity_prepare",
+        durationMs: Date.now() - preparationStartedAt,
+        operationKinds: [operationKind],
+        operationCounts: countsForOperationKind(operationKind),
+    });
+    const canonicalStartedAt = Date.now();
+    if (change.kind === TYPED_SHEETS_ENTITY_CHANGE_KINDS.CREATE) {
+        await createMappedEntity(sql, fence, writer, mapping, entityId, rowBindingId, anchor, encodedEntity);
+    }
+    else if (change.kind === TYPED_SHEETS_ENTITY_CHANGE_KINDS.UPDATE) {
+        await updateMappedEntity(sql, fence, writer, mapping, entityId, rowBindingId, anchor, encodedEntity, changedFields);
+    }
+    else {
+        await deleteMappedEntity(sql, fence, writer, mapping, entityId, rowBindingId, anchor, encodedEntity);
+    }
+    emitTiming(writer, {
+        scope: SYNC_TIMING_SCOPES.ORM_FLUSH,
+        phase: "canonical_outbox_commit",
+        durationMs: Date.now() - canonicalStartedAt,
+        operationKinds: [operationKind],
+        operationCounts: countsForOperationKind(operationKind),
+    });
+    emitTiming(writer, {
+        scope: SYNC_TIMING_SCOPES.ORM_FLUSH,
+        phase: "entity_change_total",
+        durationMs: Date.now() - changeStartedAt,
+        operationKinds: [operationKind],
+        operationCounts: countsForOperationKind(operationKind),
+    });
+}
+async function createMappedEntity(sql, fence, writer, mapping, entityId, rowBindingId, anchor, encodedEntity) {
+    await insertActiveRowBinding(sql, mapping, rowBindingId, entityId, anchor);
+    const commitId = identifiedValue("commit", writer);
+    const effects = await projectionEffects(sql, writer, mapping, entityId, rowBindingId, anchor, encodedEntity, TYPED_SHEETS_ENTITY_CHANGE_KINDS.CREATE, mapping.fields, commitId, POSITIVE_SAFE_INTEGER_MINIMUM);
+    const commit = {
+        kind: ROW_OPERATIONS.INSERT,
+        entityId,
+        acceptedSnapshotHash: acceptedSnapshotHash(entityId, encodedEntity),
+        fields: mapping.fields.map((field) => ({
+            fieldName: field.fieldName,
+            value: requireEncodedField(encodedEntity, field),
+            expectedFieldRevision: { kind: APPLICABILITY_KINDS.NOT_APPLICABLE },
+            ownership: field.ownership,
+        })),
+        effects,
+    };
+    await requireAppliedCanonicalCommit(sql, fence, commit);
+    await claimBusinessKey(sql, mapping, entityId, encodedEntity);
+}
+async function updateMappedEntity(sql, fence, writer, mapping, entityId, rowBindingId, anchor, encodedEntity, changedFields) {
+    await requireActiveRowBinding(sql, mapping, rowBindingId, entityId, anchor);
+    const entityRevision = await requireActiveCanonicalEntityRevision(sql, mapping, entityId);
+    const fieldRevisions = await canonicalFieldRevisions(sql, entityId);
+    const fields = changedFields.map((field) => {
+        const expectedFieldRevision = fieldRevisions.get(field.fieldName);
+        if (expectedFieldRevision === undefined) {
+            throw new TypedSheetsOrmError(TYPED_SHEETS_ORM_ERROR_CODES.CANONICAL_COMMIT_REJECTED, `${mapping.entityName}.${field.property} has no canonical field revision.`);
+        }
+        return {
+            fieldName: field.fieldName,
+            value: requireEncodedField(encodedEntity, field),
+            expectedFieldRevision: { kind: APPLICABILITY_KINDS.APPLICABLE, value: expectedFieldRevision },
+            ownership: field.ownership,
+        };
+    });
+    const nextEntityRevision = entityRevision + 1;
+    const commitId = identifiedValue("commit", writer);
+    const effects = await projectionEffects(sql, writer, mapping, entityId, rowBindingId, anchor, encodedEntity, TYPED_SHEETS_ENTITY_CHANGE_KINDS.UPDATE, changedFields, commitId, nextEntityRevision);
+    const commit = {
+        kind: ROW_OPERATIONS.UPDATE,
+        entityId,
+        acceptedSnapshotHash: acceptedSnapshotHash(entityId, encodedEntity),
+        fields,
+        effects,
+    };
+    await requireAppliedCanonicalCommit(sql, fence, commit);
+    if (changedFields.some((field) => field.fieldName === mapping.businessKey.fieldName)) {
+        await rotateBusinessKey(sql, mapping, entityId, encodedEntity);
+    }
+}
+async function deleteMappedEntity(sql, fence, writer, mapping, entityId, rowBindingId, anchor, encodedEntity) {
+    await requireActiveRowBinding(sql, mapping, rowBindingId, entityId, anchor);
+    const entityRevision = await requireActiveCanonicalEntityRevision(sql, mapping, entityId);
+    const nextEntityRevision = entityRevision + 1;
+    const commitId = identifiedValue("commit", writer);
+    const effects = await projectionEffects(sql, writer, mapping, entityId, rowBindingId, anchor, encodedEntity, TYPED_SHEETS_ENTITY_CHANGE_KINDS.DELETE, [], commitId, nextEntityRevision);
+    const commit = {
+        kind: ROW_OPERATIONS.DELETE,
+        entityId,
+        acceptedSnapshotHash: acceptedSnapshotHash(entityId, encodedEntity),
+        expectedEntityRevision: entityRevision,
+        effects,
+    };
+    await requireAppliedCanonicalCommit(sql, fence, commit);
+    await tombstoneActiveRowBinding(sql, mapping, rowBindingId, entityId);
+    await retireEntityBusinessKeys(sql, mapping, entityId);
+}
+function acceptedSnapshotHash(entityId, fields) {
+    return presentValue(stableHash({
+        entityId,
+        fields: Object.entries(fields)
+            .sort(([left], [right]) => left.localeCompare(right))
+            .map(([fieldName, value]) => ({ fieldName, value })),
+    }));
+}
+//# sourceMappingURL=entityLifecycle.js.map

package/dist/application/orm/persistence/lifecycle/entityLifecycle.js.map

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

package/dist/application/orm/persistence/projection/projectionEffects.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Projection-effect planning for mapped entity lifecycle changes.
+ *
+ * This module derives system-state and user-input effects from the SQLite
+ * baseline. It does not execute them; the outbox worker remains responsible
+ * for materializing effects in Apps Script.
+ */
+import { type EffectTargetKind, type NormalizedCell } from "../../../../domain/index.js";
+import type { NewEffect, RegisteredSyncSheet, SqlExecutor } from "../support/contracts.js";
+import { type ProjectionBaseline, type ResolvedWriterOptions } from "../support/contracts.js";
+import { type TypedSheetsEntityChange } from "../../api/contracts.js";
+import { type TypedSheetsEntityFieldMapping, type TypedSheetsEntityMapping, type TypedSheetsEntityProjectionMapping } from "../../mapping/entityMapping.js";
+/** Plans all projection effects required by one mapped entity lifecycle change. */
+export declare function projectionEffects(sql: SqlExecutor, writer: ResolvedWriterOptions, mapping: TypedSheetsEntityMapping, entityId: string, rowBindingId: string, anchor: string, encodedEntity: Readonly<Record<string, NormalizedCell>>, changeKind: TypedSheetsEntityChange["kind"], changedFields: readonly TypedSheetsEntityFieldMapping[], commitId: string, targetEntityRevision: number): Promise<readonly NewEffect[]>;
+/** Loads and validates the registered route for a mapped projection. */
+export declare function requireMappedRoute(sql: SqlExecutor, mapping: TypedSheetsEntityMapping, projection: TypedSheetsEntityProjectionMapping): Promise<RegisteredSyncSheet>;
+/** Derives the next visible revision/hash from queued or confirmed state. */
+export declare function projectionBaseline(sql: SqlExecutor, mapping: TypedSheetsEntityMapping, projection: TypedSheetsEntityProjectionMapping, rowBindingId: string, targetKind: EffectTargetKind, targetId: string): Promise<ProjectionBaseline>;
+/** Reads the last confirmed visible state when no effect is currently queued. */
+export declare function projectionBaselineFromConfirmedState(sql: SqlExecutor, mapping: TypedSheetsEntityMapping, projection: TypedSheetsEntityProjectionMapping, rowBindingId: string, streamSequence: number): Promise<ProjectionBaseline>;
+//# sourceMappingURL=projectionEffects.d.ts.map

package/dist/application/orm/persistence/projection/projectionEffects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectionEffects.d.ts","sourceRoot":"","sources":["../../../../../src/application/orm/persistence/projection/projectionEffects.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAIL,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACpB,MAAM,6BAA6B,CAAC;AAarC,OAAO,KAAK,EACV,SAAS,EACT,mBAAmB,EACnB,WAAW,EACZ,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAML,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAE3B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAEL,KAAK,6BAA6B,EAClC,KAAK,wBAAwB,EAC7B,KAAK,kCAAkC,EACxC,MAAM,gCAAgC,CAAC;AAiBxC,mFAAmF;AACnF,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,qBAAqB,EAC7B,OAAO,EAAE,wBAAwB,EACjC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,EACvD,UAAU,EAAE,uBAAuB,CAAC,MAAM,CAAC,EAC3C,aAAa,EAAE,SAAS,6BAA6B,EAAE,EACvD,QAAQ,EAAE,MAAM,EAChB,oBAAoB,EAAE,MAAM,GAC3B,OAAO,CAAC,SAAS,SAAS,EAAE,CAAC,CAoI/B;AAED,wEAAwE;AACxE,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,wBAAwB,EACjC,UAAU,EAAE,kCAAkC,GAC7C,OAAO,CAAC,mBAAmB,CAAC,CAa9B;AAED,6EAA6E;AAC7E,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,wBAAwB,EACjC,UAAU,EAAE,kCAAkC,EAC9C,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,gBAAgB,EAC5B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,kBAAkB,CAAC,CAwD7B;AAED,iFAAiF;AACjF,wBAAsB,oCAAoC,CACxD,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,wBAAwB,EACjC,UAAU,EAAE,kCAAkC,EAC9C,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,kBAAkB,CAAC,CA0B7B"}

package/dist/application/orm/persistence/projection/projectionEffects.js

@@ -0,0 +1,203 @@
+/**
+ * Projection-effect planning for mapped entity lifecycle changes.
+ *
+ * This module derives system-state and user-input effects from the SQLite
+ * baseline. It does not execute them; the outbox worker remains responsible
+ * for materializing effects in Apps Script.
+ */
+import { EMPTY_STRING_LENGTH_ZERO, FIELD_OWNERSHIPS, POSITIVE_SAFE_INTEGER_MINIMUM, } from "../../../../domain/index.js";
+import { NORMALIZED_CELL_KINDS } from "../../../../shared/encoding/constants.js";
+import { SYNC_GATEWAY_PROJECTIONS } from "../../../sync/gateway/constants.js";
+import { computeSyncVisibleHash, parseSyncProjectionEffectPayload, } from "../../../sync/gateway/syncGateway.js";
+import { createCandidateReconcileEffect, createSystemProjectionEffect, createUserInputDeleteEffect, } from "../../../sync/outbound/projection/ProjectionEffectFactory.js";
+import { requireRegisteredSyncSheetWithSql } from "../../../../infrastructure/storage/index.js";
+import { MAPPED_EFFECT_STATUSES, MAPPED_EFFECT_TARGET_KINDS, READ_LATEST_PROJECTION_EFFECT_SQL, READ_VISIBLE_PROJECTION_STATE_SQL, } from "../support/contracts.js";
+import { TYPED_SHEETS_ENTITY_CHANGE_KINDS, } from "../../api/contracts.js";
+import { requireTypedSheetsEntityProjection, } from "../../mapping/entityMapping.js";
+import { TYPED_SHEETS_ORM_ERROR_CODES, TypedSheetsOrmError, } from "../../errors.js";
+import { absentValue, applicableValue, identifiedValue, isNonNegativeSafeInteger, isPositiveSafeInteger, projectionRowTargetId, requireEncodedField, throwProjectionBlocked, presentValue, } from "../support/helpers.js";
+/** Plans all projection effects required by one mapped entity lifecycle change. */
+export async function projectionEffects(sql, writer, mapping, entityId, rowBindingId, anchor, encodedEntity, changeKind, changedFields, commitId, targetEntityRevision) {
+    const systemProjection = requireTypedSheetsEntityProjection(mapping, SYNC_GATEWAY_PROJECTIONS.SYSTEM_STATE);
+    const systemRoute = await requireMappedRoute(sql, mapping, systemProjection);
+    const systemTarget = {
+        targetKind: MAPPED_EFFECT_TARGET_KINDS.ENTITY,
+        targetId: entityId,
+    };
+    const systemBaseline = await projectionBaseline(sql, mapping, systemProjection, rowBindingId, systemTarget.targetKind, systemTarget.targetId);
+    const systemFields = {
+        ...encodedEntity,
+        [mapping.tombstoneFieldName]: {
+            kind: NORMALIZED_CELL_KINDS.BOOLEAN,
+            value: changeKind === TYPED_SHEETS_ENTITY_CHANGE_KINDS.DELETE,
+        },
+    };
+    const effects = [
+        createSystemProjectionEffect({
+            effectId: identifiedValue("effect", writer),
+            commitId,
+            logicalSheetId: mapping.logicalSheetId,
+            physicalSheetId: systemRoute.physicalSheetId,
+            sheetName: systemRoute.tabName,
+            registeredRange: systemRoute.registeredRange,
+            projection: SYNC_GATEWAY_PROJECTIONS.SYSTEM_STATE,
+            schemaVersion: mapping.schemaVersion,
+            targetKind: systemTarget.targetKind,
+            targetId: systemTarget.targetId,
+            rowBindingId: presentValue(rowBindingId),
+            conflictId: absentValue(),
+            targetAnchor: anchor,
+            fields: systemFields,
+            createIfMissing: systemBaseline.createIfMissing,
+            expectedVisibleRevision: systemBaseline.expectedVisibleRevision,
+            expectedVisibleHash: systemBaseline.expectedVisibleHash,
+            targetEntityRevision: applicableValue(targetEntityRevision),
+            streamSequence: systemBaseline.streamSequence,
+        }),
+    ];
+    const userProjection = mapping.projections.find((projection) => projection.projection === SYNC_GATEWAY_PROJECTIONS.USER_INPUT);
+    if (userProjection === undefined)
+        return effects;
+    const shouldReconcileUserInput = userProjection !== undefined &&
+        changeKind !== TYPED_SHEETS_ENTITY_CHANGE_KINDS.DELETE &&
+        (changeKind === TYPED_SHEETS_ENTITY_CHANGE_KINDS.CREATE ||
+            changedFields.some((field) => field.ownership === FIELD_OWNERSHIPS.USER));
+    if (changeKind !== TYPED_SHEETS_ENTITY_CHANGE_KINDS.DELETE &&
+        !shouldReconcileUserInput)
+        return effects;
+    const userRoute = await requireMappedRoute(sql, mapping, userProjection);
+    const userFields = Object.fromEntries(mapping.fields
+        .filter((field) => field.ownership === FIELD_OWNERSHIPS.USER)
+        .map((field) => [field.fieldName, requireEncodedField(encodedEntity, field)]));
+    const userTarget = {
+        targetKind: MAPPED_EFFECT_TARGET_KINDS.PROJECTION_ROW,
+        targetId: projectionRowTargetId(userProjection.physicalSheetId, rowBindingId),
+    };
+    const userBaseline = await projectionBaseline(sql, mapping, userProjection, rowBindingId, userTarget.targetKind, userTarget.targetId);
+    if (changeKind === TYPED_SHEETS_ENTITY_CHANGE_KINDS.DELETE) {
+        const userFieldHash = computeSyncVisibleHash(userFields);
+        if (userFieldHash !== userBaseline.expectedVisibleHash) {
+            throwProjectionBlocked(mapping, userProjection, "the User_Input row does not match the entity fields selected for deletion");
+        }
+        effects.push(createUserInputDeleteEffect({
+            effectId: identifiedValue("effect", writer),
+            commitId,
+            logicalSheetId: mapping.logicalSheetId,
+            physicalSheetId: userRoute.physicalSheetId,
+            sheetName: userRoute.tabName,
+            registeredRange: userRoute.registeredRange,
+            schemaVersion: mapping.schemaVersion,
+            targetKind: userTarget.targetKind,
+            targetId: userTarget.targetId,
+            rowBindingId: presentValue(rowBindingId),
+            conflictId: absentValue(),
+            targetAnchor: anchor,
+            fields: userFields,
+            createIfMissing: false,
+            expectedVisibleRevision: userBaseline.expectedVisibleRevision,
+            expectedVisibleHash: userBaseline.expectedVisibleHash,
+            targetEntityRevision: applicableValue(targetEntityRevision),
+            streamSequence: userBaseline.streamSequence,
+        }));
+        return effects;
+    }
+    effects.push(createCandidateReconcileEffect({
+        effectId: identifiedValue("effect", writer),
+        commitId,
+        logicalSheetId: mapping.logicalSheetId,
+        physicalSheetId: userRoute.physicalSheetId,
+        sheetName: userRoute.tabName,
+        registeredRange: userRoute.registeredRange,
+        schemaVersion: mapping.schemaVersion,
+        targetKind: userTarget.targetKind,
+        targetId: userTarget.targetId,
+        rowBindingId: presentValue(rowBindingId),
+        conflictId: absentValue(),
+        targetAnchor: anchor,
+        fields: userFields,
+        createIfMissing: userBaseline.createIfMissing,
+        expectedVisibleRevision: userBaseline.expectedVisibleRevision,
+        expectedVisibleHash: userBaseline.expectedVisibleHash,
+        targetEntityRevision: applicableValue(targetEntityRevision),
+        streamSequence: userBaseline.streamSequence,
+    }));
+    return effects;
+}
+/** Loads and validates the registered route for a mapped projection. */
+export async function requireMappedRoute(sql, mapping, projection) {
+    const route = await requireRegisteredSyncSheetWithSql(sql, projection.physicalSheetId);
+    if (route.logicalSheetId !== mapping.logicalSheetId ||
+        route.projection !== projection.projection ||
+        route.schemaVersion !== mapping.schemaVersion) {
+        throw new TypedSheetsOrmError(TYPED_SHEETS_ORM_ERROR_CODES.INVALID_ENTITY_MAPPING, `registered route ${projection.physicalSheetId} does not match ${mapping.entityName}'s mapping.`);
+    }
+    return route;
+}
+/** Derives the next visible revision/hash from queued or confirmed state. */
+export async function projectionBaseline(sql, mapping, projection, rowBindingId, targetKind, targetId) {
+    const latest = await sql.get(READ_LATEST_PROJECTION_EFFECT_SQL, [
+        mapping.logicalSheetId,
+        targetKind,
+        targetId,
+    ]);
+    if (latest !== undefined) {
+        if (latest.physical_sheet_id !== projection.physicalSheetId ||
+            latest.projection !== projection.projection ||
+            !isPositiveSafeInteger(latest.stream_sequence)) {
+            throwProjectionBlocked(mapping, projection, "latest target effect has incompatible routing");
+        }
+        const streamSequence = latest.stream_sequence + 1;
+        if (!isPositiveSafeInteger(streamSequence)) {
+            throwProjectionBlocked(mapping, projection, "projection stream sequence overflowed");
+        }
+        if (latest.status === MAPPED_EFFECT_STATUSES.PENDING ||
+            latest.status === MAPPED_EFFECT_STATUSES.PROCESSING) {
+            if (!isNonNegativeSafeInteger(latest.expected_visible_revision)) {
+                throwProjectionBlocked(mapping, projection, "latest effect has an invalid expected visible revision");
+            }
+            const expectedVisibleRevision = latest.expected_visible_revision + 1;
+            if (!isNonNegativeSafeInteger(expectedVisibleRevision)) {
+                throwProjectionBlocked(mapping, projection, "projection visible revision overflowed");
+            }
+            const payload = parseSyncProjectionEffectPayload(latest.payload_json);
+            return {
+                expectedVisibleRevision,
+                expectedVisibleHash: payload.targetVisibleHash,
+                createIfMissing: false,
+                streamSequence,
+            };
+        }
+        if (latest.status !== MAPPED_EFFECT_STATUSES.APPLIED) {
+            throwProjectionBlocked(mapping, projection, `latest effect is ${latest.status}`);
+        }
+        return projectionBaselineFromConfirmedState(sql, mapping, projection, rowBindingId, streamSequence);
+    }
+    return projectionBaselineFromConfirmedState(sql, mapping, projection, rowBindingId, POSITIVE_SAFE_INTEGER_MINIMUM);
+}
+/** Reads the last confirmed visible state when no effect is currently queued. */
+export async function projectionBaselineFromConfirmedState(sql, mapping, projection, rowBindingId, streamSequence) {
+    const visible = await sql.get(READ_VISIBLE_PROJECTION_STATE_SQL, [
+        projection.physicalSheetId,
+        projection.projection,
+        rowBindingId,
+    ]);
+    if (visible === undefined) {
+        return {
+            expectedVisibleRevision: 0,
+            expectedVisibleHash: "",
+            createIfMissing: true,
+            streamSequence,
+        };
+    }
+    if (!isNonNegativeSafeInteger(visible.confirmed_visible_revision) ||
+        visible.confirmed_snapshot_hash.length === EMPTY_STRING_LENGTH_ZERO) {
+        throwProjectionBlocked(mapping, projection, "confirmed visible state is invalid");
+    }
+    return {
+        expectedVisibleRevision: visible.confirmed_visible_revision,
+        expectedVisibleHash: visible.confirmed_snapshot_hash,
+        createIfMissing: false,
+        streamSequence,
+    };
+}
+//# sourceMappingURL=projectionEffects.js.map

package/dist/application/orm/persistence/projection/projectionEffects.js.map

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