jiva-core 0.3.47 → 0.3.48-dev.0fd3c65

package/dist/code/benchmark/microcrm/assets/app.full.reference.mjs

@@ -0,0 +1,267 @@
+import http from 'node:http';
+import { DatabaseSync } from 'node:sqlite';
+
+const STAGES = ['lead', 'qualified', 'won', 'lost'];
+const STAGE_PROBABILITY = { lead: 0.1, qualified: 0.4, won: 1.0, lost: 0.0 };
+const EMAIL_RE = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+const round = (n, dp) => Math.round(n * 10 ** dp) / 10 ** dp;
+
+export function createApp(dbPath = ':memory:') {
+  const db = new DatabaseSync(dbPath);
+  db.exec('PRAGMA foreign_keys = ON;');
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS contacts (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      name TEXT NOT NULL,
+      email TEXT NOT NULL UNIQUE,
+      company TEXT,
+      created_at TEXT NOT NULL
+    );
+    CREATE TABLE IF NOT EXISTS deals (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      contact_id INTEGER NOT NULL,
+      title TEXT NOT NULL,
+      amount REAL NOT NULL DEFAULT 0,
+      stage TEXT NOT NULL DEFAULT 'lead',
+      created_at TEXT NOT NULL,
+      FOREIGN KEY (contact_id) REFERENCES contacts(id) ON DELETE CASCADE
+    );
+  `);
+
+  // In-memory idempotency-key store: key -> contact id (per app instance).
+  const idempotency = new Map();
+
+  const getContact = (id) => db.prepare('SELECT * FROM contacts WHERE id = ?').get(id) ?? null;
+  const getDeal = (id) => db.prepare('SELECT * FROM deals WHERE id = ?').get(id) ?? null;
+
+  function validateContact(b, requireAll) {
+    if (requireAll || b.name !== undefined) {
+      if (typeof b.name !== 'string' || b.name.trim() === '') return 'name is required';
+    }
+    if (requireAll || b.email !== undefined) {
+      if (typeof b.email !== 'string' || !EMAIL_RE.test(b.email)) return 'a valid email is required';
+    }
+    return null;
+  }
+  function validateDeal(b, requireAll) {
+    if (requireAll || b.title !== undefined) {
+      if (typeof b.title !== 'string' || b.title.trim() === '') return 'title is required';
+    }
+    if (b.amount !== undefined) {
+      if (typeof b.amount !== 'number' || Number.isNaN(b.amount) || b.amount < 0) return 'amount must be a number >= 0';
+    }
+    if (b.stage !== undefined) {
+      if (!STAGES.includes(b.stage)) return 'invalid stage';
+    }
+    return null;
+  }
+
+  const send = (res, status, obj) => {
+    res.writeHead(status, { 'content-type': 'application/json' });
+    res.end(obj === undefined ? '' : JSON.stringify(obj));
+  };
+  const readBody = (req) =>
+    new Promise((resolve, reject) => {
+      let data = '';
+      req.on('data', (c) => (data += c));
+      req.on('end', () => {
+        if (!data) return resolve({});
+        try { resolve(JSON.parse(data)); } catch { reject(new Error('invalid json')); }
+      });
+      req.on('error', reject);
+    });
+
+  const insertDeal = (contactId, d) =>
+    db.prepare('INSERT INTO deals (contact_id, title, amount, stage, created_at) VALUES (?, ?, ?, ?, ?)')
+      .run(contactId, d.title, d.amount ?? 0, d.stage ?? 'lead', new Date().toISOString());
+
+  const handler = async (req, res) => {
+    const url = new URL(req.url, 'http://localhost');
+    const parts = url.pathname.split('/').filter(Boolean);
+    const method = req.method;
+
+    try {
+      if (parts[0] === 'contacts') {
+        // POST /contacts (with optional Idempotency-Key)
+        if (parts.length === 1 && method === 'POST') {
+          const key = req.headers['idempotency-key'];
+          if (key && idempotency.has(key)) {
+            return send(res, 200, getContact(idempotency.get(key)));
+          }
+          let body;
+          try { body = await readBody(req); } catch { return send(res, 400, { error: 'invalid json' }); }
+          const err = validateContact(body, true);
+          if (err) return send(res, 400, { error: err });
+          try {
+            const info = db
+              .prepare('INSERT INTO contacts (name, email, company, created_at) VALUES (?, ?, ?, ?)')
+              .run(body.name, body.email, body.company ?? null, new Date().toISOString());
+            const id = Number(info.lastInsertRowid);
+            if (key) idempotency.set(key, id);
+            return send(res, 201, getContact(id));
+          } catch (e) {
+            if (String(e.message).includes('UNIQUE')) return send(res, 409, { error: 'email already exists' });
+            throw e;
+          }
+        }
+        if (parts.length === 1 && method === 'GET') {
+          const q = url.searchParams.get('q');
+          const limit = Math.max(0, parseInt(url.searchParams.get('limit') ?? '50', 10) || 50);
+          const offset = Math.max(0, parseInt(url.searchParams.get('offset') ?? '0', 10) || 0);
+          let where = '';
+          const args = [];
+          if (q) { where = 'WHERE name LIKE ? OR email LIKE ?'; args.push('%' + q + '%', '%' + q + '%'); }
+          const total = db.prepare(`SELECT COUNT(*) AS c FROM contacts ${where}`).get(...args).c;
+          const data = db.prepare(`SELECT * FROM contacts ${where} ORDER BY id LIMIT ? OFFSET ?`).all(...args, limit, offset);
+          return send(res, 200, { data, total });
+        }
+        if (parts.length === 2) {
+          const id = Number(parts[1]);
+          const existing = getContact(id);
+          if (method === 'GET') return existing ? send(res, 200, existing) : send(res, 404, { error: 'not found' });
+          if (method === 'PATCH') {
+            if (!existing) return send(res, 404, { error: 'not found' });
+            let body;
+            try { body = await readBody(req); } catch { return send(res, 400, { error: 'invalid json' }); }
+            const err = validateContact(body, false);
+            if (err) return send(res, 400, { error: err });
+            const name = body.name ?? existing.name;
+            const email = body.email ?? existing.email;
+            const company = body.company !== undefined ? body.company : existing.company;
+            try {
+              db.prepare('UPDATE contacts SET name = ?, email = ?, company = ? WHERE id = ?').run(name, email, company, id);
+            } catch (e) {
+              if (String(e.message).includes('UNIQUE')) return send(res, 409, { error: 'email already exists' });
+              throw e;
+            }
+            return send(res, 200, getContact(id));
+          }
+          if (method === 'DELETE') {
+            if (!existing) return send(res, 404, { error: 'not found' });
+            db.prepare('DELETE FROM contacts WHERE id = ?').run(id);
+            return send(res, 204);
+          }
+        }
+        // GET /contacts/:id/stats
+        if (parts.length === 3 && parts[2] === 'stats' && method === 'GET') {
+          const id = Number(parts[1]);
+          if (!getContact(id)) return send(res, 404, { error: 'contact not found' });
+          const deals = db.prepare('SELECT * FROM deals WHERE contact_id = ?').all(id);
+          const totalDeals = deals.length;
+          const totalValue = deals.reduce((s, d) => s + d.amount, 0);
+          const wonDeals = deals.filter((d) => d.stage === 'won');
+          const wonValue = wonDeals.reduce((s, d) => s + d.amount, 0);
+          const winRate = totalDeals === 0 ? 0 : round(wonDeals.length / totalDeals, 4);
+          const weightedPipeline = round(deals.reduce((s, d) => s + d.amount * (STAGE_PROBABILITY[d.stage] ?? 0), 0), 2);
+          return send(res, 200, { totalDeals, totalValue, wonValue, winRate, weightedPipeline });
+        }
+        // /contacts/:id/deals  and  /contacts/:id/deals/bulk
+        if ((parts.length === 3 || parts.length === 4) && parts[2] === 'deals') {
+          const id = Number(parts[1]);
+          const contact = getContact(id);
+          if (!contact) return send(res, 404, { error: 'contact not found' });
+
+          // POST /contacts/:id/deals/bulk — atomic
+          if (parts.length === 4 && parts[3] === 'bulk' && method === 'POST') {
+            let body;
+            try { body = await readBody(req); } catch { return send(res, 400, { error: 'invalid json' }); }
+            const list = body?.deals;
+            if (!Array.isArray(list) || list.length === 0) return send(res, 400, { error: 'deals must be a non-empty array' });
+            for (const d of list) {
+              const err = validateDeal(d, true);
+              if (err) return send(res, 400, { error: err }); // reject whole batch, insert nothing
+            }
+            db.exec('BEGIN');
+            try {
+              const created = [];
+              for (const d of list) created.push(getDeal(Number(insertDeal(id, d).lastInsertRowid)));
+              db.exec('COMMIT');
+              return send(res, 201, { data: created, total: created.length });
+            } catch (e) {
+              db.exec('ROLLBACK');
+              throw e;
+            }
+          }
+
+          if (parts.length === 3 && method === 'POST') {
+            let body;
+            try { body = await readBody(req); } catch { return send(res, 400, { error: 'invalid json' }); }
+            const err = validateDeal(body, true);
+            if (err) return send(res, 400, { error: err });
+            return send(res, 201, getDeal(Number(insertDeal(id, body).lastInsertRowid)));
+          }
+          if (parts.length === 3 && method === 'GET') {
+            const data = db.prepare('SELECT * FROM deals WHERE contact_id = ? ORDER BY id').all(id);
+            return send(res, 200, { data, total: data.length });
+          }
+        }
+      }
+
+      if (parts[0] === 'deals') {
+        if (parts.length === 2 && parts[1] === 'summary' && method === 'GET') {
+          const summary = {};
+          for (const s of STAGES) summary[s] = { count: 0, totalAmount: 0 };
+          const rows = db
+            .prepare('SELECT stage, COUNT(*) AS count, COALESCE(SUM(amount), 0) AS totalAmount FROM deals GROUP BY stage')
+            .all();
+          for (const r of rows) summary[r.stage] = { count: r.count, totalAmount: r.totalAmount };
+          return send(res, 200, { summary });
+        }
+        // GET /deals — advanced filtering / sorting / pagination
+        if (parts.length === 1 && method === 'GET') {
+          const sp = url.searchParams;
+          const where = [];
+          const args = [];
+          const stage = sp.get('stage');
+          if (stage !== null) { where.push('stage = ?'); args.push(stage); }
+          for (const [param, op] of [['minAmount', '>='], ['maxAmount', '<=']]) {
+            const v = sp.get(param);
+            if (v !== null) {
+              const n = Number(v);
+              if (Number.isNaN(n)) return send(res, 400, { error: `invalid ${param}` });
+              where.push(`amount ${op} ?`);
+              args.push(n);
+            }
+          }
+          let orderBy = 'id';
+          let dir = 'ASC';
+          const sort = sp.get('sort');
+          if (sort !== null) {
+            const [field, d = 'asc'] = sort.split(':');
+            if (!['amount', 'created_at', 'id'].includes(field) || !['asc', 'desc'].includes(d.toLowerCase())) {
+              return send(res, 400, { error: 'invalid sort' });
+            }
+            orderBy = field;
+            dir = d.toUpperCase();
+          }
+          const whereSql = where.length ? `WHERE ${where.join(' AND ')}` : '';
+          const total = db.prepare(`SELECT COUNT(*) AS c FROM deals ${whereSql}`).get(...args).c;
+          const limit = Math.max(0, parseInt(sp.get('limit') ?? '50', 10) || 50);
+          const offset = Math.max(0, parseInt(sp.get('offset') ?? '0', 10) || 0);
+          const data = db.prepare(`SELECT * FROM deals ${whereSql} ORDER BY ${orderBy} ${dir} LIMIT ? OFFSET ?`).all(...args, limit, offset);
+          return send(res, 200, { data, total, hasMore: offset + data.length < total });
+        }
+        if (parts.length === 2 && method === 'PATCH') {
+          const id = Number(parts[1]);
+          const existing = getDeal(id);
+          if (!existing) return send(res, 404, { error: 'not found' });
+          let body;
+          try { body = await readBody(req); } catch { return send(res, 400, { error: 'invalid json' }); }
+          const err = validateDeal(body, false);
+          if (err) return send(res, 400, { error: err });
+          const title = body.title ?? existing.title;
+          const amount = body.amount ?? existing.amount;
+          const stage = body.stage ?? existing.stage;
+          db.prepare('UPDATE deals SET title = ?, amount = ?, stage = ? WHERE id = ?').run(title, amount, stage, id);
+          return send(res, 200, getDeal(id));
+        }
+      }
+
+      return send(res, 404, { error: 'not found' });
+    } catch (e) {
+      return send(res, 500, { error: 'internal error: ' + (e?.message || String(e)) });
+    }
+  };
+
+  return http.createServer(handler);
+}

package/dist/code/benchmark/microcrm/assets/app.reference.mjs

@@ -0,0 +1,191 @@
+import http from 'node:http';
+import { DatabaseSync } from 'node:sqlite';
+
+const STAGES = ['lead', 'qualified', 'won', 'lost'];
+const EMAIL_RE = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+
+export function createApp(dbPath = ':memory:') {
+  const db = new DatabaseSync(dbPath);
+  db.exec('PRAGMA foreign_keys = ON;');
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS contacts (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      name TEXT NOT NULL,
+      email TEXT NOT NULL UNIQUE,
+      company TEXT,
+      created_at TEXT NOT NULL
+    );
+    CREATE TABLE IF NOT EXISTS deals (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      contact_id INTEGER NOT NULL,
+      title TEXT NOT NULL,
+      amount REAL NOT NULL DEFAULT 0,
+      stage TEXT NOT NULL DEFAULT 'lead',
+      created_at TEXT NOT NULL,
+      FOREIGN KEY (contact_id) REFERENCES contacts(id) ON DELETE CASCADE
+    );
+  `);
+
+  const getContact = (id) => db.prepare('SELECT * FROM contacts WHERE id = ?').get(id) ?? null;
+  const getDeal = (id) => db.prepare('SELECT * FROM deals WHERE id = ?').get(id) ?? null;
+
+  function validateContact(b, requireAll) {
+    if (requireAll || b.name !== undefined) {
+      if (typeof b.name !== 'string' || b.name.trim() === '') return 'name is required';
+    }
+    if (requireAll || b.email !== undefined) {
+      if (typeof b.email !== 'string' || !EMAIL_RE.test(b.email)) return 'a valid email is required';
+    }
+    return null;
+  }
+  function validateDeal(b, requireAll) {
+    if (requireAll || b.title !== undefined) {
+      if (typeof b.title !== 'string' || b.title.trim() === '') return 'title is required';
+    }
+    if (b.amount !== undefined) {
+      if (typeof b.amount !== 'number' || Number.isNaN(b.amount) || b.amount < 0) return 'amount must be a number >= 0';
+    }
+    if (b.stage !== undefined) {
+      if (!STAGES.includes(b.stage)) return 'invalid stage';
+    }
+    return null;
+  }
+
+  const send = (res, status, obj) => {
+    res.writeHead(status, { 'content-type': 'application/json' });
+    res.end(obj === undefined ? '' : JSON.stringify(obj));
+  };
+  const readBody = (req) =>
+    new Promise((resolve, reject) => {
+      let data = '';
+      req.on('data', (c) => (data += c));
+      req.on('end', () => {
+        if (!data) return resolve({});
+        try { resolve(JSON.parse(data)); } catch { reject(new Error('invalid json')); }
+      });
+      req.on('error', reject);
+    });
+
+  const handler = async (req, res) => {
+    const url = new URL(req.url, 'http://localhost');
+    const parts = url.pathname.split('/').filter(Boolean);
+    const method = req.method;
+
+    try {
+      if (parts[0] === 'contacts') {
+        if (parts.length === 1 && method === 'POST') {
+          let body;
+          try { body = await readBody(req); } catch { return send(res, 400, { error: 'invalid json' }); }
+          const err = validateContact(body, true);
+          if (err) return send(res, 400, { error: err });
+          try {
+            const info = db
+              .prepare('INSERT INTO contacts (name, email, company, created_at) VALUES (?, ?, ?, ?)')
+              .run(body.name, body.email, body.company ?? null, new Date().toISOString());
+            return send(res, 201, getContact(Number(info.lastInsertRowid)));
+          } catch (e) {
+            if (String(e.message).includes('UNIQUE')) return send(res, 409, { error: 'email already exists' });
+            throw e;
+          }
+        }
+        if (parts.length === 1 && method === 'GET') {
+          const q = url.searchParams.get('q');
+          const limit = Math.max(0, parseInt(url.searchParams.get('limit') ?? '50', 10) || 50);
+          const offset = Math.max(0, parseInt(url.searchParams.get('offset') ?? '0', 10) || 0);
+          let where = '';
+          const args = [];
+          if (q) { where = 'WHERE name LIKE ? OR email LIKE ?'; args.push('%' + q + '%', '%' + q + '%'); }
+          const total = db.prepare(`SELECT COUNT(*) AS c FROM contacts ${where}`).get(...args).c;
+          const data = db.prepare(`SELECT * FROM contacts ${where} ORDER BY id LIMIT ? OFFSET ?`).all(...args, limit, offset);
+          return send(res, 200, { data, total });
+        }
+        if (parts.length === 2) {
+          const id = Number(parts[1]);
+          const existing = getContact(id);
+          if (method === 'GET') return existing ? send(res, 200, existing) : send(res, 404, { error: 'not found' });
+          if (method === 'PATCH') {
+            if (!existing) return send(res, 404, { error: 'not found' });
+            let body;
+            try { body = await readBody(req); } catch { return send(res, 400, { error: 'invalid json' }); }
+            const err = validateContact(body, false);
+            if (err) return send(res, 400, { error: err });
+            const name = body.name ?? existing.name;
+            const email = body.email ?? existing.email;
+            const company = body.company !== undefined ? body.company : existing.company;
+            try {
+              db.prepare('UPDATE contacts SET name = ?, email = ?, company = ? WHERE id = ?').run(name, email, company, id);
+            } catch (e) {
+              if (String(e.message).includes('UNIQUE')) return send(res, 409, { error: 'email already exists' });
+              throw e;
+            }
+            return send(res, 200, getContact(id));
+          }
+          if (method === 'DELETE') {
+            if (!existing) return send(res, 404, { error: 'not found' });
+            db.prepare('DELETE FROM contacts WHERE id = ?').run(id);
+            return send(res, 204);
+          }
+        }
+        if (parts.length === 3 && parts[2] === 'deals') {
+          const id = Number(parts[1]);
+          const contact = getContact(id);
+          if (!contact) return send(res, 404, { error: 'contact not found' });
+          if (method === 'POST') {
+            let body;
+            try { body = await readBody(req); } catch { return send(res, 400, { error: 'invalid json' }); }
+            const err = validateDeal(body, true);
+            if (err) return send(res, 400, { error: err });
+            const info = db
+              .prepare('INSERT INTO deals (contact_id, title, amount, stage, created_at) VALUES (?, ?, ?, ?, ?)')
+              .run(id, body.title, body.amount ?? 0, body.stage ?? 'lead', new Date().toISOString());
+            return send(res, 201, getDeal(Number(info.lastInsertRowid)));
+          }
+          if (method === 'GET') {
+            const data = db.prepare('SELECT * FROM deals WHERE contact_id = ? ORDER BY id').all(id);
+            return send(res, 200, { data, total: data.length });
+          }
+        }
+      }
+
+      if (parts[0] === 'deals') {
+        if (parts.length === 2 && parts[1] === 'summary' && method === 'GET') {
+          const summary = {};
+          for (const s of STAGES) summary[s] = { count: 0, totalAmount: 0 };
+          const rows = db
+            .prepare('SELECT stage, COUNT(*) AS count, COALESCE(SUM(amount), 0) AS totalAmount FROM deals GROUP BY stage')
+            .all();
+          for (const r of rows) summary[r.stage] = { count: r.count, totalAmount: r.totalAmount };
+          return send(res, 200, { summary });
+        }
+        if (parts.length === 1 && method === 'GET') {
+          const stage = url.searchParams.get('stage');
+          let where = '';
+          const args = [];
+          if (stage) { where = 'WHERE stage = ?'; args.push(stage); }
+          const data = db.prepare(`SELECT * FROM deals ${where} ORDER BY id`).all(...args);
+          return send(res, 200, { data, total: data.length });
+        }
+        if (parts.length === 2 && method === 'PATCH') {
+          const id = Number(parts[1]);
+          const existing = getDeal(id);
+          if (!existing) return send(res, 404, { error: 'not found' });
+          let body;
+          try { body = await readBody(req); } catch { return send(res, 400, { error: 'invalid json' }); }
+          const err = validateDeal(body, false);
+          if (err) return send(res, 400, { error: err });
+          const title = body.title ?? existing.title;
+          const amount = body.amount ?? existing.amount;
+          const stage = body.stage ?? existing.stage;
+          db.prepare('UPDATE deals SET title = ?, amount = ?, stage = ? WHERE id = ?').run(title, amount, stage, id);
+          return send(res, 200, getDeal(id));
+        }
+      }
+
+      return send(res, 404, { error: 'not found' });
+    } catch (e) {
+      return send(res, 500, { error: 'internal error: ' + (e?.message || String(e)) });
+    }
+  };
+
+  return http.createServer(handler);
+}

