@aigne/afs-sqlite 1.11.0-beta → 1.11.0-beta.1

package/dist/router/path-router.mjs

@@ -0,0 +1,76 @@
+import { createRouter } from "radix3";
+
+//#region src/router/path-router.ts
+/**
+* Creates a radix3 router for SQLite AFS path routing
+*
+* Routes:
+* - / → listTables
+* - /:table → listTable
+* - /:table/new → createRow
+* - /:table/@schema → getSchema
+* - /:table/:pk → readRow
+* - /:table/:pk/@attr → listAttributes
+* - /:table/:pk/@attr/:column → getAttribute
+* - /:table/:pk/@meta → getMeta
+* - /:table/:pk/@actions → listActions
+* - /:table/:pk/@actions/:action → executeAction
+*/
+function createPathRouter() {
+	return createRouter({ routes: {
+		"/": { action: "listTables" },
+		"/:table": { action: "listTable" },
+		"/:table/new": { action: "createRow" },
+		"/:table/@schema": { action: "getSchema" },
+		"/:table/:pk": { action: "readRow" },
+		"/:table/:pk/@attr": { action: "listAttributes" },
+		"/:table/:pk/@attr/:column": { action: "getAttribute" },
+		"/:table/:pk/@meta": { action: "getMeta" },
+		"/:table/:pk/@actions": { action: "listActions" },
+		"/:table/:pk/@actions/:action": { action: "executeAction" }
+	} });
+}
+/**
+* Parses a path and returns the matched route with params
+* @param router - The radix3 router instance
+* @param path - The path to match
+* @returns RouteMatch if matched, undefined otherwise
+*/
+function matchPath(router, path) {
+	const result = router.lookup(path);
+	if (!result) return void 0;
+	return {
+		action: result.action,
+		params: result.params ?? {}
+	};
+}
+/**
+* Builds a path from components
+*/
+function buildPath(table, pk, suffix) {
+	const parts = ["/"];
+	if (table) parts.push(table);
+	if (pk) parts.push(pk);
+	if (suffix) parts.push(suffix);
+	return parts.join("/").replace(/\/+/g, "/");
+}
+/**
+* Checks if a path segment is a virtual path (@attr, @meta, @actions, @schema)
+*/
+function isVirtualPath(segment) {
+	return segment.startsWith("@");
+}
+/**
+* Gets the type of virtual path
+*/
+function getVirtualPathType(segment) {
+	if (segment === "@attr") return "attr";
+	if (segment === "@meta") return "meta";
+	if (segment === "@actions") return "actions";
+	if (segment === "@schema") return "schema";
+	return null;
+}
+
+//#endregion
+export { buildPath, createPathRouter, getVirtualPathType, isVirtualPath, matchPath };
+//# sourceMappingURL=path-router.mjs.map

