@rzl-zone/utils-js 2.1.0 → 3.0.0

package/dist/next/index.js

@@ -1 +1 @@
-function E(r){return Array.isArray(r)}var o=r=>typeof r=="string";var h=(r,e)=>{if(!o(r))return true;s(e)||(e={});let{trim:n=true}=e;return n&&(r=r.trim()),r===""};var d=r=>typeof r=="boolean";var $=r=>r instanceof Error;function T(r){return Array.isArray(r)&&r.length>0}function s(r){return typeof r=="object"&&!v(r)&&!E(r)}var p=(r,e)=>{if(!o(r))return false;s(e)||(e={});let{trim:n=true}=e;return(n?r.trim():r).length>0};var u=r=>typeof r>"u";function v(r){return r==null}var c=(r,e={trimOnly:false})=>{if(!p(r))return "";s(e)||(e={});let{trimOnly:n=false}=e;return n?r.trim():r.replace(/\s+/g,"")};var w=(r,e="/")=>{if(!p(e))throw new TypeError(`Invalid parameter:'defaultPath' must be a string and string is non-empty string. Received:${typeof e}(${e})`);if(!p(r))return e;try{if(r=c(r,{trimOnly:!0}),r=r.replace(/\s+/g,""),r.startsWith("http://")||r.startsWith("https://")){let n=new URL(r);return `${n.pathname}${n.search}${n.hash}`.replace(/^\/+/,"/")}return "/"+r.replace(/^\/+/,"").replace(/\/{2,}/g,"/")}catch(n){let t=$(n)?n:new Error("Unknown error from function `normalizePathname()`");throw new x(`Failed to normalize pathname in function \`normalizePathname()\`:${t.message}`,t)}};var y=(r,e)=>{if(!p(r))return "";if(!u(e)){if(!s(e))throw new TypeError("Options must be an object.");if("prefixColon"in e&&!d(e.prefixColon))throw new TypeError("Option `prefixColon` must be a boolean.")}let n=r.replace(/\D+/g,"");return n?e?.prefixColon??false?`:${n}`:n:""};var x=class r extends Error{constructor(n,t){super(n);this.originalError=t;this.name="NormalizePathnameError",Error.captureStackTrace&&Error.captureStackTrace(this,r);}};function G(r,e){if(!o(r)||h(r))throw new TypeError(`\u{1F6A8}'generateRoute' Failed:- Invalid 'route' value.- Expected a non-empty string,but received ${typeof r}:${JSON.stringify(r)}`);if(!r.includes("["))return r;if(!s(e))throw new Error(`\u{1F6A8}'generateRoute' Failed cause in route "${r}":- Missing or invalid parameters object for route:"${r}",expected an object mapping parameters.`);if(!e)throw new Error(`\u{1F6A8}'generateRoute' Failed cause in route "${r}":- Missing parameters object for route:"${r}"`);let n=["?","&","#","=","/"," ","'",'"',"(",")","+",";","%","@",":"],t=[],i=Array.from(r.matchAll(/\[(\w+)\]/g)).map(a=>a[1]);for(let a of i){let l=e[a];if(u(l)){t.push(`- Missing parameter:"${a}".`);continue}let f=l.trim();if(!f){t.push(`- Parameter "${a}" cannot be empty.`);continue}f.includes("/")&&t.push(`- Parameter "${a}" contains slashes "/" which is not allowed.`);let g=n.filter(m=>m!=="/").filter(m=>f.includes(m));g.length>0&&t.push(`- Parameter "${a}" contains invalid characters(${g.length>1?g.join(","):g}). These characters are not allowed because they could cause issues in URL structure. The following characters are forbidden in route parameters:(${n.join(",")}).`);}if(T(t))throw new Error(`\u{1F6A8}'generateRoute' Failed cause in route "${r}":${t.join(``)}`);return r.replace(/\[(\w+)\]/g,(a,l)=>e[l].trim().replace(/^\/+|\/+$/g,"")).replace(/\/+/g,"/")}var rr=(r="",e)=>{try{let f=function(m,P){return `${m.replace(/\/+$/,"")}/${P.replace(/^\/+/,"")}`};var n=f;if(!o(r))throw new TypeError(`Invalid type for 'pathname'. Expected 'string',received:${typeof r}`);s(e)||(e={});let{prefix:t="/api",withOrigin:i=!0}=e;if(!u(t)&&!o(t))throw new TypeError(`Invalid type for 'prefix'. Expected 'string',received:${typeof t}`);if(!d(i))throw new TypeError(`Invalid type for 'withOrigin'. Expected 'boolean',received:${typeof i}`);r=w(r),t=w(t);let a=t.endsWith("/")?t:t+"/";(r===t||r===t+"/"||r.startsWith(a))&&(r=r.slice(t.length),r=w(r));let l=b({suffix:t});return f(i?l:new URL(l).pathname,r).replace(/\/+$/,"")}catch(t){throw new Error("Failed to generate backend API URL in `createBeApiUrl()`,Error:"+t)}};var b=({suffix:r="/"}={})=>{if(!o(r))throw new TypeError(`Invalid type for 'suffix'. Expected string,received:${typeof r}`);try{let e=process.env.NEXT_PUBLIC_BACKEND_API_URL?.trim();if(e){e=c(e);let i=new URL(e);!!!i.port&&process.env.NEXT_PUBLIC_PORT_BE&&(e=i.origin+y(process.env.NEXT_PUBLIC_PORT_BE,{prefixColon:!0}));}else e="http://localhost"+y(process.env.NEXT_PUBLIC_PORT_BE||"8000",{prefixColon:!0});r=c(r).length?c(r):"/";let n=new URL(e.replace(/\/+$/,"")).origin,t=r==="/"?"/":`${r.startsWith("/")?"":"/"}${r.replace(/\/+$/,"")}`;return `${n}${t}`}catch(e){throw new Error("Invalid `NEXT_PUBLIC_BACKEND_API_URL`,failed to generate from `getBeApiUrl()`,Error:"+e)}};var or=()=>{try{let r=process.env.NEXT_PUBLIC_BASE_URL?.trim(),e=process.env.NEXT_PUBLIC_PORT_FE?.trim(),n=r||"http://localhost";n=c(n).replace(/\/+$/,"");let t=/:\/\/[^/]+:\d+/.test(n);!t&&e?n+=y(e,{prefixColon:!0}):!t&&!r&&(n+=":3000");let i=new URL(n);return `${i.protocol}//${i.hostname}${i.port?`:${i.port}`:""}`}catch(r){throw new Error("Invalid `NEXT_PUBLIC_BASE_URL`,failed to generate from `getBaseUrl()`,Error:"+r)}};export{rr as createBeApiUrl,G as generateRoute,or as getBaseUrl,b as getBeApiUrl};
+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};

