@getstrata/core 2.2.59 → 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 +27 -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 -254
  278. package/dist/entries/queue/failedJobRepository.js +19 -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 -255
  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 -1384
  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 +10433 -11347
  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,23 +1,37 @@
1
1
  import type { AbilityChecker } from "../auth/abilityChecker";
2
+ import type { AuthReader } from "../auth/authReader";
3
+ import type { PolicyGate } from "../auth/policy";
4
+ import type { EventBus } from "../events/eventBusClass";
2
5
  import type { ThrottleQuotaPolicy } from "../http/throttleMiddleware";
6
+ import type { Mailer } from "../mail/mailer";
7
+ import type { Queue } from "../queue/index";
8
+ import type { QueueServices } from "../queue/queueServices";
9
+ import type { StorageManager } from "../storage/storage";
3
10
  import type { PublicTenancyOptions, TenantResolver } from "../tenant/tenantMiddleware";
4
- import type { AuthUserDirectory } from "./authUserDirectory";
5
- import type { ServiceContainerLike } from "./container";
6
- declare const CORE_THROTTLE_QUOTA_POLICY_TOKEN: import("./container").ServiceToken<ThrottleQuotaPolicy>;
7
- declare const CORE_PUBLIC_TENANCY_TOKEN: import("./container").ServiceToken<PublicTenancyOptions>;
8
- declare const CORE_TENANT_RESOLVER_TOKEN: import("./container").ServiceToken<TenantResolver>;
9
- declare const CORE_HTTP_CLEANUP_TOKEN: import("./container").ServiceToken<(cleanup: () => void) => void>;
10
- declare const CORE_CONFIG_TOKEN = "core.config";
11
- declare const CORE_CACHE_TOKEN = "core.cache";
12
- declare const CORE_QUEUE_TOKEN = "core.queue";
13
- declare const CORE_EVENT_BUS_TOKEN = "core.eventBus";
14
- declare const CORE_POLICY_GATE_TOKEN = "core.policyGate";
15
- declare const CORE_AUTH_TOKEN = "core.auth";
16
- declare const CORE_TOKEN_SERVICE_TOKEN = "core.tokenService";
17
- declare const CORE_ABILITY_CHECKER_TOKEN = "core.abilityChecker";
18
- declare const CORE_AUTH_USER_DIRECTORY_TOKEN = "core.authUserDirectory";
11
+ import type { TracingRuntime } from "../tracing/otel";
12
+ import type { AuthAccountLookup } from "./authUserDirectory";
13
+ import type { ConfigStoreLike, ServiceContainerLike } from "./container";
14
+ export { CORE_CACHE_TOKEN } from "@getstrata/core/cache/tokens";
15
+ declare const CORE_THROTTLE_QUOTA_POLICY_TOKEN: import("@getstrata/core/contracts/token").ServiceToken<ThrottleQuotaPolicy>;
16
+ declare const CORE_PUBLIC_TENANCY_TOKEN: import("@getstrata/core/contracts/token").ServiceToken<PublicTenancyOptions>;
17
+ declare const CORE_TENANT_RESOLVER_TOKEN: import("@getstrata/core/contracts/token").ServiceToken<TenantResolver>;
18
+ declare const CORE_HTTP_CLEANUP_TOKEN: import("@getstrata/core/contracts/token").ServiceToken<(cleanup: () => void) => void>;
19
+ declare const CORE_TRACING_RUNTIME_TOKEN: import("@getstrata/core/contracts/token").ServiceToken<TracingRuntime>;
20
+ declare const CORE_MAIL_TOKEN: import("@getstrata/core/contracts/token").ServiceToken<Mailer>;
21
+ declare const CORE_STORAGE_TOKEN: import("@getstrata/core/contracts/token").ServiceToken<StorageManager>;
22
+ declare const CORE_JSON_RESPONSE_POLICY_TOKEN: import("@getstrata/core/contracts/token").ServiceToken<Readonly<{
23
+ etagEnabled: boolean;
24
+ }>>;
25
+ declare const CORE_CONFIG_TOKEN: import("@getstrata/core/contracts/token").ServiceToken<ConfigStoreLike>;
26
+ declare const FAILED_JOB_SERVICE_TOKEN: import("@getstrata/core/contracts/token").ServiceToken<QueueServices>;
27
+ declare const CORE_QUEUE_TOKEN: import("@getstrata/core/contracts/token").ServiceToken<Queue>;
28
+ declare const CORE_EVENT_BUS_TOKEN: import("@getstrata/core/contracts/token").ServiceToken<EventBus>;
29
+ declare const CORE_POLICY_GATE_TOKEN: import("@getstrata/core/contracts/token").ServiceToken<Pick<PolicyGate<Record<string, import("../auth/policy").Policy>>, "allows" | "authorize" | "register">>;
30
+ declare const CORE_AUTH_TOKEN: import("@getstrata/core/contracts/token").ServiceToken<AuthReader>;
31
+ declare const CORE_ABILITY_CHECKER_TOKEN: import("@getstrata/core/contracts/token").ServiceToken<AbilityChecker>;
32
+ declare const CORE_AUTH_USER_DIRECTORY_TOKEN: import("@getstrata/core/contracts/token").ServiceToken<AuthAccountLookup>;
19
33
  declare function isAbilityChecker(value: unknown): value is AbilityChecker;
20
- declare function isAuthUserDirectory(value: unknown): value is AuthUserDirectory;
34
+ declare function isAuthUserDirectory(value: unknown): value is AuthAccountLookup;
21
35
  declare function resolveAbilityChecker(container: ServiceContainerLike): AbilityChecker;
