@e280/stz 0.3.10 → 0.3.12

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@e280/stz",
-	"version": "0.3.10",
+	"version": "0.3.12",
 	"description": "everyday ts fns for everything",
 	"license": "MIT",
 	"author": "Chase Moskal <chasemoskal@gmail.com>",

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/s/utensils/map.ts

@@ -1,5 +1,5 @@
 
-type MapLike<K, V> = {
+export type MapLike<K, V> = {
 	has(key: K): boolean
 	get(key: K): V | undefined
 	set(key: K, value: V): unknown
@@ -26,9 +26,12 @@ export function guarantee<K, V>(map: MapLike<K, V>, key: K, make: () => V) {
 	}
 }
 
-export function inserts<K, V, M extends Pick<MapLike<K, V>, "set">>(map: M, entries: Iterable<[K, V]>) {
+export function setEntries<K, V, M extends Pick<MapLike<K, V>, "set">>(map: M, entries: Iterable<[K, V]>) {
 	for (const [key, value] of entries)
 		map.set(key, value)
 	return map
 }
 
+/** @deprecated renamed to `setEntries` */
+export const inserts = setEntries
+

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"}

package/x/utensils/map.d.ts

@@ -1,9 +1,10 @@
-type MapLike<K, V> = {
+export type MapLike<K, V> = {
     has(key: K): boolean;
     get(key: K): V | undefined;
     set(key: K, value: V): unknown;
 };
 export declare function need<K, V>(map: Pick<MapLike<K, V>, "has" | "get">, key: K, err?: string): V;
 export declare function guarantee<K, V>(map: MapLike<K, V>, key: K, make: () => V): V;
-export declare function inserts<K, V, M extends Pick<MapLike<K, V>, "set">>(map: M, entries: Iterable<[K, V]>): M;
-export {};
+export declare function setEntries<K, V, M extends Pick<MapLike<K, V>, "set">>(map: M, entries: Iterable<[K, V]>): M;
+/** @deprecated renamed to `setEntries` */
+export declare const inserts: typeof setEntries;

package/x/utensils/map.js

@@ -13,9 +13,11 @@ export function guarantee(map, key, make) {
         return value;
     }
 }
-export function inserts(map, entries) {
+export function setEntries(map, entries) {
     for (const [key, value] of entries)
         map.set(key, value);
     return map;
 }
+/** @deprecated renamed to `setEntries` */
+export const inserts = setEntries;
 //# sourceMappingURL=map.js.map

package/x/utensils/map.js.map

@@ -1 +1 @@
-{"version":3,"file":"map.js","sourceRoot":"","sources":["../../s/utensils/map.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,IAAI,CAClB,GAAuC,EACvC,GAAM,EACN,GAAG,GAAG,CAAC,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,yBAAyB,GAAG,GAAG,CAAC,CAAC,CAAC,sBAAsB,CAAC;IAE3F,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC;QACf,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,CAAM,CAAA;;QAExB,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,CAAA;AACtB,CAAC;AAED,MAAM,UAAU,SAAS,CAAO,GAAkB,EAAE,GAAM,EAAE,IAAa;IACxE,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC;QACf,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,CAAE,CAAA;SAChB,CAAC;QACL,MAAM,KAAK,GAAG,IAAI,EAAE,CAAA;QACpB,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QACnB,OAAO,KAAK,CAAA;IACb,CAAC;AACF,CAAC;AAED,MAAM,UAAU,OAAO,CAA6C,GAAM,EAAE,OAAyB;IACpG,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,OAAO;QACjC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IACpB,OAAO,GAAG,CAAA;AACX,CAAC"}
+{"version":3,"file":"map.js","sourceRoot":"","sources":["../../s/utensils/map.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,IAAI,CAClB,GAAuC,EACvC,GAAM,EACN,GAAG,GAAG,CAAC,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,yBAAyB,GAAG,GAAG,CAAC,CAAC,CAAC,sBAAsB,CAAC;IAE3F,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC;QACf,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,CAAM,CAAA;;QAExB,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,CAAA;AACtB,CAAC;AAED,MAAM,UAAU,SAAS,CAAO,GAAkB,EAAE,GAAM,EAAE,IAAa;IACxE,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC;QACf,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,CAAE,CAAA;SAChB,CAAC;QACL,MAAM,KAAK,GAAG,IAAI,EAAE,CAAA;QACpB,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QACnB,OAAO,KAAK,CAAA;IACb,CAAC;AACF,CAAC;AAED,MAAM,UAAU,UAAU,CAA6C,GAAM,EAAE,OAAyB;IACvG,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,OAAO;QACjC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IACpB,OAAO,GAAG,CAAA;AACX,CAAC;AAED,0CAA0C;AAC1C,MAAM,CAAC,MAAM,OAAO,GAAG,UAAU,CAAA"}