hikoutei 0.3.3 → 0.3.5

package/dist/adapter/sheets/providers/google-sheets-api/model/postcondition.js

@@ -0,0 +1,99 @@
+/**
+ * Response-loss postcondition classifier (Apps Script `classifyPostcondition_`).
+ *
+ * Recovery probes classify one effect against a fresh target+receipt read.
+ * The classifier never assumes success: a receipt proves the effect reached
+ * the sheet, a matching visible hash proves the target content, and anything
+ * else is `unapplied`, `changed`, or `unavailable` so the worker redrives,
+ * fails, or keeps probing instead of closing the outbox on weak evidence.
+ */
+import { PRESENCE_KINDS } from "../../../../../shared/state/index.js";
+import { presentValue, absentValue } from "../../../../../shared/state/index.js";
+import { currentHash, findWorkingRow, isDeletionEffect, requireGatewayEffect, toWorkingRow, } from "./planner.js";
+/**
+ * Classifies one effect's delivery state. `context` must come from the same
+ * read pass as `receipts` so the classification is a single consistent view.
+ */
+export function classifyPostcondition(context, effect, receipts) {
+    const request = {
+        physicalSheetId: effect.physicalSheetId,
+        sheetName: effect.payload.sheetName,
+        registeredRange: effect.payload.registeredRange,
+        projection: effect.projection,
+        schemaVersion: effect.payload.schemaVersion,
+        effects: [effect],
+    };
+    requireGatewayEffect(effect, request, context);
+    const receipt = receipts.get(effect.effectId);
+    if (receipt !== undefined && receipt.payloadHash !== effect.payloadHash) {
+        return postcondition("changed", absentValue(), absentValue());
+    }
+    const row = findProbeRow(context, effect);
+    if (isDeletionEffect(effect.effectKind)) {
+        if (receipt !== undefined && row === undefined) {
+            return postcondition("applied", presentValue(receipt.visibleRevision), presentValue(receipt.visibleHash));
+        }
+        if (row === undefined) {
+            // An absent row without this effect's receipt could be a manual
+            // deletion; never let that absence close an outbox effect.
+            return postcondition("unavailable", absentValue(), absentValue());
+        }
+        const deleteHash = currentHash(row, effect.payload.fields);
+        if (receipt !== undefined) {
+            return postcondition("changed", absentValue(), presentValue(deleteHash));
+        }
+        return deleteHash === effect.expectedVisibleHash
+            ? postcondition("unapplied", presentValue(effect.expectedVisibleRevision), presentValue(deleteHash))
+            : postcondition("changed", absentValue(), presentValue(deleteHash));
+    }
+    // A receipt alone cannot prove that a non-delete row still exists; a manual
+    // deletion must remain observable instead of closing the outbox.
+    if (row === undefined) {
+        return postcondition(receipt !== undefined || !effect.payload.createIfMissing ? "changed" : "unapplied", absentValue(), absentValue(), receipt === undefined ? undefined : "receipt_target_missing");
+    }
+    const current = currentHash(row, effect.payload.fields);
+    if (current === effect.payload.targetVisibleHash) {
+        if (receipt === undefined) {
+            // The row already carries the target content, but without a receipt
+            // there is no durable proof that this effect was applied by the
+            // provider: the two-batch inline path can crash between the target-row
+            // write and the receipt write and leave exactly this orphan. Closing
+            // the outbox on row-hash evidence alone would turn that crash into a
+            // false success, so stay fail-closed.
+            return postcondition("unavailable", absentValue(), presentValue(current), "receipt_missing");
+        }
+        return postcondition("applied", presentValue(receipt.visibleRevision), presentValue(current));
+    }
+    const repairGuard = effect.repairGuardHash;
+    if (current === effect.expectedVisibleHash ||
+        (repairGuard.kind === PRESENCE_KINDS.PRESENT && current === repairGuard.value)) {
+        return postcondition("unapplied", presentValue(effect.expectedVisibleRevision), presentValue(current));
+    }
+    return postcondition("changed", absentValue(), presentValue(current));
+}
+function findProbeRow(context, effect) {
+    const byAnchor = new Map();
+    const byIdentity = new Map();
+    for (const row of context.rows) {
+        const working = toWorkingRow(row);
+        if (working.anchor.kind === PRESENCE_KINDS.PRESENT) {
+            byAnchor.set(working.anchor.value, working);
+        }
+        if (working.identity.kind === PRESENCE_KINDS.PRESENT) {
+            byIdentity.set(working.identity.value, working);
+        }
+    }
+    return findWorkingRow(byAnchor, byIdentity, effect.payload.targetAnchor, effect.targetId);
+}
+function postcondition(disposition, visibleRevision, visibleHash, reason) {
+    const result = {
+        disposition,
+        visibleRevision,
+        visibleHash,
+        // The direct provider never computes a snapshot hash; recovery does not
+        // need it and the Apps Script gateway also returns null here.
+        snapshotHash: absentValue(),
+    };
+    return reason === undefined ? result : { ...result, reason };
+}
+//# sourceMappingURL=postcondition.js.map

