basecamp

type APIProvenance struct {
	BC3    UpstreamRef `json:"bc3"`
	BC3API UpstreamRef `json:"bc3_api"`
}

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

type AnswerListOptions struct {
	// Limit is the maximum number of answers to return.
	// If 0 (default), returns all answers. Use a positive value to cap results.
	Limit int

	// Page, if non-zero, disables pagination and returns only the first page.
	// NOTE: The page number itself is not yet honored due to OpenAPI client
	// limitations. Use 0 to paginate through all results up to Limit.
	Page int
}

type AnswerListResult struct {
	// Answers is the list of answers returned.
	Answers []QuestionAnswer
	// Meta contains pagination metadata (total count, etc.).
	Meta ListMeta
}

type Assignable struct {
	ID        int64    `json:"id"`
	Title     string   `json:"title"`
	Type      string   `json:"type"`
	URL       string   `json:"url"`
	AppURL    string   `json:"app_url"`
	Bucket    *Bucket  `json:"bucket,omitempty"`
	Parent    *Parent  `json:"parent,omitempty"`
	DueOn     string   `json:"due_on,omitempty"`
	StartsOn  string   `json:"starts_on,omitempty"`
	Assignees []Person `json:"assignees,omitempty"`
}

type AssignedTodosOptions struct {
	// GroupBy groups results by "bucket" or "date".
	GroupBy string
}

type AssignedTodosResponse struct {
	Person    *Person `json:"person"`
	GroupedBy string  `json:"grouped_by"`
	Todos     []Todo  `json:"todos"`
}

type AttachmentResponse struct {
	AttachableSGID string `json:"attachable_sgid"`
}

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

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

type AuthStrategy interface {
	// Authenticate applies authentication to the given HTTP request.
	Authenticate(ctx context.Context, req *http.Request) error
}

type AuthorizationInfo struct {
	ExpiresAt FlexTime            `json:"expires_at"`
	Identity  Identity            `json:"identity"`
	Accounts  []AuthorizedAccount `json:"accounts"`
}

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

type AuthorizedAccount struct {
	ID       int64  `json:"id"`
	Name     string `json:"name"`
	Product  string `json:"product"`
	HREF     string `json:"href"`
	AppHREF  string `json:"app_href"`
	Hidden   bool   `json:"hidden,omitempty"`
	Expired  bool   `json:"expired,omitempty"`
	Featured bool   `json:"featured,omitempty"`
}

type BearerAuth struct {
	TokenProvider TokenProvider
}

type Boost struct {
	ID        int64     `json:"id"`
	Content   string    `json:"content"`
	CreatedAt time.Time `json:"created_at"`
	Booster   *Person   `json:"booster,omitempty"`
	Recording *Parent   `json:"recording,omitempty"`
}

type BoostListResult struct {
	// Boosts is the list of boosts returned.
	Boosts []Boost
	// Meta contains pagination metadata (total count, etc.).
	Meta ListMeta
}

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

type Bucket struct {
	ID   int64  `json:"id"`
	Name string `json:"name"`
	Type string `json:"type"`
}

type BulkheadConfig struct {
	// MaxConcurrent is the maximum number of parallel requests.
	// Default: 10
	MaxConcurrent int

	// MaxWait is the maximum time to wait for a slot.
	// If zero, requests are rejected immediately when the bulkhead is full.
	// Default: 5s
	MaxWait time.Duration
}

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

type Campfire struct {
	ID               int64     `json:"id"`
	Status           string    `json:"status"`
	VisibleToClients bool      `json:"visible_to_clients"`
	CreatedAt        time.Time `json:"created_at"`
	UpdatedAt        time.Time `json:"updated_at"`
	Title            string    `json:"title"`
	InheritsStatus   bool      `json:"inherits_status"`
	Type             string    `json:"type"`
	URL              string    `json:"url"`
	AppURL           string    `json:"app_url"`
	LinesURL         string    `json:"lines_url"`
	FilesURL         string    `json:"files_url,omitempty"`
	Bucket           *Bucket   `json:"bucket,omitempty"`
	Creator          *Person   `json:"creator,omitempty"`
	BoostsCount      int       `json:"boosts_count,omitempty"`
}

type CampfireLine struct {
	ID               int64                    `json:"id"`
	Status           string                   `json:"status"`
	VisibleToClients bool                     `json:"visible_to_clients"`
	CreatedAt        time.Time                `json:"created_at"`
	UpdatedAt        time.Time                `json:"updated_at"`
	Title            string                   `json:"title"`
	InheritsStatus   bool                     `json:"inherits_status"`
	Type             string                   `json:"type"`
	URL              string                   `json:"url"`
	AppURL           string                   `json:"app_url"`
	Content          string                   `json:"content,omitempty"`
	Attachments      []CampfireLineAttachment `json:"attachments,omitempty"`
	Parent           *Parent                  `json:"parent,omitempty"`
	Bucket           *Bucket                  `json:"bucket,omitempty"`
	Creator          *Person                  `json:"creator,omitempty"`
	BoostsCount      int                      `json:"boosts_count,omitempty"`
}

