hikoutei 0.4.2 → 0.4.5

package/dist/application/sync/outbound/SheetsEffectDispatcher.js

@@ -0,0 +1,440 @@
+/**
+ * Sheets dispatcher: the host implementation of the package worker's
+ * `Dispatcher` boundary over the Google Sheets sync provider.
+ *
+ * The worker owns selection, claiming, grouping, lease refresh, transitions,
+ * and recovery. This dispatcher owns every payload-derived decision: route
+ * keys, fast-append candidacy, payload validation, the User_Input candidate
+ * gate (via the active-candidate guard SQL), remote evidence validation
+ * against effect targets, and transport-outcome classification.
+ */
+import { NON_NEGATIVE_SAFE_INTEGER_MINIMUM, } from "../../../domain/index.js";
+import { DispatchTransportError, } from "@hikoutei/outbox";
+import { CONFLICT_STATUSES, EFFECT_KINDS, EFFECT_TARGET_KINDS, } from "../../../domain/model/constants.js";
+import { absentValue, presentValue, } from "../../../shared/state/index.js";
+import { stableHash } from "../../../shared/encoding/stableEncode.js";
+import { hasActiveUserInputCandidateWithSql, } from "../../../infrastructure/storage/sync/outbound/effectWorkerSql.js";
+import { ensureSpreadsheetAuthorityWithAdapter, } from "../../../infrastructure/storage/sync/shared/spreadsheetAuthority.js";
+import { parseSyncProjectionEffectPayload, } from "../sheets/syncSheets.js";
+import { SYNC_EFFECT_RESULT_STATUSES, SYNC_FAST_APPEND_STATUSES, SYNC_POSTCONDITION_DISPOSITIONS, SYNC_POSTCONDITION_MODES, SYNC_POSTCONDITION_STATUSES, SYNC_PROJECTIONS, } from "../sheets/constants.js";
+import { classifyTransportOutcome, TRANSPORT_OUTCOME_KINDS, } from "../sheets/transportOutcome.js";
+import { fromSqlNullable } from "../../../infrastructure/storage/sqlite/sqlState.js";
+/**
+ * Builds the stable grouping key shared by all provider operations on one
+ * route. The route includes payload-derived tab/range/schema fields, so one
+ * dispatched group always maps to exactly one provider request.
+ */
+export function sheetsRouteKeyFor(effect) {
+    const payload = parseSyncProjectionEffectPayload(effect.payload_json);
+    return [
+        effect.physical_sheet_id,
+        payload.sheetName,
+        payload.registeredRange,
+        effect.projection,
+        payload.schemaVersion,
+    ].join("\u0000");
+}
+/** Validates the opaque payload of one pending effect for the worker. */
+export function sheetsPayloadValidationError(effect) {
+    try {
+        toProviderEffect(effect);
+        return absentValue();
+    }
+    catch (error) {
+        return presentValue(safeProviderErrorMessage(error));
+    }
+}
+/**
+ * Classifies one pending effect as an append-only fast candidate.
+ *
+ * A fast append requires an empty visible baseline (`createIfMissing` with
+ * revision 0 and an empty visible hash) plus a new System_State entity row or
+ * a new Sync_Conflicts resolution row.
+ */
+export function isSheetsFastAppendCandidate(effect) {
+    try {
+        return isFastAppendEffect(toProviderEffect(effect));
+    }
+    catch {
+        return false;
+    }
+}
+/** Classifies one converted provider effect as an append-only fast candidate. */
+export function isFastAppendEffect(effect) {
+    const emptyVisibleBaseline = effect.payload.createIfMissing &&
+        effect.expectedVisibleRevision === NON_NEGATIVE_SAFE_INTEGER_MINIMUM &&
+        effect.expectedVisibleHash === "";
+    if (!emptyVisibleBaseline)
+        return false;
+    return (effect.effectKind === EFFECT_KINDS.SYSTEM_PROJECTION &&
+        effect.projection === SYNC_PROJECTIONS.SYSTEM_STATE &&
+        effect.targetKind === EFFECT_TARGET_KINDS.ENTITY) || (effect.effectKind === EFFECT_KINDS.RESOLUTION_PROJECTION &&
+        effect.projection === SYNC_PROJECTIONS.SYNC_CONFLICTS &&
+        effect.targetKind === EFFECT_TARGET_KINDS.CONFLICT);
+}
+/**
+ * Dispatcher over a `SyncEffectWorkerProvider` and the host storage adapter.
+ *
+ * The storage adapter backs the candidate gate and the dispatch authority
+ * claim; both are optional host extensions the worker may skip.
+ */
+export class SheetsEffectDispatcher {
+    provider;
+    storage;
+    constructor(options) {
+        this.provider = options.provider;
+        this.storage = options.storage;
+    }
+    routeKeyFor(effect) {
+        return sheetsRouteKeyFor(effect);
+    }
+    isFastAppendCandidate(effect) {
+        return isSheetsFastAppendCandidate(effect);
+    }
+    payloadValidationError(effect) {
+        return sheetsPayloadValidationError(effect);
+    }
+    /** Dispatches append-only rows through the idempotent provider batch operation. */
+    async fastAppend(request) {
+        const providerRequest = buildFastAppendRowsRequest(request.effects);
+        let response;
+        try {
+            response = await this.provider.fastAppendRows(providerRequest);
+        }
+        catch (error) {
+            throw toDispatchTransportError(error);
+        }
+        const byEffect = new Map(request.effects.map((effect) => [effect.effect_id, effect]));
+        const results = [];
+        for (const result of response.results) {
+            const pending = byEffect.get(result.effectId);
+            if (pending === undefined)
+                continue;
+            const effect = toProviderEffect(pending);
+            const evidence = receiptEvidence(result);
+            if (evidence === undefined) {
+                results.push({
+                    effectId: result.effectId,
+                    status: "delivery_uncertain",
+                    reason: presentValue("Fast append did not return receipt-backed visible evidence."),
+                });
+                continue;
+            }
+            if (evidence.visibleHash !== effect.payload.targetVisibleHash) {
+                // The append receipt did not match the effect target: the remote row
+                // does not carry the acknowledged state, so the worker closes the
+                // effect as failed rather than trusting the receipt.
+                results.push({ effectId: result.effectId, status: "applied_target_mismatch" });
+                continue;
+            }
+            results.push({
+                effectId: result.effectId,
+                status: "applied",
+                visibleRevision: evidence.visibleRevision,
+                visibleHash: evidence.visibleHash,
+                fieldHashes: fieldHashesFor(effect),
+            });
+        }
+        return { results, hasMore: response.hasMore, ...(response.timing === undefined ? {} : { timing: response.timing }) };
+    }
+    /** Dispatches one regular effect batch through the provider. */
+    async apply(request) {
+        const effects = request.effects.map((pending) => toProviderEffect(pending));
+        const providerRequest = {
+            physicalSheetId: effects[0].physicalSheetId,
+            sheetName: effects[0].payload.sheetName,
+            registeredRange: effects[0].payload.registeredRange,
+            projection: effects[0].projection,
+            schemaVersion: effects[0].payload.schemaVersion,
+            postconditionMode: SYNC_POSTCONDITION_MODES.DEFERRED,
+            effects,
+        };
+        let response;
+        try {
+            response = await this.provider.applyEffects(providerRequest);
+        }
+        catch (error) {
+            throw toDispatchTransportError(error);
+        }
+        const byEffect = new Map(effects.map((effect) => [effect.effectId, effect]));
+        const results = [];
+        for (const result of response.results) {
+            results.push(translateApplyResult(result, byEffect.get(result.effectId)));
+        }
+        return { results, hasMore: response.hasMore, ...(response.timing === undefined ? {} : { timing: response.timing }) };
+    }
+    /** Reads back response-loss effects so the worker can settle them safely. */
+    async readPostconditions(request) {
+        const effects = request.effects.map((pending) => toProviderEffect(pending));
+        const providerRequest = {
+            physicalSheetId: effects[0].physicalSheetId,
+            sheetName: effects[0].payload.sheetName,
+            registeredRange: effects[0].payload.registeredRange,
+            projection: effects[0].projection,
+            schemaVersion: effects[0].payload.schemaVersion,
+            effects,
+        };
+        let response;
+        try {
+            response = await this.provider.readEffectPostconditions(providerRequest);
+        }
+        catch (error) {
+            throw toDispatchTransportError(error);
+        }
+        const byEffect = new Map(effects.map((effect) => [effect.effectId, effect]));
+        const results = response.map((result) => ({
+            effectId: result.effectId,
+            payloadHash: result.payloadHash,
+            postcondition: translatePostcondition(result.postcondition, byEffect.get(result.effectId)),
+        }));
+        return { results };
+    }
+    /**
+     * Preserves active User_Input candidates before remote dispatch: reconcile
+     * or delete effects that would overwrite a candidate-owned field are
+     * blocked locally before any remote compare-and-set runs.
+     */
+    async gate(items) {
+        const allowed = [];
+        const blocked = [];
+        for (const item of items) {
+            let effect;
+            try {
+                effect = toProviderEffect(item.pending);
+            }
+            catch {
+                allowed.push(item.pending.effect_id);
+                continue;
+            }
+            if (!isCandidateProtectingUserInputEffect(effect)) {
+                allowed.push(item.pending.effect_id);
+                continue;
+            }
+            const rowBinding = effect.rowBindingId;
+            if (rowBinding.kind !== "present") {
+                allowed.push(item.pending.effect_id);
+                continue;
+            }
+            const fieldNames = Object.keys(effect.payload.fields);
+            const blockedByCandidate = await this.storage.read(({ sql }) => hasActiveUserInputCandidateWithSql(sql, {
+                physicalSheetId: effect.physicalSheetId,
+                projection: SYNC_PROJECTIONS.USER_INPUT,
+                rowBindingId: rowBinding.value,
+                fieldNames,
+                openConflictStatus: CONFLICT_STATUSES.OPEN,
+                rebasedConflictStatus: CONFLICT_STATUSES.NEEDS_REBASE,
+            }));
+            if (blockedByCandidate)
+                blocked.push(item.pending.effect_id);
+            else
+                allowed.push(item.pending.effect_id);
+        }
+        return { allowed, blocked };
+    }
+    /** Refreshes the dispatch authority claim for one physical sheet. */
+    async ensureAuthority(fence, physicalSheetId, ownerId) {
+        const result = await ensureSpreadsheetAuthorityWithAdapter(this.storage, {
+            ...fence,
+            physicalSheetId,
+            ownerId,
+        });
+        return result.kind === "claimed";
+    }
+}
+function buildFastAppendRowsRequest(effects) {
+    const converted = effects.map((pending) => toProviderEffect(pending));
+    const first = converted[0];
+    return {
+        physicalSheetId: first.physicalSheetId,
+        sheetName: first.payload.sheetName,
+        registeredRange: first.payload.registeredRange,
+        projection: first.projection,
+        schemaVersion: first.payload.schemaVersion,
+        rows: converted.map((effect) => ({
+            effectId: effect.effectId,
+            payloadHash: effect.payloadHash,
+            anchor: effect.payload.targetAnchor,
+            fields: effect.payload.fields,
+        })),
+    };
+}
+function translateApplyResult(result, effect) {
+    const base = {
+        effectId: result.effectId,
+        payloadHash: result.payloadHash,
+    };
+    if ((result.status === SYNC_EFFECT_RESULT_STATUSES.APPLIED ||
+        result.status === SYNC_EFFECT_RESULT_STATUSES.ALREADY_APPLIED)) {
+        const evidence = verifiedSuccessEvidence(result, effect);
+        if (evidence !== undefined) {
+            return {
+                ...base,
+                status: result.status,
+                visibleRevision: evidence.visibleRevision,
+                visibleHash: evidence.visibleHash,
+                fieldHashes: evidence.fieldHashes,
+            };
+        }
+        // A success label without the acknowledged target state is not enough to
+        // close a durable effect; the worker treats it like a lost response and
+        // reads back first.
+        return {
+            ...base,
+            status: "delivery_uncertain",
+            reason: presentValue("Provider applied result did not include receipt-backed visible evidence."),
+        };
+    }
+    if (result.status === SYNC_EFFECT_RESULT_STATUSES.SUPERSEDED) {
+        return { ...base, status: "superseded", reason: result.reason };
+    }
+    if (result.status === SYNC_EFFECT_RESULT_STATUSES.GUARD_MISMATCH) {
+        return { ...base, status: "guard_mismatch", reason: result.reason };
+    }
+    if (result.status === SYNC_EFFECT_RESULT_STATUSES.REPAIR_REOBSERVE) {
+        return { ...base, status: "repair_reobserve", reason: result.reason };
+    }
+    return {
+        ...base,
+        status: result.status === SYNC_EFFECT_RESULT_STATUSES.SCHEMA_ERROR
+            ? "schema_error"
+            : "retryable_error",
+        reason: result.reason,
+    };
+}
+function translatePostcondition(postcondition, effect) {
+    if (postcondition.disposition === SYNC_POSTCONDITION_DISPOSITIONS.APPLIED &&
+        postcondition.visibleRevision.kind === "present" &&
+        postcondition.visibleHash.kind === "present" &&
+        effect !== undefined &&
+        postcondition.visibleHash.value === effect.payload.targetVisibleHash) {
+        return {
+            disposition: "applied",
+            visibleRevision: postcondition.visibleRevision.value,
+            visibleHash: postcondition.visibleHash.value,
+            fieldHashes: fieldHashesFor(effect),
+        };
+    }
+    if (postcondition.disposition === SYNC_POSTCONDITION_DISPOSITIONS.APPLIED) {
+        if (effect !== undefined &&
+            postcondition.visibleRevision.kind === "present" &&
+            postcondition.visibleHash.kind === "present") {
+            return { disposition: "applied_target_mismatch" };
+        }
+        return { disposition: "applied_without_visible_state" };
+    }
+    if (postcondition.disposition === SYNC_POSTCONDITION_DISPOSITIONS.CHANGED) {
+        return {
+            disposition: "changed",
+            ...(postcondition.reason === undefined ? {} : { reason: postcondition.reason }),
+        };
+    }
+    if (postcondition.disposition === SYNC_POSTCONDITION_DISPOSITIONS.UNAPPLIED) {
+        return {
+            disposition: "unapplied",
+            ...(postcondition.reason === undefined ? {} : { reason: postcondition.reason }),
+        };
+    }
+    return {
+        disposition: "unavailable",
+        ...(postcondition.reason === undefined ? {} : { reason: postcondition.reason }),
+    };
+}
+/**
+ * Returns verified success evidence only when the provider's success label
+ * carries the acknowledged target state: a verified/acknowledged postcondition
+ * plus a visible revision and hash that match the effect target.
+ */
+function verifiedSuccessEvidence(result, effect) {
+    if (result.postcondition !== SYNC_POSTCONDITION_STATUSES.VERIFIED &&
+        result.postcondition !== SYNC_POSTCONDITION_STATUSES.ACKNOWLEDGED) {
+        return undefined;
+    }
+    if (result.visibleRevision.kind !== "present" ||
+        result.visibleHash.kind !== "present") {
+        return undefined;
+    }
+    if (effect === undefined ||
+        result.visibleHash.value !== effect.payload.targetVisibleHash) {
+        return undefined;
+    }
+    return {
+        visibleRevision: result.visibleRevision.value,
+        visibleHash: result.visibleHash.value,
+        fieldHashes: fieldHashesFor(effect),
+    };
+}
+function receiptEvidence(result) {
+    if (result.status !== SYNC_FAST_APPEND_STATUSES.APPLIED ||
+        typeof result.visibleRevision !== "number" ||
+        !Number.isSafeInteger(result.visibleRevision) ||
+        result.visibleRevision < 1 ||
+        typeof result.visibleHash !== "string" ||
+        result.visibleHash.length === 0) {
+        return undefined;
+    }
+    return { visibleRevision: result.visibleRevision, visibleHash: result.visibleHash };
+}
+function fieldHashesFor(effect) {
+    return Object.fromEntries(Object.entries(effect.payload.fields)
+        .map(([fieldName, value]) => [fieldName, stableHash(value)]));
+}
+function isCandidateProtectingUserInputEffect(effect) {
+    return effect.effectKind === EFFECT_KINDS.CANDIDATE_RECONCILE ||
+        effect.effectKind === EFFECT_KINDS.USER_INPUT_DELETE;
+}
+/** Validates and converts one durable outbox row into a provider effect. */
+function toProviderEffect(effect) {
+    if (!isSyncEffectKind(effect.effect_kind)) {
+        throw new Error("unsupported sync effect kind: " + effect.effect_kind);
+    }
+    if (!isSyncProjection(effect.projection)) {
+        throw new Error("unsupported sync projection: " + effect.projection);
+    }
+    if (!isEffectTargetKind(effect.target_kind)) {
+        throw new Error("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),
+    };
+}
+function isSyncEffectKind(value) {
+    return value === EFFECT_KINDS.SYSTEM_PROJECTION ||
+        value === EFFECT_KINDS.CANDIDATE_RECONCILE ||
+        value === EFFECT_KINDS.SYSTEM_REPAIR ||
+        value === EFFECT_KINDS.RESOLUTION_PROJECTION ||
+        value === EFFECT_KINDS.RESOLUTION_DELETE ||
+        value === EFFECT_KINDS.USER_INPUT_DELETE;
+}
+function isSyncProjection(value) {
+    return value === SYNC_PROJECTIONS.USER_INPUT ||
+        value === SYNC_PROJECTIONS.SYSTEM_STATE ||
+        value === SYNC_PROJECTIONS.SYNC_CONFLICTS;
+}
+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;
+}
+function toDispatchTransportError(error) {
+    const outcome = classifyTransportOutcome(error);
+    return new DispatchTransportError(outcome.kind === TRANSPORT_OUTCOME_KINDS.EXPLICIT_REMOTE_FAILURE
+        ? "explicit_remote_failure"
+        : "delivery_uncertain", outcome.message);
+}
+function safeProviderErrorMessage(error) {
+    return error instanceof Error ? error.message.slice(0, 500) : "unknown sync provider failure";
+}
+//# sourceMappingURL=SheetsEffectDispatcher.js.map

