@flowcore/pathways 0.2.1

package/esm/pathways/internal-pathway.state.d.ts

@@ -0,0 +1,41 @@
+import type { PathwayState } from "./types.js";
+/**
+ * Internal implementation of PathwayState interface that uses KV storage
+ * for tracking processed events to prevent duplicate processing
+ *
+ * @implements {PathwayState}
+ */
+export declare class InternalPathwayState implements PathwayState {
+    /**
+     * Default time-to-live for processed event records (5 minutes)
+     * @private
+     */
+    private static readonly DEFAULT_TTL_MS;
+    /**
+     * The KV adapter instance for storage
+     * @private
+     */
+    private kv;
+    /**
+     * Gets or initializes the KV adapter
+     *
+     * @private
+     * @returns {Promise<KvAdapter>} The KV adapter instance
+     */
+    private getKv;
+    /**
+     * Checks if an event has already been processed
+     *
+     * @param {string} eventId - The ID of the event to check
+     * @returns {Promise<boolean>} True if the event has been processed, false otherwise
+     */
+    isProcessed(eventId: string): Promise<boolean>;
+    /**
+     * Marks an event as processed
+     *
+     * @param {string} eventId - The ID of the event to mark as processed
+     * @returns {Promise<void>}
+     */
+    setProcessed(eventId: string): Promise<void>;
+}
+//# sourceMappingURL=internal-pathway.state.d.ts.map

package/esm/pathways/internal-pathway.state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-pathway.state.d.ts","sourceRoot":"","sources":["../../src/pathways/internal-pathway.state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;;GAKG;AACH,qBAAa,oBAAqB,YAAW,YAAY;IACvD;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAEvD;;;OAGG;IACH,OAAO,CAAC,EAAE,CAA0B;IAEpC;;;;;OAKG;YACW,KAAK;IAOnB;;;;;OAKG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMpD;;;;;OAKG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAInD"}

package/esm/pathways/internal-pathway.state.js

