@b2bc-devkit/sheetorm 1.1.0 → 1.2.3

package/dist/npm/storage/GoogleSheetAdapter.js

@@ -1,238 +0,0 @@
-/**
- * Google Apps Script adapter implementing the ISheetAdapter interface.
- *
- * Wraps a single GAS `Sheet` object (one tab in a Spreadsheet) and
- * translates 0-based data indexes used by the ORM into 1-based sheet
- * rows required by the GAS Range API. Row 1 is always the header row;
- * data rows start at row 2.
- *
- * All multi-cell reads/writes are performed with `getRange().getValues()`
- * / `setValues()` to minimise GAS API calls (each call adds ~300 ms of
- * latency in the Apps Script runtime).
- *
- * @module GoogleSheetAdapter
- */
-import { SheetOrmLogger } from "../utils/SheetOrmLogger.js";
-/**
- * Production implementation of {@link ISheetAdapter} for Google Apps Script.
- * Delegates every operation to the underlying `GoogleAppsScript.Spreadsheet.Sheet`.
- */
-export class GoogleSheetAdapter {
-    /**
-     * @param sheet - A GAS Sheet object obtained via Spreadsheet.getSheetByName()
-     *                or Spreadsheet.insertSheet().
-     */
-    constructor(sheet) {
-        this.sheet = sheet;
-    }
-    /** Return the name of the underlying sheet tab. */
-    getName() {
-        return this.sheet.getName();
-    }
-    /**
-     * Read the header row (row 1) and return the column names as strings.
-     * Returns an empty array if the sheet has no columns.
-     */
-    getHeaders() {
-        const lastCol = this.sheet.getLastColumn();
-        if (lastCol === 0)
-            return [];
-        return this.sheet
-            .getRange(1, 1, 1, lastCol)
-            .getValues()[0]
-            .map((v) => String(v));
-    }
-    /**
-     * Overwrite the header row (row 1) with the given column names.
-     * No-op if the headers array is empty.
-     */
-    setHeaders(headers) {
-        if (headers.length === 0)
-            return;
-        this.sheet.getRange(1, 1, 1, headers.length).setValues([headers]);
-    }
-    /**
-     * Read all data rows (row 2+) as a 2D array.
-     * Returns an empty array if the sheet has no data rows.
-     */
-    getAllData() {
-        const lastRow = this.sheet.getLastRow();
-        const lastCol = this.sheet.getLastColumn();
-        // If there is only a header row (or nothing at all), return empty
-        if (lastRow <= 1 || lastCol === 0) {
-            SheetOrmLogger.log(`[Sheet:${this.sheet.getName()}] getAllData → 0 rows (empty)`);
-            return [];
-        }
-        // Read from row 2 (first data row) to the last occupied row
-        const result = this.sheet.getRange(2, 1, lastRow - 1, lastCol).getValues();
-        SheetOrmLogger.log(`[Sheet:${this.sheet.getName()}] getAllData → ${result.length} rows × ${lastCol} cols`);
-        return result;
-    }
-    /**
-     * Return the number of data rows (excludes the header row).
-     * Computed as `lastRow - 1`, where lastRow includes the header.
-     */
-    getRowCount() {
-        const lastRow = this.sheet.getLastRow();
-        const count = Math.max(0, lastRow - 1); // exclude header row
-        SheetOrmLogger.log(`[Sheet:${this.sheet.getName()}] getRowCount → ${count}`);
-        return count;
-    }
-    /** Append a single row after the last occupied row using GAS appendRow(). */
-    appendRow(values) {
-        this.sheet.appendRow(values);
-    }
-    /**
-     * Append multiple rows in a single setValues() API call.
-     * Much faster than calling appendRow() in a loop (~300 ms per call saved).
-     */
-    appendRows(rows) {
-        if (rows.length === 0)
-            return;
-        // Start writing immediately below the last occupied row
-        const startRow = this.sheet.getLastRow() + 1;
-        const numCols = rows[0].length;
-        SheetOrmLogger.log(`[Sheet:${this.sheet.getName()}] appendRows ${rows.length} rows × ${numCols} cols at sheetRow=${startRow}`);
-        this.sheet.getRange(startRow, 1, rows.length, numCols).setValues(rows);
-    }
-    /**
-     * Write rows starting at the given 0-based data index.
-     * Overwrites existing cells — used for batch-update operations.
-     *
-     * @param startRowIndex - 0-based data index (sheet row = index + 2).
-     * @param rows          - 2D array of values.
-     */
-    writeRowsAt(startRowIndex, rows) {
-        if (rows.length === 0)
-            return;
-        // Convert 0-based data index to 1-based sheet row (header is row 1)
-        const sheetRow = startRowIndex + 2;
-        const numCols = rows[0].length;
-        SheetOrmLogger.log(`[Sheet:${this.sheet.getName()}] writeRowsAt dataIdx=${startRowIndex} sheetRow=${sheetRow} rows=${rows.length} cols=${numCols}`);
-        this.sheet.getRange(sheetRow, 1, rows.length, numCols).setValues(rows);
-    }
-    /**
-     * Overwrite a single data row.
-     *
-     * @param rowIndex - 0-based data index (sheet row = index + 2).
-     * @param values   - Column values.
-     */
-    updateRow(rowIndex, values) {
-        const sheetRow = rowIndex + 2; // +2: 1-based + header offset
-        SheetOrmLogger.log(`[Sheet:${this.sheet.getName()}] updateRow dataIdx=${rowIndex} sheetRow=${sheetRow}`);
-        this.sheet.getRange(sheetRow, 1, 1, values.length).setValues([values]);
-    }
-    /**
-     * Overwrite multiple rows, batching contiguous groups into single
-     * setValues() calls to minimise GAS API round-trips.
-     *
-     * Example: updating rows 3, 4, 5, 10, 11 produces two setValues() calls
-     * instead of five.
-     */
-    updateRows(updates) {
-        if (updates.length === 0)
-            return;
-        // Sort by rowIndex so we can detect contiguous sequences
-        const sorted = [...updates].sort((a, b) => a.rowIndex - b.rowIndex);
-        // Accumulate contiguous groups and flush each as a single setValues()
-        let groupStart = sorted[0].rowIndex;
-        let groupRows = [sorted[0].values];
-        let groupCount = 0;
-        for (let i = 1; i < sorted.length; i++) {
-            if (sorted[i].rowIndex === sorted[i - 1].rowIndex + 1) {
-                // Contiguous — add to current group
-                groupRows.push(sorted[i].values);
-            }
-            else {
-                // Non-contiguous — flush the current group and start a new one
-                SheetOrmLogger.log(`[Sheet:${this.sheet.getName()}] updateRows group#${groupCount} dataIdx=${groupStart} rows=${groupRows.length}`);
-                this.sheet.getRange(groupStart + 2, 1, groupRows.length, groupRows[0].length).setValues(groupRows);
-                groupStart = sorted[i].rowIndex;
-                groupRows = [sorted[i].values];
-                groupCount++;
-            }
-        }
-        // Flush the final group
-        SheetOrmLogger.log(`[Sheet:${this.sheet.getName()}] updateRows group#${groupCount} dataIdx=${groupStart} rows=${groupRows.length} (final); total updates=${updates.length}`);
-        this.sheet.getRange(groupStart + 2, 1, groupRows.length, groupRows[0].length).setValues(groupRows);
-    }
-    /**
-     * Delete a single data row. GAS deleteRow() shifts all rows below up by one.
-     * @param rowIndex - 0-based data index.
-     */
-    deleteRow(rowIndex) {
-        const sheetRow = rowIndex + 2;
-        this.sheet.deleteRow(sheetRow);
-    }
-    /**
-     * Delete multiple data rows by index.
-     * Rows are deleted from bottom to top so that earlier indexes remain valid.
-     */
-    deleteRows(rowIndexes) {
-        // Sort descending to avoid index shift issues
-        const sorted = [...rowIndexes].sort((a, b) => b - a);
-        for (const idx of sorted) {
-            this.deleteRow(idx);
-        }
-    }
-    /**
-     * Read a single data row.
-     * @param rowIndex - 0-based data index.
-     * @returns Array of cell values.
-     */
-    getRow(rowIndex) {
-        const sheetRow = rowIndex + 2;
-        const lastCol = this.sheet.getLastColumn();
-        if (lastCol === 0)
-            return [];
-        return this.sheet.getRange(sheetRow, 1, 1, lastCol).getValues()[0];
-    }
-    /**
-     * Replace all data rows (row 2+) with the provided 2D array.
-     *
-     * If the new data has fewer rows than the old data, surplus old rows
-     * are cleared. If the new data is narrower (fewer columns), surplus
-     * columns in the written region are also cleared.
-     */
-    replaceAllData(rows) {
-        const lastRow = this.sheet.getLastRow();
-        const lastCol = this.sheet.getLastColumn();
-        const oldDataRows = Math.max(0, lastRow - 1);
-        const newCols = rows.length > 0 ? rows[0].length : 0;
-        const clearCols = Math.max(lastCol, newCols);
-        // Write the new data
-        if (rows.length > 0) {
-            this.sheet.getRange(2, 1, rows.length, newCols).setValues(rows);
-        }
-        // Clear surplus columns in written rows if new data is narrower
-        if (rows.length > 0 && newCols < lastCol) {
-            this.sheet.getRange(2, newCols + 1, rows.length, lastCol - newCols).clearContent();
-        }
-        // Clear surplus old rows below the new data
-        if (oldDataRows > rows.length && clearCols > 0) {
-            this.sheet.getRange(rows.length + 2, 1, oldDataRows - rows.length, clearCols).clearContent();
-        }
-    }
-    /** Clear the entire sheet (headers + data). */
-    clear() {
-        this.sheet.clear();
-    }
-    /** Force-flush pending changes to the spreadsheet (calls SpreadsheetApp.flush()). */
-    flush() {
-        SpreadsheetApp.flush();
-    }
-    /**
-     * Write the header row and all data rows in a single setValues() API call.
-     * Row 1 = headers, row 2+ = data.
-     *
-     * Used for newly-created sheets to avoid a separate setHeaders() round-trip.
-     */
-    writeAllRowsWithHeaders(headers, rows) {
-        const numCols = headers.length;
-        // Combine headers and data into one contiguous 2D array
-        const allRows = [headers, ...rows];
-        SheetOrmLogger.log(`[Sheet:${this.sheet.getName()}] writeAllRowsWithHeaders ${rows.length} data rows + header (${allRows.length} total)`);
-        this.sheet.getRange(1, 1, allRows.length, numCols).setValues(allRows);
-    }
-}
-//# sourceMappingURL=GoogleSheetAdapter.js.map

