type AddressFieldDetails struct {
	// The street address
	Street string `json:"street"`
	// The city
	City string `json:"city"`
	// The country
	Country string `json:"country"`
	// The ZIP code
	Zip string `json:"zip"`
	// The state
	State string `json:"state"`
}

type AllowedRecipientType string

type AllowedType string

type AutofillBehavior string

type Client struct {
	SecretsAPI      SecretsAPI
	ItemsAPI        ItemsAPI
	VaultsAPI       VaultsAPI
	EnvironmentsAPI EnvironmentsAPI
	GroupsAPI       GroupsAPI
	// contains filtered or unexported fields
}

type ClientOption func(client *Client) error

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

type DocumentCreateParams struct {
	// The name of the file
	Name string `json:"name"`
	// The content of the file
	Content []byte `json:"content"`
}

type EnvironmentVariable struct {
	// An environment variable's name
	Name string `json:"name"`
	// An environment variable's value
	Value string `json:"value"`
	// An environment variable's masked state
	Masked bool `json:"masked"`
}

type EnvironmentsAPI interface {
	// Get environment variables belonging to an Environment.
	GetVariables(ctx context.Context, environmentID string) (GetVariablesResponse, error)
}

type EnvironmentsSource struct {
	*internal.InnerClient
}

type ErrorMessage string

type FileAttributes struct {
	// The name of the file
	Name string `json:"name"`
	// The ID of the file retrieved from the server
	ID string `json:"id"`
	// The size of the file in bytes
	Size uint32 `json:"size"`
}

type FileCreateParams struct {
	// The name of the file
	Name string `json:"name"`
	// The content of the file
	Content []byte `json:"content"`
	// The section id where the file should be stored
	SectionID string `json:"sectionId"`
	// The field id where the file should be stored
	FieldID string `json:"fieldId"`
}

type GeneratePasswordResponse struct {
	// The generated password.
	Password string `json:"password"`
}

type GetVariablesResponse struct {
	// List of environment variables.
	Variables []EnvironmentVariable `json:"variables"`
}

type Group struct {
	ID          string        `json:"id"`
	Title       string        `json:"title"`
	Description string        `json:"description"`
	GroupType   GroupType     `json:"groupType"`
	State       GroupState    `json:"state"`
	VaultAccess []VaultAccess `json:"vaultAccess,omitempty"`
}

type GroupAccess struct {
	// The group's ID
	GroupID string `json:"groupId"`
	// The group's set of permissions for the vault
	Permissions uint32 `json:"permissions"`
}

type GroupGetParams struct {
	VaultPermissions *bool `json:"vaultPermissions,omitempty"`
}

type GroupState string

type GroupType string

type GroupVaultAccess struct {
	// The vault's ID
	VaultID string `json:"vaultId"`
	// The group's ID
	GroupID string `json:"groupId"`
	// The group's set of permissions for the vault
	Permissions uint32 `json:"permissions"`
}

type GroupsAPI interface {
	// Get a group by its ID and parameters.
	Get(ctx context.Context, groupID string, groupParams GroupGetParams) (Group, error)
}

type GroupsSource struct {
	*internal.InnerClient
}

type Item struct {
	// The item's ID
	ID string `json:"id"`
	// The item's title
	Title string `json:"title"`
	// The item's category
	Category ItemCategory `json:"category"`
	// The ID of the vault where the item is saved
	VaultID string `json:"vaultId"`
	// The item's fields
	Fields []ItemField `json:"fields"`
	// The item's sections
	Sections []ItemSection `json:"sections"`
	// The notes of the item
	Notes string `json:"notes"`
	// The item's tags
	Tags []string `json:"tags"`
	// The websites used for autofilling for items of the Login and Password categories.
	Websites []Website `json:"websites"`
	// The item's version
	Version uint32 `json:"version"`
	// The item's file fields
	Files []ItemFile `json:"files"`
	// The document file for the Document item category
	Document *FileAttributes `json:"document,omitempty"`
	// The time the item was created at
	CreatedAt time.Time `json:"createdAt"`
	// The time the item was updated at
	UpdatedAt time.Time `json:"updatedAt"`
}

