@lyku/lockstep-pg 0.1.1

package/LLMs.md

@@ -0,0 +1,86 @@
+# @lyku/lockstep-pg - LLMs Guide
+
+## Purpose
+
+Generic PostgreSQL migration toolkit that operates on `@lyku/lockstep-core` schema definitions. It bridges the gap between code-defined table models and a live database by introspecting, diffing, and generating SQL.
+
+## Architecture
+
+```
+Code Models (PostgresTableModel)
+    |
+    v
+modelToIntrospected() --- normalize to IntrospectedTable
+    |                              |
+    v                              v
+introspectDatabase() ---------> diffDatabase()
+    |                              |
+    v                              v
+IntrospectedTable (from DB)    DiffOperation[]
+    |                              |
+    v                              v
+detectDrift() ---------> driftToSql() / generateMigrationSql()
+    |                              |
+    v                              v
+Drift[]                        SQL strings (safe + destructive)
+```
+
+Two parallel paths exist:
+
+1. **Legacy drift path**: `detectDrift()` -> `driftToSql()` -- single function connects to DB, returns flat drift list
+2. **Structured diff path**: `introspectDatabase()` -> `diffDatabase()` -> `generateMigrationSql()` -- composable pipeline with typed operations
+
+## Key Types
+
+- `DataformConfig` -- `{ tables: Record<string, PostgresTableModel> }`
+- `Drift` -- flat drift record with type, table, details, column, expected/actual
+- `IntrospectedTable` -- normalized table representation (columns as Map, indexes, PKs, unique constraints, FKs)
+- `IntrospectedColumn` -- column with normalized type, nullable, default, enum values, array item type
+- `DiffOperation` -- discriminated union of 14 operation types (create_table, add_column, alter_column_type, etc.)
+
+## File Structure
+
+```
+src/
+  index.ts              -- Public API re-exports
+  drift.ts              -- detectDrift() - connects to DB, returns Drift[]
+  introspect.ts         -- introspectTable/Database(), modelToIntrospected(), normalizeDbType()
+  diff.ts               -- diffTable/Database(), categorizeOperations()
+  migrate.ts            -- driftToSql(), generateMigration() (legacy drift path)
+  generateSql.ts        -- operationToSql(), generateMigrationSql() (structured diff path)
+  form.ts               -- generateCreateTablesSql()
+  seed.ts               -- generateSeedSql()
+  setupTable.ts         -- Full CREATE TABLE + indexes + triggers for one table
+  createTable.ts        -- buildTableCreationCommand()
+  buildTableIndexCommand.ts    -- buildTableIndexCommands()
+  buildTableTriggerCommands.ts -- buildTableTriggerCommands()
+  mapColumnType.ts      -- Master column type mapper
+  map*Type.ts           -- Per-type mappers (bigint, serial, varchar, array, etc.)
+  dateToPostgresString.ts      -- Date formatting
+  numberChecks.ts       -- CHECK constraint SQL for numeric bounds
+  timestampChecks.ts    -- CHECK constraint SQL for timestamp bounds
+```
+
+## Key Patterns
+
+- **Type normalization**: Both DB types and schema types are normalized to canonical forms before comparison (e.g., `int8` -> `bigint`, `character varying` -> `varchar`, `user-defined` -> `text`)
+- **Enum as TEXT + CHECK**: Enums are stored as `TEXT` columns with `CHECK (col IN ('a', 'b'))` constraints, not PostgreSQL enum types
+- **Safe vs destructive**: All operations are categorized -- additive changes (ADD COLUMN, CREATE INDEX) are safe; DROP operations are destructive and output separately
+- **Serial detection**: `bigserial`/`serial` columns are stored as `bigint`/`integer` in Postgres with `nextval()` defaults -- the introspector detects this pattern
+- **Array type inference**: Array columns carry `arrayItemType` metadata to generate correct `TYPE[]` SQL
+
+## Gotchas
+
+- `detectDrift()` creates its own `pg.Client` with `ssl: true` hardcoded -- won't work with non-SSL connections
+- The legacy `Drift` type and the structured `DiffOperation` type are parallel systems that don't share code
+- `modelToIntrospected()` generates synthetic index names (`idx_tableName_col`) that won't match actual DB index names -- comparison is column-based, not name-based
+- Foreign key diff can generate drops for manually-created constraints not in the schema
+- `escapeString` in migrate.ts and seed.ts is duplicated
+
+## Monorepo Connections
+
+- **Input**: `@lyku/lockstep-core` (PostgresTableModel, PostgresRecordModel, PostgresColumnModel types)
+- **Consumer**: `apps/dataform` (CLI scripts that call these functions)
+- **Data source**: `@lyku/pg-config` (the actual table registry passed as DataformConfig)
+- **Peer dep**: `@lyku/lockstep-core >= 0.2.0`
+- **Runtime dep**: `pg` for database connections

