@geekmidas/constructs 10.0.0-alpha.18 → 10.0.0-alpha.181

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 (485) hide show
  1. package/README.md +246 -158
  2. package/dist/Construct-127M7yrl.d.cts +231 -0
  3. package/dist/Construct-127M7yrl.d.cts.map +1 -0
  4. package/dist/Construct-BMk_CRSD.d.mts +231 -0
  5. package/dist/Construct-BMk_CRSD.d.mts.map +1 -0
  6. package/dist/{Construct-BeYVu_QF.mjs → Construct-CGuc_Ijk.mjs} +8 -9
  7. package/dist/Construct-CGuc_Ijk.mjs.map +1 -0
  8. package/dist/{Construct-DqdlARxq.cjs → Construct-DorKS0Ua.cjs} +8 -9
  9. package/dist/Construct-DorKS0Ua.cjs.map +1 -0
  10. package/dist/{Cron-l4Wlz6G9.d.mts → Cron-BcA8F0S-.d.cts} +16 -9
  11. package/dist/Cron-BcA8F0S-.d.cts.map +1 -0
  12. package/dist/{Cron-zsoSAwZo.d.cts → Cron-z2CiuQT_.d.mts} +15 -8
  13. package/dist/Cron-z2CiuQT_.d.mts.map +1 -0
  14. package/dist/{CronBuilder-D_0HNBTr.mjs → CronBuilder-BJ5LoadF.mjs} +28 -11
  15. package/dist/CronBuilder-BJ5LoadF.mjs.map +1 -0
  16. package/dist/CronBuilder-BZvo34X2.d.cts +47 -0
  17. package/dist/CronBuilder-BZvo34X2.d.cts.map +1 -0
  18. package/dist/{CronBuilder-BdnI6lxF.cjs → CronBuilder-B_NSP-Y5.cjs} +27 -10
  19. package/dist/CronBuilder-B_NSP-Y5.cjs.map +1 -0
  20. package/dist/CronBuilder-BbgKo8OI.d.mts +47 -0
  21. package/dist/CronBuilder-BbgKo8OI.d.mts.map +1 -0
  22. package/dist/Endpoint-52z1P0Ue.cjs +581 -0
  23. package/dist/Endpoint-52z1P0Ue.cjs.map +1 -0
  24. package/dist/{Endpoint-oS-Fe3d_.d.mts → Endpoint-CIDUreMW.d.mts} +104 -23
  25. package/dist/Endpoint-CIDUreMW.d.mts.map +1 -0
  26. package/dist/{Endpoint-DBflWAe4.d.cts → Endpoint-COisi9jw.d.cts} +101 -20
  27. package/dist/Endpoint-COisi9jw.d.cts.map +1 -0
  28. package/dist/Endpoint-sUOU7uLx.mjs +552 -0
  29. package/dist/Endpoint-sUOU7uLx.mjs.map +1 -0
  30. package/dist/{EndpointFactory-Bm3aKRdV.mjs → EndpointFactory-Bzi9Sl7r.mjs} +269 -53
  31. package/dist/EndpointFactory-Bzi9Sl7r.mjs.map +1 -0
  32. package/dist/{index-Cc4kKPag.d.mts → EndpointFactory-CIM80WIK.d.mts} +189 -106
  33. package/dist/EndpointFactory-CIM80WIK.d.mts.map +1 -0
  34. package/dist/{index-C1ZwNOOk.d.cts → EndpointFactory-CfBg6jJE.d.cts} +187 -104
  35. package/dist/EndpointFactory-CfBg6jJE.d.cts.map +1 -0
  36. package/dist/{EndpointFactory-CLvWuHyt.cjs → EndpointFactory-Cf_Cs1ym.cjs} +309 -51
  37. package/dist/EndpointFactory-Cf_Cs1ym.cjs.map +1 -0
  38. package/dist/Function-BIEsY0Hm.d.cts +76 -0
  39. package/dist/Function-BIEsY0Hm.d.cts.map +1 -0
  40. package/dist/Function-BKReud5p.d.mts +76 -0
  41. package/dist/Function-BKReud5p.d.mts.map +1 -0
  42. package/dist/{HonoEndpointAdaptor-92zavCsV.cjs → HonoEndpointAdaptor-BTbqfSaa.cjs} +115 -41
  43. package/dist/HonoEndpointAdaptor-BTbqfSaa.cjs.map +1 -0
  44. package/dist/{HonoEndpointAdaptor-yYaU7jVJ.mjs → HonoEndpointAdaptor-CBVey2cY.mjs} +112 -38
  45. package/dist/HonoEndpointAdaptor-CBVey2cY.mjs.map +1 -0
  46. package/dist/ObjectSubscriberBuilder-Ci_Cc-WZ.d.mts +129 -0
  47. package/dist/ObjectSubscriberBuilder-Ci_Cc-WZ.d.mts.map +1 -0
  48. package/dist/ObjectSubscriberBuilder-DWtLxfAJ.d.cts +129 -0
  49. package/dist/ObjectSubscriberBuilder-DWtLxfAJ.d.cts.map +1 -0
  50. package/dist/ProcessorBuilder-CdLwJK4k.d.mts +216 -0
  51. package/dist/ProcessorBuilder-CdLwJK4k.d.mts.map +1 -0
  52. package/dist/ProcessorBuilder-ClD7tmEe.d.cts +216 -0
  53. package/dist/ProcessorBuilder-ClD7tmEe.d.cts.map +1 -0
  54. package/dist/Queue-9Hh20ZCk.mjs +104 -0
  55. package/dist/Queue-9Hh20ZCk.mjs.map +1 -0
  56. package/dist/{Queue-D9X6OoON.d.mts → Queue-B8HGg439.d.mts} +42 -41
  57. package/dist/Queue-B8HGg439.d.mts.map +1 -0
  58. package/dist/{Queue-DYPB2KWL.d.cts → Queue-C4rijiM7.d.cts} +43 -42
  59. package/dist/Queue-C4rijiM7.d.cts.map +1 -0
  60. package/dist/Queue-W1wueijP.cjs +109 -0
  61. package/dist/Queue-W1wueijP.cjs.map +1 -0
  62. package/dist/QueueBuilder-BDcv9B71.cjs +135 -0
  63. package/dist/QueueBuilder-BDcv9B71.cjs.map +1 -0
  64. package/dist/QueueBuilder-CjULiiDN.d.mts +75 -0
  65. package/dist/QueueBuilder-CjULiiDN.d.mts.map +1 -0
  66. package/dist/QueueBuilder-CrZL8HHs.mjs +118 -0
  67. package/dist/QueueBuilder-CrZL8HHs.mjs.map +1 -0
  68. package/dist/QueueBuilder-Dacm9qAv.d.cts +75 -0
  69. package/dist/QueueBuilder-Dacm9qAv.d.cts.map +1 -0
  70. package/dist/Subscriber-5rCX1Nph.d.cts +83 -0
  71. package/dist/Subscriber-5rCX1Nph.d.cts.map +1 -0
  72. package/dist/Subscriber-CtQXhcL7.d.mts +83 -0
  73. package/dist/Subscriber-CtQXhcL7.d.mts.map +1 -0
  74. package/dist/SubscriberBuilder-CpFhShTJ.mjs +238 -0
  75. package/dist/SubscriberBuilder-CpFhShTJ.mjs.map +1 -0
  76. package/dist/SubscriberBuilder-DJEvNRdD.cjs +261 -0
  77. package/dist/SubscriberBuilder-DJEvNRdD.cjs.map +1 -0
  78. package/dist/Topic-BGoOeCT6.mjs +99 -0
  79. package/dist/Topic-BGoOeCT6.mjs.map +1 -0
  80. package/dist/Topic-DLCZBNwK.cjs +104 -0
  81. package/dist/Topic-DLCZBNwK.cjs.map +1 -0
  82. package/dist/adaptors/aws.cjs +147 -168
  83. package/dist/adaptors/aws.cjs.map +1 -1
  84. package/dist/adaptors/aws.d.cts +57 -48
  85. package/dist/adaptors/aws.d.cts.map +1 -1
  86. package/dist/adaptors/aws.d.mts +58 -49
  87. package/dist/adaptors/aws.d.mts.map +1 -1
  88. package/dist/adaptors/aws.mjs +142 -164
  89. package/dist/adaptors/aws.mjs.map +1 -1
  90. package/dist/adaptors/awsWebsocket.cjs +354 -0
  91. package/dist/adaptors/awsWebsocket.cjs.map +1 -0
  92. package/dist/adaptors/awsWebsocket.d.cts +156 -0
  93. package/dist/adaptors/awsWebsocket.d.cts.map +1 -0
  94. package/dist/adaptors/awsWebsocket.d.mts +156 -0
  95. package/dist/adaptors/awsWebsocket.d.mts.map +1 -0
  96. package/dist/adaptors/awsWebsocket.mjs +347 -0
  97. package/dist/adaptors/awsWebsocket.mjs.map +1 -0
  98. package/dist/adaptors/hono.cjs +1 -1
  99. package/dist/adaptors/hono.d.cts +8 -7
  100. package/dist/adaptors/hono.d.cts.map +1 -1
  101. package/dist/adaptors/hono.d.mts +10 -9
  102. package/dist/adaptors/hono.d.mts.map +1 -1
  103. package/dist/adaptors/hono.mjs +1 -1
  104. package/dist/adaptors/testing.cjs +1174 -41
  105. package/dist/adaptors/testing.cjs.map +1 -1
  106. package/dist/adaptors/testing.d.cts +517 -40
  107. package/dist/adaptors/testing.d.cts.map +1 -1
  108. package/dist/adaptors/testing.d.mts +517 -40
  109. package/dist/adaptors/testing.d.mts.map +1 -1
  110. package/dist/adaptors/testing.mjs +1140 -36
  111. package/dist/adaptors/testing.mjs.map +1 -1
  112. package/dist/auth-CutSfNlr.d.mts +274 -0
  113. package/dist/auth-CutSfNlr.d.mts.map +1 -0
  114. package/dist/auth-b9ADezz9.d.cts +274 -0
  115. package/dist/auth-b9ADezz9.d.cts.map +1 -0
  116. package/dist/auth.cjs +311 -26
  117. package/dist/auth.cjs.map +1 -1
  118. package/dist/auth.d.cts +2 -104
  119. package/dist/auth.d.mts +2 -104
  120. package/dist/auth.mjs +307 -28
  121. package/dist/auth.mjs.map +1 -1
  122. package/dist/cache-9wLNSy3O.d.cts +44 -0
  123. package/dist/cache-9wLNSy3O.d.cts.map +1 -0
  124. package/dist/cache-BFPs_CGs.d.mts +44 -0
  125. package/dist/cache-BFPs_CGs.d.mts.map +1 -0
  126. package/dist/cache.cjs +4 -20
  127. package/dist/cache.cjs.map +1 -1
  128. package/dist/cache.d.cts +2 -43
  129. package/dist/cache.d.mts +2 -43
  130. package/dist/cache.mjs +4 -20
  131. package/dist/cache.mjs.map +1 -1
  132. package/dist/cipher-C1lEFX63.mjs +225 -0
  133. package/dist/cipher-C1lEFX63.mjs.map +1 -0
  134. package/dist/cipher-CVxfwLjk.cjs +332 -0
  135. package/dist/cipher-CVxfwLjk.cjs.map +1 -0
  136. package/dist/cipher-DSDxPRIp.d.cts +106 -0
  137. package/dist/cipher-DSDxPRIp.d.cts.map +1 -0
  138. package/dist/cipher-DSDxPRIp.d.mts +106 -0
  139. package/dist/cipher-DSDxPRIp.d.mts.map +1 -0
  140. package/dist/{construct-interface-DPlxfpoS.d.mts → construct-interface-CVoejIpo.d.cts} +79 -8
  141. package/dist/construct-interface-CVoejIpo.d.cts.map +1 -0
  142. package/dist/{construct-interface-DgXTJcOD.d.cts → construct-interface-Nw5Dt9AC.d.mts} +79 -8
  143. package/dist/construct-interface-Nw5Dt9AC.d.mts.map +1 -0
  144. package/dist/construct-interface.cjs +62 -4
  145. package/dist/construct-interface.cjs.map +1 -1
  146. package/dist/construct-interface.d.cts +2 -2
  147. package/dist/construct-interface.d.mts +2 -2
  148. package/dist/construct-interface.mjs +59 -5
  149. package/dist/construct-interface.mjs.map +1 -1
  150. package/dist/credential-B80mOxwT.mjs +222 -0
  151. package/dist/credential-B80mOxwT.mjs.map +1 -0
  152. package/dist/credential-RlgbzZAc.cjs +257 -0
  153. package/dist/credential-RlgbzZAc.cjs.map +1 -0
  154. package/dist/credential.cjs +7 -129
  155. package/dist/credential.d.cts +2 -58
  156. package/dist/credential.d.mts +2 -58
  157. package/dist/credential.mjs +2 -128
  158. package/dist/crons/index.cjs +127 -1
  159. package/dist/crons/index.cjs.map +1 -1
  160. package/dist/crons/index.d.cts +43 -3
  161. package/dist/crons/index.d.cts.map +1 -1
  162. package/dist/crons/index.d.mts +43 -3
  163. package/dist/crons/index.d.mts.map +1 -1
  164. package/dist/crons/index.mjs +126 -2
  165. package/dist/crons/index.mjs.map +1 -1
  166. package/dist/database/kysely.cjs +3 -194
  167. package/dist/database/kysely.d.cts +2 -149
  168. package/dist/database/kysely.d.mts +2 -149
  169. package/dist/database/kysely.mjs +2 -192
  170. package/dist/email.cjs +24 -17
  171. package/dist/email.cjs.map +1 -1
  172. package/dist/email.d.cts +15 -5
  173. package/dist/email.d.cts.map +1 -1
  174. package/dist/email.d.mts +16 -6
  175. package/dist/email.d.mts.map +1 -1
  176. package/dist/email.mjs +23 -17
  177. package/dist/email.mjs.map +1 -1
  178. package/dist/encryption/kms.cjs +95 -0
  179. package/dist/encryption/kms.cjs.map +1 -0
  180. package/dist/encryption/kms.d.cts +7 -0
  181. package/dist/encryption/kms.d.cts.map +1 -0
  182. package/dist/encryption/kms.d.mts +7 -0
  183. package/dist/encryption/kms.d.mts.map +1 -0
  184. package/dist/encryption/kms.mjs +93 -0
  185. package/dist/encryption/kms.mjs.map +1 -0
  186. package/dist/encryption.cjs +116 -0
  187. package/dist/encryption.cjs.map +1 -0
  188. package/dist/encryption.d.cts +37 -0
  189. package/dist/encryption.d.cts.map +1 -0
  190. package/dist/encryption.d.mts +37 -0
  191. package/dist/encryption.d.mts.map +1 -0
  192. package/dist/encryption.mjs +101 -0
  193. package/dist/encryption.mjs.map +1 -0
  194. package/dist/endpoints/index.cjs +32 -10
  195. package/dist/endpoints/index.d.cts +106 -3
  196. package/dist/endpoints/index.d.cts.map +1 -0
  197. package/dist/endpoints/index.d.mts +106 -3
  198. package/dist/endpoints/index.d.mts.map +1 -0
  199. package/dist/endpoints/index.mjs +6 -4
  200. package/dist/expire-C586zznE.d.cts +38 -0
  201. package/dist/expire-C586zznE.d.cts.map +1 -0
  202. package/dist/expire-C586zznE.d.mts +38 -0
  203. package/dist/expire-C586zznE.d.mts.map +1 -0
  204. package/dist/external-api.cjs +106 -0
  205. package/dist/external-api.cjs.map +1 -0
  206. package/dist/external-api.d.cts +2 -0
  207. package/dist/external-api.d.mts +2 -0
  208. package/dist/external-api.mjs +103 -0
  209. package/dist/external-api.mjs.map +1 -0
  210. package/dist/fake-JI5uN1SF.d.cts +201 -0
  211. package/dist/fake-JI5uN1SF.d.cts.map +1 -0
  212. package/dist/fake-zpuXpBmY.d.mts +201 -0
  213. package/dist/fake-zpuXpBmY.d.mts.map +1 -0
  214. package/dist/file-server.cjs +170 -49
  215. package/dist/file-server.cjs.map +1 -1
  216. package/dist/file-server.d.cts +148 -16
  217. package/dist/file-server.d.cts.map +1 -1
  218. package/dist/file-server.d.mts +148 -16
  219. package/dist/file-server.d.mts.map +1 -1
  220. package/dist/file-server.mjs +168 -51
  221. package/dist/file-server.mjs.map +1 -1
  222. package/dist/functions/index.cjs +1 -1
  223. package/dist/functions/index.d.cts +2 -1
  224. package/dist/functions/index.d.mts +2 -1
  225. package/dist/functions/index.mjs +1 -1
  226. package/dist/{functions-C53GW2eQ.mjs → functions-BvIDQKAA.mjs} +117 -22
  227. package/dist/functions-BvIDQKAA.mjs.map +1 -0
  228. package/dist/{functions-B6qCvfmy.cjs → functions-DLF6-IK8.cjs} +122 -18
  229. package/dist/functions-DLF6-IK8.cjs.map +1 -0
  230. package/dist/inbox-CXLU7h_8.d.cts +195 -0
  231. package/dist/inbox-CXLU7h_8.d.cts.map +1 -0
  232. package/dist/inbox-DYFsLd9A.d.mts +195 -0
  233. package/dist/inbox-DYFsLd9A.d.mts.map +1 -0
  234. package/dist/inbox.cjs +291 -0
  235. package/dist/inbox.cjs.map +1 -0
  236. package/dist/inbox.d.cts +2 -0
  237. package/dist/inbox.d.mts +2 -0
  238. package/dist/inbox.mjs +283 -0
  239. package/dist/inbox.mjs.map +1 -0
  240. package/dist/index-BpE9_6l5.d.mts +115 -0
  241. package/dist/index-BpE9_6l5.d.mts.map +1 -0
  242. package/dist/{index-CeEtxDmK.d.cts → index-DdRjYhiJ.d.cts} +42 -2
  243. package/dist/{index-CeEtxDmK.d.cts.map → index-DdRjYhiJ.d.cts.map} +1 -1
  244. package/dist/{index-CeEtxDmK.d.mts → index-DdRjYhiJ.d.mts} +42 -2
  245. package/dist/{index-CeEtxDmK.d.mts.map → index-DdRjYhiJ.d.mts.map} +1 -1
  246. package/dist/index-zRChehJ9.d.cts +115 -0
  247. package/dist/index-zRChehJ9.d.cts.map +1 -0
  248. package/dist/index.cjs +4 -1
  249. package/dist/index.d.cts +26 -3
  250. package/dist/index.d.cts.map +1 -0
  251. package/dist/index.d.mts +26 -3
  252. package/dist/index.d.mts.map +1 -0
  253. package/dist/index.mjs +3 -2
  254. package/dist/kysely-5PAqFBzo.d.mts +216 -0
  255. package/dist/kysely-5PAqFBzo.d.mts.map +1 -0
  256. package/dist/kysely-Bc9xzaik.mjs +371 -0
  257. package/dist/kysely-Bc9xzaik.mjs.map +1 -0
  258. package/dist/kysely-D7f6J2lh.cjs +384 -0
  259. package/dist/kysely-D7f6J2lh.cjs.map +1 -0
  260. package/dist/kysely-lxNUBSTP.d.cts +216 -0
  261. package/dist/kysely-lxNUBSTP.d.cts.map +1 -0
  262. package/dist/{telemetry-DGcFlVpB.d.cts → lambdaTelemetry-8vnmVZQ5.d.cts} +2 -2
  263. package/dist/lambdaTelemetry-8vnmVZQ5.d.cts.map +1 -0
  264. package/dist/{telemetry-DGcFlVpB.d.mts → lambdaTelemetry-8vnmVZQ5.d.mts} +2 -2
  265. package/dist/lambdaTelemetry-8vnmVZQ5.d.mts.map +1 -0
  266. package/dist/mobile-app.cjs +79 -0
  267. package/dist/mobile-app.cjs.map +1 -0
  268. package/dist/mobile-app.d.cts +78 -0
  269. package/dist/mobile-app.d.cts.map +1 -0
  270. package/dist/mobile-app.d.mts +78 -0
  271. package/dist/mobile-app.d.mts.map +1 -0
  272. package/dist/mobile-app.mjs +78 -0
  273. package/dist/mobile-app.mjs.map +1 -0
  274. package/dist/object-storage.cjs +50 -7
  275. package/dist/object-storage.cjs.map +1 -1
  276. package/dist/object-storage.d.cts +37 -3
  277. package/dist/object-storage.d.cts.map +1 -1
  278. package/dist/object-storage.d.mts +37 -3
  279. package/dist/object-storage.d.mts.map +1 -1
  280. package/dist/object-storage.mjs +49 -9
  281. package/dist/object-storage.mjs.map +1 -1
  282. package/dist/optionalPeers-D7Wt6dnF.mjs +140 -0
  283. package/dist/optionalPeers-D7Wt6dnF.mjs.map +1 -0
  284. package/dist/optionalPeers-DuNQXXe1.cjs +223 -0
  285. package/dist/optionalPeers-DuNQXXe1.cjs.map +1 -0
  286. package/dist/origins-BjxYht13.cjs +96 -0
  287. package/dist/origins-BjxYht13.cjs.map +1 -0
  288. package/dist/origins-Boc9qbo-.mjs +73 -0
  289. package/dist/origins-Boc9qbo-.mjs.map +1 -0
  290. package/dist/pattern-C1CEcglD.mjs +241 -0
  291. package/dist/pattern-C1CEcglD.mjs.map +1 -0
  292. package/dist/pattern-QFaUIr77.cjs +288 -0
  293. package/dist/pattern-QFaUIr77.cjs.map +1 -0
  294. package/dist/privateAddress-Bg5fUsbp.mjs +21 -0
  295. package/dist/privateAddress-Bg5fUsbp.mjs.map +1 -0
  296. package/dist/privateAddress-CqGyuFHn.cjs +26 -0
  297. package/dist/privateAddress-CqGyuFHn.cjs.map +1 -0
  298. package/dist/processors/index.cjs +214 -0
  299. package/dist/processors/index.cjs.map +1 -0
  300. package/dist/processors/index.d.cts +78 -0
  301. package/dist/processors/index.d.cts.map +1 -0
  302. package/dist/processors/index.d.mts +78 -0
  303. package/dist/processors/index.d.mts.map +1 -0
  304. package/dist/processors/index.mjs +193 -0
  305. package/dist/processors/index.mjs.map +1 -0
  306. package/dist/queue/index.cjs +5 -192
  307. package/dist/queue/index.d.cts +3 -53
  308. package/dist/queue/index.d.mts +3 -53
  309. package/dist/queue/index.mjs +3 -190
  310. package/dist/random-password.cjs +86 -0
  311. package/dist/random-password.cjs.map +1 -0
  312. package/dist/random-password.d.cts +30 -0
  313. package/dist/random-password.d.cts.map +1 -0
  314. package/dist/random-password.d.mts +30 -0
  315. package/dist/random-password.d.mts.map +1 -0
  316. package/dist/random-password.mjs +84 -0
  317. package/dist/random-password.mjs.map +1 -0
  318. package/dist/readOnlyStorage-C7bCe-z5.cjs +101 -0
  319. package/dist/readOnlyStorage-C7bCe-z5.cjs.map +1 -0
  320. package/dist/readOnlyStorage-DMCeLuS2.mjs +78 -0
  321. package/dist/readOnlyStorage-DMCeLuS2.mjs.map +1 -0
  322. package/dist/readRequestBody-BmKnPl0a.mjs +293 -0
  323. package/dist/readRequestBody-BmKnPl0a.mjs.map +1 -0
  324. package/dist/{lazyAccessors-Dx9NLwJZ.cjs → readRequestBody-CN9GVdeE.cjs} +141 -47
  325. package/dist/readRequestBody-CN9GVdeE.cjs.map +1 -0
  326. package/dist/{processAudits-D_2W5x8k.cjs → requestLogger-CnoYd-Ah.cjs} +63 -3
  327. package/dist/requestLogger-CnoYd-Ah.cjs.map +1 -0
  328. package/dist/{processAudits-BpRlPQMW.mjs → requestLogger-D2JS7pPM.mjs} +51 -3
  329. package/dist/requestLogger-D2JS7pPM.mjs.map +1 -0
  330. package/dist/rest-api.cjs +100 -73
  331. package/dist/rest-api.cjs.map +1 -1
  332. package/dist/rest-api.d.cts +83 -59
  333. package/dist/rest-api.d.cts.map +1 -1
  334. package/dist/rest-api.d.mts +83 -59
  335. package/dist/rest-api.d.mts.map +1 -1
  336. package/dist/rest-api.mjs +97 -76
  337. package/dist/rest-api.mjs.map +1 -1
  338. package/dist/runSubscriber-HEqXkin1.mjs +117 -0
  339. package/dist/runSubscriber-HEqXkin1.mjs.map +1 -0
  340. package/dist/runSubscriber-sVJfLA0-.cjs +134 -0
  341. package/dist/runSubscriber-sVJfLA0-.cjs.map +1 -0
  342. package/dist/shutdown-BMJmAhSt.cjs +38 -0
  343. package/dist/shutdown-BMJmAhSt.cjs.map +1 -0
  344. package/dist/shutdown-C7xa8x9S.mjs +27 -0
  345. package/dist/shutdown-C7xa8x9S.mjs.map +1 -0
  346. package/dist/site.cjs +140 -10
  347. package/dist/site.cjs.map +1 -1
  348. package/dist/site.d.cts +156 -3
  349. package/dist/site.d.cts.map +1 -1
  350. package/dist/site.d.mts +156 -3
  351. package/dist/site.d.mts.map +1 -1
  352. package/dist/site.mjs +120 -13
  353. package/dist/site.mjs.map +1 -1
  354. package/dist/stages-DaTaoQei.d.cts +73 -0
  355. package/dist/stages-DaTaoQei.d.cts.map +1 -0
  356. package/dist/stages-DaTaoQei.d.mts +73 -0
  357. package/dist/stages-DaTaoQei.d.mts.map +1 -0
  358. package/dist/subscribers/index.cjs +134 -1
  359. package/dist/subscribers/index.cjs.map +1 -0
  360. package/dist/subscribers/index.d.cts +74 -3
  361. package/dist/subscribers/index.d.cts.map +1 -0
  362. package/dist/subscribers/index.d.mts +74 -3
  363. package/dist/subscribers/index.d.mts.map +1 -0
  364. package/dist/subscribers/index.mjs +132 -2
  365. package/dist/subscribers/index.mjs.map +1 -0
  366. package/dist/telemetry-BbLyS7ln.d.cts +57 -0
  367. package/dist/telemetry-BbLyS7ln.d.cts.map +1 -0
  368. package/dist/telemetry-DWX-qKUh.d.mts +57 -0
  369. package/dist/telemetry-DWX-qKUh.d.mts.map +1 -0
  370. package/dist/telemetry.cjs +64 -0
  371. package/dist/telemetry.cjs.map +1 -0
  372. package/dist/telemetry.d.cts +2 -0
  373. package/dist/telemetry.d.mts +2 -0
  374. package/dist/telemetry.mjs +63 -0
  375. package/dist/telemetry.mjs.map +1 -0
  376. package/dist/topic/index.cjs +2 -134
  377. package/dist/topic/index.d.cts +2 -3
  378. package/dist/topic/index.d.mts +2 -3
  379. package/dist/topic/index.mjs +2 -132
  380. package/dist/tracing-Bbj1uoFJ.mjs +127 -0
  381. package/dist/tracing-Bbj1uoFJ.mjs.map +1 -0
  382. package/dist/tracing-C0ooU0V2.cjs +150 -0
  383. package/dist/tracing-C0ooU0V2.cjs.map +1 -0
  384. package/dist/websocket-api-9ndLBolx.d.cts +1207 -0
  385. package/dist/websocket-api-9ndLBolx.d.cts.map +1 -0
  386. package/dist/websocket-api-BPPXF79i.d.mts +1207 -0
  387. package/dist/websocket-api-BPPXF79i.d.mts.map +1 -0
  388. package/dist/websocket-api-C6LGg9-D.mjs +1716 -0
  389. package/dist/websocket-api-C6LGg9-D.mjs.map +1 -0
  390. package/dist/websocket-api-CoKPJJRl.cjs +1895 -0
  391. package/dist/websocket-api-CoKPJJRl.cjs.map +1 -0
  392. package/dist/websocket-api.cjs +42 -0
  393. package/dist/websocket-api.d.cts +2 -0
  394. package/dist/websocket-api.d.mts +2 -0
  395. package/dist/websocket-api.mjs +3 -0
  396. package/dist/worker.cjs +174 -32
  397. package/dist/worker.cjs.map +1 -1
  398. package/dist/worker.d.cts +147 -47
  399. package/dist/worker.d.cts.map +1 -1
  400. package/dist/worker.d.mts +147 -47
  401. package/dist/worker.d.mts.map +1 -1
  402. package/dist/worker.mjs +175 -33
  403. package/dist/worker.mjs.map +1 -1
  404. package/package.json +180 -43
  405. package/dist/Construct-BeYVu_QF.mjs.map +0 -1
  406. package/dist/Construct-DfbwIntp.d.cts +0 -115
  407. package/dist/Construct-DfbwIntp.d.cts.map +0 -1
  408. package/dist/Construct-DqdlARxq.cjs.map +0 -1
  409. package/dist/Construct-l5aOn_jv.d.mts +0 -115
  410. package/dist/Construct-l5aOn_jv.d.mts.map +0 -1
  411. package/dist/Cron-l4Wlz6G9.d.mts.map +0 -1
  412. package/dist/Cron-zsoSAwZo.d.cts.map +0 -1
  413. package/dist/CronBuilder-BdnI6lxF.cjs.map +0 -1
  414. package/dist/CronBuilder-CyT71Nzg.d.cts +0 -41
  415. package/dist/CronBuilder-CyT71Nzg.d.cts.map +0 -1
  416. package/dist/CronBuilder-D_0HNBTr.mjs.map +0 -1
  417. package/dist/CronBuilder-UoNgFe8S.d.mts +0 -41
  418. package/dist/CronBuilder-UoNgFe8S.d.mts.map +0 -1
  419. package/dist/Endpoint-BpZHtJ2W.cjs +0 -1689
  420. package/dist/Endpoint-BpZHtJ2W.cjs.map +0 -1
  421. package/dist/Endpoint-DBflWAe4.d.cts.map +0 -1
  422. package/dist/Endpoint-ONsly_dq.mjs +0 -1671
  423. package/dist/Endpoint-ONsly_dq.mjs.map +0 -1
  424. package/dist/Endpoint-oS-Fe3d_.d.mts.map +0 -1
  425. package/dist/EndpointFactory-Bm3aKRdV.mjs.map +0 -1
  426. package/dist/EndpointFactory-CLvWuHyt.cjs.map +0 -1
  427. package/dist/HonoEndpointAdaptor-92zavCsV.cjs.map +0 -1
  428. package/dist/HonoEndpointAdaptor-yYaU7jVJ.mjs.map +0 -1
  429. package/dist/Queue-D9X6OoON.d.mts.map +0 -1
  430. package/dist/Queue-DYPB2KWL.d.cts.map +0 -1
  431. package/dist/Subscriber-C4heaAyO.d.mts +0 -51
  432. package/dist/Subscriber-C4heaAyO.d.mts.map +0 -1
  433. package/dist/Subscriber-CotDUELC.d.cts +0 -51
  434. package/dist/Subscriber-CotDUELC.d.cts.map +0 -1
  435. package/dist/SubscriberBuilder-BEv0eoHy.d.cts +0 -59
  436. package/dist/SubscriberBuilder-BEv0eoHy.d.cts.map +0 -1
  437. package/dist/SubscriberBuilder-C0ZEtGDI.cjs +0 -125
  438. package/dist/SubscriberBuilder-C0ZEtGDI.cjs.map +0 -1
  439. package/dist/SubscriberBuilder-h7B_cHMr.mjs +0 -114
  440. package/dist/SubscriberBuilder-h7B_cHMr.mjs.map +0 -1
  441. package/dist/SubscriberBuilder-tyH5yTk5.d.mts +0 -59
  442. package/dist/SubscriberBuilder-tyH5yTk5.d.mts.map +0 -1
  443. package/dist/Topic-DEVGo0Dm.d.cts +0 -89
  444. package/dist/Topic-DEVGo0Dm.d.cts.map +0 -1
  445. package/dist/Topic-zk_6Gthr.d.mts +0 -89
  446. package/dist/Topic-zk_6Gthr.d.mts.map +0 -1
  447. package/dist/auth.d.cts.map +0 -1
  448. package/dist/auth.d.mts.map +0 -1
  449. package/dist/cache.d.cts.map +0 -1
  450. package/dist/cache.d.mts.map +0 -1
  451. package/dist/construct-interface-DPlxfpoS.d.mts.map +0 -1
  452. package/dist/construct-interface-DgXTJcOD.d.cts.map +0 -1
  453. package/dist/credential.cjs.map +0 -1
  454. package/dist/credential.d.cts.map +0 -1
  455. package/dist/credential.d.mts.map +0 -1
  456. package/dist/credential.mjs.map +0 -1
  457. package/dist/database/kysely.cjs.map +0 -1
  458. package/dist/database/kysely.d.cts.map +0 -1
  459. package/dist/database/kysely.d.mts.map +0 -1
  460. package/dist/database/kysely.mjs.map +0 -1
  461. package/dist/functions-B6qCvfmy.cjs.map +0 -1
  462. package/dist/functions-C53GW2eQ.mjs.map +0 -1
  463. package/dist/index-B2urf3YI.d.cts +0 -26
  464. package/dist/index-B2urf3YI.d.cts.map +0 -1
  465. package/dist/index-C1ZwNOOk.d.cts.map +0 -1
  466. package/dist/index-Cc4kKPag.d.mts.map +0 -1
  467. package/dist/index-DMCDvnsM.d.mts +0 -26
  468. package/dist/index-DMCDvnsM.d.mts.map +0 -1
  469. package/dist/index-D_frT6MP.d.cts +0 -165
  470. package/dist/index-D_frT6MP.d.cts.map +0 -1
  471. package/dist/index-DcyIYbDS.d.mts +0 -165
  472. package/dist/index-DcyIYbDS.d.mts.map +0 -1
  473. package/dist/lazyAccessors-BHtcqgz2.mjs +0 -211
  474. package/dist/lazyAccessors-BHtcqgz2.mjs.map +0 -1
  475. package/dist/lazyAccessors-Dx9NLwJZ.cjs.map +0 -1
  476. package/dist/processAudits-BpRlPQMW.mjs.map +0 -1
  477. package/dist/processAudits-D_2W5x8k.cjs.map +0 -1
  478. package/dist/queue/index.cjs.map +0 -1
  479. package/dist/queue/index.d.cts.map +0 -1
  480. package/dist/queue/index.d.mts.map +0 -1
  481. package/dist/queue/index.mjs.map +0 -1
  482. package/dist/telemetry-DGcFlVpB.d.cts.map +0 -1
  483. package/dist/telemetry-DGcFlVpB.d.mts.map +0 -1
  484. package/dist/topic/index.cjs.map +0 -1
  485. package/dist/topic/index.mjs.map +0 -1
