@xubylele/schema-forge-core 1.0.0

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2025-2026 Xuby
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,254 @@
+# Schema Forge Core
+
+`@xubylele/schema-forge-core` is the deterministic engine behind Schema Forge. It contains the full domain logic for parsing, diffing, validating, and generating SQL from declarative schema definitions.
+
+The core is framework-agnostic and built around pure, predictable transformations:
+
+* **Parse** the `.sf` DSL format
+* **Normalize** schema into a state model
+* **Diff** schema versions to detect structural changes
+* **Validate** schema definitions and destructive changes
+* **Generate** SQL migration statements
+* **Import** and reconstruct schema from existing SQL migrations
+
+Same input → same output.
+
+---
+
+## Philosophy
+
+* Declarative schema definition
+* Deterministic transformations
+* Framework agnostic
+* Pure domain layer
+* Explicit state modeling
+
+The core contains no hidden side effects. All structural changes are derived from explicit schema input and state.
+
+---
+
+## Module Boundaries
+
+### Core (Pure)
+
+Environment-agnostic logic:
+
+* Parsing DSL
+* Schema normalization
+* Diff engine
+* Validation rules
+* SQL generation
+* SQL parsing to operations
+* State modeling
+
+These modules can run in Node.js or browser environments.
+
+### Node Utilities (I/O Helpers)
+
+Node-only helpers for CLI or tooling environments:
+
+* File system utilities
+* Project path resolution
+* Migration file loading
+
+These require Node.js.
+
+---
+
+## Installation
+
+```bash
+npm install @xubylele/schema-forge-core
+```
+
+---
+
+## Basic Usage
+
+### Parse → Diff → Generate SQL
+
+```ts
+import {
+  parseSchema,
+  schemaToState,
+  diffSchemas,
+  generateSql
+} from "@xubylele/schema-forge-core"
+
+const schemaSource = `
+table users {
+  id uuid pk
+  email varchar unique
+  created_at timestamptz
+}
+`
+
+// Parse DSL into schema model
+const schema = parseSchema(schemaSource)
+
+// Convert schema into normalized state
+const state = await schemaToState(schema)
+
+const nextSchemaSource = `
+table users {
+  id uuid pk
+  email varchar unique
+  name varchar
+  created_at timestamptz
+}
+`
+
+const nextSchema = parseSchema(nextSchemaSource)
+
+// Compute structural diff
+const diff = diffSchemas(state, nextSchema)
+
+// Generate SQL for provider
+const sql = generateSql(diff, "postgres")
+
+console.log(sql)
+// ALTER TABLE users ADD COLUMN name varchar;
+```
+
+---
+
+## Schema Validation
+
+```ts
+import {
+  validateSchema,
+  validateSchemaChanges,
+  toValidationReport
+} from "@xubylele/schema-forge-core"
+
+const schema = parseSchema(schemaSource)
+
+// Structural validation (throws on invalid schema)
+validateSchema(schema)
+
+// Destructive change validation
+const findings = validateSchemaChanges(state, nextSchema)
+const report = toValidationReport(findings)
+
+report.errors.forEach(f => {
+  console.error(`[error] ${f.code}: ${f.message}`)
+})
+
+report.warnings.forEach(f => {
+  console.warn(`[warning] ${f.code}: ${f.message}`)
+})
+```
+
+---
+
+## SQL Import (Reverse Engineering)
+
+```ts
+import {
+  loadMigrationSqlInput,
+  parseMigrationSql,
+  applySqlOps,
+  schemaToDsl
+} from "@xubylele/schema-forge-core"
+
+const inputs = await loadMigrationSqlInput("./migrations")
+
+for (const input of inputs) {
+  const parseResult = parseMigrationSql(input.sql)
+
+  if (parseResult.warnings.length > 0) {
+    console.warn(parseResult.warnings)
+  }
+
+  const result = applySqlOps(parseResult.ops)
+  const dsl = schemaToDsl(result.schema)
+
+  console.log(dsl)
+}
+```
+
+---
+
+## Supported Providers
+
+* `postgres`
+
+Additional providers may be implemented in higher-level packages.
+
+---
+
+## Core API (High-Level)
+
+### Parsing & State
+
+* `parseSchema(source: string): DatabaseSchema`
+* `schemaToState(schema: DatabaseSchema): Promise<StateFile>`
+* `loadState(filePath: string): Promise<StateFile>`
+* `saveState(filePath: string, state: StateFile): Promise<void>`
+
+### Diff Engine
+
+* `diffSchemas(state: StateFile, schema: DatabaseSchema): DiffResult`
+
+### Validation
+
+* `validateSchema(schema: DatabaseSchema): void`
+* `validateSchemaChanges(state: StateFile, schema: DatabaseSchema): Finding[]`
+* `toValidationReport(findings: Finding[]): ValidationReport`
+
+### SQL Generation
+
+* `generateSql(diff: DiffResult, provider: Provider, config?: SqlConfig): string`
+
+### SQL Parsing & Reconstruction
+
+* `parseMigrationSql(sql: string): ParseResult`
+* `applySqlOps(ops: SqlOp[]): ApplySqlOpsResult`
+* `schemaToDsl(schema: DatabaseSchema): string`
+
+Full API surface is available via TypeScript exports.
+
+---
+
+## Type Exports
+
+All domain types are exported for integration:
+
+* `DatabaseSchema`, `Table`, `Column`, `ForeignKey`
+* `StateFile`, `StateTable`, `StateColumn`
+* `DiffResult`, `Operation`
+* `SqlOp`, `ParseResult`, `ApplySqlOpsResult`
+* `Finding`, `ValidationReport`, `Severity`
+* `Provider`, `SqlConfig`
+
+---
+
+## Architecture
+
+```
+DSL (.sf)
+  ↓
+Parser → DatabaseSchema
+  ↓
+State Normalization → StateFile
+  ↓
+Diff Engine → Operations
+  ↓
+SQL Generator → Migration SQL
+```
+
+---
+
+## Development
+
+```bash
+npm install
+npm run build
+npm test
+```
+
+---
+
+## License
+
+ISC

