@hypersoniclabs/helix-cli 0.1.7 → 0.1.24-helix3.438

package/dist/itemDef/tables.js.map

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

package/dist/itemDef/validate.d.ts

@@ -0,0 +1,30 @@
+import { type ItemDefVaultRef } from './gunConfigRules';
+export type ItemDefValidation = {
+    errors: string[];
+    warnings: string[];
+    descriptor: Record<string, unknown> | null;
+    /** Relative refs resolved against the descriptor's directory, in play order: mesh/clip first (when relative), then sounds. */
+    relativeRefs: {
+        ref: string;
+        file: string;
+    }[];
+    meshRef: string | ItemDefVaultRef | null;
+    /** An emote's `emote.clip` as authored; null on every weapon descriptor. */
+    clipRef: string | ItemDefVaultRef | null;
+    /** A PAIRED emote's `emote.roles.joiner.clip` as authored; null on a solo emote and on every weapon. */
+    joinerClipRef: string | ItemDefVaultRef | null;
+    /** An emote's `emote.intro` / `emote.outro` as authored; null when it declares none, and on every weapon. */
+    introClipRef: string | ItemDefVaultRef | null;
+    outroClipRef: string | ItemDefVaultRef | null;
+    /** A PAIRED emote's authored `emote.roles.offerAtS`; null when absent (the first frame) or unusable. */
+    offerAtS: number | null;
+    /** Measured duration of the INITIATOR clip, seconds — null when it is a pinned ref or the GLB does not say. */
+    clipDurationS: number | null;
+    /** Measured durations of the transition clips, on the same terms — what the one-shot chain cap is summed from. */
+    introDurationS: number | null;
+    outroDurationS: number | null;
+};
+/** The descriptor as publish will shape it: every relative string in `assets.*` (and every emote clip) swapped for a pinned-ref stand-in. */
+export declare function toPublishShape(descriptor: Record<string, unknown>): Record<string, unknown>;
+export declare function validateItemDefDescriptor(parsed: unknown, baseDir: string): ItemDefValidation;
+export declare function validateItemDefFile(file: string): ItemDefValidation;

package/dist/itemDef/validate.js

