@helix3/helix-cli 0.1.4-helix3.24

package/dist/character/stages/splitFacePrimitive.js

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.splitFacePrimitive = splitFacePrimitive;
+// PORTED from helix-web-engine-new/tools/character-pipeline — the source of truth for the character
+// pipeline. SYNC OBLIGATION: fix bugs there first, then mirror the change here; do not diverge.
+const core_1 = require("@gltf-transform/core");
+/**
+ * Slices the head geometry out of a single-mesh character into its own 'FaceMesh' node, so the
+ * runtime's first-person mode can hide it (CameraRig `fpHideMeshes` matches mesh names containing
+ * 'FaceMesh'; the stock character ships its face as a separate part — imports are one welded mesh).
+ *
+ * The split is WEIGHT-driven and therefore rig-agnostic: after conform the skeleton is canonical,
+ * so a triangle belongs to the face part when its mean skin weight into the NECK-AND-UP subtree
+ * (neck_01 -> neck_02 -> head -> facial root; falls back to 'head' when no neck joint exists)
+ * exceeds 0.5. Rooting at the neck matters on auto-rigged imports: their face skin blends head WITH
+ * neck (head alone rarely crosses 0.5 outside the skull), and the stock face part includes a neck
+ * skirt too (see CameraRig's skull-measure). Scalp-anchored hair/hats ride along; LONG draped hair
+ * that auto-rigs weight to the clavicles stays on the body — in first person it behaves like
+ * shoulder-wear, swaying at the screen edges the way the visible shoulders do. Only the index
+ * buffer splits — the face primitive SHARES the body's attribute accessors, so the file grows by
+ * one index accessor and one node per scene. The MATERIAL however must be a distinct instance
+ * (textures still shared): the runtime hides the face by mutating material.colorWrite, and
+ * GLTFLoader gives prims that reference one glTF material the same THREE.Material — a shared
+ * material would hide the body. For that same reason this stage MUST run AFTER merge-lods: its
+ * dedup compares materials by value (names ignored) and would fold the face clone back into the
+ * body material. Every scene of the merged document is split (scene i = LOD level i).
+ */
+function splitFacePrimitive(document) {
+    let split = false, faceTris = 0, bodyTris = 0, headJoints = 0;
+    for (const scene of document.getRoot().listScenes()) {
+        let hostNode = null;
+        scene.traverse((node) => { if (hostNode === null && node.getMesh() !== null && node.getSkin() !== null)
+            hostNode = node; });
+        if (hostNode === null)
+            continue;
+        const host = hostNode;
+        const skin = host.getSkin();
+        const joints = skin.listJoints();
+        const subtreeRoot = joints.find((j) => j.getName() === 'neck_01') ?? joints.find((j) => j.getName() === 'head');
+        if (subtreeRoot === undefined)
+            continue;
+        const headSet = new Set();
+        const mark = (node) => {
+            const idx = joints.indexOf(node);
+            if (idx >= 0)
+                headSet.add(idx);
+            for (const child of node.listChildren())
+                mark(child);
+        };
+        mark(subtreeRoot);
+        headJoints = headSet.size;
+        const facePrims = [];
+        const el = [];
+        for (const prim of host.getMesh().listPrimitives()) {
+            const indices = prim.getIndices();
+            const j0 = prim.getAttribute('JOINTS_0');
+            const w0 = prim.getAttribute('WEIGHTS_0');
+            if (prim.getMode() !== 4 || indices === null || j0 === null || w0 === null)
+                continue;
+            // per-vertex weight into the head subtree (getElement denormalizes quantized weights)
+            const headness = new Float32Array(j0.getCount());
+            const jv = [];
+            for (let v = 0; v < j0.getCount(); v++) {
+                j0.getElement(v, jv);
+                w0.getElement(v, el);
+                let h = 0;
+                for (let c = 0; c < 4; c++)
+                    if (headSet.has(jv[c]))
+                        h += el[c];
+                headness[v] = h;
+            }
+            const idx = indices.getArray();
+            const face = [], body = [];
+            for (let i = 0; i < idx.length; i += 3) {
+                const mean = (headness[idx[i]] + headness[idx[i + 1]] + headness[idx[i + 2]]) / 3;
+                (mean > 0.5 ? face : body).push(idx[i], idx[i + 1], idx[i + 2]);
+            }
+            if (face.length === 0) {
+                bodyTris += idx.length / 3;
+                continue;
+            }
+            const buffer = document.getRoot().listBuffers()[0];
+            prim.setIndices(document.createAccessor().setType('SCALAR').setArray(new Uint32Array(body)).setBuffer(buffer));
+            const material = prim.getMaterial();
+            const facePrim = document.createPrimitive()
+                .setMode(4)
+                .setMaterial(material !== null ? material.clone().setName(`${material.getName() || 'material'}_FaceMesh`) : null)
+                .setIndices(document.createAccessor().setType('SCALAR').setArray(new Uint32Array(face)).setBuffer(buffer));
+            for (const semantic of prim.listSemantics())
+                facePrim.setAttribute(semantic, prim.getAttribute(semantic));
+            facePrims.push(facePrim);
+            faceTris += face.length / 3;
+            bodyTris += body.length / 3;
+        }
+        if (facePrims.length === 0)
+            continue;
+        const faceMesh = document.createMesh('FaceMesh');
+        for (const prim of facePrims)
+            faceMesh.addPrimitive(prim);
+        const faceNode = document.createNode('FaceMesh').setMesh(faceMesh).setSkin(skin);
+        for (const parent of host.listParents()) {
+            if (parent.propertyType === core_1.PropertyType.NODE) {
+                parent.addChild(faceNode);
+                break;
+            }
+            if (parent.propertyType === core_1.PropertyType.SCENE) {
+                parent.addChild(faceNode);
+                break;
+            }
+        }
+        split = true;
+    }
+    return { split, faceTris, bodyTris, headJoints };
+}
+//# sourceMappingURL=splitFacePrimitive.js.map

