@rzl-zone/utils-js 3.2.6-beta.0 → 3.3.0

package/dist/{isPlainObject-BVhBAPHX.d.ts → isPlainObject-DGJkcFYw.d.ts}

@@ -1,13 +1,14 @@
-import{N as NonPlainObject}from'./type-data-DDs-u2kq.js';
-/** Types for **{@link getPreciseType}**. */
+import{N as NonPlainObject}from'./prettify-3o8_Kw6b.js';
+/** ---------------------------------------------------------------------------
+ * * ***Type Options for {@link getPreciseType | `getPreciseType`}.***
+ * ---------------------------------------------------------------------------
+ */
 type GetPreciseTypeOptions={
 /** -------------------------------------------------------
  * * ***Specifies the format in which the returned string type should be transformed.***
  * -------------------------------------------------------
- *
- * ℹ️ For special string literals in `SPECIAL_CASES` (`"-Infinity" | "Infinity" | "NaN"`), which will remain unchanged.
+ * **ℹ️ For special string literals in `SPECIAL_CASES` (`"-Infinity" | "Infinity" | "NaN"`), which will remain unchanged.**
  * @default "toLowerCase"
- *
  * @description
  * Supported formats:
  * - `"toLowerCase"` (default) — converts all letters to lowercase.
@@ -26,7 +27,6 @@ type GetPreciseTypeOptions={
  *   - ➔ `"Result Example Type"`
  * - `"slugify"` — URL-friendly slug (lowercase with hyphens).
  *   - ➔ `"result-example-type"`
- *
  * @note
  * ⚠️ If an invalid value is provided, the function will automatically fallback to the default `"toLowerCase"`.
  */

package/dist/{never-BfayMBF9.d.ts → never-D89PbPh5.d.ts}

@@ -1,9 +1,8 @@
-import{I as If}from'./if-CvT4R7Kh.js';
+import{I as If}from'./if-ChM35c_q.js';
 /** -------------------------------------------------------
- * * ***IsNever.***
+ * * ***Utility Type: `IsNever`.***
  * -------------------------------------------------------
- * **Conditional**: returns `true` if `T` is `never`, otherwise `false`.
- *
+ * ****Conditional**: returns `true` if `T` is `never`, otherwise `false`.**
  * @template T - Type to check.
  * @example
  * ```ts
@@ -13,11 +12,10 @@ import{I as If}from'./if-CvT4R7Kh.js';
  */
 type IsNever<T>=[T] extends [never]?true:false;
 /** -------------------------------------------------------
- * * ***IfNever.***
+ * * ***Utility Type: `IfNever`.***
  * -------------------------------------------------------
- * **Conditional**: Selects one of two branches depending on whether `T` is `never`.
+ * ****Conditional**: Selects one of two branches depending on whether `T` is `never`.**
  * - Defaults: `IfTrue = true`, `IfFalse = false`.
- *
  * @template T - Type to check.
  * @template IfTrue - The branch type if `T` is `never`, (default: `true`).
  * @template IfFalse - The branch type if `T` is not `never`, (default: `false`).
@@ -35,14 +33,9 @@ type IsNever<T>=[T] extends [never]?true:false;
  */
 type IfNever<T,IfTrue=true,IfFalse=false>=If<IsNever<T>,IfTrue,IfFalse>;
 /** -------------------------------------------------------
- * * ***NeverifyPropertiesOptions.***
+ * * ***Utility Type: `NeverifyPropertiesOptions`.***
  * -------------------------------------------------------
- * Configuration options for the ***{@link NeverifyProperties}*** type utility.
- *
- * @property makeOptional - Whether to make all properties optional.
- *   - If `true`, resulting properties will be optional (`?`).
- *   - Default: `false`.
- *
+ * **Configuration options for the ***{@link NeverifyProperties | `NeverifyProperties`}*** type utility.**
  * @example
  * ```ts
  * type Opt1 = NeverifyPropertiesOptions;
@@ -50,24 +43,22 @@ type IfNever<T,IfTrue=true,IfFalse=false>=If<IsNever<T>,IfTrue,IfFalse>;
  * ```
  */
 type NeverifyPropertiesOptions={
-/** Whether to make all properties optional, defaultValue: `false`.
+/** * ***Whether to make all properties optional, defaultValue: `false`.***
  *
  * @default false
  */
 makeOptional:boolean;};
 /** -------------------------------------------------------
- * * ***NeverifyProperties.***
+ * * ***Utility Type: `NeverifyProperties`.***
  * -------------------------------------------------------
- * Turns all properties of an object to type `never`.
+ * **Turns all properties of an object to type `never`.**
  * - If `Options["makeOptional"]` is `true`, properties will be optional.
- *
  * @template T - Object type to transform.
  * @template Options - Configuration options (default: `{ makeOptional: false }`).
  * @example
  * ```ts
  * type A = NeverifyProperties<{ a: string; b: string }>;
  * // ➔ { a: never; b: never }
- *
  * type B = NeverifyProperties<{ a: string; b: string }, { makeOptional: true }>;
  * // ➔ { a?: never; b?: never }
  * ```

package/dist/next/index.cjs

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

package/dist/next/index.d.ts

@@ -1,4 +1,4 @@
-import{I as IsAny}from'../any-BmdI8UbK.js';import'../if-CvT4R7Kh.js';
+import{I as IsAny}from'../any-v4TsK9ES.js';import'../if-ChM35c_q.js';
 /** ---------------------------------------------------------
  * * ***Extracts dynamic route parameters from a given route string.***
  * ---------------------------------------------------------
@@ -39,8 +39,9 @@ type ExtractRouteParams<T>=T extends string?HasDynamicSegments<T>extends true?T
  */
 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.***
+ * * ***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]`.
@@ -86,9 +87,11 @@ prefix?:string;
  * @default true */
 withOrigin?:boolean;};
 /** ---------------------------------
- * * ***Constructs a backend API URL by appending a given pathname to the base API URL.***
+ * * ***Utility for NextJS: `createBeApiUrl`.***
  * ---------------------------------
- * This function builds on top of `getBeApiUrl()`.
+ * **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.
@@ -130,14 +133,14 @@ declare const createBeApiUrl:(
  * @default ""
  */
 pathname:string|null|undefined,options?:OptionsCreateBeApiUrl)=>string;type OptionsGetBeApiUrl={
-/** * The Suffix origin base api url, e.g:`http://localhost.com/api`, default: `"/"`.
+/** * ***The Suffix origin base api url, e.g:`http://localhost.com/api`, default: `"/"`.***
  *
  * @default "/" */
 suffix?:string;};
 /** ---------------------------------------------------
- * * ***Retrieves the base API URL of the backend.***
+ * * ***Utility for NextJS: `getBeApiUrl`.***
  * ---------------------------------------------------
- * **This function determines the backend API base URL from the `NEXT_PUBLIC_BACKEND_API_URL` environment variable.**
+ * **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.
@@ -147,7 +150,7 @@ suffix?:string;};
  * 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").
+ * - 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.
@@ -170,11 +173,11 @@ suffix?:string;};
  * getBeApiUrl({ suffix: "/v1" });
  * // ➔ "http://localhost:8000/v1"
  */
