@rzl-zone/utils-js 2.1.0 → 3.0.0-beta.0

package/dist/next/index.js

@@ -1 +1,8 @@
-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 {c as c$2,d}from'../chunk-JFRL7NKU.js';import {c as c$3}from'../chunk-GECI2YBP.js';import {a}from'../chunk-NIMNTEGV.js';import {a as a$1}from'../chunk-XVB3ZZEB.js';import'../chunk-ELDDNERR.js';import {c}from'../chunk-MNGGDB2G.js';import'../chunk-5SZUSNGZ.js';import {h,E,m,c as c$1,r,p,f,k,G}from'../chunk-XCFIOTCV.js';function C(e,t){if(!h(e)||a(e))throw new TypeError(`\u274C 'generateRoute' Failed:
+- Invalid 'route' value.
+- Must be of type \`string\` and non-empty string, but received: "${E(e)}": \`${c(e)}\`.`);if(!/[\\[\]]/.test(e))return e;if(m(t,{message:({validType:o})=>`\u274C 'generateRoute' Failed cause in route "${e}":
+- Missing or invalid parameters \`${o}\` for route: "${e}", must be of type \`${o}\` mapping parameters.`}),c$1(t))throw new TypeError(`\u274C 'generateRoute' Failed cause in route "${e}":
+- Missing parameters \`plain-object\` for route: "${e}".`);let n=["?","&","#","=","/","'",'"',"(",")","+",";","%","@",":"],r$1=[],s=Array.from(e.matchAll(/\[(\w+)\]/g)).map(o=>o[1]);for(let o of s){let i=t[o];if(!h(i)){r$1.push(`- Invalid parameter: "${o}" must be of type \`string\`, but received: \`${E(i)}\`.`);continue}if(a(i)){r$1.push(`- Parameter "${o}" cannot be empty string.`);continue}let p=n.filter(g=>i.includes(g));if(/\s/.test(i)&&p.push("white-space(s)"),p.length>0){let g=p.map(a=>a==="`"?"backtick - (`)":`\`${a}\``);n.includes("white-space(s)")||n.push("white-space(s)");let c=n.map(a=>a==="`"?"backtick - (`)":`\`${a}\``);r$1.push(`- Parameter "${o}" contains invalid characters (${g.join(", ")}). These characters are not allowed because they could cause issues in URL structure. The following characters are forbidden in route parameters: (${c.join(", ")}).`);}}if(r(r$1))throw new Error(`\u274C 'generateRoute' Failed cause in route "${e}":
+${r$1.join(`
+`)}.`);return e.replace(/\[(\w+)\]/g,(o,i)=>(p(t[i])?t[i]:"").trim().replace(/^\/+|\/+$/g,"")).replace(/\/+/g,"/")}var M=(e="",t)=>{try{let p=function(c,a){return `${c.replace(/\/+$/,"")}/${a.replace(/^\/+/,"")}`};var n=p;a$1(e,{message({currentType:c,validType:a}){return `First parameter \`pathname\` must be of type \`${a}\`, but received: \`${c}\`.`}}),f(t)||(t={});let{prefix:r="/api",withOrigin:s=!0}=t;if(!k(r)&&!h(r))throw new TypeError(`Parameter \`prefix\` property of the \`options\` (second parameter) must be of type \`string\`, but received: ${E(r)}.`);G(s,{message:({currentType:c,validType:a})=>`Parameter \`withOrigin\` property of the \`options\` (second parameter) must be of type \`${a}\`, but received: \`${c}\`.`}),e=c$2(e),r=c$2(r);let o=r.endsWith("/")?r:r+"/";(e===r||e===r+"/"||e.startsWith(o))&&(e=e.slice(r.length),e=c$2(e));let i=U({suffix:r});return p(s?i:new URL(i).pathname,e).replace(/\/+$/,"")}catch(r){throw new Error("Failed to generate backend API URL in `createBeApiUrl()`, Error:"+r)}};var U=({suffix:e="/"}={})=>{a$1(e,{message({currentType:t,validType:n}){return `Parameter \`suffix\` property of the first parameter must be of type \`${n}\`, but received: \`${t}\`.`}});try{let t=process.env.NEXT_PUBLIC_BACKEND_API_URL?.trim();if(t){t=c$3(t);let s=new URL(t);!!!s.port&&process.env.NEXT_PUBLIC_PORT_BE&&(t=s.origin+d(process.env.NEXT_PUBLIC_PORT_BE,{prefixColon:!0}));}else t="http://localhost"+d(process.env.NEXT_PUBLIC_PORT_BE||"8000",{prefixColon:!0});e=c$3(e).length?c$3(e):"/";let n=new URL(t.replace(/\/+$/,"")).origin,r=e==="/"?"/":`${e.startsWith("/")?"":"/"}${e.replace(/\/+$/,"")}`;return `${n}${r}`}catch(t){throw new Error("Invalid `NEXT_PUBLIC_BACKEND_API_URL`, failed to generate from `getBeApiUrl()`, Error:"+t)}};var Z=()=>{try{let e=process.env.NEXT_PUBLIC_BASE_URL?.trim(),t=process.env.NEXT_PUBLIC_PORT_FE?.trim(),n=e||"http://localhost";n=c$3(n).replace(/\/+$/,"");let r=/:\/\/[^/]+:\d+/.test(n);!r&&t?n+=d(t,{prefixColon:!0}):!r&&!e&&(n+=":3000");let s=new URL(n);return `${s.protocol}//${s.hostname}${s.port?`:${s.port}`:""}`}catch(e){throw new Error("Invalid `NEXT_PUBLIC_BASE_URL`, failed to generate from `getBaseUrl()`, Error:"+e)}};
+export{M as createBeApiUrl,C as generateRoute,Z as getBaseUrl,U as getBeApiUrl};