package/dist/character/stages/splitFacePrimitive.js.map

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

package/dist/character/stages/weldedSimplify.d.ts

@@ -0,0 +1,32 @@
+import { Document } from '@gltf-transform/core';
+export interface WeldedSimplifyResult {
+    before: number;
+    after: number;
+    /** Fraction of output triangles whose three corners agreed on one source UV chart (1 = zero smear). */
+    uvCoherence: number;
+}
+export interface SeamAnalysis {
+    verts: number;
+    positions: number;
+    charts: number;
+    tris: number;
+    /** True when the atlas is shredded into micro-charts (>= 1 chart per 50 tris). Attribute-preserving
+     * simplify on such a mesh is both floored AND lumpy (only chart interiors may collapse) — route it
+     * through weldedSimplify + unwrap + bake instead. */
+    microChartAtlas: boolean;
+}
+/** Measures how seam-shredded a mesh is: index-connectivity islands ARE the atlas charts. */
+export declare function analyzeSeams(document: Document): SeamAnalysis;
+/**
+ * Seam-breaking simplification for baked-atlas IMPORTS (Meshy-class meshes). Their auto-unwrap shreds
+ * the atlas into micro-charts (~7 tris each on the reference warrior), splitting every border vertex;
+ * meshopt preserves attribute seams, so attribute-aware simplify floors at the chart-border ring
+ * (~34% of source) regardless of error budget. This stage welds vertices by exact position (the
+ * position-level surface is a clean manifold that simplifies to any target), then repairs attributes:
+ * each output corner is re-pointed at a REAL original vertex — per triangle, the UV chart shared by
+ * the most corners wins, so triangles that survived inside one chart keep pristine UVs and only
+ * chart-spanning triangles smear. Normals are recomputed smooth (source normals are per-copy shreds);
+ * every other attribute (JOINTS/WEIGHTS/...) rides along with the chosen copy, so skinning survives.
+ * NEVER use on first-party identity-texture bodies — this trades UV fidelity for triangle count.
+ */
+export declare function weldedSimplify(document: Document, targetTris: number, errorCap?: number): Promise<WeldedSimplifyResult>;

package/dist/character/stages/weldedSimplify.js

