@syncular/typegen 0.0.1-60

package/dist/render.js

@@ -0,0 +1,140 @@
+/**
+ * @syncular/typegen - TypeScript code generation
+ */
+/**
+ * Convert a snake_case table/column name to PascalCase.
+ */
+function toPascalCase(str) {
+    return str
+        .split(/[_-]/)
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+        .join('');
+}
+/**
+ * Render a single column definition.
+ */
+function renderColumn(column) {
+    // Use optional modifier for nullable columns with defaults (Generated type pattern)
+    const optional = column.hasDefault || column.nullable ? '?' : '';
+    return `  ${column.name}${optional}: ${column.tsType};`;
+}
+/**
+ * Render a table interface.
+ */
+function renderTableInterface(table, interfaceName) {
+    const columns = table.columns.map(renderColumn).join('\n');
+    return `export interface ${interfaceName} {\n${columns}\n}`;
+}
+/**
+ * Render a database interface containing all tables.
+ */
+function renderDbInterface(schema, interfaceName, extendsType) {
+    const extendsClause = extendsType ? ` extends ${extendsType}` : '';
+    const tableEntries = schema.tables
+        .map((t) => `  ${t.name}: ${toPascalCase(t.name)}Table;`)
+        .join('\n');
+    return `export interface ${interfaceName}${extendsClause} {\n${tableEntries}\n}`;
+}
+/**
+ * Render complete TypeScript type definitions.
+ */
+export function renderTypes(options) {
+    const { schemas, extendsSyncClientDb, includeVersionHistory, customImports } = options;
+    const lines = [];
+    // Header
+    lines.push('/**');
+    lines.push(' * Auto-generated database types from migrations.');
+    lines.push(' * DO NOT EDIT - regenerate with @syncular/typegen');
+    lines.push(' */');
+    lines.push('');
+    // Import SyncClientDb if extending
+    if (extendsSyncClientDb) {
+        lines.push("import type { SyncClientDb } from '@syncular/client';");
+        lines.push('');
+    }
+    // Render custom imports from resolver
+    if (customImports && customImports.length > 0) {
+        // Group imports by source module
+        const byModule = new Map();
+        for (const imp of customImports) {
+            let names = byModule.get(imp.from);
+            if (!names) {
+                names = new Set();
+                byModule.set(imp.from, names);
+            }
+            names.add(imp.name);
+        }
+        for (const [from, names] of byModule) {
+            const sorted = [...names].sort();
+            lines.push(`import type { ${sorted.join(', ')} } from '${from}';`);
+        }
+        lines.push('');
+    }
+    // Get the latest schema
+    const latestSchema = schemas[schemas.length - 1];
+    if (!latestSchema) {
+        lines.push('// No migrations defined');
+        return lines.join('\n');
+    }
+    // Generate table interfaces for latest version
+    for (const table of latestSchema.tables) {
+        lines.push(renderTableInterface(table, `${toPascalCase(table.name)}Table`));
+        lines.push('');
+    }
+    // Generate versioned DB interfaces if requested
+    if (includeVersionHistory && schemas.length > 0) {
+        for (const schema of schemas) {
+            // For each version, generate table interfaces with version suffix
+            // if they differ from the latest
+            const versionSuffix = `V${schema.version}`;
+            // Generate versioned table interfaces
+            for (const table of schema.tables) {
+                const latestTable = latestSchema.tables.find((t) => t.name === table.name);
+                // Only generate versioned interface if different from latest
+                if (latestTable && !tablesEqual(table, latestTable)) {
+                    lines.push(renderTableInterface(table, `${toPascalCase(table.name)}Table${versionSuffix}`));
+                    lines.push('');
+                }
+            }
+            // Generate versioned DB interface
+            const tableEntries = schema.tables
+                .map((t) => {
+                const latestTable = latestSchema.tables.find((lt) => lt.name === t.name);
+                const useVersioned = latestTable && !tablesEqual(t, latestTable);
+                const typeName = useVersioned
+                    ? `${toPascalCase(t.name)}Table${versionSuffix}`
+                    : `${toPascalCase(t.name)}Table`;
+                return `  ${t.name}: ${typeName};`;
+            })
+                .join('\n');
+            lines.push(`export interface ClientDb${versionSuffix} {`);
+            lines.push(tableEntries);
+            lines.push('}');
+            lines.push('');
+        }
+    }
+    // Generate main DB interface (latest version)
+    const extendsType = extendsSyncClientDb ? 'SyncClientDb' : undefined;
+    lines.push(renderDbInterface(latestSchema, 'ClientDb', extendsType));
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Check if two table schemas are equal.
+ */
+function tablesEqual(a, b) {
+    if (a.columns.length !== b.columns.length)
+        return false;
+    for (let i = 0; i < a.columns.length; i++) {
+        const colA = a.columns[i];
+        const colB = b.columns[i];
+        if (colA.name !== colB.name ||
+            colA.tsType !== colB.tsType ||
+            colA.nullable !== colB.nullable ||
+            colA.hasDefault !== colB.hasDefault) {
+            return false;
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=render.js.map

package/dist/render.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,89 @@
+/**
+ * @syncular/typegen - Type definitions
+ */
+import type { DefinedMigrations } from '@syncular/migrations';
+export type TypegenDialect = 'sqlite' | 'postgres';
+/**
+ * Column information passed to the resolver function.
+ */
+export interface ColumnInfo {
+    table: string;
+    column: string;
+    sqlType: string;
+    nullable: boolean;
+    isPrimaryKey: boolean;
+    hasDefault: boolean;
+    dialect: TypegenDialect;
+}
+/**
+ * Return type from a resolver function.
+ */
+export type TypeOverride = string | {
+    type: string;
+    import?: {
+        name: string;
+        from: string;
+    };
+};
+/**
+ * User-provided function to override default type mapping.
+ */
+export type ResolveTypeFn = (col: ColumnInfo) => TypeOverride | undefined;
+/**
+ * Parsed table schema.
+ */
+export interface TableSchema {
+    name: string;
+    columns: ColumnSchema[];
+}
+/**
+ * Parsed column schema.
+ */
+export interface ColumnSchema {
+    name: string;
+    sqlType: string;
+    tsType: string;
+    nullable: boolean;
+    isPrimaryKey: boolean;
+    hasDefault: boolean;
+}
+/**
+ * Schema snapshot at a specific version.
+ */
+export interface VersionedSchema {
+    version: number;
+    tables: TableSchema[];
+}
+/**
+ * Options for generateTypes().
+ */
+export interface GenerateTypesOptions<DB = unknown> {
+    /** Defined migrations from defineMigrations() */
+    migrations: DefinedMigrations<DB>;
+    /** Output file path for generated types */
+    output: string;
+    /** Database dialect to use for introspection (default: 'sqlite') */
+    dialect?: TypegenDialect;
+    /** Whether to extend SyncClientDb interface (adds sync infrastructure types) */
+    extendsSyncClientDb?: boolean;
+    /** Generate versioned interfaces (ClientDbV1, ClientDbV2, etc.) */
+    includeVersionHistory?: boolean;
+    /** Only generate types for these tables (default: all tables) */
+    tables?: string[];
+    /** Custom type resolver for overriding default type mapping */
+    resolveType?: ResolveTypeFn;
+}
+/**
+ * Result of type generation.
+ */
+export interface GenerateTypesResult {
+    /** Path to the generated file */
+    outputPath: string;
+    /** Current schema version */
+    currentVersion: number;
+    /** Number of tables generated */
+    tableCount: number;
+    /** Generated TypeScript code */
+    code: string;
+}
+//# 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":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,cAAc,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,MAAM,GACN;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,UAAU,KAAK,YAAY,GAAG,SAAS,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB,CAAC,EAAE,GAAG,OAAO;IAChD,iDAAiD;IACjD,UAAU,EAAE,iBAAiB,CAAC,EAAE,CAAC,CAAC;IAClC,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,gFAAgF;IAChF,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,mEAAmE;IACnE,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,aAAa,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;CACd"}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * @syncular/typegen - Type definitions
+ */
+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;;GAEG"}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@syncular/typegen",
+  "version": "0.0.1-60",
+  "description": "TypeScript type generator for Syncular schemas",
+  "license": "MIT",
+  "author": "Benjamin Kniffler",
+  "homepage": "https://syncular.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/syncular/syncular.git",
+    "directory": "packages/typegen"
+  },
+  "bugs": {
+    "url": "https://github.com/syncular/syncular/issues"
+  },
+  "keywords": [
+    "sync",
+    "offline-first",
+    "realtime",
+    "database",
+    "typescript",
+    "codegen",
+    "typescript"
+  ],
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "bun": "./src/index.ts",
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "scripts": {
+    "test": "bun test --pass-with-no-tests",
+    "tsgo": "tsgo --noEmit",
+    "build": "rm -rf dist && tsgo",
+    "release": "bun pm pack --destination . && npm publish ./*.tgz --tag latest && rm -f ./*.tgz"
+  },
+  "dependencies": {
+    "@electric-sql/pglite": "^0.3.15",
+    "@syncular/migrations": "0.0.1",
+    "better-sqlite3": "^12.6.2",
+    "kysely-pglite-dialect": "^1.2.0"
+  },
+  "peerDependencies": {
+    "kysely": "^0.28.0"
+  },
+  "devDependencies": {
+    "@syncular/config": "0.0.0",
+    "@types/better-sqlite3": "^7.6.13",
+    "kysely": "*"
+  },
+  "files": [
+    "dist",
+    "src"
+  ]
+}

package/src/generate.ts

@@ -0,0 +1,127 @@
+/**
+ * @syncular/typegen - Type generation entry point
+ */
+
+import { mkdir, writeFile } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { introspectAllVersions, introspectCurrentSchema } from './introspect';
+import { resolveColumnType } from './map-types';
+import { renderTypes } from './render';
+import type {
+  GenerateTypesOptions,
+  GenerateTypesResult,
+  ResolveTypeFn,
+  TypegenDialect,
+  VersionedSchema,
+} from './types';
+
+/**
+ * Apply type mapping to all columns in the schemas.
+ * Returns the schemas with tsType filled in and any custom imports collected.
+ */
+function applyTypeMappings(
+  schemas: VersionedSchema[],
+  dialect: TypegenDialect,
+  resolveType?: ResolveTypeFn
+): {
+  schemas: VersionedSchema[];
+  customImports: Array<{ name: string; from: string }>;
+} {
+  const allImports: Array<{ name: string; from: string }> = [];
+
+  const mapped = schemas.map((schema) => ({
+    ...schema,
+    tables: schema.tables.map((table) => ({
+      ...table,
+      columns: table.columns.map((col) => {
+        const resolved = resolveColumnType(
+          {
+            table: table.name,
+            column: col.name,
+            sqlType: col.sqlType,
+            nullable: col.nullable,
+            isPrimaryKey: col.isPrimaryKey,
+            hasDefault: col.hasDefault,
+            dialect,
+          },
+          resolveType
+        );
+        allImports.push(...resolved.imports);
+        return {
+          ...col,
+          tsType: resolved.tsType,
+        };
+      }),
+    })),
+  }));
+
+  return { schemas: mapped, customImports: allImports };
+}
+
+/**
+ * Generate TypeScript types from migrations.
+ *
+ * @example
+ * ```typescript
+ * import { generateTypes } from '@syncular/typegen';
+ * import { migrations } from './migrations';
+ *
+ * await generateTypes({
+ *   migrations,
+ *   output: './src/db.generated.ts',
+ *   extendsSyncClientDb: true,
+ * });
+ * ```
+ */
+export async function generateTypes<DB>(
+  options: GenerateTypesOptions<DB>
+): Promise<GenerateTypesResult> {
+  const {
+    migrations,
+    output,
+    extendsSyncClientDb,
+    includeVersionHistory,
+    tables,
+    dialect = 'sqlite',
+    resolveType,
+  } = options;
+
+  // Introspect schemas (raw SQL types, no TS mapping yet)
+  let rawSchemas: VersionedSchema[];
+  if (includeVersionHistory) {
+    rawSchemas = await introspectAllVersions(migrations, dialect, tables);
+  } else {
+    const current = await introspectCurrentSchema(migrations, dialect, tables);
+    rawSchemas = [current];
+  }
+
+  // Apply type mapping (default + user resolver)
+  const { schemas, customImports } = applyTypeMappings(
+    rawSchemas,
+    dialect,
+    resolveType
+  );
+
+  // Render TypeScript code
+  const code = renderTypes({
+    schemas,
+    extendsSyncClientDb,
+    includeVersionHistory,
+    customImports,
+  });
+
+  // Ensure output directory exists
+  await mkdir(dirname(output), { recursive: true });
+
+  // Write the file
+  await writeFile(output, code, 'utf-8');
+
+  const latestSchema = schemas[schemas.length - 1];
+
+  return {
+    outputPath: output,
+    currentVersion: migrations.currentVersion,
+    tableCount: latestSchema?.tables.length ?? 0,
+    code,
+  };
+}

package/src/index.ts

@@ -0,0 +1,14 @@
+/**
+ * @syncular/typegen - Generate TypeScript types from migrations
+ *
+ * Creates type definitions by:
+ * 1. Applying migrations to an in-memory database (SQLite or PostgreSQL)
+ * 2. Introspecting the resulting schema
+ * 3. Generating TypeScript interfaces
+ */
+
+export * from './generate';
+export * from './introspect';
+export * from './map-types';
+export * from './render';
+export * from './types';

package/src/introspect-postgres.ts

@@ -0,0 +1,149 @@
+/**
+ * @syncular/typegen - PostgreSQL schema introspection via PGlite
+ */
+
+import { PGlite } from '@electric-sql/pglite';
+import type { DefinedMigrations } from '@syncular/migrations';
+import { Kysely } from 'kysely';
+import { PGliteDialect } from 'kysely-pglite-dialect';
+import type { TableSchema, VersionedSchema } from './types';
+
+interface PgColumn {
+  table_name: string;
+  column_name: string;
+  data_type: string;
+  udt_name: string;
+  is_nullable: string;
+  column_default: string | null;
+  ordinal_position: number;
+}
+
+interface PgPrimaryKey {
+  table_name: string;
+  column_name: string;
+}
+
+async function introspectPg(pglite: PGlite): Promise<TableSchema[]> {
+  const colResult = await pglite.query<PgColumn>(
+    `SELECT table_name, column_name, data_type, udt_name,
+            is_nullable, column_default, ordinal_position
+     FROM information_schema.columns
+     WHERE table_schema = 'public'
+     ORDER BY table_name, ordinal_position`
+  );
+
+  const pkResult = await pglite.query<PgPrimaryKey>(
+    `SELECT kcu.column_name, tc.table_name
+     FROM information_schema.table_constraints tc
+     JOIN information_schema.key_column_usage kcu
+       ON tc.constraint_name = kcu.constraint_name
+          AND tc.table_schema = kcu.table_schema
+     WHERE tc.constraint_type = 'PRIMARY KEY' AND tc.table_schema = 'public'`
+  );
+
+  const pkSet = new Set(
+    pkResult.rows.map((r) => `${r.table_name}.${r.column_name}`)
+  );
+
+  const tableMap = new Map<string, TableSchema>();
+
+  for (const col of colResult.rows) {
+    let table = tableMap.get(col.table_name);
+    if (!table) {
+      table = { name: col.table_name, columns: [] };
+      tableMap.set(col.table_name, table);
+    }
+
+    const isPrimaryKey = pkSet.has(`${col.table_name}.${col.column_name}`);
+    const nullable = col.is_nullable === 'YES' && !isPrimaryKey;
+    const hasDefault = col.column_default !== null;
+
+    // Use udt_name for more precise type info (e.g. int4 instead of "integer")
+    // For arrays, data_type is "ARRAY" and udt_name starts with "_"
+    let sqlType: string;
+    if (col.data_type === 'ARRAY' && col.udt_name.startsWith('_')) {
+      // Convert _int4 → int4[], _text → text[], etc.
+      sqlType = `${col.udt_name.slice(1)}[]`;
+    } else if (col.data_type === 'USER-DEFINED') {
+      sqlType = col.udt_name;
+    } else {
+      sqlType = col.udt_name;
+    }
+
+    table.columns.push({
+      name: col.column_name,
+      sqlType,
+      tsType: '', // resolved later by map-types
+      nullable,
+      isPrimaryKey,
+      hasDefault,
+    });
+  }
+
+  // Sort tables by name for deterministic output
+  return [...tableMap.values()].sort((a, b) => a.name.localeCompare(b.name));
+}
+
+async function introspectAtVersion<DB = unknown>(
+  migrations: DefinedMigrations<DB>,
+  targetVersion: number,
+  filterTables?: string[]
+): Promise<VersionedSchema> {
+  const pglite = await PGlite.create();
+
+  try {
+    const db = new Kysely<DB>({
+      dialect: new PGliteDialect(pglite),
+    });
+
+    for (const migration of migrations.migrations) {
+      if (migration.version > targetVersion) break;
+      await migration.fn(db);
+    }
+
+    await db.destroy();
+
+    let tables = await introspectPg(pglite);
+
+    if (filterTables && filterTables.length > 0) {
+      const filterSet = new Set(filterTables);
+      tables = tables.filter((t) => filterSet.has(t.name));
+    }
+
+    return {
+      version: targetVersion,
+      tables,
+    };
+  } finally {
+    await pglite.close();
+  }
+}
+
+export async function introspectPostgresAllVersions<DB = unknown>(
+  migrations: DefinedMigrations<DB>,
+  filterTables?: string[]
+): Promise<VersionedSchema[]> {
+  const schemas: VersionedSchema[] = [];
+
+  for (const migration of migrations.migrations) {
+    const schema = await introspectAtVersion(
+      migrations,
+      migration.version,
+      filterTables
+    );
+    schemas.push(schema);
+  }
+
+  return schemas;
+}
+
+export async function introspectPostgresCurrentSchema<DB = unknown>(
+  migrations: DefinedMigrations<DB>,
+  filterTables?: string[]
+): Promise<VersionedSchema> {
+  return introspectAtVersion(
+    migrations,
+    migrations.currentVersion,
+    filterTables
+  );
+}