@ztimson/utils 0.11.1 → 0.11.2

package/dist/array.d.ts

@@ -0,0 +1,66 @@
+export declare function addUnique<T>(array: T[], el: T): T[];
+export declare function arrayDiff(a: any[], b: any[]): any[];
+/**
+ * Provides a shorthand for sorting arrays of complex objects by a string property
+ *
+ * @example
+ * ```ts
+ * let arr = [{a: 'Apple', b: 123}, {a: 'Carrot', b: 789}, {a: 'banana', b: 456}];
+ * arr.sort(caseInsensitiveSort('a'));
+ * ```
+ *
+ * @param {string} prop - Name of property to use, supports dot notation
+ * @returns {(a, b) => (number)} - Function to handle sort (Meant to be passed to Array.prototype.sort or used in sortFn)
+ */
+export declare function caseInsensitiveSort(prop: string): (a: any, b: any) => number;
+/**
+ * Recursively flatten nested arrays
+ *
+ * @example
+ * ```ts
+ * const arr = [
+ *     {label: null, url: '/'},
+ *     {label: 'Model Admin', url: '/model-admin'},
+ *     [
+ *       {label: 'Elements', url: '/model-admin/elements'},
+ *       {label: 'Example', url: null}
+ *     ]
+ * ];
+ *
+ * console.log(flattenArr(arr));
+ * // Output:
+ * [
+ *     {label: null, url: '/'},
+ *     {label: 'Model Admin', url: '/model-admin'},
+ *     {label: 'Elements', url: '/model-admin/elements'},
+ *     {label: 'Example', url: null}
+ * ]
+ * ```
+ *
+ * @param {any[]} arr - n-dimensional array
+ * @param {any[]} result - Internal use only -- Keeps track of recursion
+ * @returns {any[]} - Flattened array
+ */
+export declare function flattenArr(arr: any[], result?: any[]): any[];
+/**
+ * Provides a shorthand for sorting arrays of complex objects
+ *
+ * @example
+ * ```ts
+ * let arr = [{a: {b: 2}}, {a: {b: 3}}, {a: {b: 1}}];
+ * arr.sort(sortByProp('a.b'));
+ * ```
+ *
+ * @param {string} prop - Name of property to use, supports dot notation
+ * @param {boolean} reverse - Reverse the order of the sort
+ * @returns {(a, b) => (number)} - Function to handle sort (Meant to be passed to Array.prototype.sort)
+ */
+export declare function sortByProp(prop: string, reverse?: boolean): (a: any, b: any) => number;
+export declare function findByProp(prop: string, value: any): (v: any) => boolean;
+export declare function makeUnique(arr: any[]): any[];
+/**
+ * Make sure value is an array, if it isn't wrap it in one.
+ * @param {T[] | T} value Value that should be an array
+ * @returns {T[]} Value in an array
+ */
+export declare function makeArray<T>(value: T | T[]): T[];

package/dist/aset.d.ts

@@ -0,0 +1,14 @@
+export declare class ASet<T> extends Array {
+    get size(): number;
+    constructor(elements?: T[]);
+    add(el: T): void;
+    delete(el: T): void;
+    difference(set: ASet<T>): ASet<T>;
+    has(el: T): boolean;
+    intersection(set: ASet<T>): ASet<T>;
+    isDisjointFrom(set: ASet<T>): boolean;
+    isSubsetOf(set: ASet<T>): boolean;
+    isSuperset(set: ASet<T>): boolean;
+    symmetricDifference(set: ASet<T>): ASet<any>;
+    union(set: ASet<T> | Array<T>): ASet<any>;
+}

package/dist/download.d.ts

@@ -0,0 +1 @@
+export declare function download(href: any, name: string): void;

package/dist/emitter.d.ts

@@ -0,0 +1,18 @@
+export type Listener = (...args: any[]) => any;
+export type TypedEvents = {
+    [k in string | symbol]: Listener;
+} & {
+    '*': (event: string, ...args: any[]) => any;
+};
+export declare class TypedEmitter<T extends TypedEvents = TypedEvents> {
+    private static listeners;
+    private listeners;
+    static emit(event: any, ...args: any[]): void;
+    static off(event: any, listener: Listener): void;
+    static on(event: any, listener: Listener): () => void;
+    static once(event: any, listener?: Listener): Promise<any>;
+    emit<K extends keyof T>(event: K, ...args: Parameters<T[K]>): void;
+    off<K extends keyof T = string>(event: K, listener: T[K]): void;
+    on<K extends keyof T = string>(event: K, listener: T[K]): () => void;
+    once<K extends keyof T = string>(event: K, listener?: T[K]): Promise<any>;
+}

package/dist/errors.d.ts

