@chrt-inc/typescript-sdk 1.751.0 → 1.754.0

package/dist/cjs/Client.js

@@ -56,8 +56,8 @@ class ChrtClient {
         this._options = Object.assign(Object.assign({}, _options), { headers: (0, headers_js_1.mergeHeaders)({
                 "X-Fern-Language": "JavaScript",
                 "X-Fern-SDK-Name": "@chrt-inc/typescript-sdk",
-                "X-Fern-SDK-Version": "1.751.0",
-                "User-Agent": "@chrt-inc/typescript-sdk/1.751.0",
+                "X-Fern-SDK-Version": "1.754.0",
+                "User-Agent": "@chrt-inc/typescript-sdk/1.754.0",
                 "X-Fern-Runtime": core.RUNTIME.type,
                 "X-Fern-Runtime-Version": core.RUNTIME.version,
             }, _options === null || _options === void 0 ? void 0 : _options.headers) });

package/dist/cjs/api/resources/shipping/resources/flights/client/Client.d.ts

@@ -56,5 +56,31 @@ export declare class Flights {
      */
     getFlightLegsForTaskGroupV1(taskGroupId: string, requestOptions?: Flights.RequestOptions): core.HttpResponsePromise<Chrt.FlightInfoForTaskRes>;
     private __getFlightLegsForTaskGroupV1;
+    /**
+     * Returns the flight leg with its Cirium-sourced status, lazily resolving the Cirium flightId and refreshing the cached status on read. | authz_personas=[driver_for_executor, coordinator_org_operators, executor_org_operators, shipper_org_operators] | () -> (FlightLeg1)
+     *
+     * @param {string} flightLegId
+     * @param {Flights.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Chrt.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.shipping.flights.getFlightStatusForFlightLegV1("flight_leg_id")
+     */
+    getFlightStatusForFlightLegV1(flightLegId: string, requestOptions?: Flights.RequestOptions): core.HttpResponsePromise<Chrt.FlightLeg1>;
+    private __getFlightStatusForFlightLegV1;
+    /**
+     * Returns the Cirium-sourced positional track for a flight leg — the live breadcrumb trail plus the planned path (waypoints + legacy route) in one read-through call. | authz_personas=[driver_for_executor, coordinator_org_operators, executor_org_operators, shipper_org_operators] | () -> (FlightTrackRes)
+     *
+     * @param {string} flightLegId
+     * @param {Flights.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Chrt.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.shipping.flights.getFlightTrackForFlightLegV1("flight_leg_id")
+     */
+    getFlightTrackForFlightLegV1(flightLegId: string, requestOptions?: Flights.RequestOptions): core.HttpResponsePromise<Chrt.FlightTrackRes>;
+    private __getFlightTrackForFlightLegV1;
     protected _getAuthorizationHeader(): Promise<string | undefined>;
 }

package/dist/cjs/api/resources/shipping/resources/flights/client/Client.js

@@ -173,6 +173,124 @@ class Flights {
             }
         });
     }
