@rzl-zone/utils-js 3.4.0 → 3.5.1

package/dist/next/index.cjs

@@ -1 +1,218 @@
-"use strict";var e=require("../chunk-H66AC7GK.cjs"),r=require("../chunk-KVAL5PAG.cjs"),t=require("../chunk-E55EQK2U.cjs"),s=require("../chunk-HYRQMTRH.cjs"),n=require("../chunk-T7PU2V7X.cjs");require("../chunk-UDA26MCU.cjs");var i=require("../chunk-PZQ6I4JJ.cjs");var a=(t={})=>{i.isPlainObject(t)||(t={});let n=i.hasOwnProp(t,"suffix")?t.suffix:"/";s.assertIsString(n,{message:({currentType:e,validType:r})=>`Parameter \`suffix\` property of the first parameter must be of type \`${r}\`, but received: \`${e}\`.`});try{let t=process.env.NEXT_PUBLIC_BACKEND_API_URL?.trim();if(t){t=r.removeSpaces(t);const s=new URL(t);!!!s.port&&process.env.NEXT_PUBLIC_PORT_BE&&(t=s.origin+e.formatEnvPort(process.env.NEXT_PUBLIC_PORT_BE,{prefixColon:!0}))}else t="http://localhost"+e.formatEnvPort(process.env.NEXT_PUBLIC_PORT_BE||"8000",{prefixColon:!0});n=r.removeSpaces(n).length?r.removeSpaces(n):"/";const s=new URL(t.replace(/\/+$/,"")).origin;return`${s}${"/"===n?"/":`${n.startsWith("/")?"":"/"}${n.replace(/\/+$/,"")}`}`}catch(e){throw new Error("Invalid `NEXT_PUBLIC_BACKEND_API_URL`, failed to generate from `getBeApiUrl()`, Error:"+e)}};exports.createBeApiUrl=(r,t={})=>{try{let n=function(e,r){return`${e.replace(/\/+$/,"")}/${r.replace(/^\/+/,"")}`};s.assertIsString(i.isNil(r)?"":r,{message:({currentType:e,validType:r})=>`First parameter (\`pathname\`) must be of type \`${r}\`, but received: \`${e}\`.`}),i.isPlainObject(t)||(t={});let{prefix:o="/api",withOrigin:c=!0}=t;if(!i.isUndefined(o)&&!i.isString(o))throw new TypeError(`Parameter \`prefix\` property of the \`options\` (second parameter) must be of type \`string\`, but received: \`${i.getPreciseType(o)}\`.`);i.assertIsBoolean(c,{message:({currentType:e,validType:r})=>`Parameter \`withOrigin\` property of the \`options\` (second parameter) must be of type \`${r}\`, but received: \`${e}\`.`}),r=e.normalizePathname(r),o=e.normalizePathname(o);const p=o.endsWith("/")?o:o+"/";(r===o||r===o+"/"||r.startsWith(p))&&(r=r.slice(o.length),r=e.normalizePathname(r));const u=a({suffix:o});return n(c?u:new URL(u).pathname,r).replace(/\/+$/,"")}catch(e){throw i.isError(e)?e:new Error("Failed to generate backend API URL in `createBeApiUrl()`, Error: "+new Error(String(e)).message.trim())}},exports.generateRoute=function(e,r){if(!i.isString(e)||t.isEmptyString(e))throw new TypeError(`❌ 'generateRoute' Failed:\n- Invalid 'route' value.\n- Must be of type \`string\` and non-empty string, but received: "${i.getPreciseType(e)}": \`${n.safeStableStringify(e)}\`.`);if(!/[\\[\]]/.test(e))return e;if(i.assertIsPlainObject(r,{message:({validType:r})=>`❌ 'generateRoute' Failed cause in route "${e}":\n- Missing or invalid parameters \`${r}\` for route: "${e}", must be of type \`${r}\` mapping parameters.`}),i.isNil(r))throw new TypeError(`❌ 'generateRoute' Failed cause in route "${e}":\n- Missing parameters \`plain-object\` for route: "${e}".`);const s=["?","&","#","=","/","'",'"',"(",")","+",";","%","@",":"],a=[],o=Array.from(e.matchAll(/\[(\w+)\]/g)).map(e=>e[1]);for(const e of o){const n=r[e];if(!i.isString(n)){a.push(`- Invalid parameter: "${e}" must be of type \`string\`, but received: \`${i.getPreciseType(n)}\`.`);continue}if(t.isEmptyString(n)){a.push(`- Parameter "${e}" cannot be empty string.`);continue}const o=s.filter(e=>n.includes(e));if(/\s/.test(n)&&o.push("white-space(s)"),o.length>0){const r=o.map(e=>"`"===e?"backtick - (`)":`\`${e}\``);s.includes("white-space(s)")||s.push("white-space(s)");const t=s.map(e=>"`"===e?"backtick - (`)":`\`${e}\``);a.push(`- Parameter "${e}" contains invalid characters (${r.join(", ")}). These characters are not allowed because they could cause issues in URL structure. The following characters are forbidden in route parameters: (${t.join(", ")}).`)}}if(i.isNonEmptyArray(a))throw new Error(`❌ 'generateRoute' Failed cause in route "${e}":\n${a.join("\n")}.`);return e.replace(/\[(\w+)\]/g,(e,t)=>(i.isNonEmptyString(r[t])?r[t]:"").trim().replace(/^\/+|\/+$/g,"")).replace(/\/+/g,"/")},exports.getBaseUrl=()=>{try{const t=process.env.NEXT_PUBLIC_BASE_URL?.trim(),s=process.env.NEXT_PUBLIC_PORT_FE?.trim();let n=t||"http://localhost";n=r.removeSpaces(n).replace(/\/+$/,"");const i=/:\/\/[^/]+:\d+/.test(n);!i&&s?n+=e.formatEnvPort(s,{prefixColon:!0}):i||t||(n+=":3000");const a=new URL(n);return`${a.protocol}//${a.hostname}${a.port?`:${a.port}`:""}`}catch(e){throw new Error("Invalid `NEXT_PUBLIC_BASE_URL`, failed to generate from `getBaseUrl()`, Error:"+e)}},exports.getBeApiUrl=a;
+/*!
+ * ====================================================
+ * Rzl Utils-JS.
+ * ----------------------------------------------------
+ * Version: 3.5.1.
+ * Author: Rizalvin Dwiky.
+ * Repository: https://github.com/rzl-zone/utils-js.
+ * ====================================================
+ */
+'use strict';
+
+var chunkH66AC7GK_cjs = require('../chunk-H66AC7GK.cjs');
+var chunkKVAL5PAG_cjs = require('../chunk-KVAL5PAG.cjs');
+var chunkE55EQK2U_cjs = require('../chunk-E55EQK2U.cjs');
+var chunkHYRQMTRH_cjs = require('../chunk-HYRQMTRH.cjs');
+var chunkT7PU2V7X_cjs = require('../chunk-T7PU2V7X.cjs');
+require('../chunk-UDA26MCU.cjs');
+var chunkPZQ6I4JJ_cjs = require('../chunk-PZQ6I4JJ.cjs');
+
+function generateRoute(route, params) {
+  if (!chunkPZQ6I4JJ_cjs.isString(route) || chunkE55EQK2U_cjs.isEmptyString(route)) {
+    throw new TypeError(
+      `\u274C 'generateRoute' Failed:
+- Invalid 'route' value.
+- Must be of type \`string\` and non-empty string, but received: "${chunkPZQ6I4JJ_cjs.getPreciseType(
+        route
+      )}": \`${chunkT7PU2V7X_cjs.safeStableStringify(route)}\`.`
+    );
+  }
+  if (!/[\\[\]]/.test(route)) {
+    return route;
+  }
+  chunkPZQ6I4JJ_cjs.assertIsPlainObject(params, {
+    message: ({ validType }) => `\u274C 'generateRoute' Failed cause in route "${route}":
+- Missing or invalid parameters \`${validType}\` for route: "${route}", must be of type \`${validType}\` mapping parameters.`
+  });
+  if (chunkPZQ6I4JJ_cjs.isNil(params)) {
+    throw new TypeError(
+      `\u274C 'generateRoute' Failed cause in route "${route}":
+- Missing parameters \`plain-object\` for route: "${route}".`
+    );
+  }
+  const invalidChars = [
+    "?",
+    "&",
+    "#",
+    "=",
+    "/",
+    // "`",
+    // " ",
+    // ".",
+    "'",
+    '"',
+    "(",
+    ")",
+    "+",
+    ";",
+    "%",
+    "@",
+    ":"
+  ];
+  const errors = [];
+  const requiredKeys = Array.from(route.matchAll(/\[(\w+)\]/g)).map((m) => m[1]);
+  for (const key of requiredKeys) {
+    const value = params[key];
+    if (!chunkPZQ6I4JJ_cjs.isString(value)) {
+      errors.push(
+        `- Invalid parameter: "${key}" must be of type \`string\`, but received: \`${chunkPZQ6I4JJ_cjs.getPreciseType(
+          value
+        )}\`.`
+      );
+      continue;
+    }
+    if (chunkE55EQK2U_cjs.isEmptyString(value)) {
+      errors.push(`- Parameter "${key}" cannot be empty string.`);
+      continue;
+    }
+    const foundInvalidChars = invalidChars.filter((char) => value.includes(char));
+    if (/\s/.test(value)) {
+      foundInvalidChars.push("white-space(s)");
+    }
+    if (foundInvalidChars.length > 0) {
+      const formattedChars = foundInvalidChars.map(
+        (c) => c === "`" ? "backtick - (`)" : `\`${c}\``
+      );
+      if (!invalidChars.includes("white-space(s)")) invalidChars.push("white-space(s)");
+      const formattedInvalidChars = invalidChars.map(
+        (c) => c === "`" ? "backtick - (`)" : `\`${c}\``
+      );
+      errors.push(
+        `- Parameter "${key}" contains invalid characters (${formattedChars.join(
+          ", "
+        )}). These characters are not allowed because they could cause issues in URL structure. The following characters are forbidden in route parameters: (${formattedInvalidChars.join(
+          ", "
+        )}).`
+      );
+    }
+  }
+  if (chunkPZQ6I4JJ_cjs.isNonEmptyArray(errors)) {
+    throw new Error(
+      `\u274C 'generateRoute' Failed cause in route "${route}":
+${errors.join("\n")}.`
+    );
+  }
+  return route.replace(/\[(\w+)\]/g, (_, key) => {
+    const paramKey = chunkPZQ6I4JJ_cjs.isNonEmptyString(params[key]) ? params[key] : "";
+    return paramKey.trim().replace(/^\/+|\/+$/g, "");
+  }).replace(/\/+/g, "/");
+}
+
+var createBeApiUrl = (pathname, options = {}) => {
+  try {
+    let joinPath2 = function(a, b) {
+      return `${a.replace(/\/+$/, "")}/${b.replace(/^\/+/, "")}`;
+    };
+    var joinPath = joinPath2;
+    chunkHYRQMTRH_cjs.assertIsString(chunkPZQ6I4JJ_cjs.isNil(pathname) ? "" : pathname, {
+      message({ currentType, validType }) {
+        return `First parameter (\`pathname\`) must be of type \`${validType}\`, but received: \`${currentType}\`.`;
+      }
+    });
+    if (!chunkPZQ6I4JJ_cjs.isPlainObject(options)) {
+      options = {};
+    }
+    let {
+      prefix = "/api",
+      withOrigin = true
+    } = options;
+    if (!chunkPZQ6I4JJ_cjs.isUndefined(prefix) && !chunkPZQ6I4JJ_cjs.isString(prefix)) {
+      throw new TypeError(
+        `Parameter \`prefix\` property of the \`options\` (second parameter) must be of type \`string\`, but received: \`${chunkPZQ6I4JJ_cjs.getPreciseType(
+          prefix
+        )}\`.`
+      );
+    }
+    chunkPZQ6I4JJ_cjs.assertIsBoolean(withOrigin, {
+      message: ({ currentType, validType }) => `Parameter \`withOrigin\` property of the \`options\` (second parameter) must be of type \`${validType}\`, but received: \`${currentType}\`.`
+    });
+    pathname = chunkH66AC7GK_cjs.normalizePathname(pathname);
+    prefix = chunkH66AC7GK_cjs.normalizePathname(prefix);
+    const normalizedPrefix = prefix.endsWith("/") ? prefix : prefix + "/";
+    if (pathname === prefix || pathname === prefix + "/" || pathname.startsWith(normalizedPrefix)) {
+      pathname = pathname.slice(prefix.length);
+      pathname = chunkH66AC7GK_cjs.normalizePathname(pathname);
+    }
+    const baseApiUrl = getBeApiUrl({ suffix: prefix });
+    const fullPath = withOrigin ? joinPath2(baseApiUrl, pathname) : joinPath2(new URL(baseApiUrl).pathname, pathname);
+    return fullPath.replace(/\/+$/, "");
+  } catch (err) {
+    if (chunkPZQ6I4JJ_cjs.isError(err)) {
+      throw err;
+    } else
+      throw new Error(
+        "Failed to generate backend API URL in `createBeApiUrl()`, Error: " + new Error(String(err)).message.trim()
+      );
+  }
+};
+
+var getBeApiUrl = (options = {}) => {
+  if (!chunkPZQ6I4JJ_cjs.isPlainObject(options)) options = {};
+  let suffix = chunkPZQ6I4JJ_cjs.hasOwnProp(options, "suffix") ? options.suffix : "/";
+  chunkHYRQMTRH_cjs.assertIsString(suffix, {
+    message({ currentType, validType }) {
+      return `Parameter \`suffix\` property of the first parameter must be of type \`${validType}\`, but received: \`${currentType}\`.`;
+    }
+  });
+  try {
+    let rawBaseUrl = process.env.NEXT_PUBLIC_BACKEND_API_URL?.trim();
+    if (rawBaseUrl) {
+      rawBaseUrl = chunkKVAL5PAG_cjs.removeSpaces(rawBaseUrl);
+      const urlObj = new URL(rawBaseUrl);
+      const hasPort = !!urlObj.port;
+      if (!hasPort && process.env.NEXT_PUBLIC_PORT_BE) {
+        rawBaseUrl = urlObj.origin + chunkH66AC7GK_cjs.formatEnvPort(process.env.NEXT_PUBLIC_PORT_BE, {
+          prefixColon: true
+        });
+      }
+    } else {
+      rawBaseUrl = "http://localhost" + chunkH66AC7GK_cjs.formatEnvPort(process.env.NEXT_PUBLIC_PORT_BE || "8000", {
+        prefixColon: true
+      });
+    }
+    suffix = chunkKVAL5PAG_cjs.removeSpaces(suffix).length ? chunkKVAL5PAG_cjs.removeSpaces(suffix) : "/";
+    const baseApiUrl = new URL(rawBaseUrl.replace(/\/+$/, "")).origin;
+    const finalSuffix = suffix === "/" ? "/" : `${suffix.startsWith("/") ? "" : "/"}${suffix.replace(/\/+$/, "")}`;
+    return `${baseApiUrl}${finalSuffix}`;
+  } catch (error) {
+    throw new Error(
+      "Invalid `NEXT_PUBLIC_BACKEND_API_URL`, failed to generate from `getBeApiUrl()`, Error:" + error
+    );
+  }
+};
+
+var getBaseUrl = () => {
+  try {
+    const baseEnv = process.env.NEXT_PUBLIC_BASE_URL?.trim();
+    const portEnv = process.env.NEXT_PUBLIC_PORT_FE?.trim();
+    let baseUrl = baseEnv || "http://localhost";
+    baseUrl = chunkKVAL5PAG_cjs.removeSpaces(baseUrl).replace(/\/+$/, "");
+    const hasPort = /:\/\/[^/]+:\d+/.test(baseUrl);
+    if (!hasPort && portEnv) {
+      baseUrl += chunkH66AC7GK_cjs.formatEnvPort(portEnv, { prefixColon: true });
+    } else if (!hasPort && !baseEnv) {
+      baseUrl += ":3000";
+    }
+    const url = new URL(baseUrl);
+    return `${url.protocol}//${url.hostname}${url.port ? `:${url.port}` : ""}`;
+  } catch (error) {
+    throw new Error(
+      "Invalid `NEXT_PUBLIC_BASE_URL`, failed to generate from `getBaseUrl()`, Error:" + error
+    );
+  }
+};
+
+exports.createBeApiUrl = createBeApiUrl;
+exports.generateRoute = generateRoute;
+exports.getBaseUrl = getBaseUrl;
+exports.getBeApiUrl = getBeApiUrl;

