@getstrata/bootstrap 2.2.60 → 3.0.5

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 (90) hide show
  1. package/CHANGELOG.md +35 -0
  2. package/dist/bootstrap/app.d.ts +18 -7
  3. package/dist/bootstrap/buildModuleRoutes.d.ts +3 -5
  4. package/dist/bootstrap/buildWebModuleRoutes.d.ts +2 -3
  5. package/dist/bootstrap/cache/modelCacheTags.d.ts +3 -2
  6. package/dist/bootstrap/cachedJson.d.ts +7 -2
  7. package/dist/bootstrap/config.d.ts +1 -1
  8. package/dist/bootstrap/context.d.ts +25 -7
  9. package/dist/bootstrap/contracts.d.ts +1 -0
  10. package/dist/bootstrap/createWebRoutes.d.ts +2 -1
  11. package/dist/bootstrap/databaseReadiness.d.ts +3 -0
  12. package/dist/bootstrap/dependencies.d.ts +3 -2
  13. package/dist/bootstrap/discoverJobs.d.ts +3 -2
  14. package/dist/bootstrap/discoverListeners.d.ts +10 -7
  15. package/dist/bootstrap/discoverModels.d.ts +3 -2
  16. package/dist/bootstrap/discoverModules.d.ts +7 -6
  17. package/dist/bootstrap/health.d.ts +3 -2
  18. package/dist/bootstrap/http/securedRouteModelBinding.d.ts +1 -1
  19. package/dist/bootstrap/httpKernel.d.ts +43 -22
  20. package/dist/bootstrap/httpPersistence.d.ts +4 -0
  21. package/dist/bootstrap/inProcessCron.d.ts +5 -5
  22. package/dist/bootstrap/listeners/invalidateCacheOnModelWrite.d.ts +13 -12
  23. package/dist/bootstrap/metricsRoutes.d.ts +6 -1
  24. package/dist/bootstrap/moduleRouteMiddleware.d.ts +4 -4
  25. package/dist/bootstrap/modules.d.ts +1 -1
  26. package/dist/bootstrap/ownedHttpRoute.d.ts +23 -0
  27. package/dist/bootstrap/persistenceContracts.d.ts +70 -0
  28. package/dist/bootstrap/persistenceInvocation.d.ts +4 -0
  29. package/dist/bootstrap/providers/auth.d.ts +21 -0
  30. package/dist/bootstrap/providers/cache.d.ts +9 -3
  31. package/dist/bootstrap/providers/cacheProvider.d.ts +3 -0
  32. package/dist/bootstrap/providers/config.d.ts +6 -3
  33. package/dist/bootstrap/providers/events.d.ts +5 -2
  34. package/dist/bootstrap/providers/index.d.ts +3 -2
  35. package/dist/bootstrap/providers/listeners.d.ts +3 -3
  36. package/dist/bootstrap/providers/mail.d.ts +15 -0
  37. package/dist/bootstrap/providers/queue.d.ts +3 -2
  38. package/dist/bootstrap/providers/storage.d.ts +11 -2
  39. package/dist/bootstrap/providers/tracing.d.ts +4 -2
  40. package/dist/bootstrap/providers/view.d.ts +8 -5
  41. package/dist/bootstrap/public-api.d.ts +10 -7
  42. package/dist/bootstrap/queue/defaultJobs.d.ts +4 -2
  43. package/dist/bootstrap/rateLimit.d.ts +13 -3
  44. package/dist/bootstrap/routeCompiler.d.ts +20 -0
  45. package/dist/bootstrap/routeMetadata.d.ts +3 -3
  46. package/dist/bootstrap/routePlan.d.ts +11 -0
  47. package/dist/bootstrap/schedule.d.ts +11 -2
  48. package/dist/bootstrap/secretsGuard.d.ts +2 -3
  49. package/dist/bootstrap/web/routing.d.ts +6 -3
  50. package/dist/bootstrap/web/server.d.ts +14 -4
  51. package/dist/bootstrap/web/session.d.ts +23 -16
  52. package/dist/entries/buildModuleRoutes.js +602 -384
  53. package/dist/entries/buildWebModuleRoutes.js +596 -347
  54. package/dist/entries/cache/modelCacheTags.js +8 -186
  55. package/dist/entries/cachedJson.js +22 -0
  56. package/dist/entries/config.js +1 -3
  57. package/dist/entries/context.js +665 -700
  58. package/dist/entries/createSpaRoutes.js +194 -5
  59. package/dist/entries/createWebRoutes.js +618 -367
  60. package/dist/entries/databaseReadiness.js +267 -0
  61. package/dist/entries/dependencies.js +666 -701
  62. package/dist/entries/discoverJobs.js +18 -16
  63. package/dist/entries/discoverListeners.js +27 -38
  64. package/dist/entries/discoverModels.js +4 -3
  65. package/dist/entries/discoverModules.js +29 -67
  66. package/dist/entries/health.js +14 -34
  67. package/dist/entries/httpKernel.js +405 -89
  68. package/dist/entries/listeners/invalidateCacheOnModelWrite.js +43 -289
  69. package/dist/entries/metricsRoutes.js +9 -5
  70. package/dist/entries/persistenceContracts.js +1 -0
  71. package/dist/entries/persistenceInvocation.js +17 -0
  72. package/dist/entries/providers/auth.js +114 -0
  73. package/dist/entries/providers/cache.js +35 -0
  74. package/dist/entries/providers/events.js +55 -0
  75. package/dist/entries/providers/view.js +34 -44
  76. package/dist/entries/providers.js +392 -561
  77. package/dist/entries/queue/defaultJobs.js +9 -6
  78. package/dist/entries/routePlan.js +200 -0
  79. package/dist/entries/schedule.js +37 -37
  80. package/dist/entries/secretsGuard.js +10 -13
  81. package/dist/entries/web/routing.js +412 -96
  82. package/dist/entries/web/server.js +461 -29
  83. package/dist/entries/web/session.js +61 -73
  84. package/dist/index.js +1520 -1085
  85. package/dist/internal/ownedHttpRoute.js +66 -0
  86. package/package.json +52 -15
  87. package/dist/bootstrap/applicationRegistry.d.ts +0 -1
  88. package/dist/bootstrap/routeRegistry.d.ts +0 -10
  89. package/dist/entries/applicationRegistry.js +0 -24
  90. package/dist/entries/routeRegistry.js +0 -29
