@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":"index.cjs","names":["DEFAULT_LOGGER","ConsoleLogger","Construct","obj: unknown","ConstructType","name: TName","handler: QueueHandler<TMessage, TServices, TLogger>","messageSchema: TMessage","timeout: number","services: TServices","logger: TLogger","batchSize?: number","fifo?: boolean","DEFAULT_LOGGER","name: T","timeout: number","batchSize: number","services: T","logger: T","schema: T","fn: QueueHandler<NonNullable<TMessage>, TServices, TLogger>"],"sources":["../../src/queue/Queue.ts","../../src/queue/QueueBuilder.ts","../../src/queue/index.ts"],"sourcesContent":["import { environmentCase } from '@geekmidas/envkit';\nimport {\n\ttype EventPublisher,\n\ttype EventPublisherConnectionString,\n\ttype PublishableMessage,\n\tPublisher,\n} from '@geekmidas/events';\nimport type { Logger } from '@geekmidas/logger';\nimport { ConsoleLogger } from '@geekmidas/logger/console';\nimport type { InferStandardSchema } from '@geekmidas/schema';\nimport type { Service, ServiceRecord } from '@geekmidas/services';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport { Construct, ConstructType } from '../Construct';\n\nconst DEFAULT_LOGGER = new ConsoleLogger() as unknown as Logger;\n\n/**\n * The wire message a queue carries: `{ type: <queue name>, payload: <message> }`.\n * The producer publishes this shape and the worker receives the `payload`s as\n * its `messages`. Typing `type` to the queue name keeps the publisher fully\n * typed and lets pg-boss (local) / SQS (deployed) route by name.\n */\nexport type QueueMessage<\n\tTName extends string,\n\tTMessage extends StandardSchemaV1,\n> = PublishableMessage<TName, InferStandardSchema<TMessage>>;\n\n/**\n * A queue worker — a point-to-point SQS-style queue and its single consumer.\n * Unlike a `Subscriber` (topic fan-out, filtered by `subscribedEvents`), a queue\n * drains every message of its one `message` type. Build one with `q` (see\n * `QueueBuilder`); `gkm build` discovers it into the manifest's `queues` field.\n *\n * The producer side is {@link Queue.publisher} — a ready-to-inject `Service`\n * that any endpoint/function drops into `.services([...])` to send messages.\n */\nexport class Queue<\n\tTName extends string = string,\n\tTMessage extends StandardSchemaV1 = StandardSchemaV1,\n\tTServices extends Service[] = [],\n\tTLogger extends Logger = Logger,\n> extends Construct<TLogger, string, undefined, undefined, TServices> {\n\t__IS_QUEUE__ = true;\n\n\tstatic isQueue(\n\t\tobj: unknown,\n\t): obj is Queue<string, StandardSchemaV1, Service[], Logger> {\n\t\treturn Boolean(\n\t\t\tobj &&\n\t\t\t\t(obj as { __IS_QUEUE__?: boolean }).__IS_QUEUE__ === true &&\n\t\t\t\t(obj as Construct).type === ConstructType.Queue,\n\t\t);\n\t}\n\n\tconstructor(\n\t\tpublic readonly name: TName,\n\t\tpublic readonly handler: QueueHandler<TMessage, TServices, TLogger>,\n\t\tpublic readonly messageSchema: TMessage,\n\t\tpublic override readonly timeout: number = 30000,\n\t\tpublic override readonly services: TServices = [] as unknown as TServices,\n\t\tpublic override readonly logger: TLogger = DEFAULT_LOGGER as TLogger,\n\t\t/** SQS event-source batch size (deployed). */\n\t\tpublic readonly batchSize?: number,\n\t\t/** Whether the queue is FIFO (deployed). */\n\t\tpublic readonly fifo?: boolean,\n\t) {\n\t\tsuper(\n\t\t\tConstructType.Queue,\n\t\t\tlogger,\n\t\t\tservices,\n\t\t\t[],\n\t\t\tundefined,\n\t\t\tundefined,\n\t\t\ttimeout,\n\t\t);\n\t}\n\n\t/**\n\t * The producer side — a `Service` exposing an `EventPublisher` typed to this\n\t * queue's message. Inject it via `.services([queue.publisher])`; the handler\n\t * then calls `services.<name>Publisher.publish([{ type, payload }])`.\n\t *\n\t * It reads `<NAME>_PUBLISHER_CONNECTION_STRING` and builds the transport from\n\t * the URL protocol — `pgboss://` locally, `sqs://` deployed — so the same\n\t * code publishes to Postgres in dev and SQS in prod. Because it's a `Service`,\n\t * `Construct.getEnvironment()` sniffs it, so the env requirement flows into\n\t * the manifest and infra links exactly this queue with least privilege.\n\t */\n\tget publisher(): Service<\n\t\t`${TName}Publisher`,\n\t\tEventPublisher<QueueMessage<TName, TMessage>>\n\t> {\n\t\tconst envVar = `${environmentCase(this.name)}_PUBLISHER_CONNECTION_STRING`;\n\t\treturn {\n\t\t\tserviceName: `${this.name}Publisher`,\n\t\t\tasync register({ envParser }) {\n\t\t\t\tconst { connectionString } = envParser\n\t\t\t\t\t.create((get) => ({\n\t\t\t\t\t\tconnectionString: get(envVar).string(),\n\t\t\t\t\t}))\n\t\t\t\t\t.parse();\n\n\t\t\t\treturn Publisher.fromConnectionString<QueueMessage<TName, TMessage>>(\n\t\t\t\t\tconnectionString as EventPublisherConnectionString,\n\t\t\t\t);\n\t\t\t},\n\t\t};\n\t}\n}\n\n/** The context a queue handler receives — a batch of typed messages. */\nexport type QueueContext<\n\tTMessage extends StandardSchemaV1,\n\tTServices extends Service[] = [],\n\tTLogger extends Logger = Logger,\n> = {\n\tmessages: InferStandardSchema<TMessage>[];\n\tservices: ServiceRecord<TServices>;\n\tlogger: TLogger;\n};\n\nexport type QueueHandler<\n\tTMessage extends StandardSchemaV1,\n\tTServices extends Service[] = [],\n\tTLogger extends Logger = Logger,\n> = (\n\tctx: QueueContext<TMessage, TServices, TLogger>,\n) => unknown | Promise<unknown>;\n","import type { Logger } from '@geekmidas/logger';\nimport { DEFAULT_LOGGER } from '@geekmidas/logger/console';\nimport type { Service } from '@geekmidas/services';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport { cloneWith } from '../clone';\nimport { Queue, type QueueHandler } from './Queue';\n\n/**\n * Builds a {@link Queue} worker — `q.queue('orders').services([db]).message(schema).handle(fn)`.\n * Services are an array (sniffed for required env vars); `message` is the typed\n * job payload; `handle` is the single consumer. The queue name is captured as a\n * literal so `queue.publisher` is typed to `{ type: '<name>', payload }`.\n */\nexport class QueueBuilder<\n\tTName extends string = string,\n\tTMessage extends StandardSchemaV1 | undefined = undefined,\n\tTServices extends Service[] = [],\n\tTLogger extends Logger = Logger,\n> {\n\tprivate _name?: string;\n\tprivate _messageSchema?: TMessage;\n\tprivate _timeout = 30000;\n\tprivate _batchSize?: number;\n\tprivate _fifo?: boolean;\n\tprivate _services: TServices = [] as Service[] as TServices;\n\tprivate _logger: TLogger = DEFAULT_LOGGER as TLogger;\n\n\t/** The queue name — drives the infra queue and its `<NAME>_*` env vars. */\n\tqueue<T extends string>(\n\t\tname: T,\n\t): QueueBuilder<T, TMessage, TServices, TLogger> {\n\t\treturn cloneWith(this, { _name: name }) as unknown as QueueBuilder<\n\t\t\tT,\n\t\t\tTMessage,\n\t\t\tTServices,\n\t\t\tTLogger\n\t\t>;\n\t}\n\n\ttimeout(timeout: number): this {\n\t\treturn cloneWith(this, { _timeout: timeout });\n\t}\n\n\t/** SQS event-source batch size (deployed). */\n\tbatchSize(batchSize: number): this {\n\t\treturn cloneWith(this, { _batchSize: batchSize });\n\t}\n\n\t/** Mark the queue as FIFO (deployed). */\n\tfifo(fifo = true): this {\n\t\treturn cloneWith(this, { _fifo: fifo });\n\t}\n\n\tservices<T extends Service[]>(\n\t\tservices: T,\n\t): QueueBuilder<TName, TMessage, [...TServices, ...T], TLogger> {\n\t\treturn cloneWith(this, {\n\t\t\t_services: [...this._services, ...services] as unknown as TServices,\n\t\t}) as unknown as QueueBuilder<\n\t\t\tTName,\n\t\t\tTMessage,\n\t\t\t[...TServices, ...T],\n\t\t\tTLogger\n\t\t>;\n\t}\n\n\tlogger<T extends Logger>(\n\t\tlogger: T,\n\t): QueueBuilder<TName, TMessage, TServices, T> {\n\t\treturn cloneWith(this, {\n\t\t\t_logger: logger as unknown as TLogger,\n\t\t}) as unknown as QueueBuilder<TName, TMessage, TServices, T>;\n\t}\n\n\t/** The typed message (job) payload the queue carries. */\n\tmessage<T extends StandardSchemaV1>(\n\t\tschema: T,\n\t): QueueBuilder<TName, T, TServices, TLogger> {\n\t\treturn cloneWith(this, {\n\t\t\t_messageSchema: schema as unknown as TMessage,\n\t\t}) as unknown as QueueBuilder<TName, T, TServices, TLogger>;\n\t}\n\n\thandle(\n\t\tfn: QueueHandler<NonNullable<TMessage>, TServices, TLogger>,\n\t): Queue<TName, NonNullable<TMessage>, TServices, TLogger> {\n\t\tif (!this._name) {\n\t\t\tthrow new Error(\n\t\t\t\t'Queue requires a name — call .queue(name) before .handle().',\n\t\t\t);\n\t\t}\n\t\tif (!this._messageSchema) {\n\t\t\tthrow new Error(\n\t\t\t\t'Queue requires a message schema — call .message(schema) before .handle().',\n\t\t\t);\n\t\t}\n\n\t\tconst queue = new Queue<TName, NonNullable<TMessage>, TServices, TLogger>(\n\t\t\tthis._name as TName,\n\t\t\tfn,\n\t\t\tthis._messageSchema as NonNullable<TMessage>,\n\t\t\tthis._timeout,\n\t\t\tthis._services,\n\t\t\tthis._logger,\n\t\t\tthis._batchSize,\n\t\t\tthis._fifo,\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\treturn queue;\n\t}\n}\n","export {\n\tQueue,\n\ttype QueueContext,\n\ttype QueueHandler,\n\ttype QueueMessage,\n} from './Queue';\n\nimport { QueueBuilder } from './QueueBuilder';\n\nexport { QueueBuilder } from './QueueBuilder';\n\nexport const q = new QueueBuilder();\n"],"mappings":";;;;;;;AAcA,MAAMA,mBAAiB,IAAIC;;;;;;;;;;AAsB3B,IAAa,QAAb,cAKUC,4BAA4D;CACrE,eAAe;CAEf,OAAO,QACNC,KAC4D;AAC5D,SAAO,QACN,OACE,IAAmC,iBAAiB,QACpD,IAAkB,SAASC,gCAAc,MAC3C;CACD;CAED,YACiBC,MACAC,SACAC,eACSC,UAAkB,KAClBC,WAAsB,CAAE,GACxBC,SAAkBV,kBAE3BW,WAEAC,MACf;AACD,QACCR,gCAAc,OACd,QACA,UACA,CAAE,mBAGF,QACA;EAnBe;EACA;EACA;EACS;EACA;EACA;EAET;EAEA;CAWhB;;;;;;;;;;;;CAaD,IAAI,YAGF;EACD,MAAM,UAAU,EAAE,wCAAgB,KAAK,KAAK,CAAC;AAC7C,SAAO;GACN,cAAc,EAAE,KAAK,KAAK;GAC1B,MAAM,SAAS,EAAE,WAAW,EAAE;IAC7B,MAAM,EAAE,kBAAkB,GAAG,UAC3B,OAAO,CAAC,SAAS,EACjB,kBAAkB,IAAI,OAAO,CAAC,QAAQ,CACtC,GAAE,CACF,OAAO;AAET,WAAO,6BAAU,qBAChB,iBACA;GACD;EACD;CACD;AACD;;;;;;;;;;AC/FD,IAAa,eAAb,MAKE;CACD,AAAQ;CACR,AAAQ;CACR,AAAQ,WAAW;CACnB,AAAQ;CACR,AAAQ;CACR,AAAQ,YAAuB,CAAE;CACjC,AAAQ,UAAmBS;;CAG3B,MACCC,MACgD;AAChD,SAAO,wBAAU,MAAM,EAAE,OAAO,KAAM,EAAC;CAMvC;CAED,QAAQC,SAAuB;AAC9B,SAAO,wBAAU,MAAM,EAAE,UAAU,QAAS,EAAC;CAC7C;;CAGD,UAAUC,WAAyB;AAClC,SAAO,wBAAU,MAAM,EAAE,YAAY,UAAW,EAAC;CACjD;;CAGD,KAAK,OAAO,MAAY;AACvB,SAAO,wBAAU,MAAM,EAAE,OAAO,KAAM,EAAC;CACvC;CAED,SACCC,UAC+D;AAC/D,SAAO,wBAAU,MAAM,EACtB,WAAW,CAAC,GAAG,KAAK,WAAW,GAAG,QAAS,EAC3C,EAAC;CAMF;CAED,OACCC,QAC8C;AAC9C,SAAO,wBAAU,MAAM,EACtB,SAAS,OACT,EAAC;CACF;;CAGD,QACCC,QAC6C;AAC7C,SAAO,wBAAU,MAAM,EACtB,gBAAgB,OAChB,EAAC;CACF;CAED,OACCC,IAC0D;AAC1D,OAAK,KAAK,MACT,OAAM,IAAI,MACT;AAGF,OAAK,KAAK,eACT,OAAM,IAAI,MACT;EAIF,MAAM,QAAQ,IAAI,MACjB,KAAK,OACL,IACA,KAAK,gBACL,KAAK,UACL,KAAK,WACL,KAAK,SACL,KAAK,YACL,KAAK;AAON,SAAO;CACP;AACD;;;;ACvGD,MAAa,IAAI,IAAI"}
1
+ {"version":3,"file":"index.cjs","names":["DEFAULT_LOGGER","name: T","timeout: number","batchSize: number","services: T","logger: T","schema: T","fn: QueueHandler<NonNullable<TMessage>, TServices, TLogger>","Queue"],"sources":["../../src/queue/QueueBuilder.ts","../../src/queue/index.ts"],"sourcesContent":["import type { Logger } from '@geekmidas/logger';\nimport { DEFAULT_LOGGER } from '@geekmidas/logger/console';\nimport type { Service } from '@geekmidas/services';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport { cloneWith } from '../clone';\nimport { Queue, type QueueHandler } from './Queue';\n\n/**\n * Builds a {@link Queue} worker — `q.queue('orders').services([db]).message(schema).handle(fn)`.\n * Services are an array (sniffed for required env vars); `message` is the typed\n * job payload; `handle` is the single consumer. The queue name is captured as a\n * literal so `queue.publisher` is typed to `{ type: '<name>', payload }`.\n */\nexport class QueueBuilder<\n\tTName extends string = string,\n\tTMessage extends StandardSchemaV1 | undefined = undefined,\n\tTServices extends Service[] = [],\n\tTLogger extends Logger = Logger,\n> {\n\tprivate _name?: string;\n\tprivate _messageSchema?: TMessage;\n\tprivate _timeout = 30000;\n\tprivate _batchSize?: number;\n\tprivate _fifo?: boolean;\n\tprivate _services: TServices = [] as Service[] as TServices;\n\tprivate _logger: TLogger = DEFAULT_LOGGER as TLogger;\n\n\t/** The queue name — drives the infra queue and its `<NAME>_*` env vars. */\n\tqueue<T extends string>(\n\t\tname: T,\n\t): QueueBuilder<T, TMessage, TServices, TLogger> {\n\t\treturn cloneWith(this, { _name: name }) as unknown as QueueBuilder<\n\t\t\tT,\n\t\t\tTMessage,\n\t\t\tTServices,\n\t\t\tTLogger\n\t\t>;\n\t}\n\n\ttimeout(timeout: number): this {\n\t\treturn cloneWith(this, { _timeout: timeout });\n\t}\n\n\t/** SQS event-source batch size (deployed). */\n\tbatchSize(batchSize: number): this {\n\t\treturn cloneWith(this, { _batchSize: batchSize });\n\t}\n\n\t/** Mark the queue as FIFO (deployed). */\n\tfifo(fifo = true): this {\n\t\treturn cloneWith(this, { _fifo: fifo });\n\t}\n\n\tservices<T extends Service[]>(\n\t\tservices: T,\n\t): QueueBuilder<TName, TMessage, [...TServices, ...T], TLogger> {\n\t\treturn cloneWith(this, {\n\t\t\t_services: [...this._services, ...services] as unknown as TServices,\n\t\t}) as unknown as QueueBuilder<\n\t\t\tTName,\n\t\t\tTMessage,\n\t\t\t[...TServices, ...T],\n\t\t\tTLogger\n\t\t>;\n\t}\n\n\tlogger<T extends Logger>(\n\t\tlogger: T,\n\t): QueueBuilder<TName, TMessage, TServices, T> {\n\t\treturn cloneWith(this, {\n\t\t\t_logger: logger as unknown as TLogger,\n\t\t}) as unknown as QueueBuilder<TName, TMessage, TServices, T>;\n\t}\n\n\t/** The typed message (job) payload the queue carries. */\n\tmessage<T extends StandardSchemaV1>(\n\t\tschema: T,\n\t): QueueBuilder<TName, T, TServices, TLogger> {\n\t\treturn cloneWith(this, {\n\t\t\t_messageSchema: schema as unknown as TMessage,\n\t\t}) as unknown as QueueBuilder<TName, T, TServices, TLogger>;\n\t}\n\n\thandle(\n\t\tfn: QueueHandler<NonNullable<TMessage>, TServices, TLogger>,\n\t): Queue<TName, NonNullable<TMessage>, TServices, TLogger> {\n\t\tif (!this._name) {\n\t\t\tthrow new Error(\n\t\t\t\t'Queue requires a name — call .queue(name) before .handle().',\n\t\t\t);\n\t\t}\n\t\tif (!this._messageSchema) {\n\t\t\tthrow new Error(\n\t\t\t\t'Queue requires a message schema — call .message(schema) before .handle().',\n\t\t\t);\n\t\t}\n\n\t\tconst queue = new Queue<TName, NonNullable<TMessage>, TServices, TLogger>(\n\t\t\tthis._name as TName,\n\t\t\tfn,\n\t\t\tthis._messageSchema as NonNullable<TMessage>,\n\t\t\tthis._timeout,\n\t\t\tthis._services,\n\t\t\tthis._logger,\n\t\t\tthis._batchSize,\n\t\t\tthis._fifo,\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\treturn queue;\n\t}\n}\n","export {\n\tisQueueResult,\n\tQueue,\n\ttype QueueContext,\n\ttype QueueHandler,\n\ttype QueueMessage,\n\ttype QueueRecord,\n\ttype QueueResult,\n} from './Queue';\n\nimport { QueueBuilder } from './QueueBuilder';\n\nexport { QueueBuilder } from './QueueBuilder';\n\nexport const q = new QueueBuilder();\n"],"mappings":";;;;;;;;;;;;AAaA,IAAa,eAAb,MAKE;CACD,AAAQ;CACR,AAAQ;CACR,AAAQ,WAAW;CACnB,AAAQ;CACR,AAAQ;CACR,AAAQ,YAAuB,CAAE;CACjC,AAAQ,UAAmBA;;CAG3B,MACCC,MACgD;AAChD,SAAO,wBAAU,MAAM,EAAE,OAAO,KAAM,EAAC;CAMvC;CAED,QAAQC,SAAuB;AAC9B,SAAO,wBAAU,MAAM,EAAE,UAAU,QAAS,EAAC;CAC7C;;CAGD,UAAUC,WAAyB;AAClC,SAAO,wBAAU,MAAM,EAAE,YAAY,UAAW,EAAC;CACjD;;CAGD,KAAK,OAAO,MAAY;AACvB,SAAO,wBAAU,MAAM,EAAE,OAAO,KAAM,EAAC;CACvC;CAED,SACCC,UAC+D;AAC/D,SAAO,wBAAU,MAAM,EACtB,WAAW,CAAC,GAAG,KAAK,WAAW,GAAG,QAAS,EAC3C,EAAC;CAMF;CAED,OACCC,QAC8C;AAC9C,SAAO,wBAAU,MAAM,EACtB,SAAS,OACT,EAAC;CACF;;CAGD,QACCC,QAC6C;AAC7C,SAAO,wBAAU,MAAM,EACtB,gBAAgB,OAChB,EAAC;CACF;CAED,OACCC,IAC0D;AAC1D,OAAK,KAAK,MACT,OAAM,IAAI,MACT;AAGF,OAAK,KAAK,eACT,OAAM,IAAI,MACT;EAIF,MAAM,QAAQ,IAAIC,oBACjB,KAAK,OACL,IACA,KAAK,gBACL,KAAK,UACL,KAAK,WACL,KAAK,SACL,KAAK,YACL,KAAK;AAON,SAAO;CACP;AACD;;;;ACpGD,MAAa,IAAI,IAAI"}
@@ -1,5 +1,5 @@
1
- import "../Construct-D_3yZ9m5.cjs";
2
- import { Queue, QueueContext, QueueHandler, QueueMessage } from "../Queue-Brw--scg.cjs";
1
+ import "../Construct-BEh2DSMe.cjs";
2
+ import { Queue, QueueContext, QueueHandler, QueueMessage, QueueRecord, QueueResult, isQueueResult } from "../Queue-XQNGO6_-.cjs";
3
3
  import * as _geekmidas_logger8 from "@geekmidas/logger";
4
4
  import { Logger } from "@geekmidas/logger";
5
5
  import { Service } from "@geekmidas/services";
@@ -41,5 +41,5 @@ declare const q: QueueBuilder<string, undefined, [], _geekmidas_logger8.Logger>;
41
41
  //# sourceMappingURL=index.d.ts.map
42
42
 
43
43
  //#endregion
44
- export { Queue, QueueBuilder, QueueContext, QueueHandler, QueueMessage, q };
44
+ export { Queue, QueueBuilder, QueueContext, QueueHandler, QueueMessage, QueueRecord, QueueResult, isQueueResult, q };
45
45
  //# sourceMappingURL=index.d.cts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.cts","names":[],"sources":["../../src/queue/QueueBuilder.ts","../../src/queue/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;AAaA;;AAEkB,cAFL,YAEK,CAAA,cAAA,MAAA,GAAA,MAAA,EAAA,iBAAA,gBAAA,GAAA,SAAA,GAAA,SAAA,EAAA,kBACC,OADD,EAAA,GAAA,EAAA,EAAA,gBAED,MAFC,GAEQ,MAFR,CAAA,CAAA;EAAgB,QACf,KAAA;EAAO,QACT,cAAA;EAAM,QAAG,QAAA;EAAM,QAYxB,UAAA;EAAC,QACQ,KAAA;EAAC,QAAE,SAAA;EAAQ,QAAE,OAAA;EAAS;EAAS,KAA5C,CAAA,UAAA,MAAA,CAAA,CAAA,IAAA,EADI,CACJ,CAAA,EAAA,YAAA,CAAa,CAAb,EAAgB,QAAhB,EAA0B,SAA1B,EAAqC,OAArC,CAAA;EAAY,OAuBI,CAAA,OAAA,EAAA,MAAA,CAAA,EAAA,IAAA;EAAO;EACd,SACI,CAAA,SAAA,EAAA,MAAA,CAAA,EAAA,IAAA;EAAK;EAAU,IAAM,CAAA,IAAA,CAAA,EAAA,OAAA,CAAA,EAAA,IAAA;EAAS,QAAK,CAAA,UAFhC,OAEgC,EAAA,CAAA,CAAA,QAAA,EADxC,CACwC,CAAA,EAAhD,YAAgD,CAAnC,KAAmC,EAA5B,QAA4B,EAAA,CAAA,GAAd,SAAc,EAAA,GAAA,CAAA,CAAA,EAAI,OAAJ,CAAA;EAAC,MAAG,CAAA,UAWtC,MAXsC,CAAA,CAAA,MAAA,EAY9C,CAZ8C,CAAA,EAapD,YAboD,CAavC,KAbuC,EAahC,QAbgC,EAatB,SAbsB,EAaX,CAbW,CAAA;EAAO;EAA/C,OAWE,CAAA,UASC,gBATD,CAAA,CAAA,MAAA,EAUR,CAVQ,CAAA,EAWd,YAXc,CAWD,KAXC,EAWM,CAXN,EAWS,SAXT,EAWoB,OAXpB,CAAA;EAAM,MACd,CAAA,EAAA,EAiBJ,YAjBI,CAiBS,WAjBT,CAiBqB,QAjBrB,CAAA,EAiBgC,SAjBhC,EAiB2C,OAjB3C,CAAA,CAAA,EAkBN,KAlBM,CAkBA,KAlBA,EAkBO,WAlBP,CAkBmB,QAlBnB,CAAA,EAkB8B,SAlB9B,EAkByC,OAlBzC,CAAA;;;;;cCxDG,GAAC,oCAAqB,kBAAA,CAArB,MAAA"}
1
+ {"version":3,"file":"index.d.cts","names":[],"sources":["../../src/queue/QueueBuilder.ts","../../src/queue/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;AAaA;;AAEkB,cAFL,YAEK,CAAA,cAAA,MAAA,GAAA,MAAA,EAAA,iBAAA,gBAAA,GAAA,SAAA,GAAA,SAAA,EAAA,kBACC,OADD,EAAA,GAAA,EAAA,EAAA,gBAED,MAFC,GAEQ,MAFR,CAAA,CAAA;EAAgB,QACf,KAAA;EAAO,QACT,cAAA;EAAM,QAAG,QAAA;EAAM,QAYxB,UAAA;EAAC,QACQ,KAAA;EAAC,QAAE,SAAA;EAAQ,QAAE,OAAA;EAAS;EAAS,KAA5C,CAAA,UAAA,MAAA,CAAA,CAAA,IAAA,EADI,CACJ,CAAA,EAAA,YAAA,CAAa,CAAb,EAAgB,QAAhB,EAA0B,SAA1B,EAAqC,OAArC,CAAA;EAAY,OAuBI,CAAA,OAAA,EAAA,MAAA,CAAA,EAAA,IAAA;EAAO;EACd,SACI,CAAA,SAAA,EAAA,MAAA,CAAA,EAAA,IAAA;EAAK;EAAU,IAAM,CAAA,IAAA,CAAA,EAAA,OAAA,CAAA,EAAA,IAAA;EAAS,QAAK,CAAA,UAFhC,OAEgC,EAAA,CAAA,CAAA,QAAA,EADxC,CACwC,CAAA,EAAhD,YAAgD,CAAnC,KAAmC,EAA5B,QAA4B,EAAA,CAAA,GAAd,SAAc,EAAA,GAAA,CAAA,CAAA,EAAI,OAAJ,CAAA;EAAC,MAAG,CAAA,UAWtC,MAXsC,CAAA,CAAA,MAAA,EAY9C,CAZ8C,CAAA,EAapD,YAboD,CAavC,KAbuC,EAahC,QAbgC,EAatB,SAbsB,EAaX,CAbW,CAAA;EAAO;EAA/C,OAWE,CAAA,UASC,gBATD,CAAA,CAAA,MAAA,EAUR,CAVQ,CAAA,EAWd,YAXc,CAWD,KAXC,EAWM,CAXN,EAWS,SAXT,EAWoB,OAXpB,CAAA;EAAM,MACd,CAAA,EAAA,EAiBJ,YAjBI,CAiBS,WAjBT,CAiBqB,QAjBrB,CAAA,EAiBgC,SAjBhC,EAiB2C,OAjB3C,CAAA,CAAA,EAkBN,KAlBM,CAkBA,KAlBA,EAkBO,WAlBP,CAkBmB,QAlBnB,CAAA,EAkB8B,SAlB9B,EAkByC,OAlBzC,CAAA;;;;;cCrDG,GAAC,oCAAqB,kBAAA,CAArB,MAAA"}
@@ -1,5 +1,5 @@
1
- import "../Construct-DsqpiAym.mjs";
2
- import { Queue, QueueContext, QueueHandler, QueueMessage } from "../Queue-D5z1bwFu.mjs";
1
+ import "../Construct-qnOnQTcP.mjs";
2
+ import { Queue, QueueContext, QueueHandler, QueueMessage, QueueRecord, QueueResult, isQueueResult } from "../Queue-I5NfFV0V.mjs";
3
3
  import { Service } from "@geekmidas/services";
4
4
  import { Logger as Logger$1 } from "@geekmidas/logger";
5
5
  import { StandardSchemaV1 } from "@standard-schema/spec";
@@ -40,5 +40,5 @@ declare const q: QueueBuilder<string, undefined, [], Logger>;
40
40
  //# sourceMappingURL=index.d.ts.map
41
41
 
42
42
  //#endregion
43
- export { Queue, QueueBuilder, QueueContext, QueueHandler, QueueMessage, q };
43
+ export { Queue, QueueBuilder, QueueContext, QueueHandler, QueueMessage, QueueRecord, QueueResult, isQueueResult, q };
44
44
  //# sourceMappingURL=index.d.mts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.mts","names":[],"sources":["../../src/queue/QueueBuilder.ts","../../src/queue/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;AAaA;;;AAGmB,cAHN,YAGM,CAAA,cAAA,MAAA,GAAA,MAAA,EAAA,iBADD,gBACC,GAAA,SAAA,GAAA,SAAA,EAAA,kBAAA,OAAA,EAAA,GAAA,EAAA,EAAA,gBACF,QADE,GACO,QADP,CAAA,CAAA;EAAO,QACT,KAAA;EAAM,QAAG,cAAA;EAAM,QAYxB,QAAA;EAAC,QACQ,UAAA;EAAC,QAAE,KAAA;EAAQ,QAAE,SAAA;EAAS,QAAE,OAAA;EAAO;EAAhC,KAuBI,CAAA,UAAA,MAAA,CAAA,CAAA,IAAA,EAxBZ,CAwBY,CAAA,EAvBhB,YAuBgB,CAvBH,CAuBG,EAvBA,QAuBA,EAvBU,SAuBV,EAvBqB,OAuBrB,CAAA;EAAO,OACf,CAAA,OAAA,EAAA,MAAA,CAAA,EAAA,IAAA;EAAC;EACS,SAAE,CAAA,SAAA,EAAA,MAAA,CAAA,EAAA,IAAA;EAAQ;EAAe,IAAK,CAAA,IAAA,CAAA,EAAA,OAAA,CAAA,EAAA,IAAA;EAAC,QAAG,CAAA,UAFpC,OAEoC,EAAA,CAAA,CAAA,QAAA,EAD5C,CAC4C,CAAA,EAApD,YAAoD,CAAvC,KAAuC,EAAhC,QAAgC,EAAA,CAAA,GAAlB,SAAkB,EAAA,GAAJ,CAAI,CAAA,EAAA,OAAA,CAAA;EAAO,MAA3D,CAAA,UAWc,QAXd,CAAA,CAAA,MAAA,EAYM,CAZN,CAAA,EAaA,YAbA,CAaa,KAbb,EAaoB,QAbpB,EAa8B,SAb9B,EAayC,CAbzC,CAAA;EAAY;EAWQ,OACd,CAAA,UAQS,gBART,CAAA,CAAA,MAAA,EASA,CATA,CAAA,EAUN,YAVM,CAUO,KAVP,EAUc,CAVd,EAUiB,SAVjB,EAU4B,OAV5B,CAAA;EAAC,MACM,CAAA,EAAA,EAgBX,YAhBW,CAgBE,WAhBF,CAgBc,QAhBd,CAAA,EAgByB,SAhBzB,EAgBoC,OAhBpC,CAAA,CAAA,EAiBb,KAjBa,CAiBP,KAjBO,EAiBA,WAjBA,CAiBY,QAjBZ,CAAA,EAiBuB,SAjBvB,EAiBkC,OAjBlC,CAAA;;;;;cCzDJ,GAAC,oCAAA"}
1
+ {"version":3,"file":"index.d.mts","names":[],"sources":["../../src/queue/QueueBuilder.ts","../../src/queue/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;AAaA;;;AAGmB,cAHN,YAGM,CAAA,cAAA,MAAA,GAAA,MAAA,EAAA,iBADD,gBACC,GAAA,SAAA,GAAA,SAAA,EAAA,kBAAA,OAAA,EAAA,GAAA,EAAA,EAAA,gBACF,QADE,GACO,QADP,CAAA,CAAA;EAAO,QACT,KAAA;EAAM,QAAG,cAAA;EAAM,QAYxB,QAAA;EAAC,QACQ,UAAA;EAAC,QAAE,KAAA;EAAQ,QAAE,SAAA;EAAS,QAAE,OAAA;EAAO;EAAhC,KAuBI,CAAA,UAAA,MAAA,CAAA,CAAA,IAAA,EAxBZ,CAwBY,CAAA,EAvBhB,YAuBgB,CAvBH,CAuBG,EAvBA,QAuBA,EAvBU,SAuBV,EAvBqB,OAuBrB,CAAA;EAAO,OACf,CAAA,OAAA,EAAA,MAAA,CAAA,EAAA,IAAA;EAAC;EACS,SAAE,CAAA,SAAA,EAAA,MAAA,CAAA,EAAA,IAAA;EAAQ;EAAe,IAAK,CAAA,IAAA,CAAA,EAAA,OAAA,CAAA,EAAA,IAAA;EAAC,QAAG,CAAA,UAFpC,OAEoC,EAAA,CAAA,CAAA,QAAA,EAD5C,CAC4C,CAAA,EAApD,YAAoD,CAAvC,KAAuC,EAAhC,QAAgC,EAAA,CAAA,GAAlB,SAAkB,EAAA,GAAJ,CAAI,CAAA,EAAA,OAAA,CAAA;EAAO,MAA3D,CAAA,UAWc,QAXd,CAAA,CAAA,MAAA,EAYM,CAZN,CAAA,EAaA,YAbA,CAaa,KAbb,EAaoB,QAbpB,EAa8B,SAb9B,EAayC,CAbzC,CAAA;EAAY;EAWQ,OACd,CAAA,UAQS,gBART,CAAA,CAAA,MAAA,EASA,CATA,CAAA,EAUN,YAVM,CAUO,KAVP,EAUc,CAVd,EAUiB,SAVjB,EAU4B,OAV5B,CAAA;EAAC,MACM,CAAA,EAAA,EAgBX,YAhBW,CAgBE,WAhBF,CAgBc,QAhBd,CAAA,EAgByB,SAhBzB,EAgBoC,OAhBpC,CAAA,CAAA,EAiBb,KAjBa,CAiBP,KAjBO,EAiBA,WAjBA,CAiBY,QAjBZ,CAAA,EAiBuB,SAjBvB,EAiBkC,OAjBlC,CAAA;;;;;cCtDJ,GAAC,oCAAA"}
@@ -1,60 +1,8 @@
1
- import { Construct, ConstructType } from "../Construct-D0uZvbr3.mjs";
2
- import { cloneWith } from "../clone-pdXxc0t3.mjs";
3
- import { ConsoleLogger, DEFAULT_LOGGER } from "@geekmidas/logger/console";
4
- import { environmentCase } from "@geekmidas/envkit";
5
- import { Publisher } from "@geekmidas/events";
1
+ import "../Construct-D5LZBFhb.mjs";
2
+ import { cloneWith } from "../clone-BWIwx6vL.mjs";
3
+ import { Queue, isQueueResult } from "../Queue-915lgS2D.mjs";
4
+ import { DEFAULT_LOGGER } from "@geekmidas/logger/console";
6
5
 
7
- //#region src/queue/Queue.ts
8
- const DEFAULT_LOGGER$1 = new ConsoleLogger();
9
- /**
10
- * A queue worker — a point-to-point SQS-style queue and its single consumer.
11
- * Unlike a `Subscriber` (topic fan-out, filtered by `subscribedEvents`), a queue
12
- * drains every message of its one `message` type. Build one with `q` (see
13
- * `QueueBuilder`); `gkm build` discovers it into the manifest's `queues` field.
14
- *
15
- * The producer side is {@link Queue.publisher} — a ready-to-inject `Service`
16
- * that any endpoint/function drops into `.services([...])` to send messages.
17
- */
18
- var Queue = class extends Construct {
19
- __IS_QUEUE__ = true;
20
- static isQueue(obj) {
21
- return Boolean(obj && obj.__IS_QUEUE__ === true && obj.type === ConstructType.Queue);
22
- }
23
- constructor(name, handler, messageSchema, timeout = 3e4, services = [], logger = DEFAULT_LOGGER$1, batchSize, fifo) {
24
- super(ConstructType.Queue, logger, services, [], void 0, void 0, timeout);
25
- this.name = name;
26
- this.handler = handler;
27
- this.messageSchema = messageSchema;
28
- this.timeout = timeout;
29
- this.services = services;
30
- this.logger = logger;
31
- this.batchSize = batchSize;
32
- this.fifo = fifo;
33
- }
34
- /**
35
- * The producer side — a `Service` exposing an `EventPublisher` typed to this
36
- * queue's message. Inject it via `.services([queue.publisher])`; the handler
37
- * then calls `services.<name>Publisher.publish([{ type, payload }])`.
38
- *
39
- * It reads `<NAME>_PUBLISHER_CONNECTION_STRING` and builds the transport from
40
- * the URL protocol — `pgboss://` locally, `sqs://` deployed — so the same
41
- * code publishes to Postgres in dev and SQS in prod. Because it's a `Service`,
42
- * `Construct.getEnvironment()` sniffs it, so the env requirement flows into
43
- * the manifest and infra links exactly this queue with least privilege.
44
- */
45
- get publisher() {
46
- const envVar = `${environmentCase(this.name)}_PUBLISHER_CONNECTION_STRING`;
47
- return {
48
- serviceName: `${this.name}Publisher`,
49
- async register({ envParser }) {
50
- const { connectionString } = envParser.create((get) => ({ connectionString: get(envVar).string() })).parse();
51
- return Publisher.fromConnectionString(connectionString);
52
- }
53
- };
54
- }
55
- };
56
-
57
- //#endregion
58
6
  //#region src/queue/QueueBuilder.ts
59
7
  /**
60
8
  * Builds a {@link Queue} worker — `q.queue('orders').services([db]).message(schema).handle(fn)`.
@@ -108,5 +56,5 @@ var QueueBuilder = class {
108
56
  const q = new QueueBuilder();
109
57
 
110
58
  //#endregion
111
- export { Queue, QueueBuilder, q };
59
+ export { Queue, QueueBuilder, isQueueResult, q };
112
60
  //# sourceMappingURL=index.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.mjs","names":["DEFAULT_LOGGER","obj: unknown","name: TName","handler: QueueHandler<TMessage, TServices, TLogger>","messageSchema: TMessage","timeout: number","services: TServices","logger: TLogger","batchSize?: number","fifo?: boolean","name: T","timeout: number","batchSize: number","services: T","logger: T","schema: T","fn: QueueHandler<NonNullable<TMessage>, TServices, TLogger>"],"sources":["../../src/queue/Queue.ts","../../src/queue/QueueBuilder.ts","../../src/queue/index.ts"],"sourcesContent":["import { environmentCase } from '@geekmidas/envkit';\nimport {\n\ttype EventPublisher,\n\ttype EventPublisherConnectionString,\n\ttype PublishableMessage,\n\tPublisher,\n} from '@geekmidas/events';\nimport type { Logger } from '@geekmidas/logger';\nimport { ConsoleLogger } from '@geekmidas/logger/console';\nimport type { InferStandardSchema } from '@geekmidas/schema';\nimport type { Service, ServiceRecord } from '@geekmidas/services';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport { Construct, ConstructType } from '../Construct';\n\nconst DEFAULT_LOGGER = new ConsoleLogger() as unknown as Logger;\n\n/**\n * The wire message a queue carries: `{ type: <queue name>, payload: <message> }`.\n * The producer publishes this shape and the worker receives the `payload`s as\n * its `messages`. Typing `type` to the queue name keeps the publisher fully\n * typed and lets pg-boss (local) / SQS (deployed) route by name.\n */\nexport type QueueMessage<\n\tTName extends string,\n\tTMessage extends StandardSchemaV1,\n> = PublishableMessage<TName, InferStandardSchema<TMessage>>;\n\n/**\n * A queue worker — a point-to-point SQS-style queue and its single consumer.\n * Unlike a `Subscriber` (topic fan-out, filtered by `subscribedEvents`), a queue\n * drains every message of its one `message` type. Build one with `q` (see\n * `QueueBuilder`); `gkm build` discovers it into the manifest's `queues` field.\n *\n * The producer side is {@link Queue.publisher} — a ready-to-inject `Service`\n * that any endpoint/function drops into `.services([...])` to send messages.\n */\nexport class Queue<\n\tTName extends string = string,\n\tTMessage extends StandardSchemaV1 = StandardSchemaV1,\n\tTServices extends Service[] = [],\n\tTLogger extends Logger = Logger,\n> extends Construct<TLogger, string, undefined, undefined, TServices> {\n\t__IS_QUEUE__ = true;\n\n\tstatic isQueue(\n\t\tobj: unknown,\n\t): obj is Queue<string, StandardSchemaV1, Service[], Logger> {\n\t\treturn Boolean(\n\t\t\tobj &&\n\t\t\t\t(obj as { __IS_QUEUE__?: boolean }).__IS_QUEUE__ === true &&\n\t\t\t\t(obj as Construct).type === ConstructType.Queue,\n\t\t);\n\t}\n\n\tconstructor(\n\t\tpublic readonly name: TName,\n\t\tpublic readonly handler: QueueHandler<TMessage, TServices, TLogger>,\n\t\tpublic readonly messageSchema: TMessage,\n\t\tpublic override readonly timeout: number = 30000,\n\t\tpublic override readonly services: TServices = [] as unknown as TServices,\n\t\tpublic override readonly logger: TLogger = DEFAULT_LOGGER as TLogger,\n\t\t/** SQS event-source batch size (deployed). */\n\t\tpublic readonly batchSize?: number,\n\t\t/** Whether the queue is FIFO (deployed). */\n\t\tpublic readonly fifo?: boolean,\n\t) {\n\t\tsuper(\n\t\t\tConstructType.Queue,\n\t\t\tlogger,\n\t\t\tservices,\n\t\t\t[],\n\t\t\tundefined,\n\t\t\tundefined,\n\t\t\ttimeout,\n\t\t);\n\t}\n\n\t/**\n\t * The producer side — a `Service` exposing an `EventPublisher` typed to this\n\t * queue's message. Inject it via `.services([queue.publisher])`; the handler\n\t * then calls `services.<name>Publisher.publish([{ type, payload }])`.\n\t *\n\t * It reads `<NAME>_PUBLISHER_CONNECTION_STRING` and builds the transport from\n\t * the URL protocol — `pgboss://` locally, `sqs://` deployed — so the same\n\t * code publishes to Postgres in dev and SQS in prod. Because it's a `Service`,\n\t * `Construct.getEnvironment()` sniffs it, so the env requirement flows into\n\t * the manifest and infra links exactly this queue with least privilege.\n\t */\n\tget publisher(): Service<\n\t\t`${TName}Publisher`,\n\t\tEventPublisher<QueueMessage<TName, TMessage>>\n\t> {\n\t\tconst envVar = `${environmentCase(this.name)}_PUBLISHER_CONNECTION_STRING`;\n\t\treturn {\n\t\t\tserviceName: `${this.name}Publisher`,\n\t\t\tasync register({ envParser }) {\n\t\t\t\tconst { connectionString } = envParser\n\t\t\t\t\t.create((get) => ({\n\t\t\t\t\t\tconnectionString: get(envVar).string(),\n\t\t\t\t\t}))\n\t\t\t\t\t.parse();\n\n\t\t\t\treturn Publisher.fromConnectionString<QueueMessage<TName, TMessage>>(\n\t\t\t\t\tconnectionString as EventPublisherConnectionString,\n\t\t\t\t);\n\t\t\t},\n\t\t};\n\t}\n}\n\n/** The context a queue handler receives — a batch of typed messages. */\nexport type QueueContext<\n\tTMessage extends StandardSchemaV1,\n\tTServices extends Service[] = [],\n\tTLogger extends Logger = Logger,\n> = {\n\tmessages: InferStandardSchema<TMessage>[];\n\tservices: ServiceRecord<TServices>;\n\tlogger: TLogger;\n};\n\nexport type QueueHandler<\n\tTMessage extends StandardSchemaV1,\n\tTServices extends Service[] = [],\n\tTLogger extends Logger = Logger,\n> = (\n\tctx: QueueContext<TMessage, TServices, TLogger>,\n) => unknown | Promise<unknown>;\n","import type { Logger } from '@geekmidas/logger';\nimport { DEFAULT_LOGGER } from '@geekmidas/logger/console';\nimport type { Service } from '@geekmidas/services';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport { cloneWith } from '../clone';\nimport { Queue, type QueueHandler } from './Queue';\n\n/**\n * Builds a {@link Queue} worker — `q.queue('orders').services([db]).message(schema).handle(fn)`.\n * Services are an array (sniffed for required env vars); `message` is the typed\n * job payload; `handle` is the single consumer. The queue name is captured as a\n * literal so `queue.publisher` is typed to `{ type: '<name>', payload }`.\n */\nexport class QueueBuilder<\n\tTName extends string = string,\n\tTMessage extends StandardSchemaV1 | undefined = undefined,\n\tTServices extends Service[] = [],\n\tTLogger extends Logger = Logger,\n> {\n\tprivate _name?: string;\n\tprivate _messageSchema?: TMessage;\n\tprivate _timeout = 30000;\n\tprivate _batchSize?: number;\n\tprivate _fifo?: boolean;\n\tprivate _services: TServices = [] as Service[] as TServices;\n\tprivate _logger: TLogger = DEFAULT_LOGGER as TLogger;\n\n\t/** The queue name — drives the infra queue and its `<NAME>_*` env vars. */\n\tqueue<T extends string>(\n\t\tname: T,\n\t): QueueBuilder<T, TMessage, TServices, TLogger> {\n\t\treturn cloneWith(this, { _name: name }) as unknown as QueueBuilder<\n\t\t\tT,\n\t\t\tTMessage,\n\t\t\tTServices,\n\t\t\tTLogger\n\t\t>;\n\t}\n\n\ttimeout(timeout: number): this {\n\t\treturn cloneWith(this, { _timeout: timeout });\n\t}\n\n\t/** SQS event-source batch size (deployed). */\n\tbatchSize(batchSize: number): this {\n\t\treturn cloneWith(this, { _batchSize: batchSize });\n\t}\n\n\t/** Mark the queue as FIFO (deployed). */\n\tfifo(fifo = true): this {\n\t\treturn cloneWith(this, { _fifo: fifo });\n\t}\n\n\tservices<T extends Service[]>(\n\t\tservices: T,\n\t): QueueBuilder<TName, TMessage, [...TServices, ...T], TLogger> {\n\t\treturn cloneWith(this, {\n\t\t\t_services: [...this._services, ...services] as unknown as TServices,\n\t\t}) as unknown as QueueBuilder<\n\t\t\tTName,\n\t\t\tTMessage,\n\t\t\t[...TServices, ...T],\n\t\t\tTLogger\n\t\t>;\n\t}\n\n\tlogger<T extends Logger>(\n\t\tlogger: T,\n\t): QueueBuilder<TName, TMessage, TServices, T> {\n\t\treturn cloneWith(this, {\n\t\t\t_logger: logger as unknown as TLogger,\n\t\t}) as unknown as QueueBuilder<TName, TMessage, TServices, T>;\n\t}\n\n\t/** The typed message (job) payload the queue carries. */\n\tmessage<T extends StandardSchemaV1>(\n\t\tschema: T,\n\t): QueueBuilder<TName, T, TServices, TLogger> {\n\t\treturn cloneWith(this, {\n\t\t\t_messageSchema: schema as unknown as TMessage,\n\t\t}) as unknown as QueueBuilder<TName, T, TServices, TLogger>;\n\t}\n\n\thandle(\n\t\tfn: QueueHandler<NonNullable<TMessage>, TServices, TLogger>,\n\t): Queue<TName, NonNullable<TMessage>, TServices, TLogger> {\n\t\tif (!this._name) {\n\t\t\tthrow new Error(\n\t\t\t\t'Queue requires a name — call .queue(name) before .handle().',\n\t\t\t);\n\t\t}\n\t\tif (!this._messageSchema) {\n\t\t\tthrow new Error(\n\t\t\t\t'Queue requires a message schema — call .message(schema) before .handle().',\n\t\t\t);\n\t\t}\n\n\t\tconst queue = new Queue<TName, NonNullable<TMessage>, TServices, TLogger>(\n\t\t\tthis._name as TName,\n\t\t\tfn,\n\t\t\tthis._messageSchema as NonNullable<TMessage>,\n\t\t\tthis._timeout,\n\t\t\tthis._services,\n\t\t\tthis._logger,\n\t\t\tthis._batchSize,\n\t\t\tthis._fifo,\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\treturn queue;\n\t}\n}\n","export {\n\tQueue,\n\ttype QueueContext,\n\ttype QueueHandler,\n\ttype QueueMessage,\n} from './Queue';\n\nimport { QueueBuilder } from './QueueBuilder';\n\nexport { QueueBuilder } from './QueueBuilder';\n\nexport const q = new QueueBuilder();\n"],"mappings":";;;;;;;AAcA,MAAMA,mBAAiB,IAAI;;;;;;;;;;AAsB3B,IAAa,QAAb,cAKU,UAA4D;CACrE,eAAe;CAEf,OAAO,QACNC,KAC4D;AAC5D,SAAO,QACN,OACE,IAAmC,iBAAiB,QACpD,IAAkB,SAAS,cAAc,MAC3C;CACD;CAED,YACiBC,MACAC,SACAC,eACSC,UAAkB,KAClBC,WAAsB,CAAE,GACxBC,SAAkBP,kBAE3BQ,WAEAC,MACf;AACD,QACC,cAAc,OACd,QACA,UACA,CAAE,mBAGF,QACA;EAnBe;EACA;EACA;EACS;EACA;EACA;EAET;EAEA;CAWhB;;;;;;;;;;;;CAaD,IAAI,YAGF;EACD,MAAM,UAAU,EAAE,gBAAgB,KAAK,KAAK,CAAC;AAC7C,SAAO;GACN,cAAc,EAAE,KAAK,KAAK;GAC1B,MAAM,SAAS,EAAE,WAAW,EAAE;IAC7B,MAAM,EAAE,kBAAkB,GAAG,UAC3B,OAAO,CAAC,SAAS,EACjB,kBAAkB,IAAI,OAAO,CAAC,QAAQ,CACtC,GAAE,CACF,OAAO;AAET,WAAO,UAAU,qBAChB,iBACA;GACD;EACD;CACD;AACD;;;;;;;;;;AC/FD,IAAa,eAAb,MAKE;CACD,AAAQ;CACR,AAAQ;CACR,AAAQ,WAAW;CACnB,AAAQ;CACR,AAAQ;CACR,AAAQ,YAAuB,CAAE;CACjC,AAAQ,UAAmB;;CAG3B,MACCC,MACgD;AAChD,SAAO,UAAU,MAAM,EAAE,OAAO,KAAM,EAAC;CAMvC;CAED,QAAQC,SAAuB;AAC9B,SAAO,UAAU,MAAM,EAAE,UAAU,QAAS,EAAC;CAC7C;;CAGD,UAAUC,WAAyB;AAClC,SAAO,UAAU,MAAM,EAAE,YAAY,UAAW,EAAC;CACjD;;CAGD,KAAK,OAAO,MAAY;AACvB,SAAO,UAAU,MAAM,EAAE,OAAO,KAAM,EAAC;CACvC;CAED,SACCC,UAC+D;AAC/D,SAAO,UAAU,MAAM,EACtB,WAAW,CAAC,GAAG,KAAK,WAAW,GAAG,QAAS,EAC3C,EAAC;CAMF;CAED,OACCC,QAC8C;AAC9C,SAAO,UAAU,MAAM,EACtB,SAAS,OACT,EAAC;CACF;;CAGD,QACCC,QAC6C;AAC7C,SAAO,UAAU,MAAM,EACtB,gBAAgB,OAChB,EAAC;CACF;CAED,OACCC,IAC0D;AAC1D,OAAK,KAAK,MACT,OAAM,IAAI,MACT;AAGF,OAAK,KAAK,eACT,OAAM,IAAI,MACT;EAIF,MAAM,QAAQ,IAAI,MACjB,KAAK,OACL,IACA,KAAK,gBACL,KAAK,UACL,KAAK,WACL,KAAK,SACL,KAAK,YACL,KAAK;AAON,SAAO;CACP;AACD;;;;ACvGD,MAAa,IAAI,IAAI"}
1
+ {"version":3,"file":"index.mjs","names":["name: T","timeout: number","batchSize: number","services: T","logger: T","schema: T","fn: QueueHandler<NonNullable<TMessage>, TServices, TLogger>"],"sources":["../../src/queue/QueueBuilder.ts","../../src/queue/index.ts"],"sourcesContent":["import type { Logger } from '@geekmidas/logger';\nimport { DEFAULT_LOGGER } from '@geekmidas/logger/console';\nimport type { Service } from '@geekmidas/services';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport { cloneWith } from '../clone';\nimport { Queue, type QueueHandler } from './Queue';\n\n/**\n * Builds a {@link Queue} worker — `q.queue('orders').services([db]).message(schema).handle(fn)`.\n * Services are an array (sniffed for required env vars); `message` is the typed\n * job payload; `handle` is the single consumer. The queue name is captured as a\n * literal so `queue.publisher` is typed to `{ type: '<name>', payload }`.\n */\nexport class QueueBuilder<\n\tTName extends string = string,\n\tTMessage extends StandardSchemaV1 | undefined = undefined,\n\tTServices extends Service[] = [],\n\tTLogger extends Logger = Logger,\n> {\n\tprivate _name?: string;\n\tprivate _messageSchema?: TMessage;\n\tprivate _timeout = 30000;\n\tprivate _batchSize?: number;\n\tprivate _fifo?: boolean;\n\tprivate _services: TServices = [] as Service[] as TServices;\n\tprivate _logger: TLogger = DEFAULT_LOGGER as TLogger;\n\n\t/** The queue name — drives the infra queue and its `<NAME>_*` env vars. */\n\tqueue<T extends string>(\n\t\tname: T,\n\t): QueueBuilder<T, TMessage, TServices, TLogger> {\n\t\treturn cloneWith(this, { _name: name }) as unknown as QueueBuilder<\n\t\t\tT,\n\t\t\tTMessage,\n\t\t\tTServices,\n\t\t\tTLogger\n\t\t>;\n\t}\n\n\ttimeout(timeout: number): this {\n\t\treturn cloneWith(this, { _timeout: timeout });\n\t}\n\n\t/** SQS event-source batch size (deployed). */\n\tbatchSize(batchSize: number): this {\n\t\treturn cloneWith(this, { _batchSize: batchSize });\n\t}\n\n\t/** Mark the queue as FIFO (deployed). */\n\tfifo(fifo = true): this {\n\t\treturn cloneWith(this, { _fifo: fifo });\n\t}\n\n\tservices<T extends Service[]>(\n\t\tservices: T,\n\t): QueueBuilder<TName, TMessage, [...TServices, ...T], TLogger> {\n\t\treturn cloneWith(this, {\n\t\t\t_services: [...this._services, ...services] as unknown as TServices,\n\t\t}) as unknown as QueueBuilder<\n\t\t\tTName,\n\t\t\tTMessage,\n\t\t\t[...TServices, ...T],\n\t\t\tTLogger\n\t\t>;\n\t}\n\n\tlogger<T extends Logger>(\n\t\tlogger: T,\n\t): QueueBuilder<TName, TMessage, TServices, T> {\n\t\treturn cloneWith(this, {\n\t\t\t_logger: logger as unknown as TLogger,\n\t\t}) as unknown as QueueBuilder<TName, TMessage, TServices, T>;\n\t}\n\n\t/** The typed message (job) payload the queue carries. */\n\tmessage<T extends StandardSchemaV1>(\n\t\tschema: T,\n\t): QueueBuilder<TName, T, TServices, TLogger> {\n\t\treturn cloneWith(this, {\n\t\t\t_messageSchema: schema as unknown as TMessage,\n\t\t}) as unknown as QueueBuilder<TName, T, TServices, TLogger>;\n\t}\n\n\thandle(\n\t\tfn: QueueHandler<NonNullable<TMessage>, TServices, TLogger>,\n\t): Queue<TName, NonNullable<TMessage>, TServices, TLogger> {\n\t\tif (!this._name) {\n\t\t\tthrow new Error(\n\t\t\t\t'Queue requires a name — call .queue(name) before .handle().',\n\t\t\t);\n\t\t}\n\t\tif (!this._messageSchema) {\n\t\t\tthrow new Error(\n\t\t\t\t'Queue requires a message schema — call .message(schema) before .handle().',\n\t\t\t);\n\t\t}\n\n\t\tconst queue = new Queue<TName, NonNullable<TMessage>, TServices, TLogger>(\n\t\t\tthis._name as TName,\n\t\t\tfn,\n\t\t\tthis._messageSchema as NonNullable<TMessage>,\n\t\t\tthis._timeout,\n\t\t\tthis._services,\n\t\t\tthis._logger,\n\t\t\tthis._batchSize,\n\t\t\tthis._fifo,\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\treturn queue;\n\t}\n}\n","export {\n\tisQueueResult,\n\tQueue,\n\ttype QueueContext,\n\ttype QueueHandler,\n\ttype QueueMessage,\n\ttype QueueRecord,\n\ttype QueueResult,\n} from './Queue';\n\nimport { QueueBuilder } from './QueueBuilder';\n\nexport { QueueBuilder } from './QueueBuilder';\n\nexport const q = new QueueBuilder();\n"],"mappings":";;;;;;;;;;;;AAaA,IAAa,eAAb,MAKE;CACD,AAAQ;CACR,AAAQ;CACR,AAAQ,WAAW;CACnB,AAAQ;CACR,AAAQ;CACR,AAAQ,YAAuB,CAAE;CACjC,AAAQ,UAAmB;;CAG3B,MACCA,MACgD;AAChD,SAAO,UAAU,MAAM,EAAE,OAAO,KAAM,EAAC;CAMvC;CAED,QAAQC,SAAuB;AAC9B,SAAO,UAAU,MAAM,EAAE,UAAU,QAAS,EAAC;CAC7C;;CAGD,UAAUC,WAAyB;AAClC,SAAO,UAAU,MAAM,EAAE,YAAY,UAAW,EAAC;CACjD;;CAGD,KAAK,OAAO,MAAY;AACvB,SAAO,UAAU,MAAM,EAAE,OAAO,KAAM,EAAC;CACvC;CAED,SACCC,UAC+D;AAC/D,SAAO,UAAU,MAAM,EACtB,WAAW,CAAC,GAAG,KAAK,WAAW,GAAG,QAAS,EAC3C,EAAC;CAMF;CAED,OACCC,QAC8C;AAC9C,SAAO,UAAU,MAAM,EACtB,SAAS,OACT,EAAC;CACF;;CAGD,QACCC,QAC6C;AAC7C,SAAO,UAAU,MAAM,EACtB,gBAAgB,OAChB,EAAC;CACF;CAED,OACCC,IAC0D;AAC1D,OAAK,KAAK,MACT,OAAM,IAAI,MACT;AAGF,OAAK,KAAK,eACT,OAAM,IAAI,MACT;EAIF,MAAM,QAAQ,IAAI,MACjB,KAAK,OACL,IACA,KAAK,gBACL,KAAK,UACL,KAAK,WACL,KAAK,SACL,KAAK,YACL,KAAK;AAON,SAAO;CACP;AACD;;;;ACpGD,MAAa,IAAI,IAAI"}
@@ -1,5 +1,5 @@
1
- const require_Construct = require('../Construct-D09WUUOf.cjs');
2
- const require_clone = require('../clone-I_WIpiFf.cjs');
1
+ const require_Construct = require('../Construct-Cf_0pAvo.cjs');
2
+ const require_clone = require('../clone-BQnYiRgm.cjs');
3
3
  const __geekmidas_logger_console = require_Construct.__toESM(require("@geekmidas/logger/console"));
4
4
 
5
5
  //#region src/subscribers/Subscriber.ts
@@ -1,6 +1,6 @@
1
- import "../Construct-D_3yZ9m5.cjs";
2
- import { Subscriber, SubscriberHandler } from "../Subscriber-DvKSp0N4.cjs";
3
- import { Topic, TopicEvents, TopicMessage } from "../Topic-BMfrIFdX.cjs";
1
+ import "../Construct-BEh2DSMe.cjs";
2
+ import { Subscriber, SubscriberHandler } from "../Subscriber-YwPpHrBc.cjs";
3
+ import { Topic, TopicEvents, TopicMessage } from "../Topic-dIcPqSLa.cjs";
4
4
  import { EventPublisher, ExtractPublisherMessage } from "@geekmidas/events";
5
5
  import * as _geekmidas_logger9 from "@geekmidas/logger";
6
6
  import { Logger } from "@geekmidas/logger";
@@ -1,6 +1,6 @@
1
- import "../Construct-DsqpiAym.mjs";
2
- import { Subscriber, SubscriberHandler } from "../Subscriber-CJ22tp8r.mjs";
3
- import { Topic, TopicEvents, TopicMessage } from "../Topic-B-fxOsR2.mjs";
1
+ import "../Construct-qnOnQTcP.mjs";
2
+ import { Subscriber, SubscriberHandler } from "../Subscriber-Bjil86Ub.mjs";
3
+ import { Topic, TopicEvents, TopicMessage } from "../Topic-D8-wkoh4.mjs";
4
4
  import { Service } from "@geekmidas/services";
5
5
  import { EventPublisher, ExtractPublisherMessage } from "@geekmidas/events";
6
6
  import { Logger as Logger$1 } from "@geekmidas/logger";
@@ -1,5 +1,5 @@
1
- import { Construct, ConstructType } from "../Construct-D0uZvbr3.mjs";
2
- import { cloneWith } from "../clone-pdXxc0t3.mjs";
1
+ import { Construct, ConstructType } from "../Construct-D5LZBFhb.mjs";
2
+ import { cloneWith } from "../clone-BWIwx6vL.mjs";
3
3
  import { ConsoleLogger, DEFAULT_LOGGER } from "@geekmidas/logger/console";
4
4
 
5
5
  //#region src/subscribers/Subscriber.ts
@@ -92,4 +92,4 @@ interface Telemetry {
92
92
  //# sourceMappingURL=telemetry.d.ts.map
93
93
  //#endregion
94
94
  export { Telemetry, TelemetryContext, TelemetryRequest, TelemetryResponse };
95
- //# sourceMappingURL=telemetry-C--EgYVr.d.mts.map
95
+ //# sourceMappingURL=telemetry-vq7C0ZBy.d.mts.map
@@ -1 +1 @@
1
- {"version":3,"file":"telemetry-C--EgYVr.d.mts","names":[],"sources":["../src/telemetry.ts"],"sourcesContent":[],"mappings":";;;;;;;AA6FmB,UAlFF,gBAAA,CAkFE;EAAgB;;;EAQgB,CAAA,GAAA,EAAA,MAAA,CAAA,EAAA,OAAA;;;;;UAhFlC,gBAAA;;;;;;;;WASP;;;;;UAMO,iBAAA;;;;;;;;;;;;YAcN;;;;;;;;;;;;;;;;;;;;;;;;;;;UA4BM,SAAA;;;;;;;0BAOQ,mBAAmB;;;;;;;oBAQzB,4BAA4B;;;;;;;sBAQ1B,yBAAyB"}
1
+ {"version":3,"file":"telemetry-vq7C0ZBy.d.mts","names":[],"sources":["../src/telemetry.ts"],"sourcesContent":[],"mappings":";;;;;;;AA6FmB,UAlFF,gBAAA,CAkFE;EAAgB;;;EAQgB,CAAA,GAAA,EAAA,MAAA,CAAA,EAAA,OAAA;;;;;UAhFlC,gBAAA;;;;;;;;WASP;;;;;UAMO,iBAAA;;;;;;;;;;;;YAcN;;;;;;;;;;;;;;;;;;;;;;;;;;;UA4BM,SAAA;;;;;;;0BAOQ,mBAAmB;;;;;;;oBAQzB,4BAA4B;;;;;;;sBAQ1B,yBAAyB"}
@@ -1,5 +1,5 @@
1
- const require_Construct = require('../Construct-D09WUUOf.cjs');
2
- const require_clone = require('../clone-I_WIpiFf.cjs');
1
+ const require_Construct = require('../Construct-Cf_0pAvo.cjs');
2
+ const require_clone = require('../clone-BQnYiRgm.cjs');
3
3
  const __geekmidas_logger_console = require_Construct.__toESM(require("@geekmidas/logger/console"));
4
4
  const __geekmidas_envkit = require_Construct.__toESM(require("@geekmidas/envkit"));
5
5
  const __geekmidas_events = require_Construct.__toESM(require("@geekmidas/events"));
@@ -1,5 +1,5 @@
1
- import "../Construct-D_3yZ9m5.cjs";
2
- import { Topic, TopicEvents, TopicMessage } from "../Topic-BMfrIFdX.cjs";
1
+ import "../Construct-BEh2DSMe.cjs";
2
+ import { Topic, TopicEvents, TopicMessage } from "../Topic-dIcPqSLa.cjs";
3
3
  import { Logger } from "@geekmidas/logger";
4
4
 
5
5
  //#region src/topic/TopicBuilder.d.ts
@@ -1,5 +1,5 @@
1
- import "../Construct-DsqpiAym.mjs";
2
- import { Topic, TopicEvents, TopicMessage } from "../Topic-B-fxOsR2.mjs";
1
+ import "../Construct-qnOnQTcP.mjs";
2
+ import { Topic, TopicEvents, TopicMessage } from "../Topic-D8-wkoh4.mjs";
3
3
  import { Logger } from "@geekmidas/logger";
4
4
 
5
5
  //#region src/topic/TopicBuilder.d.ts
@@ -1,5 +1,5 @@
1
- import { Construct, ConstructType } from "../Construct-D0uZvbr3.mjs";
2
- import { cloneWith } from "../clone-pdXxc0t3.mjs";
1
+ import { Construct, ConstructType } from "../Construct-D5LZBFhb.mjs";
2
+ import { cloneWith } from "../clone-BWIwx6vL.mjs";
3
3
  import { ConsoleLogger, DEFAULT_LOGGER } from "@geekmidas/logger/console";
4
4
  import { environmentCase } from "@geekmidas/envkit";
5
5
  import { Publisher } from "@geekmidas/events";
@@ -6,4 +6,4 @@ type LowerHttpMethod<T extends HttpMethod> = Lowercase<T>;
6
6
 
7
7
  //#endregion
8
8
  export { HttpMethod, LowerHttpMethod, RemoveUndefined };
9
- //# sourceMappingURL=types-DNngH0fX.d.mts.map
9
+ //# sourceMappingURL=types-X37z95fN.d.mts.map
@@ -1 +1 @@
1
- {"version":3,"file":"types-DNngH0fX.d.mts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":";KAAY,6BAAA,MACC,CADD,IACM,CADS,CACP,CADO,CAAA,SAAA,SAAA,GAAA,KAAA,GACwB,CADxB,GAC4B,CAD5B,CAC8B,CAD9B,CAAA,EAAA;AACd,KAGD,UAAA,GAHC,KAAA,GAAA,MAAA,GAAA,KAAA,GAAA,OAAA,GAAA,QAAA,GAAA,SAAA;AAAK,KAWN,eAXM,CAAA,UAWoB,UAXpB,CAAA,GAWkC,SAXlC,CAW4C,CAX5C,CAAA"}
1
+ {"version":3,"file":"types-X37z95fN.d.mts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":";KAAY,6BAAA,MACC,CADD,IACM,CADS,CACP,CADO,CAAA,SAAA,SAAA,GAAA,KAAA,GACwB,CADxB,GAC4B,CAD5B,CAC8B,CAD9B,CAAA,EAAA;AACd,KAGD,UAAA,GAHC,KAAA,GAAA,MAAA,GAAA,KAAA,GAAA,OAAA,GAAA,QAAA,GAAA,SAAA;AAAK,KAWN,eAXM,CAAA,UAWoB,UAXpB,CAAA,GAWkC,SAXlC,CAW4C,CAX5C,CAAA"}
package/dist/types.d.mts CHANGED
@@ -1,2 +1,2 @@
1
- import { HttpMethod, LowerHttpMethod, RemoveUndefined } from "./types-DNngH0fX.mjs";
1
+ import { HttpMethod, LowerHttpMethod, RemoveUndefined } from "./types-X37z95fN.mjs";
2
2
  export { HttpMethod, LowerHttpMethod, RemoveUndefined };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@geekmidas/constructs",
3
- "version": "9.3.0",
3
+ "version": "9.5.0",
4
4
  "private": false,
5
5
  "type": "module",
6
6
  "exports": {
@@ -152,33 +152,33 @@
152
152
  "pg": "~8.16.3",
153
153
  "msw": "~2.10.3",
154
154
  "zod": "~4.6.6",
155
- "@geekmidas/audit": "^9.3.0",
156
- "@geekmidas/cache": "^9.3.0",
157
- "@geekmidas/db": "^9.3.0",
158
- "@geekmidas/envkit": "^9.3.0",
159
- "@geekmidas/errors": "^9.3.0",
160
- "@geekmidas/events": "^9.3.0",
161
- "@geekmidas/logger": "^9.3.0",
162
- "@geekmidas/rate-limit": "^9.3.0",
163
- "@geekmidas/schema": "^9.3.0",
164
- "@geekmidas/services": "^9.3.0",
165
- "@geekmidas/testkit": "^9.3.0"
155
+ "@geekmidas/audit": "^9.5.0",
156
+ "@geekmidas/cache": "^9.5.0",
157
+ "@geekmidas/db": "^9.5.0",
158
+ "@geekmidas/envkit": "^9.5.0",
159
+ "@geekmidas/errors": "^9.5.0",
160
+ "@geekmidas/events": "^9.5.0",
161
+ "@geekmidas/logger": "^9.5.0",
162
+ "@geekmidas/rate-limit": "^9.5.0",
163
+ "@geekmidas/schema": "^9.5.0",
164
+ "@geekmidas/services": "^9.5.0",
165
+ "@geekmidas/testkit": "^9.5.0"
166
166
  },
167
167
  "peerDependencies": {
168
168
  "@middy/core": ">=6.3.1",
169
169
  "@types/aws-lambda": ">=8.10.92",
170
170
  "hono": ">=4.8.2",
171
171
  "msw": ">=2.0.0",
172
- "@geekmidas/audit": "^9.3.0",
173
- "@geekmidas/cache": "^9.3.0",
174
- "@geekmidas/db": "^9.3.0",
175
- "@geekmidas/envkit": "^9.3.0",
176
- "@geekmidas/errors": "^9.3.0",
177
- "@geekmidas/events": "^9.3.0",
178
- "@geekmidas/logger": "^9.3.0",
179
- "@geekmidas/rate-limit": "^9.3.0",
180
- "@geekmidas/schema": "^9.3.0",
181
- "@geekmidas/services": "^9.3.0"
172
+ "@geekmidas/audit": "^9.5.0",
173
+ "@geekmidas/cache": "^9.5.0",
174
+ "@geekmidas/db": "^9.5.0",
175
+ "@geekmidas/envkit": "^9.5.0",
176
+ "@geekmidas/errors": "^9.5.0",
177
+ "@geekmidas/events": "^9.5.0",
178
+ "@geekmidas/logger": "^9.5.0",
179
+ "@geekmidas/rate-limit": "^9.5.0",
180
+ "@geekmidas/schema": "^9.5.0",
181
+ "@geekmidas/services": "^9.5.0"
182
182
  },
183
183
  "peerDependenciesMeta": {
184
184
  "@geekmidas/audit": {
package/src/Construct.ts CHANGED
@@ -9,7 +9,7 @@ import type { Logger } from '@geekmidas/logger';
9
9
  import type { Service, ServiceContext } from '@geekmidas/services';
10
10
  import type { StandardSchemaV1 } from '@standard-schema/spec';
11
11
  import compact from 'lodash.compact';
12
- import type { MonitorInfo, MonitorService } from './monitor';
12
+ import type { MonitorService } from './monitor';
13
13
 
14
14
  // Cache for service environment variables to handle singleton services
15
15
  // Stores both the full list and the optional subset so the same sniff result
@@ -61,7 +61,7 @@ export abstract class Construct<
61
61
  /** Database service for this construct (used by Endpoint for RLS/audit context) */
62
62
  public databaseService?: Service<TDatabaseServiceName, TDatabase>;
63
63
 
64
- /** Monitors told about each run of this construct (see `.monitor()`). */
64
+ /** Monitors told about each run: a cron's `.uptime()`, if it has one. */
65
65
  public monitors: MonitorService[] = [];
66
66
 
67
67
  constructor(
@@ -80,17 +80,6 @@ export abstract class Construct<
80
80
  >,
81
81
  ) {}
82
82
 
83
- /**
84
- * This construct's monitors as the build manifest records them, or nothing
85
- * when it has none.
86
- */
87
- getMonitoring(): MonitorInfo[] | undefined {
88
- if (!this.monitors.length) return undefined;
89
- return this.monitors.map(
90
- (monitor) => monitor.monitor ?? { type: monitor.serviceName },
91
- );
92
- }
93
-
94
83
  /**
95
84
  * Returns an array of environment variable names required by this construct's services.
96
85
  * This is determined by running a "sniffer" EnvironmentParser through each service's