type CampfireLineAttachment struct {
	Title       string `json:"title,omitempty"`
	URL         string `json:"url,omitempty"`
	Filename    string `json:"filename,omitempty"`
	ContentType string `json:"content_type,omitempty"`
	ByteSize    int64  `json:"byte_size,omitempty"`
	DownloadURL string `json:"download_url,omitempty"`
}

type CampfireLineListResult struct {
	// Lines is the list of campfire lines returned.
	Lines []CampfireLine
	// Meta contains pagination metadata (total count, etc.).
	Meta ListMeta
}

type CampfireListResult struct {
	// Campfires is the list of campfires returned.
	Campfires []Campfire
	// Meta contains pagination metadata (total count, etc.).
	Meta ListMeta
}

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

type Card struct {
	ID                    int64      `json:"id"`
	Status                string     `json:"status"`
	VisibleToClients      bool       `json:"visible_to_clients"`
	CreatedAt             time.Time  `json:"created_at"`
	UpdatedAt             time.Time  `json:"updated_at"`
	Title                 string     `json:"title"`
	InheritsStatus        bool       `json:"inherits_status"`
	Type                  string     `json:"type"`
	URL                   string     `json:"url"`
	AppURL                string     `json:"app_url"`
	BookmarkURL           string     `json:"bookmark_url"`
	SubscriptionURL       string     `json:"subscription_url,omitempty"`
	Position              int        `json:"position"`
	Content               string     `json:"content,omitempty"`
	Description           string     `json:"description,omitempty"`
	DueOn                 string     `json:"due_on,omitempty"`
	Completed             bool       `json:"completed"`
	CompletedAt           *time.Time `json:"completed_at,omitempty"`
	CommentsCount         int        `json:"comments_count"`
	BoostsCount           int        `json:"boosts_count"`
	CommentsURL           string     `json:"comments_url,omitempty"`
	CommentCount          int        `json:"comment_count"`
	CompletionURL         string     `json:"completion_url,omitempty"`
	Parent                *Parent    `json:"parent,omitempty"`
	Bucket                *Bucket    `json:"bucket,omitempty"`
	Creator               *Person    `json:"creator,omitempty"`
	Completer             *Person    `json:"completer,omitempty"`
	Assignees             []Person   `json:"assignees,omitempty"`
	CompletionSubscribers []Person   `json:"completion_subscribers,omitempty"`
	Steps                 []CardStep `json:"steps,omitempty"`
}

type CardColumn struct {
	ID               int64     `json:"id"`
	Status           string    `json:"status"`
	VisibleToClients bool      `json:"visible_to_clients"`
	CreatedAt        time.Time `json:"created_at"`
	UpdatedAt        time.Time `json:"updated_at"`
	Title            string    `json:"title"`
	InheritsStatus   bool      `json:"inherits_status"`
	Type             string    `json:"type"`
	URL              string    `json:"url"`
	AppURL           string    `json:"app_url"`
	BookmarkURL      string    `json:"bookmark_url"`
	Position         int       `json:"position,omitempty"`
	Color            string    `json:"color,omitempty"`
	Description      string    `json:"description,omitempty"`
	CardsCount       int       `json:"cards_count"`
	CommentCount     int       `json:"comment_count"`
	CardsURL         string    `json:"cards_url,omitempty"`
	Parent           *Parent   `json:"parent,omitempty"`
	Bucket           *Bucket   `json:"bucket,omitempty"`
	Creator          *Person   `json:"creator,omitempty"`
	Subscribers      []Person  `json:"subscribers,omitempty"`
}

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

type CardListOptions struct {
	// Limit is the maximum number of cards to return.
	// If 0 (default), returns all cards. Use a positive value to cap results.
	Limit int

	// Page, if non-zero, disables pagination and returns only the first page.
	// NOTE: The page number itself is not yet honored due to OpenAPI client
	// limitations. Use 0 to paginate through all results up to Limit.
	Page int
}

type CardListResult struct {
	// Cards is the list of cards returned.
	Cards []Card
	// Meta contains pagination metadata (total count, etc.).
	Meta ListMeta
}

type CardStep struct {
	ID               int64      `json:"id"`
	Status           string     `json:"status"`
	VisibleToClients bool       `json:"visible_to_clients"`
	CreatedAt        time.Time  `json:"created_at"`
	UpdatedAt        time.Time  `json:"updated_at"`
	Title            string     `json:"title"`
	InheritsStatus   bool       `json:"inherits_status"`
	Type             string     `json:"type"`
	URL              string     `json:"url"`
	AppURL           string     `json:"app_url"`
	BookmarkURL      string     `json:"bookmark_url"`
	Position         int        `json:"position"`
	DueOn            string     `json:"due_on,omitempty"`
	Completed        bool       `json:"completed"`
	CompletedAt      *time.Time `json:"completed_at,omitempty"`
	Parent           *Parent    `json:"parent,omitempty"`
	Bucket           *Bucket    `json:"bucket,omitempty"`
	Creator          *Person    `json:"creator,omitempty"`
	Completer        *Person    `json:"completer,omitempty"`
	Assignees        []Person   `json:"assignees,omitempty"`
}

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