package/dist/npm/storage/GoogleSheetAdapter.js.map

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

package/dist/npm/storage/GoogleSpreadsheetAdapter.d.ts

@@ -1,65 +0,0 @@
-/**
- * Google Apps Script adapter implementing the ISpreadsheetAdapter interface.
- *
- * Wraps a GAS `Spreadsheet` object (the whole file) and provides
- * operations for creating, listing, and deleting individual sheet tabs.
- * Defaults to the active spreadsheet when no explicit Spreadsheet object
- * is supplied.
- *
- * @module GoogleSpreadsheetAdapter
- */
-import type { ISpreadsheetAdapter } from "../core/types/ISpreadsheetAdapter.js";
-import type { ISheetAdapter } from "../core/types/ISheetAdapter.js";
-/**
- * Production implementation of {@link ISpreadsheetAdapter} for Google Apps Script.
- * Each call that returns a sheet wraps it in a {@link GoogleSheetAdapter}.
- */
-export declare class GoogleSpreadsheetAdapter implements ISpreadsheetAdapter {
-    /** The wrapped GAS Spreadsheet object. */
-    private spreadsheet;
-    /**
-     * @param spreadsheet - Optional explicit Spreadsheet object.
-     *                       Falls back to `SpreadsheetApp.getActiveSpreadsheet()`
-     *                       when omitted (the common GAS use-case).
-     */
-    constructor(spreadsheet?: GoogleAppsScript.Spreadsheet.Spreadsheet);
-    /**
-     * Look up a sheet tab by name.
-     * @returns A wrapped adapter, or `null` if no sheet with that name exists.
-     */
-    getSheetByName(name: string): ISheetAdapter | null;
-    /**
-     * Get or create a sheet tab.  If a sheet with the given name already
-     * exists it is reused (idempotent).  Otherwise a new tab is inserted.
-     */
-    createSheet(name: string): ISheetAdapter;
-    /**
-     * Always insert a brand-new sheet tab (not idempotent).
-     * GAS throws if a sheet with the same name already exists.
-     */
-    insertSheet(name: string): ISheetAdapter;
-    /** Delete a sheet tab by name.  No-op if the sheet does not exist. */
-    deleteSheet(name: string): void;
-    /** Return an array of all sheet tab names in the spreadsheet. */
-    getSheetNames(): string[];
-    /** Return a Map of sheet name → adapter for every tab in the spreadsheet. */
-    getSheets(): Map<string, ISheetAdapter>;
-    /**
-     * Remove all sheets and leave a single empty "Sheet1" tab.
-     *
-     * GAS requires at least one sheet in a spreadsheet, so the first tab
-     * is kept, cleared, and renamed to "Sheet1" while all others are deleted.
-     */
-    removeAllSheets(): void;
-    /**
-     * Protect a sheet tab and restrict editing to the given email addresses.
-     *
-     * Uses the GAS `Protection` API to add a sheet-level protection.
-     * Existing editors (except the owner) are removed, and only the
-     * specified `editors` are granted edit access.
-     *
-     * No-op if the sheet does not exist.
-     */
-    protectSheet(name: string, editors: string[]): void;
-}
-//# sourceMappingURL=GoogleSpreadsheetAdapter.d.ts.map