package/dist/next/index.d.ts

@@ -1,3 +1,12 @@
+/*!
+ * ====================================================
+ * Rzl Utils-JS.
+ * ----------------------------------------------------
+ * Version: 3.5.1.
+ * Author: Rizalvin Dwiky.
+ * Repository: https://github.com/rzl-zone/utils-js.
+ * ====================================================
+ */
 import{IsAny}from'@rzl-zone/ts-types-plus';
 /** ---------------------------------------------------------
  * * ***Extracts dynamic route parameters from a given route string.***
@@ -204,4 +213,4 @@ declare const getBeApiUrl:(options?:OptionsGetBeApiUrl)=>string;
  * getBaseUrl();
  * // ➔ "http://localhost:3000"
  */
-declare const getBaseUrl:()=>string;export{type ExtractRouteParams,type HasDynamicSegments,createBeApiUrl,generateRoute,getBaseUrl,getBeApiUrl};
+declare const getBaseUrl:()=>string;export{type ExtractRouteParams,type HasDynamicSegments,createBeApiUrl,generateRoute,getBaseUrl,getBeApiUrl};

package/dist/next/index.js

@@ -1 +1,213 @@
-import{normalizePathname as e,formatEnvPort as r}from"../chunk-GGEADHZO.js";import{removeSpaces as t}from"../chunk-XEDXFSGI.js";import{isEmptyString as o}from"../chunk-W2WNBUDE.js";import{assertIsString as n}from"../chunk-SBKGWRS5.js";import{safeStableStringify as s}from"../chunk-PET42Z7W.js";import"../chunk-QNKGP5DY.js";import{isString as a,getPreciseType as i,assertIsPlainObject as p,isNil as c,isNonEmptyArray as u,isNonEmptyString as l,isPlainObject as m,isUndefined as f,assertIsBoolean as h,isError as $,hasOwnProp as d}from"../chunk-CMW2TBOQ.js";function g(e,r){if(!a(e)||o(e))throw new TypeError(`❌ 'generateRoute' Failed:\n- Invalid 'route' value.\n- Must be of type \`string\` and non-empty string, but received: "${i(e)}": \`${s(e)}\`.`);if(!/[\\[\]]/.test(e))return e;if(p(r,{message:({validType:r})=>`❌ 'generateRoute' Failed cause in route "${e}":\n- Missing or invalid parameters \`${r}\` for route: "${e}", must be of type \`${r}\` mapping parameters.`}),c(r))throw new TypeError(`❌ 'generateRoute' Failed cause in route "${e}":\n- Missing parameters \`plain-object\` for route: "${e}".`);const t=["?","&","#","=","/","'",'"',"(",")","+",";","%","@",":"],n=[],m=Array.from(e.matchAll(/\[(\w+)\]/g)).map(e=>e[1]);for(const e of m){const s=r[e];if(!a(s)){n.push(`- Invalid parameter: "${e}" must be of type \`string\`, but received: \`${i(s)}\`.`);continue}if(o(s)){n.push(`- Parameter "${e}" cannot be empty string.`);continue}const p=t.filter(e=>s.includes(e));if(/\s/.test(s)&&p.push("white-space(s)"),p.length>0){const r=p.map(e=>"`"===e?"backtick - (`)":`\`${e}\``);t.includes("white-space(s)")||t.push("white-space(s)");const o=t.map(e=>"`"===e?"backtick - (`)":`\`${e}\``);n.push(`- Parameter "${e}" contains invalid characters (${r.join(", ")}). These characters are not allowed because they could cause issues in URL structure. The following characters are forbidden in route parameters: (${o.join(", ")}).`)}}if(u(n))throw new Error(`❌ 'generateRoute' Failed cause in route "${e}":\n${n.join("\n")}.`);return e.replace(/\[(\w+)\]/g,(e,t)=>(l(r[t])?r[t]:"").trim().replace(/^\/+|\/+$/g,"")).replace(/\/+/g,"/")}var E=(r,t={})=>{try{let o=function(e,r){return`${e.replace(/\/+$/,"")}/${r.replace(/^\/+/,"")}`};n(c(r)?"":r,{message:({currentType:e,validType:r})=>`First parameter (\`pathname\`) must be of type \`${r}\`, but received: \`${e}\`.`}),m(t)||(t={});let{prefix:s="/api",withOrigin:p=!0}=t;if(!f(s)&&!a(s))throw new TypeError(`Parameter \`prefix\` property of the \`options\` (second parameter) must be of type \`string\`, but received: \`${i(s)}\`.`);h(p,{message:({currentType:e,validType:r})=>`Parameter \`withOrigin\` property of the \`options\` (second parameter) must be of type \`${r}\`, but received: \`${e}\`.`}),r=e(r),s=e(s);const u=s.endsWith("/")?s:s+"/";(r===s||r===s+"/"||r.startsWith(u))&&(r=r.slice(s.length),r=e(r));const l=w({suffix:s});return o(p?l:new URL(l).pathname,r).replace(/\/+$/,"")}catch(e){throw $(e)?e:new Error("Failed to generate backend API URL in `createBeApiUrl()`, Error: "+new Error(String(e)).message.trim())}},w=(e={})=>{m(e)||(e={});let o=d(e,"suffix")?e.suffix:"/";n(o,{message:({currentType:e,validType:r})=>`Parameter \`suffix\` property of the first parameter must be of type \`${r}\`, but received: \`${e}\`.`});try{let e=process.env.NEXT_PUBLIC_BACKEND_API_URL?.trim();if(e){e=t(e);const o=new URL(e);!!!o.port&&process.env.NEXT_PUBLIC_PORT_BE&&(e=o.origin+r(process.env.NEXT_PUBLIC_PORT_BE,{prefixColon:!0}))}else e="http://localhost"+r(process.env.NEXT_PUBLIC_PORT_BE||"8000",{prefixColon:!0});o=t(o).length?t(o):"/";const n=new URL(e.replace(/\/+$/,"")).origin;return`${n}${"/"===o?"/":`${o.startsWith("/")?"":"/"}${o.replace(/\/+$/,"")}`}`}catch(e){throw new Error("Invalid `NEXT_PUBLIC_BACKEND_API_URL`, failed to generate from `getBeApiUrl()`, Error:"+e)}},y=()=>{try{const e=process.env.NEXT_PUBLIC_BASE_URL?.trim(),o=process.env.NEXT_PUBLIC_PORT_FE?.trim();let n=e||"http://localhost";n=t(n).replace(/\/+$/,"");const s=/:\/\/[^/]+:\d+/.test(n);!s&&o?n+=r(o,{prefixColon:!0}):s||e||(n+=":3000");const a=new URL(n);return`${a.protocol}//${a.hostname}${a.port?`:${a.port}`:""}`}catch(e){throw new Error("Invalid `NEXT_PUBLIC_BASE_URL`, failed to generate from `getBaseUrl()`, Error:"+e)}};export{E as createBeApiUrl,g as generateRoute,y as getBaseUrl,w as getBeApiUrl};
+/*!
+ * ====================================================
+ * Rzl Utils-JS.
+ * ----------------------------------------------------
+ * Version: 3.5.1.
+ * Author: Rizalvin Dwiky.
+ * Repository: https://github.com/rzl-zone/utils-js.
+ * ====================================================
+ */
+import { normalizePathname, formatEnvPort } from '../chunk-GGEADHZO.js';
+import { removeSpaces } from '../chunk-XEDXFSGI.js';
+import { isEmptyString } from '../chunk-W2WNBUDE.js';
+import { assertIsString } from '../chunk-SBKGWRS5.js';
+import { safeStableStringify } from '../chunk-PET42Z7W.js';
+import '../chunk-QNKGP5DY.js';
+import { isString, getPreciseType, assertIsPlainObject, isNil, isNonEmptyArray, isNonEmptyString, isPlainObject, isUndefined, assertIsBoolean, isError, hasOwnProp } from '../chunk-CMW2TBOQ.js';
+
+function generateRoute(route, params) {
+  if (!isString(route) || isEmptyString(route)) {
+    throw new TypeError(
+      `\u274C 'generateRoute' Failed:
+- Invalid 'route' value.
+- Must be of type \`string\` and non-empty string, but received: "${getPreciseType(
+        route
+      )}": \`${safeStableStringify(route)}\`.`
+    );
+  }
+  if (!/[\\[\]]/.test(route)) {
+    return route;
+  }
+  assertIsPlainObject(params, {
+    message: ({ validType }) => `\u274C 'generateRoute' Failed cause in route "${route}":
+- Missing or invalid parameters \`${validType}\` for route: "${route}", must be of type \`${validType}\` mapping parameters.`
+  });
+  if (isNil(params)) {
+    throw new TypeError(
+      `\u274C 'generateRoute' Failed cause in route "${route}":
+- Missing parameters \`plain-object\` for route: "${route}".`
+    );
+  }
+  const invalidChars = [
+    "?",
+    "&",
+    "#",
+    "=",
+    "/",
+    // "`",
+    // " ",
+    // ".",
+    "'",
+    '"',
+    "(",
+    ")",
+    "+",
+    ";",
+    "%",
+    "@",
+    ":"
+  ];
+  const errors = [];
+  const requiredKeys = Array.from(route.matchAll(/\[(\w+)\]/g)).map((m) => m[1]);
+  for (const key of requiredKeys) {
+    const value = params[key];
+    if (!isString(value)) {
+      errors.push(
+        `- Invalid parameter: "${key}" must be of type \`string\`, but received: \`${getPreciseType(
+          value
+        )}\`.`
+      );
+      continue;
+    }
+    if (isEmptyString(value)) {
+      errors.push(`- Parameter "${key}" cannot be empty string.`);
+      continue;
+    }
+    const foundInvalidChars = invalidChars.filter((char) => value.includes(char));
+    if (/\s/.test(value)) {
+      foundInvalidChars.push("white-space(s)");
+    }
+    if (foundInvalidChars.length > 0) {
+      const formattedChars = foundInvalidChars.map(
+        (c) => c === "`" ? "backtick - (`)" : `\`${c}\``
+      );
+      if (!invalidChars.includes("white-space(s)")) invalidChars.push("white-space(s)");
+      const formattedInvalidChars = invalidChars.map(
+        (c) => c === "`" ? "backtick - (`)" : `\`${c}\``
+      );
+      errors.push(
+        `- Parameter "${key}" contains invalid characters (${formattedChars.join(
+          ", "
+        )}). These characters are not allowed because they could cause issues in URL structure. The following characters are forbidden in route parameters: (${formattedInvalidChars.join(
+          ", "
+        )}).`
+      );
+    }
+  }
+  if (isNonEmptyArray(errors)) {
+    throw new Error(
+      `\u274C 'generateRoute' Failed cause in route "${route}":
+${errors.join("\n")}.`
+    );
+  }
+  return route.replace(/\[(\w+)\]/g, (_, key) => {
+    const paramKey = isNonEmptyString(params[key]) ? params[key] : "";
+    return paramKey.trim().replace(/^\/+|\/+$/g, "");
+  }).replace(/\/+/g, "/");
+}
+
+var createBeApiUrl = (pathname, options = {}) => {
+  try {
+    let joinPath2 = function(a, b) {
+      return `${a.replace(/\/+$/, "")}/${b.replace(/^\/+/, "")}`;
+    };
+    var joinPath = joinPath2;
+    assertIsString(isNil(pathname) ? "" : pathname, {
+      message({ currentType, validType }) {
+        return `First parameter (\`pathname\`) must be of type \`${validType}\`, but received: \`${currentType}\`.`;
+      }
+    });
+    if (!isPlainObject(options)) {
+      options = {};
+    }
+    let {
+      prefix = "/api",
+      withOrigin = true
+    } = options;
+    if (!isUndefined(prefix) && !isString(prefix)) {
+      throw new TypeError(
+        `Parameter \`prefix\` property of the \`options\` (second parameter) must be of type \`string\`, but received: \`${getPreciseType(
+          prefix
+        )}\`.`
+      );
+    }
+    assertIsBoolean(withOrigin, {
+      message: ({ currentType, validType }) => `Parameter \`withOrigin\` property of the \`options\` (second parameter) must be of type \`${validType}\`, but received: \`${currentType}\`.`
+    });
+    pathname = normalizePathname(pathname);
+    prefix = normalizePathname(prefix);
+    const normalizedPrefix = prefix.endsWith("/") ? prefix : prefix + "/";
+    if (pathname === prefix || pathname === prefix + "/" || pathname.startsWith(normalizedPrefix)) {
+      pathname = pathname.slice(prefix.length);
+      pathname = normalizePathname(pathname);
+    }
+    const baseApiUrl = getBeApiUrl({ suffix: prefix });
+    const fullPath = withOrigin ? joinPath2(baseApiUrl, pathname) : joinPath2(new URL(baseApiUrl).pathname, pathname);
+    return fullPath.replace(/\/+$/, "");
+  } catch (err) {
+    if (isError(err)) {
+      throw err;
+    } else
+      throw new Error(
+        "Failed to generate backend API URL in `createBeApiUrl()`, Error: " + new Error(String(err)).message.trim()
+      );
+  }
+};
+
+var getBeApiUrl = (options = {}) => {
+  if (!isPlainObject(options)) options = {};
+  let suffix = hasOwnProp(options, "suffix") ? options.suffix : "/";
+  assertIsString(suffix, {
+    message({ currentType, validType }) {
+      return `Parameter \`suffix\` property of the first parameter must be of type \`${validType}\`, but received: \`${currentType}\`.`;
+    }
+  });
+  try {
+    let rawBaseUrl = process.env.NEXT_PUBLIC_BACKEND_API_URL?.trim();
+    if (rawBaseUrl) {
+      rawBaseUrl = removeSpaces(rawBaseUrl);
+      const urlObj = new URL(rawBaseUrl);
+      const hasPort = !!urlObj.port;
+      if (!hasPort && process.env.NEXT_PUBLIC_PORT_BE) {
+        rawBaseUrl = urlObj.origin + formatEnvPort(process.env.NEXT_PUBLIC_PORT_BE, {
+          prefixColon: true
+        });
+      }
+    } else {
+      rawBaseUrl = "http://localhost" + formatEnvPort(process.env.NEXT_PUBLIC_PORT_BE || "8000", {
+        prefixColon: true
+      });
+    }
+    suffix = removeSpaces(suffix).length ? removeSpaces(suffix) : "/";
+    const baseApiUrl = new URL(rawBaseUrl.replace(/\/+$/, "")).origin;
+    const finalSuffix = suffix === "/" ? "/" : `${suffix.startsWith("/") ? "" : "/"}${suffix.replace(/\/+$/, "")}`;
+    return `${baseApiUrl}${finalSuffix}`;
+  } catch (error) {
+    throw new Error(
+      "Invalid `NEXT_PUBLIC_BACKEND_API_URL`, failed to generate from `getBeApiUrl()`, Error:" + error
+    );
+  }
+};
+
+var getBaseUrl = () => {
+  try {
+    const baseEnv = process.env.NEXT_PUBLIC_BASE_URL?.trim();
+    const portEnv = process.env.NEXT_PUBLIC_PORT_FE?.trim();
+    let baseUrl = baseEnv || "http://localhost";
+    baseUrl = removeSpaces(baseUrl).replace(/\/+$/, "");
+    const hasPort = /:\/\/[^/]+:\d+/.test(baseUrl);
+    if (!hasPort && portEnv) {
+      baseUrl += formatEnvPort(portEnv, { prefixColon: true });
+    } else if (!hasPort && !baseEnv) {
+      baseUrl += ":3000";
+    }
+    const url = new URL(baseUrl);
+    return `${url.protocol}//${url.hostname}${url.port ? `:${url.port}` : ""}`;
+  } catch (error) {
+    throw new Error(
+      "Invalid `NEXT_PUBLIC_BASE_URL`, failed to generate from `getBaseUrl()`, Error:" + error
+    );
+  }
+};
+
+export { createBeApiUrl, generateRoute, getBaseUrl, getBeApiUrl };

