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

package/dist/sqlite-afs.d.cts

@@ -0,0 +1,330 @@
+import { TableSchema } from "./schema/types.cjs";
+import { ActionContext } from "./actions/types.cjs";
+import { SQLiteAFSOptions } from "./config.cjs";
+import { LibSQLDatabase } from "drizzle-orm/libsql";
+import { AFSAccessMode, AFSDeleteResult, AFSEntry, AFSExplainResult, AFSListResult, AFSModuleLoadParams, AFSSearchOptions, AFSStatResult, AFSWriteEntryPayload, ProviderManifest } from "@aigne/afs";
+import { z } from "zod";
+import { AFSBaseProvider, RouteContext } from "@aigne/afs/provider";
+
+//#region src/sqlite-afs.d.ts
+/**
+ * SQLite AFS Module
+ *
+ * Exposes SQLite databases as AFS nodes with full CRUD support,
+ * schema introspection, FTS5 search, and virtual paths (.meta, .actions).
+ */
+declare class SQLiteAFS extends AFSBaseProvider {
+  private options;
+  readonly name: string;
+  readonly description?: string;
+  readonly accessMode: AFSAccessMode;
+  private db;
+  private schemaService;
+  private crud;
+  private ftsSearch;
+  private actions;
+  private ftsConfig;
+  private initialized;
+  constructor(options: SQLiteAFSOptions & {
+    localPath?: string;
+    uri?: string;
+  });
+  /**
+   * Returns the Zod schema for configuration validation
+   */
+  static schema(): z.ZodObject<{
+    url: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    accessMode: z.ZodOptional<z.ZodEnum<{
+      readonly: "readonly";
+      readwrite: "readwrite";
+    }>>;
+    tables: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    excludeTables: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    fts: z.ZodOptional<z.ZodObject<{
+      enabled: z.ZodDefault<z.ZodBoolean>;
+      tables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
+    }, z.core.$strip>>;
+    wal: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+  }, z.core.$strip>;
+  static manifest(): ProviderManifest;
+  /**
+   * Loads a module instance from configuration
+   */
+  static load({
+    config
+  }?: AFSModuleLoadParams): Promise<SQLiteAFS>;
+  /**
+   * Initializes the database connection and schema service
+   */
+  private initialize;
+  /**
+   * Ensures the module is initialized.
+   * This is called automatically by handlers, but can also be called
+   * manually to trigger initialization (e.g., in tests).
+   */
+  ensureInitialized(): Promise<void>;
+  /**
+   * List all tables
+   * Note: list() returns only children, never the path itself (per new semantics)
+   */
+  listTablesHandler(_ctx: RouteContext): Promise<AFSListResult>;
+  /**
+   * List rows in a table
+   * Note: list() returns only children (rows), never the table itself (per new semantics)
+   */
+  listTableHandler(ctx: RouteContext<{
+    table: string;
+  }>): Promise<AFSListResult>;
+  /**
+   * List a row - rows are leaf nodes with no children
+   * Note: list() returns only children, never the path itself (per new semantics)
+   */
+  listRowHandler(ctx: RouteContext<{
+    table: string;
+    pk: string;
+  }>): Promise<AFSListResult>;
+  /**
+   * List actions for a row
+   */
+  listActionsHandler(ctx: RouteContext<{
+    table: string;
+    pk: string;
+  }>): Promise<AFSListResult>;
+  /**
+   * List actions for a table (table-level actions)
+   */
+  listTableActionsHandler(ctx: RouteContext<{
+    table: string;
+  }>): Promise<AFSListResult>;
+  /**
+   * List actions at root level (database-level actions)
+   */
+  listRootActionsHandler(_ctx: RouteContext): Promise<AFSListResult>;
+  /**
+   * Read root (database) entry
+   */
+  readRootHandler(_ctx: RouteContext): Promise<AFSEntry | undefined>;
+  /**
+   * Read root metadata (database-level schema information)
+   */
+  readRootMetaHandler(_ctx: RouteContext): Promise<AFSEntry | undefined>;
+  /**
+   * Read capabilities manifest
+   * Returns information about available actions at different levels
+   */
+  readCapabilitiesHandler(_ctx: RouteContext): Promise<AFSEntry | undefined>;
+  /**
+   * Read table (directory) entry
+   */
+  readTableHandler(ctx: RouteContext<{
+    table: string;
+  }>): Promise<AFSEntry | undefined>;
+  /**
+   * Read table metadata (table-level schema information)
+   */
+  readTableMetaHandler(ctx: RouteContext<{
+    table: string;
+  }>): Promise<AFSEntry | undefined>;
+  /**
+   * Read a row
+   */
+  readRowHandler(ctx: RouteContext<{
+    table: string;
+    pk: string;
+  }>): Promise<AFSEntry | undefined>;
+  /**
+   * Get row metadata (@meta suffix - SQLite-specific)
+   */
+  getMetaHandler(ctx: RouteContext<{
+    table: string;
+    pk: string;
+  }>): Promise<AFSEntry | undefined>;
+  /**
+   * Get row metadata (.meta suffix - row-level schema information)
+   */
+  getRowDotMetaHandler(ctx: RouteContext<{
+    table: string;
+    pk: string;
+  }>): Promise<AFSEntry | undefined>;
+  /**
+   * Create a new row
+   */
+  createRowHandler(ctx: RouteContext<{
+    table: string;
+  }>, content: AFSWriteEntryPayload): Promise<{
+    data: AFSEntry;
+  }>;
+  /**
+   * Update an existing row
+   */
+  updateRowHandler(ctx: RouteContext<{
+    table: string;
+    pk: string;
+  }>, content: AFSWriteEntryPayload): Promise<{
+    data: AFSEntry;
+  }>;
+  /**
+   * Execute action via write (for triggering row-level actions)
+   */
+  executeActionWriteHandler(ctx: RouteContext<{
+    table: string;
+    pk: string;
+    action: string;
+  }>, content: AFSWriteEntryPayload): Promise<{
+    data: AFSEntry;
+  }>;
+  /**
+   * Execute action via write (for triggering table-level actions)
+   */
+  executeTableActionWriteHandler(ctx: RouteContext<{
+    table: string;
+    action: string;
+  }>, content: AFSWriteEntryPayload): Promise<{
+    data: AFSEntry;
+  }>;
+  /**
+   * Execute action via write (for triggering root-level actions)
+   */
+  executeRootActionWriteHandler(ctx: RouteContext<{
+    action: string;
+  }>, content: AFSWriteEntryPayload): Promise<{
+    data: AFSEntry;
+  }>;
+  /**
+   * Delete a table entry (not supported - always throws)
+   */
+  deleteTableHandler(ctx: RouteContext<{
+    table: string;
+  }>): Promise<AFSDeleteResult>;
+  /**
+   * Delete a row
+   */
+  deleteRowHandler(ctx: RouteContext<{
+    table: string;
+    pk: string;
+  }>): Promise<AFSDeleteResult>;
+  /**
+   * Search all tables
+   */
+  searchAllHandler(_ctx: RouteContext, query: string, options?: AFSSearchOptions): Promise<{
+    data: AFSEntry[];
+    message?: string;
+  }>;
+  /**
+   * Search a specific table
+   */
+  searchTableHandler(ctx: RouteContext<{
+    table: string;
+  }>, query: string, options?: AFSSearchOptions): Promise<{
+    data: AFSEntry[];
+    message?: string;
+  }>;
+  /**
+   * Get stat for root (database level)
+   */
+  statRootHandler(_ctx: RouteContext): Promise<AFSStatResult>;
+  /**
+   * Get stat for a table
+   */
+  statTableHandler(ctx: RouteContext<{
+    table: string;
+  }>): Promise<AFSStatResult>;
+  /**
+   * Get stat for a row
+   */
+  statRowHandler(ctx: RouteContext<{
+    table: string;
+    pk: string;
+  }>): Promise<AFSStatResult>;
+  /**
+   * Explain root (database level)
+   */
+  explainRootHandler(ctx: RouteContext): Promise<AFSExplainResult>;
+  /**
+   * Explain a table
+   */
+  explainTableHandler(ctx: RouteContext<{
+    table: string;
+  }>): Promise<AFSExplainResult>;
+  /**
+   * Explain a row
+   */
+  explainRowHandler(ctx: RouteContext<{
+    table: string;
+    pk: string;
+  }>): Promise<AFSExplainResult>;
+  /**
+   * Execute action via exec (row-level)
+   */
+  handleRowActionExec(ctx: RouteContext<{
+    table: string;
+    pk: string;
+    action: string;
+  }>, args: Record<string, unknown>): Promise<{
+    success: boolean;
+    data?: Record<string, unknown>;
+  }>;
+  /**
+   * Execute action via exec (table-level)
+   */
+  handleTableActionExec(ctx: RouteContext<{
+    table: string;
+    action: string;
+  }>, args: Record<string, unknown>): Promise<{
+    success: boolean;
+    data?: Record<string, unknown>;
+  }>;
+  /**
+   * Execute action via exec (root-level)
+   */
+  handleRootActionExec(ctx: RouteContext<{
+    action: string;
+  }>, args: Record<string, unknown>): Promise<{
+    success: boolean;
+    data?: Record<string, unknown>;
+  }>;
+  /**
+   * Executes an action and returns raw result (for exec handlers)
+   * Returns AFSExecResult structure: { success: boolean, data?: Record<string, unknown> }
+   */
+  private executeActionRaw;
+  /**
+   * Executes a root-level action and returns raw result (for exec handlers)
+   * Returns AFSExecResult structure: { success: boolean, data?: Record<string, unknown> }
+   */
+  private executeRootActionRaw;
+  /**
+   * Executes an action (for write handlers - wraps in AFSEntry)
+   */
+  private executeAction;
+  /**
+   * Executes a root-level action (for write handlers - wraps in AFSEntry)
+   */
+  private executeRootAction;
+  /**
+   * Exports table data in specified format
+   */
+  exportTable(table: string, format: string): Promise<unknown>;
+  /**
+   * Registers a custom action
+   */
+  registerAction(name: string, handler: (ctx: ActionContext, params: Record<string, unknown>) => Promise<unknown>, options?: {
+    description?: string;
+    tableLevel?: boolean;
+    rowLevel?: boolean;
+  }): void;
+  /**
+   * Gets table schemas (for external access)
+   * Note: This queries the database on-demand
+   */
+  getSchemas(): Promise<Map<string, TableSchema>>;
+  /**
+   * Gets the database instance (for advanced operations)
+   */
+  getDatabase(): LibSQLDatabase;
+}
+//#endregion
+export { SQLiteAFS };
+//# sourceMappingURL=sqlite-afs.d.cts.map