package/dist/next/server/index.cjs

@@ -1 +1 @@
-'use strict';require('server-only');var server=require('next/server');var n=t=>typeof t=="boolean";var i=t=>typeof t=="function";var m=(t,o=true)=>{if(!i(server.NextRequest))throw new Error("`getClientIpOrUrl` is designed to be used in a `Next.js` environment.");if(!(t instanceof server.NextRequest))throw new TypeError("Argument `request` must be an instance of NextRequest.");if(!n(o))throw new TypeError("Expected `includeFullUrl` to be a boolean.");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 r=e.length>1?e[e.length-1].trim():e[0];if(!o)return r;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"}://${r}:${f}`};exports.getClientIpOrUrl=m;
+"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}`};

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

@@ -1,22 +1,16 @@
-import{NextRequest}from 'next/server';
+import{NextRequest}from'next/server';
 /** ---------------------------------
- * * ***Retrieves the real client IP address and constructs the full URL using headers like***
- * ***`x-forwarded-for`, `x-forwarded-proto`, and `x-forwarded-port`.***
+ * * ***Utility for NextJS Server: `getClientIpOrUrl`.***
  * ---------------------------------
- *
- * * ⚠️ **Notes:**
- *   - Only supported in **Next.js** environments (specifically in `server-only` contexts).
- *   - Should be used in **middleware** or **server actions** that have access to `NextRequest`.
- *
- *
- * @param {NextRequest} request - The incoming Next.js request object.
- * @param {boolean} [includeFullUrl=true] - Whether to return the full URL (`protocol://ip:port`) or just the IP address.
- *
+ * **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";
@@ -27,16 +21,8 @@ import{NextRequest}from 'next/server';
  *   console.log("Client IP:", clientIp);
  * }
  *
- * @example
  * // Get full URL
  * const url = getClientIpOrUrl(request);
  * console.log("Client full URL:", url);
  */
-declare const getClientIpOrUrl:(
-/** * The incoming Next.js request object. */
-request:NextRequest,
-/** * Whether to return the full URL (protocol, IP, and port) or just the IP address.
- *
- * @default true
- */
-includeFullUrl?:boolean)=>string;export{getClientIpOrUrl};
+declare const getClientIpOrUrl:(request:NextRequest,includeFullUrl?:boolean)=>string;export{getClientIpOrUrl};

package/dist/next/server/index.js

@@ -1 +1 @@
-import'server-only';import{NextRequest}from'next/server';var n=t=>typeof t=="boolean";var i=t=>typeof t=="function";var m=(t,o=true)=>{if(!i(NextRequest))throw new Error("`getClientIpOrUrl` is designed to be used in a `Next.js` environment.");if(!(t instanceof NextRequest))throw new TypeError("Argument `request` must be an instance of NextRequest.");if(!n(o))throw new TypeError("Expected `includeFullUrl` to be a boolean.");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 r=e.length>1?e[e.length-1].trim():e[0];if(!o)return r;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"}://${r}:${f}`};export{m as getClientIpOrUrl};
+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};

package/dist/nils-DMz3kU7M.d.ts

@@ -0,0 +1,177 @@
+/** --------------------------------------------------
+ * * ***Nullish.***
+ * --------------------------------------------------
+ * Represents all values considered **"nullish"**:
+ * - `null`
+ * - `undefined`
+ *
+ * Useful as a shorthand when working with optional or missing values.
+ */
+type Nullish=null|undefined;
+/** --------------------------------------------------
+ * * ***Nullable.***
+ * --------------------------------------------------
+ * Represents a type that can be either `T` or `null`.
+ *
+ * @template T - The base type.
+ *
+ * @example
+ * ```ts
+ * type A = Nullable<string>; // ➔ string | null
+ * ```
+ */
+type Nullable<T>=T|null;
+/** --------------------------------------------------
+ * * ***Nilable.***
+ * --------------------------------------------------
+ * 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
+ * ```
+ */
+type Nilable<T>=T|null|undefined;
+/** --------------------------------------------------
+ * * ***Undefinedable.***
+ * --------------------------------------------------
+ * Represents a type that can be either `T` or `undefined`.
+ *
+ * @template T - The base type.
+ *
+ * @example
+ * ```ts
+ * type A = Undefinedable<boolean>; // ➔ boolean | undefined
+ * ```
+ */
+type Undefinedable<T>=T|undefined;
+/** -------------------------------------------------------
+ * * ***NonNil.***
+ * -------------------------------------------------------
+ * 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.***
+ * -------------------------------------------------------
+ * 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.***
+ * -------------------------------------------------------
+ * 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.***
+ * --------------------------------------------------
+ *
+ * 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 KeepNil<T>=(null extends T?null:never)|(undefined extends T?undefined:never);
+/** --------------------------------------------------
+ * * ***KeepNull.***
+ * --------------------------------------------------
+ * 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
+ * type B = KeepNull<string>;        // ➔ never
+ * ```
+ */
+type KeepNull<T>=null extends T?null:never;
+/** --------------------------------------------------
+ * * ***KeepUndef.***
+ * --------------------------------------------------
+ * 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
+ * type B = KeepUndef<number>;             // ➔ never
+ * ```
+ */
+type KeepUndef<T>=undefined extends T?undefined:never;
+/** -------------------------------------------------------
+ * * ***NullToUndefined.***
+ * -------------------------------------------------------
+ * 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 E = NullToUndefined<(string | null)[]>; // ➔ (string | null)[]
+ * ```
+ */
+type NullToUndefined<T>=T extends null?undefined:T extends undefined?undefined:T;export type{KeepNil as K,NonUndefined as N,Undefinedable as U,KeepNull as a,KeepUndef as b,Nilable as c,NonNil as d,NonNull as e,Nullable as f,NullToUndefined as g,Nullish as h};

package/dist/omit-VvmIsZmX.d.ts

@@ -0,0 +1,28 @@
+import{P as Prettify}from'./prettify-C4xLcYOP.js';
+/** --------------------------------------------------
+ * * ***OmitStrict.***
+ * --------------------------------------------------
+ * Strictly omits keys `K` from type `T`, with optional flattening for readability using `Prettify`.
+ *
+ * ✅ Enhances autocomplete and type inspection clarity in editors.
+ * ✅ Optionally flattens nested intersections or mapped types into a cleaner shape.
+ *
+ * @template T - The original object type.
+ * @template K - The keys to omit from `T`.
+ * @template WithPrettify - Whether to prettify the result (default is `true`).
+ * @template WithPrettifyRecursive - Whether to prettify nested object properties recursively (default is `true`).
+ *
+ * @example
+ * ```ts
+ * type A = { a: number; b: string; c: boolean };
+ * type B = OmitStrict<A, 'b'>;
+ * // ➔ { a: number; c: boolean }
+ *
+ * type C = OmitStrict<A, 'b', false>;
+ * // ➔ Omit without prettifying, keeps intersection structure
+ *
+ * type D = OmitStrict<A, 'b', true, false>;
+ * // ➔ Prettifies only top level, does not recurse into nested objects
+ * ```
+ */
+type OmitStrict<T,K extends keyof T,WithPrettify extends boolean=true,WithPrettifyRecursive extends boolean=true>=WithPrettify extends true?Prettify<Omit<T,K>,{recursive:WithPrettifyRecursive;}>:WithPrettify extends false?Omit<T,K>:never;export type{OmitStrict as O};

package/dist/operations/index.cjs

@@ -0,0 +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}});

