@chrt-inc/typescript-sdk 1.794.0 → 1.810.0

package/dist/cjs/api/resources/operations/resources/operationsTasks/client/Client.js

@@ -431,7 +431,77 @@ class OperationsTasks {
         });
     }
     /**
-     * Sets an OperationsTask's status (not_started / in_progress / completed / skipped). Setting COMPLETED stamps completed_at/by; any other status clears them. | authz: min_org_role=operator | (OperationsTaskStatusReq) -> (bool)
+     * Sets deadline_timestamp on multiple OperationsTasks in one call, each scoped to the caller's organization. Task ids that don't exist or belong to another org are silently skipped; the response reports how many were updated. | authz: min_org_role=operator | (OperationsTasksBulkUpdateDeadlinesReq1) -> (OperationsTasksBulkUpdateDeadlinesRes1)
+     *
+     * @param {Chrt.operations.OperationsTasksBulkUpdateDeadlinesReq1} request
+     * @param {OperationsTasks.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Chrt.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.operations.operationsTasks.bulkUpdateDeadlinesV1({
+     *         operations_task_deadline_updates: [{
+     *                 task_id: "task_id",
+     *                 deadline_timestamp: "2024-01-15T09:30:00Z"
+     *             }]
+     *     })
+     */
+    bulkUpdateDeadlinesV1(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__bulkUpdateDeadlinesV1(request, requestOptions));
+    }
+    __bulkUpdateDeadlinesV1(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d;
+            let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ Authorization: yield this._getAuthorizationHeader() }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
+                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.ChrtEnvironment.Local, "operations/operations_tasks/bulk_update_deadlines/v1"),
+                method: "PATCH",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: request,
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+                maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+            });
+            if (_response.ok) {
+                return {
+                    data: _response.body,
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 422:
+                        throw new Chrt.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.ChrtError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.ChrtError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.ChrtTimeoutError("Timeout exceeded when calling PATCH /operations/operations_tasks/bulk_update_deadlines/v1.");
+                case "unknown":
+                    throw new errors.ChrtError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    /**
+     * Sets an OperationsTask's status (not_started / in_progress / completed / skipped / cancelled). Setting COMPLETED stamps completed_at/by; any other status clears them. | authz: min_org_role=operator | (OperationsTaskStatusReq) -> (bool)
      *
      * @param {string} taskId
      * @param {Chrt.operations.OperationsTaskStatusReq} request

package/dist/cjs/api/resources/operations/resources/operationsTasks/client/requests/OperationsTasksBulkUpdateDeadlinesReq1.d.ts

@@ -0,0 +1,16 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Chrt from "../../../../../../index.js";
+/**
+ * @example
+ *     {
+ *         operations_task_deadline_updates: [{
+ *                 task_id: "task_id",
+ *                 deadline_timestamp: "2024-01-15T09:30:00Z"
+ *             }]
+ *     }
+ */
+export interface OperationsTasksBulkUpdateDeadlinesReq1 {
+    operations_task_deadline_updates: Chrt.OperationsTaskDeadlineUpdate1[];
+}

package/dist/cjs/api/resources/operations/resources/operationsTasks/client/requests/index.d.ts

@@ -1,5 +1,6 @@
 export { type OperationsTasksListV1Request } from "./OperationsTasksListV1Request.js";
 export { type OperationsTaskClientUpdate1 } from "./OperationsTaskClientUpdate1.js";
 export { type OperationsTaskClientCreate1 } from "./OperationsTaskClientCreate1.js";
+export { type OperationsTasksBulkUpdateDeadlinesReq1 } from "./OperationsTasksBulkUpdateDeadlinesReq1.js";
 export { type OperationsTaskStatusReq } from "./OperationsTaskStatusReq.js";
 export { type OperationsTaskAddCommentReq1 } from "./OperationsTaskAddCommentReq1.js";

package/dist/cjs/api/resources/shipping/resources/orderDrafts/client/requests/OrdersNewDraftReq.d.ts

@@ -17,6 +17,8 @@ export interface OrdersNewDraftReq {
     department_id?: string | null;
     /** OperationsTaskList ids to apply to the coordinator's Case at draft creation; foreign/stale ids are skipped without failing the draft. */
     task_list_ids?: string[];
+    /** If set, pins the first applied OperationsTask's deadline; later from_previous_task entries cascade from it. None anchors the chain to the apply time (now). */
+    initial_deadline_timestamp?: string | null;
     /** Optional key, unique per caller org, that makes draft creation idempotent: re-sending the same key returns the already-created draft instead of creating a duplicate. */
     creation_idempotency_key?: string | null;
     /** Seed content for the OrderThread's first user turn (text + long-lived references). Agentic builds supply it; click-ops leaves it None for a blank seed turn. */

package/dist/cjs/api/resources/tracking/resources/driver/client/Client.d.ts

@@ -30,28 +30,6 @@ export declare namespace Driver {
 export declare class Driver {
     protected readonly _options: Driver.Options;
     constructor(_options?: Driver.Options);
-    /**
-     * Records driver location updates. Updates driver's last seen timestamp and location. Automatically records tracking data for all IN_PROGRESS task groups and their associated IN_TRANSIT cargos (cargo_by_driver). | auth: api_key | (LocationFeature) -> (DriverUpdateRes)
-     *
-     * @param {Chrt.LocationFeature} request
-     * @param {Driver.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @throws {@link Chrt.UnprocessableEntityError}
-     *
-     * @example
-     *     await client.tracking.driver.updateV1({
-     *         type: "Feature",
-     *         geometry: {
-     *             type: "GeometryCollection",
-     *             geometries: [{
-     *                     type: "LineString",
-     *                     coordinates: [[]]
-     *                 }]
-     *         }
-     *     })
-     */
-    updateV1(request: Chrt.LocationFeature, requestOptions?: Driver.RequestOptions): core.HttpResponsePromise<Chrt.DriverUpdateRes>;
-    private __updateV1;
     /**
      * Records driver location updates with a client-supplied capture timestamp. Writes a driver_by_driver ping on every call, updates the driver's last seen, and records tracking data for all IN_PROGRESS task groups and their associated IN_TRANSIT cargos. | auth: api_key | (DriverByDriverDataPointClientCreate1) -> (DriverUpdateRes)
      *

package/dist/cjs/api/resources/tracking/resources/driver/client/Client.js

@@ -55,77 +55,6 @@ class Driver {
     constructor(_options = {}) {
         this._options = _options;
     }
-    /**
-     * Records driver location updates. Updates driver's last seen timestamp and location. Automatically records tracking data for all IN_PROGRESS task groups and their associated IN_TRANSIT cargos (cargo_by_driver). | auth: api_key | (LocationFeature) -> (DriverUpdateRes)
-     *
-     * @param {Chrt.LocationFeature} request
-     * @param {Driver.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @throws {@link Chrt.UnprocessableEntityError}
-     *
-     * @example
-     *     await client.tracking.driver.updateV1({
-     *         type: "Feature",
-     *         geometry: {
-     *             type: "GeometryCollection",
-     *             geometries: [{
-     *                     type: "LineString",
-     *                     coordinates: [[]]
-     *                 }]
-     *         }
-     *     })
-     */
-    updateV1(request, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__updateV1(request, requestOptions));
-    }
-    __updateV1(request, requestOptions) {
-        return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c, _d;
-            let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ Authorization: yield this._getAuthorizationHeader() }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
-            const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
-                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.ChrtEnvironment.Local, "tracking/driver/update/v1"),
-                method: "POST",
-                headers: _headers,
-                contentType: "application/json",
-                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
-                requestType: "json",
-                body: request,
-                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
-                maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
-                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
-            });
-            if (_response.ok) {
-                return { data: _response.body, rawResponse: _response.rawResponse };
-            }
-            if (_response.error.reason === "status-code") {
-                switch (_response.error.statusCode) {
-                    case 422:
-                        throw new Chrt.UnprocessableEntityError(_response.error.body, _response.rawResponse);
-                    default:
-                        throw new errors.ChrtError({
-                            statusCode: _response.error.statusCode,
-                            body: _response.error.body,
-                            rawResponse: _response.rawResponse,
-                        });
-                }
-            }
-            switch (_response.error.reason) {
-                case "non-json":
-                    throw new errors.ChrtError({
-                        statusCode: _response.error.statusCode,
-                        body: _response.error.rawBody,
-                        rawResponse: _response.rawResponse,
-                    });
-                case "timeout":
-                    throw new errors.ChrtTimeoutError("Timeout exceeded when calling POST /tracking/driver/update/v1.");
-                case "unknown":
-                    throw new errors.ChrtError({
-                        message: _response.error.errorMessage,
-                        rawResponse: _response.rawResponse,
-                    });
-            }
-        });
-    }
     /**
      * Records driver location updates with a client-supplied capture timestamp. Writes a driver_by_driver ping on every call, updates the driver's last seen, and records tracking data for all IN_PROGRESS task groups and their associated IN_TRANSIT cargos. | auth: api_key | (DriverByDriverDataPointClientCreate1) -> (DriverUpdateRes)
      *

package/dist/cjs/api/resources/tracking/resources/sessions/client/Client.d.ts

@@ -51,7 +51,6 @@ export declare class Sessions {
      *         filter_device_id: "filter_device_id",
      *         filter_off_chrt_reference_id: "filter_off_chrt_reference_id",
      *         filter_flight_number: "filter_flight_number",
-     *         filter_fa_flight_id: "filter_fa_flight_id",
      *         filter_flight_loaded_status: "filter_flight_loaded_status",
      *         filter_has_last_seen: true,
      *         filter_created_at_timestamp_gte: "2024-01-15T09:30:00Z",
@@ -99,7 +98,7 @@ export declare class Sessions {
     typeaheadV1(request: Chrt.tracking.SessionsTypeaheadV1Request, requestOptions?: Sessions.RequestOptions): core.HttpResponsePromise<Chrt.TrackingTypeaheadResult[]>;
     private __typeaheadV1;
     /**
-     * Creates a new tracking session for a device and automatically starts recording data points. The caller must be the device owner or belong to an org the device is shared with. The device owner remains the session owner (org_id). The device's shared_with_org_ids are copied to the session. The device must not have an active session. Optionally seed a destination geofence (location + radius) to fire a destination geofence entered notification. Auto-termination is scheduled for ~1 week out at 8 PM PT. Prevent auto termination with `no_auto_termination=True` | auth: api_key | (SessionClientCreate1) -> (PydanticObjectId)
+     * Creates a new tracking session for a device and automatically starts recording data points. The caller must be the device owner or belong to an org the device is shared with. The device owner remains the session owner (org_id). The device's shared_with_org_ids are copied to the session. The device must not have an active session. Optionally seed a destination geofence (location + radius) to fire a destination geofence entered notification; attach flights afterwards via set_flight_info. Auto-termination is scheduled for ~1 week out at 8 PM PT. Prevent auto termination with `no_auto_termination=True` | auth: api_key | (SessionClientCreate1) -> (PydanticObjectId)
      *
      * @param {Chrt.tracking.SessionClientCreate1} request
      * @param {Sessions.RequestOptions} requestOptions - Request-specific configuration.
@@ -146,7 +145,7 @@ export declare class Sessions {
     updateSharedOrgsV1(request: Chrt.tracking.SessionsUpdateSharedOrgsReq1, requestOptions?: Sessions.RequestOptions): core.HttpResponsePromise<boolean>;
     private __updateSharedOrgsV1;
     /**
-     * Terminates a session. Moves device.active_session_id to device.past_session_ids. | auth: api_key | () -> (bool)
+     * Terminates a session. Moves device.active_session_id to device.past_session_ids and deactivates the device. | auth: api_key | () -> (bool)
      *
      * @param {Chrt.tracking.SessionsTerminateV1Request} request
      * @param {Sessions.RequestOptions} requestOptions - Request-specific configuration.
@@ -161,53 +160,59 @@ export declare class Sessions {
     terminateV1(request: Chrt.tracking.SessionsTerminateV1Request, requestOptions?: Sessions.RequestOptions): core.HttpResponsePromise<boolean>;
     private __terminateV1;
     /**
-     * Adds a flight number and FA flight IDs to an existing session. Creates or reuses a FlightAware alert. | auth: api_key | authz: min_org_role=operator | (SessionAddFlightReq1) -> (bool)
+     * Returns the session's flight legs in order, with Cirium-sourced status lazily resolved and refreshed on read. Access restricted to the caller's organization or shared organizations. | auth: api_key | authz: min_org_role=operator | () -> (list[FlightLeg1])
      *
-     * @param {Chrt.tracking.SessionAddFlightReq1} request
+     * @param {Chrt.tracking.SessionsFlightLegsV1Request} request
      * @param {Sessions.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Chrt.UnprocessableEntityError}
      *
      * @example
-     *     await client.tracking.sessions.addFlightV1({
-     *         session_id: "session_id",
-     *         flight_number: "flight_number",
-     *         fa_flight_ids: ["fa_flight_ids"]
+     *     await client.tracking.sessions.flightLegsV1({
+     *         session_id: "session_id"
      *     })
      */