package/dist/next/server/index.cjs

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

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

@@ -1,42 +1,42 @@
-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`.***
- * ---------------------------------
- *
- * * ⚠️ **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.
- *
- * @returns {string} The extracted client IP address or the full constructed URL.
- *
- * @throws {Error} If the function is used outside a Next.js server environment.
- * @throws {TypeError} If the arguments do not match the expected types.
- *
- * @example
- * // Basic usage in Next.js middleware
- * import { NextRequest } from "next/server";
- * import { getClientIpOrUrl } from "@rzl-zone/utils-js/next/server";
- *
- * export function middleware(request: NextRequest) {
- *   const clientIp = getClientIpOrUrl(request, false);
- *   console.log("Client IP:", clientIp);
- * }
- *
- * @example
- * // Get full URL
- * const url = getClientIpOrUrl(request);
- * console.log("Client full URL:", url);
- */
+* * ***Retrieves the real client IP address and constructs the full URL using headers like***
+* ***`x-forwarded-for`, `x-forwarded-proto`, and `x-forwarded-port`.***
+* ---------------------------------
+*
+* * ⚠️ **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.
+*
+* @returns {string} The extracted client IP address or the full constructed URL.
+*
+* @throws {Error} If the function is used outside a Next.js server environment.
+* @throws {TypeError} If the arguments do not match the expected types.
+*
+* @example
+* // Basic usage in Next.js middleware
+* import { NextRequest } from "next/server";
+* import { getClientIpOrUrl } from "@rzl-zone/utils-js/next/server";
+*
+* export function middleware(request: NextRequest) {
+*   const clientIp = getClientIpOrUrl(request, false);
+*   console.log("Client IP:", clientIp);
+* }
+*
+* @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};
+*
+* @default true
+*/
+includeFullUrl?:boolean)=>string;export{getClientIpOrUrl};

package/dist/next/server/index.js

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

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 chunkFSSV24W7_cjs=require('../chunk-FSSV24W7.cjs');require('../chunk-GRVZXQXL.cjs'),require('../chunk-KCQDDZJE.cjs'),require('../chunk-62HX5Z45.cjs'),require('../chunk-RV2VULM7.cjs'),require('../chunk-U5Y2FXMN.cjs'),require('../chunk-7YWAQOA4.cjs'),require('../chunk-CN53M4QZ.cjs');Object.defineProperty(exports,"findDuplicates",{enumerable:true,get:function(){return chunkFSSV24W7_cjs.a}});Object.defineProperty(exports,"omitKeys",{enumerable:true,get:function(){return chunkFSSV24W7_cjs.b}});Object.defineProperty(exports,"omitKeysDeep",{enumerable:true,get:function(){return chunkFSSV24W7_cjs.c}});Object.defineProperty(exports,"omitProps",{enumerable:true,get:function(){return chunkFSSV24W7_cjs.d}});

package/dist/operations/index.d.ts

@@ -0,0 +1,182 @@
+import{N as NumberRangeUnion}from'../NumberRangeUnion-DC-C3_Kq.js';
+/** ----------------------------------------------------------------------
+* * ***Finds duplicate values in an array by deep equality comparison.***
+* ----------------------------------------------------------------------
+*
+* - ✔ Uses `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 `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[];
+/** --------------------------------
+* * ***Creates a new object excluding specified keys.***
+* --------------------------------
+* This function creates a shallow copy of the given object
+* omitting the specified keys. It will return a new object
+* without mutating the original.
+*
+* It also validates that `keysToOmit` does not contain duplicate keys.
+*
+* Internally, it uses `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 }
+*
+* @example
+* omitKeys({ name: "John", age: 30 }, ["age"]);
+* // => { name: "John" }
+*
+* @example
+* 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;
+/** ------------------------------------------------------
+* * Recursively omits properties from an object using dot notation paths.
+* * Also removes resulting empty objects (`{}`) and arrays (`[]`),
+* * cascading upwards to remove empty parents until root if needed.
+* ------------------------------------------------------
+*
+* @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.
+*
+* @remarks
+* ⚠️ 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.
+*
+* @example
+* omitKeysDeep({ arr: [{ a: 1 }] }, ["arr.0.a"]);
+* // → {} (array becomes empty and removed)
+*
+* @example
+* omitKeysDeep({ a: { b: { c: 1 }, d: 2 }, e: 3 }, ["a.b.c"]);
+* // → { a: { d: 2 }, e: 3 }
+*
+* @example
+* omitKeysDeep({ a: [{ b: 1 }, { c: 2 }] }, ["a.0.b"]);
+* // → { a: [{ c: 2 }] }
+*
+* @example
+* omitKeysDeep({ a: [{ b: 1 }] }, ["a.0.b"]);
+* // → {} (array becomes empty and removed)
+*
+* @example
+* omitKeysDeep({ complex: [{ deep: [{ x: 1, y: 2 }] }] }, ["complex.0.deep.0.x"]);
+* // → { complex: [{ deep: [{ y: 2 }] }] }
+*
+* @example
+* omitKeysDeep({ complex: [{ deep: [{ x: 1 }] }] }, ["complex.0.deep.0.x"]);
+* // → {} (deep chain emptied and collapsed)
+*
+* @example
+* omitKeysDeep({ data: [[{ foo: 1, bar: 2 }]] }, ["data.0.0.foo"]);
+* // → { data: [[{ bar: 2 }]] }
+*
+* @example
+* omitKeysDeep({ data: [[{ foo: 1 }]] }, ["data.0.0.foo"]);
+* // → {} (nested arrays emptied completely)
+*
+* @example
+* omitKeysDeep({ x: [{ y: [{ z: 1 }, { w: 2 }] }] }, ["x.0.y.0.z"]);
+* // → { x: [{ y: [{ w: 2 }] }] }
+*
+* @example
+* omitKeysDeep({ x: [{ y: [{ z: 1 }] }] }, ["x.0.y.0.z"]);
+* // → {} (entire nested arrays removed)
+*
+* @example
+* omitKeysDeep({ p: { q: { r: 5 } }, s: 6 }, ["p.q.r"]);
+* // → { s: 6 } (`p` removed because it becomes empty)
+*
+* @example
+* omitKeysDeep({ arr: [{ a: 1, b: 2 }, { c: 3 }] }, ["arr.0.a"]);
+* // → { arr: [{ b: 2 }, { c: 3 }] }
+*
+* @example
+* omitKeysDeep({ root: [{ sub: [{ leaf: 10 }] }] }, ["root.0.sub.0.leaf"]);
+* // → {} (deep nested arrays emptied to root)
+*
+* @example
+* omitKeysDeep({ meta: { tags: ["x", "y"], count: 2 } }, ["meta.count"]);
+* // → { meta: { tags: ["x", "y"] } }
+*
+* @example
+* omitKeysDeep({ arr: [[{ a: 1 }, { b: 2 }]] }, ["arr.0.0.a"]);
+* // → { arr: [[{ b: 2 }]] }
+*
+* @example
+* omitKeysDeep({ arr: [[{ a: 1 }]] }, ["arr.0.0.a"]);
+* // → {} (double nested emptied)
+*
+* @example
+* omitKeysDeep({ nested: [{ list: [{ id: 1, val: 2 }] }] }, ["nested.0.list.0.val"]);
+* // → { nested: [{ list: [{ id: 1 }] }] }
+*
+* @example
+* omitKeysDeep({ nested: [{ list: [{ id: 1 }] }] }, ["nested.0.list.0.id"]);
+* // → {} (full collapse to empty)
+*
+* @example
+* 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>;
+/** --------------------------------
+* * Removes Property from PROPS Collection
+* --------------------------------
+* @description Becarefull put array in arrayException, If array is duplicated it will be throw an exception error
+* @param object is Record as object (string,any)
+* @param arrayExcept is Array exception []
+* @returns
+*
+* @deprecated - Use `omitKeys` instead, this function will remove a next update.
+*/
+declare const omitProps:<I extends Record<string,unknown>,S extends(keyof I)[]>(object:I,arrayExcept:S)=>Omit<I,S[number]>|undefined;export{findDuplicates,omitKeys,omitKeysDeep,omitProps};

