@pikku/core 0.12.107 → 0.12.112

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 (594) hide show
  1. package/CHANGELOG.md +357 -0
  2. package/dist/analytics/analytics.d.ts +6 -0
  3. package/dist/analytics/analytics.js +58 -0
  4. package/dist/analytics/analytics.types.d.ts +156 -0
  5. package/dist/analytics/analytics.types.js +1 -0
  6. package/dist/analytics/anonymous-analytics-identity.d.ts +23 -0
  7. package/dist/analytics/anonymous-analytics-identity.js +27 -0
  8. package/dist/analytics/compose-analytics-identity.d.ts +14 -0
  9. package/dist/analytics/compose-analytics-identity.js +33 -0
  10. package/dist/analytics/cookie-analytics-identity.d.ts +24 -0
  11. package/dist/analytics/cookie-analytics-identity.js +37 -0
  12. package/dist/analytics/define-analytics-events.d.ts +22 -0
  13. package/dist/analytics/define-analytics-events.js +9 -0
  14. package/dist/analytics/fan-out-analytics.d.ts +15 -0
  15. package/dist/analytics/fan-out-analytics.js +36 -0
  16. package/dist/analytics/index.d.ts +13 -0
  17. package/dist/analytics/index.js +8 -0
  18. package/dist/analytics/logger-analytics-service.d.ts +14 -0
  19. package/dist/analytics/logger-analytics-service.js +23 -0
  20. package/dist/analytics/mint-cookie.d.ts +44 -0
  21. package/dist/analytics/mint-cookie.js +55 -0
  22. package/dist/dev/hot-reload.d.ts +0 -1
  23. package/dist/dev/hot-reload.js +4 -25
  24. package/dist/dev/module-runner.js +104 -25
  25. package/dist/errors/errors.d.ts +7 -0
  26. package/dist/errors/errors.js +17 -0
  27. package/dist/function/function-meta.types.d.ts +2 -0
  28. package/dist/function/function-runner.js +29 -0
  29. package/dist/function/functions.types.d.ts +22 -3
  30. package/dist/middleware/auth-apikey.d.ts +1 -1
  31. package/dist/pikku-state.d.ts +1 -1
  32. package/dist/scopes.d.ts +11 -0
  33. package/dist/scopes.js +17 -0
  34. package/dist/services/credential-wire-service.d.ts +1 -1
  35. package/dist/services/feature-flag-service.d.ts +100 -0
  36. package/dist/services/feature-flag-service.js +1 -0
  37. package/dist/services/index.d.ts +1 -0
  38. package/dist/services/meta-service.d.ts +16 -0
  39. package/dist/services/meta-service.js +19 -0
  40. package/dist/services/webhook-service.d.ts +7 -2
  41. package/dist/services/webhook-service.js +11 -6
  42. package/dist/testing/service-tests/agent-run-service-tests.d.ts +2 -2
  43. package/dist/testing/service-tests/agent-storage-service-tests.d.ts +1 -1
  44. package/dist/testing/service-tests/channel-store-tests.d.ts +1 -1
  45. package/dist/testing/service-tests/credential-service-tests.d.ts +1 -1
  46. package/dist/testing/service-tests/deployment-service-tests.d.ts +1 -1
  47. package/dist/testing/service-tests/event-hub-store-tests.d.ts +1 -1
  48. package/dist/testing/service-tests/secret-service-tests.d.ts +1 -1
  49. package/dist/testing/service-tests/session-store-tests.d.ts +1 -1
  50. package/dist/testing/service-tests/workflow-run-service-tests.d.ts +1 -1
  51. package/dist/testing/service-tests/workflow-service-tests.d.ts +1 -1
  52. package/dist/types/core.types.d.ts +23 -0
  53. package/dist/wirings/agent/agent-rpc.d.ts +1 -1
  54. package/dist/wirings/agent/agent-turn.d.ts +1 -1
  55. package/dist/wirings/agent-scorer/agent-scorer-live.d.ts +1 -1
  56. package/dist/wirings/channel/channel-common.d.ts +1 -1
  57. package/dist/wirings/channel/channel-rpc-validators.d.ts +2 -2
  58. package/dist/wirings/channel/channel-runner.d.ts +1 -1
  59. package/dist/wirings/channel/local/local-channel-runner.d.ts +1 -1
  60. package/dist/wirings/channel/serverless/serverless-channel-runner.d.ts +1 -1
  61. package/dist/wirings/cli/channel/cli-approval.d.ts +2 -2
  62. package/dist/wirings/flag/assert-feature-available.d.ts +15 -0
  63. package/dist/wirings/flag/assert-feature-available.js +23 -0
  64. package/dist/wirings/flag/cached-flag-source.d.ts +73 -0
  65. package/dist/wirings/flag/cached-flag-source.js +96 -0
  66. package/dist/wirings/flag/define-feature-flags.d.ts +33 -0
  67. package/dist/wirings/flag/define-feature-flags.js +32 -0
  68. package/dist/wirings/flag/flag.types.d.ts +97 -0
  69. package/dist/wirings/flag/flag.types.js +1 -0
  70. package/dist/wirings/flag/index.d.ts +7 -0
  71. package/dist/wirings/flag/index.js +5 -0
  72. package/dist/wirings/flag/resolve-flag.d.ts +52 -0
  73. package/dist/wirings/flag/resolve-flag.js +90 -0
  74. package/dist/wirings/flag/validate-flag-definitions.d.ts +26 -0
  75. package/dist/wirings/flag/validate-flag-definitions.js +103 -0
  76. package/dist/wirings/virtual-user/virtual-user-scaffold.d.ts +8 -8
  77. package/dist/wirings/virtual-user/virtual-user-schedule.d.ts +1 -1
  78. package/dist/wirings/workflow/workflow-queue-routing.d.ts +1 -1
  79. package/knowledge/decisions/internals/a-reset-suite-makes-the-dev-seed-the-fixture.md +50 -0
  80. package/knowledge/decisions/internals/hot-reload-reads-the-changed-source-never-a-compiled-copy.md +38 -0
  81. package/knowledge/decisions/internals/index.md +2 -0
  82. package/package.json +11 -5
  83. package/run-tests.sh +17 -9
  84. package/src/public-surface.json +26 -0
  85. package/src/agent-naming.test.ts +0 -68
  86. package/src/api-report.test.ts +0 -138
  87. package/src/app-alias-surface.test.ts +0 -179
  88. package/src/app-leaf-surface.test.ts +0 -222
  89. package/src/bootstrap-compat/root.ts +0 -20
  90. package/src/classification/column-form.test.ts +0 -97
  91. package/src/classification/column-form.ts +0 -55
  92. package/src/classification/data-classification.ts +0 -73
  93. package/src/classification/index.ts +0 -40
  94. package/src/classification/key-ids.ts +0 -2
  95. package/src/classification/secret-value.test.ts +0 -204
  96. package/src/classification/secret-value.ts +0 -106
  97. package/src/crypto-utils.test.ts +0 -668
  98. package/src/crypto-utils.ts +0 -460
  99. package/src/dev/hot-reload.test.ts +0 -587
  100. package/src/dev/hot-reload.ts +0 -225
  101. package/src/dev/module-runner.test.ts +0 -235
  102. package/src/dev/module-runner.ts +0 -138
  103. package/src/dev/reload-meta.test.ts +0 -183
  104. package/src/dev/reload-meta.ts +0 -144
  105. package/src/ecosystem-tier-removed.test.ts +0 -72
  106. package/src/env.ts +0 -1
  107. package/src/errors/error-handler.ts +0 -77
  108. package/src/errors/error.test.ts +0 -229
  109. package/src/errors/errors.ts +0 -393
  110. package/src/errors/index.ts +0 -11
  111. package/src/errors/serialized-error.ts +0 -12
  112. package/src/factory-functions.test.ts +0 -111
  113. package/src/function/abort-scope.test.ts +0 -97
  114. package/src/function/abort-scope.ts +0 -80
  115. package/src/function/function-meta.types.ts +0 -151
  116. package/src/function/function-runner.test.ts +0 -1619
  117. package/src/function/function-runner.ts +0 -499
  118. package/src/function/functions.types.ts +0 -319
  119. package/src/function/index.ts +0 -40
  120. package/src/function/list.types.test.ts +0 -100
  121. package/src/function/list.types.ts +0 -69
  122. package/src/function/pikku-request.test.ts +0 -35
  123. package/src/function/pikku-request.ts +0 -17
  124. package/src/gopass-secrets-removed.test.ts +0 -51
  125. package/src/handle-error.test.ts +0 -532
  126. package/src/handle-error.ts +0 -64
  127. package/src/middleware/auth-apikey.test.ts +0 -362
  128. package/src/middleware/auth-apikey.ts +0 -39
  129. package/src/middleware/auth-bearer.test.ts +0 -566
  130. package/src/middleware/auth-bearer.ts +0 -83
  131. package/src/middleware/auth-cookie.test.ts +0 -572
  132. package/src/middleware/auth-cookie.ts +0 -107
  133. package/src/middleware/cors.test.ts +0 -579
  134. package/src/middleware/cors.ts +0 -103
  135. package/src/middleware/index.ts +0 -30
  136. package/src/middleware/middleware-factories.ts +0 -76
  137. package/src/middleware/middleware.types.ts +0 -61
  138. package/src/middleware/remote-auth.test.ts +0 -547
  139. package/src/middleware/remote-auth.ts +0 -95
  140. package/src/middleware/remote-jobs-secret.ts +0 -35
  141. package/src/middleware/require-origin.test.ts +0 -115
  142. package/src/middleware/require-origin.ts +0 -79
  143. package/src/middleware/telemetry.ts +0 -83
  144. package/src/middleware-runner.test.ts +0 -578
  145. package/src/middleware-runner.ts +0 -232
  146. package/src/no-any-casts.test.ts +0 -57
  147. package/src/no-root-barrel.test.ts +0 -122
  148. package/src/permissions.test.ts +0 -256
  149. package/src/permissions.ts +0 -217
  150. package/src/pikku-state.test.ts +0 -198
  151. package/src/pikku-state.ts +0 -206
  152. package/src/production-barrels-stay-lean.test.ts +0 -110
  153. package/src/public-surface.test.ts +0 -133
  154. package/src/remote.test.ts +0 -173
  155. package/src/remote.ts +0 -56
  156. package/src/removed-legacy-exports.test.ts +0 -66
  157. package/src/run-tests-script.test.ts +0 -67
  158. package/src/schema.test.ts +0 -430
  159. package/src/schema.ts +0 -204
  160. package/src/scopes.test.ts +0 -203
  161. package/src/scopes.ts +0 -67
  162. package/src/services/agent-run-state-service.ts +0 -37
  163. package/src/services/agent-runner-service.ts +0 -238
  164. package/src/services/agent-storage-service.ts +0 -39
  165. package/src/services/ai-embedding-service.ts +0 -9
  166. package/src/services/audit-service.test.ts +0 -44
  167. package/src/services/audit-service.ts +0 -280
  168. package/src/services/content-service.ts +0 -65
  169. package/src/services/credential-service.ts +0 -20
  170. package/src/services/credential-wire-service.test.ts +0 -235
  171. package/src/services/credential-wire-service.ts +0 -120
  172. package/src/services/deployment-service.ts +0 -32
  173. package/src/services/email-service.test.ts +0 -100
  174. package/src/services/email-service.ts +0 -60
  175. package/src/services/email-template.test.ts +0 -311
  176. package/src/services/email-template.ts +0 -254
  177. package/src/services/file-scenario-run-store.test.ts +0 -349
  178. package/src/services/file-scenario-run-store.ts +0 -282
  179. package/src/services/gateway-service.ts +0 -5
  180. package/src/services/http-personas-converse.test.ts +0 -274
  181. package/src/services/http-personas.test.ts +0 -379
  182. package/src/services/http-personas.ts +0 -508
  183. package/src/services/in-memory-agent-run-state-service.ts +0 -87
  184. package/src/services/in-memory-queue-service.test.ts +0 -162
  185. package/src/services/in-memory-queue-service.ts +0 -78
  186. package/src/services/in-memory-session-store.test.ts +0 -58
  187. package/src/services/in-memory-session-store.ts +0 -20
  188. package/src/services/in-memory-trigger-service.ts +0 -47
  189. package/src/services/in-memory-workflow-service.test.ts +0 -430
  190. package/src/services/in-memory-workflow-service.ts +0 -595
  191. package/src/services/index.ts +0 -192
  192. package/src/services/istanbul-coverage-service.test.ts +0 -66
  193. package/src/services/istanbul-coverage-service.ts +0 -59
  194. package/src/services/jwt-service.ts +0 -15
  195. package/src/services/local-content-request-handler.test.ts +0 -240
  196. package/src/services/local-content-request-handler.ts +0 -295
  197. package/src/services/local-content.test.ts +0 -186
  198. package/src/services/local-content.ts +0 -242
  199. package/src/services/local-credential-service.ts +0 -63
  200. package/src/services/local-email-service.test.ts +0 -182
  201. package/src/services/local-email-service.ts +0 -43
  202. package/src/services/local-gateway-service.ts +0 -51
  203. package/src/services/local-secrets.test.ts +0 -95
  204. package/src/services/local-secrets.ts +0 -71
  205. package/src/services/local-variables.test.ts +0 -61
  206. package/src/services/local-variables.ts +0 -45
  207. package/src/services/logger-console.test.ts +0 -117
  208. package/src/services/logger-console.ts +0 -174
  209. package/src/services/logger.ts +0 -48
  210. package/src/services/meta-service.test.ts +0 -75
  211. package/src/services/meta-service.ts +0 -767
  212. package/src/services/persona-actor-secret.test.ts +0 -68
  213. package/src/services/persona-actor-secret.ts +0 -70
  214. package/src/services/persona-sign-in.test.ts +0 -219
  215. package/src/services/persona-sign-in.ts +0 -238
  216. package/src/services/personas-service.ts +0 -191
  217. package/src/services/pikku-user-id.test.ts +0 -62
  218. package/src/services/pikku-user-id.ts +0 -13
  219. package/src/services/queue-webhook-service.test.ts +0 -409
  220. package/src/services/queue-webhook-service.ts +0 -150
  221. package/src/services/remote-jobs.test.ts +0 -106
  222. package/src/services/remote-jobs.ts +0 -92
  223. package/src/services/scheduler-service.ts +0 -37
  224. package/src/services/schema-service.ts +0 -10
  225. package/src/services/scope-service.ts +0 -91
  226. package/src/services/scoped-credential-service.test.ts +0 -86
  227. package/src/services/scoped-credential-service.ts +0 -63
  228. package/src/services/scoped-secret-service.test.ts +0 -93
  229. package/src/services/scoped-secret-service.ts +0 -40
  230. package/src/services/secret-host-binding.test.ts +0 -138
  231. package/src/services/secret-host-binding.ts +0 -51
  232. package/src/services/secret-service.ts +0 -25
  233. package/src/services/secretless.test.ts +0 -54
  234. package/src/services/secretless.ts +0 -29
  235. package/src/services/session-store.ts +0 -9
  236. package/src/services/stub-tracker.test.ts +0 -104
  237. package/src/services/stub-tracker.ts +0 -175
  238. package/src/services/system-role-guard.test.ts +0 -96
  239. package/src/services/system-role-guard.ts +0 -71
  240. package/src/services/temporary-file-service.ts +0 -76
  241. package/src/services/trigger-service.ts +0 -5
  242. package/src/services/typed-credential-service.ts +0 -83
  243. package/src/services/typed-secret-service.test.ts +0 -204
  244. package/src/services/typed-secret-service.ts +0 -132
  245. package/src/services/typed-variables-service.test.ts +0 -166
  246. package/src/services/typed-variables-service.ts +0 -166
  247. package/src/services/user-session-service.test.ts +0 -147
  248. package/src/services/user-session-service.ts +0 -85
  249. package/src/services/v8-coverage-service.test.ts +0 -69
  250. package/src/services/v8-coverage-service.ts +0 -163
  251. package/src/services/variables-service.ts +0 -13
  252. package/src/services/webhook-service.ts +0 -147
  253. package/src/services/workflow-service.ts +0 -120
  254. package/src/side-effects-are-declared.test.ts +0 -84
  255. package/src/source-files-stay-composable.test.ts +0 -41
  256. package/src/template-alias-surface.test.ts +0 -240
  257. package/src/test-utils.ts +0 -38
  258. package/src/testing/index.ts +0 -3
  259. package/src/testing/service-tests/agent-run-service-tests.ts +0 -98
  260. package/src/testing/service-tests/agent-storage-service-tests.ts +0 -379
  261. package/src/testing/service-tests/channel-store-tests.ts +0 -98
  262. package/src/testing/service-tests/credential-service-tests.ts +0 -143
  263. package/src/testing/service-tests/deployment-service-tests.ts +0 -33
  264. package/src/testing/service-tests/event-hub-store-tests.ts +0 -48
  265. package/src/testing/service-tests/secret-service-tests.ts +0 -105
  266. package/src/testing/service-tests/session-store-tests.ts +0 -62
  267. package/src/testing/service-tests/workflow-run-service-tests.ts +0 -59
  268. package/src/testing/service-tests/workflow-service-tests.ts +0 -308
  269. package/src/testing/service-tests.ts +0 -95
  270. package/src/time-utils.test.ts +0 -56
  271. package/src/time-utils.ts +0 -89
  272. package/src/types/core.types.ts +0 -446
  273. package/src/types/index.ts +0 -25
  274. package/src/types/state.types.ts +0 -226
  275. package/src/types/typed-credentials.test.ts +0 -72
  276. package/src/utils/hash.test.ts +0 -68
  277. package/src/utils/hash.ts +0 -26
  278. package/src/utils/hmac.ts +0 -21
  279. package/src/utils/node-host-resolver.ts +0 -20
  280. package/src/utils/safe-fetch.test.ts +0 -515
  281. package/src/utils/safe-fetch.ts +0 -347
  282. package/src/utils.test.ts +0 -359
  283. package/src/utils.ts +0 -165
  284. package/src/version.test.ts +0 -80
  285. package/src/version.ts +0 -25
  286. package/src/wirings/actor-flow/actor-flow.types.ts +0 -40
  287. package/src/wirings/actor-flow/index.ts +0 -10
  288. package/src/wirings/actor-flow/run-conversation.test.ts +0 -187
  289. package/src/wirings/actor-flow/run-conversation.ts +0 -280
  290. package/src/wirings/addon/addon-auth-tags.test.ts +0 -219
  291. package/src/wirings/addon/addon-runner.ts +0 -236
  292. package/src/wirings/addon/addon-scopes.test.ts +0 -225
  293. package/src/wirings/addon/addon-secrets.test.ts +0 -391
  294. package/src/wirings/addon/index.ts +0 -12
  295. package/src/wirings/addon/remote-addon-auth.ts +0 -65
  296. package/src/wirings/addon/wire-addon.test.ts +0 -102
  297. package/src/wirings/addon/wire-addon.ts +0 -202
  298. package/src/wirings/addon/wire-remote-addon.ts +0 -41
  299. package/src/wirings/agent/agent-agui.test.ts +0 -1213
  300. package/src/wirings/agent/agent-agui.ts +0 -405
  301. package/src/wirings/agent/agent-authorization.test.ts +0 -208
  302. package/src/wirings/agent/agent-finalize.test.ts +0 -187
  303. package/src/wirings/agent/agent-finalize.ts +0 -197
  304. package/src/wirings/agent/agent-helpers.test.ts +0 -215
  305. package/src/wirings/agent/agent-helpers.ts +0 -96
  306. package/src/wirings/agent/agent-interrupt.test.ts +0 -833
  307. package/src/wirings/agent/agent-interrupt.ts +0 -400
  308. package/src/wirings/agent/agent-memory.test.ts +0 -397
  309. package/src/wirings/agent/agent-memory.ts +0 -496
  310. package/src/wirings/agent/agent-middleware.types.test.ts +0 -41
  311. package/src/wirings/agent/agent-model-config.test.ts +0 -103
  312. package/src/wirings/agent/agent-model-config.ts +0 -59
  313. package/src/wirings/agent/agent-prepare.test.ts +0 -977
  314. package/src/wirings/agent/agent-prepare.ts +0 -1083
  315. package/src/wirings/agent/agent-registry.test.ts +0 -455
  316. package/src/wirings/agent/agent-registry.ts +0 -99
  317. package/src/wirings/agent/agent-resume-authorization.test.ts +0 -206
  318. package/src/wirings/agent/agent-rpc.ts +0 -116
  319. package/src/wirings/agent/agent-runner.test.ts +0 -1229
  320. package/src/wirings/agent/agent-runner.ts +0 -858
  321. package/src/wirings/agent/agent-stream-delegate.test.ts +0 -381
  322. package/src/wirings/agent/agent-stream-output-hooks.test.ts +0 -353
  323. package/src/wirings/agent/agent-stream.test.ts +0 -1800
  324. package/src/wirings/agent/agent-stream.ts +0 -1639
  325. package/src/wirings/agent/agent-thread-ownership.test.ts +0 -297
  326. package/src/wirings/agent/agent-turn.test.ts +0 -65
  327. package/src/wirings/agent/agent-turn.ts +0 -122
  328. package/src/wirings/agent/agent-utils.ts +0 -20
  329. package/src/wirings/agent/agent.types.ts +0 -676
  330. package/src/wirings/agent/index.ts +0 -58
  331. package/src/wirings/agent/voice-input.test.ts +0 -220
  332. package/src/wirings/agent/voice-input.ts +0 -180
  333. package/src/wirings/agent/voice-output.test.ts +0 -510
  334. package/src/wirings/agent/voice-output.ts +0 -311
  335. package/src/wirings/agent-scorer/agent-scorer-grade.test.ts +0 -106
  336. package/src/wirings/agent-scorer/agent-scorer-grade.ts +0 -55
  337. package/src/wirings/agent-scorer/agent-scorer-judge.test.ts +0 -285
  338. package/src/wirings/agent-scorer/agent-scorer-judge.ts +0 -180
  339. package/src/wirings/agent-scorer/agent-scorer-live.test.ts +0 -174
  340. package/src/wirings/agent-scorer/agent-scorer-live.ts +0 -56
  341. package/src/wirings/agent-scorer/agent-scorer-registry.ts +0 -66
  342. package/src/wirings/agent-scorer/agent-scorer-sampling.test.ts +0 -34
  343. package/src/wirings/agent-scorer/agent-scorer-sampling.ts +0 -36
  344. package/src/wirings/agent-scorer/agent-scorer-snapshots.test.ts +0 -49
  345. package/src/wirings/agent-scorer/agent-scorer-snapshots.ts +0 -46
  346. package/src/wirings/agent-scorer/agent-scorer-worker.test.ts +0 -122
  347. package/src/wirings/agent-scorer/agent-scorer-worker.ts +0 -71
  348. package/src/wirings/agent-scorer/agent-scorer.ts +0 -102
  349. package/src/wirings/agent-scorer/agent-scorer.types.ts +0 -128
  350. package/src/wirings/agent-scorer/index.ts +0 -23
  351. package/src/wirings/channel/channel-common.ts +0 -102
  352. package/src/wirings/channel/channel-handler-shapes.test.ts +0 -72
  353. package/src/wirings/channel/channel-handler.test.ts +0 -322
  354. package/src/wirings/channel/channel-handler.ts +0 -259
  355. package/src/wirings/channel/channel-host-rpc.test.ts +0 -150
  356. package/src/wirings/channel/channel-host-rpc.ts +0 -69
  357. package/src/wirings/channel/channel-middleware-runner.test.ts +0 -188
  358. package/src/wirings/channel/channel-middleware-runner.ts +0 -126
  359. package/src/wirings/channel/channel-rpc-registry.ts +0 -116
  360. package/src/wirings/channel/channel-rpc-responder.ts +0 -117
  361. package/src/wirings/channel/channel-rpc-service.ts +0 -132
  362. package/src/wirings/channel/channel-rpc-validators.ts +0 -65
  363. package/src/wirings/channel/channel-rpc.test.ts +0 -841
  364. package/src/wirings/channel/channel-rpc.ts +0 -5
  365. package/src/wirings/channel/channel-rpc.types.ts +0 -160
  366. package/src/wirings/channel/channel-runner.ts +0 -164
  367. package/src/wirings/channel/channel-store.ts +0 -35
  368. package/src/wirings/channel/channel.types.ts +0 -193
  369. package/src/wirings/channel/define-channel-routes.ts +0 -5
  370. package/src/wirings/channel/eventhub-service.ts +0 -16
  371. package/src/wirings/channel/eventhub-store.ts +0 -13
  372. package/src/wirings/channel/index.ts +0 -40
  373. package/src/wirings/channel/local/index.ts +0 -3
  374. package/src/wirings/channel/local/local-channel-handler.ts +0 -98
  375. package/src/wirings/channel/local/local-channel-runner.test.ts +0 -339
  376. package/src/wirings/channel/local/local-channel-runner.ts +0 -271
  377. package/src/wirings/channel/local/local-eventhub-service.test.ts +0 -77
  378. package/src/wirings/channel/local/local-eventhub-service.ts +0 -69
  379. package/src/wirings/channel/log-channels.ts +0 -16
  380. package/src/wirings/channel/pikku-abstract-channel-handler.test.ts +0 -135
  381. package/src/wirings/channel/pikku-abstract-channel-handler.ts +0 -60
  382. package/src/wirings/channel/serverless/index.ts +0 -6
  383. package/src/wirings/channel/serverless/serverless-channel-runner.ts +0 -328
  384. package/src/wirings/cli/channel/cli-approval.test.ts +0 -177
  385. package/src/wirings/cli/channel/cli-approval.ts +0 -135
  386. package/src/wirings/cli/channel/cli-channel-runner.ts +0 -118
  387. package/src/wirings/cli/channel/cli-raw-channel-runner.test.ts +0 -192
  388. package/src/wirings/cli/channel/cli-raw-channel-runner.ts +0 -148
  389. package/src/wirings/cli/channel/cli-raw-client-runner.test.ts +0 -480
  390. package/src/wirings/cli/channel/cli-raw-client-runner.ts +0 -188
  391. package/src/wirings/cli/channel/index.ts +0 -6
  392. package/src/wirings/cli/cli-runner.test.ts +0 -969
  393. package/src/wirings/cli/cli-runner.ts +0 -538
  394. package/src/wirings/cli/cli.types.ts +0 -388
  395. package/src/wirings/cli/command-parser.test.ts +0 -1120
  396. package/src/wirings/cli/command-parser.ts +0 -713
  397. package/src/wirings/cli/define-cli-commands.ts +0 -13
  398. package/src/wirings/cli/format-cli-error.test.ts +0 -91
  399. package/src/wirings/cli/format-cli-error.ts +0 -96
  400. package/src/wirings/cli/index.ts +0 -19
  401. package/src/wirings/credential/credential.types.ts +0 -37
  402. package/src/wirings/credential/define-credential.ts +0 -49
  403. package/src/wirings/credential/index.ts +0 -7
  404. package/src/wirings/credential/validate-credential-definitions.ts +0 -63
  405. package/src/wirings/gateway/gateway-authorization.test.ts +0 -575
  406. package/src/wirings/gateway/gateway-channel-meta.test.ts +0 -44
  407. package/src/wirings/gateway/gateway-runner.test.ts +0 -581
  408. package/src/wirings/gateway/gateway-runner.ts +0 -411
  409. package/src/wirings/gateway/gateway.types.ts +0 -137
  410. package/src/wirings/gateway/index.ts +0 -15
  411. package/src/wirings/http/http-routes.test.ts +0 -318
  412. package/src/wirings/http/http-routes.ts +0 -111
  413. package/src/wirings/http/http-runner-addon-ref.test.ts +0 -238
  414. package/src/wirings/http/http-runner.test.ts +0 -503
  415. package/src/wirings/http/http-runner.ts +0 -462
  416. package/src/wirings/http/http.types.ts +0 -307
  417. package/src/wirings/http/index.ts +0 -27
  418. package/src/wirings/http/log-http-routes.ts +0 -18
  419. package/src/wirings/http/pikku-fetch-http-request.test.ts +0 -318
  420. package/src/wirings/http/pikku-fetch-http-request.ts +0 -260
  421. package/src/wirings/http/pikku-fetch-http-response.test.ts +0 -123
  422. package/src/wirings/http/pikku-fetch-http-response.ts +0 -149
  423. package/src/wirings/http/routers/http-router.ts +0 -13
  424. package/src/wirings/http/routers/path-to-regex.test.ts +0 -306
  425. package/src/wirings/http/routers/path-to-regex.ts +0 -115
  426. package/src/wirings/http/web-request.test.ts +0 -382
  427. package/src/wirings/http/web-request.ts +0 -162
  428. package/src/wirings/mcp/index.ts +0 -26
  429. package/src/wirings/mcp/mcp-endpoint-registry.test.ts +0 -388
  430. package/src/wirings/mcp/mcp-endpoint-registry.ts +0 -159
  431. package/src/wirings/mcp/mcp-runner.test.ts +0 -588
  432. package/src/wirings/mcp/mcp-runner.ts +0 -330
  433. package/src/wirings/mcp/mcp.types.ts +0 -199
  434. package/src/wirings/node/index.ts +0 -2
  435. package/src/wirings/node/node.types.ts +0 -23
  436. package/src/wirings/oauth2/index.ts +0 -1
  437. package/src/wirings/oauth2/oauth2.types.ts +0 -12
  438. package/src/wirings/persona/define-personas.ts +0 -33
  439. package/src/wirings/persona/index.ts +0 -75
  440. package/src/wirings/persona/persona-app-scopes.test.ts +0 -47
  441. package/src/wirings/persona/persona-app-scopes.ts +0 -74
  442. package/src/wirings/persona/persona-email.ts +0 -87
  443. package/src/wirings/persona/persona-environments.test.ts +0 -194
  444. package/src/wirings/persona/persona-environments.ts +0 -138
  445. package/src/wirings/persona/persona-mailbox.ts +0 -156
  446. package/src/wirings/persona/persona.test.ts +0 -230
  447. package/src/wirings/persona/persona.types.ts +0 -156
  448. package/src/wirings/persona/validate-personas.ts +0 -137
  449. package/src/wirings/queue/index.ts +0 -29
  450. package/src/wirings/queue/queue-identity.test.ts +0 -454
  451. package/src/wirings/queue/queue-identity.ts +0 -176
  452. package/src/wirings/queue/queue-runner.test.ts +0 -705
  453. package/src/wirings/queue/queue-runner.ts +0 -181
  454. package/src/wirings/queue/queue.types.ts +0 -161
  455. package/src/wirings/queue/register-queue-helper.ts +0 -46
  456. package/src/wirings/queue/signed-queue-service.ts +0 -60
  457. package/src/wirings/queue/validate-worker-config.test.ts +0 -108
  458. package/src/wirings/queue/validate-worker-config.ts +0 -90
  459. package/src/wirings/role/define-system-role.ts +0 -33
  460. package/src/wirings/role/index.ts +0 -13
  461. package/src/wirings/role/role.test.ts +0 -104
  462. package/src/wirings/role/role.types.ts +0 -47
  463. package/src/wirings/role/validate-role-definitions.ts +0 -93
  464. package/src/wirings/rpc/index.ts +0 -8
  465. package/src/wirings/rpc/rpc-runner.test.ts +0 -1130
  466. package/src/wirings/rpc/rpc-runner.ts +0 -569
  467. package/src/wirings/rpc/rpc-types.ts +0 -87
  468. package/src/wirings/scheduler/index.ts +0 -11
  469. package/src/wirings/scheduler/log-schedulers.ts +0 -16
  470. package/src/wirings/scheduler/scheduler-runner.test.ts +0 -835
  471. package/src/wirings/scheduler/scheduler-runner.ts +0 -138
  472. package/src/wirings/scheduler/scheduler.types.ts +0 -42
  473. package/src/wirings/scope/define-scope.ts +0 -33
  474. package/src/wirings/scope/index.ts +0 -15
  475. package/src/wirings/scope/scope.test.ts +0 -159
  476. package/src/wirings/scope/scope.types.ts +0 -42
  477. package/src/wirings/scope/validate-scope-definitions.ts +0 -107
  478. package/src/wirings/secret/index.ts +0 -9
  479. package/src/wirings/secret/secret.types.ts +0 -70
  480. package/src/wirings/secret/validate-secret-definitions.test.ts +0 -232
  481. package/src/wirings/secret/validate-secret-definitions.ts +0 -88
  482. package/src/wirings/trigger/index.ts +0 -9
  483. package/src/wirings/trigger/pikku-trigger-service.ts +0 -107
  484. package/src/wirings/trigger/trigger-runner.test.ts +0 -78
  485. package/src/wirings/trigger/trigger-runner.ts +0 -113
  486. package/src/wirings/trigger/trigger.types.ts +0 -100
  487. package/src/wirings/variable/index.ts +0 -8
  488. package/src/wirings/variable/validate-variable-definitions.test.ts +0 -115
  489. package/src/wirings/variable/validate-variable-definitions.ts +0 -71
  490. package/src/wirings/variable/variable.types.ts +0 -40
  491. package/src/wirings/virtual-user/index.ts +0 -107
  492. package/src/wirings/virtual-user/prepare-virtual-user-run.test.ts +0 -115
  493. package/src/wirings/virtual-user/prepare-virtual-user-run.ts +0 -95
  494. package/src/wirings/virtual-user/run-virtual-user.test.ts +0 -774
  495. package/src/wirings/virtual-user/run-virtual-user.ts +0 -684
  496. package/src/wirings/virtual-user/virtual-user-agents.test.ts +0 -72
  497. package/src/wirings/virtual-user/virtual-user-agents.ts +0 -62
  498. package/src/wirings/virtual-user/virtual-user-catalogue.test.ts +0 -215
  499. package/src/wirings/virtual-user/virtual-user-catalogue.ts +0 -184
  500. package/src/wirings/virtual-user/virtual-user-derive.test.ts +0 -426
  501. package/src/wirings/virtual-user/virtual-user-derive.ts +0 -161
  502. package/src/wirings/virtual-user/virtual-user-dispositions.test.ts +0 -68
  503. package/src/wirings/virtual-user/virtual-user-dispositions.ts +0 -210
  504. package/src/wirings/virtual-user/virtual-user-intents.test.ts +0 -218
  505. package/src/wirings/virtual-user/virtual-user-intents.ts +0 -185
  506. package/src/wirings/virtual-user/virtual-user-rng.test.ts +0 -72
  507. package/src/wirings/virtual-user/virtual-user-rng.ts +0 -50
  508. package/src/wirings/virtual-user/virtual-user-run-store.ts +0 -131
  509. package/src/wirings/virtual-user/virtual-user-scaffold.test.ts +0 -854
  510. package/src/wirings/virtual-user/virtual-user-scaffold.ts +0 -664
  511. package/src/wirings/virtual-user/virtual-user-schedule-store.ts +0 -93
  512. package/src/wirings/virtual-user/virtual-user-schedule.test.ts +0 -280
  513. package/src/wirings/virtual-user/virtual-user-schedule.ts +0 -156
  514. package/src/wirings/virtual-user/virtual-user-target.ts +0 -47
  515. package/src/wirings/virtual-user/virtual-user.types.ts +0 -215
  516. package/src/wirings/workflow/dsl/workflow-dsl.types.ts +0 -709
  517. package/src/wirings/workflow/dsl/workflow-runner.ts +0 -25
  518. package/src/wirings/workflow/feature.test.ts +0 -131
  519. package/src/wirings/workflow/feature.ts +0 -59
  520. package/src/wirings/workflow/graph/graph-foreach-queued.test.ts +0 -569
  521. package/src/wirings/workflow/graph/graph-foreach.test.ts +0 -626
  522. package/src/wirings/workflow/graph/graph-node.ts +0 -115
  523. package/src/wirings/workflow/graph/graph-runner.test.ts +0 -1049
  524. package/src/wirings/workflow/graph/graph-runner.ts +0 -1376
  525. package/src/wirings/workflow/graph/graph-validation.test.ts +0 -27
  526. package/src/wirings/workflow/graph/graph-validation.ts +0 -41
  527. package/src/wirings/workflow/graph/template.test.ts +0 -49
  528. package/src/wirings/workflow/graph/template.ts +0 -42
  529. package/src/wirings/workflow/graph/wire-workflow-graph.ts +0 -39
  530. package/src/wirings/workflow/graph/workflow-graph.types.ts +0 -75
  531. package/src/wirings/workflow/index.ts +0 -107
  532. package/src/wirings/workflow/pikku-scenario-service.ts +0 -1013
  533. package/src/wirings/workflow/pikku-workflow-service.test.ts +0 -963
  534. package/src/wirings/workflow/pikku-workflow-service.ts +0 -1993
  535. package/src/wirings/workflow/run-timeline.test.ts +0 -199
  536. package/src/wirings/workflow/run-timeline.ts +0 -185
  537. package/src/wirings/workflow/scenario-cookie-jar.test.ts +0 -107
  538. package/src/wirings/workflow/scenario-cookie-jar.ts +0 -57
  539. package/src/wirings/workflow/scenario-expectations.test.ts +0 -238
  540. package/src/wirings/workflow/scenario-hooks.test.ts +0 -259
  541. package/src/wirings/workflow/scenario-poll.test.ts +0 -64
  542. package/src/wirings/workflow/scenario-poll.ts +0 -27
  543. package/src/wirings/workflow/scenario-prose.test.ts +0 -275
  544. package/src/wirings/workflow/scenario-prose.ts +0 -86
  545. package/src/wirings/workflow/scenario-run.types.ts +0 -193
  546. package/src/wirings/workflow/scenario-service.test.ts +0 -147
  547. package/src/wirings/workflow/scenario-step-guards.ts +0 -23
  548. package/src/wirings/workflow/scenario-step.test.ts +0 -800
  549. package/src/wirings/workflow/scenario-step.types.ts +0 -262
  550. package/src/wirings/workflow/scenario-surface.test.ts +0 -146
  551. package/src/wirings/workflow/scenario-surface.ts +0 -71
  552. package/src/wirings/workflow/scenario.types.ts +0 -63
  553. package/src/wirings/workflow/workflow-approval-audit.ts +0 -47
  554. package/src/wirings/workflow/workflow-approval-policy.test.ts +0 -594
  555. package/src/wirings/workflow/workflow-approval-policy.ts +0 -68
  556. package/src/wirings/workflow/workflow-approval.ts +0 -290
  557. package/src/wirings/workflow/workflow-child-run-session.test.ts +0 -168
  558. package/src/wirings/workflow/workflow-constants.ts +0 -66
  559. package/src/wirings/workflow/workflow-dispatch-durability.test.ts +0 -116
  560. package/src/wirings/workflow/workflow-dispatch-payload.test.ts +0 -55
  561. package/src/wirings/workflow/workflow-dispatch-relay.test.ts +0 -128
  562. package/src/wirings/workflow/workflow-errors.ts +0 -132
  563. package/src/wirings/workflow/workflow-inline-authority.test.ts +0 -175
  564. package/src/wirings/workflow/workflow-invocation-id.test.ts +0 -51
  565. package/src/wirings/workflow/workflow-invocation-id.ts +0 -28
  566. package/src/wirings/workflow/workflow-meta-resolver.ts +0 -45
  567. package/src/wirings/workflow/workflow-mirror.test.ts +0 -171
  568. package/src/wirings/workflow/workflow-missing-meta.test.ts +0 -92
  569. package/src/wirings/workflow/workflow-on-error.test.ts +0 -145
  570. package/src/wirings/workflow/workflow-queue-routing.ts +0 -129
  571. package/src/wirings/workflow/workflow-queue-wiring.ts +0 -149
  572. package/src/wirings/workflow/workflow-queue-workers.test.ts +0 -131
  573. package/src/wirings/workflow/workflow-queue-workers.ts +0 -66
  574. package/src/wirings/workflow/workflow-recovery.ts +0 -192
  575. package/src/wirings/workflow/workflow-replay-snapshot.test.ts +0 -140
  576. package/src/wirings/workflow/workflow-retry-policy.test.ts +0 -113
  577. package/src/wirings/workflow/workflow-run-authority.test.ts +0 -212
  578. package/src/wirings/workflow/workflow-run-context.test.ts +0 -172
  579. package/src/wirings/workflow/workflow-run-engine.types.ts +0 -92
  580. package/src/wirings/workflow/workflow-run-ownership.ts +0 -37
  581. package/src/wirings/workflow/workflow-run-polling.test.ts +0 -127
  582. package/src/wirings/workflow/workflow-stalled-recovery.test.ts +0 -152
  583. package/src/wirings/workflow/workflow-status-stream.test.ts +0 -354
  584. package/src/wirings/workflow/workflow-status-stream.ts +0 -144
  585. package/src/wirings/workflow/workflow-step-claim.ts +0 -46
  586. package/src/wirings/workflow/workflow-step-ordinal.test.ts +0 -94
  587. package/src/wirings/workflow/workflow-step-session.test.ts +0 -87
  588. package/src/wirings/workflow/workflow-suspend.ts +0 -61
  589. package/src/wirings/workflow/workflow-terminal-run-guard.test.ts +0 -105
  590. package/src/wirings/workflow/workflow.types.ts +0 -268
  591. package/src/wirings-stay-decoupled.test.ts +0 -130
  592. package/tsconfig.json +0 -14
  593. package/tsconfig.tsbuildinfo +0 -1
  594. package/tsconfig.type-tests.json +0 -15