type ItemCategory string

type ItemCreateParams struct {
	// The item's category
	Category ItemCategory `json:"category"`
	// The ID of the vault where the item is saved
	VaultID string `json:"vaultId"`
	// The item's title
	Title string `json:"title"`
	// The item's fields
	Fields []ItemField `json:"fields,omitempty"`
	// The item's sections
	Sections []ItemSection `json:"sections,omitempty"`
	// The item's notes
	Notes *string `json:"notes,omitempty"`
	// The item's tags
	Tags []string `json:"tags,omitempty"`
	// The websites used for autofilling for items of the Login and Password categories.
	Websites []Website `json:"websites,omitempty"`
	// The item's files stored as fields
	Files []FileCreateParams `json:"files,omitempty"`
	// The document file for the Document item type. Empty when the item isn't of Document type.
	Document *DocumentCreateParams `json:"document,omitempty"`
}

type ItemField struct {
	// The field's ID
	ID string `json:"id"`
	// The field's title
	Title string `json:"title"`
	// The ID of the section containing the field. Built-in fields such as usernames and passwords don't require a section.
	SectionID *string `json:"sectionId,omitempty"`
	// The field's type
	FieldType ItemFieldType `json:"fieldType"`
	// The string representation of the field's value
	Value string `json:"value"`
	// Field type-specific attributes.
	Details *ItemFieldDetails `json:"details,omitempty"`
}

type ItemFieldDetails struct {
	Type ItemFieldDetailsTypes `json:"type"`
	// contains filtered or unexported fields
}

type ItemFieldDetailsTypes string

type ItemFieldType string

type ItemFile struct {
	// the attributes of the file
	Attributes FileAttributes `json:"attributes"`
	// the section id where the file should be stored
	SectionID string `json:"sectionId"`
	// the field id where the file should be stored
	FieldID string `json:"fieldId"`
}

type ItemListFilter struct {
	Type ItemListFilterTypes `json:"type"`
	// contains filtered or unexported fields
}

type ItemListFilterByStateInner struct {
	Active   bool `json:"active"`
	Archived bool `json:"archived"`
}

type ItemListFilterTypes string

type ItemOverview struct {
	// The item's ID
	ID string `json:"id"`
	// The item's title
	Title string `json:"title"`
	// The item's category
	Category ItemCategory `json:"category"`
	// The ID of the vault where the item is saved
	VaultID string `json:"vaultId"`
	// The websites used for autofilling for items of the Login and Password categories.
	Websites []Website `json:"websites"`
	// The item tags
	Tags []string `json:"tags"`
	// The time the item was created at
	CreatedAt time.Time `json:"createdAt"`
	// The time the item was updated at
	UpdatedAt time.Time `json:"updatedAt"`
	// Indicates the state of the item
	State ItemState `json:"state"`
}

type ItemSection struct {
	// The section's unique ID
	ID string `json:"id"`
	// The section's title
	Title string `json:"title"`
}

type ItemShareAccountPolicy struct {
	// The maximum duration that an item can be shared for
	MaxExpiry ItemShareDuration `json:"maxExpiry"`
	// The default duration that an item is shared for
	DefaultExpiry ItemShareDuration `json:"defaultExpiry"`
	// The maximum number of times an item can be viewed. A null value means unlimited views
	MaxViews *uint32 `json:"maxViews,omitempty"`
	// The allowed types of item sharing - either "Authenticated" (share to specific users) or "Public" (share to anyone with a link)
	AllowedTypes []AllowedType `json:"allowedTypes"`
	// The allowed recipient types of item sharing - either "Email" or "Domain"
	AllowedRecipientTypes []AllowedRecipientType `json:"allowedRecipientTypes"`
	// The file sharing policy
	Files ItemShareFiles `json:"files"`
}

type ItemShareDuration string

