docstar-cli 1.2.1 → 1.4.0

package/dist/commands/msg91/whatsapp/to-fetch-whatsapp-number.js

@@ -0,0 +1,32 @@
+import {Command, Flags} from '@oclif/core'
+import {executeCliCommand} from '../../../lib/http.js'
+import {promptForMissingParams} from '../../../lib/prompt.js'
+
+const REQUIRED_PARAMS = []
+
+export default class Generated extends Command {
+  static description = "To Fetch Whatsapp Number"
+  static aliases = []
+  static flags = {
+    "accept": Flags.string({description: 'Header value'}),
+    "authkey": Flags.string({description: 'Header value'}),
+    "content-type": Flags.string({description: 'Header value'}),
+  }
+
+  async run() {
+    const {flags} = await this.parse(Generated)
+    const params = {}
+    for (const [key, value] of Object.entries(flags)) {
+      if (value !== undefined) params[key] = value
+    }
+
+    Object.assign(params, await promptForMissingParams(REQUIRED_PARAMS, params))
+
+    try {
+      const result = await executeCliCommand("msg91", "whatsapp", "to-fetch-whatsapp-number", params)
+      this.log(JSON.stringify(result, null, 2))
+    } catch (error) {
+      this.error(error.message)
+    }
+  }
+}

package/dist/commands/msg91/whatsapp/whatsapp-analytics.js

@@ -0,0 +1,33 @@
+import {Command, Flags} from '@oclif/core'
+import {executeCliCommand} from '../../../lib/http.js'
+import {promptForMissingParams} from '../../../lib/prompt.js'
+
+const REQUIRED_PARAMS = []
+
+export default class Generated extends Command {
+  static description = "WhatsApp Analytics"
+  static aliases = []
+  static flags = {
+    "startDate": Flags.string({description: "Optional parameter"}),
+    "endDate": Flags.string({description: "Optional parameter"}),
+    "Accept": Flags.string({description: 'Header value'}),
+    "Authkey": Flags.string({description: 'Header value'}),
+  }
+
+  async run() {
+    const {flags} = await this.parse(Generated)
+    const params = {}
+    for (const [key, value] of Object.entries(flags)) {
+      if (value !== undefined) params[key] = value
+    }
+
+    Object.assign(params, await promptForMissingParams(REQUIRED_PARAMS, params))
+
+    try {
+      const result = await executeCliCommand("msg91", "whatsapp", "whatsapp-analytics", params)
+      this.log(JSON.stringify(result, null, 2))
+    } catch (error) {
+      this.error(error.message)
+    }
+  }
+}

package/dist/commands/msg91/whatsapp/whatsapp-logs.js

@@ -0,0 +1,36 @@
+import {Command, Flags} from '@oclif/core'
+import {executeCliCommand} from '../../../lib/http.js'
+import {promptForMissingParams} from '../../../lib/prompt.js'
+
+const REQUIRED_PARAMS = []
+
+export default class Generated extends Command {
+  static description = "Whatsapp Logs"
+  static aliases = []
+  static flags = {
+    "startDate": Flags.string({description: "Optional parameter"}),
+    "endDate": Flags.string({description: "Optional parameter"}),
+    "requestId": Flags.string({description: "Optional parameter"}),
+    "fields": Flags.string({description: "Optional parameter"}),
+    "limit": Flags.string({description: "Optional parameter"}),
+    "authkey": Flags.string({description: 'Header value'}),
+    "accept": Flags.string({description: 'Header value'}),
+  }
+
+  async run() {
+    const {flags} = await this.parse(Generated)
+    const params = {}
+    for (const [key, value] of Object.entries(flags)) {
+      if (value !== undefined) params[key] = value
+    }
+
+    Object.assign(params, await promptForMissingParams(REQUIRED_PARAMS, params))
+
+    try {
+      const result = await executeCliCommand("msg91", "whatsapp", "whatsapp-logs", params)
+      this.log(JSON.stringify(result, null, 2))
+    } catch (error) {
+      this.error(error.message)
+    }
+  }
+}

package/dist/commands/msg91/whatsapp/whatsapp-voice-call.js

