@orbytautomation/engine 0.1.0

package/dist/adapters/builtins/CLICommandResolver.d.ts

@@ -0,0 +1,49 @@
+/**
+ * CLI Command Resolver
+ *
+ * Resolves CLI commands with path resolution and environment setup.
+ */
+export interface CommandResolution {
+    /**
+     * Resolved command path or name
+     */
+    command: string;
+    /**
+     * Whether the command was found in PATH
+     */
+    found: boolean;
+    /**
+     * Absolute path to the command (if found)
+     */
+    absolutePath?: string;
+    /**
+     * Resolved arguments
+     */
+    args: string[];
+    /**
+     * Environment variables
+     */
+    env: Record<string, string>;
+}
+export declare class CLICommandResolver {
+    private cwd;
+    private env;
+    constructor(cwd?: string, env?: Record<string, string>);
+    /**
+     * Resolve a CLI command
+     */
+    resolve(command: string, args?: string[]): Promise<CommandResolution>;
+    /**
+     * Resolve environment variables in a string
+     */
+    private resolveVariables;
+    /**
+     * Set environment variables
+     */
+    setEnv(env: Record<string, string>): void;
+    /**
+     * Set working directory
+     */
+    setCwd(cwd: string): void;
+}
+//# sourceMappingURL=CLICommandResolver.d.ts.map

package/dist/adapters/builtins/CLICommandResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CLICommandResolver.d.ts","sourceRoot":"","sources":["../../../src/adapters/builtins/CLICommandResolver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,KAAK,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,IAAI,EAAE,MAAM,EAAE,CAAC;IAEf;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,GAAG,CAAyB;gBAExB,GAAG,GAAE,MAAsB,EAAE,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM;IAKzE;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA4B/E;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAMxB;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAIzC;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;CAG1B"}

package/dist/adapters/builtins/CLICommandResolver.js

@@ -0,0 +1,63 @@
+/**
+ * CLI Command Resolver
+ *
+ * Resolves CLI commands with path resolution and environment setup.
+ */
+import path from 'node:path';
+export class CLICommandResolver {
+    cwd;
+    env;
+    constructor(cwd = process.cwd(), env = {}) {
+        this.cwd = cwd;
+        this.env = { ...process.env, ...env };
+    }
+    /**
+     * Resolve a CLI command
+     */
+    async resolve(command, args = []) {
+        // Try to find the command in PATH
+        let absolutePath;
+        let found = false;
+        // For now, assume command exists if it's in PATH or is a path
+        if (command.includes('/') || command.includes('\\')) {
+            const resolvedPath = path.resolve(this.cwd, command);
+            absolutePath = resolvedPath;
+            found = true;
+        }
+        else {
+            // Assume command is in PATH
+            absolutePath = command;
+            found = true;
+        }
+        // Resolve arguments (expand variables)
+        const resolvedArgs = args.map(arg => this.resolveVariables(arg));
+        return {
+            command: absolutePath || command,
+            found,
+            absolutePath,
+            args: resolvedArgs,
+            env: this.env,
+        };
+    }
+    /**
+     * Resolve environment variables in a string
+     */
+    resolveVariables(str) {
+        return str.replace(/\$\{?([A-Za-z_][A-Za-z0-9_]*)\}?/g, (match, varName) => {
+            return this.env[varName] || match;
+        });
+    }
+    /**
+     * Set environment variables
+     */
+    setEnv(env) {
+        this.env = { ...this.env, ...env };
+    }
+    /**
+     * Set working directory
+     */
+    setCwd(cwd) {
+        this.cwd = cwd;
+    }
+}
+//# sourceMappingURL=CLICommandResolver.js.map

