@b2bc-devkit/sheetorm 1.1.0 → 1.2.3

package/dist/npm/utils/Serialization.js

@@ -1,281 +0,0 @@
-/**
- * Serialization utilities for converting between entity objects and Google Sheet rows.
- *
- * This module handles the bidirectional mapping:
- *   Entity object ←→ sheet row (unknown[])
- *
- * Each conversion is type-aware: when a FieldDefinition carries an explicit `type`,
- * the value is coerced accordingly. When type is omitted, the serializer infers
- * the best representation from the JavaScript runtime type.
- *
- * @module Serialization
- */
-import { SystemColumns } from "../core/types/SystemColumns.js";
-/**
- * Serialize a single field value for storage in a Google Sheet cell.
- *
- * Conversion rules by FieldType:
- *   - "string" / "reference" → String()
- *   - "number"  → Number(); non-finite values become empty string
- *   - "boolean" → true/false; strings "true"/"1"/"yes" are truthy
- *   - "date"    → ISO 8601 string; invalid Date → empty string
- *   - "json"    → JSON.stringify()
- *
- * When fieldDef.type is undefined, the JS runtime type is inspected
- * (number, boolean, Date, object → JSON, else String).
- *
- * @param value    - The entity field value to serialize.
- * @param fieldDef - Field metadata (type, name, etc.).
- * @returns A cell-safe value (string, number, or boolean).
- */
-function serializeValue(value, fieldDef) {
-    // Null / undefined → empty cell
-    if (value === null || value === undefined)
-        return "";
-    // --- Explicit type branch ---
-    if (fieldDef.type) {
-        switch (fieldDef.type) {
-            case "string":
-            case "reference":
-                return String(value);
-            case "number": {
-                // Accept numeric values directly; coerce strings to numbers
-                if (typeof value === "number")
-                    return Number.isFinite(value) ? value : "";
-                const num = Number(value);
-                return Number.isFinite(num) ? num : "";
-            }
-            case "boolean": {
-                // Accept booleans directly; coerce numbers and strings
-                if (typeof value === "boolean")
-                    return value;
-                if (typeof value === "number")
-                    return !isNaN(value) && value !== 0;
-                const lower = typeof value === "string" ? value.toLowerCase().trim() : "";
-                return lower === "true" || lower === "1" || lower === "yes";
-            }
-            case "date":
-                // Dates are stored as ISO 8601 strings; invalid dates become empty
-                if (value instanceof Date)
-                    return isNaN(value.getTime()) ? "" : value.toISOString();
-                return String(value);
-            case "json":
-                // Arbitrary structures are JSON-stringified for cell storage
-                return JSON.stringify(value);
-            default:
-                return String(value);
-        }
-    }
-    // --- Auto-infer branch (no explicit type) ---
-    if (typeof value === "number")
-        return value;
-    if (typeof value === "boolean")
-        return value;
-    if (value instanceof Date)
-        return isNaN(value.getTime()) ? "" : value.toISOString();
-    if (typeof value === "object")
-        return JSON.stringify(value);
-    return String(value);
-}
-/**
- * Deserialize a cell value read from a Google Sheet into a typed JavaScript value.
- *
- * Empty / null cells return the field's defaultValue (or null if none is defined).
- * Conversion mirrors serializeValue in reverse:
- *   - "number"   → Number(); non-finite → null
- *   - "boolean"  → true/false from various truthy representations
- *   - "date"     → ISO string (Date objects are converted)
- *   - "json"     → JSON.parse(); malformed JSON → null
- *   - "string" / "reference" → String()
- *
- * When fieldDef.type is undefined, the raw cell value is returned as-is,
- * trusting the Google Sheets storage layer to preserve JavaScript types.
- *
- * @param cellValue - Raw value read from the sheet cell.
- * @param fieldDef  - Field metadata describing the expected type.
- * @returns The deserialized JavaScript value.
- */
-function deserializeValue(cellValue, fieldDef) {
-    // Empty cell → use default or null
-    if (cellValue === "" || cellValue === null || cellValue === undefined) {
-        return fieldDef.defaultValue ?? null;
-    }
-    // --- Explicit type branch ---
-    if (fieldDef.type) {
-        switch (fieldDef.type) {
-            case "string":
-            case "reference":
-                return String(cellValue);
-            case "number": {
-                const num = Number(cellValue);
-                return Number.isFinite(num) ? num : null;
-            }
-            case "boolean":
-                // Accept native booleans, numbers, and truthy strings
-                if (typeof cellValue === "boolean")
-                    return cellValue;
-                if (typeof cellValue === "number")
-                    return !isNaN(cellValue) && cellValue !== 0;
-                if (typeof cellValue === "string") {
-                    const lower = cellValue.toLowerCase().trim();
-                    return lower === "true" || lower === "1" || lower === "yes";
-                }
-                return Boolean(cellValue);
-            case "date":
-                // Normalise GAS Date objects to ISO strings
-                if (cellValue instanceof Date)
-                    return isNaN(cellValue.getTime()) ? null : cellValue.toISOString();
-                return String(cellValue);
-            case "json":
-                // Parse JSON-stringified cell; return null on malformed input
-                if (typeof cellValue === "string" && cellValue.length > 0) {
-                    try {
-                        return JSON.parse(cellValue);
-                    }
-                    catch {
-                        return null;
-                    }
-                }
-                return cellValue;
-            default:
-                return cellValue;
-        }
-    }
-    // Auto: trust storage layer to return the correct JS type
-    return cellValue;
-}
-/**
- * Build the complete header row for a SheetORM table.
- *
- * Layout: `[__id, __createdAt, __updatedAt, ...userFields]`.
- * This order is assumed by entityToRow / rowToEntity and must remain stable.
- *
- * @param fields - User-defined field definitions (from decorators).
- * @returns An array of column header strings.
- */
-function buildHeaders(fields) {
-    // System columns always occupy the first three positions
-    return [SystemColumns.ID, SystemColumns.CREATED_AT, SystemColumns.UPDATED_AT, ...fields.map((f) => f.name)];
-}
-/**
- * Convert an entity object into a row array matching the header order.
- *
- * The resulting array can be passed directly to ISheetAdapter.appendRow()
- * or updateRow(). System columns are placed first, followed by user
- * fields in the same order as the header row.
- *
- * @param entity   - The entity to serialise.
- * @param fields   - User-defined field definitions.
- * @param headers  - Full header row (system + user columns).
- * @param fieldMap - Optional pre-built name→FieldDefinition map for O(1) lookup.
- *                   When omitted, falls back to linear scan (fine for <20 fields).
- * @returns An unknown[] row array ready to be written to the sheet.
- */
-function entityToRow(entity, fields, headers, fieldMap) {
-    const len = headers.length;
-    const row = new Array(len);
-    // Use provided fieldMap or fall back to linear scan for small field lists
-    const useMap = fieldMap !== undefined;
-    for (let i = 0; i < len; i++) {
-        const col = headers[i];
-        // System columns are handled directly (no serialization needed)
-        if (col === SystemColumns.ID) {
-            row[i] = entity.__id;
-        }
-        else if (col === SystemColumns.CREATED_AT) {
-            row[i] = entity.__createdAt ?? "";
-        }
-        else if (col === SystemColumns.UPDATED_AT) {
-            row[i] = entity.__updatedAt ?? "";
-        }
-        else {
-            // User field: look up the definition and serialize the value
-            const fieldDef = useMap ? fieldMap.get(col) : fields.find((f) => f.name === col);
-            if (fieldDef) {
-                row[i] = serializeValue(entity[col], fieldDef);
-            }
-            else {
-                // Unknown column — pass through raw value (defensive, shouldn't happen normally)
-                row[i] = entity[col] ?? "";
-            }
-        }
-    }
-    return row;
-}
-/**
- * Convert a sheet row array back into a typed entity object.
- *
- * Iterates over the header columns and deserializes each cell value
- * into the appropriate JS type.
- *
- * @param row      - Raw row data from ISheetAdapter.getAllData().
- * @param headers  - Full header row (system + user columns).
- * @param fields   - User-defined field definitions.
- * @param fieldMap - Optional pre-built name→FieldDefinition map for O(1) lookup.
- * @returns A fully hydrated entity object of type T.
- */
-function rowToEntity(row, headers, fields, fieldMap) {
-    const entity = {};
-    // Use provided fieldMap or fall back to linear scan for small field lists
-    const useMap = fieldMap !== undefined;
-    const rowLen = row.length;
-    for (let i = 0, len = headers.length; i < len; i++) {
-        const col = headers[i];
-        // Guard against short rows (missing trailing columns)
-        const cellValue = i < rowLen ? row[i] : "";
-        if (col === SystemColumns.ID) {
-            // __id is always stored as a string
-            entity.__id = String(cellValue);
-        }
-        else if (col === SystemColumns.CREATED_AT) {
-            // GAS may return a Date object; normalise to ISO string
-            entity.__createdAt =
-                cellValue instanceof Date
-                    ? cellValue.toISOString()
-                    : cellValue !== "" && cellValue !== null && cellValue !== undefined
-                        ? String(cellValue)
-                        : undefined;
-        }
-        else if (col === SystemColumns.UPDATED_AT) {
-            entity.__updatedAt =
-                cellValue instanceof Date
-                    ? cellValue.toISOString()
-                    : cellValue !== "" && cellValue !== null && cellValue !== undefined
-                        ? String(cellValue)
-                        : undefined;
-        }
-        else {
-            // User field: deserialize using the matching FieldDefinition
-            const fieldDef = useMap ? fieldMap.get(col) : fields.find((f) => f.name === col);
-            if (fieldDef) {
-                entity[col] = deserializeValue(cellValue, fieldDef);
-            }
-            else {
-                // Unknown column — keep raw value (defensive)
-                entity[col] = cellValue;
-            }
-        }
-    }
-    return entity;
-}
-/**
- * Public serialization utility class.
- *
- * Wraps five static methods that handle the Entity ←→ row conversion:
- * - serializeValue / deserializeValue — single-field level
- * - buildHeaders — construct the header row
- * - entityToRow / rowToEntity — full entity conversion
- */
-export class Serialization {
-}
-/** Serialize a single field value for cell storage. */
-Serialization.serializeValue = serializeValue;
-/** Deserialize a single cell value back to a JS value. */
-Serialization.deserializeValue = deserializeValue;
-/** Build the full header row (system + user columns). */
-Serialization.buildHeaders = buildHeaders;
-/** Convert an entity to a sheet row array. */
-Serialization.entityToRow = entityToRow;
-/** Convert a sheet row array to an entity object. */
-Serialization.rowToEntity = rowToEntity;
-//# sourceMappingURL=Serialization.js.map