+    /**
+     * Returns the flight leg with its Cirium-sourced status, lazily resolving the Cirium flightId and refreshing the cached status on read. | authz_personas=[driver_for_executor, coordinator_org_operators, executor_org_operators, shipper_org_operators] | () -> (FlightLeg1)
+     *
+     * @param {string} flightLegId
+     * @param {Flights.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Chrt.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.shipping.flights.getFlightStatusForFlightLegV1("flight_leg_id")
+     */
+    getFlightStatusForFlightLegV1(flightLegId, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getFlightStatusForFlightLegV1(flightLegId, requestOptions));
+    }
+    __getFlightStatusForFlightLegV1(flightLegId, 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, `shipping/flights/status/for_flight_leg/v1/${encodeURIComponent(flightLegId)}`),
+                method: "GET",
+                headers: _headers,
+                queryParameters: 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,
+            });
+            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 GET /shipping/flights/status/for_flight_leg/v1/{flight_leg_id}.");
+                case "unknown":
+                    throw new errors.ChrtError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    /**
+     * Returns the Cirium-sourced positional track for a flight leg — the live breadcrumb trail plus the planned path (waypoints + legacy route) in one read-through call. | authz_personas=[driver_for_executor, coordinator_org_operators, executor_org_operators, shipper_org_operators] | () -> (FlightTrackRes)
+     *
+     * @param {string} flightLegId
+     * @param {Flights.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Chrt.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.shipping.flights.getFlightTrackForFlightLegV1("flight_leg_id")
+     */
+    getFlightTrackForFlightLegV1(flightLegId, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getFlightTrackForFlightLegV1(flightLegId, requestOptions));
+    }
+    __getFlightTrackForFlightLegV1(flightLegId, 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, `shipping/flights/track/for_flight_leg/v1/${encodeURIComponent(flightLegId)}`),
+                method: "GET",
+                headers: _headers,
+                queryParameters: 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,
+            });
+            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 GET /shipping/flights/track/for_flight_leg/v1/{flight_leg_id}.");
+                case "unknown":
+                    throw new errors.ChrtError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     _getAuthorizationHeader() {
         return __awaiter(this, void 0, void 0, function* () {
             const bearer = yield core.Supplier.get(this._options.token);

package/dist/cjs/api/resources/shipping/resources/orderDrafts/resources/taskGroup/client/Client.d.ts

@@ -60,7 +60,10 @@ export declare class TaskGroup {
      *         flight_legs: [{
      *                 schema_version: 1,
      *                 flight_number: "flight_number",
-     *                 provenance: "manual"
+     *                 provenance: "manual",
+     *                 origin_iata: "origin_iata",
+     *                 destination_iata: "destination_iata",
+     *                 scheduled_departure_utc: "2024-01-15T09:30:00Z"
      *             }]
      *     })
      */

package/dist/cjs/api/resources/shipping/resources/orderDrafts/resources/taskGroup/client/Client.js

@@ -134,7 +134,10 @@ class TaskGroup {
      *         flight_legs: [{
      *                 schema_version: 1,
      *                 flight_number: "flight_number",
-     *                 provenance: "manual"
+     *                 provenance: "manual",
+     *                 origin_iata: "origin_iata",
+     *                 destination_iata: "destination_iata",
+     *                 scheduled_departure_utc: "2024-01-15T09:30:00Z"
      *             }]
      *     })
      */

package/dist/cjs/api/resources/shipping/resources/taskGroups/client/Client.d.ts

@@ -154,7 +154,10 @@ export declare class TaskGroups {
      *         flight_legs: [{
      *                 schema_version: 1,
      *                 flight_number: "flight_number",
-     *                 provenance: "manual"
+     *                 provenance: "manual",
+     *                 origin_iata: "origin_iata",
+     *                 destination_iata: "destination_iata",
+     *                 scheduled_departure_utc: "2024-01-15T09:30:00Z"
      *             }]
      *     })
      */

package/dist/cjs/api/resources/shipping/resources/taskGroups/client/Client.js

@@ -522,7 +522,10 @@ class TaskGroups {
      *         flight_legs: [{
      *                 schema_version: 1,
      *                 flight_number: "flight_number",
-     *                 provenance: "manual"
+     *                 provenance: "manual",
+     *                 origin_iata: "origin_iata",
+     *                 destination_iata: "destination_iata",
+     *                 scheduled_departure_utc: "2024-01-15T09:30:00Z"
      *             }]
      *     })
      */

package/dist/cjs/api/types/FlightLeg1.d.ts