type CardTable struct {
	ID               int64        `json:"id"`
	Status           string       `json:"status"`
	VisibleToClients bool         `json:"visible_to_clients"`
	CreatedAt        time.Time    `json:"created_at"`
	UpdatedAt        time.Time    `json:"updated_at"`
	Title            string       `json:"title"`
	InheritsStatus   bool         `json:"inherits_status"`
	Type             string       `json:"type"`
	URL              string       `json:"url"`
	AppURL           string       `json:"app_url"`
	BookmarkURL      string       `json:"bookmark_url"`
	SubscriptionURL  string       `json:"subscription_url"`
	Bucket           *Bucket      `json:"bucket,omitempty"`
	Creator          *Person      `json:"creator,omitempty"`
	Subscribers      []Person     `json:"subscribers,omitempty"`
	Lists            []CardColumn `json:"lists,omitempty"`
}

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

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

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

type Chatbot struct {
	ID          int64     `json:"id"`
	CreatedAt   time.Time `json:"created_at"`
	UpdatedAt   time.Time `json:"updated_at"`
	ServiceName string    `json:"service_name"`
	CommandURL  string    `json:"command_url,omitempty"`
	URL         string    `json:"url"`
	AppURL      string    `json:"app_url"`
	LinesURL    string    `json:"lines_url"`
}

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

type CircuitBreakerConfig struct {
	// FailureThreshold is the number of failures before the circuit opens.
	// Default: 5
	FailureThreshold int

	// SuccessThreshold is the number of successes to close from half-open.
	// Default: 2
	SuccessThreshold int

	// OpenTimeout is the time before transitioning from open to half-open.
	// Default: 30s
	OpenTimeout time.Duration

	// FailureRateThreshold is the percentage failure rate to trigger opening.
	// Only evaluated when SlidingWindowSize requests have been made.
	// Default: 50 (meaning 50%)
	FailureRateThreshold float64

	// SlidingWindowSize is the number of requests to consider for rate calculation.
	// Default: 10
	SlidingWindowSize int

	// Now is a function that returns the current time. Used for testing.
	// If nil, time.Now is used.
	Now func() time.Time
}

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

type ClientApproval struct {
	ID               int64                    `json:"id"`
	Status           string                   `json:"status"`
	VisibleToClients bool                     `json:"visible_to_clients"`
	CreatedAt        time.Time                `json:"created_at"`
	UpdatedAt        time.Time                `json:"updated_at"`
	Title            string                   `json:"title"`
	InheritsStatus   bool                     `json:"inherits_status"`
	Type             string                   `json:"type"`
	URL              string                   `json:"url"`
	AppURL           string                   `json:"app_url"`
	BookmarkURL      string                   `json:"bookmark_url"`
	SubscriptionURL  string                   `json:"subscription_url"`
	Parent           *Parent                  `json:"parent,omitempty"`
	Bucket           *Bucket                  `json:"bucket,omitempty"`
	Creator          *Person                  `json:"creator,omitempty"`
	Content          string                   `json:"content"`
	Subject          string                   `json:"subject"`
	DueOn            *string                  `json:"due_on,omitempty"`
	RepliesCount     int                      `json:"replies_count"`
	RepliesURL       string                   `json:"replies_url"`
	ApprovalStatus   string                   `json:"approval_status"`
	Approver         *Person                  `json:"approver,omitempty"`
	Responses        []ClientApprovalResponse `json:"responses,omitempty"`
}

type ClientApprovalListResult struct {
	// Approvals is the list of client approvals returned.
	Approvals []ClientApproval
	// Meta contains pagination metadata (total count, etc.).
	Meta ListMeta
}

type ClientApprovalResponse struct {
	ID               int64     `json:"id"`
	Status           string    `json:"status"`
	VisibleToClients bool      `json:"visible_to_clients"`
	CreatedAt        time.Time `json:"created_at"`
	UpdatedAt        time.Time `json:"updated_at"`
	Title            string    `json:"title"`
	InheritsStatus   bool      `json:"inherits_status"`
	Type             string    `json:"type"`
	AppURL           string    `json:"app_url"`
	BookmarkURL      string    `json:"bookmark_url"`
	Parent           *Parent   `json:"parent,omitempty"`
	Bucket           *Bucket   `json:"bucket,omitempty"`
	Creator          *Person   `json:"creator,omitempty"`
	Content          string    `json:"content"`
	Approved         bool      `json:"approved"`
}

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

type ClientCompany struct {
	ID   int64  `json:"id"`
	Name string `json:"name"`
}

type ClientCorrespondence struct {
	ID               int64     `json:"id"`
	Status           string    `json:"status"`
	VisibleToClients bool      `json:"visible_to_clients"`
	CreatedAt        time.Time `json:"created_at"`
	UpdatedAt        time.Time `json:"updated_at"`
	Title            string    `json:"title"`
	InheritsStatus   bool      `json:"inherits_status"`
	Type             string    `json:"type"`
	URL              string    `json:"url"`
	AppURL           string    `json:"app_url"`
	BookmarkURL      string    `json:"bookmark_url"`
	SubscriptionURL  string    `json:"subscription_url"`
	Parent           *Parent   `json:"parent,omitempty"`
	Bucket           *Bucket   `json:"bucket,omitempty"`
	Creator          *Person   `json:"creator,omitempty"`
	Content          string    `json:"content"`
	Subject          string    `json:"subject"`
	RepliesCount     int       `json:"replies_count"`
	RepliesURL       string    `json:"replies_url"`
}

