@rankwrangler/cli 0.1.2 → 0.2.0

package/README.md

@@ -11,8 +11,9 @@ npm install -g @rankwrangler/cli
 ## Usage
 
 ```bash
-rankwrangler config set api-key rrk_...
-rankwrangler products get B0DV53VS61
+rw config set api-key rrk_...
+rw products get B0DV53VS61
+# `rankwrangler` is also supported as an alias
 ```
 
 ## Development

package/dist/index.js

@@ -11,18 +11,22 @@ const DEFAULT_MARKETPLACE_ID = 'ATVPDKIKX0DER';
 const CONFIG_DIR = path.join(homedir(), '.rankwrangler');
 const CONFIG_PATH = path.join(CONFIG_DIR, 'config.json');
 const DEFAULT_OUTPUT_PRETTY = true;
+const SUPPORTED_COMMANDS = new Set([
+    'products:get',
+    'api-key:status',
+    'api-key:validate',
+    'config:show',
+    'config:clear',
+    'config:set',
+]);
 const { positionals, values } = parseArgs({
     args: process.argv.slice(2),
     options: {
         help: { type: 'boolean', short: 'h' },
         apiKey: { type: 'string' },
-        licenseKey: { type: 'string' },
         baseUrl: { type: 'string' },
-        url: { type: 'string' },
         marketplace: { type: 'string', short: 'm' },
-        marketplaceId: { type: 'string' },
         asin: { type: 'string', multiple: true },
-        asins: { type: 'string', multiple: true },
     },
     allowPositionals: true,
 });
@@ -37,6 +41,10 @@ const main = async () => {
         fail('UNKNOWN_COMMAND', 'Unknown command', { command: positionals.join(' ') });
         return;
     }
+    if (!isSupportedCommand(command)) {
+        fail('UNKNOWN_COMMAND', 'Unknown command', { command: `${command.resource} ${command.verb}` });
+        return;
+    }
     const config = await loadConfig();
     if (command.resource === 'config') {
         const response = await runConfigCommand(command, config);
@@ -45,7 +53,7 @@ const main = async () => {
     }
     const apiKey = resolveApiKey(config);
     if (!apiKey) {
-        fail('MISSING_CONFIG', 'api key is required. set via `config set api-key <value>`');
+        fail('MISSING_CONFIG', 'API key is required. set via `config set api-key <value>`');
         return;
     }
     const baseUrl = resolveBaseUrl(config);
@@ -65,11 +73,11 @@ const runApiCommand = async (command, client, config) => {
         }
         return client.getProductInfoBatch.mutate({ marketplaceId, asins });
     }
