@jantokic/chtype 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 chtype contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,192 @@
+# chtype
+
+**Type-safe ClickHouse toolkit for TypeScript.**
+
+Generate TypeScript types from your ClickHouse schema, then query with full IDE autocomplete and compile-time validation.
+
+```bash
+npm install chtype
+# or
+bun add chtype
+```
+
+## Why chtype?
+
+ClickHouse has no mature ORM for TypeScript. The official `@clickhouse/client` is excellent but gives you raw SQL strings — typos in column names only fail at runtime, result types are manually maintained, and schema drift silently breaks your code.
+
+chtype fixes this with three subpath imports:
+
+| Import | What it does |
+|---|---|
+| `chtype/codegen` | Introspects your ClickHouse DB and generates TypeScript interfaces |
+| `chtype/query` | Type-safe query builder with ClickHouse-specific functions (argMax, FINAL, SETTINGS) |
+| `chtype/client` | Thin wrapper over `@clickhouse/client` that connects query builder to execution |
+
+## Quick Start
+
+### 1. Generate types from your database
+
+```bash
+npx chtype generate \
+  --host http://localhost:8123 \
+  --database my_db \
+  --output ./src/generated/schema.ts
+```
+
+This produces a file like:
+
+```typescript
+// @generated by chtype — do not edit manually
+
+/**
+ * Table: `users`
+ * Engine: ReplacingMergeTree(updated_at)
+ * ORDER BY: (user_id)
+ */
+export interface UsersRow {
+  user_id: string;
+  name: string;
+  score: number | null;
+  tags: string[];
+  updated_at: string;
+}
+
+/** Insert type for `users` — DEFAULT columns are optional. */
+export interface UsersInsert {
+  user_id: string;
+  name: string;
+  score?: number | null;
+  tags?: string[];
+  updated_at?: string;
+}
+
+export interface Database {
+  users: {
+    row: UsersRow;
+    insert: UsersInsert;
+    engine: "ReplacingMergeTree";
+    versionColumn: "updated_at";
+  };
+}
+```
+
+### 2. Query with full type safety
+
+```typescript
+import { createQueryBuilder } from 'chtype/query';
+import { createClient } from 'chtype/client';
+import type { Database } from './generated/schema';
+
+const qb = createQueryBuilder<Database>();
+const ch = createClient<Database>({
+  url: 'http://localhost:8123',
+  database: 'my_db',
+});
+
+// Column names autocomplete — typos caught at compile time
+const query = qb
+  .selectFrom('users')
+  .select(['user_id', 'name', 'score'])
+  .where('score', '>', qb.param('minScore', 'Float64'))
+  .orderBy('score', 'DESC')
+  .limit(20)
+  .compile();
+
+const users = await ch.execute(query);
+```
+
+### 3. ClickHouse-specific features
+
+```typescript
+// argMax — first-class citizen for ReplacingMergeTree tables
+const latest = qb
+  .selectFrom('users')
+  .select([
+    'user_id',
+    qb.fn.argMax('name', 'updated_at').as('name'),
+    qb.fn.argMax('score', 'updated_at').as('score'),
+  ])
+  .groupBy('user_id')
+  .compile();
+
+// FINAL modifier (for debug/audit only)
+const withFinal = qb
+  .selectFrom('users')
+  .select(['user_id', 'name'])
+  .final()
+  .compile();
+
+// SETTINGS clause
+const withSettings = qb
+  .selectFrom('users')
+  .select(['user_id'])
+  .settings({ max_execution_time: 30 })
+  .compile();
+
+// Type-safe inserts — MATERIALIZED columns excluded, DEFAULT columns optional
+await ch.insert('users', [
+  { user_id: '123', name: 'Alice' },
+  { user_id: '456', name: 'Bob', score: 42 },
+]);
+```
+
+### 4. All values are parameterized
+
+The query builder **only** accepts `Param` or `Expression` values in WHERE clauses — raw strings are not allowed. This makes SQL injection impossible by design.
+
+```typescript
+// This is the only way to pass values — always safe
+qb.selectFrom('users')
+  .where('name', '=', qb.param('name', 'String'))
+
+// Raw strings in WHERE are a type error — won't compile
+```
+
+## Config File
+
+Instead of CLI flags, use a `chtype.config.ts` file:
+
+```typescript
+import { defineConfig } from 'chtype/codegen';
+
+export default defineConfig({
+  connection: {
+    host: 'http://localhost:8123',
+    database: 'my_db',
+    username: 'default',
+    password: process.env.CLICKHOUSE_PASSWORD,
+  },
+  output: './src/generated/schema.ts',
+  bigints: true,  // set to true to map UInt64/Int64 to bigint instead of string
+  include: ['users', 'events', 'market_*'],
+  exclude: [],
+});
+```
+
+Then run:
+
+```bash
+npx chtype generate --config chtype.config.ts
+```
+
+## How It Compares
+
+| Feature | chtype | Raw @clickhouse/client | Kysely + CH dialect | hypequery |
+|---|---|---|---|---|
+| Column autocomplete | Yes | No | Yes (limited) | Yes |
+| Schema drift detection | Yes (codegen) | No | No | Yes (codegen) |
+| argMax / FINAL / SETTINGS | Yes | Manual SQL | No | No |
+| Insert type validation | Yes (Row vs Insert) | No | No | No |
+| Engine metadata in types | Yes | No | No | Partial |
+| Zero runtime overhead | Yes | N/A | Yes | No (framework) |
+| SQL injection prevention | By design | Manual | By design | By design |
+
+## Requirements
+
+- Node.js >= 20 or Bun
+- TypeScript >= 5.0
+- ClickHouse server (any recent version)
+
+## License
+
+MIT

