theokit 0.75.1 → 0.76.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (203) hide show
  1. package/README.md +80 -1
  2. package/dist/{actions-virtual-module-MIQPBAZW.js → actions-virtual-module-34PJIOI6.js} +11 -9
  3. package/dist/actions-virtual-module-34PJIOI6.js.map +1 -0
  4. package/dist/{actions-virtual-module-QEI6QPK4.js → actions-virtual-module-HS4W7HQU.js} +6 -5
  5. package/dist/{actions-virtual-module-QEI6QPK4.js.map → actions-virtual-module-HS4W7HQU.js.map} +1 -1
  6. package/dist/adapters/agent-mount.js +9 -7
  7. package/dist/{agent-N4OV5MDY.js → agent-HCK5RHH7.js} +4 -3
  8. package/dist/{app-typed-client-CHSITA46.js → app-typed-client-BWITJLJA.js} +6 -5
  9. package/dist/{app-typed-client-CHSITA46.js.map → app-typed-client-BWITJLJA.js.map} +1 -1
  10. package/dist/{app-typed-client-XQJXF646.js → app-typed-client-FR4M4VND.js} +11 -9
  11. package/dist/app-typed-client-FR4M4VND.js.map +1 -0
  12. package/dist/{aws-lambda-K5Y6XS5V.js → aws-lambda-XT7ZDJ6B.js} +3 -3
  13. package/dist/{build-GNKTCEES.js → build-Y3CWTWP6.js} +24 -92
  14. package/dist/build-Y3CWTWP6.js.map +1 -0
  15. package/dist/{bun-VPXMWFBA.js → bun-PJLDELDT.js} +5 -5
  16. package/dist/{chunk-D7STTNQN.js → chunk-2FZYZHZM.js} +3 -3
  17. package/dist/{chunk-J2KYVTPD.js → chunk-2SGNODVJ.js} +30 -16
  18. package/dist/chunk-2SGNODVJ.js.map +1 -0
  19. package/dist/chunk-2SQ7YAU3.js +85 -0
  20. package/dist/chunk-2SQ7YAU3.js.map +1 -0
  21. package/dist/{chunk-SYIQV4UH.js → chunk-33DGAR6Q.js} +2 -2
  22. package/dist/{chunk-CLSYYO5F.js → chunk-3HRANFEN.js} +2 -2
  23. package/dist/{chunk-EW5IG7GA.js → chunk-42TYMRBG.js} +1 -1
  24. package/dist/{chunk-EW5IG7GA.js.map → chunk-42TYMRBG.js.map} +1 -1
  25. package/dist/{chunk-BINRCILF.js → chunk-4JRXZTVQ.js} +4 -13
  26. package/dist/chunk-4JRXZTVQ.js.map +1 -0
  27. package/dist/{chunk-ICXXHV4V.js → chunk-54BIQFP4.js} +4 -13
  28. package/dist/chunk-54BIQFP4.js.map +1 -0
  29. package/dist/{chunk-NX3P5MLH.js → chunk-C2BRSL4W.js} +50 -6
  30. package/dist/chunk-C2BRSL4W.js.map +1 -0
  31. package/dist/{chunk-E5QTCOKC.js → chunk-C5FBN5LO.js} +87 -23
  32. package/dist/chunk-C5FBN5LO.js.map +1 -0
  33. package/dist/{chunk-NLHAYGQQ.js → chunk-G3DDIEYE.js} +4 -2
  34. package/dist/chunk-G3DDIEYE.js.map +1 -0
  35. package/dist/{chunk-R4AMIBZL.js → chunk-GLD7UXOG.js} +5 -5
  36. package/dist/chunk-GLD7UXOG.js.map +1 -0
  37. package/dist/{chunk-3MKRDJQ2.js → chunk-I27DTFV4.js} +273 -75
  38. package/dist/chunk-I27DTFV4.js.map +1 -0
  39. package/dist/chunk-ISTKIQNY.js +67 -0
  40. package/dist/chunk-ISTKIQNY.js.map +1 -0
  41. package/dist/chunk-IXXZBZF7.js +70 -0
  42. package/dist/chunk-IXXZBZF7.js.map +1 -0
  43. package/dist/{chunk-PVNMLZ5G.js → chunk-JO462JZM.js} +2 -2
  44. package/dist/chunk-KKLXKR2B.js +469 -0
  45. package/dist/chunk-KKLXKR2B.js.map +1 -0
  46. package/dist/{chunk-RY6D4EXL.js → chunk-LCP5FT55.js} +25 -4
  47. package/dist/{chunk-RY6D4EXL.js.map → chunk-LCP5FT55.js.map} +1 -1
  48. package/dist/{chunk-D2R5SJEL.js → chunk-MAJZ2L3A.js} +2 -2
  49. package/dist/{chunk-D2R5SJEL.js.map → chunk-MAJZ2L3A.js.map} +1 -1
  50. package/dist/chunk-NF7LXSXZ.js +19 -0
  51. package/dist/chunk-NF7LXSXZ.js.map +1 -0
  52. package/dist/{chunk-VPK7ABMB.js → chunk-NWUZMJN2.js} +3 -3
  53. package/dist/{chunk-EVKNHQWG.js → chunk-OO3PHTRT.js} +45 -4
  54. package/dist/chunk-OO3PHTRT.js.map +1 -0
  55. package/dist/{chunk-2Z7TANA4.js → chunk-PVI6HM6E.js} +3 -3
  56. package/dist/{chunk-4X43VTST.js → chunk-TODO6J42.js} +1 -1
  57. package/dist/chunk-TODO6J42.js.map +1 -0
  58. package/dist/{chunk-ZDCCILMP.js → chunk-TQTEKNOL.js} +2 -69
  59. package/dist/chunk-TQTEKNOL.js.map +1 -0
  60. package/dist/{chunk-MX63AWEK.js → chunk-VXDTQO3S.js} +22 -6
  61. package/dist/{chunk-MX63AWEK.js.map → chunk-VXDTQO3S.js.map} +1 -1
  62. package/dist/{chunk-OZB2TKGJ.js → chunk-W2I6L4IJ.js} +2 -2
  63. package/dist/{chunk-UWV3B3RY.js → chunk-XDLFOATW.js} +5 -5
  64. package/dist/{chunk-RQKMY3JW.js → chunk-XI4FALFZ.js} +3 -3
  65. package/dist/chunk-XI4FALFZ.js.map +1 -0
  66. package/dist/{chunk-2FHNJ7LI.js → chunk-Z76QQR7I.js} +2 -2
  67. package/dist/chunk-ZICY2CD7.js +16 -0
  68. package/dist/chunk-ZICY2CD7.js.map +1 -0
  69. package/dist/{chunk-I5PDEWZZ.js → chunk-ZQJORKBM.js} +9 -3
  70. package/dist/chunk-ZQJORKBM.js.map +1 -0
  71. package/dist/cli/index.js +21 -15
  72. package/dist/cli/index.js.map +1 -1
  73. package/dist/{cloudflare-7EZQE4UV.js → cloudflare-F7KLBOU4.js} +6 -6
  74. package/dist/{config-support-HUZ4DXR7.js → config-support-2TER2BYD.js} +28 -21
  75. package/dist/config-support-2TER2BYD.js.map +1 -0
  76. package/dist/cron-lock-C3YpKDz2.d.ts +33 -0
  77. package/dist/db-ZWDKD57T.js +86 -0
  78. package/dist/db-ZWDKD57T.js.map +1 -0
  79. package/dist/{deno-deploy-M5V3PYWU.js → deno-deploy-LJ5JQQVR.js} +5 -5
  80. package/dist/{dev-7PMNIIOF.js → dev-R6U3JOYM.js} +60 -11
  81. package/dist/dev-R6U3JOYM.js.map +1 -0
  82. package/dist/{engine-singleton-X4R7AZBJ.js → engine-singleton-BQ5QOMTC.js} +15 -9
  83. package/dist/{engine-singleton-X4R7AZBJ.js.map → engine-singleton-BQ5QOMTC.js.map} +1 -1
  84. package/dist/{generate-RW3NO3NR.js → generate-2VAWEL7X.js} +205 -65
  85. package/dist/generate-2VAWEL7X.js.map +1 -0
  86. package/dist/{index-CmkWlIDO.d.ts → index-DfsJ3Qhk.d.ts} +1 -1
  87. package/dist/index.d.ts +10 -1
  88. package/dist/index.js +12 -10
  89. package/dist/index.js.map +1 -1
  90. package/dist/{info-6NAUW5XY.js → info-IPMW56PI.js} +4 -4
  91. package/dist/{internal-api-R7TTYMCY.js → internal-api-6RAOYIET.js} +6 -5
  92. package/dist/{internal-api-A5HA7TYF.js → internal-api-LJOFLJSS.js} +13 -10
  93. package/dist/job-backend-WvUs5rO1.d.ts +119 -0
  94. package/dist/{load-config-CLFWJOXN.js → load-config-USRR4GXP.js} +4 -4
  95. package/dist/{mcp-3NRZAQKY.js → mcp-FBXEX45H.js} +5 -4
  96. package/dist/{mcp-3NRZAQKY.js.map → mcp-FBXEX45H.js.map} +1 -1
  97. package/dist/{netlify-NI4HYDKN.js → netlify-ZPQNREFH.js} +2 -2
  98. package/dist/{node-LORYECWI.js → node-3EV3CVWB.js} +2 -2
  99. package/dist/{observability-bootstrap-DOWRMADT.js → observability-bootstrap-DMJ7R6WA.js} +3 -3
  100. package/dist/{openapi-ZHKJB3XL.js → openapi-CA3E3LZH.js} +4 -4
  101. package/dist/{preview-SNS7VJWH.js → preview-AX2TMD26.js} +3 -3
  102. package/dist/registry-3D2KR7UE.js +34 -0
  103. package/dist/{routes-SMNSI2ZX.js → routes-BJ7GGRCV.js} +4 -4
  104. package/dist/{schema-DJH3IOVR.js → schema-FBM2UH72.js} +3 -3
  105. package/dist/{schemas-2R2J64ZH.js → schemas-BUR6PWSA.js} +2 -2
  106. package/dist/server/agent/index.d.ts +1 -1
  107. package/dist/server/agent/index.js +2 -1
  108. package/dist/server/cost/index.d.ts +2 -2
  109. package/dist/server/cost/index.js +1 -1
  110. package/dist/server/cost/sqlite/index.d.ts +2 -2
  111. package/dist/server/cost/sqlite/index.js +1 -1
  112. package/dist/server/cron/index.d.ts +20 -7
  113. package/dist/server/cron/index.js +5 -2
  114. package/dist/server/http/index.d.ts +2 -2
  115. package/dist/server/http/index.js +9 -7
  116. package/dist/server/index.d.ts +8 -7
  117. package/dist/server/index.js +42 -27
  118. package/dist/server/index.js.map +1 -1
  119. package/dist/server/jobs/index.d.ts +85 -44
  120. package/dist/server/jobs/index.js +8 -2
  121. package/dist/server/observability/index.js +8 -7
  122. package/dist/server/storage/index.d.ts +2 -2
  123. package/dist/server/storage/index.js +4 -1
  124. package/dist/server/webhook/index.d.ts +4 -5
  125. package/dist/server/webhook/index.js +1 -1
  126. package/dist/{server-boundary-ZT6HN7ON.js → server-boundary-EKIGYL7B.js} +6 -5
  127. package/dist/{server-boundary-ZT6HN7ON.js.map → server-boundary-EKIGYL7B.js.map} +1 -1
  128. package/dist/{server-boundary-HYLYGFZY.js → server-boundary-WSGVQAXP.js} +11 -9
  129. package/dist/server-boundary-WSGVQAXP.js.map +1 -0
  130. package/dist/{start-L5TGWGLU.js → start-4FY3TLM7.js} +118 -185
  131. package/dist/start-4FY3TLM7.js.map +1 -0
  132. package/dist/{static-O2RZ5NLR.js → static-VNN4HYRN.js} +2 -2
  133. package/dist/{storage-manager-BtG38jYl.d.ts → storage-manager-Clu2RBpH.d.ts} +15 -3
  134. package/dist/{storage-manager-3O5PDO6O.js → storage-manager-O3APCXYX.js} +46 -5
  135. package/dist/storage-manager-O3APCXYX.js.map +1 -0
  136. package/dist/{storage-types-CFGPFIdB.d.ts → storage-types-ndO0ZZqH.d.ts} +2 -2
  137. package/dist/{theo-cloud-B4R7GCWK.js → theo-cloud-243SPOIA.js} +2 -2
  138. package/dist/{vercel-INHLOCSZ.js → vercel-EXKSZ2OQ.js} +5 -5
  139. package/dist/vite-plugin/index.js +12 -10
  140. package/dist/{vite-plugin-UXEXT7GX.js → vite-plugin-LE42ZIGV.js} +10 -9
  141. package/dist/{whatsapp-D_Fnl1LX.d.ts → whatsapp-4W2eK2ij.d.ts} +1 -1
  142. package/package.json +1 -1
  143. package/dist/actions-virtual-module-MIQPBAZW.js.map +0 -1
  144. package/dist/app-typed-client-XQJXF646.js.map +0 -1
  145. package/dist/build-GNKTCEES.js.map +0 -1
  146. package/dist/chunk-3MKRDJQ2.js.map +0 -1
  147. package/dist/chunk-4X43VTST.js.map +0 -1
  148. package/dist/chunk-BINRCILF.js.map +0 -1
  149. package/dist/chunk-E5QTCOKC.js.map +0 -1
  150. package/dist/chunk-EVKNHQWG.js.map +0 -1
  151. package/dist/chunk-I5PDEWZZ.js.map +0 -1
  152. package/dist/chunk-ICXXHV4V.js.map +0 -1
  153. package/dist/chunk-IDEZ7FU2.js +0 -18
  154. package/dist/chunk-IDEZ7FU2.js.map +0 -1
  155. package/dist/chunk-J2KYVTPD.js.map +0 -1
  156. package/dist/chunk-NLHAYGQQ.js.map +0 -1
  157. package/dist/chunk-NX3P5MLH.js.map +0 -1
  158. package/dist/chunk-R4AMIBZL.js.map +0 -1
  159. package/dist/chunk-RQKMY3JW.js.map +0 -1
  160. package/dist/chunk-YCF3N4JS.js +0 -26
  161. package/dist/chunk-YCF3N4JS.js.map +0 -1
  162. package/dist/chunk-ZDCCILMP.js.map +0 -1
  163. package/dist/config-support-HUZ4DXR7.js.map +0 -1
  164. package/dist/db-IVVCQE5Z.js +0 -76
  165. package/dist/db-IVVCQE5Z.js.map +0 -1
  166. package/dist/dev-7PMNIIOF.js.map +0 -1
  167. package/dist/generate-RW3NO3NR.js.map +0 -1
  168. package/dist/job-backend-CgC8Xf33.d.ts +0 -68
  169. package/dist/registry-3SVWZVIJ.js +0 -34
  170. package/dist/server-boundary-HYLYGFZY.js.map +0 -1
  171. package/dist/start-L5TGWGLU.js.map +0 -1
  172. package/dist/storage-manager-3O5PDO6O.js.map +0 -1
  173. /package/dist/{agent-N4OV5MDY.js.map → agent-HCK5RHH7.js.map} +0 -0
  174. /package/dist/{aws-lambda-K5Y6XS5V.js.map → aws-lambda-XT7ZDJ6B.js.map} +0 -0
  175. /package/dist/{bun-VPXMWFBA.js.map → bun-PJLDELDT.js.map} +0 -0
  176. /package/dist/{chunk-D7STTNQN.js.map → chunk-2FZYZHZM.js.map} +0 -0
  177. /package/dist/{chunk-SYIQV4UH.js.map → chunk-33DGAR6Q.js.map} +0 -0
  178. /package/dist/{chunk-CLSYYO5F.js.map → chunk-3HRANFEN.js.map} +0 -0
  179. /package/dist/{chunk-PVNMLZ5G.js.map → chunk-JO462JZM.js.map} +0 -0
  180. /package/dist/{chunk-VPK7ABMB.js.map → chunk-NWUZMJN2.js.map} +0 -0
  181. /package/dist/{chunk-2Z7TANA4.js.map → chunk-PVI6HM6E.js.map} +0 -0
  182. /package/dist/{chunk-OZB2TKGJ.js.map → chunk-W2I6L4IJ.js.map} +0 -0
  183. /package/dist/{chunk-UWV3B3RY.js.map → chunk-XDLFOATW.js.map} +0 -0
  184. /package/dist/{chunk-2FHNJ7LI.js.map → chunk-Z76QQR7I.js.map} +0 -0
  185. /package/dist/{cloudflare-7EZQE4UV.js.map → cloudflare-F7KLBOU4.js.map} +0 -0
  186. /package/dist/{deno-deploy-M5V3PYWU.js.map → deno-deploy-LJ5JQQVR.js.map} +0 -0
  187. /package/dist/{info-6NAUW5XY.js.map → info-IPMW56PI.js.map} +0 -0
  188. /package/dist/{internal-api-R7TTYMCY.js.map → internal-api-6RAOYIET.js.map} +0 -0
  189. /package/dist/{internal-api-A5HA7TYF.js.map → internal-api-LJOFLJSS.js.map} +0 -0
  190. /package/dist/{load-config-CLFWJOXN.js.map → load-config-USRR4GXP.js.map} +0 -0
  191. /package/dist/{netlify-NI4HYDKN.js.map → netlify-ZPQNREFH.js.map} +0 -0
  192. /package/dist/{node-LORYECWI.js.map → node-3EV3CVWB.js.map} +0 -0
  193. /package/dist/{observability-bootstrap-DOWRMADT.js.map → observability-bootstrap-DMJ7R6WA.js.map} +0 -0
  194. /package/dist/{openapi-ZHKJB3XL.js.map → openapi-CA3E3LZH.js.map} +0 -0
  195. /package/dist/{preview-SNS7VJWH.js.map → preview-AX2TMD26.js.map} +0 -0
  196. /package/dist/{registry-3SVWZVIJ.js.map → registry-3D2KR7UE.js.map} +0 -0
  197. /package/dist/{routes-SMNSI2ZX.js.map → routes-BJ7GGRCV.js.map} +0 -0
  198. /package/dist/{schema-DJH3IOVR.js.map → schema-FBM2UH72.js.map} +0 -0
  199. /package/dist/{schemas-2R2J64ZH.js.map → schemas-BUR6PWSA.js.map} +0 -0
  200. /package/dist/{static-O2RZ5NLR.js.map → static-VNN4HYRN.js.map} +0 -0
  201. /package/dist/{theo-cloud-B4R7GCWK.js.map → theo-cloud-243SPOIA.js.map} +0 -0
  202. /package/dist/{vercel-INHLOCSZ.js.map → vercel-EXKSZ2OQ.js.map} +0 -0
  203. /package/dist/{vite-plugin-UXEXT7GX.js.map → vite-plugin-LE42ZIGV.js.map} +0 -0
