@getstrata/core 2.2.60 → 3.0.3

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 (330) hide show
  1. package/CHANGELOG.md +22 -0
  2. package/dist/core/audit/exportAuditLogs.d.ts +12 -3
  3. package/dist/core/audit/exportStore.d.ts +6 -2
  4. package/dist/core/audit/siemFormatter.d.ts +2 -2
  5. package/dist/core/auth/abilityCatalog.d.ts +1 -9
  6. package/dist/core/auth/authContext.d.ts +2 -0
  7. package/dist/core/auth/authOutcome.d.ts +32 -0
  8. package/dist/core/auth/authReader.d.ts +22 -0
  9. package/dist/core/auth/basicAuthGuard.d.ts +19 -3
  10. package/dist/core/auth/emailVerification.d.ts +1 -1
  11. package/dist/core/auth/guard.d.ts +27 -6
  12. package/dist/core/auth/intendedUrlCookie.d.ts +13 -7
  13. package/dist/core/auth/jwt.d.ts +5 -4
  14. package/dist/core/auth/jwtGuard.d.ts +7 -6
  15. package/dist/core/auth/membershipContext.d.ts +10 -7
  16. package/dist/core/auth/membershipContextMiddleware.d.ts +3 -3
  17. package/dist/core/auth/membershipMiddleware.d.ts +1 -2
  18. package/dist/core/auth/membershipServiceImplementation.d.ts +1 -1
  19. package/dist/core/auth/oauth/oidcIdToken.d.ts +25 -16
  20. package/dist/core/auth/oauth/oidcProvider.d.ts +6 -4
  21. package/dist/core/auth/oauth/providers.d.ts +3 -1
  22. package/dist/core/auth/oneTimeToken.d.ts +2 -3
  23. package/dist/core/auth/passwordConfirmCookie.d.ts +15 -6
  24. package/dist/core/auth/passwordLogin.d.ts +5 -5
  25. package/dist/core/auth/pendingMfaCookie.d.ts +2 -2
  26. package/dist/core/auth/policy.d.ts +23 -10
  27. package/dist/core/auth/requireAuthCapability.d.ts +3 -0
  28. package/dist/core/auth/resolveMembershipService.d.ts +3 -2
  29. package/dist/core/auth/saml/samlAssertionReplay.d.ts +4 -4
  30. package/dist/core/auth/saml/samlServiceProvider.d.ts +11 -7
  31. package/dist/core/auth/scimAuthMiddleware.d.ts +10 -3
  32. package/dist/core/auth/sessionCookie.d.ts +20 -9
  33. package/dist/core/auth/sessionGuard.d.ts +14 -3
  34. package/dist/core/cache/createCacheStore.d.ts +6 -3
  35. package/dist/core/cache/redisCacheStore.d.ts +5 -1
  36. package/dist/core/cache/repository.d.ts +5 -1
  37. package/dist/core/cache/simpleCache.d.ts +2 -1
  38. package/dist/core/cache/tokens.d.ts +8 -0
  39. package/dist/core/config/applicationConfig.d.ts +21 -0
  40. package/dist/core/config/configSnapshot.d.ts +3 -0
  41. package/dist/core/config/envSchema.d.ts +3 -2
  42. package/dist/core/contracts/application.d.ts +153 -0
  43. package/dist/core/contracts/authUserDirectory.d.ts +24 -7
  44. package/dist/core/contracts/container.d.ts +20 -23
  45. package/dist/core/contracts/di.d.ts +4 -2
  46. package/dist/core/contracts/executionContext.d.ts +5 -0
  47. package/dist/core/contracts/executionOperations.d.ts +10 -0
  48. package/dist/core/contracts/executionOwnership.d.ts +38 -0
  49. package/dist/core/contracts/persistence.d.ts +20 -0
  50. package/dist/core/contracts/serviceTokens.d.ts +32 -18
  51. package/dist/core/contracts/services.d.ts +63 -0
  52. package/dist/core/contracts/token.d.ts +19 -0
  53. package/dist/core/crypto/fieldEncryption.d.ts +19 -7
  54. package/dist/core/crypto/fieldEncryptionRotation.d.ts +21 -5
  55. package/dist/core/crypto/mfaSecret.d.ts +10 -3
  56. package/dist/core/database/baseRepository.d.ts +14 -10
  57. package/dist/core/database/bindings.d.ts +6 -0
  58. package/dist/core/database/bunSql.d.ts +3 -12
  59. package/dist/core/database/definitions.d.ts +209 -0
  60. package/dist/core/database/dialect.d.ts +5 -24
  61. package/dist/core/database/driverPorts.d.ts +116 -0
  62. package/dist/core/database/errors.d.ts +47 -7
  63. package/dist/core/database/factory.d.ts +51 -31
  64. package/dist/core/database/index.d.ts +9 -10
  65. package/dist/core/database/keyset.d.ts +2 -1
  66. package/dist/core/database/legacyNativeTransaction.d.ts +5 -0
  67. package/dist/core/database/manager.d.ts +12 -0
  68. package/dist/core/database/model.d.ts +91 -97
  69. package/dist/core/database/modelQuery.d.ts +9 -5
  70. package/dist/core/database/modelRegistry.d.ts +52 -33
  71. package/dist/core/database/mysqlConnection.d.ts +1 -19
  72. package/dist/core/database/mysqlNative.d.ts +38 -0
  73. package/dist/core/database/nativeTransactions.d.ts +16 -0
  74. package/dist/core/database/ormInternal.d.ts +85 -0
  75. package/dist/core/database/ormRuntime.d.ts +4 -0
  76. package/dist/core/database/ownedReadOnlyObservation.d.ts +16 -0
  77. package/dist/core/database/postgresNative.d.ts +11 -0
  78. package/dist/core/database/query.d.ts +24 -23
  79. package/dist/core/database/queryPlanSnapshot.d.ts +7 -0
  80. package/dist/core/database/rawMysql.d.ts +7 -0
  81. package/dist/core/database/rawPostgres.d.ts +23 -0
  82. package/dist/core/database/rawSqlite.d.ts +6 -0
  83. package/dist/core/database/relationQueries.d.ts +3 -2
  84. package/dist/core/database/relationQuery.d.ts +24 -6
  85. package/dist/core/database/repositoryQuery.d.ts +6 -1
  86. package/dist/core/database/schema/driver.d.ts +1 -1
  87. package/dist/core/database/seeders/types.d.ts +1 -1
  88. package/dist/core/database/session.d.ts +13 -0
  89. package/dist/core/database/sessionFactory.d.ts +9 -0
  90. package/dist/core/database/sqlDialects.d.ts +22 -0
  91. package/dist/core/database/tokens.d.ts +7 -0
  92. package/dist/core/database/transactionSession.d.ts +43 -0
  93. package/dist/core/errors/http.d.ts +4 -1
  94. package/dist/core/events/{eventBus.d.ts → eventBusClass.d.ts} +1 -3
  95. package/dist/core/events/index.d.ts +2 -3
  96. package/dist/core/events/outbox/index.d.ts +44 -13
  97. package/dist/core/events/outbox/metrics.d.ts +4 -4
  98. package/dist/core/events/outbox/workerTransport.d.ts +17 -0
  99. package/dist/core/http/authMiddleware.d.ts +2 -2
  100. package/dist/core/http/authorizeMiddleware.d.ts +2 -2
  101. package/dist/core/http/bodySizeLimitMiddleware.d.ts +1 -1
  102. package/dist/core/http/conditionalResponse.d.ts +7 -2
  103. package/dist/core/http/contentSecurityPolicy.d.ts +4 -3
  104. package/dist/core/http/corsMiddleware.d.ts +2 -1
  105. package/dist/core/http/csrfMiddleware.d.ts +6 -1
  106. package/dist/core/http/csrfToken.d.ts +17 -7
  107. package/dist/core/http/databaseError.d.ts +4 -0
  108. package/dist/core/http/etag.d.ts +5 -2
  109. package/dist/core/http/flashMiddleware.d.ts +1 -1
  110. package/dist/core/http/flashSession.d.ts +13 -7
  111. package/dist/core/http/index.d.ts +1 -1
  112. package/dist/core/http/loginThrottleMiddleware.d.ts +3 -3
  113. package/dist/core/http/memoryThrottleMiddleware.d.ts +2 -2
  114. package/dist/core/http/parseMultipartUpload.d.ts +3 -2
  115. package/dist/core/http/requestMetaContext.d.ts +5 -0
  116. package/dist/core/http/requireAbilityMiddleware.d.ts +1 -1
  117. package/dist/core/http/requireAuthMiddleware.d.ts +2 -2
  118. package/dist/core/http/requirePasswordConfirmMiddleware.d.ts +2 -1
  119. package/dist/core/http/requireVerifiedMiddleware.d.ts +2 -2
  120. package/dist/core/http/requireWebAuthMiddleware.d.ts +2 -2
  121. package/dist/core/http/response.d.ts +4 -3
  122. package/dist/core/http/scimThrottleMiddleware.d.ts +4 -3
  123. package/dist/core/http/securedRouteModelBinding.d.ts +10 -3
  124. package/dist/core/http/securityHeadersMiddleware.d.ts +1 -2
  125. package/dist/core/http/signedUrl.d.ts +8 -6
  126. package/dist/core/http/throttleMiddleware.d.ts +9 -5
  127. package/dist/core/http/uploads.d.ts +9 -3
  128. package/dist/core/http/webErrorResponse.d.ts +8 -2
  129. package/dist/core/jobs/exportAuditLogsJob.d.ts +5 -2
  130. package/dist/core/jobs/invalidateCacheTagsJob.d.ts +5 -4
  131. package/dist/core/lifecycle/gracefulShutdown.d.ts +2 -5
  132. package/dist/core/logging/requestLoggingMiddleware.d.ts +1 -1
  133. package/dist/core/mail/mailer.d.ts +7 -5
  134. package/dist/core/openapi/generator.d.ts +12 -4
  135. package/dist/core/openapi/registeredRoute.d.ts +4 -4
  136. package/dist/core/queue/createAppQueue.d.ts +9 -4
  137. package/dist/core/queue/failedJobMetrics.d.ts +11 -2
  138. package/dist/core/queue/failedJobRepository.d.ts +6 -3
  139. package/dist/core/queue/failedJobService.d.ts +1 -0
  140. package/dist/core/queue/index.d.ts +16 -6
  141. package/dist/core/queue/jobRegistry.d.ts +3 -2
  142. package/dist/core/queue/jobRunner.d.ts +10 -4
  143. package/dist/core/queue/publicQueue.d.ts +18 -9
  144. package/dist/core/queue/queueConfig.d.ts +20 -10
  145. package/dist/core/queue/queueHandoff.d.ts +31 -0
  146. package/dist/core/queue/queueMetrics.d.ts +10 -3
  147. package/dist/core/queue/queueServices.d.ts +28 -0
  148. package/dist/core/queue/queueWorkerTransport.d.ts +28 -0
  149. package/dist/core/queue/redisQueue.d.ts +19 -10
  150. package/dist/core/queue/redisQueueKeys.d.ts +5 -5
  151. package/dist/core/queue/redisStreams.d.ts +17 -10
  152. package/dist/core/queue/resilientQueue.d.ts +10 -4
  153. package/dist/core/queue/types.d.ts +1 -0
  154. package/dist/core/runtime/appKeyPrefix.d.ts +5 -5
  155. package/dist/core/runtime/application.d.ts +7 -0
  156. package/dist/core/runtime/executionContext.d.ts +9 -0
  157. package/dist/core/runtime/executionTasks.d.ts +49 -0
  158. package/dist/core/runtime/resourceJournal.d.ts +67 -0
  159. package/dist/core/runtime/serviceGraph.d.ts +14 -0
  160. package/dist/core/security/oauthState.d.ts +13 -9
  161. package/dist/core/security/publicReads.d.ts +2 -2
  162. package/dist/core/security/safeFetch.d.ts +1 -0
  163. package/dist/core/security/safeUrl.d.ts +3 -0
  164. package/dist/core/security/scimTenantTokens.d.ts +1 -1
  165. package/dist/core/security/tokenExpiry.d.ts +1 -1
  166. package/dist/core/security/webhookSignature.d.ts +1 -1
  167. package/dist/core/storage/storage.d.ts +24 -16
  168. package/dist/core/tenant/databaseTenantContext.d.ts +5 -7
  169. package/dist/core/tenant/resolveTenant.d.ts +2 -2
  170. package/dist/core/tenant/scopedDatabasePolicy.d.ts +8 -0
  171. package/dist/core/tenant/tenantDatabaseScope.d.ts +3 -7
  172. package/dist/core/tenant/tenantMiddleware.d.ts +15 -4
  173. package/dist/core/tracing/otel.d.ts +4 -6
  174. package/dist/core/tracing/tracingMiddleware.d.ts +3 -3
  175. package/dist/core/view/etaViewEngine.d.ts +1 -1
  176. package/dist/core/view/index.d.ts +5 -4
  177. package/dist/core/view/tokens.d.ts +8 -0
  178. package/dist/core/view/viewRenderer.d.ts +2 -2
  179. package/dist/core/view/webErrorView.d.ts +8 -7
  180. package/dist/core/view/webLayoutData.d.ts +6 -4
  181. package/dist/entries/audit/exportAuditLogs.js +87 -1024
  182. package/dist/entries/audit/siemFormatter.js +4 -90
  183. package/dist/entries/auth/abilityCatalog.js +28 -0
  184. package/dist/entries/auth/accessControl.js +5 -16
  185. package/dist/entries/auth/accountStateMigration.js +216 -236
  186. package/dist/entries/auth/authOutcome.js +80 -0
  187. package/dist/entries/auth/authReader.js +68 -0
  188. package/dist/entries/auth/basicAuthGuard.js +144 -1249
  189. package/dist/entries/auth/emailVerification.js +2 -2
  190. package/dist/entries/auth/intendedUrlCookie.js +35 -59
  191. package/dist/entries/auth/jwt.js +22 -47
  192. package/dist/entries/auth/jwtGuard.js +99 -231
  193. package/dist/entries/auth/membershipMiddleware.js +71 -10
  194. package/dist/entries/auth/membershipScope.js +16 -22
  195. package/dist/entries/auth/membershipService.js +11 -28
  196. package/dist/entries/auth/oauth/oidcProvider.js +59 -64
  197. package/dist/entries/auth/oauth/providers.js +12 -95
  198. package/dist/entries/auth/oauth/samlProvider.js +53 -1080
  199. package/dist/entries/auth/oneTimeToken.js +27 -289
  200. package/dist/entries/auth/passwordConfirmCookie.js +40 -63
  201. package/dist/entries/auth/passwordLogin.js +94 -399
  202. package/dist/entries/auth/pendingMfaCookie.js +6 -6
  203. package/dist/entries/auth/policy.js +22 -56
  204. package/dist/entries/auth/saml/samlServiceProvider.js +55 -1084
  205. package/dist/entries/auth/scimAuthMiddleware.js +16 -3358
  206. package/dist/entries/auth/sessionCookie.js +58 -73
  207. package/dist/entries/auth/sessionGuard.js +95 -248
  208. package/dist/entries/auth/tokenHash.js +11 -43
  209. package/dist/entries/cache/createCacheStore.js +126 -117
  210. package/dist/entries/cache/repository.js +25 -0
  211. package/dist/entries/cache/simpleCache.js +12 -7
  212. package/dist/entries/cache/tokens.js +9 -0
  213. package/dist/entries/config/applicationConfig.js +163 -0
  214. package/dist/entries/config/envSchema.js +21 -4
  215. package/dist/entries/contracts/application.js +1 -0
  216. package/dist/entries/contracts/authUserDirectory.js +10 -0
  217. package/dist/entries/contracts/container.js +99 -26
  218. package/dist/entries/contracts/di.js +3 -0
  219. package/dist/entries/contracts/executionContext.js +7 -0
  220. package/dist/entries/contracts/executionOperations.js +7 -0
  221. package/dist/entries/contracts/executionOwnership.js +7 -0
  222. package/dist/entries/contracts/membership.js +1 -0
  223. package/dist/entries/contracts/persistence.js +1 -0
  224. package/dist/entries/contracts/serviceTokens.js +26 -116
  225. package/dist/entries/contracts/services.js +98 -0
  226. package/dist/entries/contracts/token.js +41 -0
  227. package/dist/entries/crypto/fieldEncryption.js +49 -50
  228. package/dist/entries/crypto/mfaSecret.js +86 -82
  229. package/dist/entries/database/acquisitionMetrics.js +107 -0
  230. package/dist/entries/database/baseRepository.d.ts +2 -0
  231. package/dist/entries/database/bindings.js +2082 -0
  232. package/dist/entries/database/definitions.js +175 -0
  233. package/dist/entries/database/errors.js +114 -89
  234. package/dist/entries/database/factory.js +67 -28
  235. package/dist/entries/database/migrations.js +172 -224
  236. package/dist/entries/database/model.d.ts +1 -0
  237. package/dist/entries/database/ownedReadOnlyObservation.js +1282 -0
  238. package/dist/entries/database/query.js +159 -161
  239. package/dist/entries/database/repositoryQuery.d.ts +1 -0
  240. package/dist/entries/database/repositoryQuery.js +1 -1373
  241. package/dist/entries/database/schema.js +216 -236
  242. package/dist/entries/database/session.js +1 -0
  243. package/dist/entries/database/sqliteConnection.js +525 -83
  244. package/dist/entries/database/tokens.js +9 -0
  245. package/dist/entries/errors/http.js +118 -1
  246. package/dist/entries/http/authMiddleware.js +8 -5
  247. package/dist/entries/http/authorizeMiddleware.js +1 -1
  248. package/dist/entries/http/bodySizeLimitMiddleware.js +2 -2
  249. package/dist/entries/http/clientIp.js +2 -2
  250. package/dist/entries/http/conditionalResponse.js +19 -7
  251. package/dist/entries/http/corsMiddleware.js +6 -101
  252. package/dist/entries/http/csrfMiddleware.js +92 -106
  253. package/dist/entries/http/csrfToken.js +58 -94
  254. package/dist/entries/http/etag.js +7 -4
  255. package/dist/entries/http/flashMiddleware.js +57 -99
  256. package/dist/entries/http/flashSession.js +41 -68
  257. package/dist/entries/http/memoryThrottleMiddleware.js +43 -186
  258. package/dist/entries/http/metricsMiddleware.js +2 -16
  259. package/dist/entries/http/parseMultipartUpload.js +15 -29
  260. package/dist/entries/http/requireAbilityMiddleware.js +2 -2
  261. package/dist/entries/http/requirePasswordConfirmMiddleware.js +19 -31
  262. package/dist/entries/http/requireVerifiedMiddleware.js +4 -7
  263. package/dist/entries/http/requireWebAuthMiddleware.js +2 -2
  264. package/dist/entries/http/response.js +67 -233
  265. package/dist/entries/http/routeMiddleware.js +0 -14
  266. package/dist/entries/http/scimThrottleMiddleware.js +43 -237
  267. package/dist/entries/http/securedRouteModelBinding.js +37 -25
  268. package/dist/entries/http/securityHeadersMiddleware.js +8 -25
  269. package/dist/entries/http/signedUrl.js +20 -110
  270. package/dist/entries/http/throttleMiddleware.js +41 -185
  271. package/dist/entries/http/uploads.js +9 -24
  272. package/dist/entries/jobs/exportAuditLogsJob.js +17 -1498
  273. package/dist/entries/jobs/invalidateCacheTagsJob.js +12 -47
  274. package/dist/entries/logging/requestLoggingMiddleware.js +4 -4
  275. package/dist/entries/mail/mailer.js +68 -78
  276. package/dist/entries/openapi/generator.js +33 -100
  277. package/dist/entries/queue/createAppQueue.js +416 -256
  278. package/dist/entries/queue/failedJobRepository.js +17 -8
  279. package/dist/entries/queue/failedJobService.js +1 -0
  280. package/dist/entries/queue/jobRunner.js +141 -66
  281. package/dist/entries/queue/publicQueue.js +411 -257
  282. package/dist/entries/queue/queueConfig.js +61 -0
  283. package/dist/entries/queue/queueHandoff.js +318 -0
  284. package/dist/entries/queue/queueMetrics.js +989 -1386
  285. package/dist/entries/queue/queueServices.js +133 -0
  286. package/dist/entries/queue/queueWorkerTransport.js +1703 -0
  287. package/dist/entries/queue/redisQueue.js +282 -180
  288. package/dist/entries/queue.js +6 -45
  289. package/dist/entries/runtime/application.js +1585 -0
  290. package/dist/entries/runtime/asyncContextStore.js +0 -16
  291. package/dist/entries/security/oauthState.js +35 -67
  292. package/dist/entries/security/publicReads.js +4 -4
  293. package/dist/entries/security/safeFetch.js +1 -0
  294. package/dist/entries/security/scimTenantTokens.js +3 -3
  295. package/dist/entries/security/tokenExpiry.js +2 -2
  296. package/dist/entries/security/totp.js +1 -87
  297. package/dist/entries/security/webhookSignature.js +2 -90
  298. package/dist/entries/storage/storage.js +120 -45
  299. package/dist/entries/tenant/databaseTenantContext.js +6 -907
  300. package/dist/entries/tenant/publicTenantHost.js +78 -0
  301. package/dist/entries/tenant/resolveTenant.js +14 -0
  302. package/dist/entries/tenant/scopedDatabasePolicy.js +75 -0
  303. package/dist/entries/tenant/tenancyConfig.js +1 -19
  304. package/dist/entries/tenant/tenantDatabaseScope.js +3 -892
  305. package/dist/entries/tracing/tracingMiddleware.js +104 -173
  306. package/dist/entries/view/tokens.js +11 -0
  307. package/dist/framework/public-api.d.ts +62 -44
  308. package/dist/index.js +10435 -11351
  309. package/dist/internal/ormInternal.js +117 -0
  310. package/dist/internal/ormRuntime.js +5000 -0
  311. package/package.json +158 -46
  312. package/dist/core/database/bindConnection.d.ts +0 -1
  313. package/dist/core/database/boundConnection.d.ts +0 -5
  314. package/dist/core/database/defaultConnection.d.ts +0 -7
  315. package/dist/core/database/namedConnections.d.ts +0 -15
  316. package/dist/core/database/readOnlyCollector.d.ts +0 -7
  317. package/dist/core/database/repositoryConnection.d.ts +0 -4
  318. package/dist/core/database/transaction.d.ts +0 -23
  319. package/dist/core/database/transactionControl.d.ts +0 -6
  320. package/dist/core/events/deferredModelEvents.d.ts +0 -7
  321. package/dist/core/facades/index.d.ts +0 -10
  322. package/dist/core/runtime/applicationRegistry.d.ts +0 -18
  323. package/dist/entries/database/bindConnection.js +0 -1
  324. package/dist/entries/database/boundConnection.js +0 -1
  325. package/dist/entries/database/defaultConnection.js +0 -1
  326. package/dist/entries/database/namedConnections.js +0 -1
  327. package/dist/entries/database/repositoryConnection.js +0 -1
  328. package/dist/entries/database/transaction.js +0 -1
  329. package/dist/entries/facades.js +0 -711
  330. package/dist/entries/runtime/applicationRegistry.js +0 -1
