sellapp-sdk 0.1.1

// This file is auto-generated by oagen. Do not edit.

use crate::client::Client;
#[allow(unused_imports)]
use crate::enums::*;
use crate::error::Error;
#[allow(unused_imports)]
use crate::models::*;
#[allow(unused_imports)]
use serde::Serialize;

pub struct WebhookChannelsApi<'a> {
    pub(crate) client: &'a Client,
}

#[derive(Debug, Clone, Serialize)]
pub struct ListParams {
    /// Page number.
    ///
    /// Defaults to `1`.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub page: Option<i64>,
    /// Number of webhook channels to return per page.
    ///
    /// Defaults to `15`.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub limit: Option<i64>,
    /// Store slug. Required for OAuth access tokens. API keys may omit it to use their current store, or the first accessible store when no current store is selected.
    #[serde(skip_serializing_if = "Option::is_none")]
    #[serde(rename = "X-STORE")]
    pub x_store: Option<String>,
}

impl Default for ListParams {
    #[allow(deprecated)]
    fn default() -> Self {
        Self {
            page: Some(1),
            limit: Some(15),
            x_store: Default::default(),
        }
    }
}

#[derive(Debug, Clone, Serialize)]
pub struct CreateParams {
    /// Store slug. Required for OAuth access tokens. API keys may omit it to use their current store, or the first accessible store when no current store is selected.
    #[serde(skip_serializing_if = "Option::is_none")]
    #[serde(rename = "X-STORE")]
    pub x_store: Option<String>,
    /// Request body sent with this call.
    ///
    /// Required.
    #[serde(skip)]
    pub body: SdkCreateWebhookChannelRequestApplicationJson,
}

impl CreateParams {
    /// Construct a new `CreateParams` with the required fields set.
    #[allow(deprecated)]
    pub fn new(body: SdkCreateWebhookChannelRequestApplicationJson) -> Self {
        Self {
            x_store: Default::default(),
            body,
        }
    }
}

#[derive(Debug, Clone, Serialize)]
pub struct SearchParams {
    /// Store slug. Required for OAuth access tokens. API keys may omit it to use their current store, or the first accessible store when no current store is selected.
    #[serde(skip_serializing_if = "Option::is_none")]
    #[serde(rename = "X-STORE")]
    pub x_store: Option<String>,
    /// Request body sent with this call.
    ///
    /// Required.
    #[serde(skip)]
    pub body: SdkSearchWebhookChannelsRequestApplicationJson,
}

impl SearchParams {
    /// Construct a new `SearchParams` with the required fields set.
    #[allow(deprecated)]
    pub fn new(body: SdkSearchWebhookChannelsRequestApplicationJson) -> Self {
        Self {
            x_store: Default::default(),
            body,
        }
    }
}

#[derive(Debug, Clone, Serialize)]
pub struct RotateParams {
    /// Store slug. Required for OAuth access tokens. API keys may omit it to use their current store, or the first accessible store when no current store is selected.
    #[serde(skip_serializing_if = "Option::is_none")]
    #[serde(rename = "X-STORE")]
    pub x_store: Option<String>,
    /// Request body sent with this call.
    ///
    /// Required.
    #[serde(skip)]
    pub body: SdkRotateWebhookSigningSecretRequestApplicationJson,
}

impl RotateParams {
    /// Construct a new `RotateParams` with the required fields set.
    #[allow(deprecated)]
    pub fn new(body: SdkRotateWebhookSigningSecretRequestApplicationJson) -> Self {
        Self {
            x_store: Default::default(),
            body,
        }
    }
}

#[derive(Debug, Clone, Default, Serialize)]
pub struct GetParams {
    /// Store slug. Required for OAuth access tokens. API keys may omit it to use their current store, or the first accessible store when no current store is selected.
    #[serde(skip_serializing_if = "Option::is_none")]
    #[serde(rename = "X-STORE")]
    pub x_store: Option<String>,
}

#[derive(Debug, Clone, Serialize)]
pub struct ReplaceParams {
    /// Store slug. Required for OAuth access tokens. API keys may omit it to use their current store, or the first accessible store when no current store is selected.
    #[serde(skip_serializing_if = "Option::is_none")]
    #[serde(rename = "X-STORE")]
    pub x_store: Option<String>,
    /// Request body sent with this call.
    ///
    /// Required.
    #[serde(skip)]
    pub body: SdkReplaceWebhookChannelRequestApplicationJson,
}