type ClientCorrespondenceListResult struct {
	// Correspondences is the list of client correspondences returned.
	Correspondences []ClientCorrespondence
	// Meta contains pagination metadata (total count, etc.).
	Meta ListMeta
}

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

type ClientOption func(*Client)

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

type ClientReply struct {
	ID               int64     `json:"id"`
	Status           string    `json:"status"`
	VisibleToClients bool      `json:"visible_to_clients"`
	CreatedAt        time.Time `json:"created_at"`
	UpdatedAt        time.Time `json:"updated_at"`
	Title            string    `json:"title"`
	InheritsStatus   bool      `json:"inherits_status"`
	Type             string    `json:"type"`
	URL              string    `json:"url"`
	AppURL           string    `json:"app_url"`
	BookmarkURL      string    `json:"bookmark_url"`
	Parent           *Parent   `json:"parent,omitempty"`
	Bucket           *Bucket   `json:"bucket,omitempty"`
	Creator          *Person   `json:"creator,omitempty"`
	Content          string    `json:"content"`
}

type ClientReplyListResult struct {
	// Replies is the list of client replies returned.
	Replies []ClientReply
	// Meta contains pagination metadata (total count, etc.).
	Meta ListMeta
}

type Clientside struct {
	URL    string `json:"url"`
	AppURL string `json:"app_url"`
}

type Comment struct {
	ID        int64     `json:"id"`
	Status    string    `json:"status"`
	CreatedAt time.Time `json:"created_at"`
	UpdatedAt time.Time `json:"updated_at"`
	Content   string    `json:"content"`
	Type      string    `json:"type"`
	URL       string    `json:"url"`
	AppURL    string    `json:"app_url"`
	Parent    *Parent   `json:"parent,omitempty"`
	Bucket    *Bucket   `json:"bucket,omitempty"`
	Creator   *Person   `json:"creator,omitempty"`
}

type CommentListOptions struct {
	// Limit is the maximum number of comments to return.
	// If 0, uses DefaultCommentLimit (100). Use -1 for unlimited.
	Limit int

	// Page, if non-zero, disables pagination and returns only the first page.
	// NOTE: The page number itself is not yet honored due to OpenAPI client
	// limitations. Use 0 to paginate through all results up to Limit.
	Page int
}

type CommentListResult struct {
	// Comments is the list of comments returned.
	Comments []Comment
	// Meta contains pagination metadata (total count, etc.).
	Meta ListMeta
}

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

type Config struct {
	// BaseURL is the API base URL (e.g., "https://3.basecampapi.com").
	BaseURL string `json:"base_url"`

	// ProjectID is the default project/bucket ID.
	ProjectID string `json:"project_id"`

	// TodolistID is the default todolist ID.
	TodolistID string `json:"todolist_id"`

	// CacheDir is the directory for HTTP cache storage.
	CacheDir string `json:"cache_dir"`

	// CacheEnabled controls whether HTTP caching is enabled.
	CacheEnabled bool `json:"cache_enabled"`
}

type CreateAnswerRequest struct {
	// Content is the answer content in HTML (required).
	Content string `json:"content"`
	// GroupOn is the date to group the answer with (optional, ISO 8601 format).
	GroupOn string `json:"group_on,omitempty"`
}

type CreateCampfireLineRequest struct {
	// Content is the message body (required).
	Content string `json:"content"`
	// ContentType is "text/plain" or "text/html". If empty, the API defaults to plain text.
	ContentType string `json:"content_type,omitempty"`
}

type CreateCardRequest struct {
	// Title is the card title (required).
	Title string `json:"title"`
	// Content is the card body in HTML (optional).
	Content string `json:"content,omitempty"`
	// DueOn is the due date in ISO 8601 format (optional).
	DueOn string `json:"due_on,omitempty"`
	// Notify when true, will notify assignees (optional).
	Notify bool `json:"notify,omitempty"`
}

type CreateChatbotRequest struct {
	// ServiceName is the chatbot name used to invoke queries and commands (required).
	// No spaces, emoji or non-word characters are allowed.
	ServiceName string `json:"service_name"`
	// CommandURL is the HTTPS URL that Basecamp should call when the bot is addressed (optional).
	CommandURL string `json:"command_url,omitempty"`
}

type CreateColumnRequest struct {
	// Title is the column title (required).
	Title string `json:"title"`
	// Description is the column description (optional).
	Description string `json:"description,omitempty"`
}

type CreateCommentRequest struct {
	// Content is the comment text in HTML (required).
	Content string `json:"content"`
}

type CreateDocumentRequest struct {
	// Title is the document title (required).
	Title string `json:"title"`
	// Content is the document body in HTML (optional).
	Content string `json:"content,omitempty"`
	// Status is either "drafted" or "active" (optional, defaults to active).
	Status string `json:"status,omitempty"`
	// Subscriptions controls who gets notified and subscribed.
	// nil: field omitted (server default). &[]int64{}: subscribe nobody. &[]int64{1,2}: those people.
	Subscriptions *[]int64 `json:"subscriptions,omitempty"`
}

