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

package/dist/product.js

@@ -0,0 +1,285 @@
+"use strict";
+// Pure, network-free helpers behind `helix product …` — the in-world-purchase
+// registration vocabulary (key charset, the three product types, the authored
+// grant kinds, the field bounds) and the rules tying them together. Split
+// from the HTTP flow in lib.ts for the same reason achievement.ts is: every rule
+// below is testable without mocking a server, and every one of them costs a
+// round trip if it only fails remotely.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GRANT_CODE_MAX = exports.GRANT_CODE_PATTERN = exports.MAX_PASS_DURATION_SECONDS = exports.MAX_GRANT_CURRENCY_AMOUNT = exports.MAX_GRANT_ITEM_QUANTITY = exports.MAX_GRANT_EFFECTS = exports.productTypeGrantsItem = exports.isProductKey = exports.PRODUCT_DESCRIPTION_MAX = exports.PRODUCT_TITLE_MAX = exports.PRODUCT_KEY_MAX = exports.PRODUCT_KEY_PATTERN = exports.WORLD_PRODUCT_TYPES = void 0;
+exports.buildProductRegistration = buildProductRegistration;
+exports.buildProductUpdate = buildProductUpdate;
+// ---------------------------------------------------------------------------
+// The registration vocabulary
+// ---------------------------------------------------------------------------
+//
+// !! MIRROR — KEEP IN LOCKSTEP WITH THE BACKEND !!
+//
+//   AUTHORITY: helix-backend-api → src/iwp/dtos/register-world-product.request.dto.ts
+//              and src/iwp/dtos/update-world-product.request.dto.ts (the field
+//              bounds and which fields each route accepts), plus
+//              src/database/enums/world-product-type.enum.ts (the closed type
+//              list, and which of them grant a UniversalItem), plus
+//              src/iwp/product-grants.ts (the authored grant kinds, their
+//              bounds and the per-product effect cap).
+//
+// This is a LOCAL FAST PATH, never the authority. It exists so an incoherent
+// registration — a consumable carrying an item, a grant without one — fails
+// before a round trip, nothing more. Two properties keep a stale copy harmless:
+// the CLI never invents a value (every flag is matched EXACTLY against these
+// lists), and the server is always the last word — its 400 enumerates the real
+// vocabulary and is surfaced verbatim (ApiError.render()). `product.spec.ts`
+// pins the lists, so any edit is a reviewed diff rather than silent drift.
+/**
+ * What a purchase DOES. `item_grant` / `non_consumable` hand the player a
+ * UniversalItem (non_consumable additionally caps ownership via maxPerUser);
+ * `consumable` grants nothing durable — the world applies the effect itself.
+ */
+exports.WORLD_PRODUCT_TYPES = ['consumable', 'non_consumable', 'item_grant'];
+/** Up to 64 chars, lowercase letters/digits/`_`/`-`, starting alphanumeric. */
+exports.PRODUCT_KEY_PATTERN = /^[a-z0-9][a-z0-9_-]*$/;
+exports.PRODUCT_KEY_MAX = 64;
+exports.PRODUCT_TITLE_MAX = 120;
+exports.PRODUCT_DESCRIPTION_MAX = 2000;
+// Shape only, not the version nibble the DTO's IsUUID('4') demands: a local
+// refusal of a real item id would be worse than the round trip it saves.
+const UUID_SHAPE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+const isProductKey = (value) => typeof value === 'string' && value.length <= exports.PRODUCT_KEY_MAX && exports.PRODUCT_KEY_PATTERN.test(value);
+exports.isProductKey = isProductKey;
+/** The two types that must name the UniversalItem they hand over. */
+const productTypeGrantsItem = (type) => type !== 'consumable';
+exports.productTypeGrantsItem = productTypeGrantsItem;
+exports.MAX_GRANT_EFFECTS = 8;
+exports.MAX_GRANT_ITEM_QUANTITY = 100;
+exports.MAX_GRANT_CURRENCY_AMOUNT = 1_000_000_000;
+exports.MAX_PASS_DURATION_SECONDS = 10 * 365 * 24 * 60 * 60;
+/** Currency codes and pass keys share the product-key charset — world code spells all three. */
+exports.GRANT_CODE_PATTERN = exports.PRODUCT_KEY_PATTERN;
+exports.GRANT_CODE_MAX = exports.PRODUCT_KEY_MAX;
+const isGrantCode = (value) => typeof value === 'string' && value.length <= exports.GRANT_CODE_MAX && exports.GRANT_CODE_PATTERN.test(value);
+const isPositiveInt = (value, max) => typeof value === 'number' && Number.isInteger(value) && value >= 1 && value <= max;
+/**
+ * Every local rule on an authored effect array, COLLECTED rather than thrown one
+ * at a time: the backend answers with all of them at once, so the fast path
+ * should too. `productKey` is needed because a `pass` with no `passKey` defaults
+ * to the product key at fulfilment — a keyless product cannot mint a nameless
+ * pass. Item ids are only checked for presence: which items a creator may grant
+ * is the server's call, made against the registry.
+ */
+/** Every effect a PERMANENT pass ⇒ a second purchase delivers nothing (the server derives cap 1). */
+function isPermanentPassOnly(grants) {
+    return grants.length > 0 && grants.every((g) => g.kind === 'pass' && g.durationSeconds == null);
+}
+function grantErrors(grants, productKey) {
+    if (!Array.isArray(grants))
+        return ['grants must be an array of effects'];
+    if (grants.length > exports.MAX_GRANT_EFFECTS)
+        return [`grants may hold at most ${exports.MAX_GRANT_EFFECTS} effects`];
+    const errors = [];
+    const seenCodes = new Set();
+    const seenPasses = new Set();
+    grants.forEach((grant, index) => {
+        const at = `grants[${index}]`;
+        if (grant === null || typeof grant !== 'object' || Array.isArray(grant)) {
+            errors.push(`${at} must be an object effect`);
+            return;
+        }
+        const effect = grant;
+        switch (effect.kind) {
+            case 'item': {
+                if (typeof effect.itemId !== 'string' || !effect.itemId.trim())
+                    errors.push(`${at}: an item effect requires itemId`);
+                if (effect.quantity !== undefined && !isPositiveInt(effect.quantity, exports.MAX_GRANT_ITEM_QUANTITY)) {
+                    errors.push(`${at}: quantity must be an integer between 1 and ${exports.MAX_GRANT_ITEM_QUANTITY}`);
+                }
+                break;
+            }
+            case 'pass': {
+                const passKey = effect.passKey ?? productKey;
+                if (effect.passKey !== undefined && !isGrantCode(effect.passKey)) {
+                    errors.push(`${at}: passKey must be lowercase alphanumeric with - or _, at most ${exports.GRANT_CODE_MAX} chars`);
+                }
+                else if (passKey == null) {
+                    errors.push(`${at}: a pass on a keyless product must name a passKey (there is no product key to default to)`);
+                }
+                else if (typeof passKey === 'string') {
+                    if (seenPasses.has(passKey))
+                        errors.push(`${at}: duplicate pass "${passKey}" in one product`);
+                    seenPasses.add(passKey);
+                }
+                if (effect.durationSeconds !== undefined && !isPositiveInt(effect.durationSeconds, exports.MAX_PASS_DURATION_SECONDS)) {
+                    errors.push(`${at}: durationSeconds must be an integer between 1 and ${exports.MAX_PASS_DURATION_SECONDS}`);
+                }
+                break;
+            }
+            case 'currency': {
+                if (!isGrantCode(effect.code)) {
+                    errors.push(`${at}: code must be lowercase alphanumeric with - or _, at most ${exports.GRANT_CODE_MAX} chars`);
+                }
+                else {
+                    if (seenCodes.has(effect.code))
+                        errors.push(`${at}: duplicate currency "${effect.code}" in one product — merge the amounts`);
+                    seenCodes.add(effect.code);
+                }
+                if (!isPositiveInt(effect.amount, exports.MAX_GRANT_CURRENCY_AMOUNT)) {
+                    errors.push(`${at}: amount must be an integer between 1 and ${exports.MAX_GRANT_CURRENCY_AMOUNT}`);
+                }
+                if (effect.display !== undefined && effect.display !== 'wallet' && effect.display !== 'uses') {
+                    errors.push(`${at}: display must be "wallet" or "uses"`);
+                }
+                break;
+            }
+            default:
+                errors.push(`${at}: unknown kind "${String(effect.kind)}" — expected item, pass or currency`);
+        }
+    });
+    return errors;
+}
+const list = (values) => values.join(', ');
+/**
+ * Build the JSON body, applying every local rule first. Keys the caller did not
+ * set are OMITTED rather than sent empty — an empty description and no
+ * description are the same row, and sending "" would look like intent.
+ */
+function buildProductRegistration(input) {
+    const warnings = [];
+    const key = input.key?.trim().toLowerCase() || undefined;
+    if (key !== undefined) {
+        if (!(0, exports.isProductKey)(key)) {
+            throw new Error(`key "${key}" must be at most ${exports.PRODUCT_KEY_MAX} chars of lowercase letters, digits, "_" or "-", starting alphanumeric. ` +
+                'It is what world code buys as `pkey:<key>`, so treat it as a schema: it cannot be renamed later.');
+        }
+        if (key !== input.key?.trim())
+            warnings.push(`key lowercased to "${key}" — the registry stores it lowercase.`);
+    }
+    const title = input.title?.trim() ?? '';
+    if (!title)
+        throw new Error('title is required (the name the purchase popup shows the player)');
+    if (title.length > exports.PRODUCT_TITLE_MAX)
+        throw new Error(`title is ${title.length} characters; the limit is ${exports.PRODUCT_TITLE_MAX}`);
+    const description = input.description?.trim();
+    if (description !== undefined && description.length > exports.PRODUCT_DESCRIPTION_MAX) {
+        throw new Error(`description is ${description.length} characters; the limit is ${exports.PRODUCT_DESCRIPTION_MAX}`);
+    }
+    // 0 is a first-class price, not a missing one: it registers a free "Claim",
+    // which the popup confirms without spending LIX.
+    if (input.priceLix === undefined)
+        throw new Error('priceLix is required (LIX the player pays; use 0 for a free "Claim")');
+    if (!Number.isFinite(input.priceLix) || input.priceLix < 0) {
+        throw new Error(`priceLix must be a number >= 0 LIX (got ${input.priceLix}); 0 registers a free "Claim"`);
+    }
+    const itemId = input.itemId?.trim() || undefined;
+    // One authoring mode per product: `grants` is the WHOLE effect list, so a
+    // type/itemId beside it would be a second, possibly disagreeing answer to
+    // "what does this hand over". The server derives both from the effects.
+    const grants = input.grants ?? null;
+    let type;
+    if (grants) {
+        if (input.type || itemId) {
+            throw new Error('grants replaces type/itemId — author the effect list (item | pass | currency) or the legacy type/itemId pair, not both.');
+        }
+        const errors = grantErrors(grants, key ?? null);
+        if (errors.length)
+            throw new Error(errors.join('; '));
+        // SYNC OBLIGATION: mirrors the backend's refusal (helix-backend-api product-grants.ts,
+        // PERMANENT_PASS_CAP_MESSAGE) so the author learns it here rather than from a 400.
+        if (input.maxPerUser !== undefined && input.maxPerUser > 1 && isPermanentPassOnly(grants)) {
+            throw new Error('a permanent pass is delivered once — a maxPerUser above 1 would charge again for nothing; leave it unset ' +
+                '(the cap is 1), or add a timed pass or a currency effect to make the product re-buyable.');
+        }
+    }
+    else {
+        if (!input.type)
+            throw new Error(`type is required when grants is not provided (one of ${list(exports.WORLD_PRODUCT_TYPES)})`);
+        if (!exports.WORLD_PRODUCT_TYPES.includes(input.type)) {
+            throw new Error(`unknown type "${input.type}" — supported types: ${list(exports.WORLD_PRODUCT_TYPES)}`);
+        }
+        type = input.type;
+        if ((0, exports.productTypeGrantsItem)(type)) {
+            if (!itemId) {
+                throw new Error(`a "${type}" product hands the player a universal item — set itemId to the Item id returned by \`helix continuum make-item\` or \`helix continuum publish-glb --offer marketplace\`. ` +
+                    'Use type consumable for a purchase your world fulfils itself.');
+            }
+            if (!UUID_SHAPE.test(itemId))
+                throw new Error(`itemId "${itemId}" is not a universal-item id (a uuid)`);
+        }
+        else if (itemId) {
+            throw new Error('a "consumable" product grants nothing durable, so it takes no itemId - use type item_grant ' +
+                '(or non_consumable, which also caps ownership) to hand over an item.');
+        }
+    }
+    if (input.maxPerUser !== undefined && (!Number.isInteger(input.maxPerUser) || input.maxPerUser < 1)) {
+        throw new Error(`maxPerUser must be a whole number >= 1 (got ${input.maxPerUser})`);
+    }
+    if (input.priceLix === 0)
+        warnings.push('price 0 registers a free "Claim" — the popup asks for confirmation, not LIX.');
+    if (!key) {
+        warnings.push('no key: world code can then only buy this product by its uuid. A key lets it buy "pkey:<key>", which is stable across builds.');
+    }
+    if (type === 'consumable') {
+        warnings.push('a consumable grants nothing on its own — your world applies the effect when the purchase comes back Granted.');
+    }
+    if (grants && grants.length === 0) {
+        warnings.push('an empty grants list is a tip jar — the purchase hands over nothing; your world applies the effect when it comes back Granted.');
+    }
+    return {
+        fields: {
+            ...(key ? { key } : {}),
+            title,
+            ...(description ? { description } : {}),
+            priceLix: input.priceLix,
+            ...(grants ? { grants } : { type, ...(itemId ? { itemId } : {}) }),
+            ...(input.maxPerUser !== undefined ? { maxPerUser: input.maxPerUser } : {}),
+        },
+        warnings,
+    };
+}
+/** Validate a PATCH body locally and refuse an empty one (a no-op round trip that reads as success). */
+function buildProductUpdate(input) {
+    // The backend has no route that changes a key, by design: world code buys
+    // "pkey:<key>", so a rename would break every build naming it.
+    if (input.key !== undefined) {
+        throw new Error('a product\'s key is immutable — world code buys it as "pkey:<key>", so renaming one would break every build that names it. ' +
+            'Register a new product and deactivate this one instead.');
+    }
+    // Same reason, one step further on: the effect list is what a buyer paid for.
+    if (input.grants !== undefined) {
+        throw new Error('a product\'s grants are immutable — changing what a purchase hands over would re-label every copy already sold. ' +
+            'Register a new product and deactivate this one instead.');
+    }
+    const patch = {};
+    if (input.title !== undefined) {
+        const title = input.title.trim();
+        if (!title)
+            throw new Error('title cannot be empty');
+        if (title.length > exports.PRODUCT_TITLE_MAX)
+            throw new Error(`title is ${title.length} characters; the limit is ${exports.PRODUCT_TITLE_MAX}`);
+        patch.title = title;
+    }
+    if (input.description !== undefined) {
+        const description = input.description.trim();
+        if (description.length > exports.PRODUCT_DESCRIPTION_MAX) {
+            throw new Error(`description is ${description.length} characters; the limit is ${exports.PRODUCT_DESCRIPTION_MAX}`);
+        }
+        patch.description = description;
+    }
+    if (input.priceLix !== undefined) {
+        if (!Number.isFinite(input.priceLix) || input.priceLix < 0) {
+            throw new Error(`priceLix must be a number >= 0 LIX (got ${input.priceLix}); 0 makes it a free "Claim"`);
+        }
+        patch.priceLix = input.priceLix;
+    }
+    if (input.maxPerUser !== undefined) {
+        if (input.maxPerUser !== null && (!Number.isInteger(input.maxPerUser) || input.maxPerUser < 1)) {
+            throw new Error(`maxPerUser must be a whole number >= 1 (got ${input.maxPerUser})`);
+        }
+        patch.maxPerUser = input.maxPerUser;
+    }
+    if (input.active !== undefined)
+        patch.active = input.active;
+    if (Object.keys(patch).length === 0) {
+        throw new Error('nothing to update — set at least one of title, description, priceLix, maxPerUser, active');
+    }
+    return patch;
+}
+//# sourceMappingURL=product.js.map