-    if (command.resource === 'license' && command.verb === 'status') {
-        return client.license.status.mutate();
+    if (command.resource === 'api-key' && command.verb === 'status') {
+        return client.apiKey.status.mutate();
     }
-    if (command.resource === 'license' && command.verb === 'validate') {
-        return client.license.validate.mutate();
+    if (command.resource === 'api-key' && command.verb === 'validate') {
+        return client.apiKey.validate.mutate();
     }
     fail('UNKNOWN_COMMAND', 'Unknown command', {
         command: `${command.resource} ${command.verb}`,
@@ -108,7 +116,7 @@ const runConfigCommand = async (command, config) => {
         else if (key === 'base-url') {
             nextConfig.baseUrl = normalizeBaseUrl(value);
         }
-        else if (key === 'marketplace' || key === 'marketplace-id') {
+        else if (key === 'marketplace') {
             nextConfig.marketplaceId = value;
         }
         else {
@@ -128,11 +136,7 @@ const runConfigCommand = async (command, config) => {
     return null;
 };
 const requireMarketplaceId = (config) => {
-    const marketplaceId = values.marketplaceId ??
-        values.marketplace ??
-        config.marketplaceId ??
-        process.env.RR_MARKETPLACE_ID ??
-        DEFAULT_MARKETPLACE_ID;
+    const marketplaceId = values.marketplace ?? config.marketplaceId ?? process.env.RR_MARKETPLACE_ID ?? DEFAULT_MARKETPLACE_ID;
     return marketplaceId;
 };
 const requireAsins = (commandArgs) => {
@@ -143,7 +147,7 @@ const requireAsins = (commandArgs) => {
     return Array.from(new Set(candidates.map(normalizeAsin)));
 };
 const collectAsinCandidates = (commandArgs) => {
-    const optionAsins = [...(values.asin ?? []), ...(values.asins ?? [])];
+    const optionAsins = [...(values.asin ?? [])];
     const envAsins = process.env.RR_ASINS
         ? process.env.RR_ASINS.split(',').map(value => value.trim())
         : [];
@@ -160,10 +164,10 @@ const normalizeAsin = (value) => {
     return normalized;
 };
 const resolveApiKey = (config) => {
-    return values.apiKey ?? values.licenseKey ?? config.apiKey ?? process.env.RR_LICENSE_KEY;
+    return values.apiKey ?? config.apiKey ?? process.env.RR_API_KEY;
 };
 const resolveBaseUrl = (config) => {
-    const configured = values.baseUrl ?? values.url ?? config.baseUrl ?? process.env.RR_API_URL;
+    const configured = values.baseUrl ?? config.baseUrl ?? process.env.RR_API_URL;
     return normalizeBaseUrl(configured ?? DEFAULT_API_BASE_URL);
 };
 const normalizeBaseUrl = (value) => {
@@ -177,32 +181,18 @@ const normalizeBaseUrl = (value) => {
 };
 const resolveCommand = (inputPositionals) => {
     const [first, second, ...rest] = inputPositionals;
-    if (!first) {
-        return null;
-    }
-    if (first === 'get-product-info') {
-        return {
-            resource: 'products',
-            verb: 'get',
-            args: rest,
-        };
-    }
-    if (first === 'get-product-info-batch') {
-        return {
-            resource: 'products',
-            verb: 'get',
-            args: rest,
-        };
-    }
-    if (!second) {
+    if (!first || !second) {
         return null;
     }
     return {
         resource: first,
-        verb: first === 'products' && second === 'get-batch' ? 'get' : second,
+        verb: second,
         args: rest,
     };
 };
+const isSupportedCommand = (command) => {
+    return SUPPORTED_COMMANDS.has(`${command.resource}:${command.verb}`);
+};
 const loadConfig = async () => {
     try {
         const raw = await readFile(CONFIG_PATH, 'utf8');
@@ -275,40 +265,44 @@ const fail = (code, message, details) => {
 };
 const printUsage = () => {
     const usage = [
-        'RankWrangler CLI',
-        '',
-        'Command Shape',
-        '  rankwrangler <resource> <verb> [args...] [flags...]',
+        'NAME',
+        '  rw, rankwrangler - RankWrangler command line interface',
         '',
-        'Principles',
-        '  - Resource-first, verb-second commands',
-        '  - JSON-only output with {"ok": true|false, ...} envelope',
-        '  - One command maps to one API capability',
+        'SYNOPSIS',
+        '  rw <resource> <verb> [args...] [options]',
+        '  rankwrangler <resource> <verb> [args...] [options]',
         '',
-        'API Commands',
-        '  products get <ASIN...> [--marketplace <id>|-m <id>]',
-        '  license status',
-        '  license validate',
-        '',
-        'Config Commands',
+        'COMMANDS',
+        '  products get <ASIN...>',
+        '  api-key status',
+        '  api-key validate',
         '  config show',
         '  config clear',
         '  config set api-key <value>',
         '  config set base-url <origin>',
         '  config set marketplace <marketplaceId>',
         '',
-        'Global Flags',
-        '  --apiKey <value>         Override API key (alias: --licenseKey)',
-        '  --baseUrl <origin>       Override API origin (alias: --url)',
-        `  --marketplace <id>, -m   Override marketplace (default: ${DEFAULT_MARKETPLACE_ID})`,
-        '  --marketplaceId <id>     Compatibility alias for --marketplace',
+        'OPTIONS',
+        '  -h, --help               Show this help message',
+        '  --apiKey <value>         Override API key',
+        '  --baseUrl <origin>       Override API origin',
+        `  -m, --marketplace <id>   Override marketplace (default: ${DEFAULT_MARKETPLACE_ID})`,
         '  --asin <ASIN>            Add ASIN (repeatable)',
-        '  --asins <ASIN>           Add ASIN (repeatable, compatibility alias)',
         '',
-        'Legacy Aliases (still supported)',
-        '  get-product-info',
-        '  get-product-info-batch',
-        '  products get-batch',
+        'FILES',
+        `  ${CONFIG_PATH}           Local CLI config`,
+        '',
+        'ENVIRONMENT',
+        '  RR_API_KEY               API key fallback',
+        '  RR_API_URL               API origin fallback',
+        '  RR_MARKETPLACE_ID        Marketplace fallback',
+        '  RR_ASIN                  Single ASIN fallback',
+        '  RR_ASINS                 Comma-separated ASIN fallback',
+        '',
+        'EXAMPLES',
+        '  rw config set api-key rrk_...',
+        '  rw products get B0DV53VS61',
+        '  rankwrangler api-key status',
     ];
     console.log(usage.join('\n'));
 };

package/package.json

@@ -1,9 +1,10 @@
 {
     "name": "@rankwrangler/cli",
-    "version": "0.1.2",
+    "version": "0.2.0",
     "description": "Official RankWrangler command line interface",
     "type": "module",
     "bin": {
+        "rw": "dist/index.js",
         "rankwrangler": "dist/index.js"
     },
     "main": "./dist/index.js",
@@ -19,7 +20,7 @@
         "access": "public"
     },
     "dependencies": {
-        "@rankwrangler/http-client": "^0.1.2"
+        "@rankwrangler/http-client": "^0.2.0"
     },
     "devDependencies": {
         "@types/node": "^24.3.0",