type ItemShareFiles struct {
	// Whether files can be included in item shares
	Allowed bool `json:"allowed"`
	// The maximum encrypted size (in bytes) an included file can be
	MaxSize uint32 `json:"maxSize"`
	// The allowed types of item sharing - either "Authenticated" (share to specific users) or "Public" (share to anyone with a link)
	AllowedTypes []AllowedType `json:"allowedTypes,omitempty"`
	// The allowed recipient types of item sharing - either "Email" or "Domain"
	AllowedRecipientTypes []AllowedRecipientType `json:"allowedRecipientTypes,omitempty"`
	// The maximum duration that an item can be shared for
	MaxExpiry *ItemShareDuration `json:"maxExpiry,omitempty"`
	// The default duration that an item is shared for
	DefaultExpiry *ItemShareDuration `json:"defaultExpiry,omitempty"`
	// The maximum number of times an item can be viewed. A null value means unlimited views
	MaxViews *uint32 `json:"maxViews,omitempty"`
}

type ItemShareParams struct {
	// Emails or domains of the item share recipients. If not provided, everyone with the share link will have access
	Recipients []ValidRecipient `json:"recipients,omitempty"`
	// The duration of the share in seconds. If not provided, defaults to the account policy's default expiry
	ExpireAfter *ItemShareDuration `json:"expireAfter,omitempty"`
	// Whether the item can only be viewed once per recipient
	OneTimeOnly bool `json:"oneTimeOnly"`
}

type ItemState string

type ItemUpdateFailureReason struct {
	Type ItemUpdateFailureReasonTypes `json:"type"`
	// contains filtered or unexported fields
}

type ItemUpdateFailureReasonTypes string

type ItemsAPI interface {
	// Create a new item.
	Create(ctx context.Context, params ItemCreateParams) (Item, error)

	// Create items in batch, within a single vault.
	CreateAll(ctx context.Context, vaultID string, params []ItemCreateParams) (ItemsUpdateAllResponse, error)

	// Get an item by vault and item ID.
	Get(ctx context.Context, vaultID string, itemID string) (Item, error)

	// Get items by vault and their item IDs.
	GetAll(ctx context.Context, vaultID string, itemIds []string) (ItemsGetAllResponse, error)

	// Update an existing item.
	Put(ctx context.Context, item Item) (Item, error)

	// Delete an item.
	Delete(ctx context.Context, vaultID string, itemID string) error

	// Delete items in batch, within a single vault.
	DeleteAll(ctx context.Context, vaultID string, itemIds []string) (ItemsDeleteAllResponse, error)

	// Archive an item.
	Archive(ctx context.Context, vaultID string, itemID string) error

	// List items based on filters.
	List(ctx context.Context, vaultID string, filters ...ItemListFilter) ([]ItemOverview, error)

	// ----- Sub APIs - these methods are used to access subordinate function groups -----
	Shares() ItemsSharesAPI
	Files() ItemsFilesAPI
}

type ItemsDeleteAllResponse struct {
	IndividualResponses map[string]Response[struct{}, ItemUpdateFailureReason] `json:"individualResponses"`
}

type ItemsFilesAPI interface {
	// Attach files to Items.
	Attach(ctx context.Context, item Item, fileParams FileCreateParams) (Item, error)

	// Read file content from the Item.
	Read(ctx context.Context, vaultID string, itemID string, attr FileAttributes) ([]byte, error)

	// Delete a field file from Item using the section and field IDs.
	Delete(ctx context.Context, item Item, sectionID string, fieldID string) (Item, error)

	// Replace the document file within a document item.
	ReplaceDocument(ctx context.Context, item Item, docParams DocumentCreateParams) (Item, error)
}

type ItemsFilesSource struct {
	*internal.InnerClient
}

type ItemsGetAllError struct {
	Type ItemsGetAllErrorTypes `json:"type"`
	// contains filtered or unexported fields
}

type ItemsGetAllErrorTypes string

type ItemsGetAllResponse struct {
	IndividualResponses []Response[Item, ItemsGetAllError] `json:"individualResponses"`
}

