Struct ShopifyRuntime 

pub struct ShopifyRuntime { /* private fields */ }

Runtime state shared by the routes and the Shopify extractor.

The startup hook puts it in the AppState extensions.

Implementations

impl ShopifyRuntime

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

The resolved, validated config.

pub const fn registry(&self) -> &WebhookRegistry

The webhook handlers.

pub fn token_store(&self) -> &Arc<dyn TokenStore>

The token store, to read tokens.

Do not write or delete tokens through it: the plugin serializes writes per shop, and a direct write can race a refresh.

pub const fn delivery_store(&self) -> &Arc<dyn DeliveryStore>

The duplicate-delivery store.

pub fn client(&self) -> Result<ShopifyClient>

The client for the single-store shop.

Errors

Returns Error::Config when shop or SHOPIFY_ACCESS_TOKEN is not set.

pub async fn client_for( &self, shop: &ShopDomain, now: i64, ) -> Result<ShopifyClient>

The client for shop, at Unix time now.

The single-store shop uses the fixed token. Other shops use the token store. When the token expires within REFRESH_MARGIN_SECS, it refreshes first. Only one refresh for a shop runs at a time, in its own task: a cancelled caller does not lose the new token pair. When a refresh fails and the old token is still valid, the client uses the old token.

Errors

Returns Error::NotInstalled when the shop has no token, Error::Reauthorize when Shopify refuses the refresh token, or a store or HTTP error.

Trait Implementations

impl Debug for ShopifyRuntime

Debug shows no secrets and no tokens.

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

Formats the value using the given formatter.