import "github.com/gemini-oss/rego/pkg/slack"

const (
    // SCIMBaseURL is the base URL for Slack SCIM 2.0 API (separate from Web API)
    SCIMBaseURL = "https://api.slack.com/scim/v2"

    // SCIM User endpoints
    // https://docs.slack.dev/reference/scim-api/users
    SCIMUsers = "%s/Users" // https://docs.slack.dev/reference/scim-api/users
)

const (
    BaseURL      = "https://slack.com/api"          // https://slack.com/api/METHOD_FAMILY.method?pretty=1
    AuditBaseURL = "https://api.slack.com/audit/v1" // AuditBaseURL is the base URL for Slack Audit Logs API (separate from Web API)
)

var (
    // Admin User endpoints (Tier 2 - 20/min)
    // https://api.slack.com/methods#admin.users
    AdminUsersList       = fmt.Sprintf("%s/admin.users.list", BaseURL)
    AdminUsersAssign     = fmt.Sprintf("%s/admin.users.assign", BaseURL)
    AdminUsersInvite     = fmt.Sprintf("%s/admin.users.invite", BaseURL)
    AdminUsersRemove     = fmt.Sprintf("%s/admin.users.remove", BaseURL)
    AdminUsersSetAdmin   = fmt.Sprintf("%s/admin.users.setAdmin", BaseURL)
    AdminUsersSetOwner   = fmt.Sprintf("%s/admin.users.setOwner", BaseURL)
    AdminUsersSetRegular = fmt.Sprintf("%s/admin.users.setRegular", BaseURL)

    // Admin Session endpoints
    // https://api.slack.com/methods#admin.users.session
    AdminUsersSessionReset      = fmt.Sprintf("%s/admin.users.session.reset", BaseURL)
    AdminUsersSessionResetBulk  = fmt.Sprintf("%s/admin.users.session.resetBulk", BaseURL)
    AdminUsersSessionInvalidate = fmt.Sprintf("%s/admin.users.session.invalidate", BaseURL)
    AdminUsersSessionList       = fmt.Sprintf("%s/admin.users.session.list", BaseURL)

    // Admin Teams endpoints
    // https://api.slack.com/methods#admin.teams
    AdminTeams       = fmt.Sprintf("%s/admin.teams.list", BaseURL)
    AdminTeamsCreate = fmt.Sprintf("%s/admin.teams.create", BaseURL)
)

var (
    // Audit Logs endpoints (Tier 3 - 50/min, org-wide)
    // https://docs.slack.dev/reference/audit-logs-api/methods-actions-reference
    AuditLogs    = "%s/logs"    // GET https://api.slack.com/audit/v1/logs
    AuditSchemas = "%s/schemas" // GET https://api.slack.com/audit/v1/schemas
    AuditActions = "%s/actions" // GET https://api.slack.com/audit/v1/actions
)

var (
    // Chat endpoints (Special rate limits - 1 msg/sec per channel)
    // https://api.slack.com/methods#chat
    ChatPostMessage   = fmt.Sprintf("%s/chat.postMessage", BaseURL)
    ChatUpdate        = fmt.Sprintf("%s/chat.update", BaseURL)
    ChatDelete        = fmt.Sprintf("%s/chat.delete", BaseURL)
    ChatPostEphemeral = fmt.Sprintf("%s/chat.postEphemeral", BaseURL)
    ChatGetPermalink  = fmt.Sprintf("%s/chat.getPermalink", BaseURL)
)

var (
    // User endpoints (Tier 3 - 50/min)
    // https://api.slack.com/methods#users
    SlackUsers              = fmt.Sprintf("%s/users.list", BaseURL)
    SlackUsersInfo          = fmt.Sprintf("%s/users.info", BaseURL)
    SlackUsersLookupByEmail = fmt.Sprintf("%s/users.lookupByEmail", BaseURL)
    SlackUsersConversations = fmt.Sprintf("%s/users.conversations", BaseURL)
    SlackUsersSetPresence   = fmt.Sprintf("%s/users.setPresence", BaseURL)
)

