family-ai-agent 1.0.6 → 1.0.8

package/.letta/settings.local.json

@@ -0,0 +1,3 @@
+{
+  "lastAgent": "agent-3a361625-47f4-46d7-bde9-c0f165ea2a58"
+}

package/dist/cli/index.js

@@ -260,7 +260,7 @@ async function runQuery(query) {
 program
     .name('family-ai-agent')
     .description('Family AI Agent - Your AI Family for All Tasks')
-    .version('1.0.6');
+    .version('1.0.8');
 // Add config command group
 program.addCommand(createConfigCommand());
 program

package/dist/database/adapters/base-adapter.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Base Database Adapter
+ *
+ * Abstract base class for database adapters.
+ * Provides common functionality and interface contract.
+ */
+import type { DatabaseAdapter, DatabaseType, QueryResult, TransactionClient, PoolStats } from '../types.js';
+/**
+ * Abstract base adapter class
+ */
+export declare abstract class BaseAdapter implements DatabaseAdapter {
+    abstract readonly type: DatabaseType;
+    protected _isInitialized: boolean;
+    get isInitialized(): boolean;
+    /**
+     * Initialize the database connection
+     */
+    abstract initialize(): Promise<void>;
+    /**
+     * Execute a raw SQL query
+     */
+    abstract query<T extends Record<string, any> = Record<string, any>>(sql: string, params?: unknown[]): Promise<QueryResult<T>>;
+    /**
+     * Execute a transaction
+     */
+    abstract transaction<T>(callback: (client: TransactionClient) => Promise<T>): Promise<T>;
+    /**
+     * Check database health
+     */
+    abstract healthCheck(): Promise<boolean>;
+    /**
+     * Get connection pool statistics
+     */
+    getPoolStats?(): PoolStats;
+    /**
+     * Close all connections
+     */
+    abstract close(): Promise<void>;
+    /**
+     * Ensure adapter is initialized before operations
+     */
+    protected ensureInitialized(): void;
+    /**
+     * Log query execution
+     */
+    protected logQuery(sql: string, durationMs: number, rowCount: number | null): void;
+    /**
+     * Log query error
+     */
+    protected logError(sql: string, error: unknown): void;
+    /**
+     * Convert PostgreSQL parameter placeholders ($1, $2) to SQLite (?)
+     */
+    protected convertPlaceholders(sql: string): string;
+    /**
+     * Convert PostgreSQL-specific syntax to SQLite
+     */
+    protected convertToSqlite(sql: string): string;
+    /**
+     * Extract RETURNING clause from SQL
+     */
+    protected extractReturning(sql: string): string | null;
+    /**
+     * Extract table name from INSERT/UPDATE/DELETE
+     */
+    protected extractTableName(sql: string): string | null;
+    /**
+     * Check if SQL is a SELECT query
+     */
+    protected isSelectQuery(sql: string): boolean;
+    /**
+     * Check if SQL has RETURNING clause
+     */
+    protected hasReturning(sql: string): boolean;
+}
+/**
+ * Adapter factory function type
+ */
+export type AdapterFactory = () => Promise<DatabaseAdapter>;
+export default BaseAdapter;
+//# sourceMappingURL=base-adapter.d.ts.map

package/dist/database/adapters/base-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-adapter.d.ts","sourceRoot":"","sources":["../../../src/database/adapters/base-adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,SAAS,EACV,MAAM,aAAa,CAAC;AAMrB;;GAEG;AACH,8BAAsB,WAAY,YAAW,eAAe;IAC1D,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IACrC,SAAS,CAAC,cAAc,UAAS;IAEjC,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED;;OAEG;IACH,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAEpC;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAChE,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,OAAO,EAAE,GACjB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,CAAC,EACpB,QAAQ,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,OAAO,CAAC,CAAC,CAAC,GAClD,OAAO,CAAC,CAAC,CAAC;IAEb;;OAEG;IACH,QAAQ,CAAC,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAExC;;OAEG;IACH,YAAY,CAAC,IAAI,SAAS;IAE1B;;OAEG;IACH,QAAQ,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAE/B;;OAEG;IACH,SAAS,CAAC,iBAAiB,IAAI,IAAI;IAMnC;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IASlF;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IASrD;;OAEG;IACH,SAAS,CAAC,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAIlD;;OAEG;IACH,SAAS,CAAC,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAkB9C;;OAEG;IACH,SAAS,CAAC,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKtD;;OAEG;IACH,SAAS,CAAC,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAatD;;OAEG;IACH,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI7C;;OAEG;IACH,SAAS,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;CAG7C;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC,CAAC;AAE5D,eAAe,WAAW,CAAC"}

package/dist/database/adapters/base-adapter.js

@@ -0,0 +1,105 @@
+/**
+ * Base Database Adapter
+ *
+ * Abstract base class for database adapters.
+ * Provides common functionality and interface contract.
+ */
+import { createLogger } from '../../utils/logger.js';
+import { MemoryError } from '../../utils/errors.js';
+const logger = createLogger('DatabaseAdapter');
+/**
+ * Abstract base adapter class
+ */
+export class BaseAdapter {
+    _isInitialized = false;
+    get isInitialized() {
+        return this._isInitialized;
+    }
+    /**
+     * Ensure adapter is initialized before operations
+     */
+    ensureInitialized() {
+        if (!this._isInitialized) {
+            throw new MemoryError('Database adapter not initialized. Call initialize() first.');
+        }
+    }
+    /**
+     * Log query execution
+     */
+    logQuery(sql, durationMs, rowCount) {
+        logger.debug('Query executed', {
+            database: this.type,
+            duration: durationMs,
+            rows: rowCount,
+            query: sql.slice(0, 100),
+        });
+    }
+    /**
+     * Log query error
+     */
+    logError(sql, error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        logger.error('Query failed', {
+            database: this.type,
+            error: errorMessage,
+            query: sql.slice(0, 100),
+        });
+    }
+    /**
+     * Convert PostgreSQL parameter placeholders ($1, $2) to SQLite (?)
+     */
+    convertPlaceholders(sql) {
+        return sql.replace(/\$\d+/g, '?');
+    }
+    /**
+     * Convert PostgreSQL-specific syntax to SQLite
+     */
+    convertToSqlite(sql) {
+        let converted = this.convertPlaceholders(sql);
+        // Replace NOW() with CURRENT_TIMESTAMP
+        converted = converted.replace(/NOW\(\)/gi, 'CURRENT_TIMESTAMP');
+        // Remove ::type casts
+        converted = converted.replace(/::[a-zA-Z_]+(\[\])?/g, '');
+        // Replace JSONB with JSON (SQLite uses text)
+        converted = converted.replace(/JSONB/gi, 'JSON');
+        // Replace gen_random_uuid() with a placeholder (handled in code)
+        converted = converted.replace(/gen_random_uuid\(\)/gi, "lower(hex(randomblob(16)))");
+        return converted;
+    }
+    /**
+     * Extract RETURNING clause from SQL
+     */
+    extractReturning(sql) {
+        const match = sql.match(/RETURNING\s+(.+?)$/i);
+        return match ? match[1].trim() : null;
+    }
+    /**
+     * Extract table name from INSERT/UPDATE/DELETE
+     */
+    extractTableName(sql) {
+        const insertMatch = sql.match(/INSERT\s+INTO\s+["']?(\w+)["']?/i);
+        if (insertMatch)
+            return insertMatch[1];
+        const updateMatch = sql.match(/UPDATE\s+["']?(\w+)["']?/i);
+        if (updateMatch)
+            return updateMatch[1];
+        const deleteMatch = sql.match(/DELETE\s+FROM\s+["']?(\w+)["']?/i);
+        if (deleteMatch)
+            return deleteMatch[1];
+        return null;
+    }
+    /**
+     * Check if SQL is a SELECT query
+     */
+    isSelectQuery(sql) {
+        return sql.trim().toUpperCase().startsWith('SELECT');
+    }
+    /**
+     * Check if SQL has RETURNING clause
+     */
+    hasReturning(sql) {
+        return /RETURNING\s+/i.test(sql);
+    }
+}
+export default BaseAdapter;
+//# sourceMappingURL=base-adapter.js.map

package/dist/database/adapters/base-adapter.js.map

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

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

@@ -0,0 +1,49 @@
+/**
+ * Database Adapter Factory
+ *
+ * Factory for creating database adapters with auto-detection support.
+ * Tries PostgreSQL first, falls back to SQLite automatically.
+ */
+import type { DatabaseAdapter, DetectionResult, DatabaseConfig } from '../types.js';
+/**
+ * Detect which database to use
+ */
+export declare function detectDatabase(config: DatabaseConfig): Promise<DetectionResult>;
+/**
+ * Create database adapter based on detection result
+ */
+export declare function createAdapter(detection: DetectionResult, config: DatabaseConfig): Promise<DatabaseAdapter>;
+/**
+ * Get or create the database adapter singleton
+ */
+export declare function getAdapter(): Promise<DatabaseAdapter>;
+/**
+ * Close the database adapter
+ */
+export declare function closeAdapter(): Promise<void>;
+/**
+ * Reset adapter (for testing)
+ */
+export declare function resetAdapter(): void;
+/**
+ * Check if adapter is initialized
+ */
+export declare function isAdapterInitialized(): boolean;
+/**
+ * Get current adapter type
+ */
+export declare function getAdapterType(): 'postgresql' | 'sqlite' | null;
+export { PostgresAdapter } from './postgres-adapter.js';
+export { SQLiteAdapter } from './sqlite-adapter.js';
+export { BaseAdapter } from './base-adapter.js';
+declare const _default: {
+    getAdapter: typeof getAdapter;
+    closeAdapter: typeof closeAdapter;
+    resetAdapter: typeof resetAdapter;
+    detectDatabase: typeof detectDatabase;
+    createAdapter: typeof createAdapter;
+    isAdapterInitialized: typeof isAdapterInitialized;
+    getAdapterType: typeof getAdapterType;
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/database/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAUpF;;GAEG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAoGrF;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,SAAS,EAAE,eAAe,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAWhH;AAED;;GAEG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,eAAe,CAAC,CAU3D;AAmBD;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAOlD;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAGnC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,YAAY,GAAG,QAAQ,GAAG,IAAI,CAE/D;AAGD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;;;;;;;;;;AAEhD,wBAQE"}

package/dist/database/adapters/index.js

@@ -0,0 +1,200 @@
+/**
+ * Database Adapter Factory
+ *
+ * Factory for creating database adapters with auto-detection support.
+ * Tries PostgreSQL first, falls back to SQLite automatically.
+ */
+import pg from 'pg';
+import { PostgresAdapter } from './postgres-adapter.js';
+import { SQLiteAdapter } from './sqlite-adapter.js';
+import { getDatabaseConfig, buildPostgresUrl, getDefaultSqlitePath } from '../db-config.js';
+import { createLogger } from '../../utils/logger.js';
+const { Pool } = pg;
+const logger = createLogger('AdapterFactory');
+// Singleton adapter instance
+let adapterInstance = null;
+let initPromise = null;
+/**
+ * Detect which database to use
+ */
+export async function detectDatabase(config) {
+    // 1. Check for explicit configuration
+    if (config.type !== 'auto') {
+        if (config.type === 'postgresql') {
+            return {
+                type: 'postgresql',
+                connectionString: config.postgresUrl ?? buildPostgresUrl({
+                    DATABASE_URL: config.postgresUrl,
+                    DB_HOST: config.postgresHost,
+                    DB_PORT: config.postgresPort,
+                    DB_USER: config.postgresUser,
+                    DB_PASSWORD: config.postgresPassword,
+                    DB_NAME: config.postgresDatabase,
+                    DB_POOL_MAX: config.postgresPoolMax,
+                    DB_POOL_IDLE_TIMEOUT_MS: config.postgresIdleTimeoutMs,
+                    DB_POOL_CONNECTION_TIMEOUT_MS: config.postgresConnectionTimeoutMs,
+                    DATABASE_TYPE: 'postgresql',
+                    SQLITE_PATH: config.sqlitePath,
+                    DB_HEALTH_CHECK_INTERVAL_MS: config.healthCheckIntervalMs,
+                    DB_CIRCUIT_BREAKER_THRESHOLD: config.circuitBreakerThreshold,
+                    DB_CIRCUIT_BREAKER_TIMEOUT_MS: config.circuitBreakerTimeoutMs,
+                    DB_CACHE_MAX_SIZE: config.cacheMaxSize,
+                    DB_CACHE_TTL_MS: config.cacheTtlMs,
+                    VECTOR_DIMENSION: config.vectorDimension,
+                    VECTOR_MIN_SIMILARITY: config.vectorMinSimilarity,
+                }),
+                reason: 'Explicit PostgreSQL configuration',
+            };
+        }
+        return {
+            type: 'sqlite',
+            sqlitePath: config.sqlitePath ?? getDefaultSqlitePath(),
+            reason: 'Explicit SQLite configuration',
+        };
+    }
+    // 2. Check for DATABASE_URL (usually means PostgreSQL is intended)
+    if (config.postgresUrl) {
+        return {
+            type: 'postgresql',
+            connectionString: config.postgresUrl,
+            reason: 'DATABASE_URL environment variable set',
+        };
+    }
+    // 3. Try PostgreSQL connection
+    try {
+        const connectionString = buildPostgresUrl({
+            DATABASE_URL: config.postgresUrl,
+            DB_HOST: config.postgresHost,
+            DB_PORT: config.postgresPort,
+            DB_USER: config.postgresUser,
+            DB_PASSWORD: config.postgresPassword,
+            DB_NAME: config.postgresDatabase,
+            DB_POOL_MAX: config.postgresPoolMax,
+            DB_POOL_IDLE_TIMEOUT_MS: config.postgresIdleTimeoutMs,
+            DB_POOL_CONNECTION_TIMEOUT_MS: config.postgresConnectionTimeoutMs,
+            DATABASE_TYPE: 'auto',
+            SQLITE_PATH: config.sqlitePath,
+            DB_HEALTH_CHECK_INTERVAL_MS: config.healthCheckIntervalMs,
+            DB_CIRCUIT_BREAKER_THRESHOLD: config.circuitBreakerThreshold,
+            DB_CIRCUIT_BREAKER_TIMEOUT_MS: config.circuitBreakerTimeoutMs,
+            DB_CACHE_MAX_SIZE: config.cacheMaxSize,
+            DB_CACHE_TTL_MS: config.cacheTtlMs,
+            VECTOR_DIMENSION: config.vectorDimension,
+            VECTOR_MIN_SIMILARITY: config.vectorMinSimilarity,
+        });
+        const pool = new Pool({
+            connectionString,
+            connectionTimeoutMillis: 3000, // Quick timeout for detection
+        });
+        try {
+            const client = await pool.connect();
+            await client.query('SELECT 1');
+            client.release();
+            await pool.end();
+            logger.info('PostgreSQL connection successful');
+            return {
+                type: 'postgresql',
+                connectionString,
+                reason: 'PostgreSQL connection successful',
+            };
+        }
+        finally {
+            await pool.end().catch(() => { });
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        logger.debug('PostgreSQL not available, falling back to SQLite', { error: message });
+    }
+    // 4. Fall back to SQLite
+    const sqlitePath = config.sqlitePath ?? getDefaultSqlitePath();
+    return {
+        type: 'sqlite',
+        sqlitePath,
+        reason: 'PostgreSQL unavailable, using SQLite fallback',
+    };
+}
+/**
+ * Create database adapter based on detection result
+ */
+export async function createAdapter(detection, config) {
+    let adapter;
+    if (detection.type === 'postgresql') {
+        adapter = new PostgresAdapter(detection.connectionString, config);
+    }
+    else {
+        adapter = new SQLiteAdapter(detection.sqlitePath, config);
+    }
+    await adapter.initialize();
+    return adapter;
+}
+/**
+ * Get or create the database adapter singleton
+ */
+export async function getAdapter() {
+    if (adapterInstance?.isInitialized) {
+        return adapterInstance;
+    }
+    if (!initPromise) {
+        initPromise = initializeAdapter();
+    }
+    return initPromise;
+}
+/**
+ * Initialize the database adapter
+ */
+async function initializeAdapter() {
+    const config = getDatabaseConfig();
+    const detection = await detectDatabase(config);
+    logger.info('Database detected', {
+        type: detection.type,
+        reason: detection.reason,
+        path: detection.sqlitePath,
+    });
+    adapterInstance = await createAdapter(detection, config);
+    return adapterInstance;
+}
+/**
+ * Close the database adapter
+ */
+export async function closeAdapter() {
+    if (adapterInstance) {
+        await adapterInstance.close();
+        adapterInstance = null;
+        initPromise = null;
+        logger.info('Database adapter closed');
+    }
+}
+/**
+ * Reset adapter (for testing)
+ */
+export function resetAdapter() {
+    adapterInstance = null;
+    initPromise = null;
+}
+/**
+ * Check if adapter is initialized
+ */
+export function isAdapterInitialized() {
+    return adapterInstance?.isInitialized ?? false;
+}
+/**
+ * Get current adapter type
+ */
+export function getAdapterType() {
+    return adapterInstance?.type ?? null;
+}
+// Re-export adapter classes
+export { PostgresAdapter } from './postgres-adapter.js';
+export { SQLiteAdapter } from './sqlite-adapter.js';
+export { BaseAdapter } from './base-adapter.js';
+export default {
+    getAdapter,
+    closeAdapter,
+    resetAdapter,
+    detectDatabase,
+    createAdapter,
+    isAdapterInitialized,
+    getAdapterType,
+};
+//# sourceMappingURL=index.js.map

package/dist/database/adapters/index.js.map

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

package/dist/database/adapters/postgres-adapter.d.ts

@@ -0,0 +1,75 @@
+/**
+ * PostgreSQL Database Adapter
+ *
+ * Adapter for PostgreSQL with connection pooling and pgvector support.
+ */
+import pg from 'pg';
+import type { QueryResultRow } from 'pg';
+import type { NodePgDatabase } from 'drizzle-orm/node-postgres';
+import { BaseAdapter } from './base-adapter.js';
+import type { QueryResult, TransactionClient, PoolStats, DatabaseConfig } from '../types.js';
+import * as schema from '../drizzle/schema/index.js';
+/**
+ * PostgreSQL database adapter with Drizzle ORM
+ */
+export declare class PostgresAdapter extends BaseAdapter {
+    readonly type: "postgresql";
+    private pool;
+    private drizzleInstance;
+    private connectionString;
+    private config;
+    constructor(connectionString: string, config: DatabaseConfig);
+    /**
+     * Get Drizzle ORM instance
+     */
+    get drizzle(): NodePgDatabase<typeof schema>;
+    /**
+     * Get raw pool (for advanced operations)
+     */
+    get rawPool(): pg.Pool;
+    /**
+     * Initialize PostgreSQL connection pool
+     */
+    initialize(): Promise<void>;
+    /**
+     * Test database connection
+     */
+    private testConnection;
+    /**
+     * Enable pgvector extension if not already enabled
+     */
+    private enablePgVector;
+    /**
+     * Execute a raw SQL query
+     */
+    query<T extends QueryResultRow = Record<string, any>>(sqlText: string, params?: unknown[]): Promise<QueryResult<T>>;
+    /**
+     * Execute a transaction
+     */
+    transaction<T>(callback: (client: TransactionClient) => Promise<T>): Promise<T>;
+    /**
+     * Check database health
+     */
+    healthCheck(): Promise<boolean>;
+    /**
+     * Get connection pool statistics
+     */
+    getPoolStats(): PoolStats;
+    /**
+     * Close all connections
+     */
+    close(): Promise<void>;
+    /**
+     * Execute vector similarity search
+     */
+    vectorSearch<T = Record<string, unknown>>(table: string, embeddingColumn: string, queryEmbedding: number[], options?: {
+        limit?: number;
+        minSimilarity?: number;
+        filters?: Record<string, unknown>;
+        selectColumns?: string[];
+    }): Promise<Array<T & {
+        similarity: number;
+    }>>;
+}
+export default PostgresAdapter;
+//# sourceMappingURL=postgres-adapter.d.ts.map

package/dist/database/adapters/postgres-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-adapter.d.ts","sourceRoot":"","sources":["../../../src/database/adapters/postgres-adapter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,IAAI,CAAC;AAEzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAGhE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EACV,WAAW,EACX,iBAAiB,EACjB,SAAS,EACT,cAAc,EACf,MAAM,aAAa,CAAC;AAIrB,OAAO,KAAK,MAAM,MAAM,4BAA4B,CAAC;AAKrD;;GAEG;AACH,qBAAa,eAAgB,SAAQ,WAAW;IAC9C,QAAQ,CAAC,IAAI,EAAG,YAAY,CAAU;IAEtC,OAAO,CAAC,IAAI,CAAwB;IACpC,OAAO,CAAC,eAAe,CAA8C;IACrE,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,MAAM,CAAiB;gBAEnB,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc;IAM5D;;OAEG;IACH,IAAI,OAAO,IAAI,cAAc,CAAC,OAAO,MAAM,CAAC,CAG3C;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,EAAE,CAAC,IAAI,CAGrB;IAED;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA0CjC;;OAEG;YACW,cAAc;IAS5B;;OAEG;YACW,cAAc;IAY5B;;OAEG;IACG,KAAK,CAAC,CAAC,SAAS,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACxD,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,OAAO,EAAE,GACjB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAoB1B;;OAEG;IACG,WAAW,CAAC,CAAC,EACjB,QAAQ,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,OAAO,CAAC,CAAC,CAAC,GAClD,OAAO,CAAC,CAAC,CAAC;IA+Bb;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IASrC;;OAEG;IACH,YAAY,IAAI,SAAS;IAYzB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAU5B;;OAEG;IACG,YAAY,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5C,KAAK,EAAE,MAAM,EACb,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,EAAE,EACxB,OAAO,GAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,GACL,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAmC9C;AAED,eAAe,eAAe,CAAC"}