@devp0nt/route0 1.0.0-next.64 → 1.0.0-next.66

package/dist/cjs/index.cjs

@@ -33,7 +33,7 @@ class Route0 {
   get origin() {
     if (!this._origin) {
       throw new Error(
-        "origin for route " + this.definition + ' is not set, please provide it like Route0.create(route, {origin: "https://example.com"}) in config or set via overrides like routes._.override({origin: "https://example.com"})'
+        "origin for route " + this.definition + ' is not set, please provide it like Route0.create(route, {origin: "https://example.com"}) in config or set via clones like routes._.clone({origin: "https://example.com"})'
       );
     }
     return this._origin;
@@ -458,76 +458,171 @@ class Route0 {
       unmatched
     };
   }
-  /**
-   * Safe parser for flat input objects.
-   *
-   * Returns structured success/error result instead of throwing.
-   */
-  safeParseFlatInput(input, loose) {
-    loose ??= this.hasLooseSearch;
+  _validateParamsInput(input) {
     const paramsKeys = this.getParamsKeys();
     if (input === void 0) {
       if (paramsKeys.length) {
         return {
-          success: false,
-          data: void 0,
-          error: new Error(`Missing params: ${paramsKeys.map((k) => `"${k}"`).join(", ")}`)
+          issues: [
+            {
+              message: `Missing params: ${paramsKeys.map((k) => `"${k}"`).join(", ")}`
+            }
+          ]
         };
       }
       input = {};
     }
     if (typeof input !== "object" || input === null) {
       return {
-        success: false,
-        data: void 0,
-        error: new Error("Invalid input: expected object")
+        issues: [{ message: "Invalid input: expected object" }]
       };
     }
-    const inputKeys = Object.keys(input);
+    const inputObj = input;
+    const inputKeys = Object.keys(inputObj);
     const notDefinedKeys = paramsKeys.filter((k) => !inputKeys.includes(k));
     if (notDefinedKeys.length) {
       return {
-        success: false,
-        data: void 0,
-        error: new Error(`Missing params: ${notDefinedKeys.map((k) => `"${k}"`).join(", ")}`)
+        issues: [
+          {
+            message: `Missing params: ${notDefinedKeys.map((k) => `"${k}"`).join(", ")}`
+          }
+        ]
       };
     }
     const data = {};
-    const filterKeys = !loose ? [...paramsKeys, ...this.getSearchKeys()] : false;
-    for (const [k, v] of Object.entries(input)) {
-      if (filterKeys && !filterKeys.includes(k)) {
-        continue;
+    for (const k of paramsKeys) {
+      const v = inputObj[k];
+      if (typeof v === "string") {
+        data[k] = v;
+      } else if (typeof v === "number") {
+        data[k] = String(v);
+      } else {
+        return {
+          issues: [{ message: `Invalid input: expected string, number, got ${typeof v} for "${k}"` }]
+        };
       }
+    }
+    return {
+      value: data
+    };
+  }
+  _validateSearchInput(input, loose) {
+    if (input === void 0) {
+      input = {};
+    }
+    if (typeof input !== "object" || input === null) {
+      return {
+        issues: [{ message: "Invalid input: expected object" }]
+      };
+    }
+    const inputObj = input;
+    const paramsKeys = this.getParamsKeys();
+    const searchKeys = this.getSearchKeys();
+    const data = {};
+    for (const [k, v] of Object.entries(inputObj)) {
+      if (k === "hash") continue;
+      if (paramsKeys.includes(k)) continue;
+      if (!loose && !searchKeys.includes(k)) continue;
+      if (v === void 0) continue;
       if (typeof v === "string") {
         data[k] = v;
       } else if (typeof v === "number") {
         data[k] = String(v);
       } else {
-        const isParamKey = paramsKeys.includes(k);
         return {
-          success: false,
-          data: void 0,
-          error: new Error(
-            `Invalid input: expected string, number,${!isParamKey ? " or undefined," : ""} got ${typeof v} for "${k}"`
-          )
+          issues: [{ message: `Invalid input: expected string, number, or undefined, got ${typeof v} for "${k}"` }]
         };
       }
     }
     return {
-      success: true,
-      data,
-      error: void 0
+      value: data
+    };
+  }
+  _validateFlatInput(input, loose) {
+    const paramsResult = this._validateParamsInput(input);
+    if ("issues" in paramsResult) {
+      return {
+        issues: paramsResult.issues ?? []
+      };
+    }
+    const searchResult = this._validateSearchInput(input, loose);
+    if ("issues" in searchResult) {
+      return {
+        issues: searchResult.issues ?? []
+      };
+    }
+    return {
+      value: {
+        ...searchResult.value,
+        ...paramsResult.value
+      }
     };
   }
-  /** Throwing variant of `safeParseFlatInput()`. */
-  parseFlatInput(input, loose) {
-    loose ??= this.hasLooseSearch;
-    const result = this.safeParseFlatInput(input, loose);
-    if (result.error) {
-      throw result.error;
+  _safeParseSchemaResult(result) {
+    if ("issues" in result) {
+      return {
+        success: false,
+        data: void 0,
+        error: new Error(result.issues?.[0]?.message ?? "Invalid input")
+      };
     }
-    return result.data;
+    return {
+      success: true,
+      data: result.value,
+      error: void 0
+    };
   }
+  _parseSchemaResult(result) {
+    const safeResult = this._safeParseSchemaResult(result);
+    if (safeResult.error) {
+      throw safeResult.error;
+    }
+    return safeResult.data;
+  }
+  /** Standard Schema for route params input. */
+  paramsInputSchema = {
+    "~standard": {
+      version: 1,
+      vendor: "route0",
+      validate: (value) => this._validateParamsInput(value),
+      types: void 0
+    },
+    parse: (value) => this._parseSchemaResult(this._validateParamsInput(value)),
+    safeParse: (value) => this._safeParseSchemaResult(this._validateParamsInput(value))
+  };
+  /** Standard Schema for strict search input. */
+  strictSearchInputSchema = {
+    "~standard": {
+      version: 1,
+      vendor: "route0",
+      validate: (value) => this._validateSearchInput(value, false),
+      types: void 0
+    },
+    parse: (value) => this._parseSchemaResult(this._validateSearchInput(value, false)),
+    safeParse: (value) => this._safeParseSchemaResult(this._validateSearchInput(value, false))
+  };
+  /** Standard Schema for loose search input. */
+  looseSearchInputSchema = {
+    "~standard": {
+      version: 1,
+      vendor: "route0",
+      validate: (value) => this._validateSearchInput(value, true),
+      types: void 0
+    },
+    parse: (value) => this._parseSchemaResult(this._validateSearchInput(value, true)),
+    safeParse: (value) => this._safeParseSchemaResult(this._validateSearchInput(value, true))
+  };
+  /** Standard Schema for route flat input (uses route default strict/loose mode). */
+  flatInputSchema = {
+    "~standard": {
+      version: 1,
+      vendor: "route0",
+      validate: (value) => this._validateFlatInput(value, this.hasLooseSearch),
+      types: void 0
+    },
+    parse: (value) => this._parseSchemaResult(this._validateFlatInput(value, this.hasLooseSearch)),
+    safeParse: (value) => this._safeParseSchemaResult(this._validateFlatInput(value, this.hasLooseSearch))
+  };
   /** True when path structure is equal (param names are ignored). */
   isSame(other) {
     return this.pathDefinition.replace(/:([A-Za-z0-9_]+)/g, "__PARAM__") === other.pathDefinition.replace(/:([A-Za-z0-9_]+)/g, "__PARAM__");
@@ -655,7 +750,7 @@ class Routes {
     this._ = {
       routes: this._routes,
       getLocation: this._getLocation.bind(this),
-      override: this._override.bind(this),
+      clone: this._clone.bind(this),
       pathsOrdering: this._pathsOrdering,
       keysOrdering: this._keysOrdering,
       ordered: this._ordered
@@ -667,7 +762,7 @@ class Routes {
     if (!override) {
       return result;
     }
-    return result._.override(override);
+    return result._.clone(override);
   }
   static prettify(instance) {
     Object.setPrototypeOf(instance, Routes.prototype);
@@ -675,7 +770,7 @@ class Routes {
       value: "Routes"
     });
     Object.assign(instance, {
-      override: instance._override.bind(instance)
+      clone: instance._clone.bind(instance)
     });
     Object.assign(instance, instance._routes);
     return instance;
@@ -724,7 +819,7 @@ class Routes {
     return { pathsOrdering, keysOrdering };
   }
   /** Returns a cloned routes collection with config applied to each route. */
-  _override(config) {
+  _clone(config) {
     const newRoutes = {};
     for (const key in this._routes) {
       if (Object.hasOwn(this._routes, key)) {