package/CHANGELOG.md CHANGED
@@ -1,5 +1,27 @@
1
1
  # @getstrata/core changelog
2
2
 
3
+ ## 3.0.3
4
+
5
+ Remove the separate successful-main-CI prerequisite; the release workflow still requires its own full quality gate before publication.
6
+
7
+ Fix npm publication of local release archives by resolving paths absolutely, avoiding GitHub shorthand interpretation. Exercise archive publication dry-runs in CI and before live publication. Preserve the failed v3.0.2 tag; its first publish failed before any package was published.
8
+
9
+ ## 3.0.2
10
+
11
+ Complete the SOLID contract audit: storage deletion is idempotent `Promise<void>` across local and S3 drivers; model misses and required authentication use transport-neutral errors with HTTP 404/401 translation. Middleware accepts only the authentication capability it calls. These API changes and migration steps are documented in `docs/architecture/target-api-migration.md`.
12
+
13
+ Reconcile completed framework ownership and retirement documentation. Clarify the exact-commit main CI prerequisite, early-tag retry procedure, and maintainer release handoff; improve the release admission diagnostic without changing its checks.
14
+
15
+ Remove unused internal renderer/build compatibility helpers and migrate their test imports. Refresh v3 application, auth, discovery, queue, tracing and lifecycle guidance; clearly label retained 2.x qualification evidence.
16
+
17
+ ## 3.0.1
18
+
19
+ Fix release archive packing for npm 12 package-keyed JSON output while retaining npm 11 compatibility. Validate archive identity and integrity, pin the publication toolchain, and exercise actual release packing in CI. The v3.0.0 tag remains unchanged; its failed workflow published no npm packages.
20
+
21
+ ## 3.0.0
22
+
23
+ Breaking application-owned runtime, typed authorization and persistence, immutable starter plans, isolated adapters and authenticated queue handoffs.
24
+
3
25
  ## 2.2.60