@@ -9,11 +9,22 @@ export interface FlightLeg1 {
     task_group_id: string;
     flight_number: string;
     provenance: Chrt.FlightLegProvenanceEnum1;
+    origin_iata: string;
+    destination_iata: string;
+    scheduled_departure_utc: string;
     carrier_iata?: string | null;
     carrier_icao?: string | null;
-    origin_iata?: string | null;
-    destination_iata?: string | null;
-    scheduled_departure_utc?: string | null;
     scheduled_arrival_utc?: string | null;
-    fa_flight_ids?: string[];
+    cirium_flight_id?: number | null;
+    flight_status?: Chrt.FlightLegStatusEnum1 | null;
+    estimated_departure_utc?: string | null;
+    actual_departure_utc?: string | null;
+    estimated_arrival_utc?: string | null;
+    actual_arrival_utc?: string | null;
+    departure_gate?: string | null;
+    arrival_gate?: string | null;
+    departure_terminal?: string | null;
+    arrival_terminal?: string | null;
+    flight_status_source?: Chrt.FlightLegStatusSourceEnum1 | null;
+    flight_status_fetched_at_utc?: string | null;
 }

package/dist/cjs/api/types/FlightLegClientCreate1.d.ts

@@ -6,11 +6,10 @@ export interface FlightLegClientCreate1 {
     schema_version: number;
     flight_number: string;
     provenance: Chrt.FlightLegProvenanceEnum1;
+    origin_iata: string;
+    destination_iata: string;
+    scheduled_departure_utc: string;
     carrier_iata?: string | null;
     carrier_icao?: string | null;
-    origin_iata?: string | null;
-    destination_iata?: string | null;
-    scheduled_departure_utc?: string | null;
     scheduled_arrival_utc?: string | null;
-    fa_flight_ids?: string[];
 }

package/dist/cjs/api/types/FlightLegStatusEnum1.d.ts

@@ -0,0 +1,14 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export type FlightLegStatusEnum1 = "scheduled" | "departed_gate" | "in_flight" | "landed" | "arrived_gate" | "cancelled" | "diverted" | "unknown";
+export declare const FlightLegStatusEnum1: {
+    readonly Scheduled: "scheduled";
+    readonly DepartedGate: "departed_gate";
+    readonly InFlight: "in_flight";
+    readonly Landed: "landed";
+    readonly ArrivedGate: "arrived_gate";
+    readonly Cancelled: "cancelled";
+    readonly Diverted: "diverted";
+    readonly Unknown: "unknown";
+};

package/dist/cjs/api/types/FlightLegStatusEnum1.js

@@ -0,0 +1,16 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FlightLegStatusEnum1 = void 0;
+exports.FlightLegStatusEnum1 = {
+    Scheduled: "scheduled",
+    DepartedGate: "departed_gate",
+    InFlight: "in_flight",
+    Landed: "landed",
+    ArrivedGate: "arrived_gate",
+    Cancelled: "cancelled",
+    Diverted: "diverted",
+    Unknown: "unknown",
+};

package/dist/cjs/api/types/FlightLegStatusSourceEnum1.d.ts

@@ -0,0 +1,8 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export type FlightLegStatusSourceEnum1 = "live" | "historical";
+export declare const FlightLegStatusSourceEnum1: {
+    readonly Live: "live";
+    readonly Historical: "historical";
+};

package/dist/cjs/api/types/FlightLegStatusSourceEnum1.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FlightLegStatusSourceEnum1 = void 0;
+exports.FlightLegStatusSourceEnum1 = {
+    Live: "live",
+    Historical: "historical",
+};

package/dist/cjs/api/types/FlightLegWebhookInfo.d.ts

@@ -17,6 +17,4 @@ export interface FlightLegWebhookInfo {
     scheduled_departure_utc?: string | null;
     /** Scheduled arrival (UTC) */
     scheduled_arrival_utc?: string | null;
-    /** FlightAware flight UUIDs associated with this leg */
-    fa_flight_ids?: string[];
 }

package/dist/cjs/api/types/FlightTrackPosition.d.ts

@@ -0,0 +1,14 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * A single reported (or derived) aircraft position along the flown trail.
+ */
+export interface FlightTrackPosition {
+    lat?: number | null;
+    lon?: number | null;
+    altitude_ft?: number | null;
+    speed_mph?: number | null;
+    source?: string | null;
+    date_utc?: string | null;
+}