package/README.md

@@ -0,0 +1,93 @@
+# @lyku/lockstep-pg
+
+Schema-driven PostgreSQL migration toolkit for [`@lyku/lockstep-core`](../from-schema) models. Detects drift between your code-defined schemas and the live database, then generates safe (and optionally destructive) SQL migrations.
+
+## Features
+
+- **Drift detection** - Compare `PostgresTableModel` definitions against a live PostgreSQL database
+- **Introspection** - Read table structure, indexes, constraints, and foreign keys from any Postgres database
+- **Diff engine** - Structural diff between introspected tables and code models, categorized into safe vs. destructive operations
+- **SQL generation** - Produces migration SQL from diffs or drift reports, including `CREATE TABLE`, `ALTER COLUMN`, `ADD INDEX`, enum `CHECK` constraint updates, and stock document seeding
+- **Seed data** - Generate `INSERT ... ON CONFLICT DO NOTHING` statements for stock/fixture documents defined in table models
+
+## Usage
+
+### Detect drift
+
+```typescript
+import { detectDrift } from '@lyku/lockstep-pg';
+import { tables } from '@lyku/pg-config';
+
+const drifts = await detectDrift(process.env.PG_CONNECTION_STRING, { tables });
+// Returns Drift[] - missing tables, extra columns, type mismatches, missing indexes, etc.
+```
+
+### Generate a migration
+
+```typescript
+import { generateMigration } from '@lyku/lockstep-pg';
+import { tables } from '@lyku/pg-config';
+
+const { safe, destructive, driftCount } = await generateMigration(process.env.PG_CONNECTION_STRING, { tables });
+// safe: SQL string wrapped in BEGIN/COMMIT (additive changes)
+// destructive: SQL string for DROP operations (review carefully)
+```
+
+### Introspect a database
+
+```typescript
+import { Client } from 'pg';
+import { introspectDatabase, introspectTable } from '@lyku/lockstep-pg';
+
+const client = new Client({ connectionString: '...' });
+await client.connect();
+
+// Single table
+const table = await introspectTable(client, 'users');
+
+// All tables
+const allTables = await introspectDatabase(client);
+
+await client.end();
+```
+
+### Diff and generate SQL
+
+```typescript
+import { diffDatabase, categorizeOperations } from '@lyku/lockstep-pg';
+import { generateMigrationSql } from '@lyku/lockstep-pg';
+
+const ops = diffDatabase(dbTables, codeTables);
+const { safe, destructive } = categorizeOperations(ops);
+const sql = generateMigrationSql(ops);
+```
+
+### Generate seed SQL
+
+```typescript
+import { generateSeedSql } from '@lyku/lockstep-pg';
+import { tables } from '@lyku/pg-config';
+
+const sql = generateSeedSql({ tables });
+// INSERT ... ON CONFLICT DO NOTHING for each table's `docs` array
+```
+
+## Drift types
+
+| Type                        | Description                                      |
+| --------------------------- | ------------------------------------------------ |
+| `missing_table`             | Table defined in schema but absent from database |
+| `extra_table`               | Table in database but not in schema              |
+| `missing_column`            | Column defined in schema but absent from table   |
+| `extra_column`              | Column in table but not in schema                |
+| `column_type_mismatch`      | Column type differs between schema and database  |
+| `nullable_mismatch`         | NOT NULL constraint differs                      |
+| `missing_index`             | Index defined in schema but absent from database |
+| `extra_index`               | Index in database but not in schema              |
+| `missing_constraint`        | CHECK constraint missing for enum column         |
+| `check_constraint_mismatch` | Enum CHECK constraint values differ              |
+| `missing_stock_doc`         | Fixture/seed record missing from table           |
+
+## License
+
+GPL-3.0

