hikoutei 0.2.0

package/dist/application/sync/inbound/polling/SimpleSheetPolling.d.ts

@@ -0,0 +1,72 @@
+/**
+ * SQLite-authoritative polling with one values read per registered table.
+ *
+ * This path intentionally does not assign anchors, read Developer Metadata,
+ * acquire a Sheet lock, calculate snapshot hashes, or write observation
+ * receipts. It reads the registered range once, matches rows by the declared
+ * business key, compares normalized values with SQLite canonical state, and
+ * returns only changed rows for the observation writer to persist.
+ */
+import type { NormalizedCell } from "../../../../domain/index.js";
+import type { SqlStorageAdapter } from "../../../../adapter/persistence/contracts/sql.js";
+import type { RegisteredSyncProjectionDefinition } from "../../gateway/SyncGatewayBootstrap.js";
+import type { SyncSheetTableReaderGateway, SyncTableRowsResult } from "../../gateway/syncGateway.js";
+/** Runtime classification for one row returned by simple polling. */
+export declare const SIMPLE_POLL_ROW_KINDS: {
+    readonly UNCHANGED: "unchanged";
+    readonly CHANGED: "changed";
+    readonly UNKNOWN: "unknown";
+    readonly INVALID: "invalid";
+};
+export type SimplePollRowKind = (typeof SIMPLE_POLL_ROW_KINDS)[keyof typeof SIMPLE_POLL_ROW_KINDS];
+/** Stable reasons for rows that cannot be compared to canonical state. */
+export declare const SIMPLE_POLL_INVALID_REASONS: {
+    readonly MISSING_IDENTITY: "missing_identity";
+    readonly DUPLICATE_IDENTITY: "duplicate_identity";
+    readonly INVALID_CANONICAL_VALUE: "invalid_canonical_value";
+};
+export type SimplePollInvalidReason = (typeof SIMPLE_POLL_INVALID_REASONS)[keyof typeof SIMPLE_POLL_INVALID_REASONS];
+/** One changed Sheet row ready for the next observation/evaluation stage. */
+export interface SimplePollChangedRow {
+    readonly entityId: string;
+    readonly rowNumber: number;
+    readonly fields: Readonly<Record<string, NormalizedCell>>;
+    readonly changedFields: readonly string[];
+}
+/** One table's result from a lightweight polling pass. */
+export interface SimpleSheetTablePollingResult {
+    readonly physicalSheetId: string;
+    readonly logicalSheetId: string;
+    readonly sheetName: string;
+    readonly rowsScanned: number;
+    readonly unchangedRows: number;
+    readonly changedRows: readonly SimplePollChangedRow[];
+    readonly unknownRows: number;
+    readonly invalidRows: number;
+    readonly missingCanonicalRows: number;
+    readonly readTiming?: SyncTableRowsResult["timing"];
+    readonly elapsedMs: number;
+}
+/** Aggregated result for one polling pass across the registered tables. */
+export interface SimpleSheetPollingResult {
+    readonly elapsedMs: number;
+    readonly tables: readonly SimpleSheetTablePollingResult[];
+    readonly rowsScanned: number;
+    readonly unchangedRows: number;
+    readonly changedRows: readonly SimplePollChangedRow[];
+    readonly unknownRows: number;
+    readonly invalidRows: number;
+    readonly missingCanonicalRows: number;
+}
+/**
+ * Reads and compares all selected projections without a writer lease or
+ * Sheet-side metadata mutation. Missing canonical rows are reported only;
+ * this function never infers a delete from a missing Sheet row.
+ */
+export declare function pollSimpleSheetRowsWithAdapter(options: {
+    readonly storage: SqlStorageAdapter;
+    readonly gateway: SyncSheetTableReaderGateway;
+    readonly definitions: readonly RegisteredSyncProjectionDefinition[];
+    readonly physicalSheetIds?: readonly string[];
+}): Promise<SimpleSheetPollingResult>;
+//# sourceMappingURL=SimpleSheetPolling.d.ts.map

package/dist/application/sync/inbound/polling/SimpleSheetPolling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SimpleSheetPolling.d.ts","sourceRoot":"","sources":["../../../../../src/application/sync/inbound/polling/SimpleSheetPolling.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAIlE,OAAO,KAAK,EAAe,iBAAiB,EAAE,MAAM,kDAAkD,CAAC;AAKvG,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,uCAAuC,CAAC;AAChG,OAAO,KAAK,EAEV,2BAA2B,EAE3B,mBAAmB,EACpB,MAAM,8BAA8B,CAAC;AAkBtC,qEAAqE;AACrE,eAAO,MAAM,qBAAqB;;;;;CAKxB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAC3B,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,OAAO,qBAAqB,CAAC,CAAC;AAErE,0EAA0E;AAC1E,eAAO,MAAM,2BAA2B;;;;CAI9B,CAAC;AAEX,MAAM,MAAM,uBAAuB,GACjC,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,OAAO,2BAA2B,CAAC,CAAC;AAEjF,6EAA6E;AAC7E,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;IAC1D,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3C;AAED,0DAA0D;AAC1D,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACtD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,UAAU,CAAC,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IACpD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,2EAA2E;AAC3E,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,6BAA6B,EAAE,CAAC;IAC1D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACtD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;CACvC;AAoCD;;;;GAIG;AACH,wBAAsB,8BAA8B,CAAC,OAAO,EAAE;IAC5D,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,2BAA2B,CAAC;IAC9C,QAAQ,CAAC,WAAW,EAAE,SAAS,kCAAkC,EAAE,CAAC;IACpE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/C,GAAG,OAAO,CAAC,wBAAwB,CAAC,CA+CpC"}