impl ReplaceParams {
    /// Construct a new `ReplaceParams` with the required fields set.
    #[allow(deprecated)]
    pub fn new(body: SdkReplaceWebhookChannelRequestApplicationJson) -> Self {
        Self {
            x_store: Default::default(),
            body,
        }
    }
}

#[derive(Debug, Clone, Serialize)]
pub struct UpdateParams {
    /// Store slug. Required for OAuth access tokens. API keys may omit it to use their current store, or the first accessible store when no current store is selected.
    #[serde(skip_serializing_if = "Option::is_none")]
    #[serde(rename = "X-STORE")]
    pub x_store: Option<String>,
    /// Request body sent with this call.
    ///
    /// Required.
    #[serde(skip)]
    pub body: SdkUpdateWebhookChannelRequestApplicationJson,
}

impl UpdateParams {
    /// Construct a new `UpdateParams` with the required fields set.
    #[allow(deprecated)]
    pub fn new(body: SdkUpdateWebhookChannelRequestApplicationJson) -> Self {
        Self {
            x_store: Default::default(),
            body,
        }
    }
}

#[derive(Debug, Clone, Default, Serialize)]
pub struct DeleteParams {
    /// Store slug. Required for OAuth access tokens. API keys may omit it to use their current store, or the first accessible store when no current store is selected.
    #[serde(skip_serializing_if = "Option::is_none")]
    #[serde(rename = "X-STORE")]
    pub x_store: Option<String>,
}

#[derive(Debug, Clone, Serialize)]
pub struct SendParams {
    /// Store slug. Required for OAuth access tokens. API keys may omit it to use their current store, or the first accessible store when no current store is selected.
    #[serde(skip_serializing_if = "Option::is_none")]
    #[serde(rename = "X-STORE")]
    pub x_store: Option<String>,
    /// Request body sent with this call.
    ///
    /// Required.
    #[serde(skip)]
    pub body: SdkSendTestWebhookRequestApplicationJson,
}

impl SendParams {
    /// Construct a new `SendParams` with the required fields set.
    #[allow(deprecated)]
    pub fn new(body: SdkSendTestWebhookRequestApplicationJson) -> Self {
        Self {
            x_store: Default::default(),
            body,
        }
    }
}

impl<'a> WebhookChannelsApi<'a> {
    /// List webhook channels
    ///
    /// Retrieve the authenticated store's outbound developer webhook destinations. Signing secrets and delivery headers are never included. OAuth callers use the admin grant and select a store with X-STORE. Current membership and role permissions apply to every request.
    pub async fn list(
        &self,
        params: ListParams,
    ) -> Result<SdkListWebhookChannelsResponseValue200ApplicationJson, Error> {
        self.list_with_options(params, None).await
    }

    /// Variant of [`Self::list`] that accepts per-request [`crate::RequestOptions`].
    pub async fn list_with_options(
        &self,
        params: ListParams,
        options: Option<&crate::RequestOptions>,
    ) -> Result<SdkListWebhookChannelsResponseValue200ApplicationJson, Error> {
        self.list_raw(params, options)
            .await
            .map(|response| response.data)
    }

    /// Returns the typed result together with status, headers, and request ID.
    pub async fn list_raw(
        &self,
        params: ListParams,
        options: Option<&crate::RequestOptions>,
    ) -> Result<crate::RawResponse<SdkListWebhookChannelsResponseValue200ApplicationJson>, Error>
    {
        let path = "/v2/webhook-channels".to_string();
        let method = http::Method::GET;
        let mut merged = options.cloned().unwrap_or_default();
        merged.idempotency_supported = false;
        merged.operation_id = Some("listWebhookChannels".to_string());
        let options = Some(&merged);
        self.client
            .request_with_query_schema_opts_raw(
                method,
                &path,
                &params,
                options,
                "GET /v2/webhook-channels",
            )
            .await
    }

    /// Create a webhook channel
    ///
    /// Create an outbound webhook destination with a stable UUID and an explicit event filter. OAuth callers use the admin grant and select a store with X-STORE. Current membership and role permissions apply to every request.
    pub async fn create(
        &self,
        params: CreateParams,
    ) -> Result<SdkCreateWebhookChannelResponseValue201ApplicationJson, Error> {
        self.create_with_options(params, None).await
    }

    /// Variant of [`Self::create`] that accepts per-request [`crate::RequestOptions`].
    pub async fn create_with_options(
        &self,
        params: CreateParams,
        options: Option<&crate::RequestOptions>,
    ) -> Result<SdkCreateWebhookChannelResponseValue201ApplicationJson, Error> {
        self.create_raw(params, options)
            .await
            .map(|response| response.data)
    }

