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

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;;;;;;;EAOL,UAAA,CACJ,EAAA,EAAI,cAAA,EACJ,OAAA;IAkD4D,qCAhD1D,MAAA,aAiGa;IA/Fb,aAAA;EAAA,IAED,OAAA,CAAQ,GAAA,SAAY,WAAA;EAuHpB;;;;;;EA3EG,eAAA,CAAgB,EAAA,EAAI,cAAA,EAAgB,SAAA,WAAoB,OAAA,CAAQ,WAAA;EAnDpE;;;;EAyFF,mBAAA,CAAoB,MAAA,EAAQ,WAAA;EAlFjB;;;EA6FL,MAAA,CAAO,EAAA,EAAI,cAAA,EAAgB,SAAA,WAAoB,OAAA;EAjD/B;;;EAiEhB,SAAA,CACJ,EAAA,EAAI,cAAA,EACJ,SAAA,UACA,OAAA,YACA,OAAA;IA/BF,4CAiCI,YAAA,WAjCgB;IAmChB,YAAA;EAAA,IAED,OAAA;EA1BU;;;EA6EP,UAAA,CAAW,EAAA,EAAI,cAAA,EAAgB,SAAA,WAAoB,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;;;;;;;EAOL,UAAA,CACJ,EAAA,EAAI,cAAA,EACJ,OAAA;IAkD4D,qCAhD1D,MAAA,aAiGa;IA/Fb,aAAA;EAAA,IAED,OAAA,CAAQ,GAAA,SAAY,WAAA;EAuHpB;;;;;;EA3EG,eAAA,CAAgB,EAAA,EAAI,cAAA,EAAgB,SAAA,WAAoB,OAAA,CAAQ,WAAA;EAnDpE;;;;EAyFF,mBAAA,CAAoB,MAAA,EAAQ,WAAA;EAlFjB;;;EA6FL,MAAA,CAAO,EAAA,EAAI,cAAA,EAAgB,SAAA,WAAoB,OAAA;EAjD/B;;;EAiEhB,SAAA,CACJ,EAAA,EAAI,cAAA,EACJ,SAAA,UACA,OAAA,YACA,OAAA;IA/BF,4CAiCI,YAAA,WAjCgB;IAmChB,YAAA;EAAA,IAED,OAAA;EA1BU;;;EA6EP,UAAA,CAAW,EAAA,EAAI,cAAA,EAAgB,SAAA,WAAoB,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/service.cjs

@@ -0,0 +1,86 @@
+const require_types = require('./types.cjs');
+const require_introspector = require('./introspector.cjs');
+let _aigne_sqlite = require("@aigne/sqlite");
+
+//#region src/schema/service.ts
+/**
+* Executes a raw SQL query and returns all rows
+*/
+async function execAll(db, query) {
+	return db.all(_aigne_sqlite.sql.raw(query)).execute();
+}
+/**
+* Schema service that queries schema on-demand (no caching)
+*
+* SQLite PRAGMA queries are extremely fast, so real-time queries
+* are preferred over caching to avoid staleness issues.
+*/
+var SchemaService = class {
+	introspector = new require_introspector.SchemaIntrospector();
+	constructor(db, options) {
+		this.db = db;
+		this.options = options;
+	}
+	/**
+	* Gets schema for a specific table (real-time query)
+	*/
+	async getSchema(tableName) {
+		if (!tableName) return;
+		if (require_types.SYSTEM_TABLES.includes(tableName)) return;
+		if (this.options?.tables && !this.options.tables.includes(tableName)) return;
+		if (this.options?.excludeTables?.includes(tableName)) return;
+		if (!await this.hasTable(tableName)) return;
+		return this.introspector.introspectTable(this.db, tableName);
+	}
+	/**
+	* Checks if a table exists (real-time query)
+	*/
+	async hasTable(tableName) {
+		if (!tableName) return false;
+		if (require_types.SYSTEM_TABLES.includes(tableName)) return false;
+		if (this.options?.tables && !this.options.tables.includes(tableName)) return false;
+		if (this.options?.excludeTables?.includes(tableName)) return false;
+		return ((await execAll(this.db, `SELECT COUNT(*) as count FROM sqlite_master WHERE type = 'table' AND name = '${tableName.replace(/'/g, "''")}'`))[0]?.count ?? 0) > 0;
+	}
+	/**
+	* Gets all table schemas (real-time query)
+	*/
+	async getAllSchemas() {
+		return this.introspector.introspect(this.db, {
+			tables: this.options?.tables,
+			excludeTables: this.options?.excludeTables
+		});
+	}
+	/**
+	* Lists all table names (real-time query)
+	*/
+	async listTableNames() {
+		return (await execAll(this.db, `
+      SELECT name FROM sqlite_master
+      WHERE type = 'table'
+      AND name NOT LIKE 'sqlite_%'
+      AND name NOT LIKE '%_fts%'
+      ORDER BY name
+    `)).map((r) => r.name).filter((name) => {
+			if (require_types.SYSTEM_TABLES.includes(name)) return false;
+			if (this.options?.tables && !this.options.tables.includes(name)) return false;
+			if (this.options?.excludeTables?.includes(name)) return false;
+			return true;
+		});
+	}
+	/**
+	* Gets the count of tables
+	*/
+	async getTableCount() {
+		return (await this.listTableNames()).length;
+	}
+	/**
+	* Gets the primary key column name for a table
+	*/
+	getPrimaryKeyColumn(schema) {
+		return this.introspector.getPrimaryKeyColumn(schema);
+	}
+};
+
+//#endregion
+exports.SchemaService = SchemaService;

package/dist/schema/service.d.cts

