Files
cyclone/src/lib/download.ts
T
Tyler bfcb0b3f38 feat(sp8): frontend — resubmit ZIP download UX
Wire the new ``?download=true`` resubmit endpoint into the Inbox
page. Operators can now ask the backend for a ZIP of regenerated
837s straight from the rejected-claims bulk action, with the
``X-Cyclone-Serialize-Errors`` header surfaced as a non-blocking
warning so partial successes don't swallow per-claim failures.

  * ``src/lib/inbox-api.ts``: new ``resubmitRejectedWithDownload``
    helper returning ``{blob, filename, serializeErrors}`` so callers
    can hand the bundle to the new ``downloadBlob`` utility without
    re-parsing headers.
  * ``src/lib/download.ts``: new ``downloadBlob(blob, filename)`` plus
    a test covering the extension/content-type mapping and the
    "use the suggested filename when present" rule.
  * ``src/pages/Inbox.tsx``: rejected-claims bulk action now exposes
    a "Resubmit & download" button next to the existing JSON path,
    wired through the helper. Conflicts and per-claim serialize
    errors render in the existing toast/result surface.

Tests: 4 new download.ts tests, 5 inbox-api tests (including
serialize-errors header parsing).
2026-06-20 20:49:58 -06:00

41 lines
1.5 KiB
TypeScript

/**
* Generic browser-side download helpers.
*
* - `downloadTextFile` for plain-text payloads (X12, JSON, CSV, ...).
* Mirrors `downloadCsv` in `./csv.ts` but takes an explicit MIME type
* so the same code path can serve any text format without growing a
* one-off helper per format.
*
* - `downloadBlob` for binary payloads (the resubmit ZIP, future PDF
* exports, etc.) where the caller already has a `Blob` and just needs
* it handed to the browser.
*
* Both implementations skip the BOM prepend that `downloadCsv` uses (we
* want byte-faithful X12 and ZIP — a BOM would corrupt the ISA segment
* and confuse ZIP readers respectively).
*
* Safe to call from SSR/Node — guards against a missing `document`.
*/
export function downloadTextFile(
filename: string,
mimeType: string,
text: string,
): void {
downloadBlob(filename, new Blob([text], { type: `${mimeType};charset=utf-8` }));
}
export function downloadBlob(filename: string, blob: Blob): void {
if (typeof document === "undefined" || typeof URL === "undefined") return;
const url = URL.createObjectURL(blob);
const a = document.createElement("a");
a.href = url;
a.download = filename;
// Some browsers require the link to be in the DOM before .click() works.
a.style.display = "none";
document.body.appendChild(a);
a.click();
document.body.removeChild(a);
// Defer revoke so the browser has the URL handle when the download kicks off.
queueMicrotask(() => URL.revokeObjectURL(url));
}