@pikku/core 0.12.106 → 0.12.111

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 (589) hide show
  1. package/CHANGELOG.md +358 -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/errors/errors.d.ts +7 -0
  23. package/dist/errors/errors.js +17 -0
  24. package/dist/function/function-meta.types.d.ts +2 -0
  25. package/dist/function/function-runner.js +29 -0
  26. package/dist/function/functions.types.d.ts +22 -3
  27. package/dist/middleware/auth-apikey.d.ts +1 -1
  28. package/dist/pikku-state.d.ts +1 -1
  29. package/dist/scopes.d.ts +11 -0
  30. package/dist/scopes.js +17 -0
  31. package/dist/services/credential-wire-service.d.ts +1 -1
  32. package/dist/services/feature-flag-service.d.ts +100 -0
  33. package/dist/services/feature-flag-service.js +1 -0
  34. package/dist/services/index.d.ts +1 -0
  35. package/dist/services/meta-service.d.ts +16 -0
  36. package/dist/services/meta-service.js +19 -0
  37. package/dist/services/webhook-service.d.ts +7 -2
  38. package/dist/services/webhook-service.js +11 -6
  39. package/dist/testing/service-tests/agent-run-service-tests.d.ts +2 -2
  40. package/dist/testing/service-tests/agent-storage-service-tests.d.ts +1 -1
  41. package/dist/testing/service-tests/channel-store-tests.d.ts +1 -1
  42. package/dist/testing/service-tests/credential-service-tests.d.ts +1 -1
  43. package/dist/testing/service-tests/deployment-service-tests.d.ts +1 -1
  44. package/dist/testing/service-tests/event-hub-store-tests.d.ts +1 -1
  45. package/dist/testing/service-tests/secret-service-tests.d.ts +1 -1
  46. package/dist/testing/service-tests/session-store-tests.d.ts +1 -1
  47. package/dist/testing/service-tests/workflow-run-service-tests.d.ts +1 -1
  48. package/dist/testing/service-tests/workflow-service-tests.d.ts +1 -1
  49. package/dist/types/core.types.d.ts +23 -0
  50. package/dist/wirings/agent/agent-rpc.d.ts +1 -1
  51. package/dist/wirings/agent/agent-turn.d.ts +1 -1
  52. package/dist/wirings/agent-scorer/agent-scorer-live.d.ts +1 -1
  53. package/dist/wirings/channel/channel-common.d.ts +1 -1
  54. package/dist/wirings/channel/channel-rpc-validators.d.ts +2 -2
  55. package/dist/wirings/channel/channel-runner.d.ts +1 -1
  56. package/dist/wirings/channel/local/local-channel-runner.d.ts +1 -1
  57. package/dist/wirings/channel/serverless/serverless-channel-runner.d.ts +1 -1
  58. package/dist/wirings/cli/channel/cli-approval.d.ts +2 -2
  59. package/dist/wirings/flag/assert-feature-available.d.ts +15 -0
  60. package/dist/wirings/flag/assert-feature-available.js +23 -0
  61. package/dist/wirings/flag/cached-flag-source.d.ts +73 -0
  62. package/dist/wirings/flag/cached-flag-source.js +96 -0
  63. package/dist/wirings/flag/define-feature-flags.d.ts +33 -0
  64. package/dist/wirings/flag/define-feature-flags.js +32 -0
  65. package/dist/wirings/flag/flag.types.d.ts +97 -0
  66. package/dist/wirings/flag/flag.types.js +1 -0
  67. package/dist/wirings/flag/index.d.ts +7 -0
  68. package/dist/wirings/flag/index.js +5 -0
  69. package/dist/wirings/flag/resolve-flag.d.ts +52 -0
  70. package/dist/wirings/flag/resolve-flag.js +90 -0
  71. package/dist/wirings/flag/validate-flag-definitions.d.ts +26 -0
  72. package/dist/wirings/flag/validate-flag-definitions.js +103 -0
  73. package/dist/wirings/rpc/rpc-runner.js +3 -0
  74. package/dist/wirings/virtual-user/virtual-user-scaffold.d.ts +8 -8
  75. package/dist/wirings/virtual-user/virtual-user-schedule.d.ts +1 -1
  76. package/dist/wirings/workflow/workflow-queue-routing.d.ts +1 -1
  77. package/package.json +11 -5
  78. package/run-tests.sh +17 -9
  79. package/src/public-surface.json +26 -0
  80. package/src/agent-naming.test.ts +0 -68
  81. package/src/api-report.test.ts +0 -138
  82. package/src/app-alias-surface.test.ts +0 -179
  83. package/src/app-leaf-surface.test.ts +0 -222
  84. package/src/bootstrap-compat/root.ts +0 -20
  85. package/src/classification/column-form.test.ts +0 -97
  86. package/src/classification/column-form.ts +0 -55
  87. package/src/classification/data-classification.ts +0 -73
  88. package/src/classification/index.ts +0 -40
  89. package/src/classification/key-ids.ts +0 -2
  90. package/src/classification/secret-value.test.ts +0 -204
  91. package/src/classification/secret-value.ts +0 -106
  92. package/src/crypto-utils.test.ts +0 -668
  93. package/src/crypto-utils.ts +0 -460
  94. package/src/dev/hot-reload.test.ts +0 -587
  95. package/src/dev/hot-reload.ts +0 -225
  96. package/src/dev/module-runner.test.ts +0 -235
  97. package/src/dev/module-runner.ts +0 -138
  98. package/src/dev/reload-meta.test.ts +0 -183
  99. package/src/dev/reload-meta.ts +0 -144
  100. package/src/ecosystem-tier-removed.test.ts +0 -72
  101. package/src/env.ts +0 -1
  102. package/src/errors/error-handler.ts +0 -77
  103. package/src/errors/error.test.ts +0 -229
  104. package/src/errors/errors.ts +0 -393
  105. package/src/errors/index.ts +0 -11
  106. package/src/errors/serialized-error.ts +0 -12
  107. package/src/factory-functions.test.ts +0 -111
  108. package/src/function/abort-scope.test.ts +0 -97
  109. package/src/function/abort-scope.ts +0 -80
  110. package/src/function/function-meta.types.ts +0 -151
  111. package/src/function/function-runner.test.ts +0 -1619
  112. package/src/function/function-runner.ts +0 -499
  113. package/src/function/functions.types.ts +0 -319
  114. package/src/function/index.ts +0 -40
  115. package/src/function/list.types.test.ts +0 -100
  116. package/src/function/list.types.ts +0 -69
  117. package/src/function/pikku-request.test.ts +0 -35
  118. package/src/function/pikku-request.ts +0 -17
  119. package/src/gopass-secrets-removed.test.ts +0 -51
  120. package/src/handle-error.test.ts +0 -532
  121. package/src/handle-error.ts +0 -64
  122. package/src/middleware/auth-apikey.test.ts +0 -362
  123. package/src/middleware/auth-apikey.ts +0 -39
  124. package/src/middleware/auth-bearer.test.ts +0 -566
  125. package/src/middleware/auth-bearer.ts +0 -83
  126. package/src/middleware/auth-cookie.test.ts +0 -572
  127. package/src/middleware/auth-cookie.ts +0 -107
  128. package/src/middleware/cors.test.ts +0 -579
  129. package/src/middleware/cors.ts +0 -103
  130. package/src/middleware/index.ts +0 -30
  131. package/src/middleware/middleware-factories.ts +0 -76
  132. package/src/middleware/middleware.types.ts +0 -61
  133. package/src/middleware/remote-auth.test.ts +0 -547
  134. package/src/middleware/remote-auth.ts +0 -95
  135. package/src/middleware/remote-jobs-secret.ts +0 -35
  136. package/src/middleware/require-origin.test.ts +0 -115
  137. package/src/middleware/require-origin.ts +0 -79
  138. package/src/middleware/telemetry.ts +0 -83
  139. package/src/middleware-runner.test.ts +0 -578
  140. package/src/middleware-runner.ts +0 -232
  141. package/src/no-any-casts.test.ts +0 -57
  142. package/src/no-root-barrel.test.ts +0 -122
  143. package/src/permissions.test.ts +0 -256
  144. package/src/permissions.ts +0 -217
  145. package/src/pikku-state.test.ts +0 -198
  146. package/src/pikku-state.ts +0 -206
  147. package/src/production-barrels-stay-lean.test.ts +0 -110
  148. package/src/public-surface.test.ts +0 -133
  149. package/src/remote.test.ts +0 -173
  150. package/src/remote.ts +0 -56
  151. package/src/removed-legacy-exports.test.ts +0 -66
  152. package/src/run-tests-script.test.ts +0 -67
  153. package/src/schema.test.ts +0 -430
  154. package/src/schema.ts +0 -204
  155. package/src/scopes.test.ts +0 -203
  156. package/src/scopes.ts +0 -67
  157. package/src/services/agent-run-state-service.ts +0 -37
  158. package/src/services/agent-runner-service.ts +0 -238
  159. package/src/services/agent-storage-service.ts +0 -39
  160. package/src/services/ai-embedding-service.ts +0 -9
  161. package/src/services/audit-service.test.ts +0 -44
  162. package/src/services/audit-service.ts +0 -280
  163. package/src/services/content-service.ts +0 -65
  164. package/src/services/credential-service.ts +0 -20
  165. package/src/services/credential-wire-service.test.ts +0 -235
  166. package/src/services/credential-wire-service.ts +0 -120
  167. package/src/services/deployment-service.ts +0 -32
  168. package/src/services/email-service.test.ts +0 -100
  169. package/src/services/email-service.ts +0 -60
  170. package/src/services/email-template.test.ts +0 -311
  171. package/src/services/email-template.ts +0 -254
  172. package/src/services/file-scenario-run-store.test.ts +0 -349
  173. package/src/services/file-scenario-run-store.ts +0 -282
  174. package/src/services/gateway-service.ts +0 -5
  175. package/src/services/http-personas-converse.test.ts +0 -274
  176. package/src/services/http-personas.test.ts +0 -379
  177. package/src/services/http-personas.ts +0 -508
  178. package/src/services/in-memory-agent-run-state-service.ts +0 -87
  179. package/src/services/in-memory-queue-service.test.ts +0 -162
  180. package/src/services/in-memory-queue-service.ts +0 -78
  181. package/src/services/in-memory-session-store.test.ts +0 -58
  182. package/src/services/in-memory-session-store.ts +0 -20
  183. package/src/services/in-memory-trigger-service.ts +0 -47
  184. package/src/services/in-memory-workflow-service.test.ts +0 -430
  185. package/src/services/in-memory-workflow-service.ts +0 -595
  186. package/src/services/index.ts +0 -192
  187. package/src/services/istanbul-coverage-service.test.ts +0 -66
  188. package/src/services/istanbul-coverage-service.ts +0 -59
  189. package/src/services/jwt-service.ts +0 -15
  190. package/src/services/local-content-request-handler.test.ts +0 -240
  191. package/src/services/local-content-request-handler.ts +0 -295
  192. package/src/services/local-content.test.ts +0 -186
  193. package/src/services/local-content.ts +0 -242
  194. package/src/services/local-credential-service.ts +0 -63
  195. package/src/services/local-email-service.test.ts +0 -182
  196. package/src/services/local-email-service.ts +0 -43
  197. package/src/services/local-gateway-service.ts +0 -51
  198. package/src/services/local-secrets.test.ts +0 -95
  199. package/src/services/local-secrets.ts +0 -71
  200. package/src/services/local-variables.test.ts +0 -61
  201. package/src/services/local-variables.ts +0 -45
  202. package/src/services/logger-console.test.ts +0 -117
  203. package/src/services/logger-console.ts +0 -174
  204. package/src/services/logger.ts +0 -48
  205. package/src/services/meta-service.test.ts +0 -75
  206. package/src/services/meta-service.ts +0 -767
  207. package/src/services/persona-actor-secret.test.ts +0 -68
  208. package/src/services/persona-actor-secret.ts +0 -70
  209. package/src/services/persona-sign-in.test.ts +0 -219
  210. package/src/services/persona-sign-in.ts +0 -238
  211. package/src/services/personas-service.ts +0 -191
  212. package/src/services/pikku-user-id.test.ts +0 -62
  213. package/src/services/pikku-user-id.ts +0 -13
  214. package/src/services/queue-webhook-service.test.ts +0 -409
  215. package/src/services/queue-webhook-service.ts +0 -150
  216. package/src/services/remote-jobs.test.ts +0 -106
  217. package/src/services/remote-jobs.ts +0 -92
  218. package/src/services/scheduler-service.ts +0 -37
  219. package/src/services/schema-service.ts +0 -10
  220. package/src/services/scope-service.ts +0 -91
  221. package/src/services/scoped-credential-service.test.ts +0 -86
  222. package/src/services/scoped-credential-service.ts +0 -63
  223. package/src/services/scoped-secret-service.test.ts +0 -93
  224. package/src/services/scoped-secret-service.ts +0 -40
  225. package/src/services/secret-host-binding.test.ts +0 -138
  226. package/src/services/secret-host-binding.ts +0 -51
  227. package/src/services/secret-service.ts +0 -25
  228. package/src/services/secretless.test.ts +0 -54
  229. package/src/services/secretless.ts +0 -29
  230. package/src/services/session-store.ts +0 -9
  231. package/src/services/stub-tracker.test.ts +0 -104
  232. package/src/services/stub-tracker.ts +0 -175
  233. package/src/services/system-role-guard.test.ts +0 -96
  234. package/src/services/system-role-guard.ts +0 -71
  235. package/src/services/temporary-file-service.ts +0 -76
  236. package/src/services/trigger-service.ts +0 -5
  237. package/src/services/typed-credential-service.ts +0 -83
  238. package/src/services/typed-secret-service.test.ts +0 -204
  239. package/src/services/typed-secret-service.ts +0 -132
  240. package/src/services/typed-variables-service.test.ts +0 -166
  241. package/src/services/typed-variables-service.ts +0 -166
  242. package/src/services/user-session-service.test.ts +0 -147
  243. package/src/services/user-session-service.ts +0 -85
  244. package/src/services/v8-coverage-service.test.ts +0 -69
  245. package/src/services/v8-coverage-service.ts +0 -163
  246. package/src/services/variables-service.ts +0 -13
  247. package/src/services/webhook-service.ts +0 -147
  248. package/src/services/workflow-service.ts +0 -120
  249. package/src/side-effects-are-declared.test.ts +0 -84
  250. package/src/source-files-stay-composable.test.ts +0 -41
  251. package/src/template-alias-surface.test.ts +0 -240
  252. package/src/test-utils.ts +0 -38
  253. package/src/testing/index.ts +0 -3
  254. package/src/testing/service-tests/agent-run-service-tests.ts +0 -98
  255. package/src/testing/service-tests/agent-storage-service-tests.ts +0 -379
  256. package/src/testing/service-tests/channel-store-tests.ts +0 -98
  257. package/src/testing/service-tests/credential-service-tests.ts +0 -143
  258. package/src/testing/service-tests/deployment-service-tests.ts +0 -33
  259. package/src/testing/service-tests/event-hub-store-tests.ts +0 -48
  260. package/src/testing/service-tests/secret-service-tests.ts +0 -105
  261. package/src/testing/service-tests/session-store-tests.ts +0 -62
  262. package/src/testing/service-tests/workflow-run-service-tests.ts +0 -59
  263. package/src/testing/service-tests/workflow-service-tests.ts +0 -308
  264. package/src/testing/service-tests.ts +0 -95
  265. package/src/time-utils.test.ts +0 -56
  266. package/src/time-utils.ts +0 -89
  267. package/src/types/core.types.ts +0 -446
  268. package/src/types/index.ts +0 -25
  269. package/src/types/state.types.ts +0 -226
  270. package/src/types/typed-credentials.test.ts +0 -72
  271. package/src/utils/hash.test.ts +0 -68
  272. package/src/utils/hash.ts +0 -26
  273. package/src/utils/hmac.ts +0 -21
  274. package/src/utils/node-host-resolver.ts +0 -20
  275. package/src/utils/safe-fetch.test.ts +0 -515
  276. package/src/utils/safe-fetch.ts +0 -347
  277. package/src/utils.test.ts +0 -359
  278. package/src/utils.ts +0 -165
  279. package/src/version.test.ts +0 -80
  280. package/src/version.ts +0 -25
  281. package/src/wirings/actor-flow/actor-flow.types.ts +0 -40
  282. package/src/wirings/actor-flow/index.ts +0 -10
  283. package/src/wirings/actor-flow/run-conversation.test.ts +0 -187
  284. package/src/wirings/actor-flow/run-conversation.ts +0 -280
  285. package/src/wirings/addon/addon-auth-tags.test.ts +0 -219
  286. package/src/wirings/addon/addon-runner.ts +0 -236
  287. package/src/wirings/addon/addon-scopes.test.ts +0 -225
  288. package/src/wirings/addon/addon-secrets.test.ts +0 -391
  289. package/src/wirings/addon/index.ts +0 -12
  290. package/src/wirings/addon/remote-addon-auth.ts +0 -65
  291. package/src/wirings/addon/wire-addon.test.ts +0 -102
  292. package/src/wirings/addon/wire-addon.ts +0 -202
  293. package/src/wirings/addon/wire-remote-addon.ts +0 -41
  294. package/src/wirings/agent/agent-agui.test.ts +0 -1213
  295. package/src/wirings/agent/agent-agui.ts +0 -405
  296. package/src/wirings/agent/agent-authorization.test.ts +0 -208
  297. package/src/wirings/agent/agent-finalize.test.ts +0 -187
  298. package/src/wirings/agent/agent-finalize.ts +0 -197
  299. package/src/wirings/agent/agent-helpers.test.ts +0 -215
  300. package/src/wirings/agent/agent-helpers.ts +0 -96
  301. package/src/wirings/agent/agent-interrupt.test.ts +0 -833
  302. package/src/wirings/agent/agent-interrupt.ts +0 -400
  303. package/src/wirings/agent/agent-memory.test.ts +0 -397
  304. package/src/wirings/agent/agent-memory.ts +0 -496
  305. package/src/wirings/agent/agent-middleware.types.test.ts +0 -41
  306. package/src/wirings/agent/agent-model-config.test.ts +0 -103
  307. package/src/wirings/agent/agent-model-config.ts +0 -59
  308. package/src/wirings/agent/agent-prepare.test.ts +0 -977
  309. package/src/wirings/agent/agent-prepare.ts +0 -1083
  310. package/src/wirings/agent/agent-registry.test.ts +0 -455
  311. package/src/wirings/agent/agent-registry.ts +0 -99
  312. package/src/wirings/agent/agent-resume-authorization.test.ts +0 -206
  313. package/src/wirings/agent/agent-rpc.ts +0 -116
  314. package/src/wirings/agent/agent-runner.test.ts +0 -1229
  315. package/src/wirings/agent/agent-runner.ts +0 -858
  316. package/src/wirings/agent/agent-stream-delegate.test.ts +0 -381
  317. package/src/wirings/agent/agent-stream-output-hooks.test.ts +0 -353
  318. package/src/wirings/agent/agent-stream.test.ts +0 -1800
  319. package/src/wirings/agent/agent-stream.ts +0 -1639
  320. package/src/wirings/agent/agent-thread-ownership.test.ts +0 -297
  321. package/src/wirings/agent/agent-turn.test.ts +0 -65
  322. package/src/wirings/agent/agent-turn.ts +0 -122
  323. package/src/wirings/agent/agent-utils.ts +0 -20
  324. package/src/wirings/agent/agent.types.ts +0 -676
  325. package/src/wirings/agent/index.ts +0 -58
  326. package/src/wirings/agent/voice-input.test.ts +0 -220
  327. package/src/wirings/agent/voice-input.ts +0 -180
  328. package/src/wirings/agent/voice-output.test.ts +0 -510
  329. package/src/wirings/agent/voice-output.ts +0 -311
  330. package/src/wirings/agent-scorer/agent-scorer-grade.test.ts +0 -106
  331. package/src/wirings/agent-scorer/agent-scorer-grade.ts +0 -55
  332. package/src/wirings/agent-scorer/agent-scorer-judge.test.ts +0 -285
  333. package/src/wirings/agent-scorer/agent-scorer-judge.ts +0 -180
  334. package/src/wirings/agent-scorer/agent-scorer-live.test.ts +0 -174
  335. package/src/wirings/agent-scorer/agent-scorer-live.ts +0 -56
  336. package/src/wirings/agent-scorer/agent-scorer-registry.ts +0 -66
  337. package/src/wirings/agent-scorer/agent-scorer-sampling.test.ts +0 -34
  338. package/src/wirings/agent-scorer/agent-scorer-sampling.ts +0 -36
  339. package/src/wirings/agent-scorer/agent-scorer-snapshots.test.ts +0 -49
  340. package/src/wirings/agent-scorer/agent-scorer-snapshots.ts +0 -46
  341. package/src/wirings/agent-scorer/agent-scorer-worker.test.ts +0 -122
  342. package/src/wirings/agent-scorer/agent-scorer-worker.ts +0 -71
  343. package/src/wirings/agent-scorer/agent-scorer.ts +0 -102
  344. package/src/wirings/agent-scorer/agent-scorer.types.ts +0 -128
  345. package/src/wirings/agent-scorer/index.ts +0 -23
  346. package/src/wirings/channel/channel-common.ts +0 -102
  347. package/src/wirings/channel/channel-handler-shapes.test.ts +0 -72
  348. package/src/wirings/channel/channel-handler.test.ts +0 -322
  349. package/src/wirings/channel/channel-handler.ts +0 -259
  350. package/src/wirings/channel/channel-host-rpc.test.ts +0 -150
  351. package/src/wirings/channel/channel-host-rpc.ts +0 -69
  352. package/src/wirings/channel/channel-middleware-runner.test.ts +0 -188
  353. package/src/wirings/channel/channel-middleware-runner.ts +0 -126
  354. package/src/wirings/channel/channel-rpc-registry.ts +0 -116
  355. package/src/wirings/channel/channel-rpc-responder.ts +0 -117
  356. package/src/wirings/channel/channel-rpc-service.ts +0 -132
  357. package/src/wirings/channel/channel-rpc-validators.ts +0 -65
  358. package/src/wirings/channel/channel-rpc.test.ts +0 -841
  359. package/src/wirings/channel/channel-rpc.ts +0 -5
  360. package/src/wirings/channel/channel-rpc.types.ts +0 -160
  361. package/src/wirings/channel/channel-runner.ts +0 -164
  362. package/src/wirings/channel/channel-store.ts +0 -35
  363. package/src/wirings/channel/channel.types.ts +0 -193
  364. package/src/wirings/channel/define-channel-routes.ts +0 -5
  365. package/src/wirings/channel/eventhub-service.ts +0 -16
  366. package/src/wirings/channel/eventhub-store.ts +0 -13
  367. package/src/wirings/channel/index.ts +0 -40
  368. package/src/wirings/channel/local/index.ts +0 -3
  369. package/src/wirings/channel/local/local-channel-handler.ts +0 -98
  370. package/src/wirings/channel/local/local-channel-runner.test.ts +0 -339
  371. package/src/wirings/channel/local/local-channel-runner.ts +0 -271
  372. package/src/wirings/channel/local/local-eventhub-service.test.ts +0 -77
  373. package/src/wirings/channel/local/local-eventhub-service.ts +0 -69
  374. package/src/wirings/channel/log-channels.ts +0 -16
  375. package/src/wirings/channel/pikku-abstract-channel-handler.test.ts +0 -135
  376. package/src/wirings/channel/pikku-abstract-channel-handler.ts +0 -60
  377. package/src/wirings/channel/serverless/index.ts +0 -6
  378. package/src/wirings/channel/serverless/serverless-channel-runner.ts +0 -328
  379. package/src/wirings/cli/channel/cli-approval.test.ts +0 -177
  380. package/src/wirings/cli/channel/cli-approval.ts +0 -135
  381. package/src/wirings/cli/channel/cli-channel-runner.ts +0 -118
  382. package/src/wirings/cli/channel/cli-raw-channel-runner.test.ts +0 -192
  383. package/src/wirings/cli/channel/cli-raw-channel-runner.ts +0 -148
  384. package/src/wirings/cli/channel/cli-raw-client-runner.test.ts +0 -480
  385. package/src/wirings/cli/channel/cli-raw-client-runner.ts +0 -188
  386. package/src/wirings/cli/channel/index.ts +0 -6
  387. package/src/wirings/cli/cli-runner.test.ts +0 -969
  388. package/src/wirings/cli/cli-runner.ts +0 -538
  389. package/src/wirings/cli/cli.types.ts +0 -388
  390. package/src/wirings/cli/command-parser.test.ts +0 -1120
  391. package/src/wirings/cli/command-parser.ts +0 -713
  392. package/src/wirings/cli/define-cli-commands.ts +0 -13
  393. package/src/wirings/cli/format-cli-error.test.ts +0 -91
  394. package/src/wirings/cli/format-cli-error.ts +0 -96
  395. package/src/wirings/cli/index.ts +0 -19
  396. package/src/wirings/credential/credential.types.ts +0 -37
  397. package/src/wirings/credential/define-credential.ts +0 -49
  398. package/src/wirings/credential/index.ts +0 -7
  399. package/src/wirings/credential/validate-credential-definitions.ts +0 -63
  400. package/src/wirings/gateway/gateway-authorization.test.ts +0 -575
  401. package/src/wirings/gateway/gateway-channel-meta.test.ts +0 -44
  402. package/src/wirings/gateway/gateway-runner.test.ts +0 -581
  403. package/src/wirings/gateway/gateway-runner.ts +0 -411
  404. package/src/wirings/gateway/gateway.types.ts +0 -137
  405. package/src/wirings/gateway/index.ts +0 -15
  406. package/src/wirings/http/http-routes.test.ts +0 -318
  407. package/src/wirings/http/http-routes.ts +0 -111
  408. package/src/wirings/http/http-runner-addon-ref.test.ts +0 -238
  409. package/src/wirings/http/http-runner.test.ts +0 -503
  410. package/src/wirings/http/http-runner.ts +0 -462
  411. package/src/wirings/http/http.types.ts +0 -307
  412. package/src/wirings/http/index.ts +0 -27
  413. package/src/wirings/http/log-http-routes.ts +0 -18
  414. package/src/wirings/http/pikku-fetch-http-request.test.ts +0 -318
  415. package/src/wirings/http/pikku-fetch-http-request.ts +0 -260
  416. package/src/wirings/http/pikku-fetch-http-response.test.ts +0 -123
  417. package/src/wirings/http/pikku-fetch-http-response.ts +0 -149
  418. package/src/wirings/http/routers/http-router.ts +0 -13
  419. package/src/wirings/http/routers/path-to-regex.test.ts +0 -306
  420. package/src/wirings/http/routers/path-to-regex.ts +0 -115
  421. package/src/wirings/http/web-request.test.ts +0 -382
  422. package/src/wirings/http/web-request.ts +0 -162
  423. package/src/wirings/mcp/index.ts +0 -26
  424. package/src/wirings/mcp/mcp-endpoint-registry.test.ts +0 -388
  425. package/src/wirings/mcp/mcp-endpoint-registry.ts +0 -159
  426. package/src/wirings/mcp/mcp-runner.test.ts +0 -588
  427. package/src/wirings/mcp/mcp-runner.ts +0 -330
  428. package/src/wirings/mcp/mcp.types.ts +0 -199
  429. package/src/wirings/node/index.ts +0 -2
  430. package/src/wirings/node/node.types.ts +0 -23
  431. package/src/wirings/oauth2/index.ts +0 -1
  432. package/src/wirings/oauth2/oauth2.types.ts +0 -12
  433. package/src/wirings/persona/define-personas.ts +0 -33
  434. package/src/wirings/persona/index.ts +0 -75
  435. package/src/wirings/persona/persona-app-scopes.test.ts +0 -47
  436. package/src/wirings/persona/persona-app-scopes.ts +0 -74
  437. package/src/wirings/persona/persona-email.ts +0 -87
  438. package/src/wirings/persona/persona-environments.test.ts +0 -194
  439. package/src/wirings/persona/persona-environments.ts +0 -138
  440. package/src/wirings/persona/persona-mailbox.ts +0 -156
  441. package/src/wirings/persona/persona.test.ts +0 -230
  442. package/src/wirings/persona/persona.types.ts +0 -156
  443. package/src/wirings/persona/validate-personas.ts +0 -137
  444. package/src/wirings/queue/index.ts +0 -29
  445. package/src/wirings/queue/queue-identity.test.ts +0 -454
  446. package/src/wirings/queue/queue-identity.ts +0 -176
  447. package/src/wirings/queue/queue-runner.test.ts +0 -705
  448. package/src/wirings/queue/queue-runner.ts +0 -181
  449. package/src/wirings/queue/queue.types.ts +0 -161
  450. package/src/wirings/queue/register-queue-helper.ts +0 -46
  451. package/src/wirings/queue/signed-queue-service.ts +0 -60
  452. package/src/wirings/queue/validate-worker-config.test.ts +0 -108
  453. package/src/wirings/queue/validate-worker-config.ts +0 -90
  454. package/src/wirings/role/define-system-role.ts +0 -33
  455. package/src/wirings/role/index.ts +0 -13
  456. package/src/wirings/role/role.test.ts +0 -104
  457. package/src/wirings/role/role.types.ts +0 -47
  458. package/src/wirings/role/validate-role-definitions.ts +0 -93
  459. package/src/wirings/rpc/index.ts +0 -8
  460. package/src/wirings/rpc/rpc-runner.test.ts +0 -1130
  461. package/src/wirings/rpc/rpc-runner.ts +0 -566
  462. package/src/wirings/rpc/rpc-types.ts +0 -87
  463. package/src/wirings/scheduler/index.ts +0 -11
  464. package/src/wirings/scheduler/log-schedulers.ts +0 -16
  465. package/src/wirings/scheduler/scheduler-runner.test.ts +0 -835
  466. package/src/wirings/scheduler/scheduler-runner.ts +0 -138
  467. package/src/wirings/scheduler/scheduler.types.ts +0 -42
  468. package/src/wirings/scope/define-scope.ts +0 -33
  469. package/src/wirings/scope/index.ts +0 -15
  470. package/src/wirings/scope/scope.test.ts +0 -159
  471. package/src/wirings/scope/scope.types.ts +0 -42
  472. package/src/wirings/scope/validate-scope-definitions.ts +0 -107
  473. package/src/wirings/secret/index.ts +0 -9
  474. package/src/wirings/secret/secret.types.ts +0 -70
  475. package/src/wirings/secret/validate-secret-definitions.test.ts +0 -232
  476. package/src/wirings/secret/validate-secret-definitions.ts +0 -88
  477. package/src/wirings/trigger/index.ts +0 -9
  478. package/src/wirings/trigger/pikku-trigger-service.ts +0 -107
  479. package/src/wirings/trigger/trigger-runner.test.ts +0 -78
  480. package/src/wirings/trigger/trigger-runner.ts +0 -113
  481. package/src/wirings/trigger/trigger.types.ts +0 -100
  482. package/src/wirings/variable/index.ts +0 -8
  483. package/src/wirings/variable/validate-variable-definitions.test.ts +0 -115
  484. package/src/wirings/variable/validate-variable-definitions.ts +0 -71
  485. package/src/wirings/variable/variable.types.ts +0 -40
  486. package/src/wirings/virtual-user/index.ts +0 -107
  487. package/src/wirings/virtual-user/prepare-virtual-user-run.test.ts +0 -115
  488. package/src/wirings/virtual-user/prepare-virtual-user-run.ts +0 -95
  489. package/src/wirings/virtual-user/run-virtual-user.test.ts +0 -774
  490. package/src/wirings/virtual-user/run-virtual-user.ts +0 -684
  491. package/src/wirings/virtual-user/virtual-user-agents.test.ts +0 -72
  492. package/src/wirings/virtual-user/virtual-user-agents.ts +0 -62
  493. package/src/wirings/virtual-user/virtual-user-catalogue.test.ts +0 -215
  494. package/src/wirings/virtual-user/virtual-user-catalogue.ts +0 -184
  495. package/src/wirings/virtual-user/virtual-user-derive.test.ts +0 -426
  496. package/src/wirings/virtual-user/virtual-user-derive.ts +0 -161
  497. package/src/wirings/virtual-user/virtual-user-dispositions.test.ts +0 -68
  498. package/src/wirings/virtual-user/virtual-user-dispositions.ts +0 -210
  499. package/src/wirings/virtual-user/virtual-user-intents.test.ts +0 -218
  500. package/src/wirings/virtual-user/virtual-user-intents.ts +0 -185
  501. package/src/wirings/virtual-user/virtual-user-rng.test.ts +0 -72
  502. package/src/wirings/virtual-user/virtual-user-rng.ts +0 -50
  503. package/src/wirings/virtual-user/virtual-user-run-store.ts +0 -131
  504. package/src/wirings/virtual-user/virtual-user-scaffold.test.ts +0 -854
  505. package/src/wirings/virtual-user/virtual-user-scaffold.ts +0 -664
  506. package/src/wirings/virtual-user/virtual-user-schedule-store.ts +0 -93
  507. package/src/wirings/virtual-user/virtual-user-schedule.test.ts +0 -280
  508. package/src/wirings/virtual-user/virtual-user-schedule.ts +0 -156
  509. package/src/wirings/virtual-user/virtual-user-target.ts +0 -47
  510. package/src/wirings/virtual-user/virtual-user.types.ts +0 -215
  511. package/src/wirings/workflow/dsl/workflow-dsl.types.ts +0 -709
  512. package/src/wirings/workflow/dsl/workflow-runner.ts +0 -25
  513. package/src/wirings/workflow/feature.test.ts +0 -131
  514. package/src/wirings/workflow/feature.ts +0 -59
  515. package/src/wirings/workflow/graph/graph-foreach-queued.test.ts +0 -569
  516. package/src/wirings/workflow/graph/graph-foreach.test.ts +0 -626
  517. package/src/wirings/workflow/graph/graph-node.ts +0 -115
  518. package/src/wirings/workflow/graph/graph-runner.test.ts +0 -1049
  519. package/src/wirings/workflow/graph/graph-runner.ts +0 -1376
  520. package/src/wirings/workflow/graph/graph-validation.test.ts +0 -27
  521. package/src/wirings/workflow/graph/graph-validation.ts +0 -41
  522. package/src/wirings/workflow/graph/template.test.ts +0 -49
  523. package/src/wirings/workflow/graph/template.ts +0 -42
  524. package/src/wirings/workflow/graph/wire-workflow-graph.ts +0 -39
  525. package/src/wirings/workflow/graph/workflow-graph.types.ts +0 -75
  526. package/src/wirings/workflow/index.ts +0 -107
  527. package/src/wirings/workflow/pikku-scenario-service.ts +0 -1013
  528. package/src/wirings/workflow/pikku-workflow-service.test.ts +0 -963
  529. package/src/wirings/workflow/pikku-workflow-service.ts +0 -1993
  530. package/src/wirings/workflow/run-timeline.test.ts +0 -199
  531. package/src/wirings/workflow/run-timeline.ts +0 -185
  532. package/src/wirings/workflow/scenario-cookie-jar.test.ts +0 -107
  533. package/src/wirings/workflow/scenario-cookie-jar.ts +0 -57
  534. package/src/wirings/workflow/scenario-expectations.test.ts +0 -238
  535. package/src/wirings/workflow/scenario-hooks.test.ts +0 -259
  536. package/src/wirings/workflow/scenario-poll.test.ts +0 -64
  537. package/src/wirings/workflow/scenario-poll.ts +0 -27
  538. package/src/wirings/workflow/scenario-prose.test.ts +0 -275
  539. package/src/wirings/workflow/scenario-prose.ts +0 -86
  540. package/src/wirings/workflow/scenario-run.types.ts +0 -193
  541. package/src/wirings/workflow/scenario-service.test.ts +0 -147
  542. package/src/wirings/workflow/scenario-step-guards.ts +0 -23
  543. package/src/wirings/workflow/scenario-step.test.ts +0 -800
  544. package/src/wirings/workflow/scenario-step.types.ts +0 -262
  545. package/src/wirings/workflow/scenario-surface.test.ts +0 -146
  546. package/src/wirings/workflow/scenario-surface.ts +0 -71
  547. package/src/wirings/workflow/scenario.types.ts +0 -63
  548. package/src/wirings/workflow/workflow-approval-audit.ts +0 -47
  549. package/src/wirings/workflow/workflow-approval-policy.test.ts +0 -594
  550. package/src/wirings/workflow/workflow-approval-policy.ts +0 -68
  551. package/src/wirings/workflow/workflow-approval.ts +0 -290
  552. package/src/wirings/workflow/workflow-child-run-session.test.ts +0 -168
  553. package/src/wirings/workflow/workflow-constants.ts +0 -66
  554. package/src/wirings/workflow/workflow-dispatch-durability.test.ts +0 -116
  555. package/src/wirings/workflow/workflow-dispatch-payload.test.ts +0 -55
  556. package/src/wirings/workflow/workflow-dispatch-relay.test.ts +0 -128
  557. package/src/wirings/workflow/workflow-errors.ts +0 -132
  558. package/src/wirings/workflow/workflow-inline-authority.test.ts +0 -175
  559. package/src/wirings/workflow/workflow-invocation-id.test.ts +0 -51
  560. package/src/wirings/workflow/workflow-invocation-id.ts +0 -28
  561. package/src/wirings/workflow/workflow-meta-resolver.ts +0 -45
  562. package/src/wirings/workflow/workflow-mirror.test.ts +0 -171
  563. package/src/wirings/workflow/workflow-missing-meta.test.ts +0 -92
  564. package/src/wirings/workflow/workflow-on-error.test.ts +0 -145
  565. package/src/wirings/workflow/workflow-queue-routing.ts +0 -129
  566. package/src/wirings/workflow/workflow-queue-wiring.ts +0 -149
  567. package/src/wirings/workflow/workflow-queue-workers.test.ts +0 -131
  568. package/src/wirings/workflow/workflow-queue-workers.ts +0 -66
  569. package/src/wirings/workflow/workflow-recovery.ts +0 -192
  570. package/src/wirings/workflow/workflow-replay-snapshot.test.ts +0 -140
  571. package/src/wirings/workflow/workflow-retry-policy.test.ts +0 -113
  572. package/src/wirings/workflow/workflow-run-authority.test.ts +0 -212
  573. package/src/wirings/workflow/workflow-run-context.test.ts +0 -172
  574. package/src/wirings/workflow/workflow-run-engine.types.ts +0 -92
  575. package/src/wirings/workflow/workflow-run-ownership.ts +0 -37
  576. package/src/wirings/workflow/workflow-run-polling.test.ts +0 -127
  577. package/src/wirings/workflow/workflow-stalled-recovery.test.ts +0 -152
  578. package/src/wirings/workflow/workflow-status-stream.test.ts +0 -354
  579. package/src/wirings/workflow/workflow-status-stream.ts +0 -144
  580. package/src/wirings/workflow/workflow-step-claim.ts +0 -46
  581. package/src/wirings/workflow/workflow-step-ordinal.test.ts +0 -94
  582. package/src/wirings/workflow/workflow-step-session.test.ts +0 -87
  583. package/src/wirings/workflow/workflow-suspend.ts +0 -61
  584. package/src/wirings/workflow/workflow-terminal-run-guard.test.ts +0 -105
  585. package/src/wirings/workflow/workflow.types.ts +0 -268
  586. package/src/wirings-stay-decoupled.test.ts +0 -130
  587. package/tsconfig.json +0 -14
  588. package/tsconfig.tsbuildinfo +0 -1
  589. 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
- })