@@ -0,0 +1,64 @@
+import { createKvAdapter } from "./kv/kv-adapter.js";
+/**
+ * Internal implementation of PathwayState interface that uses KV storage
+ * for tracking processed events to prevent duplicate processing
+ *
+ * @implements {PathwayState}
+ */
+export class InternalPathwayState {
+    constructor() {
+        /**
+         * The KV adapter instance for storage
+         * @private
+         */
+        Object.defineProperty(this, "kv", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
+    }
+    /**
+     * Gets or initializes the KV adapter
+     *
+     * @private
+     * @returns {Promise<KvAdapter>} The KV adapter instance
+     */
+    async getKv() {
+        if (!this.kv) {
+            this.kv = await createKvAdapter();
+        }
+        return this.kv;
+    }
+    /**
+     * Checks if an event has already been processed
+     *
+     * @param {string} eventId - The ID of the event to check
+     * @returns {Promise<boolean>} True if the event has been processed, false otherwise
+     */
+    async isProcessed(eventId) {
+        const kv = await this.getKv();
+        const result = await kv.get(eventId);
+        return result === true;
+    }
+    /**
+     * Marks an event as processed
+     *
+     * @param {string} eventId - The ID of the event to mark as processed
+     * @returns {Promise<void>}
+     */
+    async setProcessed(eventId) {
+        const kv = await this.getKv();
+        await kv.set(eventId, true, InternalPathwayState.DEFAULT_TTL_MS);
+    }
+}
+/**
+ * Default time-to-live for processed event records (5 minutes)
+ * @private
+ */
+Object.defineProperty(InternalPathwayState, "DEFAULT_TTL_MS", {
+    enumerable: true,
+    configurable: true,
+    writable: true,
+    value: 5 * 60 * 1000
+}); // 5 minutes

package/esm/pathways/kv/bun-kv-adapter.d.ts

@@ -0,0 +1,36 @@
+import type { KvAdapter } from "./kv-adapter.js";
+/**
+ * KV adapter implementation for Bun runtime
+ *
+ * Uses Bun's SQLite-based key-value store for storage
+ *
+ * @implements {KvAdapter}
+ */
+export declare class BunKvAdapter implements KvAdapter {
+    /**
+     * The underlying Bun SQLite key-value store
+     * @private
+     */
+    private store;
+    /**
+     * Creates a new in-memory Bun KV adapter
+     */
+    constructor();
+    /**
+     * Retrieves a value from the Bun KV store
+     *
+     * @template T The expected type of the stored value
+     * @param {string} key The key to retrieve
+     * @returns {T | null} The stored value or null if not found
+     */
+    get<T>(key: string): T | null;
+    /**
+     * Stores a value in the Bun KV store with the specified TTL
+     *
+     * @param {string} key The key to store the value under
+     * @param {unknown} value The value to store
+     * @param {number} ttlMs Time-to-live in milliseconds
+     */
+    set(key: string, value: unknown, ttlMs: number): void;
+}
+//# sourceMappingURL=bun-kv-adapter.d.ts.map

package/esm/pathways/kv/bun-kv-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bun-kv-adapter.d.ts","sourceRoot":"","sources":["../../../src/pathways/kv/bun-kv-adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;;;;;GAMG;AACH,qBAAa,YAAa,YAAW,SAAS;IAC5C;;;OAGG;IACH,OAAO,CAAC,KAAK,CAAoB;IAEjC;;OAEG;;IAKH;;;;;;OAMG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAK7B;;;;;;OAMG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;CAGtD"}

package/esm/pathways/kv/bun-kv-adapter.js

@@ -0,0 +1,47 @@
+import { BunSqliteKeyValue } from "bun-sqlite-key-value";
+/**
+ * KV adapter implementation for Bun runtime
+ *
+ * Uses Bun's SQLite-based key-value store for storage
+ *
+ * @implements {KvAdapter}
+ */
+export class BunKvAdapter {
+    /**
+     * Creates a new in-memory Bun KV adapter
+     */
+    constructor() {
+        /**
+         * The underlying Bun SQLite key-value store
+         * @private
+         */
+        Object.defineProperty(this, "store", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.store = new BunSqliteKeyValue(":memory:");
+    }
+    /**
+     * Retrieves a value from the Bun KV store
+     *
+     * @template T The expected type of the stored value
+     * @param {string} key The key to retrieve
+     * @returns {T | null} The stored value or null if not found
+     */
+    get(key) {
+        const value = this.store.get(key);
+        return value;
+    }
+    /**
+     * Stores a value in the Bun KV store with the specified TTL
+     *
+     * @param {string} key The key to store the value under
+     * @param {unknown} value The value to store
+     * @param {number} ttlMs Time-to-live in milliseconds
+     */
+    set(key, value, ttlMs) {
+        this.store.set(key, value, ttlMs);
+    }
+}

package/esm/pathways/kv/kv-adapter.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Interface for key-value storage adapters
+ *
+ * Provides a common interface for different KV storage implementations
+ * that can be used for storing pathway state.
+ */
+export interface KvAdapter {
+    /**
+     * Retrieves a value from storage by key
+     *
+     * @template T The expected type of the stored value
+     * @param {string} key The key to retrieve
+     * @returns {(Promise<T | null> | T | null)} The stored value or null if not found
+     */
+    get<T>(key: string): (Promise<T | null> | T | null);
+    /**
+     * Stores a value in storage with the specified key and TTL
+     *
+     * @param {string} key The key to store the value under
+     * @param {unknown} value The value to store
+     * @param {number} ttlMs Time-to-live in milliseconds
+     * @returns {(Promise<void> | void)}
+     */
+    set(key: string, value: unknown, ttlMs: number): (Promise<void> | void);
+}
+/**
+ * Creates an appropriate KV adapter based on the runtime environment
+ *
+ * Attempts to use Bun KV adapter if running in Bun, falls back to Node adapter otherwise
+ *
+ * @returns {Promise<KvAdapter>} A KV adapter instance
+ */
+export declare function createKvAdapter(): Promise<KvAdapter>;
+//# sourceMappingURL=kv-adapter.d.ts.map

package/esm/pathways/kv/kv-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kv-adapter.d.ts","sourceRoot":"","sources":["../../../src/pathways/kv/kv-adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB;;;;;;OAMG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IAEpD;;;;;;;OAOG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;CACzE;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,SAAS,CAAC,CAU1D"}

package/esm/pathways/kv/kv-adapter.js

@@ -0,0 +1,19 @@
+/**
+ * Creates an appropriate KV adapter based on the runtime environment
+ *
+ * Attempts to use Bun KV adapter if running in Bun, falls back to Node adapter otherwise
+ *
+ * @returns {Promise<KvAdapter>} A KV adapter instance
+ */
+export async function createKvAdapter() {
+    try {
+        // Try to import Bun adapter
+        const { BunKvAdapter } = await import("./bun-kv-adapter.js");
+        return new BunKvAdapter();
+    }
+    catch {
+        // Default to node-cache if Bun is not available
+        const { NodeKvAdapter } = await import("./node-kv-adapter.js");
+        return new NodeKvAdapter();
+    }
+}

package/esm/pathways/kv/node-kv-adapter.d.ts

@@ -0,0 +1,33 @@
+import type { KvAdapter } from "./kv-adapter.js";
+/**
+ * KV adapter implementation for Node.js runtime
+ *
+ * Uses node-cache for in-memory key-value storage
+ *
+ * @implements {KvAdapter}
+ */
+export declare class NodeKvAdapter implements KvAdapter {
+    /**
+     * The underlying Node.js cache instance
+     * @private
+     */
+    private readonly kv;
+    /**
+     * Retrieves a value from the Node.js cache
+     *
+     * @template T The expected type of the stored value
+     * @param {string} key The key to retrieve
+     * @returns {Promise<T | null>} The stored value or null if not found
+     */
+    get<T>(key: string): Promise<T | null>;
+    /**
+     * Stores a value in the Node.js cache with the specified TTL
+     *
+     * @param {string} key The key to store the value under
+     * @param {unknown} value The value to store
+     * @param {number} ttlMs Time-to-live in milliseconds
+     * @returns {Promise<void>}
+     */
+    set(key: string, value: unknown, ttlMs: number): Promise<void>;
+}
+//# sourceMappingURL=node-kv-adapter.d.ts.map

package/esm/pathways/kv/node-kv-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-kv-adapter.d.ts","sourceRoot":"","sources":["../../../src/pathways/kv/node-kv-adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;;;;;GAMG;AACH,qBAAa,aAAc,YAAW,SAAS;IAC7C;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAmB;IAEtC;;;;;;OAMG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAK5C;;;;;;;OAOG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGrE"}

package/esm/pathways/kv/node-kv-adapter.js

@@ -0,0 +1,44 @@
+import NodeCache from "node-cache";
+/**
+ * KV adapter implementation for Node.js runtime
+ *
+ * Uses node-cache for in-memory key-value storage
+ *
+ * @implements {KvAdapter}
+ */
+export class NodeKvAdapter {
+    constructor() {
+        /**
+         * The underlying Node.js cache instance
+         * @private
+         */
+        Object.defineProperty(this, "kv", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new NodeCache()
+        });
+    }
+    /**
+     * Retrieves a value from the Node.js cache
+     *
+     * @template T The expected type of the stored value
+     * @param {string} key The key to retrieve
+     * @returns {Promise<T | null>} The stored value or null if not found
+     */
+    async get(key) {
+        const result = await this.kv.get(key);
+        return result ?? null;
+    }
+    /**
+     * Stores a value in the Node.js cache with the specified TTL
+     *
+     * @param {string} key The key to store the value under
+     * @param {unknown} value The value to store
+     * @param {number} ttlMs Time-to-live in milliseconds
+     * @returns {Promise<void>}
+     */
+    async set(key, value, ttlMs) {
+        await this.kv.set(key, value, (ttlMs / 1000));
+    }
+}

package/esm/pathways/logger.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Logger interface that can be implemented by users to capture logs from pathways
+ */
+export interface Logger {
+    /**
+     * Log debug information
+     * @param message The message to log
+     * @param context Optional context data to include
+     */
+    debug(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Log informational messages
+     * @param message The message to log
+     * @param context Optional context data to include
+     */
+    info(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Log warning messages
+     * @param message The message to log
+     * @param context Optional context data to include
+     */
+    warn(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Log error messages
+     * @param message The message to log
+     * @param context Optional context data to include
+     */
+    error(message: string, context?: Record<string, unknown>): void;
+}
+/**
+ * A default console logger that logs to the console
+ */
+export declare class ConsoleLogger implements Logger {
+    debug(message: string, context?: Record<string, unknown>): void;
+    info(message: string, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+    error(message: string, context?: Record<string, unknown>): void;
+}
+/**
+ * A no-operation logger that does nothing
+ */
+export declare class NoopLogger implements Logger {
+    debug(_message: string, _context?: Record<string, unknown>): void;
+    info(_message: string, _context?: Record<string, unknown>): void;
+    warn(_message: string, _context?: Record<string, unknown>): void;
+    error(_message: string, _context?: Record<string, unknown>): void;
+}
+//# sourceMappingURL=logger.d.ts.map

package/esm/pathways/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/pathways/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IAE/D;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IAE9D;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IAE9D;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;CAChE;AAED;;GAEG;AACH,qBAAa,aAAc,YAAW,MAAM;IAC1C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAGhE;AAED;;GAEG;AACH,qBAAa,UAAW,YAAW,MAAM;IACvC,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IACjE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAChE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAChE,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAClE"}

package/esm/pathways/logger.js

@@ -0,0 +1,26 @@
+/**
+ * A default console logger that logs to the console
+ */
+export class ConsoleLogger {
+    debug(message, context) {
+        console.debug(message, context ? JSON.stringify(context) : '');
+    }
+    info(message, context) {
+        console.info(message, context ? JSON.stringify(context) : '');
+    }
+    warn(message, context) {
+        console.warn(message, context ? JSON.stringify(context) : '');
+    }
+    error(message, context) {
+        console.error(message, context ? JSON.stringify(context) : '');
+    }
+}
+/**
+ * A no-operation logger that does nothing
+ */
+export class NoopLogger {
+    debug(_message, _context) { }
+    info(_message, _context) { }
+    warn(_message, _context) { }
+    error(_message, _context) { }
+}

package/esm/pathways/postgres/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * PostgreSQL integration for Flowcore Pathways
+ *
+ * This module exports components for using PostgreSQL as a storage backend
+ * for pathway state and other persistent data.
+ */
+export * from "./postgres-adapter.js";
+export * from "./postgres-pathway-state.js";
+//# sourceMappingURL=index.d.ts.map

package/esm/pathways/postgres/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/pathways/postgres/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC"}

package/esm/pathways/postgres/index.js

@@ -0,0 +1,8 @@
+/**
+ * PostgreSQL integration for Flowcore Pathways
+ *
+ * This module exports components for using PostgreSQL as a storage backend
+ * for pathway state and other persistent data.
+ */
+export * from "./postgres-adapter.js";
+export * from "./postgres-pathway-state.js";

package/esm/pathways/postgres/postgres-adapter.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Configuration options for PostgreSQL connection
+ *
+ * @interface PostgresConfig
+ */
+export interface PostgresConfig {
+    /** PostgreSQL server hostname */
+    host: string;
+    /** PostgreSQL server port */
+    port: number;
+    /** PostgreSQL username */
+    user: string;
+    /** PostgreSQL password */
+    password: string;
+    /** PostgreSQL database name */
+    database: string;
+    /** Whether to use SSL for the connection */
+    ssl?: boolean;
+}
+/**
+ * Interface for PostgreSQL database operations
+ *
+ * Provides methods for connecting, querying, and executing SQL statements
+ *
+ * @interface PostgresAdapter
+ */
+export interface PostgresAdapter {
+    /**
+     * Establishes a connection to the PostgreSQL database
+     * @returns {Promise<void>}
+     */
+    connect(): Promise<void>;
+    /**
+     * Closes the connection to the PostgreSQL database
+     * @returns {Promise<void>}
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Executes a SQL query and returns the results
+     * @template T The expected result type
+     * @param {string} sql The SQL query to execute
+     * @param {unknown[]} [params] Optional parameters for the query
+     * @returns {Promise<T>} The query results
+     */
+    query<T>(sql: string, params?: unknown[]): Promise<T>;
+    /**
+     * Executes a SQL statement without returning results
+     * @param {string} sql The SQL statement to execute
+     * @param {unknown[]} [params] Optional parameters for the statement
+     * @returns {Promise<void>}
+     */
+    execute(sql: string, params?: unknown[]): Promise<void>;
+}
+/**
+ * Implementation of PostgresAdapter using the postgres.js library
+ *
+ * @implements {PostgresAdapter}
+ */
+export declare class PostgresJsAdapter implements PostgresAdapter {
+    /** The postgres.js client factory function */
+    private postgres;
+    /** The active postgres.js client */
+    private sql;
+    /** The PostgreSQL configuration */
+    private config;
+    /** The connection string built from the configuration */
+    private connectionString;
+    /**
+     * Creates a new PostgresJsAdapter instance
+     *
+     * @param {PostgresConfig} config The PostgreSQL connection configuration
+     */
+    constructor(config: PostgresConfig);
+    /**
+     * Establishes a connection to the PostgreSQL database
+     *
+     * @returns {Promise<void>}
+     * @throws {Error} If connection fails
+     */
+    connect(): Promise<void>;
+    /**
+     * Closes the connection to the PostgreSQL database
+     *
+     * @returns {Promise<void>}
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Executes a SQL query and returns the results
+     *
+     * @template T The expected result type
+     * @param {string} sql The SQL query to execute
+     * @param {unknown[]} [params=[]] Optional parameters for the query
+     * @returns {Promise<T>} The query results
+     */
+    query<T>(sql: string, params?: unknown[]): Promise<T>;
+    /**
+     * Executes a SQL statement without returning results
+     *
+     * @param {string} sql The SQL statement to execute
+     * @param {unknown[]} [params=[]] Optional parameters for the statement
+     * @returns {Promise<void>}
+     */
+    execute(sql: string, params?: unknown[]): Promise<void>;
+}
+/**
+ * Creates and initializes a PostgreSQL adapter
+ *
+ * @param {PostgresConfig} config The PostgreSQL connection configuration
+ * @returns {Promise<PostgresAdapter>} An initialized PostgreSQL adapter
+ */
+export declare function createPostgresAdapter(config: PostgresConfig): Promise<PostgresAdapter>;
+//# sourceMappingURL=postgres-adapter.d.ts.map

package/esm/pathways/postgres/postgres-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-adapter.d.ts","sourceRoot":"","sources":["../../../src/pathways/postgres/postgres-adapter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB;;;OAGG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B;;;;;;OAMG;IACH,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAEtD;;;;;OAKG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzD;AAoBD;;;;GAIG;AACH,qBAAa,iBAAkB,YAAW,eAAe;IACvD,8CAA8C;IAC9C,OAAO,CAAC,QAAQ,CAA+D;IAC/E,oCAAoC;IACpC,OAAO,CAAC,GAAG,CAA+B;IAC1C,mCAAmC;IACnC,OAAO,CAAC,MAAM,CAAiB;IAC/B,yDAAyD;IACzD,OAAO,CAAC,gBAAgB,CAAS;IAEjC;;;;OAIG;gBACS,MAAM,EAAE,cAAc;IAQlC;;;;;OAKG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAW9B;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAOjC;;;;;;;OAOG;IACG,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,EAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAO/D;;;;;;OAMG;IACG,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,EAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAMlE;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAI5F"}

package/esm/pathways/postgres/postgres-adapter.js

@@ -0,0 +1,113 @@
+/**
+ * Implementation of PostgresAdapter using the postgres.js library
+ *
+ * @implements {PostgresAdapter}
+ */
+export class PostgresJsAdapter {
+    /**
+     * Creates a new PostgresJsAdapter instance
+     *
+     * @param {PostgresConfig} config The PostgreSQL connection configuration
+     */
+    constructor(config) {
+        /** The postgres.js client factory function */
+        Object.defineProperty(this, "postgres", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
+        /** The active postgres.js client */
+        Object.defineProperty(this, "sql", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
+        /** The PostgreSQL configuration */
+        Object.defineProperty(this, "config", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /** The connection string built from the configuration */
+        Object.defineProperty(this, "connectionString", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.config = config;
+        this.connectionString = `postgres://${config.user}:${config.password}@${config.host}:${config.port}/${config.database}`;
+        if (config.ssl) {
+            this.connectionString += "?sslmode=require";
+        }
+    }
+    /**
+     * Establishes a connection to the PostgreSQL database
+     *
+     * @returns {Promise<void>}
+     * @throws {Error} If connection fails
+     */
+    async connect() {
+        try {
+            const module = await import("postgres");
+            this.postgres = module.default;
+            this.sql = this.postgres(this.connectionString);
+        }
+        catch (error) {
+            console.error("Failed to connect to PostgreSQL:", error);
+            throw error;
+        }
+    }
+    /**
+     * Closes the connection to the PostgreSQL database
+     *
+     * @returns {Promise<void>}
+     */
+    async disconnect() {
+        if (this.sql) {
+            await this.sql.end();
+            this.sql = null;
+        }
+    }
+    /**
+     * Executes a SQL query and returns the results
+     *
+     * @template T The expected result type
+     * @param {string} sql The SQL query to execute
+     * @param {unknown[]} [params=[]] Optional parameters for the query
+     * @returns {Promise<T>} The query results
+     */
+    async query(sql, params = []) {
+        if (!this.sql) {
+            await this.connect();
+        }
+        return await this.sql.unsafe(sql, params);
+    }
+    /**
+     * Executes a SQL statement without returning results
+     *
+     * @param {string} sql The SQL statement to execute
+     * @param {unknown[]} [params=[]] Optional parameters for the statement
+     * @returns {Promise<void>}
+     */
+    async execute(sql, params = []) {
+        if (!this.sql) {
+            await this.connect();
+        }
+        await this.sql.unsafe(sql, params);
+    }
+}
+/**
+ * Creates and initializes a PostgreSQL adapter
+ *
+ * @param {PostgresConfig} config The PostgreSQL connection configuration
+ * @returns {Promise<PostgresAdapter>} An initialized PostgreSQL adapter
+ */
+export async function createPostgresAdapter(config) {
+    const adapter = new PostgresJsAdapter(config);
+    await adapter.connect();
+    return adapter;
+}