@web-ts-toolkit/access-router 0.42.2 → 0.44.0

package/index.mjs

@@ -784,6 +784,29 @@ var cloneConfigValue = (value) => {
     ])
   );
 };
+var cloneForRead = (value) => {
+  if (Array.isArray(value)) {
+    if (Object.isFrozen(value)) {
+      return value;
+    }
+    return value.map((item) => cloneForRead(item));
+  }
+  if (!value || typeof value !== "object") {
+    return value;
+  }
+  if (Object.getPrototypeOf(value) !== Object.prototype) {
+    return value;
+  }
+  if (Object.isFrozen(value)) {
+    return value;
+  }
+  return Object.fromEntries(
+    Object.entries(value).map(([entryKey, entryValue]) => [
+      entryKey,
+      cloneForRead(entryValue)
+    ])
+  );
+};
 var freezeConfigValue = (value) => {
   if (!value || typeof value !== "object") {
     return value;
@@ -799,6 +822,7 @@ var freezeConfigValue = (value) => {
   }
   return value;
 };
+var cloneAndFreezeForStore = (value) => freezeConfigValue(cloneForRead(value));
 var getNestedOption = (manager, key, defaultValue) => {
   const keys2 = String(key).split(".");
   if (keys2.length === 1) {
@@ -828,6 +852,14 @@ var OptionsManager = class {
         target[keystr] = value;
         _this.listeners[keystr] && _this.listeners[keystr].call(_this, value, keystr, target, oldvalue);
         return true;
+      },
+      defineProperty(target, key, descriptor) {
+        const keystr = String(key);
+        const oldvalue = target[keystr];
+        const result = Reflect.defineProperty(target, key, descriptor);
+        const newValue = target[keystr];
+        _this.listeners[keystr] && _this.listeners[keystr].call(_this, newValue, keystr, target, oldvalue);
+        return result;
       }
     });
   }
