feat(bookings): two-level clearance charges (port + misc) billed to customer with invoices

packages/types/src/freight/index.ts

@@ -807,6 +807,21 @@ export interface PricingBreakdown {
 
 export type DocumentReviewStatus = "PENDING" | "APPROVED" | "QUERIED";
 
+// ── Clearance history (per-booking action trail, History tab) ───────────────
+
+/** One recorded clearance action — review, workflow step, or charge. */
+export interface ClearanceHistoryEvent {
+  id: string;
+  /** Stable machine code, e.g. DOC_APPROVED, DECLARATION_UPLOADED. */
+  action: string;
+  /** Human sentence, frozen at write time. */
+  label: string;
+  actorType: "STAFF" | "CUSTOMER" | "SYSTEM";
+  actorName: string | null;
+  metadata: Record<string, unknown> | null;
+  at: string;
+}
+
 // ── Clearance charges (post-finalization customer billing) ──────────────────
 
 export type ClearanceChargeType = "PORT_CHARGES" | "MISCELLANEOUS";