stripe

type AnalyticsTelemetryClient struct {
	BaseURL *url.URL

	HTTPClient *http.Client
	// contains filtered or unexported fields
}

type CLIAnalyticsEventMetadata struct {
	InvocationID      string `url:"invocation_id"`              // The invocation id is unique to each context object and represents all events coming from one command / gRPC method call
	UserAgent         string `url:"user_agent"`                 // the application that is used to create this request
	CommandPath       string `url:"command_path"`               // the command or gRPC method that initiated this request
	CommandFlags      string `url:"command_flags"`              // Comma-separated list of flags that were passed to the command (only includes flag names, not their values)
	PluginName        string `url:"plugin_name,omitempty"`      // the plugin being installed, when relevant
	PluginVersion     string `url:"plugin_version,omitempty"`   // the version of the plugin being installed/uninstalled/upgraded
	Merchant          string `url:"merchant"`                   // the merchant ID: ex. acct_xxxx
	CLIVersion        string `url:"cli_version"`                // the version of the CLI
	OS                string `url:"os"`                         // the OS of the system
	Arch              string `url:"arch"`                       // the CPU architecture of the system
	MachineUUID       string `url:"machine_uuid,omitempty"`     // the persistent machine UUID
	GeneratedResource bool   `url:"generated_resource"`         // whether or not this was a generated resource
	AIAgent           string `url:"ai_agent,omitempty"`         // the AI coding agent that invoked the CLI, if any
	AgentHostKind     string `url:"agent_host_kind,omitempty"`  // where the agent ran: desktop, terminal, ide, remote, sdk, mcp, chat, ci, or other
	AgentVersion      string `url:"agent_version,omitempty"`    // the agent's own version, when it reports one
	InstallMethod     string `url:"install_method,omitempty"`   // how the CLI was installed
	InTmux            bool   `url:"in_tmux"`                    // whether the CLI was invoked from within tmux
	InScreen          bool   `url:"in_screen"`                  // whether the CLI was invoked from within GNU Screen
	TerminalProgram   string `url:"terminal_program,omitempty"` // the terminal program that invoked the CLI, if any
}

type Client struct {
	// The base URL (protocol + hostname) used for all requests sent by this
	// client.
	BaseURL *url.URL

	// Credentials holds the auth credentials for the request. If Token is
	// empty, the Authorization header is omitted.
	Credentials Credentials

	// When this is enabled, request and response headers will be printed to
	// stdout.
	Verbose bool

	// List of request and response headers that should be printed when Verbose is true.
	// Defaults to the standard set of relevant for Stripe headers.
	VerbosePrintableHeaders []string

	// When true, 3xx responses are returned directly instead of being followed.
	NoFollowRedirects bool
	// contains filtered or unexported fields
}

type Credentials struct {
	Token       string
	OAKContext  string
	OAKLivemode *bool
}

type NoOpTelemetryClient struct {
}

type RequestPerformer interface {
	PerformRequest(ctx context.Context, method, path string, params string, configure func(*http.Request) error) (*http.Response, error)
}

type TelemetryClient interface {
	SendAPIRequestEvent(ctx context.Context, requestID string, livemode bool) (*http.Response, error)
	SendEvent(ctx context.Context, eventName string, eventValue string)
}