@tarangdb/generator 1.0.0-alpha.1

package/README.md

@@ -0,0 +1,36 @@
+# @tarangdb/generator
+
+TarangDB JSON schema to TypeScript code generator.
+
+This package is primarily used by `@tarangdb/cli`, but can be used directly by tools that already have a Tarang schema response.
+
+## Install
+
+```bash
+npm install @tarangdb/generator
+```
+
+## Usage
+
+```ts
+import { generateTypeScript } from "@tarangdb/generator";
+
+const source = await fetch("https://api.tarangdb.com/v1/projects/{projectId}/schema", {
+  headers: {
+    Authorization: `Bearer ${process.env.TARANG_API_KEY}`,
+  },
+});
+
+const schema = await source.json();
+const code = generateTypeScript(schema);
+```
+
+Generated output includes:
+
+- row, insert, and update interfaces per table
+- `TarangSchema` registry for `TarangClient<TarangSchema>`
+- `tarangSchemaMetadata` with table and column mappings
+
+## Status
+
+This is an alpha release. The schema contract is versioned by `schemaVersion`.

package/dist/generate.d.ts

@@ -0,0 +1,2 @@
+import type { TarangProjectSchemaResponse } from "./schema";
+export declare function generateTypeScript(schema: TarangProjectSchemaResponse): string;