4
26
 
5
27
  - Preserve failed-job payloads as PostgreSQL JSONB objects by letting the native driver encode them once. Retain SQLite/MySQL JSON text mapping and readable legacy JSONB strings; timestamps, projections and replay admission/deletion ordering are unchanged.
@@ -1,8 +1,17 @@
1
+ import { type EnvRecord } from "../runtime/appEnv";
2
+ import { type AuditExportSql } from "./exportStore";
1
3
  interface AuditExportConfig {
2
4
  endpoint: string;
3
5
  format: "json" | "cef";
4
6
  batchSize: number;
5
7
  }
6
- declare function resolveAuditExportConfig(): AuditExportConfig | null;
7
- declare function exportPendingAuditLogs(): Promise<number>;
8
- export { exportPendingAuditLogs, resolveAuditExportConfig };
8
+ declare function resolveAuditExportConfig(env?: EnvRecord): AuditExportConfig | null;
9
+ interface AuditExporterOptions {
10
+ readonly runSql: AuditExportSql;
11
+ readonly environment: EnvRecord;
12
+ }
13
+ /** Capture policy once; each SQL scope settles before the outbound HTTP boundary. */
14
+ declare function createAuditExporter(options: AuditExporterOptions): () => Promise<number>;
15
+ declare function exportPendingAuditLogs(runSql: AuditExportSql, environment?: EnvRecord): Promise<number>;
16
+ export type { AuditExportConfig, AuditExporterOptions, AuditExportSql };
17
+ export { createAuditExporter, exportPendingAuditLogs, resolveAuditExportConfig };
@@ -1,3 +1,5 @@
1
+ import type { SelectedSession } from "../contracts/persistence";
2
+ type AuditExportSql = <T>(work: (selected: SelectedSession) => Promise<T>) => Promise<T>;
1
3
  type PendingAuditLog = {
2
4
  id: number;
3
5
  user_id: number | null;
@@ -12,6 +14,8 @@ type PendingAuditLog = {
12
14
  trace_id: string | null;
13
15
  created_at: Date;
14
16
  };
15
- declare function readPendingAuditLogs(batchSize: number): Promise<PendingAuditLog[]>;
16
- declare function acknowledgeAuditLogs(ids: readonly number[]): Promise<void>;
17
+ /** The supplied scope selects the application's connection and trusted SQL policy. */
18
+ declare function readPendingAuditLogs(runSql: AuditExportSql, batchSize: number): Promise<PendingAuditLog[]>;
19
+ declare function acknowledgeAuditLogs(runSql: AuditExportSql, ids: readonly number[]): Promise<void>;
20
+ export type { AuditExportSql };
17
21
  export { acknowledgeAuditLogs, readPendingAuditLogs };
@@ -24,7 +24,7 @@ declare function formatSiemAuditEvent(input: {
24
24
  checksum?: string | null;
25
25
  payload?: Record<string, unknown>;
26
26
  created_at: Date;
27
- }): SiemAuditEvent;
28
- declare function formatCefLine(event: SiemAuditEvent): string;
27
+ }, eventType?: string): SiemAuditEvent;
28
+ declare function formatCefLine(event: SiemAuditEvent, displayName?: string): string;
29
29
  export type { SiemAuditEvent };
