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

package/dist/operations/search.cjs

@@ -0,0 +1,141 @@
+const require_builder = require('../node/builder.cjs');
+let _aigne_sqlite = require("@aigne/sqlite");
+
+//#region src/operations/search.ts
+/**
+* Executes a raw SQL query and returns all rows
+*/
+async function execAll(db, query) {
+	return db.all(_aigne_sqlite.sql.raw(query)).execute();
+}
+/**
+* FTS5 Search operations for SQLite AFS
+*/
+var FTSSearch = class {
+	constructor(db, schemas, config, basePath = "") {
+		this.db = db;
+		this.schemas = schemas;
+		this.config = config;
+		this.basePath = basePath;
+	}
+	/**
+	* Performs full-text search across configured tables
+	*/
+	async search(query, options) {
+		if (!this.config.enabled) return {
+			data: [],
+			message: "Full-text search is not enabled"
+		};
+		const results = [];
+		const limit = options?.limit ?? 50;
+		const buildOptions = { basePath: this.basePath };
+		const tablesToSearch = options?.tables ? options.tables.filter((t) => this.config.tables.has(t)) : Array.from(this.config.tables.keys());
+		const ftsQuery = this.prepareFTSQuery(query, options?.caseSensitive);
+		for (const tableName of tablesToSearch) {
+			const tableConfig = this.config.tables.get(tableName);
+			const schema = this.schemas.get(tableName);
+			if (!tableConfig || !schema) continue;
+			const ftsTableName = `${tableName}_fts`;
+			try {
+				if (!await this.ftsTableExists(ftsTableName)) continue;
+				const highlightColumn = tableConfig.columns[0] ?? "";
+				const highlightIndex = highlightColumn ? tableConfig.columns.indexOf(highlightColumn) : 0;
+				const rows = await execAll(this.db, `
+            SELECT t.*, highlight("${ftsTableName}", ${highlightIndex}, '<mark>', '</mark>') as snippet
+            FROM "${ftsTableName}" fts
+            JOIN "${tableName}" t ON fts.rowid = t.rowid
+            WHERE "${ftsTableName}" MATCH '${ftsQuery}'
+            LIMIT ${Math.ceil(limit / tablesToSearch.length)}
+          `);
+				for (const row of rows) {
+					const { snippet, ...rowData } = row;
+					results.push(require_builder.buildSearchEntry(tableName, schema, rowData, snippet, buildOptions));
+				}
+			} catch (error) {
+				console.warn(`FTS search failed for table ${tableName}:`, error);
+			}
+			if (results.length >= limit) break;
+		}
+		return {
+			data: results.slice(0, limit),
+			message: results.length === 0 ? `No results found for "${query}"` : void 0
+		};
+	}
+	/**
+	* Searches within a specific table
+	*/
+	async searchTable(tableName, query, options) {
+		return this.search(query, {
+			...options,
+			tables: [tableName]
+		});
+	}
+	/**
+	* Checks if FTS is configured for a table
+	*/
+	hasFTS(tableName) {
+		return this.config.enabled && this.config.tables.has(tableName);
+	}
+	/**
+	* Gets FTS configuration for a table
+	*/
+	getFTSConfig(tableName) {
+		return this.config.tables.get(tableName);
+	}
+	/**
+	* Checks if an FTS table exists
+	*/
+	async ftsTableExists(ftsTableName) {
+		return (await execAll(this.db, `SELECT name FROM sqlite_master WHERE type = 'table' AND name = '${ftsTableName}'`)).length > 0;
+	}
+	/**
+	* Prepares a query string for FTS5
+	* Handles special characters and case sensitivity
+	*/
+	prepareFTSQuery(query, _caseSensitive) {
+		let prepared = query.replace(/"/g, "\"\"").replace(/'/g, "''");
+		if (prepared.includes(" ") && !prepared.startsWith("\"")) prepared = `"${prepared}"`;
+		return prepared;
+	}
+	/**
+	* Updates the schemas map (after refresh)
+	*/
+	setSchemas(schemas) {
+		this.schemas = schemas;
+	}
+	/**
+	* Simple search fallback when FTS is not available
+	* Uses LIKE queries on specified columns
+	*/
+	async simpleLikeSearch(tableName, query, columns, options) {
+		const schema = this.schemas.get(tableName);
+		if (!schema) return {
+			data: [],
+			message: `Table '${tableName}' not found`
+		};
+		const buildOptions = { basePath: this.basePath };
+		const limit = options?.limit ?? 50;
+		const escapedQuery = query.replace(/'/g, "''");
+		const conditions = columns.filter((col) => schema.columns.some((c) => c.name === col)).map((col) => `"${col}" LIKE '%${escapedQuery}%'`).join(" OR ");
+		if (!conditions) return {
+			data: [],
+			message: "No valid columns to search"
+		};
+		return { data: (await execAll(this.db, `SELECT * FROM "${tableName}" WHERE ${conditions} LIMIT ${limit}`)).map((row) => require_builder.buildSearchEntry(tableName, schema, row, void 0, buildOptions)) };
+	}
+};
+/**
+* Creates FTS configuration from options
+*/
+function createFTSConfig(options) {
+	const config = {
+		enabled: options?.enabled ?? false,
+		tables: /* @__PURE__ */ new Map()
+	};
+	if (options?.tables) for (const [table, columns] of Object.entries(options.tables)) config.tables.set(table, { columns });
+	return config;
+}
+
+//#endregion
+exports.FTSSearch = FTSSearch;
+exports.createFTSConfig = createFTSConfig;

package/dist/operations/search.d.cts

@@ -0,0 +1,79 @@
+import { TableSchema } from "../schema/types.cjs";
+import { LibSQLDatabase } from "drizzle-orm/libsql";
+import { AFSSearchOptions, AFSSearchResult } from "@aigne/afs";
+
+//#region src/operations/search.d.ts
+/**
+ * FTS5 search configuration for a table
+ */
+interface FTSTableConfig {
+  /** Columns to include in FTS index */
+  columns: string[];
+  /** Whether FTS table has been created */
+  initialized?: boolean;
+}
+/**
+ * FTS5 search configuration
+ */
+interface FTSConfig {
+  /** Whether FTS is enabled */
+  enabled: boolean;
+  /** Per-table FTS configuration */
+  tables: Map<string, FTSTableConfig>;
+}
+/**
+ * FTS5 Search operations for SQLite AFS
+ */
+declare class FTSSearch {
+  private db;
+  private schemas;
+  private config;
+  private basePath;
+  constructor(db: LibSQLDatabase, schemas: Map<string, TableSchema>, config: FTSConfig, basePath?: string);
+  /**
+       * Performs full-text search across configured tables
+       */
+  search(query: string, options?: AFSSearchOptions & {
+    /** Specific tables to search (defaults to all FTS-enabled tables) */tables?: string[];
+  }): Promise<AFSSearchResult>;
+  /**
+       * Searches within a specific table
+       */
+  searchTable(tableName: string, query: string, options?: AFSSearchOptions): Promise<AFSSearchResult>;
+  /**
+       * Checks if FTS is configured for a table
+       */
+  hasFTS(tableName: string): boolean;
+  /**
+       * Gets FTS configuration for a table
+       */
+  getFTSConfig(tableName: string): FTSTableConfig | undefined;
+  /**
+       * Checks if an FTS table exists
+       */
+  private ftsTableExists;
+  /**
+       * Prepares a query string for FTS5
+       * Handles special characters and case sensitivity
+       */
+  private prepareFTSQuery;
+  /**
+       * Updates the schemas map (after refresh)
+       */
+  setSchemas(schemas: Map<string, TableSchema>): void;
+  /**
+       * Simple search fallback when FTS is not available
+       * Uses LIKE queries on specified columns
+       */
+  simpleLikeSearch(tableName: string, query: string, columns: string[], options?: AFSSearchOptions): Promise<AFSSearchResult>;
+}
+/**
+ * Creates FTS configuration from options
+ */
+declare function createFTSConfig(options?: {
+  enabled?: boolean;
+  tables?: Record<string, string[]>;
+}): FTSConfig;
+//#endregion
+export { FTSConfig, FTSSearch, FTSTableConfig, createFTSConfig };
+//# sourceMappingURL=search.d.cts.map

package/dist/operations/search.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.cts","names":[],"sources":["../../src/operations/search.ts"],"mappings":";;;;;;AAgBA;AAUA;UAViB,cAAA;EAAA;EAAA,OAAA;EAAA;EAAA,WAAA;AAAA;AAAA;AAUjB;AAUA;AApBiB,UAUA,SAAA;EAAA;EAAA,OAAA;EAAA;EAAA,MAAA,EAIP,GAAA,SAAY,cAAA;AAAA;AAAA;AAMtB;;AANsB,cAMT,SAAA;EAAA,QAAA,EAAA;EAAA,QAAA,OAAA;EAAA,QAAA,MAAA;EAAA,QAAA,QAAA;EAAA,YAAA,EAAA,EAEG,cAAA,EAAA,OAAA,EACK,GAAA,SAAY,WAAA,GAAA,MAAA,EACb,SAAA,EAAA,QAAA;EAAA;;;EAAA,OAAA,KAAA,UAAA,OAAA,GASN,gBAAA;IAAA,qEAAA,MAAA;EAAA,IAIT,OAAA,CAAQ,eAAA;EAAA;;;EAAA,YAAA,SAAA,UAAA,KAAA,UAAA,OAAA,GA+EC,gBAAA,GACT,OAAA,CAAQ,eAAA;EAAA;;;EAAA,OAAA,SAAA;EAAA;;;EAAA,aAAA,SAAA,WAcsB,cAAA;EAAA;;;EAAA,QAAA,cAAA;EAAA;;;;EAAA,QAAA,eAAA;EAAA;;;EAAA,WAAA,OAAA,EAuCb,GAAA,SAAY,WAAA;EAAA;;;;EAAA,iBAAA,SAAA,UAAA,KAAA,UAAA,OAAA,YAAA,OAAA,GAYpB,gBAAA,GACT,OAAA,CAAQ,eAAA;AAAA;AAAA;;;AAAA,iBAkCG,eAAA,CAAA,OAAA;EAAA,OAAA;EAAA,MAAA,GAEL,MAAA;AAAA,IACP,SAAA"}

package/dist/operations/search.d.mts

@@ -0,0 +1,79 @@
+import { TableSchema } from "../schema/types.mjs";
+import { AFSSearchOptions, AFSSearchResult } from "@aigne/afs";
+import { LibSQLDatabase } from "drizzle-orm/libsql";
+
+//#region src/operations/search.d.ts
+/**
+ * FTS5 search configuration for a table
+ */
+interface FTSTableConfig {
+  /** Columns to include in FTS index */
+  columns: string[];
+  /** Whether FTS table has been created */
+  initialized?: boolean;
+}
+/**
+ * FTS5 search configuration
+ */
+interface FTSConfig {
+  /** Whether FTS is enabled */
+  enabled: boolean;
+  /** Per-table FTS configuration */
+  tables: Map<string, FTSTableConfig>;
+}
+/**
+ * FTS5 Search operations for SQLite AFS
+ */
+declare class FTSSearch {
+  private db;
+  private schemas;
+  private config;
+  private basePath;
+  constructor(db: LibSQLDatabase, schemas: Map<string, TableSchema>, config: FTSConfig, basePath?: string);
+  /**
+       * Performs full-text search across configured tables
+       */
+  search(query: string, options?: AFSSearchOptions & {
+    /** Specific tables to search (defaults to all FTS-enabled tables) */tables?: string[];
+  }): Promise<AFSSearchResult>;
+  /**
+       * Searches within a specific table
+       */
+  searchTable(tableName: string, query: string, options?: AFSSearchOptions): Promise<AFSSearchResult>;
+  /**
+       * Checks if FTS is configured for a table
+       */
+  hasFTS(tableName: string): boolean;
+  /**
+       * Gets FTS configuration for a table
+       */
+  getFTSConfig(tableName: string): FTSTableConfig | undefined;
+  /**
+       * Checks if an FTS table exists
+       */
+  private ftsTableExists;
+  /**
+       * Prepares a query string for FTS5
+       * Handles special characters and case sensitivity
+       */
+  private prepareFTSQuery;
+  /**
+       * Updates the schemas map (after refresh)
+       */
+  setSchemas(schemas: Map<string, TableSchema>): void;
+  /**
+       * Simple search fallback when FTS is not available
+       * Uses LIKE queries on specified columns
+       */
+  simpleLikeSearch(tableName: string, query: string, columns: string[], options?: AFSSearchOptions): Promise<AFSSearchResult>;
+}
+/**
+ * Creates FTS configuration from options
+ */
+declare function createFTSConfig(options?: {
+  enabled?: boolean;
+  tables?: Record<string, string[]>;
+}): FTSConfig;
+//#endregion
+export { FTSConfig, FTSSearch, FTSTableConfig, createFTSConfig };
+//# sourceMappingURL=search.d.mts.map

package/dist/operations/search.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.mts","names":[],"sources":["../../src/operations/search.ts"],"mappings":";;;;;;AAgBA;AAUA;UAViB,cAAA;EAAA;EAAA,OAAA;EAAA;EAAA,WAAA;AAAA;AAAA;AAUjB;AAUA;AApBiB,UAUA,SAAA;EAAA;EAAA,OAAA;EAAA;EAAA,MAAA,EAIP,GAAA,SAAY,cAAA;AAAA;AAAA;AAMtB;;AANsB,cAMT,SAAA;EAAA,QAAA,EAAA;EAAA,QAAA,OAAA;EAAA,QAAA,MAAA;EAAA,QAAA,QAAA;EAAA,YAAA,EAAA,EAEG,cAAA,EAAA,OAAA,EACK,GAAA,SAAY,WAAA,GAAA,MAAA,EACb,SAAA,EAAA,QAAA;EAAA;;;EAAA,OAAA,KAAA,UAAA,OAAA,GASN,gBAAA;IAAA,qEAAA,MAAA;EAAA,IAIT,OAAA,CAAQ,eAAA;EAAA;;;EAAA,YAAA,SAAA,UAAA,KAAA,UAAA,OAAA,GA+EC,gBAAA,GACT,OAAA,CAAQ,eAAA;EAAA;;;EAAA,OAAA,SAAA;EAAA;;;EAAA,aAAA,SAAA,WAcsB,cAAA;EAAA;;;EAAA,QAAA,cAAA;EAAA;;;;EAAA,QAAA,eAAA;EAAA;;;EAAA,WAAA,OAAA,EAuCb,GAAA,SAAY,WAAA;EAAA;;;;EAAA,iBAAA,SAAA,UAAA,KAAA,UAAA,OAAA,YAAA,OAAA,GAYpB,gBAAA,GACT,OAAA,CAAQ,eAAA;AAAA;AAAA;;;AAAA,iBAkCG,eAAA,CAAA,OAAA;EAAA,OAAA;EAAA,MAAA,GAEL,MAAA;AAAA,IACP,SAAA"}

package/dist/operations/search.mjs

@@ -0,0 +1,141 @@
+import { buildSearchEntry } from "../node/builder.mjs";
+import { sql } from "@aigne/sqlite";
+
+//#region src/operations/search.ts
+/**
+* Executes a raw SQL query and returns all rows
+*/
+async function execAll(db, query) {
+	return db.all(sql.raw(query)).execute();
+}
+/**
+* FTS5 Search operations for SQLite AFS
+*/
+var FTSSearch = class {
+	constructor(db, schemas, config, basePath = "") {
+		this.db = db;
+		this.schemas = schemas;
+		this.config = config;
+		this.basePath = basePath;
+	}
+	/**
+	* Performs full-text search across configured tables
+	*/
+	async search(query, options) {
+		if (!this.config.enabled) return {
+			data: [],
+			message: "Full-text search is not enabled"
+		};
+		const results = [];
+		const limit = options?.limit ?? 50;
+		const buildOptions = { basePath: this.basePath };
+		const tablesToSearch = options?.tables ? options.tables.filter((t) => this.config.tables.has(t)) : Array.from(this.config.tables.keys());
+		const ftsQuery = this.prepareFTSQuery(query, options?.caseSensitive);
+		for (const tableName of tablesToSearch) {
+			const tableConfig = this.config.tables.get(tableName);
+			const schema = this.schemas.get(tableName);
+			if (!tableConfig || !schema) continue;
+			const ftsTableName = `${tableName}_fts`;
+			try {
+				if (!await this.ftsTableExists(ftsTableName)) continue;
+				const highlightColumn = tableConfig.columns[0] ?? "";
+				const highlightIndex = highlightColumn ? tableConfig.columns.indexOf(highlightColumn) : 0;
+				const rows = await execAll(this.db, `
+            SELECT t.*, highlight("${ftsTableName}", ${highlightIndex}, '<mark>', '</mark>') as snippet
+            FROM "${ftsTableName}" fts
+            JOIN "${tableName}" t ON fts.rowid = t.rowid
+            WHERE "${ftsTableName}" MATCH '${ftsQuery}'
+            LIMIT ${Math.ceil(limit / tablesToSearch.length)}
+          `);
+				for (const row of rows) {
+					const { snippet, ...rowData } = row;
+					results.push(buildSearchEntry(tableName, schema, rowData, snippet, buildOptions));
+				}
+			} catch (error) {
+				console.warn(`FTS search failed for table ${tableName}:`, error);
+			}
+			if (results.length >= limit) break;
+		}
+		return {
+			data: results.slice(0, limit),
+			message: results.length === 0 ? `No results found for "${query}"` : void 0
+		};
+	}
+	/**
+	* Searches within a specific table
+	*/
+	async searchTable(tableName, query, options) {
+		return this.search(query, {
+			...options,
+			tables: [tableName]
+		});
+	}
+	/**
+	* Checks if FTS is configured for a table
+	*/
+	hasFTS(tableName) {
+		return this.config.enabled && this.config.tables.has(tableName);
+	}
+	/**
+	* Gets FTS configuration for a table
+	*/
+	getFTSConfig(tableName) {
+		return this.config.tables.get(tableName);
+	}
+	/**
+	* Checks if an FTS table exists
+	*/
+	async ftsTableExists(ftsTableName) {
+		return (await execAll(this.db, `SELECT name FROM sqlite_master WHERE type = 'table' AND name = '${ftsTableName}'`)).length > 0;
+	}
+	/**
+	* Prepares a query string for FTS5
+	* Handles special characters and case sensitivity
+	*/
+	prepareFTSQuery(query, _caseSensitive) {
+		let prepared = query.replace(/"/g, "\"\"").replace(/'/g, "''");
+		if (prepared.includes(" ") && !prepared.startsWith("\"")) prepared = `"${prepared}"`;
+		return prepared;
+	}
+	/**
+	* Updates the schemas map (after refresh)
+	*/
+	setSchemas(schemas) {
+		this.schemas = schemas;
+	}
+	/**
+	* Simple search fallback when FTS is not available
+	* Uses LIKE queries on specified columns
+	*/
+	async simpleLikeSearch(tableName, query, columns, options) {
+		const schema = this.schemas.get(tableName);
+		if (!schema) return {
+			data: [],
+			message: `Table '${tableName}' not found`
+		};
+		const buildOptions = { basePath: this.basePath };
+		const limit = options?.limit ?? 50;
+		const escapedQuery = query.replace(/'/g, "''");
+		const conditions = columns.filter((col) => schema.columns.some((c) => c.name === col)).map((col) => `"${col}" LIKE '%${escapedQuery}%'`).join(" OR ");
+		if (!conditions) return {
+			data: [],
+			message: "No valid columns to search"
+		};
+		return { data: (await execAll(this.db, `SELECT * FROM "${tableName}" WHERE ${conditions} LIMIT ${limit}`)).map((row) => buildSearchEntry(tableName, schema, row, void 0, buildOptions)) };
+	}
+};
+/**
+* Creates FTS configuration from options
+*/
+function createFTSConfig(options) {
+	const config = {
+		enabled: options?.enabled ?? false,
+		tables: /* @__PURE__ */ new Map()
+	};
+	if (options?.tables) for (const [table, columns] of Object.entries(options.tables)) config.tables.set(table, { columns });
+	return config;
+}
+
+//#endregion
+export { FTSSearch, createFTSConfig };
+//# sourceMappingURL=search.mjs.map

package/dist/operations/search.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.mjs","names":[],"sources":["../../src/operations/search.ts"],"sourcesContent":["import type { AFSEntry, AFSSearchOptions, AFSSearchResult } from \"@aigne/afs\";\nimport { sql } from \"@aigne/sqlite\";\nimport type { LibSQLDatabase } from \"drizzle-orm/libsql\";\nimport { type BuildEntryOptions, buildSearchEntry } from \"../node/builder.js\";\nimport type { TableSchema } from \"../schema/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 * FTS5 search configuration for a table\n */\nexport interface FTSTableConfig {\n  /** Columns to include in FTS index */\n  columns: string[];\n  /** Whether FTS table has been created */\n  initialized?: boolean;\n}\n\n/**\n * FTS5 search configuration\n */\nexport interface FTSConfig {\n  /** Whether FTS is enabled */\n  enabled: boolean;\n  /** Per-table FTS configuration */\n  tables: Map<string, FTSTableConfig>;\n}\n\n/**\n * FTS5 Search operations for SQLite AFS\n */\nexport class FTSSearch {\n  constructor(\n    private db: LibSQLDatabase,\n    private schemas: Map<string, TableSchema>,\n    private config: FTSConfig,\n    private basePath: string = \"\",\n  ) {}\n\n  /**\n   * Performs full-text search across configured tables\n   */\n  async search(\n    query: string,\n    options?: AFSSearchOptions & {\n      /** Specific tables to search (defaults to all FTS-enabled tables) */\n      tables?: string[];\n    },\n  ): Promise<AFSSearchResult> {\n    if (!this.config.enabled) {\n      return { data: [], message: \"Full-text search is not enabled\" };\n    }\n\n    const results: AFSEntry[] = [];\n    const limit = options?.limit ?? 50;\n    const buildOptions: BuildEntryOptions = { basePath: this.basePath };\n\n    // Determine which tables to search\n    const tablesToSearch = options?.tables\n      ? options.tables.filter((t) => this.config.tables.has(t))\n      : Array.from(this.config.tables.keys());\n\n    // Escape and prepare the query for FTS5\n    const ftsQuery = this.prepareFTSQuery(query, options?.caseSensitive);\n\n    for (const tableName of tablesToSearch) {\n      const tableConfig = this.config.tables.get(tableName);\n      const schema = this.schemas.get(tableName);\n\n      if (!tableConfig || !schema) continue;\n\n      const ftsTableName = `${tableName}_fts`;\n\n      try {\n        // Check if FTS table exists\n        const ftsExists = await this.ftsTableExists(ftsTableName);\n        if (!ftsExists) continue;\n\n        // Get the first column for highlighting\n        const highlightColumn = tableConfig.columns[0] ?? \"\";\n        const highlightIndex = highlightColumn ? tableConfig.columns.indexOf(highlightColumn) : 0;\n\n        // Build FTS query with highlight\n        const rows = await execAll<Record<string, unknown> & { snippet?: string }>(\n          this.db,\n          `\n            SELECT t.*, highlight(\"${ftsTableName}\", ${highlightIndex}, '<mark>', '</mark>') as snippet\n            FROM \"${ftsTableName}\" fts\n            JOIN \"${tableName}\" t ON fts.rowid = t.rowid\n            WHERE \"${ftsTableName}\" MATCH '${ftsQuery}'\n            LIMIT ${Math.ceil(limit / tablesToSearch.length)}\n          `,\n        );\n\n        for (const row of rows) {\n          const { snippet, ...rowData } = row;\n          results.push(\n            buildSearchEntry(\n              tableName,\n              schema,\n              rowData,\n              snippet as string | undefined,\n              buildOptions,\n            ),\n          );\n        }\n      } catch (error) {\n        // Log but continue with other tables\n        console.warn(`FTS search failed for table ${tableName}:`, error);\n      }\n\n      // Stop if we have enough results\n      if (results.length >= limit) break;\n    }\n\n    return {\n      data: results.slice(0, limit),\n      message: results.length === 0 ? `No results found for \"${query}\"` : undefined,\n    };\n  }\n\n  /**\n   * Searches within a specific table\n   */\n  async searchTable(\n    tableName: string,\n    query: string,\n    options?: AFSSearchOptions,\n  ): Promise<AFSSearchResult> {\n    return this.search(query, { ...options, tables: [tableName] });\n  }\n\n  /**\n   * Checks if FTS is configured for a table\n   */\n  hasFTS(tableName: string): boolean {\n    return this.config.enabled && this.config.tables.has(tableName);\n  }\n\n  /**\n   * Gets FTS configuration for a table\n   */\n  getFTSConfig(tableName: string): FTSTableConfig | undefined {\n    return this.config.tables.get(tableName);\n  }\n\n  /**\n   * Checks if an FTS table exists\n   */\n  private async ftsTableExists(ftsTableName: string): Promise<boolean> {\n    const result = await execAll<{ name: string }>(\n      this.db,\n      `SELECT name FROM sqlite_master WHERE type = 'table' AND name = '${ftsTableName}'`,\n    );\n    return result.length > 0;\n  }\n\n  /**\n   * Prepares a query string for FTS5\n   * Handles special characters and case sensitivity\n   */\n  private prepareFTSQuery(query: string, _caseSensitive?: boolean): string {\n    // Escape special FTS5 characters\n    let prepared = query\n      .replace(/\"/g, '\"\"') // Escape double quotes\n      .replace(/'/g, \"''\"); // Escape single quotes\n\n    // For case-insensitive search (default), we don't need to modify\n    // FTS5 is case-insensitive by default for ASCII\n\n    // If the query contains multiple words, search for the phrase\n    if (prepared.includes(\" \") && !prepared.startsWith('\"')) {\n      prepared = `\"${prepared}\"`;\n    }\n\n    return prepared;\n  }\n\n  /**\n   * Updates the schemas map (after refresh)\n   */\n  setSchemas(schemas: Map<string, TableSchema>): void {\n    this.schemas = schemas;\n  }\n\n  /**\n   * Simple search fallback when FTS is not available\n   * Uses LIKE queries on specified columns\n   */\n  async simpleLikeSearch(\n    tableName: string,\n    query: string,\n    columns: string[],\n    options?: AFSSearchOptions,\n  ): Promise<AFSSearchResult> {\n    const schema = this.schemas.get(tableName);\n    if (!schema) {\n      return { data: [], message: `Table '${tableName}' not found` };\n    }\n\n    const buildOptions: BuildEntryOptions = { basePath: this.basePath };\n    const limit = options?.limit ?? 50;\n    const escapedQuery = query.replace(/'/g, \"''\");\n\n    // Build LIKE conditions for each column\n    const conditions = columns\n      .filter((col) => schema.columns.some((c) => c.name === col))\n      .map((col) => `\"${col}\" LIKE '%${escapedQuery}%'`)\n      .join(\" OR \");\n\n    if (!conditions) {\n      return { data: [], message: \"No valid columns to search\" };\n    }\n\n    const rows = await execAll<Record<string, unknown>>(\n      this.db,\n      `SELECT * FROM \"${tableName}\" WHERE ${conditions} LIMIT ${limit}`,\n    );\n\n    return {\n      data: rows.map((row) => buildSearchEntry(tableName, schema, row, undefined, buildOptions)),\n    };\n  }\n}\n\n/**\n * Creates FTS configuration from options\n */\nexport function createFTSConfig(options?: {\n  enabled?: boolean;\n  tables?: Record<string, string[]>;\n}): FTSConfig {\n  const config: FTSConfig = {\n    enabled: options?.enabled ?? false,\n    tables: new Map(),\n  };\n\n  if (options?.tables) {\n    for (const [table, columns] of Object.entries(options.tables)) {\n      config.tables.set(table, { columns });\n    }\n  }\n\n  return config;\n}\n"],"mappings":"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"}

package/dist/router/path-router.cjs

@@ -0,0 +1,79 @@
+let radix3 = require("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 (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" }
+	} });
+}
+/**
+* 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
+exports.buildPath = buildPath;
+exports.createPathRouter = createPathRouter;
+exports.getVirtualPathType = getVirtualPathType;
+exports.isVirtualPath = isVirtualPath;
+exports.matchPath = matchPath;

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

@@ -0,0 +1,42 @@
+import { RouteData, RouteMatch } from "./types.cjs";
+import { RadixRouter } from "radix3";
+
+//#region src/router/path-router.d.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
+ */
+declare function createPathRouter(): RadixRouter<RouteData>;
+/**
+ * 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
+ */
+declare function matchPath(router: RadixRouter<RouteData>, path: string): RouteMatch | undefined;
+/**
+ * Builds a path from components
+ */
+declare function buildPath(table?: string, pk?: string, suffix?: string): string;
+/**
+ * Checks if a path segment is a virtual path (@attr, @meta, @actions, @schema)
+ */
+declare function isVirtualPath(segment: string): boolean;
+/**
+ * Gets the type of virtual path
+ */
+declare function getVirtualPathType(segment: string): "attr" | "meta" | "actions" | "schema" | null;
+//#endregion
+export { buildPath, createPathRouter, getVirtualPathType, isVirtualPath, matchPath };
+//# sourceMappingURL=path-router.d.cts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,42 @@
+import { RouteData, RouteMatch } from "./types.mjs";
+import { RadixRouter } from "radix3";
+
+//#region src/router/path-router.d.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
+ */
+declare function createPathRouter(): RadixRouter<RouteData>;
+/**
+ * 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
+ */
+declare function matchPath(router: RadixRouter<RouteData>, path: string): RouteMatch | undefined;
+/**
+ * Builds a path from components
+ */
+declare function buildPath(table?: string, pk?: string, suffix?: string): string;
+/**
+ * Checks if a path segment is a virtual path (@attr, @meta, @actions, @schema)
+ */
+declare function isVirtualPath(segment: string): boolean;
+/**
+ * Gets the type of virtual path
+ */
+declare function getVirtualPathType(segment: string): "attr" | "meta" | "actions" | "schema" | null;
+//#endregion
+export { buildPath, createPathRouter, getVirtualPathType, isVirtualPath, matchPath };
+//# sourceMappingURL=path-router.d.mts.map

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

@@ -0,0 +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"}