@@ -1,4 +1,9 @@
1
- import { r as Declarable, t as Construct } from "./construct-interface-DgXTJcOD.cjs";
1
+ import { n as StandardSchemaV1 } from "./index-DdRjYhiJ.cjs";
2
+ import { a as HasPublicFace, i as Declarable, l as ServerHalf, n as Construct } from "./construct-interface-CVoejIpo.cjs";
3
+ import { n as Telemetry } from "./telemetry-BbLyS7ln.cjs";
4
+ import { r as ObjectExpiry } from "./expire-C586zznE.cjs";
5
+ import { f as PatternParams, i as Processor, t as ProcessorBuilder } from "./ProcessorBuilder-ClD7tmEe.cjs";
6
+ import { Logger } from "@geekmidas/logger";
2
7
  import { Service } from "@geekmidas/services";
3
8
  import { ConstructName, Declaration } from "@geekmidas/manifest";
4
9
  import { StorageClient } from "@geekmidas/storage";
@@ -57,6 +62,26 @@ export interface FileServerClient<TOpen extends string = never> extends StorageC
57
62
  * @param expiresIn - minutes, matching `getUploadURL`.
58
63
  */
59
64
  signedUrl(key: string, expiresIn?: number): Promise<string>;
65
+ /**
66
+ * The address of a processor's derivative of an open object — the
67
+ * thumbnail, not the original.
68
+ *
69
+ * @throws {NotOpen} when the key matches no declared pattern.
70
+ * @throws {ProcessorNotOnThisServer} for another file server's processor.
71
+ */
72
+ processedUrl<TPattern extends string, TSchema extends StandardSchemaV1 | undefined>(processor: Processor<TPattern, TSchema, any, any>, params: ProcessorUrlParams<TPattern, TSchema>, key: string): string;
73
+ }
74
+ /**
75
+ * What addresses a derivative: the values the processor's schema accepts —
76
+ * its input, since these go into a path — or, without one, the raw strings.
77
+ */
78
+ export type ProcessorUrlParams<TPattern extends string, TSchema extends StandardSchemaV1 | undefined> = TSchema extends StandardSchemaV1 ? StandardSchemaV1.InferInput<TSchema> : PatternParams<TPattern>;
79
+ /** A processed URL was asked of a file server the processor is not on. */
80
+ export declare class ProcessorNotOnThisServer extends Error {
81
+ readonly pattern: string;
82
+ readonly server: string;
83
+ readonly expected: string;
84
+ constructor(pattern: string, server: string, expected: string);
60
85
  }
