@tarout/cli 0.2.1 → 0.3.0

package/README.md

@@ -39,6 +39,28 @@ tarout deploy --wait --source upload
 # The first deploy prompts to create or link an app, and to create detected resources.
 ```
 
+## Call any API (`tarout call`)
+
+Beyond the curated commands, `tarout call` reaches **every** platform procedure
+directly — the same control surface exposed via REST and MCP:
+
+```bash
+tarout call --list                 # discover all callable procedures + type
+tarout call application.create --input '{"name":"my-app"}' --json
+tarout call deployment.all --input '{"applicationId":"app_123"}'
+```
+
+## MCP (agent access)
+
+Connect Claude Desktop / Cursor to Tarout via the bundled `tarout-mcp` bridge:
+
+```json
+{ "mcpServers": { "tarout": { "command": "tarout-mcp" } } }
+```
+
+Hosted agents can hit the Streamable-HTTP endpoint `/api/mcp` directly with an
+`x-api-key` header. See [`docs/MCP.md`](../docs/MCP.md).
+
 ## Commands
 
 ### Authentication

package/bin/tarout-mcp

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+import('../dist/mcp/stdio.js');

package/dist/{api-SHKZO2SZ.js → api-QAKANRFX.js}

@@ -2,8 +2,9 @@ import {
   createApiClient,
   getApiClient,
   resetApiClient
-} from "./chunk-FKX4CRPL.js";
-import "./chunk-FS74WWHV.js";
+} from "./chunk-NHNK5ZQ5.js";
+import "./chunk-5DAFGMBH.js";
+import "./chunk-KL3JNPAY.js";
 export {
   createApiClient,
   getApiClient,

package/dist/billing-GUA4S2Y4.js

@@ -0,0 +1,12 @@
+import {
+  pollCheckoutUntilTerminal,
+  registerBillingCommands
+} from "./chunk-BS6DFVSU.js";
+import "./chunk-NHNK5ZQ5.js";
+import "./chunk-5DAFGMBH.js";
+import "./chunk-CJMIX35A.js";
+import "./chunk-KL3JNPAY.js";
+export {
+  pollCheckoutUntilTerminal,
+  registerBillingCommands
+};

package/dist/chunk-5DAFGMBH.js

@@ -0,0 +1,137 @@
+// src/lib/config.ts
+import Conf from "conf";
+import {
+  chmodSync,
+  existsSync,
+  mkdirSync,
+  readFileSync,
+  rmSync,
+  writeFileSync
+} from "fs";
+import { join } from "path";
+var config = new Conf({
+  projectName: "tarout",
+  configFileMode: 384,
+  defaults: {
+    currentProfile: "default",
+    profiles: {}
+  }
+});
+function getConfig() {
+  return config.store;
+}
+function getCurrentProfile() {
+  const cfg = getConfig();
+  return cfg.profiles[cfg.currentProfile] || null;
+}
+function setProfile(name, profile) {
+  config.set(`profiles.${name}`, profile);
+}
+function setCurrentProfile(name) {
+  config.set("currentProfile", name);
+}
+function clearConfig() {
+  config.clear();
+}
+function isLoggedIn() {
+  const profile = getCurrentProfile();
+  return profile !== null && !!profile.token || !!process.env.TAROUT_TOKEN;
+}
+function getToken() {
+  const profile = getCurrentProfile();
+  return profile?.token || process.env.TAROUT_TOKEN || null;
+}
+function getApiUrl() {
+  const profile = getCurrentProfile();
+  return profile?.apiUrl || process.env.TAROUT_API_URL || "https://tarout.sa";
+}
+function updateProfile(updates) {
+  const cfg = getConfig();
+  const currentProfileName = cfg.currentProfile;
+  const currentProfile = cfg.profiles[currentProfileName];
+  if (currentProfile) {
+    config.set(`profiles.${currentProfileName}`, {
+      ...currentProfile,
+      ...updates
+    });
+  }
+}
+var PROJECT_CONFIG_DIR = ".tarout";
+var PROJECT_CONFIG_FILE = "project.json";
+function chmodIfSupported(path, mode) {
+  try {
+    chmodSync(path, mode);
+  } catch {
+  }
+}
+function getProjectConfigDir(basePath) {
+  const base = basePath || process.cwd();
+  return join(base, PROJECT_CONFIG_DIR);
+}
+function getProjectConfigPath(basePath) {
+  return join(getProjectConfigDir(basePath), PROJECT_CONFIG_FILE);
+}
+function isProjectLinked(basePath) {
+  return existsSync(getProjectConfigPath(basePath));
+}
+function getProjectConfig(basePath) {
+  const configPath = getProjectConfigPath(basePath);
+  if (!existsSync(configPath)) {
+    return null;
+  }
+  try {
+    const content = readFileSync(configPath, "utf-8");
+    return JSON.parse(content);
+  } catch {
+    return null;
+  }
+}
+function setProjectConfig(config2, basePath) {
+  const configDir = getProjectConfigDir(basePath);
+  const configPath = getProjectConfigPath(basePath);
+  if (!existsSync(configDir)) {
+    mkdirSync(configDir, { recursive: true, mode: 448 });
+  }
+  chmodIfSupported(configDir, 448);
+  writeFileSync(configPath, JSON.stringify(config2, null, 2), {
+    encoding: "utf-8",
+    mode: 384
+  });
+  chmodIfSupported(configPath, 384);
+  const gitignorePath = join(configDir, ".gitignore");
+  if (!existsSync(gitignorePath)) {
+    writeFileSync(
+      gitignorePath,
+      "# Ignore local tarout config\n*\n!.gitignore\n",
+      { encoding: "utf-8", mode: 384 }
+    );
+    chmodIfSupported(gitignorePath, 384);
+  }
+}
+function removeProjectConfig(basePath) {
+  const configDir = getProjectConfigDir(basePath);
+  if (!existsSync(configDir)) {
+    return false;
+  }
+  try {
+    rmSync(configDir, { recursive: true, force: true });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+export {
+  getCurrentProfile,
+  setProfile,
+  setCurrentProfile,
+  clearConfig,
+  isLoggedIn,
+  getToken,
+  getApiUrl,
+  updateProfile,
+  isProjectLinked,
+  getProjectConfig,
+  setProjectConfig,
+  removeProjectConfig
+};

package/dist/{chunk-XSJKHLNL.js → chunk-BS6DFVSU.js}

@@ -1,13 +1,15 @@
 import {
   AuthError,
   getApiClient,
-  handleError,
+  handleError
+} from "./chunk-NHNK5ZQ5.js";
+import {
   isLoggedIn
-} from "./chunk-FKX4CRPL.js";
+} from "./chunk-5DAFGMBH.js";
 import {
   confirm,
   select
-} from "./chunk-J3H7LTFT.js";
+} from "./chunk-CJMIX35A.js";
 import {
   ExitCode,
   box,
@@ -20,9 +22,10 @@ import {
   outputJsonLine,
   shouldSkipConfirmation,
   table
-} from "./chunk-FS74WWHV.js";
+} from "./chunk-KL3JNPAY.js";
 
 // src/commands/billing.ts
+import { InvalidArgumentError } from "commander";
 import open from "open";
 
 // src/utils/spinner.ts
@@ -153,10 +156,22 @@ function registerBillingCommands(program) {
       handleError(err);
     }
   });
-  billing.command("upgrade").argument("[plan]", "Plan key to switch to").description("Upgrade or change subscription plan").option(
+  billing.command("upgrade").argument("[plan]", "Plan key to switch to (alias: --plan)").description("Upgrade or change subscription plan").option(
+    "--plan <key>",
+    "Plan key (alias for the positional argument; useful for agent invocations)"
+  ).option(
     "-q, --quantity <n>",
     "Plan quantity (for multi-slot plans)",
     Number.parseInt
+  ).option(
+    "--billing-period <period>",
+    "Billing period: monthly or yearly (yearly = 10\xD7 monthly, 2 months free)",
+    parseBillingPeriod
+  ).option(
+    "--addon <key[:qty]>",
+    "Bundled addon to purchase with the plan change (repeatable, e.g. --addon db.standard:2)",
+    collectAddon,
+    []
   ).option(
     "-w, --wait",
     "After hosted-checkout opens, poll status until the payment is confirmed"
@@ -172,7 +187,9 @@ function registerBillingCommands(program) {
     try {
       if (!isLoggedIn()) throw new AuthError();
       const client = getApiClient();
-      let targetPlan = planKey;
+      let targetPlan = planKey || options.plan;
+      const billingPeriod = options.billingPeriod;
+      const addons = Array.isArray(options.addon) && options.addon.length > 0 ? options.addon : void 0;
       if (!targetPlan) {
         const _spinner = startSpinner("Fetching plans...");
         const catalog = await client.subscription.getCatalog.query();
@@ -187,15 +204,30 @@ function registerBillingCommands(program) {
           plans.map((p) => ({
             name: `${p.planKey || p.key || p.name} ${p.priceHalalas ? `(${(p.priceHalalas / 100).toFixed(2)} SAR/mo)` : "(Free)"}`,
             value: p.planKey || p.key || p.name
-          }))
+          })),
+          {
+            field: "plan",
+            flag: "--plan",
+            context: {
+              available: plans.map((p) => ({
+                key: p.planKey || p.key || p.name,
+                priceHalalas: p.priceHalalas ?? 0
+              }))
+            }
+          }
         );
       }
+      if (!targetPlan) {
+        throw new Error("No plan selected");
+      }
       const _previewSpinner = startSpinner("Calculating change...");
       let preview;
       try {
         preview = await client.subscription.previewPlanChange.query({
           planKey: targetPlan,
-          planQuantity: options.quantity
+          planQuantity: options.quantity,
+          billingPeriod,
+          addons
         });
         succeedSpinner();
       } catch {
@@ -206,6 +238,12 @@ function registerBillingCommands(program) {
         log("");
         log(`Plan: ${colors.cyan(targetPlan)}`);
         if (options.quantity) log(`Quantity: ${options.quantity}`);
+        if (billingPeriod) log(`Billing period: ${billingPeriod}`);
+        if (addons && addons.length > 0) {
+          log(
+            `Addons: ${addons.map((a) => `${a.addonKey}\xD7${a.quantity}`).join(", ")}`
+          );
+        }
         if (preview?.amountDue !== void 0) {
           log(
             `Amount due now: ${colors.bold(`${(preview.amountDue / 100).toFixed(2)} SAR`)}`
@@ -214,7 +252,18 @@ function registerBillingCommands(program) {
         log("");
         const confirmed = await confirm(
           `Switch to plan "${targetPlan}"?`,
-          false
+          false,
+          {
+            field: "confirm_upgrade",
+            flag: "--yes",
+            context: {
+              plan: targetPlan,
+              quantity: options.quantity,
+              billingPeriod,
+              addons,
+              amountDueHalalas: preview?.amountDue
+            }
+          }
         );
         if (!confirmed) {
           log("Cancelled.");
@@ -224,7 +273,9 @@ function registerBillingCommands(program) {
       const _changeSpinner = startSpinner("Changing plan...");
       const result = await client.subscription.changePlan.mutate({
         planKey: targetPlan,
-        planQuantity: options.quantity
+        planQuantity: options.quantity,
+        billingPeriod,
+        addons
       });
       succeedSpinner("Plan changed!");
       if (result?.applied) {
@@ -369,6 +420,14 @@ function registerBillingCommands(program) {
     try {
       if (!isLoggedIn()) throw new AuthError();
       const client = getApiClient();
+      if (isJsonMode()) {
+        outputJsonLine({
+          type: "event",
+          event: "checkout_polling_started",
+          orderId,
+          timeoutSeconds: options.timeout
+        });
+      }
       const final = await pollCheckoutUntilTerminal(client, orderId, {
         timeoutMs: options.timeout * 1e3,
         intervalMs: 4e3
@@ -414,7 +473,8 @@ function registerBillingCommands(program) {
         log("");
         const confirmed = await confirm(
           "Are you sure you want to cancel your subscription?",
-          false
+          false,
+          { field: "confirm_cancel", flag: "--yes" }
         );
         if (!confirmed) {
           log("Cancelled.");
@@ -472,7 +532,12 @@ function registerBillingCommands(program) {
         log("");
         const confirmed = await confirm(
           `Add addon "${addonKey}" \xD7 ${quantity}?`,
-          false
+          false,
+          {
+            field: "confirm_addon_add",
+            flag: "--yes",
+            context: { addonKey, quantity }
+          }
         );
         if (!confirmed) {
           log("Cancelled.");
@@ -503,7 +568,15 @@ function registerBillingCommands(program) {
     try {
       if (!isLoggedIn()) throw new AuthError();
       if (!shouldSkipConfirmation()) {
-        const confirmed = await confirm(`Remove addon "${addonKey}"?`, false);
+        const confirmed = await confirm(
+          `Remove addon "${addonKey}"?`,
+          false,
+          {
+            field: "confirm_addon_remove",
+            flag: "--yes",
+            context: { addonKey }
+          }
+        );
         if (!confirmed) {
           log("Cancelled.");
           return;
@@ -584,7 +657,11 @@ function registerBillingCommands(program) {
       if (!shouldSkipConfirmation()) {
         log(`
 Purchase ${quantity}\xD7 ${colors.cyan(addonKey)}?`);
-        const confirmed = await confirm("Proceed?", false);
+        const confirmed = await confirm("Proceed?", false, {
+          field: "confirm_addon_buy",
+          flag: "--yes",
+          context: { addonKey, quantity }
+        });
         if (!confirmed) {
           log("Cancelled.");
           return;
@@ -614,7 +691,8 @@ Payment required: ${colors.cyan(result.paymentUrl)}
       if (!shouldSkipConfirmation()) {
         const confirmed = await confirm(
           "Cancel the pending plan change?",
-          false
+          false,
+          { field: "confirm_pending_cancel", flag: "--yes" }
         );
         if (!confirmed) {
           log("Cancelled.");
@@ -867,6 +945,29 @@ async function pollCheckoutUntilTerminal(client, orderId, opts) {
     failureReason: r.failureReason
   };
 }
+function collectAddon(value, previous) {
+  const [rawKey, rawQty] = value.split(":");
+  const addonKey = (rawKey || "").trim();
+  if (!addonKey) {
+    throw new InvalidArgumentError(
+      `Invalid --addon value "${value}". Expected key[:qty] (e.g. db.standard:2).`
+    );
+  }
+  const quantity = rawQty === void 0 ? 1 : Number.parseInt(rawQty, 10);
+  if (!Number.isFinite(quantity) || quantity <= 0) {
+    throw new InvalidArgumentError(
+      `Invalid --addon quantity in "${value}". Expected a positive integer.`
+    );
+  }
+  return [...previous, { addonKey, quantity }];
+}
+function parseBillingPeriod(raw) {
+  const v = raw.toLowerCase();
+  if (v === "monthly" || v === "yearly") return v;
+  throw new InvalidArgumentError(
+    `Invalid --billing-period "${raw}". Expected "monthly" or "yearly".`
+  );
+}
 function formatSubStatus(status) {
   const map = {
     active: colors.success("active"),

package/dist/chunk-CJMIX35A.js

@@ -0,0 +1,127 @@
+import {
+  ExitCode,
+  exit,
+  isJsonMode,
+  isNonInteractiveMode,
+  outputNeedsInput
+} from "./chunk-KL3JNPAY.js";
+
+// src/utils/prompts.ts
+import inquirer from "inquirer";
+function emitNeedsInputAndExit(descriptor, rest) {
+  outputNeedsInput({ ...descriptor, ...rest });
+  exit(ExitCode.NEEDS_INPUT);
+}
+function shouldEmitNeedsInput() {
+  return isJsonMode() || isNonInteractiveMode();
+}
+function emitUnannotatedPromptError(kind, question) {
+  outputNeedsInput({
+    field: "unannotated_prompt",
+    kind,
+    question,
+    flag: "--yes",
+    context: {
+      hint: "This prompt site does not yet expose a CLI flag. Re-invoke with --yes (for confirms) or provide the value as a positional/flag argument, or file an issue to ask for explicit flag support for this command."
+    }
+  });
+  exit(ExitCode.NEEDS_INPUT);
+}
+async function confirm(message, defaultValue = false, descriptor) {
+  if (descriptor && shouldEmitNeedsInput()) {
+    emitNeedsInputAndExit(descriptor, {
+      kind: "confirm",
+      question: message,
+      default: defaultValue
+    });
+  }
+  if (!descriptor && shouldEmitNeedsInput()) {
+    emitUnannotatedPromptError("confirm", message);
+  }
+  const { confirmed } = await inquirer.prompt([
+    {
+      type: "confirm",
+      name: "confirmed",
+      message,
+      default: defaultValue
+    }
+  ]);
+  return confirmed;
+}
+async function input(message, defaultValue, descriptor) {
+  if (descriptor && shouldEmitNeedsInput()) {
+    emitNeedsInputAndExit(descriptor, {
+      kind: "input",
+      question: message,
+      default: defaultValue
+    });
+  }
+  if (!descriptor && shouldEmitNeedsInput()) {
+    emitUnannotatedPromptError("input", message);
+  }
+  const { value } = await inquirer.prompt([
+    {
+      type: "input",
+      name: "value",
+      message,
+      default: defaultValue
+    }
+  ]);
+  return value;
+}
+async function select(message, choices, descriptor) {
+  if (descriptor && shouldEmitNeedsInput()) {
+    emitNeedsInputAndExit(descriptor, {
+      kind: "select",
+      question: message,
+      choices: choices.map((c) => ({ label: c.name, value: c.value }))
+    });
+  }
+  if (!descriptor && shouldEmitNeedsInput()) {
+    emitUnannotatedPromptError("select", message);
+  }
+  const { value } = await inquirer.prompt([
+    {
+      type: "list",
+      name: "value",
+      message,
+      choices
+    }
+  ]);
+  return value;
+}
+async function password(message, descriptor) {
+  if (descriptor && shouldEmitNeedsInput()) {
+    emitNeedsInputAndExit(
+      { ...descriptor, sensitive: true },
+      { kind: "password", question: message }
+    );
+  }
+  if (!descriptor && shouldEmitNeedsInput()) {
+    emitUnannotatedPromptError("password", message);
+  }
+  const { value } = await inquirer.prompt([
+    {
+      type: "password",
+      name: "value",
+      message,
+      mask: "*"
+    }
+  ]);
+  return value;
+}
+async function promptOrEmit(req, fallback) {
+  if (shouldEmitNeedsInput()) {
+    outputNeedsInput(req);
+    exit(ExitCode.NEEDS_INPUT);
+  }
+  return fallback();
+}
+
+export {
+  confirm,
+  input,
+  select,
+  password,
+  promptOrEmit
+};

package/dist/{chunk-FS74WWHV.js → chunk-KL3JNPAY.js}

@@ -43,7 +43,7 @@ function jsonError(code, message, suggestions, details) {
   };
 }
 function outputJson(response) {
-  console.log(JSON.stringify(response, null, 2));
+  console.log(JSON.stringify(response));
 }
 
 // src/lib/output.ts
@@ -52,7 +52,8 @@ var globalOptions = {
   quiet: false,
   verbose: false,
   noColor: false,
-  yes: false
+  yes: false,
+  nonInteractive: false
 };
 function setGlobalOptions(options) {
   globalOptions = { ...globalOptions, ...options };
@@ -63,6 +64,9 @@ function isJsonMode() {
 function shouldSkipConfirmation() {
   return globalOptions.yes;
 }
+function isNonInteractiveMode() {
+  return globalOptions.nonInteractive;
+}
 function c(colorFn, str) {
   return globalOptions.noColor ? str : colorFn(str);
 }
@@ -183,6 +187,7 @@ export {
   setGlobalOptions,
   isJsonMode,
   shouldSkipConfirmation,
+  isNonInteractiveMode,
   colors,
   getStatusBadge,
   log,