@flowcore/pathways 0.2.1 → 0.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (98) hide show
  1. package/CHANGELOG.md +16 -0
  2. package/esm/common/flowcore.type.d.ts +3 -3
  3. package/esm/common/flowcore.type.d.ts.map +1 -1
  4. package/esm/common/index.d.ts +2 -0
  5. package/esm/common/index.d.ts.map +1 -1
  6. package/esm/common/index.js +2 -0
  7. package/esm/compatibility/flowcore-transformer-core.sdk.d.ts +4 -0
  8. package/esm/compatibility/flowcore-transformer-core.sdk.d.ts.map +1 -1
  9. package/esm/compatibility/flowcore-transformer-core.sdk.js +2 -0
  10. package/esm/contracts/index.d.ts +2 -0
  11. package/esm/contracts/index.d.ts.map +1 -1
  12. package/esm/contracts/index.js +2 -0
  13. package/esm/mod.d.ts +2 -0
  14. package/esm/mod.d.ts.map +1 -1
  15. package/esm/mod.js +2 -0
  16. package/esm/pathways/builder.d.ts +87 -0
  17. package/esm/pathways/builder.d.ts.map +1 -1
  18. package/esm/pathways/builder.js +83 -8
  19. package/esm/pathways/index.d.ts +2 -0
  20. package/esm/pathways/index.d.ts.map +1 -1
  21. package/esm/pathways/index.js +2 -0
  22. package/esm/pathways/internal-pathway.state.d.ts +5 -7
  23. package/esm/pathways/internal-pathway.state.d.ts.map +1 -1
  24. package/esm/pathways/internal-pathway.state.js +5 -7
  25. package/esm/pathways/kv/bun-kv-adapter.d.ts +5 -7
  26. package/esm/pathways/kv/bun-kv-adapter.d.ts.map +1 -1
  27. package/esm/pathways/kv/bun-kv-adapter.js +5 -7
  28. package/esm/pathways/kv/kv-adapter.d.ts +7 -7
  29. package/esm/pathways/kv/kv-adapter.js +1 -1
  30. package/esm/pathways/kv/node-kv-adapter.d.ts +6 -8
  31. package/esm/pathways/kv/node-kv-adapter.d.ts.map +1 -1
  32. package/esm/pathways/kv/node-kv-adapter.js +6 -8
  33. package/esm/pathways/logger.d.ts +65 -12
  34. package/esm/pathways/logger.d.ts.map +1 -1
  35. package/esm/pathways/logger.js +48 -3
  36. package/esm/pathways/postgres/index.d.ts +2 -0
  37. package/esm/pathways/postgres/index.d.ts.map +1 -1
  38. package/esm/pathways/postgres/index.js +2 -0
  39. package/esm/pathways/postgres/postgres-adapter.d.ts +20 -29
  40. package/esm/pathways/postgres/postgres-adapter.d.ts.map +1 -1
  41. package/esm/pathways/postgres/postgres-adapter.js +12 -17
  42. package/esm/pathways/postgres/postgres-pathway-state.d.ts +2 -6
  43. package/esm/pathways/postgres/postgres-pathway-state.d.ts.map +1 -1
  44. package/esm/pathways/postgres/postgres-pathway-state.js +2 -4
  45. package/esm/pathways/types.d.ts +48 -3
  46. package/esm/pathways/types.d.ts.map +1 -1
  47. package/esm/router/index.d.ts +17 -11
  48. package/esm/router/index.d.ts.map +1 -1
  49. package/esm/router/index.js +21 -24
  50. package/package.json +2 -2
  51. package/script/common/flowcore.type.d.ts +3 -3
  52. package/script/common/flowcore.type.d.ts.map +1 -1
  53. package/script/common/index.d.ts +2 -0
  54. package/script/common/index.d.ts.map +1 -1
  55. package/script/common/index.js +2 -0
  56. package/script/compatibility/flowcore-transformer-core.sdk.d.ts +4 -0
  57. package/script/compatibility/flowcore-transformer-core.sdk.d.ts.map +1 -1
  58. package/script/compatibility/flowcore-transformer-core.sdk.js +2 -0
  59. package/script/contracts/index.d.ts +2 -0
  60. package/script/contracts/index.d.ts.map +1 -1
  61. package/script/contracts/index.js +2 -0
  62. package/script/mod.d.ts +2 -0
  63. package/script/mod.d.ts.map +1 -1
  64. package/script/mod.js +2 -0
  65. package/script/pathways/builder.d.ts +87 -0
  66. package/script/pathways/builder.d.ts.map +1 -1
  67. package/script/pathways/builder.js +83 -8
  68. package/script/pathways/index.d.ts +2 -0
  69. package/script/pathways/index.d.ts.map +1 -1
  70. package/script/pathways/index.js +2 -0
  71. package/script/pathways/internal-pathway.state.d.ts +5 -7
  72. package/script/pathways/internal-pathway.state.d.ts.map +1 -1
  73. package/script/pathways/internal-pathway.state.js +5 -7
  74. package/script/pathways/kv/bun-kv-adapter.d.ts +5 -7
  75. package/script/pathways/kv/bun-kv-adapter.d.ts.map +1 -1
  76. package/script/pathways/kv/bun-kv-adapter.js +5 -7
  77. package/script/pathways/kv/kv-adapter.d.ts +7 -7
  78. package/script/pathways/kv/kv-adapter.js +1 -1
  79. package/script/pathways/kv/node-kv-adapter.d.ts +6 -8
  80. package/script/pathways/kv/node-kv-adapter.d.ts.map +1 -1
  81. package/script/pathways/kv/node-kv-adapter.js +6 -8
  82. package/script/pathways/logger.d.ts +65 -12
  83. package/script/pathways/logger.d.ts.map +1 -1
  84. package/script/pathways/logger.js +48 -3
  85. package/script/pathways/postgres/index.d.ts +2 -0
  86. package/script/pathways/postgres/index.d.ts.map +1 -1
  87. package/script/pathways/postgres/index.js +2 -0
  88. package/script/pathways/postgres/postgres-adapter.d.ts +20 -29
  89. package/script/pathways/postgres/postgres-adapter.d.ts.map +1 -1
  90. package/script/pathways/postgres/postgres-adapter.js +12 -17
  91. package/script/pathways/postgres/postgres-pathway-state.d.ts +2 -6
  92. package/script/pathways/postgres/postgres-pathway-state.d.ts.map +1 -1
  93. package/script/pathways/postgres/postgres-pathway-state.js +2 -4
  94. package/script/pathways/types.d.ts +48 -3
  95. package/script/pathways/types.d.ts.map +1 -1
  96. package/script/router/index.d.ts +17 -11
  97. package/script/router/index.d.ts.map +1 -1
  98. package/script/router/index.js +21 -24
