@shieldz/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Deniz Yanbollu / Shieldz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,20 @@
+# @shieldz/cli
+
+[![npm](https://img.shields.io/npm/v/@shieldz/cli.svg)](https://www.npmjs.com/package/@shieldz/cli)
+
+Command-line interface for [Shieldz](https://shieldz.cash) — non-custodial crypto payments.
+
+```bash
+npm install -g @shieldz/cli
+export SHIELDZ_API_KEY=sk_live_…
+
+shieldz invoices create --amount 5000 --memo "Order #1234"
+shieldz invoices get <id>
+shieldz invoices list --status paid --limit 10
+```
+
+Or run without installing: `npx @shieldz/cli invoices list`.
+
+## License
+
+MIT © Deniz Yanbollu / Shieldz

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+import Shieldz, { ShieldzError } from "@shieldz/sdk";
+const VERSION = "0.1.0";
+function parseFlags(args) {
+    const out = {};
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (a.startsWith("--")) {
+            const key = a.slice(2);
+            const next = args[i + 1];
+            if (next && !next.startsWith("--")) {
+                out[key] = next;
+                i++;
+            }
+            else {
+                out[key] = true;
+            }
+        }
+    }
+    return out;
+}
+function client() {
+    const key = process.env.SHIELDZ_API_KEY;
+    if (!key) {
+        console.error("shieldz: set SHIELDZ_API_KEY (sk_live_… or sk_test_…)");
+        process.exit(1);
+    }
+    return new Shieldz(key);
+}
+const HELP = `shieldz ${VERSION} — non-custodial crypto payments
+
+Usage:
+  shieldz invoices create --amount <usd_cents> [--memo <text>] [--email <addr>]
+  shieldz invoices get <id>
+  shieldz invoices list [--limit <n>] [--status <pending|paid|expired|failed>]
+
+Auth: set SHIELDZ_API_KEY in your environment.
+Docs: https://shieldz.cash/docs`;
+async function main() {
+    const [, , ...argv] = process.argv;
+    const [group, action, ...rest] = argv;
+    if (!group || group === "--help" || group === "-h" || group === "help") {
+        console.log(HELP);
+        return;
+    }
+    if (group === "--version" || group === "-v") {
+        console.log(VERSION);
+        return;
+    }
+    if (group === "invoices") {
+        const shieldz = client();
+        const flags = parseFlags(rest);
+        if (action === "create") {
+            const amount = Number(flags.amount);
+            if (!Number.isInteger(amount)) {
+                console.error("shieldz: --amount <usd_cents> is required (integer)");
+                process.exit(1);
+            }
+            const inv = await shieldz.invoices.create({
+                amount_usd_cents: amount,
+                ...(flags.memo ? { memo: String(flags.memo) } : {}),
+                ...(flags.email ? { customer_email: String(flags.email) } : {}),
+            });
+            console.log(JSON.stringify(inv, null, 2));
+            return;
+        }
+        if (action === "get") {
+            const id = rest[0];
+            if (!id) {
+                console.error("shieldz: invoices get <id>");
+                process.exit(1);
+            }
+            console.log(JSON.stringify(await shieldz.invoices.retrieve(id), null, 2));
+            return;
+        }
+        if (action === "list") {
+            const page = await shieldz.invoices.list({
+                ...(flags.limit ? { limit: Number(flags.limit) } : {}),
+                ...(flags.status ? { status: String(flags.status) } : {}),
+            });
+            console.log(JSON.stringify(page, null, 2));
+            return;
+        }
+    }
+    console.error(`shieldz: unknown command. Run \`shieldz --help\`.`);
+    process.exit(1);
+}
+main().catch((err) => {
+    if (err instanceof ShieldzError) {
+        console.error(`shieldz: error ${err.status} ${err.type}/${err.code}: ${err.message}`);
+    }
+    else {
+        console.error("shieldz:", err instanceof Error ? err.message : err);
+    }
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@shieldz/cli",
+  "version": "0.1.0",
+  "description": "Command-line interface for Shieldz — create and inspect non-custodial crypto payment invoices from your terminal.",
+  "type": "module",
+  "bin": { "shieldz": "dist/index.js" },
+  "files": ["dist", "README.md", "LICENSE"],
+  "engines": { "node": ">=18" },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": ["shieldz", "cli", "crypto", "payments", "non-custodial", "invoices"],
+  "license": "MIT",
+  "author": "Deniz Yanbollu (@dnzynbl)",
+  "homepage": "https://shieldz.cash",
+  "repository": { "type": "git", "url": "git+https://github.com/ShieldZCash/shieldz-cli.git" },
+  "bugs": { "url": "https://github.com/ShieldZCash/shieldz-cli/issues" },
+  "dependencies": { "@shieldz/sdk": "^0.2.0" },
+  "devDependencies": { "typescript": "^5.6.0", "@types/node": "^20.0.0" }
+}