tenancy

type Event struct {
	// ID is the monotonically increasing event sequence number.
	ID int64 `json:"id"`
	// EventType is "created" or "deleted".
	EventType string `json:"eventType"`
	// ResourceType is "org" or "project".
	ResourceType string    `json:"resourceType"`
	ResourceID   uuid.UUID `json:"resourceId"`
	ResourceName string    `json:"resourceName"`
	// OrgID is set for project events; nil for org events.
	OrgID   *uuid.UUID `json:"orgId"`
	OrgName *string    `json:"orgName"`
	// FolderID is reserved for future hierarchical resource types.
	FolderID  *uuid.UUID `json:"folderId"`
	CreatedAt time.Time  `json:"createdAt"`
}

type Handler interface {
	// HandleEvent is called for each event (both replay and incremental).
	// Must be idempotent -- replay on restart will re-deliver events for
	// all existing and soft-deleted resources.
	HandleEvent(ctx context.Context, event Event) error
}

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

type PollerConfig struct {
	// PollInterval is the steady-state polling interval (default 5s).
	PollInterval time.Duration

	// PollLimit is the max number of events per poll request (default 100).
	PollLimit int

	// InitialBackoff is the starting backoff when the Tenant Manager is
	// unreachable (default 1s).
	InitialBackoff time.Duration

	// MaxBackoff caps the exponential backoff (default 30s).
	MaxBackoff time.Duration

	// Timeout for individual HTTP requests (default 30s).
	HTTPTimeout time.Duration

	// OnError is an optional callback invoked when a non-fatal error occurs
	// (poll failure, event processing error, status update failure).
	OnError func(err error, msg string)
}