@@ -2,19 +2,29 @@ import type { TSchema } from "@sinclair/typebox";
2
2
  import type { WebhookFileData, WebhookSendOptions } from "@flowcore/sdk-transformer-core";
3
3
  /**
4
4
  * Helper type to create a custom type error for non-writable pathways
5
+ * @template T The string type to create an error for
5
6
  */
6
7
  type NonWritablePathwayError<T extends string> = T & {
7
8
  readonly __nonWritablePathwayError: "This pathway is not writable. To make it writable, remove 'writable: false' from the pathway contract.";
8
9
  };
9
10
  /**
10
11
  * Contract for defining a pathway
11
- * @template F - The flow type
12
- * @template E - The event type
13
- * @template T - The schema type
12
+ * @template F The flow type
13
+ * @template E The event type
14
+ * @template T The schema type
14
15
  */
15
16
  export interface PathwayContract<F extends string, E extends string, T extends TSchema> {
17
+ /**
18
+ * The flow type for this pathway
19
+ */
16
20
  flowType: F;
21
+ /**
22
+ * The event type for this pathway
23
+ */
17
24
  eventType: E;
25
+ /**
26
+ * The schema that defines the structure of events for this pathway
27
+ */
18
28
  schema: T;
19
29
  /**
20
30
  * Whether the pathway is writable. Use `false as const` to make the pathway non-writable at compile time.
@@ -63,24 +73,59 @@ export interface PathwayContract<F extends string, E extends string, T extends T
63
73
  */
64
74
  isFilePathway?: boolean;
65
75
  }
