@kbve/droid 0.0.2 → 0.0.4

package/README.md

@@ -1,11 +1,6 @@
----
-title: droid
-description: 
----
 # Droid
 
-<img align="right" width="150" height="50" title="KBVE logo"
-     src="https://kbve.com/assets/images/brand/letter_logo.svg">
+<a href="https://kbve.com" style="float: right;"><img width="150" height="50" title="KBVE logo" src="https://kbve.com/assets/images/brand/letter_logo.svg" /></a>
 
 Droid is a lightweight manager for service workers, shared workers, and web workers in modern JavaScript and TypeScript applications.
 It simplifies the setup, communication, and lifecycle management of workers, making it easier to offload heavy computations, enable background tasks, and improve the responsiveness of your web apps.
@@ -13,6 +8,9 @@ With Droid, you can quickly integrate multi-threaded capabilities into your proj
 
 Droid provides a unified API to register, manage, and communicate with different types of web workers. Whether you are using service workers for offline support, shared workers for cross-tab communication, or web workers for parallel processing, Droid abstracts away the boilerplate and browser inconsistencies. It is designed to be framework-agnostic, making it suitable for use in vanilla JavaScript projects as well as with popular frameworks like React, Vue, or Angular. The library aims to help developers harness the power of multi-threading in the browser with simple, consistent patterns and robust error handling.
 
+<a href="https://kbve.com/application/javascript/#droid" style="float: right;"><img width="250" height="250" title="Droid WebP Logo" src="https://kbve.com/assets/images/brand/npm/droid.webp" /></a>
+
+
 ### Dependencies
 
 Droid requires a few runtime dependencies to provide its full feature set:
@@ -28,6 +26,18 @@ These dependencies are automatically installed when you add Droid to your projec
 - Optional: TypeScript for type safety and better development experience
 - Optional: Framework-specific packages if integrating with React, Vue, Angular, etc.
 
