knockapi 0.6.1 → 1.0.0

data/lib/knockapi/resources/providers/ms_teams.rb

@@ -0,0 +1,122 @@
+# frozen_string_literal: true
+
+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.
+        #
+        # @overload check_auth(channel_id, ms_teams_tenant_object:, request_options: {})
+        #
+        # @param channel_id [String] The ID of the Knock Microsoft Teams channel to check.
+        #
+        # @param ms_teams_tenant_object [String] A JSON encoded string containing the Microsoft Teams tenant object reference.
+        #
+        # @param request_options [Knockapi::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Knockapi::Models::Providers::MsTeamCheckAuthResponse]
+        #
+        # @see Knockapi::Models::Providers::MsTeamCheckAuthParams
+        def check_auth(channel_id, params)
+          parsed, options = Knockapi::Models::Providers::MsTeamCheckAuthParams.dump_request(params)
+          @client.request(
+            method: :get,
+            path: ["v1/providers/ms-teams/%1$s/auth_check", channel_id],
+            query: parsed,
+            model: Knockapi::Models::Providers::MsTeamCheckAuthResponse,
+            options: options
+          )
+        end
+
+        # List the Microsoft Teams channels within a team. By default, archived and
+        # private channels are excluded from the results.
+        #
+        # @overload list_channels(channel_id, ms_teams_tenant_object:, team_id:, query_options: nil, request_options: {})
+        #
+        # @param channel_id [String] The ID of the Knock Microsoft Teams channel to get channels for.
+        #
+        # @param ms_teams_tenant_object [String] A JSON encoded string containing the Microsoft Teams tenant object reference.
+        #
+        # @param team_id [String] Microsoft Teams team ID.
+        #
+        # @param query_options [Knockapi::Models::Providers::MsTeamListChannelsParams::QueryOptions]
+        #
+        # @param request_options [Knockapi::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Knockapi::Models::Providers::MsTeamListChannelsResponse]
+        #
+        # @see Knockapi::Models::Providers::MsTeamListChannelsParams
+        def list_channels(channel_id, params)
+          parsed, options = Knockapi::Models::Providers::MsTeamListChannelsParams.dump_request(params)
+          @client.request(
+            method: :get,
+            path: ["v1/providers/ms-teams/%1$s/channels", channel_id],
+            query: parsed,
+            model: Knockapi::Models::Providers::MsTeamListChannelsResponse,
+            options: options
+          )
+        end
+
+        # Get a list of teams belonging to the Microsoft Entra tenant. By default,
+        # archived and private channels are excluded from the results.
+        #
+        # @overload list_teams(channel_id, ms_teams_tenant_object:, query_options: nil, request_options: {})
+        #
+        # @param channel_id [String] The ID of the Knock Microsoft Teams channel to get teams for.
+        #
+        # @param ms_teams_tenant_object [String] A JSON encoded string containing the Microsoft Teams tenant object reference.
+        #
+        # @param query_options [Knockapi::Models::Providers::MsTeamListTeamsParams::QueryOptions]
+        #
+        # @param request_options [Knockapi::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Knockapi::Internal::MsTeamsPagination<Knockapi::Models::Providers::MsTeamListTeamsResponse>]
+        #
+        # @see Knockapi::Models::Providers::MsTeamListTeamsParams
+        def list_teams(channel_id, params)
+          parsed, options = Knockapi::Models::Providers::MsTeamListTeamsParams.dump_request(params)
+          @client.request(
+            method: :get,
+            path: ["v1/providers/ms-teams/%1$s/teams", channel_id],
+            query: parsed,
+            page: Knockapi::Internal::MsTeamsPagination,
+            model: Knockapi::Models::Providers::MsTeamListTeamsResponse,
+            options: options
+          )
+        end
+
+        # Remove a Microsoft Entra tenant ID from a Microsoft Teams tenant object.
+        #
+        # @overload revoke_access(channel_id, ms_teams_tenant_object:, request_options: {})
+        #
+        # @param channel_id [String] The ID of the Knock Microsoft Teams channel to revoke access for.
+        #
+        # @param ms_teams_tenant_object [String] A JSON encoded string containing the Microsoft Teams tenant object reference.
+        #
+        # @param request_options [Knockapi::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Knockapi::Models::Providers::MsTeamRevokeAccessResponse]
+        #
+        # @see Knockapi::Models::Providers::MsTeamRevokeAccessParams
+        def revoke_access(channel_id, params)
+          parsed, options = Knockapi::Models::Providers::MsTeamRevokeAccessParams.dump_request(params)
+          @client.request(
+            method: :put,
+            path: ["v1/providers/ms-teams/%1$s/revoke_access", channel_id],
+            query: parsed,
+            model: Knockapi::Models::Providers::MsTeamRevokeAccessResponse,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Knockapi::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/knockapi/resources/providers/slack.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+module Knockapi
+  module Resources
+    class Providers
+      class Slack
+        # Check if a Slack channel is authenticated.
+        #
+        # @overload check_auth(channel_id, access_token_object:, request_options: {})
+        #
+        # @param channel_id [String] The ID of the Knock Slack channel to check.
+        #
+        # @param access_token_object [String] A JSON encoded string containing the access token object reference.
+        #
+        # @param request_options [Knockapi::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Knockapi::Models::Providers::SlackCheckAuthResponse]
+        #
+        # @see Knockapi::Models::Providers::SlackCheckAuthParams
+        def check_auth(channel_id, params)
+          parsed, options = Knockapi::Models::Providers::SlackCheckAuthParams.dump_request(params)
+          @client.request(
+            method: :get,
+            path: ["v1/providers/slack/%1$s/auth_check", channel_id],
+            query: parsed,
+            model: Knockapi::Models::Providers::SlackCheckAuthResponse,
+            options: options
+          )
+        end
+
+        # List Slack channels for a Slack workspace.
+        #
+        # @overload list_channels(channel_id, access_token_object:, query_options: nil, request_options: {})
+        #
+        # @param channel_id [String] The ID of the Knock Slack channel to get channels for.
+        #
+        # @param access_token_object [String] A JSON encoded string containing the access token object reference.
+        #
+        # @param query_options [Knockapi::Models::Providers::SlackListChannelsParams::QueryOptions]
+        #
+        # @param request_options [Knockapi::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Knockapi::Internal::SlackChannelsCursor<Knockapi::Models::Providers::SlackListChannelsResponse>]
+        #
+        # @see Knockapi::Models::Providers::SlackListChannelsParams
+        def list_channels(channel_id, params)
+          parsed, options = Knockapi::Models::Providers::SlackListChannelsParams.dump_request(params)
+          @client.request(
+            method: :get,
+            path: ["v1/providers/slack/%1$s/channels", channel_id],
+            query: parsed,
+            page: Knockapi::Internal::SlackChannelsCursor,
+            model: Knockapi::Models::Providers::SlackListChannelsResponse,
+            options: options
+          )
+        end
+
+        # Revoke access for a Slack channel.
+        #
+        # @overload revoke_access(channel_id, access_token_object:, request_options: {})
+        #
+        # @param channel_id [String] The ID of the Knock Slack channel to revoke access for.
+        #
+        # @param access_token_object [String] A JSON encoded string containing the access token object reference.
+        #
+        # @param request_options [Knockapi::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Knockapi::Models::Providers::SlackRevokeAccessResponse]
+        #
+        # @see Knockapi::Models::Providers::SlackRevokeAccessParams
+        def revoke_access(channel_id, params)
+          parsed, options = Knockapi::Models::Providers::SlackRevokeAccessParams.dump_request(params)
+          @client.request(
+            method: :put,
+            path: ["v1/providers/slack/%1$s/revoke_access", channel_id],
+            query: parsed,
+            model: Knockapi::Models::Providers::SlackRevokeAccessResponse,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Knockapi::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/knockapi/resources/providers.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Knockapi
+  module Resources
+    class Providers
+      # @return [Knockapi::Resources::Providers::Slack]
+      attr_reader :slack
+
+      # @return [Knockapi::Resources::Providers::MsTeams]
+      attr_reader :ms_teams
+
+      # @api private
+      #
+      # @param client [Knockapi::Client]
+      def initialize(client:)
+        @client = client
+        @slack = Knockapi::Resources::Providers::Slack.new(client: client)
+        @ms_teams = Knockapi::Resources::Providers::MsTeams.new(client: client)
+      end
+    end
+  end
+end

data/lib/knockapi/resources/recipients/channel_data.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Knockapi
+  module Resources
+    class Recipients
+      class ChannelData
+        # @api private
+        #
+        # @param client [Knockapi::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/knockapi/resources/recipients/preferences.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Knockapi
+  module Resources
+    class Recipients
+      class Preferences
+        # @api private
+        #
+        # @param client [Knockapi::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/knockapi/resources/recipients/subscriptions.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Knockapi
+  module Resources
+    class Recipients
+      class Subscriptions
+        # @api private
+        #
+        # @param client [Knockapi::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/knockapi/resources/recipients.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Knockapi
+  module Resources
+    class Recipients
+      # @return [Knockapi::Resources::Recipients::Subscriptions]
+      attr_reader :subscriptions
+
+      # @return [Knockapi::Resources::Recipients::Preferences]
+      attr_reader :preferences
+
+      # @return [Knockapi::Resources::Recipients::ChannelData]
+      attr_reader :channel_data
+
+      # @api private
+      #
+      # @param client [Knockapi::Client]
+      def initialize(client:)
+        @client = client
+        @subscriptions = Knockapi::Resources::Recipients::Subscriptions.new(client: client)
+        @preferences = Knockapi::Resources::Recipients::Preferences.new(client: client)
+        @channel_data = Knockapi::Resources::Recipients::ChannelData.new(client: client)
+      end
+    end
+  end
+end

data/lib/knockapi/resources/schedules/bulk.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module Knockapi
+  module Resources
+    class Schedules
+      class Bulk
+        # Bulk creates up to 1,000 schedules at a time. This endpoint also handles
+        # [inline identifications](/managing-recipients/identifying-recipients#inline-identifying-recipients)
+        # for the `actor`, `recipient`, and `tenant` fields.
+        #
+        # @overload create(schedules:, request_options: {})
+        #
+        # @param schedules [Array<Knockapi::Models::Schedules::BulkCreateParams::Schedule>] A list of schedules.
+        #
+        # @param request_options [Knockapi::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Knockapi::Models::BulkOperation]
+        #
+        # @see Knockapi::Models::Schedules::BulkCreateParams
+        def create(params)
+          parsed, options = Knockapi::Models::Schedules::BulkCreateParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: "v1/schedules/bulk/create",
+            body: parsed,
+            model: Knockapi::Models::BulkOperation,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Knockapi::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/knockapi/resources/schedules.rb

@@ -0,0 +1,159 @@
+# frozen_string_literal: true
+
+module Knockapi
+  module Resources
+    class Schedules
+      # @return [Knockapi::Resources::Schedules::Bulk]
+      attr_reader :bulk
+
+      # Some parameter documentations has been truncated, see
+      # {Knockapi::Models::ScheduleCreateParams} for more details.
+      #
+      # Creates one or more schedules for a workflow with the specified recipients,
+      # timing, and data. Schedules can be one-time or recurring. This endpoint also
+      # handles
+      # [inline identifications](/managing-recipients/identifying-recipients#inline-identifying-recipients)
+      # for the `actor`, `recipient`, and `tenant` fields.
+      #
+      # @overload create(recipients:, repeats:, workflow:, data: nil, ending_at: nil, scheduled_at: nil, tenant: nil, request_options: {})
+      #
+      # @param recipients [Array<String, Knockapi::Models::InlineIdentifyUserRequest, Knockapi::Models::InlineObjectRequest>] The recipients to trigger the workflow for. Can inline identify users, objects,
+      # ...
+      #
+      # @param repeats [Array<Knockapi::Models::ScheduleRepeatRule>] The repeat rule for the schedule.
+      #
+      # @param workflow [String] The key of the workflow.
+      #
+      # @param data [Hash{Symbol=>Object}, nil] An optional map of data to pass into the workflow execution.
+      #
+      # @param ending_at [Time, nil] The ending date and time for the schedule.
+      #
+      # @param scheduled_at [Time, nil] The starting date and time for the schedule.
+      #
+      # @param tenant [String, Knockapi::Models::TenantRequest, nil] An request to set a tenant inline.
+      #
+      # @param request_options [Knockapi::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Array<Knockapi::Models::Schedule>]
+      #
+      # @see Knockapi::Models::ScheduleCreateParams
+      def create(params)
+        parsed, options = Knockapi::Models::ScheduleCreateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "v1/schedules",
+          body: parsed,
+          model: Knockapi::Internal::Type::ArrayOf[Knockapi::Models::Schedule],
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Knockapi::Models::ScheduleUpdateParams} for more details.
+      #
+      # Updates one or more existing schedules with new timing, data, or other
+      # properties. All specified schedule IDs will be updated with the same values.
+      # This endpoint also handles
+      # [inline identifications](/managing-recipients/identifying-recipients#inline-identifying-recipients)
+      # for the `actor`, `recipient`, and `tenant` fields.
+      #
+      # @overload update(schedule_ids:, actor: nil, data: nil, ending_at: nil, repeats: nil, scheduled_at: nil, tenant: nil, request_options: {})
+      #
+      # @param schedule_ids [Array<String>] A list of schedule IDs.
+      #
+      # @param actor [String, Knockapi::Models::RecipientReference::ObjectReference, nil] A reference to a recipient, either a user identifier (string) or an object refer
+      # ...
+      #
+      # @param data [Hash{Symbol=>Object}, nil] An optional map of data to pass into the workflow execution.
+      #
+      # @param ending_at [Time, nil] The ending date and time for the schedule.
+      #
+      # @param repeats [Array<Knockapi::Models::ScheduleRepeatRule>] The repeat rule for the schedule.
+      #
+      # @param scheduled_at [Time, nil] The starting date and time for the schedule.
+      #
+      # @param tenant [String, Knockapi::Models::TenantRequest, nil] An request to set a tenant inline.
+      #
+      # @param request_options [Knockapi::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Array<Knockapi::Models::Schedule>]
+      #
+      # @see Knockapi::Models::ScheduleUpdateParams
+      def update(params)
+        parsed, options = Knockapi::Models::ScheduleUpdateParams.dump_request(params)
+        @client.request(
+          method: :put,
+          path: "v1/schedules",
+          body: parsed,
+          model: Knockapi::Internal::Type::ArrayOf[Knockapi::Models::Schedule],
+          options: options
+        )
+      end
+
+      # Returns a paginated list of schedules for the current environment, filtered by
+      # workflow and optionally by recipients and tenant.
+      #
+      # @overload list(workflow:, after: nil, before: nil, page_size: nil, recipients: nil, tenant: nil, request_options: {})
+      #
+      # @param workflow [String] Filter by workflow key.
+      #
+      # @param after [String] The cursor to fetch entries after.
+      #
+      # @param before [String] The cursor to fetch entries before.
+      #
+      # @param page_size [Integer] The number of items per page.
+      #
+      # @param recipients [Array<String>] Filter by recipient IDs.
+      #
+      # @param tenant [String] Filter by tenant ID.
+      #
+      # @param request_options [Knockapi::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Knockapi::Internal::EntriesCursor<Knockapi::Models::Schedule>]
+      #
+      # @see Knockapi::Models::ScheduleListParams
+      def list(params)
+        parsed, options = Knockapi::Models::ScheduleListParams.dump_request(params)
+        @client.request(
+          method: :get,
+          path: "v1/schedules",
+          query: parsed,
+          page: Knockapi::Internal::EntriesCursor,
+          model: Knockapi::Models::Schedule,
+          options: options
+        )
+      end
+
+      # Permanently deletes one or more schedules identified by the provided schedule
+      # IDs. This operation cannot be undone.
+      #
+      # @overload delete(schedule_ids:, request_options: {})
+      #
+      # @param schedule_ids [Array<String>] A list of schedule IDs.
+      #
+      # @param request_options [Knockapi::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Array<Knockapi::Models::Schedule>]
+      #
+      # @see Knockapi::Models::ScheduleDeleteParams
+      def delete(params)
+        parsed, options = Knockapi::Models::ScheduleDeleteParams.dump_request(params)
+        @client.request(
+          method: :delete,
+          path: "v1/schedules",
+          body: parsed,
+          model: Knockapi::Internal::Type::ArrayOf[Knockapi::Models::Schedule],
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Knockapi::Client]
+      def initialize(client:)
+        @client = client
+        @bulk = Knockapi::Resources::Schedules::Bulk.new(client: client)
+      end
+    end
+  end
+end

data/lib/knockapi/resources/shared.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Knockapi
+  module Resources
+    class Shared
+      # @api private
+      #
+      # @param client [Knockapi::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/knockapi/resources/tenants/bulk.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+module Knockapi
+  module Resources
+    class Tenants
+      class Bulk
+        # Delete multiple tenants in a single operation. This operation cannot be undone.
+        #
+        # @overload delete(tenant_ids:, request_options: {})
+        #
+        # @param tenant_ids [Array<String>] The IDs of the tenants to delete.
+        #
+        # @param request_options [Knockapi::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Knockapi::Models::BulkOperation]
+        #
+        # @see Knockapi::Models::Tenants::BulkDeleteParams
+        def delete(params)
+          parsed, options = Knockapi::Models::Tenants::BulkDeleteParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: "v1/tenants/bulk/delete",
+            query: parsed,
+            model: Knockapi::Models::BulkOperation,
+            options: options
+          )
+        end
+
+        # Set or update up to 1,000 tenants in a single operation.
+        #
+        # @overload set(tenants:, request_options: {})
+        #
+        # @param tenants [Array<String, Knockapi::Models::TenantRequest>] The tenants to be upserted.
+        #
+        # @param request_options [Knockapi::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Knockapi::Models::BulkOperation]
+        #
+        # @see Knockapi::Models::Tenants::BulkSetParams
+        def set(params)
+          parsed, options = Knockapi::Models::Tenants::BulkSetParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: "v1/tenants/bulk/set",
+            body: parsed,
+            model: Knockapi::Models::BulkOperation,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Knockapi::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end