@pineliner/odb-client 1.0.0

package/dist/service/service-client.d.ts

@@ -0,0 +1,151 @@
+/**
+ * Service Client - High-level client for managing tenant databases via ODB-Lite Tenant API
+ *
+ * This client provides automatic database provisioning and management for multi-tenant applications.
+ * It handles:
+ * - Automatic database creation on first use
+ * - Database hash caching for performance
+ * - Tenant API integration with ODB-Lite
+ * - Query execution via ODB-Lite's query API
+ *
+ * @example
+ * ```typescript
+ * const service = new ServiceClient({
+ *   baseUrl: 'http://localhost:8671',
+ *   apiKey: 'odblite_tenant_key'
+ * });
+ *
+ * // Automatically creates database if it doesn't exist
+ * const dbHash = await service.ensureDatabaseForTenant('wallet', 'tenant-123');
+ *
+ * // Execute queries
+ * const result = await service.query(dbHash, 'SELECT * FROM wallets', []);
+ * ```
+ */
+export interface ODBLiteDatabase {
+    hash: string;
+    name: string;
+    tenantId: string;
+    nodeId: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ODBLiteNode {
+    nodeId: string;
+    url: string;
+    status: string;
+    lastHealthCheck: string;
+}
+export interface ServiceClientConfig {
+    /** Base URL of ODB-Lite server (e.g., http://localhost:8671) */
+    baseUrl: string;
+    /** Tenant API key for authentication */
+    apiKey: string;
+}
+/**
+ * Service Client for managing tenant databases in ODB-Lite
+ *
+ * This is a higher-level client that sits on top of the base ODB client.
+ * It provides automatic database provisioning and management for services
+ * that need per-tenant database isolation.
+ */
+export declare class ServiceClient {
+    private apiUrl;
+    private apiKey;
+    private databaseCache;
+    constructor(config: ServiceClientConfig);
+    /**
+     * Get or create a database for a tenant
+     *
+     * This is the main method used by services. It will:
+     * 1. Check the cache for an existing database hash
+     * 2. Query ODB-Lite to see if the database exists
+     * 3. Create the database if it doesn't exist
+     * 4. Cache and return the database hash
+     *
+     * @param prefix - Database name prefix (e.g., 'wallet', 'tracking')
+     * @param tenantId - Tenant identifier
+     * @returns Database hash for querying
+     *
+     * @example
+     * ```typescript
+     * const hash = await service.ensureDatabaseForTenant('wallet', 'tenant-123');
+     * // Returns hash for database named 'wallet_tenant-123'
+     * ```
+     */
+    ensureDatabaseForTenant(prefix: string, tenantId: string): Promise<string>;
+    /**
+     * List all databases owned by this tenant
+     *
+     * Queries ODB-Lite's tenant API to get all databases accessible with the current API key.
+     *
+     * @returns Array of database objects
+     */
+    listDatabases(): Promise<ODBLiteDatabase[]>;
+    /**
+     * Create a new database
+     *
+     * @param name - Database name (should be unique)
+     * @param nodeId - ID of the node to host the database
+     * @returns Created database object with hash
+     */
+    createDatabase(name: string, nodeId: string): Promise<ODBLiteDatabase>;
+    /**
+     * Get database details by hash
+     *
+     * @param hash - Database hash
+     * @returns Database object
+     */
+    getDatabase(hash: string): Promise<ODBLiteDatabase>;
+    /**
+     * Delete a database
+     *
+     * @param hash - Database hash to delete
+     */
+    deleteDatabase(hash: string): Promise<void>;
+    /**
+     * List available nodes
+     *
+     * @returns Array of node objects
+     */
+    listNodes(): Promise<ODBLiteNode[]>;
+    /**
+     * Execute a query on a specific database
+     *
+     * This is a low-level query method. For most use cases, you should use
+     * the full ODB client (`odblite()` function) instead, which provides
+     * template tag support and better ergonomics.
+     *
+     * @param databaseHash - Hash of the database to query
+     * @param sql - SQL query string
+     * @param params - Query parameters
+     * @returns Query result
+     */
+    query<T = any>(databaseHash: string, sql: string, params?: any[]): Promise<T>;
+    /**
+     * Clear the database hash cache
+     *
+     * Useful when database mappings have changed or for testing.
+     */
+    clearCache(): void;
+    /**
+     * Get cached database hash for a specific tenant (if exists)
+     *
+     * @param prefix - Database name prefix
+     * @param tenantId - Tenant identifier
+     * @returns Cached hash or undefined
+     */
+    getCachedHash(prefix: string, tenantId: string): string | undefined;
+    /**
+     * Pre-cache a database hash
+     *
+     * Useful when you know the mapping ahead of time and want to avoid
+     * the initial lookup.
+     *
+     * @param prefix - Database name prefix
+     * @param tenantId - Tenant identifier
+     * @param hash - Database hash
+     */
+    setCachedHash(prefix: string, tenantId: string, hash: string): void;
+}
+//# sourceMappingURL=service-client.d.ts.map

package/dist/service/service-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-client.d.ts","sourceRoot":"","sources":["../../src/service/service-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,aAAa,CAAsB;gBAE/B,MAAM,EAAE,mBAAmB;IAMvC;;;;;;;;;;;;;;;;;;OAkBG;IACG,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAkDhF;;;;;;OAMG;IACG,aAAa,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAejD;;;;;;OAMG;IACG,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAkB5E;;;;;OAKG;IACG,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAezD;;;;OAIG;IACG,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBjD;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAezC;;;;;;;;;;;OAWG;IACG,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,GAAG,EAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAkBvF;;;;OAIG;IACH,UAAU,IAAI,IAAI;IAIlB;;;;;;OAMG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAKnE;;;;;;;;;OASG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;CAIpE"}

package/dist/types.d.ts

@@ -0,0 +1,75 @@
+export interface ODBLiteConfig {
+    baseUrl: string;
+    apiKey: string;
+    databaseId?: string;
+    timeout?: number;
+    retries?: number;
+}
+export interface QueryResult<T = any> {
+    rows: T[];
+    rowsAffected: number;
+    executionTime: number;
+    databaseName?: string;
+}
+export interface ODBLiteResponse<T = any> {
+    success: boolean;
+    data?: T[];
+    rows?: T[];
+    rowsAffected?: number;
+    executionTime?: number;
+    dbId?: string;
+    databaseName?: string;
+    error?: string;
+}
+export interface SQLFragment {
+    text: string;
+    values: any[];
+}
+export interface PreparedQuery {
+    sql: string;
+    params: any[];
+}
+export interface Transaction {
+    <T = any>(sql: TemplateStringsArray, ...values: any[]): Promise<QueryResult<T>>;
+    <T = any>(input: any): SQLFragment;
+    raw(text: string): string;
+    identifier(name: string): string;
+    query<T = any>(sql: string, params?: any[]): Promise<QueryResult<T>>;
+    execute<T = any>(sql: string | {
+        sql: string;
+        args?: any[];
+    }, args?: any[]): Promise<QueryResult<T>>;
+    savepoint<T = any>(callback: (sql: Transaction) => Promise<T>): Promise<T>;
+    rollback(): Promise<void>;
+    commit(): Promise<void>;
+}
+export type TransactionCallback<T = any> = (sql: Transaction) => Promise<T> | T | Promise<T[]> | T[];
+export type TransactionMode = 'read write' | 'read only' | string;
+export interface ODBLiteConnection {
+    sql<T = any>(sql: TemplateStringsArray, ...values: any[]): Promise<QueryResult<T>>;
+    query<T = any>(sql: string, params?: any[]): Promise<QueryResult<T>>;
+    begin(): Promise<Transaction>;
+    ping(): Promise<boolean>;
+    end(): Promise<void>;
+    config: ODBLiteConfig;
+}
+export type PrimitiveType = string | number | boolean | null | Date | Buffer;
+export type QueryParameter = PrimitiveType | PrimitiveType[];
+export interface Row {
+    [column: string]: any;
+}
+export declare class ODBLiteError extends Error {
+    code?: string | undefined;
+    query?: string | undefined;
+    params?: any[] | undefined;
+    constructor(message: string, code?: string | undefined, query?: string | undefined, params?: any[] | undefined);
+}
+export declare class ConnectionError extends ODBLiteError {
+    originalError?: Error | undefined;
+    constructor(message: string, originalError?: Error | undefined);
+}
+export declare class QueryError extends ODBLiteError {
+    originalError?: Error | undefined;
+    constructor(message: string, query?: string, params?: any[], originalError?: Error | undefined);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@pineliner/odb-client",
+  "version": "1.0.0",
+  "description": "Isomorphic client for ODB-Lite with postgres.js-like template string SQL support",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "type": "module",
+  "scripts": {
+    "dev": "rslib build --watch",
+    "build": "rslib build",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit",
+    "deploy": "bun run build && npm publish --access public"
+  },
+  "dependencies": {
+    "@libsql/client": "^0.15.15"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@rslib/core": "^0.0.14",
+    "typescript": "^5.9.2"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist/**/*",
+    "src/**/*"
+  ],
+  "keywords": [
+    "libsql",
+    "sqlite",
+    "sql",
+    "database",
+    "client",
+    "template-strings",
+    "postgres-like"
+  ]
+}

package/src/core/client.ts

@@ -0,0 +1,277 @@
+import type { ODBLiteConfig, ODBLiteConnection, QueryResult, Transaction, TransactionCallback, TransactionMode, SQLFragment } from '../types.ts';
+import { HTTPClient } from './http-client.ts';
+import { SQLParser } from './sql-parser.ts';
+import { createSimpleTransaction, SimpleTransaction } from './transaction.ts';
+import { ConnectionError } from '../types.ts';
+
+// Define the callable SQL function type
+interface SQLFunction {
+  // Primary call signatures - context-aware like postgres.js
+  <T = any>(sql: TemplateStringsArray, ...values: any[]): Promise<QueryResult<T>>;
+  <T = any>(input: any): SQLFragment; // For sql(object), sql(array), etc.
+
+  // Keep minimal utility methods for edge cases
+  raw(text: string): string;
+  identifier(name: string): string;
+
+  // Additional postgres.js-like methods
+  query<T = any>(sql: string, params?: any[]): Promise<QueryResult<T>>;
+
+  // libsql-compatible execute method (for backward compatibility)
+  execute<T = any>(sql: string | { sql: string; args?: any[] }, args?: any[]): Promise<QueryResult<T>>;
+
+  // Transaction support - multiple overloads like postgres.js
+  begin(): Promise<Transaction>;
+  begin<T>(callback: TransactionCallback<T>): Promise<T>;
+  begin<T>(mode: TransactionMode, callback: TransactionCallback<T>): Promise<T>;
+
+  ping(): Promise<boolean>;
+  end(): Promise<void>;
+  setDatabase(databaseId: string): SQLFunction;
+  getDatabaseInfo(): Promise<any>;
+  configure(updates: Partial<ODBLiteConfig>): SQLFunction;
+}
+
+/**
+ * Main ODBLite client that provides postgres.js-like interface
+ */
+export class ODBLiteClient implements ODBLiteConnection {
+  private httpClient: HTTPClient;
+  public config: ODBLiteConfig;
+  public sql: SQLFunction;
+
+  constructor(config: ODBLiteConfig) {
+    this.config = config;
+    this.httpClient = new HTTPClient(config);
+
+    // Create the callable sql function with attached utility methods
+    const sqlFunction = <T = any>(sql: TemplateStringsArray | any, ...values: any[]): Promise<QueryResult<T>> | SQLFragment => {
+      // Handle template string queries (returns Promise)
+      if (Array.isArray(sql) && (('raw' in sql) || (typeof sql[0] === 'string' && values.length >= 0))) {
+        const parsed = SQLParser.parse(sql, values);
+        return this.httpClient.query<T>(parsed.sql, parsed.params);
+      }
+
+      // Handle direct object/array inputs (returns SQLFragment for composing)
+      const parsed = SQLParser.parse(sql, values);
+      return {
+        text: parsed.sql,
+        values: parsed.params
+      };
+    };
+
+    // Attach minimal utility methods to the function
+    sqlFunction.raw = (text: string): string => SQLParser.raw(text);
+    sqlFunction.identifier = (name: string): string => SQLParser.identifier(name);
+
+    // Attach client methods to the function
+    sqlFunction.query = async <T = any>(sql: string, params: any[] = []): Promise<QueryResult<T>> => {
+      return await this.httpClient.query<T>(sql, params);
+    };
+
+    // libsql-compatible execute method (for backward compatibility)
+    sqlFunction.execute = async <T = any>(sql: string | { sql: string; args?: any[] }, args?: any[]): Promise<QueryResult<T>> => {
+      if (typeof sql === 'string') {
+        return await this.httpClient.query<T>(sql, args || []);
+      } else {
+        return await this.httpClient.query<T>(sql.sql, sql.args || []);
+      }
+    };
+
+    // Enhanced begin method with callback support
+    sqlFunction.begin = async <T = any>(
+      modeOrCallback?: TransactionMode | TransactionCallback<T>,
+      callback?: TransactionCallback<T>
+    ): Promise<Transaction | T> => {
+      // Determine if this is callback-style or traditional
+      if (typeof modeOrCallback === 'function') {
+        // begin(callback)
+        return this.executeTransactionWithCallback(modeOrCallback);
+      } else if (typeof modeOrCallback === 'string' && callback) {
+        // begin(mode, callback)
+        return this.executeTransactionWithCallback(callback, modeOrCallback);
+      } else {
+        // begin() - traditional style
+        return createSimpleTransaction(this.httpClient);
+      }
+    };
+    sqlFunction.ping = async (): Promise<boolean> => {
+      return await this.httpClient.ping();
+    };
+    sqlFunction.end = async (): Promise<void> => {
+      // No-op for HTTP-based client
+    };
+    sqlFunction.setDatabase = (databaseId: string): SQLFunction => {
+      this.httpClient.setDatabase(databaseId);
+      this.config.databaseId = databaseId;
+      return sqlFunction as SQLFunction;
+    };
+    sqlFunction.getDatabaseInfo = async (): Promise<any> => {
+      return await this.httpClient.getDatabaseInfo();
+    };
+    sqlFunction.configure = (updates: Partial<ODBLiteConfig>): SQLFunction => {
+      const newConfig = { ...this.config, ...updates };
+      return new ODBLiteClient(newConfig).sql;
+    };
+
+    this.sql = sqlFunction as SQLFunction;
+  }
+
+  /**
+   * Execute a transaction with callback (postgres.js style)
+   */
+  private async executeTransactionWithCallback<T>(
+    callback: TransactionCallback<T>,
+    mode?: TransactionMode
+  ): Promise<T> {
+    const tx = createSimpleTransaction(this.httpClient);
+
+    try {
+      // Execute the callback with the transaction
+      const result = await callback(tx);
+
+      // Commit the transaction
+      await tx.commit();
+
+      return result as T;
+    } catch (error) {
+      // Rollback on any error
+      await tx.rollback();
+      throw error;
+    }
+  }
+
+
+  /**
+   * Raw query method
+   * Usage: client.query('SELECT * FROM users WHERE id = ?', [123])
+   */
+  async query<T = any>(sql: string, params: any[] = []): Promise<QueryResult<T>> {
+    return await this.httpClient.query<T>(sql, params);
+  }
+
+  /**
+   * Begin a transaction
+   * Note: Uses simple transaction model suitable for HTTP-based access
+   */
+  async begin(): Promise<Transaction> {
+    return createSimpleTransaction(this.httpClient);
+  }
+
+  /**
+   * Health check
+   */
+  async ping(): Promise<boolean> {
+    return await this.httpClient.ping();
+  }
+
+  /**
+   * Close connection (no-op for HTTP client)
+   */
+  async end(): Promise<void> {
+    // No-op for HTTP-based client
+  }
+
+  /**
+   * Set the database ID for queries
+   */
+  setDatabase(databaseId: string): this {
+    this.httpClient.setDatabase(databaseId);
+    this.config.databaseId = databaseId;
+    return this;
+  }
+
+  /**
+   * Get database information
+   */
+  async getDatabaseInfo(): Promise<any> {
+    return await this.httpClient.getDatabaseInfo();
+  }
+
+  /**
+   * Create a new client instance with updated configuration
+   */
+  configure(updates: Partial<ODBLiteConfig>): ODBLiteClient {
+    const newConfig = { ...this.config, ...updates };
+    return new ODBLiteClient(newConfig);
+  }
+
+
+  /**
+   * Create raw SQL that won't be parameterized
+   * Usage: sql`SELECT * FROM ${raw('users')}`
+   */
+  static raw(text: string): string {
+    return SQLParser.raw(text);
+  }
+
+  /**
+   * Escape identifier (table/column names)
+   * Usage: sql`SELECT * FROM ${identifier('user-table')}`
+   */
+  static identifier(name: string): string {
+    return SQLParser.identifier(name);
+  }
+
+  /**
+   * Build WHERE clause from object
+   * Usage: const whereClause = ODBLiteClient.where({ id: 1, name: 'John' });
+   */
+  static where(conditions: Record<string, any>) {
+    return SQLParser.where(conditions);
+  }
+
+  /**
+   * Build INSERT VALUES from object(s)
+   * Usage: const insertClause = ODBLiteClient.insertValues({ name: 'John', age: 30 });
+   */
+  static insertValues(data: Record<string, any> | Record<string, any>[]) {
+    return SQLParser.insertValues(data);
+  }
+
+  /**
+   * Build UPDATE SET clause from object
+   * Usage: const setClause = ODBLiteClient.updateSet({ name: 'John', age: 30 });
+   */
+  static updateSet(data: Record<string, any>) {
+    return SQLParser.updateSet(data);
+  }
+
+  /**
+   * Join SQL fragments
+   * Usage: const query = ODBLiteClient.join([baseQuery, whereClause], ' WHERE ');
+   */
+  static join(fragments: Array<{ text: string; values: any[] }>, separator = ' ') {
+    return SQLParser.join(fragments, separator);
+  }
+}
+
+/**
+ * Factory function to create ODBLite client (postgres.js style)
+ * Returns the sql function directly, not the client class
+ */
+export function odblite(config: ODBLiteConfig): SQLFunction;
+export function odblite(baseUrl: string, apiKey: string, databaseId?: string): SQLFunction;
+export function odblite(
+  configOrBaseUrl: ODBLiteConfig | string,
+  apiKey?: string,
+  databaseId?: string
+): SQLFunction {
+  const client = typeof configOrBaseUrl === 'string'
+    ? new ODBLiteClient({
+        baseUrl: configOrBaseUrl,
+        apiKey: apiKey!,
+        databaseId
+      })
+    : new ODBLiteClient(configOrBaseUrl);
+
+  return client.sql;
+}
+
+// Export static utility functions
+export const raw = ODBLiteClient.raw;
+export const identifier = ODBLiteClient.identifier;
+export const where = ODBLiteClient.where;
+export const insertValues = ODBLiteClient.insertValues;
+export const updateSet = ODBLiteClient.updateSet;
+export const join = ODBLiteClient.join;