type ItemsSharesAPI interface {
	// Get the item sharing policy of your account.
	GetAccountPolicy(ctx context.Context, vaultID string, itemID string) (ItemShareAccountPolicy, error)

	// Validate the recipients of an item sharing link.
	ValidateRecipients(ctx context.Context, policy ItemShareAccountPolicy, recipients []string) ([]ValidRecipient, error)

	// Create a new item sharing link.
	Create(ctx context.Context, item Item, policy ItemShareAccountPolicy, params ItemShareParams) (string, error)
}

type ItemsSharesSource struct {
	*internal.InnerClient
}

type ItemsSource struct {
	*internal.InnerClient
	SharesAPI ItemsSharesAPI
	FilesAPI  ItemsFilesAPI
}

type ItemsUpdateAllResponse struct {
	IndividualResponses []Response[Item, ItemUpdateFailureReason] `json:"individualResponses"`
}

type OTPFieldDetails struct {
	// The OTP code, if successfully computed
	Code *string `json:"code,omitempty"`
	// The error message, if the OTP code could not be computed
	ErrorMessage *string `json:"errorMessage,omitempty"`
}

type PasswordRecipe struct {
	Type PasswordRecipeTypes `json:"type"`
	// contains filtered or unexported fields
}

type PasswordRecipeMemorableInner struct {
	// The type of separator between chunks.
	SeparatorType SeparatorType `json:"separatorType"`
	// Uppercase one randomly selected chunk.
	Capitalize bool `json:"capitalize"`
	// The type of word list used.
	WordListType WordListType `json:"wordListType"`
	// The number of "words" (words or syllables).
	WordCount uint32 `json:"wordCount"`
}

type PasswordRecipePinInner struct {
	// Number of digits in the PIN.
	Length uint32 `json:"length"`
}

type PasswordRecipeRandomInner struct {
	// Include at least one digit in the password.
	IncludeDigits bool `json:"includeDigits"`
	// Include at least one symbol in the password.
	IncludeSymbols bool `json:"includeSymbols"`
	// The length of the password.
	Length uint32 `json:"length"`
}

type PasswordRecipeTypes string

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

type ResolveAllResponse struct {
	IndividualResponses map[string]Response[ResolvedReference, ResolveReferenceError] `json:"individualResponses"`
}

type ResolveReferenceError struct {
	Type ResolveReferenceErrorTypes `json:"type"`
	// contains filtered or unexported fields
}

type ResolveReferenceErrorTypes string

type ResolvedReference struct {
	Secret  string `json:"secret"`
	ItemID  string `json:"itemId"`
	VaultID string `json:"vaultId"`
}

type Response[T any, E any] struct {
	Content *T `json:"content,omitempty"`
	Error   *E `json:"error,omitempty"`
}

type SSHKeyAttributes struct {
	// The public part of the SSH Key
	PublicKey string `json:"publicKey"`
	// The fingerprint of the SSH Key
	Fingerprint string `json:"fingerprint"`
	// The key type ("Ed25519" or "RSA, {length}-bit")
	KeyType string `json:"keyType"`
}

type SecretsAPI interface {
	// Resolve returns the secret the provided secret reference points to.
	Resolve(ctx context.Context, secretReference string) (string, error)

	// Resolve takes in a list of secret references and returns the secrets they point to or errors if any.
	ResolveAll(ctx context.Context, secretReferences []string) (ResolveAllResponse, error)
}

type SecretsSource struct {
	*internal.InnerClient
}

type SeparatorType string

type ValidRecipient struct {
	Type ValidRecipientTypes `json:"type"`
	// contains filtered or unexported fields
}

type ValidRecipientDomainInner struct {
	Domain string `json:"domain"`
}

type ValidRecipientEmailInner struct {
	Email string `json:"email"`
}

type ValidRecipientTypes string