@@ -1,835 +0,0 @@
1
- import { describe, test, beforeEach } from 'node:test'
2
- import assert from 'node:assert/strict'
3
- import {
4
- wireScheduler,
5
- runScheduledTask,
6
- getScheduledTasks,
7
- } from './scheduler-runner.js'
8
- import { resetPikkuState, pikkuState } from '../../pikku-state.js'
9
- import type { CoreScheduledTask } from './scheduler.types.js'
10
- import type { CoreUserSession } from '../../types/core.types.js'
11
-
12
- beforeEach(() => {
13
- resetPikkuState()
14
- })
15
-
16
- const createMockLogger = () => {
17
- const logs: Array<{ level: string; message: string; error?: any }> = []
18
- return {
19
- info: (msg: string) => logs.push({ level: 'info', message: msg }),
20
- warn: (msg: string) => logs.push({ level: 'warn', message: msg }),
21
- error: (msg: string, error?: any) =>
22
- logs.push({ level: 'error', message: msg, error }),
23
- debug: (msg: string) => logs.push({ level: 'debug', message: msg }),
24
- getLogs: () => logs,
25
- }
26
- }
27
-
28
- describe('wireScheduler', () => {
29
- test('should successfully wire a scheduled task', () => {
30
- const mockTask: CoreScheduledTask = {
31
- name: 'test-task',
32
- schedule: '0 0 * * *',
33
- func: {
34
- func: async () => {},
35
- auth: false,
36
- },
37
- }
38
-
39
- pikkuState(null, 'scheduler', 'meta')['test-task'] = {
40
- pikkuFuncId: 'scheduler_test-task',
41
- name: 'test-task',
42
- schedule: '0 0 * * *',
43
- }
44
-
45
- wireScheduler(mockTask)
46
-
47
- const tasks = pikkuState(null, 'scheduler', 'tasks')
48
- assert.equal(tasks.has('test-task'), true)
49
- assert.equal(tasks.get('test-task'), mockTask)
50
- })
51
-
52
- test('should skip when scheduled task metadata not found', () => {
53
- const mockTask: CoreScheduledTask = {
54
- name: 'missing-meta-task',
55
- schedule: '0 0 * * *',
56
- func: {
57
- func: async () => {},
58
- auth: false,
59
- },
60
- }
61
-
62
- wireScheduler(mockTask)
63
-
64
- const tasks = pikkuState(null, 'scheduler', 'tasks')
65
- assert.equal(tasks.has('missing-meta-task'), false)
66
- })
67
-
68
- test('should throw error when scheduled task already exists', () => {
69
- const mockTask: CoreScheduledTask = {
70
- name: 'duplicate-task',
71
- schedule: '0 0 * * *',
72
- func: {
73
- func: async () => {},
74
- auth: false,
75
- },
76
- }
77
-
78
- pikkuState(null, 'scheduler', 'meta')['duplicate-task'] = {
79
- pikkuFuncId: 'scheduler_duplicate-task',
80
- name: 'duplicate-task',
81
- schedule: '0 0 * * *',
82
- }
83
-
84
- wireScheduler(mockTask)
85
-
86
- assert.throws(
87
- () => wireScheduler(mockTask),
88
- (error: any) => {
89
- assert.equal(
90
- error.message,
91
- 'Scheduled task already exists: duplicate-task'
92
- )
93
- return true
94
- }
95
- )
96
- })
97
-
98
- test('should wire task with middleware and tags', () => {
99
- const middleware = async (services: any, wire: any, next: any) => {
100
- await next()
101
- }
102
-
103
- const mockTask: CoreScheduledTask = {
104
- name: 'task-with-middleware',
105
- schedule: '0 0 * * *',
106
- func: {
107
- func: async () => {},
108
- auth: false,
109
- middleware: [middleware],
110
- tags: ['admin'],
111
- },
112
- middleware: [middleware],
113
- tags: ['scheduled'],
114
- }
115
-
116
- pikkuState(null, 'scheduler', 'meta')['task-with-middleware'] = {
117
- pikkuFuncId: 'scheduler_task-with-middleware',
118
- name: 'task-with-middleware',
119
- schedule: '0 0 * * *',
120
- }
121
-
122
- wireScheduler(mockTask)
123
-
124
- const tasks = pikkuState(null, 'scheduler', 'tasks')
125
- const task = tasks.get('task-with-middleware')
126
- assert.equal(task?.middleware?.length, 1)
127
- assert.deepEqual(task?.tags, ['scheduled'])
128
- })
129
- })
130
-
131
- describe('runScheduledTask', () => {
132
- test('should successfully run a scheduled task', async () => {
133
- let taskExecuted = false
134
-
135
- const mockTask: CoreScheduledTask = {
136
- name: 'simple-task',
137
- schedule: '0 0 * * *',
138
- func: {
139
- func: async () => {
140
- taskExecuted = true
141
- },
142
- auth: false,
143
- },
144
- }
145
-
146
- pikkuState(null, 'scheduler', 'meta')['simple-task'] = {
147
- pikkuFuncId: 'scheduler_simple-task',
148
- name: 'simple-task',
149
- schedule: '0 0 * * *',
150
- }
151
- pikkuState(null, 'function', 'meta')['scheduler_simple-task'] = {
152
- pikkuFuncId: 'scheduler_simple-task',
153
- inputSchemaName: null,
154
- outputSchemaName: null,
155
- sessionless: true,
156
- }
157
- wireScheduler(mockTask)
158
-
159
- const mockLogger = createMockLogger()
160
- pikkuState(null, 'package', 'singletonServices', {
161
- logger: mockLogger,
162
- } as any)
163
- await runScheduledTask({
164
- name: 'simple-task',
165
- })
166
-
167
- assert.equal(taskExecuted, true)
168
-
169
- const logs = mockLogger.getLogs()
170
- assert.equal(logs.length, 1)
171
- assert.equal(logs[0].level, 'info')
172
- assert(logs[0].message.includes('Running schedule task: simple-task'))
173
- })
174
-
175
- test('should run task with session', async () => {
176
- let receivedSession: CoreUserSession | undefined
177
-
178
- const mockTask: CoreScheduledTask = {
179
- name: 'task-with-session',
180
- schedule: '0 0 * * *',
181
- func: {
182
- func: async (services: any, data: any, wire: any) => {
183
- receivedSession = await wire.getSession()
184
- },
185
- auth: false,
186
- },
187
- }
188
-
189
- pikkuState(null, 'scheduler', 'meta')['task-with-session'] = {
190
- pikkuFuncId: 'scheduler_task-with-session',
191
- name: 'task-with-session',
192
- schedule: '0 0 * * *',
193
- }
194
- pikkuState(null, 'function', 'meta')['scheduler_task-with-session'] = {
195
- pikkuFuncId: 'scheduler_task-with-session',
196
- inputSchemaName: null,
197
- outputSchemaName: null,
198
- sessionless: true,
199
- }
200
- wireScheduler(mockTask)
201
-
202
- const mockLogger = createMockLogger()
203
- pikkuState(null, 'package', 'singletonServices', {
204
- logger: mockLogger,
205
- } as any)
206
- const session: CoreUserSession = { userId: 'user123' }
207
-
208
- await runScheduledTask({
209
- name: 'task-with-session',
210
- session,
211
- })
212
-
213
- assert.deepEqual(receivedSession, session)
214
- })
215
-
216
- test('a task middleware can set the session the task runs as', async () => {
217
- let frozenSession: CoreUserSession | undefined
218
- const machineSession: CoreUserSession = {
219
- userId: 'cron:machine-session-task',
220
- }
221
-
222
- const mockTask: CoreScheduledTask = {
223
- name: 'machine-session-task',
224
- schedule: '0 0 * * *',
225
- middleware: [
226
- async (_services: any, wire: any, next: any) => {
227
- wire.setSession(machineSession)
228
- return next()
229
- },
230
- ] as any,
231
- func: {
232
- func: async (_services: any, _data: any, wire: any) => {
233
- frozenSession = wire.session
234
- },
235
- auth: false,
236
- },
237
- }
238
-
239
- pikkuState(null, 'scheduler', 'meta')['machine-session-task'] = {
240
- pikkuFuncId: 'scheduler_machine-session-task',
241
- name: 'machine-session-task',
242
- schedule: '0 0 * * *',
243
- }
244
- pikkuState(null, 'function', 'meta')['scheduler_machine-session-task'] = {
245
- pikkuFuncId: 'scheduler_machine-session-task',
246
- inputSchemaName: null,
247
- outputSchemaName: null,
248
- sessionless: true,
249
- }
250
- wireScheduler(mockTask)
251
-
252
- pikkuState(null, 'package', 'singletonServices', {
253
- logger: createMockLogger(),
254
- } as any)
255
-
256
- await runScheduledTask({ name: 'machine-session-task' })
257
-
258
- assert.deepEqual(frozenSession, machineSession)
259
- })
260
-
261
- test('a session-taking task does not warn that auth was disabled', async () => {
262
- const mockTask: CoreScheduledTask = {
263
- name: 'identified-task',
264
- schedule: '0 0 * * *',
265
- middleware: [
266
- async (_services: any, wire: any, next: any) => {
267
- wire.setSession({ userId: 'cron:identified-task' })
268
- return next()
269
- },
270
- ] as any,
271
- func: {
272
- func: async () => {},
273
- },
274
- }
275
-
276
- pikkuState(null, 'scheduler', 'meta')['identified-task'] = {
277
- pikkuFuncId: 'scheduler_identified-task',
278
- name: 'identified-task',
279
- schedule: '0 0 * * *',
280
- }
281
- pikkuState(null, 'function', 'meta')['scheduler_identified-task'] = {
282
- pikkuFuncId: 'scheduler_identified-task',
283
- inputSchemaName: null,
284
- outputSchemaName: null,
285
- sessionless: false,
286
- }
287
- wireScheduler(mockTask)
288
-
289
- const mockLogger = createMockLogger()
290
- pikkuState(null, 'package', 'singletonServices', {
291
- logger: mockLogger,
292
- } as any)
293
-
294
- await runScheduledTask({ name: 'identified-task' })
295
-
296
- assert.deepEqual(
297
- mockLogger
298
- .getLogs()
299
- .filter(
300
- (log) =>
301
- log.level === 'warn' && /auth was explicitly disabled/.test(log.message)
302
- ),
303
- []
304
- )
305
- })
306
-
307
- test('should throw ScheduledTaskNotFoundError when task not found', async () => {
308
- const mockLogger = createMockLogger()
309
- pikkuState(null, 'package', 'singletonServices', {
310
- logger: mockLogger,
311
- } as any)
312
-
313
- await assert.rejects(
314
- async () => {
315
- await runScheduledTask({
316
- name: 'non-existent-task',
317
- })
318
- },
319
- (error: any) => {
320
- assert(error.message.includes('Scheduled task not found'))
321
- return true
322
- }
323
- )
324
- })
325
-
326
- test('should throw ScheduledTaskNotFoundError when meta not found', async () => {
327
- const mockTask: CoreScheduledTask = {
328
- name: 'task-without-meta',
329
- schedule: '0 0 * * *',
330
- func: {
331
- func: async () => {},
332
- auth: false,
333
- },
334
- }
335
-
336
- pikkuState(null, 'scheduler', 'tasks').set('task-without-meta', mockTask)
337
-
338
- const mockLogger = createMockLogger()
339
- pikkuState(null, 'package', 'singletonServices', {
340
- logger: mockLogger,
341
- } as any)
342
-
343
- await assert.rejects(
344
- async () => {
345
- await runScheduledTask({
346
- name: 'task-without-meta',
347
- })
348
- },
349
- (error: any) => {
350
- assert(error.message.includes('Scheduled task meta not found'))
351
- return true
352
- }
353
- )
354
- })
355
-
356
- test('should handle task.skip() by throwing ScheduledTaskSkippedError', async () => {
357
- const mockTask: CoreScheduledTask = {
358
- name: 'skipped-task',
359
- schedule: '0 0 * * *',
360
- func: {
361
- func: async (services: any, data: any, wire: any) => {
362
- wire.scheduledTask.skip('Not ready yet')
363
- },
364
- auth: false,
365
- },
366
- }
367
-
368
- pikkuState(null, 'scheduler', 'meta')['skipped-task'] = {
369
- pikkuFuncId: 'scheduler_skipped-task',
370
- name: 'skipped-task',
371
- schedule: '0 0 * * *',
372
- }
373
- pikkuState(null, 'function', 'meta')['scheduler_skipped-task'] = {
374
- pikkuFuncId: 'scheduler_skipped-task',
375
- inputSchemaName: null,
376
- outputSchemaName: null,
377
- sessionless: true,
378
- }
379
- wireScheduler(mockTask)
380
-
381
- const mockLogger = createMockLogger()
382
- pikkuState(null, 'package', 'singletonServices', {
383
- logger: mockLogger,
384
- } as any)
385
-
386
- await assert.rejects(
387
- async () => {
388
- await runScheduledTask({
389
- name: 'skipped-task',
390
- })
391
- },
392
- (error: any) => {
393
- assert(
394
- error.message.includes("Scheduled task 'skipped-task' was skipped")
395
- )
396
- assert(error.message.includes('Not ready yet'))
397
- return true
398
- }
399
- )
400
- })
401
-
402
- test('should handle task.skip() without reason', async () => {
403
- const mockTask: CoreScheduledTask = {
404
- name: 'skipped-task-no-reason',
405
- schedule: '0 0 * * *',
406
- func: {
407
- func: async (services: any, data: any, wire: any) => {
408
- wire.scheduledTask.skip()
409
- },
410
- auth: false,
411
- },
412
- }
413
-
414
- pikkuState(null, 'scheduler', 'meta')['skipped-task-no-reason'] = {
415
- pikkuFuncId: 'scheduler_skipped-task-no-reason',
416
- name: 'skipped-task-no-reason',
417
- schedule: '0 0 * * *',
418
- }
419
- pikkuState(null, 'function', 'meta')['scheduler_skipped-task-no-reason'] = {
420
- pikkuFuncId: 'scheduler_skipped-task-no-reason',
421
- inputSchemaName: null,
422
- outputSchemaName: null,
423
- sessionless: true,
424
- }
425
- wireScheduler(mockTask)
426
-
427
- const mockLogger = createMockLogger()
428
- pikkuState(null, 'package', 'singletonServices', {
429
- logger: mockLogger,
430
- } as any)
431
-
432
- await assert.rejects(
433
- async () => {
434
- await runScheduledTask({
435
- name: 'skipped-task-no-reason',
436
- })
437
- },
438
- (error: any) => {
439
- assert(
440
- error.message.includes(
441
- "Scheduled task 'skipped-task-no-reason' was skipped"
442
- )
443
- )
444
- return true
445
- }
446
- )
447
- })
448
-
449
- test('should provide correct wire object to task', async () => {
450
- let capturedWire: any
451
-
452
- const mockTask: CoreScheduledTask = {
453
- name: 'wire-task',
454
- schedule: '*/5 * * * *',
455
- func: {
456
- func: async (services: any, data: any, wire: any) => {
457
- capturedWire = wire
458
- },
459
- auth: false,
460
- },
461
- }
462
-
463
- pikkuState(null, 'scheduler', 'meta')['wire-task'] = {
464
- pikkuFuncId: 'scheduler_wire-task',
465
- name: 'wire-task',
466
- schedule: '*/5 * * * *',
467
- }
468
- pikkuState(null, 'function', 'meta')['scheduler_wire-task'] = {
469
- pikkuFuncId: 'scheduler_wire-task',
470
- inputSchemaName: null,
471
- outputSchemaName: null,
472
- sessionless: true,
473
- }
474
- wireScheduler(mockTask)
475
-
476
- const mockLogger = createMockLogger()
477
- pikkuState(null, 'package', 'singletonServices', {
478
- logger: mockLogger,
479
- } as any)
480
-
481
- await runScheduledTask({
482
- name: 'wire-task',
483
- })
484
-
485
- assert.equal(capturedWire.scheduledTask.name, 'wire-task')
486
- assert.equal(capturedWire.scheduledTask.schedule, '*/5 * * * *')
487
- assert(capturedWire.scheduledTask.executionTime instanceof Date)
488
- assert.equal(typeof capturedWire.scheduledTask.skip, 'function')
489
- })
490
-
491
- test('should call createWireServices when provided', async () => {
492
- let createWireServicesCalled = false
493
- const mockWireService = { custom: 'service' }
494
-
495
- const mockTask: CoreScheduledTask = {
496
- name: 'session-services-task',
497
- schedule: '0 0 * * *',
498
- func: {
499
- func: async () => undefined,
500
- auth: false,
501
- },
502
- }
503
-
504
- pikkuState(null, 'scheduler', 'meta')['session-services-task'] = {
505
- pikkuFuncId: 'scheduler_session-services-task',
506
- name: 'session-services-task',
507
- schedule: '0 0 * * *',
508
- }
509
- pikkuState(null, 'function', 'meta')['scheduler_session-services-task'] = {
510
- pikkuFuncId: 'scheduler_session-services-task',
511
- inputSchemaName: null,
512
- outputSchemaName: null,
513
- sessionless: true,
514
- }
515
- wireScheduler(mockTask)
516
-
517
- const mockLogger = createMockLogger()
518
- pikkuState(null, 'package', 'singletonServices', {
519
- logger: mockLogger,
520
- } as any)
521
- pikkuState(null, 'package', 'factories', {
522
- createWireServices: async () => {
523
- createWireServicesCalled = true
524
- return mockWireService as any
525
- },
526
- } as any)
527
-
528
- await runScheduledTask({
529
- name: 'session-services-task',
530
- })
531
-
532
- assert.equal(createWireServicesCalled, true)
533
- })
534
-
535
- test('should clean up wire services in finally block', async () => {
536
- let closeCalled = false
537
- const mockWireService = {
538
- custom: {
539
- close: async () => {
540
- closeCalled = true
541
- },
542
- },
543
- }
544
-
545
- const mockTask: CoreScheduledTask = {
546
- name: 'cleanup-task',
547
- schedule: '0 0 * * *',
548
- func: {
549
- func: async () => undefined,
550
- auth: false,
551
- },
552
- }
553
-
554
- pikkuState(null, 'scheduler', 'meta')['cleanup-task'] = {
555
- pikkuFuncId: 'scheduler_cleanup-task',
556
- name: 'cleanup-task',
557
- schedule: '0 0 * * *',
558
- }
559
- pikkuState(null, 'function', 'meta')['scheduler_cleanup-task'] = {
560
- pikkuFuncId: 'scheduler_cleanup-task',
561
- inputSchemaName: null,
562
- outputSchemaName: null,
563
- sessionless: true,
564
- }
565
- wireScheduler(mockTask)
566
-
567
- const mockLogger = createMockLogger()
568
- pikkuState(null, 'package', 'singletonServices', {
569
- logger: mockLogger,
570
- } as any)
571
- pikkuState(null, 'package', 'factories', {
572
- createWireServices: async () => mockWireService as any,
573
- } as any)
574
-
575
- await runScheduledTask({
576
- name: 'cleanup-task',
577
- })
578
-
579
- assert.equal(closeCalled, true)
580
- })
581
-
582
- test('should clean up wire services even when task throws error', async () => {
583
- let closeCalled = false
584
- const mockWireService = {
585
- custom: {
586
- close: async () => {
587
- closeCalled = true
588
- },
589
- },
590
- }
591
-
592
- const mockTask: CoreScheduledTask = {
593
- name: 'error-cleanup-task',
594
- schedule: '0 0 * * *',
595
- func: {
596
- func: async () => {
597
- throw new Error('Task failed')
598
- },
599
- auth: false,
600
- },
601
- }
602
-
603
- pikkuState(null, 'scheduler', 'meta')['error-cleanup-task'] = {
604
- pikkuFuncId: 'scheduler_error-cleanup-task',
605
- name: 'error-cleanup-task',
606
- schedule: '0 0 * * *',
607
- }
608
- pikkuState(null, 'function', 'meta')['scheduler_error-cleanup-task'] = {
609
- pikkuFuncId: 'scheduler_error-cleanup-task',
610
- inputSchemaName: null,
611
- outputSchemaName: null,
612
- sessionless: true,
613
- }
614
- wireScheduler(mockTask)
615
-
616
- const mockLogger = createMockLogger()
617
- pikkuState(null, 'package', 'singletonServices', {
618
- logger: mockLogger,
619
- } as any)
620
- pikkuState(null, 'package', 'factories', {
621
- createWireServices: async () => mockWireService as any,
622
- } as any)
623
-
624
- await assert.rejects(async () => {
625
- await runScheduledTask({
626
- name: 'error-cleanup-task',
627
- })
628
- })
629
-
630
- assert.equal(closeCalled, true)
631
- })
632
-
633
- test('should re-throw errors from task', async () => {
634
- const mockTask: CoreScheduledTask = {
635
- name: 'error-task',
636
- schedule: '0 0 * * *',
637
- func: {
638
- func: async (services: any, data: any, wire: any) => {
639
- wire.scheduledTask.skip('Test skip')
640
- },
641
- auth: false,
642
- },
643
- }
644
-
645
- pikkuState(null, 'scheduler', 'meta')['error-task'] = {
646
- pikkuFuncId: 'scheduler_error-task',
647
- name: 'error-task',
648
- schedule: '0 0 * * *',
649
- }
650
- pikkuState(null, 'function', 'meta')['scheduler_error-task'] = {
651
- pikkuFuncId: 'scheduler_error-task',
652
- inputSchemaName: null,
653
- outputSchemaName: null,
654
- sessionless: true,
655
- }
656
- wireScheduler(mockTask)
657
-
658
- const mockLogger = createMockLogger()
659
- pikkuState(null, 'package', 'singletonServices', {
660
- logger: mockLogger,
661
- } as any)
662
-
663
- await assert.rejects(async () => {
664
- await runScheduledTask({
665
- name: 'error-task',
666
- })
667
- })
668
-
669
- const logs = mockLogger.getLogs()
670
- const infoLogs = logs.filter((l) => l.level === 'info')
671
- assert(infoLogs.length > 0)
672
- })
673
-
674
- test('should execute task with middleware', async () => {
675
- const executionOrder: string[] = []
676
-
677
- const middleware = async (services: any, wire: any, next: any) => {
678
- executionOrder.push('middleware')
679
- await next()
680
- }
681
-
682
- const mockTask: CoreScheduledTask = {
683
- name: 'middleware-task',
684
- schedule: '0 0 * * *',
685
- func: {
686
- func: async () => {
687
- executionOrder.push('task')
688
- },
689
- auth: false,
690
- },
691
- middleware: [middleware],
692
- }
693
-
694
- pikkuState(null, 'scheduler', 'meta')['middleware-task'] = {
695
- pikkuFuncId: 'scheduler_middleware-task',
696
- name: 'middleware-task',
697
- schedule: '0 0 * * *',
698
- }
699
- pikkuState(null, 'function', 'meta')['scheduler_middleware-task'] = {
700
- pikkuFuncId: 'scheduler_middleware-task',
701
- inputSchemaName: null,
702
- outputSchemaName: null,
703
- sessionless: true,
704
- }
705
- wireScheduler(mockTask)
706
-
707
- const mockLogger = createMockLogger()
708
- pikkuState(null, 'package', 'singletonServices', {
709
- logger: mockLogger,
710
- } as any)
711
-
712
- await runScheduledTask({
713
- name: 'middleware-task',
714
- })
715
-
716
- assert.deepEqual(executionOrder, ['middleware', 'task'])
717
- })
718
- })
719
-
720
- describe('getScheduledTasks', () => {
721
- test('should return the tasks map', () => {
722
- const mockTask: CoreScheduledTask = {
723
- name: 'test-task',
724
- schedule: '0 0 * * *',
725
- func: {
726
- func: async () => {},
727
- auth: false,
728
- },
729
- }
730
-
731
- pikkuState(null, 'scheduler', 'meta')['test-task'] = {
732
- pikkuFuncId: 'scheduler_test-task',
733
- name: 'test-task',
734
- schedule: '0 0 * * *',
735
- }
736
- wireScheduler(mockTask)
737
-
738
- const tasks = getScheduledTasks()
739
- assert.equal(tasks instanceof Map, true)
740
- assert.equal(tasks.has('test-task'), true)
741
- })
742
-
743
- test('should return empty map when no tasks registered', () => {
744
- const tasks = getScheduledTasks()
745
- assert.equal(tasks instanceof Map, true)
746
- assert.equal(tasks.size, 0)
747
- })
748
- })
749
-
750
- /**
751
- * A cron has no caller to authenticate, so the only thing that can give it an
752
- * identity is its own wiring. These cover the mechanism the virtual-user
753
- * scaffold's `virtualUserPlatformSession` relies on: middleware on the task
754
- * sets the session, and the scope gate on the function it drives is enforced
755
- * against exactly that session — a tick with no identity, or one holding the
756
- * wrong scope, is refused the same way a person would be.
757
- */
758
- describe('a scheduled task authorizes on the session its own middleware sets', () => {
759
- const wireGatedTask = (
760
- name: string,
761
- middleware?: Array<
762
- (services: any, wire: any, next: any) => Promise<void> | void
763
- >
764
- ) => {
765
- let seen: CoreUserSession | undefined
766
- const task: CoreScheduledTask = {
767
- name,
768
- schedule: '0 * * * *',
769
- func: {
770
- func: async (_services: any, _data: any, wire: any) => {
771
- seen = await wire.getSession()
772
- },
773
- } as any,
774
- middleware,
775
- }
776
- pikkuState(null, 'scheduler', 'meta')[name] = {
777
- pikkuFuncId: `scheduler_${name}`,
778
- name,
779
- schedule: '0 * * * *',
780
- }
781
- pikkuState(null, 'function', 'meta')[`scheduler_${name}`] = {
782
- pikkuFuncId: `scheduler_${name}`,
783
- inputSchemaName: null,
784
- outputSchemaName: null,
785
- sessionless: false,
786
- scopes: ['virtualUser:run'],
787
- }
788
- wireScheduler(task)
789
- pikkuState(null, 'package', 'singletonServices', {
790
- logger: createMockLogger(),
791
- } as any)
792
- return () => seen
793
- }
794
-
795
- const settingSession = (session: CoreUserSession) => [
796
- async (_services: any, wire: any, next: any) => {
797
- await wire.setSession(session)
798
- return next()
799
- },
800
- ]
801
-
802
- test('is refused outright when nothing gives the tick an identity', async () => {
803
- wireGatedTask('unidentified-tick')
804
- await assert.rejects(
805
- runScheduledTask({ name: 'unidentified-tick' }),
806
- /Authentication required/
807
- )
808
- })
809
-
810
- test('is refused when the identity it sets holds the wrong scope', async () => {
811
- wireGatedTask(
812
- 'misscoped-tick',
813
- settingSession({
814
- userId: 'pikku-platform',
815
- scopes: ['admin'],
816
- } as CoreUserSession)
817
- )
818
- await assert.rejects(
819
- runScheduledTask({ name: 'misscoped-tick' }),
820
- /virtualUser:run/
821
- )
822
- })
823
-
824
- test('runs as the platform user its middleware set', async () => {
825
- const seen = wireGatedTask(
826
- 'platform-tick',
827
- settingSession({
828
- userId: 'pikku-platform',
829
- scopes: ['virtualUser:run'],
830
- } as CoreUserSession)
831
- )
832
- await runScheduledTask({ name: 'platform-tick' })
833
- assert.equal(seen()?.userId, 'pikku-platform')
834
- })
835
- })