@flowcore/pathways 0.7.0 → 0.9.0

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,6 +1,6 @@
 {
   "name": "@flowcore/pathways",
-  "version": "0.7.0",
+  "version": "0.9.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/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";
 /**
@@ -62,6 +63,7 @@ export declare class PathwaysBuilder<TPathway extends Record<string, unknown> =
     private pathwayTimeoutMs;
     private auditHandler?;
     private userIdResolver?;
+    private readonly sessionUserResolvers;
     private readonly logger;
     private readonly baseUrl;
     private readonly tenant;
@@ -76,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
@@ -103,6 +107,46 @@ export declare class PathwaysBuilder<TPathway extends Record<string, unknown> =
      * @returns The PathwaysBuilder instance with custom user ID resolver configured
      */
     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>;
+    /**
+     * Gets a user resolver for a specific session ID
+     * @param sessionId The session ID to get the resolver for
+     * @returns The resolver function for the session, or undefined if none exists
+     */
+    getSessionUserResolver(sessionId: string): UserIdResolver | undefined;
     /**
      * Process a pathway event with error handling and retries
      * @param pathway The pathway to process
@@ -189,10 +233,5 @@ export declare class PathwaysBuilder<TPathway extends Record<string, unknown> =
      * @throws Error if the timeout is exceeded
      */
     private waitForPathwayToBeProcessed;
-    /**
-     * Creates a new instance of PathwaysBuilder with the same configuration
-     * @returns A new PathwaysBuilder instance with the same type parameters and configuration
-     */
-    clone(): PathwaysBuilder<TPathway, TWritablePaths>;
 }
 //# sourceMappingURL=builder.d.ts.map

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":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAExD,OAAO,KAAK,EAAyD,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AAG/H,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAE1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AACnD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,UAAU,EAAE,YAAY,EAAE,mBAAmB,EAA6B,eAAe,EAAE,MAAM,YAAY,CAAA;AAsB3J;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAA;AAEzC;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,KAAK,IAAI,CAAA;AAEvE;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;AAElD;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,kBAAkB;IACjE;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,eAAe,CAE1B,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,EAAE,EAC7C,cAAc,SAAS,MAAM,QAAQ,GAAG,KAAK;IAE7C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2B;IACpD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAGxB;IACD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAGhC;IACD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAG9B;IACD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAG9B;IACD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAyE;IAC5G,OAAO,CAAC,QAAQ,CAAC,OAAO,CAGvB;IACD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyE;IACjG,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyE;IAClG,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuE;IAChG,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAuE;IAClG,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuE;IACnG,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAiC;IAC9D,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAA0B;IAChE,OAAO,CAAC,YAAY,CAA2C;IAC/D,OAAO,CAAC,gBAAgB,CAAqC;IAG7D,OAAO,CAAC,YAAY,CAAC,CAAc;IACnC,OAAO,CAAC,cAAc,CAAC,CAAgB;IAGvC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAyB;IAG9D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAG/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAE/B;;;;;;;;;;OAUG;gBACS,EACV,OAAO,EACP,MAAM,EACN,QAAQ,EACR,MAAM,EACN,gBAAgB,EAChB,MAAM,EACN,oBAAoB,GACrB,EAAE;QACD,OAAO,EAAE,MAAM,CAAA;QACf,MAAM,EAAE,MAAM,CAAA;QACd,QAAQ,EAAE,MAAM,CAAA;QAChB,MAAM,EAAE,MAAM,CAAA;QACd,gBAAgB,CAAC,EAAE,MAAM,CAAA;QACzB,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,oBAAoB,CAAC,EAAE,SAAS,CAAA;KACjC;IAsCD;;;;OAIG;IACH,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,eAAe,CAAC,QAAQ,EAAE,cAAc,CAAC;IAMhF;;;;OAIG;IACH,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,eAAe,CAAC,QAAQ,EAAE,cAAc,CAAC;IAM3E;;;;OAIG;IACH,gBAAgB,CAAC,QAAQ,EAAE,cAAc,GAAG,eAAe,CAAC,QAAQ,EAAE,cAAc,CAAC;IAMrF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACH,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,eAAe,CAAC,QAAQ,EAAE,cAAc,CAAC;IAU/G;;;;OAIG;IACH,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAQrE;;;;;OAKG;IACU,OAAO,CAAC,OAAO,EAAE,MAAM,QAAQ,EAAE,IAAI,EAAE,aAAa;IA6IjE;;;;;;;;OAQG;IACH,QAAQ,CACN,CAAC,SAAS,MAAM,EAChB,CAAC,SAAS,MAAM,EAChB,CAAC,SAAS,OAAO,EACjB,CAAC,SAAS,OAAO,GAAG,IAAI,EAExB,QAAQ,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG;QAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GAChG,eAAe,CAChB,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAC9C,cAAc,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CACtD;IA4DD;;;;;;OAMG;IACH,GAAG,CAAC,KAAK,SAAS,MAAM,QAAQ,EAAE,IAAI,EAAE,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;IAK/D;;;;;;;;;;OAUG;IACH,MAAM,CAAC,KAAK,SAAS,MAAM,QAAQ,EACjC,IAAI,EAAE,KAAK,EACX,OAAO,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,GAAG;QAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAA;KAAE,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GACxG,IAAI;IAqBP;;;;;OAKG;IACH,SAAS,CAAC,KAAK,SAAS,MAAM,QAAQ,EACpC,IAAI,EAAE,KAAK,EACX,OAAO,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,GAAG;QAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAA;KAAE,KAAK,IAAI,EACvF,IAAI,GAAE,QAAQ,GAAG,OAAO,GAAG,KAAgB,GAC1C,IAAI;IA4BP;;;;OAIG;IACH,OAAO,CAAC,KAAK,SAAS,MAAM,QAAQ,EAClC,IAAI,EAAE,KAAK,EACX,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,GAAG;QAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAA;KAAE,KAAK,IAAI,GACpG,IAAI;IAmBP;;;OAGG;IACH,UAAU,CACR,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,GACrE,IAAI;IAMP;;;;;;;OAOG;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;IAuH7B;;;;;;;;;;OAUG;YACW,2BAA2B;CA4C1C"}

