deviantart

type Authenticator func(s *sling.Sling) error

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

type Client struct {
	Browse      *BrowseService
	Collections *CollectionsService
	Comments    *CommentsService
	Deviation   *DeviationService
	Gallery     *GalleryService
	Messages    *MessagesService
	Stash       *StashService
	User        *UserService
	// contains filtered or unexported fields
}

type Collection struct {
	FolderID    uuid.UUID   `json:"folderid"`
	Name        string      `json:"name"`
	Description string      `json:"folder"`
	Size        uint32      `json:"size,omitempty"`
	Thumb       *Deviation  `json:"thumb"`
	Deviations  []Deviation `json:"deviations,omitempty"`
}

type CollectionsService struct {
	*FoldersService[Collection]
	// contains filtered or unexported fields
}

type Comment struct {
	CommentID   uuid.UUID   `json:"commentid"`
	ParentID    uuid.UUID   `json:"parentid"`
	Posted      string      `json:"posted"`
	Replies     int         `json:"replies"`
	Body        string      `json:"body"`
	IsLiked     bool        `json:"is_liked"`
	IsFeatured  bool        `json:"is_featured"`
	Likes       int         `json:"likes"`
	User        User        `json:"user,omitempty"`
	TextContent *EditorText `json:"text_content,omitempty"`

	// The hidden field will be null when the comment is not hidden and one of
	// the following values when it is:
	//   - `hidden_by_owner` - The comment was hidden by the owner of the item
	//   - `hidden_by_admin` - The comment was hidden by an administrator
	//   - `hidden_by_commenter` - The comment was by the comment owner
	//   - `hidden_as_spam` - The comment was hidden because it was marked spam
	Hidden string `json:"hidden"`
}

type CommentParams struct {
	// The Comment ID you are replying to.
	CommentID uuid.UUID `url:"commentid,omitempty"`

	// The comment text.
	Text string `url:"body"`
}

type CommentSiblings struct {
	HasMore    bool      `json:"has_more"`
	NextOffset int       `json:"next_offset,omitempty"`
	HasLess    bool      `json:"has_less"`
	PrevOffset int       `json:"prev_offset,omitempty"`
	Thread     []Comment `json:"thread"`
	Context    struct {
		Parent        *Comment   `json:"parent,omitempty"`
		ItemProfile   *User      `json:"item_profile,omitempty"`
		ItemDeviation *Deviation `json:"item_deviation,omitempty"`
		ItemStatus    *Status    `json:"item_status,omitempty"`
	} `json:"context,omitempty"`
}

type CommentSiblingsParams struct {
	// Fetch the related containing item (deviation, profile user, or status).
	IncludeItem bool `url:"ext_item,omitempty"`

	// The pagination offset.
	Offset int `url:"offset,omitempty"`

	// The pagination limit.
	Limit int `url:"limit,omitempty"`
}

type CommentsResponse struct {
	HasMore    bool      `json:"has_more,omitempty"`
	NextOffset int       `json:"next_offset,omitempty"`
	HasLess    bool      `json:"has_less,omitempty"`
	PrevOffset bool      `json:"prev_offset,omitempty"`
	Total      int       `json:"total,omitempty"`
	Thread     []Comment `json:"thread,omitempty"`
}

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

type Content struct {
	HTML     string   `json:"html,omitempty"`
	CSS      string   `json:"css,omitempty"`
	CSSFonts []string `json:"css_fonts,omitempty"`
}

type CopyDeviationsParams struct {
	TargetFolderID uuid.UUID   `url:"target_folderid,omitempty"`
	DeviationIDs   []uuid.UUID `url:"deviationids,omitempty"`
}

type Country struct {
	CountryID uint8  `json:"countryid"`
	Name      string `json:"name"`
}

type CreateFolderParams struct {
	// The name of the folder to create.
	Folder string `url:"folder"`

	// Folder description.
	// This field is supported only by galleries.
	Description string `url:"description,omitempty"`

	// The UUID of the parent gallery if this is a subgallery.
	// This field is supported only by galleries.
	ParentFolderID uuid.UUID `url:"parent_folderid,omitempty"`
}

type CreateJournalParams struct {
	// Journal title.
	Title string `url:"title"`

	// The `body` of the journal.
	Body string `url:"body,omitempty"`

	// Journal tags.
	Tags []string `url:"tags,brackets,omitempty"`

	// Cover deviation ID.
	CoverImageDeviationID uuid.UUID `url:"cover_image_deviation_id,omitempty"`

	// ID of the embeded deviation.
	EmbeddedImageDeviationID uuid.UUID `url:"embedded_image_deviation_id,omitempty"`

	// Submission is mature or not.
	IsMature bool `url:"is_mature,omitempty"`

	// Allow comments on the submission.
	AllowComments bool `url:"allow_comments,omitempty"`

	// License options.
	LicenseOptions LicenseOptions `url:"license_options,omitempty"`
}

