@kayjs/auth 0.0.0-stage → 1.104.1

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 (407) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +78 -2
  3. package/llms/admin-and-organizations.md +70 -0
  4. package/llms/admin-pages.md +30 -0
  5. package/llms/grouped-methods.md +106 -0
  6. package/llms/hardening-and-testing.md +108 -0
  7. package/llms/oauth-passkeys-two-factor.md +111 -0
  8. package/llms/oauth-providers.md +28 -0
  9. package/llms/oauth-server-and-tokens.md +76 -0
  10. package/llms/organization-pages.md +20 -0
  11. package/llms/passwords-and-mails.md +129 -0
  12. package/llms/sessions-and-guards.md +51 -0
  13. package/llms/setup.md +122 -0
  14. package/llms/signed-in-components.md +59 -0
  15. package/llms.txt +28 -0
  16. package/package.json +85 -4
  17. package/src/access.ts +31 -0
  18. package/src/account.ts +198 -0
  19. package/src/add.ts +70 -0
  20. package/src/address.ts +51 -0
  21. package/src/admin.ts +361 -0
  22. package/src/auditWording.ts +153 -0
  23. package/src/auth.ts +219 -0
  24. package/src/authorize/clients.ts +160 -0
  25. package/src/authorize/grants.ts +44 -0
  26. package/src/authorize/metadata.ts +72 -0
  27. package/src/authorize/register.ts +38 -0
  28. package/src/authorize/reply.ts +9 -0
  29. package/src/authorize/request.ts +253 -0
  30. package/src/authorize/resource.ts +34 -0
  31. package/src/authorize/revoke.ts +36 -0
  32. package/src/authorize/routes.ts +87 -0
  33. package/src/authorize/token.ts +213 -0
  34. package/src/authorize/uris.ts +76 -0
  35. package/src/bearer.ts +208 -0
  36. package/src/bearerHeader.ts +11 -0
  37. package/src/breached.ts +47 -0
  38. package/src/browser.ts +59 -0
  39. package/src/captcha.ts +196 -0
  40. package/src/cbor.ts +129 -0
  41. package/src/components/deletion-banner.kay +20 -0
  42. package/src/components/impersonation-banner.kay +21 -0
  43. package/src/components/signed-in.kay +8 -0
  44. package/src/components/signed-out.kay +6 -0
  45. package/src/components/user-menu.kay +21 -0
  46. package/src/context.ts +5 -0
  47. package/src/core.ts +308 -0
  48. package/src/createUserCommand.ts +217 -0
  49. package/src/decide.ts +45 -0
  50. package/src/deletion.ts +80 -0
  51. package/src/devTool.ts +104 -0
  52. package/src/device.ts +37 -0
  53. package/src/email.ts +594 -0
  54. package/src/erase.ts +237 -0
  55. package/src/events.ts +297 -0
  56. package/src/export.ts +101 -0
  57. package/src/failure.ts +63 -0
  58. package/src/forwardAuth.ts +55 -0
  59. package/src/forwardRoutes.ts +68 -0
  60. package/src/gate.ts +104 -0
  61. package/src/guard.ts +22 -0
  62. package/src/guards.ts +72 -0
  63. package/src/guesses.ts +99 -0
  64. package/src/index.ts +46 -0
  65. package/src/keys.ts +51 -0
  66. package/src/limits.ts +182 -0
  67. package/src/load.ts +18 -0
  68. package/src/locale.ts +15 -0
  69. package/src/log.ts +4 -0
  70. package/src/mail.ts +225 -0
  71. package/src/memoryStore.ts +599 -0
  72. package/src/messages/fr.ts +357 -0
  73. package/src/methods/account.ts +80 -0
  74. package/src/methods/admin.ts +63 -0
  75. package/src/methods/audit.ts +15 -0
  76. package/src/methods/email.ts +39 -0
  77. package/src/methods/magicLink.ts +32 -0
  78. package/src/methods/oauth.ts +35 -0
  79. package/src/methods/oauthServer.ts +31 -0
  80. package/src/methods/organizations.ts +96 -0
  81. package/src/methods/passkeys.ts +61 -0
  82. package/src/methods/password.ts +53 -0
  83. package/src/methods/sessions.ts +18 -0
  84. package/src/methods/tokens.ts +24 -0
  85. package/src/methods/twoFactor.ts +62 -0
  86. package/src/oauth/client.ts +324 -0
  87. package/src/oauth/flow.ts +350 -0
  88. package/src/oauth/index.ts +5 -0
  89. package/src/oauth/pkce.ts +20 -0
  90. package/src/oauth/providers.ts +490 -0
  91. package/src/oauth/refresher.ts +177 -0
  92. package/src/oauth/timeout.ts +2 -0
  93. package/src/oauth/types.ts +78 -0
  94. package/src/oauthTest.ts +112 -0
  95. package/src/organizations.ts +675 -0
  96. package/src/organizationsCore.ts +60 -0
  97. package/src/own.ts +313 -0
  98. package/src/pages/components/captcha.kay +16 -0
  99. package/src/pages/components/frame.kay +11 -0
  100. package/src/pages/components/message.kay +8 -0
  101. package/src/pages/components/panel.kay +12 -0
  102. package/src/pages/components/passkey-add.kay +48 -0
  103. package/src/pages/components/passkey-sign-in.kay +34 -0
  104. package/src/pages/components/passkey-two-factor.kay +33 -0
  105. package/src/pages/components/proof.kay +15 -0
  106. package/src/pages/components/provider-buttons.kay +25 -0
  107. package/src/pages/components/recovery-codes.kay +13 -0
  108. package/src/pages/components/separator.kay +4 -0
  109. package/src/pages/english.ts +82 -0
  110. package/src/pages/forms.ts +185 -0
  111. package/src/pages/index.ts +361 -0
  112. package/src/pages/organizationPage.ts +12 -0
  113. package/src/pages/routes/account/_guard.ts +15 -0
  114. package/src/pages/routes/account/_layout.kay +37 -0
  115. package/src/pages/routes/account/clients.kay +33 -0
  116. package/src/pages/routes/account/connections.kay +57 -0
  117. package/src/pages/routes/account/data.kay +106 -0
  118. package/src/pages/routes/account/index.kay +109 -0
  119. package/src/pages/routes/account/organizations/[org].kay +188 -0
  120. package/src/pages/routes/account/organizations/_guard.ts +8 -0
  121. package/src/pages/routes/account/organizations/index.kay +86 -0
  122. package/src/pages/routes/account/security.kay +164 -0
  123. package/src/pages/routes/account/sessions.kay +51 -0
  124. package/src/pages/routes/account/tokens.kay +84 -0
  125. package/src/pages/routes/admin/_layout.kay +43 -0
  126. package/src/pages/routes/admin/audit.kay +43 -0
  127. package/src/pages/routes/admin/index.kay +60 -0
  128. package/src/pages/routes/admin/users/[id].kay +181 -0
  129. package/src/pages/routes/confirm-email.kay +39 -0
  130. package/src/pages/routes/invitation.kay +104 -0
  131. package/src/pages/routes/magic-link.kay +42 -0
  132. package/src/pages/routes/oauth/authorize.kay +80 -0
  133. package/src/pages/routes/register.kay +83 -0
  134. package/src/pages/routes/reset-password.kay +73 -0
  135. package/src/pages/routes/sign-in.kay +128 -0
  136. package/src/pages/routes/two-factor.kay +61 -0
  137. package/src/pages/routes/verify-email.kay +83 -0
  138. package/src/passkeys.ts +373 -0
  139. package/src/password.ts +316 -0
  140. package/src/payloads.ts +22 -0
  141. package/src/pg.ts +705 -0
  142. package/src/profile.ts +43 -0
  143. package/src/proof.ts +110 -0
  144. package/src/prune.ts +123 -0
  145. package/src/rates.ts +82 -0
  146. package/src/request.ts +712 -0
  147. package/src/requiredTwoFactor.ts +71 -0
  148. package/src/requirement.ts +23 -0
  149. package/src/roles.ts +18 -0
  150. package/src/routes.ts +202 -0
  151. package/src/rules-check.ts +37 -0
  152. package/src/rules.ts +108 -0
  153. package/src/securityNotice.ts +45 -0
  154. package/src/sessions.ts +184 -0
  155. package/src/setup.ts +417 -0
  156. package/src/signInOptions.ts +9 -0
  157. package/src/state.ts +34 -0
  158. package/src/store.ts +410 -0
  159. package/src/storeHelpers.ts +23 -0
  160. package/src/test.ts +46 -0
  161. package/src/testCookies.ts +9 -0
  162. package/src/testHelpers.ts +58 -0
  163. package/src/testing.ts +113 -0
  164. package/src/text.ts +6 -0
  165. package/src/totp.ts +120 -0
  166. package/src/twoFactor.ts +200 -0
  167. package/src/types.ts +23 -0
  168. package/src/userData.ts +47 -0
  169. package/src/viewer-layout/_layout.kay +11 -0
  170. package/src/viewer.ts +116 -0
  171. package/src/wayIn.ts +40 -0
  172. package/src/webauthn.ts +375 -0
  173. package/src/wsAuth.ts +53 -0
  174. package/types/access.d.ts +12 -0
  175. package/types/access.d.ts.map +1 -0
  176. package/types/account.d.ts +32 -0
  177. package/types/account.d.ts.map +1 -0
  178. package/types/add.d.ts +29 -0
  179. package/types/add.d.ts.map +1 -0
  180. package/types/address.d.ts +2 -0
  181. package/types/address.d.ts.map +1 -0
  182. package/types/admin.d.ts +84 -0
  183. package/types/admin.d.ts.map +1 -0
  184. package/types/auditWording.d.ts +9 -0
  185. package/types/auditWording.d.ts.map +1 -0
  186. package/types/auth.d.ts +3475 -0
  187. package/types/auth.d.ts.map +1 -0
  188. package/types/authorize/clients.d.ts +15 -0
  189. package/types/authorize/clients.d.ts.map +1 -0
  190. package/types/authorize/grants.d.ts +15 -0
  191. package/types/authorize/grants.d.ts.map +1 -0
  192. package/types/authorize/metadata.d.ts +20 -0
  193. package/types/authorize/metadata.d.ts.map +1 -0
  194. package/types/authorize/register.d.ts +4 -0
  195. package/types/authorize/register.d.ts.map +1 -0
  196. package/types/authorize/reply.d.ts +6 -0
  197. package/types/authorize/reply.d.ts.map +1 -0
  198. package/types/authorize/request.d.ts +48 -0
  199. package/types/authorize/request.d.ts.map +1 -0
  200. package/types/authorize/resource.d.ts +4 -0
  201. package/types/authorize/resource.d.ts.map +1 -0
  202. package/types/authorize/revoke.d.ts +4 -0
  203. package/types/authorize/revoke.d.ts.map +1 -0
  204. package/types/authorize/routes.d.ts +5 -0
  205. package/types/authorize/routes.d.ts.map +1 -0
  206. package/types/authorize/token.d.ts +7 -0
  207. package/types/authorize/token.d.ts.map +1 -0
  208. package/types/authorize/uris.d.ts +5 -0
  209. package/types/authorize/uris.d.ts.map +1 -0
  210. package/types/bearer.d.ts +45 -0
  211. package/types/bearer.d.ts.map +1 -0
  212. package/types/bearerHeader.d.ts +3 -0
  213. package/types/bearerHeader.d.ts.map +1 -0
  214. package/types/breached.d.ts +5 -0
  215. package/types/breached.d.ts.map +1 -0
  216. package/types/browser.d.ts +11 -0
  217. package/types/browser.d.ts.map +1 -0
  218. package/types/captcha.d.ts +42 -0
  219. package/types/captcha.d.ts.map +1 -0
  220. package/types/cbor.d.ts +4 -0
  221. package/types/cbor.d.ts.map +1 -0
  222. package/types/context.d.ts +3 -0
  223. package/types/context.d.ts.map +1 -0
  224. package/types/core.d.ts +180 -0
  225. package/types/core.d.ts.map +1 -0
  226. package/types/createUserCommand.d.ts +11 -0
  227. package/types/createUserCommand.d.ts.map +1 -0
  228. package/types/decide.d.ts +12 -0
  229. package/types/decide.d.ts.map +1 -0
  230. package/types/deletion.d.ts +17 -0
  231. package/types/deletion.d.ts.map +1 -0
  232. package/types/devTool.d.ts +3 -0
  233. package/types/devTool.d.ts.map +1 -0
  234. package/types/device.d.ts +7 -0
  235. package/types/device.d.ts.map +1 -0
  236. package/types/email.d.ts +73 -0
  237. package/types/email.d.ts.map +1 -0
  238. package/types/erase.d.ts +31 -0
  239. package/types/erase.d.ts.map +1 -0
  240. package/types/events.d.ts +139 -0
  241. package/types/events.d.ts.map +1 -0
  242. package/types/export.d.ts +54 -0
  243. package/types/export.d.ts.map +1 -0
  244. package/types/failure.d.ts +19 -0
  245. package/types/failure.d.ts.map +1 -0
  246. package/types/forwardAuth.d.ts +12 -0
  247. package/types/forwardAuth.d.ts.map +1 -0
  248. package/types/forwardRoutes.d.ts +11 -0
  249. package/types/forwardRoutes.d.ts.map +1 -0
  250. package/types/gate.d.ts +31 -0
  251. package/types/gate.d.ts.map +1 -0
  252. package/types/guard.d.ts +10 -0
  253. package/types/guard.d.ts.map +1 -0
  254. package/types/guards.d.ts +37 -0
  255. package/types/guards.d.ts.map +1 -0
  256. package/types/guesses.d.ts +18 -0
  257. package/types/guesses.d.ts.map +1 -0
  258. package/types/index.d.ts +47 -0
  259. package/types/index.d.ts.map +1 -0
  260. package/types/keys.d.ts +11 -0
  261. package/types/keys.d.ts.map +1 -0
  262. package/types/limits.d.ts +133 -0
  263. package/types/limits.d.ts.map +1 -0
  264. package/types/load.d.ts +18 -0
  265. package/types/load.d.ts.map +1 -0
  266. package/types/locale.d.ts +4 -0
  267. package/types/locale.d.ts.map +1 -0
  268. package/types/log.d.ts +2 -0
  269. package/types/log.d.ts.map +1 -0
  270. package/types/mail.d.ts +51 -0
  271. package/types/mail.d.ts.map +1 -0
  272. package/types/memoryStore.d.ts +3 -0
  273. package/types/memoryStore.d.ts.map +1 -0
  274. package/types/messages/fr.d.ts +409 -0
  275. package/types/messages/fr.d.ts.map +1 -0
  276. package/types/methods/account.d.ts +24 -0
  277. package/types/methods/account.d.ts.map +1 -0
  278. package/types/methods/admin.d.ts +30 -0
  279. package/types/methods/admin.d.ts.map +1 -0
  280. package/types/methods/audit.d.ts +11 -0
  281. package/types/methods/audit.d.ts.map +1 -0
  282. package/types/methods/email.d.ts +14 -0
  283. package/types/methods/email.d.ts.map +1 -0
  284. package/types/methods/magicLink.d.ts +12 -0
  285. package/types/methods/magicLink.d.ts.map +1 -0
  286. package/types/methods/oauth.d.ts +16 -0
  287. package/types/methods/oauth.d.ts.map +1 -0
  288. package/types/methods/oauthServer.d.ts +13 -0
  289. package/types/methods/oauthServer.d.ts.map +1 -0
  290. package/types/methods/organizations.d.ts +30 -0
  291. package/types/methods/organizations.d.ts.map +1 -0
  292. package/types/methods/passkeys.d.ts +19 -0
  293. package/types/methods/passkeys.d.ts.map +1 -0
  294. package/types/methods/password.d.ts +17 -0
  295. package/types/methods/password.d.ts.map +1 -0
  296. package/types/methods/sessions.d.ts +9 -0
  297. package/types/methods/sessions.d.ts.map +1 -0
  298. package/types/methods/tokens.d.ts +11 -0
  299. package/types/methods/tokens.d.ts.map +1 -0
  300. package/types/methods/twoFactor.d.ts +20 -0
  301. package/types/methods/twoFactor.d.ts.map +1 -0
  302. package/types/oauth/client.d.ts +39 -0
  303. package/types/oauth/client.d.ts.map +1 -0
  304. package/types/oauth/flow.d.ts +38 -0
  305. package/types/oauth/flow.d.ts.map +1 -0
  306. package/types/oauth/index.d.ts +6 -0
  307. package/types/oauth/index.d.ts.map +1 -0
  308. package/types/oauth/pkce.d.ts +10 -0
  309. package/types/oauth/pkce.d.ts.map +1 -0
  310. package/types/oauth/providers.d.ts +100 -0
  311. package/types/oauth/providers.d.ts.map +1 -0
  312. package/types/oauth/refresher.d.ts +55 -0
  313. package/types/oauth/refresher.d.ts.map +1 -0
  314. package/types/oauth/timeout.d.ts +2 -0
  315. package/types/oauth/timeout.d.ts.map +1 -0
  316. package/types/oauth/types.d.ts +75 -0
  317. package/types/oauth/types.d.ts.map +1 -0
  318. package/types/oauthTest.d.ts +23 -0
  319. package/types/oauthTest.d.ts.map +1 -0
  320. package/types/organizations.d.ts +111 -0
  321. package/types/organizations.d.ts.map +1 -0
  322. package/types/organizationsCore.d.ts +29 -0
  323. package/types/organizationsCore.d.ts.map +1 -0
  324. package/types/own.d.ts +55 -0
  325. package/types/own.d.ts.map +1 -0
  326. package/types/pages/english.d.ts +80 -0
  327. package/types/pages/english.d.ts.map +1 -0
  328. package/types/pages/forms.d.ts +204 -0
  329. package/types/pages/forms.d.ts.map +1 -0
  330. package/types/pages/index.d.ts +166 -0
  331. package/types/pages/index.d.ts.map +1 -0
  332. package/types/pages/organizationPage.d.ts +7 -0
  333. package/types/pages/organizationPage.d.ts.map +1 -0
  334. package/types/pages/routes/account/_guard.d.ts +3 -0
  335. package/types/pages/routes/account/_guard.d.ts.map +1 -0
  336. package/types/pages/routes/account/organizations/_guard.d.ts +3 -0
  337. package/types/pages/routes/account/organizations/_guard.d.ts.map +1 -0
  338. package/types/passkeys.d.ts +61 -0
  339. package/types/passkeys.d.ts.map +1 -0
  340. package/types/password.d.ts +49 -0
  341. package/types/password.d.ts.map +1 -0
  342. package/types/payloads.d.ts +4 -0
  343. package/types/payloads.d.ts.map +1 -0
  344. package/types/pg.d.ts +303 -0
  345. package/types/pg.d.ts.map +1 -0
  346. package/types/profile.d.ts +11 -0
  347. package/types/profile.d.ts.map +1 -0
  348. package/types/proof.d.ts +33 -0
  349. package/types/proof.d.ts.map +1 -0
  350. package/types/prune.d.ts +5 -0
  351. package/types/prune.d.ts.map +1 -0
  352. package/types/rates.d.ts +15 -0
  353. package/types/rates.d.ts.map +1 -0
  354. package/types/request.d.ts +119 -0
  355. package/types/request.d.ts.map +1 -0
  356. package/types/requiredTwoFactor.d.ts +16 -0
  357. package/types/requiredTwoFactor.d.ts.map +1 -0
  358. package/types/requirement.d.ts +4 -0
  359. package/types/requirement.d.ts.map +1 -0
  360. package/types/roles.d.ts +9 -0
  361. package/types/roles.d.ts.map +1 -0
  362. package/types/routes.d.ts +31 -0
  363. package/types/routes.d.ts.map +1 -0
  364. package/types/rules-check.d.ts +3 -0
  365. package/types/rules-check.d.ts.map +1 -0
  366. package/types/rules.d.ts +38 -0
  367. package/types/rules.d.ts.map +1 -0
  368. package/types/securityNotice.d.ts +7 -0
  369. package/types/securityNotice.d.ts.map +1 -0
  370. package/types/sessions.d.ts +32 -0
  371. package/types/sessions.d.ts.map +1 -0
  372. package/types/setup.d.ts +18 -0
  373. package/types/setup.d.ts.map +1 -0
  374. package/types/signInOptions.d.ts +6 -0
  375. package/types/signInOptions.d.ts.map +1 -0
  376. package/types/state.d.ts +25 -0
  377. package/types/state.d.ts.map +1 -0
  378. package/types/store.d.ts +295 -0
  379. package/types/store.d.ts.map +1 -0
  380. package/types/storeHelpers.d.ts +4 -0
  381. package/types/storeHelpers.d.ts.map +1 -0
  382. package/types/test.d.ts +21 -0
  383. package/types/test.d.ts.map +1 -0
  384. package/types/testCookies.d.ts +3 -0
  385. package/types/testCookies.d.ts.map +1 -0
  386. package/types/testHelpers.d.ts +34 -0
  387. package/types/testHelpers.d.ts.map +1 -0
  388. package/types/testing.d.ts +12 -0
  389. package/types/testing.d.ts.map +1 -0
  390. package/types/text.d.ts +2 -0
  391. package/types/text.d.ts.map +1 -0
  392. package/types/totp.d.ts +12 -0
  393. package/types/totp.d.ts.map +1 -0
  394. package/types/twoFactor.d.ts +41 -0
  395. package/types/twoFactor.d.ts.map +1 -0
  396. package/types/types.d.ts +17 -0
  397. package/types/types.d.ts.map +1 -0
  398. package/types/userData.d.ts +9 -0
  399. package/types/userData.d.ts.map +1 -0
  400. package/types/viewer.d.ts +23 -0
  401. package/types/viewer.d.ts.map +1 -0
  402. package/types/wayIn.d.ts +12 -0
  403. package/types/wayIn.d.ts.map +1 -0
  404. package/types/webauthn.d.ts +111 -0
  405. package/types/webauthn.d.ts.map +1 -0
  406. package/types/wsAuth.d.ts +14 -0
  407. package/types/wsAuth.d.ts.map +1 -0
