@hypersoniclabs/helix-cli 0.1.6 → 0.1.23

package/dist/resolve.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.normalizePinRange = normalizePinRange;
+exports.validateAssetPackConstraints = validateAssetPackConstraints;
+exports.defaultDeps = defaultDeps;
 exports.resolvePins = resolvePins;
 const api_1 = require("./api");
 const ability_1 = require("./ability");
@@ -21,22 +23,51 @@ function normalizePinRange(range) {
 function maxOf(versions, compare) {
     return versions.reduce((max, v) => (compare(v, max) > 0 ? v : max));
 }
-async function resolveVersion(deps, slug, range) {
+function matchesRange(deps, version, range) {
+    const normalized = normalizePinRange(range);
+    return normalized === 'latest' || deps.satisfies(version, normalized);
+}
+/** Invocation-local asset constraints; the system envelope remains authoritative. */
+function validateAssetPackConstraints(constraints) {
+    for (const [slug, range] of Object.entries(constraints)) {
+        if (!/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(slug))
+            throw new Error(`invalid asset-pack slug "${slug}"`);
+        // Validate before normalization: normalizePinRange intentionally pads partial pins,
+        // but must not turn a malformed explicit constraint (e.g. 0.1.4.9) into a valid pin.
+        if (typeof range !== 'string' || !/^(?:latest|\*|[~^]?(?:0|[1-9]\d*)(?:\.(?:0|[1-9]\d*)){0,2}(?:-[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?)$/.test(range.trim())) {
+            throw new Error(`invalid asset-pack range for "${slug}": use an exact version, ^/~ range, latest or *`);
+        }
+    }
+}
+async function resolveVersion(deps, slug, range, requiredRange) {
+    // A complete exact pin is deliberate opt-in to an active staged version. The
+    // public version-detail endpoint remains authoritative (and rejects missing or
+    // inactive versions); the floating catalog intentionally excludes 0% rollouts.
+    // Keep partial pins and every range on that catalog path.
+    if (/^\d+\.\d+\.\d+(?:-[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/.test(range.trim())) {
+        if (requiredRange !== undefined && !matchesRange(deps, range.trim(), requiredRange)) {
+            throw new Error(`asset-pack "${slug}@${range.trim()}" does not satisfy system requirement "${requiredRange}"`);
+        }
+        return range.trim();
+    }
     const all = await deps.listVersions(slug);
     if (all.length === 0)
         throw new Error(`no active version of "${slug}" is published`);
+    const eligible = requiredRange === undefined ? all : all.filter((v) => matchesRange(deps, v, requiredRange));
     const norm = normalizePinRange(range);
     if (norm === 'latest') {
         // Prefer a stable release; only fall back to prereleases when nothing stable is published.
-        const stable = all.filter((v) => !v.includes('-'));
-        return maxOf(stable.length ? stable : all, deps.compare);
+        if (!eligible.length)
+            throw new Error(`no published version of "${slug}" satisfies system requirement "${requiredRange}"`);
+        const stable = eligible.filter((v) => !v.includes('-'));
+        return maxOf(stable.length ? stable : eligible, deps.compare);
     }
-    const matches = all.filter((v) => deps.satisfies(v, norm));
+    const matches = eligible.filter((v) => deps.satisfies(v, norm));
     if (matches.length === 0)
         throw new Error(`no published version of "${slug}" satisfies "${range}" (available: ${all.join(', ')})`);
     return maxOf(matches, deps.compare);
 }
-async function resolveOne(deps, kind, slug, range) {
+async function resolveOne(deps, kind, slug, range, constraints = {}) {
     const version = await resolveVersion(deps, slug, range);
     const detail = await deps.getVersion(slug, version);
     if (detail.kind !== kind) {
@@ -47,11 +78,37 @@ async function resolveOne(deps, kind, slug, range) {
     if (kind === 'ability') {
         return { kind, slug, range, version, codeUrl: detail.codeBaseUrl, codeFiles, assetBaseUrl: detail.assetBaseUrl };
     }
-    // A system ships code only; its assets come from a separate asset-pack discovered via the
-    // envelope (fallback <slug>-assets@latest). The system's assetBaseUrl IS the asset-pack's base.
-    const pin = detail.manifest.assetPack ?? { slug: `${slug}-assets`, range: 'latest' };
-    const apVersion = await resolveVersion(deps, pin.slug, pin.range);
+    // A system ships code only; its assets come from a separate asset-pack. A DECLARED envelope
+    // assetPack must resolve (fail loudly). Undeclared, we probe the legacy <slug>-assets convention
+    // but treat a missing pack as an asset-free system (e.g. engine-core) rather than an error.
+    const declared = detail.manifest.assetPack;
+    const pin = declared ?? { slug: `${slug}-assets`, range: 'latest' };
+    const constraint = Object.hasOwn(constraints, pin.slug) ? constraints[pin.slug] : undefined;
+    let apVersion;
+    try {
+        apVersion = await resolveVersion(deps, pin.slug, constraint ?? pin.range, constraint === undefined ? undefined : pin.range);
+    }
+    catch (err) {
+        const missingPack = err instanceof Error && /no (package|active version)/.test(err.message);
+        if (!declared && constraint === undefined && missingPack) {
+            return {
+                kind,
+                slug,
+                range,
+                version,
+                codeUrl: detail.codeBaseUrl,
+                codeFiles,
+                assetBaseUrl: null,
+                ...(typeof detail.manifest.three === 'string' ? { three: detail.manifest.three } : {}),
+                ...(typeof detail.manifest.rapier === 'string' ? { rapier: detail.manifest.rapier } : {}),
+            };
+        }
+        throw err;
+    }
     const apDetail = await deps.getVersion(pin.slug, apVersion);
+    if (apDetail.kind !== 'asset-pack' || apDetail.slug !== pin.slug || apDetail.version !== apVersion) {
+        throw new Error(`asset-pack "${pin.slug}@${apVersion}" catalog identity does not match the requested asset-pack`);
+    }
     if (!apDetail.assetBaseUrl)
         throw new Error(`asset-pack "${pin.slug}@${apVersion}" has no asset base URL`);
     return {
@@ -64,8 +121,11 @@ async function resolveOne(deps, kind, slug, range) {
         assetBaseUrl: apDetail.assetBaseUrl,
         assetPack: { slug: pin.slug, version: apVersion, range: pin.range, assetBaseUrl: apDetail.assetBaseUrl },
         ...(typeof detail.manifest.three === 'string' ? { three: detail.manifest.three } : {}),
+        ...(typeof detail.manifest.rapier === 'string' ? { rapier: detail.manifest.rapier } : {}),
     };
 }
+// Exported so other callers needing the live catalog (e.g. `assessWorldCurrency`) reuse this exact
+// wiring — an unauthenticated HelixApi + the vendored semver primitives — instead of re-deriving it.
 async function defaultDeps(apiUrl) {
     const v = await (0, ability_1.loadVendoredValidator)();
     if (!v.satisfiesSystemPin || !v.parseSemver || !v.compareSemver) {
@@ -94,9 +154,15 @@ async function defaultDeps(apiUrl) {
 }
 // Resolve every pin in a v0.2 world manifest to an exact active version + its CDN bases. Pass
 // `deps` to resolve against an injected catalog (tests); omit it to hit the live platform.
-async function resolvePins(apiUrl, pins, deps) {
+async function resolvePins(apiUrl, pins, deps, assetPacks = {}) {
+    validateAssetPackConstraints(assetPacks);
     const d = deps ?? (await defaultDeps(apiUrl));
-    const systems = await Promise.all(Object.entries(pins.systems ?? {}).map(([slug, range]) => resolveOne(d, 'system', slug, range)));
+    const systems = await Promise.all(Object.entries(pins.systems ?? {}).map(([slug, range]) => resolveOne(d, 'system', slug, range, assetPacks)));
+    for (const slug of Object.keys(assetPacks)) {
+        if (!systems.some((system) => system.assetPack?.slug === slug)) {
+            throw new Error(`asset-pack constraint "${slug}" is not used by any requested system`);
+        }
+    }
     const abilities = await Promise.all(Object.entries(pins.abilities ?? {}).map(([slug, range]) => resolveOne(d, 'ability', slug, range)));
     return { systems, abilities };
 }

package/dist/resolve.js.map

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

package/dist/sceneElements/compiler.d.ts

@@ -0,0 +1,21 @@
+import { type HelixSceneV2 } from '@hypersoniclabs/helix-manifest';
+import type { SceneElementsDocument } from './types';
+/** Bundle-relative bytes a compiled document expects beside itself: the caller copies each to `<document dir>/<uri>`. */
+export type SceneBundleFile = {
+    uri: string;
+    /** Absolute path of the authored file the uri is served from. */
+    path: string;
+    bytes: number;
+    sha256: string;
+};
+export type CompileSceneElementsOptions = {
+    /** Directory the document's relative paths resolve against — normally the elements file's own folder. */
+    baseDir?: string;
+};
+export type SceneElementsCompilation = {
+    scene: HelixSceneV2;
+    bundleFiles: SceneBundleFile[];
+};
+export declare function compileSceneElementsBundle(input: SceneElementsDocument, options?: CompileSceneElementsOptions): SceneElementsCompilation;
+/** The sealed document alone, for callers that ship no bundle bytes beside it. */
+export declare function compileSceneElements(input: SceneElementsDocument, options?: CompileSceneElementsOptions): HelixSceneV2;