@findatruck/aggregator-client 1.1.0 → 1.1.2

package/dist/index.cjs

@@ -22,10 +22,16 @@ var index_exports = {};
 __export(index_exports, {
   AggregatorClient: () => AggregatorClient,
   AggregatorClientError: () => AggregatorClientError,
+  DriverRankingSchema: () => import_shared_schemas2.DriverRankingSchema,
+  DriverRankingsRequestSchema: () => import_shared_schemas2.DriverRankingsRequestSchema,
+  DriverRankingsResponseSchema: () => import_shared_schemas2.DriverRankingsResponseSchema,
   NewLoginRequestSchema: () => import_shared_schemas2.NewLoginRequestSchema,
   NewLoginResponseFailureSchema: () => import_shared_schemas2.NewLoginResponseFailureSchema,
   NewLoginResponseSchema: () => import_shared_schemas2.NewLoginResponseSchema,
   NewLoginResponseSuccessSchema: () => import_shared_schemas2.NewLoginResponseSuccessSchema,
+  StateHeatmapEntrySchema: () => import_shared_schemas2.StateHeatmapEntrySchema,
+  StateHeatmapRequestSchema: () => import_shared_schemas2.StateHeatmapRequestSchema,
+  StateHeatmapResponseSchema: () => import_shared_schemas2.StateHeatmapResponseSchema,
   ValidatePasswordRequestSchema: () => import_shared_schemas2.ValidatePasswordRequestSchema,
   ValidatePasswordResponseSchema: () => import_shared_schemas2.ValidatePasswordResponseSchema,
   endpoints: () => endpoints
@@ -46,6 +52,18 @@ var endpoints = {
     method: "POST",
     requestSchema: import_shared_schemas.ValidatePasswordRequestSchema,
     responseSchema: import_shared_schemas.ValidatePasswordResponseSchema
+  },
+  driverRankings: {
+    path: "/telemetry/driver-rankings",
+    method: "GET",
+    requestSchema: import_shared_schemas.DriverRankingsRequestSchema,
+    responseSchema: import_shared_schemas.DriverRankingsResponseSchema
+  },
+  stateHeatmap: {
+    path: "/telemetry/driver/:driver_id/heatmap",
+    method: "GET",
+    requestSchema: import_shared_schemas.StateHeatmapRequestSchema,
+    responseSchema: import_shared_schemas.StateHeatmapResponseSchema
   }
 };
 
@@ -116,6 +134,61 @@ var AggregatorClient = class {
     }
     return responseParseResult.data;
   }
