@routeflow/types 1.0.0 → 1.0.3

package/src/exports.ts

@@ -3,9 +3,13 @@
  *
  * Type Flow: Prisma → API DTOs → OpenAPI → here → SDK → Client Apps
  *
- * NOTE: Response/Entity types are defined manually here until the API
- * adds proper Response DTOs with @ApiResponse decorators. Once that's done,
- * these can be replaced with generated types.
+ * IMPORTANT:
+ * - Types that have Response DTOs in API are re-exported from generated types
+ * - Types WITHOUT Response DTOs (Organization, User, Driver, Run, Stop, etc.)
+ *   are temporarily defined manually until API adds proper Response DTOs
+ *
+ * TODO: Once API adds Response DTOs for all entities, convert ALL manual
+ * definitions to re-exports from components['schemas']
  */
 
 import type { components, paths, operations } from './index.js';
@@ -16,11 +20,22 @@ export type { components, paths, operations };
 // ============================================================================
 // ENUMS (match Prisma schema enums)
 // ============================================================================
+// These should match the Prisma enums exactly
 
-export type Role = 'ADMIN' | 'DISPATCHER' | 'DRIVER';
+export type Role = 'ADMIN' | 'OWNER' | 'FLEET_MANAGER' | 'DISPATCHER' | 'ACCOUNTING' | 'DRIVER' | 'BROKER';
 
 export type RunStatus = 'DRAFT' | 'ASSIGNED' | 'IN_PROGRESS' | 'COMPLETED' | 'CANCELLED';
 
+export type CancellationReason =
+  | 'CUSTOMER_CANCELLED'
+  | 'DRIVER_CANCELLED'
+  | 'EQUIPMENT_ISSUE'
+  | 'WEATHER'
+  | 'RATE_DISPUTE'
+  | 'SCHEDULING_CONFLICT'
+  | 'NO_SHOW'
+  | 'OTHER';
+
 export type StopType = 'PICKUP' | 'DELIVERY';
 
 export type StopStatus =
@@ -66,10 +81,56 @@ export type DriverDispatchStatus =
   | 'DISPATCHED'
   | 'ASSIGNED';
 
+export type CustomerType = 'BROKER' | 'SHIPPER' | 'CARRIER';
+
+export type StatementStatus = 'DRAFT' | 'PENDING' | 'APPROVED' | 'PAID';
+
+export type MessageType = 'TEXT' | 'IMAGE' | 'DOCUMENT' | 'SYSTEM';
+
+export type ParsedDocumentStatus = 'PENDING' | 'PROCESSED' | 'FAILED' | 'NEEDS_REVIEW';
+
+export type ExtractedAssetType = 'DRIVER' | 'TRUCK' | 'TRAILER';
+
+export type ExtractedAssetStatus = 'PENDING' | 'APPROVED' | 'REJECTED' | 'MERGED';
+
+// ============================================================================
+// ENTITY TYPES - WITH Response DTOs (✅ Re-exported from generated types)
+// ============================================================================
+
+// Customer (has ResponseDto in API)
+export type Customer = components['schemas']['CustomerResponseDto'];
+export type CustomerList = components['schemas']['CustomerListResponseDto'];
+
+// Message (has ResponseDto in API)
+export type Message = components['schemas']['MessageResponseDto'];
+export type MessageList = components['schemas']['MessageListResponseDto'];
+
+// Statement (has ResponseDto in API)
+export type DriverStatement = components['schemas']['StatementResponseDto'];
+export type StatementList = components['schemas']['StatementListResponseDto'];
+
+// Referral (has ResponseDto in API)
+export type Referral = components['schemas']['ReferralResponseDto'];
+export type ReferralList = components['schemas']['ReferralListResponseDto'];
+export type ReferralStats = components['schemas']['ReferralStatsDto'];
+
+// Extracted Assets (has ResponseDto in API)
+export type ExtractedAsset = components['schemas']['ExtractedAssetResponseDto'];
+export type ExtractedAssetField = components['schemas']['ExtractedAssetFieldDto'];
+export type ExtractionResult = components['schemas']['ExtractionResultResponseDto'];
+export type PaginatedExtractions = components['schemas']['PaginatedExtractionsResponseDto'];
+export type BulkOperationResult = components['schemas']['BulkOperationResponseDto'];
+
+// Smart Parse (has DTOs in API)
+export type SmartParseDocument = components['schemas']['SmartParseDocumentDto'];
+export type SmartParseResult = components['schemas']['SmartParseResultDto'];
+export type SuggestedDriver = components['schemas']['SuggestedDriverDto'];
+export type SuggestedCustomer = components['schemas']['SuggestedCustomerDto'];
+
 // ============================================================================
