TypeScript

import { Creem } from "creem";

const creem = new Creem({
  apiKey: process.env.CREEM_API_KEY!,
});

// Retrieve a product
const product = await creem.products.get("prod_7CIbZEZnRC5DWibmoOboOu");
console.log(product);

// Create a checkout session
const checkout = await creem.checkouts.create({
  productId: "prod_xxxxx",
  successUrl: "https://yourapp.com/success",
  metadata: {
    userId: "user_123",
  },
});
console.log(checkout.checkoutUrl); // Redirect user to this URL

CREEM_API_KEY=your_api_key
# Optional: enable debug logs from the SDK
CREEM_DEBUG=true

// List products
const productPage = await creem.products.search(1, 10);
const products = productPage.result.items;

// Get a product
const product = await creem.products.get("prod_7CIbb...");

// Create a product
const createdProduct = await creem.products.create({
  name: "Test Product",
  description: "Test Product Description",
  price: 1000, // In cents
  currency: "USD",
  billingType: "recurring",
  billingPeriod: "every-month",
});

// Search products
const productsPage = await creem.products.search(1, 10);
console.log(productsPage.result.items);

// Create a checkout session
const checkout = await creem.checkouts.create({
  productId: "prod_xxxxx",
  units: 2, // Optional: Number of units (default: 1)
  discountCode: "SUMMER2024", // Optional: Apply discount
  customer: {
    email: "customer@example.com", // Optional: Pre-fill customer info
  },
  customFields: [
    // Optional: Max 3 custom fields
    {
      key: "company",
      label: "Company Name",
      type: "text",
      optional: false,
    },
  ],
  successUrl: "https://yourapp.com/success",
  metadata: {
    userId: "user_123",
    source: "web",
  },
});

console.log(checkout.checkoutUrl); // Redirect user to this URL

// Get a checkout session
const retrievedCheckout = await creem.checkouts.retrieve("chck_1234567890");

// List customers
const customerPage = await creem.customers.list(1, 10);
const customers = customerPage.result.items;

// Get a customer by ID
const customer = await creem.customers.retrieve("cust_abc123");

// Get a customer by email
const customerByEmail = await creem.customers.retrieve(undefined, "customer@example.com");

// Create customer portal link
const portal = await creem.customers.generateBillingLinks({
  customerId: "cust_abc123",
});

console.log(portal.customerPortalLink); // Redirect user to portal

// Get a subscription
const subscription = await creem.subscriptions.get("sub_abc123");

// Cancel a subscription
const canceledSubscription = await creem.subscriptions.cancel("sub_abc123", {
  mode: "immediate",
});

// Update a subscription (change units/seats)
const updated = await creem.subscriptions.update("sub_abc123", {
  items: [
    {
      id: "item_abc123", // Subscription item ID
      units: 5, // Update to 5 seats
    },
  ],
  updateBehavior: "proration-charge-immediately",
});

// Upgrade a subscription to a different product
const upgraded = await creem.subscriptions.upgrade("sub_abc123", {
  productId: "prod_premium", // New product ID
  updateBehavior: "proration-charge-immediately",
});

// Activate a license
const license = await creem.licenses.activate({
  key: "license_key_here",
  instanceName: "Production Server",
});

console.log(license.instance?.id); // Use this instance ID for validation

// Validate a license
const validatedLicense = await creem.licenses.validate({
  key: "license_key_here",
  instanceId: "inst_abc123",
});

console.log(validatedLicense.status); // "active" | "inactive" | "expired" | "disabled"

// Deactivate a license
const deactivatedLicense = await creem.licenses.deactivate({
  key: "license_key_here",
  instanceId: "inst_abc123",
});

// Create a discount code
const discount = await creem.discounts.create({
  name: "Summer Sale 2024",
  code: "SUMMER2024", // Optional: Auto-generated if not provided
  type: "percentage",
  percentage: 20, // 20% off
  duration: "forever", // "forever" | "once" | "repeating"
  maxRedemptions: 100,
  appliesToProducts: ["prod_xxxxx"],
});

// Retrieve a discount by ID
const discountById = await creem.discounts.get("disc_xxxxx");

// Retrieve a discount by code
const discountByCode = await creem.discounts.get(undefined, "SUMMER2024");

// Delete a discount
await creem.discounts.delete("disc_xxxxx");

// Get a transaction
const transaction = await creem.transactions.getById("txn_xxxxx");

// List transactions
const transactionPage = await creem.transactions.search(
  "cust_xxxxx", // customerId (optional)
  undefined, // orderId
  undefined, // productId
  1, // page
  50, // pageSize
);
const transactions = transactionPage.result.items;

import { CreemCore } from "creem/core.js";
import { productsGet } from "creem/funcs/productsGet.js";

// Use `CreemCore` for best tree-shaking performance.
const creem = new CreemCore({
  apiKey: process.env["CREEM_API_KEY"] ?? "",
});

const res = await productsGet(creem, "prod_1234567890");
if (!res.ok) throw res.error;

console.log(res.value);

import { constructWebhookEventEntity } from "creem/webhooks";

const event = await constructWebhookEventEntity(rawBody, request.headers, {
  secret: process.env.CREEM_WEBHOOK_SECRET!,
});

switch (event.eventType) {
  case "checkout.completed":
    console.log(event.object.id);
    // Grant access, send email, update your database, etc.
    break;
  case "subscription.canceled":
    console.log(event.object.id);
    // Revoke access or mark the subscription as canceled.
    break;
}

import type {
  CheckoutEntity,
  CustomerEntity,
  ProductEntity,
  SubscriptionEntity,
  TransactionEntity,
  LicenseEntity,
  DiscountEntity,
} from "creem/models/components";

try {
  const product = await creem.products.get("prod_xxxxx");
} catch (error) {
  console.error("Failed to retrieve product:", error);
  // Handle error appropriately
}