hikoutei 0.2.0

package/dist/application/sync/outbound/effects/SyncEffectWorkerHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SyncEffectWorkerHelpers.d.ts","sourceRoot":"","sources":["../../../../../src/application/sync/outbound/effects/SyncEffectWorkerHelpers.ts"],"names":[],"mappings":"AAAA,qEAAqE;AAErE,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACzF,OAAO,EAGL,cAAc,EACf,MAAM,uCAAuC,CAAC;AAM/C,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEvD;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI;IAC5B,QAAQ,CAAC,IAAI,EAAE,OAAO,cAAc,CAAC,OAAO,CAAC;IAC7C,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;CACnB,CAAC;AAEF,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAErD;AAED,wBAAgB,WAAW,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAE5C;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,YAAY,CAAC,CAAC,CAAC,CAEzE;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,OAAO,CAEvD;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,SAAS,GAAG,YAAY,CAAC,CAAC,CAAC,CAIrE;AAED,wBAAgB,4BAA4B,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,aAAa,CAAC,CAAC,CAAC,CAIjF;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAEvD"}

package/dist/application/sync/outbound/effects/SyncEffectWorkerHelpers.js

@@ -0,0 +1,32 @@
+/** Small value and error helpers shared by effect-worker modules. */
+import { APPLICABILITY_KINDS, LOOKUP_RESULT_KINDS, PRESENCE_KINDS, } from "../../../../shared/state/constants.js";
+import { STORAGE_ERROR_CODES, StorageError, } from "../../../../infrastructure/storage/errors.js";
+export function safeErrorMessage(error) {
+    return error instanceof Error ? error.message.slice(0, 500) : "unknown sync gateway failure";
+}
+export function presentValue(value) {
+    return { kind: PRESENCE_KINDS.PRESENT, value };
+}
+export function absentValue() {
+    return { kind: PRESENCE_KINDS.ABSENT };
+}
+export function isPresent(value) {
+    return value.kind === PRESENCE_KINDS.PRESENT;
+}
+export function isAbsent(value) {
+    return value.kind === PRESENCE_KINDS.ABSENT;
+}
+export function lookupResult(value) {
+    return value === undefined
+        ? { kind: LOOKUP_RESULT_KINDS.NOT_FOUND }
+        : { kind: LOOKUP_RESULT_KINDS.FOUND, value };
+}
+export function applicabilityFromSqlNullable(value) {
+    return value === null
+        ? { kind: APPLICABILITY_KINDS.NOT_APPLICABLE }
+        : { kind: APPLICABILITY_KINDS.APPLICABLE, value };
+}
+export function throwWorkerError(message) {
+    throw new StorageError(STORAGE_ERROR_CODES.INVALID_PENDING_EFFECT, message);
+}
+//# sourceMappingURL=SyncEffectWorkerHelpers.js.map

package/dist/application/sync/outbound/effects/SyncEffectWorkerHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SyncEffectWorkerHelpers.js","sourceRoot":"","sources":["../../../../../src/application/sync/outbound/effects/SyncEffectWorkerHelpers.ts"],"names":[],"mappings":"AAAA,qEAAqE;AAGrE,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,GACf,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACL,mBAAmB,EACnB,YAAY,GACb,MAAM,8CAA8C,CAAC;AAEtD,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,8BAA8B,CAAC;AAC/F,CAAC;AAWD,MAAM,UAAU,YAAY,CAAI,KAAQ;IACtC,OAAO,EAAE,IAAI,EAAE,cAAc,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,EAAE,IAAI,EAAE,cAAc,CAAC,MAAM,EAAE,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,SAAS,CAAI,KAAkB;IAC7C,OAAO,KAAK,CAAC,IAAI,KAAK,cAAc,CAAC,OAAO,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,QAAQ,CAAI,KAAkB;IAC5C,OAAO,KAAK,CAAC,IAAI,KAAK,cAAc,CAAC,MAAM,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,YAAY,CAAI,KAAoB;IAClD,OAAO,KAAK,KAAK,SAAS;QACxB,CAAC,CAAC,EAAE,IAAI,EAAE,mBAAmB,CAAC,SAAS,EAAE;QACzC,CAAC,CAAC,EAAE,IAAI,EAAE,mBAAmB,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAI,KAAe;IAC7D,OAAO,KAAK,KAAK,IAAI;QACnB,CAAC,CAAC,EAAE,IAAI,EAAE,mBAAmB,CAAC,cAAc,EAAE;QAC9C,CAAC,CAAC,EAAE,IAAI,EAAE,mBAAmB,CAAC,UAAU,EAAE,KAAK,EAAE,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,MAAM,IAAI,YAAY,CAAC,mBAAmB,CAAC,sBAAsB,EAAE,OAAO,CAAC,CAAC;AAC9E,CAAC"}

package/dist/application/sync/outbound/effects/SyncEffectWorkerRouting.d.ts

