@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
@@ -1,5 +1,5 @@
1
1
  import { type AuthUser, authContext } from "@getstrata/core/auth/authContext";
2
- import type { AuthManager } from "@getstrata/core/auth/guard";
3
- declare function createAuthMiddleware(auth: AuthManager): (request: Request, next: () => Promise<Response>) => Promise<Response>;
2
+ import type { AuthReader } from "../auth/authReader";
3
+ declare function createAuthMiddleware(auth: Pick<AuthReader, "authenticate">): (request: Request, next: () => Promise<Response>) => Promise<Response>;
4
4
  export type { AuthUser };
5
5
  export { authContext, createAuthMiddleware };
@@ -1,5 +1,5 @@
1
- import type { AuthManager } from "@getstrata/core/auth/guard";
2
1
  import type { Policy, PolicyGate } from "@getstrata/core/auth/policy";
2
+ import type { AuthReader } from "../auth/authReader";
3
3
  import type { Middleware } from "./middleware";
4
- declare function createAuthorizeMiddleware(gate: PolicyGate, auth: AuthManager, resource: string, action: keyof Policy): Middleware;
4
+ declare function createAuthorizeMiddleware(gate: Pick<PolicyGate, "allows">, auth: Pick<AuthReader, "resolve">, resource: string, action: keyof Policy): Middleware;
5
5
  export { createAuthorizeMiddleware };
@@ -1,4 +1,4 @@
1
1
  import type { Middleware } from "./middleware";
2
- declare function resolveMaxBodyBytes(): number;
2
+ declare function resolveMaxBodyBytes(value?: string): number;
3
3
  declare function createBodySizeLimitMiddleware(maxBytes?: number): Middleware;
4
4
  export { createBodySizeLimitMiddleware, resolveMaxBodyBytes };
@@ -1,2 +1,7 @@
1
- declare function conditionalJsonResponse(request: Request | undefined, data: unknown, init?: ResponseInit): Response;
2
- export { conditionalJsonResponse };
1
+ type JsonResponsePolicy = Readonly<{
2
+ etagEnabled: boolean;
3
+ }>;
4
+ declare function snapshotJsonResponsePolicy(policy: JsonResponsePolicy): JsonResponsePolicy;
5
+ declare function conditionalJsonResponse(request: Request | undefined, data: unknown, policy: JsonResponsePolicy, init?: ResponseInit): Response;
6
+ export type { JsonResponsePolicy };
7
+ export { conditionalJsonResponse, snapshotJsonResponsePolicy };
@@ -1,8 +1,11 @@
1
+ import type { FrontendMode } from "../runtime/frontendMode";
1
2
  type CspDirectiveValue = string | string[] | false;
2
3
  interface ContentSecurityPolicyDirectives {
3
4
  [directive: string]: CspDirectiveValue;
4
5
  }
