@hasna/invoices 0.1.3 → 0.1.5

package/dist/cli/index.js

@@ -2088,6 +2088,21 @@ function normalizePagination(options, defaults) {
   const offset = Number.isFinite(options.offset) ? Math.max(Math.trunc(options.offset), 0) : 0;
   return { limit, offset };
 }
+function assertInvoiceStatus(status) {
+  if (!INVOICE_STATUSES.has(status)) {
+    throw new RangeError(`Invalid invoice status: ${String(status)}`);
+  }
+}
+function assertPartyKind(kind) {
+  if (!PARTY_KINDS.has(kind)) {
+    throw new RangeError(`Invalid party kind: ${String(kind)}`);
+  }
+}
+function assertNonBlankString(value, field) {
+  if (typeof value !== "string" || value.trim().length === 0) {
+    throw new TypeError(`${field} must not be blank`);
+  }
+}
 function assertSafeCents(value, field) {
   if (!Number.isSafeInteger(value) || value < 0) {
     throw new RangeError(`${field} must be a safe nonnegative integer`);
@@ -2205,14 +2220,27 @@ function mapInvoiceLineRow(row) {
   };
 }
 function createParty(db, input) {
-  const id = input.id ?? randomUUID();
+  const id = input.id;
+  const kind = input.kind;
+  const legalName = input.legalName;
+  const email = input.email;
+  const taxId = input.taxId;
+  const country = input.country;
+  const address = input.address;
+  if (id !== undefined) {
+    assertNonBlankString(id, "id");
+  }
+  assertPartyKind(kind);
+  assertNonBlankString(legalName, "legalName");
+  const partyId = id ?? randomUUID();
   db.query(`
 INSERT INTO parties (id, kind, legal_name, email, tax_id, country, address)
 VALUES (?1, ?2, ?3, ?4, ?5, ?6, ?7)
-`).run(id, input.kind, input.legalName, input.email ?? null, input.taxId ?? null, input.country ?? null, input.address ?? null);
-  return getPartyById(db, id);
+`).run(partyId, kind, legalName, email ?? null, taxId ?? null, country ?? null, address ?? null);
+  return getPartyById(db, partyId);
 }
 function getPartyById(db, id) {
+  assertNonBlankString(id, "id");
   const row = db.query("SELECT * FROM parties WHERE id = ?1").get(id);
   return row ? mapPartyRow(row) : null;
 }
@@ -2223,8 +2251,28 @@ function listParties(db, kind) {
   return db.query("SELECT * FROM parties ORDER BY legal_name ASC").all().map(mapPartyRow);
 }
 function createInvoice(db, input) {
-  const preparedLines = prepareInvoiceLines(input.lines);
-  const invoiceId = input.id ?? randomUUID();
+  const id = input.id;
+  const number = input.number;
+  const issuerId = input.issuerId;
+  const customerId = input.customerId;
+  const currency = input.currency;
+  const notes = input.notes;
+  const issuedAt = input.issuedAt;
+  const dueAt = input.dueAt;
+  const lines = input.lines;
+  if (id !== undefined) {
+    assertNonBlankString(id, "id");
+  }
+  assertNonBlankString(number, "number");
+  assertNonBlankString(issuerId, "issuerId");
+  assertNonBlankString(customerId, "customerId");
+  assertNonBlankString(currency, "currency");
+  assertNonBlankString(issuedAt, "issuedAt");
+  if (dueAt !== undefined) {
+    assertNonBlankString(dueAt, "dueAt");
+  }
+  const preparedLines = prepareInvoiceLines(lines);
+  const invoiceId = id ?? randomUUID();
   let subtotalCents = 0;
   let taxCents = 0;
   for (const line of preparedLines) {
@@ -2241,7 +2289,7 @@ INSERT INTO invoices (
   id, number, issuer_id, customer_id, status, currency, notes, issued_at, due_at, subtotal_cents, tax_cents, total_cents
 )
 VALUES (?1, ?2, ?3, ?4, 'draft', ?5, ?6, ?7, ?8, ?9, ?10, ?11)
-`).run(invoiceId, input.number, input.issuerId, input.customerId, input.currency, input.notes ?? null, input.issuedAt, input.dueAt ?? null, subtotalCents, taxCents, totalCents);
+`).run(invoiceId, number, issuerId, customerId, currency, notes ?? null, issuedAt, dueAt ?? null, subtotalCents, taxCents, totalCents);
     const insertLine = db.query(`
 INSERT INTO invoice_lines (
   id, invoice_id, position, description, quantity, unit_price_cents, tax_rate_basis_points, line_total_cents
@@ -2267,12 +2315,14 @@ function getInvoiceById(db, id) {
 }
 function listInvoices(db, options = {}) {
   const { limit, offset } = normalizePagination(options, { limit: 50 });
-  if (options.status) {
+  if (options.status !== undefined) {
+    assertInvoiceStatus(options.status);
     return db.query("SELECT * FROM invoices WHERE status = ?1 ORDER BY issued_at DESC, created_at DESC LIMIT ?2 OFFSET ?3").all(options.status, limit, offset).map(mapInvoiceRow);
   }
   return db.query("SELECT * FROM invoices ORDER BY issued_at DESC, created_at DESC LIMIT ?1 OFFSET ?2").all(limit, offset).map(mapInvoiceRow);
 }
 function updateInvoiceStatus(db, id, status) {
+  assertInvoiceStatus(status);
   db.query("UPDATE invoices SET status = ?2, updated_at = datetime('now') WHERE id = ?1").run(id, status);
   const row = db.query("SELECT * FROM invoices WHERE id = ?1").get(id);
   return row ? mapInvoiceRow(row) : null;
@@ -2280,7 +2330,8 @@ function updateInvoiceStatus(db, id, status) {
 function searchInvoices(db, query, options = {}) {
   const { limit, offset } = normalizePagination(options, { limit: 20 });
   const escapedPhrase = `"${query.replace(/"/g, '""')}"`;
-  if (options.status) {
+  if (options.status !== undefined) {
+    assertInvoiceStatus(options.status);
     return db.query(`
 SELECT i.*
 FROM invoices_fts f
@@ -2302,7 +2353,11 @@ LIMIT ?2
 OFFSET ?3
 `).all(escapedPhrase, limit, offset).map(mapInvoiceRow);
 }
-var init_invoices = () => {};
+var INVOICE_STATUSES, PARTY_KINDS;
+var init_invoices = __esm(() => {
+  INVOICE_STATUSES = new Set(["draft", "sent", "partially_paid", "paid", "void", "overdue"]);
+  PARTY_KINDS = new Set(["issuer", "customer"]);
+});
 
 // src/db/database.ts
 import { mkdirSync } from "fs";
@@ -2471,7 +2526,7 @@ function listAgents(db) {
 }
 
 // src/lib/version.ts
-var VERSION = "0.0.1";
+var VERSION = "0.1.5";
 
 // src/cli/index.ts
 init_database();

package/dist/db/invoices.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"invoices.d.ts","sourceRoot":"","sources":["../../src/db/invoices.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"invoices.d.ts","sourceRoot":"","sources":["../../src/db/invoices.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,6 +1,6 @@
 // @bun
 // src/lib/version.ts
-var VERSION = "0.0.1";
+var VERSION = "0.1.5";
 // src/db/database.ts
 import { mkdirSync } from "fs";
 import { dirname, join } from "path";
@@ -205,11 +205,28 @@ function migrateDatabase(options = {}) {
 }
 // src/db/invoices.ts
 import { randomUUID } from "crypto";
+var INVOICE_STATUSES = new Set(["draft", "sent", "partially_paid", "paid", "void", "overdue"]);
+var PARTY_KINDS = new Set(["issuer", "customer"]);
 function normalizePagination(options, defaults) {
   const limit = Number.isFinite(options.limit) ? Math.max(Math.trunc(options.limit), 0) : defaults.limit;
   const offset = Number.isFinite(options.offset) ? Math.max(Math.trunc(options.offset), 0) : 0;
   return { limit, offset };
 }
+function assertInvoiceStatus(status) {
+  if (!INVOICE_STATUSES.has(status)) {
+    throw new RangeError(`Invalid invoice status: ${String(status)}`);
+  }
+}
+function assertPartyKind(kind) {
+  if (!PARTY_KINDS.has(kind)) {
+    throw new RangeError(`Invalid party kind: ${String(kind)}`);
+  }
+}
+function assertNonBlankString(value, field) {
+  if (typeof value !== "string" || value.trim().length === 0) {
+    throw new TypeError(`${field} must not be blank`);
+  }
+}
 function assertSafeCents(value, field) {
   if (!Number.isSafeInteger(value) || value < 0) {
     throw new RangeError(`${field} must be a safe nonnegative integer`);
@@ -327,14 +344,35 @@ function mapInvoiceLineRow(row) {
   };
 }
 function createParty(db, input) {
-  const id = input.id ?? randomUUID();
+  const id = input.id;
+  const kind = input.kind;
+  const legalName = input.legalName;
+  const email = input.email;
+  const taxId = input.taxId;
+  const country = input.country;
+  const address = input.address;
+  if (id !== undefined) {
+    assertNonBlankString(id, "id");
+  }
+  assertPartyKind(kind);
+  assertNonBlankString(legalName, "legalName");
+  const partyId = id ?? randomUUID();
   db.query(`
 INSERT INTO parties (id, kind, legal_name, email, tax_id, country, address)
 VALUES (?1, ?2, ?3, ?4, ?5, ?6, ?7)
-`).run(id, input.kind, input.legalName, input.email ?? null, input.taxId ?? null, input.country ?? null, input.address ?? null);
-  return getPartyById(db, id);
+`).run(partyId, kind, legalName, email ?? null, taxId ?? null, country ?? null, address ?? null);
+  return getPartyById(db, partyId);
 }
 function updateParty(db, id, updates) {
+  const legalName = updates.legalName;
+  const email = updates.email;
+  const taxId = updates.taxId;
+  const country = updates.country;
+  const address = updates.address;
+  assertNonBlankString(id, "id");
+  if (legalName !== undefined) {
+    assertNonBlankString(legalName, "legalName");
+  }
   db.query(`
 UPDATE parties
 SET legal_name = COALESCE(?2, legal_name),
@@ -344,10 +382,11 @@ SET legal_name = COALESCE(?2, legal_name),
     address = COALESCE(?6, address),
     updated_at = datetime('now')
 WHERE id = ?1
-`).run(id, updates.legalName ?? null, updates.email ?? null, updates.taxId ?? null, updates.country ?? null, updates.address ?? null);
+`).run(id, legalName ?? null, email ?? null, taxId ?? null, country ?? null, address ?? null);
   return getPartyById(db, id);
 }
 function getPartyById(db, id) {
+  assertNonBlankString(id, "id");
   const row = db.query("SELECT * FROM parties WHERE id = ?1").get(id);
   return row ? mapPartyRow(row) : null;
 }
@@ -358,8 +397,28 @@ function listParties(db, kind) {
   return db.query("SELECT * FROM parties ORDER BY legal_name ASC").all().map(mapPartyRow);
 }
 function createInvoice(db, input) {
-  const preparedLines = prepareInvoiceLines(input.lines);
-  const invoiceId = input.id ?? randomUUID();
+  const id = input.id;
+  const number = input.number;
+  const issuerId = input.issuerId;
+  const customerId = input.customerId;
+  const currency = input.currency;
+  const notes = input.notes;
+  const issuedAt = input.issuedAt;
+  const dueAt = input.dueAt;
+  const lines = input.lines;
+  if (id !== undefined) {
+    assertNonBlankString(id, "id");
+  }
+  assertNonBlankString(number, "number");
+  assertNonBlankString(issuerId, "issuerId");
+  assertNonBlankString(customerId, "customerId");
+  assertNonBlankString(currency, "currency");
+  assertNonBlankString(issuedAt, "issuedAt");
+  if (dueAt !== undefined) {
+    assertNonBlankString(dueAt, "dueAt");
+  }
+  const preparedLines = prepareInvoiceLines(lines);
+  const invoiceId = id ?? randomUUID();
   let subtotalCents = 0;
   let taxCents = 0;
   for (const line of preparedLines) {
@@ -376,7 +435,7 @@ INSERT INTO invoices (
   id, number, issuer_id, customer_id, status, currency, notes, issued_at, due_at, subtotal_cents, tax_cents, total_cents
 )
 VALUES (?1, ?2, ?3, ?4, 'draft', ?5, ?6, ?7, ?8, ?9, ?10, ?11)
-`).run(invoiceId, input.number, input.issuerId, input.customerId, input.currency, input.notes ?? null, input.issuedAt, input.dueAt ?? null, subtotalCents, taxCents, totalCents);
+`).run(invoiceId, number, issuerId, customerId, currency, notes ?? null, issuedAt, dueAt ?? null, subtotalCents, taxCents, totalCents);
     const insertLine = db.query(`
 INSERT INTO invoice_lines (
   id, invoice_id, position, description, quantity, unit_price_cents, tax_rate_basis_points, line_total_cents
@@ -402,12 +461,14 @@ function getInvoiceById(db, id) {
 }
 function listInvoices(db, options = {}) {
   const { limit, offset } = normalizePagination(options, { limit: 50 });
-  if (options.status) {
+  if (options.status !== undefined) {
+    assertInvoiceStatus(options.status);
     return db.query("SELECT * FROM invoices WHERE status = ?1 ORDER BY issued_at DESC, created_at DESC LIMIT ?2 OFFSET ?3").all(options.status, limit, offset).map(mapInvoiceRow);
   }
   return db.query("SELECT * FROM invoices ORDER BY issued_at DESC, created_at DESC LIMIT ?1 OFFSET ?2").all(limit, offset).map(mapInvoiceRow);
 }
 function updateInvoiceStatus(db, id, status) {
+  assertInvoiceStatus(status);
   db.query("UPDATE invoices SET status = ?2, updated_at = datetime('now') WHERE id = ?1").run(id, status);
   const row = db.query("SELECT * FROM invoices WHERE id = ?1").get(id);
   return row ? mapInvoiceRow(row) : null;
@@ -432,7 +493,8 @@ FROM invoices i;
 function searchInvoices(db, query, options = {}) {
   const { limit, offset } = normalizePagination(options, { limit: 20 });
   const escapedPhrase = `"${query.replace(/"/g, '""')}"`;
-  if (options.status) {
+  if (options.status !== undefined) {
+    assertInvoiceStatus(options.status);
     return db.query(`
 SELECT i.*
 FROM invoices_fts f

package/dist/lib/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.0.1";
+export declare const VERSION = "0.1.5";
 //# sourceMappingURL=version.d.ts.map

package/dist/mcp/index.js

@@ -4201,11 +4201,28 @@ function migrateDatabase(options = {}) {
 
 // src/db/invoices.ts
 import { randomUUID } from "crypto";
+var INVOICE_STATUSES = new Set(["draft", "sent", "partially_paid", "paid", "void", "overdue"]);
+var PARTY_KINDS = new Set(["issuer", "customer"]);
 function normalizePagination(options, defaults) {
   const limit = Number.isFinite(options.limit) ? Math.max(Math.trunc(options.limit), 0) : defaults.limit;
   const offset = Number.isFinite(options.offset) ? Math.max(Math.trunc(options.offset), 0) : 0;
   return { limit, offset };
 }
+function assertInvoiceStatus(status) {
+  if (!INVOICE_STATUSES.has(status)) {
+    throw new RangeError(`Invalid invoice status: ${String(status)}`);
+  }
+}
+function assertPartyKind(kind) {
+  if (!PARTY_KINDS.has(kind)) {
+    throw new RangeError(`Invalid party kind: ${String(kind)}`);
+  }
+}
+function assertNonBlankString(value, field) {
+  if (typeof value !== "string" || value.trim().length === 0) {
+    throw new TypeError(`${field} must not be blank`);
+  }
+}
 function assertSafeCents(value, field) {
   if (!Number.isSafeInteger(value) || value < 0) {
     throw new RangeError(`${field} must be a safe nonnegative integer`);
@@ -4323,14 +4340,27 @@ function mapInvoiceLineRow(row) {
   };
 }
 function createParty(db, input) {
-  const id = input.id ?? randomUUID();
+  const id = input.id;
+  const kind = input.kind;
+  const legalName = input.legalName;
+  const email = input.email;
+  const taxId = input.taxId;
+  const country = input.country;
+  const address = input.address;
+  if (id !== undefined) {
+    assertNonBlankString(id, "id");
+  }
+  assertPartyKind(kind);
+  assertNonBlankString(legalName, "legalName");
+  const partyId = id ?? randomUUID();
   db.query(`
 INSERT INTO parties (id, kind, legal_name, email, tax_id, country, address)
 VALUES (?1, ?2, ?3, ?4, ?5, ?6, ?7)
-`).run(id, input.kind, input.legalName, input.email ?? null, input.taxId ?? null, input.country ?? null, input.address ?? null);
-  return getPartyById(db, id);
+`).run(partyId, kind, legalName, email ?? null, taxId ?? null, country ?? null, address ?? null);
+  return getPartyById(db, partyId);
 }
 function getPartyById(db, id) {
+  assertNonBlankString(id, "id");
   const row = db.query("SELECT * FROM parties WHERE id = ?1").get(id);
   return row ? mapPartyRow(row) : null;
 }
@@ -4341,8 +4371,28 @@ function listParties(db, kind) {
   return db.query("SELECT * FROM parties ORDER BY legal_name ASC").all().map(mapPartyRow);
 }
 function createInvoice(db, input) {
-  const preparedLines = prepareInvoiceLines(input.lines);
-  const invoiceId = input.id ?? randomUUID();
+  const id = input.id;
+  const number = input.number;
+  const issuerId = input.issuerId;
+  const customerId = input.customerId;
+  const currency = input.currency;
+  const notes = input.notes;
+  const issuedAt = input.issuedAt;
+  const dueAt = input.dueAt;
+  const lines = input.lines;
+  if (id !== undefined) {
+    assertNonBlankString(id, "id");
+  }
+  assertNonBlankString(number, "number");
+  assertNonBlankString(issuerId, "issuerId");
+  assertNonBlankString(customerId, "customerId");
+  assertNonBlankString(currency, "currency");
+  assertNonBlankString(issuedAt, "issuedAt");
+  if (dueAt !== undefined) {
+    assertNonBlankString(dueAt, "dueAt");
+  }
+  const preparedLines = prepareInvoiceLines(lines);
+  const invoiceId = id ?? randomUUID();
   let subtotalCents = 0;
   let taxCents = 0;
   for (const line of preparedLines) {
@@ -4359,7 +4409,7 @@ INSERT INTO invoices (
   id, number, issuer_id, customer_id, status, currency, notes, issued_at, due_at, subtotal_cents, tax_cents, total_cents
 )
 VALUES (?1, ?2, ?3, ?4, 'draft', ?5, ?6, ?7, ?8, ?9, ?10, ?11)
-`).run(invoiceId, input.number, input.issuerId, input.customerId, input.currency, input.notes ?? null, input.issuedAt, input.dueAt ?? null, subtotalCents, taxCents, totalCents);
+`).run(invoiceId, number, issuerId, customerId, currency, notes ?? null, issuedAt, dueAt ?? null, subtotalCents, taxCents, totalCents);
     const insertLine = db.query(`
 INSERT INTO invoice_lines (
   id, invoice_id, position, description, quantity, unit_price_cents, tax_rate_basis_points, line_total_cents
@@ -4385,12 +4435,14 @@ function getInvoiceById(db, id) {
 }
 function listInvoices(db, options = {}) {
   const { limit, offset } = normalizePagination(options, { limit: 50 });
-  if (options.status) {
+  if (options.status !== undefined) {
+    assertInvoiceStatus(options.status);
     return db.query("SELECT * FROM invoices WHERE status = ?1 ORDER BY issued_at DESC, created_at DESC LIMIT ?2 OFFSET ?3").all(options.status, limit, offset).map(mapInvoiceRow);
   }
   return db.query("SELECT * FROM invoices ORDER BY issued_at DESC, created_at DESC LIMIT ?1 OFFSET ?2").all(limit, offset).map(mapInvoiceRow);
 }
 function updateInvoiceStatus(db, id, status) {
+  assertInvoiceStatus(status);
   db.query("UPDATE invoices SET status = ?2, updated_at = datetime('now') WHERE id = ?1").run(id, status);
   const row = db.query("SELECT * FROM invoices WHERE id = ?1").get(id);
   return row ? mapInvoiceRow(row) : null;
@@ -4402,7 +4454,8 @@ function deleteInvoice(db, id) {
 function searchInvoices(db, query, options = {}) {
   const { limit, offset } = normalizePagination(options, { limit: 20 });
   const escapedPhrase = `"${query.replace(/"/g, '""')}"`;
-  if (options.status) {
+  if (options.status !== undefined) {
+    assertInvoiceStatus(options.status);
     return db.query(`
 SELECT i.*
 FROM invoices_fts f

package/dist/server/index.js

@@ -4009,11 +4009,28 @@ function openInvoiceDatabase(options = {}) {
 
 // src/db/invoices.ts
 import { randomUUID } from "crypto";
+var INVOICE_STATUSES = new Set(["draft", "sent", "partially_paid", "paid", "void", "overdue"]);
+var PARTY_KINDS = new Set(["issuer", "customer"]);
 function normalizePagination(options, defaults) {
   const limit = Number.isFinite(options.limit) ? Math.max(Math.trunc(options.limit), 0) : defaults.limit;
   const offset = Number.isFinite(options.offset) ? Math.max(Math.trunc(options.offset), 0) : 0;
   return { limit, offset };
 }
+function assertInvoiceStatus(status) {
+  if (!INVOICE_STATUSES.has(status)) {
+    throw new RangeError(`Invalid invoice status: ${String(status)}`);
+  }
+}
+function assertPartyKind(kind) {
+  if (!PARTY_KINDS.has(kind)) {
+    throw new RangeError(`Invalid party kind: ${String(kind)}`);
+  }
+}
+function assertNonBlankString(value, field) {
+  if (typeof value !== "string" || value.trim().length === 0) {
+    throw new TypeError(`${field} must not be blank`);
+  }
+}
 function assertSafeCents(value, field) {
   if (!Number.isSafeInteger(value) || value < 0) {
     throw new RangeError(`${field} must be a safe nonnegative integer`);
@@ -4131,14 +4148,27 @@ function mapInvoiceLineRow(row) {
   };
 }
 function createParty(db, input) {
-  const id = input.id ?? randomUUID();
+  const id = input.id;
+  const kind = input.kind;
+  const legalName = input.legalName;
+  const email = input.email;
+  const taxId = input.taxId;
+  const country = input.country;
+  const address = input.address;
+  if (id !== undefined) {
+    assertNonBlankString(id, "id");
+  }
+  assertPartyKind(kind);
+  assertNonBlankString(legalName, "legalName");
+  const partyId = id ?? randomUUID();
   db.query(`
 INSERT INTO parties (id, kind, legal_name, email, tax_id, country, address)
 VALUES (?1, ?2, ?3, ?4, ?5, ?6, ?7)
-`).run(id, input.kind, input.legalName, input.email ?? null, input.taxId ?? null, input.country ?? null, input.address ?? null);
-  return getPartyById(db, id);
+`).run(partyId, kind, legalName, email ?? null, taxId ?? null, country ?? null, address ?? null);
+  return getPartyById(db, partyId);
 }
 function getPartyById(db, id) {
+  assertNonBlankString(id, "id");
   const row = db.query("SELECT * FROM parties WHERE id = ?1").get(id);
   return row ? mapPartyRow(row) : null;
 }
@@ -4149,8 +4179,28 @@ function listParties(db, kind) {
   return db.query("SELECT * FROM parties ORDER BY legal_name ASC").all().map(mapPartyRow);
 }
 function createInvoice(db, input) {
-  const preparedLines = prepareInvoiceLines(input.lines);
-  const invoiceId = input.id ?? randomUUID();
+  const id = input.id;
+  const number = input.number;
+  const issuerId = input.issuerId;
+  const customerId = input.customerId;
+  const currency = input.currency;
+  const notes = input.notes;
+  const issuedAt = input.issuedAt;
+  const dueAt = input.dueAt;
+  const lines = input.lines;
+  if (id !== undefined) {
+    assertNonBlankString(id, "id");
+  }
+  assertNonBlankString(number, "number");
+  assertNonBlankString(issuerId, "issuerId");
+  assertNonBlankString(customerId, "customerId");
+  assertNonBlankString(currency, "currency");
+  assertNonBlankString(issuedAt, "issuedAt");
+  if (dueAt !== undefined) {
+    assertNonBlankString(dueAt, "dueAt");
+  }
+  const preparedLines = prepareInvoiceLines(lines);
+  const invoiceId = id ?? randomUUID();
   let subtotalCents = 0;
   let taxCents = 0;
   for (const line of preparedLines) {
@@ -4167,7 +4217,7 @@ INSERT INTO invoices (
   id, number, issuer_id, customer_id, status, currency, notes, issued_at, due_at, subtotal_cents, tax_cents, total_cents
 )
 VALUES (?1, ?2, ?3, ?4, 'draft', ?5, ?6, ?7, ?8, ?9, ?10, ?11)
-`).run(invoiceId, input.number, input.issuerId, input.customerId, input.currency, input.notes ?? null, input.issuedAt, input.dueAt ?? null, subtotalCents, taxCents, totalCents);
+`).run(invoiceId, number, issuerId, customerId, currency, notes ?? null, issuedAt, dueAt ?? null, subtotalCents, taxCents, totalCents);
     const insertLine = db.query(`
 INSERT INTO invoice_lines (
   id, invoice_id, position, description, quantity, unit_price_cents, tax_rate_basis_points, line_total_cents
@@ -4193,12 +4243,14 @@ function getInvoiceById(db, id) {
 }
 function listInvoices(db, options = {}) {
   const { limit, offset } = normalizePagination(options, { limit: 50 });
-  if (options.status) {
+  if (options.status !== undefined) {
+    assertInvoiceStatus(options.status);
     return db.query("SELECT * FROM invoices WHERE status = ?1 ORDER BY issued_at DESC, created_at DESC LIMIT ?2 OFFSET ?3").all(options.status, limit, offset).map(mapInvoiceRow);
   }
   return db.query("SELECT * FROM invoices ORDER BY issued_at DESC, created_at DESC LIMIT ?1 OFFSET ?2").all(limit, offset).map(mapInvoiceRow);
 }
 function updateInvoiceStatus(db, id, status) {
+  assertInvoiceStatus(status);
   db.query("UPDATE invoices SET status = ?2, updated_at = datetime('now') WHERE id = ?1").run(id, status);
   const row = db.query("SELECT * FROM invoices WHERE id = ?1").get(id);
   return row ? mapInvoiceRow(row) : null;
@@ -4206,7 +4258,8 @@ function updateInvoiceStatus(db, id, status) {
 function searchInvoices(db, query, options = {}) {
   const { limit, offset } = normalizePagination(options, { limit: 20 });
   const escapedPhrase = `"${query.replace(/"/g, '""')}"`;
-  if (options.status) {
+  if (options.status !== undefined) {
+    assertInvoiceStatus(options.status);
     return db.query(`
 SELECT i.*
 FROM invoices_fts f

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/invoices",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Invoice generation and management for AI agents - CLI + MCP server + REST API + dashboard + SDK",
   "type": "module",
   "main": "dist/index.js",