@@ -0,0 +1,175 @@
+"use strict";
+// `helix item-def validate` — the manifest authority validator + the vendored engine rules for the
+// descriptor's TYPE (gun-config for a weapon, the emote rules + clip duration caps for an emote, both clips
+// of a paired one) + referenced-file existence + the mesh precheck, all offline.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toPublishShape = toPublishShape;
+exports.validateItemDefDescriptor = validateItemDefDescriptor;
+exports.validateItemDefFile = validateItemDefFile;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const helix_manifest_1 = require("@hypersoniclabs/helix-manifest");
+const emoteRules_1 = require("./emoteRules");
+const gunConfigRules_1 = require("./gunConfigRules");
+const scaffold_1 = require("./scaffold");
+const emptyValidation = (errors) => ({
+    errors,
+    warnings: [],
+    descriptor: null,
+    relativeRefs: [],
+    meshRef: null,
+    clipRef: null,
+    joinerClipRef: null,
+    introClipRef: null,
+    outroClipRef: null,
+    offerAtS: null,
+    clipDurationS: null,
+    introDurationS: null,
+    outroDurationS: null,
+});
+/** A placeholder pinned ref standing in for a pre-publish relative path, so the manifest schema
+ *  (which requires {assetId, version, checksumSha256} triples) can validate the eventual published shape. */
+const placeholderRef = (path) => ({
+    assetId: `local:${path}`.slice(0, 128),
+    version: 1,
+    checksumSha256: '0'.repeat(64),
+});
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+/** The descriptor as publish will shape it: every relative string in `assets.*` (and every emote clip) swapped for a pinned-ref stand-in. */
+function toPublishShape(descriptor) {
+    const clone = structuredClone(descriptor);
+    const assets = clone.assets;
+    if (isRecord(assets)) {
+        for (const key of ['meshes', 'audio', 'clips']) {
+            const list = assets[key];
+            if (!Array.isArray(list))
+                continue;
+            assets[key] = list.map((entry) => (typeof entry === 'string' ? placeholderRef(entry) : entry));
+        }
+    }
+    const emote = clone.emote;
+    if (isRecord(emote)) {
+        if (typeof emote.clip === 'string')
+            emote.clip = placeholderRef(emote.clip);
+        for (const key of ['intro', 'outro']) {
+            if (typeof emote[key] === 'string')
+                emote[key] = placeholderRef(emote[key]);
+        }
+        const joiner = isRecord(emote.roles) ? emote.roles.joiner : undefined;
+        if (isRecord(joiner) && typeof joiner.clip === 'string')
+            joiner.clip = placeholderRef(joiner.clip);
+    }
+    return clone;
+}
+function validateItemDefDescriptor(parsed, baseDir) {
+    const out = emptyValidation([]);
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+        out.errors.push('descriptor: must be a JSON object');
+        return out;
+    }
+    const descriptor = parsed;
+    out.descriptor = descriptor;
+    // 1. The manifest authority validator, over the publish shape (relative paths → placeholder pins).
+    const manifest = (0, helix_manifest_1.validateInteractiveItemDescriptor)(toPublishShape(descriptor));
+    if (manifest.valid)
+        out.warnings.push(...manifest.warnings);
+    else
+        out.errors.push(...manifest.errors);
+    // 2. Every relative ref must exist next to the descriptor.
+    const track = (ref) => {
+        const file = (0, node_path_1.resolve)((0, node_path_1.join)(baseDir, ref));
+        out.relativeRefs.push({ ref, file });
+        if (!(0, node_fs_1.existsSync)(file))
+            out.errors.push(`referenced file not found: ${ref} (expected at ${file})`);
+    };
+    // 3. The lane rules for the descriptor's TYPE — the block set decides which one applies.
+    if ((0, emoteRules_1.isEmoteDescriptor)(descriptor)) {
+        const emote = (0, emoteRules_1.checkEmoteRules)(descriptor);
+        out.errors.push(...emote.errors);
+        out.warnings.push(...emote.warnings);
+        out.clipRef = emote.clipRef;
+        out.joinerClipRef = emote.joinerClipRef;
+        out.introClipRef = emote.introClipRef;
+        out.outroClipRef = emote.outroClipRef;
+        out.offerAtS = emote.offerAtS;
+        if (typeof emote.clipRef === 'string')
+            track(emote.clipRef);
+        if (typeof emote.joinerClipRef === 'string')
+            track(emote.joinerClipRef);
+        if (typeof emote.introClipRef === 'string')
+            track(emote.introClipRef);
+        if (typeof emote.outroClipRef === 'string')
+            track(emote.outroClipRef);
+        for (const ref of emote.relativeAudioRefs)
+            track(ref);
+        // The duration caps need the clip BYTES, which is why they live in this lane and not in the manifest. A
+        // PAIRED emote's two clips are held to the SAME playback: a oneshot pair whose joiner runs long never ends.
+        for (const ref of [emote.clipRef, emote.joinerClipRef]) {
+            if (typeof ref !== 'string')
+                continue;
+            const clipFile = (0, node_path_1.resolve)((0, node_path_1.join)(baseDir, ref));
+            if (!(0, node_fs_1.existsSync)(clipFile))
+                continue;
+            const measured = (0, emoteRules_1.measureEmoteClip)((0, node_fs_1.readFileSync)(clipFile), ref);
+            out.errors.push(...measured.errors);
+            out.warnings.push(...measured.warnings);
+            if (measured.durationS !== null)
+                out.errors.push(...(0, emoteRules_1.checkEmoteClipDuration)(measured.durationS, emote.playback, ref));
+            if (ref !== emote.clipRef)
+                continue;
+            out.clipDurationS = measured.durationS;
+            // The offer instant is only checkable against the INITIATOR's measured clip — the manifest never sees it.
+            if (measured.durationS !== null && emote.offerAtS !== null)
+                out.errors.push(...(0, emoteRules_1.checkEmoteOfferAt)(emote.offerAtS, measured.durationS, ref));
+        }
+        // The transitions carry their own ceilings, and on a oneshot the WHOLE chain owes the one-shot cap.
+        for (const [key, ref] of [['intro', emote.introClipRef], ['outro', emote.outroClipRef]]) {
+            if (typeof ref !== 'string')
+                continue;
+            const clipFile = (0, node_path_1.resolve)((0, node_path_1.join)(baseDir, ref));
+            if (!(0, node_fs_1.existsSync)(clipFile))
+                continue;
+            const measured = (0, emoteRules_1.measureEmoteClip)((0, node_fs_1.readFileSync)(clipFile), ref);
+            out.errors.push(...measured.errors);
+            out.warnings.push(...measured.warnings);
+            if (key === 'intro')
+                out.introDurationS = measured.durationS;
+            else
+                out.outroDurationS = measured.durationS;
+        }
+        out.errors.push(...(0, emoteRules_1.checkEmoteChainDuration)(out.introDurationS, out.clipDurationS, out.outroDurationS, emote.playback));
+    }
+    else {
+        const gun = (0, gunConfigRules_1.checkGunConfigRules)(descriptor);
+        out.errors.push(...gun.errors);
+        out.warnings.push(...gun.warnings);
+        out.meshRef = gun.meshRef;
+        if (typeof gun.meshRef === 'string')
+            track(gun.meshRef);
+        for (const ref of gun.relativeSoundRefs)
+            track(ref);
+        // The mesh precheck (WARN only — the caps are the server's).
+        if (typeof gun.meshRef === 'string') {
+            const meshFile = (0, node_path_1.resolve)((0, node_path_1.join)(baseDir, gun.meshRef));
+            if ((0, node_fs_1.existsSync)(meshFile))
+                out.warnings.push(...(0, scaffold_1.meshPrecheck)((0, node_fs_1.readFileSync)(meshFile), gun.meshRef).warnings);
+        }
+    }
+    out.errors = [...new Set(out.errors)];
+    out.warnings = [...new Set(out.warnings)];
+    return out;
+}
+function validateItemDefFile(file) {
+    const path = (0, node_path_1.resolve)(file);
+    if (!(0, node_fs_1.existsSync)(path))
+        return emptyValidation([`descriptor not found: ${path}`]);
+    let parsed;
+    try {
+        parsed = JSON.parse((0, node_fs_1.readFileSync)(path, 'utf8'));
+    }
+    catch (err) {
+        return emptyValidation([`descriptor: invalid JSON — ${err instanceof Error ? err.message : String(err)}`]);
+    }
+    return validateItemDefDescriptor(parsed, (0, node_path_1.dirname)(path));
+}
+//# sourceMappingURL=validate.js.map

