@e280/stz 0.0.0-1 → 0.0.0-3

package/package.json

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

package/s/coalesce.ts

@@ -0,0 +1,5 @@
+
+export function coalesce<A extends any[] = []>(...fns: ((...a: A) => void)[]) {
+	return (...a: A) => fns.forEach(fn => fn(...a))
+}
+

package/s/deadline.ts

@@ -1,17 +1,20 @@
 
 export class DeadlineError extends Error {
 	name = this.constructor.name
-	constructor(milliseconds: number) {
-		super(`deadline exceeded (${milliseconds.toLocaleString()} ms)`)
+	constructor(public milliseconds: number, message: string) {
+		super(`${message}, timed out in ${(milliseconds / 1000).toFixed(1)} seconds`)
 	}
 }
 
 /** 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>) {
+export function deadline<R>(milliseconds: number, message: string, fn: () => Promise<R>) {
+	if (milliseconds <= 0 || milliseconds === Infinity)
+		return fn()
+
 	return new Promise<R>((resolve, reject) => {
 
 		const id = setTimeout(
-			() => reject(new DeadlineError(milliseconds)),
+			() => reject(new DeadlineError(milliseconds, message)),
 			milliseconds,
 		)
 
@@ -21,4 +24,3 @@ export function deadline<R>(milliseconds: number, fn: () => Promise<R>) {
 			.finally(() => clearTimeout(id))
 	})
 }
-

package/s/drill.ts

@@ -0,0 +1,22 @@
+
+import {is} from "./is.js"
+
+/**
+ * return a value within an object tree, found at the given path.
+ */
+export function drill<xResult>(
+		object: {[key: string]: any},
+		path: string[],
+	): xResult {
+
+	let current: any = object
+
+	for (const key of path) {
+		current = current[key]
+		if (is.unavailable(current))
+			break
+	}
+
+	return current
+}
+

package/s/index.ts

@@ -7,10 +7,12 @@ export * from "./data/bytes.js"
 export * from "./data/hex.js"
 export * from "./data/txt.js"
 
+export * from "./coalesce.js"
 export * from "./concurrent.js"
 export * from "./deadline.js"
 export * from "./dedupe.js"
 export * from "./defer-promise.js"
+export * from "./drill.js"
 export * from "./escape-regex.js"
 export * from "./hat.js"
 export * from "./is.js"

package/s/pubsub.ts

@@ -57,12 +57,18 @@ export function xub<A extends any[] = []>() {
 }
 
 /** create a subscriber fn that can be published to */
-export function sub<A extends any[] = []>(): Sub<A> {
-	return xub<A>()[1]
+export function sub<A extends any[] = []>(listener?: Listener<A>): Sub<A> {
+	const fn = xub<A>()[1]
+	if (listener)
+		fn.sub(listener)
+	return fn
 }
 
 /** create a publisher fn that can be subscribed to */
-export function pub<A extends any[] = []>(): Pub<A> {
-	return xub<A>()[0]
+export function pub<A extends any[] = []>(listener?: Listener<A>): Pub<A> {
+	const fn = xub<A>()[0]
+	if (listener)
+		fn.sub(listener)
+	return fn
 }
 

package/x/coalesce.d.ts

@@ -0,0 +1 @@
+export declare function coalesce<A extends any[] = []>(...fns: ((...a: A) => void)[]): (...a: A) => void;

package/x/coalesce.js

@@ -0,0 +1,4 @@
+export function coalesce(...fns) {
+    return (...a) => fns.forEach(fn => fn(...a));
+}
+//# sourceMappingURL=coalesce.js.map

package/x/coalesce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coalesce.js","sourceRoot":"","sources":["../s/coalesce.ts"],"names":[],"mappings":"AACA,MAAM,UAAU,QAAQ,CAAuB,GAAG,GAA0B;IAC3E,OAAO,CAAC,GAAG,CAAI,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;AAChD,CAAC"}

package/x/deadline.d.ts

@@ -1,6 +1,7 @@
 export declare class DeadlineError extends Error {
+    milliseconds: number;
     name: string;
-    constructor(milliseconds: number);
+    constructor(milliseconds: number, message: string);
 }
 /** 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, message: string, fn: () => Promise<R>): Promise<R>;

package/x/deadline.js

@@ -1,13 +1,17 @@
 export class DeadlineError extends Error {
+    milliseconds;
     name = this.constructor.name;
-    constructor(milliseconds) {
-        super(`deadline exceeded (${milliseconds.toLocaleString()} ms)`);
+    constructor(milliseconds, message) {
+        super(`${message}, timed out in ${(milliseconds / 1000).toFixed(1)} seconds`);
+        this.milliseconds = milliseconds;
     }
 }
 /** set a deadline for a fn to do something, will reject with a `DeadlineError` if it takes too long */
-export function deadline(milliseconds, fn) {
+export function deadline(milliseconds, message, fn) {
+    if (milliseconds <= 0 || milliseconds === Infinity)
+        return fn();
     return new Promise((resolve, reject) => {
-        const id = setTimeout(() => reject(new DeadlineError(milliseconds)), milliseconds);
+        const id = setTimeout(() => reject(new DeadlineError(milliseconds, message)), milliseconds);
         fn()
             .then(resolve)
             .catch(reject)

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;IACvC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAA;IAC5B,YAAY,YAAoB;QAC/B,KAAK,CAAC,sBAAsB,YAAY,CAAC,cAAc,EAAE,MAAM,CAAC,CAAA;IACjE,CAAC;CACD;AAED,uGAAuG;AACvG,MAAM,UAAU,QAAQ,CAAI,YAAoB,EAAE,EAAoB;IACrE,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAEzC,MAAM,EAAE,GAAG,UAAU,CACpB,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,aAAa,CAAC,YAAY,CAAC,CAAC,EAC7C,YAAY,CACZ,CAAA;QAED,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,MAAM,OAAO,aAAc,SAAQ,KAAK;IAEpB;IADnB,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAA;IAC5B,YAAmB,YAAoB,EAAE,OAAe;QACvD,KAAK,CAAC,GAAG,OAAO,kBAAkB,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAA;QAD3D,iBAAY,GAAZ,YAAY,CAAQ;IAEvC,CAAC;CACD;AAED,uGAAuG;AACvG,MAAM,UAAU,QAAQ,CAAI,YAAoB,EAAE,OAAe,EAAE,EAAoB;IACtF,IAAI,YAAY,IAAI,CAAC,IAAI,YAAY,KAAK,QAAQ;QACjD,OAAO,EAAE,EAAE,CAAA;IAEZ,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAEzC,MAAM,EAAE,GAAG,UAAU,CACpB,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,aAAa,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,EACtD,YAAY,CACZ,CAAA;QAED,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"}

package/x/drill.d.ts

@@ -0,0 +1,6 @@
+/**
+ * return a value within an object tree, found at the given path.
+ */
+export declare function drill<xResult>(object: {
+    [key: string]: any;
+}, path: string[]): xResult;

package/x/drill.js

@@ -0,0 +1,14 @@
+import { is } from "./is.js";
+/**
+ * return a value within an object tree, found at the given path.
+ */
+export function drill(object, path) {
+    let current = object;
+    for (const key of path) {
+        current = current[key];
+        if (is.unavailable(current))
+            break;
+    }
+    return current;
+}
+//# sourceMappingURL=drill.js.map

package/x/drill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drill.js","sourceRoot":"","sources":["../s/drill.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,EAAE,EAAC,MAAM,SAAS,CAAA;AAE1B;;GAEG;AACH,MAAM,UAAU,KAAK,CACnB,MAA4B,EAC5B,IAAc;IAGf,IAAI,OAAO,GAAQ,MAAM,CAAA;IAEzB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACxB,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;QACtB,IAAI,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC;YAC1B,MAAK;IACP,CAAC;IAED,OAAO,OAAO,CAAA;AACf,CAAC"}

package/x/index.d.ts

@@ -5,10 +5,12 @@ export * from "./data/base64url.js";
 export * from "./data/bytes.js";
 export * from "./data/hex.js";
 export * from "./data/txt.js";
+export * from "./coalesce.js";
 export * from "./concurrent.js";
 export * from "./deadline.js";
 export * from "./dedupe.js";
 export * from "./defer-promise.js";
+export * from "./drill.js";
 export * from "./escape-regex.js";
 export * from "./hat.js";
 export * from "./is.js";

package/x/index.js

@@ -5,10 +5,12 @@ export * from "./data/base64url.js";
 export * from "./data/bytes.js";
 export * from "./data/hex.js";
 export * from "./data/txt.js";
+export * from "./coalesce.js";
 export * from "./concurrent.js";
 export * from "./deadline.js";
 export * from "./dedupe.js";
 export * from "./defer-promise.js";
+export * from "./drill.js";
 export * from "./escape-regex.js";
 export * from "./hat.js";
 export * from "./is.js";

package/x/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../s/index.ts"],"names":[],"mappings":"AACA,cAAc,yBAAyB,CAAA;AACvC,cAAc,kBAAkB,CAAA;AAChC,cAAc,kBAAkB,CAAA;AAChC,cAAc,qBAAqB,CAAA;AACnC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAE7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,YAAY,CAAA;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../s/index.ts"],"names":[],"mappings":"AACA,cAAc,yBAAyB,CAAA;AACvC,cAAc,kBAAkB,CAAA;AAChC,cAAc,kBAAkB,CAAA;AAChC,cAAc,qBAAqB,CAAA;AACnC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAE7B,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,oBAAoB,CAAA;AAClC,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA;AACjC,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,YAAY,CAAA;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA"}

package/x/pubsub.d.ts

@@ -13,6 +13,6 @@ export interface Pub<A extends any[] = []> extends Xub<A> {
 }
 export declare function xub<A extends any[] = []>(): [Pub<A>, Sub<A>];
 /** create a subscriber fn that can be published to */
-export declare function sub<A extends any[] = []>(): Sub<A>;
+export declare function sub<A extends any[] = []>(listener?: Listener<A>): Sub<A>;
 /** create a publisher fn that can be subscribed to */
-export declare function pub<A extends any[] = []>(): Pub<A>;
+export declare function pub<A extends any[] = []>(listener?: Listener<A>): Pub<A>;

package/x/pubsub.js

@@ -30,11 +30,17 @@ export function xub() {
     return [pub, sub];
 }
 /** create a subscriber fn that can be published to */
-export function sub() {
-    return xub()[1];
+export function sub(listener) {
+    const fn = xub()[1];
+    if (listener)
+        fn.sub(listener);
+    return fn;
 }
 /** create a publisher fn that can be subscribed to */
-export function pub() {
-    return xub()[0];
+export function pub(listener) {
+    const fn = xub()[0];
+    if (listener)
+        fn.sub(listener);
+    return fn;
 }
 //# sourceMappingURL=pubsub.js.map

package/x/pubsub.js.map

@@ -1 +1 @@
-{"version":3,"file":"pubsub.js","sourceRoot":"","sources":["../s/pubsub.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,YAAY,EAAC,MAAM,oBAAoB,CAAA;AAmB/C,MAAM,UAAU,GAAG;IAClB,MAAM,GAAG,GAAG,IAAI,GAAG,EAAe,CAAA;IAElC,SAAS,GAAG,CAAC,EAAe;QAC3B,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACX,OAAO,GAAG,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA,CAAC,CAAC,CAAA;IAChC,CAAC;IAED,KAAK,UAAU,GAAG,CAAC,GAAG,CAAI;QACzB,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;IAChD,CAAC;IAED,KAAK,UAAU,IAAI;QAClB,MAAM,EAAC,OAAO,EAAE,OAAO,EAAC,GAAG,YAAY,EAAK,CAAA;QAC5C,MAAM,WAAW,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE;YAChC,OAAO,CAAC,CAAC,CAAC,CAAA;YACV,WAAW,EAAE,CAAA;QACd,CAAC,CAAC,CAAA;QACF,OAAO,OAAO,CAAA;IACf,CAAC;IAED,SAAS,KAAK;QACb,GAAG,CAAC,KAAK,EAAE,CAAA;IACZ,CAAC;IAED,GAAG,CAAC,GAAG,GAAG,GAAG,CAAA;IACb,GAAG,CAAC,GAAG,GAAG,GAAG,CAAA;IACb,GAAG,CAAC,IAAI,GAAG,IAAI,CAAA;IACf,GAAG,CAAC,KAAK,GAAG,KAAK,CAAA;IAEjB,GAAG,CAAC,GAAG,GAAG,GAAG,CAAA;IACb,GAAG,CAAC,GAAG,GAAG,GAAG,CAAA;IACb,GAAG,CAAC,IAAI,GAAG,IAAI,CAAA;IACf,GAAG,CAAC,KAAK,GAAG,KAAK,CAAA;IAEjB,OAAO,CAAC,GAAG,EAAE,GAAG,CAAqB,CAAA;AACtC,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,GAAG;IAClB,OAAO,GAAG,EAAK,CAAC,CAAC,CAAC,CAAA;AACnB,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,GAAG;IAClB,OAAO,GAAG,EAAK,CAAC,CAAC,CAAC,CAAA;AACnB,CAAC"}
+{"version":3,"file":"pubsub.js","sourceRoot":"","sources":["../s/pubsub.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,YAAY,EAAC,MAAM,oBAAoB,CAAA;AAmB/C,MAAM,UAAU,GAAG;IAClB,MAAM,GAAG,GAAG,IAAI,GAAG,EAAe,CAAA;IAElC,SAAS,GAAG,CAAC,EAAe;QAC3B,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACX,OAAO,GAAG,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA,CAAC,CAAC,CAAA;IAChC,CAAC;IAED,KAAK,UAAU,GAAG,CAAC,GAAG,CAAI;QACzB,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;IAChD,CAAC;IAED,KAAK,UAAU,IAAI;QAClB,MAAM,EAAC,OAAO,EAAE,OAAO,EAAC,GAAG,YAAY,EAAK,CAAA;QAC5C,MAAM,WAAW,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE;YAChC,OAAO,CAAC,CAAC,CAAC,CAAA;YACV,WAAW,EAAE,CAAA;QACd,CAAC,CAAC,CAAA;QACF,OAAO,OAAO,CAAA;IACf,CAAC;IAED,SAAS,KAAK;QACb,GAAG,CAAC,KAAK,EAAE,CAAA;IACZ,CAAC;IAED,GAAG,CAAC,GAAG,GAAG,GAAG,CAAA;IACb,GAAG,CAAC,GAAG,GAAG,GAAG,CAAA;IACb,GAAG,CAAC,IAAI,GAAG,IAAI,CAAA;IACf,GAAG,CAAC,KAAK,GAAG,KAAK,CAAA;IAEjB,GAAG,CAAC,GAAG,GAAG,GAAG,CAAA;IACb,GAAG,CAAC,GAAG,GAAG,GAAG,CAAA;IACb,GAAG,CAAC,IAAI,GAAG,IAAI,CAAA;IACf,GAAG,CAAC,KAAK,GAAG,KAAK,CAAA;IAEjB,OAAO,CAAC,GAAG,EAAE,GAAG,CAAqB,CAAA;AACtC,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,GAAG,CAAuB,QAAsB;IAC/D,MAAM,EAAE,GAAG,GAAG,EAAK,CAAC,CAAC,CAAC,CAAA;IACtB,IAAI,QAAQ;QACX,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IACjB,OAAO,EAAE,CAAA;AACV,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,GAAG,CAAuB,QAAsB;IAC/D,MAAM,EAAE,GAAG,GAAG,EAAK,CAAC,CAAC,CAAC,CAAA;IACtB,IAAI,QAAQ;QACX,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IACjB,OAAO,EAAE,CAAA;AACV,CAAC"}