@runtimed/node 0.0.1

package/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2024, runtimed
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@runtimed/node",
+  "version": "0.0.1",
+  "description": "Node.js bindings for the runtimed daemon client (napi-rs).",
+  "type": "module",
+  "license": "BSD-3-Clause",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nteract/desktop.git",
+    "directory": "packages/runtimed-node"
+  },
+  "main": "./src/index.cjs",
+  "types": "./src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./src/index.d.ts",
+      "require": "./src/index.cjs",
+      "default": "./src/index.cjs"
+    }
+  },
+  "files": [
+    "src/index.cjs",
+    "src/index.d.ts",
+    "src/binding.cjs",
+    "src/binding.d.ts"
+  ],
+  "napi": {
+    "binaryName": "runtimed-node",
+    "targets": [
+      "x86_64-unknown-linux-gnu"
+    ]
+  },
+  "optionalDependencies": {
+    "@runtimed/node-darwin-arm64": "0.0.1",
+    "@runtimed/node-linux-x64-gnu": "0.0.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@napi-rs/cli": "^3.6.2"
+  },
+  "scripts": {
+    "assemble:platform": "node scripts/assemble-platform-package.mjs",
+    "build": "napi build --platform --release --js binding.cjs --dts binding.d.ts --manifest-path ../../crates/runtimed-node/Cargo.toml --output-dir src",
+    "build:debug": "napi build --platform --js binding.cjs --dts binding.d.ts --manifest-path ../../crates/runtimed-node/Cargo.toml --output-dir src",
+    "pack:platform:dry-run": "node scripts/assemble-platform-package.mjs --pack-dry-run",
+    "pack:dry-run": "pnpm pack --dry-run",
+    "smoke": "node -e \"const m = require('./src/index.cjs'); console.log('defaultSocketPath:', m.defaultSocketPath());\""
+  }
+}

package/src/binding.cjs

