@pineliner/odb-client 1.0.0 → 1.0.2

package/dist/database/adapters/bun-sqlite.d.ts

@@ -0,0 +1,14 @@
+import type { DatabaseAdapter, Connection, BunSQLiteConfig } from '../types';
+/**
+ * Bun SQLite adapter for DatabaseManager
+ * Wraps bun:sqlite with Connection interface
+ */
+export declare class BunSQLiteAdapter implements DatabaseAdapter {
+    readonly type: "bun-sqlite";
+    private config;
+    constructor(config: BunSQLiteConfig);
+    connect(config: BunSQLiteConfig): Promise<Connection>;
+    disconnect(tenantId?: string): Promise<void>;
+    isHealthy(): Promise<boolean>;
+}
+//# sourceMappingURL=bun-sqlite.d.ts.map

package/dist/database/adapters/bun-sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bun-sqlite.d.ts","sourceRoot":"","sources":["../../../src/database/adapters/bun-sqlite.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EAGV,eAAe,EAChB,MAAM,UAAU,CAAA;AAEjB;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,eAAe;IACtD,QAAQ,CAAC,IAAI,EAAG,YAAY,CAAS;IACrC,OAAO,CAAC,MAAM,CAAiB;gBAEnB,MAAM,EAAE,eAAe;IAI7B,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC;IASrD,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK5C,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;CAapC"}

package/dist/database/adapters/libsql.d.ts

@@ -0,0 +1,14 @@
+import type { DatabaseAdapter, Connection, LibSQLConfig } from '../types';
+/**
+ * LibSQL adapter for DatabaseManager
+ * Wraps @libsql/client with Connection interface
+ */
+export declare class LibSQLAdapter implements DatabaseAdapter {
+    readonly type: "libsql";
+    private config;
+    constructor(config: LibSQLConfig);
+    connect(config: LibSQLConfig): Promise<Connection>;
+    disconnect(tenantId?: string): Promise<void>;
+    isHealthy(): Promise<boolean>;
+}
+//# sourceMappingURL=libsql.d.ts.map

package/dist/database/adapters/libsql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"libsql.d.ts","sourceRoot":"","sources":["../../../src/database/adapters/libsql.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EAGV,YAAY,EACb,MAAM,UAAU,CAAA;AAEjB;;;GAGG;AACH,qBAAa,aAAc,YAAW,eAAe;IACnD,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAS;IACjC,OAAO,CAAC,MAAM,CAAc;gBAEhB,MAAM,EAAE,YAAY;IAI1B,OAAO,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC;IAUlD,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK5C,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;CAYpC"}

package/dist/database/adapters/odblite.d.ts

@@ -0,0 +1,15 @@
+import type { DatabaseAdapter, Connection, ODBLiteConfig } from '../types';
+/**
+ * ODB-Lite adapter for DatabaseManager
+ * Wraps ServiceClient and ODBLiteClient with Connection interface
+ */
+export declare class ODBLiteAdapter implements DatabaseAdapter {
+    readonly type: "odblite";
+    private config;
+    private serviceClient;
+    constructor(config: ODBLiteConfig);
+    connect(config: any): Promise<Connection>;
+    disconnect(tenantId?: string): Promise<void>;
+    isHealthy(): Promise<boolean>;
+}
+//# sourceMappingURL=odblite.d.ts.map

package/dist/database/adapters/odblite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"odblite.d.ts","sourceRoot":"","sources":["../../../src/database/adapters/odblite.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EAGV,aAAa,EACd,MAAM,UAAU,CAAA;AAEjB;;;GAGG;AACH,qBAAa,cAAe,YAAW,eAAe;IACpD,QAAQ,CAAC,IAAI,EAAG,SAAS,CAAS;IAClC,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,aAAa,CAAe;gBAExB,MAAM,EAAE,aAAa;IAQ3B,OAAO,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC;IA2BzC,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa5C,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;CAQpC"}

package/dist/database/index.d.ts

