@chargetrip/types 1.73.0 → 1.75.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chargetrip/types",
-  "version": "1.73.0",
+  "version": "1.75.0",
   "license": "MIT",
   "keywords": [
     "chargetrip",

package/src/graphql.ts

@@ -3176,20 +3176,20 @@ export type NavigationOverviewpolylineArgs = {
 };
 
 export type NavigationPropertiesStation = {
-  /** ID of the station. When provided and valid, the coordinates of this station will be used. */
+  /** ID of the station. If specified and valid, the station is used as a mandatory charging stop. */
   station_id?: Maybe<Scalars["ID"]>;
-  /** External ID of the station. When provided and valid, the coordinates of this station will be used. */
+  /** External ID of the station. If specified and valid, the station is used as a mandatory charging stop. */
   external_station_id?: Maybe<Scalars["ID"]>;
-  /** Duration to stay at the station, in seconds. Includes charging time and charging penalty. When not provided, the duration is optimized based on the vehicle’s charging needs and selected charging mode. */
+  /** Minimum duration of the stop at the station, in seconds. This duration can be extended based on the chosen charging mode. Under `ALWAYS_TO_MAX_CHARGE`, the duration is extended until the defined maximum state of charge of the vehicle is achieved. Under `OPTIMIZE_TRAVEL_TIME`, the duration is extended only if a longer stay optimizes the overall travel time, otherwise, the vehicle charges only for the specified duration. If not specified, the duration is solely determined by the charging mode specified in `vehicle.charging.mode` or configured in the project settings. */
   stop_duration?: Maybe<Scalars["Int"]>;
 };
 
 export type NavigationPropertiesStationInput = {
-  /** ID of the station. When provided and valid, the coordinates of this station will be used. */
+  /** ID of the station. If specified and valid, the station is used as a mandatory charging stop. */
   station_id?: Maybe<Scalars["ID"]>;
-  /** External ID of the station. When provided and valid, the coordinates of this station will be used. */
+  /** External ID of the station. If specified and valid, the station is used as a mandatory charging stop. */
   external_station_id?: Maybe<Scalars["ID"]>;
-  /** Duration to stay at the station, in seconds. Includes charging time and charging penalty. When not provided, the duration is optimized based on the vehicle’s charging needs and selected charging mode. */
+  /** Minimum duration of the stop at the station, in seconds. This duration can be extended based on the chosen charging mode. Under `ALWAYS_TO_MAX_CHARGE`, the duration is extended until the defined maximum state of charge of the vehicle is achieved. Under `OPTIMIZE_TRAVEL_TIME`, the duration is extended only if a longer stay optimizes the overall travel time, otherwise, the vehicle charges only for the specified duration. If not specified, the duration is solely determined by the charging mode specified in `vehicle.charging.mode` or configured in the project settings. */
   stop_duration?: Maybe<Scalars["Int"]>;
 };
 
@@ -3406,7 +3406,7 @@ export type NavigationViaFeaturePoint = {
   type: FeatureType;
   /** Geometry of the feature. */
   geometry: Point;
-  /** Additional feature properties for via. If a `station.id` or `station.external_id` are provided, it will be treated as a charging stop.  If omitted or `location.name` is provided, the stop is treated as a non-charging stop location. */
+  /** Properties of the via point. Used to designate the via point as a charging stop, configure vehicle occupancy and cargo details, or set optional location parameters. If both `properties.station.id` and `properties.station.external_id` are omitted, the via point is treated as a non-charging stop at `geometry`. */
   properties?: Maybe<NavigationViaProperties>;
 };
 
@@ -3417,7 +3417,7 @@ export type NavigationViaFeaturePointInput = {
   type: FeatureType;
   /** Geometry of the feature. */
   geometry: PointInput;
-  /** Additional feature properties for via. If a `station.id` or `station.external_id` are provided, it will be treated as a charging stop.  If omitted or `location.name` is provided, the stop is treated as a non-charging stop location. */
+  /** Properties of the via point. Used to designate the via point as a charging stop, configure vehicle occupancy and cargo details, or set optional location parameters. If both `properties.station.id` and `properties.station.external_id` are omitted, the via point is treated as a non-charging stop at `geometry`. */
   properties?: Maybe<NavigationViaPropertiesInput>;
 };
 
@@ -5394,6 +5394,8 @@ export enum RouteDetailsLegWarningCode {
   STATION_CLOSING_SOON = "station_closing_soon",
   /** Specified stop duration at the via charging station is insufficient to start a charging session. */
   VIA_INSUFFICIENT_CHARGING_TIME = "via_insufficient_charging_time",
+  /** The stop duration at the station was extended to meet the charging mode for this route. */
+  VIA_CHARGING_DURATION_EXTENDED = "via_charging_duration_extended",
   /** Selected via station does not have compatible connectors that meet the minimum power threshold. The route still includes this charging stop, but charging will be slower than requested. */
   VIA_STATION_BELOW_MINIMUM_POWER = "via_station_below_minimum_power",
   /** Charging station at the destination does not have any connectors compatible with the selected vehicle. */
@@ -6508,20 +6510,20 @@ export type RoutePropertiesLocationInput = {
 };
 
 export type RoutePropertiesStation = {
-  /** ID of the station. When provided and valid, the coordinates of this station will be used. */
+  /** ID of the station. If specified and valid, the station is used as a mandatory charging stop. */
   station_id?: Maybe<Scalars["ID"]>;
-  /** External ID of the station. When provided and valid, the coordinates of this station will be used. */
+  /** External ID of the station. If specified and valid, the station is used as a mandatory charging stop. */
   external_station_id?: Maybe<Scalars["ID"]>;
-  /** Duration to stay at the station, in seconds. */
+  /** Minimum duration of the stop at the station, in seconds. This duration can be extended based on the chosen charging mode. Under `ALWAYS_TO_MAX_CHARGE`, the duration is extended until the defined maximum state of charge of the vehicle is achieved. Under `OPTIMIZE_TRAVEL_TIME`, the duration is extended only if a longer stay optimizes the overall travel time, otherwise, the vehicle charges only for the specified duration. If not specified, the duration is solely determined by the charging mode specified in `vehicle.charging.mode` or configured in the project settings. */
   stop_duration?: Maybe<Scalars["Int"]>;
 };
 
 export type RoutePropertiesStationInput = {
-  /** ID of the station. When provided and valid, the coordinates of this station will be used. */
+  /** ID of the station. If specified and valid, the station is used as a mandatory charging stop. */
   station_id?: Maybe<Scalars["ID"]>;
-  /** External ID of the station. When provided and valid, the coordinates of this station will be used. */
+  /** External ID of the station. If specified and valid, the station is used as a mandatory charging stop. */
   external_station_id?: Maybe<Scalars["ID"]>;
-  /** Duration to stay at the station, in seconds. */
+  /** Minimum duration of the stop at the station, in seconds. This duration can be extended based on the chosen charging mode. Under `ALWAYS_TO_MAX_CHARGE`, the duration is extended until the defined maximum state of charge of the vehicle is achieved. Under `OPTIMIZE_TRAVEL_TIME`, the duration is extended only if a longer stay optimizes the overall travel time, otherwise, the vehicle charges only for the specified duration. If not specified, the duration is solely determined by the charging mode specified in `vehicle.charging.mode` or configured in the project settings. */
   stop_duration?: Maybe<Scalars["Int"]>;
 };
 
@@ -6899,7 +6901,7 @@ export type RouteTruckViaPropertiesInput = {
   location?: Maybe<RoutePropertiesViaLocationInput>;
   /** Vehicle configuration at this point. Properties defined here override previous settings and persist for all subsequent segments of the route until changed again. If not specified, the vehicle state from the previous point remains in effect. */
   vehicle?: Maybe<RouteTruckPropertiesVehicleInput>;
-  /** Station data of the via point. */
+  /** Specifies a charging station at the via. If a known station is provided, it will be used as charging stop. Any configured operator preferences are ignored for this stop. */
   station?: Maybe<RoutePropertiesStationInput>;
 };
 
@@ -7144,7 +7146,7 @@ export type RouteViaFeaturePoint = {
   type: FeatureType;
   /** Geometry of the feature. */
   geometry?: Maybe<Point>;
-  /** Additional feature properties for via. If a `station.id` or `station.external_id` are provided, it will be treated as a charging stop.  If omitted or `location.name` is provided, the stop is treated as a non-charging stop location. */
+  /** Properties of the via point. Used to designate the via point as a charging stop, configure vehicle occupancy and cargo details, or set optional location parameters. If both `properties.station.id` and `properties.station.external_id` are omitted, the via point is treated as a non-charging stop at `geometry`. */
   properties?: Maybe<RouteViaProperties>;
 };
 
@@ -7155,7 +7157,7 @@ export type RouteViaFeaturePointInput = {
   type: FeatureType;
   /** Geometry of the feature. */
   geometry?: Maybe<PointInput>;
-  /** Additional feature properties for via. If a `station.id` or `station.external_id` are provided, it will be treated as a charging stop.  If omitted or `location.name` is provided, the stop is treated as a non-charging stop location. */
+  /** Properties of the via point. Used to designate the via point as a charging stop, configure vehicle occupancy and cargo details, or set optional location parameters. If both `properties.station.id` and `properties.station.external_id` are omitted, the via point is treated as a non-charging stop at `geometry`. */
   properties?: Maybe<RouteViaPropertiesInput>;
 };
 
@@ -8581,6 +8583,8 @@ export type VehicleListNaming = {
   edition?: Maybe<Scalars["String"]>;
   /** Vehicle model version. Added by Chargetrip as an alternative for when a vehicle manufacturer does not provide a version name, or uses the same version name across all trims or consecutive years. */
   chargetrip_version: Scalars["String"];
+  /** Top-level general model series identifier. */
+  series?: Maybe<Scalars["String"]>;
 };
 
 export type VehicleListRange = {
@@ -8681,6 +8685,8 @@ export type VehicleNaming = {
   edition?: Maybe<Scalars["String"]>;
   /** Vehicle model version. Added by Chargetrip as an alternative for when a vehicle manufacturer does not provide a version name, or uses the same version name across all trims or consecutive years. */
   chargetrip_version: Scalars["String"];
+  /** Top-level general model series identifier. */
+  series?: Maybe<Scalars["String"]>;
 };
 
 export type VehiclePerformance = {
@@ -8723,6 +8729,8 @@ export type VehiclePremium = {
   charge: VehiclePremiumCharge;
   /** Fast charge details. */
   fast_charge: VehiclePremiumFastCharge;
+  /** Manufacturer-stated fast charging specifications. */
+  fast_charge_oem?: Maybe<VehiclePremiumFastChargeOEM>;
   /** Adapters of connectors available for a connectors of the vehicle. Please note that for HEVs this will always be an empty array. */
   adapters: Array<VehicleConnector>;
   /** Battery of the vehicle. */
@@ -8735,10 +8743,14 @@ export type VehiclePremium = {
   pricing: VehiclePremiumPriceValueWithGrant;
   /** Drivetrain of the vehicle. */
   drivetrain: VehiclePremiumDrivetrain;
+  /** Internal combustion engine (ICE) and fuel storage specifications for hybrid and plug-in hybrid vehicles. This field is null for battery electric vehicles. */
+  combustion?: Maybe<VehiclePremiumCombustion>;
   /** Performance of the vehicle. */
   performance?: Maybe<VehiclePremiumPerformance>;
   /** Range of the vehicle. */
   range: VehiclePremiumRange;
+  /** One-stop range data by climatic condition (mild, average, cold), including durations and rating. */
+  one_stop_range?: Maybe<VehiclePremiumOneStopRange>;
   /** Efficiency of the vehicle. */
   efficiency: VehiclePremiumEfficiency;
   /** Safety of the vehicle. */
@@ -8797,6 +8809,12 @@ export type VehiclePremiumBattery = {
   nominal_voltage?: Maybe<Scalars["Float"]>;
   /** Type of battery. */
   type?: Maybe<VehicleBatteryType>;
+  /** Form factor of the battery cells. */
+  form_factor?: Maybe<Scalars["String"]>;
+  /** Battery pack name or reference code. */
+  name?: Maybe<Scalars["String"]>;
+  /** Battery and drivetrain platform system voltage architecture. */
+  architecture?: Maybe<Scalars["String"]>;
 };
 
 export type VehiclePremiumBatteryweightArgs = {
@@ -9072,6 +9090,24 @@ export type VehiclePremiumChargeStandardOBCcharge_speedArgs = {
   unit?: Maybe<ChargeSpeedUnit>;
 };
 
+/** Specifications for internal combustion engine (ICE) systems. */
+export type VehiclePremiumCombustion = {
+  /** Fuel tank capacity of the vehicle. */
+  fuel_tank_capacity?: Maybe<Scalars["Float"]>;
+  /** Engine displacement. */
+  displacement?: Maybe<Scalars["Float"]>;
+};
+
+/** Specifications for internal combustion engine (ICE) systems. */
+export type VehiclePremiumCombustionfuel_tank_capacityArgs = {
+  unit?: Maybe<VolumeUnit>;
+};
+
+/** Specifications for internal combustion engine (ICE) systems. */
+export type VehiclePremiumCombustiondisplacementArgs = {
+  unit?: Maybe<VolumeUnit>;
+};
+
 export type VehiclePremiumDrivetrain = {
   /** Type of drivetrain. */
   type: VehicleDrivetrainType;
@@ -9127,6 +9163,10 @@ export type VehiclePremiumEfficiencyNEDC = {
   vehicle_fuel_equivalent?: Maybe<Scalars["Float"]>;
   /** Rated CO2 emissions in NEDC combined cycle in battery-only mode (NULL if not NEDC rated). */
   co2?: Maybe<Scalars["Float"]>;
+  /** Fuel efficiency under the NEDC cycle when the hybrid battery is completely empty. Only applicable to PHEVs. */
+  battery_empty?: Maybe<Scalars["Float"]>;
+  /** CO2 emissions under the NEDC cycle when the hybrid battery is completely empty. Only applicable to PHEVs. */
+  battery_empty_co2?: Maybe<Scalars["Float"]>;
 };
 
 export type VehiclePremiumEfficiencyNEDCvalueArgs = {
@@ -9149,6 +9189,14 @@ export type VehiclePremiumEfficiencyNEDCco2Args = {
   unit?: Maybe<EmissionRateUnit>;
 };
 
+export type VehiclePremiumEfficiencyNEDCbattery_emptyArgs = {
+  unit?: Maybe<FuelConsumptionUnit>;
+};
+
+export type VehiclePremiumEfficiencyNEDCbattery_empty_co2Args = {
+  unit?: Maybe<EmissionRateUnit>;
+};
+
 export type VehiclePremiumEfficiencyProvider = {
   /** Vehicle efficiency based on RealRange (usable battery/range). */
   value?: Maybe<Scalars["Float"]>;
@@ -9286,6 +9334,29 @@ export type VehiclePremiumFastChargecharge_speedArgs = {
   unit?: Maybe<ChargeSpeedUnit>;
 };
 
+export type VehiclePremiumFastChargeOEM = {
+  /** Manufacturer-stated maximum power for a fast charging session. */
+  maximum_power?: Maybe<Scalars["Float"]>;
+  /** Manufacturer-stated charge time in seconds for a fast charging session. */
+  charge_time?: Maybe<Scalars["Int"]>;
+  /** Manufacturer-stated start state of charge for a fast charging session. */
+  start_state_of_charge?: Maybe<Scalars["Float"]>;
+  /** Manufacturer-stated end state of charge for a fast charging session. */
+  end_state_of_charge?: Maybe<Scalars["Float"]>;
+};
+
+export type VehiclePremiumFastChargeOEMmaximum_powerArgs = {
+  unit?: Maybe<PowerUnit>;
+};
+
+export type VehiclePremiumFastChargeOEMstart_state_of_chargeArgs = {
+  unit?: Maybe<StateOfChargeUnit>;
+};
+
+export type VehiclePremiumFastChargeOEMend_state_of_chargeArgs = {
+  unit?: Maybe<StateOfChargeUnit>;
+};
+
 export type VehiclePremiumFastChargeTable = {
   /** Charging details for fast charging (format: ChargerConnector-ChargerPower-AC/DC). */
   format?: Maybe<Scalars["String"]>;
@@ -9342,6 +9413,53 @@ export type VehiclePremiumNaming = {
   length_version?: Maybe<Scalars["String"]>;
   /** Vehicle model height version. */
   height_version?: Maybe<Scalars["String"]>;
+  /** Top-level general model series identifier. */
+  series?: Maybe<Scalars["String"]>;
+};
+
+/** 1-stop range data by climatic condition (mild, average, cold), including durations and rating. */
+export type VehiclePremiumOneStopRange = {
+  /** 1-stop range metrics in mild conditions. */
+  mild?: Maybe<VehiclePremiumOneStopRangeCondition>;
+  /** 1-stop range metrics in average conditions. */
+  average?: Maybe<VehiclePremiumOneStopRangeCondition>;
+  /** 1-stop range metrics in cold conditions. */
+  cold?: Maybe<VehiclePremiumOneStopRangeCondition>;
+  /** Long-distance rating in stars based on 1-stop range performance. */
+  rating_stars?: Maybe<Scalars["Float"]>;
+};
+
+/** 1-stop range metrics under specific climatic conditions. */
+export type VehiclePremiumOneStopRangeCondition = {
+  /** Distance for first driving leg under specific climatic conditions. */
+  first_leg_distance?: Maybe<Scalars["Float"]>;
+  /** Distance for second driving leg under specific climatic conditions. */
+  second_leg_distance?: Maybe<Scalars["Float"]>;
+  /** Total distance for 1-stop trip under specific climatic conditions. */
+  total_distance?: Maybe<Scalars["Float"]>;
+  /** Driving duration in seconds for first leg under specific climatic conditions. */
+  first_leg_duration?: Maybe<Scalars["Int"]>;
+  /** Charging duration in seconds for stop under specific climatic conditions. */
+  charging_duration?: Maybe<Scalars["Int"]>;
+  /** Driving duration in seconds for second leg under specific climatic conditions. */
+  second_leg_duration?: Maybe<Scalars["Int"]>;
+  /** Total trip duration in seconds for 1-stop trip under specific climatic conditions. */
+  total_duration?: Maybe<Scalars["Int"]>;
+};
+
+/** 1-stop range metrics under specific climatic conditions. */
+export type VehiclePremiumOneStopRangeConditionfirst_leg_distanceArgs = {
+  unit?: Maybe<DistanceUnit>;
+};
+
+/** 1-stop range metrics under specific climatic conditions. */
+export type VehiclePremiumOneStopRangeConditionsecond_leg_distanceArgs = {
+  unit?: Maybe<DistanceUnit>;
+};
+
+/** 1-stop range metrics under specific climatic conditions. */
+export type VehiclePremiumOneStopRangeConditiontotal_distanceArgs = {
+  unit?: Maybe<DistanceUnit>;
 };
 
 export type VehiclePremiumPerformance = {
@@ -9677,7 +9795,9 @@ export enum VolumeUnit {
   /** Return the volume in cubic meters. */
   CUBIC_METER = "cubic_meter",
   /** Return the volume in cubic feet. */
-  CUBIC_FOOT = "cubic_foot"
+  CUBIC_FOOT = "cubic_foot",
+  /** Return the volume in cubic centimeters. */
+  CUBIC_CENTIMETER = "cubic_centimeter"
 }
 
 /** Type of weather conditions used in the route calculation. */