package/dist/client/client.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Type-safe ClickHouse client.
+ *
+ * Wraps @clickhouse/client with schema-aware methods.
+ */
+import { type ClickHouseClient as BaseClient, type ClickHouseClientConfigOptions } from '@clickhouse/client';
+import type { CompiledQuery, DatabaseSchema, InsertType, TableName } from '../query/types.js';
+export interface ChtypeClient<DB extends DatabaseSchema> {
+    /** Execute a compiled query and return typed rows. */
+    execute<T = Record<string, unknown>>(query: CompiledQuery): Promise<T[]>;
+    /** Execute a raw SQL query with optional parameters. */
+    query<T = Record<string, unknown>>(sql: string, params?: Record<string, unknown>): Promise<T[]>;
+    /** Insert rows into a table. Type-checked against the table's Insert type. */
+    insert<T extends TableName<DB>>(table: T, rows: InsertType<DB, T>[]): Promise<void>;
+    /**
+     * Execute a DDL/ALTER command (raw SQL, no parameterization).
+     *
+     * WARNING: Never interpolate user input into the SQL string passed here.
+     * This method is for DDL statements only (CREATE TABLE, ALTER TABLE, etc.)
+     * where ClickHouse does not support parameterized queries.
+     */
+    command(sql: string): Promise<void>;
+    close(): Promise<void>;
+    readonly raw: BaseClient;
+}
+/**
+ * Create a type-safe ClickHouse client.
+ *
+ * @example
+ * ```ts
+ * import { createClient } from 'chtype/client';
+ * import type { Database } from './chtype.generated';
+ *
+ * const ch = createClient<Database>({
+ *   url: 'http://localhost:8123',
+ *   database: 'my_db',
+ * });
+ * ```
+ */
+export declare function createClient<DB extends DatabaseSchema>(options: ClickHouseClientConfigOptions): ChtypeClient<DB>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client/client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,KAAK,gBAAgB,IAAI,UAAU,EACnC,KAAK,6BAA6B,EAEnC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9F,MAAM,WAAW,YAAY,CAAC,EAAE,SAAS,cAAc;IACrD,sDAAsD;IACtD,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAEzE,wDAAwD;IACxD,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAEhG,8EAA8E;IAC9E,MAAM,CAAC,CAAC,SAAS,SAAS,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpF;;;;;;OAMG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;CAC1B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,EAAE,SAAS,cAAc,EACpD,OAAO,EAAE,6BAA6B,GACrC,YAAY,CAAC,EAAE,CAAC,CA8ClB"}

package/dist/client/client.js