package/dist/npm/utils/Serialization.js.map

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

package/dist/npm/utils/SheetOrmLogger.d.ts

@@ -1,31 +0,0 @@
-/**
- * Lightweight, globally togglable logger for SheetORM internals.
- *
- * When {@link verbose} is `true`, every log call is forwarded to either
- * the Google Apps Script `Logger` (when running inside GAS) or `console.log`
- * (when running in Node / Jest / browser).
- *
- * Usage from a GAS script:
- * ```ts
- * SheetORM.SheetOrmLogger.verbose = true;
- * GasEntrypoints.runBenchmark();
- * ```
- *
- * All SheetORM subsystems (GoogleSheetAdapter, SheetRepository, IndexStore,
- * MemoryCache) emit structured log lines through this class, e.g.:
- *   `[Cache] HIT "tbl_Cars"`, `[Adapter] getAllData "idx_Cars" → 42 rows`.
- */
-export declare class SheetOrmLogger {
-    /**
-     * Master switch for verbose logging.
-     * Set to `true` before any ORM operation to capture detailed traces.
-     */
-    static verbose: boolean;
-    /**
-     * Emit a log message if verbose mode is enabled.
-     *
-     * @param msg - Human-readable message (typically prefixed with a subsystem tag).
-     */
-    static log(msg: string): void;
-}
-//# sourceMappingURL=SheetOrmLogger.d.ts.map

