@helix3/helix-cli 0.1.13-helix3.145 → 0.1.13-helix3.147

package/dist/index.js

@@ -3188,6 +3188,7 @@ sceneSource
     .requiredOption('--creator <creator>', 'attribution for the source pack')
     .requiredOption('--source-url <url>', 'where the pack was obtained')
     .option('--default-materials', 'swap imported materials/textures for the shared HELIX default set', false)
+    .option('--vault-pinned', 'this package will be uploaded with `vault-pin`, so the 199-file multipart guard is deferred to publish (where the bundle carries no files at all)', false)
     .option('--cell-size <meters>', 'streaming cell size override', parsePositiveFloat)
     .action(async (pack, opts) => {
     try {
@@ -3209,6 +3210,7 @@ sceneSource
             sourceId: opts.sourceId,
             receipt,
             ...(opts.defaultMaterials ? { defaultMaterials: true } : {}),
+            ...(opts.vaultPinned ? { vaultPinned: true } : {}),
             ...(opts.cellSize !== undefined ? { cellSizeM: opts.cellSize } : {}),
         });
         console.log(JSON.stringify(result, null, 2));
@@ -3217,6 +3219,50 @@ sceneSource
         fail(`✖ ${err instanceof Error ? err.message : String(err)}`);
     }
 });
+sceneSource
+    .command('vault-pin')
+    .description('Publish a compiled package\'s resources to the Vault and rewrite its Scene to pin them, so the published bundle is the Scene document alone')
+    .argument('<package-dir>', 'compiled Scene v2 package directory (from compile-pack or compile)')
+    .option('--kind <kind>', 'Vault kind for every resource (default: inferred per file extension)')
+    .option('--license <license>', 'Vault license: helix_standard, cc0, cc_by, or all_rights_reserved (default: from the import receipt)')
+    .option('--title-prefix <text>', 'prefix for each uploaded asset title')
+    .option('--concurrency <n>', 'parallel uploads, 1-8', parsePositiveFloat)
+    .option('--attempts <n>', 'upload attempts per file before it counts as failed (default 3)', parsePositiveFloat)
+    .option('--skip-unpinnable', 'leave files the Vault refuses as bundle resources and name them in the receipt, instead of failing the run', false)
+    .option('--dry-run', 'report what would be uploaded without sending any bytes or touching the Scene', false)
+    .action(async (packageDir, opts) => {
+    try {
+        const { pinScenePackageToVault } = await Promise.resolve().then(() => __importStar(require('./sceneImport/vaultPin')));
+        const { isVaultAssetKind, isVaultAssetLicense, VAULT_ASSET_LICENSES } = await Promise.resolve().then(() => __importStar(require('./vaultPublish')));
+        if (opts.kind !== undefined && !isVaultAssetKind(opts.kind)) {
+            fail(`✖ --kind must be one of: ${lib_1.VAULT_ASSET_KINDS.join(', ')}`);
+        }
+        if (opts.license !== undefined && !isVaultAssetLicense(opts.license)) {
+            fail(`✖ --license must be one of: ${VAULT_ASSET_LICENSES.join(', ')}`);
+        }
+        const creds = requireAuth();
+        const result = await pinScenePackageToVault({
+            packageDir: (0, node_path_1.resolve)(packageDir),
+            api: lib_1.HelixApi.forCredentials(creds),
+            apiUrl: creds.apiUrl,
+            ...(opts.kind !== undefined ? { kind: opts.kind } : {}),
+            ...(opts.license !== undefined
+                ? { license: opts.license }
+                : {}),
+            ...(opts.titlePrefix !== undefined ? { titlePrefix: opts.titlePrefix } : {}),
+            ...(opts.concurrency !== undefined ? { concurrency: opts.concurrency } : {}),
+            ...(opts.attempts !== undefined ? { attempts: opts.attempts } : {}),
+            skipUnpinnable: opts.skipUnpinnable,
+            dryRun: opts.dryRun,
+            // Progress goes to stderr so stdout stays one parseable JSON document.
+            onProgress: (message) => process.stderr.write(`${message}\n`),
+        });
+        console.log(JSON.stringify(result, null, 2));
+    }
+    catch (err) {
+        fail(err instanceof lib_1.ApiError ? err.render() : `✖ ${err instanceof Error ? err.message : String(err)}`);
+    }
+});
 sceneSource
     .command('publish')
     .description('Validate and dry-run the native Scene v2 World-build multipart request')
@@ -3266,6 +3312,8 @@ sceneSource
             worldId: input.worldId,
             profileId: input.profileId,
             visibility: input.visibility,
+            bundleResources: input.resources.length,
+            vaultPinnedResources: input.vaultPins.length,
             contentDelivery: 'public-content-addressed; --visibility gates World discovery only',
             receipt,
         }, null, 2));