@hypersoniclabs/helix-cli 0.1.7 → 0.1.23

package/dist/bridge/management.js

@@ -0,0 +1,333 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.inspectBridgePlugin = inspectBridgePlugin;
+exports.installBridgePlugin = installBridgePlugin;
+exports.removeBridgePlugin = removeBridgePlugin;
+exports.createBridgePlugin = createBridgePlugin;
+exports.bridgeDoctor = bridgeDoctor;
+const node_crypto_1 = require("node:crypto");
+const node_fs_1 = require("node:fs");
+const promises_1 = require("node:fs/promises");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const manifest_1 = require("./manifest");
+const plugins_1 = require("./plugins");
+const types_1 = require("./types");
+const MAX_PLUGIN_FILES = 2_048;
+const MAX_PLUGIN_BYTES = 64 * 1024 * 1024;
+const PLUGIN_LOCK_SCHEMA = 'helix.bridge-plugin-lock/1';
+function errorCode(error) {
+    return typeof error === 'object' && error !== null && 'code' in error && typeof error.code === 'string'
+        ? error.code
+        : null;
+}
+function parsePluginLock(value) {
+    try {
+        const parsed = JSON.parse(value);
+        return parsed.schemaVersion === PLUGIN_LOCK_SCHEMA &&
+            typeof parsed.lockId === 'string' &&
+            (parsed.operation === 'install' || parsed.operation === 'remove') &&
+            Number.isInteger(parsed.pid) && Number(parsed.pid) > 0 &&
+            typeof parsed.hostname === 'string' &&
+            typeof parsed.startedAt === 'string' &&
+            typeof parsed.pluginId === 'string' &&
+            typeof parsed.pluginRoot === 'string' &&
+            typeof parsed.generation === 'string'
+            ? parsed
+            : null;
+    }
+    catch {
+        return null;
+    }
+}
+function processIsAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return errorCode(error) !== 'ESRCH';
+    }
+}
+function pluginLockPath(pluginsRoot, id) {
+    return (0, node_path_1.join)(pluginsRoot, `.${id}.bridge-plugin-lock`);
+}
+function lockIsOwned(path, lockId) {
+    try {
+        return parsePluginLock((0, node_fs_1.readFileSync)(path, 'utf8'))?.lockId === lockId;
+    }
+    catch {
+        return false;
+    }
+}
+function recoverStalePluginLock(path, pluginsRoot, id) {
+    let existing;
+    try {
+        existing = parsePluginLock((0, node_fs_1.readFileSync)(path, 'utf8'));
+    }
+    catch (error) {
+        if (errorCode(error) === 'ENOENT')
+            return true;
+        throw error;
+    }
+    const destination = (0, node_path_1.resolve)((0, node_path_1.join)(pluginsRoot, id));
+    if (!existing || existing.hostname !== (0, node_os_1.hostname)() || processIsAlive(existing.pid) ||
+        existing.pluginId !== id || (0, node_path_1.resolve)(existing.pluginRoot) !== destination) {
+        return false;
+    }
+    const retired = `${path}.stale-${existing.lockId}`;
+    try {
+        (0, node_fs_1.renameSync)(path, retired);
+    }
+    catch (error) {
+        if (errorCode(error) === 'ENOENT')
+            return true;
+        throw error;
+    }
+    const moved = parsePluginLock((0, node_fs_1.readFileSync)(retired, 'utf8'));
+    if (moved?.lockId !== existing.lockId) {
+        if (!(0, node_fs_1.existsSync)(path))
+            (0, node_fs_1.renameSync)(retired, path);
+        return false;
+    }
+    (0, node_fs_1.rmSync)(retired, { force: true });
+    return true;
+}
+function acquirePluginLock(pluginsRoot, id, generation, operation) {
+    const path = pluginLockPath(pluginsRoot, id);
+    const record = {
+        schemaVersion: PLUGIN_LOCK_SCHEMA,
+        lockId: (0, node_crypto_1.randomBytes)(16).toString('hex'),
+        operation,
+        pid: process.pid,
+        hostname: (0, node_os_1.hostname)(),
+        startedAt: new Date().toISOString(),
+        pluginId: id,
+        pluginRoot: (0, node_path_1.resolve)((0, node_path_1.join)(pluginsRoot, id)),
+        generation,
+    };
+    for (let attempt = 0; attempt < 2; attempt += 1) {
+        let descriptor = null;
+        let created = false;
+        try {
+            descriptor = (0, node_fs_1.openSync)(path, 'wx');
+            created = true;
+            (0, node_fs_1.writeSync)(descriptor, `${JSON.stringify(record, null, 2)}\n`);
+            (0, node_fs_1.closeSync)(descriptor);
+            return { path, record };
+        }
+        catch (error) {
+            if (descriptor !== null) {
+                try {
+                    (0, node_fs_1.closeSync)(descriptor);
+                }
+                catch { /* already closed */ }
+            }
+            if (errorCode(error) !== 'EEXIST') {
+                if (created)
+                    (0, node_fs_1.rmSync)(path, { force: true });
+                throw error;
+            }
+            if (attempt === 0 && recoverStalePluginLock(path, pluginsRoot, id))
+                continue;
+            throw new Error(`Bridge plugin '${id}' is being modified by another local operation. ` +
+                `Inspect ${path}; it records the owner and generation for safe recovery.`);
+        }
+    }
+    throw new Error(`Unable to reserve Bridge plugin '${id}'.`);
+}
+function releasePluginLock(lock) {
+    if (lockIsOwned(lock.path, lock.record.lockId))
+        (0, node_fs_1.rmSync)(lock.path, { force: true });
+}
+function inventory(root, current = root, files = [], total = { bytes: 0 }) {
+    for (const entry of (0, node_fs_1.readdirSync)(current, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) {
+        const path = (0, node_path_1.join)(current, entry.name);
+        const info = (0, node_fs_1.lstatSync)(path);
+        if (info.isSymbolicLink())
+            throw new Error(`Bridge plugins may not contain symlinks: ${path}`);
+        if (info.isDirectory())
+            inventory(root, path, files, total);
+        else if (info.isFile()) {
+            files.push({ source: path, relative: path.slice(root.length + 1), size: info.size });
+            total.bytes += info.size;
+            if (files.length > MAX_PLUGIN_FILES)
+                throw new Error(`Bridge plugin has more than ${MAX_PLUGIN_FILES} files`);
+            if (total.bytes > MAX_PLUGIN_BYTES)
+                throw new Error(`Bridge plugin is larger than ${MAX_PLUGIN_BYTES} bytes`);
+        }
+        else
+            throw new Error(`Bridge plugins may contain only regular files and directories: ${path}`);
+    }
+    return files;
+}
+function inspectBridgePlugin(path) {
+    const loaded = (0, manifest_1.readBridgePluginManifest)(path);
+    const files = inventory(loaded.root);
+    const bytes = files.reduce((sum, entry) => sum + entry.size, 0);
+    if (files.length > MAX_PLUGIN_FILES)
+        throw new Error(`Bridge plugin has ${files.length} files; limit is ${MAX_PLUGIN_FILES}`);
+    if (bytes > MAX_PLUGIN_BYTES)
+        throw new Error(`Bridge plugin is ${bytes} bytes; limit is ${MAX_PLUGIN_BYTES}`);
+    for (const capability of loaded.manifest.capabilities) {
+        if (!capability.command)
+            continue;
+        const executable = (0, node_path_1.join)(loaded.root, capability.command.executable);
+        if (!(0, node_fs_1.existsSync)(executable) || !(0, node_fs_1.statSync)(executable).isFile()) {
+            throw new Error(`${capability.id} executable does not exist: ${capability.command.executable}`);
+        }
+    }
+    return { root: loaded.root, manifest: loaded.manifest, files: files.length, bytes };
+}
+async function installBridgePlugin(path, options = {}) {
+    const inspected = inspectBridgePlugin(path);
+    const source = (0, plugins_1.loadExternalBridgePlugin)(inspected.root);
+    const pluginsRoot = (0, node_path_1.join)((0, plugins_1.defaultBridgeHome)(), 'plugins');
+    (0, node_fs_1.mkdirSync)(pluginsRoot, { recursive: true });
+    const destination = (0, node_path_1.join)(pluginsRoot, inspected.manifest.id);
+    const staging = (0, node_path_1.join)(pluginsRoot, `.${inspected.manifest.id}.${process.pid}.${(0, node_crypto_1.randomBytes)(4).toString('hex')}.tmp`);
+    let retired = null;
+    let cleanupWarning;
+    const lock = acquirePluginLock(pluginsRoot, inspected.manifest.id, source.contentDigest, 'install');
+    try {
+        if ((0, node_fs_1.existsSync)(destination) && !options.force) {
+            throw new Error(`${inspected.manifest.id} is already installed; pass --force to replace it.`);
+        }
+        (0, node_fs_1.rmSync)(staging, { recursive: true, force: true });
+        for (const file of inventory(inspected.root)) {
+            const target = (0, node_path_1.join)(staging, file.relative);
+            await (0, promises_1.mkdir)((0, node_path_1.dirname)(target), { recursive: true });
+            await (0, promises_1.copyFile)(file.source, target);
+            if (file.relative === 'bridge-plugin.json')
+                (0, node_fs_1.chmodSync)(target, 0o644);
+        }
+        inspectBridgePlugin(staging);
+        const staged = (0, plugins_1.loadExternalBridgePlugin)(staging);
+        if (staged.manifest.id !== inspected.manifest.id || staged.contentDigest !== source.contentDigest) {
+            throw new Error(`Bridge plugin '${inspected.manifest.id}' changed while staging; activation aborted.`);
+        }
+        if ((0, node_fs_1.existsSync)(destination)) {
+            retired = `${destination}.replaced.${Date.now()}`;
+            (0, node_fs_1.renameSync)(destination, retired);
+            (0, node_fs_1.renameSync)(staging, destination);
+            const activatedRetired = retired;
+            retired = null;
+            try {
+                (0, node_fs_1.rmSync)(activatedRetired, { recursive: true, force: true });
+            }
+            catch (error) {
+                cleanupWarning = `Installed ${inspected.manifest.id}, but could not remove the retired plugin at ${activatedRetired}: ${error instanceof Error ? error.message : String(error)}`;
+            }
+        }
+        else {
+            (0, node_fs_1.renameSync)(staging, destination);
+        }
+        return { path: destination, manifest: staged.manifest, ...(cleanupWarning ? { cleanupWarning } : {}) };
+    }
+    catch (error) {
+        (0, node_fs_1.rmSync)(staging, { recursive: true, force: true });
+        if (retired && (0, node_fs_1.existsSync)(retired) && !(0, node_fs_1.existsSync)(destination))
+            (0, node_fs_1.renameSync)(retired, destination);
+        throw error;
+    }
+    finally {
+        releasePluginLock(lock);
+    }
+}
+function removeBridgePlugin(id) {
+    const plugin = (0, plugins_1.loadBridgePlugins)().find((entry) => entry.manifest.id === id);
+    if (!plugin)
+        throw new Error(`Bridge plugin is not installed: ${id}`);
+    if (plugin.official || !plugin.root)
+        throw new Error(`Built-in Bridge plugin cannot be removed: ${id}`);
+    const pluginsRoot = (0, node_path_1.join)((0, plugins_1.defaultBridgeHome)(), 'plugins');
+    const destination = (0, node_path_1.join)(pluginsRoot, id);
+    const expectedGeneration = plugin.contentDigest;
+    const lock = acquirePluginLock(pluginsRoot, id, expectedGeneration, 'remove');
+    let trash = null;
+    try {
+        const active = (0, plugins_1.loadExternalBridgePlugin)(destination);
+        if (active.manifest.id !== id || active.contentDigest !== expectedGeneration) {
+            throw new Error(`Bridge plugin '${id}' changed before removal; retry after inspecting its active generation.`);
+        }
+        trash = `${destination}.removed.${Date.now()}`;
+        (0, node_fs_1.renameSync)(destination, trash);
+        (0, node_fs_1.rmSync)(trash, { recursive: true, force: true });
+        return id;
+    }
+    catch (error) {
+        if (trash && (0, node_fs_1.existsSync)(trash) && !(0, node_fs_1.existsSync)(destination)) {
+            try {
+                (0, node_fs_1.renameSync)(trash, destination);
+            }
+            catch (restoreError) {
+                throw new Error(`Bridge plugin '${id}' removal failed and its tombstone could not be restored: ` +
+                    `${restoreError instanceof Error ? restoreError.message : String(restoreError)}`);
+            }
+        }
+        throw error;
+    }
+    finally {
+        releasePluginLock(lock);
+    }
+}
+function createBridgePlugin(directory, options) {
+    const target = (0, node_path_1.resolve)(directory);
+    if ((0, node_fs_1.existsSync)(target) && (0, node_fs_1.readdirSync)(target).length > 0)
+        throw new Error(`Bridge plugin directory must be empty: ${target}`);
+    (0, node_fs_1.mkdirSync)((0, node_path_1.join)(target, 'bin'), { recursive: true });
+    const manifestPath = (0, node_path_1.join)(target, 'bridge-plugin.json');
+    const executablePath = (0, node_path_1.join)(target, 'bin', 'plugin.js');
+    (0, node_fs_1.writeFileSync)(manifestPath, `${JSON.stringify({
+        schemaVersion: types_1.BRIDGE_PLUGIN_SCHEMA,
+        id: options.id,
+        name: options.name ?? options.id,
+        version: '0.1.0',
+        trust: 'local-untrusted',
+        permissions: ['filesystem.read-source', 'filesystem.write-output', 'spawn-process', 'unrestricted-host-execution'],
+        capabilities: [{
+                id: `${options.id}.import`,
+                stage: 'transform',
+                accepts: ['file.unknown'],
+                produces: ['helix.package.asset'],
+                matches: { extensions: [`.${options.id.split('.').at(-1) ?? 'asset'}`] },
+                permissions: ['filesystem.read-source', 'filesystem.write-output', 'spawn-process', 'unrestricted-host-execution'],
+                command: { executable: 'bin/plugin.js', args: [] },
+            }],
+    }, null, 2)}\n`);
+    (0, node_fs_1.writeFileSync)(executablePath, [
+        '#!/usr/bin/env node',
+        "let input = '';",
+        "process.stdin.setEncoding('utf8');",
+        "process.stdin.on('data', (chunk) => { input += chunk; });",
+        "process.stdin.on('end', () => {",
+        "  const request = JSON.parse(input);",
+        "  throw new Error(`Implement ${request.capability} and return { artifacts: [...] } as JSON.`);",
+        '});',
+        '',
+    ].join('\n'));
+    (0, node_fs_1.chmodSync)(executablePath, 0o755);
+    inspectBridgePlugin(target);
+    return { directory: target, manifestPath, executablePath };
+}
+function bridgeDoctor(pluginDirs = []) {
+    const plugins = (0, plugins_1.loadBridgePlugins)(pluginDirs);
+    return {
+        schemaVersion: 'helix.bridge-doctor/1',
+        home: (0, plugins_1.defaultBridgeHome)(),
+        plugins: plugins.map((entry) => ({
+            id: entry.manifest.id,
+            version: entry.manifest.version,
+            trust: entry.manifest.trust,
+            official: entry.official,
+            capabilities: entry.manifest.capabilities.length,
+        })),
+        tools: {
+            unrealEditor: process.env.HELIX_UNREAL_EDITOR ?? null,
+            unityEditor: process.env.HELIX_UNITY_EDITOR ?? null,
+            godot: process.env.HELIX_GODOT ?? null,
+            blender: process.env.HELIX_BLENDER ?? null,
+        },
+    };
+}
+//# sourceMappingURL=management.js.map

package/dist/bridge/management.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"management.js","sourceRoot":"","sources":["../../src/bridge/management.ts"],"names":[],"mappings":"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"}