type CreateForwardReplyRequest struct {
	// Content is the reply body in HTML (required).
	Content string `json:"content"`
}

type CreateLineOptions struct {
	// ContentType is "text/plain" or "text/html". If empty, the API defaults to plain text.
	ContentType string
}

type CreateMarkerRequest struct {
	// Name is the marker name (required).
	Name string `json:"name"`
	// Date is the marker date in YYYY-MM-DD format (required).
	Date string `json:"date"`
}

type CreateMessageRequest struct {
	// Subject is the message title (required).
	Subject string `json:"subject"`
	// Content is the message body in HTML (optional).
	Content string `json:"content,omitempty"`
	// Status is either "drafted" or "active" (optional, defaults to active).
	Status string `json:"status,omitempty"`
	// CategoryID is the message type ID (optional).
	CategoryID int64 `json:"category_id,omitempty"`
	// Subscriptions controls who gets notified and subscribed.
	// nil: field omitted (server default). &[]int64{}: subscribe nobody. &[]int64{1,2}: those people.
	Subscriptions *[]int64 `json:"subscriptions,omitempty"`
}

type CreateMessageTypeRequest struct {
	// Name is the message type name (required).
	Name string `json:"name"`
	// Icon is the message type icon (required).
	Icon string `json:"icon"`
}

type CreatePersonRequest struct {
	// Name is the person's full name (required).
	Name string `json:"name"`
	// EmailAddress is the person's email address (required).
	EmailAddress string `json:"email_address"`
	// Title is the person's job title (optional).
	Title string `json:"title,omitempty"`
	// CompanyName is the person's company name (optional).
	CompanyName string `json:"company_name,omitempty"`
}

type CreateProjectFromTemplateRequest struct {
	// Name is the project name (required).
	Name string `json:"name"`
	// Description is an optional project description.
	Description string `json:"description,omitempty"`
}

type CreateProjectRequest struct {
	// Name is the project name (required).
	Name string `json:"name"`
	// Description is an optional project description.
	Description string `json:"description,omitempty"`
}

type CreateQuestionRequest struct {
	// Title is the question text (required).
	Title string `json:"title"`
	// Schedule is the question schedule configuration (required).
	Schedule *QuestionSchedule `json:"schedule"`
}

type CreateScheduleEntryRequest struct {
	// Summary is the event title (required).
	Summary string `json:"summary"`
	// StartsAt is the event start time (required, ISO 8601 format).
	StartsAt string `json:"starts_at"`
	// EndsAt is the event end time (required, ISO 8601 format).
	EndsAt string `json:"ends_at"`
	// Description is the event details in HTML (optional).
	Description string `json:"description,omitempty"`
	// ParticipantIDs is a list of people IDs to assign (optional).
	ParticipantIDs []int64 `json:"participant_ids,omitempty"`
	// AllDay indicates if this is an all-day event (optional).
	AllDay bool `json:"all_day,omitempty"`
	// Notify triggers participant notifications when true (optional).
	Notify bool `json:"notify,omitempty"`
	// Subscriptions controls who gets notified and subscribed.
	// nil: field omitted (server default). &[]int64{}: subscribe nobody. &[]int64{1,2}: those people.
	Subscriptions *[]int64 `json:"subscriptions,omitempty"`
}

type CreateStepRequest struct {
	// Title is the step title (required).
	Title string `json:"title"`
	// DueOn is the due date in ISO 8601 format (optional).
	DueOn string `json:"due_on,omitempty"`
	// Assignees is a list of person IDs to assign this step to (optional).
	Assignees []int64 `json:"assignees,omitempty"`
}

type CreateTemplateRequest struct {
	// Name is the template name (required).
	Name string `json:"name"`
	// Description is an optional template description.
	Description string `json:"description,omitempty"`
}

type CreateTimesheetEntryRequest struct {
	Date        string `json:"date"`
	Hours       string `json:"hours"`
	Description string `json:"description,omitempty"`
	PersonID    int64  `json:"person_id,omitempty"`
}

type CreateTodoRequest struct {
	// Content is the todo text (required).
	Content string `json:"content"`
	// Description is an optional extended description (can include HTML).
	Description string `json:"description,omitempty"`
	// AssigneeIDs is a list of person IDs to assign this todo to.
	AssigneeIDs []int64 `json:"assignee_ids,omitempty"`
	// CompletionSubscriberIDs is a list of person IDs to notify on completion.
	CompletionSubscriberIDs []int64 `json:"completion_subscriber_ids,omitempty"`
	// Notify when true, will notify assignees.
	Notify bool `json:"notify,omitempty"`
	// DueOn is the due date in ISO 8601 format (YYYY-MM-DD).
	DueOn string `json:"due_on,omitempty"`
	// StartsOn is the start date in ISO 8601 format (YYYY-MM-DD).
	StartsOn string `json:"starts_on,omitempty"`
}

type CreateTodolistGroupRequest struct {
	// Name is the group name (required).
	Name string `json:"name"`
}