type CreateLiteratureParams struct {
	// Literature title.
	Title string `url:"title"`

	// The `body` of the literature.
	Body string `url:"body,omitempty"`

	// Literature description.
	Description string `url:"description,omitempty"`

	// Literature tags.
	Tags []string `url:"tags,brackets,omitempty"`

	// UUIDs of gallery folders to publish this submission to.
	GalleryIDs []uuid.UUID `url:"galleryids,omitempty"`

	// Submission is mature or not.
	IsMature bool `url:"is_mature"`

	// The mature level of the submission, required for mature submissions.
	MatureLevel string `url:"mature_level,omitempty"`

	// The mature classification of the submission.
	MatureClassification []string `url:"mature_classification,brackets,omitempty"`

	// Allow comments on the submission
	AllowComments bool `url:"allow_comments,omitempty"`

	// License options.
	LicenseOptions []LicenseOptions `url:"license_options"`

	// ID of the embeded deviation.
	EmbeddedImageDeviationID string `url:"embedded_image_deviation_id,omitempty"`
}

type CursorParams struct {
	Cursor string `url:"cursor,omitempty"`
}

type CursorResponse[T any] struct {
	Results    []T    `json:"results"`
	HasMore    bool   `json:"has_more"`
	NextCursor string `json:"next_cursor"`
	PrevCursor string `json:"prev_cursor"`
}

type DeleteMessageParams struct {
	// The folder to delete the message from, defaults to inbox.
	FolderID uuid.UUID `url:"folderid,omitempty"`

	// The message to delete.
	MessageID string `url:"messageid,omitempty"`

	// The stack to delete.
	StackID string `url:"stackid,omitempty"`
}

type Deviation struct {
	DeviationID  uuid.UUID `json:"deviationid"`
	PrintID      uuid.UUID `json:"printid,omitempty"`
	URL          string    `json:"url,omitempty"`
	Title        string    `json:"title,omitempty"`
	Category     string    `json:"category,omitempty"`
	CategoryPath string    `json:"category_path,omitempty"`
	IsFavourited bool      `json:"is_favourited,omitempty"`
	IsDeleted    bool      `json:"is_deleted"`
	IsPublished  bool      `json:"is_published,omitempty"`
	IsBlocked    bool      `json:"is_blocked,omitempty"`
	Author       User      `json:"author,omitempty"`
	Stats        struct {
		Comments   uint32 `json:"comments"`
		Favourites uint32 `json:"favourites"`
	} `json:"stats,omitempty"`
	PublishedTime  string        `json:"published_time,omitempty"`
	AllowsComments bool          `json:"allows_comments,omitempty"`
	Tier           DeviationTier `json:"tier,omitempty"`
	Preview        StashFile     `json:"preview,omitempty"`
	Content        struct {
		StashFile
		FileSize uint32 `json:"filesize"`
	} `json:"content,omitempty"`
	Thumbs []StashFile `json:"thumbs"`
	Videos []struct {
		Src      string `json:"src"`
		Quality  string `json:"quality"`
		FileSize uint32 `json:"filesize"`
		Duration uint32 `json:"duration"`
	} `json:"videos,omitempty"`
	Flash          []fileInfo `json:"flash,omitempty"`
	DailyDeviation struct {
		Body      string `json:"body"`
		Time      string `json:"time"`
		Giver     User   `json:"giver"`
		Suggester User   `json:"suggester,omitempty"`
	} `json:"daily_deviation,omitempty"`
	PremiumFolderData *PremiumFolderData `json:"premium_folder_data,omitempty"`
	TextContent       *EditorText        `json:"text_content,omitempty"`
	IsPinned          bool               `json:"is_pinned,omitempty"`
	CoverImage        *Deviation         `json:"cover_image,omitempty"`
	TierAccess        string             `json:"tier_access,omitempty"`
	PrimaryTier       *Deviation         `json:"primary_tier,omitempty"`
	Excerpt           string             `json:"excerpt,omitempty"`
	IsMature          bool               `json:"is_mature,omitempty"`
	IsDownloadable    bool               `json:"is_downloadable,omitempty"`
	DownloadFileSize  uint32             `json:"download_filesize,omitempty"`
	MotionBook        struct {
		EmbedURL string `json:"embed_url,omitempty"`
	} `json:"motion_book,omitempty"`
	SuggestedReasons []any `json:"suggested_reasons,omitempty"`
}

type DeviationMetadata struct {
	DeviationID          uuid.UUID            `json:"deviationid"`
	PrintID              uuid.UUID            `json:"uuid,omitempty"`
	Author               *User                `json:"author"`
	IsWatching           bool                 `json:"is_watching"`
	Title                string               `json:"title"`
	Description          string               `json:"description"`
	License              string               `json:"license"`
	AllowsComments       bool                 `json:"allow_comments"`
	Tags                 []DeviationTag       `json:"tags"`
	IsFavourited         bool                 `json:"is_favourited"`
	IsMature             bool                 `json:"is_mature"`
	MatureLevel          string               `json:"mature_level,omitempty"`
	MatureClassification []string             `json:"mature_classification,omitempty"`
	Submission           *DeviationSubmission `json:"submission,omitempty"`
	Stats                *DeviationStats      `json:"stats,omitempty"`
	Camera               map[string]string    `json:"camera,omitempty"`
	Collections          []Folder             `json:"collections,omitempty"`
	Galleries            []Folder             `json:"galleries,omitempty"`
	CanPostComments      bool                 `json:"can_post_comments,omitempty"`
}

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

