@helix3/helix-cli 0.1.13-helix3.124 → 0.1.13-helix3.125

package/dist/index.js

@@ -492,6 +492,78 @@ program
             : `✖ ${err instanceof Error ? err.message : String(err)}`);
     }
 });
+program
+    .command('publish-interactable')
+    .description('Publish a validator-gated interactable bundle and link its official free Marketplace item')
+    .argument('[directory]', 'interactable bundle directory (the built dist/)', '.')
+    .action(async (directory) => {
+    const creds = requireAuth();
+    try {
+        const result = await (0, lib_1.publishInteractable)((0, node_path_1.resolve)(directory), creds, (message) => console.log(message));
+        console.log(`✔ Published interactable ${result.slug}@${result.version} (revision ${result.revision})`);
+        console.log(`  checksum:    ${result.checksumSha256}`);
+        console.log(`  item:        ${result.item.id}`);
+        console.log(`  distribution:${result.distribution.id}`);
+    }
+    catch (err) {
+        fail(err instanceof lib_1.ApiError
+            ? err.render()
+            : `✖ ${err instanceof Error ? err.message : String(err)}`);
+    }
+});
+program
+    .command('add-interactable')
+    .description('Resolve a Marketplace interactable, verify and vendor its bundle, then generate client/server glue')
+    .argument('<slug-or-item-id>', 'Marketplace item slug or UUID')
+    .option('-C, --world <dir>', 'world project directory', '.')
+    .option('--position <x,y,z>', 'placement origin in metres', '0,0,0')
+    .option('--yaw <degrees>', 'placement yaw in degrees', '0')
+    .option('--scale <n>', 'uniform placement scale', '1')
+    .action(async (ref, opts) => {
+    try {
+        const yawDeg = Number(opts.yaw);
+        const scale = Number(opts.scale);
+        if (!Number.isFinite(yawDeg))
+            fail(`✖ --yaw must be a number, got '${opts.yaw}'`);
+        if (!Number.isFinite(scale) || scale <= 0) {
+            fail(`✖ --scale must be a number > 0, got '${opts.scale}'`);
+        }
+        const credentials = (0, config_1.loadCredentials)() ?? undefined;
+        const result = await (0, lib_1.addInteractable)((0, node_path_1.resolve)(opts.world), ref, {
+            credentials,
+            placement: {
+                position: (0, lib_1.parseInteractablePosition)(opts.position),
+                yawDeg,
+                scale,
+            },
+            onProgress: (message) => console.log(message),
+        });
+        console.log(`${result.noOp ? '✔ Already installed' : '✔ Added'} ${result.id}@${result.version} as ${result.namespace}`);
+        console.log(`  bundle: ${result.destination}`);
+        console.log(`  client: ${result.clientGluePath}`);
+        console.log(`  server: ${result.manifestPath}`);
+        console.log('  composition caps:');
+        for (const name of [
+            'rules',
+            'roomVars',
+            'playerVars',
+            'timers',
+            'phases',
+            'zones',
+            'events',
+            'actions',
+        ]) {
+            console.log(`    ${name}: ${result.caps[name]}/${result.caps.limits[name]} (${result.caps.percentages[name]}%)`);
+        }
+        for (const warning of result.warnings)
+            console.warn(`  ! ${warning}`);
+    }
+    catch (err) {
+        fail(err instanceof lib_1.ApiError
+            ? err.render()
+            : `✖ ${err instanceof Error ? err.message : String(err)}`);
+    }
+});
 // --- helix item ------------------------------------------------------------
 // Universal items (wearables, avatars, home items) uploaded straight from a DCC
 // export — the surface Helix Studio drives. Publishing an item is not