@geekmidas/constructs 9.3.0 → 9.5.0

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 (177) hide show
  1. package/CHANGELOG.md +82 -0
  2. package/dist/{AWSScheduledFunction-Dg6TPIxn.d.mts → AWSScheduledFunction--49dTSUQ.d.mts} +8 -2
  3. package/dist/AWSScheduledFunction--49dTSUQ.d.mts.map +1 -0
  4. package/dist/{AWSScheduledFunction-CU7mMGFA.mjs → AWSScheduledFunction-BXmRm9W6.mjs} +4 -3
  5. package/dist/{AWSScheduledFunction-CU7mMGFA.mjs.map → AWSScheduledFunction-BXmRm9W6.mjs.map} +1 -1
  6. package/dist/{AWSScheduledFunction-CKhVurOa.cjs → AWSScheduledFunction-C-JBSNak.cjs} +6 -5
  7. package/dist/{AWSScheduledFunction-CKhVurOa.cjs.map → AWSScheduledFunction-C-JBSNak.cjs.map} +1 -1
  8. package/dist/{AWSScheduledFunction-DAGP_vz5.d.cts → AWSScheduledFunction-D0_HIJj8.d.cts} +8 -2
  9. package/dist/AWSScheduledFunction-D0_HIJj8.d.cts.map +1 -0
  10. package/dist/{Construct-D_3yZ9m5.d.cts → Construct-BEh2DSMe.d.cts} +7 -13
  11. package/dist/Construct-BEh2DSMe.d.cts.map +1 -0
  12. package/dist/{Construct-D09WUUOf.cjs → Construct-Cf_0pAvo.cjs} +2 -10
  13. package/dist/Construct-Cf_0pAvo.cjs.map +1 -0
  14. package/dist/{Construct-D0uZvbr3.mjs → Construct-D5LZBFhb.mjs} +3 -11
  15. package/dist/Construct-D5LZBFhb.mjs.map +1 -0
  16. package/dist/{Construct-DsqpiAym.d.mts → Construct-qnOnQTcP.d.mts} +7 -13
  17. package/dist/Construct-qnOnQTcP.d.mts.map +1 -0
  18. package/dist/{Endpoint-CxBdXNZm.d.cts → Endpoint-DIQblT3d.d.cts} +2 -2
  19. package/dist/Endpoint-DIQblT3d.d.cts.map +1 -0
  20. package/dist/{Endpoint-DEydLuBs.d.mts → Endpoint-ZtG0zVz1.d.mts} +4 -4
  21. package/dist/{Endpoint-DEydLuBs.d.mts.map → Endpoint-ZtG0zVz1.d.mts.map} +1 -1
  22. package/dist/{HonoEndpointAdaptor-DCD0rhFg.cjs → HonoEndpointAdaptor-1aMXc8F3.cjs} +12 -19
  23. package/dist/HonoEndpointAdaptor-1aMXc8F3.cjs.map +1 -0
  24. package/dist/{HonoEndpointAdaptor-CJfFQ5KR.mjs → HonoEndpointAdaptor-BcVAeMLW.mjs} +11 -18
  25. package/dist/HonoEndpointAdaptor-BcVAeMLW.mjs.map +1 -0
  26. package/dist/Queue-915lgS2D.mjs +62 -0
  27. package/dist/Queue-915lgS2D.mjs.map +1 -0
  28. package/dist/Queue-HbdYCQ-X.cjs +73 -0
  29. package/dist/Queue-HbdYCQ-X.cjs.map +1 -0
  30. package/dist/{Queue-Brw--scg.d.cts → Queue-I5NfFV0V.d.mts} +30 -5
  31. package/dist/{Queue-Brw--scg.d.cts.map → Queue-I5NfFV0V.d.mts.map} +1 -1
  32. package/dist/{Queue-D5z1bwFu.d.mts → Queue-XQNGO6_-.d.cts} +30 -5
  33. package/dist/{Queue-D5z1bwFu.d.mts.map → Queue-XQNGO6_-.d.cts.map} +1 -1
  34. package/dist/{Subscriber-CJ22tp8r.d.mts → Subscriber-Bjil86Ub.d.mts} +2 -2
  35. package/dist/{Subscriber-CJ22tp8r.d.mts.map → Subscriber-Bjil86Ub.d.mts.map} +1 -1
  36. package/dist/{Subscriber-DvKSp0N4.d.cts → Subscriber-YwPpHrBc.d.cts} +2 -2
  37. package/dist/{Subscriber-DvKSp0N4.d.cts.map → Subscriber-YwPpHrBc.d.cts.map} +1 -1
  38. package/dist/{Topic-BMfrIFdX.d.cts → Topic-D8-wkoh4.d.mts} +3 -3
  39. package/dist/{Topic-B-fxOsR2.d.mts.map → Topic-D8-wkoh4.d.mts.map} +1 -1
  40. package/dist/{Topic-B-fxOsR2.d.mts → Topic-dIcPqSLa.d.cts} +3 -3
  41. package/dist/{Topic-BMfrIFdX.d.cts.map → Topic-dIcPqSLa.d.cts.map} +1 -1
  42. package/dist/adaptors/aws.cjs +29 -22
  43. package/dist/adaptors/aws.cjs.map +1 -1
  44. package/dist/adaptors/aws.d.cts +10 -9
  45. package/dist/adaptors/aws.d.cts.map +1 -1
  46. package/dist/adaptors/aws.d.mts +12 -11
  47. package/dist/adaptors/aws.d.mts.map +1 -1
  48. package/dist/adaptors/aws.mjs +29 -22
  49. package/dist/adaptors/aws.mjs.map +1 -1
  50. package/dist/adaptors/hono.cjs +7 -7
  51. package/dist/adaptors/hono.d.cts +3 -3
  52. package/dist/adaptors/hono.d.cts.map +1 -1
  53. package/dist/adaptors/hono.d.mts +5 -5
  54. package/dist/adaptors/hono.d.mts.map +1 -1
  55. package/dist/adaptors/hono.mjs +7 -7
  56. package/dist/adaptors/testing.cjs +32 -31
  57. package/dist/adaptors/testing.cjs.map +1 -1
  58. package/dist/adaptors/testing.d.cts +12 -6
  59. package/dist/adaptors/testing.d.cts.map +1 -1
  60. package/dist/adaptors/testing.d.mts +14 -8
  61. package/dist/adaptors/testing.d.mts.map +1 -1
  62. package/dist/adaptors/testing.mjs +32 -31
  63. package/dist/adaptors/testing.mjs.map +1 -1
  64. package/dist/{clone-I_WIpiFf.cjs → clone-BQnYiRgm.cjs} +1 -1
  65. package/dist/{clone-I_WIpiFf.cjs.map → clone-BQnYiRgm.cjs.map} +1 -1
  66. package/dist/{clone-pdXxc0t3.mjs → clone-BWIwx6vL.mjs} +1 -1
  67. package/dist/{clone-pdXxc0t3.mjs.map → clone-BWIwx6vL.mjs.map} +1 -1
  68. package/dist/crons/index.cjs +27 -6
  69. package/dist/crons/index.cjs.map +1 -1
  70. package/dist/crons/index.d.cts +13 -3
  71. package/dist/crons/index.d.cts.map +1 -1
  72. package/dist/crons/index.d.mts +13 -3
  73. package/dist/crons/index.d.mts.map +1 -1
  74. package/dist/crons/index.mjs +27 -6
  75. package/dist/crons/index.mjs.map +1 -1
  76. package/dist/endpoints/index.cjs +7 -32
  77. package/dist/endpoints/index.cjs.map +1 -1
  78. package/dist/endpoints/index.d.cts +6 -14
  79. package/dist/endpoints/index.d.cts.map +1 -1
  80. package/dist/endpoints/index.d.mts +6 -14
  81. package/dist/endpoints/index.d.mts.map +1 -1
  82. package/dist/endpoints/index.mjs +7 -32
  83. package/dist/endpoints/index.mjs.map +1 -1
  84. package/dist/functions/index.cjs +3 -3
  85. package/dist/functions/index.d.cts +2 -2
  86. package/dist/functions/index.d.mts +2 -2
  87. package/dist/functions/index.mjs +3 -3
  88. package/dist/{functions-DhkDodl0.mjs → functions-CNJbRq0O.mjs} +4 -89
  89. package/dist/functions-CNJbRq0O.mjs.map +1 -0
  90. package/dist/{functions-B3OFv3QV.cjs → functions-DzjxHo1V.cjs} +3 -100
  91. package/dist/functions-DzjxHo1V.cjs.map +1 -0
  92. package/dist/{index-B8LNLQXD.d.mts → index-CbhtERFB.d.mts} +2 -8
  93. package/dist/index-CbhtERFB.d.mts.map +1 -0
  94. package/dist/{index-CeoLMr7c.d.cts → index-XJKTxGx7.d.cts} +6 -12
  95. package/dist/index-XJKTxGx7.d.cts.map +1 -0
  96. package/dist/index.cjs +1 -1
  97. package/dist/index.d.cts +1 -1
  98. package/dist/index.d.mts +3 -3
  99. package/dist/index.mjs +1 -1
  100. package/dist/{lazyAccessors-C1n1QfEj.cjs → lazyAccessors-BZJl6bx_.cjs} +3 -3
  101. package/dist/{lazyAccessors-C1n1QfEj.cjs.map → lazyAccessors-BZJl6bx_.cjs.map} +1 -1
  102. package/dist/{lazyAccessors-fFIQrblM.mjs → lazyAccessors-BjAZqRqK.mjs} +3 -3
  103. package/dist/{lazyAccessors-fFIQrblM.mjs.map → lazyAccessors-BjAZqRqK.mjs.map} +1 -1
  104. package/dist/monitor-D3uHJ8DU.cjs +67 -0
  105. package/dist/monitor-D3uHJ8DU.cjs.map +1 -0
  106. package/dist/monitor-Dt7fiasS.mjs +61 -0
  107. package/dist/monitor-Dt7fiasS.mjs.map +1 -0
  108. package/dist/monitors/index.cjs +2 -2
  109. package/dist/monitors/index.cjs.map +1 -1
  110. package/dist/monitors/index.d.cts +2 -2
  111. package/dist/monitors/index.d.cts.map +1 -1
  112. package/dist/monitors/index.d.mts +2 -2
  113. package/dist/monitors/index.mjs +2 -2
  114. package/dist/monitors/index.mjs.map +1 -1
  115. package/dist/{processAudits-CwyaaSQc.mjs → processAudits-BEiSkgH3.mjs} +1 -1
  116. package/dist/{processAudits-CwyaaSQc.mjs.map → processAudits-BEiSkgH3.mjs.map} +1 -1
  117. package/dist/{processAudits-94Ar_EJF.cjs → processAudits-Cd912Eck.cjs} +2 -2
  118. package/dist/{processAudits-94Ar_EJF.cjs.map → processAudits-Cd912Eck.cjs.map} +1 -1
  119. package/dist/{publisher-BZgcrVPy.cjs → publisher-B6Wu-JNv.cjs} +1 -1
  120. package/dist/{publisher-BZgcrVPy.cjs.map → publisher-B6Wu-JNv.cjs.map} +1 -1
  121. package/dist/{publisher-CnpeMv-r.mjs → publisher-Cs7WcvJl.mjs} +1 -1
  122. package/dist/{publisher-CnpeMv-r.mjs.map → publisher-Cs7WcvJl.mjs.map} +1 -1
  123. package/dist/queue/index.cjs +6 -57
  124. package/dist/queue/index.cjs.map +1 -1
  125. package/dist/queue/index.d.cts +3 -3
  126. package/dist/queue/index.d.cts.map +1 -1
  127. package/dist/queue/index.d.mts +3 -3
  128. package/dist/queue/index.d.mts.map +1 -1
  129. package/dist/queue/index.mjs +5 -57
  130. package/dist/queue/index.mjs.map +1 -1
  131. package/dist/subscribers/index.cjs +2 -2
  132. package/dist/subscribers/index.d.cts +3 -3
  133. package/dist/subscribers/index.d.mts +3 -3
  134. package/dist/subscribers/index.mjs +2 -2
  135. package/dist/{telemetry-C--EgYVr.d.mts → telemetry-vq7C0ZBy.d.mts} +1 -1
  136. package/dist/{telemetry-C--EgYVr.d.mts.map → telemetry-vq7C0ZBy.d.mts.map} +1 -1
  137. package/dist/topic/index.cjs +2 -2
  138. package/dist/topic/index.d.cts +2 -2
  139. package/dist/topic/index.d.mts +2 -2
  140. package/dist/topic/index.mjs +2 -2
  141. package/dist/{types-DNngH0fX.d.mts → types-X37z95fN.d.mts} +1 -1
  142. package/dist/{types-DNngH0fX.d.mts.map → types-X37z95fN.d.mts.map} +1 -1
  143. package/dist/types.d.mts +1 -1
  144. package/package.json +22 -22
  145. package/src/Construct.ts +2 -13
  146. package/src/__tests__/uptime.spec.ts +340 -0
  147. package/src/crons/Cron.ts +10 -0
  148. package/src/crons/CronBuilder.ts +15 -1
  149. package/src/endpoints/AmazonApiGatewayEndpointAdaptor.ts +2 -23
  150. package/src/endpoints/EndpointBuilder.ts +1 -4
  151. package/src/endpoints/EndpointFactory.ts +0 -31
  152. package/src/endpoints/HonoEndpointAdaptor.ts +1 -16
  153. package/src/endpoints/TestEndpointAdaptor.ts +4 -20
  154. package/src/functions/BaseFunctionBuilder.ts +0 -10
  155. package/src/functions/FunctionBuilder.ts +0 -2
  156. package/src/monitor.ts +14 -55
  157. package/src/monitors/heartbeat.ts +4 -2
  158. package/src/queue/AWSLambdaQueueAdaptor.ts +33 -8
  159. package/src/queue/Queue.ts +35 -1
  160. package/src/queue/TestQueueAdaptor.ts +18 -4
  161. package/src/queue/__tests__/AWSLambdaQueueAdaptor.spec.ts +131 -0
  162. package/src/queue/__tests__/TestQueueAdaptor.spec.ts +58 -0
  163. package/src/queue/index.ts +3 -0
  164. package/dist/AWSScheduledFunction-DAGP_vz5.d.cts.map +0 -1
  165. package/dist/AWSScheduledFunction-Dg6TPIxn.d.mts.map +0 -1
  166. package/dist/Construct-D09WUUOf.cjs.map +0 -1
  167. package/dist/Construct-D0uZvbr3.mjs.map +0 -1
  168. package/dist/Construct-D_3yZ9m5.d.cts.map +0 -1
  169. package/dist/Construct-DsqpiAym.d.mts.map +0 -1
  170. package/dist/Endpoint-CxBdXNZm.d.cts.map +0 -1
  171. package/dist/HonoEndpointAdaptor-CJfFQ5KR.mjs.map +0 -1
  172. package/dist/HonoEndpointAdaptor-DCD0rhFg.cjs.map +0 -1
  173. package/dist/functions-B3OFv3QV.cjs.map +0 -1
  174. package/dist/functions-DhkDodl0.mjs.map +0 -1
  175. package/dist/index-B8LNLQXD.d.mts.map +0 -1
  176. package/dist/index-CeoLMr7c.d.cts.map +0 -1
  177. package/src/__tests__/monitor.spec.ts +0 -696