package/dist/product.js.map

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

package/dist/publications.d.ts

@@ -0,0 +1,116 @@
+import type { CliCredentials } from './config';
+export declare const PUBLICATIONS_UPLOAD_PATH = "/api/v1/publications/upload";
+export declare const ITEMS_FROM_PACKAGE_PATH = "/api/v1/items";
+export type PublicationOffer = {
+    channel: 'marketplace' | 'world';
+    priceLix: number;
+    worldId?: string;
+    key?: string;
+    maxPerPlayer?: number;
+    maxClaims?: number;
+    startsAt?: string;
+    endsAt?: string;
+};
+export type PublishGlbOptions = {
+    mesh: string;
+    title: string;
+    contentRating?: 'everyone' | 'teen' | 'mature' | 'adult';
+    packageType?: 'asset' | 'character';
+    intentId?: string;
+    visibility?: 'public' | 'private';
+    vaultListing?: 'auto' | 'none';
+    offer?: PublicationOffer;
+    edition?: 'standard' | 'collectible';
+    collectibleSupply?: number;
+    category?: string;
+    description?: string;
+    tags?: string[];
+};
+export type PublicationReceipt = {
+    intentId: string;
+    package: {
+        packageId: string;
+        version: string;
+        manifestCid: string;
+        type: string;
+        visibility: string;
+        created: boolean;
+    };
+    item: null | {
+        item: {
+            id: string;
+            packagePin: {
+                packageId: string;
+                version: string;
+                manifestCid: string;
+            };
+        };
+        creatorCopy: null | {
+            inventoryItemId: string;
+            serial: number | null;
+            soulbound: boolean;
+        };
+        distributions: Array<{
+            id: string;
+            channel: string;
+            active: boolean;
+        }>;
+        channelsDeferred?: {
+            reason: string;
+            channels: string[];
+        };
+    };
+    vaultListing: {
+        state: string;
+    };
+    verification?: {
+        ok: boolean;
+        warnings: string[];
+    };
+};
+export type PublicationApi = {
+    postMultipart(path: string, form: FormData): Promise<PublicationReceipt>;
+};
+export type PackagePin = {
+    packageId: string;
+    version: string;
+    manifestCid: string;
+};
+export type MakeItemOptions = {
+    intentId?: string;
+    packagePin: PackagePin;
+    contentRating: 'everyone' | 'teen' | 'mature' | 'adult';
+    title?: string;
+    description?: string;
+    category?: string;
+    edition?: 'standard' | 'collectible';
+    collectibleSupply?: number;
+    tags?: string[];
+    offer?: PublicationOffer;
+    personal?: boolean;
+};
+export type MadeItemReceipt = NonNullable<PublicationReceipt['item']> & {
+    created?: boolean;
+};
+export type ItemApi = {
+    request(pathMethod: 'POST', path: string, body: unknown): Promise<MadeItemReceipt>;
+};
+export type PublishOwnedItemOptions = {
+    itemId: string;
+    intentId?: string;
+    packagePin: PackagePin;
+    contentRating: 'everyone' | 'teen' | 'mature' | 'adult';
+    acceptRatingAttestation: true;
+};
+/** Publish a personal Item without changing its identity or minting an offer. */
+export declare function publishOwnedItemFromPackage(options: PublishOwnedItemOptions, creds: CliCredentials, deps?: {
+    api?: ItemApi;
+}): Promise<MadeItemReceipt>;
+/** Project an owned, sealed exact Package Version into one ownable Item. */
+export declare function makeItemFromPackage(options: MakeItemOptions, creds: CliCredentials, deps?: {
+    api?: ItemApi;
+}): Promise<MadeItemReceipt>;
+/** One authoritative request: seal the GLB into a Package, then optionally open its first offer. */
+export declare function publishGlb(options: PublishGlbOptions, creds: CliCredentials, deps?: {
+    api?: PublicationApi;
+}): Promise<PublicationReceipt>;