@@ -0,0 +1,202 @@
+"use strict";
+// PORTED from helix-web-engine-new/tools/character-pipeline — the source of truth for the character
+// pipeline. SYNC OBLIGATION: fix bugs there first, then mirror the change here; do not diverge.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyzeSeams = analyzeSeams;
+exports.weldedSimplify = weldedSimplify;
+const meshoptimizer_1 = require("meshoptimizer");
+const report_1 = require("./report");
+/** Measures how seam-shredded a mesh is: index-connectivity islands ARE the atlas charts. */
+function analyzeSeams(document) {
+    let verts = 0, charts = 0, tris = 0;
+    const positions = new Set();
+    for (const mesh of document.getRoot().listMeshes()) {
+        for (const prim of mesh.listPrimitives()) {
+            const pos = prim.getAttribute('POSITION');
+            const ix = prim.getIndices();
+            if (prim.getMode() !== 4 || pos === null || ix === null)
+                continue;
+            const p = pos.getArray();
+            const n = pos.getCount();
+            verts += n;
+            tris += ix.getCount() / 3;
+            for (let v = 0; v < n; v++)
+                positions.add(`${p[v * 3]},${p[v * 3 + 1]},${p[v * 3 + 2]}`);
+            const parent = new Int32Array(n);
+            for (let i = 0; i < n; i++)
+                parent[i] = i;
+            const find = (x) => { while (parent[x] !== x) {
+                parent[x] = parent[parent[x]];
+                x = parent[x];
+            } return x; };
+            const arr = ix.getArray();
+            for (let i = 0; i < arr.length; i += 3) {
+                const a = find(arr[i]), b = find(arr[i + 1]), c = find(arr[i + 2]);
+                parent[b] = a;
+                parent[c] = a;
+            }
+            const roots = new Set();
+            for (let i = 0; i < arr.length; i++)
+                roots.add(find(arr[i]));
+            charts += roots.size;
+        }
+    }
+    return { verts, positions: positions.size, charts, tris, microChartAtlas: tris > 0 && charts / tris > 0.02 };
+}
+/**
+ * Seam-breaking simplification for baked-atlas IMPORTS (Meshy-class meshes). Their auto-unwrap shreds
+ * the atlas into micro-charts (~7 tris each on the reference warrior), splitting every border vertex;
+ * meshopt preserves attribute seams, so attribute-aware simplify floors at the chart-border ring
+ * (~34% of source) regardless of error budget. This stage welds vertices by exact position (the
+ * position-level surface is a clean manifold that simplifies to any target), then repairs attributes:
+ * each output corner is re-pointed at a REAL original vertex — per triangle, the UV chart shared by
+ * the most corners wins, so triangles that survived inside one chart keep pristine UVs and only
+ * chart-spanning triangles smear. Normals are recomputed smooth (source normals are per-copy shreds);
+ * every other attribute (JOINTS/WEIGHTS/...) rides along with the chosen copy, so skinning survives.
+ * NEVER use on first-party identity-texture bodies — this trades UV fidelity for triangle count.
+ */
+async function weldedSimplify(document, targetTris, errorCap = 0.05) {
+    const before = (0, report_1.countTriangles)(document);
+    if (before <= targetTris)
+        return { before, after: before, uvCoherence: 1 };
+    await meshoptimizer_1.MeshoptSimplifier.ready;
+    let coherentTris = 0;
+    let outputTris = 0;
+    for (const mesh of document.getRoot().listMeshes()) {
+        for (const prim of mesh.listPrimitives()) {
+            if (prim.getMode() !== 4 || prim.getIndices() === null || prim.getAttribute('POSITION') === null)
+                continue;
+            const primTris = prim.getIndices().getCount() / 3;
+            // Multi-prim imports: each prim gets a share of the target proportional to its share of the tris.
+            const primTarget = Math.max(1, Math.round((primTris / before) * targetTris));
+            const stats = simplifyPrimitive(document, prim, primTarget, errorCap);
+            coherentTris += stats.coherent;
+            outputTris += stats.tris;
+        }
+    }
+    return { before, after: (0, report_1.countTriangles)(document), uvCoherence: outputTris > 0 ? coherentTris / outputTris : 1 };
+}
+function simplifyPrimitive(document, prim, targetTris, errorCap) {
+    const idx = prim.getIndices().getArray();
+    const pos = prim.getAttribute('POSITION').getArray();
+    const nVerts = pos.length / 3;
+    // UV chart per original vertex = connected component of the ORIGINAL index topology (charts are
+    // fully split at their borders, so index-connectivity islands ARE the atlas charts).
+    const parent = new Int32Array(nVerts);
+    for (let i = 0; i < nVerts; i++)
+        parent[i] = i;
+    const find = (x) => { while (parent[x] !== x) {
+        parent[x] = parent[parent[x]];
+        x = parent[x];
+    } return x; };
+    for (let i = 0; i < idx.length; i += 3) {
+        const a = find(idx[i]), b = find(idx[i + 1]), c = find(idx[i + 2]);
+        parent[b] = a;
+        parent[c] = a;
+    }
+    // Weld by exact position -> compacted slots; slotCopies preserves every original co-located vertex.
+    const slotByKey = new Map();
+    const slotOf = new Uint32Array(nVerts);
+    const slotCopies = [];
+    for (let v = 0; v < nVerts; v++) {
+        const key = `${pos[v * 3]},${pos[v * 3 + 1]},${pos[v * 3 + 2]}`;
+        let slot = slotByKey.get(key);
+        if (slot === undefined) {
+            slot = slotCopies.length;
+            slotByKey.set(key, slot);
+            slotCopies.push([]);
+        }
+        slotOf[v] = slot;
+        slotCopies[slot].push(v);
+    }
+    const weldedPos = new Float32Array(slotCopies.length * 3);
+    for (let s = 0; s < slotCopies.length; s++) {
+        const o = slotCopies[s][0];
+        weldedPos[s * 3] = pos[o * 3];
+        weldedPos[s * 3 + 1] = pos[o * 3 + 1];
+        weldedPos[s * 3 + 2] = pos[o * 3 + 2];
+    }
+    const weldedIdx = [];
+    for (let i = 0; i < idx.length; i += 3) {
+        const a = slotOf[idx[i]], b = slotOf[idx[i + 1]], c = slotOf[idx[i + 2]];
+        if (a !== b && b !== c && a !== c)
+            weldedIdx.push(a, b, c);
+    }
+    const [simplified] = meshoptimizer_1.MeshoptSimplifier.simplify(new Uint32Array(weldedIdx), weldedPos, 3, targetTris * 3, errorCap, []);
+    // Re-point each output corner at a real original vertex: per triangle, the chart covering the most
+    // corners wins; corners without a copy in that chart fall back to their first copy (the smear case).
+    let coherent = 0;
+    const outIdxByCopy = new Map();
+    const outIdx = new Uint32Array(simplified.length);
+    const chartsOf = (slot) => {
+        const charts = new Map();
+        for (const copy of slotCopies[slot])
+            charts.set(find(copy), copy);
+        return charts;
+    };
+    for (let i = 0; i < simplified.length; i += 3) {
+        const corners = [chartsOf(simplified[i]), chartsOf(simplified[i + 1]), chartsOf(simplified[i + 2])];
+        const votes = new Map();
+        for (const corner of corners)
+            for (const chart of corner.keys())
+                votes.set(chart, (votes.get(chart) ?? 0) + 1);
+        let best = -1, bestVotes = 0;
+        for (const [chart, count] of votes)
+            if (count > bestVotes) {
+                best = chart;
+                bestVotes = count;
+            }
+        if (bestVotes === 3)
+            coherent++;
+        for (let k = 0; k < 3; k++) {
+            const copy = corners[k].get(best) ?? slotCopies[simplified[i + k]][0];
+            let mapped = outIdxByCopy.get(copy);
+            if (mapped === undefined) {
+                mapped = outIdxByCopy.size;
+                outIdxByCopy.set(copy, mapped);
+            }
+            outIdx[i + k] = mapped;
+        }
+    }
+    // Rebuild the vertex stream as a subset of the ORIGINAL vertices — every attribute stays consistent.
+    const buffer = document.getRoot().listBuffers()[0];
+    const copyList = [...outIdxByCopy.keys()];
+    for (const semantic of prim.listSemantics()) {
+        const src = prim.getAttribute(semantic);
+        const srcArray = src.getArray();
+        const size = src.getElementSize();
+        const subset = new srcArray.constructor(copyList.length * size);
+        copyList.forEach((copy, out) => { for (let c = 0; c < size; c++)
+            subset[out * size + c] = srcArray[copy * size + c]; });
+        prim.setAttribute(semantic, document.createAccessor().setType(src.getType()).setArray(subset).setNormalized(src.getNormalized()).setBuffer(buffer));
+    }
+    prim.setIndices(document.createAccessor().setType('SCALAR').setArray(outIdx).setBuffer(buffer));
+    // Smooth normals from the final geometry, shared per welded slot (area-weighted via raw cross products).
+    if (prim.getAttribute('NORMAL') !== null) {
+        const outPos = prim.getAttribute('POSITION').getArray();
+        const acc = new Float32Array(slotCopies.length * 3);
+        for (let i = 0; i < outIdx.length; i += 3) {
+            const p = [0, 1, 2].map((k) => outIdx[i + k] * 3);
+            const ux = outPos[p[1]] - outPos[p[0]], uy = outPos[p[1] + 1] - outPos[p[0] + 1], uz = outPos[p[1] + 2] - outPos[p[0] + 2];
+            const vx = outPos[p[2]] - outPos[p[0]], vy = outPos[p[2] + 1] - outPos[p[0] + 1], vz = outPos[p[2] + 2] - outPos[p[0] + 2];
+            const nx = uy * vz - uz * vy, ny = uz * vx - ux * vz, nz = ux * vy - uy * vx;
+            for (let k = 0; k < 3; k++) {
+                const slot = slotOf[copyList[outIdx[i + k]]] * 3;
+                acc[slot] = acc[slot] + nx;
+                acc[slot + 1] = acc[slot + 1] + ny;
+                acc[slot + 2] = acc[slot + 2] + nz;
+            }
+        }
+        const normals = new Float32Array(copyList.length * 3);
+        copyList.forEach((copy, out) => {
+            const slot = slotOf[copy] * 3;
+            const len = Math.hypot(acc[slot], acc[slot + 1], acc[slot + 2]) || 1;
+            normals[out * 3] = acc[slot] / len;
+            normals[out * 3 + 1] = acc[slot + 1] / len;
+            normals[out * 3 + 2] = acc[slot + 2] / len;
+        });
+        prim.setAttribute('NORMAL', document.createAccessor().setType('VEC3').setArray(normals).setBuffer(buffer));
+    }
+    return { tris: outIdx.length / 3, coherent };
+}
+//# sourceMappingURL=weldedSimplify.js.map

