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",
});

// 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 | trialing | canceled | past_due | ...
console.log(subscriptions[0].status);

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

const canAccess = await crovver.canAccess("workspace_abc123", "advanced_analytics");

if (canAccess) {
  // serve the feature
}

// Record usage
await crovver.recordUsage("workspace_abc123", "api_calls", 1);

// Check against limit
const limit = await crovver.checkUsageLimit("workspace_abc123", "api_calls");
console.log(`${limit.used} / ${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
  }
}