package/dist/npm/utils/SheetOrmLogger.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SheetOrmLogger.d.ts","sourceRoot":"","sources":["../../../src/utils/SheetOrmLogger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,cAAc;IACzB;;;OAGG;IACH,MAAM,CAAC,OAAO,EAAE,OAAO,CAAS;IAEhC;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;CAW9B"}

package/dist/npm/utils/SheetOrmLogger.js

@@ -1,42 +0,0 @@
-/**
- * Lightweight, globally togglable logger for SheetORM internals.
- *
- * When {@link verbose} is `true`, every log call is forwarded to either
- * the Google Apps Script `Logger` (when running inside GAS) or `console.log`
- * (when running in Node / Jest / browser).
- *
- * Usage from a GAS script:
- * ```ts
- * SheetORM.SheetOrmLogger.verbose = true;
- * GasEntrypoints.runBenchmark();
- * ```
- *
- * All SheetORM subsystems (GoogleSheetAdapter, SheetRepository, IndexStore,
- * MemoryCache) emit structured log lines through this class, e.g.:
- *   `[Cache] HIT "tbl_Cars"`, `[Adapter] getAllData "idx_Cars" → 42 rows`.
- */
-export class SheetOrmLogger {
-    /**
-     * Emit a log message if verbose mode is enabled.
-     *
-     * @param msg - Human-readable message (typically prefixed with a subsystem tag).
-     */
-    static log(msg) {
-        // Short-circuit when verbose logging is off (zero overhead in production)
-        if (!SheetOrmLogger.verbose)
-            return;
-        // Use GAS Logger when available, fall back to console.log in test / Node environments
-        if (typeof Logger !== "undefined" && typeof Logger.log === "function") {
-            Logger.log(msg);
-        }
-        else {
-            console.log(msg);
-        }
-    }
-}
-/**
- * Master switch for verbose logging.
- * Set to `true` before any ORM operation to capture detailed traces.
- */
-SheetOrmLogger.verbose = false;
-//# sourceMappingURL=SheetOrmLogger.js.map

