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

package/dist/next/index.d.ts

@@ -1,204 +1,204 @@
 import{I as IsAny}from'../any-BmdI8UbK.js';import'../if-CvT4R7Kh.js';
 /** ---------------------------------------------------------
-* * ***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;
 /** ---------------------------------
-* * ***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 {Error} If the route contains dynamic segments but no parameters object is provided.
-* @throws {Error} If a required parameter is missing from the `params` object.
-* @throws {Error} If a parameter value is an empty string.
-* @throws {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.
-*/
+ * * ***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 {Error} If the route contains dynamic segments but no parameters object is provided.
+ * @throws {Error} If a required parameter is missing from the `params` object.
+ * @throws {Error} If a parameter value is an empty string.
+ * @throws {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;};
 /** ---------------------------------
-* * ***Constructs a backend API URL by appending a given pathname to the base API URL.***
-* ---------------------------------
-* 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 {TypeError} If `withOrigin` is not a boolean.
-* @throws {TypeError} If `prefix` and `pathname` is not a string.
-* @throws {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"
-*/
+ * * ***Constructs a backend API URL by appending a given pathname to the base API URL.***
+ * ---------------------------------
+ * 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 {TypeError} If `withOrigin` is not a boolean.
+ * @throws {TypeError} If `prefix` and `pathname` is not a string.
+ * @throws {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 ""
-*/
+ *
+ * @default ""
+ */
 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;};
 /** ---------------------------------------------------
-* * ***Retrieves the base API URL of the backend.***
-* ---------------------------------------------------
-* **This function determines the backend API base URL from the `NEXT_PUBLIC_BACKEND_API_URL` environment variable.**
-* - **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 {TypeError} If `suffix` is not a `string`.
-* @throws {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"
-*/
+ * * ***Retrieves the base API URL of the backend.***
+ * ---------------------------------------------------
+ * **This function determines the backend API base URL from the `NEXT_PUBLIC_BACKEND_API_URL` environment variable.**
+ * - **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 {TypeError} If `suffix` is not a `string`.
+ * @throws {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:({suffix}?:OptionsGetBeApiUrl)=>string;
 /** ---------------------------------------------------
-* * ***Retrieves the base URL of the application.***
-* ---------------------------------------------------
-* **This function is designed to be used within `Next.js` applications.**
-* - **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 {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"
-*/
+ * * ***Retrieves the base URL of the application.***
+ * ---------------------------------------------------
+ * **This function is designed to be used within `Next.js` applications.**
+ * - **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 {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{type ExtractRouteParams,type HasDynamicSegments,createBeApiUrl,generateRoute,getBaseUrl,getBeApiUrl};

package/dist/next/index.js

@@ -1,4 +1,4 @@
-import {c as c$2,d}from'../chunk-NSVLG7NY.js';import {c as c$3}from'../chunk-HXST7RJB.js';import {a}from'../chunk-Z6FLCEN6.js';import {a as a$1}from'../chunk-JISH2VGG.js';import'../chunk-ELDDNERR.js';import {c}from'../chunk-467VEMJH.js';import'../chunk-5SZUSNGZ.js';import {g,E,j,c as c$1,r,p,f,m,G,C}from'../chunk-MJAW5RAK.js';function N(e,t){if(!g(e)||a(e))throw new TypeError(`\u274C 'generateRoute' Failed:
+import {c as c$2,d}from'../chunk-QDNSC57Z.js';import {c as c$3}from'../chunk-NR44SNYE.js';import {a}from'../chunk-7CHFAMS2.js';import {a as a$1}from'../chunk-NJSAV73S.js';import'../chunk-ELDDNERR.js';import {c}from'../chunk-J4NCYYGS.js';import'../chunk-5SZUSNGZ.js';import {g,E,j,c as c$1,r,p,f,m,G,C}from'../chunk-EWYPSKKM.js';function N(e,t){if(!g(e)||a(e))throw new TypeError(`\u274C 'generateRoute' Failed:
 - Invalid 'route' value.
 - Must be of type \`string\` and non-empty string, but received: "${E(e)}": \`${c(e)}\`.`);if(!/[\\[\]]/.test(e))return e;if(j(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.`}),c$1(t))throw new TypeError(`\u274C 'generateRoute' Failed cause in route "${e}":

package/dist/next/server/index.cjs

@@ -1,2 +1,2 @@
-'use strict';var chunkLVUSFXQS_cjs=require('../../chunk-LVUSFXQS.cjs');require('server-only');var server=require('next/server');var g=(t,r=true)=>{if(!chunkLVUSFXQS_cjs.b(server.NextRequest))throw new Error("Function `getClientIpOrUrl` is designed to be used in a `NextJS` environment.");if(!(t instanceof server.NextRequest))throw new TypeError("First parameter (`request`) must be an `instance of NextRequest` from `NextJS`.");chunkLVUSFXQS_cjs.G(r,{message:({currentType:a,validType:d})=>`Second parameter (\`includeFullUrl\`) must be of type \`${d}\`, but received: \`${a}\`.`});let e=(t.headers.get("x-forwarded-for")??"127.0.0.1").trim().split(",");(e[0]==="::ffff:127.0.0.1"||e[0]==="::1")&&(e[0]="127.0.0.1");let o=e.length>1?e[e.length-1].trim():e[0];if(!r)return o;let p=t.headers.get("x-forwarded-proto")||"http",f=t.headers.get("x-forwarded-port")||"3000";return `${process.env.NODE_ENV==="production"?p:"http"}://${o}:${f}`};
+'use strict';var chunkCII6WWLO_cjs=require('../../chunk-CII6WWLO.cjs');require('server-only');var server=require('next/server');var g=(t,r=true)=>{if(!chunkCII6WWLO_cjs.b(server.NextRequest))throw new Error("Function `getClientIpOrUrl` is designed to be used in a `NextJS` environment.");if(!(t instanceof server.NextRequest))throw new TypeError("First parameter (`request`) must be an `instance of NextRequest` from `NextJS`.");chunkCII6WWLO_cjs.G(r,{message:({currentType:a,validType:d})=>`Second parameter (\`includeFullUrl\`) must be of type \`${d}\`, but received: \`${a}\`.`});let e=(t.headers.get("x-forwarded-for")??"127.0.0.1").trim().split(",");(e[0]==="::ffff:127.0.0.1"||e[0]==="::1")&&(e[0]="127.0.0.1");let o=e.length>1?e[e.length-1].trim():e[0];if(!r)return o;let p=t.headers.get("x-forwarded-proto")||"http",f=t.headers.get("x-forwarded-port")||"3000";return `${process.env.NODE_ENV==="production"?p:"http"}://${o}:${f}`};
 exports.getClientIpOrUrl=g;

package/dist/next/server/index.d.ts

@@ -1,28 +1,28 @@
 import{NextRequest}from'next/server';
 /** ---------------------------------
-* * ***Utility for NextJS Server: `getClientIpOrUrl`.***
-* ---------------------------------
-* **Retrieves the real client IP address and constructs the full URL using headers like `x-forwarded-for`, `x-forwarded-proto`, and `x-forwarded-port`.**
-* - **ℹ️ Note:**
-*    - Only supported in **Next.js** environments (specifically in `server-only` contexts).
-*    - Should be used in **middleware** or **server actions** that have access to ***[`NextRequest - NextJS`](https://nextjs.org/docs/app/api-reference/functions/next-request)***.
-* @param {NextRequest} request - The incoming ***`NextJS`*** request object.
-* @param {boolean|undefined} [includeFullUrl=true] - Whether to return the full URL (`protocol`, `IP`, and `port` like `protocol://ip:port`) or just the IP address, defaultValue: `true`.
-* @returns {string} The extracted client IP address or the full constructed URL.
-* @throws {Error} If the function is used outside a Next.js server environment.
-* @throws {TypeError} If the arguments do not match the expected types.
-* @example
-* // Basic usage in Next.js middleware
-* import { NextRequest } from "next/server";
-* import { getClientIpOrUrl } from "@rzl-zone/utils-js/next/server";
-*
-* export function middleware(request: NextRequest) {
-*   const clientIp = getClientIpOrUrl(request, false);
-*   console.log("Client IP:", clientIp);
-* }
-*
-* // Get full URL
-* const url = getClientIpOrUrl(request);
-* console.log("Client full URL:", url);
-*/
+ * * ***Utility for NextJS Server: `getClientIpOrUrl`.***
+ * ---------------------------------
+ * **Retrieves the real client IP address and constructs the full URL using headers like `x-forwarded-for`, `x-forwarded-proto`, and `x-forwarded-port`.**
+ * - **ℹ️ Note:**
+ *    - Only supported in **Next.js** environments (specifically in `server-only` contexts).
+ *    - Should be used in **middleware** or **server actions** that have access to ***[`NextRequest - NextJS`](https://nextjs.org/docs/app/api-reference/functions/next-request)***.
+ * @param {NextRequest} request - The incoming ***`NextJS`*** request object.
+ * @param {boolean|undefined} [includeFullUrl=true] - Whether to return the full URL (`protocol`, `IP`, and `port` like `protocol://ip:port`) or just the IP address, defaultValue: `true`.
+ * @returns {string} The extracted client IP address or the full constructed URL.
+ * @throws {Error} If the function is used outside a Next.js server environment.
+ * @throws {TypeError} If the arguments do not match the expected types.
+ * @example
+ * // Basic usage in Next.js middleware
+ * import { NextRequest } from "next/server";
+ * import { getClientIpOrUrl } from "@rzl-zone/utils-js/next/server";
+ *
+ * export function middleware(request: NextRequest) {
+ *   const clientIp = getClientIpOrUrl(request, false);
+ *   console.log("Client IP:", clientIp);
+ * }
+ *
+ * // Get full URL
+ * const url = getClientIpOrUrl(request);
+ * console.log("Client full URL:", url);
+ */
 declare const getClientIpOrUrl:(request:NextRequest,includeFullUrl?:boolean)=>string;export{getClientIpOrUrl};

package/dist/next/server/index.js

@@ -1,2 +1,2 @@
-import {b,G}from'../../chunk-MJAW5RAK.js';import'server-only';import {NextRequest}from'next/server';var g=(t,r=true)=>{if(!b(NextRequest))throw new Error("Function `getClientIpOrUrl` is designed to be used in a `NextJS` environment.");if(!(t instanceof NextRequest))throw new TypeError("First parameter (`request`) must be an `instance of NextRequest` from `NextJS`.");G(r,{message:({currentType:a,validType:d})=>`Second parameter (\`includeFullUrl\`) must be of type \`${d}\`, but received: \`${a}\`.`});let e=(t.headers.get("x-forwarded-for")??"127.0.0.1").trim().split(",");(e[0]==="::ffff:127.0.0.1"||e[0]==="::1")&&(e[0]="127.0.0.1");let o=e.length>1?e[e.length-1].trim():e[0];if(!r)return o;let p=t.headers.get("x-forwarded-proto")||"http",f=t.headers.get("x-forwarded-port")||"3000";return `${process.env.NODE_ENV==="production"?p:"http"}://${o}:${f}`};
+import {b,G}from'../../chunk-EWYPSKKM.js';import'server-only';import {NextRequest}from'next/server';var g=(t,r=true)=>{if(!b(NextRequest))throw new Error("Function `getClientIpOrUrl` is designed to be used in a `NextJS` environment.");if(!(t instanceof NextRequest))throw new TypeError("First parameter (`request`) must be an `instance of NextRequest` from `NextJS`.");G(r,{message:({currentType:a,validType:d})=>`Second parameter (\`includeFullUrl\`) must be of type \`${d}\`, but received: \`${a}\`.`});let e=(t.headers.get("x-forwarded-for")??"127.0.0.1").trim().split(",");(e[0]==="::ffff:127.0.0.1"||e[0]==="::1")&&(e[0]="127.0.0.1");let o=e.length>1?e[e.length-1].trim():e[0];if(!r)return o;let p=t.headers.get("x-forwarded-proto")||"http",f=t.headers.get("x-forwarded-port")||"3000";return `${process.env.NODE_ENV==="production"?p:"http"}://${o}:${f}`};
 export{g as getClientIpOrUrl};