@osise/api-client 0.0.1 → 0.0.2

package/dist/types/types/job.d.ts

@@ -1,9 +1,43 @@
 /**
  * Job DTOs
+ * Types for job management, quotes, ratings, and artisan job operations
  */
-import { JobStatus, PaymentMethod, PaymentStatus, ServiceCategory } from './enums';
+import { JobStatus, JobUrgency, JobPriority, JobMediaType, QuoteStatus, PaymentMethod, PaymentStatus, AccountType, AvailabilityStatus, ServiceCategory } from './enums';
 import { Coordinates, PaginationParams, DateRange, Quote, RatingBreakdown } from './common';
-/** Create job request */
+import { AddressDto } from './consumer';
+/** Service category response */
+export interface ServiceCategoryDto {
+    id: string;
+    name: string;
+    description?: string;
+    iconUrl?: string;
+    basePrice: number;
+    isActive: boolean;
+    displayOrder: number;
+}
+/** Estimate request */
+export interface EstimateRequestDto {
+    serviceCategoryId: string;
+    description: string;
+    urgency?: string;
+    addressId?: string;
+    latitude?: number;
+    longitude?: number;
+}
+/** Estimate response */
+export interface EstimateResponseDto {
+    serviceCategory: ServiceCategoryDto;
+    estimatedMinPrice: number;
+    estimatedMaxPrice: number;
+    estimatedServiceFee: number;
+    estimatedTotalMin: number;
+    estimatedTotalMax: number;
+    estimatedResponseTimeMinutes: number;
+    availableArtisansCount: number;
+    notes?: string;
+    urgencySurchargePercent: number;
+}
+/** Create job request (legacy - for backwards compatibility) */
 export interface CreateJobRequestDto {
     serviceCategory: ServiceCategory;
     title: string;
@@ -15,6 +49,20 @@ export interface CreateJobRequestDto {
     photos?: string[];
     notes?: string;
 }
+/** Create job request (new format) */
+export interface CreateJobDto {
+    serviceCategoryId: string;
+    title: string;
+    description: string;
+    voiceNoteUrl?: string;
+    photoUrls?: string[];
+    videoUrls?: string[];
+    urgency?: JobUrgency;
+    scheduledDateTime?: string;
+    addressId: string;
+    preferredArtisanId?: string;
+    departmentCode?: string;
+}
 /** Update job request */
 export interface UpdateJobRequestDto {
     title?: string;
@@ -26,7 +74,7 @@ export interface UpdateJobRequestDto {
     photos?: string[];
     notes?: string;
 }
-/** Job request response */
+/** Job request response (legacy) */
 export interface JobRequestDto {
     id: string;
     requestNumber: string;
@@ -41,9 +89,9 @@ export interface JobRequestDto {
     photos: string[];
     notes?: string;
     assignedArtisan?: JobArtisanDto;
-    quote?: JobQuoteDto;
+    quote?: JobQuoteDtoLegacy;
     payment?: JobPaymentDto;
-    rating?: JobRatingDto;
+    rating?: JobRatingDtoLegacy;
     createdAt: string;
     updatedAt?: string;
     completedAt?: string;
@@ -59,7 +107,8 @@ export interface JobAddressDto {
     longitude: number;
     instructions?: string;
 }
-/** Artisan assigned to job */
+export type { AddressDto } from './consumer';
+/** Artisan assigned to job (legacy) */
 export interface JobArtisanDto {
     id: string;
     firstName: string;
@@ -71,8 +120,219 @@ export interface JobArtisanDto {
     currentLocation?: Coordinates;
     estimatedArrival?: string;
 }
-/** Job quote */
+/** Consumer info in job context */
+export interface JobConsumerDto {
+    id: string;
+    name: string;
+    phoneNumber: string;
+    profileImageUrl?: string;
+    accountType: AccountType;
+    companyName?: string;
+}
+/** Media item in job */
+export interface JobMediaDto {
+    id: string;
+    mediaType: JobMediaType;
+    url: string;
+    thumbnailUrl?: string;
+    caption?: string;
+    uploadContext?: string;
+    createdAt: string;
+}
+/** Job list item */
+export interface JobListItemDto {
+    id: string;
+    requestNumber: string;
+    referenceNumber?: string;
+    serviceCategory: ServiceCategory;
+    serviceCategoryName?: string;
+    title: string;
+    status: JobStatus;
+    address: string;
+    area?: string;
+    city?: string;
+    isUrgent: boolean;
+    urgency?: JobUrgency;
+    assignedArtisanName?: string;
+    assignedArtisanPhoto?: string;
+    artisanProfileImageUrl?: string;
+    totalAmount?: number;
+    approvedQuoteTotal?: number;
+    createdAt: string;
+    scheduledFor?: string;
+    scheduledDateTime?: string;
+    statusChangedAt?: string;
+}
+/** Full job detail response */
+export interface JobDetailDto {
+    id: string;
+    referenceNumber: string;
+    title: string;
+    description: string;
+    voiceNoteUrl?: string;
+    serviceCategory: ServiceCategoryDto;
+    status: JobStatus;
+    statusChangedAt: string;
+    urgency: JobUrgency;
+    priority: JobPriority;
+    scheduledDateTime?: string;
+    address: AddressDto;
+    latitude: number;
+    longitude: number;
+    consumer: JobConsumerDto;
+    artisan?: ArtisanForJobDto;
+    media: JobMediaDto[];
+    currentQuote?: JobQuoteDto;
+    rating?: JobRatingDto;
+    assignedAt?: string;
+    acknowledgedAt?: string;
+    enRouteAt?: string;
+    arrivedAt?: string;
+    startedAt?: string;
+    completedAt?: string;
+    confirmedCompletionAt?: string;
+    cancelledAt?: string;
+    cancellationReason?: string;
+    initialEstimate?: number;
+    approvedQuoteTotal?: number;
+    finalTotal?: number;
+    serviceFee?: number;
+    paymentMethod?: PaymentMethod;
+    paymentStatus?: PaymentStatus;
+    paidAt?: string;
+    canBeCancelled: boolean;
+    canBeRated: boolean;
+    hasPendingQuote: boolean;
+    isEscalated: boolean;
+    isRedo: boolean;
+    warrantyExpiresAt?: string;
+    createdAt: string;
+    updatedAt?: string;
+}
+/** Job status response */
+export interface JobStatusDto {
+    jobId: string;
+    referenceNumber: string;
+    status: JobStatus;
+    statusDisplayText: string;
+    statusChangedAt: string;
+    history: JobStatusHistoryItemDto[];
+    nextExpectedStatus?: string;
+    isActive: boolean;
+}
+/** Status history item */
+export interface JobStatusHistoryItemDto {
+    status: JobStatus;
+    statusDisplayText: string;
+    timestamp: string;
+    notes?: string;
+}
+/** Job updates/timeline event */
+export interface JobUpdateDto {
+    id: string;
+    type: string;
+    title: string;
+    message?: string;
+    actor?: string;
+    actorRole?: string;
+    timestamp: string;
+    metadata?: Record<string, unknown>;
+}
+/** Job timeline event (legacy) */
+export interface JobTimelineEventDto {
+    id: string;
+    eventType: string;
+    title: string;
+    description?: string;
+    actor?: string;
+    actorRole?: string;
+    timestamp: string;
+    metadata?: Record<string, unknown>;
+}
+/** Artisan info for job display */
+export interface ArtisanForJobDto {
+    id: string;
+    name: string;
+    profileImageUrl?: string;
+    phoneNumber?: string;
+    primaryTrade: string;
+    yearsOfExperience: number;
+    overallRating: number;
+    totalRatings: number;
+    completedJobs: number;
+    completionRate: number;
+    isVerified: boolean;
+    badges: string[];
+}
+/** ETA response */
+export interface EtaDto {
+    jobId: string;
+    estimatedArrivalTime?: string;
+    estimatedMinutes?: number;
+    estimatedDistanceKm?: number;
+    updatedAt?: string;
+    isEnRoute: boolean;
+    hasArrived: boolean;
+    message?: string;
+}
+/** Artisan location tracking */
+export interface LocationDto {
+    jobId: string;
+    latitude: number;
+    longitude: number;
+    updatedAt: string;
+    destinationLatitude: number;
+    destinationLongitude: number;
+    status: JobStatus;
+    heading?: number;
+    speedKmh?: number;
+}
+/** Quote item (material) */
+export interface QuoteItemDto {
+    id: string;
+    item: string;
+    quantity: number;
+    unit?: string;
+    unitPrice: number;
+    totalPrice: number;
+    notes?: string;
+}
+/** Create quote item */
+export interface CreateQuoteItemDto {
+    item: string;
+    quantity: number;
+    unit?: string;
+    unitPrice: number;
+    notes?: string;
+}
+/** Job quote response */
 export interface JobQuoteDto {
+    id: string;
+    jobId: string;
+    artisanId: string;
+    artisanName: string;
+    laborCost: number;
+    materials: QuoteItemDto[];
+    materialsTotal: number;
+    serviceFee: number;
+    total: number;
+    estimatedDurationMinutes: number;
+    estimatedDuration: string;
+    notes?: string;
+    status: QuoteStatus;
+    submittedAt: string;
+    expiresAt?: string;
+    approvedAt?: string;
+    rejectedAt?: string;
+    rejectionReason?: string;
+    negotiationMessage?: string;
+    version: number;
+    isPending: boolean;
+    isApproved: boolean;
+    isExpired: boolean;
+}
+/** Job quote (legacy format) */
+export interface JobQuoteDtoLegacy {
     id: string;
     quote: Quote;
     status: 'pending' | 'approved' | 'rejected' | 'revised';
@@ -82,7 +342,7 @@ export interface JobQuoteDto {
     rejectionReason?: string;
     revisionNumber: number;
 }
-/** Submit quote (artisan) */
+/** Submit quote (artisan) - legacy */
 export interface SubmitQuoteDto {
     laborCost: number;
     materials: {
@@ -93,11 +353,31 @@ export interface SubmitQuoteDto {
     estimatedDuration: string;
     notes?: string;
 }
-/** Approve/reject quote (consumer) */
+/** Create quote request (artisan) */
+export interface CreateQuoteDto {
+    laborCost: number;
+    materials: CreateQuoteItemDto[];
+    estimatedDurationMinutes: number;
+    notes?: string;
+}
+/** Approve/reject quote (consumer) - legacy */
 export interface QuoteDecisionDto {
     decision: 'approve' | 'reject';
     rejectionReason?: string;
 }
+/** Approve quote request */
+export interface ApproveQuoteDto {
+    notes?: string;
+}
+/** Reject quote request */
+export interface RejectQuoteDto {
+    reason: string;
+}
+/** Negotiate quote request */
+export interface NegotiateQuoteDto {
+    message: string;
+    suggestedTotal?: number;
+}
 /** Job payment */
 export interface JobPaymentDto {
     id: string;
@@ -121,8 +401,24 @@ export interface PaymentResponseDto {
     reference: string;
     expiresAt?: string;
 }
-/** Job rating */
+/** Job rating response */
 export interface JobRatingDto {
+    id: string;
+    jobId: string;
+    overallRating: number;
+    qualityRating: number;
+    punctualityRating: number;
+    professionalismRating: number;
+    valueRating: number;
+    reviewText?: string;
+    photoUrls?: string[];
+    artisanResponse?: string;
+    tipAmount?: number;
+    createdAt: string;
+    updatedAt?: string;
+}
+/** Job rating (legacy format) */
+export interface JobRatingDtoLegacy {
     id: string;
     overall: number;
     quality: number;
@@ -132,7 +428,7 @@ export interface JobRatingDto {
     reviewText?: string;
     createdAt: string;
 }
-/** Submit rating (consumer) */
+/** Submit rating (consumer) - legacy */
 export interface SubmitRatingDto {
     overall: number;
     quality: number;
@@ -141,44 +437,51 @@ export interface SubmitRatingDto {
     value: number;
     reviewText?: string;
 }
-/** Job list item */
-export interface JobListItemDto {
-    id: string;
-    requestNumber: string;
-    serviceCategory: ServiceCategory;
-    title: string;
-    status: JobStatus;
-    address: string;
-    isUrgent: boolean;
-    assignedArtisanName?: string;
-    assignedArtisanPhoto?: string;
-    totalAmount?: number;
-    createdAt: string;
-    scheduledFor?: string;
+/** Create rating request */
+export interface CreateRatingDto {
+    overallRating: number;
+    qualityRating: number;
+    punctualityRating: number;
+    professionalismRating: number;
+    valueRating: number;
+    reviewText?: string;
+    photoUrls?: string[];
 }
-/** Job filter parameters */
-export interface JobFilterDto extends PaginationParams, DateRange {
-    status?: JobStatus | JobStatus[];
-    serviceCategory?: ServiceCategory;
-    isUrgent?: boolean;
-    search?: string;
-    sortBy?: 'createdAt' | 'scheduledFor' | 'status' | 'amount';
-    sortDirection?: 'asc' | 'desc';
+/** Add tip request */
+export interface AddTipDto {
+    amount: number;
+    message?: string;
 }
 /** Cancel job request */
 export interface CancelJobDto {
     reason: string;
 }
-/** Job timeline event */
-export interface JobTimelineEventDto {
-    id: string;
-    eventType: string;
-    title: string;
-    description?: string;
-    actor?: string;
-    actorRole?: string;
-    timestamp: string;
-    metadata?: Record<string, unknown>;
+/** Reschedule job request */
+export interface RescheduleJobDto {
+    scheduledDateTime: string;
+    reason?: string;
+}
+/** Escalate job request */
+export interface EscalateJobDto {
+    reason: string;
+    details?: string;
+}
+/** Report issue request */
+export interface ReportIssueDto {
+    issueType: string;
+    description: string;
+    photoUrls?: string[];
+    preferredResolution?: string;
+}
+/** Request redo request */
+export interface RequestRedoDto {
+    reason: string;
+    photoUrls?: string[];
+    preferredDateTime?: string;
+}
+/** Confirm completion request */
+export interface ConfirmCompletionDto {
+    notes?: string;
 }
 /** Job dispute */
 export interface JobDisputeDto {
@@ -197,18 +500,56 @@ export interface CreateDisputeDto {
     description: string;
     photos?: string[];
 }
-/** Artisan job view */
-export interface ArtisanJobDto extends JobRequestDto {
-    consumerName: string;
-    consumerPhone: string;
-    distanceKm: number;
-    estimatedEarning: number;
+/** Accept job request */
+export interface AcceptJobDto {
+    estimatedArrivalMinutes: number;
+    notes?: string;
 }
-/** Artisan job filter */
-export interface ArtisanJobFilterDto extends PaginationParams, DateRange {
-    status?: JobStatus | JobStatus[];
-    sortBy?: 'createdAt' | 'completedAt' | 'earning';
-    sortDirection?: 'asc' | 'desc';
+/** Decline job request */
+export interface DeclineJobDto {
+    reason: string;
+    details?: string;
+}
+/** Acknowledge job request */
+export interface AcknowledgeJobDto {
+    estimatedArrivalMinutes: number;
+}
+/** Mark en route request */
+export interface MarkEnRouteDto {
+    latitude: number;
+    longitude: number;
+    estimatedArrivalMinutes: number;
+}
+/** Mark arrived request */
+export interface MarkArrivedDto {
+    latitude: number;
+    longitude: number;
+}
+/** Request materials request */
+export interface RequestMaterialsDto {
+    materials: CreateQuoteItemDto[];
+    reason: string;
+    photoUrls?: string[];
+}
+/** Job progress update request */
+export interface JobProgressUpdateDto {
+    message: string;
+    estimatedRemainingMinutes?: number;
+    photoUrls?: string[];
+}
+/** Mark job complete request */
+export interface MarkJobCompleteDto {
+    notes?: string;
+    photoUrls?: string[];
+    hasFinalAmountChange?: boolean;
+    finalLaborCost?: number;
+    finalMaterialsTotal?: number;
+    amountChangeReason?: string;
+}
+/** Confirm cash received request */
+export interface ConfirmCashReceivedDto {
+    amountReceived: number;
+    notes?: string;
 }
 /** Update job status (artisan) */
 export interface UpdateJobStatusDto {
@@ -216,11 +557,191 @@ export interface UpdateJobStatusDto {
     notes?: string;
     location?: Coordinates;
 }
-/** Artisan location update */
+/** Artisan location update (legacy) */
 export interface ArtisanLocationUpdateDto {
     latitude: number;
     longitude: number;
     heading?: number;
     speed?: number;
 }
+/** Update artisan location request */
+export interface UpdateArtisanLocationDto {
+    latitude: number;
+    longitude: number;
+    heading?: number;
+    speedKmh?: number;
+}
+/** Artisan job view (legacy) */
+export interface ArtisanJobDto extends JobRequestDto {
+    consumerName: string;
+    consumerPhone: string;
+    distanceKm: number;
+    estimatedEarning: number;
+}
+/** Artisan job detail (extends detail with artisan-specific info) */
+export interface ArtisanJobDetailDto extends JobDetailDto {
+    distanceKm: number;
+    estimatedEarning: number;
+    consumerRatingAverage?: number;
+}
+/** Job queue item (admin dispatch view) */
+export interface JobQueueItemDto {
+    id: string;
+    referenceNumber: string;
+    title: string;
+    serviceCategoryName: string;
+    status: JobStatus;
+    urgency: JobUrgency;
+    priority: JobPriority;
+    scheduledDateTime?: string;
+    consumerName: string;
+    consumerPhone: string;
+    accountType: AccountType;
+    companyName?: string;
+    area: string;
+    city: string;
+    latitude: number;
+    longitude: number;
+    assignedArtisanName?: string;
+    assignedArtisanId?: string;
+    availableArtisansCount: number;
+    waitingMinutes: number;
+    isEscalated: boolean;
+    hasPreferredArtisan: boolean;
+    tags?: string;
+    createdAt: string;
+    statusChangedAt: string;
+}
+/** Job queue filter */
+export interface JobQueueFilterDto extends PaginationParams {
+    status?: JobStatus | JobStatus[];
+    urgency?: JobUrgency | JobUrgency[];
+    priority?: JobPriority | JobPriority[];
+    serviceCategoryId?: string;
+    area?: string;
+    city?: string;
+    isEscalated?: boolean;
+    hasAssignedArtisan?: boolean;
+    search?: string;
+    sortBy?: 'createdAt' | 'waitingMinutes' | 'priority' | 'urgency';
+    sortDirection?: 'asc' | 'desc';
+}
+/** Active jobs filter */
+export interface ActiveJobsFilterDto extends PaginationParams {
+    status?: JobStatus | JobStatus[];
+    artisanId?: string;
+    serviceCategoryId?: string;
+    area?: string;
+    city?: string;
+    sortBy?: 'statusChangedAt' | 'scheduledDateTime' | 'priority';
+    sortDirection?: 'asc' | 'desc';
+}
+/** Available artisan for job (admin view) */
+export interface AvailableArtisanDto {
+    id: string;
+    name: string;
+    profileImageUrl?: string;
+    phoneNumber: string;
+    primaryTrade: string;
+    overallRating: number;
+    totalRatings: number;
+    completedJobs: number;
+    completionRate: number;
+    distanceKm: number;
+    estimatedTravelMinutes: number;
+    availabilityStatus: AvailabilityStatus;
+    activeJobsCount: number;
+    currentJobExpectedCompletion?: string;
+    isOnProbation: boolean;
+    yearsOfExperience: number;
+    isPreferred: boolean;
+    latitude: number;
+    longitude: number;
+}
+/** Suggested artisan (system recommendation) */
+export interface SuggestedArtisanDto extends AvailableArtisanDto {
+    suggestionScore: number;
+    suggestionReasons: string[];
+    rank: number;
+}
+/** Assign artisan request */
+export interface AssignArtisanDto {
+    artisanId: string;
+    notes?: string;
+    notifyArtisan?: boolean;
+    expectedResponseMinutes?: number;
+}
+/** Broadcast job request */
+export interface BroadcastJobDto {
+    artisanIds?: string[];
+    radiusKm?: number;
+    maxArtisans?: number;
+    message?: string;
+    expiresInMinutes?: number;
+}
+/** Reassign job request */
+export interface ReassignJobDto {
+    newArtisanId: string;
+    reason: string;
+    notifyCurrentArtisan?: boolean;
+    notifyNewArtisan?: boolean;
+}
+/** Update job priority request */
+export interface UpdateJobPriorityDto {
+    priority: JobPriority;
+    reason?: string;
+}
+/** Add job note request */
+export interface AddJobNoteDto {
+    content: string;
+    isInternal?: boolean;
+}
+/** Job note response */
+export interface JobNoteDto {
+    id: string;
+    jobId: string;
+    content: string;
+    isInternal: boolean;
+    createdBy: string;
+    createdByName: string;
+    createdAt: string;
+}
+/** Update job ETA request */
+export interface UpdateJobEtaDto {
+    estimatedArrivalTime: string;
+    reason?: string;
+}
+/** Log contact request */
+export interface LogContactDto {
+    contactedParty: 'customer' | 'artisan';
+    contactMethod: 'phone' | 'sms' | 'inApp';
+    outcome: 'reached' | 'noAnswer' | 'voicemail' | 'busy';
+    notes?: string;
+}
+/** Admin job detail (extended) */
+export interface AdminJobDetailDto extends JobDetailDto {
+    notes: JobNoteDto[];
+    statusHistory: JobStatusHistoryItemDto[];
+    dispatchedBy?: string;
+    dispatchedAt?: string;
+    totalContactAttempts: number;
+    lastContactAttemptAt?: string;
+}
+/** Consumer job filter */
+export interface JobFilterDto extends PaginationParams, DateRange {
+    status?: JobStatus | JobStatus[];
+    serviceCategory?: ServiceCategory;
+    urgency?: JobUrgency | JobUrgency[];
+    serviceCategoryId?: string;
+    isUrgent?: boolean;
+    search?: string;
+    sortBy?: 'createdAt' | 'scheduledFor' | 'scheduledDateTime' | 'status' | 'amount';
+    sortDirection?: 'asc' | 'desc';
+}
+/** Artisan job filter */
+export interface ArtisanJobFilterDto extends PaginationParams, DateRange {
+    status?: JobStatus | JobStatus[];
+    sortBy?: 'createdAt' | 'completedAt' | 'earning';
+    sortDirection?: 'asc' | 'desc';
+}
 //# sourceMappingURL=job.d.ts.map