5
6
  interface ContentSecurityPolicyOptions {
7
+ readonly frontendMode?: FrontendMode;
8
+ readonly production?: boolean;
6
9
  /** Full HTML Content-Security-Policy. Replaces the HTMX/SPA baseline. */
7
10
  csp?: string;
8
11
  /** Alias for `csp`. */
@@ -16,12 +19,10 @@ interface ResolveContentSecurityPolicyOptions extends ContentSecurityPolicyOptio
16
19
  /** HTMX 2.0.4 default indicator CSS (line-continued string inside insertIndicatorStyles). */
17
20
  declare const HTMX_2_0_4_INDICATOR_STYLE_HASH = "'sha256-bsV5JivYxvGywDAZ22EZJKBFip65Ng9xoJVLbBg7bdo='";
18
21
  declare function generateCspNonce(): string;
19
- declare function configureContentSecurityPolicy(options: ContentSecurityPolicyOptions): void;
20
- declare function resetContentSecurityPolicyForTests(): void;
21
22
  declare function strictApiContentSecurityPolicy(): string;
22
23
  declare function serverHtmxContentSecurityPolicy(nonce?: string): string;
23
24
  declare function spaContentSecurityPolicy(nonce?: string): string;
24
25
  declare function resolveHtmlContentSecurityPolicy(options?: ResolveContentSecurityPolicyOptions): string;
25
26
  declare function resolveContentSecurityPolicy(response: Response, options?: ResolveContentSecurityPolicyOptions): string;
26
27
  export type { ContentSecurityPolicyDirectives, ContentSecurityPolicyOptions };
27
- export { configureContentSecurityPolicy, generateCspNonce, HTMX_2_0_4_INDICATOR_STYLE_HASH, resetContentSecurityPolicyForTests, resolveContentSecurityPolicy, resolveHtmlContentSecurityPolicy, serverHtmxContentSecurityPolicy, spaContentSecurityPolicy, strictApiContentSecurityPolicy, };
28
+ export { generateCspNonce, HTMX_2_0_4_INDICATOR_STYLE_HASH, resolveContentSecurityPolicy, resolveHtmlContentSecurityPolicy, serverHtmxContentSecurityPolicy, spaContentSecurityPolicy, strictApiContentSecurityPolicy, };
@@ -5,9 +5,10 @@ interface CorsConfig {
5
5
  allowedHeaders: string[];
6
6
  maxAgeSeconds: number;
7
7
  }
8
- /** Additional application-approved request headers; defaults and origins remain unchanged. */
8
+ /** Explicit application-owned origin and request-header policy. Omitted origins grant no cross-origin access. */
9
9
  interface CorsOptions {
10
10
  additionalAllowedHeaders?: readonly string[];
11
+ allowedOrigins?: readonly string[];
11
12
  }
12
13
  declare function resolveCorsConfig(options?: CorsOptions): CorsConfig;
13
14
  declare function createCorsMiddleware(options?: CorsOptions): Middleware;
@@ -1,8 +1,13 @@
1
+ import { type CsrfTokenOptions } from "./csrfToken";
1
2
  import type { Middleware } from "./middleware";
2
3
  interface CsrfOptions {
3
4
  /** Explicit public origin for TLS offload; requires matching URL authority and Host on every request. */
4
5
  targetOrigin?: string;
6
+ readonly token?: CsrfTokenOptions;
7
+ readonly allowDevelopmentHeaders?: boolean;
8
+ readonly samlAcsUrl?: string;
5
9
  }
6
- declare function createCsrfMiddleware(options?: CsrfOptions): Middleware;
10
+ export declare function csrfMiddlewareOptionsFromEnvironment(env: Readonly<Record<string, string | undefined>>): CsrfOptions;
11
+ declare function createCsrfMiddleware(options: CsrfOptions): Middleware;
7
12
  export type { CsrfOptions };
8
13
  export { createCsrfMiddleware };
@@ -1,15 +1,25 @@
1
- declare const CSRF_COOKIE: string;
2
- declare function csrfCookieName(): string;
3
- declare function createCsrfTokenCookie(): {
1
+ import { type EnvRecord } from "../runtime/appEnv";
2
+ declare const CSRF_COOKIE = "strata_csrf";
3
+ interface CsrfTokenOptions {
4
+ readonly secret: string;
5
+ readonly cookieName: string;
6
+ readonly production: boolean;
7
+ }
8
+ /** Resolve once from the application's captured environment, never a later request. */
9
+ declare function csrfTokenOptionsFromEnvironment(env: EnvRecord): CsrfTokenOptions;
10
+ declare function csrfCookieName(options: CsrfTokenOptions): string;
11
+ declare function verifyCsrfTokenValue(token: string, options: CsrfTokenOptions): boolean;
12
+ declare function createCsrfTokenCookie(options: CsrfTokenOptions): {
4
13
  token: string;
5
14
  cookie: string;
6
15
  };
7
- declare function resolveCsrfToken(request: Request): {
16
+ declare function resolveCsrfToken(request: Request, options: CsrfTokenOptions): {
8
17
  token: string;
9
18
  cookie?: string;
10
19
  };
11
20
  declare function readSubmittedCsrfToken(request: Request): string | null;
12
21
  declare function readSubmittedCsrfTokenFromBody(request: Request): Promise<string | null>;
13
- declare function verifyCsrfToken(request: Request, submittedToken: string | null): boolean;
14
- declare function resolveCsrfTokenForRequest(request: Request): string;
15
- export { CSRF_COOKIE, createCsrfTokenCookie, csrfCookieName, readSubmittedCsrfToken, readSubmittedCsrfTokenFromBody, resolveCsrfToken, resolveCsrfTokenForRequest, verifyCsrfToken, };
22
+ declare function verifyCsrfToken(request: Request, submittedToken: string | null, options: CsrfTokenOptions): boolean;
23
+ declare function resolveCsrfTokenForRequest(request: Request, options: CsrfTokenOptions): string;
24
+ export type { CsrfTokenOptions };
25
+ export { CSRF_COOKIE, createCsrfTokenCookie, csrfCookieName, csrfTokenOptionsFromEnvironment, readSubmittedCsrfToken, readSubmittedCsrfTokenFromBody, resolveCsrfToken, resolveCsrfTokenForRequest, verifyCsrfToken, verifyCsrfTokenValue, };
@@ -0,0 +1,4 @@
1
+ import { type HttpError } from "@getstrata/core/errors/http";
2
+ /** Transport-only status mapping; persistence never imports response classes. */
3
+ declare function mapDatabaseHttpError(error: unknown): HttpError;
4
+ export { mapDatabaseHttpError };
@@ -3,7 +3,8 @@ interface EtagVersioned {
3
3
  updated_at?: Date | string | null;
4
4
  created_at?: Date | string | null;
5
5
  }
6
- declare function isEtagEnabled(): boolean;
6
+ /** Parse an explicit entrypoint value; omission retains the enabled default. */
7
+ declare function isEtagEnabled(value?: string): boolean;
7
8
  declare function computeEtagFromJson(data: unknown): string;
8
9
  declare function etagFromResource(resource: EtagVersioned): string;
9
10
  declare function etagValuesMatch(left: string, right: string): boolean;
@@ -13,6 +14,8 @@ declare function assertIfMatch(request: Request, etag: string, options?: {
13
14
  required?: boolean;
14
15
  }): void;
15
16
  declare function notModifiedResponse(etag: string): Response;
16
- declare function applyConditionalGet(request: Request, response: Response, etag: string): Response;
17
+ declare function applyConditionalGet(request: Request, response: Response, etag: string, policy?: Readonly<{
18
+ etagEnabled: boolean;
19
+ }>): Response;
17
20
  export type { EtagVersioned };
18
21
  export { applyConditionalGet, assertIfMatch, computeEtagFromJson, etagFromResource, etagValuesMatch, ifMatchSatisfied, ifNoneMatchSatisfied, isEtagEnabled, notModifiedResponse, };
@@ -1,3 +1,3 @@
1
1
  import type { Middleware } from "./middleware";
2
- declare function createFlashMiddleware(): Middleware;
2
+ declare function createFlashMiddleware(options: import("./flashSession").FlashSessionOptions): Middleware;
3
3
  export { createFlashMiddleware };
@@ -1,14 +1,20 @@
1
- declare const FLASH_COOKIE: string;
2
- declare function flashCookieName(): string;
1
+ declare const FLASH_COOKIE = "strata_flash";
2
+ export interface FlashSessionOptions {
3
+ readonly cookieName: string;
4
+ readonly secret: string;
5
+ readonly production: boolean;
6
+ }
7
+ export declare function flashSessionOptionsFromEnvironment(env: Readonly<Record<string, string | undefined>>): FlashSessionOptions;
8
+ declare function flashCookieName(env: Readonly<Record<string, string | undefined>>): string;
3
9
  type FlashLevel = "success" | "error" | "info";
4
10
  interface FlashMessage {
5
11
  level: FlashLevel;
6
12
  message: string;
7
13
  }
8
- declare function createFlashCookie(message: FlashMessage): string;
9
- declare function clearFlashCookie(): string;
10
- declare function pullFlash(request: Request): FlashMessage | null;
11
- declare function flashResponse(response: Response, message: FlashMessage): Response;
12
- declare function withFlashClear(response: Response): Response;
14
+ declare function createFlashCookie(message: FlashMessage, options: FlashSessionOptions): string;
15
+ declare function clearFlashCookie(options: FlashSessionOptions): string;
16
+ declare function pullFlash(request: Request, options: FlashSessionOptions): FlashMessage | null;
17
+ declare function flashResponse(response: Response, message: FlashMessage, options: FlashSessionOptions): Response;
18
+ declare function withFlashClear(response: Response, options: FlashSessionOptions): Response;
13
19
  export type { FlashLevel, FlashMessage };
14
20
  export { clearFlashCookie, createFlashCookie, FLASH_COOKIE, flashCookieName, flashResponse, pullFlash, withFlashClear, };
@@ -2,7 +2,7 @@ export { BadRequestError, ConflictError, ForbiddenError, HttpError, NotFoundErro
2
2
  export type { PaginatedResult, PaginationMeta } from "../pagination";
3
3
  export { createAuthMiddleware } from "./authMiddleware";
4
4
  export { createAuthorizeMiddleware } from "./authorizeMiddleware";
5
- export { conditionalJsonResponse } from "./conditionalResponse";
5
+ export { conditionalJsonResponse, type JsonResponsePolicy } from "./conditionalResponse";
6
6
  export type { EtagVersioned } from "./etag";
7
7
  export { applyConditionalGet, assertIfMatch, computeEtagFromJson, etagFromResource, etagValuesMatch, ifMatchSatisfied, ifNoneMatchSatisfied, isEtagEnabled, notModifiedResponse, } from "./etag";
8
8
  export { FormRequest, QueryFormRequest } from "./formRequest";
@@ -1,7 +1,7 @@
1
1
  import { type MemoryThrottleStorageOptions } from "../runtime/boundedThrottleStore";
2
2
  import type { DisposableMemoryThrottle } from "./memoryThrottleMiddleware";
3
- import { type DisposableThrottle, type RedisThrottleClient } from "./throttleMiddleware";
4
- interface LoginThrottleOptions extends MemoryThrottleStorageOptions {
3
+ import { type DisposableThrottle, type RedisThrottleClient, type ThrottleIdentityPolicy } from "./throttleMiddleware";
4
+ interface LoginThrottleOptions extends MemoryThrottleStorageOptions, ThrottleIdentityPolicy {
5
5
  redisUrl?: string;
6
6
  maxAttempts: number;
7
7
  decaySeconds: number;
@@ -9,7 +9,7 @@ interface LoginThrottleOptions extends MemoryThrottleStorageOptions {
9
9
  commandTimeoutMs?: number;
10
10
  redisClient?: RedisThrottleClient;
11
11
  }
12
- declare function resolveLoginIdentity(request: Request): string;
12
+ declare function resolveLoginIdentity(request: Request, trustForwardedFor?: boolean): string;
13
13
  declare function resolveLoginEmail(request: Request): Promise<string>;
14
14
  declare function createMemoryLoginThrottleMiddleware(options: LoginThrottleOptions): DisposableMemoryThrottle;
15
15
  declare function createLoginThrottleMiddleware(options: LoginThrottleOptions): DisposableThrottle;
@@ -1,7 +1,7 @@
1
1
  import { type MemoryThrottleStats, type MemoryThrottleStorageOptions } from "../runtime/boundedThrottleStore";
2
2
  import type { Middleware } from "./middleware";
3
- import { type ThrottleQuotaPolicy } from "./throttleMiddleware";
4
- interface MemoryThrottleOptions extends MemoryThrottleStorageOptions {
3
+ import { type ThrottleIdentityPolicy, type ThrottleQuotaPolicy } from "./throttleMiddleware";
4
+ interface MemoryThrottleOptions extends MemoryThrottleStorageOptions, ThrottleIdentityPolicy {
5
5
  maxAttempts: number;
6
6
  decaySeconds: number;
7
7
  keyPrefix?: string;
@@ -1,3 +1,4 @@
1
+ import { type UploadPolicy } from "./uploads";
1
2
  interface ParsedUpload {
2
3
  fileName: string;
3
4
  mimeType: string;
@@ -5,7 +6,7 @@ interface ParsedUpload {
5
6
  contents: Uint8Array;
6
7
  }
7
8
  declare function sanitizeUploadFileName(name: string): string;
8
- declare function validateUploadFile(file: File, fieldName?: string): Promise<ParsedUpload>;
9
- declare function parseMultipartUpload(request: Request, fieldName?: string): Promise<ParsedUpload>;
9
+ declare function validateUploadFile(file: File, fieldName?: string, policy?: UploadPolicy): Promise<ParsedUpload>;
10
+ declare function parseMultipartUpload(request: Request, fieldName?: string, policy?: UploadPolicy): Promise<ParsedUpload>;
10
11
  export type { ParsedUpload };
11
12
  export { parseMultipartUpload, sanitizeUploadFileName, validateUploadFile };
@@ -1,3 +1,4 @@
1
+ import type { WebErrorView } from "../view/webErrorView";
1
2
  type RequestMeta = {
2
3
  ipAddress: string | null;
3
4
  /** Immediate socket peer recorded by the transport; never a forwarded client header. */
@@ -10,6 +11,10 @@ type RequestMeta = {
10
11
  routeTemplate?: string;
11
12
  /** API error contracts take precedence over client content negotiation. */
12
13
  errorFormat?: "json";
14
+ /** Captured owner policy; carried only within this request. */
15
+ webErrorView?: WebErrorView;
16
+ viewsEnabled?: boolean;
17
+ webErrorsProduction?: boolean;
13
18
  flash?: {
14
19
  level: string;
15
20
  message: string;
@@ -1,4 +1,4 @@
1
1
  import type { AbilityChecker } from "../auth/abilityChecker";
2
2
  import type { Middleware } from "./middleware";
3
- declare function createRequireAbilityMiddleware(abilityChecker: AbilityChecker): (ability: string) => Middleware;
3
+ declare function createRequireAbilityMiddleware(abilityChecker: AbilityChecker, viewsEnabled?: boolean): (ability: string) => Middleware;
4
4
  export { createRequireAbilityMiddleware };
@@ -1,4 +1,4 @@
1
- import type { AuthManager } from "@getstrata/core/auth/guard";
1
+ import type { AuthReader } from "../auth/authReader";
2
2
  import type { Middleware } from "./middleware";
3
- declare function createRequireAuthMiddleware(auth: AuthManager): Middleware;
3
+ declare function createRequireAuthMiddleware(auth: Pick<AuthReader, "check">): Middleware;
4
4
  export { createRequireAuthMiddleware };
@@ -1,5 +1,6 @@
1
+ import { type PasswordConfirmReadOptions } from "@getstrata/core/auth/passwordConfirmCookie";
1
2
  import type { Middleware } from "./middleware";
2
3
  declare const PASSWORD_CONFIRM_MESSAGE = "Password confirmation required.";
3
4
  declare const PASSWORD_CONFIRM_PATH = "/confirm-password";
4
- declare function createRequirePasswordConfirmMiddleware(): Middleware;
5
+ declare function createRequirePasswordConfirmMiddleware(options: PasswordConfirmReadOptions): Middleware;
5
6
  export { createRequirePasswordConfirmMiddleware, PASSWORD_CONFIRM_MESSAGE, PASSWORD_CONFIRM_PATH };
@@ -1,6 +1,6 @@
1
- import type { AuthManager } from "@getstrata/core/auth/guard";
1
+ import type { AuthReader } from "../auth/authReader";
2
2
  import type { Middleware } from "./middleware";
3
3
  declare const UNVERIFIED_MESSAGE = "Your email address is not verified.";
4
4
  declare const VERIFY_NOTICE_PATH = "/email/verify";
5
- declare function createRequireVerifiedMiddleware(auth?: AuthManager): Middleware;
5
+ declare function createRequireVerifiedMiddleware(auth: AuthReader | undefined, required: boolean, intendedOptions: import("../auth/intendedUrlCookie").IntendedUrlCookieOptions): Middleware;
6
6
  export { createRequireVerifiedMiddleware, UNVERIFIED_MESSAGE, VERIFY_NOTICE_PATH };
@@ -1,4 +1,4 @@
1
- import type { AuthManager } from "@getstrata/core/auth/guard";
1
+ import type { AuthReader } from "../auth/authReader";
2
2
  import type { Middleware } from "./middleware";
3
- declare function createRequireWebAuthMiddleware(auth: AuthManager): Middleware;
3
+ declare function createRequireWebAuthMiddleware(auth: AuthReader, intendedOptions: import("../auth/intendedUrlCookie").IntendedUrlCookieOptions): Middleware;
4
4
  export { createRequireWebAuthMiddleware };
@@ -1,3 +1,4 @@
1
+ import { type WebErrorResponseOptions } from "@getstrata/core/http/webErrorResponse";
1
2
  import type { Middleware } from "./middleware";
2
3
  declare function jsonResponse(data: unknown, init?: ResponseInit): Response;
3
4
  /** Explicit private payloads (identity, credentials and CSRF); public JSON defaults stay unchanged. */
@@ -5,10 +6,10 @@ declare function privateJsonResponse(data: unknown, init?: ResponseInit): Respon
5
6
  declare function createdResponse(data: unknown, init?: ResponseInit): Response;
6
7
  declare function noContentResponse(): Response;
7
8
  declare function errorResponse(error: unknown): Response;
8
- declare function withErrorHandling<THandler extends (request: Request) => Response | Promise<Response>>(handler: THandler): (...args: Parameters<THandler>) => Promise<Response>;
9
- declare function withErrorHandling<TArgs extends unknown[]>(handler: (...args: TArgs) => Response | Promise<Response>): (...args: TArgs) => Promise<Response>;
9
+ declare function withErrorHandling<THandler extends (request: Request) => Response | Promise<Response>>(handler: THandler, options?: WebErrorResponseOptions): (...args: Parameters<THandler>) => Promise<Response>;
10
+ declare function withErrorHandling<TArgs extends unknown[]>(handler: (...args: TArgs) => Response | Promise<Response>, options?: WebErrorResponseOptions): (...args: TArgs) => Promise<Response>;
10
11
  declare function withJsonErrorHandling<THandler extends (request: Request) => Response | Promise<Response>>(handler: THandler): (...args: Parameters<THandler>) => Promise<Response>;
11
12
  declare function withJsonErrorHandling<TArgs extends unknown[]>(handler: (...args: TArgs) => Response | Promise<Response>): (...args: TArgs) => Promise<Response>;
12
13
  declare function createJsonErrorMiddleware(): Middleware;
13
- declare function createWebErrorMiddleware(): Middleware;
14
+ declare function createWebErrorMiddleware(options?: WebErrorResponseOptions): Middleware;
14
15
  export { createdResponse, createJsonErrorMiddleware, createWebErrorMiddleware, errorResponse, jsonResponse, noContentResponse, privateJsonResponse, withErrorHandling, withJsonErrorHandling, };
@@ -1,7 +1,8 @@
1
1
  import { type MemoryThrottleStorageOptions } from "../runtime/boundedThrottleStore";
2
2
  import type { Middleware } from "./middleware";
3
- import { type RedisThrottleClient } from "./throttleMiddleware";
4
- interface ScimThrottleOptions extends MemoryThrottleStorageOptions {
3
+ import { type RedisThrottleClient, type ThrottleIdentityPolicy } from "./throttleMiddleware";
4
+ interface ScimThrottleOptions extends MemoryThrottleStorageOptions, ThrottleIdentityPolicy {
5
+ resolveTenant?: (token: string) => number | null;
5
6
  redisUrl?: string;
6
7
  maxAttempts: number;
7
8
  decaySeconds: number;
@@ -9,7 +10,7 @@ interface ScimThrottleOptions extends MemoryThrottleStorageOptions {
9
10
  redisClient?: RedisThrottleClient;
10
11
  keyPrefix?: string;
11
12
  }
12
- declare function resolveScimIdentity(request: Request): string;
13
+ declare function resolveScimIdentity(request: Request, trustForwardedFor?: boolean): string;
13
14
  declare function createScimThrottleMiddleware(options: ScimThrottleOptions): Middleware & {
14
15
  dispose: () => void;
15
16
  stats: () => import("./memoryThrottleMiddleware").MemoryThrottleStats | undefined;
@@ -1,3 +1,5 @@
1
+ import type { AuthUser } from "@getstrata/core/auth/authContext";
2
+ import type { AuthReader } from "@getstrata/core/auth/authReader";
1
3
  import type { Policy } from "@getstrata/core/auth/policy";
2
4
  import type { RouteRequest } from "./route";
3
5
  interface RouteModelAuthorization {
@@ -7,7 +9,12 @@ interface RouteModelAuthorization {
7
9
  /** Opt in (`true`) or out (`false`) of GET ETags. HTML and composites are off by default. */
8
10
  etag?: boolean;
9
11
  }
10
- declare function securedBindRouteModel<TParams extends Record<string, string>, TModel, TParam extends keyof TParams & string>(param: TParam, resolver: (id: number, request: RouteRequest<TParams>) => Promise<TModel>, authorization: RouteModelAuthorization, handler: (request: RouteRequest<TParams>, model: TModel) => Response | Promise<Response>): (request: RouteRequest<TParams>) => Promise<Response>;
11
- declare function securedBindRouteModelByKey<TParams extends Record<string, string>, TModel, TParam extends keyof TParams & string>(param: TParam, resolver: (key: string, request: RouteRequest<TParams>) => Promise<TModel>, authorization: RouteModelAuthorization, handler: (request: RouteRequest<TParams>, model: TModel) => Response | Promise<Response>): (request: RouteRequest<TParams>) => Promise<Response>;
12
- export type { RouteModelAuthorization };
12
+ interface RouteModelBindingPorts {
13
+ readonly auth: Pick<AuthReader, "resolve">;
14
+ readonly authorize: (resource: string, action: keyof Policy, user: AuthUser | null, model: unknown) => void | Promise<void>;
15
+ readonly etagEnabled: boolean;
16
+ }
17
+ declare function securedBindRouteModel<TParams extends Record<string, string>, TModel, TParam extends keyof TParams & string>(param: TParam, resolver: (id: number, request: RouteRequest<TParams>) => Promise<TModel>, authorization: RouteModelAuthorization, handler: (request: RouteRequest<TParams>, model: TModel) => Response | Promise<Response>, ports: RouteModelBindingPorts): (request: RouteRequest<TParams>) => Promise<Response>;
18
+ declare function securedBindRouteModelByKey<TParams extends Record<string, string>, TModel, TParam extends keyof TParams & string>(param: TParam, resolver: (key: string, request: RouteRequest<TParams>) => Promise<TModel>, authorization: RouteModelAuthorization, handler: (request: RouteRequest<TParams>, model: TModel) => Response | Promise<Response>, ports: RouteModelBindingPorts): (request: RouteRequest<TParams>) => Promise<Response>;
19
+ export type { RouteModelAuthorization, RouteModelBindingPorts };
13
20
  export { securedBindRouteModel, securedBindRouteModelByKey };
@@ -1,6 +1,5 @@
1
1
  import type { ContentSecurityPolicyOptions } from "@getstrata/core/http/contentSecurityPolicy";
2
- import { configureContentSecurityPolicy } from "@getstrata/core/http/contentSecurityPolicy";
3
2
  import type { Middleware } from "./middleware";
4
3
  declare function createSecurityHeadersMiddleware(options?: ContentSecurityPolicyOptions): Middleware;
5
4
  export type { ContentSecurityPolicyOptions };
6
- export { configureContentSecurityPolicy, createSecurityHeadersMiddleware };
5
+ export { createSecurityHeadersMiddleware };
@@ -3,11 +3,13 @@ interface TemporarySignedUrlOptions {
3
3
  expiresInSeconds?: number;
4
4
  query?: Record<string, string | number>;
5
5
  }
6
- declare function signedUrl(path: string, query?: Record<string, string | number>): string;
7
- declare function temporarySignedUrl(path: string, expiresInSeconds: number, query?: Record<string, string | number>): string;
8
- declare function absoluteTemporarySignedUrl(path: string, expiresInSeconds: number, query?: Record<string, string | number>, origin?: string): string;
9
- declare function hasValidSignature(input: Request | URL | string): boolean;
10
- declare function assertValidSignature(input: Request | URL | string): void;
11
- declare function createValidateSignatureMiddleware(): Middleware;
6
+ declare function signedUrl(path: string, query: Record<string, string | number> | undefined, secret: string): string;
7
+ declare function temporarySignedUrl(path: string, expiresInSeconds: number, query: Record<string, string | number> | undefined, secret: string): string;
8
+ declare function absoluteTemporarySignedUrl(path: string, expiresInSeconds: number, query: Record<string, string | number> | undefined, origin: string, secret: string): string;
9
+ declare function hasValidSignature(input: Request | URL | string, secret: string): boolean;
10
+ declare function assertValidSignature(input: Request | URL | string, secret: string): void;
11
+ declare function createValidateSignatureMiddleware(options: {
12
+ readonly secret: string;
13
+ }): Middleware;
12
14
  export type { TemporarySignedUrlOptions };
13
15
  export { absoluteTemporarySignedUrl, assertValidSignature, createValidateSignatureMiddleware, hasValidSignature, signedUrl, temporarySignedUrl, };
@@ -10,7 +10,11 @@ interface ThrottleQuotaContext {
10
10
  }
11
11
  /** A synchronous application-owned attempt limit; the window remains fixed. */
12
12
  type ThrottleQuotaPolicy = (context: ThrottleQuotaContext) => number;
13
- interface ThrottleOptions {
13
+ interface ThrottleIdentityPolicy {
14
+ readonly namespace?: string;
15
+ readonly trustForwardedFor?: boolean;
16
+ }
17
+ interface ThrottleOptions extends ThrottleIdentityPolicy {
14
18
  redisUrl: string;
15
19
  maxAttempts: number;
16
20
  decaySeconds: number;
@@ -19,9 +23,9 @@ interface ThrottleOptions {
19
23
  redisClient?: RedisThrottleClient;
20
24
  quotaPolicy?: ThrottleQuotaPolicy;
21
25
  }
22
- declare function resolveThrottleIdentity(request: Request): string;
26
+ declare function resolveThrottleIdentity(request: Request, trustForwardedFor?: boolean): string;
23
27
  type RedisThrottleClient = Pick<RedisClient, "send">;
24
- declare function redisThrottleKey(request: Request, prefix: string, identity: string, tenantId?: number | null): string;
28
+ declare function redisThrottleKey(request: Request, prefix: string, identity: string, tenantId?: number | null, namespace?: string): string;
25
29
  declare function consumeRedisThrottle(client: RedisThrottleClient, key: string, decaySeconds: number, timeoutMs?: number, signal?: AbortSignal): Promise<number>;
26
30
  /** Reuse a healthy connection; failed owned connections are recreated on the next request. */
27
31
  declare function createRedisThrottleConsumer(options: Pick<ThrottleOptions, "redisUrl" | "redisClient" | "commandTimeoutMs">): ((key: string, decaySeconds: number) => Promise<number>) & {
@@ -32,7 +36,7 @@ type DisposableThrottle = Middleware & {
32
36
  dispose(): void;
33
37
  };
34
38
  declare function throttleUnavailableResponse(): Response;
35
- declare function resolveThrottleQuota(request: Request, options: Pick<ThrottleOptions, "maxAttempts" | "quotaPolicy">, identity?: string): number;
39
+ declare function resolveThrottleQuota(request: Request, options: Pick<ThrottleOptions, "maxAttempts" | "quotaPolicy" | "trustForwardedFor">, identity?: string): number;
36
40
  declare function createThrottleMiddleware(options: ThrottleOptions): DisposableThrottle;
37
- export type { DisposableThrottle, RedisThrottleClient, ThrottleOptions, ThrottleQuotaContext, ThrottleQuotaPolicy, };
41
+ export type { DisposableThrottle, RedisThrottleClient, ThrottleIdentityPolicy, ThrottleOptions, ThrottleQuotaContext, ThrottleQuotaPolicy, };
38
42
  export { consumeRedisThrottle, createRedisThrottleConsumer, createThrottleMiddleware, redisThrottleKey, resolveThrottleIdentity, resolveThrottleQuota, throttleUnavailableResponse, };
@@ -1,5 +1,11 @@
1
1
  declare const DEFAULT_MAX_UPLOAD_BYTES: number;
2
2
  declare const ALLOWED_UPLOAD_MIME_TYPES: Set<string>;
3
- declare function resolveMaxUploadBytes(): number;
4
- declare function isAllowedMimeType(mimeType: string): boolean;
5
- export { ALLOWED_UPLOAD_MIME_TYPES, DEFAULT_MAX_UPLOAD_BYTES, isAllowedMimeType, resolveMaxUploadBytes, };
3
+ interface UploadPolicy {
4
+ readonly maxBytes: number;
5
+ readonly allowUnknownMime: boolean;
6
+ }
7
+ declare const DEFAULT_UPLOAD_POLICY: UploadPolicy;
8
+ declare function resolveMaxUploadBytes(value?: string): number;
9
+ declare function isAllowedMimeType(mimeType: string, allowUnknownMime?: boolean): boolean;
10
+ export type { UploadPolicy };
11
+ export { ALLOWED_UPLOAD_MIME_TYPES, DEFAULT_MAX_UPLOAD_BYTES, DEFAULT_UPLOAD_POLICY, isAllowedMimeType, resolveMaxUploadBytes, };
@@ -1,7 +1,13 @@
1
1
  import { type HttpError } from "@getstrata/core/errors/http";
2
+ import { type WebErrorView } from "../view/webErrorView";
3
+ interface WebErrorResponseOptions {
4
+ enabled?: boolean;
5
+ production?: boolean;
6
+ render?: WebErrorView;
7
+ }
2
8
  type FieldErrors = Record<string, string[]>;
3
9
  declare function normalizeFieldErrors(details: unknown): FieldErrors;
4
10
  declare function logServerError(error: unknown, mappedError: HttpError): void;
5
- declare function webErrorResponse(error: unknown, request?: Request): Promise<Response | null>;
6
- export type { FieldErrors };
11
+ declare function webErrorResponse(error: unknown, request?: Request, options?: WebErrorResponseOptions): Promise<Response | null>;
12
+ export type { FieldErrors, WebErrorResponseOptions };
7
13
  export { logServerError, normalizeFieldErrors, webErrorResponse };
@@ -1,11 +1,14 @@
1
- import { Job } from "../queue";
1
+ import { Job, type JobContext } from "../queue";
2
2
  interface ExportAuditLogsPayload {
3
3
  reason?: string;
4
4
  }
5
5
  declare class ExportAuditLogsJob extends Job<ExportAuditLogsPayload> {
6
+ private readonly exporter?;
7
+ static readonly jobName = "audit.export";
6
8
  readonly maxAttempts = 2;
7
9
  readonly backoffMs = 5000;
8
- handle(_payload?: ExportAuditLogsPayload): Promise<void>;
10
+ constructor(exporter?: (() => Promise<number>) | undefined);
11
+ handle(_payload?: ExportAuditLogsPayload, context?: JobContext): Promise<void>;
9
12
  }
10
13
  export { ExportAuditLogsJob };
11
14
  export default ExportAuditLogsJob;
@@ -1,12 +1,13 @@
1
1
  import type { CacheLike } from "../../types/services";
2
- import { Job } from "../queue";
2
+ import { Job, type JobContext } from "../queue";
3
3
  interface InvalidateCacheTagsPayload {
4
4
  tags: string[];
5
5
  }
6
6
  declare class InvalidateCacheTagsJob extends Job<InvalidateCacheTagsPayload> {
7
- private readonly cache;
8
- constructor(cache: CacheLike);
9
- handle(payload: InvalidateCacheTagsPayload): Promise<void>;
7
+ private readonly cache?;
8
+ static readonly jobName = "cache.invalidate-tags";
9
+ constructor(cache?: CacheLike | undefined);
10
+ handle(payload: InvalidateCacheTagsPayload, context?: JobContext): Promise<void>;
10
11
  }
11
12
  export { InvalidateCacheTagsJob };
12
13
  export default InvalidateCacheTagsJob;
@@ -26,9 +26,6 @@ declare class LifecycleCoordinator {
26
26
  shutdown(reason?: string): Promise<ShutdownResult>;
27
27
  private execute;
28
28
  }
29
- declare function registerShutdownHandler(name: string, handler: ShutdownHandler, phase?: ShutdownPhase): () => void;
30
- declare function runGracefulShutdown(signal: string): Promise<ShutdownResult>;
31
- declare function installGracefulShutdownSignals(signals?: NodeJS.Signals[], lifecycle?: LifecycleCoordinator): () => void;
32
- declare function resetGracefulShutdownForTests(): void;
29
+ declare function installGracefulShutdownSignals(signals: NodeJS.Signals[] | undefined, lifecycle: LifecycleCoordinator): () => void;
33
30
  export type { ShutdownContext, ShutdownFailure, ShutdownHandler, ShutdownPhase, ShutdownResult };
34
- export { installGracefulShutdownSignals, LifecycleCoordinator, registerShutdownHandler, resetGracefulShutdownForTests, runGracefulShutdown, };
31
+ export { installGracefulShutdownSignals, LifecycleCoordinator };
@@ -1,3 +1,3 @@
1
1
  import type { Middleware } from "@getstrata/core/http/middleware";
2
- declare function createRequestLoggingMiddleware(): Middleware;
2
+ declare function createRequestLoggingMiddleware(trustForwardedFor?: boolean): Middleware;
3
3
  export { createRequestLoggingMiddleware };
@@ -1,3 +1,4 @@
1
+ import { CORE_MAIL_TOKEN } from "@getstrata/core/contracts/serviceTokens";
1
2
  import type { TLSOptions } from "bun";
2
3
  import { assertSafeSmtpAddress, assertSafeSmtpField, buildSmtpPayload, smtpEnvelopeAddress } from "./smtpMessage.ts";
3
4
  interface MailMessage {
@@ -18,18 +19,20 @@ interface SmtpConfig {
18
19
  from: string;
19
20
  secure: boolean;
20
21
  timeoutMs?: number;
22
+ ehloHost?: string;
21
23
  tls?: Pick<TLSOptions, "ca" | "serverName">;
22
24
  }
23
25
  type SmtpTransport = (config: SmtpConfig, message: MailMessage) => Promise<void>;
24
- declare function resolveSmtpConfig(): SmtpConfig;
26
+ declare function resolveSmtpConfig(environment?: Readonly<Record<string, string | undefined>>): SmtpConfig;
27
+ declare function snapshotSmtpConfig(config: SmtpConfig): Readonly<SmtpConfig>;
25
28
  declare function redactMailBody(body: string): string;
26
29
  declare function defaultSmtpTransport(config: SmtpConfig, message: MailMessage): Promise<void>;
27
30
  declare class LogMailDriver implements MailDriver {
28
31
  send(message: MailMessage): Promise<void>;
29
32
  }
30
33
  declare class SmtpMailDriver implements MailDriver {
31
- private readonly config;
32
34
  private readonly transport;
35
+ private readonly config;
33
36
  constructor(config: SmtpConfig, transport?: SmtpTransport);
34
37
  send(message: MailMessage): Promise<void>;
35
38
  }
@@ -38,7 +41,6 @@ declare class Mailer {
38
41
  constructor(driver: MailDriver);
39
42
  send(message: MailMessage): Promise<void>;
40
43
  }
41
- declare function createMailDriver(): MailDriver;
42
- declare function mailer(): Mailer;
44
+ declare function createMailDriver(env?: Readonly<Record<string, string | undefined>>): MailDriver;
43
45
  export type { MailDriver, MailMessage, SmtpConfig, SmtpTransport };
44
- export { assertSafeSmtpAddress, assertSafeSmtpField, buildSmtpPayload, createMailDriver, defaultSmtpTransport, LogMailDriver, Mailer, mailer, redactMailBody, resolveSmtpConfig, SmtpMailDriver, smtpEnvelopeAddress, };
46
+ export { assertSafeSmtpAddress, assertSafeSmtpField, buildSmtpPayload, CORE_MAIL_TOKEN, createMailDriver, defaultSmtpTransport, LogMailDriver, Mailer, redactMailBody, resolveSmtpConfig, SmtpMailDriver, smtpEnvelopeAddress, snapshotSmtpConfig, };
@@ -1,4 +1,12 @@
1
1
  import type { RegisteredRoute } from "./registeredRoute";
2
+ interface OpenApiConfig {
3
+ readonly appName: string;
4
+ readonly appUrl: string;
5
+ readonly apiPrefix: string;
6
+ readonly sdkClassName: string;
7
+ }
8
+ /** Environment adapter: call once at the application's composition boundary. */
9
+ declare function resolveOpenApiConfig(env: Readonly<Record<string, string | undefined>>): OpenApiConfig;
2
10
  interface OpenApiSpec {
3
11
  openapi: string;
4
12
  info: {
@@ -15,8 +23,8 @@ interface OpenApiSpec {
15
23
  schemas?: Record<string, unknown>;
16
24
  };
17
25
  }
18
- declare function generateOpenApiSpec(routes: RegisteredRoute[]): OpenApiSpec;
26
+ declare function generateOpenApiSpec(routes: readonly RegisteredRoute[], config?: OpenApiConfig): OpenApiSpec;
19
27
  declare function renderOpenApiDocument(spec: OpenApiSpec): string;
20
- declare function renderTypeScriptSdk(spec: OpenApiSpec, prefix?: string): string;
21
- export type { OpenApiSpec };
22
- export { generateOpenApiSpec, renderOpenApiDocument, renderTypeScriptSdk };
28
+ declare function renderTypeScriptSdk(spec: OpenApiSpec, prefix?: string, className?: string): string;
29
+ export type { OpenApiConfig, OpenApiSpec };
30
+ export { generateOpenApiSpec, renderOpenApiDocument, renderTypeScriptSdk, resolveOpenApiConfig };
@@ -37,9 +37,9 @@ interface OpenApiOperation {
37
37
  }
38
38
  type OpenApiRouteMap = Record<string, Partial<Record<"GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS", OpenApiOperation>>>;
39
39
  interface RegisteredRoute {
40
- method: string;
41
- path: string;
42
- middleware: string[];
43
- openApi?: OpenApiOperation;
40
+ readonly method: string;
41
+ readonly path: string;
42
+ readonly middleware: readonly string[];
43
+ readonly openApi?: Readonly<OpenApiOperation>;
44
44
  }
45
45
  export type { OpenApiJson, OpenApiMediaType, OpenApiOperation, OpenApiParameter, OpenApiResponse, OpenApiRouteMap, OpenApiSchema, RegisteredRoute, };