package/dist/npm/utils/SheetOrmLogger.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"SheetOrmLogger.js","sourceRoot":"","sources":["../../../src/utils/SheetOrmLogger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,cAAc;IAOzB;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,GAAW;QACpB,0EAA0E;QAC1E,IAAI,CAAC,cAAc,CAAC,OAAO;YAAE,OAAO;QAEpC,sFAAsF;QACtF,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,MAAM,CAAC,GAAG,KAAK,UAAU,EAAE,CAAC;YACtE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClB,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;;AArBD;;;GAGG;AACI,sBAAO,GAAY,KAAK,CAAC"}

package/dist/npm/utils/Uuid.d.ts

@@ -1,29 +0,0 @@
-/**
- * UUID v4 generation with a three-tier fallback strategy:
- *
- * 1. **GAS Utilities.getUuid()** — native, crypto-safe, fastest in Apps Script.
- * 2. **Web Crypto API (globalThis.crypto)** — available in Node 19+, browsers,
- *    Deno, Bun, and other modern runtimes.
- * 3. **Math.random()** — last resort; not cryptographically secure but
- *    adequate for non-security-critical record identifiers in dev/test.
- *
- * All generated UUIDs conform to RFC 4122 v4 (random).
- */
-/**
- * Generate a RFC 4122 v4 (random) UUID string.
- *
- * @returns A lowercase UUID in the canonical `xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx` format.
- */
-declare function generateUUID(): string;
-/**
- * Public UUID utility class.
- *
- * Exposes a single static method `generate()` that returns a new UUID v4 string.
- * Wrapped in a class to follow the SheetORM one-export-per-file convention.
- */
-export declare class Uuid {
-    /** Generate a new RFC 4122 v4 UUID string. */
-    static generate: typeof generateUUID;
-}
-export {};
-//# sourceMappingURL=Uuid.d.ts.map

