organization

type AcceptInvitationRequest struct {
	Token string `json:"token" description:"Invitation token"`
}

type AddMemberRequest struct {
	OrgID  string `path:"orgId" description:"Organization identifier"`
	UserID string `json:"user_id" description:"User identifier to add"`
	Role   string `json:"role,omitempty" description:"Member role (owner, admin, member)"`
}

type AdminListOrgsRequest struct {
	AppID string `query:"app_id" description:"Application ID"`
}

type CheckSlugRequest struct {
	AppID string `query:"app_id" description:"Application ID"`
	Slug  string `query:"slug" description:"Slug to check"`
}

type Config struct {
	// PathPrefix is the HTTP path prefix for organization routes.
	// Defaults to the engine's BasePath.
	PathPrefix string

	// InvitationTTL is how long an invitation can be accepted after it is
	// created. Zero means DefaultInvitationTTL (seven days). A negative value
	// turns expiry off, so invitations never lapse, which was the behaviour
	// before this option existed.
	InvitationTTL time.Duration

	// InvitationURLTemplate is the link an invitation email carries, with
	// {token} standing in for the invitation token, for example
	// "https://app.example.com/accept-invite?token={token}". Empty (the
	// default) means the plugin sends no invitation email, which was the
	// behaviour before this option existed. Mail goes through the plugin
	// registered as "notification"; without one nothing is sent either.
	InvitationURLTemplate string

	// RoleRanks gives role names other than owner, admin and member a rank
	// for the checks that compare roles: who may read or change an
	// organization, grant a role, or remove a member. Keys are lower case
	// names; values are on the built-in scale, member 1, admin 2, owner 3,
	// so {"builder": 1} lets a builder do what a member can and nothing
	// more. A name not listed ranks 0, below member, which is how every
	// custom role was treated before this option existed. The built-in names
	// cannot be changed here. Be careful with 2 or 3: a role ranked as admin
	// passes every admin-level check in this plugin.
	RoleRanks map[string]int
}

type CreateInvitationRequest struct {
	OrgID string `path:"orgId" description:"Organization identifier"`
	Email string `json:"email" description:"Email address to invite"`
	Role  string `json:"role,omitempty" description:"Member role (owner, admin, member)"`
}

type CreateOrgRequest struct {
	AppID string `json:"app_id,omitempty" description:"Application ID (optional, uses default)"`
	Name  string `json:"name" description:"Organization name"`
	Slug  string `json:"slug" description:"URL-safe slug"`
	Logo  string `json:"logo,omitempty" description:"Organization logo URL"`
}

type CreateTeamRequest struct {
	OrgID string `path:"orgId" description:"Organization identifier"`
	Name  string `json:"name" description:"Team name"`
	Slug  string `json:"slug" description:"URL-safe team slug"`
}

type DeclineInvitationRequest struct {
	Token string `json:"token" description:"Invitation token"`
}

type DeleteOrgRequest struct {
	OrgID string `path:"orgId" description:"Organization identifier"`
}

type DeleteTeamRequest struct {
	OrgID  string `path:"orgId" description:"Organization identifier"`
	TeamID string `path:"teamId" description:"Team identifier"`
}

type GetInvitationRequest struct {
	Token string `path:"inviteToken" description:"Invitation token"`
}

type GetOrgRequest struct {
	OrgID string `path:"orgId" description:"Organization identifier"`
}

type GetTeamRequest struct {
	OrgID  string `path:"orgId" description:"Organization identifier"`
	TeamID string `path:"teamId" description:"Team identifier"`
}

type InvitationListResponse struct {
	Invitations any `json:"invitations" description:"List of invitations"`
	// NextCursor is set when more remain; pass it as cursor to continue.
	NextCursor string `json:"next_cursor,omitempty" description:"Cursor for the next page, absent on the last"`
}

