db4ai 0.3.0 → 0.3.1

package/dist/cli/runtime/index.d.ts

@@ -1,3 +1,5 @@
+import Database from 'better-sqlite3';
+
 /**
  * Module 14: Local Runtime
  *
@@ -5,8 +7,8 @@
  * Provides the same interface as the Cloudflare Durable Object for
  * seamless local development and testing.
  */
-import Database from 'better-sqlite3';
-export interface Thing {
+
+interface Thing {
     rowid: number;
     type: string;
     id: string;
@@ -15,28 +17,28 @@ export interface Thing {
     created_at: number;
     created_by_action?: number;
 }
-export interface UpsertResult {
+interface UpsertResult {
     rowid: number;
     created: boolean;
 }
-export interface UpsertParams {
+interface UpsertParams {
     type: string;
     id: string;
     data: Record<string, unknown>;
     created_by_action?: number;
 }
-export interface GetParams {
+interface GetParams {
     type: string;
     id: string;
 }
-export interface ListParams {
+interface ListParams {
     type?: string;
     limit?: number;
     offset?: number;
     where?: Record<string, unknown>;
     order?: 'asc' | 'desc';
 }
-export interface Relationship {
+interface Relationship {
     rowid: number;
     from_rowid: number;
     to_rowid: number;
@@ -46,7 +48,7 @@ export interface Relationship {
     created_at: number;
     created_by_action?: number;
 }
-export interface CreateRelationshipParams {
+interface CreateRelationshipParams {
     from_rowid: number;
     to_rowid: number;
     type: string;
@@ -54,24 +56,24 @@ export interface CreateRelationshipParams {
     label: string;
     created_by_action?: number;
 }
-export interface TraverseParams {
+interface TraverseParams {
     from_rowid: number;
     type?: string;
 }
-export interface IncomingParams {
+interface IncomingParams {
     to_rowid: number;
     type?: string;
 }
-export interface TraverseMultiHopParams {
+interface TraverseMultiHopParams {
     from_rowid: number;
     depth: number;
     type?: string;
 }
-export interface TraverseMultiHopResult {
+interface TraverseMultiHopResult {
     to_rowid: number;
     depth: number;
 }
-export interface Action {
+interface Action {
     rowid: number;
     type: 'mutation' | 'generation' | 'resolution' | 'function' | 'evaluate';
     input_hash: string;
@@ -84,22 +86,22 @@ export interface Action {
     cost_tokens?: number;
     created_at: number;
 }
-export interface CreateActionParams {
+interface CreateActionParams {
     type: 'mutation' | 'generation' | 'resolution' | 'function' | 'evaluate';
     input: Record<string, unknown>;
     model?: string;
 }
-export interface CompleteActionParams {
+interface CompleteActionParams {
     rowid: number;
     output: Record<string, unknown>;
     duration_ms?: number;
     cost_tokens?: number;
 }
-export interface FailActionParams {
+interface FailActionParams {
     rowid: number;
     error: string;
 }
-export interface DBEvent {
+interface DBEvent {
     rowid: number;
     type: string;
     action: 'created' | 'updated' | 'deleted' | 'generated';
@@ -112,7 +114,7 @@ export interface DBEvent {
     action_id?: number;
     correlation_id?: string;
 }
-export interface EmitEventParams {
+interface EmitEventParams {
     type: string;
     action: 'created' | 'updated' | 'deleted' | 'generated';
     entity_type: string;
@@ -123,23 +125,50 @@ export interface EmitEventParams {
     action_id?: number;
     correlation_id?: string;
 }
-export interface ListEventsParams {
+interface ListEventsParams {
     type?: string;
     action?: 'created' | 'updated' | 'deleted' | 'generated';
     since?: number;
     correlation_id?: string;
     limit?: number;
 }
-export declare class LocalDB {
+/**
+ * Connection pool for reusing database instances.
+ * SQLite with better-sqlite3 uses file-level locking, so we maintain
+ * a singleton instance per database path to avoid resource contention.
+ */
+declare class ConnectionPool {
+    private static instances;
+    /**
+     * Acquire a database connection. Creates a new one or returns existing.
+     */
+    static acquire(dbPath: string): Database.Database;
+    /**
+     * Release a database connection. Closes when ref count reaches 0.
+     */
+    static release(dbPath: string): void;
+    /**
+     * Force close all connections (for testing cleanup).
+     */
+    static closeAll(): void;
+}
+declare class LocalDB {
     private db;
+    private usePool;
     readonly path: string;
     readonly version: number;
     readonly things: ThingsAPI;
     readonly relationships: RelationshipsAPI;
     readonly actions: ActionsAPI;
     readonly events: EventsAPI;
-    constructor(dbPath?: string);
+    constructor(dbPath?: string, options?: {
+        usePool?: boolean;
+    });
     private initSchema;
+    /**
+     * Run any pending database migrations.
+     */
+    private runMigrations;
     /**
      * Closes the database connection.
      */
@@ -232,5 +261,5 @@ declare class EventsAPI {
      */
     list(params?: ListEventsParams): Promise<DBEvent[]>;
 }
-export default LocalDB;
-//# sourceMappingURL=index.d.ts.map
+
+export { type Action, type CompleteActionParams, ConnectionPool, type CreateActionParams, type CreateRelationshipParams, type DBEvent, type EmitEventParams, type FailActionParams, type GetParams, type IncomingParams, type ListEventsParams, type ListParams, LocalDB, type Relationship, type Thing, type TraverseMultiHopParams, type TraverseMultiHopResult, type TraverseParams, type UpsertParams, type UpsertResult, LocalDB as default };