Your First Operation

mkdir stateset-first-operation
cd stateset-first-operation
npm init -y
npm install @stateset/embedded@1.35.1

import assert from 'node:assert/strict';
import { existsSync, writeFileSync } from 'node:fs';
import { resolve } from 'node:path';
import { Commerce } from '@stateset/embedded';

const database = resolve('operations.db');
if (existsSync(database)) {
  throw new Error('operations.db already exists. Run inspect-operation.mjs, or use a new directory.');
}
const commerce = new Commerce(database);
const customer = await commerce.customers.create({
  email: 'ada@example.com', firstName: 'Ada', lastName: 'Lovelace',
});
const sku = 'MUG-001';
await commerce.inventory.createItem({ sku, name: 'Ceramic mug', initialQuantity: 10 });
const order = await commerce.orders.createExact({
  customerId: customer.id,
  currency: 'USD',
  stockPolicy: 'reject_if_insufficient',
  items: [{ sku, name: 'Ceramic mug', quantity: 2, unitPrice: '12.50' }],
});
assert.equal(order.status, 'pending');
assert.equal(order.totalAmountExact, '25.00');
const stock = await commerce.inventory.getStock(sku);
assert.equal(stock.totalAllocated, '2');
assert.equal(stock.totalAvailable, '8');

writeFileSync('operation.json', JSON.stringify({ database, orderId: order.id, sku }, null, 2));
const mcpConfig = {
  mcpServers: {
    'stateset-commerce': {
      command: 'npx',
      args: ['-y', '-p', '@stateset/cli@1.35.1', 'stateset-mcp',
        '--db', database, '--profile', 'core'],
    },
  },
};
writeFileSync('mcp-config.json', JSON.stringify(mcpConfig, null, 2));
const prompt = `Use the stateset-commerce read tools to inspect order ${order.id}
and inventory for SKU ${sku}. Report the order ID, status, total and currency;
stock on hand, allocated and available; and whether the available stock can cover
an additional request for 9 mugs right now. Identify the tool results behind your
answer. Do not create, reserve, update, cancel, charge, ship, or send anything.
If the records or tools are unavailable, report the blocker instead of guessing.`;
writeFileSync('agent-task.txt', prompt + '\n');
console.log(`Created order: ${order.id}`);
console.log(`Database: ${database}`);
console.log('Saved operation.json, mcp-config.json, and agent-task.txt');

node setup-operation.mjs

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

const fixture = JSON.parse(readFileSync('operation.json', 'utf8'));
const commerce = new Commerce(fixture.database);
const order = await commerce.orders.get(fixture.orderId);
const stock = await commerce.inventory.getStock(fixture.sku);
assert.ok(order, 'Order is missing from the selected database');
assert.ok(stock, 'Inventory item is missing from the selected database');
assert.equal(order.status, 'pending');
assert.equal(order.totalAmountExact, '25.00');
assert.equal(order.currency, 'USD');
assert.deepEqual(
  [stock.totalOnHand, stock.totalAllocated, stock.totalAvailable],
  ['10', '2', '8'],
);
assert.equal(await commerce.orders.count(), 1);
console.log(`Order: ${order.id}`);
console.log('Status: pending; total: 25.00 USD');
console.log('Stock: on hand=10, allocated=2, available=8');
console.log('Additional request for 9: insufficient available stock');

node inspect-operation.mjs