@@ -0,0 +1,30 @@
+/** Effect conversion, request grouping, and routing predicates. */
+import type { EffectTargetKind } from "../../../../domain/index.js";
+import type { PendingEffect, WriterLease, FencingContext } from "../../../../infrastructure/storage/index.js";
+import type { ApplySyncEffectsRequest, FastAppendRowsRequest, ReadSyncEffectPostconditionsRequest, SyncGatewayEffect, SyncGatewayEffectResult, SyncProjection } from "../../gateway/syncGateway.js";
+import type { ClaimedEffect } from "./SyncEffectWorker.js";
+/** Accepts either inline read-back or a flushed-write acknowledgement. */
+export declare function isSuccessfulGatewayPostcondition(status: SyncGatewayEffectResult["postcondition"]): boolean;
+export declare function toGatewayEffect(effect: PendingEffect): SyncGatewayEffect;
+export declare function groupByGatewayRequest(items: readonly ClaimedEffect[]): readonly {
+    readonly request: ApplySyncEffectsRequest;
+    readonly items: readonly ClaimedEffect[];
+}[];
+/** Groups append-only system effects into one fast gateway request per route. */
+export declare function groupByFastAppendRequest(items: readonly ClaimedEffect[]): readonly {
+    readonly request: FastAppendRowsRequest;
+    readonly items: readonly ClaimedEffect[];
+}[];
+/** Groups postcondition reads so each group performs one remote Sheet scan. */
+export declare function groupByGatewayPostconditionRequest(items: readonly ClaimedEffect[]): readonly {
+    readonly request: ReadSyncEffectPostconditionsRequest;
+    readonly items: readonly ClaimedEffect[];
+}[];
+export declare function isSyncEffectKind(value: string): value is SyncGatewayEffect["effectKind"];
+export declare function isCandidateProtectingUserInputEffect(effect: SyncGatewayEffect): boolean;
+/** Selects only new System_State entity rows for the append-only fast path. */
+export declare function isFastAppendCandidate(item: ClaimedEffect): boolean;
+export declare function isSyncProjection(value: string): value is SyncProjection;
+export declare function isEffectTargetKind(value: string): value is EffectTargetKind;
+export declare function fenceFromLease(lease: WriterLease, now: number): FencingContext;
+//# sourceMappingURL=SyncEffectWorkerRouting.d.ts.map

package/dist/application/sync/outbound/effects/SyncEffectWorkerRouting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SyncEffectWorkerRouting.d.ts","sourceRoot":"","sources":["../../../../../src/application/sync/outbound/effects/SyncEffectWorkerRouting.ts"],"names":[],"mappings":"AAAA,mEAAmE;AAGnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAEpE,OAAO,KAAK,EACV,aAAa,EACb,WAAW,EACX,cAAc,EACf,MAAM,6CAA6C,CAAC;AAErD,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EACrB,mCAAmC,EAEnC,iBAAiB,EACjB,uBAAuB,EACvB,cAAc,EACf,MAAM,8BAA8B,CAAC;AAatC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,0EAA0E;AAC1E,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,uBAAuB,CAAC,eAAe,CAAC,GAC/C,OAAO,CAGT;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,iBAAiB,CAyBxE;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,GAAG,SAAS;IAC/E,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;CAC1C,EAAE,CAoCF;AAED,iFAAiF;AACjF,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,GAAG,SAAS;IAClF,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;CAC1C,EAAE,CAsCF;AAED,+EAA+E;AAC/E,wBAAgB,kCAAkC,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,GAAG,SAAS;IAC5F,QAAQ,CAAC,OAAO,EAAE,mCAAmC,CAAC;IACtD,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;CAC1C,EAAE,CAqCF;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,iBAAiB,CAAC,YAAY,CAAC,CAOxF;AAED,wBAAgB,oCAAoC,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAGvF;AAED,+EAA+E;AAC/E,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CASlE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,cAAc,CAIvE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,gBAAgB,CAK3E;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,cAAc,CAO9E"}

package/dist/application/sync/outbound/effects/SyncEffectWorkerRouting.js