61
86
  export interface FileServerOptions<TOpen extends string = never> {
62
87
  /**
@@ -73,8 +98,39 @@ export interface FileServerOptions<TOpen extends string = never> {
73
98
  * refuse to serve unsigned.
74
99
  */
75
100
  open?: readonly TOpen[];
101
+ /**
102
+ * Open paths whose objects never change once written — keyed by a content
103
+ * hash or a file id — so every client may keep them forever: the edge
104
+ * sends `Cache-Control: public, max-age=31536000, immutable`, over
105
+ * whatever the object was stored with.
106
+ *
107
+ * A subset of `open`, because a signed object is never served by the edge.
108
+ * Only say it of paths whose keys are written once: a client holding an
109
+ * immutable copy never asks again.
110
+ */
111
+ immutable?: readonly string[];
76
112
  /** Keep previous versions of an object. */
77
113
  versioned?: boolean;
114
+ /**
115
+ * Delete the objects under each prefix this many days after they were
116
+ * written — `{ 'previews/': { days: 7 } }`. A setting of the bucket this
117
+ * server vends, so it cannot be given with `origin`.
118
+ */
119
+ expire?: ObjectExpiry;
120
+ /**
121
+ * How long its processors' derivatives are kept in the bucket before it
122
+ * deletes them — 30 days unless said. They are remade on the next request,
123
+ * so this trades storage for the work of making one again.
124
+ */
125
+ derived?: {
126
+ readonly days: number;
127
+ };
128
+ /**
129
+ * What its processor unit emits — the `Telemetry` construct, as a worker
130
+ * takes it: each request is a span, and the deploy hands the unit the
131
+ * `OTEL_*` keys its stage resolves.
132
+ */
133
+ telemetry?: Telemetry;
78
134
  /**
79
135
  * A bucket declared elsewhere, instead of one of this server's own.
80
136
  *
@@ -85,40 +141,106 @@ export interface FileServerOptions<TOpen extends string = never> {
85
141
  */
86
142
  origin?: Declarable;
87
143
  }
