genjutsu-db 0.1.0

package/dist/client.js

@@ -0,0 +1,370 @@
+/**
+ * Client factory for the genjutsu-db library.
+ * Creates a schema-driven client with typed repositories.
+ */
+import { extractSpreadsheetId, getSheetValues, updateSheet, clearRange, batchClear, batchUpdate, getSpreadsheetMetadata, structuralBatchUpdate, } from "./transport";
+import { schemaError, permissionError, validationError } from "./errors";
+import { validateForeignKeys, loadRelated } from "./relations";
+const RESERVED_SHEET_NAMES = ["_genjutsu_migrations"];
+export function createClient(config) {
+    // Validate config
+    if (!config.spreadsheetId) {
+        throw schemaError("spreadsheetId must be non-empty");
+    }
+    if (!config.auth && !config.apiKey) {
+        throw schemaError("Either auth or apiKey must be provided");
+    }
+    const schemas = config.schemas;
+    if (!schemas || Object.keys(schemas).length === 0) {
+        throw schemaError("At least one schema must be registered");
+    }
+    // Validate schemas at creation time
+    const sheetNames = new Set();
+    for (const [key, schema] of Object.entries(schemas)) {
+        if (!schema.sheetName) {
+            throw schemaError(`Schema "${key}" has empty sheetName`);
+        }
+        if (!schema.headers || schema.headers.length === 0) {
+            throw schemaError(`Schema "${key}" has empty headers`);
+        }
+        if (sheetNames.has(schema.sheetName)) {
+            throw schemaError(`Duplicate sheetName "${schema.sheetName}" in schemas`);
+        }
+        if (RESERVED_SHEET_NAMES.includes(schema.sheetName)) {
+            throw schemaError(`Schema "${key}" uses reserved sheet name "${schema.sheetName}"`);
+        }
+        sheetNames.add(schema.sheetName);
+        // Validate FK target models exist in schemas
+        if (schema.relations) {
+            for (const rel of schema.relations) {
+                if (!schemas[rel.targetModel]) {
+                    throw schemaError(`Schema "${key}" references model "${rel.targetModel}" which is not registered`);
+                }
+            }
+        }
+    }
+    const ctx = {
+        auth: config.auth,
+        apiKey: config.apiKey,
+        spreadsheetId: config.spreadsheetId,
+    };
+    const isReadOnly = !config.auth;
+    function assertWritable() {
+        if (isReadOnly) {
+            throw permissionError("Write operations require auth. This client was created with apiKey only (read-only).");
+        }
+    }
+    // Write mutex: serializes all write operations
+    let writeLock = Promise.resolve();
+    function withWriteLock(fn) {
+        const prev = writeLock;
+        let resolve;
+        writeLock = new Promise((r) => {
+            resolve = r;
+        });
+        return prev.then(fn).finally(() => resolve());
+    }
+    // Build a generic repository for a single schema
+    function buildRepo(schema, _allSchemas) {
+        return {
+            async create(record, options) {
+                assertWritable();
+                return withWriteLock(async () => {
+                    // Apply defaults from field definitions
+                    const entity = applyDefaults(schema, record);
+                    // Validate
+                    if (schema.validate)
+                        schema.validate(entity);
+                    // Check duplicate PK
+                    if (schema.primaryKey) {
+                        const existing = await readAllRaw(schema);
+                        const pk = schema.primaryKey;
+                        const pkValue = entity[pk];
+                        const duplicate = existing.find((e) => e[pk] === pkValue);
+                        if (duplicate) {
+                            throw validationError(`Duplicate primary key: ${String(pkValue)}`, [
+                                { field: pk, message: "Duplicate primary key", value: pkValue },
+                            ]);
+                        }
+                    }
+                    // FK validation
+                    if (!options?.skipFkValidation) {
+                        await validateForeignKeys(entity, schema, schemas, ctx);
+                    }
+                    // Ensure headers exist before first append
+                    const rawRows = await getSheetValues(ctx, schema.writeRange, "FORMATTED_VALUE");
+                    if (rawRows.length === 0) {
+                        // Sheet is empty — write headers first
+                        await updateSheet(ctx, schema.writeRange, [schema.headers], false);
+                    }
+                    // Append single row
+                    const values = [schema.toRow(entity)];
+                    await updateSheet(ctx, schema.writeRange, values, true);
+                    return entity;
+                });
+            },
+            async findById(id) {
+                if (!schema.primaryKey)
+                    return null;
+                const records = await readAllRaw(schema);
+                const pk = schema.primaryKey;
+                return (records.find((r) => r[pk] === id) ?? null);
+            },
+            async findMany(filter, options) {
+                let records = await readAllRaw(schema);
+                if (filter)
+                    records = records.filter(filter);
+                if (options?.include) {
+                    records = await loadRelated(records, schema, options.include, schemas, ctx);
+                }
+                return records;
+            },
+            async update(id, changes, options) {
+                assertWritable();
+                return withWriteLock(async () => {
+                    const records = await readAllRaw(schema);
+                    if (!schema.primaryKey) {
+                        throw validationError("Cannot update without a primary key", []);
+                    }
+                    const pk = schema.primaryKey;
+                    const index = records.findIndex((r) => r[pk] === id);
+                    if (index === -1) {
+                        throw validationError(`Record not found: ${String(id)}`, [
+                            { field: pk, message: "Record not found", value: id },
+                        ]);
+                    }
+                    const merged = { ...records[index], ...changes };
+                    if (schema.validate)
+                        schema.validate(merged);
+                    // FK validation on changed fields
+                    if (!options?.skipFkValidation) {
+                        const changedFields = new Set(Object.keys(changes));
+                        await validateForeignKeys(merged, schema, schemas, ctx, changedFields);
+                    }
+                    records[index] = merged;
+                    // Rewrite all records
+                    const values = [schema.headers];
+                    for (const r of records)
+                        values.push(schema.toRow(r));
+                    await clearRange(ctx, schema.clearRange);
+                    await updateSheet(ctx, schema.writeRange, values, false);
+                    return merged;
+                });
+            },
+            async delete(id) {
+                assertWritable();
+                return withWriteLock(async () => {
+                    if (!schema.primaryKey)
+                        return;
+                    const records = await readAllRaw(schema);
+                    const pk = schema.primaryKey;
+                    const filtered = records.filter((r) => r[pk] !== id);
+                    const values = [schema.headers];
+                    for (const r of filtered)
+                        values.push(schema.toRow(r));
+                    await clearRange(ctx, schema.clearRange);
+                    await updateSheet(ctx, schema.writeRange, values, false);
+                });
+            },
+            async readAll(options) {
+                let records = await readAllRaw(schema);
+                if (options?.include) {
+                    records = await loadRelated(records, schema, options.include, schemas, ctx);
+                }
+                return records;
+            },
+            writeAll(records) {
+                assertWritable();
+                return withWriteLock(async () => {
+                    if (schema.validate) {
+                        for (const r of records)
+                            schema.validate(r);
+                    }
+                    const values = [schema.headers];
+                    for (const r of records)
+                        values.push(schema.toRow(r));
+                    await clearRange(ctx, schema.clearRange);
+                    if (values.length > 0) {
+                        await updateSheet(ctx, schema.writeRange, values, false);
+                    }
+                });
+            },
+            append(records) {
+                assertWritable();
+                if (schema.appendSupported === false) {
+                    return Promise.reject(schemaError(`Append not supported for "${schema.sheetName}"`));
+                }
+                return withWriteLock(async () => {
+                    if (schema.validate) {
+                        for (const r of records)
+                            schema.validate(r);
+                    }
+                    // Ensure headers exist before first append
+                    const rawRows = await getSheetValues(ctx, schema.writeRange, "FORMATTED_VALUE");
+                    if (rawRows.length === 0) {
+                        await updateSheet(ctx, schema.writeRange, [schema.headers], false);
+                    }
+                    const values = records.map((r) => schema.toRow(r));
+                    await updateSheet(ctx, schema.writeRange, values, true);
+                });
+            },
+        };
+    }
+    async function readAllRaw(schema) {
+        const rows = await getSheetValues(ctx, schema.readRange, "UNFORMATTED_VALUE");
+        const results = [];
+        for (let i = 0; i < rows.length; i++) {
+            const entity = schema.parseRow(rows[i], i);
+            if (entity != null)
+                results.push(entity);
+        }
+        return results;
+    }
+    function applyDefaults(schema, record) {
+        if (!schema.fields)
+            return record;
+        const result = { ...record };
+        for (const field of schema.fields) {
+            if (result[field.name] === undefined && field.defaultValue !== undefined) {
+                result[field.name] = field.defaultValue;
+            }
+        }
+        return result;
+    }
+    // Pre-build all repositories
+    const repos = {};
+    for (const [key, schema] of Object.entries(schemas)) {
+        repos[key] = buildRepo(schema, schemas);
+    }
+    return {
+        repo(key) {
+            return repos[key];
+        },
+        batchSync(payload) {
+            assertWritable();
+            return withWriteLock(async () => {
+                const clearRanges = [];
+                const data = [];
+                for (const [key, schema] of Object.entries(schemas)) {
+                    clearRanges.push(schema.clearRange);
+                    const records = payload[key] ?? [];
+                    const values = [schema.headers];
+                    for (const r of records) {
+                        values.push(schema.toRow(r));
+                    }
+                    data.push({ range: schema.writeRange, values });
+                }
+                await batchClear(ctx, clearRanges);
+                await batchUpdate(ctx, data);
+            });
+        },
+        async ensureSchema() {
+            const metadata = await getSpreadsheetMetadata(ctx);
+            const titles = new Set(metadata.sheets.map((s) => s.title));
+            const toAdd = Object.values(schemas)
+                .map((s) => s.sheetName)
+                .filter((t) => !titles.has(t));
+            if (toAdd.length === 0)
+                return;
+            await structuralBatchUpdate(ctx, toAdd.map((title) => ({
+                addSheet: { properties: { title } },
+            })));
+        },
+        async applyFormatting() {
+            const hasAnyFormatting = Object.values(schemas).some((s) => (s.formatting && s.formatting.length > 0) || s.headerFormatting);
+            if (!hasAnyFormatting)
+                return;
+            const metadata = await getSpreadsheetMetadata(ctx);
+            const sheetIdMap = new Map();
+            for (const s of metadata.sheets) {
+                sheetIdMap.set(s.title, s.sheetId);
+            }
+            const requests = [];
+            for (const schema of Object.values(schemas)) {
+                const sheetId = sheetIdMap.get(schema.sheetName);
+                if (sheetId == null)
+                    continue;
+                // Header formatting
+                if (schema.headerFormatting) {
+                    const hf = schema.headerFormatting;
+                    const cellFormat = {};
+                    const fields = [];
+                    if (hf.bold || hf.fontSize) {
+                        cellFormat.textFormat = {
+                            ...(hf.bold != null ? { bold: hf.bold } : {}),
+                            ...(hf.fontSize != null ? { fontSize: hf.fontSize } : {}),
+                        };
+                        fields.push("userEnteredFormat.textFormat");
+                    }
+                    if (hf.horizontalAlignment) {
+                        cellFormat.horizontalAlignment = hf.horizontalAlignment;
+                        fields.push("userEnteredFormat.horizontalAlignment");
+                    }
+                    if (fields.length > 0) {
+                        requests.push({
+                            repeatCell: {
+                                range: {
+                                    sheetId,
+                                    startRowIndex: 0,
+                                    endRowIndex: 1,
+                                    startColumnIndex: 0,
+                                    endColumnIndex: schema.headers.length,
+                                },
+                                cell: { userEnteredFormat: cellFormat },
+                                fields: fields.join(","),
+                            },
+                        });
+                    }
+                }
+                // Data formatting rules
+                if (schema.formatting) {
+                    for (const rule of schema.formatting) {
+                        const cellFormat = {};
+                        const fields = [];
+                        if (rule.bold || rule.fontSize) {
+                            cellFormat.textFormat = {
+                                ...(rule.bold != null ? { bold: rule.bold } : {}),
+                                ...(rule.fontSize != null ? { fontSize: rule.fontSize } : {}),
+                            };
+                            fields.push("userEnteredFormat.textFormat");
+                        }
+                        if (rule.horizontalAlignment) {
+                            cellFormat.horizontalAlignment = rule.horizontalAlignment;
+                            fields.push("userEnteredFormat.horizontalAlignment");
+                        }
+                        if (rule.numberFormat) {
+                            cellFormat.numberFormat = rule.numberFormat;
+                            fields.push("userEnteredFormat.numberFormat");
+                        }
+                        if (fields.length > 0) {
+                            requests.push({
+                                repeatCell: {
+                                    range: {
+                                        sheetId,
+                                        startRowIndex: rule.startRow ?? 1,
+                                        endRowIndex: rule.endRow ?? 10000,
+                                        startColumnIndex: rule.startCol,
+                                        endColumnIndex: rule.endCol,
+                                    },
+                                    cell: { userEnteredFormat: cellFormat },
+                                    fields: fields.join(","),
+                                },
+                            });
+                        }
+                    }
+                }
+            }
+            if (requests.length === 0)
+                return;
+            await structuralBatchUpdate(ctx, requests);
+        },
+        async migrate(_migrations) {
+            assertWritable();
+            // Stub — full implementation in src/migrations.ts (Phase 6)
+            const { runMigrations } = await import("./migrations");
+            await runMigrations(ctx, _migrations);
+        },
+        extractSpreadsheetId,
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Typed error handling for the genjutsu-db library.
+ */
+export type GenjutsuErrorKind = "AUTH_ERROR" | "PERMISSION_ERROR" | "RATE_LIMIT" | "NETWORK_ERROR" | "VALIDATION_ERROR" | "SCHEMA_ERROR" | "MIGRATION_ERROR" | "API_ERROR";
+export interface ValidationIssue {
+    field: string;
+    message: string;
+    value?: unknown;
+}
+export declare class GenjutsuError extends Error {
+    readonly kind: GenjutsuErrorKind;
+    readonly cause?: unknown;
+    readonly retryAfterMs?: number;
+    readonly validationIssues?: ValidationIssue[];
+    readonly migrationVersion?: number;
+    readonly migrationName?: string;
+    constructor(kind: GenjutsuErrorKind, message: string, options?: {
+        cause?: unknown;
+        retryAfterMs?: number;
+        validationIssues?: ValidationIssue[];
+        migrationVersion?: number;
+        migrationName?: string;
+    });
+}
+/** @deprecated Use GenjutsuError instead */
+export declare const SheetsDbError: typeof GenjutsuError;
+export declare function isGenjutsuError(err: unknown): err is GenjutsuError;
+/** @deprecated Use isGenjutsuError instead */
+export declare const isSheetsDbError: typeof isGenjutsuError;
+export declare function authError(message: string, cause?: unknown): GenjutsuError;
+export declare function permissionError(message: string, cause?: unknown): GenjutsuError;
+export declare function rateLimitError(message: string, retryAfterMs?: number, cause?: unknown): GenjutsuError;
+export declare function networkError(message: string, cause?: unknown): GenjutsuError;
+export declare function validationError(message: string, issues: ValidationIssue[]): GenjutsuError;
+export declare function schemaError(message: string, cause?: unknown): GenjutsuError;
+export declare function migrationError(message: string, version: number, name: string, cause?: unknown): GenjutsuError;
+export declare function apiError(message: string, cause?: unknown): GenjutsuError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,iBAAiB,GACzB,YAAY,GACZ,kBAAkB,GAClB,YAAY,GACZ,eAAe,GACf,kBAAkB,GAClB,cAAc,GACd,iBAAiB,GACjB,WAAW,CAAC;AAEhB,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;IAC9C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;gBAG9B,IAAI,EAAE,iBAAiB,EACvB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;QACrC,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB;CAWJ;AAED,4CAA4C;AAC5C,eAAO,MAAM,aAAa,sBAAgB,CAAC;AAE3C,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,aAAa,CAElE;AAED,8CAA8C;AAC9C,eAAO,MAAM,eAAe,wBAAkB,CAAC;AAE/C,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,aAAa,CAEzE;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,aAAa,CAE/E;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,EACrB,KAAK,CAAC,EAAE,OAAO,GACd,aAAa,CAEf;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,aAAa,CAE5E;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,eAAe,EAAE,GACxB,aAAa,CAIf;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,aAAa,CAE3E;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,OAAO,GACd,aAAa,CAMf;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,aAAa,CAExE"}

package/dist/errors.js

@@ -0,0 +1,59 @@
+/**
+ * Typed error handling for the genjutsu-db library.
+ */
+export class GenjutsuError extends Error {
+    kind;
+    cause;
+    retryAfterMs;
+    validationIssues;
+    migrationVersion;
+    migrationName;
+    constructor(kind, message, options) {
+        super(message);
+        this.name = "GenjutsuError";
+        this.kind = kind;
+        this.cause = options?.cause;
+        this.retryAfterMs = options?.retryAfterMs;
+        this.validationIssues = options?.validationIssues;
+        this.migrationVersion = options?.migrationVersion;
+        this.migrationName = options?.migrationName;
+    }
+}
+/** @deprecated Use GenjutsuError instead */
+export const SheetsDbError = GenjutsuError;
+export function isGenjutsuError(err) {
+    return err instanceof GenjutsuError;
+}
+/** @deprecated Use isGenjutsuError instead */
+export const isSheetsDbError = isGenjutsuError;
+export function authError(message, cause) {
+    return new GenjutsuError("AUTH_ERROR", message, { cause });
+}
+export function permissionError(message, cause) {
+    return new GenjutsuError("PERMISSION_ERROR", message, { cause });
+}
+export function rateLimitError(message, retryAfterMs, cause) {
+    return new GenjutsuError("RATE_LIMIT", message, { cause, retryAfterMs });
+}
+export function networkError(message, cause) {
+    return new GenjutsuError("NETWORK_ERROR", message, { cause });
+}
+export function validationError(message, issues) {
+    return new GenjutsuError("VALIDATION_ERROR", message, {
+        validationIssues: issues,
+    });
+}
+export function schemaError(message, cause) {
+    return new GenjutsuError("SCHEMA_ERROR", message, { cause });
+}
+export function migrationError(message, version, name, cause) {
+    return new GenjutsuError("MIGRATION_ERROR", message, {
+        cause,
+        migrationVersion: version,
+        migrationName: name,
+    });
+}
+export function apiError(message, cause) {
+    return new GenjutsuError("API_ERROR", message, { cause });
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAkBH,MAAM,OAAO,aAAc,SAAQ,KAAK;IAC7B,IAAI,CAAoB;IACxB,KAAK,CAAW;IAChB,YAAY,CAAU;IACtB,gBAAgB,CAAqB;IACrC,gBAAgB,CAAU;IAC1B,aAAa,CAAU;IAEhC,YACE,IAAuB,EACvB,OAAe,EACf,OAMC;QAED,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,OAAO,EAAE,KAAK,CAAC;QAC5B,IAAI,CAAC,YAAY,GAAG,OAAO,EAAE,YAAY,CAAC;QAC1C,IAAI,CAAC,gBAAgB,GAAG,OAAO,EAAE,gBAAgB,CAAC;QAClD,IAAI,CAAC,gBAAgB,GAAG,OAAO,EAAE,gBAAgB,CAAC;QAClD,IAAI,CAAC,aAAa,GAAG,OAAO,EAAE,aAAa,CAAC;IAC9C,CAAC;CACF;AAED,4CAA4C;AAC5C,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAC;AAE3C,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,OAAO,GAAG,YAAY,aAAa,CAAC;AACtC,CAAC;AAED,8CAA8C;AAC9C,MAAM,CAAC,MAAM,eAAe,GAAG,eAAe,CAAC;AAE/C,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,KAAe;IACxD,OAAO,IAAI,aAAa,CAAC,YAAY,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,KAAe;IAC9D,OAAO,IAAI,aAAa,CAAC,kBAAkB,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,OAAe,EACf,YAAqB,EACrB,KAAe;IAEf,OAAO,IAAI,aAAa,CAAC,YAAY,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,KAAe;IAC3D,OAAO,IAAI,aAAa,CAAC,eAAe,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,OAAe,EACf,MAAyB;IAEzB,OAAO,IAAI,aAAa,CAAC,kBAAkB,EAAE,OAAO,EAAE;QACpD,gBAAgB,EAAE,MAAM;KACzB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,KAAe;IAC1D,OAAO,IAAI,aAAa,CAAC,cAAc,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,OAAe,EACf,OAAe,EACf,IAAY,EACZ,KAAe;IAEf,OAAO,IAAI,aAAa,CAAC,iBAAiB,EAAE,OAAO,EAAE;QACnD,KAAK;QACL,gBAAgB,EAAE,OAAO;QACzB,aAAa,EAAE,IAAI;KACpB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAAe,EAAE,KAAe;IACvD,OAAO,IAAI,aAAa,CAAC,WAAW,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;AAC5D,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * genjutsu-db — public API barrel export.
+ * A TypeScript-first Google Sheets database library with zero runtime dependencies.
+ */
+export { createClient } from "./client";
+export { extractSpreadsheetId, createSpreadsheet } from "./transport";
+export { GenjutsuError, SheetsDbError, isGenjutsuError, isSheetsDbError, authError, permissionError, rateLimitError, networkError, validationError, schemaError, migrationError, apiError, } from "./errors";
+export type { GenjutsuErrorKind, ValidationIssue } from "./errors";
+export type { SheetSchema, InferEntity, FormattingRule, HeaderFormat, FieldDefinition, RelationDefinition, Repository, ClientConfig, GenjutsuClient, FindOptions, ReadOptions, WriteOptions, Migration, MigrationContext, } from "./types";
+export { defineModel, field } from "./model";
+export type { FieldDef } from "./model";
+export { generateId, isValidDate, normalizeDate, looksLikeIsoDate, parseAmount, hasIdColumn, findMissingHeaders, } from "./utils";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAGxC,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGtE,OAAO,EACL,aAAa,EACb,aAAa,EACb,eAAe,EACf,eAAe,EACf,SAAS,EACT,eAAe,EACf,cAAc,EACd,YAAY,EACZ,eAAe,EACf,WAAW,EACX,cAAc,EACd,QAAQ,GACT,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAGnE,YAAY,EACV,WAAW,EACX,WAAW,EACX,cAAc,EACd,YAAY,EACZ,eAAe,EACf,kBAAkB,EAClB,UAAU,EACV,YAAY,EACZ,cAAc,EACd,WAAW,EACX,WAAW,EACX,YAAY,EACZ,SAAS,EACT,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAC7C,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGxC,OAAO,EACL,UAAU,EACV,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,kBAAkB,GACnB,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+/**
+ * genjutsu-db — public API barrel export.
+ * A TypeScript-first Google Sheets database library with zero runtime dependencies.
+ */
+// Client factory
+export { createClient } from "./client";
+// Transport
+export { extractSpreadsheetId, createSpreadsheet } from "./transport";
+// Error types
+export { GenjutsuError, SheetsDbError, isGenjutsuError, isSheetsDbError, authError, permissionError, rateLimitError, networkError, validationError, schemaError, migrationError, apiError, } from "./errors";
+// Model definition
+export { defineModel, field } from "./model";
+// Utilities
+export { generateId, isValidDate, normalizeDate, looksLikeIsoDate, parseAmount, hasIdColumn, findMissingHeaders, } from "./utils";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,iBAAiB;AACjB,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,YAAY;AACZ,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEtE,cAAc;AACd,OAAO,EACL,aAAa,EACb,aAAa,EACb,eAAe,EACf,eAAe,EACf,SAAS,EACT,eAAe,EACf,cAAc,EACd,YAAY,EACZ,eAAe,EACf,WAAW,EACX,cAAc,EACd,QAAQ,GACT,MAAM,UAAU,CAAC;AAqBlB,mBAAmB;AACnB,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAG7C,YAAY;AACZ,OAAO,EACL,UAAU,EACV,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,kBAAkB,GACnB,MAAM,SAAS,CAAC"}

package/dist/migrations.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Migration runner for the genjutsu-db library.
+ * Versioned up() migrations with tracking in _genjutsu_migrations sheet.
+ */
+import type { TransportContext } from "./transport";
+import type { Migration } from "./types";
+/**
+ * Run pending migrations, tracking applied ones in _genjutsu_migrations.
+ */
+export declare function runMigrations(ctx: TransportContext, migrations: Migration[]): Promise<void>;
+//# sourceMappingURL=migrations.d.ts.map

package/dist/migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../src/migrations.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAoB,MAAM,SAAS,CAAC;AAY3D;;GAEG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,gBAAgB,EACrB,UAAU,EAAE,SAAS,EAAE,GACtB,OAAO,CAAC,IAAI,CAAC,CAsEf"}