@@ -0,0 +1,35 @@
+export declare class CustomError extends Error {
+    static code: number;
+    private _code?;
+    get code(): number;
+    set code(c: number);
+    constructor(message?: string, code?: number);
+    static from(err: Error): CustomError;
+    static instanceof(err: Error): boolean;
+    toString(): string;
+}
+export declare class BadRequestError extends CustomError {
+    static code: number;
+    constructor(message?: string);
+    static instanceof(err: Error): boolean;
+}
+export declare class UnauthorizedError extends CustomError {
+    static code: number;
+    constructor(message?: string);
+    static instanceof(err: Error): boolean;
+}
+export declare class ForbiddenError extends CustomError {
+    static code: number;
+    constructor(message?: string);
+    static instanceof(err: Error): boolean;
+}
+export declare class NotFoundError extends CustomError {
+    static code: number;
+    constructor(message?: string);
+    static instanceof(err: Error): boolean;
+}
+export declare class InternalServerError extends CustomError {
+    static code: number;
+    constructor(message?: string);
+    static instanceof(err: Error): boolean;
+}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export * from './array';
+export * from './aset';
+export * from './download';
+export * from './emitter';
+export * from './errors';
+export * from './logger';
+export * from './math';
+export * from './misc';
+export * from './objects';
+export * from './promise-progress';
+export * from './string';
+export * from './time';
+export * from './xhr';

package/dist/logger.d.ts

@@ -0,0 +1,65 @@
+import { TypedEmitter, TypedEvents } from './emitter';
+export declare const CliEffects: {
+    CLEAR: string;
+    BRIGHT: string;
+    DIM: string;
+    UNDERSCORE: string;
+    BLINK: string;
+    REVERSE: string;
+    HIDDEN: string;
+};
+export declare const CliForeground: {
+    BLACK: string;
+    RED: string;
+    GREEN: string;
+    YELLOW: string;
+    BLUE: string;
+    MAGENTA: string;
+    CYAN: string;
+    LIGHT_GREY: string;
+    GREY: string;
+    LIGHT_RED: string;
+    LIGHT_GREEN: string;
+    LIGHT_YELLOW: string;
+    LIGHT_BLUE: string;
+    LIGHT_MAGENTA: string;
+    LIGHT_CYAN: string;
+    WHITE: string;
+};
+export declare const CliBackground: {
+    BLACK: string;
+    RED: string;
+    GREEN: string;
+    YELLOW: string;
+    BLUE: string;
+    MAGENTA: string;
+    CYAN: string;
+    WHITE: string;
+    GREY: string;
+};
+export declare enum LOG_LEVEL {
+    ERROR = 0,
+    WARN = 1,
+    INFO = 2,
+    LOG = 3,
+    DEBUG = 4
+}
+export type LoggerEvents = TypedEvents & {
+    'ERROR': (...args: any[]) => any;
+    'WARN': (...args: any[]) => any;
+    'INFO': (...args: any[]) => any;
+    'LOG': (...args: any[]) => any;
+    'DEBUG': (...args: any[]) => any;
+};
+export declare class Logger extends TypedEmitter<LoggerEvents> {
+    readonly namespace?: string | undefined;
+    static LOG_LEVEL: LOG_LEVEL;
+    constructor(namespace?: string | undefined);
+    private pad;
+    private format;
+    debug(...args: string[]): void;
+    log(...args: string[]): void;
+    info(...args: string[]): void;
+    warn(...args: string[]): void;
+    error(...args: string[]): void;
+}

package/dist/math.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Convert decimal number to fraction
+ *
+ * @example
+ * ```js
+ * dec2Frac(1.25) // Outputs: "1 1/4"
+ * ```
+ *
+ * @param {number} num Number to convert
+ * @return {string} Fraction with remainder
+ */
+export declare function dec2Frac(num: number): string;
+/**
+ * Convert fraction to decimal number
+ *
+ * @example
+ * ```js
+ * fracToDec('1 1/4') // Outputs: 1.25
+ * ```
+ *
+ * @param {string} frac Fraction to convert
+ * @return {number} Faction as a decimal
+ */
+export declare function fracToDec(frac: string): number;

package/dist/misc.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Convert data into a form encoded format.
+ *
+ * @param {any} data - data to convert
+ * @returns {string} - Ecodeded form data
+ */
+export declare function formEncode(data: any): string;
+/**
+ * Get profile image from Gravatar
+ *
+ * @param {string} email Account email address
+ * @param {string} def Default image, can be a link or '404', see: https://docs.gravatar.com/general/images/
+ * @returns {string} Gravatar URL
+ */
+export declare function gravatar(email: string, def?: string): string;
+/** Parts of a URL */
+export type ParsedUrl = {
+    protocol?: string;
+    subdomain?: string;
+    domain: string;
+    host: string;
+    port?: number;
+    path?: string;
+    query?: {
+        [name: string]: string;
+    };
+    fragment?: string;
+};
+/**
+ *
+ * @param {string} url
+ * @returns {RegExpExecArray}
+ */
+export declare function urlParser(url: string): ParsedUrl;

package/dist/objects.d.ts