package/dist/router/path-router.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-router.mjs","names":[],"sources":["../../src/router/path-router.ts"],"sourcesContent":["import { createRouter, type RadixRouter } from \"radix3\";\nimport type { RouteData, RouteMatch, RouteParams } from \"./types.js\";\n\nexport type { RouteData };\n\n/**\n * Creates a radix3 router for SQLite AFS path routing\n *\n * Routes:\n * - / → listTables\n * - /:table → listTable\n * - /:table/new → createRow\n * - /:table/@schema → getSchema\n * - /:table/:pk → readRow\n * - /:table/:pk/@attr → listAttributes\n * - /:table/:pk/@attr/:column → getAttribute\n * - /:table/:pk/@meta → getMeta\n * - /:table/:pk/@actions → listActions\n * - /:table/:pk/@actions/:action → executeAction\n */\nexport function createPathRouter(): RadixRouter<RouteData> {\n  return createRouter<RouteData>({\n    routes: {\n      // Root - list all tables\n      \"/\": { action: \"listTables\" },\n\n      // Table-level routes\n      \"/:table\": { action: \"listTable\" },\n      \"/:table/new\": { action: \"createRow\" },\n      \"/:table/@schema\": { action: \"getSchema\" },\n\n      // Row-level routes\n      \"/:table/:pk\": { action: \"readRow\" },\n      \"/:table/:pk/@attr\": { action: \"listAttributes\" },\n      \"/:table/:pk/@attr/:column\": { action: \"getAttribute\" },\n      \"/:table/:pk/@meta\": { action: \"getMeta\" },\n      \"/:table/:pk/@actions\": { action: \"listActions\" },\n      \"/:table/:pk/@actions/:action\": { action: \"executeAction\" },\n    },\n  });\n}\n\n/**\n * Parses a path and returns the matched route with params\n * @param router - The radix3 router instance\n * @param path - The path to match\n * @returns RouteMatch if matched, undefined otherwise\n */\nexport function matchPath(router: RadixRouter<RouteData>, path: string): RouteMatch | undefined {\n  const result = router.lookup(path);\n  if (!result) return undefined;\n\n  return {\n    action: result.action,\n    params: (result.params ?? {}) as RouteParams,\n  };\n}\n\n/**\n * Builds a path from components\n */\nexport function buildPath(table?: string, pk?: string, suffix?: string): string {\n  const parts = [\"/\"];\n  if (table) parts.push(table);\n  if (pk) parts.push(pk);\n  if (suffix) parts.push(suffix);\n  return parts.join(\"/\").replace(/\\/+/g, \"/\");\n}\n\n/**\n * Checks if a path segment is a virtual path (@attr, @meta, @actions, @schema)\n */\nexport function isVirtualPath(segment: string): boolean {\n  return segment.startsWith(\"@\");\n}\n\n/**\n * Gets the type of virtual path\n */\nexport function getVirtualPathType(segment: string): \"attr\" | \"meta\" | \"actions\" | \"schema\" | null {\n  if (segment === \"@attr\") return \"attr\";\n  if (segment === \"@meta\") return \"meta\";\n  if (segment === \"@actions\") return \"actions\";\n  if (segment === \"@schema\") return \"schema\";\n  return null;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAoBA,SAAgB,mBAA2C;AACzD,QAAO,aAAwB,EAC7B,QAAQ;EAEN,KAAK,EAAE,QAAQ,cAAc;EAG7B,WAAW,EAAE,QAAQ,aAAa;EAClC,eAAe,EAAE,QAAQ,aAAa;EACtC,mBAAmB,EAAE,QAAQ,aAAa;EAG1C,eAAe,EAAE,QAAQ,WAAW;EACpC,qBAAqB,EAAE,QAAQ,kBAAkB;EACjD,6BAA6B,EAAE,QAAQ,gBAAgB;EACvD,qBAAqB,EAAE,QAAQ,WAAW;EAC1C,wBAAwB,EAAE,QAAQ,eAAe;EACjD,gCAAgC,EAAE,QAAQ,iBAAiB;EAC5D,EACF,CAAC;;;;;;;;AASJ,SAAgB,UAAU,QAAgC,MAAsC;CAC9F,MAAM,SAAS,OAAO,OAAO,KAAK;AAClC,KAAI,CAAC,OAAQ,QAAO;AAEpB,QAAO;EACL,QAAQ,OAAO;EACf,QAAS,OAAO,UAAU,EAAE;EAC7B;;;;;AAMH,SAAgB,UAAU,OAAgB,IAAa,QAAyB;CAC9E,MAAM,QAAQ,CAAC,IAAI;AACnB,KAAI,MAAO,OAAM,KAAK,MAAM;AAC5B,KAAI,GAAI,OAAM,KAAK,GAAG;AACtB,KAAI,OAAQ,OAAM,KAAK,OAAO;AAC9B,QAAO,MAAM,KAAK,IAAI,CAAC,QAAQ,QAAQ,IAAI;;;;;AAM7C,SAAgB,cAAc,SAA0B;AACtD,QAAO,QAAQ,WAAW,IAAI;;;;;AAMhC,SAAgB,mBAAmB,SAAgE;AACjG,KAAI,YAAY,QAAS,QAAO;AAChC,KAAI,YAAY,QAAS,QAAO;AAChC,KAAI,YAAY,WAAY,QAAO;AACnC,KAAI,YAAY,UAAW,QAAO;AAClC,QAAO"}

package/dist/router/types.d.cts

@@ -0,0 +1,34 @@
+//#region src/router/types.d.ts
+/**
+ * Route action types for SQLite AFS
+ */
+type RouteAction = "listTables" | "listTable" | "readRow" | "createRow" | "getSchema" | "listAttributes" | "getAttribute" | "getMeta" | "listActions" | "executeAction";
+/**
+ * Route data associated with each path pattern
+ */
+interface RouteData {
+  /** The action to perform for this route */
+  action: RouteAction;
+}
+/**
+ * Route match result with params
+ */
+interface RouteMatch extends RouteData {
+  params: RouteParams;
+}
+/**
+ * Dynamic route parameters extracted from path
+ */
+interface RouteParams {
+  /** Table name */
+  table?: string;
+  /** Primary key value */
+  pk?: string;
+  /** Column name for attribute access */
+  column?: string;
+  /** Action name for @actions */
+  action?: string;
+}
+//#endregion
+export { RouteAction, RouteData, RouteMatch, RouteParams };
+//# sourceMappingURL=types.d.cts.map

package/dist/router/types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.cts","names":[],"sources":["../../src/router/types.ts"],"mappings":";;AAGA;AAeA;KAfY,WAAA;AAAA;AAeZ;AAQA;AAvBY,UAeK,SAAA;EAAA;EAAA,MAAA,EAEP,WAAA;AAAA;AAAA;AAMV;AAOA;AAbU,UAMO,UAAA,SAAmB,SAAA;EAAA,MAAA,EAC1B,WAAA;AAAA;AAAA;AAMV;;AANU,UAMO,WAAA;EAAA;EAAA,KAAA;EAAA;EAAA,EAAA;EAAA;EAAA,MAAA;EAAA;EAAA,MAAA;AAAA"}

package/dist/router/types.d.mts

