@helix3/helix-cli 0.1.14-helix3.177 → 0.1.14-helix3.178

package/dist/index.js

@@ -41,6 +41,7 @@ const node_path_1 = require("node:path");
 const node_os_1 = require("node:os");
 const lib_1 = require("./lib");
 const itemQuote_1 = require("./itemQuote");
+const itemSearch_1 = require("./itemSearch");
 const tables_1 = require("./itemDef/tables");
 const emoteRules_1 = require("./itemDef/emoteRules");
 const scaffold_1 = require("./itemDef/scaffold");
@@ -1114,6 +1115,89 @@ const item = program
 // a dedicated command for a closed two-value list is a command to discover, to
 // document and to keep in sync, for information that fits on one line under the
 // list it is always read with. `--gender`'s own help carries the same values.
+item
+    .command('search')
+    .description('Search the published MARKETPLACE catalogue — including builds, the presets someone already assembled')
+    .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>', `builds in the results: ${itemSearch_1.BUILD_FILTER_MODES.join(' | ')} (default include — a build 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) => {
+    const creds = requireAuth();
+    if (opts.builds && !itemSearch_1.BUILD_FILTER_MODES.includes(opts.builds)) {
+        fail(`✖ --builds must be one of ${itemSearch_1.BUILD_FILTER_MODES.join(', ')}, got '${opts.builds}'`);
+    }
+    try {
+        const result = await (0, itemSearch_1.searchItems)(lib_1.HelixApi.forCredentials(creds), {
+            query,
+            kind: opts.kind,
+            category: opts.category,
+            subCategory: opts.subCategory,
+            tag: opts.tag,
+            hostKind: opts.hostKind,
+            builds: opts.builds,
+            limit: opts.limit ? parsePositiveInt(opts.limit, '--limit') : undefined,
+        });
+        if (opts.json)
+            return printJson(result);
+        if (result.items.length === 0) {
+            console.log('No published items match.');
+            return;
+        }
+        for (const row of result.items) {
+            // The BUILD mark leads the line. A build 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 builds
+            // do not get a category of their own.
+            const mark = row.buildKind ? `[build:${row.buildKind}] ` : '';
+            const price = row.priceLix === null ? 'unlisted' : `Ⱡ${row.priceLix}`;
+            console.log(`${mark}${row.title}  (${row.kind}, ${price})`);
+            console.log(`  ${row.id}${row.creator ? `  by ${row.creator}` : ''}`);
+        }
+        if (result.totalItems !== null && result.totalItems > result.items.length) {
+            console.error(`\nShowing ${result.items.length} of ${result.totalItems}. Use --limit to widen.`);
+        }
+    }
+    catch (err) {
+        fail(`✖ ${err instanceof Error ? err.message : String(err)}`);
+    }
+});
+item
+    .command('build')
+    .description("What is in a published build: its base, its parts, what you own, and what the parts cost together")
+    .argument('<itemId>', 'universal item id of the build')
+    .option('--json', 'machine-readable output')
+    .action(async (itemId, opts) => {
+    const creds = requireAuth();
+    try {
+        const result = await (0, itemSearch_1.getItemBuild)(lib_1.HelixApi.forCredentials(creds), itemId);
+        if (opts.json)
+            return printJson(result);
+        console.log(`Build (${result.kind}) — ${result.parts.length} part(s)`);
+        for (const part of result.parts) {
+            const name = part.title ?? 'Not listed on the marketplace yet';
+            // `owned === null` means nobody is signed in. Printing that as "not
+            // owned" would be a claim about the caller's inventory we cannot make.
+            const owned = part.owned === true ? ' [owned]' : '';
+            const price = part.priceLix === null ? '' : `  Ⱡ${part.priceLix}`;
+            console.log(`  ${part.slot.padEnd(16)} ${name}${price}${owned}`);
+        }
+        if (result.unresolvedPartCount > 0) {
+            // Named, never silently dropped: the total below describes only the
+            // listed parts, and a reader must not mistake it for the whole build.
+            console.log(`\n${result.unresolvedPartCount} part(s) are not listed yet and are NOT in the total.`);
+        }
+        console.log(`\nBuild total (sum of the listed parts): Ⱡ${result.totalPriceLix}`);
+    }
+    catch (err) {
+        fail(`✖ ${err instanceof Error ? err.message : String(err)}`);
+    }
+});
 item
     .command('list-slots')
     .description('Print the Character-Creator vocabulary a wearable declares: the cosmetic slot tags, and the genders')