@flowcore/pathways 0.8.0 → 0.9.1

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

@@ -4,6 +4,47 @@ import { createPostgresAdapter } from "./postgres-adapter.js";
  *
  * 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 class PostgresPathwayState {
     /**
@@ -109,8 +150,30 @@ export class PostgresPathwayState {
     /**
      * 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");
+     * }
+     * ```
      */
     async isProcessed(eventId) {
         await this.initialize();
@@ -125,8 +188,37 @@ export class PostgresPathwayState {
     /**
      * 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
+     *   }
+     * }
+     * ```
      */
     async setProcessed(eventId) {
         await this.initialize();
@@ -188,8 +280,46 @@ Object.defineProperty(PostgresPathwayState, "DEFAULT_TABLE_NAME", {
 /**
  * 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 function createPostgresPathwayState(config) {
     const state = new PostgresPathwayState(config);

package/esm/pathways/session-pathway.d.ts

@@ -1,4 +1,4 @@
-import type { PathwaysBuilder } from "./builder.js";
+import type { PathwaysBuilder, UserIdResolver } from "./builder.js";
 import type { EventMetadata, PathwayWriteOptions } from "./types.js";
 /**
  * SessionPathwayBuilder wraps a PathwaysBuilder instance and automatically
@@ -6,6 +6,38 @@ import type { EventMetadata, PathwayWriteOptions } from "./types.js";
  *
  * This provides a convenient way to track operations within a user session
  * by automatically including the session ID in metadata.
+ *
+ * Key features:
+ * - Automatic session ID generation if none is provided
+ * - Cross-platform UUID generation (works in Deno, Bun, and Node.js)
+ * - Simple API for accessing the current session ID
+ * - Convenient integration with session-specific user resolvers
+ * - Automatic inclusion of session ID in all write operations
+ * - Support for overriding the session ID on specific writes
+ *
+ * Use cases:
+ * - Tracking user actions across multiple pathway writes
+ * - Connecting related events in a single user session
+ * - Supporting multi-user environments where different users' operations need to be tracked separately
+ * - Building user activity logs with session grouping
+ *
+ * @example
+ * ```typescript
+ * // Create a session pathway with auto-generated ID
+ * const session = new SessionPathwayBuilder(pathwaysBuilder);
+ *
+ * // Get the auto-generated session ID
+ * const sessionId = session.getSessionId();
+ *
+ * // Register a user resolver for this session
+ * session.withUserResolver(async () => getCurrentUserId());
+ *
+ * // Write events with session context
+ * await session.write("order/placed", orderData);
+ * await session.write("user/action", actionData);
+ *
+ * // All events will be associated with the same session ID
+ * ```
  */
 export declare class SessionPathwayBuilder<TPathway extends Record<string, unknown> = {}, TWritablePaths extends keyof TPathway = never> {
     private readonly pathwaysBuilder;
@@ -23,6 +55,36 @@ export declare class SessionPathwayBuilder<TPathway extends Record<string, unkno
      * @returns The session ID associated with this instance
      */
     getSessionId(): string;
+    /**
+     * Registers a user resolver for this session
+     *
+     * This is a convenience method that calls `pathwaysBuilder.withSessionUserResolver`
+     * with the current session ID, allowing you to set up a resolver specific to this session
+     * without having to manually pass the session ID.
+     *
+     * The resolver will be called whenever events are written through this session,
+     * and the resolved user ID will be included in the event metadata.
+     *
+     * @param resolver The function that resolves to the user ID for this session
+     * @returns The SessionPathwayBuilder instance for chaining
+     *
+     * @throws Error if the underlying PathwaysBuilder does not have session user resolvers configured
+     *
+     * @example
+     * ```typescript
+     * const session = new SessionPathwayBuilder(pathwaysBuilder);
+     *
+     * // Register a user resolver for this session
+     * session.withUserResolver(async () => {
+     *   // Get the user ID associated with this session
+     *   return getUserIdFromSession();
+     * });
+     *
+     * // When writing events, the user ID will be automatically included
+     * await session.write("user/action", actionData);
+     * ```
+     */
+    withUserResolver(resolver: UserIdResolver): this;
     /**
      * Writes data to a pathway, proxying to the underlying PathwaysBuilder
      *

package/esm/pathways/session-pathway.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-pathway.d.ts","sourceRoot":"","sources":["../../src/pathways/session-pathway.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAqBrE;;;;;;GAMG;AACH,qBAAa,qBAAqB,CAEhC,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,EAAE,EAC7C,cAAc,SAAS,MAAM,QAAQ,GAAG,KAAK;IAE7C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA4C;IAC5E,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC;;;;;OAKG;gBAED,eAAe,EAAE,eAAe,CAAC,QAAQ,EAAE,cAAc,CAAC,EAC1D,SAAS,CAAC,EAAE,MAAM;IAMpB;;;;OAIG;IACH,YAAY,IAAI,MAAM;IAItB;;;;;;;;OAQG;IACG,KAAK,CAAC,KAAK,SAAS,cAAc,EACtC,IAAI,EAAE,KAAK,EACX,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,EACrB,QAAQ,CAAC,EAAE,aAAa,EACxB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC;CAU9B"}
+{"version":3,"file":"session-pathway.d.ts","sourceRoot":"","sources":["../../src/pathways/session-pathway.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAqBrE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,qBAAa,qBAAqB,CAEhC,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,EAAE,EAC7C,cAAc,SAAS,MAAM,QAAQ,GAAG,KAAK;IAE7C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA4C;IAC5E,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC;;;;;OAKG;gBAED,eAAe,EAAE,eAAe,CAAC,QAAQ,EAAE,cAAc,CAAC,EAC1D,SAAS,CAAC,EAAE,MAAM;IAMpB;;;;OAIG;IACH,YAAY,IAAI,MAAM;IAItB;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,gBAAgB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAKhD;;;;;;;;OAQG;IACG,KAAK,CAAC,KAAK,SAAS,cAAc,EACtC,IAAI,EAAE,KAAK,EACX,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,EACrB,QAAQ,CAAC,EAAE,aAAa,EACxB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC;CAU9B"}

package/esm/pathways/session-pathway.js

@@ -21,6 +21,38 @@ function generateUUID() {
  *
  * This provides a convenient way to track operations within a user session
  * by automatically including the session ID in metadata.
+ *
+ * Key features:
+ * - Automatic session ID generation if none is provided
+ * - Cross-platform UUID generation (works in Deno, Bun, and Node.js)
+ * - Simple API for accessing the current session ID
+ * - Convenient integration with session-specific user resolvers
+ * - Automatic inclusion of session ID in all write operations
+ * - Support for overriding the session ID on specific writes
+ *
+ * Use cases:
+ * - Tracking user actions across multiple pathway writes
+ * - Connecting related events in a single user session
+ * - Supporting multi-user environments where different users' operations need to be tracked separately
+ * - Building user activity logs with session grouping
+ *
+ * @example
+ * ```typescript
+ * // Create a session pathway with auto-generated ID
+ * const session = new SessionPathwayBuilder(pathwaysBuilder);
+ *
+ * // Get the auto-generated session ID
+ * const sessionId = session.getSessionId();
+ *
+ * // Register a user resolver for this session
+ * session.withUserResolver(async () => getCurrentUserId());
+ *
+ * // Write events with session context
+ * await session.write("order/placed", orderData);
+ * await session.write("user/action", actionData);
+ *
+ * // All events will be associated with the same session ID
+ * ```
  */
 export class SessionPathwayBuilder {
     /**
@@ -53,6 +85,39 @@ export class SessionPathwayBuilder {
     getSessionId() {
         return this.sessionId;
     }
+    /**
+     * Registers a user resolver for this session
+     *
+     * This is a convenience method that calls `pathwaysBuilder.withSessionUserResolver`
+     * with the current session ID, allowing you to set up a resolver specific to this session
+     * without having to manually pass the session ID.
+     *
+     * The resolver will be called whenever events are written through this session,
+     * and the resolved user ID will be included in the event metadata.
+     *
+     * @param resolver The function that resolves to the user ID for this session
+     * @returns The SessionPathwayBuilder instance for chaining
+     *
+     * @throws Error if the underlying PathwaysBuilder does not have session user resolvers configured
+     *
+     * @example
+     * ```typescript
+     * const session = new SessionPathwayBuilder(pathwaysBuilder);
+     *
+     * // Register a user resolver for this session
+     * session.withUserResolver(async () => {
+     *   // Get the user ID associated with this session
+     *   return getUserIdFromSession();
+     * });
+     *
+     * // When writing events, the user ID will be automatically included
+     * await session.write("user/action", actionData);
+     * ```
+     */
+    withUserResolver(resolver) {
+        this.pathwaysBuilder.withSessionUserResolver(this.sessionId, resolver);
+        return this;
+    }
     /**
      * Writes data to a pathway, proxying to the underlying PathwaysBuilder
      *

package/esm/router/index.d.ts

@@ -11,6 +11,49 @@ import type { PathwaysBuilder } from "../pathways/index.js";
 import type { Logger } from "../pathways/logger.js";
 /**
  * Router class that handles directing events to the appropriate pathway handlers
+ *
+ * The PathwayRouter serves as a bridge between incoming webhook events and the PathwaysBuilder,
+ * ensuring events are routed to the correct pathway handlers based on flow type and event type.
+ *
+ * Key features:
+ * - Secure authentication using a secret key
+ * - Automatic mapping of events to the correct pathway handlers
+ * - Compatibility with both legacy and modern Flowcore event formats
+ * - Detailed error handling and logging
+ *
+ * Use cases:
+ * - Building webhook endpoints that receive Flowcore events
+ * - Creating API routes that process events from external systems
+ * - Implementing event-driven microservices that consume Flowcore events
+ *
+ * @example
+ * ```typescript
+ * // Create a router with authentication
+ * const SECRET_KEY = "your-webhook-secret";
+ * const router = new PathwayRouter(pathwaysBuilder, SECRET_KEY);
+ *
+ * // In your HTTP handler:
+ * async function handleWebhook(req: Request) {
+ *   const event = await req.json();
+ *   const secret = req.headers.get("X-Webhook-Secret");
+ *
+ *   try {
+ *     const result = await router.processEvent(event, secret);
+ *     return new Response(JSON.stringify(result), {
+ *       status: 200,
+ *       headers: { "Content-Type": "application/json" }
+ *     });
+ *   } catch (error) {
+ *     console.error("Error processing event:", error);
+ *     return new Response(JSON.stringify({
+ *       error: error.message
+ *     }), {
+ *       status: 401,
+ *       headers: { "Content-Type": "application/json" }
+ *     });
+ *   }
+ * }
+ * ```
  */
 export declare class PathwayRouter {
     private readonly pathways;
@@ -28,10 +71,48 @@ export declare class PathwayRouter {
     /**
      * Process an incoming event by routing it to the appropriate pathway handler
      *
-     * @param event The event to process
+     * This method handles the complete lifecycle of an incoming event:
+     * 1. Validates the authentication using the provided secret key
+     * 2. Maps the event to the correct pathway based on flowType and eventType
+     * 3. Delegates processing to the PathwaysBuilder
+     * 4. Provides detailed error handling and feedback
+     *
+     * The method supports both modern Flowcore events and legacy events that used
+     * the "aggregator" field instead of "flowType". It automatically converts legacy
+     * events to the modern format before processing.
+     *
+     * @param event The event to process, containing flowType, eventType, and payload
      * @param providedSecret The secret key provided for authentication
      * @returns Result of the event processing with success status and message
-     * @throws Error if authentication fails, pathway is not found, or processing fails
+     *
+     * @throws Error if authentication fails (401 unauthorized)
+     * @throws Error if the pathway is not found (404 not found)
+     * @throws Error if processing fails (includes the original error message)
+     *
+     * @example
+     * ```typescript
+     * // Basic usage
+     * try {
+     *   const result = await router.processEvent(incomingEvent, secretFromHeader);
+     *   console.log("Success:", result.message);
+     * } catch (error) {
+     *   console.error("Failed to process event:", error.message);
+     * }
+     *
+     * // With error handling for different error types
+     * try {
+     *   const result = await router.processEvent(event, secret);
+     *   return { status: 200, body: result };
+     * } catch (error) {
+     *   if (error.message.includes("Invalid secret key")) {
+     *     return { status: 401, body: { error: "Unauthorized" } };
+     *   } else if (error.message.includes("not found")) {
+     *     return { status: 404, body: { error: "Pathway not found" } };
+     *   } else {
+     *     return { status: 500, body: { error: "Processing failed" } };
+     *   }
+     * }
+     * ```
      */
     processEvent(event: FlowcoreLegacyEvent, providedSecret: string): Promise<{
         success: boolean;

package/esm/router/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/router/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAErE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAGnD;;GAEG;AACH,qBAAa,aAAa;IAatB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAb5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAEhC;;;;;;;OAOG;gBAGgB,QAAQ,EAAE,eAAe,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,EAC9C,SAAS,EAAE,MAAM,EAClC,MAAM,CAAC,EAAE,MAAM;IAajB;;;;;;;OAOG;IACG,YAAY,CAAC,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAkDvH"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/router/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAErE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAGnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,qBAAa,aAAa;IAatB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAb5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAEhC;;;;;;;OAOG;gBAGgB,QAAQ,EAAE,eAAe,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,EAC9C,SAAS,EAAE,MAAM,EAClC,MAAM,CAAC,EAAE,MAAM;IAajB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6CG;IACG,YAAY,CAAC,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAkDvH"}

package/esm/router/index.js

@@ -1,6 +1,49 @@
 import { NoopLogger } from "../pathways/logger.js";
 /**
  * Router class that handles directing events to the appropriate pathway handlers
+ *
+ * The PathwayRouter serves as a bridge between incoming webhook events and the PathwaysBuilder,
+ * ensuring events are routed to the correct pathway handlers based on flow type and event type.
+ *
+ * Key features:
+ * - Secure authentication using a secret key
+ * - Automatic mapping of events to the correct pathway handlers
+ * - Compatibility with both legacy and modern Flowcore event formats
+ * - Detailed error handling and logging
+ *
+ * Use cases:
+ * - Building webhook endpoints that receive Flowcore events
+ * - Creating API routes that process events from external systems
+ * - Implementing event-driven microservices that consume Flowcore events
+ *
+ * @example
+ * ```typescript
+ * // Create a router with authentication
+ * const SECRET_KEY = "your-webhook-secret";
+ * const router = new PathwayRouter(pathwaysBuilder, SECRET_KEY);
+ *
+ * // In your HTTP handler:
+ * async function handleWebhook(req: Request) {
+ *   const event = await req.json();
+ *   const secret = req.headers.get("X-Webhook-Secret");
+ *
+ *   try {
+ *     const result = await router.processEvent(event, secret);
+ *     return new Response(JSON.stringify(result), {
+ *       status: 200,
+ *       headers: { "Content-Type": "application/json" }
+ *     });
+ *   } catch (error) {
+ *     console.error("Error processing event:", error);
+ *     return new Response(JSON.stringify({
+ *       error: error.message
+ *     }), {
+ *       status: 401,
+ *       headers: { "Content-Type": "application/json" }
+ *     });
+ *   }
+ * }
+ * ```
  */
 export class PathwayRouter {
     /**
@@ -43,10 +86,48 @@ export class PathwayRouter {
     /**
      * Process an incoming event by routing it to the appropriate pathway handler
      *
-     * @param event The event to process
+     * This method handles the complete lifecycle of an incoming event:
+     * 1. Validates the authentication using the provided secret key
+     * 2. Maps the event to the correct pathway based on flowType and eventType
+     * 3. Delegates processing to the PathwaysBuilder
+     * 4. Provides detailed error handling and feedback
+     *
+     * The method supports both modern Flowcore events and legacy events that used
+     * the "aggregator" field instead of "flowType". It automatically converts legacy
+     * events to the modern format before processing.
+     *
+     * @param event The event to process, containing flowType, eventType, and payload
      * @param providedSecret The secret key provided for authentication
      * @returns Result of the event processing with success status and message
-     * @throws Error if authentication fails, pathway is not found, or processing fails
+     *
+     * @throws Error if authentication fails (401 unauthorized)
+     * @throws Error if the pathway is not found (404 not found)
+     * @throws Error if processing fails (includes the original error message)
+     *
+     * @example
+     * ```typescript
+     * // Basic usage
+     * try {
+     *   const result = await router.processEvent(incomingEvent, secretFromHeader);
+     *   console.log("Success:", result.message);
+     * } catch (error) {
+     *   console.error("Failed to process event:", error.message);
+     * }
+     *
+     * // With error handling for different error types
+     * try {
+     *   const result = await router.processEvent(event, secret);
+     *   return { status: 200, body: result };
+     * } catch (error) {
+     *   if (error.message.includes("Invalid secret key")) {
+     *     return { status: 401, body: { error: "Unauthorized" } };
+     *   } else if (error.message.includes("not found")) {
+     *     return { status: 404, body: { error: "Pathway not found" } };
+     *   } else {
+     *     return { status: 500, body: { error: "Processing failed" } };
+     *   }
+     * }
+     * ```
      */
     async processEvent(event, providedSecret) {
         // Validate secret key

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@flowcore/pathways",
-  "version": "0.8.0",
+  "version": "0.9.1",
   "description": "A TypeScript Library for creating Flowcore Pathways, simplifying the integration with the flowcore platform",
-  "homepage": "https://github.com/flowcore-io/flowcore-sdk#readme",
+  "homepage": "https://github.com/flowcore-io/flowcore-pathways#readme",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/flowcore-io/flowcore-sdk.git"
+    "url": "git+https://github.com/flowcore-io/flowcore-pathways.git"
   },
   "license": "MIT",
   "bugs": {
-    "url": "https://github.com/flowcore-io/flowcore-sdk/issues"
+    "url": "https://github.com/flowcore-io/flowcore-pathways/issues"
   },
   "main": "./script/mod.js",
   "module": "./esm/mod.js",
@@ -25,7 +25,6 @@
   "dependencies": {
     "@flowcore/sdk-transformer-core": "^2.3.6",
     "@sinclair/typebox": "^0.34.27",
-    "bun-sqlite-key-value": "1.13.1",
     "node-cache": "5.1.2",
     "postgres": "^3.4.3",
     "rxjs": "^7.8.1"

package/script/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/script/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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"}