package/dist/generate.js

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateTypeScript = generateTypeScript;
+const naming_1 = require("./naming");
+const TYPE_MAP = {
+    string: "string",
+    number: "number",
+    integer: "number",
+    boolean: "boolean",
+    date: "string",
+    datetime: "string",
+    email: "string",
+    url: "string",
+    json: "unknown",
+    relation: "string",
+    unknown: "unknown",
+};
+function generateTypeScript(schema) {
+    if (!schema || !Array.isArray(schema.tables)) {
+        throw new Error("Invalid TarangProjectSchemaResponse: expected a tables array.");
+    }
+    const tableSymbols = (0, naming_1.makeUniqueNames)(schema.tables.map((table) => (0, naming_1.ensureIdentifier)((0, naming_1.toPascalCase)(table.name || table.originalSheetName || "Table"))));
+    const generatedTables = schema.tables.map((table, index) => buildGeneratedTable(table, tableSymbols[index]));
+    const lines = [
+        "/* Auto-generated by @tarangdb/generator. Do not edit by hand. */",
+        "",
+    ];
+    for (const generatedTable of generatedTables) {
+        lines.push(...renderTable(generatedTable));
+    }
+    lines.push(...renderSchemaRegistry(generatedTables));
+    lines.push(...renderSchemaMetadata(generatedTables));
+    return `${lines.join("\n")}\n`;
+}
+function buildGeneratedTable(table, symbol) {
+    const columns = buildColumns(table.columns);
+    return {
+        symbol,
+        columns,
+        table,
+    };
+}
+function buildColumns(columns) {
+    const normalizedWriteNames = (0, naming_1.makeUniqueNames)(columns.map((column) => (0, naming_1.ensureIdentifier)((0, naming_1.toCamelCase)(column.name || column.originalHeader || "value"))));
+    return columns.map((column, index) => ({
+        originalHeader: column.originalHeader,
+        rowProperty: normalizedWriteNames[index],
+        writeProperty: normalizedWriteNames[index],
+        type: TYPE_MAP[column.type],
+        required: column.required,
+        nullable: column.nullable,
+    }));
+}
+function renderTable(generatedTable) {
+    const { symbol, columns, table } = generatedTable;
+    const rowInterface = `${symbol}Row`;
+    const insertInterface = `${symbol}Insert`;
+    const updateInterface = `${symbol}Update`;
+    return [
+        `export interface ${rowInterface} {`,
+        ...columns.map((column) => renderRowProperty(column)),
+        "}",
+        "",
+        `export interface ${insertInterface} {`,
+        ...columns.map((column) => renderWriteProperty(column, false)),
+        "}",
+        "",
+        `export interface ${updateInterface} {`,
+        ...columns.map((column) => renderWriteProperty(column, true)),
+        "}",
+        "",
+    ];
+}
+function renderRowProperty(column) {
+    const type = column.nullable ? `${column.type} | null` : column.type;
+    const optional = column.required ? "" : "?";
+    return `  ${(0, naming_1.escapeStringLiteral)(column.rowProperty)}${optional}: ${type};`;
+}
+function renderWriteProperty(column, forceOptional) {
+    const type = column.nullable ? `${column.type} | null` : column.type;
+    const optional = forceOptional || !column.required ? "?" : "";
+    return `  ${column.writeProperty}${optional}: ${type};`;
+}
+function renderMetadataProperty(column) {
+    return [
+        "        {",
+        `          originalHeader: ${(0, naming_1.escapeStringLiteral)(column.originalHeader)},`,
+        `          rowProperty: ${(0, naming_1.escapeStringLiteral)(column.rowProperty)},`,
+        `          writeProperty: ${(0, naming_1.escapeStringLiteral)(column.writeProperty)},`,
+        `          type: ${(0, naming_1.escapeStringLiteral)(column.type)},`,
+        `          required: ${column.required},`,
+        `          nullable: ${column.nullable},`,
+        "        },",
+    ].join("\n");
+}
+function renderSchemaRegistry(generatedTables) {
+    const lines = ["export interface TarangSchema {"];
+    for (const generatedTable of generatedTables) {
+        lines.push(`  ${(0, naming_1.escapeStringLiteral)(generatedTable.table.name)}: {`);
+        lines.push(`    row: ${generatedTable.symbol}Row;`);
+        lines.push(`    insert: ${generatedTable.symbol}Insert;`);
+        lines.push(`    update: ${generatedTable.symbol}Update;`);
+        lines.push("  };");
+    }
+    lines.push("}", "");
+    return lines;
+}
+function renderSchemaMetadata(generatedTables) {
+    const lines = ["export const tarangSchemaMetadata = {", "  tables: {"];
+    for (const generatedTable of generatedTables) {
+        lines.push(`    ${(0, naming_1.escapeStringLiteral)(generatedTable.table.name)}: {`);
+        lines.push(`      tableName: ${(0, naming_1.escapeStringLiteral)(generatedTable.table.name)},`);
+        lines.push(`      originalSheetName: ${(0, naming_1.escapeStringLiteral)(generatedTable.table.originalSheetName)},`);
+        lines.push("      columns: [");
+        for (const column of generatedTable.columns) {
+            lines.push(...renderMetadataProperty(column).split("\n"));
+        }
+        lines.push("      ],");
+        lines.push("    },");
+    }
+    lines.push("  },", "} as const;", "");
+    return lines;
+}
+//# sourceMappingURL=generate.js.map

package/dist/generate.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./schema";
+export * from "./generate";

package/dist/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./schema"), exports);
+__exportStar(require("./generate"), exports);
+//# 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,2CAAyB;AACzB,6CAA2B"}

package/dist/naming.d.ts

@@ -0,0 +1,6 @@
+export declare function toWords(value: string): string[];
+export declare function toPascalCase(value: string): string;
+export declare function toCamelCase(value: string): string;
+export declare function ensureIdentifier(value: string): string;
+export declare function makeUniqueNames(values: string[]): string[];
+export declare function escapeStringLiteral(value: string): string;