package/dist/npm/storage/GoogleSpreadsheetAdapter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"GoogleSpreadsheetAdapter.d.ts","sourceRoot":"","sources":["../../../src/storage/GoogleSpreadsheetAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAIpE;;;GAGG;AACH,qBAAa,wBAAyB,YAAW,mBAAmB;IAClE,0CAA0C;IAC1C,OAAO,CAAC,WAAW,CAA2C;IAE9D;;;;OAIG;gBACS,WAAW,CAAC,EAAE,gBAAgB,CAAC,WAAW,CAAC,WAAW;IAIlE;;;OAGG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAMlD;;;OAGG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa;IAWxC;;;OAGG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa;IAMxC,sEAAsE;IACtE,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQ/B,iEAAiE;IACjE,aAAa,IAAI,MAAM,EAAE;IAIzB,6EAA6E;IAC7E,SAAS,IAAI,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC;IAQvC;;;;;OAKG;IACH,eAAe,IAAI,IAAI;IAcvB;;;;;;;;OAQG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI;CAUpD"}

package/dist/npm/storage/GoogleSpreadsheetAdapter.js

@@ -1,119 +0,0 @@
-/**
- * Google Apps Script adapter implementing the ISpreadsheetAdapter interface.
- *
- * Wraps a GAS `Spreadsheet` object (the whole file) and provides
- * operations for creating, listing, and deleting individual sheet tabs.
- * Defaults to the active spreadsheet when no explicit Spreadsheet object
- * is supplied.
- *
- * @module GoogleSpreadsheetAdapter
- */
-import { GoogleSheetAdapter } from "./GoogleSheetAdapter.js";
-import { SheetOrmLogger } from "../utils/SheetOrmLogger.js";
-/**
- * Production implementation of {@link ISpreadsheetAdapter} for Google Apps Script.
- * Each call that returns a sheet wraps it in a {@link GoogleSheetAdapter}.
- */
-export class GoogleSpreadsheetAdapter {
-    /**
-     * @param spreadsheet - Optional explicit Spreadsheet object.
-     *                       Falls back to `SpreadsheetApp.getActiveSpreadsheet()`
-     *                       when omitted (the common GAS use-case).
-     */
-    constructor(spreadsheet) {
-        this.spreadsheet = spreadsheet ?? SpreadsheetApp.getActiveSpreadsheet();
-    }
-    /**
-     * Look up a sheet tab by name.
-     * @returns A wrapped adapter, or `null` if no sheet with that name exists.
-     */
-    getSheetByName(name) {
-        const sheet = this.spreadsheet.getSheetByName(name);
-        SheetOrmLogger.log(`[Spreadsheet] getSheetByName("${name}") → ${sheet ? "found" : "null"}`);
-        return sheet ? new GoogleSheetAdapter(sheet) : null;
-    }
-    /**
-     * Get or create a sheet tab.  If a sheet with the given name already
-     * exists it is reused (idempotent).  Otherwise a new tab is inserted.
-     */
-    createSheet(name) {
-        const existing = this.spreadsheet.getSheetByName(name);
-        if (existing) {
-            SheetOrmLogger.log(`[Spreadsheet] createSheet("${name}") → reusing existing sheet`);
-            return new GoogleSheetAdapter(existing);
-        }
-        SheetOrmLogger.log(`[Spreadsheet] createSheet("${name}") → inserting new sheet`);
-        const sheet = this.spreadsheet.insertSheet(name);
-        return new GoogleSheetAdapter(sheet);
-    }
-    /**
-     * Always insert a brand-new sheet tab (not idempotent).
-     * GAS throws if a sheet with the same name already exists.
-     */
-    insertSheet(name) {
-        SheetOrmLogger.log(`[Spreadsheet] insertSheet("${name}")`);
-        const sheet = this.spreadsheet.insertSheet(name);
-        return new GoogleSheetAdapter(sheet);
-    }
-    /** Delete a sheet tab by name.  No-op if the sheet does not exist. */
-    deleteSheet(name) {
-        const sheet = this.spreadsheet.getSheetByName(name);
-        if (sheet) {
-            SheetOrmLogger.log(`[Spreadsheet] deleteSheet("${name}")`);
-            this.spreadsheet.deleteSheet(sheet);
-        }
-    }
-    /** Return an array of all sheet tab names in the spreadsheet. */
-    getSheetNames() {
-        return this.spreadsheet.getSheets().map((s) => s.getName());
-    }
-    /** Return a Map of sheet name → adapter for every tab in the spreadsheet. */
-    getSheets() {
-        const map = new Map();
-        for (const sheet of this.spreadsheet.getSheets()) {
-            map.set(sheet.getName(), new GoogleSheetAdapter(sheet));
-        }
-        return map;
-    }
-    /**
-     * Remove all sheets and leave a single empty "Sheet1" tab.
-     *
-     * GAS requires at least one sheet in a spreadsheet, so the first tab
-     * is kept, cleared, and renamed to "Sheet1" while all others are deleted.
-     */
-    removeAllSheets() {
-        const sheets = this.spreadsheet.getSheets();
-        SheetOrmLogger.log(`[Spreadsheet] removeAllSheets() → deleting ${sheets.length} sheet(s)`);
-        if (sheets.length === 0)
-            return;
-        // Keep the first sheet to satisfy the GAS one-sheet minimum requirement
-        const keeper = sheets[0];
-        for (let i = 1; i < sheets.length; i++) {
-            this.spreadsheet.deleteSheet(sheets[i]);
-        }
-        // Clear all content and rename to default
-        keeper.clear();
-        keeper.setName("Sheet1");
-    }
-    /**
-     * Protect a sheet tab and restrict editing to the given email addresses.
-     *
-     * Uses the GAS `Protection` API to add a sheet-level protection.
-     * Existing editors (except the owner) are removed, and only the
-     * specified `editors` are granted edit access.
-     *
-     * No-op if the sheet does not exist.
-     */
-    protectSheet(name, editors) {
-        const sheet = this.spreadsheet.getSheetByName(name);
-        if (!sheet)
-            return;
-        SheetOrmLogger.log(`[Spreadsheet] protectSheet("${name}") → editors: [${editors.join(", ")}]`);
-        const protection = sheet.protect().setDescription("Protected by SheetORM");
-        protection.removeEditors(protection.getEditors());
-        if (editors.length > 0) {
-            protection.addEditors(editors);
-        }
-    }
-}
-//# sourceMappingURL=GoogleSpreadsheetAdapter.js.map

