@e280/stz 0.3.3 → 0.3.5

package/package.json

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

package/s/data/bytes.ts

@@ -10,5 +10,20 @@ export const bytes = Object.freeze({
 	random(count: number) {
 		return crypto.getRandomValues(new Uint8Array(count))
 	},
+
+	concat(parts: Uint8Array[]) {
+		let size = 0
+		for (const part of parts) size += part.byteLength
+
+		const bytes = new Uint8Array(size)
+
+		let offset = 0
+		for (const part of parts) {
+			bytes.set(part, offset)
+			offset += part.byteLength
+		}
+
+		return bytes as Uint8Array
+	},
 })
 

package/s/index.ts

@@ -13,6 +13,7 @@ export * from "./debounce/types.js"
 export * from "./deep/index.js"
 export * from "./dig/dig.js"
 
+export * from "./queue/lane.js"
 export * from "./queue/queue.js"
 export * from "./rand/index.js"
 

package/s/queue/lane.ts

@@ -0,0 +1,10 @@
+
+import {queue} from "./queue.js"
+
+/** create a serialized execution lane for arbitrary async functions. */
+export function lane(limit = Infinity) {
+	return queue((fn: () => Promise<unknown>) => fn(), limit) as (
+		<R>(fn: () => Promise<R>) => Promise<R>
+	)
+}
+

package/s/queue/queue.test.ts

@@ -1,11 +1,11 @@
 
-import {Science, expect} from "@e280/science"
+import {suite, test, expect} from "@e280/science"
 
 import {nap} from "../nap.js"
 import {queue} from "./queue.js"
 
