Enum ErrorData 

pub enum ErrorData {
    KeyInputInvalid {
        reason: String,
    },
    KeyCiphertextInvalid {
        reason: String,
    },
    BindingNotConfigured {
        binding_name: String,
        env_var: String,
    },
    BindingConfigInvalid {
        binding_name: String,
        env_var: String,
        reason: String,
    },
    UnsupportedBindingProvider {
        binding_name: String,
        env_var: String,
        provider: String,
    },
    StorageOperationFailed {
        binding_name: String,
        operation: String,
    },
    StorageAccessDenied {
        binding_name: String,
        operation: String,
    },
    StorageObjectNotFound {
        binding_name: String,
        operation: String,
    },
    StorageObjectAlreadyExists {
        binding_name: String,
        operation: String,
    },
    BuildOperationFailed {
        binding_name: String,
        operation: String,
    },
    EnvironmentVariableMissing {
        variable_name: String,
    },
    InvalidEnvironmentVariable {
        variable_name: String,
        value: String,
        reason: String,
    },
    InvalidConfigurationUrl {
        url: String,
        reason: String,
    },
    EventProcessingFailed {
        event_type: String,
        reason: String,
    },
    GrpcConnectionFailed {
        endpoint: String,
        reason: String,
    },
    GrpcServiceUnavailable {
        service: String,
        endpoint: String,
        reason: String,
    },
    GrpcRequestFailed {
        service: String,
        method: String,
        details: String,
    },
    ServerBindFailed {
        address: String,
        reason: String,
    },
    AuthenticationFailed {
        provider: String,
        binding_name: String,
        reason: String,
    },
    OperationNotSupported {
        operation: String,
        reason: String,
    },
    SandboxCommandFailed {
        failure: String,
        reason: String,
    },
    SandboxOutcomeUnknown {
        operation: String,
        reason: String,
    },
    SandboxNotAsDeclared {
        sandbox_id: String,
        restriction: String,
        reason: String,
    },
    SandboxUnreachable {
        operation: String,
        reason: String,
    },
    FeatureNotEnabled {
        feature: String,
    },
    GrpcCallFailed {
        service: String,
        method: String,
        reason: String,
    },
    DeserializationFailed {
        message: String,
        type_name: String,
    },
    SerializationFailed {
        message: String,
    },
    UnexpectedResponseFormat {
        provider: String,
        binding_name: String,
        field: String,
        response_json: String,
    },
    CloudPlatformError {
        message: String,
        resource_id: Option<String>,
    },
    PostgresSecretResolutionFailed {
        binding_name: String,
        secret: String,
        reason: String,
    },
    PostgresSecretValueInvalid {
        binding_name: String,
        secret: String,
        reason: String,
    },
    ResourceNotFound {
        resource_id: String,
    },
    RemoteResourceNotFound {
        operation_context: String,
        resource_type: String,
        resource_name: String,
    },
    RemoteResourceConflict {
        operation_context: String,
        resource_type: String,
        resource_name: String,
        conflict_reason: String,
    },
    RemoteAccessDenied {
        operation_context: String,
        resource_type: String,
        resource_name: String,
    },
    RateLimitExceeded {
        operation_context: String,
        details: String,
    },
    Timeout {
        operation_context: String,
        details: String,
    },
    RemoteServiceUnavailable {
        operation_context: String,
        details: String,
    },
    QuotaExceeded {
        operation_context: String,
        details: String,
    },
    InvalidInput {
        operation_context: String,
        details: String,
        field_name: Option<String>,
    },
    AuthenticationError {
        operation_context: String,
        details: String,
    },
    Other {
        message: String,
    },
    PresignedRequestExpired {
        path: String,
        expired_at: DateTime<Utc>,
    },
    HttpRequestFailed {
        url: String,
        method: String,
    },
    LocalFilesystemError {
        path: String,
        operation: String,
    },
    ClientConfigLoadFailed {
        provider: String,
    },
    BindingSetupFailed {
        binding_type: String,
        reason: String,
    },
    KvOperationFailed {
        operation: String,
        key: String,
        reason: String,
    },
    QueueOperationFailed {
        operation: String,
        reason: String,
    },
    QueueProviderResponseInvalid {
        reason: String,
    },
    RemoteAccessFailed {
        operation: String,
    },
    ClientConfigInvalid {
        platform: Platform,
        message: String,
    },
}