package/dist/application/sync/inbound/polling/SimpleSheetPolling.js

@@ -0,0 +1,272 @@
+/**
+ * SQLite-authoritative polling with one values read per registered table.
+ *
+ * This path intentionally does not assign anchors, read Developer Metadata,
+ * acquire a Sheet lock, calculate snapshot hashes, or write observation
+ * receipts. It reads the registered range once, matches rows by the declared
+ * business key, compares normalized values with SQLite canonical state, and
+ * returns only changed rows for the observation writer to persist.
+ */
+import { NORMALIZED_CELL_KINDS, } from "../../../../shared/encoding/constants.js";
+import { STORAGE_ERROR_CODES, StorageError, } from "../../../../infrastructure/storage/errors.js";
+const READ_CANONICAL_ROWS_SQL = `
+  SELECT binding.logical_sheet_id, entity.entity_id, entity.status AS entity_status,
+         field.field_name, field.normalized_value
+  FROM row_binding AS binding
+  JOIN entity_state AS entity
+    ON entity.entity_id = binding.entity_id
+   AND entity.status IN ('active', 'tombstoned')
+  JOIN entity_field_state AS field
+    ON field.entity_id = entity.entity_id
+  WHERE binding.logical_sheet_id IN (__LOGICAL_SHEET_IDS__)
+    AND binding.state IN ('active', 'tombstoned')
+  ORDER BY binding.logical_sheet_id, entity.entity_id, field.field_name
+`;
+const DEFAULT_TOMBSTONE_FIELD_NAME = "__typed_sheets_deleted";
+/** Runtime classification for one row returned by simple polling. */
+export const SIMPLE_POLL_ROW_KINDS = {
+    UNCHANGED: "unchanged",
+    CHANGED: "changed",
+    UNKNOWN: "unknown",
+    INVALID: "invalid",
+};
+/** Stable reasons for rows that cannot be compared to canonical state. */
+export const SIMPLE_POLL_INVALID_REASONS = {
+    MISSING_IDENTITY: "missing_identity",
+    DUPLICATE_IDENTITY: "duplicate_identity",
+    INVALID_CANONICAL_VALUE: "invalid_canonical_value",
+};
+/**
+ * Reads and compares all selected projections without a writer lease or
+ * Sheet-side metadata mutation. Missing canonical rows are reported only;
+ * this function never infers a delete from a missing Sheet row.
+ */
+export async function pollSimpleSheetRowsWithAdapter(options) {
+    const startedAt = Date.now();
+    const definitions = selectDefinitions(options.definitions, options.physicalSheetIds);
+    validateDefinitions(definitions);
+    if (definitions.length === 0) {
+        return {
+            elapsedMs: Date.now() - startedAt,
+            tables: [],
+            rowsScanned: 0,
+            unchangedRows: 0,
+            changedRows: [],
+            unknownRows: 0,
+            invalidRows: 0,
+            missingCanonicalRows: 0,
+        };
+    }
+    const [canonicalByLogicalSheet, remoteResults] = await Promise.all([
+        readCanonicalRows(options.storage, definitions),
+        options.gateway.readRowsBatch(definitions.map(toReadRequest)),
+    ]);
+    if (remoteResults.length !== definitions.length) {
+        throwPollingError("table read result count does not match the requested tables");
+    }
+    const tables = definitions.map((definition, index) => {
+        const remote = remoteResults[index];
+        if (remote === undefined) {
+            throwPollingError("table read result is missing at index " + index);
+        }
+        const canonical = canonicalByLogicalSheet.get(definition.sheet.logicalSheetId) ?? new Map();
+        return compareTable(definition, remote, canonical);
+    });
+    const changedRows = tables.flatMap((table) => table.changedRows);
+    return {
+        elapsedMs: Date.now() - startedAt,
+        tables,
+        rowsScanned: tables.reduce((total, table) => total + table.rowsScanned, 0),
+        unchangedRows: tables.reduce((total, table) => total + table.unchangedRows, 0),
+        changedRows,
+        unknownRows: tables.reduce((total, table) => total + table.unknownRows, 0),
+        invalidRows: tables.reduce((total, table) => total + table.invalidRows, 0),
+        missingCanonicalRows: tables.reduce((total, table) => total + table.missingCanonicalRows, 0),
+    };
+}
+function toReadRequest(definition) {
+    return {
+        physicalSheetId: definition.sheet.physicalSheetId,
+        sheetName: definition.sheet.tabName,
+        registeredRange: definition.sheet.registeredRange,
+        projection: definition.sheet.projection,
+        schemaVersion: definition.sheet.schemaVersion,
+        headers: definition.headers,
+    };
+}
+async function readCanonicalRows(storage, definitions) {
+    const logicalSheetIds = definitions.map((definition) => definition.sheet.logicalSheetId);
+    const placeholders = logicalSheetIds.map(() => "?").join(", ");
+    const rows = await storage.read(({ sql }) => sql.all(READ_CANONICAL_ROWS_SQL.replace("__LOGICAL_SHEET_IDS__", placeholders), logicalSheetIds));
+    const entitiesByLogicalSheet = new Map();
+    for (const row of rows) {
+        const fieldsByEntity = entitiesByLogicalSheet.get(row.logical_sheet_id) ?? new Map();
+        const existing = fieldsByEntity.get(row.entity_id) ?? {
+            entityId: row.entity_id,
+            status: parseCanonicalEntityStatus(row.entity_status, row.entity_id),
+            fields: new Map(),
+        };
+        existing.fields.set(row.field_name, parseCanonicalCell(row.normalized_value, row.entity_id + "." + row.field_name));
+        fieldsByEntity.set(row.entity_id, existing);
+        entitiesByLogicalSheet.set(row.logical_sheet_id, fieldsByEntity);
+    }
+    return entitiesByLogicalSheet;
+}
+function compareTable(definition, remote, canonical) {
+    const startedAt = Date.now();
+    validateRemoteResult(definition, remote);
+    const identityField = definition.sheet.businessKeyField;
+    const identityCounts = new Map();
+    for (const row of remote.rows) {
+        const identity = identityFromCell(row.fields[identityField]);
+        if (identity !== undefined)
+            identityCounts.set(identity, (identityCounts.get(identity) ?? 0) + 1);
+    }
+    let unchangedRows = 0;
+    let unknownRows = 0;
+    let invalidRows = 0;
+    const changedRows = [];
+    const seenCanonicalIds = new Set();
+    for (const row of remote.rows) {
+        const result = compareRow(row, identityField, identityCounts, canonical, definition.headers);
+        if (result.kind === SIMPLE_POLL_ROW_KINDS.UNCHANGED) {
+            unchangedRows += 1;
+            seenCanonicalIds.add(result.entityId);
+        }
+        else if (result.kind === SIMPLE_POLL_ROW_KINDS.CHANGED) {
+            changedRows.push({
+                entityId: result.entityId,
+                rowNumber: row.rowNumber,
+                fields: row.fields,
+                changedFields: result.changedFields,
+            });
+            seenCanonicalIds.add(result.entityId);
+        }
+        else if (result.kind === SIMPLE_POLL_ROW_KINDS.UNKNOWN) {
+            unknownRows += 1;
+        }
+        else {
+            invalidRows += 1;
+        }
+    }
+    return {
+        physicalSheetId: definition.sheet.physicalSheetId,
+        logicalSheetId: definition.sheet.logicalSheetId,
+        sheetName: definition.sheet.tabName,
+        rowsScanned: remote.rows.length,
+        unchangedRows,
+        changedRows,
+        unknownRows,
+        invalidRows,
+        missingCanonicalRows: [...canonical.keys()].filter((entityId) => !seenCanonicalIds.has(entityId)).length,
+        ...(remote.timing === undefined ? {} : { readTiming: remote.timing }),
+        elapsedMs: Date.now() - startedAt,
+    };
+}
+function compareRow(row, identityField, identityCounts, canonical, headers) {
+    const identity = identityFromCell(row.fields[identityField]);
+    if (identity === undefined) {
+        return { kind: SIMPLE_POLL_ROW_KINDS.INVALID, reason: SIMPLE_POLL_INVALID_REASONS.MISSING_IDENTITY };
+    }
+    if (identityCounts.get(identity) !== 1) {
+        return { kind: SIMPLE_POLL_ROW_KINDS.INVALID, reason: SIMPLE_POLL_INVALID_REASONS.DUPLICATE_IDENTITY };
+    }
+    const expected = canonical.get(identity);
+    if (expected === undefined)
+        return { kind: SIMPLE_POLL_ROW_KINDS.UNKNOWN, entityId: identity };
+    const changedFields = headers.filter((fieldName) => {
+        const expectedCell = fieldName === DEFAULT_TOMBSTONE_FIELD_NAME
+            ? { kind: NORMALIZED_CELL_KINDS.BOOLEAN, value: expected.status === "tombstoned" }
+            : expected.fields.get(fieldName) ?? null;
+        return !sameCell(row.fields[fieldName] ?? null, expectedCell);
+    });
+    return changedFields.length === 0
+        ? { kind: SIMPLE_POLL_ROW_KINDS.UNCHANGED, entityId: identity }
+        : { kind: SIMPLE_POLL_ROW_KINDS.CHANGED, entityId: identity, changedFields };
+}
+function validateRemoteResult(definition, result) {
+    if (result.sheetName !== definition.sheet.tabName ||
+        result.registeredRange !== definition.sheet.registeredRange ||
+        result.headers.length !== definition.headers.length ||
+        result.headers.some((header, index) => header !== definition.headers[index])) {
+        throwPollingError("table read result does not match the registered projection");
+    }
+}
+function selectDefinitions(definitions, physicalSheetIds) {
+    if (physicalSheetIds === undefined)
+        return definitions;
+    const selected = new Set(physicalSheetIds);
+    return definitions.filter((definition) => selected.has(definition.sheet.physicalSheetId));
+}
+function validateDefinitions(definitions) {
+    for (const definition of definitions) {
+        if (!definition.headers.includes(definition.sheet.businessKeyField)) {
+            throwPollingError("business key is not declared in the projection headers: " + definition.sheet.businessKeyField);
+        }
+        if (new Set(definition.headers).size !== definition.headers.length) {
+            throwPollingError("projection headers contain duplicates: " + definition.sheet.tabName);
+        }
+    }
+}
+function identityFromCell(cell) {
+    if (cell === undefined || cell === null)
+        return undefined;
+    if (cell.kind === NORMALIZED_CELL_KINDS.STRING) {
+        return cell.value.length === 0 ? undefined : cell.value;
+    }
+    if (cell.kind === NORMALIZED_CELL_KINDS.NUMBER)
+        return String(cell.value);
+    return undefined;
+}
+function sameCell(left, right) {
+    if (left === null || right === null)
+        return left === right;
+    if (left.kind !== right.kind)
+        return false;
+    return left.value === right.value;
+}
+function parseCanonicalCell(value, label) {
+    let parsed;
+    try {
+        parsed = JSON.parse(value);
+    }
+    catch (error) {
+        throwPollingError("canonical value is not valid JSON for " + label, error);
+    }
+    if (parsed === null)
+        return null;
+    if (typeof parsed !== "object" || Array.isArray(parsed)) {
+        throwPollingError("canonical value is not a normalized cell for " + label);
+    }
+    const record = parsed;
+    if (record.kind === NORMALIZED_CELL_KINDS.STRING || record.kind === NORMALIZED_CELL_KINDS.DATE) {
+        if (typeof record.value !== "string")
+            throwPollingError("canonical text cell is invalid for " + label);
+        return record.kind === NORMALIZED_CELL_KINDS.STRING
+            ? { kind: NORMALIZED_CELL_KINDS.STRING, value: record.value }
+            : { kind: NORMALIZED_CELL_KINDS.DATE, value: record.value };
+    }
+    if (record.kind === NORMALIZED_CELL_KINDS.NUMBER) {
+        if (typeof record.value !== "number" || !Number.isFinite(record.value)) {
+            throwPollingError("canonical number cell is invalid for " + label);
+        }
+        return { kind: NORMALIZED_CELL_KINDS.NUMBER, value: record.value };
+    }
+    if (record.kind === NORMALIZED_CELL_KINDS.BOOLEAN) {
+        if (typeof record.value !== "boolean")
+            throwPollingError("canonical boolean cell is invalid for " + label);
+        return { kind: NORMALIZED_CELL_KINDS.BOOLEAN, value: record.value };
+    }
+    throwPollingError("canonical cell kind is unsupported for " + label);
+}
+function parseCanonicalEntityStatus(value, entityId) {
+    if (value === "active" || value === "tombstoned")
+        return value;
+    throwPollingError("canonical entity status is unsupported for " + entityId);
+}
+function throwPollingError(message, cause) {
+    throw new StorageError(STORAGE_ERROR_CODES.INVALID_READ_ONLY_OBSERVATION, message, {
+        cause,
+    });
+}
+//# sourceMappingURL=SimpleSheetPolling.js.map