package/dist/character/stages/weldedSimplify.js.map

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

package/dist/character/testutil/syntheticRig.d.ts

@@ -0,0 +1,9 @@
+import { Document } from '@gltf-transform/core';
+/**
+ * Meshy-pathology plane (2*n*n tris): every triangle carries its own 3 vertices (positions duplicated
+ * across faces, up to 6 copies each) and its own UV micro-chart — meshopt seam-locks every vertex, so
+ * attribute-preserving simplify barely moves. weldedSimplify must see through it.
+ */
+export declare function buildShreddedPlane(n?: number): Document;
+/** Dense grid plane (2*n*n tris) for simplify tests. */
+export declare function buildDensePlane(n?: number): Document;

package/dist/character/testutil/syntheticRig.js

@@ -0,0 +1,84 @@
+"use strict";
+// PORTED from helix-web-engine-new/tools/character-pipeline — the source of truth for the character
+// pipeline. SYNC OBLIGATION: fix bugs there first, then mirror the change here; do not diverge.
+// Partial port: only the plane builders the ported tests use (the rig/animation helpers stay in the engine tool).
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildShreddedPlane = buildShreddedPlane;
+exports.buildDensePlane = buildDensePlane;
+const core_1 = require("@gltf-transform/core");
+/**
+ * Meshy-pathology plane (2*n*n tris): every triangle carries its own 3 vertices (positions duplicated
+ * across faces, up to 6 copies each) and its own UV micro-chart — meshopt seam-locks every vertex, so
+ * attribute-preserving simplify barely moves. weldedSimplify must see through it.
+ */
+function buildShreddedPlane(n = 30) {
+    const document = new core_1.Document();
+    const buffer = document.createBuffer();
+    const scene = document.createScene('scene');
+    const verts = [];
+    const uvs = [];
+    const normals = [];
+    const indices = [];
+    const charts = 2 * n * n;
+    const chartCols = Math.ceil(Math.sqrt(charts));
+    let face = 0;
+    const emit = (corners) => {
+        const cu = (face % chartCols) / chartCols;
+        const cv = Math.floor(face / chartCols) / chartCols;
+        for (const [x, y] of corners) {
+            indices.push(verts.length / 3);
+            verts.push(x / n, y / n, 0);
+            uvs.push(cu + (x % 2) / (2 * chartCols), cv + (y % 2) / (2 * chartCols));
+            normals.push(0, 0, 1);
+        }
+        face++;
+    };
+    for (let y = 0; y < n; y++) {
+        for (let x = 0; x < n; x++) {
+            emit([[x, y], [x + 1, y], [x, y + 1]]);
+            emit([[x + 1, y], [x + 1, y + 1], [x, y + 1]]);
+        }
+    }
+    const prim = document
+        .createPrimitive()
+        .setMode(4)
+        .setIndices(document.createAccessor().setType('SCALAR').setArray(new Uint32Array(indices)).setBuffer(buffer))
+        .setAttribute('POSITION', document.createAccessor().setType('VEC3').setArray(new Float32Array(verts)).setBuffer(buffer))
+        .setAttribute('NORMAL', document.createAccessor().setType('VEC3').setArray(new Float32Array(normals)).setBuffer(buffer))
+        .setAttribute('TEXCOORD_0', document.createAccessor().setType('VEC2').setArray(new Float32Array(uvs)).setBuffer(buffer));
+    scene.addChild(document.createNode('plane').setMesh(document.createMesh('plane').addPrimitive(prim)));
+    return document;
+}
+/** Dense grid plane (2*n*n tris) for simplify tests. */
+function buildDensePlane(n = 30) {
+    const document = new core_1.Document();
+    const buffer = document.createBuffer();
+    const scene = document.createScene('scene');
+    const verts = [];
+    const uvs = [];
+    for (let y = 0; y <= n; y++) {
+        for (let x = 0; x <= n; x++) {
+            verts.push(x / n, y / n, 0);
+            uvs.push(x / n, y / n);
+        }
+    }
+    const indices = [];
+    for (let y = 0; y < n; y++) {
+        for (let x = 0; x < n; x++) {
+            const a = y * (n + 1) + x;
+            const b = a + 1;
+            const c = a + n + 1;
+            const d = c + 1;
+            indices.push(a, b, c, b, d, c);
+        }
+    }
+    const prim = document
+        .createPrimitive()
+        .setMode(4)
+        .setIndices(document.createAccessor().setType('SCALAR').setArray(new Uint32Array(indices)).setBuffer(buffer))
+        .setAttribute('POSITION', document.createAccessor().setType('VEC3').setArray(new Float32Array(verts)).setBuffer(buffer))
+        .setAttribute('TEXCOORD_0', document.createAccessor().setType('VEC2').setArray(new Float32Array(uvs)).setBuffer(buffer));
+    scene.addChild(document.createNode('plane').setMesh(document.createMesh('plane').addPrimitive(prim)));
+    return document;
+}
+//# sourceMappingURL=syntheticRig.js.map