var ErrorDetails = map[string]string{
    "as_user_not_supported":                    "The as_user parameter does not function with workspace apps.",
    "channel_not_found":                        "Value passed for channel was invalid.",
    "duplicate_channel_not_found":              "Channel associated with client_msg_id was invalid.",
    "duplicate_message_not_found":              "No duplicate message exists associated with client_msg_id.",
    "ekm_access_denied":                        "Administrators have suspended the ability to post a message.",
    "invalid_blocks":                           "Blocks submitted with this message are not valid",
    "invalid_blocks_format":                    "The blocks is not a valid JSON object or doesn't match the Block Kit syntax.",
    "invalid_metadata_format":                  "Invalid metadata format provided",
    "invalid_metadata_schema":                  "Invalid metadata schema provided",
    "is_archived":                              "Channel has been archived.",
    "message_limit_exceeded":                   "Members on this team are sending too many messages. For more details, see https://slack.com/help/articles/115002422943-Usage-limits-for-free-workspaces",
    "messages_tab_disabled":                    "Messages tab for the app is disabled.",
    "metadata_must_be_sent_from_app":           "Message metadata can only be posted or updated using an app token",
    "metadata_too_large":                       "Metadata exceeds size limit",
    "msg_too_long":                             "Message text is too long",
    "no_text":                                  "No message text provided",
    "not_in_channel":                           "Cannot post user messages to a channel they are not in.",
    "rate_limited":                             "Application has posted too many messages, read the Rate Limit documentation for more information",
    "restricted_action":                        "A workspace preference prevents the authenticated user from posting.",
    "restricted_action_non_threadable_channel": "Cannot post thread replies into a non_threadable channel.",
    "restricted_action_read_only_channel":      "Cannot post any message into a read-only channel.",
    "restricted_action_thread_locked":          "Cannot post replies to a thread that has been locked by admins.",
    "restricted_action_thread_only_channel":    "Cannot post top-level messages into a thread-only channel.",
    "slack_connect_canvas_sharing_blocked":     "Admin has disabled Canvas File sharing in all Slack Connect communications",
    "slack_connect_file_link_sharing_blocked":  "Admin has disabled Slack File sharing in all Slack Connect communications",
    "team_access_not_granted":                  "The token used is not granted the specific workspace access required to complete this request.",
    "too_many_attachments":                     "Too many attachments were provided with this message. A maximum of 100 attachments are allowed on a message.",
    "too_many_contact_cards":                   "Too many contact_cards were provided with this message. A maximum of 10 contact cards are allowed on a message.",
    "cannot_reply_to_message":                  "This message type cannot have thread replies.",
    "access_denied":                            "Access to a resource specified in the request is denied.",
    "account_inactive":                         "Authentication token is for a deleted user or workspace when using a bot token.",
    "deprecated_endpoint":                      "The endpoint has been deprecated.",
    "enterprise_is_restricted":                 "The method cannot be called from an Enterprise.",
    "invalid_auth":                             "Some aspect of authentication cannot be validated. Either the provided token is invalid or the request originates from an IP address disallowed from making the request.",
    "method_deprecated":                        "The method has been deprecated.",
    "missing_scope":                            "The token used is not granted the specific scope permissions required to complete this request.",
    "not_allowed_token_type":                   "The token type used in this request is not allowed.",
    "not_authed":                               "No authentication token provided.",
    "no_permission":                            "The workspace token used in this request does not have the permissions necessary to complete the request. Make sure your app is a member of the conversation it's attempting to post a message to.",
    "org_login_required":                       "The workspace is undergoing an enterprise migration and will not be available until migration is complete.",
    "token_expired":                            "Authentication token has expired",
    "token_revoked":                            "Authentication token is for a deleted user or workspace or the app has been removed when using a user token.",
    "two_factor_setup_required":                "Two factor setup is required.",
    "accesslimited":                            "Access to this method is limited on the current network",
    "fatal_error":                              "The server could not complete your operation(s) without encountering a catastrophic error. It's possible some aspect of the operation succeeded before the error was raised.",
    "internal_error":                           "The server could not complete your operation(s) without encountering an error, likely due to a transient issue on our end. It's possible some aspect of the operation succeeded before the error was raised.",
    "invalid_arg_name":                         "The method was passed an argument whose name falls outside the bounds of accepted or expected values. This includes very long names and names with non-alphanumeric characters other than _. If you get this error, it is typically an indication that you have made a very malformed API call.",
    "invalid_arguments":                        "The method was either called with invalid arguments or some detail about the arguments passed is invalid, which is more likely when using complex arguments like blocks or attachments.",
    "invalid_array_arg":                        "The method was passed an array as an argument. Please only input valid strings.",
    "invalid_charset":                          "The method was called via a POST request, but the charset specified in the Content-Type header was invalid. Valid charset names are: utf-8 iso-8859-1.",
    "invalid_form_data":                        "The method was called via a POST request with Content-Type application/x-www-form-urlencoded or multipart/form-data, but the form data was either missing or syntactically invalid.",
    "invalid_post_type":                        "The method was called via a POST request, but the specified Content-Type was invalid. Valid types are: application/json application/x-www-form-urlencoded multipart/form-data text/plain.",
    "missing_post_type":                        "The method was called via a POST request and included a data payload, but the request did not include a Content-Type header.",
    "ratelimited":                              "The request has been ratelimited. Refer to the Retry-After header for when you may make your next request.",
    "request_timeout":                          "The method was called via a POST request, but the POST data was either missing or truncated.",
    "service_unavailable":                      "The service is temporarily unavailable",
    "team_added_to_org":                        "The workspace associated with your request is currently undergoing migration to an Enterprise Organization. Web API and other platform operations will be intermittently unavailable until the transition is complete.",
    "user_access_not_granted":                  "The user token used in this request does not have the permissions necessary to complete the request.",
}

var WarningDetails = map[string]string{
    "message_truncated":   "The text field of a message should have no more than 40,000 characters. We truncate really long messages.",
    "missing_charset":     "The method was called via a POST request, and recommended practice for the specified Content-Type is to include a charset parameter. However, no charset was present. Specifically, non-form-data content types (e.g. text/plain) are the ones for which charset is recommended.",
    "superfluous_charset": "The method was called via a POST request, and the specified Content-Type is not defined to understand the charset parameter. However, charset was in fact present. Specifically, form-data content types (e.g. multipart/form-data) are the ones for which charset is superfluous.",
}