Errors related to alien-bindings operations.

Variants

KeyInputInvalid

Plaintext or context is outside the portable Key binding limits.

Fields

reason: String

KeyCiphertextInvalid

Decrypted provider data is not a valid Alien Key frame.

Fields

reason: String

BindingNotConfigured

No binding configuration was found for the requested binding name (the ALIEN_<NAME>_BINDING environment variable was not set).

Fields

binding_name: String

Name of the binding that was requested

env_var: String

The exact environment variable name that would configure this binding

BindingConfigInvalid

Binding provider configuration is invalid or missing.

Fields

binding_name: String

Name of the binding

env_var: String

The exact environment variable name that configures this binding

reason: String

Specific reason why the configuration is invalid

UnsupportedBindingProvider

Binding configuration named a provider that this build does not support.

Fields

binding_name: String

Name of the binding

env_var: String

The exact environment variable name that configures this binding

provider: String

The provider string that is not supported

StorageOperationFailed

Storage operation failed due to provider issues.

Fields

binding_name: String

Name of the storage binding

operation: String

Description of the operation that failed

StorageAccessDenied

Storage credentials are missing permission for an operation.

Fields

binding_name: String

Name of the storage binding.

operation: String

Provider-independent operation name.

StorageObjectNotFound

The requested object does not exist.

Fields

binding_name: String

Name of the storage binding.

operation: String

Provider-independent operation name.

StorageObjectAlreadyExists

A create-only storage write found an existing object.

Fields

binding_name: String

Name of the storage binding.

operation: String

Provider-independent operation name.

BuildOperationFailed

Build operation failed due to provider issues.

Fields

binding_name: String

Name of the build binding

operation: String

Description of the operation that failed

EnvironmentVariableMissing

Required environment variable is missing or invalid.

Fields

variable_name: String

Name of the missing environment variable

InvalidEnvironmentVariable

Environment variable has an invalid value.

Fields

variable_name: String

Name of the environment variable

value: String

The invalid value

reason: String

Reason why the value is invalid

InvalidConfigurationUrl

Configuration URL is malformed or invalid.

Fields

url: String

The invalid URL

reason: String

Specific reason why the URL is invalid

EventProcessingFailed

Event processing failed due to malformed or unsupported data.

Fields

event_type: String

Type of event that failed to process

reason: String

Specific reason for the processing failure

GrpcConnectionFailed

gRPC connection failed or became unavailable.

Fields

endpoint: String

The gRPC endpoint that failed to connect

reason: String

Reason for the connection failure

GrpcServiceUnavailable

gRPC service unavailable or returned error.

Fields

service: String

Name of the gRPC service

endpoint: String

The gRPC endpoint

reason: String

Reason for service unavailability

GrpcRequestFailed

gRPC request failed with an error status.

Fields

service: String

Name of the gRPC service

method: String

Name of the gRPC method

details: String

Error details from the gRPC status

ServerBindFailed

Server failed to bind to the specified address.

Fields

address: String

The address that failed to bind

reason: String

Reason for the bind failure

AuthenticationFailed

Authentication failed for the configured provider.

Fields

provider: String

Name of the provider (aws, gcp, azure, etc.)

binding_name: String

Name of the binding

reason: String

Reason for authentication failure

OperationNotSupported

Operation not supported by the configured provider.

Fields

operation: String

Name of the unsupported operation

reason: String

Reason why the operation is not supported

SandboxCommandFailed

A command run inside a sandbox did not complete.

Visibility is inherited for the reason SandboxUnreachable gives below: what this wraps is often a cloud client’s error carrying the response text of the call that failed, and into_external reads only the outermost flag — so a fixed false here would publish it.

Fields

failure: String

Diagnostic label from the provider or agent, for logs and support; callers branch on the error code

reason: String

Human-readable detail from the agent

SandboxOutcomeUnknown

A sandbox operation was dispatched and never reported its outcome.

The counterpart to SandboxUnreachable: there the call did not take effect and repeating it is safe, here it may already have taken effect, so a repeat can run the same command twice. Visibility is inherited for the reason SandboxUnreachable gives below.

