@vulfram/transport-browser 0.19.2-alpha

package/lib/vulfram_core_bg.wasm.d.ts

@@ -0,0 +1,24 @@
+/* tslint:disable */
+/* eslint-disable */
+export const memory: WebAssembly.Memory;
+export const __wbg_bufferresult_free: (a: number, b: number) => void;
+export const bufferresult_result: (a: number) => number;
+export const bufferresult_takeBuffer: (a: number, b: number) => void;
+export const vulfram_dispose: () => number;
+export const vulfram_get_profiling: () => number;
+export const vulfram_init: () => number;
+export const vulfram_receive_events: () => number;
+export const vulfram_receive_queue: () => number;
+export const vulfram_send_queue: (a: number, b: number) => number;
+export const vulfram_tick: (a: number, b: number) => number;
+export const vulfram_upload_buffer: (a: bigint, b: number, c: number, d: number) => number;
+export const __wasm_bindgen_func_elem_1531: (a: number, b: number) => void;
+export const __wasm_bindgen_func_elem_1533: (a: number, b: number, c: number) => void;
+export const __wasm_bindgen_func_elem_3378: (a: number, b: number, c: number, d: number) => void;
+export const __wasm_bindgen_func_elem_1532: (a: number, b: number, c: number) => void;
+export const __wasm_bindgen_func_elem_1532_3: (a: number, b: number, c: number) => void;
+export const __wbindgen_export: (a: number, b: number) => number;
+export const __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
+export const __wbindgen_export3: (a: number) => void;
+export const __wbindgen_add_to_stack_pointer: (a: number) => number;
+export const __wbindgen_export4: (a: number, b: number, c: number) => void;

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@vulfram/transport-browser",
+  "version": "0.19.2-alpha",
+  "module": "src/index.ts",
+  "main": "src/index.ts",
+  "types": "src/index.ts",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@vulfram/transport-types": "^0.3.0"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.3.10"
+  }
+}

package/src/index.ts

@@ -0,0 +1,148 @@
+import type { EngineTransport, EngineTransportFactory } from '@vulfram/transport-types';
+import {
+  VULFRAM_R2_DEFAULT_BASE_URL,
+  buildArtifactUrl,
+  parsePackageArtifactTarget,
+} from '@vulfram/transport-types';
+
+import pkg from '../package.json' with { type: 'json' };
+
+export type InitInput = unknown | Promise<unknown>;
+
+type WasmBufferResult = {
+  result: number;
+  takeBuffer: () => Uint8Array;
+  free: () => void;
+};
+
+type WasmBindings = {
+  default: (moduleOrPath?: InitInput) => Promise<unknown>;
+  vulfram_dispose: () => number;
+  vulfram_get_profiling: () => WasmBufferResult;
+  vulfram_init: () => number;
+  vulfram_receive_events: () => WasmBufferResult;
+  vulfram_receive_queue: () => WasmBufferResult;
+  vulfram_send_queue: (data: Uint8Array) => number;
+  vulfram_tick: (timeMs: number, deltaMs: number) => number;
+  vulfram_upload_buffer: (
+    id: bigint,
+    uploadType: number,
+    data: Uint8Array,
+  ) => number;
+};
+
+const packageVersion = (pkg as { version?: string }).version ?? '0.0.0';
+const { channel, artifactVersion } = parsePackageArtifactTarget(packageVersion);
+
+let initialized = false;
+let bindings: WasmBindings | null = null;
+
+function resolveBrowserArtifactUrl(artifact: string): string {
+  return buildArtifactUrl({
+    baseUrl: VULFRAM_R2_DEFAULT_BASE_URL,
+    channel,
+    artifactVersion,
+    binding: 'wasm',
+    platform: 'browser',
+    artifact,
+  });
+}
+
+async function loadBindings(): Promise<WasmBindings> {
+  if (bindings) return bindings;
+
+  try {
+    const localModulePath = '../lib/vulfram_core.js';
+    bindings = (await import(
+      /* @vite-ignore */ localModulePath
+    )) as WasmBindings;
+    return bindings;
+  } catch {
+    const remoteModule = resolveBrowserArtifactUrl('vulfram_core.js');
+    bindings = (await import(
+      /* @vite-ignore */ remoteModule
+    )) as WasmBindings;
+    return bindings;
+  }
+}
+
+function ensureInitialized(): void {
+  if (!initialized || !bindings) {
+    throw new Error(
+      'Browser transport not initialized. Call initBrowserTransport() first.',
+    );
+  }
+}
+
+function unwrapBufferResult(result: WasmBufferResult): {
+  buffer: Uint8Array;
+  result: number;
+} {
+  const buffer = result.takeBuffer();
+  const code = result.result;
+  result.free();
+  return { buffer, result: code };
+}
+
+export async function initBrowserTransport(
+  moduleOrPath?: InitInput,
+): Promise<void> {
+  if (initialized) return;
+  const wasm = await loadBindings();
+
+  try {
+    await wasm.default(moduleOrPath);
+  } catch (error) {
+    if (moduleOrPath !== undefined) {
+      throw error;
+    }
+
+    const fallbackWasmUrl = resolveBrowserArtifactUrl('vulfram_core_bg.wasm');
+    await wasm.default(fallbackWasmUrl);
+  }
+
+  initialized = true;
+}
+
+const transportImpl: EngineTransport = {
+  vulframInit: () => {
+    ensureInitialized();
+    return bindings!.vulfram_init();
+  },
+  vulframDispose: () => {
+    ensureInitialized();
+    return bindings!.vulfram_dispose();
+  },
+  vulframSendQueue: (buffer) => {
+    ensureInitialized();
+    return bindings!.vulfram_send_queue(buffer);
+  },
+  vulframReceiveQueue: () => {
+    ensureInitialized();
+    return unwrapBufferResult(bindings!.vulfram_receive_queue());
+  },
+  vulframReceiveEvents: () => {
+    ensureInitialized();
+    return unwrapBufferResult(bindings!.vulfram_receive_events());
+  },
+  vulframUploadBuffer: (id, uploadType, buffer) => {
+    ensureInitialized();
+    return bindings!.vulfram_upload_buffer(BigInt(id), uploadType, buffer);
+  },
+  vulframTick: (timeMs, deltaMs) => {
+    ensureInitialized();
+    return bindings!.vulfram_tick(timeMs, deltaMs);
+  },
+  vulframGetProfiling: () => {
+    ensureInitialized();
+    return unwrapBufferResult(bindings!.vulfram_get_profiling());
+  },
+};
+
+export const transportBrowser: EngineTransportFactory = () => {
+  ensureInitialized();
+  return transportImpl;
+};
+
+export const initWasmTransport = initBrowserTransport;
+export const transportWasm = transportBrowser;

package/tsconfig.json

@@ -0,0 +1,29 @@
+{
+  "compilerOptions": {
+    // Environment setup & latest features
+    "lib": ["ESNext"],
+    "target": "ESNext",
+    "module": "Preserve",
+    "moduleDetection": "force",
+    "jsx": "react-jsx",
+    "allowJs": true,
+
+    // Bundler mode
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "verbatimModuleSyntax": true,
+    "noEmit": true,
+
+    // Best practices
+    "strict": true,
+    "skipLibCheck": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedIndexedAccess": true,
+    "noImplicitOverride": true,
+
+    // Some stricter flags (disabled by default)
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "noPropertyAccessFromIndexSignature": false
+  }
+}