package/script/pathways/builder.js

@@ -18,6 +18,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
  *
@@ -42,8 +46,9 @@ 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,
@@ -153,6 +158,13 @@ class PathwaysBuilder {
             writable: true,
             value: void 0
         });
+        // Session-specific user resolvers
+        Object.defineProperty(this, "sessionUserResolvers", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
         // Logger instance (but not using it yet due to TypeScript errors)
         Object.defineProperty(this, "logger", {
             enumerable: true,
@@ -192,6 +204,9 @@ class PathwaysBuilder {
         this.tenant = tenant;
         this.dataCore = dataCore;
         this.apiKey = apiKey;
+        if (sessionUserResolvers) {
+            this.sessionUserResolvers = sessionUserResolvers;
+        }
         this.logger.debug('Initializing PathwaysBuilder', {
             baseUrl,
             tenant,
@@ -243,6 +258,59 @@ class PathwaysBuilder {
         this.userIdResolver = resolver;
         return this;
     }
+    /**
+     * 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, DEFAULT_SESSION_USER_RESOLVER_TTL_MS);
+        return this;
+    }
+    /**
+     * Gets a user resolver for a specific session ID
+     * @param sessionId The session ID to get the resolver for
+     * @returns The resolver function for the session, or undefined if none exists
+     */
+    getSessionUserResolver(sessionId) {
+        if (!this.sessionUserResolvers) {
+            return undefined;
+        }
+        const resolver = this.sessionUserResolvers.get(sessionId);
+        return resolver;
+    }
     /**
      * Process a pathway event with error handling and retries
      * @param pathway The pathway to process
@@ -537,7 +605,8 @@ class PathwaysBuilder {
             pathway: pathStr,
             metadata,
             options: {
-                fireAndForget: options?.fireAndForget
+                fireAndForget: options?.fireAndForget,
+                sessionId: options?.sessionId
             }
         });
         if (!this.pathways[path]) {
@@ -561,17 +630,43 @@ class PathwaysBuilder {
         }
         // Create a copy of the metadata to avoid modifying the original
         const finalMetadata = metadata ? { ...metadata } : {};
+        // Check for session-specific user resolver
+        let userId;
+        if (options?.sessionId) {
+            const sessionUserResolver = this.getSessionUserResolver(options.sessionId);
+            if (sessionUserResolver) {
+                try {
+                    userId = await sessionUserResolver();
+                    this.logger.debug(`Using session-specific user resolver`, {
+                        pathway: pathStr,
+                        sessionId: options.sessionId,
+                        userId
+                    });
+                }
+                catch (error) {
+                    this.logger.error(`Error resolving session user ID`, error instanceof Error ? error : new Error(String(error)), {
+                        pathway: pathStr,
+                        sessionId: options.sessionId
+                    });
+                }
+            }
+        }
         // Process audit metadata if audit is configured
         if (this.userIdResolver) {
-            this.logger.debug(`Resolving user ID for audit metadata`, { pathway: pathStr });
-            const userId = await this.userIdResolver();
-            // Determine the audit mode: default is "user" unless explicitly specified as "system"
-            const auditMode = options?.auditMode ?? "user";
-            this.logger.debug(`Adding audit metadata`, {
-                pathway: pathStr,
-                auditMode,
-                userId
-            });
+            // Only use global resolver if we don't already have a user ID from a session resolver
+            if (!userId) {
+                this.logger.debug(`Resolving user ID for audit metadata`, { pathway: pathStr });
+                userId = await this.userIdResolver();
+            }
+        }
+        // Determine the audit mode: default is "user" unless explicitly specified as "system"
+        const auditMode = options?.auditMode ?? "user";
+        this.logger.debug(`Adding audit metadata`, {
+            pathway: pathStr,
+            auditMode,
+            userId
+        });
+        if (userId) {
             // Add appropriate audit metadata based on mode
             if (auditMode === "system") {
                 finalMetadata["audit/user-id"] = "system";
@@ -657,37 +752,5 @@ class PathwaysBuilder {
             attempts
         });
     }
-    /**
-     * Creates a new instance of PathwaysBuilder with the same configuration
-     * @returns A new PathwaysBuilder instance with the same type parameters and configuration
-     */
-    clone() {
-        this.logger.debug('Building new PathwaysBuilder instance with same configuration');
-        // Create new instance with same base configuration
-        const builder = new PathwaysBuilder({
-            baseUrl: this.baseUrl,
-            tenant: this.tenant,
-            dataCore: this.dataCore,
-            apiKey: this.apiKey,
-            pathwayTimeoutMs: this.pathwayTimeoutMs,
-            logger: this.logger
-        });
-        // Copy pathway state configuration if custom
-        if (!(this.pathwayState instanceof internal_pathway_state_js_1.InternalPathwayState)) {
-            builder.withPathwayState(this.pathwayState);
-        }
-        // Copy audit configuration if present
-        if (this.auditHandler) {
-            builder.withAudit(this.auditHandler);
-        }
-        // Copy user resolver if present
-        if (this.userIdResolver) {
-            builder.withUserResolver(this.userIdResolver);
-        }
-        // The new instance will have the same type parameters but
-        // it will be empty of pathways until they are registered again
-        this.logger.info('New PathwaysBuilder instance created');
-        return builder;
-    }
 }
 exports.PathwaysBuilder = PathwaysBuilder;

package/script/pathways/index.d.ts

@@ -3,6 +3,7 @@
  *
  * Exports all components needed to build and manage pathways including:
  * - Pathway builder
+ * - Session pathway builder
  * - State management
  * - Storage adapters (KV, Postgres)
  * - Logging
@@ -15,5 +16,6 @@ export * from "./internal-pathway.state.js";
 export * from "./kv/kv-adapter.js";
 export * from "./logger.js";
 export * from "./postgres/index.js";
+export * from "./session-pathway.js";
 export * from "./types.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pathways/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,cAAc,cAAc,CAAC;AAC7B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pathways/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,cAAc,cAAc,CAAC;AAC7B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC"}

package/script/pathways/index.js

@@ -19,6 +19,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
  *
  * Exports all components needed to build and manage pathways including:
  * - Pathway builder
+ * - Session pathway builder
  * - State management
  * - Storage adapters (KV, Postgres)
  * - Logging
@@ -31,4 +32,5 @@ __exportStar(require("./internal-pathway.state.js"), exports);
 __exportStar(require("./kv/kv-adapter.js"), exports);
 __exportStar(require("./logger.js"), exports);
 __exportStar(require("./postgres/index.js"), exports);
+__exportStar(require("./session-pathway.js"), exports);
 __exportStar(require("./types.js"), exports);

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