package/dist/application/sync/inbound/polling/SimpleSheetPolling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SimpleSheetPolling.js","sourceRoot":"","sources":["../../../../../src/application/sync/inbound/polling/SimpleSheetPolling.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EACL,qBAAqB,GACtB,MAAM,0CAA0C,CAAC;AAElD,OAAO,EACL,mBAAmB,EACnB,YAAY,GACb,MAAM,8CAA8C,CAAC;AAStD,MAAM,uBAAuB,GAAG;;;;;;;;;;;;CAY/B,CAAC;AAEF,MAAM,4BAA4B,GAAG,wBAAwB,CAAC;AAE9D,qEAAqE;AACrE,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,SAAS,EAAE,WAAW;IACtB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;CACV,CAAC;AAKX,0EAA0E;AAC1E,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,gBAAgB,EAAE,kBAAkB;IACpC,kBAAkB,EAAE,oBAAoB;IACxC,uBAAuB,EAAE,yBAAyB;CAC1C,CAAC;AA0EX;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAAC,OAKpD;IACC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,WAAW,GAAG,iBAAiB,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACrF,mBAAmB,CAAC,WAAW,CAAC,CAAC;IACjC,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO;YACL,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;YACjC,MAAM,EAAE,EAAE;YACV,WAAW,EAAE,CAAC;YACd,aAAa,EAAE,CAAC;YAChB,WAAW,EAAE,EAAE;YACf,WAAW,EAAE,CAAC;YACd,WAAW,EAAE,CAAC;YACd,oBAAoB,EAAE,CAAC;SACxB,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,uBAAuB,EAAE,aAAa,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACjE,iBAAiB,CAAC,OAAO,CAAC,OAAO,EAAE,WAAW,CAAC;QAC/C,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,WAAW,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;KAC9D,CAAC,CAAC;IACH,IAAI,aAAa,CAAC,MAAM,KAAK,WAAW,CAAC,MAAM,EAAE,CAAC;QAChD,iBAAiB,CAAC,6DAA6D,CAAC,CAAC;IACnF,CAAC;IAED,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,EAAE;QACnD,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,iBAAiB,CAAC,wCAAwC,GAAG,KAAK,CAAC,CAAC;QACtE,CAAC;QACD,MAAM,SAAS,GAAG,uBAAuB,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;QAC5F,OAAO,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IACH,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IACjE,OAAO;QACL,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;QACjC,MAAM;QACN,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QAC1E,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC;QAC9E,WAAW;QACX,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QAC1E,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QAC1E,oBAAoB,EAAE,MAAM,CAAC,MAAM,CACjC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,KAAK,CAAC,oBAAoB,EACpD,CAAC,CACF;KACF,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CACpB,UAA8C;IAE9C,OAAO;QACL,eAAe,EAAE,UAAU,CAAC,KAAK,CAAC,eAAe;QACjD,SAAS,EAAE,UAAU,CAAC,KAAK,CAAC,OAAO;QACnC,eAAe,EAAE,UAAU,CAAC,KAAK,CAAC,eAAe;QACjD,UAAU,EAAE,UAAU,CAAC,KAAK,CAAC,UAAU;QACvC,aAAa,EAAE,UAAU,CAAC,KAAK,CAAC,aAAa;QAC7C,OAAO,EAAE,UAAU,CAAC,OAAO;KAC5B,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,iBAAiB,CAC9B,OAA0B,EAC1B,WAA0D;IAE1D,MAAM,eAAe,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IACzF,MAAM,YAAY,GAAG,eAAe,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/D,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAClD,uBAAuB,CAAC,OAAO,CAAC,uBAAuB,EAAE,YAAY,CAAC,EACtE,eAAe,CAChB,CAAC,CAAC;IACH,MAAM,sBAAsB,GAAG,IAAI,GAAG,EAAwC,CAAC;IAC/E,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,cAAc,GAAG,sBAAsB,CAAC,GAAG,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;QACrF,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI;YACpD,QAAQ,EAAE,GAAG,CAAC,SAAS;YACvB,MAAM,EAAE,0BAA0B,CAAC,GAAG,CAAC,aAAa,EAAE,GAAG,CAAC,SAAS,CAAC;YACpE,MAAM,EAAE,IAAI,GAAG,EAA0B;SAC1C,CAAC;QACF,QAAQ,CAAC,MAAM,CAAC,GAAG,CACjB,GAAG,CAAC,UAAU,EACd,kBAAkB,CAAC,GAAG,CAAC,gBAAgB,EAAE,GAAG,CAAC,SAAS,GAAG,GAAG,GAAG,GAAG,CAAC,UAAU,CAAC,CAC/E,CAAC;QACF,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC5C,sBAAsB,CAAC,GAAG,CAAC,GAAG,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,sBAAsB,CAAC;AAChC,CAAC;AAED,SAAS,YAAY,CACnB,UAA8C,EAC9C,MAA2B,EAC3B,SAA+C;IAE/C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,oBAAoB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACzC,MAAM,aAAa,GAAG,UAAU,CAAC,KAAK,CAAC,gBAAgB,CAAC;IACxD,MAAM,cAAc,GAAG,IAAI,GAAG,EAAkB,CAAC;IACjD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC;QAC7D,IAAI,QAAQ,KAAK,SAAS;YAAE,cAAc,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACpG,CAAC;IAED,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,MAAM,WAAW,GAA2B,EAAE,CAAC;IAC/C,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAU,CAAC;IAC3C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,EAAE,aAAa,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;QAC7F,IAAI,MAAM,CAAC,IAAI,KAAK,qBAAqB,CAAC,SAAS,EAAE,CAAC;YACpD,aAAa,IAAI,CAAC,CAAC;YACnB,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACxC,CAAC;aAAM,IAAI,MAAM,CAAC,IAAI,KAAK,qBAAqB,CAAC,OAAO,EAAE,CAAC;YACzD,WAAW,CAAC,IAAI,CAAC;gBACf,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,aAAa,EAAE,MAAM,CAAC,aAAa;aACpC,CAAC,CAAC;YACH,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACxC,CAAC;aAAM,IAAI,MAAM,CAAC,IAAI,KAAK,qBAAqB,CAAC,OAAO,EAAE,CAAC;YACzD,WAAW,IAAI,CAAC,CAAC;QACnB,CAAC;aAAM,CAAC;YACN,WAAW,IAAI,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IAED,OAAO;QACL,eAAe,EAAE,UAAU,CAAC,KAAK,CAAC,eAAe;QACjD,cAAc,EAAE,UAAU,CAAC,KAAK,CAAC,cAAc;QAC/C,SAAS,EAAE,UAAU,CAAC,KAAK,CAAC,OAAO;QACnC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM;QAC/B,aAAa;QACb,WAAW;QACX,WAAW;QACX,WAAW;QACX,oBAAoB,EAAE,CAAC,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM;QACxG,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;QACrE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;KAClC,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CACjB,GAAiB,EACjB,aAAqB,EACrB,cAA2C,EAC3C,SAA+C,EAC/C,OAA0B;IAE1B,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC;IAC7D,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,EAAE,IAAI,EAAE,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,2BAA2B,CAAC,gBAAgB,EAAE,CAAC;IACvG,CAAC;IACD,IAAI,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACvC,OAAO,EAAE,IAAI,EAAE,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,2BAA2B,CAAC,kBAAkB,EAAE,CAAC;IACzG,CAAC;IACD,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACzC,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,EAAE,IAAI,EAAE,qBAAqB,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;IAC/F,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE;QACjD,MAAM,YAAY,GAAG,SAAS,KAAK,4BAA4B;YAC7D,CAAC,CAAC,EAAE,IAAI,EAAE,qBAAqB,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,KAAK,YAAY,EAAE;YAClF,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC;QAC3C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,IAAI,EAAE,YAAY,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IACH,OAAO,aAAa,CAAC,MAAM,KAAK,CAAC;QAC/B,CAAC,CAAC,EAAE,IAAI,EAAE,qBAAqB,CAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE;QAC/D,CAAC,CAAC,EAAE,IAAI,EAAE,qBAAqB,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;AACjF,CAAC;AAED,SAAS,oBAAoB,CAC3B,UAA8C,EAC9C,MAA2B;IAE3B,IACE,MAAM,CAAC,SAAS,KAAK,UAAU,CAAC,KAAK,CAAC,OAAO;QAC7C,MAAM,CAAC,eAAe,KAAK,UAAU,CAAC,KAAK,CAAC,eAAe;QAC3D,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,UAAU,CAAC,OAAO,CAAC,MAAM;QACnD,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,KAAK,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAC5E,CAAC;QACD,iBAAiB,CAAC,4DAA4D,CAAC,CAAC;IAClF,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CACxB,WAA0D,EAC1D,gBAA+C;IAE/C,IAAI,gBAAgB,KAAK,SAAS;QAAE,OAAO,WAAW,CAAC;IACvD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAC3C,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC;AAC5F,CAAC;AAED,SAAS,mBAAmB,CAC1B,WAA0D;IAE1D,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACpE,iBAAiB,CACf,0DAA0D,GAAG,UAAU,CAAC,KAAK,CAAC,gBAAgB,CAC/F,CAAC;QACJ,CAAC;QACD,IAAI,IAAI,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACnE,iBAAiB,CAAC,yCAAyC,GAAG,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC1F,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAgC;IACxD,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAC1D,IAAI,IAAI,CAAC,IAAI,KAAK,qBAAqB,CAAC,MAAM,EAAE,CAAC;QAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;IAC1D,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,qBAAqB,CAAC,MAAM;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1E,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,QAAQ,CAAC,IAAoB,EAAE,KAAqB;IAC3D,IAAI,IAAI,KAAK,IAAI,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,KAAK,KAAK,CAAC;IAC3D,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IAC3C,OAAO,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,CAAC;AACpC,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAa,EAAE,KAAa;IACtD,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,iBAAiB,CAAC,wCAAwC,GAAG,KAAK,EAAE,KAAK,CAAC,CAAC;IAC7E,CAAC;IACD,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACjC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACxD,iBAAiB,CAAC,+CAA+C,GAAG,KAAK,CAAC,CAAC;IAC7E,CAAC;IACD,MAAM,MAAM,GAAG,MAAiC,CAAC;IACjD,IAAI,MAAM,CAAC,IAAI,KAAK,qBAAqB,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,qBAAqB,CAAC,IAAI,EAAE,CAAC;QAC/F,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ;YAAE,iBAAiB,CAAC,qCAAqC,GAAG,KAAK,CAAC,CAAC;QACvG,OAAO,MAAM,CAAC,IAAI,KAAK,qBAAqB,CAAC,MAAM;YACjD,CAAC,CAAC,EAAE,IAAI,EAAE,qBAAqB,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE;YAC7D,CAAC,CAAC,EAAE,IAAI,EAAE,qBAAqB,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;IAChE,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,qBAAqB,CAAC,MAAM,EAAE,CAAC;QACjD,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACvE,iBAAiB,CAAC,uCAAuC,GAAG,KAAK,CAAC,CAAC;QACrE,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,qBAAqB,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;IACrE,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,qBAAqB,CAAC,OAAO,EAAE,CAAC;QAClD,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,SAAS;YAAE,iBAAiB,CAAC,wCAAwC,GAAG,KAAK,CAAC,CAAC;QAC3G,OAAO,EAAE,IAAI,EAAE,qBAAqB,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;IACtE,CAAC;IACD,iBAAiB,CAAC,yCAAyC,GAAG,KAAK,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,0BAA0B,CAAC,KAAa,EAAE,QAAgB;IACjE,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,YAAY;QAAE,OAAO,KAAK,CAAC;IAC/D,iBAAiB,CAAC,6CAA6C,GAAG,QAAQ,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAe,EAAE,KAAe;IACzD,MAAM,IAAI,YAAY,CAAC,mBAAmB,CAAC,6BAA6B,EAAE,OAAO,EAAE;QACjF,KAAK;KACN,CAAC,CAAC;AACL,CAAC"}

