@flowcore/pathways 0.2.1 → 0.2.2

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

@@ -2,8 +2,6 @@ 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 {
     /**
@@ -20,21 +18,21 @@ export declare class InternalPathwayState implements PathwayState {
      * Gets or initializes the KV adapter
      *
      * @private
-     * @returns {Promise<KvAdapter>} The KV adapter instance
+     * @returns 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
+     * @param eventId The ID of the event to check
+     * @returns 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>}
+     * @param eventId The ID of the event to mark as processed
+     * @returns Promise that resolves when the operation completes
      */
     setProcessed(eventId: string): Promise<void>;
 }

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

@@ -1 +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"}
+{"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;;;GAGG;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/script/pathways/internal-pathway.state.js

@@ -5,8 +5,6 @@ const kv_adapter_js_1 = require("./kv/kv-adapter.js");
 /**
  * Internal implementation of PathwayState interface that uses KV storage
  * for tracking processed events to prevent duplicate processing
- *
- * @implements {PathwayState}
  */
 class InternalPathwayState {
     constructor() {
@@ -25,7 +23,7 @@ class InternalPathwayState {
      * Gets or initializes the KV adapter
      *
      * @private
-     * @returns {Promise<KvAdapter>} The KV adapter instance
+     * @returns The KV adapter instance
      */
     async getKv() {
         if (!this.kv) {
@@ -36,8 +34,8 @@ class InternalPathwayState {
     /**
      * 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
+     * @param eventId The ID of the event to check
+     * @returns True if the event has been processed, false otherwise
      */
     async isProcessed(eventId) {
         const kv = await this.getKv();
@@ -47,8 +45,8 @@ class InternalPathwayState {
     /**
      * Marks an event as processed
      *
-     * @param {string} eventId - The ID of the event to mark as processed
-     * @returns {Promise<void>}
+     * @param eventId The ID of the event to mark as processed
+     * @returns Promise that resolves when the operation completes
      */
     async setProcessed(eventId) {
         const kv = await this.getKv();

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

@@ -3,8 +3,6 @@ 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 {
     /**
@@ -20,16 +18,16 @@ export declare class BunKvAdapter implements KvAdapter {
      * 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
+     * @param key The key to retrieve
+     * @returns 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
+     * @param key The key to store the value under
+     * @param value The value to store
+     * @param ttlMs Time-to-live in milliseconds
      */
     set(key: string, value: unknown, ttlMs: number): void;
 }

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

@@ -1 +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"}
+{"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;;;;GAIG;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/script/pathways/kv/bun-kv-adapter.js

@@ -6,8 +6,6 @@ const bun_sqlite_key_value_1 = require("bun-sqlite-key-value");
  * KV adapter implementation for Bun runtime
  *
  * Uses Bun's SQLite-based key-value store for storage
- *
- * @implements {KvAdapter}
  */
 class BunKvAdapter {
     /**
@@ -30,8 +28,8 @@ class BunKvAdapter {
      * 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
+     * @param key The key to retrieve
+     * @returns The stored value or null if not found
      */
     get(key) {
         const value = this.store.get(key);
@@ -40,9 +38,9 @@ class BunKvAdapter {
     /**
      * 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
+     * @param key The key to store the value under
+     * @param value The value to store
+     * @param ttlMs Time-to-live in milliseconds
      */
     set(key, value, ttlMs) {
         this.store.set(key, value, ttlMs);

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

@@ -9,17 +9,17 @@ 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
+     * @param key The key to retrieve
+     * @returns 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)}
+     * @param key The key to store the value under
+     * @param value The value to store
+     * @param ttlMs Time-to-live in milliseconds
+     * @returns Promise or void when the operation completes
      */
     set(key: string, value: unknown, ttlMs: number): (Promise<void> | void);
 }
@@ -28,7 +28,7 @@ export interface KvAdapter {
  *
  * Attempts to use Bun KV adapter if running in Bun, falls back to Node adapter otherwise
  *
- * @returns {Promise<KvAdapter>} A KV adapter instance
+ * @returns A KV adapter instance for the current runtime
  */
 export declare function createKvAdapter(): Promise<KvAdapter>;
 //# sourceMappingURL=kv-adapter.d.ts.map

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

@@ -29,7 +29,7 @@ exports.createKvAdapter = createKvAdapter;
  *
  * Attempts to use Bun KV adapter if running in Bun, falls back to Node adapter otherwise
  *
- * @returns {Promise<KvAdapter>} A KV adapter instance
+ * @returns A KV adapter instance for the current runtime
  */
 async function createKvAdapter() {
     try {

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

@@ -3,8 +3,6 @@ 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 {
     /**
@@ -16,17 +14,17 @@ export declare class NodeKvAdapter implements KvAdapter {
      * 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
+     * @param key The key to retrieve
+     * @returns 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>}
+     * @param key The key to store the value under
+     * @param value The value to store
+     * @param ttlMs Time-to-live in milliseconds
+     * @returns Promise that resolves when the operation completes
      */
     set(key: string, value: unknown, ttlMs: number): Promise<void>;
 }

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

@@ -1 +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"}
+{"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;;;;GAIG;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/script/pathways/kv/node-kv-adapter.js

@@ -9,8 +9,6 @@ const node_cache_1 = __importDefault(require("node-cache"));
  * KV adapter implementation for Node.js runtime
  *
  * Uses node-cache for in-memory key-value storage
- *
- * @implements {KvAdapter}
  */
 class NodeKvAdapter {
     constructor() {
@@ -29,8 +27,8 @@ class NodeKvAdapter {
      * 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
+     * @param key The key to retrieve
+     * @returns The stored value or null if not found
      */
     async get(key) {
         const result = await this.kv.get(key);
@@ -39,10 +37,10 @@ class NodeKvAdapter {
     /**
      * 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>}
+     * @param key The key to store the value under
+     * @param value The value to store
+     * @param ttlMs Time-to-live in milliseconds
+     * @returns Promise that resolves when the operation completes
      */
     async set(key, value, ttlMs) {
         await this.kv.set(key, value, (ttlMs / 1000));

package/script/pathways/logger.d.ts

@@ -23,26 +23,69 @@ export interface Logger {
     /**
      * Log error messages
      * @param message The message to log
+     * @param error Optional error object
      * @param context Optional context data to include
      */
-    error(message: string, context?: Record<string, unknown>): void;
+    error(message: string, error?: Error, context?: Record<string, unknown>): void;
 }
 /**
  * A default console logger that logs to the console
  */
 export declare class ConsoleLogger implements Logger {
+    /**
+     * Log debug information to the console
+     * @param message The message to log
+     * @param context Optional context data to include
+     */
     debug(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Log informational messages to the console
+     * @param message The message to log
+     * @param context Optional context data to include
+     */
     info(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Log warning messages to the console
+     * @param message The message to log
+     * @param context Optional context data to include
+     */
     warn(message: string, context?: Record<string, unknown>): void;
-    error(message: string, context?: Record<string, unknown>): 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
+     */
+    error(message: string, error?: Error, context?: Record<string, unknown>): void;
 }
 /**
  * A no-operation logger that does nothing
  */
 export declare class NoopLogger implements Logger {
+    /**
+     * No-op debug log
+     * @param _message The message to log (ignored)
+     * @param _context Optional context data (ignored)
+     */
     debug(_message: string, _context?: Record<string, unknown>): void;
+    /**
+     * No-op info log
+     * @param _message The message to log (ignored)
+     * @param _context Optional context data (ignored)
+     */
     info(_message: string, _context?: Record<string, unknown>): void;
+    /**
+     * No-op warning log
+     * @param _message The message to log (ignored)
+     * @param _context Optional context data (ignored)
+     */
     warn(_message: string, _context?: Record<string, unknown>): void;
-    error(_message: string, _context?: Record<string, unknown>): void;
+    /**
+     * No-op error log
+     * @param _message The message to log (ignored)
+     * @param _error Optional error object (ignored)
+     * @param _context Optional context data (ignored)
+     */
+    error(_message: string, _error?: Error, _context?: Record<string, unknown>): 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;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"}
+{"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;;;;;OAKG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;CAC/E;AAED;;GAEG;AACH,qBAAa,aAAc,YAAW,MAAM;IAC1C;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9D;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9D;;;;;OAKG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAG/E;AAED;;GAEG;AACH,qBAAa,UAAW,YAAW,MAAM;IACvC;;;;OAIG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAEjE;;;;OAIG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAEhE;;;;OAIG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAEhE;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAClF"}

package/script/pathways/logger.js

@@ -5,17 +5,38 @@ exports.NoopLogger = exports.ConsoleLogger = void 0;
  * A default console logger that logs to the console
  */
 class ConsoleLogger {
+    /**
+     * Log debug information to the console
+     * @param message The message to log
+     * @param context Optional context data to include
+     */
     debug(message, context) {
         console.debug(message, context ? JSON.stringify(context) : '');
     }
+    /**
+     * Log informational messages to the console
+     * @param message The message to log
+     * @param context Optional context data to include
+     */
     info(message, context) {
         console.info(message, context ? JSON.stringify(context) : '');
     }
+    /**
+     * Log warning messages to the console
+     * @param message The message to log
+     * @param context Optional context data to include
+     */
     warn(message, context) {
         console.warn(message, context ? JSON.stringify(context) : '');
     }
-    error(message, context) {
-        console.error(message, context ? JSON.stringify(context) : '');
+    /**
+     * Log error messages to the console
+     * @param message The message to log
+     * @param error Optional error object
+     * @param context Optional context data to include
+     */
+    error(message, error, context) {
+        console.error(message, error, context ? JSON.stringify(context) : '');
     }
 }
 exports.ConsoleLogger = ConsoleLogger;
@@ -23,9 +44,30 @@ exports.ConsoleLogger = ConsoleLogger;
  * A no-operation logger that does nothing
  */
 class NoopLogger {
+    /**
+     * No-op debug log
+     * @param _message The message to log (ignored)
+     * @param _context Optional context data (ignored)
+     */
     debug(_message, _context) { }
+    /**
+     * No-op info log
+     * @param _message The message to log (ignored)
+     * @param _context Optional context data (ignored)
+     */
     info(_message, _context) { }
+    /**
+     * No-op warning log
+     * @param _message The message to log (ignored)
+     * @param _context Optional context data (ignored)
+     */
     warn(_message, _context) { }
-    error(_message, _context) { }
+    /**
+     * No-op error log
+     * @param _message The message to log (ignored)
+     * @param _error Optional error object (ignored)
+     * @param _context Optional context data (ignored)
+     */
+    error(_message, _error, _context) { }
 }
 exports.NoopLogger = NoopLogger;

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

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

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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/pathways/postgres/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC"}

package/script/pathways/postgres/index.js

@@ -19,6 +19,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
  *
  * This module exports components for using PostgreSQL as a storage backend
  * for pathway state and other persistent data.
+ *
+ * @module
  */
 __exportStar(require("./postgres-adapter.js"), exports);
 __exportStar(require("./postgres-pathway-state.js"), exports);

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

@@ -1,7 +1,5 @@
 /**
  * Configuration options for PostgreSQL connection
- *
- * @interface PostgresConfig
  */
 export interface PostgresConfig {
     /** PostgreSQL server hostname */
@@ -21,40 +19,36 @@ export interface PostgresConfig {
  * 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>}
+     * @returns Promise that resolves when the connection is established
      */
     connect(): Promise<void>;
     /**
      * Closes the connection to the PostgreSQL database
-     * @returns {Promise<void>}
+     * @returns Promise that resolves when the connection is closed
      */
     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
+     * @param sql The SQL query to execute
+     * @param params Optional parameters for the query
+     * @returns Promise that resolves to 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>}
+     * @param sql The SQL statement to execute
+     * @param params Optional parameters for the statement
+     * @returns Promise that resolves when the statement has been executed
      */
     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 */
@@ -68,45 +62,42 @@ export declare class PostgresJsAdapter implements PostgresAdapter {
     /**
      * Creates a new PostgresJsAdapter instance
      *
-     * @param {PostgresConfig} config The PostgreSQL connection configuration
+     * @param config The PostgreSQL connection configuration
      */
     constructor(config: PostgresConfig);
     /**
      * Establishes a connection to the PostgreSQL database
      *
-     * @returns {Promise<void>}
-     * @throws {Error} If connection fails
+     * @returns Promise that resolves when connection is established
+     * @throws Error if connection fails
      */
     connect(): Promise<void>;
     /**
      * Closes the connection to the PostgreSQL database
-     *
-     * @returns {Promise<void>}
+     * @returns Promise that resolves when the connection is closed
      */
     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
+     * @param sql The SQL query to execute
+     * @param params Optional parameters for the query
+     * @returns Promise that resolves to 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>}
+     * @param sql The SQL statement to execute
+     * @param params Optional parameters for the statement
+     * @returns Promise that resolves when the statement has been executed
      */
     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
+ * @param config The PostgreSQL connection configuration
+ * @returns An initialized PostgreSQL adapter
  */
 export declare function createPostgresAdapter(config: PostgresConfig): Promise<PostgresAdapter>;
 //# sourceMappingURL=postgres-adapter.d.ts.map

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;;;;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"}
+{"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"}

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

@@ -27,14 +27,12 @@ exports.PostgresJsAdapter = void 0;
 exports.createPostgresAdapter = createPostgresAdapter;
 /**
  * Implementation of PostgresAdapter using the postgres.js library
- *
- * @implements {PostgresAdapter}
  */
 class PostgresJsAdapter {
     /**
      * Creates a new PostgresJsAdapter instance
      *
-     * @param {PostgresConfig} config The PostgreSQL connection configuration
+     * @param config The PostgreSQL connection configuration
      */
     constructor(config) {
         /** The postgres.js client factory function */
@@ -74,8 +72,8 @@ class PostgresJsAdapter {
     /**
      * Establishes a connection to the PostgreSQL database
      *
-     * @returns {Promise<void>}
-     * @throws {Error} If connection fails
+     * @returns Promise that resolves when connection is established
+     * @throws Error if connection fails
      */
     async connect() {
         try {
@@ -90,8 +88,7 @@ class PostgresJsAdapter {
     }
     /**
      * Closes the connection to the PostgreSQL database
-     *
-     * @returns {Promise<void>}
+     * @returns Promise that resolves when the connection is closed
      */
     async disconnect() {
         if (this.sql) {
@@ -101,11 +98,10 @@ class PostgresJsAdapter {
     }
     /**
      * 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
+     * @param sql The SQL query to execute
+     * @param params Optional parameters for the query
+     * @returns Promise that resolves to the query results
      */
     async query(sql, params = []) {
         if (!this.sql) {
@@ -115,10 +111,9 @@ class PostgresJsAdapter {
     }
     /**
      * 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>}
+     * @param sql The SQL statement to execute
+     * @param params Optional parameters for the statement
+     * @returns Promise that resolves when the statement has been executed
      */
     async execute(sql, params = []) {
         if (!this.sql) {
@@ -131,8 +126,8 @@ exports.PostgresJsAdapter = PostgresJsAdapter;
 /**
  * Creates and initializes a PostgreSQL adapter
  *
- * @param {PostgresConfig} config The PostgreSQL connection configuration
- * @returns {Promise<PostgresAdapter>} An initialized PostgreSQL adapter
+ * @param config The PostgreSQL connection configuration
+ * @returns An initialized PostgreSQL adapter
  */
 async function createPostgresAdapter(config) {
     const adapter = new PostgresJsAdapter(config);