@@ -841,18 +873,18 @@ var OptionsManager = class {
   set(key, value) {
     const path = toPath(key);
     if (path.length <= 1) {
-      set2(this.currentOptions, path, this.preserveKeys.has(String(path[0])) ? value : cloneConfigValue(value));
+      set2(this.currentOptions, path, this.preserveKeys.has(String(path[0])) ? value : cloneAndFreezeForStore(value));
       return;
     }
     const [rootKey, ...nestedPath] = path;
     const currentRoot = get2(this.currentOptions, [rootKey], void 0);
     const baseRoot = isPlainObject8(currentRoot) ? currentRoot : {};
     const nextRoot = cloneConfigValue(baseRoot);
-    set2(nextRoot, nestedPath, cloneConfigValue(value));
-    set2(this.currentOptions, [rootKey], nextRoot);
+    set2(nextRoot, nestedPath, cloneForRead(value));
+    set2(this.currentOptions, [rootKey], freezeConfigValue(nextRoot));
   }
   fetch() {
-    const cloned = cloneConfigValue(this.currentOptions);
+    const cloned = cloneForRead(this.currentOptions);
     for (const key of this.preserveKeys) {
       if (key in this.currentOptions) {
         cloned[key] = this.currentOptions[key];
@@ -861,20 +893,20 @@ var OptionsManager = class {
     return freezeConfigValue(cloned);
   }
   assign(options) {
-    const cloned = cloneConfigValue(options);
+    const cloned = cloneForRead(options);
     for (const key of this.preserveKeys) {
       if (key in options) {
         cloned[key] = options[key];
       }
     }
-    assign(this.currentOptions, cloned);
+    assign(this.currentOptions, freezeConfigValue(cloned));
   }
   onchange(key, func) {
     set2(this.listeners, key, func);
     return this;
   }
   snapshot() {
-    const cloned = cloneConfigValue(this.currentOptions);
+    const cloned = cloneForRead(this.currentOptions);
     for (const key of this.preserveKeys) {
       if (key in this.currentOptions) {
         cloned[key] = this.currentOptions[key];
@@ -890,13 +922,13 @@ var OptionsManager = class {
         delete current[key];
       }
     }
-    const cloned = cloneConfigValue(snap);
+    const cloned = cloneForRead(snap);
     for (const key of this.preserveKeys) {
       if (key in snap) {
         cloned[key] = snap[key];
       }
     }
-    assign(current, cloned);
+    assign(current, freezeConfigValue(cloned));
   }
 };
 
@@ -1366,8 +1398,7 @@ var AccessRuntime = class {
   }
   setDataOptions(dataName, options) {
     const manager = this.getOrCreateDataOptions(dataName);
-    const currentDataOptions = manager.fetch();
-    manager.assign({ ...currentDataOptions, ...options });
+    manager.assign(options);
   }
   setDataOption(dataName, key, value) {
     const manager = this.getOrCreateDataOptions(dataName);
@@ -1377,6 +1408,11 @@ var AccessRuntime = class {
     const manager = this.getOrCreateDataOptions(dataName);
     return manager.fetch();
   }
+  getDataSnapshot(dataName) {
+    const manager = this.getOrCreateDataOptions(dataName);
+    const snapshot = manager.get("data");
+    return snapshot ?? [];
+  }
   getDataOption(dataName, key, defaultValue) {
     const manager = this.getOrCreateDataOptions(dataName);
     return getNestedOption(manager, key, defaultValue);
@@ -1498,6 +1534,9 @@ var getRuntime4 = () => getActiveRuntime() ?? defaultRuntime;
 var getDataOptions = (dataName) => {
   return getRuntime4().getDataOptions(dataName);
 };
+var getDataSnapshot = (dataName) => {
+  return getRuntime4().getDataSnapshot(dataName);
+};
 var getDataOption = (dataName, key, defaultValue) => {
   return getRuntime4().getDataOption(dataName, key, defaultValue);
 };
@@ -1507,9 +1546,6 @@ var getRuntime5 = () => getActiveRuntime() ?? defaultRuntime;
 var getModelRef = (modelName, refPath) => {
   return getRuntime5().getModelRef(modelName, refPath);
 };
-var getModelSub = (modelName) => {
-  return getRuntime5().getModelSub(modelName);
-};
 
 // src/services/base.ts
 import {
@@ -3436,7 +3472,7 @@ var DataService = class {
     this.req = req;
     this.dataName = dataName;
     this.options = getDataOptions(dataName);
-    this.data = this.options.data ?? [];
+    this.data = getDataSnapshot(dataName);
   }
   async findOne(filter2, args, options) {
     const filterErrors = validateClientFilter(filter2);
@@ -3617,8 +3653,11 @@ var copyAndDepopulate = (docObject, operations, options = { mutable: true, idFie
           if (!isPlainObject13(target)) return ret;
           const targetObject = target;
           const next = targetObject[seg];
-          if (isArray8(next)) ret.push(...next);
-          else if (next !== null && next !== void 0) ret.push(next);
+          if (isArray8(next)) {
+            for (const item of next) {
+              ret.push(item);
+            }
+          } else if (next !== null && next !== void 0) ret.push(next);
           return ret;
         }, []);
       }
@@ -3804,11 +3843,12 @@ async function resolveAccessFilter({
 }) {
   let nextFilter = normalizeFilter(filter2);
   const overrideFilterFn = getOption(`overrideFilter.${access}`, null);
-  if (isFunction4(overrideFilterFn)) {
+  if (nextFilter !== false && isFunction4(overrideFilterFn)) {
     nextFilter = normalizeFilter(await overrideFilterFn.call(req, nextFilter, permissions));
   }
+  if (nextFilter === false) return false;
   const baseFilterFn = getOption(`baseFilter.${access}`, null);
-  if (!isFunction4(baseFilterFn)) return nextFilter || {};
+  if (!isFunction4(baseFilterFn)) return nextFilter ?? {};
   const baseFilter = normalizeFilter(
     cache.has(cacheKey) ? cache.get(cacheKey) : await baseFilterFn.call(req, permissions)
   );
@@ -3816,7 +3856,7 @@ async function resolveAccessFilter({
     cache.set(cacheKey, baseFilter);
   }
   if (baseFilter === false) return false;
-  if (!baseFilter) return nextFilter || {};
+  if (!baseFilter) return nextFilter ?? {};
   if (!nextFilter) return baseFilter;
   return optimizeAndFilter([baseFilter, nextFilter]);
 }
@@ -3824,15 +3864,30 @@ function getRequestPermissions(req) {
   const requestPermissionField = getGlobalOption("requestPermissionField");
   return new permission_default(req[requestPermissionField] || {});
 }
+var permissionFieldOwners = /* @__PURE__ */ new WeakMap();
+function getPermissionFieldOwnerMap(req) {
+  let owners = permissionFieldOwners.get(req);
+  if (!owners) {
+    owners = /* @__PURE__ */ new Map();
+    permissionFieldOwners.set(req, owners);
+  }
+  return owners;
+}
 async function setRequestPermissions(req) {
   const requestPermissionField = getGlobalOption("requestPermissionField");
-  if (req[requestPermissionField]) return;
+  const activeRuntime = getActiveRuntime();
+  const owners = getPermissionFieldOwnerMap(req);
+  const owner = owners.get(requestPermissionField);
+  const hasFieldValue = Boolean(req[requestPermissionField]);
+  if (owner === activeRuntime) return;
+  if (hasFieldValue && owner === void 0) return;
   const globalPermissions = getGlobalOption("globalPermissions");
   if (!isFunction4(globalPermissions)) return;
   const permissions = await globalPermissions.call(req, req);
   if (isPlainObject14(permissions)) req[requestPermissionField] = permissions;
   else if (isArray9(permissions)) req[requestPermissionField] = arrayToRecord(permissions);
   else if (isString5(permissions)) req[requestPermissionField] = { [permissions]: true };
+  owners.set(requestPermissionField, activeRuntime);
 }
 async function evaluateRouteGuard(req, permissions, routeGuard) {
   const phas = (key) => permissions.has(key);
@@ -3900,17 +3955,14 @@ function getResolvedRequestPermissions(req) {
 async function setResolvedRequestPermissions(req) {
   await setRequestPermissions(req);
 }
-async function canActivateRequest(req, routeGuard) {
-  const permissions = getGlobalPermissions(req);
-  return evaluateRouteGuard(req, permissions, routeGuard);
-}
 async function initializeAclRequest({
   req,
   flag,
+  runtime,
   createCore,
   assignCore
 }) {
-  if (req[flag]) {
+  if (req[flag] === runtime) {
     return null;
   }
   const core = createCore(req);
@@ -3918,7 +3970,7 @@ async function initializeAclRequest({
   assignCore(core);
   req[PERMISSIONS] = core.getPermissions();
   req[PERMISSION_KEYS] = [...req[PERMISSIONS].keys];
-  req[flag] = true;
+  req[flag] = runtime;
   return core;
 }
 
@@ -4054,6 +4106,7 @@ async function resolveSelectForRequest({
 // src/core.ts
 var Core = class {
   constructor(req) {
+    this.cachedPermissions = null;
     this.req = req;
     this.caches = {
       baseFilter: new Cache()
@@ -4337,13 +4390,15 @@ var Core = class {
     return docObject;
   }
   getPermissions() {
+    if (this.cachedPermissions) return this.cachedPermissions;
     return getResolvedRequestPermissions(this.req);
   }
   async setPermissions() {
     await setResolvedRequestPermissions(this.req);
+    this.cachedPermissions = getResolvedRequestPermissions(this.req);
   }
   async canActivate(routeGuard) {
-    return canActivateRequest(this.req, routeGuard);
+    return evaluateRouteGuard(this.req, this.getGlobalPermissions(), routeGuard);
   }
   async isAllowed(modelName, access) {
     if (access.startsWith("subs")) {
@@ -4379,6 +4434,7 @@ var Core = class {
     return this.getPublicService(modelName);
   }
   getGlobalPermissions() {
+    if (this.cachedPermissions) return this.cachedPermissions;
     return getGlobalPermissions(this.req);
   }
 };
@@ -4388,6 +4444,7 @@ var createSetCore = (runtime = defaultRuntime) => {
       await initializeAclRequest({
         req,
         flag: MIDDLEWARE,
+        runtime,
         createCore: (request) => new Core(request),
         assignCore: (core) => {
           req.macl = core;
@@ -4768,8 +4825,9 @@ function defineRequestSchema(validator, options = {}) {
   };
 }
 function fromZod(schema) {
-  return (value) => {
-    const result = schema.safeParse(value);
+  return async (value) => {
+    const candidate = schema;
+    const result = typeof candidate.safeParseAsync === "function" ? await candidate.safeParseAsync.call(schema, value) : schema.safeParse(value);
     if (result.success) {
       return {
         success: true,
@@ -4806,6 +4864,9 @@ function fromYup(schema) {
         data
       };
     } catch (error2) {
+      if (!isYupValidationError(error2)) {
+        throw error2;
+      }
       return {
         success: false,
         issues: normalizeYupIssues(error2)
@@ -4830,8 +4891,32 @@ function fromJoi(schema) {
 }
 function fromAjv(validator) {
   return async (value) => {
-    const valid = await validator(value);
-    if (valid) {
+    const outcome = validator(value);
+    if (isThenable(outcome)) {
+      try {
+        const data = await outcome;
+        if (data === false) {
+          return {
+            success: false,
+            issues: normalizeAjvIssues(validator.errors ?? [])
+          };
+        }
+        return {
+          success: true,
+          data: data === true ? value : data
+        };
+      } catch (error2) {
+        if (!isAjvValidationError(error2)) {
+          throw error2;
+        }
+        return {
+          success: false,
+          issues: normalizeAjvIssues(error2.errors ?? [])
+        };
+      }
+    }
+    const errorsSnapshot = validator.errors ? [...validator.errors] : [];
+    if (outcome) {
       return {
         success: true,
         data: value
@@ -4839,7 +4924,7 @@ function fromAjv(validator) {
     }
     return {
       success: false,
-      issues: normalizeAjvIssues(validator.errors ?? [])
+      issues: normalizeAjvIssues(errorsSnapshot)
     };
   };
 }
@@ -4860,6 +4945,25 @@ function fromValibot(schema, safeParse) {
 }
 function fromArkType(type) {
   return async (value) => {
+    if (isStandardSchema(type)) {
+      const result2 = await type["~standard"].validate(value);
+      if (isArkTypeErrors(result2)) {
+        return {
+          success: false,
+          issues: normalizeArkTypeIssues(result2)
+        };
+      }
+      if (isStandardSchemaFailure(result2)) {
+        return {
+          success: false,
+          issues: normalizeArkTypeStandardIssues(result2.issues)
+        };
+      }
+      return {
+        success: true,
+        data: result2.value
+      };
+    }
     const result = await type(value);
     if (!isArkTypeErrors(result)) {
       return {
@@ -4912,6 +5016,9 @@ function fromVine(validator) {
         data: output
       };
     } catch (error2) {
+      if (!isVineValidationError(error2)) {
+        throw error2;
+      }
       return {
         success: false,
         issues: normalizeVineError(error2)
@@ -4972,6 +5079,13 @@ function normalizeArkTypeIssues(issues) {
   }));
   return normalized.length ? normalized : [{ message: issues.summary ?? "Validation failed" }];
 }
+function normalizeArkTypeStandardIssues(issues) {
+  const normalized = issues.map((issue) => ({
+    message: issue.message ?? issue.problem ?? "Validation failed",
+    path: issue.path?.flatMap((segment) => normalizePathSegment(segment))
+  }));
+  return normalized.length ? normalized : [{ message: "Validation failed" }];
+}
 function normalizeIoTsIssues(issues) {
   return issues.map((issue) => ({
     message: issue.message ?? "Validation failed",
@@ -5006,25 +5120,64 @@ function normalizeVineField(message) {
   }
   return path.length ? path : void 0;
 }
+function decodeAjvSegment(segment) {
+  return segment.replace(/~1/g, "/").replace(/~0/g, "~");
+}
+function encodePointerSegment(segment) {
+  return encodeURIComponent(segment.replace(/~/g, "~0").replace(/\//g, "~1"));
+}
 function parseAjvPath(issue) {
-  const path = issue.instancePath?.split("/").filter(Boolean).map((segment) => /^\d+$/.test(segment) ? Number(segment) : segment);
-  if (issue.params?.missingProperty) {
-    return (path ?? []).concat(issue.params.missingProperty);
+  const raw = issue.instancePath;
+  const base = raw == null || raw === "" ? [] : (raw.startsWith("/") ? raw.slice(1) : raw).split("/").map(decodeAjvSegment);
+  const missing = issue.params?.missingProperty;
+  if (typeof missing === "string") {
+    return [...base, missing];
   }
-  return path;
+  return base;
 }
 function parsePathString(path) {
   if (!path) return void 0;
   return path.replace(/\[(\d+)\]/g, ".$1").split(".").filter(Boolean).map((segment) => /^\d+$/.test(segment) ? Number(segment) : segment);
 }
 function isYupValidationError(error2) {
-  return typeof error2 === "object" && error2 !== null && "message" in error2;
+  if (typeof error2 !== "object" || error2 === null || !("message" in error2)) {
+    return false;
+  }
+  const candidate = error2;
+  return candidate.name === "ValidationError" && typeof candidate.message === "string" && Array.isArray(candidate.errors) && Array.isArray(candidate.inner);
 }
 function isArkTypeErrors(value) {
-  return Array.isArray(value);
+  if (typeof value !== "object" || value === null) {
+    return false;
+  }
+  const record = value;
+  return record.arkKind === "errors" || record[" arkKind"] === "errors";
+}
+function isThenable(value) {
+  return typeof value === "object" && value !== null && "then" in value && typeof value.then === "function";
+}
+function isAjvValidationError(error2) {
+  if (typeof error2 !== "object" || error2 === null || !("errors" in error2)) {
+    return false;
+  }
+  const errors = error2.errors;
+  return errors == null || Array.isArray(errors);
 }
 function isVineValidationError(error2) {
-  return typeof error2 === "object" && error2 !== null && "messages" in error2 && Array.isArray(error2.messages);
+  if (typeof error2 !== "object" || error2 === null || !("messages" in error2)) {
+    return false;
+  }
+  const candidate = error2;
+  if (!Array.isArray(candidate.messages) || candidate.messages.length === 0) {
+    return false;
+  }
+  const hasDiscriminator = candidate.code === "E_VALIDATION_ERROR" || candidate.name === "ValidationError";
+  if (!hasDiscriminator) {
+    return false;
+  }
+  return candidate.messages.every(
+    (message) => typeof message === "object" && message !== null && typeof message.message === "string" && typeof message.field === "string"
+  );
 }
 function formatIssue(issue, key, location = "pointer") {
   const path = (issue.path ?? []).map(String);
@@ -5041,7 +5194,7 @@ function formatIssue(issue, key, location = "pointer") {
   };
 }
 function buildPointer(path) {
-  return path.length === 0 ? "#" : `#/${path.join("/")}`;
+  return path.length === 0 ? "#" : `#/${path.map(encodePointerSegment).join("/")}`;
 }
 
 // src/validation/model-router.ts
@@ -5542,24 +5695,26 @@ function setModelCollectionRoutes(context) {
   router.post(`/${options.mutationRouteSegment}`, async (req) => {
     await context.assertAllowed(req, "create");
     const { include_permissions } = parseQuery(requestSchemas.createQuery, req.query);
-    const body = await parseNestedBodyWithSchema(
+    const intermediateBody = await parseNestedBodyWithSchema(
       advancedCreateBodySchema,
       req.body,
       "data",
       context.getRequestSchema("requestSchemas.advancedCreate.data")
     );
-    const { data, select, populate, tasks } = body;
-    const advancedOptions = body.options ?? {};
-    await parseBodyWithSchema(
+    const { data: nestedData, select: nestedSelect, populate: nestedPopulate, tasks: nestedTasks } = intermediateBody;
+    const nestedOptions = intermediateBody.options ?? {};
+    const finalBody = await parseBodyWithSchema(
       advancedCreateBodySchema,
-      { data, select, populate, tasks, options: advancedOptions },
+      { data: nestedData, select: nestedSelect, populate: nestedPopulate, tasks: nestedTasks, options: nestedOptions },
       context.getRequestSchema("requestSchemas.advancedCreate.default") ?? context.getRequestSchema("requestSchemas.advancedCreate")
     );
-    const { includePermissions, populateAccess } = advancedOptions;
+    const { data: finalData, select: finalSelect, populate: finalPopulate, tasks: finalTasks } = finalBody;
+    const finalOptions = finalBody.options ?? {};
+    const { includePermissions, populateAccess } = finalOptions;
     const svc = context.getPublicService(req);
     const result = await svc._create(
-      data,
-      { select, populate, tasks },
+      finalData,
+      { select: finalSelect, populate: finalPopulate, tasks: finalTasks },
       {
         includePermissions: includePermissions ?? parseBooleanString(include_permissions),
         populateAccess
@@ -5758,25 +5913,33 @@ function setModelDocumentRoutes(context) {
     await context.assertAllowed(req, "update");
     const id = parsePathParam(req.params[options.idParam], options.idParam);
     const { returning_all, include_permissions } = parseQuery(requestSchemas.updateQuery, req.query);
-    const body = await parseNestedBodyWithSchema(
+    const intermediateBody = await parseNestedBodyWithSchema(
       advancedUpdateBodySchema,
       req.body,
       "data",
       context.getRequestSchema("requestSchemas.advancedUpdate.data")
     );
-    const { data, select, populate, tasks } = body;
-    const advancedOptions = body.options ?? {};
-    await parseBodyWithSchema(
+    const { data: nestedData, select: nestedSelect, populate: nestedPopulate, tasks: nestedTasks } = intermediateBody;
+    const nestedOptions = intermediateBody.options ?? {};
+    const finalBody = await parseBodyWithSchema(
       advancedUpdateBodySchema,
-      { data, select, populate, tasks, options: advancedOptions },
+      {
+        data: nestedData,
+        select: nestedSelect,
+        populate: nestedPopulate,
+        tasks: nestedTasks,
+        options: nestedOptions
+      },
       context.getRequestSchema("requestSchemas.advancedUpdate.default") ?? context.getRequestSchema("requestSchemas.advancedUpdate")
     );
-    const { returningAll, includePermissions, populateAccess } = advancedOptions;
+    const { data: finalData, select: finalSelect, populate: finalPopulate, tasks: finalTasks } = finalBody;
+    const finalOptions = finalBody.options ?? {};
+    const { returningAll, includePermissions, populateAccess } = finalOptions;
     const svc = context.getPublicService(req);
     const result = await svc._update(
       id,
-      data,
-      { select, populate, tasks },
+      finalData,
+      { select: finalSelect, populate: finalPopulate, tasks: finalTasks },
       {
         returningAll: returningAll ?? parseBooleanString(returning_all),
         includePermissions: includePermissions ?? parseBooleanString(include_permissions),
@@ -5826,23 +5989,31 @@ function setModelDocumentRoutes(context) {
     await context.assertAllowed(req, "upsert");
     const svc = context.getPublicService(req);
     const { returning_all, include_permissions } = parseQuery(requestSchemas.upsertQuery, req.query);
-    const body = await parseNestedBodyWithSchema(
+    const intermediateBody = await parseNestedBodyWithSchema(
       advancedUpsertBodySchema,
       req.body,
       "data",
       context.getRequestSchema("requestSchemas.advancedUpsert.data")
     );
-    const { data, select, populate, tasks } = body;
-    const advancedOptions = body.options ?? {};
-    await parseBodyWithSchema(
+    const { data: nestedData, select: nestedSelect, populate: nestedPopulate, tasks: nestedTasks } = intermediateBody;
+    const nestedOptions = intermediateBody.options ?? {};
+    const finalBody = await parseBodyWithSchema(
       advancedUpsertBodySchema,
-      { data, select, populate, tasks, options: advancedOptions },
+      {
+        data: nestedData,
+        select: nestedSelect,
+        populate: nestedPopulate,
+        tasks: nestedTasks,
+        options: nestedOptions
+      },
       context.getRequestSchema("requestSchemas.advancedUpsert.default") ?? context.getRequestSchema("requestSchemas.advancedUpsert")
     );
-    const { returningAll, includePermissions, populateAccess } = advancedOptions;
+    const { data: finalData, select: finalSelect, populate: finalPopulate, tasks: finalTasks } = finalBody;
+    const finalOptions = finalBody.options ?? {};
+    const { returningAll, includePermissions, populateAccess } = finalOptions;
     const result = await svc._upsert(
-      data,
-      { select, populate, tasks },
+      finalData,
+      { select: finalSelect, populate: finalPopulate, tasks: finalTasks },
       {
         returningAll: returningAll ?? parseBooleanString(returning_all),
         includePermissions: includePermissions ?? parseBooleanString(include_permissions),
@@ -5912,7 +6083,7 @@ function setModelDocumentRoutes(context) {
 
 // src/routers/model-router-subdocument-routes.ts
 function setModelSubDocumentRoutes(context) {
-  const subs = getModelSub(context.modelName);
+  const subs = context.runtime.getModelSub(context.modelName);
   for (let x = 0; x < subs.length; x++) {
     const sub = subs[x];
     context.router.get(`/:${context.options.idParam}/${sub}`, async (req) => {
@@ -6137,7 +6308,9 @@ var ModelRouter = class _ModelRouter {
       "baseFilter"
     );
     /**
-     * The override filter definitions applied in every query transaction.
+     * Trusted filter replacements applied before base-filter composition.
+     * They may replace ordinary filters, but cannot replace an existing `false` denial.
+     * Returning `false` denies the transaction.
      * @operation `list`, `read`, `update`, `delete`
      */
     this.overrideFilter = setOption.bind(this, "overrideFilter");
@@ -6297,6 +6470,7 @@ var ModelRouter = class _ModelRouter {
       modelName: this.modelName,
       router: this.router,
       options: this.options,
+      runtime: this.runtime,
       getRequestSchema: this.getRequestSchema.bind(this),
       getPublicService: this.getPublicService.bind(this),
       assertAllowed: this.assertAllowed.bind(this),
@@ -6311,6 +6485,7 @@ var ModelRouter = class _ModelRouter {
       modelName: this.modelName,
       router: this.router,
       options: this.options,
+      runtime: this.runtime,
       getRequestSchema: this.getRequestSchema.bind(this),
       getPublicService: this.getPublicService.bind(this),
       assertAllowed: this.assertAllowed.bind(this),
@@ -6325,6 +6500,7 @@ var ModelRouter = class _ModelRouter {
       modelName: this.modelName,
       router: this.router,
       options: this.options,
+      runtime: this.runtime,
       getRequestSchema: this.getRequestSchema.bind(this),
       getPublicService: this.getPublicService.bind(this),
       assertAllowed: this.assertAllowed.bind(this),
@@ -6375,6 +6551,7 @@ import { isNumber as _isNumber, normalizeUrlPath as normalizeUrlPath3, orderBy a
 // src/core-data.ts
 var DataCore = class {
   constructor(req) {
+    this.cachedPermissions = null;
     this.req = req;
     this.caches = {
       baseFilter: new Cache()
@@ -6468,13 +6645,15 @@ var DataCore = class {
     });
   }
   getPermissions() {
+    if (this.cachedPermissions) return this.cachedPermissions;
     return getResolvedRequestPermissions(this.req);
   }
   async setPermissions() {
     await setResolvedRequestPermissions(this.req);
+    this.cachedPermissions = getResolvedRequestPermissions(this.req);
   }
   async canActivate(routeGuard) {
-    return canActivateRequest(this.req, routeGuard);
+    return evaluateRouteGuard(this.req, this.getGlobalPermissions(), routeGuard);
   }
   async isAllowed(dataName, access) {
     const operationAccess = getDataOption(dataName, `operationAccess.${access}`);
@@ -6490,6 +6669,7 @@ var DataCore = class {
     return this.getService(dataName);
   }
   getGlobalPermissions() {
+    if (this.cachedPermissions) return this.cachedPermissions;
     return getGlobalPermissions(this.req);
   }
 };
@@ -6499,6 +6679,7 @@ var createSetDataCore = (runtime = defaultRuntime) => {
       await initializeAclRequest({
         req,
         flag: DATA_MIDDLEWARE,
+        runtime,
         createCore: (request) => new DataCore(request),
         assignCore: (core) => {
           req.dacl = core;
@@ -6803,6 +6984,11 @@ var DataRouter = class {
       this,
       "baseFilter"
     );
+    /**
+     * Trusted filter replacements applied before base-filter composition.
+     * They may replace ordinary filters, but cannot replace an existing `false` denial.
+     * Returning `false` denies the transaction.
+     */
     this.overrideFilter = setOption2.bind(this, "overrideFilter");
     this.decorate = setOption2.bind(
       this,