@flowcore/pathways 0.2.3 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.3.0](https://github.com/flowcore-io/flowcore-pathways/compare/v0.2.4...v0.3.0) (2025-03-15)
+
+
+### Features
+
+* **postgres:** :sparkles: Enhance PostgreSQL configuration with connection string support ([9b51155](https://github.com/flowcore-io/flowcore-pathways/commit/9b51155eaa8f11c5ca3e8f6422d2b4268c4f27ea))
+
+## [0.2.4](https://github.com/flowcore-io/flowcore-pathways/compare/v0.2.3...v0.2.4) (2025-03-15)
+
+
+### Bug Fixes
+
+* **logger:** :art: Update error method signatures and improve JSDoc documentation ([07ab772](https://github.com/flowcore-io/flowcore-pathways/commit/07ab77237c7aa88f6bc5999ff95148873c2e45d0))
+
 ## [0.2.3](https://github.com/flowcore-io/flowcore-pathways/compare/v0.2.2...v0.2.3) (2025-03-15)
 
 

package/esm/pathways/logger.d.ts

@@ -31,12 +31,15 @@ export interface Logger {
      */
     warn(message: string, context?: LoggerMeta): void;
     /**
-     * Log error messages
-     * @param message The message to log
-     * @param error Optional error object
-     * @param context Optional context data to include
+     * Log error messages - supports two different method signatures:
+     * 1. error(message: string, error?: Error, context?: LoggerMeta)
+     * 2. error(messageOrError: string | Error, meta?: LoggerMeta)
+     *
+     * @param messageOrError The message to log or Error object
+     * @param errorOrContext Optional error object or context data
+     * @param context Optional context data (only for signature 1)
      */
-    error(message: string, error?: Error, context?: LoggerMeta): void;
+    error(messageOrError: string | Error, errorOrContext?: Error | LoggerMeta, context?: LoggerMeta): void;
 }
 /**
  * A default console logger that logs to the console
@@ -62,11 +65,15 @@ export declare class ConsoleLogger implements Logger {
     warn(message: string, context?: LoggerMeta): void;
     /**
      * Log error messages to the console
-     * @param message The message to log
-     * @param error Optional error object
-     * @param context Optional context data to include
+     * Supports both signature formats:
+     * 1. error(message: string, error?: Error, context?: LoggerMeta)
+     * 2. error(messageOrError: string | Error, meta?: LoggerMeta)
+     *
+     * @param messageOrError The message to log or Error object
+     * @param errorOrContext Optional error object or context data
+     * @param context Optional context data (only for signature 1)
      */
-    error(message: string, error?: Error, context?: LoggerMeta): void;
+    error(messageOrError: string | Error, errorOrContext?: Error | LoggerMeta, context?: LoggerMeta): void;
 }
 /**
  * A no-operation logger that does nothing
@@ -92,10 +99,12 @@ export declare class NoopLogger implements Logger {
     warn(_message: string, _context?: LoggerMeta): void;
     /**
      * No-op error log
-     * @param _message The message to log (ignored)
-     * @param _error Optional error object (ignored)
+     * Supports both signature formats
+     *
+     * @param _messageOrError The message to log or Error object (ignored)
+     * @param _errorOrContext Optional error object or context data (ignored)
      * @param _context Optional context data (ignored)
      */
-    error(_message: string, _error?: Error, _context?: LoggerMeta): void;
+    error(_messageOrError: string | Error, _errorOrContext?: Error | LoggerMeta, _context?: LoggerMeta): void;
 }
 //# sourceMappingURL=logger.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/pathways/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;IACtB,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,OAAO,CAAC,EAAE,KAAK,CAAA;IACf,SAAS,CAAC,EAAE,KAAK,CAAA;CAClB;AAED,MAAM,WAAW,MAAM;IACrB;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;IAElD;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;IAEjD;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;IAEjD;;;;;OAKG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;CAClE;AAED;;GAEG;AACH,qBAAa,aAAc,YAAW,MAAM;IAC1C;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIlD;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIjD;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIjD;;;;;OAKG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;CAGlE;AAED;;GAEG;AACH,qBAAa,UAAW,YAAW,MAAM;IACvC;;;;OAIG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,UAAU,GAAG,IAAI;IAEpD;;;;OAIG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,UAAU,GAAG,IAAI;IAEnD;;;;OAIG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,UAAU,GAAG,IAAI;IAEnD;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,EAAE,UAAU,GAAG,IAAI;CACrE"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/pathways/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;IACtB,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,OAAO,CAAC,EAAE,KAAK,CAAA;IACf,SAAS,CAAC,EAAE,KAAK,CAAA;CAClB;AAED,MAAM,WAAW,MAAM;IACrB;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;IAElD;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;IAEjD;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;IAEjD;;;;;;;;OAQG;IACH,KAAK,CAAC,cAAc,EAAE,MAAM,GAAG,KAAK,EAAE,cAAc,CAAC,EAAE,KAAK,GAAG,UAAU,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;CACvG;AAED;;GAEG;AACH,qBAAa,aAAc,YAAW,MAAM;IAC1C;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIlD;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIjD;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIjD;;;;;;;;;OASG;IACH,KAAK,CAAC,cAAc,EAAE,MAAM,GAAG,KAAK,EAAE,cAAc,CAAC,EAAE,KAAK,GAAG,UAAU,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;CAcvG;AAED;;GAEG;AACH,qBAAa,UAAW,YAAW,MAAM;IACvC;;;;OAIG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,UAAU,GAAG,IAAI;IAEpD;;;;OAIG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,UAAU,GAAG,IAAI;IAEnD;;;;OAIG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,UAAU,GAAG,IAAI;IAEnD;;;;;;;OAOG;IACH,KAAK,CAAC,eAAe,EAAE,MAAM,GAAG,KAAK,EAAE,eAAe,CAAC,EAAE,KAAK,GAAG,UAAU,EAAE,QAAQ,CAAC,EAAE,UAAU,GAAG,IAAI;CAC1G"}

package/esm/pathways/logger.js

@@ -31,12 +31,29 @@ export class ConsoleLogger {
     }
     /**
      * Log error messages to the console
-     * @param message The message to log
-     * @param error Optional error object
-     * @param context Optional context data to include
+     * Supports both signature formats:
+     * 1. error(message: string, error?: Error, context?: LoggerMeta)
+     * 2. error(messageOrError: string | Error, meta?: LoggerMeta)
+     *
+     * @param messageOrError The message to log or Error object
+     * @param errorOrContext Optional error object or context data
+     * @param context Optional context data (only for signature 1)
      */
-    error(message, error, context) {
-        console.error(message, error, context ? JSON.stringify(context) : '');
+    error(messageOrError, errorOrContext, context) {
+        if (typeof messageOrError === 'string') {
+            if (errorOrContext instanceof Error) {
+                // Signature 1: error(message: string, error: Error, context?: LoggerMeta)
+                console.error(messageOrError, errorOrContext, context ? JSON.stringify(context) : '');
+            }
+            else {
+                // Signature 1 (no error) or Signature 2: error(message: string, context?: LoggerMeta)
+                console.error(messageOrError, errorOrContext ? JSON.stringify(errorOrContext) : '');
+            }
+        }
+        else {
+            // Signature 2: error(error: Error, context?: LoggerMeta)
+            console.error(messageOrError, errorOrContext ? JSON.stringify(errorOrContext) : '');
+        }
     }
 }
 /**
@@ -63,9 +80,11 @@ export class NoopLogger {
     warn(_message, _context) { }
     /**
      * No-op error log
-     * @param _message The message to log (ignored)
-     * @param _error Optional error object (ignored)
+     * Supports both signature formats
+     *
+     * @param _messageOrError The message to log or Error object (ignored)
+     * @param _errorOrContext Optional error object or context data (ignored)
      * @param _context Optional context data (ignored)
      */
-    error(_message, _error, _context) { }
+    error(_messageOrError, _errorOrContext, _context) { }
 }

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

@@ -1,7 +1,23 @@
 /**
- * Configuration options for PostgreSQL connection
+ * Configuration for PostgreSQL connection using a connection string
+ */
+export interface PostgresConnectionStringConfig {
+    /** Complete PostgreSQL connection string (e.g., postgres://user:password@host:port/database?sslmode=require) */
+    connectionString: string;
+    /** These properties are not used when a connection string is provided */
+    host?: never;
+    port?: never;
+    user?: never;
+    password?: never;
+    database?: never;
+    ssl?: never;
+}
+/**
+ * Configuration for PostgreSQL connection using individual parameters
  */
-export interface PostgresConfig {
+export interface PostgresParametersConfig {
+    /** Not used when individual parameters are provided */
+    connectionString?: never;
     /** PostgreSQL server hostname */
     host: string;
     /** PostgreSQL server port */
@@ -15,6 +31,14 @@ export interface PostgresConfig {
     /** Whether to use SSL for the connection */
     ssl?: boolean;
 }
+/**
+ * Configuration options for PostgreSQL connection
+ *
+ * Can provide either:
+ * 1. A complete connection string, or
+ * 2. Individual connection parameters (host, port, user, etc.)
+ */
+export type PostgresConfig = PostgresConnectionStringConfig | PostgresParametersConfig;
 /**
  * Interface for PostgreSQL database operations
  *
@@ -96,7 +120,7 @@ export declare class PostgresJsAdapter implements PostgresAdapter {
 /**
  * Creates and initializes a PostgreSQL adapter
  *
- * @param config The PostgreSQL connection configuration
+ * @param config The PostgreSQL connection configuration (either connectionString or individual parameters)
  * @returns An initialized PostgreSQL adapter
  */
 export declare function createPostgresAdapter(config: PostgresConfig): Promise<PostgresAdapter>;

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

@@ -1 +1 @@
-{"version":3,"file":"postgres-adapter.d.ts","sourceRoot":"","sources":["../../../src/pathways/postgres/postgres-adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;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;;;;GAIG;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;;GAEG;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;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAOjC;;;;;;OAMG;IACG,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,EAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAO/D;;;;;OAKG;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"}
+{"version":3,"file":"postgres-adapter.d.ts","sourceRoot":"","sources":["../../../src/pathways/postgres/postgres-adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C,gHAAgH;IAChH,gBAAgB,EAAE,MAAM,CAAC;IAEzB,yEAAyE;IACzE,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,QAAQ,CAAC,EAAE,KAAK,CAAC;IACjB,QAAQ,CAAC,EAAE,KAAK,CAAC;IACjB,GAAG,CAAC,EAAE,KAAK,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,uDAAuD;IACvD,gBAAgB,CAAC,EAAE,KAAK,CAAC;IAEzB,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,MAAM,cAAc,GAAG,8BAA8B,GAAG,wBAAwB,CAAC;AAEvF;;;;GAIG;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;;GAEG;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;IAelC;;;;;OAKG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAW9B;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAOjC;;;;;;OAMG;IACG,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,EAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAO/D;;;;;OAKG;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

@@ -37,9 +37,16 @@ export class PostgresJsAdapter {
             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";
+        if ('connectionString' in config && config.connectionString) {
+            // Use the provided connection string directly
+            this.connectionString = config.connectionString;
+        }
+        else {
+            // Build connection string from individual parameters
+            this.connectionString = `postgres://${config.user}:${config.password}@${config.host}:${config.port}/${config.database}`;
+            if (config.ssl) {
+                this.connectionString += "?sslmode=require";
+            }
         }
     }
     /**
@@ -98,7 +105,7 @@ export class PostgresJsAdapter {
 /**
  * Creates and initializes a PostgreSQL adapter
  *
- * @param config The PostgreSQL connection configuration
+ * @param config The PostgreSQL connection configuration (either connectionString or individual parameters)
  * @returns An initialized PostgreSQL adapter
  */
 export async function createPostgresAdapter(config) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flowcore/pathways",
-  "version": "0.2.3",
+  "version": "0.3.0",
   "description": "A TypeScript Library for creating Flowcore Pathways, simplifying the integration with the flowcore platform",
   "homepage": "https://github.com/flowcore-io/flowcore-sdk#readme",
   "repository": {

package/script/pathways/logger.d.ts

@@ -31,12 +31,15 @@ export interface Logger {
      */
     warn(message: string, context?: LoggerMeta): void;
     /**
-     * Log error messages
-     * @param message The message to log
-     * @param error Optional error object
-     * @param context Optional context data to include
+     * Log error messages - supports two different method signatures:
+     * 1. error(message: string, error?: Error, context?: LoggerMeta)
+     * 2. error(messageOrError: string | Error, meta?: LoggerMeta)
+     *
+     * @param messageOrError The message to log or Error object
+     * @param errorOrContext Optional error object or context data
+     * @param context Optional context data (only for signature 1)
      */
-    error(message: string, error?: Error, context?: LoggerMeta): void;
+    error(messageOrError: string | Error, errorOrContext?: Error | LoggerMeta, context?: LoggerMeta): void;
 }
 /**
  * A default console logger that logs to the console
@@ -62,11 +65,15 @@ export declare class ConsoleLogger implements Logger {
     warn(message: string, context?: LoggerMeta): void;
     /**
      * Log error messages to the console
-     * @param message The message to log
-     * @param error Optional error object
-     * @param context Optional context data to include
+     * Supports both signature formats:
+     * 1. error(message: string, error?: Error, context?: LoggerMeta)
+     * 2. error(messageOrError: string | Error, meta?: LoggerMeta)
+     *
+     * @param messageOrError The message to log or Error object
+     * @param errorOrContext Optional error object or context data
+     * @param context Optional context data (only for signature 1)
      */
-    error(message: string, error?: Error, context?: LoggerMeta): void;
+    error(messageOrError: string | Error, errorOrContext?: Error | LoggerMeta, context?: LoggerMeta): void;
 }
 /**
  * A no-operation logger that does nothing
@@ -92,10 +99,12 @@ export declare class NoopLogger implements Logger {
     warn(_message: string, _context?: LoggerMeta): void;
     /**
      * No-op error log
-     * @param _message The message to log (ignored)
-     * @param _error Optional error object (ignored)
+     * Supports both signature formats
+     *
+     * @param _messageOrError The message to log or Error object (ignored)
+     * @param _errorOrContext Optional error object or context data (ignored)
      * @param _context Optional context data (ignored)
      */
-    error(_message: string, _error?: Error, _context?: LoggerMeta): void;
+    error(_messageOrError: string | Error, _errorOrContext?: Error | LoggerMeta, _context?: LoggerMeta): void;
 }
 //# sourceMappingURL=logger.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/pathways/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;IACtB,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,OAAO,CAAC,EAAE,KAAK,CAAA;IACf,SAAS,CAAC,EAAE,KAAK,CAAA;CAClB;AAED,MAAM,WAAW,MAAM;IACrB;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;IAElD;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;IAEjD;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;IAEjD;;;;;OAKG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;CAClE;AAED;;GAEG;AACH,qBAAa,aAAc,YAAW,MAAM;IAC1C;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIlD;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIjD;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIjD;;;;;OAKG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;CAGlE;AAED;;GAEG;AACH,qBAAa,UAAW,YAAW,MAAM;IACvC;;;;OAIG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,UAAU,GAAG,IAAI;IAEpD;;;;OAIG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,UAAU,GAAG,IAAI;IAEnD;;;;OAIG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,UAAU,GAAG,IAAI;IAEnD;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,EAAE,UAAU,GAAG,IAAI;CACrE"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/pathways/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;IACtB,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,OAAO,CAAC,EAAE,KAAK,CAAA;IACf,SAAS,CAAC,EAAE,KAAK,CAAA;CAClB;AAED,MAAM,WAAW,MAAM;IACrB;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;IAElD;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;IAEjD;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;IAEjD;;;;;;;;OAQG;IACH,KAAK,CAAC,cAAc,EAAE,MAAM,GAAG,KAAK,EAAE,cAAc,CAAC,EAAE,KAAK,GAAG,UAAU,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;CACvG;AAED;;GAEG;AACH,qBAAa,aAAc,YAAW,MAAM;IAC1C;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIlD;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIjD;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAIjD;;;;;;;;;OASG;IACH,KAAK,CAAC,cAAc,EAAE,MAAM,GAAG,KAAK,EAAE,cAAc,CAAC,EAAE,KAAK,GAAG,UAAU,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;CAcvG;AAED;;GAEG;AACH,qBAAa,UAAW,YAAW,MAAM;IACvC;;;;OAIG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,UAAU,GAAG,IAAI;IAEpD;;;;OAIG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,UAAU,GAAG,IAAI;IAEnD;;;;OAIG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,UAAU,GAAG,IAAI;IAEnD;;;;;;;OAOG;IACH,KAAK,CAAC,eAAe,EAAE,MAAM,GAAG,KAAK,EAAE,eAAe,CAAC,EAAE,KAAK,GAAG,UAAU,EAAE,QAAQ,CAAC,EAAE,UAAU,GAAG,IAAI;CAC1G"}

package/script/pathways/logger.js

@@ -34,12 +34,29 @@ class ConsoleLogger {
     }
     /**
      * Log error messages to the console
-     * @param message The message to log
-     * @param error Optional error object
-     * @param context Optional context data to include
+     * Supports both signature formats:
+     * 1. error(message: string, error?: Error, context?: LoggerMeta)
+     * 2. error(messageOrError: string | Error, meta?: LoggerMeta)
+     *
+     * @param messageOrError The message to log or Error object
+     * @param errorOrContext Optional error object or context data
+     * @param context Optional context data (only for signature 1)
      */
-    error(message, error, context) {
-        console.error(message, error, context ? JSON.stringify(context) : '');
+    error(messageOrError, errorOrContext, context) {
+        if (typeof messageOrError === 'string') {
+            if (errorOrContext instanceof Error) {
+                // Signature 1: error(message: string, error: Error, context?: LoggerMeta)
+                console.error(messageOrError, errorOrContext, context ? JSON.stringify(context) : '');
+            }
+            else {
+                // Signature 1 (no error) or Signature 2: error(message: string, context?: LoggerMeta)
+                console.error(messageOrError, errorOrContext ? JSON.stringify(errorOrContext) : '');
+            }
+        }
+        else {
+            // Signature 2: error(error: Error, context?: LoggerMeta)
+            console.error(messageOrError, errorOrContext ? JSON.stringify(errorOrContext) : '');
+        }
     }
 }
 exports.ConsoleLogger = ConsoleLogger;
@@ -67,10 +84,12 @@ class NoopLogger {
     warn(_message, _context) { }
     /**
      * No-op error log
-     * @param _message The message to log (ignored)
-     * @param _error Optional error object (ignored)
+     * Supports both signature formats
+     *
+     * @param _messageOrError The message to log or Error object (ignored)
+     * @param _errorOrContext Optional error object or context data (ignored)
      * @param _context Optional context data (ignored)
      */
-    error(_message, _error, _context) { }
+    error(_messageOrError, _errorOrContext, _context) { }
 }
 exports.NoopLogger = NoopLogger;

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

@@ -1,7 +1,23 @@
 /**
- * Configuration options for PostgreSQL connection
+ * Configuration for PostgreSQL connection using a connection string
+ */
+export interface PostgresConnectionStringConfig {
+    /** Complete PostgreSQL connection string (e.g., postgres://user:password@host:port/database?sslmode=require) */
+    connectionString: string;
+    /** These properties are not used when a connection string is provided */
+    host?: never;
+    port?: never;
+    user?: never;
+    password?: never;
+    database?: never;
+    ssl?: never;
+}
+/**
+ * Configuration for PostgreSQL connection using individual parameters
  */
-export interface PostgresConfig {
+export interface PostgresParametersConfig {
+    /** Not used when individual parameters are provided */
+    connectionString?: never;
     /** PostgreSQL server hostname */
     host: string;
     /** PostgreSQL server port */
@@ -15,6 +31,14 @@ export interface PostgresConfig {
     /** Whether to use SSL for the connection */
     ssl?: boolean;
 }
+/**
+ * Configuration options for PostgreSQL connection
+ *
+ * Can provide either:
+ * 1. A complete connection string, or
+ * 2. Individual connection parameters (host, port, user, etc.)
+ */
+export type PostgresConfig = PostgresConnectionStringConfig | PostgresParametersConfig;
 /**
  * Interface for PostgreSQL database operations
  *
@@ -96,7 +120,7 @@ export declare class PostgresJsAdapter implements PostgresAdapter {
 /**
  * Creates and initializes a PostgreSQL adapter
  *
- * @param config The PostgreSQL connection configuration
+ * @param config The PostgreSQL connection configuration (either connectionString or individual parameters)
  * @returns An initialized PostgreSQL adapter
  */
 export declare function createPostgresAdapter(config: PostgresConfig): Promise<PostgresAdapter>;

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

@@ -1 +1 @@
-{"version":3,"file":"postgres-adapter.d.ts","sourceRoot":"","sources":["../../../src/pathways/postgres/postgres-adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;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;;;;GAIG;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;;GAEG;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;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAOjC;;;;;;OAMG;IACG,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,EAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAO/D;;;;;OAKG;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"}
+{"version":3,"file":"postgres-adapter.d.ts","sourceRoot":"","sources":["../../../src/pathways/postgres/postgres-adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C,gHAAgH;IAChH,gBAAgB,EAAE,MAAM,CAAC;IAEzB,yEAAyE;IACzE,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,QAAQ,CAAC,EAAE,KAAK,CAAC;IACjB,QAAQ,CAAC,EAAE,KAAK,CAAC;IACjB,GAAG,CAAC,EAAE,KAAK,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,uDAAuD;IACvD,gBAAgB,CAAC,EAAE,KAAK,CAAC;IAEzB,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,MAAM,cAAc,GAAG,8BAA8B,GAAG,wBAAwB,CAAC;AAEvF;;;;GAIG;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;;GAEG;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;IAelC;;;;;OAKG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAW9B;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAOjC;;;;;;OAMG;IACG,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,EAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAO/D;;;;;OAKG;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/script/pathways/postgres/postgres-adapter.js

@@ -64,9 +64,16 @@ class PostgresJsAdapter {
             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";
+        if ('connectionString' in config && config.connectionString) {
+            // Use the provided connection string directly
+            this.connectionString = config.connectionString;
+        }
+        else {
+            // Build connection string from individual parameters
+            this.connectionString = `postgres://${config.user}:${config.password}@${config.host}:${config.port}/${config.database}`;
+            if (config.ssl) {
+                this.connectionString += "?sslmode=require";
+            }
         }
     }
     /**
@@ -126,7 +133,7 @@ exports.PostgresJsAdapter = PostgresJsAdapter;
 /**
  * Creates and initializes a PostgreSQL adapter
  *
- * @param config The PostgreSQL connection configuration
+ * @param config The PostgreSQL connection configuration (either connectionString or individual parameters)
  * @returns An initialized PostgreSQL adapter
  */
 async function createPostgresAdapter(config) {