@napplet/conformance-cli 0.3.3 → 0.4.0

package/dist/host-bundle.global.js

@@ -1,7 +1,7 @@
 "use strict";
 var NappletConformanceHostBundle = (() => {
   // ../core/dist/index.js
-  var NAP_DOMAINS = ["shell", "relay", "identity", "storage", "inc", "theme", "keys", "media", "notify", "config", "resource", "cvm", "outbox", "upload", "intent", "ble", "webrtc", "link", "count", "lists", "serial", "fs", "common", "dm"];
+  var NAP_DOMAINS = ["shell", "relay", "identity", "storage", "inc", "theme", "keys", "media", "notify", "config", "resource", "cvm", "outbox", "upload", "intent", "ble", "webrtc", "link", "count", "lists", "serial", "fs", "common", "dm", "gamepad"];
   function createDispatch() {
     const handlers = /* @__PURE__ */ new Map();
     function registerNap2(domain, handler) {
@@ -32,6 +32,11 @@ var NappletConformanceHostBundle = (() => {
   // ../conformance/dist/index.js
   var ID = { id: "string" };
   var ENVELOPE_SPECS = {
+    // NAP-GAMEPAD Wire Protocol: all three messages are fire-and-forget, without ids.
+    // https://github.com/napplet/naps/pull/108
+    "gamepad.subscribe": { dir: "out", forbiddenFields: ["id"], forbiddenReason: "NAP-GAMEPAD fire-and-forget envelopes do not carry it" },
+    "gamepad.unsubscribe": { dir: "out", forbiddenFields: ["id"], forbiddenReason: "NAP-GAMEPAD fire-and-forget envelopes do not carry it" },
+    "gamepad.state": { dir: "in", fields: { available: "boolean", focused: "boolean", pads: "array" } },
     // Optional NAP-SHELL environment, independent of other domains.
     "shell.ready": { dir: "out" },
     "shell.init": { dir: "in", fields: { capabilities: "object", services: "array" } },
@@ -462,7 +467,7 @@ var NappletConformanceHostBundle = (() => {
       if (field in record) {
         errors.push({
           code: "forbidden-field",
-          message: `Field "${field}" must be runtime-derived and cannot be emitted by a napplet`,
+          message: `Field "${field}" cannot be emitted by a napplet: ${spec.forbiddenReason ?? "it must be runtime-derived"}`,
           field
         });
       }
@@ -564,6 +569,11 @@ var NappletConformanceHostBundle = (() => {
         errors.push({ code: "invalid-metadata", message: `Invalid ${name} tag cardinality for kind ${event.kind}` });
       }
     }
+    for (const tag of event.tags.filter((tag2) => tag2[0] === "source")) {
+      if (tag.length !== 2 || !isSourceLocation(tag[1])) {
+        errors.push({ code: "invalid-metadata", message: "source must contain one HTTP(S), SSH, Git, or SCP repository location" });
+      }
+    }
     for (const tag of event.tags.filter((tag2) => tag2[0] === "i")) {
       if (!tag[1]?.trim() || tag[1].includes("?")) {
         errors.push({ code: "invalid-metadata", message: "Intent advertisements must be non-empty queryless identities" });
@@ -574,6 +584,16 @@ var NappletConformanceHostBundle = (() => {
       warnings.push({ code: "invalid-icon", message: "Ignore invalid icon metadata and use generic artwork (NIP-5D \xA7Icon)" });
     }
   }
+  function isSourceLocation(value) {
+    if (!value || /^[a-z]:[\\/]/i.test(value)) return false;
+    try {
+      const { protocol } = new URL(value);
+      if (["http:", "https:", "ssh:", "git:"].includes(protocol)) return true;
+      if (protocol === "file:") return false;
+    } catch {
+    }
+    return !value.includes("://") && /^(?:[^@\s/:]+@)?[^:\s/]+:[^\s]+$/.test(value);
+  }
   var REFERENCE_PUBKEY = "f".repeat(64);
   var REFERENCE_ENDPOINT = { id: "reference-source-endpoint", catalogId: "reference-source" };
   var REFERENCE_BLOB_URL = "https://reference.invalid/blob";
@@ -609,6 +629,9 @@ var NappletConformanceHostBundle = (() => {
     }
   }
   var RESPONDERS = {
+    // This transport-neutral mock has no controller API. Production shells use a host reader.
+    "gamepad.subscribe": () => ok({ type: "gamepad.state", available: false, reason: "unavailable", focused: false, pads: [] }),
+    "gamepad.unsubscribe": none,
     // relay
     "relay.subscribe": (e) => ok({ type: "relay.eose", subId: e.subId }),
     "relay.close": none,
@@ -971,18 +994,76 @@ var NappletConformanceHostBundle = (() => {
     };
   }
   var INTERNAL_BOOT_ERROR = "__nappletConformance.error";
+  var INTERNAL_INSTALLED = "__nappletConformance.installed";
   function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
   }
   function escapeHtmlAttr(value) {
     return value.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
   }
-  function runtimePrelude(domains) {
+  var GAMEPAD_STATE_TOOLS_SOURCE = `(() => {
+  const record = (value) => value !== null && typeof value === 'object' && !Array.isArray(value);
+  const numberIn = (value, min, max) => typeof value === 'number' && Number.isFinite(value) && value >= min && value <= max;
+  const isGamepadState = (value) => {
+    if (!record(value) || typeof value.available !== 'boolean' || typeof value.focused !== 'boolean' || !Array.isArray(value.pads)) return false;
+    if (value.available) {
+      if (value.reason !== undefined) return false;
+    } else if (value.focused || (value.reason !== 'blocked' && value.reason !== 'unavailable')) return false;
+    return Array.from(value.pads).every((pad) => {
+      if (pad === null) return true;
+      if (!record(pad) || !Number.isInteger(pad.index) || pad.index < 0 || typeof pad.id !== 'string' || typeof pad.mapping !== 'string' || pad.connected !== true) return false;
+      if (typeof pad.timestamp !== 'number' || !Number.isFinite(pad.timestamp) || !Array.isArray(pad.axes) || !Array.isArray(pad.buttons)) return false;
+      if (!value.focused && pad.timestamp !== 0) return false;
+      if (!Array.from(pad.axes).every((axis) => numberIn(axis, -1, 1) && (value.focused || axis === 0))) return false;
+      return Array.from(pad.buttons).every((button) => record(button) && numberIn(button.value, 0, 1) && typeof button.pressed === 'boolean' && typeof button.touched === 'boolean' && (value.focused || (button.value === 0 && !button.pressed && !button.touched)));
+    });
+  };
+  const copyGamepadState = (state) => {
+    const copy = { available: state.available, focused: state.focused };
+    if (state.reason !== undefined) copy.reason = state.reason;
+    copy.pads = state.pads.map((pad) => pad === null ? null : {
+      index: pad.index, id: pad.id, mapping: pad.mapping, connected: pad.connected,
+      timestamp: pad.timestamp, axes: pad.axes.slice(), buttons: pad.buttons.map((button) => ({ value: button.value, pressed: button.pressed, touched: button.touched })),
+    });
+    return copy;
+  };
+  return { isGamepadState, copyGamepadState };
+})()`;
+  function errorObserver() {
+    return `(() => {
+    const report = (reason) => {
+      try { window.parent.postMessage({ type: '${INTERNAL_BOOT_ERROR}', reason: String(reason && reason.message || reason) }, '*'); }
+      catch {}
+    };
+    window.addEventListener('error', (event) => report(event.error || event.message));
+    window.addEventListener('unhandledrejection', (event) => report(event.reason));
+  })();`;
+  }
+  function runtimePrelude(domains, runtimePreludeSource) {
+    const installed = `window.parent.postMessage({ type: '${INTERNAL_INSTALLED}', installed: !!window.napplet }, '*');`;
+    if (runtimePreludeSource !== void 0) {
+      return `${runtimePreludeSource}
+;globalThis.NappletShimPrelude.install(${JSON.stringify({ domains })});
+${installed}`;
+    }
     return `
 (() => {
   const domains = ${JSON.stringify(domains)};
   const napplet = {};
-  for (const domain of domains) napplet[domain] = {};
+  for (const domain of domains) {
+    if (domain === 'resource' || domain === 'gamepad') napplet[domain] = {};
+  }
+  const gamepadTools = ${GAMEPAD_STATE_TOOLS_SOURCE};
+  let gamepadState = { available: true, focused: false, pads: [] };
+  const gamepadHandlers = new Set();
+  // Subscribe on first use, like the nap binding, so napplets that never touch
+  // gamepad emit no gamepad traffic for checks to attribute to them.
+  let gamepadSubscribed = false;
+  const gamepadSubscribe = () => {
+    if (gamepadSubscribed) return;
+    gamepadSubscribed = true;
+    window.parent.postMessage({ type: 'gamepad.subscribe' }, '*');
+  };
   const pending = new Map();
   let seq = 0;
   const nextId = () => {
@@ -1002,7 +1083,18 @@ var NappletConformanceHostBundle = (() => {
     window.parent.postMessage({ ...message, id }, '*');
   });
   window.addEventListener('message', (event) => {
+    if (event.source !== window.parent) return;
     const msg = event.data;
+    if (gamepadSubscribed && msg && msg.type === 'gamepad.state' && !('id' in msg) && gamepadTools.isGamepadState(msg)) {
+      gamepadState = gamepadTools.copyGamepadState(msg);
+      const recipients = Array.from(gamepadHandlers);
+      for (const entry of recipients) {
+        if (!gamepadHandlers.has(entry)) continue;
+        try { entry.handler(gamepadTools.copyGamepadState(gamepadState)); }
+        catch (error) { queueMicrotask(() => { throw error; }); }
+      }
+      return;
+    }
     if (!msg || typeof msg !== 'object' || typeof msg.id !== 'string') return;
     const slot = pending.get(msg.id);
     if (!slot) return;
@@ -1015,6 +1107,19 @@ var NappletConformanceHostBundle = (() => {
     }
     slot.resolve(msg);
   });
+  if (napplet.gamepad) {
+    napplet.gamepad = {
+      get available() { gamepadSubscribe(); return gamepadState.available; },
+      get focused() { gamepadSubscribe(); return gamepadState.focused; },
+      getGamepads() { gamepadSubscribe(); return gamepadTools.copyGamepadState(gamepadState).pads; },
+      onChange(handler) {
+        const entry = { handler };
+        gamepadHandlers.add(entry);
+        gamepadSubscribe();
+        return { close() { gamepadHandlers.delete(entry); } };
+      },
+    };
+  }
   if (napplet.resource) {
     napplet.resource.info = () =>
       request({ type: 'resource.info' }, 'resource.info.result', 'resource.info.error')
@@ -1048,19 +1153,14 @@ var NappletConformanceHostBundle = (() => {
     };
   }
   window.napplet = napplet;
-  const report = (reason) => {
-    try {
-      window.parent.postMessage({ type: '${INTERNAL_BOOT_ERROR}', reason: String(reason && reason.message || reason) }, '*');
-    } catch {}
-  };
-  window.addEventListener('error', (event) => report(event.error || event.message));
-  window.addEventListener('unhandledrejection', (event) => report(event.reason));
+  ${installed}
 })();
 `;
   }
-  function injectRuntime(html, url, domains) {
+  function injectRuntime(html, url, domains, runtimePreludeSource) {
     const base = `<base href="${escapeHtmlAttr(url)}">`;
-    const script = `<script>${runtimePrelude(domains)}<\/script>`;
+    const source = runtimePrelude(domains, runtimePreludeSource).replace(/<\/script/gi, "<\\/script");
+    const script = `<script>${errorObserver()}<\/script><script>${source}<\/script>`;
     const headOpen = /<head(?:\s[^>]*)?>/i.exec(html);
     if (headOpen) {
       const at = headOpen.index + headOpen[0].length;
@@ -1089,15 +1189,21 @@ var NappletConformanceHostBundle = (() => {
     const shell = createReferenceShell();
     const iframe = doc.createElement("iframe");
     iframe.setAttribute("sandbox", opts.allowSameOrigin ? "allow-scripts allow-same-origin" : "allow-scripts");
+    iframe.setAttribute("allow", "gamepad 'none'");
     iframe.setAttribute("aria-hidden", "true");
     iframe.style.position = "absolute";
     iframe.style.width = "1px";
     iframe.style.height = "1px";
     iframe.style.left = "-9999px";
     let bootError = null;
+    let installedGlobal = false;
     const listener = (event) => {
       if (event.source !== iframe.contentWindow) return;
       const data = event.data;
+      if (data && typeof data === "object" && data.type === INTERNAL_INSTALLED) {
+        installedGlobal = data.installed === true;
+        return;
+      }
       if (data && typeof data === "object" && data.type === INTERNAL_BOOT_ERROR) {
         bootError = `napplet boot error: ${String(data.reason ?? "unknown error")}`;
         return;
@@ -1114,10 +1220,10 @@ var NappletConformanceHostBundle = (() => {
       }, { once: true });
     });
     win.addEventListener("message", listener);
-    (doc.body ?? doc.documentElement).appendChild(iframe);
     try {
-      const html = await loadHtml(opts.url);
-      iframe.srcdoc = injectRuntime(html, opts.url, domains);
+      const html = opts.html ?? await loadHtml(opts.url);
+      iframe.srcdoc = injectRuntime(html, opts.url, domains, opts.runtimePreludeSource);
+      (doc.body ?? doc.documentElement).appendChild(iframe);
     } catch (error) {
       bootError = error instanceof Error ? error.message : String(error);
     }
@@ -1135,16 +1241,18 @@ var NappletConformanceHostBundle = (() => {
       iframe.remove();
     } catch {
     }
-    return { installedGlobal: bootError === null, bootError, emitted: [...shell.records] };
+    return { installedGlobal, bootError, emitted: [...shell.records] };
   }
   async function bootAndCollect(options) {
     const doc = options.document ?? document;
     const win = options.window ?? window;
     const resolved = {
       url: options.url,
+      html: options.html,
       readyTimeoutMs: options.readyTimeoutMs ?? 5e3,
       settleMs: options.settleMs ?? 600,
-      allowSameOrigin: options.allowSameOrigin ?? false
+      allowSameOrigin: options.allowSameOrigin ?? false,
+      runtimePreludeSource: options.runtimePreludeSource
     };
     const primary = await bootOnce(NAP_DOMAINS, resolved, doc, win);
     let degraded = null;