secretbin

type Attachment struct {
	Name        string `json:"name"`        // Filename of the attachment
	ContentType string `json:"contentType"` // MIME type of the attachment
	Data        []byte `json:"data"`        // Binary data of the attachment
}

type Banner struct {
	Type string `json:"type"` // Type of the banner ("info", "warning", "error")
	Text string `json:"text"` // Text content of the banner
}

type Client interface {
	// Config returns information about the SecretBin server.
	Config() *Config

	// SubmitSecret creates a new secret inside SecretBin and returns the access URL for said secret.
	SubmitSecret(secret Secret, options Options) (string, error)
}

type Config struct {
	Name           string             // Name of the SecretBin instance
	Endpoint       string             // Endpoint URL of the SecretBin server
	Version        *semver.Version    // Version of the SecretBin server
	Banner         *Banner            // Optional banner displayed by the server
	Expires        map[string]Expires // Available expiration options for secrets
	DefaultExpires string             // Default expiration option for secrets
}

type Expires struct {
	Count   int    `json:"count"`   // Number of units for this expiration option
	Unit    string `json:"unit"`    // Unit of time for this expiration option (e.g., "hr", "d", "w", "m", "y")
	Seconds int    `json:"seconds"` // Duration in seconds for this expiration option
}

type Options struct {
	// Password is used as an additional security step along the the encryption key (optional)
	Password string

	// Expires is the expiration time for the secret.
	//
	// Use [Client.Config().Expires] to get the available options.
	Expires string

	// BurnAfter indicates after how many reads the secret should be deleted.
	//
	// 0 means no burn after reading.
	BurnAfter uint
}

type PasswordOptions struct {
	Uppercase bool
	Lowercase bool
	Digits    bool
	Symbols   bool
	Length    int
}

type Secret struct {
	Message     string        `json:"message"`     // Text content of the secret
	Attachments []*Attachment `json:"attachments"` // Optional file attachments of the secret
}

type SecretBinError struct {
	Name    string `json:"name"`
	Message string `json:"message"`
	Status  int    `json:"status"`
}