package/dist/npm/storage/GoogleSpreadsheetAdapter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"GoogleSpreadsheetAdapter.js","sourceRoot":"","sources":["../../../src/storage/GoogleSpreadsheetAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D;;;GAGG;AACH,MAAM,OAAO,wBAAwB;IAInC;;;;OAIG;IACH,YAAY,WAAsD;QAChE,IAAI,CAAC,WAAW,GAAG,WAAW,IAAI,cAAc,CAAC,oBAAoB,EAAE,CAAC;IAC1E,CAAC;IAED;;;OAGG;IACH,cAAc,CAAC,IAAY;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QACpD,cAAc,CAAC,GAAG,CAAC,iCAAiC,IAAI,QAAQ,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QAC5F,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACtD,CAAC;IAED;;;OAGG;IACH,WAAW,CAAC,IAAY;QACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QACvD,IAAI,QAAQ,EAAE,CAAC;YACb,cAAc,CAAC,GAAG,CAAC,8BAA8B,IAAI,6BAA6B,CAAC,CAAC;YACpF,OAAO,IAAI,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QAC1C,CAAC;QACD,cAAc,CAAC,GAAG,CAAC,8BAA8B,IAAI,0BAA0B,CAAC,CAAC;QACjF,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACjD,OAAO,IAAI,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;IAED;;;OAGG;IACH,WAAW,CAAC,IAAY;QACtB,cAAc,CAAC,GAAG,CAAC,8BAA8B,IAAI,IAAI,CAAC,CAAC;QAC3D,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACjD,OAAO,IAAI,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;IAED,sEAAsE;IACtE,WAAW,CAAC,IAAY;QACtB,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QACpD,IAAI,KAAK,EAAE,CAAC;YACV,cAAc,CAAC,GAAG,CAAC,8BAA8B,IAAI,IAAI,CAAC,CAAC;YAC3D,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,iEAAiE;IACjE,aAAa;QACX,OAAO,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,6EAA6E;IAC7E,SAAS;QACP,MAAM,GAAG,GAAG,IAAI,GAAG,EAAyB,CAAC;QAC7C,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,EAAE,CAAC;YACjD,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC;QAC1D,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;;;OAKG;IACH,eAAe;QACb,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,CAAC;QAC5C,cAAc,CAAC,GAAG,CAAC,8CAA8C,MAAM,CAAC,MAAM,WAAW,CAAC,CAAC;QAC3F,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAChC,wEAAwE;QACxE,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1C,CAAC;QACD,0CAA0C;QAC1C,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC3B,CAAC;IAED;;;;;;;;OAQG;IACH,YAAY,CAAC,IAAY,EAAE,OAAiB;QAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QACpD,IAAI,CAAC,KAAK;YAAE,OAAO;QACnB,cAAc,CAAC,GAAG,CAAC,+BAA+B,IAAI,kBAAkB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/F,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,cAAc,CAAC,uBAAuB,CAAC,CAAC;QAC3E,UAAU,CAAC,aAAa,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC,CAAC;QAClD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;CACF"}