-// ENTITY TYPES (Response types - match Prisma models)
-// TODO: Replace with generated types once API has Response DTOs
+// ENTITY TYPES - WITHOUT Response DTOs (⚠️ Temporary manual definitions)
 // ============================================================================
+// TODO: Replace with re-exports once API adds Response DTOs
 
 export interface Organization {
   id: string;
@@ -111,19 +172,30 @@ export interface Driver {
 export interface Run {
   id: string;
   name: string;
+  loadNumber: string | null;
   status: RunStatus;
   plannedDate: string;
   plannedEndDate: string | null;
   startedAt: string | null;
   completedAt: string | null;
+  cancelledAt: string | null;
+  cancellationReason: CancellationReason | null;
+  cancellationNotes: string | null;
   totalDistance: number | null;
   totalDuration: number | null;
+  totalPay: number | null;
+  equipmentType: string | null;
+  commodityDesc: string | null;
+  weight: number | null;
   orgId: string;
   driverId: string | null;
+  customerId: string | null;
   createdById: string;
+  cancelledById: string | null;
   createdAt: string;
   updatedAt: string;
   driver?: User;
+  customer?: Customer;
   stops?: Stop[];
   documents?: Document[];
 }
@@ -133,12 +205,14 @@ export interface Stop {
   sequence: number;
   type: StopType;
   status: StopStatus;
+  facilityName: string | null;
   address: string;
   lat: number;
   lng: number;
   contactName: string | null;
   contactPhone: string | null;
   notes: string | null;
+  referenceNumber: string | null;
   timeWindowStart: string | null;
   timeWindowEnd: string | null;
   arrivedAt: string | null;
@@ -248,6 +322,33 @@ export interface CompanyDocument {
   updatedAt: string;
 }
 
+export interface ParsedDocument {
+  id: string;
+  originalFileUrl: string;
+  fileName: string | null;
+  mimeType: string | null;
+  fileSize: number | null;
+  status: ParsedDocumentStatus;
+  parsedData: Record<string, unknown> | null;
+  confidence: number | null;
+  errorMessage: string | null;
+  createdRunId: string | null;
+  matchedCustomerId: string | null;
+  suggestedDriverId: string | null;
+  uploadedById: string;
+  orgId: string;
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface StatementLineItem {
+  description: string;
+  type: 'EARNING' | 'DEDUCTION';
+  amount: number;
+  runId?: string;
+  loadNumber?: string;
+}
+
 // ============================================================================
 // AUTH RESPONSE TYPES
 // ============================================================================
@@ -312,43 +413,77 @@ export interface TodaysRunsResponse {
 }
 
 // ============================================================================
-// REQUEST DTOs (from OpenAPI - these are generated)
+// REQUEST DTOs (✅ Re-exported from generated types)
 // ============================================================================
 
+// Auth DTOs
 export type RegisterDto = components['schemas']['RegisterDto'];
 export type LoginDto = components['schemas']['LoginDto'];
 export type TelegramAuthDto = components['schemas']['TelegramAuthDto'];
 export type TelegramLinkDto = components['schemas']['TelegramLinkDto'];
 export type RefreshTokenDto = components['schemas']['RefreshTokenDto'];
 
+// User DTOs
 export type CreateUserDto = components['schemas']['CreateUserDto'];
 export type UpdateUserDto = components['schemas']['UpdateUserDto'];
 export type LinkTelegramDto = components['schemas']['LinkTelegramDto'];
 
+// Organization DTOs
 export type CreateOrgDto = components['schemas']['CreateOrgDto'];
 export type UpdateOrgDto = components['schemas']['UpdateOrgDto'];
 export type InviteUserDto = components['schemas']['InviteUserDto'];
 
+// Run DTOs
 export type CreateRunDto = components['schemas']['CreateRunDto'];
 export type UpdateRunDto = components['schemas']['UpdateRunDto'];
 export type AssignDriverDto = components['schemas']['AssignDriverDto'];
 
+// Stop DTOs
 export type CreateStopDto = components['schemas']['CreateStopDto'];
 export type UpdateStopDto = components['schemas']['UpdateStopDto'];
 export type ReorderStopsDto = components['schemas']['ReorderStopsDto'];
 export type UpdateStopStatusDto = components['schemas']['UpdateStopStatusDto'];
 
+// Document DTOs
 export type CreateDocumentDto = components['schemas']['CreateDocumentDto'];
 export type CreateCompanyDocumentDto = components['schemas']['CreateCompanyDocumentDto'];
 
+// Magic Link DTOs
 export type CreateMagicLinkDto = components['schemas']['CreateMagicLinkDto'];
 
+// Asset DTOs
 export type CreateTruckDto = components['schemas']['CreateTruckDto'];
 export type UpdateTruckDto = components['schemas']['UpdateTruckDto'];
 export type CreateTrailerDto = components['schemas']['CreateTrailerDto'];
 export type UpdateTrailerDto = components['schemas']['UpdateTrailerDto'];
 export type AssignAssetDto = components['schemas']['AssignAssetDto'];
 
+// Customer DTOs
+export type CreateCustomerDto = components['schemas']['CreateCustomerDto'];
+export type UpdateCustomerDto = components['schemas']['UpdateCustomerDto'];
+
+// Message DTOs
+export type CreateMessageDto = components['schemas']['CreateMessageDto'];
+export type MarkReadDto = components['schemas']['MarkReadDto'];
+
+// Statement DTOs
+export type CreateStatementDto = components['schemas']['CreateStatementDto'];
+export type UpdateStatementDto = components['schemas']['UpdateStatementDto'];
+export type GenerateStatementDto = components['schemas']['GenerateStatementDto'];
+
+// Referral DTOs
+export type CreateReferralDto = components['schemas']['CreateReferralDto'];
+export type UpdateReferralDto = components['schemas']['UpdateReferralDto'];
+
+// Document Processing DTOs
+export type ParseRateConDto = components['schemas']['ParseRateConDto'];
+export type ExtractAssetsDto = components['schemas']['ExtractAssetsDto'];
+export type ApproveExtractionDto = components['schemas']['ApproveExtractionDto'];
+export type RejectExtractionDto = components['schemas']['RejectExtractionDto'];
+export type MergeExtractionDto = components['schemas']['MergeExtractionDto'];
+export type BulkApproveDto = components['schemas']['BulkApproveDto'];
+export type BulkRejectDto = components['schemas']['BulkRejectDto'];
+
 // ============================================================================
 // REQUEST TYPE ALIASES (for SDK compatibility)
 // ============================================================================
@@ -364,6 +499,17 @@ export type UpdateRunRequest = UpdateRunDto;
 export type CreateStopRequest = CreateStopDto;
 export type UpdateStopRequest = UpdateStopDto;
 
+export type CreateCustomerRequest = CreateCustomerDto;
+export type UpdateCustomerRequest = UpdateCustomerDto;
+
+export type CreateMessageRequest = CreateMessageDto;
+
+export type CreateStatementRequest = CreateStatementDto;
+export type UpdateStatementRequest = UpdateStatementDto;
+
+export type CreateReferralRequest = CreateReferralDto;
+export type UpdateReferralRequest = UpdateReferralDto;
+
 // ============================================================================
 // PAGINATION TYPES
 // ============================================================================
@@ -385,6 +531,9 @@ export type PaginatedStops = PaginatedResponse<Stop>;
 export type PaginatedDrivers = PaginatedResponse<User>;
 export type PaginatedTrucks = PaginatedResponse<Truck>;
 export type PaginatedTrailers = PaginatedResponse<Trailer>;
+export type PaginatedCustomers = PaginatedResponse<Customer>;
+export type PaginatedStatements = PaginatedResponse<DriverStatement>;
+export type PaginatedMessages = PaginatedResponse<Message>;
 
 // ============================================================================
 // TYPE HELPERS
@@ -400,3 +549,6 @@ export type QueryParams<T extends keyof paths, M extends keyof paths[T]> =
 
 export type RequestBody<T extends keyof paths, M extends keyof paths[T]> =
   paths[T][M] extends { requestBody: { content: { 'application/json': infer B } } } ? B : never;
+
+export type ResponseBody<T extends keyof paths, M extends keyof paths[T]> =
+  paths[T][M] extends { responses: { 200: { content: { 'application/json': infer R } } } } ? R : never;