reflected 0.1.3 → 0.1.5

package/src/ffi/worker.js

@@ -1,24 +0,0 @@
-import remote from 'reflected-ffi/remote';
-
-import worker from '../index.js';
-
-/**
- * @param {import('../index.js').WorkerOptions & import('reflected-ffi/remote').RemoteOptions} options
- */
-export default async options => {
-  const reflected = await worker({
-    ...options,
-    onsync: args => args,
-    // @ts-ignore
-    onsend: args => ffi.reflect(...args),
-  });
-
-  const ffi = remote({
-    timeout: 0,
-    buffer: true,
-    ...options,
-    reflect: (...args) => reflected(args),
-  });
-
-  return ffi;
-};

package/src/index.js

@@ -1,57 +0,0 @@
-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');
-  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);
-  };
-  addEventListener('message', resolve, { once: true });
-}
-else if (native) {
-  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 {
-  channel = 'async';
-  module = (await import(/* webpackIgnore: true */'./main/async.js')).default;
-}
-
-export { channel };
-
-export default module;

package/src/main/async.js

@@ -1,29 +0,0 @@
-import Sender from './sender.js';
-import SAB from './sab.js';
-import { bootstrap, handler, post, url } from './shared.js';
-import { byteOffset, 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, new Uint8Array(sab, byteOffset, 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

@@ -1,21 +0,0 @@
-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

@@ -1,20 +0,0 @@
-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

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

package/src/main/sender.js

@@ -1,38 +0,0 @@
-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.length === 2 && 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;
-  }
-}

package/src/main/shared.js

@@ -1,99 +0,0 @@
-import withResolvers from '@webreflection/utils/with-resolvers';
-import { encoder } from 'reflected-ffi/encoder';
-
-import { byteOffset } from '../shared.js';
-
-const { notify, store } = Atomics;
-
-export const SAB = ({
-  initByteLength = 1024,
-  maxByteLength = (1024 * 8)
-}) =>
-  new SharedArrayBuffer(
-    byteOffset + initByteLength,
-    { maxByteLength: byteOffset + maxByteLength }
-  );
-
-/**
- * @typedef {Object} ServiceWorkerOptions see https://developer.mozilla.org/en-US/docs/Web/API/ServiceWorkerContainer/register#options
- * @property {string} [url] will use the `serviceWorker` value if that is a `string`, otherwise it refers to where the service worker file is located.
- * @property {'classic' | 'module'} [type]
- * @property {'all' | 'imports' | 'none'} [updateViaCache]
- */
-
-/**
- * @typedef {Object} Options
- * @property {(payload: unknown) => Int32Array | Promise<Int32Array>} onsync invoked when the worker expect a response as `Int32Array` to populate the SharedArrayBuffer with.
- * @property {(payload: unknown) => unknown | Promise<unknown>} [onsend] invoked when the worker replies to a `worker.send(data)` call.
- * @property {number} [initByteLength=1024] defines the initial byte length of the SharedArrayBuffer.
- * @property {number} [maxByteLength=8192] defines the maximum byte length (growth) of the SharedArrayBuffer.
- * @property {string | ServiceWorkerOptions} [serviceWorker] defines the service worker to use as fallback if SharedArrayBuffer is not supported. If not defined, the `async` fallback will be used so that no `sync` operations from the worker will be possible.
- * @property {import('reflected-ffi/encoder').encoder} [encoder] defines the encoder function to use to encode the result into the SharedArrayBuffer.
- */
-
-/**
- * Initialize the worker channel communication and resolves with the worker instance.
- * @template T
- * @param {T} Worker
- * @returns
- */
-export const bootstrap = Worker => {
-  /**
-   * @param {string} scriptURL
-   * @param {Options} options
-   * @returns
-   */
-  return (scriptURL, options) => {
-    const { promise, resolve } = withResolvers();
-    // @ts-ignore
-    new Worker(scriptURL, options, resolve);
-    return /** @type {Promise<T>} */(promise);
-  };
-};
-
-export const handler = (sab, options, useAtomics) => {
-  const i32a = new Int32Array(sab);
-  const encode = (options.encoder ?? encoder)({ byteOffset });
-
-  const resolve = useAtomics ?
-    (length => {
-      store(i32a, 1, length);
-      store(i32a, 0, 1);
-      notify(i32a, 0);
-    }) :
-    (length => {
-      i32a[1] = length;
-      i32a[0] = 1;
-    });
-
-  const process = result => {
-    const length = encode(result, sab);
-    return typeof length === 'number' ? resolve(length) : length.then(resolve);
-  };
-
-  return async ({ data }) => process(await options.onsync(data));
-};
-
-const isOK = value => {
-  switch (typeof value) {
-    case 'symbol':
-    case 'function':
-      return false;
-  }
-  return true;
-};
-
-export const post = (sab, options) => {
-  const opts = {};
-  for (const key in options) {
-    const value = options[key];
-    if (isOK(key) && isOK(value)) opts[key] = value;
-  }
-  return [sab, opts];
-};
-
-export const url = (scriptURL, reflected, options) => {
-  const url = new URL(scriptURL, location.href);
-  url.searchParams.set('reflected', reflected);
-  return [url, { ...options, type: 'module' }];
-};

package/src/main/xhr.js

@@ -1,102 +0,0 @@
-import withResolvers from '@webreflection/utils/with-resolvers';
-import { Worker as AsyncWorker } from './async.js';
-
-import SHARED_CHANNEL from '../channel.js';
-import SAB from './sab.js';
-import Sender from './sender.js';
-
-import { handler, post, url } from './shared.js';
-import { byteOffset, randomUUID } from '../shared.js';
-
-const CHANNEL = 'xhr';
-
-const channels = new Map;
-
-const sharedBC = new BroadcastChannel(SHARED_CHANNEL);
-sharedBC.addEventListener('message', async ({ data: [op, details] }) => {
-  if (op === 'request') {
-    const [uid, [id, channel]] = details;
-    const responses = channels.get(channel);
-    if (responses) {
-      const promise = responses.get(id);
-      responses.delete(id);
-      sharedBC.postMessage(['response', [uid, await promise]]);
-    }
-  }
-});
-
-const { promise: sw, resolve } = withResolvers();
-let init = true;
-
-const activate = (swc, options) => {
-  let w, c = true, { url } = options;
-  swc.getRegistration(url)
-    .then(r => (r ?? swc.register(url, options)))
-    .then(function ready(r) {
-      const { controller } = swc;
-      c = c && !!controller;
-      w = (r.installing || r.waiting || r.active);
-      if (!w) return activate(swc, options);
-      if (w.state === 'activated') {
-        if (c) {
-          // allow ServiceWorker swap on different URL
-          if (controller.scriptURL === url)
-            return resolve();
-          r.unregister();
-        }
-        location.reload();
-      }
-      else {
-        w.addEventListener('statechange', () => ready(r), { once: true });
-      }
-    });
-};
-
-class Worker extends Sender {
-  #channel;
-  constructor(scriptURL, options, resolve) {
-    if (init) {
-      init = false;
-      let { serviceWorker } = options;
-      if (!serviceWorker) {
-        // @ts-ignore
-        return new AsyncWorker(scriptURL, options, resolve);
-      }
-      if (typeof serviceWorker === 'string') serviceWorker = { url: serviceWorker };
-      serviceWorker.url = new URL(serviceWorker.url, location.href).href;
-      activate(navigator.serviceWorker, serviceWorker);
-    }
-    const channel = randomUUID();
-    const bc = new BroadcastChannel(channel);
-    const sab = SAB(options);
-    const responses = new Map;
-    const i32a = new Int32Array(sab);
-    const handle = handler(sab, options, false);
-    channels.set(channel, responses);
-    bc.addEventListener('message', async ({ data: [id, payload] }) => {
-      const { promise, resolve } = withResolvers();
-      responses.set(id, promise);
-      await handle({ data: payload });
-      resolve(new Uint8Array(sab, byteOffset, i32a[1]));
-    });
-    super(...url(scriptURL, CHANNEL, options));
-    super.addEventListener('message', () => resolve(this), { once: true });
-    super.postMessage(post(sab, options).concat(channel));
-    this.#channel = channel;
-  }
-
-  terminate() {
-    channels.delete(this.#channel);
-    super.terminate();
-  }
-
-  get channel() {
-    return CHANNEL;
-  }
-};
-
-export default (scriptURL, options) => {
-  const { promise, resolve } = withResolvers();
-  const worker = new Worker(scriptURL, options, resolve);
-  return worker instanceof AsyncWorker ? promise : sw.then(() => promise);
-};

package/src/message.js

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

package/src/service/listeners.js

@@ -1,47 +0,0 @@
-import CHANNEL from '../channel.js';
-
-import nextResolver from 'next-resolver';
-
-const [next, resolve] = nextResolver();
-
-const { protocol, host, pathname } = location;
-const url = `${protocol}//${host}${pathname}`;
-
-const bc = new BroadcastChannel(CHANNEL);
-bc.addEventListener('message', ({ data: [op, details] }) => {
-  if (op === 'response') {
-    const [uid, payload] = details;
-    resolve(uid, `[${payload.join(',')}]`);
-  }
-});
-
-const response = {
-  status: 200,
-  statusText: 'OK',
-  headers: new Headers({
-    'Cache-Control': 'no-cache, must-revalidate',
-    'Expires': 'Mon, 26 Jul 1997 05:00:00 GMT',
-    'Content-type': 'application/json',
-  })
-};
-
-const respond = async details => {
-  const [uid, promise] = next();
-  bc.postMessage(['request', [uid, details]]);
-  return new Response(await promise, response);
-};
-
-// @ts-ignore
-export const activate = event => event.waitUntil(clients.claim());
-
-export const fetch = async event => {
-  const { request: r } = event;
-  if (r.method === 'POST' && r.url.startsWith(url)) {
-    event.stopImmediatePropagation();
-    event.respondWith(r.json().then(respond));
-    event.preventDefault();
-  }
-};
-
-// @ts-ignore
-export const install = () => skipWaiting();

package/src/service/worker.js

@@ -1,5 +0,0 @@
-import { activate, fetch, install } from './listeners.js';
-
-addEventListener('activate', activate);
-addEventListener('fetch', fetch);
-addEventListener('install', install);

package/src/shared.js

@@ -1,12 +0,0 @@
-export const byteOffset = Int32Array.BYTES_PER_ELEMENT * 2;
-
-let hasRandomUUID = true;
-try {
-  crypto.randomUUID();
-} catch (_) {
-  hasRandomUUID = false;
-}
-
-export const randomUUID = hasRandomUUID ?
-  (() => crypto.randomUUID() ):
-  (() => (Date.now() + Math.random()).toString(36));

package/src/worker/async.js

@@ -1,40 +0,0 @@
-import withResolvers from '@webreflection/utils/with-resolvers';
-import { decoder } from 'reflected-ffi/decoder';
-import i32 from 'weak-id/i32';
-
-import sender from './sender.js';
-import { byteOffset } from '../shared.js';
-
-const { promise, resolve } = withResolvers();
-
-addEventListener(
-  'message',
-  ({ data: [_, main, channel] }) => resolve([main, channel]),
-  { once: true }
-);
-
-export const channel = 'async';
-
-const handle = (channel, options) => {
-  const bc = new BroadcastChannel(channel);
-  const next = i32();
-  const decode = (options.decoder ?? decoder)({ byteOffset });
-  const map = new Map;
-  bc.addEventListener('message', ({ data: [id, { length, buffer }] }) => {
-    map.get(id)(options.onsync(length ? decode(length, buffer) : void 0));
-    map.delete(id);
-  });
-  return (payload, ...rest) => {
-    const { promise, resolve } = withResolvers();
-    const id = next();
-    map.set(id, resolve);
-    // @ts-ignore
-    bc.postMessage([id, payload], ...rest);
-    return promise;
-  };
-};
-
-export default options => promise.then(([main, channel]) => {
-  postMessage(1);
-  return handle(channel, sender({ ...main, ...options }));
-});

package/src/worker/broadcast.js

@@ -1,11 +0,0 @@
-import withResolvers from '@webreflection/utils/with-resolvers';
-import { handler } from './shared.js';
-
-const { promise, resolve } = withResolvers();
-
-export const channel = 'broadcast';
-
-export default handler(
-  promise,
-  ({ data: [sab, main, channel] }) => resolve([sab, main, new BroadcastChannel(channel)]),
-);

package/src/worker/message.js

@@ -1,11 +0,0 @@
-import withResolvers from '@webreflection/utils/with-resolvers';
-import { handler } from './shared.js';
-
-const { promise, resolve } = withResolvers();
-
-export const channel = 'message';
-
-export default handler(
-  promise,
-  ({ data: [sab, main], ports: [channel] }) => resolve([sab, main, channel])
-);

package/src/worker/sender.js

@@ -1,16 +0,0 @@
-import SHARED_CHANNEL from '../channel.js';
-
-const { isArray } = Array;
-
-export default options => {
-  addEventListener('message', async event => {
-    const { data } = event;
-    if (isArray(data) && data[0] === SHARED_CHANNEL) {
-      event.stopImmediatePropagation();
-      event.preventDefault();
-      const [id, payload] = data[1];
-      postMessage([SHARED_CHANNEL, [id, await options.onsend(payload)]]);
-    }
-  });
-  return options;
-};

package/src/worker/shared.js

@@ -1,52 +0,0 @@
-import { decoder } from 'reflected-ffi/decoder';
-
-import sender from './sender.js';
-import { byteOffset } from '../shared.js';
-
-const { load, store, wait } = Atomics;
-
-/**
- * @typedef {Object} Options
- * @property {(payload: Int32Array) => unknown} onsync transforms the resulting `Int32Array` from *main* thread into a value usable within the worker.
- * @property {(payload: unknown) => unknown |Promise<unknown>} onsend invoked to define what to return to the *main* thread when it calls `worker.send(payload)`.
- * @property {import('reflected-ffi/decoder').decoder} [decoder] defines the decoder function to use to decode the result from the SharedArrayBuffer.
- */
-
-/**
- * @param {MessageChannel | BroadcastChannel} channel
- * @param {Int32Array} i32a
- * @param {Options} options
- * @returns {(payload: unknown, ...rest: unknown[]) => unknown}
- */
-const handle = (channel, i32a, options) => {
-  const decode = (options.decoder ?? decoder)({ byteOffset });
-  const { buffer } = i32a;
-  return (payload, ...rest) => {
-    // @ts-ignore
-    channel.postMessage(payload, ...rest);
-    wait(i32a, 0, 0);
-    store(i32a, 0, 0);
-    const length = load(i32a, 1);
-    return options.onsync(length ? decode(length, buffer) : void 0);
-  };
-};
-
-/**
- * 
- * @param {Promise<[SharedArrayBuffer, Options, MessageChannel | BroadcastChannel]>} promise
- * @param {(event:MessageEvent) => void} listener
- * @returns
- */
-export const handler = (promise, listener) => {
-  addEventListener('message', listener, { once: true });
-  /**
-   * @param {Options} options
-   * @returns
-   */
-  return options => promise.then(
-    ([sab, main, channel]) => {
-      postMessage(1);
-      return handle(channel, new Int32Array(sab), sender({ ...main, ...options }));
-    }
-  );
-};

package/src/worker/xhr.js

@@ -1,40 +0,0 @@
-import withResolvers from '@webreflection/utils/with-resolvers';
-import { decoder } from 'reflected-ffi/decoder';
-import i32 from 'weak-id/i32';
-
-import sender from './sender.js';
-
-const { parse, stringify } = JSON;
-
-const { promise, resolve } = withResolvers();
-
-addEventListener(
-  'message',
-  ({ data: [_, main, channel] }) => resolve([main, channel]),
-  { once: true }
-);
-
-export const channel = 'xhr';
-
-const handle = (channel, options) => {
-  const bc = new BroadcastChannel(channel);
-  const next = i32();
-  const decode = (options.decoder ?? decoder)({ byteOffset: 0 });
-  const { serviceWorker } = options;
-  return (payload, ...rest) => {
-    const id = next();
-    // @ts-ignore
-    bc.postMessage([id, payload], ...rest);
-    const xhr = new XMLHttpRequest;
-    xhr.open('POST', serviceWorker, false);
-    xhr.setRequestHeader('Content-Type', 'application/json');
-    xhr.send(stringify([id, channel]));
-    const { length, buffer } = new Uint8Array(parse(xhr.responseText));
-    return options.onsync(length ? decode(length, buffer) : void 0);
-  };
-};
-
-export default options => promise.then(([main, channel]) => {
-  postMessage(1);
-  return handle(channel, sender({ ...main, ...options }));
-});

package/src/xhr.js

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