type AdminClient struct {
    *Client
}

func (c *AdminClient) ListActiveUsers(teamID string) (*AdminUsers, error)

func (c *AdminClient) ListAllUsers(teamID string) (*AdminUsers, error)

func (c *AdminClient) ResetUserSession(userID string, opts ...SessionResetOption) error

func (c *AdminClient) ResetUserSessionsBulk(userIDs []string, opts ...SessionResetOption) error

type AdminUser struct {
    ID                string   `json:"id"`                      // User ID
    Email             string   `json:"email"`                   // User email
    IsAdmin           bool     `json:"is_admin"`                // Whether user is admin
    IsOwner           bool     `json:"is_owner"`                // Whether user is owner
    IsPrimaryOwner    bool     `json:"is_primary_owner"`        // Whether user is primary owner
    IsRestricted      bool     `json:"is_restricted"`           // Whether user is a guest
    IsUltraRestricted bool     `json:"is_ultra_restricted"`     // Whether user is a single-channel guest
    IsBot             bool     `json:"is_bot"`                  // Whether user is a bot
    IsActive          bool     `json:"is_active"`               // Whether user is active
    Username          string   `json:"username"`                // User's username
    FullName          string   `json:"full_name,omitempty"`     // User's full name
    DateCreated       int64    `json:"date_created,omitempty"`  // Account creation timestamp
    ExpirationTS      int64    `json:"expiration_ts,omitempty"` // Guest expiration timestamp
    HasFiles          bool     `json:"has_files,omitempty"`     // Whether user has files
    Has2FA            bool     `json:"has_2fa,omitempty"`       // Whether user has 2FA enabled
    Workspaces        []string `json:"workspaces,omitempty"`    // Workspaces user belongs to
}

type AdminUserQuery struct {
    Cursor                           string `json:"cursor,omitempty" url:"cursor,omitempty"`                                                           // Pagination cursor
    IsActive                         *bool  `json:"is_active,omitempty" url:"is_active,omitempty"`                                                     // Filter by active status
    Limit                            int    `json:"limit,omitempty" url:"limit,omitempty"`                                                             // Max 1000, default 100
    TeamID                           string `json:"team_id,omitempty" url:"team_id,omitempty"`                                                         // Required: Workspace ID
    IncludeDeactivatedUserWorkspaces bool   `json:"include_deactivated_user_workspaces,omitempty" url:"include_deactivated_user_workspaces,omitempty"` // Include deactivated
}

func (q *AdminUserQuery) SetCursor(cursor string)

type AdminUsers struct {
    OK               bool             `json:"ok"`
    Users            []*AdminUser     `json:"users,omitempty"`
    ResponseMetadata ResponseMetadata `json:"response_metadata,omitzero"`
    Error            string           `json:"error,omitempty"`
}

func (a AdminUsers) Append(other AdminUsers) AdminUsers

func (a AdminUsers) NextCursor() string

type AuditAccountTypeRole struct {
    ID   string `json:"id,omitempty"`   // Account type role ID
    Name string `json:"name,omitempty"` // Account type role name
}

type AuditActionsResponse struct {
    Actions map[string][]string `json:"actions,omitempty"` // Actions grouped by category
}

type AuditActor struct {
    Type string     `json:"type,omitempty"` // Always "user"
    User *AuditUser `json:"user,omitempty"` // User details
}

type AuditApp struct {
    ID                  string   `json:"id,omitempty"`                    // App ID
    Name                string   `json:"name,omitempty"`                  // App name
    IsDistributed       bool     `json:"is_distributed,omitempty"`        // Whether the app is distributed
    IsDirectoryApproved bool     `json:"is_directory_approved,omitempty"` // Whether the app is directory-approved
    IsWorkflowApp       bool     `json:"is_workflow_app,omitempty"`       // Whether this is a workflow app
    Scopes              []string `json:"scopes,omitempty"`                // OAuth scopes
}

type AuditChannel struct {
    ID                         string   `json:"id,omitempty"`                            // Channel ID
    Privacy                    string   `json:"privacy,omitempty"`                       // Channel privacy (public, private)
    Name                       string   `json:"name,omitempty"`                          // Channel name
    IsShared                   bool     `json:"is_shared,omitempty"`                     // Whether the channel is shared
    IsOrgShared                bool     `json:"is_org_shared,omitempty"`                 // Whether the channel is org-shared
    TeamsSharedWith            []string `json:"teams_shared_with,omitempty"`             // Teams shared with
    OriginalConnectedChannelID string   `json:"original_connected_channel_id,omitempty"` // Original connected channel ID
    IsSalesforceChannel        bool     `json:"is_salesforce_channel,omitempty"`         // Whether this is a Salesforce channel
}

type AuditClient struct {
    *Client
    AuditBaseURL string
}

func (c *AuditClient) BuildURL(endpoint string, identifiers ...interface{}) string

