@depthbomb/common 1.3.2 → 2.1.0

package/package.json

@@ -1,83 +1,103 @@
-{
-	"name": "@depthbomb/common",
-	"version": "1.3.2",
-	"description": "A set of common utilities for TypeScript/JavaScript",
-	"license": "MIT",
-	"engines": {
-		"node": ">=22"
-	},
-	"keywords": [
-		"typescript",
-		"utilities"
-	],
-	"exports": {
-		".": {
-			"import": "./dist/index.mjs",
-			"require": "./dist/index.cjs"
-		},
-		"./async": {
-			"import": "./dist/async.mjs",
-			"require": "./dist/async.cjs"
-		},
-		"./decorators": {
-			"import": "./dist/decorators.mjs",
-			"require": "./dist/decorators.cjs"
-		},
-		"./fn": {
-			"import": "./dist/fn.mjs",
-			"require": "./dist/fn.cjs"
-		},
-		"./lazy": {
-			"import": "./dist/lazy.mjs",
-			"require": "./dist/lazy.cjs"
-		},
-		"./queue": {
-			"import": "./dist/queue.mjs",
-			"require": "./dist/queue.cjs"
-		},
-		"./types": {
-			"import": "./dist/types.mjs",
-			"require": "./dist/types.cjs"
-		},
-		"./urllib": {
-			"import": "./dist/urllib.mjs",
-			"require": "./dist/urllib.cjs"
-		}
-	},
-	"main": "./dist/index.cjs",
-	"module": "./dist/index.mjs",
-	"types": "./dist/index.d.cts",
-	"files": [
-		"dist"
-	],
-	"sideEffects": false,
-	"publishConfig": {
-		"access": "public"
-	},
-	"repository": {
-		"type": "git",
-		"url": "git+https://github.com/depthbomb/js-common.git"
-	},
-	"bugs": {
-		"url": "https://github.com/depthbomb/js-common/issues"
-	},
-	"scripts": {
-		"build": "tsc",
-		"dist": "tsdown",
-		"release": "yarn dist && release-it",
-		"lint": "eslint ./src --ext .ts",
-		"test": "vitest"
-	},
-	"devDependencies": {
-		"@types/eslint": "^9.6.1",
-		"@types/node": "^24.10.13",
-		"@typescript-eslint/eslint-plugin": "^8.55.0",
-		"@typescript-eslint/parser": "^8.55.0",
-		"eslint": "^10.0.0",
-		"release-it": "^19.2.4",
-		"tsdown": "^0.20.3",
-		"typescript": "^5.9.3",
-		"vitest": "^4.0.18"
-	},
-	"packageManager": "yarn@4.12.0"
-}
+{
+	"name": "@depthbomb/common",
+	"version": "2.1.0",
+	"description": "A set of common utilities for TypeScript/JavaScript",
+	"license": "MIT",
+	"engines": {
+		"node": ">=22"
+	},
+	"keywords": [
+		"typescript",
+		"utilities"
+	],
+	"exports": {
+		".": {
+			"import": "./dist/index.mjs",
+			"require": "./dist/index.cjs"
+		},
+		"./collections": {
+			"import": "./dist/collections.mjs",
+			"require": "./dist/collections.cjs"
+		},
+		"./decorators": {
+			"import": "./dist/decorators.mjs",
+			"require": "./dist/decorators.cjs"
+		},
+		"./functional": {
+			"import": "./dist/functional.mjs",
+			"require": "./dist/functional.cjs"
+		},
+		"./guards": {
+			"import": "./dist/guards.mjs",
+			"require": "./dist/guards.cjs"
+		},
+		"./lazy": {
+			"import": "./dist/lazy.mjs",
+			"require": "./dist/lazy.cjs"
+		},
+		"./number": {
+			"import": "./dist/number.mjs",
+			"require": "./dist/number.cjs"
+		},
+		"./promise": {
+			"import": "./dist/promise.mjs",
+			"require": "./dist/promise.cjs"
+		},
+		"./random": {
+			"import": "./dist/random.mjs",
+			"require": "./dist/random.cjs"
+		},
+		"./state": {
+			"import": "./dist/state.mjs",
+			"require": "./dist/state.cjs"
+		},
+		"./timing": {
+			"import": "./dist/timing.mjs",
+			"require": "./dist/timing.cjs"
+		},
+		"./typing": {
+			"import": "./dist/typing.mjs",
+			"require": "./dist/typing.cjs"
+		},
+		"./url": {
+			"import": "./dist/url.mjs",
+			"require": "./dist/url.cjs"
+		}
+	},
+	"main": "./dist/index.cjs",
+	"module": "./dist/index.mjs",
+	"types": "./dist/index.d.cts",
+	"files": [
+		"dist"
+	],
+	"sideEffects": false,
+	"publishConfig": {
+		"access": "public"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/depthbomb/js-common.git"
+	},
+	"bugs": {
+		"url": "https://github.com/depthbomb/js-common/issues"
+	},
+	"scripts": {
+		"build": "tsc",
+		"dist": "tsdown",
+		"release": "yarn dist && release-it",
+		"lint": "eslint ./src --ext .ts",
+		"test": "vitest"
+	},
+	"devDependencies": {
+		"@types/eslint": "^9.6.1",
+		"@types/node": "^24.12.0",
+		"@typescript-eslint/eslint-plugin": "^8.57.2",
+		"@typescript-eslint/parser": "^8.57.2",
+		"eslint": "^10.1.0",
+		"release-it": "^19.2.4",
+		"tsdown": "^0.21.5",
+		"typescript": "^6.0.2",
+		"vitest": "^4.1.2"
+	},
+	"packageManager": "yarn@4.13.0"
+}