+  /**
+   * Gets all drivers ranked by miles driven within a time range.
+   * Optionally filter by state.
+   */
+  async driverRankings(request) {
+    const endpoint = endpoints.driverRankings;
+    const parseResult = endpoint.requestSchema.safeParse(request);
+    if (!parseResult.success) {
+      throw new AggregatorClientError(
+        `Invalid request: ${parseResult.error.message}`,
+        endpoint.path
+      );
+    }
+    const response = await this.makeGetRequest(endpoint.path, request);
+    const responseParseResult = endpoint.responseSchema.safeParse(response);
+    if (!responseParseResult.success) {
+      throw new AggregatorClientError(
+        `Invalid response from aggregator: ${responseParseResult.error.message}`,
+        endpoint.path,
+        void 0,
+        response
+      );
+    }
+    return responseParseResult.data;
+  }
+  /**
+   * Gets a heatmap of telemetry locations by state for a specific driver.
+   * Returns the count and percentage of telemetry points in each state.
+   */
+  async stateHeatmap(request) {
+    const endpoint = endpoints.stateHeatmap;
+    const parseResult = endpoint.requestSchema.safeParse(request);
+    if (!parseResult.success) {
+      throw new AggregatorClientError(
+        `Invalid request: ${parseResult.error.message}`,
+        endpoint.path
+      );
+    }
+    const path = endpoint.path.replace(":driver_id", request.driver_id);
+    const queryParams = {
+      start_date: request.start_date,
+      end_date: request.end_date
+    };
+    const response = await this.makeGetRequest(path, queryParams);
+    const responseParseResult = endpoint.responseSchema.safeParse(response);
+    if (!responseParseResult.success) {
+      throw new AggregatorClientError(
+        `Invalid response from aggregator: ${responseParseResult.error.message}`,
+        endpoint.path,
+        void 0,
+        response
+      );
+    }
+    return responseParseResult.data;
+  }
   async makeRequest(path, method, body) {
     const url = `${this.baseUrl}${path}`;
     const response = await fetch(url, {
@@ -142,6 +215,36 @@ var AggregatorClient = class {
     }
     return response.json();
   }
+  async makeGetRequest(path, params) {
+    const searchParams = new URLSearchParams();
+    for (const [key, value] of Object.entries(params)) {
+      if (value !== void 0) {
+        searchParams.append(key, value);
+      }
+    }
+    const url = `${this.baseUrl}${path}?${searchParams.toString()}`;
+    const response = await fetch(url, {
+      method: "GET",
+      headers: {
+        "Authorization": `Bearer ${this.workerSecret}`
+      }
+    });
+    if (!response.ok) {
+      let responseBody;
+      try {
+        responseBody = await response.json();
+      } catch {
+        responseBody = await response.text();
+      }
+      throw new AggregatorClientError(
+        `Request to ${path} failed with status ${response.status}`,
+        path,
+        response.status,
+        responseBody
+      );
+    }
+    return response.json();
+  }
 };
 
 // src/index.ts
@@ -150,10 +253,16 @@ var import_shared_schemas2 = require("@findatruck/shared-schemas");
 0 && (module.exports = {
   AggregatorClient,
   AggregatorClientError,
+  DriverRankingSchema,
+  DriverRankingsRequestSchema,
+  DriverRankingsResponseSchema,
   NewLoginRequestSchema,
   NewLoginResponseFailureSchema,
   NewLoginResponseSchema,
   NewLoginResponseSuccessSchema,
+  StateHeatmapEntrySchema,
+  StateHeatmapRequestSchema,
+  StateHeatmapResponseSchema,
   ValidatePasswordRequestSchema,
   ValidatePasswordResponseSchema,
   endpoints

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { NewLoginRequest, NewLoginResponse, ValidatePasswordRequest, ValidatePasswordResponse } from '@findatruck/shared-schemas';
-export { NewLoginRequest, NewLoginRequestSchema, NewLoginResponse, NewLoginResponseFailure, NewLoginResponseFailureSchema, NewLoginResponseSchema, NewLoginResponseSuccess, NewLoginResponseSuccessSchema, ValidatePasswordRequest, ValidatePasswordRequestSchema, ValidatePasswordResponse, ValidatePasswordResponseSchema } from '@findatruck/shared-schemas';
+import { NewLoginRequest, NewLoginResponse, ValidatePasswordRequest, ValidatePasswordResponse, DriverRankingsRequest, DriverRankingsResponse, StateHeatmapRequest, StateHeatmapResponse } from '@findatruck/shared-schemas';
+export { DriverRanking, DriverRankingSchema, DriverRankingsRequest, DriverRankingsRequestSchema, DriverRankingsResponse, DriverRankingsResponseSchema, NewLoginRequest, NewLoginRequestSchema, NewLoginResponse, NewLoginResponseFailure, NewLoginResponseFailureSchema, NewLoginResponseSchema, NewLoginResponseSuccess, NewLoginResponseSuccessSchema, StateHeatmapEntry, StateHeatmapEntrySchema, StateHeatmapRequest, StateHeatmapRequestSchema, StateHeatmapResponse, StateHeatmapResponseSchema, ValidatePasswordRequest, ValidatePasswordRequestSchema, ValidatePasswordResponse, ValidatePasswordResponseSchema } from '@findatruck/shared-schemas';
 import { z } from 'zod';
 
 /**
@@ -55,7 +55,18 @@ declare class AggregatorClient {
      * Returns whether the password is valid and the associated driver IDs.
      */
     validatePassword(request: ValidatePasswordRequest): Promise<ValidatePasswordResponse>;
+    /**
+     * Gets all drivers ranked by miles driven within a time range.
+     * Optionally filter by state.
+     */
+    driverRankings(request: DriverRankingsRequest): Promise<DriverRankingsResponse>;
+    /**
+     * Gets a heatmap of telemetry locations by state for a specific driver.
+     * Returns the count and percentage of telemetry points in each state.
+     */
+    stateHeatmap(request: StateHeatmapRequest): Promise<StateHeatmapResponse>;
     private makeRequest;
+    private makeGetRequest;
 }
 
 /**
@@ -116,6 +127,34 @@ declare const endpoints: {
             driverIds: z.ZodArray<z.ZodString>;
         }, z.core.$strip>;
     };
+    readonly driverRankings: {
+        readonly path: "/telemetry/driver-rankings";
+        readonly method: "GET";
+        readonly requestSchema: z.ZodObject<{
+            start_date: z.ZodString;
+            end_date: z.ZodString;
+            state: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        readonly responseSchema: z.ZodArray<z.ZodObject<{
+            rank: z.ZodNumber;
+            driver_id: z.ZodString;
+            driver_name: z.ZodString;
+            total_miles: z.ZodNumber;
+        }, z.core.$strip>>;
+    };
+    readonly stateHeatmap: {
+        readonly path: "/telemetry/driver/:driver_id/heatmap";
+        readonly method: "GET";
+        readonly requestSchema: z.ZodObject<{
+            driver_id: z.ZodString;
+            start_date: z.ZodString;
+            end_date: z.ZodString;
+        }, z.core.$strip>;
+        readonly responseSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
+            count: z.ZodNumber;
+            percentage: z.ZodNumber;
+        }, z.core.$strip>>;
+    };
 };
 type EndpointName = keyof typeof endpoints;
 

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { NewLoginRequest, NewLoginResponse, ValidatePasswordRequest, ValidatePasswordResponse } from '@findatruck/shared-schemas';
-export { NewLoginRequest, NewLoginRequestSchema, NewLoginResponse, NewLoginResponseFailure, NewLoginResponseFailureSchema, NewLoginResponseSchema, NewLoginResponseSuccess, NewLoginResponseSuccessSchema, ValidatePasswordRequest, ValidatePasswordRequestSchema, ValidatePasswordResponse, ValidatePasswordResponseSchema } from '@findatruck/shared-schemas';
+import { NewLoginRequest, NewLoginResponse, ValidatePasswordRequest, ValidatePasswordResponse, DriverRankingsRequest, DriverRankingsResponse, StateHeatmapRequest, StateHeatmapResponse } from '@findatruck/shared-schemas';
+export { DriverRanking, DriverRankingSchema, DriverRankingsRequest, DriverRankingsRequestSchema, DriverRankingsResponse, DriverRankingsResponseSchema, NewLoginRequest, NewLoginRequestSchema, NewLoginResponse, NewLoginResponseFailure, NewLoginResponseFailureSchema, NewLoginResponseSchema, NewLoginResponseSuccess, NewLoginResponseSuccessSchema, StateHeatmapEntry, StateHeatmapEntrySchema, StateHeatmapRequest, StateHeatmapRequestSchema, StateHeatmapResponse, StateHeatmapResponseSchema, ValidatePasswordRequest, ValidatePasswordRequestSchema, ValidatePasswordResponse, ValidatePasswordResponseSchema } from '@findatruck/shared-schemas';
 import { z } from 'zod';
 
 /**
@@ -55,7 +55,18 @@ declare class AggregatorClient {
      * Returns whether the password is valid and the associated driver IDs.
      */
     validatePassword(request: ValidatePasswordRequest): Promise<ValidatePasswordResponse>;
+    /**
+     * Gets all drivers ranked by miles driven within a time range.
+     * Optionally filter by state.
+     */
+    driverRankings(request: DriverRankingsRequest): Promise<DriverRankingsResponse>;
+    /**
+     * Gets a heatmap of telemetry locations by state for a specific driver.
+     * Returns the count and percentage of telemetry points in each state.
+     */
+    stateHeatmap(request: StateHeatmapRequest): Promise<StateHeatmapResponse>;
     private makeRequest;
+    private makeGetRequest;
 }
 
 /**
@@ -116,6 +127,34 @@ declare const endpoints: {
             driverIds: z.ZodArray<z.ZodString>;
         }, z.core.$strip>;
     };
+    readonly driverRankings: {
+        readonly path: "/telemetry/driver-rankings";
+        readonly method: "GET";
+        readonly requestSchema: z.ZodObject<{
+            start_date: z.ZodString;
+            end_date: z.ZodString;
+            state: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        readonly responseSchema: z.ZodArray<z.ZodObject<{
+            rank: z.ZodNumber;
+            driver_id: z.ZodString;
+            driver_name: z.ZodString;
+            total_miles: z.ZodNumber;
+        }, z.core.$strip>>;
+    };
+    readonly stateHeatmap: {
+        readonly path: "/telemetry/driver/:driver_id/heatmap";
+        readonly method: "GET";
+        readonly requestSchema: z.ZodObject<{
+            driver_id: z.ZodString;
+            start_date: z.ZodString;
+            end_date: z.ZodString;
+        }, z.core.$strip>;
+        readonly responseSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
+            count: z.ZodNumber;
+            percentage: z.ZodNumber;
+        }, z.core.$strip>>;
+    };
 };
 type EndpointName = keyof typeof endpoints;
 

package/dist/index.js

@@ -3,7 +3,11 @@ import {
   NewLoginRequestSchema,
   NewLoginResponseSchema,
   ValidatePasswordRequestSchema,
-  ValidatePasswordResponseSchema
+  ValidatePasswordResponseSchema,
+  DriverRankingsRequestSchema,
+  DriverRankingsResponseSchema,
+  StateHeatmapRequestSchema,
+  StateHeatmapResponseSchema
 } from "@findatruck/shared-schemas";
 var endpoints = {
   newLogin: {
@@ -17,6 +21,18 @@ var endpoints = {
     method: "POST",
     requestSchema: ValidatePasswordRequestSchema,
     responseSchema: ValidatePasswordResponseSchema
+  },
+  driverRankings: {
+    path: "/telemetry/driver-rankings",
+    method: "GET",
+    requestSchema: DriverRankingsRequestSchema,
+    responseSchema: DriverRankingsResponseSchema
+  },
+  stateHeatmap: {
+    path: "/telemetry/driver/:driver_id/heatmap",
+    method: "GET",
+    requestSchema: StateHeatmapRequestSchema,
+    responseSchema: StateHeatmapResponseSchema
   }
 };
 
@@ -87,6 +103,61 @@ var AggregatorClient = class {
     }
     return responseParseResult.data;
   }
+  /**
+   * Gets all drivers ranked by miles driven within a time range.
+   * Optionally filter by state.
+   */
+  async driverRankings(request) {
+    const endpoint = endpoints.driverRankings;
+    const parseResult = endpoint.requestSchema.safeParse(request);
+    if (!parseResult.success) {
+      throw new AggregatorClientError(
+        `Invalid request: ${parseResult.error.message}`,
+        endpoint.path
+      );
+    }
+    const response = await this.makeGetRequest(endpoint.path, request);
+    const responseParseResult = endpoint.responseSchema.safeParse(response);
+    if (!responseParseResult.success) {
+      throw new AggregatorClientError(
+        `Invalid response from aggregator: ${responseParseResult.error.message}`,
+        endpoint.path,
+        void 0,
+        response
+      );
+    }
+    return responseParseResult.data;
+  }
+  /**
+   * Gets a heatmap of telemetry locations by state for a specific driver.
+   * Returns the count and percentage of telemetry points in each state.
+   */
+  async stateHeatmap(request) {
+    const endpoint = endpoints.stateHeatmap;
+    const parseResult = endpoint.requestSchema.safeParse(request);
+    if (!parseResult.success) {
+      throw new AggregatorClientError(
+        `Invalid request: ${parseResult.error.message}`,
+        endpoint.path
+      );
+    }
+    const path = endpoint.path.replace(":driver_id", request.driver_id);
+    const queryParams = {
+      start_date: request.start_date,
+      end_date: request.end_date
+    };
+    const response = await this.makeGetRequest(path, queryParams);
+    const responseParseResult = endpoint.responseSchema.safeParse(response);
+    if (!responseParseResult.success) {
+      throw new AggregatorClientError(
+        `Invalid response from aggregator: ${responseParseResult.error.message}`,
+        endpoint.path,
+        void 0,
+        response
+      );
+    }
+    return responseParseResult.data;
+  }
   async makeRequest(path, method, body) {
     const url = `${this.baseUrl}${path}`;
     const response = await fetch(url, {
@@ -113,6 +184,36 @@ var AggregatorClient = class {
     }
     return response.json();
   }
+  async makeGetRequest(path, params) {
+    const searchParams = new URLSearchParams();
+    for (const [key, value] of Object.entries(params)) {
+      if (value !== void 0) {
+        searchParams.append(key, value);
+      }
+    }
+    const url = `${this.baseUrl}${path}?${searchParams.toString()}`;
+    const response = await fetch(url, {
+      method: "GET",
+      headers: {
+        "Authorization": `Bearer ${this.workerSecret}`
+      }
+    });
+    if (!response.ok) {
+      let responseBody;
+      try {
+        responseBody = await response.json();
+      } catch {
+        responseBody = await response.text();
+      }
+      throw new AggregatorClientError(
+        `Request to ${path} failed with status ${response.status}`,
+        path,
+        response.status,
+        responseBody
+      );
+    }
+    return response.json();
+  }
 };
 
 // src/index.ts
@@ -122,15 +223,27 @@ import {
   NewLoginResponseSuccessSchema,
   NewLoginResponseFailureSchema,
   ValidatePasswordRequestSchema as ValidatePasswordRequestSchema2,
-  ValidatePasswordResponseSchema as ValidatePasswordResponseSchema2
+  ValidatePasswordResponseSchema as ValidatePasswordResponseSchema2,
+  DriverRankingsRequestSchema as DriverRankingsRequestSchema2,
+  DriverRankingsResponseSchema as DriverRankingsResponseSchema2,
+  DriverRankingSchema,
+  StateHeatmapRequestSchema as StateHeatmapRequestSchema2,
+  StateHeatmapResponseSchema as StateHeatmapResponseSchema2,
+  StateHeatmapEntrySchema
 } from "@findatruck/shared-schemas";
 export {
   AggregatorClient,
   AggregatorClientError,
+  DriverRankingSchema,
+  DriverRankingsRequestSchema2 as DriverRankingsRequestSchema,
+  DriverRankingsResponseSchema2 as DriverRankingsResponseSchema,
   NewLoginRequestSchema2 as NewLoginRequestSchema,
   NewLoginResponseFailureSchema,
   NewLoginResponseSchema2 as NewLoginResponseSchema,
   NewLoginResponseSuccessSchema,
+  StateHeatmapEntrySchema,
+  StateHeatmapRequestSchema2 as StateHeatmapRequestSchema,
+  StateHeatmapResponseSchema2 as StateHeatmapResponseSchema,
   ValidatePasswordRequestSchema2 as ValidatePasswordRequestSchema,
   ValidatePasswordResponseSchema2 as ValidatePasswordResponseSchema,
   endpoints

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@findatruck/aggregator-client",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -23,7 +23,7 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@findatruck/shared-schemas": "^2.9.0"
+    "@findatruck/shared-schemas": "^2.10.0"
   },
   "peerDependencies": {
     "zod": "^4.1.11"