@@ -0,0 +1,202 @@
+/** Effect conversion, request grouping, and routing predicates. */
+import { NON_NEGATIVE_SAFE_INTEGER_MINIMUM } from "../../../../domain/index.js";
+import { fromSqlNullable } from "../../../../infrastructure/storage/sqlite/sqlState.js";
+import { LOOKUP_RESULT_KINDS } from "../../../../shared/state/constants.js";
+import { parseSyncProjectionEffectPayload } from "../../gateway/syncGateway.js";
+import { SYNC_GATEWAY_POSTCONDITION_MODES, SYNC_GATEWAY_POSTCONDITION_STATUSES, SYNC_GATEWAY_PROJECTIONS, } from "../../gateway/constants.js";
+import { EFFECT_TARGET_KINDS, SYNC_EFFECT_KINDS } from "./SyncEffectWorkerConstants.js";
+import { isPresent, lookupResult, throwWorkerError, } from "./SyncEffectWorkerHelpers.js";
+/** Accepts either inline read-back or a flushed-write acknowledgement. */
+export function isSuccessfulGatewayPostcondition(status) {
+    return status === SYNC_GATEWAY_POSTCONDITION_STATUSES.VERIFIED ||
+        status === SYNC_GATEWAY_POSTCONDITION_STATUSES.ACKNOWLEDGED;
+}
+export function toGatewayEffect(effect) {
+    if (!isSyncEffectKind(effect.effect_kind)) {
+        throwWorkerError("unsupported sync effect kind: " + effect.effect_kind);
+    }
+    if (!isSyncProjection(effect.projection)) {
+        throwWorkerError("unsupported sync projection: " + effect.projection);
+    }
+    if (!isEffectTargetKind(effect.target_kind)) {
+        throwWorkerError("unsupported sync effect target kind: " + effect.target_kind);
+    }
+    return {
+        effectId: effect.effect_id,
+        payloadHash: effect.payload_hash,
+        effectKind: effect.effect_kind,
+        physicalSheetId: effect.physical_sheet_id,
+        projection: effect.projection,
+        targetKind: effect.target_kind,
+        targetId: effect.target_id,
+        rowBindingId: fromSqlNullable(effect.row_binding_id),
+        conflictId: fromSqlNullable(effect.conflict_id),
+        expectedVisibleRevision: effect.expected_visible_revision,
+        expectedVisibleHash: effect.expected_visible_hash,
+        repairGuardHash: fromSqlNullable(effect.repair_guard_hash),
+        payload: parseSyncProjectionEffectPayload(effect.payload_json),
+    };
+}
+export function groupByGatewayRequest(items) {
+    const groups = new Map();
+    for (const item of items) {
+        const effect = item.gatewayEffect;
+        if (!isPresent(effect))
+            continue;
+        const key = [
+            effect.value.physicalSheetId,
+            effect.value.payload.sheetName,
+            effect.value.payload.registeredRange,
+            effect.value.projection,
+            effect.value.payload.schemaVersion,
+        ].join("\u0000");
+        const existing = lookupResult(groups.get(key));
+        if (existing.kind === LOOKUP_RESULT_KINDS.NOT_FOUND) {
+            groups.set(key, {
+                request: {
+                    physicalSheetId: effect.value.physicalSheetId,
+                    sheetName: effect.value.payload.sheetName,
+                    registeredRange: effect.value.payload.registeredRange,
+                    projection: effect.value.projection,
+                    schemaVersion: effect.value.payload.schemaVersion,
+                    postconditionMode: SYNC_GATEWAY_POSTCONDITION_MODES.DEFERRED,
+                    effects: [effect.value],
+                },
+                items: [item],
+            });
+        }
+        else {
+            existing.value.request = {
+                ...existing.value.request,
+                postconditionMode: SYNC_GATEWAY_POSTCONDITION_MODES.DEFERRED,
+                effects: [...existing.value.request.effects, effect.value],
+            };
+            existing.value.items.push(item);
+        }
+    }
+    return [...groups.values()];
+}
+/** Groups append-only system effects into one fast gateway request per route. */
+export function groupByFastAppendRequest(items) {
+    const groups = new Map();
+    for (const item of items) {
+        const effect = item.gatewayEffect;
+        if (!isPresent(effect))
+            continue;
+        const key = [
+            effect.value.physicalSheetId,
+            effect.value.payload.sheetName,
+            effect.value.payload.registeredRange,
+            effect.value.projection,
+            effect.value.payload.schemaVersion,
+        ].join("\u0000");
+        const row = {
+            effectId: effect.value.effectId,
+            fields: effect.value.payload.fields,
+        };
+        const existing = lookupResult(groups.get(key));
+        if (existing.kind === LOOKUP_RESULT_KINDS.NOT_FOUND) {
+            groups.set(key, {
+                request: {
+                    physicalSheetId: effect.value.physicalSheetId,
+                    sheetName: effect.value.payload.sheetName,
+                    registeredRange: effect.value.payload.registeredRange,
+                    projection: effect.value.projection,
+                    schemaVersion: effect.value.payload.schemaVersion,
+                    rows: [row],
+                },
+                items: [item],
+            });
+        }
+        else {
+            existing.value.request = {
+                ...existing.value.request,
+                rows: [...existing.value.request.rows, row],
+            };
+            existing.value.items.push(item);
+        }
+    }
+    return [...groups.values()];
+}
+/** Groups postcondition reads so each group performs one remote Sheet scan. */
+export function groupByGatewayPostconditionRequest(items) {
+    const groups = new Map();
+    for (const item of items) {
+        const effect = item.gatewayEffect;
+        if (!isPresent(effect))
+            continue;
+        const key = [
+            effect.value.physicalSheetId,
+            effect.value.payload.sheetName,
+            effect.value.payload.registeredRange,
+            effect.value.projection,
+            effect.value.payload.schemaVersion,
+        ].join("\u0000");
+        const existing = lookupResult(groups.get(key));
+        if (existing.kind === LOOKUP_RESULT_KINDS.NOT_FOUND) {
+            groups.set(key, {
+                request: {
+                    physicalSheetId: effect.value.physicalSheetId,
+                    sheetName: effect.value.payload.sheetName,
+                    registeredRange: effect.value.payload.registeredRange,
+                    projection: effect.value.projection,
+                    schemaVersion: effect.value.payload.schemaVersion,
+                    effects: [effect.value],
+                },
+                items: [item],
+            });
+        }
+        else {
+            existing.value.request = {
+                ...existing.value.request,
+                effects: [...existing.value.request.effects, effect.value],
+            };
+            existing.value.items.push(item);
+        }
+    }
+    return [...groups.values()];
+}
+export function isSyncEffectKind(value) {
+    return value === SYNC_EFFECT_KINDS.SYSTEM_PROJECTION ||
+        value === SYNC_EFFECT_KINDS.CANDIDATE_RECONCILE ||
+        value === SYNC_EFFECT_KINDS.SYSTEM_REPAIR ||
+        value === SYNC_EFFECT_KINDS.RESOLUTION_PROJECTION ||
+        value === SYNC_EFFECT_KINDS.RESOLUTION_DELETE ||
+        value === SYNC_EFFECT_KINDS.USER_INPUT_DELETE;
+}
+export function isCandidateProtectingUserInputEffect(effect) {
+    return effect.effectKind === SYNC_EFFECT_KINDS.CANDIDATE_RECONCILE ||
+        effect.effectKind === SYNC_EFFECT_KINDS.USER_INPUT_DELETE;
+}
+/** Selects only new System_State entity rows for the append-only fast path. */
+export function isFastAppendCandidate(item) {
+    if (!isPresent(item.gatewayEffect))
+        return false;
+    const effect = item.gatewayEffect.value;
+    return effect.effectKind === SYNC_EFFECT_KINDS.SYSTEM_PROJECTION &&
+        effect.projection === SYNC_GATEWAY_PROJECTIONS.SYSTEM_STATE &&
+        effect.targetKind === EFFECT_TARGET_KINDS.ENTITY &&
+        effect.payload.createIfMissing &&
+        effect.expectedVisibleRevision === NON_NEGATIVE_SAFE_INTEGER_MINIMUM &&
+        effect.expectedVisibleHash === "";
+}
+export function isSyncProjection(value) {
+    return value === SYNC_GATEWAY_PROJECTIONS.USER_INPUT ||
+        value === SYNC_GATEWAY_PROJECTIONS.SYSTEM_STATE ||
+        value === SYNC_GATEWAY_PROJECTIONS.SYNC_CONFLICTS;
+}
+export function isEffectTargetKind(value) {
+    return value === EFFECT_TARGET_KINDS.ENTITY ||
+        value === EFFECT_TARGET_KINDS.ROW_BINDING ||
+        value === EFFECT_TARGET_KINDS.PROJECTION_ROW ||
+        value === EFFECT_TARGET_KINDS.CONFLICT;
+}
+export function fenceFromLease(lease, now) {
+    return {
+        role: lease.role,
+        writerEpoch: lease.writerEpoch,
+        fencingToken: lease.fencingToken,
+        now,
+    };
+}
+//# sourceMappingURL=SyncEffectWorkerRouting.js.map

