@real-router/search-schema-plugin 0.3.0 → 0.3.2

package/dist/cjs/index.js

@@ -1,2 +1,2 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("@real-router/core/api");const t=`[search-schema-plugin]`;function n(e){let t=new Set;for(let n of e)if(n.path&&n.path.length>0){let e=n.path[0],r=typeof e==`object`&&`key`in e?e.key:e;t.add(String(r))}return t}function r(e,t){let n={};for(let r of Object.keys(e))t.has(r)||(n[r]=e[r]);return n}var i=class{#e;#t;#n;#r;#i;#a;#o;constructor(e,t,n){this.#e=e,this.#t=t,this.#n=n.mode??`development`,this.#r=n.strict??!1,this.#i=n.onError,this.#u(),this.#a=this.#e.addInterceptor(`forwardState`,(e,t,n)=>{let r=e(t,n);return this.#l(r)}),this.#o=this.#n===`development`?this.#t.subscribeChanges(e=>{this.#s(e)}):()=>{}}getPlugin(){return{teardown:()=>{this.#a(),this.#o()}}}#s(e){switch(e.op){case`add`:case`replace`:for(let t of e.added)this.#f(t.name);break;case`update`:e.patch.defaultParams!==void 0&&this.#f(e.name);break}}#c(e){return this.#e.getRouteConfig(e)?.searchSchema}#l(e){let i=this.#c(e.name);if(!i)return e;let a=i[`~standard`].validate(e.params);if(a instanceof Promise)throw TypeError(`${t} Async schema validation is not supported. Route "${e.name}" returned a Promise from ~standard.validate().`);if(`value`in a){let t=this.#r?a.value:{...e.params,...a.value};return{...e,params:t}}if(this.#i)return{...e,params:this.#i(e.name,e.params,a.issues)};this.#n===`development`&&console.error(`${t} Route "${e.name}": invalid search params`,a.issues);let o=n(a.issues),s=r(e.params,o),c=this.#t.get(e.name)?.defaultParams,l=c?{...c,...s}:s;return{...e,params:l}}#u(){if(this.#n!==`development`)return;let e=this.#e.getTree();e&&this.#d(e)}#d(e){if(e.fullName&&this.#f(e.fullName),e.children instanceof Map)for(let t of e.children.values())t&&typeof t==`object`&&this.#d(t)}#f(e){let n=this.#c(e);if(!n)return;let r=this.#t.get(e)?.defaultParams;if(!r)return;let i=n[`~standard`].validate(r);i instanceof Promise||`issues`in i&&console.warn(`${t} Route "${e}": defaultParams do not pass searchSchema`,i.issues)}};const a=new Set([`development`,`production`]);function o(e){if(e.mode!==void 0&&!a.has(e.mode))throw TypeError(`${t} Invalid mode: "${e.mode}". Must be "development" or "production".`);if(e.strict!==void 0&&typeof e.strict!=`boolean`)throw TypeError(`${t} Invalid strict option: expected boolean, got ${typeof e.strict}.`);if(e.onError!==void 0&&typeof e.onError!=`function`)throw TypeError(`${t} Invalid onError: expected function, got ${typeof e.onError}.`)}function s(t={}){o(t);let n=Object.freeze({...t});return t=>new i((0,e.getPluginApi)(t),(0,e.getRoutesApi)(t),n).getPlugin()}exports.searchSchemaPlugin=s;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("@real-router/core/api");const t=`[search-schema-plugin]`;function n(e){let t=new Set;for(let n of e)if(n.path&&n.path.length>0){let e=n.path[0],r=typeof e==`object`&&`key`in e?e.key:e;t.add(String(r))}return t}function r(e,t){let n={};for(let[r,i]of Object.entries(e))t.has(r)||(n[r]=i);return n}var i=class{#e;#t;#n;#r;#i;#a;#o;constructor(e,t,n){this.#e=e,this.#t=t,this.#n=n.mode??`development`,this.#r=n.strict??!1,this.#i=n.onError,this.#u(),this.#a=this.#e.addInterceptor(`forwardState`,(e,t,n)=>{let r=e(t,n);return this.#l(r)}),this.#o=this.#n===`development`?this.#t.subscribeChanges(e=>{this.#s(e)}):()=>{}}getPlugin(){return{teardown:()=>{this.#a(),this.#o()}}}#s(e){switch(e.op){case`add`:case`replace`:for(let t of e.added)this.#f(t.name);break;case`update`:e.patch.defaultParams!==void 0&&this.#f(e.name);break}}#c(e){return this.#e.getRouteConfig(e)?.searchSchema}#l(e){let i=this.#c(e.name);if(!i)return e;let a=i[`~standard`].validate(e.params);if(a instanceof Promise)throw TypeError(`${t} Async schema validation is not supported. Route "${e.name}" returned a Promise from ~standard.validate().`);if(`value`in a){let t=this.#r?a.value:{...e.params,...a.value};return{...e,params:t}}if(this.#i)return{...e,params:this.#i(e.name,e.params,a.issues)};this.#n===`development`&&console.error(`${t} Route "${e.name}": invalid search params`,a.issues);let o=n(a.issues),s=r(e.params,o),c=this.#t.get(e.name)?.defaultParams,l=c?{...c,...s}:s;return{...e,params:l}}#u(){if(this.#n!==`development`)return;let e=this.#e.getTree();e&&this.#d(e)}#d(e){if(e.fullName&&this.#f(e.fullName),e.children instanceof Map)for(let t of e.children.values())t&&typeof t==`object`&&this.#d(t)}#f(e){let n=this.#c(e);if(!n)return;let r=this.#t.get(e)?.defaultParams;if(!r)return;let i=n[`~standard`].validate(r);i instanceof Promise||`issues`in i&&console.warn(`${t} Route "${e}": defaultParams do not pass searchSchema`,i.issues)}};const a=new Set([`development`,`production`]);function o(e){if(e.mode!==void 0&&!a.has(e.mode))throw TypeError(`${t} Invalid mode: "${e.mode}". Must be "development" or "production".`);if(e.strict!==void 0&&typeof e.strict!=`boolean`)throw TypeError(`${t} Invalid strict option: expected boolean, got ${typeof e.strict}.`);if(e.onError!==void 0&&typeof e.onError!=`function`)throw TypeError(`${t} Invalid onError: expected function, got ${typeof e.onError}.`)}function s(t={}){o(t);let n=Object.freeze({...t});return t=>new i((0,e.getPluginApi)(t),(0,e.getRoutesApi)(t),n).getPlugin()}exports.searchSchemaPlugin=s;
 //# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["#pluginApi","#routesApi","#mode","#strict","#onError","#removeForwardStateInterceptor","#removeChangesSubscription","#validateExistingDefaultParams","#validateState","#onTreeChanged","#validateSingleRouteDefaultParams","#getSchema","#walkTree"],"sources":["../../src/constants.ts","../../src/helpers.ts","../../src/plugin.ts","../../src/validation.ts","../../src/factory.ts"],"sourcesContent":["// packages/search-schema-plugin/src/constants.ts\n\nexport const ERROR_PREFIX = \"[search-schema-plugin]\";\n","// packages/search-schema-plugin/src/helpers.ts\n\nimport type { StandardSchemaV1Issue } from \"./types\";\nimport type { Params } from \"@real-router/core\";\n\n/**\n * Extract top-level keys from validation issues.\n * Only processes issues with a non-empty path — issues without path\n * affect the whole object and can't be stripped by key.\n */\nexport function getInvalidKeys(\n  issues: readonly StandardSchemaV1Issue[],\n): Set<string> {\n  const keys = new Set<string>();\n\n  for (const issue of issues) {\n    if (issue.path && issue.path.length > 0) {\n      const segment = issue.path[0];\n      const key =\n        typeof segment === \"object\" && \"key\" in segment ? segment.key : segment;\n\n      keys.add(String(key));\n    }\n  }\n\n  return keys;\n}\n\n/** Create a shallow copy of params without the specified keys. */\nexport function omitKeys(params: Params, keys: Set<string>): Params {\n  const result: Params = {};\n\n  for (const key of Object.keys(params)) {\n    if (!keys.has(key)) {\n      result[key] = params[key];\n    }\n  }\n\n  return result;\n}\n","import { ERROR_PREFIX } from \"./constants\";\nimport { getInvalidKeys, omitKeys } from \"./helpers\";\n\nimport type {\n  SearchSchemaPluginOptions,\n  StandardSchemaV1,\n  StandardSchemaV1Issue,\n} from \"./types\";\nimport type { Params, Plugin, TreeChangedEvent } from \"@real-router/core\";\nimport type { PluginApi, RoutesApi } from \"@real-router/core/api\";\n\nexport class SearchSchemaPlugin {\n  readonly #pluginApi: PluginApi;\n  readonly #routesApi: RoutesApi;\n  readonly #mode: \"development\" | \"production\";\n  readonly #strict: boolean;\n  readonly #onError:\n    | ((\n        routeName: string,\n        params: Params,\n        issues: readonly StandardSchemaV1Issue[],\n      ) => Params)\n    | undefined;\n  readonly #removeForwardStateInterceptor: () => void;\n  readonly #removeChangesSubscription: () => void;\n\n  constructor(\n    pluginApi: PluginApi,\n    routesApi: RoutesApi,\n    options: SearchSchemaPluginOptions,\n  ) {\n    this.#pluginApi = pluginApi;\n    this.#routesApi = routesApi;\n    this.#mode = options.mode ?? \"development\";\n    this.#strict = options.strict ?? false;\n    this.#onError = options.onError;\n\n    this.#validateExistingDefaultParams();\n\n    this.#removeForwardStateInterceptor = this.#pluginApi.addInterceptor(\n      \"forwardState\",\n      (next, routeName, routeParams) => {\n        const result = next(routeName, routeParams);\n\n        return this.#validateState(result);\n      },\n    );\n\n    // Dev-time defaultParams validation for runtime tree mutations. Replaces the\n    // old `add` interceptor: TREE_CHANGED additionally covers `update` (changed\n    // defaultParams) and `replace` (new route set) — the gap the interceptor\n    // could not reach. Production mode skips the subscription entirely.\n    this.#removeChangesSubscription =\n      this.#mode === \"development\"\n        ? this.#routesApi.subscribeChanges((event) => {\n            this.#onTreeChanged(event);\n          })\n        : () => {};\n  }\n\n  getPlugin(): Plugin {\n    return {\n      teardown: () => {\n        this.#removeForwardStateInterceptor();\n        this.#removeChangesSubscription();\n      },\n    };\n  }\n\n  #onTreeChanged(event: TreeChangedEvent): void {\n    switch (event.op) {\n      case \"add\":\n      case \"replace\": {\n        // `added` is FLAT (full dotted names, descendants included).\n        for (const route of event.added) {\n          this.#validateSingleRouteDefaultParams(route.name);\n        }\n\n        break;\n      }\n      case \"update\": {\n        // Only a defaultParams change can newly violate the schema.\n        if (event.patch.defaultParams !== undefined) {\n          this.#validateSingleRouteDefaultParams(event.name);\n        }\n\n        break;\n      }\n      // \"remove\" / \"clear\": the routes are gone — nothing to validate.\n    }\n  }\n\n  #getSchema(routeName: string): StandardSchemaV1 | undefined {\n    return this.#pluginApi.getRouteConfig(routeName)?.searchSchema as\n      | StandardSchemaV1\n      | undefined;\n  }\n\n  #validateState(result: { name: string; params: Params }): {\n    name: string;\n    params: Params;\n  } {\n    const schema = this.#getSchema(result.name);\n\n    if (!schema) {\n      return result;\n    }\n\n    const validation = schema[\"~standard\"].validate(result.params);\n\n    if (validation instanceof Promise) {\n      throw new TypeError(\n        `${ERROR_PREFIX} Async schema validation is not supported. Route \"${result.name}\" returned a Promise from ~standard.validate().`,\n      );\n    }\n\n    if (\"value\" in validation) {\n      const params = this.#strict\n        ? (validation.value as Params)\n        : { ...result.params, ...(validation.value as Params) };\n\n      return { ...result, params };\n    }\n\n    if (this.#onError) {\n      return {\n        ...result,\n        params: this.#onError(result.name, result.params, validation.issues),\n      };\n    }\n\n    if (this.#mode === \"development\") {\n      console.error(\n        `${ERROR_PREFIX} Route \"${result.name}\": invalid search params`,\n        validation.issues,\n      );\n    }\n\n    const invalidKeys = getInvalidKeys(validation.issues);\n    const stripped = omitKeys(result.params, invalidKeys);\n    const route = this.#routesApi.get(result.name);\n    const defaults = route?.defaultParams;\n    const restored = defaults ? { ...defaults, ...stripped } : stripped;\n\n    return { ...result, params: restored };\n  }\n\n  #validateExistingDefaultParams(): void {\n    if (this.#mode !== \"development\") {\n      return;\n    }\n\n    const tree = this.#pluginApi.getTree() as unknown as\n      | { fullName?: string; children?: ReadonlyMap<string, unknown> }\n      | undefined;\n\n    /* v8 ignore next -- @preserve: getTree() always returns a RouteTree, defensive check */\n    if (!tree) {\n      return;\n    }\n\n    this.#walkTree(tree);\n  }\n\n  #walkTree(node: {\n    fullName?: string;\n    children?: ReadonlyMap<string, unknown>;\n  }): void {\n    if (node.fullName) {\n      this.#validateSingleRouteDefaultParams(node.fullName);\n    }\n\n    /* v8 ignore next 3 -- @preserve: children is always a Map in RouteTree */\n    if (node.children instanceof Map) {\n      for (const child of node.children.values()) {\n        if (child && typeof child === \"object\") {\n          this.#walkTree(\n            child as {\n              fullName?: string;\n              children?: ReadonlyMap<string, unknown>;\n            },\n          );\n        }\n      }\n    }\n  }\n\n  #validateSingleRouteDefaultParams(routeName: string): void {\n    const schema = this.#getSchema(routeName);\n\n    if (!schema) {\n      return;\n    }\n\n    const route = this.#routesApi.get(routeName);\n    const defaultParams = route?.defaultParams;\n\n    if (!defaultParams) {\n      return;\n    }\n\n    const validation = schema[\"~standard\"].validate(defaultParams);\n\n    if (validation instanceof Promise) {\n      return;\n    }\n\n    if (\"issues\" in validation) {\n      console.warn(\n        `${ERROR_PREFIX} Route \"${routeName}\": defaultParams do not pass searchSchema`,\n        validation.issues,\n      );\n    }\n  }\n}\n","import { ERROR_PREFIX } from \"./constants\";\n\nimport type { SearchSchemaPluginOptions } from \"./types\";\n\nconst VALID_MODES = new Set([\"development\", \"production\"]);\n\nexport function validateOptions(options: SearchSchemaPluginOptions): void {\n  if (options.mode !== undefined && !VALID_MODES.has(options.mode)) {\n    throw new TypeError(\n      `${ERROR_PREFIX} Invalid mode: \"${options.mode}\". Must be \"development\" or \"production\".`,\n    );\n  }\n\n  if (options.strict !== undefined && typeof options.strict !== \"boolean\") {\n    throw new TypeError(\n      `${ERROR_PREFIX} Invalid strict option: expected boolean, got ${typeof options.strict}.`,\n    );\n  }\n\n  if (options.onError !== undefined && typeof options.onError !== \"function\") {\n    throw new TypeError(\n      `${ERROR_PREFIX} Invalid onError: expected function, got ${typeof options.onError}.`,\n    );\n  }\n}\n","import { getPluginApi, getRoutesApi } from \"@real-router/core/api\";\n\nimport { SearchSchemaPlugin } from \"./plugin\";\nimport { validateOptions } from \"./validation\";\n\nimport type { SearchSchemaPluginOptions } from \"./types\";\nimport type { PluginFactory, Plugin } from \"@real-router/core\";\n\nexport function searchSchemaPlugin(\n  options: SearchSchemaPluginOptions = {},\n): PluginFactory {\n  validateOptions(options);\n\n  const frozenOptions: SearchSchemaPluginOptions = Object.freeze({\n    ...options,\n  });\n\n  return (router): Plugin => {\n    const pluginApi = getPluginApi(router);\n    const routesApi = getRoutesApi(router);\n    const plugin = new SearchSchemaPlugin(pluginApi, routesApi, frozenOptions);\n\n    return plugin.getPlugin();\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["#pluginApi","#routesApi","#mode","#strict","#onError","#removeForwardStateInterceptor","#removeChangesSubscription","#validateExistingDefaultParams","#validateState","#onTreeChanged","#validateSingleRouteDefaultParams","#getSchema","#walkTree"],"sources":["../../src/constants.ts","../../src/helpers.ts","../../src/plugin.ts","../../src/validation.ts","../../src/factory.ts"],"sourcesContent":["// packages/search-schema-plugin/src/constants.ts\n\nexport const ERROR_PREFIX = \"[search-schema-plugin]\";\n","// packages/search-schema-plugin/src/helpers.ts\n\nimport type { StandardSchemaV1Issue } from \"./types\";\nimport type { Params } from \"@real-router/core\";\n\n/**\n * Extract top-level keys from validation issues.\n * Only processes issues with a non-empty path — issues without path\n * affect the whole object and can't be stripped by key.\n */\nexport function getInvalidKeys(\n  issues: readonly StandardSchemaV1Issue[],\n): Set<string> {\n  const keys = new Set<string>();\n\n  for (const issue of issues) {\n    if (issue.path && issue.path.length > 0) {\n      const segment = issue.path[0];\n      const key =\n        typeof segment === \"object\" && \"key\" in segment ? segment.key : segment;\n\n      keys.add(String(key));\n    }\n  }\n\n  return keys;\n}\n\n/** Create a shallow copy of params without the specified keys. */\nexport function omitKeys(params: Params, keys: Set<string>): Params {\n  const result: Params = {};\n\n  for (const [key, value] of Object.entries(params)) {\n    if (!keys.has(key)) {\n      result[key] = value;\n    }\n  }\n\n  return result;\n}\n","import { ERROR_PREFIX } from \"./constants\";\nimport { getInvalidKeys, omitKeys } from \"./helpers\";\n\nimport type {\n  SearchSchemaPluginOptions,\n  StandardSchemaV1,\n  StandardSchemaV1Issue,\n} from \"./types\";\nimport type { Params, Plugin, TreeChangedEvent } from \"@real-router/core\";\nimport type { PluginApi, RoutesApi } from \"@real-router/core/api\";\n\nexport class SearchSchemaPlugin {\n  readonly #pluginApi: PluginApi;\n  readonly #routesApi: RoutesApi;\n  readonly #mode: \"development\" | \"production\";\n  readonly #strict: boolean;\n  readonly #onError:\n    | ((\n        routeName: string,\n        params: Params,\n        issues: readonly StandardSchemaV1Issue[],\n      ) => Params)\n    | undefined;\n  readonly #removeForwardStateInterceptor: () => void;\n  readonly #removeChangesSubscription: () => void;\n\n  constructor(\n    pluginApi: PluginApi,\n    routesApi: RoutesApi,\n    options: SearchSchemaPluginOptions,\n  ) {\n    this.#pluginApi = pluginApi;\n    this.#routesApi = routesApi;\n    this.#mode = options.mode ?? \"development\";\n    this.#strict = options.strict ?? false;\n    this.#onError = options.onError;\n\n    this.#validateExistingDefaultParams();\n\n    this.#removeForwardStateInterceptor = this.#pluginApi.addInterceptor(\n      \"forwardState\",\n      (next, routeName, routeParams) => {\n        const result = next(routeName, routeParams);\n\n        return this.#validateState(result);\n      },\n    );\n\n    // Dev-time defaultParams validation for runtime tree mutations. Replaces the\n    // old `add` interceptor: TREE_CHANGED additionally covers `update` (changed\n    // defaultParams) and `replace` (new route set) — the gap the interceptor\n    // could not reach. Production mode skips the subscription entirely.\n    this.#removeChangesSubscription =\n      this.#mode === \"development\"\n        ? this.#routesApi.subscribeChanges((event) => {\n            this.#onTreeChanged(event);\n          })\n        : () => {};\n  }\n\n  getPlugin(): Plugin {\n    return {\n      teardown: () => {\n        this.#removeForwardStateInterceptor();\n        this.#removeChangesSubscription();\n      },\n    };\n  }\n\n  #onTreeChanged(event: TreeChangedEvent): void {\n    switch (event.op) {\n      case \"add\":\n      case \"replace\": {\n        // `added` is FLAT (full dotted names, descendants included).\n        for (const route of event.added) {\n          this.#validateSingleRouteDefaultParams(route.name);\n        }\n\n        break;\n      }\n      case \"update\": {\n        // Only a defaultParams change can newly violate the schema.\n        if (event.patch.defaultParams !== undefined) {\n          this.#validateSingleRouteDefaultParams(event.name);\n        }\n\n        break;\n      }\n      // \"remove\" / \"clear\": the routes are gone — nothing to validate.\n    }\n  }\n\n  #getSchema(routeName: string): StandardSchemaV1 | undefined {\n    return this.#pluginApi.getRouteConfig(routeName)?.searchSchema as\n      | StandardSchemaV1\n      | undefined;\n  }\n\n  #validateState(result: { name: string; params: Params }): {\n    name: string;\n    params: Params;\n  } {\n    const schema = this.#getSchema(result.name);\n\n    if (!schema) {\n      return result;\n    }\n\n    const validation = schema[\"~standard\"].validate(result.params);\n\n    if (validation instanceof Promise) {\n      throw new TypeError(\n        `${ERROR_PREFIX} Async schema validation is not supported. Route \"${result.name}\" returned a Promise from ~standard.validate().`,\n      );\n    }\n\n    if (\"value\" in validation) {\n      const params = this.#strict\n        ? (validation.value as Params)\n        : { ...result.params, ...(validation.value as Params) };\n\n      return { ...result, params };\n    }\n\n    if (this.#onError) {\n      return {\n        ...result,\n        params: this.#onError(result.name, result.params, validation.issues),\n      };\n    }\n\n    if (this.#mode === \"development\") {\n      console.error(\n        `${ERROR_PREFIX} Route \"${result.name}\": invalid search params`,\n        validation.issues,\n      );\n    }\n\n    const invalidKeys = getInvalidKeys(validation.issues);\n    const stripped = omitKeys(result.params, invalidKeys);\n    const route = this.#routesApi.get(result.name);\n    const defaults = route?.defaultParams;\n    const restored = defaults ? { ...defaults, ...stripped } : stripped;\n\n    return { ...result, params: restored };\n  }\n\n  #validateExistingDefaultParams(): void {\n    if (this.#mode !== \"development\") {\n      return;\n    }\n\n    const tree = this.#pluginApi.getTree() as unknown as\n      | { fullName?: string; children?: ReadonlyMap<string, unknown> }\n      | undefined;\n\n    /* v8 ignore next -- @preserve: getTree() always returns a RouteTree, defensive check */\n    if (!tree) {\n      return;\n    }\n\n    this.#walkTree(tree);\n  }\n\n  #walkTree(node: {\n    fullName?: string;\n    children?: ReadonlyMap<string, unknown>;\n  }): void {\n    if (node.fullName) {\n      this.#validateSingleRouteDefaultParams(node.fullName);\n    }\n\n    /* v8 ignore next 3 -- @preserve: children is always a Map in RouteTree */\n    if (node.children instanceof Map) {\n      for (const child of node.children.values()) {\n        if (child && typeof child === \"object\") {\n          this.#walkTree(\n            child as {\n              fullName?: string;\n              children?: ReadonlyMap<string, unknown>;\n            },\n          );\n        }\n      }\n    }\n  }\n\n  #validateSingleRouteDefaultParams(routeName: string): void {\n    const schema = this.#getSchema(routeName);\n\n    if (!schema) {\n      return;\n    }\n\n    const route = this.#routesApi.get(routeName);\n    const defaultParams = route?.defaultParams;\n\n    if (!defaultParams) {\n      return;\n    }\n\n    const validation = schema[\"~standard\"].validate(defaultParams);\n\n    if (validation instanceof Promise) {\n      return;\n    }\n\n    if (\"issues\" in validation) {\n      console.warn(\n        `${ERROR_PREFIX} Route \"${routeName}\": defaultParams do not pass searchSchema`,\n        validation.issues,\n      );\n    }\n  }\n}\n","import { ERROR_PREFIX } from \"./constants\";\n\nimport type { SearchSchemaPluginOptions } from \"./types\";\n\nconst VALID_MODES = new Set([\"development\", \"production\"]);\n\nexport function validateOptions(options: SearchSchemaPluginOptions): void {\n  if (options.mode !== undefined && !VALID_MODES.has(options.mode)) {\n    throw new TypeError(\n      `${ERROR_PREFIX} Invalid mode: \"${options.mode}\". Must be \"development\" or \"production\".`,\n    );\n  }\n\n  if (options.strict !== undefined && typeof options.strict !== \"boolean\") {\n    throw new TypeError(\n      `${ERROR_PREFIX} Invalid strict option: expected boolean, got ${typeof options.strict}.`,\n    );\n  }\n\n  if (options.onError !== undefined && typeof options.onError !== \"function\") {\n    throw new TypeError(\n      `${ERROR_PREFIX} Invalid onError: expected function, got ${typeof options.onError}.`,\n    );\n  }\n}\n","import { getPluginApi, getRoutesApi } from \"@real-router/core/api\";\n\nimport { SearchSchemaPlugin } from \"./plugin\";\nimport { validateOptions } from \"./validation\";\n\nimport type { SearchSchemaPluginOptions } from \"./types\";\nimport type { PluginFactory, Plugin } from \"@real-router/core\";\n\nexport function searchSchemaPlugin(\n  options: SearchSchemaPluginOptions = {},\n): PluginFactory {\n  validateOptions(options);\n\n  const frozenOptions: SearchSchemaPluginOptions = Object.freeze({\n    ...options,\n  });\n\n  return (router): Plugin => {\n    const pluginApi = getPluginApi(router);\n    const routesApi = getRoutesApi(router);\n    const plugin = new SearchSchemaPlugin(pluginApi, routesApi, frozenOptions);\n\n    return plugin.getPlugin();\n  };\n}\n"],"mappings":"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"}

package/dist/esm/index.mjs

@@ -1,2 +1,2 @@
-import{getPluginApi as e,getRoutesApi as t}from"@real-router/core/api";const n=`[search-schema-plugin]`;function r(e){let t=new Set;for(let n of e)if(n.path&&n.path.length>0){let e=n.path[0],r=typeof e==`object`&&`key`in e?e.key:e;t.add(String(r))}return t}function i(e,t){let n={};for(let r of Object.keys(e))t.has(r)||(n[r]=e[r]);return n}var a=class{#e;#t;#n;#r;#i;#a;#o;constructor(e,t,n){this.#e=e,this.#t=t,this.#n=n.mode??`development`,this.#r=n.strict??!1,this.#i=n.onError,this.#u(),this.#a=this.#e.addInterceptor(`forwardState`,(e,t,n)=>{let r=e(t,n);return this.#l(r)}),this.#o=this.#n===`development`?this.#t.subscribeChanges(e=>{this.#s(e)}):()=>{}}getPlugin(){return{teardown:()=>{this.#a(),this.#o()}}}#s(e){switch(e.op){case`add`:case`replace`:for(let t of e.added)this.#f(t.name);break;case`update`:e.patch.defaultParams!==void 0&&this.#f(e.name);break}}#c(e){return this.#e.getRouteConfig(e)?.searchSchema}#l(e){let t=this.#c(e.name);if(!t)return e;let a=t[`~standard`].validate(e.params);if(a instanceof Promise)throw TypeError(`${n} Async schema validation is not supported. Route "${e.name}" returned a Promise from ~standard.validate().`);if(`value`in a){let t=this.#r?a.value:{...e.params,...a.value};return{...e,params:t}}if(this.#i)return{...e,params:this.#i(e.name,e.params,a.issues)};this.#n===`development`&&console.error(`${n} Route "${e.name}": invalid search params`,a.issues);let o=r(a.issues),s=i(e.params,o),c=this.#t.get(e.name)?.defaultParams,l=c?{...c,...s}:s;return{...e,params:l}}#u(){if(this.#n!==`development`)return;let e=this.#e.getTree();e&&this.#d(e)}#d(e){if(e.fullName&&this.#f(e.fullName),e.children instanceof Map)for(let t of e.children.values())t&&typeof t==`object`&&this.#d(t)}#f(e){let t=this.#c(e);if(!t)return;let r=this.#t.get(e)?.defaultParams;if(!r)return;let i=t[`~standard`].validate(r);i instanceof Promise||`issues`in i&&console.warn(`${n} Route "${e}": defaultParams do not pass searchSchema`,i.issues)}};const o=new Set([`development`,`production`]);function s(e){if(e.mode!==void 0&&!o.has(e.mode))throw TypeError(`${n} Invalid mode: "${e.mode}". Must be "development" or "production".`);if(e.strict!==void 0&&typeof e.strict!=`boolean`)throw TypeError(`${n} Invalid strict option: expected boolean, got ${typeof e.strict}.`);if(e.onError!==void 0&&typeof e.onError!=`function`)throw TypeError(`${n} Invalid onError: expected function, got ${typeof e.onError}.`)}function c(n={}){s(n);let r=Object.freeze({...n});return n=>new a(e(n),t(n),r).getPlugin()}export{c as searchSchemaPlugin};
+import{getPluginApi as e,getRoutesApi as t}from"@real-router/core/api";const n=`[search-schema-plugin]`;function r(e){let t=new Set;for(let n of e)if(n.path&&n.path.length>0){let e=n.path[0],r=typeof e==`object`&&`key`in e?e.key:e;t.add(String(r))}return t}function i(e,t){let n={};for(let[r,i]of Object.entries(e))t.has(r)||(n[r]=i);return n}var a=class{#e;#t;#n;#r;#i;#a;#o;constructor(e,t,n){this.#e=e,this.#t=t,this.#n=n.mode??`development`,this.#r=n.strict??!1,this.#i=n.onError,this.#u(),this.#a=this.#e.addInterceptor(`forwardState`,(e,t,n)=>{let r=e(t,n);return this.#l(r)}),this.#o=this.#n===`development`?this.#t.subscribeChanges(e=>{this.#s(e)}):()=>{}}getPlugin(){return{teardown:()=>{this.#a(),this.#o()}}}#s(e){switch(e.op){case`add`:case`replace`:for(let t of e.added)this.#f(t.name);break;case`update`:e.patch.defaultParams!==void 0&&this.#f(e.name);break}}#c(e){return this.#e.getRouteConfig(e)?.searchSchema}#l(e){let t=this.#c(e.name);if(!t)return e;let a=t[`~standard`].validate(e.params);if(a instanceof Promise)throw TypeError(`${n} Async schema validation is not supported. Route "${e.name}" returned a Promise from ~standard.validate().`);if(`value`in a){let t=this.#r?a.value:{...e.params,...a.value};return{...e,params:t}}if(this.#i)return{...e,params:this.#i(e.name,e.params,a.issues)};this.#n===`development`&&console.error(`${n} Route "${e.name}": invalid search params`,a.issues);let o=r(a.issues),s=i(e.params,o),c=this.#t.get(e.name)?.defaultParams,l=c?{...c,...s}:s;return{...e,params:l}}#u(){if(this.#n!==`development`)return;let e=this.#e.getTree();e&&this.#d(e)}#d(e){if(e.fullName&&this.#f(e.fullName),e.children instanceof Map)for(let t of e.children.values())t&&typeof t==`object`&&this.#d(t)}#f(e){let t=this.#c(e);if(!t)return;let r=this.#t.get(e)?.defaultParams;if(!r)return;let i=t[`~standard`].validate(r);i instanceof Promise||`issues`in i&&console.warn(`${n} Route "${e}": defaultParams do not pass searchSchema`,i.issues)}};const o=new Set([`development`,`production`]);function s(e){if(e.mode!==void 0&&!o.has(e.mode))throw TypeError(`${n} Invalid mode: "${e.mode}". Must be "development" or "production".`);if(e.strict!==void 0&&typeof e.strict!=`boolean`)throw TypeError(`${n} Invalid strict option: expected boolean, got ${typeof e.strict}.`);if(e.onError!==void 0&&typeof e.onError!=`function`)throw TypeError(`${n} Invalid onError: expected function, got ${typeof e.onError}.`)}function c(n={}){s(n);let r=Object.freeze({...n});return n=>new a(e(n),t(n),r).getPlugin()}export{c as searchSchemaPlugin};
 //# sourceMappingURL=index.mjs.map

package/dist/esm/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["#pluginApi","#routesApi","#mode","#strict","#onError","#removeForwardStateInterceptor","#removeChangesSubscription","#validateExistingDefaultParams","#validateState","#onTreeChanged","#validateSingleRouteDefaultParams","#getSchema","#walkTree"],"sources":["../../src/constants.ts","../../src/helpers.ts","../../src/plugin.ts","../../src/validation.ts","../../src/factory.ts"],"sourcesContent":["// packages/search-schema-plugin/src/constants.ts\n\nexport const ERROR_PREFIX = \"[search-schema-plugin]\";\n","// packages/search-schema-plugin/src/helpers.ts\n\nimport type { StandardSchemaV1Issue } from \"./types\";\nimport type { Params } from \"@real-router/core\";\n\n/**\n * Extract top-level keys from validation issues.\n * Only processes issues with a non-empty path — issues without path\n * affect the whole object and can't be stripped by key.\n */\nexport function getInvalidKeys(\n  issues: readonly StandardSchemaV1Issue[],\n): Set<string> {\n  const keys = new Set<string>();\n\n  for (const issue of issues) {\n    if (issue.path && issue.path.length > 0) {\n      const segment = issue.path[0];\n      const key =\n        typeof segment === \"object\" && \"key\" in segment ? segment.key : segment;\n\n      keys.add(String(key));\n    }\n  }\n\n  return keys;\n}\n\n/** Create a shallow copy of params without the specified keys. */\nexport function omitKeys(params: Params, keys: Set<string>): Params {\n  const result: Params = {};\n\n  for (const key of Object.keys(params)) {\n    if (!keys.has(key)) {\n      result[key] = params[key];\n    }\n  }\n\n  return result;\n}\n","import { ERROR_PREFIX } from \"./constants\";\nimport { getInvalidKeys, omitKeys } from \"./helpers\";\n\nimport type {\n  SearchSchemaPluginOptions,\n  StandardSchemaV1,\n  StandardSchemaV1Issue,\n} from \"./types\";\nimport type { Params, Plugin, TreeChangedEvent } from \"@real-router/core\";\nimport type { PluginApi, RoutesApi } from \"@real-router/core/api\";\n\nexport class SearchSchemaPlugin {\n  readonly #pluginApi: PluginApi;\n  readonly #routesApi: RoutesApi;\n  readonly #mode: \"development\" | \"production\";\n  readonly #strict: boolean;\n  readonly #onError:\n    | ((\n        routeName: string,\n        params: Params,\n        issues: readonly StandardSchemaV1Issue[],\n      ) => Params)\n    | undefined;\n  readonly #removeForwardStateInterceptor: () => void;\n  readonly #removeChangesSubscription: () => void;\n\n  constructor(\n    pluginApi: PluginApi,\n    routesApi: RoutesApi,\n    options: SearchSchemaPluginOptions,\n  ) {\n    this.#pluginApi = pluginApi;\n    this.#routesApi = routesApi;\n    this.#mode = options.mode ?? \"development\";\n    this.#strict = options.strict ?? false;\n    this.#onError = options.onError;\n\n    this.#validateExistingDefaultParams();\n\n    this.#removeForwardStateInterceptor = this.#pluginApi.addInterceptor(\n      \"forwardState\",\n      (next, routeName, routeParams) => {\n        const result = next(routeName, routeParams);\n\n        return this.#validateState(result);\n      },\n    );\n\n    // Dev-time defaultParams validation for runtime tree mutations. Replaces the\n    // old `add` interceptor: TREE_CHANGED additionally covers `update` (changed\n    // defaultParams) and `replace` (new route set) — the gap the interceptor\n    // could not reach. Production mode skips the subscription entirely.\n    this.#removeChangesSubscription =\n      this.#mode === \"development\"\n        ? this.#routesApi.subscribeChanges((event) => {\n            this.#onTreeChanged(event);\n          })\n        : () => {};\n  }\n\n  getPlugin(): Plugin {\n    return {\n      teardown: () => {\n        this.#removeForwardStateInterceptor();\n        this.#removeChangesSubscription();\n      },\n    };\n  }\n\n  #onTreeChanged(event: TreeChangedEvent): void {\n    switch (event.op) {\n      case \"add\":\n      case \"replace\": {\n        // `added` is FLAT (full dotted names, descendants included).\n        for (const route of event.added) {\n          this.#validateSingleRouteDefaultParams(route.name);\n        }\n\n        break;\n      }\n      case \"update\": {\n        // Only a defaultParams change can newly violate the schema.\n        if (event.patch.defaultParams !== undefined) {\n          this.#validateSingleRouteDefaultParams(event.name);\n        }\n\n        break;\n      }\n      // \"remove\" / \"clear\": the routes are gone — nothing to validate.\n    }\n  }\n\n  #getSchema(routeName: string): StandardSchemaV1 | undefined {\n    return this.#pluginApi.getRouteConfig(routeName)?.searchSchema as\n      | StandardSchemaV1\n      | undefined;\n  }\n\n  #validateState(result: { name: string; params: Params }): {\n    name: string;\n    params: Params;\n  } {\n    const schema = this.#getSchema(result.name);\n\n    if (!schema) {\n      return result;\n    }\n\n    const validation = schema[\"~standard\"].validate(result.params);\n\n    if (validation instanceof Promise) {\n      throw new TypeError(\n        `${ERROR_PREFIX} Async schema validation is not supported. Route \"${result.name}\" returned a Promise from ~standard.validate().`,\n      );\n    }\n\n    if (\"value\" in validation) {\n      const params = this.#strict\n        ? (validation.value as Params)\n        : { ...result.params, ...(validation.value as Params) };\n\n      return { ...result, params };\n    }\n\n    if (this.#onError) {\n      return {\n        ...result,\n        params: this.#onError(result.name, result.params, validation.issues),\n      };\n    }\n\n    if (this.#mode === \"development\") {\n      console.error(\n        `${ERROR_PREFIX} Route \"${result.name}\": invalid search params`,\n        validation.issues,\n      );\n    }\n\n    const invalidKeys = getInvalidKeys(validation.issues);\n    const stripped = omitKeys(result.params, invalidKeys);\n    const route = this.#routesApi.get(result.name);\n    const defaults = route?.defaultParams;\n    const restored = defaults ? { ...defaults, ...stripped } : stripped;\n\n    return { ...result, params: restored };\n  }\n\n  #validateExistingDefaultParams(): void {\n    if (this.#mode !== \"development\") {\n      return;\n    }\n\n    const tree = this.#pluginApi.getTree() as unknown as\n      | { fullName?: string; children?: ReadonlyMap<string, unknown> }\n      | undefined;\n\n    /* v8 ignore next -- @preserve: getTree() always returns a RouteTree, defensive check */\n    if (!tree) {\n      return;\n    }\n\n    this.#walkTree(tree);\n  }\n\n  #walkTree(node: {\n    fullName?: string;\n    children?: ReadonlyMap<string, unknown>;\n  }): void {\n    if (node.fullName) {\n      this.#validateSingleRouteDefaultParams(node.fullName);\n    }\n\n    /* v8 ignore next 3 -- @preserve: children is always a Map in RouteTree */\n    if (node.children instanceof Map) {\n      for (const child of node.children.values()) {\n        if (child && typeof child === \"object\") {\n          this.#walkTree(\n            child as {\n              fullName?: string;\n              children?: ReadonlyMap<string, unknown>;\n            },\n          );\n        }\n      }\n    }\n  }\n\n  #validateSingleRouteDefaultParams(routeName: string): void {\n    const schema = this.#getSchema(routeName);\n\n    if (!schema) {\n      return;\n    }\n\n    const route = this.#routesApi.get(routeName);\n    const defaultParams = route?.defaultParams;\n\n    if (!defaultParams) {\n      return;\n    }\n\n    const validation = schema[\"~standard\"].validate(defaultParams);\n\n    if (validation instanceof Promise) {\n      return;\n    }\n\n    if (\"issues\" in validation) {\n      console.warn(\n        `${ERROR_PREFIX} Route \"${routeName}\": defaultParams do not pass searchSchema`,\n        validation.issues,\n      );\n    }\n  }\n}\n","import { ERROR_PREFIX } from \"./constants\";\n\nimport type { SearchSchemaPluginOptions } from \"./types\";\n\nconst VALID_MODES = new Set([\"development\", \"production\"]);\n\nexport function validateOptions(options: SearchSchemaPluginOptions): void {\n  if (options.mode !== undefined && !VALID_MODES.has(options.mode)) {\n    throw new TypeError(\n      `${ERROR_PREFIX} Invalid mode: \"${options.mode}\". Must be \"development\" or \"production\".`,\n    );\n  }\n\n  if (options.strict !== undefined && typeof options.strict !== \"boolean\") {\n    throw new TypeError(\n      `${ERROR_PREFIX} Invalid strict option: expected boolean, got ${typeof options.strict}.`,\n    );\n  }\n\n  if (options.onError !== undefined && typeof options.onError !== \"function\") {\n    throw new TypeError(\n      `${ERROR_PREFIX} Invalid onError: expected function, got ${typeof options.onError}.`,\n    );\n  }\n}\n","import { getPluginApi, getRoutesApi } from \"@real-router/core/api\";\n\nimport { SearchSchemaPlugin } from \"./plugin\";\nimport { validateOptions } from \"./validation\";\n\nimport type { SearchSchemaPluginOptions } from \"./types\";\nimport type { PluginFactory, Plugin } from \"@real-router/core\";\n\nexport function searchSchemaPlugin(\n  options: SearchSchemaPluginOptions = {},\n): PluginFactory {\n  validateOptions(options);\n\n  const frozenOptions: SearchSchemaPluginOptions = Object.freeze({\n    ...options,\n  });\n\n  return (router): Plugin => {\n    const pluginApi = getPluginApi(router);\n    const routesApi = getRoutesApi(router);\n    const plugin = new SearchSchemaPlugin(pluginApi, routesApi, frozenOptions);\n\n    return plugin.getPlugin();\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":["#pluginApi","#routesApi","#mode","#strict","#onError","#removeForwardStateInterceptor","#removeChangesSubscription","#validateExistingDefaultParams","#validateState","#onTreeChanged","#validateSingleRouteDefaultParams","#getSchema","#walkTree"],"sources":["../../src/constants.ts","../../src/helpers.ts","../../src/plugin.ts","../../src/validation.ts","../../src/factory.ts"],"sourcesContent":["// packages/search-schema-plugin/src/constants.ts\n\nexport const ERROR_PREFIX = \"[search-schema-plugin]\";\n","// packages/search-schema-plugin/src/helpers.ts\n\nimport type { StandardSchemaV1Issue } from \"./types\";\nimport type { Params } from \"@real-router/core\";\n\n/**\n * Extract top-level keys from validation issues.\n * Only processes issues with a non-empty path — issues without path\n * affect the whole object and can't be stripped by key.\n */\nexport function getInvalidKeys(\n  issues: readonly StandardSchemaV1Issue[],\n): Set<string> {\n  const keys = new Set<string>();\n\n  for (const issue of issues) {\n    if (issue.path && issue.path.length > 0) {\n      const segment = issue.path[0];\n      const key =\n        typeof segment === \"object\" && \"key\" in segment ? segment.key : segment;\n\n      keys.add(String(key));\n    }\n  }\n\n  return keys;\n}\n\n/** Create a shallow copy of params without the specified keys. */\nexport function omitKeys(params: Params, keys: Set<string>): Params {\n  const result: Params = {};\n\n  for (const [key, value] of Object.entries(params)) {\n    if (!keys.has(key)) {\n      result[key] = value;\n    }\n  }\n\n  return result;\n}\n","import { ERROR_PREFIX } from \"./constants\";\nimport { getInvalidKeys, omitKeys } from \"./helpers\";\n\nimport type {\n  SearchSchemaPluginOptions,\n  StandardSchemaV1,\n  StandardSchemaV1Issue,\n} from \"./types\";\nimport type { Params, Plugin, TreeChangedEvent } from \"@real-router/core\";\nimport type { PluginApi, RoutesApi } from \"@real-router/core/api\";\n\nexport class SearchSchemaPlugin {\n  readonly #pluginApi: PluginApi;\n  readonly #routesApi: RoutesApi;\n  readonly #mode: \"development\" | \"production\";\n  readonly #strict: boolean;\n  readonly #onError:\n    | ((\n        routeName: string,\n        params: Params,\n        issues: readonly StandardSchemaV1Issue[],\n      ) => Params)\n    | undefined;\n  readonly #removeForwardStateInterceptor: () => void;\n  readonly #removeChangesSubscription: () => void;\n\n  constructor(\n    pluginApi: PluginApi,\n    routesApi: RoutesApi,\n    options: SearchSchemaPluginOptions,\n  ) {\n    this.#pluginApi = pluginApi;\n    this.#routesApi = routesApi;\n    this.#mode = options.mode ?? \"development\";\n    this.#strict = options.strict ?? false;\n    this.#onError = options.onError;\n\n    this.#validateExistingDefaultParams();\n\n    this.#removeForwardStateInterceptor = this.#pluginApi.addInterceptor(\n      \"forwardState\",\n      (next, routeName, routeParams) => {\n        const result = next(routeName, routeParams);\n\n        return this.#validateState(result);\n      },\n    );\n\n    // Dev-time defaultParams validation for runtime tree mutations. Replaces the\n    // old `add` interceptor: TREE_CHANGED additionally covers `update` (changed\n    // defaultParams) and `replace` (new route set) — the gap the interceptor\n    // could not reach. Production mode skips the subscription entirely.\n    this.#removeChangesSubscription =\n      this.#mode === \"development\"\n        ? this.#routesApi.subscribeChanges((event) => {\n            this.#onTreeChanged(event);\n          })\n        : () => {};\n  }\n\n  getPlugin(): Plugin {\n    return {\n      teardown: () => {\n        this.#removeForwardStateInterceptor();\n        this.#removeChangesSubscription();\n      },\n    };\n  }\n\n  #onTreeChanged(event: TreeChangedEvent): void {\n    switch (event.op) {\n      case \"add\":\n      case \"replace\": {\n        // `added` is FLAT (full dotted names, descendants included).\n        for (const route of event.added) {\n          this.#validateSingleRouteDefaultParams(route.name);\n        }\n\n        break;\n      }\n      case \"update\": {\n        // Only a defaultParams change can newly violate the schema.\n        if (event.patch.defaultParams !== undefined) {\n          this.#validateSingleRouteDefaultParams(event.name);\n        }\n\n        break;\n      }\n      // \"remove\" / \"clear\": the routes are gone — nothing to validate.\n    }\n  }\n\n  #getSchema(routeName: string): StandardSchemaV1 | undefined {\n    return this.#pluginApi.getRouteConfig(routeName)?.searchSchema as\n      | StandardSchemaV1\n      | undefined;\n  }\n\n  #validateState(result: { name: string; params: Params }): {\n    name: string;\n    params: Params;\n  } {\n    const schema = this.#getSchema(result.name);\n\n    if (!schema) {\n      return result;\n    }\n\n    const validation = schema[\"~standard\"].validate(result.params);\n\n    if (validation instanceof Promise) {\n      throw new TypeError(\n        `${ERROR_PREFIX} Async schema validation is not supported. Route \"${result.name}\" returned a Promise from ~standard.validate().`,\n      );\n    }\n\n    if (\"value\" in validation) {\n      const params = this.#strict\n        ? (validation.value as Params)\n        : { ...result.params, ...(validation.value as Params) };\n\n      return { ...result, params };\n    }\n\n    if (this.#onError) {\n      return {\n        ...result,\n        params: this.#onError(result.name, result.params, validation.issues),\n      };\n    }\n\n    if (this.#mode === \"development\") {\n      console.error(\n        `${ERROR_PREFIX} Route \"${result.name}\": invalid search params`,\n        validation.issues,\n      );\n    }\n\n    const invalidKeys = getInvalidKeys(validation.issues);\n    const stripped = omitKeys(result.params, invalidKeys);\n    const route = this.#routesApi.get(result.name);\n    const defaults = route?.defaultParams;\n    const restored = defaults ? { ...defaults, ...stripped } : stripped;\n\n    return { ...result, params: restored };\n  }\n\n  #validateExistingDefaultParams(): void {\n    if (this.#mode !== \"development\") {\n      return;\n    }\n\n    const tree = this.#pluginApi.getTree() as unknown as\n      | { fullName?: string; children?: ReadonlyMap<string, unknown> }\n      | undefined;\n\n    /* v8 ignore next -- @preserve: getTree() always returns a RouteTree, defensive check */\n    if (!tree) {\n      return;\n    }\n\n    this.#walkTree(tree);\n  }\n\n  #walkTree(node: {\n    fullName?: string;\n    children?: ReadonlyMap<string, unknown>;\n  }): void {\n    if (node.fullName) {\n      this.#validateSingleRouteDefaultParams(node.fullName);\n    }\n\n    /* v8 ignore next 3 -- @preserve: children is always a Map in RouteTree */\n    if (node.children instanceof Map) {\n      for (const child of node.children.values()) {\n        if (child && typeof child === \"object\") {\n          this.#walkTree(\n            child as {\n              fullName?: string;\n              children?: ReadonlyMap<string, unknown>;\n            },\n          );\n        }\n      }\n    }\n  }\n\n  #validateSingleRouteDefaultParams(routeName: string): void {\n    const schema = this.#getSchema(routeName);\n\n    if (!schema) {\n      return;\n    }\n\n    const route = this.#routesApi.get(routeName);\n    const defaultParams = route?.defaultParams;\n\n    if (!defaultParams) {\n      return;\n    }\n\n    const validation = schema[\"~standard\"].validate(defaultParams);\n\n    if (validation instanceof Promise) {\n      return;\n    }\n\n    if (\"issues\" in validation) {\n      console.warn(\n        `${ERROR_PREFIX} Route \"${routeName}\": defaultParams do not pass searchSchema`,\n        validation.issues,\n      );\n    }\n  }\n}\n","import { ERROR_PREFIX } from \"./constants\";\n\nimport type { SearchSchemaPluginOptions } from \"./types\";\n\nconst VALID_MODES = new Set([\"development\", \"production\"]);\n\nexport function validateOptions(options: SearchSchemaPluginOptions): void {\n  if (options.mode !== undefined && !VALID_MODES.has(options.mode)) {\n    throw new TypeError(\n      `${ERROR_PREFIX} Invalid mode: \"${options.mode}\". Must be \"development\" or \"production\".`,\n    );\n  }\n\n  if (options.strict !== undefined && typeof options.strict !== \"boolean\") {\n    throw new TypeError(\n      `${ERROR_PREFIX} Invalid strict option: expected boolean, got ${typeof options.strict}.`,\n    );\n  }\n\n  if (options.onError !== undefined && typeof options.onError !== \"function\") {\n    throw new TypeError(\n      `${ERROR_PREFIX} Invalid onError: expected function, got ${typeof options.onError}.`,\n    );\n  }\n}\n","import { getPluginApi, getRoutesApi } from \"@real-router/core/api\";\n\nimport { SearchSchemaPlugin } from \"./plugin\";\nimport { validateOptions } from \"./validation\";\n\nimport type { SearchSchemaPluginOptions } from \"./types\";\nimport type { PluginFactory, Plugin } from \"@real-router/core\";\n\nexport function searchSchemaPlugin(\n  options: SearchSchemaPluginOptions = {},\n): PluginFactory {\n  validateOptions(options);\n\n  const frozenOptions: SearchSchemaPluginOptions = Object.freeze({\n    ...options,\n  });\n\n  return (router): Plugin => {\n    const pluginApi = getPluginApi(router);\n    const routesApi = getRoutesApi(router);\n    const plugin = new SearchSchemaPlugin(pluginApi, routesApi, frozenOptions);\n\n    return plugin.getPlugin();\n  };\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@real-router/search-schema-plugin",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "type": "commonjs",
   "description": "Runtime search parameter validation via Standard Schema for Real-Router",
   "main": "./dist/cjs/index.js",
@@ -18,8 +18,7 @@
     }
   },
   "files": [
-    "dist",
-    "src"
+    "dist"
   ],
   "repository": {
     "type": "git",
@@ -46,7 +45,7 @@
   "homepage": "https://github.com/greydragon888/real-router",
   "sideEffects": false,
   "dependencies": {
-    "@real-router/core": "^0.56.0"
+    "@real-router/core": "^0.58.0"
   },
   "scripts": {
     "test": "vitest",

package/src/constants.ts

@@ -1,3 +0,0 @@
-// packages/search-schema-plugin/src/constants.ts
-
-export const ERROR_PREFIX = "[search-schema-plugin]";

package/src/factory.ts

@@ -1,25 +0,0 @@
-import { getPluginApi, getRoutesApi } from "@real-router/core/api";
-
-import { SearchSchemaPlugin } from "./plugin";
-import { validateOptions } from "./validation";
-
-import type { SearchSchemaPluginOptions } from "./types";
-import type { PluginFactory, Plugin } from "@real-router/core";
-
-export function searchSchemaPlugin(
-  options: SearchSchemaPluginOptions = {},
-): PluginFactory {
-  validateOptions(options);
-
-  const frozenOptions: SearchSchemaPluginOptions = Object.freeze({
-    ...options,
-  });
-
-  return (router): Plugin => {
-    const pluginApi = getPluginApi(router);
-    const routesApi = getRoutesApi(router);
-    const plugin = new SearchSchemaPlugin(pluginApi, routesApi, frozenOptions);
-
-    return plugin.getPlugin();
-  };
-}

package/src/helpers.ts

@@ -1,40 +0,0 @@
-// packages/search-schema-plugin/src/helpers.ts
-
-import type { StandardSchemaV1Issue } from "./types";
-import type { Params } from "@real-router/core";
-
-/**
- * Extract top-level keys from validation issues.
- * Only processes issues with a non-empty path — issues without path
- * affect the whole object and can't be stripped by key.
- */
-export function getInvalidKeys(
-  issues: readonly StandardSchemaV1Issue[],
-): Set<string> {
-  const keys = new Set<string>();
-
-  for (const issue of issues) {
-    if (issue.path && issue.path.length > 0) {
-      const segment = issue.path[0];
-      const key =
-        typeof segment === "object" && "key" in segment ? segment.key : segment;
-
-      keys.add(String(key));
-    }
-  }
-
-  return keys;
-}
-
-/** Create a shallow copy of params without the specified keys. */
-export function omitKeys(params: Params, keys: Set<string>): Params {
-  const result: Params = {};
-
-  for (const key of Object.keys(params)) {
-    if (!keys.has(key)) {
-      result[key] = params[key];
-    }
-  }
-
-  return result;
-}

package/src/index.ts

@@ -1,16 +0,0 @@
-import type { StandardSchemaV1 } from "./types";
-
-export { searchSchemaPlugin } from "./factory";
-
-declare module "@real-router/core" {
-  interface Route {
-    searchSchema?: StandardSchemaV1;
-  }
-}
-
-export type {
-  SearchSchemaPluginOptions,
-  StandardSchemaV1,
-  StandardSchemaV1Issue,
-  StandardSchemaV1Result,
-} from "./types";

package/src/plugin.ts

@@ -1,215 +0,0 @@
-import { ERROR_PREFIX } from "./constants";
-import { getInvalidKeys, omitKeys } from "./helpers";
-
-import type {
-  SearchSchemaPluginOptions,
-  StandardSchemaV1,
-  StandardSchemaV1Issue,
-} from "./types";
-import type { Params, Plugin, TreeChangedEvent } from "@real-router/core";
-import type { PluginApi, RoutesApi } from "@real-router/core/api";
-
-export class SearchSchemaPlugin {
-  readonly #pluginApi: PluginApi;
-  readonly #routesApi: RoutesApi;
-  readonly #mode: "development" | "production";
-  readonly #strict: boolean;
-  readonly #onError:
-    | ((
-        routeName: string,
-        params: Params,
-        issues: readonly StandardSchemaV1Issue[],
-      ) => Params)
-    | undefined;
-  readonly #removeForwardStateInterceptor: () => void;
-  readonly #removeChangesSubscription: () => void;
-
-  constructor(
-    pluginApi: PluginApi,
-    routesApi: RoutesApi,
-    options: SearchSchemaPluginOptions,
-  ) {
-    this.#pluginApi = pluginApi;
-    this.#routesApi = routesApi;
-    this.#mode = options.mode ?? "development";
-    this.#strict = options.strict ?? false;
-    this.#onError = options.onError;
-
-    this.#validateExistingDefaultParams();
-
-    this.#removeForwardStateInterceptor = this.#pluginApi.addInterceptor(
-      "forwardState",
-      (next, routeName, routeParams) => {
-        const result = next(routeName, routeParams);
-
-        return this.#validateState(result);
-      },
-    );
-
-    // Dev-time defaultParams validation for runtime tree mutations. Replaces the
-    // old `add` interceptor: TREE_CHANGED additionally covers `update` (changed
-    // defaultParams) and `replace` (new route set) — the gap the interceptor
-    // could not reach. Production mode skips the subscription entirely.
-    this.#removeChangesSubscription =
-      this.#mode === "development"
-        ? this.#routesApi.subscribeChanges((event) => {
-            this.#onTreeChanged(event);
-          })
-        : () => {};
-  }
-
-  getPlugin(): Plugin {
-    return {
-      teardown: () => {
-        this.#removeForwardStateInterceptor();
-        this.#removeChangesSubscription();
-      },
-    };
-  }
-
-  #onTreeChanged(event: TreeChangedEvent): void {
-    switch (event.op) {
-      case "add":
-      case "replace": {
-        // `added` is FLAT (full dotted names, descendants included).
-        for (const route of event.added) {
-          this.#validateSingleRouteDefaultParams(route.name);
-        }
-
-        break;
-      }
-      case "update": {
-        // Only a defaultParams change can newly violate the schema.
-        if (event.patch.defaultParams !== undefined) {
-          this.#validateSingleRouteDefaultParams(event.name);
-        }
-
-        break;
-      }
-      // "remove" / "clear": the routes are gone — nothing to validate.
-    }
-  }
-
-  #getSchema(routeName: string): StandardSchemaV1 | undefined {
-    return this.#pluginApi.getRouteConfig(routeName)?.searchSchema as
-      | StandardSchemaV1
-      | undefined;
-  }
-
-  #validateState(result: { name: string; params: Params }): {
-    name: string;
-    params: Params;
-  } {
-    const schema = this.#getSchema(result.name);
-
-    if (!schema) {
-      return result;
-    }
-
-    const validation = schema["~standard"].validate(result.params);
-
-    if (validation instanceof Promise) {
-      throw new TypeError(
-        `${ERROR_PREFIX} Async schema validation is not supported. Route "${result.name}" returned a Promise from ~standard.validate().`,
-      );
-    }
-
-    if ("value" in validation) {
-      const params = this.#strict
-        ? (validation.value as Params)
-        : { ...result.params, ...(validation.value as Params) };
-
-      return { ...result, params };
-    }
-
-    if (this.#onError) {
-      return {
-        ...result,
-        params: this.#onError(result.name, result.params, validation.issues),
-      };
-    }
-
-    if (this.#mode === "development") {
-      console.error(
-        `${ERROR_PREFIX} Route "${result.name}": invalid search params`,
-        validation.issues,
-      );
-    }
-
-    const invalidKeys = getInvalidKeys(validation.issues);
-    const stripped = omitKeys(result.params, invalidKeys);
-    const route = this.#routesApi.get(result.name);
-    const defaults = route?.defaultParams;
-    const restored = defaults ? { ...defaults, ...stripped } : stripped;
-
-    return { ...result, params: restored };
-  }
-
-  #validateExistingDefaultParams(): void {
-    if (this.#mode !== "development") {
-      return;
-    }
-
-    const tree = this.#pluginApi.getTree() as unknown as
-      | { fullName?: string; children?: ReadonlyMap<string, unknown> }
-      | undefined;
-
-    /* v8 ignore next -- @preserve: getTree() always returns a RouteTree, defensive check */
-    if (!tree) {
-      return;
-    }
-
-    this.#walkTree(tree);
-  }
-
-  #walkTree(node: {
-    fullName?: string;
-    children?: ReadonlyMap<string, unknown>;
-  }): void {
-    if (node.fullName) {
-      this.#validateSingleRouteDefaultParams(node.fullName);
-    }
-
-    /* v8 ignore next 3 -- @preserve: children is always a Map in RouteTree */
-    if (node.children instanceof Map) {
-      for (const child of node.children.values()) {
-        if (child && typeof child === "object") {
-          this.#walkTree(
-            child as {
-              fullName?: string;
-              children?: ReadonlyMap<string, unknown>;
-            },
-          );
-        }
-      }
-    }
-  }
-
-  #validateSingleRouteDefaultParams(routeName: string): void {
-    const schema = this.#getSchema(routeName);
-
-    if (!schema) {
-      return;
-    }
-
-    const route = this.#routesApi.get(routeName);
-    const defaultParams = route?.defaultParams;
-
-    if (!defaultParams) {
-      return;
-    }
-
-    const validation = schema["~standard"].validate(defaultParams);
-
-    if (validation instanceof Promise) {
-      return;
-    }
-
-    if ("issues" in validation) {
-      console.warn(
-        `${ERROR_PREFIX} Route "${routeName}": defaultParams do not pass searchSchema`,
-        validation.issues,
-      );
-    }
-  }
-}