@@ -0,0 +1,60 @@
+/**
+ * Type-safe ClickHouse client.
+ *
+ * Wraps @clickhouse/client with schema-aware methods.
+ */
+import { createClient as createBaseClient, } from '@clickhouse/client';
+/**
+ * Create a type-safe ClickHouse client.
+ *
+ * @example
+ * ```ts
+ * import { createClient } from 'chtype/client';
+ * import type { Database } from './chtype.generated';
+ *
+ * const ch = createClient<Database>({
+ *   url: 'http://localhost:8123',
+ *   database: 'my_db',
+ * });
+ * ```
+ */
+export function createClient(options) {
+    const client = createBaseClient(options);
+    return {
+        async execute(query) {
+            const result = await client.query({
+                query: query.sql,
+                query_params: query.params,
+                format: 'JSONEachRow',
+            });
+            return result.json();
+        },
+        async query(sql, params) {
+            const result = await client.query({
+                query: sql,
+                query_params: params,
+                format: 'JSONEachRow',
+            });
+            return result.json();
+        },
+        async insert(table, rows) {
+            if (rows.length === 0)
+                return;
+            await client.insert({
+                table: table,
+                values: rows,
+                format: 'JSONEachRow',
+            });
+        },
+        async command(sql) {
+            await client.command({ query: sql });
+        },
+        async close() {
+            await client.close();
+        },
+        get raw() {
+            return client;
+        },
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/client/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client/client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAGL,YAAY,IAAI,gBAAgB,GACjC,MAAM,oBAAoB,CAAC;AA0B5B;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,YAAY,CAC1B,OAAsC;IAEtC,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAEzC,OAAO;QACL,KAAK,CAAC,OAAO,CAA8B,KAAoB;YAC7D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC;gBAChC,KAAK,EAAE,KAAK,CAAC,GAAG;gBAChB,YAAY,EAAE,KAAK,CAAC,MAAM;gBAC1B,MAAM,EAAE,aAAa;aACtB,CAAC,CAAC;YACH,OAAO,MAAM,CAAC,IAAI,EAAK,CAAC;QAC1B,CAAC;QAED,KAAK,CAAC,KAAK,CACT,GAAW,EACX,MAAgC;YAEhC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC;gBAChC,KAAK,EAAE,GAAG;gBACV,YAAY,EAAE,MAAM;gBACpB,MAAM,EAAE,aAAa;aACtB,CAAC,CAAC;YACH,OAAO,MAAM,CAAC,IAAI,EAAK,CAAC;QAC1B,CAAC;QAED,KAAK,CAAC,MAAM,CAA0B,KAAQ,EAAE,IAAyB;YACvE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO;YAC9B,MAAM,MAAM,CAAC,MAAM,CAAC;gBAClB,KAAK,EAAE,KAAe;gBACtB,MAAM,EAAE,IAAI;gBACZ,MAAM,EAAE,aAAa;aACtB,CAAC,CAAC;QACL,CAAC;QAED,KAAK,CAAC,OAAO,CAAC,GAAW;YACvB,MAAM,MAAM,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QACvC,CAAC;QAED,KAAK,CAAC,KAAK;YACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;QAED,IAAI,GAAG;YACL,OAAO,MAAM,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/client/index.d.ts

@@ -0,0 +1,2 @@
+export { createClient, type ChtypeClient } from './client.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/client/index.js

@@ -0,0 +1,2 @@
+export { createClient } from './client.js';
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAqB,MAAM,aAAa,CAAC"}

package/dist/codegen/cli.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * chtype CLI — Generate TypeScript types from your ClickHouse schema.
+ *
+ * Usage:
+ *   npx chtype generate --host http://localhost:8123 --database my_db
+ *   npx chtype generate --config chtype.config.ts
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/codegen/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/codegen/cli.ts"],"names":[],"mappings":";AAEA;;;;;;GAMG"}

package/dist/codegen/cli.js

@@ -0,0 +1,100 @@
+#!/usr/bin/env node
+/**
+ * chtype CLI — Generate TypeScript types from your ClickHouse schema.
+ *
+ * Usage:
+ *   npx chtype generate --host http://localhost:8123 --database my_db
+ *   npx chtype generate --config chtype.config.ts
+ */
+import { writeFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { createClient } from '@clickhouse/client';
+import { defineCommand, runMain } from 'citty';
+import { ChtypeConfigSchema, loadConfigFile } from './config.js';
+import { generate } from './generator.js';
+import { introspect } from './introspect.js';
+const generateCommand = defineCommand({
+    meta: {
+        name: 'generate',
+        description: 'Generate TypeScript types from a ClickHouse database',
+    },
+    args: {
+        host: { type: 'string', description: 'ClickHouse HTTP URL', default: 'http://localhost:8123' },
+        database: { type: 'string', description: 'Database name' },
+        username: { type: 'string', description: 'ClickHouse username', default: 'default' },
+        password: { type: 'string', description: 'ClickHouse password', default: '' },
+        output: { type: 'string', alias: 'o', description: 'Output file path', default: './chtype.generated.ts' },
+        bigints: { type: 'boolean', description: 'Map UInt64/Int64 to bigint instead of string', default: false },
+        include: { type: 'string', description: 'Comma-separated table name patterns to include' },
+        exclude: { type: 'string', description: 'Comma-separated table name patterns to exclude' },
+        config: { type: 'string', alias: 'c', description: 'Path to config file (chtype.config.ts)' },
+    },
+    async run({ args }) {
+        let config;
+        if (args.config) {
+            const fileConfig = await loadConfigFile(resolve(args.config));
+            if (!fileConfig) {
+                process.exit(1);
+            }
+            config = fileConfig;
+        }
+        else {
+            config = ChtypeConfigSchema.parse({
+                connection: {
+                    host: args.host,
+                    database: args.database,
+                    username: args.username,
+                    password: args.password,
+                },
+                output: args.output,
+                bigints: args.bigints,
+                include: args.include ? args.include.split(',').map((s) => s.trim()) : [],
+                exclude: args.exclude ? args.exclude.split(',').map((s) => s.trim()) : [],
+            });
+        }
+        if (!config.connection.database) {
+            console.error('Error: --database is required');
+            process.exit(1);
+        }
+        console.log(`Connecting to ${config.connection.host}...`);
+        console.log(`Database: ${config.connection.database}`);
+        const client = createClient({
+            url: config.connection.host,
+            database: config.connection.database,
+            username: config.connection.username,
+            password: config.connection.password,
+        });
+        try {
+            const tables = await introspect(client, config.connection.database, {
+                include: config.include,
+                exclude: config.exclude,
+            });
+            console.log(`Found ${tables.length} tables`);
+            for (const table of tables) {
+                console.log(`  ${table.name} (${table.engine}, ${table.columns.length} columns)`);
+            }
+            const output = generate(tables, {
+                database: config.connection.database,
+                bigints: config.bigints,
+            });
+            const outPath = resolve(config.output);
+            writeFileSync(outPath, output, 'utf-8');
+            console.log(`\nWrote ${tables.length} table types to ${outPath}`);
+        }
+        finally {
+            await client.close();
+        }
+    },
+});
+const main = defineCommand({
+    meta: {
+        name: 'chtype',
+        version: '0.1.0',
+        description: 'Type-safe ClickHouse toolkit for TypeScript',
+    },
+    subCommands: {
+        generate: generateCommand,
+    },
+});
+runMain(main);
+//# sourceMappingURL=cli.js.map

package/dist/codegen/cli.js.map

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

package/dist/codegen/config.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Configuration for chtype codegen.
+ */
+import { z } from 'zod';
+export declare const ChtypeConfigSchema: z.ZodObject<{
+    connection: z.ZodObject<{
+        host: z.ZodDefault<z.ZodString>;
+        database: z.ZodString;
+        username: z.ZodDefault<z.ZodString>;
+        password: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        host: string;
+        database: string;
+        username: string;
+        password: string;
+    }, {
+        database: string;
+        host?: string | undefined;
+        username?: string | undefined;
+        password?: string | undefined;
+    }>;
+    output: z.ZodDefault<z.ZodString>;
+    bigints: z.ZodDefault<z.ZodBoolean>;
+    include: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    exclude: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    connection: {
+        host: string;
+        database: string;
+        username: string;
+        password: string;
+    };
+    output: string;
+    bigints: boolean;
+    include: string[];
+    exclude: string[];
+}, {
+    connection: {
+        database: string;
+        host?: string | undefined;
+        username?: string | undefined;
+        password?: string | undefined;
+    };
+    output?: string | undefined;
+    bigints?: boolean | undefined;
+    include?: string[] | undefined;
+    exclude?: string[] | undefined;
+}>;
+export type ChtypeConfig = z.infer<typeof ChtypeConfigSchema>;
+/**
+ * Helper for defining a typed config file.
+ *
+ * @example
+ * ```ts
+ * // chtype.config.ts
+ * import { defineConfig } from 'chtype/codegen';
+ *
+ * export default defineConfig({
+ *   connection: {
+ *     host: 'http://localhost:8123',
+ *     database: 'my_db',
+ *   },
+ *   output: './src/generated/schema.ts',
+ * });
+ * ```
+ */
+export declare function defineConfig(config: z.input<typeof ChtypeConfigSchema>): ChtypeConfig;
+/**
+ * Load config from a file path. Uses dynamic import to support .ts files
+ * (requires Bun, tsx, or similar TypeScript-aware runtime).
+ */
+export declare function loadConfigFile(configPath: string): Promise<ChtypeConfig | null>;
+//# sourceMappingURL=config.d.ts.map

package/dist/codegen/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/codegen/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAW7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,GAAG,YAAY,CAErF;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAUrF"}

package/dist/codegen/config.js

@@ -0,0 +1,53 @@
+/**
+ * Configuration for chtype codegen.
+ */
+import { z } from 'zod';
+export const ChtypeConfigSchema = z.object({
+    connection: z.object({
+        host: z.string().url().default('http://localhost:8123'),
+        database: z.string().min(1),
+        username: z.string().default('default'),
+        password: z.string().default(''),
+    }),
+    output: z.string().default('./chtype.generated.ts'),
+    bigints: z.boolean().default(false),
+    include: z.array(z.string()).default([]),
+    exclude: z.array(z.string()).default([]),
+});
+/**
+ * Helper for defining a typed config file.
+ *
+ * @example
+ * ```ts
+ * // chtype.config.ts
+ * import { defineConfig } from 'chtype/codegen';
+ *
+ * export default defineConfig({
+ *   connection: {
+ *     host: 'http://localhost:8123',
+ *     database: 'my_db',
+ *   },
+ *   output: './src/generated/schema.ts',
+ * });
+ * ```
+ */
+export function defineConfig(config) {
+    return ChtypeConfigSchema.parse(config);
+}
+/**
+ * Load config from a file path. Uses dynamic import to support .ts files
+ * (requires Bun, tsx, or similar TypeScript-aware runtime).
+ */
+export async function loadConfigFile(configPath) {
+    try {
+        const mod = await import(configPath);
+        const raw = mod.default ?? mod;
+        return ChtypeConfigSchema.parse(raw);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(`Failed to load config from ${configPath}: ${message}`);
+        return null;
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/codegen/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/codegen/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,uBAAuB,CAAC;QACvD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC;QACvC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;KACjC,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,uBAAuB,CAAC;IACnD,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACnC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACxC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACzC,CAAC,CAAC;AAIH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,YAAY,CAAC,MAA0C;IACrE,OAAO,kBAAkB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAC1C,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,UAAkB;IACrD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;QACrC,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC;QAC/B,OAAO,kBAAkB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,CAAC,KAAK,CAAC,8BAA8B,UAAU,KAAK,OAAO,EAAE,CAAC,CAAC;QACtE,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/codegen/generator.d.ts

@@ -0,0 +1,16 @@
+/**
+ * TypeScript code generator.
+ *
+ * Takes introspected table metadata and generates:
+ * - Per-table Row interfaces (for SELECT results)
+ * - Per-table Insert interfaces (DEFAULT fields optional, MATERIALIZED/ALIAS excluded)
+ * - A Database registry type mapping table names to their types + engine metadata
+ */
+import type { IntrospectedTable } from './introspect.js';
+import { type TypeMapperOptions } from './type-mapper.js';
+export interface GeneratorOptions extends TypeMapperOptions {
+    database: string;
+    command?: string;
+}
+export declare function generate(tables: IntrospectedTable[], options: GeneratorOptions): string;
+//# sourceMappingURL=generator.d.ts.map

package/dist/codegen/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/codegen/generator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAsB,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EAAE,KAAK,iBAAiB,EAAqB,MAAM,kBAAkB,CAAC;AAE7E,MAAM,WAAW,gBAAiB,SAAQ,iBAAiB;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA+ED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,EAAE,EAAE,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAqBvF"}