@chargetrip/types 1.47.2 → 1.49.0

package/package.json

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

package/src/graphql.ts

@@ -146,7 +146,9 @@ export enum Amenities {
   BATHROOM = "bathroom",
   SUPERMARKET = "supermarket",
   PLAYGROUND = "playground",
-  PHARMACY = "pharmacy"
+  PHARMACY = "pharmacy",
+  BAKERY = "bakery",
+  CONVENIENCE_STORE = "convenience_store"
 }
 
 /** Amenity data. */
@@ -164,7 +166,7 @@ export type Amenity = {
   /** ID provided by an amenity data source as the row ID. */
   external_id: Scalars["String"];
   /** Name of the amenity. */
-  name?: Maybe<Scalars["String"]>;
+  name: Scalars["String"];
   /** Geo location coordinates. This is a GeoJSON Point. */
   location: Point;
   /** Address of the amenity. */
@@ -269,7 +271,9 @@ export enum AmenityType {
   BATHROOM = "bathroom",
   SUPERMARKET = "supermarket",
   PLAYGROUND = "playground",
-  PHARMACY = "pharmacy"
+  PHARMACY = "pharmacy",
+  BAKERY = "bakery",
+  CONVENIENCE_STORE = "convenience_store"
 }
 
 /** Type of wheelchair accessibility at the amenity. */
@@ -503,6 +507,17 @@ export enum ChargingBehaviourCode {
   OFFICE_CHARGING = "OFFICE_CHARGING"
 }
 
+export enum CongestionLevel {
+  /** Congestion level is unknown or could not be determined. */
+  UNKNOWN = "unknown",
+  /** Traffic is flowing freely with little to no delay. */
+  LOW = "low",
+  /** Increased traffic volume causing minor delays. */
+  MEDIUM = "medium",
+  /** Significant traffic volume causing heavy delays and potential standstills. */
+  HIGH = "high"
+}
+
 export type Connect = {
   /** List of connectivity providers to which the vehicle can connect. This field returns null for free users. Please contact customer success for more information. */
   providers?: Maybe<Array<ConnectProvider>>;
@@ -1276,6 +1291,8 @@ export type CreateRoute = {
   weather?: Maybe<RouteWeather>;
   /** Charging stations preferences for route calculation. */
   station_preferences?: Maybe<RouteStationPreferences>;
+  /** [BETA] Indicates whether current traffic conditions were considered during route calculation. This feature is disabled by default and requires explicit enablement for your project. Please contact Chargetrip support for more information. */
+  traffic_aware?: Maybe<Scalars["Boolean"]>;
 };
 
 /** Input for the create route mutation. */
@@ -1304,6 +1321,8 @@ export type CreateRouteInput = {
   station_preferences?: Maybe<RouteStationPreferencesInput>;
   /** [BETA] Configuration options for the route's driving conditions. Includes factors to adjust average speed, set a maximum speed, and define a base driving style. If not specified, no adjustments are applied. */
   driving_preferences?: Maybe<RouteDrivingPreferencesInput>;
+  /** [BETA] Route should consider current traffic conditions. This feature is disabled by default and requires explicit enablement for your project. Please contact Chargetrip support for more information. */
+  traffic_aware?: Maybe<Scalars["Boolean"]>;
 };
 
 /** Currency in the ISO 4217 format. */
@@ -3880,21 +3899,6 @@ export type ReviewTagsInput = {
 export type ReviewUser = {
   /** User full name. If a review was added by an anonymous user, this will be null. */
   name?: Maybe<Scalars["String"]>;
-  /**
-   * User ID.
-   * @deprecated Not sent back anymore, will be null
-   */
-  id?: Maybe<Scalars["ID"]>;
-  /**
-   * First name.
-   * @deprecated In favor of name.
-   */
-  firstName?: Maybe<Scalars["String"]>;
-  /**
-   * Last name.
-   * @deprecated In favor of name
-   */
-  lastName?: Maybe<Scalars["String"]>;
 };
 
 export type Route = {
@@ -4106,6 +4110,10 @@ export type RouteDetails = {
   tags: Array<RouteDetailsTag>;
   /** Number of charging stops required for this route. */
   charges: Scalars["Int"];
+  /** [BETA] Warnings that certain conditions specified in a route mutation are not respected. */
+  warnings?: Maybe<Array<RouteWarning>>;
+  /** [BETA] Information regarding traffic conditions along the route. Available for routes created with traffic_aware set. */
+  traffic?: Maybe<RouteDetailsTraffic>;
 };
 
 export type RouteDetailsdistanceArgs = {
@@ -4228,6 +4236,10 @@ export type RouteDetailsLeg = {
   maneuvers: Array<RouteDetailsManeuver>;
   /** Road sections of a leg - divided by means of transportation. */
   sections: Array<RouteDetailsLegSection>;
+  /** [BETA] Warnings that certain conditions specified in a route mutation are not respected. */
+  warnings?: Maybe<Array<RouteDetailsLegWarning>>;
+  /** [BETA] Information regarding traffic conditions along the route's leg . Available for routes created with traffic_aware set to true. */
+  traffic?: Maybe<RouteDetailsLegTraffic>;
 };
 
 /** Leg of a route detail. */
@@ -4354,6 +4366,8 @@ export type RouteDetailsLegSection = {
   duration: Scalars["Float"];
   /** Total energy used in a section in kilowatt-hours. The value will be 0 for walking sections. */
   consumption?: Maybe<Scalars["Float"]>;
+  /** [BETA] Information regarding traffic conditions along the leg's section. Available for routes created with traffic_aware set to true. */
+  traffic?: Maybe<RouteDetailsLegSectionTraffic>;
 };
 
 export type RouteDetailsLegSectionpolylineArgs = {
@@ -4392,6 +4406,11 @@ export type RouteDetailsLegSectionFeaturePointPropertiestotal_cargo_weightArgs =
   unit?: Maybe<WeightUnit>;
 };
 
+export type RouteDetailsLegSectionTraffic = {
+  /** [BETA] Traffic congestion intervals mapped to the polyline indices of the leg's section. */
+  congestions: Array<TrafficCongestionInterval>;
+};
+
 /** Type of a route details leg section. */
 export enum RouteDetailsLegSectionType {
   DRIVING = "driving",
@@ -4408,6 +4427,11 @@ export type RouteDetailsLegStation = {
   connector_id: Scalars["ID"];
 };
 
+export type RouteDetailsLegTraffic = {
+  /** [BETA] Traffic congestion intervals mapped to the polyline indices of the leg. */
+  congestions: Array<TrafficCongestionInterval>;
+};
+
 /** Type of a leg. */
 export enum RouteDetailsLegType {
   /** This leg ends at a charging station and the vehicle must recharge. */
@@ -4424,6 +4448,27 @@ export enum RouteDetailsLegType {
   FINAL = "final"
 }
 
+export type RouteDetailsLegWarning = {
+  /** The code of the warning. */
+  code: RouteDetailsLegWarningCode;
+};
+
+/** Types of warnings that can be encountered in a route leg. */
+export enum RouteDetailsLegWarningCode {
+  /** The via location cannot be reached by vehicle. */
+  VIA_NOT_VEHICLE_ACCESSIBLE = "via_not_vehicle_accessible",
+  /** The leg could not use stations from the preferred operator(s). */
+  OPERATORS_PREFERRED_NOT_AVAILABLE = "operators_preferred_not_available",
+  /** Vehicle's load may exceed the maximum supported weight of the vehicle. */
+  MAXIMUM_WEIGHT_EXCEEDED = "maximum_weight_exceeded",
+  /** The leg includes sections requested to be avoided. */
+  SEGMENT_UNAVOIDABLE = "segment_unavoidable",
+  /** The charging station used in the leg has limited opening hours. */
+  STATION_LIMITED_OPEN_HOURS = "station_limited_open_hours",
+  /** The specified stop duration at the via charging station is insufficient to start a charging session. */
+  VIA_INSUFFICIENT_CHARGING_TIME = "via_insufficient_charging_time"
+}
+
 export type RouteDetailsManeuver = {
   /** Type of instruction. */
   type: RouteDetailsLegManeuverType;
@@ -4524,6 +4569,13 @@ export enum RouteDetailsTag {
   CROSSBORDER = "crossborder"
 }
 
+export type RouteDetailsTraffic = {
+  /** [BETA] Additional driving duration, in seconds, caused by traffic congestion compared to free-flow conditions. This value is already included in route total and driving durations. */
+  delay: Scalars["Int"];
+  /** [BETA] Traffic congestion intervals mapped to the polyline indices of the leg. */
+  congestions: Array<Maybe<TrafficCongestionInterval>>;
+};
+
 export type RouteDrivingPreferences = {
   /** [BETA] Factor to adjust the route's calculated average speed. Accepts values between 0.80 and 1.20. 1.0 is neutral. Values below 1.0 reduce speed (e.g. 0.95 is -5%), values above increase it. If provided in combination with style, this overrides the speed factor implied by the selected 'style'. */
   speed_factor?: Maybe<Scalars["Float"]>;
@@ -5352,7 +5404,7 @@ export type RouteOperatorPreferencesRanking = {
 };
 
 export type RouteOperatorPreferencesRankingInput = {
-  /** Ranking enforcement type: preferred (applies ranking levels), required (routes only via ranked operators), or none (no ranking applied). */
+  /** Determines how operator preferences are applied to stations during route calculation. If no ranking is provided through 'levels' or project settings, no operator preference is applied. */
   type: RouteOperatorsType;
   /** Priority levels for operator ranking. If not specified, applies the specified enforcement type to the project-configured operator ranking. */
   levels?: Maybe<RouteOperatorPreferencesRankingLevelsInput>;
@@ -6017,6 +6069,31 @@ export type RouteViaPropertiesInput = {
   station?: Maybe<RoutePropertiesStationInput>;
 };
 
+export type RouteWarning = {
+  /** The code of the warning. */
+  code: RouteWarningCode;
+};
+
+/** Types of warnings that can be encountered in a route. */
+export enum RouteWarningCode {
+  /** The selected vehicle model is unavailable on one or more regions along the route. */
+  EV_UNAVAILABLE_IN_REGION = "ev_unavailable_in_region",
+  /** Route excludes charging stations as a hybrid vehicle does not require external charging. */
+  HEV_NO_CHARGING_STATIONS = "hev_no_charging_stations",
+  /** Route is calculated using only the battery range of the extended-range vehicle.  */
+  EREV_BATTERY_ONLY_RANGE = "erev_battery_only_range",
+  /** The origin location cannot be reached by vehicle and requires a walking section to reach the point. */
+  ORIGIN_NOT_VEHICLE_ACCESSIBLE = "origin_not_vehicle_accessible",
+  /** The destination location cannot be reached by vehicle and requires a walking section to reach the point. */
+  DESTINATION_NOT_VEHICLE_ACCESSIBLE = "destination_not_vehicle_accessible",
+  /** The requested final state of charge cannot be achieved. */
+  FINAL_SOC_NOT_POSSIBLE = "final_soc_not_possible",
+  /** The set maximum speed is too low (below 50 km/h) and may result in an inefficient route. */
+  LOW_SPEED = "low_speed",
+  /** Operator preferences were ignored because they have not been configured for this project nor provided in the route create request. */
+  OPERATOR_PREFERENCES_NOT_FOUND = "operator_preferences_not_found"
+}
+
 export type RouteWeather = {
   /** Weather configuration applied to the route. */
   type: WeatherType;
@@ -6207,18 +6284,8 @@ export type Station = {
   properties?: Maybe<Scalars["JSON"]>;
   /** A flag that indicates if a station has real-time information about the availability of its connectors. */
   realtime?: Maybe<Scalars["Boolean"]>;
-  /**
-   * A flag that indicates if a station is on private property.
-   * @deprecated In favor of access_type.
-   */
-  private?: Maybe<Scalars["Boolean"]>;
   /** Connectors grouped by power. */
   power?: Maybe<Scalars["JSON"]>;
-  /**
-   * Station availability.
-   * @deprecated predicted_availability, no value will be sent. Deprecated in favor of predicted_occupancy.
-   */
-  predicted_availability?: Maybe<Array<Maybe<StationPredictedAvailability>>>;
   /** Predicted station occupancy. */
   predicted_occupancy?: Maybe<Array<Maybe<StationPredictedOccupancy>>>;
   /** Charging speed for a station. */
@@ -6311,41 +6378,11 @@ export type StationAroundQuery = {
 };
 
 export type StationCustomProperties = {
-  /**
-   * List of eMSP cards accepted at a charging station.
-   * @deprecated In favor of station.roaming.
-   */
-  roaming?: Maybe<Array<Maybe<StationRoaming>>>;
-  /**
-   * Phone number for assistance at a charging station.
-   * @deprecated In favor of station.support_phone_number.
-   */
-  support_phone_number?: Maybe<Scalars["String"]>;
-  /**
-   * Charging behavior of a station.
-   * @deprecated In favor of station.charging_behaviour.
-   */
-  charging_behaviour?: Maybe<ChargingBehaviour>;
   /**
    * Shows how reliable a charging station is (1 to 5; 1 = unreliable, 5 = reliable), taking into account the charging behaviour history and error values.
    * @deprecated In favor of station.reliability_score.
    */
   reliability_score?: Maybe<Scalars["Int"]>;
-  /**
-   * List of available ad hoc payment methods.
-   * @deprecated In favor of station.adhoc_authorisation_payment_method.
-   */
-  adhoc_authorisation_method?: Maybe<Array<Maybe<AdhocAuthorisationMethod>>>;
-  /**
-   * Predicted station occupancy.
-   * @deprecated In favor of station.predicted_occupancy.
-   */
-  predicted_occupancy?: Maybe<Array<Maybe<StationPredictedOccupancy>>>;
-  /**
-   * Type of access to the charging station.
-   * @deprecated In favor of station.access_type.
-   */
-  access_type?: Maybe<AccessType>;
   /** Custom station properties for OICP databases such as the global Hubject database. Station databases that not follow the OICP standard return null values. */
   oicp?: Maybe<OICPStationCustomProperties>;
 };
@@ -6797,6 +6834,15 @@ export type TotalOccupantWeightInput = {
   source?: Maybe<TelemetryInputSource>;
 };
 
+export type TrafficCongestionInterval = {
+  /** Starting index of this interval in the polyline. */
+  start_index: Scalars["Int"];
+  /** Ending index of this interval in the polyline. */
+  end_index: Scalars["Int"];
+  /** Congestion level for this specific interval. */
+  level: CongestionLevel;
+};
+
 export enum TurningCircleUnit {
   /** Return the turning circle in meters. */
   METER = "meter",
@@ -7327,11 +7373,6 @@ export type VehiclePremium = {
   body: VehiclePremiumBody;
   /** Availability of the vehicle. */
   availability: VehiclePremiumAvailability;
-  /**
-   * Pricing of the vehicle.
-   * @deprecated In favor of pricing.
-   */
-  price: VehiclePremiumPrice;
   /** Starting price in the currency defined in the field argument. If not defined, it will return the starting price in the currency returned in the currency field. */
   pricing: VehiclePremiumPriceValueWithGrant;
   /** Drivetrain of the vehicle. */
@@ -7433,11 +7474,6 @@ export type VehiclePremiumBody = {
   weight_is_estimated?: Maybe<Scalars["Boolean"]>;
   /** Maximum payload allowed for the vehicle. */
   weight_max_payload?: Maybe<Scalars["Float"]>;
-  /**
-   * Gross Vehicle Weight (GVWR) - (max allowed vehicle weight with payload).
-   * @deprecated In favor of weight_gvwr.nominal
-   */
-  max_gross_vehicle_weight?: Maybe<Scalars["Float"]>;
   /** Standard luggage capacity. */
   boot_capacity?: Maybe<Scalars["Float"]>;
   /** Storage capacity of front trunk/under the hood (frunk). */
@@ -7500,10 +7536,6 @@ export type VehiclePremiumBodyweight_max_payloadArgs = {
   unit?: Maybe<WeightUnit>;
 };
 
-export type VehiclePremiumBodymax_gross_vehicle_weightArgs = {
-  unit?: Maybe<WeightUnit>;
-};
-
 export type VehiclePremiumBodyboot_capacityArgs = {
   unit?: Maybe<VolumeUnit>;
 };
@@ -8090,42 +8122,12 @@ export type VehiclePremiumRoutingfuel_consumptionArgs = {
 export type VehiclePremiumRoutingConsumption = {
   /** The amount of energy, in kWh, used by the auxiliary systems of the vehicle in an hour, like media box, etc */
   auxiliary?: Maybe<Scalars["Float"]>;
-  /**
-   * Consumption, in kWh, of the auxiliaries.
-   * @deprecated In favor of auxiliary
-   */
-  aux?: Maybe<VehiclePremiumRoutingConsumptionValue>;
-  /**
-   * Consumption, in kWh, of the battery management system.
-   * @deprecated In favor of auxiliary
-   */
-  bms?: Maybe<VehiclePremiumRoutingConsumptionValue>;
-  /**
-   * Consumption, in kWh, of the vehicle in idle mode.
-   * @deprecated In favor of auxiliary
-   */
-  idle?: Maybe<VehiclePremiumRoutingConsumptionValue>;
 };
 
 export type VehiclePremiumRoutingConsumptionauxiliaryArgs = {
   unit?: Maybe<AuxiliaryConsumptionUnit>;
 };
 
-export type VehiclePremiumRoutingConsumptionValue = {
-  /** Best (lowest) consumption in summer. */
-  best?: Maybe<Scalars["Float"]>;
-  /** Best (lowest) consumption in winter. */
-  worst?: Maybe<Scalars["Float"]>;
-};
-
-export type VehiclePremiumRoutingConsumptionValuebestArgs = {
-  unit?: Maybe<ConsumptionUnit>;
-};
-
-export type VehiclePremiumRoutingConsumptionValueworstArgs = {
-  unit?: Maybe<ConsumptionUnit>;
-};
-
 export type VehiclePremiumSafety = {
   /** Number of seats equipped with ISOFIX. */
   isofix_seats?: Maybe<Scalars["Int"]>;