type CreateTodolistRequest struct {
	// Name is the todolist name (required).
	Name string `json:"name"`
	// Description is an optional description (can include HTML).
	Description string `json:"description,omitempty"`
}

type CreateUploadRequest struct {
	// AttachableSGID is the signed global ID for an uploaded attachment (required).
	// See the Create Attachment endpoint for how to upload files.
	AttachableSGID string `json:"attachable_sgid"`
	// Description is the upload description in HTML (optional).
	Description string `json:"description,omitempty"`
	// BaseName is the filename without extension (optional).
	BaseName string `json:"base_name,omitempty"`
	// Subscriptions controls who gets notified and subscribed.
	// nil: field omitted (server default). &[]int64{}: subscribe nobody. &[]int64{1,2}: those people.
	Subscriptions *[]int64 `json:"subscriptions,omitempty"`
}

type CreateVaultRequest struct {
	// Title is the vault name (required).
	Title string `json:"title"`
}

type CreateWebhookRequest struct {
	// PayloadURL is the URL to receive webhook payloads (required).
	PayloadURL string `json:"payload_url"`
	// Types is a list of event types to subscribe to (required).
	// Example: ["Todo", "Todolist", "Comment"]
	Types []string `json:"types"`
	// Active indicates whether the webhook is active (default: true).
	Active *bool `json:"active,omitempty"`
}

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

type Credentials struct {
	AccessToken   string `json:"access_token"`
	RefreshToken  string `json:"refresh_token"`
	ExpiresAt     int64  `json:"expires_at"`
	Scope         string `json:"scope"`
	TokenEndpoint string `json:"token_endpoint"`
	UserID        string `json:"user_id,omitempty"`
}

type Date = types.Date

type DockItem struct {
	ID       int64  `json:"id"`
	Title    string `json:"title"`
	Name     string `json:"name"`
	Enabled  bool   `json:"enabled"`
	Position *int   `json:"position"`
	URL      string `json:"url"`
	AppURL   string `json:"app_url"`
}

type Document struct {
	ID               int64     `json:"id"`
	Status           string    `json:"status"`
	VisibleToClients bool      `json:"visible_to_clients"`
	CreatedAt        time.Time `json:"created_at"`
	UpdatedAt        time.Time `json:"updated_at"`
	Title            string    `json:"title"`
	InheritsStatus   bool      `json:"inherits_status"`
	Type             string    `json:"type"`
	URL              string    `json:"url"`
	AppURL           string    `json:"app_url"`
	BookmarkURL      string    `json:"bookmark_url"`
	SubscriptionURL  string    `json:"subscription_url"`
	CommentsCount    int       `json:"comments_count"`
	BoostsCount      int       `json:"boosts_count,omitempty"`
	CommentsURL      string    `json:"comments_url"`
	Position         int       `json:"position,omitempty"`
	Parent           *Parent   `json:"parent,omitempty"`
	Bucket           *Bucket   `json:"bucket,omitempty"`
	Creator          *Person   `json:"creator,omitempty"`
	Content          string    `json:"content"`
}

type DocumentListOptions struct {
	// Limit is the maximum number of documents to return.
	// If 0 (default), returns all documents. Use a positive value to cap results.
	Limit int

	// Page, if non-zero, disables pagination and returns only the first page.
	// NOTE: The page number itself is not yet honored due to OpenAPI client
	// limitations. Use 0 to paginate through all results up to Limit.
	Page int
}

type DocumentListResult struct {
	// Documents is the list of documents returned.
	Documents []Document
	// Meta contains pagination metadata (total count, etc.).
	Meta ListMeta
}

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

type DownloadResult struct {
	// Body is the file content. Caller must close this.
	Body io.ReadCloser
	// ContentType is the MIME type of the file.
	ContentType string
	// ContentLength is the size of the file in bytes (-1 if unknown).
	ContentLength int64
	// Filename is the name of the file.
	Filename string
}

type Error struct {
	Code       string
	Message    string
	Hint       string
	HTTPStatus int
	Retryable  bool
	RequestID  string
	Cause      error
}

type Event struct {
	ID          int64         `json:"id"`
	RecordingID int64         `json:"recording_id"`
	Action      string        `json:"action"`
	Details     *EventDetails `json:"details,omitempty"`
	CreatedAt   time.Time     `json:"created_at"`
	Creator     *Person       `json:"creator,omitempty"`
}

type EventDetails struct {
	// AddedPersonIDs is populated for assignment_changed actions.
	AddedPersonIDs []int64 `json:"added_person_ids,omitempty"`
	// RemovedPersonIDs is populated for assignment_changed actions.
	RemovedPersonIDs []int64 `json:"removed_person_ids,omitempty"`
	// NotifiedRecipientIDs is populated for completion events.
	NotifiedRecipientIDs []int64 `json:"notified_recipient_ids,omitempty"`
}

type EventListOptions struct {
	// Limit is the maximum number of events to return.
	// If 0, uses DefaultEventLimit (100). Use -1 for unlimited.
	Limit int

	// Page, if non-zero, disables pagination and returns only the first page.
	// NOTE: The page number itself is not yet honored due to OpenAPI client
	// limitations. Use 0 to paginate through all results up to Limit.
	Page int
}