@@ -0,0 +1,52 @@
+import { TableSchema } from "./types.cjs";
+import { LibSQLDatabase } from "drizzle-orm/libsql";
+
+//#region src/schema/service.d.ts
+/**
+ * Options for schema service
+ */
+interface SchemaServiceOptions {
+  /** Whitelist of tables to include */
+  tables?: string[];
+  /** Tables to exclude */
+  excludeTables?: string[];
+}
+/**
+ * Schema service that queries schema on-demand (no caching)
+ *
+ * SQLite PRAGMA queries are extremely fast, so real-time queries
+ * are preferred over caching to avoid staleness issues.
+ */
+declare class SchemaService {
+  private db;
+  private options?;
+  private introspector;
+  constructor(db: LibSQLDatabase, options?: SchemaServiceOptions | undefined);
+  /**
+   * Gets schema for a specific table (real-time query)
+   */
+  getSchema(tableName: string): Promise<TableSchema | undefined>;
+  /**
+   * Checks if a table exists (real-time query)
+   */
+  hasTable(tableName: string): Promise<boolean>;
+  /**
+   * Gets all table schemas (real-time query)
+   */
+  getAllSchemas(): Promise<Map<string, TableSchema>>;
+  /**
+   * Lists all table names (real-time query)
+   */
+  listTableNames(): Promise<string[]>;
+  /**
+   * Gets the count of tables
+   */
+  getTableCount(): Promise<number>;
+  /**
+   * Gets the primary key column name for a table
+   */
+  getPrimaryKeyColumn(schema: TableSchema): string;
+}
+//#endregion
+export { SchemaService, SchemaServiceOptions };
+//# sourceMappingURL=service.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.cts","names":[],"sources":["../../src/schema/service.ts"],"mappings":";;;;;;AAeA;UAAiB,oBAAA;;EAEf,MAAA;EAEa;EAAb,aAAA;AAAA;;;;;;;cASW,aAAA;EAAA,QAID,EAAA;EAAA,QACA,OAAA;EAAA,QAJF,YAAA;cAGE,EAAA,EAAI,cAAA,EACJ,OAAA,GAAU,oBAAA;EA0HQ;;;EApHtB,SAAA,CAAU,SAAA,WAAoB,OAAA,CAAQ,WAAA;EANlC;;;EAuCJ,QAAA,CAAS,SAAA,WAAoB,OAAA;EAxCzB;;;EAuEJ,aAAA,CAAA,GAAiB,OAAA,CAAQ,GAAA,SAAY,WAAA;EAhE3B;;;EA0EV,cAAA,CAAA,GAAkB,OAAA;EAzCT;;;EA2ET,aAAA,CAAA,GAAiB,OAAA;EA5CQ;;;EAoD/B,mBAAA,CAAoB,MAAA,EAAQ,WAAA;AAAA"}

package/dist/schema/service.d.mts

@@ -0,0 +1,52 @@
+import { TableSchema } from "./types.mjs";
+import { LibSQLDatabase } from "drizzle-orm/libsql";
+
+//#region src/schema/service.d.ts
+/**
+ * Options for schema service
+ */
+interface SchemaServiceOptions {
+  /** Whitelist of tables to include */
+  tables?: string[];
+  /** Tables to exclude */
+  excludeTables?: string[];
+}
+/**
+ * Schema service that queries schema on-demand (no caching)
+ *
+ * SQLite PRAGMA queries are extremely fast, so real-time queries
+ * are preferred over caching to avoid staleness issues.
+ */
+declare class SchemaService {
+  private db;
+  private options?;
+  private introspector;
+  constructor(db: LibSQLDatabase, options?: SchemaServiceOptions | undefined);
+  /**
+   * Gets schema for a specific table (real-time query)
+   */
+  getSchema(tableName: string): Promise<TableSchema | undefined>;
+  /**
+   * Checks if a table exists (real-time query)
+   */
+  hasTable(tableName: string): Promise<boolean>;
+  /**
+   * Gets all table schemas (real-time query)
+   */
+  getAllSchemas(): Promise<Map<string, TableSchema>>;
+  /**
+   * Lists all table names (real-time query)
+   */
+  listTableNames(): Promise<string[]>;
+  /**
+   * Gets the count of tables
+   */
+  getTableCount(): Promise<number>;
+  /**
+   * Gets the primary key column name for a table
+   */
+  getPrimaryKeyColumn(schema: TableSchema): string;
+}
+//#endregion
+export { SchemaService, SchemaServiceOptions };
+//# sourceMappingURL=service.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.mts","names":[],"sources":["../../src/schema/service.ts"],"mappings":";;;;;;AAeA;UAAiB,oBAAA;;EAEf,MAAA;EAEa;EAAb,aAAA;AAAA;;;;;;;cASW,aAAA;EAAA,QAID,EAAA;EAAA,QACA,OAAA;EAAA,QAJF,YAAA;cAGE,EAAA,EAAI,cAAA,EACJ,OAAA,GAAU,oBAAA;EA0HQ;;;EApHtB,SAAA,CAAU,SAAA,WAAoB,OAAA,CAAQ,WAAA;EANlC;;;EAuCJ,QAAA,CAAS,SAAA,WAAoB,OAAA;EAxCzB;;;EAuEJ,aAAA,CAAA,GAAiB,OAAA,CAAQ,GAAA,SAAY,WAAA;EAhE3B;;;EA0EV,cAAA,CAAA,GAAkB,OAAA;EAzCT;;;EA2ET,aAAA,CAAA,GAAiB,OAAA;EA5CQ;;;EAoD/B,mBAAA,CAAoB,MAAA,EAAQ,WAAA;AAAA"}