package/package.json

@@ -0,0 +1,32 @@
+{
+	"name": "@lyku/lockstep-pg",
+	"version": "0.1.1",
+	"description": "Schema-driven PostgreSQL migration toolkit: drift detection, introspection, and SQL generation for @lyku/lockstep-core models",
+	"main": "./src/index.js",
+	"types": "./src/index.d.ts",
+	"type": "module",
+	"license": "GPL-3.0",
+	"exports": {
+		".": {
+			"types": "./src/index.d.ts",
+			"import": "./src/index.js",
+			"default": "./src/index.js"
+		}
+	},
+	"peerDependencies": {
+		"@lyku/lockstep-core": ">=0.2.0"
+	},
+	"dependencies": {
+		"pg": "^8.0.0"
+	},
+	"keywords": [
+		"postgresql",
+		"migration",
+		"schema",
+		"drift",
+		"introspection",
+		"lockstep",
+		"lockstep-core"
+	],
+	"module": "./src/index.js"
+}

package/src/buildTableIndexCommand.d.ts

@@ -0,0 +1,3 @@
+import { PostgresRecordModel, PostgresTableModel } from '@lyku/lockstep-core';
+export declare function buildTableIndexCommands<T extends PostgresTableModel<PostgresRecordModel>>(tableName: string, model: T): string[];
+//# sourceMappingURL=buildTableIndexCommand.d.ts.map

package/src/buildTableIndexCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildTableIndexCommand.d.ts","sourceRoot":"","sources":["../../../../libs/lockstep-pg/src/buildTableIndexCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9E,wBAAgB,uBAAuB,CACtC,CAAC,SAAS,kBAAkB,CAAC,mBAAmB,CAAC,EAChD,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,YAmD5B"}

package/src/buildTableIndexCommand.js

@@ -0,0 +1,46 @@
+export function buildTableIndexCommands(tableName, model) {
+    const indexQueries = [];
+    if (model.indexes) {
+        model.indexes.forEach((index) => {
+            let indexColumns;
+            let indexName;
+            let whereClause;
+            if (typeof index === 'string') {
+                // Single column index
+                indexColumns = [`"${index}"`];
+                indexName = `idx_${tableName}_${index.split(' ')[0]}`;
+            }
+            else if (Array.isArray(index)) {
+                // Multi-column index
+                indexColumns = index.map((col) => {
+                    const parts = col.split(' ');
+                    const colName = parts[0];
+                    const modifiers = parts.slice(1).join(' '); // e.g., "DESC NULLS LAST"
+                    return modifiers ? `"${colName}" ${modifiers}` : `"${colName}"`;
+                });
+                indexName = `idx_${tableName}_${index.map((c) => c.split(' ')[0]).join('_')}`;
+            }
+            else {
+                // Object format with optional custom name and where clause
+                const objIndex = index;
+                const cols = Array.isArray(objIndex.columns)
+                    ? objIndex.columns
+                    : [objIndex.columns];
+                indexColumns = cols.map((col) => `"${col}"`);
+                indexName = objIndex.name ?? `idx_${tableName}_${cols.join('_')}`;
+                // Support partial indexes with WHERE clause
+                if (objIndex.where) {
+                    whereClause = objIndex.where;
+                }
+            }
+            let indexQuery = `CREATE INDEX IF NOT EXISTS "${indexName}" ON "${tableName}" (${indexColumns.join(', ')})`;
+            if (whereClause) {
+                indexQuery += `\nWHERE ${whereClause}`;
+            }
+            indexQuery += ';';
+            indexQueries.push(indexQuery);
+        });
+    }
+    return indexQueries;
+}
+//# sourceMappingURL=buildTableIndexCommand.js.map

