@chrt-inc/typescript-sdk 0.231.0 → 0.271.0

package/dist/esm/api/types/Geometry.mjs

@@ -0,0 +1,4 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export {};

package/dist/esm/api/types/LocationFeature.d.mts

@@ -4,11 +4,15 @@
 import * as Chrt from "../index.mjs";
 /**
  * GeoJSON Feature with typed properties for locations
+ *
+ * The geometry field is strongly typed as Geometry (union of all geometry types)
+ * but remains optional to match the base Feature class specification.
+ * To ensure geometry is always present, validate it at runtime or make it required.
  */
 export interface LocationFeature {
     bbox?: unknown[];
     type: "Feature";
-    geometry?: Chrt.LocationFeatureOutputGeometry | null;
+    geometry: Chrt.Geometry;
     properties?: Chrt.LocationProperties | null;
     id?: LocationFeature.Id | null;
 }

package/dist/esm/api/types/LocationProperties.d.mts

@@ -8,4 +8,6 @@ export interface LocationProperties {
     address?: string | null;
     name?: string | null;
     mapbox_id?: string | null;
+    /** Accepts any additional properties */
+    [key: string]: any;
 }

package/dist/esm/api/types/OutlierLabellerEnum.d.mts

@@ -0,0 +1,8 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export type OutlierLabellerEnum = "movingpandas" | "user";
+export declare const OutlierLabellerEnum: {
+    readonly Movingpandas: "movingpandas";
+    readonly User: "user";
+};

package/dist/esm/api/types/OutlierLabellerEnum.mjs

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export const OutlierLabellerEnum = {
+    Movingpandas: "movingpandas",
+    User: "user",
+};

package/dist/esm/api/types/Session1.d.mts

@@ -0,0 +1,17 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export interface Session1 {
+    schema_version: number;
+    device_id: string;
+    device_mac_address: string;
+    /** Must be a string starting with `org_` */
+    org_id: string;
+    comments?: string | null;
+    recording?: boolean;
+    terminated?: boolean;
+    session_created_at_timestamp: string;
+    recording_initiated_at_timestamp?: string | null;
+    public?: boolean;
+    _id: string;
+}

package/dist/esm/api/types/Session1.mjs

@@ -0,0 +1,4 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export {};

package/dist/esm/api/types/SessionByDeviceDeleteResponse1.d.mts

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export interface SessionByDeviceDeleteResponse1 {
+    session_deleted: boolean;
+    tracking_session_by_device_data_points_deleted: number;
+}

package/dist/esm/api/types/SessionByDeviceDeleteResponse1.mjs

@@ -0,0 +1,4 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export {};

package/dist/esm/api/types/SessionByDeviceMarkOutliersResponse1.d.mts

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export interface SessionByDeviceMarkOutliersResponse1 {
+    successful_updates: number;
+    failed_updates: number;
+}

package/dist/esm/api/types/SessionByDeviceMarkOutliersResponse1.mjs

@@ -0,0 +1,4 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export {};

package/dist/esm/api/types/TrackingCargoByDeviceDataPoint1.d.mts

@@ -0,0 +1,12 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Chrt from "../index.mjs";
+export interface TrackingCargoByDeviceDataPoint1 {
+    schema_version: number;
+    timestamp: string;
+    metadata: Chrt.TrackingCargoByDeviceDataPointMetadata1;
+    location: Chrt.LocationFeature;
+    temperature?: number | null;
+    _id: string;
+}

package/dist/esm/api/types/TrackingCargoByDeviceDataPoint1.mjs

@@ -0,0 +1,4 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export {};

package/dist/esm/api/types/TrackingCargoByDeviceDataPointMetadata1.d.mts

@@ -0,0 +1,11 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Chrt from "../index.mjs";
+export interface TrackingCargoByDeviceDataPointMetadata1 {
+    device_id: string;
+    cargo_id: string;
+    task_group_id: string;
+    outlier?: boolean | null;
+    outlier_labeller?: Chrt.OutlierLabellerEnum | null;
+}

package/dist/esm/api/types/TrackingCargoByDeviceDataPointMetadata1.mjs

@@ -0,0 +1,4 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export {};

package/dist/esm/api/types/TrackingCargoByDriverDataPointMetadata1.d.mts

@@ -1,8 +1,11 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
+import * as Chrt from "../index.mjs";
 export interface TrackingCargoByDriverDataPointMetadata1 {
     driver_id: string;
     cargo_id: string;
     task_group_id: string;
+    outlier?: boolean | null;
+    outlier_labeller?: Chrt.OutlierLabellerEnum | null;
 }