package/src/types.ts

@@ -1,91 +0,0 @@
-// packages/search-schema-plugin/src/types.ts
-
-import type { Params } from "@real-router/core";
-
-// =============================================================================
-// Standard Schema V1 (inline — zero external deps)
-// https://github.com/standard-schema/standard-schema
-// =============================================================================
-
-/** A single validation issue from Standard Schema V1. */
-export interface StandardSchemaV1Issue {
-  readonly message: string;
-  readonly path?:
-    | readonly (PropertyKey | { readonly key: PropertyKey })[]
-    | undefined;
-}
-
-/** Validation result — either success or failure. */
-export type StandardSchemaV1Result<Output = unknown> =
-  | { readonly value: Output }
-  | { readonly issues: readonly StandardSchemaV1Issue[] };
-
-/**
- * Standard Schema V1 interface.
- *
- * Supported by Zod 3.24+, Valibot 1.0+, ArkType.
- * The plugin doesn't depend on any specific schema library.
- */
-export interface StandardSchemaV1<Input = unknown, Output = Input> {
-  readonly "~standard": {
-    readonly version: 1;
-    readonly vendor: string;
-    readonly validate: (
-      value: unknown,
-    ) =>
-      | StandardSchemaV1Result<Output>
-      | Promise<StandardSchemaV1Result<Output>>;
-    readonly types?:
-      | {
-          readonly input: Input;
-          readonly output: Output;
-        }
-      | undefined;
-  };
-}
-
-// =============================================================================
-// Plugin Options
-// =============================================================================
-
-export interface SearchSchemaPluginOptions {
-  /**
-   * Error handling mode.
-   * - "development" (default): strip invalid + console.error
-   * - "production": silent strip
-   *
-   * For recovery of invalid params use defaultParams (strip + merge + diagnostics).
-   * For filling absent params use .default() in schema (no diagnostics).
-   * .catch() is not recommended — suppresses errors, mode: "development" won't see the issue.
-   */
-  readonly mode?: "development" | "production";
-
-  /**
-   * Strip search params not described in schema.
-   * - false (default): unknown params pass through
-   * - true: unknown params are removed
-   *
-   * Per-route override: .strict() / .passthrough() in Zod schema.
-   */
-  readonly strict?: boolean;
-
-  /**
-   * Custom error handler (overrides mode completely).
-   * Must return cleaned params.
-   *
-   * Contract:
-   * - Returned params are used as-is, without re-validation.
-   *   Responsibility for correctness is on the callback author.
-   *   (Re-validation would risk infinite loops.)
-   * - Exceptions from onError propagate up without suppression.
-   *   Consistent with interceptor behavior in core.
-   * - When onError is set, neither console.error (mode: "development"),
-   *   nor silent strip (mode: "production") are executed.
-   *   All responsibility for diagnostics and recovery is on the callback.
-   */
-  readonly onError?: (
-    routeName: string,
-    params: Params,
-    issues: readonly StandardSchemaV1Issue[],
-  ) => Params;
-}

package/src/validation.ts

@@ -1,25 +0,0 @@
-import { ERROR_PREFIX } from "./constants";
-
-import type { SearchSchemaPluginOptions } from "./types";
-
-const VALID_MODES = new Set(["development", "production"]);
-
-export function validateOptions(options: SearchSchemaPluginOptions): void {
-  if (options.mode !== undefined && !VALID_MODES.has(options.mode)) {
-    throw new TypeError(
-      `${ERROR_PREFIX} Invalid mode: "${options.mode}". Must be "development" or "production".`,
-    );
-  }
-
-  if (options.strict !== undefined && typeof options.strict !== "boolean") {
-    throw new TypeError(
-      `${ERROR_PREFIX} Invalid strict option: expected boolean, got ${typeof options.strict}.`,
-    );
-  }
-
-  if (options.onError !== undefined && typeof options.onError !== "function") {
-    throw new TypeError(
-      `${ERROR_PREFIX} Invalid onError: expected function, got ${typeof options.onError}.`,
-    );
-  }
-}