package/dist/character/testutil/syntheticRig.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,25 @@
+export type CliCredentials = {
+    apiUrl: string;
+    token: string;
+    expiresAt: string;
+    username: string;
+};
+type HelixEnvName = 'staging' | 'helix3' | 'production';
+export declare function resolveEnvironment(scope: string, override?: {
+    apiUrl?: string;
+    webUrl?: string;
+}): {
+    scope: string;
+    env: HelixEnvName;
+    apiUrl: string;
+    webUrl: string;
+};
+export declare const HELIX_SCOPE: string;
+export declare const HELIX_ENV: HelixEnvName;
+export declare const DEFAULT_API_URL: string;
+export declare const DEFAULT_WEB_URL: string;
+export declare function saveCredentials(creds: CliCredentials): void;
+export declare function loadCredentials(): CliCredentials | null;
+export declare function clearCredentials(): void;
+export declare function jwtExpiresAtIso(token: string): string;
+export {};

package/dist/config.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_WEB_URL = exports.DEFAULT_API_URL = exports.HELIX_ENV = exports.HELIX_SCOPE = void 0;
+exports.resolveEnvironment = resolveEnvironment;
+exports.saveCredentials = saveCredentials;
+exports.loadCredentials = loadCredentials;
+exports.clearCredentials = clearCredentials;
+exports.jwtExpiresAtIso = jwtExpiresAtIso;
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const browserLogin_1 = require("./browserLogin");
+const CONFIG_DIR = (0, node_path_1.join)((0, node_os_1.homedir)(), '.helix');
+const CREDENTIALS_FILE = (0, node_path_1.join)(CONFIG_DIR, 'credentials.json');
+// The npm scope this build was published under selects its default environment:
+// non-prod lanes republish every @helix package under their scope (@helixdev = staging,
+// @helix3 = helix3 — see publish-npm.mjs), production stays @hypersoniclabs. Read from our
+// own package.json `name` (dist/.. at runtime) — a lane tarball carries the rewritten
+// scope; file:-linked local dev reads @hypersoniclabs → production.
+function ownScope() {
+    try {
+        const name = JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(__dirname, '..', 'package.json'), 'utf8')).name;
+        return name?.startsWith('@') ? name.split('/')[0] : '@hypersoniclabs';
+    }
+    catch {
+        return '@hypersoniclabs';
+    }
+}
+const ENVIRONMENTS = {
+    production: { apiUrl: 'https://api.helixgame.com', webUrl: 'https://helixgame.com' },
+    staging: { apiUrl: 'https://helix-backend-staging.up.railway.app', webUrl: 'https://next.helixgame.com' },
+    helix3: { apiUrl: 'https://helix-backend-api-helix3.up.railway.app', webUrl: 'https://new.helixgame.com' },
+};
+const SCOPE_ENVS = { '@helixdev': 'staging', '@helix3': 'helix3' };
+// Pure resolver (testable without the ambient package.json / process.env): the npm scope
+// picks the environment; HELIX_API_URL/HELIX_WEB_URL override. The site is its OWN value —
+// only an API-only override derives it (api.-strip); otherwise the env default applies.
+function resolveEnvironment(scope, override = {}) {
+    const env = SCOPE_ENVS[scope] ?? 'production';
+    const preset = ENVIRONMENTS[env];
+    const apiUrl = override.apiUrl ?? preset.apiUrl;
+    const webUrl = override.webUrl ?? (override.apiUrl ? (0, browserLogin_1.deriveWebUrl)(apiUrl) : preset.webUrl);
+    return { scope, env, apiUrl, webUrl };
+}
+// This build's resolved scope/environment + default API & website URLs. Scope comes from
+// our own package.json name; HELIX_API_URL/HELIX_WEB_URL override per run.
+const RESOLVED = resolveEnvironment(ownScope(), {
+    apiUrl: process.env.HELIX_API_URL,
+    webUrl: process.env.HELIX_WEB_URL,
+});
+exports.HELIX_SCOPE = RESOLVED.scope;
+exports.HELIX_ENV = RESOLVED.env;
+exports.DEFAULT_API_URL = RESOLVED.apiUrl;
+exports.DEFAULT_WEB_URL = RESOLVED.webUrl;
+function saveCredentials(creds) {
+    (0, node_fs_1.mkdirSync)(CONFIG_DIR, { recursive: true });
+    (0, node_fs_1.writeFileSync)(CREDENTIALS_FILE, JSON.stringify(creds, null, 2), {
+        mode: 0o600,
+    });
+    try {
+        (0, node_fs_1.chmodSync)(CREDENTIALS_FILE, 0o600);
+    }
+    catch {
+        // Windows: mode bits are advisory; the file lives under the user profile.
+    }
+}
+function loadCredentials() {
+    try {
+        const creds = JSON.parse((0, node_fs_1.readFileSync)(CREDENTIALS_FILE, 'utf8'));
+        if (creds.expiresAt && new Date(creds.expiresAt).getTime() < Date.now()) {
+            return null;
+        }
+        return creds;
+    }
+    catch {
+        return null;
+    }
+}
+function clearCredentials() {
+    try {
+        (0, node_fs_1.writeFileSync)(CREDENTIALS_FILE, '{}', { mode: 0o600 });
+    }
+    catch {
+        // nothing stored — already logged out.
+    }
+}
+// Reads the `exp` (seconds) claim from a JWT without verifying its signature —
+// just to surface a friendly expiry to the user and to expire the stored
+// credentials locally. Returns '' if the token is not a decodable JWT.
+function jwtExpiresAtIso(token) {
+    try {
+        const payload = token.split('.')[1];
+        if (!payload)
+            return '';
+        const json = Buffer.from(payload, 'base64url').toString('utf8');
+        const exp = JSON.parse(json).exp;
+        return typeof exp === 'number' ? new Date(exp * 1000).toISOString() : '';
+    }
+    catch {
+        return '';
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};