@@ -0,0 +1,34 @@
+//#region src/router/types.d.ts
+/**
+ * Route action types for SQLite AFS
+ */
+type RouteAction = "listTables" | "listTable" | "readRow" | "createRow" | "getSchema" | "listAttributes" | "getAttribute" | "getMeta" | "listActions" | "executeAction";
+/**
+ * Route data associated with each path pattern
+ */
+interface RouteData {
+  /** The action to perform for this route */
+  action: RouteAction;
+}
+/**
+ * Route match result with params
+ */
+interface RouteMatch extends RouteData {
+  params: RouteParams;
+}
+/**
+ * Dynamic route parameters extracted from path
+ */
+interface RouteParams {
+  /** Table name */
+  table?: string;
+  /** Primary key value */
+  pk?: string;
+  /** Column name for attribute access */
+  column?: string;
+  /** Action name for @actions */
+  action?: string;
+}
+//#endregion
+export { RouteAction, RouteData, RouteMatch, RouteParams };
+//# sourceMappingURL=types.d.mts.map

package/dist/router/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../src/router/types.ts"],"mappings":";;AAGA;AAeA;KAfY,WAAA;AAAA;AAeZ;AAQA;AAvBY,UAeK,SAAA;EAAA;EAAA,MAAA,EAEP,WAAA;AAAA;AAAA;AAMV;AAOA;AAbU,UAMO,UAAA,SAAmB,SAAA;EAAA,MAAA,EAC1B,WAAA;AAAA;AAAA;AAMV;;AANU,UAMO,WAAA;EAAA;EAAA,KAAA;EAAA;EAAA,EAAA;EAAA;EAAA,MAAA;EAAA;EAAA,MAAA;AAAA"}

package/dist/schema/introspector.cjs

@@ -0,0 +1,160 @@
+const require_types = require('./types.cjs');
+let _aigne_sqlite = require("@aigne/sqlite");
+
+//#region src/schema/introspector.ts
+/**
+* Executes a raw SQL query and returns all rows
+*/
+async function execAll(db, query) {
+	return db.all(_aigne_sqlite.sql.raw(query)).execute();
+}
+/**
+* Executes a raw SQL query (for INSERT, UPDATE, DELETE)
+*/
+async function execRun(db, query) {
+	await db.run(_aigne_sqlite.sql.raw(query)).execute();
+}
+/**
+* Maps raw PRAGMA table_info row to ColumnInfo
+*/
+function mapColumn(row) {
+	return {
+		name: row.name,
+		type: row.type,
+		notnull: row.notnull === 1,
+		pk: row.pk,
+		dfltValue: row.dflt_value
+	};
+}
+/**
+* Maps raw PRAGMA foreign_key_list row to ForeignKeyInfo
+*/
+function mapForeignKey(row) {
+	return {
+		id: row.id,
+		seq: row.seq,
+		table: row.table,
+		from: row.from,
+		to: row.to,
+		onUpdate: row.on_update,
+		onDelete: row.on_delete,
+		match: row.match
+	};
+}
+/**
+* Maps raw PRAGMA index_list row to IndexInfo
+*/
+function mapIndex(row) {
+	return {
+		seq: row.seq,
+		name: row.name,
+		unique: row.unique === 1,
+		origin: row.origin,
+		partial: row.partial === 1
+	};
+}
+/**
+* Schema introspector that uses SQLite PRAGMA queries to discover database schema
+*/
+var SchemaIntrospector = class {
+	/**
+	* Introspects all tables in the database
+	* @param db - Drizzle database instance
+	* @param options - Introspection options
+	* @returns Map of table name to TableSchema
+	*/
+	async introspect(db, options) {
+		const schemas = /* @__PURE__ */ new Map();
+		const tablesResult = await execAll(db, `
+      SELECT name FROM sqlite_master
+      WHERE type = 'table'
+      AND name NOT LIKE 'sqlite_%'
+      AND name NOT LIKE '%_fts%'
+      ORDER BY name
+    `);
+		for (const { name } of tablesResult) {
+			if (require_types.SYSTEM_TABLES.includes(name)) continue;
+			if (options?.tables && !options.tables.includes(name)) continue;
+			if (options?.excludeTables?.includes(name)) continue;
+			const schema = await this.introspectTable(db, name);
+			schemas.set(name, schema);
+		}
+		return schemas;
+	}
+	/**
+	* Introspects a single table
+	* @param db - Drizzle database instance
+	* @param tableName - Name of the table to introspect
+	* @returns TableSchema for the specified table
+	*/
+	async introspectTable(db, tableName) {
+		const columns = (await execAll(db, `PRAGMA table_info("${tableName}")`)).map(mapColumn);
+		return {
+			name: tableName,
+			columns,
+			primaryKey: columns.filter((c) => c.pk > 0).map((c) => c.name),
+			foreignKeys: (await execAll(db, `PRAGMA foreign_key_list("${tableName}")`)).map(mapForeignKey),
+			indexes: (await execAll(db, `PRAGMA index_list("${tableName}")`)).map(mapIndex)
+		};
+	}
+	/**
+	* Gets the primary key column name for a table
+	* Returns the first PK column, or 'rowid' if no explicit PK
+	*/
+	getPrimaryKeyColumn(schema) {
+		if (schema.primaryKey.length > 0 && schema.primaryKey[0]) return schema.primaryKey[0];
+		return "rowid";
+	}
+	/**
+	* Checks if a table has FTS (Full-Text Search) enabled
+	*/
+	async hasFTS(db, tableName) {
+		return (await execAll(db, `
+      SELECT name FROM sqlite_master
+      WHERE type = 'table'
+      AND name = '${`${tableName}_fts`}'
+    `)).length > 0;
+	}
+	/**
+	* Creates FTS5 table for full-text search on specified columns
+	*/
+	async createFTS(db, tableName, columns, options) {
+		const ftsTableName = `${tableName}_fts`;
+		const contentTable = options?.contentTable ?? tableName;
+		const contentRowid = options?.contentRowid ?? "rowid";
+		const columnList = columns.join(", ");
+		await execRun(db, `
+      CREATE VIRTUAL TABLE IF NOT EXISTS "${ftsTableName}" USING fts5(
+        ${columnList},
+        content="${contentTable}",
+        content_rowid="${contentRowid}"
+      )
+    `);
+		await execRun(db, `
+      CREATE TRIGGER IF NOT EXISTS "${tableName}_ai" AFTER INSERT ON "${tableName}" BEGIN
+        INSERT INTO "${ftsTableName}"(rowid, ${columnList}) VALUES (new.${contentRowid}, ${columns.map((c) => `new."${c}"`).join(", ")});
+      END
+    `);
+		await execRun(db, `
+      CREATE TRIGGER IF NOT EXISTS "${tableName}_ad" AFTER DELETE ON "${tableName}" BEGIN
+        INSERT INTO "${ftsTableName}"("${ftsTableName}", rowid, ${columnList}) VALUES ('delete', old.${contentRowid}, ${columns.map((c) => `old."${c}"`).join(", ")});
+      END
+    `);
+		await execRun(db, `
+      CREATE TRIGGER IF NOT EXISTS "${tableName}_au" AFTER UPDATE ON "${tableName}" BEGIN
+        INSERT INTO "${ftsTableName}"("${ftsTableName}", rowid, ${columnList}) VALUES ('delete', old.${contentRowid}, ${columns.map((c) => `old."${c}"`).join(", ")});
+        INSERT INTO "${ftsTableName}"(rowid, ${columnList}) VALUES (new.${contentRowid}, ${columns.map((c) => `new."${c}"`).join(", ")});
+      END
+    `);
+	}
+	/**
+	* Rebuilds FTS index for a table (useful after bulk inserts)
+	*/
+	async rebuildFTS(db, tableName) {
+		const ftsTableName = `${tableName}_fts`;
+		await execRun(db, `INSERT INTO "${ftsTableName}"("${ftsTableName}") VALUES ('rebuild')`);
+	}
+};
+
+//#endregion
+exports.SchemaIntrospector = SchemaIntrospector;