package/dist/next/server/index.cjs

@@ -1 +1,43 @@
-"use strict";var e=require("../../chunk-PZQ6I4JJ.cjs");require("server-only");var r=require("next/server");exports.getClientIpOrUrl=(t,n=!0)=>{if(!e.isFunction(r.NextRequest))throw new Error("Function `getClientIpOrUrl` is designed to be used in a `NextJS` environment.");if(!(t instanceof r.NextRequest))throw new TypeError("First parameter (`request`) must be an `instance of NextRequest` from `NextJS`.");e.assertIsBoolean(n,{message:({currentType:e,validType:r})=>`Second parameter (\`includeFullUrl\`) must be of type \`${r}\`, but received: \`${e}\`.`});const s=(t.headers.get("x-forwarded-for")??"127.0.0.1").trim().split(",");"::ffff:127.0.0.1"!==s[0]&&"::1"!==s[0]||(s[0]="127.0.0.1");const o=s.length>1?s[s.length-1].trim():s[0];if(!n)return o;const i=t.headers.get("x-forwarded-proto")||"http",u=t.headers.get("x-forwarded-port")||"3000";return`${"production"===process.env.NODE_ENV?i:"http"}://${o}:${u}`};
+/*!
+ * ====================================================
+ * Rzl Utils-JS.
+ * ----------------------------------------------------
+ * Version: 3.5.1.
+ * Author: Rizalvin Dwiky.
+ * Repository: https://github.com/rzl-zone/utils-js.
+ * ====================================================
+ */
+'use strict';
+
+var chunkPZQ6I4JJ_cjs = require('../../chunk-PZQ6I4JJ.cjs');
+require('server-only');
+var server = require('next/server');
+
+var getClientIpOrUrl = (request, includeFullUrl = true) => {
+  if (!chunkPZQ6I4JJ_cjs.isFunction(server.NextRequest)) {
+    throw new Error(
+      "Function `getClientIpOrUrl` is designed to be used in a `NextJS` environment."
+    );
+  }
+  if (!(request instanceof server.NextRequest)) {
+    throw new TypeError(
+      "First parameter (`request`) must be an `instance of NextRequest` from `NextJS`."
+    );
+  }
+  chunkPZQ6I4JJ_cjs.assertIsBoolean(includeFullUrl, {
+    message: ({ currentType, validType }) => `Second parameter (\`includeFullUrl\`) must be of type \`${validType}\`, but received: \`${currentType}\`.`
+  });
+  const forwardedIps = (request.headers.get("x-forwarded-for") ?? "127.0.0.1").trim().split(",");
+  if (forwardedIps[0] === "::ffff:127.0.0.1" || forwardedIps[0] === "::1") {
+    forwardedIps[0] = "127.0.0.1";
+  }
+  const clientIp = forwardedIps.length > 1 ? forwardedIps[forwardedIps.length - 1].trim() : forwardedIps[0];
+  if (!includeFullUrl) {
+    return clientIp;
+  }
+  const protocol = request.headers.get("x-forwarded-proto") || "http";
+  const port = request.headers.get("x-forwarded-port") || "3000";
+  return `${process.env.NODE_ENV === "production" ? protocol : "http"}://${clientIp}:${port}`;
+};
+
+exports.getClientIpOrUrl = getClientIpOrUrl;

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

