@rzl-zone/utils-js 3.0.2-beta.2 → 3.1.0

package/dist/isPlainObject-BVhBAPHX.d.ts

@@ -0,0 +1,169 @@
+import{N as NonPlainObject}from'./type-data-DDs-u2kq.js';
+/** Types for **{@link getPreciseType}**. */
+type GetPreciseTypeOptions={
+/** -------------------------------------------------------
+ * * ***Specifies the format in which the returned string type should be transformed.***
+ * -------------------------------------------------------
+ *
+ * ℹ️ For special string literals in `SPECIAL_CASES` (`"-Infinity" | "Infinity" | "NaN"`), which will remain unchanged.
+ * @default "toLowerCase"
+ *
+ * @description
+ * Supported formats:
+ * - `"toLowerCase"` (default) — converts all letters to lowercase.
+ *   - ➔ `"result example type"`
+ * - `"toDotCase"` — words separated by dots.
+ *   - ➔ `"result.example.type"`
+ * - `"toCamelCase"` — first word lowercase, subsequent words capitalized.
+ *   - ➔ `"resultExampleType"`
+ * - `"toKebabCase"` — words separated by hyphens.
+ *   - ➔ `"result-example-type"`
+ * - `"toSnakeCase"` — words separated by underscores.
+ *   - ➔ `"result_example_type"`
+ * - `"toPascalCase"` — all words capitalized, no spaces.
+ *   - ➔ `"ResultExampleType"`
+ * - `"toPascalCaseSpace"` — all words capitalized with spaces between words.
+ *   - ➔ `"Result Example Type"`
+ * - `"slugify"` — URL-friendly slug (lowercase with hyphens).
+ *   - ➔ `"result-example-type"`
+ *
+ * @note
+ * ⚠️ If an invalid value is provided, the function will automatically fallback to the default `"toLowerCase"`.
+ */
+formatCase?:"toPascalCaseSpace"|"toPascalCase"|"toCamelCase"|"toKebabCase"|"toSnakeCase"|"toDotCase"|"slugify"|"toLowerCase";};
+/** ----------------------------------------------------------
+ * * ***Utility-Predicate: `getPreciseType`.***
+ * ----------------------------------------------------------
+ * **Returns a detailed and normalized type string for the given value.**
+ * @description
+ * The returned string is human-readable _**toLowerCase**_ with spaces _***(by default)***_ or formatted according to the `options.formatCase` setting.
+ * - **Handles:**
+ *    - Primitives (`string`, `number`, `boolean`, `null`, `undefined`, `symbol`, `bigint`)
+ *    - Built-in objects (`Array`, `Map`, `Set`, `Error subclasses`, `Typed Arrays`, `etc`)
+ *    - Objects created with `Object.create(null)`
+ *    - Generator instances
+ *    - Node.js `Buffer` instances
+ *    - Proxy detection (returns `"Proxy"` if detected; detection is not 100% accurate)
+ *    - Uses cached mapping table (`FIXES`) for known types to provide consistent naming
+ *    - Falls back to constructor name or `Object.prototype.toString` tag
+ * @param {*} value - The value to detect the precise type of
+ * @param {GetPreciseTypeOptions} [options] - Optional configuration
+ * @param {GetPreciseTypeOptions["formatCase"]} [options.formatCase="toLowerCase"]
+ *   Specifies how the returned type string should be formatted.
+ *   - ⚠️ Special string literals in `SPECIAL_CASES`
+ *     (`"-Infinity" | "Infinity" | "NaN"`) will remain
+ *     unchanged even if a different `formatCase` is applied.
+ * @returns {string} The normalized and formatted type string
+ * @example
+ * getPreciseType(123);  // ➔ "number"
+ * getPreciseType(null); // ➔ "null"
+ * getPreciseType(/regex/,{ formatCase: "toKebabCase" });
+ * // ➔ "reg-exp"
+ * getPreciseType(function* () {}, { formatCase: "toCamelCase" });
+ * // ➔ "generatorFunction"
+ * getPreciseType(async function () {}, { formatCase: "toPascalCaseSpace" });
+ * // ➔ "Async Function"
+ * getPreciseType(NaN, { formatCase: "toKebabCase" });
+ * // ➔ "NaN" (SPECIAL_CASES remain)
+ */
+declare const getPreciseType:(value:unknown,options?:GetPreciseTypeOptions)=>string;type IsNumberOptions={
+/** If set to `true`, `NaN` will be considered a valid number, defaultValue: `false`.
+ *
+ * @default false
+ */
+includeNaN?:boolean;};
+/** ---------------------------------------------------------
+ * * ***Type guard: `isNumber`.***
+ * ----------------------------------------------------------
+ * **Checks if a value is of type **`number`**.**
+ * - **Behavior:**
+ *    - Uses `typeof value === "number"`.
+ *    - By default, excludes **`NaN`**.
+ *    - If `options.includeNaN` is `true`, then **`NaN`** is also considered valid.
+ *    - Still considers `Infinity` and `-Infinity` as **numbers** (consistent with JavaScript).
+ * - **ℹ️ Note:**
+ *    - To exclude `Infinity` and `-Infinity`, use **{@link isFinite | `isFinite`}** instead.
+ * @param {*} value - The value to check.
+ * @param {IsNumberOptions} [options] - Optional settings.
+ * @param {boolean} [options.includeNaN=false]  If `true`, `NaN` will be considered a valid number, defaults to `false`, which excludes `NaN`.
+ * @returns {boolean} Returns `true` if the value is a number (and depending on `includeNaN`, `NaN` is included or excluded).
+ * @example
+ * isNumber(42);
+ * // ➔ true
+ * isNumber(Infinity);
+ * // ➔ true
+ * isNumber(-Infinity);
+ * // ➔ true
+ * isNumber(NaN);
+ * // ➔ false (default)
+ * isNumber(NaN, { includeNaN: true });
+ * // ➔ true
+ * isNumber("42");
+ * // ➔ false
+ */
+declare const isNumber:(value:unknown,options?:IsNumberOptions)=>value is number;type HasKeys<T>=keyof T extends never?false:true;
+/** ----------------------------------------------------------
+ * * ***Utility type: `IsPlainObjectResult`.***
+ * ----------------------------------------------------------
+ * **Represents the inferred type after asserting a value is a **plain object**.**
+ * - **Behavior:**
+ *    - If `T` is `unknown`, the resulting type is `Record<PropertyKey, unknown> & T`.
+ *    - If `T` is an object:
+ *        - If it is a non-plain object (class instance, built-in object, etc.), the result is `never`.
+ *        - If it has no keys (`HasKeys<T>` checked by **{@link HasKeys}** is false), the result is `Record<PropertyKey, unknown> & T`.
+ *        - Otherwise, the result is `T` itself.
+ *    - For any other types, the result is `never`.
+ * @template T - The input type to be asserted as a plain object.
+ * @example
+ * ```ts
+ * type A = IsPlainObjectResult<unknown>;
+ * // ➔ Record<PropertyKey, unknown> & unknown
+ * type B = IsPlainObjectResult<{}>;
+ * // ➔ Record<PropertyKey, unknown> & {}
+ * type C = IsPlainObjectResult<{ foo: string }>;
+ * // ➔ { foo: string }
+ * type D = IsPlainObjectResult<Date>;
+ * // ➔ never
+ * ```
+ */
+type IsPlainObjectResult<T>=unknown extends T?Record<PropertyKey,unknown>& T:T extends object?T extends NonPlainObject?never:HasKeys<T>extends false?Record<PropertyKey,unknown>& T:T:Extract<T,Record<PropertyKey,unknown>>;
+/** ----------------------------------------------------------
+ * * ***Type guard: `isPlainObject`.***
+ * ----------------------------------------------------------
+ * **Checks if a value is a **plain-object**.**
+ * - **A plain object is:**
+ *    - Created by the `Object` constructor, or
+ *    - Has a `[[Prototype]]` of `null` (e.g. `Object.create(null)`).
+ * - **✅ Returns `true` for:**
+ *    - Empty object literals: `{}`
+ *    - Objects with null prototype: `Object.create(null)`
+ * - **❌ Returns `false` for:**
+ *    - Arrays (`[]`, `new Array()`)
+ *    - Functions (regular, arrow, or class constructors)
+ *    - Built-in objects: `Date`, `RegExp`, `Error`, `Map`, `Set`, `WeakMap`, `WeakSet`
+ *    - Boxed primitives: `new String()`, `new Number()`, `new Boolean()`
+ *    - `null` or `undefined`
+ *    - Symbols
+ *    - Class instances
+ * @template T - The type of the value being checked.
+ * @param {*} value - The value to check.
+ * @returns {boolean} Return `true` if `value` is a `plain-object`, otherwise `false`.
+ * @example
+ * isPlainObject({});
+ * // ➔ true
+ * isPlainObject(Object.create(null));
+ * // ➔ true
+ * isPlainObject(null);
+ * // ➔ false
+ * isPlainObject(() => {});
+ * // ➔ false
+ * isPlainObject([1, 2, 3]);
+ * // ➔ false
+ * isPlainObject(new Date());
+ * // ➔ false
+ * isPlainObject(new MyClass());
+ * // ➔ false
+ * isPlainObject(new String("x"));
+ * // ➔ false
+ */
+declare function isPlainObject<T>(value:T):value is IsPlainObjectResult<T>;declare function isPlainObject<T>(value:T):value is NonNullable<Extract<T,Record<PropertyKey,unknown>>>;export{type GetPreciseTypeOptions as G,type IsNumberOptions as I,type IsPlainObjectResult as a,isPlainObject as b,getPreciseType as g,isNumber as i};