package/dist/core/diff.d.ts

@@ -0,0 +1,22 @@
+import type { Column, DatabaseSchema, DiffResult, StateColumn, StateFile } from '../types/schema';
+/**
+ * Extract table names from a stored state file.
+ */
+export declare function getTableNamesFromState(state: StateFile): Set<string>;
+/**
+ * Extract table names from a database schema.
+ */
+export declare function getTableNamesFromSchema(schema: DatabaseSchema): Set<string>;
+/**
+ * Extract column names from a state table columns record.
+ */
+export declare function getColumnNamesFromState(stateColumns: Record<string, StateColumn>): Set<string>;
+/**
+ * Extract column names from a schema table columns array.
+ */
+export declare function getColumnNamesFromSchema(dbColumns: Column[]): Set<string>;
+/**
+ * Compare a persisted state and a new schema, generating ordered operations.
+ */
+export declare function diffSchemas(oldState: StateFile, newSchema: DatabaseSchema): DiffResult;
+//# sourceMappingURL=diff.d.ts.map

package/dist/core/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/core/diff.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EACN,cAAc,EACd,UAAU,EAEV,WAAW,EACX,SAAS,EACV,MAAM,iBAAiB,CAAC;AAGzB;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,CAEpE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,cAAc,GAAG,GAAG,CAAC,MAAM,CAAC,CAE3E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GACxC,GAAG,CAAC,MAAM,CAAC,CAEb;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAEzE;AA8BD;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,GAAG,UAAU,CA+OtF"}

package/dist/core/diff.js