type DeviationStats struct {
	Views          int `json:"views"`
	ViewsToday     int `json:"views_today,omitempty"`
	Favourites     int `json:"favourites"`
	Comments       int `json:"comments"`
	Downloads      int `json:"downloads"`
	DownloadsToday int `json:"downloads_today,omitempty"`
}

type DeviationSubmission struct {
	CreationTime  string `json:"creation_time"`
	Category      string `json:"category"`
	FileSize      string `json:"file_size,omitempty"`
	Resolution    string `json:"resolution,omitempty"`
	SubmittedWith struct {
		App string `json:"app"`
		URL string `json:"url"`
	} `json:"submitted_with"`
}

type DeviationTag struct {
	Name      string `json:"tag_name"`
	Sponsored bool   `json:"sponsored"`
	Sponsor   bool   `json:"sponsor"`
}

type DeviationTier struct {
	State            string `json:"state,omitempty"` // TODO: enum[draft,active,pending_deletion,deleted]
	IsUserSubscribed bool   `json:"is_user_subscribed,omitempty"`
	CanUserSubscribe bool   `json:"can_user_subscribe,omitempty"`
	SubproductID     uint64 `json:"subproductid,omitempty"`
	DollarPrice      string `json:"dollar_price,omitempty"` // TODO: PremiumFolderData has the same float field.
	Settings         struct {
		AccessSettings string `json:"access_settings"` // TODO: enum[all,future_only,limited_past_and_future]
	} `json:"settings,omitempty"`
	Stats struct {
		Subscribers uint32 `json:"subscribers,omitempty"`
		Deviations  uint32 `json:"deviations,omitempty"`
		Posts       uint32 `json:"posts,omitempty"`
		Total       uint32 `json:"total,omitempty"`
	} `json:"stats"`
	Benefits []string `json:"benefits"`
}

type DeviationUpdateResponse struct {
	StatusResponse
	URL         string    `json:"url"`
	DeviationID uuid.UUID `json:"deviationid"`
}

type DisplayResolution uint8

type DownloadResponse struct {
	FileName string `json:"filename"`
	FileSize uint32 `json:"filesize"`
	// contains filtered or unexported fields
}

type EditDeviationParams struct {
	// Title.
	Title string `url:"title,omitempty"`

	// Submission is mature or not.
	IsMature bool `url:"is_mature"`

	// The mature level of the submission, required for mature submissions.
	MatureLevel string `url:"mature_level,omitempty"`

	// The mature classification of the submission.
	MatureClassification []string `url:"mature_classification,brackets,omitempty"`

	// Allow comments on the submission. Default: true.
	AllowComments bool `url:"allow_comments,omitempty"`

	// License options.
	LicenseOptions LicenseOptions `url:"license_options,omitempty"`

	// UUIDs of gallery folders to publish this submission to.
	GalleryIDs []string `url:"galleryids,omitempty"`

	// Offer original file as a free download.
	AllowFreeDownload bool `url:"allow_free_download,omitempty"`

	// Add watermark. Available only if display_resolution is present.
	AddWatermark bool `url:"add_watermark,omitempty"`
}

type EditorText struct {
	Excerpt string `json:"excerpt"`
	Body    struct {
		Type     string `json:"type"`
		Markup   string `json:"markup,omitempty"`
		Features string `json:"features"`
	} `json:"body"`
}

type EmbeddedContentParams struct {
	// The deviation ID of container deviation.
	DeviationID uuid.UUID `url:"deviationid"`

	// ID of embedded deviation to use as an offset.
	OffsetDeviationID uuid.UUID `url:"offset_deviationid,omitempty"`
}

type Error struct {
	StatusResponse

	// The error type.
	Type string `json:"error"`

	// The error message.
	Description string `json:"error_description"`

	// An additional endpoint specific error code.
	Details map[string]string `json:"error_details"`

	// An additional endpoint specific error code.
	Code int `json:"error_code"`
}

type FaveInfo struct {
	User *User `json:"user"`
	Time int64 `json:"time"`
}

type FetchCommentsParams struct {
	// The commentid you want to fetch.
	CommentID uuid.UUID `url:"commentid,omitempty"`

	// Depth to query replies until.
	MaxDepth uint8 `json:"maxdepth,omitempty"`

	// The pagination offset.
	Offset int `url:"offset,omitempty"`

	// The pagination limit.
	Limit int `url:"limit,omitempty"`
}

