@geekmidas/constructs 10.0.0-alpha.0 → 10.0.0-alpha.10

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 (218) hide show
  1. package/README.md +1 -0
  2. package/dist/{Construct-HmWM6YYu.mjs → Construct-BD5neF7w.mjs} +15 -2
  3. package/dist/Construct-BD5neF7w.mjs.map +1 -0
  4. package/dist/{Construct-WhCXIOPV.d.cts → Construct-C0ijr2qp.d.cts} +14 -1
  5. package/dist/Construct-C0ijr2qp.d.cts.map +1 -0
  6. package/dist/{Construct-B-xc0SE9.d.mts → Construct-Ct8nalEi.d.mts} +14 -1
  7. package/dist/Construct-Ct8nalEi.d.mts.map +1 -0
  8. package/dist/{Construct-roId57cU.cjs → Construct-CyS3RpTL.cjs} +14 -1
  9. package/dist/Construct-CyS3RpTL.cjs.map +1 -0
  10. package/dist/Cron-DmQ8vQ4b.d.cts +39 -0
  11. package/dist/Cron-DmQ8vQ4b.d.cts.map +1 -0
  12. package/dist/Cron-dh4rUgib.d.mts +39 -0
  13. package/dist/Cron-dh4rUgib.d.mts.map +1 -0
  14. package/dist/CronBuilder-BquXDbDI.d.cts +44 -0
  15. package/dist/CronBuilder-BquXDbDI.d.cts.map +1 -0
  16. package/dist/CronBuilder-CGgY2080.d.mts +44 -0
  17. package/dist/CronBuilder-CGgY2080.d.mts.map +1 -0
  18. package/dist/CronBuilder-CYKT5RiO.mjs +93 -0
  19. package/dist/CronBuilder-CYKT5RiO.mjs.map +1 -0
  20. package/dist/CronBuilder-Da0C0edR.cjs +105 -0
  21. package/dist/CronBuilder-Da0C0edR.cjs.map +1 -0
  22. package/dist/{Endpoint-ROcXU-eH.d.mts → Endpoint-BjWKinFA.d.mts} +2 -2
  23. package/dist/{Endpoint-ROcXU-eH.d.mts.map → Endpoint-BjWKinFA.d.mts.map} +1 -1
  24. package/dist/{Endpoint-BGwpNEX4.mjs → Endpoint-DCQPMdUX.mjs} +3 -3
  25. package/dist/{Endpoint-BGwpNEX4.mjs.map → Endpoint-DCQPMdUX.mjs.map} +1 -1
  26. package/dist/{Endpoint-BBkV6l0k.cjs → Endpoint-DcWXE-SZ.cjs} +3 -3
  27. package/dist/{Endpoint-BBkV6l0k.cjs.map → Endpoint-DcWXE-SZ.cjs.map} +1 -1
  28. package/dist/{Endpoint-BnxZqIX-.d.cts → Endpoint-dav89W6-.d.cts} +2 -2
  29. package/dist/{Endpoint-BnxZqIX-.d.cts.map → Endpoint-dav89W6-.d.cts.map} +1 -1
  30. package/dist/{EndpointFactory-DYoGLaIT.cjs → EndpointFactory-CdWB7wPw.cjs} +7 -5
  31. package/dist/EndpointFactory-CdWB7wPw.cjs.map +1 -0
  32. package/dist/{EndpointFactory-Di0X9AWp.mjs → EndpointFactory-CjV8F_lJ.mjs} +7 -5
  33. package/dist/EndpointFactory-CjV8F_lJ.mjs.map +1 -0
  34. package/dist/{HonoEndpointAdaptor-wMsCyMgt.cjs → HonoEndpointAdaptor-DtL9j19R.cjs} +5 -6
  35. package/dist/{HonoEndpointAdaptor-wMsCyMgt.cjs.map → HonoEndpointAdaptor-DtL9j19R.cjs.map} +1 -1
  36. package/dist/{HonoEndpointAdaptor-DFKIIG2o.mjs → HonoEndpointAdaptor-P1ahhZHu.mjs} +4 -5
  37. package/dist/{HonoEndpointAdaptor-DFKIIG2o.mjs.map → HonoEndpointAdaptor-P1ahhZHu.mjs.map} +1 -1
  38. package/dist/{Queue-D6WeziRD.d.cts → Queue-D7ZuwBhy.d.cts} +2 -2
  39. package/dist/{Queue-D6WeziRD.d.cts.map → Queue-D7ZuwBhy.d.cts.map} +1 -1
  40. package/dist/{Queue-DpUeqdC8.d.mts → Queue-gVGfi2Yk.d.mts} +2 -2
  41. package/dist/{Queue-DpUeqdC8.d.mts.map → Queue-gVGfi2Yk.d.mts.map} +1 -1
  42. package/dist/{Subscriber-4rBJgDKI.d.mts → Subscriber-2mEi0ImH.d.cts} +3 -3
  43. package/dist/{Subscriber-4rBJgDKI.d.mts.map → Subscriber-2mEi0ImH.d.cts.map} +1 -1
  44. package/dist/{Subscriber-DVQowdyj.d.cts → Subscriber-xTJ9ayPN.d.mts} +3 -3
  45. package/dist/{Subscriber-DVQowdyj.d.cts.map → Subscriber-xTJ9ayPN.d.mts.map} +1 -1
  46. package/dist/SubscriberBuilder-4OPehf2R.cjs +120 -0
  47. package/dist/SubscriberBuilder-4OPehf2R.cjs.map +1 -0
  48. package/dist/SubscriberBuilder-BjkbeT9l.mjs +108 -0
  49. package/dist/SubscriberBuilder-BjkbeT9l.mjs.map +1 -0
  50. package/dist/SubscriberBuilder-Dptmo-1A.d.mts +62 -0
  51. package/dist/SubscriberBuilder-Dptmo-1A.d.mts.map +1 -0
  52. package/dist/SubscriberBuilder-waNhzjSM.d.cts +62 -0
  53. package/dist/SubscriberBuilder-waNhzjSM.d.cts.map +1 -0
  54. package/dist/{Topic-Ohx9dvWr.d.cts → Topic-19QeHBIR.d.cts} +2 -2
  55. package/dist/{Topic-Ohx9dvWr.d.cts.map → Topic-19QeHBIR.d.cts.map} +1 -1
  56. package/dist/{Topic-cmy2jOUy.d.mts → Topic-DuFeqkBh.d.mts} +2 -2
  57. package/dist/{Topic-cmy2jOUy.d.mts.map → Topic-DuFeqkBh.d.mts.map} +1 -1
  58. package/dist/adaptors/aws.cjs +243 -10
  59. package/dist/adaptors/aws.cjs.map +1 -1
  60. package/dist/adaptors/aws.d.cts +99 -10
  61. package/dist/adaptors/aws.d.cts.map +1 -1
  62. package/dist/adaptors/aws.d.mts +99 -10
  63. package/dist/adaptors/aws.d.mts.map +1 -1
  64. package/dist/adaptors/aws.mjs +240 -7
  65. package/dist/adaptors/aws.mjs.map +1 -1
  66. package/dist/adaptors/hono.cjs +6 -7
  67. package/dist/adaptors/hono.d.cts +6 -6
  68. package/dist/adaptors/hono.d.cts.map +1 -1
  69. package/dist/adaptors/hono.d.mts +6 -6
  70. package/dist/adaptors/hono.d.mts.map +1 -1
  71. package/dist/adaptors/hono.mjs +6 -7
  72. package/dist/adaptors/testing.cjs +9 -10
  73. package/dist/adaptors/testing.cjs.map +1 -1
  74. package/dist/adaptors/testing.d.cts +6 -6
  75. package/dist/adaptors/testing.d.mts +6 -6
  76. package/dist/adaptors/testing.mjs +6 -7
  77. package/dist/adaptors/testing.mjs.map +1 -1
  78. package/dist/auth.cjs +2 -2
  79. package/dist/auth.cjs.map +1 -1
  80. package/dist/auth.d.cts +10 -10
  81. package/dist/auth.d.cts.map +1 -1
  82. package/dist/auth.d.mts +10 -10
  83. package/dist/auth.d.mts.map +1 -1
  84. package/dist/auth.mjs +2 -2
  85. package/dist/auth.mjs.map +1 -1
  86. package/dist/{cache-CdQ7OLpR.d.cts → cache-BrRz3fEB.d.mts} +3 -3
  87. package/dist/{cache-CdQ7OLpR.d.cts.map → cache-BrRz3fEB.d.mts.map} +1 -1
  88. package/dist/{cache-DYoJFcfd.d.mts → cache-BtZY_tHe.d.cts} +3 -3
  89. package/dist/{cache-DYoJFcfd.d.mts.map → cache-BtZY_tHe.d.cts.map} +1 -1
  90. package/dist/cache.d.cts +2 -2
  91. package/dist/cache.d.mts +2 -2
  92. package/dist/{construct-interface-BqwRNYA2.d.mts → construct-interface-D9d4Gm4p.d.cts} +2 -2
  93. package/dist/{construct-interface-BqwRNYA2.d.mts.map → construct-interface-D9d4Gm4p.d.cts.map} +1 -1
  94. package/dist/{construct-interface-D2nNkHUN.d.cts → construct-interface-g5GM5pwR.d.mts} +2 -2
  95. package/dist/{construct-interface-D2nNkHUN.d.cts.map → construct-interface-g5GM5pwR.d.mts.map} +1 -1
  96. package/dist/construct-interface.d.cts +1 -1
  97. package/dist/construct-interface.d.mts +1 -1
  98. package/dist/credential.d.cts +1 -1
  99. package/dist/credential.d.mts +1 -1
  100. package/dist/crons/index.cjs +68 -86
  101. package/dist/crons/index.cjs.map +1 -1
  102. package/dist/crons/index.d.cts +36 -48
  103. package/dist/crons/index.d.cts.map +1 -1
  104. package/dist/crons/index.d.mts +36 -48
  105. package/dist/crons/index.d.mts.map +1 -1
  106. package/dist/crons/index.mjs +65 -82
  107. package/dist/crons/index.mjs.map +1 -1
  108. package/dist/database/kysely.d.cts +2 -2
  109. package/dist/database/kysely.d.mts +2 -2
  110. package/dist/email.d.cts +1 -1
  111. package/dist/email.d.mts +1 -1
  112. package/dist/endpoints/index.cjs +6 -7
  113. package/dist/endpoints/index.d.cts +5 -5
  114. package/dist/endpoints/index.d.mts +5 -5
  115. package/dist/endpoints/index.mjs +5 -6
  116. package/dist/file-server.d.cts +1 -1
  117. package/dist/file-server.d.mts +1 -1
  118. package/dist/functions/index.cjs +3 -4
  119. package/dist/functions/index.d.cts +4 -4
  120. package/dist/functions/index.d.mts +4 -4
  121. package/dist/functions/index.mjs +3 -3
  122. package/dist/{functions-CvT_q7Y4.mjs → functions-14lpEFL4.mjs} +22 -9
  123. package/dist/functions-14lpEFL4.mjs.map +1 -0
  124. package/dist/{functions-DukjG8ov.cjs → functions-i_la-N5r.cjs} +21 -14
  125. package/dist/functions-i_la-N5r.cjs.map +1 -0
  126. package/dist/{index-7OcOWe75.d.cts → index-Bd5FqCoe.d.cts} +5 -5
  127. package/dist/{index-7OcOWe75.d.cts.map → index-Bd5FqCoe.d.cts.map} +1 -1
  128. package/dist/index-BknhM6Ux.d.mts +31 -0
  129. package/dist/index-BknhM6Ux.d.mts.map +1 -0
  130. package/dist/index-CBSfrowv.d.cts +31 -0
  131. package/dist/index-CBSfrowv.d.cts.map +1 -0
  132. package/dist/{index-Dadljnh_.d.cts → index-D24Xm79M.d.cts} +19 -11
  133. package/dist/index-D24Xm79M.d.cts.map +1 -0
  134. package/dist/{index-CPeqtKgq.d.mts → index-_ajboYxK.d.mts} +26 -17
  135. package/dist/index-_ajboYxK.d.mts.map +1 -0
  136. package/dist/{index-Bt-F7u8L.d.mts → index-lAO9egTb.d.mts} +5 -5
  137. package/dist/{index-Bt-F7u8L.d.mts.map → index-lAO9egTb.d.mts.map} +1 -1
  138. package/dist/index.cjs +1 -1
  139. package/dist/index.d.cts +1 -1
  140. package/dist/index.d.mts +1 -1
  141. package/dist/index.mjs +1 -1
  142. package/dist/{lazyAccessors-DM6HcXQk.mjs → lazyAccessors-BoJN3SMd.mjs} +41 -2
  143. package/dist/lazyAccessors-BoJN3SMd.mjs.map +1 -0
  144. package/dist/{lazyAccessors-DrJj8NpA.cjs → lazyAccessors-e3j2oE2m.cjs} +52 -1
  145. package/dist/lazyAccessors-e3j2oE2m.cjs.map +1 -0
  146. package/dist/object-storage.d.cts +1 -1
  147. package/dist/object-storage.d.mts +1 -1
  148. package/dist/{processAudits-Bc8rz6Ev.cjs → processAudits-CGqttuXm.cjs} +1 -1
  149. package/dist/{processAudits-Bc8rz6Ev.cjs.map → processAudits-CGqttuXm.cjs.map} +1 -1
  150. package/dist/{processAudits-D89tICM4.mjs → processAudits-Dmts9H_b.mjs} +1 -1
  151. package/dist/{processAudits-D89tICM4.mjs.map → processAudits-Dmts9H_b.mjs.map} +1 -1
  152. package/dist/queue/index.cjs +1 -1
  153. package/dist/queue/index.d.cts +5 -5
  154. package/dist/queue/index.d.mts +5 -5
  155. package/dist/queue/index.mjs +1 -1
  156. package/dist/rest-api.cjs +6 -8
  157. package/dist/rest-api.cjs.map +1 -1
  158. package/dist/rest-api.d.cts +16 -24
  159. package/dist/rest-api.d.cts.map +1 -1
  160. package/dist/rest-api.d.mts +16 -24
  161. package/dist/rest-api.d.mts.map +1 -1
  162. package/dist/rest-api.mjs +6 -8
  163. package/dist/rest-api.mjs.map +1 -1
  164. package/dist/site.cjs +2 -2
  165. package/dist/site.cjs.map +1 -1
  166. package/dist/site.d.cts +9 -16
  167. package/dist/site.d.cts.map +1 -1
  168. package/dist/site.d.mts +9 -16
  169. package/dist/site.d.mts.map +1 -1
  170. package/dist/site.mjs +2 -2
  171. package/dist/site.mjs.map +1 -1
  172. package/dist/subscribers/index.cjs +6 -108
  173. package/dist/subscribers/index.d.cts +6 -63
  174. package/dist/subscribers/index.d.mts +6 -63
  175. package/dist/subscribers/index.mjs +5 -105
  176. package/dist/topic/index.cjs +1 -1
  177. package/dist/topic/index.d.cts +4 -32
  178. package/dist/topic/index.d.mts +4 -32
  179. package/dist/topic/index.mjs +1 -1
  180. package/dist/worker.cjs +166 -0
  181. package/dist/worker.cjs.map +1 -0
  182. package/dist/worker.d.cts +146 -0
  183. package/dist/worker.d.cts.map +1 -0
  184. package/dist/worker.d.mts +145 -0
  185. package/dist/worker.d.mts.map +1 -0
  186. package/dist/worker.mjs +165 -0
  187. package/dist/worker.mjs.map +1 -0
  188. package/package.json +58 -66
  189. package/dist/AWSScheduledFunction-BvFvBsBN.d.cts +0 -122
  190. package/dist/AWSScheduledFunction-BvFvBsBN.d.cts.map +0 -1
  191. package/dist/AWSScheduledFunction-CVccZO-L.d.mts +0 -122
  192. package/dist/AWSScheduledFunction-CVccZO-L.d.mts.map +0 -1
  193. package/dist/AWSScheduledFunction-Db1lttJH.mjs +0 -243
  194. package/dist/AWSScheduledFunction-Db1lttJH.mjs.map +0 -1
  195. package/dist/AWSScheduledFunction-qu4ieRZR.cjs +0 -255
  196. package/dist/AWSScheduledFunction-qu4ieRZR.cjs.map +0 -1
  197. package/dist/Construct-B-xc0SE9.d.mts.map +0 -1
  198. package/dist/Construct-HmWM6YYu.mjs.map +0 -1
  199. package/dist/Construct-WhCXIOPV.d.cts.map +0 -1
  200. package/dist/Construct-roId57cU.cjs.map +0 -1
  201. package/dist/EndpointFactory-DYoGLaIT.cjs.map +0 -1
  202. package/dist/EndpointFactory-Di0X9AWp.mjs.map +0 -1
  203. package/dist/functions-CvT_q7Y4.mjs.map +0 -1
  204. package/dist/functions-DukjG8ov.cjs.map +0 -1
  205. package/dist/index-CPeqtKgq.d.mts.map +0 -1
  206. package/dist/index-Dadljnh_.d.cts.map +0 -1
  207. package/dist/lazyAccessors-DM6HcXQk.mjs.map +0 -1
  208. package/dist/lazyAccessors-DrJj8NpA.cjs.map +0 -1
  209. package/dist/publisher-CGEo8UKD.mjs +0 -41
  210. package/dist/publisher-CGEo8UKD.mjs.map +0 -1
  211. package/dist/publisher-CqGsXB2X.cjs +0 -53
  212. package/dist/publisher-CqGsXB2X.cjs.map +0 -1
  213. package/dist/subscribers/index.cjs.map +0 -1
  214. package/dist/subscribers/index.d.cts.map +0 -1
  215. package/dist/subscribers/index.d.mts.map +0 -1
  216. package/dist/subscribers/index.mjs.map +0 -1
  217. package/dist/topic/index.d.cts.map +0 -1
  218. package/dist/topic/index.d.mts.map +0 -1
