import {z} from 'zod' export type JobSortOptions = 'createdAt' | 'scheduledAt'; export type SortDirection = 'ascending' | 'descending'; export type JobStatus = 'new' | 'scheduled' | 'unscheduled' | 'sent' | 'read' | 'accepted' | 'refused' | 'onTheWay' | 'started' | 'suspended' | 'completedOk' | 'completedWithIssues' | 'cancelled' | 'lateStart' | 'lateFinish' | 'rescheduled'; export type GetApiV1JobsArgs = {'Customer-Id': number, sortBy?: JobSortOptions | undefined, direction?: SortDirection | undefined, id?: Array | undefined, typeId?: Array | undefined, contactId?: Array | undefined, orderNumber?: Array | undefined, createdAtFrom?: string | undefined, createdAtTo?: string | undefined, resourceId?: Array | undefined, vehicleId?: Array | undefined, reference?: Array | undefined, plannedAtFrom?: string | undefined, plannedAtTo?: string | undefined, startAtFrom?: string | undefined, startAtTo?: string | undefined, statusModifiedAtFrom?: string | undefined, statusModifiedAtTo?: string | undefined, status?: Array | undefined, pageNumber?: number | undefined, pageSize?: number | undefined}; export type GetApiV1JobsOptions = {baseUrl?: string | undefined, bearer?: string | undefined, fetch?: typeof fetch | undefined}; export const location = z.object({latitude: z.number(), longitude: z.number()}); export const jobStatus = z.enum(["new", "scheduled", "unscheduled", "sent", "read", "accepted", "refused", "onTheWay", "started", "suspended", "completedOk", "completedWithIssues", "cancelled", "lateStart", "lateFinish", "rescheduled"]); export const customFieldType = z.enum(["boolean", "integer", "decimal", "text", "list", "statement", "date", "note", "time", "systemList"]); export const customFieldEmbeddedDefinitionModel = z.object({caption: z.string().optional(), type: customFieldType.optional(), listOptions: z.array(z.string()).nullable().optional(), isRequired: z.boolean().optional(), isEditable: z.boolean().optional(), default: z.string().nullable().optional()}); export const customFieldSystemListType = z.enum(["resource", "vehicle", "webUser"]); export const systemListValueMetadataModel = z.object({label: z.string().nullable().optional(), entityType: customFieldSystemListType.optional()}); export const customFieldReadModel = z.object({definitionId: z.number().int().optional(), value: z.string().nullable().optional(), definition: customFieldEmbeddedDefinitionModel.optional(), systemListValueMetadata: systemListValueMetadataModel.optional()}); export const readJobAssistantModel = z.object({resourceId: z.number().int().nullable().optional(), resourceName: z.string().nullable().optional()}); export const readJobModel = z.object({id: z.number().int().optional(), uid: z.string().nullable().optional(), typeId: z.number().int().optional(), typeName: z.string().optional(), contactId: z.number().int().optional(), contactName: z.string().optional(), contactAddress: z.string().optional(), contactLocation: location.optional(), status: jobStatus.optional(), statusModifiedAt: z.string().nullable().optional(), statusRecordedAt: z.string().nullable().optional(), plannedDuration: z.number().int().optional(), dueAt: z.string().nullable().optional(), reference: z.string().optional(), description: z.string().optional(), createdAt: z.string().optional(), orderNumber: z.string().nullable().optional(), personId: z.string().nullable().optional(), personName: z.string().nullable().optional(), isConfirmed: z.boolean().optional(), categoryId: z.number().int().nullable().optional(), categoryName: z.string().nullable().optional(), resourceId: z.number().int().nullable().optional(), resourceName: z.string().nullable().optional(), vehicleId: z.number().int().nullable().optional(), vehicleRegistration: z.string().nullable().optional(), plannedStartAt: z.string().nullable().optional(), plannedEndAt: z.string().nullable().optional(), actualStartAt: z.string().nullable().optional(), actualEndAt: z.string().nullable().optional(), actualDuration: z.number().int().nullable().optional(), internalComment: z.string().optional(), resourcesComment: z.string().optional(), contactComment: z.string().optional(), result: z.string().nullable().optional(), jobGroupId: z.number().int().nullable().optional(), isFinanciallyComplete: z.boolean().optional(), isActioned: z.boolean().optional(), officeNotes: z.string().optional(), contractId: z.number().int().nullable().optional(), recurrenceId: z.number().int().nullable().optional(), customFields: z.array(customFieldReadModel).optional(), assistants: z.array(readJobAssistantModel).optional(), siteContactIds: z.array(z.number().int()).optional(), salesOpportunityId: z.number().int().nullable().optional()}); export const pagedResponseReadJobModel = z.object({items: z.array(readJobModel).optional(), pageNumber: z.number().int().optional(), pageSize: z.number().int().optional(), pageItemCount: z.number().int().optional()}); export const validateResponse = async ( schema: { readonly '~standard': { readonly validate: (value: unknown) => ({ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }) | Promise<{ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }> } }, value: unknown ): Promise => { const result = await schema['~standard'].validate(value) if (result.issues !== undefined) { const detail = result.issues .map(({ message, path }) => path?.length ? `${path.map((segment) => String(typeof segment === 'object' ? segment.key : segment)).join('.')}: ${message}` : message ) .join('; ') throw new Error(`Response does not match the schema: ${detail}`, { cause: { issues: result.issues } }) } return result.value }; /** * Get a list of jobs * * GET /v1/jobs */ export const getApiV1Jobs = async (args: GetApiV1JobsArgs, options?: GetApiV1JobsOptions) => { const {baseUrl = "https://api.bigchange.com", fetch: fetchFn = fetch, bearer} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (args['Customer-Id'] != null) headers.set("Customer-Id", String(args['Customer-Id'])) if (args.sortBy != null) query.append("sortBy", String(args.sortBy)) if (args.direction != null) query.append("direction", String(args.direction)) for (const item of args.id ?? []) query.append("id", String(item)) for (const item of args.typeId ?? []) query.append("typeId", String(item)) for (const item of args.contactId ?? []) query.append("contactId", String(item)) for (const item of args.orderNumber ?? []) query.append("orderNumber", String(item)) if (args.createdAtFrom != null) query.append("createdAtFrom", String(args.createdAtFrom)) if (args.createdAtTo != null) query.append("createdAtTo", String(args.createdAtTo)) for (const item of args.resourceId ?? []) query.append("resourceId", String(item)) for (const item of args.vehicleId ?? []) query.append("vehicleId", String(item)) for (const item of args.reference ?? []) query.append("reference", String(item)) if (args.plannedAtFrom != null) query.append("plannedAtFrom", String(args.plannedAtFrom)) if (args.plannedAtTo != null) query.append("plannedAtTo", String(args.plannedAtTo)) if (args.startAtFrom != null) query.append("startAtFrom", String(args.startAtFrom)) if (args.startAtTo != null) query.append("startAtTo", String(args.startAtTo)) if (args.statusModifiedAtFrom != null) query.append("statusModifiedAtFrom", String(args.statusModifiedAtFrom)) if (args.statusModifiedAtTo != null) query.append("statusModifiedAtTo", String(args.statusModifiedAtTo)) for (const item of args.status ?? []) query.append("status", String(item)) if (args.pageNumber != null) query.append("pageNumber", String(args.pageNumber)) if (args.pageSize != null) query.append("pageSize", String(args.pageSize)) if (bearer !== undefined) headers.set('authorization', `Bearer ${bearer}`) const url = `${baseUrl.replace(/\/+$/, '')}/v1/jobs${query.size > 0 ? `?${query}` : ''}` const res = await fetchFn(url, {method: "GET", headers}) if (!res.ok) throw new Error(`Request failed with status ${res.status}`, {cause: {status: res.status, body: await res.text()}}) return validateResponse(pagedResponseReadJobModel, await res.json()) };