@beel_es/cli 0.1.1 → 0.1.2

package/README.md

@@ -36,7 +36,7 @@ npx @beel_es/cli invoices export-excel --output invoices.xlsx
 npx @beel_es/cli --live invoices list          # production
 ```
 
-`--data` accepts inline JSON, `@file.json`, or `-` for stdin. Binary responses (PDF, ZIP, Excel) require `--output <path>`.
+`--data` accepts inline JSON, `@file.json`, or `-` for stdin. It is only **required** for endpoints whose request body is mandatory (e.g. `invoices create`); for lifecycle actions with an optional body (e.g. `invoices mark-paid`) it is optional, and verbs with no body (e.g. `invoices issue`) don't expose it at all. Each command's `--help` shows whether `--data` is required or optional. Binary responses (PDF, ZIP, Excel) require `--output <path>`.
 
 Discover everything with `--help` at any level: `beel --help`, `beel invoices --help`, `beel invoices list --help` (flags, enums and defaults come from the API spec).
 

package/dist/index.js

@@ -10797,7 +10797,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "@beel_es/cli",
-      version: "0.1.1",
+      version: "0.1.2",
       description: "Agent-first CLI for the BeeL invoicing API. Commands are derived at startup from the embedded OpenAPI spec. Run with npx @beel_es/cli \u2014 no install needed.",
       license: "MIT",
       type: "module",
@@ -10964,7 +10964,22 @@ function printJson(data) {
   process.stdout.write(`${JSON.stringify(data, null, 2)}
 `);
 }
+var INFO_CODES = /* @__PURE__ */ new Set(["commander.help", "commander.helpDisplayed", "commander.version"]);
+function commanderErrorToContract(error) {
+  if (INFO_CODES.has(error.code) || error.exitCode === 0) {
+    return { contract: null, exit: error.exitCode };
+  }
+  return { contract: { code: "USAGE_ERROR", message: stripErrorPrefix(error.message) }, exit: EXIT.USAGE };
+}
+function stripErrorPrefix(message) {
+  return message.replace(/^error:\s*/i, "");
+}
 function fail(error) {
+  if (error instanceof CommanderError) {
+    const { contract, exit } = commanderErrorToContract(error);
+    if (contract) writeError({ code: contract.code, message: contract.message });
+    process.exit(exit);
+  }
   if (error instanceof UsageError) {
     writeError({ code: "USAGE_ERROR", message: error.message });
     process.exit(EXIT.USAGE);
@@ -11081,10 +11096,11 @@ function buildQueryParams(doc, rawParams) {
 function deriveBody(doc, operation) {
   const requestBody = resolveRef(doc, operation.requestBody);
   const content = requestBody?.content;
-  if (!content) return null;
-  if ("application/json" in content) return "json";
-  if ("multipart/form-data" in content) return "multipart";
-  return null;
+  if (!content) return { kind: null, required: false };
+  const required = requestBody?.required === true;
+  if ("application/json" in content) return { kind: "json", required };
+  if ("multipart/form-data" in content) return { kind: "multipart", required };
+  return { kind: null, required: false };
 }
 function deriveBinaryResponse(doc, operation) {
   const responses = operation.responses ?? {};
@@ -11107,6 +11123,7 @@ function buildManifest(doc) {
       const operation = pathItem[method];
       if (!operation || typeof operation.operationId !== "string") continue;
       const group = deriveGroup(path);
+      const body = deriveBody(doc, operation);
       commands.push({
         group,
         action: deriveAction(group, operation.operationId, method, path),
@@ -11116,7 +11133,8 @@ function buildManifest(doc) {
         operationId: operation.operationId,
         pathParams: extractPathParams(path),
         queryParams: buildQueryParams(doc, [...sharedParams, ...operation.parameters ?? []]),
-        body: deriveBody(doc, operation),
+        body: body.kind,
+        bodyRequired: body.required,
         binaryResponse: deriveBinaryResponse(doc, operation)
       });
     }
@@ -11260,7 +11278,10 @@ function registerCommand(group, spec) {
     else sub.option(flag, description);
   }
   if (spec.body === "json") {
-    sub.requiredOption("--data <json>", "JSON body: inline, @file.json, or - for stdin");
+    const hint = spec.bodyRequired ? "JSON body (required)" : "JSON body (optional)";
+    const description = `${hint}: inline, @file.json, or - for stdin`;
+    if (spec.bodyRequired) sub.requiredOption("--data <json>", description);
+    else sub.option("--data <json>", description);
   }
   if (spec.binaryResponse) {
     sub.requiredOption("--output <path>", "Write the binary response to this file");
@@ -11511,6 +11532,9 @@ var { version } = require_package();
 var program2 = new Command("beel").description(
   "BeeL invoicing API CLI. JSON output on stdout, errors on stderr. Sandbox by default; pass --live for production."
 ).version(version).option("--live", "Use the live (production) API key instead of the test one");
+program2.exitOverride();
+program2.configureOutput({ outputError: () => {
+} });
 registerLogin(program2);
 registerConfig(program2);
 registerRequest(program2);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@beel_es/cli",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Agent-first CLI for the BeeL invoicing API. Commands are derived at startup from the embedded OpenAPI spec. Run with npx @beel_es/cli — no install needed.",
   "license": "MIT",
   "type": "module",