144
+ /** An immutable pattern that no open pattern admits. */
145
+ export declare class ImmutableNotOpen extends Error {
146
+ readonly id: string;
147
+ readonly pattern: string;
148
+ readonly open: readonly string[];
149
+ constructor(id: string, pattern: string, open: readonly string[]);
150
+ }
151
+ /**
152
+ * A bucket setting given to a file server that fronts a bucket declared
153
+ * elsewhere — where the bucket's own construct is the one that says it.
154
+ */
155
+ export declare class BucketOptionOnOrigin extends Error {
156
+ readonly server: string;
157
+ readonly origin: string;
158
+ readonly option: string;
159
+ constructor(server: string, origin: string, option: string);
160
+ }
161
+ /**
162
+ * A bucket method called on a file server's client that was handed only its
163
+ * public address — a frontend's plain edge.
164
+ */
165
+ export declare class FileServerReadOnly extends Error {
166
+ readonly id: string;
167
+ readonly method: string;
168
+ readonly key: string;
169
+ constructor(id: string, method: string, key: string);
170
+ }
88
171
  /** A key was asked to be served unsigned, and no open pattern admits it. */
89
172
  export declare class NotOpen extends Error {
90
173
  readonly key: string;
91
174
  readonly open: readonly string[];
92
175
  constructor(key: string, open: readonly string[]);
93
176
  }