@@ -1,3 +1,12 @@
+/*!
+ * ====================================================
+ * Rzl Utils-JS.
+ * ----------------------------------------------------
+ * Version: 3.5.1.
+ * Author: Rizalvin Dwiky.
+ * Repository: https://github.com/rzl-zone/utils-js.
+ * ====================================================
+ */
 import{NextRequest}from'next/server';
 /** ---------------------------------
  * * ***Utility for NextJS Server: `getClientIpOrUrl`.***
@@ -25,4 +34,4 @@ import{NextRequest}from'next/server';
  * const url = getClientIpOrUrl(request);
  * console.log("Client full URL:", url);
  */
-declare const getClientIpOrUrl:(request:NextRequest,includeFullUrl?:boolean)=>string;export{getClientIpOrUrl};
+declare const getClientIpOrUrl:(request:NextRequest,includeFullUrl?:boolean)=>string;export{getClientIpOrUrl};

package/dist/next/server/index.js

@@ -1 +1,41 @@
-import{isFunction as e,assertIsBoolean as r}from"../../chunk-CMW2TBOQ.js";import"server-only";import{NextRequest as t}from"next/server";var o=(o,n=!0)=>{if(!e(t))throw new Error("Function `getClientIpOrUrl` is designed to be used in a `NextJS` environment.");if(!(o instanceof t))throw new TypeError("First parameter (`request`) must be an `instance of NextRequest` from `NextJS`.");r(n,{message:({currentType:e,validType:r})=>`Second parameter (\`includeFullUrl\`) must be of type \`${r}\`, but received: \`${e}\`.`});const s=(o.headers.get("x-forwarded-for")??"127.0.0.1").trim().split(",");"::ffff:127.0.0.1"!==s[0]&&"::1"!==s[0]||(s[0]="127.0.0.1");const i=s.length>1?s[s.length-1].trim():s[0];if(!n)return i;const p=o.headers.get("x-forwarded-proto")||"http",a=o.headers.get("x-forwarded-port")||"3000";return`${"production"===process.env.NODE_ENV?p:"http"}://${i}:${a}`};export{o as getClientIpOrUrl};
+/*!
+ * ====================================================
+ * Rzl Utils-JS.
+ * ----------------------------------------------------
+ * Version: 3.5.1.
+ * Author: Rizalvin Dwiky.
+ * Repository: https://github.com/rzl-zone/utils-js.
+ * ====================================================
+ */
+import { isFunction, assertIsBoolean } from '../../chunk-CMW2TBOQ.js';
+import 'server-only';
+import { NextRequest } from 'next/server';
+
+var getClientIpOrUrl = (request, includeFullUrl = true) => {
+  if (!isFunction(NextRequest)) {
+    throw new Error(
+      "Function `getClientIpOrUrl` is designed to be used in a `NextJS` environment."
+    );
+  }
+  if (!(request instanceof NextRequest)) {
+    throw new TypeError(
+      "First parameter (`request`) must be an `instance of NextRequest` from `NextJS`."
+    );
+  }
+  assertIsBoolean(includeFullUrl, {
+    message: ({ currentType, validType }) => `Second parameter (\`includeFullUrl\`) must be of type \`${validType}\`, but received: \`${currentType}\`.`
+  });
+  const forwardedIps = (request.headers.get("x-forwarded-for") ?? "127.0.0.1").trim().split(",");
+  if (forwardedIps[0] === "::ffff:127.0.0.1" || forwardedIps[0] === "::1") {
+    forwardedIps[0] = "127.0.0.1";
+  }
+  const clientIp = forwardedIps.length > 1 ? forwardedIps[forwardedIps.length - 1].trim() : forwardedIps[0];
+  if (!includeFullUrl) {
+    return clientIp;
+  }
+  const protocol = request.headers.get("x-forwarded-proto") || "http";
+  const port = request.headers.get("x-forwarded-port") || "3000";
+  return `${process.env.NODE_ENV === "production" ? protocol : "http"}://${clientIp}:${port}`;
+};
+
+export { getClientIpOrUrl };