package/dist/code/benchmark/microcrm/assets/bulk.test.mjs

@@ -0,0 +1,63 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { createApp } from '../src/app.js';
+
+async function withServer(run) {
+  const server = createApp(':memory:');
+  await new Promise((res) => server.listen(0, res));
+  const { port } = server.address();
+  try { await run(`http://127.0.0.1:${port}`); } finally { await new Promise((res) => server.close(res)); }
+}
+async function req(base, method, path, body) {
+  const init = { method, headers: {} };
+  if (body !== undefined) { init.headers['content-type'] = 'application/json'; init.body = JSON.stringify(body); }
+  const res = await fetch(base + path, init);
+  const text = await res.text();
+  let json = null; try { json = text ? JSON.parse(text) : null; } catch { json = null; }
+  return { status: res.status, body: json };
+}
+const mkContact = () => ({ name: 'A', email: `a${Math.random().toString(36).slice(2)}@x.com` });
+
+test('bulk create inserts all deals (201) and returns them', () =>
+  withServer(async (base) => {
+    const c = await req(base, 'POST', '/contacts', mkContact());
+    const r = await req(base, 'POST', `/contacts/${c.body.id}/deals/bulk`, { deals: [{ title: 'a', amount: 1 }, { title: 'b', amount: 2 }, { title: 'c' }] });
+    assert.equal(r.status, 201);
+    assert.equal(r.body.data.length, 3);
+    assert.equal(r.body.total, 3);
+  }));
+
+test('bulk for unknown contact → 404', () =>
+  withServer(async (base) => {
+    const r = await req(base, 'POST', '/contacts/99999/deals/bulk', { deals: [{ title: 'a' }] });
+    assert.equal(r.status, 404);
+  }));
+
+test('bulk with empty array → 400', () =>
+  withServer(async (base) => {
+    const c = await req(base, 'POST', '/contacts', mkContact());
+    const r = await req(base, 'POST', `/contacts/${c.body.id}/deals/bulk`, { deals: [] });
+    assert.equal(r.status, 400);
+  }));
+
+test('bulk with non-array deals → 400', () =>
+  withServer(async (base) => {
+    const c = await req(base, 'POST', '/contacts', mkContact());
+    const r = await req(base, 'POST', `/contacts/${c.body.id}/deals/bulk`, { deals: 'nope' });
+    assert.equal(r.status, 400);
+  }));
+
+test('bulk with one invalid item → 400', () =>
+  withServer(async (base) => {
+    const c = await req(base, 'POST', '/contacts', mkContact());
+    const r = await req(base, 'POST', `/contacts/${c.body.id}/deals/bulk`, { deals: [{ title: 'ok' }, { title: '' }] });
+    assert.equal(r.status, 400);
+  }));
+
+test('bulk is atomic — an invalid item inserts NOTHING', () =>
+  withServer(async (base) => {
+    const c = await req(base, 'POST', '/contacts', mkContact());
+    await req(base, 'POST', `/contacts/${c.body.id}/deals/bulk`, { deals: [{ title: 'ok', amount: 10 }, { title: 'bad', amount: -1 }] });
+    const list = await req(base, 'GET', `/contacts/${c.body.id}/deals`);
+    assert.equal(list.body.total, 0);
+  }));