94
- export declare class FileServer<TName extends string = string, TOpen extends string = never> implements Construct<TName, FileServerClient<TOpen>> {
177
+ export declare class FileServer<TName extends string = string, TOpen extends string = never> implements Construct<TName, FileServerClient<TOpen>>, HasPublicFace {
95
178
  private readonly options;
96
179
  readonly id: TName;
97
180
  readonly service: Service<Uncapitalize<TName>, FileServerClient<TOpen>>;
98
181
  /** The id of the surface node, as opposed to the bucket's. */
99
182
  readonly surfaceId: string;
100
183
  private readonly open;
184
+ private readonly immutable;
185
+ /** The vended bucket's expiry, checked once: prefix → days. */
186
+ private readonly expire;
187
+ /** Days its processors' derivatives are kept, when it says. */
188
+ private readonly derivedDays;
101
189
  /**
102
190
  * Declared once and read by both `declare()` and `connect()`, so the keys the
103
191
  * target publishes and the keys the client reads cannot drift.
104
192
  */
105
193
  private readonly keys;
194
+ /**
195
+ * How a processor reaches the bucket: the bucket's own URL and nothing of
196
+ * the serving half, which a processor never needs. A field, not a getter:
197
+ * services are cached by object identity.
198
+ */
199
+ private readonly origin;
106
200
  constructor(id: ConstructName<TName>, options?: FileServerOptions<TOpen>);
107
201
  /**
108
- * The served surface, as something an edge can point at.
202
+ * A processor behind one path pattern of this server: a handler that makes
203
+ * a derivative of an open object on read.
204
+ *
205
+ * ```ts
206
+ * export const thumbnails = assets
207
+ * .process('/i/:width/*')
208
+ * .params(z.object({ width: z.enum(['64', '256', '1024']) }))
209
+ * .native(['sharp'])
210
+ * .handle(async ({ params, object }) => ({
211
+ * body: await sharp(await object.bytes()).resize(Number(params.width)).webp().toBuffer(),
212
+ * contentType: 'image/webp',
213
+ * cache: 'immutable',
214
+ * }));
215
+ * ```
216
+ *
217
+ * Open paths only: a key no `open` pattern admits is answered 404, as an
218
+ * unsigned read of it would be.
219
+ *
220
+ * @throws {ProcessorPatternInvalid} for a pattern the edge cannot route.
221
+ */
222
+ process<TPattern extends `/${string}/*`>(pattern: TPattern, options?: {
223
+ logger?: Logger;
224
+ }): ProcessorBuilder<TPattern>;
225
+ /**
226
+ * The served surface: what a site's or a mobile app's plain
227
+ * `.dependsOn([uploads])` points at.
109
228
  *
110
- * Depending on the `FileServer` itself points at the **bucket** — its
111
- * canonical node — which is right for a handler: it presigns and writes. But
112
- * a bucket's URL is never public, so a site depending on it gets nothing
113
- * inlined, which is correct and also useless.
229
+ * Its address is public, so the frontend is built with it
230
+ * (`VITE_UPLOADS_URL`) — and it is all the frontend gets: no bucket, no
231
+ * key. A backend's plain edge is to the bucket, as it presigns and writes.
232
+ */
233
+ get publicFace(): Declarable;
234
+ /**
235
+ * Everything: the bucket, its credentials, and the address it is served
236
+ * on.
114
237
  *
115
- * This is the other half: `.dependsOn([uploads.server])` points at the
116
- * surface, whose address *is* public, and is what puts
117
- * `VITE_UPLOADS_SERVER_URL` in a bundle. The same accessor shape
118
- * `database.reader()` uses, and for the same reason — one construct owning
119
- * two addresses needs a way to name the second.
238
+ * What a backend's plain edge already is. A frontend asks for it by name —
239
+ * `.dependsOn([uploads.server])` — when its server half uploads or
240
+ * presigns: a full-stack site's, never a bundle's. The bucket's connection
241
+ * is never inlined into a bundle either way; only the served address is.
120
242
  */
121
- get server(): Declarable;
243
+ get server(): ServerHalf;
122
244
  /**
123
245
  * The bucket and the surface over it — or just the surface, when the bucket
124
246
  * was declared elsewhere.
@@ -132,10 +254,14 @@ export declare class FileServer<TName extends string = string, TOpen extends str
132
254
  /**
133
255
  * The bucket's client, with the serving half added.
134
256
  *
135
- * Both addresses are read here, which is also how the environment reaches a
257
+ * Both keys are read here, which is also how the environment reaches a
136
258
  * handler: the sniffer records what this reads, so `.dependsOn([uploads])`
137
- * carries the bucket URL and the server URL without either being written
138
- * down beside the handler.
259
+ * carries the bucket's connection and the server's address without either
260
+ * being written down beside the handler.
261
+ *
262
+ * Without the connection — a site's or an app's plain edge, which is to
263
+ * the public face — the client serves and does nothing else: its bucket
264
+ * methods throw {@link FileServerReadOnly}.
139
265
  */
140
266
  private connect;
141
267
  /**
@@ -147,6 +273,12 @@ export declare class FileServer<TName extends string = string, TOpen extends str
147
273
  * does.
148
274
  */
149
275
  private serves;
276
+ /**
277
+ * Whether every key a pattern admits is open: the pattern itself, each of
278
+ * its wildcards taken as a segment of its own, is a key an open pattern
279
+ * serves — `brand/logos/*` under `brand/**`, but not `**` under `brand/**`.
280
+ */
281
+ private covers;
150
282
  }
151
283
  //#endregion
152
284
  //# sourceMappingURL=file-server.d.cts.map
@@ -1 +1 @@
1
- {"version":3,"file":"file-server.d.cts","names":[],"sources":["../src/file-server.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;YA4DY,OAAO,oBAAoB,mBAAmB,cACpD,kBACH,mBAAmB,cAAc,YAC7B,gBAAgB,SACnB;;iBAGa,iBAAiB,sCACzB;;;;;;;;;;EAUR,IAAI,KAAK,OAAO;;;;;;;;;;;EAYhB,QAAQ;;;;;;;;;;;;EAaR,UAAU,aAAa,qBAAqB;;iBAG5B,kBAAkB;;;;;;;;;;;;;;EAclC,gBAAgB;;EAEhB;;;;;;;;;EASA,SAAS;;;qBAIG,gBAAgB;WAElB;WACA;EAFV,YACU,aACA;;qBAYE,WACZ,+BACA,yCACY,UAAU,OAAO,iBAAiB;mBAkB5B;WAhBT,IAAI;WACJ,SAAS,QAAQ,aAAa,QAAQ,iBAAiB;;WAGvD;mBAEQ;;;;;mBAMA;EAEjB,YACC,IAAI,cAAc,QACD,UAAS,kBAAkB;;;;;;;;;;;;;;;MAuCzC,UAAU;;;;;;;;;;EAoBd,WAAW;;;;;;;;;UAkCG;;;;;;;;;UAsCN"}
1
+ {"version":3,"file":"file-server.d.cts","names":[],"sources":["../src/file-server.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;YAiFY,OAAO,oBAAoB,mBAAmB,cACpD,kBACH,mBAAmB,cAAc,YAC7B,gBAAgB,SACnB;;iBAGa,iBAAiB,sCACzB;;;;;;;;;;EAUR,IAAI,KAAK,OAAO;;;;;;;;;;;EAYhB,QAAQ;;;;;;;;;;;;EAaR,UAAU,aAAa,qBAAqB;;;;;;;;EAS5C,aACC,yBACA,gBAAgB,8BAEhB,WAAW,UAAU,UAAU,oBAC/B,QAAQ,mBAAmB,UAAU,UACrC;;;;;;YAQU,mBACX,yBACA,gBAAgB,gCACb,gBAAgB,mBACjB,iBAAiB,WAAW,WAC5B,cAAc;;qBAGJ,iCAAiC;WAEnC;WACA;WACA;EAHV,YACU,iBACA,gBACA;;iBAUM,kBAAkB;;;;;;;;;;;;;;EAclC,gBAAgB;;;;;;;;;;;EAWhB;;EAEA;;;;;;EAMA,SAAS;;;;;;EAMT;aAAqB;;;;;;;EAMrB,YAAY;;;;;;;;;EASZ,SAAS;;;qBAIG,yBAAyB;WAE3B;WACA;WACA;EAHV,YACU,YACA,iBACA;;;;;;qBAgBE,6BAA6B;WAE/B;WACA;WACA;EAHV,YACU,gBACA,gBACA;;;;;;qBAcE,2BAA2B;WAE7B;WACA;WACA;EAHV,YACU,YACA,gBACA;;;qBAaE,gBAAgB;WAElB;WACA;EAFV,YACU,aACA;;qBAYE,WACZ,+BACA,yCACY,UAAU,OAAO,iBAAiB,SAAS;mBAgCrC;WA9BT,IAAI;WACJ,SAAS,QAAQ,aAAa,QAAQ,iBAAiB;;WAGvD;mBAEQ;mBACA;;mBAGA;;mBAGA;;;;;mBAMA;;;;;;mBAOA;EAEjB,YACC,IAAI,cAAc,QACD,UAAS,kBAAkB;;;;;;;;;;;;;;;;;;;;;;EAwE7C,QAAQ,iCACP,SAAS,UACT;IAAW,SAAS;MAClB,iBAAiB;;;;;;;;;MAsBhB,cAAc;;;;;;;;;;MAoBd,UAAU;;;;;;;;;;EAad,WAAW;;;;;;;;;;;;;UA8CG;;;;;;;;;UAyDN;;;;;;UASA"}
@@ -1,7 +1,12 @@
1
- import { r as Declarable, t as Construct } from "./construct-interface-DPlxfpoS.mjs";
1
+ import { n as StandardSchemaV1 } from "./index-DdRjYhiJ.mjs";
2
+ import { a as HasPublicFace, i as Declarable, l as ServerHalf, n as Construct } from "./construct-interface-Nw5Dt9AC.mjs";
3
+ import { n as Telemetry } from "./telemetry-DWX-qKUh.mjs";
4
+ import { r as ObjectExpiry } from "./expire-C586zznE.mjs";
5
+ import { f as PatternParams, i as Processor, t as ProcessorBuilder } from "./ProcessorBuilder-CdLwJK4k.mjs";
2
6
  import { ConstructName, Declaration } from "@geekmidas/manifest";
3
7
  import { StorageClient } from "@geekmidas/storage";
4
8
  import { Service } from "@geekmidas/services";
9
+ import { Logger } from "@geekmidas/logger";
5
10
  //#region src/file-server.d.ts
6
11
  /**
7
12
  * A key an open pattern admits.
@@ -57,6 +62,26 @@ export interface FileServerClient<TOpen extends string = never> extends StorageC
57
62
  * @param expiresIn - minutes, matching `getUploadURL`.
58
63
  */
59
64
  signedUrl(key: string, expiresIn?: number): Promise<string>;
65
+ /**
66
+ * The address of a processor's derivative of an open object — the
67
+ * thumbnail, not the original.
68
+ *
69
+ * @throws {NotOpen} when the key matches no declared pattern.
70
+ * @throws {ProcessorNotOnThisServer} for another file server's processor.
71
+ */
72
+ processedUrl<TPattern extends string, TSchema extends StandardSchemaV1 | undefined>(processor: Processor<TPattern, TSchema, any, any>, params: ProcessorUrlParams<TPattern, TSchema>, key: string): string;
73
+ }
74
+ /**
75
+ * What addresses a derivative: the values the processor's schema accepts —
76
+ * its input, since these go into a path — or, without one, the raw strings.
77
+ */
78
+ export type ProcessorUrlParams<TPattern extends string, TSchema extends StandardSchemaV1 | undefined> = TSchema extends StandardSchemaV1 ? StandardSchemaV1.InferInput<TSchema> : PatternParams<TPattern>;
79
+ /** A processed URL was asked of a file server the processor is not on. */
80
+ export declare class ProcessorNotOnThisServer extends Error {
81
+ readonly pattern: string;
82
+ readonly server: string;
83
+ readonly expected: string;
84
+ constructor(pattern: string, server: string, expected: string);
60
85
  }
61
86
  export interface FileServerOptions<TOpen extends string = never> {
62
87
  /**
@@ -73,8 +98,39 @@ export interface FileServerOptions<TOpen extends string = never> {
73
98
  * refuse to serve unsigned.
74
99
  */
75
100
  open?: readonly TOpen[];
101
+ /**
102
+ * Open paths whose objects never change once written — keyed by a content
103
+ * hash or a file id — so every client may keep them forever: the edge
104
+ * sends `Cache-Control: public, max-age=31536000, immutable`, over
105
+ * whatever the object was stored with.
106
+ *
107
+ * A subset of `open`, because a signed object is never served by the edge.
108
+ * Only say it of paths whose keys are written once: a client holding an
109
+ * immutable copy never asks again.
110
+ */
111
+ immutable?: readonly string[];
76
112
  /** Keep previous versions of an object. */
77
113
  versioned?: boolean;
114
+ /**
115
+ * Delete the objects under each prefix this many days after they were
116
+ * written — `{ 'previews/': { days: 7 } }`. A setting of the bucket this
117
+ * server vends, so it cannot be given with `origin`.
118
+ */
119
+ expire?: ObjectExpiry;
120
+ /**
121
+ * How long its processors' derivatives are kept in the bucket before it
122
+ * deletes them — 30 days unless said. They are remade on the next request,
123
+ * so this trades storage for the work of making one again.
124
+ */
125
+ derived?: {
126
+ readonly days: number;
127
+ };
128
+ /**
129
+ * What its processor unit emits — the `Telemetry` construct, as a worker
130
+ * takes it: each request is a span, and the deploy hands the unit the
131
+ * `OTEL_*` keys its stage resolves.
132
+ */
133
+ telemetry?: Telemetry;
78
134
  /**
79
135
  * A bucket declared elsewhere, instead of one of this server's own.
80
136
  *
@@ -85,40 +141,106 @@ export interface FileServerOptions<TOpen extends string = never> {
85
141
  */
86
142
  origin?: Declarable;
87
143
  }
144
+ /** An immutable pattern that no open pattern admits. */
145
+ export declare class ImmutableNotOpen extends Error {
146
+ readonly id: string;
147
+ readonly pattern: string;
148
+ readonly open: readonly string[];
149
+ constructor(id: string, pattern: string, open: readonly string[]);
150
+ }
151
+ /**
152
+ * A bucket setting given to a file server that fronts a bucket declared
153
+ * elsewhere — where the bucket's own construct is the one that says it.
154
+ */
155
+ export declare class BucketOptionOnOrigin extends Error {
156
+ readonly server: string;
157
+ readonly origin: string;
158
+ readonly option: string;
159
+ constructor(server: string, origin: string, option: string);
160
+ }
161
+ /**
162
+ * A bucket method called on a file server's client that was handed only its
163
+ * public address — a frontend's plain edge.
164
+ */
165
+ export declare class FileServerReadOnly extends Error {
166
+ readonly id: string;
167
+ readonly method: string;
168
+ readonly key: string;
169
+ constructor(id: string, method: string, key: string);
170
+ }
88
171
  /** A key was asked to be served unsigned, and no open pattern admits it. */
89
172
  export declare class NotOpen extends Error {
90
173
  readonly key: string;
91
174
  readonly open: readonly string[];
92
175
  constructor(key: string, open: readonly string[]);
93
176
  }
94
- export declare class FileServer<TName extends string = string, TOpen extends string = never> implements Construct<TName, FileServerClient<TOpen>> {
177
+ export declare class FileServer<TName extends string = string, TOpen extends string = never> implements Construct<TName, FileServerClient<TOpen>>, HasPublicFace {
95
178
  private readonly options;
96
179
  readonly id: TName;
97
180
  readonly service: Service<Uncapitalize<TName>, FileServerClient<TOpen>>;
98
181
  /** The id of the surface node, as opposed to the bucket's. */
99
182
  readonly surfaceId: string;
100
183
  private readonly open;
184
+ private readonly immutable;
185
+ /** The vended bucket's expiry, checked once: prefix → days. */
186
+ private readonly expire;
187
+ /** Days its processors' derivatives are kept, when it says. */
188
+ private readonly derivedDays;
101
189
  /**
102
190
  * Declared once and read by both `declare()` and `connect()`, so the keys the
103
191
  * target publishes and the keys the client reads cannot drift.
104
192
  */
105
193
  private readonly keys;
194
+ /**
195
+ * How a processor reaches the bucket: the bucket's own URL and nothing of
196
+ * the serving half, which a processor never needs. A field, not a getter:
197
+ * services are cached by object identity.
198
+ */
199
+ private readonly origin;
106
200
  constructor(id: ConstructName<TName>, options?: FileServerOptions<TOpen>);
107
201
  /**
108
- * The served surface, as something an edge can point at.
202
+ * A processor behind one path pattern of this server: a handler that makes
203
+ * a derivative of an open object on read.
204
+ *
205
+ * ```ts
206
+ * export const thumbnails = assets
207
+ * .process('/i/:width/*')
208
+ * .params(z.object({ width: z.enum(['64', '256', '1024']) }))
209
+ * .native(['sharp'])
210
+ * .handle(async ({ params, object }) => ({
211
+ * body: await sharp(await object.bytes()).resize(Number(params.width)).webp().toBuffer(),
212
+ * contentType: 'image/webp',
213
+ * cache: 'immutable',
214
+ * }));
215
+ * ```
216
+ *
217
+ * Open paths only: a key no `open` pattern admits is answered 404, as an
218
+ * unsigned read of it would be.
219
+ *
220
+ * @throws {ProcessorPatternInvalid} for a pattern the edge cannot route.
221
+ */
222
+ process<TPattern extends `/${string}/*`>(pattern: TPattern, options?: {
223
+ logger?: Logger;
224
+ }): ProcessorBuilder<TPattern>;
225
+ /**
226
+ * The served surface: what a site's or a mobile app's plain
227
+ * `.dependsOn([uploads])` points at.
109
228
  *
110
- * Depending on the `FileServer` itself points at the **bucket** — its
111
- * canonical node — which is right for a handler: it presigns and writes. But
112
- * a bucket's URL is never public, so a site depending on it gets nothing
113
- * inlined, which is correct and also useless.
229
+ * Its address is public, so the frontend is built with it
230
+ * (`VITE_UPLOADS_URL`) — and it is all the frontend gets: no bucket, no
231
+ * key. A backend's plain edge is to the bucket, as it presigns and writes.
232
+ */
233
+ get publicFace(): Declarable;
234
+ /**
235
+ * Everything: the bucket, its credentials, and the address it is served
236
+ * on.
114
237
  *
115
- * This is the other half: `.dependsOn([uploads.server])` points at the
116
- * surface, whose address *is* public, and is what puts
117
- * `VITE_UPLOADS_SERVER_URL` in a bundle. The same accessor shape
118
- * `database.reader()` uses, and for the same reason — one construct owning
119
- * two addresses needs a way to name the second.
238
+ * What a backend's plain edge already is. A frontend asks for it by name —
239
+ * `.dependsOn([uploads.server])` — when its server half uploads or
240
+ * presigns: a full-stack site's, never a bundle's. The bucket's connection
241
+ * is never inlined into a bundle either way; only the served address is.
120
242
  */
121
- get server(): Declarable;
243
+ get server(): ServerHalf;
122
244
  /**
123
245
  * The bucket and the surface over it — or just the surface, when the bucket
124
246
  * was declared elsewhere.
@@ -132,10 +254,14 @@ export declare class FileServer<TName extends string = string, TOpen extends str
132
254
  /**
133
255
  * The bucket's client, with the serving half added.
134
256
  *
135
- * Both addresses are read here, which is also how the environment reaches a
257
+ * Both keys are read here, which is also how the environment reaches a
136
258
  * handler: the sniffer records what this reads, so `.dependsOn([uploads])`
137
- * carries the bucket URL and the server URL without either being written
138
- * down beside the handler.
259
+ * carries the bucket's connection and the server's address without either
260
+ * being written down beside the handler.
261
+ *
262
+ * Without the connection — a site's or an app's plain edge, which is to
263
+ * the public face — the client serves and does nothing else: its bucket
264
+ * methods throw {@link FileServerReadOnly}.
139
265
  */
140
266
  private connect;
141
267
  /**
@@ -147,6 +273,12 @@ export declare class FileServer<TName extends string = string, TOpen extends str
147
273
  * does.
148
274
  */
149
275
  private serves;
276
+ /**
277
+ * Whether every key a pattern admits is open: the pattern itself, each of
278
+ * its wildcards taken as a segment of its own, is a key an open pattern
279
+ * serves — `brand/logos/*` under `brand/**`, but not `**` under `brand/**`.
280
+ */
281
+ private covers;
150
282
  }
151
283
  //#endregion
152
284
  //# sourceMappingURL=file-server.d.mts.map
@@ -1 +1 @@
1
- {"version":3,"file":"file-server.d.mts","names":[],"sources":["../src/file-server.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;YA4DY,OAAO,oBAAoB,mBAAmB,cACpD,kBACH,mBAAmB,cAAc,YAC7B,gBAAgB,SACnB;;iBAGa,iBAAiB,sCACzB;;;;;;;;;;EAUR,IAAI,KAAK,OAAO;;;;;;;;;;;EAYhB,QAAQ;;;;;;;;;;;;EAaR,UAAU,aAAa,qBAAqB;;iBAG5B,kBAAkB;;;;;;;;;;;;;;EAclC,gBAAgB;;EAEhB;;;;;;;;;EASA,SAAS;;;qBAIG,gBAAgB;WAElB;WACA;EAFV,YACU,aACA;;qBAYE,WACZ,+BACA,yCACY,UAAU,OAAO,iBAAiB;mBAkB5B;WAhBT,IAAI;WACJ,SAAS,QAAQ,aAAa,QAAQ,iBAAiB;;WAGvD;mBAEQ;;;;;mBAMA;EAEjB,YACC,IAAI,cAAc,QACD,UAAS,kBAAkB;;;;;;;;;;;;;;;MAuCzC,UAAU;;;;;;;;;;EAoBd,WAAW;;;;;;;;;UAkCG;;;;;;;;;UAsCN"}
1
+ {"version":3,"file":"file-server.d.mts","names":[],"sources":["../src/file-server.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;YAiFY,OAAO,oBAAoB,mBAAmB,cACpD,kBACH,mBAAmB,cAAc,YAC7B,gBAAgB,SACnB;;iBAGa,iBAAiB,sCACzB;;;;;;;;;;EAUR,IAAI,KAAK,OAAO;;;;;;;;;;;EAYhB,QAAQ;;;;;;;;;;;;EAaR,UAAU,aAAa,qBAAqB;;;;;;;;EAS5C,aACC,yBACA,gBAAgB,8BAEhB,WAAW,UAAU,UAAU,oBAC/B,QAAQ,mBAAmB,UAAU,UACrC;;;;;;YAQU,mBACX,yBACA,gBAAgB,gCACb,gBAAgB,mBACjB,iBAAiB,WAAW,WAC5B,cAAc;;qBAGJ,iCAAiC;WAEnC;WACA;WACA;EAHV,YACU,iBACA,gBACA;;iBAUM,kBAAkB;;;;;;;;;;;;;;EAclC,gBAAgB;;;;;;;;;;;EAWhB;;EAEA;;;;;;EAMA,SAAS;;;;;;EAMT;aAAqB;;;;;;;EAMrB,YAAY;;;;;;;;;EASZ,SAAS;;;qBAIG,yBAAyB;WAE3B;WACA;WACA;EAHV,YACU,YACA,iBACA;;;;;;qBAgBE,6BAA6B;WAE/B;WACA;WACA;EAHV,YACU,gBACA,gBACA;;;;;;qBAcE,2BAA2B;WAE7B;WACA;WACA;EAHV,YACU,YACA,gBACA;;;qBAaE,gBAAgB;WAElB;WACA;EAFV,YACU,aACA;;qBAYE,WACZ,+BACA,yCACY,UAAU,OAAO,iBAAiB,SAAS;mBAgCrC;WA9BT,IAAI;WACJ,SAAS,QAAQ,aAAa,QAAQ,iBAAiB;;WAGvD;mBAEQ;mBACA;;mBAGA;;mBAGA;;;;;mBAMA;;;;;;mBAOA;EAEjB,YACC,IAAI,cAAc,QACD,UAAS,kBAAkB;;;;;;;;;;;;;;;;;;;;;;EAwE7C,QAAQ,iCACP,SAAS,UACT;IAAW,SAAS;MAClB,iBAAiB;;;;;;;;;MAsBhB,cAAc;;;;;;;;;;MAoBd,UAAU;;;;;;;;;;EAad,WAAW;;;;;;;;;;;;;UA8CG;;;;;;;;;UAyDN;;;;;;UASA"}