@pithy-sh/auth 0.15.3 → 0.17.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (209) hide show
  1. package/README.md +4 -0
  2. package/dist/attestation/appAttest/assertion.d.ts +32 -0
  3. package/dist/attestation/appAttest/assertion.d.ts.map +1 -0
  4. package/dist/attestation/appAttest/assertion.js +59 -0
  5. package/dist/attestation/appAttest/attestation.d.ts +49 -0
  6. package/dist/attestation/appAttest/attestation.d.ts.map +1 -0
  7. package/dist/attestation/appAttest/attestation.js +111 -0
  8. package/dist/attestation/appAttest/authData.d.ts +24 -0
  9. package/dist/attestation/appAttest/authData.d.ts.map +1 -0
  10. package/dist/attestation/appAttest/authData.js +32 -0
  11. package/dist/attestation/appAttest/base64.d.ts +8 -0
  12. package/dist/attestation/appAttest/base64.d.ts.map +1 -0
  13. package/dist/attestation/appAttest/base64.js +27 -0
  14. package/dist/attestation/appAttest/bytes.d.ts +7 -0
  15. package/dist/attestation/appAttest/bytes.d.ts.map +1 -0
  16. package/dist/attestation/appAttest/bytes.js +19 -0
  17. package/dist/attestation/appAttest/cbor.d.ts +20 -0
  18. package/dist/attestation/appAttest/cbor.d.ts.map +1 -0
  19. package/dist/attestation/appAttest/cbor.js +96 -0
  20. package/dist/attestation/appAttest/der.d.ts +38 -0
  21. package/dist/attestation/appAttest/der.d.ts.map +1 -0
  22. package/dist/attestation/appAttest/der.js +106 -0
  23. package/dist/attestation/appAttest/keys.d.ts +15 -0
  24. package/dist/attestation/appAttest/keys.d.ts.map +1 -0
  25. package/dist/attestation/appAttest/keys.js +37 -0
  26. package/dist/attestation/appAttest/root.d.ts +9 -0
  27. package/dist/attestation/appAttest/root.d.ts.map +1 -0
  28. package/dist/attestation/appAttest/root.js +12 -0
  29. package/dist/attestation/appAttest/verifier.d.ts +39 -0
  30. package/dist/attestation/appAttest/verifier.d.ts.map +1 -0
  31. package/dist/attestation/appAttest/verifier.js +121 -0
  32. package/dist/attestation/appAttest/x509.d.ts +50 -0
  33. package/dist/attestation/appAttest/x509.d.ts.map +1 -0
  34. package/dist/attestation/appAttest/x509.js +163 -0
  35. package/dist/attestation/challenge.d.ts +26 -0
  36. package/dist/attestation/challenge.d.ts.map +1 -0
  37. package/dist/attestation/challenge.js +47 -0
  38. package/dist/attestation/config.d.ts +72 -0
  39. package/dist/attestation/config.d.ts.map +1 -0
  40. package/dist/attestation/config.js +52 -0
  41. package/dist/attestation/errors.d.ts +30 -0
  42. package/dist/attestation/errors.d.ts.map +1 -0
  43. package/dist/attestation/errors.js +45 -0
  44. package/dist/attestation/gate.d.ts +27 -0
  45. package/dist/attestation/gate.d.ts.map +1 -0
  46. package/dist/attestation/gate.js +78 -0
  47. package/dist/attestation/playIntegrity/google.d.ts +47 -0
  48. package/dist/attestation/playIntegrity/google.d.ts.map +1 -0
  49. package/dist/attestation/playIntegrity/google.js +178 -0
  50. package/dist/attestation/playIntegrity/verdict.d.ts +40 -0
  51. package/dist/attestation/playIntegrity/verdict.d.ts.map +1 -0
  52. package/dist/attestation/playIntegrity/verdict.js +93 -0
  53. package/dist/attestation/playIntegrity/verifier.d.ts +22 -0
  54. package/dist/attestation/playIntegrity/verifier.d.ts.map +1 -0
  55. package/dist/attestation/playIntegrity/verifier.js +64 -0
  56. package/dist/attestation/verifier.d.ts +60 -0
  57. package/dist/attestation/verifier.d.ts.map +1 -0
  58. package/dist/attestation/verifier.js +46 -0
  59. package/dist/attestation/wire.d.ts +42 -0
  60. package/dist/attestation/wire.d.ts.map +1 -0
  61. package/dist/attestation/wire.js +72 -0
  62. package/dist/capability.d.ts +49 -6
  63. package/dist/capability.d.ts.map +1 -1
  64. package/dist/capability.js +42 -7
  65. package/dist/client/api.d.ts +37 -24
  66. package/dist/client/api.d.ts.map +1 -1
  67. package/dist/client/api.js +52 -41
  68. package/dist/client/attestation.d.ts +148 -0
  69. package/dist/client/attestation.d.ts.map +1 -0
  70. package/dist/client/attestation.js +321 -0
  71. package/dist/client/projection.d.ts +29 -4
  72. package/dist/client/projection.d.ts.map +1 -1
  73. package/dist/data/appAttestKey.d.ts +30 -0
  74. package/dist/data/appAttestKey.d.ts.map +1 -0
  75. package/dist/data/appAttestKey.js +25 -0
  76. package/dist/data/attestationChallenge.d.ts +17 -0
  77. package/dist/data/attestationChallenge.d.ts.map +1 -0
  78. package/dist/data/attestationChallenge.js +19 -0
  79. package/dist/data/tables.d.ts +19 -1
  80. package/dist/data/tables.d.ts.map +1 -1
  81. package/dist/data/tables.js +6 -2
  82. package/dist/data/userLifecycle.d.ts +1 -0
  83. package/dist/data/userLifecycle.d.ts.map +1 -1
  84. package/dist/data/userLifecycle.js +3 -2
  85. package/dist/hooks/runtime.d.ts +32 -0
  86. package/dist/hooks/runtime.d.ts.map +1 -0
  87. package/dist/hooks/runtime.js +25 -0
  88. package/dist/http/adminRoutes.d.ts.map +1 -1
  89. package/dist/http/adminRoutes.js +4 -2
  90. package/dist/http/devLoginRoute.js +3 -3
  91. package/dist/http/resolve.d.ts.map +1 -1
  92. package/dist/http/resolve.js +3 -2
  93. package/dist/http/responses.d.ts +15 -0
  94. package/dist/http/responses.d.ts.map +1 -1
  95. package/dist/http/responses.js +13 -2
  96. package/dist/http/routes.d.ts +5 -1
  97. package/dist/http/routes.d.ts.map +1 -1
  98. package/dist/http/routes.js +92 -25
  99. package/dist/http/schemas.d.ts +7 -0
  100. package/dist/http/schemas.d.ts.map +1 -1
  101. package/dist/http/schemas.js +7 -1
  102. package/dist/index.js +1 -1
  103. package/dist/instance/secrets.d.ts +86 -7
  104. package/dist/instance/secrets.d.ts.map +1 -1
  105. package/dist/instance/secrets.js +54 -8
  106. package/dist/lifecycle/erasure.d.ts.map +1 -1
  107. package/dist/lifecycle/erasure.js +2 -1
  108. package/dist/lifecycle/hooks.d.ts +18 -10
  109. package/dist/lifecycle/hooks.d.ts.map +1 -1
  110. package/dist/lifecycle/request.d.ts +2 -1
  111. package/dist/lifecycle/request.d.ts.map +1 -1
  112. package/dist/lifecycle/request.js +4 -1
  113. package/dist/lifecycle/transitions.d.ts +24 -16
  114. package/dist/lifecycle/transitions.d.ts.map +1 -1
  115. package/dist/lifecycle/transitions.js +27 -16
  116. package/dist/migrations/0009_attestation_challenges.d.ts +9 -0
  117. package/dist/migrations/0009_attestation_challenges.d.ts.map +1 -0
  118. package/dist/migrations/0009_attestation_challenges.js +21 -0
  119. package/dist/migrations/0010_app_attest_keys.d.ts +9 -0
  120. package/dist/migrations/0010_app_attest_keys.d.ts.map +1 -0
  121. package/dist/migrations/0010_app_attest_keys.js +17 -0
  122. package/dist/migrations/0011_retained_basis_key.d.ts +10 -0
  123. package/dist/migrations/0011_retained_basis_key.d.ts.map +1 -0
  124. package/dist/migrations/0011_retained_basis_key.js +18 -0
  125. package/dist/migrations/set.d.ts +4 -1
  126. package/dist/migrations/set.d.ts.map +1 -1
  127. package/dist/migrations/set.js +8 -2
  128. package/dist/purge/run.d.ts +11 -11
  129. package/dist/purge/run.d.ts.map +1 -1
  130. package/dist/purge/run.js +9 -8
  131. package/dist/purge/workflow.d.ts +7 -1
  132. package/dist/purge/workflow.d.ts.map +1 -1
  133. package/dist/purge/workflow.js +6 -2
  134. package/dist/seeds/devSession.js +1 -1
  135. package/dist/test-utils/appAttestDevice.d.ts +92 -0
  136. package/dist/test-utils/appAttestDevice.d.ts.map +1 -0
  137. package/dist/test-utils/appAttestDevice.js +282 -0
  138. package/dist/test-utils/appAttestSample.d.ts +22 -0
  139. package/dist/test-utils/appAttestSample.d.ts.map +1 -0
  140. package/dist/test-utils/appAttestSample.js +24 -0
  141. package/dist/test-utils/googlePlay.d.ts +47 -0
  142. package/dist/test-utils/googlePlay.d.ts.map +1 -0
  143. package/dist/test-utils/googlePlay.js +117 -0
  144. package/dist/test-utils/liveApp.d.ts +76 -36
  145. package/dist/test-utils/liveApp.d.ts.map +1 -1
  146. package/dist/test-utils/liveApp.js +16 -5
  147. package/dist/test-utils/rollbackThrough.d.ts +11 -0
  148. package/dist/test-utils/rollbackThrough.d.ts.map +1 -0
  149. package/dist/test-utils/rollbackThrough.js +16 -0
  150. package/dist/test-utils/scopedBackend.d.ts +25 -0
  151. package/dist/test-utils/scopedBackend.d.ts.map +1 -1
  152. package/dist/test-utils/scopedBackend.js +1 -1
  153. package/dist/version.generated.d.ts +1 -1
  154. package/dist/version.generated.js +1 -1
  155. package/docs/account-lifecycle.md +46 -10
  156. package/docs/attestation.md +173 -0
  157. package/package.json +5 -5
  158. package/pithy.manifest.json +14 -0
  159. package/src/attestation/appAttest/assertion.ts +65 -0
  160. package/src/attestation/appAttest/attestation.ts +159 -0
  161. package/src/attestation/appAttest/authData.ts +45 -0
  162. package/src/attestation/appAttest/base64.ts +29 -0
  163. package/src/attestation/appAttest/bytes.ts +18 -0
  164. package/src/attestation/appAttest/cbor.ts +116 -0
  165. package/src/attestation/appAttest/der.ts +126 -0
  166. package/src/attestation/appAttest/keys.ts +57 -0
  167. package/src/attestation/appAttest/root.ts +13 -0
  168. package/src/attestation/appAttest/verifier.ts +113 -0
  169. package/src/attestation/appAttest/x509.ts +209 -0
  170. package/src/attestation/challenge.ts +56 -0
  171. package/src/attestation/config.ts +118 -0
  172. package/src/attestation/errors.ts +60 -0
  173. package/src/attestation/gate.ts +105 -0
  174. package/src/attestation/playIntegrity/google.ts +239 -0
  175. package/src/attestation/playIntegrity/verdict.ts +149 -0
  176. package/src/attestation/playIntegrity/verifier.ts +77 -0
  177. package/src/attestation/verifier.ts +87 -0
  178. package/src/attestation/wire.ts +79 -0
  179. package/src/capability.ts +85 -16
  180. package/src/client/api.ts +73 -40
  181. package/src/client/attestation.ts +404 -0
  182. package/src/client/projection.ts +29 -4
  183. package/src/data/appAttestKey.ts +45 -0
  184. package/src/data/attestationChallenge.ts +23 -0
  185. package/src/data/tables.ts +5 -1
  186. package/src/data/userLifecycle.ts +9 -2
  187. package/src/hooks/runtime.ts +41 -0
  188. package/src/http/adminRoutes.ts +14 -7
  189. package/src/http/resolve.ts +8 -4
  190. package/src/http/responses.ts +29 -1
  191. package/src/http/routes.ts +128 -38
  192. package/src/http/schemas.ts +24 -0
  193. package/src/instance/secrets.ts +88 -9
  194. package/src/lifecycle/erasure.ts +2 -1
  195. package/src/lifecycle/hooks.ts +22 -10
  196. package/src/lifecycle/request.ts +4 -1
  197. package/src/lifecycle/transitions.ts +47 -28
  198. package/src/migrations/0009_attestation_challenges.ts +28 -0
  199. package/src/migrations/0010_app_attest_keys.ts +27 -0
  200. package/src/migrations/0011_retained_basis_key.ts +19 -0
  201. package/src/migrations/set.ts +7 -1
  202. package/src/purge/run.ts +29 -17
  203. package/src/purge/workflow.ts +7 -3
  204. package/src/test-utils/appAttestDevice.ts +399 -0
  205. package/src/test-utils/appAttestSample.ts +20 -0
  206. package/src/test-utils/googlePlay.ts +144 -0
  207. package/src/test-utils/liveApp.ts +31 -5
  208. package/src/test-utils/rollbackThrough.ts +24 -0
  209. package/src/version.generated.ts +1 -1