type Vault struct {
	// The vault's ID.
	ID string `json:"id"`
	// The vault's title.
	Title string `json:"title"`
	// The description of the vault.
	Description string `json:"description"`
	// The type of the vault.
	VaultType VaultType `json:"vaultType"`
	// The number of active items within the vault.
	ActiveItemCount uint32 `json:"activeItemCount"`
	// The content version number of the vault. It gets incremented whenever the state of the vault's contents changes (e.g. items from within the vault get created or updated).
	ContentVersion uint32 `json:"contentVersion"`
	// The attribute version number of the vault. It gets incremented whenever vault presentation information changes, such as its title or icon.
	AttributeVersion uint32 `json:"attributeVersion"`
	// The access information associated with the vault.
	Access []VaultAccess `json:"access,omitempty"`
}

type VaultAccess struct {
	// The vault's UUID.
	VaultUuid string `json:"vaultUuid"`
	// The vault's accessor type.
	AccessorType VaultAccessorType `json:"accessorType"`
	// The vault's accessor UUID.
	AccessorUuid string `json:"accessorUuid"`
	// The permissions granted to this vault
	Permissions uint32 `json:"permissions"`
}

type VaultAccessorType string

type VaultCreateParams struct {
	Title             string  `json:"title"`
	Description       *string `json:"description,omitempty"`
	AllowAdminsAccess *bool   `json:"allowAdminsAccess,omitempty"`
}

type VaultGetParams struct {
	// The vault's accessor params.
	Accessors *bool `json:"accessors,omitempty"`
}

type VaultListParams struct {
	DecryptDetails *bool `json:"decryptDetails,omitempty"`
}

type VaultOverview struct {
	// The vault's ID.
	ID string `json:"id"`
	// The vault's title.
	Title string `json:"title"`
	// The description of this vault.
	Description string `json:"description"`
	// The type of the vault.
	VaultType VaultType `json:"vaultType"`
	// The number of active items within the vault.
	ActiveItemCount uint32 `json:"activeItemCount"`
	// The content version number of the vault. It gets incremented whenever the state of the vault's contents changes (e.g. items from within the vault get created or updated).
	ContentVersion uint32 `json:"contentVersion"`
	// The attribute version number of the vault. It gets incremented whenever vault presentation information changes, such as its title or icon.
	AttributeVersion uint32 `json:"attributeVersion"`
	// The time the vault was created at
	CreatedAt time.Time `json:"createdAt"`
	// The time the vault was updated at
	UpdatedAt time.Time `json:"updatedAt"`
}

type VaultType string

type VaultUpdateParams struct {
	Title       *string `json:"title,omitempty"`
	Description *string `json:"description,omitempty"`
}

type VaultsAPI interface {
	// Create a new user vault.
	Create(ctx context.Context, params VaultCreateParams) (Vault, error)

	// List information about vaults that's configurable based on some input parameters.
	List(ctx context.Context, params ...VaultListParams) ([]VaultOverview, error)

	// Get an overview of a vault by its ID.
	GetOverview(ctx context.Context, vaultID string) (VaultOverview, error)

	// Get detailed vault information by vault ID and parameters.
	Get(ctx context.Context, vaultID string, vaultParams VaultGetParams) (Vault, error)

	// Update a vault
	Update(ctx context.Context, vaultID string, params VaultUpdateParams) (Vault, error)

	// Delete a vault by its ID.
	Delete(ctx context.Context, vaultID string) error

	// Grant group permissions to a vault.
	GrantGroupPermissions(ctx context.Context, vaultID string, groupPermissionsList []GroupAccess) error

	// Update group permissions for vaults.
	UpdateGroupPermissions(ctx context.Context, groupPermissionsList []GroupVaultAccess) error

	// Revoke group permissions from a vault.
	RevokeGroupPermissions(ctx context.Context, vaultID string, groupID string) error
}

type VaultsSource struct {
	*internal.InnerClient
}

type Website struct {
	// The website URL
	URL string `json:"url"`
	// The label of the website, e.g. 'website', 'sign-in address'
	Label string `json:"label"`
	// The auto-fill behavior of the website
	//
	// For more information, visit <https://support.1password.com/autofill-behavior/>
	AutofillBehavior AutofillBehavior `json:"autofillBehavior"`
}

type WordListType string