-    addFlightV1(request: Chrt.tracking.SessionAddFlightReq1, requestOptions?: Sessions.RequestOptions): core.HttpResponsePromise<boolean>;
-    private __addFlightV1;
+    flightLegsV1(request: Chrt.tracking.SessionsFlightLegsV1Request, requestOptions?: Sessions.RequestOptions): core.HttpResponsePromise<Chrt.FlightLeg1[]>;
+    private __flightLegsV1;
     /**
-     * Removes a flight number and FA flight IDs from a session. Runs the shared-aware FlightAware unsubscribe cycle before removing. | auth: api_key | authz: min_org_role=operator | (SessionRemoveFlightReq1) -> (bool)
+     * Returns the Cirium-sourced positional track for one of the session's flight legs — the live breadcrumb trail plus the planned path (waypoints + legacy route) — cached on read. Access restricted to the caller's organization or shared organizations. | auth: api_key | authz: min_org_role=operator | () -> (FlightTrackRes)
      *
-     * @param {Chrt.tracking.SessionRemoveFlightReq1} request
+     * @param {Chrt.tracking.SessionsFlightTrackV1Request} request
      * @param {Sessions.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Chrt.UnprocessableEntityError}
      *
      * @example
-     *     await client.tracking.sessions.removeFlightV1({
+     *     await client.tracking.sessions.flightTrackV1({
      *         session_id: "session_id",
-     *         flight_number: "flight_number",
-     *         fa_flight_ids: ["fa_flight_ids"]
+     *         flight_leg_id: "flight_leg_id"
      *     })
      */
