@rzl-zone/utils-js 3.12.1-beta.0 → 3.12.1-beta.1

package/dist/next/index.d.ts

@@ -2,7 +2,7 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.12.1-beta.0`
+*  Version: `3.12.1-beta.1`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
@@ -10,217 +10,211 @@
 
 import { IsAny } from "@rzl-zone/ts-types-plus";
 /** ---------------------------------------------------------
- * * ***Extracts dynamic route parameters from a given route string.***
- * ---------------------------------------------------------
- * **This utility type recursively searches for dynamic segments within a route,
- * extracting each parameter and constructing an object where each key represents
- * a dynamic segment and its value is of type `string`.**
- * - ***⚠️ Warning:***
- *    - ***This types only support when using ***[`NextJS`](https://nextjs.org/)***.***
- * @template T - The route string containing potential dynamic segments.
- * @example
- * ```ts
- * type Params1 = ExtractRouteParams<"/user/[id]">;
- * // ➔ { id: string }
- * type Params2 = ExtractRouteParams<"/post/[slug]/comment/[commentId]">;
- * // ➔ { slug: string; commentId: string }
- * type Params3 = ExtractRouteParams<"/dashboard">;
- * // ➔ {} (no dynamic parameters)
- * ```
- */
+* * ***Extracts dynamic route parameters from a given route string.***
+* ---------------------------------------------------------
+* **This utility type recursively searches for dynamic segments within a route,
+* extracting each parameter and constructing an object where each key represents
+* a dynamic segment and its value is of type `string`.**
+* - ***⚠️ Warning:***
+*    - ***This types only support when using ***[`NextJS`](https://nextjs.org/)***.***
+* @template T - The route string containing potential dynamic segments.
+* @example
+* ```ts
+* type Params1 = ExtractRouteParams<"/user/[id]">;
+* // ➔ { id: string }
+* type Params2 = ExtractRouteParams<"/post/[slug]/comment/[commentId]">;
+* // ➔ { slug: string; commentId: string }
+* type Params3 = ExtractRouteParams<"/dashboard">;
+* // ➔ {} (no dynamic parameters)
+* ```
+*/
 type ExtractRouteParams<T> = T extends string ? HasDynamicSegments<T> extends true ? T extends `${infer _Start}[${infer Param}]${infer Rest}` ? { [K in Param | keyof ExtractRouteParams<Rest>]: string } : unknown : unknown : unknown;
 /** ---------------------------------------------------------
- * * ***Determines whether a given route contains dynamic segments.***
- * ---------------------------------------------------------
- * **This type checks if the route includes at least one `[param]` pattern.
- * If it does, the result is `true`, otherwise `false`.**
- * - ***⚠️ Warning:***
- *    - ***This types only support when using ***[`NextJS`](https://nextjs.org/)***.***
- * @template T - The route string to be evaluated.
- * @example
- * ```ts
- * type HasParams1 = HasDynamicSegments<"/user/[id]">;
- * // ➔ true
- * type HasParams2 = HasDynamicSegments<"/settings/profile">;
- * // ➔ false
- * type HasParams3 = HasDynamicSegments<"/blog/[category]/[slug]">;
- * // ➔ true
- * ```
- */
+* * ***Determines whether a given route contains dynamic segments.***
+* ---------------------------------------------------------
+* **This type checks if the route includes at least one `[param]` pattern.
+* If it does, the result is `true`, otherwise `false`.**
+* - ***⚠️ Warning:***
+*    - ***This types only support when using ***[`NextJS`](https://nextjs.org/)***.***
+* @template T - The route string to be evaluated.
+* @example
+* ```ts
+* type HasParams1 = HasDynamicSegments<"/user/[id]">;
+* // ➔ true
+* type HasParams2 = HasDynamicSegments<"/settings/profile">;
+* // ➔ false
+* type HasParams3 = HasDynamicSegments<"/blog/[category]/[slug]">;
+* // ➔ true
+* ```
+*/
 type HasDynamicSegments<T> = T extends `${string}[${string}]${string}` ? true : false;
 type GenerateRouteResult<T> = true extends IsAny<T> ? unknown : T extends string ? string : unknown;
 /** ---------------------------------
- * * ***Utility for NextJS: `generateRoute`.***
- * ---------------------------------
- * **Generates a URL by replacing dynamic route parameters with provided values.**
- * - ***⚠️ Warning:***
- *    - ***This function only support when using ***[`NextJS`](https://nextjs.org/)***.***
- * @template T - The route string containing dynamic segments in the format `[param]`.
- * @param {T} route - The route string containing dynamic segments.
- * @param {ExtractRouteParams<T>} [params] - An object containing key-value pairs that match the dynamic segments in the route.
- * @returns {string} The formatted URL with all dynamic segments replaced.
- * @throws **{@link Error | `Error`}** if the route contains dynamic segments but no parameters object is provided.
- * @throws **{@link Error | `Error`}** if a required parameter is missing from the `params` object.
- * @throws **{@link Error | `Error`}** if a parameter value is an empty string.
- * @throws **{@link Error | `Error`}** if any parameter contains invalid characters like `?`, `&`, `=`, `#`, `/`, spaces, `'`, `"`, `(`, `)`, `+`, `;`, `%`, `@`, or `:`, which can cause URL issues.
- * @example
- * // Basic usage
- * generateRoute("/user/[id]", { id: "123" });
- * // ➔ "/user/123"
- *
- * // No dynamic segments, returns as-is
- * generateRoute("/dashboard");
- * // ➔ "/dashboard"
- *
- * // Throws an error due to missing parameters object
- * generateRoute("/profile/[username]");
- * // ➔ ❌ Error: ❌ Missing parameters object for route: "/profile/[username]"
- *
- * // Throws an error due to an empty parameter value
- * generateRoute("/post/[category]/[slug]", { category: "tech", slug: "" });
- * // ➔ ❌ Error: ❌ Parameter "slug" cannot be empty in route: "/post/[category]/[slug]"
- *
- * // Throws an error due to parameter containing invalid characters
- * generateRoute("/search/[query]", { query: "how to?learn" });
- * // ➔ ❌ Error: ❌ Parameter "query" contains invalid character "?" in route: "/search/[query]"
- *
- * // Handles leading/trailing slashes correctly
- * generateRoute("/blog/[category]/[slug]", { category: "/news/", slug: "/latest-update/" });
- * // ➔ ❌ Error: ❌ Parameter "category" and "slug" contains slashes "/" which is not allowed.
- */
+* * ***Utility for NextJS: `generateRoute`.***
+* ---------------------------------
+* **Generates a URL by replacing dynamic route parameters with provided values.**
+* - ***⚠️ Warning:***
+*    - ***This function only support when using ***[`NextJS`](https://nextjs.org/)***.***
+* @template T - The route string containing dynamic segments in the format `[param]`.
+* @param {T} route - The route string containing dynamic segments.
+* @param {ExtractRouteParams<T>} [params] - An object containing key-value pairs that match the dynamic segments in the route.
+* @returns {string} The formatted URL with all dynamic segments replaced.
+* @throws **{@link Error | `Error`}** if the route contains dynamic segments but no parameters object is provided.
+* @throws **{@link Error | `Error`}** if a required parameter is missing from the `params` object.
+* @throws **{@link Error | `Error`}** if a parameter value is an empty string.
+* @throws **{@link Error | `Error`}** if any parameter contains invalid characters like `?`, `&`, `=`, `#`, `/`, spaces, `'`, `"`, `(`, `)`, `+`, `;`, `%`, `@`, or `:`, which can cause URL issues.
+* @example
+* // Basic usage
+* generateRoute("/user/[id]", { id: "123" });
+* // ➔ "/user/123"
+*
+* // No dynamic segments, returns as-is
+* generateRoute("/dashboard");
+* // ➔ "/dashboard"
+*
+* // Throws an error due to missing parameters object
+* generateRoute("/profile/[username]");
+* // ➔ ❌ Error: ❌ Missing parameters object for route: "/profile/[username]"
+*
+* // Throws an error due to an empty parameter value
+* generateRoute("/post/[category]/[slug]", { category: "tech", slug: "" });
+* // ➔ ❌ Error: ❌ Parameter "slug" cannot be empty in route: "/post/[category]/[slug]"
+*
+* // Throws an error due to parameter containing invalid characters
+* generateRoute("/search/[query]", { query: "how to?learn" });
+* // ➔ ❌ Error: ❌ Parameter "query" contains invalid character "?" in route: "/search/[query]"
+*
+* // Handles leading/trailing slashes correctly
+* generateRoute("/blog/[category]/[slug]", { category: "/news/", slug: "/latest-update/" });
+* // ➔ ❌ Error: ❌ Parameter "category" and "slug" contains slashes "/" which is not allowed.
+*/
 declare function generateRoute<T extends string>(route: T extends string ? HasDynamicSegments<T> extends true ? T : never : never, params: T extends string ? ExtractRouteParams<T> : undefined): GenerateRouteResult<T>;
 declare function generateRoute<T extends string>(route: T extends string ? T : never, params?: Extract<ExtractRouteParams<T>, Record<string, unknown>>): GenerateRouteResult<T>;
 declare function generateRoute<T = unknown>(route: T extends string ? HasDynamicSegments<T> extends true ? T : unknown : unknown, params?: T extends string ? ExtractRouteParams<T> : undefined): unknown;
 type OptionsCreateBeApiUrl = {
   /** * The prefix pathname api url, e.g:`"http://localhost.com/your-target-prefix-entri-point-api-is-here"`, default: `"/api"`.
-   *
-   * @default "/api" */
+  *
+  * @default "/api" */
   prefix?: string;
   /** * Option to getting `prefix` and `pathname` of api url only `(removing origin base api url)`, default: `true`.
-   *
-   * @default true */
+  *
+  * @default true */
   withOrigin?: boolean;
 };
 /** ---------------------------------
- * * ***Utility for NextJS: `createBeApiUrl`.***
- * ---------------------------------
- * **Constructs a backend API URL by appending a given pathname to the base API URL.**
- * - **ℹ️ Note:**
- *    - This function builds on top of `getBeApiUrl()`.
- * - **Determines the base API URL from:**
- *    - `NEXT_PUBLIC_BACKEND_API_URL` environment variable (or defaults to `"http://localhost:8000"`).
- *    - Automatically appends `NEXT_PUBLIC_PORT_BE` if the base URL does not already include a port.
- * - **Features of this function:**
- *    - Allows customizing the API path with an optional `prefix` (defaults to `"/api"`).
- *    - Can include or exclude the origin (protocol + host) via `withOrigin`.
- *    - Normalizes paths to avoid duplicate slashes.
- * - ***⚠️ Warning:***
- *    - ***This function only support when using ***[`NextJS`](https://nextjs.org/)***.***
- * @param {string|null|undefined} pathname - The API endpoint path (e.g., `/users` or `/v1/posts`), defaultValue: `""`.
- * @param {OptionsCreateBeApiUrl} [options] - Configuration options.
- * @param {OptionsCreateBeApiUrl["prefix"]} [options.prefix="/api"] - The prefix for the API path (default is `"/api"`).
- * @param {OptionsCreateBeApiUrl["withOrigin"]} [options.withOrigin=true] - Whether to include the full base URL or return only the API path.
- * @returns {string} The formatted API URL.
- * @throws **{@link TypeError | `TypeError`}** if `withOrigin` is not a boolean.
- * @throws **{@link TypeError | `TypeError`}** if `prefix` and `pathname` is not a string.
- * @throws **{@link Error | `Error`}** if constructing the API URL fails due to an invalid base URL.
- * @example
- * createBeApiUrl("/users")
- * // ➔ "http://localhost:8000/api/users"
- * createBeApiUrl("/api/users")
- * // ➔ "http://localhost:8000/api/users"
- * createBeApiUrl("/v1", { prefix: "/v1" })
- * // ➔ "http://localhost:8000/v1"
- * createBeApiUrl("/v1/users")
- * // ➔ "http://localhost:8000/api/v1/users"
- * createBeApiUrl("/v1/users", { prefix: "/v1" })
- * // ➔ "http://localhost:8000/v1/users"
- * createBeApiUrl("/users", { withOrigin: false })
- * // ➔ "/api/users"
- * createBeApiUrl(null, { withOrigin: false })
- * // ➔ "/api"
- * createBeApiUrl(undefined, { withOrigin: false })
- * // ➔ "/api"
- */
-declare const createBeApiUrl: (
-/** * The pathname api url, e.g:`"http://localhost.com/your-target-prefix-entri-point-api-is-here/your-target-pathname-is-here"`.
- *
- * @default ""
- */
-
-pathname: string | null | undefined, options?: OptionsCreateBeApiUrl) => string;
+* * ***Utility for NextJS: `createBeApiUrl`.***
+* ---------------------------------
+* **Constructs a backend API URL by appending a given pathname to the base API URL.**
+* - **ℹ️ Note:**
+*    - This function builds on top of `getBeApiUrl()`.
+* - **Determines the base API URL from:**
+*    - `NEXT_PUBLIC_BACKEND_API_URL` environment variable (or defaults to `"http://localhost:8000"`).
+*    - Automatically appends `NEXT_PUBLIC_PORT_BE` if the base URL does not already include a port.
+* - **Features of this function:**
+*    - Allows customizing the API path with an optional `prefix` (defaults to `"/api"`).
+*    - Can include or exclude the origin (protocol + host) via `withOrigin`.
+*    - Normalizes paths to avoid duplicate slashes.
+* - ***⚠️ Warning:***
+*    - ***This function only support when using ***[`NextJS`](https://nextjs.org/)***.***
+* @param {string|null|undefined} pathname - The API endpoint path (e.g., `/users` or `/v1/posts`), defaultValue: `""`.
+* @param {OptionsCreateBeApiUrl} [options] - Configuration options.
+* @param {OptionsCreateBeApiUrl["prefix"]} [options.prefix="/api"] - The prefix for the API path (default is `"/api"`).
+* @param {OptionsCreateBeApiUrl["withOrigin"]} [options.withOrigin=true] - Whether to include the full base URL or return only the API path.
+* @returns {string} The formatted API URL.
+* @throws **{@link TypeError | `TypeError`}** if `withOrigin` is not a boolean.
+* @throws **{@link TypeError | `TypeError`}** if `prefix` and `pathname` is not a string.
+* @throws **{@link Error | `Error`}** if constructing the API URL fails due to an invalid base URL.
+* @example
+* createBeApiUrl("/users")
+* // ➔ "http://localhost:8000/api/users"
+* createBeApiUrl("/api/users")
+* // ➔ "http://localhost:8000/api/users"
+* createBeApiUrl("/v1", { prefix: "/v1" })
+* // ➔ "http://localhost:8000/v1"
+* createBeApiUrl("/v1/users")
+* // ➔ "http://localhost:8000/api/v1/users"
+* createBeApiUrl("/v1/users", { prefix: "/v1" })
+* // ➔ "http://localhost:8000/v1/users"
+* createBeApiUrl("/users", { withOrigin: false })
+* // ➔ "/api/users"
+* createBeApiUrl(null, { withOrigin: false })
+* // ➔ "/api"
+* createBeApiUrl(undefined, { withOrigin: false })
+* // ➔ "/api"
+*/
+declare const createBeApiUrl: (pathname: string | null | undefined, options?: OptionsCreateBeApiUrl) => string;
 type OptionsGetBeApiUrl = {
   /** * ***The Suffix origin base api url, e.g:`http://localhost.com/api`, default: `"/"`.***
-   *
-   * @default "/" */
+  *
+  * @default "/" */
   suffix?: string;
 };
 /** ---------------------------------------------------
- * * ***Utility for NextJS: `getBeApiUrl`.***
- * ---------------------------------------------------
- * **This function determines the backend API base URL from the `NEXT_PUBLIC_BACKEND_API_URL` environment variable (retrieves the base API URL of the backend).**
- * - **Behavior:**
- *    - If the variable is not set, it defaults to `"http://localhost:8000"`.
- *    - It also allows adding an optional suffix to the returned URL.
- * - ***⚠️ Warning:***
- *    - ***This function only support when using ***[`NextJS`](https://nextjs.org/)***.***
- * @description
- * This function determines the backend API base URL from the `NEXT_PUBLIC_BACKEND_API_URL` environment variable.
- * - If `NEXT_PUBLIC_BACKEND_API_URL` is not set, it defaults to `"http://localhost:8000"`.
- * - If `NEXT_PUBLIC_BACKEND_API_URL` does **not** contain a port, it appends one from `NEXT_PUBLIC_PORT_BE` if available.
- * - Supports appending optional suffix (like `"/api"`).
- * @param {OptionsGetBeApiUrl|undefined} options - Configuration options.
- * @param {OptionsGetBeApiUrl["suffix"]} [options.suffix="/"] - The suffix to append to the base API URL.
- * @returns {string} The formatted backend API base URL.
- * @throws **{@link TypeError | `TypeError`}** if `suffix` is not a `string`.
- * @throws **{@link Error | `Error`}** if `NEXT_PUBLIC_BACKEND_API_URL` is invalid.
- * @example
- * // With NEXT_PUBLIC_BACKEND_API_URL set at `*.env` file
- * NEXT_PUBLIC_BACKEND_API_URL = "https://api.example.com";
- * getBeApiUrl();
- * // ➔ "https://api.example.com/"
- *
- * // With NEXT_PUBLIC_BACKEND_API_URL but no port, using NEXT_PUBLIC_PORT_BE at `*.env` file
- * NEXT_PUBLIC_BACKEND_API_URL = "http://localhost";
- * NEXT_PUBLIC_PORT_BE = "5000";
- * getBeApiUrl({ suffix: "/api" });
- * // ➔ "http://localhost:5000/api"
- *
- * // Without NEXT_PUBLIC_BACKEND_API_URL at `*.env` file (defaults to localhost:8000)
- * delete NEXT_PUBLIC_BACKEND_API_URL;
- * getBeApiUrl({ suffix: "/v1" });
- * // ➔ "http://localhost:8000/v1"
- */
+* * ***Utility for NextJS: `getBeApiUrl`.***
+* ---------------------------------------------------
+* **This function determines the backend API base URL from the `NEXT_PUBLIC_BACKEND_API_URL` environment variable (retrieves the base API URL of the backend).**
+* - **Behavior:**
+*    - If the variable is not set, it defaults to `"http://localhost:8000"`.
+*    - It also allows adding an optional suffix to the returned URL.
+* - ***⚠️ Warning:***
+*    - ***This function only support when using ***[`NextJS`](https://nextjs.org/)***.***
+* @description
+* This function determines the backend API base URL from the `NEXT_PUBLIC_BACKEND_API_URL` environment variable.
+* - If `NEXT_PUBLIC_BACKEND_API_URL` is not set, it defaults to `"http://localhost:8000"`.
+* - If `NEXT_PUBLIC_BACKEND_API_URL` does **not** contain a port, it appends one from `NEXT_PUBLIC_PORT_BE` if available.
+* - Supports appending optional suffix (like `"/api"`).
+* @param {OptionsGetBeApiUrl|undefined} options - Configuration options.
+* @param {OptionsGetBeApiUrl["suffix"]} [options.suffix="/"] - The suffix to append to the base API URL.
+* @returns {string} The formatted backend API base URL.
+* @throws **{@link TypeError | `TypeError`}** if `suffix` is not a `string`.
+* @throws **{@link Error | `Error`}** if `NEXT_PUBLIC_BACKEND_API_URL` is invalid.
+* @example
+* // With NEXT_PUBLIC_BACKEND_API_URL set at `*.env` file
+* NEXT_PUBLIC_BACKEND_API_URL = "https://api.example.com";
+* getBeApiUrl();
+* // ➔ "https://api.example.com/"
+*
+* // With NEXT_PUBLIC_BACKEND_API_URL but no port, using NEXT_PUBLIC_PORT_BE at `*.env` file
+* NEXT_PUBLIC_BACKEND_API_URL = "http://localhost";
+* NEXT_PUBLIC_PORT_BE = "5000";
+* getBeApiUrl({ suffix: "/api" });
+* // ➔ "http://localhost:5000/api"
+*
+* // Without NEXT_PUBLIC_BACKEND_API_URL at `*.env` file (defaults to localhost:8000)
+* delete NEXT_PUBLIC_BACKEND_API_URL;
+* getBeApiUrl({ suffix: "/v1" });
+* // ➔ "http://localhost:8000/v1"
+*/
 declare const getBeApiUrl: (options?: OptionsGetBeApiUrl) => string;
 /** ---------------------------------------------------
- * * ***Utility for NextJS: `getBaseUrl`.***
- * ---------------------------------------------------
- * **Retrieves the base URL of the application.**
- * - **Behavior:**
- *    - It determines the base URL from the `NEXT_PUBLIC_BASE_URL` environment variable.
- *    - If `NEXT_PUBLIC_BASE_URL` is not set, it defaults to `"http://localhost:3000"`.
- *    - If `NEXT_PUBLIC_BASE_URL` does **not** contain a port, it appends one from `NEXT_PUBLIC_PORT_FE` if available.
- *    - Ensures the final URL is valid and normalized (no trailing slashes).
- * - ***⚠️ Warning:***
- *    - ***This function only support when using ***[`NextJS`](https://nextjs.org/)***.***
- * @returns {string} The resolved base URL of the application.
- * @throws **{@link Error | `Error`}** if the constructed URL is invalid or malformed.
- * @example
- * // With environment variable set at `*.env` file
- * NEXT_PUBLIC_BASE_URL = "https://example.com";
- * getBaseUrl();
- * // ➔ "https://example.com"
- *
- * // With custom port via NEXT_PUBLIC_PORT_FE at `*.env` file
- * NEXT_PUBLIC_BASE_URL = "http://localhost";
- * NEXT_PUBLIC_PORT_FE = "4000";
- * getBaseUrl();
- * // ➔ "http://localhost:4000"
- *
- * // Without environment variable at `*.env` file
- * delete NEXT_PUBLIC_BASE_URL;
- * getBaseUrl();
- * // ➔ "http://localhost:3000"
- */
+* * ***Utility for NextJS: `getBaseUrl`.***
+* ---------------------------------------------------
+* **Retrieves the base URL of the application.**
+* - **Behavior:**
+*    - It determines the base URL from the `NEXT_PUBLIC_BASE_URL` environment variable.
+*    - If `NEXT_PUBLIC_BASE_URL` is not set, it defaults to `"http://localhost:3000"`.
+*    - If `NEXT_PUBLIC_BASE_URL` does **not** contain a port, it appends one from `NEXT_PUBLIC_PORT_FE` if available.
+*    - Ensures the final URL is valid and normalized (no trailing slashes).
+* - ***⚠️ Warning:***
+*    - ***This function only support when using ***[`NextJS`](https://nextjs.org/)***.***
+* @returns {string} The resolved base URL of the application.
+* @throws **{@link Error | `Error`}** if the constructed URL is invalid or malformed.
+* @example
+* // With environment variable set at `*.env` file
+* NEXT_PUBLIC_BASE_URL = "https://example.com";
+* getBaseUrl();
+* // ➔ "https://example.com"
+*
+* // With custom port via NEXT_PUBLIC_PORT_FE at `*.env` file
+* NEXT_PUBLIC_BASE_URL = "http://localhost";
+* NEXT_PUBLIC_PORT_FE = "4000";
+* getBaseUrl();
+* // ➔ "http://localhost:4000"
+*
+* // Without environment variable at `*.env` file
+* delete NEXT_PUBLIC_BASE_URL;
+* getBaseUrl();
+* // ➔ "http://localhost:3000"
+*/
 declare const getBaseUrl: () => string;
 export { ExtractRouteParams, HasDynamicSegments, createBeApiUrl, generateRoute, getBaseUrl, getBeApiUrl };

package/dist/next/index.js

@@ -2,17 +2,17 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.12.1-beta.0`
+*  Version: `3.12.1-beta.1`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
-import { A as isPlainObject, N as isNil, S as isUndefined, T as assertIsPlainObject, b as hasOwnProp, k as isString, p as isNonEmptyArray, r as getPreciseType, t as assertIsBoolean, v as isError, y as isNonEmptyString } from "../assertIsBoolean-BlBct0Fc.js";
-import { t as assertIsString } from "../assertIsString-DqV9NwbI.js";
-import { t as safeStableStringify } from "../safeStableStringify-BNh3D0K0.js";
-import { t as isEmptyString } from "../isEmptyString-BTUWYTbw.js";
-import { t as removeSpaces } from "../removeSpaces-BE8lfh-4.js";
-import { n as normalizePathname, t as formatEnvPort } from "../formatEnvPort-DpIXzPAZ.js";
+import { A as isPlainObject, N as isNil, S as isUndefined, T as assertIsPlainObject, b as hasOwnProp, k as isString, p as isNonEmptyArray, r as getPreciseType, t as assertIsBoolean, v as isError, y as isNonEmptyString } from "../assertIsBoolean-DR1SaXPD.js";
+import { t as assertIsString } from "../assertIsString-CEB07_83.js";
+import { t as safeStableStringify } from "../safeStableStringify-CXOZ9Ub8.js";
+import { t as isEmptyString } from "../isEmptyString-BXzKAC2j.js";
+import { t as removeSpaces } from "../removeSpaces-Bmc5DX4F.js";
+import { n as normalizePathname, t as formatEnvPort } from "../formatEnvPort-ByFVLjSV.js";
 function generateRoute(route, params) {
 	if (!isString(route) || isEmptyString(route)) throw new TypeError(`❌ 'generateRoute' Failed:\n- Invalid 'route' value.\n- Must be of type \`string\` and non-empty string, but received: "${getPreciseType(route)}": \`${safeStableStringify(route, { keepUndefined: true })}\`.`);
 	if (!/[\\[\]]/.test(route)) return route;

package/dist/next/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/next/generateRoute.ts","../../src/next/createBeApiUrl.ts","../../src/next/getBeApiUrl.ts","../../src/next/getBaseUrl.ts"],"sourcesContent":["import type { IsAny } from \"@rzl-zone/ts-types-plus\";\n\nimport { isNil } from \"@/predicates/is/isNil\";\nimport { isString } from \"@/predicates/is/isString\";\nimport { isEmptyString } from \"@/predicates/is/isEmptyString\";\nimport { isNonEmptyArray } from \"@/predicates/is/isNonEmptyArray\";\nimport { getPreciseType } from \"@/predicates/type/getPreciseType\";\nimport { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\nimport { assertIsPlainObject } from \"@/assertions/objects/assertIsPlainObject\";\nimport { safeStableStringify } from \"@/conversions/stringify/safeStableStringify\";\n\n/** ---------------------------------------------------------\n * * ***Extracts dynamic route parameters from a given route string.***\n * ---------------------------------------------------------\n * **This utility type recursively searches for dynamic segments within a route,\n * extracting each parameter and constructing an object where each key represents\n * a dynamic segment and its value is of type `string`.**\n * - ***⚠️ Warning:***\n *    - ***This types only support when using ***[`NextJS`](https://nextjs.org/)***.***\n * @template T - The route string containing potential dynamic segments.\n * @example\n * ```ts\n * type Params1 = ExtractRouteParams<\"/user/[id]\">;\n * // ➔ { id: string }\n * type Params2 = ExtractRouteParams<\"/post/[slug]/comment/[commentId]\">;\n * // ➔ { slug: string; commentId: string }\n * type Params3 = ExtractRouteParams<\"/dashboard\">;\n * // ➔ {} (no dynamic parameters)\n * ```\n */\nexport type ExtractRouteParams<T> = T extends string\n  ? HasDynamicSegments<T> extends true\n    ? T extends `${infer _Start}[${infer Param}]${infer Rest}`\n      ? { [K in Param | keyof ExtractRouteParams<Rest>]: string }\n      : unknown\n    : unknown\n  : unknown; // Ensures an empty object if no dynamic segments are found.\n\n/** ---------------------------------------------------------\n * * ***Determines whether a given route contains dynamic segments.***\n * ---------------------------------------------------------\n * **This type checks if the route includes at least one `[param]` pattern.\n * If it does, the result is `true`, otherwise `false`.**\n * - ***⚠️ Warning:***\n *    - ***This types only support when using ***[`NextJS`](https://nextjs.org/)***.***\n * @template T - The route string to be evaluated.\n * @example\n * ```ts\n * type HasParams1 = HasDynamicSegments<\"/user/[id]\">;\n * // ➔ true\n * type HasParams2 = HasDynamicSegments<\"/settings/profile\">;\n * // ➔ false\n * type HasParams3 = HasDynamicSegments<\"/blog/[category]/[slug]\">;\n * // ➔ true\n * ```\n */\nexport type HasDynamicSegments<T> = T extends `${string}[${string}]${string}`\n  ? true\n  : false;\n\ntype GenerateRouteResult<T> =\n  true extends IsAny<T> ? unknown : T extends string ? string : unknown;\n\n/** ---------------------------------\n * * ***Utility for NextJS: `generateRoute`.***\n * ---------------------------------\n * **Generates a URL by replacing dynamic route parameters with provided values.**\n * - ***⚠️ Warning:***\n *    - ***This function only support when using ***[`NextJS`](https://nextjs.org/)***.***\n * @template T - The route string containing dynamic segments in the format `[param]`.\n * @param {T} route - The route string containing dynamic segments.\n * @param {ExtractRouteParams<T>} [params] - An object containing key-value pairs that match the dynamic segments in the route.\n * @returns {string} The formatted URL with all dynamic segments replaced.\n * @throws **{@link Error | `Error`}** if the route contains dynamic segments but no parameters object is provided.\n * @throws **{@link Error | `Error`}** if a required parameter is missing from the `params` object.\n * @throws **{@link Error | `Error`}** if a parameter value is an empty string.\n * @throws **{@link Error | `Error`}** if any parameter contains invalid characters like `?`, `&`, `=`, `#`, `/`, spaces, `'`, `\"`, `(`, `)`, `+`, `;`, `%`, `@`, or `:`, which can cause URL issues.\n * @example\n * // Basic usage\n * generateRoute(\"/user/[id]\", { id: \"123\" });\n * // ➔ \"/user/123\"\n *\n * // No dynamic segments, returns as-is\n * generateRoute(\"/dashboard\");\n * // ➔ \"/dashboard\"\n *\n * // Throws an error due to missing parameters object\n * generateRoute(\"/profile/[username]\");\n * // ➔ ❌ Error: ❌ Missing parameters object for route: \"/profile/[username]\"\n *\n * // Throws an error due to an empty parameter value\n * generateRoute(\"/post/[category]/[slug]\", { category: \"tech\", slug: \"\" });\n * // ➔ ❌ Error: ❌ Parameter \"slug\" cannot be empty in route: \"/post/[category]/[slug]\"\n *\n * // Throws an error due to parameter containing invalid characters\n * generateRoute(\"/search/[query]\", { query: \"how to?learn\" });\n * // ➔ ❌ Error: ❌ Parameter \"query\" contains invalid character \"?\" in route: \"/search/[query]\"\n *\n * // Handles leading/trailing slashes correctly\n * generateRoute(\"/blog/[category]/[slug]\", { category: \"/news/\", slug: \"/latest-update/\" });\n * // ➔ ❌ Error: ❌ Parameter \"category\" and \"slug\" contains slashes \"/\" which is not allowed.\n */\nexport function generateRoute<T extends string>(\n  route: T extends string\n    ? HasDynamicSegments<T> extends true\n      ? T\n      : never\n    : never,\n  params: T extends string ? ExtractRouteParams<T> : undefined\n): GenerateRouteResult<T>;\nexport function generateRoute<T extends string>(\n  route: T extends string ? T : never,\n  params?: Extract<ExtractRouteParams<T>, Record<string, unknown>>\n): GenerateRouteResult<T>;\nexport function generateRoute<T = unknown>(\n  route: T extends string\n    ? HasDynamicSegments<T> extends true\n      ? T\n      : unknown\n    : unknown,\n  params?: T extends string ? ExtractRouteParams<T> : undefined\n): unknown;\nexport function generateRoute<T>(\n  route: T,\n  params?: ExtractRouteParams<T>\n): string | unknown {\n  //todo: Validate the route string\n  if (!isString(route) || isEmptyString(route)) {\n    throw new TypeError(\n      `❌ 'generateRoute' Failed:\\n- Invalid 'route' value.\\n- Must be of type \\`string\\` and non-empty string, but received: \"${getPreciseType(\n        route\n      )}\": \\`${safeStableStringify(route, {\n        keepUndefined: true\n      })}\\`.`\n    );\n  }\n\n  //todo: If no dynamic segments exist, return the route as-is immediately\n  if (!/[\\\\[\\]]/.test(route)) {\n    return route;\n  }\n\n  //todo: Validate that params is a plain object\n  assertIsPlainObject(params, {\n    message: ({ validType }) =>\n      `❌ 'generateRoute' Failed cause in route \"${route}\":\\n- Missing or invalid parameters \\`${validType}\\` for route: \"${route}\", must be of type \\`${validType}\\` mapping parameters.`\n  });\n\n  //todo: Ensure parameters are provided for dynamic routes.\n  if (isNil(params)) {\n    throw new TypeError(\n      `❌ 'generateRoute' Failed cause in route \"${route}\":\\n- Missing parameters \\`plain-object\\` for route: \"${route}\".`\n    );\n  }\n\n  //todo: Check for invalid characters that can break the URL format\n  const invalidChars = [\n    \"?\",\n    \"&\",\n    \"#\",\n    \"=\",\n    \"/\",\n    // \"`\",\n    // \" \",\n    // \".\",\n    \"'\",\n    // eslint-disable-next-line quotes\n    '\"',\n    \"(\",\n    \")\",\n    \"+\",\n    \";\",\n    \"%\",\n    \"@\",\n    \":\"\n  ];\n\n  const errors: string[] = [];\n\n  const requiredKeys = Array.from(route.matchAll(/\\[(\\w+)\\]/g)).map(\n    (m) => m[1] || \"\"\n  );\n\n  for (const key of requiredKeys) {\n    const value = params[key];\n\n    if (!isString(value)) {\n      errors.push(\n        `- Invalid parameter: \"${key}\" must be of type \\`string\\`, but received: \\`${getPreciseType(\n          value\n        )}\\`.`\n      );\n      continue;\n    }\n\n    if (isEmptyString(value)) {\n      errors.push(`- Parameter \"${key}\" cannot be empty string.`);\n      continue;\n    }\n\n    const foundInvalidChars = invalidChars.filter((char) =>\n      value.includes(char)\n    );\n\n    if (/\\s/.test(value)) {\n      foundInvalidChars.push(\"white-space(s)\");\n    }\n\n    if (foundInvalidChars.length > 0) {\n      const formattedChars = foundInvalidChars.map((c) =>\n        c === \"`\" ? \"backtick - (`)\" : `\\`${c}\\``\n      );\n\n      if (!invalidChars.includes(\"white-space(s)\"))\n        invalidChars.push(\"white-space(s)\");\n\n      const formattedInvalidChars = invalidChars.map((c) =>\n        c === \"`\" ? \"backtick - (`)\" : `\\`${c}\\``\n      );\n\n      errors.push(\n        `- Parameter \"${key}\" contains invalid characters (${formattedChars.join(\n          \", \"\n        )}). These characters are not allowed because they could cause issues in URL structure. The following characters are forbidden in route parameters: (${formattedInvalidChars.join(\n          \", \"\n        )}).`\n      );\n    }\n  }\n\n  if (isNonEmptyArray(errors)) {\n    throw new Error(\n      `❌ 'generateRoute' Failed cause in route \"${route}\":\\n${errors.join(\"\\n\")}.`\n    );\n  }\n\n  return route\n    .replace(/\\[(\\w+)\\]/g, (_, key) => {\n      const paramKey = isNonEmptyString(params[key]) ? params[key] : \"\";\n\n      return paramKey.trim().replace(/^\\/+|\\/+$/g, \"\");\n    })\n    .replace(/\\/+/g, \"/\");\n}\n","import { getBeApiUrl } from \"@/next\";\nimport { normalizePathname } from \"@/urls/pathname/normalizePathname\";\n\nimport { isNil } from \"@/predicates/is/isNil\";\nimport { isError } from \"@/predicates/is/isError\";\nimport { isString } from \"@/predicates/is/isString\";\nimport { isUndefined } from \"@/predicates/is/isUndefined\";\nimport { isPlainObject } from \"@/predicates/is/isPlainObject\";\nimport { getPreciseType } from \"@/predicates/type/getPreciseType\";\nimport { assertIsString } from \"@/assertions/strings/assertIsString\";\nimport { assertIsBoolean } from \"@/assertions/booleans/assertIsBoolean\";\n\ntype OptionsCreateBeApiUrl = {\n  /** * The prefix pathname api url, e.g:`\"http://localhost.com/your-target-prefix-entri-point-api-is-here\"`, default: `\"/api\"`.\n   *\n   * @default \"/api\" */\n  prefix?: string;\n  /** * Option to getting `prefix` and `pathname` of api url only `(removing origin base api url)`, default: `true`.\n   *\n   * @default true */\n  withOrigin?: boolean;\n};\n\n/** ---------------------------------\n * * ***Utility for NextJS: `createBeApiUrl`.***\n * ---------------------------------\n * **Constructs a backend API URL by appending a given pathname to the base API URL.**\n * - **ℹ️ Note:**\n *    - This function builds on top of `getBeApiUrl()`.\n * - **Determines the base API URL from:**\n *    - `NEXT_PUBLIC_BACKEND_API_URL` environment variable (or defaults to `\"http://localhost:8000\"`).\n *    - Automatically appends `NEXT_PUBLIC_PORT_BE` if the base URL does not already include a port.\n * - **Features of this function:**\n *    - Allows customizing the API path with an optional `prefix` (defaults to `\"/api\"`).\n *    - Can include or exclude the origin (protocol + host) via `withOrigin`.\n *    - Normalizes paths to avoid duplicate slashes.\n * - ***⚠️ Warning:***\n *    - ***This function only support when using ***[`NextJS`](https://nextjs.org/)***.***\n * @param {string|null|undefined} pathname - The API endpoint path (e.g., `/users` or `/v1/posts`), defaultValue: `\"\"`.\n * @param {OptionsCreateBeApiUrl} [options] - Configuration options.\n * @param {OptionsCreateBeApiUrl[\"prefix\"]} [options.prefix=\"/api\"] - The prefix for the API path (default is `\"/api\"`).\n * @param {OptionsCreateBeApiUrl[\"withOrigin\"]} [options.withOrigin=true] - Whether to include the full base URL or return only the API path.\n * @returns {string} The formatted API URL.\n * @throws **{@link TypeError | `TypeError`}** if `withOrigin` is not a boolean.\n * @throws **{@link TypeError | `TypeError`}** if `prefix` and `pathname` is not a string.\n * @throws **{@link Error | `Error`}** if constructing the API URL fails due to an invalid base URL.\n * @example\n * createBeApiUrl(\"/users\")\n * // ➔ \"http://localhost:8000/api/users\"\n * createBeApiUrl(\"/api/users\")\n * // ➔ \"http://localhost:8000/api/users\"\n * createBeApiUrl(\"/v1\", { prefix: \"/v1\" })\n * // ➔ \"http://localhost:8000/v1\"\n * createBeApiUrl(\"/v1/users\")\n * // ➔ \"http://localhost:8000/api/v1/users\"\n * createBeApiUrl(\"/v1/users\", { prefix: \"/v1\" })\n * // ➔ \"http://localhost:8000/v1/users\"\n * createBeApiUrl(\"/users\", { withOrigin: false })\n * // ➔ \"/api/users\"\n * createBeApiUrl(null, { withOrigin: false })\n * // ➔ \"/api\"\n * createBeApiUrl(undefined, { withOrigin: false })\n * // ➔ \"/api\"\n */\nexport const createBeApiUrl = (\n  /** * The pathname api url, e.g:`\"http://localhost.com/your-target-prefix-entri-point-api-is-here/your-target-pathname-is-here\"`.\n   *\n   * @default \"\"\n   */\n  pathname: string | null | undefined,\n  options: OptionsCreateBeApiUrl = {}\n): string => {\n  try {\n    // ✅ Type checks\n    assertIsString(isNil(pathname) ? \"\" : pathname, {\n      message({ currentType, validType }) {\n        return `First parameter (\\`pathname\\`) must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`;\n      }\n    });\n\n    if (!isPlainObject(options)) {\n      options = {};\n    }\n\n    let { prefix = \"/api\", withOrigin = true } = options;\n\n    if (!isUndefined(prefix) && !isString(prefix)) {\n      throw new TypeError(\n        `Parameter \\`prefix\\` property of the \\`options\\` (second parameter) must be of type \\`string\\`, but received: \\`${getPreciseType(\n          prefix\n        )}\\`.`\n      );\n    }\n\n    assertIsBoolean(withOrigin, {\n      message: ({ currentType, validType }) =>\n        `Parameter \\`withOrigin\\` property of the \\`options\\` (second parameter) must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`\n    });\n\n    // Normalize pathname\n    pathname = normalizePathname(pathname);\n    // Normalize prefix\n    prefix = normalizePathname(prefix);\n\n    const normalizedPrefix = prefix.endsWith(\"/\") ? prefix : prefix + \"/\";\n\n    // Remove duplicate prefix in pathname\n    if (\n      pathname === prefix ||\n      pathname === prefix + \"/\" ||\n      pathname.startsWith(normalizedPrefix)\n    ) {\n      pathname = pathname.slice(prefix.length);\n      pathname = normalizePathname(pathname);\n    }\n\n    // Get the base API URL\n    const baseApiUrl = getBeApiUrl({ suffix: prefix });\n\n    function joinPath(a: string, b: string) {\n      return `${a.replace(/\\/+$/, \"\")}/${b.replace(/^\\/+/, \"\")}`;\n    }\n\n    const fullPath = withOrigin\n      ? joinPath(baseApiUrl, pathname)\n      : joinPath(new URL(baseApiUrl).pathname, pathname);\n\n    return fullPath.replace(/\\/+$/, \"\");\n  } catch (err) {\n    if (isError(err)) {\n      throw err;\n    } else {\n      throw new Error(\n        \"Failed to generate backend API URL in `createBeApiUrl()`, Error: \" +\n          String(err).trim(),\n        { cause: err }\n      );\n    }\n\n    // if (isError(err)) {\n    //   throw err;\n    // } else\n    //   throw new Error(\n    //     \"Failed to generate backend API URL in `createBeApiUrl()`, Error: \" +\n    //       new Error(String(err)).message.trim()\n    //   );\n  }\n};\n","import { formatEnvPort } from \"@/urls/utils/formatEnvPort\";\nimport { hasOwnProp } from \"@/predicates/has/hasOwnProp\";\nimport { isPlainObject } from \"@/predicates/is/isPlainObject\";\nimport { removeSpaces } from \"@/strings/sanitizations/removeSpaces\";\nimport { assertIsString } from \"@/assertions/strings/assertIsString\";\n\ntype OptionsGetBeApiUrl = {\n  /** * ***The Suffix origin base api url, e.g:`http://localhost.com/api`, default: `\"/\"`.***\n   *\n   * @default \"/\" */\n  suffix?: string;\n};\n\n/** ---------------------------------------------------\n * * ***Utility for NextJS: `getBeApiUrl`.***\n * ---------------------------------------------------\n * **This function determines the backend API base URL from the `NEXT_PUBLIC_BACKEND_API_URL` environment variable (retrieves the base API URL of the backend).**\n * - **Behavior:**\n *    - If the variable is not set, it defaults to `\"http://localhost:8000\"`.\n *    - It also allows adding an optional suffix to the returned URL.\n * - ***⚠️ Warning:***\n *    - ***This function only support when using ***[`NextJS`](https://nextjs.org/)***.***\n * @description\n * This function determines the backend API base URL from the `NEXT_PUBLIC_BACKEND_API_URL` environment variable.\n * - If `NEXT_PUBLIC_BACKEND_API_URL` is not set, it defaults to `\"http://localhost:8000\"`.\n * - If `NEXT_PUBLIC_BACKEND_API_URL` does **not** contain a port, it appends one from `NEXT_PUBLIC_PORT_BE` if available.\n * - Supports appending optional suffix (like `\"/api\"`).\n * @param {OptionsGetBeApiUrl|undefined} options - Configuration options.\n * @param {OptionsGetBeApiUrl[\"suffix\"]} [options.suffix=\"/\"] - The suffix to append to the base API URL.\n * @returns {string} The formatted backend API base URL.\n * @throws **{@link TypeError | `TypeError`}** if `suffix` is not a `string`.\n * @throws **{@link Error | `Error`}** if `NEXT_PUBLIC_BACKEND_API_URL` is invalid.\n * @example\n * // With NEXT_PUBLIC_BACKEND_API_URL set at `*.env` file\n * NEXT_PUBLIC_BACKEND_API_URL = \"https://api.example.com\";\n * getBeApiUrl();\n * // ➔ \"https://api.example.com/\"\n *\n * // With NEXT_PUBLIC_BACKEND_API_URL but no port, using NEXT_PUBLIC_PORT_BE at `*.env` file\n * NEXT_PUBLIC_BACKEND_API_URL = \"http://localhost\";\n * NEXT_PUBLIC_PORT_BE = \"5000\";\n * getBeApiUrl({ suffix: \"/api\" });\n * // ➔ \"http://localhost:5000/api\"\n *\n * // Without NEXT_PUBLIC_BACKEND_API_URL at `*.env` file (defaults to localhost:8000)\n * delete NEXT_PUBLIC_BACKEND_API_URL;\n * getBeApiUrl({ suffix: \"/v1\" });\n * // ➔ \"http://localhost:8000/v1\"\n */\nexport const getBeApiUrl = (options: OptionsGetBeApiUrl = {}): string => {\n  if (!isPlainObject(options)) options = {};\n\n  let suffix = hasOwnProp(options, \"suffix\") ? options.suffix : \"/\";\n\n  // Ensure suffix is a string\n  assertIsString(suffix, {\n    message({ currentType, validType }) {\n      return `Parameter \\`suffix\\` property of the first parameter must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`;\n    }\n  });\n\n  try {\n    let rawBaseUrl = process.env.NEXT_PUBLIC_BACKEND_API_URL?.trim();\n\n    if (rawBaseUrl) {\n      rawBaseUrl = removeSpaces(rawBaseUrl);\n      // const hasPort = /:\\/\\/[^/]+:\\d+/.test(rawBaseUrl);\n      const urlObj = new URL(rawBaseUrl);\n      const hasPort = !!urlObj.port;\n\n      if (!hasPort && process.env.NEXT_PUBLIC_PORT_BE) {\n        rawBaseUrl =\n          urlObj.origin +\n          formatEnvPort(process.env.NEXT_PUBLIC_PORT_BE, {\n            prefixColon: true\n          });\n      }\n    } else {\n      // fallback\n      rawBaseUrl =\n        \"http://localhost\" +\n        formatEnvPort(process.env.NEXT_PUBLIC_PORT_BE || \"8000\", {\n          prefixColon: true\n        });\n    }\n\n    suffix = removeSpaces(suffix).length ? removeSpaces(suffix) : \"/\";\n    const baseApiUrl = new URL(rawBaseUrl.replace(/\\/+$/, \"\")).origin;\n\n    const finalSuffix =\n      suffix === \"/\"\n        ? \"/\"\n        : `${suffix.startsWith(\"/\") ? \"\" : \"/\"}${suffix.replace(/\\/+$/, \"\")}`;\n\n    return `${baseApiUrl}${finalSuffix}`;\n  } catch (error) {\n    throw new Error(\n      \"Invalid `NEXT_PUBLIC_BACKEND_API_URL`, failed to generate from `getBeApiUrl()`, Error:\" +\n        error,\n      { cause: error }\n    );\n  }\n};\n","import { formatEnvPort } from \"@/urls/utils/formatEnvPort\";\nimport { removeSpaces } from \"@/strings/sanitizations/removeSpaces\";\n\n/** ---------------------------------------------------\n * * ***Utility for NextJS: `getBaseUrl`.***\n * ---------------------------------------------------\n * **Retrieves the base URL of the application.**\n * - **Behavior:**\n *    - It determines the base URL from the `NEXT_PUBLIC_BASE_URL` environment variable.\n *    - If `NEXT_PUBLIC_BASE_URL` is not set, it defaults to `\"http://localhost:3000\"`.\n *    - If `NEXT_PUBLIC_BASE_URL` does **not** contain a port, it appends one from `NEXT_PUBLIC_PORT_FE` if available.\n *    - Ensures the final URL is valid and normalized (no trailing slashes).\n * - ***⚠️ Warning:***\n *    - ***This function only support when using ***[`NextJS`](https://nextjs.org/)***.***\n * @returns {string} The resolved base URL of the application.\n * @throws **{@link Error | `Error`}** if the constructed URL is invalid or malformed.\n * @example\n * // With environment variable set at `*.env` file\n * NEXT_PUBLIC_BASE_URL = \"https://example.com\";\n * getBaseUrl();\n * // ➔ \"https://example.com\"\n *\n * // With custom port via NEXT_PUBLIC_PORT_FE at `*.env` file\n * NEXT_PUBLIC_BASE_URL = \"http://localhost\";\n * NEXT_PUBLIC_PORT_FE = \"4000\";\n * getBaseUrl();\n * // ➔ \"http://localhost:4000\"\n *\n * // Without environment variable at `*.env` file\n * delete NEXT_PUBLIC_BASE_URL;\n * getBaseUrl();\n * // ➔ \"http://localhost:3000\"\n */\nexport const getBaseUrl = (): string => {\n  try {\n    const baseEnv = process.env.NEXT_PUBLIC_BASE_URL?.trim();\n    const portEnv = process.env.NEXT_PUBLIC_PORT_FE?.trim();\n\n    let baseUrl = baseEnv || \"http://localhost\";\n\n    // Always clean trailing slashes first\n    baseUrl = removeSpaces(baseUrl).replace(/\\/+$/, \"\");\n\n    // Check if already contains port\n    const hasPort = /:\\/\\/[^/]+:\\d+/.test(baseUrl);\n\n    if (!hasPort && portEnv) {\n      baseUrl += formatEnvPort(portEnv, { prefixColon: true });\n    } else if (!hasPort && !baseEnv) {\n      baseUrl += \":3000\";\n    }\n\n    const url = new URL(baseUrl);\n    return `${url.protocol}//${url.hostname}${url.port ? `:${url.port}` : \"\"}`;\n  } catch (error) {\n    throw new Error(\n      \"Invalid `NEXT_PUBLIC_BASE_URL`, failed to generate from `getBaseUrl()`, Error:\" +\n        error,\n      { cause: error }\n    );\n  }\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;AA0HA,SAAgB,cACd,OACA,QACkB;CAElB,IAAI,CAAC,SAAS,MAAM,IAAI,cAAc,MAAM,EAC1C,MAAM,IAAI,UACR,0HAA0H,eACxH,MACD,CAAC,OAAO,oBAAoB,OAAO,EAClC,eAAe,MAChB,CAAC,CAAC,KACJ;CAIH,IAAI,CAAC,UAAU,KAAK,MAAM,EACxB,OAAO;CAIT,oBAAoB,QAAQ,EAC1B,UAAU,EAAE,gBACV,4CAA4C,MAAM,wCAAwC,UAAU,iBAAiB,MAAM,uBAAuB,UAAU,yBAC/J,CAAC;CAGF,IAAI,MAAM,OAAO,EACf,MAAM,IAAI,UACR,4CAA4C,MAAM,wDAAwD,MAAM,IACjH;CAIH,MAAM,eAAe;EACnB;EACA;EACA;EACA;EACA;EAIA;EAEA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD;CAED,MAAM,SAAmB,EAAE;CAE3B,MAAM,eAAe,MAAM,KAAK,MAAM,SAAS,aAAa,CAAC,CAAC,KAC3D,MAAM,EAAE,MAAM,GAChB;CAED,KAAK,MAAM,OAAO,cAAc;EAC9B,MAAM,QAAQ,OAAO;EAErB,IAAI,CAAC,SAAS,MAAM,EAAE;GACpB,OAAO,KACL,yBAAyB,IAAI,gDAAgD,eAC3E,MACD,CAAC,KACH;GACD;;EAGF,IAAI,cAAc,MAAM,EAAE;GACxB,OAAO,KAAK,gBAAgB,IAAI,2BAA2B;GAC3D;;EAGF,MAAM,oBAAoB,aAAa,QAAQ,SAC7C,MAAM,SAAS,KAAK,CACrB;EAED,IAAI,KAAK,KAAK,MAAM,EAClB,kBAAkB,KAAK,iBAAiB;EAG1C,IAAI,kBAAkB,SAAS,GAAG;GAChC,MAAM,iBAAiB,kBAAkB,KAAK,MAC5C,MAAM,MAAM,mBAAmB,KAAK,EAAE,IACvC;GAED,IAAI,CAAC,aAAa,SAAS,iBAAiB,EAC1C,aAAa,KAAK,iBAAiB;GAErC,MAAM,wBAAwB,aAAa,KAAK,MAC9C,MAAM,MAAM,mBAAmB,KAAK,EAAE,IACvC;GAED,OAAO,KACL,gBAAgB,IAAI,iCAAiC,eAAe,KAClE,KACD,CAAC,qJAAqJ,sBAAsB,KAC3K,KACD,CAAC,IACH;;;CAIL,IAAI,gBAAgB,OAAO,EACzB,MAAM,IAAI,MACR,4CAA4C,MAAM,MAAM,OAAO,KAAK,KAAK,CAAC,GAC3E;CAGH,OAAO,MACJ,QAAQ,eAAe,GAAG,QAAQ;EAGjC,QAFiB,iBAAiB,OAAO,KAAK,GAAG,OAAO,OAAO,IAE/C,MAAM,CAAC,QAAQ,cAAc,GAAG;GAChD,CACD,QAAQ,QAAQ,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AClLzB,MAAa,kBAKX,UACA,UAAiC,EAAE,KACxB;CACX,IAAI;EAEF,eAAe,MAAM,SAAS,GAAG,KAAK,UAAU,EAC9C,QAAQ,EAAE,aAAa,aAAa;GAClC,OAAO,oDAAoD,UAAU,sBAAsB,YAAY;KAE1G,CAAC;EAEF,IAAI,CAAC,cAAc,QAAQ,EACzB,UAAU,EAAE;EAGd,IAAI,EAAE,SAAS,QAAQ,aAAa,SAAS;EAE7C,IAAI,CAAC,YAAY,OAAO,IAAI,CAAC,SAAS,OAAO,EAC3C,MAAM,IAAI,UACR,mHAAmH,eACjH,OACD,CAAC,KACH;EAGH,gBAAgB,YAAY,EAC1B,UAAU,EAAE,aAAa,gBACvB,6FAA6F,UAAU,sBAAsB,YAAY,MAC5I,CAAC;EAGF,WAAW,kBAAkB,SAAS;EAEtC,SAAS,kBAAkB,OAAO;EAElC,MAAM,mBAAmB,OAAO,SAAS,IAAI,GAAG,SAAS,SAAS;EAGlE,IACE,aAAa,UACb,aAAa,SAAS,OACtB,SAAS,WAAW,iBAAiB,EACrC;GACA,WAAW,SAAS,MAAM,OAAO,OAAO;GACxC,WAAW,kBAAkB,SAAS;;EAIxC,MAAM,aAAa,YAAY,EAAE,QAAQ,QAAQ,CAAC;EAElD,SAAS,SAAS,GAAW,GAAW;GACtC,OAAO,GAAG,EAAE,QAAQ,QAAQ,GAAG,CAAC,GAAG,EAAE,QAAQ,QAAQ,GAAG;;EAO1D,QAJiB,aACb,SAAS,YAAY,SAAS,GAC9B,SAAS,IAAI,IAAI,WAAW,CAAC,UAAU,SAAS,EAEpC,QAAQ,QAAQ,GAAG;UAC5B,KAAK;EACZ,IAAI,QAAQ,IAAI,EACd,MAAM;OAEN,MAAM,IAAI,MACR,sEACE,OAAO,IAAI,CAAC,MAAM,EACpB,EAAE,OAAO,KAAK,CACf;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACvFP,MAAa,eAAe,UAA8B,EAAE,KAAa;CACvE,IAAI,CAAC,cAAc,QAAQ,EAAE,UAAU,EAAE;CAEzC,IAAI,SAAS,WAAW,SAAS,SAAS,GAAG,QAAQ,SAAS;CAG9D,eAAe,QAAQ,EACrB,QAAQ,EAAE,aAAa,aAAa;EAClC,OAAO,0EAA0E,UAAU,sBAAsB,YAAY;IAEhI,CAAC;CAEF,IAAI;EACF,IAAI,aAAa,QAAQ,IAAI,6BAA6B,MAAM;EAEhE,IAAI,YAAY;GACd,aAAa,aAAa,WAAW;GAErC,MAAM,SAAS,IAAI,IAAI,WAAW;GAGlC,IAAI,CAAC,CAFY,CAAC,OAAO,QAET,QAAQ,IAAI,qBAC1B,aACE,OAAO,SACP,cAAc,QAAQ,IAAI,qBAAqB,EAC7C,aAAa,MACd,CAAC;SAIN,aACE,qBACA,cAAc,QAAQ,IAAI,uBAAuB,QAAQ,EACvD,aAAa,MACd,CAAC;EAGN,SAAS,aAAa,OAAO,CAAC,SAAS,aAAa,OAAO,GAAG;EAQ9D,OAAO,GAPY,IAAI,IAAI,WAAW,QAAQ,QAAQ,GAAG,CAAC,CAAC,SAGzD,WAAW,MACP,MACA,GAAG,OAAO,WAAW,IAAI,GAAG,KAAK,MAAM,OAAO,QAAQ,QAAQ,GAAG;UAGhE,OAAO;EACd,MAAM,IAAI,MACR,2FACE,OACF,EAAE,OAAO,OAAO,CACjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACnEL,MAAa,mBAA2B;CACtC,IAAI;EACF,MAAM,UAAU,QAAQ,IAAI,sBAAsB,MAAM;EACxD,MAAM,UAAU,QAAQ,IAAI,qBAAqB,MAAM;EAEvD,IAAI,UAAU,WAAW;EAGzB,UAAU,aAAa,QAAQ,CAAC,QAAQ,QAAQ,GAAG;EAGnD,MAAM,UAAU,iBAAiB,KAAK,QAAQ;EAE9C,IAAI,CAAC,WAAW,SACd,WAAW,cAAc,SAAS,EAAE,aAAa,MAAM,CAAC;OACnD,IAAI,CAAC,WAAW,CAAC,SACtB,WAAW;EAGb,MAAM,MAAM,IAAI,IAAI,QAAQ;EAC5B,OAAO,GAAG,IAAI,SAAS,IAAI,IAAI,WAAW,IAAI,OAAO,IAAI,IAAI,SAAS;UAC/D,OAAO;EACd,MAAM,IAAI,MACR,mFACE,OACF,EAAE,OAAO,OAAO,CACjB"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/next/generateRoute.ts","../../src/next/createBeApiUrl.ts","../../src/next/getBeApiUrl.ts","../../src/next/getBaseUrl.ts"],"sourcesContent":["import type { IsAny } from \"@rzl-zone/ts-types-plus\";\n\nimport { isNil } from \"@/predicates/is/isNil\";\nimport { isString } from \"@/predicates/is/isString\";\nimport { isEmptyString } from \"@/predicates/is/isEmptyString\";\nimport { isNonEmptyArray } from \"@/predicates/is/isNonEmptyArray\";\nimport { getPreciseType } from \"@/predicates/type/getPreciseType\";\nimport { isNonEmptyString } from \"@/predicates/is/isNonEmptyString\";\nimport { assertIsPlainObject } from \"@/assertions/objects/assertIsPlainObject\";\nimport { safeStableStringify } from \"@/conversions/stringify/safeStableStringify\";\n\n/** ---------------------------------------------------------\n * * ***Extracts dynamic route parameters from a given route string.***\n * ---------------------------------------------------------\n * **This utility type recursively searches for dynamic segments within a route,\n * extracting each parameter and constructing an object where each key represents\n * a dynamic segment and its value is of type `string`.**\n * - ***⚠️ Warning:***\n *    - ***This types only support when using ***[`NextJS`](https://nextjs.org/)***.***\n * @template T - The route string containing potential dynamic segments.\n * @example\n * ```ts\n * type Params1 = ExtractRouteParams<\"/user/[id]\">;\n * // ➔ { id: string }\n * type Params2 = ExtractRouteParams<\"/post/[slug]/comment/[commentId]\">;\n * // ➔ { slug: string; commentId: string }\n * type Params3 = ExtractRouteParams<\"/dashboard\">;\n * // ➔ {} (no dynamic parameters)\n * ```\n */\nexport type ExtractRouteParams<T> = T extends string\n  ? HasDynamicSegments<T> extends true\n    ? T extends `${infer _Start}[${infer Param}]${infer Rest}`\n      ? { [K in Param | keyof ExtractRouteParams<Rest>]: string }\n      : unknown\n    : unknown\n  : unknown; // Ensures an empty object if no dynamic segments are found.\n\n/** ---------------------------------------------------------\n * * ***Determines whether a given route contains dynamic segments.***\n * ---------------------------------------------------------\n * **This type checks if the route includes at least one `[param]` pattern.\n * If it does, the result is `true`, otherwise `false`.**\n * - ***⚠️ Warning:***\n *    - ***This types only support when using ***[`NextJS`](https://nextjs.org/)***.***\n * @template T - The route string to be evaluated.\n * @example\n * ```ts\n * type HasParams1 = HasDynamicSegments<\"/user/[id]\">;\n * // ➔ true\n * type HasParams2 = HasDynamicSegments<\"/settings/profile\">;\n * // ➔ false\n * type HasParams3 = HasDynamicSegments<\"/blog/[category]/[slug]\">;\n * // ➔ true\n * ```\n */\nexport type HasDynamicSegments<T> = T extends `${string}[${string}]${string}`\n  ? true\n  : false;\n\ntype GenerateRouteResult<T> =\n  true extends IsAny<T> ? unknown : T extends string ? string : unknown;\n\n/** ---------------------------------\n * * ***Utility for NextJS: `generateRoute`.***\n * ---------------------------------\n * **Generates a URL by replacing dynamic route parameters with provided values.**\n * - ***⚠️ Warning:***\n *    - ***This function only support when using ***[`NextJS`](https://nextjs.org/)***.***\n * @template T - The route string containing dynamic segments in the format `[param]`.\n * @param {T} route - The route string containing dynamic segments.\n * @param {ExtractRouteParams<T>} [params] - An object containing key-value pairs that match the dynamic segments in the route.\n * @returns {string} The formatted URL with all dynamic segments replaced.\n * @throws **{@link Error | `Error`}** if the route contains dynamic segments but no parameters object is provided.\n * @throws **{@link Error | `Error`}** if a required parameter is missing from the `params` object.\n * @throws **{@link Error | `Error`}** if a parameter value is an empty string.\n * @throws **{@link Error | `Error`}** if any parameter contains invalid characters like `?`, `&`, `=`, `#`, `/`, spaces, `'`, `\"`, `(`, `)`, `+`, `;`, `%`, `@`, or `:`, which can cause URL issues.\n * @example\n * // Basic usage\n * generateRoute(\"/user/[id]\", { id: \"123\" });\n * // ➔ \"/user/123\"\n *\n * // No dynamic segments, returns as-is\n * generateRoute(\"/dashboard\");\n * // ➔ \"/dashboard\"\n *\n * // Throws an error due to missing parameters object\n * generateRoute(\"/profile/[username]\");\n * // ➔ ❌ Error: ❌ Missing parameters object for route: \"/profile/[username]\"\n *\n * // Throws an error due to an empty parameter value\n * generateRoute(\"/post/[category]/[slug]\", { category: \"tech\", slug: \"\" });\n * // ➔ ❌ Error: ❌ Parameter \"slug\" cannot be empty in route: \"/post/[category]/[slug]\"\n *\n * // Throws an error due to parameter containing invalid characters\n * generateRoute(\"/search/[query]\", { query: \"how to?learn\" });\n * // ➔ ❌ Error: ❌ Parameter \"query\" contains invalid character \"?\" in route: \"/search/[query]\"\n *\n * // Handles leading/trailing slashes correctly\n * generateRoute(\"/blog/[category]/[slug]\", { category: \"/news/\", slug: \"/latest-update/\" });\n * // ➔ ❌ Error: ❌ Parameter \"category\" and \"slug\" contains slashes \"/\" which is not allowed.\n */\nexport function generateRoute<T extends string>(\n  route: T extends string\n    ? HasDynamicSegments<T> extends true\n      ? T\n      : never\n    : never,\n  params: T extends string ? ExtractRouteParams<T> : undefined\n): GenerateRouteResult<T>;\nexport function generateRoute<T extends string>(\n  route: T extends string ? T : never,\n  params?: Extract<ExtractRouteParams<T>, Record<string, unknown>>\n): GenerateRouteResult<T>;\nexport function generateRoute<T = unknown>(\n  route: T extends string\n    ? HasDynamicSegments<T> extends true\n      ? T\n      : unknown\n    : unknown,\n  params?: T extends string ? ExtractRouteParams<T> : undefined\n): unknown;\nexport function generateRoute<T>(\n  route: T,\n  params?: ExtractRouteParams<T>\n): string | unknown {\n  //todo: Validate the route string\n  if (!isString(route) || isEmptyString(route)) {\n    throw new TypeError(\n      `❌ 'generateRoute' Failed:\\n- Invalid 'route' value.\\n- Must be of type \\`string\\` and non-empty string, but received: \"${getPreciseType(\n        route\n      )}\": \\`${safeStableStringify(route, {\n        keepUndefined: true\n      })}\\`.`\n    );\n  }\n\n  //todo: If no dynamic segments exist, return the route as-is immediately\n  if (!/[\\\\[\\]]/.test(route)) {\n    return route;\n  }\n\n  //todo: Validate that params is a plain object\n  assertIsPlainObject(params, {\n    message: ({ validType }) =>\n      `❌ 'generateRoute' Failed cause in route \"${route}\":\\n- Missing or invalid parameters \\`${validType}\\` for route: \"${route}\", must be of type \\`${validType}\\` mapping parameters.`\n  });\n\n  //todo: Ensure parameters are provided for dynamic routes.\n  if (isNil(params)) {\n    throw new TypeError(\n      `❌ 'generateRoute' Failed cause in route \"${route}\":\\n- Missing parameters \\`plain-object\\` for route: \"${route}\".`\n    );\n  }\n\n  //todo: Check for invalid characters that can break the URL format\n  const invalidChars = [\n    \"?\",\n    \"&\",\n    \"#\",\n    \"=\",\n    \"/\",\n    \"'\",\n    // eslint-disable-next-line quotes\n    '\"',\n    \"(\",\n    \")\",\n    \"+\",\n    \";\",\n    \"%\",\n    \"@\",\n    \":\"\n  ];\n\n  const errors: string[] = [];\n\n  const requiredKeys = Array.from(route.matchAll(/\\[(\\w+)\\]/g)).map(\n    (m) => m[1] || \"\"\n  );\n\n  for (const key of requiredKeys) {\n    const value = params[key];\n\n    if (!isString(value)) {\n      errors.push(\n        `- Invalid parameter: \"${key}\" must be of type \\`string\\`, but received: \\`${getPreciseType(\n          value\n        )}\\`.`\n      );\n      continue;\n    }\n\n    if (isEmptyString(value)) {\n      errors.push(`- Parameter \"${key}\" cannot be empty string.`);\n      continue;\n    }\n\n    const foundInvalidChars = invalidChars.filter((char) =>\n      value.includes(char)\n    );\n\n    if (/\\s/.test(value)) {\n      foundInvalidChars.push(\"white-space(s)\");\n    }\n\n    if (foundInvalidChars.length > 0) {\n      const formattedChars = foundInvalidChars.map((c) =>\n        c === \"`\" ? \"backtick - (`)\" : `\\`${c}\\``\n      );\n\n      if (!invalidChars.includes(\"white-space(s)\"))\n        invalidChars.push(\"white-space(s)\");\n\n      const formattedInvalidChars = invalidChars.map((c) =>\n        c === \"`\" ? \"backtick - (`)\" : `\\`${c}\\``\n      );\n\n      errors.push(\n        `- Parameter \"${key}\" contains invalid characters (${formattedChars.join(\n          \", \"\n        )}). These characters are not allowed because they could cause issues in URL structure. The following characters are forbidden in route parameters: (${formattedInvalidChars.join(\n          \", \"\n        )}).`\n      );\n    }\n  }\n\n  if (isNonEmptyArray(errors)) {\n    throw new Error(\n      `❌ 'generateRoute' Failed cause in route \"${route}\":\\n${errors.join(\"\\n\")}.`\n    );\n  }\n\n  return route\n    .replace(/\\[(\\w+)\\]/g, (_, key) => {\n      const paramKey = isNonEmptyString(params[key]) ? params[key] : \"\";\n\n      return paramKey.trim().replace(/^\\/+|\\/+$/g, \"\");\n    })\n    .replace(/\\/+/g, \"/\");\n}\n","import { getBeApiUrl } from \"@/next\";\nimport { normalizePathname } from \"@/urls/pathname/normalizePathname\";\n\nimport { isNil } from \"@/predicates/is/isNil\";\nimport { isError } from \"@/predicates/is/isError\";\nimport { isString } from \"@/predicates/is/isString\";\nimport { isUndefined } from \"@/predicates/is/isUndefined\";\nimport { isPlainObject } from \"@/predicates/is/isPlainObject\";\nimport { getPreciseType } from \"@/predicates/type/getPreciseType\";\nimport { assertIsString } from \"@/assertions/strings/assertIsString\";\nimport { assertIsBoolean } from \"@/assertions/booleans/assertIsBoolean\";\n\ntype OptionsCreateBeApiUrl = {\n  /** * The prefix pathname api url, e.g:`\"http://localhost.com/your-target-prefix-entri-point-api-is-here\"`, default: `\"/api\"`.\n   *\n   * @default \"/api\" */\n  prefix?: string;\n  /** * Option to getting `prefix` and `pathname` of api url only `(removing origin base api url)`, default: `true`.\n   *\n   * @default true */\n  withOrigin?: boolean;\n};\n\n/** ---------------------------------\n * * ***Utility for NextJS: `createBeApiUrl`.***\n * ---------------------------------\n * **Constructs a backend API URL by appending a given pathname to the base API URL.**\n * - **ℹ️ Note:**\n *    - This function builds on top of `getBeApiUrl()`.\n * - **Determines the base API URL from:**\n *    - `NEXT_PUBLIC_BACKEND_API_URL` environment variable (or defaults to `\"http://localhost:8000\"`).\n *    - Automatically appends `NEXT_PUBLIC_PORT_BE` if the base URL does not already include a port.\n * - **Features of this function:**\n *    - Allows customizing the API path with an optional `prefix` (defaults to `\"/api\"`).\n *    - Can include or exclude the origin (protocol + host) via `withOrigin`.\n *    - Normalizes paths to avoid duplicate slashes.\n * - ***⚠️ Warning:***\n *    - ***This function only support when using ***[`NextJS`](https://nextjs.org/)***.***\n * @param {string|null|undefined} pathname - The API endpoint path (e.g., `/users` or `/v1/posts`), defaultValue: `\"\"`.\n * @param {OptionsCreateBeApiUrl} [options] - Configuration options.\n * @param {OptionsCreateBeApiUrl[\"prefix\"]} [options.prefix=\"/api\"] - The prefix for the API path (default is `\"/api\"`).\n * @param {OptionsCreateBeApiUrl[\"withOrigin\"]} [options.withOrigin=true] - Whether to include the full base URL or return only the API path.\n * @returns {string} The formatted API URL.\n * @throws **{@link TypeError | `TypeError`}** if `withOrigin` is not a boolean.\n * @throws **{@link TypeError | `TypeError`}** if `prefix` and `pathname` is not a string.\n * @throws **{@link Error | `Error`}** if constructing the API URL fails due to an invalid base URL.\n * @example\n * createBeApiUrl(\"/users\")\n * // ➔ \"http://localhost:8000/api/users\"\n * createBeApiUrl(\"/api/users\")\n * // ➔ \"http://localhost:8000/api/users\"\n * createBeApiUrl(\"/v1\", { prefix: \"/v1\" })\n * // ➔ \"http://localhost:8000/v1\"\n * createBeApiUrl(\"/v1/users\")\n * // ➔ \"http://localhost:8000/api/v1/users\"\n * createBeApiUrl(\"/v1/users\", { prefix: \"/v1\" })\n * // ➔ \"http://localhost:8000/v1/users\"\n * createBeApiUrl(\"/users\", { withOrigin: false })\n * // ➔ \"/api/users\"\n * createBeApiUrl(null, { withOrigin: false })\n * // ➔ \"/api\"\n * createBeApiUrl(undefined, { withOrigin: false })\n * // ➔ \"/api\"\n */\nexport const createBeApiUrl = (\n  /** * The pathname api url, e.g:`\"http://localhost.com/your-target-prefix-entri-point-api-is-here/your-target-pathname-is-here\"`.\n   *\n   * @default \"\"\n   */\n  pathname: string | null | undefined,\n  options: OptionsCreateBeApiUrl = {}\n): string => {\n  try {\n    // ✅ Type checks\n    assertIsString(isNil(pathname) ? \"\" : pathname, {\n      message({ currentType, validType }) {\n        return `First parameter (\\`pathname\\`) must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`;\n      }\n    });\n\n    if (!isPlainObject(options)) {\n      options = {};\n    }\n\n    let { prefix = \"/api\", withOrigin = true } = options;\n\n    if (!isUndefined(prefix) && !isString(prefix)) {\n      throw new TypeError(\n        `Parameter \\`prefix\\` property of the \\`options\\` (second parameter) must be of type \\`string\\`, but received: \\`${getPreciseType(\n          prefix\n        )}\\`.`\n      );\n    }\n\n    assertIsBoolean(withOrigin, {\n      message: ({ currentType, validType }) =>\n        `Parameter \\`withOrigin\\` property of the \\`options\\` (second parameter) must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`\n    });\n\n    // Normalize pathname\n    pathname = normalizePathname(pathname);\n    // Normalize prefix\n    prefix = normalizePathname(prefix);\n\n    const normalizedPrefix = prefix.endsWith(\"/\") ? prefix : prefix + \"/\";\n\n    // Remove duplicate prefix in pathname\n    if (\n      pathname === prefix ||\n      pathname === prefix + \"/\" ||\n      pathname.startsWith(normalizedPrefix)\n    ) {\n      pathname = pathname.slice(prefix.length);\n      pathname = normalizePathname(pathname);\n    }\n\n    // Get the base API URL\n    const baseApiUrl = getBeApiUrl({ suffix: prefix });\n\n    function joinPath(a: string, b: string) {\n      return `${a.replace(/\\/+$/, \"\")}/${b.replace(/^\\/+/, \"\")}`;\n    }\n\n    const fullPath = withOrigin\n      ? joinPath(baseApiUrl, pathname)\n      : joinPath(new URL(baseApiUrl).pathname, pathname);\n\n    return fullPath.replace(/\\/+$/, \"\");\n  } catch (err) {\n    if (isError(err)) {\n      throw err;\n    } else {\n      throw new Error(\n        \"Failed to generate backend API URL in `createBeApiUrl()`, Error: \" +\n          String(err).trim(),\n        { cause: err }\n      );\n    }\n  }\n};\n","import { formatEnvPort } from \"@/urls/utils/formatEnvPort\";\nimport { hasOwnProp } from \"@/predicates/has/hasOwnProp\";\nimport { isPlainObject } from \"@/predicates/is/isPlainObject\";\nimport { removeSpaces } from \"@/strings/sanitizations/removeSpaces\";\nimport { assertIsString } from \"@/assertions/strings/assertIsString\";\n\ntype OptionsGetBeApiUrl = {\n  /** * ***The Suffix origin base api url, e.g:`http://localhost.com/api`, default: `\"/\"`.***\n   *\n   * @default \"/\" */\n  suffix?: string;\n};\n\n/** ---------------------------------------------------\n * * ***Utility for NextJS: `getBeApiUrl`.***\n * ---------------------------------------------------\n * **This function determines the backend API base URL from the `NEXT_PUBLIC_BACKEND_API_URL` environment variable (retrieves the base API URL of the backend).**\n * - **Behavior:**\n *    - If the variable is not set, it defaults to `\"http://localhost:8000\"`.\n *    - It also allows adding an optional suffix to the returned URL.\n * - ***⚠️ Warning:***\n *    - ***This function only support when using ***[`NextJS`](https://nextjs.org/)***.***\n * @description\n * This function determines the backend API base URL from the `NEXT_PUBLIC_BACKEND_API_URL` environment variable.\n * - If `NEXT_PUBLIC_BACKEND_API_URL` is not set, it defaults to `\"http://localhost:8000\"`.\n * - If `NEXT_PUBLIC_BACKEND_API_URL` does **not** contain a port, it appends one from `NEXT_PUBLIC_PORT_BE` if available.\n * - Supports appending optional suffix (like `\"/api\"`).\n * @param {OptionsGetBeApiUrl|undefined} options - Configuration options.\n * @param {OptionsGetBeApiUrl[\"suffix\"]} [options.suffix=\"/\"] - The suffix to append to the base API URL.\n * @returns {string} The formatted backend API base URL.\n * @throws **{@link TypeError | `TypeError`}** if `suffix` is not a `string`.\n * @throws **{@link Error | `Error`}** if `NEXT_PUBLIC_BACKEND_API_URL` is invalid.\n * @example\n * // With NEXT_PUBLIC_BACKEND_API_URL set at `*.env` file\n * NEXT_PUBLIC_BACKEND_API_URL = \"https://api.example.com\";\n * getBeApiUrl();\n * // ➔ \"https://api.example.com/\"\n *\n * // With NEXT_PUBLIC_BACKEND_API_URL but no port, using NEXT_PUBLIC_PORT_BE at `*.env` file\n * NEXT_PUBLIC_BACKEND_API_URL = \"http://localhost\";\n * NEXT_PUBLIC_PORT_BE = \"5000\";\n * getBeApiUrl({ suffix: \"/api\" });\n * // ➔ \"http://localhost:5000/api\"\n *\n * // Without NEXT_PUBLIC_BACKEND_API_URL at `*.env` file (defaults to localhost:8000)\n * delete NEXT_PUBLIC_BACKEND_API_URL;\n * getBeApiUrl({ suffix: \"/v1\" });\n * // ➔ \"http://localhost:8000/v1\"\n */\nexport const getBeApiUrl = (options: OptionsGetBeApiUrl = {}): string => {\n  if (!isPlainObject(options)) options = {};\n\n  let suffix = hasOwnProp(options, \"suffix\") ? options.suffix : \"/\";\n\n  // Ensure suffix is a string\n  assertIsString(suffix, {\n    message({ currentType, validType }) {\n      return `Parameter \\`suffix\\` property of the first parameter must be of type \\`${validType}\\`, but received: \\`${currentType}\\`.`;\n    }\n  });\n\n  try {\n    let rawBaseUrl = process.env.NEXT_PUBLIC_BACKEND_API_URL?.trim();\n\n    if (rawBaseUrl) {\n      rawBaseUrl = removeSpaces(rawBaseUrl);\n\n      const urlObj = new URL(rawBaseUrl);\n      const hasPort = !!urlObj.port;\n\n      if (!hasPort && process.env.NEXT_PUBLIC_PORT_BE) {\n        rawBaseUrl =\n          urlObj.origin +\n          formatEnvPort(process.env.NEXT_PUBLIC_PORT_BE, {\n            prefixColon: true\n          });\n      }\n    } else {\n      // fallback\n      rawBaseUrl =\n        \"http://localhost\" +\n        formatEnvPort(process.env.NEXT_PUBLIC_PORT_BE || \"8000\", {\n          prefixColon: true\n        });\n    }\n\n    suffix = removeSpaces(suffix).length ? removeSpaces(suffix) : \"/\";\n    const baseApiUrl = new URL(rawBaseUrl.replace(/\\/+$/, \"\")).origin;\n\n    const finalSuffix =\n      suffix === \"/\"\n        ? \"/\"\n        : `${suffix.startsWith(\"/\") ? \"\" : \"/\"}${suffix.replace(/\\/+$/, \"\")}`;\n\n    return `${baseApiUrl}${finalSuffix}`;\n  } catch (error) {\n    throw new Error(\n      \"Invalid `NEXT_PUBLIC_BACKEND_API_URL`, failed to generate from `getBeApiUrl()`, Error:\" +\n        error,\n      { cause: error }\n    );\n  }\n};\n","import { formatEnvPort } from \"@/urls/utils/formatEnvPort\";\nimport { removeSpaces } from \"@/strings/sanitizations/removeSpaces\";\n\n/** ---------------------------------------------------\n * * ***Utility for NextJS: `getBaseUrl`.***\n * ---------------------------------------------------\n * **Retrieves the base URL of the application.**\n * - **Behavior:**\n *    - It determines the base URL from the `NEXT_PUBLIC_BASE_URL` environment variable.\n *    - If `NEXT_PUBLIC_BASE_URL` is not set, it defaults to `\"http://localhost:3000\"`.\n *    - If `NEXT_PUBLIC_BASE_URL` does **not** contain a port, it appends one from `NEXT_PUBLIC_PORT_FE` if available.\n *    - Ensures the final URL is valid and normalized (no trailing slashes).\n * - ***⚠️ Warning:***\n *    - ***This function only support when using ***[`NextJS`](https://nextjs.org/)***.***\n * @returns {string} The resolved base URL of the application.\n * @throws **{@link Error | `Error`}** if the constructed URL is invalid or malformed.\n * @example\n * // With environment variable set at `*.env` file\n * NEXT_PUBLIC_BASE_URL = \"https://example.com\";\n * getBaseUrl();\n * // ➔ \"https://example.com\"\n *\n * // With custom port via NEXT_PUBLIC_PORT_FE at `*.env` file\n * NEXT_PUBLIC_BASE_URL = \"http://localhost\";\n * NEXT_PUBLIC_PORT_FE = \"4000\";\n * getBaseUrl();\n * // ➔ \"http://localhost:4000\"\n *\n * // Without environment variable at `*.env` file\n * delete NEXT_PUBLIC_BASE_URL;\n * getBaseUrl();\n * // ➔ \"http://localhost:3000\"\n */\nexport const getBaseUrl = (): string => {\n  try {\n    const baseEnv = process.env.NEXT_PUBLIC_BASE_URL?.trim();\n    const portEnv = process.env.NEXT_PUBLIC_PORT_FE?.trim();\n\n    let baseUrl = baseEnv || \"http://localhost\";\n\n    // Always clean trailing slashes first\n    baseUrl = removeSpaces(baseUrl).replace(/\\/+$/, \"\");\n\n    // Check if already contains port\n    const hasPort = /:\\/\\/[^/]+:\\d+/.test(baseUrl);\n\n    if (!hasPort && portEnv) {\n      baseUrl += formatEnvPort(portEnv, { prefixColon: true });\n    } else if (!hasPort && !baseEnv) {\n      baseUrl += \":3000\";\n    }\n\n    const url = new URL(baseUrl);\n    return `${url.protocol}//${url.hostname}${url.port ? `:${url.port}` : \"\"}`;\n  } catch (error) {\n    throw new Error(\n      \"Invalid `NEXT_PUBLIC_BASE_URL`, failed to generate from `getBaseUrl()`, Error:\" +\n        error,\n      { cause: error }\n    );\n  }\n};\n"],"mappings":"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"}

package/dist/next/server/index.cjs

@@ -2,14 +2,14 @@
 * ========================================================================
 *  @rzl-zone/utils-js
 * ------------------------------------------------------------------------
-*  Version: `3.12.1-beta.0`
+*  Version: `3.12.1-beta.1`
 *  Author: `Rizalvin Dwiky <rizalvindwiky@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js`
 * ========================================================================
 */
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_assertIsBoolean = require('../../assertIsBoolean-DozdtbNi.cjs');
+const require_assertIsBoolean = require('../../assertIsBoolean-C8WEXVr2.cjs');
 require("@rzl-zone/node-only");
 let next_server = require("next/server");
 const getClientIpOrUrl = (request, includeFullUrl = true) => {