30
30
  export { formatCefLine, formatSiemAuditEvent };
@@ -1,13 +1,5 @@
1
1
  declare const MEMBER_ABILITIES: readonly ["profile:read", "auth:tokens:read", "auth:tokens:write", "auth:tokens:delete"];
2
2
  declare const ADMIN_ABILITIES: readonly ["profile:read", "auth:tokens:read", "auth:tokens:write", "auth:tokens:delete", "webhooks:read", "webhooks:write", "audit:read", "audit:export"];
3
3
  declare const PLATFORM_ADMIN_ABILITIES: readonly ["*"];
4
- interface AbilityCatalog {
5
- member: readonly string[];
6
- admin: readonly string[];
7
- resolveForRole(role: string | null | undefined): string[];
8
- }
9
4
  declare function resolveAbilitiesForRole(role: string | null | undefined): string[];
10
- declare function configureAbilityCatalog(next: AbilityCatalog): void;
11
- declare function abilityCatalog(): AbilityCatalog;
12
- export type { AbilityCatalog };
13
- export { ADMIN_ABILITIES, abilityCatalog, configureAbilityCatalog, MEMBER_ABILITIES, PLATFORM_ADMIN_ABILITIES, resolveAbilitiesForRole, };
5
+ export { ADMIN_ABILITIES, MEMBER_ABILITIES, PLATFORM_ADMIN_ABILITIES, resolveAbilitiesForRole };
@@ -1,6 +1,8 @@
1
1
  type CredentialSource = "session" | "bearer" | "basic" | "guest" | null;