package/dist/bridge/manifest.d.ts

@@ -0,0 +1,8 @@
+import { type BridgePluginManifest } from './types';
+export declare const MAX_BRIDGE_PLUGIN_MANIFEST_BYTES: number;
+export declare function validateBridgePluginManifest(value: unknown): BridgePluginManifest;
+export declare function readBridgePluginManifest(path: string): {
+    root: string;
+    path: string;
+    manifest: BridgePluginManifest;
+};

package/dist/bridge/manifest.js

@@ -0,0 +1,192 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_BRIDGE_PLUGIN_MANIFEST_BYTES = void 0;
+exports.validateBridgePluginManifest = validateBridgePluginManifest;
+exports.readBridgePluginManifest = readBridgePluginManifest;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const types_1 = require("./types");
+// `(?![\s\S])` is a strict JavaScript end-of-input assertion. Unlike `$`, it
+// does not also match immediately before one trailing newline.
+const ID = /^[a-z0-9](?:[a-z0-9._-]{0,126}[a-z0-9])?(?![\s\S])/;
+const VERSION = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?![\s\S])/;
+const UNSAFE_DISPLAY_CHARACTERS = /[\u0000-\u001f\u007f-\u009f\u061c\u200e\u200f\u2028\u2029\u202a-\u202e\u2066-\u2069]/u;
+exports.MAX_BRIDGE_PLUGIN_MANIFEST_BYTES = 256 * 1024;
+function record(value, label) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        throw new Error(`${label} must be an object`);
+    }
+    return value;
+}
+function string(value, label) {
+    if (typeof value !== 'string' || value.trim() === '')
+        throw new Error(`${label} must be a non-empty string`);
+    if (UNSAFE_DISPLAY_CHARACTERS.test(value)) {
+        throw new Error(`${label} must not contain terminal controls, newlines, line separators, or bidi controls`);
+    }
+    return value;
+}
+function stringList(value, label) {
+    if (!Array.isArray(value)) {
+        throw new Error(`${label} must be an array of non-empty strings`);
+    }
+    return value.map((entry, index) => string(entry, `${label}[${index}]`));
+}
+function stringArray(value, label) {
+    return [...new Set(stringList(value, label))];
+}
+function permissions(value, label) {
+    const entries = stringArray(value, label);
+    for (const entry of entries) {
+        if (!types_1.BRIDGE_PERMISSIONS.includes(entry)) {
+            throw new Error(`${label} contains unknown permission '${entry}'`);
+        }
+    }
+    return entries;
+}
+function optionalString(value, label) {
+    return value === undefined ? undefined : string(value, label);
+}
+function sourceMatcher(value, label) {
+    const input = record(value, label);
+    const extensions = input.extensions === undefined ? undefined : stringArray(input.extensions, `${label}.extensions`);
+    const fileNames = input.fileNames === undefined ? undefined : stringArray(input.fileNames, `${label}.fileNames`);
+    const markerFiles = input.markerFiles === undefined ? undefined : stringArray(input.markerFiles, `${label}.markerFiles`);
+    if (!(extensions?.length || fileNames?.length || markerFiles?.length))
+        throw new Error(`${label} must declare at least one matcher`);
+    for (const extension of extensions ?? []) {
+        if (!/^\.[a-z0-9][a-z0-9._-]*$/.test(extension))
+            throw new Error(`${label}.extensions must be lowercase extensions beginning with '.'`);
+    }
+    for (const fileName of fileNames ?? []) {
+        if (fileName.includes('/') || fileName.includes('\\'))
+            throw new Error(`${label}.fileNames entries must be basenames`);
+    }
+    for (const marker of markerFiles ?? []) {
+        if ((0, node_path_1.isAbsolute)(marker) || (0, node_path_1.normalize)(marker).split(/[\\/]/).includes('..')) {
+            throw new Error(`${label}.markerFiles entries must stay inside the source directory`);
+        }
+    }
+    return {
+        ...(extensions ? { extensions } : {}),
+        ...(fileNames ? { fileNames } : {}),
+        ...(markerFiles ? { markerFiles } : {}),
+    };
+}
+function capability(value, pluginPermissions, index) {
+    const input = record(value, `capabilities[${index}]`);
+    const id = string(input.id, `capabilities[${index}].id`);
+    if (!ID.test(id))
+        throw new Error(`capabilities[${index}].id is not a stable lowercase id`);
+    if (id.startsWith('helix.') || types_1.BRIDGE_RESERVED_CAPABILITY_IDS.includes(id)) {
+        throw new Error(`${id} uses a capability identity reserved for built-in HELIX plugins`);
+    }
+    const stage = string(input.stage, `capabilities[${index}].stage`);
+    if (!types_1.BRIDGE_STAGES.includes(stage))
+        throw new Error(`capabilities[${index}].stage is not supported`);
+    const accepts = stringArray(input.accepts, `capabilities[${index}].accepts`);
+    const produces = stringArray(input.produces, `capabilities[${index}].produces`);
+    if (accepts.length === 0 || produces.length === 0)
+        throw new Error(`${id} must accept and produce at least one type`);
+    const ownPermissions = input.permissions === undefined ? [] : permissions(input.permissions, `capabilities[${index}].permissions`);
+    for (const permission of ownPermissions) {
+        if (!pluginPermissions.includes(permission)) {
+            throw new Error(`${id} requests '${permission}', which is not declared by the plugin`);
+        }
+    }
+    let command;
+    if (input.command !== undefined) {
+        const raw = record(input.command, `capabilities[${index}].command`);
+        const executable = string(raw.executable, `capabilities[${index}].command.executable`);
+        if ((0, node_path_1.isAbsolute)(executable) || (0, node_path_1.normalize)(executable).split(/[\\/]/).includes('..')) {
+            throw new Error(`${id} command executable must stay inside the installed plugin directory`);
+        }
+        const args = raw.args === undefined ? undefined : stringList(raw.args, `capabilities[${index}].command.args`);
+        const timeoutSeconds = raw.timeoutSeconds === undefined ? undefined : Number(raw.timeoutSeconds);
+        if (timeoutSeconds !== undefined && (!Number.isFinite(timeoutSeconds) || timeoutSeconds <= 0 || timeoutSeconds > 86_400)) {
+            throw new Error(`${id} command timeoutSeconds must be between 1 and 86400`);
+        }
+        command = { executable, ...(args ? { args } : {}), ...(timeoutSeconds ? { timeoutSeconds } : {}) };
+    }
+    if (!command)
+        throw new Error(`${id} must declare an executable command`);
+    const targets = input.targets === undefined ? undefined : stringArray(input.targets, `capabilities[${index}].targets`);
+    for (const target of targets ?? [])
+        if (!types_1.BRIDGE_TARGETS.includes(target))
+            throw new Error(`${id} has unknown target '${target}'`);
+    const priority = input.priority === undefined ? undefined : Number(input.priority);
+    if (priority !== undefined && (!Number.isFinite(priority) || !Number.isInteger(priority)))
+        throw new Error(`${id} priority must be an integer`);
+    return {
+        id,
+        stage,
+        accepts,
+        produces,
+        ...(targets ? { targets } : {}),
+        ...(priority !== undefined ? { priority } : {}),
+        ...(ownPermissions.length ? { permissions: ownPermissions } : {}),
+        ...(command ? { command } : {}),
+        ...(input.description !== undefined ? { description: string(input.description, `${id}.description`) } : {}),
+        ...(input.requires !== undefined ? { requires: stringArray(input.requires, `${id}.requires`) } : {}),
+        ...(input.replaces !== undefined ? { replaces: stringArray(input.replaces, `${id}.replaces`) } : {}),
+        ...(input.matches !== undefined ? { matches: sourceMatcher(input.matches, `${id}.matches`) } : {}),
+    };
+}
+function validateBridgePluginManifest(value) {
+    const input = record(value, 'Bridge plugin manifest');
+    if (input.schemaVersion !== types_1.BRIDGE_PLUGIN_SCHEMA) {
+        throw new Error(`Bridge plugin schemaVersion must be '${types_1.BRIDGE_PLUGIN_SCHEMA}'`);
+    }
+    const id = string(input.id, 'plugin.id');
+    if (!ID.test(id))
+        throw new Error('plugin.id must be a stable lowercase id');
+    if (id.startsWith('helix.'))
+        throw new Error("plugin.id uses the reserved 'helix.' namespace");
+    const version = string(input.version, 'plugin.version');
+    if (!VERSION.test(version))
+        throw new Error('plugin.version must be semantic version x.y.z');
+    const trust = string(input.trust, 'plugin.trust');
+    if (!types_1.BRIDGE_TRUST_LEVELS.includes(trust))
+        throw new Error(`plugin.trust must be one of ${types_1.BRIDGE_TRUST_LEVELS.join(', ')}`);
+    if (trust === 'helix-verified' || trust === 'verified-publisher') {
+        throw new Error(`Local plugin manifests cannot self-assign '${trust}' trust`);
+    }
+    const declaredPermissions = permissions(input.permissions ?? [], 'plugin.permissions');
+    if (!Array.isArray(input.capabilities) || input.capabilities.length === 0) {
+        throw new Error('plugin.capabilities must contain at least one capability');
+    }
+    const capabilities = input.capabilities.map((entry, index) => capability(entry, declaredPermissions, index));
+    const capabilityIds = new Set();
+    for (const entry of capabilities) {
+        if (capabilityIds.has(entry.id))
+            throw new Error(`duplicate capability id '${entry.id}'`);
+        capabilityIds.add(entry.id);
+    }
+    return {
+        schemaVersion: types_1.BRIDGE_PLUGIN_SCHEMA,
+        id,
+        name: string(input.name, 'plugin.name'),
+        version,
+        trust,
+        permissions: declaredPermissions,
+        capabilities,
+        ...(optionalString(input.description, 'plugin.description') ? { description: optionalString(input.description, 'plugin.description') } : {}),
+        ...(optionalString(input.homepage, 'plugin.homepage') ? { homepage: optionalString(input.homepage, 'plugin.homepage') } : {}),
+    };
+}
+function readBridgePluginManifest(path) {
+    const manifestPath = (0, node_path_1.basename)(path) === 'bridge-plugin.json' ? (0, node_path_1.resolve)(path) : (0, node_path_1.join)((0, node_path_1.resolve)(path), 'bridge-plugin.json');
+    const info = (0, node_fs_1.lstatSync)(manifestPath);
+    if (info.isSymbolicLink() || !info.isFile()) {
+        throw new Error(`Bridge plugin manifest must be a regular non-symlink file: ${manifestPath}`);
+    }
+    if (info.size > exports.MAX_BRIDGE_PLUGIN_MANIFEST_BYTES) {
+        throw new Error(`Bridge plugin manifest exceeds the ${exports.MAX_BRIDGE_PLUGIN_MANIFEST_BYTES}-byte limit: ${manifestPath}`);
+    }
+    return {
+        root: (0, node_path_1.dirname)(manifestPath),
+        path: manifestPath,
+        manifest: validateBridgePluginManifest(JSON.parse((0, node_fs_1.readFileSync)(manifestPath, 'utf8'))),
+    };
+}
+//# sourceMappingURL=manifest.js.map