package/dist/esm/api/types/TrackingDeviceTypeEnum1.d.mts

@@ -0,0 +1,9 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export type TrackingDeviceTypeEnum1 = "D15N-tag" | "MTB06-label" | "T3-D-tag";
+export declare const TrackingDeviceTypeEnum1: {
+    readonly D15NTag: "D15N-tag";
+    readonly Mtb06Label: "MTB06-label";
+    readonly T3DTag: "T3-D-tag";
+};

package/dist/esm/api/types/TrackingDeviceTypeEnum1.mjs

@@ -0,0 +1,8 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export const TrackingDeviceTypeEnum1 = {
+    D15NTag: "D15N-tag",
+    Mtb06Label: "MTB06-label",
+    T3DTag: "T3-D-tag",
+};

package/dist/esm/api/types/TrackingSessionByDeviceDataPoint1.d.mts

@@ -0,0 +1,12 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Chrt from "../index.mjs";
+export interface TrackingSessionByDeviceDataPoint1 {
+    schema_version: number;
+    timestamp: string;
+    metadata: Chrt.TrackingSessionByDeviceDataPointMetadata1;
+    location: Chrt.LocationFeature;
+    temperature?: number | null;
+    _id: string;
+}

package/dist/esm/api/types/TrackingSessionByDeviceDataPoint1.mjs

@@ -0,0 +1,4 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export {};

package/dist/esm/api/types/TrackingSessionByDeviceDataPointMetadata1.d.mts

@@ -0,0 +1,9 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Chrt from "../index.mjs";
+export interface TrackingSessionByDeviceDataPointMetadata1 {
+    session_id: string;
+    outlier?: boolean | null;
+    outlier_labeller?: Chrt.OutlierLabellerEnum | null;
+}

package/dist/esm/api/types/TrackingSessionByDeviceDataPointMetadata1.mjs

@@ -0,0 +1,4 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export {};

package/dist/esm/api/types/TrackingTaskGroupByDriverDataPointMetadata1.d.mts

@@ -1,7 +1,10 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
+import * as Chrt from "../index.mjs";
 export interface TrackingTaskGroupByDriverDataPointMetadata1 {
     driver_id: string;
     task_group_id: string;
+    outlier?: boolean | null;
+    outlier_labeller?: Chrt.OutlierLabellerEnum | null;
 }

package/dist/esm/api/types/index.d.mts

@@ -17,8 +17,10 @@ export * from "./CreateConnectAccountLinkRes.mjs";
 export * from "./CreateOrderRes.mjs";
 export * from "./CreateShipperPayCourierPaymentReq.mjs";
 export * from "./DecodedJwtWithOrgAndUserId.mjs";
+export * from "./Device1.mjs";
 export * from "./Driver1.mjs";
 export * from "./DriverStatusEnum.mjs";
+export * from "./DriverUpdateResp.mjs";
 export * from "./Expense1.mjs";
 export * from "./GenerateInvoiceRes.mjs";
 export * from "./GeometryCollectionInputGeometriesItem.mjs";
@@ -32,9 +34,8 @@ export * from "./LineItem1.mjs";
 export * from "./LineItemClientCreate1.mjs";
 export * from "./LineItemEnum1.mjs";
 export * from "./LineString.mjs";
-export * from "./LocationFeatureInputGeometry.mjs";
+export * from "./Geometry.mjs";
 export * from "./LocationFeature.mjs";
-export * from "./LocationFeatureOutputGeometry.mjs";
 export * from "./LocationProperties.mjs";
 export * from "./Milestone1.mjs";
 export * from "./MilestoneClientCreate1.mjs";
@@ -56,6 +57,7 @@ export * from "./OrderStatusEnum1.mjs";
 export * from "./OrgMemberDetails.mjs";
 export * from "./OrgMembersAndDrivers.mjs";
 export * from "./OrgPublicData2.mjs";
+export * from "./OutlierLabellerEnum.mjs";
 export * from "./PaymentPreviewResponse.mjs";
 export * from "./PayoutStatusEnum.mjs";
 export * from "./Point.mjs";
@@ -64,6 +66,9 @@ export * from "./Position2D.mjs";
 export * from "./Position3D.mjs";
 export * from "./PriceNameEnum.mjs";
 export * from "./RouteTypeEnum1.mjs";
