@e280/stz 0.3.9 → 0.3.11

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@e280/stz",
-	"version": "0.3.9",
+	"version": "0.3.11",
 	"description": "everyday ts fns for everything",
 	"license": "MIT",
 	"author": "Chase Moskal <chasemoskal@gmail.com>",
@@ -22,8 +22,8 @@
 		"count": "find s -path '*/_archive' -prune -o -name '*.ts' -exec wc -l {} +"
 	},
 	"devDependencies": {
-		"@e280/science": "^0.1.11",
-		"@types/node": "^26.1.1",
+		"@e280/science": "^0.1.12",
+		"@types/node": "^26.2.0",
 		"typescript": "^7.0.2"
 	},
 	"keywords": [

package/s/deadline.ts

@@ -1,4 +1,6 @@
 
+import {is} from "./is.js"
+
 export class DeadlineError extends Error {
 	name = this.constructor.name
 	constructor(public milliseconds: number) {
@@ -6,17 +8,29 @@ export class DeadlineError extends Error {
 	}
 }
 
+async function invoke<R>(fn: Promise<R> | (() => Promise<R>)) {
+	return is.fn(fn)
+		? fn()
+		: fn
+}
+
 /** set a deadline for a fn to do something, will reject with a `DeadlineError` if it takes too long */
-export function deadline<R>(milliseconds: number, fn: () => Promise<R>) {
-	if (milliseconds <= 0 || milliseconds === Infinity)
-		return fn()
+export function deadline<R>(milliseconds: number | undefined | null, fn: Promise<R> | (() => Promise<R>)) {
+	if (milliseconds === undefined || milliseconds === null || milliseconds === Infinity)
+		return invoke(fn)
+
+	if (milliseconds < 0 || Number.isNaN(milliseconds))
+		throw new RangeError("invalid value provided as milliseconds to deadline fn")
+
+	if (milliseconds === 0)
+		return Promise.reject(new DeadlineError(milliseconds))
 
 	return new Promise<R>((resolve, reject) => {
 		const id = setTimeout(
 			() => reject(new DeadlineError(milliseconds)),
 			milliseconds,
 		)
-		fn()
+		invoke(fn)
 			.then(resolve)
 			.catch(reject)
 			.finally(() => clearTimeout(id))

package/x/deadline.d.ts

@@ -4,4 +4,4 @@ export declare class DeadlineError extends Error {
     constructor(milliseconds: number);
 }
 /** set a deadline for a fn to do something, will reject with a `DeadlineError` if it takes too long */
-export declare function deadline<R>(milliseconds: number, fn: () => Promise<R>): Promise<R>;
+export declare function deadline<R>(milliseconds: number | undefined | null, fn: Promise<R> | (() => Promise<R>)): Promise<R>;

package/x/deadline.js

@@ -1,3 +1,4 @@
+import { is } from "./is.js";
 export class DeadlineError extends Error {
     milliseconds;
     name = this.constructor.name;
@@ -6,13 +7,22 @@ export class DeadlineError extends Error {
         this.milliseconds = milliseconds;
     }
 }
+async function invoke(fn) {
+    return is.fn(fn)
+        ? fn()
+        : fn;
+}
 /** set a deadline for a fn to do something, will reject with a `DeadlineError` if it takes too long */
 export function deadline(milliseconds, fn) {
-    if (milliseconds <= 0 || milliseconds === Infinity)
-        return fn();
+    if (milliseconds === undefined || milliseconds === null || milliseconds === Infinity)
+        return invoke(fn);
+    if (milliseconds < 0 || Number.isNaN(milliseconds))
+        throw new RangeError("invalid value provided as milliseconds to deadline fn");
+    if (milliseconds === 0)
+        return Promise.reject(new DeadlineError(milliseconds));
     return new Promise((resolve, reject) => {
         const id = setTimeout(() => reject(new DeadlineError(milliseconds)), milliseconds);
-        fn()
+        invoke(fn)
             .then(resolve)
             .catch(reject)
             .finally(() => clearTimeout(id));

package/x/deadline.js.map

@@ -1 +1 @@
-{"version":3,"file":"deadline.js","sourceRoot":"","sources":["../s/deadline.ts"],"names":[],"mappings":"AACA,MAAM,OAAO,aAAc,SAAQ,KAAK;IAEpB,YAAY;IAD/B,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAA;IAC5B,YAAmB,YAAoB;QACtC,KAAK,CAAC,sBAAsB,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAA;4BADtD,YAAY;IAE/B,CAAC;CACD;AAED,uGAAuG;AACvG,MAAM,UAAU,QAAQ,CAAI,YAAoB,EAAE,EAAoB;IACrE,IAAI,YAAY,IAAI,CAAC,IAAI,YAAY,KAAK,QAAQ;QACjD,OAAO,EAAE,EAAE,CAAA;IAEZ,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACzC,MAAM,EAAE,GAAG,UAAU,CACpB,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,aAAa,CAAC,YAAY,CAAC,CAAC,EAC7C,YAAY,CACZ,CAAA;QACD,EAAE,EAAE;aACF,IAAI,CAAC,OAAO,CAAC;aACb,KAAK,CAAC,MAAM,CAAC;aACb,OAAO,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAA;IAClC,CAAC,CAAC,CAAA;AACH,CAAC"}
+{"version":3,"file":"deadline.js","sourceRoot":"","sources":["../s/deadline.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,EAAE,EAAC,MAAM,SAAS,CAAA;AAE1B,MAAM,OAAO,aAAc,SAAQ,KAAK;IAEpB,YAAY;IAD/B,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAA;IAC5B,YAAmB,YAAoB;QACtC,KAAK,CAAC,sBAAsB,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAA;4BADtD,YAAY;IAE/B,CAAC;CACD;AAED,KAAK,UAAU,MAAM,CAAI,EAAmC;IAC3D,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;QACf,CAAC,CAAC,EAAE,EAAE;QACN,CAAC,CAAC,EAAE,CAAA;AACN,CAAC;AAED,uGAAuG;AACvG,MAAM,UAAU,QAAQ,CAAI,YAAuC,EAAE,EAAmC;IACvG,IAAI,YAAY,KAAK,SAAS,IAAI,YAAY,KAAK,IAAI,IAAI,YAAY,KAAK,QAAQ;QACnF,OAAO,MAAM,CAAC,EAAE,CAAC,CAAA;IAElB,IAAI,YAAY,GAAG,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC;QACjD,MAAM,IAAI,UAAU,CAAC,uDAAuD,CAAC,CAAA;IAE9E,IAAI,YAAY,KAAK,CAAC;QACrB,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,aAAa,CAAC,YAAY,CAAC,CAAC,CAAA;IAEvD,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACzC,MAAM,EAAE,GAAG,UAAU,CACpB,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,aAAa,CAAC,YAAY,CAAC,CAAC,EAC7C,YAAY,CACZ,CAAA;QACD,MAAM,CAAC,EAAE,CAAC;aACR,IAAI,CAAC,OAAO,CAAC;aACb,KAAK,CAAC,MAAM,CAAC;aACb,OAAO,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAA;IAClC,CAAC,CAAC,CAAA;AACH,CAAC"}