package/dist/async.cjs

@@ -1 +0,0 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});function e(e){return new Promise(t=>setTimeout(t,e))}function t(e){return new Promise((t,n)=>setTimeout(n,e))}async function n(t,n=100,r=5e3){let i=Date.now();for(;!await t();){if(Date.now()-i>r)throw Error(`Timeout exceeded`);await e(n)}}async function r(e,t){let n;try{return await Promise.race([e,new Promise((e,r)=>{n=setTimeout(()=>r(Error(`Operation timed out`)),t)})])}finally{n!==void 0&&clearTimeout(n)}}async function i(e){return(await Promise.allSettled(e)).filter(e=>e.status===`fulfilled`).map(e=>e.value)}async function a(e){let t=[];for(let n of e)t.push(await n());return t}exports.allSettledSuccessful=i,exports.pollUntil=n,exports.rejectionTimeout=t,exports.sequential=a,exports.timeout=e,exports.withTimeout=r;

package/dist/async.d.cts

@@ -1,44 +0,0 @@
-//#region src/async.d.ts
-/**
- * Returns a promise after the provided {@link ms} has passed
- * @param ms The number of milliseconds to wait
- */
-declare function timeout(ms: number): Promise<unknown>;
-/**
- * Rejects a promise after the provided {@link ms} has passed
- * @param ms The number of milliseconds to wait
- */
-declare function rejectionTimeout(ms: number): Promise<unknown>;
-/**
- * Polls until the provided condition is met, or the timeout is exceeded.
- *
- * @param condition A function that returns a boolean or a promise that resolves to a boolean
- * @param interval The interval in milliseconds to wait between checks
- * @param timeoutMs The maximum time in milliseconds to wait before throwing an error
- */
-declare function pollUntil(condition: () => boolean | Promise<boolean>, interval?: number, timeoutMs?: number): Promise<void>;
-/**
- * Wraps a promise with a timeout. If the promise does not resolve within the specified time, an error is thrown.
- *
- * @param promise The promise to wrap with a timeout
- * @param ms The number of milliseconds to wait before timing out
- *
- * @returns The result of the promise if it resolves before the timeout, otherwise throws an error
- */
-declare function withTimeout<T>(promise: Promise<T>, ms: number): Promise<T>;
-/**
- * Waits for all promises to settle and returns an array of successful results.
- *
- * @param promises An array of promises to wait for
- * @returns A promise that resolves to an array of successful results
- */
-declare function allSettledSuccessful<T>(promises: Promise<T>[]): Promise<T[]>;
-/**
- * Executes an array of asynchronous tasks sequentially.
- *
- * @param tasks An array of functions that return promises
- * @returns A promise that resolves to an array of results from the input tasks
- */
-declare function sequential<T>(tasks: (() => Promise<T>)[]): Promise<T[]>;
-//#endregion
-export { allSettledSuccessful, pollUntil, rejectionTimeout, sequential, timeout, withTimeout };

