doc.go

// Package bitwarden provides a comprehensive Go client library for Bitwarden and

// Vaultwarden password managers. It supports both CLI-based communication (via bw serve)

// and direct server communication with end-to-end encryption.

//

// The library provides two client modes:

//

//   - Client: Communicates via Bitwarden CLI's "bw serve" API (requires running CLI)

//   - DirectClient: Direct server communication with full encryption support (no CLI needed)

//

// Both clients implement the VaultClient interface, providing a unified API for vault operations

// including items, folders, collections, organizations, Send, and attachments.

//

// Basic usage with Client:

//

//	client := bitwarden.NewClient()

//	err := client.Unlock(context.Background(), "master-password")

//	items, _ := client.Items().List(context.Background(), nil)

//

// Basic usage with DirectClient:

//

//	client := bitwarden.NewDirectClient(

//	    "https://vault.bitwarden.com",

//	    "user@example.com",

//	    "master-password",

//	)

//	err := client.Unlock(context.Background(), "master-password")

//	client.Sync(context.Background())

//	items, _ := client.Items().List(context.Background(), nil)

package bitwarden