type Folder struct {
	// FolderID uuid.UUID `json:"folderid"` // TODO: Remove it?
	FolderID int64  `json:"folderid"`
	Name     string `json:"name"`
	Owner    *User  `json:"owner,omitempty"` // TODO: Do we need this field?
}

type FolderContent struct {
	OffsetResponse[Deviation]
	Name string `json:"name"`
}

type FolderParams struct {
	// The user who owns the folder, defaults to current user.
	Username string `url:"username,omitempty"`

	// Sort results by either newest or popular (when querying all folders
	// only).
	// This field is supported only by galleries.
	SortMode string `url:"mode,omitempty"` // values(newest, popular) default: popular
}

type FoldersParams struct {
	// The user to list folders for, if omitted the authenticated user is used.
	Username string `url:"username,omitempty"`

	// The option to include the content count per each collection folder.
	CalculateSize bool `url:"calculate_size,omitempty"`

	// Include first 5 deviations from the folder.
	IncludePreload bool `url:"ext_preload,omitempty"`

	// Filters collections with no deviations if true.
	FilterEmptyFolder bool `url:"filter_empty_folder,omitempty"`
}

type FoldersService[T Collection | Gallery] struct {
	// contains filtered or unexported fields
}

type Friend struct {
	User       *User     `json:"user"`
	IsWatching bool      `json:"is_watching"`
	WatchesYou bool      `json:"watches_you"`
	LastVisit  string    `json:"lastvisit,omitempty"` // TODO: Parse time.
	Watch      UserWatch `json:"watch"`
}

type FriendsSearchParams struct {
	Username string `url:"username,omitempty"`
	Search   string `url:"search,omitempty"`
	Query    string `url:"query,omitempty"`
}

type Gallery struct {
	FolderID          uuid.UUID          `json:"folderid"`
	Parent            uuid.UUID          `json:"parent,omitempty"`
	Name              string             `json:"name"`
	Description       string             `json:"folder"`
	Size              uint32             `json:"size,omitempty"`
	Thumb             *Deviation         `json:"thumb"`
	PremiumFolderData *PremiumFolderData `json:"premium_folder_data,omitempty"` // premium_folder_data
	HasSubfolders     bool               `json:"has_subfolders"`
	Subfolders        []Gallery          `json:"subfolders,omitempty"`
	Deviations        []Deviation        `json:"deviations,omitempty"`
}

type GalleryService struct {
	*FoldersService[Gallery]
	// contains filtered or unexported fields
}

type GetProfileParams struct {
	// Include collection folder info.
	IncludeCollections bool `url:"ext_collections,omitempty"`

	// Include gallery folder info.
	IncludeGalleries bool `url:"ext_galleries,omitempty"`
}

type ItemParams struct {
	IncludeSubmission bool `url:"ext_submission,omitempty"`
	IncludeCamera     bool `url:"ext_camera,omitempty"`
	IncludeStats      bool `url:"ext_stats,omitempty"`
}

type JournalStatus struct {
	Journal *Deviation `json:"journal"`
	Status  *Status    `json:"status"`
}

type LicenseOptions struct {
	CreativeCommons bool `url:"creative_commons,omitempty"`
	Commercial      bool `url:"commercial,omitempty"`
	// Valid values: yes, no, share
	Modify string `url:"modify,omitempty"`
}

type Message struct {
	MessageID  string `json:"messageid"`
	Type       string `json:"type"`
	Orphaned   bool   `json:"orphaned"`
	TS         string `json:"ts,omitempty"`
	StackID    string `json:"stackid,omitempty"`
	StackCount int    `json:"stack_count,omitempty"`
	IsNew      bool   `json:"is_new"`
	Originator *User  `json:"originator,omitempty"`
	Subject    *struct {
		Profile    *User      `json:"profile,omitempty"`
		Deviation  *Deviation `json:"deviation,omitempty"`
		Status     *Status    `json:"status,omitempty"`
		Comment    *Comment   `json:"comment,omitempty"`
		Collection *Folder    `json:"collection"`
		Gallery    *Folder    `json:"gallery"`
	} `json:"subject,omitempty"`
	HTML       string     `json:"html,omitempty"`
	Profile    *User      `json:"profile,omitempty"`
	Deviation  *Deviation `json:"deviation,omitempty"`
	Status     *Status    `json:"status,omitempty"`
	Comment    *Comment   `json:"comment,omitempty"`
	Collection *Folder    `json:"collection,omitempty"`
}

type MessagesFeedParams struct {
	// The folder to fetch messages from, defaults to inbox.
	FolderID uuid.UUID `url:"folderid,omitempty"`

	// True to use stacked mode, false to use flat mode.
	Stack bool `url:"stack,omitempty"`
}

type MessagesFeedbackParams struct {
	// Type of feedback messages to fetch.
	Type string `url:"type"`

	// The folder to fetch messages from, defaults to inbox.
	FolderID uuid.UUID `url:"folderid,omitempty"`

	// True to use stacked mode, false to use flat mode.
	Stack bool `url:"stack,omitempty"`
}

