space-data-module-sdk 0.6.0 → 0.7.0

package/src/runtime-host/index.js

@@ -23,6 +23,28 @@ function createCapabilityRegistry(capabilities = {}) {
   return registry;
 }
 
+function listCapabilityOperations(capabilities) {
+  const operations = new Set();
+  for (const [capabilityId, adapter] of capabilities.entries()) {
+    if (!adapter || typeof adapter !== "object") {
+      continue;
+    }
+    const methodIds = Object.keys(adapter).filter(
+      (methodId) => typeof adapter[methodId] === "function" && methodId !== "invoke",
+    );
+    if (methodIds.length > 0) {
+      for (const methodId of methodIds) {
+        operations.add(`${capabilityId}.${methodId}`);
+      }
+      continue;
+    }
+    if (typeof adapter.invoke === "function") {
+      operations.add(`${capabilityId}.invoke`);
+    }
+  }
+  return Array.from(operations).sort();
+}
+
 export function createRuntimeHost(options = {}) {
   const rows = options.rows ?? createFlatSqlRuntimeStore();
   const regions = options.regions ?? createRuntimeRegionStore();
@@ -36,6 +58,15 @@ export function createRuntimeHost(options = {}) {
     listCapabilities() {
       return Array.from(capabilities.keys()).sort();
     },
+    listSupportedCapabilities() {
+      return Array.from(capabilities.keys()).sort();
+    },
+    listOperations() {
+      return listCapabilityOperations(capabilities);
+    },
+    hasCapability(capability) {
+      return capabilities.has(normalizeCapabilityId(capability));
+    },
     getCapability(capability) {
       return capabilities.get(normalizeCapabilityId(capability)) ?? null;
     },
@@ -68,6 +99,9 @@ export function createRuntimeHost(options = {}) {
         `Runtime host capability "${capabilityId}" does not implement "${methodId}" or invoke().`,
       );
     },
+    async invoke(operation, params = {}) {
+      return this.invokeCapability(operation, params);
+    },
   };
 }
 

package/src/testing/browserModuleHarness.js

@@ -14,10 +14,11 @@
 
 import { createBrowserWasiShim, WasiExitError } from "../host/wasiShim.js";
 import { createBrowserHost } from "../host/browserHost.js";
+import { getWasmWallet } from "../utils/wasmCrypto.js";
 import {
   createJsonHostcallBridge,
+  createAsyncHostDispatcher,
   createHostSyncDispatcher,
-  dispatchHostOperation,
   DEFAULT_HOSTCALL_IMPORT_MODULE,
 } from "../host/abi.js";
 import {
@@ -126,8 +127,20 @@ async function instantiateBrowserModule(options = {}) {
  * @param {string} [options.surface] - "direct" or "command" (default: auto-detect).
  */
 export async function createBrowserModuleHarness(options = {}) {
-  const host = options.host ?? createBrowserHost(options.hostOptions);
   const wasmModule = await compileWasmModule(options.wasmSource);
+  const moduleImports = WebAssembly.Module.imports(wasmModule);
+  const needsHostBridge = moduleImports.some(
+    (entry) => entry.module === DEFAULT_HOSTCALL_IMPORT_MODULE,
+  );
+  const hostOptions =
+    !options.host && needsHostBridge && !options.hostOptions?.wasmWallet
+      ? {
+          ...options.hostOptions,
+          wasmWallet: await getWasmWallet(),
+        }
+      : options.hostOptions;
+  const host = options.host ?? createBrowserHost(hostOptions);
+  const dispatchHost = createAsyncHostDispatcher(host);
 
   const profile = detectArtifactProfile(wasmModule);
   const moduleExports = WebAssembly.Module.exports(wasmModule);
@@ -240,7 +253,7 @@ export async function createBrowserModuleHarness(options = {}) {
   }
 
   async function callHost(operation, params = {}) {
-    return dispatchHostOperation(host, operation, params);
+    return dispatchHost(operation, params);
   }
 
   function readManifest() {

package/src/testing/index.d.ts

@@ -335,6 +335,7 @@ export interface BrowserModuleHarness {
     stdout: Uint8Array;
     stderr: Uint8Array;
   };
+  callHost(operation: string, params?: Record<string, any>): Promise<unknown>;
   invokeRaw(
     requestBytes: Uint8Array | ArrayBuffer | ArrayBufferView,
   ): Promise<Uint8Array>;

package/src/testing/index.js

@@ -98,6 +98,7 @@ const CapabilitySurfaceMatrix = Object.freeze({
     notes: [
       "WASI preopens are the preferred cross-runtime filesystem surface.",
       "The sync hostcall ABI currently exposes filesystem.resolvePath only.",
+      "Awaited filesystem reads and writes live on the generic async host boundary shared by NodeHost, BrowserHost, runtime-host capability registries, and harness callHost dispatch.",
     ],
   }),
   pipe: Object.freeze({
@@ -121,7 +122,7 @@ const CapabilitySurfaceMatrix = Object.freeze({
     nodeHostApi: true,
     notes: [
       "The coarse network capability maps to async host-side HTTP/TCP/UDP/TLS/WebSocket services.",
-      "Browser harnesses can await the same capability surface through BrowserHost.invoke().",
+      "Browser and Node harnesses can await the same capability surface through BrowserHost.invoke(), loadModule(...).callHost(...), and createBrowserModuleHarness(...).callHost(...).",
       "Pure WASI guests cannot reach that surface through the current sync hostcall ABI.",
       "WasmEdge provides non-blocking socket-oriented extensions that can serve as the standard server-side max-WASI target.",
     ],
@@ -207,7 +208,7 @@ const CapabilitySurfaceMatrix = Object.freeze({
     syncHostcall: false,
     nodeHostApi: true,
     notes: [
-      "IPFS access is available through async host adapters and browser/module harness dispatch.",
+      "IPFS access is available through the generic async host boundary and browser/module harness dispatch.",
       "Pure WASM guests cannot reach that surface through the current sync hostcall ABI.",
     ],
   }),
@@ -219,7 +220,7 @@ const CapabilitySurfaceMatrix = Object.freeze({
     syncHostcall: false,
     nodeHostApi: true,
     notes: [
-      "Protocol registration is available through async host adapters and browser/module harness dispatch.",
+      "Protocol registration is available through the generic async host boundary and browser/module harness dispatch.",
       "Pure WASM guests cannot reach that surface through the current sync hostcall ABI.",
     ],
   }),
@@ -231,7 +232,7 @@ const CapabilitySurfaceMatrix = Object.freeze({
     syncHostcall: false,
     nodeHostApi: true,
     notes: [
-      "Protocol dialing is available through async host adapters and browser/module harness dispatch.",
+      "Protocol dialing is available through the generic async host boundary and browser/module harness dispatch.",
       "Pure WASM guests cannot reach that surface through the current sync hostcall ABI.",
     ],
   }),