package/dist/application/sync/index.d.ts

@@ -0,0 +1,16 @@
+/** Application-level synchronization orchestration. */
+export { createSyncEffectWorkerSupervisor, SyncEffectWorkerSupervisor, } from "./outbound/effects/SyncEffectSupervisor.js";
+export type { CreateSyncEffectWorkerSupervisorOptions, SyncEffectWorkerSupervisorReconciliationOptions, SyncEffectWorkerSupervisorLoopOptions, SyncEffectWorkerSupervisorWait, } from "./outbound/effects/SyncEffectSupervisor.js";
+export { runReconciliationScan } from "./outbound/reconciliation/ReconciliationScanner.js";
+export type { ReconciliationIdFactory, ReconciliationScanReport, RunReconciliationScanOptions, } from "./outbound/reconciliation/ReconciliationScanner.js";
+export { provisionRegisteredSyncSheets } from "./gateway/SyncGatewayBootstrap.js";
+export type { RegisteredSyncProjectionDefinition, SyncGatewayProvisionRoute, SyncGatewayProvisioner, } from "./gateway/SyncGatewayBootstrap.js";
+export { pollSimpleSheetRowsWithAdapter, SIMPLE_POLL_INVALID_REASONS, SIMPLE_POLL_ROW_KINDS, } from "./inbound/polling/SimpleSheetPolling.js";
+export type { SimplePollChangedRow, SimplePollInvalidReason, SimplePollRowKind, SimpleSheetPollingResult, SimpleSheetTablePollingResult, } from "./inbound/polling/SimpleSheetPolling.js";
+export { observeSyncSnapshot, observeSyncSnapshots, SplitSyncGateway, } from "./gateway/syncGateway.js";
+export type { SplitSyncGatewayOptions, SyncObservedSnapshot, SyncSheetObservationBatchGateway, SyncEffectWorkerGateway, SyncEffectWorkerFullGateway, SyncSheetObservationGateway, SyncSheetGateway, ReadSyncTableRowsRequest, SyncSheetTableReaderGateway, SyncTableRow, SyncTableRowsResult, } from "./gateway/syncGateway.js";
+export { SYNC_GATEWAY_SNAPSHOT_READ_MODES } from "./gateway/constants.js";
+export type { SyncGatewaySnapshotReadMode } from "./gateway/constants.js";
+export { SYNC_TIMING_OPERATION_KINDS, SYNC_TIMING_SCOPES, emptySyncTimingOperationCounts, } from "./telemetry/syncTiming.js";
+export type { SyncGatewayTiming, SyncGatewayTimingPhase, SyncTimingEvent, SyncTimingOperationCounts, SyncTimingOperationKind, SyncTimingScope, SyncTimingSink, } from "./telemetry/syncTiming.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/application/sync/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/application/sync/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EACL,gCAAgC,EAChC,0BAA0B,GAC3B,MAAM,4CAA4C,CAAC;AACpD,YAAY,EACV,uCAAuC,EACvC,+CAA+C,EAC/C,qCAAqC,EACrC,8BAA8B,GAC/B,MAAM,4CAA4C,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oDAAoD,CAAC;AAC3F,YAAY,EACV,uBAAuB,EACvB,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,oDAAoD,CAAC;AAC5D,OAAO,EAAE,6BAA6B,EAAE,MAAM,mCAAmC,CAAC;AAClF,YAAY,EACV,kCAAkC,EAClC,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,8BAA8B,EAC9B,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,yCAAyC,CAAC;AACjD,YAAY,EACV,oBAAoB,EACpB,uBAAuB,EACvB,iBAAiB,EACjB,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,yCAAyC,CAAC;AACjD,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,uBAAuB,EACvB,oBAAoB,EACpB,gCAAgC,EAChC,uBAAuB,EACvB,2BAA2B,EAC3B,2BAA2B,EAC3B,gBAAgB,EAChB,wBAAwB,EACxB,2BAA2B,EAC3B,YAAY,EACZ,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,gCAAgC,EAAE,MAAM,wBAAwB,CAAC;AAC1E,YAAY,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,EACL,2BAA2B,EAC3B,kBAAkB,EAClB,8BAA8B,GAC/B,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,iBAAiB,EACjB,sBAAsB,EACtB,eAAe,EACf,yBAAyB,EACzB,uBAAuB,EACvB,eAAe,EACf,cAAc,GACf,MAAM,2BAA2B,CAAC"}

