@signaliz/cli 1.0.0

package/README.md

@@ -0,0 +1,29 @@
+# @signaliz/cli
+
+Command-line interface for Signaliz — deploy Ops, stream logs, manage API keys.
+
+## Install
+
+```bash
+npm install -g @signaliz/cli
+```
+
+## Configure
+
+```bash
+export SIGNALIZ_API_KEY=sk_...
+export SIGNALIZ_WORKSPACE_ID=00000000-0000-0000-0000-000000000000
+```
+
+## Usage
+
+```bash
+signaliz --help
+signaliz logs <run_id>
+signaliz deploy signaliz.yaml          # plan
+signaliz deploy signaliz.yaml --apply  # apply
+signaliz keys list
+signaliz keys create --name=ci --scopes=read:ops,write:ops --expires=90d
+signaliz keys rotate <key_id>
+signaliz keys revoke <key_id>
+```

package/dist/bin.js

@@ -0,0 +1,139 @@
+#!/usr/bin/env node
+"use strict";
+
+// src/bin.ts
+var import_node_fs = require("fs");
+var HELP = `signaliz <command> [args]
+
+Commands:
+  logs <run_id> [--since=ISO] [--filter=type1,type2]
+                              Stream run events (SSE) until the run ends.
+  deploy <file.yaml> [--apply] Plan (default) or apply a signaliz.yaml.
+  keys list                   List API keys for the current workspace.
+  keys create --name=NAME --scopes=read:ops,write:ops [--expires=30d|90d|1y|never]
+  keys rotate <key_id>
+  keys revoke <key_id>
+
+Environment:
+  SIGNALIZ_API_KEY            sk_... key (required)
+  SIGNALIZ_API_URL            override base URL (default: https://api.signaliz.com)
+  SIGNALIZ_WORKSPACE_ID       workspace UUID for keys/deploy commands
+`;
+function arg(name) {
+  const found = process.argv.find((a) => a.startsWith(`--${name}=`));
+  return found?.split("=").slice(1).join("=");
+}
+function requireKey() {
+  const key = process.env.SIGNALIZ_API_KEY;
+  if (!key) {
+    console.error("error: SIGNALIZ_API_KEY env var required");
+    process.exit(1);
+  }
+  return key;
+}
+function baseUrl() {
+  return process.env.SIGNALIZ_API_URL?.replace(/\/$/, "") || "https://api.signaliz.com";
+}
+async function streamLogs(runId) {
+  const key = requireKey();
+  const url = new URL(`${baseUrl()}/functions/v1/cli-log-stream`);
+  url.searchParams.set("run_id", runId);
+  const since = arg("since");
+  const filter = arg("filter");
+  if (since) url.searchParams.set("since", since);
+  if (filter) url.searchParams.set("filter", filter);
+  const res = await fetch(url, { headers: { Authorization: `Bearer ${key}` } });
+  if (!res.ok) {
+    console.error(`error: ${res.status} ${await res.text()}`);
+    process.exit(1);
+  }
+  if (!res.body) {
+    console.error("error: no response body");
+    process.exit(1);
+  }
+  const reader = res.body.getReader();
+  const decoder = new TextDecoder();
+  while (true) {
+    const { value, done } = await reader.read();
+    if (done) break;
+    process.stdout.write(decoder.decode(value));
+  }
+}
+async function deploy(file, applyMode) {
+  const key = requireKey();
+  const workspace_id = process.env.SIGNALIZ_WORKSPACE_ID;
+  if (!workspace_id) {
+    console.error("error: SIGNALIZ_WORKSPACE_ID env var required");
+    process.exit(1);
+  }
+  const yaml_text = (0, import_node_fs.readFileSync)(file, "utf8");
+  const fn = applyMode ? "yaml-apply" : "yaml-plan";
+  const res = await fetch(`${baseUrl()}/functions/v1/${fn}`, {
+    method: "POST",
+    headers: { Authorization: `Bearer ${key}`, "Content-Type": "application/json" },
+    body: JSON.stringify({ yaml_text, workspace_id, confirm: applyMode })
+  });
+  const data = await res.json();
+  console.log(JSON.stringify(data, null, 2));
+  if (!res.ok || data?.success === false) process.exit(1);
+}
+async function keys(sub, rest) {
+  const key = requireKey();
+  const workspace_id = process.env.SIGNALIZ_WORKSPACE_ID;
+  if (!workspace_id) {
+    console.error("error: SIGNALIZ_WORKSPACE_ID env var required");
+    process.exit(1);
+  }
+  const body = { action: sub, workspace_id };
+  if (sub === "create") {
+    body.name = arg("name");
+    body.scopes = (arg("scopes") || "").split(",").filter(Boolean);
+    body.expires_in = arg("expires") || "never";
+  } else if (sub === "rotate" || sub === "revoke") {
+    body.key_id = rest[0];
+  }
+  const res = await fetch(`${baseUrl()}/functions/v1/api-keys`, {
+    method: "POST",
+    headers: { Authorization: `Bearer ${key}`, "Content-Type": "application/json" },
+    body: JSON.stringify(body)
+  });
+  console.log(JSON.stringify(await res.json(), null, 2));
+  if (!res.ok) process.exit(1);
+}
+async function main() {
+  const [, , cmd, ...rest] = process.argv;
+  if (!cmd || cmd === "--help" || cmd === "-h") {
+    process.stdout.write(HELP);
+    return;
+  }
+  switch (cmd) {
+    case "logs":
+      if (!rest[0]) {
+        console.error("usage: signaliz logs <run_id>");
+        process.exit(1);
+      }
+      return streamLogs(rest[0]);
+    case "deploy":
+      if (!rest[0]) {
+        console.error("usage: signaliz deploy <file.yaml> [--apply]");
+        process.exit(1);
+      }
+      return deploy(rest[0], rest.includes("--apply"));
+    case "keys": {
+      const sub = rest[0];
+      if (!["list", "create", "rotate", "revoke"].includes(sub)) {
+        console.error("usage: signaliz keys <list|create|rotate|revoke> ...");
+        process.exit(1);
+      }
+      return keys(sub, rest.slice(1));
+    }
+    default:
+      console.error(`unknown command: ${cmd}`);
+      process.stdout.write(HELP);
+      process.exit(1);
+  }
+}
+main().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@signaliz/cli",
+  "version": "1.0.0",
+  "description": "Signaliz CLI — deploy Ops, stream logs, manage API keys.",
+  "bin": {
+    "signaliz": "./dist/bin.js"
+  },
+  "files": ["dist", "README.md"],
+  "scripts": {
+    "build": "tsup src/bin.ts --format cjs --clean",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": ["signaliz", "cli", "gtm", "ops"],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@signaliz/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0"
+  }
+}