package/CHANGELOG.md CHANGED
@@ -1,5 +1,40 @@
1
1
  # @getstrata/bootstrap changelog
2
2
 
3
+ ## 3.0.5
4
+
5
+ - Fixed SQLite queries returning no rows when SQL begins with comments, including VALUES, PRAGMA, EXPLAIN, and compact RETURNING statements.
6
+ - Aligned memory and Redis cache expiration. Added put and forever to ordinary, tagged, and execution-scoped caches. Zero or negative TTLs now remove entries; invalid numeric TTLs are rejected before effects.
7
+ - Fixed stale cache loaders overwriting newer writes and empty cache keys bypassing memory limits.
8
+ - Fixed internal redirect validation bypasses and preserved repeated query parameters.
9
+ - Fixed malformed intended-URL and flash cookies throwing errors.
10
+ - Fixed CI package dry-runs failing when the package version was already published.
11
+
12
+ **Migration:** Replace Redis TTL 0 used for permanent storage with forever(). For a permanent configured default, use . TTL units remain milliseconds.
13
+
14
+ ## 3.0.4
15
+
16
+ Restore workspace-based npm publication and remove custom archive packing/recovery. Skip confirmed existing versions, stop on registry lookup failures, and accept successful npm uploads without requiring immediate registry visibility. Retain release quality gates, pinned npm, provenance and publication dry-runs. The v3.0.3 attempt published only @getstrata/core before its visibility check failed.
17
+
18
+ ## 3.0.3
19
+
20
+ Remove the separate successful-main-CI prerequisite; the release workflow still requires its own full quality gate before publication.
21
+
22
+ 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.
23
+
24
+ ## 3.0.2
25
+
26
+ 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.
27
+
28
+ 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.
29
+
30
+ ## 3.0.1
31
+
32
+ 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.
33
+
34
+ ## 3.0.0
35
+
36
+ Breaking application-owned runtime, typed authorization and persistence, immutable starter plans, isolated adapters and authenticated queue handoffs.
37
+
3
38
  ## 2.2.60
4
39
 
5
40
  - Align the core requirement with the 2.2.60 PostgreSQL failed-job persistence correction. Bootstrap, HTTP/auth, lifecycle and public/protected contracts are unchanged.
@@ -1,13 +1,24 @@
1
- import { type ShutdownResult } from "@getstrata/core/lifecycle/gracefulShutdown";
1
+ import type { StopResult } from "@getstrata/core/contracts/application";
2
+ import { type AppContextOptions } from "./context";
3
+ import { type ServiceProvider } from "./contracts";
4
+ import { type NativeServerOptions } from "./web/server";
5
+ export interface AppOptions extends AppContextOptions {
6
+ readonly providers?: readonly ServiceProvider[];
7
+ readonly port: number;
8
+ readonly native?: NativeServerOptions;
9
+ readonly cron?: Readonly<{
10
+ schedule: import("@getstrata/core/scheduler/schedule").Schedule;
11
+ options: import("@getstrata/core/scheduler/schedule").SchedulerRunOptions;
12
+ }>;
13
+ }
2
14
  declare class App {
3
- private server?;
4
15
  private startup?;
5
- private lifecycle?;
16
+ private readonly owner;
6
17
  private uninstallSignals?;
18
+ constructor(options: AppOptions);
19
+ get application(): import("@getstrata/core/contracts/application").Application;
7
20
  serve(): Promise<void>;
8
- private start;
9
- shutdown(reason?: string): Promise<ShutdownResult>;
10
- stop(force?: boolean): void;
11
- private resolvePort;
21
+ shutdown(reason?: string): Promise<StopResult>;
22
+ stop(): Promise<StopResult>;
12
23
  }
13
24
  export default App;
@@ -1,10 +1,8 @@
1
1
  import type { AppDependencies, AppModule, AppRouteMap } from "./contracts";
2
- import { registerOpenApiRouteMap } from "./routeMetadata";
3
2
  interface BuildModuleRoutesOptions {
4
3
  apiPrefix?: string;
5
- modules?: AppModule[];
6
- clearRegistry?: boolean;
4
+ modules: readonly AppModule[];
7
5
  }
8
- declare function buildModuleRoutes(dependencies: AppDependencies, options?: BuildModuleRoutesOptions): AppRouteMap;
6
+ declare function buildModuleRoutes(dependencies: AppDependencies, options: BuildModuleRoutesOptions): AppRouteMap;
9
7
  export type { BuildModuleRoutesOptions };
10
- export { buildModuleRoutes, registerOpenApiRouteMap };
8
+ export { buildModuleRoutes };
@@ -1,9 +1,8 @@
1
1
  import type { AppDependencies, AppModule, AppRouteMap } from "./contracts";
2
2
  interface BuildWebModuleRoutesOptions {
3
- modules?: AppModule[];
4
- clearRegistry?: boolean;
3
+ modules: readonly AppModule[];
5
4
  seedRoutes?: Record<string, unknown>;
6
5
  }
7
- declare function buildWebModuleRoutes(dependencies: AppDependencies, options?: BuildWebModuleRoutesOptions): AppRouteMap;
6
+ declare function buildWebModuleRoutes(dependencies: AppDependencies, options: BuildWebModuleRoutesOptions): AppRouteMap;
8
7
  export type { BuildWebModuleRoutesOptions };
9
8
  export { buildWebModuleRoutes };