+export * from "./Session1.mjs";
+export * from "./SessionByDeviceDeleteResponse1.mjs";
+export * from "./SessionByDeviceMarkOutliersResponse1.mjs";
 export * from "./ShipperContactInfo1.mjs";
 export * from "./ShipperContactInfoClientCreate1.mjs";
 export * from "./ShipperNotificationEventEnum.mjs";
@@ -92,8 +97,13 @@ export * from "./TaskGroupsExpandedRes.mjs";
 export * from "./TaskWithDetails.mjs";
 export * from "./TemplateRes.mjs";
 export * from "./TimezoneResponse.mjs";
+export * from "./TrackingCargoByDeviceDataPoint1.mjs";
+export * from "./TrackingCargoByDeviceDataPointMetadata1.mjs";
 export * from "./TrackingCargoByDriverDataPoint1.mjs";
 export * from "./TrackingCargoByDriverDataPointMetadata1.mjs";
+export * from "./TrackingDeviceTypeEnum1.mjs";
+export * from "./TrackingSessionByDeviceDataPoint1.mjs";
+export * from "./TrackingSessionByDeviceDataPointMetadata1.mjs";
 export * from "./TrackingTaskGroupByDriverDataPoint1.mjs";
 export * from "./TrackingTaskGroupByDriverDataPointMetadata1.mjs";
 export * from "./TransportTypeEnum.mjs";

package/dist/esm/api/types/index.mjs

@@ -17,8 +17,10 @@ export * from "./CreateConnectAccountLinkRes.mjs";
 export * from "./CreateOrderRes.mjs";
 export * from "./CreateShipperPayCourierPaymentReq.mjs";
 export * from "./DecodedJwtWithOrgAndUserId.mjs";
+export * from "./Device1.mjs";
 export * from "./Driver1.mjs";
 export * from "./DriverStatusEnum.mjs";
+export * from "./DriverUpdateResp.mjs";
 export * from "./Expense1.mjs";
 export * from "./GenerateInvoiceRes.mjs";
 export * from "./GeometryCollectionInputGeometriesItem.mjs";
@@ -32,9 +34,8 @@ export * from "./LineItem1.mjs";
 export * from "./LineItemClientCreate1.mjs";
 export * from "./LineItemEnum1.mjs";
 export * from "./LineString.mjs";
-export * from "./LocationFeatureInputGeometry.mjs";
+export * from "./Geometry.mjs";
 export * from "./LocationFeature.mjs";
-export * from "./LocationFeatureOutputGeometry.mjs";
 export * from "./LocationProperties.mjs";
 export * from "./Milestone1.mjs";
 export * from "./MilestoneClientCreate1.mjs";
@@ -56,6 +57,7 @@ export * from "./OrderStatusEnum1.mjs";
 export * from "./OrgMemberDetails.mjs";
 export * from "./OrgMembersAndDrivers.mjs";
 export * from "./OrgPublicData2.mjs";
+export * from "./OutlierLabellerEnum.mjs";
 export * from "./PaymentPreviewResponse.mjs";
 export * from "./PayoutStatusEnum.mjs";
 export * from "./Point.mjs";
@@ -64,6 +66,9 @@ export * from "./Position2D.mjs";
 export * from "./Position3D.mjs";
 export * from "./PriceNameEnum.mjs";
 export * from "./RouteTypeEnum1.mjs";
+export * from "./Session1.mjs";
+export * from "./SessionByDeviceDeleteResponse1.mjs";
+export * from "./SessionByDeviceMarkOutliersResponse1.mjs";
 export * from "./ShipperContactInfo1.mjs";
 export * from "./ShipperContactInfoClientCreate1.mjs";
 export * from "./ShipperNotificationEventEnum.mjs";
@@ -92,8 +97,13 @@ export * from "./TaskGroupsExpandedRes.mjs";
 export * from "./TaskWithDetails.mjs";
 export * from "./TemplateRes.mjs";
 export * from "./TimezoneResponse.mjs";
+export * from "./TrackingCargoByDeviceDataPoint1.mjs";
+export * from "./TrackingCargoByDeviceDataPointMetadata1.mjs";
 export * from "./TrackingCargoByDriverDataPoint1.mjs";
 export * from "./TrackingCargoByDriverDataPointMetadata1.mjs";
+export * from "./TrackingDeviceTypeEnum1.mjs";
+export * from "./TrackingSessionByDeviceDataPoint1.mjs";
+export * from "./TrackingSessionByDeviceDataPointMetadata1.mjs";
 export * from "./TrackingTaskGroupByDriverDataPoint1.mjs";
 export * from "./TrackingTaskGroupByDriverDataPointMetadata1.mjs";
 export * from "./TransportTypeEnum.mjs";