package/dist/schema/introspector.d.cts

@@ -0,0 +1,49 @@
+import { TableSchema } from "./types.cjs";
+import { LibSQLDatabase } from "drizzle-orm/libsql";
+
+//#region src/schema/introspector.d.ts
+/**
+ * Schema introspector that uses SQLite PRAGMA queries to discover database schema
+ */
+declare class SchemaIntrospector {
+  /**
+       * Introspects all tables in the database
+       * @param db - Drizzle database instance
+       * @param options - Introspection options
+       * @returns Map of table name to TableSchema
+       */
+  introspect(db: LibSQLDatabase, options?: {
+    /** Whitelist of tables to include */tables?: string[]; /** Tables to exclude */
+    excludeTables?: string[];
+  }): Promise<Map<string, TableSchema>>;
+  /**
+       * Introspects a single table
+       * @param db - Drizzle database instance
+       * @param tableName - Name of the table to introspect
+       * @returns TableSchema for the specified table
+       */
+  introspectTable(db: LibSQLDatabase, tableName: string): Promise<TableSchema>;
+  /**
+       * Gets the primary key column name for a table
+       * Returns the first PK column, or 'rowid' if no explicit PK
+       */
+  getPrimaryKeyColumn(schema: TableSchema): string;
+  /**
+       * Checks if a table has FTS (Full-Text Search) enabled
+       */
+  hasFTS(db: LibSQLDatabase, tableName: string): Promise<boolean>;
+  /**
+       * Creates FTS5 table for full-text search on specified columns
+       */
+  createFTS(db: LibSQLDatabase, tableName: string, columns: string[], options?: {
+    /** Content table (defaults to tableName) */contentTable?: string; /** Content rowid column (defaults to 'rowid') */
+    contentRowid?: string;
+  }): Promise<void>;
+  /**
+       * Rebuilds FTS index for a table (useful after bulk inserts)
+       */
+  rebuildFTS(db: LibSQLDatabase, tableName: string): Promise<void>;
+}
+//#endregion
+export { SchemaIntrospector };
+//# sourceMappingURL=introspector.d.cts.map

