@arcforgelabs/flow 2026.10.53-1 → 2026.10.53-2

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@arcforgelabs/flow",
-  "version": "2026.10.53-1",
+  "version": "2026.10.53-2",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@arcforgelabs/flow",
-      "version": "2026.10.53-1",
+      "version": "2026.10.53-2",
       "license": "MIT",
       "dependencies": {
         "@clerk/backend": "3.25.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcforgelabs/flow",
-  "version": "2026.10.53-1",
+  "version": "2026.10.53-2",
   "description": "Invoicing, bill entry and a financial dashboard for labs, with Seazona and Xero integrations.",
   "license": "MIT",
   "repository": {

package/server/core/sending.js

@@ -439,7 +439,8 @@ export async function sendQueued(db, organisationId, { accounting, limit = WORKE
         summary.waiting += 1;
       } else {
         const error = result.error ?? { code: `send_${result.outcome}`, message: `Sending ended as ${result.outcome}.` };
-        await settle(db, organisationId, result.invoiceId, { sendState: 'failed', sendError: { code: error.code, message: error.message, ...(error.short ? { short: error.short } : {}) } });
+        const xero = xeroMatch(error);
+        await settle(db, organisationId, result.invoiceId, { sendState: 'failed', sendError: { code: error.code, message: error.message, ...(error.short ? { short: error.short } : {}), ...(xero ? { xero } : {}) } });
         summary.failed += 1;
         summary.refused = [...new Set([...(summary.refused ?? []), error.code])];
         const fact = refusalFact(known.get(result.invoiceId), error);
@@ -450,6 +451,17 @@ export async function sendQueued(db, organisationId, { accounting, limit = WORKE
   return summary;
 }
 
+// The Xero invoice a refusal matched, kept so the page can link to it.
+// Only an id, a number and a status. Anything else in the error stays out.
+function xeroMatch(error) {
+  const xero = error?.details?.xero;
+  if (!xero || typeof xero !== 'object') return null;
+  if (!INVOICE_ID.test(xero.invoiceId ?? '')) return null;
+  const number = INVOICE_NUMBER.test(xero.number ?? '') ? xero.number : null;
+  const status = /^[A-Z0-9_]{1,32}$/.test(xero.status ?? '') ? xero.status : null;
+  return { invoiceId: xero.invoiceId, ...(number ? { number } : {}), ...(status ? { status } : {}) };
+}
+
 function settle(db, organisationId, invoiceId, fields) {
   return db.update(invoices).set({ ...fields, sendUpdatedAt: sql`now()` })
     .where(and(eq(invoices.organisationId, organisationId), eq(invoices.id, invoiceId), eq(invoices.sendState, 'queued')));

package/server/db/schema.js

@@ -112,7 +112,8 @@ export const invoices = pgTable('invoices', {
   readyAt: timestamp('ready_at', { withTimezone: true }),
   readyBy: uuid('ready_by').references(() => people.id, { onDelete: 'set null' }),
   // Sending to the accounting system (server/core/sending.js): queued by a
-  // person, then sent or failed. `sendError` is { code, message } while failed.
+  // person, then sent or failed. `sendError` is { code, message, short?, xero? }
+  // while failed. `xero` is the matched invoice { invoiceId, number, status }.
   sendState: text('send_state'),
   sendError: jsonb('send_error'),
   sendRequestedBy: uuid('send_requested_by').references(() => people.id, { onDelete: 'set null' }),

package/server/ui/invoicing.js

@@ -1423,6 +1423,21 @@ function issuedView(invoice, ui, context, redraw) {
     ? h('button', { class: 'fx-btn', type: 'button', onclick: () => act('revise', `${invoice.number} is a draft again.`) }, 'Revise') : null;
   const preview = previewButton(ui, invoice.id);
   actionBar = h('div', { class: 'fx-ph__actions' }, [voidButton, reviseButton, preview, send].filter(Boolean));
+  // The same problem notice as a draft. A matched Xero invoice gets the
+  // same Open in Xero link as the Xero card (go.xero.com, reconcile.js).
+  const found = invoice.problems ?? [];
+  const shorts = found.length && found.every((p) => p.short) ? [...new Set(found.map((p) => p.short))].join(', ') : null;
+  const problemNotice = found.length
+    ? ui.notice([...new Set(found.map((p) => brief(p.message)))].join(' '), 'danger', 'Problem.', { short: shorts })
+    : null;
+  const matched = found.find((p) => /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(p.xero?.invoiceId ?? ''));
+  const openXero = matched ? h('a', {
+    class: 'fx-btn fx-btn--sm fx-btn--ghost',
+    href: `https://go.xero.com/AccountsReceivable/View.aspx?InvoiceID=${encodeURIComponent(matched.xero.invoiceId)}`,
+    target: '_blank',
+    rel: 'noopener',
+  }, 'Open in Xero') : null;
+  const problemRow = problemNotice ? (openXero ? h('div', { class: 'fx-offer' }, problemNotice, openXero) : problemNotice) : null;
   const header = h('header', { class: 'fx-ph' },
     h('div', { class: 'fx-ph__text' },
       h('h1', { class: 'fx-title' }, invoice.number),
@@ -1449,6 +1464,7 @@ function issuedView(invoice, ui, context, redraw) {
     chrome.record,
     chrome.pager,
     header,
+    problemRow,
     h('div', { class: 'fx-invoice__grid' },
       h('div', { class: 'fx-invoice__main' },
         h('section', { class: 'fx-card fx-doc' },