@real-router/validation-plugin 0.1.0 → 0.2.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/dist/cjs/index.js
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
var e=require("@real-router/core"),t=require("@real-router/core/validation"),r=require("@real-router/logger"),o=["replace","reload","force","forceDeactivate","redirected"],n=/\S/,a=/^[A-Z_a-z][\w-]*(?:\.[A-Z_a-z][\w-]*)*$/;function i(e,t){return new TypeError(`[router.${e}] ${t}`)}function c(e,t=new WeakSet){if(null==e)return!0;const r=typeof e;if("string"===r||"boolean"===r)return!0;if("number"===r)return Number.isFinite(e);if("function"===r||"symbol"===r)return!1;if(Array.isArray(e))return!t.has(e)&&(t.add(e),e.every(e=>c(e,t)));if("object"===r){if(t.has(e))return!1;t.add(e);const r=Object.getPrototypeOf(e);return(null===r||r===Object.prototype)&&Object.values(e).every(e=>c(e,t))}return!1}function s(e){if(null==e)return!0;const t=typeof e;return"string"===t||"boolean"===t||"number"===t&&Number.isFinite(e)}function u(e){if("object"!=typeof e||null===e||Array.isArray(e))return!1;const t=Object.getPrototypeOf(e);if(null!==t&&t!==Object.prototype)return!1;let r=!1;for(const t in e){if(!Object.hasOwn(e,t))continue;const o=e[t];if(!s(o)){const e=typeof o;if("function"===e||"symbol"===e)return!1;r=!0;break}}return!r||c(e)}function f(e){return"object"==typeof e&&null!==e&&function(e){return function(e){return"string"==typeof e&&(""===e||!(e.length>1e4)&&(!!e.startsWith("@@")||a.test(e)))}(e.name)&&"string"==typeof e.path&&u(e.params)}(e)}function d(e){return"string"==typeof e}function l(e){return"boolean"==typeof e}function p(e,t){return e in t}function w(e,t){if("string"!=typeof e)throw i(t,"Route name must be a string, got "+typeof e);if(""!==e){if(!n.test(e))throw i(t,"Route name cannot contain only whitespace");if(e.length>1e4)throw i(t,"Route name exceeds maximum length of 10000 characters. This is a technical safety limit.");if(!e.startsWith("@@")&&!a.test(e))throw i(t,`Invalid route name "${e}". Each segment must start with a letter or underscore, followed by letters, numbers, underscores, or hyphens. Segments are separated by dots (e.g., "users.profile").`)}}function y(e){return null===e?"null":Array.isArray(e)?`array[${e.length}]`:"object"==typeof e?"constructor"in e&&"Object"!==e.constructor.name?e.constructor.name:"object":typeof e}function g(e){return{warn:Math.floor(.2*e),error:Math.floor(.5*e)}}function m(e,t){if("string"!=typeof e)throw new TypeError(`[router.${t}] dependency name must be a string, got ${typeof e}`)}function h(e,t){if(!e||"object"!=typeof e||e.constructor!==Object)throw new TypeError(`[router.${t}] Invalid argument: expected plain object, received ${y(e)}`);for(const r in e)if(Object.getOwnPropertyDescriptor(e,r)?.get)throw new TypeError(`[router.${t}] Getters not allowed: "${r}"`)}function v(e,t){const o=e,n=o.limits?.maxDependencies??100;if(0===n)return;const a=Object.keys(o.dependencies).length,{warn:i,error:c}=g(n);if(a>=n)throw new RangeError(`[router.${t}] Dependency limit exceeded (${n}). Current: ${a}.`);a===c?r.logger.error(`router.${t}`,`${a} dependencies registered! This indicates architectural problems. Hard limit at ${n}.`):a===i&&r.logger.warn(`router.${t}`,`${a} dependencies registered. Consider if all are necessary.`)}function $(e){if(void 0!==e){if(!e||"object"!=typeof e||e.constructor!==Object)throw new TypeError("[cloneRouter] Invalid dependencies: expected plain object or undefined, received "+typeof e);for(const t in e)if(Object.getOwnPropertyDescriptor(e,t)?.get)throw new TypeError(`[cloneRouter] Getters not allowed in dependencies: "${t}"`)}}function b(e,t){r.logger.warn(`router.${t}`,"Router dependency already exists and is being overwritten:",e)}function E(e,t){r.logger.warn(`router.${t}`,"Overwritten:",e.join(", "))}function T(e){r.logger.warn("router.removeDependency",`Attempted to remove non-existent dependency: "${"string"==typeof e?e:String(e)}"`)}var P=new Set(["$start","$stop","$$start","$$cancel","$$success","$$error"]);function j(e){if(!P.has(e))throw new TypeError(`[router.addEventListener] Invalid event name: ${String(e)}. Must be one of: $start, $stop, $$start, $$cancel, $$success, $$error`)}function R(e,t){if(!l(e)&&"function"!=typeof e)throw new TypeError(`[router.${t}] Handler must be a boolean or factory function, got ${y(e)}`)}function A(e,t,o){r.logger.warn(`router.${o}`,`Overwriting existing ${t} handler for route "${e}"`)}function x(e,t){r.logger.warn(`router.${t}`,`Guard for "${e}" returned a Promise. Sync check cannot resolve async guards — returning false.`)}function S(e){if("string"!=typeof e)throw new TypeError(`[router.navigate] Invalid route name: expected string, got ${y(e)}`)}function O(e){if(void 0!==e&&("object"!=typeof e||null===e))throw new TypeError(`[router.navigateToDefault] Invalid options: ${y(e)}. Expected NavigationOptions object.`)}function I(e,t){if(!function(e){if("object"!=typeof e||null===e||Array.isArray(e))return!1;const t=e;for(const e of o){const r=t[e];if(void 0!==r&&"boolean"!=typeof r)return!1}const r=t.signal;return!(void 0!==r&&!(r instanceof AbortSignal))}(e))throw new TypeError(`[router.${t}] Invalid options: ${y(e)}. Expected NavigationOptions object.`)}function D(e,t){if(void 0!==e&&!u(e))throw new TypeError(`[router.${t}] params must be a plain object, got ${y(e)}`)}function k(e){if(void 0!==e&&"string"!=typeof e)throw new TypeError(`[router.start] path must be a string, got ${y(e)}.`);if("string"==typeof e&&""!==e&&!e.startsWith("/"))throw new TypeError(`[router.start] path must start with "/", got "${e}".`)}var M=["strict","never","always","preserve"],N=["default","strict","loose"],F=["default","uri","uriComponent","none"],C={arrayFormat:["none","brackets","index","comma"],booleanFormat:["none","string","empty-true"],nullFormat:["default","hidden"]},L=["all","warn-error","error-only","none"],q=new Set(["defaultRoute","defaultParams","trailingSlash","queryParamsMode","queryParams","urlParamsEncoding","allowNotFound","rewritePathOnMatch","logger","limits"]),_={maxDependencies:{min:0,max:1e4},maxPlugins:{min:0,max:1e3},maxListeners:{min:0,max:1e5},warnListeners:{min:0,max:1e5},maxEventDepth:{min:0,max:100},maxLifecycleHandlers:{min:0,max:1e4}};function B(e,t,r){if("number"!=typeof t||!Number.isInteger(t))throw new TypeError(`[router.${r}] limit "${e}" must be an integer, got ${String(t)}`);const o=_[e];if(t<o.min||t>o.max)throw new RangeError(`[router.${r}] limit "${e}" must be between ${o.min} and ${o.max}, got ${t}`)}function H(e,t){if(!e||"object"!=typeof e||e.constructor!==Object)throw new TypeError(`[router.${t}] invalid limits: expected plain object, got ${typeof e}`);for(const[r,o]of Object.entries(e)){if(!Object.hasOwn(_,r))throw new TypeError(`[router.${t}] unknown limit: "${r}"`);void 0!==o&&B(r,o,t)}}function U(e,t,r,o){if(void 0!==e&&("string"!=typeof e||!r.includes(e))){const n=r.map(e=>`"${e}"`).join(", ");throw new TypeError(`[router.${o}] Invalid "${t}": "${"string"==typeof e?e:`(${typeof e})`}". Must be one of: ${n}`)}}function W(e,t){if(!e||"object"!=typeof e||Array.isArray(e))throw new TypeError(`[router.${t}] Invalid options: expected plain object`);const r=e;for(const e of Object.keys(r))if(!q.has(e))throw new TypeError(`[router.${t}] Unknown option: "${e}"`);if(function(e,t){if(void 0!==e&&"string"!=typeof e&&"function"!=typeof e)throw new TypeError(`[router.${t}] Invalid "defaultRoute": expected string or function, got ${typeof e}`)}(r.defaultRoute,t),function(e,t){if(void 0!==e&&"function"!=typeof e&&(!e||"object"!=typeof e||Array.isArray(e)||e.constructor!==Object))throw new TypeError(`[router.${t}] Invalid "defaultParams": expected plain object or function, got ${typeof e}`)}(r.defaultParams,t),U(r.trailingSlash,"trailingSlash",M,t),U(r.queryParamsMode,"queryParamsMode",N,t),U(r.urlParamsEncoding,"urlParamsEncoding",F,t),void 0!==r.allowNotFound&&"boolean"!=typeof r.allowNotFound)throw new TypeError(`[router.${t}] Invalid "allowNotFound": expected boolean, got ${typeof r.allowNotFound}`);if(void 0!==r.rewritePathOnMatch&&"boolean"!=typeof r.rewritePathOnMatch)throw new TypeError(`[router.${t}] Invalid "rewritePathOnMatch": expected boolean, got ${typeof r.rewritePathOnMatch}`);!function(e,t){if(void 0===e)return;if(!e||"object"!=typeof e||Array.isArray(e))throw new TypeError(`[router.${t}] Invalid "queryParams": expected plain object`);const r=e;for(const e of Object.keys(r)){if(!p(e,C))throw new TypeError(`[router.${t}] Invalid "queryParams.${e}": unknown option`);U(r[e],`queryParams.${e}`,C[e],t)}}(r.queryParams,t),function(e,t){if(void 0===e)return;if(!e||"object"!=typeof e||Array.isArray(e))throw new TypeError(`[router.${t}] Invalid "logger": expected plain object`);const r=e;if(void 0!==r.level&&!L.includes(r.level)){const e=L.map(e=>`"${e}"`).join(", ");throw new TypeError(`[router.${t}] Invalid "logger.level": "${"string"==typeof r.level?r.level:`(${typeof r.level})`}". Must be one of: ${e}`)}if(void 0!==r.callback&&"function"!=typeof r.callback)throw new TypeError(`[router.${t}] Invalid "logger.callback": expected function`);if(void 0!==r.callbackIgnoresLevel&&"boolean"!=typeof r.callbackIgnoresLevel)throw new TypeError(`[router.${t}] Invalid "logger.callbackIgnoresLevel": expected boolean`)}(r.logger,t),void 0!==r.limits&&H(r.limits,t)}var G="router.usePlugin",z={onStart:!0,onStop:!0,onTransitionStart:!0,onTransitionSuccess:!0,onTransitionError:!0,onTransitionCancel:!0};function Z(e){for(const t in e)if("teardown"!==t&&!(t in z))throw new TypeError(`[router.usePlugin] Unknown property '${t}'. Plugin must only contain event handlers and optional teardown.`)}function Q(){r.logger.warn(G,"Duplicate factory in batch, will be registered once")}function V(e){r.logger.warn(G,`Property '${e}' is not a function, skipping`)}function K(e){"onStart"===e&&r.logger.warn(G,"Router already started, onStart will not be called")}function J(e,t){const r=["start","buildPath","forwardState"];if("string"!=typeof e||!r.includes(e))throw new TypeError(`[router.addInterceptor] Invalid method: "${String(e)}". Must be one of: ${r.join(", ")}`);if("function"!=typeof t)throw new TypeError("[router.addInterceptor] interceptor must be a function, got "+typeof t)}function X(e,t){if(!e||"object"!=typeof e)throw new TypeError(`[validation-plugin] ${t}: store must be an object`);const r=e;if(!Array.isArray(r.definitions))throw new TypeError(`[validation-plugin] ${t}: store.definitions must be an array`);if(!r.config||"object"!=typeof r.config)throw new TypeError(`[validation-plugin] ${t}: store.config must be an object`);if(!r.tree||"object"!=typeof r.tree)throw new TypeError(`[validation-plugin] ${t}: store.tree must be an object`);return r}function Y(e,t,r=""){for(const o of e){const e=r?`${r}.${o.name}`:o.name;t(o,e),o.children&&Y(o.children,t,e)}}function ee(e,t){const r=t.split(".");let o=e;for(const e of r)if(o=o.children.get(e),!o)return!1;return!0}function te(t,r){try{return e.resolveForwardChain(t,r)}catch(e){throw new Error(`[validation-plugin] ${e.message}`,{cause:e})}}function re(e){const t=new Set;for(const r of e){for(const e of r.paramMeta.urlParams)t.add(e);for(const e of r.paramMeta.spatParams)t.add(e)}return t}function oe(e,t,r){if("AsyncFunction"===e.constructor.name||e.toString().includes("__awaiter"))throw new TypeError(`[validation-plugin] Route "${r}" ${t} cannot be async`)}function ne(e){const t=X(e,"validateExistingRoutes"),r=new Set;Y(t.definitions,(e,t)=>{if("string"!=typeof e.name||!e.name)throw new TypeError(`[validation-plugin] validateExistingRoutes: route has invalid name: ${e.name}`);if("string"!=typeof e.path)throw new TypeError(`[validation-plugin] validateExistingRoutes: route "${t}" has non-string path (${typeof e.path})`);if(r.has(t))throw new Error(`[validation-plugin] validateExistingRoutes: duplicate route name detected: "${t}"`);r.add(t)})}function ae(e){const t=X(e,"validateForwardToConsistency"),{config:r,tree:o,matcher:n}=t;for(const[e,t]of Object.entries(r.forwardMap)){if(!ee(o,t))throw new Error(`[validation-plugin] validateForwardToConsistency: forwardTo target "${t}" does not exist in tree (source route: "${e}")`);const r=n.getSegmentsByName(e),a=n.getSegmentsByName(t);if(r&&a){const o=re(r),n=[...re(a)].filter(e=>!o.has(e));if(n.length>0)throw new Error(`[validation-plugin] validateForwardToConsistency: forwardTo target "${t}" requires params [${n.join(", ")}] not available in source route "${e}"`)}}for(const e of Object.keys(r.forwardMap))te(e,r.forwardMap)}function ie(e){if(!e||"object"!=typeof e)throw new TypeError("[validation-plugin] validateDependenciesStructure: deps must be an object");const t=e;if(!t.dependencies||"object"!=typeof t.dependencies)throw new TypeError("[validation-plugin] validateDependenciesStructure: deps.dependencies must be an object");const r=t.dependencies;for(const e of Object.keys(r))if(Object.getOwnPropertyDescriptor(r,e)?.get)throw new TypeError(`[validation-plugin] validateDependenciesStructure: dependency "${e}" must not use a getter`);if(!t.limits||"object"!=typeof t.limits)throw new TypeError("[validation-plugin] validateDependenciesStructure: deps.limits must be an object");const o=t.limits,n=["maxDependencies","maxPlugins","maxListeners","warnListeners","maxEventDepth","maxLifecycleHandlers"];for(const e of n)if("number"!=typeof o[e])throw new TypeError(`[validation-plugin] validateDependenciesStructure: deps.limits.${e} must be a number, got ${typeof o[e]}`)}function ce(e,t){return new TypeError(`[router.${e}] ${t}`)}var se=/^[A-Z_a-z][\w-]*$/,ue=/\S/;function fe(e){return null===e?"null":"object"==typeof e?"constructor"in e&&"Object"!==e.constructor.name?e.constructor.name:"object":typeof e}function de(e,t){if(!t.includes("."))return e.children.get(t);let r=e;for(const e of t.split("."))if(r=r.children.get(e),!r)return;return r}function le(e,t,r,o="",n,a){!function(e,t){if(!e||"object"!=typeof e)throw new TypeError(`[router.${t}] Route must be an object, got ${fe(e)}`);const r=Object.getPrototypeOf(e);if(r!==Object.prototype&&null!==r)throw new TypeError(`[router.${t}] Route must be a plain object, got ${fe(e)}`);if(function(e){for(const t of Object.keys(e)){const r=Object.getOwnPropertyDescriptor(e,t);if(r&&(r.get||r.set))return!0}return!1}(e))throw new TypeError(`[router.${t}] Route must not have getters or setters`)}(e,t);const i=e;!function(e,t){if("string"!=typeof e.name)throw new TypeError(`[router.${t}] Route name must be a string, got ${fe(e.name)}`);const r=e.name;if(""===r)throw new TypeError(`[router.${t}] Route name cannot be empty`);if(!ue.test(r))throw new TypeError(`[router.${t}] Route name cannot contain only whitespace`);if(r.length>1e4)throw new TypeError(`[router.${t}] Route name exceeds maximum length of 10000 characters`);if(!r.startsWith("@@")){if(r.includes("."))throw new TypeError(`[router.${t}] Route name "${r}" cannot contain dots. Use children array or { parent } option in addRoute() instead.`);if(!se.test(r))throw new TypeError(`[router.${t}] Invalid route name "${r}". Name must start with a letter or underscore, followed by letters, numbers, underscores, or hyphens.`)}}(i,t),function(e,t,r,o){if("string"!=typeof e){let t;throw t=null===e?"null":Array.isArray(e)?"array":typeof e,ce(r,`Route path must be a string, got ${t}`)}if(""===e)return;if(/\s/.test(e))throw ce(r,`Invalid path for route "${t}": whitespace not allowed in "${e}"`);if(!/^([/?~]|[^/]+$)/.test(e))throw ce(r,`Route "${t}" has invalid path format: "${e}". Path should start with '/', '~', '?' or be a relative segment.`);if(e.includes("//"))throw ce(r,`Invalid path for route "${t}": double slashes not allowed in "${e}"`);const n=o&&Object.values(o.paramTypeMap).includes("url");if(e.startsWith("~")&&n)throw ce(r,`Absolute path "${e}" cannot be used under parent route with URL parameters`)}(i.path,i.name,t,r),function(e,t){if(void 0!==e.encodeParams&&"function"!=typeof e.encodeParams)throw new TypeError(`[router.${t}] Route "${String(e.name)}" encodeParams must be a function`)}(i,t),function(e,t){if(void 0!==e.decodeParams&&"function"!=typeof e.decodeParams)throw new TypeError(`[router.${t}] Route "${String(e.name)}" decodeParams must be a function`)}(i,t);const c=i.name,s=o?`${o}.${c}`:c;r&&s&&function(e,t,r){if(de(e,t))throw new Error(`[router.${r}] Route "${t}" already exists`)}(r,s,t),n&&function(e,t,r){if(e.has(t))throw new Error(`[router.${r}] Duplicate route "${t}" in batch`);e.add(t)}(n,s,t);const u=i.path,f=o;if(r&&function(e,t,r,o){const n=""===t?e:de(e,t);if(n)for(const e of n.children.values())if(e.path===r)throw new Error(`[router.${o}] Path "${r}" is already defined`)}(r,f,u,t),a&&function(e,t,r,o){const n=e.get(t);if(n?.has(r))throw new Error(`[router.${o}] Path "${r}" is already defined`);n?n.add(r):e.set(t,new Set([r]))}(a,f,u,t),void 0!==i.children){if(!Array.isArray(i.children))throw new TypeError(`[router.${t}] Route "${c}" children must be an array, got ${fe(i.children)}`);for(const e of i.children)le(e,t,r,s,n,a)}}function pe(e,t){if(void 0!==e.canActivate&&"function"!=typeof e.canActivate)throw new TypeError(`[router.addRoute] canActivate must be a function for route "${t}", got ${y(e.canActivate)}`);if(void 0!==e.canDeactivate&&"function"!=typeof e.canDeactivate)throw new TypeError(`[router.addRoute] canDeactivate must be a function for route "${t}", got ${y(e.canDeactivate)}`);if(void 0!==e.defaultParams){const r=e.defaultParams;if(null===r||"object"!=typeof r||Array.isArray(r))throw new TypeError(`[router.addRoute] defaultParams must be an object for route "${t}", got ${y(e.defaultParams)}`)}if("AsyncFunction"===e.decodeParams?.constructor.name)throw new TypeError(`[router.addRoute] decodeParams cannot be async for route "${t}". Async functions break matchPath/buildPath.`);if("AsyncFunction"===e.encodeParams?.constructor.name)throw new TypeError(`[router.addRoute] encodeParams cannot be async for route "${t}". Async functions break matchPath/buildPath.`);if(function(e,t){if(void 0!==e&&"function"==typeof e){const r="AsyncFunction"===e.constructor.name,o=e.toString().includes("__awaiter");if(r||o)throw new TypeError(`[router.addRoute] forwardTo callback cannot be async for route "${t}". Async functions break matchPath/buildPath.`)}}(e.forwardTo,t),e.children)for(const r of e.children)pe(r,`${t}.${r.name}`)}function we(e){const t=new Set,r=/[*:]([A-Z_a-z]\w*)/g;let o;for(;null!==(o=r.exec(e));)t.add(o[1]);return t}function ye(e){const t=new Set;for(const r of e)for(const e of we(r))t.add(e);return t}function ge(e,t,r="",o=[]){for(const n of e){const e=r?`${r}.${n.name}`:n.name,a=[...o,n.path];if(e===t)return a;if(n.children&&t.startsWith(`${e}.`))return ge(n.children,t,e,a)}throw new Error(`[internal] collectPathsToRoute: route "${t}" not found`)}function me(e,t=""){const r=new Set;for(const o of e){const e=t?`${t}.${o.name}`:o.name;if(r.add(e),o.children)for(const t of me(o.children,e))r.add(t)}return r}function he(e,t=""){const r=new Map;for(const o of e){const e=t?`${t}.${o.name}`:o.name;if(o.forwardTo&&"string"==typeof o.forwardTo&&r.set(e,o.forwardTo),o.children)for(const[t,n]of he(o.children,e))r.set(t,n)}return r}function ve(e,t,r,o){return t?function(e){const t=new Set;for(const r of e){for(const e of r.paramMeta.urlParams)t.add(e);for(const e of r.paramMeta.spatParams)t.add(e)}return t}(function(e,t){const r=[],o=t.includes(".")?t.split("."):[t];""!==e.path&&r.push(e);let n=e;for(const e of o){const t=n.children.get(e);if(!t)return null;r.push(t),n=t}return r}(r,e)??[]):ye(ge(o,e))}function $e(e,t,r,o,n){const a=function(e,t){const r=t.split(".");let o=e;for(const e of r)if(o=o.children.get(e),!o)return!1;return!0}(n,t),i=o.has(t);if(!a&&!i)throw new ReferenceError(`[router.addRoute] forwardTo target "${t}" does not exist for route "${e}"`);const c=ye(ge(r,e)),s=[...ve(t,a,n,r)].filter(e=>!c.has(e));if(s.length>0)throw new Error(`[router.addRoute] forwardTo target "${t}" requires params [${s.join(", ")}] that are not available in source route "${e}"`)}function be(t,r,o){const n=me(t),a=he(t),i={...r};for(const[e,t]of a)i[e]=t;for(const[e,r]of a)$e(e,r,t,n,o);for(const t of Object.keys(i))e.resolveForwardChain(t,i)}function Ee(e,t){if(e.startsWith("@@"))throw new Error(`[router.${t}] Route name "${e}" uses the reserved "@@" prefix. Routes with this prefix are internal and cannot be modified through the public API.`)}function Te(e,t){for(const r of e)r&&"object"==typeof r&&"string"==typeof r.name&&(Ee(r.name,t),r.children&&Te(r.children,t))}function Pe(e){w(e,"removeRoute")}function je(e){if("string"!=typeof e)throw new TypeError(`[router.setRootPath] rootPath must be a string, got ${y(e)}`)}function Re(e){return"AsyncFunction"===e.constructor.name||String(e).includes("__awaiter")}function Ae(e){const t=e;if(void 0!==t.canActivate&&"function"!=typeof t.canActivate)throw new TypeError(`[router.addRoute] canActivate must be a function, got ${y(t.canActivate)}`);if(void 0!==t.canDeactivate&&"function"!=typeof t.canDeactivate)throw new TypeError(`[router.addRoute] canDeactivate must be a function, got ${y(t.canDeactivate)}`)}function xe(e){const t=e,r=t.name;if(void 0!==t.decodeParams&&Re(t.decodeParams))throw new TypeError(`[router.addRoute] decodeParams cannot be async for route "${String(r)}"`);if(void 0!==t.encodeParams&&Re(t.encodeParams))throw new TypeError(`[router.addRoute] encodeParams cannot be async for route "${String(r)}"`);if("function"==typeof t.forwardTo&&Re(t.forwardTo))throw new TypeError(`[router.addRoute] forwardTo callback cannot be async for route "${String(r)}"`)}function Se(e,t,r,o){if(!d(e))throw new TypeError("[router.isActiveRoute] name must be a string, got "+typeof e);if(void 0!==t&&!u(t))throw new TypeError(`[router.isActiveRoute] params must be a plain object, got ${y(t)}`);if(void 0!==r&&"boolean"!=typeof r)throw new TypeError("[router.isActiveRoute] strictEquality must be a boolean, got "+typeof r);if(void 0!==o&&"boolean"!=typeof o)throw new TypeError("[router.isActiveRoute] ignoreQueryParams must be a boolean, got "+typeof o)}function Oe(e,t,r){if(!d(e))throw new TypeError(`[router.${r}] Invalid routeName: ${y(e)}. Expected string.`);if(!u(t))throw new TypeError(`[router.${r}] Invalid routeParams: ${y(t)}. Expected plain object.`)}function Ie(e,t){if(w(e,"updateRoute"),""===e)throw new ReferenceError("[router.updateRoute] Invalid name: empty string. Cannot update root node.");if(null===t)throw new TypeError("[router.updateRoute] updates must be an object, got null");if("object"!=typeof t||Array.isArray(t))throw new TypeError(`[router.updateRoute] updates must be an object, got ${y(t)}`)}function De(e,t){if("AsyncFunction"===e.constructor.name||e.toString().includes("__awaiter"))throw new TypeError(`[router.updateRoute] ${t} cannot be an async function`)}function ke(e,t){if(null!=e){if("function"!=typeof e)throw new TypeError(`[router.updateRoute] ${t} must be a function or null, got ${typeof e}`);De(e,t)}}function Me(e){if(!d(e)||""===e)throw new TypeError("[router.buildPath] route must be a non-empty string, got "+("string"==typeof e?'""':typeof e))}function Ne(e){if(!d(e))throw new TypeError("[router.matchPath] path must be a string, got "+typeof e)}function Fe(e){if(!d(e))throw new TypeError("[router.shouldUpdateNode] nodeName must be a string, got "+typeof e)}function Ce(t,r,o,n,a){if(!o(t))throw new ReferenceError(`[router.updateRoute] route "${t}" does not exist`);if(null!=r&&"string"==typeof r){if(!o(r))throw new Error(`[router.updateRoute] forwardTo target "${r}" does not exist`);(function(e,t,r){const o=r.getSegmentsByName(e),n=r.getSegmentsByName(t),a=function(e){const t=new Set;for(const r of e)for(const e of r.paramMeta.urlParams)t.add(e);return t}(o),i=[];for(const e of n)for(const t of e.paramMeta.urlParams)i.push(t);const c=i.filter(e=>!a.has(e));if(c.length>0)throw new Error(`[router.addRoute] forwardTo target "${t}" requires params [${c.join(", ")}] that are not available in source route "${e}"`)})(t,r,n),function(t,r,o){const n={...o.forwardMap,[t]:r};e.resolveForwardChain(t,n)}(t,r,a)}}function Le(e,t,r,o){if(!d(e))throw new TypeError(`[router.makeState] Invalid name: ${y(e)}. Expected string.`);if(void 0!==t&&!u(t))throw new TypeError(`[router.makeState] Invalid params: ${y(t)}. Expected plain object.`);if(void 0!==r&&!d(r))throw new TypeError(`[router.makeState] Invalid path: ${y(r)}. Expected string.`);if(void 0!==o&&"number"!=typeof o)throw new TypeError(`[router.makeState] Invalid forceId: ${y(o)}. Expected number.`)}function qe(e){return{routes:{validateBuildPathArgs:Me,validateMatchPathArgs:Ne,validateIsActiveRouteArgs:Se,validateShouldUpdateNodeArgs:Fe,validateStateBuilderArgs:Oe,validateAddRouteArgs(e){!function(e){for(const t of e){if(null===t||"object"!=typeof t||Array.isArray(t))throw new TypeError(`[router.addRoute] Route must be an object, got ${y(t)}`);pe(t,t.name)}}(e)},validateRoutes(e,t){const r=t;!function(e,t,r){const o=new Set,n=new Map;for(const r of e)le(r,"addRoute",t,"",o,n);t&&r&&be(e,r,t)}(e,r.tree,r.config?.forwardMap)},validateRemoveRouteArgs:Pe,validateUpdateRouteBasicArgs:Ie,validateUpdateRoutePropertyTypes(e,t){!function(e,t,r,o){if(null!=e){if("string"!=typeof e&&"function"!=typeof e)throw new TypeError(`[router.updateRoute] forwardTo must be a string, function, or null, got ${y(e)}`);"function"==typeof e&&De(e,"forwardTo callback")}if(null!=t&&("object"!=typeof t||Array.isArray(t)))throw new TypeError(`[router.updateRoute] defaultParams must be an object or null, got ${y(t)}`);ke(r,"decodeParams"),ke(o,"encodeParams")}(t.forwardTo,t.defaultParams,t.decodeParams,t.encodeParams)},validateUpdateRoute(e,t,r){const o=r;Ce(e,t.forwardTo,e=>o.matcher.hasRoute(e),o.matcher,o.config)},validateParentOption(e,t){!function(e){if("string"!=typeof e||""===e)throw new TypeError(`[router.addRoute] parent option must be a non-empty string, got ${y(e)}`);w(e,"addRoute")}(e);let r=t;for(const t of e.split(".")){const o=r.children.get(t);if(!o)throw new ReferenceError(`[router.addRoute] Parent route "${e}" does not exist`);r=o}},validateRouteName(e,t){w(e,t)},throwIfInternalRoute(e,t){Ee(e,t)},throwIfInternalRouteInArray(e,t){Te(e,t)},validateExistingRoutes:ne,validateForwardToConsistency:ae,validateSetRootPathArgs:je,guardRouteCallbacks:Ae,guardNoAsyncCallbacks:xe},options:{validateLimitValue(e,t){B(e,t,"validate")},validateLimits(e){H(e,"validate")},validateOptions:W},dependencies:{validateDependencyName:m,validateSetDependencyArgs(e,t,r){!function(e){if("string"!=typeof e)throw new TypeError("[router.setDependency] dependency name must be a string, got "+typeof e)}(e)},validateDependenciesObject:h,validateDependencyExists(e,t){const r=t,o=r.dependencies?.[e];!function(e,t){if(void 0===e)throw new ReferenceError(`[router.getDependency] dependency "${t}" not found`)}(o,e)},validateDependencyLimit(e,t){},validateDependenciesStructure:ie,validateDependencyCount:v,validateCloneArgs:$,warnOverwrite:b,warnBatchOverwrite:E,warnRemoveNonExistent:T},plugins:{validatePluginLimit(e,t){!function(e,t,r=50){if(0!==r&&e+t>r)throw new RangeError(`[router.usePlugin] Plugin limit exceeded (${r}). Current: ${e}, Attempting to add: ${t}. This indicates an architectural problem. Consider consolidating plugins.`)}(e,1,t?.maxPlugins)},validateNoDuplicatePlugins(e,t){},validatePluginKeys:Z,validateCountThresholds(t){!function(e,t){if(0===t)return;const{warn:o,error:n}=g(t);e>=n?r.logger.error(G,`${e} plugins registered! This is excessive. Hard limit at ${t}.`):e>=o&&r.logger.warn(G,`${e} plugins registered. Consider if all are necessary.`)}(t,e.getOptions().limits?.maxPlugins??50)},warnBatchDuplicates:Q,warnPluginMethodType:V,warnPluginAfterStart:K,validateAddInterceptorArgs:J},lifecycle:{validateHandler:R,validateNotRegistering(e,t,r){},validateHandlerLimit(e,t,r){!function(e,t,r=200){if(0!==r&&e>=r)throw new RangeError(`[router.${t}] Lifecycle handler limit exceeded (${r}). This indicates too many routes with individual handlers. Consider using plugins for cross-cutting concerns.`)}(e,r,t?.maxLifecycleHandlers)},validateCountThresholds(t,o){!function(e,t,o){if(0===o)return;const{warn:n,error:a}=g(o);e>=a?r.logger.error(`router.${t}`,`${e} lifecycle handlers registered! This is excessive. Hard limit at ${o}.`):e>=n&&r.logger.warn(`router.${t}`,`${e} lifecycle handlers registered. Consider consolidating logic.`)}(t,o,e.getOptions().limits?.maxLifecycleHandlers??200)},warnOverwrite:A,warnAsyncGuardSync:x},navigation:{validateNavigateArgs:S,validateNavigateToDefaultArgs:O,validateNavigationOptions:I,validateParams:D,validateStartArgs:k},state:{validateMakeStateArgs:Le,validateAreStatesEqualArgs(e,t,r){if(!f(e))throw new TypeError(`[router.areStatesEqual] Invalid state1: ${y(e)}. Expected State object.`);if(!f(t))throw new TypeError(`[router.areStatesEqual] Invalid state2: ${y(t)}. Expected State object.`);if(void 0!==r&&!l(r))throw new TypeError(`[router.areStatesEqual] Invalid ignoreQueryParams: ${y(r)}. Expected boolean.`)}},eventBus:{validateEventName:j,validateListenerArgs(e,t){!function(e,t){if(j(e),"function"!=typeof t)throw new TypeError("[router.addEventListener] callback must be a function, got "+typeof t)}(e,t)}}}}exports.validationPlugin=function(){return r=>{const o=t.getInternals(r);if(r.isActive())throw new e.RouterError("VALIDATION_PLUGIN_AFTER_START",{message:"validation-plugin must be registered before router.start()"});o.validator=qe(o);try{const e=o.routeGetStore(),t=o.dependenciesGetStore(),r=o.getOptions();ne(e),ae(e),function(e){const t=X(e,"validateRoutePropertiesStore"),{config:r}=t;for(const[e,t]of Object.entries(r.decoders)){if("function"!=typeof t)throw new TypeError(`[validation-plugin] validateRoutePropertiesStore: route "${e}" decoder must be a function, got ${typeof t}`);oe(t,"decoder",e)}for(const[e,t]of Object.entries(r.encoders)){if("function"!=typeof t)throw new TypeError(`[validation-plugin] validateRoutePropertiesStore: route "${e}" encoder must be a function, got ${typeof t}`);oe(t,"encoder",e)}for(const[e,t]of Object.entries(r.defaultParams))if(null===t||"object"!=typeof t||Array.isArray(t))throw new TypeError(`[validation-plugin] validateRoutePropertiesStore: route "${e}" defaultParams must be a plain object, got ${Array.isArray(t)?"array":typeof t}`);for(const[e,t]of Object.entries(r.forwardFnMap)){if("function"!=typeof t)throw new TypeError(`[validation-plugin] validateRoutePropertiesStore: route "${e}" forwardTo callback must be a function, got ${typeof t}`);oe(t,"forwardTo callback",e)}}(e),function(e){const t=X(e,"validateForwardToTargetsStore"),{config:r,tree:o}=t;for(const[e,t]of Object.entries(r.forwardMap))if(!ee(o,t))throw new Error(`[validation-plugin] validateForwardToTargetsStore: forwardTo target "${t}" does not exist for route "${e}"`)}(e),ie(t),function(e,t,r){const o=function(e){const t=e&&"object"==typeof e?e:{};return t.limits&&"object"==typeof t.limits?t.limits:{}}(e);!function(e,t){if(!e||"object"!=typeof e)return;const r=e;if(!Array.isArray(r.definitions))return;const o=r.definitions.length,n=t.maxRoutes;if("number"==typeof n&&n>0&&o>n)throw new RangeError(`[validation-plugin] validateLimitsConsistency: route count (${o}) exceeds configured limit (${n})`)}(t,o),function(e,t){if(!e||"object"!=typeof e)return;const r=e.dependencies,o=e.limits;if(!r||"object"!=typeof r||!o||"object"!=typeof o)return;const n=Object.keys(r).length,a=t.maxDependencies,i="number"==typeof a?a:o.maxDependencies;if("number"==typeof i&&i>0&&n>=i)throw new RangeError(`[validation-plugin] validateLimitsConsistency: dependency count (${n}) reaches or exceeds maxDependencies limit (${i})`)}(r,o)}(r,e,t),o.validator.options.validateOptions(r,"constructor (retrospective)")}catch(e){throw o.validator=null,e}return{teardown(){o.validator=null}}}};//# sourceMappingURL=index.js.map
|
|
1
|
+
var e=require("@real-router/core"),t=require("@real-router/core/validation"),r=require("@real-router/logger"),o=["replace","reload","force","forceDeactivate","redirected"],n=/\S/,a=/^[A-Z_a-z][\w-]*(?:\.[A-Z_a-z][\w-]*)*$/;function i(e,t){return new TypeError(`[router.${e}] ${t}`)}function c(e,t=new WeakSet){if(null==e)return!0;const r=typeof e;if("string"===r||"boolean"===r)return!0;if("number"===r)return Number.isFinite(e);if("function"===r||"symbol"===r)return!1;if(Array.isArray(e))return!t.has(e)&&(t.add(e),e.every(e=>c(e,t)));if("object"===r){if(t.has(e))return!1;t.add(e);const r=Object.getPrototypeOf(e);return(null===r||r===Object.prototype)&&Object.values(e).every(e=>c(e,t))}return!1}function s(e){if(null==e)return!0;const t=typeof e;return"string"===t||"boolean"===t||"number"===t&&Number.isFinite(e)}function u(e){if("object"!=typeof e||null===e||Array.isArray(e))return!1;const t=Object.getPrototypeOf(e);if(null!==t&&t!==Object.prototype)return!1;let r=!1;for(const t in e){if(!Object.hasOwn(e,t))continue;const o=e[t];if(!s(o)){const e=typeof o;if("function"===e||"symbol"===e)return!1;r=!0;break}}return!r||c(e)}function f(e){return"object"==typeof e&&null!==e&&function(e){return function(e){return"string"==typeof e&&(""===e||!(e.length>1e4)&&(!!e.startsWith("@@")||a.test(e)))}(e.name)&&"string"==typeof e.path&&u(e.params)}(e)}function d(e){return"string"==typeof e}function l(e){return"boolean"==typeof e}function p(e,t){return e in t}function w(e,t){if("string"!=typeof e)throw i(t,"Route name must be a string, got "+typeof e);if(""!==e){if(!n.test(e))throw i(t,"Route name cannot contain only whitespace");if(e.length>1e4)throw i(t,"Route name exceeds maximum length of 10000 characters. This is a technical safety limit.");if(!e.startsWith("@@")&&!a.test(e))throw i(t,`Invalid route name "${e}". Each segment must start with a letter or underscore, followed by letters, numbers, underscores, or hyphens. Segments are separated by dots (e.g., "users.profile").`)}}function y(e){return null===e?"null":Array.isArray(e)?`array[${e.length}]`:"object"==typeof e?"constructor"in e&&"Object"!==e.constructor.name?e.constructor.name:"object":typeof e}function g(e){return{warn:Math.floor(.2*e),error:Math.floor(.5*e)}}function m(e,t){if("string"!=typeof e)throw new TypeError(`[router.${t}] dependency name must be a string, got ${typeof e}`)}function h(e,t){if(!e||"object"!=typeof e||e.constructor!==Object)throw new TypeError(`[router.${t}] Invalid argument: expected plain object, received ${y(e)}`);for(const r in e)if(Object.getOwnPropertyDescriptor(e,r)?.get)throw new TypeError(`[router.${t}] Getters not allowed: "${r}"`)}function v(e,t){const o=e,n=o.limits?.maxDependencies??100;if(0===n)return;const a=Object.keys(o.dependencies).length,{warn:i,error:c}=g(n);if(a>=n)throw new RangeError(`[router.${t}] Dependency limit exceeded (${n}). Current: ${a}.`);a===c?r.logger.error(`router.${t}`,`${a} dependencies registered! This indicates architectural problems. Hard limit at ${n}.`):a===i&&r.logger.warn(`router.${t}`,`${a} dependencies registered. Consider if all are necessary.`)}function $(e){if(void 0!==e){if(!e||"object"!=typeof e||e.constructor!==Object)throw new TypeError("[cloneRouter] Invalid dependencies: expected plain object or undefined, received "+typeof e);for(const t in e)if(Object.getOwnPropertyDescriptor(e,t)?.get)throw new TypeError(`[cloneRouter] Getters not allowed in dependencies: "${t}"`)}}function b(e,t){r.logger.warn(`router.${t}`,"Router dependency already exists and is being overwritten:",e)}function E(e,t){r.logger.warn(`router.${t}`,"Overwritten:",e.join(", "))}function T(e){r.logger.warn("router.removeDependency",`Attempted to remove non-existent dependency: "${"string"==typeof e?e:String(e)}"`)}var P=new Set(["$start","$stop","$$start","$$cancel","$$success","$$error"]);function j(e){if(!P.has(e))throw new TypeError(`[router.addEventListener] Invalid event name: ${String(e)}. Must be one of: $start, $stop, $$start, $$cancel, $$success, $$error`)}function R(e,t){if(!l(e)&&"function"!=typeof e)throw new TypeError(`[router.${t}] Handler must be a boolean or factory function, got ${y(e)}`)}function A(e,t,o){r.logger.warn(`router.${o}`,`Overwriting existing ${t} handler for route "${e}"`)}function x(e,t){r.logger.warn(`router.${t}`,`Guard for "${e}" returned a Promise. Sync check cannot resolve async guards — returning false.`)}function S(e){if("string"!=typeof e)throw new TypeError(`[router.navigate] Invalid route name: expected string, got ${y(e)}`)}function O(e){if(void 0!==e&&("object"!=typeof e||null===e))throw new TypeError(`[router.navigateToDefault] Invalid options: ${y(e)}. Expected NavigationOptions object.`)}function I(e,t){if(!function(e){if("object"!=typeof e||null===e||Array.isArray(e))return!1;const t=e;for(const e of o){const r=t[e];if(void 0!==r&&"boolean"!=typeof r)return!1}const r=t.signal;return!(void 0!==r&&!(r instanceof AbortSignal))}(e))throw new TypeError(`[router.${t}] Invalid options: ${y(e)}. Expected NavigationOptions object.`)}function D(e,t){if(void 0!==e&&!u(e))throw new TypeError(`[router.${t}] params must be a plain object, got ${y(e)}`)}function k(e){if(void 0!==e&&"string"!=typeof e)throw new TypeError(`[router.start] path must be a string, got ${y(e)}.`);if("string"==typeof e&&""!==e&&!e.startsWith("/"))throw new TypeError(`[router.start] path must start with "/", got "${e}".`)}var M=["strict","never","always","preserve"],N=["default","strict","loose"],F=["default","uri","uriComponent","none"],C={arrayFormat:["none","brackets","index","comma"],booleanFormat:["none","string","empty-true"],nullFormat:["default","hidden"]},L=["all","warn-error","error-only","none"],q=new Set(["defaultRoute","defaultParams","trailingSlash","queryParamsMode","queryParams","urlParamsEncoding","allowNotFound","rewritePathOnMatch","logger","limits"]),_={maxDependencies:{min:0,max:1e4},maxPlugins:{min:0,max:1e3},maxListeners:{min:0,max:1e5},warnListeners:{min:0,max:1e5},maxEventDepth:{min:0,max:100},maxLifecycleHandlers:{min:0,max:1e4}};function B(e,t,r){if("number"!=typeof t||!Number.isInteger(t))throw new TypeError(`[router.${r}] limit "${e}" must be an integer, got ${String(t)}`);const o=_[e];if(t<o.min||t>o.max)throw new RangeError(`[router.${r}] limit "${e}" must be between ${o.min} and ${o.max}, got ${t}`)}function H(e,t){if(!e||"object"!=typeof e||e.constructor!==Object)throw new TypeError(`[router.${t}] invalid limits: expected plain object, got ${typeof e}`);for(const[r,o]of Object.entries(e)){if(!Object.hasOwn(_,r))throw new TypeError(`[router.${t}] unknown limit: "${r}"`);void 0!==o&&B(r,o,t)}}function U(e,t,r,o){if(void 0!==e&&("string"!=typeof e||!r.includes(e))){const n=r.map(e=>`"${e}"`).join(", ");throw new TypeError(`[router.${o}] Invalid "${t}": "${"string"==typeof e?e:`(${typeof e})`}". Must be one of: ${n}`)}}function W(e,t){if(!e||"object"!=typeof e||Array.isArray(e))throw new TypeError(`[router.${t}] Invalid options: expected plain object`);const r=e;for(const e of Object.keys(r))if(!q.has(e))throw new TypeError(`[router.${t}] Unknown option: "${e}"`);if(function(e,t){if(void 0!==e&&"string"!=typeof e&&"function"!=typeof e)throw new TypeError(`[router.${t}] Invalid "defaultRoute": expected string or function, got ${typeof e}`)}(r.defaultRoute,t),function(e,t){if(void 0!==e&&"function"!=typeof e&&(!e||"object"!=typeof e||Array.isArray(e)||e.constructor!==Object))throw new TypeError(`[router.${t}] Invalid "defaultParams": expected plain object or function, got ${typeof e}`)}(r.defaultParams,t),U(r.trailingSlash,"trailingSlash",M,t),U(r.queryParamsMode,"queryParamsMode",N,t),U(r.urlParamsEncoding,"urlParamsEncoding",F,t),void 0!==r.allowNotFound&&"boolean"!=typeof r.allowNotFound)throw new TypeError(`[router.${t}] Invalid "allowNotFound": expected boolean, got ${typeof r.allowNotFound}`);if(void 0!==r.rewritePathOnMatch&&"boolean"!=typeof r.rewritePathOnMatch)throw new TypeError(`[router.${t}] Invalid "rewritePathOnMatch": expected boolean, got ${typeof r.rewritePathOnMatch}`);!function(e,t){if(void 0===e)return;if(!e||"object"!=typeof e||Array.isArray(e))throw new TypeError(`[router.${t}] Invalid "queryParams": expected plain object`);const r=e;for(const e of Object.keys(r)){if(!p(e,C))throw new TypeError(`[router.${t}] Invalid "queryParams.${e}": unknown option`);U(r[e],`queryParams.${e}`,C[e],t)}}(r.queryParams,t),function(e,t){if(void 0===e)return;if(!e||"object"!=typeof e||Array.isArray(e))throw new TypeError(`[router.${t}] Invalid "logger": expected plain object`);const r=e;if(void 0!==r.level&&!L.includes(r.level)){const e=L.map(e=>`"${e}"`).join(", ");throw new TypeError(`[router.${t}] Invalid "logger.level": "${"string"==typeof r.level?r.level:`(${typeof r.level})`}". Must be one of: ${e}`)}if(void 0!==r.callback&&"function"!=typeof r.callback)throw new TypeError(`[router.${t}] Invalid "logger.callback": expected function`);if(void 0!==r.callbackIgnoresLevel&&"boolean"!=typeof r.callbackIgnoresLevel)throw new TypeError(`[router.${t}] Invalid "logger.callbackIgnoresLevel": expected boolean`)}(r.logger,t),void 0!==r.limits&&H(r.limits,t)}var G="router.usePlugin",z={onStart:!0,onStop:!0,onTransitionStart:!0,onTransitionSuccess:!0,onTransitionError:!0,onTransitionCancel:!0};function Z(e){for(const t in e)if("teardown"!==t&&!(t in z))throw new TypeError(`[router.usePlugin] Unknown property '${t}'. Plugin must only contain event handlers and optional teardown.`)}function Q(){r.logger.warn(G,"Duplicate factory in batch, will be registered once")}function V(e){r.logger.warn(G,`Property '${e}' is not a function, skipping`)}function K(e){"onStart"===e&&r.logger.warn(G,"Router already started, onStart will not be called")}function J(e,t){const r=["start","buildPath","forwardState"];if("string"!=typeof e||!r.includes(e))throw new TypeError(`[router.addInterceptor] Invalid method: "${String(e)}". Must be one of: ${r.join(", ")}`);if("function"!=typeof t)throw new TypeError("[router.addInterceptor] interceptor must be a function, got "+typeof t)}function X(e,t){if(!e||"object"!=typeof e)throw new TypeError(`[validation-plugin] ${t}: store must be an object`);const r=e;if(!Array.isArray(r.definitions))throw new TypeError(`[validation-plugin] ${t}: store.definitions must be an array`);if(!r.config||"object"!=typeof r.config)throw new TypeError(`[validation-plugin] ${t}: store.config must be an object`);if(!r.tree||"object"!=typeof r.tree)throw new TypeError(`[validation-plugin] ${t}: store.tree must be an object`);return r}function Y(e,t,r=""){for(const o of e){const e=r?`${r}.${o.name}`:o.name;t(o,e),o.children&&Y(o.children,t,e)}}function ee(e,t){const r=t.split(".");let o=e;for(const e of r)if(o=o.children.get(e),!o)return!1;return!0}function te(t,r){try{return e.resolveForwardChain(t,r)}catch(e){throw new Error(`[validation-plugin] ${e.message}`,{cause:e})}}function re(e){const t=new Set;for(const r of e){for(const e of r.paramMeta.urlParams)t.add(e);for(const e of r.paramMeta.spatParams)t.add(e)}return t}function oe(e,t,r){if("AsyncFunction"===e.constructor.name||e.toString().includes("__awaiter"))throw new TypeError(`[validation-plugin] Route "${r}" ${t} cannot be async`)}function ne(e){const t=X(e,"validateExistingRoutes"),r=new Set;Y(t.definitions,(e,t)=>{if("string"!=typeof e.name||!e.name)throw new TypeError(`[validation-plugin] validateExistingRoutes: route has invalid name: ${e.name}`);if("string"!=typeof e.path)throw new TypeError(`[validation-plugin] validateExistingRoutes: route "${t}" has non-string path (${typeof e.path})`);if(r.has(t))throw new Error(`[validation-plugin] validateExistingRoutes: duplicate route name detected: "${t}"`);r.add(t)})}function ae(e){const t=X(e,"validateForwardToConsistency"),{config:r,tree:o,matcher:n}=t;for(const[e,t]of Object.entries(r.forwardMap)){if(!ee(o,t))throw new Error(`[validation-plugin] validateForwardToConsistency: forwardTo target "${t}" does not exist in tree (source route: "${e}")`);const r=n.getSegmentsByName(e),a=n.getSegmentsByName(t);if(r&&a){const o=re(r),n=[...re(a)].filter(e=>!o.has(e));if(n.length>0)throw new Error(`[validation-plugin] validateForwardToConsistency: forwardTo target "${t}" requires params [${n.join(", ")}] not available in source route "${e}"`)}}for(const e of Object.keys(r.forwardMap))te(e,r.forwardMap)}function ie(e){if(!e||"object"!=typeof e)throw new TypeError("[validation-plugin] validateDependenciesStructure: deps must be an object");const t=e;if(!t.dependencies||"object"!=typeof t.dependencies)throw new TypeError("[validation-plugin] validateDependenciesStructure: deps.dependencies must be an object");const r=t.dependencies;for(const e of Object.keys(r))if(Object.getOwnPropertyDescriptor(r,e)?.get)throw new TypeError(`[validation-plugin] validateDependenciesStructure: dependency "${e}" must not use a getter`);if(!t.limits||"object"!=typeof t.limits)throw new TypeError("[validation-plugin] validateDependenciesStructure: deps.limits must be an object");const o=t.limits,n=["maxDependencies","maxPlugins","maxListeners","warnListeners","maxEventDepth","maxLifecycleHandlers"];for(const e of n)if("number"!=typeof o[e])throw new TypeError(`[validation-plugin] validateDependenciesStructure: deps.limits.${e} must be a number, got ${typeof o[e]}`)}function ce(e,t){return new TypeError(`[router.${e}] ${t}`)}var se=/^[A-Z_a-z][\w-]*$/,ue=/\S/;function fe(e){return null===e?"null":"object"==typeof e?"constructor"in e&&"Object"!==e.constructor.name?e.constructor.name:"object":typeof e}function de(e,t){if(!t.includes("."))return e.children.get(t);let r=e;for(const e of t.split("."))if(r=r.children.get(e),!r)return;return r}function le(e,t,r,o="",n,a){!function(e,t){if(!e||"object"!=typeof e)throw new TypeError(`[router.${t}] Route must be an object, got ${fe(e)}`);const r=Object.getPrototypeOf(e);if(r!==Object.prototype&&null!==r)throw new TypeError(`[router.${t}] Route must be a plain object, got ${fe(e)}`);if(function(e){for(const t of Object.keys(e)){const r=Object.getOwnPropertyDescriptor(e,t);if(r&&(r.get||r.set))return!0}return!1}(e))throw new TypeError(`[router.${t}] Route must not have getters or setters`)}(e,t);const i=e;!function(e,t){if("string"!=typeof e.name)throw new TypeError(`[router.${t}] Route name must be a string, got ${fe(e.name)}`);const r=e.name;if(""===r)throw new TypeError(`[router.${t}] Route name cannot be empty`);if(!ue.test(r))throw new TypeError(`[router.${t}] Route name cannot contain only whitespace`);if(r.length>1e4)throw new TypeError(`[router.${t}] Route name exceeds maximum length of 10000 characters`);if(!r.startsWith("@@")){if(r.includes("."))throw new TypeError(`[router.${t}] Route name "${r}" cannot contain dots. Use children array or { parent } option in addRoute() instead.`);if(!se.test(r))throw new TypeError(`[router.${t}] Invalid route name "${r}". Name must start with a letter or underscore, followed by letters, numbers, underscores, or hyphens.`)}}(i,t),function(e,t,r,o){if("string"!=typeof e){let t;throw t=null===e?"null":Array.isArray(e)?"array":typeof e,ce(r,`Route path must be a string, got ${t}`)}if(""===e)return;if(/\s/.test(e))throw ce(r,`Invalid path for route "${t}": whitespace not allowed in "${e}"`);if(!/^([/?~]|[^/]+$)/.test(e))throw ce(r,`Route "${t}" has invalid path format: "${e}". Path should start with '/', '~', '?' or be a relative segment.`);if(e.includes("//"))throw ce(r,`Invalid path for route "${t}": double slashes not allowed in "${e}"`);const n=o&&Object.values(o.paramTypeMap).includes("url");if(e.startsWith("~")&&n)throw ce(r,`Absolute path "${e}" cannot be used under parent route with URL parameters`)}(i.path,i.name,t,r),function(e,t){if(void 0!==e.encodeParams&&"function"!=typeof e.encodeParams)throw new TypeError(`[router.${t}] Route "${String(e.name)}" encodeParams must be a function`)}(i,t),function(e,t){if(void 0!==e.decodeParams&&"function"!=typeof e.decodeParams)throw new TypeError(`[router.${t}] Route "${String(e.name)}" decodeParams must be a function`)}(i,t);const c=i.name,s=o?`${o}.${c}`:c;r&&s&&function(e,t,r){if(de(e,t))throw new Error(`[router.${r}] Route "${t}" already exists`)}(r,s,t),n&&function(e,t,r){if(e.has(t))throw new Error(`[router.${r}] Duplicate route "${t}" in batch`);e.add(t)}(n,s,t);const u=i.path,f=o;if(r&&function(e,t,r,o){const n=""===t?e:de(e,t);if(n)for(const e of n.children.values())if(e.path===r)throw new Error(`[router.${o}] Path "${r}" is already defined`)}(r,f,u,t),a&&function(e,t,r,o){const n=e.get(t);if(n?.has(r))throw new Error(`[router.${o}] Path "${r}" is already defined`);n?n.add(r):e.set(t,new Set([r]))}(a,f,u,t),void 0!==i.children){if(!Array.isArray(i.children))throw new TypeError(`[router.${t}] Route "${c}" children must be an array, got ${fe(i.children)}`);for(const e of i.children)le(e,t,r,s,n,a)}}function pe(e,t){if(void 0!==e.canActivate&&"function"!=typeof e.canActivate)throw new TypeError(`[router.addRoute] canActivate must be a function for route "${t}", got ${y(e.canActivate)}`);if(void 0!==e.canDeactivate&&"function"!=typeof e.canDeactivate)throw new TypeError(`[router.addRoute] canDeactivate must be a function for route "${t}", got ${y(e.canDeactivate)}`);if(void 0!==e.defaultParams){const r=e.defaultParams;if(null===r||"object"!=typeof r||Array.isArray(r))throw new TypeError(`[router.addRoute] defaultParams must be an object for route "${t}", got ${y(e.defaultParams)}`)}if("AsyncFunction"===e.decodeParams?.constructor.name)throw new TypeError(`[router.addRoute] decodeParams cannot be async for route "${t}". Async functions break matchPath/buildPath.`);if("AsyncFunction"===e.encodeParams?.constructor.name)throw new TypeError(`[router.addRoute] encodeParams cannot be async for route "${t}". Async functions break matchPath/buildPath.`);if(function(e,t){if(void 0!==e&&"function"==typeof e){const r="AsyncFunction"===e.constructor.name,o=e.toString().includes("__awaiter");if(r||o)throw new TypeError(`[router.addRoute] forwardTo callback cannot be async for route "${t}". Async functions break matchPath/buildPath.`)}}(e.forwardTo,t),e.children)for(const r of e.children)pe(r,`${t}.${r.name}`)}function we(e){const t=new Set,r=/[*:]([A-Z_a-z]\w*)/g;let o;for(;null!==(o=r.exec(e));)t.add(o[1]);return t}function ye(e){const t=new Set;for(const r of e)for(const e of we(r))t.add(e);return t}function ge(e,t,r="",o=[]){for(const n of e){const e=r?`${r}.${n.name}`:n.name,a=[...o,n.path];if(e===t)return a;if(n.children&&t.startsWith(`${e}.`))return ge(n.children,t,e,a)}throw new Error(`[internal] collectPathsToRoute: route "${t}" not found`)}function me(e,t=""){const r=new Set;for(const o of e){const e=t?`${t}.${o.name}`:o.name;if(r.add(e),o.children)for(const t of me(o.children,e))r.add(t)}return r}function he(e,t=""){const r=new Map;for(const o of e){const e=t?`${t}.${o.name}`:o.name;if(o.forwardTo&&"string"==typeof o.forwardTo&&r.set(e,o.forwardTo),o.children)for(const[t,n]of he(o.children,e))r.set(t,n)}return r}function ve(e,t,r,o){return t?function(e){const t=new Set;for(const r of e){for(const e of r.paramMeta.urlParams)t.add(e);for(const e of r.paramMeta.spatParams)t.add(e)}return t}(function(e,t){const r=[],o=t.includes(".")?t.split("."):[t];""!==e.path&&r.push(e);let n=e;for(const e of o){const t=n.children.get(e);if(!t)return null;r.push(t),n=t}return r}(r,e)??[]):ye(ge(o,e))}function $e(e,t,r,o,n){const a=function(e,t){const r=t.split(".");let o=e;for(const e of r)if(o=o.children.get(e),!o)return!1;return!0}(n,t),i=o.has(t);if(!a&&!i)throw new ReferenceError(`[router.addRoute] forwardTo target "${t}" does not exist for route "${e}"`);const c=ye(ge(r,e)),s=[...ve(t,a,n,r)].filter(e=>!c.has(e));if(s.length>0)throw new Error(`[router.addRoute] forwardTo target "${t}" requires params [${s.join(", ")}] that are not available in source route "${e}"`)}function be(t,r,o){const n=me(t),a=he(t),i={...r};for(const[e,t]of a)i[e]=t;for(const[e,r]of a)$e(e,r,t,n,o);for(const t of Object.keys(i))e.resolveForwardChain(t,i)}function Ee(e,t){if(e.startsWith("@@"))throw new Error(`[router.${t}] Route name "${e}" uses the reserved "@@" prefix. Routes with this prefix are internal and cannot be modified through the public API.`)}function Te(e,t){for(const r of e)r&&"object"==typeof r&&"string"==typeof r.name&&(Ee(r.name,t),r.children&&Te(r.children,t))}function Pe(e){w(e,"removeRoute")}function je(e){if("string"!=typeof e)throw new TypeError(`[router.setRootPath] rootPath must be a string, got ${y(e)}`)}function Re(e){return"AsyncFunction"===e.constructor.name||String(e).includes("__awaiter")}function Ae(e){const t=e;if(void 0!==t.canActivate&&"function"!=typeof t.canActivate)throw new TypeError(`[router.addRoute] canActivate must be a function, got ${y(t.canActivate)}`);if(void 0!==t.canDeactivate&&"function"!=typeof t.canDeactivate)throw new TypeError(`[router.addRoute] canDeactivate must be a function, got ${y(t.canDeactivate)}`)}function xe(e){const t=e,r=t.name;if(void 0!==t.decodeParams&&Re(t.decodeParams))throw new TypeError(`[router.addRoute] decodeParams cannot be async for route "${String(r)}"`);if(void 0!==t.encodeParams&&Re(t.encodeParams))throw new TypeError(`[router.addRoute] encodeParams cannot be async for route "${String(r)}"`);if("function"==typeof t.forwardTo&&Re(t.forwardTo))throw new TypeError(`[router.addRoute] forwardTo callback cannot be async for route "${String(r)}"`)}function Se(e,t,r,o){if(!d(e))throw new TypeError("[router.isActiveRoute] name must be a string, got "+typeof e);if(void 0!==t&&!u(t))throw new TypeError(`[router.isActiveRoute] params must be a plain object, got ${y(t)}`);if(void 0!==r&&"boolean"!=typeof r)throw new TypeError("[router.isActiveRoute] strictEquality must be a boolean, got "+typeof r);if(void 0!==o&&"boolean"!=typeof o)throw new TypeError("[router.isActiveRoute] ignoreQueryParams must be a boolean, got "+typeof o)}function Oe(e,t,r){if(!d(e))throw new TypeError(`[router.${r}] Invalid routeName: ${y(e)}. Expected string.`);if(!u(t))throw new TypeError(`[router.${r}] Invalid routeParams: ${y(t)}. Expected plain object.`)}function Ie(e,t){if(w(e,"updateRoute"),""===e)throw new ReferenceError("[router.updateRoute] Invalid name: empty string. Cannot update root node.");if(null===t)throw new TypeError("[router.updateRoute] updates must be an object, got null");if("object"!=typeof t||Array.isArray(t))throw new TypeError(`[router.updateRoute] updates must be an object, got ${y(t)}`)}function De(e,t){if("AsyncFunction"===e.constructor.name||e.toString().includes("__awaiter"))throw new TypeError(`[router.updateRoute] ${t} cannot be an async function`)}function ke(e,t){if(null!=e){if("function"!=typeof e)throw new TypeError(`[router.updateRoute] ${t} must be a function or null, got ${typeof e}`);De(e,t)}}function Me(e){if(!d(e)||""===e)throw new TypeError("[router.buildPath] route must be a non-empty string, got "+("string"==typeof e?'""':typeof e))}function Ne(e){if(!d(e))throw new TypeError("[router.matchPath] path must be a string, got "+typeof e)}function Fe(e){if(!d(e))throw new TypeError("[router.shouldUpdateNode] nodeName must be a string, got "+typeof e)}function Ce(t,r,o,n,a){if(!o(t))throw new ReferenceError(`[router.updateRoute] route "${t}" does not exist`);if(null!=r&&"string"==typeof r){if(!o(r))throw new Error(`[router.updateRoute] forwardTo target "${r}" does not exist`);(function(e,t,r){const o=r.getSegmentsByName(e),n=r.getSegmentsByName(t),a=function(e){const t=new Set;for(const r of e)for(const e of r.paramMeta.urlParams)t.add(e);return t}(o),i=[];for(const e of n)for(const t of e.paramMeta.urlParams)i.push(t);const c=i.filter(e=>!a.has(e));if(c.length>0)throw new Error(`[router.addRoute] forwardTo target "${t}" requires params [${c.join(", ")}] that are not available in source route "${e}"`)})(t,r,n),function(t,r,o){const n={...o.forwardMap,[t]:r};e.resolveForwardChain(t,n)}(t,r,a)}}function Le(e,t,r){if(!d(e))throw new TypeError(`[router.makeState] Invalid name: ${y(e)}. Expected string.`);if(void 0!==t&&!u(t))throw new TypeError(`[router.makeState] Invalid params: ${y(t)}. Expected plain object.`);if(void 0!==r&&!d(r))throw new TypeError(`[router.makeState] Invalid path: ${y(r)}. Expected string.`)}function qe(e){return{routes:{validateBuildPathArgs:Me,validateMatchPathArgs:Ne,validateIsActiveRouteArgs:Se,validateShouldUpdateNodeArgs:Fe,validateStateBuilderArgs:Oe,validateAddRouteArgs(e){!function(e){for(const t of e){if(null===t||"object"!=typeof t||Array.isArray(t))throw new TypeError(`[router.addRoute] Route must be an object, got ${y(t)}`);pe(t,t.name)}}(e)},validateRoutes(e,t){const r=t;!function(e,t,r){const o=new Set,n=new Map;for(const r of e)le(r,"addRoute",t,"",o,n);t&&r&&be(e,r,t)}(e,r.tree,r.config?.forwardMap)},validateRemoveRouteArgs:Pe,validateUpdateRouteBasicArgs:Ie,validateUpdateRoutePropertyTypes(e,t){!function(e,t,r,o){if(null!=e){if("string"!=typeof e&&"function"!=typeof e)throw new TypeError(`[router.updateRoute] forwardTo must be a string, function, or null, got ${y(e)}`);"function"==typeof e&&De(e,"forwardTo callback")}if(null!=t&&("object"!=typeof t||Array.isArray(t)))throw new TypeError(`[router.updateRoute] defaultParams must be an object or null, got ${y(t)}`);ke(r,"decodeParams"),ke(o,"encodeParams")}(t.forwardTo,t.defaultParams,t.decodeParams,t.encodeParams)},validateUpdateRoute(e,t,r){const o=r;Ce(e,t.forwardTo,e=>o.matcher.hasRoute(e),o.matcher,o.config)},validateParentOption(e,t){!function(e){if("string"!=typeof e||""===e)throw new TypeError(`[router.addRoute] parent option must be a non-empty string, got ${y(e)}`);w(e,"addRoute")}(e);let r=t;for(const t of e.split(".")){const o=r.children.get(t);if(!o)throw new ReferenceError(`[router.addRoute] Parent route "${e}" does not exist`);r=o}},validateRouteName(e,t){w(e,t)},throwIfInternalRoute(e,t){Ee(e,t)},throwIfInternalRouteInArray(e,t){Te(e,t)},validateExistingRoutes:ne,validateForwardToConsistency:ae,validateSetRootPathArgs:je,guardRouteCallbacks:Ae,guardNoAsyncCallbacks:xe},options:{validateLimitValue(e,t){B(e,t,"validate")},validateLimits(e){H(e,"validate")},validateOptions:W},dependencies:{validateDependencyName:m,validateSetDependencyArgs(e,t,r){!function(e){if("string"!=typeof e)throw new TypeError("[router.setDependency] dependency name must be a string, got "+typeof e)}(e)},validateDependenciesObject:h,validateDependencyExists(e,t){const r=t,o=r.dependencies?.[e];!function(e,t){if(void 0===e)throw new ReferenceError(`[router.getDependency] dependency "${t}" not found`)}(o,e)},validateDependencyLimit(e,t){},validateDependenciesStructure:ie,validateDependencyCount:v,validateCloneArgs:$,warnOverwrite:b,warnBatchOverwrite:E,warnRemoveNonExistent:T},plugins:{validatePluginLimit(e,t){!function(e,t,r=50){if(0!==r&&e+t>r)throw new RangeError(`[router.usePlugin] Plugin limit exceeded (${r}). Current: ${e}, Attempting to add: ${t}. This indicates an architectural problem. Consider consolidating plugins.`)}(e,1,t?.maxPlugins)},validateNoDuplicatePlugins(e,t){},validatePluginKeys:Z,validateCountThresholds(t){!function(e,t){if(0===t)return;const{warn:o,error:n}=g(t);e>=n?r.logger.error(G,`${e} plugins registered! This is excessive. Hard limit at ${t}.`):e>=o&&r.logger.warn(G,`${e} plugins registered. Consider if all are necessary.`)}(t,e.getOptions().limits?.maxPlugins??50)},warnBatchDuplicates:Q,warnPluginMethodType:V,warnPluginAfterStart:K,validateAddInterceptorArgs:J},lifecycle:{validateHandler:R,validateNotRegistering(e,t,r){},validateHandlerLimit(e,t,r){!function(e,t,r=200){if(0!==r&&e>=r)throw new RangeError(`[router.${t}] Lifecycle handler limit exceeded (${r}). This indicates too many routes with individual handlers. Consider using plugins for cross-cutting concerns.`)}(e,r,t?.maxLifecycleHandlers)},validateCountThresholds(t,o){!function(e,t,o){if(0===o)return;const{warn:n,error:a}=g(o);e>=a?r.logger.error(`router.${t}`,`${e} lifecycle handlers registered! This is excessive. Hard limit at ${o}.`):e>=n&&r.logger.warn(`router.${t}`,`${e} lifecycle handlers registered. Consider consolidating logic.`)}(t,o,e.getOptions().limits?.maxLifecycleHandlers??200)},warnOverwrite:A,warnAsyncGuardSync:x},navigation:{validateNavigateArgs:S,validateNavigateToDefaultArgs:O,validateNavigationOptions:I,validateParams:D,validateStartArgs:k},state:{validateMakeStateArgs:Le,validateAreStatesEqualArgs(e,t,r){if(!f(e))throw new TypeError(`[router.areStatesEqual] Invalid state1: ${y(e)}. Expected State object.`);if(!f(t))throw new TypeError(`[router.areStatesEqual] Invalid state2: ${y(t)}. Expected State object.`);if(void 0!==r&&!l(r))throw new TypeError(`[router.areStatesEqual] Invalid ignoreQueryParams: ${y(r)}. Expected boolean.`)}},eventBus:{validateEventName:j,validateListenerArgs(e,t){!function(e,t){if(j(e),"function"!=typeof t)throw new TypeError("[router.addEventListener] callback must be a function, got "+typeof t)}(e,t)}}}}exports.validationPlugin=function(){return r=>{const o=t.getInternals(r);if(r.isActive())throw new e.RouterError("VALIDATION_PLUGIN_AFTER_START",{message:"validation-plugin must be registered before router.start()"});o.validator=qe(o);try{const e=o.routeGetStore(),t=o.dependenciesGetStore(),r=o.getOptions();ne(e),ae(e),function(e){const t=X(e,"validateRoutePropertiesStore"),{config:r}=t;for(const[e,t]of Object.entries(r.decoders)){if("function"!=typeof t)throw new TypeError(`[validation-plugin] validateRoutePropertiesStore: route "${e}" decoder must be a function, got ${typeof t}`);oe(t,"decoder",e)}for(const[e,t]of Object.entries(r.encoders)){if("function"!=typeof t)throw new TypeError(`[validation-plugin] validateRoutePropertiesStore: route "${e}" encoder must be a function, got ${typeof t}`);oe(t,"encoder",e)}for(const[e,t]of Object.entries(r.defaultParams))if(null===t||"object"!=typeof t||Array.isArray(t))throw new TypeError(`[validation-plugin] validateRoutePropertiesStore: route "${e}" defaultParams must be a plain object, got ${Array.isArray(t)?"array":typeof t}`);for(const[e,t]of Object.entries(r.forwardFnMap)){if("function"!=typeof t)throw new TypeError(`[validation-plugin] validateRoutePropertiesStore: route "${e}" forwardTo callback must be a function, got ${typeof t}`);oe(t,"forwardTo callback",e)}}(e),function(e){const t=X(e,"validateForwardToTargetsStore"),{config:r,tree:o}=t;for(const[e,t]of Object.entries(r.forwardMap))if(!ee(o,t))throw new Error(`[validation-plugin] validateForwardToTargetsStore: forwardTo target "${t}" does not exist for route "${e}"`)}(e),ie(t),function(e,t,r){const o=function(e){const t=e&&"object"==typeof e?e:{};return t.limits&&"object"==typeof t.limits?t.limits:{}}(e);!function(e,t){if(!e||"object"!=typeof e)return;const r=e;if(!Array.isArray(r.definitions))return;const o=r.definitions.length,n=t.maxRoutes;if("number"==typeof n&&n>0&&o>n)throw new RangeError(`[validation-plugin] validateLimitsConsistency: route count (${o}) exceeds configured limit (${n})`)}(t,o),function(e,t){if(!e||"object"!=typeof e)return;const r=e.dependencies,o=e.limits;if(!r||"object"!=typeof r||!o||"object"!=typeof o)return;const n=Object.keys(r).length,a=t.maxDependencies,i="number"==typeof a?a:o.maxDependencies;if("number"==typeof i&&i>0&&n>=i)throw new RangeError(`[validation-plugin] validateLimitsConsistency: dependency count (${n}) reaches or exceeds maxDependencies limit (${i})`)}(r,o)}(r,e,t),o.validator.options.validateOptions(r,"constructor (retrospective)")}catch(e){throw o.validator=null,e}return{teardown(){o.validator=null}}}};//# sourceMappingURL=index.js.map
|