type InvitationPreview struct {
	OrgID       string    `json:"org_id" description:"Organization the invitation is for"`
	OrgName     string    `json:"org_name" description:"Organization's display name"`
	OrgSlug     string    `json:"org_slug,omitempty" description:"Organization's slug"`
	InviterName string    `json:"inviter_name" description:"Who sent the invitation"`
	Role        string    `json:"role" description:"Role the invitee will hold"`
	EmailMasked string    `json:"email_masked" description:"Partially masked invited address"`
	ExpiresAt   time.Time `json:"expires_at" description:"When the invitation stops working"`
}

type ListInvitationsRequest struct {
	OrgID  string `path:"orgId" description:"Organization identifier"`
	Limit  int    `query:"limit" description:"Page size (default 50, max 200)" optional:"true"`
	Cursor string `query:"cursor" description:"Cursor from the previous page's next_cursor" optional:"true"`
}

type ListMembersRequest struct {
	OrgID  string `path:"orgId" description:"Organization identifier"`
	Limit  int    `query:"limit" description:"Page size (default 50, max 200)" optional:"true"`
	Cursor string `query:"cursor" description:"Cursor from the previous page's next_cursor" optional:"true"`
}

type ListOrgsRequest struct {
	Limit  int    `query:"limit" description:"Page size (default 50, max 200)" optional:"true"`
	Cursor string `query:"cursor" description:"Cursor from the previous page's next_cursor" optional:"true"`
}

type ListTeamsRequest struct {
	OrgID  string `path:"orgId" description:"Organization identifier"`
	Limit  int    `query:"limit" description:"Page size (default 50, max 200)" optional:"true"`
	Cursor string `query:"cursor" description:"Cursor from the previous page's next_cursor" optional:"true"`
}

type MemberListResponse struct {
	Members any `json:"members" description:"List of members"`
	// NextCursor is set when more remain; pass it as cursor to continue.
	NextCursor string `json:"next_cursor,omitempty" description:"Cursor for the next page, absent on the last"`
}

type OrgListResponse struct {
	Organizations any `json:"organizations" description:"List of organizations"`
	// NextCursor is set when more remain; pass it as cursor to continue.
	NextCursor string `json:"next_cursor,omitempty" description:"Cursor for the next page, absent on the last"`
}

type Plugin struct {
	// contains filtered or unexported fields
}

type RemoveMemberRequest struct {
	OrgID    string `path:"orgId" description:"Organization identifier"`
	MemberID string `path:"memberId" description:"Member identifier"`
}

type ResendInvitationRequest struct {
	OrgID        string `path:"orgId" description:"Organization identifier"`
	InvitationID string `path:"invitationId" description:"Invitation identifier"`
}

type RevokeInvitationRequest struct {
	OrgID        string `path:"orgId" description:"Organization identifier"`
	InvitationID string `path:"invitationId" description:"Invitation identifier"`
}

type SlugAvailableResponse struct {
	Available bool `json:"available" description:"Whether the slug is available"`
}

type StatusResponse struct {
	Status string `json:"status" description:"Operation status"`
}

type TeamListResponse struct {
	Teams any `json:"teams" description:"List of teams"`
	// NextCursor is set when more remain; pass it as cursor to continue.
	NextCursor string `json:"next_cursor,omitempty" description:"Cursor for the next page, absent on the last"`
}

type UpdateMemberRequest struct {
	OrgID    string `path:"orgId" description:"Organization identifier"`
	MemberID string `path:"memberId" description:"Member identifier"`
	Role     string `json:"role" description:"New member role (owner, admin, member)"`
}

type UpdateOrgRequest struct {
	OrgID string  `path:"orgId" description:"Organization identifier"`
	Name  *string `json:"name,omitempty" description:"Organization name"`
	Logo  *string `json:"logo,omitempty" description:"Organization logo URL"`
}

type UpdateTeamRequest struct {
	OrgID  string  `path:"orgId" description:"Organization identifier"`
	TeamID string  `path:"teamId" description:"Team identifier"`
	Name   *string `json:"name,omitempty" description:"Team name"`
	Slug   *string `json:"slug,omitempty" description:"URL-safe team slug"`
}