-declare const getBeApiUrl:({suffix}?:OptionsGetBeApiUrl)=>string;
+declare const getBeApiUrl:(options?:OptionsGetBeApiUrl)=>string;
 /** ---------------------------------------------------
- * * ***Retrieves the base URL of the application.***
+ * * ***Utility for NextJS: `getBaseUrl`.***
  * ---------------------------------------------------
- * **This function is designed to be used within `Next.js` applications.**
+ * **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"`.
@@ -190,7 +193,7 @@ declare const getBeApiUrl:({suffix}?:OptionsGetBeApiUrl)=>string;
  * getBaseUrl();
  * // ➔ "https://example.com"
  *
- * // With custom port via NEXT_PUBLIC_PORT_FE  at `*.env` file
+ * // With custom port via NEXT_PUBLIC_PORT_FE at `*.env` file
  * NEXT_PUBLIC_BASE_URL = "http://localhost";
  * NEXT_PUBLIC_PORT_FE = "4000";
  * getBaseUrl();

package/dist/next/index.js

@@ -1 +1 @@
-import{normalizePathname as e,formatEnvPort as r}from"../chunk-LJVGJLP4.js";import{removeSpaces as t}from"../chunk-MISCBZJC.js";import{isEmptyString as o}from"../chunk-KOVO72OM.js";import{assertIsString as n}from"../chunk-T4CIAKEK.js";import"../chunk-WVSPXFTY.js";import{safeStableStringify as i}from"../chunk-BHIBDDQF.js";import"../chunk-QNKGP5DY.js";import{isString as a,getPreciseType as s,assertIsPlainObject as p,isNil as c,isNonEmptyArray as u,isNonEmptyString as l,isPlainObject as m,isUndefined as f,assertIsBoolean as h,isError as $}from"../chunk-EW3I4O7X.js";function d(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: "${s(e)}": \`${i(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 i=r[e];if(!a(i)){n.push(`- Invalid parameter: "${e}" must be of type \`string\`, but received: \`${s(i)}\`.`);continue}if(o(i)){n.push(`- Parameter "${e}" cannot be empty string.`);continue}const p=t.filter(e=>i.includes(e));if(/\s/.test(i)&&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 g=(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:i="/api",withOrigin:p=!0}=t;if(!f(i)&&!a(i))throw new TypeError(`Parameter \`prefix\` property of the \`options\` (second parameter) must be of type \`string\`, but received: \`${s(i)}\`.`);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),i=e(i);const u=i.endsWith("/")?i:i+"/";(r===i||r===i+"/"||r.startsWith(u))&&(r=r.slice(i.length),r=e(r));const l=v({suffix:i});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())}},v=({suffix:e="/"}={})=>{var o;n(e,{message:({currentType:e,validType:r})=>`Parameter \`suffix\` property of the first parameter must be of type \`${r}\`, but received: \`${e}\`.`});try{let n=null==(o=process.env.NEXT_PUBLIC_BACKEND_API_URL)?void 0:o.trim();if(n){n=t(n);const e=new URL(n);!!!e.port&&process.env.NEXT_PUBLIC_PORT_BE&&(n=e.origin+r(process.env.NEXT_PUBLIC_PORT_BE,{prefixColon:!0}))}else n="http://localhost"+r(process.env.NEXT_PUBLIC_PORT_BE||"8000",{prefixColon:!0});e=t(e).length?t(e):"/";const i=new URL(n.replace(/\/+$/,"")).origin;return`${i}${"/"===e?"/":`${e.startsWith("/")?"":"/"}${e.replace(/\/+$/,"")}`}`}catch(e){throw new Error("Invalid `NEXT_PUBLIC_BACKEND_API_URL`, failed to generate from `getBeApiUrl()`, Error:"+e)}},E=()=>{var e,o;try{const n=null==(e=process.env.NEXT_PUBLIC_BASE_URL)?void 0:e.trim(),i=null==(o=process.env.NEXT_PUBLIC_PORT_FE)?void 0:o.trim();let a=n||"http://localhost";a=t(a).replace(/\/+$/,"");const s=/:\/\/[^/]+:\d+/.test(a);!s&&i?a+=r(i,{prefixColon:!0}):s||n||(a+=":3000");const p=new URL(a);return`${p.protocol}//${p.hostname}${p.port?`:${p.port}`:""}`}catch(e){throw new Error("Invalid `NEXT_PUBLIC_BASE_URL`, failed to generate from `getBaseUrl()`, Error:"+e)}};export{g as createBeApiUrl,d as generateRoute,E as getBaseUrl,v as getBeApiUrl};
+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};

package/dist/next/server/index.cjs

@@ -1 +1 @@
-"use strict";var e=require("../../chunk-D3VSHABU.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}`};
+"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}`};

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

@@ -6,7 +6,7 @@ import{NextRequest}from'next/server';
  * - **ℹ️ 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 {NextRequest} request - The incoming ***`NextJS`*** request object, must be instanceof `NextRequest` from `next/server`.
  * @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.

package/dist/next/server/index.js

@@ -1 +1 @@
-import{isFunction as e,assertIsBoolean as r}from"../../chunk-EW3I4O7X.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};
+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};

package/dist/{nils-DMz3kU7M.d.ts → nils-CO8zLHSB.d.ts}

@@ -1,20 +1,17 @@
 /** --------------------------------------------------
- * * ***Nullish.***
+ * * ***Utility Type: `Nullish`.***
  * --------------------------------------------------
- * Represents all values considered **"nullish"**:
- * - `null`
- * - `undefined`
- *
- * Useful as a shorthand when working with optional or missing values.
+ * **Useful as a shorthand when working with optional or missing values.**
+ * - **Represents all values considered **`nullish`**:**
+ *    - `null`
+ *    - `undefined`
  */
 type Nullish=null|undefined;
 /** --------------------------------------------------
- * * ***Nullable.***
+ * * ***Utility Type: `Nullable`.***
  * --------------------------------------------------
- * Represents a type that can be either `T` or `null`.
- *
+ * **Represents a type that can be either `T` or `null`.**
  * @template T - The base type.
- *
  * @example
  * ```ts
  * type A = Nullable<string>; // ➔ string | null
@@ -22,12 +19,10 @@ type Nullish=null|undefined;
  */
 type Nullable<T>=T|null;
 /** --------------------------------------------------
- * * ***Nilable.***
+ * * ***Utility Type: `Nilable`.***
  * --------------------------------------------------
- * Represents a type that can be either `T`, `null`, or `undefined`.
- *
+ * **Represents a type that can be either `T`, `null`, or `undefined`.**
  * @template T - The base type.
- *
  * @example
  * ```ts
  * type A = Nilable<number>; // ➔ number | null | undefined
@@ -35,12 +30,10 @@ type Nullable<T>=T|null;
  */
 type Nilable<T>=T|null|undefined;
 /** --------------------------------------------------
- * * ***Undefinedable.***
+ * * ***Utility Type: `Undefinedable`.***
  * --------------------------------------------------
- * Represents a type that can be either `T` or `undefined`.
- *
+ * **Represents a type that can be either `T` or `undefined`.**
  * @template T - The base type.
- *
  * @example
  * ```ts
  * type A = Undefinedable<boolean>; // ➔ boolean | undefined
@@ -48,95 +41,79 @@ type Nilable<T>=T|null|undefined;
  */
 type Undefinedable<T>=T|undefined;
 /** -------------------------------------------------------
- * * ***NonNil.***
+ * * ***Utility Type: `NonNil`.***
  * -------------------------------------------------------
- * Removes both `null` and `undefined` from the given type `T`.
- *
+ * **Removes both `null` and `undefined` from the given type `T`.**
  * @template T - The type to filter.
- *
  * @example
  * ```ts
  * type A = NonNil<string | null | undefined>;
  * // ➔ string
- *
  * type B = NonNil<number | null>;
  * // ➔ number
- *
  * type C = NonNil<undefined | null>;
  * // ➔ never
- *
  * type D = NonNil<boolean | undefined>;
  * // ➔ boolean
  * ```
  */
 type NonNil<T>=T extends null|undefined?never:T;
 /** -------------------------------------------------------
- * * ***NonNull.***
+ * * ***Utility Type: `NonNull`.***
  * -------------------------------------------------------
- * Removes `null` from the given type `T`.
- *
+ * **Removes `null` from the given type `T`.**
  * @template T - The type to filter.
- *
  * @example
  * ```ts
  * type A = NonNull<string | null>;
  * // ➔ string
- *
  * type B = NonNull<number | null | undefined>;
  * // ➔ number | undefined
- *
  * type C = NonNull<null>;
  * // ➔ never
  * ```
  */
 type NonNull<T>=T extends null?never:T;
 /** -------------------------------------------------------
- * * ***NonUndefined.***
+ * * ***Utility Type: `NonUndefined`.***
  * -------------------------------------------------------
- * Remove `undefined` from the given type `T`.
- *
+ * **Remove `undefined` from the given type `T`.**
  * @template T - The type to filter.
- *
  * @example
  * ```ts
  * type A = NonUndefined<string | undefined>;
  * // ➔ string
- *
  * type B = NonUndefined<number | null | undefined>;
  * // ➔ number | null
- *
  * type C = NonUndefined<undefined>;
  * // ➔ never
  * ```
  */
 type NonUndefined<T>=T extends undefined?never:T;
 /** --------------------------------------------------
- * * ***KeepNil.***
+ * * ***Utility Type: `KeepNil`.***
  * --------------------------------------------------
- *
- * Keeps `null` and/or `undefined` in the output type
- * **only if** they exist in the input type `T`.
- * Otherwise, resolves to `never`.
- *
+ * **Keeps `null` and/or `undefined` in the output type **only if** they
+ * exist in the input type `T`, otherwise, resolves to `never`.**
  * @template T - Input type to check for `null` and `undefined`.
- *
  * @example
  * ```ts
- * type A = KeepNil<string | null>;          // ➔ null
- * type B = KeepNil<number | undefined>;     // ➔ undefined
- * type C = KeepNil<string | null | undefined>; // ➔ null | undefined
- * type D = KeepNil<boolean>;                // ➔ never
+ * type A = KeepNil<string | null>;
+ * // ➔ null
+ * type B = KeepNil<number | undefined>;
+ * // ➔ undefined
+ * type C = KeepNil<string | null | undefined>;
+ * // ➔ null | undefined
+ * type D = KeepNil<boolean>;
+ * // ➔ never
  * ```
  */
 type KeepNil<T>=(null extends T?null:never)|(undefined extends T?undefined:never);
 /** --------------------------------------------------
- * * ***KeepNull.***
+ * * ***Utility Type: `KeepNull`.***
  * --------------------------------------------------
- * Keeps `null` in the output type **only if** the input type `T` includes `null`.
- * Otherwise resolves to `never`.
- *
+ * **Keeps `null` in the output type **only if** the input type `T` includes `null`, otherwise resolves to `never`.**
  * @template T - Input type to check for `null`.
- *
  * @example
  * ```ts
  * type A = KeepNull<string | null>; // ➔ null
@@ -145,13 +122,10 @@ type KeepNil<T>=(null extends T?null:never)|(undefined extends T?undefined:never
  */
 type KeepNull<T>=null extends T?null:never;
 /** --------------------------------------------------
- * * ***KeepUndef.***
+ * * ***Utility Type: `KeepUndef`.***
  * --------------------------------------------------
- * Keeps `undefined` in the output type **only if** the input type `T` includes `undefined`.
- * Otherwise resolves to `never`.
- *
+ * **Keeps `undefined` in the output type **only if** the input type `T` includes `undefined`, otherwise resolves to `never`.**
  * @template T - Input type to check for `undefined`.
- *
  * @example
  * ```ts
  * type A = KeepUndef<number | undefined>; // ➔ undefined
@@ -160,17 +134,17 @@ type KeepNull<T>=null extends T?null:never;
  */
 type KeepUndef<T>=undefined extends T?undefined:never;
 /** -------------------------------------------------------
- * * ***NullToUndefined.***
+ * * ***Utility Type: `NullToUndefined`.***
  * -------------------------------------------------------
- * Transforms `null` or `undefined` types into `undefined`, otherwise, returns the original type `T` unchanged.
- *
+ * **Transforms `null` or `undefined` types into `undefined`, otherwise, returns
+ * the original type `T` unchanged.**
  * @template T - The input type to transform.
  * @example
  * ```ts
- * type A = NullToUndefined<null>;          // ➔ undefined
- * type B = NullToUndefined<undefined>;     // ➔ undefined
- * type C = NullToUndefined<string>;        // ➔ string
- * type D = NullToUndefined<null[]>;        // ➔ null[]
+ * type A = NullToUndefined<null>;      // ➔ undefined
+ * type B = NullToUndefined<undefined>; // ➔ undefined
+ * type C = NullToUndefined<string>;    // ➔ string
+ * type D = NullToUndefined<null[]>;    // ➔ null[]
  * type E = NullToUndefined<(string | null)[]>; // ➔ (string | null)[]
  * ```
  */

