@toiroakr/lines-db 0.9.0 → 0.9.2

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @toiroakr/lines-db
 
+## 0.9.2
+
+### Patch Changes
+
+- 9982a21: Update runtime dependencies (`commander` to v14.0.3, `@standard-schema/spec` to v1.1.0, `tsx` to v4.21.0) and refresh devDependencies/tooling (migrate from ESLint/Prettier to Oxlint/Oxfmt, TypeScript v6).
+
+## 0.9.1
+
+### Patch Changes
+
+- 4ca2664: fix: validate circular foreign key constraints via deferred validation
+
+  Previously, when two tables had bidirectional foreign keys (e.g., `_User` → `User` and `User` → `_User`), one direction's FK validation was always skipped due to circular dependency detection. Now, circular dependency FKs are validated in a second pass after all tables have been loaded, using SQL queries instead of SQLite FK constraints.
+
 ## 0.9.0
 
 ### Minor Changes
@@ -13,6 +27,7 @@
 - c408b92: feat: display per-table validation results for directory validation
 
   The `validate` command now shows individual results per table when validating a directory, including record counts for successful tables (e.g., `✓ users (3 records)`).
+
   - Added `TableValidationResult` type and `tableResults` field to `ValidationResult`
   - Each table result includes `tableName`, `valid`, `rowCount`, `errors`, and `warnings`
 
@@ -29,6 +44,7 @@
 - 4597383: feat: support .mts and .cts schema file extensions
 
   Schema files are now auto-detected with the following priority: `.schema.ts` > `.schema.mts` > `.schema.cts`. Mixed extensions within a single project are supported.
+
   - Added `--output` option to `generate` command for specifying the output file path (e.g., `--output ./data/db.mts`)
   - Import paths are correctly rewritten: `.ts`→`.js`, `.mts`→`.mjs`, `.cts`→`.cjs`
   - New exported utilities: `findSchemaFile`, `isSchemaFile`, `extractTableNameFromSchemaFile`, `rewriteExtensionForImport`, `SCHEMA_EXTENSIONS`
@@ -70,6 +86,7 @@
 - b281dc8: Fix constraint validation in validator to properly detect primary key and unique index violations
 
   Previously, the validator was not creating indexes from schema metadata and was missing the default primaryKey behavior, causing constraint violations to go undetected. This fix ensures:
+
   - Indexes (both unique and non-unique) are now properly created from schema metadata in the validation database
   - Primary key defaults to 'id' column when not explicitly specified, matching database.ts behavior
   - Constraint violations are properly detected by inserting rows into an in-memory database and catching SQLite exceptions
@@ -110,6 +127,7 @@
 - 49089e1: fix: skip validation with warning instead of error when schema file is not found
 
   When validating a directory containing JSONL files, if a schema file is missing for some tables, the validator will now:
+
   - Skip validation for those files with a warning message instead of throwing an error
   - Display warnings in yellow in the CLI output
   - Continue validation for other files that have schema files

package/bin/{cli.js → cli.mjs}

@@ -6,10 +6,8 @@ import { pathToFileURL } from "node:url";
 import { styleText } from "node:util";
 import { Command } from "commander";
 import { runInNewContext } from "node:vm";
-
-//#region rolldown:runtime
+//#region \0rolldown/runtime.js
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
-
 //#endregion
 //#region src/schema-extensions.ts
 /**
@@ -60,7 +58,6 @@ function rewriteExtensionForImport(filePath) {
 	for (const [tsExt, jsExt] of Object.entries(SCHEMA_TO_JS_IMPORT_MAP)) if (filePath.endsWith(tsExt)) return filePath.slice(0, -tsExt.length) + jsExt;
 	return filePath;
 }
-
 //#endregion
 //#region src/type-generator.ts
 var TypeGenerator = class {
@@ -167,7 +164,6 @@ function toCamelCase(value) {
 function sanitizeIdentifier(value) {
 	return value.replace(/[^A-Za-z0-9_$]/g, "");
 }
-
 //#endregion
 //#region src/runtime.ts
 function detectRuntime() {
@@ -175,10 +171,12 @@ function detectRuntime() {
 	return "unknown";
 }
 const RUNTIME = detectRuntime();
-
 //#endregion
 //#region src/sqlite-adapter.ts
 /**
+* SQLite adapter for Node.js
+*/
+/**
 * Create a SQLite database instance for Node.js
 */
 function createDatabase(path = ":memory:") {
@@ -215,7 +213,6 @@ function createNodeDatabase(path) {
 		}
 	};
 }