package/dist/schema/introspector.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspector.d.cts","names":[],"sources":["../../src/schema/introspector.ts"],"mappings":";;;;;AAwEA;;cAAa,kBAAA;EAAA;;;;;;EAAA,WAAA,EAAA,EAQL,cAAA,EAAA,OAAA;IAAA,qCAAA,MAAA;IAAA,aAAA;EAAA,IAOH,OAAA,CAAQ,GAAA,SAAY,WAAA;EAAA;;;;;;EAAA,gBAAA,EAAA,EA4CG,cAAA,EAAA,SAAA,WAAoC,OAAA,CAAQ,WAAA;EAAA;;;;EAAA,oBAAA,MAAA,EAsC1C,WAAA;EAAA;;;EAAA,OAAA,EAAA,EAWX,cAAA,EAAA,SAAA,WAAoC,OAAA;EAAA;;;EAAA,UAAA,EAAA,EAiB/C,cAAA,EAAA,SAAA,UAAA,OAAA,YAAA,OAAA;IAAA,4CAAA,YAAA;IAAA,YAAA;EAAA,IASH,OAAA;EAAA;;;EAAA,WAAA,EAAA,EAmDkB,cAAA,EAAA,SAAA,WAAoC,OAAA;AAAA"}

package/dist/schema/introspector.d.mts

@@ -0,0 +1,49 @@
+import { TableSchema } from "./types.mjs";
+import { LibSQLDatabase } from "drizzle-orm/libsql";
+
+//#region src/schema/introspector.d.ts
+/**
+ * Schema introspector that uses SQLite PRAGMA queries to discover database schema
+ */
+declare class SchemaIntrospector {
+  /**
+       * Introspects all tables in the database
+       * @param db - Drizzle database instance
+       * @param options - Introspection options
+       * @returns Map of table name to TableSchema
+       */
+  introspect(db: LibSQLDatabase, options?: {
+    /** Whitelist of tables to include */tables?: string[]; /** Tables to exclude */
+    excludeTables?: string[];
+  }): Promise<Map<string, TableSchema>>;
+  /**
+       * Introspects a single table
+       * @param db - Drizzle database instance
+       * @param tableName - Name of the table to introspect
+       * @returns TableSchema for the specified table
+       */
+  introspectTable(db: LibSQLDatabase, tableName: string): Promise<TableSchema>;
+  /**
+       * Gets the primary key column name for a table
+       * Returns the first PK column, or 'rowid' if no explicit PK
+       */
+  getPrimaryKeyColumn(schema: TableSchema): string;
+  /**
+       * Checks if a table has FTS (Full-Text Search) enabled
+       */
+  hasFTS(db: LibSQLDatabase, tableName: string): Promise<boolean>;
+  /**
+       * Creates FTS5 table for full-text search on specified columns
+       */
+  createFTS(db: LibSQLDatabase, tableName: string, columns: string[], options?: {
+    /** Content table (defaults to tableName) */contentTable?: string; /** Content rowid column (defaults to 'rowid') */
+    contentRowid?: string;
+  }): Promise<void>;
+  /**
+       * Rebuilds FTS index for a table (useful after bulk inserts)
+       */
+  rebuildFTS(db: LibSQLDatabase, tableName: string): Promise<void>;
+}
+//#endregion
+export { SchemaIntrospector };
+//# sourceMappingURL=introspector.d.mts.map

package/dist/schema/introspector.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspector.d.mts","names":[],"sources":["../../src/schema/introspector.ts"],"mappings":";;;;;AAwEA;;cAAa,kBAAA;EAAA;;;;;;EAAA,WAAA,EAAA,EAQL,cAAA,EAAA,OAAA;IAAA,qCAAA,MAAA;IAAA,aAAA;EAAA,IAOH,OAAA,CAAQ,GAAA,SAAY,WAAA;EAAA;;;;;;EAAA,gBAAA,EAAA,EA4CG,cAAA,EAAA,SAAA,WAAoC,OAAA,CAAQ,WAAA;EAAA;;;;EAAA,oBAAA,MAAA,EAsC1C,WAAA;EAAA;;;EAAA,OAAA,EAAA,EAWX,cAAA,EAAA,SAAA,WAAoC,OAAA;EAAA;;;EAAA,UAAA,EAAA,EAiB/C,cAAA,EAAA,SAAA,UAAA,OAAA,YAAA,OAAA;IAAA,4CAAA,YAAA;IAAA,YAAA;EAAA,IASH,OAAA;EAAA;;;EAAA,WAAA,EAAA,EAmDkB,cAAA,EAAA,SAAA,WAAoC,OAAA;AAAA"}

package/dist/schema/introspector.mjs