package/dist/esm/core/auth/AuthProvider.d.mts

@@ -0,0 +1,4 @@
+import { AuthRequest } from "./AuthRequest.mjs";
+export interface AuthProvider {
+    getAuthRequest(): Promise<AuthRequest>;
+}

package/dist/esm/core/auth/AuthProvider.mjs

@@ -0,0 +1 @@
+export {};

package/dist/esm/core/auth/AuthRequest.d.mts

@@ -0,0 +1,9 @@
+/**
+ * Request parameters for authentication requests.
+ */
+export interface AuthRequest {
+    /**
+     * The headers to be included in the request.
+     */
+    headers: Record<string, string>;
+}

package/dist/esm/core/auth/AuthRequest.mjs

@@ -0,0 +1 @@
+export {};

package/dist/esm/core/auth/index.d.mts

@@ -1,2 +1,4 @@
+export { AuthProvider } from "./AuthProvider.mjs";
+export { type AuthRequest } from "./AuthRequest.mjs";
 export { BasicAuth } from "./BasicAuth.mjs";
 export { BearerToken } from "./BearerToken.mjs";

package/dist/esm/core/exports.d.mts

@@ -0,0 +1 @@
+export * from "./file/exports.mjs";

package/dist/esm/core/exports.mjs

@@ -0,0 +1 @@
+export * from "./file/exports.mjs";

package/dist/esm/core/fetcher/Fetcher.d.mts