-    removeFlightV1(request: Chrt.tracking.SessionRemoveFlightReq1, requestOptions?: Sessions.RequestOptions): core.HttpResponsePromise<boolean>;
-    private __removeFlightV1;
+    flightTrackV1(request: Chrt.tracking.SessionsFlightTrackV1Request, requestOptions?: Sessions.RequestOptions): core.HttpResponsePromise<Chrt.FlightTrackRes>;
+    private __flightTrackV1;
     /**
-     * Fetches current OOOI timestamps from FlightAware for each fa_flight_id on the session and updates flight_status_by_fa_flight_id. Use when the webhook may have left state out of sync. | auth: api_key | authz: min_org_role=operator | () -> (bool)
+     * Replaces the session's followed flights: deletes the existing session-owned FlightLeg documents and creates new ones from the supplied flight details. Each leg's Cirium flightId and status resolve lazily on read. Pass an empty list to clear all flights. | auth: api_key | authz: min_org_role=operator | (SessionSetFlightInfoReq1) -> (bool)
      *
-     * @param {Chrt.tracking.SessionsSyncFlightStatusV1Request} request
+     * @param {Chrt.tracking.SessionSetFlightInfoReq1} request
      * @param {Sessions.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Chrt.UnprocessableEntityError}
      *
      * @example
-     *     await client.tracking.sessions.syncFlightStatusV1({
-     *         session_id: "session_id"
+     *     await client.tracking.sessions.setFlightInfoV1({
+     *         session_id: "session_id",
+     *         flight_legs: [{
+     *                 schema_version: 1,
+     *                 flight_number: "flight_number",
+     *                 provenance: "manual",
+     *                 origin_iata: "origin_iata",
+     *                 destination_iata: "destination_iata",
+     *                 scheduled_departure_utc: "2024-01-15T09:30:00Z",
+     *                 carrier_iata: "carrier_iata"
+     *             }]
      *     })
      */
