@hypersoniclabs/helix-cli 0.1.7 → 0.1.23

package/dist/bridge/types.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BRIDGE_SOURCE_KINDS = exports.BRIDGE_TRUST_LEVELS = exports.BRIDGE_TARGETS = exports.BRIDGE_CONTENT_TYPES = exports.BRIDGE_STAGES = exports.BRIDGE_RESERVED_CAPABILITY_IDS = exports.BRIDGE_EXTERNAL_TOOL_ENVIRONMENT = exports.BRIDGE_EXTERNAL_COMMAND_PERMISSIONS = exports.BRIDGE_PERMISSIONS = exports.BRIDGE_CORE_IMPLEMENTATION_VERSION = exports.BRIDGE_PROVENANCE_SCHEMA = exports.BRIDGE_PLUGIN_REQUEST_SCHEMA = exports.BRIDGE_PLAN_SCHEMA = exports.BRIDGE_DETECTION_SCHEMA = exports.BRIDGE_PLUGIN_SCHEMA = void 0;
+exports.BRIDGE_PLUGIN_SCHEMA = 'helix.bridge-plugin/1';
+exports.BRIDGE_DETECTION_SCHEMA = 'helix.bridge-detection/1';
+exports.BRIDGE_PLAN_SCHEMA = 'helix.bridge-plan/1';
+exports.BRIDGE_PLUGIN_REQUEST_SCHEMA = 'helix.bridge-plugin-request/1';
+exports.BRIDGE_PROVENANCE_SCHEMA = 'helix.bridge-provenance/1';
+// Bump when changing built-in Bridge behavior without a CLI package-version bump.
+exports.BRIDGE_CORE_IMPLEMENTATION_VERSION = '5';
+exports.BRIDGE_PERMISSIONS = [
+    'filesystem.read-source',
+    'filesystem.write-output',
+    'unrestricted-host-execution',
+    'network',
+    'spawn-process',
+    'unreal-editor',
+    'unity-editor',
+    'blender',
+    'gpu',
+];
+exports.BRIDGE_EXTERNAL_COMMAND_PERMISSIONS = [
+    'filesystem.read-source',
+    'filesystem.write-output',
+    'spawn-process',
+    'unrestricted-host-execution',
+];
+/** Host tool requirements and the only environment variables exposed for them. */
+exports.BRIDGE_EXTERNAL_TOOL_ENVIRONMENT = {
+    'tool:unreal-editor-commandlet': 'HELIX_UNREAL_EDITOR',
+    'tool:unity-editor-batchmode': 'HELIX_UNITY_EDITOR',
+    'tool:godot-headless': 'HELIX_GODOT',
+};
+/**
+ * Capability identities owned by the in-process HELIX implementation. External
+ * manifests cannot claim these identities (or the broader `helix.` namespace),
+ * so a reviewed plan can never be redirected into a different dispatcher.
+ */
+exports.BRIDGE_RESERVED_CAPABILITY_IDS = [
+    'helix.asset.copy',
+    'helix.character.import',
+    'helix.character.addon.import',
+    'helix.animation.retarget',
+    'metahuman.face.materials',
+    'helix.scene.package',
+    'unreal.project.extract',
+    'unity.project.extract',
+    'godot.project.extract',
+];
+exports.BRIDGE_STAGES = [
+    'detect', 'inspect', 'extract', 'normalize', 'transform', 'validate', 'optimize', 'package', 'publish',
+];
+exports.BRIDGE_CONTENT_TYPES = ['auto', 'asset', 'character', 'addon', 'scene', 'animation', 'extract'];
+exports.BRIDGE_TARGETS = ['web', 'unreal', 'mobile', 'canonical'];
+exports.BRIDGE_TRUST_LEVELS = ['helix-verified', 'verified-publisher', 'community', 'local-untrusted'];
+exports.BRIDGE_SOURCE_KINDS = [
+    'format.glb', 'format.gltf', 'format.fbx', 'format.obj', 'format.usd', 'format.usdz', 'format.vrm', 'format.image',
+    'format.audio', 'metahuman.face', 'unreal.project', 'unity.project', 'godot.project', 'directory.unknown', 'file.unknown',
+];
+//# sourceMappingURL=types.js.map

