import {z} from 'zod' export type DataProfile = 'fleet' | 'endUser'; export type Range = string; export type TripStateEnum = 'Nominal' | 'Unstarted' | 'DataLacking' | 'Unfinished'; export type TripStateEnumArray = Array; export type IndexRange = string; export type GetApiFleetsFidTripsArgs = {fid: string, profile?: DataProfile | undefined, timestamps?: Array | undefined, distance?: Range | undefined, duration?: Range | undefined, states?: TripStateEnumArray | undefined, indexRange?: IndexRange | undefined, pageSize?: number | undefined, pageToken?: string | undefined}; export type GetApiFleetsFidTripsOptions = {baseUrl?: string | undefined, BasicAuth?: {username: string, password: string} | undefined, ClientId?: string | undefined, fetch?: typeof fetch | undefined}; export const url = z.string(); export const link = z.object({href: url, templated: z.boolean().optional(), type: z.string().optional(), deprecation: z.string().optional(), name: z.string().optional(), title: z.string().optional(), profile: z.string().optional(), hreflang: z.string().optional()}); export const tabLinks = z.object({self: link, first: link, next: link.optional(), prev: link.optional(), last: link.optional()}); export const vin = z.string(); export const point = z.object({coordinates: z.array(z.number()), type: z.literal("Point")}); export const position = z.object({type: z.literal("Feature"), geometry: point, properties: z.object({createdAt: z.string(), vin: vin.optional(), heading: z.number().int().gte(0).lte(360).optional(), signalQuality: z.number().int().optional(), type: z.enum(["Estimated", "Acquire"]).optional(), fixStatus: z.enum(["2D", "3D"]).optional()})}); export const energyType = z.enum(["Fuel", "Electric"]); export const energySubType = z.enum(["FossilEnergy", "ElectricEnergy", "Hydrogen"]); export const liteEnergy = z.object({type: energyType.optional(), subType: energySubType.optional(), level: z.number().gte(0).lte(100).optional(), autonomy: z.number().int().optional()}); export const energyConsumption = z.object({consumption: z.number().gte(0), avgConsumption: z.number().optional(), type: energyType, subType: energySubType.optional()}); export const tripSegment = z.object({propulsion: z.enum(["Thermal", "Electric", "Hybrid"]).optional(), percent: z.number().optional(), distance: z.number().optional()}); export const trip = z.object({createdAt: z.string(), updatedAt: z.string().optional(), _links: z.object({self: link, vehicle: link.optional(), waypoints: link.optional(), alerts: link.optional(), collisions: link.optional()}), id: z.string(), vin: vin, startedAt: z.string().optional(), stoppedAt: z.string().optional(), startPosition: position.optional(), stopPosition: position.optional(), duration: z.number().int().optional(), distance: z.number().optional(), startMileage: z.number().optional(), startEnergies: z.array(liteEnergy).optional(), endEnergies: z.array(liteEnergy).optional(), energyConsumptions: z.array(energyConsumption).optional(), kinetic: z.object({avgSpeed: z.number().optional(), maxSpeed: z.number().optional()}).optional(), segments: z.array(tripSegment).optional(), done: z.boolean().optional(), faults: z.array(z.object({fault: z.enum(["Unstarted", "DataLacking", "Unfinished"]).optional(), cause: z.enum(["GeoPrivacy", "FullPrivacy", "Connection"]).optional()})).optional()}); export const trips = z.object({_links: tabLinks, total: z.number().int(), totalPage: z.number().int(), currentPage: z.number().int(), _embedded: z.object({trips: z.array(trip).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 }; /** * Trips of all vehicles of the fleet. * * GET /fleets/{fid}/trips */ export const getApiFleetsFidTrips = async (args: GetApiFleetsFidTripsArgs, options?: GetApiFleetsFidTripsOptions) => { const {baseUrl = "https://api-cert.groupe-psa.com/connectedcar/v3", fetch: fetchFn = fetch, BasicAuth, ClientId} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/hal+json") if (args.profile != null) query.append("profile", String(args.profile)) for (const item of args.timestamps ?? []) query.append("timestamps", String(item)) if (args.distance != null) query.append("distance", String(args.distance)) if (args.duration != null) query.append("duration", String(args.duration)) for (const item of args.states ?? []) query.append("states", String(item)) if (args.indexRange != null) query.append("indexRange", String(args.indexRange)) if (args.pageSize != null) query.append("pageSize", String(args.pageSize)) if (args.pageToken != null) query.append("pageToken", String(args.pageToken)) if (BasicAuth !== undefined) headers.set('authorization', `Basic ${btoa(`${BasicAuth.username}:${BasicAuth.password}`)}`) if (ClientId !== undefined) query.set("client_id", ClientId) const url = `${baseUrl.replace(/\/+$/, '')}/fleets/${encodeURIComponent(String(args.fid))}/trips${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(trips, await res.json()) };