@@ -24,6 +24,9 @@ import type { SessionSecretVersions } from "./sessionSecrets";
24
24
  * - `auth-microsoft-credentials` — the Microsoft Entra ID app registration's client id, client secret,
25
25
  * and tenant, as a typed JSON value. The tenant rides inside because it means nothing apart from the
26
26
  * registration it belongs to. Rotatable: an Entra client secret expires (24 months at most).
27
+ * - `auth-play-integrity-service-account` — the Google Cloud service account JSON key the Worker decodes Play
28
+ * Integrity tokens with. Read only when an Android attestation arrives; rotated by adding a key in Google
29
+ * Cloud Console, not on our schedule.
27
30
  */
28
31
  export declare const AUTH_SESSION_SECRET = "auth-session-secret";
29
32
  export declare const AUTH_GOOGLE_CREDENTIALS = "auth-google-credentials";
@@ -31,8 +34,9 @@ export declare const AUTH_APPLE_CREDENTIALS = "auth-apple-credentials";
31
34
  export declare const AUTH_FACEBOOK_CREDENTIALS = "auth-facebook-credentials";
32
35
  export declare const AUTH_GITHUB_CREDENTIALS = "auth-github-credentials";
33
36
  export declare const AUTH_MICROSOFT_CREDENTIALS = "auth-microsoft-credentials";
