tesla-fleet-api 0.3.0 → 0.4.0

package/dist/exceptions.d.mts

@@ -0,0 +1,1142 @@
+/**
+ * Every error this library raises, ported class-for-class from
+ * `python-tesla-fleet-api`'s `exceptions.py` so a Python caller's
+ * `except X` maps one-to-one onto a JavaScript `instanceof X`.
+ *
+ * Each class carries its Python class attributes (`message`, `status`,
+ * `key`, `code`) as static fields, and every instance copies them, so both
+ * `err.status` and `InvalidCommand.key` work.
+ */
+/** The body or detail attached to an error: decoded JSON, raw text, or nothing. */
+export type TeslaFleetErrorData = Record<string, unknown> | string | null;
+/**
+ * Base class for all Tesla exceptions.
+ */
+export declare class TeslaFleetError extends Error {
+  static readonly message: string;
+  static readonly status: number | null;
+  static readonly key: string | null;
+  static readonly code: number | null;
+  readonly data: TeslaFleetErrorData;
+  readonly status: number | null;
+  readonly key: string | null;
+  readonly code: number | null;
+  constructor(data?: TeslaFleetErrorData, status?: number | null, options?: ErrorOptions);
+}
+/**
+ * A request to the API could not be completed: `fetch` rejected (DNS,
+ * refused connection, TLS, reset) or the request timed out. The underlying
+ * error is kept as `cause`.
+ */
+export declare class TeslaFleetConnectionError extends TeslaFleetError {
+  static readonly message: string;
+}
+/**
+ * A cloud REST call was made on a vehicle that is only reachable over Bluetooth.
+ */
+export declare class BluetoothCloudUnavailableError extends TeslaFleetError {
+  static readonly message: string;
+}
+/**
+ * Bluetooth command timed out waiting for vehicle response.
+ */
+export declare class BluetoothTimeout extends TeslaFleetError {
+  static readonly message: string;
+}
+/**
+ * A mutating Bluetooth command has an unresolved outcome.
+ *
+ * The write either completed and its ack was lost, or it entered backend I/O
+ * and then failed/timed out in a way that cannot prove whether the vehicle
+ * received it. It can also have acknowledged the request without a required
+ * physical state check confirming completion. The vehicle may have executed
+ * the command - lock/unlock have both been observed to execute despite this
+ * error. Treat the outcome as unknown, not failed: verify by reading state
+ * back when possible, and never blind-retry or re-issue the same command on
+ * another transport, since it may already have run.
+ *
+ * Extends `BluetoothTimeout` so existing `instanceof BluetoothTimeout`
+ * handling still catches it, while remaining distinguishable from it (and
+ * from `BluetoothTransportError`, the provable pre-submission transport
+ * failure) via `unconfirmed` - e.g. a BLE-primary/cloud-fallback router should
+ * not fail over on this error, since failing over risks double-executing the
+ * command.
+ */
+export declare class BluetoothUnconfirmedCommand extends BluetoothTimeout {
+  static readonly message: string;
+  readonly unconfirmed = true;
+}
+/**
+ * A mutating Bluetooth command was proven NOT to have taken effect.
+ *
+ * Unlike `BluetoothUnconfirmedCommand` (ack lost, outcome unknown), this
+ * means a state check - a `confirmation="verify"` post-timeout read, or
+ * the vehicle's own status broadcast still showing a different value once
+ * the whole confirmation window elapsed - actively contradicted the
+ * requested end state. That makes it safe to fail over: a router replaying the
+ * command on a fallback transport is not at risk of double-executing an
+ * already-applied command, because this one demonstrably did not apply.
+ * Deliberately does NOT subclass `BluetoothTimeout`/
+ * `BluetoothUnconfirmedCommand` so a fallback router's per-command
+ * failover (which only special-cases the ambiguous case) treats it like any
+ * other ordinary failure and tries the next backend.
+ */
+export declare class BluetoothCommandFailed extends TeslaFleetError {
+  static readonly message: string;
+}
+/**
+ * The Bluetooth transport failed provably before the write reached the vehicle.
+ *
+ * Covers connect, notify-subscribe, and GATT characteristic-resolution
+ * failures - all raised by the local BLE stack before any bytes go out over
+ * the air, so a fallback router can safely retry the same command
+ * elsewhere. A GATT write that entered backend I/O and then failed or timed
+ * out is delivery-ambiguous instead (the write may have reached the
+ * vehicle) and raises `BluetoothTimeout`/`BluetoothUnconfirmedCommand`,
+ * not this class - see those exceptions.
+ */
+export declare class BluetoothTransportError extends TeslaFleetError {
+  static readonly message: string;
+}
+/**
+ * The response from the server was not JSON.
+ */
+export declare class ResponseError extends TeslaFleetError {
+  static readonly message: string;
+}
+/**
+ * The data request or command is unknown.
+ */
+export declare class InvalidCommand extends TeslaFleetError {
+  static readonly message: string;
+  static readonly status: number;
+  static readonly key: string;
+}
+/**
+ * A field in the input is not valid.
+ */
+export declare class InvalidField extends TeslaFleetError {
+  static readonly message: string;
+  static readonly status: number;
+  static readonly key: string;
+}
+/**
+ * The request body is not valid, a description giving a more specific error message may be returned.
+ */
+export declare class InvalidRequest extends TeslaFleetError {
+  static readonly message: string;
+  static readonly status: number;
+  static readonly key: string;
+}
+/**
+ * The "code" in request body is invalid, generate a new one and try again.
+ */
+export declare class InvalidAuthCode extends TeslaFleetError {
+  static readonly message: string;
+  static readonly status: number;
+  static readonly key: string;
+}
+/**
+ * Invalid redirect URI/URL. The authorize redirect URI and token redirect URI must match.
+ */
+export declare class InvalidRedirectUrl extends TeslaFleetError {
+  static readonly message: string;
+  static readonly status: number;
+  static readonly key: string;
+}
+/**
+ * We don't recognize this client_id and client_secret combination. Use the client_id and client_secret that has been granted for the application.
+ */
+export declare class UnauthorizedClient extends TeslaFleetError {
+  static readonly message: string;
+  static readonly status: number;
+  static readonly key: string;
+}
+/**
+ * The vehicle has turned off remote access.
+ */
+export declare class MobileAccessDisabled extends TeslaFleetError {
+  static readonly message: string;
+  static readonly status: number;
+  static readonly key: string;
+}
+/**
+ * Third party specific error when no access token is provided.
+ */
+export declare class MissingToken extends TeslaFleetError {
+  static readonly message: string;
+  static readonly status: number;
+}
+/**
+ * Teslemetry specific error when no access token is provided.
+ */
+export declare class MissingTeslemetryToken extends MissingToken {
+  static readonly key: string;
+}
+/**
+ * Tessie specific error when no access token is provided.
+ */
+export declare class MissingTessieToken extends MissingToken {
+  static readonly key: string;
+}
+/**
+ * Third party specific error for invalid access token.
+ */
+export declare class InvalidToken extends TeslaFleetError {
+  static readonly message: string;
+  static readonly status: number;
+}
+/**
+ * Teslemetry specific error for invalid access token.
+ */
+export declare class InvalidTeslemetryToken extends InvalidToken {
+  static readonly key: string;
+}
+/**
+ * Tessie specific error for invalid access token.
+ */
+export declare class InvalidTessieToken extends InvalidToken {
+  static readonly key: string;
+}
+/**
+ * The OAuth token is invalid.
+ */
+export declare class OAuthInvalid extends TeslaFleetError {
+  static readonly message: string;
+  static readonly status: number;
+  static readonly key: string;
+}
+/**
+ * The OAuth token has expired.
+ */
+export declare class OAuthExpired extends TeslaFleetError {
+  static readonly message: string;
+  static readonly status: number;
+  static readonly key: string;
+}
+/**
+ * Teslemetry OAuth dynamic client registration (RFC 7591) failed.
+ *
+ * Covers a transport/timeout failure reaching the registration endpoint, a
+ * non-2xx response, a response body that isn't valid JSON, and a
+ * well-formed response missing a usable `client_id`. The specific reason
+ * is carried in `data`.
+ */
+export declare class TeslemetryRegistrationError extends TeslaFleetError {
+  static readonly message: string;
+}
+/**
+ * The user has reset their password and a new auth code is required, or the refresh_token has already been used.
+ */
+export declare class LoginRequired extends TeslaFleetError {
+  static readonly message: string;
+  static readonly status: number;
+  static readonly key: string;
+}
+/**
+ * Payment is required in order to use the API (non-free account only).
+ */
+export declare class PaymentRequired extends TeslaFleetError {
+  static readonly message: string;
+  static readonly status: number;
+}
+/**
+ * Subscription is required in order to use Teslemetry.
+ */
+export declare class SubscriptionRequired extends TeslaFleetError {
+  static readonly message: string;
+  static readonly status: number;
+  static readonly key: string;
+}
+/**
+ * Subscription is required in order to use Teslemetry.
+ */
+export declare class VehicleSubscriptionRequired extends TeslaFleetError {
+  static readonly message: string;
+  static readonly status: number;
+  static readonly key: string;
+}
+/**
+ * Account has insufficient credits to make this request.
+ */
+export declare class InsufficientCredits extends TeslaFleetError {
+  static readonly message: string;
+  static readonly status: number;
+  static readonly key: string;
+}
+/**
+ * Access to this resource is not authorized, developers should check required Scope.
+ */
+export declare class Forbidden extends TeslaFleetError {
+  static readonly message: string;
+  static readonly status: number;
+  static readonly key: string;
+}
+/**
+ * The requested scopes are not granted.
+ */
+export declare class InvalidScope extends TeslaFleetError {
+  static readonly message: string;
+  static readonly status: number;
+  static readonly key: string;
+}
+/**
+ * The vehicle is unsupported.
+ */
+export declare class UnsupportedVehicle extends TeslaFleetError {
+  static readonly message: string;
+  static readonly status: number;
+  static readonly key: string;
+}
+/**
+ * The requested resource does not exist.
+ */
+export declare class NotFound extends TeslaFleetError {
+  static readonly message: string;
+  static readonly status: number;
+}
+/**
+ * The HTTP method is not allowed.
+ */
+export declare class InvalidMethod extends TeslaFleetError {
+  static readonly message: string;
+  static readonly status: number;
+  static readonly key: string;
+}
+/**
+ * The operation is not allowed.
+ */
+export declare class NotAllowed extends TeslaFleetError {
+  static readonly message: string;
+  static readonly status: number;
+}
+/**
+ * The HTTP request does not have a Content-Type header set to application/json.
+ */
+export declare class NotAcceptable extends TeslaFleetError {
+  static readonly message: string;
+  static readonly status: number;
+}
+/**
+ * The vehicle is not "online.
+ */
+export declare class VehicleOffline extends TeslaFleetError {
+  static readonly message: string;
+  static readonly status: number;
+}
+/**
+ * A condition has not been met to process the request.
+ */
+export declare class PreconditionFailed extends TeslaFleetError {
+  static readonly message: string;
+  static readonly status: number;
+}
+/**
+ * This user is not present in the current region.
+ */
+export declare class InvalidRegion extends TeslaFleetError {
+  static readonly message: string;
+  static readonly status: number;
+}
+/**
+ * There is a semantic problem with the data, e.g. missing or invalid data.
+ */
+export declare class InvalidResource extends TeslaFleetError {
+  static readonly message: string;
+  static readonly status: number;
+}
+/**
+ * Account is locked, and must be unlocked by Tesla.
+ */
+export declare class Locked extends TeslaFleetError {
+  static readonly message: string;
+  static readonly status: number;
+}
+/**
+ * The response from Tesla was invalid.
+ */
+export declare class InvalidResponse extends TeslaFleetError {
+  static readonly message: string;
+  static readonly status: number;
+}
+/**
+ * Account or server is rate limited.
+ */
+export declare class RateLimited extends TeslaFleetError {
+  static readonly message: string;
+  static readonly status: number;
+}
+/**
+ * Querying for a user/vehicle without proper privacy settings.
+ */
+export declare class ResourceUnavailableForLegalReasons extends TeslaFleetError {
+  static readonly message: string;
+  static readonly status: number;
+}
+/**
+ * Client has closed the request before the server could send a response.
+ */
+export declare class ClientClosedRequest extends TeslaFleetError {
+  static readonly message: string;
+  static readonly status: number;
+}
+/**
+ * An error occurred while processing the request.
+ */
+export declare class InternalServerError extends TeslaFleetError {
+  static readonly message: string;
+  static readonly status: number;
+}
+/**
+ * The server, acting as a gateway, received an invalid response from an upstream server.
+ */
+export declare class BadGateway extends TeslaFleetError {
+  static readonly message: string;
+  static readonly status: number;
+}
+/**
+ * The energy gateway is unreachable.
+ */
+export declare class EnergyGatewayUnreachable extends BadGateway {
+  static readonly message: string;
+  static readonly key: string;
+}
+/**
+ * Either an internal service or a vehicle did not respond (timeout).
+ */
+export declare class ServiceUnavailable extends TeslaFleetError {
+  static readonly message: string;
+  static readonly status: number;
+}
+/**
+ * Server did not receive a response.
+ */
+export declare class GatewayTimeout extends TeslaFleetError {
+  static readonly message: string;
+  static readonly status: number;
+}
+/**
+ * Vehicle responded with an error - might need a reboot, OTA update, or service.
+ */
+export declare class DeviceUnexpectedResponse extends TeslaFleetError {
+  static readonly message: string;
+  static readonly status: number;
+}
+/**
+ * Errors related to this library.
+ */
+export declare class LibraryError extends Error {
+  constructor(message?: string, options?: ErrorOptions);
+}
+/**
+ * A signed operation was attempted on a vehicle constructed with signing
+ * explicitly disabled.
+ */
+export declare class SigningDisabled extends LibraryError {
+  constructor();
+}
+/**
+ * An existing private key file could not be loaded as a usable key.
+ *
+ * `reason` is one of `"unreadable"` (I/O failure), `"malformed"` (not valid
+ * PEM), `"encrypted"` (PEM requires a passphrase), or `"wrong_type"` (loaded
+ * key is not the expected type). A local key-file failure, not an upstream
+ * Fleet API error, so this extends `LibraryError` rather than
+ * `TeslaFleetError`.
+ */
+export declare class PrivateKeyError extends LibraryError {
+  readonly reason: string;
+  constructor(reason: string, message: string, options?: ErrorOptions);
+}
+/**
+ * The requested action requires a signed command; the unsigned cloud API cannot actuate it.
+ *
+ * Energy gateways have been observed acknowledging this class of unsigned
+ * `grpc_command` without physically operating the grid contactor - see
+ * `EnergySite.set_island_mode`. Pair an RSA key with
+ * `EnergySite.add_authorized_client`, then either build the energy site
+ * with that `private_key` and its `din` to sign it through the cloud, or
+ * issue it through a signed local LAN backend (composed via
+ * `EnergySiteRouter`).
+ */
+export declare class SignedCommandRequired extends TeslaFleetError {
+  static readonly message: string;
+}
+/**
+ * An energy gateway's presence-proof window expired before verification.
+ *
+ * The gateway itself reported the terminal `PENDING_VERIFICATION_TIMEOUT`
+ * state (`AuthorizedClientState`) - the ~9-minute window to confirm the
+ * key (typically via a physical breaker/switch toggle) closed with no
+ * confirmation. The registration is dead; re-register the *same* public
+ * key with `add_authorized_client` to reset the window and retry, rather
+ * than generating a new key.
+ */
+export declare class AuthorizedClientPairingTimedOut extends TeslaFleetError {
+  static readonly message: string;
+}
+/**
+ * `wait_until_paired()`'s own bounded overall wait elapsed.
+ *
+ * Distinct from `AuthorizedClientPairingTimedOut`: the gateway had not
+ * reported a terminal state (the registration may still be alive, e.g.
+ * still `PENDING_VERIFICATION`, or the local `verify_by_use` check
+ * kept failing) when the caller's `timeout` ran out. Retry by calling
+ * `wait_until_paired()` again.
+ */
+export declare class AuthorizedClientWaitExpired extends TeslaFleetError {
+  static readonly message: string;
+}
+/**
+ * A `session_info` reply failed local authentication and was discarded.
+ *
+ * Raised when the reply's `session_info_tag` HMAC does not verify, is
+ * absent, the echoed `request_uuid` does not match the outstanding
+ * request it claims to answer, or its clock time regresses within the same
+ * epoch. Also raised when the reply carries an empty `publicKey` (so no
+ * shared key can be derived to verify a tag) with a status other than
+ * `SESSION_INFO_STATUS_KEY_NOT_ON_WHITELIST`, which raises
+ * `NotOnWhitelistFault` instead. The session's prior state is left
+ * unmodified.
+ */
+export declare class SessionInfoAuthenticationFault extends TeslaFleetError {
+  static readonly message: string;
+}
+/**
+ * A signed command response reused a counter value already seen on this session.
+ *
+ * protocol.md requires rejecting a response whose counter has previously
+ * been used, to prevent an attacker from replaying a captured encrypted
+ * response back at the client.
+ */
+export declare class SignedCommandResponseReplayed extends TeslaFleetError {
+  static readonly message: string;
+}
+/**
+ * Vehicle has responded with an error when sending a signed command
+ */
+export declare class TeslaFleetInformationFault extends TeslaFleetError {
+  static readonly message: string;
+}
+/**
+ * Unknown fault on signed command.
+ */
+export declare class UnknownFault extends TeslaFleetInformationFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Not on whitelist fault on signed command.
+ */
+export declare class NotOnWhitelistFault extends TeslaFleetInformationFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * IV smaller than expected fault on signed command.
+ */
+export declare class IVSmallerThanExpectedFault extends TeslaFleetInformationFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Invalid token fault on signed command.
+ */
+export declare class InvalidTokenFault extends TeslaFleetInformationFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Token and counter invalid fault on signed command.
+ */
+export declare class TokenAndCounterInvalidFault extends TeslaFleetInformationFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * AES decrypt auth fault on signed command.
+ */
+export declare class AESDecryptAuthFault extends TeslaFleetInformationFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * ECDSA input fault on signed command.
+ */
+export declare class ECDSAInputFault extends TeslaFleetInformationFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * ECDSA signature fault on signed command.
+ */
+export declare class ECDSASignatureFault extends TeslaFleetInformationFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Local entity start fault on signed command.
+ */
+export declare class LocalEntityStartFault extends TeslaFleetInformationFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Local entity result fault on signed command.
+ */
+export declare class LocalEntityResultFault extends TeslaFleetInformationFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Could not retrieve key fault on signed command.
+ */
+export declare class CouldNotRetrieveKeyFault extends TeslaFleetInformationFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Could not retrieve token fault on signed command.
+ */
+export declare class CouldNotRetrieveTokenFault extends TeslaFleetInformationFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Signature too short fault on signed command.
+ */
+export declare class SignatureTooShortFault extends TeslaFleetInformationFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Token is incorrect length fault on signed command.
+ */
+export declare class TokenIsIncorrectLengthFault extends TeslaFleetInformationFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Incorrect epoch fault on signed command.
+ */
+export declare class IncorrectEpochFault extends TeslaFleetInformationFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * IV incorrect length fault on signed command.
+ */
+export declare class IVIncorrectLengthFault extends TeslaFleetInformationFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Time expired fault on signed command.
+ */
+export declare class TimeExpiredFault extends TeslaFleetInformationFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Not provisioned with identity fault on signed command.
+ */
+export declare class NotProvisionedWithIdentityFault extends TeslaFleetInformationFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Could not hash metadata fault on signed command.
+ */
+export declare class CouldNotHashMetadataFault extends TeslaFleetInformationFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Vehicle has responded with an error when sending a signed command
+ */
+export declare class TeslaFleetMessageFault extends TeslaFleetError {
+  static readonly message: string;
+}
+/**
+ * Required vehicle subsystem is busy. Try again
+ */
+export declare class TeslaFleetMessageFaultBusy extends TeslaFleetMessageFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Vehicle subsystem did not respond. Try again
+ */
+export declare class TeslaFleetMessageFaultTimeout extends TeslaFleetMessageFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Vehicle did not recognize the key used to authorize command. Make sure your key is paired with the vehicle
+ */
+export declare class TeslaFleetMessageFaultUnknownKeyId extends TeslaFleetMessageFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Key used to authorize command has been disabled
+ */
+export declare class TeslaFleetMessageFaultInactiveKey extends TeslaFleetMessageFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Command signature/MAC is incorrect. Use included session info to update session and try again
+ */
+export declare class TeslaFleetMessageFaultInvalidSignature extends TeslaFleetMessageFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Command anti-replay counter has been used before. Use included session info to update session and try again
+ */
+export declare class TeslaFleetMessageFaultInvalidTokenOrCounter extends TeslaFleetMessageFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * User is not authorized to execute command. This can be because of the role or because of vehicle state
+ */
+export declare class TeslaFleetMessageFaultInsufficientPrivileges extends TeslaFleetMessageFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Command was malformed or addressed to an unrecognized vehicle system. May indicate client error or older vehicle firmware
+ */
+export declare class TeslaFleetMessageFaultInvalidDomains extends TeslaFleetMessageFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Unrecognized command. May indicate client error or unsupported vehicle firmware
+ */
+export declare class TeslaFleetMessageFaultInvalidCommand extends TeslaFleetMessageFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Could not parse command. Indicates client error
+ */
+export declare class TeslaFleetMessageFaultDecoding extends TeslaFleetMessageFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Internal vehicle error. Try again. Most commonly encountered when the vehicle has not finished booting
+ */
+export declare class TeslaFleetMessageFaultInternal extends TeslaFleetMessageFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Command sent to wrong VIN
+ */
+export declare class TeslaFleetMessageFaultWrongPersonalization extends TeslaFleetMessageFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Command was malformed or used a deprecated parameter
+ */
+export declare class TeslaFleetMessageFaultBadParameter extends TeslaFleetMessageFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Vehicle's keychain is full. You must delete a key before you can add another
+ */
+export declare class TeslaFleetMessageFaultKeychainIsFull extends TeslaFleetMessageFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Session ID mismatch. Use included session info to update session and try again
+ */
+export declare class TeslaFleetMessageFaultIncorrectEpoch extends TeslaFleetMessageFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Initialization Value length is incorrect (AES-GCM must use 12-byte IVs). Indicates a client programming error
+ */
+export declare class TeslaFleetMessageFaultIVIncorrectLength extends TeslaFleetMessageFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Command expired. Use included session info to determine if clocks have desynchronized and try again
+ */
+export declare class TeslaFleetMessageFaultTimeExpired extends TeslaFleetMessageFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Vehicle has not been provisioned with a VIN and may require service
+ */
+export declare class TeslaFleetMessageFaultNotProvisionedWithIdentity extends TeslaFleetMessageFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Internal vehicle error
+ */
+export declare class TeslaFleetMessageFaultCouldNotHashMetadata extends TeslaFleetMessageFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Vehicle rejected command because its expiration time was too far in the future. This is a security precaution
+ */
+export declare class TeslaFleetMessageFaultTimeToLiveTooLong extends TeslaFleetMessageFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * The vehicle owner has disabled Mobile access
+ */
+export declare class TeslaFleetMessageFaultRemoteAccessDisabled extends TeslaFleetMessageFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * The command was authorized with a Service key, but the vehicle has not been configured to permit remote service commands
+ */
+export declare class TeslaFleetMessageFaultRemoteServiceAccessDisabled extends TeslaFleetMessageFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * The command requires proof of Tesla account credentials but was not sent over a channel that provides this proof. Resend the command using Fleet API
+ */
+export declare class TeslaFleetMessageFaultCommandRequiresAccountCredentials extends TeslaFleetMessageFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Client sent a request with a field that exceeds MTU
+ */
+export declare class TeslaFleetMessageFaultFieldExceedsMTU extends TeslaFleetMessageFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Client's request was received, but response size exceeded MTU
+ */
+export declare class TeslaFleetMessageFaultResponseSizeExceedsMTU extends TeslaFleetMessageFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * The vehicle has seen this counter value before. Reset the counter and try again
+ */
+export declare class TeslaFleetMessageFaultRepeatedCounter extends TeslaFleetMessageFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * The key handle is not valid. The key may have been revoked or expired
+ */
+export declare class TeslaFleetMessageFaultInvalidKeyHandle extends TeslaFleetMessageFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * The response requires encryption but encryption was not requested
+ */
+export declare class TeslaFleetMessageFaultRequiresResponseEncryption extends TeslaFleetMessageFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Vehicle has responded with an error when sending a signed command
+ */
+export declare class SignedMessageInformationFault extends TeslaFleetError {
+  static readonly message: string;
+}
+/**
+ * Unknown fault on signed command.
+ */
+export declare class SignedMessageInformationFaultUnknown extends SignedMessageInformationFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Not on whitelist fault on signed command.
+ */
+export declare class SignedMessageInformationFaultNotOnWhitelist extends SignedMessageInformationFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * IV smaller than expected fault on signed command.
+ */
+export declare class SignedMessageInformationFaultIVSmallerThanExpected extends SignedMessageInformationFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Invalid token fault on signed command.
+ */
+export declare class SignedMessageInformationFaultInvalidToken extends SignedMessageInformationFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Token and counter invalid fault on signed command.
+ */
+export declare class SignedMessageInformationFaultTokenAndCounterInvalid extends SignedMessageInformationFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * AES decrypt auth fault on signed command.
+ */
+export declare class SignedMessageInformationFaultAESDecryptAuth extends SignedMessageInformationFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * ECDSA input fault on signed command.
+ */
+export declare class SignedMessageInformationFaultECDSAInput extends SignedMessageInformationFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * ECDSA signature fault on signed command.
+ */
+export declare class SignedMessageInformationFaultECDSASignature extends SignedMessageInformationFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Local entity start fault on signed command.
+ */
+export declare class SignedMessageInformationFaultLocalEntityStart extends SignedMessageInformationFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Local entity result fault on signed command.
+ */
+export declare class SignedMessageInformationFaultLocalEntityResult extends SignedMessageInformationFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Could not retrieve key fault on signed command.
+ */
+export declare class SignedMessageInformationFaultCouldNotRetrieveKey extends SignedMessageInformationFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Could not retrieve token fault on signed command.
+ */
+export declare class SignedMessageInformationFaultCouldNotRetrieveToken extends SignedMessageInformationFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Signature too short fault on signed command.
+ */
+export declare class SignedMessageInformationFaultSignatureTooShort extends SignedMessageInformationFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Token is incorrect length fault on signed command.
+ */
+export declare class SignedMessageInformationFaultTokenIsIncorrectLength extends SignedMessageInformationFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Incorrect epoch fault on signed command.
+ */
+export declare class SignedMessageInformationFaultIncorrectEpoch extends SignedMessageInformationFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * IV incorrect length fault on signed command.
+ */
+export declare class SignedMessageInformationFaultIVIncorrectLength extends SignedMessageInformationFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Time expired fault on signed command.
+ */
+export declare class SignedMessageInformationFaultTimeExpired extends SignedMessageInformationFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Not provisioned with identity fault on signed command.
+ */
+export declare class SignedMessageInformationFaultNotProvisionedWithIdentity extends SignedMessageInformationFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+/**
+ * Could not hash metadata fault on signed command.
+ */
+export declare class SignedMessageInformationFaultCouldNotHashMetadata extends SignedMessageInformationFault {
+  static readonly message: string;
+  static readonly code: number;
+}
+export declare class WhitelistOperationStatus extends TeslaFleetError {
+  static readonly message: string;
+}
+export declare class WhitelistOperationUndocumentedError extends WhitelistOperationStatus {
+  static readonly message: string;
+  static readonly code: number;
+}
+export declare class WhitelistOperationNoPermissionToRemoveOneself extends WhitelistOperationStatus {
+  static readonly message: string;
+  static readonly code: number;
+}
+export declare class WhitelistOperationKeyfobSlotsFull extends WhitelistOperationStatus {
+  static readonly message: string;
+  static readonly code: number;
+}
+export declare class WhitelistOperationWhitelistFull extends WhitelistOperationStatus {
+  static readonly message: string;
+  static readonly code: number;
+}
+export declare class WhitelistOperationNoPermissionToAdd extends WhitelistOperationStatus {
+  static readonly message: string;
+  static readonly code: number;
+}
+export declare class WhitelistOperationInvalidPublicKey extends WhitelistOperationStatus {
+  static readonly message: string;
+  static readonly code: number;
+}
+export declare class WhitelistOperationNoPermissionToRemove extends WhitelistOperationStatus {
+  static readonly message: string;
+  static readonly code: number;
+}
+export declare class WhitelistOperationNoPermissionToChangePermissions extends WhitelistOperationStatus {
+  static readonly message: string;
+  static readonly code: number;
+}
+export declare class WhitelistOperationAttemptingToElevateOthersAboveOneself extends WhitelistOperationStatus {
+  static readonly message: string;
+  static readonly code: number;
+}
+export declare class WhitelistOperationAttemptingToDemoteSuperiorToOneself extends WhitelistOperationStatus {
+  static readonly message: string;
+  static readonly code: number;
+}
+export declare class WhitelistOperationAttemptingToRemoveOwnPermissions extends WhitelistOperationStatus {
+  static readonly message: string;
+  static readonly code: number;
+}
+export declare class WhitelistOperationPublicKeyNotOnWhitelist extends WhitelistOperationStatus {
+  static readonly message: string;
+  static readonly code: number;
+}
+export declare class WhitelistOperationAttemptingToAddExistingKey extends WhitelistOperationStatus {
+  static readonly message: string;
+  static readonly code: number;
+}
+export declare class WhitelistOperationNotAllowedToAddUnlessOnReader extends WhitelistOperationStatus {
+  static readonly message: string;
+  static readonly code: number;
+}
+export declare class WhitelistOperationFMModifyingOutsideOfFMode extends WhitelistOperationStatus {
+  static readonly message: string;
+  static readonly code: number;
+}
+export declare class WhitelistOperationFMAttemptingToAddPermanentKey extends WhitelistOperationStatus {
+  static readonly message: string;
+  static readonly code: number;
+}
+export declare class WhitelistOperationFMAttemptingToRemovePermanentKey extends WhitelistOperationStatus {
+  static readonly message: string;
+  static readonly code: number;
+}
+export declare class WhitelistOperationKeychainWhileFSFull extends WhitelistOperationStatus {
+  static readonly message: string;
+  static readonly code: number;
+}
+export declare class WhitelistOperationAttemptingToAddKeyWithoutRole extends WhitelistOperationStatus {
+  static readonly message: string;
+  static readonly code: number;
+}
+export declare class WhitelistOperationAttemptingToAddKeyWithServiceRole extends WhitelistOperationStatus {
+  static readonly message: string;
+  static readonly code: number;
+}
+export declare class WhitelistOperationNonServiceKeyAttemptingToAddServiceTech extends WhitelistOperationStatus {
+  static readonly message: string;
+  static readonly code: number;
+}
+export declare class WhitelistOperationServiceKeyAttemptingToAddServiceTechOutsideServiceMode extends WhitelistOperationStatus {
+  static readonly message: string;
+  static readonly code: number;
+}
+export declare class WhitelistOperationCouldNotStartLocalEntityAuth extends WhitelistOperationStatus {
+  static readonly message: string;
+  static readonly code: number;
+}
+export declare class WhitelistOperationLocalEntityAuthFailedUIDenied extends WhitelistOperationStatus {
+  static readonly message: string;
+  static readonly code: number;
+}
+export declare class WhitelistOperationLocalEntityAuthFailedTimedOutWaitingForTap extends WhitelistOperationStatus {
+  static readonly message: string;
+  static readonly code: number;
+}
+export declare class WhitelistOperationLocalEntityAuthFailedTimedOutWaitingForUIAck extends WhitelistOperationStatus {
+  static readonly message: string;
+  static readonly code: number;
+}
+export declare class WhitelistOperationLocalEntityAuthFailedValetMode extends WhitelistOperationStatus {
+  static readonly message: string;
+  static readonly code: number;
+}
+export declare class WhitelistOperationLocalEntityAuthFailedCancelled extends WhitelistOperationStatus {
+  static readonly message: string;
+  static readonly code: number;
+}
+/** `TeslaFleetInformationFault` subclasses indexed by their protobuf enum value; index 0 (no fault) is `null`. */
+export declare const INFORMATION_FAULTS: readonly (typeof TeslaFleetInformationFault | null)[];
+/** `TeslaFleetMessageFault` subclasses indexed by their protobuf enum value; index 0 (no fault) is `null`. */
+export declare const MESSAGE_FAULTS: readonly (typeof TeslaFleetMessageFault | null)[];
+/** `SignedMessageInformationFault` subclasses indexed by their protobuf enum value; index 0 (no fault) is `null`. */
+export declare const SIGNED_MESSAGE_INFORMATION_FAULTS: readonly (typeof SignedMessageInformationFault | null)[];
+/** `WhitelistOperationStatus` subclasses indexed by their protobuf enum value; index 0 (no fault) is `null`. */
+export declare const WHITELIST_OPERATION_STATUS: readonly (typeof WhitelistOperationStatus | null)[];
+/**
+ * Every fault a vehicle can return that means it did not recognize/accept our
+ * signing key as authorized to issue commands, verified against each fault's
+ * proto enum meaning rather than its name alone.
+ * `TeslaFleetMessageFaultKeychainIsFull` is deliberately excluded: its proto
+ * meaning is "no room to add another key", not "this key was rejected".
+ */
+export declare const KEY_REJECTED_FAULTS: readonly (typeof TeslaFleetError)[];
+/**
+ * Whether `error` means the vehicle rejected our signing key.
+ *
+ * True for a fault meaning the vehicle does not recognize our key as
+ * whitelisted/paired (or could not retrieve/validate it), false for every
+ * other fault, including transport errors and faults about an unrelated
+ * signed-command condition (e.g. a full keychain).
+ */
+export declare function is_key_rejected(error: unknown): boolean;
+/**
+ * Throw the `TeslaFleetError` subclass matching `resp` if its status is >= 400.
+ * https://developer.tesla.com/docs/fleet-api#response-codes
+ *
+ * Consumes the response body when it throws; resolves without touching the
+ * body otherwise.
+ */
+export declare function raise_for_status(resp: Response): Promise<void>;