@real-router/validation-plugin 0.11.0 → 0.12.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (7) hide show
  1. package/dist/cjs/index.d.ts.map +1 -1
  2. package/dist/cjs/index.js +1 -1
  3. package/dist/cjs/index.js.map +1 -1
  4. package/dist/esm/index.d.mts.map +1 -1
  5. package/dist/esm/index.mjs +1 -1
  6. package/dist/esm/index.mjs.map +1 -1
  7. package/package.json +5 -4
package/dist/esm/index.mjs CHANGED
@@ -1,2 +1,2 @@
1
- import{RouterError as e,resolveForwardChain as t}from"@real-router/core";import{getInternals as n,validateRoute as r}from"@real-router/core/validation";import{logger as i}from"@real-router/logger";const a=[`replace`,`reload`,`force`,`forceDeactivate`,`redirected`];function o(e){if(typeof e!=`object`||!e||Array.isArray(e))return!1;let t=e;for(let e of a){let n=t[e];if(n!==void 0&&typeof n!=`boolean`)return!1}let n=t.signal;return!(n!==void 0&&!(n instanceof AbortSignal))}const s=/\S/,c=/^[A-Z_a-z][\w-]*(?:\.[A-Z_a-z][\w-]*)*$/;function l(e,t){return TypeError(`[router.${e}] ${t}`)}function ee(e){return typeof e==`string`?e===``?!0:e.length>1e4?!1:e.startsWith(`@@`)?!0:c.test(e):!1}function u(e){if(Array.isArray(e))return!0;let t=Object.getPrototypeOf(e);return t===null||t===Object.prototype}function te(e,t){let n=Array.isArray(e)?e:Object.values(e);for(let e of n)t.push(e)}function ne(e){let t=typeof e;return t===`string`||t===`boolean`?!0:t===`number`?Number.isFinite(e):!1}var d=class{container;constructor(e){this.container=e}};function re(e,t,n,r){return n.has(e)?!1:r.has(e)?!0:u(e)?(n.add(e),t.push(new d(e)),te(e,t),!0):!1}function ie(e){let t=[e],n=new WeakSet,r=new WeakSet;for(;t.length>0;){let e=t.pop();if(e instanceof d){n.delete(e.container),r.add(e.container);continue}if(e!=null){if(typeof e==`object`){if(!re(e,t,n,r))return!1;continue}if(!ne(e))return!1}}return!0}function ae(e){if(e==null)return!0;let t=typeof e;return t===`string`||t===`boolean`?!0:t===`number`?Number.isFinite(e):!1}function f(e){try{return p(e)}catch{return!1}}function p(e){if(typeof e!=`object`||!e||Array.isArray(e))return!1;let t=Object.getPrototypeOf(e);if(t!==null&&t!==Object.prototype)return!1;let n=!1;for(let t in e){if(!Object.hasOwn(e,t))continue;let r=e[t];if(!ae(r)){let e=typeof r;if(e===`function`||e===`symbol`)return!1;n=!0;break}}return n?ie(e):!0}function m(e){return ee(e.name)&&typeof e.path==`string`&&f(e.params)}function h(e){return typeof e!=`object`||!e?!1:m(e)}function g(e){return typeof e==`string`}function _(e){return typeof e==`boolean`}function oe(e,t){return e in t}function v(e,t){if(typeof e!=`string`)throw l(t,`Route name must be a string, got ${typeof e}`);if(e!==``){if(!s.test(e))throw l(t,`Route name cannot contain only whitespace`);if(e.length>1e4)throw l(t,`Route name exceeds maximum length of 10000 characters. This is a technical safety limit.`);if(!e.startsWith(`@@`)&&!c.test(e))throw l(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){if(e===null)return`null`;if(Array.isArray(e))return`array[${e.length}]`;if(typeof e==`object`){try{let t=e.constructor;if(typeof t==`function`&&t.name!==`Object`)return t.name||`object`}catch{}return`object`}return typeof e}function b(e){return{warn:Math.floor(e*.2),error:Math.floor(e*.5)}}function se(e,t){if(typeof e!=`string`)throw TypeError(`[router.${t}] dependency name must be a string, got ${typeof e}`)}function ce(e){if(typeof e!=`string`)throw TypeError(`[router.setDependency] dependency name must be a string, got ${typeof e}`)}function le(e,t){if(!(e&&typeof e==`object`&&e.constructor===Object))throw TypeError(`[router.${t}] Invalid argument: expected plain object, received ${y(e)}`);for(let n in e)if(Object.getOwnPropertyDescriptor(e,n)?.get)throw TypeError(`[router.${t}] Getters not allowed: "${n}"`)}function ue(e,t){if(e===void 0)throw ReferenceError(`[router.getDependency] dependency "${t}" not found`)}function de(e,t){let n=e,r=n.limits?.maxDependencies??100;if(r===0)return;let a=Object.keys(n.dependencies).length,{warn:o,error:s}=b(r);if(a>=r)throw RangeError(`[router.${t}] Dependency limit exceeded (${r}). Current: ${a}.`);a===s?i.error(`router.${t}`,`${a} dependencies registered! This indicates architectural problems. Hard limit at ${r}.`):a===o&&i.warn(`router.${t}`,`${a} dependencies registered. Consider if all are necessary.`)}function fe(e){if(e!==void 0){if(!(e&&typeof e==`object`&&e.constructor===Object))throw TypeError(`[cloneRouter] Invalid dependencies: expected plain object or undefined, received ${typeof e}`);for(let t in e)if(Object.getOwnPropertyDescriptor(e,t)?.get)throw TypeError(`[cloneRouter] Getters not allowed in dependencies: "${t}"`)}}function pe(e,t){i.warn(`router.${t}`,`Router dependency already exists and is being overwritten:`,e)}function me(e,t){i.warn(`router.${t}`,`Overwritten:`,e.join(`, `))}function he(e){i.warn(`router.removeDependency`,`Attempted to remove non-existent dependency: "${typeof e==`string`?e:String(e)}"`)}const ge=new Set([`$start`,`$stop`,`$$start`,`$$leaveApprove`,`$$cancel`,`$$success`,`$$error`]);function _e(e){if(!ge.has(e))throw TypeError(`[router.addEventListener] Invalid event name: ${String(e)}. Must be one of: $start, $stop, $$start, $$leaveApprove, $$cancel, $$success, $$error`)}function ve(e,t){if(_e(e),typeof t!=`function`)throw TypeError(`[router.addEventListener] callback must be a function, got ${typeof t}`)}function ye(e,t){if(!_(e)&&typeof e!=`function`)throw TypeError(`[router.${t}] Handler must be a boolean or factory function, got ${y(e)}`)}function be(e,t,n=200){if(n!==0&&e>=n)throw RangeError(`[router.${t}] Lifecycle handler limit exceeded (${n}). This indicates too many routes with individual handlers. Consider using plugins for cross-cutting concerns.`)}function xe(e,t,n){if(n===0)return;let{warn:r,error:a}=b(n);e>=a?i.error(`router.${t}`,`${e} lifecycle handlers registered! This is excessive. Hard limit at ${n}.`):e>=r&&i.warn(`router.${t}`,`${e} lifecycle handlers registered. Consider consolidating logic.`)}function x(e,t,n){i.warn(`router.${n}`,`Overwriting existing ${t} handler for route "${e}"`)}function S(e,t){i.warn(`router.${t}`,`Guard for "${e}" returned a Promise. Sync check cannot resolve async guards — returning false.`)}function C(e){if(typeof e!=`string`)throw TypeError(`[router.navigate] Invalid route name: expected string, got ${y(e)}`)}function w(e){if(e!==void 0&&(typeof e!=`object`||!e))throw TypeError(`[router.navigateToDefault] Invalid options: ${y(e)}. Expected NavigationOptions object.`)}function T(e){if(typeof e!=`object`||!e)throw TypeError(`[router.navigateToState] Invalid state: ${y(e)}. Expected State object.`);let t=e;if(!g(t.name))throw TypeError(`[router.navigateToState] Invalid state.name: ${y(t.name)}. Expected string.`);if(!f(t.params))throw TypeError(`[router.navigateToState] Invalid state.params: ${y(t.params)}. Expected plain object.`);if(!g(t.path))throw TypeError(`[router.navigateToState] Invalid state.path: ${y(t.path)}. Expected string.`)}function E(e,t){if(!o(e))throw TypeError(`[router.${t}] Invalid options: ${y(e)}. Expected NavigationOptions object.`)}const D=/[\u0000-\u001F\u007F]/;function O(e,t){for(let n in e){if(!Object.hasOwn(e,n))continue;let r=e[n],i=typeof r;if(i===`symbol`||i===`bigint`)throw TypeError(`[router.${t}] param "${n}" cannot be a ${i} — it does not round-trip through the URL path. Use a string, number, or boolean.`);if(i===`string`&&D.test(r))throw TypeError(`[router.${t}] param "${n}" must not contain control characters (NUL / C0 / DEL) — they corrupt the URL path.`)}}function k(e,t){if(e!==void 0&&(typeof e==`object`&&e&&!Array.isArray(e)&&O(e,t),!f(e)))throw TypeError(`[router.${t}] params must be a plain object, got ${y(e)}`)}function A(e){if(e!==void 0&&typeof e!=`string`)throw TypeError(`[router.start] path must be a string, got ${y(e)}.`);if(typeof e==`string`){if(D.test(e))throw TypeError(`[router.start] path must not contain control characters (NUL / C0 / DEL).`);if(e!==``&&!e.startsWith(`/`))throw TypeError(`[router.start] path must start with "/", got "${e}".`)}}const j={trailingSlash:[`strict`,`never`,`always`,`preserve`],queryParamsMode:[`default`,`strict`,`loose`],urlParamsEncoding:[`default`,`uri`,`uriComponent`,`none`]},M={arrayFormat:[`none`,`brackets`,`index`,`comma`],booleanFormat:[`none`,`auto`,`empty-true`],nullFormat:[`default`,`hidden`],numberFormat:[`none`,`auto`]},Se=new Set([`defaultRoute`,`defaultParams`,`trailingSlash`,`caseSensitive`,`queryParamsMode`,`queryParams`,`urlParamsEncoding`,`allowNotFound`,`rewritePathOnMatch`,`logger`,`limits`]),N={maxDependencies:{min:0,max:1e4},maxPlugins:{min:0,max:1e3},maxListeners:{min:0,max:1e5},warnListeners:{min:0,max:1e5},maxLifecycleHandlers:{min:0,max:1e4}};function Ce(e,t,n){if(typeof t!=`number`||!Number.isInteger(t))throw TypeError(`[router.${n}] limit "${e}" must be an integer, got ${String(t)}`);let r=N[e];if(t<r.min||t>r.max)throw RangeError(`[router.${n}] limit "${e}" must be between ${r.min} and ${r.max}, got ${t}`)}function we(e,t){if(!e||typeof e!=`object`||e.constructor!==Object)throw TypeError(`[router.${t}] invalid limits: expected plain object, got ${typeof e}`);for(let[n,r]of Object.entries(e)){if(!Object.hasOwn(N,n))throw TypeError(`[router.${t}] unknown limit: "${n}"`);r!==void 0&&Ce(n,r,t)}let{warnListeners:n,maxListeners:r}=e;if(typeof n==`number`&&typeof r==`number`&&r>0&&n>r)throw RangeError(`[router.${t}] "limits.warnListeners" (${n}) must not exceed "limits.maxListeners" (${r}) — the warning channel would be unreachable`)}function P(e,t,n,r){if(e!==void 0&&(typeof e!=`string`||!n.includes(e))){let i=n.map(e=>`"${e}"`).join(`, `);throw TypeError(`[router.${r}] Invalid "${t}": "${typeof e==`string`?e:`(${typeof e})`}". Must be one of: ${i}`)}}function Te(e,t){if(e!==void 0&&typeof e!=`string`&&typeof e!=`function`)throw TypeError(`[router.${t}] Invalid "defaultRoute": expected string or function, got ${typeof e}`)}function Ee(e,t){if(e!==void 0&&typeof e!=`function`&&(!e||typeof e!=`object`||Array.isArray(e)||e.constructor!==Object))throw TypeError(`[router.${t}] Invalid "defaultParams": expected plain object or function, got ${typeof e}`)}function De(e,t){if(e===void 0)return;if(!e||typeof e!=`object`||Array.isArray(e))throw TypeError(`[router.${t}] Invalid "queryParams": expected plain object`);let n=e;for(let[e,r]of Object.entries(n)){if(!oe(e,M))throw TypeError(`[router.${t}] Invalid "queryParams.${e}": unknown option`);P(r,`queryParams.${e}`,M[e],t)}}function Oe(e,t){if(!e||typeof e!=`object`||Array.isArray(e))throw TypeError(`[router.${t}] Invalid options: expected plain object`);let n=e;for(let e of Object.keys(n))if(!Se.has(e))throw TypeError(`[router.${t}] Unknown option: "${e}"`);if(Te(n.defaultRoute,t),Ee(n.defaultParams,t),P(n.trailingSlash,`trailingSlash`,j.trailingSlash,t),P(n.queryParamsMode,`queryParamsMode`,j.queryParamsMode,t),P(n.urlParamsEncoding,`urlParamsEncoding`,j.urlParamsEncoding,t),n.allowNotFound!==void 0&&typeof n.allowNotFound!=`boolean`)throw TypeError(`[router.${t}] Invalid "allowNotFound": expected boolean, got ${typeof n.allowNotFound}`);if(n.rewritePathOnMatch!==void 0&&typeof n.rewritePathOnMatch!=`boolean`)throw TypeError(`[router.${t}] Invalid "rewritePathOnMatch": expected boolean, got ${typeof n.rewritePathOnMatch}`);if(n.caseSensitive!==void 0&&typeof n.caseSensitive!=`boolean`)throw TypeError(`[router.${t}] Invalid "caseSensitive": expected boolean, got ${typeof n.caseSensitive}`);De(n.queryParams,t),n.limits!==void 0&&we(n.limits,t)}const F=`router.usePlugin`,ke={onStart:!0,onStop:!0,onTransitionStart:!0,onTransitionLeaveApprove:!0,onTransitionSuccess:!0,onTransitionError:!0,onTransitionCancel:!0};function Ae(e,t,n=50){if(n!==0&&e+t>n)throw RangeError(`[router.usePlugin] Plugin limit exceeded (${n}). Current: ${e}, Attempting to add: ${t}. This indicates an architectural problem. Consider consolidating plugins.`)}function je(e,t){if(t.includes(e))throw Error(`[router.usePlugin] Plugin factory already registered. To re-register, first unsubscribe the existing plugin.`)}function Me(e,t){if(t===0)return;let{warn:n,error:r}=b(t);e>=r?i.error(F,`${e} plugins registered! This is excessive. Hard limit at ${t}.`):e>=n&&i.warn(F,`${e} plugins registered. Consider if all are necessary.`)}function Ne(e){for(let t in e)if(!(t===`teardown`||Object.hasOwn(ke,t)))throw TypeError(`[router.usePlugin] Unknown property '${t}'. Plugin must only contain event handlers and optional teardown.`)}function Pe(){i.warn(F,`Duplicate factory in batch, will be registered once`)}function Fe(e){i.warn(F,`Property '${e}' is not a function, skipping`)}function Ie(e){e===`onStart`&&i.warn(F,`Router already started, onStart will not be called`)}function Le(e,t){let n=[`start`,`buildPath`,`forwardState`];if(typeof e!=`string`||!n.includes(e))throw TypeError(`[router.addInterceptor] Invalid method: "${String(e)}". Must be one of: ${n.join(`, `)}`);if(typeof t!=`function`)throw TypeError(`[router.addInterceptor] interceptor must be a function, got ${typeof t}`)}function I(e,t){if(!e||typeof e!=`object`)throw TypeError(`[validation-plugin] ${t}: store must be an object`);let n=e;if(!Array.isArray(n.definitions))throw TypeError(`[validation-plugin] ${t}: store.definitions must be an array`);if(!n.config||typeof n.config!=`object`)throw TypeError(`[validation-plugin] ${t}: store.config must be an object`);if(!n.tree||typeof n.tree!=`object`)throw TypeError(`[validation-plugin] ${t}: store.tree must be an object`);return n}function L(e,t,n=``){for(let r of e){let e=n?`${n}.${r.name}`:r.name;t(r,e),r.children&&L(r.children,t,e)}}function R(e,t){let n=t.split(`.`),r=e;for(let e of n)if(r=r.children.get(e),!r)return!1;return!0}function Re(e,n){try{return t(e,n)}catch(e){throw Error(`[validation-plugin] ${e.message}`,{cause:e})}}function z(e){let t=new Set;for(let n of e){for(let e of n.paramMeta.urlParams)t.add(e);for(let e of n.paramMeta.spatParams)t.add(e)}return t}function B(e,t,n){let r=e;if(r.constructor.name===`AsyncFunction`||r.toString().includes(`__awaiter`))throw TypeError(`[validation-plugin] Route "${n}" ${t} cannot be async`)}function ze(e){L(I(e,`validateExistingRoutes`).definitions,(e,t)=>{if(typeof e.name!=`string`||!e.name)throw TypeError(`[validation-plugin] validateExistingRoutes: route has invalid name: ${e.name}`);if(e.name.includes(`.`))throw TypeError(`[router.constructor] Route name "${e.name}" cannot contain dots. Use children array or { parent } option in addRoute() instead.`);if(typeof e.path!=`string`)throw TypeError(`[validation-plugin] validateExistingRoutes: route "${t}" has non-string path (${typeof e.path})`)})}function Be(e){let{config:t,tree:n,matcher:r}=I(e,`validateForwardToConsistency`);for(let[e,i]of Object.entries(t.forwardMap)){if(!R(n,i))throw Error(`[validation-plugin] validateForwardToConsistency: forwardTo target "${i}" does not exist in tree (source route: "${e}")`);let t=r.getSegmentsByName(e),a=r.getSegmentsByName(i);if(t&&a){let n=z(t),r=[...z(a)].filter(e=>!n.has(e));if(r.length>0)throw Error(`[validation-plugin] validateForwardToConsistency: forwardTo target "${i}" requires params [${r.join(`, `)}] not available in source route "${e}"`)}}for(let e of Object.keys(t.forwardMap))Re(e,t.forwardMap)}function Ve(e){let{config:t}=I(e,`validateRoutePropertiesStore`);for(let[e,n]of Object.entries(t.decoders)){if(typeof n!=`function`)throw TypeError(`[validation-plugin] validateRoutePropertiesStore: route "${e}" decoder must be a function, got ${typeof n}`);B(n,`decoder`,e)}for(let[e,n]of Object.entries(t.encoders)){if(typeof n!=`function`)throw TypeError(`[validation-plugin] validateRoutePropertiesStore: route "${e}" encoder must be a function, got ${typeof n}`);B(n,`encoder`,e)}for(let[e,n]of Object.entries(t.defaultParams))if(typeof n!=`object`||!n||Array.isArray(n))throw TypeError(`[validation-plugin] validateRoutePropertiesStore: route "${e}" defaultParams must be a plain object, got ${Array.isArray(n)?`array`:typeof n}`);for(let[e,n]of Object.entries(t.forwardFnMap)){if(typeof n!=`function`)throw TypeError(`[validation-plugin] validateRoutePropertiesStore: route "${e}" forwardTo callback must be a function, got ${typeof n}`);B(n,`forwardTo callback`,e)}}function He(e){let{config:t,tree:n}=I(e,`validateForwardToTargetsStore`);for(let[e,r]of Object.entries(t.forwardMap))if(!R(n,r))throw Error(`[validation-plugin] validateForwardToTargetsStore: forwardTo target "${r}" does not exist for route "${e}"`)}function Ue(e){if(!e||typeof e!=`object`)throw TypeError(`[validation-plugin] validateDependenciesStructure: deps must be an object`);let t=e;if(!t.dependencies||typeof t.dependencies!=`object`)throw TypeError(`[validation-plugin] validateDependenciesStructure: deps.dependencies must be an object`);let n=t.dependencies;for(let e of Object.keys(n))if(Object.getOwnPropertyDescriptor(n,e)?.get)throw TypeError(`[validation-plugin] validateDependenciesStructure: dependency "${e}" must not use a getter`);if(!t.limits||typeof t.limits!=`object`)throw TypeError(`[validation-plugin] validateDependenciesStructure: deps.limits must be an object`);let r=t.limits;for(let e of[`maxDependencies`,`maxPlugins`,`maxListeners`,`warnListeners`,`maxLifecycleHandlers`])if(typeof r[e]!=`number`)throw TypeError(`[validation-plugin] validateDependenciesStructure: deps.limits.${e} must be a number, got ${typeof r[e]}`)}function We(e){let t=e&&typeof e==`object`?e:{};return t.limits&&typeof t.limits==`object`?t.limits:{}}function Ge(e,t){if(!e||typeof e!=`object`)return;let n=e,r=n.dependencies,i=n.limits;if(!r||typeof r!=`object`||!i||typeof i!=`object`)return;let a=Object.keys(r).length,o=i,s=t.maxDependencies,c=o.maxDependencies,l=typeof s==`number`?s:c;if(typeof l==`number`&&l>0&&a>=l)throw RangeError(`[validation-plugin] validateLimitsConsistency: dependency count (${a}) reaches or exceeds maxDependencies limit (${l})`)}function Ke(e,t){Ge(t,We(e))}function V(e,t){if(!(typeof e!=`string`||!e)&&!R(I(t,`validateResolvedDefaultRoute`).tree,e))throw Error(`[validation-plugin] defaultRoute resolved to non-existent route: "${e}"`)}function qe(e,t){if(e!==void 0&&typeof e==`function`){let n=e.constructor.name===`AsyncFunction`,r=e.toString().includes(`__awaiter`);if(n||r)throw TypeError(`[router.addRoute] forwardTo callback cannot be async for route "${t}". Async functions break matchPath/buildPath.`)}}function H(e,t){if(e.canActivate!==void 0&&typeof e.canActivate!=`function`)throw TypeError(`[router.addRoute] canActivate must be a function for route "${t}", got ${y(e.canActivate)}`);if(e.canDeactivate!==void 0&&typeof e.canDeactivate!=`function`)throw TypeError(`[router.addRoute] canDeactivate must be a function for route "${t}", got ${y(e.canDeactivate)}`);if(e.defaultParams!==void 0){let n=e.defaultParams;if(typeof n!=`object`||!n||Array.isArray(n))throw TypeError(`[router.addRoute] defaultParams must be an object for route "${t}", got ${y(e.defaultParams)}`)}if(e.decodeParams?.constructor.name===`AsyncFunction`)throw TypeError(`[router.addRoute] decodeParams cannot be async for route "${t}". Async functions break matchPath/buildPath.`);if(e.encodeParams?.constructor.name===`AsyncFunction`)throw TypeError(`[router.addRoute] encodeParams cannot be async for route "${t}". Async functions break matchPath/buildPath.`);if(qe(e.forwardTo,t),e.children)for(let n of e.children)H(n,`${t}.${n.name}`)}function Je(e){let t=new Set,n=/[*:]([A-Z_a-z]\w*)/g,r;for(;(r=n.exec(e))!==null;)t.add(r[1]);return t}function U(e){let t=new Set;for(let n of e)for(let e of Je(n))t.add(e);return t}function W(e,t,n=``,r=[]){for(let i of e){let e=n?`${n}.${i.name}`:i.name,a=[...r,i.path];if(e===t)return a;if(i.children&&t.startsWith(`${e}.`))return W(i.children,t,e,a)}throw Error(`[internal] collectPathsToRoute: route "${t}" not found`)}function G(e,t=``){let n=new Set;for(let r of e){let e=t?`${t}.${r.name}`:r.name;if(n.add(e),r.children)for(let t of G(r.children,e))n.add(t)}return n}function K(e,t=``){let n=new Map;for(let r of e){let e=t?`${t}.${r.name}`:r.name;if(r.forwardTo&&typeof r.forwardTo==`string`&&n.set(e,r.forwardTo),r.children)for(let[t,i]of K(r.children,e))n.set(t,i)}return n}function q(e){let t=new Set;for(let n of e){for(let e of n.paramMeta.urlParams)t.add(e);for(let e of n.paramMeta.spatParams)t.add(e)}return t}function Ye(e,t,n,r){return t?q(n.getSegmentsByName(e)??[]):U(W(r,e))}const Xe=new Set;function Ze(e,t,n,r,i,a){let o=i.hasRoute(t),s=r.has(t);if(!o&&!s)throw ReferenceError(`[router.addRoute] forwardTo target "${t}" does not exist for route "${e}"`);let c=new Set([...a,...U(W(n,e))]),l=[...Ye(t,o,i,n)].filter(e=>!c.has(e));if(l.length>0)throw Error(`[router.addRoute] forwardTo target "${t}" requires params [${l.join(`, `)}] that are not available in source route "${e}"`)}function Qe(e,n,r,i){let a=G(e),o=i?new Set([...a].map(e=>`${i}.${e}`)):a,s=i?q(r.getSegmentsByName(i)):Xe,c=K(e),l={...n};for(let[e,t]of c)l[e]=t;for(let[t,n]of c)Ze(t,n,e,o,r,s);for(let e of Object.keys(l))t(e,l)}function J(e,t){if(e.startsWith(`@@`))throw 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 Y(e,t){for(let n of e)n&&typeof n==`object`&&typeof n.name==`string`&&(J(n.name,t),n.children&&Y(n.children,t))}function $e(e){v(e,`removeRoute`)}function et(e){if(typeof e!=`string`)throw TypeError(`[router.setRootPath] rootPath must be a string, got ${y(e)}`)}function X(e){return e.constructor.name===`AsyncFunction`||String(e).includes(`__awaiter`)}function tt(e){let t=e;if(t.canActivate!==void 0&&typeof t.canActivate!=`function`)throw TypeError(`[router.addRoute] canActivate must be a function, got ${y(t.canActivate)}`);if(t.canDeactivate!==void 0&&typeof t.canDeactivate!=`function`)throw TypeError(`[router.addRoute] canDeactivate must be a function, got ${y(t.canDeactivate)}`)}function nt(e){let t=e,n=t.name;if(t.decodeParams!==void 0&&X(t.decodeParams))throw TypeError(`[router.addRoute] decodeParams cannot be async for route "${String(n)}"`);if(t.encodeParams!==void 0&&X(t.encodeParams))throw TypeError(`[router.addRoute] encodeParams cannot be async for route "${String(n)}"`);if(typeof t.forwardTo==`function`&&X(t.forwardTo))throw TypeError(`[router.addRoute] forwardTo callback cannot be async for route "${String(n)}"`)}function rt(e){for(let t of e){if(typeof t!=`object`||!t||Array.isArray(t))throw TypeError(`[router.addRoute] Route must be an object, got ${y(t)}`);H(t,t.name)}}function it(e){if(typeof e!=`string`||e===``)throw TypeError(`[router.addRoute] parent option must be a non-empty string, got ${y(e)}`);v(e,`addRoute`)}function at(e,t,n,r){if(!g(e))throw TypeError(`[router.isActiveRoute] name must be a string, got ${typeof e}`);if(t!==void 0&&!f(t))throw TypeError(`[router.isActiveRoute] params must be a plain object, got ${y(t)}`);if(n!==void 0&&typeof n!=`boolean`)throw TypeError(`[router.isActiveRoute] strictEquality must be a boolean, got ${typeof n}`);if(r!==void 0&&typeof r!=`boolean`)throw TypeError(`[router.isActiveRoute] ignoreQueryParams must be a boolean, got ${typeof r}`)}function ot(e,t,n){if(!g(e))throw TypeError(`[router.${n}] Invalid routeName: ${y(e)}. Expected string.`);if(!f(t))throw TypeError(`[router.${n}] Invalid routeParams: ${y(t)}. Expected plain object.`)}function Z(e,t){if(v(e,`updateRoute`),e===``)throw ReferenceError(`[router.updateRoute] Invalid name: empty string. Cannot update root node.`);if(t===null)throw TypeError(`[router.updateRoute] updates must be an object, got null`);if(typeof t!=`object`||Array.isArray(t))throw TypeError(`[router.updateRoute] updates must be an object, got ${y(t)}`)}function Q(e,t){if(e.constructor.name===`AsyncFunction`||e.toString().includes(`__awaiter`))throw TypeError(`[router.updateRoute] ${t} cannot be an async function`)}function $(e,t){if(e!=null){if(typeof e!=`function`)throw TypeError(`[router.updateRoute] ${t} must be a function or null, got ${typeof e}`);Q(e,t)}}function st(e,t,n,r){if(e!=null){if(typeof e!=`string`&&typeof e!=`function`)throw TypeError(`[router.updateRoute] forwardTo must be a string, function, or null, got ${y(e)}`);typeof e==`function`&&Q(e,`forwardTo callback`)}if(t!=null&&(typeof t!=`object`||Array.isArray(t)))throw TypeError(`[router.updateRoute] defaultParams must be an object or null, got ${y(t)}`);$(n,`decodeParams`),$(r,`encodeParams`)}function ct(e){if(!g(e)||e===``)throw TypeError(`[router.buildPath] route must be a non-empty string, got ${typeof e==`string`?`""`:typeof e}`)}function lt(e){if(!g(e))throw TypeError(`[router.matchPath] path must be a string, got ${typeof e}`)}function ut(e){if(!g(e))throw TypeError(`[router.shouldUpdateNode] nodeName must be a string, got ${typeof e}`)}function dt(e,t,n,i,a){if(a&&t){let e=t;for(let t of a.split(`.`))if(e=e.children.get(t),!e)throw ReferenceError(`[router.addRoute] Parent route "${a}" does not exist`)}let o=new Set,s=new Map;for(let n of e)r(n,`addRoute`,t,a??``,o,s);n&&i&&Qe(e,i,n,a)}function ft(e){let t=new Set;for(let n of e)for(let e of n.paramMeta.urlParams)t.add(e);return t}function pt(e,t,n){let r=n.getSegmentsByName(e),i=n.getSegmentsByName(t),a=ft(r),o=[];for(let e of i)for(let t of e.paramMeta.urlParams)o.push(t);let s=o.filter(e=>!a.has(e));if(s.length>0)throw Error(`[router.addRoute] forwardTo target "${t}" requires params [${s.join(`, `)}] that are not available in source route "${e}"`)}function mt(e,n,r){t(e,{...r.forwardMap,[e]:n})}function ht(e,t,n,r,i){if(!n(e))throw ReferenceError(`[router.updateRoute] route "${e}" does not exist`);if(t!=null&&typeof t==`string`){if(!n(t))throw Error(`[router.updateRoute] forwardTo target "${t}" does not exist`);pt(e,t,r),mt(e,t,i)}}function gt(e,t,n){if(!g(e))throw TypeError(`[router.makeState] Invalid name: ${y(e)}. Expected string.`);if(t!==void 0&&!f(t))throw TypeError(`[router.makeState] Invalid params: ${y(t)}. Expected plain object.`);if(n!==void 0&&!g(n))throw TypeError(`[router.makeState] Invalid path: ${y(n)}. Expected string.`)}function _t(e){return{routes:{validateBuildPathArgs:ct,validateMatchPathArgs:lt,validateIsActiveRouteArgs:at,validateShouldUpdateNodeArgs:ut,validateStateBuilderArgs:ot,validateAddRouteArgs(e){rt(e)},validateRoutes(e,t,n){let r=t;dt(e,r.tree,r.matcher,r.config?.forwardMap,n)},validateRemoveRouteArgs:$e,validateUpdateRouteBasicArgs:Z,validateUpdateRoutePropertyTypes(e,t){let n=t;st(n.forwardTo,n.defaultParams,n.decodeParams,n.encodeParams)},validateUpdateRoute(e,t,n){let r=n,i=t.forwardTo;ht(e,i,e=>r.matcher.hasRoute(e),r.matcher,r.config)},validateParentOption(e,t){it(e);let n=t;for(let t of e.split(`.`)){let r=n.children.get(t);if(!r)throw ReferenceError(`[router.addRoute] Parent route "${e}" does not exist`);n=r}},validateRouteName(e,t){v(e,t)},throwIfInternalRoute(e,t){J(e,t)},throwIfInternalRouteInArray(e,t){Y(e,t)},validateSetRootPathArgs:et,guardRouteCallbacks:tt,guardNoAsyncCallbacks:nt},options:{validateOptions:Oe,validateResolvedDefaultRoute:V},dependencies:{validateDependencyName:se,validateSetDependencyArgs(e,t,n){ce(e)},validateDependenciesObject:le,validateDependencyExists(e,t){let n=t.dependencies?.[e];ue(n,e)},validateDependencyCount:de,validateCloneArgs:fe,warnOverwrite:pe,warnBatchOverwrite:me,warnRemoveNonExistent:he},plugins:{validatePluginLimit(e,t){Ae(e,1,t?.maxPlugins)},validateNoDuplicatePlugins:je,validatePluginKeys:Ne,validateCountThresholds(t){Me(t,e.getOptions().limits?.maxPlugins??50)},warnBatchDuplicates:Pe,warnPluginMethodType:Fe,warnPluginAfterStart:Ie,validateAddInterceptorArgs:Le},lifecycle:{validateHandler:ye,validateHandlerLimit(t,n){be(t,n,e.getOptions().limits?.maxLifecycleHandlers??200)},validateCountThresholds(t,n){xe(t,n,e.getOptions().limits?.maxLifecycleHandlers??200)},warnOverwrite:x,warnAsyncGuardSync:S},navigation:{validateNavigateArgs:C,validateNavigateToDefaultArgs:w,validateNavigateToStateArgs:T,validateNavigationOptions:E,validateParams:k,validateStartArgs:A},state:{validateMakeStateArgs:gt,validateAreStatesEqualArgs(e,t,n){if(!h(e))throw TypeError(`[router.areStatesEqual] Invalid state1: ${y(e)}. Expected State object.`);if(!h(t))throw TypeError(`[router.areStatesEqual] Invalid state2: ${y(t)}. Expected State object.`);if(n!==void 0&&!_(n))throw TypeError(`[router.areStatesEqual] Invalid ignoreQueryParams: ${y(n)}. Expected boolean.`)}},eventBus:{validateListenerArgs(e,t){ve(e,t)}}}}function vt(){return t=>{let r=n(t);if(t.isActive())throw new e(`VALIDATION_PLUGIN_AFTER_START`,{message:`validation-plugin must be registered before router.start()`});r.validator=_t(r);try{let e=r.routeGetStore(),t=r.dependenciesGetStore(),n=r.getOptions();ze(e),Be(e),Ve(e),He(e),Ue(t),Ke(n,t),r.validator.options.validateOptions(n,`constructor (retrospective)`),typeof n.defaultRoute==`string`&&V(n.defaultRoute,e)}catch(e){throw r.validator=null,e}return{teardown(){r.validator=null}}}}export{vt as validationPlugin};
1
+ import{RouterError as e,resolveForwardChain as t}from"@real-router/core";import{getInternals as n,validateRoute as r}from"@real-router/core/validation";import{logger as i}from"@real-router/logger";const a=[`replace`,`reload`,`force`,`forceDeactivate`,`redirected`];function o(e){if(typeof e!=`object`||!e||Array.isArray(e))return!1;let t=e;for(let e of a){let n=t[e];if(n!==void 0&&typeof n!=`boolean`)return!1}let n=t.signal;return!(n!==void 0&&!(n instanceof AbortSignal))}const s=/\S/,c=/^[A-Z_a-z][\w-]*(?:\.[A-Z_a-z][\w-]*)*$/;function l(e,t){return TypeError(`[router.${e}] ${t}`)}function ee(e){return typeof e==`string`?e===``?!0:e.length>1e4?!1:e.startsWith(`@@`)?!0:c.test(e):!1}function u(e){if(Array.isArray(e))return!0;let t=Object.getPrototypeOf(e);return t===null||t===Object.prototype}function te(e,t){let n=Array.isArray(e)?e:Object.values(e);for(let e of n)t.push(e)}function ne(e){let t=typeof e;return t===`string`||t===`boolean`?!0:t===`number`?Number.isFinite(e):!1}var d=class{container;constructor(e){this.container=e}};function re(e,t,n,r){return n.has(e)?!1:r.has(e)?!0:u(e)?(n.add(e),t.push(new d(e)),te(e,t),!0):!1}function ie(e){let t=[e],n=new WeakSet,r=new WeakSet;for(;t.length>0;){let e=t.pop();if(e instanceof d){n.delete(e.container),r.add(e.container);continue}if(e!=null){if(typeof e==`object`){if(!re(e,t,n,r))return!1;continue}if(!ne(e))return!1}}return!0}function ae(e){if(e==null)return!0;let t=typeof e;return t===`string`||t===`boolean`?!0:t===`number`?Number.isFinite(e):!1}function f(e){try{return p(e)}catch{return!1}}function p(e){if(typeof e!=`object`||!e||Array.isArray(e))return!1;let t=Object.getPrototypeOf(e);if(t!==null&&t!==Object.prototype)return!1;let n=!1;for(let t in e){if(!Object.hasOwn(e,t))continue;let r=e[t];if(!ae(r)){let e=typeof r;if(e===`function`||e===`symbol`)return!1;n=!0;break}}return n?ie(e):!0}function oe(e){return ee(e.name)&&typeof e.path==`string`&&f(e.params)}function m(e){return typeof e!=`object`||!e?!1:oe(e)}function h(e){return typeof e==`string`}function g(e){return typeof e==`boolean`}function se(e,t){return e in t}function _(e,t){if(typeof e!=`string`)throw l(t,`Route name must be a string, got ${typeof e}`);if(e!==``){if(!s.test(e))throw l(t,`Route name cannot contain only whitespace`);if(e.length>1e4)throw l(t,`Route name exceeds maximum length of 10000 characters. This is a technical safety limit.`);if(!e.startsWith(`@@`)&&!c.test(e))throw l(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 v(e){if(e===null)return`null`;if(Array.isArray(e))return`array[${e.length}]`;if(typeof e==`object`){try{let t=e.constructor;if(typeof t==`function`&&t.name!==`Object`)return t.name||`object`}catch{}return`object`}return typeof e}function y(e){return{warn:Math.floor(e*.2),error:Math.floor(e*.5)}}function ce(e,t){if(typeof e!=`string`)throw TypeError(`[router.${t}] dependency name must be a string, got ${typeof e}`)}function le(e){if(typeof e!=`string`)throw TypeError(`[router.setDependency] dependency name must be a string, got ${typeof e}`)}function ue(e,t){if(!(e&&typeof e==`object`&&e.constructor===Object))throw TypeError(`[router.${t}] Invalid argument: expected plain object, received ${v(e)}`);for(let n in e)if(Object.getOwnPropertyDescriptor(e,n)?.get)throw TypeError(`[router.${t}] Getters not allowed: "${n}"`)}function de(e,t){if(e===void 0)throw ReferenceError(`[router.getDependency] dependency "${t}" not found`)}function fe(e,t){let n=e,r=n.limits?.maxDependencies??100;if(r===0)return;let a=Object.keys(n.dependencies).length,{warn:o,error:s}=y(r);if(a>=r)throw RangeError(`[router.${t}] Dependency limit exceeded (${r}). Current: ${a}.`);a===s?i.error(`router.${t}`,`${a} dependencies registered! This indicates architectural problems. Hard limit at ${r}.`):a===o&&i.warn(`router.${t}`,`${a} dependencies registered. Consider if all are necessary.`)}function pe(e){if(e!==void 0){if(!(e&&typeof e==`object`&&e.constructor===Object))throw TypeError(`[cloneRouter] Invalid dependencies: expected plain object or undefined, received ${typeof e}`);for(let t in e)if(Object.getOwnPropertyDescriptor(e,t)?.get)throw TypeError(`[cloneRouter] Getters not allowed in dependencies: "${t}"`)}}function me(e,t){i.warn(`router.${t}`,`Router dependency already exists and is being overwritten:`,e)}function he(e,t){i.warn(`router.${t}`,`Overwritten:`,e.join(`, `))}function ge(e){i.warn(`router.removeDependency`,`Attempted to remove non-existent dependency: "${typeof e==`string`?e:String(e)}"`)}const _e=new Set([`$start`,`$stop`,`$$start`,`$$leaveApprove`,`$$cancel`,`$$success`,`$$error`]);function ve(e){if(!_e.has(e))throw TypeError(`[router.addEventListener] Invalid event name: ${String(e)}. Must be one of: $start, $stop, $$start, $$leaveApprove, $$cancel, $$success, $$error`)}function ye(e,t){if(ve(e),typeof t!=`function`)throw TypeError(`[router.addEventListener] callback must be a function, got ${typeof t}`)}function be(e,t,n,r=1e4){if(r===0)return;let{warn:a,error:o}=y(r);e>=o?i.error(`router.${n}`,`${e} listeners registered for "${t}"! This is excessive. Hard limit at ${r}.`):e>=a&&i.warn(`router.${n}`,`${e} listeners registered for "${t}". Consider whether all are necessary — a growing count usually means a missing unsubscribe.`)}function xe(e,t){if(!g(e)&&typeof e!=`function`)throw TypeError(`[router.${t}] Handler must be a boolean or factory function, got ${v(e)}`)}function Se(e,t,n=200){if(n!==0&&e>=n)throw RangeError(`[router.${t}] Lifecycle handler limit exceeded (${n}). This indicates too many routes with individual handlers. Consider using plugins for cross-cutting concerns.`)}function b(e,t,n){if(n===0)return;let{warn:r,error:a}=y(n);e>=a?i.error(`router.${t}`,`${e} lifecycle handlers registered! This is excessive. Hard limit at ${n}.`):e>=r&&i.warn(`router.${t}`,`${e} lifecycle handlers registered. Consider consolidating logic.`)}function x(e,t,n){i.warn(`router.${n}`,`Overwriting existing ${t} handler for route "${e}"`)}function S(e,t){i.warn(`router.${t}`,`Guard for "${e}" returned a Promise. Sync check cannot resolve async guards — returning false.`)}function C(e){if(typeof e!=`string`)throw TypeError(`[router.navigate] Invalid route name: expected string, got ${v(e)}`)}function w(e){if(e!==void 0&&(typeof e!=`object`||!e))throw TypeError(`[router.navigateToDefault] Invalid options: ${v(e)}. Expected NavigationOptions object.`)}function T(e){if(typeof e!=`object`||!e)throw TypeError(`[router.navigateToState] Invalid state: ${v(e)}. Expected State object.`);let t=e;if(!h(t.name))throw TypeError(`[router.navigateToState] Invalid state.name: ${v(t.name)}. Expected string.`);if(!f(t.params))throw TypeError(`[router.navigateToState] Invalid state.params: ${v(t.params)}. Expected plain object.`);if(!h(t.path))throw TypeError(`[router.navigateToState] Invalid state.path: ${v(t.path)}. Expected string.`)}function E(e,t){if(!o(e))throw TypeError(`[router.${t}] Invalid options: ${v(e)}. Expected NavigationOptions object.`)}const D=/[\u0000-\u001F\u007F]/;function O(e,t){for(let n in e){if(!Object.hasOwn(e,n))continue;let r=e[n],i=typeof r;if(i===`symbol`||i===`bigint`)throw TypeError(`[router.${t}] param "${n}" cannot be a ${i} — it does not round-trip through the URL path. Use a string, number, or boolean.`);if(i===`string`&&D.test(r))throw TypeError(`[router.${t}] param "${n}" must not contain control characters (NUL / C0 / DEL) — they corrupt the URL path.`)}}function k(e,t){if(e!==void 0&&(typeof e==`object`&&e&&!Array.isArray(e)&&O(e,t),!f(e)))throw TypeError(`[router.${t}] params must be a plain object, got ${v(e)}`)}function A(e){if(e!==void 0&&typeof e!=`string`)throw TypeError(`[router.start] path must be a string, got ${v(e)}.`);if(typeof e==`string`){if(D.test(e))throw TypeError(`[router.start] path must not contain control characters (NUL / C0 / DEL).`);if(e!==``&&!e.startsWith(`/`))throw TypeError(`[router.start] path must start with "/", got "${e}".`)}}const j={trailingSlash:[`strict`,`never`,`always`,`preserve`],queryParamsMode:[`default`,`strict`,`loose`],urlParamsEncoding:[`default`,`uri`,`uriComponent`,`none`]},M={arrayFormat:[`none`,`brackets`,`index`,`comma`],booleanFormat:[`none`,`auto`,`empty-true`],nullFormat:[`default`,`hidden`],numberFormat:[`none`,`auto`]},Ce=new Set([`defaultRoute`,`defaultParams`,`trailingSlash`,`caseSensitive`,`queryParamsMode`,`queryParams`,`urlParamsEncoding`,`allowNotFound`,`rewritePathOnMatch`,`logger`,`limits`]),N={maxDependencies:{min:0,max:1e4},maxPlugins:{min:0,max:1e3},maxListeners:{min:0,max:1e5},warnListeners:{min:0,max:1e5},maxLifecycleHandlers:{min:0,max:1e4}};function we(e,t,n){if(typeof t!=`number`||!Number.isInteger(t))throw TypeError(`[router.${n}] limit "${e}" must be an integer, got ${String(t)}`);let r=N[e];if(t<r.min||t>r.max)throw RangeError(`[router.${n}] limit "${e}" must be between ${r.min} and ${r.max}, got ${t}`)}function Te(e,t){if(!e||typeof e!=`object`||e.constructor!==Object)throw TypeError(`[router.${t}] invalid limits: expected plain object, got ${typeof e}`);for(let[n,r]of Object.entries(e)){if(!Object.hasOwn(N,n))throw TypeError(`[router.${t}] unknown limit: "${n}"`);r!==void 0&&we(n,r,t)}let{warnListeners:n,maxListeners:r}=e;if(typeof n==`number`&&typeof r==`number`&&r>0&&n>r)throw RangeError(`[router.${t}] "limits.warnListeners" (${n}) must not exceed "limits.maxListeners" (${r}) — the warning channel would be unreachable`)}function P(e,t,n,r){if(e!==void 0&&(typeof e!=`string`||!n.includes(e))){let i=n.map(e=>`"${e}"`).join(`, `);throw TypeError(`[router.${r}] Invalid "${t}": "${typeof e==`string`?e:`(${typeof e})`}". Must be one of: ${i}`)}}function Ee(e,t){if(e!==void 0&&typeof e!=`string`&&typeof e!=`function`)throw TypeError(`[router.${t}] Invalid "defaultRoute": expected string or function, got ${typeof e}`)}function De(e,t){if(e!==void 0&&typeof e!=`function`&&(!e||typeof e!=`object`||Array.isArray(e)||e.constructor!==Object))throw TypeError(`[router.${t}] Invalid "defaultParams": expected plain object or function, got ${typeof e}`)}function Oe(e,t){if(e===void 0)return;if(!e||typeof e!=`object`||Array.isArray(e))throw TypeError(`[router.${t}] Invalid "queryParams": expected plain object`);let n=e;for(let[e,r]of Object.entries(n)){if(!se(e,M))throw TypeError(`[router.${t}] Invalid "queryParams.${e}": unknown option`);P(r,`queryParams.${e}`,M[e],t)}}function ke(e,t){if(!e||typeof e!=`object`||Array.isArray(e))throw TypeError(`[router.${t}] Invalid options: expected plain object`);let n=e;for(let e of Object.keys(n))if(!Ce.has(e))throw TypeError(`[router.${t}] Unknown option: "${e}"`);if(Ee(n.defaultRoute,t),De(n.defaultParams,t),P(n.trailingSlash,`trailingSlash`,j.trailingSlash,t),P(n.queryParamsMode,`queryParamsMode`,j.queryParamsMode,t),P(n.urlParamsEncoding,`urlParamsEncoding`,j.urlParamsEncoding,t),n.allowNotFound!==void 0&&typeof n.allowNotFound!=`boolean`)throw TypeError(`[router.${t}] Invalid "allowNotFound": expected boolean, got ${typeof n.allowNotFound}`);if(n.rewritePathOnMatch!==void 0&&typeof n.rewritePathOnMatch!=`boolean`)throw TypeError(`[router.${t}] Invalid "rewritePathOnMatch": expected boolean, got ${typeof n.rewritePathOnMatch}`);if(n.caseSensitive!==void 0&&typeof n.caseSensitive!=`boolean`)throw TypeError(`[router.${t}] Invalid "caseSensitive": expected boolean, got ${typeof n.caseSensitive}`);Oe(n.queryParams,t),n.limits!==void 0&&Te(n.limits,t)}const F=`router.usePlugin`,Ae={onStart:!0,onStop:!0,onTransitionStart:!0,onTransitionLeaveApprove:!0,onTransitionSuccess:!0,onTransitionError:!0,onTransitionCancel:!0};function je(e,t,n=50){if(n!==0&&e+t>n)throw RangeError(`[router.usePlugin] Plugin limit exceeded (${n}). Current: ${e}, Attempting to add: ${t}. This indicates an architectural problem. Consider consolidating plugins.`)}function Me(e,t){if(t.includes(e))throw Error(`[router.usePlugin] Plugin factory already registered. To re-register, first unsubscribe the existing plugin.`)}function Ne(e,t){if(t===0)return;let{warn:n,error:r}=y(t);e>=r?i.error(F,`${e} plugins registered! This is excessive. Hard limit at ${t}.`):e>=n&&i.warn(F,`${e} plugins registered. Consider if all are necessary.`)}function Pe(e){for(let t in e)if(!(t===`teardown`||Object.hasOwn(Ae,t)))throw TypeError(`[router.usePlugin] Unknown property '${t}'. Plugin must only contain event handlers and optional teardown.`)}function Fe(){i.warn(F,`Duplicate factory in batch, will be registered once`)}function Ie(e){i.warn(F,`Property '${e}' is not a function, skipping`)}function Le(e){e===`onStart`&&i.warn(F,`Router already started, onStart will not be called`)}function Re(e,t){let n=[`start`,`buildPath`,`forwardState`];if(typeof e!=`string`||!n.includes(e))throw TypeError(`[router.addInterceptor] Invalid method: "${String(e)}". Must be one of: ${n.join(`, `)}`);if(typeof t!=`function`)throw TypeError(`[router.addInterceptor] interceptor must be a function, got ${typeof t}`)}function I(e,t){if(!e||typeof e!=`object`)throw TypeError(`[validation-plugin] ${t}: store must be an object`);let n=e;if(!Array.isArray(n.definitions))throw TypeError(`[validation-plugin] ${t}: store.definitions must be an array`);if(!n.config||typeof n.config!=`object`)throw TypeError(`[validation-plugin] ${t}: store.config must be an object`);if(!n.tree||typeof n.tree!=`object`)throw TypeError(`[validation-plugin] ${t}: store.tree must be an object`);return n}function L(e,t,n=``){for(let r of e){let e=n?`${n}.${r.name}`:r.name;t(r,e),r.children&&L(r.children,t,e)}}function R(e,t){let n=t.split(`.`),r=e;for(let e of n)if(r=r.children.get(e),!r)return!1;return!0}function ze(e,n){try{return t(e,n)}catch(e){throw Error(`[validation-plugin] ${e.message}`,{cause:e})}}function z(e){let t=new Set;for(let n of e){for(let e of n.paramMeta.urlParams)t.add(e);for(let e of n.paramMeta.spatParams)t.add(e)}return t}function B(e,t,n){let r=e;if(r.constructor.name===`AsyncFunction`||r.toString().includes(`__awaiter`))throw TypeError(`[validation-plugin] Route "${n}" ${t} cannot be async`)}function Be(e){L(I(e,`validateExistingRoutes`).definitions,(e,t)=>{if(typeof e.name!=`string`||!e.name)throw TypeError(`[validation-plugin] validateExistingRoutes: route has invalid name: ${e.name}`);if(e.name.includes(`.`))throw TypeError(`[router.constructor] Route name "${e.name}" cannot contain dots. Use children array or { parent } option in addRoute() instead.`);if(typeof e.path!=`string`)throw TypeError(`[validation-plugin] validateExistingRoutes: route "${t}" has non-string path (${typeof e.path})`)})}function Ve(e){let{config:t,tree:n,matcher:r}=I(e,`validateForwardToConsistency`);for(let[e,i]of Object.entries(t.forwardMap)){if(!R(n,i))throw Error(`[validation-plugin] validateForwardToConsistency: forwardTo target "${i}" does not exist in tree (source route: "${e}")`);let t=r.getSegmentsByName(e),a=r.getSegmentsByName(i);if(t&&a){let n=z(t),r=[...z(a)].filter(e=>!n.has(e));if(r.length>0)throw Error(`[validation-plugin] validateForwardToConsistency: forwardTo target "${i}" requires params [${r.join(`, `)}] not available in source route "${e}"`)}}for(let e of Object.keys(t.forwardMap))ze(e,t.forwardMap)}function He(e){let{config:t}=I(e,`validateRoutePropertiesStore`);for(let[e,n]of Object.entries(t.decoders)){if(typeof n!=`function`)throw TypeError(`[validation-plugin] validateRoutePropertiesStore: route "${e}" decoder must be a function, got ${typeof n}`);B(n,`decoder`,e)}for(let[e,n]of Object.entries(t.encoders)){if(typeof n!=`function`)throw TypeError(`[validation-plugin] validateRoutePropertiesStore: route "${e}" encoder must be a function, got ${typeof n}`);B(n,`encoder`,e)}for(let[e,n]of Object.entries(t.defaultParams))if(typeof n!=`object`||!n||Array.isArray(n))throw TypeError(`[validation-plugin] validateRoutePropertiesStore: route "${e}" defaultParams must be a plain object, got ${Array.isArray(n)?`array`:typeof n}`);for(let[e,n]of Object.entries(t.forwardFnMap)){if(typeof n!=`function`)throw TypeError(`[validation-plugin] validateRoutePropertiesStore: route "${e}" forwardTo callback must be a function, got ${typeof n}`);B(n,`forwardTo callback`,e)}}function Ue(e){let{config:t,tree:n}=I(e,`validateForwardToTargetsStore`);for(let[e,r]of Object.entries(t.forwardMap))if(!R(n,r))throw Error(`[validation-plugin] validateForwardToTargetsStore: forwardTo target "${r}" does not exist for route "${e}"`)}function We(e){if(!e||typeof e!=`object`)throw TypeError(`[validation-plugin] validateDependenciesStructure: deps must be an object`);let t=e;if(!t.dependencies||typeof t.dependencies!=`object`)throw TypeError(`[validation-plugin] validateDependenciesStructure: deps.dependencies must be an object`);let n=t.dependencies;for(let e of Object.keys(n))if(Object.getOwnPropertyDescriptor(n,e)?.get)throw TypeError(`[validation-plugin] validateDependenciesStructure: dependency "${e}" must not use a getter`);if(!t.limits||typeof t.limits!=`object`)throw TypeError(`[validation-plugin] validateDependenciesStructure: deps.limits must be an object`);let r=t.limits;for(let e of[`maxDependencies`,`maxPlugins`,`maxListeners`,`warnListeners`,`maxLifecycleHandlers`])if(typeof r[e]!=`number`)throw TypeError(`[validation-plugin] validateDependenciesStructure: deps.limits.${e} must be a number, got ${typeof r[e]}`)}function Ge(e){let t=e&&typeof e==`object`?e:{};return t.limits&&typeof t.limits==`object`?t.limits:{}}function Ke(e,t){if(!e||typeof e!=`object`)return;let n=e,r=n.dependencies,i=n.limits;if(!r||typeof r!=`object`||!i||typeof i!=`object`)return;let a=Object.keys(r).length,o=i,s=t.maxDependencies,c=o.maxDependencies,l=typeof s==`number`?s:c;if(typeof l==`number`&&l>0&&a>l)throw RangeError(`[validation-plugin] validateLimitsConsistency: dependency count (${a}) exceeds maxDependencies limit (${l})`)}function qe(e,t){Ke(t,Ge(e))}function V(e,t){if(!(typeof e!=`string`||!e)&&!R(I(t,`validateResolvedDefaultRoute`).tree,e))throw Error(`[validation-plugin] defaultRoute resolved to non-existent route: "${e}"`)}function Je(e,t){if(e!==void 0&&typeof e==`function`){let n=e.constructor.name===`AsyncFunction`,r=e.toString().includes(`__awaiter`);if(n||r)throw TypeError(`[router.addRoute] forwardTo callback cannot be async for route "${t}". Async functions break matchPath/buildPath.`)}}function H(e,t){if(e.canActivate!==void 0&&typeof e.canActivate!=`function`)throw TypeError(`[router.addRoute] canActivate must be a function for route "${t}", got ${v(e.canActivate)}`);if(e.canDeactivate!==void 0&&typeof e.canDeactivate!=`function`)throw TypeError(`[router.addRoute] canDeactivate must be a function for route "${t}", got ${v(e.canDeactivate)}`);if(e.defaultParams!==void 0){let n=e.defaultParams;if(typeof n!=`object`||!n||Array.isArray(n))throw TypeError(`[router.addRoute] defaultParams must be an object for route "${t}", got ${v(e.defaultParams)}`)}if(e.decodeParams?.constructor.name===`AsyncFunction`)throw TypeError(`[router.addRoute] decodeParams cannot be async for route "${t}". Async functions break matchPath/buildPath.`);if(e.encodeParams?.constructor.name===`AsyncFunction`)throw TypeError(`[router.addRoute] encodeParams cannot be async for route "${t}". Async functions break matchPath/buildPath.`);if(Je(e.forwardTo,t),e.children)for(let n of e.children)H(n,`${t}.${n.name}`)}function Ye(e){let t=new Set,n=/[*:]([A-Z_a-z]\w*)/g,r;for(;(r=n.exec(e))!==null;)t.add(r[1]);return t}function U(e){let t=new Set;for(let n of e)for(let e of Ye(n))t.add(e);return t}function W(e,t,n=``,r=[]){for(let i of e){let e=n?`${n}.${i.name}`:i.name,a=[...r,i.path];if(e===t)return a;if(i.children&&t.startsWith(`${e}.`))return W(i.children,t,e,a)}throw Error(`[internal] collectPathsToRoute: route "${t}" not found`)}function G(e,t=``){let n=new Set;for(let r of e){let e=t?`${t}.${r.name}`:r.name;if(n.add(e),r.children)for(let t of G(r.children,e))n.add(t)}return n}function K(e,t=``){let n=new Map;for(let r of e){let e=t?`${t}.${r.name}`:r.name;if(r.forwardTo&&typeof r.forwardTo==`string`&&n.set(e,r.forwardTo),r.children)for(let[t,i]of K(r.children,e))n.set(t,i)}return n}function q(e){let t=new Set;for(let n of e){for(let e of n.paramMeta.urlParams)t.add(e);for(let e of n.paramMeta.spatParams)t.add(e)}return t}function Xe(e,t,n,r){return t?q(n.getSegmentsByName(e)??[]):U(W(r,e))}const Ze=new Set;function Qe(e,t,n,r,i,a){let o=i.hasRoute(t),s=r.has(t);if(!o&&!s)throw ReferenceError(`[router.addRoute] forwardTo target "${t}" does not exist for route "${e}"`);let c=new Set([...a,...U(W(n,e))]),l=[...Xe(t,o,i,n)].filter(e=>!c.has(e));if(l.length>0)throw Error(`[router.addRoute] forwardTo target "${t}" requires params [${l.join(`, `)}] that are not available in source route "${e}"`)}function $e(e,n,r,i){let a=G(e),o=i?new Set([...a].map(e=>`${i}.${e}`)):a,s=i?q(r.getSegmentsByName(i)):Ze,c=K(e),l={...n};for(let[e,t]of c)l[e]=t;for(let[t,n]of c)Qe(t,n,e,o,r,s);for(let e of Object.keys(l))t(e,l)}function J(e,t){if(e.startsWith(`@@`))throw 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 Y(e,t){for(let n of e)n&&typeof n==`object`&&typeof n.name==`string`&&(J(n.name,t),n.children&&Y(n.children,t))}function et(e){_(e,`removeRoute`)}function tt(e){if(typeof e!=`string`)throw TypeError(`[router.setRootPath] rootPath must be a string, got ${v(e)}`)}function X(e){return e.constructor.name===`AsyncFunction`||String(e).includes(`__awaiter`)}function nt(e){let t=e;if(t.canActivate!==void 0&&typeof t.canActivate!=`function`)throw TypeError(`[router.addRoute] canActivate must be a function, got ${v(t.canActivate)}`);if(t.canDeactivate!==void 0&&typeof t.canDeactivate!=`function`)throw TypeError(`[router.addRoute] canDeactivate must be a function, got ${v(t.canDeactivate)}`)}function rt(e){let t=e,n=t.name;if(t.decodeParams!==void 0&&X(t.decodeParams))throw TypeError(`[router.addRoute] decodeParams cannot be async for route "${String(n)}"`);if(t.encodeParams!==void 0&&X(t.encodeParams))throw TypeError(`[router.addRoute] encodeParams cannot be async for route "${String(n)}"`);if(typeof t.forwardTo==`function`&&X(t.forwardTo))throw TypeError(`[router.addRoute] forwardTo callback cannot be async for route "${String(n)}"`)}function it(e){for(let t of e){if(typeof t!=`object`||!t||Array.isArray(t))throw TypeError(`[router.addRoute] Route must be an object, got ${v(t)}`);H(t,t.name)}}function at(e){if(typeof e!=`string`||e===``)throw TypeError(`[router.addRoute] parent option must be a non-empty string, got ${v(e)}`);_(e,`addRoute`)}function ot(e,t,n,r){if(!h(e))throw TypeError(`[router.isActiveRoute] name must be a string, got ${typeof e}`);if(t!==void 0&&!f(t))throw TypeError(`[router.isActiveRoute] params must be a plain object, got ${v(t)}`);if(n!==void 0&&typeof n!=`boolean`)throw TypeError(`[router.isActiveRoute] strictEquality must be a boolean, got ${typeof n}`);if(r!==void 0&&typeof r!=`boolean`)throw TypeError(`[router.isActiveRoute] ignoreQueryParams must be a boolean, got ${typeof r}`)}function st(e,t,n){if(!h(e))throw TypeError(`[router.${n}] Invalid routeName: ${v(e)}. Expected string.`);if(!f(t))throw TypeError(`[router.${n}] Invalid routeParams: ${v(t)}. Expected plain object.`)}function ct(e,t){if(_(e,`updateRoute`),e===``)throw ReferenceError(`[router.updateRoute] Invalid name: empty string. Cannot update root node.`);if(t===null)throw TypeError(`[router.updateRoute] updates must be an object, got null`);if(typeof t!=`object`||Array.isArray(t))throw TypeError(`[router.updateRoute] updates must be an object, got ${v(t)}`)}function Z(e,t){if(e.constructor.name===`AsyncFunction`||e.toString().includes(`__awaiter`))throw TypeError(`[router.updateRoute] ${t} cannot be an async function`)}function Q(e,t){if(e!=null){if(typeof e!=`function`)throw TypeError(`[router.updateRoute] ${t} must be a function or null, got ${typeof e}`);Z(e,t)}}function lt(e,t,n,r){if(e!=null){if(typeof e!=`string`&&typeof e!=`function`)throw TypeError(`[router.updateRoute] forwardTo must be a string, function, or null, got ${v(e)}`);typeof e==`function`&&Z(e,`forwardTo callback`)}if(t!=null&&(typeof t!=`object`||Array.isArray(t)))throw TypeError(`[router.updateRoute] defaultParams must be an object or null, got ${v(t)}`);Q(n,`decodeParams`),Q(r,`encodeParams`)}function ut(e){if(!h(e)||e===``)throw TypeError(`[router.buildPath] route must be a non-empty string, got ${typeof e==`string`?`""`:typeof e}`)}function dt(e){if(!h(e))throw TypeError(`[router.matchPath] path must be a string, got ${typeof e}`)}function ft(e){if(!h(e))throw TypeError(`[router.shouldUpdateNode] nodeName must be a string, got ${typeof e}`)}function $(e,t,n,i,a){if(a&&t){let e=t;for(let t of a.split(`.`))if(e=e.children.get(t),!e)throw ReferenceError(`[router.addRoute] Parent route "${a}" does not exist`)}let o=new Set,s=new Map;for(let n of e)r(n,`addRoute`,t,a??``,o,s);n&&i&&$e(e,i,n,a)}function pt(e){let t=new Set;for(let n of e)for(let e of n.paramMeta.urlParams)t.add(e);return t}function mt(e,t,n){let r=n.getSegmentsByName(e),i=n.getSegmentsByName(t),a=pt(r),o=[];for(let e of i)for(let t of e.paramMeta.urlParams)o.push(t);let s=o.filter(e=>!a.has(e));if(s.length>0)throw Error(`[router.addRoute] forwardTo target "${t}" requires params [${s.join(`, `)}] that are not available in source route "${e}"`)}function ht(e,n,r){t(e,{...r.forwardMap,[e]:n})}function gt(e,t,n,r,i){if(!n(e))throw ReferenceError(`[router.updateRoute] route "${e}" does not exist`);if(t!=null&&typeof t==`string`){if(!n(t))throw Error(`[router.updateRoute] forwardTo target "${t}" does not exist`);mt(e,t,r),ht(e,t,i)}}function _t(e,t,n){if(!h(e))throw TypeError(`[router.makeState] Invalid name: ${v(e)}. Expected string.`);if(t!==void 0&&!f(t))throw TypeError(`[router.makeState] Invalid params: ${v(t)}. Expected plain object.`);if(n!==void 0&&!h(n))throw TypeError(`[router.makeState] Invalid path: ${v(n)}. Expected string.`)}function vt(e){return{routes:{validateBuildPathArgs:ut,validateMatchPathArgs:dt,validateIsActiveRouteArgs:ot,validateShouldUpdateNodeArgs:ft,validateStateBuilderArgs:st,validateAddRouteArgs(e){it(e)},validateRoutes(e,t,n){let r=t;$(e,r.tree,r.matcher,r.config?.forwardMap,n)},validateRemoveRouteArgs:et,validateUpdateRouteBasicArgs:ct,validateUpdateRoutePropertyTypes(e,t){let n=t;lt(n.forwardTo,n.defaultParams,n.decodeParams,n.encodeParams)},validateUpdateRoute(e,t,n){let r=n,i=t.forwardTo;gt(e,i,e=>r.matcher.hasRoute(e),r.matcher,r.config)},validateParentOption(e,t){at(e);let n=t;for(let t of e.split(`.`)){let r=n.children.get(t);if(!r)throw ReferenceError(`[router.addRoute] Parent route "${e}" does not exist`);n=r}},validateRouteName(e,t){_(e,t)},throwIfInternalRoute(e,t){J(e,t)},throwIfInternalRouteInArray(e,t){Y(e,t)},validateSetRootPathArgs:tt,guardRouteCallbacks:nt,guardNoAsyncCallbacks:rt},options:{validateOptions:ke,validateResolvedDefaultRoute:V},dependencies:{validateDependencyName:ce,validateSetDependencyArgs(e,t,n){le(e)},validateDependenciesObject:ue,validateDependencyExists(e,t){let n=t.dependencies?.[e];de(n,e)},validateDependencyCount:fe,validateCloneArgs:pe,warnOverwrite:me,warnBatchOverwrite:he,warnRemoveNonExistent:ge},plugins:{validatePluginLimit(e,t){je(e,1,t?.maxPlugins)},validateNoDuplicatePlugins:Me,validatePluginKeys:Pe,validateCountThresholds(t){Ne(t,e.getOptions().limits?.maxPlugins??50)},warnBatchDuplicates:Fe,warnPluginMethodType:Ie,warnPluginAfterStart:Le,validateAddInterceptorArgs:Re},lifecycle:{validateHandler:xe,validateHandlerLimit(t,n){Se(t,n,e.getOptions().limits?.maxLifecycleHandlers??200)},validateCountThresholds(t,n){b(t,n,e.getOptions().limits?.maxLifecycleHandlers??200)},warnOverwrite:x,warnAsyncGuardSync:S},navigation:{validateNavigateArgs:C,validateNavigateToDefaultArgs:w,validateNavigateToStateArgs:T,validateNavigationOptions:E,validateParams:k,validateStartArgs:A},state:{validateMakeStateArgs:_t,validateAreStatesEqualArgs(e,t,n){if(!m(e))throw TypeError(`[router.areStatesEqual] Invalid state1: ${v(e)}. Expected State object.`);if(!m(t))throw TypeError(`[router.areStatesEqual] Invalid state2: ${v(t)}. Expected State object.`);if(n!==void 0&&!g(n))throw TypeError(`[router.areStatesEqual] Invalid ignoreQueryParams: ${v(n)}. Expected boolean.`)}},eventBus:{validateListenerArgs(e,t){ye(e,t)},validateCountThresholds(t,n,r){be(t,n,r,e.getOptions().limits?.maxListeners??1e4)}}}}function yt(){return t=>{let r=n(t);if(t.isActive())throw new e(`VALIDATION_PLUGIN_AFTER_START`,{message:`validation-plugin must be registered before router.start()`});r.validator=vt(r);try{let e=r.routeGetStore(),t=r.dependenciesGetStore(),n=r.getOptions();Be(e),Ve(e),He(e),Ue(e),We(t),qe(n,t),r.validator.options.validateOptions(n,`constructor (retrospective)`),typeof n.defaultRoute==`string`&&V(n.defaultRoute,e)}catch(e){throw r.validator=null,e}return{teardown(){r.validator=null}}}}export{yt as validationPlugin};
2
2
  //# sourceMappingURL=index.mjs.map