502 rather than the 503 its neighbour carries: the exchange with the sandbox broke down, which is not the same invitation to try again later.

Fields

operation: String

Operation that was in flight

reason: String

What went wrong on the wire

SandboxNotAsDeclared

A sandbox came up without a restriction its declaration asked for.

Distinct from a refused call: the data plane accepted the request and answered, and what it built is not what was asked for. The sandbox id is carried because the caller never receives one — this is the failure where an operator has to be able to find what was left behind if deleting it also failed.

Fields

sandbox_id: String

Provider-scoped id of the sandbox that was built

restriction: String

What the declaration asked for, such as egress policy

reason: String

What the sandbox came up with instead

SandboxUnreachable

The sandbox agent could not be reached, or the connection dropped mid-response.

Visibility is inherited rather than declared public: what this wraps is often the cloud client’s catch-all, which carries the raw request and response text of the call that failed. Marking the wrapper external does not redact a source, so a fixed false here would carry that text out to a caller.

Fields

operation: String

Operation that was in flight

reason: String

What went wrong on the wire

FeatureNotEnabled

Feature is not enabled in the compiled binary.

Fields

feature: String

Name of the feature that is not enabled

GrpcCallFailed

gRPC call failed.

Fields

service: String

Name of the gRPC service

method: String

Name of the gRPC method

reason: String

Reason for the call failure

DeserializationFailed

Deserialization of data failed.

Fields

message: String

Human-readable error message

type_name: String

Name of the type being deserialized

SerializationFailed

Serialization of data failed.

Fields

message: String

Human-readable error message

UnexpectedResponseFormat

Response format from provider API is unexpected or missing required fields.

Fields

provider: String

Name of the provider (aws, gcp, azure, etc.)

binding_name: String

Name of the binding

field: String

Name of the missing or malformed field

response_json: String

The full response JSON for debugging

CloudPlatformError

Cloud platform API error.

Fields

message: String

Human-readable description of the error

resource_id: Option<String>

Optional resource ID that was involved in the error

PostgresSecretResolutionFailed

Reading a cloud Postgres binding’s password from its secret store failed.

The retry and visibility metadata comes from the provider error being wrapped: throttling remains retryable, while permanent provider failures do not become retryable merely because they happened during secret resolution.

secret is the locator, never the secret value.

Fields

binding_name: String

Name of the Postgres binding whose password could not be resolved

secret: String

The secret locator that was read (an ARN / name / URI — never the value)

reason: String

What went wrong while reading the secret

PostgresSecretValueInvalid

A cloud Postgres secret was read, but did not contain a usable password.

Provider responses with missing, empty, or malformed values cannot become valid by retrying the same version. secret is the locator, never the secret value.

Fields

binding_name: String

Name of the Postgres binding whose password value was invalid

secret: String

The secret locator that was read (an ARN / name / URI — never the value)

reason: String

Why the returned value cannot be used as a password

ResourceNotFound

Resource not found in the cloud platform.

Fields

resource_id: String

ID of the resource that was not found

RemoteResourceNotFound

The requested remote resource does not exist.

Fields

operation_context: String

Context of the operation that failed (e.g., “Failed to get ECR repository details”)

resource_type: String

Type of the resource that was not found

resource_name: String

Name of the resource that was not found

RemoteResourceConflict

Operation conflicts with current remote resource state.

Fields

operation_context: String

Context of the operation that failed

resource_type: String

Type of the resource that has a conflict

resource_name: String

Name of the resource that has a conflict

conflict_reason: String

Specific reason for the conflict

RemoteAccessDenied

Access denied due to insufficient permissions.

Fields

operation_context: String

Context of the operation that failed

resource_type: String

Type of the resource access was denied to

resource_name: String

Name of the resource access was denied to

RateLimitExceeded

Request rate limit exceeded.

Fields

operation_context: String

Context of the operation that failed

details: String

Additional details about the rate limit

Timeout

Operation exceeded the allowed timeout.

Fields

operation_context: String

Context of the operation that failed

details: String

Additional details about the timeout

RemoteServiceUnavailable

Remote service is temporarily unavailable.

Fields