@@ -2,7 +2,7 @@
2
2
  import "tsx/esm";
3
3
  import {
4
4
  nodeAdapter
5
- } from "./chunk-NLHAYGQQ.js";
5
+ } from "./chunk-G3DDIEYE.js";
6
6
  import "./chunk-L4V5V2TI.js";
7
7
 
8
8
  // src/adapters/config-support.ts
@@ -13,7 +13,8 @@ var CONFIG_CONCERNS = [
13
13
  "disallowed",
14
14
  "serialization",
15
15
  "plugins",
16
- "securityHeaders"
16
+ "securityHeaders",
17
+ "jobs"
17
18
  ];
18
19
  function appliedByNoTarget(concern) {
19
20
  const applied = nodeAdapter.appliesConfig;
@@ -27,26 +28,32 @@ var CONFIG_KEY = {
27
28
  disallowed: "security.disallowed",
28
29
  serialization: "serialization",
29
30
  plugins: "plugins",
30
- securityHeaders: "security.headers"
31
+ securityHeaders: "security.headers",
32
+ jobs: "jobs.backend"
33
+ };
34
+ var IS_DECLARED = {
35
+ rateLimit: (config) => config.rateLimit !== void 0,
36
+ cors: (config) => config.security?.cors !== void 0,
37
+ // `csrf` carries `.default('strict')` (config/schemas/security.ts:100) and
38
+ // the deployed fallback is also `'strict'` (server/http/execute.ts:144).
39
+ // A config that says `'strict'` therefore gets what it asked for, by
40
+ // coincidence rather than by wiring -- reporting it dropped would be noise
41
+ // over an identical outcome. Only a weaker setting is silently ignored.
42
+ csrf: (config) => config.security?.csrf !== void 0 && config.security.csrf !== "strict",
43
+ disallowed: (config) => config.security?.disallowed !== void 0 && config.security.disallowed.routes.length > 0,
44
+ securityHeaders: (config) => config.security?.headers !== void 0,
45
+ // Same shape: `.default('json')` (config/schema.ts:147), and a target with
46
+ // no transformer serializes as JSON. `'json'` is honoured by coincidence;
47
+ // `'superjson'` is the case where the deployed app quietly disagrees with
48
+ // the file.
49
+ serialization: (config) => config.serialization !== "json",
50
+ plugins: (config) => config.plugins !== void 0 && config.plugins.length > 0,
51
+ // A constructed backend (a pool, a map) has no literal a deployed entry could hold, so only
52
+ // `theokit start` wires `ctx.queue` from it (usetheokit/theokit#1009).
53
+ jobs: (config) => config.jobs !== void 0
31
54
  };
32
55
  function isDeclared(config, concern) {
33
- const security = config.security;
34
- switch (concern) {
35
- case "rateLimit":
36
- return config.rateLimit !== void 0;
37
- case "cors":
38
- return security?.cors !== void 0;
39
- case "csrf":
40
- return security?.csrf !== void 0 && security.csrf !== "strict";
41
- case "disallowed":
42
- return security?.disallowed !== void 0 && security.disallowed.routes.length > 0;
43
- case "securityHeaders":
44
- return security?.headers !== void 0;
45
- case "serialization":
46
- return config.serialization !== "json";
47
- case "plugins":
48
- return config.plugins !== void 0 && config.plugins.length > 0;
49
- }
56
+ return IS_DECLARED[concern](config);
50
57
  }
51
58
  function findUnappliedConfig(config, adapter) {
52
59
  const applied = adapter.appliesConfig ?? [];
@@ -149,4 +156,4 @@ export {
149
156
  findUnappliedConfig,
150
157
  warnUnappliedConfig
151
158
  };
152
- //# sourceMappingURL=config-support-HUZ4DXR7.js.map
159
+ //# sourceMappingURL=config-support-2TER2BYD.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/adapters/config-support.ts"],"sourcesContent":["/**\n * Which configuration a deploy target's emitted handler actually applies.\n *\n * `theo.config.ts` validates `rateLimit`, `security.cors`, `security.csrf`,\n * `security.disallowed` and `serialization` for every target. Applying them is\n * the handler's job, and the six Web-standards adapters build `executeRoute`'s\n * context from a subset of its fields, so the rest fall back to hard-coded\n * defaults on a deployed app (usetheokit/theokit#410). `security.cors` was read\n * only by the dev server until #409 wired it into `theokit start`; the six Web\n * targets still drop it.\n *\n * This module does not fix that. It makes it **audible at build time**: a\n * config key that is parsed and then dropped is named, with the target that\n * drops it and the next action. Silence was the defect — an operator who\n * declares a rate limit and gets none has no reason to look.\n *\n * It warns rather than refuses, deliberately. Refusing would break every\n * deployment that declares `rateLimit` today, and the real fix — wiring a\n * limiter that needs a per-runtime client address — is not a build away\n * (`docs/program/journeys/j07-rate-limit.md` § Correction measured what it\n * costs). Forcing an operator to delete valid configuration in order to ship\n * would trade a silent gap for a loud one that also loses information.\n */\nimport type { TheoConfig } from '../config/schema.js'\n\nimport { nodeAdapter } from './node.js'\nimport type { ConfigConcern, DeployAdapter } from './types.js'\n\n/**\n * The closed set. A concern belongs here when it is (a) declarable in\n * `theo.config.ts` and (b) applied by a request handler rather than at build\n * time — a build-time key cannot be silently dropped by a runtime.\n */\nexport const CONFIG_CONCERNS = [\n 'rateLimit',\n 'cors',\n 'csrf',\n 'disallowed',\n 'serialization',\n 'plugins',\n 'securityHeaders',\n 'jobs',\n] as const satisfies readonly ConfigConcern[]\n\n/**\n * Does any production target apply this concern?\n *\n * DERIVED from what the `node` adapter declares, rather than listed. This was a hand-maintained\n * `APPLIED_BY_NO_TARGET` set holding `cors`, kept in step with `nodeAdapter.appliesConfig` by a\n * test — and #409, which taught `theokit start` to apply `cors`, emptied it. An empty hardcoded\n * set is not merely redundant: it makes the branch below provably unreachable, which the linter\n * says out loud (`sonarjs/no-empty-collection`).\n *\n * Deriving keeps the branch honest AND reachable: the moment a concern is added that `node` does\n * not apply, the advice stops claiming a target exists for it, with nothing to remember.\n */\nfunction appliedByNoTarget(concern: ConfigConcern): boolean {\n const applied = nodeAdapter.appliesConfig\n if (applied === undefined || applied === 'runtime-not-emitted-here') return true\n return !applied.includes(concern)\n}\n\n/** Where each concern lives in the config, for a message the operator can grep. */\nconst CONFIG_KEY: Record<ConfigConcern, string> = {\n rateLimit: 'rateLimit',\n cors: 'security.cors',\n csrf: 'security.csrf',\n disallowed: 'security.disallowed',\n serialization: 'serialization',\n plugins: 'plugins',\n securityHeaders: 'security.headers',\n jobs: 'jobs.backend',\n}\n\n/** Whether the config declares each concern, one predicate per concern. */\nconst IS_DECLARED: Record<ConfigConcern, (config: TheoConfig) => boolean> = {\n rateLimit: (config) => config.rateLimit !== undefined,\n cors: (config) => config.security?.cors !== undefined,\n // `csrf` carries `.default('strict')` (config/schemas/security.ts:100) and\n // the deployed fallback is also `'strict'` (server/http/execute.ts:144).\n // A config that says `'strict'` therefore gets what it asked for, by\n // coincidence rather than by wiring -- reporting it dropped would be noise\n // over an identical outcome. Only a weaker setting is silently ignored.\n csrf: (config) => config.security?.csrf !== undefined && config.security.csrf !== 'strict',\n disallowed: (config) =>\n config.security?.disallowed !== undefined && config.security.disallowed.routes.length > 0,\n securityHeaders: (config) => config.security?.headers !== undefined,\n // Same shape: `.default('json')` (config/schema.ts:147), and a target with\n // no transformer serializes as JSON. `'json'` is honoured by coincidence;\n // `'superjson'` is the case where the deployed app quietly disagrees with\n // the file.\n serialization: (config) => config.serialization !== 'json',\n plugins: (config) => config.plugins !== undefined && config.plugins.length > 0,\n // A constructed backend (a pool, a map) has no literal a deployed entry could hold, so only\n // `theokit start` wires `ctx.queue` from it (usetheokit/theokit#1009).\n jobs: (config) => config.jobs !== undefined,\n}\n\nfunction isDeclared(config: TheoConfig, concern: ConfigConcern): boolean {\n return IS_DECLARED[concern](config)\n}\n\n/**\n * The concerns this config declares and this adapter does not apply.\n *\n * An adapter that emits no request handler of its own answers\n * `'runtime-not-emitted-here'` and is never reported against: it is not that\n * the configuration is dropped, it is that this build cannot know. Saying\n * nothing is the honest output, and it is a different fact from saying no.\n */\nexport function findUnappliedConfig(\n config: TheoConfig,\n adapter: Pick<DeployAdapter, 'appliesConfig'>,\n): ConfigConcern[] {\n const applied = adapter.appliesConfig ?? []\n if (applied === 'runtime-not-emitted-here') return []\n return CONFIG_CONCERNS.filter(\n (concern) => isDeclared(config, concern) && !applied.includes(concern),\n )\n}\n\n/**\n * The build-time message. Empty string when nothing was dropped, so the caller\n * neither branches nor prints a header over an empty list.\n */\nexport function describeUnappliedConfig(target: string, dropped: readonly ConfigConcern[]): string {\n if (dropped.length === 0) return ''\n const one = dropped.length === 1\n const list = dropped.map((concern) => ` - ${CONFIG_KEY[concern]}`).join('\\n')\n const elsewhere = dropped.filter((concern) => !appliedByNoTarget(concern))\n const nowhere = dropped.filter(appliedByNoTarget)\n\n // The advice has to change with the target, or it degenerates. Building for\n // `node` with only `security.cors` dropped once produced \"deploy to `node`,\n // which applies all of the above except security.cors\" -- an instruction to\n // do what you are already doing, about the one key it then excepts.\n const actions: string[] = []\n if (elsewhere.length > 0 && target !== 'node') {\n actions.push(\n ` - ${elsewhere.map((c) => CONFIG_KEY[c]).join(', ')}: build for \\`node\\` and run \\`theokit start\\`,`,\n ` which applies ${elsewhere.length === 1 ? 'it' : 'them'}; or remove ${elsewhere.length === 1 ? 'it' : 'them'} so the file states what runs.`,\n )\n } else if (elsewhere.length > 0) {\n actions.push(\n ` - ${elsewhere.map((c) => CONFIG_KEY[c]).join(', ')}: remove ${elsewhere.length === 1 ? 'it' : 'them'} so the file states what runs.`,\n )\n }\n if (nowhere.length > 0) {\n actions.push(\n ` - ${nowhere.map((c) => CONFIG_KEY[c]).join(', ')}: no production target applies ${nowhere.length === 1 ? 'this' : 'these'} today`,\n ` (usetheokit/theokit#409) -- terminate it in front of the app, or remove it.`,\n )\n }\n\n return [\n ` ! ${String(dropped.length)} configuration ${one ? 'key is' : 'keys are'} validated and NOT applied on \\`${target}\\`:`,\n list,\n ` The handler this target emits never reads ${one ? 'it' : 'them'}, so the deployed app`,\n ` behaves as if ${one ? 'the key were' : 'the keys were'} absent.`,\n ` What to do:`,\n ...actions,\n ` Tracked: usetheokit/theokit#410 (deploy targets), usetheokit/theokit#409 (cors).`,\n ].join('\\n')\n}\n\n/**\n * Emit the warning, if there is one. The sink is injected so the behaviour is\n * exercisable without driving a whole build: the alternative was a caller that\n * only a full `theokit build` could reach, which in practice means a caller\n * nothing tests.\n */\nexport function warnUnappliedConfig(\n config: TheoConfig,\n adapter: Pick<DeployAdapter, 'appliesConfig'>,\n target: string,\n log: (message: string) => void,\n): void {\n const dropped = findUnappliedConfig(config, adapter)\n if (dropped.length === 0) return\n log(`\\n${describeUnappliedConfig(target, dropped)}\\n`)\n}\n\n/**\n * A declared rate limit the chosen target cannot enforce.\n *\n * Its own class so a caller can distinguish it from a configuration typo — this is not the build\n * failing to understand the file, it is the build understanding it and refusing the combination.\n */\nexport class UnenforceableRateLimitError extends Error {\n override readonly name = 'UnenforceableRateLimitError'\n constructor(readonly target: string) {\n super(\n [\n `Refusing to build for \\`${target}\\`: theo.config.ts declares a rate limit and this target does not enforce one.`,\n ``,\n ` The config reads as protection the deploy will not have. Nothing at runtime reports the`,\n ` absence, so the first sign is abuse — which is why this refuses rather than warns.`,\n ``,\n ` Two honest ways forward:`,\n ` • build for \\`node\\` and run \\`theokit start\\`, which applies the limit; or`,\n ` • remove \\`rateLimit\\` from theo.config.ts, so the file states what actually runs.`,\n ``,\n ` There is deliberately no flag to keep the key and skip the check: a config that stays`,\n ` while doing nothing is the state this refusal exists to end (usetheokit/theokit#461).`,\n ].join('\\n'),\n )\n }\n}\n\n/**\n * Refuse a build whose target drops a DECLARED rate limit.\n *\n * Only `rateLimit`, and the narrowness is the design. A dropped `cors` or `serialization` degrades\n * where someone can see it, and `describeUnappliedConfig`'s warning is proportionate for those.\n * `rateLimit` is the one whose absence looks exactly like success, which is the same reasoning\n * `MissingRoutePolicyError` applies to an undeclared route policy: refuse where silence would be\n * read as safety.\n *\n * `'runtime-not-emitted-here'` is not judged. That adapter's runtime is someone else's and this\n * build cannot answer for it; refusing there would be asserting something unmeasured.\n */\n/**\n * Refuse a target that cannot stream when the config says responses stream.\n *\n * Lives here rather than inside an adapter's `build()` because of WHEN it has to run. The refusal was\n * thrown from `buildAwsLambda`, which `runAdapterBuild` reaches a hundred lines after `cleanOutDir` has\n * emptied the output — so a project with `ssrStreaming: true` lost a working build to a refusal about\n * streaming. Measured 2026-09-28: 302 files in `.theokit/client/assets` before, 0 after (B-336).\n *\n * The alternatives are DERIVED from the registry rather than written into the sentence. A hardcoded\n * list was correct when it was written and nothing kept it correct, which is the same class of drift\n * `adapter-streaming-contract.test.ts` now pins.\n */\nexport function assertStreamingSupported(\n config: Pick<TheoConfig, 'ssrStreaming'>,\n adapter: Pick<DeployAdapter, 'streamsResponses' | 'streamingUnsupportedDetail'>,\n target: string,\n streamingTargets?: readonly string[],\n): void {\n if (!config.ssrStreaming) return\n if (adapter.streamsResponses === true) return\n\n const detail =\n adapter.streamingUnsupportedDetail === undefined ? '' : ` ${adapter.streamingUnsupportedDetail}`\n\n // The alternatives are named only when the CALLER could know them. An adapter cannot: asking the\n // registry from inside one closes `adapter -> config-support -> registry -> adapter`, and the Acyclic\n // Dependencies Principle is not negotiable here (`rules/architecture.md`). So the CLI passes the list\n // it already has, and a direct call to an adapter's build gets the same refusal without it.\n const alternatives =\n streamingTargets === undefined || streamingTargets.length === 0\n ? ''\n : ` Build a streaming target instead (${streamingTargets.join(', ')}), or set`\n const orSet = alternatives === '' ? ' Set' : alternatives\n\n throw new Error(\n `[adapter-${target}] ssrStreaming is on, but the ${target} target does not stream responses.` +\n `${detail}${orSet} ssrStreaming: false in theo.config.ts.`,\n )\n}\n\nexport function assertRateLimitEnforceable(\n config: TheoConfig,\n adapter: Pick<DeployAdapter, 'enforcesRateLimit'>,\n target: string,\n): void {\n if (!isDeclared(config, 'rateLimit')) return\n\n // B-257 — this reads `enforcesRateLimit`, NOT `appliesConfig`. They were one list until now, and\n // `applied.includes('rateLimit')` returned before the throw, so adding that entry to silence the\n // WARNING also switched off this REFUSAL — on a runtime where the limit still cannot hold.\n //\n // **An omitted field REFUSES.** The first cut defaulted to `'not-ours-to-judge'`, which inverted\n // the rule it replaced: `appliesConfig ?? []` did not include `'rateLimit'`, so an adapter that\n // declared nothing was refused; `?? 'not-ours-to-judge'` let it through. Measured on\n // `static.ts`, which declares neither field and is registered at `registry.ts:28` — it went from\n // refusing a declared limit to proceeding with a console warning. `:213-215` refuses exactly that\n // outcome in its own words, and this member is on the EXPORTED `DeployAdapter`, so every\n // third-party adapter inherited the inversion too.\n //\n // Abstaining is a CLAIM about somebody else's runtime, and a claim has to be made rather than\n // inferred from silence.\n const enforces = adapter.enforcesRateLimit ?? 'never'\n\n // An adapter emitting no request handler is not judged. Its runtime is someone else's and this\n // build cannot answer for it; refusing would assert something unmeasured. An ABSTAIN, and the\n // reason it is not spelled `'never'`.\n if (enforces === 'not-ours-to-judge') return\n\n if (enforces === 'always') return\n\n // `'never'`, and the default for an adapter that declared nothing. Refusing here is what the\n // pre-B-257 rule did; reaching the store check below would let an undeclared adapter enforce by\n // accident whenever a config happened to name one.\n if (enforces === 'never') throw new UnenforceableRateLimitError(target)\n\n // `'with-a-store'`: a per-invocation runtime enforces only when the config names a durable\n // counter. Without one the in-process count dies with the invocation, and a limit that forgets is\n // a limit that does not limit — the same class of failure as a shared bucket, by another road.\n if (declaresRateLimitStore(config)) return\n\n throw new UnenforceableRateLimitError(target)\n}\n\n/** Does the declared `rateLimit` name a store the emitted entry could construct? */\nfunction declaresRateLimitStore(config: TheoConfig): boolean {\n const limit = (config as { rateLimit?: { store?: unknown } }).rateLimit\n return typeof limit?.store === 'object' && limit.store !== null\n}\n"],"mappings":"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","names":[]}
@@ -0,0 +1,33 @@
1
+ import { P as PoolLike } from './storage-types-ndO0ZZqH.js';
2
+
3
+ /**
4
+ * Decides which process runs a cron tick when several run the scheduler.
5
+ *
6
+ * `theokit start` schedules every cron in every process, so N replicas used to fire each tick N
7
+ * times (usetheokit/theokit#1016). With a lock, each process asks before running the handler and
8
+ * only the one that gets `true` runs it. `scheduledAt` is the tick's computed time, the same value
9
+ * in every replica, which is what makes it a key they can agree on.
10
+ */
11
+ interface CronLock {
12
+ /** `true` exactly once per `(name, scheduledAt)` across every process sharing the lock. */
13
+ acquire(name: string, scheduledAt: Date): Promise<boolean>;
14
+ }
15
+ interface PostgresCronLockOptions {
16
+ /** Table holding one row per fired tick (default `theokit_cron_runs`). Created on first use. */
17
+ tableName?: string;
18
+ /** Rows older than this are deleted when the same cron fires again. Default 7 days. */
19
+ retentionDays?: number;
20
+ }
21
+ /**
22
+ * A `CronLock` on a shared Postgres: one row per fired tick, keyed by `(name, scheduled_at)`. The
23
+ * replica whose `INSERT ... ON CONFLICT DO NOTHING` inserts the row runs the tick; every other one
24
+ * gets no row back and skips it. A row rather than `pg_try_advisory_lock` because the lock has to
25
+ * outlive the statement: a replica whose timer fires a few milliseconds late must still see that the
26
+ * tick was taken, and an advisory lock released after a fast handler would let it run again.
27
+ *
28
+ * Each row is also a record of when the tick fired and nothing else; rows past `retentionDays` are
29
+ * removed as the cron keeps firing.
30
+ */
31
+ declare function createPostgresCronLock(pool: PoolLike, options?: PostgresCronLockOptions): CronLock;
32
+
33
+ export { type CronLock as C, type PostgresCronLockOptions as P, createPostgresCronLock as c };
@@ -0,0 +1,86 @@
1
+ #!/usr/bin/env node
2
+ import "tsx/esm";
3
+ import {
4
+ loadConfig
5
+ } from "./chunk-W2I6L4IJ.js";
6
+ import "./chunk-3QPVEJ7D.js";
7
+ import "./chunk-O5JZ6ROY.js";
8
+ import "./chunk-C2BRSL4W.js";
9
+ import "./chunk-L4V5V2TI.js";
10
+ import "./chunk-MAJZ2L3A.js";
11
+
12
+ // src/cli/commands/db.ts
13
+ import { execSync } from "child_process";
14
+ import { existsSync } from "fs";
15
+ import { join, resolve } from "path";
16
+ var VALID_ACTIONS = /* @__PURE__ */ new Set(["migrate", "push", "generate", "seed"]);
17
+ var runInherited = (command, cwd) => {
18
+ execSync(command, { cwd, stdio: "inherit" });
19
+ };
20
+ function assertFileExists(cwd, relPath, hint) {
21
+ if (!existsSync(resolve(cwd, relPath))) {
22
+ throw new Error(`${relPath} not found. ${hint}`);
23
+ }
24
+ }
25
+ function assertBinExists(cwd, bin) {
26
+ const binPath = resolve(cwd, "node_modules", ".bin", bin);
27
+ if (!existsSync(binPath)) {
28
+ throw new Error(`${bin} not found. Run: npm install -D ${bin}`);
29
+ }
30
+ }
31
+ var DRIZZLE_KIT_VERBS = {
32
+ migrate: { command: "npx drizzle-kit migrate", message: "Migrations applied" },
33
+ push: { command: "npx drizzle-kit push", message: "Schema pushed to the database" },
34
+ generate: { command: "npx drizzle-kit generate", message: "Migration files generated" }
35
+ };
36
+ async function runSeed(cwd, run) {
37
+ const { serverDir } = await loadConfig(cwd);
38
+ const seedPath = join(serverDir, "db", "seed.ts");
39
+ assertFileExists(cwd, seedPath, `Create ${seedPath} with your seed data.`);
40
+ console.log("\n \u25B8 Running seed...\n");
41
+ run(`npx tsx ${seedPath}`, cwd);
42
+ return "Database seeded successfully";
43
+ }
44
+ async function dbCommand(action, cwd, run = runInherited) {
45
+ if (!VALID_ACTIONS.has(action)) {
46
+ return {
47
+ status: "invalid_action",
48
+ message: `Unknown db action "${action}". Available: ${[...VALID_ACTIONS].join(", ")}`
49
+ };
50
+ }
51
+ const dbAction = action;
52
+ try {
53
+ if (dbAction === "seed") {
54
+ return { status: "success", message: await runSeed(cwd, run), action: dbAction };
55
+ }
56
+ const verb = DRIZZLE_KIT_VERBS[dbAction];
57
+ assertFileExists(cwd, "drizzle.config.ts", "Create a drizzle.config.ts for your project.");
58
+ assertBinExists(cwd, "drizzle-kit");
59
+ console.log(`
60
+ \u25B8 Running ${verb.command.replace("npx ", "")}...
61
+ `);
62
+ run(verb.command, cwd);
63
+ return { status: "success", message: verb.message, action: dbAction };
64
+ } catch (err) {
65
+ const msg = err instanceof Error ? err.message : String(err);
66
+ return { status: "error", message: msg, action: dbAction };
67
+ }
68
+ }
69
+ async function dbCommandCli(action) {
70
+ const result = await dbCommand(action, process.cwd());
71
+ if (result.status === "success") {
72
+ console.log(`
73
+ \u2713 ${result.message}
74
+ `);
75
+ } else {
76
+ console.error(`
77
+ \u2717 ${result.message}
78
+ `);
79
+ process.exit(1);
80
+ }
81
+ }
82
+ export {
83
+ dbCommand,
84
+ dbCommandCli
85
+ };
86
+ //# sourceMappingURL=db-ZWDKD57T.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/cli/commands/db.ts"],"sourcesContent":["import { execSync } from 'node:child_process'\nimport { existsSync } from 'node:fs'\nimport { join, resolve } from 'node:path'\n\nimport { loadConfig } from '../../config/load-config.js'\n\ntype DbAction = 'migrate' | 'push' | 'generate' | 'seed'\n\nconst VALID_ACTIONS = new Set<DbAction>(['migrate', 'push', 'generate', 'seed'])\n\ninterface DbCommandResult {\n status: 'success' | 'error' | 'invalid_action'\n message: string\n action?: DbAction\n}\n\n/** Runs a shell command in the project. Injected so a test can see the command without running it. */\ntype RunCommand = (command: string, cwd: string) => void\n\nconst runInherited: RunCommand = (command, cwd) => {\n execSync(command, { cwd, stdio: 'inherit' })\n}\n\nfunction assertFileExists(cwd: string, relPath: string, hint: string): void {\n if (!existsSync(resolve(cwd, relPath))) {\n throw new Error(`${relPath} not found. ${hint}`)\n }\n}\n\nfunction assertBinExists(cwd: string, bin: string): void {\n const binPath = resolve(cwd, 'node_modules', '.bin', bin)\n if (!existsSync(binPath)) {\n throw new Error(`${bin} not found. Run: npm install -D ${bin}`)\n }\n}\n\n/**\n * Each verb runs the drizzle-kit command of the same name.\n *\n * `migrate` used to run `drizzle-kit push` (usetheokit/theokit#1021). Push diffs the schema straight\n * into the database: it never reads the files `generate` writes and keeps no\n * `drizzle.__drizzle_migrations` journal, so a deploy script calling `theokit db migrate` applied\n * an unreviewed diff with no record of it. `migrate` now applies the generated files, and the old\n * behaviour stays available, under its real name, as `push`.\n */\nconst DRIZZLE_KIT_VERBS = {\n migrate: { command: 'npx drizzle-kit migrate', message: 'Migrations applied' },\n push: { command: 'npx drizzle-kit push', message: 'Schema pushed to the database' },\n generate: { command: 'npx drizzle-kit generate', message: 'Migration files generated' },\n} as const\n\nasync function runSeed(cwd: string, run: RunCommand): Promise<string> {\n // The seed file lives under the configured `serverDir`; a hardcoded `server/` missed the\n // scaffold's `src/server` layout.\n const { serverDir } = await loadConfig(cwd)\n const seedPath = join(serverDir, 'db', 'seed.ts')\n assertFileExists(cwd, seedPath, `Create ${seedPath} with your seed data.`)\n console.log('\\n ▸ Running seed...\\n')\n run(`npx tsx ${seedPath}`, cwd)\n return 'Database seeded successfully'\n}\n\nexport async function dbCommand(\n action: string,\n cwd: string,\n run: RunCommand = runInherited,\n): Promise<DbCommandResult> {\n if (!VALID_ACTIONS.has(action as DbAction)) {\n return {\n status: 'invalid_action',\n message: `Unknown db action \"${action}\". Available: ${[...VALID_ACTIONS].join(', ')}`,\n }\n }\n\n const dbAction = action as DbAction\n\n try {\n if (dbAction === 'seed') {\n return { status: 'success', message: await runSeed(cwd, run), action: dbAction }\n }\n const verb = DRIZZLE_KIT_VERBS[dbAction]\n assertFileExists(cwd, 'drizzle.config.ts', 'Create a drizzle.config.ts for your project.')\n assertBinExists(cwd, 'drizzle-kit')\n console.log(`\\n ▸ Running ${verb.command.replace('npx ', '')}...\\n`)\n run(verb.command, cwd)\n return { status: 'success', message: verb.message, action: dbAction }\n } catch (err) {\n const msg = err instanceof Error ? err.message : String(err)\n return { status: 'error', message: msg, action: dbAction }\n }\n}\n\nexport async function dbCommandCli(action: string): Promise<void> {\n const result = await dbCommand(action, process.cwd())\n if (result.status === 'success') {\n console.log(`\\n ✓ ${result.message}\\n`)\n } else {\n console.error(`\\n ✗ ${result.message}\\n`)\n process.exit(1)\n }\n}\n"],"mappings":";;;;;;;;;;;;AAAA,SAAS,gBAAgB;AACzB,SAAS,kBAAkB;AAC3B,SAAS,MAAM,eAAe;AAM9B,IAAM,gBAAgB,oBAAI,IAAc,CAAC,WAAW,QAAQ,YAAY,MAAM,CAAC;AAW/E,IAAM,eAA2B,CAAC,SAAS,QAAQ;AACjD,WAAS,SAAS,EAAE,KAAK,OAAO,UAAU,CAAC;AAC7C;AAEA,SAAS,iBAAiB,KAAa,SAAiB,MAAoB;AAC1E,MAAI,CAAC,WAAW,QAAQ,KAAK,OAAO,CAAC,GAAG;AACtC,UAAM,IAAI,MAAM,GAAG,OAAO,eAAe,IAAI,EAAE;AAAA,EACjD;AACF;AAEA,SAAS,gBAAgB,KAAa,KAAmB;AACvD,QAAM,UAAU,QAAQ,KAAK,gBAAgB,QAAQ,GAAG;AACxD,MAAI,CAAC,WAAW,OAAO,GAAG;AACxB,UAAM,IAAI,MAAM,GAAG,GAAG,mCAAmC,GAAG,EAAE;AAAA,EAChE;AACF;AAWA,IAAM,oBAAoB;AAAA,EACxB,SAAS,EAAE,SAAS,2BAA2B,SAAS,qBAAqB;AAAA,EAC7E,MAAM,EAAE,SAAS,wBAAwB,SAAS,gCAAgC;AAAA,EAClF,UAAU,EAAE,SAAS,4BAA4B,SAAS,4BAA4B;AACxF;AAEA,eAAe,QAAQ,KAAa,KAAkC;AAGpE,QAAM,EAAE,UAAU,IAAI,MAAM,WAAW,GAAG;AAC1C,QAAM,WAAW,KAAK,WAAW,MAAM,SAAS;AAChD,mBAAiB,KAAK,UAAU,UAAU,QAAQ,uBAAuB;AACzE,UAAQ,IAAI,8BAAyB;AACrC,MAAI,WAAW,QAAQ,IAAI,GAAG;AAC9B,SAAO;AACT;AAEA,eAAsB,UACpB,QACA,KACA,MAAkB,cACQ;AAC1B,MAAI,CAAC,cAAc,IAAI,MAAkB,GAAG;AAC1C,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,SAAS,sBAAsB,MAAM,iBAAiB,CAAC,GAAG,aAAa,EAAE,KAAK,IAAI,CAAC;AAAA,IACrF;AAAA,EACF;AAEA,QAAM,WAAW;AAEjB,MAAI;AACF,QAAI,aAAa,QAAQ;AACvB,aAAO,EAAE,QAAQ,WAAW,SAAS,MAAM,QAAQ,KAAK,GAAG,GAAG,QAAQ,SAAS;AAAA,IACjF;AACA,UAAM,OAAO,kBAAkB,QAAQ;AACvC,qBAAiB,KAAK,qBAAqB,8CAA8C;AACzF,oBAAgB,KAAK,aAAa;AAClC,YAAQ,IAAI;AAAA,mBAAiB,KAAK,QAAQ,QAAQ,QAAQ,EAAE,CAAC;AAAA,CAAO;AACpE,QAAI,KAAK,SAAS,GAAG;AACrB,WAAO,EAAE,QAAQ,WAAW,SAAS,KAAK,SAAS,QAAQ,SAAS;AAAA,EACtE,SAAS,KAAK;AACZ,UAAM,MAAM,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAC3D,WAAO,EAAE,QAAQ,SAAS,SAAS,KAAK,QAAQ,SAAS;AAAA,EAC3D;AACF;AAEA,eAAsB,aAAa,QAA+B;AAChE,QAAM,SAAS,MAAM,UAAU,QAAQ,QAAQ,IAAI,CAAC;AACpD,MAAI,OAAO,WAAW,WAAW;AAC/B,YAAQ,IAAI;AAAA,WAAS,OAAO,OAAO;AAAA,CAAI;AAAA,EACzC,OAAO;AACL,YAAQ,MAAM;AAAA,WAAS,OAAO,OAAO;AAAA,CAAI;AACzC,YAAQ,KAAK,CAAC;AAAA,EAChB;AACF;","names":[]}
@@ -1,11 +1,11 @@
1
1
  #!/usr/bin/env node
2
2
  import "tsx/esm";
3
- import {
4
- planDeployedPlugins
5
- } from "./chunk-C43AHOHI.js";
6
3
  import {
7
4
  deployedEntryPreamble
8
5
  } from "./chunk-XLFDYTWO.js";
6
+ import {
7
+ planDeployedPlugins
8
+ } from "./chunk-C43AHOHI.js";
9
9
  import {
10
10
  agentsDirLiteral,
11
11
  deployedAgentsFragment,
@@ -19,7 +19,7 @@ import {
19
19
  } from "./chunk-EQJF2EH5.js";
20
20
  import {
21
21
  nodeAdapter
22
- } from "./chunk-NLHAYGQQ.js";
22
+ } from "./chunk-G3DDIEYE.js";
23
23
  import "./chunk-WSMLSIS5.js";
24
24
  import {
25
25
  assertServicesUnsupported,
@@ -382,4 +382,4 @@ export {
382
382
  renderDenoConfig,
383
383
  renderDenoEntry
384
384
  };
385
- //# sourceMappingURL=deno-deploy-M5V3PYWU.js.map
385
+ //# sourceMappingURL=deno-deploy-LJ5JQQVR.js.map
@@ -1,26 +1,38 @@
1
1
  #!/usr/bin/env node
2
2
  import "tsx/esm";
3
+ import {
4
+ listJobFiles
5
+ } from "./chunk-2SQ7YAU3.js";
6
+ import {
7
+ cronScanDirs,
8
+ listCronFiles
9
+ } from "./chunk-IWIRHUNV.js";
3
10
  import {
4
11
  validateProjectStructure
5
12
  } from "./chunk-GEQJAFSV.js";
6
13
  import {
7
- initCacheEngineFromConfig
8
- } from "./chunk-YCF3N4JS.js";
14
+ configureStorageManagerFromConfig,
15
+ createCronScheduler,
16
+ initCacheEngineFromConfig,
17
+ loadCronModules,
18
+ loadJobModules,
19
+ startJobWorker
20
+ } from "./chunk-KKLXKR2B.js";
9
21
  import {
10
22
  preflightNodeAndBindings
11
23
  } from "./chunk-KTMQUYED.js";
12
24
  import {
13
25
  theoPluginAsync
14
- } from "./chunk-J2KYVTPD.js";
15
- import "./chunk-I5PDEWZZ.js";
26
+ } from "./chunk-2SGNODVJ.js";
27
+ import "./chunk-ZQJORKBM.js";
16
28
  import "./chunk-BDH5GKFZ.js";
17
29
  import "./chunk-3PWQQWT6.js";
18
30
  import "./chunk-FDOOBTXJ.js";
19
- import "./chunk-RQKMY3JW.js";
20
- import "./chunk-BINRCILF.js";
31
+ import "./chunk-XI4FALFZ.js";
32
+ import "./chunk-4JRXZTVQ.js";
21
33
  import "./chunk-FNJVSFEC.js";
22
34
  import "./chunk-WSMLSIS5.js";
23
- import "./chunk-MX63AWEK.js";
35
+ import "./chunk-VXDTQO3S.js";
24
36
  import "./chunk-C27VRUVN.js";
25
37
  import "./chunk-7UZZHCRN.js";
26
38
  import "./chunk-47MM2JUK.js";
@@ -30,20 +42,22 @@ import "./chunk-4WP7A7RX.js";
30
42
  import "./chunk-Z7CJHDLS.js";
31
43
  import {
32
44
  loadConfig
33
- } from "./chunk-OZB2TKGJ.js";
45
+ } from "./chunk-W2I6L4IJ.js";
34
46
  import {
35
47
  loadEnv
36
48
  } from "./chunk-3QPVEJ7D.js";