@@ -0,0 +1,248 @@
+import { normalizeDefault } from './normalize';
+/**
+ * Extract table names from a stored state file.
+ */
+export function getTableNamesFromState(state) {
+    return new Set(Object.keys(state.tables));
+}
+/**
+ * Extract table names from a database schema.
+ */
+export function getTableNamesFromSchema(schema) {
+    return new Set(Object.keys(schema.tables));
+}
+/**
+ * Extract column names from a state table columns record.
+ */
+export function getColumnNamesFromState(stateColumns) {
+    return new Set(Object.keys(stateColumns));
+}
+/**
+ * Extract column names from a schema table columns array.
+ */
+export function getColumnNamesFromSchema(dbColumns) {
+    return new Set(dbColumns.map(column => column.name));
+}
+function getSortedNames(names) {
+    return Array.from(names).sort((a, b) => a.localeCompare(b));
+}
+function normalizeColumnType(type) {
+    return type
+        .toLowerCase()
+        .trim()
+        .replace(/\s+/g, ' ')
+        .replace(/\s*\(\s*/g, '(')
+        .replace(/\s*,\s*/g, ',')
+        .replace(/\s*\)\s*/g, ')');
+}
+function resolveStatePrimaryKey(table) {
+    return table.primaryKey ??
+        Object.entries(table.columns).find(([, column]) => column.primaryKey)?.[0] ??
+        null;
+}
+function resolveSchemaPrimaryKey(table) {
+    return table.primaryKey ?? table.columns.find(column => column.primaryKey)?.name ?? null;
+}
+function normalizeNullable(nullable) {
+    return nullable ?? true;
+}
+/**
+ * Compare a persisted state and a new schema, generating ordered operations.
+ */
+export function diffSchemas(oldState, newSchema) {
+    const operations = [];
+    const oldTableNames = getTableNamesFromState(oldState);
+    const newTableNames = getTableNamesFromSchema(newSchema);
+    const sortedNewTableNames = getSortedNames(newTableNames);
+    const sortedOldTableNames = getSortedNames(oldTableNames);
+    // Phase 1: create tables (A-Z)
+    for (const tableName of sortedNewTableNames) {
+        if (!oldTableNames.has(tableName)) {
+            operations.push({
+                kind: 'create_table',
+                table: newSchema.tables[tableName],
+            });
+        }
+    }
+    const commonTableNames = sortedNewTableNames.filter(tableName => oldTableNames.has(tableName));
+    // Phase 2: detect column type changes in schema order
+    for (const tableName of commonTableNames) {
+        const newTable = newSchema.tables[tableName];
+        const oldTable = oldState.tables[tableName];
+        if (!newTable || !oldTable) {
+            continue;
+        }
+        for (const column of newTable.columns) {
+            const previousColumn = oldTable.columns[column.name];
+            if (!previousColumn) {
+                continue;
+            }
+            const previousType = normalizeColumnType(previousColumn.type);
+            const currentType = normalizeColumnType(column.type);
+            if (previousType !== currentType) {
+                operations.push({
+                    kind: 'column_type_changed',
+                    tableName,
+                    columnName: column.name,
+                    fromType: previousColumn.type,
+                    toType: column.type,
+                });
+            }
+        }
+    }
+    // Phase 3: drop PK constraints for changed/removed primary keys
+    for (const tableName of commonTableNames) {
+        const newTable = newSchema.tables[tableName];
+        const oldTable = oldState.tables[tableName];
+        if (!newTable || !oldTable) {
+            continue;
+        }
+        const previousPrimaryKey = resolveStatePrimaryKey(oldTable);
+        const currentPrimaryKey = resolveSchemaPrimaryKey(newTable);
+        if (previousPrimaryKey !== null && previousPrimaryKey !== currentPrimaryKey) {
+            operations.push({
+                kind: 'drop_primary_key_constraint',
+                tableName,
+            });
+        }
+    }
+    // Phase 4: detect unique changes for existing columns in schema order
+    for (const tableName of commonTableNames) {
+        const newTable = newSchema.tables[tableName];
+        const oldTable = oldState.tables[tableName];
+        if (!newTable || !oldTable) {
+            continue;
+        }
+        for (const column of newTable.columns) {
+            const previousColumn = oldTable.columns[column.name];
+            if (!previousColumn) {
+                continue;
+            }
+            const previousUnique = previousColumn.unique ?? false;
+            const currentUnique = column.unique ?? false;
+            if (previousUnique !== currentUnique) {
+                operations.push({
+                    kind: 'column_unique_changed',
+                    tableName,
+                    columnName: column.name,
+                    from: previousUnique,
+                    to: currentUnique,
+                });
+            }
+        }
+    }
+    // Phase 5: detect column nullability changes in schema order
+    for (const tableName of commonTableNames) {
+        const newTable = newSchema.tables[tableName];
+        const oldTable = oldState.tables[tableName];
+        if (!newTable || !oldTable) {
+            continue;
+        }
+        for (const column of newTable.columns) {
+            const previousColumn = oldTable.columns[column.name];
+            if (!previousColumn) {
+                continue;
+            }
+            const previousNullable = normalizeNullable(previousColumn.nullable);
+            const currentNullable = normalizeNullable(column.nullable);
+            if (previousNullable !== currentNullable) {
+                operations.push({
+                    kind: 'column_nullability_changed',
+                    tableName,
+                    columnName: column.name,
+                    from: previousNullable,
+                    to: currentNullable,
+                });
+            }
+        }
+    }
+    // Phase 6: detect column default changes in schema order
+    for (const tableName of commonTableNames) {
+        const newTable = newSchema.tables[tableName];
+        const oldTable = oldState.tables[tableName];
+        if (!newTable || !oldTable) {
+            continue;
+        }
+        for (const column of newTable.columns) {
+            const previousColumn = oldTable.columns[column.name];
+            if (!previousColumn) {
+                continue;
+            }
+            const previousDefault = normalizeDefault(previousColumn.default);
+            const currentDefault = normalizeDefault(column.default);
+            if (previousDefault !== currentDefault) {
+                operations.push({
+                    kind: 'column_default_changed',
+                    tableName,
+                    columnName: column.name,
+                    fromDefault: previousDefault,
+                    toDefault: currentDefault,
+                });
+            }
+        }
+    }
+    // Phase 7: add columns in schema order
+    for (const tableName of commonTableNames) {
+        const newTable = newSchema.tables[tableName];
+        const oldTable = oldState.tables[tableName];
+        if (!newTable || !oldTable) {
+            continue;
+        }
+        const oldColumnNames = getColumnNamesFromState(oldTable.columns);
+        for (const column of newTable.columns) {
+            if (!oldColumnNames.has(column.name)) {
+                operations.push({
+                    kind: 'add_column',
+                    tableName,
+                    column,
+                });
+            }
+        }
+    }
+    // Phase 8: add PK constraints for added/changed primary keys
+    for (const tableName of commonTableNames) {
+        const newTable = newSchema.tables[tableName];
+        const oldTable = oldState.tables[tableName];
+        if (!newTable || !oldTable) {
+            continue;
+        }
+        const previousPrimaryKey = resolveStatePrimaryKey(oldTable);
+        const currentPrimaryKey = resolveSchemaPrimaryKey(newTable);
+        if (currentPrimaryKey !== null && previousPrimaryKey !== currentPrimaryKey) {
+            operations.push({
+                kind: 'add_primary_key_constraint',
+                tableName,
+                columnName: currentPrimaryKey,
+            });
+        }
+    }
+    // Phase 9: drop columns in state key order
+    for (const tableName of commonTableNames) {
+        const newTable = newSchema.tables[tableName];
+        const oldTable = oldState.tables[tableName];
+        if (!newTable || !oldTable) {
+            continue;
+        }
+        const newColumnNames = getColumnNamesFromSchema(newTable.columns);
+        for (const columnName of Object.keys(oldTable.columns)) {
+            if (!newColumnNames.has(columnName)) {
+                operations.push({
+                    kind: 'drop_column',
+                    tableName,
+                    columnName,
+                });
+            }
+        }
+    }
+    // Phase 10: drop tables (A-Z)
+    for (const tableName of sortedOldTableNames) {
+        if (!newTableNames.has(tableName)) {
+            operations.push({
+                kind: 'drop_table',
+                tableName,
+            });
+        }
+    }
+    return { operations };
+}
+//# sourceMappingURL=diff.js.map

