genjutsu-db 0.1.0

package/dist/transport.js

@@ -0,0 +1,232 @@
+/**
+ * Low-level HTTP transport for Google Sheets v4 REST API.
+ * Supports token provider pattern, 401 retry, 403→PERMISSION_ERROR, apiKey for public sheets.
+ */
+import { authError, permissionError, rateLimitError, networkError, apiError, } from "./errors";
+export const SHEETS_API = "https://sheets.googleapis.com/v4/spreadsheets";
+async function resolveToken(auth) {
+    return typeof auth === "function" ? auth() : auth;
+}
+export function extractSpreadsheetId(urlOrId) {
+    const match = urlOrId.match(/\/d\/([a-zA-Z0-9-_]+)/);
+    if (match)
+        return match[1];
+    // If no slashes, treat as a bare ID
+    if (!urlOrId.includes("/"))
+        return urlOrId;
+    return null;
+}
+function parseRetryAfterMs(res) {
+    const header = res.headers.get("Retry-After");
+    if (!header)
+        return undefined;
+    const seconds = parseInt(header, 10);
+    return Number.isNaN(seconds) ? undefined : seconds * 1000;
+}
+function wrapHttpError(status, body, cause) {
+    if (status === 401) {
+        throw authError(`Authentication failed: ${status} ${body}`, cause);
+    }
+    if (status === 403) {
+        throw permissionError(`Permission denied: ${status} ${body}`, cause);
+    }
+    if (status === 429) {
+        throw rateLimitError(`Rate limited: ${status} ${body}`, undefined, cause);
+    }
+    throw apiError(`Sheets API error: ${status} ${body}`, cause);
+}
+async function buildAuthHeaders(ctx) {
+    if (ctx.auth) {
+        const token = await resolveToken(ctx.auth);
+        return { Authorization: `Bearer ${token}` };
+    }
+    return {};
+}
+function buildApiKeyParam(ctx) {
+    if (ctx.apiKey && !ctx.auth) {
+        return `key=${encodeURIComponent(ctx.apiKey)}`;
+    }
+    return "";
+}
+function appendParams(url, extra) {
+    if (!extra)
+        return url;
+    return url.includes("?") ? `${url}&${extra}` : `${url}?${extra}`;
+}
+async function fetchWithErrorHandling(url, init, ctx, retryOn401 = true) {
+    let res;
+    try {
+        res = await fetch(url, init);
+    }
+    catch (err) {
+        throw networkError(`Network request failed: ${err instanceof Error ? err.message : String(err)}`, err);
+    }
+    // 401 retry: if auth is a function, call it again for a fresh token and retry once
+    if (res.status === 401 && retryOn401 && typeof ctx.auth === "function") {
+        const freshToken = await ctx.auth();
+        const retryInit = {
+            ...init,
+            headers: {
+                ...init.headers,
+                Authorization: `Bearer ${freshToken}`,
+            },
+        };
+        let retryRes;
+        try {
+            retryRes = await fetch(url, retryInit);
+        }
+        catch (err) {
+            throw networkError(`Network request failed on retry: ${err instanceof Error ? err.message : String(err)}`, err);
+        }
+        if (!retryRes.ok) {
+            const body = await retryRes.text();
+            if (retryRes.status === 429) {
+                throw rateLimitError(`Rate limited: ${retryRes.status} ${body}`, parseRetryAfterMs(retryRes), retryRes);
+            }
+            wrapHttpError(retryRes.status, body, retryRes);
+        }
+        return retryRes;
+    }
+    if (!res.ok) {
+        const body = await res.text();
+        if (res.status === 429) {
+            throw rateLimitError(`Rate limited: ${res.status} ${body}`, parseRetryAfterMs(res), res);
+        }
+        wrapHttpError(res.status, body, res);
+    }
+    return res;
+}
+// ---------------------------------------------------------------------------
+// Read Operations
+// ---------------------------------------------------------------------------
+export async function getSheetValues(ctx, range, valueRenderOption = "FORMATTED_VALUE") {
+    const params = new URLSearchParams({ valueRenderOption });
+    let url = `${SHEETS_API}/${ctx.spreadsheetId}/values/${encodeURIComponent(range)}?${params}`;
+    url = appendParams(url, buildApiKeyParam(ctx));
+    const headers = await buildAuthHeaders(ctx);
+    const res = await fetchWithErrorHandling(url, { headers }, ctx);
+    const data = (await res.json());
+    const values = data.values;
+    if (!Array.isArray(values) || values.length === 0)
+        return [];
+    return values.map((row) => (Array.isArray(row) ? [...row] : []));
+}
+export async function batchGetValues(ctx, ranges, valueRenderOption = "FORMATTED_VALUE") {
+    if (ranges.length === 0)
+        return new Map();
+    const params = new URLSearchParams({ valueRenderOption });
+    for (const r of ranges)
+        params.append("ranges", r);
+    let url = `${SHEETS_API}/${ctx.spreadsheetId}/values:batchGet?${params}`;
+    url = appendParams(url, buildApiKeyParam(ctx));
+    const headers = await buildAuthHeaders(ctx);
+    const res = await fetchWithErrorHandling(url, { headers }, ctx);
+    const data = (await res.json());
+    const result = new Map();
+    const valueRanges = data.valueRanges ?? [];
+    for (let i = 0; i < ranges.length; i++) {
+        const vr = valueRanges[i];
+        const values = vr?.values ?? [];
+        result.set(ranges[i], values.map((row) => (Array.isArray(row) ? [...row] : [])));
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Write Operations
+// ---------------------------------------------------------------------------
+export async function updateSheet(ctx, range, values, append) {
+    const url = append
+        ? `${SHEETS_API}/${ctx.spreadsheetId}/values/${encodeURIComponent(range)}:append?valueInputOption=USER_ENTERED`
+        : `${SHEETS_API}/${ctx.spreadsheetId}/values/${encodeURIComponent(range)}?valueInputOption=USER_ENTERED`;
+    const method = append ? "POST" : "PUT";
+    const headers = {
+        ...(await buildAuthHeaders(ctx)),
+        "Content-Type": "application/json",
+    };
+    await fetchWithErrorHandling(url, { method, headers, body: JSON.stringify({ values }) }, ctx);
+}
+export async function clearRange(ctx, range) {
+    const url = `${SHEETS_API}/${ctx.spreadsheetId}/values/${encodeURIComponent(range)}:clear`;
+    const headers = {
+        ...(await buildAuthHeaders(ctx)),
+        "Content-Type": "application/json",
+    };
+    await fetchWithErrorHandling(url, { method: "POST", headers, body: JSON.stringify({}) }, ctx);
+}
+// ---------------------------------------------------------------------------
+// Batch Operations
+// ---------------------------------------------------------------------------
+export async function batchClear(ctx, ranges) {
+    const url = `${SHEETS_API}/${ctx.spreadsheetId}/values:batchClear`;
+    const headers = {
+        ...(await buildAuthHeaders(ctx)),
+        "Content-Type": "application/json",
+    };
+    const res = await fetchWithErrorHandling(url, { method: "POST", headers, body: JSON.stringify({ ranges }) }, ctx);
+    // Response consumed by fetchWithErrorHandling
+    void res;
+}
+export async function batchUpdate(ctx, data) {
+    const url = `${SHEETS_API}/${ctx.spreadsheetId}/values:batchUpdate`;
+    const headers = {
+        ...(await buildAuthHeaders(ctx)),
+        "Content-Type": "application/json",
+    };
+    const res = await fetchWithErrorHandling(url, {
+        method: "POST",
+        headers,
+        body: JSON.stringify({ data, valueInputOption: "USER_ENTERED" }),
+    }, ctx);
+    void res;
+}
+// ---------------------------------------------------------------------------
+// Spreadsheet Metadata
+// ---------------------------------------------------------------------------
+export async function getSpreadsheetMetadata(ctx) {
+    let url = `${SHEETS_API}/${ctx.spreadsheetId}?fields=sheets.properties(sheetId,title)`;
+    url = appendParams(url, buildApiKeyParam(ctx));
+    const headers = await buildAuthHeaders(ctx);
+    const res = await fetchWithErrorHandling(url, { headers }, ctx);
+    const data = (await res.json());
+    return {
+        sheets: (data.sheets ?? []).map((s) => ({
+            sheetId: s.properties.sheetId,
+            title: s.properties.title,
+        })),
+    };
+}
+// ---------------------------------------------------------------------------
+// Structural Operations (for migrations)
+// ---------------------------------------------------------------------------
+export async function structuralBatchUpdate(ctx, requests) {
+    const url = `${SHEETS_API}/${ctx.spreadsheetId}:batchUpdate`;
+    const headers = {
+        ...(await buildAuthHeaders(ctx)),
+        "Content-Type": "application/json",
+    };
+    await fetchWithErrorHandling(url, { method: "POST", headers, body: JSON.stringify({ requests }) }, ctx);
+}
+// ---------------------------------------------------------------------------
+// Spreadsheet Creation
+// ---------------------------------------------------------------------------
+export async function createSpreadsheet(title, auth) {
+    const token = await resolveToken(auth);
+    const res = await fetch(SHEETS_API, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${token}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify({ properties: { title } }),
+    });
+    if (!res.ok) {
+        const body = await res.text();
+        throw apiError(`Failed to create spreadsheet: ${res.status} ${body}`);
+    }
+    const data = (await res.json());
+    return {
+        spreadsheetId: data.spreadsheetId,
+        spreadsheetUrl: data.spreadsheetUrl,
+    };
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Generic types for the genjutsu-db library.
+ * Schema-driven API: SheetSchema<T>, Repository<T>, GenjutsuClient<S>, and supporting types.
+ */
+export interface FormattingRule {
+    startCol: number;
+    endCol: number;
+    startRow?: number;
+    endRow?: number;
+    bold?: boolean;
+    fontSize?: number;
+    horizontalAlignment?: "LEFT" | "CENTER" | "RIGHT";
+    numberFormat?: {
+        type: string;
+        pattern?: string;
+    };
+}
+export interface HeaderFormat {
+    bold?: boolean;
+    fontSize?: number;
+    horizontalAlignment?: "LEFT" | "CENTER" | "RIGHT";
+}
+export interface FieldDefinition {
+    name: string;
+    type: "string" | "number" | "date" | "boolean";
+    isPrimaryKey?: boolean;
+    isOptional?: boolean;
+    defaultValue?: unknown;
+    references?: {
+        model: string;
+        field: string;
+    };
+}
+export interface RelationDefinition {
+    sourceField: string;
+    targetModel: string;
+    targetField: string;
+    type: "many-to-one";
+}
+export interface SheetSchema<T> {
+    sheetName: string;
+    headers: string[];
+    readRange: string;
+    writeRange: string;
+    clearRange: string;
+    parseRow(row: unknown[], rowIndex: number): T | null;
+    toRow(entity: T): unknown[];
+    validate?: (entity: T) => void;
+    appendSupported?: boolean;
+    formatting?: FormattingRule[];
+    headerFormatting?: HeaderFormat;
+    primaryKey?: string;
+    fields?: FieldDefinition[];
+    relations?: RelationDefinition[];
+}
+export type InferEntity<S> = S extends SheetSchema<infer T> ? T : never;
+export interface FindOptions {
+    include?: Record<string, true>;
+}
+export interface ReadOptions {
+    include?: Record<string, true>;
+}
+export interface WriteOptions {
+    skipFkValidation?: boolean;
+}
+export interface Repository<T> {
+    create(record: Partial<T>, options?: WriteOptions): Promise<T>;
+    findById(id: string | number): Promise<T | null>;
+    findMany(filter?: (item: T) => boolean, options?: FindOptions): Promise<T[]>;
+    update(id: string | number, changes: Partial<T>, options?: WriteOptions): Promise<T>;
+    delete(id: string | number): Promise<void>;
+    readAll(options?: ReadOptions): Promise<T[]>;
+    writeAll(records: T[]): Promise<void>;
+    append(records: T[]): Promise<void>;
+}
+export interface ClientConfig<S extends Record<string, SheetSchema<any>>> {
+    spreadsheetId: string;
+    auth?: string | (() => Promise<string>);
+    apiKey?: string;
+    schemas: S;
+}
+export interface GenjutsuClient<S extends Record<string, SheetSchema<any>>> {
+    repo<K extends keyof S & string>(key: K): Repository<InferEntity<S[K]>>;
+    batchSync(payload: Partial<{
+        [K in keyof S]: InferEntity<S[K]>[];
+    }>): Promise<void>;
+    ensureSchema(): Promise<void>;
+    applyFormatting(): Promise<void>;
+    migrate(migrations: Migration[]): Promise<void>;
+    extractSpreadsheetId(urlOrId: string): string | null;
+}
+export interface Migration {
+    version: number;
+    name: string;
+    up: (ctx: MigrationContext) => Promise<void>;
+}
+export interface MigrationContext {
+    createSheet(name: string): Promise<void>;
+    addColumn(sheet: string, column: string, afterIndex?: number): Promise<void>;
+    removeColumn(sheet: string, columnIndex: number): Promise<void>;
+    renameColumn(sheet: string, columnIndex: number, newName: string): Promise<void>;
+    renameSheet(oldName: string, newName: string): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,6 @@
+/**
+ * Generic types for the genjutsu-db library.
+ * Schema-driven API: SheetSchema<T>, Repository<T>, GenjutsuClient<S>, and supporting types.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/utils.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Generic utility functions for the genjutsu-db library.
+ * Domain-agnostic helpers for date parsing, amount parsing,
+ * header validation, ID generation, and row detection.
+ */
+export declare function isValidDate(date: string): boolean;
+export declare function tryRepairDate(value: string): string | null;
+export declare function normalizeDate(value: unknown): string | null;
+export declare function looksLikeIsoDate(value: string): boolean;
+export declare function parseAmount(value: unknown): number | null;
+export declare function hasIdColumn(row: unknown[], minLength: number, looksLikeDate: (v: string) => boolean): boolean;
+export declare function findMissingHeaders(actualHeaders: string[], requiredHeaders: string[]): string[];
+export declare function generateId(): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAYD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAO1D;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAK3D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAKzD;AAED,wBAAgB,WAAW,CACzB,GAAG,EAAE,OAAO,EAAE,EACd,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,GACpC,OAAO,CAGT;AAED,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,MAAM,EAAE,EACvB,eAAe,EAAE,MAAM,EAAE,GACxB,MAAM,EAAE,CAGV;AAED,wBAAgB,UAAU,IAAI,MAAM,CAEnC"}

package/dist/utils.js

@@ -0,0 +1,57 @@
+/**
+ * Generic utility functions for the genjutsu-db library.
+ * Domain-agnostic helpers for date parsing, amount parsing,
+ * header validation, ID generation, and row detection.
+ */
+const ISO_DATE_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
+export function isValidDate(date) {
+    return ISO_DATE_PATTERN.test(date);
+}
+function serialToIsoDate(serial) {
+    const epoch = new Date(1899, 11, 30).getTime();
+    const ms = serial * 86400000 + epoch;
+    const d = new Date(ms);
+    const y = d.getFullYear();
+    const m = String(d.getMonth() + 1).padStart(2, "0");
+    const day = String(d.getDate()).padStart(2, "0");
+    return `${y}-${m}-${day}`;
+}
+export function tryRepairDate(value) {
+    if (ISO_DATE_PATTERN.test(value.trim()))
+        return value.trim();
+    const num = parseFloat(value.replace(/[$,\s]/g, ""));
+    if (!Number.isNaN(num) && num > 0 && num < 1000000) {
+        return serialToIsoDate(num);
+    }
+    return null;
+}
+export function normalizeDate(value) {
+    if (value == null)
+        return null;
+    const s = String(value).trim();
+    if (ISO_DATE_PATTERN.test(s))
+        return s;
+    return tryRepairDate(s);
+}
+export function looksLikeIsoDate(value) {
+    return ISO_DATE_PATTERN.test(value.trim());
+}
+export function parseAmount(value) {
+    if (typeof value === "number" && !Number.isNaN(value))
+        return value;
+    const s = String(value ?? "").replace(/[$,\s]/g, "");
+    const n = parseFloat(s);
+    return Number.isNaN(n) ? null : n;
+}
+export function hasIdColumn(row, minLength, looksLikeDate) {
+    const first = String(row[0] ?? "").trim();
+    return row.length >= minLength && first.length > 0 && !looksLikeDate(first);
+}
+export function findMissingHeaders(actualHeaders, requiredHeaders) {
+    const normalized = new Set(actualHeaders.map((h) => h.trim().toLowerCase()));
+    return requiredHeaders.filter((h) => !normalized.has(h.toLowerCase()));
+}
+export function generateId() {
+    return `${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

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

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "genjutsu-db",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "A TypeScript-first Google Sheets database library with zero runtime dependencies",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist/"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "bun test",
+    "lint": "tsc --noEmit",
+    "prepublishOnly": "bun test && bun run build"
+  },
+  "keywords": [
+    "google-sheets",
+    "database",
+    "orm",
+    "typescript",
+    "spreadsheet"
+  ],
+  "license": "MIT",
+  "author": "Ayaz Uddin",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Ayaz2589/Genjutsu-DB.git"
+  },
+  "homepage": "https://github.com/Ayaz2589/Genjutsu-DB#readme",
+  "bugs": {
+    "url": "https://github.com/Ayaz2589/Genjutsu-DB/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "sideEffects": false,
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/bun": "^1.2.0"
+  }
+}