@real-router/validation-plugin 0.14.2 → 0.15.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/esm/index.d.mts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/validationPlugin.ts"],"mappings":";;;;;;;;;;;;;;;;
|
|
1
|
+
{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/validationPlugin.ts"],"mappings":";;;;;;;;;;;;;;;;iBAsVgB,iBACd,qBAAqB,sBAAsB,wBACxC,cAAc"}
|
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{putField as i}from"@real-router/core/utils";function a(e){return typeof e==`string`}function o(e){return typeof e==`boolean`}function s(e,t){return e in t}const c=Object.getPrototypeOf,l=Object.values,u=Object.hasOwn;function ee(e){if(Array.isArray(e))return!0;let t=c(e);return t===null||t===Object.prototype}function te(e,t){let n=Array.isArray(e)?e:l(e);for(let e of n)t.push(e)}function ne(e){let t=typeof e;return t===`string`||t===`boolean`||t===`number`&&Number.isFinite(e)}var d=class{container;constructor(e){this.container=e}};function re(e,t,n,r){return n.has(e)?!1:r.has(e)?!0:ee(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`||t===`number`&&Number.isFinite(e)}function f(e){try{return oe(e)}catch{return!1}}function oe(e){if(typeof e!=`object`||!e||Array.isArray(e))return!1;let t=c(e);if(t!==null&&t!==Object.prototype)return!1;let n=!1;for(let t in e){if(!u(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)}const se=[`replace`,`reload`,`force`,`forceDeactivate`,`redirected`];function ce(e){if(typeof e!=`object`||!e||Array.isArray(e))return!1;let t=e;for(let e of se){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 le=/\S/,p=/^[A-Z_a-z][\w-]*(?:\.[A-Z_a-z][\w-]*)*$/;function m(e,t){return TypeError(`[router.${e}] ${t}`)}function ue(e){return typeof e==`string`?e===``?!0:e.length>1e4?!1:e.startsWith(`@@`)?!0:p.test(e):!1}function de(e){return ue(e.name)&&typeof e.path==`string`&&f(e.params)}function h(e){return typeof e!=`object`||!e?!1:de(e)}function g(e,t){if(typeof e!=`string`)throw m(t,`Route name must be a string, got ${typeof e}`);if(e!==``){if(!le.test(e))throw m(t,`Route name cannot contain only whitespace`);if(e.length>1e4)throw m(t,`Route name exceeds maximum length of 10000 characters. This is a technical safety limit.`);if(!e.startsWith(`@@`)&&!p.test(e))throw m(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 _(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 v(e){return{warn:Math.floor(e*.2),error:Math.floor(e*.5)}}const y=Object.keys,b=Object.getOwnPropertyDescriptor,fe=Object.getPrototypeOf,pe=Object;function x(e){if(!e||typeof e!=`object`)return!1;let t=fe(e);return t===null||t.constructor===pe}function me(e,t){if(typeof e!=`string`)throw TypeError(`[router.${t}] dependency name must be a string, got ${typeof e}`)}function he(e){if(typeof e!=`string`)throw TypeError(`[router.setDependency] dependency name must be a string, got ${typeof e}`)}function ge(e,t){if(!x(e))throw TypeError(`[router.${t}] Invalid argument: expected plain object, received ${_(e)}`);for(let n of y(e))if(b(e,n)?.get)throw TypeError(`[router.${t}] Getters not allowed: "${n}"`)}function _e(e,t){if(e===void 0)throw ReferenceError(`[router.getDependency] dependency "${t}" not found`)}function ve(e,t,n){let r=e,i=r.limits?.maxDependencies??100;if(i===0)return;let a=y(r.dependencies).length,{warn:o,error:s}=v(i);if(a>=i)throw RangeError(`[router.${t}] Dependency limit exceeded (${i}). Current: ${a}.`);a===s?n.error(`router.${t}`,`${a} dependencies registered! This indicates architectural problems. Hard limit at ${i}.`):a===o&&n.warn(`router.${t}`,`${a} dependencies registered. Consider if all are necessary.`)}function ye(e){if(e!==void 0){if(!x(e))throw TypeError(`[cloneRouter] Invalid dependencies: expected plain object or undefined, received ${typeof e}`);for(let t of y(e))if(b(e,t)?.get)throw TypeError(`[cloneRouter] Getters not allowed in dependencies: "${t}"`)}}function be(e,t,n){n.warn(`router.${t}`,`Router dependency already exists and is being overwritten:`,e)}function xe(e,t,n){n.warn(`router.${t}`,`Overwritten:`,e.join(`, `))}function Se(e,t){t.warn(`router.removeDependency`,`Attempted to remove non-existent dependency: "${typeof e==`string`?e:String(e)}"`)}const Ce=new Set([`$start`,`$stop`,`$$start`,`$$leaveApprove`,`$$cancel`,`$$success`,`$$error`]);function we(e){if(!Ce.has(e))throw TypeError(`[router.addEventListener] Invalid event name: ${String(e)}. Must be one of: $start, $stop, $$start, $$leaveApprove, $$cancel, $$success, $$error`)}function Te(e,t){if(we(e),typeof t!=`function`)throw TypeError(`[router.addEventListener] callback must be a function, got ${typeof t}`)}function Ee(e,t,n,r,i=1e4){if(i===0)return;let{warn:a,error:o}=v(i);e>=o?r.error(`router.${n}`,`${e} listeners registered for "${t}"! This is excessive. Hard limit at ${i}.`):e>=a&&r.warn(`router.${n}`,`${e} listeners registered for "${t}". Consider whether all are necessary — a growing count usually means a missing unsubscribe.`)}function De(e,t){if(!o(e)&&typeof e!=`function`)throw TypeError(`[router.${t}] Handler must be a boolean or factory function, got ${_(e)}`)}function Oe(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 S(e,t,n,r){if(n===0)return;let{warn:i,error:a}=v(n);e>=a?r.error(`router.${t}`,`${e} lifecycle handlers registered! This is excessive. Hard limit at ${n}.`):e>=i&&r.warn(`router.${t}`,`${e} lifecycle handlers registered. Consider consolidating logic.`)}function C(e,t,n,r){r.warn(`router.${n}`,`Overwriting existing ${t} handler for route "${e}"`)}function w(e,t,n){n.warn(`router.${t}`,`Guard for "${e}" returned a Promise. Sync check cannot resolve async guards — returning false.`)}const T=Object.hasOwn;function ke(e){if(typeof e!=`string`)throw TypeError(`[router.navigate] Invalid route name: expected string, got ${_(e)}`)}function Ae(e){if(e!==void 0&&(typeof e!=`object`||!e))throw TypeError(`[router.navigateToDefault] Invalid options: ${_(e)}. Expected NavigationOptions object.`)}function je(e){if(typeof e!=`object`||!e)throw TypeError(`[router.navigateToState] Invalid state: ${_(e)}. Expected State object.`);let t=e;if(!a(t.name))throw TypeError(`[router.navigateToState] Invalid state.name: ${_(t.name)}. Expected string.`);if(!f(t.params))throw TypeError(`[router.navigateToState] Invalid state.params: ${_(t.params)}. Expected plain object.`);if(!a(t.path))throw TypeError(`[router.navigateToState] Invalid state.path: ${_(t.path)}. Expected string.`)}function Me(e,t){if(!ce(e))throw TypeError(`[router.${t}] Invalid options: ${_(e)}. Expected NavigationOptions object.`)}const E=/[\u0000-\u001F\u007F]/;function Ne(e,t){for(let n in e){if(!T(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`&&E.test(r))throw TypeError(`[router.${t}] param "${n}" must not contain control characters (NUL / C0 / DEL) — they corrupt the URL path.`)}}function Pe(e,t){if(e!==void 0&&(typeof e==`object`&&e&&!Array.isArray(e)&&Ne(e,t),!f(e)))throw TypeError(`[router.${t}] params must be a plain object, got ${_(e)}`)}function Fe(e){if(e!==void 0&&typeof e!=`string`)throw TypeError(`[router.start] path must be a string, got ${_(e)}.`);if(typeof e==`string`){if(E.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 D=Object.entries,Ie=Object.hasOwn,Le=Object.keys,O={trailingSlash:[`strict`,`never`,`always`,`preserve`],queryParamsMode:[`default`,`strict`,`loose`],urlParamsEncoding:[`default`,`uri`,`uriComponent`,`none`]},k={arrayFormat:[`none`,`brackets`,`index`,`comma`],booleanFormat:[`none`,`auto`,`empty-true`],nullFormat:[`default`,`hidden`],numberFormat:[`none`,`auto`]},Re=new Set([`defaultRoute`,`defaultParams`,`defaultSearch`,`trailingSlash`,`caseSensitive`,`queryParamsMode`,`queryParams`,`urlParamsEncoding`,`allowNotFound`,`rewritePathOnMatch`,`logger`,`limits`]),A={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 ze(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=A[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 Be(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 D(e)){if(!Ie(A,n))throw TypeError(`[router.${t}] unknown limit: "${n}"`);r!==void 0&&ze(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 j(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 Ve(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 M(e,t,n){if(e!==void 0&&typeof e!=`function`&&(!e||typeof e!=`object`||Array.isArray(e)||e.constructor!==Object))throw TypeError(`[router.${n}] Invalid "${t}": expected plain object or function, got ${typeof e}`)}function He(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 D(n)){if(!s(e,k))throw TypeError(`[router.${t}] Invalid "queryParams.${e}": unknown option`);j(r,`queryParams.${e}`,k[e],t)}}function Ue(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 Le(n))if(!Re.has(e))throw TypeError(`[router.${t}] Unknown option: "${e}"`);if(Ve(n.defaultRoute,t),M(n.defaultParams,`defaultParams`,t),M(n.defaultSearch,`defaultSearch`,t),j(n.trailingSlash,`trailingSlash`,O.trailingSlash,t),j(n.queryParamsMode,`queryParamsMode`,O.queryParamsMode,t),j(n.urlParamsEncoding,`urlParamsEncoding`,O.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}`);He(n.queryParams,t),n.limits!==void 0&&Be(n.limits,t)}const We=Object.hasOwn,N=`router.usePlugin`,Ge={onStart:!0,onStop:!0,onTransitionStart:!0,onTransitionLeaveApprove:!0,onTransitionSuccess:!0,onTransitionError:!0,onTransitionCancel:!0};function Ke(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 qe(e,t){if(t.includes(e))throw Error(`[router.usePlugin] Plugin factory already registered. To re-register, first unsubscribe the existing plugin.`)}function Je(e,t,n){if(t===0)return;let{warn:r,error:i}=v(t);e>=i?n.error(N,`${e} plugins registered! This is excessive. Hard limit at ${t}.`):e>=r&&n.warn(N,`${e} plugins registered. Consider if all are necessary.`)}function Ye(e){for(let t in e)if(!(t===`teardown`||We(Ge,t)))throw TypeError(`[router.usePlugin] Unknown property '${t}'. Plugin must only contain event handlers and optional teardown.`)}function Xe(e){e.warn(N,`Duplicate factory in batch, will be registered once`)}function Ze(e,t){t.warn(N,`Property '${e}' is not a function, skipping`)}function Qe(e,t){e===`onStart`&&t.warn(N,`Router already started, onStart will not be called`)}function $e(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}`)}const P=Object.entries,et=Object.getOwnPropertyDescriptor,F=Object.keys;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 tt(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);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 nt(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(typeof e.path!=`string`)throw TypeError(`[validation-plugin] validateExistingRoutes: route "${t}" has non-string path (${typeof e.path})`)})}function rt(e){let{config:t,tree:n,matcher:r}=I(e,`validateForwardToConsistency`);for(let[e,i]of P(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 F(t.forwardMap))tt(e,t.forwardMap)}function it(e){let{config:t}=I(e,`validateRoutePropertiesStore`);for(let[e,n]of P(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 P(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 P(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 P(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 at(e){let{config:t,tree:n}=I(e,`validateForwardToTargetsStore`);for(let[e,r]of P(t.forwardMap))if(!R(n,r))throw Error(`[validation-plugin] validateForwardToTargetsStore: forwardTo target "${r}" does not exist for route "${e}"`)}function ot(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 F(n))if(et(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(!Number.isInteger(r[e]))throw TypeError(`[validation-plugin] validateDependenciesStructure: deps.limits.${e} must be an integer, got ${String(r[e])}`)}function st(e){let t=e&&typeof e==`object`?e:{};return t.limits&&typeof t.limits==`object`?t.limits:{}}function ct(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=F(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 lt(e,t){ct(t,st(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}"`)}const ut=Object.keys;function dt(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 ${_(e.canActivate)}`);if(e.canDeactivate!==void 0&&typeof e.canDeactivate!=`function`)throw TypeError(`[router.addRoute] canDeactivate must be a function for route "${t}", got ${_(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 ${_(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(dt(e.forwardTo,t),e.children)for(let n of e.children)H(n,`${t}.${n.name}`)}function ft(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 ft(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);return t}function pt(e,t,n,r){return t?q(n.getSegmentsByName(e)??[]):U(W(r,e))}const mt=new Set;function ht(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=[...pt(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 gt(e,n,r,a){let o=G(e),s=a?new Set([...o].map(e=>`${a}.${e}`)):o,c=a?q(r.getSegmentsByName(a)):mt,l=K(e),u={...n};for(let[e,t]of l)i(u,e,t);for(let[t,n]of l)ht(t,n,e,s,r,c);for(let e of ut(u))t(e,u)}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 _t(e){g(e,`removeRoute`)}function vt(e){if(typeof e!=`string`)throw TypeError(`[router.setRootPath] rootPath must be a string, got ${_(e)}`)}function X(e){return e.constructor.name===`AsyncFunction`||String(e).includes(`__awaiter`)}function yt(e){let t=e;if(t.canActivate!==void 0&&typeof t.canActivate!=`function`)throw TypeError(`[router.addRoute] canActivate must be a function, got ${_(t.canActivate)}`);if(t.canDeactivate!==void 0&&typeof t.canDeactivate!=`function`)throw TypeError(`[router.addRoute] canDeactivate must be a function, got ${_(t.canDeactivate)}`)}function bt(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 xt(e){for(let t of e){if(typeof t!=`object`||!t||Array.isArray(t))throw TypeError(`[router.addRoute] Route must be an object, got ${_(t)}`);H(t,t.name)}}function St(e){if(typeof e!=`string`||e===``)throw TypeError(`[router.addRoute] parent option must be a non-empty string, got ${_(e)}`);g(e,`addRoute`)}function Ct(e,t,n,r){if(!a(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 ${_(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 wt(e,t,n){if(!a(e))throw TypeError(`[router.${n}] Invalid routeName: ${_(e)}. Expected string.`);if(!f(t))throw TypeError(`[router.${n}] Invalid routeParams: ${_(t)}. Expected plain object.`)}function Tt(e,t){if(g(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 ${_(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 Et(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 ${_(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 ${_(t)}`);Q(n,`decodeParams`),Q(r,`encodeParams`)}function $(e){if(!a(e)||e===``)throw TypeError(`[router.buildPath] route must be a non-empty string, got ${typeof e==`string`?`""`:typeof e}`)}function Dt(e){if(!a(e))throw TypeError(`[router.matchPath] path must be a string, got ${typeof e}`)}function Ot(e){if(!a(e))throw TypeError(`[router.shouldUpdateNode] nodeName must be a string, got ${typeof e}`)}function kt(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,i,n,a)}function At(e){let t=new Set;for(let n of e)for(let e of n.paramMeta.urlParams)t.add(e);return t}function jt(e,t,n){let r=n.getSegmentsByName(e),i=n.getSegmentsByName(t),a=At(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 Nt(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`);jt(e,t,r),Mt(e,t,i)}}function Pt(e,t,n){if(!a(e))throw TypeError(`[router.makeState] Invalid name: ${_(e)}. Expected string.`);if(t!==void 0&&!f(t))throw TypeError(`[router.makeState] Invalid params: ${_(t)}. Expected plain object.`);if(n!==void 0&&!a(n))throw TypeError(`[router.makeState] Invalid path: ${_(n)}. Expected string.`)}function Ft(){let e=new Set;return function(t,n){let r=`${t} ${n}`;e.has(r)||(e.add(r),console.warn(`[router] Query key "${n}" is not declared on route "${t}" (\`?${n}\`), so the current \`queryParamsMode\` will not print it — it was dropped from \`state.search\` rather than published beside a \`state.path\` that cannot show it. Declare it on the route path, or use \`queryParamsMode: "loose"\` to keep undeclared keys. A \`defaultSearch\` entry for "${n}" is dead config in this mode for the same reason.`))}}function It(){let e=new Set;return function(t,n){let r=`${t} ${n}`;e.has(r)||(e.add(r),console.warn(`[router] Param "${n}" is declared nowhere on route "${t}" — neither as a path slot (:${n}) nor as a query param (?${n}), so it stays in state.params but never reaches the URL. The state will not round-trip: matchPath(state.path) cannot recover it. Declare it on the route path if it belongs in the URL, or pass it through the search channel; keep it here only if it is deliberately app-level data.`))}}function Lt(e){return{routes:{validateBuildPathArgs:$,validateMatchPathArgs:Dt,validateIsActiveRouteArgs:Ct,validateShouldUpdateNodeArgs:Ot,validateStateBuilderArgs:wt,validateAddRouteArgs(e){xt(e)},validateRoutes(e,t,n){let r=t;kt(e,r.tree,r.matcher,r.config?.forwardMap,n)},validateRemoveRouteArgs:_t,validateUpdateRouteBasicArgs:Tt,validateUpdateRoutePropertyTypes(e,t){let n=t;Et(n.forwardTo,n.defaultParams,n.decodeParams,n.encodeParams)},validateUpdateRoute(e,t,n){let r=n,i=t.forwardTo;Nt(e,i,e=>r.matcher.hasRoute(e),r.matcher,r.config)},validateParentOption(e,t){St(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){g(e,t)},throwIfInternalRoute(e,t){J(e,t)},throwIfInternalRouteInArray(e,t){Y(e,t)},validateSetRootPathArgs:vt,guardRouteCallbacks:yt,guardNoAsyncCallbacks:bt},options:{validateOptions:Ue,validateResolvedDefaultRoute:V},dependencies:{validateDependencyName:me,validateSetDependencyArgs(e,t,n){he(e)},validateDependenciesObject:ge,validateDependencyExists(e,t){let n=t.dependencies?.[e];_e(n,e)},validateDependencyCount(t,n){ve(t,n,e.logger)},validateCloneArgs:ye,warnOverwrite(t,n){be(t,n,e.logger)},warnBatchOverwrite(t,n){xe(t,n,e.logger)},warnRemoveNonExistent(t){Se(t,e.logger)}},plugins:{validatePluginLimit(e,t){Ke(e,1,t?.maxPlugins)},validateNoDuplicatePlugins:qe,validatePluginKeys:Ye,validateCountThresholds(t){Je(t,e.getOptions().limits?.maxPlugins??50,e.logger)},warnBatchDuplicates(){Xe(e.logger)},warnPluginMethodType(t){Ze(t,e.logger)},warnPluginAfterStart(t){Qe(t,e.logger)},validateAddInterceptorArgs:$e},lifecycle:{validateHandler:De,validateHandlerLimit(t,n){Oe(t,n,e.getOptions().limits?.maxLifecycleHandlers??200)},validateCountThresholds(t,n){S(t,n,e.getOptions().limits?.maxLifecycleHandlers??200,e.logger)},warnOverwrite(t,n,r){C(t,n,r,e.logger)},warnAsyncGuardSync(t,n){w(t,n,e.logger)}},navigation:{validateNavigateArgs:ke,validateNavigateToDefaultArgs:Ae,validateNavigateToStateArgs:je,validateNavigationOptions:Me,validateParams:Pe,validateStartArgs:Fe},state:{validateMakeStateArgs:Pt,reportDroppedQueryKey:Ft(),reportUndeclaredParamKey:It(),validateAreStatesEqualArgs(e,t,n){if(!h(e))throw TypeError(`[router.areStatesEqual] Invalid state1: ${_(e)}. Expected State object.`);if(!h(t))throw TypeError(`[router.areStatesEqual] Invalid state2: ${_(t)}. Expected State object.`);if(n!==void 0&&!o(n))throw TypeError(`[router.areStatesEqual] Invalid ignoreQueryParams: ${_(n)}. Expected boolean.`)}},eventBus:{validateListenerArgs(e,t){Te(e,t)},validateCountThresholds(t,n,r){let i=e.getOptions().limits?.maxListeners??1e4;Ee(t,n,r,e.logger,i)}}}}function Rt(){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=Lt(r);try{let e=r.routeGetStore(),t=r.dependenciesGetStore(),n=r.getOptions();nt(e),rt(e),it(e),at(e),ot(t),lt(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{Rt as validationPlugin};
|
|
1
|
+
import{RouterError as e,resolveForwardChain as t}from"@real-router/core";import{freezeThrownError as n,putField as r}from"@real-router/core/utils";import{getInternals as i,validateRoute as a}from"@real-router/core/validation";function o(e){return typeof e==`string`}function s(e){return typeof e==`boolean`}function c(e,t){return e in t}const l=Object.getPrototypeOf,u=Object.values,ee=Object.hasOwn;function te(e){if(Array.isArray(e))return!0;let t=l(e);return t===null||t===Object.prototype}function ne(e,t){let n=Array.isArray(e)?e:u(e);for(let e of n)t.push(e)}function re(e){let t=typeof e;return t===`string`||t===`boolean`||t===`number`&&Number.isFinite(e)}var d=class{container;constructor(e){this.container=e}};function ie(e,t,n,r){return n.has(e)?!1:r.has(e)?!0:te(e)?(n.add(e),t.push(new d(e)),ne(e,t),!0):!1}function ae(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(!ie(e,t,n,r))return!1;continue}if(!re(e))return!1}}return!0}function oe(e){if(e==null)return!0;let t=typeof e;return t===`string`||t===`boolean`||t===`number`&&Number.isFinite(e)}function f(e){try{return se(e)}catch{return!1}}function se(e){if(typeof e!=`object`||!e||Array.isArray(e))return!1;let t=l(e);if(t!==null&&t!==Object.prototype)return!1;let n=!1;for(let t in e){if(!ee(e,t))continue;let r=e[t];if(!oe(r)){let e=typeof r;if(e===`function`||e===`symbol`)return!1;n=!0;break}}return!n||ae(e)}const ce=[`replace`,`reload`,`force`,`forceDeactivate`,`redirected`];function le(e){if(typeof e!=`object`||!e||Array.isArray(e))return!1;let t=e;for(let e of ce){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 ue=/\S/,p=/^[A-Z_a-z][\w-]*(?:\.[A-Z_a-z][\w-]*)*$/;function m(e,t){return TypeError(`[router.${e}] ${t}`)}function de(e){return typeof e==`string`?e===``?!0:e.length>1e4?!1:e.startsWith(`@@`)?!0:p.test(e):!1}function fe(e){return de(e.name)&&typeof e.path==`string`&&f(e.params)}function h(e){return typeof e!=`object`||!e?!1:fe(e)}function g(e,t){if(typeof e!=`string`)throw m(t,`Route name must be a string, got ${typeof e}`);if(e!==``){if(!ue.test(e))throw m(t,`Route name cannot contain only whitespace`);if(e.length>1e4)throw m(t,`Route name exceeds maximum length of 10000 characters. This is a technical safety limit.`);if(!e.startsWith(`@@`)&&!p.test(e))throw m(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 _(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 v(e){return{warn:Math.floor(e*.2),error:Math.floor(e*.5)}}const y=Object.keys,b=Object.getOwnPropertyDescriptor,pe=Object.getPrototypeOf,me=Object;function x(e){if(!e||typeof e!=`object`)return!1;let t=pe(e);return t===null||t.constructor===me}function he(e,t){if(typeof e!=`string`)throw TypeError(`[router.${t}] dependency name must be a string, got ${typeof e}`)}function ge(e){if(typeof e!=`string`)throw TypeError(`[router.setDependency] dependency name must be a string, got ${typeof e}`)}function _e(e,t){if(!x(e))throw TypeError(`[router.${t}] Invalid argument: expected plain object, received ${_(e)}`);for(let n of y(e))if(b(e,n)?.get)throw TypeError(`[router.${t}] Getters not allowed: "${n}"`)}function ve(e,t){if(e===void 0)throw ReferenceError(`[router.getDependency] dependency "${t}" not found`)}function ye(e,t,n){let r=e,i=r.limits?.maxDependencies??100;if(i===0)return;let a=y(r.dependencies).length,{warn:o,error:s}=v(i);if(a>=i)throw RangeError(`[router.${t}] Dependency limit exceeded (${i}). Current: ${a}.`);a===s?n.error(`router.${t}`,`${a} dependencies registered! This indicates architectural problems. Hard limit at ${i}.`):a===o&&n.warn(`router.${t}`,`${a} dependencies registered. Consider if all are necessary.`)}function be(e){if(e!==void 0){if(!x(e))throw TypeError(`[cloneRouter] Invalid dependencies: expected plain object or undefined, received ${typeof e}`);for(let t of y(e))if(b(e,t)?.get)throw TypeError(`[cloneRouter] Getters not allowed in dependencies: "${t}"`)}}function xe(e,t,n){n.warn(`router.${t}`,`Router dependency already exists and is being overwritten:`,e)}function Se(e,t,n){n.warn(`router.${t}`,`Overwritten:`,e.join(`, `))}function Ce(e,t){t.warn(`router.removeDependency`,`Attempted to remove non-existent dependency: "${typeof e==`string`?e:String(e)}"`)}const we=new Set([`$start`,`$stop`,`$$start`,`$$leaveApprove`,`$$cancel`,`$$success`,`$$error`]);function Te(e){if(!we.has(e))throw TypeError(`[router.addEventListener] Invalid event name: ${String(e)}. Must be one of: $start, $stop, $$start, $$leaveApprove, $$cancel, $$success, $$error`)}function Ee(e,t){if(Te(e),typeof t!=`function`)throw TypeError(`[router.addEventListener] callback must be a function, got ${typeof t}`)}function De(e,t,n,r,i=1e4){if(i===0)return;let{warn:a,error:o}=v(i);e>=o?r.error(`router.${n}`,`${e} listeners registered for "${t}"! This is excessive. Hard limit at ${i}.`):e>=a&&r.warn(`router.${n}`,`${e} listeners registered for "${t}". Consider whether all are necessary — a growing count usually means a missing unsubscribe.`)}function Oe(e,t){if(!s(e)&&typeof e!=`function`)throw TypeError(`[router.${t}] Handler must be a boolean or factory function, got ${_(e)}`)}function S(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 C(e,t,n,r){if(n===0)return;let{warn:i,error:a}=v(n);e>=a?r.error(`router.${t}`,`${e} lifecycle handlers registered! This is excessive. Hard limit at ${n}.`):e>=i&&r.warn(`router.${t}`,`${e} lifecycle handlers registered. Consider consolidating logic.`)}function w(e,t,n,r){r.warn(`router.${n}`,`Overwriting existing ${t} handler for route "${e}"`)}function T(e,t,n){n.warn(`router.${t}`,`Guard for "${e}" returned a Promise. Sync check cannot resolve async guards — returning false.`)}const ke=Object.hasOwn;function Ae(e){if(typeof e!=`string`)throw TypeError(`[router.navigate] Invalid route name: expected string, got ${_(e)}`)}function je(e){if(e!==void 0&&(typeof e!=`object`||!e))throw TypeError(`[router.navigateToDefault] Invalid options: ${_(e)}. Expected NavigationOptions object.`)}function Me(e){if(typeof e!=`object`||!e)throw TypeError(`[router.navigateToState] Invalid state: ${_(e)}. Expected State object.`);let t=e;if(!o(t.name))throw TypeError(`[router.navigateToState] Invalid state.name: ${_(t.name)}. Expected string.`);if(!f(t.params))throw TypeError(`[router.navigateToState] Invalid state.params: ${_(t.params)}. Expected plain object.`);if(!o(t.path))throw TypeError(`[router.navigateToState] Invalid state.path: ${_(t.path)}. Expected string.`)}function Ne(e,t){if(!le(e))throw TypeError(`[router.${t}] Invalid options: ${_(e)}. Expected NavigationOptions object.`)}const E=/[\u0000-\u001F\u007F]/;function Pe(e,t){for(let n in e){if(!ke(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`&&E.test(r))throw TypeError(`[router.${t}] param "${n}" must not contain control characters (NUL / C0 / DEL) — they corrupt the URL path.`)}}function Fe(e,t){if(e!==void 0&&(typeof e==`object`&&e&&!Array.isArray(e)&&Pe(e,t),!f(e)))throw TypeError(`[router.${t}] params must be a plain object, got ${_(e)}`)}function Ie(e){if(e!==void 0&&typeof e!=`string`)throw TypeError(`[router.start] path must be a string, got ${_(e)}.`);if(typeof e==`string`){if(E.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 D=Object.entries,Le=Object.hasOwn,Re=Object.keys,O={trailingSlash:[`strict`,`never`,`always`,`preserve`],queryParamsMode:[`default`,`strict`,`loose`],urlParamsEncoding:[`default`,`uri`,`uriComponent`,`none`]},k={arrayFormat:[`none`,`brackets`,`index`,`comma`],booleanFormat:[`none`,`auto`,`empty-true`],nullFormat:[`default`,`hidden`],numberFormat:[`none`,`auto`]},ze=new Set([`defaultRoute`,`defaultParams`,`defaultSearch`,`trailingSlash`,`caseSensitive`,`queryParamsMode`,`queryParams`,`urlParamsEncoding`,`allowNotFound`,`rewritePathOnMatch`,`logger`,`limits`]),A={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 Be(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=A[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 Ve(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 D(e)){if(!Le(A,n))throw TypeError(`[router.${t}] unknown limit: "${n}"`);r!==void 0&&Be(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 j(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 He(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 M(e,t,n){if(e!==void 0&&typeof e!=`function`&&(!e||typeof e!=`object`||Array.isArray(e)||e.constructor!==Object))throw TypeError(`[router.${n}] Invalid "${t}": expected plain object or function, got ${typeof e}`)}function Ue(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 D(n)){if(!c(e,k))throw TypeError(`[router.${t}] Invalid "queryParams.${e}": unknown option`);j(r,`queryParams.${e}`,k[e],t)}}function We(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 Re(n))if(!ze.has(e))throw TypeError(`[router.${t}] Unknown option: "${e}"`);if(He(n.defaultRoute,t),M(n.defaultParams,`defaultParams`,t),M(n.defaultSearch,`defaultSearch`,t),j(n.trailingSlash,`trailingSlash`,O.trailingSlash,t),j(n.queryParamsMode,`queryParamsMode`,O.queryParamsMode,t),j(n.urlParamsEncoding,`urlParamsEncoding`,O.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}`);Ue(n.queryParams,t),n.limits!==void 0&&Ve(n.limits,t)}const Ge=Object.hasOwn,N=`router.usePlugin`,Ke={onStart:!0,onStop:!0,onTransitionStart:!0,onTransitionLeaveApprove:!0,onTransitionSuccess:!0,onTransitionError:!0,onTransitionCancel:!0};function qe(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 Ye(e,t,n){if(t===0)return;let{warn:r,error:i}=v(t);e>=i?n.error(N,`${e} plugins registered! This is excessive. Hard limit at ${t}.`):e>=r&&n.warn(N,`${e} plugins registered. Consider if all are necessary.`)}function Xe(e){for(let t in e)if(!(t===`teardown`||Ge(Ke,t)))throw TypeError(`[router.usePlugin] Unknown property '${t}'. Plugin must only contain event handlers and optional teardown.`)}function Ze(e){e.warn(N,`Duplicate factory in batch, will be registered once`)}function Qe(e,t){t.warn(N,`Property '${e}' is not a function, skipping`)}function $e(e,t){e===`onStart`&&t.warn(N,`Router already started, onStart will not be called`)}function et(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}`)}const P=Object.entries,tt=Object.getOwnPropertyDescriptor,F=Object.keys;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 nt(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);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 rt(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(typeof e.path!=`string`)throw TypeError(`[validation-plugin] validateExistingRoutes: route "${t}" has non-string path (${typeof e.path})`)})}function it(e){let{config:t,tree:n,matcher:r}=I(e,`validateForwardToConsistency`);for(let[e,i]of P(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 F(t.forwardMap))nt(e,t.forwardMap)}function at(e){let{config:t}=I(e,`validateRoutePropertiesStore`);for(let[e,n]of P(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 P(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 P(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 P(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 ot(e){let{config:t,tree:n}=I(e,`validateForwardToTargetsStore`);for(let[e,r]of P(t.forwardMap))if(!R(n,r))throw Error(`[validation-plugin] validateForwardToTargetsStore: forwardTo target "${r}" does not exist for route "${e}"`)}function st(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 F(n))if(tt(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(!Number.isInteger(r[e]))throw TypeError(`[validation-plugin] validateDependenciesStructure: deps.limits.${e} must be an integer, got ${String(r[e])}`)}function ct(e){let t=e&&typeof e==`object`?e:{};return t.limits&&typeof t.limits==`object`?t.limits:{}}function lt(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=F(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 ut(e,t){lt(t,ct(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}"`)}const dt=Object.keys;function ft(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 ${_(e.canActivate)}`);if(e.canDeactivate!==void 0&&typeof e.canDeactivate!=`function`)throw TypeError(`[router.addRoute] canDeactivate must be a function for route "${t}", got ${_(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 ${_(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(ft(e.forwardTo,t),e.children)for(let n of e.children)H(n,`${t}.${n.name}`)}function pt(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 pt(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);return t}function mt(e,t,n,r){return t?q(n.getSegmentsByName(e)??[]):U(W(r,e))}const ht=new Set;function gt(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=[...mt(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 _t(e,n,i,a){let o=G(e),s=a?new Set([...o].map(e=>`${a}.${e}`)):o,c=a?q(i.getSegmentsByName(a)):ht,l=K(e),u={...n};for(let[e,t]of l)r(u,e,t);for(let[t,n]of l)gt(t,n,e,s,i,c);for(let e of dt(u))t(e,u)}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 vt(e){g(e,`removeRoute`)}function yt(e){if(typeof e!=`string`)throw TypeError(`[router.setRootPath] rootPath must be a string, got ${_(e)}`)}function X(e){return e.constructor.name===`AsyncFunction`||String(e).includes(`__awaiter`)}function bt(e){let t=e;if(t.canActivate!==void 0&&typeof t.canActivate!=`function`)throw TypeError(`[router.addRoute] canActivate must be a function, got ${_(t.canActivate)}`);if(t.canDeactivate!==void 0&&typeof t.canDeactivate!=`function`)throw TypeError(`[router.addRoute] canDeactivate must be a function, got ${_(t.canDeactivate)}`)}function xt(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 St(e){for(let t of e){if(typeof t!=`object`||!t||Array.isArray(t))throw TypeError(`[router.addRoute] Route must be an object, got ${_(t)}`);H(t,t.name)}}function Ct(e){if(typeof e!=`string`||e===``)throw TypeError(`[router.addRoute] parent option must be a non-empty string, got ${_(e)}`);g(e,`addRoute`)}function wt(e,t,n,r){if(!o(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 ${_(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 Tt(e,t,n){if(!o(e))throw TypeError(`[router.${n}] Invalid routeName: ${_(e)}. Expected string.`);if(!f(t))throw TypeError(`[router.${n}] Invalid routeParams: ${_(t)}. Expected plain object.`)}function Et(e,t){if(g(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 ${_(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 $(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 ${_(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 ${_(t)}`);Q(n,`decodeParams`),Q(r,`encodeParams`)}function Dt(e){if(!o(e)||e===``)throw TypeError(`[router.buildPath] route must be a non-empty string, got ${typeof e==`string`?`""`:typeof e}`)}function Ot(e){if(!o(e))throw TypeError(`[router.matchPath] path must be a string, got ${typeof e}`)}function kt(e){if(!o(e))throw TypeError(`[router.shouldUpdateNode] nodeName must be a string, got ${typeof e}`)}function At(e,t,n,r,i){if(i&&t){let e=t;for(let t of i.split(`.`))if(e=e.children.get(t),!e)throw ReferenceError(`[router.addRoute] Parent route "${i}" does not exist`)}let o=new Set,s=new Map;for(let n of e)a(n,`addRoute`,t,i??``,o,s);n&&r&&_t(e,r,n,i)}function jt(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=jt(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 Nt(e,n,r){t(e,{...r.forwardMap,[e]:n})}function Pt(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),Nt(e,t,i)}}function Ft(e,t,n){if(!o(e))throw TypeError(`[router.makeState] Invalid name: ${_(e)}. Expected string.`);if(t!==void 0&&!f(t))throw TypeError(`[router.makeState] Invalid params: ${_(t)}. Expected plain object.`);if(n!==void 0&&!o(n))throw TypeError(`[router.makeState] Invalid path: ${_(n)}. Expected string.`)}function It(){let e=new Set;return function(t,n){let r=`${t} ${n}`;e.has(r)||(e.add(r),console.warn(`[router] Query key "${n}" is not declared on route "${t}" (\`?${n}\`), so the current \`queryParamsMode\` will not print it — it was dropped from \`state.search\` rather than published beside a \`state.path\` that cannot show it. Declare it on the route path, or use \`queryParamsMode: "loose"\` to keep undeclared keys. A \`defaultSearch\` entry for "${n}" is dead config in this mode for the same reason.`))}}function Lt(){let e=new Set;return function(t,n){let r=`${t} ${n}`;e.has(r)||(e.add(r),console.warn(`[router] Param "${n}" is declared nowhere on route "${t}" — neither as a path slot (:${n}) nor as a query param (?${n}), so it stays in state.params but never reaches the URL. The state will not round-trip: matchPath(state.path) cannot recover it. Declare it on the route path if it belongs in the URL, or pass it through the search channel; keep it here only if it is deliberately app-level data.`))}}function Rt(e){return{routes:{validateBuildPathArgs:Dt,validateMatchPathArgs:Ot,validateIsActiveRouteArgs:wt,validateShouldUpdateNodeArgs:kt,validateStateBuilderArgs:Tt,validateAddRouteArgs(e){St(e)},validateRoutes(e,t,n){let r=t;At(e,r.tree,r.matcher,r.config?.forwardMap,n)},validateRemoveRouteArgs:vt,validateUpdateRouteBasicArgs:Et,validateUpdateRoutePropertyTypes(e,t){let n=t;$(n.forwardTo,n.defaultParams,n.decodeParams,n.encodeParams)},validateUpdateRoute(e,t,n){let r=n,i=t.forwardTo;Pt(e,i,e=>r.matcher.hasRoute(e),r.matcher,r.config)},validateParentOption(e,t){Ct(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){g(e,t)},throwIfInternalRoute(e,t){J(e,t)},throwIfInternalRouteInArray(e,t){Y(e,t)},validateSetRootPathArgs:yt,guardRouteCallbacks:bt,guardNoAsyncCallbacks:xt},options:{validateOptions:We,validateResolvedDefaultRoute:V},dependencies:{validateDependencyName:he,validateSetDependencyArgs(e,t,n){ge(e)},validateDependenciesObject:_e,validateDependencyExists(e,t){let n=t.dependencies?.[e];ve(n,e)},validateDependencyCount(t,n){ye(t,n,e.logger)},validateCloneArgs:be,warnOverwrite(t,n){xe(t,n,e.logger)},warnBatchOverwrite(t,n){Se(t,n,e.logger)},warnRemoveNonExistent(t){Ce(t,e.logger)}},plugins:{validatePluginLimit(e,t){qe(e,1,t?.maxPlugins)},validateNoDuplicatePlugins:Je,validatePluginKeys:Xe,validateCountThresholds(t){Ye(t,e.getOptions().limits?.maxPlugins??50,e.logger)},warnBatchDuplicates(){Ze(e.logger)},warnPluginMethodType(t){Qe(t,e.logger)},warnPluginAfterStart(t){$e(t,e.logger)},validateAddInterceptorArgs:et},lifecycle:{validateHandler:Oe,validateHandlerLimit(t,n){S(t,n,e.getOptions().limits?.maxLifecycleHandlers??200)},validateCountThresholds(t,n){C(t,n,e.getOptions().limits?.maxLifecycleHandlers??200,e.logger)},warnOverwrite(t,n,r){w(t,n,r,e.logger)},warnAsyncGuardSync(t,n){T(t,n,e.logger)}},navigation:{validateNavigateArgs:Ae,validateNavigateToDefaultArgs:je,validateNavigateToStateArgs:Me,validateNavigationOptions:Ne,validateParams:Fe,validateStartArgs:Ie},state:{validateMakeStateArgs:Ft,reportDroppedQueryKey:It(),reportUndeclaredParamKey:Lt(),validateAreStatesEqualArgs(e,t,n){if(!h(e))throw TypeError(`[router.areStatesEqual] Invalid state1: ${_(e)}. Expected State object.`);if(!h(t))throw TypeError(`[router.areStatesEqual] Invalid state2: ${_(t)}. Expected State object.`);if(n!==void 0&&!s(n))throw TypeError(`[router.areStatesEqual] Invalid ignoreQueryParams: ${_(n)}. Expected boolean.`)}},eventBus:{validateListenerArgs(e,t){Ee(e,t)},validateCountThresholds(t,n,r){let i=e.getOptions().limits?.maxListeners??1e4;De(t,n,r,e.logger,i)}}}}function zt(){return t=>{let r=i(t);if(t.isActive())throw n(new e(`VALIDATION_PLUGIN_AFTER_START`,{message:`validation-plugin must be registered before router.start()`}));r.validator=Rt(r);try{let e=r.routeGetStore(),t=r.dependenciesGetStore(),n=r.getOptions();rt(e),it(e),at(e),ot(e),st(t),ut(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{zt as validationPlugin};
|
|
2
2
|
//# sourceMappingURL=index.mjs.map
|