package/dist/itemDef/validate.js.map

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

package/dist/itemPublishVersion.d.ts

@@ -0,0 +1,46 @@
+import { type ContinuumCid, type ContinuumPackageVersion } from '@hypersoniclabs/helix-manifest';
+import { ApiError } from './api';
+import type { CliCredentials } from './config';
+import { type SetItemVersionResult } from './itemSetVersion';
+export type PublishItemVersionOptions = {
+    reason: string;
+    notes?: string;
+    expectedCurrentVersionId?: string;
+    updateId?: string;
+    onProgress?: (message: string) => void;
+};
+export type PublishItemVersionResult = {
+    itemId: string;
+    packageId: string;
+    /** The Version just sealed (e.g. 1.0.6). */
+    version: string;
+    previousVersion: string;
+    manifestCid: string;
+    /** Set when the move committed (an unlisted/exempt item). Null when the visual-QA gate refused it (listed item). */
+    move: SetItemVersionResult | null;
+    /** The 422 the gate answered when `move` is null — render with `renderSetVersionError`. */
+    refusal?: ApiError;
+};
+/** `1.0.5` -> `1.0.6`. Version names are `x.y.z` on the wire; anything else is refused rather than guessed. */
+export declare function bumpVersionPatch(version: string): string;
+/** The web GLB object this Package Version resolves (the root for a prop/avatar, else the first GLB variant). */
+export declare function webGlbObjectOf(manifest: Pick<ContinuumPackageVersion, 'root' | 'variants'>): {
+    cid: ContinuumCid;
+    bytes: number;
+} | null;
+/** Replace the old GLB cid (and byte count) with the new one, everywhere it appears in a definition document. */
+export declare function replaceCidDeep(value: unknown, oldCid: string, newCid: string, newBytes: number): void;
+/** Re-serialize an add-on definition that now names the new GLB; the result is uploaded as a fresh root object. */
+export declare function updateDefinitionRendition(definitionBytes: Uint8Array, oldGlbCid: string, newGlbCid: string, newGlbBytes: number): Uint8Array;
+/** The closure this manifest actually names: root + source + variant objects, deduplicated by cid. */
+export declare function recomputeExpectedClosure(manifest: Pick<ContinuumPackageVersion, 'root' | 'source' | 'variants'>): {
+    objectCount: number;
+    totalBytes: number;
+};
+/**
+ * Ship a corrected mesh onto an ALREADY-PUBLISHED GLB add-on / prop / avatar, in place: seal a new Version of the
+ * item's own Continuum Package, then move the item pointer through `POST :id/versions`. On a listed item the move is
+ * refused by the visual-QA gate (422) — the seal stays behind and the caller gets the refusal to render, which names
+ * the two finishing steps (`item visual-qa --package-version vN --submit`, then `item set-version`).
+ */
+export declare function publishItemVersion(itemId: string, file: string, options: PublishItemVersionOptions, credentials: CliCredentials): Promise<PublishItemVersionResult>;