76
+ /**
77
+ * Creates a string key from flow type and event type in the format `flowType/eventType`
78
+ * @template F The flow type
79
+ * @template E The event type
80
+ */
66
81
  export type PathwayKey<F extends string, E extends string> = `${F}/${E}`;
82
+ /**
83
+ * Interface for event metadata, extending Record<string, unknown>
84
+ */
67
85
  export interface EventMetadata extends Record<string, unknown> {
68
86
  }
87
+ /**
88
+ * Function type for sending an event to a webhook
89
+ * @template EventPayload The type of the event payload
90
+ */
69
91
  export type SendWebhook<EventPayload> = (payload: EventPayload, metadata?: EventMetadata, options?: WebhookSendOptions) => Promise<string>;
92
+ /**
93
+ * Function type for sending a file to a webhook
94
+ */
70
95
  export type SendFilehook = (payload: WebhookFileData, metadata?: EventMetadata, options?: WebhookSendOptions) => Promise<string[]>;
71
96
  /**
72
97
  * Helper type to create a better error message for non-writable pathways
98
+ * @template T The string type for the pathway
99
+ * @template IsWritable Boolean indicating if the pathway is writable
73
100
  */
74
101
  export type WritablePathway<T extends string, IsWritable extends boolean> = IsWritable extends false ? NonWritablePathwayError<T> : T;
102
+ /**
103
+ * Interface for managing pathway processing state
104
+ */
75
105
  export type PathwayState = {
106
+ /**
107
+ * Checks if an event has been processed
108
+ * @param eventId The ID of the event to check
109
+ * @returns Boolean indicating if the event has been processed
110
+ */
76
111
  isProcessed: (eventId: string) => (boolean | Promise<boolean>);
112
+ /**
113
+ * Marks an event as processed
114
+ * @param eventId The ID of the event to mark as processed
115
+ */
77
116
  setProcessed: (eventId: string) => (void | Promise<void>);
78
117
  };
79
118
  /**
80
119
  * Options for pathway writes, extending WebhookSendOptions
81
120
  */
82
121
  export type PathwayWriteOptions = WebhookSendOptions & {
122
+ /**
123
+ * If true, doesn't wait for confirmation of event delivery
124
+ */
83
125
  fireAndForget?: boolean;
126
+ /**
127
+ * Additional HTTP headers to include with the request
128
+ */
84
129
  headers?: Record<string, string>;
85
130
  };
86
131
  export {};
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/pathways/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AAEzF;;GAEG;AACH,KAAK,uBAAuB,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,GAAG;IACnD,QAAQ,CAAC,yBAAyB,EAAE,wGAAwG,CAAA;CAC7I,CAAA;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,OAAO;IACpF,QAAQ,EAAE,CAAC,CAAA;IACX,SAAS,EAAE,CAAC,CAAA;IACZ,MAAM,EAAE,CAAC,CAAA;IACT;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC3B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAED,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,EAAE,CAAA;AAExE,MAAM,WAAW,aAAc,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAAG;AAEjE,MAAM,MAAM,WAAW,CAAC,YAAY,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,kBAAkB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;AAC1I,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,kBAAkB,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;AAElI;;GAEG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,MAAM,EAAE,UAAU,SAAS,OAAO,IAAI,UAAU,SAAS,KAAK,GAAG,uBAAuB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;AAErI,MAAM,MAAM,YAAY,GAAG;IACzB,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAA;IAC9D,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;CAC1D,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,kBAAkB,GAAG;IACrD,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC,CAAA"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/pathways/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AAEzF;;;GAGG;AACH,KAAK,uBAAuB,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,GAAG;IACnD,QAAQ,CAAC,yBAAyB,EAAE,wGAAwG,CAAA;CAC7I,CAAA;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,OAAO;IACpF;;OAEG;IACH,QAAQ,EAAE,CAAC,CAAA;IAEX;;OAEG;IACH,SAAS,EAAE,CAAC,CAAA;IAEZ;;OAEG;IACH,MAAM,EAAE,CAAC,CAAA;IAET;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAElB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;IAE3B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAED;;;;GAIG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,EAAE,CAAA;AAExE;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAAG;AAEjE;;;GAGG;AACH,MAAM,MAAM,WAAW,CAAC,YAAY,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,kBAAkB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;AAE1I;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,kBAAkB,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;AAElI;;;;GAIG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,MAAM,EAAE,UAAU,SAAS,OAAO,IAAI,UAAU,SAAS,KAAK,GAAG,uBAAuB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;AAErI;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB;;;;OAIG;IACH,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAA;IAE9D;;;OAGG;IACH,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;CAC1D,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,kBAAkB,GAAG;IACrD;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IAEvB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC,CAAA"}
@@ -1,10 +1,16 @@
1
+ /**
2
+ * Router module for Flowcore Pathways
3
+ *
4
+ * This module provides routing functionality to direct incoming events
5
+ * to the appropriate pathway handlers based on flow type and event type.
6
+ *
7
+ * @module
8
+ */
1
9
  import type { FlowcoreLegacyEvent } from "../common/flowcore.type.js";