package/dist/application/sync/outbound/effects/SyncEffectWorkerRouting.js.map

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

package/dist/application/sync/outbound/effects/SyncEffectWorkerTiming.d.ts

@@ -0,0 +1,17 @@
+/** Timing classification and diagnostics emission for one effect-worker pass. */
+import type { PendingEffect } from "../../../../infrastructure/storage/index.js";
+import type { SyncGatewayEffect } from "../../gateway/syncGateway.js";
+import { type SyncGatewayTiming, type SyncTimingEvent, type SyncTimingOperationCounts, type SyncTimingOperationKind } from "../../telemetry/syncTiming.js";
+import type { ClaimedEffect, SyncEffectWorkerBaseOptions } from "./SyncEffectWorker.js";
+export declare function emptyOperationCounts(): SyncTimingOperationCounts;
+export declare function timingOperationKindForEffect(effect: SyncGatewayEffect): SyncTimingOperationKind;
+export declare function timingOperationKindForPending(effect: PendingEffect): SyncTimingOperationKind;
+export declare function countsForOperationKinds(kinds: readonly SyncTimingOperationKind[]): SyncTimingOperationCounts;
+export declare function countsForItems(items: readonly ClaimedEffect[]): SyncTimingOperationCounts;
+export declare function operationKindsForItems(items: readonly ClaimedEffect[]): readonly SyncTimingOperationKind[];
+export declare function countsForPendingEffects(effects: readonly PendingEffect[]): SyncTimingOperationCounts;
+export declare function operationKindsForPendingEffects(effects: readonly PendingEffect[]): readonly SyncTimingOperationKind[];
+export declare function operationKindsForCounts(counts: SyncTimingOperationCounts): readonly SyncTimingOperationKind[];
+export declare function emitGatewayTiming(options: SyncEffectWorkerBaseOptions, timing: SyncGatewayTiming | undefined): void;
+export declare function emitWorkerTiming(options: SyncEffectWorkerBaseOptions, event: SyncTimingEvent): void;
+//# sourceMappingURL=SyncEffectWorkerTiming.d.ts.map