@@ -0,0 +1,84 @@
+/**
+ *  Removes any null values from an object in-place
+ *
+ * @example
+ * ```ts
+ * let test = {a: 0, b: false, c: null, d: 'abc'}
+ * console.log(clean(test)); // Output: {a: 0, b: false, d: 'abc'}
+ * ```
+ *
+ * @param {T} obj Object reference that will be cleaned
+ * @param undefinedOnly Ignore null values
+ * @returns {Partial<T>} Cleaned object
+ */
+export declare function clean<T>(obj: T, undefinedOnly?: boolean): Partial<T>;
+/**
+ * Create a deep copy of an object (vs. a shallow copy of references)
+ *
+ * Should be replaced by `structuredClone` once released.
+ *
+ * @param {T} value Object to copy
+ * @returns {T} Type
+ */
+export declare function deepCopy<T>(value: T): T;
+/**
+ * Get/set a property of an object using dot notation
+ *
+ * @example
+ * ```ts
+ * // Get a value
+ * const name = dotNotation<string>(person, 'firstName');
+ * const familyCarMake = dotNotation(family, 'cars[0].make');
+ * // Set a value
+ * dotNotation(family, 'cars[0].make', 'toyota');
+ * ```
+ *
+ * @type T Return type
+ * @param {Object} obj source object to search
+ * @param {string} prop property name (Dot notation & indexing allowed)
+ * @param {any} set  Set object property to value, omit to fetch value instead
+ * @return {T} property value
+ */
+export declare function dotNotation<T>(obj: any, prop: string, set: T): T;
+export declare function dotNotation<T>(obj: any, prop: string): T | undefined;
+/**
+ * Recursively flatten a nested object, while maintaining key structure.
+ *
+ * @example
+ * ```ts
+ * const car = {honda: {model: "Civic"}};
+ * console.log(flattenObj(car)); //Output {honda.model: "Civic"}
+ * ```
+ *
+ * @param obj - Object to flatten
+ * @param parent - Recursively check if key is a parent key or not
+ * @param result - Result
+ * @returns {object} - Flattened object
+ */
+export declare function flattenObj(obj: any, parent?: any, result?: any): any;
+/**
+ * Check that an object has the following values
+ *
+ * @example
+ * ```ts
+ * const test = {a: 2, b: 2};
+ * includes(test, {a: 1}); // true
+ * includes(test, {b: 1, c: 3}); // false
+ * ```
+ *
+ * @param target Object to search
+ * @param values Criteria to check against
+ * @param allowMissing Only check the keys that are available on the target
+ * @returns {boolean} Does target include all the values
+ */
+export declare function includes(target: any, values: any, allowMissing?: boolean): boolean;
+/**
+ * Deep check if two objects are equal
+ *
+ * @param {any} a - first item to compare
+ * @param {any} b - second item to compare
+ * @returns {boolean} True if they match
+ */
+export declare function isEqual(a: any, b: any): boolean;
+export declare function mixin(target: any, constructors: any[]): void;
+export declare function sanitizedJSON(obj: any, space?: number): any;

package/dist/promise-progress.d.ts

@@ -0,0 +1,9 @@
+export type ProgressCallback = (progress: number) => any;
+export declare class PromiseProgress<T> extends Promise<T> {
+    private listeners;
+    private _progress;
+    get progress(): number;
+    set progress(p: number);
+    constructor(executor: (resolve: (value: T) => any, reject: (reason: any) => void, progress: (progress: number) => any) => void);
+    onProgress(callback: ProgressCallback): this;
+}

package/dist/string.d.ts

@@ -0,0 +1,72 @@
+export declare function countChars(text: string, pattern: RegExp): number;
+export declare function createHex(length: number): string;
+export declare function formatPhoneNumber(number: string): string;
+/**
+ * Insert a string into another string at a given position
+ *
+ * @example
+ * ```
+ * console.log(insertAt('Hello world!', ' glorious', 5);
+ * // Output: Hello glorious world!
+ * ```
+ *
+ * @param {string} target - Parent string you want to modify
+ * @param {string} str - Value that will be injected to parent
+ * @param {number} index - Position to inject string at
+ * @returns {string} - New string
+ */
+export declare function insertAt(target: string, str: string, index: number): String;
+export declare function pad(text: any, length: number, char: string, start?: boolean): any;
+/**
+ * Generate a string of random characters.
+ *
+ * @example
+ * ```ts
+ * const random = randomString();
+ * const randomByte = randomString(8, "01")
+ * ```
+ *
+ * @param {number} length - length of generated string
+ * @param {string} pool - character pool to generate string from
+ * @return {string} generated string
+ */
+export declare function randomString(length: number, pool?: string): string;
+/**
+ * Generate a random string with fine control over letters, numbers & symbols
+ *
+ * @example
+ * ```ts
+ * const randomLetter = randomString(1, true);
+ * const randomChar = randomString(1, true, true, true);
+ * ```
+ *
+ * @param {number} length - length of generated string
+ * @param {boolean} letters - Add letters to pool
+ * @param {boolean} numbers - Add numbers to pool
+ * @param {boolean} symbols - Add symbols to pool
+ * @return {string} generated string
+ */
+export declare function randomStringBuilder(length: number, letters?: boolean, numbers?: boolean, symbols?: boolean): string;
+/**
+ * Find all substrings that match a given pattern.
+ *
+ * Roughly based on `String.prototype.matchAll`.
+ *
+ * @param {string} value - String to search.
+ * @param {RegExp | string} regex - Regular expression to match.
+ * @return {RegExpExecArray[]} Found matches.
+ */
+export declare function matchAll(value: string, regex: RegExp | string): RegExpExecArray[];
+/**
+ * Create MD5 hash using native javascript
+ * @param d String to hash
+ * @returns {string} Hashed string
+ */
+export declare function md5(d: string): string;
+/**
+ * Check if email is valid
+ *
+ * @param {string} email - Target
+ * @returns {boolean} - Follows format
+ */
+export declare function validateEmail(email: string): boolean;

