reflected 0.0.0 → 0.0.2

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,144 @@
+# reflected
+
+A primitive to allow workers to call **synchronously** any functionality exposed on the main thread.
+
+## Strategies
+
+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, for 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 according to the chosen "*channel strategy*".
+
+| Import | Use case |
+|--------|----------|
+| `reflected` | Auto-pick strategy (main + worker) |
+| `reflected/message` \| `broadcast` \| `xhr` \| `async` | Specific strategy, context-aware |
+| `reflected/main/<strategy>` | Main thread only (smaller bundle) |
+| `reflected/worker/<strategy>` | Worker only (smaller bundle) |
+
+**Requirements:** Synchronous strategies except for `xhr` need [Cross-Origin Isolation](https://developer.mozilla.org/en-US/docs/Web/API/Window/crossOriginIsolated) (e.g. `Cross-Origin-Opener-Policy: same-origin` and `Cross-Origin-Embedder-Policy: require-corp`). The `async` strategy works without those headers and always returns a Promise.
+
+### 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
+  onsync(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);
+  },
+});
+
+// retrieve 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 to top-level await
+  {
+    // invoked when the worker asks to synchronize a call
+    // and it must 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 onsync(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' });
+```
+
+### Extras
+
+- **Named export `channel`:** After initialization, `import reflect, { channel } from 'reflected'` gives the active strategy name (`'message'`, `'broadcast'`, `'xhr'`, or `'async'`).
+- **Errors:** From main-thread `onsync`, return `new Int32Array(0)` (or a convention of your choice) so the worker always gets a result; handle that in the worker’s `onsync` to avoid hanging.
+- **Types:** you can import `MainOptions` and `WorkerOptions` from the root of the porject because *main* `reflect(string, MainOptions)` and *worker* `reflect(WorkerOptions)` are different in a subtle way you probably don't want to mess around with (in particular, the `onsync` which must be sync on the *worker* side of affairs or it cannnot work)
+
+Test [live](https://webreflection.github.io/reflected/test/README/) or read the [main thread](./test/README/index.js) and [worker thread](./test/README/worker.js) code.

package/dist/async-DF1WaSCr.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-BMLGKAss.js";import"./channel-CdS9bLt4.js";const{promise:r,resolve:a}=e();addEventListener("message",({data:[e,s,t]})=>a([e,s,t]),{once:!0});const n="async";var o=a=>r.then(([r,n,o])=>(postMessage(1),((t,r,a)=>{const n=new BroadcastChannel(t),o=s(),d=new Map;return n.addEventListener("message",({data:[e,s]})=>{r.set(s,0),d.get(e)(a.onsync(r.subarray(2,2+r[1]))),d.delete(e)}),(s,...t)=>{const{promise:r,resolve:a}=e(),i=o();return d.set(i,a),n.postMessage([i,s],...t),r}})(o,new Int32Array(r),t({...n,...a}))));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="fc260aad-4404-43b8-ae9d-2c06554bb294";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),y="async";var g=(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.onsync(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,y,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 y}});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]})=>{n.set(t,0),c.get(e)(r.onsync(n.subarray(2,2+n[1]))),c.delete(e)}),(e,...s)=>{const{promise:n,resolve:r}=t(),i=o();return c.set(i,r),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})))):g;export{w as channel,f as default};

package/dist/broadcast-D0xibjmN.js

@@ -0,0 +1 @@
+import{b as s,S as e,a,h as r,u as t,p as n}from"./shared-MkVjuKUg.js";import{r as o}from"./shared-RFmxa5x4.js";import"./with-resolvers-CHEvl4oe.js";import"./i32-C78nBJH2.js";import"./channel-CdS9bLt4.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-Dc7wAEE6.js

@@ -0,0 +1 @@
+import{w as r}from"./with-resolvers-CHEvl4oe.js";import{h as s}from"./shared-C_kd5Il-.js";import"./sender-BMLGKAss.js";import"./channel-CdS9bLt4.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="fc260aad-4404-43b8-ae9d-2c06554bb294";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),y="broadcast";var h=(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.onsync(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,y,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 y}});const{isArray:m}=Array;const{load:g,store:l,wait:w}=Atomics,{promise:f,resolve:v}=t(),b="broadcast";var L=((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.onsync(t.subarray(2,2+g(t,1)))))(r,new Int32Array(e),(e=>(addEventListener("message",async t=>{const{data:n}=t;if(m(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)])),A="importScripts"in globalThis?L:h;export{b as channel,A as default};

package/dist/channel-CdS9bLt4.js

@@ -0,0 +1 @@
+var a="fc260aad-4404-43b8-ae9d-2c06554bb294";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-D7s0I-EX.js"):"broadcast"===i?import("./broadcast-Dc7wAEE6.js"):"xhr"===i?import("./xhr-D5y-AocB.js"):import("./async-DF1WaSCr.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-D0xibjmN.js")).default):(e="message",t=(await import("./message-DLH7cJo6.js")).default):navigator.serviceWorker?(e="xhr",t=(await import("./xhr-DAG_4oRo.js")).default):(e="fallback",t=()=>{});var r=t;export{e as channel,r as default};

package/dist/message-D7s0I-EX.js

@@ -0,0 +1 @@
+import{w as s}from"./with-resolvers-CHEvl4oe.js";import{h as r}from"./shared-C_kd5Il-.js";import"./sender-BMLGKAss.js";import"./channel-CdS9bLt4.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-DLH7cJo6.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-MkVjuKUg.js";import"./with-resolvers-CHEvl4oe.js";import"./i32-C78nBJH2.js";import"./channel-CdS9bLt4.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="fc260aad-4404-43b8-ae9d-2c06554bb294";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},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(i+e,{maxByteLength:i+t}))(t);n.addEventListener(u,((e,t)=>{const s=new Int32Array(e);return async({data:n})=>{const r=await t.onsync(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)),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:y}=Array;const{load:g,store:h,wait:m}=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),m(t,0,0),h(t,0,0),s.onsync(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}))))))(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-BMLGKAss.js

@@ -0,0 +1 @@
+import{S as a}from"./channel-CdS9bLt4.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-C_kd5Il-.js

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

package/dist/shared-MkVjuKUg.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-CdS9bLt4.js";const{isArray:r}=Array,n=e=>e;class o extends Worker{#e;#t;constructor(e,o){super(e,o),this.#e=t(),this.#t=new Map,o.onsend||(o.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 o.onsend(r))}})}send(t,...r){const n=this.#e(),{promise:o,resolve:a}=e();return this.#t.set(n,a),super.postMessage([s,[n,t]],...r),o}}const{notify:a,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:o}=e();return new t(s,r,o),n},m=(e,t,s)=>{const r=new Int32Array(e);return async({data:n})=>{const o=await t.onsync(n),u=o.length,h=c+o.buffer.byteLength;e.byteLength<h&&e.grow(h),r.set(o,2),s?(i(r,1,u),i(r,0,1),a(r,0)):(r[1]=u,r[0]=1)}},p=e=>{switch(typeof e){case"symbol":case"function":return!1}return!0},y=(e,t)=>{const s={};for(const e in t){const r=t[e];p(e)&&p(r)&&(s[e]=r)}return[e,s]},d=(e,t,s)=>{const r=new URL(e,location.href);return r.searchParams.set("reflected",t),[r,{...s,type:"module"}]};export{o as S,u as a,h as b,m as h,c as m,y as p,d as u};

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 a;do{a=e(s())}while(n.has(a));const r=t();return n.set(a,r),[a,r.promise]},(e,t,s)=>{const a=n.get(e);n.delete(e),s?a?.reject(s):a?.resolve(t)}]})(),{protocol:a,host:r,pathname:o}=location,i=`${a}//${r}${o}`,c=new BroadcastChannel("fc260aad-4404-43b8-ae9d-2c06554bb294");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-D5y-AocB.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-BMLGKAss.js";import"./channel-CdS9bLt4.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.onsync(t.subarray(2,2+t[1]))}})(p,new Int32Array(o),t({...a,...e}))));export{p as channel,i as default};

package/dist/xhr-DAG_4oRo.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-MkVjuKUg.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-CdS9bLt4.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);a&&(g.postMessage(["response",[e,await a.get(s)]]),a.delete(s))}});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.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="fc260aad-4404-43b8-ae9d-2c06554bb294";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.onsync(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 m=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 f=new Map,v=new BroadcastChannel(n);v.addEventListener("message",async({data:[e,t]})=>{if("request"===e){const[e,[s,n]]=t,r=f.get(n);r&&(v.postMessage(["response",[e,await r.get(s)]]),r.delete(s))}});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 b=class extends o{#s;constructor(e,s,n){if(E){E=!1;let{serviceWorker:t}=s;if(!t)return new m(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);f.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(){f.delete(this.#s),super.terminate()}get channel(){return"xhr"}};const{isArray:A}=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.onsync(t.subarray(2,2+t[1]))}})(a,new Int32Array(t),(e=>(addEventListener("message",async t=>{const{data:s}=t;if(A(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 b(e,s,r)instanceof m?n:L.then(()=>n)};export{P as channel,T as default};

package/package.json

@@ -1,16 +1,97 @@
 {
   "name": "reflected",
-  "version": "0.0.0",
-  "description": "",
-  "main": "index.js",
+  "version": "0.0.2",
+  "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",
+  "keywords": [
+    "worker",
+    "SharedArrayBuffer",
+    "synchronous"
+  ],
+  "author": "Andrea Giammarchi (webreflection)",
+  "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';
+if (process.env.NEW_CHANNEL)
+  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 'fc260aad-4404-43b8-ae9d-2c06554bb294';

package/src/index.js

@@ -1,20 +1,32 @@
-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';
 
+/** @typedef {import('./main/shared.js').Options} MainOptions */
+/** @typedef {import('./worker/shared.js').Options} WorkerOptions */
+
+/** @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 +34,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, payload] }) => {
+      await handle({ data: payload });
+      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 }
+  );