asterisk-rs-core

Shared foundation for the asterisk-rs ecosystem. The AMI, AGI, and ARI crates all depend on this crate for common types; it contains no protocol-specific logic.

What it provides

Errors

• Error — top-level error enum covering all failure modes
• ConnectionError — TCP connect failures, TLS errors, socket closed
• AuthError — login rejected, missing credentials, challenge failures
• TimeoutError — read/write/login timeouts
• ProtocolError — malformed frames, unexpected packet structure

Event bus

• Event — marker trait required by the bus: Clone + Send + Sync + Debug + 'static
• EventBus<E> — broadcast hub; protocol crates publish into it internally
• EventSubscription<E> — unbounded receiver; all events since subscribe
• FilteredSubscription<E> — like EventSubscription but with a predicate applied before delivery

Reconnection

• ReconnectPolicy — three modes:
  • ReconnectPolicy::exponential(initial, max) — doubles delay each attempt, jitter applied to prevent thundering herd (default)
  • ReconnectPolicy::fixed(interval) — constant retry delay
  • ReconnectPolicy::none() — fail on first disconnect
• ConnectionState — observable state machine: Disconnected → Connecting → Connected → Reconnecting

Credentials

• Credentials — username/secret pair; Debug impl redacts the secret so it never appears in logs or panic output

Domain constants

Strongly-typed enums parsed from Asterisk protocol strings:

Usage

You do not need to add this crate as a direct dependency unless you are building a custom protocol integration. Add asterisk-rs-ami, asterisk-rs-agi, or asterisk-rs-ari instead; they re-export the types callers need.

Part of asterisk-rs. MSRV 1.83. MIT OR Apache-2.0.