@@ -1 +1 @@
1
- {"version":3,"file":"testing.mjs","names":["endpoints: Endpoint<any, any, any, any, any, any>[]","options: CreateMswHandlersOptions","id: string","ctxOptions: RegisterContextOptions","serviceDefs: Service[]","handlers: HttpHandler[]","name: string","value: string","options?: CookieOptions","_endpoint: Endpoint<\n\t\t\tTRoute,\n\t\t\tTMethod,\n\t\t\tTInput,\n\t\t\tTOutSchema,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tTSession,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTAuditStorage,\n\t\t\tTAuditStorageServiceName,\n\t\t\tTAuditAction,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName\n\t\t>","endpoint: Endpoint<\n\t\t\tTRoute,\n\t\t\tTMethod,\n\t\t\tTInput,\n\t\t\tTOutSchema,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tTSession,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTAuditStorage,\n\t\t\tTAuditStorageServiceName,\n\t\t\tTAuditAction,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName\n\t\t>","serviceDiscovery: ServiceDiscovery<any>","ctx: TestRequestAdaptor<\n\t\t\tTInput,\n\t\t\tTServices,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTAuditStorage,\n\t\t\tTAuditStorageServiceName,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName\n\t\t>","auditContext: AuditExecutionContext<TAuditAction> | undefined","actor: AuditActor","metadata","output","result","headers: Record<string, string | string[]>","setCookieValues: string[]","cookie","_fn: Function<\n\t\t\tTInput,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tTOutSchema,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTAuditStorage,\n\t\t\tTAuditStorageServiceName,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName,\n\t\t\tTAuditAction,\n\t\t\tany\n\t\t>","fn: Function<\n\t\t\tTInput,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tTOutSchema,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTAuditStorage,\n\t\t\tTAuditStorageServiceName,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName,\n\t\t\tTAuditAction,\n\t\t\tany\n\t\t>","serviceDiscovery: ServiceDiscovery<any>","ctx: TestFunctionRequest<\n\t\t\tTInput,\n\t\t\tTServices,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTDatabase,\n\t\t\tTAuditAction\n\t\t>","services: ServiceRecord<TServices>","db: TDatabase | undefined","auditor: Auditor<TAuditAction> | undefined","queue: Queue<TName, TMessage, TServices, TLogger>","serviceDiscovery: ServiceDiscovery<any>","request: TestQueueRequest<TMessage, TServices>","subscriber: Subscriber<\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tOutSchema,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTSubscribedEvents\n\t\t>","serviceDiscovery: ServiceDiscovery<any>","request: TestSubscriberRequest<\n\t\t\tTEventPublisher,\n\t\t\tTSubscribedEvents,\n\t\t\tTServices\n\t\t>","services: ServiceRecord<TServices>","output: any","events: ExtractEventPayloads<TEventPublisher, TSubscribedEvents>[]","event: any"],"sources":["../../src/endpoints/MswEndpointAdaptor.ts","../../src/endpoints/TestEndpointAdaptor.ts","../../src/functions/TestFunctionAdaptor.ts","../../src/queue/TestQueueAdaptor.ts","../../src/subscribers/TestSubscriberAdaptor.ts"],"sourcesContent":["import { EnvironmentParser } from '@geekmidas/envkit';\nimport type { Service } from '@geekmidas/services';\nimport { ServiceDiscovery } from '@geekmidas/services';\nimport { Hono } from 'hono';\nimport { type HttpHandler, http } from 'msw';\nimport type { Endpoint } from './Endpoint';\nimport { HonoEndpoint } from './HonoEndpointAdaptor';\n\n/**\n * Header used to identify which test context a request belongs to.\n * Each concurrent test registers its own context (services, db transaction, etc.)\n * and the MSW handler looks it up by this header value.\n */\nexport const TEST_CONTEXT_HEADER = 'x-test-context-id';\n\n/**\n * Per-test context containing an isolated ServiceDiscovery instance.\n * Registered in the context map and looked up per-request via the context ID header.\n */\nexport interface MswTestContext {\n\tserviceDiscovery: ServiceDiscovery<any>;\n}\n\n/**\n * Options for creating MSW handlers from endpoint constructs.\n *\n * @example\n * ```typescript\n * import { createMswHandlers, registerTestContext } from '@geekmidas/constructs/testing';\n * import { setupServer } from 'msw/node';\n *\n * // Create handlers once (global)\n * const { handlers, registerContext, removeContext } = createMswHandlers(\n * [getUsers, createUser],\n * { baseURL: 'http://localhost:3000' },\n * );\n * const server = setupServer(...handlers);\n *\n * // Per test: register an isolated context with its own services/transaction\n * it('should list users', async ({ db }) => {\n * const contextId = crypto.randomUUID();\n * registerContext(contextId, {\n * services: { database: db, auth: mockAuth },\n * });\n *\n * const api = createApi({\n * baseURL: 'http://localhost:3000',\n * headers: { [TEST_CONTEXT_HEADER]: contextId },\n * });\n *\n * const result = await api('GET /users');\n * expect(result).toBeDefined();\n *\n * removeContext(contextId);\n * });\n * ```\n */\nexport interface CreateMswHandlersOptions {\n\t/** Base URL the client fetches from (e.g., 'http://localhost:3000') */\n\tbaseURL: string;\n}\n\n/**\n * Options for registering a per-test context.\n * Follows the same pattern as TestRequestAdaptor — services, database,\n * publisher, and auditorStorage are provided explicitly.\n */\nexport interface RegisterContextOptions {\n\t/** Service instances keyed by serviceName */\n\tservices?: Record<string, unknown>;\n\t/** Database instance — required when endpoints use .database() */\n\tdatabase?: unknown;\n\t/** Event publisher service definition */\n\tpublisher?: Service;\n\t/** Audit storage instance — required when endpoints use .auditor() */\n\tauditorStorage?: unknown;\n}\n\nconst MSW_HTTP_METHODS = [\n\t'get',\n\t'post',\n\t'put',\n\t'patch',\n\t'delete',\n\t'options',\n] as const;\n\ntype MswHttpMethod = (typeof MSW_HTTP_METHODS)[number];\n\n/**\n * Result of creating MSW handlers from endpoint constructs.\n */\nexport interface CreateMswHandlersResult {\n\t/** MSW handlers to pass to setupServer() */\n\thandlers: HttpHandler[];\n\t/** Register an isolated context for a test */\n\tregisterContext: (id: string, options: RegisterContextOptions) => void;\n}\n\n/**\n * Creates MSW HTTP handlers from endpoint constructs.\n *\n * Mounts endpoints on a Hono app and creates MSW handlers that intercept\n * fetch requests and route them through `app.request()` — giving frontend\n * tests full endpoint behavior (validation, auth, sessions) without HTTP.\n *\n * Each test registers its own isolated context via `registerContext()`,\n * which is resolved per-request using the `x-test-context-id` header.\n * This allows concurrent tests with their own transactions and services.\n *\n * @param endpoints - Array of endpoint constructs to create handlers for\n * @param options - Configuration including baseURL\n * @returns MSW handlers, the Hono app, and context management functions\n */\nexport function createMswHandlers(\n\tendpoints: Endpoint<any, any, any, any, any, any>[],\n\toptions: CreateMswHandlersOptions,\n): CreateMswHandlersResult {\n\tconst { baseURL } = options;\n\tconst contexts = new Map<string, MswTestContext>();\n\n\t/**\n\t * Register an isolated context for a test.\n\t * Creates a fresh ServiceDiscovery and pre-registers all provided services.\n\t */\n\tfunction registerContext(id: string, ctxOptions: RegisterContextOptions) {\n\t\tconst envParser = new EnvironmentParser({});\n\t\tconst serviceDiscovery = new ServiceDiscovery(envParser);\n\n\t\tconst serviceDefs: Service[] = [];\n\n\t\t// Register explicit services\n\t\tif (ctxOptions.services) {\n\t\t\tfor (const [name, instance] of Object.entries(ctxOptions.services)) {\n\t\t\t\tserviceDefs.push({\n\t\t\t\t\tserviceName: name,\n\t\t\t\t\tregister: () => instance,\n\t\t\t\t} as Service);\n\t\t\t}\n\t\t}\n\n\t\t// Register database service from endpoint metadata\n\t\tif (ctxOptions.database !== undefined) {\n\t\t\tfor (const endpoint of endpoints) {\n\t\t\t\tif (endpoint.databaseService) {\n\t\t\t\t\tserviceDefs.push({\n\t\t\t\t\t\tserviceName: endpoint.databaseService.serviceName,\n\t\t\t\t\t\tregister: () => ctxOptions.database,\n\t\t\t\t\t} as Service);\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t// Register publisher service\n\t\tif (ctxOptions.publisher) {\n\t\t\tserviceDefs.push(ctxOptions.publisher);\n\t\t}\n\n\t\t// Register auditor storage service from endpoint metadata\n\t\tif (ctxOptions.auditorStorage !== undefined) {\n\t\t\tfor (const endpoint of endpoints) {\n\t\t\t\tif (endpoint.auditorStorageService) {\n\t\t\t\t\tserviceDefs.push({\n\t\t\t\t\t\tserviceName: endpoint.auditorStorageService.serviceName,\n\t\t\t\t\t\tregister: () => ctxOptions.auditorStorage,\n\t\t\t\t\t} as Service);\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tif (serviceDefs.length > 0) {\n\t\t\tserviceDiscovery.register(serviceDefs);\n\t\t}\n\n\t\tcontexts.set(id, { serviceDiscovery });\n\t}\n\n\t// Create a Hono app per-request that uses the correct ServiceDiscovery.\n\t// We use a wrapper app that resolves the context from the header,\n\t// then delegates to a context-specific Hono app.\n\tconst handlers: HttpHandler[] = [];\n\n\tfor (const endpoint of endpoints) {\n\t\tconst method = endpoint.method.toLowerCase() as MswHttpMethod;\n\t\tif (!MSW_HTTP_METHODS.includes(method)) continue;\n\n\t\tconst mswUrl = `${baseURL}${endpoint.route}`;\n\t\tconst mswMethod = http[method];\n\n\t\thandlers.push(\n\t\t\tmswMethod(mswUrl, async ({ request }) => {\n\t\t\t\tconst contextId = request.headers.get(TEST_CONTEXT_HEADER);\n\t\t\t\tconst ctx = contextId ? contexts.get(contextId) : undefined;\n\n\t\t\t\tif (!ctx) {\n\t\t\t\t\treturn new Response(\n\t\t\t\t\t\tJSON.stringify({\n\t\t\t\t\t\t\terror: 'Missing or unknown test context ID',\n\t\t\t\t\t\t\thint: `Set the '${TEST_CONTEXT_HEADER}' header to a registered context ID`,\n\t\t\t\t\t\t}),\n\t\t\t\t\t\t{ status: 500, headers: { 'content-type': 'application/json' } },\n\t\t\t\t\t);\n\t\t\t\t}\n\n\t\t\t\t// Build a fresh Hono app with this context's ServiceDiscovery\n\t\t\t\tconst app = new Hono();\n\t\t\t\tHonoEndpoint.addRoute(endpoint, ctx.serviceDiscovery as any, app);\n\n\t\t\t\tconst response = await app.request(request);\n\n\t\t\t\treturn new Response(response.body, {\n\t\t\t\t\tstatus: response.status,\n\t\t\t\t\tstatusText: response.statusText,\n\t\t\t\t\theaders: response.headers,\n\t\t\t\t});\n\t\t\t}),\n\t\t);\n\t}\n\n\treturn {\n\t\thandlers,\n\t\tregisterContext,\n\t};\n}\n","import type {\n\tAuditActor,\n\tAuditableAction,\n\tAuditStorage,\n} from '@geekmidas/audit';\nimport { DefaultAuditor } from '@geekmidas/audit';\nimport { EnvironmentParser } from '@geekmidas/envkit';\nimport { ForbiddenError, wrapError } from '@geekmidas/errors';\nimport type { EventPublisher } from '@geekmidas/events';\nimport type { Logger } from '@geekmidas/logger';\nimport type {\n\tInferComposableStandardSchema,\n\tInferStandardSchema,\n} from '@geekmidas/schema';\nimport {\n\trunWithRequestContext,\n\ttype Service,\n\tServiceDiscovery,\n\ttype ServiceRecord,\n} from '@geekmidas/services';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport { startMonitors } from '../monitor';\nimport { publishConstructEvents } from '../publisher';\nimport type { HttpMethod } from '../types';\nimport type { MappedAudit } from './audit';\nimport {\n\ttype CookieOptions,\n\tEndpoint,\n\ttype EndpointSchemas,\n\tResponseBuilder,\n} from './Endpoint';\nimport {\n\tcreateCookieHeaderAccessor,\n\tcreateObjectHeaders,\n} from './lazyAccessors';\nimport {\n\ttype AuditExecutionContext,\n\texecuteWithAuditTransaction,\n} from './processAudits';\n\nexport type TestHttpResponse<TBody = any> = {\n\tbody: TBody;\n\tstatus: number;\n\theaders: Record<string, string | string[]>;\n};\n\n/**\n * Serializes a cookie into a Set-Cookie header string\n */\nfunction serializeCookie(\n\tname: string,\n\tvalue: string,\n\toptions?: CookieOptions,\n): string {\n\tlet cookieString = `${name}=${value}`;\n\n\tif (options) {\n\t\tif (options.maxAge !== undefined) {\n\t\t\tcookieString += `; Max-Age=${options.maxAge}`;\n\t\t}\n\t\tif (options.expires) {\n\t\t\tcookieString += `; Expires=${options.expires.toUTCString()}`;\n\t\t}\n\t\tif (options.domain) {\n\t\t\tcookieString += `; Domain=${options.domain}`;\n\t\t}\n\t\tif (options.path) {\n\t\t\tcookieString += `; Path=${options.path}`;\n\t\t}\n\t\tif (options.httpOnly) {\n\t\t\tcookieString += '; HttpOnly';\n\t\t}\n\t\tif (options.secure) {\n\t\t\tcookieString += '; Secure';\n\t\t}\n\t\tif (options.sameSite) {\n\t\t\tcookieString += `; SameSite=${options.sameSite}`;\n\t\t}\n\t}\n\n\treturn cookieString;\n}\n\nexport class TestEndpointAdaptor<\n\tTRoute extends string,\n\tTMethod extends HttpMethod,\n\tTInput extends EndpointSchemas = {},\n\tTOutSchema extends StandardSchemaV1 | undefined = undefined,\n\tTServices extends Service[] = [],\n\tTLogger extends Logger = Logger,\n\tTSession = unknown,\n\tTEventPublisher extends EventPublisher<any> | undefined = undefined,\n\tTEventPublisherServiceName extends string = string,\n\tTAuditStorage extends AuditStorage | undefined = undefined,\n\tTAuditStorageServiceName extends string = string,\n\tTAuditAction extends AuditableAction<string, unknown> = AuditableAction<\n\t\tstring,\n\t\tunknown\n\t>,\n\tTDatabase = undefined,\n\tTDatabaseServiceName extends string = string,\n> {\n\tstatic getDefaultServiceDiscover<\n\t\tTRoute extends string,\n\t\tTMethod extends HttpMethod,\n\t\tTInput extends EndpointSchemas = {},\n\t\tTOutSchema extends StandardSchemaV1 | undefined = undefined,\n\t\tTServices extends Service[] = [],\n\t\tTLogger extends Logger = Logger,\n\t\tTSession = unknown,\n\t\tTEventPublisher extends EventPublisher<any> | undefined = undefined,\n\t\tTEventPublisherServiceName extends string = string,\n\t\tTAuditStorage extends AuditStorage | undefined = undefined,\n\t\tTAuditStorageServiceName extends string = string,\n\t\tTAuditAction extends AuditableAction<string, unknown> = AuditableAction<\n\t\t\tstring,\n\t\t\tunknown\n\t\t>,\n\t\tTDatabase = undefined,\n\t\tTDatabaseServiceName extends string = string,\n\t>(\n\t\t_endpoint: Endpoint<\n\t\t\tTRoute,\n\t\t\tTMethod,\n\t\t\tTInput,\n\t\t\tTOutSchema,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tTSession,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTAuditStorage,\n\t\t\tTAuditStorageServiceName,\n\t\t\tTAuditAction,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName\n\t\t>,\n\t) {\n\t\treturn ServiceDiscovery.getInstance(new EnvironmentParser({}));\n\t}\n\tconstructor(\n\t\tprivate readonly endpoint: Endpoint<\n\t\t\tTRoute,\n\t\t\tTMethod,\n\t\t\tTInput,\n\t\t\tTOutSchema,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tTSession,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTAuditStorage,\n\t\t\tTAuditStorageServiceName,\n\t\t\tTAuditAction,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName\n\t\t>,\n\t\tprivate serviceDiscovery: ServiceDiscovery<any> = TestEndpointAdaptor.getDefaultServiceDiscover(\n\t\t\tendpoint,\n\t\t),\n\t) {}\n\n\tasync fullRequest(\n\t\tctx: TestRequestAdaptor<\n\t\t\tTInput,\n\t\t\tTServices,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTAuditStorage,\n\t\t\tTAuditStorageServiceName,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName\n\t\t>,\n\t): Promise<TestHttpResponse<InferStandardSchema<TOutSchema>>> {\n\t\tconst body = await this.endpoint.parseInput((ctx as any).body, 'body');\n\t\tconst query = await this.endpoint.parseInput((ctx as any).query, 'query');\n\t\tconst params = await this.endpoint.parseInput(\n\t\t\t(ctx as any).params,\n\t\t\t'params',\n\t\t);\n\n\t\t// Lazy accessors - defer parsing until needed\n\t\tconst header = createObjectHeaders(ctx.headers);\n\t\tconst cookie = createCookieHeaderAccessor(ctx.headers.cookie);\n\n\t\t// Request context setup\n\t\tconst startTime = Date.now();\n\t\tconst requestId =\n\t\t\t(ctx as any).requestId ??\n\t\t\tctx.headers['x-request-id'] ??\n\t\t\tcrypto.randomUUID();\n\n\t\tconst logger = this.endpoint.logger.child({\n\t\t\trequestId,\n\t\t\troute: this.endpoint.route,\n\t\t\thost: ctx.headers.host,\n\t\t\tmethod: this.endpoint.method,\n\t\t}) as TLogger;\n\n\t\t// Get database from context for session extraction\n\t\tconst rawDb = (ctx as any).database as TDatabase;\n\n\t\tconst monitor = await startMonitors(\n\t\t\tthis.endpoint,\n\t\t\tthis.serviceDiscovery,\n\t\t\tlogger,\n\t\t);\n\n\t\t// Wrap handler execution in request context\n\t\ttry {\n\t\t\tconst response = await runWithRequestContext(\n\t\t\t\t{ logger, requestId, startTime },\n\t\t\t\tasync () =>\n\t\t\t\t\tthis.run(ctx, { body, query, params, header, cookie, logger, rawDb }),\n\t\t\t);\n\t\t\tawait monitor.settle(response.status);\n\t\t\treturn response;\n\t\t} catch (error) {\n\t\t\tawait monitor.settle(wrapError(error).statusCode, error);\n\t\t\tthrow error;\n\t\t}\n\t}\n\n\tprivate async run(\n\t\tctx: TestRequestAdaptor<\n\t\t\tTInput,\n\t\t\tTServices,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTAuditStorage,\n\t\t\tTAuditStorageServiceName,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName\n\t\t>,\n\t\t{\n\t\t\tbody,\n\t\t\tquery,\n\t\t\tparams,\n\t\t\theader,\n\t\t\tcookie,\n\t\t\tlogger,\n\t\t\trawDb,\n\t\t}: {\n\t\t\tbody: unknown;\n\t\t\tquery: unknown;\n\t\t\tparams: unknown;\n\t\t\theader: ReturnType<typeof createObjectHeaders>;\n\t\t\tcookie: ReturnType<typeof createCookieHeaderAccessor>;\n\t\t\tlogger: TLogger;\n\t\t\trawDb: TDatabase;\n\t\t},\n\t): Promise<TestHttpResponse<InferStandardSchema<TOutSchema>>> {\n\t\tconst session = await this.endpoint.getSession({\n\t\t\tlogger,\n\t\t\tservices: ctx.services,\n\t\t\theader,\n\t\t\tcookie,\n\t\t\t...(rawDb !== undefined && { db: rawDb }),\n\t\t} as any);\n\n\t\t// Check authorization\n\t\tconst isAuthorized = await this.endpoint.authorize({\n\t\t\theader,\n\t\t\tcookie,\n\t\t\tservices: ctx.services,\n\t\t\tlogger,\n\t\t\tsession,\n\t\t\t...(rawDb !== undefined && { db: rawDb }),\n\t\t\tbody,\n\t\t\tquery,\n\t\t\tparams,\n\t\t} as any);\n\n\t\tif (!isAuthorized) {\n\t\t\tlogger.warn('Forbidden access attempt');\n\t\t\tthrow new ForbiddenError(\n\t\t\t\t'Forbidden access to the endpoint',\n\t\t\t\t'You do not have permission to access this resource.',\n\t\t\t);\n\t\t}\n\n\t\t// Create audit context if audit storage is provided\n\t\t// The auditorStorage instance is required when endpoint uses .auditor()\n\t\tconst auditorStorage = (ctx as any).auditorStorage as TAuditStorage;\n\t\tlet auditContext: AuditExecutionContext<TAuditAction> | undefined;\n\n\t\tif (auditorStorage) {\n\t\t\t// Extract actor if configured\n\t\t\tlet actor: AuditActor = { id: 'system', type: 'system' };\n\t\t\tif (this.endpoint.actorExtractor) {\n\t\t\t\ttry {\n\t\t\t\t\tactor = await this.endpoint.actorExtractor({\n\t\t\t\t\t\tservices: ctx.services as any,\n\t\t\t\t\t\tsession,\n\t\t\t\t\t\theader,\n\t\t\t\t\t\tcookie,\n\t\t\t\t\t\tlogger,\n\t\t\t\t\t});\n\t\t\t\t} catch (error) {\n\t\t\t\t\tlogger.error(error as Error, 'Failed to extract actor for audits');\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tconst auditor = new DefaultAuditor<TAuditAction>({\n\t\t\t\tactor,\n\t\t\t\tstorage: auditorStorage as AuditStorage,\n\t\t\t\tmetadata: {\n\t\t\t\t\tendpoint: this.endpoint.route,\n\t\t\t\t\tmethod: this.endpoint.method,\n\t\t\t\t},\n\t\t\t});\n\n\t\t\tauditContext = { auditor, storage: auditorStorage as AuditStorage };\n\t\t}\n\n\t\t// Warn if declarative audits are configured but no audit storage\n\t\tconst audits = this.endpoint.audits as MappedAudit<\n\t\t\tTAuditAction,\n\t\t\tTOutSchema\n\t\t>[];\n\t\tif (!auditContext && audits?.length) {\n\t\t\tlogger.warn('No auditor storage service available');\n\t\t}\n\n\t\t// Execute handler with automatic audit transaction support\n\t\tconst result = await executeWithAuditTransaction(\n\t\t\tauditContext,\n\t\t\tasync (auditor) => {\n\t\t\t\t// Use audit transaction as db if available (when storage has same database)\n\t\t\t\t// For testing, the tester controls whether to use transactional auditing\n\t\t\t\tconst trx = auditor?.getTransaction?.();\n\t\t\t\tconst db = trx ?? rawDb;\n\n\t\t\t\tconst responseBuilder = new ResponseBuilder();\n\t\t\t\tconst response = await this.endpoint.handler(\n\t\t\t\t\t{\n\t\t\t\t\t\tbody,\n\t\t\t\t\t\tquery,\n\t\t\t\t\t\tparams,\n\t\t\t\t\t\tsession,\n\t\t\t\t\t\tservices: ctx.services,\n\t\t\t\t\t\tlogger,\n\t\t\t\t\t\theader,\n\t\t\t\t\t\tcookie,\n\t\t\t\t\t\tauditor,\n\t\t\t\t\t\tdb,\n\t\t\t\t\t} as any,\n\t\t\t\t\tresponseBuilder,\n\t\t\t\t);\n\n\t\t\t\t// Check if response has metadata\n\t\t\t\tlet data = response;\n\t\t\t\tlet metadata = responseBuilder.getMetadata();\n\n\t\t\t\tif (Endpoint.hasMetadata(response)) {\n\t\t\t\t\tdata = response.data;\n\t\t\t\t\tmetadata = response.metadata;\n\t\t\t\t}\n\n\t\t\t\tconst output = await this.endpoint.parseOutput(data);\n\n\t\t\t\treturn { output, metadata, responseBuilder };\n\t\t\t},\n\t\t\t// Process declarative audits after handler (inside transaction)\n\t\t\tasync (result, auditor) => {\n\t\t\t\tif (!audits?.length) return;\n\n\t\t\t\tfor (const audit of audits) {\n\t\t\t\t\tif (audit.when && !audit.when(result.output as any)) {\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\t\t\t\t\tconst payload = audit.payload(result.output as any);\n\t\t\t\t\tconst entityId = audit.entityId?.(result.output as any);\n\t\t\t\t\tauditor.audit(audit.type as any, payload as any, {\n\t\t\t\t\t\ttable: audit.table,\n\t\t\t\t\t\tentityId,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t},\n\t\t\t// Pass rawDb so storage can reuse existing transactions\n\t\t\t{ db: rawDb },\n\t\t);\n\n\t\tconst { output, metadata } = result;\n\n\t\tctx.publisher && (await this.serviceDiscovery.register([ctx.publisher]));\n\t\tawait publishConstructEvents(this.endpoint, output, this.serviceDiscovery);\n\n\t\t// Convert cookies to Set-Cookie headers\n\t\tconst headers: Record<string, string | string[]> = {\n\t\t\t...(metadata.headers || {}),\n\t\t};\n\n\t\tif (metadata.cookies && metadata.cookies.size > 0) {\n\t\t\tconst setCookieValues: string[] = [];\n\t\t\tfor (const [name, cookie] of metadata.cookies.entries()) {\n\t\t\t\tsetCookieValues.push(\n\t\t\t\t\tserializeCookie(name, cookie.value, cookie.options),\n\t\t\t\t);\n\t\t\t}\n\t\t\theaders['set-cookie'] = setCookieValues;\n\t\t}\n\n\t\t// Return HTTP response format\n\t\treturn {\n\t\t\tbody: output,\n\t\t\tstatus: metadata.status || 200,\n\t\t\theaders,\n\t\t};\n\t}\n\n\tasync request(\n\t\tctx: TestRequestAdaptor<\n\t\t\tTInput,\n\t\t\tTServices,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTAuditStorage,\n\t\t\tTAuditStorageServiceName,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName\n\t\t>,\n\t): Promise<InferStandardSchema<TOutSchema>> {\n\t\tconst response = await this.fullRequest(ctx);\n\t\treturn response.body;\n\t}\n}\n\n/**\n * Conditional audit storage requirement - required when TAuditStorage is configured\n */\ntype AuditStorageRequirement<\n\tTAuditStorage extends AuditStorage | undefined = undefined,\n> = TAuditStorage extends undefined\n\t? {}\n\t: {\n\t\t\t/** Audit storage instance - required when endpoint uses .auditor() */\n\t\t\tauditorStorage: TAuditStorage;\n\t\t};\n\n/**\n * Conditional database requirement - required when TDatabase is configured\n */\ntype DatabaseRequirement<TDatabase = undefined> = TDatabase extends undefined\n\t? {}\n\t: {\n\t\t\t/** Database instance - required when endpoint uses .database() */\n\t\t\tdatabase: TDatabase;\n\t\t};\n\nexport type TestRequestAdaptor<\n\tTInput extends EndpointSchemas = {},\n\tTServices extends Service[] = [],\n\tTEventPublisher extends EventPublisher<any> | undefined = undefined,\n\tTEventPublisherServiceName extends string = string,\n\tTAuditStorage extends AuditStorage | undefined = undefined,\n\t_TAuditStorageServiceName extends string = string,\n\tTDatabase = undefined,\n\t_TDatabaseServiceName extends string = string,\n> = {\n\tservices: ServiceRecord<TServices>;\n\theaders: Record<string, string>;\n\tpublisher?: Service<TEventPublisherServiceName, TEventPublisher>;\n} & InferComposableStandardSchema<TInput> &\n\tAuditStorageRequirement<TAuditStorage> &\n\tDatabaseRequirement<TDatabase>;\n","import type { AuditableAction, Auditor, AuditStorage } from '@geekmidas/audit';\nimport { DefaultAuditor } from '@geekmidas/audit';\nimport { EnvironmentParser } from '@geekmidas/envkit';\nimport type { EventPublisher } from '@geekmidas/events';\nimport type { Logger } from '@geekmidas/logger';\nimport type {\n\tComposableStandardSchema,\n\tInferComposableStandardSchema,\n\tInferStandardSchema,\n} from '@geekmidas/schema';\nimport {\n\trunWithRequestContext,\n\ttype Service,\n\tServiceDiscovery,\n\ttype ServiceRecord,\n} from '@geekmidas/services';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport { startMonitors } from '../monitor';\nimport { publishEvents } from '../publisher';\nimport type { Function } from './Function';\nimport { FunctionBuilder } from './FunctionBuilder';\n\nexport class TestFunctionAdaptor<\n\tTInput extends ComposableStandardSchema | undefined = undefined,\n\tTOutSchema extends StandardSchemaV1 | undefined = undefined,\n\tTServices extends Service[] = [],\n\tTLogger extends Logger = Logger,\n\tTEventPublisher extends EventPublisher<any> | undefined = undefined,\n\tTEventPublisherServiceName extends string = string,\n\tTAuditStorage extends AuditStorage | undefined = undefined,\n\tTAuditStorageServiceName extends string = string,\n\tTDatabase = undefined,\n\tTDatabaseServiceName extends string = string,\n\tTAuditAction extends AuditableAction<string, unknown> = AuditableAction<\n\t\tstring,\n\t\tunknown\n\t>,\n> {\n\tstatic getDefaultServiceDiscovery<\n\t\tTInput extends ComposableStandardSchema | undefined = undefined,\n\t\tTOutSchema extends StandardSchemaV1 | undefined = undefined,\n\t\tTServices extends Service[] = [],\n\t\tTLogger extends Logger = Logger,\n\t\tTEventPublisher extends EventPublisher<any> | undefined = undefined,\n\t\tTEventPublisherServiceName extends string = string,\n\t\tTAuditStorage extends AuditStorage | undefined = undefined,\n\t\tTAuditStorageServiceName extends string = string,\n\t\tTDatabase = undefined,\n\t\tTDatabaseServiceName extends string = string,\n\t\tTAuditAction extends AuditableAction<string, unknown> = AuditableAction<\n\t\t\tstring,\n\t\t\tunknown\n\t\t>,\n\t>(\n\t\t_fn: Function<\n\t\t\tTInput,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tTOutSchema,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTAuditStorage,\n\t\t\tTAuditStorageServiceName,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName,\n\t\t\tTAuditAction,\n\t\t\tany\n\t\t>,\n\t) {\n\t\treturn ServiceDiscovery.getInstance(new EnvironmentParser({}));\n\t}\n\n\tconstructor(\n\t\tprivate readonly fn: Function<\n\t\t\tTInput,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tTOutSchema,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTAuditStorage,\n\t\t\tTAuditStorageServiceName,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName,\n\t\t\tTAuditAction,\n\t\t\tany\n\t\t>,\n\t\tprivate serviceDiscovery: ServiceDiscovery<any> = TestFunctionAdaptor.getDefaultServiceDiscovery(\n\t\t\tfn,\n\t\t),\n\t) {}\n\n\tasync invoke(\n\t\tctx: TestFunctionRequest<\n\t\t\tTInput,\n\t\t\tTServices,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTDatabase,\n\t\t\tTAuditAction\n\t\t>,\n\t): Promise<InferStandardSchema<TOutSchema>> {\n\t\t// Parse input if schema is provided\n\n\t\tconst parsedInput = await FunctionBuilder.parseComposableStandardSchema(\n\t\t\tctx.input,\n\t\t\tthis.fn.input,\n\t\t);\n\n\t\t// Create logger with context\n\t\tconst logger = this.fn.logger.child({\n\t\t\ttest: true,\n\t\t}) as TLogger;\n\n\t\t// Register services (use provided services or register from function)\n\t\tlet services: ServiceRecord<TServices>;\n\t\tif (ctx.services) {\n\t\t\tservices = ctx.services;\n\t\t} else {\n\t\t\tservices = await this.serviceDiscovery.register(this.fn.services);\n\t\t}\n\n\t\t// Resolve database (use provided db or register from function)\n\t\tlet db: TDatabase | undefined;\n\t\tif ('db' in ctx && ctx.db !== undefined) {\n\t\t\tdb = ctx.db;\n\t\t} else if (this.fn.databaseService) {\n\t\t\tconst dbServices = await this.serviceDiscovery.register([\n\t\t\t\tthis.fn.databaseService,\n\t\t\t]);\n\t\t\tdb = dbServices[\n\t\t\t\tthis.fn.databaseService.serviceName as keyof typeof dbServices\n\t\t\t] as TDatabase;\n\t\t}\n\n\t\t// Resolve auditor (use provided auditor or create from function)\n\t\tlet auditor: Auditor<TAuditAction> | undefined;\n\t\tif ('auditor' in ctx && ctx.auditor !== undefined) {\n\t\t\tauditor = ctx.auditor;\n\t\t} else if (this.fn.auditorStorageService) {\n\t\t\tconst auditServices = await this.serviceDiscovery.register([\n\t\t\t\tthis.fn.auditorStorageService,\n\t\t\t]);\n\t\t\tconst storage = auditServices[\n\t\t\t\tthis.fn.auditorStorageService.serviceName as keyof typeof auditServices\n\t\t\t] as AuditStorage;\n\n\t\t\tauditor = new DefaultAuditor<TAuditAction>({\n\t\t\t\tactor: { id: 'system', type: 'system' },\n\t\t\t\tstorage,\n\t\t\t\tmetadata: {\n\t\t\t\t\tfunction: this.fn.type,\n\t\t\t\t\ttest: true,\n\t\t\t\t},\n\t\t\t});\n\t\t}\n\n\t\t// Wrap execution in request context for service access via context.getLogger()\n\t\tconst requestId = `test-${Date.now()}`;\n\t\tconst startTime = Date.now();\n\n\t\treturn runWithRequestContext({ logger, requestId, startTime }, async () => {\n\t\t\tconst monitor = await startMonitors(\n\t\t\t\tthis.fn,\n\t\t\t\tthis.serviceDiscovery,\n\t\t\t\tlogger,\n\t\t\t);\n\t\t\ttry {\n\t\t\t\tconst output = await this.run({\n\t\t\t\t\tparsedInput,\n\t\t\t\t\tservices,\n\t\t\t\t\tlogger,\n\t\t\t\t\tdb,\n\t\t\t\t\tauditor,\n\t\t\t\t});\n\t\t\t\tawait monitor.success(output);\n\t\t\t\treturn output;\n\t\t\t} catch (error) {\n\t\t\t\tawait monitor.failure(error);\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t}) as Promise<InferStandardSchema<TOutSchema>>;\n\t}\n\n\tprivate async run({\n\t\tparsedInput,\n\t\tservices,\n\t\tlogger,\n\t\tdb,\n\t\tauditor,\n\t}: {\n\t\tparsedInput: unknown;\n\t\tservices: ServiceRecord<TServices>;\n\t\tlogger: TLogger;\n\t\tdb: TDatabase | undefined;\n\t\tauditor: Auditor<TAuditAction> | undefined;\n\t}): Promise<InferStandardSchema<TOutSchema>> {\n\t\t// Execute the function\n\t\tconst response = await this.fn.fn({\n\t\t\tinput: parsedInput,\n\t\t\tservices,\n\t\t\tlogger,\n\t\t\tdb,\n\t\t\tauditor,\n\t\t} as any);\n\n\t\t// Parse output if schema is provided\n\t\tconst output = await this.fn.parseOutput(response);\n\n\t\t// Flush audits if any were recorded\n\t\tif (auditor) {\n\t\t\tconst records = auditor.getRecords();\n\t\t\tif (records.length > 0) {\n\t\t\t\tlogger.debug(\n\t\t\t\t\t{ auditCount: records.length },\n\t\t\t\t\t'Flushing function audits',\n\t\t\t\t);\n\t\t\t\tawait auditor.flush();\n\t\t\t}\n\t\t}\n\n\t\t// Register publisher service if provided in context\n\n\t\tawait publishEvents(\n\t\t\tlogger,\n\t\t\tthis.serviceDiscovery,\n\t\t\tthis.fn.events,\n\t\t\toutput,\n\t\t\tthis.fn.publisherService,\n\t\t);\n\n\t\treturn output;\n\t}\n}\n\nexport type TestFunctionRequest<\n\tTInput extends ComposableStandardSchema | undefined = undefined,\n\tTServices extends Service[] = [],\n\tTEventPublisher extends EventPublisher<any> | undefined = undefined,\n\tTEventPublisherServiceName extends string = string,\n\tTDatabase = undefined,\n\tTAuditAction extends AuditableAction<string, unknown> = AuditableAction<\n\t\tstring,\n\t\tunknown\n\t>,\n> = {\n\tinput: InferComposableStandardSchema<TInput>;\n\tservices: ServiceRecord<TServices>;\n\tpublisher?: Service<TEventPublisherServiceName, TEventPublisher>;\n\tdb?: TDatabase;\n\tauditor?: Auditor<TAuditAction>;\n} & InferComposableStandardSchema<{ input: TInput }>;\n","import { EnvironmentParser } from '@geekmidas/envkit';\nimport type { Logger } from '@geekmidas/logger';\nimport type { InferStandardSchema } from '@geekmidas/schema';\nimport type { Service, ServiceRecord } from '@geekmidas/services';\nimport { runWithRequestContext, ServiceDiscovery } from '@geekmidas/services';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport type { Queue } from './Queue';\n\n/**\n * In-memory test driver for a {@link Queue} worker. Hand it a batch of messages\n * and it registers the queue's services, runs the handler in a request context,\n * and returns the handler result — no SQS/pg-boss required.\n *\n * @example\n * const adapter = new TestQueueAdaptor(ordersQueue);\n * await adapter.invoke({ messages: [{ orderId: '123' }] });\n */\nexport class TestQueueAdaptor<\n\tTName extends string = string,\n\tTMessage extends StandardSchemaV1 = StandardSchemaV1,\n\tTServices extends Service[] = [],\n\tTLogger extends Logger = Logger,\n> {\n\tstatic getDefaultServiceDiscovery() {\n\t\treturn ServiceDiscovery.getInstance(new EnvironmentParser({}));\n\t}\n\n\tconstructor(\n\t\tprivate readonly queue: Queue<TName, TMessage, TServices, TLogger>,\n\t\tprivate serviceDiscovery: ServiceDiscovery<any> = TestQueueAdaptor.getDefaultServiceDiscovery(),\n\t) {}\n\n\tasync invoke(\n\t\trequest: TestQueueRequest<TMessage, TServices>,\n\t): Promise<unknown> {\n\t\tconst logger = this.queue.logger.child({ test: true }) as TLogger;\n\n\t\tconst services =\n\t\t\trequest.services ??\n\t\t\t((await this.serviceDiscovery.register(\n\t\t\t\tthis.queue.services,\n\t\t\t)) as ServiceRecord<TServices>);\n\n\t\tconst requestId = `test-${Date.now()}`;\n\t\tconst startTime = Date.now();\n\n\t\treturn runWithRequestContext({ logger, requestId, startTime }, () =>\n\t\t\tthis.queue.handler({\n\t\t\t\tmessages: request.messages,\n\t\t\t\tservices,\n\t\t\t\tlogger,\n\t\t\t}),\n\t\t);\n\t}\n}\n\nexport type TestQueueRequest<\n\tTMessage extends StandardSchemaV1 = StandardSchemaV1,\n\tTServices extends Service[] = [],\n> = {\n\tmessages: InferStandardSchema<TMessage>[];\n\tservices?: ServiceRecord<TServices>;\n};\n","import { EnvironmentParser } from '@geekmidas/envkit';\nimport type {\n\tEventPublisher,\n\tExtractPublisherMessage,\n} from '@geekmidas/events';\nimport type { Logger } from '@geekmidas/logger';\nimport type { InferStandardSchema } from '@geekmidas/schema';\nimport type { Service, ServiceRecord } from '@geekmidas/services';\nimport { runWithRequestContext, ServiceDiscovery } from '@geekmidas/services';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport { publishEvents } from '../publisher';\nimport type { Subscriber } from './Subscriber';\n\n// Helper type to extract payload types for subscribed events\ntype ExtractEventPayloads<\n\tTPublisher extends EventPublisher<any> | undefined,\n\tTEventTypes extends any[],\n> = TPublisher extends EventPublisher<any>\n\t? Extract<ExtractPublisherMessage<TPublisher>, { type: TEventTypes[number] }>\n\t: never;\n\nexport class TestSubscriberAdaptor<\n\tTServices extends Service[] = [],\n\tTLogger extends Logger = Logger,\n\tOutSchema extends StandardSchemaV1 | undefined = undefined,\n\tTEventPublisher extends EventPublisher<any> | undefined = undefined,\n\tTEventPublisherServiceName extends string = string,\n\tTSubscribedEvents extends\n\t\tExtractPublisherMessage<TEventPublisher>['type'][] = ExtractPublisherMessage<TEventPublisher>['type'][],\n> {\n\tstatic getDefaultServiceDiscovery() {\n\t\treturn ServiceDiscovery.getInstance(new EnvironmentParser({}));\n\t}\n\n\tconstructor(\n\t\tprivate readonly subscriber: Subscriber<\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tOutSchema,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTSubscribedEvents\n\t\t>,\n\t\tprivate serviceDiscovery: ServiceDiscovery<any> = TestSubscriberAdaptor.getDefaultServiceDiscovery(),\n\t) {}\n\n\tasync invoke(\n\t\trequest: TestSubscriberRequest<\n\t\t\tTEventPublisher,\n\t\t\tTSubscribedEvents,\n\t\t\tTServices\n\t\t>,\n\t): Promise<InferStandardSchema<OutSchema>> {\n\t\t// Create logger with test context\n\t\tconst logger = this.subscriber.logger.child({\n\t\t\ttest: true,\n\t\t}) as TLogger;\n\n\t\t// Resolve services (use provided or auto-register)\n\t\tlet services: ServiceRecord<TServices>;\n\t\tif (request.services) {\n\t\t\tservices = request.services;\n\t\t} else {\n\t\t\tservices = await this.serviceDiscovery.register(this.subscriber.services);\n\t\t}\n\n\t\t// Filter events to only subscribed types\n\t\tconst filteredEvents = this.filterEvents(request.events);\n\n\t\t// Return early if no events after filtering (mirrors AWSLambdaSubscriber)\n\t\tif (filteredEvents.length === 0) {\n\t\t\treturn { batchItemFailures: [] } as any;\n\t\t}\n\n\t\t// Wrap execution in request context for service access via context.getLogger()\n\t\tconst requestId = `test-${Date.now()}`;\n\t\tconst startTime = Date.now();\n\n\t\treturn runWithRequestContext({ logger, requestId, startTime }, async () => {\n\t\t\t// Execute the subscriber handler\n\t\t\tconst result = await this.subscriber.handler({\n\t\t\t\tevents: filteredEvents,\n\t\t\t\tservices,\n\t\t\t\tlogger,\n\t\t\t});\n\n\t\t\t// Validate output if schema is provided\n\t\t\tlet output: any = result;\n\t\t\tif (this.subscriber.outputSchema && result) {\n\t\t\t\tconst validationResult =\n\t\t\t\t\tawait this.subscriber.outputSchema['~standard'].validate(result);\n\n\t\t\t\tif (validationResult.issues) {\n\t\t\t\t\tthrow new Error('Subscriber output validation failed');\n\t\t\t\t}\n\n\t\t\t\toutput = validationResult.value;\n\t\t\t}\n\n\t\t\t// Publish events if configured\n\t\t\tawait publishEvents(\n\t\t\t\tlogger,\n\t\t\t\tthis.serviceDiscovery,\n\t\t\t\tthis.subscriber.events,\n\t\t\t\toutput,\n\t\t\t\tthis.subscriber.publisherService,\n\t\t\t);\n\n\t\t\treturn output;\n\t\t}) as Promise<InferStandardSchema<OutSchema>>;\n\t}\n\n\tprivate filterEvents(\n\t\tevents: ExtractEventPayloads<TEventPublisher, TSubscribedEvents>[],\n\t): ExtractEventPayloads<TEventPublisher, TSubscribedEvents>[] {\n\t\tif (!this.subscriber.subscribedEvents) {\n\t\t\treturn events;\n\t\t}\n\n\t\treturn events.filter((event: any) =>\n\t\t\tthis.subscriber.subscribedEvents!.includes(event.type),\n\t\t);\n\t}\n}\n\nexport type TestSubscriberRequest<\n\tTEventPublisher extends EventPublisher<any> | undefined = undefined,\n\tTSubscribedEvents extends any[] = [],\n\tTServices extends Service[] = [],\n> = {\n\tevents: ExtractEventPayloads<TEventPublisher, TSubscribedEvents>[];\n\tservices?: ServiceRecord<TServices>;\n};\n"],"mappings":"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"}
1
+ {"version":3,"file":"testing.mjs","names":["endpoints: Endpoint<any, any, any, any, any, any>[]","options: CreateMswHandlersOptions","id: string","ctxOptions: RegisterContextOptions","serviceDefs: Service[]","handlers: HttpHandler[]","name: string","value: string","options?: CookieOptions","_endpoint: Endpoint<\n\t\t\tTRoute,\n\t\t\tTMethod,\n\t\t\tTInput,\n\t\t\tTOutSchema,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tTSession,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTAuditStorage,\n\t\t\tTAuditStorageServiceName,\n\t\t\tTAuditAction,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName\n\t\t>","endpoint: Endpoint<\n\t\t\tTRoute,\n\t\t\tTMethod,\n\t\t\tTInput,\n\t\t\tTOutSchema,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tTSession,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTAuditStorage,\n\t\t\tTAuditStorageServiceName,\n\t\t\tTAuditAction,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName\n\t\t>","serviceDiscovery: ServiceDiscovery<any>","ctx: TestRequestAdaptor<\n\t\t\tTInput,\n\t\t\tTServices,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTAuditStorage,\n\t\t\tTAuditStorageServiceName,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName\n\t\t>","auditContext: AuditExecutionContext<TAuditAction> | undefined","actor: AuditActor","metadata","output","result","headers: Record<string, string | string[]>","setCookieValues: string[]","cookie","_fn: Function<\n\t\t\tTInput,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tTOutSchema,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTAuditStorage,\n\t\t\tTAuditStorageServiceName,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName,\n\t\t\tTAuditAction,\n\t\t\tany\n\t\t>","fn: Function<\n\t\t\tTInput,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tTOutSchema,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTAuditStorage,\n\t\t\tTAuditStorageServiceName,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName,\n\t\t\tTAuditAction,\n\t\t\tany\n\t\t>","serviceDiscovery: ServiceDiscovery<any>","ctx: TestFunctionRequest<\n\t\t\tTInput,\n\t\t\tTServices,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTDatabase,\n\t\t\tTAuditAction\n\t\t>","services: ServiceRecord<TServices>","db: TDatabase | undefined","auditor: Auditor<TAuditAction> | undefined","queue: Queue<TName, TMessage, TServices, TLogger>","serviceDiscovery: ServiceDiscovery<any>","request: TestQueueRequest<TMessage, TServices>","records: QueueRecord<TMessage>[]","subscriber: Subscriber<\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tOutSchema,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTSubscribedEvents\n\t\t>","serviceDiscovery: ServiceDiscovery<any>","request: TestSubscriberRequest<\n\t\t\tTEventPublisher,\n\t\t\tTSubscribedEvents,\n\t\t\tTServices\n\t\t>","services: ServiceRecord<TServices>","output: any","events: ExtractEventPayloads<TEventPublisher, TSubscribedEvents>[]","event: any"],"sources":["../../src/endpoints/MswEndpointAdaptor.ts","../../src/endpoints/TestEndpointAdaptor.ts","../../src/functions/TestFunctionAdaptor.ts","../../src/queue/TestQueueAdaptor.ts","../../src/subscribers/TestSubscriberAdaptor.ts"],"sourcesContent":["import { EnvironmentParser } from '@geekmidas/envkit';\nimport type { Service } from '@geekmidas/services';\nimport { ServiceDiscovery } from '@geekmidas/services';\nimport { Hono } from 'hono';\nimport { type HttpHandler, http } from 'msw';\nimport type { Endpoint } from './Endpoint';\nimport { HonoEndpoint } from './HonoEndpointAdaptor';\n\n/**\n * Header used to identify which test context a request belongs to.\n * Each concurrent test registers its own context (services, db transaction, etc.)\n * and the MSW handler looks it up by this header value.\n */\nexport const TEST_CONTEXT_HEADER = 'x-test-context-id';\n\n/**\n * Per-test context containing an isolated ServiceDiscovery instance.\n * Registered in the context map and looked up per-request via the context ID header.\n */\nexport interface MswTestContext {\n\tserviceDiscovery: ServiceDiscovery<any>;\n}\n\n/**\n * Options for creating MSW handlers from endpoint constructs.\n *\n * @example\n * ```typescript\n * import { createMswHandlers, registerTestContext } from '@geekmidas/constructs/testing';\n * import { setupServer } from 'msw/node';\n *\n * // Create handlers once (global)\n * const { handlers, registerContext, removeContext } = createMswHandlers(\n * [getUsers, createUser],\n * { baseURL: 'http://localhost:3000' },\n * );\n * const server = setupServer(...handlers);\n *\n * // Per test: register an isolated context with its own services/transaction\n * it('should list users', async ({ db }) => {\n * const contextId = crypto.randomUUID();\n * registerContext(contextId, {\n * services: { database: db, auth: mockAuth },\n * });\n *\n * const api = createApi({\n * baseURL: 'http://localhost:3000',\n * headers: { [TEST_CONTEXT_HEADER]: contextId },\n * });\n *\n * const result = await api('GET /users');\n * expect(result).toBeDefined();\n *\n * removeContext(contextId);\n * });\n * ```\n */\nexport interface CreateMswHandlersOptions {\n\t/** Base URL the client fetches from (e.g., 'http://localhost:3000') */\n\tbaseURL: string;\n}\n\n/**\n * Options for registering a per-test context.\n * Follows the same pattern as TestRequestAdaptor — services, database,\n * publisher, and auditorStorage are provided explicitly.\n */\nexport interface RegisterContextOptions {\n\t/** Service instances keyed by serviceName */\n\tservices?: Record<string, unknown>;\n\t/** Database instance — required when endpoints use .database() */\n\tdatabase?: unknown;\n\t/** Event publisher service definition */\n\tpublisher?: Service;\n\t/** Audit storage instance — required when endpoints use .auditor() */\n\tauditorStorage?: unknown;\n}\n\nconst MSW_HTTP_METHODS = [\n\t'get',\n\t'post',\n\t'put',\n\t'patch',\n\t'delete',\n\t'options',\n] as const;\n\ntype MswHttpMethod = (typeof MSW_HTTP_METHODS)[number];\n\n/**\n * Result of creating MSW handlers from endpoint constructs.\n */\nexport interface CreateMswHandlersResult {\n\t/** MSW handlers to pass to setupServer() */\n\thandlers: HttpHandler[];\n\t/** Register an isolated context for a test */\n\tregisterContext: (id: string, options: RegisterContextOptions) => void;\n}\n\n/**\n * Creates MSW HTTP handlers from endpoint constructs.\n *\n * Mounts endpoints on a Hono app and creates MSW handlers that intercept\n * fetch requests and route them through `app.request()` — giving frontend\n * tests full endpoint behavior (validation, auth, sessions) without HTTP.\n *\n * Each test registers its own isolated context via `registerContext()`,\n * which is resolved per-request using the `x-test-context-id` header.\n * This allows concurrent tests with their own transactions and services.\n *\n * @param endpoints - Array of endpoint constructs to create handlers for\n * @param options - Configuration including baseURL\n * @returns MSW handlers, the Hono app, and context management functions\n */\nexport function createMswHandlers(\n\tendpoints: Endpoint<any, any, any, any, any, any>[],\n\toptions: CreateMswHandlersOptions,\n): CreateMswHandlersResult {\n\tconst { baseURL } = options;\n\tconst contexts = new Map<string, MswTestContext>();\n\n\t/**\n\t * Register an isolated context for a test.\n\t * Creates a fresh ServiceDiscovery and pre-registers all provided services.\n\t */\n\tfunction registerContext(id: string, ctxOptions: RegisterContextOptions) {\n\t\tconst envParser = new EnvironmentParser({});\n\t\tconst serviceDiscovery = new ServiceDiscovery(envParser);\n\n\t\tconst serviceDefs: Service[] = [];\n\n\t\t// Register explicit services\n\t\tif (ctxOptions.services) {\n\t\t\tfor (const [name, instance] of Object.entries(ctxOptions.services)) {\n\t\t\t\tserviceDefs.push({\n\t\t\t\t\tserviceName: name,\n\t\t\t\t\tregister: () => instance,\n\t\t\t\t} as Service);\n\t\t\t}\n\t\t}\n\n\t\t// Register database service from endpoint metadata\n\t\tif (ctxOptions.database !== undefined) {\n\t\t\tfor (const endpoint of endpoints) {\n\t\t\t\tif (endpoint.databaseService) {\n\t\t\t\t\tserviceDefs.push({\n\t\t\t\t\t\tserviceName: endpoint.databaseService.serviceName,\n\t\t\t\t\t\tregister: () => ctxOptions.database,\n\t\t\t\t\t} as Service);\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t// Register publisher service\n\t\tif (ctxOptions.publisher) {\n\t\t\tserviceDefs.push(ctxOptions.publisher);\n\t\t}\n\n\t\t// Register auditor storage service from endpoint metadata\n\t\tif (ctxOptions.auditorStorage !== undefined) {\n\t\t\tfor (const endpoint of endpoints) {\n\t\t\t\tif (endpoint.auditorStorageService) {\n\t\t\t\t\tserviceDefs.push({\n\t\t\t\t\t\tserviceName: endpoint.auditorStorageService.serviceName,\n\t\t\t\t\t\tregister: () => ctxOptions.auditorStorage,\n\t\t\t\t\t} as Service);\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tif (serviceDefs.length > 0) {\n\t\t\tserviceDiscovery.register(serviceDefs);\n\t\t}\n\n\t\tcontexts.set(id, { serviceDiscovery });\n\t}\n\n\t// Create a Hono app per-request that uses the correct ServiceDiscovery.\n\t// We use a wrapper app that resolves the context from the header,\n\t// then delegates to a context-specific Hono app.\n\tconst handlers: HttpHandler[] = [];\n\n\tfor (const endpoint of endpoints) {\n\t\tconst method = endpoint.method.toLowerCase() as MswHttpMethod;\n\t\tif (!MSW_HTTP_METHODS.includes(method)) continue;\n\n\t\tconst mswUrl = `${baseURL}${endpoint.route}`;\n\t\tconst mswMethod = http[method];\n\n\t\thandlers.push(\n\t\t\tmswMethod(mswUrl, async ({ request }) => {\n\t\t\t\tconst contextId = request.headers.get(TEST_CONTEXT_HEADER);\n\t\t\t\tconst ctx = contextId ? contexts.get(contextId) : undefined;\n\n\t\t\t\tif (!ctx) {\n\t\t\t\t\treturn new Response(\n\t\t\t\t\t\tJSON.stringify({\n\t\t\t\t\t\t\terror: 'Missing or unknown test context ID',\n\t\t\t\t\t\t\thint: `Set the '${TEST_CONTEXT_HEADER}' header to a registered context ID`,\n\t\t\t\t\t\t}),\n\t\t\t\t\t\t{ status: 500, headers: { 'content-type': 'application/json' } },\n\t\t\t\t\t);\n\t\t\t\t}\n\n\t\t\t\t// Build a fresh Hono app with this context's ServiceDiscovery\n\t\t\t\tconst app = new Hono();\n\t\t\t\tHonoEndpoint.addRoute(endpoint, ctx.serviceDiscovery as any, app);\n\n\t\t\t\tconst response = await app.request(request);\n\n\t\t\t\treturn new Response(response.body, {\n\t\t\t\t\tstatus: response.status,\n\t\t\t\t\tstatusText: response.statusText,\n\t\t\t\t\theaders: response.headers,\n\t\t\t\t});\n\t\t\t}),\n\t\t);\n\t}\n\n\treturn {\n\t\thandlers,\n\t\tregisterContext,\n\t};\n}\n","import type {\n\tAuditActor,\n\tAuditableAction,\n\tAuditStorage,\n} from '@geekmidas/audit';\nimport { DefaultAuditor } from '@geekmidas/audit';\nimport { EnvironmentParser } from '@geekmidas/envkit';\nimport { ForbiddenError } from '@geekmidas/errors';\nimport type { EventPublisher } from '@geekmidas/events';\nimport type { Logger } from '@geekmidas/logger';\nimport type {\n\tInferComposableStandardSchema,\n\tInferStandardSchema,\n} from '@geekmidas/schema';\nimport {\n\trunWithRequestContext,\n\ttype Service,\n\tServiceDiscovery,\n\ttype ServiceRecord,\n} from '@geekmidas/services';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport { publishConstructEvents } from '../publisher';\nimport type { HttpMethod } from '../types';\nimport type { MappedAudit } from './audit';\nimport {\n\ttype CookieOptions,\n\tEndpoint,\n\ttype EndpointSchemas,\n\tResponseBuilder,\n} from './Endpoint';\nimport {\n\tcreateCookieHeaderAccessor,\n\tcreateObjectHeaders,\n} from './lazyAccessors';\nimport {\n\ttype AuditExecutionContext,\n\texecuteWithAuditTransaction,\n} from './processAudits';\n\nexport type TestHttpResponse<TBody = any> = {\n\tbody: TBody;\n\tstatus: number;\n\theaders: Record<string, string | string[]>;\n};\n\n/**\n * Serializes a cookie into a Set-Cookie header string\n */\nfunction serializeCookie(\n\tname: string,\n\tvalue: string,\n\toptions?: CookieOptions,\n): string {\n\tlet cookieString = `${name}=${value}`;\n\n\tif (options) {\n\t\tif (options.maxAge !== undefined) {\n\t\t\tcookieString += `; Max-Age=${options.maxAge}`;\n\t\t}\n\t\tif (options.expires) {\n\t\t\tcookieString += `; Expires=${options.expires.toUTCString()}`;\n\t\t}\n\t\tif (options.domain) {\n\t\t\tcookieString += `; Domain=${options.domain}`;\n\t\t}\n\t\tif (options.path) {\n\t\t\tcookieString += `; Path=${options.path}`;\n\t\t}\n\t\tif (options.httpOnly) {\n\t\t\tcookieString += '; HttpOnly';\n\t\t}\n\t\tif (options.secure) {\n\t\t\tcookieString += '; Secure';\n\t\t}\n\t\tif (options.sameSite) {\n\t\t\tcookieString += `; SameSite=${options.sameSite}`;\n\t\t}\n\t}\n\n\treturn cookieString;\n}\n\nexport class TestEndpointAdaptor<\n\tTRoute extends string,\n\tTMethod extends HttpMethod,\n\tTInput extends EndpointSchemas = {},\n\tTOutSchema extends StandardSchemaV1 | undefined = undefined,\n\tTServices extends Service[] = [],\n\tTLogger extends Logger = Logger,\n\tTSession = unknown,\n\tTEventPublisher extends EventPublisher<any> | undefined = undefined,\n\tTEventPublisherServiceName extends string = string,\n\tTAuditStorage extends AuditStorage | undefined = undefined,\n\tTAuditStorageServiceName extends string = string,\n\tTAuditAction extends AuditableAction<string, unknown> = AuditableAction<\n\t\tstring,\n\t\tunknown\n\t>,\n\tTDatabase = undefined,\n\tTDatabaseServiceName extends string = string,\n> {\n\tstatic getDefaultServiceDiscover<\n\t\tTRoute extends string,\n\t\tTMethod extends HttpMethod,\n\t\tTInput extends EndpointSchemas = {},\n\t\tTOutSchema extends StandardSchemaV1 | undefined = undefined,\n\t\tTServices extends Service[] = [],\n\t\tTLogger extends Logger = Logger,\n\t\tTSession = unknown,\n\t\tTEventPublisher extends EventPublisher<any> | undefined = undefined,\n\t\tTEventPublisherServiceName extends string = string,\n\t\tTAuditStorage extends AuditStorage | undefined = undefined,\n\t\tTAuditStorageServiceName extends string = string,\n\t\tTAuditAction extends AuditableAction<string, unknown> = AuditableAction<\n\t\t\tstring,\n\t\t\tunknown\n\t\t>,\n\t\tTDatabase = undefined,\n\t\tTDatabaseServiceName extends string = string,\n\t>(\n\t\t_endpoint: Endpoint<\n\t\t\tTRoute,\n\t\t\tTMethod,\n\t\t\tTInput,\n\t\t\tTOutSchema,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tTSession,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTAuditStorage,\n\t\t\tTAuditStorageServiceName,\n\t\t\tTAuditAction,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName\n\t\t>,\n\t) {\n\t\treturn ServiceDiscovery.getInstance(new EnvironmentParser({}));\n\t}\n\tconstructor(\n\t\tprivate readonly endpoint: Endpoint<\n\t\t\tTRoute,\n\t\t\tTMethod,\n\t\t\tTInput,\n\t\t\tTOutSchema,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tTSession,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTAuditStorage,\n\t\t\tTAuditStorageServiceName,\n\t\t\tTAuditAction,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName\n\t\t>,\n\t\tprivate serviceDiscovery: ServiceDiscovery<any> = TestEndpointAdaptor.getDefaultServiceDiscover(\n\t\t\tendpoint,\n\t\t),\n\t) {}\n\n\tasync fullRequest(\n\t\tctx: TestRequestAdaptor<\n\t\t\tTInput,\n\t\t\tTServices,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTAuditStorage,\n\t\t\tTAuditStorageServiceName,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName\n\t\t>,\n\t): Promise<TestHttpResponse<InferStandardSchema<TOutSchema>>> {\n\t\tconst body = await this.endpoint.parseInput((ctx as any).body, 'body');\n\t\tconst query = await this.endpoint.parseInput((ctx as any).query, 'query');\n\t\tconst params = await this.endpoint.parseInput(\n\t\t\t(ctx as any).params,\n\t\t\t'params',\n\t\t);\n\n\t\t// Lazy accessors - defer parsing until needed\n\t\tconst header = createObjectHeaders(ctx.headers);\n\t\tconst cookie = createCookieHeaderAccessor(ctx.headers.cookie);\n\n\t\t// Request context setup\n\t\tconst startTime = Date.now();\n\t\tconst requestId =\n\t\t\t(ctx as any).requestId ??\n\t\t\tctx.headers['x-request-id'] ??\n\t\t\tcrypto.randomUUID();\n\n\t\tconst logger = this.endpoint.logger.child({\n\t\t\trequestId,\n\t\t\troute: this.endpoint.route,\n\t\t\thost: ctx.headers.host,\n\t\t\tmethod: this.endpoint.method,\n\t\t}) as TLogger;\n\n\t\t// Get database from context for session extraction\n\t\tconst rawDb = (ctx as any).database as TDatabase;\n\n\t\t// Wrap handler execution in request context\n\t\treturn runWithRequestContext({ logger, requestId, startTime }, async () =>\n\t\t\tthis.run(ctx, { body, query, params, header, cookie, logger, rawDb }),\n\t\t);\n\t}\n\n\tprivate async run(\n\t\tctx: TestRequestAdaptor<\n\t\t\tTInput,\n\t\t\tTServices,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTAuditStorage,\n\t\t\tTAuditStorageServiceName,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName\n\t\t>,\n\t\t{\n\t\t\tbody,\n\t\t\tquery,\n\t\t\tparams,\n\t\t\theader,\n\t\t\tcookie,\n\t\t\tlogger,\n\t\t\trawDb,\n\t\t}: {\n\t\t\tbody: unknown;\n\t\t\tquery: unknown;\n\t\t\tparams: unknown;\n\t\t\theader: ReturnType<typeof createObjectHeaders>;\n\t\t\tcookie: ReturnType<typeof createCookieHeaderAccessor>;\n\t\t\tlogger: TLogger;\n\t\t\trawDb: TDatabase;\n\t\t},\n\t): Promise<TestHttpResponse<InferStandardSchema<TOutSchema>>> {\n\t\tconst session = await this.endpoint.getSession({\n\t\t\tlogger,\n\t\t\tservices: ctx.services,\n\t\t\theader,\n\t\t\tcookie,\n\t\t\t...(rawDb !== undefined && { db: rawDb }),\n\t\t} as any);\n\n\t\t// Check authorization\n\t\tconst isAuthorized = await this.endpoint.authorize({\n\t\t\theader,\n\t\t\tcookie,\n\t\t\tservices: ctx.services,\n\t\t\tlogger,\n\t\t\tsession,\n\t\t\t...(rawDb !== undefined && { db: rawDb }),\n\t\t\tbody,\n\t\t\tquery,\n\t\t\tparams,\n\t\t} as any);\n\n\t\tif (!isAuthorized) {\n\t\t\tlogger.warn('Forbidden access attempt');\n\t\t\tthrow new ForbiddenError(\n\t\t\t\t'Forbidden access to the endpoint',\n\t\t\t\t'You do not have permission to access this resource.',\n\t\t\t);\n\t\t}\n\n\t\t// Create audit context if audit storage is provided\n\t\t// The auditorStorage instance is required when endpoint uses .auditor()\n\t\tconst auditorStorage = (ctx as any).auditorStorage as TAuditStorage;\n\t\tlet auditContext: AuditExecutionContext<TAuditAction> | undefined;\n\n\t\tif (auditorStorage) {\n\t\t\t// Extract actor if configured\n\t\t\tlet actor: AuditActor = { id: 'system', type: 'system' };\n\t\t\tif (this.endpoint.actorExtractor) {\n\t\t\t\ttry {\n\t\t\t\t\tactor = await this.endpoint.actorExtractor({\n\t\t\t\t\t\tservices: ctx.services as any,\n\t\t\t\t\t\tsession,\n\t\t\t\t\t\theader,\n\t\t\t\t\t\tcookie,\n\t\t\t\t\t\tlogger,\n\t\t\t\t\t});\n\t\t\t\t} catch (error) {\n\t\t\t\t\tlogger.error(error as Error, 'Failed to extract actor for audits');\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tconst auditor = new DefaultAuditor<TAuditAction>({\n\t\t\t\tactor,\n\t\t\t\tstorage: auditorStorage as AuditStorage,\n\t\t\t\tmetadata: {\n\t\t\t\t\tendpoint: this.endpoint.route,\n\t\t\t\t\tmethod: this.endpoint.method,\n\t\t\t\t},\n\t\t\t});\n\n\t\t\tauditContext = { auditor, storage: auditorStorage as AuditStorage };\n\t\t}\n\n\t\t// Warn if declarative audits are configured but no audit storage\n\t\tconst audits = this.endpoint.audits as MappedAudit<\n\t\t\tTAuditAction,\n\t\t\tTOutSchema\n\t\t>[];\n\t\tif (!auditContext && audits?.length) {\n\t\t\tlogger.warn('No auditor storage service available');\n\t\t}\n\n\t\t// Execute handler with automatic audit transaction support\n\t\tconst result = await executeWithAuditTransaction(\n\t\t\tauditContext,\n\t\t\tasync (auditor) => {\n\t\t\t\t// Use audit transaction as db if available (when storage has same database)\n\t\t\t\t// For testing, the tester controls whether to use transactional auditing\n\t\t\t\tconst trx = auditor?.getTransaction?.();\n\t\t\t\tconst db = trx ?? rawDb;\n\n\t\t\t\tconst responseBuilder = new ResponseBuilder();\n\t\t\t\tconst response = await this.endpoint.handler(\n\t\t\t\t\t{\n\t\t\t\t\t\tbody,\n\t\t\t\t\t\tquery,\n\t\t\t\t\t\tparams,\n\t\t\t\t\t\tsession,\n\t\t\t\t\t\tservices: ctx.services,\n\t\t\t\t\t\tlogger,\n\t\t\t\t\t\theader,\n\t\t\t\t\t\tcookie,\n\t\t\t\t\t\tauditor,\n\t\t\t\t\t\tdb,\n\t\t\t\t\t} as any,\n\t\t\t\t\tresponseBuilder,\n\t\t\t\t);\n\n\t\t\t\t// Check if response has metadata\n\t\t\t\tlet data = response;\n\t\t\t\tlet metadata = responseBuilder.getMetadata();\n\n\t\t\t\tif (Endpoint.hasMetadata(response)) {\n\t\t\t\t\tdata = response.data;\n\t\t\t\t\tmetadata = response.metadata;\n\t\t\t\t}\n\n\t\t\t\tconst output = await this.endpoint.parseOutput(data);\n\n\t\t\t\treturn { output, metadata, responseBuilder };\n\t\t\t},\n\t\t\t// Process declarative audits after handler (inside transaction)\n\t\t\tasync (result, auditor) => {\n\t\t\t\tif (!audits?.length) return;\n\n\t\t\t\tfor (const audit of audits) {\n\t\t\t\t\tif (audit.when && !audit.when(result.output as any)) {\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\t\t\t\t\tconst payload = audit.payload(result.output as any);\n\t\t\t\t\tconst entityId = audit.entityId?.(result.output as any);\n\t\t\t\t\tauditor.audit(audit.type as any, payload as any, {\n\t\t\t\t\t\ttable: audit.table,\n\t\t\t\t\t\tentityId,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t},\n\t\t\t// Pass rawDb so storage can reuse existing transactions\n\t\t\t{ db: rawDb },\n\t\t);\n\n\t\tconst { output, metadata } = result;\n\n\t\tctx.publisher && (await this.serviceDiscovery.register([ctx.publisher]));\n\t\tawait publishConstructEvents(this.endpoint, output, this.serviceDiscovery);\n\n\t\t// Convert cookies to Set-Cookie headers\n\t\tconst headers: Record<string, string | string[]> = {\n\t\t\t...(metadata.headers || {}),\n\t\t};\n\n\t\tif (metadata.cookies && metadata.cookies.size > 0) {\n\t\t\tconst setCookieValues: string[] = [];\n\t\t\tfor (const [name, cookie] of metadata.cookies.entries()) {\n\t\t\t\tsetCookieValues.push(\n\t\t\t\t\tserializeCookie(name, cookie.value, cookie.options),\n\t\t\t\t);\n\t\t\t}\n\t\t\theaders['set-cookie'] = setCookieValues;\n\t\t}\n\n\t\t// Return HTTP response format\n\t\treturn {\n\t\t\tbody: output,\n\t\t\tstatus: metadata.status || 200,\n\t\t\theaders,\n\t\t};\n\t}\n\n\tasync request(\n\t\tctx: TestRequestAdaptor<\n\t\t\tTInput,\n\t\t\tTServices,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTAuditStorage,\n\t\t\tTAuditStorageServiceName,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName\n\t\t>,\n\t): Promise<InferStandardSchema<TOutSchema>> {\n\t\tconst response = await this.fullRequest(ctx);\n\t\treturn response.body;\n\t}\n}\n\n/**\n * Conditional audit storage requirement - required when TAuditStorage is configured\n */\ntype AuditStorageRequirement<\n\tTAuditStorage extends AuditStorage | undefined = undefined,\n> = TAuditStorage extends undefined\n\t? {}\n\t: {\n\t\t\t/** Audit storage instance - required when endpoint uses .auditor() */\n\t\t\tauditorStorage: TAuditStorage;\n\t\t};\n\n/**\n * Conditional database requirement - required when TDatabase is configured\n */\ntype DatabaseRequirement<TDatabase = undefined> = TDatabase extends undefined\n\t? {}\n\t: {\n\t\t\t/** Database instance - required when endpoint uses .database() */\n\t\t\tdatabase: TDatabase;\n\t\t};\n\nexport type TestRequestAdaptor<\n\tTInput extends EndpointSchemas = {},\n\tTServices extends Service[] = [],\n\tTEventPublisher extends EventPublisher<any> | undefined = undefined,\n\tTEventPublisherServiceName extends string = string,\n\tTAuditStorage extends AuditStorage | undefined = undefined,\n\t_TAuditStorageServiceName extends string = string,\n\tTDatabase = undefined,\n\t_TDatabaseServiceName extends string = string,\n> = {\n\tservices: ServiceRecord<TServices>;\n\theaders: Record<string, string>;\n\tpublisher?: Service<TEventPublisherServiceName, TEventPublisher>;\n} & InferComposableStandardSchema<TInput> &\n\tAuditStorageRequirement<TAuditStorage> &\n\tDatabaseRequirement<TDatabase>;\n","import type { AuditableAction, Auditor, AuditStorage } from '@geekmidas/audit';\nimport { DefaultAuditor } from '@geekmidas/audit';\nimport { EnvironmentParser } from '@geekmidas/envkit';\nimport type { EventPublisher } from '@geekmidas/events';\nimport type { Logger } from '@geekmidas/logger';\nimport type {\n\tComposableStandardSchema,\n\tInferComposableStandardSchema,\n\tInferStandardSchema,\n} from '@geekmidas/schema';\nimport {\n\trunWithRequestContext,\n\ttype Service,\n\tServiceDiscovery,\n\ttype ServiceRecord,\n} from '@geekmidas/services';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport { startMonitors } from '../monitor';\nimport { publishEvents } from '../publisher';\nimport type { Function } from './Function';\nimport { FunctionBuilder } from './FunctionBuilder';\n\nexport class TestFunctionAdaptor<\n\tTInput extends ComposableStandardSchema | undefined = undefined,\n\tTOutSchema extends StandardSchemaV1 | undefined = undefined,\n\tTServices extends Service[] = [],\n\tTLogger extends Logger = Logger,\n\tTEventPublisher extends EventPublisher<any> | undefined = undefined,\n\tTEventPublisherServiceName extends string = string,\n\tTAuditStorage extends AuditStorage | undefined = undefined,\n\tTAuditStorageServiceName extends string = string,\n\tTDatabase = undefined,\n\tTDatabaseServiceName extends string = string,\n\tTAuditAction extends AuditableAction<string, unknown> = AuditableAction<\n\t\tstring,\n\t\tunknown\n\t>,\n> {\n\tstatic getDefaultServiceDiscovery<\n\t\tTInput extends ComposableStandardSchema | undefined = undefined,\n\t\tTOutSchema extends StandardSchemaV1 | undefined = undefined,\n\t\tTServices extends Service[] = [],\n\t\tTLogger extends Logger = Logger,\n\t\tTEventPublisher extends EventPublisher<any> | undefined = undefined,\n\t\tTEventPublisherServiceName extends string = string,\n\t\tTAuditStorage extends AuditStorage | undefined = undefined,\n\t\tTAuditStorageServiceName extends string = string,\n\t\tTDatabase = undefined,\n\t\tTDatabaseServiceName extends string = string,\n\t\tTAuditAction extends AuditableAction<string, unknown> = AuditableAction<\n\t\t\tstring,\n\t\t\tunknown\n\t\t>,\n\t>(\n\t\t_fn: Function<\n\t\t\tTInput,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tTOutSchema,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTAuditStorage,\n\t\t\tTAuditStorageServiceName,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName,\n\t\t\tTAuditAction,\n\t\t\tany\n\t\t>,\n\t) {\n\t\treturn ServiceDiscovery.getInstance(new EnvironmentParser({}));\n\t}\n\n\tconstructor(\n\t\tprivate readonly fn: Function<\n\t\t\tTInput,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tTOutSchema,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTAuditStorage,\n\t\t\tTAuditStorageServiceName,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName,\n\t\t\tTAuditAction,\n\t\t\tany\n\t\t>,\n\t\tprivate serviceDiscovery: ServiceDiscovery<any> = TestFunctionAdaptor.getDefaultServiceDiscovery(\n\t\t\tfn,\n\t\t),\n\t) {}\n\n\tasync invoke(\n\t\tctx: TestFunctionRequest<\n\t\t\tTInput,\n\t\t\tTServices,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTDatabase,\n\t\t\tTAuditAction\n\t\t>,\n\t): Promise<InferStandardSchema<TOutSchema>> {\n\t\t// Parse input if schema is provided\n\n\t\tconst parsedInput = await FunctionBuilder.parseComposableStandardSchema(\n\t\t\tctx.input,\n\t\t\tthis.fn.input,\n\t\t);\n\n\t\t// Create logger with context\n\t\tconst logger = this.fn.logger.child({\n\t\t\ttest: true,\n\t\t}) as TLogger;\n\n\t\t// Register services (use provided services or register from function)\n\t\tlet services: ServiceRecord<TServices>;\n\t\tif (ctx.services) {\n\t\t\tservices = ctx.services;\n\t\t} else {\n\t\t\tservices = await this.serviceDiscovery.register(this.fn.services);\n\t\t}\n\n\t\t// Resolve database (use provided db or register from function)\n\t\tlet db: TDatabase | undefined;\n\t\tif ('db' in ctx && ctx.db !== undefined) {\n\t\t\tdb = ctx.db;\n\t\t} else if (this.fn.databaseService) {\n\t\t\tconst dbServices = await this.serviceDiscovery.register([\n\t\t\t\tthis.fn.databaseService,\n\t\t\t]);\n\t\t\tdb = dbServices[\n\t\t\t\tthis.fn.databaseService.serviceName as keyof typeof dbServices\n\t\t\t] as TDatabase;\n\t\t}\n\n\t\t// Resolve auditor (use provided auditor or create from function)\n\t\tlet auditor: Auditor<TAuditAction> | undefined;\n\t\tif ('auditor' in ctx && ctx.auditor !== undefined) {\n\t\t\tauditor = ctx.auditor;\n\t\t} else if (this.fn.auditorStorageService) {\n\t\t\tconst auditServices = await this.serviceDiscovery.register([\n\t\t\t\tthis.fn.auditorStorageService,\n\t\t\t]);\n\t\t\tconst storage = auditServices[\n\t\t\t\tthis.fn.auditorStorageService.serviceName as keyof typeof auditServices\n\t\t\t] as AuditStorage;\n\n\t\t\tauditor = new DefaultAuditor<TAuditAction>({\n\t\t\t\tactor: { id: 'system', type: 'system' },\n\t\t\t\tstorage,\n\t\t\t\tmetadata: {\n\t\t\t\t\tfunction: this.fn.type,\n\t\t\t\t\ttest: true,\n\t\t\t\t},\n\t\t\t});\n\t\t}\n\n\t\t// Wrap execution in request context for service access via context.getLogger()\n\t\tconst requestId = `test-${Date.now()}`;\n\t\tconst startTime = Date.now();\n\n\t\treturn runWithRequestContext({ logger, requestId, startTime }, async () => {\n\t\t\tconst monitor = await startMonitors(\n\t\t\t\tthis.fn,\n\t\t\t\tthis.serviceDiscovery,\n\t\t\t\tlogger,\n\t\t\t);\n\t\t\ttry {\n\t\t\t\tconst output = await this.run({\n\t\t\t\t\tparsedInput,\n\t\t\t\t\tservices,\n\t\t\t\t\tlogger,\n\t\t\t\t\tdb,\n\t\t\t\t\tauditor,\n\t\t\t\t});\n\t\t\t\tawait monitor.success(output);\n\t\t\t\treturn output;\n\t\t\t} catch (error) {\n\t\t\t\tawait monitor.failure(error);\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t}) as Promise<InferStandardSchema<TOutSchema>>;\n\t}\n\n\tprivate async run({\n\t\tparsedInput,\n\t\tservices,\n\t\tlogger,\n\t\tdb,\n\t\tauditor,\n\t}: {\n\t\tparsedInput: unknown;\n\t\tservices: ServiceRecord<TServices>;\n\t\tlogger: TLogger;\n\t\tdb: TDatabase | undefined;\n\t\tauditor: Auditor<TAuditAction> | undefined;\n\t}): Promise<InferStandardSchema<TOutSchema>> {\n\t\t// Execute the function\n\t\tconst response = await this.fn.fn({\n\t\t\tinput: parsedInput,\n\t\t\tservices,\n\t\t\tlogger,\n\t\t\tdb,\n\t\t\tauditor,\n\t\t} as any);\n\n\t\t// Parse output if schema is provided\n\t\tconst output = await this.fn.parseOutput(response);\n\n\t\t// Flush audits if any were recorded\n\t\tif (auditor) {\n\t\t\tconst records = auditor.getRecords();\n\t\t\tif (records.length > 0) {\n\t\t\t\tlogger.debug(\n\t\t\t\t\t{ auditCount: records.length },\n\t\t\t\t\t'Flushing function audits',\n\t\t\t\t);\n\t\t\t\tawait auditor.flush();\n\t\t\t}\n\t\t}\n\n\t\t// Register publisher service if provided in context\n\n\t\tawait publishEvents(\n\t\t\tlogger,\n\t\t\tthis.serviceDiscovery,\n\t\t\tthis.fn.events,\n\t\t\toutput,\n\t\t\tthis.fn.publisherService,\n\t\t);\n\n\t\treturn output;\n\t}\n}\n\nexport type TestFunctionRequest<\n\tTInput extends ComposableStandardSchema | undefined = undefined,\n\tTServices extends Service[] = [],\n\tTEventPublisher extends EventPublisher<any> | undefined = undefined,\n\tTEventPublisherServiceName extends string = string,\n\tTDatabase = undefined,\n\tTAuditAction extends AuditableAction<string, unknown> = AuditableAction<\n\t\tstring,\n\t\tunknown\n\t>,\n> = {\n\tinput: InferComposableStandardSchema<TInput>;\n\tservices: ServiceRecord<TServices>;\n\tpublisher?: Service<TEventPublisherServiceName, TEventPublisher>;\n\tdb?: TDatabase;\n\tauditor?: Auditor<TAuditAction>;\n} & InferComposableStandardSchema<{ input: TInput }>;\n","import { EnvironmentParser } from '@geekmidas/envkit';\nimport type { Logger } from '@geekmidas/logger';\nimport type { InferStandardSchema } from '@geekmidas/schema';\nimport type { Service, ServiceRecord } from '@geekmidas/services';\nimport { runWithRequestContext, ServiceDiscovery } from '@geekmidas/services';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport type { Queue, QueueRecord } from './Queue';\n\n/**\n * In-memory test driver for a {@link Queue} worker. Hand it a batch of messages\n * and it registers the queue's services, runs the handler in a request context,\n * and returns the handler result — no SQS/pg-boss required.\n *\n * Pass `messages` and each gets the id `message-<index>`, or pass `records` to\n * choose the ids, for a handler that reports failures by id.\n *\n * @example\n * const adapter = new TestQueueAdaptor(ordersQueue);\n * await adapter.invoke({ messages: [{ orderId: '123' }] });\n */\nexport class TestQueueAdaptor<\n\tTName extends string = string,\n\tTMessage extends StandardSchemaV1 = StandardSchemaV1,\n\tTServices extends Service[] = [],\n\tTLogger extends Logger = Logger,\n> {\n\tstatic getDefaultServiceDiscovery() {\n\t\treturn ServiceDiscovery.getInstance(new EnvironmentParser({}));\n\t}\n\n\tconstructor(\n\t\tprivate readonly queue: Queue<TName, TMessage, TServices, TLogger>,\n\t\tprivate serviceDiscovery: ServiceDiscovery<any> = TestQueueAdaptor.getDefaultServiceDiscovery(),\n\t) {}\n\n\tasync invoke(\n\t\trequest: TestQueueRequest<TMessage, TServices>,\n\t): Promise<unknown> {\n\t\tconst logger = this.queue.logger.child({ test: true }) as TLogger;\n\n\t\tconst services =\n\t\t\trequest.services ??\n\t\t\t((await this.serviceDiscovery.register(\n\t\t\t\tthis.queue.services,\n\t\t\t)) as ServiceRecord<TServices>);\n\n\t\tconst requestId = `test-${Date.now()}`;\n\t\tconst startTime = Date.now();\n\n\t\tconst records: QueueRecord<TMessage>[] =\n\t\t\t'records' in request\n\t\t\t\t? request.records\n\t\t\t\t: request.messages.map((message, index) => ({\n\t\t\t\t\t\tid: `message-${index}`,\n\t\t\t\t\t\tmessage,\n\t\t\t\t\t}));\n\n\t\treturn runWithRequestContext({ logger, requestId, startTime }, () =>\n\t\t\tthis.queue.handler({\n\t\t\t\tmessages: records.map((r) => r.message),\n\t\t\t\trecords,\n\t\t\t\tservices,\n\t\t\t\tlogger,\n\t\t\t}),\n\t\t);\n\t}\n}\n\nexport type TestQueueRequest<\n\tTMessage extends StandardSchemaV1 = StandardSchemaV1,\n\tTServices extends Service[] = [],\n> = (\n\t| { messages: InferStandardSchema<TMessage>[] }\n\t| { records: QueueRecord<TMessage>[] }\n) & {\n\tservices?: ServiceRecord<TServices>;\n};\n","import { EnvironmentParser } from '@geekmidas/envkit';\nimport type {\n\tEventPublisher,\n\tExtractPublisherMessage,\n} from '@geekmidas/events';\nimport type { Logger } from '@geekmidas/logger';\nimport type { InferStandardSchema } from '@geekmidas/schema';\nimport type { Service, ServiceRecord } from '@geekmidas/services';\nimport { runWithRequestContext, ServiceDiscovery } from '@geekmidas/services';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport { publishEvents } from '../publisher';\nimport type { Subscriber } from './Subscriber';\n\n// Helper type to extract payload types for subscribed events\ntype ExtractEventPayloads<\n\tTPublisher extends EventPublisher<any> | undefined,\n\tTEventTypes extends any[],\n> = TPublisher extends EventPublisher<any>\n\t? Extract<ExtractPublisherMessage<TPublisher>, { type: TEventTypes[number] }>\n\t: never;\n\nexport class TestSubscriberAdaptor<\n\tTServices extends Service[] = [],\n\tTLogger extends Logger = Logger,\n\tOutSchema extends StandardSchemaV1 | undefined = undefined,\n\tTEventPublisher extends EventPublisher<any> | undefined = undefined,\n\tTEventPublisherServiceName extends string = string,\n\tTSubscribedEvents extends\n\t\tExtractPublisherMessage<TEventPublisher>['type'][] = ExtractPublisherMessage<TEventPublisher>['type'][],\n> {\n\tstatic getDefaultServiceDiscovery() {\n\t\treturn ServiceDiscovery.getInstance(new EnvironmentParser({}));\n\t}\n\n\tconstructor(\n\t\tprivate readonly subscriber: Subscriber<\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tOutSchema,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTSubscribedEvents\n\t\t>,\n\t\tprivate serviceDiscovery: ServiceDiscovery<any> = TestSubscriberAdaptor.getDefaultServiceDiscovery(),\n\t) {}\n\n\tasync invoke(\n\t\trequest: TestSubscriberRequest<\n\t\t\tTEventPublisher,\n\t\t\tTSubscribedEvents,\n\t\t\tTServices\n\t\t>,\n\t): Promise<InferStandardSchema<OutSchema>> {\n\t\t// Create logger with test context\n\t\tconst logger = this.subscriber.logger.child({\n\t\t\ttest: true,\n\t\t}) as TLogger;\n\n\t\t// Resolve services (use provided or auto-register)\n\t\tlet services: ServiceRecord<TServices>;\n\t\tif (request.services) {\n\t\t\tservices = request.services;\n\t\t} else {\n\t\t\tservices = await this.serviceDiscovery.register(this.subscriber.services);\n\t\t}\n\n\t\t// Filter events to only subscribed types\n\t\tconst filteredEvents = this.filterEvents(request.events);\n\n\t\t// Return early if no events after filtering (mirrors AWSLambdaSubscriber)\n\t\tif (filteredEvents.length === 0) {\n\t\t\treturn { batchItemFailures: [] } as any;\n\t\t}\n\n\t\t// Wrap execution in request context for service access via context.getLogger()\n\t\tconst requestId = `test-${Date.now()}`;\n\t\tconst startTime = Date.now();\n\n\t\treturn runWithRequestContext({ logger, requestId, startTime }, async () => {\n\t\t\t// Execute the subscriber handler\n\t\t\tconst result = await this.subscriber.handler({\n\t\t\t\tevents: filteredEvents,\n\t\t\t\tservices,\n\t\t\t\tlogger,\n\t\t\t});\n\n\t\t\t// Validate output if schema is provided\n\t\t\tlet output: any = result;\n\t\t\tif (this.subscriber.outputSchema && result) {\n\t\t\t\tconst validationResult =\n\t\t\t\t\tawait this.subscriber.outputSchema['~standard'].validate(result);\n\n\t\t\t\tif (validationResult.issues) {\n\t\t\t\t\tthrow new Error('Subscriber output validation failed');\n\t\t\t\t}\n\n\t\t\t\toutput = validationResult.value;\n\t\t\t}\n\n\t\t\t// Publish events if configured\n\t\t\tawait publishEvents(\n\t\t\t\tlogger,\n\t\t\t\tthis.serviceDiscovery,\n\t\t\t\tthis.subscriber.events,\n\t\t\t\toutput,\n\t\t\t\tthis.subscriber.publisherService,\n\t\t\t);\n\n\t\t\treturn output;\n\t\t}) as Promise<InferStandardSchema<OutSchema>>;\n\t}\n\n\tprivate filterEvents(\n\t\tevents: ExtractEventPayloads<TEventPublisher, TSubscribedEvents>[],\n\t): ExtractEventPayloads<TEventPublisher, TSubscribedEvents>[] {\n\t\tif (!this.subscriber.subscribedEvents) {\n\t\t\treturn events;\n\t\t}\n\n\t\treturn events.filter((event: any) =>\n\t\t\tthis.subscriber.subscribedEvents!.includes(event.type),\n\t\t);\n\t}\n}\n\nexport type TestSubscriberRequest<\n\tTEventPublisher extends EventPublisher<any> | undefined = undefined,\n\tTSubscribedEvents extends any[] = [],\n\tTServices extends Service[] = [],\n> = {\n\tevents: ExtractEventPayloads<TEventPublisher, TSubscribedEvents>[];\n\tservices?: ServiceRecord<TServices>;\n};\n"],"mappings":"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"}
@@ -42,4 +42,4 @@ Object.defineProperty(exports, 'cloneWith', {
42
42
  return cloneWith;
43
43
  }
44
44
  });