package/dist/async.d.mts

@@ -1,44 +0,0 @@
-//#region src/async.d.ts
-/**
- * Returns a promise after the provided {@link ms} has passed
- * @param ms The number of milliseconds to wait
- */
-declare function timeout(ms: number): Promise<unknown>;
-/**
- * Rejects a promise after the provided {@link ms} has passed
- * @param ms The number of milliseconds to wait
- */
-declare function rejectionTimeout(ms: number): Promise<unknown>;
-/**
- * Polls until the provided condition is met, or the timeout is exceeded.
- *
- * @param condition A function that returns a boolean or a promise that resolves to a boolean
- * @param interval The interval in milliseconds to wait between checks
- * @param timeoutMs The maximum time in milliseconds to wait before throwing an error
- */
-declare function pollUntil(condition: () => boolean | Promise<boolean>, interval?: number, timeoutMs?: number): Promise<void>;
-/**
- * Wraps a promise with a timeout. If the promise does not resolve within the specified time, an error is thrown.
- *
- * @param promise The promise to wrap with a timeout
- * @param ms The number of milliseconds to wait before timing out
- *
- * @returns The result of the promise if it resolves before the timeout, otherwise throws an error
- */
-declare function withTimeout<T>(promise: Promise<T>, ms: number): Promise<T>;
-/**
- * Waits for all promises to settle and returns an array of successful results.
- *
- * @param promises An array of promises to wait for
- * @returns A promise that resolves to an array of successful results
- */
-declare function allSettledSuccessful<T>(promises: Promise<T>[]): Promise<T[]>;
-/**
- * Executes an array of asynchronous tasks sequentially.
- *
- * @param tasks An array of functions that return promises
- * @returns A promise that resolves to an array of results from the input tasks
- */
-declare function sequential<T>(tasks: (() => Promise<T>)[]): Promise<T[]>;
-//#endregion
-export { allSettledSuccessful, pollUntil, rejectionTimeout, sequential, timeout, withTimeout };

package/dist/async.mjs

@@ -1 +0,0 @@
-function e(e){return new Promise(t=>setTimeout(t,e))}function t(e){return new Promise((t,n)=>setTimeout(n,e))}async function n(t,n=100,r=5e3){let i=Date.now();for(;!await t();){if(Date.now()-i>r)throw Error(`Timeout exceeded`);await e(n)}}async function r(e,t){let n;try{return await Promise.race([e,new Promise((e,r)=>{n=setTimeout(()=>r(Error(`Operation timed out`)),t)})])}finally{n!==void 0&&clearTimeout(n)}}async function i(e){return(await Promise.allSettled(e)).filter(e=>e.status===`fulfilled`).map(e=>e.value)}async function a(e){let t=[];for(let n of e)t.push(await n());return t}export{i as allSettledSuccessful,n as pollUntil,t as rejectionTimeout,a as sequential,e as timeout,r as withTimeout};

package/dist/queue.cjs