    /// Returns the typed result together with status, headers, and request ID.
    pub async fn create_raw(
        &self,
        params: CreateParams,
        options: Option<&crate::RequestOptions>,
    ) -> Result<crate::RawResponse<SdkCreateWebhookChannelResponseValue201ApplicationJson>, Error>
    {
        let path = "/v2/webhook-channels".to_string();
        let method = http::Method::POST;
        let mut merged = options.cloned().unwrap_or_default();
        merged.idempotency_supported = false;
        merged.operation_id = Some("createWebhookChannel".to_string());
        let options = Some(&merged);
        self.client
            .request_with_body_schema_opts_raw(
                method,
                &path,
                &params,
                Some(&params.body),
                options,
                "POST /v2/webhook-channels",
            )
            .await
    }

    /// Search webhook channels
    ///
    /// Search destinations by name or URL and optionally filter by a subscribed event. OAuth callers use the admin grant and select a store with X-STORE. Current membership and role permissions apply to every request.
    pub async fn search(
        &self,
        params: SearchParams,
    ) -> Result<SdkSearchWebhookChannelsResponseValue200ApplicationJson, Error> {
        self.search_with_options(params, None).await
    }

    /// Variant of [`Self::search`] that accepts per-request [`crate::RequestOptions`].
    pub async fn search_with_options(
        &self,
        params: SearchParams,
        options: Option<&crate::RequestOptions>,
    ) -> Result<SdkSearchWebhookChannelsResponseValue200ApplicationJson, Error> {
        self.search_raw(params, options)
            .await
            .map(|response| response.data)
    }

    /// Returns the typed result together with status, headers, and request ID.
    pub async fn search_raw(
        &self,
        params: SearchParams,
        options: Option<&crate::RequestOptions>,
    ) -> Result<crate::RawResponse<SdkSearchWebhookChannelsResponseValue200ApplicationJson>, Error>
    {
        let path = "/v2/webhook-channels/search".to_string();
        let method = http::Method::POST;
        let mut merged = options.cloned().unwrap_or_default();
        merged.idempotency_supported = false;
        merged.operation_id = Some("searchWebhookChannels".to_string());
        let options = Some(&merged);
        self.client
            .request_with_body_schema_opts_raw(
                method,
                &path,
                &params,
                Some(&params.body),
                options,
                "POST /v2/webhook-channels/search",
            )
            .await
    }

    /// Rotate the webhook signing secret
    ///
    /// Replace the store-wide outbound webhook signing secret. The value is write-only and is never returned or written to delivery logs. OAuth callers use the admin grant and select a store with X-STORE. Current membership and role permissions apply to every request.
    pub async fn rotate(
        &self,
        params: RotateParams,
    ) -> Result<SdkRotateWebhookSigningSecretResponseValue200ApplicationJson, Error> {
        self.rotate_with_options(params, None).await
    }

    /// Variant of [`Self::rotate`] that accepts per-request [`crate::RequestOptions`].
    pub async fn rotate_with_options(
        &self,
        params: RotateParams,
        options: Option<&crate::RequestOptions>,
    ) -> Result<SdkRotateWebhookSigningSecretResponseValue200ApplicationJson, Error> {
        self.rotate_raw(params, options)
            .await
            .map(|response| response.data)
    }

    /// Returns the typed result together with status, headers, and request ID.
    pub async fn rotate_raw(
        &self,
        params: RotateParams,
        options: Option<&crate::RequestOptions>,
    ) -> Result<
        crate::RawResponse<SdkRotateWebhookSigningSecretResponseValue200ApplicationJson>,
        Error,
    > {
        let path = "/v2/webhook-channels/signing-secret".to_string();
        let method = http::Method::PUT;
        let mut merged = options.cloned().unwrap_or_default();
        merged.idempotency_supported = false;
        merged.operation_id = Some("rotateWebhookSigningSecret".to_string());
        let options = Some(&merged);
        self.client
            .request_with_body_schema_opts_raw(
                method,
                &path,
                &params,
                Some(&params.body),
                options,
                "PUT /v2/webhook-channels/signing-secret",
            )
            .await
    }

    /// Retrieve a webhook channel
    ///
    /// Retrieve one outbound webhook destination by its stable UUID. OAuth callers use the admin grant and select a store with X-STORE. Current membership and role permissions apply to every request.
    pub async fn get(
        &self,
        webhook_channel: &str,
        params: GetParams,
    ) -> Result<SdkGetWebhookChannelResponseValue200ApplicationJson, Error> {
        self.get_with_options(webhook_channel, params, None).await
    }