package/dist/operations/index.cjs

@@ -1 +1,33 @@
-"use strict";var e=require("../chunk-LS6U7FAY.cjs");require("../chunk-FJZGG54N.cjs"),require("../chunk-JBQMXC5I.cjs"),require("../chunk-ZETAZZLD.cjs"),require("../chunk-6JFZL7YE.cjs"),require("../chunk-BAV5T2E3.cjs"),require("../chunk-T7PU2V7X.cjs"),require("../chunk-UDA26MCU.cjs"),require("../chunk-PZQ6I4JJ.cjs"),Object.defineProperty(exports,"findDuplicates",{enumerable:!0,get:function(){return e.findDuplicates}}),Object.defineProperty(exports,"omitKeys",{enumerable:!0,get:function(){return e.omitKeys}}),Object.defineProperty(exports,"omitKeysDeep",{enumerable:!0,get:function(){return e.omitKeysDeep}});
+/*!
+ * ====================================================
+ * Rzl Utils-JS.
+ * ----------------------------------------------------
+ * Version: 3.5.1.
+ * Author: Rizalvin Dwiky.
+ * Repository: https://github.com/rzl-zone/utils-js.
+ * ====================================================
+ */
+'use strict';
+
+var chunkLS6U7FAY_cjs = require('../chunk-LS6U7FAY.cjs');
+require('../chunk-FJZGG54N.cjs');
+require('../chunk-JBQMXC5I.cjs');
+require('../chunk-ZETAZZLD.cjs');
+require('../chunk-6JFZL7YE.cjs');
+require('../chunk-BAV5T2E3.cjs');
+require('../chunk-T7PU2V7X.cjs');
+require('../chunk-UDA26MCU.cjs');
+require('../chunk-PZQ6I4JJ.cjs');
+
+Object.defineProperty(exports, "findDuplicates", {
+  enumerable: true,
+  get: function () { return chunkLS6U7FAY_cjs.findDuplicates; }
+});
+Object.defineProperty(exports, "omitKeys", {
+  enumerable: true,
+  get: function () { return chunkLS6U7FAY_cjs.omitKeys; }
+});
+Object.defineProperty(exports, "omitKeysDeep", {
+  enumerable: true,
+  get: function () { return chunkLS6U7FAY_cjs.omitKeysDeep; }
+});

