@ue-shed/uasset 0.1.0-rc.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 UE Shed contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,18 @@
+# `@ue-shed/uasset`
+
+The platform-selecting `uasset` command for UE Shed's read-only saved-asset parser. Version
+`0.1.0-rc.1` supports Windows x64 and installs the matching native artifact through an exact optional
+dependency.
+
+```powershell
+pnpm add --save-exact @ue-shed/uasset@0.1.0-rc.1
+pnpm exec uasset --version
+pnpm exec uasset inspect ./Content/Example.uasset --format json
+```
+
+The launcher resolves only the executable contained in `@ue-shed/uasset-win32-x64`. It never builds
+Cargo sources, searches a sibling checkout, probes `target`, or downloads an executable at runtime.
+Unsupported platforms fail with `UnsupportedPlatformError`; a missing optional dependency fails with
+`PlatformPackageUnavailableError` and reinstall guidance.
+
+Node.js 22.14 or later is required. The package and native parser are MIT licensed.

package/bin/uasset.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+
+import { spawnSync } from "node:child_process";
+import { resolveUassetExecutable } from "../src/index.js";
+
+try {
+	const executable = resolveUassetExecutable();
+	const result = spawnSync(executable, process.argv.slice(2), {
+		stdio: "inherit",
+		windowsHide: true
+	});
+	if (result.error !== undefined) throw result.error;
+	if (result.signal !== null) {
+		process.stderr.write(`uasset terminated by signal ${result.signal}\n`);
+		process.exitCode = 1;
+	} else {
+		process.exitCode = result.status ?? 1;
+	}
+} catch (cause) {
+	const message = cause instanceof Error ? cause.message : String(cause);
+	process.stderr.write(`uasset: ${message}\n`);
+	process.exitCode = 1;
+}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@ue-shed/uasset",
+  "version": "0.1.0-rc.1",
+  "description": "Platform-selecting launcher for the UE Shed saved-asset parser",
+  "homepage": "https://github.com/ue-shed/ue-shed#readme",
+  "bugs": {
+    "url": "https://github.com/ue-shed/ue-shed/issues"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ue-shed/ue-shed.git",
+    "directory": "packages/uasset"
+  },
+  "bin": {
+    "uasset": "./bin/uasset.js"
+  },
+  "files": [
+    "bin",
+    "src/index.d.ts",
+    "src/index.js",
+    "LICENSE",
+    "README.md"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./src/index.d.ts",
+      "default": "./src/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "optionalDependencies": {
+    "@ue-shed/uasset-win32-x64": "0.1.0-rc.1"
+  },
+  "engines": {
+    "node": ">=22.14.0"
+  },
+  "scripts": {
+    "test": "node --test",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/src/index.d.ts

@@ -0,0 +1,25 @@
+export type UassetLauncherErrorCode =
+	| "UE_SHED_UASSET_PLATFORM_PACKAGE_UNAVAILABLE"
+	| "UE_SHED_UASSET_UNSUPPORTED_PLATFORM";
+
+export declare class UnsupportedPlatformError extends Error {
+	readonly name: "UnsupportedPlatformError";
+	readonly code: "UE_SHED_UASSET_UNSUPPORTED_PLATFORM";
+	readonly platform: string;
+	readonly arch: string;
+	constructor(platform: string, arch: string);
+}
+
+export declare class PlatformPackageUnavailableError extends Error {
+	readonly name: "PlatformPackageUnavailableError";
+	readonly code: "UE_SHED_UASSET_PLATFORM_PACKAGE_UNAVAILABLE";
+	readonly packageName: string;
+	constructor(packageName: string, cause?: unknown);
+}
+
+export declare function platformPackageName(
+	platform?: string,
+	arch?: string
+): "@ue-shed/uasset-win32-x64";
+
+export declare function resolveUassetExecutable(platform?: string, arch?: string): string;

package/src/index.js

@@ -0,0 +1,80 @@
+import { accessSync, constants } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+
+const require = createRequire(import.meta.url);
+const VERSION = "0.1.0-rc.1";
+const WINDOWS_X64_PACKAGE = "@ue-shed/uasset-win32-x64";
+
+/**
+ * An operating-system and CPU combination for which no parser artifact is published.
+ */
+export class UnsupportedPlatformError extends Error {
+	/**
+	 * @param {string} platform
+	 * @param {string} arch
+	 */
+	constructor(platform, arch) {
+		super(
+			`@ue-shed/uasset ${VERSION} does not support ${platform}/${arch}. ` +
+				"This release supports Windows x64 only. Run the parser on a Windows x64 host " +
+				"or install a later @ue-shed/uasset release that lists your platform."
+		);
+		this.name = "UnsupportedPlatformError";
+		this.code = "UE_SHED_UASSET_UNSUPPORTED_PLATFORM";
+		this.platform = platform;
+		this.arch = arch;
+	}
+}
+
+/**
+ * The selected platform package was not installed or does not contain its executable.
+ */
+export class PlatformPackageUnavailableError extends Error {
+	/**
+	 * @param {string} packageName
+	 * @param {unknown} [cause]
+	 */
+	constructor(packageName, cause) {
+		super(
+			`The required ${packageName}@${VERSION} parser artifact is unavailable. ` +
+				`Reinstall @ue-shed/uasset@${VERSION} with optional dependencies enabled.`,
+			{ cause }
+		);
+		this.name = "PlatformPackageUnavailableError";
+		this.code = "UE_SHED_UASSET_PLATFORM_PACKAGE_UNAVAILABLE";
+		this.packageName = packageName;
+	}
+}
+
+/**
+ * Select the one published package for a platform. This function never probes the filesystem.
+ *
+ * @param {string} [platform]
+ * @param {string} [arch]
+ * @returns {string}
+ */
+export function platformPackageName(platform = process.platform, arch = process.arch) {
+	if (platform === "win32" && arch === "x64") return WINDOWS_X64_PACKAGE;
+	throw new UnsupportedPlatformError(platform, arch);
+}
+
+/**
+ * Resolve the executable shipped in the installed platform package. There is intentionally no
+ * source-checkout, Cargo target, PATH, or runtime-download fallback.
+ *
+ * @param {string} [platform]
+ * @param {string} [arch]
+ * @returns {string}
+ */
+export function resolveUassetExecutable(platform = process.platform, arch = process.arch) {
+	const packageName = platformPackageName(platform, arch);
+	try {
+		const packageJson = require.resolve(`${packageName}/package.json`);
+		const executable = join(dirname(packageJson), "bin", "uasset.exe");
+		accessSync(executable, constants.R_OK);
+		return executable;
+	} catch (cause) {
+		throw new PlatformPackageUnavailableError(packageName, cause);
+	}
+}