type EventListResult struct {
	// Events is the list of events returned.
	Events []Event
	// Meta contains pagination metadata (total count, etc.).
	Meta ListMeta
}

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

type FlexTime struct {
	time.Time
}

type Forward struct {
	ID        int64     `json:"id"`
	Status    string    `json:"status"`
	CreatedAt time.Time `json:"created_at"`
	UpdatedAt time.Time `json:"updated_at"`
	Subject   string    `json:"subject"`
	Content   string    `json:"content"`
	From      string    `json:"from"`
	Type      string    `json:"type"`
	URL       string    `json:"url"`
	AppURL    string    `json:"app_url"`
	Parent    *Parent   `json:"parent,omitempty"`
	Bucket    *Bucket   `json:"bucket,omitempty"`
	Creator   *Person   `json:"creator,omitempty"`
}

type ForwardListOptions struct {
	// Limit is the maximum number of forwards to return.
	// If 0 (default), returns all forwards. Use a positive value to cap results.
	Limit int

	// Page, if non-zero, disables pagination and returns only the first page.
	// NOTE: The page number itself is not yet honored due to OpenAPI client
	// limitations. Use 0 to paginate through all results up to Limit.
	Page int
}

type ForwardListResult struct {
	// Forwards is the list of forwards returned.
	Forwards []Forward
	// Meta contains pagination metadata (total count, etc.).
	Meta ListMeta
}

type ForwardReply struct {
	ID        int64     `json:"id"`
	Status    string    `json:"status"`
	CreatedAt time.Time `json:"created_at"`
	UpdatedAt time.Time `json:"updated_at"`
	Content   string    `json:"content"`
	Type      string    `json:"type"`
	URL       string    `json:"url"`
	AppURL    string    `json:"app_url"`
	Parent    *Parent   `json:"parent,omitempty"`
	Bucket    *Bucket   `json:"bucket,omitempty"`
	Creator   *Person   `json:"creator,omitempty"`
}

type ForwardReplyListOptions struct {
	// Limit is the maximum number of replies to return.
	// If 0 (default), returns all replies. Use a positive value to cap results.
	Limit int

	// Page, if non-zero, disables pagination and returns only the first page.
	// NOTE: The page number itself is not yet honored due to OpenAPI client
	// limitations. Use 0 to paginate through all results up to Limit.
	Page int
}

type ForwardReplyListResult struct {
	// Replies is the list of forward replies returned.
	Replies []ForwardReply
	// Meta contains pagination metadata (total count, etc.).
	Meta ListMeta
}

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

type GatingHooks interface {
	Hooks
	// OnOperationGate is called before OnOperationStart.
	// Returns a new context (which may contain cleanup functions like bulkhead
	// release) and an error. Return non-nil error to reject the operation.
	// The returned context should be used for the operation and passed to
	// OnOperationEnd for proper cleanup.
	OnOperationGate(ctx context.Context, op OperationInfo) (context.Context, error)
}

type GetInfoOptions struct {
	// Endpoint overrides the default authorization endpoint URL.
	// If empty, defaults to "https://launchpad.37signals.com/authorization.json".
	Endpoint string

	// FilterProduct filters accounts to only those matching this product.
	// Common values: "bc3" (Basecamp), "bcx" (Basecamp 2), "hey" (HEY).
	// If empty, all accounts are returned.
	FilterProduct string
}

type HTTPOptions struct {
	// Timeout is the request timeout (default: 30s).
	Timeout time.Duration

	// MaxRetries is the maximum retry attempts for GET requests (default: 3).
	// POST/PUT/DELETE requests only get 1 retry after successful token refresh.
	MaxRetries int

	// BaseDelay is the initial backoff delay (default: 1s).
	BaseDelay time.Duration

	// MaxJitter is the maximum random jitter to add to delays (default: 100ms).
	MaxJitter time.Duration

	// MaxPages is the maximum pages to fetch in GetAll (default: 10000).
	MaxPages int

	// Transport is the HTTP transport to use. If nil, a default transport
	// with sensible connection pooling is created.
	Transport http.RoundTripper
}

type Hooks interface {
	// OnOperationStart is called when a semantic SDK operation begins.
	// Returns a context that will be passed to OnOperationEnd.
	OnOperationStart(ctx context.Context, op OperationInfo) context.Context

	// OnOperationEnd is called when a semantic SDK operation completes.
	// The ctx is the one returned from OnOperationStart.
	OnOperationEnd(ctx context.Context, op OperationInfo, err error, duration time.Duration)

	// OnRequestStart is called before an HTTP request is sent.
	// The returned context is used for the request and passed to OnRequestEnd.
	OnRequestStart(ctx context.Context, info RequestInfo) context.Context

	// OnRequestEnd is called after an HTTP request completes.
	// It receives the same context returned by OnRequestStart.
	OnRequestEnd(ctx context.Context, info RequestInfo, result RequestResult)

	// OnRetry is called before a retry attempt.
	OnRetry(ctx context.Context, info RequestInfo, attempt int, err error)
}