-    syncFlightStatusV1(request: Chrt.tracking.SessionsSyncFlightStatusV1Request, requestOptions?: Sessions.RequestOptions): core.HttpResponsePromise<boolean>;
-    private __syncFlightStatusV1;
+    setFlightInfoV1(request: Chrt.tracking.SessionSetFlightInfoReq1, requestOptions?: Sessions.RequestOptions): core.HttpResponsePromise<boolean>;
+    private __setFlightInfoV1;
     protected _getAuthorizationHeader(): Promise<string | undefined>;
 }

package/dist/cjs/api/resources/tracking/resources/sessions/client/Client.js

@@ -87,7 +87,6 @@ class Sessions {
      *         filter_device_id: "filter_device_id",
      *         filter_off_chrt_reference_id: "filter_off_chrt_reference_id",
      *         filter_flight_number: "filter_flight_number",
-     *         filter_fa_flight_id: "filter_fa_flight_id",
      *         filter_flight_loaded_status: "filter_flight_loaded_status",
      *         filter_has_last_seen: true,
      *         filter_created_at_timestamp_gte: "2024-01-15T09:30:00Z",
@@ -106,7 +105,7 @@ class Sessions {
     __listV1() {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-            const { sort_by: sortBy, sort_order: sortOrder, page, page_size: pageSize, search, org_scope: orgScope, filter_terminated: filterTerminated, filter_public: filterPublic, filter_device_id: filterDeviceId, filter_off_chrt_reference_id: filterOffChrtReferenceId, filter_flight_number: filterFlightNumber, filter_fa_flight_id: filterFaFlightId, filter_flight_loaded_status: filterFlightLoadedStatus, filter_has_last_seen: filterHasLastSeen, filter_created_at_timestamp_gte: filterCreatedAtTimestampGte, filter_created_at_timestamp_lte: filterCreatedAtTimestampLte, filter_last_seen_at_timestamp_gte: filterLastSeenAtTimestampGte, filter_last_seen_at_timestamp_lte: filterLastSeenAtTimestampLte, filter_termination_scheduled_for_timestamp_gte: filterTerminationScheduledForTimestampGte, filter_termination_scheduled_for_timestamp_lte: filterTerminationScheduledForTimestampLte, filter_terminated_at_timestamp_gte: filterTerminatedAtTimestampGte, filter_terminated_at_timestamp_lte: filterTerminatedAtTimestampLte, } = request;
+            const { sort_by: sortBy, sort_order: sortOrder, page, page_size: pageSize, search, org_scope: orgScope, filter_terminated: filterTerminated, filter_public: filterPublic, filter_device_id: filterDeviceId, filter_off_chrt_reference_id: filterOffChrtReferenceId, filter_flight_number: filterFlightNumber, filter_flight_loaded_status: filterFlightLoadedStatus, filter_has_last_seen: filterHasLastSeen, filter_created_at_timestamp_gte: filterCreatedAtTimestampGte, filter_created_at_timestamp_lte: filterCreatedAtTimestampLte, filter_last_seen_at_timestamp_gte: filterLastSeenAtTimestampGte, filter_last_seen_at_timestamp_lte: filterLastSeenAtTimestampLte, filter_termination_scheduled_for_timestamp_gte: filterTerminationScheduledForTimestampGte, filter_termination_scheduled_for_timestamp_lte: filterTerminationScheduledForTimestampLte, filter_terminated_at_timestamp_gte: filterTerminatedAtTimestampGte, filter_terminated_at_timestamp_lte: filterTerminatedAtTimestampLte, } = request;
             const _queryParams = {};
             if (sortBy !== undefined) {
                 _queryParams["sort_by"] = sortBy;
@@ -141,9 +140,6 @@ class Sessions {
             if (filterFlightNumber !== undefined) {
                 _queryParams["filter_flight_number"] = filterFlightNumber;
             }
-            if (filterFaFlightId !== undefined) {
-                _queryParams["filter_fa_flight_id"] = filterFaFlightId;
-            }
             if (filterFlightLoadedStatus !== undefined) {
                 _queryParams["filter_flight_loaded_status"] = filterFlightLoadedStatus;
             }
@@ -353,7 +349,7 @@ class Sessions {
         });
     }
     /**
-     * Creates a new tracking session for a device and automatically starts recording data points. The caller must be the device owner or belong to an org the device is shared with. The device owner remains the session owner (org_id). The device's shared_with_org_ids are copied to the session. The device must not have an active session. Optionally seed a destination geofence (location + radius) to fire a destination geofence entered notification. Auto-termination is scheduled for ~1 week out at 8 PM PT. Prevent auto termination with `no_auto_termination=True` | auth: api_key | (SessionClientCreate1) -> (PydanticObjectId)
+     * Creates a new tracking session for a device and automatically starts recording data points. The caller must be the device owner or belong to an org the device is shared with. The device owner remains the session owner (org_id). The device's shared_with_org_ids are copied to the session. The device must not have an active session. Optionally seed a destination geofence (location + radius) to fire a destination geofence entered notification; attach flights afterwards via set_flight_info. Auto-termination is scheduled for ~1 week out at 8 PM PT. Prevent auto termination with `no_auto_termination=True` | auth: api_key | (SessionClientCreate1) -> (PydanticObjectId)
      *
      * @param {Chrt.tracking.SessionClientCreate1} request
      * @param {Sessions.RequestOptions} requestOptions - Request-specific configuration.
@@ -556,7 +552,7 @@ class Sessions {
         });
     }
     /**
-     * Terminates a session. Moves device.active_session_id to device.past_session_ids. | auth: api_key | () -> (bool)
+     * Terminates a session. Moves device.active_session_id to device.past_session_ids and deactivates the device. | auth: api_key | () -> (bool)
      *
      * @param {Chrt.tracking.SessionsTerminateV1Request} request
      * @param {Sessions.RequestOptions} requestOptions - Request-specific configuration.
@@ -620,35 +616,33 @@ class Sessions {
         });
     }
     /**
-     * Adds a flight number and FA flight IDs to an existing session. Creates or reuses a FlightAware alert. | auth: api_key | authz: min_org_role=operator | (SessionAddFlightReq1) -> (bool)
+     * Returns the session's flight legs in order, with Cirium-sourced status lazily resolved and refreshed on read. Access restricted to the caller's organization or shared organizations. | auth: api_key | authz: min_org_role=operator | () -> (list[FlightLeg1])
      *
-     * @param {Chrt.tracking.SessionAddFlightReq1} request
+     * @param {Chrt.tracking.SessionsFlightLegsV1Request} request
      * @param {Sessions.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Chrt.UnprocessableEntityError}
      *
      * @example
-     *     await client.tracking.sessions.addFlightV1({
-     *         session_id: "session_id",
-     *         flight_number: "flight_number",
-     *         fa_flight_ids: ["fa_flight_ids"]
+     *     await client.tracking.sessions.flightLegsV1({
+     *         session_id: "session_id"
      *     })
      */
-    addFlightV1(request, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__addFlightV1(request, requestOptions));
+    flightLegsV1(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__flightLegsV1(request, requestOptions));
     }
-    __addFlightV1(request, requestOptions) {
+    __flightLegsV1(request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d;
+            const { session_id: sessionId } = request;
+            const _queryParams = {};
+            _queryParams["session_id"] = sessionId;
             let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ Authorization: yield this._getAuthorizationHeader() }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
-                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.ChrtEnvironment.Local, "tracking/sessions/add_flight/v1"),
-                method: "POST",
+                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.ChrtEnvironment.Local, "tracking/sessions/flight_legs/v1"),
+                method: "GET",
                 headers: _headers,
-                contentType: "application/json",
-                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
-                requestType: "json",
-                body: request,
+                queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
                 timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
                 maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
@@ -676,7 +670,7 @@ class Sessions {
                         rawResponse: _response.rawResponse,
                     });
                 case "timeout":