package/dist/publications.js

@@ -0,0 +1,180 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ITEMS_FROM_PACKAGE_PATH = exports.PUBLICATIONS_UPLOAD_PATH = void 0;
+exports.publishOwnedItemFromPackage = publishOwnedItemFromPackage;
+exports.makeItemFromPackage = makeItemFromPackage;
+exports.publishGlb = publishGlb;
+const node_crypto_1 = require("node:crypto");
+const node_path_1 = require("node:path");
+const node_fs_1 = require("node:fs");
+const api_1 = require("./api");
+const item_1 = require("./item");
+exports.PUBLICATIONS_UPLOAD_PATH = '/api/v1/publications/upload';
+exports.ITEMS_FROM_PACKAGE_PATH = '/api/v1/items';
+const validLixPrice = (price) => Number.isFinite(price) && price >= 0 && Number(price.toFixed(4)) === price;
+/** Publish a personal Item without changing its identity or minting an offer. */
+async function publishOwnedItemFromPackage(options, creds, deps = {}) {
+    const intentId = options.intentId ?? (0, node_crypto_1.randomUUID)();
+    const pin = options.packagePin;
+    if (options.acceptRatingAttestation !== true)
+        throw new TypeError('explicit content-rating attestation is required');
+    if (!/^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(intentId))
+        throw new TypeError('intentId must be a UUIDv4');
+    if (!/^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(options.itemId))
+        throw new TypeError('itemId must be a UUID');
+    if (!/^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(pin.packageId) || !/^\d+\.\d+\.\d+$/.test(pin.version) || !/^cid:sha256:[a-f0-9]{64}$/i.test(pin.manifestCid)) {
+        throw new TypeError('packagePin must name an exact sealed Package UUID, semver and manifest CID');
+    }
+    if (!['everyone', 'teen', 'mature', 'adult'].includes(options.contentRating))
+        throw new TypeError('contentRating must be explicitly set to everyone, teen, mature or adult');
+    const api = deps.api ?? api_1.HelixApi.forCredentials(creds);
+    const response = await api.request('POST', `${exports.ITEMS_FROM_PACKAGE_PATH}/${encodeURIComponent(options.itemId)}/publish`, {
+        intentId,
+        packagePin: pin,
+        contentRating: options.contentRating,
+        contentRatingAttestationAccepted: true,
+    });
+    const itemPin = response?.item?.packagePin;
+    if (response?.created !== false || response.item?.id !== options.itemId ||
+        !itemPin || itemPin.packageId !== pin.packageId || itemPin.version !== pin.version || itemPin.manifestCid !== pin.manifestCid) {
+        throw new Error(`Item promotion ${intentId} returned no unchanged Item with its exact sealed Package pin; inspect the server receipt before retrying`);
+    }
+    if (!Array.isArray(response.distributions) || response.distributions.length !== 0) {
+        throw new Error(`Item promotion ${intentId} unexpectedly opened an offer`);
+    }
+    return response;
+}
+/** Project an owned, sealed exact Package Version into one ownable Item. */
+async function makeItemFromPackage(options, creds, deps = {}) {
+    const intentId = options.intentId ?? (0, node_crypto_1.randomUUID)();
+    const pin = options.packagePin;
+    if (!/^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(intentId))
+        throw new TypeError('intentId must be a UUID');
+    if (!/^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(pin.packageId) || !/^\d+\.\d+\.\d+$/.test(pin.version) || !/^cid:sha256:[a-f0-9]{64}$/i.test(pin.manifestCid)) {
+        throw new TypeError('packagePin must name an exact sealed Package UUID, semver and manifest CID');
+    }
+    if (!['everyone', 'teen', 'mature', 'adult'].includes(options.contentRating))
+        throw new TypeError('contentRating must be explicitly set to everyone, teen, mature or adult');
+    if (options.offer && !validLixPrice(options.offer.priceLix))
+        throw new TypeError('offer price must be nonnegative with at most four decimal places');
+    if (options.offer?.channel === 'world' && (!options.offer.worldId || !options.offer.key))
+        throw new TypeError('a World offer requires worldId and key');
+    if (options.offer?.channel === 'marketplace' && (options.offer.worldId || options.offer.key))
+        throw new TypeError('a Marketplace offer cannot name a World or key');
+    if (options.personal && options.offer)
+        throw new TypeError('a personal Item cannot open a public offer');
+    if (options.edition === 'collectible' && (!Number.isInteger(options.collectibleSupply) || (options.collectibleSupply ?? 0) < 1))
+        throw new TypeError('collectibleSupply must be a positive integer');
+    const body = {
+        intentId, packagePin: pin, title: options.title, description: options.description,
+        category: options.category, edition: options.edition ?? 'standard', collectibleSupply: options.collectibleSupply,
+        tags: options.tags, personal: options.personal,
+        contentRating: options.contentRating, contentRatingAttestationAccepted: true,
+        ...(options.offer ? { distributions: [options.offer] } : {}),
+    };
+    const api = deps.api ?? api_1.HelixApi.forCredentials(creds);
+    const response = await api.request('POST', exports.ITEMS_FROM_PACKAGE_PATH, body);
+    const itemPin = response?.item?.packagePin;
+    if (!response?.item?.id || !itemPin || itemPin.packageId !== pin.packageId || itemPin.version !== pin.version || itemPin.manifestCid !== pin.manifestCid) {
+        throw new Error(`Item intent ${intentId} returned no exact sealed Package pin; inspect the server receipt before retrying`);
+    }
+    if (options.offer) {
+        if (!options.contentRating || !['everyone', 'teen', 'mature', 'adult'].includes(options.contentRating))
+            throw new TypeError('an offer requires an explicit contentRating: everyone, teen, mature or adult');
+        const opened = response.distributions?.some((route) => route.channel === options.offer.channel && route.active);
+        const deferred = response.channelsDeferred?.channels?.includes(options.offer.channel);
+        const scheduled = Boolean(options.offer.startsAt && Date.parse(options.offer.startsAt) > Date.now() && response.distributions?.some((route) => route.channel === options.offer.channel && !route.active));
+        if (!opened && !deferred && !scheduled)
+            throw new Error(`Item intent ${intentId} did not open, schedule or defer the requested offer`);
+        if (opened && !response.creatorCopy)
+            throw new Error(`Item intent ${intentId} opened an offer without a creator copy`);
+        if (!opened && response.creatorCopy)
+            throw new Error(`Item intent ${intentId} granted a creator copy before its offer opened`);
+    }
+    else if (response.creatorCopy && response.created !== false) {
+        throw new Error(`Item intent ${intentId} minted a creator copy before an offer was made`);
+    }
+    return response;
+}
+/** One authoritative request: seal the GLB into a Package, then optionally open its first offer. */
+async function publishGlb(options, creds, deps = {}) {
+    const intentId = options.intentId ?? (0, node_crypto_1.randomUUID)();
+    if (!/^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(intentId)) {
+        throw new TypeError('intentId must be a UUID');
+    }
+    const title = options.title.trim();
+    if (!title)
+        throw new TypeError('title is required');
+    if (options.offer) {
+        if (options.visibility === 'private')
+            throw new TypeError('a public offer requires a public Package');
+        if (!validLixPrice(options.offer.priceLix))
+            throw new TypeError('offer price must be nonnegative with at most four decimal places');
+        if (options.offer.channel === 'world' && (!options.offer.worldId || !options.offer.key))
+            throw new TypeError('a World offer requires worldId and key');
+        if (options.offer.channel === 'marketplace' && (options.offer.worldId || options.offer.key))
+            throw new TypeError('a Marketplace offer cannot name a World or key');
+    }
+    if (options.edition === 'collectible' && (!Number.isInteger(options.collectibleSupply) || (options.collectibleSupply ?? 0) < 1)) {
+        throw new TypeError('collectibleSupply must be a positive integer');
+    }
+    if (options.collectibleSupply !== undefined && options.edition !== 'collectible') {
+        throw new TypeError('collectibleSupply requires collectible edition');
+    }
+    const bytes = (0, node_fs_1.readFileSync)(options.mesh);
+    (0, item_1.assertLooksLikeGlb)(bytes, options.mesh);
+    const payload = {
+        intentId,
+        title,
+        packageType: options.packageType ?? 'asset',
+        visibility: options.visibility ?? 'public',
+        vaultListing: options.vaultListing ?? 'none',
+        ...(options.offer ? {
+            contentRating: options.contentRating,
+            contentRatingAttestationAccepted: true,
+            item: {
+                title,
+                description: options.description,
+                category: options.category,
+                edition: options.edition ?? 'standard',
+                collectibleSupply: options.collectibleSupply,
+                tags: options.tags,
+                distributions: [options.offer],
+            },
+        } : {}),
+    };
+    const form = new FormData();
+    form.append('mesh', new Blob([new Uint8Array(bytes)], { type: 'model/gltf-binary' }), (0, node_path_1.basename)(options.mesh));
+    form.append('payload', JSON.stringify(payload));
+    const api = deps.api ?? api_1.HelixApi.forCredentials(creds);
+    const response = await api.postMultipart(exports.PUBLICATIONS_UPLOAD_PATH, form);
+    const pin = response.package;
+    if (!pin?.packageId || !pin.version || !pin.manifestCid || !pin.manifestCid.startsWith('cid:sha256:')) {
+        throw new Error(`Publication ${intentId} returned no sealed Package pin; inspect the server receipt before retrying`);
+    }
+    if (response.intentId !== intentId)
+        throw new Error(`Publication response intent differs from ${intentId}`);
+    if (options.offer) {
+        const item = response.item;
+        if (!item?.item?.id || !item.item.packagePin ||
+            item.item.packagePin.packageId !== pin.packageId ||
+            item.item.packagePin.version !== pin.version ||
+            item.item.packagePin.manifestCid !== pin.manifestCid) {
+            throw new Error(`Publication ${intentId} returned no Item pinned to its sealed Package; inspect the receipt before retrying`);
+        }
+        const opened = item.distributions?.some((route) => route.channel === options.offer.channel && route.active);
+        const deferred = item.channelsDeferred?.channels?.includes(options.offer.channel);
+        const scheduled = Boolean(options.offer.startsAt && Date.parse(options.offer.startsAt) > Date.now() && item.distributions?.some((route) => route.channel === options.offer.channel && !route.active));
+        if (!opened && !deferred && !scheduled)
+            throw new Error(`Publication ${intentId} did not open, schedule or defer the requested ${options.offer.channel} offer`);
+        if (opened && !item.creatorCopy)
+            throw new Error(`Publication ${intentId} opened an offer without a creator copy`);
+        if (!opened && item.creatorCopy)
+            throw new Error(`Publication ${intentId} granted a creator copy before its offer opened`);
+    }
+    else if (response.item !== null) {
+        throw new Error(`Package-only publication ${intentId} unexpectedly created an Item`);
+    }
+    return response;
+}
+//# sourceMappingURL=publications.js.map

package/dist/publications.js.map

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