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

package/dist/router/path-router.cjs

@@ -8,26 +8,20 @@ let radix3 = require("radix3");
 * - / → 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
+* - /:table/:pk/.actions → listActions
+* - /:table/:pk/.actions/:action → executeAction
 */
 function createPathRouter() {
 	return (0, radix3.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" }
+		"/:table/:pk/.actions": { action: "listActions" },
+		"/:table/:pk/.actions/:action": { action: "executeAction" }
 	} });
 }
 /**
@@ -55,19 +49,17 @@ function buildPath(table, pk, suffix) {
 	return parts.join("/").replace(/\/+/g, "/");
 }
 /**
-* Checks if a path segment is a virtual path (@attr, @meta, @actions, @schema)
+* Checks if a path segment is a virtual path (@meta, .actions, .meta)
 */
 function isVirtualPath(segment) {
-	return segment.startsWith("@");
+	return segment.startsWith("@") || 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";
+	if (segment === ".actions") return "actions";
 	return null;
 }
 

package/dist/router/path-router.d.cts

@@ -9,13 +9,10 @@ import { RadixRouter } from "radix3";
  * - / → 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
+ * - /:table/:pk/.actions → listActions
+ * - /:table/:pk/.actions/:action → executeAction
  */
 declare function createPathRouter(): RadixRouter<RouteData>;
 /**
@@ -30,13 +27,13 @@ declare function matchPath(router: RadixRouter<RouteData>, path: string): RouteM
  */
 declare function buildPath(table?: string, pk?: string, suffix?: string): string;
 /**
- * Checks if a path segment is a virtual path (@attr, @meta, @actions, @schema)
+ * Checks if a path segment is a virtual path (@meta, .actions, .meta)
  */
 declare function isVirtualPath(segment: string): boolean;
 /**
  * Gets the type of virtual path
  */
-declare function getVirtualPathType(segment: string): "attr" | "meta" | "actions" | "schema" | null;
+declare function getVirtualPathType(segment: string): "meta" | "actions" | null;
 //#endregion
 export { buildPath, createPathRouter, getVirtualPathType, isVirtualPath, matchPath };
 //# sourceMappingURL=path-router.d.cts.map

package/dist/router/path-router.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"path-router.d.cts","names":[],"sources":["../../src/router/path-router.ts"],"mappings":";;;;;AAoBA;AA4BA;;;;;AAaA;AAWA;AAOA;;;;;;iBA3DgB,gBAAA,CAAA,GAAoB,WAAA,CAAY,SAAA;AAAA;AA4BhD;;;;;AA5BgD,iBA4BhC,SAAA,CAAA,MAAA,EAAkB,WAAA,CAAY,SAAA,GAAA,IAAA,WAA2B,UAAA;AAAA;;AAazE;AAbyE,iBAazD,SAAA,CAAA,KAAA,WAAA,EAAA,WAAA,MAAA;AAAA;AAWhB;AAOA;AAlBgB,iBAWA,aAAA,CAAA,OAAA;AAAA;AAOhB;;AAPgB,iBAOA,kBAAA,CAAA,OAAA"}
+{"version":3,"file":"path-router.d.cts","names":[],"sources":["../../src/router/path-router.ts"],"mappings":";;;;;AAiBA;;;;;AAyBA;;;;;;iBAzBgB,gBAAA,CAAA,GAAoB,WAAA,CAAY,SAAA;;;;;;;iBAyBhC,SAAA,CAAU,MAAA,EAAQ,WAAA,CAAY,SAAA,GAAY,IAAA,WAAe,UAAA;;AAazE;;iBAAgB,SAAA,CAAU,KAAA,WAAgB,EAAA,WAAa,MAAA;;;;iBAWvC,aAAA,CAAc,OAAA;;;AAA9B;iBAOgB,kBAAA,CAAmB,OAAA"}

package/dist/router/path-router.d.mts

@@ -9,13 +9,10 @@ import { RadixRouter } from "radix3";
  * - / → 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
+ * - /:table/:pk/.actions → listActions
+ * - /:table/:pk/.actions/:action → executeAction
  */
 declare function createPathRouter(): RadixRouter<RouteData>;
 /**
@@ -30,13 +27,13 @@ declare function matchPath(router: RadixRouter<RouteData>, path: string): RouteM
  */
 declare function buildPath(table?: string, pk?: string, suffix?: string): string;
 /**
- * Checks if a path segment is a virtual path (@attr, @meta, @actions, @schema)
+ * Checks if a path segment is a virtual path (@meta, .actions, .meta)
  */
 declare function isVirtualPath(segment: string): boolean;
 /**
  * Gets the type of virtual path
  */
-declare function getVirtualPathType(segment: string): "attr" | "meta" | "actions" | "schema" | null;
+declare function getVirtualPathType(segment: string): "meta" | "actions" | null;
 //#endregion
 export { buildPath, createPathRouter, getVirtualPathType, isVirtualPath, matchPath };
 //# sourceMappingURL=path-router.d.mts.map