@@ -0,0 +1,586 @@
+// prettier-ignore
+/* eslint-disable */
+// @ts-nocheck
+/* auto-generated by NAPI-RS */
+
+const { readFileSync } = require('node:fs')
+let nativeBinding = null
+const loadErrors = []
+
+const isMusl = () => {
+  let musl = false
+  if (process.platform === 'linux') {
+    musl = isMuslFromFilesystem()
+    if (musl === null) {
+      musl = isMuslFromReport()
+    }
+    if (musl === null) {
+      musl = isMuslFromChildProcess()
+    }
+  }
+  return musl
+}
+
+const isFileMusl = (f) => f.includes('libc.musl-') || f.includes('ld-musl-')
+
+const isMuslFromFilesystem = () => {
+  try {
+    return readFileSync('/usr/bin/ldd', 'utf-8').includes('musl')
+  } catch {
+    return null
+  }
+}
+
+const isMuslFromReport = () => {
+  let report = null
+  if (typeof process.report?.getReport === 'function') {
+    process.report.excludeNetwork = true
+    report = process.report.getReport()
+  }
+  if (!report) {
+    return null
+  }
+  if (report.header && report.header.glibcVersionRuntime) {
+    return false
+  }
+  if (Array.isArray(report.sharedObjects)) {
+    if (report.sharedObjects.some(isFileMusl)) {
+      return true
+    }
+  }
+  return false
+}
+
+const isMuslFromChildProcess = () => {
+  try {
+    return require('child_process').execSync('ldd --version', { encoding: 'utf8' }).includes('musl')
+  } catch (e) {
+    // If we reach this case, we don't know if the system is musl or not, so is better to just fallback to false
+    return false
+  }
+}
+
+function requireNative() {
+  if (process.env.NAPI_RS_NATIVE_LIBRARY_PATH) {
+    try {
+      return require(process.env.NAPI_RS_NATIVE_LIBRARY_PATH);
+    } catch (err) {
+      loadErrors.push(err)
+    }
+  } else if (process.platform === 'android') {
+    if (process.arch === 'arm64') {
+      try {
+        return require('./runtimed-node.android-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@runtimed/node-android-arm64')
+        const bindingPackageVersion = require('@runtimed/node-android-arm64/package.json').version
+        if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm') {
+      try {
+        return require('./runtimed-node.android-arm-eabi.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@runtimed/node-android-arm-eabi')
+        const bindingPackageVersion = require('@runtimed/node-android-arm-eabi/package.json').version
+        if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Android ${process.arch}`))
+    }
+  } else if (process.platform === 'win32') {
+    if (process.arch === 'x64') {
+      if (process.config?.variables?.shlib_suffix === 'dll.a' || process.config?.variables?.node_target_type === 'shared_library') {
+        try {
+        return require('./runtimed-node.win32-x64-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@runtimed/node-win32-x64-gnu')
+        const bindingPackageVersion = require('@runtimed/node-win32-x64-gnu/package.json').version
+        if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      } else {
+        try {
+        return require('./runtimed-node.win32-x64-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@runtimed/node-win32-x64-msvc')
+        const bindingPackageVersion = require('@runtimed/node-win32-x64-msvc/package.json').version
+        if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      }
+    } else if (process.arch === 'ia32') {
+      try {
+        return require('./runtimed-node.win32-ia32-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@runtimed/node-win32-ia32-msvc')
+        const bindingPackageVersion = require('@runtimed/node-win32-ia32-msvc/package.json').version
+        if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm64') {
+      try {
+        return require('./runtimed-node.win32-arm64-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@runtimed/node-win32-arm64-msvc')
+        const bindingPackageVersion = require('@runtimed/node-win32-arm64-msvc/package.json').version
+        if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Windows: ${process.arch}`))
+    }
+  } else if (process.platform === 'darwin') {
+    try {
+      return require('./runtimed-node.darwin-universal.node')
+    } catch (e) {
+      loadErrors.push(e)
+    }
+    try {
+      const binding = require('@runtimed/node-darwin-universal')
+      const bindingPackageVersion = require('@runtimed/node-darwin-universal/package.json').version
+      if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+        throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      }
+      return binding
+    } catch (e) {
+      loadErrors.push(e)
+    }
+    if (process.arch === 'x64') {
+      try {
+        return require('./runtimed-node.darwin-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@runtimed/node-darwin-x64')
+        const bindingPackageVersion = require('@runtimed/node-darwin-x64/package.json').version
+        if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm64') {
+      try {
+        return require('./runtimed-node.darwin-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@runtimed/node-darwin-arm64')
+        const bindingPackageVersion = require('@runtimed/node-darwin-arm64/package.json').version
+        if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on macOS: ${process.arch}`))
+    }
+  } else if (process.platform === 'freebsd') {
+    if (process.arch === 'x64') {
+      try {
+        return require('./runtimed-node.freebsd-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@runtimed/node-freebsd-x64')
+        const bindingPackageVersion = require('@runtimed/node-freebsd-x64/package.json').version
+        if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm64') {
+      try {
+        return require('./runtimed-node.freebsd-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@runtimed/node-freebsd-arm64')
+        const bindingPackageVersion = require('@runtimed/node-freebsd-arm64/package.json').version
+        if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on FreeBSD: ${process.arch}`))
+    }
+  } else if (process.platform === 'linux') {
+    if (process.arch === 'x64') {
+      if (isMusl()) {
+        try {
+          return require('./runtimed-node.linux-x64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@runtimed/node-linux-x64-musl')
+          const bindingPackageVersion = require('@runtimed/node-linux-x64-musl/package.json').version
+          if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./runtimed-node.linux-x64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@runtimed/node-linux-x64-gnu')
+          const bindingPackageVersion = require('@runtimed/node-linux-x64-gnu/package.json').version
+          if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'arm64') {
+      if (isMusl()) {
+        try {
+          return require('./runtimed-node.linux-arm64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@runtimed/node-linux-arm64-musl')
+          const bindingPackageVersion = require('@runtimed/node-linux-arm64-musl/package.json').version
+          if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./runtimed-node.linux-arm64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@runtimed/node-linux-arm64-gnu')
+          const bindingPackageVersion = require('@runtimed/node-linux-arm64-gnu/package.json').version
+          if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'arm') {
+      if (isMusl()) {
+        try {
+          return require('./runtimed-node.linux-arm-musleabihf.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@runtimed/node-linux-arm-musleabihf')
+          const bindingPackageVersion = require('@runtimed/node-linux-arm-musleabihf/package.json').version
+          if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./runtimed-node.linux-arm-gnueabihf.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@runtimed/node-linux-arm-gnueabihf')
+          const bindingPackageVersion = require('@runtimed/node-linux-arm-gnueabihf/package.json').version
+          if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'loong64') {
+      if (isMusl()) {
+        try {
+          return require('./runtimed-node.linux-loong64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@runtimed/node-linux-loong64-musl')
+          const bindingPackageVersion = require('@runtimed/node-linux-loong64-musl/package.json').version
+          if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./runtimed-node.linux-loong64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@runtimed/node-linux-loong64-gnu')
+          const bindingPackageVersion = require('@runtimed/node-linux-loong64-gnu/package.json').version
+          if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'riscv64') {
+      if (isMusl()) {
+        try {
+          return require('./runtimed-node.linux-riscv64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@runtimed/node-linux-riscv64-musl')
+          const bindingPackageVersion = require('@runtimed/node-linux-riscv64-musl/package.json').version
+          if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./runtimed-node.linux-riscv64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@runtimed/node-linux-riscv64-gnu')
+          const bindingPackageVersion = require('@runtimed/node-linux-riscv64-gnu/package.json').version
+          if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'ppc64') {
+      try {
+        return require('./runtimed-node.linux-ppc64-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@runtimed/node-linux-ppc64-gnu')
+        const bindingPackageVersion = require('@runtimed/node-linux-ppc64-gnu/package.json').version
+        if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 's390x') {
+      try {
+        return require('./runtimed-node.linux-s390x-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@runtimed/node-linux-s390x-gnu')
+        const bindingPackageVersion = require('@runtimed/node-linux-s390x-gnu/package.json').version
+        if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Linux: ${process.arch}`))
+    }
+  } else if (process.platform === 'openharmony') {
+    if (process.arch === 'arm64') {
+      try {
+        return require('./runtimed-node.openharmony-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@runtimed/node-openharmony-arm64')
+        const bindingPackageVersion = require('@runtimed/node-openharmony-arm64/package.json').version
+        if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'x64') {
+      try {
+        return require('./runtimed-node.openharmony-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@runtimed/node-openharmony-x64')
+        const bindingPackageVersion = require('@runtimed/node-openharmony-x64/package.json').version
+        if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm') {
+      try {
+        return require('./runtimed-node.openharmony-arm.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@runtimed/node-openharmony-arm')
+        const bindingPackageVersion = require('@runtimed/node-openharmony-arm/package.json').version
+        if (bindingPackageVersion !== '0.0.1' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.0.1 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on OpenHarmony: ${process.arch}`))
+    }
+  } else {
+    loadErrors.push(new Error(`Unsupported OS: ${process.platform}, architecture: ${process.arch}`))
+  }
+}
+
+nativeBinding = requireNative()
+
+if (!nativeBinding || process.env.NAPI_RS_FORCE_WASI) {
+  let wasiBinding = null
+  let wasiBindingError = null
+  try {
+    wasiBinding = require('./runtimed-node.wasi.cjs')
+    nativeBinding = wasiBinding
+  } catch (err) {
+    if (process.env.NAPI_RS_FORCE_WASI) {
+      wasiBindingError = err
+    }
+  }
+  if (!nativeBinding || process.env.NAPI_RS_FORCE_WASI) {
+    try {
+      wasiBinding = require('@runtimed/node-wasm32-wasi')
+      nativeBinding = wasiBinding
+    } catch (err) {
+      if (process.env.NAPI_RS_FORCE_WASI) {
+        if (!wasiBindingError) {
+          wasiBindingError = err
+        } else {
+          wasiBindingError.cause = err
+        }
+        loadErrors.push(err)
+      }
+    }
+  }
+  if (process.env.NAPI_RS_FORCE_WASI === 'error' && !wasiBinding) {
+    const error = new Error('WASI binding not found and NAPI_RS_FORCE_WASI is set to error')
+    error.cause = wasiBindingError
+    throw error
+  }
+}
+
+if (!nativeBinding) {
+  if (loadErrors.length > 0) {
+    throw new Error(
+      `Cannot find native binding. ` +
+        `npm has a bug related to optional dependencies (https://github.com/npm/cli/issues/4828). ` +
+        'Please try `npm i` again after removing both package-lock.json and node_modules directory.',
+      {
+        cause: loadErrors.reduce((err, cur) => {
+          cur.cause = err
+          return cur
+        }),
+      },
+    )
+  }
+  throw new Error(`Failed to load native binding`)
+}
+
+module.exports = nativeBinding
+module.exports.Session = nativeBinding.Session
+module.exports.createNotebook = nativeBinding.createNotebook
+module.exports.defaultSocketPath = nativeBinding.defaultSocketPath
+module.exports.getExecutionResult = nativeBinding.getExecutionResult
+module.exports.openNotebook = nativeBinding.openNotebook
+module.exports.readParquetFile = nativeBinding.readParquetFile
+module.exports.socketPathForChannel = nativeBinding.socketPathForChannel
+module.exports.summarizeParquetFile = nativeBinding.summarizeParquetFile

package/src/binding.d.ts

@@ -0,0 +1,172 @@
+/* auto-generated by NAPI-RS */
+/* eslint-disable */
+/** A connected notebook session. */
+export declare class Session {
+  /** The notebook ID (always a UUID). */
+  get notebookId(): string
+  /**
+   * Save the notebook to disk. If a path is given, saves to that path
+   * (creating the file if needed). Otherwise saves to the original location.
+   */
+  saveNotebook(path?: string | undefined | null): Promise<void>
+  /** Close the session and release the underlying connection. */
+  close(): Promise<void>
+  /**
+   * Add a UV dependency to the notebook (e.g. `"matplotlib>=3.8"`).
+   * Call `syncEnvironment()` or restart the kernel to install it.
+   */
+  addUvDependency(pkg: string): Promise<void>
+  /** Get the current dependency fingerprint used for guarded trust approval. */
+  dependencyFingerprint(): Promise<string | null>
+  /** Approve and sign the current dependency metadata. */
+  approveTrust(dependencyFingerprint?: string | undefined | null): Promise<void>
+  /**
+   * Ask the daemon to hot-install any pending dependency changes into
+   * the running kernel's env. Starts the kernel first if needed.
+   * Returns once the install finishes.
+   */
+  syncEnvironment(): Promise<void>
+  /**
+   * Execute a source string as a new cell. Starts the kernel on demand.
+   * Returns the cell's outputs once execution is terminal.
+   */
+  runCell(source: string, options?: RunCellOptions | undefined | null): Promise<CellResult>
+  /** Queue a source string as a new cell without waiting for execution. */
+  queueCell(source: string, options?: QueueCellOptions | undefined | null): Promise<QueuedExecution>
+  /** Wait for an already-queued execution in this live session. */
+  waitForExecution(executionId: string, options?: WaitExecutionOptions | undefined | null): Promise<CellResult>
+}
+
+/** Result of running a cell. */
+export interface CellResult {
+  cellId: string
+  executionId: string
+  executionCount?: number
+  /** One of: `"done"`, `"error"`, `"timeout"`, `"kernel_error"`. */
+  status: string
+  success: boolean
+  outputs: Array<JsOutput>
+}
+
+/** Create a new (ephemeral) notebook against the daemon. */
+export declare function createNotebook(options?: CreateNotebookOptions | undefined | null): Promise<Session>
+
+/** Options for `createNotebook()`. */
+export interface CreateNotebookOptions {
+  /** Runtime type: `"python"` or `"deno"`. Defaults to `"python"`. */
+  runtime?: string
+  /** Working directory for the kernel. */
+  workingDir?: string
+  /** Override daemon socket path (otherwise uses `default_socket_path()`). */
+  socketPath?: string
+  /** Actor label for presence / Automerge provenance. */
+  peerLabel?: string
+}
+
+/**
+ * Return the default daemon socket path.
+ *
+ * Respects `RUNTIMED_SOCKET_PATH` if set. In dev mode
+ * (`RUNTIMED_WORKSPACE_PATH` set) returns the per-worktree socket.
+ */
+export declare function defaultSocketPath(): string
+
+/** Read a terminal execution result from the daemon's durable execution store. */
+export declare function getExecutionResult(executionId: string, options?: GetExecutionResultOptions | undefined | null): Promise<CellResult>
+
+/** Options for top-level `getExecutionResult()`. */
+export interface GetExecutionResultOptions {
+  /** Override daemon socket path (otherwise uses `defaultSocketPath()`). */
+  socketPath?: string
+}
+
+/** One output from a cell. `data` values are: `{ type: "text"|"binary"|"json", value: ... }`. */
+export interface JsOutput {
+  outputType: string
+  name?: string
+  text?: string
+  /** MIME-keyed map, serialized via JSON. Binary values become base64 strings. */
+  dataJson?: string
+  ename?: string
+  evalue?: string
+  traceback?: Array<string>
+  executionCount?: number
+  blobUrlsJson?: string
+  blobPathsJson?: string
+}
+
+/** Open an existing notebook by ID. */
+export declare function openNotebook(notebookId: string, options?: OpenNotebookOptions | undefined | null): Promise<Session>
+
+/** Options for `openNotebook()`. */
+export interface OpenNotebookOptions {
+  socketPath?: string
+  peerLabel?: string
+}
+
+export interface ParquetColumnInfo {
+  name: string
+  dataType: string
+  nullCount: number
+  /** JSON-encoded column stats (numeric: {min, max}, string: {distinct_count, top}, etc.) */
+  statsJson: string
+}
+
+/** A page of rows from a parquet file, as string values for display. */
+export interface ParquetRowPage {
+  columns: Array<string>
+  /** Row data — outer vec is rows, inner vec is column values as display strings. */
+  rows: Array<Array<string>>
+  totalRows: number
+  offset: number
+}
+
+/** Summary of a parquet dataset — column names, types, stats. */
+export interface ParquetSummaryResult {
+  numRows: number
+  numBytes: number
+  columns: Array<ParquetColumnInfo>
+}
+
+/** Options for `Session.queueCell()`. */
+export interface QueueCellOptions {
+  /** Cell source type: `"code"` (default), `"markdown"`, or `"raw"`. */
+  cellType?: string
+}
+
+/** A queued execution handle. */
+export interface QueuedExecution {
+  cellId: string
+  executionId: string
+}
+
+/**
+ * Read a page of rows from a local blob/file path.
+ * Returns string representations of each cell for display.
+ */
+export declare function readParquetFile(filePath: string, offset: number, limit: number): ParquetRowPage
+
+/** Options for `Session.runCell()`. */
+export interface RunCellOptions {
+  /** Max milliseconds to wait for execution. Default 120_000 (2 min). */
+  timeoutMs?: number
+  /** Cell source type: `"code"` (default), `"markdown"`, or `"raw"`. */
+  cellType?: string
+}
+
+/**
+ * Return the daemon socket path for a specific channel ("stable" or
+ * "nightly"). Ignores `RUNTIMED_SOCKET_PATH`.
+ */
+export declare function socketPathForChannel(channel: string): string
+
+/** Summarize a parquet file from a local blob/file path. */
+export declare function summarizeParquetFile(filePath: string): ParquetSummaryResult
+
+/** Options for `Session.waitForExecution()`. */
+export interface WaitExecutionOptions {
+  /** Cell ID to use when reporting kernel failures before terminal state syncs. */
+  cellId?: string
+  /** Max milliseconds to wait for execution. Default 120_000 (2 min). */
+  timeoutMs?: number
+}

package/src/index.cjs

@@ -0,0 +1,12 @@
+/**
+ * @runtimed/node — thin JS wrapper over the N-API binding.
+ *
+ * The native binding lives in `binding.cjs` + `runtimed-node.<triple>.node`.
+ * This file exists so consumers can `require('@runtimed/node')`
+ * without thinking about platform suffixes.
+ */
+"use strict";
+
+const binding = require("./binding.cjs");
+
+module.exports = binding;

package/src/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @runtimed/node — Node.js bindings for the runtimed daemon.
+ *
+ * This file re-exports the types generated by napi-rs into binding.d.ts.
+ */
+
+export * from "./binding.cjs";