Struct NatsStoragePort 

pub struct NatsStoragePort { /* private fields */ }

NATS JetStream-backed storage port.

Implementations

impl NatsStoragePort

pub fn builder() -> NatsStoragePortBuilder

Start a builder for explicit host wiring.

pub async fn from_env() -> Result<NatsStoragePort, PhotonError>

Connect using env (PHOTON_NATS_* defaults via builder).

Errors

Returns an error when env is missing or connection fails.

pub async fn connect( url: &str, stream_name: &str, ) -> Result<NatsStoragePort, PhotonError>

Connect to NATS with explicit URL and stream name (legacy; uses env defaults for firehose options).

Errors

Returns an error when connection or stream setup fails.

pub const fn config(&self) -> &NatsConfig

Resolved adapter configuration.

Trait Implementations

impl StoragePort for NatsStoragePort

fn capabilities(&self) -> StorageCapabilities

Adapter capabilities for contract tests and telemetry.

fn append<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, topic_name: &'life1 str, topic_key: Option<&'life2 str>, actor_json: Value, payload_json: Value, ) -> Pin<Box<dyn Future<Output = Result<Event, PhotonError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, NatsStoragePort: 'async_trait,

Append one event to a topic partition.

fn subscribe( &self, topic_name: String, topic_key_filter: Option<String>, after_seq: Option<i64>, ) -> Pin<Box<dyn Stream<Item = Result<Event, PhotonError>> + Send>>

Stream events for a topic partition, optionally replaying after after_seq.

fn get_event<'life0, 'life1, 'async_trait>( &'life0 self, _event_id: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Option<Event>, PhotonError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, NatsStoragePort: 'async_trait,

Point lookup by event id (optional — see StorageCapabilities::supports_get_event).

fn load_checkpoint<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, subscription_name: &'life1 str, topic_name: &'life2 str, topic_key: Option<&'life3 str>, ) -> Pin<Box<dyn Future<Output = Result<Option<i64>, PhotonError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait, NatsStoragePort: 'async_trait,

Load durable subscription high-water seq.

fn commit_checkpoint<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, subscription_name: &'life1 str, topic_name: &'life2 str, topic_key: Option<&'life3 str>, last_seq: i64, ) -> Pin<Box<dyn Future<Output = Result<(), PhotonError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait, NatsStoragePort: 'async_trait,

Persist durable subscription high-water seq.

fn truncate_before<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, topic_name: &'life1 str, topic_key: Option<&'life2 str>, truncate_bound: i64, ) -> Pin<Box<dyn Future<Output = Result<u64, PhotonError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, Self: 'async_trait,

Trim events before truncate_bound for a partition (no-op when unsupported).

fn delivery_seq_pin<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, topic_name: &'life1 str, topic_key: Option<&'life2 str>, ) -> Pin<Box<dyn Future<Output = Option<i64>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, Self: 'async_trait,

Last delivered seq pin for retention watermarks (optional).