-
 //#endregion
 //#region src/jsonl-reader.ts
 var JsonlReader = class {
@@ -295,7 +292,6 @@ var JsonlReader = class {
 		return "TEXT";
 	}
 };
-
 //#endregion
 //#region src/jsonl-writer.ts
 var JsonlWriter = class {
@@ -309,18 +305,17 @@ var JsonlWriter = class {
 	* Append data to JSONL file
 	*/
 	static async append(filePath, data) {
-		const { readFile: readFile$1, writeFile: writeFile$1 } = await import("node:fs/promises");
+		const { readFile, writeFile } = await import("node:fs/promises");
 		try {
-			const existing = await readFile$1(filePath, "utf-8");
+			const existing = await readFile(filePath, "utf-8");
 			const lines = data.map((obj) => JSON.stringify(obj)).join("\n");
-			await writeFile$1(filePath, existing.trim() + "\n" + lines + "\n", "utf-8");
+			await writeFile(filePath, existing.trim() + "\n" + lines + "\n", "utf-8");
 		} catch (error) {
 			if (error.code === "ENOENT") await this.write(filePath, data);
 			else throw error;
 		}
 	}
 };
-
 //#endregion
 //#region src/schema-loader.ts
 var SchemaLoader = class {
@@ -359,7 +354,6 @@ var SchemaLoader = class {
 		return standardObj.version === 1 && typeof standardObj.vendor === "string" && typeof standardObj.validate === "function";
 	}
 };
-
 //#endregion
 //#region src/directory-scanner.ts
 var DirectoryScanner = class {
@@ -385,7 +379,6 @@ var DirectoryScanner = class {
 		}
 	}
 };
-
 //#endregion
 //#region src/schema.ts
 /**
@@ -394,7 +387,6 @@ var DirectoryScanner = class {
 function hasBackward(schema) {
 	return "backward" in schema && typeof schema.backward === "function";
 }
-
 //#endregion
 //#region src/database.ts
 var LinesDB = class LinesDB {
@@ -433,13 +425,20 @@ var LinesDB = class LinesDB {
 		const loadedTables = /* @__PURE__ */ new Set();
 		const loadingTables = /* @__PURE__ */ new Set();
 		const attemptedTables = /* @__PURE__ */ new Set();
+		const allDeferredForeignKeys = [];
 		for (const tableNameToLoad of tablesToLoad) if (!attemptedTables.has(tableNameToLoad)) {
 			const tableTransform = tableNameToLoad === tableName ? transform : void 0;
-			const { errors, warnings, rowCounts: tableRowCounts } = await this.loadTableWithDependencies(tableNameToLoad, loadedTables, loadingTables, attemptedTables, detailedValidate, tableTransform);
+			const { errors, warnings, rowCounts: tableRowCounts, deferredForeignKeys } = await this.loadTableWithDependencies(tableNameToLoad, loadedTables, loadingTables, attemptedTables, detailedValidate, tableTransform);
 			allErrors.push(...errors);
 			allWarnings.push(...warnings);
+			allDeferredForeignKeys.push(...deferredForeignKeys);
 			for (const [k, v] of tableRowCounts) allRowCounts.set(k, v);
 		}