-                    throw new errors.ChrtTimeoutError("Timeout exceeded when calling POST /tracking/sessions/add_flight/v1.");
+                    throw new errors.ChrtTimeoutError("Timeout exceeded when calling GET /tracking/sessions/flight_legs/v1.");
                 case "unknown":
                     throw new errors.ChrtError({
                         message: _response.error.errorMessage,
@@ -686,35 +680,35 @@ class Sessions {
         });
     }
     /**
-     * Removes a flight number and FA flight IDs from a session. Runs the shared-aware FlightAware unsubscribe cycle before removing. | auth: api_key | authz: min_org_role=operator | (SessionRemoveFlightReq1) -> (bool)
+     * Returns the Cirium-sourced positional track for one of the session's flight legs — the live breadcrumb trail plus the planned path (waypoints + legacy route) — cached on read. Access restricted to the caller's organization or shared organizations. | auth: api_key | authz: min_org_role=operator | () -> (FlightTrackRes)
      *
-     * @param {Chrt.tracking.SessionRemoveFlightReq1} request
+     * @param {Chrt.tracking.SessionsFlightTrackV1Request} request
      * @param {Sessions.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Chrt.UnprocessableEntityError}
      *
      * @example
-     *     await client.tracking.sessions.removeFlightV1({
+     *     await client.tracking.sessions.flightTrackV1({
      *         session_id: "session_id",
-     *         flight_number: "flight_number",
-     *         fa_flight_ids: ["fa_flight_ids"]
+     *         flight_leg_id: "flight_leg_id"
      *     })
      */
