@aqarios/luna-model-wasm32-wasi 0.6.4

package/README.md

@@ -0,0 +1,3 @@
+# `@aqarios/luna-model-wasm32-wasi`
+
+This is the **wasm32-wasip1-threads** binary for `@aqarios/luna-model`

package/index.d.ts

@@ -0,0 +1,158 @@
+/* auto-generated by NAPI-RS */
+/* eslint-disable */
+/**
+ * Provides access to solution information including the sample,
+ * objective value, feasibility, and constraint satisfaction, counts,
+ * raw energy, and comparison capabilities.
+ */
+export declare class ResultView {
+  /** Get the number of times this result was observed. */
+  get counts(): number
+  /** Get the objective function value. */
+  get objValue(): number | null
+  /** Get the raw energy from the solver. */
+  get rawEnergy(): number | null
+  /** Get constraint satisfaction status. */
+  get constraints(): Record<string, boolean> | null
+  /** Get variable bound satisfaction status. */
+  get variableBounds(): Record<string, boolean> | null
+  /** Get feasibility status. */
+  get feasible(): boolean | null
+}
+export type JsResultView = ResultView
+
+/**
+ * Column-oriented solution data for model evaluation or solver results.
+ *
+ * A solution is independent of the original model and stores all variable data
+ * by variable name. JavaScript solutions are created from LunaModel's binary
+ * serializer with `Solution.deserialize()`.
+ */
+export declare class Solution {
+  /**
+   * Decode a LunaModel solution from serialized binary bytes.
+   *
+   * This is the JavaScript alias for Python's `Solution.decode()` /
+   * `Solution.deserialize()` path. `data` must contain bytes produced by the
+   * existing LunaModel `Solution` serializer.
+   */
+  static deserialize(data: Uint8Array): Solution
+  /**
+   * Number of occurrences for each stored sample row.
+   *
+   * This matches the Python `counts` property.
+   */
+  get counts(): Array<number>
+  /**
+   * Objective values as computed by the solver.
+   *
+   * Returns `null` if the solver did not provide raw energies. This matches
+   * the Python `raw_energies` property.
+   */
+  get rawEnergies(): Array<number> | null
+  /**
+   * Objective values as computed by the corresponding model.
+   *
+   * Returns `null` for solutions that have not yet been evaluated. This
+   * matches the Python `obj_values` property.
+   */
+  get objValues(): Array<number> | null
+  /**
+   * Feasibility flag for each stored sample row.
+   *
+   * A value is `true` when all constraints and variable bounds are satisfied
+   * for that sample. Returns `null` for solutions without feasibility data.
+   */
+  get feasible(): Array<boolean> | null
+  /**
+   * Per-constraint feasibility flags keyed by constraint name.
+   *
+   * Each vector is aligned with the stored sample rows.
+   */
+  get constraints(): Record<string, Array<boolean>>
+  /**
+   * Per-variable bound feasibility flags keyed by variable name.
+   *
+   * Each vector is aligned with the stored sample rows.
+   */
+  get variableBounds(): Record<string, Array<boolean>>
+  /**
+   * Runtime metrics carried by this solution.
+   *
+   * Returns `null` if no timing metadata is available. This corresponds to
+   * Python's `runtime` property.
+   */
+  get timing(): JsTiming | null
+  /**
+   * Sense carried by this solution.
+   *
+   * This corresponds to Python's `sense` property.
+   */
+  get sense(): Sense
+  /**
+   * Fraction of total sample mass marked as feasible.
+   *
+   * Computes the count-weighted ratio of feasible samples to all samples.
+   * Throws if feasibility data is not available.
+   */
+  feasibilityRatio(): number
+  /**
+   * Return a new solution containing only feasible sample rows.
+   *
+   * Throws if feasibility data is not available. Filtering feasible samples
+   * is not possible on a non-evaluated solution.
+   */
+  filterFeasible(): Solution
+  /**
+   * Get the best results according to the optimization sense.
+   *
+   * Returns `ResultView[]` or `null`.
+   * List of best results (lowest for MIN, highest for MAX).
+   */
+  best(): Array<ResultView> | null
+}
+export type JsSolution = Solution
+
+/**
+ * Runtime timing metadata attached to a solution.
+ *
+ * JavaScript exposes wall-clock timestamps as milliseconds since the Unix
+ * epoch (UTC). Wrap with `new Date(timing.start)` for a `Date` object.
+ */
+export declare class Timing {
+  /**
+   * Wall-clock start time, in milliseconds since the Unix epoch (UTC).
+   *
+   * This matches Python's `start` property; wrap with `new Date(...)` on
+   * the JS side if you want a `Date` object.
+   */
+  get start(): number
+  /**
+   * Wall-clock end time, in milliseconds since the Unix epoch (UTC).
+   *
+   * This matches Python's `end` property; wrap with `new Date(...)` on
+   * the JS side if you want a `Date` object.
+   */
+  get end(): number
+  /**
+   * Total runtime in seconds.
+   *
+   * This is computed as the difference between `end` and `start`. Throws if
+   * the timing record is inconsistent and the total duration cannot be
+   * computed. This matches Python's `total_seconds` property.
+   */
+  get totalSeconds(): number
+  /**
+   * QPU usage time reported by the backend.
+   *
+   * Returns `null` when no QPU timing was provided. This matches Python's
+   * `qpu` property.
+   */
+  get qpu(): number | null
+}
+export type JsTiming = Timing
+
+export declare const enum Sense {
+  Max = 0,
+  Min = 1
+}