@@ -0,0 +1,34 @@
+import {Command, Flags} from '@oclif/core'
+import {executeCliCommand} from '../../../lib/http.js'
+import {promptForMissingParams} from '../../../lib/prompt.js'
+
+const REQUIRED_PARAMS = ["status","call_hours"]
+
+export default class Generated extends Command {
+  static description = "WhatsApp Voice Call"
+  static aliases = []
+  static flags = {
+    "status": Flags.string({description: "Required parameter"}),
+    "call_hours": Flags.string({description: "Required parameter"}),
+    "Content-Type": Flags.string({description: 'Header value'}),
+    "content-type": Flags.string({description: 'Header value'}),
+    "authkey": Flags.string({description: 'Header value'}),
+  }
+
+  async run() {
+    const {flags} = await this.parse(Generated)
+    const params = {}
+    for (const [key, value] of Object.entries(flags)) {
+      if (value !== undefined) params[key] = value
+    }
+
+    Object.assign(params, await promptForMissingParams(REQUIRED_PARAMS, params))
+
+    try {
+      const result = await executeCliCommand("msg91", "whatsapp", "whatsapp-voice-call", params)
+      this.log(JSON.stringify(result, null, 2))
+    } catch (error) {
+      this.error(error.message)
+    }
+  }
+}

package/dist/commands/reqres/project/get-all-project.js

@@ -0,0 +1,32 @@
+import {Command, Flags} from '@oclif/core'
+import {executeCliCommand} from '../../../lib/http.js'
+import {promptForMissingParams} from '../../../lib/prompt.js'
+
+const REQUIRED_PARAMS = []
+
+export default class Generated extends Command {
+  static description = "Get all project "
+  static aliases = []
+  static flags = {
+    "project_id": Flags.string({description: "Optional parameter"}),
+    "x-api-key": Flags.string({description: 'Header value'}),
+    "X-Reqres-Env": Flags.string({description: 'Header value'}),
+  }
+
+  async run() {
+    const {flags} = await this.parse(Generated)
+    const params = {}
+    for (const [key, value] of Object.entries(flags)) {
+      if (value !== undefined) params[key] = value
+    }
+
+    Object.assign(params, await promptForMissingParams(REQUIRED_PARAMS, params))
+
+    try {
+      const result = await executeCliCommand("reqres", "project", "get-all-project", params)
+      this.log(JSON.stringify(result, null, 2))
+    } catch (error) {
+      this.error(error.message)
+    }
+  }
+}

package/dist/lib/codegen.js

@@ -7,11 +7,21 @@ const flagLine = (name, required) =>
 // that safely for embedding in generated source; naive string interpolation does not and can
 // produce invalid JS.
 `    ${JSON.stringify(name)}: Flags.string({description: ${JSON.stringify(`${required ? 'Required' : 'Optional'} parameter`)}}),`;