@@ -0,0 +1,161 @@
+import { SYSTEM_TABLES } from "./types.mjs";
+import { sql } from "@aigne/sqlite";
+
+//#region src/schema/introspector.ts
+/**
+* Executes a raw SQL query and returns all rows
+*/
+async function execAll(db, query) {
+	return db.all(sql.raw(query)).execute();
+}
+/**
+* Executes a raw SQL query (for INSERT, UPDATE, DELETE)
+*/
+async function execRun(db, query) {
+	await db.run(sql.raw(query)).execute();
+}
+/**
+* Maps raw PRAGMA table_info row to ColumnInfo
+*/
+function mapColumn(row) {
+	return {
+		name: row.name,
+		type: row.type,
+		notnull: row.notnull === 1,
+		pk: row.pk,
+		dfltValue: row.dflt_value
+	};
+}
+/**
+* Maps raw PRAGMA foreign_key_list row to ForeignKeyInfo
+*/
+function mapForeignKey(row) {
+	return {
+		id: row.id,
+		seq: row.seq,
+		table: row.table,
+		from: row.from,
+		to: row.to,
+		onUpdate: row.on_update,
+		onDelete: row.on_delete,
+		match: row.match
+	};
+}
+/**
+* Maps raw PRAGMA index_list row to IndexInfo
+*/
+function mapIndex(row) {
+	return {
+		seq: row.seq,
+		name: row.name,
+		unique: row.unique === 1,
+		origin: row.origin,
+		partial: row.partial === 1
+	};
+}
+/**
+* Schema introspector that uses SQLite PRAGMA queries to discover database schema
+*/
+var SchemaIntrospector = class {
+	/**
+	* Introspects all tables in the database
+	* @param db - Drizzle database instance
+	* @param options - Introspection options
+	* @returns Map of table name to TableSchema
+	*/
+	async introspect(db, options) {
+		const schemas = /* @__PURE__ */ new Map();
+		const tablesResult = await execAll(db, `
+      SELECT name FROM sqlite_master
+      WHERE type = 'table'
+      AND name NOT LIKE 'sqlite_%'
+      AND name NOT LIKE '%_fts%'
+      ORDER BY name
+    `);
+		for (const { name } of tablesResult) {
+			if (SYSTEM_TABLES.includes(name)) continue;
+			if (options?.tables && !options.tables.includes(name)) continue;
+			if (options?.excludeTables?.includes(name)) continue;
+			const schema = await this.introspectTable(db, name);
+			schemas.set(name, schema);
+		}
+		return schemas;
+	}
+	/**
+	* Introspects a single table
+	* @param db - Drizzle database instance
+	* @param tableName - Name of the table to introspect
+	* @returns TableSchema for the specified table
+	*/
+	async introspectTable(db, tableName) {
+		const columns = (await execAll(db, `PRAGMA table_info("${tableName}")`)).map(mapColumn);
+		return {
+			name: tableName,
+			columns,
+			primaryKey: columns.filter((c) => c.pk > 0).map((c) => c.name),
+			foreignKeys: (await execAll(db, `PRAGMA foreign_key_list("${tableName}")`)).map(mapForeignKey),
+			indexes: (await execAll(db, `PRAGMA index_list("${tableName}")`)).map(mapIndex)
+		};
+	}
+	/**
+	* Gets the primary key column name for a table
+	* Returns the first PK column, or 'rowid' if no explicit PK
+	*/
+	getPrimaryKeyColumn(schema) {
+		if (schema.primaryKey.length > 0 && schema.primaryKey[0]) return schema.primaryKey[0];
+		return "rowid";
+	}
+	/**
+	* Checks if a table has FTS (Full-Text Search) enabled
+	*/
+	async hasFTS(db, tableName) {
+		return (await execAll(db, `
+      SELECT name FROM sqlite_master
+      WHERE type = 'table'
+      AND name = '${`${tableName}_fts`}'
+    `)).length > 0;
+	}
+	/**
+	* Creates FTS5 table for full-text search on specified columns
+	*/
+	async createFTS(db, tableName, columns, options) {
+		const ftsTableName = `${tableName}_fts`;
+		const contentTable = options?.contentTable ?? tableName;
+		const contentRowid = options?.contentRowid ?? "rowid";
+		const columnList = columns.join(", ");
+		await execRun(db, `
+      CREATE VIRTUAL TABLE IF NOT EXISTS "${ftsTableName}" USING fts5(
+        ${columnList},
+        content="${contentTable}",
+        content_rowid="${contentRowid}"
+      )
+    `);
+		await execRun(db, `
+      CREATE TRIGGER IF NOT EXISTS "${tableName}_ai" AFTER INSERT ON "${tableName}" BEGIN
+        INSERT INTO "${ftsTableName}"(rowid, ${columnList}) VALUES (new.${contentRowid}, ${columns.map((c) => `new."${c}"`).join(", ")});
+      END
+    `);
+		await execRun(db, `
+      CREATE TRIGGER IF NOT EXISTS "${tableName}_ad" AFTER DELETE ON "${tableName}" BEGIN
+        INSERT INTO "${ftsTableName}"("${ftsTableName}", rowid, ${columnList}) VALUES ('delete', old.${contentRowid}, ${columns.map((c) => `old."${c}"`).join(", ")});
+      END
+    `);
+		await execRun(db, `
+      CREATE TRIGGER IF NOT EXISTS "${tableName}_au" AFTER UPDATE ON "${tableName}" BEGIN
+        INSERT INTO "${ftsTableName}"("${ftsTableName}", rowid, ${columnList}) VALUES ('delete', old.${contentRowid}, ${columns.map((c) => `old."${c}"`).join(", ")});
+        INSERT INTO "${ftsTableName}"(rowid, ${columnList}) VALUES (new.${contentRowid}, ${columns.map((c) => `new."${c}"`).join(", ")});
+      END
+    `);
+	}
+	/**
+	* Rebuilds FTS index for a table (useful after bulk inserts)
+	*/
+	async rebuildFTS(db, tableName) {
+		const ftsTableName = `${tableName}_fts`;
+		await execRun(db, `INSERT INTO "${ftsTableName}"("${ftsTableName}") VALUES ('rebuild')`);
+	}
+};
+
+//#endregion
+export { SchemaIntrospector };
+//# sourceMappingURL=introspector.mjs.map

