Customers

import { createCustomerService, PaymentTerms } from "commercio";

const customerService = createCustomerService();

// Create customer with all fields
const customer = await customerService.createCustomer(
  "John Doe",
  {
    street: "123 Main St",
    city: "Berlin",
    postalCode: "10115",
    country: "Germany",
    state: "Berlin",
  },
  {
    email: "john.doe@example.com",
    phone: "+49 30 12345678",
  },
  {
    creditLimit: 100000, // €1000.00 in cents
    paymentTerms: PaymentTerms.NET_30,
  }
);

console.log(customer.id);              // UUID
console.log(customer.name);            // "John Doe"
console.log(customer.address.city);    // "Berlin"
console.log(customer.contact.email);   // "john.doe@example.com"
console.log(customer.creditLimit);     // 100000
console.log(customer.paymentTerms);    // "NET_30"

// Create customer with minimal required fields
const customer = await customerService.createCustomer(
  "Jane Smith",
  {
    street: "456 Oak Ave",
    city: "Munich",
    postalCode: "80331",
    country: "Germany",
  },
  {
    email: "jane.smith@example.com",
  }
);

// Defaults:
// creditLimit: 0
// paymentTerms: NET_30
// customerGroupId: null

// Get complete order history
const orderHistory = await customerService.getOrderHistory(customer.id);

console.log(`Customer has ${orderHistory.length} orders`);
orderHistory.forEach((order) => {
  console.log(`Order ${order.id}: €${(order.totalAmount / 100).toFixed(2)} - Status: ${order.status}`);
});

import { OrderStatus } from "commercio";

// Get only completed orders
const completedOrders = await customerService.getOrderHistoryByStatus(
  customer.id,
  OrderStatus.COMPLETED
);

// Get only paid orders
const paidOrders = await customerService.getOrderHistoryByStatus(
  customer.id,
  OrderStatus.PAID
);

// Get all orders (no filter)
const allOrders = await customerService.getOrderHistoryByStatus(customer.id);

// Get customer order statistics
const stats = await customerService.getCustomerOrderStatistics(customer.id);

console.log(`Total orders: ${stats.totalOrders}`);
console.log(`Total spent: €${(stats.totalSpent / 100).toFixed(2)}`);
console.log(`Average order value: €${(stats.averageOrderValue / 100).toFixed(2)}`);
console.log(`Orders by status:`, stats.ordersByStatus);
// Output: { CREATED: 2, CONFIRMED: 1, COMPLETED: 5, ... }

// Create customer group with discount
const vipGroup = await customerService.createCustomerGroup(
  "VIP Customers",
  "Premium customer tier",
  10 // 10% discount
);

console.log(vipGroup.name);              // "VIP Customers"
console.log(vipGroup.discountPercentage); // 10

// Assign customer to a group
await customerService.updateCustomer(customer.id, {
  customerGroupId: vipGroup.id,
});

// Get all customers in a group
const vipCustomers = await customerService.getCustomersByGroup(vipGroup.id);
console.log(`VIP customers: ${vipCustomers.length}`);

// Get all customer groups
const allGroups = await customerService.getAllCustomerGroups();
const activeGroups = await customerService.getAllCustomerGroups(true);

// Get group by name
const group = await customerService.getCustomerGroupByName("VIP Customers");

// Good: Create customer first
const customer = await customerService.createCustomer(
  "John Doe",
  { street: "123 St", city: "Berlin", postalCode: "10115", country: "Germany" },
  { email: "john@example.com" }
);
const order = await orderService.createOrder(customer.id, [
  { productId: product.id, quantity: 1, unitPrice: 10000 },
]);

// Bad: This will fail
const order = await orderService.createOrder(
  "non-existent-customer-id",
  [{ productId: product.id, quantity: 1, unitPrice: 10000 }]
);

try {
  await customerService.createCustomer(
    "Customer",
    { street: "123 St", city: "Berlin", postalCode: "10115", country: "Germany" },
    { email: "existing@example.com" }
  );
} catch (error) {
  if (error.message.includes("already exists")) {
    // Customer already exists, get it instead
    const existing = await customerService.getCustomerByEmail("existing@example.com");
    return existing;
  }
  throw error;
}

// Create groups with different discount levels
const vipGroup = await customerService.createCustomerGroup("VIP", null, 15);
const regularGroup = await customerService.createCustomerGroup("Regular", null, 0);

// Assign customers to groups
await customerService.updateCustomer(customer1.id, {
  customerGroupId: vipGroup.id, // 15% discount
});

await customerService.updateCustomer(customer2.id, {
  customerGroupId: regularGroup.id, // No discount
});

const customer = await customerService.getCustomerById(customerId);
const stats = await customerService.getCustomerOrderStatistics(customerId);

// Check if customer is approaching credit limit
const creditUsed = stats.totalSpent;
const creditRemaining = customer.creditLimit - creditUsed;

if (creditRemaining < 10000) {
  console.warn(`Customer approaching credit limit: €${(creditRemaining / 100).toFixed(2)} remaining`);
}

// Get customer statistics
const stats = await customerService.getCustomerOrderStatistics(customerId);

// Identify best customers
if (stats.totalSpent > 1000000) {
  // Customer has spent more than €10000
  // Consider upgrading to VIP group
}

// Analyze order patterns
const completedOrders = await customerService.getOrderHistoryByStatus(
  customerId,
  OrderStatus.COMPLETED
);
console.log(`Customer has ${completedOrders.length} completed orders`);