37
+ export declare const AUTH_PLAY_INTEGRITY_SERVICE_ACCOUNT = "auth-play-integrity-service-account";
34
38
  /**
35
- * The JWKS private keys, as `auth-session-secret`'s overlap names them (#602).
39
+ * The JWKS private keys, as `auth-session-secret`'s overlap names them.
36
40
  *
37
41
  * Better Auth encrypts every key in `pithy_auth_jwks` under the session secret, and a key never expires —
38
42
  * so retiring the version one is sealed under would leave a signing key nothing can open. The session
@@ -96,6 +100,20 @@ export declare const MicrosoftOAuthCredentials: z.ZodObject<{
96
100
  tenantId: z.ZodString;
97
101
  }, z.core.$strip>;
98
102
  export type MicrosoftOAuthCredentials = z.infer<typeof MicrosoftOAuthCredentials>;
103
+ /**
104
+ * The Google Cloud service account key Play Integrity tokens are decoded with: the JSON file Google Cloud
105
+ * Console downloads, pasted whole. Fields auth does not read are dropped on write.
106
+ */
107
+ export declare const PlayIntegrityServiceAccount: z.ZodObject<{
108
+ type: z.ZodOptional<z.ZodLiteral<"service_account">>;
109
+ project_id: z.ZodOptional<z.ZodString>;
110
+ private_key_id: z.ZodOptional<z.ZodString>;
111
+ private_key: z.ZodString;
112
+ client_email: z.ZodString;
113
+ client_id: z.ZodOptional<z.ZodString>;
114
+ token_uri: z.ZodOptional<z.ZodString>;
115
+ }, z.core.$strip>;
116
+ export type PlayIntegrityServiceAccount = z.infer<typeof PlayIntegrityServiceAccount>;
99
117
  export declare const authSecretsRegistry: {
100
118
  readonly "auth-session-secret": {
101
119
  readonly backend: "d1";
@@ -222,9 +240,34 @@ export declare const authSecretsRegistry: {
222
240
  readonly documentation: "https://entra.microsoft.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade";
223
241
  };
224
242
  };
243
+ readonly "auth-play-integrity-service-account": {
244
+ readonly backend: "d1";
245
+ readonly scope: "environment";
246
+ readonly rotatable: false;
247
+ readonly valueType: "json";
248
+ readonly schema: z.ZodObject<{
249
+ type: z.ZodOptional<z.ZodLiteral<"service_account">>;
250
+ project_id: z.ZodOptional<z.ZodString>;
251
+ private_key_id: z.ZodOptional<z.ZodString>;
252
+ private_key: z.ZodString;
253
+ client_email: z.ZodString;
254
+ client_id: z.ZodOptional<z.ZodString>;
255
+ token_uri: z.ZodOptional<z.ZodString>;
256
+ }, z.core.$strip>;
257
+ readonly origin: {
258
+ readonly kind: "obtained";
259
+ readonly issuer: "google";
260
+ readonly documentation: "https://console.cloud.google.com/iam-admin/serviceaccounts";
261
+ };
262
+ readonly rotation: {
263
+ readonly kind: "manual";
264
+ readonly issuer: "google";
265
+ readonly documentation: "https://console.cloud.google.com/iam-admin/serviceaccounts";
266
+ };
267
+ };
225
268
  };
226
269
  /**
227
- * **The registry `auth()` contributes, from its own configuration (#602).**
270
+ * **The registry `auth()` contributes, from its own configuration.**
228
271
  *
229
272
  * The session secret's overlap follows the configured session lifetime — {@link sessionSecretOverlapDays} —
230
273
  * and it is both the overlap and its floor: an adopter who lengthens sessions lengthens the overlap with
@@ -347,6 +390,31 @@ export declare function authSecretsRegistryFor(config: {
347
390
  readonly documentation: "https://entra.microsoft.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade";
348
391
  };
349
392
  };
393
+ readonly "auth-play-integrity-service-account": {
394
+ readonly backend: "d1";
395
+ readonly scope: "environment";
396
+ readonly rotatable: false;
397
+ readonly valueType: "json";
398
+ readonly schema: z.ZodObject<{
399
+ type: z.ZodOptional<z.ZodLiteral<"service_account">>;
400
+ project_id: z.ZodOptional<z.ZodString>;
401
+ private_key_id: z.ZodOptional<z.ZodString>;
402
+ private_key: z.ZodString;
403
+ client_email: z.ZodString;
404
+ client_id: z.ZodOptional<z.ZodString>;
405
+ token_uri: z.ZodOptional<z.ZodString>;
406
+ }, z.core.$strip>;
407
+ readonly origin: {
408
+ readonly kind: "obtained";
409
+ readonly issuer: "google";
410
+ readonly documentation: "https://console.cloud.google.com/iam-admin/serviceaccounts";
411
+ };
412
+ readonly rotation: {
413
+ readonly kind: "manual";
414
+ readonly issuer: "google";
415
+ readonly documentation: "https://console.cloud.google.com/iam-admin/serviceaccounts";
416
+ };
417
+ };
350
418
  readonly "auth-session-secret": {
351
419
  readonly backend: "d1";
352
420
  readonly scope: "environment";
@@ -373,7 +441,7 @@ export declare function authSecretsRegistryFor(config: {
373
441
  };
374
442
  };
375
443
  /**
376
- * Which provider a credential belongs to — the join the CLI must never make by spelling (#541).
444
+ * Which provider a credential belongs to — the join the CLI must never make by spelling.
377
445
  *
378
446
  * `auth-apple-credentials` and the `apple` config key look like each other and that is a coincidence:
379
447
  * nothing makes a secret name and a config key the same thing, and a reporting command that matched
@@ -388,9 +456,9 @@ export type AuthProviderToggles = Record<(typeof PROVIDER_CREDENTIALS)[number][0
388
456
  * **The provider credentials this composition cannot reach**, as the `inapplicableSecrets` contribution.
389
457
  *
390
458
  * Auth declares five credentials whether or not a project runs five providers, so a project on Google
391
- * and GitHub carries two secrets nothing will ever read. `pithy doctor` asked for them every run under
392
- * *"fine to leave until you need it"* — softening, not silence, and "until you need it" is wrong about a
393
- * provider the configuration has not enabled.
459
+ * and GitHub carries two secrets nothing will ever read. A disabled provider's credential is listed as not
460
+ * applicable rather than as outstanding work: "set it until you need it" is wrong about a provider the
461
+ * configuration has not enabled.
394
462
  *
395
463
  * **The session secret is never in here**, and that is the line this draws: it is read on every sign-in
396
464
  * whatever the providers are, so it is outstanding work in every project that has not set it.
@@ -402,7 +470,7 @@ export declare function inapplicableProviderSecrets(providers: AuthProviderToggl
402
470
  /** Resolve the Better Auth session secret for this invocation — the current version alone. */