type Identity struct {
	ID           int64  `json:"id"`
	FirstName    string `json:"first_name"`
	LastName     string `json:"last_name"`
	EmailAddress string `json:"email_address"`
}

type Inbox struct {
	ID        int64     `json:"id"`
	Status    string    `json:"status"`
	CreatedAt time.Time `json:"created_at"`
	UpdatedAt time.Time `json:"updated_at"`
	Title     string    `json:"title"`
	Type      string    `json:"type"`
	URL       string    `json:"url"`
	AppURL    string    `json:"app_url"`
	Bucket    *Bucket   `json:"bucket,omitempty"`
	Creator   *Person   `json:"creator,omitempty"`
}

type LineupMarker struct {
	ID          int64     `json:"id"`
	Status      string    `json:"status"`
	Color       string    `json:"color"`
	Title       string    `json:"title"`
	StartsOn    string    `json:"starts_on"`
	EndsOn      string    `json:"ends_on"`
	Description string    `json:"description,omitempty"`
	CreatedAt   time.Time `json:"created_at"`
	UpdatedAt   time.Time `json:"updated_at"`
	Type        string    `json:"type"`
	URL         string    `json:"url"`
	AppURL      string    `json:"app_url"`
	Creator     *Person   `json:"creator,omitempty"`
	Parent      *Parent   `json:"parent,omitempty"`
	Bucket      *Bucket   `json:"bucket,omitempty"`
}

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

type ListMeta struct {
	// TotalCount is the total number of items available (from X-Total-Count header).
	// Zero if the header was not present or could not be parsed.
	TotalCount int
	// Truncated is true when results were capped by MaxPages or Limit, either
	// because more pages are available on the server or because items were
	// dropped within a page due to the limit.
	Truncated bool
}

type Match struct {
	// Source indicates how the URL was matched: API route table or structural convention.
	Source MatchSource

	// Operation is the matched API operation name (e.g., "GetTodo", "CreateMessage").
	// Empty for structural matches.
	Operation string

	// Operations lists all API operations for the matched pattern, keyed by HTTP method.
	// Nil for structural matches.
	Operations map[string]string

	// Resource is the API resource group (e.g., "Todos", "Messages").
	// Empty for structural matches.
	Resource string

	// PathType is the resource type segment from the URL path (e.g., "todos",
	// "messages", "cards", "columns"). Always populated when a bucket resource
	// is matched, whether by API route or structural fallback.
	PathType string

	// AccountID is the Basecamp account ID from the URL path.
	AccountID string

	// ProjectID is the bucket/project ID. Present for most resource URLs.
	ProjectID string

	// Params contains all named path parameters extracted from the URL.
	// Keys match the route table parameter names (e.g., "todoId", "messageId").
	// Nil for structural matches.
	Params map[string]string

	// CommentID is the comment ID extracted from a #__recording_{id} fragment.
	CommentID string
	// contains filtered or unexported fields
}

type MatchSource int

type Message struct {
	ID          int64        `json:"id"`
	Status      string       `json:"status"`
	Subject     string       `json:"subject"`
	Content     string       `json:"content"`
	CreatedAt   time.Time    `json:"created_at"`
	UpdatedAt   time.Time    `json:"updated_at"`
	Type        string       `json:"type"`
	URL         string       `json:"url"`
	AppURL      string       `json:"app_url"`
	Parent      *Parent      `json:"parent,omitempty"`
	Bucket      *Bucket      `json:"bucket,omitempty"`
	Creator     *Person      `json:"creator,omitempty"`
	Category    *MessageType `json:"category,omitempty"`
	BoostsCount int          `json:"boosts_count,omitempty"`
}

type MessageBoard struct {
	ID            int64     `json:"id"`
	Status        string    `json:"status"`
	Title         string    `json:"title"`
	CreatedAt     time.Time `json:"created_at"`
	UpdatedAt     time.Time `json:"updated_at"`
	Type          string    `json:"type"`
	URL           string    `json:"url"`
	AppURL        string    `json:"app_url"`
	MessagesCount int       `json:"messages_count"`
	MessagesURL   string    `json:"messages_url"`
	Bucket        *Bucket   `json:"bucket,omitempty"`
	Creator       *Person   `json:"creator,omitempty"`
}

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

type MessageListOptions struct {
	// Limit is the maximum number of messages to return.
	// If 0, uses DefaultMessageLimit (100). Use -1 for unlimited.
	Limit int

	// Page, if non-zero, disables pagination and returns only the first page.
	// NOTE: The page number itself is not yet honored due to OpenAPI client
	// limitations. Use 0 to paginate through all results up to Limit.
	Page int
}

type MessageListResult struct {
	// Messages is the list of messages returned.
	Messages []Message
	// Meta contains pagination metadata (total count, etc.).
	Meta ListMeta
}

type MessageType struct {
	ID        int64     `json:"id"`
	Name      string    `json:"name"`
	Icon      string    `json:"icon"`
	CreatedAt time.Time `json:"created_at"`
	UpdatedAt time.Time `json:"updated_at"`
}

type MessageTypeListResult struct {
	// MessageTypes is the list of message types returned.
	MessageTypes []MessageType
	// Meta contains pagination metadata (total count, etc.).
	Meta ListMeta
}

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

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