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

package/dist/schema/service.mjs

@@ -0,0 +1,87 @@
+import { SYSTEM_TABLES } from "./types.mjs";
+import { SchemaIntrospector } from "./introspector.mjs";
+import { sql } from "@aigne/sqlite";
+
+//#region src/schema/service.ts
+/**
+* Executes a raw SQL query and returns all rows
+*/
+async function execAll(db, query) {
+	return db.all(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 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 (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 (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 (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
+export { SchemaService };
+//# sourceMappingURL=service.mjs.map

package/dist/schema/service.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.mjs","names":[],"sources":["../../src/schema/service.ts"],"sourcesContent":["import { sql } from \"@aigne/sqlite\";\nimport type { LibSQLDatabase } from \"drizzle-orm/libsql\";\nimport { SchemaIntrospector } from \"./introspector.js\";\nimport { SYSTEM_TABLES, type TableSchema } 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 * Options for schema service\n */\nexport interface SchemaServiceOptions {\n  /** Whitelist of tables to include */\n  tables?: string[];\n  /** Tables to exclude */\n  excludeTables?: string[];\n}\n\n/**\n * Schema service that queries schema on-demand (no caching)\n *\n * SQLite PRAGMA queries are extremely fast, so real-time queries\n * are preferred over caching to avoid staleness issues.\n */\nexport class SchemaService {\n  private introspector = new SchemaIntrospector();\n\n  constructor(\n    private db: LibSQLDatabase,\n    private options?: SchemaServiceOptions,\n  ) {}\n\n  /**\n   * Gets schema for a specific table (real-time query)\n   */\n  async getSchema(tableName: string): Promise<TableSchema | undefined> {\n    // Guard against undefined/null\n    if (!tableName) {\n      return undefined;\n    }\n\n    // Skip system tables\n    if (SYSTEM_TABLES.includes(tableName as (typeof SYSTEM_TABLES)[number])) {\n      return undefined;\n    }\n\n    // Apply whitelist filter\n    if (this.options?.tables && !this.options.tables.includes(tableName)) {\n      return undefined;\n    }\n\n    // Apply exclude filter\n    if (this.options?.excludeTables?.includes(tableName)) {\n      return undefined;\n    }\n\n    // Check if table exists\n    const exists = await this.hasTable(tableName);\n    if (!exists) {\n      return undefined;\n    }\n\n    return this.introspector.introspectTable(this.db, tableName);\n  }\n\n  /**\n   * Checks if a table exists (real-time query)\n   */\n  async hasTable(tableName: string): Promise<boolean> {\n    // Guard against undefined/null\n    if (!tableName) {\n      return false;\n    }\n\n    // Skip system tables\n    if (SYSTEM_TABLES.includes(tableName as (typeof SYSTEM_TABLES)[number])) {\n      return false;\n    }\n\n    // Apply whitelist filter\n    if (this.options?.tables && !this.options.tables.includes(tableName)) {\n      return false;\n    }\n\n    // Apply exclude filter\n    if (this.options?.excludeTables?.includes(tableName)) {\n      return false;\n    }\n\n    const result = await execAll<{ count: number }>(\n      this.db,\n      `SELECT COUNT(*) as count FROM sqlite_master WHERE type = 'table' AND name = '${tableName.replace(/'/g, \"''\")}'`,\n    );\n    return (result[0]?.count ?? 0) > 0;\n  }\n\n  /**\n   * Gets all table schemas (real-time query)\n   */\n  async getAllSchemas(): Promise<Map<string, TableSchema>> {\n    return this.introspector.introspect(this.db, {\n      tables: this.options?.tables,\n      excludeTables: this.options?.excludeTables,\n    });\n  }\n\n  /**\n   * Lists all table names (real-time query)\n   */\n  async listTableNames(): Promise<string[]> {\n    const result = await execAll<{ name: string }>(\n      this.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    return result\n      .map((r) => r.name)\n      .filter((name) => {\n        // Skip system tables\n        if (SYSTEM_TABLES.includes(name as (typeof SYSTEM_TABLES)[number])) {\n          return false;\n        }\n        // Apply whitelist filter\n        if (this.options?.tables && !this.options.tables.includes(name)) {\n          return false;\n        }\n        // Apply exclude filter\n        if (this.options?.excludeTables?.includes(name)) {\n          return false;\n        }\n        return true;\n      });\n  }\n\n  /**\n   * Gets the count of tables\n   */\n  async getTableCount(): Promise<number> {\n    const names = await this.listTableNames();\n    return names.length;\n  }\n\n  /**\n   * Gets the primary key column name for a table\n   */\n  getPrimaryKeyColumn(schema: TableSchema): string {\n    return this.introspector.getPrimaryKeyColumn(schema);\n  }\n}\n"],"mappings":";;;;;;;;AAQA,eAAe,QAAW,IAAoB,OAA6B;AACzE,QAAO,GAAG,IAAO,IAAI,IAAI,MAAM,CAAC,CAAC,SAAS;;;;;;;;AAmB5C,IAAa,gBAAb,MAA2B;CACzB,AAAQ,eAAe,IAAI,oBAAoB;CAE/C,YACE,AAAQ,IACR,AAAQ,SACR;EAFQ;EACA;;;;;CAMV,MAAM,UAAU,WAAqD;AAEnE,MAAI,CAAC,UACH;AAIF,MAAI,cAAc,SAAS,UAA4C,CACrE;AAIF,MAAI,KAAK,SAAS,UAAU,CAAC,KAAK,QAAQ,OAAO,SAAS,UAAU,CAClE;AAIF,MAAI,KAAK,SAAS,eAAe,SAAS,UAAU,CAClD;AAKF,MAAI,CADW,MAAM,KAAK,SAAS,UAAU,CAE3C;AAGF,SAAO,KAAK,aAAa,gBAAgB,KAAK,IAAI,UAAU;;;;;CAM9D,MAAM,SAAS,WAAqC;AAElD,MAAI,CAAC,UACH,QAAO;AAIT,MAAI,cAAc,SAAS,UAA4C,CACrE,QAAO;AAIT,MAAI,KAAK,SAAS,UAAU,CAAC,KAAK,QAAQ,OAAO,SAAS,UAAU,CAClE,QAAO;AAIT,MAAI,KAAK,SAAS,eAAe,SAAS,UAAU,CAClD,QAAO;AAOT,WAJe,MAAM,QACnB,KAAK,IACL,gFAAgF,UAAU,QAAQ,MAAM,KAAK,CAAC,GAC/G,EACc,IAAI,SAAS,KAAK;;;;;CAMnC,MAAM,gBAAmD;AACvD,SAAO,KAAK,aAAa,WAAW,KAAK,IAAI;GAC3C,QAAQ,KAAK,SAAS;GACtB,eAAe,KAAK,SAAS;GAC9B,CAAC;;;;;CAMJ,MAAM,iBAAoC;AAYxC,UAXe,MAAM,QACnB,KAAK,IACL;;;;;;MAOD,EAGE,KAAK,MAAM,EAAE,KAAK,CAClB,QAAQ,SAAS;AAEhB,OAAI,cAAc,SAAS,KAAuC,CAChE,QAAO;AAGT,OAAI,KAAK,SAAS,UAAU,CAAC,KAAK,QAAQ,OAAO,SAAS,KAAK,CAC7D,QAAO;AAGT,OAAI,KAAK,SAAS,eAAe,SAAS,KAAK,CAC7C,QAAO;AAET,UAAO;IACP;;;;;CAMN,MAAM,gBAAiC;AAErC,UADc,MAAM,KAAK,gBAAgB,EAC5B;;;;;CAMf,oBAAoB,QAA6B;AAC/C,SAAO,KAAK,aAAa,oBAAoB,OAAO"}

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;

package/dist/schema/types.d.cts

@@ -0,0 +1,104 @@
+//#region src/schema/types.d.ts
+/**
+ * Column information from SQLite PRAGMA table_info
+ */
+interface ColumnInfo {
+  /** Column name */
+  name: string;
+  /** SQLite type (INTEGER, TEXT, REAL, BLOB, etc.) */
+  type: string;
+  /** Whether the column has NOT NULL constraint */
+  notnull: boolean;
+  /** Whether this column is part of the primary key */
+  pk: number;
+  /** Default value for the column */
+  dfltValue: unknown;
+}
+/**
+ * Foreign key information from SQLite PRAGMA foreign_key_list
+ */
+interface ForeignKeyInfo {
+  /** Foreign key id */
+  id: number;
+  /** Sequence number for composite foreign keys */
+  seq: number;
+  /** Referenced table */
+  table: string;
+  /** Column in this table */
+  from: string;
+  /** Column in referenced table */
+  to: string;
+  /** ON UPDATE action */
+  onUpdate: string;
+  /** ON DELETE action */
+  onDelete: string;
+  /** MATCH clause */
+  match: string;
+}
+/**
+ * Index information from SQLite PRAGMA index_list
+ */
+interface IndexInfo {
+  /** Index sequence number */
+  seq: number;
+  /** Index name */
+  name: string;
+  /** Whether this is a unique index */
+  unique: boolean;
+  /** Origin of the index (c = CREATE INDEX, u = UNIQUE constraint, pk = PRIMARY KEY) */
+  origin: string;
+  /** Whether the index is partial */
+  partial: boolean;
+}
+/**
+ * Complete schema information for a single table
+ */
+interface TableSchema {
+  /** Table name */
+  name: string;
+  /** Column definitions */
+  columns: ColumnInfo[];
+  /** Primary key column names */
+  primaryKey: string[];
+  /** Foreign key relationships */
+  foreignKeys: ForeignKeyInfo[];
+  /** Indexes on this table */
+  indexes: IndexInfo[];
+}
+/**
+ * Raw PRAGMA table_info result row
+ */
+interface PragmaTableInfoRow {
+  cid: number;
+  name: string;
+  type: string;
+  notnull: number;
+  dflt_value: unknown;
+  pk: number;
+}
+/**
+ * Raw PRAGMA foreign_key_list result row
+ */
+interface PragmaForeignKeyRow {
+  id: number;
+  seq: number;
+  table: string;
+  from: string;
+  to: string;
+  on_update: string;
+  on_delete: string;
+  match: string;
+}
+/**
+ * Raw PRAGMA index_list result row
+ */
+interface PragmaIndexListRow {
+  seq: number;
+  name: string;
+  unique: number;
+  origin: string;
+  partial: number;
+}
+//#endregion
+export { ColumnInfo, ForeignKeyInfo, IndexInfo, PragmaForeignKeyRow, PragmaIndexListRow, PragmaTableInfoRow, TableSchema };
+//# sourceMappingURL=types.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.cts","names":[],"sources":["../../src/schema/types.ts"],"mappings":";;AAGA;;UAAiB,UAAA;EAAU;EAEzB,IAAA;EAEA;EAAA,IAAA;EAIA;EAFA,OAAA;EAIS;EAFT,EAAA;EAQe;EANf,SAAA;AAAA;;;;UAMe,cAAA;EAQf;EANA,EAAA;EAUA;EARA,GAAA;EAYA;EAVA,KAAA;EAUK;EARL,IAAA;EAcwB;EAZxB,EAAA;EAYwB;EAVxB,QAAA;EAcA;EAZA,QAAA;EAgBA;EAdA,KAAA;AAAA;;AAsBF;;UAhBiB,SAAA;EAoBN;EAlBT,GAAA;EAwBS;EAtBT,IAAA;EAsBkB;EApBlB,MAAA;EAcA;EAZA,MAAA;EAcA;EAZA,OAAA;AAAA;;;;UAMe,WAAA;EAgBA;EAdf,IAAA;;EAEA,OAAA,EAAS,UAAA;EAaT;EAXA,UAAA;EAaA;EAXA,WAAA,EAAa,cAAA;EAab;EAXA,OAAA,EAAS,SAAA;AAAA;;AAkBX;;UAZiB,kBAAA;EACf,GAAA;EACA,IAAA;EACA,IAAA;EACA,OAAA;EACA,UAAA;EACA,EAAA;AAAA;;;;UAMe,mBAAA;EACf,EAAA;EACA,GAAA;EACA,KAAA;EACA,IAAA;EACA,EAAA;EACA,SAAA;EACA,SAAA;EACA,KAAA;AAAA;;;;UAMe,kBAAA;EACf,GAAA;EACA,IAAA;EACA,MAAA;EACA,MAAA;EACA,OAAA;AAAA"}

package/dist/schema/types.d.mts

@@ -0,0 +1,104 @@
+//#region src/schema/types.d.ts
+/**
+ * Column information from SQLite PRAGMA table_info
+ */
+interface ColumnInfo {
+  /** Column name */
+  name: string;
+  /** SQLite type (INTEGER, TEXT, REAL, BLOB, etc.) */
+  type: string;
+  /** Whether the column has NOT NULL constraint */
+  notnull: boolean;
+  /** Whether this column is part of the primary key */
+  pk: number;
+  /** Default value for the column */
+  dfltValue: unknown;
+}
+/**
+ * Foreign key information from SQLite PRAGMA foreign_key_list
+ */
+interface ForeignKeyInfo {
+  /** Foreign key id */
+  id: number;
+  /** Sequence number for composite foreign keys */
+  seq: number;
+  /** Referenced table */
+  table: string;
+  /** Column in this table */
+  from: string;
+  /** Column in referenced table */
+  to: string;
+  /** ON UPDATE action */
+  onUpdate: string;
+  /** ON DELETE action */
+  onDelete: string;
+  /** MATCH clause */
+  match: string;
+}
+/**
+ * Index information from SQLite PRAGMA index_list
+ */
+interface IndexInfo {
+  /** Index sequence number */
+  seq: number;
+  /** Index name */
+  name: string;
+  /** Whether this is a unique index */
+  unique: boolean;
+  /** Origin of the index (c = CREATE INDEX, u = UNIQUE constraint, pk = PRIMARY KEY) */
+  origin: string;
+  /** Whether the index is partial */
+  partial: boolean;
+}
+/**
+ * Complete schema information for a single table
+ */
+interface TableSchema {
+  /** Table name */
+  name: string;
+  /** Column definitions */
+  columns: ColumnInfo[];
+  /** Primary key column names */
+  primaryKey: string[];
+  /** Foreign key relationships */
+  foreignKeys: ForeignKeyInfo[];
+  /** Indexes on this table */
+  indexes: IndexInfo[];
+}
+/**
+ * Raw PRAGMA table_info result row
+ */
+interface PragmaTableInfoRow {
+  cid: number;
+  name: string;
+  type: string;
+  notnull: number;
+  dflt_value: unknown;
+  pk: number;
+}
+/**
+ * Raw PRAGMA foreign_key_list result row
+ */
+interface PragmaForeignKeyRow {
+  id: number;
+  seq: number;
+  table: string;
+  from: string;
+  to: string;
+  on_update: string;
+  on_delete: string;
+  match: string;
+}
+/**
+ * Raw PRAGMA index_list result row
+ */
+interface PragmaIndexListRow {
+  seq: number;
+  name: string;
+  unique: number;
+  origin: string;
+  partial: number;
+}
+//#endregion
+export { ColumnInfo, ForeignKeyInfo, IndexInfo, PragmaForeignKeyRow, PragmaIndexListRow, PragmaTableInfoRow, TableSchema };
+//# sourceMappingURL=types.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../src/schema/types.ts"],"mappings":";;AAGA;;UAAiB,UAAA;EAAU;EAEzB,IAAA;EAEA;EAAA,IAAA;EAIA;EAFA,OAAA;EAIS;EAFT,EAAA;EAQe;EANf,SAAA;AAAA;;;;UAMe,cAAA;EAQf;EANA,EAAA;EAUA;EARA,GAAA;EAYA;EAVA,KAAA;EAUK;EARL,IAAA;EAcwB;EAZxB,EAAA;EAYwB;EAVxB,QAAA;EAcA;EAZA,QAAA;EAgBA;EAdA,KAAA;AAAA;;AAsBF;;UAhBiB,SAAA;EAoBN;EAlBT,GAAA;EAwBS;EAtBT,IAAA;EAsBkB;EApBlB,MAAA;EAcA;EAZA,MAAA;EAcA;EAZA,OAAA;AAAA;;;;UAMe,WAAA;EAgBA;EAdf,IAAA;;EAEA,OAAA,EAAS,UAAA;EAaT;EAXA,UAAA;EAaA;EAXA,WAAA,EAAa,cAAA;EAab;EAXA,OAAA,EAAS,SAAA;AAAA;;AAkBX;;UAZiB,kBAAA;EACf,GAAA;EACA,IAAA;EACA,IAAA;EACA,OAAA;EACA,UAAA;EACA,EAAA;AAAA;;;;UAMe,mBAAA;EACf,EAAA;EACA,GAAA;EACA,KAAA;EACA,IAAA;EACA,EAAA;EACA,SAAA;EACA,SAAA;EACA,KAAA;AAAA;;;;UAMe,kBAAA;EACf,GAAA;EACA,IAAA;EACA,MAAA;EACA,MAAA;EACA,OAAA;AAAA"}

package/dist/schema/types.mjs

@@ -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
+export { SYSTEM_TABLES };
+//# sourceMappingURL=types.mjs.map

package/dist/schema/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.mjs","names":[],"sources":["../../src/schema/types.ts"],"sourcesContent":["/**\n * Column information from SQLite PRAGMA table_info\n */\nexport interface ColumnInfo {\n  /** Column name */\n  name: string;\n  /** SQLite type (INTEGER, TEXT, REAL, BLOB, etc.) */\n  type: string;\n  /** Whether the column has NOT NULL constraint */\n  notnull: boolean;\n  /** Whether this column is part of the primary key */\n  pk: number;\n  /** Default value for the column */\n  dfltValue: unknown;\n}\n\n/**\n * Foreign key information from SQLite PRAGMA foreign_key_list\n */\nexport interface ForeignKeyInfo {\n  /** Foreign key id */\n  id: number;\n  /** Sequence number for composite foreign keys */\n  seq: number;\n  /** Referenced table */\n  table: string;\n  /** Column in this table */\n  from: string;\n  /** Column in referenced table */\n  to: string;\n  /** ON UPDATE action */\n  onUpdate: string;\n  /** ON DELETE action */\n  onDelete: string;\n  /** MATCH clause */\n  match: string;\n}\n\n/**\n * Index information from SQLite PRAGMA index_list\n */\nexport interface IndexInfo {\n  /** Index sequence number */\n  seq: number;\n  /** Index name */\n  name: string;\n  /** Whether this is a unique index */\n  unique: boolean;\n  /** Origin of the index (c = CREATE INDEX, u = UNIQUE constraint, pk = PRIMARY KEY) */\n  origin: string;\n  /** Whether the index is partial */\n  partial: boolean;\n}\n\n/**\n * Complete schema information for a single table\n */\nexport interface TableSchema {\n  /** Table name */\n  name: string;\n  /** Column definitions */\n  columns: ColumnInfo[];\n  /** Primary key column names */\n  primaryKey: string[];\n  /** Foreign key relationships */\n  foreignKeys: ForeignKeyInfo[];\n  /** Indexes on this table */\n  indexes: IndexInfo[];\n}\n\n/**\n * Raw PRAGMA table_info result row\n */\nexport interface PragmaTableInfoRow {\n  cid: number;\n  name: string;\n  type: string;\n  notnull: number;\n  dflt_value: unknown;\n  pk: number;\n}\n\n/**\n * Raw PRAGMA foreign_key_list result row\n */\nexport interface PragmaForeignKeyRow {\n  id: number;\n  seq: number;\n  table: string;\n  from: string;\n  to: string;\n  on_update: string;\n  on_delete: string;\n  match: string;\n}\n\n/**\n * Raw PRAGMA index_list result row\n */\nexport interface PragmaIndexListRow {\n  seq: number;\n  name: string;\n  unique: number;\n  origin: string;\n  partial: number;\n}\n\n/**\n * System tables that should be excluded from introspection\n */\nexport const SYSTEM_TABLES = [\n  \"sqlite_sequence\",\n  \"sqlite_stat1\",\n  \"sqlite_stat2\",\n  \"sqlite_stat3\",\n  \"sqlite_stat4\",\n] as const;\n"],"mappings":";;;;AA8GA,MAAa,gBAAgB;CAC3B;CACA;CACA;CACA;CACA;CACD"}