package/dist/cjs/api/types/FlightTrackPosition.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/FlightTrackRes.d.ts

@@ -0,0 +1,21 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Chrt from "../index.js";
+/**
+ * Positional track for a flight leg: live trail + (optional) planned path.
+ *
+ * `positions` is the flown breadcrumb trail (present once airborne);
+ * `waypoints` / `legacy_route` are the planned path (present once Cirium has
+ * the filed flight plan, ~24h before departure). Everything is empty when the
+ * leg has no resolvable Cirium `flightId` or Cirium has no track yet — the
+ * endpoint never errors on a missing track (fail-soft, like the status route).
+ */
+export interface FlightTrackRes {
+    cirium_flight_id?: number | null;
+    positions?: Chrt.FlightTrackPosition[];
+    waypoints?: Chrt.FlightTrackWaypoint[];
+    legacy_route?: string | null;
+    bearing?: number | null;
+    heading?: number | null;
+}

package/dist/cjs/api/types/FlightTrackRes.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/FlightTrackWaypoint.d.ts

@@ -0,0 +1,10 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * A lat/lon point on the published flight plan (the planned path).
+ */
+export interface FlightTrackWaypoint {
+    lat?: number | null;
+    lon?: number | null;
+}

package/dist/cjs/api/types/FlightTrackWaypoint.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/index.d.ts

@@ -151,8 +151,13 @@ export * from "./FlightInfoForTaskRes.js";
 export * from "./FlightLeg1.js";
 export * from "./FlightLegClientCreate1.js";
 export * from "./FlightLegProvenanceEnum1.js";
+export * from "./FlightLegStatusEnum1.js";
+export * from "./FlightLegStatusSourceEnum1.js";
 export * from "./FlightLegWebhookInfo.js";
 export * from "./FlightStatusEnum.js";
+export * from "./FlightTrackPosition.js";
+export * from "./FlightTrackRes.js";
+export * from "./FlightTrackWaypoint.js";
 export * from "./GeometryCollectionGeometriesItem.js";
 export * from "./GeometryCollection.js";
 export * from "./HttpValidationError.js";

package/dist/cjs/api/types/index.js

@@ -167,8 +167,13 @@ __exportStar(require("./FlightInfoForTaskRes.js"), exports);
 __exportStar(require("./FlightLeg1.js"), exports);
 __exportStar(require("./FlightLegClientCreate1.js"), exports);
 __exportStar(require("./FlightLegProvenanceEnum1.js"), exports);
+__exportStar(require("./FlightLegStatusEnum1.js"), exports);
+__exportStar(require("./FlightLegStatusSourceEnum1.js"), exports);
 __exportStar(require("./FlightLegWebhookInfo.js"), exports);
 __exportStar(require("./FlightStatusEnum.js"), exports);
+__exportStar(require("./FlightTrackPosition.js"), exports);
+__exportStar(require("./FlightTrackRes.js"), exports);
+__exportStar(require("./FlightTrackWaypoint.js"), exports);
 __exportStar(require("./GeometryCollectionGeometriesItem.js"), exports);
 __exportStar(require("./GeometryCollection.js"), exports);
 __exportStar(require("./HttpValidationError.js"), exports);

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "1.751.0";
+export declare const SDK_VERSION = "1.754.0";

package/dist/cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "1.751.0";
+exports.SDK_VERSION = "1.754.0";

package/dist/esm/Client.mjs