package/src/buildTableIndexCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildTableIndexCommand.js","sourceRoot":"","sources":["../../../../libs/lockstep-pg/src/buildTableIndexCommand.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,uBAAuB,CAErC,SAAiB,EAAE,KAAQ;IAC5B,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QACnB,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YAC/B,IAAI,YAAsB,CAAC;YAC3B,IAAI,SAAiB,CAAC;YACtB,IAAI,WAA+B,CAAC;YAEpC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC/B,sBAAsB;gBACtB,YAAY,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC;gBAC9B,SAAS,GAAG,OAAO,SAAS,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACvD,CAAC;iBAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACjC,qBAAqB;gBACrB,YAAY,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;oBAChC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;oBAC7B,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;oBACzB,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,0BAA0B;oBACtE,OAAO,SAAS,CAAC,CAAC,CAAC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,OAAO,GAAG,CAAC;gBACjE,CAAC,CAAC,CAAC;gBACH,SAAS,GAAG,OAAO,SAAS,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/E,CAAC;iBAAM,CAAC;gBACP,2DAA2D;gBAC3D,MAAM,QAAQ,GAAG,KAIhB,CAAC;gBACF,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;oBAC3C,CAAC,CAAC,QAAQ,CAAC,OAAO;oBAClB,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;gBACtB,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC;gBAC7C,SAAS,GAAG,QAAQ,CAAC,IAAI,IAAI,OAAO,SAAS,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBAClE,4CAA4C;gBAC5C,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;oBACpB,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAC;gBAC9B,CAAC;YACF,CAAC;YAED,IAAI,UAAU,GAAG,+BAA+B,SAAS,SAAS,SAAS,MAAM,YAAY,CAAC,IAAI,CACjG,IAAI,CACJ,GAAG,CAAC;YACL,IAAI,WAAW,EAAE,CAAC;gBACjB,UAAU,IAAI,WAAW,WAAW,EAAE,CAAC;YACxC,CAAC;YACD,UAAU,IAAI,GAAG,CAAC;YAClB,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;IACJ,CAAC;IAED,OAAO,YAAY,CAAC;AACrB,CAAC"}

package/src/buildTableTriggerCommands.d.ts

@@ -0,0 +1,3 @@
+import { PostgresRecordModel, PostgresTableModel } from '@lyku/lockstep-core';
+export declare function buildTableTriggerCommands<T extends PostgresTableModel<PostgresRecordModel>>(tableName: string, model: T): string[];
+//# sourceMappingURL=buildTableTriggerCommands.d.ts.map

package/src/buildTableTriggerCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildTableTriggerCommands.d.ts","sourceRoot":"","sources":["../../../../libs/lockstep-pg/src/buildTableTriggerCommands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9E,wBAAgB,yBAAyB,CACxC,CAAC,SAAS,kBAAkB,CAAC,mBAAmB,CAAC,EAChD,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,YA2B5B"}

package/src/buildTableTriggerCommands.js

@@ -0,0 +1,23 @@
+export function buildTableTriggerCommands(tableName, model) {
+    const triggerQueries = [];
+    if (model.triggers) {
+        model.triggers.forEach((trigger, i) => {
+            const triggerName = trigger.name ?? `${tableName}_trigger_${i + 1}`;
+            const timing = 'before' in trigger ? 'BEFORE' : 'AFTER';
+            const event = 'before' in trigger ? trigger.before : trigger.after;
+            triggerQueries.push(`CREATE OR REPLACE FUNCTION ${triggerName}_fn()\n` +
+                `RETURNS TRIGGER AS $$\n` +
+                `BEGIN\n` +
+                `${trigger.sql}\n` +
+                `END;\n` +
+                `$$ LANGUAGE plpgsql;\n`, `DROP TRIGGER IF EXISTS ${triggerName} ON "${tableName}";\n` +
+                `CREATE TRIGGER ${triggerName}\n` +
+                `${timing} ${event.toUpperCase()}\n` +
+                `ON "${tableName}"\n` +
+                `FOR EACH ROW\n` +
+                `EXECUTE FUNCTION ${triggerName}_fn();`);
+        });
+    }
+    return triggerQueries;
+}
+//# sourceMappingURL=buildTableTriggerCommands.js.map

