Warranty Claims Quickstart

mkdir stateset-warranty-example
cd stateset-warranty-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',
});
const warranty = await commerce.warranties.create({
  customerId: customer.id,
  warrantyType: 'standard',
  durationMonths: 12,
  serialNumber: 'DEMO-MUG-001',
});
const storedWarranty = await commerce.warranties.get(warranty.id);
assert.equal(storedWarranty.customerId, customer.id);
assert.equal(storedWarranty.status, 'active');
// This version calculates each duration month as 30 days.
assert.equal(
  Date.parse(storedWarranty.endDate) - Date.parse(storedWarranty.startDate),
  360 * 24 * 60 * 60 * 1000,
);
assert.equal(await commerce.warranties.count(), 1);
console.log('Warranty created and read back: active, duration=360 days');

const claim = await commerce.warranties.createClaim({
  warrantyId: warranty.id,
  issueDescription: 'Mug handle cracked during normal use',
  contactEmail: 'ada@example.com',
});
assert.equal(claim.warrantyId, warranty.id);
assert.equal(claim.status, 'submitted');
assert.equal(claim.resolution, 'none');
console.log('First claim: submitted');

// A real application must check eligibility and approval authority first.
const approved = await commerce.warranties.approveClaim(claim.id);
assert.equal(approved.status, 'approved');
console.log('First claim approved: approved');

// Record a simulated outcome; this call performs no replacement fulfillment.
const completed = await commerce.warranties.completeClaim(claim.id, 'replacement');
assert.equal(completed.status, 'completed');
assert.equal(completed.resolution, 'replacement');
assert.equal(await commerce.orders.count(), 0);
assert.equal(await commerce.shipments.count(), 0);
console.log('First claim completed: replacement; orders=0, shipments=0');

const secondClaim = await commerce.warranties.createClaim({
  warrantyId: warranty.id,
  issueDescription: 'Example issue excluded by the demonstration policy',
});
const denied = await commerce.warranties.denyClaim(
  secondClaim.id,
  'Excluded by the demonstration coverage policy',
);
assert.equal(denied.status, 'denied');
assert.equal(denied.resolution, 'denied');
await assert.rejects(
  () => commerce.warranties.approveClaim(secondClaim.id),
  { code: 'CONFLICT', message: /Cannot approve a denied claim/ },
);
console.log('Second claim denied; subsequent approval rejected');

node warranties-demo.mjs

Warranty created and read back: active, duration=360 days
First claim: submitted
First claim approved: approved
First claim completed: replacement; orders=0, shipments=0
Second claim denied; subsequent approval rejected