@hardfin/cli 0.1.1-dev.56 → 0.1.1-dev.57

package/README.md

@@ -143,6 +143,31 @@ An agent branches on `code`. A code is never renamed and never changes meaning,
 message may be reworded at any time. `hardfin agent-guide` lists every code with what it
 means, and `src/output/failure.ts` defines them.
 
+### Calling an endpoint no command covers
+
+`hardfin api` calls any path under the API. It takes the same parts a generated command does,
+named by hand.
+
+```sh
+hardfin api /customer -f page=2 -f limit=50                    # query parameters
+hardfin api -X PATCH /item/item_V1StGXR8Z5jdHi6B --input body.json   # a JSON body
+hardfin api /file/file_7hq2mx9pkr4stz8w --output photo.jpg      # a download
+hardfin api -X POST /file --file photo.jpg -F fileType=ASSET_FILE   # an upload, as multipart
+hardfin api /file/file_7hq2mx9pkr4stz8w -H 'If-None-Match: "abc"' --output photo.jpg
+```
+
+| Flag               | Sends                                                                              |
+| ------------------ | ---------------------------------------------------------------------------------- |
+| `-f key=value`     | A query parameter, repeatable                                                      |
+| `--input <path>`   | A JSON body, from a file or `-` for standard input                                 |
+| `--file <path>`    | A file as multipart, under the part name `data` unless `--file-part` names another |
+| `-F key=value`     | A field beside the file, repeatable                                                |
+| `-H "Name: value"` | A request header, repeatable                                                       |
+| `--output <path>`  | Nothing. It writes the file the endpoint answers with, or `-` for standard output  |
+
+A header cannot set `Authorization`, `X-API-Key` or `X-API-Version`, which come from your sign
+in and settings. `--file` and `--input` cannot be given together.
+
 ### Reading the commands from a program
 
 `hardfin agent-guide` describes the CLI to an agent, as Markdown or as JSON. Name a command to

package/dist/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="ec88336e-026f-5a04-9acd-43c5410c3229")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="1c7d3a24-925a-543e-a2eb-caf5f5968ada")}catch(e){}}();
 import module from "node:module";
 //#region src/cli.ts
 module.enableCompileCache?.();
@@ -14,7 +14,7 @@ process.on("unhandledRejection", (error) => void toCrash(error));
 try {
 	const answer = await toQuickAnswer(process.argv.slice(2));
 	if (answer === void 0) {
-		const { toCli, toParseExitCode, wasReportAttempted } = await import("./program-CI4W2agw.js");
+		const { toCli, toParseExitCode, wasReportAttempted } = await import("./program-PaNgBWFL.js");
 		try {
 			await toCli().parseAsync(process.argv);
 		} catch (error) {
@@ -33,7 +33,7 @@ async function toCrash(error) {
 	isCrashing = true;
 	const isJSON = process.argv.includes("--json") || !process.stdout.isTTY;
 	try {
-		const { toReported, writeCrash } = await import("./program-CI4W2agw.js");
+		const { toReported, writeCrash } = await import("./program-PaNgBWFL.js");
 		writeCrash(error, isJSON);
 		await toReported(error, isJSON, void 0, "fatal");
 	} catch {
@@ -54,4 +54,4 @@ async function toQuickAnswer(args) {
 export {};
 
 //# sourceMappingURL=cli.js.map
-//# debugId=ec88336e-026f-5a04-9acd-43c5410c3229
+//# debugId=1c7d3a24-925a-543e-a2eb-caf5f5968ada

package/dist/completion-tree.json

@@ -2566,6 +2566,35 @@
           "description": "A file holding the JSON request body, or - for stdin",
           "valueName": "file"
         },
+        {
+          "name": "file",
+          "description": "A file to upload as multipart, in place of a JSON body",
+          "valueName": "path"
+        },
+        {
+          "name": "file-part",
+          "description": "The name of the part the file is sent as, which is data when not given",
+          "valueName": "name"
+        },
+        {
+          "name": "form",
+          "short": "F",
+          "description": "A field sent beside the file as key=value, repeatable",
+          "valueName": "key=value",
+          "repeatable": true
+        },
+        {
+          "name": "header",
+          "short": "H",
+          "description": "A request header as Name: value, repeatable",
+          "valueName": "name: value",
+          "repeatable": true
+        },
+        {
+          "name": "output",
+          "description": "Where to write a file the endpoint answers with, or - for standard output",
+          "valueName": "path"
+        },
         {
           "name": "json",
           "description": "Print machine-readable output, which is the default when stdout is not a terminal"