package/dist/operations/index.d.ts

@@ -1,3 +1,12 @@
+/*!
+ * ====================================================
+ * Rzl Utils-JS.
+ * ----------------------------------------------------
+ * Version: 3.5.1.
+ * Author: Rizalvin Dwiky.
+ * Repository: https://github.com/rzl-zone/utils-js.
+ * ====================================================
+ */
 import{NumberRangeUnion}from'@rzl-zone/ts-types-plus';
 /** ----------------------------------------------------------------------
  * * ***Utility: `findDuplicates`.***
@@ -124,4 +133,4 @@ declare const omitKeys:<I extends Record<string,unknown>,K extends keyof I>(obje
  * omitKeysDeep({ mixed: { a: [1, 2, 3], b: { c: 4 } } }, ["mixed.b.c"]);
  * // ➔ { mixed: { a: [1, 2, 3] } }
  */
-declare const omitKeysDeep:<I extends Record<string,unknown>>(object:I,keysToOmit:DotPath<I>[])=>Partial<I>;export{findDuplicates,omitKeys,omitKeysDeep};
+declare const omitKeysDeep:<I extends Record<string,unknown>>(object:I,keysToOmit:DotPath<I>[])=>Partial<I>;export{findDuplicates,omitKeys,omitKeysDeep};

