@web-ts-toolkit/access-router 0.65.1 → 0.66.0

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/index.d.mts CHANGED
@@ -1,9 +1,10 @@
1
1
  import mongoose__default, { Schema } from 'mongoose';
2
2
  import { Response, NextFunction, RequestHandler, Router } from 'express';
3
- import { A as AccessRouterBaseRequest, aq as GuardHook, aT as ModelRequest, dR as AccessRuntime, _ as DataRouterOptions, Y as DataRequest, dS as DataService, aa as ExtendedDataRouterOptions, af as Filter, bo as Projection, cv as Sort, bk as Populate, aU as ModelRouterOptions, dT as Service, dU as PublicService, b3 as ModelVirtualRecordAccess, aZ as ModelVirtualDescriptor, a$ as ModelVirtualGetter, b0 as ModelVirtualLeaf, ac as ExtendedModelRouterOptions, ds as Validation, cf as RootRouterOptions, dV as OpenApiRouterOptions, dW as OpenApiRegistryOptions, dX as OpenApiRouteDescriptor, dY as OpenApiDocumentOptions, dZ as OpenApiParameter, d_ as OpenApiSchema, d$ as OpenApiResponses, ao as GlobalOptions, a2 as DefaultModelRouterOptions, ab as ExtendedDefaultModelRouterOptions } from './parsers-h_oU4bB0.mjs';
4
- export { e0 as AccessRouterPermissionMap, e1 as AccessRouterPermissions, c as AccessRouterRequest, d as AccessRouterRequestExtensions, l as AjvErrorObjectLike, n as AjvValidatorLike, o as AllowedOutputFieldOptions, p as ArkTypeErrorsLike, q as ArkTypeLike, s as AuthorizedListResult, t as AuthorizedSingleResult, H as CreateAuthorization, N as DataFieldOptions, a7 as DocumentAuthorization, ad as FieldAuthorization, ae as FieldOperationAccess, ap as GlobalPermissionValue, ar as HydrationMode, au as InputFieldAuthorization, av as InputFieldPath, aw as IoTsContextEntryLike, ax as IoTsDecodeErrorLike, ay as IoTsDecoderLike, az as JoiSchemaLike, aA as JoiValidationErrorDetailLike, aG as MaybePromise, aH as ModelBaseFilterHook, aJ as ModelDeleteHook, aK as ModelDocPermissionsHook, aM as ModelDocumentHook, aN as ModelHook, aP as ModelHydrationOptions, aQ as ModelIdentifierHook, aR as ModelListHook, aS as ModelOverrideFilterHook, aV as ModelValidateHook, aW as ModelVirtualAccess, aX as ModelVirtualAccessRecord, aY as ModelVirtualContext, a_ as ModelVirtualDoc, b1 as ModelVirtualPopulateDependency, b2 as ModelVirtualPopulateInputs, b4 as ModelVirtuals, b5 as MutationAuthorization, b6 as NewArgs, b7 as NewOptions, e2 as OpenApiMethod, b8 as OperationAccess, b9 as OperationAuthorization, ba as OutputAuthorization, bb as OutputFieldOptions, bc as OutputFieldPath, bd as OutputPlanningOptions, bg as PairedRouteAccess, bj as PermissionSchema, e3 as Permissions, bm as PopulatePlanningOptions, bA as PublicSubdocumentCreateOptions, bB as PublicSubdocumentListOptions, bC as PublicSubdocumentMutationOptions, bD as PublicSubdocumentReadOptions, bJ as RelatedAuthorization, bL as RequestSchemaAdapter, bM as RequestSchemaFailure, bN as RequestSchemaIssue, bO as RequestSchemaLike, bP as RequestSchemaOptions, bQ as RequestSchemaResult, bR as RequestSchemaSuccess, bS as RequestSchemaValidator, ci as RouteBaseAccess, cj as RouteGuardAccess, ck as RouteVariant, cl as RouteVariantAccess, cm as RowAuthorization, cq as ServiceAuthorization, cr as ServiceOutputContext, cs as ServiceOutputDecorator, cx as StandardSchemaFailure, cy as StandardSchemaInferOutput, cz as StandardSchemaIssue, cA as StandardSchemaPathSegment, cB as StandardSchemaResult, cC as StandardSchemaSuccess, cD as StandardSchemaV1, cG as SubOperationAccess, cK as SubRouteGuardOptions, cN as SubdocumentCreateAuthorization, cP as SubdocumentCreateOptions, cQ as SubdocumentCreateVisibilityAuthorization, cR as SubdocumentDeleteAuthorization, cS as SubdocumentDeleteOptions, cT as SubdocumentGateAuthorization, cV as SubdocumentInputAuthorization, cW as SubdocumentListOptions, cX as SubdocumentModel, cY as SubdocumentMutationAuthorization, cZ as SubdocumentName, c_ as SubdocumentOutputAuthorization, d1 as SubdocumentReadAuthorization, d2 as SubdocumentReadOptions, d4 as SubdocumentUpdateOptions, d5 as SubdocumentVirtuals, d6 as SubdocumentVisibilityAuthorization, d7 as SuperstructFailureLike, d8 as SuperstructValidateLike, dl as ValibotIssueLike, dm as ValibotPathItemLike, dn as ValibotSafeParseLike, dp as ValibotSafeParseResult, du as VineValidationErrorLike, dv as VineValidationMessageLike, dw as VineValidatorLike, dx as VirtualSubModel, dy as WithVirtuals, dz as YupSchemaLike, dA as YupValidationErrorLike, e4 as defaultRuntime, dB as defineRequestSchema, dC as fromAjv, dD as fromArkType, dE as fromIoTs, dF as fromJoi, dG as fromStandardSchema, dH as fromSuperstruct, dI as fromValibot, dJ as fromVine, dK as fromYup, dL as fromZod } from './parsers-h_oU4bB0.mjs';
3
+ import { A as AccessRouterBaseRequest, au as GuardHook, a_ as ModelRequest, dY as AccessRuntime, $ as DataRouterOptions, Z as DataRequest, dZ as DataService, ab as ExtendedDataRouterOptions, ai as Filter, bv as Projection, cC as Sort, br as Populate, a$ as ModelRouterOptions, d_ as Service, d$ as PublicService, ba as ModelVirtualRecordAccess, b4 as ModelVirtualDescriptor, b6 as ModelVirtualGetter, b7 as ModelVirtualLeaf, ad as ExtendedModelRouterOptions, dz as Validation, cm as RootRouterOptions, e0 as OpenApiRouterOptions, e1 as OpenApiRegistryOptions, e2 as OpenApiRouteDescriptor, e3 as OpenApiDocumentOptions, e4 as OpenApiParameter, e5 as OpenApiSchema, e6 as OpenApiResponses, as as GlobalOptions, a3 as DefaultModelRouterOptions, ac as ExtendedDefaultModelRouterOptions } from './parsers-BiFHfrNd.mjs';
4
+ export { e7 as AccessRouterPermissionMap, e8 as AccessRouterPermissions, c as AccessRouterRequest, d as AccessRouterRequestExtensions, l as AjvErrorObjectLike, n as AjvValidatorLike, o as AllowedOutputFieldOptions, p as ArkTypeErrorsLike, q as ArkTypeLike, s as AuthorizationMode, t as AuthorizedListResult, u as AuthorizedSingleResult, I as CreateAuthorization, O as DataFieldOptions, a8 as DocumentGrants, ae as FieldAuthorization, af as FieldOperationAccess, ag as FieldPermissionHook, ah as FieldValidation, ak as FilteredOutput, at as GlobalPermissionValue, av as HydrationMode, ay as InputFieldAuthorization, az as InputFieldPath, aA as IoTsContextEntryLike, aB as IoTsDecodeErrorLike, aC as IoTsDecoderLike, aD as JoiSchemaLike, aE as JoiValidationErrorDetailLike, aK as MaybePromise, aL as ModelBaseFilterHook, aN as ModelDeleteHook, aO as ModelDocPermissionsHook, aQ as ModelDocumentHook, aR as ModelHook, aT as ModelHydrationOptions, aU as ModelIdentifierHook, aV as ModelListHook, aW as ModelOutputContext, aX as ModelOutputHook, aY as ModelOutputListHook, aZ as ModelOverrideFilterHook, b0 as ModelValidateHook, b1 as ModelVirtualAccess, b2 as ModelVirtualAccessRecord, b3 as ModelVirtualContext, b5 as ModelVirtualDoc, b8 as ModelVirtualPopulateDependency, b9 as ModelVirtualPopulateInputs, bb as ModelVirtuals, bc as MutationAuthorization, bd as NewArgs, be as NewOptions, e9 as OpenApiMethod, bf as OperationAccess, bg as OperationAuthorization, bh as OutputAuthorization, bi as OutputFieldOptions, bj as OutputFieldPath, bk as OutputPlanningOptions, bn as PairedRouteAccess, bq as PermissionSchema, ea as Permissions, bt as PopulatePlanningOptions, bH as PublicSubdocumentCreateOptions, bI as PublicSubdocumentListOptions, bJ as PublicSubdocumentMutationOptions, bK as PublicSubdocumentReadOptions, bQ as RelatedAuthorization, bS as RequestSchemaAdapter, bT as RequestSchemaFailure, bU as RequestSchemaIssue, bV as RequestSchemaLike, bW as RequestSchemaOptions, bX as RequestSchemaResult, bY as RequestSchemaSuccess, bZ as RequestSchemaValidator, cp as RouteBaseAccess, cq as RouteGuardAccess, cr as RouteVariant, cs as RouteVariantAccess, ct as RowAuthorization, cx as ServiceAuthorization, cy as ServiceOutputContext, cz as ServiceOutputDecorator, cE as StandardSchemaFailure, cF as StandardSchemaInferOutput, cG as StandardSchemaIssue, cH as StandardSchemaPathSegment, cI as StandardSchemaResult, cJ as StandardSchemaSuccess, cK as StandardSchemaV1, cN as SubOperationAccess, cR as SubRouteGuardOptions, cU as SubdocumentCreateAuthorization, cW as SubdocumentCreateOptions, cX as SubdocumentCreateVisibilityAuthorization, cY as SubdocumentDeleteAuthorization, cZ as SubdocumentDeleteOptions, c_ as SubdocumentGateAuthorization, d0 as SubdocumentInputAuthorization, d1 as SubdocumentListOptions, d2 as SubdocumentModel, d3 as SubdocumentMutationAuthorization, d4 as SubdocumentName, d5 as SubdocumentOutputAuthorization, d8 as SubdocumentReadAuthorization, d9 as SubdocumentReadOptions, db as SubdocumentUpdateOptions, dc as SubdocumentVirtuals, dd as SubdocumentVisibilityAuthorization, de as SuperstructFailureLike, df as SuperstructValidateLike, dt as ValibotIssueLike, du as ValibotPathItemLike, dv as ValibotSafeParseLike, dw as ValibotSafeParseResult, dB as VineValidationErrorLike, dC as VineValidationMessageLike, dD as VineValidatorLike, dE as VirtualSubModel, dF as WithVirtuals, dG as YupSchemaLike, dH as YupValidationErrorLike, eb as defaultRuntime, dI as defineRequestSchema, dJ as fromAjv, dK as fromArkType, dL as fromIoTs, dM as fromJoi, dN as fromStandardSchema, dO as fromSuperstruct, dP as fromValibot, dQ as fromVine, dR as fromYup, dS as fromZod } from './parsers-BiFHfrNd.mjs';
5
5
  import JsonRouter from '@web-ts-toolkit/express-json-router';
