@tokamakdev/plugin 0.1.0-beta.65 → 0.1.0-beta.70

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tokamakdev/plugin",
-  "version": "0.1.0-beta.65",
+  "version": "0.1.0-beta.70",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/mantty/tokamak.git",
@@ -9,7 +9,8 @@
   "type": "module",
   "exports": {
     ".": "./src/index.ts",
-    "./worker": "./src/worker.ts"
+    "./worker": "./src/worker.ts",
+    "./testing": "./src/testing.ts"
   },
   "files": [
     "src"

package/src/index.ts

@@ -32,7 +32,6 @@ type Pending = PendingCall | PendingSubscription;
 
 declare global {
   var __tokamakNative: NativeTransport | undefined;
-  var __tokamakReceive: ((response: NativeResponse) => void) | undefined;
 }
 
 let nextRequestId = 1;
@@ -49,27 +48,20 @@ export abstract class FrontendPlugin {
 
   protected call<T>(method: string, arguments_: unknown = null): Promise<T> {
     return new Promise<T>((resolve, reject) => {
-      send("call", this.pluginId, method, arguments_, {
-        kind: "call",
-        resolve: (value) => {
-          resolve(value as T);
-        },
-        reject,
-      });
+      send("call", this.pluginId, method, arguments_, { kind: "call", resolve, reject });
     });
   }
 
-  protected listen(
+  // eslint-disable-next-line @typescript-eslint/no-unnecessary-type-parameters -- T types the native values, as in call.
+  protected listen<T>(
     method: string,
-    next: (value: unknown) => void,
+    next: (value: T) => void,
     error: (error: DOMException) => void,
     arguments_: unknown = null,
   ): () => void {
     const { transport, id } = send("subscribe", this.pluginId, method, arguments_, {
       kind: "subscription",
-      next: (value) => {
-        next(value);
-      },
+      next,
       error,
     });
     return () => {
@@ -87,7 +79,6 @@ function nativeTransport(): NativeTransport | undefined {
     transport.onmessage = ({ data }) => {
       receive(JSON.parse(data) as NativeResponse);
     };
-    globalThis.__tokamakReceive = receive;
     transport.postMessage(JSON.stringify({ type: "reset", session }));
   }
   return transport;

package/src/testing.ts

@@ -0,0 +1,39 @@
+/** A native transport that records the page's messages and replies as the native bridges do. */
+export class FakeNativeTransport {
+  /** Every message the page posted, parsed. */
+  readonly sent: Record<string, unknown>[] = [];
+  onmessage: ((event: { data: string }) => void) | null = null;
+
+  postMessage(message: string): void {
+    this.sent.push(JSON.parse(message) as Record<string, unknown>);
+  }
+
+  /** The last message's type, plugin, method and arguments. */
+  lastRequest(): Record<string, unknown> {
+    const { type, plugin, method, arguments: arguments_ } = this.sent.at(-1) ?? {};
+    return { type, plugin, method, arguments: arguments_ };
+  }
+
+  /** Replies to the last message. */
+  respond(reply: { value?: unknown; error?: { name: string; message: string } }, done = true): void {
+    const { session, id } = this.sent.at(-1) ?? {};
+    this.deliver({ session, id, done, ...reply });
+  }
+
+  /** Delivers `response` to the page. */
+  deliver(response: Record<string, unknown>): void {
+    this.onmessage?.({ data: JSON.stringify(response) });
+  }
+}
+
+/** Installs a new fake as the page's native transport. */
+export function connectNative(): FakeNativeTransport {
+  const transport = new FakeNativeTransport();
+  globalThis.__tokamakNative = transport;
+  return transport;
+}
+
+/** Removes the page's native transport. */
+export function disconnectNative(): void {
+  Reflect.deleteProperty(globalThis, "__tokamakNative");
+}