@@ -6,8 +6,8 @@ export declare namespace Fetcher {
         url: string;
         method: string;
         contentType?: string;
-        headers?: Record<string, string | Supplier<string | undefined> | undefined>;
-        queryParameters?: Record<string, string | string[] | object | object[] | null>;
+        headers?: Record<string, string | Supplier<string | null | undefined> | null | undefined>;
+        queryParameters?: Record<string, unknown>;
         body?: unknown;
         timeoutMs?: number;
         maxRetries?: number;

package/dist/esm/core/fetcher/Fetcher.mjs

@@ -8,15 +8,15 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import { toJson } from "../json.mjs";
-import { abortRawResponse, toRawResponse, unknownRawResponse } from "./RawResponse.mjs";
-import { Supplier } from "./Supplier.mjs";
 import { createRequestUrl } from "./createRequestUrl.mjs";
 import { getErrorResponseBody } from "./getErrorResponseBody.mjs";
 import { getFetchFn } from "./getFetchFn.mjs";
 import { getRequestBody } from "./getRequestBody.mjs";
 import { getResponseBody } from "./getResponseBody.mjs";
 import { makeRequest } from "./makeRequest.mjs";
+import { abortRawResponse, toRawResponse, unknownRawResponse } from "./RawResponse.mjs";
 import { requestWithRetries } from "./requestWithRetries.mjs";
+import { Supplier } from "./Supplier.mjs";
 function getHeaders(args) {
     return __awaiter(this, void 0, void 0, function* () {
         const newHeaders = {};

package/dist/esm/core/fetcher/index.d.mts

@@ -1,9 +1,9 @@
 export type { APIResponse } from "./APIResponse.mjs";
-export { fetcher } from "./Fetcher.mjs";
+export type { BinaryResponse } from "./BinaryResponse.mjs";
 export type { Fetcher, FetchFunction } from "./Fetcher.mjs";
+export { fetcher } from "./Fetcher.mjs";
 export { getHeader } from "./getHeader.mjs";
-export { Supplier } from "./Supplier.mjs";
-export { abortRawResponse, toRawResponse, unknownRawResponse } from "./RawResponse.mjs";
-export type { RawResponse, WithRawResponse } from "./RawResponse.mjs";
 export { HttpResponsePromise } from "./HttpResponsePromise.mjs";
-export { BinaryResponse } from "./BinaryResponse.mjs";
+export type { RawResponse, WithRawResponse } from "./RawResponse.mjs";
+export { abortRawResponse, toRawResponse, unknownRawResponse } from "./RawResponse.mjs";
+export { Supplier } from "./Supplier.mjs";

package/dist/esm/core/fetcher/index.mjs

@@ -1,5 +1,5 @@
 export { fetcher } from "./Fetcher.mjs";
 export { getHeader } from "./getHeader.mjs";
-export { Supplier } from "./Supplier.mjs";
-export { abortRawResponse, toRawResponse, unknownRawResponse } from "./RawResponse.mjs";
 export { HttpResponsePromise } from "./HttpResponsePromise.mjs";
+export { abortRawResponse, toRawResponse, unknownRawResponse } from "./RawResponse.mjs";
+export { Supplier } from "./Supplier.mjs";

package/dist/esm/core/fetcher/requestWithRetries.mjs

@@ -11,21 +11,57 @@ const INITIAL_RETRY_DELAY = 1000; // in milliseconds
 const MAX_RETRY_DELAY = 60000; // in milliseconds
 const DEFAULT_MAX_RETRIES = 2;
 const JITTER_FACTOR = 0.2; // 20% random jitter
-function addJitter(delay) {
-    // Generate a random value between -JITTER_FACTOR and +JITTER_FACTOR
-    const jitterMultiplier = 1 + (Math.random() * 2 - 1) * JITTER_FACTOR;
+function addPositiveJitter(delay) {
+    // Generate a random value between 0 and +JITTER_FACTOR
+    const jitterMultiplier = 1 + Math.random() * JITTER_FACTOR;
     return delay * jitterMultiplier;
 }
+function addSymmetricJitter(delay) {
+    // Generate a random value in a JITTER_FACTOR-sized percentage range around delay
+    const jitterMultiplier = 1 + (Math.random() - 0.5) * JITTER_FACTOR;
+    return delay * jitterMultiplier;
+}
+function getRetryDelayFromHeaders(response, retryAttempt) {
+    // Check for Retry-After header first (RFC 7231), with no jitter
+    const retryAfter = response.headers.get("Retry-After");
+    if (retryAfter) {
+        // Parse as number of seconds...
+        const retryAfterSeconds = parseInt(retryAfter, 10);
+        if (!isNaN(retryAfterSeconds) && retryAfterSeconds > 0) {
+            return Math.min(retryAfterSeconds * 1000, MAX_RETRY_DELAY);
+        }
+        // ...or as an HTTP date; both are valid
+        const retryAfterDate = new Date(retryAfter);
+        if (!isNaN(retryAfterDate.getTime())) {
+            const delay = retryAfterDate.getTime() - Date.now();
+            if (delay > 0) {
+                return Math.min(Math.max(delay, 0), MAX_RETRY_DELAY);
+            }
+        }
+    }
+    // Then check for industry-standard X-RateLimit-Reset header, with positive jitter
+    const rateLimitReset = response.headers.get("X-RateLimit-Reset");
+    if (rateLimitReset) {
+        const resetTime = parseInt(rateLimitReset, 10);
+        if (!isNaN(resetTime)) {
+            // Assume Unix timestamp in epoch seconds
+            const delay = resetTime * 1000 - Date.now();
+            if (delay > 0) {
+                return addPositiveJitter(Math.min(delay, MAX_RETRY_DELAY));
+            }
+        }
+    }
+    // Fall back to exponential backoff, with symmetric jitter
+    return addSymmetricJitter(Math.min(INITIAL_RETRY_DELAY * Math.pow(2, retryAttempt), MAX_RETRY_DELAY));
+}
 export function requestWithRetries(requestFn_1) {
     return __awaiter(this, arguments, void 0, function* (requestFn, maxRetries = DEFAULT_MAX_RETRIES) {
         let response = yield requestFn();
         for (let i = 0; i < maxRetries; ++i) {
             if ([408, 429].includes(response.status) || response.status >= 500) {
-                // Calculate base delay using exponential backoff (in milliseconds)
-                const baseDelay = Math.min(INITIAL_RETRY_DELAY * Math.pow(2, i), MAX_RETRY_DELAY);
-                // Add jitter to the delay
-                const delayWithJitter = addJitter(baseDelay);
-                yield new Promise((resolve) => setTimeout(resolve, delayWithJitter));
+                // Get delay with appropriate jitter applied
+                const delay = getRetryDelayFromHeaders(response, i);
+                yield new Promise((resolve) => setTimeout(resolve, delay));
                 response = yield requestFn();
             }
             else {

package/dist/esm/core/file/exports.d.mts

@@ -0,0 +1 @@
+export { Uploadable } from "./types.mjs";

package/dist/esm/core/file/exports.mjs

@@ -0,0 +1 @@
+export {};

package/dist/esm/core/file/file.d.mts

@@ -0,0 +1,5 @@
+import { Uploadable } from "./types.mjs";
+export declare function toBinaryUploadRequest(file: Uploadable): Promise<{
+    body: Uploadable.FileLike;
+    headers?: Record<string, string>;
+}>;