@getstrata/bootstrap 2.2.51 → 2.2.52

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 CHANGED
@@ -1,5 +1,11 @@
1
1
  # @getstrata/bootstrap changelog
2
2
 
3
+ ## 2.2.52
4
+
5
+ - Share response policy and observation middleware for explicitly public application documents without adding auth/tenant requirements.
6
+ - Allow an explicit view capability for browser SSO continuation in API/SPA applications; default view-provider behavior remains unchanged.
7
+ - Require aligned core 2.2.52. Native Bun asset admission/delivery and mixed HTTP/WebSocket reporting limitations remain unchanged.
8
+
3
9
  ## 2.2.51
4
10
 
5
11
  - Resolve encoded static paths consistently across guarded server fallback, web routes and SPA assets, including HEAD and request-hook checks.
@@ -13,6 +13,9 @@ declare class HttpKernel {
13
13
  /** Own custom disposable throttle middleware until this application closes. */
14
14
  ownThrottle<T extends Middleware>(throttle: T): T;
15
15
  globalMiddleware(errorFormat?: "json" | "web"): Middleware[];
16
+ private responseMiddleware;
17
+ /** Public application documents still own response policy and observation. */
18
+ wrapPublicDocument<TRequest extends Request = Request>(handler: RouteHandler<TRequest>): RouteHandler<TRequest>;
16
19
  group(name: MiddlewareGroupName): Middleware[];
17
20
  wrap<TRequest extends Request = Request>(groups: MiddlewareGroupName | MiddlewareGroupName[], handler: RouteHandler<TRequest>): RouteHandler<TRequest>;
18
21
  wrapApi<TRequest extends Request = Request>(handler: RouteHandler<TRequest>): RouteHandler<TRequest>;
@@ -3,6 +3,8 @@ import type { ServiceProvider } from "../contracts";
3
3
  declare const CORE_VIEW_TOKEN = "core.view";
4
4
  declare const VIEW_DIRECTORY_CONFIG_KEY = "view.directory";
5
5
  interface ViewProviderOptions {
6
+ /** Explicit document capability, for example a browser SSO continuation in an API app. */
7
+ enabled?: boolean;
6
8
  directory?: string;
7
9
  layout?: string | false;
8
10
  data?: WebLayoutDataOptions;
@@ -162,6 +162,17 @@ class HttpKernel {
162
162
  }
163
163
  globalMiddleware(errorFormat = "json") {
164
164
  const auth = this.dependencies.container.resolve(CORE_AUTH_TOKEN);
165
+ return [
166
+ ...this.responseMiddleware(errorFormat),
167
+ createAuthMiddleware(auth),
168
+ createMembershipMiddleware(),
169
+ createTenantMiddleware({
170
+ publicTenancy: this.dependencies.container.has(CORE_PUBLIC_TENANCY_TOKEN) ? this.dependencies.container.resolve(CORE_PUBLIC_TENANCY_TOKEN) : undefined,
171
+ resolveTenant: this.dependencies.container.has(CORE_TENANT_RESOLVER_TOKEN) ? this.dependencies.container.resolve(CORE_TENANT_RESOLVER_TOKEN) : undefined
172
+ })
173
+ ];
174
+ }
175
+ responseMiddleware(errorFormat) {
165
176
  return [
166
177
  createCorsMiddleware(),
167
178
  createSecurityHeadersMiddleware(),
@@ -170,15 +181,12 @@ class HttpKernel {
170
181
  createMetricsMiddleware(),
171
182
  createRequestLoggingMiddleware(),
172
183
  requestIdMiddleware,
173
- errorFormat === "json" ? createJsonErrorMiddleware() : createWebErrorMiddleware(),
174
- createAuthMiddleware(auth),
175
- createMembershipMiddleware(),
176
- createTenantMiddleware({
177
- publicTenancy: this.dependencies.container.has(CORE_PUBLIC_TENANCY_TOKEN) ? this.dependencies.container.resolve(CORE_PUBLIC_TENANCY_TOKEN) : undefined,
178
- resolveTenant: this.dependencies.container.has(CORE_TENANT_RESOLVER_TOKEN) ? this.dependencies.container.resolve(CORE_TENANT_RESOLVER_TOKEN) : undefined
179
- })
184
+ errorFormat === "json" ? createJsonErrorMiddleware() : createWebErrorMiddleware()
180
185
  ];
181
186
  }
187
+ wrapPublicDocument(handler) {
188
+ return withMiddleware(...this.responseMiddleware("web"))(handler);
189
+ }
182
190
  group(name) {
183
191
  const auth = this.dependencies.container.resolve(CORE_AUTH_TOKEN);
184
192
  switch (name) {
@@ -162,6 +162,17 @@ class HttpKernel {
162
162
  }
163
163
  globalMiddleware(errorFormat = "json") {
164
164
  const auth = this.dependencies.container.resolve(CORE_AUTH_TOKEN);
165
+ return [
166
+ ...this.responseMiddleware(errorFormat),
167
+ createAuthMiddleware(auth),
168
+ createMembershipMiddleware(),
169
+ createTenantMiddleware({
170
+ publicTenancy: this.dependencies.container.has(CORE_PUBLIC_TENANCY_TOKEN) ? this.dependencies.container.resolve(CORE_PUBLIC_TENANCY_TOKEN) : undefined,
171
+ resolveTenant: this.dependencies.container.has(CORE_TENANT_RESOLVER_TOKEN) ? this.dependencies.container.resolve(CORE_TENANT_RESOLVER_TOKEN) : undefined
172
+ })
173
+ ];
174
+ }
175
+ responseMiddleware(errorFormat) {
165
176
  return [
166
177
  createCorsMiddleware(),
167
178
  createSecurityHeadersMiddleware(),
@@ -170,15 +181,12 @@ class HttpKernel {
170
181
  createMetricsMiddleware(),
171
182
  createRequestLoggingMiddleware(),
172
183
  requestIdMiddleware,
173
- errorFormat === "json" ? createJsonErrorMiddleware() : createWebErrorMiddleware(),
174
- createAuthMiddleware(auth),
175
- createMembershipMiddleware(),
176
- createTenantMiddleware({
177
- publicTenancy: this.dependencies.container.has(CORE_PUBLIC_TENANCY_TOKEN) ? this.dependencies.container.resolve(CORE_PUBLIC_TENANCY_TOKEN) : undefined,
178
- resolveTenant: this.dependencies.container.has(CORE_TENANT_RESOLVER_TOKEN) ? this.dependencies.container.resolve(CORE_TENANT_RESOLVER_TOKEN) : undefined
179
- })
184
+ errorFormat === "json" ? createJsonErrorMiddleware() : createWebErrorMiddleware()
180
185
  ];
181
186
  }
187
+ wrapPublicDocument(handler) {
188
+ return withMiddleware(...this.responseMiddleware("web"))(handler);
189
+ }
182
190
  group(name) {
183
191
  const auth = this.dependencies.container.resolve(CORE_AUTH_TOKEN);
184
192
  switch (name) {
@@ -854,7 +854,7 @@ function createViewProvider(options = {}) {
854
854
  return {
855
855
  name: "view",
856
856
  register({ container, config }) {
857
- if (!isViewsEnabled())
857
+ if (!(options.enabled ?? isViewsEnabled()))
858
858
  return;
859
859
  const viewsDirectory = directory ?? (process.env.VIEW_DIRECTORY?.trim() || DEFAULT_VIEWS_DIRECTORY);
860
860
  config.set(VIEW_DIRECTORY_CONFIG_KEY, viewsDirectory);
@@ -168,6 +168,17 @@ class HttpKernel {
168
168
  }
169
169
  globalMiddleware(errorFormat = "json") {
170
170
  const auth = this.dependencies.container.resolve(CORE_AUTH_TOKEN);
171
+ return [
172
+ ...this.responseMiddleware(errorFormat),
173
+ createAuthMiddleware(auth),
174
+ createMembershipMiddleware(),
175
+ createTenantMiddleware({
176
+ publicTenancy: this.dependencies.container.has(CORE_PUBLIC_TENANCY_TOKEN) ? this.dependencies.container.resolve(CORE_PUBLIC_TENANCY_TOKEN) : undefined,
177
+ resolveTenant: this.dependencies.container.has(CORE_TENANT_RESOLVER_TOKEN) ? this.dependencies.container.resolve(CORE_TENANT_RESOLVER_TOKEN) : undefined
178
+ })
179
+ ];
180
+ }
181
+ responseMiddleware(errorFormat) {
171
182
  return [
172
183
  createCorsMiddleware(),
173
184
  createSecurityHeadersMiddleware(),
@@ -176,15 +187,12 @@ class HttpKernel {
176
187
  createMetricsMiddleware(),
177
188
  createRequestLoggingMiddleware(),
178
189
  requestIdMiddleware,
179
- errorFormat === "json" ? createJsonErrorMiddleware() : createWebErrorMiddleware(),
180
- createAuthMiddleware(auth),
181
- createMembershipMiddleware(),
182
- createTenantMiddleware({
183
- publicTenancy: this.dependencies.container.has(CORE_PUBLIC_TENANCY_TOKEN) ? this.dependencies.container.resolve(CORE_PUBLIC_TENANCY_TOKEN) : undefined,
184
- resolveTenant: this.dependencies.container.has(CORE_TENANT_RESOLVER_TOKEN) ? this.dependencies.container.resolve(CORE_TENANT_RESOLVER_TOKEN) : undefined
185
- })
190
+ errorFormat === "json" ? createJsonErrorMiddleware() : createWebErrorMiddleware()
186
191
  ];
187
192
  }
193
+ wrapPublicDocument(handler) {
194
+ return withMiddleware(...this.responseMiddleware("web"))(handler);
195
+ }
188
196
  group(name) {
189
197
  const auth = this.dependencies.container.resolve(CORE_AUTH_TOKEN);
190
198
  switch (name) {
@@ -854,7 +854,7 @@ function createViewProvider(options = {}) {
854
854
  return {
855
855
  name: "view",
856
856
  register({ container, config }) {
857
- if (!isViewsEnabled())
857
+ if (!(options.enabled ?? isViewsEnabled()))
858
858
  return;
859
859
  const viewsDirectory = directory ?? (process.env.VIEW_DIRECTORY?.trim() || DEFAULT_VIEWS_DIRECTORY);
860
860
  config.set(VIEW_DIRECTORY_CONFIG_KEY, viewsDirectory);
@@ -153,6 +153,17 @@ class HttpKernel {
153
153
  }
154
154
  globalMiddleware(errorFormat = "json") {
155
155
  const auth = this.dependencies.container.resolve(CORE_AUTH_TOKEN);
156
+ return [
157
+ ...this.responseMiddleware(errorFormat),
158
+ createAuthMiddleware(auth),
159
+ createMembershipMiddleware(),
160
+ createTenantMiddleware({
161
+ publicTenancy: this.dependencies.container.has(CORE_PUBLIC_TENANCY_TOKEN) ? this.dependencies.container.resolve(CORE_PUBLIC_TENANCY_TOKEN) : undefined,
162
+ resolveTenant: this.dependencies.container.has(CORE_TENANT_RESOLVER_TOKEN) ? this.dependencies.container.resolve(CORE_TENANT_RESOLVER_TOKEN) : undefined
163
+ })
164
+ ];
165
+ }
166
+ responseMiddleware(errorFormat) {
156
167
  return [
157
168
  createCorsMiddleware(),
158
169
  createSecurityHeadersMiddleware(),
@@ -161,15 +172,12 @@ class HttpKernel {
161
172
  createMetricsMiddleware(),
162
173
  createRequestLoggingMiddleware(),
163
174
  requestIdMiddleware,
164
- errorFormat === "json" ? createJsonErrorMiddleware() : createWebErrorMiddleware(),
165
- createAuthMiddleware(auth),
166
- createMembershipMiddleware(),
167
- createTenantMiddleware({
168
- publicTenancy: this.dependencies.container.has(CORE_PUBLIC_TENANCY_TOKEN) ? this.dependencies.container.resolve(CORE_PUBLIC_TENANCY_TOKEN) : undefined,
169
- resolveTenant: this.dependencies.container.has(CORE_TENANT_RESOLVER_TOKEN) ? this.dependencies.container.resolve(CORE_TENANT_RESOLVER_TOKEN) : undefined
170
- })
175
+ errorFormat === "json" ? createJsonErrorMiddleware() : createWebErrorMiddleware()
171
176
  ];
172
177
  }
178
+ wrapPublicDocument(handler) {
179
+ return withMiddleware(...this.responseMiddleware("web"))(handler);
180
+ }
173
181
  group(name) {
174
182
  const auth = this.dependencies.container.resolve(CORE_AUTH_TOKEN);
175
183
  switch (name) {
@@ -23,7 +23,7 @@ function createViewProvider(options = {}) {
23
23
  return {
24
24
  name: "view",
25
25
  register({ container, config }) {
26
- if (!isViewsEnabled())
26
+ if (!(options.enabled ?? isViewsEnabled()))
27
27
  return;
28
28
  const viewsDirectory = directory ?? (process.env.VIEW_DIRECTORY?.trim() || DEFAULT_VIEWS_DIRECTORY);
29
29
  config.set(VIEW_DIRECTORY_CONFIG_KEY, viewsDirectory);
@@ -839,7 +839,7 @@ function createViewProvider(options = {}) {
839
839
  return {
840
840
  name: "view",
841
841
  register({ container, config }) {
842
- if (!isViewsEnabled())
842
+ if (!(options.enabled ?? isViewsEnabled()))
843
843
  return;
844
844
  const viewsDirectory = directory ?? (process.env.VIEW_DIRECTORY?.trim() || DEFAULT_VIEWS_DIRECTORY);
845
845
  config.set(VIEW_DIRECTORY_CONFIG_KEY, viewsDirectory);
@@ -163,6 +163,17 @@ class HttpKernel {
163
163
  }
164
164
  globalMiddleware(errorFormat = "json") {
165
165
  const auth = this.dependencies.container.resolve(CORE_AUTH_TOKEN);
166
+ return [
167
+ ...this.responseMiddleware(errorFormat),
168
+ createAuthMiddleware(auth),
169
+ createMembershipMiddleware(),
170
+ createTenantMiddleware({
171
+ publicTenancy: this.dependencies.container.has(CORE_PUBLIC_TENANCY_TOKEN) ? this.dependencies.container.resolve(CORE_PUBLIC_TENANCY_TOKEN) : undefined,
172
+ resolveTenant: this.dependencies.container.has(CORE_TENANT_RESOLVER_TOKEN) ? this.dependencies.container.resolve(CORE_TENANT_RESOLVER_TOKEN) : undefined
173
+ })
174
+ ];
175
+ }
176
+ responseMiddleware(errorFormat) {
166
177
  return [
167
178
  createCorsMiddleware(),
168
179
  createSecurityHeadersMiddleware(),
@@ -171,15 +182,12 @@ class HttpKernel {
171
182
  createMetricsMiddleware(),
172
183
  createRequestLoggingMiddleware(),
173
184
  requestIdMiddleware,
174
- errorFormat === "json" ? createJsonErrorMiddleware() : createWebErrorMiddleware(),
175
- createAuthMiddleware(auth),
176
- createMembershipMiddleware(),
177
- createTenantMiddleware({
178
- publicTenancy: this.dependencies.container.has(CORE_PUBLIC_TENANCY_TOKEN) ? this.dependencies.container.resolve(CORE_PUBLIC_TENANCY_TOKEN) : undefined,
179
- resolveTenant: this.dependencies.container.has(CORE_TENANT_RESOLVER_TOKEN) ? this.dependencies.container.resolve(CORE_TENANT_RESOLVER_TOKEN) : undefined
180
- })
185
+ errorFormat === "json" ? createJsonErrorMiddleware() : createWebErrorMiddleware()
181
186
  ];
182
187
  }
188
+ wrapPublicDocument(handler) {
189
+ return withMiddleware(...this.responseMiddleware("web"))(handler);
190
+ }
183
191
  group(name) {
184
192
  const auth = this.dependencies.container.resolve(CORE_AUTH_TOKEN);
185
193
  switch (name) {
package/dist/index.js CHANGED
@@ -182,6 +182,17 @@ class HttpKernel {
182
182
  }
183
183
  globalMiddleware(errorFormat = "json") {
184
184
  const auth = this.dependencies.container.resolve(CORE_AUTH_TOKEN);
185
+ return [
186
+ ...this.responseMiddleware(errorFormat),
187
+ createAuthMiddleware(auth),
188
+ createMembershipMiddleware(),
189
+ createTenantMiddleware({
190
+ publicTenancy: this.dependencies.container.has(CORE_PUBLIC_TENANCY_TOKEN) ? this.dependencies.container.resolve(CORE_PUBLIC_TENANCY_TOKEN) : undefined,
191
+ resolveTenant: this.dependencies.container.has(CORE_TENANT_RESOLVER_TOKEN) ? this.dependencies.container.resolve(CORE_TENANT_RESOLVER_TOKEN) : undefined
192
+ })
193
+ ];
194
+ }
195
+ responseMiddleware(errorFormat) {
185
196
  return [
186
197
  createCorsMiddleware(),
187
198
  createSecurityHeadersMiddleware(),
@@ -190,15 +201,12 @@ class HttpKernel {
190
201
  createMetricsMiddleware(),
191
202
  createRequestLoggingMiddleware(),
192
203
  requestIdMiddleware,
193
- errorFormat === "json" ? createJsonErrorMiddleware() : createWebErrorMiddleware(),
194
- createAuthMiddleware(auth),
195
- createMembershipMiddleware(),
196
- createTenantMiddleware({
197
- publicTenancy: this.dependencies.container.has(CORE_PUBLIC_TENANCY_TOKEN) ? this.dependencies.container.resolve(CORE_PUBLIC_TENANCY_TOKEN) : undefined,
198
- resolveTenant: this.dependencies.container.has(CORE_TENANT_RESOLVER_TOKEN) ? this.dependencies.container.resolve(CORE_TENANT_RESOLVER_TOKEN) : undefined
199
- })
204
+ errorFormat === "json" ? createJsonErrorMiddleware() : createWebErrorMiddleware()
200
205
  ];
201
206
  }
207
+ wrapPublicDocument(handler) {
208
+ return withMiddleware(...this.responseMiddleware("web"))(handler);
209
+ }
202
210
  group(name) {
203
211
  const auth = this.dependencies.container.resolve(CORE_AUTH_TOKEN);
204
212
  switch (name) {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@getstrata/bootstrap",
3
- "version": "2.2.51",
3
+ "version": "2.2.52",
4
4
  "description": "Strata application bootstrap: HttpKernel, DI, web session helpers",
5
5
  "type": "module",
6
6
  "license": "MIT",
@@ -190,7 +190,7 @@
190
190
  "access": "public"
191
191
  },
192
192
  "peerDependencies": {
193
- "@getstrata/core": "^2.2.51",
193
+ "@getstrata/core": "^2.2.52",
194
194
  "typescript": "^5.9.0 || ^6.0.0 || ^7.0.0"
195
195
  },
196
196
  "engines": {