package/dist/sqlite-afs.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-afs.d.cts","names":[],"sources":["../src/sqlite-afs.ts"],"mappings":"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"}

package/dist/sqlite-afs.d.mts

@@ -0,0 +1,330 @@
+import { TableSchema } from "./schema/types.mjs";
+import { ActionContext } from "./actions/types.mjs";
+import { SQLiteAFSOptions } from "./config.mjs";
+import { AFSAccessMode, AFSDeleteResult, AFSEntry, AFSExplainResult, AFSListResult, AFSModuleLoadParams, AFSSearchOptions, AFSStatResult, AFSWriteEntryPayload, ProviderManifest } from "@aigne/afs";
+import { z } from "zod";
+import { AFSBaseProvider, RouteContext } from "@aigne/afs/provider";
+import { LibSQLDatabase } from "drizzle-orm/libsql";
+
+//#region src/sqlite-afs.d.ts
+/**
+ * SQLite AFS Module
+ *
+ * Exposes SQLite databases as AFS nodes with full CRUD support,
+ * schema introspection, FTS5 search, and virtual paths (.meta, .actions).
+ */
+declare class SQLiteAFS extends AFSBaseProvider {
+  private options;
+  readonly name: string;
+  readonly description?: string;
+  readonly accessMode: AFSAccessMode;
+  private db;
+  private schemaService;
+  private crud;
+  private ftsSearch;
+  private actions;
+  private ftsConfig;
+  private initialized;
+  constructor(options: SQLiteAFSOptions & {
+    localPath?: string;
+    uri?: string;
+  });
+  /**
+   * Returns the Zod schema for configuration validation
+   */
+  static schema(): z.ZodObject<{
+    url: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    accessMode: z.ZodOptional<z.ZodEnum<{
+      readonly: "readonly";
+      readwrite: "readwrite";
+    }>>;
+    tables: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    excludeTables: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    fts: z.ZodOptional<z.ZodObject<{
+      enabled: z.ZodDefault<z.ZodBoolean>;
+      tables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
+    }, z.core.$strip>>;
+    wal: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+  }, z.core.$strip>;
+  static manifest(): ProviderManifest;
+  /**
+   * Loads a module instance from configuration
+   */
+  static load({
+    config
+  }?: AFSModuleLoadParams): Promise<SQLiteAFS>;
+  /**
+   * Initializes the database connection and schema service
+   */
+  private initialize;
+  /**
+   * Ensures the module is initialized.
+   * This is called automatically by handlers, but can also be called
+   * manually to trigger initialization (e.g., in tests).
+   */
+  ensureInitialized(): Promise<void>;
+  /**
+   * List all tables
+   * Note: list() returns only children, never the path itself (per new semantics)
+   */
+  listTablesHandler(_ctx: RouteContext): Promise<AFSListResult>;
+  /**
+   * List rows in a table
+   * Note: list() returns only children (rows), never the table itself (per new semantics)
+   */
+  listTableHandler(ctx: RouteContext<{
+    table: string;
+  }>): Promise<AFSListResult>;
+  /**
+   * List a row - rows are leaf nodes with no children
+   * Note: list() returns only children, never the path itself (per new semantics)
+   */
+  listRowHandler(ctx: RouteContext<{
+    table: string;
+    pk: string;
+  }>): Promise<AFSListResult>;
+  /**
+   * List actions for a row
+   */
+  listActionsHandler(ctx: RouteContext<{
+    table: string;
+    pk: string;
+  }>): Promise<AFSListResult>;
+  /**
+   * List actions for a table (table-level actions)
+   */
+  listTableActionsHandler(ctx: RouteContext<{
+    table: string;
+  }>): Promise<AFSListResult>;
+  /**
+   * List actions at root level (database-level actions)
+   */
+  listRootActionsHandler(_ctx: RouteContext): Promise<AFSListResult>;
+  /**
+   * Read root (database) entry
+   */
+  readRootHandler(_ctx: RouteContext): Promise<AFSEntry | undefined>;
+  /**
+   * Read root metadata (database-level schema information)
+   */
+  readRootMetaHandler(_ctx: RouteContext): Promise<AFSEntry | undefined>;
+  /**
+   * Read capabilities manifest
+   * Returns information about available actions at different levels
+   */
+  readCapabilitiesHandler(_ctx: RouteContext): Promise<AFSEntry | undefined>;
+  /**
+   * Read table (directory) entry
+   */
+  readTableHandler(ctx: RouteContext<{
+    table: string;
+  }>): Promise<AFSEntry | undefined>;
+  /**
+   * Read table metadata (table-level schema information)
+   */
+  readTableMetaHandler(ctx: RouteContext<{
+    table: string;
+  }>): Promise<AFSEntry | undefined>;
+  /**
+   * Read a row
+   */
+  readRowHandler(ctx: RouteContext<{
+    table: string;
+    pk: string;
+  }>): Promise<AFSEntry | undefined>;
+  /**
+   * Get row metadata (@meta suffix - SQLite-specific)
+   */
+  getMetaHandler(ctx: RouteContext<{
+    table: string;
+    pk: string;
+  }>): Promise<AFSEntry | undefined>;
+  /**
+   * Get row metadata (.meta suffix - row-level schema information)
+   */
+  getRowDotMetaHandler(ctx: RouteContext<{
+    table: string;
+    pk: string;
+  }>): Promise<AFSEntry | undefined>;
+  /**
+   * Create a new row
+   */
+  createRowHandler(ctx: RouteContext<{
+    table: string;
+  }>, content: AFSWriteEntryPayload): Promise<{
+    data: AFSEntry;
+  }>;
+  /**
+   * Update an existing row
+   */
+  updateRowHandler(ctx: RouteContext<{
+    table: string;
+    pk: string;
+  }>, content: AFSWriteEntryPayload): Promise<{
+    data: AFSEntry;
+  }>;
+  /**
+   * Execute action via write (for triggering row-level actions)
+   */
+  executeActionWriteHandler(ctx: RouteContext<{
+    table: string;
+    pk: string;
+    action: string;
+  }>, content: AFSWriteEntryPayload): Promise<{
+    data: AFSEntry;
+  }>;
+  /**
+   * Execute action via write (for triggering table-level actions)
+   */
+  executeTableActionWriteHandler(ctx: RouteContext<{
+    table: string;
+    action: string;
+  }>, content: AFSWriteEntryPayload): Promise<{
+    data: AFSEntry;
+  }>;
+  /**
+   * Execute action via write (for triggering root-level actions)
+   */
+  executeRootActionWriteHandler(ctx: RouteContext<{
+    action: string;
+  }>, content: AFSWriteEntryPayload): Promise<{
+    data: AFSEntry;
+  }>;
+  /**
+   * Delete a table entry (not supported - always throws)
+   */
+  deleteTableHandler(ctx: RouteContext<{
+    table: string;
+  }>): Promise<AFSDeleteResult>;
+  /**
+   * Delete a row
+   */
+  deleteRowHandler(ctx: RouteContext<{
+    table: string;
+    pk: string;
+  }>): Promise<AFSDeleteResult>;
+  /**
+   * Search all tables
+   */
+  searchAllHandler(_ctx: RouteContext, query: string, options?: AFSSearchOptions): Promise<{
+    data: AFSEntry[];
+    message?: string;
+  }>;
+  /**
+   * Search a specific table
+   */
+  searchTableHandler(ctx: RouteContext<{
+    table: string;
+  }>, query: string, options?: AFSSearchOptions): Promise<{
+    data: AFSEntry[];
+    message?: string;
+  }>;
+  /**
+   * Get stat for root (database level)
+   */
+  statRootHandler(_ctx: RouteContext): Promise<AFSStatResult>;
+  /**
+   * Get stat for a table
+   */
+  statTableHandler(ctx: RouteContext<{
+    table: string;
+  }>): Promise<AFSStatResult>;
+  /**
+   * Get stat for a row
+   */
+  statRowHandler(ctx: RouteContext<{
+    table: string;
+    pk: string;
+  }>): Promise<AFSStatResult>;
+  /**
+   * Explain root (database level)
+   */
+  explainRootHandler(ctx: RouteContext): Promise<AFSExplainResult>;
+  /**
+   * Explain a table
+   */
+  explainTableHandler(ctx: RouteContext<{
+    table: string;
+  }>): Promise<AFSExplainResult>;
+  /**
+   * Explain a row
+   */
+  explainRowHandler(ctx: RouteContext<{
+    table: string;
+    pk: string;
+  }>): Promise<AFSExplainResult>;
+  /**
+   * Execute action via exec (row-level)
+   */
+  handleRowActionExec(ctx: RouteContext<{
+    table: string;
+    pk: string;
+    action: string;
+  }>, args: Record<string, unknown>): Promise<{
+    success: boolean;
+    data?: Record<string, unknown>;
+  }>;
+  /**
+   * Execute action via exec (table-level)
+   */
+  handleTableActionExec(ctx: RouteContext<{
+    table: string;
+    action: string;
+  }>, args: Record<string, unknown>): Promise<{
+    success: boolean;
+    data?: Record<string, unknown>;
+  }>;
+  /**
+   * Execute action via exec (root-level)
+   */
+  handleRootActionExec(ctx: RouteContext<{
+    action: string;
+  }>, args: Record<string, unknown>): Promise<{
+    success: boolean;
+    data?: Record<string, unknown>;
+  }>;
+  /**
+   * Executes an action and returns raw result (for exec handlers)
+   * Returns AFSExecResult structure: { success: boolean, data?: Record<string, unknown> }
+   */
+  private executeActionRaw;
+  /**
+   * Executes a root-level action and returns raw result (for exec handlers)
+   * Returns AFSExecResult structure: { success: boolean, data?: Record<string, unknown> }
+   */
+  private executeRootActionRaw;
+  /**
+   * Executes an action (for write handlers - wraps in AFSEntry)
+   */
+  private executeAction;
+  /**
+   * Executes a root-level action (for write handlers - wraps in AFSEntry)
+   */
+  private executeRootAction;
+  /**
+   * Exports table data in specified format
+   */
+  exportTable(table: string, format: string): Promise<unknown>;
+  /**
+   * Registers a custom action
+   */
+  registerAction(name: string, handler: (ctx: ActionContext, params: Record<string, unknown>) => Promise<unknown>, options?: {
+    description?: string;
+    tableLevel?: boolean;
+    rowLevel?: boolean;
+  }): void;
+  /**
+   * Gets table schemas (for external access)
+   * Note: This queries the database on-demand
+   */
+  getSchemas(): Promise<Map<string, TableSchema>>;
+  /**
+   * Gets the database instance (for advanced operations)
+   */
+  getDatabase(): LibSQLDatabase;
+}
+//#endregion
+export { SQLiteAFS };
+//# sourceMappingURL=sqlite-afs.d.mts.map

package/dist/sqlite-afs.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-afs.d.mts","names":[],"sources":["../src/sqlite-afs.ts"],"mappings":"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"}