package/dist/operations/index.cjs

@@ -1 +1 @@
-"use strict";var e=require("../chunk-EKS4IZJR.cjs");require("../chunk-EOZKYR5S.cjs"),require("../chunk-JARPXKBM.cjs"),require("../chunk-VHAPTHEA.cjs"),require("../chunk-5C2SMIGX.cjs"),require("../chunk-ZHV5ZYVN.cjs"),require("../chunk-UDA26MCU.cjs"),require("../chunk-D3VSHABU.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}});
+"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}});

package/dist/operations/index.d.ts

@@ -1,4 +1,4 @@
-import{N as NumberRangeUnion}from'../NumberRangeUnion-DC-C3_Kq.js';
+import{N as NumberRangeUnion}from'../NumberRangeUnion-B6bhM2s7.js';
 /** ----------------------------------------------------------------------
  * * ***Utility: `findDuplicates`.***
  * ----------------------------------------------------------------------
@@ -61,8 +61,8 @@ declare const omitKeys:<I extends Record<string,unknown>,K extends keyof I>(obje
  * ------------------------------------------------------
  * **Recursively omits properties from an object using dot notation paths.**
  * - **Behavior:**
- *    - Also removes resulting empty objects (`{}`) and arrays (`[]`),
- *    - cascading upwards to remove empty parents until root if needed.
+ *    - Removes resulting empty objects (`{}`) and arrays (`[]`), cascading upwards
+ *      to remove empty parents until root if needed.
  * - **⚠️ Be careful:**
  *    - If after omission an object or array becomes empty, it will be removed entirely
  *      including all the way up to the root if necessary, resulting in `{}`.
@@ -73,7 +73,7 @@ declare const omitKeys:<I extends Record<string,unknown>,K extends keyof I>(obje
  *      manually type `"arr.99.key"` and it will work the same.
  * @template I - Type of the input object
  * @param {I} object
- *  The object to process. Should be a plain nested object or array structure.
+ *  The object to process, should be a plain nested object or array structure.
  * @param {DotPath<I>[]} keysToOmit
  *  An array of string paths in dot notation indicating the properties to remove, paths
  *  can include numeric indices to target array elements, e.g. `"arr.0.x"` to

package/dist/operations/index.js

@@ -1 +1 @@
-export{findDuplicates,omitKeys,omitKeysDeep}from"../chunk-CE4JI2YB.js";import"../chunk-XLDAIZRK.js";import"../chunk-ZTCLKKMB.js";import"../chunk-ECRNH4FW.js";import"../chunk-FIAAX3UE.js";import"../chunk-BHIBDDQF.js";import"../chunk-QNKGP5DY.js";import"../chunk-EW3I4O7X.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";

package/dist/or-C6qzKt2I.d.ts

@@ -0,0 +1,82 @@
+import{E as Extends,I as IfExtends}from'./extends-DtdRjDyU.js';
+/** -------------------------------------------------------
+ * * ***Utility Type: `And`.***
+ * -------------------------------------------------------
+ * **Performs a **logical AND** operation between two boolean types.**
+ * - **Behavior:**
+ *    - Returns `true` if **both** conditions extend `true`.
+ *    - Returns `false` for otherwise.
+ * @template Condition1 - The first condition.
+ * @template Condition2 - The second condition.
+ * @example
+ * ```ts
+ * type Case1 = And<true, true>;
+ * // ➔ true
+ * type Case2 = And<false, true>;
+ * // ➔ false
+ * type Case3 = And<true, false>;
+ * // ➔ false
+ * type Case4 = And<false, false>;
+ * // ➔ false
+ * ```
+ */
+type And<Condition1,Condition2>=IfExtends<Condition1,true,Extends<Condition2,true>>;
+/** -------------------------------------------------------
+ * * ***Utility Type: `AndArr`.***
+ * -------------------------------------------------------
+ * **Performs a **logical AND** operation across all elements in an array of
+ * boolean types.**
+ * - **Behavior:**
+ *    - Returns `true` if **all elements** extend `true`.
+ *    - Returns `false` if **any element** is not `true`.
+ * @template Conditions - A readonly array of boolean conditions.
+ * @example
+ * ```ts
+ * type Case1 = AndArr<[true, true, true]>;
+ * // ➔ true
+ * type Case2 = AndArr<[true, true, false]>;
+ * // ➔ false
+ * type Case3 = AndArr<[false, false, false]>;
+ * // ➔ false
+ * type Case4 = AndArr<[]>;
+ * // ➔ false
+ * ```
+ */
+type AndArr<Conditions extends readonly unknown[]>=Extends<[],Conditions>extends true?false:Extends<Conditions[number],true>;
+/** -------------------------------------------------------
+ * * ***Utility Type: `Or`.***
+ * -------------------------------------------------------
+ * **Computes the logical OR of two type-level boolean conditions.**
+ * @template Condition1 - First boolean condition.
+ * @template Condition2 - Second boolean condition.
+ * @example
+ * ```ts
+ * type Case1 = Or<true, true>;   // ➔ true
+ * type Case2 = Or<false, true>;  // ➔ true
+ * type Case3 = Or<false, false>; // ➔ false
+ * type Case4 = Or<true, false>;  // ➔ true
+ * ```
+ * @remarks
+ * - Uses {@link IfExtends | **`IfExtends`**} to determine if either condition is `true`.
+ * - Returns `true` if at least one of the two conditions is `true`.
+ * - Returns `false` only if both are `false`.
+ */
+type Or<Condition1,Condition2>=IfExtends<Condition1,true,true,IfExtends<Condition2,true>>;
+/** -------------------------------------------------------
+ * * ***Utility Type: `OrArr`.***
+ * -------------------------------------------------------
+ * **Computes the logical OR of all elements inside a tuple or array of boolean types.**
+ * @template Conditions - An array of boolean type elements.
+ * @example
+ * ```ts
+ * type Case1 = OrArr<[true, true, true]>;    // ➔ true
+ * type Case2 = OrArr<[true, true, false]>;   // ➔ true
+ * type Case3 = OrArr<[false, false, false]>; // ➔ false
+ * type Case4 = OrArr<[]>;                    // ➔ false
+ * ```
+ * @remarks
+ * - Uses TypeScript's indexed access types and conditional type inference.
+ * - Returns `true` if at least one element in the array is `true`.
+ * - Returns `false` if all elements are `false` or array is empty.
+ */
+type OrArr<Conditions extends readonly unknown[]>=true extends Conditions[number]?true:false;export type{And as A,OrArr as O,AndArr as a,Or as b};