turbine-orm 0.3.0

package/dist/schema-sql.js

@@ -0,0 +1,347 @@
+/**
+ * @batadata/turbine — Schema SQL Generator
+ *
+ * Converts a SchemaDef (from defineSchema) into executable DDL statements.
+ * Also provides diff and push commands for syncing schema to a live database.
+ */
+import pg from 'pg';
+import { camelToSnake } from './schema.js';
+// ---------------------------------------------------------------------------
+// SQL Generation — SchemaDef → CREATE TABLE statements
+// ---------------------------------------------------------------------------
+/**
+ * Convert a SchemaDef into an ordered array of SQL DDL statements.
+ *
+ * Returns CREATE TABLE statements (in dependency order based on references)
+ * followed by CREATE INDEX statements for foreign key columns.
+ */
+export function schemaToSQL(schema) {
+    const statements = [];
+    const tableNames = Object.keys(schema.tables);
+    // Topologically sort tables by their foreign key references
+    const sorted = topologicalSort(schema);
+    // Generate CREATE TABLE statements
+    for (const tableName of sorted) {
+        const table = schema.tables[tableName];
+        statements.push(generateCreateTable(table));
+    }
+    // Generate CREATE INDEX for foreign key columns
+    for (const tableName of sorted) {
+        const table = schema.tables[tableName];
+        const indexes = generateForeignKeyIndexes(table);
+        statements.push(...indexes);
+    }
+    return statements;
+}
+/**
+ * Topologically sort tables so that referenced tables come before referencing ones.
+ * Falls back to input order for tables with no dependency ordering.
+ */
+function topologicalSort(schema) {
+    const tableNames = Object.keys(schema.tables);
+    const resolved = new Set();
+    const result = [];
+    const visiting = new Set();
+    function visit(name) {
+        if (resolved.has(name))
+            return;
+        if (visiting.has(name)) {
+            // Circular reference — just add it
+            return;
+        }
+        visiting.add(name);
+        const table = schema.tables[name];
+        if (table) {
+            // Visit all tables this table references
+            for (const col of Object.values(table.columns)) {
+                if (col.referencesTarget) {
+                    const refTable = col.referencesTarget.split('.')[0];
+                    if (refTable !== name && schema.tables[refTable]) {
+                        visit(refTable);
+                    }
+                }
+            }
+        }
+        visiting.delete(name);
+        resolved.add(name);
+        result.push(name);
+    }
+    for (const name of tableNames) {
+        visit(name);
+    }
+    return result;
+}
+/**
+ * Generate a CREATE TABLE statement for a single table definition.
+ */
+function generateCreateTable(table) {
+    const tableName = table.name;
+    const columnDefs = [];
+    for (const [fieldName, config] of Object.entries(table.columns)) {
+        columnDefs.push(generateColumnDef(fieldName, config));
+    }
+    const body = columnDefs.map((d) => `    ${d}`).join(',\n');
+    return `CREATE TABLE ${tableName} (\n${body}\n);`;
+}
+/**
+ * Generate a single column definition line (e.g. "id BIGSERIAL PRIMARY KEY").
+ */
+function generateColumnDef(fieldName, config) {
+    const snakeName = camelToSnake(fieldName);
+    const parts = [snakeName];
+    // Type
+    if (config.type === 'VARCHAR' && config.maxLength != null) {
+        parts.push(`VARCHAR(${config.maxLength})`);
+    }
+    else {
+        parts.push(config.type);
+    }
+    // PRIMARY KEY
+    if (config.isPrimaryKey) {
+        parts.push('PRIMARY KEY');
+    }
+    // UNIQUE (only if not primary key — PK is implicitly unique)
+    if (config.isUnique && !config.isPrimaryKey) {
+        parts.push('UNIQUE');
+    }
+    // NOT NULL — serial types are implicitly NOT NULL, but explicit is fine.
+    // A column is NOT NULL if:
+    //   1. Explicitly marked .notNull(), OR
+    //   2. Is a serial (BIGSERIAL implies NOT NULL), OR
+    //   3. Has a primary key (PKs are NOT NULL)
+    // A column is left nullable if .nullable() was called.
+    const isSerial = config.type === 'BIGSERIAL';
+    const implicitNotNull = isSerial || config.isPrimaryKey;
+    if (config.isNotNull && !implicitNotNull) {
+        parts.push('NOT NULL');
+    }
+    // DEFAULT
+    if (config.defaultValue != null) {
+        const sqlDefault = normalizeDefault(config.defaultValue);
+        parts.push(`DEFAULT ${sqlDefault}`);
+    }
+    // REFERENCES
+    if (config.referencesTarget) {
+        const refParts = config.referencesTarget.split('.');
+        if (refParts.length === 2) {
+            parts.push(`REFERENCES ${refParts[0]}(${refParts[1]})`);
+        }
+    }
+    return parts.join(' ');
+}
+/**
+ * Normalize a default value from the user's schema definition to valid SQL.
+ *
+ * Examples:
+ *   'now()'  → NOW()
+ *   "'free'" → 'free'
+ *   'false'  → false
+ *   '0'      → 0
+ */
+function normalizeDefault(val) {
+    // Recognize function calls like now(), gen_random_uuid(), etc.
+    if (/^[a-z_]+\(\)$/i.test(val)) {
+        return val.toUpperCase();
+    }
+    return val;
+}
+/**
+ * Generate CREATE INDEX statements for foreign key columns.
+ * Only generates indexes for columns that have a REFERENCES clause.
+ */
+function generateForeignKeyIndexes(table) {
+    const indexes = [];
+    for (const [fieldName, config] of Object.entries(table.columns)) {
+        if (config.referencesTarget) {
+            const snakeName = camelToSnake(fieldName);
+            const indexName = `idx_${table.name}_${snakeName}`;
+            indexes.push(`CREATE INDEX ${indexName} ON ${table.name}(${snakeName});`);
+        }
+    }
+    return indexes;
+}
+/**
+ * Compare a SchemaDef against a live Postgres database and return the diff.
+ *
+ * Connects to the database, inspects the public schema, and computes what
+ * DDL is needed to make the database match the schema definition.
+ */
+export async function schemaDiff(schema, connectionString) {
+    const client = new pg.Client({ connectionString });
+    await client.connect();
+    try {
+        // Get existing tables in the public schema
+        const tableResult = await client.query(`SELECT tablename FROM pg_tables WHERE schemaname = 'public'`);
+        const existingTables = new Set(tableResult.rows.map((r) => r.tablename));
+        // Get existing columns for all tables
+        const columnResult = await client.query(`SELECT table_name, column_name, data_type, udt_name, is_nullable, column_default, character_maximum_length
+       FROM information_schema.columns
+       WHERE table_schema = 'public'
+       ORDER BY table_name, ordinal_position`);
+        const dbColumns = {};
+        for (const row of columnResult.rows) {
+            if (!dbColumns[row.table_name]) {
+                dbColumns[row.table_name] = {};
+            }
+            dbColumns[row.table_name][row.column_name] = {
+                dataType: row.data_type,
+                udtName: row.udt_name,
+                isNullable: row.is_nullable === 'YES',
+                columnDefault: row.column_default,
+                maxLength: row.character_maximum_length,
+            };
+        }
+        const schemaTableNames = new Set(Object.keys(schema.tables));
+        const result = { create: [], alter: [], drop: [], statements: [] };
+        // Tables to create (in schema but not in DB)
+        const sorted = topologicalSort(schema);
+        for (const tableName of sorted) {
+            if (!existingTables.has(tableName)) {
+                const tableDef = schema.tables[tableName];
+                result.create.push(tableDef);
+                result.statements.push(generateCreateTable(tableDef));
+                // Also add FK indexes
+                result.statements.push(...generateForeignKeyIndexes(tableDef));
+            }
+        }
+        // Tables to drop (in DB but not in schema)
+        for (const existingTable of existingTables) {
+            if (!schemaTableNames.has(existingTable)) {
+                result.drop.push(existingTable);
+                // We don't auto-generate DROP statements for safety
+            }
+        }
+        // Tables to alter (exist in both)
+        for (const tableName of sorted) {
+            if (!existingTables.has(tableName))
+                continue;
+            const tableDef = schema.tables[tableName];
+            const dbCols = dbColumns[tableName] ?? {};
+            const alterDef = { table: tableName, columns: [] };
+            for (const [fieldName, config] of Object.entries(tableDef.columns)) {
+                const snakeName = camelToSnake(fieldName);
+                const dbCol = dbCols[snakeName];
+                if (!dbCol) {
+                    // Column exists in schema but not in DB — ADD COLUMN
+                    const colDef = generateColumnDef(fieldName, config);
+                    const sql = `ALTER TABLE ${tableName} ADD COLUMN ${colDef};`;
+                    alterDef.columns.push({ column: snakeName, action: 'add', sql });
+                    result.statements.push(sql);
+                    continue;
+                }
+                // Check type mismatch
+                const expectedUdt = schemaTypeToUdt(config);
+                if (expectedUdt && dbCol.udtName !== expectedUdt) {
+                    const sqlType = config.type === 'VARCHAR' && config.maxLength
+                        ? `VARCHAR(${config.maxLength})`
+                        : config.type;
+                    const sql = `ALTER TABLE ${tableName} ALTER COLUMN ${snakeName} TYPE ${sqlType};`;
+                    alterDef.columns.push({ column: snakeName, action: 'alter_type', sql });
+                    result.statements.push(sql);
+                }
+                // Check NOT NULL mismatch
+                const shouldBeNotNull = config.isNotNull || config.isPrimaryKey || config.type === 'BIGSERIAL';
+                const isCurrentlyNullable = dbCol.isNullable;
+                if (shouldBeNotNull && isCurrentlyNullable && !config.isNullable) {
+                    const sql = `ALTER TABLE ${tableName} ALTER COLUMN ${snakeName} SET NOT NULL;`;
+                    alterDef.columns.push({ column: snakeName, action: 'set_not_null', sql });
+                    result.statements.push(sql);
+                }
+                else if (!shouldBeNotNull && !isCurrentlyNullable && config.isNullable) {
+                    const sql = `ALTER TABLE ${tableName} ALTER COLUMN ${snakeName} DROP NOT NULL;`;
+                    alterDef.columns.push({ column: snakeName, action: 'drop_not_null', sql });
+                    result.statements.push(sql);
+                }
+            }
+            // Check for columns in DB that are not in schema
+            for (const dbColName of Object.keys(dbCols)) {
+                const hasField = Object.entries(tableDef.columns).some(([fieldName]) => camelToSnake(fieldName) === dbColName);
+                if (!hasField) {
+                    const sql = `ALTER TABLE ${tableName} DROP COLUMN ${dbColName};`;
+                    alterDef.columns.push({ column: dbColName, action: 'drop', sql });
+                    // Don't auto-add drops to statements for safety — user must opt in
+                }
+            }
+            if (alterDef.columns.length > 0) {
+                result.alter.push(alterDef);
+            }
+        }
+        return result;
+    }
+    finally {
+        await client.end();
+    }
+}
+/**
+ * Map a schema column type to its expected PostgreSQL UDT name.
+ */
+function schemaTypeToUdt(config) {
+    const map = {
+        BIGSERIAL: 'int8',
+        BIGINT: 'int8',
+        INTEGER: 'int4',
+        SMALLINT: 'int2',
+        TEXT: 'text',
+        VARCHAR: 'varchar',
+        BOOLEAN: 'bool',
+        TIMESTAMPTZ: 'timestamptz',
+        DATE: 'date',
+        JSONB: 'jsonb',
+        UUID: 'uuid',
+        REAL: 'float4',
+        'DOUBLE PRECISION': 'float8',
+        NUMERIC: 'numeric',
+        BYTEA: 'bytea',
+    };
+    return map[config.type] ?? null;
+}
+/**
+ * Push a schema definition to a live database.
+ *
+ * Computes the diff, then executes the resulting DDL statements in a
+ * single transaction. This is a destructive operation for ADD/ALTER —
+ * it will NOT drop tables or columns unless explicitly configured.
+ */
+export async function schemaPush(schema, connectionString, options = {}) {
+    const diff = await schemaDiff(schema, connectionString);
+    const result = {
+        statementsExecuted: 0,
+        statements: diff.statements,
+        tablesCreated: diff.create.map((t) => t.name),
+        tablesAltered: diff.alter.map((a) => a.table),
+    };
+    if (options.dryRun || diff.statements.length === 0) {
+        return result;
+    }
+    // Execute all statements in a transaction
+    const client = new pg.Client({ connectionString });
+    await client.connect();
+    try {
+        await client.query('BEGIN');
+        for (const sql of diff.statements) {
+            await client.query(sql);
+            result.statementsExecuted++;
+        }
+        await client.query('COMMIT');
+    }
+    catch (err) {
+        await client.query('ROLLBACK');
+        throw err;
+    }
+    finally {
+        await client.end();
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Utility: format schema as SQL string (convenience for debugging/printing)
+// ---------------------------------------------------------------------------
+/**
+ * Generate the full DDL as a single formatted string.
+ * Useful for printing or saving to a .sql file.
+ */
+export function schemaToSQLString(schema) {
+    const statements = schemaToSQL(schema);
+    return statements.join('\n\n') + '\n';
+}
+//# sourceMappingURL=schema-sql.js.map

package/dist/schema-sql.js.map

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

package/dist/schema.d.ts

@@ -0,0 +1,90 @@
+/**
+ * @batadata/turbine — Schema metadata types
+ *
+ * These types represent the introspected database schema at runtime.
+ * They're used by the query builder, code generator, and CLI.
+ */
+export interface SchemaMetadata {
+    /** All discovered tables, keyed by table name */
+    tables: Record<string, TableMetadata>;
+    /** Database-level enums (typname → labels) */
+    enums: Record<string, string[]>;
+}
+export interface TableMetadata {
+    /** Table name in the database (snake_case) */
+    name: string;
+    /** All columns in ordinal order */
+    columns: ColumnMetadata[];
+    /** camelCase field name → snake_case column name */
+    columnMap: Record<string, string>;
+    /** snake_case column name → camelCase field name */
+    reverseColumnMap: Record<string, string>;
+    /** snake_case columns that are timestamp/date types (need Date parsing) */
+    dateColumns: Set<string>;
+    /** snake_case column → Postgres type for UNNEST casts */
+    pgTypes: Record<string, string>;
+    /** All snake_case column names in ordinal order */
+    allColumns: string[];
+    /** Primary key column(s) in snake_case */
+    primaryKey: string[];
+    /** Unique constraint columns */
+    uniqueColumns: string[][];
+    /** Relations defined on this table */
+    relations: Record<string, RelationDef>;
+    /** Indexes on this table */
+    indexes: IndexMetadata[];
+}
+export interface ColumnMetadata {
+    /** snake_case column name */
+    name: string;
+    /** camelCase field name for TypeScript */
+    field: string;
+    /** Postgres base type (e.g. 'int8', 'text', 'timestamptz') */
+    pgType: string;
+    /** TypeScript type string (e.g. 'number', 'string', 'Date') */
+    tsType: string;
+    /** Whether the column allows NULL */
+    nullable: boolean;
+    /** Whether the column has a DEFAULT, is serial, or is generated */
+    hasDefault: boolean;
+    /** Whether this is an array column */
+    isArray: boolean;
+    /** Postgres array type for UNNEST (e.g. 'bigint[]') */
+    pgArrayType: string;
+    /** Max character length (for varchar) */
+    maxLength?: number;
+}
+export interface RelationDef {
+    type: 'hasMany' | 'hasOne' | 'belongsTo';
+    /** Relation name (camelCase, used as the field name) */
+    name: string;
+    /** Source table */
+    from: string;
+    /** Target table */
+    to: string;
+    /** FK column on the "many" / "child" side (snake_case) */
+    foreignKey: string;
+    /** Referenced column on the "one" / "parent" side (snake_case) */
+    referenceKey: string;
+}
+export interface IndexMetadata {
+    name: string;
+    columns: string[];
+    unique: boolean;
+    definition: string;
+}
+/** Map a Postgres type to its TypeScript equivalent */
+export declare function pgTypeToTs(pgType: string, nullable: boolean): string;
+/** Check if a Postgres type is a date/timestamp that needs Date parsing */
+export declare function isDateType(pgType: string): boolean;
+/** Get the Postgres array cast type for UNNEST batch inserts */
+export declare function pgArrayType(pgType: string): string;
+/** snake_case → camelCase */
+export declare function snakeToCamel(s: string): string;
+/** camelCase → snake_case */
+export declare function camelToSnake(s: string): string;
+/** snake_case → PascalCase (for type names) */
+export declare function snakeToPascal(s: string): string;
+/** Naive singularize: "posts" → "post", "categories" → "category" */
+export declare function singularize(s: string): string;
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

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

package/dist/schema.js

@@ -0,0 +1,129 @@
+/**
+ * @batadata/turbine — Schema metadata types
+ *
+ * These types represent the introspected database schema at runtime.
+ * They're used by the query builder, code generator, and CLI.
+ */
+// ---------------------------------------------------------------------------
+// Type mapping: Postgres → TypeScript
+// ---------------------------------------------------------------------------
+const PG_TO_TS = {
+    // Integers
+    int2: 'number',
+    int4: 'number',
+    int8: 'number',
+    float4: 'number',
+    float8: 'number',
+    oid: 'number',
+    // Precision-sensitive — keep as string to avoid JS float issues
+    numeric: 'string',
+    money: 'string',
+    // Boolean
+    bool: 'boolean',
+    // Strings
+    text: 'string',
+    varchar: 'string',
+    char: 'string',
+    bpchar: 'string',
+    name: 'string',
+    uuid: 'string',
+    citext: 'string',
+    xml: 'string',
+    // Dates & times
+    timestamptz: 'Date',
+    timestamp: 'Date',
+    date: 'Date',
+    time: 'string',
+    timetz: 'string',
+    interval: 'string',
+    // JSON
+    json: 'unknown',
+    jsonb: 'unknown',
+    // Binary
+    bytea: 'Buffer',
+    // Network
+    inet: 'string',
+    cidr: 'string',
+    macaddr: 'string',
+    // Geometric
+    point: 'string',
+    line: 'string',
+    lseg: 'string',
+    box: 'string',
+    path: 'string',
+    polygon: 'string',
+    circle: 'string',
+    // TSVector
+    tsvector: 'string',
+    tsquery: 'string',
+};
+const DATE_TYPES = new Set(['timestamptz', 'timestamp', 'date']);
+const PG_TO_ARRAY = {
+    int2: 'smallint[]',
+    int4: 'integer[]',
+    int8: 'bigint[]',
+    float4: 'real[]',
+    float8: 'double precision[]',
+    numeric: 'numeric[]',
+    bool: 'boolean[]',
+    text: 'text[]',
+    varchar: 'text[]',
+    char: 'text[]',
+    bpchar: 'text[]',
+    uuid: 'uuid[]',
+    timestamptz: 'timestamptz[]',
+    timestamp: 'timestamp[]',
+    date: 'date[]',
+    json: 'json[]',
+    jsonb: 'jsonb[]',
+    bytea: 'bytea[]',
+    inet: 'inet[]',
+};
+/** Map a Postgres type to its TypeScript equivalent */
+export function pgTypeToTs(pgType, nullable) {
+    // Array types: udt_name starts with '_'
+    if (pgType.startsWith('_')) {
+        const elementType = pgTypeToTs(pgType.slice(1), false);
+        const tsType = `${elementType}[]`;
+        return nullable ? `${tsType} | null` : tsType;
+    }
+    const tsType = PG_TO_TS[pgType] ?? 'unknown';
+    return nullable ? `${tsType} | null` : tsType;
+}
+/** Check if a Postgres type is a date/timestamp that needs Date parsing */
+export function isDateType(pgType) {
+    return DATE_TYPES.has(pgType);
+}
+/** Get the Postgres array cast type for UNNEST batch inserts */
+export function pgArrayType(pgType) {
+    return PG_TO_ARRAY[pgType] ?? 'text[]';
+}
+// ---------------------------------------------------------------------------
+// Name conversion utilities
+// ---------------------------------------------------------------------------
+/** snake_case → camelCase */
+export function snakeToCamel(s) {
+    return s.replace(/_([a-z])/g, (_, c) => c.toUpperCase());
+}
+/** camelCase → snake_case */
+export function camelToSnake(s) {
+    return s.replace(/[A-Z]/g, (c) => `_${c.toLowerCase()}`);
+}
+/** snake_case → PascalCase (for type names) */
+export function snakeToPascal(s) {
+    return s
+        .split('_')
+        .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+        .join('');
+}
+/** Naive singularize: "posts" → "post", "categories" → "category" */
+export function singularize(s) {
+    if (s.endsWith('ies'))
+        return s.slice(0, -3) + 'y';
+    if (s.endsWith('ses') || s.endsWith('xes') || s.endsWith('zes'))
+        return s.slice(0, -2);
+    if (s.endsWith('s') && !s.endsWith('ss'))
+        return s.slice(0, -1);
+    return s;
+}
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

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