import {z} from 'zod' export type GetApiWorkersArgs = {from_date?: (string | null) | undefined, to_date?: (string | null) | undefined, limit?: (number | null) | undefined, include_schedule?: boolean | undefined, include_summary?: boolean | undefined, ops_group_handle?: (string | null) | undefined, profile?: (string | null) | undefined, worker_handle?: (string | null) | undefined, search_term?: (string | null) | undefined, pagination_token?: (string | null) | undefined, device_id?: (string | null) | undefined, include_deleted?: boolean | undefined, from_time?: (string | null) | undefined, to_time?: (string | null) | undefined, filter_outage?: (string | null) | undefined, filter_outage_category?: (string | null) | undefined, filter_geofence_metadata?: (string | null) | undefined, aggregate?: boolean | undefined, work_status?: (string | null) | undefined, filter_status?: ('active' | 'inactive' | 'disconnected' | 'null' | null) | undefined, tracked?: (boolean | null) | undefined, worked?: (boolean | null) | undefined, intended_to_track?: (boolean | null) | undefined, include_lp?: (boolean | null) | undefined, region_filter?: (string | null) | undefined}; export type GetApiWorkersOptions = {baseUrl?: string | undefined, BasicAuth?: {username: string, password: string} | undefined, fetch?: typeof fetch | undefined}; export const driverStatus1 = z.object({tracking: z.boolean(), available: z.boolean()}); export const driverDateSchedule = z.object({start_time: z.string(), end_time: z.string(), date: z.string(), ops_group_handle: z.string().nullable().optional(), priority: z.number().int().nullable().optional()}); export const driverRecurringSchedule = z.object({start_time: z.string(), end_time: z.string(), day_of_week: z.enum(["SUNDAY", "MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY", "SATURDAY"]), ops_group_handle: z.string().nullable().optional(), priority: z.number().int().nullable().optional()}); export const locationGeometryResponse = z.object({type: z.string(), coordinates: z.array(z.unknown())}); export const locationWithoutRadiusResponse = z.object({address: z.string().nullable().optional(), geometry: locationGeometryResponse}); export const movementLocationResponse = z.object({geometry: locationGeometryResponse, accuracy: z.number().nullable().optional(), bearing: z.number().nullable().optional(), speed: z.number().nullable().optional(), recorded_at: z.string().nullable().optional()}); export const deviceStatus1 = z.object({value: z.string(), data: z.record(z.string(), z.unknown())}); export const orderSummary1 = z.object({total: z.number().int(), completed: z.number().int(), cancelled: z.number().int(), tracked: z.number().int(), assigned: z.number().int(), completed_tasks: z.number().int()}); export const driverOutageSummary1 = z.object({code: z.string(), label: z.string(), description: z.string(), category: z.enum(["behavioural", "adversarial", "reachability", "os", "sporadic"]), duration: z.number().int(), distance: z.number().int()}); export const driverSummaryStatus1 = z.object({intended_to_track: z.boolean(), tracked: z.boolean(), worked: z.boolean(), available: z.boolean()}); export const driverSummary1 = z.object({orders: orderSummary1, geotags: z.number().int().nullable().optional(), visits: z.number().int().nullable().optional(), intended_track_duration: z.number().int(), outage_duration: z.number().int(), outage_distance: z.number().int(), outage_summary: z.array(driverOutageSummary1), tracked_duration: z.number().int(), tracked_distance: z.number().int(), avg_distance_per_visit: z.number(), drive_duration: z.number().int(), walk_duration: z.number().int(), stop_duration: z.number().int(), order_duration: z.number().int(), visit_duration: z.number().int(), geotag_duration: z.number().int(), tracking_rate: z.number().nullable().optional(), stop_count: z.number().int().nullable().optional(), walk_count: z.number().int().nullable().optional(), drive_count: z.number().int().nullable().optional(), distance: z.number().int().nullable().optional(), available_duration: z.number().int().nullable().optional(), work_duration: z.number().int().nullable().optional(), disconnected_duration: z.number().int().nullable().optional(), status: driverSummaryStatus1}); export const locationPermission1 = z.object({state: z.enum(["always", "foreground_only", "never", "location_imprecise", "unknown"]), recorded_at: z.string().nullable().optional()}); export const deviceInfo = z.object({timezone: z.string(), os_name: z.string(), device_brand: z.string(), sdk_version: z.string(), device_model: z.string(), network_operator: z.string().nullable().optional(), os_version: z.string(), os_hardware_identifier: z.string(), app_name: z.string(), app_version_string: z.string().nullable().optional(), app_version_number: z.string().nullable().optional()}); export const batteryStatus1 = z.object({battery_percent: z.number().int(), recorded_at: z.string()}); export const worker = z.object({worker_handle: z.string(), name: z.string().nullable().optional(), ops_group_handle: z.string(), product_types: z.array(z.string()).nullable().optional(), device_id: z.string().nullable().optional(), profile: z.record(z.string(), z.unknown()).nullable().optional(), work_status: driverStatus1, schedule: z.array(z.union([driverDateSchedule, driverRecurringSchedule])).nullable().optional(), deleted: z.boolean().nullable().optional(), created_at: z.string(), home: z.union([locationWithoutRadiusResponse, z.unknown()]).optional(), deleted_at: z.string().nullable().optional(), location: z.union([movementLocationResponse, z.unknown()]).optional(), device_status: z.union([deviceStatus1, z.unknown()]).optional(), unavailable_on: z.array(z.string()).nullable().optional(), summary: z.union([driverSummary1, z.unknown()]).optional(), location_permission: z.union([locationPermission1, z.unknown()]).optional(), device_info: z.union([deviceInfo, z.unknown()]).optional(), battery: z.union([batteryStatus1, z.unknown()]).optional(), timezone: z.string().nullable().optional()}); export const geotagStats = z.object({mean: z.number().nullable().optional(), min: z.number().nullable().optional(), max: z.number().nullable().optional(), stdev: z.number().nullable().optional(), mean_by_driver: z.number().nullable().optional(), sum: z.number()}); export const geotagsAggregate = z.object({count: z.number().int(), distance: z.union([geotagStats, z.unknown()]).optional(), duration: z.union([geotagStats, z.unknown()]).optional(), deviation: z.union([geotagStats, z.unknown()]).optional()}); export const countGroup = z.object({total: z.number().int(), completed: z.number().int().nullable().optional(), cancelled: z.number().int().nullable().optional(), assigned: z.number().int().nullable().optional(), tracked: z.number().int().nullable().optional()}); export const orderStats = z.object({mean: z.number().nullable().optional(), min: z.number().nullable().optional(), max: z.number().nullable().optional(), stdev: z.number().nullable().optional(), mean_by_driver: z.number().nullable().optional(), sum: z.number()}); export const ordersAggregate = z.object({count: countGroup, distance: z.union([orderStats, z.unknown()]).optional(), duration: z.union([orderStats, z.unknown()]).optional(), deviation: z.union([orderStats, z.unknown()]).optional()}); export const driversAggregate1 = z.object({total: z.number().int().nullable().optional(), total_intended_to_track: z.number().int().nullable().optional(), worked: z.number().int().nullable().optional(), tracked: z.number().int().nullable().optional(), untracked: z.number().int().nullable().optional(), disconnected: z.number().int().nullable().optional(), tracked_not_worked: z.number().int().nullable().optional()}); export const summaryAggregate = z.object({tracked_duration: z.number().int().nullable().optional(), tracked_distance: z.number().int().nullable().optional(), outage_duration: z.number().int().nullable().optional(), outage_distance: z.number().int().nullable().optional(), drive_duration: z.number().int().nullable().optional(), stop_duration: z.number().int().nullable().optional(), walk_duration: z.number().int().nullable().optional()}); export const driverOutageSummaryAggregate = z.object({code: z.string(), label: z.string(), description: z.string(), category: z.enum(["behavioural", "adversarial", "reachability", "os", "sporadic"]), duration: z.number().int(), duration_untracked: z.number().int(), duration_tracked: z.number().int(), distance: z.number().int()}); export const locationPermissionStateCounts = z.object({always: z.number().int(), foreground_only: z.number().int(), never: z.number().int(), unknown: z.number().int()}); export const visitAggregateModel = z.object({count: z.number().int()}); export const workerAggregate = z.object({geotags: geotagsAggregate.optional(), orders: ordersAggregate.optional(), workers: driversAggregate1.optional(), summary: summaryAggregate.optional(), tracking_rate: z.number().nullable().optional(), outage_summary: z.array(driverOutageSummaryAggregate).nullable().optional(), location_permission_state_counts: locationPermissionStateCounts.optional(), visits: visitAggregateModel.optional()}); export const getWorkersResponse = z.object({workers: z.array(worker).nullable().optional(), pagination_token: z.string().nullable().optional(), aggregate: z.union([workerAggregate, z.unknown()]).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 Workers * * GET /workers/ * * Also accepts auth: TokenAuth */ export const getApiWorkers = async (args: GetApiWorkersArgs, options?: GetApiWorkersOptions) => { const {baseUrl = "https://v3.api.hypertrack.com", fetch: fetchFn = fetch, BasicAuth} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (args.from_date != null) query.append("from_date", String(args.from_date)) if (args.to_date != null) query.append("to_date", String(args.to_date)) if (args.limit != null) query.append("limit", String(args.limit)) if (args.include_schedule != null) query.append("include_schedule", String(args.include_schedule)) if (args.include_summary != null) query.append("include_summary", String(args.include_summary)) if (args.ops_group_handle != null) query.append("ops_group_handle", String(args.ops_group_handle)) if (args.profile != null) query.append("profile", String(args.profile)) if (args.worker_handle != null) query.append("worker_handle", String(args.worker_handle)) if (args.search_term != null) query.append("search_term", String(args.search_term)) if (args.pagination_token != null) query.append("pagination_token", String(args.pagination_token)) if (args.device_id != null) query.append("device_id", String(args.device_id)) if (args.include_deleted != null) query.append("include_deleted", String(args.include_deleted)) if (args.from_time != null) query.append("from_time", String(args.from_time)) if (args.to_time != null) query.append("to_time", String(args.to_time)) if (args.filter_outage != null) query.append("filter_outage", String(args.filter_outage)) if (args.filter_outage_category != null) query.append("filter_outage_category", String(args.filter_outage_category)) if (args.filter_geofence_metadata != null) query.append("filter_geofence_metadata", String(args.filter_geofence_metadata)) if (args.aggregate != null) query.append("aggregate", String(args.aggregate)) if (args.work_status != null) query.append("work_status", String(args.work_status)) if (args.filter_status != null) query.append("filter_status", String(args.filter_status)) if (args.tracked != null) query.append("tracked", String(args.tracked)) if (args.worked != null) query.append("worked", String(args.worked)) if (args.intended_to_track != null) query.append("intended_to_track", String(args.intended_to_track)) if (args.include_lp != null) query.append("include_lp", String(args.include_lp)) if (args.region_filter != null) query.append("region_filter", String(args.region_filter)) if (BasicAuth !== undefined) headers.set('authorization', `Basic ${btoa(`${BasicAuth.username}:${BasicAuth.password}`)}`) const url = `${baseUrl.replace(/\/+$/, '')}/workers/${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(getWorkersResponse, await res.json()) };