knockapi 0.6.1 → 1.1.0

data/rbi/knockapi/resources/objects.rbi

@@ -0,0 +1,504 @@
+# typed: strong
+
+module Knockapi
+  module Resources
+    class Objects
+      sig { returns(Knockapi::Resources::Objects::Bulk) }
+      attr_reader :bulk
+
+      # Returns a paginated list of objects from the specified collection. Optionally
+      # includes preference data for the objects.
+      sig do
+        params(
+          collection: String,
+          after: String,
+          before: String,
+          include: T::Array[Knockapi::ObjectListParams::Include::OrSymbol],
+          page_size: Integer,
+          request_options: Knockapi::RequestOptions::OrHash
+        ).returns(Knockapi::Internal::EntriesCursor[Knockapi::Object])
+      end
+      def list(
+        # The collection this object belongs to.
+        collection,
+        # The cursor to fetch entries after.
+        after: nil,
+        # The cursor to fetch entries before.
+        before: nil,
+        # Includes preferences of the objects in the response.
+        include: nil,
+        # The number of items per page.
+        page_size: nil,
+        request_options: {}
+      )
+      end
+
+      # Permanently removes an object from the specified collection. This operation
+      # cannot be undone.
+      sig do
+        params(
+          collection: String,
+          id: String,
+          request_options: Knockapi::RequestOptions::OrHash
+        ).returns(String)
+      end
+      def delete(
+        # The collection this object belongs to.
+        collection,
+        # Unique identifier for the object.
+        id,
+        request_options: {}
+      )
+      end
+
+      # Add subscriptions for an object. If a subscription already exists, it will be
+      # updated. This endpoint also handles
+      # [inline identifications](/managing-recipients/identifying-recipients#inline-identifying-recipients)
+      # for the `recipient`.
+      sig do
+        params(
+          collection: String,
+          object_id_: String,
+          recipients:
+            T::Array[
+              T.any(
+                String,
+                Knockapi::InlineIdentifyUserRequest::OrHash,
+                Knockapi::InlineObjectRequest::OrHash
+              )
+            ],
+          properties: T.nilable(T::Hash[Symbol, T.anything]),
+          request_options: Knockapi::RequestOptions::OrHash
+        ).returns(T::Array[Knockapi::Recipients::Subscription])
+      end
+      def add_subscriptions(
+        # The collection this object belongs to.
+        collection,
+        # Unique identifier for the object.
+        object_id_,
+        # The recipients of the subscription. You can subscribe up to 100 recipients to an
+        # object at a time.
+        recipients:,
+        # The custom properties associated with the subscription relationship.
+        properties: nil,
+        request_options: {}
+      )
+      end
+
+      # Delete subscriptions for the specified recipients from an object. Returns the
+      # list of deleted subscriptions.
+      sig do
+        params(
+          collection: String,
+          object_id_: String,
+          recipients:
+            T::Array[
+              T.any(
+                String,
+                Knockapi::RecipientReference::ObjectReference::OrHash
+              )
+            ],
+          request_options: Knockapi::RequestOptions::OrHash
+        ).returns(T::Array[Knockapi::Recipients::Subscription])
+      end
+      def delete_subscriptions(
+        # The collection this object belongs to.
+        collection,
+        # Unique identifier for the object.
+        object_id_,
+        # The recipients of the subscription. You can subscribe up to 100 recipients to an
+        # object at a time.
+        recipients:,
+        request_options: {}
+      )
+      end
+
+      # Retrieves a specific object by its ID from the specified collection. Returns the
+      # object with all its properties.
+      sig do
+        params(
+          collection: String,
+          id: String,
+          request_options: Knockapi::RequestOptions::OrHash
+        ).returns(Knockapi::Object)
+      end
+      def get(
+        # The collection this object belongs to.
+        collection,
+        # Unique identifier for the object.
+        id,
+        request_options: {}
+      )
+      end
+
+      # Returns the channel data for the specified object and channel.
+      sig do
+        params(
+          collection: String,
+          object_id_: String,
+          channel_id: String,
+          request_options: Knockapi::RequestOptions::OrHash
+        ).returns(Knockapi::Recipients::RecipientsChannelData)
+      end
+      def get_channel_data(
+        # The collection this object belongs to.
+        collection,
+        # Unique identifier for the object.
+        object_id_,
+        # The unique identifier for the channel.
+        channel_id,
+        request_options: {}
+      )
+      end
+
+      # Returns the preference set for the specified object and preference set `id`.
+      sig do
+        params(
+          collection: String,
+          object_id_: String,
+          id: String,
+          request_options: Knockapi::RequestOptions::OrHash
+        ).returns(Knockapi::Recipients::PreferenceSet)
+      end
+      def get_preferences(
+        # The collection this object belongs to.
+        collection,
+        # Unique identifier for the object.
+        object_id_,
+        # Unique identifier for the preference set.
+        id,
+        request_options: {}
+      )
+      end
+
+      # Returns a paginated list of messages for a specific object in the given
+      # collection. Allows filtering by message status and provides various sorting
+      # options.
+      sig do
+        params(
+          collection: String,
+          id: String,
+          after: String,
+          before: String,
+          channel_id: String,
+          engagement_status:
+            T::Array[
+              Knockapi::ObjectListMessagesParams::EngagementStatus::OrSymbol
+            ],
+          inserted_at: Knockapi::ObjectListMessagesParams::InsertedAt::OrHash,
+          message_ids: T::Array[String],
+          page_size: Integer,
+          source: String,
+          status:
+            T::Array[Knockapi::ObjectListMessagesParams::Status::OrSymbol],
+          tenant: String,
+          trigger_data: String,
+          workflow_categories: T::Array[String],
+          workflow_recipient_run_id: String,
+          workflow_run_id: String,
+          request_options: Knockapi::RequestOptions::OrHash
+        ).returns(Knockapi::Internal::EntriesCursor[Knockapi::Message])
+      end
+      def list_messages(
+        # The collection this object belongs to.
+        collection,
+        # Unique identifier for the object.
+        id,
+        # The cursor to fetch entries after.
+        after: nil,
+        # The cursor to fetch entries before.
+        before: nil,
+        # Limits the results to items with the corresponding channel ID.
+        channel_id: nil,
+        # Limits the results to messages with the given engagement status.
+        engagement_status: nil,
+        inserted_at: nil,
+        # Limits the results to only the message IDs given (max 50). Note: when using this
+        # option, the results will be subject to any other filters applied to the query.
+        message_ids: nil,
+        # The number of items per page.
+        page_size: nil,
+        # Limits the results to messages triggered by the given workflow key.
+        source: nil,
+        # Limits the results to messages with the given delivery status.
+        status: nil,
+        # Limits the results to items with the corresponding tenant.
+        tenant: nil,
+        # Limits the results to only messages that were generated with the given data. See
+        # [trigger data filtering](/api-reference/overview/trigger-data-filtering) for
+        # more information.
+        trigger_data: nil,
+        # Limits the results to messages related to any of the provided categories.
+        workflow_categories: nil,
+        # Limits the results to messages for a specific recipient's workflow run.
+        workflow_recipient_run_id: nil,
+        # Limits the results to messages associated with the top-level workflow run ID
+        # returned by the workflow trigger request.
+        workflow_run_id: nil,
+        request_options: {}
+      )
+      end
+
+      # Returns a paginated list of preference sets for the specified object.
+      sig do
+        params(
+          collection: String,
+          object_id_: String,
+          request_options: Knockapi::RequestOptions::OrHash
+        ).returns(T::Array[Knockapi::Recipients::PreferenceSet])
+      end
+      def list_preferences(
+        # The collection this object belongs to.
+        collection,
+        # Unique identifier for the object.
+        object_id_,
+        request_options: {}
+      )
+      end
+
+      # Returns a paginated list of schedules for an object.
+      sig do
+        params(
+          collection: String,
+          id: String,
+          after: String,
+          before: String,
+          page_size: Integer,
+          tenant: String,
+          workflow: String,
+          request_options: Knockapi::RequestOptions::OrHash
+        ).returns(Knockapi::Internal::EntriesCursor[Knockapi::Schedule])
+      end
+      def list_schedules(
+        # The collection of the object to list schedules for.
+        collection,
+        # The ID of the object to list schedules for.
+        id,
+        # The cursor to fetch entries after.
+        after: nil,
+        # The cursor to fetch entries before.
+        before: nil,
+        # The number of items per page.
+        page_size: nil,
+        # Filter schedules by tenant id.
+        tenant: nil,
+        # Filter schedules by workflow id.
+        workflow: nil,
+        request_options: {}
+      )
+      end
+
+      # List subscriptions for an object. Either list the recipients that subscribe to
+      # the provided object, or list the objects that the provided object is subscribed
+      # to. Determined by the `mode` query parameter.
+      sig do
+        params(
+          collection: String,
+          object_id_: String,
+          after: String,
+          before: String,
+          include:
+            T::Array[
+              Knockapi::ObjectListSubscriptionsParams::Include::OrSymbol
+            ],
+          mode: Knockapi::ObjectListSubscriptionsParams::Mode::OrSymbol,
+          objects:
+            T::Array[Knockapi::ObjectListSubscriptionsParams::Object::OrHash],
+          page_size: Integer,
+          recipients:
+            T::Array[
+              T.any(
+                String,
+                Knockapi::RecipientReference::ObjectReference::OrHash
+              )
+            ],
+          request_options: Knockapi::RequestOptions::OrHash
+        ).returns(
+          Knockapi::Internal::EntriesCursor[Knockapi::Recipients::Subscription]
+        )
+      end
+      def list_subscriptions(
+        # The collection this object belongs to.
+        collection,
+        # Unique identifier for the object.
+        object_id_,
+        # The cursor to fetch entries after.
+        after: nil,
+        # The cursor to fetch entries before.
+        before: nil,
+        # Additional fields to include in the response.
+        include: nil,
+        # Mode of the request. `recipient` to list the objects that the provided object is
+        # subscribed to, `object` to list the recipients that subscribe to the provided
+        # object.
+        mode: nil,
+        # Objects to filter by (only used if mode is `recipient`).
+        objects: nil,
+        # The number of items per page.
+        page_size: nil,
+        # Recipients to filter by (only used if mode is `object`).
+        recipients: nil,
+        request_options: {}
+      )
+      end
+
+      # Creates a new object or updates an existing one in the specified collection.
+      # This operation is used to identify objects with their properties, as well as
+      # optional preferences and channel data.
+      sig do
+        params(
+          collection: String,
+          id: String,
+          channel_data:
+            T::Hash[
+              Symbol,
+              T.any(
+                Knockapi::Recipients::PushChannelData::OrHash,
+                Knockapi::Recipients::OneSignalChannelData::OrHash,
+                Knockapi::Recipients::SlackChannelData::OrHash,
+                Knockapi::Recipients::MsTeamsChannelData::OrHash,
+                Knockapi::Recipients::DiscordChannelData::OrHash
+              )
+            ],
+          locale: T.nilable(String),
+          preferences:
+            T::Hash[Symbol, Knockapi::Recipients::PreferenceSetRequest::OrHash],
+          timezone: T.nilable(String),
+          request_options: Knockapi::RequestOptions::OrHash
+        ).returns(Knockapi::Object)
+      end
+      def set(
+        # The collection this object belongs to.
+        collection,
+        # Unique identifier for the object.
+        id,
+        # A request to set channel data for a type of channel inline.
+        channel_data: nil,
+        # The locale of the object. Used for
+        # [message localization](/concepts/translations).
+        locale: nil,
+        # Inline set preferences for a recipient, where the key is the preference set id.
+        preferences: nil,
+        # The timezone of the object. Must be a
+        # valid [tz database time zone string](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones).
+        # Used
+        # for [recurring schedules](/concepts/schedules#scheduling-workflows-with-recurring-schedules-for-recipients).
+        timezone: nil,
+        request_options: {}
+      )
+      end
+
+      # Sets the channel data for the specified object and channel. If no object exists
+      # in the current environment for the given `collection` and `object_id`, Knock
+      # will create the object as part of this request.
+      sig do
+        params(
+          collection: String,
+          object_id_: String,
+          channel_id: String,
+          data:
+            T.any(
+              Knockapi::Recipients::PushChannelData::OrHash,
+              Knockapi::Recipients::OneSignalChannelData::OrHash,
+              Knockapi::Recipients::SlackChannelData::OrHash,
+              Knockapi::Recipients::MsTeamsChannelData::OrHash,
+              Knockapi::Recipients::DiscordChannelData::OrHash
+            ),
+          request_options: Knockapi::RequestOptions::OrHash
+        ).returns(Knockapi::Recipients::RecipientsChannelData)
+      end
+      def set_channel_data(
+        # The collection this object belongs to.
+        collection,
+        # Unique identifier for the object.
+        object_id_,
+        # The unique identifier for the channel.
+        channel_id,
+        # Channel data for a given channel type.
+        data:,
+        request_options: {}
+      )
+      end
+
+      # Sets preferences within the given preference set. This is a destructive
+      # operation and will replace any existing preferences with the preferences given.
+      # If no object exists in the current environment for the given `:collection` and
+      # `:object_id`, Knock will create the object as part of this request. The
+      # preference set `:id` can be either `default` or a `tenant.id`. Learn more about
+      # [per-tenant preferences](/preferences/tenant-preferences).
+      sig do
+        params(
+          collection: String,
+          object_id_: String,
+          id: String,
+          categories:
+            T.nilable(
+              T::Hash[
+                Symbol,
+                T.any(
+                  T::Boolean,
+                  Knockapi::Recipients::PreferenceSetRequest::Category::PreferenceSetWorkflowCategorySettingObject::OrHash
+                )
+              ]
+            ),
+          channel_types:
+            T.nilable(Knockapi::Recipients::PreferenceSetChannelTypes::OrHash),
+          workflows:
+            T.nilable(
+              T::Hash[
+                Symbol,
+                T.any(
+                  T::Boolean,
+                  Knockapi::Recipients::PreferenceSetRequest::Workflow::PreferenceSetWorkflowCategorySettingObject::OrHash
+                )
+              ]
+            ),
+          request_options: Knockapi::RequestOptions::OrHash
+        ).returns(Knockapi::Recipients::PreferenceSet)
+      end
+      def set_preferences(
+        # The collection this object belongs to.
+        collection,
+        # Unique identifier for the object.
+        object_id_,
+        # Unique identifier for the preference set.
+        id,
+        # An object where the key is the category and the values are the preference
+        # settings for that category.
+        categories: nil,
+        # Channel type preferences.
+        channel_types: nil,
+        # An object where the key is the workflow key and the values are the preference
+        # settings for that workflow.
+        workflows: nil,
+        request_options: {}
+      )
+      end
+
+      # Unsets the channel data for the specified object and channel.
+      sig do
+        params(
+          collection: String,
+          object_id_: String,
+          channel_id: String,
+          request_options: Knockapi::RequestOptions::OrHash
+        ).returns(String)
+      end
+      def unset_channel_data(
+        # The collection this object belongs to.
+        collection,
+        # Unique identifier for the object.
+        object_id_,
+        # The unique identifier for the channel.
+        channel_id,
+        request_options: {}
+      )
+      end
+
+      # @api private
+      sig { params(client: Knockapi::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/knockapi/resources/providers/ms_teams.rbi

@@ -0,0 +1,98 @@
+# typed: strong
+
+module Knockapi
+  module Resources
+    class Providers
+      class MsTeams
+        # Check if a connection to Microsoft Teams has been authorized for a given
+        # Microsoft Teams tenant object.
+        sig do
+          params(
+            channel_id: String,
+            ms_teams_tenant_object: String,
+            request_options: Knockapi::RequestOptions::OrHash
+          ).returns(Knockapi::Models::Providers::MsTeamCheckAuthResponse)
+        end
+        def check_auth(
+          # The ID of the Knock Microsoft Teams channel to check.
+          channel_id,
+          # A JSON encoded string containing the Microsoft Teams tenant object reference.
+          ms_teams_tenant_object:,
+          request_options: {}
+        )
+        end
+
+        # List the Microsoft Teams channels within a team. By default, archived and
+        # private channels are excluded from the results.
+        sig do
+          params(
+            channel_id: String,
+            ms_teams_tenant_object: String,
+            team_id: String,
+            query_options:
+              Knockapi::Providers::MsTeamListChannelsParams::QueryOptions::OrHash,
+            request_options: Knockapi::RequestOptions::OrHash
+          ).returns(Knockapi::Models::Providers::MsTeamListChannelsResponse)
+        end
+        def list_channels(
+          # The ID of the Knock Microsoft Teams channel to get channels for.
+          channel_id,
+          # A JSON encoded string containing the Microsoft Teams tenant object reference.
+          ms_teams_tenant_object:,
+          # Microsoft Teams team ID.
+          team_id:,
+          query_options: nil,
+          request_options: {}
+        )
+        end
+
+        # Get a list of teams belonging to the Microsoft Entra tenant. By default,
+        # archived and private channels are excluded from the results.
+        sig do
+          params(
+            channel_id: String,
+            ms_teams_tenant_object: String,
+            query_options:
+              Knockapi::Providers::MsTeamListTeamsParams::QueryOptions::OrHash,
+            request_options: Knockapi::RequestOptions::OrHash
+          ).returns(
+            Knockapi::Internal::MsTeamsPagination[
+              Knockapi::Models::Providers::MsTeamListTeamsResponse
+            ]
+          )
+        end
+        def list_teams(
+          # The ID of the Knock Microsoft Teams channel to get teams for.
+          channel_id,
+          # A JSON encoded string containing the Microsoft Teams tenant object reference.
+          ms_teams_tenant_object:,
+          query_options: nil,
+          request_options: {}
+        )
+        end
+
+        # Remove a Microsoft Entra tenant ID from a Microsoft Teams tenant object.
+        sig do
+          params(
+            channel_id: String,
+            ms_teams_tenant_object: String,
+            request_options: Knockapi::RequestOptions::OrHash
+          ).returns(Knockapi::Models::Providers::MsTeamRevokeAccessResponse)
+        end
+        def revoke_access(
+          # The ID of the Knock Microsoft Teams channel to revoke access for.
+          channel_id,
+          # A JSON encoded string containing the Microsoft Teams tenant object reference.
+          ms_teams_tenant_object:,
+          request_options: {}
+        )
+        end
+
+        # @api private
+        sig { params(client: Knockapi::Client).returns(T.attached_class) }
+        def self.new(client:)
+        end
+      end
+    end
+  end
+end

data/rbi/knockapi/resources/providers/slack.rbi

@@ -0,0 +1,72 @@
+# typed: strong
+
+module Knockapi
+  module Resources
+    class Providers
+      class Slack
+        # Check if a Slack channel is authenticated.
+        sig do
+          params(
+            channel_id: String,
+            access_token_object: String,
+            request_options: Knockapi::RequestOptions::OrHash
+          ).returns(Knockapi::Models::Providers::SlackCheckAuthResponse)
+        end
+        def check_auth(
+          # The ID of the Knock Slack channel to check.
+          channel_id,
+          # A JSON encoded string containing the access token object reference.
+          access_token_object:,
+          request_options: {}
+        )
+        end
+
+        # List Slack channels for a Slack workspace.
+        sig do
+          params(
+            channel_id: String,
+            access_token_object: String,
+            query_options:
+              Knockapi::Providers::SlackListChannelsParams::QueryOptions::OrHash,
+            request_options: Knockapi::RequestOptions::OrHash
+          ).returns(
+            Knockapi::Internal::SlackChannelsCursor[
+              Knockapi::Models::Providers::SlackListChannelsResponse
+            ]
+          )
+        end
+        def list_channels(
+          # The ID of the Knock Slack channel to get channels for.
+          channel_id,
+          # A JSON encoded string containing the access token object reference.
+          access_token_object:,
+          query_options: nil,
+          request_options: {}
+        )
+        end
+
+        # Revoke access for a Slack channel.
+        sig do
+          params(
+            channel_id: String,
+            access_token_object: String,
+            request_options: Knockapi::RequestOptions::OrHash
+          ).returns(Knockapi::Models::Providers::SlackRevokeAccessResponse)
+        end
+        def revoke_access(
+          # The ID of the Knock Slack channel to revoke access for.
+          channel_id,
+          # A JSON encoded string containing the access token object reference.
+          access_token_object:,
+          request_options: {}
+        )
+        end
+
+        # @api private
+        sig { params(client: Knockapi::Client).returns(T.attached_class) }
+        def self.new(client:)
+        end
+      end
+    end
+  end
+end

data/rbi/knockapi/resources/providers.rbi

@@ -0,0 +1,18 @@
+# typed: strong
+
+module Knockapi
+  module Resources
+    class Providers
+      sig { returns(Knockapi::Resources::Providers::Slack) }
+      attr_reader :slack
+
+      sig { returns(Knockapi::Resources::Providers::MsTeams) }
+      attr_reader :ms_teams
+
+      # @api private
+      sig { params(client: Knockapi::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/knockapi/resources/recipients/channel_data.rbi

@@ -0,0 +1,14 @@
+# typed: strong
+
+module Knockapi
+  module Resources
+    class Recipients
+      class ChannelData
+        # @api private
+        sig { params(client: Knockapi::Client).returns(T.attached_class) }
+        def self.new(client:)
+        end
+      end
+    end
+  end
+end