operation_context: String

Context of the operation that failed

details: String

Additional details about the service unavailability

QuotaExceeded

Quota or resource limits have been exceeded.

Fields

operation_context: String

Context of the operation that failed

details: String

Additional details about the quota violation

InvalidInput

Invalid or malformed input parameters provided to the operation.

Fields

operation_context: String

Context of the operation that failed

details: String

Details about what input was invalid

field_name: Option<String>

Optional field name that was invalid

AuthenticationError

Authentication with cloud provider failed.

Fields

operation_context: String

Context of the operation that failed

details: String

Details about the authentication failure

Other

Generic bindings error for uncommon cases.

Fields

message: String

Human-readable description of the error

PresignedRequestExpired

Presigned request has expired and can no longer be used.

Fields

path: String

Path that the presigned request was for

expired_at: DateTime<Utc>

When the request expired

HttpRequestFailed

HTTP request to external service failed.

Fields

url: String

URL that was requested

method: String

HTTP method that was used

LocalFilesystemError

Local filesystem operation failed.

Fields

path: String

Path that the operation was performed on

operation: String

Operation that failed

ClientConfigLoadFailed

Failed to load platform configuration for the provider.

Fields

provider: String

Name of the provider (aws, gcp, azure, etc.)

BindingSetupFailed

Binding setup failed during initialization.

Fields

binding_type: String

Type of binding being set up

reason: String

Reason for the setup failure

KvOperationFailed

KV operation failed.

Fields

operation: String

The KV operation that failed

key: String

The key involved in the operation

reason: String

Reason for the operation failure

QueueOperationFailed

Queue operation failed.

Fields

operation: String

The queue operation that failed

reason: String

Reason for the operation failure

QueueProviderResponseInvalid

A queue provider returned invalid message metadata required by the binding contract.

Fields

reason: String

Safe description of the missing or invalid provider field.

RemoteAccessFailed

Remote access to deployment resources failed.

Fields

operation: String

Description of the operation that failed

ClientConfigInvalid

Client configuration is invalid or missing for the platform.

Fields

platform: Platform

The platform that was expected

message: String

Description of the configuration issue

Implementations

impl ErrorData

pub fn config_invalid( binding_name: &str, reason: impl Into<String>, ) -> ErrorData

Construct a ErrorData::BindingConfigInvalid for binding_name, deriving the exact ALIEN_<NAME>_BINDING env var name internally so call sites cannot forget it (the omission that repeatedly broke bindings).

pub fn not_configured(binding_name: &str) -> ErrorData

Construct a ErrorData::BindingNotConfigured for binding_name, deriving the exact ALIEN_<NAME>_BINDING env var name internally.

Trait Implementations

impl AlienErrorData for ErrorData

fn code(&self) -> &'static str

Short machine-readable identifier (“NOT_FOUND”, “TIMEOUT”, …).

fn retryable(&self) -> bool

Whether the failing operation can be retried.

fn internal(&self) -> bool

Whether the error is internal (should not be shown to end users).

fn http_status_code(&self) -> u16

HTTP status code for this error (defaults to 500).

fn message(&self) -> String

Human-readable message (defaults to Display).

fn hint(&self) -> Option<String>

Optional actionable hint for human-facing CLI output.

fn context(&self) -> Option<Value>

Optional diagnostic payload built from struct/enum fields.

fn retryable_inherit(&self) -> Option<bool>

Whether to inherit the retryable flag from the source error. Returns None if this error should inherit from source, Some(value) for explicit value.

fn internal_inherit(&self) -> Option<bool>

Whether to inherit the internal flag from the source error. Returns None if this error should inherit from source, Some(value) for explicit value.

fn http_status_code_inherit(&self) -> Option<u16>

Whether to inherit the HTTP status code from the source error. Returns None if this error should inherit from source, Some(value) for explicit value.

fn human_layer_presentation(&self) -> HumanLayerPresentation

Controls whether this error layer should be shown in the default human CLI renderer.

impl Clone for ErrorData

fn clone(&self) -> ErrorData

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ErrorData

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ErrorData

fn deserialize<__D>( __deserializer: __D, ) -> Result<ErrorData, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for ErrorData

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Serialize for ErrorData

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.