package/dist/application/sync/index.js

@@ -0,0 +1,9 @@
+/** Application-level synchronization orchestration. */
+export { createSyncEffectWorkerSupervisor, SyncEffectWorkerSupervisor, } from "./outbound/effects/SyncEffectSupervisor.js";
+export { runReconciliationScan } from "./outbound/reconciliation/ReconciliationScanner.js";
+export { provisionRegisteredSyncSheets } from "./gateway/SyncGatewayBootstrap.js";
+export { pollSimpleSheetRowsWithAdapter, SIMPLE_POLL_INVALID_REASONS, SIMPLE_POLL_ROW_KINDS, } from "./inbound/polling/SimpleSheetPolling.js";
+export { observeSyncSnapshot, observeSyncSnapshots, SplitSyncGateway, } from "./gateway/syncGateway.js";
+export { SYNC_GATEWAY_SNAPSHOT_READ_MODES } from "./gateway/constants.js";
+export { SYNC_TIMING_OPERATION_KINDS, SYNC_TIMING_SCOPES, emptySyncTimingOperationCounts, } from "./telemetry/syncTiming.js";
+//# sourceMappingURL=index.js.map

package/dist/application/sync/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/application/sync/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EACL,gCAAgC,EAChC,0BAA0B,GAC3B,MAAM,4CAA4C,CAAC;AAOpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oDAAoD,CAAC;AAM3F,OAAO,EAAE,6BAA6B,EAAE,MAAM,mCAAmC,CAAC;AAMlF,OAAO,EACL,8BAA8B,EAC9B,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,yCAAyC,CAAC;AAQjD,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,0BAA0B,CAAC;AAclC,OAAO,EAAE,gCAAgC,EAAE,MAAM,wBAAwB,CAAC;AAE1E,OAAO,EACL,2BAA2B,EAC3B,kBAAkB,EAClB,8BAA8B,GAC/B,MAAM,2BAA2B,CAAC"}

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