package/dist/itemPublishVersion.js

@@ -0,0 +1,242 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bumpVersionPatch = bumpVersionPatch;
+exports.webGlbObjectOf = webGlbObjectOf;
+exports.replaceCidDeep = replaceCidDeep;
+exports.updateDefinitionRendition = updateDefinitionRendition;
+exports.recomputeExpectedClosure = recomputeExpectedClosure;
+exports.publishItemVersion = publishItemVersion;
+// `helix item publish-version <item-id> <file> --reason <text>`: ship a corrected mesh onto an already-published
+// GLB add-on / prop / avatar item, IN PLACE — a new sealed Package Version, same item id, same owner, same listings
+// and distributions, so every existing owner picks up the new geometry at their next spawn/session start.
+//
+// This is step 1 of the version-move flow (src/visualQa/moveUx.ts `VERSION_MOVE_FLOW_HELP`):
+//
+//   1. `item publish-version <id> <file>`  seals vN (staged) and attempts the move; on a listed item the move is
+//      refused by the visual-QA gate, which is expected — it says so and names the next two steps;
+//   2. `item visual-qa <id> --package-version vN --submit`  renders the candidate version and records the pass;
+//   3. `item set-version <id> --package-version vN --reason …`  moves the item once step 2 passed.
+//
+// The character add-on lane that used to do this (`POST :id/add-on-package/versions`) is retired. The generic path
+// a vehicle or Scene Package always used applies to every GLB item now: seal a new Version of the item's OWN
+// Continuum Package from a new GLB (the same `continuum publish-package --stage` machinery the 993/Subaru lanes
+// drive through `asset-lab/porsche-911-993/addons/tools/publish_revision.mjs`), then move the item pointer through
+// the ONE audited, revision-checked write every item update goes through (`POST :id/versions`).
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const node_buffer_1 = require("node:buffer");
+const helix_manifest_1 = require("@hypersoniclabs/helix-manifest");
+const api_1 = require("./api");
+const item_1 = require("./item");
+const client_1 = require("./continuum/client");
+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 GLB_MEDIA_TYPE = 'model/gltf-binary';
+/** A web GLB larger than this is not an add-on/prop update; refuse instead of buffering it. */
+const MAX_GLB_BYTES = 64 * 1024 * 1024;
+/** Package Version names this lane will step through before giving up on a collision. */
+const MAX_VERSION_STEPS = 8;
+function lifecycleOf(value) {
+    const unwrapped = value && typeof value === 'object' && 'item' in value && value.item
+        ? value.item
+        : value;
+    if (!unwrapped || typeof unwrapped !== 'object')
+        return undefined;
+    const lifecycle = unwrapped.lifecycle;
+    return lifecycle === 'draft' || lifecycle === 'sealed' || lifecycle === 'superseded' || lifecycle === 'revoked'
+        ? lifecycle
+        : undefined;
+}
+/** `1.0.5` -> `1.0.6`. Version names are `x.y.z` on the wire; anything else is refused rather than guessed. */
+function bumpVersionPatch(version) {
+    const match = /^(\d+)\.(\d+)\.(\d+)$/.exec(version);
+    if (!match)
+        throw new Error(`unexpected Package Version "${version}" (expected x.y.z)`);
+    return `${match[1]}.${match[2]}.${Number(match[3]) + 1}`;
+}
+/** The web GLB object this Package Version resolves (the root for a prop/avatar, else the first GLB variant). */
+function webGlbObjectOf(manifest) {
+    if (manifest.root.mediaType === GLB_MEDIA_TYPE) {
+        return { cid: (0, helix_manifest_1.normalizeContinuumCid)(manifest.root.cid), bytes: manifest.root.bytes };
+    }
+    for (const variant of manifest.variants) {
+        if (variant.object.mediaType === GLB_MEDIA_TYPE) {
+            return { cid: (0, helix_manifest_1.normalizeContinuumCid)(variant.object.cid), bytes: variant.object.bytes };
+        }
+    }
+    return null;
+}
+/** Replace the old GLB cid (and byte count) with the new one, everywhere it appears in a definition document. */
+function replaceCidDeep(value, oldCid, newCid, newBytes) {
+    if (Array.isArray(value)) {
+        for (const entry of value)
+            replaceCidDeep(entry, oldCid, newCid, newBytes);
+        return;
+    }
+    if (value && typeof value === 'object') {
+        const record = value;
+        if (typeof record.cid === 'string' && (0, helix_manifest_1.normalizeContinuumCid)(record.cid) === oldCid) {
+            record.cid = newCid;
+            if (typeof record.bytes === 'number')
+                record.bytes = newBytes;
+        }
+        for (const entry of Object.values(record))
+            replaceCidDeep(entry, oldCid, newCid, newBytes);
+    }
+}
+/** Re-serialize an add-on definition that now names the new GLB; the result is uploaded as a fresh root object. */
+function updateDefinitionRendition(definitionBytes, oldGlbCid, newGlbCid, newGlbBytes) {
+    const parsed = JSON.parse(node_buffer_1.Buffer.from(definitionBytes).toString('utf8'));
+    replaceCidDeep(parsed, oldGlbCid, newGlbCid, newGlbBytes);
+    return node_buffer_1.Buffer.from((0, helix_manifest_1.canonicalJsonBytes)(parsed));
+}
+/** The closure this manifest actually names: root + source + variant objects, deduplicated by cid. */
+function recomputeExpectedClosure(manifest) {
+    const seen = new Set();
+    let totalBytes = 0;
+    const refs = [
+        manifest.root,
+        ...(manifest.source ? [manifest.source] : []),
+        ...manifest.variants.map((variant) => variant.object),
+    ];
+    for (const ref of refs) {
+        const cid = (0, helix_manifest_1.normalizeContinuumCid)(ref.cid);
+        if (seen.has(cid))
+            continue;
+        seen.add(cid);
+        totalBytes += ref.bytes;
+    }
+    return { objectCount: seen.size, totalBytes };
+}
+/**
+ * Build the manifest for the next Version of the item's own Package: same package id/type/contract, version bumped,
+ * the web GLB (root for a prop/avatar, the GLB variant for an add-on) replaced with the new mesh, and — for an add-on
+ * whose root is a definition document — the definition's `rendition`/`mesh` re-pointed at the new GLB and re-uploaded.
+ */
+async function buildNextManifest(continuum, inspection, newGlbCid, newGlbBytes, audience, progress) {
+    const current = inspection.manifest;
+    const next = structuredClone(current);
+    const oldGlb = webGlbObjectOf(current);
+    if (next.root.mediaType === GLB_MEDIA_TYPE) {
+        next.root.cid = newGlbCid;
+        next.root.bytes = newGlbBytes;
+    }
+    for (const variant of next.variants) {
+        if (variant.object.mediaType === GLB_MEDIA_TYPE) {
+            variant.object.cid = newGlbCid;
+            variant.object.bytes = newGlbBytes;
+        }
+    }
+    // An add-on's root is a definition document that carries the GLB reference in its own `rendition`/`mesh` field.
+    // Re-point it too, so the sealed definition names exactly what the new Version serves (same as the retired
+    // `AddOnPackagePublisher.publishNextVersion` regenerating the definition with the new rendition).
+    if (next.root.mediaType !== GLB_MEDIA_TYPE && oldGlb) {
+        progress('Re-pointing the add-on definition at the new mesh…');
+        const definition = await continuum.readPackageObject(inspection.packageId, inspection.version, inspection.manifestCid, next.root.cid);
+        const updated = updateDefinitionRendition(definition.bytes, oldGlb.cid, newGlbCid, newGlbBytes);
+        const uploaded = await continuum.putObject({
+            bytes: updated,
+            filename: 'addon-definition.json',
+            mediaType: next.root.mediaType,
+            audience,
+        });
+        next.root.cid = uploaded.cid;
+        next.root.bytes = uploaded.bytes;
+    }
+    next.expectedClosure = recomputeExpectedClosure(next);
+    return next;
+}
+/**
+ * Ship a corrected mesh onto an ALREADY-PUBLISHED GLB add-on / prop / avatar, in place: seal a new Version of the
+ * item's own Continuum Package, then move the item pointer through `POST :id/versions`. On a listed item the move is
+ * refused by the visual-QA gate (422) — the seal stays behind and the caller gets the refusal to render, which names
+ * the two finishing steps (`item visual-qa --package-version vN --submit`, then `item set-version`).
+ */
+async function publishItemVersion(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_GLB_BYTES) {
+        throw new Error(`"${file}" is ${(bytes.length / (1024 * 1024)).toFixed(1)} MiB; an add-on/prop web GLB must be at most ${MAX_GLB_BYTES / (1024 * 1024)} MiB.`);
+    }
+    const progress = options.onProgress ?? (() => { });
+    const api = api_1.HelixApi.forCredentials(credentials);
+    const continuum = new client_1.HelixContinuumApi(api);
+    progress('Reading the item and its current Package Version…');
+    const { item } = await api.request('GET', `/api/v1/universal-items/${itemId}`);
+    const packageId = item.continuumPackagePin?.packageId;
+    const currentVersion = item.continuumPackagePin?.version;
+    if (!packageId || !currentVersion) {
+        throw new Error(`Item ${itemId} has no Continuum Package pin; publish its first Version before shipping an update.`);
+    }
+    const audience = item.status === 'published' ? 'public' : 'private';
+    const inspection = await continuum.inspectPackageVersion(packageId, currentVersion);
+    progress('Uploading the new mesh…');
+    const glb = await continuum.putObjectFromFile({
+        path: file,
+        filename: (0, node_path_1.basename)(file),
+        mediaType: GLB_MEDIA_TYPE,
+        audience,
+    });
+    const base = await buildNextManifest(continuum, inspection, glb.cid, glb.bytes, audience, progress);
+    // Seal the new Version (staged — it does not become the Package's current until the item actually moves to it),
+    // stepping past a Version name a previous attempt already sealed with different bytes.
+    let version = bumpVersionPatch(currentVersion);
+    for (let attempt = 0; attempt < MAX_VERSION_STEPS; attempt += 1) {
+        const manifest = { ...base, version };
+        progress(`Sealing ${packageId}@${version}…`);
+        let lifecycle;
+        try {
+            lifecycle = lifecycleOf(await continuum.createPackageVersion(packageId, manifest));
+        }
+        catch (error) {
+            if (error instanceof api_1.ApiError && error.status === 409) {
+                version = bumpVersionPatch(version);
+                continue;
+            }
+            throw error;
+        }
+        if (lifecycle === 'revoked')
+            throw new Error(`Package ${packageId}@${version} is revoked.`);
+        if (lifecycle !== 'sealed' && lifecycle !== 'superseded') {
+            const leaseOwner = `publish-version:${itemId}`;
+            const lease = await continuum.acquirePackageVersionLease(packageId, version, {
+                leaseOwner,
+                ttlSeconds: 300,
+                operationId: `publish-version:${packageId}:${version}`,
+            });
+            await continuum.sealPackageVersion(packageId, version, {
+                leaseOwner,
+                fencingToken: lease.fencingToken,
+                activate: false,
+            });
+        }
+        const manifestCid = (0, helix_manifest_1.continuumPackageVersionCid)(manifest);
+        const pin = { packageId, version, manifestCid };
+        progress('Moving the item to the new Version…');
+        const body = { packagePin: pin, 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;
+        try {
+            const move = await api.request('POST', `/api/v1/universal-items/${itemId}/versions`, body);
+            return { itemId, packageId, version, previousVersion: currentVersion, manifestCid, move };
+        }
+        catch (error) {
+            if (error instanceof api_1.ApiError && error.status === 422) {
+                // The visual-QA gate refused the move: the sealed Version stays behind, unserved, exactly as designed.
+                return { itemId, packageId, version, previousVersion: currentVersion, manifestCid, move: null, refusal: error };
+            }
+            throw error;
+        }
+    }
+    throw new Error(`Package ${packageId} has no free Version name after ${MAX_VERSION_STEPS} steps past ${currentVersion}.`);
+}
+//# sourceMappingURL=itemPublishVersion.js.map

package/dist/itemPublishVersion.js.map

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