@helix3/helix-cli 0.1.18-helix3.276 → 0.1.18-helix3.278

package/dist/addOnPackageVersion.d.ts

@@ -0,0 +1,47 @@
+import type { CliCredentials } from './config';
+export type PackagePin = {
+    packageId: string;
+    version: string;
+    manifestCid: string;
+};
+export type PublishAddOnPackageVersionOptions = {
+    reason: string;
+    notes?: string;
+    expectedCurrentVersionId?: string;
+    updateId?: string;
+    /** Bounded wait for the uploaded mesh to clear verify/optimize and reach `ready`. */
+    assetReadyTimeoutMs?: number;
+    onProgress?: (message: string) => void;
+};
+export type PublishAddOnPackageVersionResult = {
+    itemId: string;
+    revision: number;
+    packagePin: PackagePin;
+    previousRevision: number;
+    previousPackagePin: PackagePin;
+    updateId?: string;
+    [key: string]: unknown;
+};
+/**
+ * Ship a corrected mesh onto an ALREADY-PUBLISHED character add-on, in place:
+ * same item id, same owner, same serial, same listings and distributions —
+ * every existing owner picks up the new geometry at their next spawn/session
+ * start. Two backend steps, in sequence:
+ *
+ *   1. The ordinary asset door: `POST :id/assets` (presign) → PUT the bytes →
+ *      `POST :id/assets/:assetId/finalize` — the exact verify/optimize
+ *      pipeline `helix item publish` runs on a brand-new item. This function
+ *      polls the asset's status afterward, because finalize only STARTS that
+ *      pipeline; it does not wait for it.
+ *   2. `POST :id/add-on-package/versions` — seals that now-Ready GLB as a new
+ *      Version of the item's own Continuum Package and moves the item's
+ *      pointer through the platform's real, audited, revision-checked
+ *      version-update path (the same one Skylark/Ocean Drive republish
+ *      through). Refused (409) if the new geometry breaks the compatibility
+ *      contract (slot removed, contract changed, …) — that is not a bug in
+ *      this command, it means the change is not a valid update to this item.
+ *
+ * There is no local dry-run: everything here is a server-verified round trip,
+ * same as `helix item publish`.
+ */
+export declare function publishAddOnPackageVersion(itemId: string, file: string, options: PublishAddOnPackageVersionOptions, credentials: CliCredentials): Promise<PublishAddOnPackageVersionResult>;