package/dist/application/sync/outbound/effects/SyncEffectWorkerTiming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SyncEffectWorkerTiming.d.ts","sourceRoot":"","sources":["../../../../../src/application/sync/outbound/effects/SyncEffectWorkerTiming.ts"],"names":[],"mappings":"AAAA,iFAAiF;AAGjF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AACjF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC7B,MAAM,+BAA+B,CAAC;AAGvC,OAAO,KAAK,EACV,aAAa,EACb,2BAA2B,EAC5B,MAAM,uBAAuB,CAAC;AAE/B,wBAAgB,oBAAoB,IAAI,yBAAyB,CAEhE;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,iBAAiB,GAAG,uBAAuB,CAe/F;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,aAAa,GAAG,uBAAuB,CAc5F;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,SAAS,uBAAuB,EAAE,GACxC,yBAAyB,CAM3B;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,GAAG,yBAAyB,CAIzF;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,GAAG,SAAS,uBAAuB,EAAE,CAE1G;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,GAAG,yBAAyB,CAEpG;AAED,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,SAAS,aAAa,EAAE,GAChC,SAAS,uBAAuB,EAAE,CAEpC;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,yBAAyB,GAChC,SAAS,uBAAuB,EAAE,CAMpC;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,2BAA2B,EACpC,MAAM,EAAE,iBAAiB,GAAG,SAAS,GACpC,IAAI,CAWN;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,2BAA2B,EACpC,KAAK,EAAE,eAAe,GACrB,IAAI,CAMN"}

package/dist/application/sync/outbound/effects/SyncEffectWorkerTiming.js

@@ -0,0 +1,80 @@
+/** Timing classification and diagnostics emission for one effect-worker pass. */
+import { NON_NEGATIVE_SAFE_INTEGER_MINIMUM } from "../../../../domain/index.js";
+import { SYNC_TIMING_OPERATION_KINDS, SYNC_TIMING_SCOPES, } from "../../telemetry/syncTiming.js";
+import { SYNC_EFFECT_KINDS } from "./SyncEffectWorkerConstants.js";
+import { isPresent } from "./SyncEffectWorkerHelpers.js";
+export function emptyOperationCounts() {
+    return { append: 0, update: 0, delete: 0 };
+}
+export function timingOperationKindForEffect(effect) {
+    if (effect.effectKind === SYNC_EFFECT_KINDS.RESOLUTION_DELETE ||
+        effect.effectKind === SYNC_EFFECT_KINDS.USER_INPUT_DELETE) {
+        return SYNC_TIMING_OPERATION_KINDS.DELETE;
+    }
+    if (effect.payload.createIfMissing &&
+        effect.expectedVisibleRevision === NON_NEGATIVE_SAFE_INTEGER_MINIMUM &&
+        effect.expectedVisibleHash === "") {
+        return SYNC_TIMING_OPERATION_KINDS.APPEND;
+    }
+    return SYNC_TIMING_OPERATION_KINDS.UPDATE;
+}
+export function timingOperationKindForPending(effect) {
+    if (effect.effect_kind === SYNC_EFFECT_KINDS.RESOLUTION_DELETE ||
+        effect.effect_kind === SYNC_EFFECT_KINDS.USER_INPUT_DELETE) {
+        return SYNC_TIMING_OPERATION_KINDS.DELETE;
+    }
+    if (effect.expected_visible_revision === NON_NEGATIVE_SAFE_INTEGER_MINIMUM &&
+        effect.expected_visible_hash === "") {
+        return SYNC_TIMING_OPERATION_KINDS.APPEND;
+    }
+    return SYNC_TIMING_OPERATION_KINDS.UPDATE;
+}
+export function countsForOperationKinds(kinds) {
+    return {
+        append: kinds.filter((kind) => kind === SYNC_TIMING_OPERATION_KINDS.APPEND).length,
+        update: kinds.filter((kind) => kind === SYNC_TIMING_OPERATION_KINDS.UPDATE).length,
+        delete: kinds.filter((kind) => kind === SYNC_TIMING_OPERATION_KINDS.DELETE).length,
+    };
+}
+export function countsForItems(items) {
+    const kinds = items.flatMap((item) => isPresent(item.gatewayEffect) ? [timingOperationKindForEffect(item.gatewayEffect.value)] : []);
+    return countsForOperationKinds(kinds);
+}
+export function operationKindsForItems(items) {
+    return operationKindsForCounts(countsForItems(items));
+}
+export function countsForPendingEffects(effects) {
+    return countsForOperationKinds(effects.map(timingOperationKindForPending));
+}
+export function operationKindsForPendingEffects(effects) {
+    return operationKindsForCounts(countsForPendingEffects(effects));
+}
+export function operationKindsForCounts(counts) {
+    return [
+        ...(counts.append > 0 ? [SYNC_TIMING_OPERATION_KINDS.APPEND] : []),
+        ...(counts.update > 0 ? [SYNC_TIMING_OPERATION_KINDS.UPDATE] : []),
+        ...(counts.delete > 0 ? [SYNC_TIMING_OPERATION_KINDS.DELETE] : []),
+    ];
+}
+export function emitGatewayTiming(options, timing) {
+    if (timing === undefined)
+        return;
+    for (const phase of timing.phases) {
+        emitWorkerTiming(options, {
+            scope: SYNC_TIMING_SCOPES.GATEWAY,
+            phase: phase.phase,
+            durationMs: phase.durationMs,
+            operationKinds: timing.operationKinds,
+            operationCounts: timing.operationCounts,
+        });
+    }
+}
+export function emitWorkerTiming(options, event) {
+    try {
+        options.onTiming?.(event);
+    }
+    catch {
+        // Diagnostics must never change worker state transitions.
+    }
+}
+//# sourceMappingURL=SyncEffectWorkerTiming.js.map

