@opys/binding 0.0.0-stage → 0.3.0

package/README.md

@@ -1,3 +1,11 @@
-# Temporary Holding Version
+# opys-napi
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Internal crate — the one napi-rs cdylib of opys, producing the `@opys/binding`
+N-API addon. Every crate with a JS surface is a module here and a namespace
+in the addon. Not consumed by Rust callers; ships via npm.
+
+Rust consumers depend on the crate they need, such as
+[`opys-core`](https://crates.io/crates/opys-core). JS/TS consumers depend on
+the `@opys/*` package of the same name.
+
+Part of the [opys](https://github.com/harmoniya-net/opys) toolkit.

package/index.d.ts

@@ -0,0 +1,450 @@
+/* tslint:disable */
+/* eslint-disable */
+
+/* auto-generated by NAPI-RS */
+
+export declare namespace authliberty {
+  /**
+   * Resolve AuthLiberty into `{ artifacts, jvmArgs, release }` — the agent jar
+   * and the JVM arguments that load it.
+   */
+  export function resolveAuthliberty(options: Json): Promise<Json>
+  /**
+   * Run the `authliberty` plugin: the same resolve, returned as the
+   * contribution to merge — `{ name, contribution }`.
+   */
+  export function buildAuthliberty(options: Json): Promise<Json>
+  /**
+   * Resolve a version, or `latest`, to `{ version, filename, url, size,
+   * sha256?, createdAt }` against the GitLab package registry.
+   */
+  export function resolveAuthLibertyVersion(version: string, options: Json): Promise<Json>
+}
+export declare namespace bifrost {
+  /** Mint a Bifrost token: `{ username, uuid, token }`. */
+  export function mintBifrost(options: Json): Json
+  /** How long a token lives when no lifetime is given, in seconds. */
+  export function defaultBifrostTtl(): number
+}
+export declare namespace bundle {
+  /** The id of the blob holding exactly `bytes`: the hex sha256 of them. */
+  export function blobId(bytes: Buffer): string
+  export interface HashedBlob {
+    id: string
+    /** A file size, which fits a JS number long before it fits nowhere. */
+    size: number
+  }
+  /** The id and size of the blob a file on disk would be. */
+  export function hashBlobFile(path: string): Promise<unknown>
+  /**
+   * Write `manifest` and the blobs it names to `path` as a bundle, under
+   * `head`.
+   */
+  export function writeBundle(path: string, head: Json, manifest: Json, blobs: Json): Promise<unknown>
+  /** The manifest of the bundle at `path`. */
+  export function readBundle(path: string): Json
+  /**
+   * The head of the bundle at `path`: what it says about itself. The manifest
+   * is left unread.
+   */
+  export function readBundleHead(path: string): Json
+  /** The bundle format this build reads and writes. */
+  export function bundleFormat(): number
+}
+export declare namespace cleanroom {
+  /**
+   * Resolve Cleanroom into `{ artifacts, vars, classpath, launch, jvmArgs,
+   * mainClass, gameArgs }` — the release's published version document, mapped
+   * the way a vanilla one is.
+   */
+  export function resolveCleanroom(options: Json): Promise<Json>
+  /**
+   * Run the `cleanroom` plugin: the same resolve, returned as the contribution
+   * to merge — `{ name, contribution }`.
+   */
+  export function buildCleanroom(options: Json): Promise<Json>
+  /**
+   * Resolve a Minecraft version, an alias or a release tag to `{ minecraft,
+   * cleanroom, documentUrl }`.
+   */
+  export function resolveCleanroomVersion(input: string, source: string): Promise<Json>
+  /** The canonical document index base URL. */
+  export function defaultCleanroomIndex(): string
+}
+export declare namespace core {
+  /**
+   * Decode a wire manifest (plain JS object) into the domain shape.
+   * Returns the domain object as plain JS.
+   */
+  export function decodeManifest(wire: Json): Json
+  /** Encode a domain manifest back to its wire form. */
+  export function encodeManifest(domain: Json): Json
+  /** Parse a JSON-string manifest and return the domain shape as JS. */
+  export function parseManifest(input: string): Json
+  export interface OsOptions {
+    name: string
+    version: string
+    arch: string
+  }
+  /** Resolve `${var}` references in a flat var map. Throws on circular refs. */
+  export function resolveVars(vars: Record<string, string>): Record<string, string>
+  /** Substitute resolved vars into a template string. */
+  export function interpolate(template: string, vars: Record<string, string>): string
+  /** Drop artifacts whose rules exclude the given platform / features. */
+  export function filterManifest(manifest: Json, platform: OsOptions, features: Array<string>): Json
+  /** Resolve a Launch's `args` rule-tagged values for the given platform. */
+  export function resolvedArgs(launch: Json, platform: OsOptions, features: Array<string>): Array<string>
+  /** Resolve a Launch's `envs` rule-tagged values for the given platform. */
+  export function resolvedEnvs(launch: Json, platform: OsOptions, features: Array<string>): Record<string, string>
+  /** Evaluate a ruleset against a platform + active features. */
+  export function satisfiesRuleset(rules: Json, platform: OsOptions, features: Array<string>): boolean
+  /** Compile a glob to its regex source. */
+  export function globToRegexSource(glob: string): string
+  /** The non-wildcard prefix of a glob, where a cleanup rule starts walking. */
+  export function globBase(glob: string): string
+  /** Single discriminated error shape (Q10 in design doc). */
+  export interface OpysErrorInfo {
+    code: string
+    message: string
+  }
+}
+export declare namespace curseforge {
+  /**
+   * Resolve file references — ids or `/files/<id>` URLs — to one file each, in
+   * the order given: `{ fileId, projectId, filename, size, url, sha1? }[]`.
+   */
+  export function resolveCurseforgeFiles(token: string, references: Json, apiBase: string): Promise<Json>
+  /**
+   * Look files up by id. The result is in the API's order and omits any id it
+   * does not know.
+   */
+  export function fetchCurseforgeFiles(token: string, fileIds: Json, apiBase: string): Promise<Json>
+  /**
+   * Resolve a modpack to `{ manifest, loader, files, overrides }` — everything
+   * but the loader itself.
+   */
+  export function resolveCurseforgeModpack(token: string, reference: Json, apiBase: string): Promise<Json>
+  /**
+   * Turn resolved files into artifacts, each at the path chosen for it. The
+   * paths come from the config author's callback, which only the host can run.
+   */
+  export function curseforgeFileArtifacts(files: Json, paths: Array<string>): Json
+  /** Map a modpack `manifest.json` to the loader it runs on. */
+  export function loaderSpecFromManifest(manifest: Json): Json
+  /** The id a file reference names — the number, or the one in its URL. */
+  export function parseFileRef(reference: Json): number
+  /** CurseForge's public API base. */
+  export function defaultCurseforgeApi(): string
+}
+export declare namespace dev {
+  /**
+   * Merge plugin contributions and the author's manifest config into a
+   * manifest. Returns `{ manifest, blobs, warnings }` — warnings are returned rather
+   * than logged so the engine stays pure and JS keeps its own log channel.
+   *
+   * A contribution's `launch` groups are ignored here even when present: the
+   * caller resolves them through the author's accessors before calling in, and
+   * hands the result over as `args` / `command`.
+   */
+  export function assemble(outputs: Json, config: Json): Json
+  /**
+   * Every regular file under `directory`, in path order:
+   * `{ rel, dir, filename, abs, size }[]`.
+   */
+  export function scanDirectory(directory: string): Promise<unknown>
+  /**
+   * Hash the placed files — `{ abs, path, url? }[]` — and return the
+   * contribution: a blob artifact for each file with no `url`, a pinned URL
+   * artifact for each with one.
+   *
+   * Placing is the caller's because it is the config author's: `path` and
+   * `url` may be functions, and a function does not cross into here.
+   */
+  export function scannedFiles(files: Json, hash?: string | undefined | null): Promise<unknown>
+}
+export declare namespace dgpuj {
+  /**
+   * Resolve dgpuj into `{ artifacts, vars, release }` — one archive per
+   * target, the vars that find the binary, and the release they came from.
+   */
+  export function resolveDgpuj(options: Json): Promise<Json>
+  /** Run the `dgpuj` plugin: `{ output: { name, contribution }, release }`. */
+  export function buildDgpuj(options: Json): Promise<Json>
+  /** dgpuj's published targets. */
+  export function defaultDgpujPlatforms(): Json
+  /** Where dgpuj's releases are published. */
+  export function defaultDgpujRepo(): string
+}
+export declare namespace fabric {
+  /**
+   * Resolve Fabric into `{ artifacts, vars, classpath, launch, jvmArgs,
+   * mainClass, gameArgs }` — the loader's libraries folded onto the vanilla
+   * version its launcher profile inherits from.
+   */
+  export function resolveFabric(options: Json): Promise<Json>
+  /**
+   * Run the `fabric` plugin: the same resolve, returned as the contribution to
+   * merge — `{ name, contribution }`.
+   */
+  export function buildFabric(options: Json): Promise<Json>
+  /**
+   * Resolve a game version (and optional loader) to `{ gameVersion,
+   * loaderVersion, profileUrl }`. A pinned loader needs no request.
+   */
+  export function resolveFabricVersion(game: string, meta: string, loader?: string | undefined | null): Promise<Json>
+  /** The canonical Fabric Meta base URL. */
+  export function defaultFabricMeta(): string
+}
+export declare namespace forge {
+  /**
+   * Resolve Forge into `{ artifacts, vars, classpath, launch, jvmArgs,
+   * mainClass, gameArgs }` — the build's published version document folded onto
+   * the vanilla version it inherits from.
+   */
+  export function resolveForge(options: Json): Promise<Json>
+  /**
+   * Run the `forge` plugin: the same resolve, returned as the contribution to
+   * merge — `{ name, contribution }`.
+   */
+  export function buildForge(options: Json): Promise<Json>
+  /**
+   * Resolve a Minecraft version, an alias or a full build id to `{ minecraft,
+   * forge, documentUrl }`.
+   */
+  export function resolveForgeVersion(input: string, source: string): Promise<Json>
+  /** The canonical document index base URL. */
+  export function defaultForgeIndex(): string
+}
+export declare namespace java {
+  /** The (OS, arch) pairs every vendor resolver targets by default. */
+  export function defaultPlatforms(): Json
+  /**
+   * Resolve a JDK and build the manifest fragment that installs it —
+   * `{ artifacts, vars, release }`.
+   */
+  export function resolveJava(options: Json): Promise<Json>
+  /**
+   * Run the `java` plugin: the same resolve, returned as the contribution to
+   * merge — `{ output, release }`.
+   */
+  export function buildJava(options: Json): Promise<Json>
+  /** Resolve an Eclipse Temurin release across the requested platforms. */
+  export function resolveTemurin(version: string, opts?: Json | undefined | null): Promise<Json>
+  /** Resolve an Azul Zulu release across the requested platforms. */
+  export function resolveZulu(version: string, opts?: Json | undefined | null): Promise<Json>
+  /** Resolve a GraalVM CE release across the requested platforms. */
+  export function resolveGraalvm(version: string, opts?: Json | undefined | null): Promise<Json>
+}
+export declare namespace links {
+  /**
+   * Resolve links to pinned files, in the order given —
+   * `{ link, provider, filename, url, size, integrity? }[]`.
+   */
+  export function resolveLinks(links: Array<string>, options: Json): Promise<Json>
+  /**
+   * Turn resolved files into artifacts, each at the path chosen for it. The
+   * paths come from the config author's callback, which only the host can run.
+   */
+  export function linkFileArtifacts(files: Json, paths: Array<string>): Json
+}
+export declare namespace lwjgl3ify {
+  /**
+   * Resolve lwjgl3ify into `{ artifacts, vars, classpath, launch, jvmArgs,
+   * mainClass, gameArgs }` — the release's published version document, mapped
+   * the way a vanilla one is, with the jars for `mods/` added to `artifacts`.
+   */
+  export function resolveLwjgl3ify(options: Json): Promise<Json>
+  /**
+   * Run the `lwjgl3ify` plugin: the same resolve, returned as the contribution
+   * to merge — `{ name, contribution }`.
+   */
+  export function buildLwjgl3ify(options: Json): Promise<Json>
+  /**
+   * Resolve a Minecraft version, an alias or a release tag to `{ minecraft,
+   * lwjgl3ify, documentUrl }`.
+   */
+  export function resolveLwjgl3ifyVersion(input: string, source: string): Promise<Json>
+  /** The canonical document index base URL. */
+  export function defaultLwjgl3ifyIndex(): string
+}
+export declare namespace minecraftServerlist {
+  /**
+   * Run the `serverlist` plugin: `{ name, contribution }`, the contribution
+   * holding one generated `servers.dat` per distinct ruleset and its blob.
+   */
+  export function buildServerlist(servers: Json, options: Json): Json
+  /** Where the list goes unless a config says otherwise. */
+  export function defaultServerlistPath(): string
+}
+export declare namespace minecraftVanilla {
+  /**
+   * Resolve vanilla Minecraft into `{ artifacts, vars, classpath, launch,
+   * jvmArgs, mainClass, gameArgs }`.
+   */
+  export function resolveMinecraft(opts?: Json | undefined | null): Promise<Json>
+  /**
+   * Run the `minecraft` plugin: the same resolve, returned as the contribution
+   * to merge — `{ name, contribution }`.
+   */
+  export function buildMinecraft(opts?: Json | undefined | null): Promise<Json>
+  /** Look a version up in the version manifest and fetch its version JSON. */
+  export function fetchClient(opts?: Json | undefined | null): Promise<Json>
+  /** Map an already-resolved version JSON, fetching only its asset manifest. */
+  export function clientToTemplate(client: Json): Promise<Json>
+  /** Fetch `version_manifest_v2.json`, or another URL serving that document. */
+  export function fetchVersionManifest(url?: string | undefined | null): Promise<Json>
+  /** Fetch and parse an asset manifest. */
+  export function fetchAssetManifest(url: string): Promise<Json>
+  /**
+   * Turn a version JSON and its asset manifest into a template. The pure half
+   * of `clientToTemplate`, for a caller that already holds both.
+   */
+  export function mapClientToTemplate(client: Json, assets: Json): Json
+  export function mapClientJar(client: Json): Json
+  export function libraryToArtifact(library: Json): Json
+  export function mapLibraries(libraries: Json): Json
+  export function mapAssetIndex(index: Json): Json
+  export function mapAssetObjects(manifest: Json, indexId: string): Json
+  /** The `${classpath}` arms — one per OS, each led by the client jar. */
+  export function buildClasspath(libs: Json, clientJarPath: string): Json
+  /**
+   * `{ launch, jvmArgs, mainClass, gameArgs }` from a main class and the two
+   * argument lists.
+   */
+  export function buildLaunch(mainClass: string, gameArgs: Json, jvmArgs: Json): Json
+}
+export declare namespace modrinth {
+  /**
+   * Resolve version references to one file each, in the order given —
+   * `{ filename, versionId, projectId, versionNumber, size, url, sha1? }[]`.
+   */
+  export function resolveModrinthFiles(references: Array<string>, apiBase: string): Promise<Json>
+  /**
+   * Resolve a modpack to `{ index, dependencies, loader, files, overrides }` —
+   * everything but the loader itself.
+   */
+  export function resolveModrinthModpack(reference: string, apiBase: string): Promise<Json>
+  /**
+   * Turn resolved files into artifacts, each at the path chosen for it. The
+   * paths come from the config author's callback, which only the host can run.
+   */
+  export function modrinthFileArtifacts(files: Json, paths: Array<string>): Json
+  /** Map a `.mrpack`'s `dependencies` to the loader it runs on. */
+  export function loaderSpec(dependencies: Json): Json
+  /** Modrinth's public API base. */
+  export function defaultModrinthApi(): string
+}
+export declare namespace mojang {
+  export interface OsOptions {
+    name: string
+    version: string
+    arch: string
+  }
+  /** Parse a version-JSON client document into the domain shape. */
+  export function parseClient(raw: Json): Json
+  /** Parse the `libraries` array of a version JSON. */
+  export function parseLibraries(raws: Json): Json
+  /** Parse `arguments` (modern object) or `minecraftArguments` (legacy string). */
+  export function parseArguments(raw: Json): Json
+  /** Merge a patch version's args onto a base version's (`inheritsFrom`). */
+  export function mergeArgs(base: Json, patch: Json): Json
+  /** Parse an asset manifest (`objects` map). */
+  export function parseAssetManifest(raw: Json): Json
+  /** Parse `version_manifest_v2.json`. */
+  export function parseVersionManifest(raw: Json): Json
+  /** Look up a version by id. Returns `null` when absent. */
+  export function findVersion(manifest: Json, id: string): Json
+  /** The manifest's current release version. Throws when it is missing. */
+  export function latestRelease(manifest: Json): Json
+  /** The canonical version-manifest URL. */
+  export function versionManifestUrl(): string
+  export function assetUrl(hash: string): string
+  export function assetPath(hash: string): string
+  export function parseMaven(value: string): Json
+  export function encodeMaven(coord: Json): string
+  export function isNativeMaven(coord: Json): boolean
+  export function mavenMatchesIgnoringVersion(a: Json, b: Json): boolean
+  /**
+   * Decode a ruleset in strict Mojang form. A shorthand string such as
+   * `"allow.os.linux"` is an error here — that spelling is opys's own, and
+   * belongs to `@opys/core`.
+   */
+  export function decodeRuleset(raw: Json): Json
+  export function encodeRuleset(ruleset: Json): Json
+  /** Evaluate a strict Mojang ruleset against a platform + active features. */
+  export function satisfiesRuleset(rules: Json, platform: OsOptions, features: Array<string>): boolean
+  export function satisfiesRule(rule: Json, platform: OsOptions, features: Array<string>): boolean
+  export function satisfiesOs(constraint: Json, platform: OsOptions): boolean
+  export function satisfiesFeatures(constraint: Json, features: Array<string>): boolean
+}
+export declare namespace neoforge {
+  /**
+   * Resolve NeoForge into `{ artifacts, vars, classpath, launch, jvmArgs,
+   * mainClass, gameArgs }` — the build's published version document folded onto
+   * the vanilla version it inherits from.
+   */
+  export function resolveNeoForge(options: Json): Promise<Json>
+  /**
+   * Run the `neoforge` plugin: the same resolve, returned as the contribution
+   * to merge — `{ name, contribution }`.
+   */
+  export function buildNeoForge(options: Json): Promise<Json>
+  /**
+   * Resolve a Minecraft version, an alias or a full build id to `{ minecraft,
+   * neoforge, documentUrl }`.
+   */
+  export function resolveNeoForgeVersion(input: string, source: string): Promise<Json>
+  /** The canonical document index base URL. */
+  export function defaultNeoForgeIndex(): string
+}
+export declare namespace runtime {
+  export interface OsOptions {
+    name: string
+    version: string
+    arch: string
+  }
+  export interface InstallOptionsJs {
+    platform?: OsOptions
+    vars?: Record<string, string>
+    concurrency?: number
+    verifyIntegrity?: boolean
+    features?: Array<string>
+  }
+  export interface ProgressEvent {
+    phase: string
+    fetched?: number
+    total?: number
+    skipped?: number
+    count?: number
+    removed?: number
+    directories?: number
+    path?: string
+    bytes?: number
+    totalBytes?: number
+  }
+  /**
+   * Install from `source`: `{ manifest }`, `{ bundle }` or `{ url }`.
+   * The source decodes itself — see `opys_runtime::ManifestSource`.
+   */
+  export function install(source: Json, options?: InstallOptionsJs | undefined | null, progress?: (...args: any[]) => any | undefined | null): Promise<unknown>
+  export interface LaunchSpec {
+    command: string
+    args: Array<string>
+    workdir: string
+    envs: Record<string, string>
+  }
+  export interface BuildLaunchOptions {
+    platform?: OsOptions
+    features?: Array<string>
+    vars?: Record<string, string>
+    cwd?: string
+  }
+  /** Pure spawn-spec — no install, no spawn. Q5 in design doc. */
+  export function buildLaunch(source: Json, options?: BuildLaunchOptions | undefined | null): Promise<LaunchSpec>
+  /**
+   * Install, then say what to spawn — from one reading of the source, so a
+   * bundle is opened, or downloaded, once for both.
+   */
+  export function prepare(source: Json, launch?: BuildLaunchOptions | undefined | null, install?: InstallOptionsJs | undefined | null, progress?: (...args: any[]) => any | undefined | null): Promise<unknown>
+  export function currentPlatform(): OsOptions
+}

package/index.js

@@ -0,0 +1,333 @@
+/* tslint:disable */
+/* eslint-disable */
+/* prettier-ignore */
+
+/* auto-generated by NAPI-RS */
+
+const { existsSync, readFileSync } = require('fs')
+const { join } = require('path')
+
+const { platform, arch } = process
+
+let nativeBinding = null
+let localFileExisted = false
+let loadError = null
+
+function isMusl() {
+  // For Node 10
+  if (!process.report || typeof process.report.getReport !== 'function') {
+    try {
+      const lddPath = require('child_process').execSync('which ldd').toString().trim()
+      return readFileSync(lddPath, 'utf8').includes('musl')
+    } catch (e) {
+      return true
+    }
+  } else {
+    const { glibcVersionRuntime } = process.report.getReport().header
+    return !glibcVersionRuntime
+  }
+}
+
+switch (platform) {
+  case 'android':
+    switch (arch) {
+      case 'arm64':
+        localFileExisted = existsSync(join(__dirname, 'index.android-arm64.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./index.android-arm64.node')
+          } else {
+            nativeBinding = require('@opys/binding-android-arm64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm':
+        localFileExisted = existsSync(join(__dirname, 'index.android-arm-eabi.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./index.android-arm-eabi.node')
+          } else {
+            nativeBinding = require('@opys/binding-android-arm-eabi')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Android ${arch}`)
+    }
+    break
+  case 'win32':
+    switch (arch) {
+      case 'x64':
+        localFileExisted = existsSync(
+          join(__dirname, 'index.win32-x64-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./index.win32-x64-msvc.node')
+          } else {
+            nativeBinding = require('@opys/binding-win32-x64-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'ia32':
+        localFileExisted = existsSync(
+          join(__dirname, 'index.win32-ia32-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./index.win32-ia32-msvc.node')
+          } else {
+            nativeBinding = require('@opys/binding-win32-ia32-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm64':
+        localFileExisted = existsSync(
+          join(__dirname, 'index.win32-arm64-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./index.win32-arm64-msvc.node')
+          } else {
+            nativeBinding = require('@opys/binding-win32-arm64-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Windows: ${arch}`)
+    }
+    break
+  case 'darwin':
+    localFileExisted = existsSync(join(__dirname, 'index.darwin-universal.node'))
+    try {
+      if (localFileExisted) {
+        nativeBinding = require('./index.darwin-universal.node')
+      } else {
+        nativeBinding = require('@opys/binding-darwin-universal')
+      }
+      break
+    } catch {}
+    switch (arch) {
+      case 'x64':
+        localFileExisted = existsSync(join(__dirname, 'index.darwin-x64.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./index.darwin-x64.node')
+          } else {
+            nativeBinding = require('@opys/binding-darwin-x64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm64':
+        localFileExisted = existsSync(
+          join(__dirname, 'index.darwin-arm64.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./index.darwin-arm64.node')
+          } else {
+            nativeBinding = require('@opys/binding-darwin-arm64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on macOS: ${arch}`)
+    }
+    break
+  case 'freebsd':
+    if (arch !== 'x64') {
+      throw new Error(`Unsupported architecture on FreeBSD: ${arch}`)
+    }
+    localFileExisted = existsSync(join(__dirname, 'index.freebsd-x64.node'))
+    try {
+      if (localFileExisted) {
+        nativeBinding = require('./index.freebsd-x64.node')
+      } else {
+        nativeBinding = require('@opys/binding-freebsd-x64')
+      }
+    } catch (e) {
+      loadError = e
+    }
+    break
+  case 'linux':
+    switch (arch) {
+      case 'x64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'index.linux-x64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./index.linux-x64-musl.node')
+            } else {
+              nativeBinding = require('@opys/binding-linux-x64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'index.linux-x64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./index.linux-x64-gnu.node')
+            } else {
+              nativeBinding = require('@opys/binding-linux-x64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'arm64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'index.linux-arm64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./index.linux-arm64-musl.node')
+            } else {
+              nativeBinding = require('@opys/binding-linux-arm64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'index.linux-arm64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./index.linux-arm64-gnu.node')
+            } else {
+              nativeBinding = require('@opys/binding-linux-arm64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'arm':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'index.linux-arm-musleabihf.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./index.linux-arm-musleabihf.node')
+            } else {
+              nativeBinding = require('@opys/binding-linux-arm-musleabihf')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'index.linux-arm-gnueabihf.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./index.linux-arm-gnueabihf.node')
+            } else {
+              nativeBinding = require('@opys/binding-linux-arm-gnueabihf')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'riscv64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'index.linux-riscv64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./index.linux-riscv64-musl.node')
+            } else {
+              nativeBinding = require('@opys/binding-linux-riscv64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'index.linux-riscv64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./index.linux-riscv64-gnu.node')
+            } else {
+              nativeBinding = require('@opys/binding-linux-riscv64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 's390x':
+        localFileExisted = existsSync(
+          join(__dirname, 'index.linux-s390x-gnu.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./index.linux-s390x-gnu.node')
+          } else {
+            nativeBinding = require('@opys/binding-linux-s390x-gnu')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Linux: ${arch}`)
+    }
+    break
+  default:
+    throw new Error(`Unsupported OS: ${platform}, architecture: ${arch}`)
+}
+
+if (!nativeBinding) {
+  if (loadError) {
+    throw loadError
+  }
+  throw new Error(`Failed to load native binding`)
+}
+
+const { authliberty, bifrost, bundle, cleanroom, core, curseforge, dev, dgpuj, fabric, forge, java, links, lwjgl3ify, minecraftServerlist, minecraftVanilla, modrinth, mojang, neoforge, runtime } = nativeBinding
+
+module.exports.authliberty = authliberty
+module.exports.bifrost = bifrost
+module.exports.bundle = bundle
+module.exports.cleanroom = cleanroom
+module.exports.core = core
+module.exports.curseforge = curseforge
+module.exports.dev = dev
+module.exports.dgpuj = dgpuj
+module.exports.fabric = fabric
+module.exports.forge = forge
+module.exports.java = java
+module.exports.links = links
+module.exports.lwjgl3ify = lwjgl3ify
+module.exports.minecraftServerlist = minecraftServerlist
+module.exports.minecraftVanilla = minecraftVanilla
+module.exports.modrinth = modrinth
+module.exports.mojang = mojang
+module.exports.neoforge = neoforge
+module.exports.runtime = runtime

package/package.json

@@ -1,6 +1,48 @@
 {
   "name": "@opys/binding",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.3.0",
+  "description": "The napi-rs addon of opys: every native function, one namespace per package. Not consumed directly.",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "napi": {
+    "binaryName": "opys",
+    "triples": {
+      "defaults": true,
+      "additional": [
+        "aarch64-apple-darwin",
+        "aarch64-unknown-linux-gnu",
+        "x86_64-unknown-linux-musl",
+        "aarch64-unknown-linux-musl"
+      ]
+    }
+  },
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "*.node"
+  ],
+  "scripts": {
+    "build": "napi build --platform --release",
+    "build:debug": "napi build --platform"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/harmoniya-net/opys.git",
+    "directory": "crates/opys-napi"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "optionalDependencies": {
+    "@opys/binding-darwin-arm64": "0.3.0",
+    "@opys/binding-darwin-x64": "0.3.0",
+    "@opys/binding-linux-arm64-gnu": "0.3.0",
+    "@opys/binding-linux-arm64-musl": "0.3.0",
+    "@opys/binding-linux-x64-gnu": "0.3.0",
+    "@opys/binding-linux-x64-musl": "0.3.0",
+    "@opys/binding-win32-x64-msvc": "0.3.0"
+  }
+}