package/js_lunamodel.wasi-browser.js

@@ -0,0 +1,67 @@
+import {
+  createOnMessage as __wasmCreateOnMessageForFsProxy,
+  getDefaultContext as __emnapiGetDefaultContext,
+  instantiateNapiModuleSync as __emnapiInstantiateNapiModuleSync,
+  WASI as __WASI,
+} from '@napi-rs/wasm-runtime'
+
+
+
+const __wasi = new __WASI({
+  version: 'preview1',
+})
+
+const __wasmUrl = new URL('./js_lunamodel.wasm32-wasi.wasm', import.meta.url).href
+const __emnapiContext = __emnapiGetDefaultContext()
+
+
+const __sharedMemory = new WebAssembly.Memory({
+  initial: 4000,
+  maximum: 65536,
+  shared: true,
+})
+
+const __wasmFile = await fetch(__wasmUrl).then((res) => res.arrayBuffer())
+
+const {
+  instance: __napiInstance,
+  module: __wasiModule,
+  napiModule: __napiModule,
+} = __emnapiInstantiateNapiModuleSync(__wasmFile, {
+  context: __emnapiContext,
+  asyncWorkPoolSize: 4,
+  wasi: __wasi,
+  onCreateWorker() {
+    const worker = new Worker(new URL('@aqarios/luna-model-wasm32-wasi/wasi-worker-browser.mjs', import.meta.url), {
+      type: 'module',
+    })
+
+
+    return worker
+  },
+  overwriteImports(importObject) {
+    importObject.env = {
+      ...importObject.env,
+      ...importObject.napi,
+      ...importObject.emnapi,
+      memory: __sharedMemory,
+    }
+    return importObject
+  },
+  beforeInit({ instance }) {
+    for (const name of Object.keys(instance.exports)) {
+      if (name.startsWith('__napi_register__')) {
+        instance.exports[name]()
+      }
+    }
+  },
+})
+export default __napiModule.exports
+export const ResultView = __napiModule.exports.ResultView
+export const JsResultView = __napiModule.exports.JsResultView
+export const Solution = __napiModule.exports.Solution
+export const JsSolution = __napiModule.exports.JsSolution
+export const Timing = __napiModule.exports.Timing
+export const JsTiming = __napiModule.exports.JsTiming
+export const Sense = __napiModule.exports.Sense
+export const JsSense = __napiModule.exports.JsSense

package/js_lunamodel.wasi.cjs