@@ -0,0 +1,165 @@
1
+ import "./Construct-BD5neF7w.mjs";
2
+ import { edgeTo } from "./construct-interface-Z4CpS8tK.mjs";
3
+ import { FunctionBuilder } from "./functions-14lpEFL4.mjs";
4
+ import "./clone-DblgEZZa.mjs";
5
+ import { envParserFor } from "./surfaceEnv-C3Ktahea.mjs";
6
+ import { CronBuilder } from "./CronBuilder-CYKT5RiO.mjs";
7
+ import { SubscriberBuilder } from "./SubscriberBuilder-BjkbeT9l.mjs";
8
+ import { canonicalId } from "@geekmidas/manifest";
9
+ import { DEFAULT_LOGGER } from "@geekmidas/logger/console";
10
+
11
+ //#region src/worker.ts
12
+ var Worker = class Worker {
13
+ id;
14
+ /** Always defined — the worker's own, or the console logger. */
15
+ logger;
16
+ /** Always defined, and normally the default. */
17
+ envParser;
18
+ /**
19
+ * Where this worker's schedules live, when it has crons and a server runs
20
+ * them. `undefined` until `.database(…)` says.
21
+ */
22
+ scheduleStore;
23
+ constructor(id, config = {}, dependencies = [], scheduleStore) {
24
+ this.config = config;
25
+ this.dependencies = dependencies;
26
+ const canonical = canonicalId(id);
27
+ this.id = canonical;
28
+ this.logger = config.logger ?? DEFAULT_LOGGER;
29
+ this.envParser = envParserFor(config.envParser ? {
30
+ id: canonical,
31
+ envParser: config.envParser
32
+ } : void 0);
33
+ this.scheduleStore = scheduleStore;
34
+ }
35
+ /**
36
+ * The database this worker keeps its schedules in.
37
+ *
38
+ * Only a server target uses it. On AWS a cron is an EventBridge rule
39
+ * invoking a Lambda and nothing here is consulted — but a server has nothing
40
+ * firing its crons except itself, and a process that schedules in memory
41
+ * fires every job once per replica while reporting that all is well.
42
+ *
43
+ * So the store is declared rather than discovered. It could have been
44
+ * inferred — from a database the app happens to declare, or from the events
45
+ * backend when that backend is pg-boss — and both would work until an app
46
+ * had two databases, or moved its events to SNS, at which point the
47
+ * schedules would quietly move or stop. Naming it is one line and cannot
48
+ * drift.
49
+ *
50
+ * @example
51
+ * ```ts
52
+ * export const jobs = new Worker('Jobs', { logger }).database(database);
53
+ * ```
54
+ */
55
+ database(source) {
56
+ return new Worker(this.id, this.config, [...this.dependencies, edgeTo(source)], source);
57
+ }
58
+ /**
59
+ * A scheduled runnable.
60
+ *
61
+ * @example `worker.cron('rate(1 day)').handle(async ({ logger }) => { … })`
62
+ */
63
+ cron(schedule) {
64
+ return this.own(new CronBuilder().logger(this.logger)).schedule(schedule);
65
+ }
66
+ /**
67
+ * A runnable that consumes a topic.
68
+ *
69
+ * Binding is not publishing: a consumer is handed the topic's event types
70
+ * and no connection string it could publish with. Chain `.publishes(…)` when
71
+ * the handler emits follow-up events, which is the only reason it would need
72
+ * one.
73
+ *
74
+ * @example `worker.topic(users).subscribe(['user.created']).handle(…)`
75
+ */
76
+ topic(topic) {
77
+ return this.own(new SubscriberBuilder().logger(this.logger)).topic(topic);
78
+ }
79
+ /**
80
+ * A runnable that consumes events typed from a publisher service.
81
+ *
82
+ * The older of the two ways to bind a subscriber, kept for a project whose
83
+ * events come from a hand-written publisher rather than a `Topic`
84
+ * construct. `topic()` is the one to reach for: it types the events the same
85
+ * way and hands the consumer no connection string it could publish with.
86
+ */
87
+ publisher(service) {
88
+ return this.own(new SubscriberBuilder().logger(this.logger)).publisher(service);
89
+ }
90
+ /**
91
+ * Everything below builds a function — the runnable with no schedule and no
92
+ * topic, invoked by something else.
93
+ *
94
+ * These sit on the worker rather than behind a `functions` namespace because
95
+ * the namespace was a hop that said nothing: `worker.functions.input(…)`
96
+ * names a collection to reach one member of it. What kind of runnable is
97
+ * being built is decided by which of these is called first — a schedule
98
+ * makes a cron, a topic makes a subscriber, and anything else makes a
99
+ * function.
100
+ */
101
+ input(schema) {
102
+ return this.functions.input(schema);
103
+ }
104
+ output(schema) {
105
+ return this.functions.output(schema);
106
+ }
107
+ timeout(ms) {
108
+ return this.functions.timeout(ms);
109
+ }
110
+ memorySize(mb) {
111
+ return this.functions.memorySize(mb);
112
+ }
113
+ dependsOn(constructs) {
114
+ return this.functions.dependsOn(constructs);
115
+ }
116
+ services(services) {
117
+ return this.functions.services(services);
118
+ }
119
+ /**
120
+ * A function with no input schema — the shortest runnable there is.
121
+ *
122
+ * @example `worker.handle(async ({ logger }) => { … })`
123
+ */
124
+ handle(...args) {
125
+ return this.schemalessFunction().handle(...args);
126
+ }
127
+ /** The builder `handle` delegates to, named so its type can be referred to. */
128
+ schemalessFunction() {
129
+ return this.functions;
130
+ }
131
+ /** The function builder the delegating methods above are built on. */
132
+ get functions() {
133
+ return this.own(new FunctionBuilder().logger(this.logger));
134
+ }
135
+ /**
136
+ * Resources and surfaces this worker calls.
137
+ *
138
+ * Not `.dependsOn()`: this records the edge that derives the worker's
139
+ * environment and its access, the same distinction `RestApi.calls()` draws.
140
+ */
141
+ calls(constructs) {
142
+ return new Worker(this.id, this.config, [...this.dependencies, ...constructs.map(edgeTo)], this.scheduleStore);
143
+ }
144
+ /**
145
+ * Stamps this worker's id onto a builder, so everything built from it says
146
+ * which process runs it.
147
+ */
148
+ own(builder) {
149
+ builder._owner = this.id;
150
+ builder._scheduleStore = this.scheduleStore;
151
+ return builder;
152
+ }
153
+ declare() {
154
+ return [{
155
+ kind: "worker",
156
+ id: this.id,
157
+ ...this.dependencies.length ? { dependencies: this.dependencies } : {},
158
+ provides: []
159
+ }];
160
+ }
161
+ };
162
+
163
+ //#endregion
164
+ export { Worker };
165
+ //# sourceMappingURL=worker.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"worker.mjs","names":["id: ConstructName<TName>","config: WorkerConfig","dependencies: readonly Dependency[]","scheduleStore?: Consumable<string, unknown>","source: Consumable<TDbName, T>","schedule: ScheduleExpression","topic: Topic<TTopicName, TEvents>","service: Service<TPubName, T> | Consumable<TPubName, T>","schema: T","ms: number","mb: number","constructs: T","services: T","constructs: readonly Declarable[]","builder: T"],"sources":["../src/worker.ts"],"sourcesContent":["/**\n * A process with no port.\n *\n * `RestApi` is the process that answers HTTP. This is the one that does not —\n * the thing that runs a schedule, drains a queue, consumes a topic. Until it\n * existed, those had nowhere to say they belonged: a cron declared a schedule\n * and nothing else, and which container ran it was decided by the directory the\n * file sat in. A glob owned it.\n *\n * The cost of that shows up in the scaffolds. `gkm init --template worker` —\n * a project that is background jobs and nothing else — declared\n * `new RestApi('Api', { defaultAuthorizer: 'none', logger })`: an HTTP surface\n * with no HTTP on it, written because it was the only construct that made an\n * app exist and the only way to get a logger into the generated runtime.\n *\n * It takes no authorizer, and that is the tell that these are two constructs\n * rather than one with a flag: a `RestApi` needs one because an HTTP surface\n * can ship open by omission, and nothing reaches a worker from outside.\n *\n * ## Crons on a server target need a database\n *\n * A cron becomes an EventBridge rule on AWS and nothing here is consulted. A\n * server has nothing firing its crons but itself, and a process that schedules\n * in memory fires every job once per replica while reporting success — so the\n * schedule is kept in Postgres, and the worker says which one with\n * `.database(db)`.\n *\n * A worker with crons and no `.database(…)` schedules nothing on a server\n * target and says so at startup. That is a limitation of workers today rather\n * than a design: the store could be a cache, or something the target\n * provisions, and Postgres is what exists.\n *\n * It is not an app. A worker names the process that runs its crons and\n * subscribers, and that process is the app's server — the same one the\n * endpoints run in, minus the HTTP surface. Giving a worker a container of its\n * own made a second thing to build, deploy and keep alive for work that was\n * always going to run somewhere already. Declare as many as the shape of the\n * work wants: they are groupings, not deployments.\n *\n * @example\n * ```ts\n * // constructs/worker.ts\n * import { Worker } from '@geekmidas/constructs/worker';\n * import { logger } from './logger.js';\n *\n * export const worker = new Worker('Worker', { logger }).calls([database]);\n *\n * // crons/cleanup.ts\n * import { worker } from '@acme/constructs/worker.js';\n *\n * export const cleanup = worker\n * .cron('rate(1 day)')\n * .handle(async ({ logger }) => { … });\n * ```\n */\n\nimport type { EnvironmentParser } from '@geekmidas/envkit';\nimport type { EventPublisher } from '@geekmidas/events';\nimport type { Logger } from '@geekmidas/logger';\nimport { DEFAULT_LOGGER } from '@geekmidas/logger/console';\nimport {\n\ttype ConstructName,\n\tcanonicalId,\n\ttype Declaration,\n\ttype Dependency,\n} from '@geekmidas/manifest';\nimport type { ComposableStandardSchema } from '@geekmidas/schema';\nimport type { Service } from '@geekmidas/services';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport {\n\ttype Consumable,\n\ttype Declarable,\n\tedgeTo,\n} from './construct-interface';\nimport type { ScheduleExpression } from './crons/Cron';\nimport { CronBuilder } from './crons/CronBuilder';\nimport { envParserFor } from './endpoints/surfaceEnv';\nimport { FunctionBuilder } from './functions/FunctionBuilder';\nimport { SubscriberBuilder } from './subscribers/SubscriberBuilder';\nimport type { Topic, TopicEvents } from './topic/Topic';\n\nexport interface WorkerConfig {\n\t/**\n\t * The logger everything built from this worker runs with.\n\t *\n\t * The actual logger, not a path to one — the same reason `RestApi` takes\n\t * one. Every cron and subscriber in a scaffolded project used to open with\n\t * `import { logger } from '…/constructs/logger.js'`, which is the line this\n\t * removes.\n\t */\n\tlogger?: Logger;\n\t/**\n\t * The environment parser everything built from this worker runs with.\n\t *\n\t * Defaults to `process.env` merged with the credentials `gkm dev` injected,\n\t * which is what an application's own `config/env.ts` always was.\n\t */\n\tenvParser?: EnvironmentParser<{}>;\n}\n\nexport class Worker<TName extends string = string>\n\timplements Declarable<TName>\n{\n\treadonly id: TName;\n\n\t/** Always defined — the worker's own, or the console logger. */\n\treadonly logger: Logger;\n\n\t/** Always defined, and normally the default. */\n\treadonly envParser: EnvironmentParser<{}>;\n\n\t/**\n\t * Where this worker's schedules live, when it has crons and a server runs\n\t * them. `undefined` until `.database(…)` says.\n\t */\n\treadonly scheduleStore?: Consumable<string, unknown>;\n\n\tconstructor(\n\t\tid: ConstructName<TName>,\n\t\tprivate readonly config: WorkerConfig = {},\n\t\t/** Internal: how `.calls()` carries edges into the copy it returns. */\n\t\tprivate readonly dependencies: readonly Dependency[] = [],\n\t\tscheduleStore?: Consumable<string, unknown>,\n\t) {\n\t\tconst canonical = canonicalId(id as string);\n\n\t\tthis.id = canonical as TName;\n\t\tthis.logger = config.logger ?? DEFAULT_LOGGER;\n\t\tthis.envParser = envParserFor(\n\t\t\tconfig.envParser\n\t\t\t\t? { id: canonical, envParser: config.envParser }\n\t\t\t\t: undefined,\n\t\t);\n\t\tthis.scheduleStore = scheduleStore;\n\t}\n\n\t/**\n\t * The database this worker keeps its schedules in.\n\t *\n\t * Only a server target uses it. On AWS a cron is an EventBridge rule\n\t * invoking a Lambda and nothing here is consulted — but a server has nothing\n\t * firing its crons except itself, and a process that schedules in memory\n\t * fires every job once per replica while reporting that all is well.\n\t *\n\t * So the store is declared rather than discovered. It could have been\n\t * inferred — from a database the app happens to declare, or from the events\n\t * backend when that backend is pg-boss — and both would work until an app\n\t * had two databases, or moved its events to SNS, at which point the\n\t * schedules would quietly move or stop. Naming it is one line and cannot\n\t * drift.\n\t *\n\t * @example\n\t * ```ts\n\t * export const jobs = new Worker('Jobs', { logger }).database(database);\n\t * ```\n\t */\n\tdatabase<T, TDbName extends string>(\n\t\tsource: Consumable<TDbName, T>,\n\t): Worker<TName> {\n\t\treturn new Worker<TName>(\n\t\t\tthis.id as ConstructName<TName>,\n\t\t\tthis.config,\n\t\t\t[...this.dependencies, edgeTo(source)],\n\t\t\tsource as unknown as Consumable<string, unknown>,\n\t\t);\n\t}\n\n\t/**\n\t * A scheduled runnable.\n\t *\n\t * @example `worker.cron('rate(1 day)').handle(async ({ logger }) => { … })`\n\t */\n\tcron(schedule: ScheduleExpression) {\n\t\treturn this.own(new CronBuilder().logger(this.logger)).schedule(schedule);\n\t}\n\n\t/**\n\t * A runnable that consumes a topic.\n\t *\n\t * Binding is not publishing: a consumer is handed the topic's event types\n\t * and no connection string it could publish with. Chain `.publishes(…)` when\n\t * the handler emits follow-up events, which is the only reason it would need\n\t * one.\n\t *\n\t * @example `worker.topic(users).subscribe(['user.created']).handle(…)`\n\t */\n\ttopic<TTopicName extends string, TEvents extends TopicEvents>(\n\t\ttopic: Topic<TTopicName, TEvents>,\n\t) {\n\t\treturn this.own(new SubscriberBuilder().logger(this.logger)).topic(topic);\n\t}\n\n\t/**\n\t * A runnable that consumes events typed from a publisher service.\n\t *\n\t * The older of the two ways to bind a subscriber, kept for a project whose\n\t * events come from a hand-written publisher rather than a `Topic`\n\t * construct. `topic()` is the one to reach for: it types the events the same\n\t * way and hands the consumer no connection string it could publish with.\n\t */\n\tpublisher<T extends EventPublisher<any>, TPubName extends string>(\n\t\tservice: Service<TPubName, T> | Consumable<TPubName, T>,\n\t) {\n\t\treturn this.own(new SubscriberBuilder().logger(this.logger)).publisher(\n\t\t\tservice as never,\n\t\t);\n\t}\n\n\t/**\n\t * Everything below builds a function — the runnable with no schedule and no\n\t * topic, invoked by something else.\n\t *\n\t * These sit on the worker rather than behind a `functions` namespace because\n\t * the namespace was a hop that said nothing: `worker.functions.input(…)`\n\t * names a collection to reach one member of it. What kind of runnable is\n\t * being built is decided by which of these is called first — a schedule\n\t * makes a cron, a topic makes a subscriber, and anything else makes a\n\t * function.\n\t */\n\tinput<T extends ComposableStandardSchema>(schema: T) {\n\t\treturn this.functions.input(schema);\n\t}\n\n\toutput<T extends StandardSchemaV1>(schema: T) {\n\t\treturn this.functions.output(schema);\n\t}\n\n\ttimeout(ms: number) {\n\t\treturn this.functions.timeout(ms);\n\t}\n\n\tmemorySize(mb: number) {\n\t\treturn this.functions.memorySize(mb);\n\t}\n\n\tdependsOn<const T extends readonly Consumable[]>(constructs: T) {\n\t\treturn this.functions.dependsOn(constructs);\n\t}\n\n\tservices<T extends Service[]>(services: T) {\n\t\treturn this.functions.services(services);\n\t}\n\n\t/**\n\t * A function with no input schema — the shortest runnable there is.\n\t *\n\t * @example `worker.handle(async ({ logger }) => { … })`\n\t */\n\thandle(\n\t\t...args: Parameters<\n\t\t\tReturnType<Worker<TName>['schemalessFunction']>['handle']\n\t\t>\n\t) {\n\t\treturn this.schemalessFunction().handle(...args);\n\t}\n\n\t/** The builder `handle` delegates to, named so its type can be referred to. */\n\tprivate schemalessFunction() {\n\t\treturn this.functions;\n\t}\n\n\t/** The function builder the delegating methods above are built on. */\n\tprivate get functions() {\n\t\treturn this.own(new FunctionBuilder().logger(this.logger));\n\t}\n\n\t/**\n\t * Resources and surfaces this worker calls.\n\t *\n\t * Not `.dependsOn()`: this records the edge that derives the worker's\n\t * environment and its access, the same distinction `RestApi.calls()` draws.\n\t */\n\tcalls(constructs: readonly Declarable[]): Worker<TName> {\n\t\treturn new Worker<TName>(\n\t\t\tthis.id as ConstructName<TName>,\n\t\t\tthis.config,\n\t\t\t[...this.dependencies, ...constructs.map(edgeTo)],\n\t\t\tthis.scheduleStore,\n\t\t);\n\t}\n\n\t/**\n\t * Stamps this worker's id onto a builder, so everything built from it says\n\t * which process runs it.\n\t */\n\tprivate own<T extends { _owner?: string; _scheduleStore?: unknown }>(\n\t\tbuilder: T,\n\t): T {\n\t\tbuilder._owner = this.id;\n\t\tbuilder._scheduleStore = this.scheduleStore;\n\n\t\treturn builder;\n\t}\n\n\tdeclare(): Declaration[] {\n\t\treturn [\n\t\t\t{\n\t\t\t\tkind: 'worker',\n\t\t\t\tid: this.id,\n\t\t\t\t...(this.dependencies.length\n\t\t\t\t\t? { dependencies: this.dependencies }\n\t\t\t\t\t: {}),\n\t\t\t\t// Nothing calls a worker, so it publishes no address.\n\t\t\t\tprovides: [],\n\t\t\t},\n\t\t];\n\t}\n}\n"],"mappings":";;;;;;;;;;;AAoGA,IAAa,SAAb,MAAa,OAEb;CACC,AAAS;;CAGT,AAAS;;CAGT,AAAS;;;;;CAMT,AAAS;CAET,YACCA,IACiBC,SAAuB,CAAE,GAEzBC,eAAsC,CAAE,GACzDC,eACC;EAJgB;EAEA;EAGjB,MAAM,YAAY,YAAY,GAAa;AAE3C,OAAK,KAAK;AACV,OAAK,SAAS,OAAO,UAAU;AAC/B,OAAK,YAAY,aAChB,OAAO,YACJ;GAAE,IAAI;GAAW,WAAW,OAAO;EAAW,WAEjD;AACD,OAAK,gBAAgB;CACrB;;;;;;;;;;;;;;;;;;;;;CAsBD,SACCC,QACgB;AAChB,SAAO,IAAI,OACV,KAAK,IACL,KAAK,QACL,CAAC,GAAG,KAAK,cAAc,OAAO,OAAO,AAAC,GACtC;CAED;;;;;;CAOD,KAAKC,UAA8B;AAClC,SAAO,KAAK,IAAI,IAAI,cAAc,OAAO,KAAK,OAAO,CAAC,CAAC,SAAS,SAAS;CACzE;;;;;;;;;;;CAYD,MACCC,OACC;AACD,SAAO,KAAK,IAAI,IAAI,oBAAoB,OAAO,KAAK,OAAO,CAAC,CAAC,MAAM,MAAM;CACzE;;;;;;;;;CAUD,UACCC,SACC;AACD,SAAO,KAAK,IAAI,IAAI,oBAAoB,OAAO,KAAK,OAAO,CAAC,CAAC,UAC5D,QACA;CACD;;;;;;;;;;;;CAaD,MAA0CC,QAAW;AACpD,SAAO,KAAK,UAAU,MAAM,OAAO;CACnC;CAED,OAAmCA,QAAW;AAC7C,SAAO,KAAK,UAAU,OAAO,OAAO;CACpC;CAED,QAAQC,IAAY;AACnB,SAAO,KAAK,UAAU,QAAQ,GAAG;CACjC;CAED,WAAWC,IAAY;AACtB,SAAO,KAAK,UAAU,WAAW,GAAG;CACpC;CAED,UAAiDC,YAAe;AAC/D,SAAO,KAAK,UAAU,UAAU,WAAW;CAC3C;CAED,SAA8BC,UAAa;AAC1C,SAAO,KAAK,UAAU,SAAS,SAAS;CACxC;;;;;;CAOD,OACC,GAAG,MAGF;AACD,SAAO,KAAK,oBAAoB,CAAC,OAAO,GAAG,KAAK;CAChD;;CAGD,AAAQ,qBAAqB;AAC5B,SAAO,KAAK;CACZ;;CAGD,IAAY,YAAY;AACvB,SAAO,KAAK,IAAI,IAAI,kBAAkB,OAAO,KAAK,OAAO,CAAC;CAC1D;;;;;;;CAQD,MAAMC,YAAkD;AACvD,SAAO,IAAI,OACV,KAAK,IACL,KAAK,QACL,CAAC,GAAG,KAAK,cAAc,GAAG,WAAW,IAAI,OAAO,AAAC,GACjD,KAAK;CAEN;;;;;CAMD,AAAQ,IACPC,SACI;AACJ,UAAQ,SAAS,KAAK;AACtB,UAAQ,iBAAiB,KAAK;AAE9B,SAAO;CACP;CAED,UAAyB;AACxB,SAAO,CACN;GACC,MAAM;GACN,IAAI,KAAK;GACT,GAAI,KAAK,aAAa,SACnB,EAAE,cAAc,KAAK,aAAc,IACnC,CAAE;GAEL,UAAU,CAAE;EACZ,CACD;CACD;AACD"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@geekmidas/constructs",
3
- "version": "10.0.0-alpha.0",
3
+ "version": "10.0.0-alpha.10",
4
4
  "private": false,