@@ -20,8 +20,8 @@ export class ChrtClient {
         this._options = Object.assign(Object.assign({}, _options), { headers: mergeHeaders({
                 "X-Fern-Language": "JavaScript",
                 "X-Fern-SDK-Name": "@chrt-inc/typescript-sdk",
-                "X-Fern-SDK-Version": "1.751.0",
-                "User-Agent": "@chrt-inc/typescript-sdk/1.751.0",
+                "X-Fern-SDK-Version": "1.754.0",
+                "User-Agent": "@chrt-inc/typescript-sdk/1.754.0",
                 "X-Fern-Runtime": core.RUNTIME.type,
                 "X-Fern-Runtime-Version": core.RUNTIME.version,
             }, _options === null || _options === void 0 ? void 0 : _options.headers) });

package/dist/esm/api/resources/shipping/resources/flights/client/Client.d.mts

@@ -56,5 +56,31 @@ export declare class Flights {
      */
     getFlightLegsForTaskGroupV1(taskGroupId: string, requestOptions?: Flights.RequestOptions): core.HttpResponsePromise<Chrt.FlightInfoForTaskRes>;
     private __getFlightLegsForTaskGroupV1;
+    /**
+     * Returns the flight leg with its Cirium-sourced status, lazily resolving the Cirium flightId and refreshing the cached status on read. | authz_personas=[driver_for_executor, coordinator_org_operators, executor_org_operators, shipper_org_operators] | () -> (FlightLeg1)
+     *
+     * @param {string} flightLegId
+     * @param {Flights.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Chrt.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.shipping.flights.getFlightStatusForFlightLegV1("flight_leg_id")
+     */
+    getFlightStatusForFlightLegV1(flightLegId: string, requestOptions?: Flights.RequestOptions): core.HttpResponsePromise<Chrt.FlightLeg1>;
+    private __getFlightStatusForFlightLegV1;
+    /**
+     * Returns the Cirium-sourced positional track for a flight leg — the live breadcrumb trail plus the planned path (waypoints + legacy route) in one read-through call. | authz_personas=[driver_for_executor, coordinator_org_operators, executor_org_operators, shipper_org_operators] | () -> (FlightTrackRes)
+     *
+     * @param {string} flightLegId
+     * @param {Flights.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Chrt.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.shipping.flights.getFlightTrackForFlightLegV1("flight_leg_id")
+     */
+    getFlightTrackForFlightLegV1(flightLegId: string, requestOptions?: Flights.RequestOptions): core.HttpResponsePromise<Chrt.FlightTrackRes>;
+    private __getFlightTrackForFlightLegV1;
     protected _getAuthorizationHeader(): Promise<string | undefined>;
 }

package/dist/esm/api/resources/shipping/resources/flights/client/Client.mjs

@@ -137,6 +137,124 @@ export class Flights {
             }
         });
     }