func (c *AuditClient) FindByUserAgent(pattern string, oldest, latest int64) (*AuditLogsResponse, error)

func (c *AuditClient) FindEmojiByName(name string, oldest, latest int64) (*AuditLogsResponse, error)

func (c *AuditClient) GetActions() (*AuditActionsResponse, error)

func (c *AuditClient) GetAllLogs(query *AuditQuery) (*AuditLogsResponse, error)

func (c *AuditClient) GetEmojiChanges(oldest, latest int64) (*AuditLogsResponse, error)

func (c *AuditClient) GetLogs(query *AuditQuery) (*AuditLogsResponse, error)

func (c *AuditClient) GetSchemas() (*AuditSchemasResponse, error)

type AuditContext struct {
    Location  *AuditLocation `json:"location,omitempty"`   // Workspace or enterprise where the action occurred
    UA        string         `json:"ua,omitempty"`         // User agent string
    IPAddress string         `json:"ip_address,omitempty"` // IP address of the actor
    SessionID int64          `json:"session_id,omitempty"` // Session identifier
    App       *AuditApp      `json:"app,omitempty"`        // App details if action was performed via an app
}

type AuditConversationPref struct {
    Type []string `json:"type,omitempty"` // Preference types
    User []string `json:"user,omitempty"` // User IDs
}

type AuditDetails struct {
    // Value changes
    Name          string `json:"name,omitempty"`           // Name associated with the event
    NewValue      string `json:"new_value,omitempty"`      // New value after the change
    PreviousValue string `json:"previous_value,omitempty"` // Previous value before the change

    // Session/Access
    ExpiresOn  int64 `json:"expires_on,omitempty"`  // Expiration timestamp
    MobileOnly bool  `json:"mobile_only,omitempty"` // Whether action applies to mobile only
    WebOnly    bool  `json:"web_only,omitempty"`    // Whether action applies to web only

    // Type/Classification
    Type       string `json:"type,omitempty"`        // Type of the detail
    IsWorkflow bool   `json:"is_workflow,omitempty"` // Whether related to a workflow

    // User references
    Inviter      *AuditUser `json:"inviter,omitempty"`        // User who sent the invitation
    Kicker       *AuditUser `json:"kicker,omitempty"`         // User who kicked another user
    TargetUser   string     `json:"target_user,omitempty"`    // Target user ID
    TargetUserID string     `json:"target_user_id,omitempty"` // Target user ID (alternate field)

    // Sharing/Collaboration
    SharedTo        string               `json:"shared_to,omitempty"`        // Where something was shared to
    Reason          generics.StringSlice `json:"reason,omitempty"`           // Reason for the action (string or array depending on action type)
    OriginTeam      string               `json:"origin_team,omitempty"`      // Origin team ID
    TargetTeam      string               `json:"target_team,omitempty"`      // Target team ID
    SourceTeam      string               `json:"source_team,omitempty"`      // Source team ID
    DestinationTeam string               `json:"destination_team,omitempty"` // Destination team ID

    // App/Scope changes
    AppOwnerID     string   `json:"app_owner_id,omitempty"`    // App owner's user ID
    AppID          string   `json:"app_id,omitempty"`          // App ID
    BotScopes      []string `json:"bot_scopes,omitempty"`      // Bot token scopes
    NewScopes      []string `json:"new_scopes,omitempty"`      // Newly granted scopes
    PreviousScopes []string `json:"previous_scopes,omitempty"` // Previously granted scopes
    Scopes         []string `json:"scopes,omitempty"`          // Current scopes

    // Channel/Conversation
    Channels   []string               `json:"channels,omitempty"`     // Affected channel IDs
    ChannelID  string                 `json:"channel_id,omitempty"`   // Channel ID
    WhoCanPost *AuditConversationPref `json:"who_can_post,omitempty"` // Who can post preference
    CanThread  *AuditConversationPref `json:"can_thread,omitempty"`   // Thread preference

    // Permissions
    Permissions        []string `json:"permissions,omitempty"`         // Permissions involved
    ChangedPermissions []string `json:"changed_permissions,omitempty"` // Changed permissions
    Resolution         string   `json:"resolution,omitempty"`          // Resolution of the action

    // Feature toggles
    EnableAtHere    *AuditFeatureEnable `json:"enable_at_here,omitempty"`    // @here enablement
    EnableAtChannel *AuditFeatureEnable `json:"enable_at_channel,omitempty"` // @channel enablement
    CanHuddle       *AuditFeatureEnable `json:"can_huddle,omitempty"`        // Huddle enablement

    // Retention policies
    OldRetentionPolicy *AuditRetentionPolicy `json:"old_retention_policy,omitempty"` // Previous retention policy
    NewRetentionPolicy *AuditRetentionPolicy `json:"new_retention_policy,omitempty"` // New retention policy

    // Profile changes
    PreviousProfile *AuditProfile `json:"previous_profile,omitempty"` // Previous profile
    NewProfile      *AuditProfile `json:"new_profile,omitempty"`      // New profile

    // External/Slack Connect
    ExternalOrgID     string `json:"external_organization_id,omitempty"` // External organization ID
    ExternalUserID    string `json:"external_user_id,omitempty"`         // External user ID
    ExternalUserEmail string `json:"external_user_email,omitempty"`      // External user email

    // Misc references
    Trigger              string      `json:"trigger,omitempty"`                // Trigger for the action
    ExportType           string      `json:"export_type,omitempty"`            // Type of export
    Duration             int64       `json:"duration,omitempty"`               // Duration of the action
    InviteID             string      `json:"invite_id,omitempty"`              // Invitation ID
    AddedTeamID          string      `json:"added_team_id,omitempty"`          // Added team ID
    URLPrivate           string      `json:"url_private,omitempty"`            // Private URL
    SucceededUsers       []string    `json:"succeeded_users,omitempty"`        // Users that succeeded
    FailedUsers          []string    `json:"failed_users,omitempty"`           // Users that failed
    Enterprise           string      `json:"enterprise,omitempty"`             // Enterprise ID
    Subteam              string      `json:"subteam,omitempty"`                // Subteam ID
    Action               string      `json:"action,omitempty"`                 // Sub-action
    IDPGroupMemberCount  int         `json:"idp_group_member_count,omitempty"` // IDP group member count
    WorkspaceMemberCount int         `json:"workspace_member_count,omitempty"` // Workspace member count
    IDPConfigID          interface{} `json:"idp_config_id,omitempty"`          // IDP config ID (number or string depending on action)
    ConfigType           string      `json:"config_type,omitempty"`            // Config type
    Label                string      `json:"label,omitempty"`                  // Label
    SpaceFileID          string      `json:"space_file_id,omitempty"`          // Space file ID
    TargetEntity         string      `json:"target_entity,omitempty"`          // Target entity
    TargetEntityID       string      `json:"target_entity_id,omitempty"`       // Target entity ID
    DatastoreName        string      `json:"datastore_name,omitempty"`         // Datastore name
    EntityType           string      `json:"entity_type,omitempty"`            // Entity type
    AccessLevel          string      `json:"access_level,omitempty"`           // Access level
    IsChannelCanvas      bool        `json:"is_channel_canvas,omitempty"`      // Whether this is a channel canvas
    LinkedChannelID      string      `json:"linked_channel_id,omitempty"`      // Linked channel ID
}