type MessagesMentionsParams struct {
	// The folder to fetch messages from, defaults to inbox.
	FolderID uuid.UUID `url:"folderid,omitempty"`

	// True to use stacked mode, false to use flat mode.
	Stack bool `url:"stack,omitempty"`

	// The pagination offset.
	Offset int `url:"offset,omitempty"`

	// The pagination limit.
	Limit int `url:"limit,omitempty"`
}

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

type MetadataParams struct {
	// The deviation IDs you want metadata for.
	DeviationIDs []uuid.UUID `url:"deviationids"`

	IncludeSubmission bool `url:"ext_submission,omitempty"`
	IncludeCamera     bool `url:"ext_camera,omitempty"`
	IncludeStats      bool `url:"ext_stats,omitempty"`
	IncludeCollection bool `url:"ext_collection,omitempty"`
	IncludeGallery    bool `url:"ext_gallery,omitempty"`
}

type MetadataResponse struct {
	Metatada []DeviationMetadata `json:"metadata"`
}

type ModuleCoverDeviation struct {
	CoverDeviation          Deviation `json:"cover_deviation,omitempty"`
	CoverDeviationIDOffsetY uint32    `json:"cover_deviationid_offset_y"`
	ImageWidth              uint32    `json:"image_width,omitempty"`
	ImageHeight             uint32    `json:"image_height,omitempty"`
	CropX                   uint32    `json:"crop_x,omitempty"`
	CropY                   uint32    `json:"crop_y,omitempty"`
	CropWidth               uint32    `json:"crop_width,omitempty"`
	CropHeight              uint32    `json:"crop_height,omitempty"`
}

type MoreLikeThisPreviewResponse struct {
	Seed                 uuid.UUID   `json:"seed"`
	Author               User        `json:"user"`
	MoreFromArtist       []Deviation `json:"more_from_artist"`
	MoreFromDeviantArt   []Deviation `json:"more_from_da"`
	SuggestedCollections []struct {
		Collection Folder      `json:"collection"` //Gallection
		Deviations []Deviation `json:"deviations"`
	} `json:"suggested_collections,omitempty"`
}

type MoveDeviationsParams struct {
	// The UUID of the folder to copy to.
	SourceFolderID uuid.UUID `url:"source_folderid"`

	// The UUID of the folder to copy to.
	TargetFolderID uuid.UUID `url:"target_folderid"`

	// The UUIDs of the deviations.
	DeviationIDs []uuid.UUID `url:"deviationids"`
}

type OffsetParams struct {
	// The pagination offset.
	Offset uint32 `url:"offset,omitempty"`

	// The pagination limit.
	Limit uint32 `url:"limit,omitempty"`
}

type OffsetResponse[T any] struct {
	Results    []T    `json:"results"`
	HasMore    bool   `json:"has_more"`
	NextOffset uint32 `json:"next_offset,omitempty"`

	// This field is used in some endpoints with a query parameter.
	// TODO: Use separate struct and API method (?).
	EstimatedTotal uint32 `json:"estimated_total,omitempty"`
}

type PopularParams struct {
	// Search query term.
	//
	// Estimated total results count would be available on EstimatedTotal field.
	Query string `url:"q,omitempty"`

	// The timerange.
	//
	// TODO: Valid values are: values(now, 1week, 1month, alltime).
	TimeRange string `url:"timerange,omitempty"`
}

type PostStatusParams struct {
	// The body of the status.
	Text string `url:"body,omitempty"`

	// The ID of the object you wish to share.
	ID uuid.UUID `url:"id,omitempty"`

	ParentID uuid.UUID
}

type PremiumFolderData struct {
	Type           string    `json:"type"`
	HasAccess      bool      `json:"has_access"`
	GalleryID      uuid.UUID `json:"gallery_id"`
	PointsPrice    int       `json:"points_price,omitempty"`
	DollarPrice    float64   `json:"dollar_price,omitempty"` // TODO: DeviationTier has the same string field.
	NumSubscribers int       `json:"num_subscribers,omitempty"`
	SubproductID   int       `json:"subproductid,omitempty"` // TODO: Is it really an integer field and not an UUID?
}

type Profile struct {
	User             User                  `json:"user"`
	IsWatching       bool                  `json:"is_watching"`
	ProfileURL       string                `json:"profile_url"`
	UserIsArtist     bool                  `json:"user_is_artist"`
	ArtistLevel      string                `json:"artist_level,omitempty"`
	ArtistSpeciality string                `json:"artist_specialty,omitempty"`
	RealName         string                `json:"real_name"`
	Tagline          string                `json:"tagline"`
	CountryID        uint8                 `json:"countryid"`
	Country          string                `json:"country"`
	Website          string                `json:"website"`
	Bio              string                `json:"bio"`
	CoverPhoto       string                `json:"cover_photo,omitempty"`
	CoverDeviation   *ModuleCoverDeviation `json:"cover_deviation,omitempty"`
	LastStatus       *Status               `json:"last_status,omitempty"`
	Stats            struct {
		UserDeviations   uint32 `json:"user_deviations"`
		UserFavourites   uint32 `json:"user_favourites"`
		UserComments     uint32 `json:"user_comments"`
		ProfilePageViews uint32 `json:"profile_pageviews"`
		ProfileComments  uint32 `json:"profile_comments"`
	} `json:"stats"`
	Collections []Folder `json:"collections,omitempty"`
	Galleries   []struct {
		FolderID uuid.UUID `json:"folderid"`
		Parent   uuid.UUID `json:"parent,omitempty"`
		Name     string    `json:"name"`
	} `json:"galleries,omitempty"`
}