package/dist/addOnPackageVersion.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.publishAddOnPackageVersion = publishAddOnPackageVersion;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const api_1 = require("./api");
+const item_1 = require("./item");
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+const MAX_ADDON_WEB_GLB_BYTES = 64 * 1024 * 1024; // mirrors the backend's own ceiling for this lane
+const DEFAULT_ASSET_READY_TIMEOUT_MS = 180_000;
+const ASSET_POLL_INTERVAL_MS = 2_000;
+/**
+ * Ship a corrected mesh onto an ALREADY-PUBLISHED character add-on, in place:
+ * same item id, same owner, same serial, same listings and distributions —
+ * every existing owner picks up the new geometry at their next spawn/session
+ * start. Two backend steps, in sequence:
+ *
+ *   1. The ordinary asset door: `POST :id/assets` (presign) → PUT the bytes →
+ *      `POST :id/assets/:assetId/finalize` — the exact verify/optimize
+ *      pipeline `helix item publish` runs on a brand-new item. This function
+ *      polls the asset's status afterward, because finalize only STARTS that
+ *      pipeline; it does not wait for it.
+ *   2. `POST :id/add-on-package/versions` — seals that now-Ready GLB as a new
+ *      Version of the item's own Continuum Package and moves the item's
+ *      pointer through the platform's real, audited, revision-checked
+ *      version-update path (the same one Skylark/Ocean Drive republish
+ *      through). Refused (409) if the new geometry breaks the compatibility
+ *      contract (slot removed, contract changed, …) — that is not a bug in
+ *      this command, it means the change is not a valid update to this item.
+ *
+ * There is no local dry-run: everything here is a server-verified round trip,
+ * same as `helix item publish`.
+ */
+async function publishAddOnPackageVersion(itemId, file, options, credentials) {
+    if (!UUID_RE.test(itemId))
+        throw new Error('Item ID must be a UUID.');
+    const reason = options.reason?.trim() ?? '';
+    if (!reason || reason.length > 500) {
+        throw new Error('--reason is required (1-500 characters) and lands in the audit ledger.');
+    }
+    const bytes = await (0, promises_1.readFile)(file);
+    (0, item_1.assertLooksLikeGlb)(bytes, file);
+    if (bytes.length > MAX_ADDON_WEB_GLB_BYTES) {
+        throw new Error(`"${file}" is ${(bytes.length / (1024 * 1024)).toFixed(1)} MiB; an add-on's web GLB must be at most ${MAX_ADDON_WEB_GLB_BYTES / (1024 * 1024)} MiB.`);
+    }
+    const progress = options.onProgress ?? (() => { });
+    const api = api_1.HelixApi.forCredentials(credentials);
+    const filename = (0, node_path_1.basename)(file);
+    const mimeType = 'model/gltf-binary';
+    progress('Requesting a presigned upload for the corrected mesh…');
+    const presign = await api.requestItem('POST', `/api/v1/universal-items/${itemId}/assets`, {
+        rendition: 'web',
+        filename,
+        mimeType,
+        sizeBytes: bytes.length,
+    });
+    if (!presign.uploadUrl)
+        throw new Error('Server did not return an upload URL for the web asset.');
+    progress('Uploading the mesh…');
+    await (0, api_1.uploadToTicket)(presign.uploadUrl, Buffer.from(bytes), mimeType);
+    progress('Finalizing the upload (verify → optimize → thumbnail)…');
+    await api.requestItem('POST', `/api/v1/universal-items/${itemId}/assets/${presign.id}/finalize`, { sizeBytes: bytes.length });
+    progress('Waiting for the pipeline to mark the mesh ready…');
+    const ready = await waitForAssetReady(api, itemId, presign.id, options.assetReadyTimeoutMs ?? DEFAULT_ASSET_READY_TIMEOUT_MS);
+    if (ready.status !== 'ready') {
+        throw new Error(`Upload finished but the pipeline left it "${ready.status}", not "ready" — it will not be sealed into a new Package Version. Check the item's assets for the rejection reason.`);
+    }
+    progress('Sealing the new Package Version and publishing it to every owner…');
+    const body = { reason };
+    if (options.notes !== undefined)
+        body.notes = options.notes;
+    if (options.expectedCurrentVersionId !== undefined)
+        body.expectedCurrentVersionId = options.expectedCurrentVersionId;
+    if (options.updateId !== undefined)
+        body.updateId = options.updateId;
+    return api.request('POST', `/api/v1/universal-items/${itemId}/add-on-package/versions`, body);
+}
+async function waitForAssetReady(api, itemId, assetId, timeoutMs) {
+    const deadline = Date.now() + timeoutMs;
+    for (;;) {
+        const assets = await api.request('GET', `/api/v1/universal-items/${itemId}/assets`);
+        const row = assets.find((a) => a.id === assetId);
+        if (!row)
+            throw new Error(`Asset ${assetId} disappeared from ${itemId}'s asset list.`);
+        if (row.status === 'ready' || row.status === 'rejected' || row.status === 'failed')
+            return row;
+        if (Date.now() >= deadline) {
+            throw new Error(`Timed out after ${Math.round(timeoutMs / 1000)}s waiting for asset ${assetId} to leave "${row.status}".`);
+        }
+        await new Promise((resolve) => setTimeout(resolve, ASSET_POLL_INTERVAL_MS));
+    }
+}
+//# sourceMappingURL=addOnPackageVersion.js.map

package/dist/addOnPackageVersion.js.map

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

package/dist/index.js

@@ -39,6 +39,7 @@ const commands_1 = require("./sceneHlod/commands");
 const placementRequest_1 = require("./placementRequest");
 const bundle_1 = require("./bundle");
 const avatarMeshReplacement_1 = require("./avatarMeshReplacement");
+const addOnPackageVersion_1 = require("./addOnPackageVersion");
 const node_child_process_1 = require("node:child_process");
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
@@ -1207,6 +1208,49 @@ item
         fail(error instanceof lib_1.ApiError ? error.render() : String(error));
     }
 });