package/dist/operations/index.d.ts

@@ -0,0 +1,127 @@
+import{N as NumberRangeUnion}from'../NumberRangeUnion-DC-C3_Kq.js';
+/** ----------------------------------------------------------------------
+ * * ***Utility: `findDuplicates`.***
+ * ----------------------------------------------------------------------
+ * **Finds duplicate values in an array by deep equality comparison.**
+ * - **Behavior:**
+ *    - Uses ***{@link isEqual | `isEqual`}*** to compare elements
+ *      (handles objects, arrays, dates, NaN, etc.).
+ *    - Returns a new array containing only the *first occurrences* of duplicated values.
+ *    - Does **not mutate** the original array.
+ *    - Throws ***{@link TypeError | `TypeError`}*** if input is not an array.
+ * @template T Type of elements in the input array.
+ * @param {T[]} values - The array to check for duplicates.
+ * @returns {T[]} An array of the duplicate values found in the input,
+ *                preserving order of their first duplicate appearance.
+ * @throws {TypeError} If the provided `values` argument is not an array.
+ * @example
+ * findDuplicates([1, 2, 2, 3, 4, 4]);
+ * // ➔ [2, 4]
+ * findDuplicates(["apple", "banana", "apple", "orange"]);
+ * // ➔ ["apple"]
+ * findDuplicates([{ a: 1 }, { a: 1 }, { a: 2 }]);
+ * // ➔ [{ a: 1 }]
+ * findDuplicates([NaN, NaN, 1]);
+ * // ➔ [NaN]
+ * findDuplicates([true, false, true]);
+ * // ➔ [true]
+ * findDuplicates([1, 2, 3]);
+ * // ➔ []
+ */
+declare const findDuplicates:<T>(values:T[])=>T[];
+/** --------------------------------
+ * * ***Utility: `omitKeys`.***
+ * --------------------------------
+ * **This function creates a shallow copy of the given object omitting the
+ *  specified keys.**
+ * - **Behavior:**
+ *    - It will return a new object without mutating the original.
+ *    - It also validates that ***`keysToOmit`*** does not contain duplicate keys.
+ * - **ℹ️ Internally:**
+ *    - It uses ***{@link isEqual | `isEqual`}*** to check for duplicates in
+ *      the ***`keysToOmit`*** array.
+ * @template I The type of the input object.
+ * @template K The keys to omit from the object.
+ * @param {I} object - The source object to omit keys from.
+ * @param {K[]} keysToOmit - An array of keys to exclude from the returned object.
+ * @returns {Omit<I, K>} A new object without the specified keys.
+ * @throws {TypeError} If `keysToOmit` is not an array.
+ * @throws {Error} If duplicate keys are found in `keysToOmit`.
+ * @example
+ * omitKeys({ a: 1, b: 2, c: 3 }, ["b", "c"]);
+ * //➔ { a: 1 }
+ * omitKeys({ name: "John", age: 30 }, ["age"]);
+ * //➔ { name: "John" }
+ * omitKeys({ a: 1, b: 2 }, []);
+ * //➔ { a: 1, b: 2 } (no changes)
+ */
+declare const omitKeys:<I extends Record<string,unknown>,K extends keyof I>(object:I,keysToOmit:K[])=>Omit<I,K>;type IndexArray=NumberRangeUnion<0,30>;type DotPath<T,Prev extends string="">=T extends Array<infer U>?DotPath<U,`${Prev}${Prev extends "" ? "" : "."}${IndexArray}`>:T extends object?{[K in keyof T & string]:`${Prev}${Prev extends "" ? "" : "."}${K}`|DotPath<T[K],`${Prev}${Prev extends "" ? "" : "."}${K}`>;}[keyof T & string]:never;
+/** ------------------------------------------------------
+ * * ***Utility: `omitKeysDeep`.***
+ * ------------------------------------------------------
+ * **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.
+ * - **⚠️ 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 `{}`.
+ * - **ℹ️ Note:**
+ *    - For array indices, TypeScript autocomplete only suggests `0`–`30`
+ *      (to prevent editor lag on large unions).
+ *      However, higher indices are still fully supported at runtime — you can
+ *      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.
+ * @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
+ *  remove `x` from the first object inside the `arr` array.
+ * @returns {Partial<I>}
+ *  A new deeply cloned object with the specified keys omitted, with resulting
+ *  empty objects or arrays fully removed (even if it collapses to `{}`).
+ * @throws {TypeError}
+ *    If `keysToOmit` is not an array will throw TypeError.
+ * @throws {Error} If `keysToOmit` contains duplicate paths will throw Error.
+ * @example
+ * omitKeysDeep({ arr: [{ a: 1 }] }, ["arr.0.a"]);
+ * // ➔ {} (array becomes empty and removed)
+ * omitKeysDeep({ a: { b: { c: 1 }, d: 2 }, e: 3 }, ["a.b.c"]);
+ * // ➔ { a: { d: 2 }, e: 3 }
+ * omitKeysDeep({ a: [{ b: 1 }, { c: 2 }] }, ["a.0.b"]);
+ * // ➔ { a: [{ c: 2 }] }
+ * omitKeysDeep({ a: [{ b: 1 }] }, ["a.0.b"]);
+ * // ➔ {} (array becomes empty and removed)
+ * omitKeysDeep({ complex: [{ deep: [{ x: 1, y: 2 }] }] }, ["complex.0.deep.0.x"]);
+ * // ➔ { complex: [{ deep: [{ y: 2 }] }] }
+ * omitKeysDeep({ complex: [{ deep: [{ x: 1 }] }] }, ["complex.0.deep.0.x"]);
+ * // ➔ {} (deep chain emptied and collapsed)
+ * omitKeysDeep({ data: [[{ foo: 1, bar: 2 }]] }, ["data.0.0.foo"]);
+ * // ➔ { data: [[{ bar: 2 }]] }
+ * omitKeysDeep({ data: [[{ foo: 1 }]] }, ["data.0.0.foo"]);
+ * // ➔ {} (nested arrays emptied completely)
+ * omitKeysDeep({ x: [{ y: [{ z: 1 }, { w: 2 }] }] }, ["x.0.y.0.z"]);
+ * // ➔ { x: [{ y: [{ w: 2 }] }] }
+ * omitKeysDeep({ x: [{ y: [{ z: 1 }] }] }, ["x.0.y.0.z"]);
+ * // ➔ {} (entire nested arrays removed)
+ * omitKeysDeep({ p: { q: { r: 5 } }, s: 6 }, ["p.q.r"]);
+ * // ➔ { s: 6 } (`p` removed because it becomes empty)
+ * omitKeysDeep({ arr: [{ a: 1, b: 2 }, { c: 3 }] }, ["arr.0.a"]);
+ * // ➔ { arr: [{ b: 2 }, { c: 3 }] }
+ * omitKeysDeep({ root: [{ sub: [{ leaf: 10 }] }] }, ["root.0.sub.0.leaf"]);
+ * // ➔ {} (deep nested arrays emptied to root)
+ * omitKeysDeep({ meta: { tags: ["x", "y"], count: 2 } }, ["meta.count"]);
+ * // ➔ { meta: { tags: ["x", "y"] } }
+ * omitKeysDeep({ arr: [[{ a: 1 }, { b: 2 }]] }, ["arr.0.0.a"]);
+ * // ➔ { arr: [[{ b: 2 }]] }
+ * omitKeysDeep({ arr: [[{ a: 1 }]] }, ["arr.0.0.a"]);
+ * // ➔ {} (double nested emptied)
+ * omitKeysDeep({ nested: [{ list: [{ id: 1, val: 2 }] }] }, ["nested.0.list.0.val"]);
+ * // ➔ { nested: [{ list: [{ id: 1 }] }] }
+ * omitKeysDeep({ nested: [{ list: [{ id: 1 }] }] }, ["nested.0.list.0.id"]);
+ * // ➔ {} (full collapse to empty)
+ * 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};

package/dist/operations/index.js

@@ -0,0 +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";

package/dist/parsers/index.cjs

@@ -0,0 +1 @@
+"use strict";var e=require("../chunk-IMCLPT5V.cjs");require("../chunk-D3VSHABU.cjs"),Object.defineProperty(exports,"extractFileName",{enumerable:!0,get:function(){return e.extractFileName}});

package/dist/parsers/index.d.ts

@@ -0,0 +1,36 @@
+/** ----------------------------------------------------------
+ * * ***Utility: `extractFileName`.***
+ * ----------------------------------------------------------
+ * **Extracts the base file name (without extension) from a given URL, file path, or file name.**
+ * - **Behavior:**
+ *    - Strips known extensions (including multi-part extensions such as `.tar.gz`, `.tar.bz2`, etc.).
+ *    - Handles plain file names, local file paths, and full URLs seamlessly.
+ *    - If the path ends with a `/`, returns an empty string `""` (represents a directory or empty segment).
+ *    - If the input is empty, whitespace, or not a string, returns `undefined`.
+ *    - Leaves unknown or unrecognized extensions intact (does not attempt to strip unknown file extensions).
+ * - **Summary:**
+ *    - `extractFileName("https://example.com/file.txt")` ➔ `"file"`.
+ *    - `extractFileName("/local/path/image.jpeg")` ➔ `"image"`.
+ *    - `extractFileName("backup.archive.tar.gz")` ➔ `"backup.archive"`.
+ *    - `extractFileName("folder/")` ➔ `""`.
+ *    - `extractFileName("")` ➔ `undefined`.
+ *    - `extractFileName("unknownfile.weirdext")` ➔ `"unknownfile.weirdext"`
+ *       ***(keeps unknown extension)***.
+ * @description
+ * This is particularly useful for displaying or logging file names
+ * without cluttering them with redundant extensions, while being careful
+ * not to accidentally truncate unfamiliar formats.
+ * @param {string | null | undefined} url - The URL, file system path, or plain file name to process.
+ * @returns {string | undefined} The file name without its extension(s),
+ *                               or `undefined` if input is invalid,
+ *                               or an empty string `""` if the path ends with `/`.
+ * @example
+ * extractFileName("document.pdf");                   // ➔ "document"
+ * extractFileName("/files/archive.tar.gz");          // ➔ "archive"
+ * extractFileName("https://cdn.site.com/video.mp4"); // ➔ "video"
+ * extractFileName("folder/");                        // ➔ ""
+ * extractFileName("strangefile.unknownext");         // ➔ "strangefile.unknownext"
+ * extractFileName("");                               // ➔ undefined
+ * extractFileName(123);                              // ➔ undefined
+ */
+declare const extractFileName:(url:string|null|undefined)=>string|undefined;export{extractFileName};