+    /**
+     * Returns the flight leg with its Cirium-sourced status, lazily resolving the Cirium flightId and refreshing the cached status on read. | authz_personas=[driver_for_executor, coordinator_org_operators, executor_org_operators, shipper_org_operators] | () -> (FlightLeg1)
+     *
+     * @param {string} flightLegId
+     * @param {Flights.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Chrt.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.shipping.flights.getFlightStatusForFlightLegV1("flight_leg_id")
+     */
+    getFlightStatusForFlightLegV1(flightLegId, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getFlightStatusForFlightLegV1(flightLegId, requestOptions));
+    }
+    __getFlightStatusForFlightLegV1(flightLegId, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d;
+            let _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, 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, `shipping/flights/status/for_flight_leg/v1/${encodeURIComponent(flightLegId)}`),
+                method: "GET",
+                headers: _headers,
+                queryParameters: 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,
+            });
+            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 GET /shipping/flights/status/for_flight_leg/v1/{flight_leg_id}.");
+                case "unknown":
+                    throw new errors.ChrtError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    /**
+     * Returns the Cirium-sourced positional track for a flight leg — the live breadcrumb trail plus the planned path (waypoints + legacy route) in one read-through call. | authz_personas=[driver_for_executor, coordinator_org_operators, executor_org_operators, shipper_org_operators] | () -> (FlightTrackRes)
+     *
+     * @param {string} flightLegId
+     * @param {Flights.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Chrt.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.shipping.flights.getFlightTrackForFlightLegV1("flight_leg_id")
+     */
+    getFlightTrackForFlightLegV1(flightLegId, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getFlightTrackForFlightLegV1(flightLegId, requestOptions));
+    }
+    __getFlightTrackForFlightLegV1(flightLegId, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d;
+            let _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, 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, `shipping/flights/track/for_flight_leg/v1/${encodeURIComponent(flightLegId)}`),
+                method: "GET",
+                headers: _headers,
+                queryParameters: 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,
+            });
+            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 GET /shipping/flights/track/for_flight_leg/v1/{flight_leg_id}.");
+                case "unknown":
+                    throw new errors.ChrtError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     _getAuthorizationHeader() {
         return __awaiter(this, void 0, void 0, function* () {
             const bearer = yield core.Supplier.get(this._options.token);

package/dist/esm/api/resources/shipping/resources/orderDrafts/resources/taskGroup/client/Client.d.mts

@@ -60,7 +60,10 @@ export declare class TaskGroup {
      *         flight_legs: [{
      *                 schema_version: 1,
      *                 flight_number: "flight_number",
-     *                 provenance: "manual"
+     *                 provenance: "manual",
+     *                 origin_iata: "origin_iata",
+     *                 destination_iata: "destination_iata",
+     *                 scheduled_departure_utc: "2024-01-15T09:30:00Z"
      *             }]
      *     })
      */

package/dist/esm/api/resources/shipping/resources/orderDrafts/resources/taskGroup/client/Client.mjs

@@ -98,7 +98,10 @@ export class TaskGroup {
      *         flight_legs: [{
      *                 schema_version: 1,
      *                 flight_number: "flight_number",
-     *                 provenance: "manual"
+     *                 provenance: "manual",
+     *                 origin_iata: "origin_iata",
+     *                 destination_iata: "destination_iata",
+     *                 scheduled_departure_utc: "2024-01-15T09:30:00Z"
      *             }]
      *     })
      */

package/dist/esm/api/resources/shipping/resources/taskGroups/client/Client.d.mts

@@ -154,7 +154,10 @@ export declare class TaskGroups {
      *         flight_legs: [{
      *                 schema_version: 1,
      *                 flight_number: "flight_number",
-     *                 provenance: "manual"
+     *                 provenance: "manual",
+     *                 origin_iata: "origin_iata",
+     *                 destination_iata: "destination_iata",
+     *                 scheduled_departure_utc: "2024-01-15T09:30:00Z"
      *             }]
      *     })
      */

package/dist/esm/api/resources/shipping/resources/taskGroups/client/Client.mjs

@@ -486,7 +486,10 @@ export class TaskGroups {
      *         flight_legs: [{
      *                 schema_version: 1,
      *                 flight_number: "flight_number",
-     *                 provenance: "manual"
+     *                 provenance: "manual",
+     *                 origin_iata: "origin_iata",
+     *                 destination_iata: "destination_iata",
+     *                 scheduled_departure_utc: "2024-01-15T09:30:00Z"
      *             }]
      *     })
      */

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

@@ -9,11 +9,22 @@ export interface FlightLeg1 {
     task_group_id: string;
     flight_number: string;
     provenance: Chrt.FlightLegProvenanceEnum1;
+    origin_iata: string;
+    destination_iata: string;
+    scheduled_departure_utc: string;
     carrier_iata?: string | null;
     carrier_icao?: string | null;
-    origin_iata?: string | null;
-    destination_iata?: string | null;
-    scheduled_departure_utc?: string | null;
     scheduled_arrival_utc?: string | null;
-    fa_flight_ids?: string[];
+    cirium_flight_id?: number | null;
+    flight_status?: Chrt.FlightLegStatusEnum1 | null;
+    estimated_departure_utc?: string | null;
+    actual_departure_utc?: string | null;
+    estimated_arrival_utc?: string | null;
+    actual_arrival_utc?: string | null;
+    departure_gate?: string | null;
+    arrival_gate?: string | null;
+    departure_terminal?: string | null;
+    arrival_terminal?: string | null;
+    flight_status_source?: Chrt.FlightLegStatusSourceEnum1 | null;
+    flight_status_fetched_at_utc?: string | null;
 }

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

