@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,668 +0,0 @@
1
- import { describe, test } from 'node:test'
2
- import assert from 'node:assert'
3
- import { WeakKeyMaterialError } from './errors/errors.js'
4
- import {
5
- encryptJSON,
6
- decryptJSON,
7
- encryptWithKeyMaterial,
8
- decryptWithKeyMaterial,
9
- generateDEK,
10
- generateKEKSalt,
11
- deriveKEK,
12
- wrapDEK,
13
- unwrapDEK,
14
- envelopeEncrypt,
15
- envelopeDecrypt,
16
- envelopeRewrap,
17
- } from './crypto-utils.js'
18
-
19
- describe('encryptJSON / decryptJSON', () => {
20
- const secret = 'test-secret-key-for-encryption'
21
-
22
- test('should round-trip a simple object', async () => {
23
- const original = { hello: 'world', num: 42 }
24
- const encrypted = await encryptJSON(secret, original)
25
- const decrypted = await decryptJSON(secret, encrypted)
26
- assert.deepStrictEqual(decrypted, original)
27
- })
28
-
29
- test('should round-trip a string value', async () => {
30
- const original = 'just a string'
31
- const encrypted = await encryptJSON(secret, original)
32
- const decrypted = await decryptJSON(secret, encrypted)
33
- assert.strictEqual(decrypted, original)
34
- })
35
-
36
- test('should round-trip a number', async () => {
37
- const original = 12345
38
- const encrypted = await encryptJSON(secret, original)
39
- const decrypted = await decryptJSON(secret, encrypted)
40
- assert.strictEqual(decrypted, original)
41
- })
42
-
43
- test('should round-trip null', async () => {
44
- const encrypted = await encryptJSON(secret, null)
45
- const decrypted = await decryptJSON(secret, encrypted)
46
- assert.strictEqual(decrypted, null)
47
- })
48
-
49
- test('should round-trip a boolean', async () => {
50
- const encrypted = await encryptJSON(secret, true)
51
- const decrypted = await decryptJSON(secret, encrypted)
52
- assert.strictEqual(decrypted, true)
53
- })
54
-
55
- test('should round-trip a nested object', async () => {
56
- const original = { user: { id: 1, roles: ['admin', 'user'] }, active: true }
57
- const encrypted = await encryptJSON(secret, original)
58
- const decrypted = await decryptJSON(secret, encrypted)
59
- assert.deepStrictEqual(decrypted, original)
60
- })
61
-
62
- test('should round-trip an array', async () => {
63
- const original = [1, 'two', { three: 3 }]
64
- const encrypted = await encryptJSON(secret, original)
65
- const decrypted = await decryptJSON(secret, encrypted)
66
- assert.deepStrictEqual(decrypted, original)
67
- })
68
-
69
- test('should produce different ciphertexts for same input (random IV)', async () => {
70
- const value = { same: 'data' }
71
- const enc1 = await encryptJSON(secret, value)
72
- const enc2 = await encryptJSON(secret, value)
73
- assert.notStrictEqual(enc1, enc2)
74
- })
75
-
76
- test('should produce a base64url string (no +, /, or = characters)', async () => {
77
- const encrypted = await encryptJSON(secret, { test: 'base64url' })
78
- assert.ok(!/[+/=]/.test(encrypted), `Expected base64url, got: ${encrypted}`)
79
- })
80
-
81
- test('should fail to decrypt with wrong secret', async () => {
82
- const encrypted = await encryptJSON(secret, { data: 'sensitive' })
83
- await assert.rejects(
84
- () => decryptJSON('wrong-secret', encrypted),
85
- (err: any) => err instanceof Error
86
- )
87
- })
88
-
89
- test('should reject an invalid encrypted payload (too short)', async () => {
90
- await assert.rejects(() => decryptJSON(secret, 'dG9vc2hvcnQ'), {
91
- message: 'Invalid encrypted payload',
92
- })
93
- })
94
-
95
- test('should reject empty string', async () => {
96
- await assert.rejects(() => decryptJSON(secret, ''), {
97
- message: 'Invalid encrypted payload',
98
- })
99
- })
100
-
101
- test('should reject corrupted ciphertext', async () => {
102
- const encrypted = await encryptJSON(secret, { data: 'test' })
103
- const corrupted = encrypted.slice(0, -4) + 'XXXX'
104
- await assert.rejects(
105
- () => decryptJSON(secret, corrupted),
106
- (err: any) => err instanceof Error
107
- )
108
- })
109
-
110
- test('should handle unicode content', async () => {
111
- const original = { emoji: '🎉', japanese: 'こんにちは', arabic: 'مرحبا' }
112
- const encrypted = await encryptJSON(secret, original)
113
- const decrypted = await decryptJSON(secret, encrypted)
114
- assert.deepStrictEqual(decrypted, original)
115
- })
116
-
117
- test('should handle empty object', async () => {
118
- const original = {}
119
- const encrypted = await encryptJSON(secret, original)
120
- const decrypted = await decryptJSON(secret, encrypted)
121
- assert.deepStrictEqual(decrypted, original)
122
- })
123
-
124
- test('should handle large payload', async () => {
125
- const original = { data: 'x'.repeat(10000) }
126
- const encrypted = await encryptJSON(secret, original)
127
- const decrypted = await decryptJSON(secret, encrypted)
128
- assert.deepStrictEqual(decrypted, original)
129
- })
130
- })
131
-
132
- describe('key derivation hardening', () => {
133
- const secret = 'test-secret-key-for-encryption'
134
-
135
- const SALT_BYTES = 16
136
- const IV_BYTES = 12
137
- const TAG_BYTES = 16
138
-
139
- const fromBase64Url = (input: string): Uint8Array => {
140
- let b64 = input.replace(/-/g, '+').replace(/_/g, '/')
141
- while (b64.length % 4 !== 0) b64 += '='
142
- return new Uint8Array(Buffer.from(b64, 'base64'))
143
- }
144
-
145
- const toBase64Url = (bytes: Uint8Array): string =>
146
- Buffer.from(bytes)
147
- .toString('base64')
148
- .replace(/\+/g, '-')
149
- .replace(/\//g, '_')
150
- .replace(/=+$/g, '')
151
-
152
- test('the derived key is NOT the raw SHA-256 digest of the passphrase', async () => {
153
- const encrypted = await encryptJSON(secret, { data: 'sensitive' })
154
- const blob = fromBase64Url(encrypted)
155
-
156
- const digest = await crypto.subtle.digest(
157
- 'SHA-256',
158
- new TextEncoder().encode(secret)
159
- )
160
- const naiveKey = await crypto.subtle.importKey(
161
- 'raw',
162
- digest,
163
- { name: 'AES-GCM' },
164
- false,
165
- ['decrypt']
166
- )
167
-
168
- for (let ivStart = 0; ivStart <= SALT_BYTES; ivStart++) {
169
- const iv = blob.slice(ivStart, ivStart + IV_BYTES)
170
- const ciphertext = blob.slice(ivStart + IV_BYTES)
171
- if (ciphertext.length <= TAG_BYTES) continue
172
- await assert.rejects(
173
- () =>
174
- crypto.subtle.decrypt({ name: 'AES-GCM', iv }, naiveKey, ciphertext),
175
- `SHA-256(passphrase) decrypted the payload at offset ${ivStart}`
176
- )
177
- }
178
- })
179
-
180
- test('each encryption embeds a fresh random salt', async () => {
181
- const value = { same: 'data' }
182
- const salts = new Set<string>()
183
- for (let i = 0; i < 8; i++) {
184
- const blob = fromBase64Url(await encryptJSON(secret, value))
185
- salts.add(Buffer.from(blob.slice(0, SALT_BYTES)).toString('hex'))
186
- }
187
- assert.strictEqual(salts.size, 8, 'salt repeated across encryptions')
188
- })
189
-
190
- test('blob layout is [salt:16][iv:12][ciphertext+tag]', async () => {
191
- const plaintext = JSON.stringify({ data: 'x'.repeat(100) })
192
- const blob = fromBase64Url(
193
- await encryptJSON(secret, { data: 'x'.repeat(100) })
194
- )
195
- assert.strictEqual(
196
- blob.length,
197
- SALT_BYTES + IV_BYTES + plaintext.length + TAG_BYTES
198
- )
199
- })
200
-
201
- test('round-trips under the salted format', async () => {
202
- const original = { user: 'alice', scopes: ['read', 'write'] }
203
- const encrypted = await encryptJSON(secret, original)
204
- assert.deepStrictEqual(await decryptJSON(secret, encrypted), original)
205
- })
206
-
207
- test('a wrong passphrase rejects rather than returning garbage', async () => {
208
- const encrypted = await encryptJSON(secret, { data: 'sensitive' })
209
- let result: unknown = Symbol('untouched')
210
- await assert.rejects(async () => {
211
- result = await decryptJSON('wrong-secret', encrypted)
212
- })
213
- assert.strictEqual(typeof result, 'symbol', 'decrypt returned a value')
214
- })
215
-
216
- test('a blob truncated into the salt is rejected', async () => {
217
- const encrypted = await encryptJSON(secret, { data: 'sensitive' })
218
- const blob = fromBase64Url(encrypted)
219
- const truncated = toBase64Url(blob.slice(0, SALT_BYTES - 1))
220
- await assert.rejects(() => decryptJSON(secret, truncated), {
221
- message: 'Invalid encrypted payload',
222
- })
223
- })
224
-
225
- test('a blob carrying salt+iv but no ciphertext is rejected', async () => {
226
- const header = toBase64Url(new Uint8Array(SALT_BYTES + IV_BYTES))
227
- await assert.rejects(() => decryptJSON(secret, header), {
228
- message: 'Invalid encrypted payload',
229
- })
230
- })
231
-
232
- test('tampering with the salt is rejected', async () => {
233
- const encrypted = await encryptJSON(secret, { data: 'sensitive' })
234
- const blob = fromBase64Url(encrypted)
235
- blob[0] = blob[0]! ^ 0xff
236
- await assert.rejects(() => decryptJSON(secret, toBase64Url(blob)))
237
- })
238
-
239
- test('tampering with the tag is rejected', async () => {
240
- const encrypted = await encryptJSON(secret, { data: 'sensitive' })
241
- const blob = fromBase64Url(encrypted)
242
- blob[blob.length - 1] = blob[blob.length - 1]! ^ 0xff
243
- await assert.rejects(() => decryptJSON(secret, toBase64Url(blob)))
244
- })
245
- })
246
-
247
- describe('encryptWithKeyMaterial / decryptWithKeyMaterial', () => {
248
- const NAME = 'PIKKU_REMOTE_SECRET'
249
- const keyMaterial = 'k'.repeat(43)
250
- const info = 'pikku:remote-session'
251
-
252
- const SALT_BYTES = 16
253
- const IV_BYTES = 12
254
- const TAG_BYTES = 16
255
-
256
- const fromBase64Url = (input: string): Uint8Array => {
257
- let b64 = input.replace(/-/g, '+').replace(/_/g, '/')
258
- while (b64.length % 4 !== 0) b64 += '='
259
- return new Uint8Array(Buffer.from(b64, 'base64'))
260
- }
261
-
262
- const toBase64Url = (bytes: Uint8Array): string =>
263
- Buffer.from(bytes)
264
- .toString('base64')
265
- .replace(/\+/g, '-')
266
- .replace(/\//g, '_')
267
- .replace(/=+$/g, '')
268
-
269
- test('round-trips an object', async () => {
270
- const original = { user: 'alice', scopes: ['read', 'write'] }
271
- const encrypted = await encryptWithKeyMaterial(
272
- NAME,
273
- keyMaterial,
274
- info,
275
- original
276
- )
277
- assert.deepStrictEqual(
278
- await decryptWithKeyMaterial(NAME, keyMaterial, info, encrypted),
279
- original
280
- )
281
- })
282
-
283
- test('round-trips unicode content', async () => {
284
- const original = { emoji: '🎉', japanese: 'こんにちは' }
285
- const encrypted = await encryptWithKeyMaterial(
286
- NAME,
287
- keyMaterial,
288
- info,
289
- original
290
- )
291
- assert.deepStrictEqual(
292
- await decryptWithKeyMaterial(NAME, keyMaterial, info, encrypted),
293
- original
294
- )
295
- })
296
-
297
- test('blob layout is [salt:16][iv:12][ciphertext+tag]', async () => {
298
- const value = { data: 'x'.repeat(100) }
299
- const blob = fromBase64Url(
300
- await encryptWithKeyMaterial(NAME, keyMaterial, info, value)
301
- )
302
- assert.strictEqual(
303
- blob.length,
304
- SALT_BYTES + IV_BYTES + JSON.stringify(value).length + TAG_BYTES
305
- )
306
- })
307
-
308
- test('produces base64url with no +, / or = characters', async () => {
309
- const encrypted = await encryptWithKeyMaterial(NAME, keyMaterial, info, {
310
- test: 1,
311
- })
312
- assert.ok(!/[+/=]/.test(encrypted), `Expected base64url, got: ${encrypted}`)
313
- })
314
-
315
- test('each encryption embeds a fresh random salt', async () => {
316
- const salts = new Set<string>()
317
- for (let i = 0; i < 8; i++) {
318
- const blob = fromBase64Url(
319
- await encryptWithKeyMaterial(NAME, keyMaterial, info, { same: 'data' })
320
- )
321
- salts.add(Buffer.from(blob.slice(0, SALT_BYTES)).toString('hex'))
322
- }
323
- assert.strictEqual(salts.size, 8, 'salt repeated across encryptions')
324
- })
325
-
326
- test('a wrong key material rejects rather than returning garbage', async () => {
327
- const encrypted = await encryptWithKeyMaterial(NAME, keyMaterial, info, {
328
- data: 'sensitive',
329
- })
330
- let result: unknown = Symbol('untouched')
331
- await assert.rejects(async () => {
332
- result = await decryptWithKeyMaterial(
333
- NAME,
334
- 'w'.repeat(43),
335
- info,
336
- encrypted
337
- )
338
- })
339
- assert.strictEqual(typeof result, 'symbol', 'decrypt returned a value')
340
- })
341
-
342
- test('a key derived for one info cannot decrypt another info payload', async () => {
343
- const encrypted = await encryptWithKeyMaterial(
344
- NAME,
345
- keyMaterial,
346
- 'pikku:remote-session',
347
- { data: 'sensitive' }
348
- )
349
- await assert.rejects(() =>
350
- decryptWithKeyMaterial(
351
- NAME,
352
- keyMaterial,
353
- 'pikku:other-purpose',
354
- encrypted
355
- )
356
- )
357
- })
358
-
359
- test('info namespacing holds even for a one-character difference', async () => {
360
- const encrypted = await encryptWithKeyMaterial(NAME, keyMaterial, 'a', {
361
- data: 'x',
362
- })
363
- await assert.rejects(() =>
364
- decryptWithKeyMaterial(NAME, keyMaterial, 'b', encrypted)
365
- )
366
- })
367
-
368
- test('a blob truncated into the salt is rejected', async () => {
369
- const encrypted = await encryptWithKeyMaterial(NAME, keyMaterial, info, {
370
- data: 'sensitive',
371
- })
372
- const truncated = toBase64Url(
373
- fromBase64Url(encrypted).slice(0, SALT_BYTES - 1)
374
- )
375
- await assert.rejects(
376
- () => decryptWithKeyMaterial(NAME, keyMaterial, info, truncated),
377
- { message: 'Invalid encrypted payload' }
378
- )
379
- })
380
-
381
- test('a blob carrying salt+iv but no ciphertext is rejected', async () => {
382
- const header = toBase64Url(new Uint8Array(SALT_BYTES + IV_BYTES))
383
- await assert.rejects(
384
- () => decryptWithKeyMaterial(NAME, keyMaterial, info, header),
385
- { message: 'Invalid encrypted payload' }
386
- )
387
- })
388
-
389
- test('tampering with the salt is rejected', async () => {
390
- const blob = fromBase64Url(
391
- await encryptWithKeyMaterial(NAME, keyMaterial, info, {
392
- data: 'sensitive',
393
- })
394
- )
395
- blob[0] = blob[0]! ^ 0xff
396
- await assert.rejects(() =>
397
- decryptWithKeyMaterial(NAME, keyMaterial, info, toBase64Url(blob))
398
- )
399
- })
400
-
401
- test('tampering with the tag is rejected', async () => {
402
- const blob = fromBase64Url(
403
- await encryptWithKeyMaterial(NAME, keyMaterial, info, {
404
- data: 'sensitive',
405
- })
406
- )
407
- blob[blob.length - 1] = blob[blob.length - 1]! ^ 0xff
408
- await assert.rejects(() =>
409
- decryptWithKeyMaterial(NAME, keyMaterial, info, toBase64Url(blob))
410
- )
411
- })
412
-
413
- test('a passphrase blob cannot be read by the key-material path', async () => {
414
- const encrypted = await encryptJSON(keyMaterial, { data: 'sensitive' })
415
- await assert.rejects(() =>
416
- decryptWithKeyMaterial(NAME, keyMaterial, info, encrypted)
417
- )
418
- })
419
-
420
- test('rejects key material shorter than 32 characters on encrypt', async () => {
421
- await assert.rejects(
422
- () => encryptWithKeyMaterial(NAME, 'short-secret', info, { a: 1 }),
423
- (err: unknown) => err instanceof WeakKeyMaterialError
424
- )
425
- })
426
-
427
- test('rejects key material shorter than 32 characters on decrypt', async () => {
428
- const encrypted = await encryptWithKeyMaterial(NAME, keyMaterial, info, {
429
- a: 1,
430
- })
431
- await assert.rejects(
432
- () => decryptWithKeyMaterial(NAME, 'short-secret', info, encrypted),
433
- (err: unknown) => err instanceof WeakKeyMaterialError
434
- )
435
- })
436
-
437
- test('accepts key material of exactly 32 characters', async () => {
438
- const exact = 'y'.repeat(32)
439
- const encrypted = await encryptWithKeyMaterial(NAME, exact, info, { a: 1 })
440
- assert.deepStrictEqual(
441
- await decryptWithKeyMaterial(NAME, exact, info, encrypted),
442
- { a: 1 }
443
- )
444
- })
445
-
446
- test('the weak key material error names the offending secret', async () => {
447
- await assert.rejects(
448
- () => encryptWithKeyMaterial('MY_SECRET', 'tiny', info, { a: 1 }),
449
- (err: unknown) =>
450
- err instanceof WeakKeyMaterialError &&
451
- err.message.includes('MY_SECRET') &&
452
- err.message.includes('32')
453
- )
454
- })
455
-
456
- test('key derivation is fast enough for the per-request path', async () => {
457
- await encryptWithKeyMaterial(NAME, keyMaterial, info, { warm: true })
458
-
459
- const iterations = 20
460
- const start = performance.now()
461
- for (let i = 0; i < iterations; i++) {
462
- const blob = await encryptWithKeyMaterial(NAME, keyMaterial, info, {
463
- i,
464
- })
465
- await decryptWithKeyMaterial(NAME, keyMaterial, info, blob)
466
- }
467
- const perPair = (performance.now() - start) / iterations
468
-
469
- assert.ok(
470
- perPair < 5,
471
- `encrypt+decrypt took ${perPair.toFixed(2)}ms, budget is 5ms`
472
- )
473
- })
474
- })
475
-
476
- describe('envelope encryption', () => {
477
- const passphrase = 'my-key-encryption-key'
478
- const salt = generateKEKSalt()
479
-
480
- test('generateDEK produces unique keys', async () => {
481
- const dek1 = await generateDEK()
482
- const dek2 = await generateDEK()
483
- assert.notStrictEqual(dek1, dek2)
484
- assert.ok(dek1.length > 0)
485
- })
486
-
487
- test('generateKEKSalt produces a unique base64url salt each call', () => {
488
- const salts = new Set<string>()
489
- for (let i = 0; i < 8; i++) salts.add(generateKEKSalt())
490
- assert.strictEqual(salts.size, 8)
491
- for (const value of salts) {
492
- assert.ok(!/[+/=]/.test(value), `Expected base64url, got: ${value}`)
493
- }
494
- })
495
-
496
- test('deriveKEK is deterministic for the same passphrase and salt', async () => {
497
- const kekA = await deriveKEK(passphrase, salt)
498
- const kekB = await deriveKEK(passphrase, salt)
499
- const wrapped = await wrapDEK(kekA, 'dek-value')
500
- assert.strictEqual(await unwrapDEK(kekB, wrapped), 'dek-value')
501
- })
502
-
503
- test('the same passphrase under a different salt yields a different KEK', async () => {
504
- const kekA = await deriveKEK(passphrase, salt)
505
- const kekB = await deriveKEK(passphrase, generateKEKSalt())
506
- const wrapped = await wrapDEK(kekA, 'dek-value')
507
- await assert.rejects(() => unwrapDEK(kekB, wrapped))
508
- })
509
-
510
- test('wrapDEK / unwrapDEK round-trip', async () => {
511
- const kek = await deriveKEK(passphrase, salt)
512
- const dek = await generateDEK()
513
- const wrapped = await wrapDEK(kek, dek)
514
- assert.strictEqual(await unwrapDEK(kek, wrapped), dek)
515
- })
516
-
517
- test('the wrapped DEK blob layout is [iv:12][ciphertext+tag]', async () => {
518
- const kek = await deriveKEK(passphrase, salt)
519
- const dek = await generateDEK()
520
- const wrapped = await wrapDEK(kek, dek)
521
-
522
- let b64 = wrapped.replace(/-/g, '+').replace(/_/g, '/')
523
- while (b64.length % 4 !== 0) b64 += '='
524
- const blob = new Uint8Array(Buffer.from(b64, 'base64'))
525
-
526
- assert.strictEqual(blob.length, 12 + JSON.stringify(dek).length + 16)
527
- })
528
-
529
- test('unwrapDEK fails with a KEK derived from a wrong passphrase', async () => {
530
- const kek = await deriveKEK(passphrase, salt)
531
- const wrongKEK = await deriveKEK('wrong-kek', salt)
532
- const wrapped = await wrapDEK(kek, await generateDEK())
533
- await assert.rejects(
534
- () => unwrapDEK(wrongKEK, wrapped),
535
- (err: any) => err instanceof Error
536
- )
537
- })
538
-
539
- test('a tampered wrapped DEK is rejected', async () => {
540
- const kek = await deriveKEK(passphrase, salt)
541
- const wrapped = await wrapDEK(kek, await generateDEK())
542
- await assert.rejects(() => unwrapDEK(kek, wrapped.slice(0, -4) + 'XXXX'))
543
- })
544
-
545
- test('a truncated wrapped DEK is rejected', async () => {
546
- const kek = await deriveKEK(passphrase, salt)
547
- await assert.rejects(() => unwrapDEK(kek, 'dG9vc2hvcnQ'), {
548
- message: 'Invalid encrypted payload',
549
- })
550
- })
551
-
552
- test('envelopeEncrypt / envelopeDecrypt round-trip', async () => {
553
- const kek = await deriveKEK(passphrase, salt)
554
- const original = {
555
- apiKey: 'sk-secret-123',
556
- endpoint: 'https://api.example.com',
557
- }
558
- const { ciphertext, wrappedDEK } = await envelopeEncrypt(kek, original)
559
- assert.deepStrictEqual(
560
- await envelopeDecrypt(kek, ciphertext, wrappedDEK),
561
- original
562
- )
563
- })
564
-
565
- test('envelopeEncrypt produces unique ciphertexts and DEKs per call', async () => {
566
- const kek = await deriveKEK(passphrase, salt)
567
- const value = { same: 'data' }
568
- const r1 = await envelopeEncrypt(kek, value)
569
- const r2 = await envelopeEncrypt(kek, value)
570
- assert.notStrictEqual(r1.ciphertext, r2.ciphertext)
571
- assert.notStrictEqual(r1.wrappedDEK, r2.wrappedDEK)
572
- })
573
-
574
- test('envelopeDecrypt fails with a wrong KEK', async () => {
575
- const kek = await deriveKEK(passphrase, salt)
576
- const wrongKEK = await deriveKEK('wrong-kek', salt)
577
- const { ciphertext, wrappedDEK } = await envelopeEncrypt(kek, 'secret')
578
- await assert.rejects(
579
- () => envelopeDecrypt(wrongKEK, ciphertext, wrappedDEK),
580
- (err: any) => err instanceof Error
581
- )
582
- })
583
-
584
- test('envelopeRewrap allows decryption with the new KEK', async () => {
585
- const kek = await deriveKEK(passphrase, salt)
586
- const newSalt = generateKEKSalt()
587
- const newKEK = await deriveKEK('my-new-kek', newSalt)
588
- const original = { token: 'abc-123' }
589
- const { ciphertext, wrappedDEK } = await envelopeEncrypt(kek, original)
590
-
591
- const rewrapped = await envelopeRewrap(kek, newKEK, wrappedDEK)
592
-
593
- await assert.rejects(
594
- () => envelopeDecrypt(kek, ciphertext, rewrapped),
595
- (err: any) => err instanceof Error
596
- )
597
-
598
- assert.deepStrictEqual(
599
- await envelopeDecrypt(newKEK, ciphertext, rewrapped),
600
- original
601
- )
602
- })
603
-
604
- test('envelopeRewrap does not change the ciphertext', async () => {
605
- const kek = await deriveKEK(passphrase, salt)
606
- const newKEK = await deriveKEK('new-kek', generateKEKSalt())
607
- const original = { data: 'important' }
608
- const { ciphertext, wrappedDEK } = await envelopeEncrypt(kek, original)
609
- const rewrapped = await envelopeRewrap(kek, newKEK, wrappedDEK)
610
-
611
- assert.notStrictEqual(rewrapped, wrappedDEK)
612
- assert.deepStrictEqual(
613
- await envelopeDecrypt(newKEK, ciphertext, rewrapped),
614
- original
615
- )
616
- })
617
-
618
- test('envelope handles string secrets', async () => {
619
- const kek = await deriveKEK(passphrase, salt)
620
- const { ciphertext, wrappedDEK } = await envelopeEncrypt(
621
- kek,
622
- 'plain-string-secret'
623
- )
624
- assert.strictEqual(
625
- await envelopeDecrypt<string>(kek, ciphertext, wrappedDEK),
626
- 'plain-string-secret'
627
- )
628
- })
629
-
630
- /**
631
- * Timed against a derivation measured here rather than a fixed millisecond
632
- * budget. A constant threshold is a load test in disguise: this runs
633
- * alongside two thousand other tests, and 50ms left barely 4x headroom over
634
- * a 10ms window, so the suite went red roughly one run in five. Timing the
635
- * derivation the test already needs costs nothing and makes both sides scale
636
- * together, so the margin survives whatever else the machine is doing.
637
- *
638
- * knowledge: decisions/internals/a-wall-clock-threshold-is-a-load-test-in-disguise.md
639
- */
640
- test('N secrets cost one KEK derivation, not N', async () => {
641
- const derivationStart = performance.now()
642
- const kek = await deriveKEK(passphrase, salt)
643
- const oneDerivation = performance.now() - derivationStart
644
-
645
- const count = 50
646
- const stored = []
647
- for (let i = 0; i < count; i++) {
648
- stored.push(await envelopeEncrypt(kek, { index: i }))
649
- }
650
-
651
- const start = performance.now()
652
- for (let i = 0; i < count; i++) {
653
- const { ciphertext, wrappedDEK } = stored[i]!
654
- assert.deepStrictEqual(
655
- await envelopeDecrypt(kek, ciphertext, wrappedDEK),
656
- {
657
- index: i,
658
- }
659
- )
660
- }
661
- const elapsed = performance.now() - start
662
-
663
- assert.ok(
664
- elapsed < oneDerivation,
665
- `unwrapping ${count} DEKs took ${elapsed.toFixed(1)}ms, longer than the ${oneDerivation.toFixed(1)}ms a single KEK derivation costs — re-deriving per secret would cost about ${(oneDerivation * count).toFixed(0)}ms`
666
- )
667
- })
668
- })