package/dist/core/diff.js.map

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

package/dist/core/errors.d.ts

@@ -0,0 +1,4 @@
+export declare class SchemaValidationError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B"}

package/dist/core/errors.js

@@ -0,0 +1,7 @@
+export class SchemaValidationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'SchemaValidationError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF"}

package/dist/core/fs.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Ensure a directory exists, creating it if necessary
+ */
+export declare function ensureDir(dirPath: string): Promise<void>;
+/**
+ * Check if a file exists
+ */
+export declare function fileExists(filePath: string): Promise<boolean>;
+/**
+ * Read a text file with UTF-8 encoding
+ */
+export declare function readTextFile(filePath: string): Promise<string>;
+/**
+ * Write a text file with UTF-8 encoding
+ */
+export declare function writeTextFile(filePath: string, content: string): Promise<void>;
+/**
+ * Read a JSON file with UTF-8 encoding
+ * Returns fallback value if file doesn't exist
+ */
+export declare function readJsonFile<T>(filePath: string, fallback: T): Promise<T>;
+/**
+ * Write a JSON file with UTF-8 encoding
+ * Pretty-prints with 2-space indentation
+ */
+export declare function writeJsonFile(filePath: string, data: any): Promise<void>;
+/**
+ * Find files matching a pattern recursively
+ */
+export declare function findFiles(dirPath: string, pattern: RegExp): Promise<string[]>;
+//# sourceMappingURL=fs.d.ts.map

package/dist/core/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/core/fs.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM9D;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOnE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAMpE;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAUpF;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAY/E;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAO9E;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAqBnF"}