37
49
  import "./chunk-O5JZ6ROY.js";
38
- import "./chunk-NX3P5MLH.js";
50
+ import "./chunk-C2BRSL4W.js";
39
51
  import {
40
52
  orchestrateDev
41
53
  } from "./chunk-L4V5V2TI.js";
42
- import "./chunk-D2R5SJEL.js";
54
+ import "./chunk-MAJZ2L3A.js";
55
+ import "./chunk-NF7LXSXZ.js";
43
56
  import "./chunk-5ODOE6EF.js";
44
57
  import "./chunk-VQIUTCK2.js";
45
58
 
46
59
  // src/cli/commands/dev.ts
60
+ import { resolve } from "path";
47
61
  import react from "@vitejs/plugin-react";
48
62
  import { createServer } from "vite";
49
63
  function buildDevServerOptions(config, port) {
@@ -64,6 +78,7 @@ async function startDevServer(cwd, options) {
64
78
  const config = await loadConfig(cwd);
65
79
  validateProjectStructure(cwd, config.appDir);
66
80
  await initCacheEngineFromConfig(config.cache);
81
+ await configureStorageManagerFromConfig(config.storage);
67
82
  const orchestration = await orchestrateDev({
68
83
  cwd,
69
84
  services: config.services
@@ -108,8 +123,42 @@ async function startDevServer(cwd, options) {
108
123
  server.httpServer?.on("close", () => {
109
124
  void orchestration.stop();
110
125
  });
126
+ await startDevJobWorker(server, cwd, config);
127
+ await startDevCrons(server, cwd, config, options?.crons === true);
111
128
  return server;
112
129
  }
130
+ async function startDevJobWorker(server, cwd, config) {
131
+ const files = listJobFiles(resolve(cwd, config.serverDir, "jobs"));
132
+ const definitions = await loadJobModules(files, (filePath) => server.ssrLoadModule(filePath));
133
+ const jobs = startJobWorker(config, definitions);
134
+ if (jobs.summary !== void 0) console.log(`
135
+ ${jobs.summary}`);
136
+ server.httpServer?.on("close", () => {
137
+ void jobs.worker?.stop();
138
+ });
139
+ }
140
+ async function startDevCrons(server, cwd, config, schedule) {
141
+ const dirs = cronScanDirs(cwd, config.serverDir, config.agentsDir);
142
+ const files = listCronFiles([dirs.crons, dirs.schedules]);
143
+ if (files.length === 0) return;
144
+ if (!schedule) {
145
+ console.log(
146
+ `
147
+ Crons: ${String(files.length)} declared, not scheduled in dev. Run \`theokit dev --crons\` to schedule them (edits apply after a restart).`
148
+ );
149
+ return;
150
+ }
151
+ const definitions = await loadCronModules(files, (filePath) => server.ssrLoadModule(filePath));
152
+ const scheduler = createCronScheduler(definitions);
153
+ scheduler.start();
154
+ console.log(
155
+ `
156
+ Crons: ${String(definitions.length)} scheduled in dev (--crons); edits apply after a restart.`
157
+ );
158
+ server.httpServer?.on("close", () => {
159
+ scheduler.stop();
160
+ });
161
+ }
113
162
  async function devCommand(options) {
114
163
  try {
115
164
  const cwd = process.cwd();
@@ -128,4 +177,4 @@ export {
128
177
  devCommand,
129
178
  startDevServer
130
179
  };
131
- //# sourceMappingURL=dev-7PMNIIOF.js.map
180
+ //# sourceMappingURL=dev-R6U3JOYM.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/cli/commands/dev.ts"],"sourcesContent":["import { resolve } from 'node:path'\n\nimport react from '@vitejs/plugin-react'\nimport { createServer, type Plugin, type ServerOptions, type ViteDevServer } from 'vite'\n\nimport { loadConfig } from '../../config/load-config.js'\nimport { loadEnv } from '../../config/load-env.js'\nimport type { TheoConfig } from '../../config/schema.js'\nimport { validateProjectStructure } from '../../config/validate-structure.js'\nimport { initCacheEngineFromConfig } from '../../server/cache-bootstrap.js'\nimport { createCronScheduler } from '../../server/cron/cron-runtime-node.js'\nimport { cronScanDirs, listCronFiles } from '../../server/cron/cron-scan.js'\nimport { listJobFiles } from '../../server/jobs/job-scan.js'\nimport { orchestrateDev } from '../../services/index.js'\nimport { theoPluginAsync } from '../../vite-plugin/index.js'\nimport { preflightNodeAndBindings } from '../preflight-node-version.js'\n\nimport { configureStorageManagerFromConfig } from './start/bootstrap-stages.js'\nimport { loadCronModules } from './start/cron-bootstrap.js'\nimport { loadJobModules, startJobWorker } from './start/job-bootstrap.js'\n\ninterface DevOptions {\n port?: number\n /** Schedule the crons in dev (`theokit dev --crons`). Off by default (usetheokit/theokit#1017). */\n crons?: boolean\n}\n\n/**\n * The Vite `server` block, as a pure function of the loaded config — the same reasoning\n * `buildSecurityHeaders` is written down with: a setting that reaches Vite only from inside a\n * booted dev server can be asserted only by booting one, and a setting nobody can assert is how a\n * config field ends up existing and doing nothing (#555).\n *\n * Every key here is omitted rather than set to `undefined` when the app said nothing, so Vite's own\n * defaults apply. That matters most for `allowedHosts`, where the falsy value is `[]` — an empty\n * allowlist blocks every host, loopback included, so writing one on silence would turn \"no opinion\"\n * into \"refuse everything\".\n */\nexport function buildDevServerOptions(config: TheoConfig, port: number): ServerOptions {\n return {\n port,\n host: config.host,\n open: config.open,\n strictPort: config.strictPort,\n ...(config.allowedHosts !== undefined ? { allowedHosts: config.allowedHosts } : {}),\n warmup: config.warmup ?? {\n clientFiles: ['./app/**/*.tsx', './app/**/*.ts'],\n },\n }\n}\n\nexport async function startDevServer(cwd: string, options?: DevOptions): Promise<ViteDevServer> {\n // Preflight (FIRST — BEFORE anything that touches native bindings):\n // verifies Node version + native binding ABI match. Emits actionable\n // error referencing `nvm use` + `pnpm rebuild` when the dev server\n // was spawned under the wrong Node (common gotcha with `nohup env ...`\n // stripping the nvm PATH prefix).\n preflightNodeAndBindings(cwd)\n\n // Phase 1 (T1.2) — Load .env files into process.env BEFORE any module\n // reads them. Must run before loadConfig() so theo.config.ts functions\n // referencing process.env.* resolve correctly.\n loadEnv({ cwd, mode: 'development' })\n\n const config = await loadConfig(cwd)\n // #95 — pass config.appDir so the structure gate honors a custom frontend dir (e.g. apps/web).\n validateProjectStructure(cwd, config.appDir)\n\n // #352 — same engine, same config key, so `revalidateTag` behaves identically\n // under `theo dev` and `theo start`. A cache that only exists in production is\n // a cache nobody develops against.\n await initCacheEngineFromConfig(config.cache)\n\n // #1020 — the storage counterpart. `start` applied `config.storage` and `dev` did not, so every\n // `usePostgres(...)` threw \"Database not configured\" in development.\n await configureStorageManagerFromConfig(config.storage)\n\n // Wave 2 (T1.1) — spawn polyglot services BEFORE Vite. Healthcheck gates\n // readiness. Empty `services: {}` → early return (Wave 1 BC preserved).\n const orchestration = await orchestrateDev({\n cwd,\n services: config.services,\n })\n if (!orchestration.allHealthy) {\n await orchestration.stop()\n throw new Error(\n `[services] services failed healthcheck: ${orchestration.unhealthy.join(', ')}. ` +\n `Check that each declared service binds its port and responds 200 on its ` +\n `healthcheck path within 30s.`,\n )\n }\n\n // Phase 7 — legacy fs-mtime sweep removed: SDK's Agent.registry handles\n // LRU + idle eviction natively (configurable via theo.config.ts >\n // agents.registry; lazy-configured on first request).\n\n const port = options?.port ?? config.port\n // Narrow the rateLimit union: only the legacy flat shape (windowMs+max)\n // flows into the theoPlugin's RateLimitConfig parameter. The per-route\n // variant is consumed inside the api-middleware via the loaded user\n // config separately.\n const flatRateLimit =\n config.rateLimit && 'windowMs' in config.rateLimit && 'max' in config.rateLimit\n ? config.rateLimit\n : undefined\n // theoPluginAsync auto-chains @theokit/ui + @tailwindcss/vite via\n // top-level Plugin[] return (sync `theoPlugin()` factory's config()\n // hook returning {plugins:[...]} is silently dropped by Vite — see\n // commit history). Spread the result so Vite flattens them.\n let server: ViteDevServer\n try {\n const theoPlugins = await theoPluginAsync({\n root: cwd,\n rateLimit: flatRateLimit,\n ssr: config.ssr,\n // #95 — honor config `serverDir` (default \"server\") so route/action discovery scans it.\n serverDir: config.serverDir,\n // #95 follow-up — honor config `agentsDir` (default \"agents\") for the agent scan/middleware.\n agentsDir: config.agentsDir,\n // #95 follow-up — honor config `appDir` (default \"app\") for the file-based router + SSR/client entry.\n appDir: config.appDir,\n // Wave 2 (T3.1) — wire typed-client plugin when services declared.\n services: config.services,\n // T4.1 (canvas-ecosystem-refactor / ADR D6) — passthrough peer-deps\n // that plugins import dynamically (e.g., mermaid via plugin-canvas).\n viteOptimizeDeps: config.viteOptimizeDeps,\n })\n server = await createServer({\n root: cwd,\n plugins: [react(), ...theoPlugins] as Plugin[],\n server: buildDevServerOptions(config, port),\n logLevel: options?.port === 0 ? 'silent' : undefined,\n })\n\n await server.listen()\n } catch (err) {\n // EC-1 / try-finally pattern: if Vite create/listen fails AFTER services\n // started, stop them so we don't leak child processes.\n await orchestration.stop()\n throw err\n }\n\n // EC-1 fix: attach orchestration.stop() to the underlying HTTP server's\n // close event via Node-native API. We do NOT mutate `server.close`\n // (fragile across Vite upgrades). httpServer is `http.Server | null`.\n server.httpServer?.on('close', () => {\n void orchestration.stop()\n })\n\n await startDevJobWorker(server, cwd, config)\n await startDevCrons(server, cwd, config, options?.crons === true)\n\n return server\n}\n\n/**\n * The job worker `theokit start` runs, in development too (usetheokit/theokit#1010): `ctx.queue`\n * works in dev since #1009, and a queue nothing drains would make every job untestable without a\n * production build. Job files load through Vite, like routes, and the worker stops with the server.\n */\nasync function startDevJobWorker(\n server: ViteDevServer,\n cwd: string,\n config: TheoConfig,\n): Promise<void> {\n const files = listJobFiles(resolve(cwd, config.serverDir, 'jobs'))\n const definitions = await loadJobModules(files, (filePath) => server.ssrLoadModule(filePath))\n const jobs = startJobWorker(config, definitions)\n if (jobs.summary !== undefined) console.log(`\\n ${jobs.summary}`)\n server.httpServer?.on('close', () => {\n void jobs.worker?.stop()\n })\n}\n\n/**\n * Crons in development (usetheokit/theokit#1017). `dev` had no cron code path and said nothing, so\n * a new cron neither fired nor got explained until `build` plus `start`. Scheduling is opt-in\n * (`--crons`): a cron that sends an email or charges a card should not do it on every dev boot\n * unasked. Either way the boot log says what happens to the declared crons. Files load through\n * Vite once at boot, so an edit to a cron applies after a restart. Single process, so no lock.\n */\nasync function startDevCrons(\n server: ViteDevServer,\n cwd: string,\n config: TheoConfig,\n schedule: boolean,\n): Promise<void> {\n const dirs = cronScanDirs(cwd, config.serverDir, config.agentsDir)\n const files = listCronFiles([dirs.crons, dirs.schedules])\n if (files.length === 0) return\n if (!schedule) {\n console.log(\n `\\n Crons: ${String(files.length)} declared, not scheduled in dev. ` +\n 'Run `theokit dev --crons` to schedule them (edits apply after a restart).',\n )\n return\n }\n const definitions = await loadCronModules(files, (filePath) => server.ssrLoadModule(filePath))\n const scheduler = createCronScheduler(definitions)\n scheduler.start()\n console.log(\n `\\n Crons: ${String(definitions.length)} scheduled in dev (--crons); edits apply after a restart.`,\n )\n server.httpServer?.on('close', () => {\n scheduler.stop()\n })\n}\n\nexport async function devCommand(options: DevOptions): Promise<void> {\n try {\n const cwd = process.cwd()\n const server = await startDevServer(cwd, options)\n server.printUrls()\n } catch (err) {\n const msg = err instanceof Error ? err.message : String(err)\n console.error(`\\n ✗ ${msg}\\n`)\n process.exit(1)\n }\n}\n"],"mappings":"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","names":[]}
@@ -1,5 +1,8 @@
1
1
  #!/usr/bin/env node
2
2
  import "tsx/esm";
3
+ import {
4
+ processSingleton
5
+ } from "./chunk-NF7LXSXZ.js";
3
6
 
4
7
  // src/cache/constants.ts
5
8
  var THEO_T_PREFIX = "_THEO_T_";
@@ -272,9 +275,11 @@ var InMemoryCacheAdapter = class {
272
275
  };
273
276
 
274
277
  // src/cache/engine-singleton.ts
275
- var _engine;
278
+ var holder = processSingleton("cache-engine", () => ({
279
+ engine: void 0
280
+ }));
276
281
  function initCacheEngine(config, hooks = {}) {
277
- if (_engine) {
282
+ if (holder.engine) {
278
283
  throw new Error(
279
284
  "Cache engine already initialized \u2014 call _resetCacheEngine() in tests, or check init order in production."
280
285
  );
@@ -285,26 +290,27 @@ function initCacheEngine(config, hooks = {}) {
285
290
  );
286
291
  }
287
292
  const adapter = config.storage === "memory" ? new InMemoryCacheAdapter({ maxEntries: config.maxEntries }) : config.storage;
288
- _engine = createCacheEngine({
293
+ holder.engine = createCacheEngine({
289
294
  storage: adapter,
290
295
  defaults: config.defaults,
291
296
  onError: hooks.onError
292
297
  });
293
- return _engine;
298
+ return holder.engine;
294
299
  }
295
300
  function getCacheEngine() {
296
- if (!_engine) {
301
+ const engine = holder.engine;
302
+ if (!engine) {
297
303
  throw new Error(
298
304
  "Cache engine not initialized. Ensure theo.config.ts has `cache.enabled: true` and the framework bootstrap called initCacheEngine."
299
305
  );
300
306
  }
301
- return _engine;
307
+ return engine;
302
308
  }
303
309
  function isCacheEngineInitialized() {
304
- return _engine !== void 0;
310
+ return holder.engine !== void 0;
305
311
  }
306
312
  function _resetCacheEngine() {
307
- _engine = void 0;
313
+ holder.engine = void 0;
308
314
  }
309
315
  export {
310
316
  _resetCacheEngine,
@@ -312,4 +318,4 @@ export {
312
318
  initCacheEngine,
313
319
  isCacheEngineInitialized
314
320
  };
315
- //# sourceMappingURL=engine-singleton-X4R7AZBJ.js.map
321
+ //# sourceMappingURL=engine-singleton-BQ5QOMTC.js.map
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/cache/constants.ts","../src/cache/cache-engine.ts","../src/cache/in-memory-adapter.ts","../src/cache/engine-singleton.ts"],"sourcesContent":["/**\n * Single source of truth for cache subsystem constants.\n * Limits mirror Next.js (NEXT_CACHE_TAG_MAX_LENGTH / NEXT_CACHE_TAG_MAX_ITEMS)\n * — see reference doc §3.2 and ADR D6 of caching-and-revalidation-plan.md.\n */\n\nexport const CACHE_TAG_MAX_LENGTH = 256\nexport const CACHE_TAG_MAX_ITEMS = 128\nexport const THEO_T_PREFIX = '_THEO_T_'\n\nexport const DEFAULT_MAX_AGE = 1\nexport const DEFAULT_SWR_MULTIPLIER = 60\n","import { THEO_T_PREFIX } from './constants.js'\nimport type { CacheEntry, CacheStorageAdapter } from './storage-adapter.js'\n\nexport type CacheStatus = 'hit' | 'stale' | 'miss'\n\n/**\n * Process-wide fallbacks for the options a cache wrapper takes per call site.\n *\n * The engine reads none of them: `getOrCompute` and `tryReadCached` always\n * receive explicit values. They are carried here because the engine is the one\n * object every wrapper (`defineCachedRoute`) already holds, and a wrapper with\n * no declared value has nowhere else to look. Per-call-site options always win.\n *\n * Shaped to accept `NormalizedCacheConfig['defaults']` whole (#352): every field\n * the config schema declares is honoured, none is dropped on the way in.\n */\nexport interface CacheDefaults {\n /** seconds; fallback for a wrapper that declares no `maxAge`. */\n maxAge?: number\n /** seconds; fallback stale-while-revalidate window. */\n swr?: number\n /** whether responses with status >= 400 may be cached. */\n cacheErrors?: boolean\n /** version stamp applied to entries written without an explicit one. */\n cacheVersion?: string\n}\n\nexport interface CacheEngineOptions {\n storage: CacheStorageAdapter\n defaults?: CacheDefaults\n onError?: (err: unknown, ctx: { phase: 'get' | 'set' | 'revalidate'; key: string }) => void\n}\n\nexport interface GetOrComputeOptions<T> {\n maxAge: number\n swr?: number\n tags?: string[]\n cacheVersion?: string\n transform?: (raw: T) => T\n validate?: (raw: T) => boolean\n /**\n * When `true`, the value is returned but NOT written to cache.\n * Used by route middleware to bypass cache for uncacheable responses\n * (Set-Cookie, oversized body, status >= 400 with cacheErrors=false).\n */\n skipCacheWhen?: (raw: T) => boolean\n}\n\nexport interface CacheEngine {\n getOrCompute<T>(\n key: string,\n fn: () => Promise<T>,\n opts: GetOrComputeOptions<T>,\n ): Promise<{ value: T; status: CacheStatus }>\n\n /**\n * Public canonical cache read (T4.2 of architecture-review-remediation-plan,\n * PV-5 DRY consolidation). Returns the parsed value + status (`hit` | `stale`)\n * for callers that DON'T want to bind a loader function (e.g., HTTP route\n * middleware that may want to bypass on miss instead of running a loader).\n *\n * Returns undefined when:\n * - Entry not present in storage\n * - `opts.cacheVersion` mismatch with entry\n * - Body is not a JSON string (parse failed)\n * - `opts.validate` returns false (or throws — caller's onError invoked)\n * - Entry is fully expired (past maxAge + swr)\n */\n tryReadCached<T>(\n key: string,\n opts: { cacheVersion?: string; validate?: (v: T) => boolean },\n ): Promise<{ value: T; status: 'hit' | 'stale' } | undefined>\n\n set(key: string, entry: CacheEntry): Promise<void>\n invalidate(key: string): Promise<boolean>\n invalidateTag(tag: string): Promise<number>\n revalidatePath(path: string, type?: 'layout' | 'page'): Promise<number>\n\n /** Storage adapter passthrough (read-only access for diagnostics). */\n readonly storage: CacheStorageAdapter\n\n /**\n * Process-wide defaults the wrappers fall back to. Normalized to `{}` when the\n * factory received none, so a caller never has to guard the access.\n */\n readonly defaults: CacheDefaults\n}\n\n/**\n * Build a cache engine wrapping a storage adapter.\n *\n * Implements:\n * - SWR (fresh / stale / expired branching) — Astro `memory-provider.ts:423`-style.\n * - In-flight dedupe via `Map<key, Promise>` — Next.js `pendingRevalidates` pattern.\n * - Tag-based invalidation via adapter's deleteByTag.\n * - Path-as-tag encoding (revalidatePath sugar) — Next.js `revalidate.ts:105`.\n *\n * EC-8: Math.max(0, age) guards clock skew.\n * EC-9: validate callback wrapped in try/catch.\n * EC-10: loader returning undefined skips cache write + warns once.\n *\n * NOTE on max-lines-per-function disable below: createCacheEngine is a factory\n * closure that owns the in-flight/bg/warned maps. Splitting would force the\n * helpers across modules and re-introduce the shared mutable state through\n * parameter lists.\n */\n// eslint-disable-next-line max-lines-per-function\nexport function createCacheEngine(opts: CacheEngineOptions): CacheEngine {\n const { storage, defaults = {}, onError } = opts\n const inFlight = new Map<string, Promise<unknown>>()\n const bgInFlight = new Set<string>()\n const undefinedLoaderWarned = new Set<string>()\n\n async function getOrCompute<T>(\n key: string,\n fn: () => Promise<T>,\n options: GetOrComputeOptions<T>,\n ): Promise<{ value: T; status: CacheStatus }> {\n // Dedupe: concurrent first-miss shares the loader promise\n const pending = inFlight.get(key)\n if (pending) {\n const value = (await pending) as T\n return { value, status: 'miss' }\n }\n\n // maxAge=0 → always miss, never cache\n if (options.maxAge === 0) {\n return claimAndRun(key, fn, options, /* skipWrite */ true)\n }\n\n // Atomically claim the in-flight slot BEFORE any await (dedupe race fix).\n return claimAndRun(key, fn, options, false)\n }\n\n /**\n * Claims the in-flight slot synchronously, then performs the get/loader work\n * inside. Concurrent callers awaiting the same key share this slot.\n */\n function claimAndRun<T>(\n key: string,\n fn: () => Promise<T>,\n options: GetOrComputeOptions<T>,\n skipWrite: boolean,\n ): Promise<{ value: T; status: CacheStatus }> {\n let resolveOuter!: (v: T) => void\n let rejectOuter!: (e: unknown) => void\n const outerPromise = new Promise<T>((resolve, reject) => {\n resolveOuter = resolve\n rejectOuter = reject\n })\n // Prevent unhandled-rejection when no concurrent awaiter exists\n void outerPromise.catch(() => {\n /* swallow — the leader handles via work promise */\n })\n inFlight.set(key, outerPromise)\n\n const work = (async (): Promise<{ value: T; status: CacheStatus }> => {\n try {\n if (!skipWrite) {\n const cached = await tryReadCached<T>(key, options)\n if (cached) {\n // HIT or STALE — value already resolved\n resolveOuter(cached.value)\n if (cached.status === 'stale') {\n scheduleBackgroundRevalidate(key, fn, options)\n }\n return cached\n }\n }\n // Miss path: run loader\n const value = await runLoader(key, fn, options, skipWrite)\n resolveOuter(value)\n return { value, status: 'miss' as const }\n } catch (err) {\n rejectOuter(err)\n throw err\n } finally {\n inFlight.delete(key)\n }\n })()\n\n return work\n }\n\n // One inline staleness machine; each guard (version check, parse, validate,\n // age, swr window) is one short branch. Extracting per-step would dilute,\n // not clarify.\n // eslint-disable-next-line complexity\n async function tryReadCached<T>(\n key: string,\n options: GetOrComputeOptions<T>,\n ): Promise<{ value: T; status: CacheStatus } | undefined> {\n let entry: CacheEntry | undefined\n try {\n entry = await storage.get(key)\n } catch (err) {\n onError?.(err, { phase: 'get', key })\n return undefined\n }\n if (!entry) return undefined\n if (options.cacheVersion !== undefined && entry.cacheVersion !== options.cacheVersion) {\n return undefined\n }\n if (typeof entry.body !== 'string') return undefined\n let parsed: T\n try {\n parsed = JSON.parse(entry.body) as T\n } catch (err) {\n onError?.(err, { phase: 'get', key })\n return undefined\n }\n // EC-9: validate wrapped in try/catch\n if (options.validate) {\n try {\n if (!options.validate(parsed)) return undefined\n } catch (err) {\n onError?.(err, { phase: 'get', key })\n return undefined\n }\n }\n // EC-8: clamp age to non-negative (clock skew)\n const age = Math.max(0, (Date.now() - entry.storedAt) / 1000)\n if (age <= entry.maxAge) {\n const value = options.transform ? options.transform(parsed) : parsed\n return { value, status: 'hit' }\n }\n if (age <= entry.maxAge + entry.swr) {\n const value = options.transform ? options.transform(parsed) : parsed\n return { value, status: 'stale' }\n }\n return undefined\n }\n\n // runLoader always returns `value` by design: loader output is the caller's\n // contract; every branch short-circuits a *write*, never the return path.\n // eslint-disable-next-line sonarjs/no-invariant-returns, complexity\n async function runLoader<T>(\n key: string,\n fn: () => Promise<T>,\n options: GetOrComputeOptions<T>,\n skipWrite = false,\n ): Promise<T> {\n const raw = await fn()\n const value = options.transform ? options.transform(raw) : raw\n\n if (skipWrite) return value\n\n // skipCacheWhen sentinel — caller-controlled skip-write\n if (options.skipCacheWhen?.(value)) return value\n\n // EC-9: validate during write\n if (options.validate) {\n try {\n if (!options.validate(value)) return value\n } catch (err) {\n onError?.(err, { phase: 'set', key })\n return value\n }\n }\n\n // EC-10: undefined return → warn-once + skip cache\n if (value === undefined) {\n if (!undefinedLoaderWarned.has(key)) {\n undefinedLoaderWarned.add(key)\n console.warn(`[theokit:cache] loader returned undefined for key \"${key}\"; entry not cached`)\n }\n return value\n }\n\n try {\n const entry: CacheEntry = {\n body: JSON.stringify(value),\n status: 200,\n headers: [],\n storedAt: Date.now(),\n maxAge: options.maxAge,\n swr: options.swr ?? 0,\n tags: options.tags ?? [],\n cacheVersion: options.cacheVersion,\n }\n await storage.set(key, entry)\n } catch (err) {\n onError?.(err, { phase: 'set', key })\n }\n return value\n }\n\n function scheduleBackgroundRevalidate<T>(\n key: string,\n fn: () => Promise<T>,\n options: GetOrComputeOptions<T>,\n ): void {\n if (bgInFlight.has(key)) return\n bgInFlight.add(key)\n void runLoader(key, fn, options)\n .catch((err: unknown) => {\n onError?.(err, { phase: 'revalidate', key })\n })\n .finally(() => {\n bgInFlight.delete(key)\n })\n }\n\n return {\n storage,\n defaults,\n\n getOrCompute,\n\n async tryReadCached<T>(\n key: string,\n opts: { cacheVersion?: string; validate?: (v: T) => boolean },\n ): Promise<{ value: T; status: 'hit' | 'stale' } | undefined> {\n // Delegate to internal impl (which uses the broader GetOrComputeOptions\n // type). tryReadCached never returns status: 'miss' — that codepath\n // returns undefined. Narrow the type via assertion.\n const result = await tryReadCached<T>(key, {\n ...opts,\n maxAge: 0, // unused by tryReadCached\n })\n if (!result) return undefined\n return result as { value: T; status: 'hit' | 'stale' }\n },\n\n async set(key, entry) {\n await storage.set(key, entry)\n },\n\n async invalidate(key) {\n // Best-effort: clear in-flight too so next request starts fresh\n inFlight.delete(key)\n return storage.delete(key)\n },\n\n async invalidateTag(tag) {\n return storage.deleteByTag(tag)\n },\n\n async revalidatePath(path, type) {\n const tag = THEO_T_PREFIX + path + (type ? '/' + type : '')\n return storage.deleteByTag(tag)\n },\n }\n}\n","import type { CacheEntry, CacheStorageAdapter } from './storage-adapter.js'\n\nexport interface InMemoryCacheAdapterOptions {\n /** Maximum number of entries before LRU eviction. Default 1000. */\n maxEntries?: number\n}\n\n/**\n * In-memory cache adapter with LRU eviction + reverse tag index.\n *\n * Uses Map insertion-order for O(1) LRU (Astro LRUMap pattern).\n * Reverse index `tagIndex: Map<tag, Set<key>>` makes deleteByTag O(matched-keys).\n *\n * Invariants:\n * - `entries.size <= maxEntries` post-set.\n * - `tagIndex[tag].has(key)` ↔ `entries.get(key)?.tags.includes(tag)`.\n *\n * eslint-disable @typescript-eslint/require-await — the CacheStorageAdapter\n * interface is intentionally async so Redis/file/external adapters fit. The\n * in-memory variant returns immediately but keeps the async signature to\n * satisfy the contract.\n */\n/* eslint-disable @typescript-eslint/require-await */\nexport class InMemoryCacheAdapter implements CacheStorageAdapter {\n readonly name = 'memory'\n readonly #entries = new Map<string, CacheEntry>()\n readonly #tagIndex = new Map<string, Set<string>>()\n readonly #maxEntries: number\n\n constructor(opts: InMemoryCacheAdapterOptions = {}) {\n this.#maxEntries = opts.maxEntries ?? 1000\n }\n\n async get(key: string): Promise<CacheEntry | undefined> {\n const entry = this.#entries.get(key)\n if (entry === undefined) return undefined\n // LRU bump\n this.#entries.delete(key)\n this.#entries.set(key, entry)\n return entry\n }\n\n async set(key: string, entry: CacheEntry): Promise<void> {\n // Overwrite case: clean old tags first\n const existing = this.#entries.get(key)\n if (existing) {\n this.#removeKeyFromTagIndex(key, existing.tags)\n this.#entries.delete(key)\n } else if (this.#entries.size >= this.#maxEntries) {\n // LRU eviction\n const oldestIter = this.#entries.keys().next()\n if (!oldestIter.done) {\n const oldestKey = oldestIter.value\n const oldestEntry = this.#entries.get(oldestKey)\n if (oldestEntry) {\n this.#removeKeyFromTagIndex(oldestKey, oldestEntry.tags)\n }\n this.#entries.delete(oldestKey)\n }\n }\n this.#entries.set(key, entry)\n for (const tag of entry.tags) {\n let bucket = this.#tagIndex.get(tag)\n if (!bucket) {\n bucket = new Set()\n this.#tagIndex.set(tag, bucket)\n }\n bucket.add(key)\n }\n }\n\n async delete(key: string): Promise<boolean> {\n const entry = this.#entries.get(key)\n if (!entry) return false\n this.#removeKeyFromTagIndex(key, entry.tags)\n this.#entries.delete(key)\n return true\n }\n\n async deleteByTag(tag: string): Promise<number> {\n const bucket = this.#tagIndex.get(tag)\n if (!bucket || bucket.size === 0) return 0\n const keys = [...bucket]\n for (const key of keys) {\n const entry = this.#entries.get(key)\n if (entry) {\n this.#unindexFromOtherTags(key, entry.tags, tag)\n }\n this.#entries.delete(key)\n }\n this.#tagIndex.delete(tag)\n return keys.length\n }\n\n async size(): Promise<number> {\n return this.#entries.size\n }\n\n async clear(): Promise<void> {\n this.#entries.clear()\n this.#tagIndex.clear()\n }\n\n async *keys(prefix?: string): AsyncIterableIterator<string> {\n for (const key of this.#entries.keys()) {\n if (prefix && !key.startsWith(prefix)) continue\n yield key\n }\n }\n\n #removeKeyFromTagIndex(key: string, tags: string[]): void {\n for (const tag of tags) {\n const bucket = this.#tagIndex.get(tag)\n if (!bucket) continue\n bucket.delete(key)\n if (bucket.size === 0) this.#tagIndex.delete(tag)\n }\n }\n\n #unindexFromOtherTags(key: string, tags: string[], skipTag: string): void {\n for (const otherTag of tags) {\n if (otherTag === skipTag) continue\n const otherBucket = this.#tagIndex.get(otherTag)\n if (!otherBucket) continue\n otherBucket.delete(key)\n if (otherBucket.size === 0) this.#tagIndex.delete(otherTag)\n }\n }\n}\n","import type { CacheEngine, CacheEngineOptions } from './cache-engine.js'\nimport { createCacheEngine } from './cache-engine.js'\nimport { InMemoryCacheAdapter } from './in-memory-adapter.js'\nimport type { CacheStorageAdapter } from './storage-adapter.js'\n\nexport interface NormalizedCacheConfig {\n enabled: boolean\n storage: 'memory' | CacheStorageAdapter\n maxEntries: number\n defaults: {\n maxAge: number\n swr?: number\n cacheErrors: boolean\n }\n}\n\nlet _engine: CacheEngine | undefined\n\n/**\n * Initialize the singleton cache engine for this process.\n * Throws if called twice; tests should call `_resetCacheEngine()` between.\n */\nexport function initCacheEngine(\n config: NormalizedCacheConfig,\n hooks: Pick<CacheEngineOptions, 'onError'> = {},\n): CacheEngine {\n if (_engine) {\n throw new Error(\n 'Cache engine already initialized — call _resetCacheEngine() in tests, or check init order in production.',\n )\n }\n if (!config.enabled) {\n throw new Error(\n 'initCacheEngine: config.enabled is false. Skip this call entirely when cache is disabled.',\n )\n }\n const adapter =\n config.storage === 'memory'\n ? new InMemoryCacheAdapter({ maxEntries: config.maxEntries })\n : config.storage\n _engine = createCacheEngine({\n storage: adapter,\n defaults: config.defaults,\n onError: hooks.onError,\n })\n return _engine\n}\n\n/**\n * Resolve the singleton cache engine.\n * Throws a clear error if not initialized — usually means the framework\n * bootstrap missed calling initCacheEngine, or cache.enabled is false.\n */\nexport function getCacheEngine(): CacheEngine {\n if (!_engine) {\n throw new Error(\n 'Cache engine not initialized. Ensure theo.config.ts has `cache.enabled: true` and the framework bootstrap called initCacheEngine.',\n )\n }\n return _engine\n}\n\n/**\n * Whether `initCacheEngine` has already run in this process.\n *\n * Exists so a caller can be idempotent WITHOUT wrapping `initCacheEngine` in a\n * `catch`. A boot legitimately reaches this state more than once — HMR, a second\n * server started in one process, an integration test booting twice in one worker\n * — and catching the throw to absorb that would swallow the genuine\n * double-initialisation bug the throw exists to report.\n */\nexport function isCacheEngineInitialized(): boolean {\n return _engine !== undefined\n}\n\n/**\n * Test-only: clear the singleton so the next test can re-init.\n * Production code MUST NOT call this.\n */\nexport function _resetCacheEngine(): void {\n _engine = undefined\n}\n"],"mappings":"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","names":["opts"]}
1
+ {"version":3,"sources":["../src/cache/constants.ts","../src/cache/cache-engine.ts","../src/cache/in-memory-adapter.ts","../src/cache/engine-singleton.ts"],"sourcesContent":["/**\n * Single source of truth for cache subsystem constants.\n * Limits mirror Next.js (NEXT_CACHE_TAG_MAX_LENGTH / NEXT_CACHE_TAG_MAX_ITEMS)\n * — see reference doc §3.2 and ADR D6 of caching-and-revalidation-plan.md.\n */\n\nexport const CACHE_TAG_MAX_LENGTH = 256\nexport const CACHE_TAG_MAX_ITEMS = 128\nexport const THEO_T_PREFIX = '_THEO_T_'\n\nexport const DEFAULT_MAX_AGE = 1\nexport const DEFAULT_SWR_MULTIPLIER = 60\n","import { THEO_T_PREFIX } from './constants.js'\nimport type { CacheEntry, CacheStorageAdapter } from './storage-adapter.js'\n\nexport type CacheStatus = 'hit' | 'stale' | 'miss'\n\n/**\n * Process-wide fallbacks for the options a cache wrapper takes per call site.\n *\n * The engine reads none of them: `getOrCompute` and `tryReadCached` always\n * receive explicit values. They are carried here because the engine is the one\n * object every wrapper (`defineCachedRoute`) already holds, and a wrapper with\n * no declared value has nowhere else to look. Per-call-site options always win.\n *\n * Shaped to accept `NormalizedCacheConfig['defaults']` whole (#352): every field\n * the config schema declares is honoured, none is dropped on the way in.\n */\nexport interface CacheDefaults {\n /** seconds; fallback for a wrapper that declares no `maxAge`. */\n maxAge?: number\n /** seconds; fallback stale-while-revalidate window. */\n swr?: number\n /** whether responses with status >= 400 may be cached. */\n cacheErrors?: boolean\n /** version stamp applied to entries written without an explicit one. */\n cacheVersion?: string\n}\n\nexport interface CacheEngineOptions {\n storage: CacheStorageAdapter\n defaults?: CacheDefaults\n onError?: (err: unknown, ctx: { phase: 'get' | 'set' | 'revalidate'; key: string }) => void\n}\n\nexport interface GetOrComputeOptions<T> {\n maxAge: number\n swr?: number\n tags?: string[]\n cacheVersion?: string\n transform?: (raw: T) => T\n validate?: (raw: T) => boolean\n /**\n * When `true`, the value is returned but NOT written to cache.\n * Used by route middleware to bypass cache for uncacheable responses\n * (Set-Cookie, oversized body, status >= 400 with cacheErrors=false).\n */\n skipCacheWhen?: (raw: T) => boolean\n}\n\nexport interface CacheEngine {\n getOrCompute<T>(\n key: string,\n fn: () => Promise<T>,\n opts: GetOrComputeOptions<T>,\n ): Promise<{ value: T; status: CacheStatus }>\n\n /**\n * Public canonical cache read (T4.2 of architecture-review-remediation-plan,\n * PV-5 DRY consolidation). Returns the parsed value + status (`hit` | `stale`)\n * for callers that DON'T want to bind a loader function (e.g., HTTP route\n * middleware that may want to bypass on miss instead of running a loader).\n *\n * Returns undefined when:\n * - Entry not present in storage\n * - `opts.cacheVersion` mismatch with entry\n * - Body is not a JSON string (parse failed)\n * - `opts.validate` returns false (or throws — caller's onError invoked)\n * - Entry is fully expired (past maxAge + swr)\n */\n tryReadCached<T>(\n key: string,\n opts: { cacheVersion?: string; validate?: (v: T) => boolean },\n ): Promise<{ value: T; status: 'hit' | 'stale' } | undefined>\n\n set(key: string, entry: CacheEntry): Promise<void>\n invalidate(key: string): Promise<boolean>\n invalidateTag(tag: string): Promise<number>\n revalidatePath(path: string, type?: 'layout' | 'page'): Promise<number>\n\n /** Storage adapter passthrough (read-only access for diagnostics). */\n readonly storage: CacheStorageAdapter\n\n /**\n * Process-wide defaults the wrappers fall back to. Normalized to `{}` when the\n * factory received none, so a caller never has to guard the access.\n */\n readonly defaults: CacheDefaults\n}\n\n/**\n * Build a cache engine wrapping a storage adapter.\n *\n * Implements:\n * - SWR (fresh / stale / expired branching) — Astro `memory-provider.ts:423`-style.\n * - In-flight dedupe via `Map<key, Promise>` — Next.js `pendingRevalidates` pattern.\n * - Tag-based invalidation via adapter's deleteByTag.\n * - Path-as-tag encoding (revalidatePath sugar) — Next.js `revalidate.ts:105`.\n *\n * EC-8: Math.max(0, age) guards clock skew.\n * EC-9: validate callback wrapped in try/catch.\n * EC-10: loader returning undefined skips cache write + warns once.\n *\n * NOTE on max-lines-per-function disable below: createCacheEngine is a factory\n * closure that owns the in-flight/bg/warned maps. Splitting would force the\n * helpers across modules and re-introduce the shared mutable state through\n * parameter lists.\n */\n// eslint-disable-next-line max-lines-per-function\nexport function createCacheEngine(opts: CacheEngineOptions): CacheEngine {\n const { storage, defaults = {}, onError } = opts\n const inFlight = new Map<string, Promise<unknown>>()\n const bgInFlight = new Set<string>()\n const undefinedLoaderWarned = new Set<string>()\n\n async function getOrCompute<T>(\n key: string,\n fn: () => Promise<T>,\n options: GetOrComputeOptions<T>,\n ): Promise<{ value: T; status: CacheStatus }> {\n // Dedupe: concurrent first-miss shares the loader promise\n const pending = inFlight.get(key)\n if (pending) {\n const value = (await pending) as T\n return { value, status: 'miss' }\n }\n\n // maxAge=0 → always miss, never cache\n if (options.maxAge === 0) {\n return claimAndRun(key, fn, options, /* skipWrite */ true)\n }\n\n // Atomically claim the in-flight slot BEFORE any await (dedupe race fix).\n return claimAndRun(key, fn, options, false)\n }\n\n /**\n * Claims the in-flight slot synchronously, then performs the get/loader work\n * inside. Concurrent callers awaiting the same key share this slot.\n */\n function claimAndRun<T>(\n key: string,\n fn: () => Promise<T>,\n options: GetOrComputeOptions<T>,\n skipWrite: boolean,\n ): Promise<{ value: T; status: CacheStatus }> {\n let resolveOuter!: (v: T) => void\n let rejectOuter!: (e: unknown) => void\n const outerPromise = new Promise<T>((resolve, reject) => {\n resolveOuter = resolve\n rejectOuter = reject\n })\n // Prevent unhandled-rejection when no concurrent awaiter exists\n void outerPromise.catch(() => {\n /* swallow — the leader handles via work promise */\n })\n inFlight.set(key, outerPromise)\n\n const work = (async (): Promise<{ value: T; status: CacheStatus }> => {\n try {\n if (!skipWrite) {\n const cached = await tryReadCached<T>(key, options)\n if (cached) {\n // HIT or STALE — value already resolved\n resolveOuter(cached.value)\n if (cached.status === 'stale') {\n scheduleBackgroundRevalidate(key, fn, options)\n }\n return cached\n }\n }\n // Miss path: run loader\n const value = await runLoader(key, fn, options, skipWrite)\n resolveOuter(value)\n return { value, status: 'miss' as const }\n } catch (err) {\n rejectOuter(err)\n throw err\n } finally {\n inFlight.delete(key)\n }\n })()\n\n return work\n }\n\n // One inline staleness machine; each guard (version check, parse, validate,\n // age, swr window) is one short branch. Extracting per-step would dilute,\n // not clarify.\n // eslint-disable-next-line complexity\n async function tryReadCached<T>(\n key: string,\n options: GetOrComputeOptions<T>,\n ): Promise<{ value: T; status: CacheStatus } | undefined> {\n let entry: CacheEntry | undefined\n try {\n entry = await storage.get(key)\n } catch (err) {\n onError?.(err, { phase: 'get', key })\n return undefined\n }\n if (!entry) return undefined\n if (options.cacheVersion !== undefined && entry.cacheVersion !== options.cacheVersion) {\n return undefined\n }\n if (typeof entry.body !== 'string') return undefined\n let parsed: T\n try {\n parsed = JSON.parse(entry.body) as T\n } catch (err) {\n onError?.(err, { phase: 'get', key })\n return undefined\n }\n // EC-9: validate wrapped in try/catch\n if (options.validate) {\n try {\n if (!options.validate(parsed)) return undefined\n } catch (err) {\n onError?.(err, { phase: 'get', key })\n return undefined\n }\n }\n // EC-8: clamp age to non-negative (clock skew)\n const age = Math.max(0, (Date.now() - entry.storedAt) / 1000)\n if (age <= entry.maxAge) {\n const value = options.transform ? options.transform(parsed) : parsed\n return { value, status: 'hit' }\n }\n if (age <= entry.maxAge + entry.swr) {\n const value = options.transform ? options.transform(parsed) : parsed\n return { value, status: 'stale' }\n }\n return undefined\n }\n\n // runLoader always returns `value` by design: loader output is the caller's\n // contract; every branch short-circuits a *write*, never the return path.\n // eslint-disable-next-line sonarjs/no-invariant-returns, complexity\n async function runLoader<T>(\n key: string,\n fn: () => Promise<T>,\n options: GetOrComputeOptions<T>,\n skipWrite = false,\n ): Promise<T> {\n const raw = await fn()\n const value = options.transform ? options.transform(raw) : raw\n\n if (skipWrite) return value\n\n // skipCacheWhen sentinel — caller-controlled skip-write\n if (options.skipCacheWhen?.(value)) return value\n\n // EC-9: validate during write\n if (options.validate) {\n try {\n if (!options.validate(value)) return value\n } catch (err) {\n onError?.(err, { phase: 'set', key })\n return value\n }\n }\n\n // EC-10: undefined return → warn-once + skip cache\n if (value === undefined) {\n if (!undefinedLoaderWarned.has(key)) {\n undefinedLoaderWarned.add(key)\n console.warn(`[theokit:cache] loader returned undefined for key \"${key}\"; entry not cached`)\n }\n return value\n }\n\n try {\n const entry: CacheEntry = {\n body: JSON.stringify(value),\n status: 200,\n headers: [],\n storedAt: Date.now(),\n maxAge: options.maxAge,\n swr: options.swr ?? 0,\n tags: options.tags ?? [],\n cacheVersion: options.cacheVersion,\n }\n await storage.set(key, entry)\n } catch (err) {\n onError?.(err, { phase: 'set', key })\n }\n return value\n }\n\n function scheduleBackgroundRevalidate<T>(\n key: string,\n fn: () => Promise<T>,\n options: GetOrComputeOptions<T>,\n ): void {\n if (bgInFlight.has(key)) return\n bgInFlight.add(key)\n void runLoader(key, fn, options)\n .catch((err: unknown) => {\n onError?.(err, { phase: 'revalidate', key })\n })\n .finally(() => {\n bgInFlight.delete(key)\n })\n }\n\n return {\n storage,\n defaults,\n\n getOrCompute,\n\n async tryReadCached<T>(\n key: string,\n opts: { cacheVersion?: string; validate?: (v: T) => boolean },\n ): Promise<{ value: T; status: 'hit' | 'stale' } | undefined> {\n // Delegate to internal impl (which uses the broader GetOrComputeOptions\n // type). tryReadCached never returns status: 'miss' — that codepath\n // returns undefined. Narrow the type via assertion.\n const result = await tryReadCached<T>(key, {\n ...opts,\n maxAge: 0, // unused by tryReadCached\n })\n if (!result) return undefined\n return result as { value: T; status: 'hit' | 'stale' }\n },\n\n async set(key, entry) {\n await storage.set(key, entry)\n },\n\n async invalidate(key) {\n // Best-effort: clear in-flight too so next request starts fresh\n inFlight.delete(key)\n return storage.delete(key)\n },\n\n async invalidateTag(tag) {\n return storage.deleteByTag(tag)\n },\n\n async revalidatePath(path, type) {\n const tag = THEO_T_PREFIX + path + (type ? '/' + type : '')\n return storage.deleteByTag(tag)\n },\n }\n}\n","import type { CacheEntry, CacheStorageAdapter } from './storage-adapter.js'\n\nexport interface InMemoryCacheAdapterOptions {\n /** Maximum number of entries before LRU eviction. Default 1000. */\n maxEntries?: number\n}\n\n/**\n * In-memory cache adapter with LRU eviction + reverse tag index.\n *\n * Uses Map insertion-order for O(1) LRU (Astro LRUMap pattern).\n * Reverse index `tagIndex: Map<tag, Set<key>>` makes deleteByTag O(matched-keys).\n *\n * Invariants:\n * - `entries.size <= maxEntries` post-set.\n * - `tagIndex[tag].has(key)` ↔ `entries.get(key)?.tags.includes(tag)`.\n *\n * eslint-disable @typescript-eslint/require-await — the CacheStorageAdapter\n * interface is intentionally async so Redis/file/external adapters fit. The\n * in-memory variant returns immediately but keeps the async signature to\n * satisfy the contract.\n */\n/* eslint-disable @typescript-eslint/require-await */\nexport class InMemoryCacheAdapter implements CacheStorageAdapter {\n readonly name = 'memory'\n readonly #entries = new Map<string, CacheEntry>()\n readonly #tagIndex = new Map<string, Set<string>>()\n readonly #maxEntries: number\n\n constructor(opts: InMemoryCacheAdapterOptions = {}) {\n this.#maxEntries = opts.maxEntries ?? 1000\n }\n\n async get(key: string): Promise<CacheEntry | undefined> {\n const entry = this.#entries.get(key)\n if (entry === undefined) return undefined\n // LRU bump\n this.#entries.delete(key)\n this.#entries.set(key, entry)\n return entry\n }\n\n async set(key: string, entry: CacheEntry): Promise<void> {\n // Overwrite case: clean old tags first\n const existing = this.#entries.get(key)\n if (existing) {\n this.#removeKeyFromTagIndex(key, existing.tags)\n this.#entries.delete(key)\n } else if (this.#entries.size >= this.#maxEntries) {\n // LRU eviction\n const oldestIter = this.#entries.keys().next()\n if (!oldestIter.done) {\n const oldestKey = oldestIter.value\n const oldestEntry = this.#entries.get(oldestKey)\n if (oldestEntry) {\n this.#removeKeyFromTagIndex(oldestKey, oldestEntry.tags)\n }\n this.#entries.delete(oldestKey)\n }\n }\n this.#entries.set(key, entry)\n for (const tag of entry.tags) {\n let bucket = this.#tagIndex.get(tag)\n if (!bucket) {\n bucket = new Set()\n this.#tagIndex.set(tag, bucket)\n }\n bucket.add(key)\n }\n }\n\n async delete(key: string): Promise<boolean> {\n const entry = this.#entries.get(key)\n if (!entry) return false\n this.#removeKeyFromTagIndex(key, entry.tags)\n this.#entries.delete(key)\n return true\n }\n\n async deleteByTag(tag: string): Promise<number> {\n const bucket = this.#tagIndex.get(tag)\n if (!bucket || bucket.size === 0) return 0\n const keys = [...bucket]\n for (const key of keys) {\n const entry = this.#entries.get(key)\n if (entry) {\n this.#unindexFromOtherTags(key, entry.tags, tag)\n }\n this.#entries.delete(key)\n }\n this.#tagIndex.delete(tag)\n return keys.length\n }\n\n async size(): Promise<number> {\n return this.#entries.size\n }\n\n async clear(): Promise<void> {\n this.#entries.clear()\n this.#tagIndex.clear()\n }\n\n async *keys(prefix?: string): AsyncIterableIterator<string> {\n for (const key of this.#entries.keys()) {\n if (prefix && !key.startsWith(prefix)) continue\n yield key\n }\n }\n\n #removeKeyFromTagIndex(key: string, tags: string[]): void {\n for (const tag of tags) {\n const bucket = this.#tagIndex.get(tag)\n if (!bucket) continue\n bucket.delete(key)\n if (bucket.size === 0) this.#tagIndex.delete(tag)\n }\n }\n\n #unindexFromOtherTags(key: string, tags: string[], skipTag: string): void {\n for (const otherTag of tags) {\n if (otherTag === skipTag) continue\n const otherBucket = this.#tagIndex.get(otherTag)\n if (!otherBucket) continue\n otherBucket.delete(key)\n if (otherBucket.size === 0) this.#tagIndex.delete(otherTag)\n }\n }\n}\n","import { processSingleton } from '../core/process-singleton.js'\n\nimport type { CacheEngine, CacheEngineOptions } from './cache-engine.js'\nimport { createCacheEngine } from './cache-engine.js'\nimport { InMemoryCacheAdapter } from './in-memory-adapter.js'\nimport type { CacheStorageAdapter } from './storage-adapter.js'\n\nexport interface NormalizedCacheConfig {\n enabled: boolean\n storage: 'memory' | CacheStorageAdapter\n maxEntries: number\n defaults: {\n maxAge: number\n swr?: number\n cacheErrors: boolean\n }\n}\n\n// One engine per PROCESS, not per module instance. `theokit start` initializes the engine from the\n// CLI build and `revalidateTag` reads it from the library build; a module-level `let` gave each\n// build its own copy, so the route side always saw \"not initialized\" (usetheokit/theokit#1018).\nconst holder = processSingleton('cache-engine', () => ({\n engine: undefined as CacheEngine | undefined,\n}))\n\n/**\n * Initialize the singleton cache engine for this process.\n * Throws if called twice; tests should call `_resetCacheEngine()` between.\n */\nexport function initCacheEngine(\n config: NormalizedCacheConfig,\n hooks: Pick<CacheEngineOptions, 'onError'> = {},\n): CacheEngine {\n if (holder.engine) {\n throw new Error(\n 'Cache engine already initialized — call _resetCacheEngine() in tests, or check init order in production.',\n )\n }\n if (!config.enabled) {\n throw new Error(\n 'initCacheEngine: config.enabled is false. Skip this call entirely when cache is disabled.',\n )\n }\n const adapter =\n config.storage === 'memory'\n ? new InMemoryCacheAdapter({ maxEntries: config.maxEntries })\n : config.storage\n holder.engine = createCacheEngine({\n storage: adapter,\n defaults: config.defaults,\n onError: hooks.onError,\n })\n return holder.engine\n}\n\n/**\n * Resolve the singleton cache engine.\n * Throws a clear error if not initialized — usually means the framework\n * bootstrap missed calling initCacheEngine, or cache.enabled is false.\n */\nexport function getCacheEngine(): CacheEngine {\n const engine = holder.engine\n if (!engine) {\n throw new Error(\n 'Cache engine not initialized. Ensure theo.config.ts has `cache.enabled: true` and the framework bootstrap called initCacheEngine.',\n )\n }\n return engine\n}\n\n/**\n * Whether `initCacheEngine` has already run in this process.\n *\n * Exists so a caller can be idempotent WITHOUT wrapping `initCacheEngine` in a\n * `catch`. A boot legitimately reaches this state more than once — HMR, a second\n * server started in one process, an integration test booting twice in one worker\n * — and catching the throw to absorb that would swallow the genuine\n * double-initialisation bug the throw exists to report.\n */\nexport function isCacheEngineInitialized(): boolean {\n return holder.engine !== undefined\n}\n\n/**\n * Test-only: clear the singleton so the next test can re-init.\n * Production code MUST NOT call this.\n */\nexport function _resetCacheEngine(): void {\n holder.engine = undefined\n}\n"],"mappings":"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","names":["opts"]}