@pineliner/odb-client 1.0.0

package/README.md

@@ -0,0 +1,316 @@
+# ODBLite Client
+
+A TypeScript/JavaScript client for ODBLite that provides a postgres.js-like interface for LibSQL databases. This isomorphic client transforms template string SQL to LibSQL JSON format while maintaining familiar syntax.
+
+## Features
+
+- 🔄 **Isomorphic**: Works in Node.js, Bun, and browsers
+- 📝 **Template String SQL**: postgres.js-style template literals
+- 🛡️ **Type Safe**: Full TypeScript support with generics
+- ⚡ **HTTP-based**: Communicates with ODBLite service over HTTP
+- 🔄 **Retry Logic**: Built-in connection retry with exponential backoff
+- 🎯 **LibSQL Compatible**: Optimized for LibSQL/SQLite databases
+
+## Installation
+
+```bash
+npm install @your-org/odblite-client
+# or
+bun add @your-org/odblite-client
+```
+
+## Quick Start
+
+**🎯 SUPPORTS BOTH QUERY STYLES** - See [QUERY_STYLES.md](./QUERY_STYLES.md) for full documentation
+
+### Style 1: Template Strings (postgres.js-like)
+
+```typescript
+import { odblite } from '@pineliner/odb-client';
+
+const sql = odblite({
+  baseUrl: 'http://localhost:8671',
+  apiKey: 'your-api-key',
+  databaseId: 'your-database-hash'
+});
+
+// Template string queries
+const users = await sql`SELECT * FROM users WHERE age > ${25}`;
+const user = await sql`SELECT * FROM users WHERE id = ${userId}`;
+```
+
+### Style 2: Query Method (? placeholders)
+
+```typescript
+import { odblite } from '@pineliner/odb-client';
+
+const sql = odblite({
+  baseUrl: 'http://localhost:8671',
+  apiKey: 'your-api-key',
+  databaseId: 'your-database-hash'
+});
+
+// Query method with parameters
+const users = await sql.query('SELECT * FROM users WHERE age > ?', [25]);
+const user = await sql.query('SELECT * FROM users WHERE id = ?', [userId]);
+```
+
+**👉 Both styles work identically! Choose what you prefer.**
+
+// Context-aware sql() - detects WHERE conditions automatically!
+const activeUsers = await sql`
+  SELECT * FROM users
+  WHERE ${sql({ active: true, role: ['admin', 'user'] })}  // Arrays = IN clauses!
+`;
+
+// Transactions work exactly like postgres.js with context-aware tx()!
+const tx = await sql.begin();
+await tx`INSERT INTO users ${tx({ name: 'John', age: 30 })}`;
+await tx`UPDATE users SET ${tx({ active: true })} WHERE id = 1`;
+await tx.commit();
+```
+
+## API Reference
+
+### Factory Functions
+
+```typescript
+// With config object - returns callable sql function
+const sql = odblite({
+  baseUrl: 'http://localhost:3000',
+  apiKey: 'your-api-key',
+  databaseId: 'your-database-id',
+  timeout: 30000,
+  retries: 3
+});
+
+// With individual parameters - returns callable sql function
+const sql = odblite('http://localhost:3000', 'your-api-key', 'your-database-id');
+```
+
+### Template String Queries (Identical to postgres.js!)
+
+```typescript
+// Basic queries - sql is directly callable!
+const users = await sql`SELECT * FROM users`;
+const user = await sql`SELECT * FROM users WHERE id = ${id}`;
+
+// Array values (IN clauses)
+const users = await sql`SELECT * FROM users WHERE id IN ${[1, 2, 3]}`;
+
+// Object values - context-aware!
+await sql`UPDATE users SET ${userUpdate} WHERE id = ${id}`;
+```
+
+### Context-Aware sql() Function
+
+The `sql()` function intelligently detects the context and formats accordingly:
+
+```typescript
+// WHERE conditions - detects null/array values
+const conditions = sql({
+  active: true,
+  deleted_at: null,     // Becomes "IS NULL"
+  id: [1, 2, 3],       // Becomes "IN (?, ?, ?)"
+  name: 'John'         // Becomes "= ?"
+});
+// Result: "active" = ? AND "deleted_at" IS NULL AND "id" IN (?, ?, ?) AND "name" = ?
+
+// SET clauses - detects simple objects
+const setData = sql({ name: 'John', age: 30 });
+// Result: "name" = ?, "age" = ?
+
+// INSERT VALUES - detects arrays of objects
+const insertData = sql([
+  { name: 'John', age: 30 },
+  { name: 'Jane', age: 25 }
+]);
+// Result: ("name", "age") VALUES (?, ?), (?, ?)
+
+// IN clauses - detects primitive arrays
+const inClause = sql([1, 2, 3]);
+// Result: (?, ?, ?)
+```
+
+### Raw Query Method
+
+```typescript
+const result = await sql.query('SELECT * FROM users WHERE id = ?', [123]);
+```
+
+### Utility Methods (Minimal)
+
+```typescript
+// Raw SQL (unescaped) - for table/column names
+const tableName = sql.raw('users');
+await sql`SELECT * FROM ${tableName}`;
+
+// Identifier escaping - for dynamic column names
+const columnName = sql.identifier('user-name');
+await sql`SELECT ${columnName} FROM users`;
+
+// Everything else uses context-aware sql()!
+const whereClause = sql({
+  active: true,
+  role: ['admin', 'user'],
+  created_at: null
+});
+await sql`SELECT * FROM users WHERE ${whereClause}`;
+
+const insertClause = sql([
+  { name: 'John', age: 30 },
+  { name: 'Jane', age: 25 }
+]);
+await sql`INSERT INTO users ${insertClause}`;
+
+const setClause = sql({ name: 'John', age: 31 });
+await sql`UPDATE users SET ${setClause} WHERE id = ${id}`;
+```
+
+### Transactions (Context-Aware Like Main sql Function!)
+
+```typescript
+// Begin transaction - returns callable transaction function with context detection
+const tx = await sql.begin();
+
+try {
+  // tx() is context-aware just like sql()!
+  await tx`INSERT INTO users ${tx({ name: 'John', email: 'john@example.com' })}`;
+  await tx`UPDATE settings SET ${tx({ last_user: 'John', updated_at: new Date() })}`;
+
+  // Use WHERE conditions in transactions
+  await tx`DELETE FROM temp_data WHERE ${tx({ expired: true, created_at: null })}`;
+
+  await tx.commit();
+} catch (error) {
+  await tx.rollback();
+  throw error;
+}
+
+// Batch operations with context-aware tx()
+const tx2 = await sql.begin();
+const users = [
+  { name: 'Alice', email: 'alice@example.com' },
+  { name: 'Bob', email: 'bob@example.com' }
+];
+
+await tx2`INSERT INTO users ${tx2(users)}`; // Automatic bulk insert detection!
+await tx2.commit();
+```
+
+### Database Management
+
+```typescript
+// Switch database
+sql.setDatabase('another-database-id');
+
+// Health check
+const isHealthy = await sql.ping();
+
+// Get database info
+const info = await sql.getDatabaseInfo();
+
+// Create new client with different config
+const newSql = sql.configure({ timeout: 60000 });
+```
+
+### Error Handling
+
+```typescript
+import { QueryError, ConnectionError } from '@your-org/odblite-client';
+
+try {
+  await sql`SELECT * FROM users WHERE invalid_column = ${value}`;
+} catch (error) {
+  if (error instanceof QueryError) {
+    console.log('SQL Error:', error.message);
+    console.log('Query:', error.query);
+    console.log('Params:', error.params);
+  } else if (error instanceof ConnectionError) {
+    console.log('Connection Error:', error.message);
+  }
+}
+```
+
+## Type Safety
+
+```typescript
+interface User {
+  id: number;
+  name: string;
+  email: string;
+  created_at: string;
+}
+
+// Typed query results
+const users = await sql<User>`SELECT * FROM users`;
+// users.rows is User[]
+
+const user = await sql<User>`SELECT * FROM users WHERE id = ${1}`;
+// user.rows[0] is User | undefined
+```
+
+## Configuration Options
+
+```typescript
+interface ODBLiteConfig {
+  baseUrl: string;        // ODBLite service URL
+  apiKey: string;         // API authentication key
+  databaseId?: string;    // Target database ID
+  timeout?: number;       // Request timeout (default: 30000ms)
+  retries?: number;       // Retry attempts (default: 3)
+}
+```
+
+## Query Result Format
+
+```typescript
+interface QueryResult<T> {
+  rows: T[];              // Query result rows
+  rowsAffected: number;   // Number of affected rows
+  executionTime: number;  // Query execution time in ms
+  databaseName?: string;  // Database name
+}
+```
+
+## Comparison with postgres.js
+
+This client provides a similar API to postgres.js but optimized for LibSQL:
+
+```typescript
+// postgres.js style - works the same!
+const users = await sql`SELECT * FROM users WHERE age > ${25}`;
+const user = await sql`SELECT * FROM users WHERE id = ${userId}`;
+
+// Object destructuring
+const [user] = await sql`SELECT * FROM users WHERE id = ${1}`;
+
+// Template string power
+const searchTerm = 'john';
+const users = await sql`
+  SELECT * FROM users
+  WHERE name ILIKE ${'%' + searchTerm + '%'}
+  ORDER BY created_at DESC
+  LIMIT ${10}
+`;
+```
+
+## Development
+
+```bash
+# Install dependencies
+bun install
+
+# Run tests
+bun test
+
+# Build
+bun run build
+
+# Type check
+bun run typecheck
+```
+
+## License
+
+MIT

package/dist/core/client.d.ts

@@ -0,0 +1,110 @@
+import type { ODBLiteConfig, ODBLiteConnection, QueryResult, Transaction, TransactionCallback, TransactionMode, SQLFragment } from '../types.ts';
+interface SQLFunction {
+    <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>>;
+    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 declare class ODBLiteClient implements ODBLiteConnection {
+    private httpClient;
+    config: ODBLiteConfig;
+    sql: SQLFunction;
+    constructor(config: ODBLiteConfig);
+    /**
+     * Execute a transaction with callback (postgres.js style)
+     */
+    private executeTransactionWithCallback;
+    /**
+     * Raw query method
+     * Usage: client.query('SELECT * FROM users WHERE id = ?', [123])
+     */
+    query<T = any>(sql: string, params?: any[]): Promise<QueryResult<T>>;
+    /**
+     * Begin a transaction
+     * Note: Uses simple transaction model suitable for HTTP-based access
+     */
+    begin(): Promise<Transaction>;
+    /**
+     * Health check
+     */
+    ping(): Promise<boolean>;
+    /**
+     * Close connection (no-op for HTTP client)
+     */
+    end(): Promise<void>;
+    /**
+     * Set the database ID for queries
+     */
+    setDatabase(databaseId: string): this;
+    /**
+     * Get database information
+     */
+    getDatabaseInfo(): Promise<any>;
+    /**
+     * Create a new client instance with updated configuration
+     */
+    configure(updates: Partial<ODBLiteConfig>): ODBLiteClient;
+    /**
+     * Create raw SQL that won't be parameterized
+     * Usage: sql`SELECT * FROM ${raw('users')}`
+     */
+    static raw(text: string): string;
+    /**
+     * Escape identifier (table/column names)
+     * Usage: sql`SELECT * FROM ${identifier('user-table')}`
+     */
+    static identifier(name: string): string;
+    /**
+     * Build WHERE clause from object
+     * Usage: const whereClause = ODBLiteClient.where({ id: 1, name: 'John' });
+     */
+    static where(conditions: Record<string, any>): SQLFragment;
+    /**
+     * Build INSERT VALUES from object(s)
+     * Usage: const insertClause = ODBLiteClient.insertValues({ name: 'John', age: 30 });
+     */
+    static insertValues(data: Record<string, any> | Record<string, any>[]): SQLFragment;
+    /**
+     * Build UPDATE SET clause from object
+     * Usage: const setClause = ODBLiteClient.updateSet({ name: 'John', age: 30 });
+     */
+    static updateSet(data: Record<string, any>): SQLFragment;
+    /**
+     * Join SQL fragments
+     * Usage: const query = ODBLiteClient.join([baseQuery, whereClause], ' WHERE ');
+     */
+    static join(fragments: Array<{
+        text: string;
+        values: any[];
+    }>, separator?: string): SQLFragment;
+}
+/**
+ * Factory function to create ODBLite client (postgres.js style)
+ * Returns the sql function directly, not the client class
+ */
+export declare function odblite(config: ODBLiteConfig): SQLFunction;
+export declare function odblite(baseUrl: string, apiKey: string, databaseId?: string): SQLFunction;
+export declare const raw: typeof ODBLiteClient.raw;
+export declare const identifier: typeof ODBLiteClient.identifier;
+export declare const where: typeof ODBLiteClient.where;
+export declare const insertValues: typeof ODBLiteClient.insertValues;
+export declare const updateSet: typeof ODBLiteClient.updateSet;
+export declare const join: typeof ODBLiteClient.join;
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/core/client.d.ts.map

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

package/dist/core/http-client.d.ts

@@ -0,0 +1,37 @@
+import type { ODBLiteConfig, QueryResult } from '../types.ts';
+/**
+ * HTTP client for communicating with ODBLite service
+ */
+export declare class HTTPClient {
+    private config;
+    constructor(config: ODBLiteConfig);
+    /**
+     * Execute a query against the ODBLite service
+     */
+    query<T = any>(sql: string, params?: any[]): Promise<QueryResult<T>>;
+    /**
+     * Check database health
+     */
+    ping(): Promise<boolean>;
+    /**
+     * Get database information
+     */
+    getDatabaseInfo(): Promise<any>;
+    /**
+     * Set the database ID for subsequent queries
+     */
+    setDatabase(databaseId: string): void;
+    /**
+     * Make HTTP request with retry logic
+     */
+    private makeRequest;
+    /**
+     * Create a new HTTPClient with updated config
+     */
+    configure(updates: Partial<ODBLiteConfig>): HTTPClient;
+    /**
+     * Get current configuration
+     */
+    getConfig(): Readonly<ODBLiteConfig>;
+}
+//# sourceMappingURL=http-client.d.ts.map

package/dist/core/http-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../src/core/http-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAmB,WAAW,EAAE,MAAM,aAAa,CAAA;AAG9E;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAe;gBAEjB,MAAM,EAAE,aAAa;IAajC;;OAEG;IACG,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,GAAG,EAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAoD9E;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAqB9B;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,GAAG,CAAC;IAqBrC;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAIrC;;OAEG;YACW,WAAW;IAgDzB;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,UAAU;IAOtD;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,aAAa,CAAC;CAGrC"}

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

@@ -0,0 +1,70 @@
+import type { SQLFragment, PreparedQuery } from '../types.ts';
+/**
+ * SQL template string parser that converts postgres.js-style template strings
+ * into LibSQL-compatible parameterized queries
+ */
+export declare class SQLParser {
+    /**
+     * Parse input that can be template strings, objects, or arrays
+     * Context-aware like postgres.js
+     */
+    static parse(sql: TemplateStringsArray | any, values?: any[]): PreparedQuery;
+    /**
+     * Parse contextual input (objects, arrays, etc.)
+     * Uses heuristics to detect the intended context
+     */
+    private static parseContextualInput;
+    /**
+     * Build a SET clause for UPDATE statements
+     */
+    private static buildSetClause;
+    /**
+     * Parse template string SQL into LibSQL format
+     */
+    private static parseTemplateString;
+    /**
+     * Create a raw SQL fragment (not parameterized)
+     */
+    static raw(text: string): string;
+    /**
+     * Create an identifier (table name, column name, etc.)
+     */
+    static identifier(name: string): string;
+    /**
+     * Escape SQL identifiers (table names, column names)
+     */
+    private static escapeIdentifier;
+    /**
+     * Convert JavaScript values to LibSQL-compatible values
+     */
+    private static convertValue;
+    /**
+     * Create a SQL fragment for building complex queries
+     */
+    static fragment(sql: TemplateStringsArray, ...values: any[]): SQLFragment;
+    /**
+     * Join multiple SQL fragments
+     */
+    static join(fragments: SQLFragment[], separator?: string): SQLFragment;
+    /**
+     * Helper for building WHERE clauses from objects
+     */
+    static where(conditions: Record<string, any>): SQLFragment;
+    /**
+     * Helper for building INSERT VALUES from objects
+     */
+    static insertValues(data: Record<string, any> | Record<string, any>[]): SQLFragment;
+    /**
+     * Helper for building UPDATE SET clauses from objects
+     */
+    static updateSet(data: Record<string, any>): SQLFragment;
+}
+export declare const sql: typeof SQLParser.parse;
+export declare const raw: typeof SQLParser.raw;
+export declare const identifier: typeof SQLParser.identifier;
+export declare const fragment: typeof SQLParser.fragment;
+export declare const join: typeof SQLParser.join;
+export declare const where: typeof SQLParser.where;
+export declare const insertValues: typeof SQLParser.insertValues;
+export declare const updateSet: typeof SQLParser.updateSet;
+//# sourceMappingURL=sql-parser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sql-parser.d.ts","sourceRoot":"","sources":["../../src/core/sql-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAkB,MAAM,aAAa,CAAC;AAE9E;;;GAGG;AACH,qBAAa,SAAS;IACpB;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,oBAAoB,GAAG,GAAG,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,aAAa;IAU5E;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAyEnC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAgB7B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAyClC;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIhC;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIvC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAK/B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IAiC3B;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,WAAW;IAQzE;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,EAAE,SAAS,SAAM,GAAG,WAAW;IAOnE;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,WAAW;IA8B1D;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,WAAW;IAyBnF;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,WAAW;CAezD;AAGD,eAAO,MAAM,GAAG,wBAAkC,CAAC;AACnD,eAAO,MAAM,GAAG,sBAAgC,CAAC;AACjD,eAAO,MAAM,UAAU,6BAAuC,CAAC;AAC/D,eAAO,MAAM,QAAQ,2BAAqC,CAAC;AAC3D,eAAO,MAAM,IAAI,uBAAiC,CAAC;AACnD,eAAO,MAAM,KAAK,wBAAkC,CAAC;AACrD,eAAO,MAAM,YAAY,+BAAyC,CAAC;AACnE,eAAO,MAAM,SAAS,4BAAsC,CAAC"}

package/dist/core/transaction.d.ts

@@ -0,0 +1,60 @@
+import type { Transaction, QueryResult } from '../types.ts';
+import type { HTTPClient } from './http-client.ts';
+/**
+ * Create a transaction function similar to the main sql function
+ */
+export declare function createTransaction(httpClient: HTTPClient): Transaction;
+/**
+ * Transaction implementation for ODBLite
+ * Note: SQLite transactions are simulated at the client level since ODBLite
+ * operates on individual queries. This provides a familiar API but doesn't
+ * provide true ACID guarantees across multiple HTTP requests.
+ */
+export declare class ODBLiteTransaction {
+    private httpClient;
+    private isCommitted;
+    private isRolledBack;
+    private queries;
+    constructor(httpClient: HTTPClient);
+    /**
+     * Execute a query within the transaction
+     * For SQLite, we'll queue queries and execute them in batch on commit
+     */
+    sql<T = any>(sql: TemplateStringsArray, ...values: any[]): Promise<QueryResult<T>>;
+    /**
+     * Commit the transaction by executing all queued queries
+     */
+    commit(): Promise<void>;
+    /**
+     * Rollback the transaction
+     */
+    rollback(): Promise<void>;
+    /**
+     * Check if transaction is still active
+     */
+    private checkTransactionState;
+    /**
+     * Determine if a query is a read operation
+     */
+    private isReadQuery;
+}
+/**
+ * Create a simple transaction function that executes immediately
+ * This is more suitable for HTTP-based databases where true transactions
+ * across multiple requests are not practical
+ */
+export declare function createSimpleTransaction(httpClient: HTTPClient): Transaction;
+/**
+ * Simple transaction implementation that executes immediately
+ * This is more suitable for HTTP-based databases where true transactions
+ * across multiple requests are not practical
+ */
+export declare class SimpleTransaction {
+    private httpClient;
+    private isActive;
+    constructor(httpClient: HTTPClient);
+    sql<T = any>(sql: TemplateStringsArray, ...values: any[]): Promise<QueryResult<T>>;
+    commit(): Promise<void>;
+    rollback(): Promise<void>;
+}
+//# sourceMappingURL=transaction.d.ts.map

package/dist/core/transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../../src/core/transaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAoC,MAAM,aAAa,CAAC;AAC9F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAInD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,UAAU,GAAG,WAAW,CAgLrE;AAED;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,OAAO,CAA6C;gBAEhD,UAAU,EAAE,UAAU;IAIlC;;;OAGG;IACG,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAqBxF;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAkC7B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAa/B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAS7B;;OAEG;IACH,OAAO,CAAC,WAAW;CAOpB;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,UAAU,GAAG,WAAW,CAkF3E;AAED;;;;GAIG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,QAAQ,CAAQ;gBAEZ,UAAU,EAAE,UAAU;IAI5B,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IASlF,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAKvB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAIhC"}