package/dist/adapter/sheets/providers/google-sheets-api/model/postcondition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postcondition.js","sourceRoot":"","sources":["../../../../../../src/adapter/sheets/providers/google-sheets-api/model/postcondition.ts"],"names":[],"mappings":"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"}

package/dist/adapter/sheets/providers/google-sheets-api/model/preflight.d.ts

@@ -0,0 +1,242 @@
+/**
+ * Bulk preflight: a sheet enumeration call plus one bounded data read of the
+ * target tab and receipt tab.
+ *
+ * The provider first enumerates every tab (no ranges, so hidden sheets are
+ * returned), then reads the target grid (values, date formats, row-level
+ * developer-metadata anchors) and the hidden receipt tab through the narrow
+ * transport. Every untrusted SDK payload is validated with runtime guards
+ * and promoted into a typed context the planner can mutate. Any drift —
+ * header changes, duplicate anchors or identities, malformed receipts,
+ * invalid cells — fails closed before a single mutation request is built.
+ *
+ * The enumeration and the data read are separate functions so the provider
+ * can pace and report each transport request individually; the composite
+ * `readPreflightContext` keeps the two-call sequence for non-pacing callers.
+ */
+import type { NormalizedCell } from "../../../../../domain/index.js";
+import type { Presence } from "../../../../../shared/state/index.js";
+import type { GoogleSheetsApiTransport } from "../transport/googleSheetsApiTransport.js";
+/**
+ * Preflight field mask: sheet identity plus grid values, formats, anchors.
+ *
+ * GridData has no `sheetId` of its own; the parent sheet's
+ * `sheets.properties.sheetId` identifies the grid, and developer metadata
+ * uses the REST `metadataKey`/`metadataValue` field names.
+ */
+export declare const GOOGLE_SHEETS_API_PREFLIGHT_FIELDS: string;
+/**
+ * Enumeration field mask: sheet identity only.
+ *
+ * The enumeration call requests no ranges because a ranged
+ * `spreadsheets.get` response only carries sheets intersecting the requested
+ * ranges (hidden tabs included only when no ranges are given); the receipt
+ * tab can therefore never be discovered from the ranged data call alone.
+ */
+export declare const GOOGLE_SHEETS_API_ENUMERATION_FIELDS = "sheets.properties(sheetId,title,hidden)";
+/**
+ * Provisioning enumeration mask: sheet identity plus grid dimensions.
+ *
+ * The grid dimensions let provisioning request the full used grid of an
+ * existing tab (up to the sheet's actual last column) so "truly empty" is
+ * judged against the whole tab, not just the registered range.
+ */
+export declare const GOOGLE_SHEETS_API_PROVISION_ENUMERATION_FIELDS = "sheets.properties(sheetId,title,hidden,gridProperties(rowCount,columnCount))";
+/**
+ * Provisioning data mask: values plus number formats for header checks.
+ *
+ * Anchors, merged ranges, and computed values are not needed to decide
+ * whether an existing tab is empty or whether its header row matches.
+ */
+export declare const GOOGLE_SHEETS_API_PROVISION_FIELDS: string;
+/**
+ * Values-only table-read mask (getValues semantics).
+ *
+ * Includes computed values, formatted error strings, number formats, and
+ * data-validation rules so formula cells resolve to their computed value,
+ * error cells to their display string, and checkbox columns to their
+ * blank/false rule.
+ */
+export declare const GOOGLE_SHEETS_API_VALUES_FIELDS: string;
+/**
+ * Full observation mask: values, computed values, merged ranges, anchors.
+ *
+ * This is the metadata-preserving read used by snapshots and anchor
+ * assignment. Merged regions live on the SHEET object as `sheets.merges`
+ * (GridRange entries), NOT on GridData, and `rowMetadata.developerMetadata`
+ * returns the row anchor evidence under the REST `metadataKey`/
+ * `metadataValue` names.
+ */
+export declare const GOOGLE_SHEETS_API_OBSERVATION_FIELDS: string;
+/**
+ * Lightweight observation mask: values and computed values only.
+ *
+ * Used by user_input polling reads, which never consult merged regions (the
+ * lightweight branch has no merged map) or data-validation rules (the
+ * checkbox-false blank rule comes from the checkboxHeaders config, not from
+ * dataValidation). Keeping `sheets.merges` and `dataValidation` out of the
+ * request makes the polling read cheaper.
+ */
+export declare const GOOGLE_SHEETS_API_LIGHTWEIGHT_OBSERVATION_FIELDS: string;
+/** One validated merged-cell region (a GridRange) from a sheet payload. */
+export interface ParsedMergedCell {
+    readonly sheetId?: number;
+    readonly startRowIndex: number;
+    readonly endRowIndex: number;
+    readonly startColumnIndex: number;
+    readonly endColumnIndex: number;
+}
+/** One validated receipt row read from the hidden receipt tab. */
+export interface PreflightReceipt {
+    readonly effectId: string;
+    readonly payloadHash: string;
+    readonly status: "applied";
+    readonly visibleHash: string;
+    readonly visibleRevision: number;
+}
+/** One nonblank target row normalized from the grid read. */
+export interface PreflightRow {
+    readonly rowNumber: number;
+    readonly physicalAnchor: Presence<string>;
+    readonly cells: Readonly<Record<string, NormalizedCell>>;
+    readonly identity: Presence<string>;
+}
+/** Typed preflight context consumed by the planner and batch builder. */
+export interface PreflightContext {
+    readonly sheetId: number;
+    readonly title: string;
+    /** 1-based absolute start column of the registered range in the grid. */
+    readonly startColumn: number;
+    readonly headers: readonly string[];
+    /** header -> 0-based column offset inside the registered range. */
+    readonly positions: ReadonlyMap<string, number>;
+    readonly rows: readonly PreflightRow[];
+    readonly byAnchor: ReadonlyMap<string, PreflightRow>;
+    readonly byIdentity: ReadonlyMap<string, PreflightRow>;
+    /** First free row (1-based) for appends: max(lastContentRow + 1, 2). */
+    readonly nextAppendRow: number;
+    readonly identityField: Presence<string>;
+    readonly checkboxHeaders: readonly string[];
+    readonly receiptSheetId: Presence<number>;
+    /** Receipt tab last content row; 0 when the tab is absent. */
+    readonly receiptLastRow: number;
+    readonly receipts: ReadonlyMap<string, PreflightReceipt>;
+    /** Sheet ids of every tab seen by the enumeration (id allocator input). */
+    readonly existingSheetIds: readonly number[];
+}
+/** Route-level inputs every preflight needs from the registered definition. */
+export interface PreflightRouteOptions {
+    readonly spreadsheetId: string;
+    readonly sheetName: string;
+    readonly registeredRange: string;
+    readonly headers: readonly string[];
+    readonly identityField: Presence<string>;
+    readonly checkboxHeaders: readonly string[];
+}
+/**
+ * Enumerates every tab of the spreadsheet (no ranges, so hidden tabs are
+ * returned). The enumeration supplies the sheetIds the data call's grid
+ * data is keyed by and the receipt tab's presence.
+ */
+export declare function enumerateSheetProperties(transport: GoogleSheetsApiTransport, spreadsheetId: string, timeoutMs?: number): Promise<readonly ParsedSheet[]>;
+/** Reads and validates the target and receipt tabs for one route. */
+export declare function readPreflightContext(transport: GoogleSheetsApiTransport, route: PreflightRouteOptions, timeoutMs?: number): Promise<PreflightContext>;
+/**
+ * Reads the bounded target/receipt grid data for one route, given the sheet
+ * enumeration. The target range starts at A1 and extends to the registered
+ * range's end column (whole-column ranges can legitimately exceed ZZ),
+ * keeping the 1,048,576-row limit of the grid.
+ */
+export declare function readPreflightData(transport: GoogleSheetsApiTransport, route: PreflightRouteOptions, sheets: readonly ParsedSheet[], timeoutMs?: number): Promise<PreflightContext>;
+export interface ParsedSheet {
+    readonly sheetId: number;
+    readonly title: string;
+    readonly hidden: boolean;
+    /** Grid dimensions when the requesting mask included gridProperties. */
+    readonly gridProperties?: {
+        readonly rowCount: number;
+        readonly columnCount: number;
+    };
+    /** Merged ranges when the requesting mask included sheets.merges. */
+    readonly merges?: readonly ParsedMergedCell[];
+}
+export interface ParsedGridData {
+    readonly startRow: number;
+    readonly startColumn: number;
+    readonly rowData: readonly ParsedRowData[];
+    readonly rowMetadata: readonly ParsedRowMetadata[];
+}
+export interface ParsedRowData {
+    readonly values: readonly unknown[];
+}
+export interface ParsedRowMetadata {
+    readonly developerMetadata: readonly {
+        readonly metadataKey: string;
+        readonly metadataValue: string;
+    }[];
+}
+/** One validated REST `CellFormat.numberFormat` object from an SDK cell. */
+export interface ParsedCellNumberFormat {
+    readonly type: string;
+    readonly pattern: string | undefined;
+}
+interface ParsedSpreadsheetDocument {
+    readonly sheets: readonly ParsedSheet[];
+    readonly grids: ReadonlyMap<number, ParsedGridData>;
+}
+/** Promotes an untrusted `spreadsheets.get` body with runtime guards. */
+export declare function parseSpreadsheetDocument(value: unknown, label: string): ParsedSpreadsheetDocument;
+/**
+ * Promotes an enumeration-only `spreadsheets.get` body (sheet properties,
+ * no grid data) with runtime guards.
+ */
+export declare function parseSheetPropertiesDocument(value: unknown, label: string): readonly ParsedSheet[];
+/** Returns the parsed grid for one sheet by title, failing closed when absent. */
+export declare function requireGridDataByTitle(document: ParsedSpreadsheetDocument, sheets: readonly ParsedSheet[], title: string): {
+    readonly sheet: ParsedSheet;
+    readonly grid: ParsedGridData;
+};
+/**
+ * Validates the header row against the registered definition and layout:
+ * every cell must be a non-empty string, duplicates fail closed, and the
+ * row must match the expected headers exactly.
+ */
+export declare function readRegisteredHeaders(data: ParsedGridData, range: {
+    readonly startColumn: number;
+    readonly columnCount: number;
+}, expectedHeaders: readonly string[]): readonly string[];
+/** Returns the header cells of one grid as raw API values (no validation). */
+export declare function gridHeaderCells(data: ParsedGridData, range: {
+    readonly startColumn: number;
+    readonly columnCount: number;
+}): readonly unknown[];
+/**
+ * Builds the row -> anchor-list index from one grid's row metadata.
+ *
+ * Row metadata is index-aligned with rowData; only the shared anchor key
+ * counts, and a row may legitimately carry several metadata entries (the
+ * caller decides whether multiple anchors are an error).
+ */
+export declare function readAnchorIndex(data: ParsedGridData): ReadonlyMap<number, readonly string[]>;
+/**
+ * Reads the visible cells of one 1-based row over the registered range.
+ *
+ * `null` entries mark blank cells, matching the sparse values arrays the API
+ * returns (a row's values array may be narrower than the requested range).
+ */
+export declare function gridRowCells(data: ParsedGridData, rowNumber: number, startColumn: number, columnCount: number): readonly unknown[];
+/**
+ * Extracts the number format of one API cell, if any.
+ *
+ * The REST API models `CellFormat.numberFormat` as a `{ type, pattern }`
+ * object, never a bare string; the user-entered format wins over the
+ * effective format when both are present.
+ */
+export declare function apiCellNumberFormat(value: unknown): ParsedCellNumberFormat | undefined;
+/** Parses and validates the hidden receipt tab grid. */
+export declare function readReceipts(data: ParsedGridData): {
+    readonly receipts: ReadonlyMap<string, PreflightReceipt>;
+    readonly lastRow: number;
+};
+export {};
+//# sourceMappingURL=preflight.d.ts.map

package/dist/adapter/sheets/providers/google-sheets-api/model/preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../../../../../../src/adapter/sheets/providers/google-sheets-api/model/preflight.ts"],"names":[],"mappings":"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"}