package/src/buildTableTriggerCommands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildTableTriggerCommands.js","sourceRoot":"","sources":["../../../../libs/lockstep-pg/src/buildTableTriggerCommands.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,yBAAyB,CAEvC,SAAiB,EAAE,KAAQ;IAC5B,MAAM,cAAc,GAAa,EAAE,CAAC;IACpC,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACpB,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE;YACrC,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,IAAI,GAAG,SAAS,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;YACpE,MAAM,MAAM,GAAG,QAAQ,IAAI,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC;YACxD,MAAM,KAAK,GAAG,QAAQ,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;YAEnE,cAAc,CAAC,IAAI,CAClB,8BAA8B,WAAW,SAAS;gBACjD,yBAAyB;gBACzB,SAAS;gBACT,GAAG,OAAO,CAAC,GAAG,IAAI;gBAClB,QAAQ;gBACR,wBAAwB,EAEzB,0BAA0B,WAAW,QAAQ,SAAS,MAAM;gBAC3D,kBAAkB,WAAW,IAAI;gBACjC,GAAG,MAAM,IAAI,KAAK,CAAC,WAAW,EAAE,IAAI;gBACpC,OAAO,SAAS,KAAK;gBACrB,gBAAgB;gBAChB,oBAAoB,WAAW,QAAQ,CACxC,CAAC;QACH,CAAC,CAAC,CAAC;IACJ,CAAC;IAED,OAAO,cAAc,CAAC;AACvB,CAAC"}

package/src/createTable.d.ts

@@ -0,0 +1,3 @@
+import { PostgresRecordModel, PostgresTableModel } from '@lyku/lockstep-core';
+export declare const buildTableCreationCommand: (tableName: string, model: PostgresTableModel<PostgresRecordModel>) => string;
+//# sourceMappingURL=createTable.d.ts.map

package/src/createTable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createTable.d.ts","sourceRoot":"","sources":["../../../../libs/lockstep-pg/src/createTable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAa9E,eAAO,MAAM,yBAAyB,GACrC,WAAW,MAAM,EACjB,OAAO,kBAAkB,CAAC,mBAAmB,CAAC,WAkC9C,CAAC"}

package/src/createTable.js

@@ -0,0 +1,46 @@
+import { mapColumnType } from './mapColumnType';
+function formatDefault(def) {
+    if (def === null)
+        return 'NULL';
+    if (typeof def === 'object' && def !== null && 'sql' in def) {
+        return def.sql;
+    }
+    if (typeof def === 'string')
+        return `'${def}'`;
+    if (typeof def === 'boolean')
+        return def ? 'TRUE' : 'FALSE';
+    return String(def);
+}
+export const buildTableCreationCommand = (tableName, model) => {
+    const { schema } = model;
+    const required = 'required' in schema ? schema.required : [];
+    const columns = 'properties' in schema
+        ? Object.entries(schema.properties)
+            .map(([columnName, columnSchema]) => {
+            const columnType = mapColumnType(columnName, columnSchema);
+            const notNull = required.includes(columnName) ? ' NOT NULL' : '';
+            const hasDefault = 'default' in columnSchema && columnSchema.default !== undefined;
+            const defaultClause = hasDefault
+                ? ` DEFAULT ${formatDefault(columnSchema.default)}`
+                : '';
+            return `"${columnName}" ${columnType}${defaultClause}${notNull}`;
+        })
+            .join(', ')
+        : '';
+    const { primaryKey, unique } = model;
+    const primary = primaryKey
+        ? `, PRIMARY KEY (${[primaryKey]
+            .flat()
+            .map((k) => `"${k}"`)
+            .join(', ')})`
+        : '';
+    const uni = unique
+        ? `, UNIQUE (${[unique]
+            .flat()
+            .map((k) => `"${k}"`)
+            .join(', ')})`
+        : '';
+    const createTableQuery = `CREATE TABLE IF NOT EXISTS "${tableName}" (${columns} ${primary} ${uni});`;
+    return createTableQuery;
+};
+//# sourceMappingURL=createTable.js.map