package/dist/bridge/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/bridge/manifest.ts"],"names":[],"mappings":"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"}

package/dist/bridge/metahuman.d.ts

@@ -0,0 +1,26 @@
+import type { Document } from '@gltf-transform/core';
+export interface FixMetaHumanFaceResult {
+    headPrimTris: number;
+    droppedMaterials: string[];
+    texturedEyeMaterials: string[];
+}
+export interface FixMetaHumanFaceOptions {
+    bakedName?: string;
+    eyeTexturePng?: Uint8Array;
+}
+/** Verifies that the expected baked eyes still have textured, scene-reachable geometry. */
+export declare function assertLiveTexturedMetaHumanEyes(document: Document, expectedMaterialNames: readonly string[]): void;
+/**
+ * Canonical Bridge copy of the material repair introduced by
+ * helix-web-engine-new PR #99 (`avatar-eye-material-fix`). Unreal's FBX export
+ * preserves the eye geometry and UVs, but not the baked material graph. Bridge
+ * therefore requires the eye bake and refuses an output that would ship black,
+ * textureless eyes.
+ */
+export declare function fixMetaHumanFaceMaterials(document: Document, headTexturePng: Uint8Array, options?: FixMetaHumanFaceOptions): FixMetaHumanFaceResult;
+export declare function inspectBaseAvatarGlb(bytes: Uint8Array): {
+    lodCount: number;
+    faceMeshCount: number;
+    bodyMeshCount: number;
+    eyeMaterialCount: number;
+};