package/dist/bridge/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/bridge/types.ts"],"names":[],"mappings":";;;AAAa,QAAA,oBAAoB,GAAG,uBAAgC,CAAC;AACxD,QAAA,uBAAuB,GAAG,0BAAmC,CAAC;AAC9D,QAAA,kBAAkB,GAAG,qBAA8B,CAAC;AACpD,QAAA,4BAA4B,GAAG,+BAAwC,CAAC;AACxE,QAAA,wBAAwB,GAAG,2BAAoC,CAAC;AAC7E,kFAAkF;AACrE,QAAA,kCAAkC,GAAG,GAAY,CAAC;AAElD,QAAA,kBAAkB,GAAG;IAChC,wBAAwB;IACxB,yBAAyB;IACzB,6BAA6B;IAC7B,SAAS;IACT,eAAe;IACf,eAAe;IACf,cAAc;IACd,SAAS;IACT,KAAK;CACG,CAAC;AAEE,QAAA,mCAAmC,GAAG;IACjD,wBAAwB;IACxB,yBAAyB;IACzB,eAAe;IACf,6BAA6B;CACiB,CAAC;AAEjD,kFAAkF;AACrE,QAAA,gCAAgC,GAAG;IAC9C,+BAA+B,EAAE,qBAAqB;IACtD,6BAA6B,EAAE,oBAAoB;IACnD,qBAAqB,EAAE,aAAa;CAC5B,CAAC;AAEX;;;;GAIG;AACU,QAAA,8BAA8B,GAAG;IAC5C,kBAAkB;IAClB,wBAAwB;IACxB,8BAA8B;IAC9B,0BAA0B;IAC1B,0BAA0B;IAC1B,qBAAqB;IACrB,wBAAwB;IACxB,uBAAuB;IACvB,uBAAuB;CACf,CAAC;AAEE,QAAA,aAAa,GAAG;IAC3B,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS;CAC9F,CAAC;AACE,QAAA,oBAAoB,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,CAAU,CAAC;AACzG,QAAA,cAAc,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAU,CAAC;AACnE,QAAA,mBAAmB,GAAG,CAAC,gBAAgB,EAAE,oBAAoB,EAAE,WAAW,EAAE,iBAAiB,CAAU,CAAC;AAQxG,QAAA,mBAAmB,GAAG;IACjC,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc;IAClH,cAAc,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAE,mBAAmB,EAAE,cAAc;CACjH,CAAC"}

package/dist/bridge/validate.d.ts

@@ -0,0 +1,12 @@
+export interface BridgeProvenanceValidation {
+    valid: true;
+    path: string;
+    deterministicKey: string;
+    artifacts: Array<{
+        kind: string;
+        path: string;
+        sha256: string;
+        sizeBytes: number;
+    }>;
+}
+export declare function validateBridgeProvenance(provenancePath: string): BridgeProvenanceValidation;

package/dist/bridge/validate.js