package/dist/schema/introspector.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspector.mjs","names":[],"sources":["../../src/schema/introspector.ts"],"sourcesContent":["import { sql } from \"@aigne/sqlite\";\nimport type { LibSQLDatabase } from \"drizzle-orm/libsql\";\nimport {\n  type ColumnInfo,\n  type ForeignKeyInfo,\n  type IndexInfo,\n  type PragmaForeignKeyRow,\n  type PragmaIndexListRow,\n  type PragmaTableInfoRow,\n  SYSTEM_TABLES,\n  type TableSchema,\n} from \"./types.js\";\n\n/**\n * Executes a raw SQL query and returns all rows\n */\nasync function execAll<T>(db: LibSQLDatabase, query: string): Promise<T[]> {\n  return db.all<T>(sql.raw(query)).execute();\n}\n\n/**\n * Executes a raw SQL query (for INSERT, UPDATE, DELETE)\n */\nasync function execRun(db: LibSQLDatabase, query: string): Promise<void> {\n  await db.run(sql.raw(query)).execute();\n}\n\n/**\n * Maps raw PRAGMA table_info row to ColumnInfo\n */\nfunction mapColumn(row: PragmaTableInfoRow): ColumnInfo {\n  return {\n    name: row.name,\n    type: row.type,\n    notnull: row.notnull === 1,\n    pk: row.pk,\n    dfltValue: row.dflt_value,\n  };\n}\n\n/**\n * Maps raw PRAGMA foreign_key_list row to ForeignKeyInfo\n */\nfunction mapForeignKey(row: PragmaForeignKeyRow): ForeignKeyInfo {\n  return {\n    id: row.id,\n    seq: row.seq,\n    table: row.table,\n    from: row.from,\n    to: row.to,\n    onUpdate: row.on_update,\n    onDelete: row.on_delete,\n    match: row.match,\n  };\n}\n\n/**\n * Maps raw PRAGMA index_list row to IndexInfo\n */\nfunction mapIndex(row: PragmaIndexListRow): IndexInfo {\n  return {\n    seq: row.seq,\n    name: row.name,\n    unique: row.unique === 1,\n    origin: row.origin,\n    partial: row.partial === 1,\n  };\n}\n\n/**\n * Schema introspector that uses SQLite PRAGMA queries to discover database schema\n */\nexport class SchemaIntrospector {\n  /**\n   * Introspects all tables in the database\n   * @param db - Drizzle database instance\n   * @param options - Introspection options\n   * @returns Map of table name to TableSchema\n   */\n  async introspect(\n    db: LibSQLDatabase,\n    options?: {\n      /** Whitelist of tables to include */\n      tables?: string[];\n      /** Tables to exclude */\n      excludeTables?: string[];\n    },\n  ): Promise<Map<string, TableSchema>> {\n    const schemas = new Map<string, TableSchema>();\n\n    // Get all user tables (exclude system tables and FTS tables)\n    const tablesResult = await execAll<{ name: string }>(\n      db,\n      `\n      SELECT name FROM sqlite_master\n      WHERE type = 'table'\n      AND name NOT LIKE 'sqlite_%'\n      AND name NOT LIKE '%_fts%'\n      ORDER BY name\n    `,\n    );\n\n    for (const { name } of tablesResult) {\n      // Skip system tables\n      if (SYSTEM_TABLES.includes(name as (typeof SYSTEM_TABLES)[number])) {\n        continue;\n      }\n\n      // Apply whitelist filter\n      if (options?.tables && !options.tables.includes(name)) {\n        continue;\n      }\n\n      // Apply exclude filter\n      if (options?.excludeTables?.includes(name)) {\n        continue;\n      }\n\n      const schema = await this.introspectTable(db, name);\n      schemas.set(name, schema);\n    }\n\n    return schemas;\n  }\n\n  /**\n   * Introspects a single table\n   * @param db - Drizzle database instance\n   * @param tableName - Name of the table to introspect\n   * @returns TableSchema for the specified table\n   */\n  async introspectTable(db: LibSQLDatabase, tableName: string): Promise<TableSchema> {\n    // Get column information\n    const columnsResult = await execAll<PragmaTableInfoRow>(\n      db,\n      `PRAGMA table_info(\"${tableName}\")`,\n    );\n    const columns = columnsResult.map(mapColumn);\n\n    // Get primary key columns (pk > 0 indicates part of primary key)\n    const primaryKey = columns.filter((c) => c.pk > 0).map((c) => c.name);\n\n    // Get foreign keys\n    const fksResult = await execAll<PragmaForeignKeyRow>(\n      db,\n      `PRAGMA foreign_key_list(\"${tableName}\")`,\n    );\n    const foreignKeys = fksResult.map(mapForeignKey);\n\n    // Get indexes\n    const indexesResult = await execAll<PragmaIndexListRow>(\n      db,\n      `PRAGMA index_list(\"${tableName}\")`,\n    );\n    const indexes = indexesResult.map(mapIndex);\n\n    return {\n      name: tableName,\n      columns,\n      primaryKey,\n      foreignKeys,\n      indexes,\n    };\n  }\n\n  /**\n   * Gets the primary key column name for a table\n   * Returns the first PK column, or 'rowid' if no explicit PK\n   */\n  getPrimaryKeyColumn(schema: TableSchema): string {\n    if (schema.primaryKey.length > 0 && schema.primaryKey[0]) {\n      return schema.primaryKey[0];\n    }\n    // SQLite tables without explicit PK use rowid\n    return \"rowid\";\n  }\n\n  /**\n   * Checks if a table has FTS (Full-Text Search) enabled\n   */\n  async hasFTS(db: LibSQLDatabase, tableName: string): Promise<boolean> {\n    const ftsTableName = `${tableName}_fts`;\n    const result = await execAll<{ name: string }>(\n      db,\n      `\n      SELECT name FROM sqlite_master\n      WHERE type = 'table'\n      AND name = '${ftsTableName}'\n    `,\n    );\n    return result.length > 0;\n  }\n\n  /**\n   * Creates FTS5 table for full-text search on specified columns\n   */\n  async createFTS(\n    db: LibSQLDatabase,\n    tableName: string,\n    columns: string[],\n    options?: {\n      /** Content table (defaults to tableName) */\n      contentTable?: string;\n      /** Content rowid column (defaults to 'rowid') */\n      contentRowid?: string;\n    },\n  ): Promise<void> {\n    const ftsTableName = `${tableName}_fts`;\n    const contentTable = options?.contentTable ?? tableName;\n    const contentRowid = options?.contentRowid ?? \"rowid\";\n    const columnList = columns.join(\", \");\n\n    // Create FTS5 virtual table\n    await execRun(\n      db,\n      `\n      CREATE VIRTUAL TABLE IF NOT EXISTS \"${ftsTableName}\" USING fts5(\n        ${columnList},\n        content=\"${contentTable}\",\n        content_rowid=\"${contentRowid}\"\n      )\n    `,\n    );\n\n    // Create triggers to keep FTS in sync\n    await execRun(\n      db,\n      `\n      CREATE TRIGGER IF NOT EXISTS \"${tableName}_ai\" AFTER INSERT ON \"${tableName}\" BEGIN\n        INSERT INTO \"${ftsTableName}\"(rowid, ${columnList}) VALUES (new.${contentRowid}, ${columns.map((c) => `new.\"${c}\"`).join(\", \")});\n      END\n    `,\n    );\n\n    await execRun(\n      db,\n      `\n      CREATE TRIGGER IF NOT EXISTS \"${tableName}_ad\" AFTER DELETE ON \"${tableName}\" BEGIN\n        INSERT INTO \"${ftsTableName}\"(\"${ftsTableName}\", rowid, ${columnList}) VALUES ('delete', old.${contentRowid}, ${columns.map((c) => `old.\"${c}\"`).join(\", \")});\n      END\n    `,\n    );\n\n    await execRun(\n      db,\n      `\n      CREATE TRIGGER IF NOT EXISTS \"${tableName}_au\" AFTER UPDATE ON \"${tableName}\" BEGIN\n        INSERT INTO \"${ftsTableName}\"(\"${ftsTableName}\", rowid, ${columnList}) VALUES ('delete', old.${contentRowid}, ${columns.map((c) => `old.\"${c}\"`).join(\", \")});\n        INSERT INTO \"${ftsTableName}\"(rowid, ${columnList}) VALUES (new.${contentRowid}, ${columns.map((c) => `new.\"${c}\"`).join(\", \")});\n      END\n    `,\n    );\n  }\n\n  /**\n   * Rebuilds FTS index for a table (useful after bulk inserts)\n   */\n  async rebuildFTS(db: LibSQLDatabase, tableName: string): Promise<void> {\n    const ftsTableName = `${tableName}_fts`;\n    await execRun(db, `INSERT INTO \"${ftsTableName}\"(\"${ftsTableName}\") VALUES ('rebuild')`);\n  }\n}\n"],"mappings":"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"}

package/dist/schema/types.cjs

@@ -0,0 +1,15 @@
+
+//#region src/schema/types.ts
+/**
+* System tables that should be excluded from introspection
+*/
+const SYSTEM_TABLES = [
+	"sqlite_sequence",
+	"sqlite_stat1",
+	"sqlite_stat2",
+	"sqlite_stat3",
+	"sqlite_stat4"
+];
+
+//#endregion
+exports.SYSTEM_TABLES = SYSTEM_TABLES;