@@ -0,0 +1,106 @@
+/**
+ * Keeps the bounded effect worker running until the durable outbox is idle.
+ *
+ * The supervisor provides liveness around `runSyncEffectWorker*()`: one pass
+ * still handles a bounded batch, while this loop starts the next pass and
+ * backs off after failures. It also coalesces manual and background triggers so
+ * one process cannot run two effect passes concurrently.
+ */
+import type { ReconciliationScanReport } from "../reconciliation/ReconciliationScanner.js";
+import { type SyncEffectWorkerReport, type SyncEffectWorkerWithAdapterOptions } from "./SyncEffectWorker.js";
+export type SyncEffectWorkerSupervisorWait = (durationMs: number) => Promise<void>;
+type RunPass = () => Promise<SyncEffectWorkerReport>;
+/** Periodic reconciliation(불일치 보정) task attached to the effect loop. */
+export interface SyncEffectWorkerSupervisorReconciliationOptions {
+    /** Minimum delay between scan attempts. The first scan runs immediately. */
+    readonly intervalMs?: number;
+    /** Confirms that no pending or processing outbox work remains before scanning. */
+    readonly isOutboxIdle?: () => Promise<boolean>;
+    /** Runs one scan and enqueues corrections into the durable outbox. */
+    readonly run: () => Promise<ReconciliationScanReport>;
+    /** Receives a completed scan without being allowed to stop the loop. */
+    readonly onReport?: (report: ReconciliationScanReport) => void;
+    /** Receives scan failures; the effect worker continues independently. */
+    readonly onError?: (error: unknown) => void;
+}
+/** Options for the runtime loop; `runPass` is injectable for deterministic tests. */
+export interface SyncEffectWorkerSupervisorLoopOptions {
+    readonly runPass: RunPass;
+    readonly idleIntervalMs?: number;
+    readonly errorBackoffInitialMs?: number;
+    readonly errorBackoffMaxMs?: number;
+    readonly random?: () => number;
+    readonly wait?: SyncEffectWorkerSupervisorWait;
+    readonly now?: () => number;
+    readonly reconciliation?: SyncEffectWorkerSupervisorReconciliationOptions;
+    readonly onReport?: (report: SyncEffectWorkerReport) => void;
+    readonly onError?: (error: unknown) => void;
+}
+/** Worker options with a clock supplied by the supervisor on every pass. */
+export type CreateSyncEffectWorkerSupervisorOptions = Omit<SyncEffectWorkerWithAdapterOptions, "now" | "workerId" | "maxEffects" | "writerLeaseDurationMs" | "effectLeaseDurationMs"> & {
+    readonly workerId?: string;
+    readonly maxEffects?: number;
+    readonly writerLeaseDurationMs?: number;
+    readonly effectLeaseDurationMs?: number;
+    readonly now?: () => number;
+    readonly idleIntervalMs?: number;
+    readonly errorBackoffInitialMs?: number;
+    readonly errorBackoffMaxMs?: number;
+    readonly random?: () => number;
+    readonly wait?: SyncEffectWorkerSupervisorWait;
+    readonly reconciliation?: SyncEffectWorkerSupervisorReconciliationOptions;
+    readonly onReport?: (report: SyncEffectWorkerReport) => void;
+    readonly onError?: (error: unknown) => void;
+};
+/**
+ * Runs one bounded effect pass at a time and continues while work is making
+ * progress. `stop()` waits for the current remote call to finish before the
+ * loop exits, so the caller does not close SQLite underneath an active pass.
+ */
+export declare class SyncEffectWorkerSupervisor {
+    private readonly runPass;
+    private readonly idleIntervalMs;
+    private readonly errorBackoffInitialMs;
+    private readonly errorBackoffMaxMs;
+    private readonly random;
+    private readonly wait;
+    private readonly now;
+    private readonly reconciliation;
+    private readonly reconciliationIntervalMs;
+    private readonly onReport;
+    private readonly onError;
+    private running;
+    private loopPromise;
+    private inFlightPass;
+    private inFlightReconciliation;
+    private nextReconciliationAt;
+    private wakeWaiter;
+    constructor(options: SyncEffectWorkerSupervisorLoopOptions);
+    /** Starts the background drain loop; repeated calls are harmless. */
+    start(): void;
+    /** Returns whether the supervisor is accepting background work. */
+    isRunning(): boolean;
+    /**
+     * Runs one pass or joins the pass already running in this process.
+     * Manual HTTP triggers therefore cannot create a second concurrent worker.
+     */
+    runOnce(): Promise<SyncEffectWorkerReport>;
+    /** Stops scheduling new passes and waits for the active pass to finish. */
+    stop(): Promise<void>;
+    private runLoop;
+    /** Runs the reconciliation task when its interval has elapsed. */
+    private runScheduledReconciliation;
+    /** Coalesces a manual/scheduled reconciliation call in this process. */
+    private runReconciliationOnce;
+    private notifyReconciliationReport;
+    private notifyReconciliationError;
+    private notifyReport;
+    private notifyError;
+    private waitFor;
+    private clearInFlightPass;
+    private clearInFlightReconciliation;
+}
+/** Creates a supervisor that supplies a fresh timestamp to every worker pass. */
+export declare function createSyncEffectWorkerSupervisor(options: CreateSyncEffectWorkerSupervisorOptions): SyncEffectWorkerSupervisor;
+export {};
+//# sourceMappingURL=SyncEffectSupervisor.d.ts.map

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

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