+### Support
+
+For questions, help, or to connect with the community, support can be reached via our [Discord server](https://kbve.com/discord/). Click the badge below to join and get assistance from the KBVE team and other users.
+
+[![Discord](https://img.shields.io/discord/342732838598082562?logo=discord)](https://kbve.com/discord/)
+
+
+### Examples
+
+[Discord.SH](https://discord.sh/)
+
+
 ### Chores
 
-Preparing to release next batch.
+Preparing to release next batch, trying to resolving the CDN issue, which might still be broken.

package/comlink.js

@@ -0,0 +1,253 @@
+/**
+ * @license
+ * Copyright 2019 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const M = Symbol("Comlink.proxy"), z = Symbol("Comlink.endpoint"), N = Symbol("Comlink.releaseProxy"), x = Symbol("Comlink.finalizer"), h = Symbol("Comlink.thrown"), S = (e) => typeof e == "object" && e !== null || typeof e == "function", H = {
+  canHandle: (e) => S(e) && e[M],
+  serialize(e) {
+    const { port1: t, port2: r } = new MessageChannel();
+    return R(e, t), [r, [r]];
+  },
+  deserialize(e) {
+    return e.start(), I(e);
+  }
+}, L = {
+  canHandle: (e) => S(e) && h in e,
+  serialize({ value: e }) {
+    let t;
+    return e instanceof Error ? t = {
+      isError: !0,
+      value: {
+        message: e.message,
+        name: e.name,
+        stack: e.stack
+      }
+    } : t = { isError: !1, value: e }, [t, []];
+  },
+  deserialize(e) {
+    throw e.isError ? Object.assign(new Error(e.value.message), e.value) : e.value;
+  }
+}, A = /* @__PURE__ */ new Map([
+  ["proxy", H],
+  ["throw", L]
+]);
+function V(e, t) {
+  for (const r of e)
+    if (t === r || r === "*" || r instanceof RegExp && r.test(t))
+      return !0;
+  return !1;
+}
+function R(e, t = globalThis, r = ["*"]) {
+  t.addEventListener("message", function g(n) {
+    if (!n || !n.data)
+      return;
+    if (!V(r, n.origin)) {
+      console.warn(`Invalid origin '${n.origin}' for comlink proxy`);
+      return;
+    }
+    const { id: a, type: f, path: c } = Object.assign({ path: [] }, n.data), l = (n.data.argumentList || []).map(y);
+    let s;
+    try {
+      const o = c.slice(0, -1).reduce((i, d) => i[d], e), u = c.reduce((i, d) => i[d], e);
+      switch (f) {
+        case "GET":
+          s = u;
+          break;
+        case "SET":
+          o[c.slice(-1)[0]] = y(n.data.value), s = !0;
+          break;
+        case "APPLY":
+          s = u.apply(o, l);
+          break;
+        case "CONSTRUCT":
+          {
+            const i = new u(...l);
+            s = U(i);
+          }
+          break;
+        case "ENDPOINT":
+          {
+            const { port1: i, port2: d } = new MessageChannel();
+            R(e, d), s = F(i, [i]);
+          }
+          break;
+        case "RELEASE":
+          s = void 0;
+          break;
+        default:
+          return;
+      }
+    } catch (o) {
+      s = { value: o, [h]: 0 };
+    }
+    Promise.resolve(s).catch((o) => ({ value: o, [h]: 0 })).then((o) => {
+      const [u, i] = p(o);
+      t.postMessage(Object.assign(Object.assign({}, u), { id: a }), i), f === "RELEASE" && (t.removeEventListener("message", g), T(t), x in e && typeof e[x] == "function" && e[x]());
+    }).catch((o) => {
+      const [u, i] = p({
+        value: new TypeError("Unserializable return value"),
+        [h]: 0
+      });
+      t.postMessage(Object.assign(Object.assign({}, u), { id: a }), i);
+    });
+  }), t.start && t.start();
+}
+function _(e) {
+  return e.constructor.name === "MessagePort";
+}
+function T(e) {
+  _(e) && e.close();
+}
+function I(e, t) {
+  const r = /* @__PURE__ */ new Map();
+  return e.addEventListener("message", function(n) {
+    const { data: a } = n;
+    if (!a || !a.id)
+      return;
+    const f = r.get(a.id);
+    if (f)
+      try {
+        f(a);
+      } finally {
+        r.delete(a.id);
+      }
+  }), P(e, r, [], t);
+}
+function w(e) {
+  if (e)
+    throw new Error("Proxy has been released and is not useable");
+}
+function C(e) {
+  return m(e, /* @__PURE__ */ new Map(), {
+    type: "RELEASE"
+  }).then(() => {
+    T(e);
+  });
+}
+const E = /* @__PURE__ */ new WeakMap(), b = "FinalizationRegistry" in globalThis && new FinalizationRegistry((e) => {
+  const t = (E.get(e) || 0) - 1;
+  E.set(e, t), t === 0 && C(e);
+});
+function W(e, t) {
+  const r = (E.get(t) || 0) + 1;
+  E.set(t, r), b && b.register(e, t, e);
+}
+function j(e) {
+  b && b.unregister(e);
+}
+function P(e, t, r = [], g = function() {
+}) {
+  let n = !1;
+  const a = new Proxy(g, {
+    get(f, c) {
+      if (w(n), c === N)
+        return () => {
+          j(a), C(e), t.clear(), n = !0;
+        };
+      if (c === "then") {
+        if (r.length === 0)
+          return { then: () => a };
+        const l = m(e, t, {
+          type: "GET",
+          path: r.map((s) => s.toString())
+        }).then(y);
+        return l.then.bind(l);
+      }
+      return P(e, t, [...r, c]);
+    },
+    set(f, c, l) {
+      w(n);
+      const [s, o] = p(l);
+      return m(e, t, {
+        type: "SET",
+        path: [...r, c].map((u) => u.toString()),
+        value: s
+      }, o).then(y);
+    },
+    apply(f, c, l) {
+      w(n);
+      const s = r[r.length - 1];
+      if (s === z)
+        return m(e, t, {
+          type: "ENDPOINT"
+        }).then(y);
+      if (s === "bind")
+        return P(e, t, r.slice(0, -1));
+      const [o, u] = k(l);
+      return m(e, t, {
+        type: "APPLY",
+        path: r.map((i) => i.toString()),
+        argumentList: o
+      }, u).then(y);
+    },
+    construct(f, c) {
+      w(n);
+      const [l, s] = k(c);
+      return m(e, t, {
+        type: "CONSTRUCT",
+        path: r.map((o) => o.toString()),
+        argumentList: l
+      }, s).then(y);
+    }
+  });
+  return W(a, e), a;
+}
+function D(e) {
+  return Array.prototype.concat.apply([], e);
+}
+function k(e) {
+  const t = e.map(p);
+  return [t.map((r) => r[0]), D(t.map((r) => r[1]))];
+}
+const O = /* @__PURE__ */ new WeakMap();
+function F(e, t) {
+  return O.set(e, t), e;
+}
+function U(e) {
+  return Object.assign(e, { [M]: !0 });
+}
+function p(e) {
+  for (const [t, r] of A)
+    if (r.canHandle(e)) {
+      const [g, n] = r.serialize(e);
+      return [
+        {
+          type: "HANDLER",
+          name: t,
+          value: g
+        },
+        n
+      ];
+    }
+  return [
+    {
+      type: "RAW",
+      value: e
+    },
+    O.get(e) || []
+  ];
+}
+function y(e) {
+  switch (e.type) {
+    case "HANDLER":
+      return A.get(e.name).deserialize(e.value);
+    case "RAW":
+      return e.value;
+  }
+}
+function m(e, t, r, g) {
+  return new Promise((n) => {
+    const a = G();
+    t.set(a, n), e.start && e.start(), e.postMessage(Object.assign({ id: a }, r), g);
+  });
+}
+function G() {
+  return new Array(4).fill(0).map(() => Math.floor(Math.random() * Number.MAX_SAFE_INTEGER).toString(16)).join("-");
+}
+export {
+  R as e,
+  U as p,
+  F as t,
+  I as w
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kbve/droid",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "A manager for web, shared and service workers, aimming to make it as modular and upgradable.",
   "keywords": [
     "workers",
@@ -27,11 +27,14 @@
     }
   },
   "files": [
+    "workers/",
     "assets/",
     "src/",
+    "comlink*.js",
+    "reference-*.js",
     "droid.*.js",
-    "main-*.js",
-    "index-*.js",
+    "main.js",
+    "index.*.js",
     "index.d.ts",
     "*.md",
     "LICENSE",
@@ -42,7 +45,8 @@
     "comlink": "^4.3.1",
     "@nanostores/persistent": "^0.7.1",
     "dexie": "^3.2.4",
-    "zod": "^3.22.4"
+    "zod": "^3.22.4",
+    "flatbuffers": "^25.2.10"
   },
   "publishConfig": {
     "access": "public"

package/src/index.ts

@@ -1,3 +1,21 @@
 export * from './lib/droid';
 export * from './lib/types/bento';
 export * from './lib/mod/mod-urls';
+
+export const workerURLs = {
+	canvasWorker: new URL(
+		'./lib/workers/canvas-worker.js',
+		import.meta.url,
+	),
+	dbWorker: new URL('./lib/workers/db-worker.js', import.meta.url),
+	wsWorker: new URL('./lib/workers/ws-worker.js', import.meta.url),
+};
+
+export const workerStrings = {
+	canvasWorker: new URL(
+		'./lib/workers/canvas-worker.js',
+		import.meta.url,
+	).toString(),
+	dbWorker: new URL('./lib/workers/db-worker.js', import.meta.url).toString(),
+	wsWorker: new URL('./lib/workers/ws-worker.js', import.meta.url).toString(),
+};

package/src/lib/droid.ts

@@ -1,5 +1,7 @@
-export async function droid(opts?: { canvas?: boolean }): Promise<{ initialized: boolean }> {
-	const { main } = await import('./workers/main');
-	await main();
+export async function droid(opts?: { workerURLs?: Record<string, string> }): Promise<{ initialized: boolean }> {
+	console.log('[DROID]: droid<T>');
+	const { main } = await import('./workers/main.js');
+	await main({ workerURLs: opts?.workerURLs });
+	console.log('[DROID]: droid<T> => await WorkerURLs');
 	return { initialized: true };
 }

package/src/lib/mod/mod-manager.ts

@@ -5,13 +5,14 @@ import type { KBVEGlobal } from '../../types';
 
 let _modManager: ModManager | null = null;
 
-export async function getModManager(): Promise<ModManager> {
+export async function getModManager(modWorkerResolver?: (url: string) => string): Promise<ModManager> {
 	if (_modManager) return _modManager;
 
 	const registry: Record<string, ModHandle> = {};
 
 	async function load(url: string): Promise<ModHandle> {
-		const worker = new Worker(url, { type: 'module' });
+		const resolvedURL = modWorkerResolver?.(url) ?? url;
+		const worker = new Worker(resolvedURL, { type: 'module' });
 		const instance = wrap<BaseModAPI>(worker);
 
 		const meta: ModMeta = await instance.getMeta?.() ?? {