+// Ship a fix to an already-published item WITHOUT churning it onto a new id:
+// same item, same owner, same serial, same listings/distributions, every
+// existing owner picks up the new geometry at their next spawn. Character
+// add-ons only today — the backend's `add-on-package/versions` lane exists
+// because an add-on's Continuum Package is built FROM the item's own uploaded
+// mesh, unlike a vehicle or Scene Package, which are authored and sealed
+// independently and update through the generic (not-yet-CLI-exposed)
+// `POST :itemId/versions`. `helix item delist` is the OTHER lane here and does
+// something different: it takes an item off browse/marketplace for good,
+// rather than shipping owners an update.
+item
+    .command('publish-version')
+    .description('Ship a corrected mesh onto an already-published character add-on, IN PLACE — new Package Version, same item id/owner/listings; every existing owner gets it next spawn')
+    .argument('<item-id>', 'existing, already-published character add-on item UUID')
+    .argument('<file>', 'corrected mesh (binary glTF, .glb)')
+    .requiredOption('--reason <text>', 'required, lands in the audit ledger (e.g. "fixed poke-through on the left cuff")')
+    .option('--notes <text>', 'optional creator-facing changelog note')
+    .option('--expected-current-version-id <uuid>', 'refuse if the item has moved off this Package Version since you last read it')
+    .option('--update-id <uuid>', 'idempotency key — retrying with the same id never double-publishes')
+    .option('--json', 'machine-readable output')
+    .action(async (itemId, file, opts) => {
+    const creds = requireAuth();
+    try {
+        const result = await (0, addOnPackageVersion_1.publishAddOnPackageVersion)(itemId, (0, node_path_1.resolve)(file), {
+            reason: opts.reason,
+            notes: opts.notes,
+            expectedCurrentVersionId: opts.expectedCurrentVersionId,
+            updateId: opts.updateId,
+            onProgress: (message) => !opts.json && console.log(message),
+        }, creds);
+        if (opts.json) {
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        console.log(`✔ Published a new Version of ${itemId} — revision ${result.previousRevision} → ${result.revision}`);
+        console.log(`  package: ${result.packagePin.packageId}@${result.packagePin.version}`);
+        console.log(`  previous: ${result.previousPackagePin.packageId}@${result.previousPackagePin.version}`);
+        console.log('  same item id, same owner(s); existing owners see the change at their next spawn/session start.');
+    }
+    catch (error) {
+        fail(error instanceof lib_1.ApiError ? error.render() : `✖ ${error instanceof Error ? error.message : String(error)}`);
+    }
+});
 // One command prints the whole Character-Creator vocabulary a wearable must
 // declare — the 34 slot tags AND the two genders. There is no `list-genders`:
 // a dedicated command for a closed two-value list is a command to discover, to
@@ -1214,14 +1258,14 @@ item
 // list it is always read with. `--gender`'s own help carries the same values.
 item
     .command('search')
-    .description("Search the published MARKETPLACE catalogue — including Looks (user-facing name for a `build`: a free, never-owned preset), the dressed presets someone already assembled. A Look is never owned itself; its parts are acquired individually from their own listings")
+    .description("Search the published MARKETPLACE catalogue — including Presets (user-facing name for a `build`: a free, never-owned preset), the dressed presets someone already assembled. A Preset is never owned itself; its parts are acquired individually from their own listings")
     .argument('[query]', 'free text over title, slug and tags')
     .option('--kind <kind>', 'universal item kind (avatar, wearable, vehicle, weapon, add_on, home_item, emote, prop)')
     .option('--category <category>', 'marketplace category')
     .option('--sub-category <subCategory>', 'form factor beneath the category, e.g. car / rifle / art')
     .option('--tag <tag>', 'exact tag')
     .option('--host-kind <hostKind>', 'host class, e.g. vehicle / character / weapon')
-    .option('--builds <mode>', `Looks (API identifier: builds) in the results: ${itemSearch_1.BUILD_FILTER_MODES.join(' | ')} (default include — a Look is filed under its base's own category, so it comes back alongside bases unless you narrow)`)
+    .option('--builds <mode>', `Presets (API identifier: builds) in the results: ${itemSearch_1.BUILD_FILTER_MODES.join(' | ')} (default include — a Preset is filed under its base's own category, so it comes back alongside bases unless you narrow)`)
     .option('--limit <n>', 'rows to return (1-100, default 20)')
     .option('--json', 'machine-readable output')
     .action(async (query, opts) => {
@@ -1247,10 +1291,10 @@ item
             return;
         }
         for (const row of result.items) {
-            // The Look mark leads the line (`buildKind` is the field's API name;
-            // "Look" is what a human reads). A Look is filed under its base's
+            // The Preset mark leads the line (`buildKind` is the field's API name;
+            // "Preset" is what a human reads). A Preset is filed under its base's
             // own kind, so without it these rows are indistinguishable from the
-            // bases they were assembled from — which is the whole reason Looks
+            // bases they were assembled from — which is the whole reason Presets
             // do not get a category of their own.
             const mark = row.buildKind ? `[look:${row.buildKind}] ` : '';
             const price = row.priceLix === null ? 'unlisted' : `Ⱡ${row.priceLix}`;
@@ -1267,7 +1311,7 @@ item
 });
 item
     .command('build')
-    .description("What is in a published Look (API identifier: build): its base, its add-on parts, what you own, and what the parts cost together. A Look is never owned itself — only its parts are, each bought or held from its own listing")
+    .description("What is in a published Preset (API identifier: build): its base, its add-on parts, what you own, and what the parts cost together. A Preset is never owned itself — only its parts are, each bought or held from its own listing")
     .argument('<itemId>', 'universal item id of the build')
     .option('--json', 'machine-readable output')
     .action(async (itemId, opts) => {
@@ -2179,16 +2223,16 @@ product
 });
 // --- helix vault -------------------------------------------------------------
 // The Continuum Vault catalog (`GET /api/v1/vault/catalog`) — the table that
-// backs the website's Vault page and actually lists Looks (build Packages),
+// backs the website's Vault page and actually lists Presets (build Packages),
 // characters, vehicles, weapons, devices, and every other sealed Continuum
 // Package. Distinct from `helix assets search`, which hits the LEGACY
-// `/api/v1/vault/assets` table and has no Looks and never will.
+// `/api/v1/vault/assets` table and has no Presets and never will.
 const vault = program
     .command('vault')
-    .description('Discover sealed Continuum Packages — including Looks — through the public Vault catalog');
+    .description('Discover sealed Continuum Packages — including Presets — through the public Vault catalog');
 vault
     .command('search')
-    .description('Search the Continuum Vault catalog. Finds Looks (pass --package-type look) and every other sealed, listed Continuum Package. Public — no login required')
+    .description('Search the Continuum Vault catalog. Finds Presets (pass --package-type look) and every other sealed, listed Continuum Package. Public — no login required')
     .argument('[query]', 'free-text search over title and tags')
     .option('--package-type <type>', `filter by Continuum Package type. "look" is accepted as an alias for "build" (${vault_1.VAULT_CATALOG_PACKAGE_TYPE_INPUTS.join(', ')})`)
     .option('--sort <mode>', 'recent or name')
@@ -2214,19 +2258,19 @@ vault
     }
 });
 // --- helix look --------------------------------------------------------------