403
471
  export declare function resolveSessionSecret(env: SecretsStoreEnv): Promise<string>;
404
472
  /**
405
- * Resolve every retained version of the session secret (#602) — what an instance needs to open values sealed
473
+ * Resolve every retained version of the session secret: what an instance needs to open values sealed
406
474
  * under the previous version, and what a credential signed under it is verified against. One read through
407
475
  * the same cached accessor as {@link resolveSessionSecret}.
408
476
  */
@@ -415,6 +483,17 @@ export declare function resolveAppleCredentials(env: SecretsStoreEnv): Promise<A
415
483
  export declare function resolveFacebookCredentials(env: SecretsStoreEnv): Promise<FacebookOAuthCredentials>;
416
484
  /** Resolve the GitHub OAuth credential pair for this invocation (only call when GitHub is enabled). */
417
485
  export declare function resolveGithubCredentials(env: SecretsStoreEnv): Promise<GithubOAuthCredentials>;
486
+ /**
487
+ * The Play Integrity service account when no environment of this composition allows an Android app: nothing
488
+ * there reads it.
489
+ */
490
+ export declare function inapplicablePlayIntegritySecret(attestation: {
491
+ environments: Record<string, {
492
+ android: readonly unknown[];
493
+ }>;
494
+ }): Record<string, string>;
495
+ /** Resolve the Play Integrity service account for this invocation (only call for an Android attestation). */
496
+ export declare function resolvePlayIntegrityServiceAccount(env: SecretsStoreEnv): Promise<PlayIntegrityServiceAccount>;
418
497
  /** Resolve the Microsoft Entra ID credentials for this invocation (only call when Microsoft is enabled). */
419
498
  export declare function resolveMicrosoftCredentials(env: SecretsStoreEnv): Promise<MicrosoftOAuthCredentials>;
420
499
  export {};