type AuditEntity struct {
    Type            string                   `json:"type,omitempty"`              // Entity type (user, channel, file, app, workspace, enterprise, message, huddle, barrier, role, account_type_role, workflow, workflow_v2, usergroup, list)
    User            *AuditUser               `json:"user,omitempty"`              // User entity
    Workspace       *AuditLocation           `json:"workspace,omitempty"`         // Workspace entity
    Enterprise      *AuditLocation           `json:"enterprise,omitempty"`        // Enterprise entity
    Channel         *AuditChannel            `json:"channel,omitempty"`           // Channel entity
    File            *AuditFile               `json:"file,omitempty"`              // File entity
    App             *AuditApp                `json:"app,omitempty"`               // App entity
    Message         *AuditMessage            `json:"message,omitempty"`           // Message entity
    Huddle          *AuditHuddle             `json:"huddle,omitempty"`            // Huddle entity
    Role            *AuditRole               `json:"role,omitempty"`              // Role entity
    Usergroup       *AuditUsergroup          `json:"usergroup,omitempty"`         // User group entity
    Workflow        *AuditWorkflow           `json:"workflow,omitempty"`          // Workflow entity
    Barrier         *AuditInformationBarrier `json:"barrier,omitempty"`           // Information barrier entity
    WorkflowV2      *AuditWorkflowV2         `json:"workflow_v2,omitempty"`       // Workflow v2 entity
    AccountTypeRole *AuditAccountTypeRole    `json:"account_type_role,omitempty"` // Account type role entity
    List            *AuditSlackList          `json:"list,omitempty"`              // Slack list entity
}

type AuditEntry struct {
    ID         string        `json:"id,omitempty"`          // Unique identifier for the audit event
    DateCreate int64         `json:"date_create,omitempty"` // Unix timestamp of when the event occurred
    Action     string        `json:"action,omitempty"`      // The action that was performed (e.g., "user_login", "emoji_added")
    Actor      AuditActor    `json:"actor,omitzero"`        // The user who performed the action
    Entity     AuditEntity   `json:"entity,omitzero"`       // The object acted upon
    Context    AuditContext  `json:"context,omitzero"`      // The location where the action took place
    Details    *AuditDetails `json:"details,omitempty"`     // Additional event-specific details
}

type AuditFeatureEnable struct {
    Enabled bool `json:"enabled,omitempty"` // Whether the feature is enabled
}

type AuditFile struct {
    ID       string `json:"id,omitempty"`       // File ID
    Name     string `json:"name,omitempty"`     // File name
    Filetype string `json:"filetype,omitempty"` // File type
    Title    string `json:"title,omitempty"`    // File title
}

type AuditHuddle struct {
    ID           string   `json:"id,omitempty"`           // Huddle ID
    DateStart    int64    `json:"date_start,omitempty"`   // Start timestamp
    DateEnd      int64    `json:"date_end,omitempty"`     // End timestamp
    Participants []string `json:"participants,omitempty"` // Participant user IDs
}