package/dist/operations/index.js

@@ -1 +1,18 @@
-export{findDuplicates,omitKeys,omitKeysDeep}from"../chunk-OYTYSY7G.js";import"../chunk-2CQX5CBG.js";import"../chunk-NBZWMBO6.js";import"../chunk-6JFCSH7J.js";import"../chunk-CKTLUNWX.js";import"../chunk-YWHHVDT4.js";import"../chunk-PET42Z7W.js";import"../chunk-QNKGP5DY.js";import"../chunk-CMW2TBOQ.js";
+/*!
+ * ====================================================
+ * Rzl Utils-JS.
+ * ----------------------------------------------------
+ * Version: 3.5.1.
+ * Author: Rizalvin Dwiky.
+ * Repository: https://github.com/rzl-zone/utils-js.
+ * ====================================================
+ */
+export { findDuplicates, omitKeys, omitKeysDeep } from '../chunk-OYTYSY7G.js';
+import '../chunk-2CQX5CBG.js';
+import '../chunk-NBZWMBO6.js';
+import '../chunk-6JFCSH7J.js';
+import '../chunk-CKTLUNWX.js';
+import '../chunk-YWHHVDT4.js';
+import '../chunk-PET42Z7W.js';
+import '../chunk-QNKGP5DY.js';
+import '../chunk-CMW2TBOQ.js';