2
2
  type AuthUser = {
3
3
  id: number | string;
4
+ readonly name?: string;
5
+ readonly email?: string;
4
6
  role?: string;
5
7
  /** Current state from a trusted directory/guard, never an unverified client claim. */
6
8
  isActive?: boolean;
@@ -0,0 +1,32 @@
1
+ import type { AuthUser, CredentialSource } from "./authContext";
2
+ /** Authentication is required, independent of the transport enforcing it. */
3
+ declare class AuthenticationRequiredError extends Error {
4
+ constructor(message?: string);
5
+ }
6
+ type AuthOutcome = Readonly<{
7
+ status: "absent";
8
+ user: null;
9
+ credentialSource: null;
10
+ }> | Readonly<{
11
+ status: "invalid";
12
+ user: null;
13
+ credentialSource: CredentialSource;
14
+ }> | Readonly<{
15
+ status: "authenticated";
16
+ user: AuthUser;
17
+ credentialSource: CredentialSource;
18
+ }> | Readonly<{
19
+ status: "error";
20
+ user: null;
21
+ credentialSource: CredentialSource;
22
+ error: unknown;
23
+ }>;
24
+ declare const absentAuth: AuthOutcome;
25
+ declare function invalidAuth(credentialSource: CredentialSource): AuthOutcome;
26
+ declare function authenticatedAuth(user: AuthUser, credentialSource: CredentialSource): AuthOutcome;
27
+ /** Validate untyped/custom adapter output before composing or establishing identity. */
28
+ declare function validatedAuthOutcome(input: unknown): AuthOutcome;
29
+ declare function authUserFromOutcome(outcome: AuthOutcome): AuthUser | null;
30
+ declare function authenticateProof(credentialSource: CredentialSource, present: boolean | (() => boolean), resolve: () => AuthUser | null | Promise<AuthUser | null>): Promise<AuthOutcome>;
31
+ export type { AuthOutcome };
32
+ export { AuthenticationRequiredError, absentAuth, authenticatedAuth, authenticateProof, authUserFromOutcome, invalidAuth, validatedAuthOutcome, };
@@ -0,0 +1,22 @@
1
+ import { type AuthOutcome } from "@getstrata/core/auth/authOutcome";
2
+ import { type AuthUser, type CredentialSource } from "./authContext";
3
+ export interface AuthReader {
4
+ authenticate(request?: Request): Promise<AuthOutcome>;
5
+ resolve(request?: Request): Promise<AuthUser | null>;
6
+ resolveWithSource(request?: Request): Promise<{
7
+ user: AuthUser | null;
8
+ credentialSource: CredentialSource;
9
+ }>;
10
+ requireUser(request?: Request): Promise<AuthUser>;
11
+ check(request?: Request): Promise<boolean>;
12
+ user(request?: Request): Promise<AuthUser | null>;
13
+ }
14
+ type Established = Readonly<{
15
+ request: Request;
16
+ user: AuthUser | null;
17
+ credentialSource: CredentialSource;
18
+ }>;
19
+ export declare function runWithEstablishedAuth<T>(request: Request, auth: Omit<Established, "request">, work: () => T): T;
20
+ /** Reads only an explicitly installed established snapshot; never authenticates. */
21
+ export declare const establishedAuthReader: AuthReader;
22
+ export {};
@@ -1,10 +1,26 @@
1
- import type { ServiceContainerLike } from "../contracts/serviceContainer";
1
+ import { type AuthOutcome } from "@getstrata/core/auth/authOutcome";
2
+ import type { AuthAccountLookup, AuthCredentialVerifier, AuthEmailLookup, AuthUserRecord } from "../contracts/authUserDirectory";
3
+ import type { MfaSecretCodec } from "../crypto/mfaSecret";
2
4
  import type { AuthUser } from "./authContext";
3
5
  import type { AuthGuard } from "./guard";
6
+ type BasicAuthGuardOptions = {
7
+ accounts: AuthAccountLookup;
8
+ mfaSecrets: MfaSecretCodec;
9
+ persistRecovery(record: AuthUserRecord, hash: string): Promise<boolean>;
10
+ } & ({
11
+ emailLookup: AuthEmailLookup;
12
+ credentials?: AuthCredentialVerifier;
13
+ } | {
14
+ emailLookup?: AuthEmailLookup;
15
+ credentials: AuthCredentialVerifier;
16
+ });
4
17
  declare class BasicAuthGuard implements AuthGuard {
5
- private readonly container;
6
- constructor(container: ServiceContainerLike);
18
+ private readonly options;
19
+ constructor(options: BasicAuthGuardOptions);
7
20
  private persistRecovery;
21
+ authenticate(request: Request): Promise<AuthOutcome>;
8
22
  resolve(request: Request): Promise<AuthUser | null>;
23
+ private resolveUser;
9
24
  }
25
+ export type { BasicAuthGuardOptions };
10
26
  export { BasicAuthGuard };
@@ -1,5 +1,5 @@
1
1
  import type { AuthUser } from "./authContext";
2
- declare function isEmailVerificationRequired(): boolean;
2
+ declare function isEmailVerificationRequired(env: Readonly<Record<string, string | undefined>>): boolean;
3
3
  /** Missing, undefined, or null means unverified. */
4
4
  declare function hasVerifiedEmail(user: AuthUser): boolean;
5
5
  export { hasVerifiedEmail, isEmailVerificationRequired };
@@ -1,10 +1,24 @@
1
- import type { ServiceContainerLike } from "../contracts/serviceContainer";
1
+ import { type AuthOutcome, absentAuth, authenticatedAuth, authenticateProof, authUserFromOutcome, invalidAuth, validatedAuthOutcome } from "@getstrata/core/auth/authOutcome";
2
+ import type { AuthBearerResolver } from "../contracts/authUserDirectory";
2
3
  import type { AuthUser, CredentialSource } from "./authContext";
4
+ import { requireAuthCapability } from "./requireAuthCapability";
5
+ /** Security composition consumes outcomes; concrete resolve methods are user-only conveniences. */
3
6
  interface AuthGuard {
4
- resolve(request: Request): AuthUser | null | Promise<AuthUser | null>;
7
+ authenticate(request: Request): AuthOutcome | Promise<AuthOutcome>;
5
8
  }
6
9
  declare class GuestGuard implements AuthGuard {
10
+ private readonly options;
11
+ constructor(options: {
12
+ production: boolean;
13
+ allowDevHeaders: boolean;
14
+ abilities: {
15
+ admin: readonly string[];
16
+ member: readonly string[];
17
+ };
18
+ });
19
+ authenticate(request: Request): AuthOutcome;
7
20
  resolve(request: Request): AuthUser | null;
21
+ private resolveUser;
8
22
  }
9
23
  declare class ApiTokenGuard implements AuthGuard {
10
24
  private readonly options;
@@ -12,16 +26,21 @@ declare class ApiTokenGuard implements AuthGuard {
12
26
  token: string;
13
27
  user: AuthUser;
14
28
  });
29
+ authenticate(request: Request): AuthOutcome;
15
30
  resolve(request: Request): AuthUser | null;
31
+ private resolveUser;
16
32
  }
17
33
  declare class DatabaseTokenGuard implements AuthGuard {
18
- private readonly container;
19
- constructor(container: ServiceContainerLike);
34
+ private readonly tokens;
35
+ constructor(tokens: AuthBearerResolver);
36
+ authenticate(request: Request): Promise<AuthOutcome>;
20
37
  resolve(request: Request): Promise<AuthUser | null>;
38
+ private resolveUser;
21
39
  }
22
40
  declare class CompositeGuard implements AuthGuard {
23
41
  private readonly guards;
24
42
  constructor(guards: AuthGuard[]);
43
+ authenticate(request: Request): Promise<AuthOutcome>;
25
44
  resolve(request: Request): Promise<AuthUser | null>;
26
45
  }