+		if (detailedValidate && allDeferredForeignKeys.length > 0) for (const { tableName: tName, foreignKey: fk, filePath } of allDeferredForeignKeys) {
+			if (!loadedTables.has(fk.references.table)) continue;
+			const deferredErrors = this.validateDeferredForeignKey(tName, fk, filePath);
+			allErrors.push(...deferredErrors);
+		}
 		const tableResults = tablesToLoad.map((name) => {
 			const tableErrors = allErrors.filter((e) => e.tableName === name);
 			const tableWarnings = allWarnings.filter((w) => w.includes(`'${name}'`));
@@ -465,10 +464,12 @@ var LinesDB = class LinesDB {
 		const errors = [];
 		const warnings = [];
 		const rowCounts = /* @__PURE__ */ new Map();
+		const deferredForeignKeys = [];
 		if (attemptedTables.has(tableName)) return {
 			errors,
 			warnings,
-			rowCounts
+			rowCounts,
+			deferredForeignKeys
 		};
 		attemptedTables.add(tableName);
 		if (loadingTables.has(tableName)) throw new Error(`Circular dependency detected for table '${tableName}'`);
@@ -478,10 +479,10 @@ var LinesDB = class LinesDB {
 		try {
 			let foreignKeys;
 			try {
-				const { pathToFileURL: pathToFileURL$1 } = await import("node:url");
+				const { pathToFileURL } = await import("node:url");
 				const schemaPath = await findSchemaFile(dirname(tableConfig.jsonlPath), basename(tableConfig.jsonlPath, ".jsonl"));
 				if (schemaPath) {
-					const schemaModule = await import(`${pathToFileURL$1(schemaPath).href}?t=${Date.now()}`);
+					const schemaModule = await import(`${pathToFileURL(schemaPath).href}?t=${Date.now()}`);
 					foreignKeys = (schemaModule.schema || schemaModule.default)?.foreignKeys || schemaModule.foreignKeys;
 				}
 			} catch {}
@@ -492,23 +493,35 @@ var LinesDB = class LinesDB {
 					const depResult = await this.loadTableWithDependencies(referencedTable, loadedTables, loadingTables, attemptedTables, detailedValidate, void 0);
 					errors.push(...depResult.errors);
 					warnings.push(...depResult.warnings);
+					deferredForeignKeys.push(...depResult.deferredForeignKeys);
 					for (const [k, v] of depResult.rowCounts) rowCounts.set(k, v);
 				} else throw new Error(`Foreign key reference to non-existent table '${referencedTable}' in table '${tableName}'`);
 			}
 			const failedDependencies = /* @__PURE__ */ new Set();
+			const circularDependencies = /* @__PURE__ */ new Set();
 			if (foreignKeys && foreignKeys.length > 0) {
 				for (const fk of foreignKeys) {
 					const referencedTable = fk.references.table;
 					if (referencedTable === tableName) continue;
-					if (attemptedTables.has(referencedTable) && !loadedTables.has(referencedTable)) failedDependencies.add(referencedTable);
+					if (attemptedTables.has(referencedTable) && !loadedTables.has(referencedTable)) if (loadingTables.has(referencedTable)) circularDependencies.add(referencedTable);
+					else failedDependencies.add(referencedTable);
 				}
 				if (failedDependencies.size > 0) for (const dep of failedDependencies) warnings.push(`Skipping foreign key validation for table '${tableName}': referenced table '${dep}' has validation errors`);
 			}
-			const { loaded, rowCount, errors: loadErrors } = await this.loadTable(tableName, tableConfig, detailedValidate, transform, failedDependencies);
+			const allSkippedDependencies = new Set([...failedDependencies, ...circularDependencies]);
+			const { loaded, rowCount, errors: loadErrors } = await this.loadTable(tableName, tableConfig, detailedValidate, transform, allSkippedDependencies);
 			errors.push(...loadErrors);
 			rowCounts.set(tableName, rowCount);
-			if (loaded) loadedTables.add(tableName);
-			else {
+			if (loaded) {
+				loadedTables.add(tableName);
+				if (foreignKeys && circularDependencies.size > 0) {
+					for (const fk of foreignKeys) if (circularDependencies.has(fk.references.table)) deferredForeignKeys.push({
+						tableName,
+						foreignKey: fk,
+						filePath: tableConfig.jsonlPath
+					});
+				}
+			} else {
 				warnings.push(`Table '${tableName}' was not loaded (no data or skipped)`);
 				this.tables.delete(tableName);
 			}
@@ -518,7 +531,8 @@ var LinesDB = class LinesDB {
 		return {
 			errors,
 			warnings,
-			rowCounts
+			rowCounts,
+			deferredForeignKeys
 		};
 	}
 	/**
@@ -534,10 +548,10 @@ var LinesDB = class LinesDB {
 			validationSchema = await SchemaLoader.loadSchema(config.jsonlPath);
 		} catch (_error) {}
 		if (!config.validationSchema) try {
-			const { pathToFileURL: pathToFileURL$1 } = await import("node:url");
+			const { pathToFileURL } = await import("node:url");
 			const schemaPath = await findSchemaFile(dirname(config.jsonlPath), basename(config.jsonlPath, ".jsonl"));
 			if (!schemaPath) throw new Error("Schema file not found");
-			const schemaModule = await import(`${pathToFileURL$1(schemaPath).href}?t=${Date.now()}`);
+			const schemaModule = await import(`${pathToFileURL(schemaPath).href}?t=${Date.now()}`);
 			const schemaExport = schemaModule.schema || schemaModule.default;
 			if (schemaExport?.primaryKey) schemaMetadata.primaryKey = schemaExport.primaryKey;
 			else if (schemaModule.primaryKey) schemaMetadata.primaryKey = schemaModule.primaryKey;
@@ -764,6 +778,34 @@ var LinesDB = class LinesDB {
 		};
 	}
 	/**
+	* Validate a deferred foreign key constraint after all tables have been loaded.
+	* Used for circular dependency FK validation.
+	*/
+	validateDeferredForeignKey(tableName, fk, filePath) {
+		const errors = [];
+		const quotedTable = this.quoteTableName(tableName);
+		const quotedColumn = this.quoteIdentifier(fk.column);
+		const quotedRefTable = this.quoteTableName(fk.references.table);
+		const sql = `SELECT rowid - 1 as idx, ${quotedColumn} as val FROM ${quotedTable} WHERE ${quotedColumn} IS NOT NULL AND ${quotedColumn} NOT IN (SELECT ${this.quoteIdentifier(fk.references.column)} FROM ${quotedRefTable})`;
+		try {
+			const rows = this.query(sql);
+			for (const row of rows) errors.push({
+				file: filePath,
+				tableName,
+				rowIndex: row.idx,
+				issues: [],
+				type: "foreignKey",
+				foreignKeyError: {
+					column: fk.column,
+					value: row.val,
+					referencedTable: fk.references.table,
+					referencedColumn: fk.references.column
+				}
+			});
+		} catch (_) {}
+		return errors;
+	}
+	/**
 	* Execute a raw SQL query
 	*/
 	query(sql, params = []) {
@@ -1216,7 +1258,6 @@ var LinesDB = class LinesDB {
 		return this.db;
 	}
 };
-
 //#endregion
 //#region src/error-formatter.ts
 var ErrorFormatter = class {
@@ -1319,7 +1360,6 @@ var ErrorFormatter = class {
 		return styleText("red", "\n✗ Migration failed and was rolled back");
 	}
 };
-
 //#endregion
 //#region src/cli.ts
 register("tsx", import.meta.url, { data: {} });
@@ -1711,6 +1751,5 @@ async function migrateFile(filePath, transformStr, options) {
 	}
 }
 program.parse();
-
 //#endregion
-export {  };
+export {};

package/dist/index.cjs

@@ -1,45 +1,20 @@
-//#region rolldown:runtime
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-		key = keys[i];
-		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
-			get: ((k) => from[k]).bind(null, key),
-			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-		});
-	}
-	return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
-	value: mod,
-	enumerable: true
-}) : target, mod));
-
-//#endregion
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 let node_fs_promises = require("node:fs/promises");
-node_fs_promises = __toESM(node_fs_promises);
 let node_path = require("node:path");