@@ -1 +0,0 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=class{items=[];head=0;constructor(e){e&&(this.items=[...e])}get size(){return this.items.length-this.head}get isEmpty(){return this.size===0}enqueue(e){this.items.push(e)}dequeue(){if(this.head>=this.items.length)return;let e=this.items[this.head++];return this.head>=64&&this.head*2>=this.items.length&&(this.items=this.items.slice(this.head),this.head=0),e}peek(){return this.items[this.head]}clear(){this.items=[],this.head=0}[Symbol.iterator](){return this.toArray()[Symbol.iterator]()}toArray(){return this.items.slice(this.head)}};exports.Queue=e;

package/dist/queue.mjs

@@ -1 +0,0 @@
-var e=class{items=[];head=0;constructor(e){e&&(this.items=[...e])}get size(){return this.items.length-this.head}get isEmpty(){return this.size===0}enqueue(e){this.items.push(e)}dequeue(){if(this.head>=this.items.length)return;let e=this.items[this.head++];return this.head>=64&&this.head*2>=this.items.length&&(this.items=this.items.slice(this.head),this.head=0),e}peek(){return this.items[this.head]}clear(){this.items=[],this.head=0}[Symbol.iterator](){return this.toArray()[Symbol.iterator]()}toArray(){return this.items.slice(this.head)}};export{e as Queue};

package/dist/types.cjs

@@ -1 +0,0 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=e=>e;function t(e){}function n(e){return Object.entries(e)}exports.assume=t,exports.cast=e,exports.typedEntries=n;

package/dist/types.d.cts

@@ -1,9 +0,0 @@
-//#region src/types.d.ts
-type Awaitable<T> = PromiseLike<T> | T;
-type Maybe<T> = T | undefined;
-type Nullable<T> = T | null;
-declare const cast: <T, U extends T>(value: U) => U;
-declare function assume<T>(value: unknown): asserts value is T;
-declare function typedEntries<T extends object>(obj: T): { [K in keyof T]: [K, T[K]] }[keyof T][];
-//#endregion
-export { Awaitable, Maybe, Nullable, assume, cast, typedEntries };

package/dist/types.d.mts

@@ -1,9 +0,0 @@
-//#region src/types.d.ts
-type Awaitable<T> = PromiseLike<T> | T;
-type Maybe<T> = T | undefined;
-type Nullable<T> = T | null;
-declare const cast: <T, U extends T>(value: U) => U;
-declare function assume<T>(value: unknown): asserts value is T;
-declare function typedEntries<T extends object>(obj: T): { [K in keyof T]: [K, T[K]] }[keyof T][];
-//#endregion
-export { Awaitable, Maybe, Nullable, assume, cast, typedEntries };

package/dist/types.mjs

@@ -1 +0,0 @@
-const e=e=>e;function t(e){}function n(e){return Object.entries(e)}export{t as assume,e as cast,n as typedEntries};

package/dist/urllib.cjs

