@swmansion/popcorn 0.2.0-rc.2 → 0.2.0-rc.4

package/dist/AtomVM.mjs

@@ -56,7 +56,7 @@ if (ENVIRONMENT_IS_PTHREAD) {
 
 // --pre-jses are emitted after the Module integration code, so that they can
 // refer to Module (if they choose; they can also define Module)
-// include: /tmp/popcorn-swm.J66P2Dx/atomvm/src/platforms/emscripten/src/atomvm.pre.js
+// include: /tmp/popcorn-swm.tJ64R0d/atomvm/src/platforms/emscripten/src/atomvm.pre.js
 /*
  * This file is part of AtomVM.
  *
@@ -128,7 +128,7 @@ function ensureValidResult(result) {
   throw new Error(message);
 }
 
-// end include: /tmp/popcorn-swm.J66P2Dx/atomvm/src/platforms/emscripten/src/atomvm.pre.js
+// end include: /tmp/popcorn-swm.tJ64R0d/atomvm/src/platforms/emscripten/src/atomvm.pre.js
 var arguments_ = [];
 
 var thisProgram = "./this.program";
@@ -7366,19 +7366,19 @@ function checkIncomingModuleAPI() {
 }
 
 var ASM_CONSTS = {
-  77551: ($0, $1) => {
+  77455: ($0, $1) => {
     promiseMap.get($0).resolve($1);
   },
-  77587: ($0, $1) => {
+  77491: ($0, $1) => {
     promiseMap.get($0).reject($1);
   },
-  77622: ($0, $1) => {
+  77526: ($0, $1) => {
     promiseMap.get($0).resolve(UTF8ToString($1));
   },
-  77672: ($0, $1) => {
+  77576: ($0, $1) => {
     promiseMap.get($0).reject(UTF8ToString($1));
   },
-  77721: $0 => {
+  77625: $0 => {
     Module["onTrackedObjectDelete"]($0);
   }
 };

package/dist/bridge.d.ts

@@ -1,4 +1,4 @@
-import { type IframeRequest, type IframeResponse, type AnySerializable } from "./types";
+import type { IframeRequest, IframeResponse, AnySerializable } from "./types";
 export type IframeBridgeArgs = {
     container: HTMLElement;
     config: Record<string, string>;

package/dist/bridge.mjs

@@ -1,10 +1,7 @@
 import { isMessageType } from './types.mjs';
-import { throwError } from './utils.mjs';
+import { throwError } from './errors.mjs';
 
 const STYLE_HIDDEN = "visibility: hidden; width: 0px; height: 0px; border: none";
-function sendIframeResponse(type, data) {
-    window.parent.postMessage({ type, value: data });
-}
 class IframeBridge {
     iframe;
     handlerRef;
@@ -65,4 +62,4 @@ function metaTagsFrom(config) {
         .join("\n");
 }
 
-export { IframeBridge, sendIframeResponse };
+export { IframeBridge };

package/dist/errors.d.ts

@@ -0,0 +1,42 @@
+/** Error codes for recoverable errors returned in CallResult */
+export type PopcornErrorCode = "timeout" | "deinitialized" | "reload";
+/** Recoverable error returned in CallResult (never thrown) */
+export declare class PopcornError extends Error {
+    readonly code: PopcornErrorCode;
+    constructor(code: PopcornErrorCode, message?: string);
+}
+/** Error codes for internal errors that indicate bugs or misuse */
+export type PopcornInternalErrorCode = "assert" | "private_constructor" | "bad_call" | "no_acked_call" | "bad_ack" | "already_awaited" | "already_mounted" | "unmounted" | "bad_target" | "bad_status";
+/** Non-recoverable error indicating a bug or library misuse (always thrown) */
+export declare class PopcornInternalError extends Error {
+    readonly code: PopcornInternalErrorCode;
+    constructor(code: PopcornInternalErrorCode, message?: string);
+}
+/** Internal errors - indicate bugs, protocol violations, or library misuse */
+type ErrorData = {
+    t: "assert";
+} | {
+    t: "private_constructor";
+} | {
+    t: "bad_call";
+} | {
+    t: "no_acked_call";
+} | {
+    t: "bad_ack";
+} | {
+    t: "already_awaited";
+    messageType: string;
+    awaitedMessageType: string;
+} | {
+    t: "already_mounted";
+} | {
+    t: "unmounted";
+} | {
+    t: "bad_target";
+} | {
+    t: "bad_status";
+    status: string;
+    expectedStatus: string;
+};
+export declare function throwError(error: ErrorData): never;
+export {};

package/dist/errors.mjs

@@ -0,0 +1,49 @@
+const defaultErrorMessages = {
+    timeout: "Promise timeout",
+    deinitialized: "Call cancelled due to instance deinit",
+    reload: "Call cancelled due to iframe reload",
+};
+/** Recoverable error returned in CallResult (never thrown) */
+class PopcornError extends Error {
+    code;
+    constructor(code, message) {
+        super(message ?? defaultErrorMessages[code]);
+        this.code = code;
+        this.name = "PopcornError";
+    }
+}
+/** Non-recoverable error indicating a bug or library misuse (always thrown) */
+class PopcornInternalError extends Error {
+    code;
+    constructor(code, message) {
+        super(message ?? `Internal error: ${code}`);
+        this.code = code;
+        this.name = "PopcornInternalError";
+    }
+}
+function throwError(error) {
+    switch (error.t) {
+        case "assert":
+            throw new PopcornInternalError("assert", "Assertion error");
+        case "private_constructor":
+            throw new PopcornInternalError("private_constructor", "Don't construct the Popcorn object directly, use Popcorn.init() instead");
+        case "bad_call":
+            throw new PopcornInternalError("bad_call", "Response for non-existent call");
+        case "no_acked_call":
+            throw new PopcornInternalError("no_acked_call", "Response for non-acknowledged call");
+        case "bad_ack":
+            throw new PopcornInternalError("bad_ack", "Ack for non-existent call");
+        case "already_awaited":
+            throw new PopcornInternalError("already_awaited", `Cannot await message "${error.messageType}" when message "${error.awaitedMessageType}" is already awaited`);
+        case "already_mounted":
+            throw new PopcornInternalError("already_mounted", "Iframe already mounted");
+        case "unmounted":
+            throw new PopcornInternalError("unmounted", "WASM iframe not mounted");
+        case "bad_target":
+            throw new PopcornInternalError("bad_target", "Unspecified target process");
+        case "bad_status":
+            throw new PopcornInternalError("bad_status", `Operation not allowed: instance in "${error.status}" state, expected "${error.expectedStatus}"`);
+    }
+}
+
+export { PopcornError, PopcornInternalError, throwError };

package/dist/iframe.mjs

@@ -1,6 +1,22 @@
-import Module$1 from './AtomVM.mjs';
-import { sendIframeResponse } from './bridge.mjs';
-import { MESSAGES, HEARTBEAT_INTERVAL_MS } from './types.mjs';
+import init from './AtomVM.mjs';
+
+const HEARTBEAT_INTERVAL_MS = 500;
+const MESSAGES = {
+    INIT: "popcorn-init",
+    START_VM: "popcorn-startVm",
+    CALL: "popcorn-call",
+    CAST: "popcorn-cast",
+    CALL_ACK: "popcorn-callAck",
+    STDOUT: "popcorn-stdout",
+    STDERR: "popcorn-stderr",
+    HEARTBEAT: "popcorn-heartbeat",
+    RELOAD: "popcorn-reload",
+};
+new Set(Object.values(MESSAGES));
+
+function sendIframeResponse(type, data) {
+    window.parent.postMessage({ type, value: data });
+}
 
 // @ts-expect-error atomvm doesn't have types yet
 let Module = null;
@@ -43,7 +59,7 @@ async function startVm(avmBundle) {
     const resultPromise = new Promise((resolve) => {
         resolveResultPromise = resolve;
     });
-    const moduleInstance = await Module$1({
+    const moduleInstance = await init({
         preRun: [
             function ({ FS }) {
                 FS.mkdir("/data");

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-export { Popcorn, PopcornDeinitializedError } from "./popcorn";
-export type { CastOptions, CallOptions } from "./popcorn";
+export { Popcorn, PopcornError, PopcornInternalError } from "./popcorn";
+export type { PopcornErrorCode, PopcornInternalErrorCode, PopcornInitOptions, CastOptions, CallOptions, } from "./popcorn";
 export type { AnySerializable } from "./types";

package/dist/index.mjs

@@ -1 +1,2 @@
-export { Popcorn, PopcornDeinitializedError } from './popcorn.mjs';
+export { Popcorn } from './popcorn.mjs';
+export { PopcornError, PopcornInternalError } from './errors.mjs';

package/dist/popcorn.d.ts

@@ -1,4 +1,8 @@
-import { type AnySerializable } from "./types";
+import { PopcornError, PopcornInternalError } from "./errors";
+import type { AnySerializable } from "./types";
+import type { PopcornErrorCode, PopcornInternalErrorCode } from "./errors";
+export { PopcornError, PopcornInternalError };
+export type { PopcornErrorCode, PopcornInternalErrorCode };
 /** Options for Popcorn.init() */
 export type PopcornInitOptions = {
     /** DOM element to mount an iframe */
@@ -39,14 +43,12 @@ type CallResult = {
 } | {
     ok: false;
     /** Error from failed call */
-    error?: AnySerializable;
+    error: Error;
     /** Amount of time it took to process the call */
     durationMs: number;
 };
 type LogType = "stdout" | "stderr";
 type LogListener = (message: string) => void;
-export declare class PopcornDeinitializedError extends Error {
-}
 /**
  * Manages Elixir by setting up iframe, WASM module, and event listeners. Used to sent messages to Elixir processes.
  */
@@ -127,4 +129,3 @@ export declare class Popcorn {
     private transition;
     private assertStatus;
 }
-export {};

package/dist/popcorn.mjs

@@ -1,9 +1,8 @@
 import { IframeBridge } from './bridge.mjs';
-import { HEARTBEAT_TIMEOUT_MS, MESSAGES, MAX_RELOAD_N, CALL_TIMEOUT_MS, INIT_VM_TIMEOUT_MS } from './types.mjs';
-import { throwError } from './utils.mjs';
+import { HEARTBEAT_TIMEOUT_MS, MESSAGES, MAX_RELOAD_N, INIT_VM_TIMEOUT_MS, CALL_TIMEOUT_MS } from './types.mjs';
+import { throwError, PopcornError } from './errors.mjs';
+export { PopcornInternalError } from './errors.mjs';
 
-class PopcornDeinitializedError extends Error {
-}
 const INIT_TOKEN = Symbol();
 const IFRAME_URL = new URL("./iframe.mjs", import.meta.url).href;
 /**
@@ -76,7 +75,15 @@ class Popcorn {
         await this.awaitMessage(MESSAGES.INIT);
         this.transition({ status: "await_vm" });
         this.trace("Main: iframe loaded");
-        this.initProcess = await withTimeout(this.awaitMessage(MESSAGES.START_VM), INIT_VM_TIMEOUT_MS);
+        const startTime = performance.now();
+        const startVmResult = await withTimeout(this.awaitMessage(MESSAGES.START_VM).then((data) => ({
+            ok: true,
+            data,
+            durationMs: performance.now() - startTime,
+        })), INIT_VM_TIMEOUT_MS);
+        if (!startVmResult.ok)
+            throwError({ t: "assert" });
+        this.initProcess = startVmResult.data;
         this.transition({ status: "ready" });
         this.trace("Main: mounted, main process: ", this.initProcess);
         this.onHeartbeat();
@@ -105,7 +112,8 @@ class Popcorn {
         if (targetProcess === null)
             throwError({ t: "bad_target" });
         const requestId = this.requestId++;
-        const callPromise = new Promise((resolve, reject) => {
+        const startTimeMs = performance.now();
+        const callPromise = new Promise((resolve) => {
             if (this.bridge === null)
                 throwError({ t: "unmounted" });
             this.trace("Main: call: ", { requestId, process, args });
@@ -115,9 +123,8 @@ class Popcorn {
             });
             this.calls.set(requestId, {
                 acknowledged: false,
-                startTimeMs: performance.now(),
+                startTimeMs,
                 resolve,
-                reject,
             });
         });
         const result = await withTimeout(callPromise, timeoutMs ?? CALL_TIMEOUT_MS);
@@ -163,8 +170,9 @@ class Popcorn {
         this.logListeners.stderr.clear();
         for (const callData of this.calls.values()) {
             const durationMs = performance.now() - callData.startTimeMs;
-            callData.reject({
-                error: new PopcornDeinitializedError("Call cancelled due to instance deinit"),
+            callData.resolve({
+                ok: false,
+                error: new PopcornError("deinitialized"),
                 durationMs,
             });
         }
@@ -251,10 +259,9 @@ class Popcorn {
             // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
         }, this.heartbeatTimeoutMs);
     }
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
     reloadIframe(reason = "other") {
         if (this.bridge === null) {
-            throw new Error("WASM iframe not mounted for reload");
+            throwError({ t: "unmounted" });
         }
         if (document.hidden) {
             this.trace("Main: reloading iframe skipped, window not visible");
@@ -276,8 +283,9 @@ class Popcorn {
         }
         for (const callData of this.calls.values()) {
             const durationMs = performance.now() - callData.startTimeMs;
-            callData.reject({
-                error: new Error("Call cancelled due to iframe reload"),
+            callData.resolve({
+                ok: false,
+                error: new PopcornError("reload"),
                 durationMs,
             });
         }
@@ -322,9 +330,13 @@ class Popcorn {
 }
 async function withTimeout(promise, ms) {
     let timeout = null;
-    const timeoutPromise = new Promise((_resolve, reject) => {
+    const timeoutPromise = new Promise((resolve) => {
         timeout = setTimeout(() => {
-            reject("Promise timeout");
+            resolve({
+                ok: false,
+                error: new PopcornError("timeout"),
+                durationMs: ms,
+            });
         }, ms);
     });
     const result = await Promise.race([promise, timeoutPromise]);
@@ -337,4 +349,4 @@ function noop() {
     /* noop */
 }
 
-export { Popcorn, PopcornDeinitializedError };
+export { Popcorn, PopcornError };

package/dist/types.mjs

@@ -1,7 +1,6 @@
 const INIT_VM_TIMEOUT_MS = 30_000;
 const CALL_TIMEOUT_MS = 60_000;
 const HEARTBEAT_TIMEOUT_MS = 60_000;
-const HEARTBEAT_INTERVAL_MS = 500;
 const MAX_RELOAD_N = 3;
 const MESSAGES = {
     INIT: "popcorn-init",
@@ -19,4 +18,4 @@ function isMessageType(type) {
     return MESSAGES_TYPES.has(type);
 }
 
-export { CALL_TIMEOUT_MS, HEARTBEAT_INTERVAL_MS, HEARTBEAT_TIMEOUT_MS, INIT_VM_TIMEOUT_MS, MAX_RELOAD_N, MESSAGES, isMessageType };
+export { CALL_TIMEOUT_MS, HEARTBEAT_TIMEOUT_MS, INIT_VM_TIMEOUT_MS, MAX_RELOAD_N, MESSAGES, isMessageType };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swmansion/popcorn",
-  "version": "0.2.0-rc.2",
+  "version": "0.2.0-rc.4",
   "description": "JS bindings for Popcorn",
   "type": "module",
   "license": "Apache-2.0",
@@ -56,6 +56,7 @@
   },
   "devDependencies": {
     "@eslint/js": "^9.39.0",
+    "@playwright/test": "^1.52.0",
     "@rollup/plugin-typescript": "^12.1.2",
     "@types/node": "^25.0.8",
     "esbuild": "^0.25.0",
@@ -70,10 +71,11 @@
     "vitest": "^4.0.17"
   },
   "scripts": {
-    "setup:dev": "npm run assets:dev",
+    "setup:dev": "npm run assets:dev && rollup -c",
     "dev": "rollup -c --watch",
     "lint": "tsc --noEmit && eslint && prettier . --check --log-level=warn",
     "test": "vitest",
+    "test:e2e": "playwright test --config e2e/playwright.config.ts",
     "build:prod": "pnpm run lint && (rm -rf assets || true) && (rm -rf dist || true) && pnpm run assets:prod && rollup -c",
     "assets:dev": "./scripts/get_atomvm.sh assets/",
     "assets:prod": "RUNTIME_SOURCE='https://github.com/software-mansion-labs/FissionVM.git#swm' ./scripts/get_atomvm.sh assets/"

package/dist/utils.d.ts

@@ -1,27 +0,0 @@
-type ErrorData = {
-    t: "assert";
-} | {
-    t: "bad_status";
-    status: string;
-    expectedStatus: string;
-} | {
-    t: "private_constructor";
-} | {
-    t: "bad_call";
-} | {
-    t: "no_acked_call";
-} | {
-    t: "bad_ack";
-} | {
-    t: "unmounted";
-} | {
-    t: "bad_target";
-} | {
-    t: "already_awaited";
-    messageType: string;
-    awaitedMessageType: string;
-} | {
-    t: "already_mounted";
-};
-export declare function throwError(error: ErrorData): never;
-export {};

package/dist/utils.mjs

@@ -1,26 +0,0 @@
-function throwError(error) {
-    switch (error.t) {
-        case "assert":
-            throw new Error("Assertion error");
-        case "bad_status":
-            throw new Error(`Unexpected status transition. Instance in ${error.status} status, expected ${error.expectedStatus}`);
-        case "private_constructor":
-            throw new Error("Don't construct the Popcorn object directly, use Popcorn.init() instead");
-        case "bad_call":
-            throw new Error("Response for non-existent call");
-        case "no_acked_call":
-            throw new Error("Response for non-acknowledged call");
-        case "bad_ack":
-            throw new Error("Ack for non-existent call");
-        case "unmounted":
-            throw new Error("WASM iframe not mounted");
-        case "bad_target":
-            throw new Error("Unspecified target process");
-        case "already_awaited":
-            throw new Error(`Cannot await message ${error.messageType} when a message ${error.awaitedMessageType} is already awaited on`);
-        case "already_mounted":
-            throw new Error("Iframe already mounted");
-    }
-}
-
-export { throwError };