Orders Quickstart

mkdir stateset-orders-example
cd stateset-orders-example
npm init -y
npm install @stateset/embedded@1.35.1

import assert from 'node:assert/strict';
import { Commerce } from '@stateset/embedded';

const commerce = new Commerce(':memory:');
const customer = await commerce.customers.create({
  email: 'ada@example.com', firstName: 'Ada', lastName: 'Lovelace',
});
await commerce.inventory.createItem({
  sku: 'MUG-001', name: 'Ceramic mug', initialQuantity: 10,
});
const input = {
  customerId: customer.id,
  currency: 'USD',
  stockPolicy: 'reject_if_insufficient',
  items: [{ sku: 'MUG-001', name: 'Ceramic mug', quantity: 2, unitPrice: '12.50' }],
};
const order = await commerce.orders.createExact(input);
assert.equal(order.status, 'pending');
assert.equal(order.totalAmountExact, '25.00');
let stock = await commerce.inventory.getStock('MUG-001');
assert.equal(stock.totalAllocated, '2');
assert.equal(stock.totalAvailable, '8');
console.log(`Created: ${order.status}, ${order.totalAmountExact} ${order.currency}`);
console.log(`Available after creation: ${stock.totalAvailable}`);

await assert.rejects(
  () => commerce.orders.createExact({
    ...input,
    items: [{ ...input.items[0], quantity: 9 }],
  }),
  { code: 'INSUFFICIENT_STOCK' },
);
assert.equal(await commerce.orders.count(), 1);
console.log('Insufficient-stock request rejected; order count is still 1');

const confirmed = await commerce.orders.updateStatus(order.id, 'confirmed');
assert.equal(confirmed.status, 'confirmed');
const cancelled = await commerce.orders.cancel(order.id);
assert.equal(cancelled.status, 'cancelled');
stock = await commerce.inventory.getStock('MUG-001');
assert.equal(stock.totalAllocated, '0');
assert.equal(stock.totalAvailable, '10');
console.log(`Cancelled: ${cancelled.status}`);
console.log(`Available after cancellation: ${stock.totalAvailable}`);

node orders-demo.mjs

Created: pending, 25.00 USD
Available after creation: 8
Insufficient-stock request rejected; order count is still 1
Cancelled: cancelled
Available after cancellation: 10