provider

type PaymentMethod struct {
	ID           string `json:"id"`
	Type         string `json:"type"`  // "card", "bank_account", etc.
	Last4        string `json:"last4"` // last 4 digits
	Brand        string `json:"brand"` // "visa", "mastercard", etc.
	ExpiryMonth  int    `json:"expiry_month"`
	ExpiryYear   int    `json:"expiry_year"`
	IsDefault    bool   `json:"is_default"`
	ProviderName string `json:"provider_name"` // e.g. "stripe"
	ProviderID   string `json:"provider_id"`   // provider's own ID for this method
}

type Provider interface {
	// Name returns the provider identifier (e.g. "stripe", "braintree").
	Name() string

	ListPaymentMethods(ctx context.Context, tenantID string) ([]PaymentMethod, error)

	SyncPlan(ctx context.Context, p *plan.Plan) (providerID string, err error)
	SyncFeature(ctx context.Context, f *feature.Feature) (providerID string, err error)
	SyncSubscription(ctx context.Context, s *subscription.Subscription) (providerID string, err error)
	SyncInvoice(ctx context.Context, inv *invoice.Invoice) (providerID string, err error)

	ImportPlan(ctx context.Context, providerID string) (*plan.Plan, error)
	ImportFeature(ctx context.Context, providerID string) (*feature.Feature, error)
	ImportSubscription(ctx context.Context, providerID string) (*subscription.Subscription, error)
	ImportInvoice(ctx context.Context, providerID string) (*invoice.Invoice, error)

	HandleWebhook(ctx context.Context, payload []byte) (*WebhookResult, error)
}

type SyncResult struct {
	ProviderName string `json:"provider_name"`
	ProviderID   string `json:"provider_id"`
	EntityType   string `json:"entity_type"` // "plan", "feature", "subscription", "invoice"
	EntityID     string `json:"entity_id"`
	Direction    string `json:"direction"` // "push" or "pull"
	Success      bool   `json:"success"`
	Error        string `json:"error,omitempty"`
}

type WebhookResult struct {
	EventType  string    `json:"event_type"`
	ProviderID string    `json:"provider_id"`
	EntityType string    `json:"entity_type"` // "plan", "subscription", "invoice", etc.
	EntityID   string    `json:"entity_id"`
	Handled    bool      `json:"handled"`
	Error      string    `json:"error,omitempty"`
	Timestamp  time.Time `json:"timestamp"`
}