package/dist/naming.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toWords = toWords;
+exports.toPascalCase = toPascalCase;
+exports.toCamelCase = toCamelCase;
+exports.ensureIdentifier = ensureIdentifier;
+exports.makeUniqueNames = makeUniqueNames;
+exports.escapeStringLiteral = escapeStringLiteral;
+const RESERVED_WORDS = new Set([
+    "break",
+    "case",
+    "catch",
+    "class",
+    "const",
+    "continue",
+    "debugger",
+    "default",
+    "delete",
+    "do",
+    "else",
+    "enum",
+    "export",
+    "extends",
+    "false",
+    "finally",
+    "for",
+    "function",
+    "if",
+    "import",
+    "in",
+    "instanceof",
+    "new",
+    "null",
+    "return",
+    "super",
+    "switch",
+    "this",
+    "throw",
+    "true",
+    "try",
+    "typeof",
+    "var",
+    "void",
+    "while",
+    "with",
+    "as",
+    "any",
+    "boolean",
+    "constructor",
+    "declare",
+    "get",
+    "module",
+    "namespace",
+    "require",
+    "number",
+    "set",
+    "string",
+    "symbol",
+    "type",
+    "from",
+    "of",
+]);
+function toWords(value) {
+    const cleaned = value
+        .normalize("NFKD")
+        .replace(/[^\p{L}\p{N}]+/gu, " ")
+        .trim();
+    if (cleaned.length === 0) {
+        return ["value"];
+    }
+    return cleaned.split(/\s+/u).filter(Boolean);
+}
+function toPascalCase(value) {
+    return toWords(value)
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+        .join("") || "Value";
+}
+function toCamelCase(value) {
+    const [firstWord, ...restWords] = toWords(value);
+    const firstSegment = firstWord.charAt(0).toLowerCase() + firstWord.slice(1);
+    return [firstSegment, ...restWords.map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())].join("");
+}
+function ensureIdentifier(value) {
+    const safe = value.replace(/[^\p{L}\p{N}_$]/gu, "_");
+    const normalized = /^[\p{L}_$]/u.test(safe) ? safe : `_${safe}`;
+    return RESERVED_WORDS.has(normalized) ? `_${normalized}` : normalized;
+}
+function makeUniqueNames(values) {
+    const seen = new Map();
+    return values.map((value) => {
+        const current = seen.get(value) ?? 0;
+        const nextCount = current + 1;
+        seen.set(value, nextCount);
+        return current === 0 ? value : `${value}${nextCount}`;
+    });
+}
+function escapeStringLiteral(value) {
+    return JSON.stringify(value);
+}
+//# sourceMappingURL=naming.js.map

package/dist/naming.js.map

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

package/dist/schema.d.ts

@@ -0,0 +1,42 @@
+export interface TarangProjectSchemaResponse {
+    schemaVersion: string;
+    project: {
+        id: string;
+        name: string;
+    };
+    source: {
+        provider: "google_sheets";
+        spreadsheetId: string;
+        spreadsheetName?: string;
+        syncedAt: string;
+    };
+    tables: TarangTableSchema[];
+}
+export interface TarangTableSchema {
+    id: string;
+    name: string;
+    originalSheetName: string;
+    description?: string;
+    primaryKey?: string;
+    columns: TarangColumnSchema[];
+    permissions?: {
+        readable: boolean;
+        creatable: boolean;
+        updatable: boolean;
+        deletable: boolean;
+    };
+}
+export interface TarangColumnSchema {
+    id: string;
+    name: string;
+    originalHeader: string;
+    type: TarangColumnType;
+    required: boolean;
+    nullable: boolean;
+    unique?: boolean;
+    description?: string;
+    examples?: unknown[];
+    format?: string;
+    enum?: string[];
+}
+export type TarangColumnType = "string" | "number" | "integer" | "boolean" | "date" | "datetime" | "email" | "url" | "json" | "relation" | "unknown";

package/dist/schema.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

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

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@tarangdb/generator",
+  "version": "1.0.0-alpha.1",
+  "description": "TarangDB JSON schema to TypeScript generator.",
+  "license": "MIT",
+  "type": "commonjs",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "tarangdb",
+    "codegen",
+    "typescript",
+    "google-sheets",
+    "schema"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tarang-labs/tarang.git",
+    "directory": ".sdk/typescript/packages/generator"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist",
+    "test": "npm run build && node --test test/golden.test.cjs"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.18",
+    "typescript": "^5.8.3"
+  }
+}