@flowcore/pathways 0.8.0 → 0.9.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [0.9.0](https://github.com/flowcore-io/flowcore-pathways/compare/v0.8.0...v0.9.0) (2025-03-18)
+
+
+### Features
+
+* **pathways:** :sparkles: Introduce Session Pathways for session management ([5ad1f1d](https://github.com/flowcore-io/flowcore-pathways/commit/5ad1f1d706dcfb4ba517c38a2748274d43762cb6))
+
+
+### Bug Fixes
+
+* **pathways:** :art: Change import of KvAdapter to type import ([732da2d](https://github.com/flowcore-io/flowcore-pathways/commit/732da2d191b87781b2be3adf9efa150e2eaab3ef))
+
 ## [0.8.0](https://github.com/flowcore-io/flowcore-pathways/compare/v0.7.0...v0.8.0) (2025-03-18)
 
 

package/README.md

@@ -21,6 +21,7 @@ A TypeScript Library for creating Flowcore Pathways, simplifying the integration
   - [Auditing](#auditing)
   - [Custom Loggers](#custom-loggers)
   - [Retry Mechanisms](#retry-mechanisms)
+  - [Session Pathways](#session-pathways)
 - [API Reference](#api-reference)
 
 ## Installation
@@ -415,6 +416,100 @@ pathways.register({
 });
 ```
 
+### Session Pathways
+
+The `SessionPathwayBuilder` provides a way to associate session IDs with pathway operations, making it easier to track and manage user sessions in your application.
+
+#### Setting Up Session Support
+
+To use session-specific functionality, first configure your `PathwaysBuilder` with session support:
+
+```typescript
+import { PathwaysBuilder, createKvAdapter } from "@flowcore/pathways";
+
+// Create a KV adapter for storing session information
+const sessionStore = await createKvAdapter();
+
+// Configure the builder with session support
+const pathways = new PathwaysBuilder({
+  baseUrl: "https://api.flowcore.io",
+  tenant: "your-tenant",
+  dataCore: "your-data-core",
+  apiKey: "your-api-key",
+  sessionUserResolvers: sessionStore // Enable session-specific resolvers
+});
+```
+
+#### Creating Session Pathways
+
+Create a session-specific pathway wrapper:
+
+```typescript
+import { SessionPathwayBuilder } from "@flowcore/pathways";
+
+// Create a session with an auto-generated session ID
+const session = new SessionPathwayBuilder(pathways);
+const sessionId = session.getSessionId(); // Get the auto-generated ID
+
+// Or create a session with a specific session ID
+const customSession = new SessionPathwayBuilder(pathways, "user-session-123");
+```
+
+#### Session-Specific User Resolvers
+
+You can register different user resolvers for different sessions, allowing you to associate users with specific sessions:
+
+```typescript
+// Register a user resolver for a specific session
+pathways.withSessionUserResolver("user-session-123", async () => {
+  // Return the user ID for this session
+  return "user-456";
+});
+
+// Alternative: Register directly through the session instance
+session.withUserResolver(async () => {
+  return "user-789";
+});
+```
+
+#### Writing Events with Session Context
+
+Events written through a session builder automatically include the session ID:
+
+```typescript
+// Write an event with session context
+await session.write("order/placed", {
+  orderId: "ord-123",
+  userId: "user-456",
+  total: 99.99,
+  items: [{ id: "item-1", quantity: 2 }]
+});
+
+// You can override the session ID for a specific write
+await session.write(
+  "order/placed",
+  orderData,
+  {}, // No metadata
+  { sessionId: "different-session" }
+);
+```
+
+#### Session ID in Audit Events
+
+When auditing is enabled, the session ID is included in the audit metadata:
+
+```typescript
+// Enable auditing
+pathways.withAudit((path, event) => {
+  console.log(`Audit: ${path} event ${event.eventId}`);
+  // The session ID will be included in event metadata
+});
+
+// Now when writing events through a session
+await session.write("order/placed", orderData);
+// The session ID is automatically included in the audit metadata
+```
+
 ## API Reference
 
 For a complete API reference, please see the [API documentation](https://jsr.io/@flowcore/pathways).

package/esm/pathways/builder.d.ts

@@ -1,6 +1,7 @@
 import type { Static, TSchema } from "@sinclair/typebox";
 import type { WebhookSendOptions } from "@flowcore/sdk-transformer-core";
 import type { FlowcoreEvent } from "../contracts/event.js";
+import type { KvAdapter } from "./kv/kv-adapter.js";
 import type { Logger } from "./logger.js";
 import type { EventMetadata, PathwayContract, PathwayKey, PathwayState, PathwayWriteOptions, WritablePathway } from "./types.js";
 /**
@@ -77,14 +78,16 @@ export declare class PathwaysBuilder<TPathway extends Record<string, unknown> =
      * @param options.apiKey The API key for authentication
      * @param options.pathwayTimeoutMs Optional timeout for pathway processing in milliseconds
      * @param options.logger Optional logger instance
+     * @param options.sessionUserResolvers Optional KvAdapter instance for session-specific user resolvers
      */
-    constructor({ baseUrl, tenant, dataCore, apiKey, pathwayTimeoutMs, logger, }: {
+    constructor({ baseUrl, tenant, dataCore, apiKey, pathwayTimeoutMs, logger, sessionUserResolvers, }: {
         baseUrl: string;
         tenant: string;
         dataCore: string;
         apiKey: string;
         pathwayTimeoutMs?: number;
         logger?: Logger;
+        sessionUserResolvers?: KvAdapter;
     });
     /**
      * Configures the PathwaysBuilder to use a custom pathway state implementation
@@ -106,9 +109,36 @@ export declare class PathwaysBuilder<TPathway extends Record<string, unknown> =
     withUserResolver(resolver: UserIdResolver): PathwaysBuilder<TPathway, TWritablePaths>;
     /**
      * Registers a user resolver for a specific session
+     *
+     * Session-specific user resolvers allow you to associate different user IDs with different
+     * sessions, which is useful in multi-user applications or when tracking user actions across
+     * different sessions.
+     *
+     * The resolver is stored in a key-value store with a TTL (time to live), and will be used
+     * to resolve the user ID when operations are performed with the given session ID. If the resolver
+     * expires, it will need to be registered again.
+     *
+     * This feature works in conjunction with the SessionPathwayBuilder to provide a complete
+     * session management solution.
+     *
      * @param sessionId The session ID to associate with this resolver
      * @param resolver The resolver function that resolves to the user ID for this session
      * @returns The PathwaysBuilder instance for chaining
+     *
+     * @throws Error if session user resolvers are not configured (sessionUserResolvers not provided in constructor)
+     *
+     * @example
+     * ```typescript
+     * // Register a resolver for a specific session
+     * pathwaysBuilder.withSessionUserResolver("session-123", async () => {
+     *   return "user-456"; // Return the user ID for this session
+     * });
+     *
+     * // Use with SessionPathwayBuilder
+     * const session = new SessionPathwayBuilder(pathwaysBuilder, "session-123");
+     * await session.write("user/action", actionData);
+     * // The user ID will be automatically included in the metadata
+     * ```
      */
     withSessionUserResolver(sessionId: string, resolver: UserIdResolver): PathwaysBuilder<TPathway, TWritablePaths>;
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/pathways/builder.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/pathways/builder.ts"],"names":[],"mappings":"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"}

package/esm/pathways/builder.js

@@ -15,6 +15,10 @@ const DEFAULT_MAX_RETRIES = 3;
  * Default delay between retry attempts in milliseconds
  */
 const DEFAULT_RETRY_DELAY_MS = 500;
+/**
+ * Default TTL for session-specific user resolvers in milliseconds (10seconds)
+ */
+const DEFAULT_SESSION_USER_RESOLVER_TTL_MS = 10 * 1000;
 /**
  * Main builder class for creating and managing Flowcore pathways
  *
@@ -39,8 +43,9 @@ export class PathwaysBuilder {
      * @param options.apiKey The API key for authentication
      * @param options.pathwayTimeoutMs Optional timeout for pathway processing in milliseconds
      * @param options.logger Optional logger instance
+     * @param options.sessionUserResolvers Optional KvAdapter instance for session-specific user resolvers
      */
-    constructor({ baseUrl, tenant, dataCore, apiKey, pathwayTimeoutMs, logger, }) {
+    constructor({ baseUrl, tenant, dataCore, apiKey, pathwayTimeoutMs, logger, sessionUserResolvers, }) {
         Object.defineProperty(this, "pathways", {
             enumerable: true,
             configurable: true,
@@ -155,7 +160,7 @@ export class PathwaysBuilder {
             enumerable: true,
             configurable: true,
             writable: true,
-            value: new Map()
+            value: null
         });
         // Logger instance (but not using it yet due to TypeScript errors)
         Object.defineProperty(this, "logger", {
@@ -196,6 +201,9 @@ export class PathwaysBuilder {
         this.tenant = tenant;
         this.dataCore = dataCore;
         this.apiKey = apiKey;
+        if (sessionUserResolvers) {
+            this.sessionUserResolvers = sessionUserResolvers;
+        }
         this.logger.debug('Initializing PathwaysBuilder', {
             baseUrl,
             tenant,
@@ -249,13 +257,43 @@ export class PathwaysBuilder {
     }
     /**
      * Registers a user resolver for a specific session
+     *
+     * Session-specific user resolvers allow you to associate different user IDs with different
+     * sessions, which is useful in multi-user applications or when tracking user actions across
+     * different sessions.
+     *
+     * The resolver is stored in a key-value store with a TTL (time to live), and will be used
+     * to resolve the user ID when operations are performed with the given session ID. If the resolver
+     * expires, it will need to be registered again.
+     *
+     * This feature works in conjunction with the SessionPathwayBuilder to provide a complete
+     * session management solution.
+     *
      * @param sessionId The session ID to associate with this resolver
      * @param resolver The resolver function that resolves to the user ID for this session
      * @returns The PathwaysBuilder instance for chaining
+     *
+     * @throws Error if session user resolvers are not configured (sessionUserResolvers not provided in constructor)
+     *
+     * @example
+     * ```typescript
+     * // Register a resolver for a specific session
+     * pathwaysBuilder.withSessionUserResolver("session-123", async () => {
+     *   return "user-456"; // Return the user ID for this session
+     * });
+     *
+     * // Use with SessionPathwayBuilder
+     * const session = new SessionPathwayBuilder(pathwaysBuilder, "session-123");
+     * await session.write("user/action", actionData);
+     * // The user ID will be automatically included in the metadata
+     * ```
      */
     withSessionUserResolver(sessionId, resolver) {
+        if (!this.sessionUserResolvers) {
+            throw new Error('Session user resolvers not configured');
+        }
         this.logger.debug('Configuring session-specific user resolver', { sessionId });
-        this.sessionUserResolvers.set(sessionId, resolver);
+        this.sessionUserResolvers.set(sessionId, resolver, DEFAULT_SESSION_USER_RESOLVER_TTL_MS);
         return this;
     }
     /**
@@ -264,7 +302,11 @@ export class PathwaysBuilder {
      * @returns The resolver function for the session, or undefined if none exists
      */
     getSessionUserResolver(sessionId) {
-        return this.sessionUserResolvers.get(sessionId);
+        if (!this.sessionUserResolvers) {
+            return undefined;
+        }
+        const resolver = this.sessionUserResolvers.get(sessionId);
+        return resolver;
     }
     /**
      * Process a pathway event with error handling and retries
@@ -588,7 +630,7 @@ export class PathwaysBuilder {
         // Check for session-specific user resolver
         let userId;
         if (options?.sessionId) {
-            const sessionUserResolver = this.sessionUserResolvers.get(options.sessionId);
+            const sessionUserResolver = this.getSessionUserResolver(options.sessionId);
             if (sessionUserResolver) {
                 try {
                     userId = await sessionUserResolver();

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

@@ -2,7 +2,34 @@
  * Interface for key-value storage adapters
  *
  * Provides a common interface for different KV storage implementations
- * that can be used for storing pathway state.
+ * that can be used for storing pathway state and other application data.
+ *
+ * This interface abstracts away the details of specific storage backends,
+ * allowing the application to work with different storage providers
+ * without changing the core logic.
+ *
+ * The Flowcore Pathways library includes several implementations of this interface:
+ * - BunKvAdapter: Uses Bun's built-in KV store
+ * - NodeKvAdapter: Uses node-cache for in-memory storage
+ * - DenoKvAdapter: Uses Deno's KV store (when available)
+ *
+ * Custom implementations can be created for other storage backends
+ * by implementing this interface.
+ *
+ * @example
+ * ```typescript
+ * // Create a KV adapter
+ * const store = await createKvAdapter();
+ *
+ * // Store a value with a TTL
+ * await store.set("session:123", { userId: "user-456" }, 3600000); // 1 hour TTL
+ *
+ * // Retrieve the value
+ * const session = await store.get<{ userId: string }>("session:123");
+ * if (session) {
+ *   console.log("User ID:", session.userId);
+ * }
+ * ```
  */
 export interface KvAdapter {
     /**
@@ -26,9 +53,39 @@ export interface KvAdapter {
 /**
  * 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
+ * This function automatically detects the current runtime environment and creates
+ * the most suitable KV adapter implementation:
+ *
+ * - In Bun: Returns a BunKvAdapter using Bun's built-in KV store
+ * - In Deno with KV access: Returns a DenoKvAdapter
+ * - Otherwise: Returns a NodeKvAdapter using an in-memory cache
+ *
+ * Using this factory function rather than directly instantiating a specific adapter
+ * implementation makes your code more portable across different JavaScript runtimes.
+ *
+ * The adapter is lazily initialized, so any necessary setup only happens when
+ * you first interact with the adapter.
  *
  * @returns A KV adapter instance for the current runtime
+ *
+ * @example
+ * ```typescript
+ * // Create a runtime-specific KV adapter
+ * const kv = await createKvAdapter();
+ *
+ * // Use with PathwaysBuilder for session user resolvers
+ * const pathways = new PathwaysBuilder({
+ *   baseUrl: "https://api.flowcore.io",
+ *   tenant: "my-tenant",
+ *   dataCore: "my-data-core",
+ *   apiKey: "my-api-key",
+ *   sessionUserResolvers: kv
+ * });
+ *
+ * // Use as a general-purpose key-value store
+ * await kv.set("cache:user:123", userData, 60 * 60 * 1000); // 1 hour TTL
+ * const cachedUser = await kv.get("cache:user:123");
+ * ```
  */
 export declare function createKvAdapter(): Promise<KvAdapter>;
 //# sourceMappingURL=kv-adapter.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"kv-adapter.d.ts","sourceRoot":"","sources":["../../../src/pathways/kv/kv-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,SAAS,CAAC,CAU1D"}

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

@@ -1,9 +1,39 @@
 /**
  * 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
+ * This function automatically detects the current runtime environment and creates
+ * the most suitable KV adapter implementation:
+ *
+ * - In Bun: Returns a BunKvAdapter using Bun's built-in KV store
+ * - In Deno with KV access: Returns a DenoKvAdapter
+ * - Otherwise: Returns a NodeKvAdapter using an in-memory cache
+ *
+ * Using this factory function rather than directly instantiating a specific adapter
+ * implementation makes your code more portable across different JavaScript runtimes.
+ *
+ * The adapter is lazily initialized, so any necessary setup only happens when
+ * you first interact with the adapter.
  *
  * @returns A KV adapter instance for the current runtime
+ *
+ * @example
+ * ```typescript
+ * // Create a runtime-specific KV adapter
+ * const kv = await createKvAdapter();
+ *
+ * // Use with PathwaysBuilder for session user resolvers
+ * const pathways = new PathwaysBuilder({
+ *   baseUrl: "https://api.flowcore.io",
+ *   tenant: "my-tenant",
+ *   dataCore: "my-data-core",
+ *   apiKey: "my-api-key",
+ *   sessionUserResolvers: kv
+ * });
+ *
+ * // Use as a general-purpose key-value store
+ * await kv.set("cache:user:123", userData, 60 * 60 * 1000); // 1 hour TTL
+ * const cachedUser = await kv.get("cache:user:123");
+ * ```
  */
 export async function createKvAdapter() {
     try {

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

@@ -53,6 +53,47 @@ export type PostgresPathwayStateConfig = PostgresPathwayStateConnectionStringCon
  *
  * This class provides persistent storage of pathway state using a PostgreSQL database,
  * which allows for state to be shared across multiple instances of the application.
+ *
+ * Key features:
+ * - Persistent storage of pathway processing state across application restarts
+ * - Automatic table and index creation
+ * - Configurable TTL (time-to-live) for processed events
+ * - Automatic cleanup of expired records
+ * - Support for horizontal scaling across multiple instances
+ * - Connection pooling for efficient database usage
+ *
+ * Use cases:
+ * - Production deployments that require durability and persistence
+ * - Distributed systems where multiple instances process events
+ * - Applications with high reliability requirements
+ * - Scenarios where in-memory state is insufficient
+ *
+ * @example
+ * ```typescript
+ * // Create PostgreSQL pathway state with connection string
+ * const postgresState = createPostgresPathwayState({
+ *   connectionString: "postgres://user:password@localhost:5432/mydb",
+ *   tableName: "event_processing_state", // Optional
+ *   ttlMs: 24 * 60 * 60 * 1000 // 24 hours (optional)
+ * });
+ *
+ * // Or with individual parameters
+ * const postgresState = createPostgresPathwayState({
+ *   host: "localhost",
+ *   port: 5432,
+ *   user: "postgres",
+ *   password: "postgres",
+ *   database: "mydb",
+ *   ssl: false,
+ *   tableName: "event_processing_state", // Optional
+ *   ttlMs: 30 * 60 * 1000 // 30 minutes (optional)
+ * });
+ *
+ * // Use with PathwaysBuilder
+ * const pathways = new PathwaysBuilder({
+ *   // ... other config
+ * }).withPathwayState(postgresState);
+ * ```
  */
 export declare class PostgresPathwayState implements PathwayState {
     private config;
@@ -102,15 +143,66 @@ export declare class PostgresPathwayState implements PathwayState {
     /**
      * Checks if an event has already been processed
      *
+     * This method checks the PostgreSQL database to determine if an event with the given ID
+     * has been marked as processed. If the event exists in the database and is marked as processed,
+     * the method returns true.
+     *
+     * Before performing the check, this method also triggers cleanup of expired event records
+     * to maintain database performance.
+     *
      * @param {string} eventId - The ID of the event to check
      * @returns {Promise<boolean>} True if the event has been processed, false otherwise
+     *
+     * @example
+     * ```typescript
+     * // Check if an event has been processed
+     * const processed = await postgresState.isProcessed("event-123");
+     * if (processed) {
+     *   console.log("Event has already been processed, skipping");
+     * } else {
+     *   console.log("Processing event for the first time");
+     *   // Process the event
+     *   await processEvent(event);
+     *   // Mark as processed
+     *   await postgresState.setProcessed("event-123");
+     * }
+     * ```
      */
     isProcessed(eventId: string): Promise<boolean>;
     /**
      * Marks an event as processed
      *
+     * This method inserts or updates a record in the PostgreSQL database to mark an event
+     * as processed. If the event already exists in the database, the record is updated;
+     * otherwise, a new record is created.
+     *
+     * Each processed event is stored with an expiration timestamp based on the configured TTL.
+     * After this time elapses, the record may be automatically removed during cleanup operations.
+     *
      * @param {string} eventId - The ID of the event to mark as processed
      * @returns {Promise<void>}
+     *
+     * @example
+     * ```typescript
+     * // Process an event and mark it as processed
+     * async function handleEvent(event) {
+     *   // Check if already processed to implement idempotency
+     *   if (await postgresState.isProcessed(event.id)) {
+     *     return; // Skip already processed events
+     *   }
+     *
+     *   try {
+     *     // Process the event
+     *     await processEvent(event);
+     *
+     *     // Mark as processed after successful processing
+     *     await postgresState.setProcessed(event.id);
+     *   } catch (error) {
+     *     console.error("Failed to process event:", error);
+     *     // Not marking as processed, so it can be retried
+     *   }
+     * }
+     * ```
      */
     setProcessed(eventId: string): Promise<void>;
     /**
@@ -130,8 +222,46 @@ export declare class PostgresPathwayState implements PathwayState {
 /**
  * Creates a new PostgreSQL pathway state instance
  *
- * @param config The PostgreSQL configuration
+ * This is a factory function that simplifies the creation of PostgresPathwayState instances.
+ * It accepts either a connection string or individual connection parameters, along with
+ * optional configuration for table name and TTL.
+ *
+ * The PostgresPathwayState is lazily initialized, meaning the database connection and
+ * table creation only happen when the first operation is performed. This makes it safe
+ * to create instances early in the application lifecycle.
+ *
+ * @param config The PostgreSQL configuration (connection string or parameters)
  * @returns A new PostgresPathwayState instance
+ *
+ * @example
+ * ```typescript
+ * // With connection string
+ * const state = createPostgresPathwayState({
+ *   connectionString: "postgres://user:pass@localhost:5432/db?sslmode=require"
+ * });
+ *
+ * // With individual parameters
+ * const state = createPostgresPathwayState({
+ *   host: "localhost",
+ *   port: 5432,
+ *   user: "postgres",
+ *   password: "secret",
+ *   database: "events_db",
+ *   ssl: true
+ * });
+ *
+ * // With custom table name and TTL
+ * const state = createPostgresPathwayState({
+ *   connectionString: "postgres://user:pass@localhost:5432/db",
+ *   tableName: "my_custom_event_state",
+ *   ttlMs: 7 * 24 * 60 * 60 * 1000 // 1 week
+ * });
+ *
+ * // Use with PathwaysBuilder
+ * const pathways = new PathwaysBuilder({
+ *   // Other config
+ * }).withPathwayState(state);
+ * ```
  */
 export declare function createPostgresPathwayState(config: PostgresPathwayStateConfig): PostgresPathwayState;
 //# sourceMappingURL=postgres-pathway-state.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"postgres-pathway-state.d.ts","sourceRoot":"","sources":["../../../src/pathways/postgres/postgres-pathway-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIhD;;GAEG;AACH,MAAM,WAAW,0CAA0C;IACzD,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;IAEZ,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,oCAAoC;IACnD,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;IAEd,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,0BAA0B,GAAG,0CAA0C,GAAG,oCAAoC,CAAC;AAE3H;;;;;GAKG;AACH,qBAAa,oBAAqB,YAAW,YAAY;IA0C3C,OAAO,CAAC,MAAM;IAzC1B;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAEvD;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAmB;IAE7D;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAkB;IAElC;;;OAGG;IACH,OAAO,CAAC,SAAS,CAAS;IAE1B;;;OAGG;IACH,OAAO,CAAC,KAAK,CAAS;IAEtB;;;OAGG;IACH,OAAO,CAAC,WAAW,CAAS;IAE5B;;;;OAIG;gBACiB,MAAM,EAAE,0BAA0B;IAMtD;;;;;OAKG;YACW,UAAU;IA0CxB;;;;;OAKG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAcpD;;;;;OAKG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAelD;;;;;OAKG;YACW,cAAc;IAQ5B;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK7B;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,0BAA0B,GAAG,oBAAoB,CAGnG"}
+{"version":3,"file":"postgres-pathway-state.d.ts","sourceRoot":"","sources":["../../../src/pathways/postgres/postgres-pathway-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIhD;;GAEG;AACH,MAAM,WAAW,0CAA0C;IACzD,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;IAEZ,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,oCAAoC;IACnD,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;IAEd,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,0BAA0B,GAAG,0CAA0C,GAAG,oCAAoC,CAAC;AAE3H;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,qBAAa,oBAAqB,YAAW,YAAY;IA0C3C,OAAO,CAAC,MAAM;IAzC1B;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAEvD;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAmB;IAE7D;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAkB;IAElC;;;OAGG;IACH,OAAO,CAAC,SAAS,CAAS;IAE1B;;;OAGG;IACH,OAAO,CAAC,KAAK,CAAS;IAEtB;;;OAGG;IACH,OAAO,CAAC,WAAW,CAAS;IAE5B;;;;OAIG;gBACiB,MAAM,EAAE,0BAA0B;IAMtD;;;;;OAKG;YACW,UAAU;IA0CxB;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAcpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAelD;;;;;OAKG;YACW,cAAc;IAQ5B;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,0BAA0B,GAAG,oBAAoB,CAGnG"}