package/dist/operations/index.js

@@ -0,0 +1 @@
+export{a as findDuplicates,b as omitKeys,c as omitKeysDeep,d as omitProps}from'../chunk-GCGU2WB7.js';import'../chunk-PVJF2JHM.js';import'../chunk-W5EDKJK3.js';import'../chunk-QFCGBBSY.js';import'../chunk-SYJC7UAW.js';import'../chunk-MNGGDB2G.js';import'../chunk-5SZUSNGZ.js';import'../chunk-XCFIOTCV.js';

package/dist/parsers/index.cjs

@@ -0,0 +1 @@
+'use strict';var chunkBYZAD3XN_cjs=require('../chunk-BYZAD3XN.cjs');require('../chunk-CN53M4QZ.cjs');Object.defineProperty(exports,"extractFileName",{enumerable:true,get:function(){return chunkBYZAD3XN_cjs.a}});

package/dist/parsers/index.d.ts

@@ -0,0 +1,37 @@
+/** ----------------------------------------------------------
+* * ***Extracts the base file name (without extension) from a given URL, file path, or file name.***
+* ----------------------------------------------------------
+*
+* - ✅ 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).
+*
+* Behavior 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)
+*
+* 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} 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)=>string|undefined;export{extractFileName};

package/dist/parsers/index.js

@@ -0,0 +1 @@
+export{a as extractFileName}from'../chunk-EXZ47NOW.js';import'../chunk-XCFIOTCV.js';

package/dist/predicates/index.cjs

@@ -0,0 +1 @@
+'use strict';var chunk7NA6DUHR_cjs=require('../chunk-7NA6DUHR.cjs'),chunkFIEZKTAZ_cjs=require('../chunk-FIEZKTAZ.cjs'),chunkD47MHBSD_cjs=require('../chunk-D47MHBSD.cjs'),chunkUUPQI6ND_cjs=require('../chunk-UUPQI6ND.cjs'),chunkKCQDDZJE_cjs=require('../chunk-KCQDDZJE.cjs');require('../chunk-JWHM3WZQ.cjs');var chunkFDITZ5C6_cjs=require('../chunk-FDITZ5C6.cjs'),chunk2TRAPBZ7_cjs=require('../chunk-2TRAPBZ7.cjs');require('../chunk-BVPMMWDL.cjs');var chunkPUQXRLZH_cjs=require('../chunk-PUQXRLZH.cjs'),chunkU5Y2FXMN_cjs=require('../chunk-U5Y2FXMN.cjs'),chunk7YWAQOA4_cjs=require('../chunk-7YWAQOA4.cjs'),chunkCN53M4QZ_cjs=require('../chunk-CN53M4QZ.cjs');Object.defineProperty(exports,"areArraysEqual",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.a}});Object.defineProperty(exports,"areObjectsEqual",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.b}});Object.defineProperty(exports,"areURLsEqualPath",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.c}});Object.defineProperty(exports,"areURLsIdentical",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.d}});Object.defineProperty(exports,"arrayHasAnyMatch",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.h}});Object.defineProperty(exports,"doesKeyExist",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.g}});Object.defineProperty(exports,"isArguments",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.i}});Object.defineProperty(exports,"isArrayLike",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.k}});Object.defineProperty(exports,"isArrayLikeObject",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.l}});Object.defineProperty(exports,"isCurrencyLike",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.m}});Object.defineProperty(exports,"isDeepEqual",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.n}});Object.defineProperty(exports,"isElement",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.o}});Object.defineProperty(exports,"isEmpty",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.p}});Object.defineProperty(exports,"isEmptyDeep",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.q}});Object.defineProperty(exports,"isEqualWith",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.r}});Object.defineProperty(exports,"isLength",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.j}});Object.defineProperty(exports,"isMatch",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.t}});Object.defineProperty(exports,"isMatchWith",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.s}});Object.defineProperty(exports,"isNative",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.u}});Object.defineProperty(exports,"isObjectLoose",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.v}});Object.defineProperty(exports,"isSafeInteger",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.w}});Object.defineProperty(exports,"isValidURL",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.x}});Object.defineProperty(exports,"isWeakMap",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.y}});Object.defineProperty(exports,"textContainsAll",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.e}});Object.defineProperty(exports,"textContainsAny",{enumerable:true,get:function(){return chunk7NA6DUHR_cjs.f}});Object.defineProperty(exports,"isURL",{enumerable:true,get:function(){return chunkFIEZKTAZ_cjs.a}});Object.defineProperty(exports,"isNonEmptyValue",{enumerable:true,get:function(){return chunkD47MHBSD_cjs.a}});Object.defineProperty(exports,"isTypedArray",{enumerable:true,get:function(){return chunkD47MHBSD_cjs.b}});Object.defineProperty(exports,"isEmptyValue",{enumerable:true,get:function(){return chunkUUPQI6ND_cjs.a}});Object.defineProperty(exports,"isArrayBuffer",{enumerable:true,get:function(){return chunkKCQDDZJE_cjs.b}});Object.defineProperty(exports,"isEmptyArray",{enumerable:true,get:function(){return chunkKCQDDZJE_cjs.e}});Object.defineProperty(exports,"isEmptyObject",{enumerable:true,get:function(){return chunkKCQDDZJE_cjs.f}});Object.defineProperty(exports,"isEqual",{enumerable:true,get:function(){return chunkKCQDDZJE_cjs.d}});Object.defineProperty(exports,"isRegExp",{enumerable:true,get:function(){return chunkKCQDDZJE_cjs.a}});Object.defineProperty(exports,"isFinite",{enumerable:true,get:function(){return chunkFDITZ5C6_cjs.a}});Object.defineProperty(exports,"isEmptyString",{enumerable:true,get:function(){return chunk2TRAPBZ7_cjs.a}});Object.defineProperty(exports,"isInteger",{enumerable:true,get:function(){return chunkPUQXRLZH_cjs.a}});Object.defineProperty(exports,"isDate",{enumerable:true,get:function(){return chunkU5Y2FXMN_cjs.b}});Object.defineProperty(exports,"isMap",{enumerable:true,get:function(){return chunkU5Y2FXMN_cjs.a}});Object.defineProperty(exports,"isBigInt",{enumerable:true,get:function(){return chunk7YWAQOA4_cjs.a}});Object.defineProperty(exports,"getPreciseType",{enumerable:true,get:function(){return chunkCN53M4QZ_cjs.E}});Object.defineProperty(exports,"hasOwnProp",{enumerable:true,get:function(){return chunkCN53M4QZ_cjs.o}});Object.defineProperty(exports,"isArray",{enumerable:true,get:function(){return chunkCN53M4QZ_cjs.d}});Object.defineProperty(exports,"isBoolean",{enumerable:true,get:function(){return chunkCN53M4QZ_cjs.a}});Object.defineProperty(exports,"isBuffer",{enumerable:true,get:function(){return chunkCN53M4QZ_cjs.C}});Object.defineProperty(exports,"isError",{enumerable:true,get:function(){return chunkCN53M4QZ_cjs.D}});Object.defineProperty(exports,"isFunction",{enumerable:true,get:function(){return chunkCN53M4QZ_cjs.b}});Object.defineProperty(exports,"isNaN",{enumerable:true,get:function(){return chunkCN53M4QZ_cjs.n}});Object.defineProperty(exports,"isNil",{enumerable:true,get:function(){return chunkCN53M4QZ_cjs.c}});Object.defineProperty(exports,"isNonEmptyArray",{enumerable:true,get:function(){return chunkCN53M4QZ_cjs.r}});Object.defineProperty(exports,"isNonEmptyString",{enumerable:true,get:function(){return chunkCN53M4QZ_cjs.p}});Object.defineProperty(exports,"isNull",{enumerable:true,get:function(){return chunkCN53M4QZ_cjs.g}});Object.defineProperty(exports,"isNumber",{enumerable:true,get:function(){return chunkCN53M4QZ_cjs.i}});Object.defineProperty(exports,"isObject",{enumerable:true,get:function(){return chunkCN53M4QZ_cjs.e}});Object.defineProperty(exports,"isObjectOrArray",{enumerable:true,get:function(){return chunkCN53M4QZ_cjs.l}});Object.defineProperty(exports,"isPlainObject",{enumerable:true,get:function(){return chunkCN53M4QZ_cjs.f}});Object.defineProperty(exports,"isSet",{enumerable:true,get:function(){return chunkCN53M4QZ_cjs.q}});Object.defineProperty(exports,"isString",{enumerable:true,get:function(){return chunkCN53M4QZ_cjs.h}});Object.defineProperty(exports,"isSymbol",{enumerable:true,get:function(){return chunkCN53M4QZ_cjs.j}});Object.defineProperty(exports,"isUndefined",{enumerable:true,get:function(){return chunkCN53M4QZ_cjs.k}});