package/dist/router/path-router.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"path-router.d.mts","names":[],"sources":["../../src/router/path-router.ts"],"mappings":";;;;;AAoBA;AA4BA;;;;;AAaA;AAWA;AAOA;;;;;;iBA3DgB,gBAAA,CAAA,GAAoB,WAAA,CAAY,SAAA;AAAA;AA4BhD;;;;;AA5BgD,iBA4BhC,SAAA,CAAA,MAAA,EAAkB,WAAA,CAAY,SAAA,GAAA,IAAA,WAA2B,UAAA;AAAA;;AAazE;AAbyE,iBAazD,SAAA,CAAA,KAAA,WAAA,EAAA,WAAA,MAAA;AAAA;AAWhB;AAOA;AAlBgB,iBAWA,aAAA,CAAA,OAAA;AAAA;AAOhB;;AAPgB,iBAOA,kBAAA,CAAA,OAAA"}
+{"version":3,"file":"path-router.d.mts","names":[],"sources":["../../src/router/path-router.ts"],"mappings":";;;;;AAiBA;;;;;AAyBA;;;;;;iBAzBgB,gBAAA,CAAA,GAAoB,WAAA,CAAY,SAAA;;;;;;;iBAyBhC,SAAA,CAAU,MAAA,EAAQ,WAAA,CAAY,SAAA,GAAY,IAAA,WAAe,UAAA;;AAazE;;iBAAgB,SAAA,CAAU,KAAA,WAAgB,EAAA,WAAa,MAAA;;;;iBAWvC,aAAA,CAAc,OAAA;;;AAA9B;iBAOgB,kBAAA,CAAmB,OAAA"}

package/dist/router/path-router.mjs

@@ -8,26 +8,20 @@ import { createRouter } from "radix3";
 * - / → 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
+* - /: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" }
+		"/:table/:pk/.actions": { action: "listActions" },
+		"/:table/:pk/.actions/:action": { action: "executeAction" }
 	} });
 }
 /**
@@ -55,19 +49,17 @@ function buildPath(table, pk, suffix) {
 	return parts.join("/").replace(/\/+/g, "/");
 }
 /**
-* Checks if a path segment is a virtual path (@attr, @meta, @actions, @schema)
+* Checks if a path segment is a virtual path (@meta, .actions, .meta)
 */
 function isVirtualPath(segment) {
-	return segment.startsWith("@");
+	return segment.startsWith("@") || 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";
+	if (segment === ".actions") return "actions";
 	return null;
 }
 

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

@@ -1 +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"}
+{"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/:pk → readRow\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\n      // Row-level routes\n      \"/:table/:pk\": { action: \"readRow\" },\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 (@meta, .actions, .meta)\n */\nexport function isVirtualPath(segment: string): boolean {\n  return segment.startsWith(\"@\") || segment.startsWith(\".\");\n}\n\n/**\n * Gets the type of virtual path\n */\nexport function getVirtualPathType(segment: string): \"meta\" | \"actions\" | null {\n  if (segment === \"@meta\") return \"meta\";\n  if (segment === \".actions\") return \"actions\";\n  return null;\n}\n"],"mappings":";;;;;;;;;;;;;;;AAiBA,SAAgB,mBAA2C;AACzD,QAAO,aAAwB,EAC7B,QAAQ;EAEN,KAAK,EAAE,QAAQ,cAAc;EAG7B,WAAW,EAAE,QAAQ,aAAa;EAClC,eAAe,EAAE,QAAQ,aAAa;EAGtC,eAAe,EAAE,QAAQ,WAAW;EACpC,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,IAAI,QAAQ,WAAW,IAAI;;;;;AAM3D,SAAgB,mBAAmB,SAA4C;AAC7E,KAAI,YAAY,QAAS,QAAO;AAChC,KAAI,YAAY,WAAY,QAAO;AACnC,QAAO"}

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

@@ -1 +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"}
+{"version":3,"file":"types.d.cts","names":[],"sources":["../../src/router/types.ts"],"mappings":";;AAGA;;KAAY,WAAA;;;AAeZ;UAAiB,SAAA;;EAEf,MAAA,EAAQ,WAAA;AAAA;AAMV;;;AAAA,UAAiB,UAAA,SAAmB,SAAA;EAClC,MAAA,EAAQ,WAAA;AAAA;;;;UAMO,WAAA;EAAW;EAE1B,KAAA;EAF0B;EAI1B,EAAA;EAAA;EAEA,MAAA;EAEA;EAAA,MAAA;AAAA"}

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

@@ -1 +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"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../src/router/types.ts"],"mappings":";;AAGA;;KAAY,WAAA;;;AAeZ;UAAiB,SAAA;;EAEf,MAAA,EAAQ,WAAA;AAAA;AAMV;;;AAAA,UAAiB,UAAA,SAAmB,SAAA;EAClC,MAAA,EAAQ,WAAA;AAAA;;;;UAMO,WAAA;EAAW;EAE1B,KAAA;EAF0B;EAI1B,EAAA;EAAA;EAEA,MAAA;EAEA;EAAA,MAAA;AAAA"}

package/dist/schema/introspector.d.cts

@@ -7,41 +7,41 @@ import { LibSQLDatabase } from "drizzle-orm/libsql";
  */
 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
-       */
+   * 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
-       */
+   * 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
-       */
+   * 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
-       */
+   * 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
-       */
+   * 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)
-       */
+   * Rebuilds FTS index for a table (useful after bulk inserts)
+   */
   rebuildFTS(db: LibSQLDatabase, tableName: string): Promise<void>;
 }
 //#endregion

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

@@ -1 +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"}
+{"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

@@ -7,41 +7,41 @@ import { LibSQLDatabase } from "drizzle-orm/libsql";
  */
 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
-       */
+   * 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
-       */
+   * 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
-       */
+   * 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
-       */
+   * 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
-       */
+   * 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)
-       */
+   * Rebuilds FTS index for a table (useful after bulk inserts)
+   */
   rebuildFTS(db: LibSQLDatabase, tableName: string): Promise<void>;
 }
 //#endregion

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

@@ -1 +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"}
+{"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/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"}

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