type RemoveDeviationsParams struct {
	// The UUID of the folder to remove.
	FolderID uuid.UUID `url:"folderid"`

	// The UUIDs of the deviations.
	DeviationIDs []uuid.UUID `url:"deviationids"`
}

type StackContentsParams struct {
	Offset uint16 `url:"offset,omitempty"`
	Limit  uint8  `url:"limit,omitempty"`

	IncludeSubmission bool `url:"ext_submission,omitempty"`
	IncludeCamera     bool `url:"ext_camera,omitempty"`
	IncludeStats      bool `url:"ext_stats,omitempty"`
}

type StashDeltaParams struct {
	// The cursor hash provided to your app in the last delta call.
	Cursor string `url:"cursor,omitempty"`

	// The pagination offset
	Offset int `url:"offset,omitempty"`

	// The pagination limit
	Limit int `url:"limit,omitempty"`

	// Include extended submission information
	IncludeSubmission bool `url:"ext_submission"`

	// Include camera EXIF information
	IncludeCamera bool `url:"ext_camera"`

	// Include extended statistics
	IncludeStats bool `url:"ext_stats"`
}

type StashDeltaResponse struct {
	Cursor     string `json:"cursor"`
	HasMore    bool   `json:"has_more"`
	NextOffset int    `json:"next_offset"`
	Reset      bool   `json:"reset"`
	Entries    []struct {
		ItemID   int64         `json:"itemid,omitempty"`
		StackID  int64         `json:"stackid,omitempty"`
		Metadata StashMetadata `json:"stash_metadata"`
		Position int           `json:"position,omitempty"`
	} `json:"entries,omitempty"`
}

type StashFile struct {
	Transparency bool `json:"transparency"`
	// contains filtered or unexported fields
}

type StashItem struct {
	ItemID   int64    `json:"itemid"`
	HTML     string   `json:"html,omitempty"`
	CSS      string   `json:"css,omitempty"`
	CSSFonts []string `json:"css_fonts,omitempty"`
	StashMetadata
}

type StashMetadata struct {
	Title          string            `json:"title"`
	Path           string            `json:"path,omitempty"`
	Size           int               `json:"size,omitempty"`
	Description    string            `json:"description,omitempty"` // html
	ParentID       int               `json:"parentid,omitempty"`
	Thumb          *StashFile        `json:"thumb,omitempty"`
	ArtistComments string            `json:"artist_comments,omitempty"` //html
	OriginalURL    string            `json:"original_url,omitempty"`
	Category       string            `json:"category,omitempty"`
	CreationTime   int64             `json:"creation_time,omitempty"`
	Files          []StashFile       `json:"files,omitempty"`
	Submission     *StashSubmission  `json:"submission,omitempty"`
	Stats          *StashStats       `json:"stats,omitempty"`
	Camera         map[string]string `json:"camera,omitempty"`
	StackID        int               `json:"stackid"`
	Tags           []string          `json:"tags,omitempty"`
}

type StashMoveResponse struct {
	Target  StashMetadata   `json:"target"`
	Changes []StashMetadata `json:"changes"`
}

type StashPublishParams struct {
	// The ID of the stash item to publish.
	ItemID int64 `url:"itemid"`

	// Submission is mature or not.
	IsMature bool `url:"is_mature"`

	// The mature level of the submission, required for mature submissions.
	MatureLevel string `url:"mature_level,omitempty"`

	// The mature classification of the submission.
	MatureClassification []string `url:"mature_classification,brackets,omitempty"`

	// Agree to submission policy.
	AgreeSubmission bool `url:"agree_submission"`

	// Agree to terms of service.
	AgreeToS bool `url:"agree_tos"`

	// Feature the submission. Default: true.
	Feature bool `url:"feature,omitempty"`

	// Allow comments on the submission. Default: true.
	AllowComments bool `url:"allow_comments,omitempty"`

	// Request a critique, only available to some users see `/publish/userdata`.
	RequestCritique bool `url:"request_critique,omitempty"`

	// Resize image to. Cannot be bigger than image and is ignored for non images.
	DisplayResolution DisplayResolution `url:"display_resolution,omitempty"`

	// Sharing options.
	SharingOptions string `url:"sharing,omitempty"`

	// License options.
	LicenseOptions LicenseOptions `url:"license_options,omitempty"`

	// UUIDs of gallery folders to publish this submission to.
	GalleryIDs []string `url:"galleryids,omitempty"`

	// Offer original file as a free download.
	AllowFreeDownload bool `url:"allow_free_download,omitempty"`

	// Add watermark. Available only if display_resolution is present.
	AddWatermark bool `url:"add_watermark,omitempty"`
}