    /// Variant of [`Self::get`] that accepts per-request [`crate::RequestOptions`].
    pub async fn get_with_options(
        &self,
        webhook_channel: &str,
        params: GetParams,
        options: Option<&crate::RequestOptions>,
    ) -> Result<SdkGetWebhookChannelResponseValue200ApplicationJson, Error> {
        self.get_raw(webhook_channel, params, options)
            .await
            .map(|response| response.data)
    }

    /// Returns the typed result together with status, headers, and request ID.
    pub async fn get_raw(
        &self,
        webhook_channel: &str,
        params: GetParams,
        options: Option<&crate::RequestOptions>,
    ) -> Result<crate::RawResponse<SdkGetWebhookChannelResponseValue200ApplicationJson>, Error>
    {
        let webhook_channel = crate::client::path_segment(webhook_channel);
        let path = format!("/v2/webhook-channels/{webhook_channel}");
        let method = http::Method::GET;
        let mut merged = options.cloned().unwrap_or_default();
        merged.idempotency_supported = false;
        merged.operation_id = Some("getWebhookChannel".to_string());
        let options = Some(&merged);
        self.client
            .request_with_query_schema_opts_raw(
                method,
                &path,
                &params,
                options,
                "GET /v2/webhook-channels/{webhookChannel}",
            )
            .await
    }

    /// Replace a webhook channel
    ///
    /// Replace a destination with a complete representation. name, url, and allowed_notifications must all be present. OAuth callers use the admin grant and select a store with X-STORE. Current membership and role permissions apply to every request.
    pub async fn replace(
        &self,
        webhook_channel: &str,
        params: ReplaceParams,
    ) -> Result<SdkReplaceWebhookChannelResponseValue200ApplicationJson, Error> {
        self.replace_with_options(webhook_channel, params, None)
            .await
    }

    /// Variant of [`Self::replace`] that accepts per-request [`crate::RequestOptions`].
    pub async fn replace_with_options(
        &self,
        webhook_channel: &str,
        params: ReplaceParams,
        options: Option<&crate::RequestOptions>,
    ) -> Result<SdkReplaceWebhookChannelResponseValue200ApplicationJson, Error> {
        self.replace_raw(webhook_channel, params, options)
            .await
            .map(|response| response.data)
    }

    /// Returns the typed result together with status, headers, and request ID.
    pub async fn replace_raw(
        &self,
        webhook_channel: &str,
        params: ReplaceParams,
        options: Option<&crate::RequestOptions>,
    ) -> Result<crate::RawResponse<SdkReplaceWebhookChannelResponseValue200ApplicationJson>, Error>
    {
        let webhook_channel = crate::client::path_segment(webhook_channel);
        let path = format!("/v2/webhook-channels/{webhook_channel}");
        let method = http::Method::PUT;
        let mut merged = options.cloned().unwrap_or_default();
        merged.idempotency_supported = false;
        merged.operation_id = Some("replaceWebhookChannel".to_string());
        let options = Some(&merged);
        self.client
            .request_with_body_schema_opts_raw(
                method,
                &path,
                &params,
                Some(&params.body),
                options,
                "PUT /v2/webhook-channels/{webhookChannel}",
            )
            .await
    }

    /// Update a webhook channel
    ///
    /// Partially update a destination. Supplying allowed_notifications replaces the complete event filter; omitted fields retain their current values. OAuth callers use the admin grant and select a store with X-STORE. Current membership and role permissions apply to every request.
    pub async fn update(
        &self,
        webhook_channel: &str,
        params: UpdateParams,
    ) -> Result<SdkUpdateWebhookChannelResponseValue200ApplicationJson, Error> {
        self.update_with_options(webhook_channel, params, None)
            .await
    }

    /// Variant of [`Self::update`] that accepts per-request [`crate::RequestOptions`].
    pub async fn update_with_options(
        &self,
        webhook_channel: &str,
        params: UpdateParams,
        options: Option<&crate::RequestOptions>,
    ) -> Result<SdkUpdateWebhookChannelResponseValue200ApplicationJson, Error> {
        self.update_raw(webhook_channel, params, options)
            .await
            .map(|response| response.data)
    }

