reflected 0.0.0 → 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright © 2026-today, Andrea Giammarchi, @WebReflection
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the “Software”), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software
+is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included
+in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
+IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,127 @@
+# reflected
+
+A primitive to allow workers to call synchronously any functionality exposed on the main thread.
+
+This module uses 3 synchronous strategies + 1 asynchronous fallback:
+
+  * **message** based on *SharedArrayBuffer* and *MessageChannel*, the fastest and most reliable "*channel strategy*" that requires headers to enable [Cross Origin Isolation](https://developer.mozilla.org/en-US/docs/Web/API/Window/crossOriginIsolated) on the page.
+  * **broadcast** also based on *SharedArrayBuffer* but with *BroadcastChannel* instead to satisfy a long standing [Firefox bug](https://bugzilla.mozilla.org/show_bug.cgi?id=1752287). This also requires headers to enable [Cross Origin Isolation](https://developer.mozilla.org/en-US/docs/Web/API/Window/crossOriginIsolated) on the page.
+  * **xhr** based on synchronous *XMLHttpRequest* and a dedicated *ServiceWorker* able to intercept such *POST* requests, broadcast to all listening channels the request and resolve as response for the worker.
+  * **async** which will always return a *Promise* and will not need special headers or *ServiceWorker*. This is also a fallback for the *xhr* case if the `serviceWorker` option field has not been provided.
+
+All strategies are automatically detected through the default/main `import` but all dedicated strategies can be retrieved directly, example:
+
+  * `import reflect from 'reflected'` will decide automatically which strategy should be used.
+  * `import reflect from 'reflected/message'` will return the right *message* based module on the main thread and the worker mode within the worker.
+  * `import reflect from 'reflected/main/message'` will return the *message* strategy for the main thread only. This requires the least amount of bandwidth when you are sure that *message* strategy will work on main.
+  * `import reflect from 'reflected/worker/message'` will return the *message* strategy for the worker thread only. This requires the least amount of bandwidth when you are sure that *message* strategy will work within the worker.
+
+Swap `message` with `broadcast`, `xhr` or `async`, and all exports will work equally well accordingly to the chosen "*channel strategy*".
+
+### Worker Thread API
+
+```js
+// file: worker.js (always loaded as module)
+import reflect from 'https://esm.run/reflected';
+
+// ℹ️ must await the initialization
+const reflected = await reflect({
+  // receives the returned data from the main thread.
+  // use this helper to transform such data into something
+  // that the worker can use/understand after invoke
+  // ⚠️ must be synchronous and it's invoked synchronously
+  ondata(response:Int32Array) {
+    return response.length ? response[0] : undefined;
+  },
+
+  // receives the data from the main thread when
+  // `worker.send(payload, ...rest)` is invoked.
+  // use this helper to transform the main thread request
+  // into something compatible with structuredClone algorithm
+  // ℹ️ works even if synchronous but it's resolved asynchronously
+  async onsend(payload) {
+    const data = await fetch('./data.json').then(r => r.json());
+    return process(payload, data);
+  },
+});
+
+// retrive the result of `test_sum(1, 2, 3)`
+// directly from the main thread.
+// only the async channel variant would need to await
+const value = reflected({
+  invoke: 'test_sum',
+  args: [1, 2, 3]
+});
+
+console.log(value); // 6
+```
+
+### Main Thread API
+
+```js
+// file: index.js as module
+import reflect from 'https://esm.run/reflected';
+
+function test_sum(...args:number[]) {
+  let i = 0;
+  while (args.length)
+    i += args.pop();
+  return i;
+}
+
+// ℹ️ must await the initialization
+const worker = await reflect(
+  // Worker scriptURL
+  './worker.js',
+  // Worker options + required utilities / helpers
+  // ℹ️ type is enforced to be 'module' due top-level await
+  {
+    // invoked when the worker asks to synchronize a call
+    // and it mmust return an Int32Array reference to populate
+    // the SharedArrayBuffer and notify/unlock the worker
+    // ℹ️ works even if synchronous but it's resolved asynchronously
+    // ⚠️ the worker is not responsive until this returns so
+    //     be sure you handle errors gracefully to still provide
+    //     a result the worker can consume out of the shared buffer!
+    async ondata(payload:unknown) {
+      const { invoke, args } = payload;
+
+      if (invoke === 'test_sum') {
+        // just demoing this can be async too
+        const value = await test_sum(...args);
+        return new Int32Array([value]);
+      }
+
+      // errors should still be Int32Array but
+      // it is trivial to return no result
+      return new Int32Array(0);
+    },
+
+    // *optional* helper to process data returned from the worker when
+    // the main thread `await worker.send(payload, ...rest)` operation
+    // is invoked. If not present, whatever payload the worker returned
+    // will be directly returned as invoke result, just like in here.
+    // ℹ️ works even if synchronous but it's resolved asynchronously
+    onsend(payload:unknown) {
+       return payload;
+    },
+
+    // optional: the initial SharedArrayBuffer length
+    initByteLength: 1024,
+
+    // optional: the max possible SharedArrayBuffer growth
+    maxByteLength: 8192,
+
+    // optional: the service worker as fallback
+    //   * if it's a string, it's used to register it
+    //   * if it's an object, it's used to initialize it
+    //     but it must contain a `url` field to register it
+    // ℹ️ if already registered it will not try to register it
+    serviceWorker: undefined,
+  }
+);
+
+const value = await worker.send({ any: 'payload' });
+```
+
+Test [live](https://webreflection.github.io/reflected/test/readme.html) or read the [main thread](./test/readme.html) and [worker thread](./test/readme.js) code.

package/dist/async-Cn7CWifh.js

@@ -0,0 +1 @@
+import{w as e}from"./with-resolvers-CHEvl4oe.js";import{i as s}from"./i32-C78nBJH2.js";import{s as t}from"./sender-23_Enxlo.js";import"./channel-BwDpH9fR.js";const{promise:a,resolve:r}=e();addEventListener("message",({data:[e,s,t]})=>r([e,s,t]),{once:!0});const n="async";var o=r=>a.then(([a,n,o])=>(postMessage(1),((t,a,r)=>{const n=new BroadcastChannel(t),o=s(),d=new Map;return n.addEventListener("message",({data:[e,s]})=>{const[t,n]=d.get(e);a.set(s,0),t(r.ondata(a.subarray(2,2+a[1])))}),(s,...t)=>{const{promise:a,resolve:r}=e(),i=o();return d.set(i,[r,t]),n.postMessage([i,s],...t),a}})(o,new Int32Array(a),t({...n,...r}))));export{n as channel,o as default};

package/dist/async.js

@@ -0,0 +1 @@
+const e=Promise.withResolvers||function(){var e,t,s=new this((s,n)=>{e=s,t=n});return{resolve:e,reject:t,promise:s}};var t=e.bind(Promise),s=e=>{const t=new Int32Array(1);return()=>t[0]++},n="eac8422c-ea74-4190-9b8c-7966827497f0";const{isArray:r}=Array,a=e=>e;class o extends Worker{#e;#t;constructor(e,t){super(e,t),this.#e=s(),this.#t=new Map,t.onsend||(t.onsend=a),super.addEventListener("message",async e=>{const{data:s}=e;if(r(s)&&s[0]===n){e.stopImmediatePropagation(),e.preventDefault();const[n,r]=s[1],a=this.#t.get(n);this.#t.delete(n),a(await t.onsend(r))}})}send(e,...s){const r=this.#e(),{promise:a,resolve:o}=t();return this.#t.set(r,o),super.postMessage([n,[r,e]],...s),a}}let{SharedArrayBuffer:c}=globalThis;try{new c(4,{maxByteLength:8})}catch(e){c=class extends ArrayBuffer{get growable(){return super.resizable}grow(e){super.resize(e)}}}const i=2*Int32Array.BYTES_PER_ELEMENT,d=e=>{switch(typeof e){case"symbol":case"function":return!1}return!0};let u=!0;try{crypto.randomUUID()}catch(e){u=!1}const p=u?()=>crypto.randomUUID():()=>(Date.now()+Math.random()).toString(36),g="async";var y=(e=>(s,n)=>{const{promise:r,resolve:a}=t();return new e(s,n,a),r})(class extends o{constructor(e,t,s){const n=p(),r=new BroadcastChannel(n),a=(({initByteLength:e=1024,maxByteLength:t=8192})=>new c(i+e,{maxByteLength:i+t}))(t),o=new Int32Array(a),u=((e,t)=>{const s=new Int32Array(e);return async({data:n})=>{const r=await t.ondata(n),a=r.length,o=i+r.buffer.byteLength;e.byteLength<o&&e.grow(o),s.set(r,2),s[1]=a,s[0]=1}})(a,t);r.addEventListener("message",async({data:[e,t]})=>{await u({data:t}),r.postMessage([e,o.slice(0,2+o[1])])}),super(...((e,t,s)=>{const n=new URL(e,location.href);return n.searchParams.set("reflected",t),[n,{...s,type:"module"}]})(e,g,t)),super.addEventListener("message",()=>s(this),{once:!0}),super.postMessage(((e,t)=>{const s={};for(const e in t){const n=t[e];d(e)&&d(n)&&(s[e]=n)}return[e,s]})(a,t).concat(n))}get channel(){return g}});const{isArray:l}=Array;const{promise:h,resolve:m}=t();addEventListener("message",({data:[e,t,s]})=>m([e,t,s]),{once:!0});const w="async";var f="importScripts"in globalThis?e=>h.then(([r,a,o])=>(postMessage(1),((e,n,r)=>{const a=new BroadcastChannel(e),o=s(),c=new Map;return a.addEventListener("message",({data:[e,t]})=>{const[s,a]=c.get(e);n.set(t,0),s(r.ondata(n.subarray(2,2+n[1])))}),(e,...s)=>{const{promise:n,resolve:r}=t(),i=o();return c.set(i,[r,s]),a.postMessage([i,e],...s),n}})(o,new Int32Array(r),(e=>(addEventListener("message",async t=>{const{data:s}=t;if(l(s)&&s[0]===n){t.stopImmediatePropagation(),t.preventDefault();const[r,a]=s[1];postMessage([n,[r,await e.onsend(a)]])}}),e))({...a,...e})))):y;export{w as channel,f as default};

package/dist/broadcast-BPNfR9nK.js

@@ -0,0 +1 @@
+import{b as s,S as e,a,h as r,u as t,p as n}from"./shared-D9sRqO2H.js";import{r as o}from"./shared-RFmxa5x4.js";import"./with-resolvers-CHEvl4oe.js";import"./i32-C78nBJH2.js";import"./channel-BwDpH9fR.js";const c="broadcast";var d=s(class extends e{constructor(s,e,d){const p=o(),i=new BroadcastChannel(p),m=a(e);i.addEventListener("message",r(m,e,!0)),super(...t(s,c,e)),super.addEventListener("message",()=>d(this),{once:!0}),super.postMessage(n(m,e).concat(p))}get channel(){return c}});export{d as default};

package/dist/broadcast-CwqVSk2p.js

@@ -0,0 +1 @@
+import{w as r}from"./with-resolvers-CHEvl4oe.js";import{h as s}from"./shared-DdAq4SGF.js";import"./sender-23_Enxlo.js";import"./channel-BwDpH9fR.js";const{promise:a,resolve:e}=r(),o="broadcast";var t=s(a,({data:[r,s,a]})=>e([r,s,new BroadcastChannel(a)]));export{o as channel,t as default};

package/dist/broadcast.js

@@ -0,0 +1 @@
+const e=Promise.withResolvers||function(){var e,t,s=new this((s,n)=>{e=s,t=n});return{resolve:e,reject:t,promise:s}};var t=e.bind(Promise),s="eac8422c-ea74-4190-9b8c-7966827497f0";const{isArray:n}=Array,r=e=>e;class a extends Worker{#e;#t;constructor(e,t){super(e,t),this.#e=(()=>{const e=new Int32Array(1);return()=>e[0]++})(),this.#t=new Map,t.onsend||(t.onsend=r),super.addEventListener("message",async e=>{const{data:r}=e;if(n(r)&&r[0]===s){e.stopImmediatePropagation(),e.preventDefault();const[s,n]=r[1],a=this.#t.get(s);this.#t.delete(s),a(await t.onsend(n))}})}send(e,...n){const r=this.#e(),{promise:a,resolve:o}=t();return this.#t.set(r,o),super.postMessage([s,[r,e]],...n),a}}const{notify:o,store:c}=Atomics,i=2*Int32Array.BYTES_PER_ELEMENT,d=e=>{switch(typeof e){case"symbol":case"function":return!1}return!0};let u=!0;try{crypto.randomUUID()}catch(e){u=!1}const p=u?()=>crypto.randomUUID():()=>(Date.now()+Math.random()).toString(36),h="broadcast";var m=(e=>(s,n)=>{const{promise:r,resolve:a}=t();return new e(s,n,a),r})(class extends a{constructor(e,t,s){const n=p(),r=new BroadcastChannel(n),a=(({initByteLength:e=1024,maxByteLength:t=8192})=>new SharedArrayBuffer(i+e,{maxByteLength:i+t}))(t);r.addEventListener("message",((e,t)=>{const s=new Int32Array(e);return async({data:n})=>{const r=await t.ondata(n),a=r.length,d=i+r.buffer.byteLength;e.byteLength<d&&e.grow(d),s.set(r,2),c(s,1,a),c(s,0,1),o(s,0)}})(a,t)),super(...((e,t,s)=>{const n=new URL(e,location.href);return n.searchParams.set("reflected",t),[n,{...s,type:"module"}]})(e,h,t)),super.addEventListener("message",()=>s(this),{once:!0}),super.postMessage(((e,t)=>{const s={};for(const e in t){const n=t[e];d(e)&&d(n)&&(s[e]=n)}return[e,s]})(a,t).concat(n))}get channel(){return h}});const{isArray:y}=Array;const{load:g,store:l,wait:w}=Atomics,{promise:f,resolve:v}=t(),L="broadcast";var A=((e,t)=>(addEventListener("message",t,{once:!0}),t=>e.then(([e,n,r])=>(postMessage(1),((e,t,s)=>(n,...r)=>(e.postMessage(n,...r),w(t,0,0),l(t,0,0),s.ondata(t.subarray(2,2+g(t,1)))))(r,new Int32Array(e),(e=>(addEventListener("message",async t=>{const{data:n}=t;if(y(n)&&n[0]===s){t.stopImmediatePropagation(),t.preventDefault();const[r,a]=n[1];postMessage([s,[r,await e.onsend(a)]])}}),e))({...n,...t}))))))(f,({data:[e,t,s]})=>v([e,t,new BroadcastChannel(s)])),b="importScripts"in globalThis?A:m;export{L as channel,b as default};

package/dist/channel-BwDpH9fR.js

@@ -0,0 +1 @@
+var a="eac8422c-ea74-4190-9b8c-7966827497f0";export{a as S};

package/dist/i32-C78nBJH2.js

@@ -0,0 +1 @@
+var r=r=>{const n=new Int32Array(1);return()=>n[0]++};export{r as i};

package/dist/index.js

@@ -0,0 +1 @@
+import{w as a}from"./with-resolvers-CHEvl4oe.js";import{n as s}from"./shared-array-buffer-cwdMr2mc.js";let e,t;if("importScripts"in globalThis){let s;const{promise:r,resolve:o}=a(),i=new URL(location).searchParams.get("reflected");e=i,s="message"===i?import("./message-CgNarJIa.js"):"broadcast"===i?import("./broadcast-CwqVSk2p.js"):"xhr"===i?import("./xhr-CYct95wr.js"):import("./async-Cn7CWifh.js"),t=async a=>{const{data:e,ports:t}=await r,{default:o}=await s,i=new Event("message");return i.data=e,i.ports=t,dispatchEvent(i),o(a)},addEventListener("message",o,{once:!0})}else s?"InstallTrigger"in globalThis?(e="broadcast",t=(await import("./broadcast-BPNfR9nK.js")).default):(e="message",t=(await import("./message-YPvgpfHS.js")).default):navigator.serviceWorker?(e="xhr",t=(await import("./xhr-C97Ssg1V.js")).default):(e="fallback",t=()=>{});var r=t;export{e as channel,r as default};

package/dist/message-CgNarJIa.js

@@ -0,0 +1 @@
+import{w as s}from"./with-resolvers-CHEvl4oe.js";import{h as r}from"./shared-DdAq4SGF.js";import"./sender-23_Enxlo.js";import"./channel-BwDpH9fR.js";const{promise:e,resolve:o}=s(),a="message";var t=r(e,({data:[s,r],ports:[e]})=>o([s,r,e]));export{a as channel,t as default};

package/dist/message-YPvgpfHS.js

@@ -0,0 +1 @@
+import{b as s,S as e,a as t,h as r,u as a,p as n}from"./shared-D9sRqO2H.js";import"./with-resolvers-CHEvl4oe.js";import"./i32-C78nBJH2.js";import"./channel-BwDpH9fR.js";const o="message";var p=s(class extends e{constructor(s,e,p){const{port1:c,port2:i}=new MessageChannel,d=t(e);c.addEventListener(o,r(d,e,!0)),c.start(),super(...a(s,o,e)),super.addEventListener(o,()=>p(this),{once:!0}),super.postMessage(n(d,e),[i])}get channel(){return o}});export{p as default};

package/dist/message.js

@@ -0,0 +1 @@
+const e=Promise.withResolvers||function(){var e,t,s=new this((s,n)=>{e=s,t=n});return{resolve:e,reject:t,promise:s}};var t=e.bind(Promise),s="eac8422c-ea74-4190-9b8c-7966827497f0";const{isArray:n}=Array,r=e=>e;class a extends Worker{#e;#t;constructor(e,t){super(e,t),this.#e=(()=>{const e=new Int32Array(1);return()=>e[0]++})(),this.#t=new Map,t.onsend||(t.onsend=r),super.addEventListener("message",async e=>{const{data:r}=e;if(n(r)&&r[0]===s){e.stopImmediatePropagation(),e.preventDefault();const[s,n]=r[1],a=this.#t.get(s);this.#t.delete(s),a(await t.onsend(n))}})}send(e,...n){const r=this.#e(),{promise:a,resolve:o}=t();return this.#t.set(r,o),super.postMessage([s,[r,e]],...n),a}}const{notify:o,store:i}=Atomics,c=2*Int32Array.BYTES_PER_ELEMENT,d=e=>{switch(typeof e){case"symbol":case"function":return!1}return!0},u="message";var p=(e=>(s,n)=>{const{promise:r,resolve:a}=t();return new e(s,n,a),r})(class extends a{constructor(e,t,s){const{port1:n,port2:r}=new MessageChannel,a=(({initByteLength:e=1024,maxByteLength:t=8192})=>new SharedArrayBuffer(c+e,{maxByteLength:c+t}))(t);n.addEventListener(u,((e,t)=>{const s=new Int32Array(e);return async({data:n})=>{const r=await t.ondata(n),a=r.length,d=c+r.buffer.byteLength;e.byteLength<d&&e.grow(d),s.set(r,2),i(s,1,a),i(s,0,1),o(s,0)}})(a,t)),n.start(),super(...((e,t,s)=>{const n=new URL(e,location.href);return n.searchParams.set("reflected",t),[n,{...s,type:"module"}]})(e,u,t)),super.addEventListener(u,()=>s(this),{once:!0}),super.postMessage(((e,t)=>{const s={};for(const e in t){const n=t[e];d(e)&&d(n)&&(s[e]=n)}return[e,s]})(a,t),[r])}get channel(){return u}});const{isArray:g}=Array;const{load:h,store:m,wait:y}=Atomics,{promise:l,resolve:f}=t(),v="message";var w=((e,t)=>(addEventListener("message",t,{once:!0}),t=>e.then(([e,n,r])=>(postMessage(1),((e,t,s)=>(n,...r)=>(e.postMessage(n,...r),y(t,0,0),m(t,0,0),s.ondata(t.subarray(2,2+h(t,1)))))(r,new Int32Array(e),(e=>(addEventListener("message",async t=>{const{data:n}=t;if(g(n)&&n[0]===s){t.stopImmediatePropagation(),t.preventDefault();const[r,a]=n[1];postMessage([s,[r,await e.onsend(a)]])}}),e))({...n,...t}))))))(l,({data:[e,t],ports:[s]})=>f([e,t,s])),L="importScripts"in globalThis?w:p;export{v as channel,L as default};

package/dist/sender-23_Enxlo.js

@@ -0,0 +1 @@
+import{S as a}from"./channel-BwDpH9fR.js";const{isArray:s}=Array;var e=e=>(addEventListener("message",async t=>{const{data:n}=t;if(s(n)&&n[0]===a){t.stopImmediatePropagation(),t.preventDefault();const[s,o]=n[1];postMessage([a,[s,await e.onsend(o)]])}}),e);export{e as s};

package/dist/shared-D9sRqO2H.js

@@ -0,0 +1 @@
+import{w as e}from"./with-resolvers-CHEvl4oe.js";import{i as t}from"./i32-C78nBJH2.js";import{S as s}from"./channel-BwDpH9fR.js";const{isArray:r}=Array,n=e=>e;class a extends Worker{#e;#t;constructor(e,a){super(e,a),this.#e=t(),this.#t=new Map,a.onsend||(a.onsend=n),super.addEventListener("message",async e=>{const{data:t}=e;if(r(t)&&t[0]===s){e.stopImmediatePropagation(),e.preventDefault();const[s,r]=t[1],n=this.#t.get(s);this.#t.delete(s),n(await a.onsend(r))}})}send(t,...r){const n=this.#e(),{promise:a,resolve:o}=e();return this.#t.set(n,o),super.postMessage([s,[n,t]],...r),a}}const{notify:o,store:i}=Atomics,c=2*Int32Array.BYTES_PER_ELEMENT,u=({initByteLength:e=1024,maxByteLength:t=8192})=>new SharedArrayBuffer(c+e,{maxByteLength:c+t}),h=t=>(s,r)=>{const{promise:n,resolve:a}=e();return new t(s,r,a),n},m=(e,t,s)=>{const r=new Int32Array(e);return async({data:n})=>{const a=await t.ondata(n),u=a.length,h=c+a.buffer.byteLength;e.byteLength<h&&e.grow(h),r.set(a,2),s?(i(r,1,u),i(r,0,1),o(r,0)):(r[1]=u,r[0]=1)}},p=e=>{switch(typeof e){case"symbol":case"function":return!1}return!0},d=(e,t)=>{const s={};for(const e in t){const r=t[e];p(e)&&p(r)&&(s[e]=r)}return[e,s]},y=(e,t,s)=>{const r=new URL(e,location.href);return r.searchParams.set("reflected",t),[r,{...s,type:"module"}]};export{a as S,u as a,h as b,m as h,c as m,d as p,y as u};

package/dist/shared-DdAq4SGF.js

@@ -0,0 +1 @@
+import{s}from"./sender-23_Enxlo.js";const{load:e,store:a,wait:t}=Atomics,o=(o,r)=>(addEventListener("message",r,{once:!0}),r=>o.then(([o,n,d])=>(postMessage(1),((s,o,r)=>(n,...d)=>(s.postMessage(n,...d),t(o,0,0),a(o,0,0),r.ondata(o.subarray(2,2+e(o,1)))))(d,new Int32Array(o),s({...n,...r})))));export{o as h};

package/dist/shared-RFmxa5x4.js

@@ -0,0 +1 @@
+let t=!0;try{crypto.randomUUID()}catch(o){t=!1}const o=t?()=>crypto.randomUUID():()=>(Date.now()+Math.random()).toString(36);export{o as r};

package/dist/shared-array-buffer-cwdMr2mc.js

@@ -0,0 +1 @@
+let{SharedArrayBuffer:e}=globalThis,r=!0;try{new e(4,{maxByteLength:8})}catch(a){r=!1,e=class extends ArrayBuffer{get growable(){return super.resizable}grow(e){super.resize(e)}}}export{e as S,r as n};

package/dist/sw.js

@@ -0,0 +1 @@
+const e=Promise.withResolvers||function(){var e,t,n=new this((n,s)=>{e=n,t=s});return{resolve:e,reject:t,promise:n}};var t=e.bind(Promise);const[n,s]=((e=e=>e)=>{const n=new Map,s=(()=>{const e=new Int32Array(1);return()=>e[0]++})();return[()=>{let r;do{r=e(s())}while(n.has(r));const a=t();return n.set(r,a),[r,a.promise]},(e,t,s)=>{const r=n.get(e);n.delete(e),s?r?.reject(s):r?.resolve(t)}]})(),{protocol:r,host:a,pathname:o}=location,i=`${r}//${a}${o}`,c=new BroadcastChannel("eac8422c-ea74-4190-9b8c-7966827497f0");c.addEventListener("message",({data:[e,t]})=>{if("response"===e){const[e,n]=t;s(e,`[${n.join(",")}]`)}});const d=async e=>{const[t,s]=n();return c.postMessage(["request",[t,e]]),new Response(await s)};addEventListener("activate",e=>e.waitUntil(clients.claim())),addEventListener("fetch",async e=>{const{request:t}=e;"POST"===t.method&&t.url.startsWith(i)&&(e.stopImmediatePropagation(),e.respondWith(t.json().then(d)),e.preventDefault())}),addEventListener("install",()=>skipWaiting());

package/dist/with-resolvers-CHEvl4oe.js

@@ -0,0 +1 @@
+var e=(Promise.withResolvers||function(){var e,r,s=new this((s,i)=>{e=s,r=i});return{resolve:e,reject:r,promise:s}}).bind(Promise);export{e as w};

package/dist/xhr-C97Ssg1V.js

@@ -0,0 +1 @@
+import{w as e}from"./with-resolvers-CHEvl4oe.js";import{m as t,S as s,u as n,p as a,h as r}from"./shared-D9sRqO2H.js";import{S as o}from"./shared-array-buffer-cwdMr2mc.js";import{r as i}from"./shared-RFmxa5x4.js";import{S as c}from"./channel-BwDpH9fR.js";import"./i32-C78nBJH2.js";var l=({initByteLength:e=1024,maxByteLength:s=8192})=>new o(t+e,{maxByteLength:t+s});const d="async";let h=class extends s{constructor(e,t,s){const o=i(),c=new BroadcastChannel(o),h=l(t),p=new Int32Array(h),g=r(h,t,!1);c.addEventListener("message",async({data:[e,t]})=>{await g({data:t}),c.postMessage([e,p.slice(0,2+p[1])])}),super(...n(e,d,t)),super.addEventListener("message",()=>s(this),{once:!0}),super.postMessage(a(h,t).concat(o))}get channel(){return d}};const p=new Map,g=new BroadcastChannel(c);g.addEventListener("message",async({data:[e,t]})=>{if("request"===e){const[e,[s,n]]=t,a=p.get(n);if(a){const t=a.get(s);t&&(a.delete(s),g.postMessage(["response",[e,await t]]))}}});const{promise:u,resolve:m}=e();let f=!0;const v=(e,t)=>{let s,n=!0,{url:a}=t;e.getRegistration(a).then(s=>s??e.register(a,t)).then(function r(o){const{controller:i}=e;if(n=n&&!!i,s=o.installing||o.waiting||o.active,!s)return v(e,t);if("activated"===s.state){if(n){if(i.scriptURL===a)return m();o.unregister()}location.reload()}else s.addEventListener("statechange",()=>r(o),{once:!0})})};class w extends s{#e;constructor(t,s,o){if(f){f=!1;let{serviceWorker:e}=s;if(!e)return new h(t,s,o);"string"==typeof e&&(e={url:e}),e.url=new URL(e.url,location.href).href,v(navigator.serviceWorker,e)}const c=i(),d=new BroadcastChannel(c),g=l(s),u=new Map,m=new Int32Array(g),w=r(g,s,!1);p.set(c,u),d.addEventListener("message",async({data:[t,s]})=>{const{promise:n,resolve:a}=e();u.set(t,n),await w({data:s}),a(m.slice(0,2+m[1]))}),super(...n(t,"xhr",s)),super.addEventListener("message",()=>o(this),{once:!0}),super.postMessage(a(g,s).concat(c)),this.#e=c}terminate(){p.delete(this.#e),super.terminate()}get channel(){return"xhr"}}var y=(t,s)=>{const{promise:n,resolve:a}=e();return new w(t,s,a)instanceof h?n:u.then(()=>n)};export{y as default};

package/dist/xhr-CYct95wr.js

@@ -0,0 +1 @@
+import{w as e}from"./with-resolvers-CHEvl4oe.js";import{i as s}from"./i32-C78nBJH2.js";import{s as t}from"./sender-23_Enxlo.js";import"./channel-BwDpH9fR.js";const{parse:r,stringify:n}=JSON,{promise:o,resolve:a}=e();addEventListener("message",({data:[e,s,t]})=>a([e,s,t]),{once:!0});const p="xhr";var i=e=>o.then(([o,a,p])=>(postMessage(1),((e,t,o)=>{const a=new BroadcastChannel(e),p=s(),{serviceWorker:i}=o;return(s,...c)=>{const d=p();a.postMessage([d,s],...c);const m=new XMLHttpRequest;return m.open("POST",i,!1),m.setRequestHeader("Content-Type","application/json"),m.send(n([d,e])),t.set(r(m.responseText),0),o.ondata(t.subarray(2,2+t[1]))}})(p,new Int32Array(o),t({...a,...e}))));export{p as channel,i as default};

package/dist/xhr.js

@@ -0,0 +1 @@
+const e=Promise.withResolvers||function(){var e,t,s=new this((s,n)=>{e=s,t=n});return{resolve:e,reject:t,promise:s}};var t=e.bind(Promise),s=e=>{const t=new Int32Array(1);return()=>t[0]++},n="eac8422c-ea74-4190-9b8c-7966827497f0";const{isArray:r}=Array,a=e=>e;class o extends Worker{#e;#t;constructor(e,t){super(e,t),this.#e=s(),this.#t=new Map,t.onsend||(t.onsend=a),super.addEventListener("message",async e=>{const{data:s}=e;if(r(s)&&s[0]===n){e.stopImmediatePropagation(),e.preventDefault();const[n,r]=s[1],a=this.#t.get(n);this.#t.delete(n),a(await t.onsend(r))}})}send(e,...s){const r=this.#e(),{promise:a,resolve:o}=t();return this.#t.set(r,o),super.postMessage([n,[r,e]],...s),a}}let{SharedArrayBuffer:c}=globalThis;try{new c(4,{maxByteLength:8})}catch(e){c=class extends ArrayBuffer{get growable(){return super.resizable}grow(e){super.resize(e)}}}const i=2*Int32Array.BYTES_PER_ELEMENT,d=(e,t,s)=>{const n=new Int32Array(e);return async({data:s})=>{const r=await t.ondata(s),a=r.length,o=i+r.buffer.byteLength;e.byteLength<o&&e.grow(o),n.set(r,2),n[1]=a,n[0]=1}},l=e=>{switch(typeof e){case"symbol":case"function":return!1}return!0},u=(e,t)=>{const s={};for(const e in t){const n=t[e];l(e)&&l(n)&&(s[e]=n)}return[e,s]},p=(e,t,s)=>{const n=new URL(e,location.href);return n.searchParams.set("reflected",t),[n,{...s,type:"module"}]};var g=({initByteLength:e=1024,maxByteLength:t=8192})=>new c(i+e,{maxByteLength:i+t});let h=!0;try{crypto.randomUUID()}catch(e){h=!1}const y=h?()=>crypto.randomUUID():()=>(Date.now()+Math.random()).toString(36),w="async";let f=class extends o{constructor(e,t,s){const n=y(),r=new BroadcastChannel(n),a=g(t),o=new Int32Array(a),c=d(a,t);r.addEventListener("message",async({data:[e,t]})=>{await c({data:t}),r.postMessage([e,o.slice(0,2+o[1])])}),super(...p(e,w,t)),super.addEventListener("message",()=>s(this),{once:!0}),super.postMessage(u(a,t).concat(n))}get channel(){return w}};const m=new Map,v=new BroadcastChannel(n);v.addEventListener("message",async({data:[e,t]})=>{if("request"===e){const[e,[s,n]]=t,r=m.get(n);if(r){const t=r.get(s);t&&(r.delete(s),v.postMessage(["response",[e,await t]]))}}});const{promise:L,resolve:x}=t();let E=!0;const M=(e,t)=>{let s,n=!0,{url:r}=t;e.getRegistration(r).then(s=>s??e.register(r,t)).then(function a(o){const{controller:c}=e;if(n=n&&!!c,s=o.installing||o.waiting||o.active,!s)return M(e,t);if("activated"===s.state){if(n){if(c.scriptURL===r)return x();o.unregister()}location.reload()}else s.addEventListener("statechange",()=>a(o),{once:!0})})};let A=class extends o{#s;constructor(e,s,n){if(E){E=!1;let{serviceWorker:t}=s;if(!t)return new f(e,s,n);"string"==typeof t&&(t={url:t}),t.url=new URL(t.url,location.href).href,M(navigator.serviceWorker,t)}const r=y(),a=new BroadcastChannel(r),o=g(s),c=new Map,i=new Int32Array(o),l=d(o,s);m.set(r,c),a.addEventListener("message",async({data:[e,s]})=>{const{promise:n,resolve:r}=t();c.set(e,n),await l({data:s}),r(i.slice(0,2+i[1]))}),super(...p(e,"xhr",s)),super.addEventListener("message",()=>n(this),{once:!0}),super.postMessage(u(o,s).concat(r)),this.#s=r}terminate(){m.delete(this.#s),super.terminate()}get channel(){return"xhr"}};const{isArray:b}=Array;const{parse:B,stringify:I}=JSON,{promise:q,resolve:R}=t();addEventListener("message",({data:[e,t,s]})=>R([e,t,s]),{once:!0});const P="xhr";var T="importScripts"in globalThis?e=>q.then(([t,r,a])=>(postMessage(1),((e,t,n)=>{const r=new BroadcastChannel(e),a=s(),{serviceWorker:o}=n;return(s,...c)=>{const i=a();r.postMessage([i,s],...c);const d=new XMLHttpRequest;return d.open("POST",o,!1),d.setRequestHeader("Content-Type","application/json"),d.send(I([i,e])),t.set(B(d.responseText),0),n.ondata(t.subarray(2,2+t[1]))}})(a,new Int32Array(t),(e=>(addEventListener("message",async t=>{const{data:s}=t;if(b(s)&&s[0]===n){t.stopImmediatePropagation(),t.preventDefault();const[r,a]=s[1];postMessage([n,[r,await e.onsend(a)]])}}),e))({...r,...e})))):(e,s)=>{const{promise:n,resolve:r}=t();return new A(e,s,r)instanceof f?n:L.then(()=>n)};export{P as channel,T as default};

package/package.json

@@ -1,16 +1,93 @@
 {
   "name": "reflected",
-  "version": "0.0.0",
-  "description": "",
-  "main": "index.js",
+  "version": "0.0.1",
+  "description": "A primitive to allow workers to call synchronously any functionality exposed on the main thread.",
+  "exports": {
+    ".": {
+      "import": "./src/index.js",
+      "types": "./types/index.d.ts"
+    },
+    "./async": {
+      "import": "./src/async.js",
+      "types": "./types/async.d.ts"
+    },
+    "./broadcast": {
+      "import": "./src/broadcast.js",
+      "types": "./types/broadcast.d.ts"
+    },
+    "./message": {
+      "import": "./src/message.js",
+      "types": "./types/message.d.ts"
+    },
+    "./xhr": {
+      "import": "./src/xhr.js",
+      "types": "./types/xhr.d.ts"
+    },
+    "./main/async": {
+      "import": "./src/main/async.js",
+      "types": "./types/main/async.d.ts"
+    },
+    "./main/broadcast": {
+      "import": "./src/main/broadcast.js",
+      "types": "./types/main/broadcast.d.ts"
+    },
+    "./main/message": {
+      "import": "./src/main/message.js",
+      "types": "./types/main/message.d.ts"
+    },
+    "./main/xhr": {
+      "import": "./src/main/xhr.js",
+      "types": "./types/main/xhr.d.ts"
+    },
+    "./worker/async": {
+      "import": "./src/worker/async.js",
+      "types": "./types/worker/async.d.ts"
+    },
+    "./worker/broadcast": {
+      "import": "./src/worker/broadcast.js",
+      "types": "./types/worker/broadcast.d.ts"
+    },
+    "./worker/message": {
+      "import": "./src/worker/message.js",
+      "types": "./types/worker/message.d.ts"
+    },
+    "./worker/xhr": {
+      "import": "./src/worker/xhr.js",
+      "types": "./types/worker/xhr.d.ts"
+    },
+    "./package.json": "./package.json"
+  },
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "build": "rm -rf dist && rollup -c rollup.js && cp dist/sw.js test/sw.js && npm run types",
+    "types": "tsc --allowJs --checkJs --lib dom,esnext --module nodeNext --target esnext -d --emitDeclarationOnly --outDir ./types ./src/*.js ./src/*/*.js"
   },
   "keywords": [],
-  "author": "",
-  "license": "ISC",
-  "type": "commonjs",
+  "author": "Andrea Giammarchi",
+  "license": "MIT",
+  "type": "module",
+  "types": "./types/index.d.ts",
+  "main": "./dist/index.js",
+  "module": "./src/index.js",
   "dependencies": {
-    "@webreflection/utils": "^0.1.2"
-  }
+    "@webreflection/utils": "^0.1.2",
+    "next-resolver": "^0.1.6",
+    "typescript": "^5.9.3",
+    "weak-id": "^0.2.1"
+  },
+  "devDependencies": {
+    "@rollup/plugin-node-resolve": "^16.0.3",
+    "@rollup/plugin-terser": "^0.4.4",
+    "rollup": "^4.57.1"
+  },
+  "directories": {
+    "test": "test"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/WebReflection/reflected.git"
+  },
+  "bugs": {
+    "url": "https://github.com/WebReflection/reflected/issues"
+  },
+  "homepage": "https://github.com/WebReflection/reflected#readme"
 }

package/rollup.js

@@ -0,0 +1,59 @@
+import { nodeResolve } from '@rollup/plugin-node-resolve';
+import terser from '@rollup/plugin-terser';
+
+import { writeFileSync } from 'fs';
+
+writeFileSync(`./src/channel.js`, `export default '${crypto.randomUUID()}';`);
+
+const plugins = [nodeResolve()].concat(process.env.NO_MIN ? [] : [terser()]);
+
+export default [
+  {
+    plugins,
+    input: './src/index.js',
+    output: {
+      esModule: true,
+      dir: './dist'
+    }
+  },
+  {
+    plugins,
+    input: './src/broadcast.js',
+    output: {
+      esModule: true,
+      dir: './dist'
+    }
+  },
+  {
+    plugins,
+    input: './src/message.js',
+    output: {
+      esModule: true,
+      dir: './dist'
+    }
+  },
+  {
+    plugins,
+    input: './src/xhr.js',
+    output: {
+      esModule: true,
+      dir: './dist'
+    }
+  },
+  {
+    plugins,
+    input: './src/async.js',
+    output: {
+      esModule: true,
+      dir: './dist'
+    }
+  },
+  {
+    plugins,
+    input: './src/service/worker.js',
+    output: {
+      esModule: true,
+      file: './dist/sw.js'
+    }
+  },
+];

package/src/async.js

@@ -0,0 +1,8 @@
+import main from './main/async.js';
+import worker from './worker/async.js';
+
+export { channel } from './worker/async.js';
+
+export default (
+  'importScripts' in globalThis ? worker : main
+);

package/src/broadcast.js

@@ -0,0 +1,8 @@
+import main from './main/broadcast.js';
+import worker from './worker/broadcast.js';
+
+export { channel } from './worker/broadcast.js';
+
+export default (
+  'importScripts' in globalThis ? worker : main
+);

package/src/channel.js

@@ -0,0 +1 @@
+export default 'eac8422c-ea74-4190-9b8c-7966827497f0';

package/src/index.js

@@ -1,20 +1,29 @@
-import { native } from '/node_modules/@webreflection/utils/src/shared-array-buffer.js';
-import withResolvers from '/node_modules/@webreflection/utils/src/with-resolvers.js';
+import withResolvers from '@webreflection/utils/with-resolvers';
+import { native } from '@webreflection/utils/shared-array-buffer';
 
+/** @type {string} */
+let channel;
+
+/** @type {Function} */
 let module;
 
 if ('importScripts' in globalThis) {
   let get;
   const { promise, resolve } = withResolvers();
+  // @ts-ignore
   const reflected = new URL(location).searchParams.get('reflected');
-  if (reflected === 'chrome') get = import('./worker/chrome.js');
-  else if (reflected === 'firefox') get = import('./worker/firefox.js');
-  else if (reflected === 'fallback') get = import('./worker/fallback.js');
+  channel = reflected;
+  if (reflected === 'message') get = import(/* webpackIgnore: true */'./worker/message.js');
+  else if (reflected === 'broadcast') get = import(/* webpackIgnore: true */'./worker/broadcast.js');
+  else if (reflected === 'xhr') get = import(/* webpackIgnore: true */'./worker/xhr.js');
+  else get = import(/* webpackIgnore: true */'./worker/async.js');
   module = async options => {
     const { data, ports } = await promise;
     const { default: reflect } = await get;
     const event = new Event('message');
+    // @ts-ignore
     event.data = data;
+    // @ts-ignore
     event.ports = ports;
     dispatchEvent(event);
     return reflect(options);
@@ -22,13 +31,24 @@ if ('importScripts' in globalThis) {
   addEventListener('message', resolve, { once: true });
 }
 else if (native) {
-  if ('InstallTrigger' in globalThis)
-    module = (await import('./main/firefox.js')).default;
-  else
-    module = (await import('./main/chrome.js')).default;
+  if ('InstallTrigger' in globalThis) {
+    channel = 'broadcast';
+    module = (await import(/* webpackIgnore: true */'./main/broadcast.js')).default;
+  }
+  else {
+    channel = 'message';
+    module = (await import(/* webpackIgnore: true */'./main/message.js')).default;
+  }
+}
+else if (navigator.serviceWorker) {
+  channel = 'xhr';
+  module = (await import(/* webpackIgnore: true */'./main/xhr.js')).default;
 }
 else {
-  module = (await import('./main/fallback.js')).default;
+  channel = 'fallback';
+  module = () => {};
 }
 
+export { channel };
+
 export default module;

package/src/main/async.js

@@ -0,0 +1,29 @@
+import Sender from './sender.js';
+import SAB from './sab.js';
+import { bootstrap, handler, post, url } from './shared.js';
+import { randomUUID } from '../shared.js';
+
+const CHANNEL = 'async';
+
+export class Worker extends Sender {
+  constructor(scriptURL, options, resolve) {
+    const channel = randomUUID();
+    const bc = new BroadcastChannel(channel);
+    const sab = SAB(options);
+    const i32a = new Int32Array(sab);
+    const handle = handler(sab, options, false);
+    bc.addEventListener('message', async ({ data: [id, data] }) => {
+      await handle({ data });
+      bc.postMessage([id, i32a.slice(0, 2 + i32a[1])]);
+    });
+    super(...url(scriptURL, CHANNEL, options));
+    super.addEventListener('message', () => resolve(this), { once: true });
+    super.postMessage(post(sab, options).concat(channel));
+  }
+
+  get channel() {
+    return CHANNEL;
+  }
+};
+
+export default bootstrap(Worker);

package/src/main/broadcast.js

@@ -0,0 +1,21 @@
+import Sender from './sender.js';
+import { SAB, bootstrap, handler, post, url } from './shared.js';
+import { randomUUID } from '../shared.js';
+
+const CHANNEL = 'broadcast';
+
+export default bootstrap(class Worker extends Sender {
+  constructor(scriptURL, options, resolve) {
+    const channel = randomUUID();
+    const bc = new BroadcastChannel(channel);
+    const sab = SAB(options);
+    bc.addEventListener('message', handler(sab, options, true));
+    super(...url(scriptURL, CHANNEL, options));
+    super.addEventListener('message', () => resolve(this), { once: true });
+    super.postMessage(post(sab, options).concat(channel));
+  }
+
+  get channel() {
+    return CHANNEL;
+  }
+});

package/src/main/message.js

@@ -0,0 +1,20 @@
+import Sender from './sender.js';
+import { SAB, bootstrap, handler, post, url } from './shared.js';
+
+const CHANNEL = 'message';
+
+export default bootstrap(class Worker extends Sender {
+  constructor(scriptURL, options, resolve) {
+    const { port1, port2 } = new MessageChannel;
+    const sab = SAB(options);
+    port1.addEventListener(CHANNEL, handler(sab, options, true));
+    port1.start();
+    super(...url(scriptURL, CHANNEL, options));
+    super.addEventListener(CHANNEL, () => resolve(this), { once: true });
+    super.postMessage(post(sab, options), [port2]);
+  }
+
+  get channel() {
+    return CHANNEL;
+  }
+});

package/src/main/sab.js

@@ -0,0 +1,12 @@
+import { SharedArrayBuffer } from '@webreflection/utils/shared-array-buffer';
+
+import { minByteLength } from './shared.js';
+
+export default ({
+  initByteLength = 1024,
+  maxByteLength = (1024 * 8)
+}) =>
+  new SharedArrayBuffer(
+    minByteLength + initByteLength,
+    { maxByteLength: minByteLength + maxByteLength }
+  );

package/src/main/sender.js

@@ -0,0 +1,38 @@
+import withResolvers from '@webreflection/utils/with-resolvers';
+import i32 from 'weak-id/i32';
+
+import SHARED_CHANNEL from '../channel.js';
+
+const { isArray } = Array;
+
+const onsend = value => value;
+
+export default class Sender extends Worker {
+  #next;
+  #requests;
+  constructor(scriptURL, options) {
+    super(scriptURL, options);
+    this.#next = i32();
+    this.#requests = new Map;
+    if (!options.onsend) options.onsend = onsend;
+    super.addEventListener('message', async event => {
+      const { data } = event;
+      if (isArray(data) && data[0] === SHARED_CHANNEL) {
+        event.stopImmediatePropagation();
+        event.preventDefault();
+        const [id, payload] = data[1];
+        const resolve = this.#requests.get(id);
+        this.#requests.delete(id);
+        resolve(await options.onsend(payload));
+      }
+    });
+  }
+
+  send(payload, ...rest) {
+    const id = this.#next();
+    const { promise, resolve } = withResolvers();
+    this.#requests.set(id, resolve);
+    super.postMessage([SHARED_CHANNEL, [id, payload]], ...rest);
+    return promise;
+  }
+}