@@ -0,0 +1,118 @@
+/* eslint-disable */
+/* prettier-ignore */
+
+/* auto-generated by NAPI-RS */
+
+const __nodeFs = require('node:fs')
+const __nodePath = require('node:path')
+const { WASI: __nodeWASI } = require('node:wasi')
+const { Worker } = require('node:worker_threads')
+
+const {
+  createOnMessage: __wasmCreateOnMessageForFsProxy,
+  getDefaultContext: __emnapiGetDefaultContext,
+  instantiateNapiModuleSync: __emnapiInstantiateNapiModuleSync,
+} = require('@napi-rs/wasm-runtime')
+
+const __rootDir = __nodePath.parse(process.cwd()).root
+
+const __wasi = new __nodeWASI({
+  version: 'preview1',
+  env: process.env,
+  preopens: {
+    [__rootDir]: __rootDir,
+  }
+})
+
+const __emnapiContext = __emnapiGetDefaultContext()
+
+const __sharedMemory = new WebAssembly.Memory({
+  initial: 4000,
+  maximum: 65536,
+  shared: true,
+})
+
+let __wasmFilePath = __nodePath.join(__dirname, 'js_lunamodel.wasm32-wasi.wasm')
+const __wasmDebugFilePath = __nodePath.join(__dirname, 'js_lunamodel.wasm32-wasi.debug.wasm')
+
+if (__nodeFs.existsSync(__wasmDebugFilePath)) {
+  __wasmFilePath = __wasmDebugFilePath
+} else if (!__nodeFs.existsSync(__wasmFilePath)) {
+  try {
+    __wasmFilePath = require.resolve('@aqarios/luna-model-wasm32-wasi/js_lunamodel.wasm32-wasi.wasm')
+  } catch {
+    throw new Error('Cannot find js_lunamodel.wasm32-wasi.wasm file, and @aqarios/luna-model-wasm32-wasi package is not installed.')
+  }
+}
+
+const { instance: __napiInstance, module: __wasiModule, napiModule: __napiModule } = __emnapiInstantiateNapiModuleSync(__nodeFs.readFileSync(__wasmFilePath), {
+  context: __emnapiContext,
+  asyncWorkPoolSize: (function() {
+    const threadsSizeFromEnv = Number(process.env.NAPI_RS_ASYNC_WORK_POOL_SIZE ?? process.env.UV_THREADPOOL_SIZE)
+    // NaN > 0 is false
+    if (threadsSizeFromEnv > 0) {
+      return threadsSizeFromEnv
+    } else {
+      return 4
+    }
+  })(),
+  reuseWorker: true,
+  wasi: __wasi,
+  onCreateWorker() {
+    const worker = new Worker(__nodePath.join(__dirname, 'wasi-worker.mjs'), {
+      env: process.env,
+    })
+    worker.onmessage = ({ data }) => {
+      __wasmCreateOnMessageForFsProxy(__nodeFs)(data)
+    }
+
+    // The main thread of Node.js waits for all the active handles before exiting.
+    // But Rust threads are never waited without `thread::join`.
+    // So here we hack the code of Node.js to prevent the workers from being referenced (active).
+    // According to https://github.com/nodejs/node/blob/19e0d472728c79d418b74bddff588bea70a403d0/lib/internal/worker.js#L415,
+    // a worker is consist of two handles: kPublicPort and kHandle.
+    {
+      const kPublicPort = Object.getOwnPropertySymbols(worker).find(s =>
+        s.toString().includes("kPublicPort")
+      );
+      if (kPublicPort) {
+        worker[kPublicPort].ref = () => {};
+      }
+
+      const kHandle = Object.getOwnPropertySymbols(worker).find(s =>
+        s.toString().includes("kHandle")
+      );
+      if (kHandle) {
+        worker[kHandle].ref = () => {};
+      }
+
+      worker.unref();
+    }
+    return worker
+  },
+  overwriteImports(importObject) {
+    importObject.env = {
+      ...importObject.env,
+      ...importObject.napi,
+      ...importObject.emnapi,
+      memory: __sharedMemory,
+    }
+    return importObject
+  },
+  beforeInit({ instance }) {
+    for (const name of Object.keys(instance.exports)) {
+      if (name.startsWith('__napi_register__')) {
+        instance.exports[name]()
+      }
+    }
+  },
+})
+module.exports = __napiModule.exports
+module.exports.ResultView = __napiModule.exports.ResultView
+module.exports.JsResultView = __napiModule.exports.JsResultView
+module.exports.Solution = __napiModule.exports.Solution
+module.exports.JsSolution = __napiModule.exports.JsSolution
+module.exports.Timing = __napiModule.exports.Timing
+module.exports.JsTiming = __napiModule.exports.JsTiming
+module.exports.Sense = __napiModule.exports.Sense
+module.exports.JsSense = __napiModule.exports.JsSense

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@aqarios/luna-model-wasm32-wasi",
+  "version": "0.6.4",
+  "main": "js_lunamodel.wasi.cjs",
+  "files": [
+    "js_lunamodel.wasm32-wasi.wasm",
+    "js_lunamodel.wasi.cjs",
+    "js_lunamodel.wasi-browser.js",
+    "wasi-worker.mjs",
+    "wasi-worker-browser.mjs",
+    "index.d.ts"
+  ],
+  "description": "JavaScript and TypeScript bindings for LunaModel",
+  "author": "Aqarios GmbH <pypi@aqarios.com>",
+  "license": "Apache-2.0",
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aqarios/luna-model.git",
+    "directory": "js-lunamodel"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "browser": "js_lunamodel.wasi-browser.js",
+  "dependencies": {
+    "@napi-rs/wasm-runtime": "^1.1.5",
+    "@emnapi/core": "1.11.1",
+    "@emnapi/runtime": "1.11.1"
+  },
+  "types": "index.d.ts",
+  "module": "js_lunamodel.wasi-browser.js",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "browser": "./js_lunamodel.wasi-browser.js",
+      "import": "./js_lunamodel.wasi.cjs",
+      "require": "./js_lunamodel.wasi.cjs"
+    },
+    "./js_lunamodel.wasm32-wasi.wasm": "./js_lunamodel.wasm32-wasi.wasm",
+    "./wasi-worker-browser.mjs": "./wasi-worker-browser.mjs",
+    "./wasi-worker.mjs": "./wasi-worker.mjs"
+  }
+}