@@ -1 +1 @@
1
- {"version":3,"file":"secrets.d.ts","sourceRoot":"","sources":["../../src/instance/secrets.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAG1E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,mBAAmB,wBAAwB,CAAC;AACzD,eAAO,MAAM,uBAAuB,4BAA4B,CAAC;AACjE,eAAO,MAAM,sBAAsB,2BAA2B,CAAC;AAC/D,eAAO,MAAM,yBAAyB,8BAA8B,CAAC;AACrE,eAAO,MAAM,uBAAuB,4BAA4B,CAAC;AACjE,eAAO,MAAM,0BAA0B,+BAA+B,CAAC;AAEvE;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,cAAc,CAAC;AAE/C;;;;;;;GAOG;AACH,eAAO,MAAM,8BAA8B,EAAE,SAAS,MAAM,EAAmB,CAAC;AAKhF;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,yEAAyE;AACzE,eAAO,MAAM,sBAAsB;;;iBAaoE,CAAC;AACxG,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE5E,sEAAsE;AACtE,eAAO,MAAM,qBAAqB;;;;iBAsB/B,CAAC;AACJ,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE1E,2EAA2E;AAC3E,eAAO,MAAM,wBAAwB;;;iBAa6D,CAAC;AACnG,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEhF,yEAAyE;AACzE,eAAO,MAAM,sBAAsB;;;iBAa6D,CAAC;AACjG,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE5E;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB;;;;iBAsB4E,CAAC;AACnH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAiBlF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkE9B,CAAC;AAEH;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE;IAC7C,gBAAgB,EAAE,MAAM,CAAC;IACzB,4BAA4B,CAAC,EAAE,MAAM,CAAC;IACtC,OAAO,CAAC,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsBA;AAED;;;;;;GAMG;AACH,QAAA,MAAM,oBAAoB,sBACvB,QAAQ,wCACR,OAAO,uCACP,UAAU,0CACV,QAAQ,wCACR,WAAW,gCACJ,CAAC;AAEX,yGAAyG;AACzG,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AAEzG;;;;;;;;;;;;;GAaG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOlG;AAED,8FAA8F;AAC9F,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAGhF;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAGhG;AAED,uGAAuG;AACvG,wBAAsB,wBAAwB,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAGpG;AAED,mGAAmG;AACnG,wBAAsB,uBAAuB,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAGlG;AAED,2GAA2G;AAC3G,wBAAsB,0BAA0B,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAGxG;AAED,uGAAuG;AACvG,wBAAsB,wBAAwB,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAGpG;AAED,4GAA4G;AAC5G,wBAAsB,2BAA2B,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAG1G"}
1
+ {"version":3,"file":"secrets.d.ts","sourceRoot":"","sources":["../../src/instance/secrets.ts"],"names":[],"mappings":"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"}
@@ -26,6 +26,9 @@ import { sharedSecretsStore } from "@pithy-sh/secrets/src/sharedSecretsStore";
26
26
  * - `auth-microsoft-credentials` — the Microsoft Entra ID app registration's client id, client secret,
27
27
  * and tenant, as a typed JSON value. The tenant rides inside because it means nothing apart from the
28
28
  * registration it belongs to. Rotatable: an Entra client secret expires (24 months at most).
29
+ * - `auth-play-integrity-service-account` — the Google Cloud service account JSON key the Worker decodes Play
30
+ * Integrity tokens with. Read only when an Android attestation arrives; rotated by adding a key in Google
31
+ * Cloud Console, not on our schedule.
29
32
  */
30
33
  const AUTH_SESSION_SECRET = "auth-session-secret";
31
34
  const AUTH_GOOGLE_CREDENTIALS = "auth-google-credentials";
@@ -33,8 +36,9 @@ const AUTH_APPLE_CREDENTIALS = "auth-apple-credentials";
33
36
  const AUTH_FACEBOOK_CREDENTIALS = "auth-facebook-credentials";
34
37
  const AUTH_GITHUB_CREDENTIALS = "auth-github-credentials";
35
38
  const AUTH_MICROSOFT_CREDENTIALS = "auth-microsoft-credentials";
39
+ const AUTH_PLAY_INTEGRITY_SERVICE_ACCOUNT = "auth-play-integrity-service-account";
36
40
  /**
37
- * The JWKS private keys, as `auth-session-secret`'s overlap names them (#602).
41
+ * The JWKS private keys, as `auth-session-secret`'s overlap names them.
38
42
  *
39
43
  * Better Auth encrypts every key in `pithy_auth_jwks` under the session secret, and a key never expires —
40
44
  * so retiring the version one is sealed under would leave a signing key nothing can open. The session
@@ -98,6 +102,19 @@ const MicrosoftOAuthCredentials = z.object({
98
102
  tenantId: z.string().min(1).meta({ multiline: false }).describe("Who may sign in: a directory (tenant) ID for one organization, `organizations` for any work or school account, `consumers` for personal accounts only, or `common` for both.")
99
103
  }).describe("A Microsoft Entra ID credential set (`clientId` + `clientSecret` + `tenantId`) for one environment.");
100
104
  /**
105
+ * The Google Cloud service account key Play Integrity tokens are decoded with: the JSON file Google Cloud
106
+ * Console downloads, pasted whole. Fields auth does not read are dropped on write.
107
+ */
108
+ const PlayIntegrityServiceAccount = z.object({
109
+ type: z.literal("service_account").optional().meta({ multiline: false }).describe("The key file's kind. Google writes `service_account`."),
110
+ project_id: z.string().optional().meta({ multiline: false }).describe("The Google Cloud project the service account belongs to, linked to the app in Play Console."),
111
+ private_key_id: z.string().optional().meta({ multiline: false }).describe("The key's id, sent as the assertion's `kid` so Google picks the right public key."),
112
+ private_key: z.string().min(1).meta({ multiline: true }).describe("The RSA private key, a PKCS#8 PEM. It spans many lines, so paste the whole JSON file."),
113
+ client_email: z.string().min(1).meta({ multiline: false }).describe("The service account's address, such as `play-integrity@my-project.iam.gserviceaccount.com`."),
114
+ client_id: z.string().optional().meta({ multiline: false }).describe("The service account's numeric id. Not read; kept so the stored value matches the file."),
115
+ token_uri: z.string().regex(/^https:\/\//, "The token endpoint is an https URL.").optional().meta({ multiline: false }).describe("Google's OAuth token endpoint. Defaults to `https://oauth2.googleapis.com/token`.")
116
+ }).describe("A Google Cloud service account JSON key, for decoding Play Integrity tokens in one environment.");
117
+ /**
101
118
  * Where a human goes for each OAuth credential pair, and where the same human rotates it.
102
119
  *
103
120
  * **The settings page, not the product homepage.** The point is to end a search, not to start one — and
@@ -110,6 +127,7 @@ const APPLE_KEYS_PAGE = "https://developer.apple.com/account/resources/authkeys/
110
127
  const FACEBOOK_APPS_PAGE = "https://developers.facebook.com/apps/";
111
128
  const GITHUB_OAUTH_APPS_PAGE = "https://github.com/settings/developers";
112
129
  const MICROSOFT_APP_REGISTRATIONS_PAGE = "https://entra.microsoft.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade";
130
+ const GOOGLE_SERVICE_ACCOUNTS_PAGE = "https://console.cloud.google.com/iam-admin/serviceaccounts";
113
131
  const authSecretsRegistry = defineSecretRegistry({
114
132
  [AUTH_SESSION_SECRET]: {
115
133
  backend: "d1",
@@ -216,10 +234,27 @@ const authSecretsRegistry = defineSecretRegistry({
216
234
  issuer: "microsoft",
217
235
  documentation: MICROSOFT_APP_REGISTRATIONS_PAGE
218
236
  }
237
+ },
238
+ [AUTH_PLAY_INTEGRITY_SERVICE_ACCOUNT]: {
239
+ backend: "d1",
240
+ scope: "environment",
241
+ rotatable: false,
242
+ valueType: "json",
243
+ schema: PlayIntegrityServiceAccount,
244
+ origin: {
245
+ kind: "obtained",
246
+ issuer: "google",
247
+ documentation: GOOGLE_SERVICE_ACCOUNTS_PAGE
248
+ },
249
+ rotation: {
250
+ kind: "manual",
251
+ issuer: "google",
252
+ documentation: GOOGLE_SERVICE_ACCOUNTS_PAGE
253
+ }
219
254
  }
220
255
  });
221
256
  /**
222
- * **The registry `auth()` contributes, from its own configuration (#602).**
257
+ * **The registry `auth()` contributes, from its own configuration.**
223
258
  *
224
259
  * The session secret's overlap follows the configured session lifetime — {@link sessionSecretOverlapDays} —
225
260
  * and it is both the overlap and its floor: an adopter who lengthens sessions lengthens the overlap with
@@ -257,7 +292,7 @@ function authSecretsRegistryFor(config) {
257
292
  });
258
293
  }
259
294
  /**
260
- * Which provider a credential belongs to — the join the CLI must never make by spelling (#541).
295
+ * Which provider a credential belongs to — the join the CLI must never make by spelling.
261
296
  *
262
297
  * `auth-apple-credentials` and the `apple` config key look like each other and that is a coincidence:
263
298
  * nothing makes a secret name and a config key the same thing, and a reporting command that matched
@@ -274,9 +309,9 @@ const PROVIDER_CREDENTIALS = [
274
309
  * **The provider credentials this composition cannot reach**, as the `inapplicableSecrets` contribution.
275
310
  *
276
311
  * Auth declares five credentials whether or not a project runs five providers, so a project on Google
277
- * and GitHub carries two secrets nothing will ever read. `pithy doctor` asked for them every run under
278
- * *"fine to leave until you need it"* — softening, not silence, and "until you need it" is wrong about a
279
- * provider the configuration has not enabled.
312
+ * and GitHub carries two secrets nothing will ever read. A disabled provider's credential is listed as not
313
+ * applicable rather than as outstanding work: "set it until you need it" is wrong about a provider the
314
+ * configuration has not enabled.
280
315
  *
281
316
  * **The session secret is never in here**, and that is the line this draws: it is read on every sign-in
282
317
  * whatever the providers are, so it is outstanding work in every project that has not set it.
@@ -297,7 +332,7 @@ async function resolveSessionSecret(env) {
297
332
  return (await sharedSecretsStore(env, authSecretsRegistry)).get(AUTH_SESSION_SECRET);
298
333
  }
299
334
  /**
300
- * Resolve every retained version of the session secret (#602) — what an instance needs to open values sealed
335
+ * Resolve every retained version of the session secret: what an instance needs to open values sealed
301
336
  * under the previous version, and what a credential signed under it is verified against. One read through
302
337
  * the same cached accessor as {@link resolveSessionSecret}.
303
338
  */
@@ -320,9 +355,20 @@ async function resolveFacebookCredentials(env) {
320
355
  async function resolveGithubCredentials(env) {
321
356
  return (await sharedSecretsStore(env, authSecretsRegistry)).get(AUTH_GITHUB_CREDENTIALS);
322
357
  }
358
+ /**
359
+ * The Play Integrity service account when no environment of this composition allows an Android app: nothing
360
+ * there reads it.
361
+ */
362
+ function inapplicablePlayIntegritySecret(attestation) {
363
+ return Object.values(attestation.environments).some((block) => block.android.length > 0) ? {} : { [AUTH_PLAY_INTEGRITY_SERVICE_ACCOUNT]: "auth() allows no Android app to attest in any environment" };
364
+ }
365
+ /** Resolve the Play Integrity service account for this invocation (only call for an Android attestation). */
366
+ async function resolvePlayIntegrityServiceAccount(env) {
367
+ return (await sharedSecretsStore(env, authSecretsRegistry)).get(AUTH_PLAY_INTEGRITY_SERVICE_ACCOUNT);
368
+ }
323
369
  /** Resolve the Microsoft Entra ID credentials for this invocation (only call when Microsoft is enabled). */
324
370
  async function resolveMicrosoftCredentials(env) {
325
371
  return (await sharedSecretsStore(env, authSecretsRegistry)).get(AUTH_MICROSOFT_CREDENTIALS);
326
372
  }
327
373
  //#endregion
328
- export { AUTH_APPLE_CREDENTIALS, AUTH_FACEBOOK_CREDENTIALS, AUTH_GITHUB_CREDENTIALS, AUTH_GOOGLE_CREDENTIALS, AUTH_JWKS_DEPENDENT, AUTH_MICROSOFT_CREDENTIALS, AUTH_SESSION_SECRET, AppleOAuthCredentials, FacebookOAuthCredentials, GithubOAuthCredentials, GoogleOAuthCredentials, MicrosoftOAuthCredentials, SESSION_SECRET_SEALING_PLUGINS, authSecretsRegistry, authSecretsRegistryFor, inapplicableProviderSecrets, resolveAppleCredentials, resolveFacebookCredentials, resolveGithubCredentials, resolveGoogleCredentials, resolveMicrosoftCredentials, resolveSessionSecret, resolveSessionSecrets, sessionSecretOverlapDays };
374
+ export { AUTH_APPLE_CREDENTIALS, AUTH_FACEBOOK_CREDENTIALS, AUTH_GITHUB_CREDENTIALS, AUTH_GOOGLE_CREDENTIALS, AUTH_JWKS_DEPENDENT, AUTH_MICROSOFT_CREDENTIALS, AUTH_PLAY_INTEGRITY_SERVICE_ACCOUNT, AUTH_SESSION_SECRET, AppleOAuthCredentials, FacebookOAuthCredentials, GithubOAuthCredentials, GoogleOAuthCredentials, MicrosoftOAuthCredentials, PlayIntegrityServiceAccount, SESSION_SECRET_SEALING_PLUGINS, authSecretsRegistry, authSecretsRegistryFor, inapplicablePlayIntegritySecret, inapplicableProviderSecrets, resolveAppleCredentials, resolveFacebookCredentials, resolveGithubCredentials, resolveGoogleCredentials, resolveMicrosoftCredentials, resolvePlayIntegrityServiceAccount, resolveSessionSecret, resolveSessionSecrets, sessionSecretOverlapDays };
@@ -1 +1 @@
1
- {"version":3,"file":"erasure.d.ts","sourceRoot":"","sources":["../../src/lifecycle/erasure.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAqB,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAGrH,OAAO,EAAE,KAAK,YAAY,EAAgB,MAAM,gBAAgB,CAAC;AAqBjE,0CAA0C;AAC1C,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,YAAY,GAAG,oBAAoB,CAsExE;AAED,+GAA+G;AAC/G,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAgBnE"}
1
+ {"version":3,"file":"erasure.d.ts","sourceRoot":"","sources":["../../src/lifecycle/erasure.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAqB,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAGrH,OAAO,EAAE,KAAK,YAAY,EAAgB,MAAM,gBAAgB,CAAC;AAqBjE,0CAA0C;AAC1C,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,YAAY,GAAG,oBAAoB,CAuExE;AAED,+GAA+G;AAC/G,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAgBnE"}
@@ -7,7 +7,7 @@ import { resolveDb } from "../http/resolve.js";
7
7
  import { SQLiteDate } from "@pithy-sh/core/src/data/codecs";
8
8
  //#region src/lifecycle/erasure.ts
9
9
  /**
10
- * **A user's erasure record, read back for the control plane's attestation (#823).**
10
+ * **A user's erasure record, read back for the control plane's attestation.**
11
11
  *
12
12
  * `pithy_auth_user_lifecycle` is the one `pithy_auth_*` table a purge leaves behind, and it names the account by id
13
13
  * and nothing else. This reads the rows an erasure is made of — the deletion, any restore, each step, a failure, the
@@ -44,6 +44,7 @@ function userErasureReader(db) {
44
44
  actorType: row.actorType,
45
45
  reason: row.reason,
46
46
  step: row.step,
47
+ basisKey: row.basisKey,
47
48
  mode: row.mode,
48
49
  purgeAfter: row.purgeAfter,
49
50
  at: row.createdAt
@@ -2,8 +2,9 @@
2
2
  // SPDX-License-Identifier: MIT
3
3
  import type { D1Database } from "@cloudflare/workers-types";
4
4
  import type { UserLifecycleActorType } from "../data/userLifecycle";
5
+ import type { HookRuntime } from "../hooks/runtime";
5
6
  /**
6
- * The four seams an adopter's own code follows the account lifecycle through, without polling (#620).
7
+ * The five seams an adopter's own code follows the account lifecycle through, without polling.
7
8
  *
8
9
  * **On the transition, not on a route.** An account is suspended from the management surface today and may be
9
10
  * from somewhere else tomorrow; a listener hung off one route would miss the others, which is the argument
@@ -35,19 +36,26 @@ export interface UserLifecycleHookEvent {
35
36
  readonly purgeAfter?: Date | null;
36
37
  }
37
38
  /**
38
- * One hook. Handed the request's D1 binding, for the reason `SessionRevokedListener` is: the listener almost
39
- * certainly writes to the same database under a different capability's view of it.
39
+ * One hook. Handed the run's D1 binding, for the reason `SessionRevokedListener` is: the listener almost certainly
40
+ * writes to the same database under a different capability's view of it. And handed the Worker it runs in, so it
41
+ * can reach a secret or another binding — start a Workflow, send to a queue, call out. `runtime.waitUntil` is there
42
+ * in a request and absent in the purge Workflow. A hook that takes only `(event, d1)` is still one.
40
43
  */
41
- export type UserLifecycleListener = (event: UserLifecycleHookEvent, d1: D1Database) => void | Promise<void>;
42
- /** The four hooks, each optional. Passed to `auth()` beside the config. */
43
- export interface UserLifecycleHooks {
44
+ export type UserLifecycleListener<Env = Record<string, unknown>> = (event: UserLifecycleHookEvent, d1: D1Database, runtime: HookRuntime<Env>) => void | Promise<void>;
45
+ /** The five hooks, each optional. Passed to `auth()` beside the config; `Env` is the adopter's Worker env. */
46
+ export interface UserLifecycleHooks<Env = Record<string, unknown>> {
44
47
  /** An account was suspended. */
45
- readonly onUserSuspended?: UserLifecycleListener;
48
+ readonly onUserSuspended?: UserLifecycleListener<Env>;
46
49
  /** A suspended account was reinstated. */
47
- readonly onUserReinstated?: UserLifecycleListener;
50
+ readonly onUserReinstated?: UserLifecycleListener<Env>;
48
51
  /** An account was deleted — by an operator or by its owner — and its purge window began. */
49
- readonly onUserDeleted?: UserLifecycleListener;
52
+ readonly onUserDeleted?: UserLifecycleListener<Env>;
53
+ /**
54
+ * A deleted account was restored inside its purge window. The undo for whatever `onUserDeleted` did: the account
55
+ * is back, and a suspension it was under is still in force.
56
+ */
57
+ readonly onUserRestored?: UserLifecycleListener<Env>;
50
58
  /** A deleted account's data was erased. The last thing that happens to it. */
51
- readonly onUserPurged?: UserLifecycleListener;
59
+ readonly onUserPurged?: UserLifecycleListener<Env>;
52
60
  }
53
61
  //# sourceMappingURL=hooks.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/lifecycle/hooks.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAEpE;;;;;;;;;;;;;GAaG;AAEH,2CAA2C;AAC3C,MAAM,WAAW,sBAAsB;IACrC,kCAAkC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,oFAAoF;IACpF,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;QAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACtF,iEAAiE;IACjE,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,uCAAuC;IACvC,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,+FAA+F;IAC/F,QAAQ,CAAC,cAAc,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACtC,6DAA6D;IAC7D,QAAQ,CAAC,UAAU,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CACnC;AAED;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,sBAAsB,EAAE,EAAE,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE5G,2EAA2E;AAC3E,MAAM,WAAW,kBAAkB;IACjC,gCAAgC;IAChC,QAAQ,CAAC,eAAe,CAAC,EAAE,qBAAqB,CAAC;IACjD,0CAA0C;IAC1C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,qBAAqB,CAAC;IAClD,4FAA4F;IAC5F,QAAQ,CAAC,aAAa,CAAC,EAAE,qBAAqB,CAAC;IAC/C,8EAA8E;IAC9E,QAAQ,CAAC,YAAY,CAAC,EAAE,qBAAqB,CAAC;CAC/C"}
1
+ {"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/lifecycle/hooks.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;;;;;;;;;;;;GAaG;AAEH,2CAA2C;AAC3C,MAAM,WAAW,sBAAsB;IACrC,kCAAkC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,oFAAoF;IACpF,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;QAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACtF,iEAAiE;IACjE,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,uCAAuC;IACvC,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,+FAA+F;IAC/F,QAAQ,CAAC,cAAc,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACtC,6DAA6D;IAC7D,QAAQ,CAAC,UAAU,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CACnC;AAED;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,CAAC,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CACjE,KAAK,EAAE,sBAAsB,EAC7B,EAAE,EAAE,UAAU,EACd,OAAO,EAAE,WAAW,CAAC,GAAG,CAAC,KACtB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B,8GAA8G;AAC9G,MAAM,WAAW,kBAAkB,CAAC,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC/D,gCAAgC;IAChC,QAAQ,CAAC,eAAe,CAAC,EAAE,qBAAqB,CAAC,GAAG,CAAC,CAAC;IACtD,0CAA0C;IAC1C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,qBAAqB,CAAC,GAAG,CAAC,CAAC;IACvD,4FAA4F;IAC5F,QAAQ,CAAC,aAAa,CAAC,EAAE,qBAAqB,CAAC,GAAG,CAAC,CAAC;IACpD;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,qBAAqB,CAAC,GAAG,CAAC,CAAC;IACrD,8EAA8E;IAC9E,QAAQ,CAAC,YAAY,CAAC,EAAE,qBAAqB,CAAC,GAAG,CAAC,CAAC;CACpD"}
@@ -9,7 +9,8 @@ import type { LifecycleAuditContext, LifecycleDeps } from "./transitions";
9
9
  *
10
10
  * One function so every route resolves them the same way: this request's database, its audit seam and logger,
11
11
  * the composed email capability's enqueue bound to this request's env, and the adopter's hooks as `auth()` was
12
- * handed them. A route that assembled its own would be the second place a hook could be forgotten.
12
+ * handed them, with this request's env and `waitUntil` to run in. A route that assembled its own would be the second
13
+ * place a hook could be forgotten.
13
14
  *
14
15
  * `context` is what the caller adds to each audit event: the request's correlation, and for a management call
15
16
  * the connection it came through. The caller passes it because only the caller knows who it is.
@@ -1 +1 @@
1
- {"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/lifecycle/request.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0CAA0C,CAAC;AAE7E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD,OAAO,KAAK,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE1E;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,EACxB,MAAM,EAAE,UAAU,EAClB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,aAAa,CAaf"}
1
+ {"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/lifecycle/request.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0CAA0C,CAAC;AAE7E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAIhD,OAAO,KAAK,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE1E;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,EACxB,MAAM,EAAE,UAAU,EAClB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,aAAa,CAcf"}
@@ -1,6 +1,7 @@
1
1
  // SPDX-FileCopyrightText: 2026 Pithy
2
2
  // SPDX-License-Identifier: MIT
3
3
  import { authDatabase } from "../data/tables.js";
4
+ import { requestRuntime } from "../hooks/runtime.js";
4
5
  import { resolveDb } from "../http/resolve.js";
5
6
  //#region src/lifecycle/request.ts
6
7
  /**
@@ -8,7 +9,8 @@ import { resolveDb } from "../http/resolve.js";
8
9
  *
9
10
  * One function so every route resolves them the same way: this request's database, its audit seam and logger,
10
11
  * the composed email capability's enqueue bound to this request's env, and the adopter's hooks as `auth()` was
11
- * handed them. A route that assembled its own would be the second place a hook could be forgotten.
12
+ * handed them, with this request's env and `waitUntil` to run in. A route that assembled its own would be the second
13
+ * place a hook could be forgotten.
12
14
  *
13
15
  * `context` is what the caller adds to each audit event: the request's correlation, and for a management call
14
16
  * the connection it came through. The caller passes it because only the caller knows who it is.
@@ -22,6 +24,7 @@ function lifecycleDeps(c, wiring, context) {
22
24
  emit: c.var.emit,
23
25
  config: wiring.config,
24
26
  hooks: wiring.lifecycleHooks ?? {},
27
+ runtime: requestRuntime(c),
25
28
  enqueueEmail: enqueue ? (input) => enqueue(c.env, input) : void 0,
26
29
  log: c.var.log?.child("auth"),
27
30
  ...context ? { context } : {}
@@ -7,11 +7,12 @@ import type { EnqueueInput } from "@pithy-sh/email/src/send/enqueue";
7
7
  import type { AuthConfig } from "../capability";
8
8
  import type { AuthDatabase } from "../data/tables";
9
9
  import type { UserLifecycleActorType } from "../data/userLifecycle";
10
+ import type { HookRuntime } from "../hooks/runtime";
10
11
  import type { UserLifecycleHooks } from "./hooks";
11
12
  /**
12
- * The account-lifecycle transitions — the one place an account's state is ever changed (#620).
13
+ * The account-lifecycle transitions — the one place an account's state is ever changed.
13
14
  *
14
- * The admin routes (#621, #622), the self-service deletion, and the purge Workflow call these and write
15
+ * The admin routes, the self-service deletion, and the purge Workflow call these and write
15
16
  * nothing themselves, so each transition happens the same way whoever asked for it:
16
17
  *
17
18
  * 1. **The columns move, conditionally, and the history row is written with them.** The `update` names the
@@ -52,6 +53,8 @@ export interface LifecycleDeps {
52
53
  readonly config: Pick<AuthConfig, "retention" | "lifecycleEmails">;
53
54
  /** The adopter's hooks. */
54
55
  readonly hooks: UserLifecycleHooks;
56
+ /** The Worker the hooks run in: this run's env, and `waitUntil` inside a request. */
57
+ readonly runtime: HookRuntime;
55
58
  /** The email capability's enqueue, bound to this run's env. Absent, nothing is mailed. */
56
59
  readonly enqueueEmail?: ((input: EnqueueInput) => Promise<unknown>) | undefined;
57
60
  /** Where a swallowed failure is reported. Absent, it is swallowed silently. */
@@ -85,7 +88,7 @@ export interface LifecycleTransition {
85
88
  /** What a suspension did, and the suspension it left in force. */
86
89
  export interface SuspendTransition extends LifecycleTransition {
87
90
  /**
88
- * True when the account was already suspended and this call restated the reason and the end instead (#621).
91
+ * True when the account was already suspended and this call restated the reason and the end instead.
89
92
  * That is not a transition — `changed` is false and no hook fires — but it is written, audited and mailed.
90
93
  */
91
94
  readonly updated: boolean;
@@ -101,7 +104,7 @@ export interface SuspendTransition extends LifecycleTransition {
101
104
  * conflict rather than a no-op, and names `restoreRoute` when the caller gives one. A suspension whose end has
102
105
  * passed is not in force, and a new one replaces it.
103
106
  *
104
- * **An account already suspended has its terms restated (#621).** The reason and the end are replaced, a
107
+ * **An account already suspended has its terms restated.** The reason and the end are replaced, a
105
108
  * `suspended` row records the new reason — the newest one is what the person is shown — and the audit event
106
109
  * and the mail say so. The start is kept, and no hook fires: the account was suspended and still is, so
107
110
  * nothing transitioned. A fresh suspension that loses the race to another suspension finds the account
@@ -163,7 +166,7 @@ export interface DeleteTransition extends LifecycleTransition {
163
166
  * Restorable until then. The deletion-scheduled mail carries the purge date and, when the config names one,
164
167
  * the restore path. A deleted account deleted softly again is no transition.
165
168
  *
166
- * **Hard** (#622): `purgeAfter` is now, so the window is already closed — nothing can restore it — and the
169
+ * **Hard**: `purgeAfter` is now, so the window is already closed — nothing can restore it — and the
167
170
  * caller starts the purge. No deletion-scheduled mail, because nothing is scheduled; the purge sends the
168
171
  * deletion-complete one. An account already deleted softly has its purge brought forward to now, which is
169
172
  * written and audited but fires no hook: the account was deleted and still is. One already due is unchanged.
@@ -192,7 +195,8 @@ export interface RestoreTransition extends LifecycleTransition {
192
195
  * 404 whose action says the data is gone — read off the history row the purge leaves behind, so it is told
193
196
  * apart from an id that never existed.
194
197
  *
195
- * An account that is not deleted is no transition. A suspension it was under is still in force after.
198
+ * An account that is not deleted is no transition, and fires nothing. A suspension it was under is still in force
199
+ * after. `onUserRestored` fires once the restore is written, so an adopter can undo what it did on `onUserDeleted`.
196
200
  */
197
201
  export declare function restoreUser(deps: LifecycleDeps, input: {
198
202
  userId: string;
@@ -200,11 +204,13 @@ export declare function restoreUser(deps: LifecycleDeps, input: {
200
204
  reason: string | null;
201
205
  }): Promise<RestoreTransition>;
202
206
  /**
203
- * The account's row, or the refusal for one that is not there — the 404 that says the data is gone when the
204
- * purge erased it, and the plain one otherwise. For a route that reads an account outside a transition: the
205
- * export.
207
+ * The account's stored locale, or the refusal for an account that is not there — the 404 that says the data is gone
208
+ * when the purge erased it, and the plain one otherwise. For a route that reads an account outside a transition: the
209
+ * export, which answers in the person's own language.
206
210
  */
207
- export declare function requirePresent(db: AuthDatabase, userId: string): Promise<void>;
211
+ export declare function requirePresent(db: AuthDatabase, userId: string): Promise<{
212
+ locale: string | null;
213
+ }>;
208
214
  /** Who the purge's last mail goes to, captured before any step erases the address. */
209
215
  export interface PurgeRecipient {
210
216
  readonly email: string;
@@ -212,7 +218,7 @@ export interface PurgeRecipient {
212
218
  readonly locale: string | null;
213
219
  }
214
220
  /**
215
- * Whether one account is due for its purge, who its last mail goes to, and whether it goes (#622).
221
+ * Whether one account is due for its purge, who its last mail goes to, and whether it goes.
216
222
  *
217
223
  * `due` only for an account that is deleted and whose `purgeAfter` has passed — the cron and a hard deletion
218
224
  * both start a purge, and this is the one check either passes through, so an account restored in between is
@@ -233,7 +239,7 @@ export declare function purgeSubject(deps: LifecycleDeps, userId: string): Promi
233
239
  state: "gone";
234
240
  }>;
235
241
  /**
236
- * The account's address, as a purge step reads it (#814) — `null` when there is no account, or no address. Read
242
+ * The account's address, as a purge step reads it — `null` when there is no account, or no address. Read
237
243
  * inside the step that asks, so it is never carried in a Workflow's journal.
238
244
  */
239
245
  export declare function purgeAddress(db: AuthDatabase, userId: string): Promise<string | null>;
@@ -243,7 +249,7 @@ export interface DuePurge {
243
249
  readonly deletedAt: number;
244
250
  }
245
251
  /**
246
- * The accounts whose purge is due — deleted, with `purgeAfter` passed — oldest first, at most `limit` (#622).
252
+ * The accounts whose purge is due — deleted, with `purgeAfter` passed — oldest first, at most `limit`.
247
253
  * What the daily cron starts a purge for. An account still inside its window is not here, and neither is one
248
254
  * that was restored. Each carries its deletion's start, which names the purge's instance (`../purge/start.ts`).
249
255
  */
@@ -251,16 +257,18 @@ export declare function duePurges(deps: LifecycleDeps, limit: number): Promise<D
251
257
  /**
252
258
  * Record that one purge step — one capability's contribution — erased its rows. The contribution's summary is
253
259
  * the row's reason, so the history says what the step erased and not only that it ran. With `retained`, the step
254
- * kept its rows instead (#814): the row is `purge_retained`, and its reason is the basis the capability gave.
260
+ * kept its rows instead: the row is `purge_retained`, its reason is the basis the capability gave, and its
261
+ * `basisKey` the catalog key that translates it, when the capability names one.
255
262
  */
256
263
  export declare function recordPurgeStep(deps: LifecycleDeps, input: {
257
264
  userId: string;
258
265
  step: string;
259
266
  summary?: string | null;
260
267
  retained?: boolean;
268
+ basisKey?: string;
261
269
  }): Promise<void>;
262
270
  /**
263
- * Record that a purge gave up (#823): the step it stopped at, in the history and in the trail. The daily pass starts
271
+ * Record that a purge gave up: the step it stopped at, in the history and in the trail. The daily pass starts
264
272
  * the purge again tomorrow, so this is where it stands until then, not an end. The failure's message is never
265
273
  * written: it is code the kit did not write, and it may name the person.
266
274
  */
@@ -269,7 +277,7 @@ export declare function recordPurgeFailure(deps: LifecycleDeps, input: {
269
277
  step: string;
270
278
  }): Promise<void>;
271
279
  /**
272
- * The deletion-complete mail, sent **before the address is erased** (#622). The purge calls this after every
280
+ * The deletion-complete mail, sent **before the address is erased**. The purge calls this after every
273
281
  * other capability's rows are gone and before auth's own, which holds the address, so the last mail is
274
282
  * enqueued while there is still an account to have sent it to. The address is handed in, captured before the
275
283
  * first step. `notify: false` sends nothing, whatever the config says.
@@ -1 +1 @@
1
- {"version":3,"file":"transitions.d.ts","sourceRoot":"","sources":["../../src/lifecycle/transitions.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"transitions.d.ts","sourceRoot":"","sources":["../../src/lifecycle/transitions.ts"],"names":[],"mappings":"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"}