commerce

type Client interface {
	// GetOrCreateCustomer idempotently resolves a Commerce customer for an IAM
	// user, keyed by the user's IAM id stored in customer metadata. This is the
	// unified IAM↔Commerce link from the Python unified.py.
	GetOrCreateCustomer(ctx context.Context, u User) (*Customer, error)

	// GetCustomer fetches a customer by Commerce id.
	GetCustomer(ctx context.Context, customerID string) (*Customer, error)

	// CreateSubscription subscribes a customer to a plan tier.
	CreateSubscription(ctx context.Context, customerID, tier string) (*Subscription, error)

	// GetSubscription fetches a subscription by id.
	GetSubscription(ctx context.Context, subscriptionID string) (*Subscription, error)

	// CancelSubscription cancels a subscription. When immediate is false the
	// subscription is scheduled to end at the current period boundary.
	CancelSubscription(ctx context.Context, subscriptionID string, immediate bool) error

	// ReportUsage records metered usage (compute units) against a subscription.
	ReportUsage(ctx context.Context, subscriptionID string, quantity int64, idempotencyKey string) error

	// ListInvoices returns a customer's invoices, most recent first.
	ListInvoices(ctx context.Context, customerID string) ([]Invoice, error)

	// Enabled reports whether a usable API key is configured. When false the
	// caller should treat billing as a no-op rather than erroring.
	Enabled() bool
}

type Config struct {
	// BaseURL is the Commerce API base (default https://commerce.hanzo.ai).
	BaseURL string
	// APIKey is the Commerce bearer token. When empty the client is disabled
	// and all mutating calls return an [Error] with status 503.
	APIKey string
	// Timeout bounds each request (default 30s).
	Timeout time.Duration
}

type Customer struct {
	ID    string `json:"id"`
	Email string `json:"email"`
	Name  string `json:"name"`
	Org   string `json:"org"`
}

type Error struct {
	Status  int
	Message string
}

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

type Invoice struct {
	ID        string `json:"id"`
	Status    string `json:"status"`
	AmountUSD int64  `json:"amountUsd"`
	Created   string `json:"created"`
}

type Subscription struct {
	ID         string `json:"id"`
	CustomerID string `json:"customerId"`
	Tier       string `json:"tier"`
	Status     string `json:"status"`
}

type User struct {
	ID    string
	Email string
	Name  string
	Org   string
}