@@ -6,11 +6,10 @@ export interface FlightLegClientCreate1 {
     schema_version: number;
     flight_number: string;
     provenance: Chrt.FlightLegProvenanceEnum1;
+    origin_iata: string;
+    destination_iata: string;
+    scheduled_departure_utc: string;
     carrier_iata?: string | null;
     carrier_icao?: string | null;
-    origin_iata?: string | null;
-    destination_iata?: string | null;
-    scheduled_departure_utc?: string | null;
     scheduled_arrival_utc?: string | null;
-    fa_flight_ids?: string[];
 }

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

@@ -0,0 +1,14 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export type FlightLegStatusEnum1 = "scheduled" | "departed_gate" | "in_flight" | "landed" | "arrived_gate" | "cancelled" | "diverted" | "unknown";
+export declare const FlightLegStatusEnum1: {
+    readonly Scheduled: "scheduled";
+    readonly DepartedGate: "departed_gate";
+    readonly InFlight: "in_flight";
+    readonly Landed: "landed";
+    readonly ArrivedGate: "arrived_gate";
+    readonly Cancelled: "cancelled";
+    readonly Diverted: "diverted";
+    readonly Unknown: "unknown";
+};

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

@@ -0,0 +1,13 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export const FlightLegStatusEnum1 = {
+    Scheduled: "scheduled",
+    DepartedGate: "departed_gate",
+    InFlight: "in_flight",
+    Landed: "landed",
+    ArrivedGate: "arrived_gate",
+    Cancelled: "cancelled",
+    Diverted: "diverted",
+    Unknown: "unknown",
+};

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

@@ -0,0 +1,8 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export type FlightLegStatusSourceEnum1 = "live" | "historical";
+export declare const FlightLegStatusSourceEnum1: {
+    readonly Live: "live";
+    readonly Historical: "historical";
+};

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

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export const FlightLegStatusSourceEnum1 = {
+    Live: "live",
+    Historical: "historical",
+};

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

@@ -17,6 +17,4 @@ export interface FlightLegWebhookInfo {
     scheduled_departure_utc?: string | null;
     /** Scheduled arrival (UTC) */
     scheduled_arrival_utc?: string | null;
-    /** FlightAware flight UUIDs associated with this leg */
-    fa_flight_ids?: string[];
 }

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

@@ -0,0 +1,14 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * A single reported (or derived) aircraft position along the flown trail.
+ */
+export interface FlightTrackPosition {
+    lat?: number | null;
+    lon?: number | null;
+    altitude_ft?: number | null;
+    speed_mph?: number | null;
+    source?: string | null;
+    date_utc?: string | null;
+}

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

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

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

@@ -0,0 +1,21 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Chrt from "../index.mjs";
+/**
+ * Positional track for a flight leg: live trail + (optional) planned path.
+ *
+ * `positions` is the flown breadcrumb trail (present once airborne);
+ * `waypoints` / `legacy_route` are the planned path (present once Cirium has
+ * the filed flight plan, ~24h before departure). Everything is empty when the
+ * leg has no resolvable Cirium `flightId` or Cirium has no track yet — the
+ * endpoint never errors on a missing track (fail-soft, like the status route).
+ */
+export interface FlightTrackRes {
+    cirium_flight_id?: number | null;
+    positions?: Chrt.FlightTrackPosition[];
+    waypoints?: Chrt.FlightTrackWaypoint[];
+    legacy_route?: string | null;
+    bearing?: number | null;
+    heading?: number | null;
+}

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

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

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

@@ -0,0 +1,10 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * A lat/lon point on the published flight plan (the planned path).
+ */
+export interface FlightTrackWaypoint {
+    lat?: number | null;
+    lon?: number | null;
+}

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

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

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