package/dist/adapters/builtins/CLICommandResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CLICommandResolver.js","sourceRoot":"","sources":["../../../src/adapters/builtins/CLICommandResolver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AA6B7B,MAAM,OAAO,kBAAkB;IACrB,GAAG,CAAS;IACZ,GAAG,CAAyB;IAEpC,YAAY,MAAc,OAAO,CAAC,GAAG,EAAE,EAAE,MAA8B,EAAE;QACvE,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,EAA4B,CAAC;IAClE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,OAAe,EAAE,OAAiB,EAAE;QAChD,kCAAkC;QAClC,IAAI,YAAgC,CAAC;QACrC,IAAI,KAAK,GAAG,KAAK,CAAC;QAElB,8DAA8D;QAC9D,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACpD,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YACrD,YAAY,GAAG,YAAY,CAAC;YAC5B,KAAK,GAAG,IAAI,CAAC;QACf,CAAC;aAAM,CAAC;YACN,4BAA4B;YAC5B,YAAY,GAAG,OAAO,CAAC;YACvB,KAAK,GAAG,IAAI,CAAC;QACf,CAAC;QAED,uCAAuC;QACvC,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC;QAEjE,OAAO;YACL,OAAO,EAAE,YAAY,IAAI,OAAO;YAChC,KAAK;YACL,YAAY;YACZ,IAAI,EAAE,YAAY;YAClB,GAAG,EAAE,IAAI,CAAC,GAAG;SACd,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,GAAW;QAClC,OAAO,GAAG,CAAC,OAAO,CAAC,mCAAmC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;YACzE,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC;QACpC,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,GAA2B;QAChC,IAAI,CAAC,GAAG,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,GAAW;QAChB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;CACF"}

package/dist/adapters/builtins/CLIResultParser.d.ts

@@ -0,0 +1,61 @@
+/**
+ * CLI Result Parser
+ *
+ * Parses CLI command results and extracts structured data.
+ */
+export interface ParsedCLIResult<T = unknown> {
+    /**
+     * Parsed data
+     */
+    data: T;
+    /**
+     * Original stdout
+     */
+    stdout: string;
+    /**
+     * Original stderr
+     */
+    stderr: string;
+    /**
+     * Exit code
+     */
+    exitCode: number;
+    /**
+     * Parse errors (if any)
+     */
+    errors?: string[];
+}
+export type ResultParser<T = unknown> = (stdout: string, stderr: string, exitCode: number) => T;
+export declare class CLIResultParser {
+    /**
+     * Parse JSON output
+     */
+    static parseJSON<T = unknown>(stdout: string, stderr: string, exitCode: number): ParsedCLIResult<T>;
+    /**
+     * Parse line-separated output
+     */
+    static parseLines(stdout: string, stderr: string, exitCode: number): ParsedCLIResult<string[]>;
+    /**
+     * Parse key-value pairs (KEY=VALUE format)
+     */
+    static parseKeyValue(stdout: string, stderr: string, exitCode: number): ParsedCLIResult<Record<string, string>>;
+    /**
+     * Parse table output (whitespace-separated columns)
+     */
+    static parseTable(stdout: string, stderr: string, exitCode: number, options?: {
+        headers?: boolean;
+        delimiter?: RegExp;
+    }): ParsedCLIResult<Array<Record<string, string>>>;
+    /**
+     * Parse with custom parser function
+     */
+    static parseCustom<T>(stdout: string, stderr: string, exitCode: number, parser: ResultParser<T>): ParsedCLIResult<T>;
+    /**
+     * No parsing, return raw output
+     */
+    static parseRaw(stdout: string, stderr: string, exitCode: number): ParsedCLIResult<{
+        stdout: string;
+        stderr: string;
+    }>;
+}
+//# sourceMappingURL=CLIResultParser.d.ts.map

package/dist/adapters/builtins/CLIResultParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CLIResultParser.d.ts","sourceRoot":"","sources":["../../../src/adapters/builtins/CLIResultParser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,OAAO;IAC1C;;OAEG;IACH,IAAI,EAAE,CAAC,CAAC;IAER;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC,CAAC;AAEhG,qBAAa,eAAe;IAC1B;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC;IAanG;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,CAAC,MAAM,EAAE,CAAC;IAS9F;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAoB/G;;OAEG;IACH,MAAM,CAAC,UAAU,CACf,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GACtD,eAAe,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAmCjD;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,CAAC,EAClB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,GACtB,eAAe,CAAC,CAAC,CAAC;IAerB;;OAEG;IACH,MAAM,CAAC,QAAQ,CACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,eAAe,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAQvD"}