package/dist/never-BfayMBF9.d.ts

@@ -1,75 +1,75 @@
 import{I as If}from'./if-CvT4R7Kh.js';
 /** -------------------------------------------------------
-* * ***IsNever.***
-* -------------------------------------------------------
-* **Conditional**: returns `true` if `T` is `never`, otherwise `false`.
-*
-* @template T - Type to check.
-* @example
-* ```ts
-* type A = IsNever<never>; // ➔ true
-* type B = IsNever<true>;  // ➔ false
-* ```
-*/
+ * * ***IsNever.***
+ * -------------------------------------------------------
+ * **Conditional**: returns `true` if `T` is `never`, otherwise `false`.
+ *
+ * @template T - Type to check.
+ * @example
+ * ```ts
+ * type A = IsNever<never>; // ➔ true
+ * type B = IsNever<true>;  // ➔ false
+ * ```
+ */
 type IsNever<T>=[T] extends [never]?true:false;
 /** -------------------------------------------------------
-* * ***IfNever.***
-* -------------------------------------------------------
-* **Conditional**: Selects one of two branches depending on whether `T` is `never`.
-* - Defaults: `IfTrue = true`, `IfFalse = false`.
-*
-* @template T - Type to check.
-* @template IfTrue - The branch type if `T` is `never`, (default: `true`).
-* @template IfFalse - The branch type if `T` is not `never`, (default: `false`).
-* @example
-* ```ts
-* type A = IfNever<never>;
-* // ➔ true
-* type B = IfNever<string>;
-* // ➔ false
-* type C = IfNever<never, 'valid', 'no'>;
-* // ➔ 'valid'
-* type D = IfNever<string, 'valid', 'no'>;
-* // ➔ 'no'
-* ```
-*/
+ * * ***IfNever.***
+ * -------------------------------------------------------
+ * **Conditional**: Selects one of two branches depending on whether `T` is `never`.
+ * - Defaults: `IfTrue = true`, `IfFalse = false`.
+ *
+ * @template T - Type to check.
+ * @template IfTrue - The branch type if `T` is `never`, (default: `true`).
+ * @template IfFalse - The branch type if `T` is not `never`, (default: `false`).
+ * @example
+ * ```ts
+ * type A = IfNever<never>;
+ * // ➔ true
+ * type B = IfNever<string>;
+ * // ➔ false
+ * type C = IfNever<never, 'valid', 'no'>;
+ * // ➔ 'valid'
+ * type D = IfNever<string, 'valid', 'no'>;
+ * // ➔ 'no'
+ * ```
+ */
 type IfNever<T,IfTrue=true,IfFalse=false>=If<IsNever<T>,IfTrue,IfFalse>;
 /** -------------------------------------------------------
-* * ***NeverifyPropertiesOptions.***
-* -------------------------------------------------------
-* Configuration options for the ***{@link NeverifyProperties}*** type utility.
-*
-* @property makeOptional - Whether to make all properties optional.
-*   - If `true`, resulting properties will be optional (`?`).
-*   - Default: `false`.
-*
-* @example
-* ```ts
-* type Opt1 = NeverifyPropertiesOptions;
-* // ➔ { makeOptional: boolean }
-* ```
-*/
+ * * ***NeverifyPropertiesOptions.***
+ * -------------------------------------------------------
+ * Configuration options for the ***{@link NeverifyProperties}*** type utility.
+ *
+ * @property makeOptional - Whether to make all properties optional.
+ *   - If `true`, resulting properties will be optional (`?`).
+ *   - Default: `false`.
+ *
+ * @example
+ * ```ts
+ * type Opt1 = NeverifyPropertiesOptions;
+ * // ➔ { makeOptional: boolean }
+ * ```
+ */
 type NeverifyPropertiesOptions={
 /** Whether to make all properties optional, defaultValue: `false`.
-*
-* @default false
-*/
+ *
+ * @default false
+ */
 makeOptional:boolean;};
 /** -------------------------------------------------------
-* * ***NeverifyProperties.***
-* -------------------------------------------------------
-* Turns all properties of an object to type `never`.
-* - If `Options["makeOptional"]` is `true`, properties will be optional.
-*
-* @template T - Object type to transform.
-* @template Options - Configuration options (default: `{ makeOptional: false }`).
-* @example
-* ```ts
-* type A = NeverifyProperties<{ a: string; b: string }>;
-* // ➔ { a: never; b: never }
-*
-* type B = NeverifyProperties<{ a: string; b: string }, { makeOptional: true }>;
-* // ➔ { a?: never; b?: never }
-* ```
-*/
+ * * ***NeverifyProperties.***
+ * -------------------------------------------------------
+ * Turns all properties of an object to type `never`.
+ * - If `Options["makeOptional"]` is `true`, properties will be optional.
+ *
+ * @template T - Object type to transform.
+ * @template Options - Configuration options (default: `{ makeOptional: false }`).
+ * @example
+ * ```ts
+ * type A = NeverifyProperties<{ a: string; b: string }>;
+ * // ➔ { a: never; b: never }
+ *
+ * type B = NeverifyProperties<{ a: string; b: string }, { makeOptional: true }>;
+ * // ➔ { a?: never; b?: never }
+ * ```
+ */
 type NeverifyProperties<T extends object,Options extends NeverifyPropertiesOptions={makeOptional:false;}>={[K in keyof T]:never;}extends infer Result?If<Options["makeOptional"],Partial<Result>,Result>:never;export type{IsNever as I,NeverifyProperties as N,IfNever as a,NeverifyPropertiesOptions as b};

