@e280/stz 0.0.0-29 → 0.0.0-30

package/package.json

@@ -1,11 +1,14 @@
 {
 	"name": "@e280/stz",
-	"version": "0.0.0-29",
+	"version": "0.0.0-30",
 	"description": "everyday ts fns for everything",
 	"license": "MIT",
 	"author": "Chase Moskal <chasemoskal@gmail.com>",
 	"type": "module",
-	"main": "x/index.js",
+	"main": "./x/index.js",
+	"exports": {
+		".": "./x/index.js"
+	},
 	"files": [
 		"x",
 		"s"
@@ -24,9 +27,9 @@
 	},
 	"devDependencies": {
 		"@e280/science": "^0.0.5",
-		"@types/node": "^24.1.0",
+		"@types/node": "^24.2.0",
 		"npm-run-all": "^4.1.5",
-		"typescript": "^5.8.3"
+		"typescript": "^5.9.2"
 	},
 	"keywords": [
 		"standard",

package/s/index.ts

@@ -13,6 +13,8 @@ export * from "./debounce/types.js"
 
 export * from "./deep/deep.js"
 
+export * from "./queue/queue.js"
+
 export * from "./coalesce.js"
 export * from "./concurrent.js"
 export * from "./deadline.js"

package/s/queue/queue.test.ts

@@ -0,0 +1,67 @@
+
+import {Science, expect} from "@e280/science"
+
+import {nap} from "../nap.js"
+import {queue} from "./queue.js"
+
+export default Science.suite({
+	"job runs": Science.test(async() => {
+		let concurrent = 0
+		const job = queue(async() => {
+			concurrent++
+			await nap(100)
+			concurrent--
+		})
+		const promise1 = job()
+		await nap(50)
+		expect(concurrent).is(1)
+		await promise1
+		expect(concurrent).is(0)
+	}),
+
+	"sequencing is enforced": Science.test(async() => {
+		let concurrent = 0
+		const job = queue(async() => {
+			concurrent++
+			await nap(100)
+			concurrent--
+		})
+
+		const promise1 = job()
+		const promise2 = job()
+
+		await nap(50)
+		expect(concurrent).is(1)
+
+		await promise1
+		await nap(50)
+		expect(concurrent).is(1)
+
+		await promise2
+		expect(concurrent).is(0)
+	}),
+
+	"params and return values seem to work": Science.test(async() => {
+		const add = queue(async(a: number, b: number) => {
+			await nap(100)
+			return a + b
+		})
+		const promise1 = add(1, 2)
+		const promise2 = add(10, 20)
+		expect(await promise1).is(3)
+		expect(await promise2).is(30)
+	}),
+
+	"first job throws, second job unaffected": Science.test(async() => {
+		let run = 0
+		const job = queue(async() => {
+			run++
+			await nap(100)
+			if (run === 1)
+				throw new Error("first job failed")
+		})
+		expect(async() => job()).throwsAsync()
+		expect(async() => job()).not.throwsAsync()
+	}),
+})
+

package/s/queue/queue.ts

@@ -0,0 +1,21 @@
+
+/**
+ * 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>
+	): (...args: Args) => Promise<Result> {
+
+	let last: Promise<any> = Promise.resolve()
+
+	return (...args: Args): Promise<Result> => {
+		const job = () => fn(...args)
+		const current = last.then(job)
+
+		// prevent unhandled rejection breaking the chain
+		last = current.catch(() => {})
+
+		return current
+	}
+}
+

package/s/tests.test.ts

@@ -7,6 +7,7 @@ import debounce from "./debounce/debounce.test.js"
 import bytename from "./data/bytename/bytename.test.js"
 import deep from "./deep/deep.test.js"
 import data from "./data/data.test.js"
+import queue from "./queue/queue.test.js"
 
 await Science.run({
 	clone,
@@ -15,5 +16,6 @@ await Science.run({
 	debounce,
 	deep,
 	data,
+	queue,
 })
 

package/x/index.d.ts

@@ -9,6 +9,7 @@ export * from "./data/txt.js";
 export * from "./debounce/debounce.js";
 export * from "./debounce/types.js";
 export * from "./deep/deep.js";
+export * from "./queue/queue.js";
 export * from "./coalesce.js";
 export * from "./concurrent.js";
 export * from "./deadline.js";

package/x/index.js

@@ -9,6 +9,7 @@ export * from "./data/txt.js";
 export * from "./debounce/debounce.js";
 export * from "./debounce/types.js";
 export * from "./deep/deep.js";
+export * from "./queue/queue.js";
 export * from "./coalesce.js";
 export * from "./concurrent.js";
 export * from "./deadline.js";

package/x/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../s/index.ts"],"names":[],"mappings":"AACA,cAAc,0BAA0B,CAAA;AACxC,cAAc,kBAAkB,CAAA;AAChC,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,wBAAwB,CAAA;AACtC,cAAc,qBAAqB,CAAA;AAEnC,cAAc,gBAAgB,CAAA;AAE9B,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA;AACjC,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,SAAS,CAAA;AACvB,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../s/index.ts"],"names":[],"mappings":"AACA,cAAc,0BAA0B,CAAA;AACxC,cAAc,kBAAkB,CAAA;AAChC,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,wBAAwB,CAAA;AACtC,cAAc,qBAAqB,CAAA;AAEnC,cAAc,gBAAgB,CAAA;AAE9B,cAAc,kBAAkB,CAAA;AAEhC,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA;AACjC,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,SAAS,CAAA;AACvB,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA"}

package/x/queue/queue.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 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>;

package/x/queue/queue.js

@@ -0,0 +1,14 @@
+/**
+ * create a job queue that ensures the given fn is always called in sequence (not concurrently).
+ */
+export function queue(fn) {
+    let last = Promise.resolve();
+    return (...args) => {
+        const job = () => fn(...args);
+        const current = last.then(job);
+        // prevent unhandled rejection breaking the chain
+        last = current.catch(() => { });
+        return current;
+    };
+}
+//# sourceMappingURL=queue.js.map

package/x/queue/queue.js.map

@@ -0,0 +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"}

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

@@ -0,0 +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;
+};
+export default _default;

package/x/queue/queue.test.js

@@ -0,0 +1,57 @@
+import { Science, expect } from "@e280/science";
+import { nap } from "../nap.js";
+import { queue } from "./queue.js";
+export default Science.suite({
+    "job runs": Science.test(async () => {
+        let concurrent = 0;
+        const job = queue(async () => {
+            concurrent++;
+            await nap(100);
+            concurrent--;
+        });
+        const promise1 = job();
+        await nap(50);
+        expect(concurrent).is(1);
+        await promise1;
+        expect(concurrent).is(0);
+    }),
+    "sequencing is enforced": Science.test(async () => {
+        let concurrent = 0;
+        const job = queue(async () => {
+            concurrent++;
+            await nap(100);
+            concurrent--;
+        });
+        const promise1 = job();
+        const promise2 = job();
+        await nap(50);
+        expect(concurrent).is(1);
+        await promise1;
+        await nap(50);
+        expect(concurrent).is(1);
+        await promise2;
+        expect(concurrent).is(0);
+    }),
+    "params and return values seem to work": Science.test(async () => {
+        const add = queue(async (a, b) => {
+            await nap(100);
+            return a + b;
+        });
+        const promise1 = add(1, 2);
+        const promise2 = add(10, 20);
+        expect(await promise1).is(3);
+        expect(await promise2).is(30);
+    }),
+    "first job throws, second job unaffected": Science.test(async () => {
+        let run = 0;
+        const job = queue(async () => {
+            run++;
+            await nap(100);
+            if (run === 1)
+                throw new Error("first job failed");
+        });
+        expect(async () => job()).throwsAsync();
+        expect(async () => job()).not.throwsAsync();
+    }),
+});
+//# sourceMappingURL=queue.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"queue.test.js","sourceRoot":"","sources":["../../s/queue/queue.test.ts"],"names":[],"mappings":"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"}

package/x/tests.test.js

@@ -5,6 +5,7 @@ import debounce from "./debounce/debounce.test.js";
 import bytename from "./data/bytename/bytename.test.js";
 import deep from "./deep/deep.test.js";
 import data from "./data/data.test.js";
+import queue from "./queue/queue.test.js";
 await Science.run({
     clone,
     bytename,
@@ -12,5 +13,6 @@ await Science.run({
     debounce,
     deep,
     data,
+    queue,
 });
 //# sourceMappingURL=tests.test.js.map

package/x/tests.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"tests.test.js","sourceRoot":"","sources":["../s/tests.test.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,OAAO,EAAC,MAAM,eAAe,CAAA;AAErC,OAAO,KAAK,MAAM,uBAAuB,CAAA;AACzC,OAAO,UAAU,MAAM,oCAAoC,CAAA;AAC3D,OAAO,QAAQ,MAAM,6BAA6B,CAAA;AAClD,OAAO,QAAQ,MAAM,kCAAkC,CAAA;AACvD,OAAO,IAAI,MAAM,qBAAqB,CAAA;AACtC,OAAO,IAAI,MAAM,qBAAqB,CAAA;AAEtC,MAAM,OAAO,CAAC,GAAG,CAAC;IACjB,KAAK;IACL,QAAQ;IACR,UAAU;IACV,QAAQ;IACR,IAAI;IACJ,IAAI;CACJ,CAAC,CAAA"}
+{"version":3,"file":"tests.test.js","sourceRoot":"","sources":["../s/tests.test.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,OAAO,EAAC,MAAM,eAAe,CAAA;AAErC,OAAO,KAAK,MAAM,uBAAuB,CAAA;AACzC,OAAO,UAAU,MAAM,oCAAoC,CAAA;AAC3D,OAAO,QAAQ,MAAM,6BAA6B,CAAA;AAClD,OAAO,QAAQ,MAAM,kCAAkC,CAAA;AACvD,OAAO,IAAI,MAAM,qBAAqB,CAAA;AACtC,OAAO,IAAI,MAAM,qBAAqB,CAAA;AACtC,OAAO,KAAK,MAAM,uBAAuB,CAAA;AAEzC,MAAM,OAAO,CAAC,GAAG,CAAC;IACjB,KAAK;IACL,QAAQ;IACR,UAAU;IACV,QAAQ;IACR,IAAI;IACJ,IAAI;IACJ,KAAK;CACL,CAAC,CAAA"}