package/dist/time.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Calculate the number of milliseconds until date/time
+ *
+ * @param {Date | number} date - Target
+ * @returns {number} - Number of milliseconds until target
+ */
+export declare function timeUntil(date: Date | number): number;
+/**
+ * Use in conjunction with `await` to pause an async script
+ *
+ * @example
+ * ```ts
+ * async () => {
+ *      ...
+ *      await sleep(1000) // Pause for 1 second
+ *	    ...
+ * }
+ * ```
+ *
+ * @param {number} ms - Time to pause for in milliseconds
+ * @returns {Promise<unknown>} - Resolves promise when it's time to resume
+ */
+export declare function sleep(ms: number): Promise<unknown>;
+export declare function formatDate(date: Date | number | string): string;

package/dist/utils.cjs

@@ -0,0 +1,2 @@
+(function(c,g){typeof exports=="object"&&typeof module<"u"?g(exports):typeof define=="function"&&define.amd?define(["exports"],g):(c=typeof globalThis<"u"?globalThis:c||self,g(c.utils={}))})(this,function(c){"use strict";var Rt=Object.defineProperty;var Tt=(c,g,A)=>g in c?Rt(c,g,{enumerable:!0,configurable:!0,writable:!0,value:A}):c[g]=A;var a=(c,g,A)=>(Tt(c,typeof g!="symbol"?g+"":g,A),A);function g(n,e=!1){if(n==null)throw new Error("Cannot clean a NULL value");return Array.isArray(n)?n=n.filter(t=>t!=null):Object.entries(n).forEach(([t,r])=>{(e&&r===void 0||!e&&r==null)&&delete n[t]}),n}function A(n){return JSON.parse(JSON.stringify(n))}function b(n,e,t){if(!(n==null||!e))return e.split(/[.[\]]/g).filter(r=>r.length).reduce((r,o,i,s)=>{if((o[0]=='"'||o[0]=="'")&&(o=o.slice(1,-1)),!(r!=null&&r.hasOwnProperty(o))){if(t==null)return;r[o]={}}return t!==void 0&&i==s.length-1?r[o]=t:r[o]},n)}function U(n,e,t={}){if(typeof n=="object"&&!Array.isArray(n)){for(const r of Object.keys(n)){const o=e?e+"."+r:r;typeof n[r]=="object"?U(n[r],o,t):t[o]=n[r]}return t}}function I(n,e,t=!1){if(n==null)return t;if(Array.isArray(e))return e.findIndex((o,i)=>!I(n[i],e[i],t))==-1;const r=typeof e;return r!=typeof n?!1:r=="object"?Object.keys(e).find(o=>!I(n[o],e[o],t))==null:r=="function"?n.toString()==e.toString():n==e}function w(n,e){const t=typeof n,r=typeof e;return t!="object"||n==null||r!="object"||e==null?t=="function"&&r=="function"?n.toString()==e.toString():n===e:Object.keys(n).length!=Object.keys(e).length?!1:Object.keys(n).every(i=>w(n[i],e[i]))}function J(n,e){e.forEach(t=>{Object.getOwnPropertyNames(t.prototype).forEach(r=>{Object.defineProperty(n.prototype,r,Object.getOwnPropertyDescriptor(t.prototype,r)||Object.create(null))})})}function V(n,e){let t=[];return JSON.parse(JSON.stringify(n,(r,o)=>{if(typeof o=="object"&&o!==null){if(t.includes(o))return;t.push(o)}return o},e))}function K(n,e){return n.indexOf(e)===-1&&n.push(e),n}function Z(n,e){return M([...n.filter(t=>!e.includes(r=>w(t,r))),...e.filter(t=>!n.includes(r=>w(t,r)))])}function Q(n){return function(e,t){const r=b(e,n),o=b(t,n);return typeof r!="string"||typeof o!="string"?1:r.toLowerCase().localeCompare(o.toLowerCase())}}function q(n,e=[]){return n.forEach(t=>Array.isArray(t)?q(t,e):e.push(t)),e}function X(n,e=!1){return function(t,r){const o=b(t,n),i=b(r,n);return typeof o=="number"&&typeof i=="number"?(e?-1:1)*(o-i):o>i?e?-1:1:o<i?e?1:-1:0}}function _(n,e){return t=>w(t[n],e)}function M(n){for(let e=n.length-1;e>=0;e--)n.slice(0,e).find(t=>w(t,n[e]))&&n.splice(e,1);return n}function tt(n){return Array.isArray(n)?n:[n]}class S extends Array{get size(){return this.length}constructor(e=[]){super(),e!=null&&e.forEach&&e.forEach(t=>this.add(t))}add(e){this.has(e)||this.push(e)}delete(e){const t=this.indexOf(e);t!=-1&&this.slice(t,1)}difference(e){return new S(this.reduce((t,r)=>(e.has(r)||t.push(r),t),[]))}has(e){return this.indexOf(e)!=-1}intersection(e){return new S(this.reduce((t,r)=>(e.has(r)&&t.push(r),t),[]))}isDisjointFrom(e){return this.intersection(e).size==0}isSubsetOf(e){return this.findIndex(t=>!e.has(t))==-1}isSuperset(e){return e.findIndex(t=>!this.has(t))==-1}symmetricDifference(e){return new S([...this.difference(e),...e.difference(this)])}union(e){return new S([...this,...e])}}function et(n,e){const t=document.createElement("a");t.href=n,t.download=e,document.body.appendChild(t),t.click(),document.body.removeChild(t)}class ${constructor(){a(this,"listeners",{})}static emit(e,...t){(this.listeners["*"]||[]).forEach(r=>r(e,...t)),(this.listeners[e.toString()]||[]).forEach(r=>r(...t))}static off(e,t){const r=e.toString();this.listeners[r]=(this.listeners[r]||[]).filter(o=>o===t)}static on(e,t){var o;const r=e.toString();return this.listeners[r]||(this.listeners[r]=[]),(o=this.listeners[r])==null||o.push(t),()=>this.off(e,t)}static once(e,t){return new Promise(r=>{const o=this.on(e,(...i)=>{r(i.length==1?i[0]:i),t&&t(...i),o()})})}emit(e,...t){(this.listeners["*"]||[]).forEach(r=>r(e,...t)),(this.listeners[e]||[]).forEach(r=>r(...t))}off(e,t){this.listeners[e]=(this.listeners[e]||[]).filter(r=>r===t)}on(e,t){var r;return this.listeners[e]||(this.listeners[e]=[]),(r=this.listeners[e])==null||r.push(t),()=>this.off(e,t)}once(e,t){return new Promise(r=>{const o=this.on(e,(...i)=>{r(i.length==1?i[0]:i),t&&t(...i),o()})})}}a($,"listeners",{});class B extends Error{constructor(t,r){super(t);a(this,"_code");r!=null&&(this._code=r)}get code(){return this._code||this.constructor.code}set code(t){this._code=t}static from(t){const r=Number(t.statusCode)??Number(t.code),o=new this(t.message||t.toString());return Object.assign(o,{stack:t.stack,...t,code:r??void 0})}static instanceof(t){return t.constructor.code!=null}toString(){return this.message||super.toString()}}a(B,"code",500);class v extends B{constructor(e="Bad Request"){super(e)}static instanceof(e){return e.constructor.code==this.code}}a(v,"code",400);class F extends B{constructor(e="Unauthorized"){super(e)}static instanceof(e){return e.constructor.code==this.code}}a(F,"code",401);class H extends B{constructor(e="Forbidden"){super(e)}static instanceof(e){return e.constructor.code==this.code}}a(H,"code",403);class Y extends B{constructor(e="Not Found"){super(e)}static instanceof(e){return e.constructor.code==this.code}}a(Y,"code",404);class W extends B{constructor(e="Internal Server Error"){super(e)}static instanceof(e){return e.constructor.code==this.code}}a(W,"code",500);const C={CLEAR:"\x1B[0m",BRIGHT:"\x1B[1m",DIM:"\x1B[2m",UNDERSCORE:"\x1B[4m",BLINK:"\x1B[5m",REVERSE:"\x1B[7m",HIDDEN:"\x1B[8m"},N={BLACK:"\x1B[30m",RED:"\x1B[31m",GREEN:"\x1B[32m",YELLOW:"\x1B[33m",BLUE:"\x1B[34m",MAGENTA:"\x1B[35m",CYAN:"\x1B[36m",LIGHT_GREY:"\x1B[37m",GREY:"\x1B[90m",LIGHT_RED:"\x1B[91m",LIGHT_GREEN:"\x1B[92m",LIGHT_YELLOW:"\x1B[93m",LIGHT_BLUE:"\x1B[94m",LIGHT_MAGENTA:"\x1B[95m",LIGHT_CYAN:"\x1B[96m",WHITE:"\x1B[97m"},nt={BLACK:"\x1B[40m",RED:"\x1B[41m",GREEN:"\x1B[42m",YELLOW:"\x1B[43m",BLUE:"\x1B[44m",MAGENTA:"\x1B[45m",CYAN:"\x1B[46m",WHITE:"\x1B[47m",GREY:"\x1B[100m"};var x=(n=>(n[n.ERROR=0]="ERROR",n[n.WARN=1]="WARN",n[n.INFO=2]="INFO",n[n.LOG=3]="LOG",n[n.DEBUG=4]="DEBUG",n))(x||{});const y=class y extends ${constructor(e){super(),this.namespace=e}pad(e,t,r,o=!1){const i=e.toString(),s=t-i.length;if(s<=0)return i;const u=Array(~~(s/r.length)).fill(r).join("");return o?i+u:u+i}format(...e){const t=new Date;return`${`${t.getFullYear()}-${t.getMonth()+1}-${t.getDate()} ${this.pad(t.getHours().toString(),2,"0")}:${this.pad(t.getMinutes().toString(),2,"0")}:${this.pad(t.getSeconds().toString(),2,"0")}.${this.pad(t.getMilliseconds().toString(),3,"0",!0)}`}${this.namespace?` [${this.namespace}]`:""} ${e.join(" ")}`}debug(...e){if(y.LOG_LEVEL<4)return;const t=this.format(...e);y.emit(4,t),console.debug(N.LIGHT_GREY+t+C.CLEAR)}log(...e){if(y.LOG_LEVEL<3)return;const t=this.format(...e);y.emit(3,t),console.log(C.CLEAR+t)}info(...e){if(y.LOG_LEVEL<2)return;const t=this.format(...e);y.emit(2,t),console.info(N.BLUE+t+C.CLEAR)}warn(...e){if(y.LOG_LEVEL<1)return;const t=this.format(...e);y.emit(1,t),console.warn(N.YELLOW+t+C.CLEAR)}error(...e){if(y.LOG_LEVEL<0)return;const t=this.format(...e);y.emit(0,t),console.error(N.RED+t+C.CLEAR)}};a(y,"LOG_LEVEL",4);let D=y;function rt(n){const e=(u,E)=>E<1e-7?u:e(E,~~(u%E)),t=n.toString().length-2;let r=Math.pow(10,t),o=n*r;const i=e(o,r);o=~~(o/i),r=~~(r/i);const s=~~(o/r);return o-=s*r,`${s?s+" ":""}${~~o}/${~~r}`}function ot(n){let e=n.split(" ");const t=e.length==2?Number(e[0]):0;return e=e.pop().split("/"),t+Number(e[0])/Number(e[1])}function it(n,e){return n.length-n.replaceAll(e,"").length}function st(n){return Array(n).fill(null).map(()=>Math.round(Math.random()*15).toString(16)).join("")}const k="abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ",P="0123456789",j="~`!@#$%^&*()_-+={[}]|\\:;\"'<,>.?/",ct=k+P+j;function ut(n){const e=/(\+?1)?.*?(\d{3}).*?(\d{3}).*?(\d{4})/g.exec(n);if(!e)throw new Error(`Number cannot be parsed: ${n}`);return`${e[1]??""} (${e[2]}) ${e[3]}-${e[4]}`.trim()}function at(n,e,t){return`${n.slice(0,t)}${e}${n.slice(t+1)}`}function lt(n,e,t,r=!0){const o=n.toString(),i=e-o.length;if(i<=0)return o;const s=Array(~~(i/t.length)).fill(t).join("");return r?s+o:o+s}function ht(n,e=ct){return Array(n).fill(null).map(()=>{const t=~~(Math.random()*e.length);return e[t]}).join("")}function ft(n,e=!1,t=!1,r=!1){if(!e&&!t&&!r)throw new Error("Must enable at least one: letters, numbers, symbols");return Array(n).fill(null).map(()=>{let o;do{const i=~~(Math.random()*3);e&&i==0?o=k[~~(Math.random()*k.length)]:t&&i==1?o=P[~~(Math.random()*P.length)]:r&&i==2&&(o=j[~~(Math.random()*j.length)])}while(!o);return o}).join("")}function dt(n,e){if(typeof e=="string"&&(e=new RegExp(e,"g")),!e.global)throw new TypeError("Regular expression must be global.");let t=[],r;for(;(r=e.exec(n))!==null;)t.push(r);return t}function z(n){var e=gt(Et(mt(yt(n),8*n.length)));return e.toLowerCase()}function gt(n){for(var e,t="0123456789ABCDEF",r="",o=0;o<n.length;o++)e=n.charCodeAt(o),r+=t.charAt(e>>>4&15)+t.charAt(15&e);return r}function yt(n){for(var e=Array(n.length>>2),t=0;t<e.length;t++)e[t]=0;for(t=0;t<8*n.length;t+=8)e[t>>5]|=(255&n.charCodeAt(t/8))<<t%32;return e}function Et(n){for(var e="",t=0;t<32*n.length;t+=8)e+=String.fromCharCode(n[t>>5]>>>t%32&255);return e}function mt(n,e){n[e>>5]|=128<<e%32,n[14+(e+64>>>9<<4)]=e;for(var t=1732584193,r=-271733879,o=-1732584194,i=271733878,s=0;s<n.length;s+=16){var u=t,E=r,T=o,O=i;r=d(r=d(r=d(r=d(r=f(r=f(r=f(r=f(r=h(r=h(r=h(r=h(r=l(r=l(r=l(r=l(r,o=l(o,i=l(i,t=l(t,r,o,i,n[s+0],7,-680876936),r,o,n[s+1],12,-389564586),t,r,n[s+2],17,606105819),i,t,n[s+3],22,-1044525330),o=l(o,i=l(i,t=l(t,r,o,i,n[s+4],7,-176418897),r,o,n[s+5],12,1200080426),t,r,n[s+6],17,-1473231341),i,t,n[s+7],22,-45705983),o=l(o,i=l(i,t=l(t,r,o,i,n[s+8],7,1770035416),r,o,n[s+9],12,-1958414417),t,r,n[s+10],17,-42063),i,t,n[s+11],22,-1990404162),o=l(o,i=l(i,t=l(t,r,o,i,n[s+12],7,1804603682),r,o,n[s+13],12,-40341101),t,r,n[s+14],17,-1502002290),i,t,n[s+15],22,1236535329),o=h(o,i=h(i,t=h(t,r,o,i,n[s+1],5,-165796510),r,o,n[s+6],9,-1069501632),t,r,n[s+11],14,643717713),i,t,n[s+0],20,-373897302),o=h(o,i=h(i,t=h(t,r,o,i,n[s+5],5,-701558691),r,o,n[s+10],9,38016083),t,r,n[s+15],14,-660478335),i,t,n[s+4],20,-405537848),o=h(o,i=h(i,t=h(t,r,o,i,n[s+9],5,568446438),r,o,n[s+14],9,-1019803690),t,r,n[s+3],14,-187363961),i,t,n[s+8],20,1163531501),o=h(o,i=h(i,t=h(t,r,o,i,n[s+13],5,-1444681467),r,o,n[s+2],9,-51403784),t,r,n[s+7],14,1735328473),i,t,n[s+12],20,-1926607734),o=f(o,i=f(i,t=f(t,r,o,i,n[s+5],4,-378558),r,o,n[s+8],11,-2022574463),t,r,n[s+11],16,1839030562),i,t,n[s+14],23,-35309556),o=f(o,i=f(i,t=f(t,r,o,i,n[s+1],4,-1530992060),r,o,n[s+4],11,1272893353),t,r,n[s+7],16,-155497632),i,t,n[s+10],23,-1094730640),o=f(o,i=f(i,t=f(t,r,o,i,n[s+13],4,681279174),r,o,n[s+0],11,-358537222),t,r,n[s+3],16,-722521979),i,t,n[s+6],23,76029189),o=f(o,i=f(i,t=f(t,r,o,i,n[s+9],4,-640364487),r,o,n[s+12],11,-421815835),t,r,n[s+15],16,530742520),i,t,n[s+2],23,-995338651),o=d(o,i=d(i,t=d(t,r,o,i,n[s+0],6,-198630844),r,o,n[s+7],10,1126891415),t,r,n[s+14],15,-1416354905),i,t,n[s+5],21,-57434055),o=d(o,i=d(i,t=d(t,r,o,i,n[s+12],6,1700485571),r,o,n[s+3],10,-1894986606),t,r,n[s+10],15,-1051523),i,t,n[s+1],21,-2054922799),o=d(o,i=d(i,t=d(t,r,o,i,n[s+8],6,1873313359),r,o,n[s+15],10,-30611744),t,r,n[s+6],15,-1560198380),i,t,n[s+13],21,1309151649),o=d(o,i=d(i,t=d(t,r,o,i,n[s+4],6,-145523070),r,o,n[s+11],10,-1120210379),t,r,n[s+2],15,718787259),i,t,n[s+9],21,-343485551),t=p(t,u),r=p(r,E),o=p(o,T),i=p(i,O)}return Array(t,r,o,i)}function R(n,e,t,r,o,i){return p(pt(p(p(e,n),p(r,i)),o),t)}function l(n,e,t,r,o,i,s){return R(e&t|~e&r,n,e,o,i,s)}function h(n,e,t,r,o,i,s){return R(e&r|t&~r,n,e,o,i,s)}function f(n,e,t,r,o,i,s){return R(e^t^r,n,e,o,i,s)}function d(n,e,t,r,o,i,s){return R(t^(e|~r),n,e,o,i,s)}function p(n,e){var t=(65535&n)+(65535&e);return(n>>16)+(e>>16)+(t>>16)<<16|65535&t}function pt(n,e){return n<<e|n>>>32-e}function At(n){return/^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+)*$/.test(n)}function Bt(n){return Object.entries(n).map(([e,t])=>encodeURIComponent(e)+"="+encodeURIComponent(t)).join("&")}function wt(n,e="mp"){return n?`https://www.gravatar.com/avatar/${z(n)}?d=${e}`:""}function St(n){const e=new RegExp("(?:(?<protocol>[\\w\\d]+)\\:\\/\\/)?(?:(?<user>.+)\\@)?(?<host>(?<domain>[^:\\/\\?#@\\n]+)(?:\\:(?<port>\\d*))?)(?<path>\\/.*?)?(?:\\?(?<query>.*?))?(?:#(?<fragment>.*?))?$","gm").exec(n),t=(e==null?void 0:e.groups)??{},r=t.domain.split(".");if(t.port!=null&&(t.port=Number(t.port)),r.length>2&&(t.domain=r.splice(-2,2).join("."),t.subdomain=r.join(".")),t.query){const o=t.query.split("&"),i={};o.forEach(s=>{const[u,E]=s.split("=");i[u]=E}),t.query=i}return t}class Ct extends Promise{constructor(t){super((r,o)=>t(i=>r(i),i=>o(i),i=>this.progress=i));a(this,"listeners",[]);a(this,"_progress",0)}get progress(){return this._progress}set progress(t){t!=this._progress&&(this._progress=t,this.listeners.forEach(r=>r(t)))}onProgress(t){return this.listeners.push(t),this}}function Ot(n){return(n instanceof Date?n.getTime():n)-new Date().getTime()}function bt(n){return new Promise(e=>setTimeout(e,n))}function Nt(n){const e=n instanceof Date?n:new Date(n);return new Intl.DateTimeFormat("en-us",{weekday:"long",month:"short",day:"numeric",hour:"numeric",minute:"numeric",hour12:!0}).format(e)}const m=class m{constructor(e={}){a(this,"interceptors",{});a(this,"headers",{});this.opts=e,this.headers=e.headers||{},e.interceptors&&e.interceptors.forEach(t=>m.addInterceptor(t))}static addInterceptor(e){const t=Object.keys(m.interceptors).length.toString();return m.interceptors[t]=e,()=>{m.interceptors[t]=null}}addInterceptor(e){const t=Object.keys(this.interceptors).length.toString();return this.interceptors[t]=e,()=>{this.interceptors[t]=null}}async request(e={}){var o,i;if(!this.opts.url&&!e.url)throw new Error("URL needs to be set");let t=((o=e.url)!=null&&o.startsWith("http")?e.url:(this.opts.url||"")+(e.url||"")).replace(/([^:]\/)\/+/g,"$1");if(e.fragment&&(t.includes("#")?t.replace(/#.*(\?|\n)/g,(s,u)=>`#${e.fragment}${u}`):t+="#"+e.fragment),e.query){const s=Array.isArray(e.query)?e.query:Object.keys(e.query).map(u=>({key:u,value:e.query[u]}));t+=(t.includes("?")?"&":"?")+s.map(u=>`${u.key}=${u.value}`).join("&")}const r=g({"Content-Type":e.body&&!(e.body instanceof FormData)?"application/json":void 0,...m.headers,...this.headers,...e.headers});return fetch(t,{headers:r,method:e.method||(e.body?"POST":"GET"),body:(i=r["Content-Type"])!=null&&i.startsWith("application/json")&&e.body?JSON.stringify(e.body):e.body}).then(async s=>{for(let O of[...Object.values(m.interceptors),...Object.values(this.interceptors)])await new Promise(L=>O(s,()=>L()));const E=await(async()=>{var O,L;return!e.skipConverting&&((O=s.headers.get("Content-Type"))!=null&&O.startsWith("application/json"))?await s.json():!e.skipConverting&&((L=s.headers.get("Content-Type"))!=null&&L.startsWith("text/plain"))?await s.text():s})();if(s.ok)return E;const T=s.statusText||(typeof E=="string"?E:null);throw T?new Error(T):E})}};a(m,"interceptors",{}),a(m,"headers",{});let G=m;c.ASet=S,c.BadRequestError=v,c.CliBackground=nt,c.CliEffects=C,c.CliForeground=N,c.CustomError=B,c.ForbiddenError=H,c.InternalServerError=W,c.LOG_LEVEL=x,c.Logger=D,c.NotFoundError=Y,c.PromiseProgress=Ct,c.TypedEmitter=$,c.UnauthorizedError=F,c.XHR=G,c.addUnique=K,c.arrayDiff=Z,c.caseInsensitiveSort=Q,c.clean=g,c.countChars=it,c.createHex=st,c.dec2Frac=rt,c.deepCopy=A,c.dotNotation=b,c.download=et,c.findByProp=_,c.flattenArr=q,c.flattenObj=U,c.formEncode=Bt,c.formatDate=Nt,c.formatPhoneNumber=ut,c.fracToDec=ot,c.gravatar=wt,c.includes=I,c.insertAt=at,c.isEqual=w,c.makeArray=tt,c.makeUnique=M,c.matchAll=dt,c.md5=z,c.mixin=J,c.pad=lt,c.randomString=ht,c.randomStringBuilder=ft,c.sanitizedJSON=V,c.sleep=bt,c.sortByProp=X,c.timeUntil=Ot,c.urlParser=St,c.validateEmail=At,Object.defineProperty(c,Symbol.toStringTag,{value:"Module"})});
+//# sourceMappingURL=utils.cjs.map