calabasas 0.22.0 → 0.23.0

package/dist/index.js

@@ -7834,6 +7834,164 @@ Run ${pc3.cyan("`calabasas init`")} first.`);
   await interactiveConfig(currentConfig, configPath);
 }
 
+// src/commands/webhook.ts
+import pc4 from "picocolors";
+function resolveAuthOrExit() {
+  const resolved = resolvePlatformApiKey({});
+  if (!resolved) {
+    console.error(pc4.red("Error:") + ` no Calabasas credentials found.
+` + "  Run `calabasas login` (user key) or set CALABASAS_PLATFORM_API_KEY in .env.local.");
+    process.exit(1);
+  }
+  return resolved.key;
+}
+function parseDuration(input) {
+  const match = /^(\d+)(s|m|h|d)$/.exec(input.trim());
+  if (!match)
+    return null;
+  const value = Number(match[1]);
+  const unit = match[2];
+  const multipliers = {
+    s: 1000,
+    m: 60000,
+    h: 3600000,
+    d: 86400000
+  };
+  return value * multipliers[unit];
+}
+function normalizeCreateInput(options, now = Date.now()) {
+  if (!options.bot) {
+    return { ok: false, error: "--bot <botId> is required" };
+  }
+  if (options.action !== "sendDM" && options.action !== "sendChannelMessage") {
+    return {
+      ok: false,
+      error: `invalid --action: ${options.action ?? "(missing)"}. Must be one of: sendDM, sendChannelMessage`
+    };
+  }
+  let params;
+  if (options.action === "sendDM") {
+    if (!options.userId) {
+      return { ok: false, error: "--user-id <discordUserId> is required for sendDM" };
+    }
+    params = { userId: options.userId };
+  } else {
+    if (!options.channelId) {
+      return {
+        ok: false,
+        error: "--channel-id <discordChannelId> is required for sendChannelMessage"
+      };
+    }
+    params = { channelId: options.channelId };
+  }
+  let maxUses;
+  if (options.maxUses !== undefined) {
+    const parsed = Number(options.maxUses);
+    if (!Number.isFinite(parsed) || parsed <= 0 || !Number.isInteger(parsed)) {
+      return {
+        ok: false,
+        error: `invalid --max-uses: ${options.maxUses}. Must be a positive integer.`
+      };
+    }
+    maxUses = parsed;
+  }
+  let expiresAt;
+  if (options.expires !== undefined) {
+    const ms = parseDuration(options.expires);
+    if (ms === null) {
+      return {
+        ok: false,
+        error: `invalid --expires: ${options.expires}. Format: <number><unit> where unit is s|m|h|d (e.g. 30m, 24h, 7d).`
+      };
+    }
+    expiresAt = now + ms;
+  }
+  return {
+    ok: true,
+    payload: {
+      botId: options.bot,
+      action: options.action,
+      params,
+      label: options.label,
+      maxUses,
+      expiresAt,
+      platformId: options.platformId
+    }
+  };
+}
+async function webhookCreate(options) {
+  const apiKey = resolveAuthOrExit();
+  const result = normalizeCreateInput(options);
+  if (!result.ok) {
+    console.error(pc4.red("Error:") + " " + result.error);
+    process.exit(1);
+  }
+  const { payload } = result;
+  const { ok, data, status } = await platformApiRequest("POST", "/api/cli/webhooks", apiKey, payload);
+  if (!ok) {
+    const errMsg = data?.error ?? `HTTP ${status}`;
+    console.error(pc4.red("Error:") + " " + errMsg);
+    process.exit(1);
+  }
+  const created = data;
+  console.log(pc4.green("Webhook created."));
+  console.log("");
+  console.log(`URL: ${pc4.cyan(created.url)}`);
+  console.log(`token: ${created.token}`);
+  console.log(`webhookId: ${created.webhookId}`);
+  console.log(`action: ${created.action}`);
+  console.log(`params: ${JSON.stringify(created.params)}`);
+  if (payload.label)
+    console.log(`label: ${payload.label}`);
+  if (payload.maxUses !== undefined)
+    console.log(`maxUses: ${payload.maxUses}`);
+  if (payload.expiresAt !== undefined) {
+    console.log(`expiresAt: ${new Date(payload.expiresAt).toISOString()}`);
+  }
+  console.log("");
+  console.log(pc4.dim(`Fire it with: curl -X POST -H 'Content-Type: application/json' -d '{"content":"hi"}' ` + created.url));
+}
+async function webhookList(options) {
+  const apiKey = resolveAuthOrExit();
+  const { ok, data, status } = await platformApiRequest("GET", "/api/cli/webhooks", apiKey);
+  if (!ok) {
+    const errMsg = data?.error ?? `HTTP ${status}`;
+    console.error(pc4.red("Error:") + " " + errMsg);
+    process.exit(1);
+  }
+  const webhooks = data.webhooks;
+  if (options.json) {
+    console.log(JSON.stringify(webhooks, null, 2));
+    return;
+  }
+  if (webhooks.length === 0) {
+    console.log("No webhooks found.");
+    console.log(pc4.dim("Create one with: calabasas webhook create --bot <id> --action sendDM --user-id <id>"));
+    return;
+  }
+  for (const w of webhooks) {
+    const target = w.params.userId ? `user ${w.params.userId}` : `channel ${w.params.channelId}`;
+    const uses = w.maxUses !== undefined ? `${w.usageCount}/${w.maxUses}` : `${w.usageCount}/—`;
+    const statusColor = w.status === "active" ? pc4.green : w.status === "expired" ? pc4.yellow : pc4.red;
+    console.log(`${pc4.cyan(w.token)}  ${w.action}  ${target}  uses=${uses}  ${statusColor(w.status)}` + (w.label ? `  label=${w.label}` : ""));
+    console.log(`  ${pc4.dim(w.url)}`);
+  }
+}
+async function webhookRevoke(token, _options) {
+  if (!token) {
+    console.error(pc4.red("Error:") + " token argument is required.");
+    process.exit(1);
+  }
+  const apiKey = resolveAuthOrExit();
+  const { ok, data, status } = await platformApiRequest("DELETE", `/api/cli/webhooks?token=${encodeURIComponent(token)}`, apiKey);
+  if (!ok) {
+    const errMsg = data?.error ?? `HTTP ${status}`;
+    console.error(pc4.red("Error:") + " " + errMsg);
+    process.exit(1);
+  }
+  console.log(pc4.green("Webhook revoked."));
+}
+
 // src/index.ts
 var dashboard = async () => {
   const mod = await import("./dashboard-a862sabz.js");
@@ -7870,4 +8028,8 @@ platformCmd.command("info").description("Show platform info (secret, URL, API ke
 platformCmd.command("set-url").description("Set Convex URL for your platform").action(platformSetUrl);
 platformCmd.command("rotate-key").description("Rotate your platform API key (for SDK access)").action(platformRotateKey);
 platformCmd.command("rotate-secret").description("Rotate the platform secret (invalidates CALABASAS_SECRET)").action(platformRotateSecret);
+var webhookCmd = program2.command("webhook").description("Manage one-off webhook URLs that fire pre-bound Discord actions");
+webhookCmd.command("create").description("Create a webhook URL bound to a single bot, action, and target").requiredOption("-b, --bot <botId>", "Bot ID that will perform the action").requiredOption("-a, --action <action>", "Action to fire: sendDM | sendChannelMessage").option("--user-id <discordUserId>", "Target user ID (required for sendDM)").option("--channel-id <discordChannelId>", "Target channel ID (required for sendChannelMessage)").option("--label <label>", "Human-readable label for listing").option("--max-uses <number>", "Max times this URL can be fired before it stops working").option("--expires <duration>", "Auto-expire after duration: e.g. 30m, 24h, 7d").option("--platform-id <id>", "Platform ID (only needed with user key + multiple platforms)").action(webhookCreate);
+webhookCmd.command("list").alias("ls").description("List all non-revoked webhooks for the current platform").option("--json", "Output raw JSON instead of a table").action(webhookList);
+webhookCmd.command("revoke <token>").description("Revoke a webhook by token (soft delete)").option("-y, --yes", "Skip confirmation prompt (currently a no-op)").action(webhookRevoke);
 program2.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "calabasas",
-  "version": "0.22.0",
+  "version": "0.23.0",
   "description": "CLI for Calabasas - Discord Gateway as a Service for Convex",
   "type": "module",
   "bin": {