type StashPublishResponse struct {
	StatusResponse
	URL         string    `json:"url"`
	DeviationID uuid.UUID `json:"deviationid"`
}

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

type StashSpace struct {
	AvailableSpace uint64 `json:"available_space"`
	TotalSpace     uint64 `json:"total_space"`
}

type StashStats struct {
	Views          int `json:"views,omitempty"`
	ViewsToday     int `json:"views_today,omitempty"`
	Downloads      int `json:"downloads,omitempty"`
	DownloadsToday int `json:"downloads_today,omitempty"`
}

type StashSubmission struct {
	FileSize      string `json:"file_size,omitempty"`
	Resolution    string `json:"resolution,omitempty"`
	SubmittedWith *struct {
		App string `json:"app,omitempty"`
		URL string `json:"url,omitempty"`
	} `json:"submitted_with,omitempty"`
}

type StashSubmitParams struct {
	// The title of the submission.
	Title string `url:"title,omitempty"`

	// Additional information about the submission provided by the author.
	Description string `url:"artist_comments,omitempty"`

	// An array of tags describing the submission. Letters, numbers and
	// underscore only.
	Tags []string `url:"tags,brackets,omitempty"`

	// A link to the original, in case the artwork has already been posted
	// elsewhere. This field can be restricted with a whitelist by editing your
	// deviantART app.
	OriginalURL string `url:"original_url,omitempty"`

	// Is the submission being worked on currently. You can use this flag to
	// warn users that the item is being edited and may change if they reload.
	// Note this does NOT provide any type of locking.
	IsDirty bool `url:"is_dirty,omitempty"`

	// The id of an existing Sta.sh submission. This can be used to overwrite
	// files and /metadata of existing submissions. If you make a new API call
	// containing files, the files that were previously associated with the
	// artwork will be replaced by the new ones.
	ItemID int64 `url:"itemid,omitempty"`

	// The name of the stack to create and place the new submission in. Applies
	// to new submissions only. (Ignored if `stackid` is set).
	Stack string `url:"stack,omitempty"`

	// The id of the stack to create and place the new submission in. Applies to
	// new submissions only.
	StackID int64 `url:"stackid,omitempty"`
}

type StashUpdateParams struct {
	Title       string `url:"title,omitempty"`
	Description string `url:"description,omitempty"`
}

type StashUserdata struct {
	Features   []string `json:"features"`
	Agreements []string `json:"agreements"`
}

type Status struct {
	StatusID      uuid.UUID `json:"statusid,omitempty"`
	Body          string    `json:"html,omitempty"`
	Timestamp     string    `json:"ts,omitempty"` // TODO: Parse to time.Time.
	URL           string    `json:"url,omitempty"`
	CommentsCount int       `json:"comments_count,omitempty"`
	IsShare       bool      `json:"is_share,omitempty"`
	IsDeleted     bool      `json:"is_deleted,omitempty"`
	Author        *User     `json:"user,omitempty"`
	Items         []struct {
		Type      string     `json:"type"`
		Status    *Status    `json:"status,omitempty"`
		Deviation *Deviation `json:"deviation,omitempty"`
	} `json:"items,omitempty"`
	TextContent *struct {
		Excerpt string `json:"excerpt"`
		Body    struct {
			Type     string `json:"type"`
			Markup   string `json:"markup,omitempty"`
			Features string `json:"features"`
		} `json:"body"`
	} `json:"text_content,omitempty"`
}

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

type SubmitResponse struct {
	StatusResponse
	ItemID  int64  `json:"itemid"`
	Stack   string `json:"stack,omitempty"`
	StackID int64  `json:"stackid,omitempty"`
}

type Topic struct {
	Name              string      `json:"name"`
	CanonicalName     string      `json:"canonical_name"`
	ExampleDeviations []Deviation `json:"example_deviations,omitempty"`
}

type UpdateDeviationOrderParams struct {
	// The UUID of the gallery folder.
	FolderID uuid.UUID `url:"folderid"`

	// The UUID of the deviation.
	DeviationID uuid.UUID `url:"deviationid"`

	// The new position.
	Position int `url:"position"`
}

type UpdateFoldersParams struct {
	// The UUID of the folder to rename.
	FolderID uuid.UUID `url:"folderid"`

	// Folder new name.
	Name string `url:"name,omitempty"`

	// Folder description.
	Description string `url:"description,omitempty"`

	// Folder thumb.
	CoverDeviationID uuid.UUID `url:"cover_deviationid,omitempty"`
}