package/dist/application/sync/outbound/effects/SyncEffectWorkerTiming.js.map

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

package/dist/application/sync/outbound/effects/SyncEffectWorkerTransitions.d.ts

@@ -0,0 +1,13 @@
+/** Durable result transitions for gateway responses and response-loss recovery. */
+import type { FencingContext } from "../../../../infrastructure/storage/sync/shared/writerLease.js";
+import type { Presence } from "../../../../shared/state/types.js";
+import type { SyncEffectPostcondition, SyncGatewayEffectResult } from "../../gateway/syncGateway.js";
+import { type SyncEffectWorkerErrorCode } from "./SyncEffectWorkerConstants.js";
+import type { ClaimedEffect, EffectWorkerStorage, MutableReport, RepairReplanRequest, SyncEffectWorkerBaseOptions, SyncEffectWorkerFullOptions } from "./SyncEffectWorker.js";
+export declare function completeGatewayResult(options: SyncEffectWorkerBaseOptions, storage: EffectWorkerStorage, fence: FencingContext, item: ClaimedEffect, result: SyncGatewayEffectResult, report: MutableReport): Promise<void>;
+export declare function recoverUnknownResults(options: SyncEffectWorkerFullOptions, storage: EffectWorkerStorage, fence: FencingContext, items: readonly ClaimedEffect[], report: MutableReport): Promise<void>;
+export declare function settleUnknownPostcondition(options: SyncEffectWorkerBaseOptions, storage: EffectWorkerStorage, fence: FencingContext, item: ClaimedEffect, postcondition: SyncEffectPostcondition, report: MutableReport): Promise<void>;
+export declare function completeApplied(storage: EffectWorkerStorage, fence: FencingContext, item: ClaimedEffect, visibleRevision: Presence<number>, visibleHash: Presence<string>, report: MutableReport): Promise<void>;
+export declare function replanOrFail(options: SyncEffectWorkerBaseOptions, storage: EffectWorkerStorage, fence: FencingContext, item: ClaimedEffect, request: RepairReplanRequest, report: MutableReport): Promise<void>;
+export declare function completeFailure(storage: EffectWorkerStorage, fence: FencingContext, item: ClaimedEffect, code: SyncEffectWorkerErrorCode, message: Presence<string>, report: MutableReport): Promise<void>;
+//# sourceMappingURL=SyncEffectWorkerTransitions.d.ts.map

package/dist/application/sync/outbound/effects/SyncEffectWorkerTransitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SyncEffectWorkerTransitions.d.ts","sourceRoot":"","sources":["../../../../../src/application/sync/outbound/effects/SyncEffectWorkerTransitions.ts"],"names":[],"mappings":"AAAA,mFAAmF;AAInF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+DAA+D,CAAC;AAIpG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAKlE,OAAO,KAAK,EACV,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAIL,KAAK,yBAAyB,EAC/B,MAAM,gCAAgC,CAAC;AAaxC,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,mBAAmB,EACnB,2BAA2B,EAC3B,2BAA2B,EAC5B,MAAM,uBAAuB,CAAC;AAE/B,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,2BAA2B,EACpC,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,uBAAuB,EAC/B,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,IAAI,CAAC,CAoEf;AAED,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,2BAA2B,EACpC,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,SAAS,aAAa,EAAE,EAC/B,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,IAAI,CAAC,CAgEf;AAED,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,2BAA2B,EACpC,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,aAAa,EACnB,aAAa,EAAE,uBAAuB,EACtC,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,IAAI,CAAC,CAoFf;AAED,wBAAsB,eAAe,CACnC,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,aAAa,EACnB,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,EACjC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,EAC7B,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,2BAA2B,EACpC,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,mBAAmB,EAC5B,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,IAAI,CAAC,CAkDf;AAED,wBAAsB,eAAe,CACnC,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,aAAa,EACnB,IAAI,EAAE,yBAAyB,EAC/B,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,EACzB,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,IAAI,CAAC,CASf"}

package/dist/application/sync/outbound/effects/SyncEffectWorkerTransitions.js