package/dist/npm/testing/ParityCatalog.d.ts

@@ -1,38 +0,0 @@
-/**
- * @module ParityCatalog
- *
- * Canonical catalog of every Jest test case that must also have a
- * corresponding runtime handler in {@link RuntimeParity}.
- *
- * The catalog is the single source of truth for parity validation:
- * - `SUITES` lists each test file and its test names.
- * - `CASE_IDS` is a flat array of composite IDs (`"file::testName"`).
- * - `toCaseId()` builds a composite ID from file + test name.
- *
- * Both Jest tests (via `parity-validator.test.ts`) and GAS runtime
- * tests (via `RuntimeParity.validate()`) cross-check against this
- * catalog to detect drift.
- */
-/** Describes a single Jest test file and its ordered list of test names. */
-interface ParitySuite {
-    file: string;
-    tests: string[];
-}
-/** Build a composite parity case ID from a test file name and test name. */
-declare function toParityCaseId(file: string, testName: string): string;
-/**
- * Public API for accessing the parity test catalog.
- *
- * Used by `parity-validator.test.ts` (Jest) and `RuntimeParity.validate()` (GAS)
- * to ensure that both environments define the same set of test cases.
- */
-export declare class ParityCatalog {
-    /** All suite definitions with test names. */
-    static readonly SUITES: ParitySuite[];
-    /** Flat array of composite case IDs. */
-    static readonly CASE_IDS: string[];
-    /** Utility to build a composite case ID. */
-    static toCaseId: typeof toParityCaseId;
-}
-export {};
-//# sourceMappingURL=ParityCatalog.d.ts.map

package/dist/npm/testing/ParityCatalog.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ParityCatalog.d.ts","sourceRoot":"","sources":["../../../src/testing/ParityCatalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,4EAA4E;AAC5E,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAmXD,4EAA4E;AAC5E,iBAAS,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE9D;AAOD;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,6CAA6C;IAC7C,MAAM,CAAC,QAAQ,CAAC,MAAM,gBAAiB;IACvC,wCAAwC;IACxC,MAAM,CAAC,QAAQ,CAAC,QAAQ,WAAmB;IAC3C,4CAA4C;IAC5C,MAAM,CAAC,QAAQ,wBAAkB;CAClC"}