package/dist/application/sync/outbound/SheetsEffectDispatcher.js.map

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

package/dist/application/sync/service/SyncServiceBootstrap.d.ts

@@ -18,8 +18,7 @@ import type { SyncSheetsProvisioner, RegisteredSyncProjectionDefinition } from "
 import type { SyncSheetsProvider, SyncSheetsTableReader } from "../sheets/syncSheets.js";
 import type { CoordinatorLaneEvent } from "../sheets/mutationCoordinator/laneTelemetry.js";
 import { type GoogleSheetsApiProviderOptions } from "../../../adapter/sheets/providers/google-sheets-api/index.js";
-import { type SyncEffectWorkerSupervisor } from "../outbound/effects/SyncEffectSupervisor.js";
-import type { SyncEffectWorkerReport } from "../outbound/effects/SyncEffectWorker.js";
+import { type EffectWorkerSupervisor, type WorkerReport } from "@hikoutei/outbox";
 import { type MappedUserInputPollingReport } from "../../../adapter/persistence/providers/mikro-orm/observation/MikroOrmUserInputPolling.js";
 import { SyncPollingSupervisor } from "./SyncPollingSupervisor.js";
 import type { SyncTimingSink } from "../telemetry/syncTiming.js";
@@ -53,7 +52,7 @@ export interface InternalSyncServiceOptions {
     readonly effectLeaseDurationMs?: number;
     readonly effectIdleIntervalMs?: number;
     readonly onTiming?: SyncTimingSink;
-    readonly onEffectReport?: (report: SyncEffectWorkerReport) => void;
+    readonly onEffectReport?: (report: WorkerReport) => void;
     readonly onEffectError?: (error: unknown) => void;
     readonly pollingIntervalMs?: number;
     /** Maximum interval between metadata-preserving safety scans. */
@@ -75,7 +74,7 @@ export interface InternalSyncService {
     readonly projectionDefinitions: readonly RegisteredSyncProjectionDefinition[];
     /** Retries durable OPEN system-wins commands after predecessors settle. */
     readonly retryDeferredConflicts: () => Promise<number>;
-    readonly effectSupervisor: SyncEffectWorkerSupervisor;
+    readonly effectSupervisor: EffectWorkerSupervisor;
     readonly pollingSupervisor: SyncPollingSupervisor<MappedUserInputPollingReport>;
     stop(): Promise<void>;
     close(): Promise<void>;

package/dist/application/sync/service/SyncServiceBootstrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SyncServiceBootstrap.d.ts","sourceRoot":"","sources":["../../../../src/application/sync/service/SyncServiceBootstrap.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"SyncServiceBootstrap.d.ts","sourceRoot":"","sources":["../../../../src/application/sync/service/SyncServiceBootstrap.ts"],"names":[],"mappings":"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"}

package/dist/application/sync/service/SyncServiceBootstrap.js

@@ -14,6 +14,8 @@
 import { randomUUID } from "node:crypto";
 import { createInternalHikoutei, } from "../../../api/Hikoutei.js";
 import { getEntityDescriptor, HikouteiEntity as HikouteiEntityToken } from "../../../api/entity.js";
+import { readWriterLeaseWithAdapter, releaseWriterLeaseWithAdapter, } from "../../../infrastructure/storage/index.js";
+import { DEFAULT_MAPPED_WRITER_ROLE, } from "../../orm/persistence/support/contracts.js";
 import { initializeMappedTypedSheetsRuntime, } from "../../../adapter/persistence/providers/mikro-orm/engine/MikroOrmMappedTypedSheets.js";
 import { createMikroOrmScalarRuntime, } from "../../../adapter/persistence/providers/mikro-orm/engine/MikroOrmScalarRuntime.js";
 import { MikroOrmScalarPersistenceProvider, } from "../../../adapter/persistence/providers/mikro-orm/api/MikroOrmScalarPersistenceProvider.js";
@@ -24,11 +26,11 @@ import { autoResolveExistingMappedConflictsWithAdapter, retryOpenMappedConflicts
 import { CoordinatedSheetsProvider, } from "../sheets/mutationCoordinator/CoordinatedSheetsProvider.js";
 import { GoogleSheetsApiSyncProvider, } from "../../../adapter/sheets/providers/google-sheets-api/index.js";
 import { GOOGLE_SHEETS_API_DEFAULTS } from "../../../adapter/sheets/providers/google-sheets-api/constants.js";
-import { createSyncEffectWorkerSupervisor, } from "../outbound/effects/SyncEffectSupervisor.js";
+import { createEffectWorkerSupervisor, APPEND_DISPATCH_THROTTLE_INTERVAL_MS, DEFAULT_EFFECT_LEASE_DURATION_MS, DEFAULT_WORKER_ROLE, DEFAULT_WRITER_LEASE_DURATION_MS, EFFECT_LEASE_PROVIDER_HEADROOM_MS, FAST_APPEND_BATCH_CANDIDATE_LIMIT, LOOKUP_RESULT_KINDS, safeErrorMessage, } from "@hikoutei/outbox";
+import { SheetsEffectDispatcher } from "../outbound/SheetsEffectDispatcher.js";
 import { MAPPED_USER_INPUT_POLL_MODES, pollMappedUserInputWithMikroOrm, } from "../../../adapter/persistence/providers/mikro-orm/observation/MikroOrmUserInputPolling.js";
 import { SyncPollingSupervisor } from "./SyncPollingSupervisor.js";
 import { SYNC_SERVICE_ERROR_CODES, SyncServiceError, } from "./errors.js";
-import { APPEND_DISPATCH_THROTTLE_INTERVAL_MS, DEFAULT_EFFECT_LEASE_DURATION_MS, DEFAULT_WRITER_LEASE_DURATION_MS, EFFECT_LEASE_PROVIDER_HEADROOM_MS, FAST_APPEND_BATCH_CANDIDATE_LIMIT, } from "../outbound/effects/SyncEffectWorkerConstants.js";
 const DEFAULT_POLLING_FULL_SCAN_INTERVAL_MS = 60_000;
 /**
  * Opens, provisions, and starts one internal sync service.
@@ -41,6 +43,11 @@ export async function createInternalSyncService(options) {
     validateServiceOptions(options, descriptors);
     const generated = createMikroOrmScalarRuntime(options.entities, options.projections);
     const writer = createWriterOptions(options);
+    // The effect worker claims its own lease role with the same runtime identity
+    // as the mapped writer unless the caller pinned an explicit worker id; one
+    // resolved identity is reused by the supervisor and by the graceful-shutdown
+    // lease release so both roles expire together on stop().
+    const effectWorkerId = options.workerId ?? writer.writerId;
     const runtime = await initializeMappedTypedSheetsRuntime({
         dbName: options.dbName,
         entities: generated.entities,
@@ -55,10 +62,14 @@ export async function createInternalSyncService(options) {
         const remote = createRemoteProvider(options, projectionDefinitions);
         await provisionRegisteredSyncSheets(remote.provisioner, projectionDefinitions);
         await autoResolveExistingMappedConflictsWithAdapter(runtime.storage, runtime.mappings.mappings, resolveTypedSheetsEntityWriterOptions(writer));
-        const effectSupervisor = createSyncEffectWorkerSupervisor({
+        const effectSupervisor = createEffectWorkerSupervisor({
             storage: runtime.storage,
-            provider: remote.provider,
+            dispatcher: new SheetsEffectDispatcher({
+                provider: remote.provider,
+                storage: runtime.storage,
+            }),
             ...optionalWorkerOptions(options),
+            workerId: effectWorkerId,
         });
         const pollingFullScanIntervalMs = options.pollingFullScanIntervalMs
             ?? DEFAULT_POLLING_FULL_SCAN_INTERVAL_MS;
@@ -107,8 +118,24 @@ export async function createInternalSyncService(options) {
             // Stop inbound reads first, then the outbound worker. Both supervisors
             // drain manual and background passes before SQLite is closed.
             stopPromise = (async () => {
-                await pollingSupervisor.stop();
-                await effectSupervisor.stop();
+                try {
+                    await pollingSupervisor.stop();
+                    await effectSupervisor.stop();
+                }
+                finally {
+                    // Graceful-shutdown handoff: expire this runtime's own leases so the
+                    // next runtime on the same SQLite file claims immediately through the
+                    // TAKEOVER path. Abnormal exits keep the full lease window, and the
+                    // row is never deleted so authority epoch ordering stays monotonic.
+                    // The release ALWAYS runs, even when a supervisor stop fails, so a
+                    // restart inside the lease window never fails with
+                    // WRITER_LEASE_UNAVAILABLE; a failing release only logs and never
+                    // masks the supervisor error. `stopped` still flips only when both
+                    // supervisor stops complete, so a rejected stop leaves a retryable
+                    // close() that re-runs the stops and the release.
+                    await expireRuntimeWriterLeases(runtime.storage, writer, effectWorkerId)
+                        .catch(() => undefined);
+                }
                 stopped = true;
                 stopPromise = undefined;
             })().catch((error) => {
@@ -133,6 +160,15 @@ export async function createInternalSyncService(options) {
         };
     }
     catch (error) {
+        // Conflict-route registration claims this runtime's mapped-role writer
+        // lease before remote provisioning runs; a provisioning failure would
+        // otherwise leave the claim valid for the full lease window and every
+        // immediate retry would fail at the same claim with
+        // WRITER_LEASE_UNAVAILABLE. Expire the claimed leases (CAS-guarded,
+        // warn-and-continue) so the retry takes over at once; the extra guard
+        // ensures this can never mask the original startup error.
+        await expireRuntimeWriterLeases(runtime.storage, writer, effectWorkerId)
+            .catch(() => undefined);
         await runtime.storage.close(true).catch(() => undefined);
         throw error;
     }
@@ -270,6 +306,55 @@ function createWriterOptions(options) {
         ...(options.onTiming === undefined ? {} : { onTiming: options.onTiming }),
     };
 }
+/**
+ * Expires this runtime's own writer leases on graceful shutdown.
+ *
+ * Each release is CAS-guarded on the exact lease row this runtime holds
+ * (role, writer id, epoch, fencing token), so a concurrent takeover or a
+ * previously crashed runtime's stale row is never expired. The observation
+ * poller and the auto conflict resolver claim under the mapped writer role
+ * with the same writer id, so the single mapped-role release covers them.
+ * A failing release only logs a classified warning and never aborts stop().
+ */
+async function expireRuntimeWriterLeases(storage, writer, effectWorkerId) {
+    const now = writer.now?.() ?? Date.now();
+    // Every claim site wired into the bootstrap must be mirrored here:
+    // conflict route registration (registerSyncConflictProjectionRoutes), auto
+    // conflict resolution (autoSystemConflictResolution), mapped flush planning
+    // and projection registration (flushCoordinator,
+    // mappedPersistenceContext), and observation polling
+    // (MikroOrmUserInputPolling) claim under the mapped writer role with
+    // writer.writerId; the effect worker supervisor claims under
+    // DEFAULT_WORKER_ROLE with effectWorkerId. A claim added elsewhere must be
+    // added to this list, or graceful close leaves it leased for the window.
+    const ownLeases = [
+        { role: DEFAULT_MAPPED_WRITER_ROLE, writerId: writer.writerId },
+        { role: DEFAULT_WORKER_ROLE, writerId: effectWorkerId },
+    ];
+    for (const { role, writerId } of ownLeases) {
+        try {
+            const found = await readWriterLeaseWithAdapter(storage, role);
+            if (found.kind !== LOOKUP_RESULT_KINDS.FOUND || found.value.writerId !== writerId) {
+                // No row, or the lease was already taken over by a newer writer:
+                // nothing this runtime owns to expire.
+                continue;
+            }
+            const released = await releaseWriterLeaseWithAdapter(storage, {
+                role,
+                writerId,
+                writerEpoch: found.value.writerEpoch,
+                fencingToken: found.value.fencingToken,
+                now,
+            });
+            if (!released) {
+                console.warn(`[sync-service] writer lease for role "${role}" changed ownership during shutdown; skipping release.`);
+            }
+        }
+        catch (error) {
+            console.warn(`[sync-service] writer lease release failed for role "${role}": ${safeErrorMessage(error)}`);
+        }
+    }
+}
 function optionalWorkerOptions(options) {
     // The knobs are tied to the ACTIVE provider: the full direct Google
     // provider's timeouts (its defaults when omitted). The worker provider