package/dist/npm/utils/Uuid.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Uuid.d.ts","sourceRoot":"","sources":["../../../src/utils/Uuid.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAoBH;;;;GAIG;AACH,iBAAS,YAAY,IAAI,MAAM,CAqD9B;AAED;;;;;GAKG;AACH,qBAAa,IAAI;IACf,8CAA8C;IAC9C,MAAM,CAAC,QAAQ,sBAAgB;CAChC"}

package/dist/npm/utils/Uuid.js

@@ -1,86 +0,0 @@
-/**
- * UUID v4 generation with a three-tier fallback strategy:
- *
- * 1. **GAS Utilities.getUuid()** — native, crypto-safe, fastest in Apps Script.
- * 2. **Web Crypto API (globalThis.crypto)** — available in Node 19+, browsers,
- *    Deno, Bun, and other modern runtimes.
- * 3. **Math.random()** — last resort; not cryptographically secure but
- *    adequate for non-security-critical record identifiers in dev/test.
- *
- * All generated UUIDs conform to RFC 4122 v4 (random).
- */
-/**
- * Pre-computed lookup table mapping byte values (0–255) to their two-character
- * hexadecimal representations. Avoids per-byte toString(16) + padStart calls
- * during UUID formatting.
- */
-const HEX = new Array(256);
-for (let i = 0; i < 256; i++) {
-    // (i + 0x100) produces a 3-char hex string; substring(1) drops the leading "1"
-    HEX[i] = (i + 0x100).toString(16).substring(1);
-}
-/**
- * Generate a RFC 4122 v4 (random) UUID string.
- *
- * @returns A lowercase UUID in the canonical `xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx` format.
- */
-function generateUUID() {
-    // --- Tier 1: GAS native UUID ---
-    // Google Apps Script V8 runtime exposes Utilities.getUuid(), which delegates
-    // to Java's java.util.UUID.randomUUID() — crypto-safe and zero-overhead.
-    if (typeof Utilities !== "undefined" && typeof Utilities.getUuid === "function") {
-        return Utilities.getUuid();
-    }
-    // --- Tier 2 & 3: manual RFC 4122 v4 construction ---
-    // Allocate 16 random bytes (128 bits); 6 bits are then overwritten for version/variant.
-    const r = new Uint8Array(16);
-    // Attempt to fill with crypto-safe random values via Web Crypto API
-    const globalHost = globalThis;
-    const g = typeof globalThis !== "undefined" ? globalHost.crypto : undefined;
-    if (g && typeof g.getRandomValues === "function") {
-        // Tier 2: Web Crypto (Node 19+, browsers, Deno)
-        g.getRandomValues(r);
-    }
-    else {
-        // Tier 3: Math.random fallback (non-crypto, dev/test only)
-        for (let i = 0; i < 16; i++) {
-            r[i] = (Math.random() * 256) | 0;
-        }
-    }
-    // Set the version nibble (bits 48–51) to 0100 → UUID version 4
-    r[6] = (r[6] & 0x0f) | 0x40;
-    // Set the variant bits (bits 64–65) to 10 → RFC 4122 variant
-    r[8] = (r[8] & 0x3f) | 0x80;
-    // Format as canonical UUID string: 8-4-4-4-12 hexadecimal characters
-    return (HEX[r[0]] +
-        HEX[r[1]] +
-        HEX[r[2]] +
-        HEX[r[3]] +
-        "-" +
-        HEX[r[4]] +
-        HEX[r[5]] +
-        "-" +
-        HEX[r[6]] +
-        HEX[r[7]] +
-        "-" +
-        HEX[r[8]] +
-        HEX[r[9]] +
-        "-" +
-        HEX[r[10]] +
-        HEX[r[11]] +
-        HEX[r[12]] +
-        HEX[r[13]] +
-        HEX[r[14]] +
-        HEX[r[15]]);
-}
-/**
- * Public UUID utility class.
- *
- * Exposes a single static method `generate()` that returns a new UUID v4 string.
- * Wrapped in a class to follow the SheetORM one-export-per-file convention.
- */
-export class Uuid {
-}
-/** Generate a new RFC 4122 v4 UUID string. */
-Uuid.generate = generateUUID;
-//# sourceMappingURL=Uuid.js.map

package/dist/npm/utils/Uuid.js.map

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