content

type CatalogAssetResult struct {
	Org     string `json:"org"`
	Slug    string `json:"slug"`
	Name    string `json:"name,omitempty"`
	Created bool   `json:"created"`
	Skipped string `json:"skipped,omitempty"` // "exists" | "not_installed" | "not_configured"
}

type Channel struct {
	ID       string `json:"id"`       // the social integration id to target in a post
	Provider string `json:"provider"` // "x" | "instagram" | "tiktok" | ...
	Name     string `json:"name"`
	Disabled bool   `json:"disabled"`
}

type ChannelResult struct {
	Channel    string `json:"channel"`              // the social integration id targeted
	Provider   string `json:"provider,omitempty"`   // "x" | "instagram" | ... when known
	Status     string `json:"status"`               // "distributed" | "scheduled" | "failed"
	ExternalID string `json:"externalId,omitempty"` // social post id, when it went out
	Error      string `json:"error,omitempty"`      // short reason, when it failed
}

type DistributeRequest struct {
	Content     string
	Media       []MediaRef
	Channels    []string
	ScheduleAt  string
	Distributed map[string]bool
}

type DistributeResult struct {
	Scheduled   bool
	ExternalIDs map[string]string // channel id → external post id (successes only)
	Channels    []ChannelResult   // per-channel honest status (ok + failed)
}

type Distributor interface {
	Channels(ctx context.Context, org string) ([]Channel, error)
	Publish(ctx context.Context, org string, req DistributeRequest) (DistributeResult, error)
}

type GenerateInput struct {
	DocType  string `json:"doctype"`                // Campaign | SocialPost | Asset
	Title    string `json:"title,omitempty"`        // optional explicit title
	Brief    string `json:"brief,omitempty"`        // the brief/goal driving copy generation
	Product  string `json:"product,omitempty"`      // commerce product handle (copy context)
	Design   string `json:"design,omitempty"`       // studio design slug (asset source)
	Channels string `json:"channels,omitempty"`     // target channels (SocialPost)
	Project  string `json:"project,omitempty"`      // brand/site sub-scope (billing + tenancy axis)
	Voice    string `json:"voice,omitempty"`        // brand-voice guidance for the copy director
	Tone     string `json:"tone,omitempty"`         // tone override for a single draft
	Kind     string `json:"kind,omitempty"`         // asset kind: ecom|product|lifestyle|hover|hero
	Source   string `json:"source_media,omitempty"` // asset source image (design CAD/photo)
	Model    string `json:"model,omitempty"`        // optional zen model override (copy)
}

type GenerateResult struct {
	DocType string `json:"doctype"` // the marketing type the draft was filed as
	Name    string `json:"name"`    // the new document's name — its address for every later call
	Status  string `json:"status"`  // always "draft"; the lifecycle owns the initial state
}

type Generator interface {
	Draft(ctx context.Context, org string, in GenerateInput) (map[string]any, error)
}

type MediaRef struct {
	URL  string `json:"url"`
	Alt  string `json:"alt,omitempty"`
	Mime string `json:"mime,omitempty"`
}

type PublishInput struct {
	DocType    string `json:"doctype"`
	Name       string `json:"name"`
	ScheduleAt string `json:"scheduleAt,omitempty"` // "" = now
}

type PublishResult struct {
	Status      string            `json:"status"`
	Channels    []string          `json:"channels,omitempty"`
	ExternalIDs map[string]string `json:"externalIds,omitempty"`
	Results     []ChannelResult   `json:"results,omitempty"`
}

type Storefront interface {
	Publish(ctx context.Context, org string, req StorefrontRequest) (StorefrontResult, error)
	// ProductExists reports whether the org's catalog holds a product with this handle
	// (slug). errNotConfigured when the commerce edge is not wired (no token / no
	// reachable commerce) — the integrity gate then SKIPS validation (local dev). A clean
	// (false, nil) is an authoritative "resolved, no such product" the gate fails closed on.
	ProductExists(ctx context.Context, org, handle string) (bool, error)
}

type StorefrontRequest struct {
	Design   string
	Kind     string
	Role     string
	ImageURL string
	Caption  string
}

type StorefrontResult struct {
	Status   string `json:"status"`
	Slug     string `json:"slug,omitempty"`
	Store    string `json:"store,omitempty"`
	ImageURL string `json:"imageUrl,omitempty"`
}

type TransitionResult struct {
	DocType      string            `json:"doctype"`
	Name         string            `json:"name"`
	From         string            `json:"from"`
	To           string            `json:"to"`
	Distribution *PublishResult    `json:"distribution,omitempty"`
	Storefront   *StorefrontResult `json:"storefront,omitempty"`
}