type AuditInformationBarrier struct {
    ID                      string   `json:"id,omitempty"`                        // Barrier ID
    PrimaryUsergroup        string   `json:"primary_usergroup,omitempty"`         // Primary user group
    BarrieredFromUsergroups []string `json:"barriered_from_usergroups,omitempty"` // Barriered from user groups
    RestrictedSubjects      []string `json:"restricted_subjects,omitempty"`       // Restricted subjects
}

type AuditLocation struct {
    Type   string `json:"type,omitempty"`   // "workspace" or "enterprise"
    ID     string `json:"id,omitempty"`     // Workspace/enterprise ID
    Name   string `json:"name,omitempty"`   // Workspace/enterprise name
    Domain string `json:"domain,omitempty"` // Workspace/enterprise domain
}

type AuditLogsResponse struct {
    Entries          []AuditEntry     `json:"entries,omitempty"`          // Audit log entries
    ResponseMetadata ResponseMetadata `json:"response_metadata,omitzero"` // Pagination cursor
}

func (a AuditLogsResponse) Append(other AuditLogsResponse) AuditLogsResponse

func (a AuditLogsResponse) NextCursor() string

type AuditMessage struct {
    Channel   string `json:"channel,omitempty"`   // Channel ID
    Team      string `json:"team,omitempty"`      // Team ID
    Timestamp string `json:"timestamp,omitempty"` // Message timestamp
}

type AuditProfile struct {
    RealName    string `json:"real_name,omitempty"`    // Real name
    FirstName   string `json:"first_name,omitempty"`   // First name
    LastName    string `json:"last_name,omitempty"`    // Last name
    DisplayName string `json:"display_name,omitempty"` // Display name
}

type AuditQuery struct {
    Latest int64  `url:"latest,omitempty"` // Unix timestamp (inclusive) for most recent event
    Oldest int64  `url:"oldest,omitempty"` // Unix timestamp (inclusive) for oldest event
    Limit  int    `url:"limit,omitempty"`  // Results to return, maximum 9,999
    Action string `url:"action,omitempty"` // Action name(s), comma-separated (max 30)
    Actor  string `url:"actor,omitempty"`  // User ID who initiated the action
    Entity string `url:"entity,omitempty"` // Target entity ID (channel, workspace, file, etc.)
    Cursor string `url:"cursor,omitempty"` // Pagination cursor from response_metadata.next_cursor
}

func (q *AuditQuery) SetCursor(cursor string)

type AuditRetentionPolicy struct {
    Type         string `json:"type,omitempty"`          // Retention policy type
    DurationDays int    `json:"duration_days,omitempty"` // Duration in days
}

type AuditRole struct {
    ID   string `json:"id,omitempty"`   // Role ID
    Name string `json:"name,omitempty"` // Role name
    Type string `json:"type,omitempty"` // Role type
}

type AuditSchema struct {
    Type       string      `json:"type,omitempty"`       // Entity type name
    Workspace  interface{} `json:"workspace,omitempty"`  // Workspace schema fields
    Enterprise interface{} `json:"enterprise,omitempty"` // Enterprise schema fields
}

type AuditSchemasResponse struct {
    Schemas []AuditSchema `json:"schemas,omitempty"` // Schema definitions
}

type AuditSlackList struct {
    ID string `json:"id,omitempty"` // List ID
}

type AuditUser struct {
    ID    string `json:"id,omitempty"`    // User ID (e.g., W123AB456)
    Name  string `json:"name,omitempty"`  // User's display name
    Email string `json:"email,omitempty"` // User's email address
    Team  string `json:"team,omitempty"`  // Team/workspace ID
}

type AuditUsergroup struct {
    ID   string `json:"id,omitempty"`   // User group ID
    Name string `json:"name,omitempty"` // User group name
}

type AuditWorkflow struct {
    ID     string `json:"id,omitempty"`     // Workflow ID
    Name   string `json:"name,omitempty"`   // Workflow name
    Domain string `json:"domain,omitempty"` // Workflow domain
}

type AuditWorkflowV2 struct {
    ID          string `json:"id,omitempty"`           // Workflow ID
    AppID       string `json:"app_id,omitempty"`       // Associated app ID
    DateUpdated int64  `json:"date_updated,omitempty"` // Last updated timestamp
    CallbackID  string `json:"callback_id,omitempty"`  // Callback ID
    Name        string `json:"name,omitempty"`         // Workflow name
    UpdatedBy   string `json:"updated_by,omitempty"`   // User who last updated
}

type Authorization struct {
    EnterpriseID        interface{} `json:"enterprise_id,omitempty"`         // ID of the enterprise (undefined, will revisit later)
    TeamID              string      `json:"team_id,omitempty"`               // ID of the team/workspace
    UserID              string      `json:"user_id,omitempty"`               // ID of the user or bot user in the workspace
    IsBot               bool        `json:"is_bot,omitempty"`                // Indicates whether this is a bot user
    IsEnterpriseInstall bool        `json:"is_enterprise_install,omitempty"` // Indicates whether this app was installed in an entire enterprise org
}

