b4n1-boost 0.3.7 → 0.3.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/background.js ADDED
@@ -0,0 +1,65 @@
1
+ // b4n1-boost background tasks for Node.js (no Redis, no BullMQ).
2
+ // background(fn, opts) runs pure functions in worker_threads and journals
3
+ // every submission to a JSONL file, so a restart never silently loses a
4
+ // submitted task record. Falls back to the event loop when worker_threads
5
+ // is unavailable.
6
+ const fs = require('fs');
7
+ const path = require('path');
8
+ const { Worker } = require('worker_threads');
9
+
10
+ function journalAppend(journal, rec) {
11
+ if (!journal) return;
12
+ fs.mkdirSync(path.dirname(journal), { recursive: true });
13
+ fs.appendFileSync(journal, JSON.stringify(rec) + '\n');
14
+ }
15
+
16
+ function background(fn, opts = {}) {
17
+ const journal = opts.journal || null;
18
+ const src = fn.toString();
19
+ return (...args) => {
20
+ const id = `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
21
+ journalAppend(journal, { id, func: fn.name || 'anonymous', status: 'pending', created: Date.now() });
22
+ const run = () => new Promise((resolve, reject) => {
23
+ let worker;
24
+ try {
25
+ worker = new Worker(
26
+ `const { parentPort, workerData } = require('worker_threads');\n`
27
+ + `const fn = (${src});\n`
28
+ + `Promise.resolve(fn(...workerData.args)).then(r => parentPort.postMessage({ ok: true, r }), e => parentPort.postMessage({ ok: false, e: String(e && e.stack || e) }));`,
29
+ { eval: true, workerData: { args } }
30
+ );
31
+ } catch (e) {
32
+ // worker_threads unavailable: run inline (documented fallback)
33
+ Promise.resolve()
34
+ .then(() => fn(...args))
35
+ .then(r => finish(null, r), e => finish(e));
36
+ return;
37
+ }
38
+ const finish = (err, val) => {
39
+ journalAppend(journal, { id, status: err ? 'failed' : 'done', finished: Date.now(), error: err ? String(err && err.message || err) : null });
40
+ try { worker.terminate(); } catch { /* already gone */ }
41
+ err ? reject(err) : resolve(val);
42
+ };
43
+ worker.on('message', m => (m.ok ? finish(null, m.r) : finish(new Error(m.e))));
44
+ worker.on('error', finish);
45
+ });
46
+ const p = run();
47
+ p.id = id;
48
+ return p;
49
+ };
50
+ }
51
+
52
+ function pendingTasks(journal) {
53
+ if (!journal || !fs.existsSync(journal)) return [];
54
+ const seen = new Map();
55
+ for (const line of fs.readFileSync(journal, 'utf8').split('\n')) {
56
+ if (!line.trim()) continue;
57
+ try {
58
+ const r = JSON.parse(line);
59
+ seen.set(r.id, r);
60
+ } catch { /* skip torn line */ }
61
+ }
62
+ return [...seen.values()].filter(r => r.status === 'pending');
63
+ }
64
+
65
+ module.exports = { background, pendingTasks };
Binary file
Binary file
Binary file
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "b4n1-boost",
3
- "version": "0.3.7",
3
+ "version": "0.3.9",
4
4
  "description": "High-performance native Rust boost layer for Node.js & Express",
5
5
  "main": "index.js",
6
6
  "scripts": {
@@ -22,6 +22,7 @@
22
22
  "bin/",
23
23
  "LICENSE",
24
24
  "EULA.txt",
25
- "README.md"
25
+ "README.md",
26
+ "background.js"
26
27
  ]
27
28
  }