22
- declare function resolveAuthUserDirectory(container: ServiceContainerLike): AuthUserDirectory | null;
23
- export { CORE_ABILITY_CHECKER_TOKEN, CORE_AUTH_TOKEN, CORE_AUTH_USER_DIRECTORY_TOKEN, CORE_CACHE_TOKEN, CORE_CONFIG_TOKEN, CORE_EVENT_BUS_TOKEN, CORE_HTTP_CLEANUP_TOKEN, CORE_POLICY_GATE_TOKEN, CORE_PUBLIC_TENANCY_TOKEN, CORE_QUEUE_TOKEN, CORE_TENANT_RESOLVER_TOKEN, CORE_THROTTLE_QUOTA_POLICY_TOKEN, CORE_TOKEN_SERVICE_TOKEN, isAbilityChecker, isAuthUserDirectory, resolveAbilityChecker, resolveAuthUserDirectory, };
36
+ declare function resolveAuthUserDirectory(container: ServiceContainerLike): AuthAccountLookup | null;
37
+ export { CORE_ABILITY_CHECKER_TOKEN, CORE_AUTH_TOKEN, CORE_AUTH_USER_DIRECTORY_TOKEN, CORE_CONFIG_TOKEN, CORE_EVENT_BUS_TOKEN, CORE_HTTP_CLEANUP_TOKEN, CORE_JSON_RESPONSE_POLICY_TOKEN, CORE_MAIL_TOKEN, CORE_POLICY_GATE_TOKEN, CORE_PUBLIC_TENANCY_TOKEN, CORE_QUEUE_TOKEN, CORE_STORAGE_TOKEN, CORE_TENANT_RESOLVER_TOKEN, CORE_THROTTLE_QUOTA_POLICY_TOKEN, CORE_TRACING_RUNTIME_TOKEN, FAILED_JOB_SERVICE_TOKEN, isAbilityChecker, isAuthUserDirectory, resolveAbilityChecker, resolveAuthUserDirectory, };
@@ -0,0 +1,63 @@
1
+ import { type AnyServiceToken, type ServiceToken } from "@getstrata/core/contracts/token";
2
+ import type { ResourceSpec } from "./application";
3
+ type ServiceLifetime = "application" | "execution";
4
+ declare const serviceDeclarationType: unique symbol;
5
+ interface DeclarationBrand {
6
+ readonly [serviceDeclarationType]: object;
7
+ }
8
+ type DependencyValues<D extends readonly AnyServiceToken[]> = {
9
+ [K in keyof D]: D[K] extends ServiceToken<infer T> ? T : never;
10
+ };
11
+ type CallableThenPayload<T> = T extends unknown ? "then" extends keyof T ? [Extract<T["then"], (...args: never[]) => unknown>] extends [never] ? never : T : never : never;
12
+ type NonPromisePayload<T> = unknown extends T ? unknown : [Extract<T, PromiseLike<unknown>> | CallableThenPayload<T>] extends [never] ? unknown : never;
13
+ interface ServiceOptions<T, D extends readonly AnyServiceToken[]> {
14
+ readonly lifetime: ServiceLifetime;
15
+ readonly dependencies: D;
16
+ /** Async initialization yields T; PromiseLike<T> is not itself a service payload. */
17
+ readonly create: (...dependencies: DependencyValues<D>) => NoInfer<T> | Promise<NoInfer<T>>;
18
+ }
19
+ interface FactoryServiceDeclaration extends DeclarationBrand {
20
+ readonly kind: "factory";
21
+ readonly token: AnyServiceToken;
22
+ readonly lifetime: ServiceLifetime;
23
+ readonly dependencies: readonly AnyServiceToken[];
24
+ /** Erased assembly signature; callers use the typed service helper. */
25
+ readonly create: (...dependencies: never[]) => unknown;
26
+ }
27
+ interface ResourceServiceOptions<T, D extends readonly AnyServiceToken[]> {
28
+ readonly lifetime: ServiceLifetime;
29
+ readonly dependencies: D;
30
+ /** Assemble a resource-free descriptor; acquisition belongs in ResourceSpec.open. */
31
+ readonly create: (...dependencies: DependencyValues<D>) => ResourceSpec<NoInfer<T>>;
32
+ }
33
+ interface ResourceServiceDeclaration extends DeclarationBrand {
34
+ readonly kind: "resource";
35
+ readonly token: AnyServiceToken;
36
+ readonly lifetime: ServiceLifetime;
37
+ readonly dependencies: readonly AnyServiceToken[];
38
+ /** Erased assembly signature; callers use the typed resourceService helper. */
39
+ readonly create: (...dependencies: never[]) => unknown;
40
+ }
41
+ interface ValueServiceDeclaration extends DeclarationBrand {
42
+ readonly kind: "value";
43
+ readonly token: AnyServiceToken;
44
+ readonly lifetime: "application";
45
+ /** Caller-owned service values are neither copied nor deep-frozen. */
46
+ readonly value: unknown;
47
+ }
48
+ interface AliasServiceDeclaration extends DeclarationBrand {
49
+ readonly kind: "alias";
50
+ readonly token: AnyServiceToken;
51
+ readonly target: AnyServiceToken;
52
+ }
53
+ type ServiceDeclaration = FactoryServiceDeclaration | ResourceServiceDeclaration | ValueServiceDeclaration | AliasServiceDeclaration;
54
+ /** Authenticate original helper output; copied/spread fields cannot forge this identity. */
55
+ declare function isServiceDeclaration(value: unknown): value is ServiceDeclaration;
56
+ /** PromiseLike payloads are not values; inspect descriptors without invoking then getters. */
57
+ declare function assertServicePayload(value: unknown): void;
58
+ declare function service<T, const D extends readonly AnyServiceToken[]>(token: ServiceToken<T> & NonPromisePayload<T>, options: ServiceOptions<T, D>): FactoryServiceDeclaration;
59
+ declare function valueService<T>(token: ServiceToken<T> & NonPromisePayload<T>, value: NoInfer<T>): ValueServiceDeclaration;
60
+ declare function resourceService<T, const D extends readonly AnyServiceToken[]>(token: ServiceToken<T> & NonPromisePayload<T>, options: ResourceServiceOptions<T, D>): ResourceServiceDeclaration;
61
+ declare function aliasService<T>(aliasToken: ServiceToken<T> & NonPromisePayload<T>, targetToken: ServiceToken<NoInfer<T>>): AliasServiceDeclaration;
62
+ export type { AliasServiceDeclaration, DependencyValues, FactoryServiceDeclaration, NonPromisePayload, ResourceServiceDeclaration, ResourceServiceOptions, ServiceDeclaration, ServiceLifetime, ServiceOptions, ValueServiceDeclaration, };
63
+ export { aliasService, assertServicePayload, isServiceDeclaration, resourceService, service, valueService, };
@@ -0,0 +1,19 @@
1
+ declare const serviceTokenIdentity: unique symbol;
2
+ declare const serviceTokenType: unique symbol;
3
+ /** Erased identity shared by heterogeneous tokens without weakening their value invariance. */
4
+ interface AnyServiceToken {
5
+ readonly name: string;
6
+ readonly [serviceTokenIdentity]: symbol;
7
+ }
8
+ /** Opaque application service identity. The function property makes T invariant. */
9
+ type ServiceToken<T> = AnyServiceToken & {
10
+ readonly [serviceTokenType]: (value: T) => T;
11
+ };
12
+ declare function createServiceToken<T>(name: string): ServiceToken<T>;
13
+ /** Shape validation is not a security boundary against arbitrary casts or reflective code. */
14
+ declare function isServiceToken(value: unknown): value is AnyServiceToken;
15
+ declare function assertServiceToken(value: unknown): asserts value is AnyServiceToken;
16
+ declare function serviceTokenKey(token: AnyServiceToken): symbol;
17
+ declare function serviceTokenName(token: AnyServiceToken): string;
18
+ export type { AnyServiceToken, ServiceToken };
19
+ export { assertServiceToken, createServiceToken, isServiceToken, serviceTokenKey, serviceTokenName, };
@@ -1,16 +1,28 @@
1
- declare function resolveEncryptionKey(): Buffer | null;
2
- declare function isFieldEncryptionEnabled(): boolean;
1
+ declare function resolveEncryptionKey(env: Readonly<Record<string, string | undefined>>): Buffer | null;
2
+ interface FieldEncryptionCodec {
3
+ isFieldEncryptionEnabled(): boolean;
4
+ protectEmail(email: string): {
5
+ storedEmail: string;
6
+ emailLookup: string;
7
+ };
8
+ revealEmail(storedEmail: string): string;
9
+ emailLookupForQuery(email: string): string;
10
+ }
11
+ /** Resolve and copy key material at owner construction, never during a request. */
12
+ declare function createFieldEncryptionCodec(env: Readonly<Record<string, string | undefined>>): FieldEncryptionCodec;
13
+ declare function isFieldEncryptionEnabled(codec: FieldEncryptionCodec): boolean;
3
14
  declare function encryptField(plaintext: string, key: Buffer): string;