type Block struct {
    Type     string    `json:"type,omitempty"`     // Type of the block, here it's rich_text
    BlockID  string    `json:"block_id,omitempty"` // ID of the block
    Elements []Element `json:"elements,omitzero"`  // Elements in the block
}

type Channel struct {
    Created            int64         `json:"created"`                   // Channel creation timestamp.
    Creator            string        `json:"creator"`                   // User ID of the channel's creator.
    ID                 string        `json:"id"`                        // Channel ID.
    IsArchived         bool          `json:"is_archived"`               // Indicates if the channel is archived.
    IsChannel          bool          `json:"is_channel"`                // Indicates if the object is a channel.
    IsExtShared        bool          `json:"is_ext_shared"`             // Indicates if the channel is externally shared.
    IsGeneral          bool          `json:"is_general"`                // Indicates if the channel is a general channel.
    IsGroup            bool          `json:"is_group"`                  // Indicates if the object is a group.
    IsIM               bool          `json:"is_im"`                     // Indicates if the object is an instant message.
    IsMPIM             bool          `json:"is_mpim"`                   // Indicates if the object is a multi-party instant message.
    IsOpen             bool          `json:"is_open,omitempty"`         // Indicates if the channel is open. Only applicable for certain channel types.
    IsOrgShared        bool          `json:"is_org_shared"`             // Indicates if the channel is organizationally shared.
    IsPendingExtShared bool          `json:"is_pending_ext_shared"`     // Indicates if the channel is pending external sharing.
    IsPrivate          bool          `json:"is_private"`                // Indicates if the channel is private.
    IsShared           bool          `json:"is_shared"`                 // Indicates if the channel is shared.
    IsUserDeleted      bool          `json:"is_user_deleted,omitempty"` // Indicates if the user is deleted. Only applicable for certain channel types.
    Name               string        `json:"name"`                      // Channel name.
    NameNormalized     string        `json:"name_normalized"`           // Normalized channel name.
    PendingShared      []interface{} `json:"pending_shared"`            // List of pending shared channel IDs.
    Priority           float64       `json:"priority,omitempty"`        // Channel priority.
    PreviousNames      []string      `json:"previous_names"`            // List of previous names for the channel.
    Purpose            Purpose       `json:"purpose"`                   // Purpose information of the channel.
    Topic              Topic         `json:"topic"`                     // Topic information of the channel.
    Unlinked           int           `json:"unlinked"`                  // Unlinked count of the channel.
    User               string        `json:"user,omitempty"`            // User ID associated with the channel. Only applicable for certain channel types.
}

type ChatClient struct {
    *Client
}

func (c *ChatClient) DeleteMessage(channel, ts string) error

func (c *ChatClient) GetPermalink(channel, messageTS string) (string, error)

func (c *ChatClient) PostEphemeral(channel, userID, text string) (*ChatResponse, error)

func (c *ChatClient) PostMessage(message *SlackMessage) (*ChatResponse, error)

func (c *ChatClient) UpdateMessage(channel, ts, text string) (*ChatResponse, error)

type ChatResponse struct {
    OK        bool   `json:"ok"`                   // Response status
    Channel   string `json:"channel,omitempty"`    // Channel ID where message was posted
    TS        string `json:"ts,omitempty"`         // Timestamp of the message
    MessageTS string `json:"message_ts,omitempty"` // Alias for ts in some responses
    Error     string `json:"error,omitempty"`      // Error message if not OK
    Warning   string `json:"warning,omitempty"`    // Warning message
}

type Client struct {
    BaseURL       string           // BaseURL is the base URL for Slack API requests.
    BotID         string           // The ID of the bot in current workspace
    HTTP          *requests.Client // HTTP client used to make HTTP requests.
    Error         *Error           // Error is the error response from the last request made by the client.
    Log           *log.Logger      // Log is the logger used to log information about the client.
    Token         string           // Authentication token for the Slack API.
    SigningSecret string           // Signing secret for bots
    Cache         *cache.Cache     // Cache is the cache used to store responses from the Slack API.
    // contains filtered or unexported fields
}

func NewClient(verbosity int) *Client

func (c *Client) Admin() *AdminClient

func (c *Client) Audit() *AuditClient

func (c *Client) BuildURL(endpoint string, identifiers ...interface{}) string

func (c *Client) Chat() *ChatClient

func (c *Client) CommandHandler(w http.ResponseWriter, r *http.Request)

func (c *Client) EventHandler(w http.ResponseWriter, r *http.Request)

func (c *Client) GetBotID() (string, error)

func (c *Client) GetCache(key string, target any) bool

func (c *Client) ResetRateLimiters()

func (c *Client) SCIM() *SCIMClient

func (c *Client) SendMessage(e *Event, m *SlackMessage) error

func (c *Client) SendReply(e *Event, m *SlackMessage) error

func (c *Client) SetCache(key string, value any, duration time.Duration)

func (c *Client) Users() *UsersClient

func (c *Client) VerifyRequest(r *http.Request, body []byte) bool