+// Header names configured in the docs editor (e.g. `authkey`) aren't part of `cli.parameters`,
+// so without this they can never be overridden from the CLI and requests are stuck with
+// whatever placeholder/value is baked into the cached module JSON. Expose them as flags too,
+// skipping any name that's already a parameter flag (that flag's value already reaches
+// `buildHeaders` via `params[key]`) or isn't a valid flag name.
+const headerFlagNames = (endpoint) => {
+    const paramNames = new Set([...endpoint.cli.parameters.required, ...endpoint.cli.parameters.optional]);
+    return Object.keys(endpoint.headers || {}).filter((name) => /^[A-Za-z][\w-]*$/.test(name) && !paramNames.has(name));
+};
 const commandFileContent = (cliName, modulePathSegment, endpoint) => {
     const { cli } = endpoint;
     const flagLines = [
         ...cli.parameters.required.map((name) => flagLine(name, true)),
         ...cli.parameters.optional.map((name) => flagLine(name, false)),
+        ...headerFlagNames(endpoint).map((name) => `    ${JSON.stringify(name)}: Flags.string({description: 'Header value'}),`),
     ].join('\n');
     return `import {Command, Flags} from '@oclif/core'
 import {executeCliCommand} from '../../../lib/http.js'

package/dist/lib/http.js

@@ -1,5 +1,5 @@
 import { readFile } from 'node:fs/promises';
-import { modulePath } from './paths.js';
+import { configPath, modulePath } from './paths.js';
 // Endpoint fields come from a rich-text editor and may be wrapped in
 // `<span text-block="true">...</span>`-style markup; unwrap to the raw value.
 export const stripHtml = (value) => (value ?? '').replaceAll(/<[^>]*>/g, '');
@@ -8,6 +8,17 @@ export const loadModule = async (cliName, modulePathSegment) => {
     const raw = await readFile(modulePath(cliName, modulePathSegment), 'utf8');
     return JSON.parse(raw);
 };
+// Lets a value like `authkey` be saved once (`docstar-cli config set <cliName> authkey <value>`)
+// instead of being passed on every command line; an explicit flag for the same name still wins.
+const loadCredentials = async (cliName) => {
+    try {
+        const savedConfig = JSON.parse(await readFile(configPath(), 'utf8'));
+        return savedConfig.collections.find((collection) => collection.cliName === cliName)?.credentials || {};
+    }
+    catch {
+        return {};
+    }
+};
 export const findEndpoint = (moduleJson, commandName) => moduleJson.endpoints.find((endpoint) => endpoint.cli.command.name === commandName || endpoint.cli.command.aliases.includes(commandName));
 const buildUrl = (endpoint, params) => {
     const baseUrl = stripHtml(endpoint.baseUrl);
@@ -56,6 +67,16 @@ const coerceToTemplateType = (existingValue, rawValue) => {
         }
         return rawValue.split(',').map((item) => item.trim());
     }
+    if (existingValue !== null && typeof existingValue === 'object') {
+        try {
+            const parsed = JSON.parse(rawValue);
+            if (typeof parsed === 'object' && parsed !== null)
+                return parsed;
+        }
+        catch {
+            // not a JSON object literal — fall through to the raw string
+        }
+    }
     return rawValue;
 };
 const buildBody = (endpoint, params) => {
@@ -81,9 +102,11 @@ export const executeCliCommand = async (cliName, modulePathSegment, commandName,
     if (!endpoint) {
         throw new Error(`No endpoint found for command "${commandName}" in module "${cliName} ${modulePathSegment}"`);
     }
-    const url = buildUrl(endpoint, params);
-    const headers = buildHeaders(endpoint, params);
-    const body = buildBody(endpoint, params);
+    const credentials = await loadCredentials(cliName);
+    const effectiveParams = { ...credentials, ...params };
+    const url = buildUrl(endpoint, effectiveParams);
+    const headers = buildHeaders(endpoint, effectiveParams);
+    const body = buildBody(endpoint, effectiveParams);
     const response = await fetch(url, {
         body,
         headers,

package/dist/lib/types.d.ts

@@ -54,6 +54,7 @@ export type CollectionConfig = {
     collectionId: string | null;
     modules: ModuleSummary[];
     updatedAt: string;
+    credentials?: Record<string, string>;
 };
 export type SavedConfig = {
     collections: CollectionConfig[];

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "docstar-cli",
   "description": "Call published DocStar API endpoints directly from your terminal, or expose them as MCP tools for AI clients.",
-  "version": "1.2.1",
+  "version": "1.4.0",
   "author": "Swayam Maheshwari",
   "bin": {
     "docstar-cli": "./bin/run.js"
@@ -27,7 +27,6 @@
     "eslint-config-prettier": "^10",
     "mocha": "^11",
     "oclif": "^4",
-    "shx": "^0.3.3",
     "ts-node": "^10",
     "typescript": "^5"
   },
@@ -36,8 +35,7 @@
   },
   "files": [
     "./bin",
-    "./dist",
-    "./oclif.manifest.json"
+    "./dist"
   ],
   "homepage": "https://github.com/swayammaheshwari/docstar-cli",
   "keywords": [
@@ -57,11 +55,10 @@
   },
   "repository": "swayammaheshwari/docstar-cli",
   "scripts": {
-    "build": "shx rm -rf dist && tsc -b",
+    "build": "tsc -b",
     "lint": "eslint",
-    "postpack": "shx rm -f oclif.manifest.json",
     "posttest": "npm run lint",
-    "prepack": "oclif manifest && oclif readme",
+    "prepack": "oclif readme",
     "test": "mocha --forbid-only \"test/**/*.test.ts\"",
     "version": "oclif readme && git add README.md"
   },

package/oclif.manifest.json

@@ -1,208 +0,0 @@
-{
-  "commands": {
-    "clean": {
-      "aliases": [],
-      "args": {
-        "collection": {
-          "description": "The collection (CLI name) to clean up, e.g. msg91",
-          "name": "collection",
-          "required": true
-        }
-      },
-      "description": "Uninstall modules from a collection, or the entire collection.\nBy default shows a checklist of the collection's installed modules to remove.\n`--all` targets the whole collection instead; combine with `--force` to skip the confirmation prompt.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> msg91                # pick modules to remove from \"msg91\"",
-        "<%= config.bin %> <%= command.id %> msg91 --all           # remove the whole \"msg91\" collection (asks to confirm)",
-        "<%= config.bin %> <%= command.id %> msg91 --all --force   # remove the whole \"msg91\" collection without asking"
-      ],
-      "flags": {
-        "all": {
-          "description": "Remove the entire collection instead of picking modules",
-          "name": "all",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "force": {
-          "description": "Skip the confirmation prompt (only relevant with --all)",
-          "name": "force",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "clean",
-      "pluginAlias": "docstar-cli",
-      "pluginName": "docstar-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "clean.js"
-      ]
-    },
-    "complete": {
-      "aliases": [],
-      "args": {
-        "collection": {
-          "name": "collection",
-          "required": true
-        },
-        "module": {
-          "name": "module",
-          "required": false
-        }
-      },
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hidden": true,
-      "hiddenAliases": [],
-      "id": "complete",
-      "pluginAlias": "docstar-cli",
-      "pluginName": "docstar-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "complete.js"
-      ]
-    },
-    "completion-script": {
-      "aliases": [],
-      "args": {},
-      "description": "Print a shell completion function that completes ONLY module names (once a collection is typed) and endpoint names (once a collection and module are typed).\nIt never completes the collection name itself, and never completes top-level commands like `list`/`init`/`mcp` — those are typed out by hand.",
-      "examples": [
-        "echo 'eval \"$(<%= config.bin %> <%= command.id %>)\"' >> ~/.bashrc  # or ~/.zshrc"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "completion-script",
-      "pluginAlias": "docstar-cli",
-      "pluginName": "docstar-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "completion-script.js"
-      ]
-    },
-    "init": {
-      "aliases": [],
-      "args": {
-        "domain": {
-          "description": "DocStar docs domain, e.g. docs.msg91.com or localhost:3000",
-          "name": "domain",
-          "required": true
-        }
-      },
-      "description": "Discover published modules for a DocStar docs site, pick which ones to install, and register their CLI commands.\nYou can run this against multiple docs sites/collections — each is kept separate under its own CLI name (`docstar-cli <cli-name> <module> <command>`).\nAfter installing, run `docstar-cli list` to see what got installed.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> docs.msg91.com",
-        "<%= config.bin %> <%= command.id %> localhost:3000 --collectionId paM4R4A26Hvb"
-      ],
-      "flags": {
-        "collectionId": {
-          "description": "Collection id (required when the domain is not a custom domain, e.g. localhost)",
-          "name": "collectionId",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "init",
-      "pluginAlias": "docstar-cli",
-      "pluginName": "docstar-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "init.js"
-      ]
-    },
-    "list": {
-      "aliases": [],
-      "args": {
-        "collection": {
-          "description": "Show modules installed for this collection (CLI name), e.g. msg91",
-          "name": "collection",
-          "required": false
-        },
-        "module": {
-          "description": "Show all endpoints for this module within the collection, e.g. slack",
-          "name": "module",
-          "required": false
-        }
-      },
-      "description": "List installed collections, the modules within one, or every endpoint of one module",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>              # list every installed collection",
-        "<%= config.bin %> <%= command.id %> --all        # same as above",
-        "<%= config.bin %> <%= command.id %> msg91         # list modules installed for the \"msg91\" collection",
-        "<%= config.bin %> <%= command.id %> msg91 slack   # list all of Slack's installed endpoints in \"msg91\""
-      ],
-      "flags": {
-        "all": {
-          "description": "List every installed collection (default when no arguments are given)",
-          "name": "all",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "list",
-      "pluginAlias": "docstar-cli",
-      "pluginName": "docstar-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "list.js"
-      ]
-    },
-    "mcp": {
-      "aliases": [],
-      "args": {},
-      "description": "Start an MCP (Model Context Protocol) server exposing every installed endpoint (across all installed collections) as a callable tool for AI clients (Claude Desktop, Claude Code, etc.).\nEvery tool follows the collection -> module -> endpoint hierarchy: e.g. collection \"msg91\" -> module \"slack\" -> endpoint \"send-message-1\" becomes the tool `msg91__slack__send-message-1`.\nRun `docstar-cli init <domain>` first so there is at least one installed module to expose.\nThis command does not exit on its own — it stays running and communicates over stdio for as long as the connecting AI client keeps the connection open.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "# Then register it in an MCP client config, e.g. .mcp.json:",
-        "# { \"mcpServers\": { \"docstar\": { \"command\": \"docstar-cli\", \"args\": [\"mcp\"] } } }"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "mcp",
-      "pluginAlias": "docstar-cli",
-      "pluginName": "docstar-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "mcp.js"
-      ]
-    }
-  },
-  "version": "1.2.1"
-}