package/src/createTable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createTable.js","sourceRoot":"","sources":["../../../../libs/lockstep-pg/src/createTable.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,SAAS,aAAa,CAAC,GAAY;IAClC,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAChC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;QAC7D,OAAQ,GAAuB,CAAC,GAAG,CAAC;IACrC,CAAC;IACD,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,IAAI,GAAG,GAAG,CAAC;IAC/C,IAAI,OAAO,GAAG,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;IAC5D,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;AACpB,CAAC;AAED,MAAM,CAAC,MAAM,yBAAyB,GAAG,CACxC,SAAiB,EACjB,KAA8C,EAC7C,EAAE;IACH,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IACzB,MAAM,QAAQ,GAAG,UAAU,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7D,MAAM,OAAO,GACZ,YAAY,IAAI,MAAM;QACrB,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC;aAChC,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,YAAY,CAAC,EAAE,EAAE;YACnC,MAAM,UAAU,GAAG,aAAa,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;YAC3D,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;YACjE,MAAM,UAAU,GACf,SAAS,IAAI,YAAY,IAAI,YAAY,CAAC,OAAO,KAAK,SAAS,CAAC;YACjE,MAAM,aAAa,GAAG,UAAU;gBAC/B,CAAC,CAAC,YAAY,aAAa,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE;gBACnD,CAAC,CAAC,EAAE,CAAC;YACN,OAAO,IAAI,UAAU,KAAK,UAAU,GAAG,aAAa,GAAG,OAAO,EAAE,CAAC;QAClE,CAAC,CAAC;aACD,IAAI,CAAC,IAAI,CAAC;QACb,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IACrC,MAAM,OAAO,GAAG,UAAU;QACzB,CAAC,CAAC,kBAAkB,CAAC,UAAU,CAAC;aAC7B,IAAI,EAAE;aACN,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC;aACpB,IAAI,CAAC,IAAI,CAAC,GAAG;QAChB,CAAC,CAAC,EAAE,CAAC;IACN,MAAM,GAAG,GAAG,MAAM;QACjB,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC;aACpB,IAAI,EAAE;aACN,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC;aACpB,IAAI,CAAC,IAAI,CAAC,GAAG;QAChB,CAAC,CAAC,EAAE,CAAC;IACN,MAAM,gBAAgB,GAAG,+BAA+B,SAAS,MAAM,OAAO,IAAI,OAAO,IAAI,GAAG,IAAI,CAAC;IACrG,OAAO,gBAAgB,CAAC;AACzB,CAAC,CAAC"}

package/src/dateToPostgresString.d.ts

@@ -0,0 +1,2 @@
+export declare const dateToPostgresString: (date: Date | string) => string;
+//# sourceMappingURL=dateToPostgresString.d.ts.map

package/src/dateToPostgresString.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dateToPostgresString.d.ts","sourceRoot":"","sources":["../../../../libs/lockstep-pg/src/dateToPostgresString.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,GAAI,MAAM,IAAI,GAAG,MAAM,WAMvD,CAAC"}

package/src/dateToPostgresString.js

@@ -0,0 +1,7 @@
+export const dateToPostgresString = (date) => {
+    // Ensure we're working with a Date object
+    const dateObj = date instanceof Date ? date : new Date(date);
+    // Format: YYYY-MM-DD HH:MM:SS.sss
+    return dateObj.toISOString().slice(0, 19).replace('T', ' ');
+};
+//# sourceMappingURL=dateToPostgresString.js.map

package/src/dateToPostgresString.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dateToPostgresString.js","sourceRoot":"","sources":["../../../../libs/lockstep-pg/src/dateToPostgresString.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,IAAmB,EAAE,EAAE;IAC3D,0CAA0C;IAC1C,MAAM,OAAO,GAAG,IAAI,YAAY,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;IAE7D,kCAAkC;IAClC,OAAO,OAAO,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAC7D,CAAC,CAAC"}