45
- //# sourceMappingURL=clone-I_WIpiFf.cjs.map
45
+ //# sourceMappingURL=clone-BQnYiRgm.cjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"clone-I_WIpiFf.cjs","names":["instance: T","delta: Record<string, unknown>"],"sources":["../src/clone.ts"],"sourcesContent":["/**\n * Cloning a builder, without enumerating its fields.\n *\n * The builders were mutable singletons that reset themselves by listing every\n * field at the end of `.handle()`. Two things followed from that, and both were\n * real:\n *\n * A configured base could not be reused. `const fn = f.logger(log)` handed back\n * `f` itself, and the first `.handle()` reset `_logger` to the default — so the\n * second handler built from that base silently logged somewhere else. Every\n * field in the reset block behaved the same way, which made\n * `f.logger(l).timeout(60_000)` a base that worked exactly once.\n *\n * And a field left out of the reset list leaked into the next handler instead.\n * `_constructs` was left out, so a function was granted a bucket a *previous*\n * function had declared — an over-grant in the field a deploy reads to size an\n * IAM policy.\n *\n * Both are the same defect: a hand-maintained list of fields that has to be\n * edited every time a field is added, and is silent when it isn't. So this\n * copies whatever the instance actually has, and the list stops existing. The\n * prototype is carried over, so `instanceof` and every method still resolve,\n * and the constructor is deliberately not re-run — this copies state rather\n * than initialising it.\n *\n * Fields must be replaced rather than mutated in place: a clone and its parent\n * share whatever array a field points at, so `_events.push(…)` would be seen by\n * both. Every builder assigns a fresh array instead, which is what makes\n * sharing the reference safe.\n */\nexport function cloneWith<T extends object>(\n\tinstance: T,\n\tdelta: Record<string, unknown>,\n): T {\n\tconst next = Object.create(Object.getPrototypeOf(instance)) as T;\n\n\treturn Object.assign(next, instance, delta);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BA,SAAgB,UACfA,UACAC,OACI;CACJ,MAAM,OAAO,OAAO,OAAO,OAAO,eAAe,SAAS,CAAC;AAE3D,QAAO,OAAO,OAAO,MAAM,UAAU,MAAM;AAC3C"}
1
+ {"version":3,"file":"clone-BQnYiRgm.cjs","names":["instance: T","delta: Record<string, unknown>"],"sources":["../src/clone.ts"],"sourcesContent":["/**\n * Cloning a builder, without enumerating its fields.\n *\n * The builders were mutable singletons that reset themselves by listing every\n * field at the end of `.handle()`. Two things followed from that, and both were\n * real:\n *\n * A configured base could not be reused. `const fn = f.logger(log)` handed back\n * `f` itself, and the first `.handle()` reset `_logger` to the default — so the\n * second handler built from that base silently logged somewhere else. Every\n * field in the reset block behaved the same way, which made\n * `f.logger(l).timeout(60_000)` a base that worked exactly once.\n *\n * And a field left out of the reset list leaked into the next handler instead.\n * `_constructs` was left out, so a function was granted a bucket a *previous*\n * function had declared — an over-grant in the field a deploy reads to size an\n * IAM policy.\n *\n * Both are the same defect: a hand-maintained list of fields that has to be\n * edited every time a field is added, and is silent when it isn't. So this\n * copies whatever the instance actually has, and the list stops existing. The\n * prototype is carried over, so `instanceof` and every method still resolve,\n * and the constructor is deliberately not re-run — this copies state rather\n * than initialising it.\n *\n * Fields must be replaced rather than mutated in place: a clone and its parent\n * share whatever array a field points at, so `_events.push(…)` would be seen by\n * both. Every builder assigns a fresh array instead, which is what makes\n * sharing the reference safe.\n */\nexport function cloneWith<T extends object>(\n\tinstance: T,\n\tdelta: Record<string, unknown>,\n): T {\n\tconst next = Object.create(Object.getPrototypeOf(instance)) as T;\n\n\treturn Object.assign(next, instance, delta);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BA,SAAgB,UACfA,UACAC,OACI;CACJ,MAAM,OAAO,OAAO,OAAO,OAAO,eAAe,SAAS,CAAC;AAE3D,QAAO,OAAO,OAAO,MAAM,UAAU,MAAM;AAC3C"}
@@ -36,4 +36,4 @@ function cloneWith(instance, delta) {
36
36
 
37
37
  //#endregion
38
38
  export { cloneWith };
39
- //# sourceMappingURL=clone-pdXxc0t3.mjs.map
39
+ //# sourceMappingURL=clone-BWIwx6vL.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"clone-pdXxc0t3.mjs","names":["instance: T","delta: Record<string, unknown>"],"sources":["../src/clone.ts"],"sourcesContent":["/**\n * Cloning a builder, without enumerating its fields.\n *\n * The builders were mutable singletons that reset themselves by listing every\n * field at the end of `.handle()`. Two things followed from that, and both were\n * real:\n *\n * A configured base could not be reused. `const fn = f.logger(log)` handed back\n * `f` itself, and the first `.handle()` reset `_logger` to the default — so the\n * second handler built from that base silently logged somewhere else. Every\n * field in the reset block behaved the same way, which made\n * `f.logger(l).timeout(60_000)` a base that worked exactly once.\n *\n * And a field left out of the reset list leaked into the next handler instead.\n * `_constructs` was left out, so a function was granted a bucket a *previous*\n * function had declared — an over-grant in the field a deploy reads to size an\n * IAM policy.\n *\n * Both are the same defect: a hand-maintained list of fields that has to be\n * edited every time a field is added, and is silent when it isn't. So this\n * copies whatever the instance actually has, and the list stops existing. The\n * prototype is carried over, so `instanceof` and every method still resolve,\n * and the constructor is deliberately not re-run — this copies state rather\n * than initialising it.\n *\n * Fields must be replaced rather than mutated in place: a clone and its parent\n * share whatever array a field points at, so `_events.push(…)` would be seen by\n * both. Every builder assigns a fresh array instead, which is what makes\n * sharing the reference safe.\n */\nexport function cloneWith<T extends object>(\n\tinstance: T,\n\tdelta: Record<string, unknown>,\n): T {\n\tconst next = Object.create(Object.getPrototypeOf(instance)) as T;\n\n\treturn Object.assign(next, instance, delta);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BA,SAAgB,UACfA,UACAC,OACI;CACJ,MAAM,OAAO,OAAO,OAAO,OAAO,eAAe,SAAS,CAAC;AAE3D,QAAO,OAAO,OAAO,MAAM,UAAU,MAAM;AAC3C"}
1
+ {"version":3,"file":"clone-BWIwx6vL.mjs","names":["instance: T","delta: Record<string, unknown>"],"sources":["../src/clone.ts"],"sourcesContent":["/**\n * Cloning a builder, without enumerating its fields.\n *\n * The builders were mutable singletons that reset themselves by listing every\n * field at the end of `.handle()`. Two things followed from that, and both were\n * real:\n *\n * A configured base could not be reused. `const fn = f.logger(log)` handed back\n * `f` itself, and the first `.handle()` reset `_logger` to the default — so the\n * second handler built from that base silently logged somewhere else. Every\n * field in the reset block behaved the same way, which made\n * `f.logger(l).timeout(60_000)` a base that worked exactly once.\n *\n * And a field left out of the reset list leaked into the next handler instead.\n * `_constructs` was left out, so a function was granted a bucket a *previous*\n * function had declared — an over-grant in the field a deploy reads to size an\n * IAM policy.\n *\n * Both are the same defect: a hand-maintained list of fields that has to be\n * edited every time a field is added, and is silent when it isn't. So this\n * copies whatever the instance actually has, and the list stops existing. The\n * prototype is carried over, so `instanceof` and every method still resolve,\n * and the constructor is deliberately not re-run — this copies state rather\n * than initialising it.\n *\n * Fields must be replaced rather than mutated in place: a clone and its parent\n * share whatever array a field points at, so `_events.push(…)` would be seen by\n * both. Every builder assigns a fresh array instead, which is what makes\n * sharing the reference safe.\n */\nexport function cloneWith<T extends object>(\n\tinstance: T,\n\tdelta: Record<string, unknown>,\n): T {\n\tconst next = Object.create(Object.getPrototypeOf(instance)) as T;\n\n\treturn Object.assign(next, instance, delta);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BA,SAAgB,UACfA,UACAC,OACI;CACJ,MAAM,OAAO,OAAO,OAAO,OAAO,eAAe,SAAS,CAAC;AAE3D,QAAO,OAAO,OAAO,MAAM,UAAU,MAAM;AAC3C"}
@@ -1,8 +1,9 @@
1
- const require_Construct = require('../Construct-D09WUUOf.cjs');
2
- const require_functions = require('../functions-B3OFv3QV.cjs');
3
- const require_clone = require('../clone-I_WIpiFf.cjs');
4
- require('../publisher-BZgcrVPy.cjs');
5
- const require_AWSScheduledFunction = require('../AWSScheduledFunction-CKhVurOa.cjs');
1
+ const require_Construct = require('../Construct-Cf_0pAvo.cjs');
2
+ require('../monitor-D3uHJ8DU.cjs');
3
+ const require_functions = require('../functions-DzjxHo1V.cjs');
4
+ const require_clone = require('../clone-BQnYiRgm.cjs');
5
+ require('../publisher-B6Wu-JNv.cjs');
6
+ const require_AWSScheduledFunction = require('../AWSScheduledFunction-C-JBSNak.cjs');
6
7
 
7
8
  //#region src/crons/Cron.ts
8
9
  var Cron = class extends require_functions.Function {
@@ -16,6 +17,14 @@ var Cron = class extends require_functions.Function {
16
17
  get schedule() {
17
18
  return this._schedule;
18
19
  }
20
+ /**
21
+ * The monitor set with `.uptime()` as the build manifest records it, or
22
+ * nothing when the cron has none.
23
+ */
24
+ getUptime() {
25
+ const [uptime] = this.monitors;
26
+ return uptime && (uptime.monitor ?? { type: uptime.serviceName });
27
+ }
19
28
  };
20
29
 
21
30
  //#endregion
@@ -23,6 +32,7 @@ var Cron = class extends require_functions.Function {
23
32
  var import_lodash = require_Construct.__toESM(require_functions.require_lodash(), 1);
24
33
  var CronBuilder = class extends require_functions.FunctionBuilder {
25
34
  _schedule;
35
+ _uptime;
26
36
  constructor() {
27
37
  super(require_Construct.ConstructType.Cron);
28
38
  }
@@ -36,6 +46,17 @@ var CronBuilder = class extends require_functions.FunctionBuilder {
36
46
  schedule(_expression) {
37
47
  return require_clone.cloneWith(this, { _schedule: _expression });
38
48
  }
49
+ /**
50
+ * Report each run to an uptime monitor, so a cron that stops running is
51
+ * noticed: `heartbeat.betterStack()` pings on success and reports a
52
+ * failure. Calling it again replaces the monitor.
53
+ *
54
+ * `gkm build` records it in the manifest with the schedule's period, the
55
+ * longest gap between runs, so infrastructure can create the heartbeat.
56
+ */
57
+ uptime(monitor) {
58
+ return require_clone.cloneWith(this, { _uptime: monitor });
59
+ }
39
60
  input(schema) {
40
61
  return require_clone.cloneWith(this, { inputSchema: schema });
41
62
  }
@@ -60,7 +81,7 @@ var CronBuilder = class extends require_functions.FunctionBuilder {
60
81
  }
61
82
  handle(fn) {
62
83
  const cron = new Cron(fn, this._timeout, this._schedule, this.inputSchema, this.outputSchema, this._services, this._logger, this._publisher, this._events, this._memorySize, this._databaseService);
63
- cron.monitors = this._monitors;
84
+ cron.monitors = this._uptime ? [this._uptime] : [];
64
85
  return cron;
65
86
  }
66
87
  };
@@ -1 +1 @@
1
- {"version":3,"file":"index.cjs","names":["Function","obj: any","ConstructType","fn: FunctionHandler<TInput, TServices, TLogger, OutSchema, TDatabase>","timeout?: number","_schedule?: ScheduleExpression","input?: TInput","outputSchema?: OutSchema","services: TServices","logger?: TLogger","publisherService?: Service<TEventPublisherServiceName, TEventPublisher>","events: any[]","memorySize?: number","databaseService?: Service<TDatabaseServiceName, TDatabase>","FunctionBuilder","ConstructType","memorySize: number","_expression: CronExpression<T>","schema: T","services: T","logger: T","publisher: Service<TName, T>","service: Service<TName, T>","fn: FunctionHandler<TInput, TServices, TLogger, OutSchema, TDatabase>"],"sources":["../../src/crons/Cron.ts","../../src/crons/CronBuilder.ts","../../src/crons/index.ts"],"sourcesContent":["import type { AuditableAction } from '@geekmidas/audit';\nimport type { EventPublisher } from '@geekmidas/events';\nimport type { Logger } from '@geekmidas/logger';\nimport type { ComposableStandardSchema } from '@geekmidas/schema';\nimport type { Service } from '@geekmidas/services';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\n\nimport { ConstructType } from '../Construct';\nimport { Function, type FunctionHandler } from '../functions';\n\nexport class Cron<\n\tTInput extends ComposableStandardSchema | undefined = undefined,\n\tTServices extends Service[] = [],\n\tTLogger extends Logger = Logger,\n\tOutSchema extends StandardSchemaV1 | undefined = undefined,\n\tTEventPublisher extends EventPublisher<any> | undefined = undefined,\n\tTEventPublisherServiceName extends string = string,\n\tTDatabase = undefined,\n\tTDatabaseServiceName extends string = string,\n> extends Function<\n\tTInput,\n\tTServices,\n\tTLogger,\n\tOutSchema,\n\tTEventPublisher,\n\tTEventPublisherServiceName,\n\tundefined,\n\tstring,\n\tTDatabase,\n\tTDatabaseServiceName,\n\tAuditableAction<string, unknown>,\n\tFunctionHandler<TInput, TServices, TLogger, OutSchema, TDatabase>\n> {\n\tstatic isCron(obj: any): obj is Cron<any, any, any, any> {\n\t\treturn Boolean(\n\t\t\tobj &&\n\t\t\t\t(obj as Function).__IS_FUNCTION__ === true &&\n\t\t\t\tobj.type === ConstructType.Cron,\n\t\t);\n\t}\n\n\tconstructor(\n\t\tfn: FunctionHandler<TInput, TServices, TLogger, OutSchema, TDatabase>,\n\t\ttimeout?: number,\n\t\tprotected _schedule?: ScheduleExpression,\n\t\tinput?: TInput,\n\t\toutputSchema?: OutSchema,\n\t\tservices: TServices = [] as unknown as TServices,\n\t\tlogger?: TLogger,\n\t\tpublisherService?: Service<TEventPublisherServiceName, TEventPublisher>,\n\t\tevents: any[] = [],\n\t\tmemorySize?: number,\n\t\tdatabaseService?: Service<TDatabaseServiceName, TDatabase>,\n\t) {\n\t\tsuper(\n\t\t\tfn,\n\t\t\ttimeout,\n\t\t\tConstructType.Cron,\n\t\t\tinput,\n\t\t\toutputSchema,\n\t\t\tservices,\n\t\t\tlogger,\n\t\t\tpublisherService,\n\t\t\tevents,\n\t\t\tmemorySize,\n\t\t\tundefined, // auditorStorageService\n\t\t\tdatabaseService,\n\t\t);\n\t}\n\n\tget schedule(): ScheduleExpression | undefined {\n\t\treturn this._schedule;\n\t}\n}\n\n// ---- Cron expression types ------------------------------------------------\n//\n// `.schedule()` takes a `cron(…)` in either of two dialects, told apart by the\n// field count, and checks each by its own rules:\n//\n// - Unix, five fields: `min hour day-of-month month day-of-week`, with\n// day-of-week 0–7 (SUN = 0 or 7) and no `?`.\n// - AWS, six fields: `min hour day-of-month month day-of-week year`, with\n// day-of-week 1–7 (SUN = 1), `?` in exactly one day field, and `L`, `W`\n// and `#` where EventBridge allows them.\n//\n// The types are generic because a plain union of every field's forms is too\n// large for TypeScript, so the literal is checked field by field instead.\n// `@geekmidas/manifest`'s `parseCron` applies the same rules at build time.\n\ntype Digit = '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9';\n\n/** `'0'`…`'99'`, with an optional leading zero (`'08'`). */\ntype UpTo99 = Digit | `${Digit}${Digit}`;\n\ntype ToNumber<S extends string> = S extends `0${infer R extends `${number}`}`\n\t? R extends ''\n\t\t? 0\n\t\t: ToNumber<R>\n\t: S extends `${infer N extends number}`\n\t\t? N\n\t\t: never;\n\ntype Range<\n\tN extends number,\n\tAcc extends number[] = [],\n> = Acc['length'] extends N ? Acc[number] : Range<N, [...Acc, Acc['length']]>;\n\n/** Numbers from `Min` to `Max` inclusive. */\ntype Between<Min extends number, Max extends number> =\n\t| Exclude<Range<Max>, Range<Min>>\n\t| Max;\n\n/** A single value: a number in range, or one of the field's names. */\ntype IsValue<\n\tS extends string,\n\tMin extends number,\n\tMax extends number,\n\tNames extends string,\n> = S extends Names\n\t? true\n\t: S extends UpTo99\n\t\t? ToNumber<S> extends Between<Min, Max>\n\t\t\t? true\n\t\t\t: false\n\t\t: false;\n\n/** `v`, `a-b` or `*`, with an optional `/step`. */\ntype IsAtom<\n\tS extends string,\n\tMin extends number,\n\tMax extends number,\n\tNames extends string,\n> = S extends `${infer Base}/${infer Step}`\n\t? Step extends UpTo99\n\t\t? Base extends '*'\n\t\t\t? true\n\t\t\t: IsAtom<Base, Min, Max, Names>\n\t\t: false\n\t: S extends '*'\n\t\t? true\n\t\t: S extends `${infer A}-${infer B}`\n\t\t\t? [IsValue<A, Min, Max, Names>, IsValue<B, Min, Max, Names>] extends [\n\t\t\t\t\ttrue,\n\t\t\t\t\ttrue,\n\t\t\t\t]\n\t\t\t\t? true\n\t\t\t\t: false\n\t\t\t: IsValue<S, Min, Max, Names>;\n\n/** A comma-separated list of atoms. */\ntype IsField<\n\tS extends string,\n\tMin extends number,\n\tMax extends number,\n\tNames extends string = never,\n> = S extends `${infer Head},${infer Rest}`\n\t? IsAtom<Head, Min, Max, Names> extends true\n\t\t? IsField<Rest, Min, Max, Names>\n\t\t: false\n\t: IsAtom<S, Min, Max, Names>;\n\ntype MonthName =\n\t| 'JAN'\n\t| 'FEB'\n\t| 'MAR'\n\t| 'APR'\n\t| 'MAY'\n\t| 'JUN'\n\t| 'JUL'\n\t| 'AUG'\n\t| 'SEP'\n\t| 'OCT'\n\t| 'NOV'\n\t| 'DEC';\ntype DayName = 'SUN' | 'MON' | 'TUE' | 'WED' | 'THU' | 'FRI' | 'SAT';\n\ntype AllTrue<T extends boolean[]> = T extends true[] ? true : false;\n\ntype IsUnix<S extends string> =\n\tS extends `${infer Mi} ${infer H} ${infer Dom} ${infer Mo} ${infer Dow}`\n\t\t? AllTrue<\n\t\t\t\t[\n\t\t\t\t\tIsField<Mi, 0, 59>,\n\t\t\t\t\tIsField<H, 0, 23>,\n\t\t\t\t\tIsField<Dom, 1, 31>,\n\t\t\t\t\tIsField<Mo, 1, 12, MonthName>,\n\t\t\t\t\tIsField<Dow, 0, 7, DayName>,\n\t\t\t\t]\n\t\t\t>\n\t\t: false;\n\ntype IsAwsDayOfMonth<S extends string> = S extends 'L' | `L-${UpTo99}` | 'LW'\n\t? true\n\t: S extends `${infer D}W`\n\t\t? IsValue<D, 1, 31, never>\n\t\t: IsField<S, 1, 31>;\n\ntype IsAwsDayOfWeek<S extends string> = S extends `${infer D}L`\n\t? IsValue<D, 1, 7, DayName>\n\t: S extends `${infer D}#${infer N}`\n\t\t? AllTrue<[IsValue<D, 1, 7, DayName>, IsValue<N, 1, 5, never>]>\n\t\t: IsField<S, 1, 7, DayName>;\n\n/** 1970–2199, EventBridge's range. */\ntype Year = `19${'7' | '8' | '9'}${Digit}` | `${'20' | '21'}${Digit}${Digit}`;\n\ntype IsYearAtom<S extends string> = S extends\n\t| '*'\n\t| Year\n\t| `${'*' | Year}/${UpTo99}`\n\t| `${Year}-${Year}`\n\t? true\n\t: false;\n\ntype IsAwsYear<S extends string> = S extends `${infer Head},${infer Rest}`\n\t? IsYearAtom<Head> extends true\n\t\t? IsAwsYear<Rest>\n\t\t: false\n\t: IsYearAtom<S>;\n\ntype IsAws<S extends string> =\n\tS extends `${infer Mi} ${infer H} ${infer Dom} ${infer Mo} ${infer Dow} ${infer Y}`\n\t\t? AllTrue<\n\t\t\t\t[\n\t\t\t\t\tIsField<Mi, 0, 59>,\n\t\t\t\t\tIsField<H, 0, 23>,\n\t\t\t\t\tIsField<Mo, 1, 12, MonthName>,\n\t\t\t\t\tIsAwsYear<Y>,\n\t\t\t\t\tDom extends '?'\n\t\t\t\t\t\t? Dow extends '?'\n\t\t\t\t\t\t\t? false\n\t\t\t\t\t\t\t: IsAwsDayOfWeek<Dow>\n\t\t\t\t\t\t: Dow extends '?'\n\t\t\t\t\t\t\t? IsAwsDayOfMonth<Dom>\n\t\t\t\t\t\t\t: false,\n\t\t\t\t]\n\t\t\t>\n\t\t: false;\n\n/** `T` when it is a valid five-field Unix `cron(…)`. */\nexport type UnixCronExpression<T extends string> = T extends `cron(${infer S})`\n\t? IsUnix<S> extends true\n\t\t? T\n\t\t: never\n\t: never;\n\n/** `T` when it is a valid six-field AWS (EventBridge) `cron(…)`. */\nexport type AwsCronExpression<T extends string> = T extends `cron(${infer S})`\n\t? IsAws<S> extends true\n\t\t? T\n\t\t: never\n\t: never;\n\n/**\n * `T` when it is a valid cron expression in either dialect, otherwise a\n * message saying what's expected. A schedule built at runtime can be cast to\n * {@link ScheduleExpression}, which `gkm build` then checks.\n */\nexport type CronExpression<T extends string> = [T] extends [ScheduleExpression]\n\t? [ScheduleExpression] extends [T]\n\t\t? T\n\t\t: CheckedCronExpression<T>\n\t: CheckedCronExpression<T>;\n\ntype CheckedCronExpression<T extends string> = [\n\tUnixCronExpression<T> | AwsCronExpression<T>,\n] extends [never]\n\t? 'Expected cron(…) with 5 fields (Unix) or 6 fields (AWS)'\n\t: T;\n\n/**\n * A cron's schedule once set. Literals are checked by {@link CronExpression};\n * every schedule is checked again by `gkm build`.\n */\nexport type ScheduleExpression = `cron(${string})`;\n","import type { EventPublisher } from '@geekmidas/events';\nimport type { Logger } from '@geekmidas/logger';\nimport type { ComposableStandardSchema } from '@geekmidas/schema';\nimport type { Service } from '@geekmidas/services';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport uniqBy from 'lodash.uniqby';\nimport { ConstructType } from '../Construct';\nimport { cloneWith } from '../clone';\nimport { FunctionBuilder, type FunctionHandler } from '../functions';\nimport { Cron, type CronExpression, type ScheduleExpression } from './Cron';\n\nexport class CronBuilder<\n\tTInput extends ComposableStandardSchema,\n\tTServices extends Service[],\n\tTLogger extends Logger = Logger,\n\tOutSchema extends StandardSchemaV1 | undefined = undefined,\n\tTEventPublisher extends EventPublisher<any> | undefined = undefined,\n\tTEventPublisherServiceName extends string = string,\n\tTDatabase = undefined,\n\tTDatabaseServiceName extends string = string,\n> extends FunctionBuilder<\n\tTInput,\n\tOutSchema,\n\tTServices,\n\tTLogger,\n\tTEventPublisher,\n\tTEventPublisherServiceName,\n\tundefined,\n\tstring,\n\tTDatabase,\n\tTDatabaseServiceName\n> {\n\tprivate _schedule?: ScheduleExpression;\n\n\tconstructor() {\n\t\tsuper(ConstructType.Cron);\n\t}\n\n\toverride memorySize(memorySize: number): this {\n\t\treturn cloneWith(this, { _memorySize: memorySize });\n\t}\n\n\t/**\n\t * When the cron runs: a five-field Unix `cron(…)` or a six-field AWS one.\n\t * `gkm build` writes it to the manifest in the AWS form.\n\t */\n\tschedule<const T extends string>(\n\t\t_expression: CronExpression<T>,\n\t): CronBuilder<\n\t\tTInput,\n\t\tTServices,\n\t\tTLogger,\n\t\tOutSchema,\n\t\tTEventPublisher,\n\t\tTEventPublisherServiceName,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t> {\n\t\treturn cloneWith(this, {\n\t\t\t_schedule: _expression as ScheduleExpression,\n\t\t});\n\t}\n\n\toverride input<T extends ComposableStandardSchema>(\n\t\tschema: T,\n\t): CronBuilder<\n\t\tT,\n\t\tTServices,\n\t\tTLogger,\n\t\tOutSchema,\n\t\tTEventPublisher,\n\t\tTEventPublisherServiceName,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t> {\n\t\treturn cloneWith(this, {\n\t\t\tinputSchema: schema as unknown as TInput,\n\t\t}) as unknown as CronBuilder<\n\t\t\tT,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tOutSchema,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName\n\t\t>;\n\t}\n\n\toverride output<T extends StandardSchemaV1>(\n\t\tschema: T,\n\t): CronBuilder<\n\t\tTInput,\n\t\tTServices,\n\t\tTLogger,\n\t\tT,\n\t\tTEventPublisher,\n\t\tTEventPublisherServiceName,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t> {\n\t\treturn cloneWith(this, {\n\t\t\toutputSchema: schema as unknown as OutSchema,\n\t\t}) as unknown as CronBuilder<\n\t\t\tTInput,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tT,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName\n\t\t>;\n\t}\n\n\toverride services<T extends Service[]>(\n\t\tservices: T,\n\t): CronBuilder<\n\t\tTInput,\n\t\t[...TServices, ...T],\n\t\tTLogger,\n\t\tOutSchema,\n\t\tTEventPublisher,\n\t\tTEventPublisherServiceName,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t> {\n\t\treturn cloneWith(this, {\n\t\t\t_services: uniqBy(\n\t\t\t\t[...this._services, ...services],\n\t\t\t\t(s) => s.serviceName,\n\t\t\t) as TServices,\n\t\t}) as unknown as CronBuilder<\n\t\t\tTInput,\n\t\t\t[...TServices, ...T],\n\t\t\tTLogger,\n\t\t\tOutSchema,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName\n\t\t>;\n\t}\n\n\toverride logger<T extends Logger>(\n\t\tlogger: T,\n\t): CronBuilder<\n\t\tTInput,\n\t\tTServices,\n\t\tT,\n\t\tOutSchema,\n\t\tTEventPublisher,\n\t\tTEventPublisherServiceName,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t> {\n\t\treturn cloneWith(this, {\n\t\t\t_logger: logger as unknown as TLogger,\n\t\t}) as unknown as CronBuilder<\n\t\t\tTInput,\n\t\t\tTServices,\n\t\t\tT,\n\t\t\tOutSchema,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName\n\t\t>;\n\t}\n\n\toverride publisher<T extends EventPublisher<any>, TName extends string>(\n\t\tpublisher: Service<TName, T>,\n\t): CronBuilder<\n\t\tTInput,\n\t\tTServices,\n\t\tTLogger,\n\t\tOutSchema,\n\t\tT,\n\t\tTName,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t> {\n\t\treturn cloneWith(this, {\n\t\t\t_publisher: publisher as unknown as Service<\n\t\t\t\tTEventPublisherServiceName,\n\t\t\t\tTEventPublisher\n\t\t\t>,\n\t\t}) as unknown as CronBuilder<\n\t\t\tTInput,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tOutSchema,\n\t\t\tT,\n\t\t\tTName,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName\n\t\t>;\n\t}\n\n\t/**\n\t * Set the database service for this cron job.\n\t * The database will be available in the handler context as `db`.\n\t */\n\toverride database<T, TName extends string>(\n\t\tservice: Service<TName, T>,\n\t): CronBuilder<\n\t\tTInput,\n\t\tTServices,\n\t\tTLogger,\n\t\tOutSchema,\n\t\tTEventPublisher,\n\t\tTEventPublisherServiceName,\n\t\tT,\n\t\tTName\n\t> {\n\t\treturn cloneWith(this, {\n\t\t\t_databaseService: service as unknown as Service<\n\t\t\t\tTDatabaseServiceName,\n\t\t\t\tTDatabase\n\t\t\t>,\n\t\t}) as unknown as CronBuilder<\n\t\t\tTInput,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tOutSchema,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tT,\n\t\t\tTName\n\t\t>;\n\t}\n\n\toverride handle(\n\t\tfn: FunctionHandler<TInput, TServices, TLogger, OutSchema, TDatabase>,\n\t): Cron<\n\t\tTInput,\n\t\tTServices,\n\t\tTLogger,\n\t\tOutSchema,\n\t\tTEventPublisher,\n\t\tTEventPublisherServiceName,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t> {\n\t\tconst cron = new Cron(\n\t\t\tfn,\n\t\t\tthis._timeout,\n\t\t\tthis._schedule,\n\t\t\tthis.inputSchema,\n\t\t\tthis.outputSchema,\n\t\t\tthis._services,\n\t\t\tthis._logger,\n\t\t\tthis._publisher,\n\t\t\tthis._events,\n\t\t\tthis._memorySize,\n\t\t\tthis._databaseService,\n\t\t);\n\n\t\t// No reset. `.handle()` reads this builder and leaves it alone, so a\n\t\t// configured base keeps its configuration for every construct built\n\t\t// from it. The reset that used to be here wiped the base on first use.\n\n\t\tcron.monitors = this._monitors;\n\n\t\treturn cron;\n\t}\n}\n","export { AWSScheduledFunction } from './AWSScheduledFunction';\nexport {\n\ttype AwsCronExpression,\n\tCron,\n\ttype CronExpression,\n\ttype ScheduleExpression,\n\ttype UnixCronExpression,\n} from './Cron';\nexport { CronBuilder } from './CronBuilder';\n\nimport { CronBuilder } from './CronBuilder';\n\nexport const c = new CronBuilder();\n"],"mappings":";;;;;;;AAUA,IAAa,OAAb,cASUA,2BAaR;CACD,OAAO,OAAOC,KAA2C;AACxD,SAAO,QACN,OACE,IAAiB,oBAAoB,QACtC,IAAI,SAASC,gCAAc,KAC5B;CACD;CAED,YACCC,IACAC,SACUC,WACVC,OACAC,cACAC,WAAsB,CAAE,GACxBC,QACAC,kBACAC,SAAgB,CAAE,GAClBC,YACAC,iBACC;AACD,QACC,IACA,SACAX,gCAAc,MACd,OACA,cACA,UACA,QACA,kBACA,QACA,oBAEA,gBACA;EAvBS;CAwBV;CAED,IAAI,WAA2C;AAC9C,SAAO,KAAK;CACZ;AACD;;;;;AC9DD,IAAa,cAAb,cASUY,kCAWR;CACD,AAAQ;CAER,cAAc;AACb,QAAMC,gCAAc,KAAK;CACzB;CAED,AAAS,WAAWC,YAA0B;AAC7C,SAAO,wBAAU,MAAM,EAAE,aAAa,WAAY,EAAC;CACnD;;;;;CAMD,SACCC,aAUC;AACD,SAAO,wBAAU,MAAM,EACtB,WAAW,YACX,EAAC;CACF;CAED,AAAS,MACRC,QAUC;AACD,SAAO,wBAAU,MAAM,EACtB,aAAa,OACb,EAAC;CAUF;CAED,AAAS,OACRA,QAUC;AACD,SAAO,wBAAU,MAAM,EACtB,cAAc,OACd,EAAC;CAUF;CAED,AAAS,SACRC,UAUC;AACD,SAAO,wBAAU,MAAM,EACtB,WAAW,2BACV,CAAC,GAAG,KAAK,WAAW,GAAG,QAAS,GAChC,CAAC,MAAM,EAAE,YACT,CACD,EAAC;CAUF;CAED,AAAS,OACRC,QAUC;AACD,SAAO,wBAAU,MAAM,EACtB,SAAS,OACT,EAAC;CAUF;CAED,AAAS,UACRC,WAUC;AACD,SAAO,wBAAU,MAAM,EACtB,YAAY,UAIZ,EAAC;CAUF;;;;;CAMD,AAAS,SACRC,SAUC;AACD,SAAO,wBAAU,MAAM,EACtB,kBAAkB,QAIlB,EAAC;CAUF;CAED,AAAS,OACRC,IAUC;EACD,MAAM,OAAO,IAAI,KAChB,IACA,KAAK,UACL,KAAK,WACL,KAAK,aACL,KAAK,cACL,KAAK,WACL,KAAK,SACL,KAAK,YACL,KAAK,SACL,KAAK,aACL,KAAK;AAON,OAAK,WAAW,KAAK;AAErB,SAAO;CACP;AACD;;;;AC9PD,MAAa,IAAI,IAAI"}
1
+ {"version":3,"file":"index.cjs","names":["Function","obj: any","ConstructType","fn: FunctionHandler<TInput, TServices, TLogger, OutSchema, TDatabase>","timeout?: number","_schedule?: ScheduleExpression","input?: TInput","outputSchema?: OutSchema","services: TServices","logger?: TLogger","publisherService?: Service<TEventPublisherServiceName, TEventPublisher>","events: any[]","memorySize?: number","databaseService?: Service<TDatabaseServiceName, TDatabase>","FunctionBuilder","ConstructType","memorySize: number","_expression: CronExpression<T>","monitor: MonitorService","schema: T","services: T","logger: T","publisher: Service<TName, T>","service: Service<TName, T>","fn: FunctionHandler<TInput, TServices, TLogger, OutSchema, TDatabase>"],"sources":["../../src/crons/Cron.ts","../../src/crons/CronBuilder.ts","../../src/crons/index.ts"],"sourcesContent":["import type { AuditableAction } from '@geekmidas/audit';\nimport type { EventPublisher } from '@geekmidas/events';\nimport type { Logger } from '@geekmidas/logger';\nimport type { ComposableStandardSchema } from '@geekmidas/schema';\nimport type { Service } from '@geekmidas/services';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\n\nimport { ConstructType } from '../Construct';\nimport { Function, type FunctionHandler } from '../functions';\nimport type { MonitorInfo } from '../monitor';\n\nexport class Cron<\n\tTInput extends ComposableStandardSchema | undefined = undefined,\n\tTServices extends Service[] = [],\n\tTLogger extends Logger = Logger,\n\tOutSchema extends StandardSchemaV1 | undefined = undefined,\n\tTEventPublisher extends EventPublisher<any> | undefined = undefined,\n\tTEventPublisherServiceName extends string = string,\n\tTDatabase = undefined,\n\tTDatabaseServiceName extends string = string,\n> extends Function<\n\tTInput,\n\tTServices,\n\tTLogger,\n\tOutSchema,\n\tTEventPublisher,\n\tTEventPublisherServiceName,\n\tundefined,\n\tstring,\n\tTDatabase,\n\tTDatabaseServiceName,\n\tAuditableAction<string, unknown>,\n\tFunctionHandler<TInput, TServices, TLogger, OutSchema, TDatabase>\n> {\n\tstatic isCron(obj: any): obj is Cron<any, any, any, any> {\n\t\treturn Boolean(\n\t\t\tobj &&\n\t\t\t\t(obj as Function).__IS_FUNCTION__ === true &&\n\t\t\t\tobj.type === ConstructType.Cron,\n\t\t);\n\t}\n\n\tconstructor(\n\t\tfn: FunctionHandler<TInput, TServices, TLogger, OutSchema, TDatabase>,\n\t\ttimeout?: number,\n\t\tprotected _schedule?: ScheduleExpression,\n\t\tinput?: TInput,\n\t\toutputSchema?: OutSchema,\n\t\tservices: TServices = [] as unknown as TServices,\n\t\tlogger?: TLogger,\n\t\tpublisherService?: Service<TEventPublisherServiceName, TEventPublisher>,\n\t\tevents: any[] = [],\n\t\tmemorySize?: number,\n\t\tdatabaseService?: Service<TDatabaseServiceName, TDatabase>,\n\t) {\n\t\tsuper(\n\t\t\tfn,\n\t\t\ttimeout,\n\t\t\tConstructType.Cron,\n\t\t\tinput,\n\t\t\toutputSchema,\n\t\t\tservices,\n\t\t\tlogger,\n\t\t\tpublisherService,\n\t\t\tevents,\n\t\t\tmemorySize,\n\t\t\tundefined, // auditorStorageService\n\t\t\tdatabaseService,\n\t\t);\n\t}\n\n\tget schedule(): ScheduleExpression | undefined {\n\t\treturn this._schedule;\n\t}\n\n\t/**\n\t * The monitor set with `.uptime()` as the build manifest records it, or\n\t * nothing when the cron has none.\n\t */\n\tgetUptime(): MonitorInfo | undefined {\n\t\tconst [uptime] = this.monitors;\n\t\treturn uptime && (uptime.monitor ?? { type: uptime.serviceName });\n\t}\n}\n\n// ---- Cron expression types ------------------------------------------------\n//\n// `.schedule()` takes a `cron(…)` in either of two dialects, told apart by the\n// field count, and checks each by its own rules:\n//\n// - Unix, five fields: `min hour day-of-month month day-of-week`, with\n// day-of-week 0–7 (SUN = 0 or 7) and no `?`.\n// - AWS, six fields: `min hour day-of-month month day-of-week year`, with\n// day-of-week 1–7 (SUN = 1), `?` in exactly one day field, and `L`, `W`\n// and `#` where EventBridge allows them.\n//\n// The types are generic because a plain union of every field's forms is too\n// large for TypeScript, so the literal is checked field by field instead.\n// `@geekmidas/manifest`'s `parseCron` applies the same rules at build time.\n\ntype Digit = '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9';\n\n/** `'0'`…`'99'`, with an optional leading zero (`'08'`). */\ntype UpTo99 = Digit | `${Digit}${Digit}`;\n\ntype ToNumber<S extends string> = S extends `0${infer R extends `${number}`}`\n\t? R extends ''\n\t\t? 0\n\t\t: ToNumber<R>\n\t: S extends `${infer N extends number}`\n\t\t? N\n\t\t: never;\n\ntype Range<\n\tN extends number,\n\tAcc extends number[] = [],\n> = Acc['length'] extends N ? Acc[number] : Range<N, [...Acc, Acc['length']]>;\n\n/** Numbers from `Min` to `Max` inclusive. */\ntype Between<Min extends number, Max extends number> =\n\t| Exclude<Range<Max>, Range<Min>>\n\t| Max;\n\n/** A single value: a number in range, or one of the field's names. */\ntype IsValue<\n\tS extends string,\n\tMin extends number,\n\tMax extends number,\n\tNames extends string,\n> = S extends Names\n\t? true\n\t: S extends UpTo99\n\t\t? ToNumber<S> extends Between<Min, Max>\n\t\t\t? true\n\t\t\t: false\n\t\t: false;\n\n/** `v`, `a-b` or `*`, with an optional `/step`. */\ntype IsAtom<\n\tS extends string,\n\tMin extends number,\n\tMax extends number,\n\tNames extends string,\n> = S extends `${infer Base}/${infer Step}`\n\t? Step extends UpTo99\n\t\t? Base extends '*'\n\t\t\t? true\n\t\t\t: IsAtom<Base, Min, Max, Names>\n\t\t: false\n\t: S extends '*'\n\t\t? true\n\t\t: S extends `${infer A}-${infer B}`\n\t\t\t? [IsValue<A, Min, Max, Names>, IsValue<B, Min, Max, Names>] extends [\n\t\t\t\t\ttrue,\n\t\t\t\t\ttrue,\n\t\t\t\t]\n\t\t\t\t? true\n\t\t\t\t: false\n\t\t\t: IsValue<S, Min, Max, Names>;\n\n/** A comma-separated list of atoms. */\ntype IsField<\n\tS extends string,\n\tMin extends number,\n\tMax extends number,\n\tNames extends string = never,\n> = S extends `${infer Head},${infer Rest}`\n\t? IsAtom<Head, Min, Max, Names> extends true\n\t\t? IsField<Rest, Min, Max, Names>\n\t\t: false\n\t: IsAtom<S, Min, Max, Names>;\n\ntype MonthName =\n\t| 'JAN'\n\t| 'FEB'\n\t| 'MAR'\n\t| 'APR'\n\t| 'MAY'\n\t| 'JUN'\n\t| 'JUL'\n\t| 'AUG'\n\t| 'SEP'\n\t| 'OCT'\n\t| 'NOV'\n\t| 'DEC';\ntype DayName = 'SUN' | 'MON' | 'TUE' | 'WED' | 'THU' | 'FRI' | 'SAT';\n\ntype AllTrue<T extends boolean[]> = T extends true[] ? true : false;\n\ntype IsUnix<S extends string> =\n\tS extends `${infer Mi} ${infer H} ${infer Dom} ${infer Mo} ${infer Dow}`\n\t\t? AllTrue<\n\t\t\t\t[\n\t\t\t\t\tIsField<Mi, 0, 59>,\n\t\t\t\t\tIsField<H, 0, 23>,\n\t\t\t\t\tIsField<Dom, 1, 31>,\n\t\t\t\t\tIsField<Mo, 1, 12, MonthName>,\n\t\t\t\t\tIsField<Dow, 0, 7, DayName>,\n\t\t\t\t]\n\t\t\t>\n\t\t: false;\n\ntype IsAwsDayOfMonth<S extends string> = S extends 'L' | `L-${UpTo99}` | 'LW'\n\t? true\n\t: S extends `${infer D}W`\n\t\t? IsValue<D, 1, 31, never>\n\t\t: IsField<S, 1, 31>;\n\ntype IsAwsDayOfWeek<S extends string> = S extends `${infer D}L`\n\t? IsValue<D, 1, 7, DayName>\n\t: S extends `${infer D}#${infer N}`\n\t\t? AllTrue<[IsValue<D, 1, 7, DayName>, IsValue<N, 1, 5, never>]>\n\t\t: IsField<S, 1, 7, DayName>;\n\n/** 1970–2199, EventBridge's range. */\ntype Year = `19${'7' | '8' | '9'}${Digit}` | `${'20' | '21'}${Digit}${Digit}`;\n\ntype IsYearAtom<S extends string> = S extends\n\t| '*'\n\t| Year\n\t| `${'*' | Year}/${UpTo99}`\n\t| `${Year}-${Year}`\n\t? true\n\t: false;\n\ntype IsAwsYear<S extends string> = S extends `${infer Head},${infer Rest}`\n\t? IsYearAtom<Head> extends true\n\t\t? IsAwsYear<Rest>\n\t\t: false\n\t: IsYearAtom<S>;\n\ntype IsAws<S extends string> =\n\tS extends `${infer Mi} ${infer H} ${infer Dom} ${infer Mo} ${infer Dow} ${infer Y}`\n\t\t? AllTrue<\n\t\t\t\t[\n\t\t\t\t\tIsField<Mi, 0, 59>,\n\t\t\t\t\tIsField<H, 0, 23>,\n\t\t\t\t\tIsField<Mo, 1, 12, MonthName>,\n\t\t\t\t\tIsAwsYear<Y>,\n\t\t\t\t\tDom extends '?'\n\t\t\t\t\t\t? Dow extends '?'\n\t\t\t\t\t\t\t? false\n\t\t\t\t\t\t\t: IsAwsDayOfWeek<Dow>\n\t\t\t\t\t\t: Dow extends '?'\n\t\t\t\t\t\t\t? IsAwsDayOfMonth<Dom>\n\t\t\t\t\t\t\t: false,\n\t\t\t\t]\n\t\t\t>\n\t\t: false;\n\n/** `T` when it is a valid five-field Unix `cron(…)`. */\nexport type UnixCronExpression<T extends string> = T extends `cron(${infer S})`\n\t? IsUnix<S> extends true\n\t\t? T\n\t\t: never\n\t: never;\n\n/** `T` when it is a valid six-field AWS (EventBridge) `cron(…)`. */\nexport type AwsCronExpression<T extends string> = T extends `cron(${infer S})`\n\t? IsAws<S> extends true\n\t\t? T\n\t\t: never\n\t: never;\n\n/**\n * `T` when it is a valid cron expression in either dialect, otherwise a\n * message saying what's expected. A schedule built at runtime can be cast to\n * {@link ScheduleExpression}, which `gkm build` then checks.\n */\nexport type CronExpression<T extends string> = [T] extends [ScheduleExpression]\n\t? [ScheduleExpression] extends [T]\n\t\t? T\n\t\t: CheckedCronExpression<T>\n\t: CheckedCronExpression<T>;\n\ntype CheckedCronExpression<T extends string> = [\n\tUnixCronExpression<T> | AwsCronExpression<T>,\n] extends [never]\n\t? 'Expected cron(…) with 5 fields (Unix) or 6 fields (AWS)'\n\t: T;\n\n/**\n * A cron's schedule once set. Literals are checked by {@link CronExpression};\n * every schedule is checked again by `gkm build`.\n */\nexport type ScheduleExpression = `cron(${string})`;\n","import type { EventPublisher } from '@geekmidas/events';\nimport type { Logger } from '@geekmidas/logger';\nimport type { ComposableStandardSchema } from '@geekmidas/schema';\nimport type { Service } from '@geekmidas/services';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport uniqBy from 'lodash.uniqby';\nimport { ConstructType } from '../Construct';\nimport { cloneWith } from '../clone';\nimport { FunctionBuilder, type FunctionHandler } from '../functions';\nimport type { MonitorService } from '../monitor';\nimport { Cron, type CronExpression, type ScheduleExpression } from './Cron';\n\nexport class CronBuilder<\n\tTInput extends ComposableStandardSchema,\n\tTServices extends Service[],\n\tTLogger extends Logger = Logger,\n\tOutSchema extends StandardSchemaV1 | undefined = undefined,\n\tTEventPublisher extends EventPublisher<any> | undefined = undefined,\n\tTEventPublisherServiceName extends string = string,\n\tTDatabase = undefined,\n\tTDatabaseServiceName extends string = string,\n> extends FunctionBuilder<\n\tTInput,\n\tOutSchema,\n\tTServices,\n\tTLogger,\n\tTEventPublisher,\n\tTEventPublisherServiceName,\n\tundefined,\n\tstring,\n\tTDatabase,\n\tTDatabaseServiceName\n> {\n\tprivate _schedule?: ScheduleExpression;\n\tprivate _uptime?: MonitorService;\n\n\tconstructor() {\n\t\tsuper(ConstructType.Cron);\n\t}\n\n\toverride memorySize(memorySize: number): this {\n\t\treturn cloneWith(this, { _memorySize: memorySize });\n\t}\n\n\t/**\n\t * When the cron runs: a five-field Unix `cron(…)` or a six-field AWS one.\n\t * `gkm build` writes it to the manifest in the AWS form.\n\t */\n\tschedule<const T extends string>(\n\t\t_expression: CronExpression<T>,\n\t): CronBuilder<\n\t\tTInput,\n\t\tTServices,\n\t\tTLogger,\n\t\tOutSchema,\n\t\tTEventPublisher,\n\t\tTEventPublisherServiceName,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t> {\n\t\treturn cloneWith(this, {\n\t\t\t_schedule: _expression as ScheduleExpression,\n\t\t});\n\t}\n\n\t/**\n\t * Report each run to an uptime monitor, so a cron that stops running is\n\t * noticed: `heartbeat.betterStack()` pings on success and reports a\n\t * failure. Calling it again replaces the monitor.\n\t *\n\t * `gkm build` records it in the manifest with the schedule's period, the\n\t * longest gap between runs, so infrastructure can create the heartbeat.\n\t */\n\tuptime(monitor: MonitorService): this {\n\t\treturn cloneWith(this, { _uptime: monitor });\n\t}\n\n\toverride input<T extends ComposableStandardSchema>(\n\t\tschema: T,\n\t): CronBuilder<\n\t\tT,\n\t\tTServices,\n\t\tTLogger,\n\t\tOutSchema,\n\t\tTEventPublisher,\n\t\tTEventPublisherServiceName,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t> {\n\t\treturn cloneWith(this, {\n\t\t\tinputSchema: schema as unknown as TInput,\n\t\t}) as unknown as CronBuilder<\n\t\t\tT,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tOutSchema,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName\n\t\t>;\n\t}\n\n\toverride output<T extends StandardSchemaV1>(\n\t\tschema: T,\n\t): CronBuilder<\n\t\tTInput,\n\t\tTServices,\n\t\tTLogger,\n\t\tT,\n\t\tTEventPublisher,\n\t\tTEventPublisherServiceName,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t> {\n\t\treturn cloneWith(this, {\n\t\t\toutputSchema: schema as unknown as OutSchema,\n\t\t}) as unknown as CronBuilder<\n\t\t\tTInput,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tT,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName\n\t\t>;\n\t}\n\n\toverride services<T extends Service[]>(\n\t\tservices: T,\n\t): CronBuilder<\n\t\tTInput,\n\t\t[...TServices, ...T],\n\t\tTLogger,\n\t\tOutSchema,\n\t\tTEventPublisher,\n\t\tTEventPublisherServiceName,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t> {\n\t\treturn cloneWith(this, {\n\t\t\t_services: uniqBy(\n\t\t\t\t[...this._services, ...services],\n\t\t\t\t(s) => s.serviceName,\n\t\t\t) as TServices,\n\t\t}) as unknown as CronBuilder<\n\t\t\tTInput,\n\t\t\t[...TServices, ...T],\n\t\t\tTLogger,\n\t\t\tOutSchema,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName\n\t\t>;\n\t}\n\n\toverride logger<T extends Logger>(\n\t\tlogger: T,\n\t): CronBuilder<\n\t\tTInput,\n\t\tTServices,\n\t\tT,\n\t\tOutSchema,\n\t\tTEventPublisher,\n\t\tTEventPublisherServiceName,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t> {\n\t\treturn cloneWith(this, {\n\t\t\t_logger: logger as unknown as TLogger,\n\t\t}) as unknown as CronBuilder<\n\t\t\tTInput,\n\t\t\tTServices,\n\t\t\tT,\n\t\t\tOutSchema,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName\n\t\t>;\n\t}\n\n\toverride publisher<T extends EventPublisher<any>, TName extends string>(\n\t\tpublisher: Service<TName, T>,\n\t): CronBuilder<\n\t\tTInput,\n\t\tTServices,\n\t\tTLogger,\n\t\tOutSchema,\n\t\tT,\n\t\tTName,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t> {\n\t\treturn cloneWith(this, {\n\t\t\t_publisher: publisher as unknown as Service<\n\t\t\t\tTEventPublisherServiceName,\n\t\t\t\tTEventPublisher\n\t\t\t>,\n\t\t}) as unknown as CronBuilder<\n\t\t\tTInput,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tOutSchema,\n\t\t\tT,\n\t\t\tTName,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName\n\t\t>;\n\t}\n\n\t/**\n\t * Set the database service for this cron job.\n\t * The database will be available in the handler context as `db`.\n\t */\n\toverride database<T, TName extends string>(\n\t\tservice: Service<TName, T>,\n\t): CronBuilder<\n\t\tTInput,\n\t\tTServices,\n\t\tTLogger,\n\t\tOutSchema,\n\t\tTEventPublisher,\n\t\tTEventPublisherServiceName,\n\t\tT,\n\t\tTName\n\t> {\n\t\treturn cloneWith(this, {\n\t\t\t_databaseService: service as unknown as Service<\n\t\t\t\tTDatabaseServiceName,\n\t\t\t\tTDatabase\n\t\t\t>,\n\t\t}) as unknown as CronBuilder<\n\t\t\tTInput,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tOutSchema,\n\t\t\tTEventPublisher,\n\t\t\tTEventPublisherServiceName,\n\t\t\tT,\n\t\t\tTName\n\t\t>;\n\t}\n\n\toverride handle(\n\t\tfn: FunctionHandler<TInput, TServices, TLogger, OutSchema, TDatabase>,\n\t): Cron<\n\t\tTInput,\n\t\tTServices,\n\t\tTLogger,\n\t\tOutSchema,\n\t\tTEventPublisher,\n\t\tTEventPublisherServiceName,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t> {\n\t\tconst cron = new Cron(\n\t\t\tfn,\n\t\t\tthis._timeout,\n\t\t\tthis._schedule,\n\t\t\tthis.inputSchema,\n\t\t\tthis.outputSchema,\n\t\t\tthis._services,\n\t\t\tthis._logger,\n\t\t\tthis._publisher,\n\t\t\tthis._events,\n\t\t\tthis._memorySize,\n\t\t\tthis._databaseService,\n\t\t);\n\n\t\t// No reset. `.handle()` reads this builder and leaves it alone, so a\n\t\t// configured base keeps its configuration for every construct built\n\t\t// from it. The reset that used to be here wiped the base on first use.\n\n\t\tcron.monitors = this._uptime ? [this._uptime] : [];\n\n\t\treturn cron;\n\t}\n}\n","export { AWSScheduledFunction } from './AWSScheduledFunction';\nexport {\n\ttype AwsCronExpression,\n\tCron,\n\ttype CronExpression,\n\ttype ScheduleExpression,\n\ttype UnixCronExpression,\n} from './Cron';\nexport { CronBuilder } from './CronBuilder';\n\nimport { CronBuilder } from './CronBuilder';\n\nexport const c = new CronBuilder();\n"],"mappings":";;;;;;;;AAWA,IAAa,OAAb,cASUA,2BAaR;CACD,OAAO,OAAOC,KAA2C;AACxD,SAAO,QACN,OACE,IAAiB,oBAAoB,QACtC,IAAI,SAASC,gCAAc,KAC5B;CACD;CAED,YACCC,IACAC,SACUC,WACVC,OACAC,cACAC,WAAsB,CAAE,GACxBC,QACAC,kBACAC,SAAgB,CAAE,GAClBC,YACAC,iBACC;AACD,QACC,IACA,SACAX,gCAAc,MACd,OACA,cACA,UACA,QACA,kBACA,QACA,oBAEA,gBACA;EAvBS;CAwBV;CAED,IAAI,WAA2C;AAC9C,SAAO,KAAK;CACZ;;;;;CAMD,YAAqC;EACpC,MAAM,CAAC,OAAO,GAAG,KAAK;AACtB,SAAO,WAAW,OAAO,WAAW,EAAE,MAAM,OAAO,YAAa;CAChE;AACD;;;;;ACvED,IAAa,cAAb,cASUY,kCAWR;CACD,AAAQ;CACR,AAAQ;CAER,cAAc;AACb,QAAMC,gCAAc,KAAK;CACzB;CAED,AAAS,WAAWC,YAA0B;AAC7C,SAAO,wBAAU,MAAM,EAAE,aAAa,WAAY,EAAC;CACnD;;;;;CAMD,SACCC,aAUC;AACD,SAAO,wBAAU,MAAM,EACtB,WAAW,YACX,EAAC;CACF;;;;;;;;;CAUD,OAAOC,SAA+B;AACrC,SAAO,wBAAU,MAAM,EAAE,SAAS,QAAS,EAAC;CAC5C;CAED,AAAS,MACRC,QAUC;AACD,SAAO,wBAAU,MAAM,EACtB,aAAa,OACb,EAAC;CAUF;CAED,AAAS,OACRA,QAUC;AACD,SAAO,wBAAU,MAAM,EACtB,cAAc,OACd,EAAC;CAUF;CAED,AAAS,SACRC,UAUC;AACD,SAAO,wBAAU,MAAM,EACtB,WAAW,2BACV,CAAC,GAAG,KAAK,WAAW,GAAG,QAAS,GAChC,CAAC,MAAM,EAAE,YACT,CACD,EAAC;CAUF;CAED,AAAS,OACRC,QAUC;AACD,SAAO,wBAAU,MAAM,EACtB,SAAS,OACT,EAAC;CAUF;CAED,AAAS,UACRC,WAUC;AACD,SAAO,wBAAU,MAAM,EACtB,YAAY,UAIZ,EAAC;CAUF;;;;;CAMD,AAAS,SACRC,SAUC;AACD,SAAO,wBAAU,MAAM,EACtB,kBAAkB,QAIlB,EAAC;CAUF;CAED,AAAS,OACRC,IAUC;EACD,MAAM,OAAO,IAAI,KAChB,IACA,KAAK,UACL,KAAK,WACL,KAAK,aACL,KAAK,cACL,KAAK,WACL,KAAK,SACL,KAAK,YACL,KAAK,SACL,KAAK,aACL,KAAK;AAON,OAAK,WAAW,KAAK,UAAU,CAAC,KAAK,OAAQ,IAAG,CAAE;AAElD,SAAO;CACP;AACD;;;;AC5QD,MAAa,IAAI,IAAI"}
@@ -1,6 +1,6 @@
1
- import "../Construct-D_3yZ9m5.cjs";
2
- import { FunctionBuilder, FunctionHandler } from "../index-CeoLMr7c.cjs";
3
- import { AWSScheduledFunction, AwsCronExpression, Cron, CronExpression, ScheduleExpression, UnixCronExpression } from "../AWSScheduledFunction-DAGP_vz5.cjs";
1
+ import { MonitorService } from "../Construct-BEh2DSMe.cjs";
2
+ import { FunctionBuilder, FunctionHandler } from "../index-XJKTxGx7.cjs";
3
+ import { AWSScheduledFunction, AwsCronExpression, Cron, CronExpression, ScheduleExpression, UnixCronExpression } from "../AWSScheduledFunction-D0_HIJj8.cjs";
4
4
  import { EventPublisher } from "@geekmidas/events";
5
5
  import * as _geekmidas_logger2 from "@geekmidas/logger";
6
6
  import { Logger } from "@geekmidas/logger";
@@ -13,6 +13,7 @@ import { StandardSchemaV1 } from "@standard-schema/spec";
13
13
  //#region src/crons/CronBuilder.d.ts
14
14
  declare class CronBuilder<TInput extends ComposableStandardSchema, TServices extends Service[], TLogger extends Logger = Logger, OutSchema extends StandardSchemaV1 | undefined = undefined, TEventPublisher extends EventPublisher<any> | undefined = undefined, TEventPublisherServiceName extends string = string, TDatabase = undefined, TDatabaseServiceName extends string = string> extends FunctionBuilder<TInput, OutSchema, TServices, TLogger, TEventPublisher, TEventPublisherServiceName, undefined, string, TDatabase, TDatabaseServiceName> {
15
15
  private _schedule?;
16
+ private _uptime?;
16
17
  constructor();
17
18
  memorySize(memorySize: number): this;
18
19
  /**
@@ -20,6 +21,15 @@ declare class CronBuilder<TInput extends ComposableStandardSchema, TServices ext
20
21
  * `gkm build` writes it to the manifest in the AWS form.
21
22
  */
22
23
  schedule<const T extends string>(_expression: CronExpression<T>): CronBuilder<TInput, TServices, TLogger, OutSchema, TEventPublisher, TEventPublisherServiceName, TDatabase, TDatabaseServiceName>;
24
+ /**
25
+ * Report each run to an uptime monitor, so a cron that stops running is
26
+ * noticed: `heartbeat.betterStack()` pings on success and reports a
27
+ * failure. Calling it again replaces the monitor.
28
+ *
29
+ * `gkm build` records it in the manifest with the schedule's period, the
30
+ * longest gap between runs, so infrastructure can create the heartbeat.
31
+ */
32
+ uptime(monitor: MonitorService): this;
23
33
  input<T extends ComposableStandardSchema>(schema: T): CronBuilder<T, TServices, TLogger, OutSchema, TEventPublisher, TEventPublisherServiceName, TDatabase, TDatabaseServiceName>;
24
34
  output<T extends StandardSchemaV1>(schema: T): CronBuilder<TInput, TServices, TLogger, T, TEventPublisher, TEventPublisherServiceName, TDatabase, TDatabaseServiceName>;
25
35
  services<T extends Service[]>(services: T): CronBuilder<TInput, [...TServices, ...T], TLogger, OutSchema, TEventPublisher, TEventPublisherServiceName, TDatabase, TDatabaseServiceName>;
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.cts","names":[],"sources":["../../src/crons/CronBuilder.ts","../../src/crons/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;cAWa,2BACG,4CACG,2BACF,SAAS,0BACP,kEACM,8KAIf,gBACT,QACA,WACA,WACA,SACA,iBACA,+CAGA,WACA;;;;;;AAnBD;;EAAwB,QACR,CAAA,gBAAA,MAAA,CAAA,CAAA,WAAA,EAmCD,cAnCC,CAmCc,CAnCd,CAAA,CAAA,EAoCZ,WApCY,CAqCd,MArCc,EAsCd,SAtCc,EAuCd,OAvCc,EAwCd,SAxCc,EAyCd,eAzCc,EA0Cd,0BA1Cc,EA2Cd,SA3Cc,EA4Cd,oBA5Cc,CAAA;EAAwB,KACrB,CAAA,UAkDO,wBAlDP,CAAA,CAAA,MAAA,EAmDT,CAnDS,CAAA,EAoDf,WApDe,CAqDjB,CArDiB,EAsDjB,SAtDiB,EAuDjB,OAvDiB,EAwDjB,SAxDiB,EAyDjB,eAzDiB,EA0DjB,0BA1DiB,EA2DjB,SA3DiB,EA4DjB,oBA5DiB,CAAA;EAAO,MACT,CAAA,UA2EU,gBA3EV,CAAA,CAAA,MAAA,EA4EP,CA5EO,CAAA,EA6Eb,WA7Ea,CA8Ef,MA9Ee,EA+Ef,SA/Ee,EAgFf,OAhFe,EAiFf,CAjFe,EAkFf,eAlFe,EAmFf,0BAnFe,EAoFf,SApFe,EAqFf,oBArFe,CAAA;EAAM,QAAG,CAAA,UAqGG,OArGH,EAAA,CAAA,CAAA,QAAA,EAsGd,CAtGc,CAAA,EAuGtB,WAvGsB,CAwGxB,MAxGwB,EAAA,CACP,GAwGb,SAxGa,EACM,GAuGL,CAvGK,CAAc,EAwGrC,OAnGD,EAoGC,SApGD,EAqGC,eArGD,EAsGC,0BAtGD,EAuGC,SAvGD,EAwGC,oBAxGD,CAAA;EAAM,MACN,CAAA,UA0H0B,MA1H1B,CAAA,CAAA,MAAA,EA2HS,CA3HT,CAAA,EA4HG,WA5HH,CA6HC,MA7HD,EA8HC,SA9HD,EA+HC,CA/HD,EAgIC,SAhID,EAiIC,eAjID,EAkIC,0BAlID,EAmIC,SAnID,EAoIC,oBApID,CAAA;EAAS,SACT,CAAA,UAmJ6B,cAnJ7B,CAAA,GAAA,CAAA,EAAA,cAAA,MAAA,CAAA,CAAA,SAAA,EAoJY,OApJZ,CAoJoB,KApJpB,EAoJ2B,CApJ3B,CAAA,CAAA,EAqJG,WArJH,CAsJC,MAtJD,EAuJC,SAvJD,EAwJC,OAxJD,EAyJC,SAzJD,EA0JC,CA1JD,EA2JC,KA3JD,EA4JC,SA5JD,EA6JC,oBA7JD,CAAA;EAAS;;;;EAMA,QACT,CAAA,CAAA,EAAA,cAAA,MAAA,CAAA,CAAA,OAAA,EA8KU,OA9KV,CA8KkB,KA9KlB,EA8KyB,CA9KzB,CAAA,CAAA,EA+KG,WA/KH,CAgLC,MAhLD,EAiLC,SAjLD,EAkLC,OAlLD,EAmLC,SAnLD,EAoLC,eApLD,EAqLC,0BArLD,EAsLC,CAtLD,EAuLC,KAvLD,CAAA;EAAoB,MAiBS,CAAA,EAAA,EA0LxB,eA1LwB,CA0LR,MA1LQ,EA0LA,SA1LA,EA0LW,OA1LX,EA0LoB,SA1LpB,EA0L+B,SA1L/B,CAAA,CAAA,EA2L1B,IA3L0B,CA4L5B,MA5L4B,EA6L5B,SA7L4B,EA8L5B,OA9L4B,EA+L5B,SA/L4B,EAgM5B,eAhM4B,EAiM5B,0BAjM4B,EAkM5B,SAlM4B,EAmM5B,oBAnM4B,CAAA;;;;;cCnCjB,GAAC,YAAoB,kBAAA,CAApB,wBAAA,EAAA,oBAAA,CAAA,4BAAA,kBAAA,CAAA,MAAA"}
1
+ {"version":3,"file":"index.d.cts","names":[],"sources":["../../src/crons/CronBuilder.ts","../../src/crons/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;cAYa,2BACG,4CACG,2BACF,SAAS,0BACP,kEACM,8KAIf,gBACT,QACA,WACA,WACA,SACA,iBACA,+CAGA,WACA;;;;;EAnBY;;;;EAEa,QACT,CAAA,gBAAA,MAAA,CAAA,CAAA,WAAA,EAkCF,cAlCE,CAkCa,CAlCb,CAAA,CAAA,EAmCb,WAnCa,CAoCf,MApCe,EAqCf,SArCe,EAsCf,OAtCe,EAuCf,SAvCe,EAwCf,eAxCe,EAyCf,0BAzCe,EA0Cf,SA1Ce,EA2Cf,oBA3Ce,CAAA;EAAM;;;;;;;;EAWP,MACf,CAAA,OAAA,EA8CgB,cA9ChB,CAAA,EAAA,IAAA;EAA0B,KAG1B,CAAA,UA+CyB,wBA/CzB,CAAA,CAAA,MAAA,EAgDS,CAhDT,CAAA,EAiDG,WAjDH,CAkDC,CAlDD,EAmDC,SAnDD,EAoDC,OApDD,EAqDC,SArDD,EAsDC,eAtDD,EAuDC,0BAvDD,EAwDC,SAxDD,EAyDC,oBAzDD,CAAA;EAAS,MACT,CAAA,UAwE0B,gBAxE1B,CAAA,CAAA,MAAA,EAyES,CAzET,CAAA,EA0EG,WA1EH,CA2EC,MA3ED,EA4EC,SA5ED,EA6EC,OA7ED,EA8EC,CA9ED,EA+EC,eA/ED,EAgFC,0BAhFD,EAiFC,SAjFD,EAkFC,oBAlFD,CAAA;EAAoB,QAkBS,CAAA,UAgFD,OAhFC,EAAA,CAAA,CAAA,QAAA,EAiFlB,CAjFkB,CAAA,EAkF1B,WAlF0B,CAmF5B,MAnF4B,EAAA,CAAf,GAoFT,SApFS,EAEb,GAkFkB,CAlFlB,CAAM,EAmFN,OAlFA,EAmFA,SAnFA,EAoFA,eApFA,EAqFA,0BArFA,EAsFA,SAtFA,EAuFA,oBAvFA,CAAA;EAAS,MACT,CAAA,UAyGyB,MAzGzB,CAAA,CAAA,MAAA,EA0GQ,CA1GR,CAAA,EA2GE,WA3GF,CA4GA,MA5GA,EA6GA,SA7GA,EA8GA,CA9GA,EA+GA,SA/GA,EAgHA,eAhHA,EAiHA,0BAjHA,EAkHA,SAlHA,EAmHA,oBAnHA,CAAA;EAAO,SACP,CAAA,UAkI4B,cAlI5B,CAAA,GAAA,CAAA,EAAA,cAAA,MAAA,CAAA,CAAA,SAAA,EAmIW,OAnIX,CAmImB,KAnInB,EAmI0B,CAnI1B,CAAA,CAAA,EAoIE,WApIF,CAqIA,MArIA,EAsIA,SAtIA,EAuIA,OAvIA,EAwIA,SAxIA,EAyIA,CAzIA,EA0IA,KA1IA,EA2IA,SA3IA,EA4IA,oBA5IA,CAAA;EAAS;;;;EAIW,QARlB,CAAA,CAAA,EAAA,cAAA,MAAA,CAAA,CAAA,OAAA,EAwKO,OAxKP,CAwKe,KAxKf,EAwKsB,CAxKtB,CAAA,CAAA,EAyKA,WAzKA,CA0KF,MA1KE,EA2KF,SA3KE,EA4KF,OA5KE,EA6KF,SA7KE,EA8KF,eA9KE,EA+KF,0BA/KE,EAgLF,CAhLE,EAiLF,KAjLE,CAAA;EAAW,MAuBE,CAAA,EAAA,EA8KX,eA9KW,CA8KK,MA9KL,EA8Ka,SA9Kb,EA8KwB,OA9KxB,EA8KiC,SA9KjC,EA8K4C,SA9K5C,CAAA,CAAA,EA+Kb,IA/Ka,CAgLf,MAhLe,EAiLf,SAjLe,EAkLf,OAlLe,EAmLf,SAnLe,EAoLf,eApLe,EAqLf,0BArLe,EAsLf,SAtLe,EAuLf,oBAvLe,CAAA;;;;;cC7DJ,GAAC,YAAoB,kBAAA,CAApB,wBAAA,EAAA,oBAAA,CAAA,4BAAA,kBAAA,CAAA,MAAA"}
@@ -1,6 +1,6 @@
1
- import "../Construct-DsqpiAym.mjs";
2
- import { FunctionBuilder, FunctionHandler } from "../index-B8LNLQXD.mjs";
3
- import { AWSScheduledFunction, AwsCronExpression, Cron, CronExpression, ScheduleExpression, UnixCronExpression } from "../AWSScheduledFunction-Dg6TPIxn.mjs";
1
+ import { MonitorService } from "../Construct-qnOnQTcP.mjs";
2
+ import { FunctionBuilder, FunctionHandler } from "../index-CbhtERFB.mjs";
3
+ import { AWSScheduledFunction, AwsCronExpression, Cron, CronExpression, ScheduleExpression, UnixCronExpression } from "../AWSScheduledFunction--49dTSUQ.mjs";
4
4
  import { Service as Service$1 } from "@geekmidas/services";
5
5
  import { EventPublisher } from "@geekmidas/events";
6
6
  import { Logger as Logger$1 } from "@geekmidas/logger";
@@ -10,6 +10,7 @@ import { StandardSchemaV1 } from "@standard-schema/spec";
10
10
  //#region src/crons/CronBuilder.d.ts
11
11
  declare class CronBuilder<TInput extends ComposableStandardSchema$1, TServices extends Service$1[], TLogger extends Logger$1 = Logger$1, OutSchema extends StandardSchemaV1 | undefined = undefined, TEventPublisher extends EventPublisher<any> | undefined = undefined, TEventPublisherServiceName extends string = string, TDatabase = undefined, TDatabaseServiceName extends string = string> extends FunctionBuilder<TInput, OutSchema, TServices, TLogger, TEventPublisher, TEventPublisherServiceName, undefined, string, TDatabase, TDatabaseServiceName> {
12
12
  private _schedule?;
13
+ private _uptime?;
13
14
  constructor();
14
15
  memorySize(memorySize: number): this;
15
16
  /**
@@ -17,6 +18,15 @@ declare class CronBuilder<TInput extends ComposableStandardSchema$1, TServices e
17
18
  * `gkm build` writes it to the manifest in the AWS form.
18
19
  */
19
20
  schedule<const T extends string>(_expression: CronExpression<T>): CronBuilder<TInput, TServices, TLogger, OutSchema, TEventPublisher, TEventPublisherServiceName, TDatabase, TDatabaseServiceName>;
21
+ /**
22
+ * Report each run to an uptime monitor, so a cron that stops running is
23
+ * noticed: `heartbeat.betterStack()` pings on success and reports a
24
+ * failure. Calling it again replaces the monitor.
25
+ *
26
+ * `gkm build` records it in the manifest with the schedule's period, the
27
+ * longest gap between runs, so infrastructure can create the heartbeat.
28
+ */
29
+ uptime(monitor: MonitorService): this;
20
30
  input<T extends ComposableStandardSchema$1>(schema: T): CronBuilder<T, TServices, TLogger, OutSchema, TEventPublisher, TEventPublisherServiceName, TDatabase, TDatabaseServiceName>;
21
31
  output<T extends StandardSchemaV1>(schema: T): CronBuilder<TInput, TServices, TLogger, T, TEventPublisher, TEventPublisherServiceName, TDatabase, TDatabaseServiceName>;
22
32
  services<T extends Service$1[]>(services: T): CronBuilder<TInput, [...TServices, ...T], TLogger, OutSchema, TEventPublisher, TEventPublisherServiceName, TDatabase, TDatabaseServiceName>;
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.mts","names":[],"sources":["../../src/crons/CronBuilder.ts","../../src/crons/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;cAWa,2BACG,8CACG,6BACF,WAAS,4BACP,kEACM,8KAIf,gBACT,QACA,WACA,WACA,SACA,iBACA,+CAGA,WACA;;;EAnBY,UAAA,CAAA,UAAW,EAAA,MAAA,CAAA,EAAA,IAAA;EAAA;;;;EAGD,QAAG,CAAA,gBAAA,MAAA,CAAA,CAAA,WAAA,EAiCX,cAjCW,CAiCI,CAjCJ,CAAA,CAAA,EAkCtB,WAlCsB,CAmCxB,MAnCwB,EAoCxB,SApCwB,EAqCxB,OArCwB,EAsCxB,SAtCwB,EAuCxB,eAvCwB,EAwCxB,0BAxCwB,EAyCxB,SAzCwB,EA0CxB,oBA1CwB,CAAA;EAAM,KACb,CAAA,UAgDO,0BAhDP,CAAA,CAAA,MAAA,EAiDT,CAjDS,CAAA,EAkDf,WAlDe,CAmDjB,CAnDiB,EAoDjB,SApDiB,EAqDjB,OArDiB,EAsDjB,SAtDiB,EAuDjB,eAvDiB,EAwDjB,0BAxDiB,EAyDjB,SAzDiB,EA0DjB,oBA1DiB,CAAA;EAAgB,MACV,CAAA,UAyEE,gBAzEF,CAAA,CAAA,MAAA,EA0Ef,CA1Ee,CAAA,EA2ErB,WA3EqB,CA4EvB,MA5EuB,EA6EvB,SA7EuB,EA8EvB,OA9EuB,EA+EvB,CA/EuB,EAgFvB,eAhFuB,EAiFvB,0BAjFuB,EAkFvB,SAlFuB,EAmFvB,oBAnFuB,CAAA;EAAc,QAKtC,CAAA,UA8F4B,SA9F5B,EAAA,CAAA,CAAA,QAAA,EA+FW,CA/FX,CAAA,EAgGG,WAhGH,CAiGC,MAjGD,EAAA,CACA,GAiGK,SAjGL,EACA,GAgGmB,CAhGnB,CAAS,EAiGR,OAhGD,EAiGC,SAjGD,EAkGC,eAlGD,EAmGC,0BAnGD,EAoGC,SApGD,EAqGC,oBArGD,CAAA;EAAO,MACP,CAAA,UAuH0B,QAvH1B,CAAA,CAAA,MAAA,EAwHS,CAxHT,CAAA,EAyHG,WAzHH,CA0HC,MA1HD,EA2HC,SA3HD,EA4HC,CA5HD,EA6HC,SA7HD,EA8HC,eA9HD,EA+HC,0BA/HD,EAgIC,SAhID,EAiIC,oBAjID,CAAA;EAAe,SACf,CAAA,UAgJ6B,cAhJ7B,CAAA,GAAA,CAAA,EAAA,cAAA,MAAA,CAAA,CAAA,SAAA,EAiJY,SAjJZ,CAiJoB,KAjJpB,EAiJ2B,CAjJ3B,CAAA,CAAA,EAkJG,WAlJH,CAmJC,MAnJD,EAoJC,SApJD,EAqJC,OArJD,EAsJC,SAtJD,EAuJC,CAvJD,EAwJC,KAxJD,EAyJC,SAzJD,EA0JC,oBA1JD,CAAA;EAA0B;;;;EAqBE,QAE3B,CAAA,CAAA,EAAA,cAAA,MAAA,CAAA,CAAA,OAAA,EA2JS,SA3JT,CA2JiB,KA3JjB,EA2JwB,CA3JxB,CAAA,CAAA,EA4JE,WA5JF,CA6JA,MA7JA,EA8JA,SA9JA,EA+JA,OA/JA,EAgKA,SAhKA,EAiKA,eAjKA,EAkKA,0BAlKA,EAmKA,CAnKA,EAoKA,KApKA,CAAA;EAAM,MACN,CAAA,EAAA,EAuLI,eAvLJ,CAuLoB,MAvLpB,EAuL4B,SAvL5B,EAuLuC,OAvLvC,EAuLgD,SAvLhD,EAuL2D,SAvL3D,CAAA,CAAA,EAwLE,IAxLF,CAyLA,MAzLA,EA0LA,SA1LA,EA2LA,OA3LA,EA4LA,SA5LA,EA6LA,eA7LA,EA8LA,0BA9LA,EA+LA,SA/LA,EAgMA,oBAhMA,CAAA;;;;;cCtCW,GAAC,YAAA,0BAAA,WAAA"}
1
+ {"version":3,"file":"index.d.mts","names":[],"sources":["../../src/crons/CronBuilder.ts","../../src/crons/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;cAYa,2BACG,8CACG,6BACF,WAAS,4BACP,kEACM,8KAIf,gBACT,QACA,WACA,WACA,SACA,iBACA,+CAGA,WACA;;EAnBY,QAAA,OAAW;EAAA,WAAA,CAAA;EAAA,UACR,CAAA,UAAA,EAAA,MAAA,CAAA,EAAA,IAAA;EAAwB;;;;EAGL,QACV,CAAA,gBAAA,MAAA,CAAA,CAAA,WAAA,EAgCV,cAhCU,CAgCK,CAhCL,CAAA,CAAA,EAiCrB,WAjCqB,CAkCvB,MAlCuB,EAmCvB,SAnCuB,EAoCvB,OApCuB,EAqCvB,SArCuB,EAsCvB,eAtCuB,EAuCvB,0BAvCuB,EAwCvB,SAxCuB,EAyCvB,oBAzCuB,CAAA;EAAc;;;;;;;;EAclB,MAkBS,CAAA,OAAA,EAwBb,cAxBa,CAAA,EAAA,IAAA;EAAC,KAAhB,CAAA,UA4BW,0BA5BX,CAAA,CAAA,MAAA,EA6BL,CA7BK,CAAA,EA8BX,WA9BW,CA+Bb,CA/Ba,EAgCb,SAhCa,EAiCb,OAjCa,EAkCb,SAlCa,EAmCb,eAnCa,EAoCb,0BApCa,EAqCb,SArCa,EAsCb,oBAtCa,CAAA;EAAc,MAE3B,CAAA,UAoDyB,gBApDzB,CAAA,CAAA,MAAA,EAqDQ,CArDR,CAAA,EAsDE,WAtDF,CAuDA,MAvDA,EAwDA,SAxDA,EAyDA,OAzDA,EA0DA,CA1DA,EA2DA,eA3DA,EA4DA,0BA5DA,EA6DA,SA7DA,EA8DA,oBA9DA,CAAA;EAAM,QACN,CAAA,UA6E2B,SA7E3B,EAAA,CAAA,CAAA,QAAA,EA8EU,CA9EV,CAAA,EA+EE,WA/EF,CAgFA,MAhFA,EAAA,CACA,GAgFI,SAhFJ,EACA,GA+EkB,CA/ElB,CAAS,EAgFT,OA/EA,EAgFA,SAhFA,EAiFA,eAjFA,EAkFA,0BAlFA,EAmFA,SAnFA,EAoFA,oBApFA,CAAA;EAAe,MACf,CAAA,UAsGyB,QAtGzB,CAAA,CAAA,MAAA,EAuGQ,CAvGR,CAAA,EAwGE,WAxGF,CAyGA,MAzGA,EA0GA,SA1GA,EA2GA,CA3GA,EA4GA,SA5GA,EA6GA,eA7GA,EA8GA,0BA9GA,EA+GA,SA/GA,EAgHA,oBAhHA,CAAA;EAA0B,SAC1B,CAAA,UA+H4B,cA/H5B,CAAA,GAAA,CAAA,EAAA,cAAA,MAAA,CAAA,CAAA,SAAA,EAgIW,SAhIX,CAgImB,KAhInB,EAgI0B,CAhI1B,CAAA,CAAA,EAiIE,WAjIF,CAkIA,MAlIA,EAmIA,SAnIA,EAoIA,OApIA,EAqIA,SArIA,EAsIA,CAtIA,EAuIA,KAvIA,EAwIA,SAxIA,EAyIA,oBAzIA,CAAA;EAAS;;;;EAoBuC,QACxC,CAAA,CAAA,EAAA,cAAA,MAAA,CAAA,CAAA,OAAA,EA4IC,SA5ID,CA4IS,KA5IT,EA4IgB,CA5IhB,CAAA,CAAA,EA6IN,WA7IM,CA8IR,MA9IQ,EA+IR,SA/IQ,EAgJR,OAhJQ,EAiJR,SAjJQ,EAkJR,eAlJQ,EAmJR,0BAnJQ,EAoJR,CApJQ,EAqJR,KArJQ,CAAA;EAAC,MAET,CAAA,EAAA,EAuKI,eAvKJ,CAuKoB,MAvKpB,EAuK4B,SAvK5B,EAuKuC,OAvKvC,EAuKgD,SAvKhD,EAuK2D,SAvK3D,CAAA,CAAA,EAwKE,IAxKF,CAyKA,MAzKA,EA0KA,SA1KA,EA2KA,OA3KA,EA4KA,SA5KA,EA6KA,eA7KA,EA8KA,0BA9KA,EA+KA,SA/KA,EAgLA,oBAhLA,CAAA;;;;;cCpEW,GAAC,YAAA,0BAAA,WAAA"}