    /// Returns the typed result together with status, headers, and request ID.
    pub async fn update_raw(
        &self,
        webhook_channel: &str,
        params: UpdateParams,
        options: Option<&crate::RequestOptions>,
    ) -> Result<crate::RawResponse<SdkUpdateWebhookChannelResponseValue200ApplicationJson>, Error>
    {
        let webhook_channel = crate::client::path_segment(webhook_channel);
        let path = format!("/v2/webhook-channels/{webhook_channel}");
        let method = http::Method::PATCH;
        let mut merged = options.cloned().unwrap_or_default();
        merged.idempotency_supported = false;
        merged.operation_id = Some("updateWebhookChannel".to_string());
        let options = Some(&merged);
        self.client
            .request_with_body_schema_opts_raw(
                method,
                &path,
                &params,
                Some(&params.body),
                options,
                "PATCH /v2/webhook-channels/{webhookChannel}",
            )
            .await
    }

    /// Delete a webhook channel
    ///
    /// Delete a destination. Other channel UUIDs remain unchanged and the deleted UUID is not reassigned. OAuth callers use the admin grant and select a store with X-STORE. Current membership and role permissions apply to every request.
    pub async fn delete(
        &self,
        webhook_channel: &str,
        params: DeleteParams,
    ) -> Result<SdkDeleteWebhookChannelResponseValue200ApplicationJson, Error> {
        self.delete_with_options(webhook_channel, params, None)
            .await
    }

    /// Variant of [`Self::delete`] that accepts per-request [`crate::RequestOptions`].
    pub async fn delete_with_options(
        &self,
        webhook_channel: &str,
        params: DeleteParams,
        options: Option<&crate::RequestOptions>,
    ) -> Result<SdkDeleteWebhookChannelResponseValue200ApplicationJson, Error> {
        self.delete_raw(webhook_channel, params, options)
            .await
            .map(|response| response.data)
    }

    /// Returns the typed result together with status, headers, and request ID.
    pub async fn delete_raw(
        &self,
        webhook_channel: &str,
        params: DeleteParams,
        options: Option<&crate::RequestOptions>,
    ) -> Result<crate::RawResponse<SdkDeleteWebhookChannelResponseValue200ApplicationJson>, Error>
    {
        let webhook_channel = crate::client::path_segment(webhook_channel);
        let path = format!("/v2/webhook-channels/{webhook_channel}");
        let method = http::Method::DELETE;
        let mut merged = options.cloned().unwrap_or_default();
        merged.idempotency_supported = false;
        merged.operation_id = Some("deleteWebhookChannel".to_string());
        let options = Some(&merged);
        self.client
            .request_with_query_schema_opts_raw(
                method,
                &path,
                &params,
                options,
                "DELETE /v2/webhook-channels/{webhookChannel}",
            )
            .await
    }

    /// Send a test webhook
    ///
    /// Synchronously send one mock delivery to the stored destination. `event` is the public delivery event name and the same name must already be enabled in `allowed_notifications`. The test payload uses the same top-level event/version contract as production. Test deliveries do not retry or follow redirects and never return response bodies or signing headers. OAuth callers use the admin grant and select a store with X-STORE. Current membership and role permissions apply to every request.
    pub async fn send(
        &self,
        webhook_channel: &str,
        params: SendParams,
    ) -> Result<SdkSendTestWebhookResponseValue200ApplicationJson, Error> {
        self.send_with_options(webhook_channel, params, None).await
    }

    /// Variant of [`Self::send`] that accepts per-request [`crate::RequestOptions`].
    pub async fn send_with_options(
        &self,
        webhook_channel: &str,
        params: SendParams,
        options: Option<&crate::RequestOptions>,
    ) -> Result<SdkSendTestWebhookResponseValue200ApplicationJson, Error> {
        self.send_raw(webhook_channel, params, options)
            .await
            .map(|response| response.data)
    }

    /// Returns the typed result together with status, headers, and request ID.
    pub async fn send_raw(
        &self,
        webhook_channel: &str,
        params: SendParams,
        options: Option<&crate::RequestOptions>,
    ) -> Result<crate::RawResponse<SdkSendTestWebhookResponseValue200ApplicationJson>, Error> {
        let webhook_channel = crate::client::path_segment(webhook_channel);
        let path = format!("/v2/webhook-channels/{webhook_channel}/test");
        let method = http::Method::POST;
        let mut merged = options.cloned().unwrap_or_default();
        merged.idempotency_supported = false;
        merged.operation_id = Some("sendTestWebhook".to_string());
        let options = Some(&merged);
        self.client
            .request_with_body_schema_opts_raw(
                method,
                &path,
                &params,
                Some(&params.body),
                options,
                "POST /v2/webhook-channels/{webhookChannel}/test",
            )
            .await
    }
}