package/dist/parsers/index.js

@@ -0,0 +1 @@
+export{extractFileName}from"../chunk-YV3K2EKJ.js";import"../chunk-EW3I4O7X.js";

package/dist/predicates/index.cjs

@@ -0,0 +1 @@
+"use strict";var e=require("../chunk-OLPKAX7F.cjs"),r=require("../chunk-KHO2SBNA.cjs"),t=require("../chunk-6C3ATUGM.cjs"),n=require("../chunk-M47QIBXI.cjs"),i=require("../chunk-JARPXKBM.cjs");require("../chunk-O7UT5AN3.cjs");var u=require("../chunk-CMJ6UYWW.cjs"),o=require("../chunk-4Z75R3IT.cjs");require("../chunk-VCFXNV3Q.cjs");var s=require("../chunk-DVMHRLKP.cjs"),c=require("../chunk-ZHV5ZYVN.cjs"),p=require("../chunk-UDA26MCU.cjs"),a=require("../chunk-D3VSHABU.cjs");Object.defineProperty(exports,"areArraysEqual",{enumerable:!0,get:function(){return e.areArraysEqual}}),Object.defineProperty(exports,"areObjectsEqual",{enumerable:!0,get:function(){return e.areObjectsEqual}}),Object.defineProperty(exports,"areURLsEqualPath",{enumerable:!0,get:function(){return e.areURLsEqualPath}}),Object.defineProperty(exports,"areURLsIdentical",{enumerable:!0,get:function(){return e.areURLsIdentical}}),Object.defineProperty(exports,"arrayHasAnyMatch",{enumerable:!0,get:function(){return e.arrayHasAnyMatch}}),Object.defineProperty(exports,"doesKeyExist",{enumerable:!0,get:function(){return e.doesKeyExist}}),Object.defineProperty(exports,"isArguments",{enumerable:!0,get:function(){return e.isArguments}}),Object.defineProperty(exports,"isArrayLike",{enumerable:!0,get:function(){return e.isArrayLike}}),Object.defineProperty(exports,"isArrayLikeObject",{enumerable:!0,get:function(){return e.isArrayLikeObject}}),Object.defineProperty(exports,"isCurrencyLike",{enumerable:!0,get:function(){return e.isCurrencyLike}}),Object.defineProperty(exports,"isDeepEqual",{enumerable:!0,get:function(){return e.isDeepEqual}}),Object.defineProperty(exports,"isElement",{enumerable:!0,get:function(){return e.isElement}}),Object.defineProperty(exports,"isEmpty",{enumerable:!0,get:function(){return e.isEmpty}}),Object.defineProperty(exports,"isEmptyDeep",{enumerable:!0,get:function(){return e.isEmptyDeep}}),Object.defineProperty(exports,"isEqualWith",{enumerable:!0,get:function(){return e.isEqualWith}}),Object.defineProperty(exports,"isLength",{enumerable:!0,get:function(){return e.isLength}}),Object.defineProperty(exports,"isMatch",{enumerable:!0,get:function(){return e.isMatch}}),Object.defineProperty(exports,"isMatchWith",{enumerable:!0,get:function(){return e.isMatchWith}}),Object.defineProperty(exports,"isNative",{enumerable:!0,get:function(){return e.isNative}}),Object.defineProperty(exports,"isObjectLoose",{enumerable:!0,get:function(){return e.isObjectLoose}}),Object.defineProperty(exports,"isPropertyKey",{enumerable:!0,get:function(){return e.isPropertyKey}}),Object.defineProperty(exports,"isSafeInteger",{enumerable:!0,get:function(){return e.isSafeInteger}}),Object.defineProperty(exports,"isValidURL",{enumerable:!0,get:function(){return e.isValidURL}}),Object.defineProperty(exports,"isWeakMap",{enumerable:!0,get:function(){return e.isWeakMap}}),Object.defineProperty(exports,"textContainsAll",{enumerable:!0,get:function(){return e.textContainsAll}}),Object.defineProperty(exports,"textContainsAny",{enumerable:!0,get:function(){return e.textContainsAny}}),Object.defineProperty(exports,"isURL",{enumerable:!0,get:function(){return r.isURL}}),Object.defineProperty(exports,"isNonEmptyValue",{enumerable:!0,get:function(){return t.isNonEmptyValue}}),Object.defineProperty(exports,"isTypedArray",{enumerable:!0,get:function(){return t.isTypedArray}}),Object.defineProperty(exports,"isEmptyValue",{enumerable:!0,get:function(){return n.isEmptyValue}}),Object.defineProperty(exports,"isArrayBuffer",{enumerable:!0,get:function(){return i.isArrayBuffer}}),Object.defineProperty(exports,"isEmptyArray",{enumerable:!0,get:function(){return i.isEmptyArray}}),Object.defineProperty(exports,"isEmptyObject",{enumerable:!0,get:function(){return i.isEmptyObject}}),Object.defineProperty(exports,"isEqual",{enumerable:!0,get:function(){return i.isEqual}}),Object.defineProperty(exports,"isRegExp",{enumerable:!0,get:function(){return i.isRegExp}}),Object.defineProperty(exports,"isFinite",{enumerable:!0,get:function(){return u.isFinite}}),Object.defineProperty(exports,"isEmptyString",{enumerable:!0,get:function(){return o.isEmptyString}}),Object.defineProperty(exports,"isInteger",{enumerable:!0,get:function(){return s.isInteger}}),Object.defineProperty(exports,"isDate",{enumerable:!0,get:function(){return c.isDate}}),Object.defineProperty(exports,"isMap",{enumerable:!0,get:function(){return c.isMap}}),Object.defineProperty(exports,"isBigInt",{enumerable:!0,get:function(){return p.isBigInt}}),Object.defineProperty(exports,"getPreciseType",{enumerable:!0,get:function(){return a.getPreciseType}}),Object.defineProperty(exports,"hasOwnProp",{enumerable:!0,get:function(){return a.hasOwnProp}}),Object.defineProperty(exports,"isArray",{enumerable:!0,get:function(){return a.isArray}}),Object.defineProperty(exports,"isBoolean",{enumerable:!0,get:function(){return a.isBoolean}}),Object.defineProperty(exports,"isBuffer",{enumerable:!0,get:function(){return a.isBuffer}}),Object.defineProperty(exports,"isError",{enumerable:!0,get:function(){return a.isError}}),Object.defineProperty(exports,"isFunction",{enumerable:!0,get:function(){return a.isFunction}}),Object.defineProperty(exports,"isNaN",{enumerable:!0,get:function(){return a.isNaN}}),Object.defineProperty(exports,"isNil",{enumerable:!0,get:function(){return a.isNil}}),Object.defineProperty(exports,"isNonEmptyArray",{enumerable:!0,get:function(){return a.isNonEmptyArray}}),Object.defineProperty(exports,"isNonEmptyString",{enumerable:!0,get:function(){return a.isNonEmptyString}}),Object.defineProperty(exports,"isNull",{enumerable:!0,get:function(){return a.isNull}}),Object.defineProperty(exports,"isNumber",{enumerable:!0,get:function(){return a.isNumber}}),Object.defineProperty(exports,"isObject",{enumerable:!0,get:function(){return a.isObject}}),Object.defineProperty(exports,"isObjectOrArray",{enumerable:!0,get:function(){return a.isObjectOrArray}}),Object.defineProperty(exports,"isPlainObject",{enumerable:!0,get:function(){return a.isPlainObject}}),Object.defineProperty(exports,"isSet",{enumerable:!0,get:function(){return a.isSet}}),Object.defineProperty(exports,"isString",{enumerable:!0,get:function(){return a.isString}}),Object.defineProperty(exports,"isSymbol",{enumerable:!0,get:function(){return a.isSymbol}}),Object.defineProperty(exports,"isUndefined",{enumerable:!0,get:function(){return a.isUndefined}});