@@ -0,0 +1,599 @@
1
+ import type { AuditRecord, AuthStore, BearerTokenRecord, IdentityRecord, InvitationRecord, MemberRecord, OAuthClientRecord, OAuthCodeRecord, OAuthGrantRecord, OAuthRefreshRecord, OrganizationRecord, PasskeyRecord, PruneLimits, SessionRecord, TokenRecord, UserRecord } from './store'
2
+ import { durationSeconds } from 'kay/library'
3
+ import { memoryAuthRates } from './rates'
4
+
5
+ // A client that registered itself and was never approved by anyone is dropped after this long.
6
+ const UNUSED_CLIENT_MS = 24 * 60 * 60 * 1000
7
+
8
+ // Everything in this process's memory, gone on restart: for tests, and for trying kayjs-auth before a database is wired.
9
+ export function memoryAuth(): AuthStore {
10
+ const users = new Map<string, UserRecord>()
11
+ const identities = new Map<string, IdentityRecord>()
12
+ const tokens = new Map<string, TokenRecord>()
13
+ const recoveryCodes = new Map<string, Set<string>>()
14
+ const bearerTokens = new Map<string, BearerTokenRecord>()
15
+ const sessions = new Map<string, SessionRecord>()
16
+ const passkeys = new Map<string, PasskeyRecord>()
17
+ const organizations = new Map<string, OrganizationRecord>()
18
+ const members = new Map<string, MemberRecord>()
19
+ const invitations = new Map<string, InvitationRecord>()
20
+ const oauthClients = new Map<string, OAuthClientRecord>()
21
+ const oauthGrants = new Map<string, OAuthGrantRecord>()
22
+ const oauthCodes = new Map<string, OAuthCodeRecord>()
23
+ const oauthRefresh = new Map<string, OAuthRefreshRecord>()
24
+ let audit: AuditRecord[] = []
25
+ const rates = memoryAuthRates()
26
+ const identityKey = (provider: string, providerId: string) => `${provider}\n${providerId}`
27
+ const memberKey = (organizationId: string, userId: string) => `${organizationId}\n${userId}`
28
+ const grantKey = (userId: string, clientId: string) => `${userId}\n${clientId}`
29
+
30
+ const dropTokens = (matches: (token: BearerTokenRecord) => boolean) => {
31
+ for (const [key, token] of bearerTokens) {
32
+ if (matches(token))
33
+ bearerTokens.delete(key)
34
+ }
35
+ }
36
+
37
+ const claimSlug = (organization: OrganizationRecord) => {
38
+ for (const other of organizations.values()) {
39
+ if (organization.slug !== null && other.slug === organization.slug && other.id !== organization.id)
40
+ throw new Error(`kayjs-auth: the slug ${organization.slug} is taken`)
41
+ }
42
+ }
43
+
44
+ const holder = (field: 'email' | 'username', value: string | null) => {
45
+ if (value === null)
46
+ return undefined
47
+
48
+ const wanted = value.toLowerCase()
49
+
50
+ for (const user of users.values()) {
51
+ if (user[field]?.toLowerCase() === wanted)
52
+ return user
53
+ }
54
+
55
+ return undefined
56
+ }
57
+
58
+ const claim = (user: UserRecord) => {
59
+ for (const field of ['email', 'username'] as const) {
60
+ const other = holder(field, user[field])
61
+
62
+ if (other && other.id !== user.id)
63
+ throw new Error(`kayjs-auth: the ${field} ${user[field]} is taken`)
64
+ }
65
+ }
66
+
67
+ return {
68
+ users: {
69
+ get: id => copy(users.get(id)),
70
+ getMany: ids => ids.flatMap(id => copy(users.get(id)) ?? []),
71
+ findByEmail: email => copy(holder('email', email)),
72
+ findByUsername: username => copy(holder('username', username)),
73
+ create(user) {
74
+ claim(user)
75
+ users.set(user.id, { ...user, roles: [...user.roles], data: structuredClone(user.data ?? {}) })
76
+ },
77
+ update(id, patch) {
78
+ const user = users.get(id)
79
+
80
+ if (!user)
81
+ return undefined
82
+
83
+ const next = { ...user, ...patch, ...patch.data !== undefined && { data: structuredClone(patch.data) } }
84
+
85
+ claim(next)
86
+ users.set(id, next)
87
+
88
+ return copy(next)
89
+ },
90
+ staleGuests(createdBefore, limit) {
91
+ const withSession = new Set([...sessions.values()].map(session => session.userId))
92
+
93
+ return oldest([...users.values()].filter(user => user.guest && user.createdAt < createdBefore && !withSession.has(user.id)), limit, 'createdAt')
94
+ },
95
+ staleUnverified(createdBefore, limit) {
96
+ const held = new Set([...sessions.values(), ...identities.values()].map(held => held.userId))
97
+
98
+ return oldest([...users.values()].filter(user => !user.guest && user.email !== null && user.emailVerifiedAt === null && user.createdAt < createdBefore && !held.has(user.id)), limit, 'createdAt')
99
+ },
100
+ markForDeletion: (id, deleteAt) => users.has(id) && users.get(id)!.deleteAt == null && Boolean(users.set(id, { ...users.get(id)!, deleteAt })),
101
+ dueForDeletion(now, limit) {
102
+ return oldest([...users.values()].filter(user => user.deleteAt != null && user.deleteAt <= now), limit, 'deleteAt')
103
+ },
104
+ delete(id) {
105
+ const existed = users.delete(id)
106
+
107
+ for (const [key, identity] of identities) {
108
+ if (identity.userId === id)
109
+ identities.delete(key)
110
+ }
111
+
112
+ for (const [key, token] of tokens) {
113
+ if (token.userId === id)
114
+ tokens.delete(key)
115
+ }
116
+
117
+ recoveryCodes.delete(id)
118
+
119
+ for (const [key, token] of bearerTokens) {
120
+ if (token.userId === id)
121
+ bearerTokens.delete(key)
122
+ }
123
+
124
+ for (const map of [oauthGrants, oauthCodes, oauthRefresh] as Map<string, { userId: string }>[]) {
125
+ for (const [key, record] of map) {
126
+ if (record.userId === id)
127
+ map.delete(key)
128
+ }
129
+ }
130
+
131
+ for (const [key, session] of sessions) {
132
+ if (session.userId === id)
133
+ sessions.delete(key)
134
+ }
135
+
136
+ for (const [key, passkey] of passkeys) {
137
+ if (passkey.userId === id)
138
+ passkeys.delete(key)
139
+ }
140
+
141
+ for (const [key, member] of members) {
142
+ if (member.userId === id)
143
+ members.delete(key)
144
+ }
145
+
146
+ for (const invitation of invitations.values()) {
147
+ if (invitation.invitedBy === id)
148
+ invitation.invitedBy = null
149
+ }
150
+
151
+ return existed
152
+ },
153
+ list({ search, offset, limit }) {
154
+ const wanted = search?.toLowerCase()
155
+ const found = [...users.values()]
156
+ .filter(user => wanted === undefined || user.id === search || user.email?.includes(wanted) || user.username?.toLowerCase().includes(wanted))
157
+ .sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime() || (a.id < b.id ? 1 : -1))
158
+
159
+ return { users: found.slice(offset, offset + limit).map(user => copy(user)!), total: found.length }
160
+ },
161
+ advanceTotpStep(id, step) {
162
+ const user = users.get(id)
163
+
164
+ if (!user || step <= user.totpLastStep)
165
+ return false
166
+
167
+ users.set(id, { ...user, totpLastStep: step })
168
+
169
+ return true
170
+ },
171
+ },
172
+ identities: {
173
+ find: (provider, providerId) => clone(identities.get(identityKey(provider, providerId))),
174
+ listByUser: userId => [...identities.values()].filter(identity => identity.userId === userId).map(identity => ({ ...identity })),
175
+ create(identity) {
176
+ const key = identityKey(identity.provider, identity.providerId)
177
+
178
+ if (identities.has(key))
179
+ throw new Error(`kayjs-auth: that ${identity.provider} account is linked already`)
180
+
181
+ identities.set(key, { ...identity })
182
+ },
183
+ update(provider, providerId, patch) {
184
+ const key = identityKey(provider, providerId)
185
+ const identity = identities.get(key)
186
+
187
+ if (identity)
188
+ identities.set(key, { ...identity, ...patch })
189
+ },
190
+ delete: (provider, providerId) => identities.delete(identityKey(provider, providerId)),
191
+ erase(userId) {
192
+ let erased = 0
193
+
194
+ for (const [key, identity] of identities) {
195
+ if (identity.userId === userId && identities.delete(key))
196
+ erased++
197
+ }
198
+
199
+ return erased
200
+ },
201
+ },
202
+ tokens: {
203
+ create(token) {
204
+ tokens.set(token.digest, { ...token })
205
+ },
206
+ consume(digest, type) {
207
+ const token = tokens.get(digest)
208
+
209
+ if (!token || token.type !== type)
210
+ return undefined
211
+
212
+ tokens.delete(digest)
213
+
214
+ return token.expiresAt.getTime() > Date.now() ? token : undefined
215
+ },
216
+ erase(userId, type) {
217
+ let erased = 0
218
+
219
+ for (const [key, token] of tokens) {
220
+ if (token.userId === userId && (type === undefined || token.type === type) && tokens.delete(key))
221
+ erased++
222
+ }
223
+
224
+ return erased
225
+ },
226
+ },
227
+ sessions: {
228
+ create(session) {
229
+ sessions.set(session.id, { ...session })
230
+ },
231
+ get: id => clone(sessions.get(id)),
232
+ listByUser: userId => [...sessions.values()].filter(session => session.userId === userId).sort((a, b) => a.createdAt.getTime() - b.createdAt.getTime()).map(session => ({ ...session })),
233
+ update(id, patch) {
234
+ const session = sessions.get(id)
235
+
236
+ if (session)
237
+ sessions.set(id, { ...session, ...patch })
238
+ },
239
+ delete(userId, id) {
240
+ if (sessions.get(id)?.userId !== userId)
241
+ return false
242
+
243
+ return sessions.delete(id)
244
+ },
245
+ },
246
+ passkeys: {
247
+ create(passkey) {
248
+ if (passkeys.has(passkey.id))
249
+ throw new Error(`kayjs-auth: the passkey ${passkey.id} is taken`)
250
+
251
+ passkeys.set(passkey.id, copyPasskey(passkey)!)
252
+ },
253
+ get: id => copyPasskey(passkeys.get(id)),
254
+ listByUser: userId => [...passkeys.values()].filter(passkey => passkey.userId === userId).sort((a, b) => a.createdAt.getTime() - b.createdAt.getTime()).map(passkey => copyPasskey(passkey)!),
255
+ update(id, patch) {
256
+ const passkey = passkeys.get(id)
257
+
258
+ if (passkey)
259
+ passkeys.set(id, { ...passkey, ...patch })
260
+ },
261
+ delete(userId, id) {
262
+ if (passkeys.get(id)?.userId !== userId)
263
+ return false
264
+
265
+ return passkeys.delete(id)
266
+ },
267
+ },
268
+ audit: {
269
+ add(entry) {
270
+ audit.push({ ...entry })
271
+ },
272
+ list: ({ userId, before, limit }) => audit
273
+ .filter(entry => (userId === undefined || entry.userId === userId) && (before === undefined || (before instanceof Date ? entry.at < before : entry.at < before.at || (entry.at.getTime() === before.at.getTime() && entry.id < before.id))))
274
+ .sort((a, b) => b.at.getTime() - a.at.getTime() || (a.id < b.id ? 1 : -1))
275
+ .slice(0, limit)
276
+ .map(entry => ({ ...entry })),
277
+ prune(before) {
278
+ const kept = audit.filter(entry => entry.at >= before)
279
+ const pruned = audit.length - kept.length
280
+
281
+ audit = kept
282
+
283
+ return pruned
284
+ },
285
+ erase(userId, pseudonym) {
286
+ let erased = 0
287
+
288
+ audit = audit.map((entry) => {
289
+ if (entry.userId === userId) {
290
+ erased++
291
+
292
+ return { ...entry, userId: pseudonym, detail: null, ip: '', userAgent: '' }
293
+ }
294
+
295
+ if (entry.actorId !== userId)
296
+ return entry
297
+
298
+ erased++
299
+
300
+ return { ...entry, actorId: pseudonym, ip: '', userAgent: '' }
301
+ })
302
+
303
+ return erased
304
+ },
305
+ },
306
+ bearerTokens: {
307
+ create(token) {
308
+ bearerTokens.set(token.id, copyToken(token)!)
309
+ },
310
+ findByDigest: digest => copyToken([...bearerTokens.values()].find(token => token.digest === digest)),
311
+ findByDigestWithUser(digest) {
312
+ const token = copyToken([...bearerTokens.values()].find(each => each.digest === digest))
313
+ const user = token && copy(users.get(token.userId))
314
+
315
+ return token && user ? { token, user } : undefined
316
+ },
317
+ listByUser: userId => [...bearerTokens.values()].filter(token => token.userId === userId).map(token => copyToken(token)!),
318
+ touch(id, at) {
319
+ const token = bearerTokens.get(id)
320
+
321
+ if (token)
322
+ bearerTokens.set(id, { ...token, lastUsedAt: at })
323
+ },
324
+ delete(userId, id) {
325
+ if (bearerTokens.get(id)?.userId !== userId)
326
+ return false
327
+
328
+ return bearerTokens.delete(id)
329
+ },
330
+ erase(userId) {
331
+ let erased = 0
332
+
333
+ for (const [key, token] of bearerTokens) {
334
+ if (token.userId === userId && bearerTokens.delete(key))
335
+ erased++
336
+ }
337
+
338
+ return erased
339
+ },
340
+ },
341
+ oauth: {
342
+ clients: {
343
+ create(client) {
344
+ oauthClients.set(client.id, { ...client, redirectUris: [...client.redirectUris] })
345
+ },
346
+ get(id) {
347
+ const client = oauthClients.get(id)
348
+
349
+ return client && { ...client, redirectUris: [...client.redirectUris] }
350
+ },
351
+ },
352
+ grants: {
353
+ get: (userId, clientId) => copyGrant(oauthGrants.get(grantKey(userId, clientId))),
354
+ upsert(grant) {
355
+ const key = grantKey(grant.userId, grant.clientId)
356
+
357
+ oauthGrants.set(key, { ...copyGrant(grant)!, createdAt: oauthGrants.get(key)?.createdAt ?? grant.createdAt })
358
+ },
359
+ touch(userId, clientId, at) {
360
+ const grant = oauthGrants.get(grantKey(userId, clientId))
361
+
362
+ if (grant)
363
+ grant.lastUsedAt = at
364
+ },
365
+ listByUser: userId => oldestFirst([...oauthGrants.values()].filter(grant => grant.userId === userId)).map(grant => copyGrant(grant)!),
366
+ revoke(userId, clientId) {
367
+ for (const [key, token] of oauthRefresh) {
368
+ if (token.userId === userId && token.clientId === clientId)
369
+ oauthRefresh.delete(key)
370
+ }
371
+
372
+ dropTokens(token => token.userId === userId && token.oauth?.clientId === clientId)
373
+
374
+ return oauthGrants.delete(grantKey(userId, clientId))
375
+ },
376
+ },
377
+ codes: {
378
+ create(code) {
379
+ oauthCodes.set(code.digest, copyOAuth(code))
380
+ },
381
+ get(digest) {
382
+ const code = oauthCodes.get(digest)
383
+
384
+ return code && copyOAuth(code)
385
+ },
386
+ use(digest, at) {
387
+ const code = oauthCodes.get(digest)
388
+
389
+ if (!code)
390
+ return undefined
391
+
392
+ const reused = code.usedAt !== null
393
+
394
+ code.usedAt ??= at
395
+
396
+ return { code: copyOAuth(code), reused }
397
+ },
398
+ },
399
+ refresh: {
400
+ create(token) {
401
+ oauthRefresh.set(token.digest, copyOAuth(token))
402
+ },
403
+ get(digest) {
404
+ const token = oauthRefresh.get(digest)
405
+
406
+ return token && copyOAuth(token)
407
+ },
408
+ use(digest, at) {
409
+ const token = oauthRefresh.get(digest)
410
+
411
+ if (!token)
412
+ return undefined
413
+
414
+ const reused = token.usedAt !== null
415
+
416
+ token.usedAt ??= at
417
+
418
+ return { token: copyOAuth(token), reused }
419
+ },
420
+ revokeFamily(userId, family) {
421
+ for (const [key, token] of oauthRefresh) {
422
+ if (token.userId === userId && token.family === family)
423
+ oauthRefresh.delete(key)
424
+ }
425
+
426
+ dropTokens(token => token.userId === userId && token.oauth?.family === family)
427
+ },
428
+ erase(userId) {
429
+ let erased = 0
430
+
431
+ for (const [key, token] of oauthRefresh) {
432
+ if (token.userId === userId && oauthRefresh.delete(key))
433
+ erased++
434
+ }
435
+
436
+ return erased
437
+ },
438
+ },
439
+ },
440
+ recoveryCodes: {
441
+ replace(userId, digests) {
442
+ recoveryCodes.set(userId, new Set(digests))
443
+ },
444
+ consume: (userId, digest) => recoveryCodes.get(userId)?.delete(digest) ?? false,
445
+ count: userId => recoveryCodes.get(userId)?.size ?? 0,
446
+ },
447
+ organizations: {
448
+ create(organization) {
449
+ claimSlug(organization)
450
+ organizations.set(organization.id, { ...organization })
451
+ },
452
+ get: id => clone(organizations.get(id)),
453
+ getMany: ids => ids.flatMap(id => clone(organizations.get(id)) ?? []),
454
+ findBySlug: slug => clone([...organizations.values()].find(organization => organization.slug === slug)),
455
+ update(id, patch) {
456
+ const organization = organizations.get(id)
457
+
458
+ if (!organization)
459
+ return undefined
460
+
461
+ const next = { ...organization, ...patch }
462
+
463
+ claimSlug(next)
464
+ organizations.set(id, next)
465
+
466
+ return { ...next }
467
+ },
468
+ delete(id) {
469
+ for (const [key, member] of members) {
470
+ if (member.organizationId === id)
471
+ members.delete(key)
472
+ }
473
+
474
+ for (const [key, invitation] of invitations) {
475
+ if (invitation.organizationId === id)
476
+ invitations.delete(key)
477
+ }
478
+
479
+ return organizations.delete(id)
480
+ },
481
+ },
482
+ members: {
483
+ add(member) {
484
+ const key = memberKey(member.organizationId, member.userId)
485
+
486
+ if (members.has(key))
487
+ throw new Error(`kayjs-auth: user ${member.userId} is a member already`)
488
+
489
+ members.set(key, copyMember(member)!)
490
+ },
491
+ get: (organizationId, userId) => copyMember(members.get(memberKey(organizationId, userId))),
492
+ listByOrganization: organizationId => oldestFirst([...members.values()].filter(member => member.organizationId === organizationId)).map(member => copyMember(member)!),
493
+ listByUser: userId => oldestFirst([...members.values()].filter(member => member.userId === userId)).map(member => copyMember(member)!),
494
+ update(organizationId, userId, patch) {
495
+ const key = memberKey(organizationId, userId)
496
+ const member = members.get(key)
497
+
498
+ if (!member)
499
+ return undefined
500
+
501
+ members.set(key, { ...member, roles: [...patch.roles] })
502
+
503
+ return copyMember(members.get(key))
504
+ },
505
+ delete: (organizationId, userId) => members.delete(memberKey(organizationId, userId)),
506
+ },
507
+ invitations: {
508
+ create(invitation) {
509
+ invitations.set(invitation.id, copyInvitation(invitation)!)
510
+ },
511
+ get: id => copyInvitation(invitations.get(id)),
512
+ listByOrganization: organizationId => oldestFirst([...invitations.values()].filter(invitation => invitation.organizationId === organizationId)).map(invitation => copyInvitation(invitation)!),
513
+ listByEmail: email => oldestFirst([...invitations.values()].filter(invitation => invitation.email === email)).map(invitation => copyInvitation(invitation)!),
514
+ delete: id => invitations.delete(id),
515
+ },
516
+ rates,
517
+ prune({ now, bearerExpiredBefore, sessionMaxAge, sessionAbsoluteMaxAge }: PruneLimits) {
518
+ const at = now.getTime()
519
+
520
+ for (const [key, token] of tokens) {
521
+ if (token.expiresAt.getTime() <= at)
522
+ tokens.delete(key)
523
+ }
524
+
525
+ for (const [key, invitation] of invitations) {
526
+ if (invitation.expiresAt.getTime() <= at)
527
+ invitations.delete(key)
528
+ }
529
+
530
+ for (const [key, token] of bearerTokens) {
531
+ if (token.expiresAt && token.expiresAt < bearerExpiredBefore)
532
+ bearerTokens.delete(key)
533
+ }
534
+
535
+ rates.sweep(at)
536
+
537
+ for (const map of [oauthCodes, oauthRefresh]) {
538
+ for (const [key, record] of map) {
539
+ if (record.expiresAt.getTime() <= at)
540
+ map.delete(key)
541
+ }
542
+ }
543
+
544
+ const granted = new Set([...oauthGrants.values()].map(grant => grant.clientId))
545
+
546
+ for (const [key, client] of oauthClients) {
547
+ if (client.createdAt.getTime() < at - UNUSED_CLIENT_MS && !granted.has(key))
548
+ oauthClients.delete(key)
549
+ }
550
+
551
+ for (const [key, session] of sessions) {
552
+ if (session.lastSeenAt.getTime() < at - durationSeconds(sessionMaxAge, 'sessionMaxAge') * 1000 || session.createdAt.getTime() < at - durationSeconds(sessionAbsoluteMaxAge, 'sessionAbsoluteMaxAge') * 1000 || session.version < (users.get(session.userId)?.sessionVersion ?? 0))
553
+ sessions.delete(key)
554
+ }
555
+ },
556
+ }
557
+ }
558
+
559
+ // The first `limit` of the users by one date, as copies.
560
+ function oldest(list: UserRecord[], limit: number, by: 'createdAt' | 'deleteAt'): UserRecord[] {
561
+ return list.sort((a, b) => a[by]!.getTime() - b[by]!.getTime()).slice(0, limit).map(user => copy(user)!)
562
+ }
563
+
564
+ // Callers get their own copy, as from a database, so changing one changes nothing stored.
565
+ function copy(user: UserRecord | undefined): UserRecord | undefined {
566
+ return user && { ...user, roles: [...user.roles], data: structuredClone(user.data ?? {}) }
567
+ }
568
+
569
+ function copyToken(token: BearerTokenRecord | undefined): BearerTokenRecord | undefined {
570
+ return token && { ...token, scopes: token.scopes && [...token.scopes], ...token.oauth && { oauth: { ...token.oauth } } }
571
+ }
572
+
573
+ function copyGrant(grant: OAuthGrantRecord | undefined): OAuthGrantRecord | undefined {
574
+ return grant && { ...grant, scopes: grant.scopes && [...grant.scopes] }
575
+ }
576
+
577
+ function copyOAuth<T extends OAuthCodeRecord | OAuthRefreshRecord>(record: T): T {
578
+ return { ...record, scopes: record.scopes && [...record.scopes] }
579
+ }
580
+
581
+ function copyPasskey(passkey: PasskeyRecord | undefined): PasskeyRecord | undefined {
582
+ return passkey && { ...passkey, transports: [...passkey.transports] }
583
+ }
584
+
585
+ function copyMember(member: MemberRecord | undefined): MemberRecord | undefined {
586
+ return member && { ...member, roles: [...member.roles] }
587
+ }
588
+
589
+ function copyInvitation(invitation: InvitationRecord | undefined): InvitationRecord | undefined {
590
+ return invitation && { ...invitation, roles: [...invitation.roles] }
591
+ }
592
+
593
+ function oldestFirst<T extends { createdAt: Date }>(records: T[]): T[] {
594
+ return records.sort((a, b) => a.createdAt.getTime() - b.createdAt.getTime())
595
+ }
596
+
597
+ function clone<T extends object>(value: T | undefined): T | undefined {
598
+ return value && { ...value }
599
+ }