-    removeFlightV1(request, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__removeFlightV1(request, requestOptions));
+    flightTrackV1(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__flightTrackV1(request, requestOptions));
     }
-    __removeFlightV1(request, requestOptions) {
+    __flightTrackV1(request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d;
+            const { session_id: sessionId, flight_leg_id: flightLegId } = request;
+            const _queryParams = {};
+            _queryParams["session_id"] = sessionId;
+            _queryParams["flight_leg_id"] = flightLegId;
             let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ Authorization: yield this._getAuthorizationHeader() }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
-                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.ChrtEnvironment.Local, "tracking/sessions/remove_flight/v1"),
-                method: "POST",
+                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.ChrtEnvironment.Local, "tracking/sessions/flight_track/v1"),
+                method: "GET",
                 headers: _headers,
-                contentType: "application/json",
-                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
-                requestType: "json",
-                body: request,
+                queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
                 timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
                 maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
@@ -742,7 +736,7 @@ class Sessions {
                         rawResponse: _response.rawResponse,
                     });
                 case "timeout":
-                    throw new errors.ChrtTimeoutError("Timeout exceeded when calling POST /tracking/sessions/remove_flight/v1.");
+                    throw new errors.ChrtTimeoutError("Timeout exceeded when calling GET /tracking/sessions/flight_track/v1.");
                 case "unknown":
                     throw new errors.ChrtError({
                         message: _response.error.errorMessage,
@@ -752,33 +746,42 @@ class Sessions {
         });
     }
     /**
-     * Fetches current OOOI timestamps from FlightAware for each fa_flight_id on the session and updates flight_status_by_fa_flight_id. Use when the webhook may have left state out of sync. | auth: api_key | authz: min_org_role=operator | () -> (bool)
+     * Replaces the session's followed flights: deletes the existing session-owned FlightLeg documents and creates new ones from the supplied flight details. Each leg's Cirium flightId and status resolve lazily on read. Pass an empty list to clear all flights. | auth: api_key | authz: min_org_role=operator | (SessionSetFlightInfoReq1) -> (bool)
      *
-     * @param {Chrt.tracking.SessionsSyncFlightStatusV1Request} request
+     * @param {Chrt.tracking.SessionSetFlightInfoReq1} request
      * @param {Sessions.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Chrt.UnprocessableEntityError}
      *
      * @example
-     *     await client.tracking.sessions.syncFlightStatusV1({
-     *         session_id: "session_id"
+     *     await client.tracking.sessions.setFlightInfoV1({
+     *         session_id: "session_id",
+     *         flight_legs: [{
+     *                 schema_version: 1,
+     *                 flight_number: "flight_number",
+     *                 provenance: "manual",
+     *                 origin_iata: "origin_iata",
+     *                 destination_iata: "destination_iata",
+     *                 scheduled_departure_utc: "2024-01-15T09:30:00Z",
+     *                 carrier_iata: "carrier_iata"
+     *             }]
      *     })
      */