package/dist/next/index.cjs

@@ -1,8 +1 @@
-'use strict';var chunk5JFV3GDE_cjs=require('../chunk-5JFV3GDE.cjs'),chunkN2IJPIND_cjs=require('../chunk-N2IJPIND.cjs'),chunk2TRAPBZ7_cjs=require('../chunk-2TRAPBZ7.cjs'),chunkBVPMMWDL_cjs=require('../chunk-BVPMMWDL.cjs');require('../chunk-PUQXRLZH.cjs');var chunkU5Y2FXMN_cjs=require('../chunk-U5Y2FXMN.cjs');require('../chunk-7YWAQOA4.cjs');var chunkCN53M4QZ_cjs=require('../chunk-CN53M4QZ.cjs');function C(e,t){if(!chunkCN53M4QZ_cjs.h(e)||chunk2TRAPBZ7_cjs.a(e))throw new TypeError(`\u274C 'generateRoute' Failed:
-- Invalid 'route' value.
-- Must be of type \`string\` and non-empty string, but received: "${chunkCN53M4QZ_cjs.E(e)}": \`${chunkU5Y2FXMN_cjs.c(e)}\`.`);if(!/[\\[\]]/.test(e))return e;if(chunkCN53M4QZ_cjs.m(t,{message:({validType:o})=>`\u274C 'generateRoute' Failed cause in route "${e}":
-- Missing or invalid parameters \`${o}\` for route: "${e}", must be of type \`${o}\` mapping parameters.`}),chunkCN53M4QZ_cjs.c(t))throw new TypeError(`\u274C 'generateRoute' Failed cause in route "${e}":
-- Missing parameters \`plain-object\` for route: "${e}".`);let n=["?","&","#","=","/","'",'"',"(",")","+",";","%","@",":"],r=[],s=Array.from(e.matchAll(/\[(\w+)\]/g)).map(o=>o[1]);for(let o of s){let i=t[o];if(!chunkCN53M4QZ_cjs.h(i)){r.push(`- Invalid parameter: "${o}" must be of type \`string\`, but received: \`${chunkCN53M4QZ_cjs.E(i)}\`.`);continue}if(chunk2TRAPBZ7_cjs.a(i)){r.push(`- Parameter "${o}" cannot be empty string.`);continue}let p=n.filter(g=>i.includes(g));if(/\s/.test(i)&&p.push("white-space(s)"),p.length>0){let g=p.map(a=>a==="`"?"backtick - (`)":`\`${a}\``);n.includes("white-space(s)")||n.push("white-space(s)");let c=n.map(a=>a==="`"?"backtick - (`)":`\`${a}\``);r.push(`- Parameter "${o}" contains invalid characters (${g.join(", ")}). These characters are not allowed because they could cause issues in URL structure. The following characters are forbidden in route parameters: (${c.join(", ")}).`);}}if(chunkCN53M4QZ_cjs.r(r))throw new Error(`\u274C 'generateRoute' Failed cause in route "${e}":
-${r.join(`
-`)}.`);return e.replace(/\[(\w+)\]/g,(o,i)=>(chunkCN53M4QZ_cjs.p(t[i])?t[i]:"").trim().replace(/^\/+|\/+$/g,"")).replace(/\/+/g,"/")}var M=(e="",t)=>{try{let p=function(c,a){return `${c.replace(/\/+$/,"")}/${a.replace(/^\/+/,"")}`};var n=p;chunkBVPMMWDL_cjs.a(e,{message({currentType:c,validType:a}){return `First parameter \`pathname\` must be of type \`${a}\`, but received: \`${c}\`.`}}),chunkCN53M4QZ_cjs.f(t)||(t={});let{prefix:r="/api",withOrigin:s=!0}=t;if(!chunkCN53M4QZ_cjs.k(r)&&!chunkCN53M4QZ_cjs.h(r))throw new TypeError(`Parameter \`prefix\` property of the \`options\` (second parameter) must be of type \`string\`, but received: ${chunkCN53M4QZ_cjs.E(r)}.`);chunkCN53M4QZ_cjs.G(s,{message:({currentType:c,validType:a})=>`Parameter \`withOrigin\` property of the \`options\` (second parameter) must be of type \`${a}\`, but received: \`${c}\`.`}),e=chunk5JFV3GDE_cjs.c(e),r=chunk5JFV3GDE_cjs.c(r);let o=r.endsWith("/")?r:r+"/";(e===r||e===r+"/"||e.startsWith(o))&&(e=e.slice(r.length),e=chunk5JFV3GDE_cjs.c(e));let i=U({suffix:r});return p(s?i:new URL(i).pathname,e).replace(/\/+$/,"")}catch(r){throw new Error("Failed to generate backend API URL in `createBeApiUrl()`, Error:"+r)}};var U=({suffix:e="/"}={})=>{chunkBVPMMWDL_cjs.a(e,{message({currentType:t,validType:n}){return `Parameter \`suffix\` property of the first parameter must be of type \`${n}\`, but received: \`${t}\`.`}});try{let t=process.env.NEXT_PUBLIC_BACKEND_API_URL?.trim();if(t){t=chunkN2IJPIND_cjs.c(t);let s=new URL(t);!!!s.port&&process.env.NEXT_PUBLIC_PORT_BE&&(t=s.origin+chunk5JFV3GDE_cjs.d(process.env.NEXT_PUBLIC_PORT_BE,{prefixColon:!0}));}else t="http://localhost"+chunk5JFV3GDE_cjs.d(process.env.NEXT_PUBLIC_PORT_BE||"8000",{prefixColon:!0});e=chunkN2IJPIND_cjs.c(e).length?chunkN2IJPIND_cjs.c(e):"/";let n=new URL(t.replace(/\/+$/,"")).origin,r=e==="/"?"/":`${e.startsWith("/")?"":"/"}${e.replace(/\/+$/,"")}`;return `${n}${r}`}catch(t){throw new Error("Invalid `NEXT_PUBLIC_BACKEND_API_URL`, failed to generate from `getBeApiUrl()`, Error:"+t)}};var Z=()=>{try{let e=process.env.NEXT_PUBLIC_BASE_URL?.trim(),t=process.env.NEXT_PUBLIC_PORT_FE?.trim(),n=e||"http://localhost";n=chunkN2IJPIND_cjs.c(n).replace(/\/+$/,"");let r=/:\/\/[^/]+:\d+/.test(n);!r&&t?n+=chunk5JFV3GDE_cjs.d(t,{prefixColon:!0}):!r&&!e&&(n+=":3000");let s=new URL(n);return `${s.protocol}//${s.hostname}${s.port?`:${s.port}`:""}`}catch(e){throw new Error("Invalid `NEXT_PUBLIC_BASE_URL`, failed to generate from `getBaseUrl()`, Error:"+e)}};
-exports.createBeApiUrl=M;exports.generateRoute=C;exports.getBaseUrl=Z;exports.getBeApiUrl=U;
+"use strict";var e=require("../chunk-S6Z6I2EG.cjs"),r=require("../chunk-XC2PYCT4.cjs"),t=require("../chunk-EBMHQW7X.cjs"),n=require("../chunk-Y4O5KZF6.cjs");require("../chunk-DVMHRLKP.cjs");var s=require("../chunk-E63WVPZE.cjs");require("../chunk-UDA26MCU.cjs");var i=require("../chunk-INUFZJLX.cjs");var a=({suffix:t="/"}={})=>{var s;n.assertIsString(t,{message:({currentType:e,validType:r})=>`Parameter \`suffix\` property of the first parameter must be of type \`${r}\`, but received: \`${e}\`.`});try{let n=null==(s=process.env.NEXT_PUBLIC_BACKEND_API_URL)?void 0:s.trim();if(n){n=r.removeSpaces(n);const t=new URL(n);!!!t.port&&process.env.NEXT_PUBLIC_PORT_BE&&(n=t.origin+e.formatEnvPort(process.env.NEXT_PUBLIC_PORT_BE,{prefixColon:!0}))}else n="http://localhost"+e.formatEnvPort(process.env.NEXT_PUBLIC_PORT_BE||"8000",{prefixColon:!0});t=r.removeSpaces(t).length?r.removeSpaces(t):"/";const i=new URL(n.replace(/\/+$/,"")).origin;return`${i}${"/"===t?"/":`${t.startsWith("/")?"":"/"}${t.replace(/\/+$/,"")}`}`}catch(e){throw new Error("Invalid `NEXT_PUBLIC_BACKEND_API_URL`, failed to generate from `getBeApiUrl()`, Error:"+e)}};exports.createBeApiUrl=(r,t={})=>{try{let s=function(e,r){return`${e.replace(/\/+$/,"")}/${r.replace(/^\/+/,"")}`};n.assertIsString(i.isNil(r)?"":r,{message:({currentType:e,validType:r})=>`First parameter (\`pathname\`) must be of type \`${r}\`, but received: \`${e}\`.`}),i.isPlainObject(t)||(t={});let{prefix:o="/api",withOrigin:c=!0}=t;if(!i.isUndefined(o)&&!i.isString(o))throw new TypeError(`Parameter \`prefix\` property of the \`options\` (second parameter) must be of type \`string\`, but received: \`${i.getPreciseType(o)}\`.`);i.assertIsBoolean(c,{message:({currentType:e,validType:r})=>`Parameter \`withOrigin\` property of the \`options\` (second parameter) must be of type \`${r}\`, but received: \`${e}\`.`}),r=e.normalizePathname(r),o=e.normalizePathname(o);const p=o.endsWith("/")?o:o+"/";(r===o||r===o+"/"||r.startsWith(p))&&(r=r.slice(o.length),r=e.normalizePathname(r));const u=a({suffix:o});return s(c?u:new URL(u).pathname,r).replace(/\/+$/,"")}catch(e){throw i.isError(e)?e:new Error("Failed to generate backend API URL in `createBeApiUrl()`, Error: "+new Error(String(e)).message.trim())}},exports.generateRoute=function(e,r){if(!i.isString(e)||t.isEmptyString(e))throw new TypeError(`❌ 'generateRoute' Failed:\n- Invalid 'route' value.\n- Must be of type \`string\` and non-empty string, but received: "${i.getPreciseType(e)}": \`${s.safeStableStringify(e)}\`.`);if(!/[\\[\]]/.test(e))return e;if(i.assertIsPlainObject(r,{message:({validType:r})=>`❌ 'generateRoute' Failed cause in route "${e}":\n- Missing or invalid parameters \`${r}\` for route: "${e}", must be of type \`${r}\` mapping parameters.`}),i.isNil(r))throw new TypeError(`❌ 'generateRoute' Failed cause in route "${e}":\n- Missing parameters \`plain-object\` for route: "${e}".`);const n=["?","&","#","=","/","'",'"',"(",")","+",";","%","@",":"],a=[],o=Array.from(e.matchAll(/\[(\w+)\]/g)).map(e=>e[1]);for(const e of o){const s=r[e];if(!i.isString(s)){a.push(`- Invalid parameter: "${e}" must be of type \`string\`, but received: \`${i.getPreciseType(s)}\`.`);continue}if(t.isEmptyString(s)){a.push(`- Parameter "${e}" cannot be empty string.`);continue}const o=n.filter(e=>s.includes(e));if(/\s/.test(s)&&o.push("white-space(s)"),o.length>0){const r=o.map(e=>"`"===e?"backtick - (`)":`\`${e}\``);n.includes("white-space(s)")||n.push("white-space(s)");const t=n.map(e=>"`"===e?"backtick - (`)":`\`${e}\``);a.push(`- Parameter "${e}" contains invalid characters (${r.join(", ")}). These characters are not allowed because they could cause issues in URL structure. The following characters are forbidden in route parameters: (${t.join(", ")}).`)}}if(i.isNonEmptyArray(a))throw new Error(`❌ 'generateRoute' Failed cause in route "${e}":\n${a.join("\n")}.`);return e.replace(/\[(\w+)\]/g,(e,t)=>(i.isNonEmptyString(r[t])?r[t]:"").trim().replace(/^\/+|\/+$/g,"")).replace(/\/+/g,"/")},exports.getBaseUrl=()=>{var t,n;try{const s=null==(t=process.env.NEXT_PUBLIC_BASE_URL)?void 0:t.trim(),i=null==(n=process.env.NEXT_PUBLIC_PORT_FE)?void 0:n.trim();let a=s||"http://localhost";a=r.removeSpaces(a).replace(/\/+$/,"");const o=/:\/\/[^/]+:\d+/.test(a);!o&&i?a+=e.formatEnvPort(i,{prefixColon:!0}):o||s||(a+=":3000");const c=new URL(a);return`${c.protocol}//${c.hostname}${c.port?`:${c.port}`:""}`}catch(e){throw new Error("Invalid `NEXT_PUBLIC_BASE_URL`, failed to generate from `getBaseUrl()`, Error:"+e)}},exports.getBeApiUrl=a;