package/src/diff.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Diff two table models and generate migration operations
+ */
+import type { IntrospectedTable, IntrospectedColumn, IntrospectedIndex, IntrospectedForeignKey } from './introspect';
+export type DiffOperation = {
+    type: 'create_table';
+    table: IntrospectedTable;
+} | {
+    type: 'drop_table';
+    tableName: string;
+} | {
+    type: 'add_column';
+    tableName: string;
+    column: IntrospectedColumn;
+} | {
+    type: 'drop_column';
+    tableName: string;
+    columnName: string;
+} | {
+    type: 'alter_column_type';
+    tableName: string;
+    columnName: string;
+    fromType: string;
+    toType: string;
+    toArrayItemType: string | null;
+} | {
+    type: 'alter_column_nullable';
+    tableName: string;
+    columnName: string;
+    nullable: boolean;
+} | {
+    type: 'alter_column_default';
+    tableName: string;
+    columnName: string;
+    defaultValue: string | null;
+} | {
+    type: 'update_check_constraint';
+    tableName: string;
+    columnName: string;
+    oldValues: string[];
+    newValues: string[];
+} | {
+    type: 'add_index';
+    tableName: string;
+    index: IntrospectedIndex;
+} | {
+    type: 'drop_index';
+    tableName: string;
+    indexName: string;
+} | {
+    type: 'add_unique_constraint';
+    tableName: string;
+    columns: string[];
+} | {
+    type: 'drop_unique_constraint';
+    tableName: string;
+    columns: string[];
+} | {
+    type: 'add_foreign_key';
+    tableName: string;
+    fk: IntrospectedForeignKey;
+} | {
+    type: 'drop_foreign_key';
+    tableName: string;
+    constraintName: string;
+};
+/**
+ * Diff two tables and generate operations needed to migrate DB to match code
+ */
+export declare function diffTable(dbTable: IntrospectedTable | undefined, codeTable: IntrospectedTable | undefined): DiffOperation[];
+/**
+ * Diff entire database against code models
+ */
+export declare function diffDatabase(dbTables: Map<string, IntrospectedTable>, codeTables: Map<string, IntrospectedTable>): DiffOperation[];
+/**
+ * Categorize operations into safe and destructive
+ */
+export declare function categorizeOperations(ops: DiffOperation[]): {
+    safe: DiffOperation[];
+    destructive: DiffOperation[];
+};
+//# sourceMappingURL=diff.d.ts.map

package/src/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../../../libs/lockstep-pg/src/diff.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACX,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,EACtB,MAAM,cAAc,CAAC;AAEtB,MAAM,MAAM,aAAa,GACtB;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,iBAAiB,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,kBAAkB,CAAA;CAAE,GACrE;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC9D;IACA,IAAI,EAAE,mBAAmB,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GACD;IACA,IAAI,EAAE,uBAAuB,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;CACjB,GACD;IACA,IAAI,EAAE,sBAAsB,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,GACD;IACA,IAAI,EAAE,yBAAyB,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;CACnB,GACD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,iBAAiB,CAAA;CAAE,GAClE;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC5D;IACA,IAAI,EAAE,uBAAuB,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;CACjB,GACD;IACA,IAAI,EAAE,wBAAwB,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;CACjB,GACD;IACA,IAAI,EAAE,iBAAiB,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,sBAAsB,CAAC;CAC1B,GACD;IACA,IAAI,EAAE,kBAAkB,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACtB,CAAC;AA4IL;;GAEG;AACH,wBAAgB,SAAS,CACxB,OAAO,EAAE,iBAAiB,GAAG,SAAS,EACtC,SAAS,EAAE,iBAAiB,GAAG,SAAS,GACtC,aAAa,EAAE,CA+EjB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC3B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,EACxC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,GACxC,aAAa,EAAE,CAajB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,aAAa,EAAE,GAAG;IAC3D,IAAI,EAAE,aAAa,EAAE,CAAC;IACtB,WAAW,EAAE,aAAa,EAAE,CAAC;CAC7B,CAgCA"}