5
5
  "type": "module",
6
6
  "exports": {
@@ -204,6 +204,16 @@
204
204
  "default": "./dist/site.cjs"
205
205
  }
206
206
  },
207
+ "./worker": {
208
+ "import": {
209
+ "types": "./dist/worker.d.mts",
210
+ "default": "./dist/worker.mjs"
211
+ },
212
+ "require": {
213
+ "types": "./dist/worker.d.cts",
214
+ "default": "./dist/worker.cjs"
215
+ }
216
+ },
207
217
  "./database/kysely": {
208
218
  "import": {
209
219
  "types": "./dist/database/kysely.d.mts",
@@ -234,7 +244,14 @@
234
244
  "lodash.set": "~4.3.2",
235
245
  "lodash.uniqby": "~4.7.0",
236
246
  "openapi-types": "~12.1.3",
237
- "qs": "~6.15.0"
247
+ "qs": "~6.16.0",
248
+ "@geekmidas/envkit": "^10.0.0-alpha.10",
249
+ "@geekmidas/errors": "^10.0.0-alpha.10",
250
+ "@geekmidas/events": "^10.0.0-alpha.10",
251
+ "@geekmidas/logger": "^10.0.0-alpha.10",
252
+ "@geekmidas/manifest": "^10.0.0-alpha.10",
253
+ "@geekmidas/schema": "^10.0.0-alpha.10",
254
+ "@geekmidas/services": "^10.0.0-alpha.10"
238
255
  },
239
256
  "devDependencies": {
240
257
  "@types/lodash.compact": "~3.0.9",
@@ -242,51 +259,44 @@
242
259
  "@types/lodash.pick": "~4.4.9",
243
260
  "@types/lodash.set": "~4.3.9",
244
261
  "@types/lodash.uniqby": "~4.7.9",
245
- "@types/pg": "~8.15.6",
246
- "@types/qs": "~6.15.0",
247
- "better-auth": "~1.4.18",
248
- "kysely": "~0.29.4",
249
- "msw": "~2.10.3",
250
- "pg": "~8.16.3",
251
- "zod": "~4.1.13",
252
- "@geekmidas/audit": "^10.0.0-alpha.0",
253
- "@geekmidas/auth": "10.0.0-alpha.0",
254
- "@geekmidas/cache": "^10.0.0-alpha.0",
255
- "@geekmidas/db": "^10.0.0-alpha.0",
256
- "@geekmidas/emailkit": "^10.0.0-alpha.0",
257
- "@geekmidas/envkit": "^10.0.0-alpha.0",
258
- "@geekmidas/errors": "^10.0.0-alpha.0",
259
- "@geekmidas/events": "^10.0.0-alpha.0",
260
- "@geekmidas/logger": "^10.0.0-alpha.0",
261
- "@geekmidas/rate-limit": "^10.0.0-alpha.0",
262
- "@geekmidas/schema": "^10.0.0-alpha.0",
263
- "@geekmidas/services": "^10.0.0-alpha.0",
264
- "@geekmidas/telescope": "10.0.0-alpha.0",
265
- "@geekmidas/testkit": "^10.0.0-alpha.0"
262
+ "@types/pg": "~8.23.1",
263
+ "@types/qs": "~6.15.1",
264
+ "better-auth": "~1.7.5",
265
+ "kysely": "~0.29.6",
266
+ "msw": "~2.15.0",
267
+ "pg": "~8.23.0",
268
+ "zod": "~4.6.5",
269
+ "@geekmidas/audit": "^10.0.0-alpha.10",
270
+ "@geekmidas/auth": "10.0.0-alpha.10",
271
+ "@geekmidas/cache": "^10.0.0-alpha.10",
272
+ "@geekmidas/db": "^10.0.0-alpha.10",
273
+ "@geekmidas/emailkit": "^10.0.0-alpha.10",
274
+ "@geekmidas/envkit": "^10.0.0-alpha.10",
275
+ "@geekmidas/errors": "^10.0.0-alpha.10",
276
+ "@geekmidas/events": "^10.0.0-alpha.10",
277
+ "@geekmidas/logger": "^10.0.0-alpha.10",
278
+ "@geekmidas/rate-limit": "^10.0.0-alpha.10",
279
+ "@geekmidas/schema": "^10.0.0-alpha.10",
280
+ "@geekmidas/services": "^10.0.0-alpha.10",
281
+ "@geekmidas/telescope": "10.0.0-alpha.10",
282
+ "@geekmidas/testkit": "^10.0.0-alpha.10"
266
283
  },
267
284
  "peerDependencies": {
268
- "@middy/core": ">=6.3.1",
269
- "@types/aws-lambda": ">=8.10.92",
270
- "better-auth": ">=1.4.18",
271
- "hono": ">=4.8.2",
272
- "kysely": ">=0.28.2 <0.30.0",
273
- "msw": ">=2.0.0",
274
- "pg": "~8.16.3",
275
- "@geekmidas/audit": "^10.0.0-alpha.0",
276
- "@geekmidas/auth": "10.0.0-alpha.0",
277
- "@geekmidas/cache": "^10.0.0-alpha.0",
278
- "@geekmidas/db": "^10.0.0-alpha.0",
279
- "@geekmidas/emailkit": "^10.0.0-alpha.0",
280
- "@geekmidas/envkit": "^10.0.0-alpha.0",
281
- "@geekmidas/errors": "^10.0.0-alpha.0",
282
- "@geekmidas/events": "^10.0.0-alpha.0",
283
- "@geekmidas/logger": "^10.0.0-alpha.0",
284
- "@geekmidas/manifest": "^10.0.0-alpha.0",
285
- "@geekmidas/rate-limit": "^10.0.0-alpha.0",
286
- "@geekmidas/schema": "^10.0.0-alpha.0",
287
- "@geekmidas/services": "^10.0.0-alpha.0",
288
- "@geekmidas/storage": "^10.0.0-alpha.0",
289
- "@geekmidas/telescope": "10.0.0-alpha.0"
285
+ "@middy/core": ">=7.9.2",
286
+ "@types/aws-lambda": ">=8.10.163",
287
+ "better-auth": ">=1.7.5",
288
+ "hono": ">=4.13.8",
289
+ "kysely": "~0.29.6",
290
+ "msw": ">=2.15.0",
291
+ "pg": ">=8.23.0",
292
+ "@geekmidas/audit": "^10.0.0-alpha.10",
293
+ "@geekmidas/auth": "10.0.0-alpha.10",
294
+ "@geekmidas/cache": "^10.0.0-alpha.10",
295
+ "@geekmidas/db": "^10.0.0-alpha.10",
296
+ "@geekmidas/emailkit": "^10.0.0-alpha.10",
297
+ "@geekmidas/rate-limit": "^10.0.0-alpha.10",
298
+ "@geekmidas/storage": "^10.0.0-alpha.10",
299
+ "@geekmidas/telescope": "10.0.0-alpha.10"
290
300
  },
291
301
  "peerDependenciesMeta": {
292
302
  "@geekmidas/audit": {
@@ -298,27 +308,9 @@
298
308
  "@geekmidas/db": {
299
309
  "optional": true
300
310
  },
301
- "@geekmidas/envkit": {
302
- "optional": true
303
- },
304
- "@geekmidas/errors": {
305
- "optional": true
306
- },
307
- "@geekmidas/events": {
308
- "optional": true
309
- },
310
- "@geekmidas/logger": {
311
- "optional": true
312
- },
313
311
  "@geekmidas/rate-limit": {
314
312
  "optional": true
315
313
  },
316
- "@geekmidas/schema": {
317
- "optional": true
318
- },
319
- "@geekmidas/services": {
320
- "optional": true
321
- },
322
314
  "@middy/core": {
323
315
  "optional": true
324
316
  },
@@ -331,9 +323,6 @@
331
323
  "msw": {
332
324
  "optional": true
333
325
  },
334
- "@geekmidas/manifest": {
335
- "optional": true
336
- },
337
326
  "@geekmidas/storage": {
338
327
  "optional": true
339
328
  },
@@ -348,6 +337,9 @@
348
337
  },
349
338
  "better-auth": {
350
339
  "optional": true
340
+ },
341
+ "@geekmidas/telescope": {
342
+ "optional": true
351
343
  }
352
344
  },
353
345
  "scripts": {
@@ -1,122 +0,0 @@
1
- import { Function, FunctionHandler } from "./index-Dadljnh_.cjs";
2
- import { EnvironmentParser } from "@geekmidas/envkit";
3
- import { EventPublisher } from "@geekmidas/events";
4
- import { Logger } from "@geekmidas/logger";
5
- import { ComposableStandardSchema, InferComposableStandardSchema, InferStandardSchema } from "@geekmidas/schema";
6
- import { Service, ServiceDiscovery, ServiceRecord } from "@geekmidas/services";
7
- import { StandardSchemaV1 } from "@standard-schema/spec";
8
- import { AuditStorage, AuditableAction, Auditor } from "@geekmidas/audit";
9
- import { Handler } from "aws-lambda";
10
-
11
- //#region src/functions/FunctionExecutionWrapper.d.ts
12
- declare abstract class FunctionExecutionWrapper<TInput extends ComposableStandardSchema | undefined = undefined, TOutSchema extends StandardSchemaV1 | undefined = undefined, TServices extends Service[] = [], TLogger extends Logger = Logger, TEventPublisher extends EventPublisher<any> | undefined = undefined, TEventPublisherServiceName extends string = string, TAuditStorage extends AuditStorage | undefined = undefined, TAuditStorageServiceName extends string = string, TDatabase = undefined, TDatabaseServiceName extends string = string, TAuditAction extends AuditableAction<string, unknown> = AuditableAction<string, unknown>> {
13
- protected envParser: EnvironmentParser<{}>;
14
- protected readonly fn: Function<TInput, TServices, TLogger, TOutSchema, TEventPublisher, TEventPublisherServiceName, TAuditStorage, TAuditStorageServiceName, TDatabase, TDatabaseServiceName, TAuditAction, FunctionHandler<TInput, TServices, TLogger, TOutSchema, TDatabase, TAuditStorage, TAuditAction>>;
15
- constructor(envParser: EnvironmentParser<{}>, fn: Function<TInput, TServices, TLogger, TOutSchema, TEventPublisher, TEventPublisherServiceName, TAuditStorage, TAuditStorageServiceName, TDatabase, TDatabaseServiceName, TAuditAction, FunctionHandler<TInput, TServices, TLogger, TOutSchema, TDatabase, TAuditStorage, TAuditAction>>);
16
- protected _logger?: TLogger;
17
- get logger(): TLogger;
18
- get serviceDiscovery(): ServiceDiscovery<ServiceRecord<TServices>>;
19
- getServices(): Promise<ServiceRecord<TServices>>;
20
- getDatabase(): Promise<TDatabase | undefined>;
21
- /**
22
- * Get the audit storage service if configured.
23
- * Returns undefined if no auditor storage is configured.
24
- */
25
- getAuditStorage(): Promise<TAuditStorage | undefined>;
26
- /**
27
- * Create an auditor instance for the function.
28
- * Returns undefined if no auditor storage is configured.
29
- */
30
- createAuditor(): Promise<Auditor<TAuditAction> | undefined>;
31
- /**
32
- * Execute handler with audit transaction support.
33
- * If the audit storage has a database (via getDatabase()), wraps execution
34
- * in a transaction so audits are atomic with handler's database operations.
35
- *
36
- * @param handler - The handler function to execute (receives auditor and db)
37
- * @returns The handler result
38
- */
39
- executeWithAudit<T>(handler: (ctx: {
40
- auditor?: Auditor<TAuditAction>;
41
- db?: TDatabase;
42
- }) => Promise<T>): Promise<T>;
43
- getFunctionInput<TEvent>(event: TEvent): Promise<InferComposableStandardSchema<TInput>>;
44
- publishEvents(response: InferStandardSchema<TOutSchema>): Promise<void>;
45
- parseComposableStandardSchema<T extends ComposableStandardSchema>(data: unknown, schema: T): Promise<InferComposableStandardSchema<T>>;
46
- }
47
- //# sourceMappingURL=FunctionExecutionWrapper.d.ts.map
48
- //#endregion
49
- //#region src/functions/AWSLambdaFunction.d.ts
50
- type AWSLambdaHandler<TEvent = any, TResult = any> = Handler<TEvent, TResult>;
51
- declare class AWSLambdaFunction<TInput extends ComposableStandardSchema | undefined = undefined, TOutSchema extends StandardSchemaV1 | undefined = undefined, TServices extends Service[] = [], TLogger extends Logger = Logger, TEventPublisher extends EventPublisher<any> | undefined = undefined, TEventPublisherServiceName extends string = string, TAuditStorage extends AuditStorage | undefined = undefined, TAuditStorageServiceName extends string = string, TDatabase = undefined, TDatabaseServiceName extends string = string, TAuditAction extends AuditableAction<string, unknown> = AuditableAction<string, unknown>> extends FunctionExecutionWrapper<TInput, TOutSchema, TServices, TLogger, TEventPublisher, TEventPublisherServiceName, TAuditStorage, TAuditStorageServiceName, TDatabase, TDatabaseServiceName, TAuditAction> {
52
- readonly fn: Function<TInput, TServices, TLogger, TOutSchema, TEventPublisher, TEventPublisherServiceName, TAuditStorage, TAuditStorageServiceName, TDatabase, TDatabaseServiceName, TAuditAction, FunctionHandler<TInput, TServices, TLogger, TOutSchema, TDatabase, TAuditStorage, TAuditAction>>;
53
- constructor(envParser: EnvironmentParser<{}>, fn: Function<TInput, TServices, TLogger, TOutSchema, TEventPublisher, TEventPublisherServiceName, TAuditStorage, TAuditStorageServiceName, TDatabase, TDatabaseServiceName, TAuditAction, FunctionHandler<TInput, TServices, TLogger, TOutSchema, TDatabase, TAuditStorage, TAuditAction>>);
54
- private error;
55
- private baseInput;
56
- private input;
57
- private loggerMiddleware;
58
- private services;
59
- private database;
60
- private auditor;
61
- private events;
62
- private _handler;
63
- get handler(): AWSLambdaHandler;
64
- }
65
- //# sourceMappingURL=AWSLambdaFunction.d.ts.map
66
- //#endregion
67
- //#region src/crons/Cron.d.ts
68
- declare class Cron<TInput extends ComposableStandardSchema | undefined = undefined, 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 Function<TInput, TServices, TLogger, OutSchema, TEventPublisher, TEventPublisherServiceName, undefined, string, TDatabase, TDatabaseServiceName, AuditableAction<string, unknown>, FunctionHandler<TInput, TServices, TLogger, OutSchema, TDatabase>> {
69
- protected _schedule?: ScheduleExpression | undefined;
70
- static isCron(obj: any): obj is Cron<any, any, any, any>;
71
- constructor(fn: FunctionHandler<TInput, TServices, TLogger, OutSchema, TDatabase>, timeout?: number, _schedule?: ScheduleExpression | undefined, input?: TInput, outputSchema?: OutSchema, services?: TServices, logger?: TLogger, publisherService?: Service<TEventPublisherServiceName, TEventPublisher>, events?: any[], memorySize?: number, databaseService?: Service<TDatabaseServiceName, TDatabase>,
72
- /**
73
- * The construct ids `.dependsOn()` named — last, so no existing positional
74
- * argument moves.
75
- */
76
- constructs?: string[]);
77
- get schedule(): ScheduleExpression | undefined;
78
- }
79
- type RateExpression = `rate(${string})`;
80
- type CronMinute = '*' | number | `${number}` | `${number}-${number}` | `${number}/${number}` | `*/${number}` | `${number},${number}` | string;
81
- type CronHour = '*' | number | `${number}` | `${number}-${number}` | `${number}/${number}` | `*/${number}` | `${number},${number}` | string;
82
- type CronDay = '*' | number | `${number}` | `${number}-${number}` | `${number}/${number}` | `*/${number}` | `${number},${number}` | string;
83
- type CronMonth = '*' | number | `${number}` | `${number}-${number}` | `${number}/${number}` | `*/${number}` | 'JAN' | 'FEB' | 'MAR' | 'APR' | 'MAY' | 'JUN' | 'JUL' | 'AUG' | 'SEP' | 'OCT' | 'NOV' | 'DEC' | string;
84
- type CronWeekday = '*' | number | `${number}` | `${number}-${number}` | `${number}/${number}` | `*/${number}` | 'SUN' | 'MON' | 'TUE' | 'WED' | 'THU' | 'FRI' | 'SAT' | `${string}-${string}` | string;
85
- type CronExpression = `cron(${CronMinute} ${CronHour} ${CronDay} ${CronMonth} ${CronWeekday})`;
86
- type ScheduleExpression = RateExpression | CronExpression;
87
- //#endregion
88
- //#region src/crons/AWSScheduledFunction.d.ts
89
- /**
90
- * AWS Lambda adaptor for {@link Cron} constructs.
91
- *
92
- * A `Cron` is a {@link import('../functions').Function} that is invoked on a
93
- * schedule (an EventBridge rule) rather than by an API request. Because of
94
- * that, the runtime execution pipeline is identical to a regular Lambda
95
- * function: input parsing, service/database/auditor wiring, event publishing,
96
- * error handling, and the `runWithRequestContext` wrapper that powers
97
- * request-scoped logging via `serviceContext.getLogger()`.
98
- *
99
- * This adaptor therefore reuses {@link AWSLambdaFunction} wholesale and only
100
- * narrows the constructor to accept a `Cron`. The schedule expression itself
101
- * (`cron.schedule`) is **deploy-time** infrastructure consumed by the CLI to
102
- * provision the EventBridge rule — it is not needed at runtime.
103
- *
104
- * @example
105
- * ```typescript
106
- * import { AWSScheduledFunction } from '@geekmidas/constructs/crons';
107
- * import { cancelPastBookings } from '../../../src/crons/cancelPastBookings.js';
108
- * import { envParser } from '../../../src/env';
109
- *
110
- * const adapter = new AWSScheduledFunction(envParser, cancelPastBookings);
111
- *
112
- * export const handler = adapter.handler;
113
- * ```
114
- */
115
- declare class AWSScheduledFunction<TInput extends ComposableStandardSchema | undefined = undefined, TServices extends Service[] = [], TLogger extends Logger = Logger, TOutSchema extends StandardSchemaV1 | undefined = undefined, TEventPublisher extends EventPublisher<any> | undefined = undefined, TEventPublisherServiceName extends string = string, TDatabase = undefined, TDatabaseServiceName extends string = string> extends AWSLambdaFunction<TInput, TOutSchema, TServices, TLogger, TEventPublisher, TEventPublisherServiceName, undefined, string, TDatabase, TDatabaseServiceName> {
116
- constructor(envParser: EnvironmentParser<{}>, cron: Cron<TInput, TServices, TLogger, TOutSchema, TEventPublisher, TEventPublisherServiceName, TDatabase, TDatabaseServiceName>);
117
- }
118
- //# sourceMappingURL=AWSScheduledFunction.d.ts.map
119
-
120
- //#endregion
121
- export { AWSLambdaFunction, AWSScheduledFunction, Cron, CronExpression, RateExpression, ScheduleExpression };
122
- //# sourceMappingURL=AWSScheduledFunction-BvFvBsBN.d.cts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"AWSScheduledFunction-BvFvBsBN.d.cts","names":[],"sources":["../src/functions/FunctionExecutionWrapper.ts","../src/functions/AWSLambdaFunction.ts","../src/crons/Cron.ts","../src/crons/AWSScheduledFunction.ts"],"sourcesContent":[],"mappings":"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"}
@@ -1,122 +0,0 @@
1
- import { Function, FunctionHandler } from "./index-CPeqtKgq.mjs";
2
- import { EnvironmentParser } from "@geekmidas/envkit";
3
- import { Service, ServiceDiscovery, ServiceRecord } from "@geekmidas/services";
4
- import { AuditStorage, AuditableAction, Auditor } from "@geekmidas/audit";
5
- import { EventPublisher } from "@geekmidas/events";
6
- import { Logger } from "@geekmidas/logger";
7
- import { ComposableStandardSchema, InferComposableStandardSchema, InferStandardSchema } from "@geekmidas/schema";
8
- import { StandardSchemaV1 } from "@standard-schema/spec";
9
- import { Handler } from "aws-lambda";
10
-
11
- //#region src/functions/FunctionExecutionWrapper.d.ts
12
- declare abstract class FunctionExecutionWrapper<TInput extends ComposableStandardSchema | undefined = undefined, TOutSchema extends StandardSchemaV1 | undefined = undefined, TServices extends Service[] = [], TLogger extends Logger = Logger, TEventPublisher extends EventPublisher<any> | undefined = undefined, TEventPublisherServiceName extends string = string, TAuditStorage extends AuditStorage | undefined = undefined, TAuditStorageServiceName extends string = string, TDatabase = undefined, TDatabaseServiceName extends string = string, TAuditAction extends AuditableAction<string, unknown> = AuditableAction<string, unknown>> {
13
- protected envParser: EnvironmentParser<{}>;
14
- protected readonly fn: Function<TInput, TServices, TLogger, TOutSchema, TEventPublisher, TEventPublisherServiceName, TAuditStorage, TAuditStorageServiceName, TDatabase, TDatabaseServiceName, TAuditAction, FunctionHandler<TInput, TServices, TLogger, TOutSchema, TDatabase, TAuditStorage, TAuditAction>>;
15
- constructor(envParser: EnvironmentParser<{}>, fn: Function<TInput, TServices, TLogger, TOutSchema, TEventPublisher, TEventPublisherServiceName, TAuditStorage, TAuditStorageServiceName, TDatabase, TDatabaseServiceName, TAuditAction, FunctionHandler<TInput, TServices, TLogger, TOutSchema, TDatabase, TAuditStorage, TAuditAction>>);
16
- protected _logger?: TLogger;
17
- get logger(): TLogger;
18
- get serviceDiscovery(): ServiceDiscovery<ServiceRecord<TServices>>;
19
- getServices(): Promise<ServiceRecord<TServices>>;
20
- getDatabase(): Promise<TDatabase | undefined>;
21
- /**
22
- * Get the audit storage service if configured.
23
- * Returns undefined if no auditor storage is configured.
24
- */
25
- getAuditStorage(): Promise<TAuditStorage | undefined>;
26
- /**
27
- * Create an auditor instance for the function.
28
- * Returns undefined if no auditor storage is configured.
29
- */
30
- createAuditor(): Promise<Auditor<TAuditAction> | undefined>;
31
- /**
32
- * Execute handler with audit transaction support.
33
- * If the audit storage has a database (via getDatabase()), wraps execution
34
- * in a transaction so audits are atomic with handler's database operations.
35
- *
36
- * @param handler - The handler function to execute (receives auditor and db)
37
- * @returns The handler result
38
- */
39
- executeWithAudit<T>(handler: (ctx: {
40
- auditor?: Auditor<TAuditAction>;
41
- db?: TDatabase;
42
- }) => Promise<T>): Promise<T>;
43
- getFunctionInput<TEvent>(event: TEvent): Promise<InferComposableStandardSchema<TInput>>;
44
- publishEvents(response: InferStandardSchema<TOutSchema>): Promise<void>;
45
- parseComposableStandardSchema<T extends ComposableStandardSchema>(data: unknown, schema: T): Promise<InferComposableStandardSchema<T>>;
46
- }
47
- //# sourceMappingURL=FunctionExecutionWrapper.d.ts.map
48
- //#endregion
49
- //#region src/functions/AWSLambdaFunction.d.ts
50
- type AWSLambdaHandler<TEvent = any, TResult = any> = Handler<TEvent, TResult>;
51
- declare class AWSLambdaFunction<TInput extends ComposableStandardSchema | undefined = undefined, TOutSchema extends StandardSchemaV1 | undefined = undefined, TServices extends Service[] = [], TLogger extends Logger = Logger, TEventPublisher extends EventPublisher<any> | undefined = undefined, TEventPublisherServiceName extends string = string, TAuditStorage extends AuditStorage | undefined = undefined, TAuditStorageServiceName extends string = string, TDatabase = undefined, TDatabaseServiceName extends string = string, TAuditAction extends AuditableAction<string, unknown> = AuditableAction<string, unknown>> extends FunctionExecutionWrapper<TInput, TOutSchema, TServices, TLogger, TEventPublisher, TEventPublisherServiceName, TAuditStorage, TAuditStorageServiceName, TDatabase, TDatabaseServiceName, TAuditAction> {
52
- readonly fn: Function<TInput, TServices, TLogger, TOutSchema, TEventPublisher, TEventPublisherServiceName, TAuditStorage, TAuditStorageServiceName, TDatabase, TDatabaseServiceName, TAuditAction, FunctionHandler<TInput, TServices, TLogger, TOutSchema, TDatabase, TAuditStorage, TAuditAction>>;
53
- constructor(envParser: EnvironmentParser<{}>, fn: Function<TInput, TServices, TLogger, TOutSchema, TEventPublisher, TEventPublisherServiceName, TAuditStorage, TAuditStorageServiceName, TDatabase, TDatabaseServiceName, TAuditAction, FunctionHandler<TInput, TServices, TLogger, TOutSchema, TDatabase, TAuditStorage, TAuditAction>>);
54
- private error;
55
- private baseInput;
56
- private input;
57
- private loggerMiddleware;
58
- private services;
59
- private database;
60
- private auditor;
61
- private events;
62
- private _handler;
63
- get handler(): AWSLambdaHandler;
64
- }
65
- //# sourceMappingURL=AWSLambdaFunction.d.ts.map
66
- //#endregion
67
- //#region src/crons/Cron.d.ts
68
- declare class Cron<TInput extends ComposableStandardSchema | undefined = undefined, 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 Function<TInput, TServices, TLogger, OutSchema, TEventPublisher, TEventPublisherServiceName, undefined, string, TDatabase, TDatabaseServiceName, AuditableAction<string, unknown>, FunctionHandler<TInput, TServices, TLogger, OutSchema, TDatabase>> {
69
- protected _schedule?: ScheduleExpression | undefined;
70
- static isCron(obj: any): obj is Cron<any, any, any, any>;
71
- constructor(fn: FunctionHandler<TInput, TServices, TLogger, OutSchema, TDatabase>, timeout?: number, _schedule?: ScheduleExpression | undefined, input?: TInput, outputSchema?: OutSchema, services?: TServices, logger?: TLogger, publisherService?: Service<TEventPublisherServiceName, TEventPublisher>, events?: any[], memorySize?: number, databaseService?: Service<TDatabaseServiceName, TDatabase>,
72
- /**
73
- * The construct ids `.dependsOn()` named — last, so no existing positional
74
- * argument moves.
75
- */
76
- constructs?: string[]);
77
- get schedule(): ScheduleExpression | undefined;
78
- }
79
- type RateExpression = `rate(${string})`;
80
- type CronMinute = '*' | number | `${number}` | `${number}-${number}` | `${number}/${number}` | `*/${number}` | `${number},${number}` | string;
81
- type CronHour = '*' | number | `${number}` | `${number}-${number}` | `${number}/${number}` | `*/${number}` | `${number},${number}` | string;
82
- type CronDay = '*' | number | `${number}` | `${number}-${number}` | `${number}/${number}` | `*/${number}` | `${number},${number}` | string;
83
- type CronMonth = '*' | number | `${number}` | `${number}-${number}` | `${number}/${number}` | `*/${number}` | 'JAN' | 'FEB' | 'MAR' | 'APR' | 'MAY' | 'JUN' | 'JUL' | 'AUG' | 'SEP' | 'OCT' | 'NOV' | 'DEC' | string;
84
- type CronWeekday = '*' | number | `${number}` | `${number}-${number}` | `${number}/${number}` | `*/${number}` | 'SUN' | 'MON' | 'TUE' | 'WED' | 'THU' | 'FRI' | 'SAT' | `${string}-${string}` | string;
85
- type CronExpression = `cron(${CronMinute} ${CronHour} ${CronDay} ${CronMonth} ${CronWeekday})`;
86
- type ScheduleExpression = RateExpression | CronExpression;
87
- //#endregion
88
- //#region src/crons/AWSScheduledFunction.d.ts
89
- /**
90
- * AWS Lambda adaptor for {@link Cron} constructs.
91
- *
92
- * A `Cron` is a {@link import('../functions').Function} that is invoked on a
93
- * schedule (an EventBridge rule) rather than by an API request. Because of
94
- * that, the runtime execution pipeline is identical to a regular Lambda
95
- * function: input parsing, service/database/auditor wiring, event publishing,
96
- * error handling, and the `runWithRequestContext` wrapper that powers
97
- * request-scoped logging via `serviceContext.getLogger()`.
98
- *
99
- * This adaptor therefore reuses {@link AWSLambdaFunction} wholesale and only
100
- * narrows the constructor to accept a `Cron`. The schedule expression itself
101
- * (`cron.schedule`) is **deploy-time** infrastructure consumed by the CLI to
102
- * provision the EventBridge rule — it is not needed at runtime.
103
- *
104
- * @example
105
- * ```typescript
106
- * import { AWSScheduledFunction } from '@geekmidas/constructs/crons';
107
- * import { cancelPastBookings } from '../../../src/crons/cancelPastBookings.js';
108
- * import { envParser } from '../../../src/env';
109
- *
110
- * const adapter = new AWSScheduledFunction(envParser, cancelPastBookings);
111
- *
112
- * export const handler = adapter.handler;
113
- * ```
114
- */
115
- declare class AWSScheduledFunction<TInput extends ComposableStandardSchema | undefined = undefined, TServices extends Service[] = [], TLogger extends Logger = Logger, TOutSchema extends StandardSchemaV1 | undefined = undefined, TEventPublisher extends EventPublisher<any> | undefined = undefined, TEventPublisherServiceName extends string = string, TDatabase = undefined, TDatabaseServiceName extends string = string> extends AWSLambdaFunction<TInput, TOutSchema, TServices, TLogger, TEventPublisher, TEventPublisherServiceName, undefined, string, TDatabase, TDatabaseServiceName> {
116
- constructor(envParser: EnvironmentParser<{}>, cron: Cron<TInput, TServices, TLogger, TOutSchema, TEventPublisher, TEventPublisherServiceName, TDatabase, TDatabaseServiceName>);
117
- }
118
- //# sourceMappingURL=AWSScheduledFunction.d.ts.map
119
-
120
- //#endregion
121
- export { AWSLambdaFunction, AWSScheduledFunction, Cron, CronExpression, RateExpression, ScheduleExpression };
122
- //# sourceMappingURL=AWSScheduledFunction-CVccZO-L.d.mts.map