Download Data Module

The BSTD Download Data Module gives you full control over your business records. Export any document type — from quotations and invoices to vehicle condition reports and NOC forms — directly into CSV or Excel format for offline analysis, compliance audits, and third-party reporting.

Export Formats

Choose the format that best fits your downstream workflow. The selection is saved to your company profile and persists across sessions.

Switching formats triggers a confirmation dialog and updates your preference via the Company settings API:

// Format selection is saved to your company profile
await saveCompanyPreference({
  download_data_format: "csv" // or "excel"
});

Document Types

Thirteen record categories are available for export. Each card displays a live count from your dashboard and initiates a secure download on click.

How It Works

1. Load Preferences: On mount, the dashboard hook fetches your company profile and current document counts.
2. Select Format: Toggle between CSV and Excel. A confirmation modal prevents accidental switches.
3. Initiate Download: Click any document card. A second confirmation modal warns about large datasets and confirms the export type.
4. Stream & Save: The frontend requests the export stream, receives a Blob, and triggers a browser download via a temporary Object URL.
5. Feedback: Loading spinners overlay the active card while the request is in flight. Errors surface via alert notifications.

The confirmation dialog component is reusable across format changes and downloads:

function ConfirmDialog({ open, title, message, onConfirm, onCancel }) {
  if (!open) return null;
  return (
    <div className="fixed inset-0 z-50 flex items-center justify-center p-4">
      <div className="absolute inset-0 bg-black/60 backdrop-blur-sm" />
      <div className="relative w-full max-w-md rounded-2xl border border-slate-700 bg-slate-900 p-6 shadow-2xl">
        <h3>{title}</h3>
        <p>{message}</p>
        <div className="flex justify-end gap-3">
          <button onClick={onCancel}>Cancel</button>
          <button onClick={onConfirm}>Confirm</button>
        </div>
      </div>
    </div>
  );
}

The download request abstraction handles authentication and Blob streaming:

// Triggered when user clicks a document card
const blob = await requestExport({
  format: currentFormat,   // "csv" | "excel"
  documentType: item.type, // e.g. "quotation", "invoice"
});

// Browser download via anchor tag + Blob URL
const url = window.URL.createObjectURL(blob);
const a = document.createElement("a");
a.href = url;
a.download = `${item.type}_data.${extension}`;
a.click();
window.URL.revokeObjectURL(url);