@@ -151,8 +151,13 @@ export * from "./FlightInfoForTaskRes.mjs";
 export * from "./FlightLeg1.mjs";
 export * from "./FlightLegClientCreate1.mjs";
 export * from "./FlightLegProvenanceEnum1.mjs";
+export * from "./FlightLegStatusEnum1.mjs";
+export * from "./FlightLegStatusSourceEnum1.mjs";
 export * from "./FlightLegWebhookInfo.mjs";
 export * from "./FlightStatusEnum.mjs";
+export * from "./FlightTrackPosition.mjs";
+export * from "./FlightTrackRes.mjs";
+export * from "./FlightTrackWaypoint.mjs";
 export * from "./GeometryCollectionGeometriesItem.mjs";
 export * from "./GeometryCollection.mjs";
 export * from "./HttpValidationError.mjs";

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

@@ -151,8 +151,13 @@ export * from "./FlightInfoForTaskRes.mjs";
 export * from "./FlightLeg1.mjs";
 export * from "./FlightLegClientCreate1.mjs";
 export * from "./FlightLegProvenanceEnum1.mjs";
+export * from "./FlightLegStatusEnum1.mjs";
+export * from "./FlightLegStatusSourceEnum1.mjs";
 export * from "./FlightLegWebhookInfo.mjs";
 export * from "./FlightStatusEnum.mjs";
+export * from "./FlightTrackPosition.mjs";
+export * from "./FlightTrackRes.mjs";
+export * from "./FlightTrackWaypoint.mjs";
 export * from "./GeometryCollectionGeometriesItem.mjs";
 export * from "./GeometryCollection.mjs";
 export * from "./HttpValidationError.mjs";

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "1.751.0";
+export declare const SDK_VERSION = "1.754.0";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "1.751.0";
+export const SDK_VERSION = "1.754.0";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@chrt-inc/typescript-sdk",
-    "version": "1.751.0",
+    "version": "1.754.0",
     "private": false,
     "repository": "github:chrt-inc/typescript-sdk",
     "type": "commonjs",

package/reference.md

@@ -17573,6 +17573,132 @@ await client.shipping.flights.getFlightLegsForTaskGroupV1("task_group_id");
 </dl>
 </details>
 
+<details><summary><code>client.shipping.flights.<a href="/src/api/resources/shipping/resources/flights/client/Client.ts">getFlightStatusForFlightLegV1</a>(flightLegId) -> Chrt.FlightLeg1</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Returns the flight leg with its Cirium-sourced status, lazily resolving the Cirium flightId and refreshing the cached status on read. | authz_personas=[driver_for_executor, coordinator_org_operators, executor_org_operators, shipper_org_operators] | () -> (FlightLeg1)
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.shipping.flights.getFlightStatusForFlightLegV1("flight_leg_id");
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**flightLegId:** `string`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Flights.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.shipping.flights.<a href="/src/api/resources/shipping/resources/flights/client/Client.ts">getFlightTrackForFlightLegV1</a>(flightLegId) -> Chrt.FlightTrackRes</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Returns the Cirium-sourced positional track for a flight leg — the live breadcrumb trail plus the planned path (waypoints + legacy route) in one read-through call. | authz_personas=[driver_for_executor, coordinator_org_operators, executor_org_operators, shipper_org_operators] | () -> (FlightTrackRes)
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.shipping.flights.getFlightTrackForFlightLegV1("flight_leg_id");
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**flightLegId:** `string`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Flights.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
 ## Shipping TaskArtifacts
 
 <details><summary><code>client.shipping.taskArtifacts.<a href="/src/api/resources/shipping/resources/taskArtifacts/client/Client.ts">addToTaskV1</a>(taskId, { ...params }) -> string</code></summary>
@@ -20454,6 +20580,9 @@ await client.shipping.taskGroups.setFlightInfoV1("task_group_id", {
             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",
         },
     ],
 });
@@ -23180,6 +23309,9 @@ await client.shipping.orderDrafts.taskGroup.setFlightInfoV1("task_group_id", {
             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",
         },
     ],
 });