27
46
  declare class AuthManager {
@@ -32,6 +51,8 @@ declare class AuthManager {
32
51
  registerGuard(name: string, next: AuthGuard): this;
33
52
  use(name?: string): AuthGuard;
34
53
  guardNames(): string[];
54
+ authenticate(request?: Request): Promise<AuthOutcome>;
55
+ /** User-only convenience; composition must consume authenticate(). */
35
56
  resolve(request?: Request): Promise<AuthUser | null>;
36
57
  resolveWithSource(request?: Request): Promise<{
37
58
  user: AuthUser | null;
@@ -44,5 +65,5 @@ declare class AuthManager {
44
65
  private authenticateRequest;
45
66
  private tryNamedGuards;
46
67
  }
47
- export type { AuthGuard, AuthUser };
48
- export { ApiTokenGuard, AuthManager, CompositeGuard, DatabaseTokenGuard, GuestGuard };
68
+ export type { AuthGuard, AuthOutcome, AuthUser };
69
+ export { ApiTokenGuard, AuthManager, absentAuth, authenticatedAuth, authenticateProof, authUserFromOutcome, CompositeGuard, DatabaseTokenGuard, GuestGuard, invalidAuth, requireAuthCapability, validatedAuthOutcome, };
@@ -1,10 +1,16 @@
1
- declare const INTENDED_URL_COOKIE: string;
1
+ declare const INTENDED_URL_COOKIE = "strata_intended";
2
2
  declare const DEFAULT_INTENDED_URL_TTL_SECONDS: number;
3
- declare function intendedUrlCookieName(): string;
4
- declare function intendedUrlTtlSeconds(): number;
3
+ export interface IntendedUrlCookieOptions {
4
+ readonly cookieName: string;
5
+ readonly ttlSeconds: number;
6
+ readonly production: boolean;
7
+ }
8
+ export declare function intendedUrlCookieOptionsFromEnvironment(env: Readonly<Record<string, string | undefined>>): IntendedUrlCookieOptions;
9
+ declare function intendedUrlCookieName(env: Readonly<Record<string, string | undefined>>): string;
10
+ declare function intendedUrlTtlSeconds(env: Readonly<Record<string, string | undefined>>): number;
5
11
  declare function isStashableIntendedPath(path: string): boolean;
6
- declare function createIntendedUrlCookie(path: string): string | null;
7
- declare function createIntendedUrlCookieFromRequest(request: Request): string | null;
8
- declare function readIntendedUrl(request: Request): string | null;
9
- declare function clearIntendedUrlCookie(): string;
12
+ declare function createIntendedUrlCookie(path: string, options: IntendedUrlCookieOptions): string | null;
13
+ declare function createIntendedUrlCookieFromRequest(request: Request, options: IntendedUrlCookieOptions): string | null;
14
+ declare function readIntendedUrl(request: Request, options: IntendedUrlCookieOptions): string | null;
15
+ declare function clearIntendedUrlCookie(options: IntendedUrlCookieOptions): string;
10
16
  export { clearIntendedUrlCookie, createIntendedUrlCookie, createIntendedUrlCookieFromRequest, DEFAULT_INTENDED_URL_TTL_SECONDS, INTENDED_URL_COOKIE, intendedUrlCookieName, intendedUrlTtlSeconds, isStashableIntendedPath, readIntendedUrl, };
@@ -9,12 +9,13 @@ interface JwtPayload {
9
9
  [key: string]: unknown;
10
10
  }
11
11
  interface SignJwtOptions {
12
- secret?: string;
12
+ secret: string;
13
13
  ttlSeconds?: number;
14
14
  }
15
- declare function resolveJwtSecret(secret?: string): string;
15
+ export declare function jwtOptionsFromEnvironment(env: Readonly<Record<string, string | undefined>>): SignJwtOptions;
16
+ declare function resolveJwtSecret(secret: string): string;
16
17
  declare function jwtTtlSeconds(override?: number): number;
17
- declare function signJwt(payload: JwtPayload, options?: SignJwtOptions): string;
18
- declare function verifyJwt(token: string, secret?: string): JwtPayload | null;
18
+ declare function signJwt(payload: JwtPayload, options: SignJwtOptions): string;
19
+ declare function verifyJwt(token: string, secret: string): JwtPayload | null;
19
20
  export type { JwtPayload, SignJwtOptions };
20
21
  export { jwtTtlSeconds, resolveJwtSecret, signJwt, verifyJwt };
@@ -1,18 +1,19 @@
1
- import type { AuthUserDirectory } from "../contracts/authUserDirectory";
2
- import type { ServiceContainerLike } from "../contracts/serviceContainer";
1
+ import { type AuthOutcome } from "@getstrata/core/auth/authOutcome";
2
+ import type { AuthAccountLookup } from "../contracts/authUserDirectory";
3
3
  import type { AuthUser } from "./authContext";
4
4
  import type { AuthGuard } from "./guard";
5
5
  import { type JwtPayload } from "./jwt";
6
6
  interface JwtGuardOptions {
7
- secret?: string;
8
- directory?: AuthUserDirectory;
9
- container?: ServiceContainerLike;
7
+ secret: string;
8
+ directory: AuthAccountLookup;
10
9
  }
11
10
  declare function authUserFromJwt(payload: JwtPayload): AuthUser;
12
11
  declare class JwtGuard implements AuthGuard {
13
12
  private readonly options;
14
- constructor(options?: JwtGuardOptions | ServiceContainerLike);
13
+ constructor(options: JwtGuardOptions);
14
+ authenticate(request: Request): Promise<AuthOutcome>;
15
15
  resolve(request: Request): Promise<AuthUser | null>;
16
+ private resolveUser;
16
17
  }
17
18
  export type { JwtGuardOptions };
18
19
  export { authUserFromJwt, JwtGuard };
@@ -1,17 +1,20 @@
1
1
  import type { MembershipLookup, OrganizationMemberRole } from "../contracts/membership";
2
+ import type { AuthUser } from "./authContext";
3
+ type MembershipSnapshot = readonly Readonly<{
4
+ organization_id: number;
5
+ role: OrganizationMemberRole;
6
+ }>[];
2
7
  type MembershipContext = {
3
8
  organizationIds: number[];
4
9
  rolesByOrganizationId: Map<number, OrganizationMemberRole>;
5
10
  };
6
11
  declare const membershipContext: import("node:async_hooks").AsyncLocalStorage<MembershipContext>;
7
- declare let membershipRepository: MembershipLookup;
8
- declare function configureMembershipLookup(lookup: MembershipLookup): void;
9
- declare function resolveMembershipLookup(): MembershipLookup;
10
- declare function resetMembershipLookupForTests(): void;
11
- declare function runWithMembershipContext<T>(callback: () => T | Promise<T>): Promise<T | Promise<T>>;
12
+ declare function loadMembershipSnapshot(lookup: MembershipLookup, user: AuthUser | null): Promise<MembershipSnapshot>;
13
+ declare function runWithMembershipSnapshot<T>(snapshot: MembershipSnapshot, callback: () => T): T;
14
+ declare function runWithMembershipContext<T>(lookup: MembershipLookup, user: AuthUser | null, callback: () => T | Promise<T>): Promise<T>;
12
15
  declare function currentOrgRole(organizationId: number): OrganizationMemberRole | null;
13
16
  declare function hasOrgMembership(organizationId: number): boolean;
14
17
  declare function currentOrganizationIds(): number[];
15
18
  declare function hasMinimumOrgRole(organizationId: number, minimum: OrganizationMemberRole): boolean;
16
- export type { MembershipContext };
17
- export { configureMembershipLookup, currentOrganizationIds, currentOrgRole, hasMinimumOrgRole, hasOrgMembership, membershipContext, membershipRepository, resetMembershipLookupForTests, resolveMembershipLookup, runWithMembershipContext, };
19
+ export type { MembershipContext, MembershipSnapshot };
20
+ export { currentOrganizationIds, currentOrgRole, hasMinimumOrgRole, hasOrgMembership, loadMembershipSnapshot, membershipContext, runWithMembershipContext, runWithMembershipSnapshot, };
@@ -1,3 +1,3 @@
1
- import type { Middleware } from "@getstrata/core/http/middleware";
2
- declare function createMembershipContextMiddleware(): Middleware;
3
- export { createMembershipContextMiddleware };
1
+ import type { Middleware } from "../http/middleware";
2
+ import { type MembershipSnapshot } from "./membershipContext";
3
+ export declare function createMembershipContextMiddleware(snapshot: MembershipSnapshot): Middleware;
@@ -1,2 +1 @@
1
- declare function createMembershipMiddleware(): import("../http").Middleware;
2
- export { createMembershipMiddleware };
1
+ export { createMembershipContextMiddleware as createMembershipMiddleware } from "./membershipContextMiddleware";
@@ -3,7 +3,7 @@ import { type AuthUser } from "./authContext";
3
3
  type MembershipRepositoryLike = MembershipLookup;
4
4
  declare class MembershipService {
5
5
  private readonly members;
6
- constructor(members?: MembershipRepositoryLike);
6
+ constructor(members: MembershipRepositoryLike);
7
7
  listOrganizationIdsForUser(userId: number): Promise<number[]>;
8
8
  getOrgRole(userId: number, organizationId: number): Promise<OrganizationMemberRole | null>;
9
9
  requireOrgAccess(organizationId: number, minimumRole?: OrganizationMemberRole, user?: AuthUser | null): Promise<OrganizationMemberRole>;
@@ -1,25 +1,34 @@
1
1
  import type { JwtPayload } from "../jwt";
2
2
  interface OidcDiscovery {
3
- issuer?: string;
4
- authorization_endpoint?: string;
5
- token_endpoint?: string;
6
- jwks_uri?: string;
3
+ readonly issuer?: string;
4
+ readonly authorization_endpoint: string;
5
+ readonly token_endpoint: string;
6
+ readonly jwks_uri: string;
7
7
  }
8
- declare function oidcSafeFetchOptions(url: string): {
8
+ interface OidcNetworkPolicy {
9
+ readonly production: boolean;
10
+ readonly allowPrivate?: boolean;
11
+ }
12
+ interface OidcClient {
13
+ loadDiscovery(issuer: string): Promise<OidcDiscovery>;
14
+ verifyIdToken(token: string, options: OidcVerificationOptions): Promise<JwtPayload>;
15
+ fetchOptions(url: string): ReturnType<typeof oidcSafeFetchOptions>;
16
+ }
17
+ interface OidcVerificationOptions {
18
+ issuer: string;
19
+ clientId: string;
20
+ nonce: string;
21
+ jwksUri: string;
22
+ accessToken?: string;
23
+ }
24
+ declare function createOidcClient(input?: OidcNetworkPolicy): OidcClient;
25
+ declare function oidcSafeFetchOptions(url: string, policy: OidcNetworkPolicy): {
26
+ production: boolean;
9
27
  allowHttp: boolean;
10
28
  allowPrivate: boolean;
11
29
  timeoutMs: number;
12
30
  maxRedirects: number;
13
31
  };
14
- declare function loadOidcDiscovery(issuer: string): Promise<OidcDiscovery>;
15
32
  declare function oidcAccessTokenHash(accessToken: string): string;
16
- declare function verifyOidcIdToken(token: string, options: {
17
- issuer: string;
18
- clientId: string;
19
- nonce: string;
20
- jwksUri: string;
21
- accessToken?: string;
22
- }): Promise<JwtPayload>;
23
- declare function resetOidcDiscoveryCacheForTests(): void;
24
- export type { OidcDiscovery };
25
- export { loadOidcDiscovery, oidcAccessTokenHash, oidcSafeFetchOptions, resetOidcDiscoveryCacheForTests, verifyOidcIdToken, };
33
+ export type { OidcClient, OidcDiscovery, OidcNetworkPolicy, OidcVerificationOptions };
34
+ export { createOidcClient, oidcAccessTokenHash };
@@ -1,4 +1,4 @@
1
- import { resetOidcDiscoveryCacheForTests } from "./oidcIdToken";
1
+ import { type OidcNetworkPolicy } from "./oidcIdToken";
2
2
  import type { OAuthProfile, OAuthProvider } from "./types";
3
3
  interface OidcProviderOptions {
4
4
  name: string;
@@ -6,7 +6,8 @@ interface OidcProviderOptions {
6
6
  clientId: string;
7
7
  clientSecret: string;
8
8
  redirectUri: string;
9
- scopes?: string[];
9
+ scopes?: readonly string[];
10
+ networkPolicy?: OidcNetworkPolicy;
10
11
  }
11
12
  interface OidcHandshake {
12
13
  state: string;
@@ -15,8 +16,9 @@ interface OidcHandshake {
15
16
  }
16
17
  declare function createOidcHandshake(): OidcHandshake;
17
18
  declare class OidcProvider implements OAuthProvider {
18
- private readonly options;
19
19
  readonly name: string;
20
+ private readonly options;
21
+ private readonly client;
20
22
  constructor(options: OidcProviderOptions);
21
23
  getAuthorizationUrl(_state: string, _redirectUri?: string): string;
22
24
  createAuthorization(state?: string, redirectUri?: string): Promise<{
@@ -27,4 +29,4 @@ declare class OidcProvider implements OAuthProvider {
27
29
  exchangeCode(code: string, redirectUri?: string, handshake?: Pick<OidcHandshake, "nonce" | "codeVerifier">): Promise<OAuthProfile>;
28
30
  }
29
31
  export type { OidcHandshake, OidcProviderOptions };
30
- export { createOidcHandshake, OidcProvider, resetOidcDiscoveryCacheForTests };
32
+ export { createOidcHandshake, OidcProvider };
@@ -3,10 +3,12 @@ interface GitHubOAuthOptions {
3
3
  clientId: string;
4
4
  clientSecret: string;
5
5
  redirectUri: string;
6
+ readonly production: boolean;
7
+ readonly userAgent: string;
6
8
  }
7
9
  declare class GitHubOAuthProvider implements OAuthProvider {
8
- private readonly options;
9
10
  readonly name = "github";
11
+ private readonly options;
10
12
  constructor(options: GitHubOAuthOptions);
11
13
  getAuthorizationUrl(state: string, redirectUri?: string): string;
12
14
  exchangeCode(code: string, redirectUri?: string): Promise<OAuthProfile>;
@@ -1,3 +1,4 @@
1
+ import type { DatabaseSession, TransactionSession } from "../database/session";
1
2
  declare const AUTH_ONE_TIME_PURPOSES: {
2
3
  readonly passwordReset: "password_reset";
3
4
  readonly emailVerify: "email_verify";
@@ -8,9 +9,7 @@ declare function generateOneTimeToken(): {
8
9
  hash: string;
9
10
  };
10
11
  declare function hashOneTimeToken(plain: string): string;
11
- type SqlClient = {
12
- unsafe<T>(query: string, params?: readonly unknown[]): Promise<T[]>;
13
- };
12
+ type SqlClient = DatabaseSession | TransactionSession;
14
13
  declare function consumeOneTimeToken(sql: SqlClient, purpose: string, plain: string, now?: Date): Promise<number | null>;
15
14
  declare function revokeUserSessions(sql: SqlClient, userId: number, options?: {
16
15
  revokeApiTokens?: boolean;
@@ -1,8 +1,17 @@
1
- declare const PASSWORD_CONFIRM_COOKIE: string;
1
+ declare const PASSWORD_CONFIRM_COOKIE = "strata_password_confirmed";
2
2
  declare const DEFAULT_PASSWORD_CONFIRM_TTL_SECONDS: number;
3
- declare function passwordConfirmCookieName(): string;
4
- declare function passwordConfirmTtlSeconds(): number;
5
- declare function hasFreshPasswordConfirmation(request: Request, userId: number, authVersion?: number): boolean;
6
- declare function createPasswordConfirmCookie(userId: number, authVersion?: number): string;
7
- declare function clearPasswordConfirmCookie(): string;
3
+ declare function passwordConfirmCookieName(env: Readonly<Record<string, string | undefined>>): string;
4
+ declare function passwordConfirmTtlSeconds(env: Readonly<Record<string, string | undefined>>): number;
5
+ export declare function passwordConfirmOptionsFromEnvironment(env: Readonly<Record<string, string | undefined>>): PasswordConfirmWriteOptions;
6
+ export interface PasswordConfirmReadOptions {
7
+ readonly secret: string;
8
+ readonly cookieName: string;
9
+ readonly ttlSeconds: number;
10
+ }
11
+ export interface PasswordConfirmWriteOptions extends PasswordConfirmReadOptions {
12
+ readonly production: boolean;
13
+ }
14
+ declare function hasFreshPasswordConfirmation(request: Request, userId: number, authVersion: number | undefined, options: PasswordConfirmReadOptions): boolean;
15
+ declare function createPasswordConfirmCookie(userId: number, authVersion: number | undefined, options: PasswordConfirmWriteOptions): string;
16
+ declare function clearPasswordConfirmCookie(options: Pick<PasswordConfirmWriteOptions, "production" | "cookieName">): string;
8
17
  export { clearPasswordConfirmCookie, createPasswordConfirmCookie, DEFAULT_PASSWORD_CONFIRM_TTL_SECONDS, hasFreshPasswordConfirmation, PASSWORD_CONFIRM_COOKIE, passwordConfirmCookieName, passwordConfirmTtlSeconds, };
@@ -1,4 +1,6 @@
1
1
  import type { AuthUserRecord } from "../contracts/authUserDirectory";
2
+ import { type MfaSecretCodec } from "../crypto/mfaSecret";
3
+ import type { DatabaseSession, TransactionSession } from "../database/session";
2
4
  type PasswordLoginFailure = "mfa_required" | "mfa_invalid" | "account_inactive";
3
5
  type PasswordLoginSuccess = {
4
6
  ok: true;
@@ -10,11 +12,9 @@ type PasswordLoginDenied = {
10
12
  };
11
13
  type PasswordLoginResult = PasswordLoginSuccess | PasswordLoginDenied;
12
14
  declare function parseRecoveryHashes(raw: string | null | undefined): string[];
13
- declare function completePasswordLogin(user: Pick<AuthUserRecord, "is_active" | "mfa_enabled" | "mfa_secret" | "mfa_recovery_codes">, options?: {
15
+ declare function completePasswordLogin(user: Pick<AuthUserRecord, "is_active" | "mfa_enabled" | "mfa_secret" | "mfa_recovery_codes">, options: {
14
16
  mfaCode?: string | null;
15
- }): PasswordLoginResult;
16
- declare function persistConsumedRecoveryHash(sql: {
17
- unsafe(query: string, params?: readonly unknown[]): Promise<unknown[]>;
18
- }, userId: number, currentRaw: string | null | undefined, consumedHash: string | undefined): Promise<void>;
17
+ }, mfaSecrets: MfaSecretCodec): PasswordLoginResult;
18
+ declare function persistConsumedRecoveryHash(sql: DatabaseSession | TransactionSession, userId: number, currentRaw: string | null | undefined, consumedHash: string | undefined): Promise<void>;
19
19
  export type { PasswordLoginResult };
20
20
  export { completePasswordLogin, parseRecoveryHashes, persistConsumedRecoveryHash };
@@ -2,8 +2,8 @@ interface PendingMfaChallenge {
2
2
  userId: number;
3
3
  authVersion: number;
4
4
  }
5
- declare function createPendingMfaCookie(userId: number, authVersion: number, secret: string): string;
5
+ declare function createPendingMfaCookie(userId: number, authVersion: number, secret: string, production?: boolean): string;
6
6
  declare function readPendingMfaCookie(request: Request, secret: string): PendingMfaChallenge | null;
7
- declare function clearPendingMfaCookie(): string;
7
+ declare function clearPendingMfaCookie(production?: boolean): string;
8
8
  export type { PendingMfaChallenge };
9
9
  export { clearPendingMfaCookie, createPendingMfaCookie, readPendingMfaCookie };
@@ -1,15 +1,28 @@
1
+ /** Every policy decision is awaited, including synchronous policies. */
2
+ type PolicyDecision = boolean | Promise<boolean>;
1
3
  declare abstract class Policy {
2
- constructor();
3
- view(_user?: unknown, _resource?: unknown): boolean;
4
- create(_user?: unknown): boolean;
5
- update(_user?: unknown, _resource?: unknown): boolean;
6
- delete(_user?: unknown, _resource?: unknown): boolean;
4
+ view(_user?: unknown, _resource?: unknown): PolicyDecision;
5
+ create(_user?: unknown): PolicyDecision;
6
+ update(_user?: unknown, _resource?: unknown): PolicyDecision;
7
+ delete(_user?: unknown, _resource?: unknown): PolicyDecision;
7
8
  }
8
- declare class PolicyGate {
9
+ /** Domain denial; transport adapters decide how to present it. */
10
+ declare class PolicyDeniedError extends Error {
9
11
  constructor();
12
+ }
13
+ type PolicyAction<T> = {
14
+ [K in keyof T]: T[K] extends (...args: never[]) => PolicyDecision ? K : never;
15
+ }[keyof T] & string;
16
+ type PolicyArguments<T> = T extends (...args: infer Args) => PolicyDecision ? Args : never;
17
+ /** Supply a policy map type (or constructor map) for typed custom actions and arguments. */
18
+ declare class PolicyGate<Policies extends {
19
+ [K in keyof Policies]: Policy;
20
+ } = Record<string, Policy>> {
10
21
  private readonly policies;
11
- register(resource: string, policy: Policy): void;
12
- allows(resource: string, action: string, user?: unknown, model?: unknown): boolean;
13
- authorize(resource: string, action: string, user?: unknown, model?: unknown): void;
22
+ constructor(policies?: Policies);
23
+ register<Resource extends keyof Policies & string>(resource: Resource, policy: Policies[Resource]): void;
24
+ allows<Resource extends keyof Policies & string, Action extends PolicyAction<Policies[Resource]>>(resource: Resource, action: Action, user: PolicyArguments<Policies[Resource][Action]>[0], ...model: PolicyArguments<Policies[Resource][Action]> extends [unknown?, ...infer Rest] ? Rest : never): Promise<boolean>;
25
+ authorize<Resource extends keyof Policies & string, Action extends PolicyAction<Policies[Resource]>>(resource: Resource, action: Action, user: PolicyArguments<Policies[Resource][Action]>[0], ...model: PolicyArguments<Policies[Resource][Action]> extends [unknown?, ...infer Rest] ? Rest : never): Promise<void>;
14
26
  }
15
- export { Policy, PolicyGate };
27
+ export type { PolicyAction, PolicyDecision };
28
+ export { Policy, PolicyDeniedError, PolicyGate };
@@ -0,0 +1,3 @@
1
+ /** Composition-time validation for explicitly selected authentication adapters. */
2
+ declare function requireAuthCapability<Capability>(value: unknown, methods: readonly (keyof Capability & string)[], mechanism: string): Capability;
3
+ export { requireAuthCapability };
@@ -1,3 +1,4 @@
1
+ import type { MembershipLookup } from "../contracts/membership";
1
2
  import MembershipService from "./membershipServiceImplementation";
2
- declare function resolveMembershipService(): MembershipService;
3
- export { resolveMembershipService };
3
+ /** Composition supplies the live lookup; no current-application selection. */
4
+ export declare function resolveMembershipService(members: MembershipLookup): MembershipService;