package/dist/code/benchmark/microcrm/assets/idempotency.test.mjs

@@ -0,0 +1,64 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { createApp } from '../src/app.js';
+
+async function withServer(run) {
+  const server = createApp(':memory:');
+  await new Promise((res) => server.listen(0, res));
+  const { port } = server.address();
+  try { await run(`http://127.0.0.1:${port}`); } finally { await new Promise((res) => server.close(res)); }
+}
+async function req(base, method, path, body, headers = {}) {
+  const init = { method, headers: { ...headers } };
+  if (body !== undefined) { init.headers['content-type'] = 'application/json'; init.body = JSON.stringify(body); }
+  const res = await fetch(base + path, init);
+  const text = await res.text();
+  let json = null; try { json = text ? JSON.parse(text) : null; } catch { json = null; }
+  return { status: res.status, body: json };
+}
+const mkContact = (over = {}) => ({ name: 'A', email: `a${Math.random().toString(36).slice(2)}@x.com`, ...over });
+
+test('repeating a POST with the same Idempotency-Key does not create a duplicate', () =>
+  withServer(async (base) => {
+    const c = mkContact();
+    const first = await req(base, 'POST', '/contacts', c, { 'idempotency-key': 'abc' });
+    assert.equal(first.status, 201);
+    const second = await req(base, 'POST', '/contacts', c, { 'idempotency-key': 'abc' });
+    assert.equal(second.body.id, first.body.id);
+    const list = await req(base, 'GET', '/contacts');
+    assert.equal(list.body.total, 1);
+  }));
+
+test('replay with the same key returns 200 (not a new 201)', () =>
+  withServer(async (base) => {
+    const c = mkContact();
+    await req(base, 'POST', '/contacts', c, { 'idempotency-key': 'k1' });
+    const replay = await req(base, 'POST', '/contacts', c, { 'idempotency-key': 'k1' });
+    assert.equal(replay.status, 200);
+  }));
+
+test('different keys create different contacts', () =>
+  withServer(async (base) => {
+    await req(base, 'POST', '/contacts', mkContact(), { 'idempotency-key': 'k1' });
+    await req(base, 'POST', '/contacts', mkContact(), { 'idempotency-key': 'k2' });
+    const list = await req(base, 'GET', '/contacts');
+    assert.equal(list.body.total, 2);
+  }));
+
+test('no key behaves normally — each POST creates', () =>
+  withServer(async (base) => {
+    await req(base, 'POST', '/contacts', mkContact());
+    await req(base, 'POST', '/contacts', mkContact());
+    const list = await req(base, 'GET', '/contacts');
+    assert.equal(list.body.total, 2);
+  }));
+
+test('replayed key returns the original even if the body changed (no 409)', () =>
+  withServer(async (base) => {
+    const original = mkContact();
+    const first = await req(base, 'POST', '/contacts', original, { 'idempotency-key': 'same' });
+    const replay = await req(base, 'POST', '/contacts', mkContact(), { 'idempotency-key': 'same' });
+    assert.equal(replay.status, 200);
+    assert.equal(replay.body.id, first.body.id);
+    assert.equal(replay.body.email, original.email);
+  }));