type UpdateJournalParams struct {
	// Journal title.
	Title string `url:"title"`

	// Journal tags.
	Tags []string `url:"tags,brackets,omitempty"`

	// Cover deviation ID.
	CoverImageDeviationID uuid.UUID `url:"cover_image_deviation_id,omitempty"`

	// Reset cover deviation ID.
	ResetCoverImageDeviationID bool `url:"reset_cover_image_deviation_id,omitempty"`

	// Submission is mature or not.
	IsMature bool `url:"is_mature,omitempty"`

	// Allow comments on the submission.
	AllowComments bool `url:"allow_comments,omitempty"`

	// License options.
	LicenseOptions LicenseOptions `url:"license_options,omitempty"`
}

type UpdateLiteratureParams struct {
	// Literature title.
	Title string `url:"title"`

	// Literature tags.
	Tags []string `url:"tags,brackets,omitempty"`

	// UUIDs of gallery folders to publish this submission to.
	GalleryIDs []uuid.UUID `url:"galleryids,omitempty"`

	// Submission is mature or not.
	IsMature bool `url:"is_mature"`

	// The mature level of the submission, required for mature submissions.
	MatureLevel string `url:"mature_level,omitempty"`

	// The mature classification of the submission.
	MatureClassification []string `url:"mature_classification,brackets,omitempty"`

	// Allow comments on the submission
	AllowComments bool `url:"allow_comments,omitempty"`

	// License options.
	LicenseOptions []LicenseOptions `url:"license_options"`
}

type UpdateOrderParams struct {
	// The UUID of the folder to reposition.
	FolderID uuid.UUID `url:"folderid"`

	// The new position.
	Position int `url:"position"`
}

type User struct {
	UserID       uuid.UUID `json:"userid"`
	UserName     string    `json:"username"`
	UserIcon     string    `json:"usericon"`
	Type         string    `json:"type"`
	IsWatching   bool      `json:"is_watching,omitempty"`
	IsSubscribed bool      `json:"is_subscribed,omitempty"`
	Details      struct {
		Sex      string `json:"sex,omitempty"`
		Age      uint8  `json:"age,omitempty"`
		JoinDate string `json:"joindate"`
	} `json:"details,omitempty"`
	Geo struct {
		Country   string `json:"country"`
		CountryID uint8  `json:"countryid"`
		Timezone  string `json:"timezone"`
	} `json:"get,omitempty"`
	Profile struct {
		UserIsArtist     bool   `json:"user_is_artist"`
		ArtistLevel      string `json:"artist_level,omitempty"`
		ArtistSpeciality string `json:"artist_speciality,omitempty"`
		RealName         string `json:"real_name"`
		Tagline          string `json:"tagline"`
		Website          string `json:"website"`
		CoverPhoto       string `json:"cover_photo"`
	} `json:"profile,omitempty"`
	Stats struct {
		Watchers int32 `json:"watchers"`
		Friends  int32 `json:"friends"`
	} `json:"stats,omitempty"`
	Sidebar struct {
		Watched struct {
			HasNewContent bool `json:"has_new_content"`
			LinkSubnav    struct {
				ContentType string `json:"content_type"`
			} `json:"link_subnav"`
			IsPinned bool `json:"is_pinned"`
		} `json:"watched,omitempty"`
	} `json:"sidebar,omitempty"`
}

type UserInfoParams struct {
	// Is the user an artist?
	UserIsArtist bool `url:"user_is_artist,omitempty"`

	// If the user is an artist, what level are they.
	ArtistLevel string `url:"artist_level,omitempty"`

	// If the user is an artist, what is their specialty.
	ArtistSpeciality string `url:"artist_specialty,omitempty"`

	// The users location.
	CountryID int `url:"countryid,omitempty"`

	// The users personal website.
	Website      string `url:"website,omitempty"`
	WebsiteLabel string `url:"website_label,omitempty"`

	// The users tagline.
	Tagline string `url:"tagline,omitempty"`

	ShowBadges  bool     `url:"show_badges,omitempty"`
	Interests   []string `url:"interests,omitempty"`    // TODO: Check positional params.
	SocialLinks []string `url:"social_links,omitempty"` // TODO: Check positional params.
}

type UserJournalsParams struct {
	// The username of the user to fetch journals for.
	Username string `url:"username"`

	// Fetch only featured or not.
	Featured bool `url:"featured,omitempty"`
}

type UserService struct {
	Friends *friendsService
	// contains filtered or unexported fields
}

type UserWatch struct {
	Friend       bool `json:"friend" url:"friend"`
	Deviations   bool `json:"deviations" url:"deviations"`
	Journals     bool `json:"journals" url:"journals"`
	ForumThreads bool `json:"forum_threads" url:"forum_threads"`
	Critiques    bool `json:"critiques" url:"critiques"`
	Scraps       bool `json:"scraps" url:"scraps"`
	Activity     bool `json:"activity" url:"activity"`
	Collections  bool `json:"collections" url:"collections"`
}