@@ -0,0 +1,370 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateBridgeProvenance = validateBridgeProvenance;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const types_1 = require("./types");
+const hash_1 = require("./hash");
+const UNREAL_MATERIAL_SIDECAR_SCHEMA = 'helix.bridge.unreal-material-sidecar/1';
+const SHA256 = /^[a-f0-9]{64}$/;
+const TEXTURE_PATH = /^textures\/([a-f0-9]{64})\.png$/;
+const PNG_SIGNATURE = Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]);
+const MAX_MATERIAL_SIDECAR_BYTES = 16 * 1024 * 1024;
+const MAX_TEXTURE_BYTES = 512 * 1024 * 1024;
+const MAX_TOTAL_TEXTURE_BYTES = 512 * 1024 * 1024;
+function object(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`);
+    return value;
+}
+function sha256(value, label) {
+    const hash = string(value, label);
+    if (!/^[a-f0-9]{64}$/.test(hash))
+        throw new Error(`${label} is invalid`);
+    return hash;
+}
+function size(value, label) {
+    if (!Number.isSafeInteger(value) || value < 0)
+        throw new Error(`${label} is invalid`);
+    return value;
+}
+function count(value, label, minimum = 0) {
+    if (!Number.isSafeInteger(value) || value < minimum)
+        throw new Error(`${label} is invalid`);
+    return value;
+}
+function portableRelativePath(value, label, allowNested) {
+    const path = string(value, label);
+    if ((0, node_path_1.isAbsolute)(path) || path.includes('\\') || path === '.' || path === '..' || path.split('/').some((part) => part === '' || part === '.' || part === '..') ||
+        (!allowNested && path.includes('/'))) {
+        throw new Error(`${label} must be a portable relative path`);
+    }
+    return path;
+}
+function inputFingerprint(value, label, allowNestedPath) {
+    const fingerprint = object(value, label);
+    return {
+        file: portableRelativePath(fingerprint.file, `${label}.file`, allowNestedPath),
+        sha256: sha256(fingerprint.sha256, `${label}.sha256`),
+        sizeBytes: size(fingerprint.sizeBytes, `${label}.sizeBytes`),
+    };
+}
+function sourceIsDirectory(sourceKind) {
+    return ['unreal.project', 'unity.project', 'godot.project', 'directory.unknown'].includes(sourceKind);
+}
+function validateProvenanceSettings(value, source, sourceKind) {
+    const sourceFileCount = source.fileCount === undefined
+        ? undefined
+        : count(source.fileCount, 'Bridge provenance source.fileCount', 1);
+    const sourceDirectoryCount = source.directoryCount === undefined
+        ? undefined
+        : count(source.directoryCount, 'Bridge provenance source.directoryCount', 0);
+    if (sourceIsDirectory(sourceKind) && (sourceFileCount === undefined || sourceDirectoryCount === undefined)) {
+        throw new Error('Bridge provenance directory source must include fileCount and directoryCount');
+    }
+    const settings = object(value, 'Bridge provenance settings');
+    const contentType = string(settings.contentType, 'Bridge provenance settings.contentType');
+    if (!types_1.BRIDGE_CONTENT_TYPES.includes(contentType) || contentType === 'auto') {
+        throw new Error(`Bridge provenance settings.contentType is invalid: ${contentType}`);
+    }
+    const inputs = object(settings.inputs, 'Bridge provenance settings.inputs');
+    for (const [name, fingerprint] of Object.entries(inputs)) {
+        if (!/^[A-Za-z][A-Za-z0-9._-]{0,126}$/.test(name)) {
+            throw new Error(`Bridge provenance settings.inputs key is invalid: ${name}`);
+        }
+        inputFingerprint(fingerprint, `Bridge provenance settings.inputs.${name}`, false);
+    }
+    const tools = object(settings.tools, 'Bridge provenance settings.tools');
+    for (const [requirement, value] of Object.entries(tools)) {
+        const expectedEnvironment = types_1.BRIDGE_EXTERNAL_TOOL_ENVIRONMENT[requirement];
+        if (!expectedEnvironment) {
+            throw new Error(`Bridge provenance settings.tools key is invalid: ${requirement}`);
+        }
+        const tool = object(value, `Bridge provenance settings.tools.${requirement}`);
+        const environmentVariable = string(tool.environmentVariable, `Bridge provenance settings.tools.${requirement}.environmentVariable`);
+        if (environmentVariable !== expectedEnvironment) {
+            throw new Error(`Bridge provenance settings.tools.${requirement}.environmentVariable does not match ${requirement}`);
+        }
+        inputFingerprint(tool, `Bridge provenance settings.tools.${requirement}`, false);
+    }
+    const sourceBundle = object(settings.sourceBundle, 'Bridge provenance settings.sourceBundle');
+    const snapshot = object(sourceBundle.snapshot, 'Bridge provenance settings.sourceBundle.snapshot');
+    const snapshotKind = string(snapshot.kind, 'Bridge provenance settings.sourceBundle.snapshot.kind');
+    if (snapshotKind !== 'file' && snapshotKind !== 'directory') {
+        throw new Error(`Bridge provenance settings.sourceBundle.snapshot.kind is invalid: ${snapshotKind}`);
+    }
+    if ((snapshotKind === 'directory') !== sourceIsDirectory(sourceKind)) {
+        throw new Error('Bridge provenance settings.sourceBundle.snapshot.kind does not match source.kind');
+    }
+    const snapshotHash = sha256(snapshot.sha256, 'Bridge provenance settings.sourceBundle.snapshot.sha256');
+    const snapshotSize = size(snapshot.sizeBytes, 'Bridge provenance settings.sourceBundle.snapshot.sizeBytes');
+    const snapshotFileCount = count(snapshot.fileCount, 'Bridge provenance settings.sourceBundle.snapshot.fileCount', 1);
+    if (snapshotKind === 'file' && snapshotFileCount !== 1) {
+        throw new Error('Bridge provenance settings.sourceBundle.snapshot.fileCount must be 1 for file sources');
+    }
+    if (snapshotKind === 'directory') {
+        const snapshotDirectoryCount = count(snapshot.directoryCount, 'Bridge provenance settings.sourceBundle.snapshot.directoryCount', 0);
+        if (sourceDirectoryCount !== undefined && snapshotDirectoryCount !== sourceDirectoryCount) {
+            throw new Error('Bridge provenance settings.sourceBundle.snapshot.directoryCount does not match source.directoryCount');
+        }
+    }
+    else if (snapshot.directoryCount !== undefined) {
+        throw new Error('Bridge provenance settings.sourceBundle.snapshot.directoryCount is only valid for directory sources');
+    }
+    if (snapshotHash !== source.sha256)
+        throw new Error('Bridge provenance settings.sourceBundle.snapshot.sha256 does not match source.sha256');
+    if (snapshotSize !== source.sizeBytes)
+        throw new Error('Bridge provenance settings.sourceBundle.snapshot.sizeBytes does not match source.sizeBytes');
+    if (sourceFileCount !== undefined && snapshotFileCount !== sourceFileCount) {
+        throw new Error('Bridge provenance settings.sourceBundle.snapshot.fileCount does not match source.fileCount');
+    }
+    const dependencies = object(sourceBundle.dependencies, 'Bridge provenance settings.sourceBundle.dependencies');
+    if (snapshotKind === 'directory' && Object.keys(dependencies).length > 0) {
+        throw new Error('Bridge provenance settings.sourceBundle.dependencies must be empty for directory sources');
+    }
+    for (const [relativePath, fingerprint] of Object.entries(dependencies)) {
+        const path = portableRelativePath(relativePath, 'Bridge provenance settings.sourceBundle.dependencies key', true);
+        const validated = inputFingerprint(fingerprint, `Bridge provenance settings.sourceBundle.dependencies.${relativePath}`, true);
+        if (validated.file !== path) {
+            throw new Error(`Bridge provenance settings.sourceBundle.dependencies.${relativePath}.file must match its relative key`);
+        }
+    }
+}
+function artifactInside(root, candidate) {
+    const requestedPath = (0, node_path_1.resolve)(root, candidate);
+    const rel = (0, node_path_1.relative)(root, requestedPath);
+    if (rel === '' || rel === '..' || rel.startsWith(`..${node_path_1.sep}`) || (0, node_path_1.isAbsolute)(rel)) {
+        throw new Error(`Bridge provenance artifact escapes its package: ${candidate}`);
+    }
+    const info = (0, node_fs_1.lstatSync)(requestedPath);
+    if (info.isSymbolicLink() || !info.isFile()) {
+        throw new Error(`Bridge provenance artifact must be a regular non-symlink file: ${candidate}`);
+    }
+    const path = (0, node_fs_1.realpathSync)(requestedPath);
+    const canonicalRel = (0, node_path_1.relative)(root, path);
+    if (canonicalRel === '' || canonicalRel === '..' || canonicalRel.startsWith(`..${node_path_1.sep}`) || (0, node_path_1.isAbsolute)(canonicalRel)) {
+        throw new Error(`Bridge provenance artifact escapes its canonical package: ${candidate}`);
+    }
+    return path;
+}
+function exactKeys(value, keys, label) {
+    const allowed = new Set(keys);
+    if (Object.keys(value).some((key) => !allowed.has(key)) || keys.some((key) => !Object.hasOwn(value, key))) {
+        throw new Error(`${label} has an invalid schema`);
+    }
+}
+function materialTextureFingerprint(value, label, requiresSourceAssetPath) {
+    const texture = object(value, label);
+    exactKeys(texture, requiresSourceAssetPath
+        ? ['sourceAssetPath', 'path', 'sha256', 'sizeBytes', 'colorSpace']
+        : ['path', 'sha256', 'sizeBytes', 'colorSpace'], label);
+    if (requiresSourceAssetPath) {
+        const sourceAssetPath = string(texture.sourceAssetPath, `${label}.sourceAssetPath`);
+        if (!sourceAssetPath.startsWith('/'))
+            throw new Error(`${label}.sourceAssetPath is invalid`);
+    }
+    const path = portableRelativePath(texture.path, `${label}.path`, true);
+    const match = TEXTURE_PATH.exec(path);
+    const digest = sha256(texture.sha256, `${label}.sha256`);
+    if (match === null || match[1] !== digest)
+        throw new Error(`${label}.path must be content-addressed by its SHA-256`);
+    const sizeBytes = size(texture.sizeBytes, `${label}.sizeBytes`);
+    if (sizeBytes === 0 || sizeBytes > MAX_TEXTURE_BYTES)
+        throw new Error(`${label}.sizeBytes exceeds the texture limit`);
+    const colorSpace = object(texture.colorSpace, `${label}.colorSpace`);
+    if (Object.keys(colorSpace).some((key) => key !== 'srgb' && key !== 'compressionSettings') ||
+        (colorSpace.srgb !== undefined && typeof colorSpace.srgb !== 'boolean') ||
+        (colorSpace.compressionSettings !== undefined && typeof colorSpace.compressionSettings !== 'string')) {
+        throw new Error(`${label}.colorSpace is invalid`);
+    }
+    return { path, sha256: digest, sizeBytes };
+}
+function sortedTextureInventory(textures, label) {
+    const byPath = new Map();
+    let totalBytes = 0;
+    for (const texture of textures) {
+        const existing = byPath.get(texture.path);
+        if (existing !== undefined) {
+            if (existing.sha256 !== texture.sha256 || existing.sizeBytes !== texture.sizeBytes) {
+                throw new Error(`${label} has conflicting texture metadata for ${texture.path}`);
+            }
+            continue;
+        }
+        byPath.set(texture.path, texture);
+        totalBytes += texture.sizeBytes;
+    }
+    if (!Number.isSafeInteger(totalBytes) || totalBytes > MAX_TOTAL_TEXTURE_BYTES) {
+        throw new Error(`${label} exceeds the total texture limit`);
+    }
+    return [...byPath.values()].sort((left, right) => left.path.localeCompare(right.path));
+}
+function actualMaterialSidecarTextures(value, label) {
+    const sidecar = object(value, label);
+    exactKeys(sidecar, ['schemaVersion', 'asset', 'materials'], label);
+    if (sidecar.schemaVersion !== UNREAL_MATERIAL_SIDECAR_SCHEMA) {
+        throw new Error(`${label}.schemaVersion is invalid`);
+    }
+    const asset = object(sidecar.asset, `${label}.asset`);
+    exactKeys(asset, ['slug', 'sourceMeshAssetPath'], `${label}.asset`);
+    string(asset.slug, `${label}.asset.slug`);
+    if (!string(asset.sourceMeshAssetPath, `${label}.asset.sourceMeshAssetPath`).startsWith('/')) {
+        throw new Error(`${label}.asset.sourceMeshAssetPath is invalid`);
+    }
+    if (!Array.isArray(sidecar.materials))
+        throw new Error(`${label}.materials must be an array`);
+    const textures = [];
+    for (const [index, materialValue] of sidecar.materials.entries()) {
+        const material = object(materialValue, `${label}.materials[${index}]`);
+        exactKeys(material, [
+            'slotIndex', 'slotName', 'importedSlotName', 'sourceMaterialAssetPath', 'sourceRootMaterialAssetPath', 'parameters',
+        ], `${label}.materials[${index}]`);
+        if (material.slotIndex !== index)
+            throw new Error(`${label}.materials[${index}].slotIndex is invalid`);
+        string(material.slotName, `${label}.materials[${index}].slotName`);
+        string(material.importedSlotName, `${label}.materials[${index}].importedSlotName`);
+        for (const field of ['sourceMaterialAssetPath', 'sourceRootMaterialAssetPath']) {
+            if (!string(material[field], `${label}.materials[${index}].${field}`).startsWith('/')) {
+                throw new Error(`${label}.materials[${index}].${field} is invalid`);
+            }
+        }
+        const parameters = object(material.parameters, `${label}.materials[${index}].parameters`);
+        exactKeys(parameters, ['scalars', 'vectors', 'textures'], `${label}.materials[${index}].parameters`);
+        const scalars = object(parameters.scalars, `${label}.materials[${index}].parameters.scalars`);
+        if (Object.values(scalars).some((value) => typeof value !== 'number' || !Number.isFinite(value))) {
+            throw new Error(`${label}.materials[${index}].parameters.scalars is invalid`);
+        }
+        const vectors = object(parameters.vectors, `${label}.materials[${index}].parameters.vectors`);
+        for (const [name, vectorValue] of Object.entries(vectors)) {
+            const vector = object(vectorValue, `${label}.materials[${index}].parameters.vectors.${name}`);
+            exactKeys(vector, ['r', 'g', 'b', 'a'], `${label}.materials[${index}].parameters.vectors.${name}`);
+            if (Object.values(vector).some((value) => typeof value !== 'number' || !Number.isFinite(value))) {
+                throw new Error(`${label}.materials[${index}].parameters.vectors.${name} is invalid`);
+            }
+        }
+        const declaredTextures = object(parameters.textures, `${label}.materials[${index}].parameters.textures`);
+        for (const [name, texture] of Object.entries(declaredTextures)) {
+            string(name, `${label}.materials[${index}].parameters.textures key`);
+            textures.push(materialTextureFingerprint(texture, `${label}.materials[${index}].parameters.textures.${name}`, true));
+        }
+    }
+    return sortedTextureInventory(textures, `${label}.materials`);
+}
+function sameTextureInventory(left, right) {
+    return left.length === right.length && left.every((texture, index) => texture.path === right[index].path &&
+        texture.sha256 === right[index].sha256 &&
+        texture.sizeBytes === right[index].sizeBytes);
+}
+function assertPng(path, label) {
+    const descriptor = (0, node_fs_1.openSync)(path, 'r');
+    try {
+        const header = Buffer.alloc(PNG_SIGNATURE.byteLength);
+        if ((0, node_fs_1.readSync)(descriptor, header, 0, header.length, 0) !== header.length || !header.equals(PNG_SIGNATURE)) {
+            throw new Error(`${label} is not a PNG`);
+        }
+    }
+    finally {
+        (0, node_fs_1.closeSync)(descriptor);
+    }
+}
+function validateFbxMaterialSidecar(root, artifact, index) {
+    const label = `Bridge provenance outputs[${index}].metadata.materialSidecar`;
+    const metadata = object(artifact.metadata, `Bridge provenance outputs[${index}].metadata`);
+    const sidecar = object(metadata.materialSidecar, label);
+    exactKeys(sidecar, ['schemaVersion', 'path', 'sha256', 'sizeBytes', 'textures'], label);
+    if (sidecar.schemaVersion !== UNREAL_MATERIAL_SIDECAR_SCHEMA)
+        throw new Error(`${label}.schemaVersion is invalid`);
+    const path = portableRelativePath(sidecar.path, `${label}.path`, false);
+    const artifactPath = portableRelativePath(artifact.path, `Bridge provenance outputs[${index}].path`, true);
+    if (path !== `${(0, node_path_1.basename)(artifactPath, (0, node_path_1.extname)(artifactPath))}.materials.json`) {
+        throw new Error(`${label}.path must be the adjacent FBX material sidecar`);
+    }
+    const expected = { sha256: sha256(sidecar.sha256, `${label}.sha256`), sizeBytes: size(sidecar.sizeBytes, `${label}.sizeBytes`) };
+    if (expected.sizeBytes === 0 || expected.sizeBytes > MAX_MATERIAL_SIDECAR_BYTES) {
+        throw new Error(`${label}.sizeBytes exceeds the sidecar limit`);
+    }
+    if (!Array.isArray(sidecar.textures))
+        throw new Error(`${label}.textures must be an array`);
+    const expectedTextures = sortedTextureInventory(sidecar.textures.map((texture, textureIndex) => materialTextureFingerprint(texture, `${label}.textures[${textureIndex}]`, false)), `${label}.textures`);
+    const sidecarPath = artifactInside(root, path);
+    const actualSidecar = (0, hash_1.hashAndSizeFileSync)(sidecarPath);
+    if (actualSidecar.sha256 !== expected.sha256 || actualSidecar.sizeBytes !== expected.sizeBytes) {
+        throw new Error(`${label} does not match Bridge provenance: ${sidecarPath}`);
+    }
+    const actualTextures = actualMaterialSidecarTextures(JSON.parse((0, node_fs_1.readFileSync)(sidecarPath, 'utf8')), label);
+    if (!sameTextureInventory(expectedTextures, actualTextures)) {
+        throw new Error(`${label}.textures does not match the sidecar inventory`);
+    }
+    for (const texture of actualTextures) {
+        const texturePath = artifactInside(root, texture.path);
+        const actual = (0, hash_1.hashAndSizeFileSync)(texturePath);
+        if (actual.sha256 !== texture.sha256 || actual.sizeBytes !== texture.sizeBytes) {
+            throw new Error(`${label} texture does not match Bridge provenance: ${texturePath}`);
+        }
+        assertPng(texturePath, `${label} texture`);
+    }
+}
+function validateBridgeProvenance(provenancePath) {
+    const requestedPath = (0, node_path_1.resolve)(provenancePath);
+    const provenanceInfo = (0, node_fs_1.lstatSync)(requestedPath);
+    if (provenanceInfo.isSymbolicLink() || !provenanceInfo.isFile()) {
+        throw new Error(`Bridge provenance must be a regular non-symlink file: ${requestedPath}`);
+    }
+    const path = (0, node_fs_1.realpathSync)(requestedPath);
+    const root = (0, node_fs_1.realpathSync)((0, node_path_1.dirname)(path));
+    const value = object(JSON.parse((0, node_fs_1.readFileSync)(path, 'utf8')), 'Bridge provenance');
+    if (value.schemaVersion !== types_1.BRIDGE_PROVENANCE_SCHEMA) {
+        throw new Error(`Bridge provenance schemaVersion must be '${types_1.BRIDGE_PROVENANCE_SCHEMA}'`);
+    }
+    const deterministicKey = string(value.deterministicKey, 'Bridge provenance deterministicKey');
+    if (!/^[a-f0-9]{64}$/.test(deterministicKey))
+        throw new Error('Bridge provenance deterministicKey is invalid');
+    const source = object(value.source, 'Bridge provenance source');
+    portableRelativePath(source.path, 'Bridge provenance source.path', false);
+    const sourceKind = string(source.kind, 'Bridge provenance source.kind');
+    if (!types_1.BRIDGE_SOURCE_KINDS.includes(sourceKind))
+        throw new Error(`Bridge provenance source.kind is invalid: ${sourceKind}`);
+    sha256(source.sha256, 'Bridge provenance source.sha256');
+    size(source.sizeBytes, 'Bridge provenance source.sizeBytes');
+    if (!Array.isArray(value.plugins) || value.plugins.length === 0)
+        throw new Error('Bridge provenance plugins must not be empty');
+    for (const [index, entry] of value.plugins.entries()) {
+        const plugin = object(entry, `Bridge provenance plugins[${index}]`);
+        string(plugin.id, `Bridge provenance plugins[${index}].id`);
+        string(plugin.version, `Bridge provenance plugins[${index}].version`);
+        sha256(plugin.digest, `Bridge provenance plugins[${index}].digest`);
+    }
+    if (!Array.isArray(value.capabilities) || value.capabilities.length === 0)
+        throw new Error('Bridge provenance capabilities must not be empty');
+    for (const [index, capability] of value.capabilities.entries())
+        string(capability, `Bridge provenance capabilities[${index}]`);
+    const target = string(value.target, 'Bridge provenance target');
+    if (!types_1.BRIDGE_TARGETS.includes(target))
+        throw new Error(`Bridge provenance target is invalid: ${target}`);
+    validateProvenanceSettings(value.settings, source, sourceKind);
+    const createdAt = string(value.createdAt, 'Bridge provenance createdAt');
+    if (Number.isNaN(Date.parse(createdAt)))
+        throw new Error('Bridge provenance createdAt is invalid');
+    if (!Array.isArray(value.outputs) || value.outputs.length === 0)
+        throw new Error('Bridge provenance outputs must not be empty');
+    const artifacts = value.outputs.map((entry, index) => {
+        const artifact = object(entry, `Bridge provenance outputs[${index}]`);
+        const kind = string(artifact.kind, `Bridge provenance outputs[${index}].kind`);
+        const artifactPath = artifactInside(root, string(artifact.path, `Bridge provenance outputs[${index}].path`));
+        const expectedSha256 = sha256(artifact.sha256, `Bridge provenance outputs[${index}].sha256`);
+        const expectedSizeBytes = size(artifact.sizeBytes, `Bridge provenance outputs[${index}].sizeBytes`);
+        const actual = (0, hash_1.hashAndSizeFileSync)(artifactPath);
+        if (actual.sizeBytes !== expectedSizeBytes || actual.sha256 !== expectedSha256) {
+            throw new Error(`${kind} artifact does not match Bridge provenance: ${artifactPath}`);
+        }
+        if (kind === 'format.fbx')
+            validateFbxMaterialSidecar(root, artifact, index);
+        return { kind, path: artifactPath, ...actual };
+    });
+    return { valid: true, path, deterministicKey, artifacts };
+}
+//# sourceMappingURL=validate.js.map

package/dist/bridge/validate.js.map

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

package/dist/bridge/zipSource.d.ts

@@ -0,0 +1,27 @@
+import { type ArchiveLimits } from '../sceneImport/archive';
+/**
+ * Caps for a mod archive downloaded from a repository. Entry count matches the BeamNG importer's own
+ * 50,000-file source ceiling; the byte ceilings are per entry and in total, and the compression-ratio
+ * guard from the shared archive reader still applies.
+ */
+export declare const ZIP_SOURCE_LIMITS: ArchiveLimits;
+export type PreparedBridgeSource = {
+    /** Directory (or the original file) the Bridge should read. */
+    path: string;
+    /** Set when `path` is a temporary extraction of this ZIP. */
+    extractedFrom?: {
+        archive: string;
+        sha256: string;
+        entries: number;
+        uncompressedBytes: number;
+    };
+    cleanup(): Promise<void>;
+};
+export declare function isZipSourcePath(source: string): boolean;
+/**
+ * Safely extract a `.zip` source to a private temporary directory. The archive is rejected as a whole
+ * if any entry is absolute, climbs out with `..`, is duplicated, exceeds the size caps, or looks like a
+ * decompression bomb; members are written with exclusive-create into an empty real directory that is
+ * removed by `cleanup()` (and on process exit). A non-zip source is returned unchanged.
+ */
+export declare function prepareBridgeSource(source: string, onProgress?: (message: string) => void, limits?: ArchiveLimits): Promise<PreparedBridgeSource>;

package/dist/bridge/zipSource.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZIP_SOURCE_LIMITS = void 0;
+exports.isZipSourcePath = isZipSourcePath;
+exports.prepareBridgeSource = prepareBridgeSource;
+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 archive_1 = require("../sceneImport/archive");
+/**
+ * Caps for a mod archive downloaded from a repository. Entry count matches the BeamNG importer's own
+ * 50,000-file source ceiling; the byte ceilings are per entry and in total, and the compression-ratio
+ * guard from the shared archive reader still applies.
+ */
+exports.ZIP_SOURCE_LIMITS = {
+    maxEntries: 50_000,
+    maxEntryBytes: 1_073_741_824,
+    maxTotalBytes: 8 * 1_073_741_824,
+    maxCompressionRatio: 1_000,
+};
+/** Archive bookkeeping that is never part of a mod's content. */
+const JUNK = /(?:^|\/)(?:__MACOSX|\.DS_Store|Thumbs\.db)(?:\/|$)/;
+function isZipSourcePath(source) {
+    const path = (0, node_path_1.resolve)(source);
+    if ((0, node_path_1.extname)(path).toLowerCase() !== '.zip')
+        return false;
+    try {
+        return (0, node_fs_1.statSync)(path).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+/** A mod zipped with one wrapper folder (`MyMod/vehicles/...`) is read from inside that folder. */
+function unwrapSingleFolder(root) {
+    const entries = (0, node_fs_1.readdirSync)(root, { withFileTypes: true });
+    if (entries.some((entry) => entry.isDirectory() && entry.name === 'vehicles'))
+        return root;
+    const folders = entries.filter((entry) => entry.isDirectory());
+    if (folders.length === 1 && entries.length === 1) {
+        return unwrapSingleFolder((0, node_path_1.join)(root, folders[0].name));
+    }
+    return root;
+}
+/**
+ * Safely extract a `.zip` source to a private temporary directory. The archive is rejected as a whole
+ * if any entry is absolute, climbs out with `..`, is duplicated, exceeds the size caps, or looks like a
+ * decompression bomb; members are written with exclusive-create into an empty real directory that is
+ * removed by `cleanup()` (and on process exit). A non-zip source is returned unchanged.
+ */
+async function prepareBridgeSource(source, onProgress, limits = exports.ZIP_SOURCE_LIMITS) {
+    if (!isZipSourcePath(source))
+        return { path: source, cleanup: async () => { } };
+    const archive = (0, node_path_1.resolve)(source);
+    const sha256 = await (0, archive_1.sha256File)(archive);
+    const inventory = await (0, archive_1.inventorySourceArchive)(archive, sha256, limits);
+    const members = inventory.entries
+        .filter((entry) => !entry.directory && !JUNK.test(entry.path))
+        .map((entry) => entry.path);
+    if (members.length === 0)
+        throw new Error(`Bridge source archive is empty: ${archive}`);
+    const scratch = await (0, promises_1.mkdtemp)((0, node_path_1.join)((0, node_os_1.tmpdir)(), 'helix-zip-source-'));
+    const exitCleanup = () => { try {
+        (0, node_fs_1.rmSync)(scratch, { recursive: true, force: true });
+    }
+    catch { /* best effort */ } };
+    process.once('exit', exitCleanup);
+    const cleanup = async () => {
+        process.removeListener('exit', exitCleanup);
+        await (0, promises_1.rm)(scratch, { recursive: true, force: true });
+    };
+    try {
+        const output = (0, node_path_1.join)(scratch, 'source');
+        onProgress?.(`extracting ${members.length} file(s) from ${archive} (${inventory.uncompressedBytes} bytes)`);
+        await (0, archive_1.extractArchiveMembers)({ archivePath: archive, expectedSha256: sha256, members, outputDir: output, limits });
+        return {
+            path: unwrapSingleFolder(output),
+            extractedFrom: {
+                archive, sha256, entries: members.length, uncompressedBytes: inventory.uncompressedBytes,
+            },
+            cleanup,
+        };
+    }
+    catch (error) {
+        await cleanup();
+        throw error;
+    }
+}
+//# sourceMappingURL=zipSource.js.map

package/dist/bridge/zipSource.js.map

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