dphelper 4.6.0 → 4.6.2

package/modules/worker.d.ts

@@ -1,20 +1,20 @@
 /// <reference path="../types/dphelper.d.ts" />
-export interface WorkerPool {
-  workers: Worker[]
-  busy: Set<Worker>
-  queue: Array<{ task: any, resolve: Function, reject: Function }>
-  size: number
-}
-
-interface WorkerTool {
-  create: (src: string, options?: { onmessage?: (e: MessageEvent) => void; onerror?: (e: ErrorEvent) => void }) => Worker
-  createInline: (code: string, options?: { onmessage?: (e: MessageEvent) => void; onerror?: (e: ErrorEvent) => void }) => Worker
-  post: (worker: Worker, message: any, transferables?: Transferable[]) => void
-  terminate: (worker: Worker) => void
-  pool: (src: string, size?: number) => WorkerPool
-  poolExec: (pool: WorkerPool, tasks: any[]) => Promise<any[]>
-  importScripts: (worker: Worker, scripts: string[]) => void
-  shared: (src: string, options?: { name?: string; onconnect?: (e: MessageEvent) => void; onmessage?: (e: MessageEvent) => void }) => SharedWorker
+export interface WorkerPool {
+  workers: Worker[]
+  busy: Set<Worker>
+  queue: Array<{ task: any, resolve: Function, reject: Function }>
+  size: number
+}
+
+interface WorkerTool {
+  create: (src: string, options?: { onmessage?: (e: MessageEvent) => void; onerror?: (e: ErrorEvent) => void }) => Worker
+  createInline: (code: string, options?: { onmessage?: (e: MessageEvent) => void; onerror?: (e: ErrorEvent) => void }) => Worker
+  post: (worker: Worker, message: any, transferables?: Transferable[]) => void
+  terminate: (worker: Worker) => void
+  pool: (src: string, size?: number) => WorkerPool
+  poolExec: (pool: WorkerPool, tasks: any[]) => Promise<any[]>
+  importScripts: (worker: Worker, scripts: string[]) => void
+  shared: (src: string, options?: { name?: string; onconnect?: (e: MessageEvent) => void; onmessage?: (e: MessageEvent) => void }) => SharedWorker
 }
 
 export const worker: WorkerTool

package/modules/worker.js

@@ -1,2 +1,2 @@
-var g={info:{title:"List",description:"Complete list of tools"},categories:["3party","system","financial","memory","numbers","time","path","file","forms","ui","other","development"]};var y={version:"4.6.0"};Object.defineProperty(globalThis,"dphelper",{value:new Proxy({},{}),writable:true,configurable:true,enumerable:false});Object.defineProperties(dphelper,{_list:{value:{scripts:[],sockets:[],...g},configurable:true,writable:true},version:{value:y.version,configurable:true,writable:true},isServer:{value:false,configurable:true,writable:true},isBrowser:{value:true,configurable:true,writable:true}});var p=dphelper;Object.defineProperty(p,"setProps",{value:(r,e,t)=>{Object.defineProperty(r,e.name,t||{writable:false,configurable:false,enumerable:false}),t?.lock&&Object.freeze(r[e.name]);},writable:false,configurable:false,enumerable:false});Object.defineProperty(p,"setDescription",{value:(r,e)=>{Object.defineProperties(p,{[r.name]:{value:e,writable:false,configurable:false,enumerable:false}}),Object.keys(e).map(t=>(Object.defineProperties(p[r.name],{[t]:{writable:false,configurable:false,enumerable:false}}),null)),p.setProps(p,r,{writable:false,configurable:false,enumerable:false}),p._list.scripts.push(r);}});var L={name:"worker",active:true,subCommand:[{name:"create",version:"0.0.1",example:"dphelper.worker.create('worker.js', { onmessage: (e) => console.log(e.data) })",author:"Dario Passariello",creationDate:"20260313",lastMod:"20260313",type:"function",active:true,description:"Create a new Web Worker from a script URL or inline code",env:"client",subCommand:[]},{name:"createInline",version:"0.0.1",example:"dphelper.worker.createInline('self.onmessage = e => postMessage(e.data * 2)')",author:"Dario Passariello",creationDate:"20260313",lastMod:"20260313",type:"function",active:true,description:"Create a Web Worker from inline JavaScript code",env:"client",subCommand:[]},{name:"post",version:"0.0.1",example:"dphelper.worker.post(worker, { type: 'compute', data: 42 })",author:"Dario Passariello",creationDate:"20260313",lastMod:"20260313",type:"function",active:true,description:"Send a message to a worker",env:"client",subCommand:[]},{name:"terminate",version:"0.0.1",example:"dphelper.worker.terminate(worker)",author:"Dario Passariello",creationDate:"20260313",lastMod:"20260313",type:"function",active:true,description:"Terminate a Web Worker",env:"client",subCommand:[]},{name:"pool",version:"0.0.1",example:"dphelper.worker.pool('worker.js', 4)",author:"Dario Passariello",creationDate:"20260313",lastMod:"20260313",type:"function",active:true,description:"Create a pool of workers for parallel processing",env:"client",subCommand:[]},{name:"poolExec",version:"0.0.1",example:"dphelper.worker.poolExec(pool, tasks)",author:"Dario Passariello",creationDate:"20260313",lastMod:"20260313",type:"function",active:true,description:"Execute tasks across a worker pool",env:"client",subCommand:[]},{name:"importScripts",version:"0.0.1",example:"dphelper.worker.importScripts(worker, ['lib1.js', 'lib2.js'])",author:"Dario Passariello",creationDate:"20260313",lastMod:"20260313",type:"function",active:true,description:"Import external scripts into a worker",env:"client",subCommand:[]},{name:"shared",version:"0.0.1",example:"dphelper.worker.shared('my-shared-buffer')",author:"Dario Passariello",creationDate:"20260313",lastMod:"20260313",type:"function",active:true,description:"Create a SharedWorker for cross-tab communication",env:"client",subCommand:[]}]},W=(r,e={})=>{try{let t=new URL(r);if(!["http:","https:","blob:","data:"].includes(t.protocol))throw new Error(`Invalid protocol: ${t.protocol}`);let o=new Worker(t.href);return e.onmessage&&(o.onmessage=e.onmessage),e.onerror&&(o.onerror=e.onerror),o}catch(t){if(!(typeof r=="string"&&!r.startsWith("http://")&&!r.startsWith("https://")&&!r.startsWith("blob:")&&!r.startsWith("data:")))throw console.error("[dphelper] worker.create: Invalid URL or protocol. Only http, https, blob, data, or relative paths allowed."),new Error("Invalid worker source URL",{cause:t});let a=new Blob([r],{type:"application/javascript"}),n=new Worker(URL.createObjectURL(a));return e.onmessage&&(n.onmessage=e.onmessage),e.onerror&&(n.onerror=e.onerror),n}},D=(r,e={})=>{let t=new Blob([r],{type:"application/javascript"}),o=URL.createObjectURL(t),a=new Worker(o);return e.onmessage&&(a.onmessage=e.onmessage),e.onerror&&(a.onerror=e.onerror),a.addEventListener("message",()=>{URL.revokeObjectURL(o);}),a.addEventListener("error",()=>{URL.revokeObjectURL(o);}),a},f=(r,e,t)=>{t?r.postMessage(e,t):r.postMessage(e);},O=r=>{r.terminate();},R=(r,e=4)=>{let t=[],o=new Set;for(let n=0;n<e;n++)t.push(W(r));return {workers:t,busy:o,queue:[],size:e}},x=async(r,e,t=3e4)=>new Promise((o,a)=>{let n=new Array(e.length),s=0,l=false,h=setTimeout(()=>{l=true,a(new Error(`[dphelper] Worker pool execution timed out after ${t}ms`));},t),v=()=>{if(!l)for(;r.queue.length>0&&r.busy.size<r.size;){let{task:c}=r.queue.shift();E(c.index,c.data);}},E=(c,d)=>{if(l)return;let i=r.workers.find(u=>!r.busy.has(u));if(!i)return;r.busy.add(i);let w=u=>{i.removeEventListener("message",w),r.busy.delete(i),n[c]=u.data,s++,s===e.length?(clearTimeout(h),o(n)):v();},k=u=>{i.removeEventListener("error",k),r.busy.delete(i),l=true,clearTimeout(h),a(new Error(`[dphelper] Worker task failed: ${u.message}`));};i.addEventListener("message",w),i.addEventListener("error",k),f(i,{index:c,data:d});};e.forEach((c,d)=>{r.queue.push({task:{index:d,data:c}});}),v();}),M=(r,e)=>{e.forEach(s=>{try{let l=new URL(s);if(!["http:","https:","blob:","data:"].includes(l.protocol)){console.error(`[dphelper] Invalid protocol for importScripts: ${l.protocol}`);return}}catch{console.error(`[dphelper] Invalid URL for importScripts: ${s}`);return}});let o=e.map(s=>s.replace(/['\\]/g,"\\$&")).map(s=>`importScripts('${s}');`).join(`
+var g={info:{title:"List",description:"Complete list of tools"},categories:["3party","system","financial","memory","numbers","time","path","file","forms","ui","other","development"]};var y={version:"4.6.2"};Object.defineProperty(globalThis,"dphelper",{value:new Proxy({},{}),writable:true,configurable:true,enumerable:false});Object.defineProperties(dphelper,{_list:{value:{scripts:[],sockets:[],...g},configurable:true,writable:true},version:{value:y.version,configurable:true,writable:true},isServer:{value:false,configurable:true,writable:true},isBrowser:{value:true,configurable:true,writable:true}});var p=dphelper;Object.defineProperty(p,"setProps",{value:(r,e,t)=>{Object.defineProperty(r,e.name,t||{writable:false,configurable:false,enumerable:false}),t?.lock&&Object.freeze(r[e.name]);},writable:false,configurable:false,enumerable:false});Object.defineProperty(p,"setDescription",{value:(r,e)=>{Object.defineProperties(p,{[r.name]:{value:e,writable:false,configurable:false,enumerable:false}}),Object.keys(e).map(t=>(Object.defineProperties(p[r.name],{[t]:{writable:false,configurable:false,enumerable:false}}),null)),p.setProps(p,r,{writable:false,configurable:false,enumerable:false}),p._list.scripts.push(r);}});var L={name:"worker",active:true,subCommand:[{name:"create",version:"0.0.1",example:"dphelper.worker.create('worker.js', { onmessage: (e) => console.log(e.data) })",author:"Dario Passariello",creationDate:"20260313",lastMod:"20260313",type:"function",active:true,description:"Create a new Web Worker from a script URL or inline code",env:"client",subCommand:[]},{name:"createInline",version:"0.0.1",example:"dphelper.worker.createInline('self.onmessage = e => postMessage(e.data * 2)')",author:"Dario Passariello",creationDate:"20260313",lastMod:"20260313",type:"function",active:true,description:"Create a Web Worker from inline JavaScript code",env:"client",subCommand:[]},{name:"post",version:"0.0.1",example:"dphelper.worker.post(worker, { type: 'compute', data: 42 })",author:"Dario Passariello",creationDate:"20260313",lastMod:"20260313",type:"function",active:true,description:"Send a message to a worker",env:"client",subCommand:[]},{name:"terminate",version:"0.0.1",example:"dphelper.worker.terminate(worker)",author:"Dario Passariello",creationDate:"20260313",lastMod:"20260313",type:"function",active:true,description:"Terminate a Web Worker",env:"client",subCommand:[]},{name:"pool",version:"0.0.1",example:"dphelper.worker.pool('worker.js', 4)",author:"Dario Passariello",creationDate:"20260313",lastMod:"20260313",type:"function",active:true,description:"Create a pool of workers for parallel processing",env:"client",subCommand:[]},{name:"poolExec",version:"0.0.1",example:"dphelper.worker.poolExec(pool, tasks)",author:"Dario Passariello",creationDate:"20260313",lastMod:"20260313",type:"function",active:true,description:"Execute tasks across a worker pool",env:"client",subCommand:[]},{name:"importScripts",version:"0.0.1",example:"dphelper.worker.importScripts(worker, ['lib1.js', 'lib2.js'])",author:"Dario Passariello",creationDate:"20260313",lastMod:"20260313",type:"function",active:true,description:"Import external scripts into a worker",env:"client",subCommand:[]},{name:"shared",version:"0.0.1",example:"dphelper.worker.shared('my-shared-buffer')",author:"Dario Passariello",creationDate:"20260313",lastMod:"20260313",type:"function",active:true,description:"Create a SharedWorker for cross-tab communication",env:"client",subCommand:[]}]},W=(r,e={})=>{try{let t=new URL(r);if(!["http:","https:","blob:","data:"].includes(t.protocol))throw new Error(`Invalid protocol: ${t.protocol}`);let o=new Worker(t.href);return e.onmessage&&(o.onmessage=e.onmessage),e.onerror&&(o.onerror=e.onerror),o}catch(t){if(!(typeof r=="string"&&!r.startsWith("http://")&&!r.startsWith("https://")&&!r.startsWith("blob:")&&!r.startsWith("data:")))throw console.error("[dphelper] worker.create: Invalid URL or protocol. Only http, https, blob, data, or relative paths allowed."),new Error("Invalid worker source URL",{cause:t});let a=new Blob([r],{type:"application/javascript"}),n=new Worker(URL.createObjectURL(a));return e.onmessage&&(n.onmessage=e.onmessage),e.onerror&&(n.onerror=e.onerror),n}},D=(r,e={})=>{let t=new Blob([r],{type:"application/javascript"}),o=URL.createObjectURL(t),a=new Worker(o);return e.onmessage&&(a.onmessage=e.onmessage),e.onerror&&(a.onerror=e.onerror),a.addEventListener("message",()=>{URL.revokeObjectURL(o);}),a.addEventListener("error",()=>{URL.revokeObjectURL(o);}),a},f=(r,e,t)=>{t?r.postMessage(e,t):r.postMessage(e);},O=r=>{r.terminate();},R=(r,e=4)=>{let t=[],o=new Set;for(let n=0;n<e;n++)t.push(W(r));return {workers:t,busy:o,queue:[],size:e}},x=async(r,e,t=3e4)=>new Promise((o,a)=>{let n=new Array(e.length),s=0,l=false,h=setTimeout(()=>{l=true,a(new Error(`[dphelper] Worker pool execution timed out after ${t}ms`));},t),v=()=>{if(!l)for(;r.queue.length>0&&r.busy.size<r.size;){let{task:c}=r.queue.shift();E(c.index,c.data);}},E=(c,d)=>{if(l)return;let i=r.workers.find(u=>!r.busy.has(u));if(!i)return;r.busy.add(i);let w=u=>{i.removeEventListener("message",w),r.busy.delete(i),n[c]=u.data,s++,s===e.length?(clearTimeout(h),o(n)):v();},k=u=>{i.removeEventListener("error",k),r.busy.delete(i),l=true,clearTimeout(h),a(new Error(`[dphelper] Worker task failed: ${u.message}`));};i.addEventListener("message",w),i.addEventListener("error",k),f(i,{index:c,data:d});};e.forEach((c,d)=>{r.queue.push({task:{index:d,data:c}});}),v();}),M=(r,e)=>{e.forEach(s=>{try{let l=new URL(s);if(!["http:","https:","blob:","data:"].includes(l.protocol)){console.error(`[dphelper] Invalid protocol for importScripts: ${l.protocol}`);return}}catch{console.error(`[dphelper] Invalid URL for importScripts: ${s}`);return}});let o=e.map(s=>s.replace(/['\\]/g,"\\$&")).map(s=>`importScripts('${s}');`).join(`
 `),a=new Blob([o],{type:"application/javascript"}),n=URL.createObjectURL(a);f(r,{type:"import",url:n});},S=(r,e={})=>{try{let t=e.name?{name:e.name}:void 0,o=new SharedWorker(r,t);return e.onmessage&&(o.port.onmessage=e.onmessage),e.onconnect&&(o.port.onmessage=a=>{e.onconnect?.(a),e.onmessage&&e.onmessage(a);}),o}catch(t){console.error("[dphelper] SharedWorker creation failed:",t);return}},U={create:W,createInline:D,post:f,terminate:O,pool:R,poolExec:x,importScripts:M,shared:S};dphelper?.setDescription(L,U);var J=dphelper.worker;export{J as worker};

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "dphelper",
   "codeName": "dphelper",
-  "version": "4.6.0",
-  "description": "dphelper devtools for developers",
+  "version": "4.6.2",
+  "description": "dphelper is a programmable, introspectable toolbox whose capabilities can be consumed by both developers and AI agents",
   "main": "./index.cjs",
   "browser": "./index.cjs",
   "type": "module",

package/sbom.json

@@ -2,10 +2,10 @@
   "$schema": "http://cyclonedx.org/schema/bom-1.5.schema.json",
   "bomFormat": "CycloneDX",
   "specVersion": "1.5",
-  "serialNumber": "urn:uuid:76ce3144-4a90-4bf8-944d-8411bc7d1094",
+  "serialNumber": "urn:uuid:aa8fd5f7-2cd8-4870-a9a3-7da5528fc311",
   "version": 1,
   "metadata": {
-    "timestamp": "2026-08-30T04:31:47.350Z",
+    "timestamp": "2026-08-30T05:26:15.924Z",
     "lifecycles": [
       {
         "phase": "build"
@@ -15,24 +15,19 @@
       {
         "vendor": "npm",
         "name": "cli",
-        "version": "10.8.2"
+        "version": "12.0.1"
       }
     ],
     "component": {
-      "bom-ref": "dphelper@4.6.0",
+      "bom-ref": "dphelper@4.6.2",
       "type": "library",
-      "name": "picla.npm.dphelper",
-      "version": "4.6.0",
+      "name": "dphelper",
+      "version": "4.6.2",
       "scope": "required",
       "author": "Dario Passariello",
-      "description": "dphelper devtools for developers",
-      "purl": "pkg:npm/dphelper@4.6.0",
-      "properties": [
-        {
-          "name": "cdx:npm:package:path",
-          "value": ""
-        }
-      ],
+      "description": "dphelper is a programmable, introspectable toolbox whose capabilities can be consumed by both developers and AI agents",
+      "purl": "pkg:npm/dphelper@4.6.2",
+      "properties": [],
       "externalReferences": [],
       "licenses": [
         {
@@ -46,7 +41,7 @@
   "components": [],
   "dependencies": [
     {
-      "ref": "dphelper@4.6.0",
+      "ref": "dphelper@4.6.2",
       "dependsOn": []
     }
   ]