Node.js SDK

npm install crovver-node
# or
pnpm add crovver-node
# or
yarn add crovver-node

import { CrovverClient } from "crovver-node";

const crovver = new CrovverClient({
  apiKey: process.env.CROVVER_SECRET_KEY!,
});

// Create a tenant (B2B: workspace or user)
const tenant = await crovver.createTenant({
  externalTenantId: "workspace_abc123",
  name: "Acme Corp",
  externalUserId: "user_123",
});

// Retrieve a tenant
const tenant = await crovver.getTenant("workspace_abc123");

const { plans } = await crovver.getPlans();

for (const plan of plans) {
  console.log(`${plan.name} - $${plan.priceAmount / 100}/mo`);
}

const { subscriptions } = await crovver.getSubscriptions("workspace_abc123");

// status: active | trial | past_due | pending_cancel | canceled | expired
console.log(subscriptions[0].status);

// Cancel a subscription
await crovver.cancelSubscription(subscriptionId, "workspace_abc123", "User requested cancellation");

// Single-product org
const canAccess = await crovver.canAccess("workspace_abc123", "advanced_analytics");

// Multi-product: scope to a specific product
const canAccess = await crovver.canAccess("workspace_abc123", "advanced_analytics", "product-a");

// Subscription-existence check — does this tenant have any active sub for product-a?
const hasProduct = await crovver.canAccess("workspace_abc123", undefined, "product-a");

const balance = await crovver.credits.balance({ tenantId: "workspace_abc123" });

for (const pool of balance.pools) {
  console.log(`${pool.poolKey}: ${pool.remaining} remaining`);
}

const result = await crovver.credits.consume({
  tenantId: "workspace_abc123",
  poolKey: "ai_generations",
  amount: 1,
  idempotencyKey: crypto.randomUUID(), // stable per user action
  metadata: { prompt: "summarise report" }, // optional
});

if (result.result === "success") {
  console.log(`Remaining: ${result.remaining}`);
} else {
  // result.result === "insufficient_credits"
  // Prompt the user to purchase an add-on or upgrade
}

const addons = await crovver.addons.listAvailable("workspace_abc123");

for (const addon of addons) {
  console.log(`${addon.name}: ${addon.creditQty} credits — ${addon.currency} ${addon.amount}`);
}

const purchase = await crovver.addons.purchase("workspace_abc123", {
  addonId: "addon_uuid",
  currency: "USD",
  idempotencyKey: crypto.randomUUID(),
  successUrl: "https://yourapp.com/billing/success",
  cancelUrl: "https://yourapp.com/billing/cancel",
});

if (purchase.requiresPayment) {
  // Redirect to Stripe checkout
  window.location.href = purchase.checkoutUrl;
} else {
  // Credits added immediately (free add-on or already processed)
  console.log(`${purchase.creditQty} credits added`);
}

const active = await crovver.addons.getActive("workspace_abc123");

for (const pool of active) {
  console.log(`${pool.poolKey}: ${pool.remaining} remaining`);
}

// ❌ Deprecated — use credits.consume() instead
await crovver.recordUsage("workspace_abc123", "api_calls", 1);

// ❌ Deprecated — use credits.balance() instead
const limit = await crovver.checkUsageLimit("workspace_abc123", "api_calls");
console.log(`${limit.current} / ${limit.limit}`);

const session = await crovver.createCheckoutSession({
  externalTenantId: "workspace_abc123",
  planId: "plan_pro",
  successUrl: "https://yourapp.com/billing/success",
  cancelUrl: "https://yourapp.com/billing/cancel",
});

// Redirect user to session.checkoutUrl

const { invoices } = await crovver.getInvoices("workspace_abc123");

import { CrovverClient, CrovverError } from "crovver-node";

try {
  const canAccess = await crovver.canAccess("workspace_abc123", "advanced_analytics");
} catch (error) {
  if (error instanceof CrovverError) {
    error.message;      // Human-readable message
    error.statusCode;   // HTTP status code
    error.code;         // API error code string
    error.isRetryable;  // Whether the SDK already retried
  }
}