@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.
- package/CHANGELOG.md +27 -0
- package/dist/core/audit/exportAuditLogs.d.ts +12 -3
- package/dist/core/audit/exportStore.d.ts +6 -2
- package/dist/core/audit/siemFormatter.d.ts +2 -2
- package/dist/core/auth/abilityCatalog.d.ts +1 -9
- package/dist/core/auth/authContext.d.ts +2 -0
- package/dist/core/auth/authOutcome.d.ts +32 -0
- package/dist/core/auth/authReader.d.ts +22 -0
- package/dist/core/auth/basicAuthGuard.d.ts +19 -3
- package/dist/core/auth/emailVerification.d.ts +1 -1
- package/dist/core/auth/guard.d.ts +27 -6
- package/dist/core/auth/intendedUrlCookie.d.ts +13 -7
- package/dist/core/auth/jwt.d.ts +5 -4
- package/dist/core/auth/jwtGuard.d.ts +7 -6
- package/dist/core/auth/membershipContext.d.ts +10 -7
- package/dist/core/auth/membershipContextMiddleware.d.ts +3 -3
- package/dist/core/auth/membershipMiddleware.d.ts +1 -2
- package/dist/core/auth/membershipServiceImplementation.d.ts +1 -1
- package/dist/core/auth/oauth/oidcIdToken.d.ts +25 -16
- package/dist/core/auth/oauth/oidcProvider.d.ts +6 -4
- package/dist/core/auth/oauth/providers.d.ts +3 -1
- package/dist/core/auth/oneTimeToken.d.ts +2 -3
- package/dist/core/auth/passwordConfirmCookie.d.ts +15 -6
- package/dist/core/auth/passwordLogin.d.ts +5 -5
- package/dist/core/auth/pendingMfaCookie.d.ts +2 -2
- package/dist/core/auth/policy.d.ts +23 -10
- package/dist/core/auth/requireAuthCapability.d.ts +3 -0
- package/dist/core/auth/resolveMembershipService.d.ts +3 -2
- package/dist/core/auth/saml/samlAssertionReplay.d.ts +4 -4
- package/dist/core/auth/saml/samlServiceProvider.d.ts +11 -7
- package/dist/core/auth/scimAuthMiddleware.d.ts +10 -3
- package/dist/core/auth/sessionCookie.d.ts +20 -9
- package/dist/core/auth/sessionGuard.d.ts +14 -3
- package/dist/core/cache/createCacheStore.d.ts +6 -3
- package/dist/core/cache/redisCacheStore.d.ts +5 -1
- package/dist/core/cache/repository.d.ts +5 -1
- package/dist/core/cache/simpleCache.d.ts +2 -1
- package/dist/core/cache/tokens.d.ts +8 -0
- package/dist/core/config/applicationConfig.d.ts +21 -0
- package/dist/core/config/configSnapshot.d.ts +3 -0
- package/dist/core/config/envSchema.d.ts +3 -2
- package/dist/core/contracts/application.d.ts +153 -0
- package/dist/core/contracts/authUserDirectory.d.ts +24 -7
- package/dist/core/contracts/container.d.ts +20 -23
- package/dist/core/contracts/di.d.ts +4 -2
- package/dist/core/contracts/executionContext.d.ts +5 -0
- package/dist/core/contracts/executionOperations.d.ts +10 -0
- package/dist/core/contracts/executionOwnership.d.ts +38 -0
- package/dist/core/contracts/persistence.d.ts +20 -0
- package/dist/core/contracts/serviceTokens.d.ts +32 -18
- package/dist/core/contracts/services.d.ts +63 -0
- package/dist/core/contracts/token.d.ts +19 -0
- package/dist/core/crypto/fieldEncryption.d.ts +19 -7
- package/dist/core/crypto/fieldEncryptionRotation.d.ts +21 -5
- package/dist/core/crypto/mfaSecret.d.ts +10 -3
- package/dist/core/database/baseRepository.d.ts +14 -10
- package/dist/core/database/bindings.d.ts +6 -0
- package/dist/core/database/bunSql.d.ts +3 -12
- package/dist/core/database/definitions.d.ts +209 -0
- package/dist/core/database/dialect.d.ts +5 -24
- package/dist/core/database/driverPorts.d.ts +116 -0
- package/dist/core/database/errors.d.ts +47 -7
- package/dist/core/database/factory.d.ts +51 -31
- package/dist/core/database/index.d.ts +9 -10
- package/dist/core/database/keyset.d.ts +2 -1
- package/dist/core/database/legacyNativeTransaction.d.ts +5 -0
- package/dist/core/database/manager.d.ts +12 -0
- package/dist/core/database/model.d.ts +91 -97
- package/dist/core/database/modelQuery.d.ts +9 -5
- package/dist/core/database/modelRegistry.d.ts +52 -33
- package/dist/core/database/mysqlConnection.d.ts +1 -19
- package/dist/core/database/mysqlNative.d.ts +38 -0
- package/dist/core/database/nativeTransactions.d.ts +16 -0
- package/dist/core/database/ormInternal.d.ts +85 -0
- package/dist/core/database/ormRuntime.d.ts +4 -0
- package/dist/core/database/ownedReadOnlyObservation.d.ts +16 -0
- package/dist/core/database/postgresNative.d.ts +11 -0
- package/dist/core/database/query.d.ts +24 -23
- package/dist/core/database/queryPlanSnapshot.d.ts +7 -0
- package/dist/core/database/rawMysql.d.ts +7 -0
- package/dist/core/database/rawPostgres.d.ts +23 -0
- package/dist/core/database/rawSqlite.d.ts +6 -0
- package/dist/core/database/relationQueries.d.ts +3 -2
- package/dist/core/database/relationQuery.d.ts +24 -6
- package/dist/core/database/repositoryQuery.d.ts +6 -1
- package/dist/core/database/schema/driver.d.ts +1 -1
- package/dist/core/database/seeders/types.d.ts +1 -1
- package/dist/core/database/session.d.ts +13 -0
- package/dist/core/database/sessionFactory.d.ts +9 -0
- package/dist/core/database/sqlDialects.d.ts +22 -0
- package/dist/core/database/tokens.d.ts +7 -0
- package/dist/core/database/transactionSession.d.ts +43 -0
- package/dist/core/errors/http.d.ts +4 -1
- package/dist/core/events/{eventBus.d.ts → eventBusClass.d.ts} +1 -3
- package/dist/core/events/index.d.ts +2 -3
- package/dist/core/events/outbox/index.d.ts +44 -13
- package/dist/core/events/outbox/metrics.d.ts +4 -4
- package/dist/core/events/outbox/workerTransport.d.ts +17 -0
- package/dist/core/http/authMiddleware.d.ts +2 -2
- package/dist/core/http/authorizeMiddleware.d.ts +2 -2
- package/dist/core/http/bodySizeLimitMiddleware.d.ts +1 -1
- package/dist/core/http/conditionalResponse.d.ts +7 -2
- package/dist/core/http/contentSecurityPolicy.d.ts +4 -3
- package/dist/core/http/corsMiddleware.d.ts +2 -1
- package/dist/core/http/csrfMiddleware.d.ts +6 -1
- package/dist/core/http/csrfToken.d.ts +17 -7
- package/dist/core/http/databaseError.d.ts +4 -0
- package/dist/core/http/etag.d.ts +5 -2
- package/dist/core/http/flashMiddleware.d.ts +1 -1
- package/dist/core/http/flashSession.d.ts +13 -7
- package/dist/core/http/index.d.ts +1 -1
- package/dist/core/http/loginThrottleMiddleware.d.ts +3 -3
- package/dist/core/http/memoryThrottleMiddleware.d.ts +2 -2
- package/dist/core/http/parseMultipartUpload.d.ts +3 -2
- package/dist/core/http/requestMetaContext.d.ts +5 -0
- package/dist/core/http/requireAbilityMiddleware.d.ts +1 -1
- package/dist/core/http/requireAuthMiddleware.d.ts +2 -2
- package/dist/core/http/requirePasswordConfirmMiddleware.d.ts +2 -1
- package/dist/core/http/requireVerifiedMiddleware.d.ts +2 -2
- package/dist/core/http/requireWebAuthMiddleware.d.ts +2 -2
- package/dist/core/http/response.d.ts +4 -3
- package/dist/core/http/scimThrottleMiddleware.d.ts +4 -3
- package/dist/core/http/securedRouteModelBinding.d.ts +10 -3
- package/dist/core/http/securityHeadersMiddleware.d.ts +1 -2
- package/dist/core/http/signedUrl.d.ts +8 -6
- package/dist/core/http/throttleMiddleware.d.ts +9 -5
- package/dist/core/http/uploads.d.ts +9 -3
- package/dist/core/http/webErrorResponse.d.ts +8 -2
- package/dist/core/jobs/exportAuditLogsJob.d.ts +5 -2
- package/dist/core/jobs/invalidateCacheTagsJob.d.ts +5 -4
- package/dist/core/lifecycle/gracefulShutdown.d.ts +2 -5
- package/dist/core/logging/requestLoggingMiddleware.d.ts +1 -1
- package/dist/core/mail/mailer.d.ts +7 -5
- package/dist/core/openapi/generator.d.ts +12 -4
- package/dist/core/openapi/registeredRoute.d.ts +4 -4
- package/dist/core/queue/createAppQueue.d.ts +9 -4
- package/dist/core/queue/failedJobMetrics.d.ts +11 -2
- package/dist/core/queue/failedJobRepository.d.ts +6 -3
- package/dist/core/queue/failedJobService.d.ts +1 -0
- package/dist/core/queue/index.d.ts +16 -6
- package/dist/core/queue/jobRegistry.d.ts +3 -2
- package/dist/core/queue/jobRunner.d.ts +10 -4
- package/dist/core/queue/publicQueue.d.ts +18 -9
- package/dist/core/queue/queueConfig.d.ts +20 -10
- package/dist/core/queue/queueHandoff.d.ts +31 -0
- package/dist/core/queue/queueMetrics.d.ts +10 -3
- package/dist/core/queue/queueServices.d.ts +28 -0
- package/dist/core/queue/queueWorkerTransport.d.ts +28 -0
- package/dist/core/queue/redisQueue.d.ts +19 -10
- package/dist/core/queue/redisQueueKeys.d.ts +5 -5
- package/dist/core/queue/redisStreams.d.ts +17 -10
- package/dist/core/queue/resilientQueue.d.ts +10 -4
- package/dist/core/queue/types.d.ts +1 -0
- package/dist/core/runtime/appKeyPrefix.d.ts +5 -5
- package/dist/core/runtime/application.d.ts +7 -0
- package/dist/core/runtime/executionContext.d.ts +9 -0
- package/dist/core/runtime/executionTasks.d.ts +49 -0
- package/dist/core/runtime/resourceJournal.d.ts +67 -0
- package/dist/core/runtime/serviceGraph.d.ts +14 -0
- package/dist/core/security/oauthState.d.ts +13 -9
- package/dist/core/security/publicReads.d.ts +2 -2
- package/dist/core/security/safeFetch.d.ts +1 -0
- package/dist/core/security/safeUrl.d.ts +3 -0
- package/dist/core/security/scimTenantTokens.d.ts +1 -1
- package/dist/core/security/tokenExpiry.d.ts +1 -1
- package/dist/core/security/webhookSignature.d.ts +1 -1
- package/dist/core/storage/storage.d.ts +24 -16
- package/dist/core/tenant/databaseTenantContext.d.ts +5 -7
- package/dist/core/tenant/resolveTenant.d.ts +2 -2
- package/dist/core/tenant/scopedDatabasePolicy.d.ts +8 -0
- package/dist/core/tenant/tenantDatabaseScope.d.ts +3 -7
- package/dist/core/tenant/tenantMiddleware.d.ts +15 -4
- package/dist/core/tracing/otel.d.ts +4 -6
- package/dist/core/tracing/tracingMiddleware.d.ts +3 -3
- package/dist/core/view/etaViewEngine.d.ts +1 -1
- package/dist/core/view/index.d.ts +5 -4
- package/dist/core/view/tokens.d.ts +8 -0
- package/dist/core/view/viewRenderer.d.ts +2 -2
- package/dist/core/view/webErrorView.d.ts +8 -7
- package/dist/core/view/webLayoutData.d.ts +6 -4
- package/dist/entries/audit/exportAuditLogs.js +87 -1024
- package/dist/entries/audit/siemFormatter.js +4 -90
- package/dist/entries/auth/abilityCatalog.js +28 -0
- package/dist/entries/auth/accessControl.js +5 -16
- package/dist/entries/auth/accountStateMigration.js +216 -236
- package/dist/entries/auth/authOutcome.js +80 -0
- package/dist/entries/auth/authReader.js +68 -0
- package/dist/entries/auth/basicAuthGuard.js +144 -1249
- package/dist/entries/auth/emailVerification.js +2 -2
- package/dist/entries/auth/intendedUrlCookie.js +35 -59
- package/dist/entries/auth/jwt.js +22 -47
- package/dist/entries/auth/jwtGuard.js +99 -231
- package/dist/entries/auth/membershipMiddleware.js +71 -10
- package/dist/entries/auth/membershipScope.js +16 -22
- package/dist/entries/auth/membershipService.js +11 -28
- package/dist/entries/auth/oauth/oidcProvider.js +59 -64
- package/dist/entries/auth/oauth/providers.js +12 -95
- package/dist/entries/auth/oauth/samlProvider.js +53 -1080
- package/dist/entries/auth/oneTimeToken.js +27 -289
- package/dist/entries/auth/passwordConfirmCookie.js +40 -63
- package/dist/entries/auth/passwordLogin.js +94 -399
- package/dist/entries/auth/pendingMfaCookie.js +6 -6
- package/dist/entries/auth/policy.js +22 -56
- package/dist/entries/auth/saml/samlServiceProvider.js +55 -1084
- package/dist/entries/auth/scimAuthMiddleware.js +16 -3358
- package/dist/entries/auth/sessionCookie.js +58 -73
- package/dist/entries/auth/sessionGuard.js +95 -248
- package/dist/entries/auth/tokenHash.js +11 -43
- package/dist/entries/cache/createCacheStore.js +126 -117
- package/dist/entries/cache/repository.js +25 -0
- package/dist/entries/cache/simpleCache.js +12 -7
- package/dist/entries/cache/tokens.js +9 -0
- package/dist/entries/config/applicationConfig.js +163 -0
- package/dist/entries/config/envSchema.js +21 -4
- package/dist/entries/contracts/application.js +1 -0
- package/dist/entries/contracts/authUserDirectory.js +10 -0
- package/dist/entries/contracts/container.js +99 -26
- package/dist/entries/contracts/di.js +3 -0
- package/dist/entries/contracts/executionContext.js +7 -0
- package/dist/entries/contracts/executionOperations.js +7 -0
- package/dist/entries/contracts/executionOwnership.js +7 -0
- package/dist/entries/contracts/membership.js +1 -0
- package/dist/entries/contracts/persistence.js +1 -0
- package/dist/entries/contracts/serviceTokens.js +26 -116
- package/dist/entries/contracts/services.js +98 -0
- package/dist/entries/contracts/token.js +41 -0
- package/dist/entries/crypto/fieldEncryption.js +49 -50
- package/dist/entries/crypto/mfaSecret.js +86 -82
- package/dist/entries/database/acquisitionMetrics.js +107 -0
- package/dist/entries/database/baseRepository.d.ts +2 -0
- package/dist/entries/database/bindings.js +2082 -0
- package/dist/entries/database/definitions.js +175 -0
- package/dist/entries/database/errors.js +114 -89
- package/dist/entries/database/factory.js +67 -28
- package/dist/entries/database/migrations.js +172 -224
- package/dist/entries/database/model.d.ts +1 -0
- package/dist/entries/database/ownedReadOnlyObservation.js +1282 -0
- package/dist/entries/database/query.js +159 -161
- package/dist/entries/database/repositoryQuery.d.ts +1 -0
- package/dist/entries/database/repositoryQuery.js +1 -1373
- package/dist/entries/database/schema.js +216 -236
- package/dist/entries/database/session.js +1 -0
- package/dist/entries/database/sqliteConnection.js +525 -83
- package/dist/entries/database/tokens.js +9 -0
- package/dist/entries/errors/http.js +118 -1
- package/dist/entries/http/authMiddleware.js +8 -5
- package/dist/entries/http/authorizeMiddleware.js +1 -1
- package/dist/entries/http/bodySizeLimitMiddleware.js +2 -2
- package/dist/entries/http/clientIp.js +2 -2
- package/dist/entries/http/conditionalResponse.js +19 -7
- package/dist/entries/http/corsMiddleware.js +6 -101
- package/dist/entries/http/csrfMiddleware.js +92 -106
- package/dist/entries/http/csrfToken.js +58 -94
- package/dist/entries/http/etag.js +7 -4
- package/dist/entries/http/flashMiddleware.js +57 -99
- package/dist/entries/http/flashSession.js +41 -68
- package/dist/entries/http/memoryThrottleMiddleware.js +43 -186
- package/dist/entries/http/metricsMiddleware.js +2 -16
- package/dist/entries/http/parseMultipartUpload.js +15 -29
- package/dist/entries/http/requireAbilityMiddleware.js +2 -2
- package/dist/entries/http/requirePasswordConfirmMiddleware.js +19 -31
- package/dist/entries/http/requireVerifiedMiddleware.js +4 -7
- package/dist/entries/http/requireWebAuthMiddleware.js +2 -2
- package/dist/entries/http/response.js +67 -233
- package/dist/entries/http/routeMiddleware.js +0 -14
- package/dist/entries/http/scimThrottleMiddleware.js +43 -237
- package/dist/entries/http/securedRouteModelBinding.js +37 -25
- package/dist/entries/http/securityHeadersMiddleware.js +8 -25
- package/dist/entries/http/signedUrl.js +20 -110
- package/dist/entries/http/throttleMiddleware.js +41 -185
- package/dist/entries/http/uploads.js +9 -24
- package/dist/entries/jobs/exportAuditLogsJob.js +17 -1498
- package/dist/entries/jobs/invalidateCacheTagsJob.js +12 -47
- package/dist/entries/logging/requestLoggingMiddleware.js +4 -4
- package/dist/entries/mail/mailer.js +68 -78
- package/dist/entries/openapi/generator.js +33 -100
- package/dist/entries/queue/createAppQueue.js +416 -254
- package/dist/entries/queue/failedJobRepository.js +19 -8
- package/dist/entries/queue/failedJobService.js +1 -0
- package/dist/entries/queue/jobRunner.js +141 -66
- package/dist/entries/queue/publicQueue.js +411 -255
- package/dist/entries/queue/queueConfig.js +61 -0
- package/dist/entries/queue/queueHandoff.js +318 -0
- package/dist/entries/queue/queueMetrics.js +989 -1384
- package/dist/entries/queue/queueServices.js +133 -0
- package/dist/entries/queue/queueWorkerTransport.js +1703 -0
- package/dist/entries/queue/redisQueue.js +282 -180
- package/dist/entries/queue.js +6 -45
- package/dist/entries/runtime/application.js +1585 -0
- package/dist/entries/runtime/asyncContextStore.js +0 -16
- package/dist/entries/security/oauthState.js +35 -67
- package/dist/entries/security/publicReads.js +4 -4
- package/dist/entries/security/safeFetch.js +1 -0
- package/dist/entries/security/scimTenantTokens.js +3 -3
- package/dist/entries/security/tokenExpiry.js +2 -2
- package/dist/entries/security/totp.js +1 -87
- package/dist/entries/security/webhookSignature.js +2 -90
- package/dist/entries/storage/storage.js +120 -45
- package/dist/entries/tenant/databaseTenantContext.js +6 -907
- package/dist/entries/tenant/publicTenantHost.js +78 -0
- package/dist/entries/tenant/resolveTenant.js +14 -0
- package/dist/entries/tenant/scopedDatabasePolicy.js +75 -0
- package/dist/entries/tenant/tenancyConfig.js +1 -19
- package/dist/entries/tenant/tenantDatabaseScope.js +3 -892
- package/dist/entries/tracing/tracingMiddleware.js +104 -173
- package/dist/entries/view/tokens.js +11 -0
- package/dist/framework/public-api.d.ts +62 -44
- package/dist/index.js +10433 -11347
- package/dist/internal/ormInternal.js +117 -0
- package/dist/internal/ormRuntime.js +5000 -0
- package/package.json +158 -46
- package/dist/core/database/bindConnection.d.ts +0 -1
- package/dist/core/database/boundConnection.d.ts +0 -5
- package/dist/core/database/defaultConnection.d.ts +0 -7
- package/dist/core/database/namedConnections.d.ts +0 -15
- package/dist/core/database/readOnlyCollector.d.ts +0 -7
- package/dist/core/database/repositoryConnection.d.ts +0 -4
- package/dist/core/database/transaction.d.ts +0 -23
- package/dist/core/database/transactionControl.d.ts +0 -6
- package/dist/core/events/deferredModelEvents.d.ts +0 -7
- package/dist/core/facades/index.d.ts +0 -10
- package/dist/core/runtime/applicationRegistry.d.ts +0 -18
- package/dist/entries/database/bindConnection.js +0 -1
- package/dist/entries/database/boundConnection.js +0 -1
- package/dist/entries/database/defaultConnection.js +0 -1
- package/dist/entries/database/namedConnections.js +0 -1
- package/dist/entries/database/repositoryConnection.js +0 -1
- package/dist/entries/database/transaction.js +0 -1
- package/dist/entries/facades.js +0 -711
- package/dist/entries/runtime/applicationRegistry.js +0 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,32 @@
|
|
|
1
1
|
# @getstrata/core changelog
|
|
2
2
|
|
|
3
|
+
## 3.0.3
|
|
4
|
+
|
|
5
|
+
Remove the separate successful-main-CI prerequisite; the release workflow still requires its own full quality gate before publication.
|
|
6
|
+
|
|
7
|
+
Fix npm publication of local release archives by resolving paths absolutely, avoiding GitHub shorthand interpretation. Exercise archive publication dry-runs in CI and before live publication. Preserve the failed v3.0.2 tag; its first publish failed before any package was published.
|
|
8
|
+
|
|
9
|
+
## 3.0.2
|
|
10
|
+
|
|
11
|
+
Complete the SOLID contract audit: storage deletion is idempotent `Promise<void>` across local and S3 drivers; model misses and required authentication use transport-neutral errors with HTTP 404/401 translation. Middleware accepts only the authentication capability it calls. These API changes and migration steps are documented in `docs/architecture/target-api-migration.md`.
|
|
12
|
+
|
|
13
|
+
Reconcile completed framework ownership and retirement documentation. Clarify the exact-commit main CI prerequisite, early-tag retry procedure, and maintainer release handoff; improve the release admission diagnostic without changing its checks.
|
|
14
|
+
|
|
15
|
+
Remove unused internal renderer/build compatibility helpers and migrate their test imports. Refresh v3 application, auth, discovery, queue, tracing and lifecycle guidance; clearly label retained 2.x qualification evidence.
|
|
16
|
+
|
|
17
|
+
## 3.0.1
|
|
18
|
+
|
|
19
|
+
Fix release archive packing for npm 12 package-keyed JSON output while retaining npm 11 compatibility. Validate archive identity and integrity, pin the publication toolchain, and exercise actual release packing in CI. The v3.0.0 tag remains unchanged; its failed workflow published no npm packages.
|
|
20
|
+
|
|
21
|
+
## 3.0.0
|
|
22
|
+
|
|
23
|
+
Breaking application-owned runtime, typed authorization and persistence, immutable starter plans, isolated adapters and authenticated queue handoffs.
|
|
24
|
+
|
|
25
|
+
## 2.2.60
|
|
26
|
+
|
|
27
|
+
- Preserve failed-job payloads as PostgreSQL JSONB objects by letting the native driver encode them once. Retain SQLite/MySQL JSON text mapping and readable legacy JSONB strings; timestamps, projections and replay admission/deletion ordering are unchanged.
|
|
28
|
+
- Add real PostgreSQL restricted-role persistence and replay regression coverage, including an independent stored-type oracle and legacy-string recovery.
|
|
29
|
+
|
|
3
30
|
## 2.2.59
|
|
4
31
|
|
|
5
32
|
- Reject unsupported SQLite column-level uniqueness during ADD COLUMN compilation, before any statement in a Schema.run plan executes. Use the existing nullable column plus table.unique() API; populated rows, duplicate rejection, CREATE behavior and PostgreSQL/MySQL SQL are preserved. #371
|
|
@@ -1,8 +1,17 @@
|
|
|
1
|
+
import { type EnvRecord } from "../runtime/appEnv";
|
|
2
|
+
import { type AuditExportSql } from "./exportStore";
|
|
1
3
|
interface AuditExportConfig {
|
|
2
4
|
endpoint: string;
|
|
3
5
|
format: "json" | "cef";
|
|
4
6
|
batchSize: number;
|
|
5
7
|
}
|
|
6
|
-
declare function resolveAuditExportConfig(): AuditExportConfig | null;
|
|
7
|
-
|
|
8
|
-
|
|
8
|
+
declare function resolveAuditExportConfig(env?: EnvRecord): AuditExportConfig | null;
|
|
9
|
+
interface AuditExporterOptions {
|
|
10
|
+
readonly runSql: AuditExportSql;
|
|
11
|
+
readonly environment: EnvRecord;
|
|
12
|
+
}
|
|
13
|
+
/** Capture policy once; each SQL scope settles before the outbound HTTP boundary. */
|
|
14
|
+
declare function createAuditExporter(options: AuditExporterOptions): () => Promise<number>;
|
|
15
|
+
declare function exportPendingAuditLogs(runSql: AuditExportSql, environment?: EnvRecord): Promise<number>;
|
|
16
|
+
export type { AuditExportConfig, AuditExporterOptions, AuditExportSql };
|
|
17
|
+
export { createAuditExporter, exportPendingAuditLogs, resolveAuditExportConfig };
|
|
@@ -1,3 +1,5 @@
|
|
|
1
|
+
import type { SelectedSession } from "../contracts/persistence";
|
|
2
|
+
type AuditExportSql = <T>(work: (selected: SelectedSession) => Promise<T>) => Promise<T>;
|
|
1
3
|
type PendingAuditLog = {
|
|
2
4
|
id: number;
|
|
3
5
|
user_id: number | null;
|
|
@@ -12,6 +14,8 @@ type PendingAuditLog = {
|
|
|
12
14
|
trace_id: string | null;
|
|
13
15
|
created_at: Date;
|
|
14
16
|
};
|
|
15
|
-
|
|
16
|
-
declare function
|
|
17
|
+
/** The supplied scope selects the application's connection and trusted SQL policy. */
|
|
18
|
+
declare function readPendingAuditLogs(runSql: AuditExportSql, batchSize: number): Promise<PendingAuditLog[]>;
|
|
19
|
+
declare function acknowledgeAuditLogs(runSql: AuditExportSql, ids: readonly number[]): Promise<void>;
|
|
20
|
+
export type { AuditExportSql };
|
|
17
21
|
export { acknowledgeAuditLogs, readPendingAuditLogs };
|
|
@@ -24,7 +24,7 @@ declare function formatSiemAuditEvent(input: {
|
|
|
24
24
|
checksum?: string | null;
|
|
25
25
|
payload?: Record<string, unknown>;
|
|
26
26
|
created_at: Date;
|
|
27
|
-
}): SiemAuditEvent;
|
|
28
|
-
declare function formatCefLine(event: SiemAuditEvent): string;
|
|
27
|
+
}, eventType?: string): SiemAuditEvent;
|
|
28
|
+
declare function formatCefLine(event: SiemAuditEvent, displayName?: string): string;
|
|
29
29
|
export type { SiemAuditEvent };
|
|
30
30
|
export { formatCefLine, formatSiemAuditEvent };
|
|
@@ -1,13 +1,5 @@
|
|
|
1
1
|
declare const MEMBER_ABILITIES: readonly ["profile:read", "auth:tokens:read", "auth:tokens:write", "auth:tokens:delete"];
|
|
2
2
|
declare const ADMIN_ABILITIES: readonly ["profile:read", "auth:tokens:read", "auth:tokens:write", "auth:tokens:delete", "webhooks:read", "webhooks:write", "audit:read", "audit:export"];
|
|
3
3
|
declare const PLATFORM_ADMIN_ABILITIES: readonly ["*"];
|
|
4
|
-
interface AbilityCatalog {
|
|
5
|
-
member: readonly string[];
|
|
6
|
-
admin: readonly string[];
|
|
7
|
-
resolveForRole(role: string | null | undefined): string[];
|
|
8
|
-
}
|
|
9
4
|
declare function resolveAbilitiesForRole(role: string | null | undefined): string[];
|
|
10
|
-
|
|
11
|
-
declare function abilityCatalog(): AbilityCatalog;
|
|
12
|
-
export type { AbilityCatalog };
|
|
13
|
-
export { ADMIN_ABILITIES, abilityCatalog, configureAbilityCatalog, MEMBER_ABILITIES, PLATFORM_ADMIN_ABILITIES, resolveAbilitiesForRole, };
|
|
5
|
+
export { ADMIN_ABILITIES, MEMBER_ABILITIES, PLATFORM_ADMIN_ABILITIES, resolveAbilitiesForRole };
|
|
@@ -1,6 +1,8 @@
|
|
|
1
1
|
type CredentialSource = "session" | "bearer" | "basic" | "guest" | null;
|
|
2
2
|
type AuthUser = {
|
|
3
3
|
id: number | string;
|
|
4
|
+
readonly name?: string;
|
|
5
|
+
readonly email?: string;
|
|
4
6
|
role?: string;
|
|
5
7
|
/** Current state from a trusted directory/guard, never an unverified client claim. */
|
|
6
8
|
isActive?: boolean;
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
import type { AuthUser, CredentialSource } from "./authContext";
|
|
2
|
+
/** Authentication is required, independent of the transport enforcing it. */
|
|
3
|
+
declare class AuthenticationRequiredError extends Error {
|
|
4
|
+
constructor(message?: string);
|
|
5
|
+
}
|
|
6
|
+
type AuthOutcome = Readonly<{
|
|
7
|
+
status: "absent";
|
|
8
|
+
user: null;
|
|
9
|
+
credentialSource: null;
|
|
10
|
+
}> | Readonly<{
|
|
11
|
+
status: "invalid";
|
|
12
|
+
user: null;
|
|
13
|
+
credentialSource: CredentialSource;
|
|
14
|
+
}> | Readonly<{
|
|
15
|
+
status: "authenticated";
|
|
16
|
+
user: AuthUser;
|
|
17
|
+
credentialSource: CredentialSource;
|
|
18
|
+
}> | Readonly<{
|
|
19
|
+
status: "error";
|
|
20
|
+
user: null;
|
|
21
|
+
credentialSource: CredentialSource;
|
|
22
|
+
error: unknown;
|
|
23
|
+
}>;
|
|
24
|
+
declare const absentAuth: AuthOutcome;
|
|
25
|
+
declare function invalidAuth(credentialSource: CredentialSource): AuthOutcome;
|
|
26
|
+
declare function authenticatedAuth(user: AuthUser, credentialSource: CredentialSource): AuthOutcome;
|
|
27
|
+
/** Validate untyped/custom adapter output before composing or establishing identity. */
|
|
28
|
+
declare function validatedAuthOutcome(input: unknown): AuthOutcome;
|
|
29
|
+
declare function authUserFromOutcome(outcome: AuthOutcome): AuthUser | null;
|
|
30
|
+
declare function authenticateProof(credentialSource: CredentialSource, present: boolean | (() => boolean), resolve: () => AuthUser | null | Promise<AuthUser | null>): Promise<AuthOutcome>;
|
|
31
|
+
export type { AuthOutcome };
|
|
32
|
+
export { AuthenticationRequiredError, absentAuth, authenticatedAuth, authenticateProof, authUserFromOutcome, invalidAuth, validatedAuthOutcome, };
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import { type AuthOutcome } from "@getstrata/core/auth/authOutcome";
|
|
2
|
+
import { type AuthUser, type CredentialSource } from "./authContext";
|
|
3
|
+
export interface AuthReader {
|
|
4
|
+
authenticate(request?: Request): Promise<AuthOutcome>;
|
|
5
|
+
resolve(request?: Request): Promise<AuthUser | null>;
|
|
6
|
+
resolveWithSource(request?: Request): Promise<{
|
|
7
|
+
user: AuthUser | null;
|
|
8
|
+
credentialSource: CredentialSource;
|
|
9
|
+
}>;
|
|
10
|
+
requireUser(request?: Request): Promise<AuthUser>;
|
|
11
|
+
check(request?: Request): Promise<boolean>;
|
|
12
|
+
user(request?: Request): Promise<AuthUser | null>;
|
|
13
|
+
}
|
|
14
|
+
type Established = Readonly<{
|
|
15
|
+
request: Request;
|
|
16
|
+
user: AuthUser | null;
|
|
17
|
+
credentialSource: CredentialSource;
|
|
18
|
+
}>;
|
|
19
|
+
export declare function runWithEstablishedAuth<T>(request: Request, auth: Omit<Established, "request">, work: () => T): T;
|
|
20
|
+
/** Reads only an explicitly installed established snapshot; never authenticates. */
|
|
21
|
+
export declare const establishedAuthReader: AuthReader;
|
|
22
|
+
export {};
|
|
@@ -1,10 +1,26 @@
|
|
|
1
|
-
import type
|
|
1
|
+
import { type AuthOutcome } from "@getstrata/core/auth/authOutcome";
|
|
2
|
+
import type { AuthAccountLookup, AuthCredentialVerifier, AuthEmailLookup, AuthUserRecord } from "../contracts/authUserDirectory";
|
|
3
|
+
import type { MfaSecretCodec } from "../crypto/mfaSecret";
|
|
2
4
|
import type { AuthUser } from "./authContext";
|
|
3
5
|
import type { AuthGuard } from "./guard";
|
|
6
|
+
type BasicAuthGuardOptions = {
|
|
7
|
+
accounts: AuthAccountLookup;
|
|
8
|
+
mfaSecrets: MfaSecretCodec;
|
|
9
|
+
persistRecovery(record: AuthUserRecord, hash: string): Promise<boolean>;
|
|
10
|
+
} & ({
|
|
11
|
+
emailLookup: AuthEmailLookup;
|
|
12
|
+
credentials?: AuthCredentialVerifier;
|
|
13
|
+
} | {
|
|
14
|
+
emailLookup?: AuthEmailLookup;
|
|
15
|
+
credentials: AuthCredentialVerifier;
|
|
16
|
+
});
|
|
4
17
|
declare class BasicAuthGuard implements AuthGuard {
|
|
5
|
-
private readonly
|
|
6
|
-
constructor(
|
|
18
|
+
private readonly options;
|
|
19
|
+
constructor(options: BasicAuthGuardOptions);
|
|
7
20
|
private persistRecovery;
|
|
21
|
+
authenticate(request: Request): Promise<AuthOutcome>;
|
|
8
22
|
resolve(request: Request): Promise<AuthUser | null>;
|
|
23
|
+
private resolveUser;
|
|
9
24
|
}
|
|
25
|
+
export type { BasicAuthGuardOptions };
|
|
10
26
|
export { BasicAuthGuard };
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import type { AuthUser } from "./authContext";
|
|
2
|
-
declare function isEmailVerificationRequired(): boolean;
|
|
2
|
+
declare function isEmailVerificationRequired(env: Readonly<Record<string, string | undefined>>): boolean;
|
|
3
3
|
/** Missing, undefined, or null means unverified. */
|
|
4
4
|
declare function hasVerifiedEmail(user: AuthUser): boolean;
|
|
5
5
|
export { hasVerifiedEmail, isEmailVerificationRequired };
|
|
@@ -1,10 +1,24 @@
|
|
|
1
|
-
import type
|
|
1
|
+
import { type AuthOutcome, absentAuth, authenticatedAuth, authenticateProof, authUserFromOutcome, invalidAuth, validatedAuthOutcome } from "@getstrata/core/auth/authOutcome";
|
|
2
|
+
import type { AuthBearerResolver } from "../contracts/authUserDirectory";
|
|
2
3
|
import type { AuthUser, CredentialSource } from "./authContext";
|
|
4
|
+
import { requireAuthCapability } from "./requireAuthCapability";
|
|
5
|
+
/** Security composition consumes outcomes; concrete resolve methods are user-only conveniences. */
|
|
3
6
|
interface AuthGuard {
|
|
4
|
-
|
|
7
|
+
authenticate(request: Request): AuthOutcome | Promise<AuthOutcome>;
|
|
5
8
|
}
|
|
6
9
|
declare class GuestGuard implements AuthGuard {
|
|
10
|
+
private readonly options;
|
|
11
|
+
constructor(options: {
|
|
12
|
+
production: boolean;
|
|
13
|
+
allowDevHeaders: boolean;
|
|
14
|
+
abilities: {
|
|
15
|
+
admin: readonly string[];
|
|
16
|
+
member: readonly string[];
|
|
17
|
+
};
|
|
18
|
+
});
|
|
19
|
+
authenticate(request: Request): AuthOutcome;
|
|
7
20
|
resolve(request: Request): AuthUser | null;
|
|
21
|
+
private resolveUser;
|
|
8
22
|
}
|
|
9
23
|
declare class ApiTokenGuard implements AuthGuard {
|
|
10
24
|
private readonly options;
|
|
@@ -12,16 +26,21 @@ declare class ApiTokenGuard implements AuthGuard {
|
|
|
12
26
|
token: string;
|
|
13
27
|
user: AuthUser;
|
|
14
28
|
});
|
|
29
|
+
authenticate(request: Request): AuthOutcome;
|
|
15
30
|
resolve(request: Request): AuthUser | null;
|
|
31
|
+
private resolveUser;
|
|
16
32
|
}
|
|
17
33
|
declare class DatabaseTokenGuard implements AuthGuard {
|
|
18
|
-
private readonly
|
|
19
|
-
constructor(
|
|
34
|
+
private readonly tokens;
|
|
35
|
+
constructor(tokens: AuthBearerResolver);
|
|
36
|
+
authenticate(request: Request): Promise<AuthOutcome>;
|
|
20
37
|
resolve(request: Request): Promise<AuthUser | null>;
|
|
38
|
+
private resolveUser;
|
|
21
39
|
}
|
|
22
40
|
declare class CompositeGuard implements AuthGuard {
|
|
23
41
|
private readonly guards;
|
|
24
42
|
constructor(guards: AuthGuard[]);
|
|
43
|
+
authenticate(request: Request): Promise<AuthOutcome>;
|
|
25
44
|
resolve(request: Request): Promise<AuthUser | null>;
|
|
26
45
|
}
|
|
27
46
|
declare class AuthManager {
|
|
@@ -32,6 +51,8 @@ declare class AuthManager {
|
|
|
32
51
|
registerGuard(name: string, next: AuthGuard): this;
|
|
33
52
|
use(name?: string): AuthGuard;
|
|
34
53
|
guardNames(): string[];
|
|
54
|
+
authenticate(request?: Request): Promise<AuthOutcome>;
|
|
55
|
+
/** User-only convenience; composition must consume authenticate(). */
|
|
35
56
|
resolve(request?: Request): Promise<AuthUser | null>;
|
|
36
57
|
resolveWithSource(request?: Request): Promise<{
|
|
37
58
|
user: AuthUser | null;
|
|
@@ -44,5 +65,5 @@ declare class AuthManager {
|
|
|
44
65
|
private authenticateRequest;
|
|
45
66
|
private tryNamedGuards;
|
|
46
67
|
}
|
|
47
|
-
export type { AuthGuard, AuthUser };
|
|
48
|
-
export { ApiTokenGuard, AuthManager, CompositeGuard, DatabaseTokenGuard, GuestGuard };
|
|
68
|
+
export type { AuthGuard, AuthOutcome, AuthUser };
|
|
69
|
+
export { ApiTokenGuard, AuthManager, absentAuth, authenticatedAuth, authenticateProof, authUserFromOutcome, CompositeGuard, DatabaseTokenGuard, GuestGuard, invalidAuth, requireAuthCapability, validatedAuthOutcome, };
|
|
@@ -1,10 +1,16 @@
|
|
|
1
|
-
declare const INTENDED_URL_COOKIE
|
|
1
|
+
declare const INTENDED_URL_COOKIE = "strata_intended";
|
|
2
2
|
declare const DEFAULT_INTENDED_URL_TTL_SECONDS: number;
|
|
3
|
-
|
|
4
|
-
|
|
3
|
+
export interface IntendedUrlCookieOptions {
|
|
4
|
+
readonly cookieName: string;
|
|
5
|
+
readonly ttlSeconds: number;
|
|
6
|
+
readonly production: boolean;
|
|
7
|
+
}
|
|
8
|
+
export declare function intendedUrlCookieOptionsFromEnvironment(env: Readonly<Record<string, string | undefined>>): IntendedUrlCookieOptions;
|
|
9
|
+
declare function intendedUrlCookieName(env: Readonly<Record<string, string | undefined>>): string;
|
|
10
|
+
declare function intendedUrlTtlSeconds(env: Readonly<Record<string, string | undefined>>): number;
|
|
5
11
|
declare function isStashableIntendedPath(path: string): boolean;
|
|
6
|
-
declare function createIntendedUrlCookie(path: string): string | null;
|
|
7
|
-
declare function createIntendedUrlCookieFromRequest(request: Request): string | null;
|
|
8
|
-
declare function readIntendedUrl(request: Request): string | null;
|
|
9
|
-
declare function clearIntendedUrlCookie(): string;
|
|
12
|
+
declare function createIntendedUrlCookie(path: string, options: IntendedUrlCookieOptions): string | null;
|
|
13
|
+
declare function createIntendedUrlCookieFromRequest(request: Request, options: IntendedUrlCookieOptions): string | null;
|
|
14
|
+
declare function readIntendedUrl(request: Request, options: IntendedUrlCookieOptions): string | null;
|
|
15
|
+
declare function clearIntendedUrlCookie(options: IntendedUrlCookieOptions): string;
|
|
10
16
|
export { clearIntendedUrlCookie, createIntendedUrlCookie, createIntendedUrlCookieFromRequest, DEFAULT_INTENDED_URL_TTL_SECONDS, INTENDED_URL_COOKIE, intendedUrlCookieName, intendedUrlTtlSeconds, isStashableIntendedPath, readIntendedUrl, };
|
package/dist/core/auth/jwt.d.ts
CHANGED
|
@@ -9,12 +9,13 @@ interface JwtPayload {
|
|
|
9
9
|
[key: string]: unknown;
|
|
10
10
|
}
|
|
11
11
|
interface SignJwtOptions {
|
|
12
|
-
secret
|
|
12
|
+
secret: string;
|
|
13
13
|
ttlSeconds?: number;
|
|
14
14
|
}
|
|
15
|
-
declare function
|
|
15
|
+
export declare function jwtOptionsFromEnvironment(env: Readonly<Record<string, string | undefined>>): SignJwtOptions;
|
|
16
|
+
declare function resolveJwtSecret(secret: string): string;
|
|
16
17
|
declare function jwtTtlSeconds(override?: number): number;
|
|
17
|
-
declare function signJwt(payload: JwtPayload, options
|
|
18
|
-
declare function verifyJwt(token: string, secret
|
|
18
|
+
declare function signJwt(payload: JwtPayload, options: SignJwtOptions): string;
|
|
19
|
+
declare function verifyJwt(token: string, secret: string): JwtPayload | null;
|
|
19
20
|
export type { JwtPayload, SignJwtOptions };
|
|
20
21
|
export { jwtTtlSeconds, resolveJwtSecret, signJwt, verifyJwt };
|
|
@@ -1,18 +1,19 @@
|
|
|
1
|
-
import type
|
|
2
|
-
import type {
|
|
1
|
+
import { type AuthOutcome } from "@getstrata/core/auth/authOutcome";
|
|
2
|
+
import type { AuthAccountLookup } from "../contracts/authUserDirectory";
|
|
3
3
|
import type { AuthUser } from "./authContext";
|
|
4
4
|
import type { AuthGuard } from "./guard";
|
|
5
5
|
import { type JwtPayload } from "./jwt";
|
|
6
6
|
interface JwtGuardOptions {
|
|
7
|
-
secret
|
|
8
|
-
directory
|
|
9
|
-
container?: ServiceContainerLike;
|
|
7
|
+
secret: string;
|
|
8
|
+
directory: AuthAccountLookup;
|
|
10
9
|
}
|
|
11
10
|
declare function authUserFromJwt(payload: JwtPayload): AuthUser;
|
|
12
11
|
declare class JwtGuard implements AuthGuard {
|
|
13
12
|
private readonly options;
|
|
14
|
-
constructor(options
|
|
13
|
+
constructor(options: JwtGuardOptions);
|
|
14
|
+
authenticate(request: Request): Promise<AuthOutcome>;
|
|
15
15
|
resolve(request: Request): Promise<AuthUser | null>;
|
|
16
|
+
private resolveUser;
|
|
16
17
|
}
|
|
17
18
|
export type { JwtGuardOptions };
|
|
18
19
|
export { authUserFromJwt, JwtGuard };
|
|
@@ -1,17 +1,20 @@
|
|
|
1
1
|
import type { MembershipLookup, OrganizationMemberRole } from "../contracts/membership";
|
|
2
|
+
import type { AuthUser } from "./authContext";
|
|
3
|
+
type MembershipSnapshot = readonly Readonly<{
|
|
4
|
+
organization_id: number;
|
|
5
|
+
role: OrganizationMemberRole;
|
|
6
|
+
}>[];
|
|
2
7
|
type MembershipContext = {
|
|
3
8
|
organizationIds: number[];
|
|
4
9
|
rolesByOrganizationId: Map<number, OrganizationMemberRole>;
|
|
5
10
|
};
|
|
6
11
|
declare const membershipContext: import("node:async_hooks").AsyncLocalStorage<MembershipContext>;
|
|
7
|
-
declare
|
|
8
|
-
declare function
|
|
9
|
-
declare function
|
|
10
|
-
declare function resetMembershipLookupForTests(): void;
|
|
11
|
-
declare function runWithMembershipContext<T>(callback: () => T | Promise<T>): Promise<T | Promise<T>>;
|
|
12
|
+
declare function loadMembershipSnapshot(lookup: MembershipLookup, user: AuthUser | null): Promise<MembershipSnapshot>;
|
|
13
|
+
declare function runWithMembershipSnapshot<T>(snapshot: MembershipSnapshot, callback: () => T): T;
|
|
14
|
+
declare function runWithMembershipContext<T>(lookup: MembershipLookup, user: AuthUser | null, callback: () => T | Promise<T>): Promise<T>;
|
|
12
15
|
declare function currentOrgRole(organizationId: number): OrganizationMemberRole | null;
|
|
13
16
|
declare function hasOrgMembership(organizationId: number): boolean;
|
|
14
17
|
declare function currentOrganizationIds(): number[];
|
|
15
18
|
declare function hasMinimumOrgRole(organizationId: number, minimum: OrganizationMemberRole): boolean;
|
|
16
|
-
export type { MembershipContext };
|
|
17
|
-
export {
|
|
19
|
+
export type { MembershipContext, MembershipSnapshot };
|
|
20
|
+
export { currentOrganizationIds, currentOrgRole, hasMinimumOrgRole, hasOrgMembership, loadMembershipSnapshot, membershipContext, runWithMembershipContext, runWithMembershipSnapshot, };
|
|
@@ -1,3 +1,3 @@
|
|
|
1
|
-
import type { Middleware } from "
|
|
2
|
-
|
|
3
|
-
export
|
|
1
|
+
import type { Middleware } from "../http/middleware";
|
|
2
|
+
import { type MembershipSnapshot } from "./membershipContext";
|
|
3
|
+
export declare function createMembershipContextMiddleware(snapshot: MembershipSnapshot): Middleware;
|
|
@@ -1,2 +1 @@
|
|
|
1
|
-
|
|
2
|
-
export { createMembershipMiddleware };
|
|
1
|
+
export { createMembershipContextMiddleware as createMembershipMiddleware } from "./membershipContextMiddleware";
|
|
@@ -3,7 +3,7 @@ import { type AuthUser } from "./authContext";
|
|
|
3
3
|
type MembershipRepositoryLike = MembershipLookup;
|
|
4
4
|
declare class MembershipService {
|
|
5
5
|
private readonly members;
|
|
6
|
-
constructor(members
|
|
6
|
+
constructor(members: MembershipRepositoryLike);
|
|
7
7
|
listOrganizationIdsForUser(userId: number): Promise<number[]>;
|
|
8
8
|
getOrgRole(userId: number, organizationId: number): Promise<OrganizationMemberRole | null>;
|
|
9
9
|
requireOrgAccess(organizationId: number, minimumRole?: OrganizationMemberRole, user?: AuthUser | null): Promise<OrganizationMemberRole>;
|
|
@@ -1,25 +1,34 @@
|
|
|
1
1
|
import type { JwtPayload } from "../jwt";
|
|
2
2
|
interface OidcDiscovery {
|
|
3
|
-
issuer?: string;
|
|
4
|
-
authorization_endpoint
|
|
5
|
-
token_endpoint
|
|
6
|
-
jwks_uri
|
|
3
|
+
readonly issuer?: string;
|
|
4
|
+
readonly authorization_endpoint: string;
|
|
5
|
+
readonly token_endpoint: string;
|
|
6
|
+
readonly jwks_uri: string;
|
|
7
7
|
}
|
|
8
|
-
|
|
8
|
+
interface OidcNetworkPolicy {
|
|
9
|
+
readonly production: boolean;
|
|
10
|
+
readonly allowPrivate?: boolean;
|
|
11
|
+
}
|
|
12
|
+
interface OidcClient {
|
|
13
|
+
loadDiscovery(issuer: string): Promise<OidcDiscovery>;
|
|
14
|
+
verifyIdToken(token: string, options: OidcVerificationOptions): Promise<JwtPayload>;
|
|
15
|
+
fetchOptions(url: string): ReturnType<typeof oidcSafeFetchOptions>;
|
|
16
|
+
}
|
|
17
|
+
interface OidcVerificationOptions {
|
|
18
|
+
issuer: string;
|
|
19
|
+
clientId: string;
|
|
20
|
+
nonce: string;
|
|
21
|
+
jwksUri: string;
|
|
22
|
+
accessToken?: string;
|
|
23
|
+
}
|
|
24
|
+
declare function createOidcClient(input?: OidcNetworkPolicy): OidcClient;
|
|
25
|
+
declare function oidcSafeFetchOptions(url: string, policy: OidcNetworkPolicy): {
|
|
26
|
+
production: boolean;
|
|
9
27
|
allowHttp: boolean;
|
|
10
28
|
allowPrivate: boolean;
|
|
11
29
|
timeoutMs: number;
|
|
12
30
|
maxRedirects: number;
|
|
13
31
|
};
|
|
14
|
-
declare function loadOidcDiscovery(issuer: string): Promise<OidcDiscovery>;
|
|
15
32
|
declare function oidcAccessTokenHash(accessToken: string): string;
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
clientId: string;
|
|
19
|
-
nonce: string;
|
|
20
|
-
jwksUri: string;
|
|
21
|
-
accessToken?: string;
|
|
22
|
-
}): Promise<JwtPayload>;
|
|
23
|
-
declare function resetOidcDiscoveryCacheForTests(): void;
|
|
24
|
-
export type { OidcDiscovery };
|
|
25
|
-
export { loadOidcDiscovery, oidcAccessTokenHash, oidcSafeFetchOptions, resetOidcDiscoveryCacheForTests, verifyOidcIdToken, };
|
|
33
|
+
export type { OidcClient, OidcDiscovery, OidcNetworkPolicy, OidcVerificationOptions };
|
|
34
|
+
export { createOidcClient, oidcAccessTokenHash };
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { type OidcNetworkPolicy } from "./oidcIdToken";
|
|
2
2
|
import type { OAuthProfile, OAuthProvider } from "./types";
|
|
3
3
|
interface OidcProviderOptions {
|
|
4
4
|
name: string;
|
|
@@ -6,7 +6,8 @@ interface OidcProviderOptions {
|
|
|
6
6
|
clientId: string;
|
|
7
7
|
clientSecret: string;
|
|
8
8
|
redirectUri: string;
|
|
9
|
-
scopes?: string[];
|
|
9
|
+
scopes?: readonly string[];
|
|
10
|
+
networkPolicy?: OidcNetworkPolicy;
|
|
10
11
|
}
|
|
11
12
|
interface OidcHandshake {
|
|
12
13
|
state: string;
|
|
@@ -15,8 +16,9 @@ interface OidcHandshake {
|
|
|
15
16
|
}
|
|
16
17
|
declare function createOidcHandshake(): OidcHandshake;
|
|
17
18
|
declare class OidcProvider implements OAuthProvider {
|
|
18
|
-
private readonly options;
|
|
19
19
|
readonly name: string;
|
|
20
|
+
private readonly options;
|
|
21
|
+
private readonly client;
|
|
20
22
|
constructor(options: OidcProviderOptions);
|
|
21
23
|
getAuthorizationUrl(_state: string, _redirectUri?: string): string;
|
|
22
24
|
createAuthorization(state?: string, redirectUri?: string): Promise<{
|
|
@@ -27,4 +29,4 @@ declare class OidcProvider implements OAuthProvider {
|
|
|
27
29
|
exchangeCode(code: string, redirectUri?: string, handshake?: Pick<OidcHandshake, "nonce" | "codeVerifier">): Promise<OAuthProfile>;
|
|
28
30
|
}
|
|
29
31
|
export type { OidcHandshake, OidcProviderOptions };
|
|
30
|
-
export { createOidcHandshake, OidcProvider
|
|
32
|
+
export { createOidcHandshake, OidcProvider };
|
|
@@ -3,10 +3,12 @@ interface GitHubOAuthOptions {
|
|
|
3
3
|
clientId: string;
|
|
4
4
|
clientSecret: string;
|
|
5
5
|
redirectUri: string;
|
|
6
|
+
readonly production: boolean;
|
|
7
|
+
readonly userAgent: string;
|
|
6
8
|
}
|
|
7
9
|
declare class GitHubOAuthProvider implements OAuthProvider {
|
|
8
|
-
private readonly options;
|
|
9
10
|
readonly name = "github";
|
|
11
|
+
private readonly options;
|
|
10
12
|
constructor(options: GitHubOAuthOptions);
|
|
11
13
|
getAuthorizationUrl(state: string, redirectUri?: string): string;
|
|
12
14
|
exchangeCode(code: string, redirectUri?: string): Promise<OAuthProfile>;
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import type { DatabaseSession, TransactionSession } from "../database/session";
|
|
1
2
|
declare const AUTH_ONE_TIME_PURPOSES: {
|
|
2
3
|
readonly passwordReset: "password_reset";
|
|
3
4
|
readonly emailVerify: "email_verify";
|
|
@@ -8,9 +9,7 @@ declare function generateOneTimeToken(): {
|
|
|
8
9
|
hash: string;
|
|
9
10
|
};
|
|
10
11
|
declare function hashOneTimeToken(plain: string): string;
|
|
11
|
-
type SqlClient =
|
|
12
|
-
unsafe<T>(query: string, params?: readonly unknown[]): Promise<T[]>;
|
|
13
|
-
};
|
|
12
|
+
type SqlClient = DatabaseSession | TransactionSession;
|
|
14
13
|
declare function consumeOneTimeToken(sql: SqlClient, purpose: string, plain: string, now?: Date): Promise<number | null>;
|
|
15
14
|
declare function revokeUserSessions(sql: SqlClient, userId: number, options?: {
|
|
16
15
|
revokeApiTokens?: boolean;
|
|
@@ -1,8 +1,17 @@
|
|
|
1
|
-
declare const PASSWORD_CONFIRM_COOKIE
|
|
1
|
+
declare const PASSWORD_CONFIRM_COOKIE = "strata_password_confirmed";
|
|
2
2
|
declare const DEFAULT_PASSWORD_CONFIRM_TTL_SECONDS: number;
|
|
3
|
-
declare function passwordConfirmCookieName(): string;
|
|
4
|
-
declare function passwordConfirmTtlSeconds(): number;
|
|
5
|
-
declare function
|
|
6
|
-
|
|
7
|
-
|
|
3
|
+
declare function passwordConfirmCookieName(env: Readonly<Record<string, string | undefined>>): string;
|
|
4
|
+
declare function passwordConfirmTtlSeconds(env: Readonly<Record<string, string | undefined>>): number;
|
|
5
|
+
export declare function passwordConfirmOptionsFromEnvironment(env: Readonly<Record<string, string | undefined>>): PasswordConfirmWriteOptions;
|
|
6
|
+
export interface PasswordConfirmReadOptions {
|
|
7
|
+
readonly secret: string;
|
|
8
|
+
readonly cookieName: string;
|
|
9
|
+
readonly ttlSeconds: number;
|
|
10
|
+
}
|
|
11
|
+
export interface PasswordConfirmWriteOptions extends PasswordConfirmReadOptions {
|
|
12
|
+
readonly production: boolean;
|
|
13
|
+
}
|
|
14
|
+
declare function hasFreshPasswordConfirmation(request: Request, userId: number, authVersion: number | undefined, options: PasswordConfirmReadOptions): boolean;
|
|
15
|
+
declare function createPasswordConfirmCookie(userId: number, authVersion: number | undefined, options: PasswordConfirmWriteOptions): string;
|
|
16
|
+
declare function clearPasswordConfirmCookie(options: Pick<PasswordConfirmWriteOptions, "production" | "cookieName">): string;
|
|
8
17
|
export { clearPasswordConfirmCookie, createPasswordConfirmCookie, DEFAULT_PASSWORD_CONFIRM_TTL_SECONDS, hasFreshPasswordConfirmation, PASSWORD_CONFIRM_COOKIE, passwordConfirmCookieName, passwordConfirmTtlSeconds, };
|
|
@@ -1,4 +1,6 @@
|
|
|
1
1
|
import type { AuthUserRecord } from "../contracts/authUserDirectory";
|
|
2
|
+
import { type MfaSecretCodec } from "../crypto/mfaSecret";
|
|
3
|
+
import type { DatabaseSession, TransactionSession } from "../database/session";
|
|
2
4
|
type PasswordLoginFailure = "mfa_required" | "mfa_invalid" | "account_inactive";
|
|
3
5
|
type PasswordLoginSuccess = {
|
|
4
6
|
ok: true;
|
|
@@ -10,11 +12,9 @@ type PasswordLoginDenied = {
|
|
|
10
12
|
};
|
|
11
13
|
type PasswordLoginResult = PasswordLoginSuccess | PasswordLoginDenied;
|
|
12
14
|
declare function parseRecoveryHashes(raw: string | null | undefined): string[];
|
|
13
|
-
declare function completePasswordLogin(user: Pick<AuthUserRecord, "is_active" | "mfa_enabled" | "mfa_secret" | "mfa_recovery_codes">, options
|
|
15
|
+
declare function completePasswordLogin(user: Pick<AuthUserRecord, "is_active" | "mfa_enabled" | "mfa_secret" | "mfa_recovery_codes">, options: {
|
|
14
16
|
mfaCode?: string | null;
|
|
15
|
-
}): PasswordLoginResult;
|
|
16
|
-
declare function persistConsumedRecoveryHash(sql:
|
|
17
|
-
unsafe(query: string, params?: readonly unknown[]): Promise<unknown[]>;
|
|
18
|
-
}, userId: number, currentRaw: string | null | undefined, consumedHash: string | undefined): Promise<void>;
|
|
17
|
+
}, mfaSecrets: MfaSecretCodec): PasswordLoginResult;
|
|
18
|
+
declare function persistConsumedRecoveryHash(sql: DatabaseSession | TransactionSession, userId: number, currentRaw: string | null | undefined, consumedHash: string | undefined): Promise<void>;
|
|
19
19
|
export type { PasswordLoginResult };
|
|
20
20
|
export { completePasswordLogin, parseRecoveryHashes, persistConsumedRecoveryHash };
|
|
@@ -2,8 +2,8 @@ interface PendingMfaChallenge {
|
|
|
2
2
|
userId: number;
|
|
3
3
|
authVersion: number;
|
|
4
4
|
}
|
|
5
|
-
declare function createPendingMfaCookie(userId: number, authVersion: number, secret: string): string;
|
|
5
|
+
declare function createPendingMfaCookie(userId: number, authVersion: number, secret: string, production?: boolean): string;
|
|
6
6
|
declare function readPendingMfaCookie(request: Request, secret: string): PendingMfaChallenge | null;
|
|
7
|
-
declare function clearPendingMfaCookie(): string;
|
|
7
|
+
declare function clearPendingMfaCookie(production?: boolean): string;
|
|
8
8
|
export type { PendingMfaChallenge };
|
|
9
9
|
export { clearPendingMfaCookie, createPendingMfaCookie, readPendingMfaCookie };
|
|
@@ -1,15 +1,28 @@
|
|
|
1
|
+
/** Every policy decision is awaited, including synchronous policies. */
|
|
2
|
+
type PolicyDecision = boolean | Promise<boolean>;
|
|
1
3
|
declare abstract class Policy {
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
delete(_user?: unknown, _resource?: unknown): boolean;
|
|
4
|
+
view(_user?: unknown, _resource?: unknown): PolicyDecision;
|
|
5
|
+
create(_user?: unknown): PolicyDecision;
|
|
6
|
+
update(_user?: unknown, _resource?: unknown): PolicyDecision;
|
|
7
|
+
delete(_user?: unknown, _resource?: unknown): PolicyDecision;
|
|
7
8
|
}
|
|
8
|
-
|
|
9
|
+
/** Domain denial; transport adapters decide how to present it. */
|
|
10
|
+
declare class PolicyDeniedError extends Error {
|
|
9
11
|
constructor();
|
|
12
|
+
}
|
|
13
|
+
type PolicyAction<T> = {
|
|
14
|
+
[K in keyof T]: T[K] extends (...args: never[]) => PolicyDecision ? K : never;
|
|
15
|
+
}[keyof T] & string;
|
|
16
|
+
type PolicyArguments<T> = T extends (...args: infer Args) => PolicyDecision ? Args : never;
|
|
17
|
+
/** Supply a policy map type (or constructor map) for typed custom actions and arguments. */
|
|
18
|
+
declare class PolicyGate<Policies extends {
|
|
19
|
+
[K in keyof Policies]: Policy;
|
|
20
|
+
} = Record<string, Policy>> {
|
|
10
21
|
private readonly policies;
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
22
|
+
constructor(policies?: Policies);
|
|
23
|
+
register<Resource extends keyof Policies & string>(resource: Resource, policy: Policies[Resource]): void;
|
|
24
|
+
allows<Resource extends keyof Policies & string, Action extends PolicyAction<Policies[Resource]>>(resource: Resource, action: Action, user: PolicyArguments<Policies[Resource][Action]>[0], ...model: PolicyArguments<Policies[Resource][Action]> extends [unknown?, ...infer Rest] ? Rest : never): Promise<boolean>;
|
|
25
|
+
authorize<Resource extends keyof Policies & string, Action extends PolicyAction<Policies[Resource]>>(resource: Resource, action: Action, user: PolicyArguments<Policies[Resource][Action]>[0], ...model: PolicyArguments<Policies[Resource][Action]> extends [unknown?, ...infer Rest] ? Rest : never): Promise<void>;
|
|
14
26
|
}
|
|
15
|
-
export {
|
|
27
|
+
export type { PolicyAction, PolicyDecision };
|
|
28
|
+
export { Policy, PolicyDeniedError, PolicyGate };
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import type { MembershipLookup } from "../contracts/membership";
|
|
1
2
|
import MembershipService from "./membershipServiceImplementation";
|
|
2
|
-
|
|
3
|
-
export
|
|
3
|
+
/** Composition supplies the live lookup; no current-application selection. */
|
|
4
|
+
export declare function resolveMembershipService(members: MembershipLookup): MembershipService;
|