4
15
  declare function decryptField(value: string, key: Buffer): string;
5
16
  declare function hashLookupValue(normalizedValue: string, key: Buffer): string;
6
17
  declare function normalizeEmail(email: string): string;
7
- declare function protectEmail(email: string): {
18
+ declare function protectEmail(email: string, codec: FieldEncryptionCodec): {
8
19
  storedEmail: string;
9
20
  emailLookup: string;
10
21
  };
11
- declare function revealEmail(storedEmail: string): string;
12
- declare function emailLookupForQuery(email: string): string;
13
- export { decryptField, emailLookupForQuery, encryptField, hashLookupValue, isFieldEncryptionEnabled, normalizeEmail, protectEmail, resolveEncryptionKey, revealEmail, };
22
+ declare function revealEmail(storedEmail: string, codec: FieldEncryptionCodec): string;
23
+ declare function emailLookupForQuery(email: string, codec: FieldEncryptionCodec): string;
24
+ export type { FieldEncryptionCodec };
25
+ export { createFieldEncryptionCodec, decryptField, emailLookupForQuery, encryptField, hashLookupValue, isFieldEncryptionEnabled, normalizeEmail, protectEmail, resolveEncryptionKey, revealEmail, };
14
26
  interface FieldEncryptionKeyringOptions {
15
27
  /** Public stable identifiers; never reuse an ID for different key material. */
16
28
  activeKeyId: string;
@@ -37,6 +49,6 @@ interface ConfiguredFieldEncryption {
37
49
  encrypt(plaintext: string, purpose: string): string;
38
50
  }
39
51
  /** Stateless resolution keeps separately bundled auth entrypoints on the same configuration. */
40
- declare function resolveFieldEncryptionKeyring(env?: Record<string, string | undefined>): ConfiguredFieldEncryption | null;
52
+ declare function resolveFieldEncryptionKeyring(env: Readonly<Record<string, string | undefined>>): ConfiguredFieldEncryption | null;
41
53
  export type { ConfiguredFieldEncryption };
42
54
  export { resolveFieldEncryptionKeyring };
@@ -1,12 +1,28 @@
1
- import { BaseRepository } from "../database/baseRepository";
1
+ import { type RepositoryDefinition } from "@getstrata/core/database/definitions";
2
+ import { BaseRepository } from "#strata-orm-runtime";
2
3
  import type { Migration } from "../database/migrations/types";
3
4
  import { type DatabaseDriver } from "../database/schema";
5
+ import type { DatabaseSession, TransactionSession } from "../database/session";
4
6
  import { type FieldEncryptionKeyring } from "./fieldEncryption";
7
+ type RotationCheckpoint = {
8
+ run_id: string;
9
+ tenant_id: number | null;
10
+ definition_hash: string;
11
+ probe: string;
12
+ lookup_probe: string;
13
+ cursor_id: string | null;
14
+ claim_token: string;
15
+ completed: boolean;
16
+ };
17
+ declare const fieldEncryptionRotationRepository: RepositoryDefinition<RotationCheckpoint, "run_id", BaseRepository<RotationCheckpoint, "run_id">>;
5
18
  declare function createFieldEncryptionRotationMigration(name: string, driver: DatabaseDriver, options?: {
6
19
  rls?: boolean;
7
20
  }): Migration;
8
- interface FieldEncryptionRotationOptions<TEntity extends object, PK extends keyof TEntity & string> {
9
- repository: BaseRepository<TEntity, PK>;
21
+ interface FieldEncryptionRotationOptions<TEntity extends object, PK extends keyof TEntity & string, TRepository extends BaseRepository<TEntity, PK> = BaseRepository<TEntity, PK>> {
22
+ session: DatabaseSession | TransactionSession;
23
+ repository: RepositoryDefinition<TEntity, PK, TRepository>;
24
+ /** Established tenant scope; caller supplies the selected session with its policy applied. */
25
+ tenantId: number | null;
10
26
  /** A distinct durable run identity per table, tenant/filter scope and audit pass. */
11
27
  runId: string;
12
28
  scopeId: string;
@@ -29,6 +45,6 @@ interface FieldEncryptionRotationBatch {
29
45
  completed: boolean;
30
46
  }
31
47
  /** One bounded transaction. Persisted cursors advance only with committed row writes. No RLS bypass. */
32
- declare function runFieldEncryptionRotationBatch<TEntity extends object, PK extends keyof TEntity & string>(options: FieldEncryptionRotationOptions<TEntity, PK>): Promise<FieldEncryptionRotationBatch>;
48
+ declare function runFieldEncryptionRotationBatch<TEntity extends object, PK extends keyof TEntity & string, TRepository extends BaseRepository<TEntity, PK>>(options: FieldEncryptionRotationOptions<TEntity, PK, TRepository>): Promise<FieldEncryptionRotationBatch>;
33
49
  export type { FieldEncryptionRotationBatch, FieldEncryptionRotationOptions };
34
- export { createFieldEncryptionRotationMigration, runFieldEncryptionRotationBatch };
50
+ export { createFieldEncryptionRotationMigration, fieldEncryptionRotationRepository, runFieldEncryptionRotationBatch, };
@@ -1,3 +1,10 @@
1
- declare function protectMfaSecret(secret: string): string;
2
- declare function revealMfaSecret(stored: string | null | undefined): string | null;
3
- export { protectMfaSecret, revealMfaSecret };
1
+ interface MfaSecretCodec {
2
+ protectMfaSecret(secret: string): string;
3
+ revealMfaSecret(stored: string | null | undefined): string | null;
4
+ }
5
+ /** Capture the application's keyring and plaintext policy before request execution. */
6
+ declare function createMfaSecretCodec(env: Readonly<Record<string, string | undefined>>): MfaSecretCodec;
7
+ declare function protectMfaSecret(secret: string, codec: MfaSecretCodec): string;
8
+ declare function revealMfaSecret(stored: string | null | undefined, codec: MfaSecretCodec): string | null;
9
+ export type { MfaSecretCodec };
10
+ export { createMfaSecretCodec, protectMfaSecret, revealMfaSecret };
@@ -1,8 +1,9 @@
1
+ import type { RepositoryBinding } from "@getstrata/core/database/definitions";
1
2
  import type { KeysetCursor, KeysetOptions } from "../pagination/index.ts";
2
3
  import { type CursorPaginatedResult, type PaginatedResult } from "../pagination/index.ts";
3
- import type { DatabaseConnection, SqlDatabaseConnection } from "./connectionContracts";
4
4
  import { type BelongsToManyRelation, type BelongsToRelation, type HasManyRelation, type HasManyThroughRelation, type MorphManyRelation, type MorphOneRelation, type MorphToRelation } from "./relationships.ts";
5
5
  import { RepositoryQuery } from "./repositoryQuery.ts";
6
+ import type { SqlDialect } from "./sqlDialects";
6
7
  import type { TableDefinition } from "./table.ts";
7
8
  import type { MutationValues, QueryOptions, QueryWhere, UpdateValues } from "./types.ts";
8
9
  import type { WhereNode } from "./whereBuilder.ts";
@@ -10,13 +11,21 @@ type ExtendedQueryOptions<TEntity extends object> = QueryOptions<TEntity> & {
10
11
  whereNodes?: WhereNode<TEntity>[];
11
12
  };
12
13
  type ErrorFactory<TValue> = (value: TValue) => Error;
14
+ declare let getRepositoryBinding: <R extends object, K extends keyof R & string>(repository: BaseRepository<R, K>) => RepositoryBinding<R, K>;
13
15
  declare class BaseRepository<TEntity extends object, PrimaryKey extends keyof TEntity & string> {
16
+ #private;
14
17
  protected readonly table: TableDefinition<TEntity, PrimaryKey>;
15
- protected readonly connection: DatabaseConnection;
16
- constructor(table: TableDefinition<TEntity, PrimaryKey>, connection?: DatabaseConnection);
18
+ constructor(binding: RepositoryBinding<TEntity, PrimaryKey>);
19
+ private get connection();
17
20
  private assertTransactionalEvent;
18
21
  private runModelMutation;
19
22
  private mysqlMutation;
23
+ private publish;
24
+ private transformWrite;
25
+ private transformQuery;
26
+ private hydrateRow;
27
+ private relatedRepository;
28
+ private runTerminal;
20
29
  private mysqlRow;
21
30
  private mysqlAffected;
22
31
  private mysqlWriteById;
@@ -55,16 +64,12 @@ declare class BaseRepository<TEntity extends object, PrimaryKey extends keyof TE
55
64
  forceDeleteById(id: TEntity[PrimaryKey]): Promise<boolean>;
56
65
  restoreById(id: TEntity[PrimaryKey]): Promise<TEntity | null>;
57
66
  private primaryKeySeekDirection;
58
- withConnection(connection: DatabaseConnection): this;
59
- /** Override when constructor initialization or native private fields must be preserved. */
60
- protected cloneWithConnection(connection: DatabaseConnection): this;
61
- getConnection(): DatabaseConnection;
62
67
  getTable(): TableDefinition<TEntity, PrimaryKey>;
63
68
  query(where?: QueryWhere<TEntity>): RepositoryQuery<TEntity, PrimaryKey>;
64
69
  protected findWhere(where: QueryWhere<TEntity>, options?: Omit<QueryOptions<TEntity>, "where">): Promise<TEntity[]>;
65
70
  protected countWhere(where?: QueryWhere<TEntity>, options?: Pick<QueryOptions<TEntity>, "withTrashed" | "onlyTrashed" | "joins" | "groupBy">, whereNodes?: readonly WhereNode<TEntity>[]): Promise<number>;
66
71
  protected averageColumn(column: keyof TEntity & string, where?: QueryWhere<TEntity>): Promise<number>;
67
- protected averageExpression(expression: string, alias: string, where?: QueryWhere<TEntity>): Promise<number>;
72
+ protected averageExpression(expression: string, alias: string, where?: QueryWhere<TEntity>, dialect?: SqlDialect): Promise<number>;
68
73
  /** One plain grouped projection; SQL numeric totals remain exact text, never implicit JS numbers. */
69
74
  sumBy<K extends keyof TEntity & string>(groupColumn: K, column: keyof TEntity & string, options?: ExtendedQueryOptions<TEntity>): Promise<Array<{
70
75
  value: TEntity[K] | null;
@@ -91,6 +96,5 @@ declare class BaseRepository<TEntity extends object, PrimaryKey extends keyof TE
91
96
  loadMorphToForChildren<TChild extends object, TParent extends object, MorphTypeKey extends keyof TChild & string, MorphIdKey extends keyof TChild & string, OwnerKey extends keyof TParent & string>(children: readonly TChild[], relation: MorphToRelation<TChild, MorphTypeKey, MorphIdKey>, repositoriesByType: ReadonlyMap<string, BaseRepository<TParent, OwnerKey>>, options?: Omit<QueryOptions<TParent>, "where">): Promise<Map<TChild[MorphIdKey], TParent>>;
92
97
  loadBelongsToManyForParents<TParent extends object, TRelated extends object, Pivot extends object, ParentKey extends keyof TParent & string, RelatedKey extends keyof TRelated & string, ForeignPivotKey extends keyof Pivot & string, RelatedPivotKey extends keyof Pivot & string>(parents: readonly TParent[], relation: BelongsToManyRelation<TParent, TRelated, Pivot, ParentKey, RelatedKey, ForeignPivotKey, RelatedPivotKey>, relatedRepository: BaseRepository<TRelated, RelatedKey>, options?: Omit<QueryOptions<TRelated>, "where">): Promise<Map<TParent[ParentKey], TRelated[]>>;
93
98
  }
94
- export { BaseRepository };
99
+ export { BaseRepository, getRepositoryBinding };
95
100
  export default BaseRepository;
96
- export type { DatabaseConnection, SqlDatabaseConnection };
@@ -0,0 +1,6 @@
1
+ import { type ServiceDeclaration } from "@getstrata/core/contracts/services";
2
+ import type { DatabaseConnectionOptions, DatabaseDefinition } from "./driverPorts";
3
+ /** Every configured pool has its own declaration and journal acquisition. */
4
+ declare function createDatabaseBindings(definition: DatabaseDefinition): readonly ServiceDeclaration[];
5
+ export type { DatabaseConnectionOptions, DatabaseDefinition };
6
+ export { createDatabaseBindings };
@@ -1,13 +1,4 @@
1
- import { SQL } from "bun";
2
- import type { DatabaseConnection } from "./connectionContracts";
3
- interface CreateBunSqlPoolOptions {
4
- url: string;
5
- max?: number;
6
- idleTimeout?: number;
7
- maxLifetime?: number;
8
- connectionTimeout?: number;
9
- }
10
- declare function createBunSqlPool(options: CreateBunSqlPoolOptions): InstanceType<typeof SQL>;
11
- declare function bindBunSql(sql: DatabaseConnection): DatabaseConnection;
1
+ import { type CreateBunSqlPoolOptions, createNativePostgresPool } from "./postgresNative";
2
+ declare const createBunSqlPool: typeof createNativePostgresPool;
12
3
  export type { CreateBunSqlPoolOptions };
13
- export { bindBunSql, createBunSqlPool };
4
+ export { createBunSqlPool };
@@ -0,0 +1,209 @@
1
+ import { type AnyServiceToken, type ServiceToken } from "@getstrata/core/contracts/token";
2
+ import type { ExecutionContext } from "../contracts/application";
3
+ import type { ExecutionPersistence } from "../contracts/persistence";
4
+ import type { DependencyValues, NonPromisePayload } from "../contracts/services";
5
+ import type { CursorPaginatedResult, KeysetCursor, KeysetOptions } from "../pagination/index";
6
+ import type { BaseRepository } from "./baseRepository";
7
+ import type { DatabaseCapabilities } from "./driverPorts";
8
+ import type { Model } from "./model";
9
+ import type { ModelCasts } from "./modelAttributes";
10
+ import type { ModelQuery, RelationNameInput } from "./modelQuery";
11
+ import type { AnyRelationQuery } from "./relationQuery";
12
+ import type { RepositoryQuery } from "./repositoryQuery";
13
+ import type { DatabaseSession } from "./session";
14
+ import type { SqlDialect } from "./sqlDialects";
15
+ import type { TableDefinition } from "./table";
16
+ import type { TransactionSession } from "./transactionSession";
17
+ import type { ModelWhere, ModelWriteValues, QueryOptions } from "./types";
18
+ declare const definitionBrand: unique symbol;
19
+ declare const repositoryType: unique symbol;
20
+ declare const modelType: unique symbol;
21
+ declare const modelIdentityType: unique symbol;
22
+ type Session = DatabaseSession | TransactionSession;
23
+ interface RepositoryBinding<R extends object, K extends keyof R & string> {
24
+ readonly session: Session;
25
+ readonly table: TableDefinition<R, K>;
26
+ readonly dialect: SqlDialect;
27
+ readonly capabilities: DatabaseCapabilities;
28
+ readonly run: <V>(work: () => V | Promise<V>) => Promise<V>;
29
+ }
30
+ interface ModelBinding<R extends object, K extends keyof R & string, T extends BaseRepository<R, K>> extends RepositoryBinding<R, K> {
31
+ readonly definition: ModelIdentity<R, K>;
32
+ readonly repository: T;
33
+ }
34
+ interface ModelIdentity<R extends object, K extends keyof R & string> {
35
+ readonly [modelIdentityType]: (value: [R, K]) => [R, K];
36
+ readonly kind: "model";
37
+ readonly name: string;
38
+ readonly [definitionBrand]: object;
39
+ }
40
+ interface ModelState<R extends object> {
41
+ readonly attributes: Partial<R>;
42
+ readonly original: Partial<R>;
43
+ readonly exists: boolean;
44
+ readonly hidden: readonly string[];
45
+ readonly visible: readonly string[] | undefined;
46
+ readonly appends: readonly string[];
47
+ }
48
+ interface ModelAttributeOptions<R extends object> {
49
+ readonly fillable?: readonly (keyof R & string)[];
50
+ readonly guarded?: readonly (keyof R & string)[] | true;
51
+ readonly casts?: ModelCasts;
52
+ readonly timestamps?: boolean;
53
+ readonly hidden?: readonly string[];
54
+ readonly visible?: readonly string[];
55
+ readonly appends?: readonly string[];
56
+ readonly dehydrate?: (values: Readonly<Partial<R>>, ...dependencies: never[]) => Partial<R> | Promise<Partial<R>>;
57
+ }
58
+ type ModelObserver<M> = Partial<Record<"retrieved" | "creating" | "created" | "updating" | "updated" | "saving" | "saved" | "deleting" | "deleted", (model: M) => unknown>>;
59
+ type RepositoryAction = "created" | "updated" | "deleted" | "restored" | "force-deleted";
60
+ interface RepositoryHooks<R extends object, K extends keyof R & string> {
61
+ readonly transformQuery?: (plan: QueryOptions<R>, binding: RepositoryBinding<R, K>) => QueryOptions<R>;
62
+ readonly transformWrite?: (action: RepositoryAction, values: Readonly<Partial<R>>, binding: RepositoryBinding<R, K>) => Partial<R> | Promise<Partial<R>>;
63
+ readonly hydrateRow?: (row: Readonly<R>, binding: RepositoryBinding<R, K>) => R;
64
+ }
65
+ type RepositoryPublication<R extends object, K extends keyof R & string> = Readonly<{
66
+ session: TransactionSession;
67
+ definition: RepositoryDefinition<R, K, BaseRepository<R, K>>;
68
+ action: RepositoryAction;
69
+ row: Readonly<R>;
70
+ }>;
71
+ type TransactionalRepositoryListener<R extends object, K extends keyof R & string> = (publication: RepositoryPublication<R, K>) => void | Promise<void>;
72
+ type AfterCommitRepositoryContext = Readonly<ExecutionPersistence & {
73
+ execution: ExecutionContext;
74
+ }>;
75
+ type AfterCommitRepositoryListener<R extends object> = (row: Readonly<R>, context: AfterCommitRepositoryContext) => void | Promise<void>;
76
+ interface RepositoryEffect {
77
+ readonly action: RepositoryAction;
78
+ readonly transactional?: AnyServiceToken;
79
+ readonly afterCommit?: AnyServiceToken;
80
+ }
81
+ declare const effectsBrand: unique symbol;
82
+ interface RepositoryEffectsDeclaration {
83
+ readonly definition: AnyRepositoryDefinition;
84
+ readonly effects: readonly RepositoryEffect[];
85
+ readonly [effectsBrand]: object;
86
+ }
87
+ type TypedRepositoryEffect<R extends object, K extends keyof R & string> = Readonly<{
88
+ action: RepositoryAction;
89
+ transactional?: ServiceToken<TransactionalRepositoryListener<R, K>>;
90
+ afterCommit?: ServiceToken<AfterCommitRepositoryListener<R>>;
91
+ }>;
92
+ interface AnyRepositoryDefinition {
93
+ readonly kind: "repository";
94
+ readonly name: string;
95
+ readonly [definitionBrand]: object;
96
+ readonly table: Readonly<{
97
+ name: string;
98
+ primaryKey: string;
99
+ columns: readonly string[];
100
+ defaultOrderBy?: unknown;
101
+ softDeletes?: unknown;
102
+ }>;
103
+ readonly dependencies: readonly AnyServiceToken[];
104
+ readonly create: (...args: never[]) => unknown;
105
+ readonly hooks?: unknown;
106
+ readonly effects: readonly RepositoryEffect[];
107
+ }
108
+ interface AnyModelDefinition extends Omit<ModelIdentity<Record<string, unknown>, string>, typeof modelIdentityType> {
109
+ readonly aliases: readonly string[];
110
+ readonly repository: AnyRepositoryDefinition;
111
+ readonly dependencies: readonly AnyServiceToken[];
112
+ readonly attributes: Readonly<{
113
+ fillable?: readonly string[];
114
+ guarded?: readonly string[] | true;
115
+ casts?: ModelCasts;
116
+ timestamps?: boolean;
117
+ hidden?: readonly string[];
118
+ visible?: readonly string[];
119
+ appends?: readonly string[];
120
+ dehydrate?: (...arguments_: never[]) => unknown;
121
+ }>;
122
+ readonly observers: readonly AnyServiceToken[];
123
+ readonly scopes: readonly ((...args: never[]) => unknown)[];
124
+ readonly construct: (...args: never[]) => unknown;
125
+ }
126
+ type RepositoryDefinition<R extends object, K extends keyof R & string, T extends BaseRepository<R, K>> = Omit<AnyRepositoryDefinition, "table" | "create" | "hooks"> & {
127
+ readonly table: TableDefinition<R, K>;
128
+ readonly create: (binding: RepositoryBinding<R, K>, ...dependencies: never[]) => T;
129
+ readonly hooks?: RepositoryHooks<R, K>;
130
+ readonly [repositoryType]: (value: [R, K, T]) => [R, K, T];
131
+ };
132
+ type ModelDefinition<R extends object, K extends keyof R & string, M extends Model<R, K>> = Omit<AnyModelDefinition, "repository" | "attributes" | "construct"> & {
133
+ readonly repository: AnyRepositoryDefinition;
134
+ readonly attributes: ModelAttributeOptions<R>;
135
+ readonly construct: (state: ModelState<R>, binding: ModelBinding<R, K, BaseRepository<R, K>>, source: M | undefined, ...dependencies: never[]) => M;
136
+ readonly [modelType]: (value: [R, K, M]) => [R, K, M];
137
+ readonly [modelIdentityType]: (value: [R, K]) => [R, K];
138
+ };
139
+ interface BoundModel<R extends object, K extends keyof R & string, M extends Model<R, K>> {
140
+ readonly definition: ModelDefinition<R, K, M>;
141
+ readonly name: string;
142
+ repository(): BaseRepository<R, K>;
143
+ query(): ModelQuery<M>;
144
+ newRecord(values: Partial<R>): M;
145
+ hydrate(values: R, exists?: boolean): M;
146
+ bind(source: NoInfer<M>): M;
147
+ newFromRecord(record: ModelWriteValues<R>, exists: false): M;
148
+ newFromRecord(record: R, exists?: boolean): M;
149
+ /** Trusted SQL/driver/partial-record hydration; the caller owns completeness. */
150
+ newFromTrustedRecord(record: object, exists?: boolean): M;
151
+ create(values: ModelWriteValues<R>, forced?: ModelWriteValues<R>): Promise<M>;
152
+ find(id: R[K]): Promise<M | null>;
153
+ findOrFail(id: R[K], errorFactory?: (id: unknown) => Error): Promise<M>;
154
+ all(options?: Omit<QueryOptions<R>, "where" | "select">): Promise<M[]>;
155
+ where(where: ModelWhere<R>): ModelQuery<M>;
156
+ firstWhere(where: ModelWhere<R>, options?: Omit<QueryOptions<R>, "where" | "select">): Promise<M | null>;
157
+ firstOrNew(where: ModelWhere<R>, values?: ModelWriteValues<R>): Promise<M>;
158
+ firstOrCreate(where: ModelWhere<R>, values?: ModelWriteValues<R>): Promise<M>;
159
+ updateOrCreate(where: ModelWhere<R>, values?: ModelWriteValues<R>): Promise<M>;
160
+ with(...relations: RelationNameInput[]): ModelQuery<M>;
161
+ withTrashed(): ModelQuery<M>;
162
+ onlyTrashed(): ModelQuery<M>;
163
+ whereHas(name: string, constrain?: (query: AnyRelationQuery) => void): ModelQuery<M>;
164
+ has(name: string): ModelQuery<M>;
165
+ doesntHave(name: string): ModelQuery<M>;
166
+ whereDoesntHave(name: string, constrain?: (query: AnyRelationQuery) => void): ModelQuery<M>;
167
+ count(): Promise<number>;
168
+ pluck(column: string): Promise<unknown[]>;
169
+ pluck(column: string, keyBy: string): Promise<Map<unknown, unknown>>;
170
+ value(column: string): Promise<unknown>;
171
+ chunk(count: number, callback: (models: M[]) => Promise<boolean | void>): Promise<void>;
172
+ keysetPaginate(options: KeysetOptions<R>): Promise<CursorPaginatedResult<M, KeysetCursor>>;
173
+ cursorPaginate(options: {
174
+ perPage: number;
175
+ cursor?: unknown;
176
+ }): Promise<CursorPaginatedResult<M>>;
177
+ }
178
+ declare function defineRepository<R extends object, K extends keyof R & string, T extends BaseRepository<R, K>, const D extends readonly AnyServiceToken[]>(s: {
179
+ name: string;
180
+ table: TableDefinition<R, K>;
181
+ dependencies: D;
182
+ hooks?: RepositoryHooks<R, K>;
183
+ effects?: readonly Readonly<{
184
+ action: RepositoryAction;
185
+ transactional?: ServiceToken<TransactionalRepositoryListener<R, K>>;
186
+ afterCommit?: ServiceToken<AfterCommitRepositoryListener<R>>;
187
+ }>[];
188
+ create: (binding: RepositoryBinding<R, K>, ...dependencies: DependencyValues<D>) => T & NonPromisePayload<T>;
189
+ }): RepositoryDefinition<R, K, T>;
190
+ declare function defineModel<R extends object, K extends keyof R & string, M extends Model<R, K>, T extends BaseRepository<R, K>, const D extends readonly AnyServiceToken[]>(s: {
191
+ name: string;
192
+ aliases?: readonly string[];
193
+ repository: RepositoryDefinition<R, K, T>;
194
+ dependencies: D;
195
+ attributes: Omit<ModelAttributeOptions<R>, "dehydrate"> & {
196
+ readonly dehydrate?: (values: Readonly<Partial<R>>, ...dependencies: DependencyValues<D>) => Partial<R> | Promise<Partial<R>>;
197
+ };
198
+ observers?: readonly ServiceToken<ModelObserver<M>>[];
199
+ scopes?: readonly ((query: RepositoryQuery<R, K>, ...dependencies: DependencyValues<D>) => RepositoryQuery<R, K>)[];
200
+ construct: (state: ModelState<R>, binding: ModelBinding<R, K, T>, source: M | undefined, ...dependencies: DependencyValues<D>) => M & NonPromisePayload<M>;
201
+ }): ModelDefinition<R, K, M>;
202
+ declare function assertDefinition(value: unknown, kind: "repository"): asserts value is AnyRepositoryDefinition;
203
+ declare function assertDefinition(value: unknown, kind: "model"): asserts value is AnyModelDefinition;
204
+ export type { AfterCommitRepositoryContext, AfterCommitRepositoryListener, AnyModelDefinition, AnyRepositoryDefinition, BoundModel, ModelAttributeOptions, ModelBinding, ModelDefinition, ModelIdentity, ModelObserver, ModelState, RepositoryAction, RepositoryBinding, RepositoryDefinition, RepositoryEffect, RepositoryHooks, RepositoryPublication, TransactionalRepositoryListener, };
205
+ export { assertDefinition, defineModel, defineRepository };
206
+ declare function repositoryEffects<R extends object, K extends keyof R & string, T extends BaseRepository<R, K>>(definition: RepositoryDefinition<R, K, T>, effects: readonly TypedRepositoryEffect<R, K>[]): RepositoryEffectsDeclaration;
207
+ declare function assertRepositoryEffectsDeclaration(value: unknown): asserts value is RepositoryEffectsDeclaration;
208
+ export type { RepositoryEffectsDeclaration, TypedRepositoryEffect };
209
+ export { assertRepositoryEffectsDeclaration, repositoryEffects };
@@ -1,28 +1,9 @@
1
- import { type DatabaseDriver } from "./schema/driver.ts";
2
- interface SqlDialect {
3
- readonly driver: DatabaseDriver;
4
- placeholder(index: number): string;
5
- quoteIdentifier(identifier: string): string;
6
- nowExpression(): string;
7
- /** Authoritative database wall clock for persisted lease/retry deadlines. */
8
- epochMillisecondsExpression(): string;
9
- /** Current reads/row locks; SQLite serializes writes at transaction admission. */
10
- rowLockClause(skipLocked?: boolean): string;
11
- /** Render a Date as a literal this engine accepts for a timestamp column. */
12
- timestampValue(value: Date): string;
13
- returningClause(columns: string): string;
14
- ilikeOperator(): "ILIKE" | "LIKE";
15
- nullsLastSuffix(): string;
16
- castToText(expression: string): string;
17
- /** Conflict handling appended to an INSERT. Empty updates mean "do nothing". */
18
- upsertSuffix(conflictColumns: readonly string[], updateColumns: readonly string[]): string;
19
- }
20
- declare function dialectFor(driver: DatabaseDriver): SqlDialect;
1
+ import type { DatabaseDriver } from "./schema/driver.ts";
2
+ import { dialectFor, type SqlDialect } from "./sqlDialects";
3
+ /** Resolve only the explicitly owned async SQL context. */
21
4
  declare function currentSqlDialect(): SqlDialect;
22
- declare function useSqlDialect(driver: DatabaseDriver): SqlDialect;
23
5
  /** Format a timestamp parameter for whichever engine is active. */
24
6
  declare function sqlTimestamp(value?: Date): string;
25
- declare function resetSqlDialect(): void;
26
- declare function runWithSqlDialect<T>(driver: DatabaseDriver, callback: () => T | Promise<T>): T | Promise<T>;
7
+ declare function runWithSqlDialect<T>(driver: DatabaseDriver, callback: () => T): T;
27
8
  export type { SqlDialect };
28
- export { currentSqlDialect, dialectFor, resetSqlDialect, runWithSqlDialect, sqlTimestamp, useSqlDialect, };
9
+ export { currentSqlDialect, dialectFor, runWithSqlDialect, sqlTimestamp };