-// A Look is a Universal Item pinned to a Continuum Package of type `build`: a
+// A Preset is a Universal Item pinned to a Continuum Package of type `build`: a
 // free, never-owned preset — a base plus the exact add-ons installed on it.
 // Its parts are still owned and acquired individually from their own listings;
-// applying a Look never grants, buys, or moves anything the caller does not
+// applying a Preset never grants, buys, or moves anything the caller does not
 // already own. Contract: run/open-alpha-qa/looks/phase2-contract.txt (items 4
 // and 6) in the workspace root.
 const look = program
     .command('look')
-    .description('Read and save Looks — dressed-character presets (API identifier: build)');
+    .description('Read and save Presets — dressed-character presets (API identifier: build)');
 look
     .command('get')
-    .description('The dressed character behind one Look in a single public call: base model plus every add-on, with pinned Packages, model URLs/CIDs, and fit data — enough to render it')
-    .argument('<ref>', 'Look item id, or packageId@version (an @ splits packageId from an explicit version; without one, the value is read as an item id)')
+    .description('The dressed character behind one Preset in a single public call: base model plus every add-on, with pinned Packages, model URLs/CIDs, and fit data — enough to render it')
+    .argument('<ref>', 'Preset item id, or packageId@version (an @ splits packageId from an explicit version; without one, the value is read as an item id)')
     .option('--json', 'machine-readable output')
     .action(async (ref, opts) => {
     const creds = (0, config_1.loadCredentials)();
@@ -2255,12 +2299,12 @@ look
 });
 look
     .command('save')
-    .description("Freeze an inventory instance's current composition into a Look. Never charges a publish fee, never grants a copy of any part, never creates a distribution — it publishes the recipe, not the parts")
+    .description("Freeze an inventory instance's current composition into a Preset. Never charges a publish fee, never grants a copy of any part, never creates a distribution — it publishes the recipe, not the parts")
     .argument('<inventory-item-id>', 'inventory instance to freeze')
-    .requiredOption('--title <title>', 'Look title (1-80 chars)')
-    .option('--description <text>', 'Look description (<=500 chars)')
+    .requiredOption('--title <title>', 'Preset title (1-80 chars)')
+    .option('--description <text>', 'Preset description (<=500 chars)')
     .option('--public', 'publish publicly (sealed public Package + Vault + Marketplace listings); default is private')
-    .option('--look <lookItemId>', 'an existing Look you created — advances it to a new version instead of creating a new one')
+    .option('--look <lookItemId>', 'an existing Preset you created — advances it to a new version instead of creating a new one')
     .option('--json', 'machine-readable output')
     .action(async (inventoryItemId, opts) => {
     const creds = requireAuth();
@@ -2273,7 +2317,7 @@ look
         });
         if (opts.json)
             return printJson(result);
-        console.log(`✔ ${result.created ? 'Saved' : 'Updated'} Look ${result.lookItemId} (${result.visibility})`);
+        console.log(`✔ ${result.created ? 'Saved' : 'Updated'} Preset ${result.lookItemId} (${result.visibility})`);
         console.log(`  package: ${result.package.packageId}@${result.package.version}`);
         if (result.vaultListingId)
             console.log(`  vault listing: ${result.vaultListingId}`);