-    syncFlightStatusV1(request, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__syncFlightStatusV1(request, requestOptions));
+    setFlightInfoV1(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__setFlightInfoV1(request, requestOptions));
     }
-    __syncFlightStatusV1(request, requestOptions) {
+    __setFlightInfoV1(request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d;
-            const { session_id: sessionId } = request;
-            const _queryParams = {};
-            _queryParams["session_id"] = sessionId;
             let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ Authorization: yield this._getAuthorizationHeader() }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
-                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.ChrtEnvironment.Local, "tracking/sessions/sync_flight_status/v1"),
+                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.ChrtEnvironment.Local, "tracking/sessions/set_flight_info/v1"),
                 method: "POST",
                 headers: _headers,
-                queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: request,
                 timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
                 maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
@@ -806,7 +809,7 @@ class Sessions {
                         rawResponse: _response.rawResponse,
                     });
                 case "timeout":
-                    throw new errors.ChrtTimeoutError("Timeout exceeded when calling POST /tracking/sessions/sync_flight_status/v1.");
+                    throw new errors.ChrtTimeoutError("Timeout exceeded when calling POST /tracking/sessions/set_flight_info/v1.");
                 case "unknown":
                     throw new errors.ChrtError({
                         message: _response.error.errorMessage,

package/dist/cjs/api/resources/tracking/resources/sessions/client/requests/SessionClientCreate1.d.ts

@@ -20,8 +20,6 @@ export interface SessionClientCreate1 {
     public?: boolean;
     off_chrt_shipper_org_id?: string | null;
     termination_scheduled_for_timestamp?: string | null;
-    flight_numbers?: string[];
-    fa_flight_ids?: string[];
     destination_geofence_location?: Chrt.LocationFeature | null;
     destination_geofence_radius_miles?: number;
 }

package/dist/cjs/api/resources/tracking/resources/sessions/client/requests/SessionSetFlightInfoReq1.d.ts

@@ -0,0 +1,24 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Chrt from "../../../../../../index.js";
+/**
+ * @example
+ *     {
+ *         session_id: "session_id",
+ *         flight_legs: [{
+ *                 schema_version: 1,
+ *                 flight_number: "flight_number",
+ *                 provenance: "manual",
+ *                 origin_iata: "origin_iata",
+ *                 destination_iata: "destination_iata",
+ *                 scheduled_departure_utc: "2024-01-15T09:30:00Z",
+ *                 carrier_iata: "carrier_iata"
+ *             }]
+ *     }
+ */
+export interface SessionSetFlightInfoReq1 {
+    session_id: string;
+    /** Ordered list of flights to follow for the session. Replaces any existing flight legs. Pass an empty list to clear all flight legs. */
+    flight_legs: Chrt.FlightLegClientCreate1[];
+}

package/dist/cjs/api/resources/tracking/resources/sessions/client/requests/{SessionsSyncFlightStatusV1Request.d.ts → SessionsFlightLegsV1Request.d.ts}

@@ -7,6 +7,6 @@
  *         session_id: "session_id"
  *     }
  */
-export interface SessionsSyncFlightStatusV1Request {
+export interface SessionsFlightLegsV1Request {
     session_id: string;
 }

package/dist/cjs/api/resources/tracking/resources/sessions/client/requests/SessionsFlightTrackV1Request.d.ts

@@ -0,0 +1,14 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * @example
+ *     {
+ *         session_id: "session_id",
+ *         flight_leg_id: "flight_leg_id"
+ *     }
+ */
+export interface SessionsFlightTrackV1Request {
+    session_id: string;
+    flight_leg_id: string;
+}