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

package/dist/operations/query-builder.d.mts

@@ -0,0 +1,34 @@
+import { TableSchema } from "../schema/types.mjs";
+
+//#region src/operations/query-builder.d.ts
+/**
+ * Builds a SELECT query string for a single row by primary key
+ */
+declare function buildSelectByPK(tableName: string, schema: TableSchema, pk: string): string;
+/**
+ * Builds a SELECT query string for listing rows with optional limit and offset
+ */
+declare function buildSelectAll(tableName: string, options?: {
+  limit?: number;
+  offset?: number;
+  orderBy?: [string, "asc" | "desc"][];
+}): string;
+/**
+ * Builds an INSERT query string from content object
+ */
+declare function buildInsert(tableName: string, schema: TableSchema, content: Record<string, unknown>): string;
+/**
+ * Builds an UPDATE query string from content object
+ */
+declare function buildUpdate(tableName: string, schema: TableSchema, pk: string, content: Record<string, unknown>): string;
+/**
+ * Builds a DELETE query string by primary key
+ */
+declare function buildDelete(tableName: string, schema: TableSchema, pk: string): string;
+/**
+ * Gets the last inserted rowid query string
+ */
+declare function buildGetLastRowId(): string;
+//#endregion
+export { buildDelete, buildGetLastRowId, buildInsert, buildSelectAll, buildSelectByPK, buildUpdate };
+//# sourceMappingURL=query-builder.d.mts.map

package/dist/operations/query-builder.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-builder.d.mts","names":[],"sources":["../../src/operations/query-builder.ts"],"mappings":";;;;AAKA;AAQA;iBARgB,eAAA,CAAA,SAAA,UAAA,MAAA,EAA2C,WAAA,EAAA,EAAA;AAAA;AAQ3D;AA6BA;AArC2D,iBAQ3C,cAAA,CAAA,SAAA,UAAA,OAAA;EAAA,KAAA;EAAA,MAAA;EAAA,OAAA;AAAA;AAAA;AA6BhB;AAsBA;AAnDgB,iBA6BA,WAAA,CAAA,SAAA,UAAA,MAAA,EAEN,WAAA,EAAA,OAAA,EACC,MAAA;AAAA;AAmBX;AA0BA;AA7CW,iBAmBK,WAAA,CAAA,SAAA,UAAA,MAAA,EAEN,WAAA,EAAA,EAAA,UAAA,OAAA,EAEC,MAAA;AAAA;AAsBX;AA0CA;AAhEW,iBAsBK,WAAA,CAAA,SAAA,UAAA,MAAA,EAAuC,WAAA,EAAA,EAAA;AAAA;AA0CvD;;AA1CuD,iBA0CvC,iBAAA,CAAA"}

package/dist/operations/query-builder.mjs