@@ -1,3 +1,4 @@
1
- declare function cacheTagsForModelWrite(tableName: string, action: string): string[];
2
- declare function discoverModelTableNames(): string[];
1
+ import type { AppModule } from "../contracts";
2
+ declare function cacheTagsForModelWrite(tableName: string, action: string, modules: readonly AppModule[]): string[];
3
+ declare function discoverModelTableNames(modules: readonly AppModule[]): string[];
3
4
  export { cacheTagsForModelWrite, discoverModelTableNames };
@@ -1,3 +1,8 @@
1
+ import type { CacheLike } from "@getstrata/core/cache/tokens";
2
+ import { type JsonResponsePolicy } from "@getstrata/core/http/conditionalResponse";
1
3
  import type { AppDependencies, CachedJson } from "./contracts";
2
- declare function createCachedJson(dependencies: Pick<AppDependencies, "cache">): CachedJson;
3
- export { createCachedJson };
4
+ declare function createCachedJson(cache: CacheLike, policy: JsonResponsePolicy): CachedJson;
5
+ /** Standalone assembly defaults to ETags; owned applications bind a captured policy. */
6
+ declare function createApplicationCachedJson(dependencies: Pick<AppDependencies, "cache" | "container">): CachedJson;
7
+ export type { JsonResponsePolicy };
8
+ export { createApplicationCachedJson, createCachedJson };
@@ -5,7 +5,7 @@ declare const CACHE_DRIVER_CONFIG_KEY = "cache.driver";
5
5
  declare const REDIS_URL_CONFIG_KEY = "cache.redisUrl";
6
6
  declare const DATABASE_URL_CONFIG_KEY = "database.url";
7
7
  declare const CSRF_TARGET_ORIGIN_CONFIG_KEY = "http.csrf.targetOrigin";
8
- 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, } from "@getstrata/core/contracts/serviceTokens";
8
+ 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, } from "@getstrata/core/contracts/serviceTokens";
9
9
  declare const AUTH_DEV_HEADERS_CONFIG_KEY = "auth.allowDevHeaders";
10
10
  declare const DEFAULT_APP_PORT = 3000;
11
11
  declare const DEFAULT_CACHE_TTL_MS = 3600000;
@@ -1,12 +1,30 @@
1
+ import type { Application, ApplicationDefinition } from "@getstrata/core/contracts/application";
1
2
  import { type AppContext, type AppModule, type ProviderContext, type ServiceProvider } from "./contracts";