-export default Science.suite({
-	"job runs": Science.test(async() => {
+export default suite({
+	"job runs": test(async() => {
 		let concurrent = 0
 		const job = queue(async() => {
 			concurrent++
@@ -19,7 +19,7 @@ export default Science.suite({
 		expect(concurrent).is(0)
 	}),
 
-	"sequencing is enforced": Science.test(async() => {
+	"sequencing is enforced": test(async() => {
 		let concurrent = 0
 		const job = queue(async() => {
 			concurrent++
@@ -41,7 +41,7 @@ export default Science.suite({
 		expect(concurrent).is(0)
 	}),
 
-	"params and return values seem to work": Science.test(async() => {
+	"params and return values seem to work": test(async() => {
 		const add = queue(async(a: number, b: number) => {
 			await nap(100)
 			return a + b
@@ -52,7 +52,7 @@ export default Science.suite({
 		expect(await promise2).is(30)
 	}),
 
-	"first job throws, second job unaffected": Science.test(async() => {
+	"first job throws, second job unaffected": test(async() => {
 		let run = 0
 		const job = queue(async() => {
 			run++
@@ -63,5 +63,16 @@ export default Science.suite({
 		expect(async() => job()).throwsAsync()
 		expect(async() => job()).not.throwsAsync()
 	}),
+
+	"limit exceeded": test(async() => {
+		const job = queue(async() => nap(10), 2)
+		await expect(
+			async() => await Promise.all([
+				job(),
+				job(),
+				job(),
+			])
+		).throwsAsync()
+	}),
 })
 

package/s/queue/queue.ts

@@ -1,15 +1,24 @@
 
-/**
- * create a job queue that ensures the given fn is always called in sequence (not concurrently).
- */
+/** create a job queue that ensures the given fn is always called in sequence (not concurrently). */
 export function queue<Args extends any[], Result>(
-		fn: (...args: Args) => Promise<Result>
+		fn: (...args: Args) => Promise<Result>,
+		limit = Infinity,
 	): (...args: Args) => Promise<Result> {
 
+	let pending = 0
 	let last: Promise<any> = Promise.resolve()
 
 	return (...args: Args): Promise<Result> => {
-		const job = () => fn(...args)
+		if (pending >= limit)
+			return Promise.reject(new Error(`queue limit exceeded (${limit})`))
+
+		pending++
+
+		const job = async() => {
+			try { return await fn(...args) }
+			finally { pending-- }
+		}
+
 		const current = last.then(job)
 
 		// prevent unhandled rejection breaking the chain

package/s/utensils/map.ts

@@ -5,7 +5,11 @@ type MapLike<K, V> = {
 	set(key: K, value: V): unknown
 }
 
-export function need<K, V>(map: Pick<MapLike<K, V>, "has" | "get">, key: K, err = "need failed") {
+export function need<K, V>(
+		map: Pick<MapLike<K, V>, "has" | "get">,
+		key: K,
+		err = (typeof key === "string" ? `needed key not found "${key}"` : "needed key not found"),
+	) {
 	if (map.has(key))
 		return map.get(key) as V
 	else

package/x/data/bytes.d.ts

@@ -1,4 +1,5 @@
 export declare const bytes: Readonly<{
     eq(a: Uint8Array, b: Uint8Array): boolean;
     random(count: number): Uint8Array<ArrayBuffer>;
+    concat(parts: Uint8Array[]): Uint8Array;
 }>;

package/x/data/bytes.js

@@ -10,5 +10,17 @@ export const bytes = Object.freeze({
     random(count) {
         return crypto.getRandomValues(new Uint8Array(count));
     },
+    concat(parts) {
+        let size = 0;
+        for (const part of parts)
+            size += part.byteLength;
+        const bytes = new Uint8Array(size);
+        let offset = 0;
+        for (const part of parts) {
+            bytes.set(part, offset);
+            offset += part.byteLength;
+        }
+        return bytes;
+    },
 });
 //# sourceMappingURL=bytes.js.map

package/x/data/bytes.js.map

@@ -1 +1 @@
-{"version":3,"file":"bytes.js","sourceRoot":"","sources":["../../s/data/bytes.ts"],"names":[],"mappings":"AACA,MAAM,CAAC,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC;IAClC,EAAE,CAAC,CAAa,EAAE,CAAa;QAC9B,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;YAAE,OAAO,KAAK,CAAA;QACvC,IAAI,IAAI,GAAG,CAAC,CAAA;QACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE;YAAE,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;QACtD,OAAO,IAAI,KAAK,CAAC,CAAA;IAClB,CAAC;IAED,MAAM,CAAC,KAAa;QACnB,OAAO,MAAM,CAAC,eAAe,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,CAAA;IACrD,CAAC;CACD,CAAC,CAAA"}
+{"version":3,"file":"bytes.js","sourceRoot":"","sources":["../../s/data/bytes.ts"],"names":[],"mappings":"AACA,MAAM,CAAC,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC;IAClC,EAAE,CAAC,CAAa,EAAE,CAAa;QAC9B,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;YAAE,OAAO,KAAK,CAAA;QACvC,IAAI,IAAI,GAAG,CAAC,CAAA;QACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE;YAAE,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;QACtD,OAAO,IAAI,KAAK,CAAC,CAAA;IAClB,CAAC;IAED,MAAM,CAAC,KAAa;QACnB,OAAO,MAAM,CAAC,eAAe,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,CAAA;IACrD,CAAC;IAED,MAAM,CAAC,KAAmB;QACzB,IAAI,IAAI,GAAG,CAAC,CAAA;QACZ,KAAK,MAAM,IAAI,IAAI,KAAK;YAAE,IAAI,IAAI,IAAI,CAAC,UAAU,CAAA;QAEjD,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,CAAA;QAElC,IAAI,MAAM,GAAG,CAAC,CAAA;QACd,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YAC1B,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;YACvB,MAAM,IAAI,IAAI,CAAC,UAAU,CAAA;QAC1B,CAAC;QAED,OAAO,KAAmB,CAAA;IAC3B,CAAC;CACD,CAAC,CAAA"}

package/x/index.d.ts

@@ -9,6 +9,7 @@ export * from "./debounce/microbounce.js";
 export * from "./debounce/types.js";
 export * from "./deep/index.js";
 export * from "./dig/dig.js";
+export * from "./queue/lane.js";
 export * from "./queue/queue.js";
 export * from "./rand/index.js";
 export * from "./ok/index.js";

package/x/index.js

@@ -9,6 +9,7 @@ export * from "./debounce/microbounce.js";
 export * from "./debounce/types.js";
 export * from "./deep/index.js";
 export * from "./dig/dig.js";
+export * from "./queue/lane.js";
 export * from "./queue/queue.js";
 export * from "./rand/index.js";
 export * from "./ok/index.js";

package/x/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../s/index.ts"],"names":[],"mappings":"AACA,cAAc,6BAA6B,CAAA;AAC3C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,yBAAyB,CAAA;AACvC,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAE7B,cAAc,wBAAwB,CAAA;AACtC,cAAc,2BAA2B,CAAA;AACzC,cAAc,qBAAqB,CAAA;AAEnC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAE5B,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAE/B,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAEhC,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AAEjC,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA;AAChC,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,qBAAqB,CAAA;AACnC,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,SAAS,CAAA;AACvB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../s/index.ts"],"names":[],"mappings":"AACA,cAAc,6BAA6B,CAAA;AAC3C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,yBAAyB,CAAA;AACvC,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAE7B,cAAc,wBAAwB,CAAA;AACtC,cAAc,2BAA2B,CAAA;AACzC,cAAc,qBAAqB,CAAA;AAEnC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAE5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAE/B,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAEhC,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AAEjC,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA;AAChC,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,qBAAqB,CAAA;AACnC,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,SAAS,CAAA;AACvB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA"}

package/x/queue/lane.d.ts

@@ -0,0 +1,2 @@
+/** create a serialized execution lane for arbitrary async functions. */
+export declare function lane(limit?: number): (<R>(fn: () => Promise<R>) => Promise<R>);

package/x/queue/lane.js

@@ -0,0 +1,6 @@
+import { queue } from "./queue.js";
+/** create a serialized execution lane for arbitrary async functions. */
+export function lane(limit = Infinity) {
+    return queue((fn) => fn(), limit);
+}
+//# sourceMappingURL=lane.js.map

package/x/queue/lane.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lane.js","sourceRoot":"","sources":["../../s/queue/lane.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,KAAK,EAAC,MAAM,YAAY,CAAA;AAEhC,wEAAwE;AACxE,MAAM,UAAU,IAAI,CAAC,KAAK,GAAG,QAAQ;IACpC,OAAO,KAAK,CAAC,CAAC,EAA0B,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,CAEvD,CAAA;AACF,CAAC"}

package/x/queue/queue.d.ts

@@ -1,4 +1,2 @@
-/**
- * create a job queue that ensures the given fn is always called in sequence (not concurrently).
- */
-export declare function queue<Args extends any[], Result>(fn: (...args: Args) => Promise<Result>): (...args: Args) => Promise<Result>;
+/** create a job queue that ensures the given fn is always called in sequence (not concurrently). */
+export declare function queue<Args extends any[], Result>(fn: (...args: Args) => Promise<Result>, limit?: number): (...args: Args) => Promise<Result>;

package/x/queue/queue.js

@@ -1,10 +1,19 @@
-/**
- * create a job queue that ensures the given fn is always called in sequence (not concurrently).
- */
-export function queue(fn) {
+/** create a job queue that ensures the given fn is always called in sequence (not concurrently). */
+export function queue(fn, limit = Infinity) {
+    let pending = 0;
     let last = Promise.resolve();
     return (...args) => {
-        const job = () => fn(...args);
+        if (pending >= limit)
+            return Promise.reject(new Error(`queue limit exceeded (${limit})`));
+        pending++;
+        const job = async () => {
+            try {
+                return await fn(...args);
+            }
+            finally {
+                pending--;
+            }
+        };
         const current = last.then(job);
         // prevent unhandled rejection breaking the chain
         last = current.catch(() => { });

package/x/queue/queue.js.map

@@ -1 +1 @@
-{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../s/queue/queue.ts"],"names":[],"mappings":"AACA;;GAEG;AACH,MAAM,UAAU,KAAK,CACnB,EAAsC;IAGvC,IAAI,IAAI,GAAiB,OAAO,CAAC,OAAO,EAAE,CAAA;IAE1C,OAAO,CAAC,GAAG,IAAU,EAAmB,EAAE;QACzC,MAAM,GAAG,GAAG,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAA;QAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAE9B,iDAAiD;QACjD,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;QAE9B,OAAO,OAAO,CAAA;IACf,CAAC,CAAA;AACF,CAAC"}
+{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../s/queue/queue.ts"],"names":[],"mappings":"AACA,oGAAoG;AACpG,MAAM,UAAU,KAAK,CACnB,EAAsC,EACtC,KAAK,GAAG,QAAQ;IAGjB,IAAI,OAAO,GAAG,CAAC,CAAA;IACf,IAAI,IAAI,GAAiB,OAAO,CAAC,OAAO,EAAE,CAAA;IAE1C,OAAO,CAAC,GAAG,IAAU,EAAmB,EAAE;QACzC,IAAI,OAAO,IAAI,KAAK;YACnB,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,yBAAyB,KAAK,GAAG,CAAC,CAAC,CAAA;QAEpE,OAAO,EAAE,CAAA;QAET,MAAM,GAAG,GAAG,KAAK,IAAG,EAAE;YACrB,IAAI,CAAC;gBAAC,OAAO,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,CAAA;YAAC,CAAC;oBACxB,CAAC;gBAAC,OAAO,EAAE,CAAA;YAAC,CAAC;QACtB,CAAC,CAAA;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAE9B,iDAAiD;QACjD,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;QAE9B,OAAO,OAAO,CAAA;IACf,CAAC,CAAA;AACF,CAAC"}

package/x/queue/queue.test.d.ts

@@ -1,8 +1,8 @@
-import { Science } from "@e280/science";
 declare const _default: {
-    "job runs": Science.Test;
-    "sequencing is enforced": Science.Test;
-    "params and return values seem to work": Science.Test;
-    "first job throws, second job unaffected": Science.Test;
+    "job runs": import("@e280/science").Test;
+    "sequencing is enforced": import("@e280/science").Test;
+    "params and return values seem to work": import("@e280/science").Test;
+    "first job throws, second job unaffected": import("@e280/science").Test;
+    "limit exceeded": import("@e280/science").Test;
 };
 export default _default;

package/x/queue/queue.test.js

@@ -1,8 +1,8 @@
-import { Science, expect } from "@e280/science";
+import { suite, test, expect } from "@e280/science";
 import { nap } from "../nap.js";
 import { queue } from "./queue.js";
-export default Science.suite({
-    "job runs": Science.test(async () => {
+export default suite({
+    "job runs": test(async () => {
         let concurrent = 0;
         const job = queue(async () => {
             concurrent++;
@@ -15,7 +15,7 @@ export default Science.suite({
         await promise1;
         expect(concurrent).is(0);
     }),
-    "sequencing is enforced": Science.test(async () => {
+    "sequencing is enforced": test(async () => {
         let concurrent = 0;
         const job = queue(async () => {
             concurrent++;
@@ -32,7 +32,7 @@ export default Science.suite({
         await promise2;
         expect(concurrent).is(0);
     }),
-    "params and return values seem to work": Science.test(async () => {
+    "params and return values seem to work": test(async () => {
         const add = queue(async (a, b) => {
             await nap(100);
             return a + b;
@@ -42,7 +42,7 @@ export default Science.suite({
         expect(await promise1).is(3);
         expect(await promise2).is(30);
     }),
-    "first job throws, second job unaffected": Science.test(async () => {
+    "first job throws, second job unaffected": test(async () => {
         let run = 0;
         const job = queue(async () => {
             run++;
@@ -53,5 +53,13 @@ export default Science.suite({
         expect(async () => job()).throwsAsync();
         expect(async () => job()).not.throwsAsync();
     }),
+    "limit exceeded": test(async () => {
+        const job = queue(async () => nap(10), 2);
+        await expect(async () => await Promise.all([
+            job(),
+            job(),
+            job(),
+        ])).throwsAsync();
+    }),
 });
 //# sourceMappingURL=queue.test.js.map

package/x/queue/queue.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"queue.test.js","sourceRoot":"","sources":["../../s/queue/queue.test.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,OAAO,EAAE,MAAM,EAAC,MAAM,eAAe,CAAA;AAE7C,OAAO,EAAC,GAAG,EAAC,MAAM,WAAW,CAAA;AAC7B,OAAO,EAAC,KAAK,EAAC,MAAM,YAAY,CAAA;AAEhC,eAAe,OAAO,CAAC,KAAK,CAAC;IAC5B,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,IAAG,EAAE;QAClC,IAAI,UAAU,GAAG,CAAC,CAAA;QAClB,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,IAAG,EAAE;YAC3B,UAAU,EAAE,CAAA;YACZ,MAAM,GAAG,CAAC,GAAG,CAAC,CAAA;YACd,UAAU,EAAE,CAAA;QACb,CAAC,CAAC,CAAA;QACF,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAA;QACtB,MAAM,GAAG,CAAC,EAAE,CAAC,CAAA;QACb,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;QACxB,MAAM,QAAQ,CAAA;QACd,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IACzB,CAAC,CAAC;IAEF,wBAAwB,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,IAAG,EAAE;QAChD,IAAI,UAAU,GAAG,CAAC,CAAA;QAClB,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,IAAG,EAAE;YAC3B,UAAU,EAAE,CAAA;YACZ,MAAM,GAAG,CAAC,GAAG,CAAC,CAAA;YACd,UAAU,EAAE,CAAA;QACb,CAAC,CAAC,CAAA;QAEF,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAA;QACtB,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAA;QAEtB,MAAM,GAAG,CAAC,EAAE,CAAC,CAAA;QACb,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;QAExB,MAAM,QAAQ,CAAA;QACd,MAAM,GAAG,CAAC,EAAE,CAAC,CAAA;QACb,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;QAExB,MAAM,QAAQ,CAAA;QACd,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IACzB,CAAC,CAAC;IAEF,uCAAuC,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,IAAG,EAAE;QAC/D,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,EAAC,CAAS,EAAE,CAAS,EAAE,EAAE;YAC/C,MAAM,GAAG,CAAC,GAAG,CAAC,CAAA;YACd,OAAO,CAAC,GAAG,CAAC,CAAA;QACb,CAAC,CAAC,CAAA;QACF,MAAM,QAAQ,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QAC1B,MAAM,QAAQ,GAAG,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;QAC5B,MAAM,CAAC,MAAM,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;QAC5B,MAAM,CAAC,MAAM,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;IAC9B,CAAC,CAAC;IAEF,yCAAyC,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,IAAG,EAAE;QACjE,IAAI,GAAG,GAAG,CAAC,CAAA;QACX,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,IAAG,EAAE;YAC3B,GAAG,EAAE,CAAA;YACL,MAAM,GAAG,CAAC,GAAG,CAAC,CAAA;YACd,IAAI,GAAG,KAAK,CAAC;gBACZ,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAA;QACrC,CAAC,CAAC,CAAA;QACF,MAAM,CAAC,KAAK,IAAG,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE,CAAA;QACtC,MAAM,CAAC,KAAK,IAAG,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE,CAAA;IAC3C,CAAC,CAAC;CACF,CAAC,CAAA"}
+{"version":3,"file":"queue.test.js","sourceRoot":"","sources":["../../s/queue/queue.test.ts"],"names":[],"mappings":"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"}

package/x/utensils/map.js

@@ -1,4 +1,4 @@
-export function need(map, key, err = "need failed") {
+export function need(map, key, err = (typeof key === "string" ? `needed key not found "${key}"` : "needed key not found")) {
     if (map.has(key))
         return map.get(key);
     else

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,CAAO,GAAuC,EAAE,GAAM,EAAE,GAAG,GAAG,aAAa;IAC9F,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,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"}