@@ -0,0 +1,72 @@
+//#region src/operations/query-builder.ts
+/**
+* Builds a SELECT query string for a single row by primary key
+*/
+function buildSelectByPK(tableName, schema, pk) {
+	return `SELECT * FROM "${tableName}" WHERE "${schema.primaryKey[0] ?? "rowid"}" = '${escapeSQLString(pk)}'`;
+}
+/**
+* Builds a SELECT query string for listing rows with optional limit and offset
+*/
+function buildSelectAll(tableName, options) {
+	let query = `SELECT * FROM "${tableName}"`;
+	if (options?.orderBy?.length) {
+		const orderClauses = options.orderBy.map(([col, dir]) => `"${col}" ${dir.toUpperCase()}`);
+		query += ` ORDER BY ${orderClauses.join(", ")}`;
+	}
+	if (options?.limit !== void 0) query += ` LIMIT ${options.limit}`;
+	if (options?.offset !== void 0) query += ` OFFSET ${options.offset}`;
+	return query;
+}
+/**
+* Builds an INSERT query string from content object
+*/
+function buildInsert(tableName, schema, content) {
+	const validColumns = new Set(schema.columns.map((c) => c.name));
+	const entries = Object.entries(content).filter(([key]) => validColumns.has(key));
+	if (entries.length === 0) throw new Error(`No valid columns provided for INSERT into ${tableName}`);
+	return `INSERT INTO "${tableName}" (${entries.map(([key]) => `"${key}"`).join(", ")}) VALUES (${entries.map(([, value]) => formatValue(value)).join(", ")})`;
+}
+/**
+* Builds an UPDATE query string from content object
+*/
+function buildUpdate(tableName, schema, pk, content) {
+	const pkColumn = schema.primaryKey[0] ?? "rowid";
+	const validColumns = new Set(schema.columns.map((c) => c.name));
+	const entries = Object.entries(content).filter(([key]) => validColumns.has(key) && key !== pkColumn);
+	if (entries.length === 0) throw new Error(`No valid columns provided for UPDATE on ${tableName}`);
+	return `UPDATE "${tableName}" SET ${entries.map(([key, value]) => `"${key}" = ${formatValue(value)}`).join(", ")} WHERE "${pkColumn}" = '${escapeSQLString(pk)}'`;
+}
+/**
+* Builds a DELETE query string by primary key
+*/
+function buildDelete(tableName, schema, pk) {
+	return `DELETE FROM "${tableName}" WHERE "${schema.primaryKey[0] ?? "rowid"}" = '${escapeSQLString(pk)}'`;
+}
+/**
+* Formats a value for SQL insertion
+*/
+function formatValue(value) {
+	if (value === null || value === void 0) return "NULL";
+	if (typeof value === "number") return String(value);
+	if (typeof value === "boolean") return value ? "1" : "0";
+	if (value instanceof Date) return `'${value.toISOString()}'`;
+	if (typeof value === "object") return `'${escapeSQLString(JSON.stringify(value))}'`;
+	return `'${escapeSQLString(String(value))}'`;
+}
+/**
+* Escapes a string for safe SQL insertion
+*/
+function escapeSQLString(str) {
+	return str.replace(/'/g, "''");
+}
+/**
+* Gets the last inserted rowid query string
+*/
+function buildGetLastRowId() {
+	return "SELECT last_insert_rowid() as id";
+}
+
+//#endregion
+export { buildDelete, buildGetLastRowId, buildInsert, buildSelectAll, buildSelectByPK, buildUpdate };
+//# sourceMappingURL=query-builder.mjs.map

package/dist/operations/query-builder.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-builder.mjs","names":[],"sources":["../../src/operations/query-builder.ts"],"sourcesContent":["import type { TableSchema } from \"../schema/types.js\";\n\n/**\n * Builds a SELECT query string for a single row by primary key\n */\nexport function buildSelectByPK(tableName: string, schema: TableSchema, pk: string): string {\n  const pkColumn = schema.primaryKey[0] ?? \"rowid\";\n  return `SELECT * FROM \"${tableName}\" WHERE \"${pkColumn}\" = '${escapeSQLString(pk)}'`;\n}\n\n/**\n * Builds a SELECT query string for listing rows with optional limit and offset\n */\nexport function buildSelectAll(\n  tableName: string,\n  options?: {\n    limit?: number;\n    offset?: number;\n    orderBy?: [string, \"asc\" | \"desc\"][];\n  },\n): string {\n  let query = `SELECT * FROM \"${tableName}\"`;\n\n  if (options?.orderBy?.length) {\n    const orderClauses = options.orderBy.map(([col, dir]) => `\"${col}\" ${dir.toUpperCase()}`);\n    query += ` ORDER BY ${orderClauses.join(\", \")}`;\n  }\n\n  if (options?.limit !== undefined) {\n    query += ` LIMIT ${options.limit}`;\n  }\n\n  if (options?.offset !== undefined) {\n    query += ` OFFSET ${options.offset}`;\n  }\n\n  return query;\n}\n\n/**\n * Builds an INSERT query string from content object\n */\nexport function buildInsert(\n  tableName: string,\n  schema: TableSchema,\n  content: Record<string, unknown>,\n): string {\n  // Filter to only valid columns\n  const validColumns = new Set(schema.columns.map((c) => c.name));\n  const entries = Object.entries(content).filter(([key]) => validColumns.has(key));\n\n  if (entries.length === 0) {\n    throw new Error(`No valid columns provided for INSERT into ${tableName}`);\n  }\n\n  const columns = entries.map(([key]) => `\"${key}\"`).join(\", \");\n  const values = entries.map(([, value]) => formatValue(value)).join(\", \");\n\n  return `INSERT INTO \"${tableName}\" (${columns}) VALUES (${values})`;\n}\n\n/**\n * Builds an UPDATE query string from content object\n */\nexport function buildUpdate(\n  tableName: string,\n  schema: TableSchema,\n  pk: string,\n  content: Record<string, unknown>,\n): string {\n  const pkColumn = schema.primaryKey[0] ?? \"rowid\";\n\n  // Filter to only valid columns, excluding PK\n  const validColumns = new Set(schema.columns.map((c) => c.name));\n  const entries = Object.entries(content).filter(\n    ([key]) => validColumns.has(key) && key !== pkColumn,\n  );\n\n  if (entries.length === 0) {\n    throw new Error(`No valid columns provided for UPDATE on ${tableName}`);\n  }\n\n  const setClauses = entries.map(([key, value]) => `\"${key}\" = ${formatValue(value)}`).join(\", \");\n\n  return `UPDATE \"${tableName}\" SET ${setClauses} WHERE \"${pkColumn}\" = '${escapeSQLString(pk)}'`;\n}\n\n/**\n * Builds a DELETE query string by primary key\n */\nexport function buildDelete(tableName: string, schema: TableSchema, pk: string): string {\n  const pkColumn = schema.primaryKey[0] ?? \"rowid\";\n  return `DELETE FROM \"${tableName}\" WHERE \"${pkColumn}\" = '${escapeSQLString(pk)}'`;\n}\n\n/**\n * Formats a value for SQL insertion\n */\nexport function formatValue(value: unknown): string {\n  if (value === null || value === undefined) {\n    return \"NULL\";\n  }\n\n  if (typeof value === \"number\") {\n    return String(value);\n  }\n\n  if (typeof value === \"boolean\") {\n    return value ? \"1\" : \"0\";\n  }\n\n  if (value instanceof Date) {\n    return `'${value.toISOString()}'`;\n  }\n\n  if (typeof value === \"object\") {\n    return `'${escapeSQLString(JSON.stringify(value))}'`;\n  }\n\n  return `'${escapeSQLString(String(value))}'`;\n}\n\n/**\n * Escapes a string for safe SQL insertion\n */\nexport function escapeSQLString(str: string): string {\n  return str.replace(/'/g, \"''\");\n}\n\n/**\n * Gets the last inserted rowid query string\n */\nexport function buildGetLastRowId(): string {\n  return \"SELECT last_insert_rowid() as id\";\n}\n"],"mappings":";;;;AAKA,SAAgB,gBAAgB,WAAmB,QAAqB,IAAoB;AAE1F,QAAO,kBAAkB,UAAU,WADlB,OAAO,WAAW,MAAM,QACc,OAAO,gBAAgB,GAAG,CAAC;;;;;AAMpF,SAAgB,eACd,WACA,SAKQ;CACR,IAAI,QAAQ,kBAAkB,UAAU;AAExC,KAAI,SAAS,SAAS,QAAQ;EAC5B,MAAM,eAAe,QAAQ,QAAQ,KAAK,CAAC,KAAK,SAAS,IAAI,IAAI,IAAI,IAAI,aAAa,GAAG;AACzF,WAAS,aAAa,aAAa,KAAK,KAAK;;AAG/C,KAAI,SAAS,UAAU,OACrB,UAAS,UAAU,QAAQ;AAG7B,KAAI,SAAS,WAAW,OACtB,UAAS,WAAW,QAAQ;AAG9B,QAAO;;;;;AAMT,SAAgB,YACd,WACA,QACA,SACQ;CAER,MAAM,eAAe,IAAI,IAAI,OAAO,QAAQ,KAAK,MAAM,EAAE,KAAK,CAAC;CAC/D,MAAM,UAAU,OAAO,QAAQ,QAAQ,CAAC,QAAQ,CAAC,SAAS,aAAa,IAAI,IAAI,CAAC;AAEhF,KAAI,QAAQ,WAAW,EACrB,OAAM,IAAI,MAAM,6CAA6C,YAAY;AAM3E,QAAO,gBAAgB,UAAU,KAHjB,QAAQ,KAAK,CAAC,SAAS,IAAI,IAAI,GAAG,CAAC,KAAK,KAAK,CAGf,YAF/B,QAAQ,KAAK,GAAG,WAAW,YAAY,MAAM,CAAC,CAAC,KAAK,KAAK,CAEP;;;;;AAMnE,SAAgB,YACd,WACA,QACA,IACA,SACQ;CACR,MAAM,WAAW,OAAO,WAAW,MAAM;CAGzC,MAAM,eAAe,IAAI,IAAI,OAAO,QAAQ,KAAK,MAAM,EAAE,KAAK,CAAC;CAC/D,MAAM,UAAU,OAAO,QAAQ,QAAQ,CAAC,QACrC,CAAC,SAAS,aAAa,IAAI,IAAI,IAAI,QAAQ,SAC7C;AAED,KAAI,QAAQ,WAAW,EACrB,OAAM,IAAI,MAAM,2CAA2C,YAAY;AAKzE,QAAO,WAAW,UAAU,QAFT,QAAQ,KAAK,CAAC,KAAK,WAAW,IAAI,IAAI,MAAM,YAAY,MAAM,GAAG,CAAC,KAAK,KAAK,CAEhD,UAAU,SAAS,OAAO,gBAAgB,GAAG,CAAC;;;;;AAM/F,SAAgB,YAAY,WAAmB,QAAqB,IAAoB;AAEtF,QAAO,gBAAgB,UAAU,WADhB,OAAO,WAAW,MAAM,QACY,OAAO,gBAAgB,GAAG,CAAC;;;;;AAMlF,SAAgB,YAAY,OAAwB;AAClD,KAAI,UAAU,QAAQ,UAAU,OAC9B,QAAO;AAGT,KAAI,OAAO,UAAU,SACnB,QAAO,OAAO,MAAM;AAGtB,KAAI,OAAO,UAAU,UACnB,QAAO,QAAQ,MAAM;AAGvB,KAAI,iBAAiB,KACnB,QAAO,IAAI,MAAM,aAAa,CAAC;AAGjC,KAAI,OAAO,UAAU,SACnB,QAAO,IAAI,gBAAgB,KAAK,UAAU,MAAM,CAAC,CAAC;AAGpD,QAAO,IAAI,gBAAgB,OAAO,MAAM,CAAC,CAAC;;;;;AAM5C,SAAgB,gBAAgB,KAAqB;AACnD,QAAO,IAAI,QAAQ,MAAM,KAAK;;;;;AAMhC,SAAgB,oBAA4B;AAC1C,QAAO"}

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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"}