@@ -0,0 +1,205 @@
+/** Durable result transitions for gateway responses and response-loss recovery. */
+import { stableHash } from "../../../../domain/index.js";
+import { LOOKUP_RESULT_KINDS, } from "../../../../shared/state/constants.js";
+import { SYNC_GATEWAY_EFFECT_RESULT_STATUSES, SYNC_GATEWAY_POSTCONDITION_DISPOSITIONS, } from "../../gateway/constants.js";
+import { OUTBOX_EFFECT_STATUSES, SYNC_EFFECT_KINDS, WORKER_ERROR_CODES, } from "./SyncEffectWorkerConstants.js";
+import { absentValue, applicabilityFromSqlNullable, isPresent, lookupResult, presentValue, safeErrorMessage, } from "./SyncEffectWorkerHelpers.js";
+import { groupByGatewayPostconditionRequest, isCandidateProtectingUserInputEffect, } from "./SyncEffectWorkerRouting.js";
+export async function completeGatewayResult(options, storage, fence, item, result, report) {
+    if (result.status === SYNC_GATEWAY_EFFECT_RESULT_STATUSES.APPLIED ||
+        result.status === SYNC_GATEWAY_EFFECT_RESULT_STATUSES.ALREADY_APPLIED) {
+        await completeApplied(storage, fence, item, result.visibleRevision, result.visibleHash, report);
+        return;
+    }
+    if (result.status === SYNC_GATEWAY_EFFECT_RESULT_STATUSES.SUPERSEDED) {
+        if (await storage.applyEffectResult({
+            ...fence,
+            effectId: item.pending.effect_id,
+            claimToken: item.claimToken,
+            status: OUTBOX_EFFECT_STATUSES.SUPERSEDED,
+            lastErrorCode: presentValue(WORKER_ERROR_CODES.GATEWAY_SUPERSEDED),
+            lastErrorMessage: result.reason,
+        }))
+            report.superseded += 1;
+        return;
+    }
+    if (result.status === SYNC_GATEWAY_EFFECT_RESULT_STATUSES.GUARD_MISMATCH) {
+        const blocked = isPresent(item.gatewayEffect) &&
+            isCandidateProtectingUserInputEffect(item.gatewayEffect.value);
+        const status = blocked
+            ? OUTBOX_EFFECT_STATUSES.BLOCKED_CANDIDATE
+            : OUTBOX_EFFECT_STATUSES.CONFLICT;
+        const applied = await storage.applyEffectResult({
+            ...fence,
+            effectId: item.pending.effect_id,
+            claimToken: item.claimToken,
+            status,
+            lastErrorCode: presentValue(blocked
+                ? WORKER_ERROR_CODES.CANDIDATE_GUARD_MISMATCH
+                : WORKER_ERROR_CODES.VISIBLE_GUARD_MISMATCH),
+            lastErrorMessage: result.reason,
+        });
+        if (applied) {
+            if (blocked)
+                report.blockedCandidate += 1;
+            else
+                report.conflicted += 1;
+        }
+        return;
+    }
+    if (result.status === SYNC_GATEWAY_EFFECT_RESULT_STATUSES.REPAIR_REOBSERVE) {
+        await replanOrFail(options, storage, fence, item, {
+            effect: item.pending,
+            gatewayResult: presentValue(result),
+            postcondition: absentValue(),
+        }, report);
+        return;
+    }
+    await completeFailure(storage, fence, item, result.status === SYNC_GATEWAY_EFFECT_RESULT_STATUSES.SCHEMA_ERROR
+        ? WORKER_ERROR_CODES.GATEWAY_SCHEMA_ERROR
+        : WORKER_ERROR_CODES.GATEWAY_RETRYABLE_ERROR, result.reason, report);
+}
+export async function recoverUnknownResults(options, storage, fence, items, report) {
+    const usable = [];
+    for (const item of items) {
+        if (isPresent(item.gatewayEffect)) {
+            usable.push(item);
+            continue;
+        }
+        await completeFailure(storage, fence, item, WORKER_ERROR_CODES.INVALID_EFFECT_PAYLOAD, item.invalidPayloadError, report);
+    }
+    for (const group of groupByGatewayPostconditionRequest(usable)) {
+        let results;
+        try {
+            results = await options.gateway.readEffectPostconditions(group.request);
+        }
+        catch (error) {
+            for (const item of group.items) {
+                await completeFailure(storage, fence, item, WORKER_ERROR_CODES.POSTCONDITION_READ_FAILED, presentValue(safeErrorMessage(error)), report);
+            }
+            continue;
+        }
+        const byEffectId = new Map(results.map((result) => [result.effectId, result]));
+        for (const item of group.items) {
+            const result = lookupResult(byEffectId.get(item.pending.effect_id));
+            if (result.kind === LOOKUP_RESULT_KINDS.NOT_FOUND ||
+                result.value.payloadHash !== item.pending.payload_hash) {
+                await completeFailure(storage, fence, item, WORKER_ERROR_CODES.POSTCONDITION_READ_FAILED, presentValue("Gateway postcondition batch did not return the expected effect evidence."), report);
+                continue;
+            }
+            await settleUnknownPostcondition(options, storage, fence, item, result.value.postcondition, report);
+        }
+    }
+}
+export async function settleUnknownPostcondition(options, storage, fence, item, postcondition, report) {
+    if (!isPresent(item.gatewayEffect)) {
+        await completeFailure(storage, fence, item, WORKER_ERROR_CODES.INVALID_EFFECT_PAYLOAD, item.invalidPayloadError, report);
+        return;
+    }
+    if (postcondition.disposition === SYNC_GATEWAY_POSTCONDITION_DISPOSITIONS.APPLIED &&
+        isPresent(postcondition.visibleRevision) &&
+        isPresent(postcondition.visibleHash)) {
+        await completeApplied(storage, fence, item, postcondition.visibleRevision, postcondition.visibleHash, report);
+        report.responseLossRecovered += 1;
+        return;
+    }
+    if (postcondition.disposition === SYNC_GATEWAY_POSTCONDITION_DISPOSITIONS.APPLIED) {
+        await completeFailure(storage, fence, item, WORKER_ERROR_CODES.POSTCONDITION_APPLIED_WITHOUT_VISIBLE_STATE, presentValue("Gateway claimed an applied postcondition without a verified visible revision and hash."), report);
+        return;
+    }
+    if (postcondition.disposition === SYNC_GATEWAY_POSTCONDITION_DISPOSITIONS.CHANGED &&
+        item.gatewayEffect.value.effectKind === SYNC_EFFECT_KINDS.SYSTEM_REPAIR) {
+        await replanOrFail(options, storage, fence, item, {
+            effect: item.pending,
+            gatewayResult: absentValue(),
+            postcondition: presentValue(postcondition),
+        }, report);
+        return;
+    }
+    if (postcondition.disposition === SYNC_GATEWAY_POSTCONDITION_DISPOSITIONS.UNAPPLIED) {
+        const requeued = await storage.retryClaimedEffect({
+            ...fence,
+            effectId: item.pending.effect_id,
+            claimToken: item.claimToken,
+            lastErrorCode: WORKER_ERROR_CODES.POSTCONDITION_UNAPPLIED_REQUIRES_REDRIVE,
+            lastErrorMessage: "Gateway did not expose the effect as applied; it was returned to pending.",
+        });
+        if (requeued) {
+            report.deferred += 1;
+            report.requeued += 1;
+        }
+        return;
+    }
+    const code = postcondition.disposition === SYNC_GATEWAY_POSTCONDITION_DISPOSITIONS.UNAVAILABLE
+        ? WORKER_ERROR_CODES.POSTCONDITION_UNAVAILABLE
+        : postcondition.disposition === SYNC_GATEWAY_POSTCONDITION_DISPOSITIONS.CHANGED
+            ? WORKER_ERROR_CODES.POSTCONDITION_CHANGED
+            : WORKER_ERROR_CODES.POSTCONDITION_UNAPPLIED_REQUIRES_REDRIVE;
+    await completeFailure(storage, fence, item, code, presentValue("Gateway response was not observed; postcondition=" + postcondition.disposition), report);
+}
+export async function completeApplied(storage, fence, item, visibleRevision, visibleHash, report) {
+    const gatewayEffect = item.gatewayEffect;
+    const confirmation = isPresent(gatewayEffect) &&
+        isPresent(gatewayEffect.value.rowBindingId) &&
+        isPresent(visibleRevision) &&
+        isPresent(visibleHash)
+        ? {
+            physicalSheetId: item.pending.physical_sheet_id,
+            projection: item.pending.projection,
+            rowBindingId: gatewayEffect.value.rowBindingId.value,
+            visibleRevision: visibleRevision.value,
+            visibleHash: visibleHash.value,
+            entityRevision: applicabilityFromSqlNullable(item.pending.target_entity_revision),
+            fieldHashes: Object.fromEntries(Object.entries(gatewayEffect.value.payload.fields)
+                .map(([fieldName, value]) => [fieldName, stableHash(value)])),
+        }
+        : undefined;
+    const applied = await storage.applyEffectResult({
+        ...fence,
+        effectId: item.pending.effect_id,
+        claimToken: item.claimToken,
+        status: OUTBOX_EFFECT_STATUSES.APPLIED,
+        lastErrorCode: absentValue(),
+        lastErrorMessage: absentValue(),
+        ...(confirmation === undefined ? {} : { projectionConfirmation: confirmation }),
+    });
+    if (applied)
+        report.applied += 1;
+}
+export async function replanOrFail(options, storage, fence, item, request, report) {
+    if (options.makeRepairReplan === undefined) {
+        await completeFailure(storage, fence, item, WORKER_ERROR_CODES.REPAIR_REOBSERVE_REQUIRES_WRITER_REPLAN, presentValue("A system repair changed remotely and no writer replan factory was configured."), report);
+        return;
+    }
+    let replacement;
+    try {
+        replacement = options.makeRepairReplan(request);
+    }
+    catch (error) {
+        await completeFailure(storage, fence, item, WORKER_ERROR_CODES.REPAIR_REPLAN_FAILED, presentValue(safeErrorMessage(error)), report);
+        return;
+    }
+    if (!isPresent(replacement)) {
+        await completeFailure(storage, fence, item, WORKER_ERROR_CODES.REPAIR_REPLAN_DEFERRED, presentValue("Writer deferred repair replan pending a fresh observation."), report);
+        return;
+    }
+    try {
+        await storage.supersedeAndReplan(fence, item.pending.effect_id, replacement.value);
+        report.replanned += 1;
+    }
+    catch (error) {
+        await completeFailure(storage, fence, item, WORKER_ERROR_CODES.REPAIR_REPLAN_FAILED, presentValue(safeErrorMessage(error)), report);
+    }
+}
+export async function completeFailure(storage, fence, item, code, message, report) {
+    if (await storage.applyEffectResult({
+        ...fence,
+        effectId: item.pending.effect_id,
+        claimToken: item.claimToken,
+        status: OUTBOX_EFFECT_STATUSES.FAILED,
+        lastErrorCode: presentValue(code),
+        lastErrorMessage: message,
+    }))
+        report.failed += 1;
+}
+//# sourceMappingURL=SyncEffectWorkerTransitions.js.map