2
- type InitializedAppContext = AppContext & {
3
+ import type { HttpPersistenceOptions, PersistenceInvocation } from "./persistenceContracts";
4
+ export type InitializedAppContext = AppContext & {
5
+ readonly application: Application;
6
+ readonly invoke: PersistenceInvocation;
3
7
  drain(): Promise<void>;
4
8
  flush(): Promise<void>;
5
9
  dispose(): Promise<void>;
6
10
  };
7
- declare function collectProviders(modules?: AppModule[]): ServiceProvider[];
8
- declare function runProviderPhase(providers: readonly ServiceProvider[], phase: "register" | "boot", context: ProviderContext): Promise<void>;
9
- declare function createAppContext(providers?: readonly ServiceProvider[]): Promise<InitializedAppContext>;
10
- declare const appContext: AppContext;
11
- export type { InitializedAppContext };
12
- export { appContext, collectProviders, createAppContext, runProviderPhase };
11
+ export interface AppContextOptions {
12
+ readonly definition: ApplicationDefinition;
13
+ readonly connection: string;
14
+ readonly http?: HttpPersistenceOptions;
15
+ readonly providersFromScope?: (scope: import("@getstrata/core/contracts/application").ProviderScope) => readonly ServiceProvider[];
16
+ readonly onConstructed?: (handle: Readonly<{
17
+ application: Application;
18
+ invoke: PersistenceInvocation;
19
+ }>) => undefined;
20
+ }
21
+ export declare function collectProviders(modules?: readonly AppModule[]): ServiceProvider[];
22
+ export declare function runProviderPhase(providers: readonly ServiceProvider[], phase: "register" | "boot", context: ProviderContext): Promise<void>;
23
+ /** No provider or pool effects occur until the single canonical application starts. */
24
+ export interface ApplicationContextHandle {
25
+ readonly application: Application;
26
+ readonly invoke: PersistenceInvocation;
27
+ start(): Promise<InitializedAppContext>;
28
+ }
29
+ export declare function createApplicationContext(providers: readonly ServiceProvider[], options: AppContextOptions): ApplicationContextHandle;
30
+ export declare function createAppContext(providers: readonly ServiceProvider[] | undefined, options: AppContextOptions): Promise<InitializedAppContext>;
@@ -22,4 +22,5 @@ interface AppModule {
22
22
  webRoutes?(context: ModuleRouteContext): AppRouteMap;
23
23
  }
24
24
  export type { OpenApiOperation, OpenApiRouteMap, OpenApiSchema, } from "@getstrata/core/openapi/registeredRoute";
25
+ export type { BusinessRequestPorts, BusinessRouteHandler, HttpPersistenceOptions, } from "./persistenceContracts";
25
26
  export type { AppModule, ModuleRouteContext };
@@ -1,6 +1,7 @@
1
1
  import type { AppDependencies, AppModule, AppRouteMap } from "./contracts";
2
2
  interface CreateWebRoutesOptions {
3
- modules?: AppModule[];
3
+ modules?: readonly AppModule[];
4
+ publicDir?: string;
4
5
  }
5
6
  declare function createWebRoutes(dependencies: AppDependencies, options?: CreateWebRoutesOptions): AppRouteMap;
6
7
  declare function mergeWebRoutes(dependencies: AppDependencies, routes: AppRouteMap, options?: CreateWebRoutesOptions): AppRouteMap;
@@ -0,0 +1,3 @@
1
+ import { type ServiceDeclaration } from "@getstrata/core/contracts/services";
2
+ /** Declared app graph dependency keeps awaited native probes before transport admission. */
3
+ export declare function createDatabaseReadinessBindings(connection: string, env: Readonly<Record<string, string | undefined>>): readonly ServiceDeclaration[];
@@ -1,4 +1,5 @@
1
- import { createAppContext } from "./context";
2
- declare function createAppDependencies(): Promise<import("./contracts").AppDependencies>;
1
+ import { type AppContextOptions, createAppContext } from "./context";
2
+ import type { ServiceProvider } from "./contracts";
3
+ declare function createAppDependencies(providers: readonly ServiceProvider[] | undefined, options: AppContextOptions): Promise<import("./contracts").AppDependencies>;
3
4
  export type { AppContext, AppDependencies } from "./contracts";
4
5
  export { createAppContext, createAppDependencies };
@@ -1,4 +1,5 @@
1
1
  import { Job } from "@getstrata/core/queue";
2
+ import type { JobRegistry } from "@getstrata/core/queue/jobRegistry";
2
3
  import { type InfrastructureDiscoveryOptions } from "./infrastructureDiscovery";
3
4
  type DiscoveredJobClass = (new () => Job) & {
4
5
  jobName: string;
@@ -10,7 +11,7 @@ type JobManifestEntry = DiscoveredJobClass | {
10
11
  interface DiscoverJobsOptions extends InfrastructureDiscoveryOptions {
11
12
  manifest?: readonly JobManifestEntry[];
12
13
  }
13
- declare function discoverJobs(options?: DiscoverJobsOptions): Promise<string[]>;
14
- declare function resetDiscoverJobsForTests(): void;
14
+ declare function discoverJobs(registry: JobRegistry, options?: DiscoverJobsOptions): Promise<string[]>;
15
+ declare function resetDiscoverJobsForTests(registry: JobRegistry): void;
15
16
  export type { DiscoveredJobClass, DiscoverJobsOptions, JobManifestEntry };
16
17
  export { discoverJobs, resetDiscoverJobsForTests };
@@ -1,9 +1,12 @@
1
+ import type { ServiceDeclaration } from "@getstrata/core/contracts/services";
2
+ import type { RepositoryEffectsDeclaration } from "@getstrata/core/database/definitions";
1
3
  import { type InfrastructureDiscoveryOptions } from "./infrastructureDiscovery";
2
- type ListenerRegistrar = () => void | Promise<void>;
3
- interface DiscoverListenersOptions extends InfrastructureDiscoveryOptions {
4
- manifest?: readonly ListenerRegistrar[];
4
+ /** Inert graph declarations, collected before application construction and pool effects. */
5
+ export interface ListenerDeclarations {
6
+ readonly services: readonly ServiceDeclaration[];
7
+ readonly repositoryEffects: readonly RepositoryEffectsDeclaration[];
5
8
  }
6
- declare function discoverListeners(options?: DiscoverListenersOptions): Promise<ListenerRegistrar[]>;
7
- declare function resetDiscoverListenersForTests(): void;
8
- export type { DiscoverListenersOptions, ListenerRegistrar };
9
- export { discoverListeners, resetDiscoverListenersForTests };
9
+ export interface DiscoverListenersOptions extends InfrastructureDiscoveryOptions {
10
+ readonly manifest?: readonly ListenerDeclarations[];
11
+ }
12
+ export declare function discoverListeners(options?: DiscoverListenersOptions): Promise<readonly ListenerDeclarations[]>;
@@ -1,8 +1,9 @@
1
- /** Import trusted application model modules, then bind and boot their exported classes. */
1
+ import { type AnyModelDefinition } from "@getstrata/core/database/definitions";
2
+ /** Import trusted application model modules, then collect their immutable exported definitions. */
2
3
  interface DiscoverModelsOptions {
3
4
  /** Startup orchestration files are not model modules; avoids importing the awaiting caller. */
4
5
  exclude?: readonly string[];
5
6
  }
6
- declare function discoverModels(directory?: string, options?: DiscoverModelsOptions): Promise<object[]>;
7
+ declare function discoverModels(directory?: string, options?: DiscoverModelsOptions): Promise<AnyModelDefinition[]>;
7
8
  export type { DiscoverModelsOptions };
8
9
  export { discoverModels };
@@ -4,10 +4,11 @@ interface DiscoverModulesOptions {
4
4
  exclude?: readonly string[];
5
5
  manifest?: readonly AppModule[];
6
6
  }
7
- declare function configureModulesDirectory(modulesDir: string): void;
8
- declare function configureModulesManifest(manifest: readonly AppModule[]): void;
9
- declare function ensureModulesLoaded(options?: DiscoverModulesOptions): Promise<AppModule[]>;
10
- declare function discoverModules(): AppModule[];
11
- declare function resetDiscoverModulesForTests(): void;
7
+ /** A discovery owner captures its source and owns its pending result, including retries. */
8
+ declare function createModuleDiscovery(options: DiscoverModulesOptions): Readonly<{
9
+ load(): Promise<readonly AppModule[]>;
10
+ }>;
11
+ /** One-shot discovery; applications retain the returned immutable module list. */
12
+ declare function ensureModulesLoaded(options: DiscoverModulesOptions): Promise<readonly AppModule[]>;
12
13
  export type { DiscoverModulesOptions };
13
- export { configureModulesDirectory, configureModulesManifest, discoverModules, ensureModulesLoaded, resetDiscoverModulesForTests, };
14
+ export { createModuleDiscovery, ensureModulesLoaded };
@@ -1,3 +1,4 @@
1
+ import type { PersistenceInvocation } from "@getstrata/core/contracts/persistence";
1
2
  import type { AppDependencies } from "./contracts";
2
3
  interface CreateHealthRoutesOptions {
3
4
  pingOnHealth?: boolean;
@@ -7,12 +8,12 @@ interface CreateHealthRoutesOptions {
7
8
  healthFormat?: "json" | "text";
8
9
  extra?: Record<string, unknown> | (() => Record<string, unknown> | Promise<Record<string, unknown>>);
9
10
  }
10
- declare function checkDatabase(): Promise<boolean>;
11
- declare function pingDatabase(): Promise<boolean>;
11
+ declare function pingDatabase(invoke: PersistenceInvocation): Promise<boolean>;
12
12
  declare function checkRedis(redisUrl: string): Promise<boolean>;
13
13
  declare function createHealthRoutes(dependencies: AppDependencies, options?: CreateHealthRoutesOptions): {
14
14
  "/health": (request?: Request) => Promise<Response>;
15
15
  "/ready": () => Promise<Response>;
16
16
  };
17
17
  export type { CreateHealthRoutesOptions };
18
+ declare const checkDatabase: typeof pingDatabase;
18
19
  export { checkDatabase, checkRedis, createHealthRoutes, pingDatabase };
@@ -1,2 +1,2 @@
1
- export type { RouteModelAuthorization } from "@getstrata/core/http/securedRouteModelBinding";
1
+ export type { RouteModelAuthorization, RouteModelBindingPorts, } from "@getstrata/core/http/securedRouteModelBinding";
2
2
  export { securedBindRouteModel, securedBindRouteModelByKey, } from "@getstrata/core/http/securedRouteModelBinding";
@@ -1,51 +1,72 @@
1
1
  import type { AuthUser } from "@getstrata/core/auth/authContext";
2
+ import { type AuthReader } from "@getstrata/core/auth/authReader";
2
3
  import type { Policy } from "@getstrata/core/auth/policy";
3
4
  import type { Middleware, RouteHandler } from "@getstrata/core/http/middleware";
5
+ import type { RouteModelBindingPorts } from "@getstrata/core/http/securedRouteModelBinding";
6
+ import type { ComposedRouteHandler } from "#strata-http-route";
4
7
  import type { AppDependencies } from "./contracts";
8
+ import type { BusinessRouteHandler, IdentityPolicyMode } from "./persistenceContracts";
5
9
  type MiddlewareGroupName = "api" | "authenticated" | "web";
6
10
  type WebGuestHome = string | ((user: AuthUser) => string | Promise<string>);
7
11
  declare class HttpKernel {
8
12
  private readonly dependencies;
9
13
  private readonly ownedThrottles;
10
14
  private disposed;
15
+ private readonly emailVerificationRequired;
16
+ private readonly viewsEnabled;
17
+ private readonly publicReadsEnabled;
18
+ private readonly etagEnabled;
19
+ private readonly httpOptions;
20
+ private readonly responsePolicy;
11
21
  private readonly configuredCsrfMiddleware;
22
+ private readonly responses;
23
+ private readonly persistence;
12
24
  constructor(dependencies: AppDependencies);
25
+ private requireFlashOptions;
26
+ private requireIntendedOptions;
27
+ routeModelBindingPorts(auth: Pick<AuthReader, "resolve">): RouteModelBindingPorts;
13
28
  dispose(): void;
14
29
  /** Own custom disposable throttle middleware until this application closes. */
15
30
  ownThrottle<T extends Middleware>(throttle: T): T;
16
31
  globalMiddleware(errorFormat?: "json" | "web"): Middleware[];
32
+ run<TRequest extends Request>(request: TRequest, handler: BusinessRouteHandler<TRequest>, format?: "json" | "web", identity?: readonly IdentityPolicyMode[], scim?: readonly Middleware[]): Promise<Response>;
33
+ composed<TRequest extends Request>(handler: BusinessRouteHandler<TRequest>, format: "json" | "web", identity?: readonly IdentityPolicyMode[] | undefined, scim?: readonly Middleware[] | undefined): ComposedRouteHandler<TRequest>;
34
+ wrapIdentity<TRequest extends Request>(handler: BusinessRouteHandler<TRequest>, modes?: readonly IdentityPolicyMode[]): ComposedRouteHandler<TRequest>;
35
+ wrapPasswordConfirm<TRequest extends Request>(handler: BusinessRouteHandler<TRequest>): ComposedRouteHandler<TRequest>;
36
+ wrapRouteMap(routes: Record<string, unknown>, middleware: readonly Middleware[]): Record<string, unknown>;
37
+ wrapScim<TRequest extends Request>(handler: BusinessRouteHandler<TRequest>, before?: readonly Middleware[]): ComposedRouteHandler<TRequest>;
17
38
  private responseMiddleware;
18
39
  /** Public application documents still own response policy and observation. */
19
40
  wrapPublicDocument<TRequest extends Request = Request>(handler: RouteHandler<TRequest>): RouteHandler<TRequest>;
20
41
  group(name: MiddlewareGroupName): Middleware[];
21
- wrap<TRequest extends Request = Request>(groups: MiddlewareGroupName | MiddlewareGroupName[], handler: RouteHandler<TRequest>): RouteHandler<TRequest>;
22
- wrapApi<TRequest extends Request = Request>(handler: RouteHandler<TRequest>): RouteHandler<TRequest>;
23
- wrapWeb<TRequest extends Request = Request>(handler: RouteHandler<TRequest>): RouteHandler<TRequest>;
42
+ wrap<TRequest extends Request = Request>(groups: MiddlewareGroupName | MiddlewareGroupName[], handler: BusinessRouteHandler<TRequest>): ComposedRouteHandler<TRequest>;
43
+ wrapApi<TRequest extends Request = Request>(handler: BusinessRouteHandler<TRequest>): ComposedRouteHandler<TRequest>;
44
+ wrapWeb<TRequest extends Request = Request>(handler: BusinessRouteHandler<TRequest>): ComposedRouteHandler<TRequest>;
24
45
  /** Signed-in HTML users redirect to `home` instead of seeing guest pages. */
25
- wrapWebGuest<TRequest extends Request = Request>(handler: RouteHandler<TRequest>, home?: WebGuestHome): RouteHandler<TRequest>;
26
- wrapWebPublicRead<TRequest extends Request = Request>(handler: RouteHandler<TRequest>, options?: {
46
+ wrapWebGuest<TRequest extends Request = Request>(handler: BusinessRouteHandler<TRequest>, home?: WebGuestHome): ComposedRouteHandler<TRequest>;
47
+ wrapWebPublicRead<TRequest extends Request = Request>(handler: BusinessRouteHandler<TRequest>, options?: {
27
48
  allowAnonymous?: boolean;
28
- }): RouteHandler<TRequest>;
29
- wrapWebAuthenticated<TRequest extends Request = Request>(handler: RouteHandler<TRequest>): RouteHandler<TRequest>;
49
+ }): ComposedRouteHandler<TRequest>;
50
+ wrapWebAuthenticated<TRequest extends Request = Request>(handler: BusinessRouteHandler<TRequest>): ComposedRouteHandler<TRequest>;
30
51
  /** Signed-in HTML without the email-verified gate (logout, verification notice). */
31
- wrapWebAuthenticatedAllowUnverified<TRequest extends Request = Request>(handler: RouteHandler<TRequest>): RouteHandler<TRequest>;
32
- wrapWebVerified<TRequest extends Request = Request>(handler: RouteHandler<TRequest>): RouteHandler<TRequest>;
52
+ wrapWebAuthenticatedAllowUnverified<TRequest extends Request = Request>(handler: BusinessRouteHandler<TRequest>): ComposedRouteHandler<TRequest>;
53
+ wrapWebVerified<TRequest extends Request = Request>(handler: BusinessRouteHandler<TRequest>): ComposedRouteHandler<TRequest>;
33
54
  /** Requires a fresh signed password-confirmation cookie. */
34
- wrapWebPasswordConfirm<TRequest extends Request = Request>(handler: RouteHandler<TRequest>): RouteHandler<TRequest>;
35
- wrapWebAbility<TRequest extends Request = Request>(ability: string, handler: RouteHandler<TRequest>): RouteHandler<TRequest>;
36
- wrapWebGlobalAdmin<TRequest extends Request = Request>(handler: RouteHandler<TRequest>): RouteHandler<TRequest>;
37
- wrapAuthenticated<TRequest extends Request = Request>(handler: RouteHandler<TRequest>): RouteHandler<TRequest>;
55
+ wrapWebPasswordConfirm<TRequest extends Request = Request>(handler: BusinessRouteHandler<TRequest>): ComposedRouteHandler<TRequest>;
56
+ wrapWebAbility<TRequest extends Request = Request>(ability: string, handler: BusinessRouteHandler<TRequest>): ComposedRouteHandler<TRequest>;
57
+ wrapWebGlobalAdmin<TRequest extends Request = Request>(handler: BusinessRouteHandler<TRequest>): ComposedRouteHandler<TRequest>;
58
+ wrapAuthenticated<TRequest extends Request = Request>(handler: BusinessRouteHandler<TRequest>): ComposedRouteHandler<TRequest>;
38
59
  /** JSON routes that require a verified email. No-op when `FEATURE_EMAIL_VERIFICATION` is off. */
39
- wrapVerified<TRequest extends Request = Request>(handler: RouteHandler<TRequest>): RouteHandler<TRequest>;
40
- wrapPublicRead<TRequest extends Request = Request>(handler: RouteHandler<TRequest>, options?: {
60
+ wrapVerified<TRequest extends Request = Request>(handler: BusinessRouteHandler<TRequest>): ComposedRouteHandler<TRequest>;
61
+ wrapPublicRead<TRequest extends Request = Request>(handler: BusinessRouteHandler<TRequest>, options?: {
41
62
  allowAnonymous?: boolean;
42
- }): RouteHandler<TRequest>;
43
- wrapGlobalAdmin<TRequest extends Request = Request>(handler: RouteHandler<TRequest>): RouteHandler<TRequest>;
44
- wrapAbility<TRequest extends Request = Request>(ability: string, handler: RouteHandler<TRequest>): RouteHandler<TRequest>;
45
- wrapPolicy<TRequest extends Request = Request>(resource: string, action: keyof Policy, handler: RouteHandler<TRequest>): RouteHandler<TRequest>;
46
- wrapLogin<TRequest extends Request = Request>(handler: RouteHandler<TRequest>): RouteHandler<TRequest>;
47
- wrapSigned<TRequest extends Request = Request>(handler: RouteHandler<TRequest>): RouteHandler<TRequest>;
48
- wrapRegister<TRequest extends Request = Request>(handler: RouteHandler<TRequest>): RouteHandler<TRequest>;
63
+ }): ComposedRouteHandler<TRequest>;
64
+ wrapGlobalAdmin<TRequest extends Request = Request>(handler: BusinessRouteHandler<TRequest>): ComposedRouteHandler<TRequest>;
65
+ wrapAbility<TRequest extends Request = Request>(ability: string, handler: BusinessRouteHandler<TRequest>): ComposedRouteHandler<TRequest>;
66
+ wrapPolicy<TRequest extends Request = Request>(resource: string, action: keyof Policy, handler: BusinessRouteHandler<TRequest>): ComposedRouteHandler<TRequest>;
67
+ wrapLogin<TRequest extends Request = Request>(handler: BusinessRouteHandler<TRequest>): ComposedRouteHandler<TRequest>;
68
+ wrapSigned<TRequest extends Request = Request>(handler: BusinessRouteHandler<TRequest>): ComposedRouteHandler<TRequest>;
69
+ wrapRegister<TRequest extends Request = Request>(handler: BusinessRouteHandler<TRequest>): ComposedRouteHandler<TRequest>;
49
70
  private wrapWebAuth;
50
71
  private verifiedMiddleware;
51
72
  private wrapThrottle;
@@ -0,0 +1,4 @@
1
+ import type { PersistenceInvocation } from "@getstrata/core/contracts/persistence";
2
+ import type { BusinessRouteHandler, HttpPersistenceOptions, IdentityPolicyMode } from "./persistenceContracts";
3
+ export { HTTP_PERSISTENCE_OPTIONS } from "#strata-http-route";
4
+ export declare function createHttpPersistence(invoke: PersistenceInvocation, options: HttpPersistenceOptions): <T extends Request>(request: T, handler: BusinessRouteHandler<T>, identity?: readonly IdentityPolicyMode[], scim?: boolean) => Promise<Response>;
@@ -1,5 +1,5 @@
1
- import "./schedule";
2
- declare function startInProcessCronIfEnabled(): void;
3
- declare function stopInProcessCron(): void;
4
- declare function drainInProcessCron(): Promise<void>;
5
- export { drainInProcessCron, startInProcessCronIfEnabled, stopInProcessCron };
1
+ import type { ResourceSpec } from "@getstrata/core/contracts/application";
2
+ import { type InProcessCronJob } from "@getstrata/core/scheduler/osCron";
3
+ import { type Schedule, type SchedulerRunOptions } from "@getstrata/core/scheduler/schedule";
4
+ /** Existing native cron adapter, with instance-owned admission and actual callback drain. */
5
+ export declare function createInProcessCronResource(schedule: Schedule, options: SchedulerRunOptions): ResourceSpec<InProcessCronJob>;
@@ -1,12 +1,13 @@
1
- import { type EventBus } from "@getstrata/core/events";
2
- import type { DurableListener, SqlOutbox } from "@getstrata/core/events/outbox";
3
- import type { CacheLike } from "../../types/services";
4
- interface ModelCacheInvalidationOptions {
5
- outbox?: SqlOutbox;
6
- }
7
- /** Include in the application's one outbox registry; never dispatch through Redis queues. */
8
- declare function createModelCacheInvalidationListener(resolveCache?: () => CacheLike): DurableListener;
9
- /** Durable mode requires the outbox schema and an explicit business transaction. */
10
- declare function registerInvalidateCacheOnModelWriteListeners(bus?: EventBus, options?: ModelCacheInvalidationOptions): () => void;
11
- export type { ModelCacheInvalidationOptions };
12
- export { createModelCacheInvalidationListener, registerInvalidateCacheOnModelWriteListeners };
1
+ import type { CacheLike } from "@getstrata/core/cache/tokens";
2
+ import { type ServiceToken } from "@getstrata/core/contracts/token";
3
+ import { type AnyRepositoryDefinition } from "@getstrata/core/database/definitions";
4
+ import type { DurableListener } from "@getstrata/core/events/outbox";
5
+ import type { Queue } from "@getstrata/core/queue";
6
+ import type { AppModule } from "../contracts";
7
+ import type { ListenerDeclarations } from "../discoverListeners";
8
+ /** Immutable effect graph; declared dependencies prepare before database pool effects. */
9
+ export declare function createModelCacheInvalidationEffects<C extends CacheLike>(repositories: readonly AnyRepositoryDefinition[], modules: readonly AppModule[], tokens: {
10
+ readonly cache: ServiceToken<C>;
11
+ readonly queue: ServiceToken<Queue>;
12
+ }): ListenerDeclarations;
13
+ export declare function createModelCacheInvalidationListener(cache: CacheLike): DurableListener;
@@ -1,8 +1,13 @@
1
- import { type TransactionAcquisitionMetrics } from "@getstrata/core/database/transaction";
1
+ import { type TransactionAcquisitionMetrics } from "@getstrata/core/database/acquisitionMetrics";
2
2
  import { type OutboxMetricsCollector } from "@getstrata/core/events/outbox";
3
3
  import { type FailedJobMetricsCollector, type RedisQueueSnapshotOptions } from "@getstrata/core/queue/queueMetrics";
4
4
  import { type TracingRuntime } from "@getstrata/core/tracing/tracingMiddleware";
5
5
  interface MetricsRoutesOptions {
6
+ /** App configuration copied once when routes are assembled. */
7
+ readonly authorization?: Readonly<{
8
+ token?: string;
9
+ production: boolean;
10
+ }>;
6
11
  /** Opt in to shared Redis queue observations; no database or failed-job scan. */
7
12
  queue?: RedisQueueSnapshotOptions & {
8
13
  redisUrl: string;
@@ -1,4 +1,4 @@
1
- import { type Middleware } from "@getstrata/core/http/middleware";
2
- /** Module callbacks must receive middleware even when inert fields share their method map. */
3
- declare function applyModuleRouteMiddleware(routes: Record<string, unknown>, middleware: Middleware[]): Record<string, unknown>;
4
- export { applyModuleRouteMiddleware };
1
+ type ModuleCallback = (...args: never[]) => unknown;
2
+ /** All three internal issuers provide the owned entry adapter; inert/native values stay intact. */
3
+ declare function enterModuleRoutes(routes: Record<string, unknown>, enter: (callback: ModuleCallback) => unknown): Record<string, unknown>;
4
+ export { enterModuleRoutes };
@@ -1 +1 @@
1
- export { configureModulesDirectory, configureModulesManifest, discoverModules, ensureModulesLoaded, } from "./discoverModules";
1
+ export { createModuleDiscovery, ensureModulesLoaded } from "./discoverModules";
@@ -0,0 +1,23 @@
1
+ import type { Middleware } from "@getstrata/core/http/middleware";
2
+ import type { BusinessRequestPorts, BusinessRouteHandler, HttpPersistenceOptions, IdentityPolicyMode } from "./persistenceContracts";
3
+ export declare const HTTP_PERSISTENCE_OPTIONS: import("@getstrata/core/contracts/token").ServiceToken<HttpPersistenceOptions>;
4
+ export interface ComposedRouteHandler<T extends Request = Request> {
5
+ (request: T): Response | Promise<Response>;
6
+ (request: T, ports: BusinessRequestPorts): Response | Promise<Response>;
7
+ <TData>(request: T, server: Bun.Server<TData>): Response | Promise<Response>;
8
+ }
9
+ type Interception = Response | void;
10
+ /** Reject malformed JavaScript handlers before metadata inspection or wrapper effects. */
11
+ export declare function assertHttpHandler(handler: unknown): asserts handler is (...args: never[]) => unknown;
12
+ export declare function scimMiddleware(handler: unknown): readonly Middleware[] | undefined;
13
+ export declare function identityModes(handler: unknown): readonly IdentityPolicyMode[] | undefined;
14
+ declare const routeDispatch: unique symbol;
15
+ export declare function businessPorts(value: BusinessRequestPorts): BusinessRequestPorts;
16
+ export declare function isBusinessPorts(value: unknown): value is BusinessRequestPorts;
17
+ export declare function ownedHttpRoute<T extends Request>(handler: BusinessRouteHandler<T>, enter: (request: T, handler: BusinessRouteHandler<T>) => Promise<Response>, modes?: readonly IdentityPolicyMode[], scim?: readonly Middleware[]): ComposedRouteHandler<T>;
18
+ export declare function dispatchOwnedRoute(handler: unknown, request: Request, before: (ports: BusinessRequestPorts) => Interception | Promise<Interception>): Promise<Response | undefined>;
19
+ /** Pure public/operational response policy; persistence probes enter their own explicit invocations. */
20
+ export declare function ownedPublicHttpRoute<T extends Request>(handler: (request: T) => Response | Promise<Response>, enter: (request: T, work: (request: T) => Response | Promise<Response>) => Promise<Response>): ((request: T) => Promise<Response>) & {
21
+ [routeDispatch]: (request: T, before?: () => Interception | Promise<Interception>) => Promise<Response>;
22
+ };
23
+ export {};
@@ -0,0 +1,70 @@
1
+ import type { AuthUser, CredentialSource } from "@getstrata/core/auth/authContext";
2
+ import type { AuthOutcome } from "@getstrata/core/auth/guard";
3
+ import type { OrganizationMemberRole } from "@getstrata/core/contracts/membership";
4
+ import type { TenantContext } from "@getstrata/core/tenant/tenantContext";
5
+ export type { EstablishedDatabasePolicy, ExecutionPersistence, PersistenceInvocation, ScopedPolicy, SelectedSession, } from "@getstrata/core/contracts/persistence";
6
+ import type { ExecutionPersistence } from "@getstrata/core/contracts/persistence";
7
+ export type AuthResolution = Readonly<{
8
+ user: AuthUser | null;
9
+ credentialSource: CredentialSource;
10
+ }>;
11
+ export interface EstablishedRequest {
12
+ readonly auth: AuthResolution;
13
+ readonly tenant: TenantContext;
14
+ readonly memberships: readonly Readonly<{
15
+ organization_id: number;
16
+ role: OrganizationMemberRole;
17
+ }>[];
18
+ }
19
+ export interface MetadataPorts {
20
+ authenticate(request: Request): Promise<AuthOutcome>;
21
+ memberships(user: AuthUser): Promise<EstablishedRequest["memberships"]>;
22
+ userTenantId(userId: number): Promise<number>;
23
+ tenant(id: number): Promise<TenantContext | null>;
24
+ }
25
+ export type MetadataFactory = (ports: ExecutionPersistence) => MetadataPorts;
26
+ import type { AuthReader } from "@getstrata/core/auth/authReader";
27
+ import type { DatabaseSession, TransactionSession } from "@getstrata/core/database/session";
28
+ import type { PublicTenancyOptions } from "@getstrata/core/tenant/publicTenantHost";
29
+ export interface BusinessRequestPorts {
30
+ readonly database: DatabaseSession | TransactionSession;
31
+ readonly auth: AuthReader;
32
+ readonly policy: import("@getstrata/core/contracts/persistence").ScopedPolicy;
33
+ readonly established: EstablishedRequest;
34
+ }
35
+ export type BusinessRouteHandler<TRequest extends Request = Request> = (request: TRequest, ports: BusinessRequestPorts) => Response | Promise<Response>;
36
+ export interface HttpPersistenceOptions {
37
+ readonly metadata: MetadataFactory;
38
+ readonly features?: Readonly<{
39
+ emailVerificationRequired: boolean;
40
+ viewsEnabled: boolean;
41
+ publicReadsEnabled: boolean;
42
+ etagEnabled?: boolean;
43
+ }>;
44
+ readonly intendedUrl?: import("@getstrata/core/auth/intendedUrlCookie").IntendedUrlCookieOptions;
45
+ readonly flash?: import("@getstrata/core/http/flashSession").FlashSessionOptions;
46
+ /** Expire only a supplied cookie rejected by the session authenticator; never retries as guest. */
47
+ readonly invalidSessionCookie?: Readonly<{
48
+ name: string;
49
+ expiredHeader: string;
50
+ }>;
51
+ readonly responsePolicy?: Readonly<{
52
+ securityHeaders?: import("@getstrata/core/http/contentSecurityPolicy").ContentSecurityPolicyOptions;
53
+ cors?: import("@getstrata/core/http/corsMiddleware").CorsOptions;
54
+ maxBodyBytes?: number;
55
+ rateLimitPerMinute?: number;
56
+ namespace?: string;
57
+ trustForwardedFor?: boolean;
58
+ loginRateLimit?: import("./rateLimit").LoginRateLimitConfig;
59
+ registerRateLimit?: import("./rateLimit").LoginRateLimitConfig;
60
+ }>;
61
+ readonly csrf?: import("@getstrata/core/http/csrfMiddleware").CsrfOptions;
62
+ readonly scim?: (request: Request, database: DatabaseSession) => Promise<TenantContext | Response>;
63
+ readonly tenancy: "none" | "column" | "rls";
64
+ readonly production: boolean;
65
+ readonly allowTenantDevHeaders: boolean;
66
+ readonly publicTenancy?: PublicTenancyOptions;
67
+ readonly signatureSecret?: string;
68
+ readonly passwordConfirmation?: import("@getstrata/core/auth/passwordConfirmCookie").PasswordConfirmReadOptions;
69
+ }
70
+ export type IdentityPolicyMode = "identifier" | "bypass";
@@ -0,0 +1,4 @@
1
+ import type { Application } from "@getstrata/core/contracts/application";
2
+ import type { PersistenceInvocation } from "./persistenceContracts";
3
+ /** Composition captures an owner, never a startup execution session. */
4
+ export declare function createPersistenceInvocation(application: Application, connection: string): PersistenceInvocation;