@@ -0,0 +1,8 @@
+export { DatabaseManager } from './manager';
+export { parseSQL, splitSQLStatements } from './sql-parser';
+export type { ParsedStatements, SQLParserOptions } from './sql-parser';
+export { BunSQLiteAdapter } from './adapters/bun-sqlite';
+export { LibSQLAdapter } from './adapters/libsql';
+export { ODBLiteAdapter } from './adapters/odblite';
+export type { TenancyMode, BackendType, QueryResult, Connection, DatabaseAdapter, PreparedStatement, DatabaseManagerConfig, MigrationConfig, BunSQLiteConfig, LibSQLConfig, ODBLiteConfig, TenantInfo, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/database/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/database/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAG3C,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAC3D,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAGtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAGnD,YAAY,EAEV,WAAW,EACX,WAAW,EACX,WAAW,EACX,UAAU,EACV,eAAe,EACf,iBAAiB,EAGjB,qBAAqB,EACrB,eAAe,EACf,eAAe,EACf,YAAY,EACZ,aAAa,EAGb,UAAU,GACX,MAAM,SAAS,CAAA"}

package/dist/database/manager.d.ts

@@ -0,0 +1,92 @@
+import type { DatabaseManagerConfig, Connection } from './types';
+/**
+ * Database factory for creating and managing multiple databases
+ *
+ * Features:
+ * - Creates multiple databases from single manager instance
+ * - Supports libsql, bun:sqlite, and ODB-Lite backends
+ * - Connection pooling with LRU eviction
+ * - Automatic schema migrations
+ *
+ * @example
+ * ```ts
+ * const dbManager = new DatabaseManager({
+ *   backend: 'libsql',
+ *   databasePath: './data'
+ * })
+ *
+ * // Create databases
+ * await dbManager.createDatabase('identity', { schemaContent })
+ * await dbManager.createDatabase('analytics', { schemaContent })
+ *
+ * // Get connections
+ * const identityDB = await dbManager.getConnection('identity')
+ * const analyticsDB = await dbManager.getConnection('analytics')
+ * ```
+ */
+export declare class DatabaseManager {
+    private config;
+    private adapter;
+    private connections;
+    private connectionTimestamps;
+    private maxConnections;
+    constructor(config: DatabaseManagerConfig);
+    /**
+     * Create a new database
+     * @param name - Database name (becomes filename or ODB-Lite database name)
+     * @param options - Optional creation options
+     */
+    createDatabase(name: string, options?: {
+        schemaContent?: string;
+    }): Promise<void>;
+    /**
+     * Check if a database exists
+     * @param name - Database name
+     * @returns true if database exists, false otherwise
+     *
+     * Note: For local backends (libsql, bun-sqlite), checks file existence.
+     * For ODB-Lite, checks if database is in connection cache.
+     */
+    databaseExists(name: string): Promise<boolean>;
+    /**
+     * Get connection to a database
+     * @param name - Database name
+     *
+     * If database exists on disk but not in cache, it will be connected automatically.
+     * If database doesn't exist at all, an error will be thrown.
+     */
+    getConnection(name: string): Promise<Connection>;
+    /**
+     * Delete a database
+     * @param name - Database name
+     */
+    deleteDatabase(name: string): Promise<void>;
+    /**
+     * Execute SQL content on a database connection
+     * Useful for running migrations or initial schema
+     * @param name - Database name
+     * @param sqlContent - SQL content to execute
+     */
+    executeSQLFile(name: string, sqlContent: string): Promise<void>;
+    /**
+     * List all managed databases
+     */
+    listDatabases(): Promise<string[]>;
+    /**
+     * Close all connections
+     */
+    close(): Promise<void>;
+    /**
+     * Run migrations on a connection
+     */
+    private runMigrations;
+    /**
+     * Get database-specific configuration
+     */
+    private getDatabaseConfig;
+    /**
+     * Evict least recently used connection
+     */
+    private evictLRU;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/database/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/database/manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EAErB,UAAU,EAIX,MAAM,SAAS,CAAA;AAOhB;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,WAAW,CAAqC;IAGxD,OAAO,CAAC,oBAAoB,CAAiC;IAC7D,OAAO,CAAC,cAAc,CAAQ;gBAElB,MAAM,EAAE,qBAAqB;IA6BzC;;;;OAIG;IACG,cAAc,CAClB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GACnC,OAAO,CAAC,IAAI,CAAC;IA0BhB;;;;;;;OAOG;IACG,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA6BpD;;;;;;OAMG;IACG,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAkCtD;;;OAGG;IACG,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBjD;;;;;OAKG;IACG,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKrE;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAIxC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAa5B;;OAEG;YACW,aAAa;IAoC3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAyBzB;;OAEG;YACW,QAAQ;CAqBvB"}

package/dist/database/sql-parser.d.ts

@@ -0,0 +1,17 @@
+export interface ParsedStatements {
+    pragmaStatements: string[];
+    regularStatements: string[];
+}
+export interface SQLParserOptions {
+    separatePragma?: boolean;
+}
+/**
+ * Parse SQL file into statements, separating PRAGMA from regular SQL
+ * Handles comments, quotes, and semicolons properly
+ */
+export declare function parseSQL(sqlContent: string, options?: SQLParserOptions): ParsedStatements;
+/**
+ * Simple split for systems that don't need PRAGMA separation
+ */
+export declare function splitSQLStatements(sqlContent: string): string[];
+//# sourceMappingURL=sql-parser.d.ts.map

package/dist/database/sql-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-parser.d.ts","sourceRoot":"","sources":["../../src/database/sql-parser.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,iBAAiB,EAAE,MAAM,EAAE,CAAA;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,gBAAgB,CA0B7F;AAkED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAG/D"}

package/dist/database/types.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Tenancy modes supported by DatabaseManager
+ */
+export type TenancyMode = 'single-db' | 'multi-tenant' | 'metastore' | 'dual-mode';
+/**
+ * Backend database types
+ */
+export type BackendType = 'bun-sqlite' | 'libsql' | 'odblite';
+/**
+ * Query result from any backend
+ */
+export interface QueryResult<T = any> {
+    rows: T[];
+    rowsAffected?: number;
+    lastInsertRowid?: number | bigint;
+}
+/**
+ * Unified database connection interface
+ * All backends implement this through adapters
+ */
+export interface Connection {
+    query<T = any>(strings: TemplateStringsArray, ...values: any[]): Promise<QueryResult<T>>;
+    execute(sql: string | {
+        sql: string;
+        args?: any[];
+    }, params?: any[]): Promise<QueryResult>;
+    prepare(sql: string): PreparedStatement;
+    transaction<T>(fn: (tx: Connection) => Promise<T>): Promise<T>;
+    close(): Promise<void>;
+}
+/**
+ * Prepared statement interface
+ */
+export interface PreparedStatement {
+    execute(params?: any[]): Promise<QueryResult>;
+    all(params?: any[]): Promise<any[]>;
+    get(params?: any[]): Promise<any | null>;
+}
+/**
+ * Database backend adapter interface
+ */
+export interface DatabaseAdapter {
+    readonly type: BackendType;
+    connect(config: any): Promise<Connection>;
+    disconnect(tenantId?: string): Promise<void>;
+    isHealthy(): Promise<boolean>;
+}
+/**
+ * Migration configuration
+ */
+export interface MigrationConfig {
+    schemaContent: string;
+}
+/**
+ * DatabaseManager configuration
+ * Simplified: Manager defines WHERE databases go, createDatabase defines WHAT
+ */
+export interface DatabaseManagerConfig {
+    backend: BackendType;
+    databasePath: string;
+    libsql?: {
+        encryptionKey?: string;
+        authToken?: string;
+    };
+    odblite?: {
+        serviceUrl: string;
+        apiKey: string;
+        nodeId?: string;
+    };
+    connectionPoolSize?: number;
+}
+/**
+ * Bun SQLite adapter config
+ */
+export interface BunSQLiteConfig {
+    databasePath: string;
+    readonly?: boolean;
+    create?: boolean;
+}
+/**
+ * LibSQL adapter config
+ */
+export interface LibSQLConfig {
+    url: string;
+    authToken?: string;
+    encryptionKey?: string;
+}
+/**
+ * ODB-Lite adapter config
+ */
+export interface ODBLiteConfig {
+    serviceUrl: string;
+    apiKey: string;
+    nodeId?: string;
+}
+/**
+ * Tenant database info
+ */
+export interface TenantInfo {
+    tenantId: string;
+    databaseHash?: string;
+    databasePath?: string;
+    createdAt: Date;
+    metadata?: Record<string, any>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/database/types.d.ts.map

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