package/dist/adapters/builtins/CLIResultParser.js

@@ -0,0 +1,113 @@
+/**
+ * CLI Result Parser
+ *
+ * Parses CLI command results and extracts structured data.
+ */
+export class CLIResultParser {
+    /**
+     * Parse JSON output
+     */
+    static parseJSON(stdout, stderr, exitCode) {
+        const errors = [];
+        let data = {};
+        try {
+            data = JSON.parse(stdout);
+        }
+        catch (error) {
+            errors.push(`Failed to parse JSON: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        return { data, stdout, stderr, exitCode, errors };
+    }
+    /**
+     * Parse line-separated output
+     */
+    static parseLines(stdout, stderr, exitCode) {
+        const data = stdout
+            .split('\n')
+            .map(line => line.trim())
+            .filter(Boolean);
+        return { data, stdout, stderr, exitCode };
+    }
+    /**
+     * Parse key-value pairs (KEY=VALUE format)
+     */
+    static parseKeyValue(stdout, stderr, exitCode) {
+        const data = {};
+        const errors = [];
+        for (const line of stdout.split('\n')) {
+            const trimmed = line.trim();
+            if (!trimmed || trimmed.startsWith('#'))
+                continue;
+            const match = trimmed.match(/^([^=]+)=(.*)$/);
+            if (match) {
+                const [, key, value] = match;
+                data[key.trim()] = value.trim();
+            }
+            else {
+                errors.push(`Invalid key-value line: ${trimmed}`);
+            }
+        }
+        return { data, stdout, stderr, exitCode, errors };
+    }
+    /**
+     * Parse table output (whitespace-separated columns)
+     */
+    static parseTable(stdout, stderr, exitCode, options = {}) {
+        const { headers = true, delimiter = /\s{2,}|\t/ } = options;
+        const lines = stdout.split('\n').map(l => l.trim()).filter(Boolean);
+        if (lines.length === 0) {
+            return { data: [], stdout, stderr, exitCode };
+        }
+        let headerLine = [];
+        let dataLines = [];
+        if (headers && lines.length > 0) {
+            headerLine = lines[0].split(delimiter).map(h => h.trim());
+            dataLines = lines.slice(1);
+        }
+        else {
+            // Generate column names: col0, col1, ...
+            const firstRow = lines[0].split(delimiter);
+            headerLine = firstRow.map((_, i) => `col${i}`);
+            dataLines = lines;
+        }
+        const data = dataLines.map(line => {
+            const values = line.split(delimiter).map(v => v.trim());
+            const row = {};
+            for (let i = 0; i < headerLine.length; i++) {
+                row[headerLine[i]] = values[i] || '';
+            }
+            return row;
+        });
+        return { data, stdout, stderr, exitCode };
+    }
+    /**
+     * Parse with custom parser function
+     */
+    static parseCustom(stdout, stderr, exitCode, parser) {
+        try {
+            const data = parser(stdout, stderr, exitCode);
+            return { data, stdout, stderr, exitCode };
+        }
+        catch (error) {
+            return {
+                data: {},
+                stdout,
+                stderr,
+                exitCode,
+                errors: [error instanceof Error ? error.message : String(error)],
+            };
+        }
+    }
+    /**
+     * No parsing, return raw output
+     */
+    static parseRaw(stdout, stderr, exitCode) {
+        return {
+            data: { stdout, stderr },
+            stdout,
+            stderr,
+            exitCode,
+        };
+    }
+}
+//# sourceMappingURL=CLIResultParser.js.map

package/dist/adapters/builtins/CLIResultParser.js.map

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

package/dist/adapters/builtins/ConnectionManager.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Connection Manager
+ *
+ * Manages pooled connections to external services (databases, queues, etc.)
+ */
+export interface Connection {
+    /**
+     * Unique identifier for this connection
+     */
+    readonly id: string;
+    /**
+     * Check if connection is alive
+     */
+    isAlive(): Promise<boolean>;
+    /**
+     * Close the connection
+     */
+    close(): Promise<void>;
+}
+export interface ConnectionConfig {
+    /**
+     * Connection identifier
+     */
+    id: string;
+    /**
+     * Connection URL or configuration
+     */
+    url: string;
+    /**
+     * Maximum number of connections in pool
+     */
+    maxConnections?: number;
+    /**
+     * Idle timeout in milliseconds
+     */
+    idleTimeout?: number;
+    /**
+     * Connection timeout in milliseconds
+     */
+    connectionTimeout?: number;
+}
+export interface ConnectionFactory<T extends Connection> {
+    /**
+     * Create a new connection
+     */
+    create(config: ConnectionConfig): Promise<T>;
+}
+/**
+ * Connection Pool Manager
+ */
+export declare class ConnectionManager<T extends Connection> {
+    private pools;
+    private factory;
+    constructor(factory: ConnectionFactory<T>);
+    /**
+     * Get or create a connection pool
+     */
+    getPool(config: ConnectionConfig): Promise<ConnectionPool<T>>;
+    /**
+     * Get a connection from a pool
+     */
+    getConnection(id: string): Promise<T>;
+    /**
+     * Release a connection back to the pool
+     */
+    releaseConnection(id: string, connection: T): Promise<void>;
+    /**
+     * Close all connections and pools
+     */
+    closeAll(): Promise<void>;
+    /**
+     * Close a specific connection pool
+     */
+    closePool(id: string): Promise<void>;
+    /**
+     * Get statistics for all pools
+     */
+    getStats(): Record<string, {
+        active: number;
+        idle: number;
+        total: number;
+    }>;
+}
+/**
+ * Connection Pool
+ */
+export declare class ConnectionPool<T extends Connection> {
+    private factory;
+    private config;
+    private available;
+    private inUse;
+    private idleTimeouts;
+    constructor(factory: ConnectionFactory<T>, config: ConnectionConfig);
+    initialize(): Promise<void>;
+    acquire(): Promise<T>;
+    release(connection: T): void;
+    private setIdleTimeout;
+    private clearIdleTimeout;
+    close(): Promise<void>;
+    getStats(): {
+        active: number;
+        idle: number;
+        total: number;
+    };
+}
+//# sourceMappingURL=ConnectionManager.d.ts.map

package/dist/adapters/builtins/ConnectionManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectionManager.d.ts","sourceRoot":"","sources":["../../../src/adapters/builtins/ConnectionManager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAE5B;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,UAAU;IACrD;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC9C;AAED;;GAEG;AACH,qBAAa,iBAAiB,CAAC,CAAC,SAAS,UAAU;IACjD,OAAO,CAAC,KAAK,CAA6C;IAC1D,OAAO,CAAC,OAAO,CAAuB;gBAE1B,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAIzC;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IAYnE;;OAEG;IACG,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAS3C;;OAEG;IACG,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAOjE;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAO/B;;OAEG;IACG,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ1C;;OAEG;IACH,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAS5E;AAED;;GAEG;AACH,qBAAa,cAAc,CAAC,CAAC,SAAS,UAAU;IAC9C,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,SAAS,CAAW;IAC5B,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,YAAY,CAAqC;gBAE7C,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,gBAAgB;IAU7D,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC;IAqB3B,OAAO,CAAC,UAAU,EAAE,CAAC,GAAG,IAAI;IAQ5B,OAAO,CAAC,cAAc;IAatB,OAAO,CAAC,gBAAgB;IAQlB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAe5B,QAAQ,IAAI;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;CAO5D"}

package/dist/adapters/builtins/ConnectionManager.js

@@ -0,0 +1,162 @@
+/**
+ * Connection Manager
+ *
+ * Manages pooled connections to external services (databases, queues, etc.)
+ */
+/**
+ * Connection Pool Manager
+ */
+export class ConnectionManager {
+    pools = new Map();
+    factory;
+    constructor(factory) {
+        this.factory = factory;
+    }
+    /**
+     * Get or create a connection pool
+     */
+    async getPool(config) {
+        const poolId = config.id || config.url;
+        if (!this.pools.has(poolId)) {
+            const pool = new ConnectionPool(this.factory, config);
+            await pool.initialize();
+            this.pools.set(poolId, pool);
+        }
+        return this.pools.get(poolId);
+    }
+    /**
+     * Get a connection from a pool
+     */
+    async getConnection(id) {
+        const pool = this.pools.get(id);
+        if (!pool) {
+            throw new Error(`Connection pool not found: ${id}`);
+        }
+        return pool.acquire();
+    }
+    /**
+     * Release a connection back to the pool
+     */
+    async releaseConnection(id, connection) {
+        const pool = this.pools.get(id);
+        if (pool) {
+            pool.release(connection);
+        }
+    }
+    /**
+     * Close all connections and pools
+     */
+    async closeAll() {
+        for (const pool of this.pools.values()) {
+            await pool.close();
+        }
+        this.pools.clear();
+    }
+    /**
+     * Close a specific connection pool
+     */
+    async closePool(id) {
+        const pool = this.pools.get(id);
+        if (pool) {
+            await pool.close();
+            this.pools.delete(id);
+        }
+    }
+    /**
+     * Get statistics for all pools
+     */
+    getStats() {
+        const stats = {};
+        for (const [id, pool] of this.pools) {
+            stats[id] = pool.getStats();
+        }
+        return stats;
+    }
+}
+/**
+ * Connection Pool
+ */
+export class ConnectionPool {
+    factory;
+    config;
+    available = [];
+    inUse = new Set();
+    idleTimeouts = new Map();
+    constructor(factory, config) {
+        this.factory = factory;
+        this.config = {
+            ...config,
+            maxConnections: config.maxConnections || 10,
+            idleTimeout: config.idleTimeout || 60000,
+            connectionTimeout: config.connectionTimeout || 5000,
+        };
+    }
+    async initialize() {
+        // Pre-create one connection
+        const connection = await this.factory.create(this.config);
+        this.available.push(connection);
+    }
+    async acquire() {
+        // Try to get an available connection
+        if (this.available.length > 0) {
+            const connection = this.available.pop();
+            this.clearIdleTimeout(connection);
+            this.inUse.add(connection);
+            return connection;
+        }
+        // Create a new connection if under the limit
+        const totalConnections = this.available.length + this.inUse.size;
+        if (totalConnections < this.config.maxConnections) {
+            const connection = await this.factory.create(this.config);
+            this.inUse.add(connection);
+            return connection;
+        }
+        // Wait for a connection to become available
+        throw new Error('Connection pool exhausted');
+    }
+    release(connection) {
+        if (this.inUse.has(connection)) {
+            this.inUse.delete(connection);
+            this.available.push(connection);
+            this.setIdleTimeout(connection);
+        }
+    }
+    setIdleTimeout(connection) {
+        const timeout = setTimeout(async () => {
+            const index = this.available.indexOf(connection);
+            if (index !== -1) {
+                this.available.splice(index, 1);
+                await connection.close();
+            }
+            this.idleTimeouts.delete(connection);
+        }, this.config.idleTimeout);
+        this.idleTimeouts.set(connection, timeout);
+    }
+    clearIdleTimeout(connection) {
+        const timeout = this.idleTimeouts.get(connection);
+        if (timeout) {
+            clearTimeout(timeout);
+            this.idleTimeouts.delete(connection);
+        }
+    }
+    async close() {
+        // Clear all idle timeouts
+        for (const timeout of this.idleTimeouts.values()) {
+            clearTimeout(timeout);
+        }
+        this.idleTimeouts.clear();
+        // Close all connections
+        const allConnections = [...this.available, ...this.inUse];
+        await Promise.all(allConnections.map(conn => conn.close()));
+        this.available = [];
+        this.inUse.clear();
+    }
+    getStats() {
+        return {
+            active: this.inUse.size,
+            idle: this.available.length,
+            total: this.inUse.size + this.available.length,
+        };
+    }
+}
+//# sourceMappingURL=ConnectionManager.js.map

package/dist/adapters/builtins/ConnectionManager.js.map

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