@@ -1 +0,0 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});function e(t,n,r){if(r!=null){if(Array.isArray(r)){for(let i of r)e(t,n,i);return}if(typeof r==`object`){try{t.append(n,JSON.stringify(r))}catch{t.append(n,String(r))}return}t.append(n,String(r))}}var t=class t{#e;constructor(e,n){e instanceof t||e instanceof URL?this.#e=new URL(e.toString()):n?this.#e=new URL(e,n.toString()):this.#e=new URL(e)}get protocol(){return this.#e.protocol}get host(){return this.#e.host}get hostname(){return this.#e.hostname}get port(){return this.#e.port}get origin(){return this.#e.origin}get username(){return this.#e.username}get password(){return this.#e.password}get hash(){return this.#e.hash}get search(){return this.#e.search}get searchParams(){return new URLSearchParams(this.#e.search)}get pathname(){return this.#e.pathname}get parts(){return this.#e.pathname.split(`/`).filter(Boolean).map(decodeURIComponent)}get name(){return this.parts.at(-1)??``}get suffix(){let e=this.name,t=e.lastIndexOf(`.`);return t>=0?e.slice(t):``}get stem(){let e=this.name,t=e.lastIndexOf(`.`);return t>=0?e.slice(0,t):e}get parent(){let e=this.parts.slice(0,-1);return this.withPath(e)}joinpath(...e){let t=[...this.parts,...e.map(e=>e.replace(/^\/+|\/+$/g,``))];return this.withPath(t)}div(...e){return this.joinpath(...e)}withPath(e){let n=new URL(this.#e.toString());return n.pathname=`/`+e.map(encodeURIComponent).join(`/`),new t(n)}withQuery(n){let r=new URL(this.#e.toString());for(let[t,i]of Object.entries(n))r.searchParams.delete(t),e(r.searchParams,t,i);return new t(r)}withoutQuery(...e){let n=new URL(this.#e.toString());for(let t of e)n.searchParams.delete(t);return new t(n)}withHash(e){let n=new URL(this.#e.toString());return n.hash=e.startsWith(`#`)?e:`#${e}`,new t(n)}withoutHash(){let e=new URL(this.#e.toString());return e.hash=``,new t(e)}async fetch(e){return fetch(this.#e,e)}resolve(e){return new t(e,this)}equals(e){return this.toString()===new t(e).toString()}toURL(){return new URL(this.#e.toString())}toString(){return this.#e.toString()}valueOf(){return this.toString()}[Symbol.toPrimitive](){return this.toString()}static from(e,n){return new t(e,n)}static parse(e){return new t(e)}};exports.URLPath=t;

package/dist/urllib.mjs

@@ -1 +0,0 @@
-function e(t,n,r){if(r!=null){if(Array.isArray(r)){for(let i of r)e(t,n,i);return}if(typeof r==`object`){try{t.append(n,JSON.stringify(r))}catch{t.append(n,String(r))}return}t.append(n,String(r))}}var t=class t{#e;constructor(e,n){e instanceof t||e instanceof URL?this.#e=new URL(e.toString()):n?this.#e=new URL(e,n.toString()):this.#e=new URL(e)}get protocol(){return this.#e.protocol}get host(){return this.#e.host}get hostname(){return this.#e.hostname}get port(){return this.#e.port}get origin(){return this.#e.origin}get username(){return this.#e.username}get password(){return this.#e.password}get hash(){return this.#e.hash}get search(){return this.#e.search}get searchParams(){return new URLSearchParams(this.#e.search)}get pathname(){return this.#e.pathname}get parts(){return this.#e.pathname.split(`/`).filter(Boolean).map(decodeURIComponent)}get name(){return this.parts.at(-1)??``}get suffix(){let e=this.name,t=e.lastIndexOf(`.`);return t>=0?e.slice(t):``}get stem(){let e=this.name,t=e.lastIndexOf(`.`);return t>=0?e.slice(0,t):e}get parent(){let e=this.parts.slice(0,-1);return this.withPath(e)}joinpath(...e){let t=[...this.parts,...e.map(e=>e.replace(/^\/+|\/+$/g,``))];return this.withPath(t)}div(...e){return this.joinpath(...e)}withPath(e){let n=new URL(this.#e.toString());return n.pathname=`/`+e.map(encodeURIComponent).join(`/`),new t(n)}withQuery(n){let r=new URL(this.#e.toString());for(let[t,i]of Object.entries(n))r.searchParams.delete(t),e(r.searchParams,t,i);return new t(r)}withoutQuery(...e){let n=new URL(this.#e.toString());for(let t of e)n.searchParams.delete(t);return new t(n)}withHash(e){let n=new URL(this.#e.toString());return n.hash=e.startsWith(`#`)?e:`#${e}`,new t(n)}withoutHash(){let e=new URL(this.#e.toString());return e.hash=``,new t(e)}async fetch(e){return fetch(this.#e,e)}resolve(e){return new t(e,this)}equals(e){return this.toString()===new t(e).toString()}toURL(){return new URL(this.#e.toString())}toString(){return this.#e.toString()}valueOf(){return this.toString()}[Symbol.toPrimitive](){return this.toString()}static from(e,n){return new t(e,n)}static parse(e){return new t(e)}};export{t as URLPath};