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