type ConversationQuery struct {
    Cursor          string `url:"cursor,omitempty"`           // Paginate through collections by setting the cursor parameter to a next_cursor attribute returned by a previous request's response_metadata
    ExcludeArchived bool   `url:"exclude_archived,omitempty"` // Set to true to exclude archived channels from the list
    Limit           int    `url:"limit,omitempty"`            // The maximum number of items to return, up to 999 (recommended: no more than 200)
    TeamID          string `url:"team_id,omitempty"`          // Encoded team id to list conversations in, required if org token is used
    Types           string `url:"types,omitempty"`            // Mix and match channel types by providing a comma-separated list (e.g., "im,mpim,public_channel,private_channel")
    User            string `url:"user,omitempty"`             // Browse conversations by a specific user ID's membership
}

func (q *ConversationQuery) SetCursor(cursor string)

type Element struct {
    Type     string         `json:"type,omitempty"`     // Type of the element, here it's rich_text_section
    Elements []InnerElement `json:"elements,omitempty"` // Inner elements in the element
}

type Error struct {
    Ok    bool   `json:"ok,omitempty"`    // Indicates whether the request was successful.
    Error string `json:"error,omitempty"` // Describes the error that occurred.
}

type Event struct {
    ClientMsgID string  `json:"client_msg_id,omitempty"` // Client-specified ID for this message
    Type        string  `json:"type,omitempty"`          // Type of the event, here it's app_mention
    Text        string  `json:"text,omitempty"`          // Text in the message that mentions the app
    User        string  `json:"user,omitempty"`          // ID of the user that sent this message
    TS          string  `json:"ts,omitempty"`            // Timestamp when this message was sent
    Blocks      []Block `json:"blocks,omitempty"`        // Blocks in the message
    Team        string  `json:"team,omitempty"`          // ID of the team/workspace where this event occurred
    Channel     string  `json:"channel,omitempty"`       // ID of the channel where this event occurred
    EventTS     string  `json:"event_ts,omitempty"`      // Timestamp when this event happened
}

type EventCallback struct {
    Token              string          `json:"token,omitempty"`                 // Verification token to verify that the incoming request is from Slack
    TeamID             string          `json:"team_id,omitempty"`               // ID of the team/workspace where the event occurred
    APIAppID           string          `json:"api_app_id,omitempty"`            // App ID of the app that has been installed in this workspace
    Type               string          `json:"type,omitempty"`                  // Type of the callback, it's always event_callback
    Event              Event           `json:"event,omitzero"`                  // Details of the event
    EventID            string          `json:"event_id,omitempty"`              // Globally unique ID for this event
    EventTime          int64           `json:"event_time,omitempty"`            // Time when the event happened
    Authorizations     []Authorization `json:"authorizations,omitempty"`        // Information about the authorizations for this workspace and event
    IsExtSharedChannel bool            `json:"is_ext_shared_channel,omitempty"` // Indicates whether the event is in a shared channel
    EventContext       string          `json:"event_context,omitempty"`         // Event context (undefined, will revisit later)
}

type InnerElement struct {
    Type   string `json:"type,omitempty"`    // Type of the inner element, it can be user or text
    UserID string `json:"user_id,omitempty"` // ID of the user, this field is present when the type is user
    Text   string `json:"text,omitempty"`    // Text of the inner element, this field is present when the type is text
}

type Member struct {
    Color             string  `json:"color,omitempty"`               // Member's color code.
    Deleted           bool    `json:"deleted,omitempty"`             // Whether the member is deleted.
    Has2FA            bool    `json:"has_2fa,omitempty"`             // Whether the member has two-factor authentication enabled.
    ID                string  `json:"id"`                            // Member's unique identifier.
    IsAdmin           bool    `json:"is_admin,omitempty"`            // Whether the member is an administrator.
    IsAppUser         bool    `json:"is_app_user,omitempty"`         // Whether the member is an app user.
    IsBot             bool    `json:"is_bot,omitempty"`              // Whether the member is a bot.
    IsOwner           bool    `json:"is_owner,omitempty"`            // Whether the member is an owner.
    IsPrimaryOwner    bool    `json:"is_primary_owner,omitempty"`    // Whether the member is the primary owner.
    IsRestricted      bool    `json:"is_restricted,omitempty"`       // Whether the member is restricted.
    IsUltraRestricted bool    `json:"is_ultra_restricted,omitempty"` // Whether the member is ultra-restricted.
    Name              string  `json:"name"`                          // Member's username.
    Profile           Profile `json:"profile,omitzero"`              // Member's profile information.
    RealName          string  `json:"real_name,omitempty"`           // Member's real name.
    TeamID            string  `json:"team_id"`                       // Team identifier.
    TZ                string  `json:"tz,omitempty"`                  // Member's time zone.
    TzLabel           string  `json:"tz_label,omitempty"`            // Label for the time zone.
    TzOffset          int     `json:"tz_offset,omitempty"`           // Time zone offset in seconds.
    Updated           int64   `json:"updated,omitempty"`             // Timestamp for when the member was updated.
}

type Metadata struct {
    NextCursor string `json:"next_cursor,omitempty"` // Next cursor for pagination.
}