2
10
  import type { PathwaysBuilder } from "../pathways/index.js";
3
11
  import type { Logger } from "../pathways/logger.js";
4
12
  /**
5
13
  * Router class that handles directing events to the appropriate pathway handlers
6
- *
7
- * @class PathwayRouter
8
14
  */
9
15
  export declare class PathwayRouter {
10
16
  private readonly pathways;
@@ -13,19 +19,19 @@ export declare class PathwayRouter {
13
19
  /**
14
20
  * Creates a new instance of PathwayRouter
15
21
  *
16
- * @param {PathwaysBuilder<Record<string, any>>} pathways - The pathways builder instance that contains all registered pathways
17
- * @param {string} secretKey - Secret key used for authentication when processing events
18
- * @param {Logger} [logger] - Optional logger instance (defaults to NoopLogger if not provided)
19
- * @throws {Error} Will throw an error if secretKey is empty or not provided
22
+ * @param pathways The pathways builder instance that contains all registered pathways
23
+ * @param secretKey Secret key used for authentication when processing events
24
+ * @param logger Optional logger instance (defaults to NoopLogger if not provided)
25
+ * @throws Error if secretKey is empty or not provided
20
26
  */
21
27
  constructor(pathways: PathwaysBuilder<Record<string, any>>, secretKey: string, logger?: Logger);
22
28
  /**
23
- * Processes an incoming event by routing it to the appropriate pathway
29
+ * Process an incoming event by routing it to the appropriate pathway handler
24
30
  *
25
- * @param {FlowcoreLegacyEvent} event - The event to process
26
- * @param {string} providedSecret - The secret key provided for authentication
27
- * @returns {Promise<{ success: boolean; message: string }>} Result of the event processing
28
- * @throws {Error} Will throw an error if authentication fails, pathway is not found, or processing fails
31
+ * @param event The event to process
32
+ * @param providedSecret The secret key provided for authentication
33
+ * @returns Result of the event processing with success status and message
34
+ * @throws Error if authentication fails, pathway is not found, or processing fails
29
35
  */
30
36
  processEvent(event: FlowcoreLegacyEvent, providedSecret: string): Promise<{
31
37
  success: boolean;
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/router/index.ts"],"names":[],"mappings":"AAAA,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;;;;GAIG;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;IAYjB;;;;;;;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;CAoDvH"}
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"}
@@ -1,17 +1,15 @@
1
1
  import { NoopLogger } from "../pathways/logger.js";
2
2
  /**
3
3
  * Router class that handles directing events to the appropriate pathway handlers
4
- *
5
- * @class PathwayRouter
6
4
  */
7
5
  export class PathwayRouter {
8
6
  /**
9
7
  * Creates a new instance of PathwayRouter
10
8
  *
11
- * @param {PathwaysBuilder<Record<string, any>>} pathways - The pathways builder instance that contains all registered pathways
12
- * @param {string} secretKey - Secret key used for authentication when processing events
13
- * @param {Logger} [logger] - Optional logger instance (defaults to NoopLogger if not provided)
14
- * @throws {Error} Will throw an error if secretKey is empty or not provided
9
+ * @param pathways The pathways builder instance that contains all registered pathways
10
+ * @param secretKey Secret key used for authentication when processing events
11
+ * @param logger Optional logger instance (defaults to NoopLogger if not provided)
12
+ * @throws Error if secretKey is empty or not provided
15
13
  */
16
14
  constructor(
17
15
  // deno-lint-ignore no-explicit-any
@@ -36,24 +34,26 @@ export class PathwayRouter {
36
34
  });
37
35
  this.logger = logger ?? new NoopLogger();
38
36
  if (!secretKey || secretKey.trim() === "") {
39
- this.logger.error("Secret key is required for PathwayRouter");
40
- throw new Error("Secret key is required for PathwayRouter");
37
+ const errorMsg = "Secret key is required for PathwayRouter";
38
+ this.logger.error(errorMsg, new Error(errorMsg));
39
+ throw new Error(errorMsg);
41
40
  }
42
41
  this.logger.debug("PathwayRouter initialized");
43
42
  }
44
43
  /**
45
- * Processes an incoming event by routing it to the appropriate pathway
44
+ * Process an incoming event by routing it to the appropriate pathway handler
46
45
  *
47
- * @param {FlowcoreLegacyEvent} event - The event to process
48
- * @param {string} providedSecret - The secret key provided for authentication
49
- * @returns {Promise<{ success: boolean; message: string }>} Result of the event processing
50
- * @throws {Error} Will throw an error if authentication fails, pathway is not found, or processing fails
46
+ * @param event The event to process
47
+ * @param providedSecret The secret key provided for authentication
48
+ * @returns Result of the event processing with success status and message
49
+ * @throws Error if authentication fails, pathway is not found, or processing fails
51
50
  */
52
51
  async processEvent(event, providedSecret) {
53
52
  // Validate secret key
54
53
  if (!providedSecret || providedSecret !== this.secretKey) {
55
- this.logger.error("Invalid secret key provided");
56
- throw new Error("Invalid secret key");
54
+ const errorMsg = "Invalid secret key";
55
+ this.logger.error(errorMsg, new Error(errorMsg));
56
+ throw new Error(errorMsg);
57
57
  }
58
58
  const compatibleEvent = {
59
59
  ...event,
@@ -65,9 +65,9 @@ export class PathwayRouter {
65
65
  });
66
66
  const pathway = this.pathways.get(pathwayKey);
67
67
  if (!pathway) {
68
- const error = `Pathway ${pathwayKey} not found`;
69
- this.logger.error(error);
70
- throw new Error(error);
68
+ const errorMsg = `Pathway ${pathwayKey} not found`;
69
+ this.logger.error(errorMsg, new Error(errorMsg));
70
+ throw new Error(errorMsg);
71
71
  }
72
72
  try {
73
73
  this.logger.debug(`Delegating event processing to pathway handler`, {
@@ -82,15 +82,12 @@ export class PathwayRouter {
82
82
  return { success: true, message: `Event processed through pathway ${pathwayKey}` };
83
83
  }
84
84
  catch (error) {
85
- const errorMessage = error instanceof Error
86
- ? error.message
87
- : String(error);
88
- this.logger.error(`Error processing pathway ${pathwayKey}`, {
89
- error: errorMessage,
85
+ const errorObj = error instanceof Error ? error : new Error(String(error));
86
+ this.logger.error(`Error processing pathway ${pathwayKey}`, errorObj, {
90
87
  eventId: compatibleEvent.eventId
91
88
  });
92
89
  // Rethrow the error with additional context
93
- throw new Error(`Failed to process event in pathway ${pathwayKey}: ${errorMessage}`);
90
+ throw new Error(`Failed to process event in pathway ${pathwayKey}: ${errorObj.message}`);
94
91
  }
95
92
  }
96
93
  }
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@flowcore/pathways",
3
- "version": "0.2.1",
4
- "description": "A Deno Library for creating Flowcore Pathways, simplifying the integration with the flowcore platform",
3
+ "version": "0.2.3",
4
+ "description": "A TypeScript Library for creating Flowcore Pathways, simplifying the integration with the flowcore platform",
5
5
  "homepage": "https://github.com/flowcore-io/flowcore-sdk#readme",
6
6
  "repository": {
7
7
  "type": "git",
@@ -1,11 +1,11 @@
1
1
  import type { FlowcoreEvent } from "../contracts/event.js";
2
2
  /**
3
3
  * Extends the FlowcoreEvent with legacy fields
4
- *
5
- * @typedef {Object} FlowcoreLegacyEvent
6
- * @property {string} [aggregator] - Optional aggregator information for legacy support
7
4
  */
8
5
  export type FlowcoreLegacyEvent = FlowcoreEvent & {
6
+ /**
7
+ * Optional aggregator information for legacy support
8
+ */
9
9
  aggregator?: string;
10
10
  };
11
11
  //# sourceMappingURL=flowcore.type.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"flowcore.type.d.ts","sourceRoot":"","sources":["../../src/common/flowcore.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAE1D;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,aAAa,GAAG;IAChD,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA"}
1
+ {"version":3,"file":"flowcore.type.d.ts","sourceRoot":"","sources":["../../src/common/flowcore.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAE1D;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,aAAa,GAAG;IAChD;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA"}
@@ -2,6 +2,8 @@
2
2
  * Common types and utilities for Flowcore Pathways
3
3
  *
4
4
  * This module exports common types and utilities that are used across the Flowcore Pathways library.
5
+ *
6
+ * @module
5
7
  */
6
8
  export * from "./flowcore.type.js";
7
9
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,oBAAoB,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,oBAAoB,CAAC"}
@@ -18,5 +18,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
18
18
  * Common types and utilities for Flowcore Pathways
19
19
  *
20
20
  * This module exports common types and utilities that are used across the Flowcore Pathways library.
21
+ *
22
+ * @module
21
23
  */
22
24
  __exportStar(require("./flowcore.type.js"), exports);
@@ -3,6 +3,8 @@
3
3
  *
4
4
  * This module re-exports components from the @flowcore/sdk-transformer-core package
5
5
  * to provide backwards compatibility with existing transformer implementations.
6
+ *
7
+ * @module
6
8
  */
7
9
  import transformerCore from "@flowcore/sdk-transformer-core";
8
10
  /**
@@ -11,6 +13,8 @@ import transformerCore from "@flowcore/sdk-transformer-core";
11
13
  export declare const WebhookBuilder: typeof transformerCore.WebhookBuilder;
12
14
  /**
13
15
  * Options for configuring webhook send operations
16
+ *
17
+ * These options control how webhook requests are sent, including timestamps and headers.
14
18
  */
15
19
  export type { WebhookSendOptions } from "@flowcore/sdk-transformer-core";
16
20
  //# sourceMappingURL=flowcore-transformer-core.sdk.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"flowcore-transformer-core.sdk.d.ts","sourceRoot":"","sources":["../../src/compatibility/flowcore-transformer-core.sdk.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,eAAe,MAAM,gCAAgC,CAAA;AAE5D;;GAEG;AACH,eAAO,MAAQ,cAAc,uCAAoB,CAAA;AAEjD;;GAEG;AACH,YAAY,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA"}
1
+ {"version":3,"file":"flowcore-transformer-core.sdk.d.ts","sourceRoot":"","sources":["../../src/compatibility/flowcore-transformer-core.sdk.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,eAAe,MAAM,gCAAgC,CAAA;AAE5D;;GAEG;AACH,eAAO,MAAQ,cAAc,uCAAoB,CAAA;AAEjD;;;;GAIG;AACH,YAAY,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA"}
@@ -9,6 +9,8 @@ exports.WebhookBuilder = void 0;
9
9
  *
10
10
  * This module re-exports components from the @flowcore/sdk-transformer-core package
11
11
  * to provide backwards compatibility with existing transformer implementations.
12
+ *
13
+ * @module
12
14
  */
13
15
  const sdk_transformer_core_1 = __importDefault(require("@flowcore/sdk-transformer-core"));
14
16
  /**
@@ -1,5 +1,7 @@
1
1
  /**
2
2
  * Export all contract types and schemas for Flowcore events
3
+ *
4
+ * @module
3
5
  */
4
6
  export * from "./event.js";
5
7
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contracts/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,YAAY,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contracts/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,YAAY,CAAC"}
@@ -16,5 +16,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
16
16
  Object.defineProperty(exports, "__esModule", { value: true });
17
17
  /**
18
18
  * Export all contract types and schemas for Flowcore events
19
+ *
20
+ * @module
19
21
  */
20
22
  __exportStar(require("./event.js"), exports);
package/script/mod.d.ts CHANGED
@@ -6,6 +6,8 @@
6
6
  * - Event contracts and schemas
7
7
  * - Pathway definitions and builders
8
8
  * - Event routing functionality
9
+ *
10
+ * @module
9
11
  */
10
12
  export * from "./common/index.js";
11
13
  export * from "./contracts/index.js";
@@ -1 +1 @@
1
- {"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC"}
1
+ {"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC"}
package/script/mod.js CHANGED
@@ -22,6 +22,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
22
22
  * - Event contracts and schemas
23
23
  * - Pathway definitions and builders
24
24
  * - Event routing functionality
25
+ *
26
+ * @module
25
27
  */
26
28
  __exportStar(require("./common/index.js"), exports);
27
29
  __exportStar(require("./contracts/index.js"), exports);
@@ -3,12 +3,46 @@ import type { WebhookSendOptions } from "@flowcore/sdk-transformer-core";
3
3
  import type { FlowcoreEvent } from "../contracts/event.js";
4
4
  import type { Logger } from "./logger.js";
5
5
  import type { EventMetadata, PathwayContract, PathwayKey, PathwayState, PathwayWriteOptions, WritablePathway } from "./types.js";
6
+ /**
7
+ * Defines the mode for auditing pathway operations
8
+ * - "user": Normal user-initiated operations
9
+ * - "system": System-initiated operations on behalf of a user
10
+ */
6
11
  export type AuditMode = "user" | "system";
12
+ /**
13
+ * Handler function for auditing pathway events
14
+ * @param path The pathway path being audited
15
+ * @param event The event data being processed
16
+ */
7
17
  export type AuditHandler = (path: string, event: FlowcoreEvent) => void;
18
+ /**
19
+ * Async function that resolves to the current user ID
20
+ * Used for audit functionality to track which user initiated an action
21
+ */
8
22
  export type UserIdResolver = () => Promise<string>;
23
+ /**
24
+ * Extended webhook send options with additional audit-specific options
25
+ */
9
26
  export interface AuditWebhookSendOptions extends WebhookSendOptions {
27
+ /**
28
+ * Custom HTTP headers to include with the webhook request
29
+ */
10
30
  headers?: Record<string, string>;
11
31
  }
32
+ /**
33
+ * Main builder class for creating and managing Flowcore pathways
34
+ *
35
+ * The PathwaysBuilder provides an interface for:
36
+ * - Registering pathways with type-safe schemas
37
+ * - Handling events sent to pathways
38
+ * - Writing data to pathways
39
+ * - Managing event processing and retries
40
+ * - Observing event lifecycle (before/after/error)
41
+ * - Audit logging of pathway operations
42
+ *
43
+ * @template TPathway Record type that maps pathway keys to their payload types
44
+ * @template TWritablePaths Union type of pathway keys that can be written to
45
+ */
12
46
  export declare class PathwaysBuilder<TPathway extends Record<string, unknown> = {}, TWritablePaths extends keyof TPathway = never> {
13
47
  private readonly pathways;
14
48
  private readonly handlers;
@@ -29,6 +63,16 @@ export declare class PathwaysBuilder<TPathway extends Record<string, unknown> =
29
63
  private auditHandler?;
30
64
  private userIdResolver?;
31
65
  private readonly logger;
66
+ /**
67
+ * Creates a new PathwaysBuilder instance
68
+ * @param options Configuration options for the PathwaysBuilder
69
+ * @param options.baseUrl The base URL for the Flowcore API
70
+ * @param options.tenant The tenant name
71
+ * @param options.dataCore The data core name
72
+ * @param options.apiKey The API key for authentication
73
+ * @param options.pathwayTimeoutMs Optional timeout for pathway processing in milliseconds
74
+ * @param options.logger Optional logger instance
75
+ */
32
76
  constructor({ baseUrl, tenant, dataCore, apiKey, pathwayTimeoutMs, logger, }: {
33
77
  baseUrl: string;
34
78
  tenant: string;
@@ -37,6 +81,11 @@ export declare class PathwaysBuilder<TPathway extends Record<string, unknown> =
37
81
  pathwayTimeoutMs?: number;
38
82
  logger?: Logger;
39
83
  });
84
+ /**
85
+ * Configures the PathwaysBuilder to use a custom pathway state implementation
86
+ * @param state The PathwayState implementation to use
87
+ * @returns The PathwaysBuilder instance with custom state configured
88
+ */
40
89
  withPathwayState(state: PathwayState): PathwaysBuilder<TPathway, TWritablePaths>;
41
90
  /**
42
91
  * Configures the PathwaysBuilder to use audit functionality
@@ -52,12 +101,39 @@ export declare class PathwaysBuilder<TPathway extends Record<string, unknown> =
52
101
  * @returns Promise that resolves when processing is complete
53
102
  */
54
103
  process(pathway: keyof TPathway, data: FlowcoreEvent): Promise<void>;
104
+ /**
105
+ * Registers a new pathway with the given contract
106
+ * @template F The flow type string
107
+ * @template E The event type string
108
+ * @template S The schema type extending TSchema
109
+ * @template W Boolean indicating if the pathway is writable (defaults to true)
110
+ * @param contract The pathway contract describing the pathway
111
+ * @returns The PathwaysBuilder instance with the new pathway registered
112
+ */
55
113
  register<F extends string, E extends string, S extends TSchema, W extends boolean = true>(contract: PathwayContract<F, E, S> & {
56
114
  writable?: W;
57
115
  maxRetries?: number;
58
116
  retryDelayMs?: number;
59
117
  }): PathwaysBuilder<TPathway & Record<PathwayKey<F, E>, Static<S>>, TWritablePaths | WritablePathway<PathwayKey<F, E>, W>>;
118
+ /**
119
+ * Gets a pathway instance by its path
120
+ *
121
+ * @template TPath The specific pathway key to retrieve
122
+ * @param path The pathway key to get
123
+ * @returns The pathway instance
124
+ */
60
125
  get<TPath extends keyof TPathway>(path: TPath): TPathway[TPath];
126
+ /**
127
+ * Sets a handler function for a pathway
128
+ *
129
+ * This handler will be called whenever an event is received for the specified pathway.
130
+ * Only one handler can be registered per pathway in a given PathwaysBuilder instance.
131
+ *
132
+ * @template TPath The specific pathway key to handle
133
+ * @param path The pathway key to handle
134
+ * @param handler The function that will process events for this pathway
135
+ * @throws Error if the pathway doesn't exist or already has a handler
136
+ */
61
137
  handle<TPath extends keyof TPathway>(path: TPath, handler: (event: FlowcoreEvent) => (Promise<void> | void)): void;
62
138
  /**
63
139
  * Subscribe to pathway events (before or after processing)
@@ -86,6 +162,17 @@ export declare class PathwaysBuilder<TPathway extends Record<string, unknown> =
86
162
  * @returns A promise that resolves to the event ID(s)
87
163
  */
88
164
  write<TPath extends TWritablePaths>(path: TPath, data: TPathway[TPath], metadata?: EventMetadata, options?: PathwayWriteOptions): Promise<string | string[]>;
165
+ /**
166
+ * Waits for a specific event to be processed
167
+ *
168
+ * This method polls the pathway state to check if an event has been processed,
169
+ * with a configurable timeout. It will throw an error if the timeout is exceeded.
170
+ *
171
+ * @private
172
+ * @param eventId The ID of the event to wait for
173
+ * @returns Promise that resolves when the event is processed
174
+ * @throws Error if the timeout is exceeded
175
+ */
89
176
  private waitForPathwayToBeProcessed;
90
177
  }
91
178
  //# sourceMappingURL=builder.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/pathways/builder.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/pathways/builder.ts"],"names":[],"mappings":"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"}