6
6
  import 'zod';
7
+ import 'node:buffer';
7
8
 
8
9
  declare function macl(): (req: AccessRouterBaseRequest, res: Response, next: NextFunction) => Promise<void>;
9
10
  interface GuardModelConditionID {
@@ -15,6 +16,14 @@ interface GuardModelCondition {
15
16
  id: string | GuardModelConditionID;
16
17
  condition: string | string[];
17
18
  }
19
+ /**
20
+ * Request permission middleware. Model conditions require a visible row and fresh
21
+ * document facts, but publish no DTO: field/virtual/include output, decorate/tasks
22
+ * and `_read` overrides do not run or veto the condition. Source/fact errors remain
23
+ * BadRequest. This request-only read does not imply the generated HTTP READ gate;
24
+ * an admitted miss may retry once under captured LIST admission and READ mode.
25
+ * Put security in operation/row/fact hooks; use a separate normal read for a DTO.
26
+ */
18
27
  declare function guard(condition: string): RequestHandler;
19
28
  declare function guard(conditions: string[]): RequestHandler;
20
29
  declare function guard(conditionFunc: GuardHook<ModelRequest>): RequestHandler;
@@ -128,8 +137,8 @@ declare class ModelRouter<TModel = unknown, TVirtuals extends object = Record<ne
128
137
  /**
129
138
  * Acquire the model-generic internal service after this runtime's middleware
130
139
  * initializes req.macl. Supply trusted per-call authorization in service options;
131
- * selection/query args stay separate. Successful results carry opaque document
132
- * handles in context(s), never data. Use getPublicService for request-only wrappers.
140
+ * selection/query args stay separate. Successful results carry immutable diagnostic
141
+ * context(s), never reusable authority on data. Use getPublicService for request-only wrappers.
133
142
  */
134
143
  getService(req: ModelRequest): Service<TModel, TVirtuals>;
135
144
  getPublicService(req: ModelRequest): PublicService<TModel, TVirtuals>;
@@ -450,7 +459,7 @@ declare const getModelInstance: <TModel = unknown>(modelName: string) => mongoos
450
459
  * Update inherited model defaults shallowly. Unspecified model options follow these
451
460
  * updates for new calls, including existing models; explicit model values (even false
452
461
  * or empty objects/arrays) win. Model undefined restores inheritance. Existing calls,
453
- * handles, router.options snapshots and mounted route paths are not rewritten.
462
+ * router.options snapshots and mounted route paths are not rewritten.
454
463
  * Explicitly cleared operationAccess keeps its existing exact-key-only default fallback.
455
464
  */
456
465
  declare const setDefaultModelOptions: (options: DefaultModelRouterOptions) => void;
package/index.d.ts CHANGED
@@ -1,9 +1,10 @@
1
1
  import mongoose__default, { Schema } from 'mongoose';
2
2
  import { Response, NextFunction, RequestHandler, Router } from 'express';
3
- import { A as AccessRouterBaseRequest, aq as GuardHook, aT as ModelRequest, dR as AccessRuntime, _ as DataRouterOptions, Y as DataRequest, dS as DataService, aa as ExtendedDataRouterOptions, af as Filter, bo as Projection, cv as Sort, bk as Populate, aU as ModelRouterOptions, dT as Service, dU as PublicService, b3 as ModelVirtualRecordAccess, aZ as ModelVirtualDescriptor, a$ as ModelVirtualGetter, b0 as ModelVirtualLeaf, ac as ExtendedModelRouterOptions, ds as Validation, cf as RootRouterOptions, dV as OpenApiRouterOptions, dW as OpenApiRegistryOptions, dX as OpenApiRouteDescriptor, dY as OpenApiDocumentOptions, dZ as OpenApiParameter, d_ as OpenApiSchema, d$ as OpenApiResponses, ao as GlobalOptions, a2 as DefaultModelRouterOptions, ab as ExtendedDefaultModelRouterOptions } from './parsers-h_oU4bB0.js';
4
- export { e0 as AccessRouterPermissionMap, e1 as AccessRouterPermissions, c as AccessRouterRequest, d as AccessRouterRequestExtensions, l as AjvErrorObjectLike, n as AjvValidatorLike, o as AllowedOutputFieldOptions, p as ArkTypeErrorsLike, q as ArkTypeLike, s as AuthorizedListResult, t as AuthorizedSingleResult, H as CreateAuthorization, N as DataFieldOptions, a7 as DocumentAuthorization, ad as FieldAuthorization, ae as FieldOperationAccess, ap as GlobalPermissionValue, ar as HydrationMode, au as InputFieldAuthorization, av as InputFieldPath, aw as IoTsContextEntryLike, ax as IoTsDecodeErrorLike, ay as IoTsDecoderLike, az as JoiSchemaLike, aA as JoiValidationErrorDetailLike, aG as MaybePromise, aH as ModelBaseFilterHook, aJ as ModelDeleteHook, aK as ModelDocPermissionsHook, aM as ModelDocumentHook, aN as ModelHook, aP as ModelHydrationOptions, aQ as ModelIdentifierHook, aR as ModelListHook, aS as ModelOverrideFilterHook, aV as ModelValidateHook, aW as ModelVirtualAccess, aX as ModelVirtualAccessRecord, aY as ModelVirtualContext, a_ as ModelVirtualDoc, b1 as ModelVirtualPopulateDependency, b2 as ModelVirtualPopulateInputs, b4 as ModelVirtuals, b5 as MutationAuthorization, b6 as NewArgs, b7 as NewOptions, e2 as OpenApiMethod, b8 as OperationAccess, b9 as OperationAuthorization, ba as OutputAuthorization, bb as OutputFieldOptions, bc as OutputFieldPath, bd as OutputPlanningOptions, bg as PairedRouteAccess, bj as PermissionSchema, e3 as Permissions, bm as PopulatePlanningOptions, bA as PublicSubdocumentCreateOptions, bB as PublicSubdocumentListOptions, bC as PublicSubdocumentMutationOptions, bD as PublicSubdocumentReadOptions, bJ as RelatedAuthorization, bL as RequestSchemaAdapter, bM as RequestSchemaFailure, bN as RequestSchemaIssue, bO as RequestSchemaLike, bP as RequestSchemaOptions, bQ as RequestSchemaResult, bR as RequestSchemaSuccess, bS as RequestSchemaValidator, ci as RouteBaseAccess, cj as RouteGuardAccess, ck as RouteVariant, cl as RouteVariantAccess, cm as RowAuthorization, cq as ServiceAuthorization, cr as ServiceOutputContext, cs as ServiceOutputDecorator, cx as StandardSchemaFailure, cy as StandardSchemaInferOutput, cz as StandardSchemaIssue, cA as StandardSchemaPathSegment, cB as StandardSchemaResult, cC as StandardSchemaSuccess, cD as StandardSchemaV1, cG as SubOperationAccess, cK as SubRouteGuardOptions, cN as SubdocumentCreateAuthorization, cP as SubdocumentCreateOptions, cQ as SubdocumentCreateVisibilityAuthorization, cR as SubdocumentDeleteAuthorization, cS as SubdocumentDeleteOptions, cT as SubdocumentGateAuthorization, cV as SubdocumentInputAuthorization, cW as SubdocumentListOptions, cX as SubdocumentModel, cY as SubdocumentMutationAuthorization, cZ as SubdocumentName, c_ as SubdocumentOutputAuthorization, d1 as SubdocumentReadAuthorization, d2 as SubdocumentReadOptions, d4 as SubdocumentUpdateOptions, d5 as SubdocumentVirtuals, d6 as SubdocumentVisibilityAuthorization, d7 as SuperstructFailureLike, d8 as SuperstructValidateLike, dl as ValibotIssueLike, dm as ValibotPathItemLike, dn as ValibotSafeParseLike, dp as ValibotSafeParseResult, du as VineValidationErrorLike, dv as VineValidationMessageLike, dw as VineValidatorLike, dx as VirtualSubModel, dy as WithVirtuals, dz as YupSchemaLike, dA as YupValidationErrorLike, e4 as defaultRuntime, dB as defineRequestSchema, dC as fromAjv, dD as fromArkType, dE as fromIoTs, dF as fromJoi, dG as fromStandardSchema, dH as fromSuperstruct, dI as fromValibot, dJ as fromVine, dK as fromYup, dL as fromZod } from './parsers-h_oU4bB0.js';
3
+ import { A as AccessRouterBaseRequest, au as GuardHook, a_ as ModelRequest, dY as AccessRuntime, $ as DataRouterOptions, Z as DataRequest, dZ as DataService, ab as ExtendedDataRouterOptions, ai as Filter, bv as Projection, cC as Sort, br as Populate, a$ as ModelRouterOptions, d_ as Service, d$ as PublicService, ba as ModelVirtualRecordAccess, b4 as ModelVirtualDescriptor, b6 as ModelVirtualGetter, b7 as ModelVirtualLeaf, ad as ExtendedModelRouterOptions, dz as Validation, cm as RootRouterOptions, e0 as OpenApiRouterOptions, e1 as OpenApiRegistryOptions, e2 as OpenApiRouteDescriptor, e3 as OpenApiDocumentOptions, e4 as OpenApiParameter, e5 as OpenApiSchema, e6 as OpenApiResponses, as as GlobalOptions, a3 as DefaultModelRouterOptions, ac as ExtendedDefaultModelRouterOptions } from './parsers-BiFHfrNd.js';
4
+ export { e7 as AccessRouterPermissionMap, e8 as AccessRouterPermissions, c as AccessRouterRequest, d as AccessRouterRequestExtensions, l as AjvErrorObjectLike, n as AjvValidatorLike, o as AllowedOutputFieldOptions, p as ArkTypeErrorsLike, q as ArkTypeLike, s as AuthorizationMode, t as AuthorizedListResult, u as AuthorizedSingleResult, I as CreateAuthorization, O as DataFieldOptions, a8 as DocumentGrants, ae as FieldAuthorization, af as FieldOperationAccess, ag as FieldPermissionHook, ah as FieldValidation, ak as FilteredOutput, at as GlobalPermissionValue, av as HydrationMode, ay as InputFieldAuthorization, az as InputFieldPath, aA as IoTsContextEntryLike, aB as IoTsDecodeErrorLike, aC as IoTsDecoderLike, aD as JoiSchemaLike, aE as JoiValidationErrorDetailLike, aK as MaybePromise, aL as ModelBaseFilterHook, aN as ModelDeleteHook, aO as ModelDocPermissionsHook, aQ as ModelDocumentHook, aR as ModelHook, aT as ModelHydrationOptions, aU as ModelIdentifierHook, aV as ModelListHook, aW as ModelOutputContext, aX as ModelOutputHook, aY as ModelOutputListHook, aZ as ModelOverrideFilterHook, b0 as ModelValidateHook, b1 as ModelVirtualAccess, b2 as ModelVirtualAccessRecord, b3 as ModelVirtualContext, b5 as ModelVirtualDoc, b8 as ModelVirtualPopulateDependency, b9 as ModelVirtualPopulateInputs, bb as ModelVirtuals, bc as MutationAuthorization, bd as NewArgs, be as NewOptions, e9 as OpenApiMethod, bf as OperationAccess, bg as OperationAuthorization, bh as OutputAuthorization, bi as OutputFieldOptions, bj as OutputFieldPath, bk as OutputPlanningOptions, bn as PairedRouteAccess, bq as PermissionSchema, ea as Permissions, bt as PopulatePlanningOptions, bH as PublicSubdocumentCreateOptions, bI as PublicSubdocumentListOptions, bJ as PublicSubdocumentMutationOptions, bK as PublicSubdocumentReadOptions, bQ as RelatedAuthorization, bS as RequestSchemaAdapter, bT as RequestSchemaFailure, bU as RequestSchemaIssue, bV as RequestSchemaLike, bW as RequestSchemaOptions, bX as RequestSchemaResult, bY as RequestSchemaSuccess, bZ as RequestSchemaValidator, cp as RouteBaseAccess, cq as RouteGuardAccess, cr as RouteVariant, cs as RouteVariantAccess, ct as RowAuthorization, cx as ServiceAuthorization, cy as ServiceOutputContext, cz as ServiceOutputDecorator, cE as StandardSchemaFailure, cF as StandardSchemaInferOutput, cG as StandardSchemaIssue, cH as StandardSchemaPathSegment, cI as StandardSchemaResult, cJ as StandardSchemaSuccess, cK as StandardSchemaV1, cN as SubOperationAccess, cR as SubRouteGuardOptions, cU as SubdocumentCreateAuthorization, cW as SubdocumentCreateOptions, cX as SubdocumentCreateVisibilityAuthorization, cY as SubdocumentDeleteAuthorization, cZ as SubdocumentDeleteOptions, c_ as SubdocumentGateAuthorization, d0 as SubdocumentInputAuthorization, d1 as SubdocumentListOptions, d2 as SubdocumentModel, d3 as SubdocumentMutationAuthorization, d4 as SubdocumentName, d5 as SubdocumentOutputAuthorization, d8 as SubdocumentReadAuthorization, d9 as SubdocumentReadOptions, db as SubdocumentUpdateOptions, dc as SubdocumentVirtuals, dd as SubdocumentVisibilityAuthorization, de as SuperstructFailureLike, df as SuperstructValidateLike, dt as ValibotIssueLike, du as ValibotPathItemLike, dv as ValibotSafeParseLike, dw as ValibotSafeParseResult, dB as VineValidationErrorLike, dC as VineValidationMessageLike, dD as VineValidatorLike, dE as VirtualSubModel, dF as WithVirtuals, dG as YupSchemaLike, dH as YupValidationErrorLike, eb as defaultRuntime, dI as defineRequestSchema, dJ as fromAjv, dK as fromArkType, dL as fromIoTs, dM as fromJoi, dN as fromStandardSchema, dO as fromSuperstruct, dP as fromValibot, dQ as fromVine, dR as fromYup, dS as fromZod } from './parsers-BiFHfrNd.js';
5
5
  import JsonRouter from '@web-ts-toolkit/express-json-router';
6
6
  import 'zod';
7
+ import 'node:buffer';
7
8
 
8
9
  declare function macl(): (req: AccessRouterBaseRequest, res: Response, next: NextFunction) => Promise<void>;
9
10
  interface GuardModelConditionID {
@@ -15,6 +16,14 @@ interface GuardModelCondition {
15
16
  id: string | GuardModelConditionID;
16
17
  condition: string | string[];
17
18
  }
19
+ /**
20
+ * Request permission middleware. Model conditions require a visible row and fresh
21
+ * document facts, but publish no DTO: field/virtual/include output, decorate/tasks
22
+ * and `_read` overrides do not run or veto the condition. Source/fact errors remain
23
+ * BadRequest. This request-only read does not imply the generated HTTP READ gate;
24
+ * an admitted miss may retry once under captured LIST admission and READ mode.
25
+ * Put security in operation/row/fact hooks; use a separate normal read for a DTO.
26
+ */
18
27
  declare function guard(condition: string): RequestHandler;
19
28
  declare function guard(conditions: string[]): RequestHandler;
20
29
  declare function guard(conditionFunc: GuardHook<ModelRequest>): RequestHandler;
@@ -128,8 +137,8 @@ declare class ModelRouter<TModel = unknown, TVirtuals extends object = Record<ne
128
137
  /**
129
138
  * Acquire the model-generic internal service after this runtime's middleware
130
139
  * initializes req.macl. Supply trusted per-call authorization in service options;
131
- * selection/query args stay separate. Successful results carry opaque document
132
- * handles in context(s), never data. Use getPublicService for request-only wrappers.
140
+ * selection/query args stay separate. Successful results carry immutable diagnostic
141
+ * context(s), never reusable authority on data. Use getPublicService for request-only wrappers.
133
142
  */
134
143
  getService(req: ModelRequest): Service<TModel, TVirtuals>;
135
144
  getPublicService(req: ModelRequest): PublicService<TModel, TVirtuals>;
@@ -450,7 +459,7 @@ declare const getModelInstance: <TModel = unknown>(modelName: string) => mongoos
450
459
  * Update inherited model defaults shallowly. Unspecified model options follow these
451
460
  * updates for new calls, including existing models; explicit model values (even false
452
461
  * or empty objects/arrays) win. Model undefined restores inheritance. Existing calls,
453
- * handles, router.options snapshots and mounted route paths are not rewritten.
462
+ * router.options snapshots and mounted route paths are not rewritten.
454
463
  * Explicitly cleared operationAccess keeps its existing exact-key-only default fallback.
455
464
  */
456
465
  declare const setDefaultModelOptions: (options: DefaultModelRouterOptions) => void;