package/wasi-worker-browser.mjs

@@ -0,0 +1,34 @@
+import { instantiateNapiModuleSync, MessageHandler, WASI } from '@napi-rs/wasm-runtime'
+
+const handler = new MessageHandler({
+  onLoad({ wasmModule, wasmMemory }) {
+    const wasi = new WASI({
+      print: function () {
+        // eslint-disable-next-line no-console
+        console.log.apply(console, arguments)
+      },
+      printErr: function() {
+        // eslint-disable-next-line no-console
+        console.error.apply(console, arguments)
+        
+      },
+    })
+    return instantiateNapiModuleSync(wasmModule, {
+      childThread: true,
+      wasi,
+      overwriteImports(importObject) {
+        importObject.env = {
+          ...importObject.env,
+          ...importObject.napi,
+          ...importObject.emnapi,
+          memory: wasmMemory,
+        }
+      },
+    })
+  },
+  
+})
+
+globalThis.onmessage = function (e) {
+  handler.handle(e)
+}

package/wasi-worker.mjs

@@ -0,0 +1,63 @@
+import fs from "node:fs";
+import { createRequire } from "node:module";
+import { parse } from "node:path";
+import { WASI } from "node:wasi";
+import { parentPort, Worker } from "node:worker_threads";
+
+const require = createRequire(import.meta.url);
+
+const { instantiateNapiModuleSync, MessageHandler, getDefaultContext } = require("@napi-rs/wasm-runtime");
+
+if (parentPort) {
+  parentPort.on("message", (data) => {
+    globalThis.onmessage({ data });
+  });
+}
+
+Object.assign(globalThis, {
+  self: globalThis,
+  require,
+  Worker,
+  importScripts: function (f) {
+    ;(0, eval)(fs.readFileSync(f, "utf8") + "//# sourceURL=" + f);
+  },
+  postMessage: function (msg) {
+    if (parentPort) {
+      parentPort.postMessage(msg);
+    }
+  },
+});
+
+const emnapiContext = getDefaultContext();
+
+const __rootDir = parse(process.cwd()).root;
+
+const handler = new MessageHandler({
+  onLoad({ wasmModule, wasmMemory }) {
+    const wasi = new WASI({
+      version: 'preview1',
+      env: process.env,
+      preopens: {
+        [__rootDir]: __rootDir,
+      },
+    });
+
+    return instantiateNapiModuleSync(wasmModule, {
+      childThread: true,
+      wasi,
+      context: emnapiContext,
+      overwriteImports(importObject) {
+        importObject.env = {
+          ...importObject.env,
+          ...importObject.napi,
+          ...importObject.emnapi,
+          memory: wasmMemory
+        };
+      },
+    });
+  },
+});
+
+globalThis.onmessage = function (e) {
+  handler.handle(e);
+};