-node_path = __toESM(node_path);
 let node_url = require("node:url");
-node_url = __toESM(node_url);
 let node_util = require("node:util");
-node_util = __toESM(node_util);
-
 //#region src/runtime.ts
 function detectRuntime() {
 	if (typeof process !== "undefined" && process.versions && process.versions.node) return "node";
 	return "unknown";
 }
 const RUNTIME = detectRuntime();
-
 //#endregion
 //#region src/sqlite-adapter.ts
 /**
+* SQLite adapter for Node.js
+*/
+/**
 * Create a SQLite database instance for Node.js
 */
 function createDatabase(path = ":memory:") {
@@ -76,7 +51,6 @@ function createNodeDatabase(path) {
 		}
 	};
 }
-
 //#endregion
 //#region src/jsonl-reader.ts
 var JsonlReader = class {
@@ -156,7 +130,6 @@ var JsonlReader = class {
 		return "TEXT";
 	}
 };
-
 //#endregion
 //#region src/jsonl-writer.ts
 var JsonlWriter = class {
@@ -170,18 +143,17 @@ var JsonlWriter = class {
 	* Append data to JSONL file
 	*/
 	static async append(filePath, data) {
-		const { readFile: readFile$1, writeFile: writeFile$2 } = await import("node:fs/promises");
+		const { readFile, writeFile } = await import("node:fs/promises");
 		try {
-			const existing = await readFile$1(filePath, "utf-8");
+			const existing = await readFile(filePath, "utf-8");
 			const lines = data.map((obj) => JSON.stringify(obj)).join("\n");
-			await writeFile$2(filePath, existing.trim() + "\n" + lines + "\n", "utf-8");
+			await writeFile(filePath, existing.trim() + "\n" + lines + "\n", "utf-8");
 		} catch (error) {
 			if (error.code === "ENOENT") await this.write(filePath, data);
 			else throw error;
 		}
 	}
 };
-
 //#endregion
 //#region src/schema-extensions.ts
 /**
@@ -246,7 +218,6 @@ function rewriteExtensionForImport(filePath) {
 	for (const [tsExt, jsExt] of Object.entries(SCHEMA_TO_JS_IMPORT_MAP)) if (filePath.endsWith(tsExt)) return filePath.slice(0, -tsExt.length) + jsExt;
 	return filePath;
 }
-
 //#endregion
 //#region src/schema-loader.ts
 var SchemaLoader = class {
@@ -266,8 +237,8 @@ var SchemaLoader = class {
 		const schemaPath = await findSchemaFile(dir, tableName);
 		if (!schemaPath) throw new Error(`Schema file not found for table '${tableName}'. Expected one of: ${SCHEMA_EXTENSIONS.map((ext) => `${tableName}${ext}`).join(", ")}`);
 		try {
-			const module$1 = await import(`${(0, node_url.pathToFileURL)(schemaPath).href}?t=${Date.now()}`);
-			const schema = module$1.default || module$1.schema;
+			const module = await import(`${(0, node_url.pathToFileURL)(schemaPath).href}?t=${Date.now()}`);
+			const schema = module.default || module.schema;
 			if (schema && this.isStandardSchema(schema)) return schema;
 			throw new Error(`Schema file ${schemaPath} does not export a valid StandardSchema`);
 		} catch (error) {
@@ -285,7 +256,6 @@ var SchemaLoader = class {
 		return standardObj.version === 1 && typeof standardObj.vendor === "string" && typeof standardObj.validate === "function";
 	}
 };
-
 //#endregion
 //#region src/directory-scanner.ts
 var DirectoryScanner = class {
@@ -311,7 +281,6 @@ var DirectoryScanner = class {
 		}
 	}
 };
-
 //#endregion
 //#region src/schema.ts
 /**
@@ -369,7 +338,6 @@ function defineSchema(schema, ...args) {
 function hasBackward(schema) {
 	return "backward" in schema && typeof schema.backward === "function";
 }
-
 //#endregion
 //#region src/database.ts
 var LinesDB = class LinesDB {
@@ -408,13 +376,20 @@ var LinesDB = class LinesDB {
 		const loadedTables = /* @__PURE__ */ new Set();
 		const loadingTables = /* @__PURE__ */ new Set();
 		const attemptedTables = /* @__PURE__ */ new Set();
+		const allDeferredForeignKeys = [];
 		for (const tableNameToLoad of tablesToLoad) if (!attemptedTables.has(tableNameToLoad)) {
 			const tableTransform = tableNameToLoad === tableName ? transform : void 0;
-			const { errors, warnings, rowCounts: tableRowCounts } = await this.loadTableWithDependencies(tableNameToLoad, loadedTables, loadingTables, attemptedTables, detailedValidate, tableTransform);
+			const { errors, warnings, rowCounts: tableRowCounts, deferredForeignKeys } = await this.loadTableWithDependencies(tableNameToLoad, loadedTables, loadingTables, attemptedTables, detailedValidate, tableTransform);
 			allErrors.push(...errors);
 			allWarnings.push(...warnings);
+			allDeferredForeignKeys.push(...deferredForeignKeys);
 			for (const [k, v] of tableRowCounts) allRowCounts.set(k, v);
 		}
+		if (detailedValidate && allDeferredForeignKeys.length > 0) for (const { tableName: tName, foreignKey: fk, filePath } of allDeferredForeignKeys) {
+			if (!loadedTables.has(fk.references.table)) continue;
+			const deferredErrors = this.validateDeferredForeignKey(tName, fk, filePath);
+			allErrors.push(...deferredErrors);
+		}
 		const tableResults = tablesToLoad.map((name) => {
 			const tableErrors = allErrors.filter((e) => e.tableName === name);
 			const tableWarnings = allWarnings.filter((w) => w.includes(`'${name}'`));
@@ -440,10 +415,12 @@ var LinesDB = class LinesDB {
 		const errors = [];
 		const warnings = [];
 		const rowCounts = /* @__PURE__ */ new Map();
+		const deferredForeignKeys = [];
 		if (attemptedTables.has(tableName)) return {
 			errors,
 			warnings,
-			rowCounts
+			rowCounts,
+			deferredForeignKeys
 		};
 		attemptedTables.add(tableName);
 		if (loadingTables.has(tableName)) throw new Error(`Circular dependency detected for table '${tableName}'`);
@@ -453,10 +430,10 @@ var LinesDB = class LinesDB {
 		try {
 			let foreignKeys;
 			try {
-				const { pathToFileURL: pathToFileURL$1 } = await import("node:url");
+				const { pathToFileURL } = await import("node:url");
 				const schemaPath = await findSchemaFile((0, node_path.dirname)(tableConfig.jsonlPath), (0, node_path.basename)(tableConfig.jsonlPath, ".jsonl"));
 				if (schemaPath) {
-					const schemaModule = await import(`${pathToFileURL$1(schemaPath).href}?t=${Date.now()}`);
+					const schemaModule = await import(`${pathToFileURL(schemaPath).href}?t=${Date.now()}`);
 					foreignKeys = (schemaModule.schema || schemaModule.default)?.foreignKeys || schemaModule.foreignKeys;
 				}
 			} catch {}
@@ -467,23 +444,35 @@ var LinesDB = class LinesDB {
 					const depResult = await this.loadTableWithDependencies(referencedTable, loadedTables, loadingTables, attemptedTables, detailedValidate, void 0);
 					errors.push(...depResult.errors);
 					warnings.push(...depResult.warnings);
+					deferredForeignKeys.push(...depResult.deferredForeignKeys);
 					for (const [k, v] of depResult.rowCounts) rowCounts.set(k, v);
 				} else throw new Error(`Foreign key reference to non-existent table '${referencedTable}' in table '${tableName}'`);
 			}
 			const failedDependencies = /* @__PURE__ */ new Set();
+			const circularDependencies = /* @__PURE__ */ new Set();
 			if (foreignKeys && foreignKeys.length > 0) {
 				for (const fk of foreignKeys) {
 					const referencedTable = fk.references.table;
 					if (referencedTable === tableName) continue;
-					if (attemptedTables.has(referencedTable) && !loadedTables.has(referencedTable)) failedDependencies.add(referencedTable);
+					if (attemptedTables.has(referencedTable) && !loadedTables.has(referencedTable)) if (loadingTables.has(referencedTable)) circularDependencies.add(referencedTable);
+					else failedDependencies.add(referencedTable);
 				}
 				if (failedDependencies.size > 0) for (const dep of failedDependencies) warnings.push(`Skipping foreign key validation for table '${tableName}': referenced table '${dep}' has validation errors`);
 			}
-			const { loaded, rowCount, errors: loadErrors } = await this.loadTable(tableName, tableConfig, detailedValidate, transform, failedDependencies);
+			const allSkippedDependencies = new Set([...failedDependencies, ...circularDependencies]);
+			const { loaded, rowCount, errors: loadErrors } = await this.loadTable(tableName, tableConfig, detailedValidate, transform, allSkippedDependencies);
 			errors.push(...loadErrors);
 			rowCounts.set(tableName, rowCount);
-			if (loaded) loadedTables.add(tableName);
-			else {
+			if (loaded) {
+				loadedTables.add(tableName);
+				if (foreignKeys && circularDependencies.size > 0) {
+					for (const fk of foreignKeys) if (circularDependencies.has(fk.references.table)) deferredForeignKeys.push({
+						tableName,
+						foreignKey: fk,
+						filePath: tableConfig.jsonlPath
+					});
+				}
+			} else {
 				warnings.push(`Table '${tableName}' was not loaded (no data or skipped)`);
 				this.tables.delete(tableName);
 			}
@@ -493,7 +482,8 @@ var LinesDB = class LinesDB {
 		return {
 			errors,
 			warnings,
-			rowCounts
+			rowCounts,
+			deferredForeignKeys
 		};
 	}
 	/**
@@ -509,10 +499,10 @@ var LinesDB = class LinesDB {
 			validationSchema = await SchemaLoader.loadSchema(config.jsonlPath);
 		} catch (_error) {}
 		if (!config.validationSchema) try {
-			const { pathToFileURL: pathToFileURL$1 } = await import("node:url");
+			const { pathToFileURL } = await import("node:url");
 			const schemaPath = await findSchemaFile((0, node_path.dirname)(config.jsonlPath), (0, node_path.basename)(config.jsonlPath, ".jsonl"));
 			if (!schemaPath) throw new Error("Schema file not found");
-			const schemaModule = await import(`${pathToFileURL$1(schemaPath).href}?t=${Date.now()}`);
+			const schemaModule = await import(`${pathToFileURL(schemaPath).href}?t=${Date.now()}`);
 			const schemaExport = schemaModule.schema || schemaModule.default;
 			if (schemaExport?.primaryKey) schemaMetadata.primaryKey = schemaExport.primaryKey;
 			else if (schemaModule.primaryKey) schemaMetadata.primaryKey = schemaModule.primaryKey;
@@ -739,6 +729,34 @@ var LinesDB = class LinesDB {
 		};
 	}
 	/**
+	* Validate a deferred foreign key constraint after all tables have been loaded.
+	* Used for circular dependency FK validation.
+	*/
+	validateDeferredForeignKey(tableName, fk, filePath) {
+		const errors = [];
+		const quotedTable = this.quoteTableName(tableName);
+		const quotedColumn = this.quoteIdentifier(fk.column);
+		const quotedRefTable = this.quoteTableName(fk.references.table);
+		const sql = `SELECT rowid - 1 as idx, ${quotedColumn} as val FROM ${quotedTable} WHERE ${quotedColumn} IS NOT NULL AND ${quotedColumn} NOT IN (SELECT ${this.quoteIdentifier(fk.references.column)} FROM ${quotedRefTable})`;
+		try {
+			const rows = this.query(sql);
+			for (const row of rows) errors.push({
+				file: filePath,
+				tableName,
+				rowIndex: row.idx,
+				issues: [],
+				type: "foreignKey",
+				foreignKeyError: {
+					column: fk.column,
+					value: row.val,
+					referencedTable: fk.references.table,
+					referencedColumn: fk.references.column
+				}
+			});
+		} catch (_) {}
+		return errors;
+	}
+	/**
 	* Execute a raw SQL query
 	*/
 	query(sql, params = []) {
@@ -1191,7 +1209,6 @@ var LinesDB = class LinesDB {
 		return this.db;
 	}
 };
-
 //#endregion
 //#region src/type-generator.ts
 var TypeGenerator = class {
@@ -1298,7 +1315,6 @@ function toCamelCase(value) {
 function sanitizeIdentifier(value) {
 	return value.replace(/[^A-Za-z0-9_$]/g, "");
 }
-
 //#endregion
 //#region src/jsonl-migration.ts
 /**
@@ -1325,7 +1341,6 @@ async function ensureTableRowsValid(options) {
 		}
 	});
 }
-
 //#endregion
 //#region src/error-formatter.ts
 var ErrorFormatter = class {
@@ -1428,7 +1443,6 @@ var ErrorFormatter = class {
 		return (0, node_util.styleText)("red", "\n✗ Migration failed and was rolled back");
 	}
 };
-
 //#endregion
 exports.DirectoryScanner = DirectoryScanner;
 exports.ErrorFormatter = ErrorFormatter;
@@ -1446,4 +1460,4 @@ exports.extractTableNameFromSchemaFile = extractTableNameFromSchemaFile;
 exports.findSchemaFile = findSchemaFile;
 exports.hasBackward = hasBackward;
 exports.isSchemaFile = isSchemaFile;
-exports.rewriteExtensionForImport = rewriteExtensionForImport;
+exports.rewriteExtensionForImport = rewriteExtensionForImport;