cmd

type APICmd struct {
	Get    APIGetCmd    `cmd:"" aliases:"GET" help:"Send a GET request"`
	Post   APIPostCmd   `cmd:"" aliases:"POST" help:"Send a POST request"`
	Put    APIPutCmd    `cmd:"" aliases:"PUT" help:"Send a PUT request"`
	Patch  APIPatchCmd  `cmd:"" aliases:"PATCH" help:"Send a PATCH request"`
	Delete APIDeleteCmd `cmd:"" aliases:"DELETE" help:"Send a DELETE request (requires --force)"`
	Legacy APILegacyCmd `cmd:"" default:"withargs" hidden:""`
}

type APIDeleteCmd struct {
	Path string `arg:"" required:"" help:"API path"`
	APIRequestFlags
}

type APIGetCmd struct {
	Path string `arg:"" required:"" help:"API path"`
	APIRequestFlags
}

type APILegacyCmd struct {
	Method string `required:"" help:"HTTP method (GET, POST, PUT, PATCH, DELETE)"`
	Path   string `required:"" help:"API path (e.g., /channels)"`
	APIRequestFlags
}

type APIPatchCmd struct {
	Path string `arg:"" required:"" help:"API path"`
	APIRequestFlags
}

type APIPostCmd struct {
	Path string `arg:"" required:"" help:"API path"`
	APIRequestFlags
}

type APIPutCmd struct {
	Path string `arg:"" required:"" help:"API path"`
	APIRequestFlags
}

type APIRequestFlags struct {
	Data   string `help:"Request JSON: inline, @file, or - for stdin" short:"d"`
	File   string `help:"Read request JSON from file (legacy; use --data @file)" type:"existingfile"`
	All    bool   `help:"Fetch every page of a JSON array response"`
	Output string `help:"Write an exact binary response to FILE or - for stdout"`
}

type AnnouncementsCmd struct {
	List   AnnouncementsListCmd   `cmd:"" help:"List announcements"`
	Get    AnnouncementsGetCmd    `cmd:"" help:"Get an announcement"`
	Create AnnouncementsCreateCmd `cmd:"" help:"Create an announcement"`
	Update AnnouncementsUpdateCmd `cmd:"" help:"Update an announcement"`
	Delete AnnouncementsDeleteCmd `cmd:"" help:"Delete an announcement (requires --force)"`
}

type AnnouncementsCreateCmd struct {
	File        string   `help:"Read JSON from file (use - for stdin)"`
	Assignments []string `arg:"" optional:"" help:"Inline announcement field assignments"`
}

type AnnouncementsDeleteCmd struct {
	ID string `required:"" help:"Announcement ID"`
}

type AnnouncementsGetCmd struct {
	ID string `required:"" help:"Announcement ID"`
}

type AnnouncementsListCmd struct {
	QueryFlags `embed:""`
	All        bool `help:"Fetch all pages"`
	Page       int  `default:"1" help:"Page number"`
	PerPage    int  `default:"25" help:"Items per page"`
}

type AnnouncementsUpdateCmd struct {
	ID          string   `required:"" help:"Announcement ID"`
	File        string   `help:"Read JSON from file (use - for stdin)"`
	Assignments []string `arg:"" optional:"" help:"Inline announcement field assignments"`
}

type AppsCmd struct {
	List   AppsListCmd   `cmd:"" help:"List apps"`
	Get    AppsGetCmd    `cmd:"" help:"Get app details"`
	Create AppsCreateCmd `cmd:"" help:"Create an app"`
	Update AppsUpdateCmd `cmd:"" help:"Update an app"`
	Config AppsConfigCmd `cmd:"" help:"Add an app to local project config"`
	Push   AppsPushCmd   `cmd:"" help:"Push configured local cloud-code files"`
	Logs   AppsLogsCmd   `cmd:"" help:"Read app cloud-code logs"`
	Code   AppsCodeCmd   `cmd:"" help:"Manage app cloud code files"`
}

type AppsCodeCmd struct {
	List   AppsCodeListCmd   `cmd:"" help:"List app code files"`
	Get    AppsCodeGetCmd    `cmd:"" help:"Get an app code file"`
	Create AppsCodeCreateCmd `cmd:"" help:"Create app code file from JSON"`
	Update AppsCodeUpdateCmd `cmd:"" help:"Update an app code file"`
	Delete AppsCodeDeleteCmd `cmd:"" help:"Delete an app code file (requires --force)"`
	Pull   AppsCodePullCmd   `cmd:"" help:"Pull remote app code files"`
}

type AppsCodeCreateCmd struct {
	App         string   `required:"" help:"Application ID"`
	File        string   `help:"Read code file JSON from file (use - for stdin)"`
	Assignments []string `arg:"" optional:"" help:"Inline assignments (e.g. name=main.js, code=console.log(1))"`
}

type AppsCodeDeleteCmd struct {
	App      string `required:"" help:"Application ID"`
	Filename string `required:"" help:"Code filename"`
}

type AppsCodeGetCmd struct {
	App      string `required:"" help:"Application ID"`
	Filename string `required:"" help:"Code filename"`
}

type AppsCodeListCmd struct {
	QueryFlags `embed:""`
	App        string `required:"" help:"Application ID"`
}

type AppsCodePullCmd struct {
	App   string   `help:"Configured local app name"`
	Files []string `help:"Remote or project-relative file subset; commas split multiple files" name:"only"`
}

type AppsCodeUpdateCmd struct {
	App         string   `required:"" help:"Application ID"`
	Filename    string   `required:"" help:"Code filename"`
	File        string   `help:"Read JSON from file (use - for stdin)"`
	Assignments []string `arg:"" optional:"" help:"Inline assignments such as code=..."`
}

type AppsConfigCmd struct{}

type AppsCreateCmd struct {
	Name        string   `required:"" help:"App name"`
	Description string   `help:"App description"`
	Internal    bool     `` /* 128-byte string literal not displayed */
	Scopes      []string `help:"Install scopes (comma-separated, e.g. read_channels,write_channels); required for internal apps"`
	URL         string   `help:"App URL (external apps only)"`
	CallbackURL string   `name:"callback-url" help:"OAuth callback URL (external apps only)"`
	SDKVersion  string   `name:"sdk-version" help:"Cloud-code SDK version"`
	Install     *bool    `negatable:"" help:"Grant and register the app on the site in one step (default: true for internal apps)"`
	Configure   bool     `help:"After creating, add the app to the local nimbu.yml project config"`
}

type AppsGetCmd struct {
	App string `required:"" help:"Application ID"`
}

type AppsListCmd struct {
	QueryFlags `embed:""`
	All        bool `help:"Fetch all pages"`
	Page       int  `help:"Page number" default:"1"`
	PerPage    int  `help:"Items per page" default:"25"`
}

type AppsLogsCmd struct {
	App   string `required:"" help:"Application local name or key"`
	Tail  bool   `help:"Poll for new logs until interrupted" short:"t"`
	Level string `help:"Minimum severity: debug, info, warn, error, fatal"`
	Query string `help:"Text search query" short:"q" name:"query"`
	Job   string `help:"Only logs from this background job name"`
	Since string `help:"Only logs after this value; raw epoch/ISO8601 or duration like 15m, 1h, 24h"`
	Limit int    `help:"Maximum logs to fetch" default:"100"`
}

type AppsPushCmd struct {
	App   string   `help:"Configured local app name"`
	Sync  bool     `help:"Delete remote files missing locally"`
	Files []string `help:"Project-relative file subset; commas split multiple files" name:"only"`
}

type AppsUpdateCmd struct {
	App         string   `required:"" help:"Application ID"`
	Name        *string  `help:"App name"`
	Description *string  `help:"App description"`
	Internal    *bool    `negatable:"" help:"Whether the app is internal (callback derived from scopes)"`
	Scopes      []string `help:"Install scopes (comma-separated, e.g. read_channels,write_channels)"`
	URL         *string  `help:"App URL (external apps only)"`
	CallbackURL *string  `name:"callback-url" help:"OAuth callback URL (external apps only)"`
	SDKVersion  *string  `name:"sdk-version" help:"Cloud-code SDK version"`
}

type AuthCmd struct {
	Login   AuthLoginCmd   `cmd:"" help:"Log in to Nimbu"`
	Logout  AuthLogoutCmd  `cmd:"" help:"Log out and remove stored credentials"`
	Status  AuthStatusCmd  `cmd:"" help:"Show authentication status"`
	Whoami  AuthWhoamiCmd  `cmd:"" help:"Show current authenticated user"`
	Scopes  AuthScopesCmd  `cmd:"" help:"Show active token scopes"`
	Token   AuthTokenCmd   `cmd:"" help:"Print access token for scripts"`
	Keyring AuthKeyringCmd `cmd:"" help:"Manage keyring backend"`
}

type AuthKeyringCmd struct {
	Show AuthKeyringShowCmd `cmd:"" default:"1" help:"Show current keyring backend"`
	Set  AuthKeyringSetCmd  `cmd:"" help:"Set keyring backend"`
}

type AuthKeyringSetCmd struct {
	Backend string `required:"" help:"Backend to use: auto, keychain, file, secret-service, kwallet, wincred"`
}

type AuthKeyringShowCmd struct{}

type AuthLoginCmd struct {
	Device bool   `help:"Log in with a one-time code entered in a browser on any device (SSH, containers)"`
	Scopes string `help:"Comma-separated OAuth scopes to request (default: full CLI access)"`
	// Deliberately not bound to NIMBU_TOKEN: an exported CI token must not
	// turn a login into storing that token.
	Token string `help:"Store an existing API token instead of logging in" short:"t"`

	// Deprecated email/password login, kept for scripts. Either flag selects it.
	Email     string `help:"Deprecated: log in with email and password" short:"e" hidden:""`
	Password  string `help:"Deprecated: password for --email login" short:"p" hidden:""`
	ExpiresIn int    `help:"Deprecated: token lifetime in seconds for --email login" short:"x" default:"7776000" hidden:""`
}

type AuthLogoutCmd struct{}

type AuthScopesCmd struct{}

type AuthStatusCmd struct{}

type AuthTokenCmd struct{}

type AuthWhoamiCmd struct{}

type BannerTheme struct {
	Name    string
	Label   string
	Palette []string // one hex color per banner line
}

type BlogPostsCmd struct {
	List   BlogPostsListCmd   `cmd:"" help:"List blog articles"`
	Get    BlogPostsGetCmd    `cmd:"" help:"Get blog article"`
	Create BlogPostsCreateCmd `cmd:"" help:"Create a blog article"`
	Update BlogPostsUpdateCmd `cmd:"" help:"Update a blog article"`
	Delete BlogPostsDeleteCmd `cmd:"" help:"Delete a blog article"`
	Count  BlogPostsCountCmd  `cmd:"" help:"Count blog articles"`
}

type BlogPostsCountCmd struct {
	CountQueryFlags `embed:""`
	Blog            string `required:"" help:"Blog ID or handle"`
}

type BlogPostsCreateCmd struct {
	Blog        string   `required:"" help:"Blog ID or handle"`
	Locale      string   `help:"Content locale for localized post fields"`
	File        string   `help:"Read post JSON from file (use - for stdin)"`
	Assignments []string `arg:"" optional:"" help:"Inline assignments (e.g. title=Hello, status=published)"`
}

type BlogPostsDeleteCmd struct {
	Blog string `required:"" help:"Blog ID or handle"`
	Post string `required:"" help:"Post ID or slug"`
}

type BlogPostsGetCmd struct {
	Blog   string `required:"" help:"Blog ID or handle"`
	Post   string `required:"" help:"Post ID or slug"`
	Locale string `help:"Content locale for localized post fields"`
}

type BlogPostsListCmd struct {
	QueryFlags `embed:""`
	Blog       string `required:"" help:"Blog ID or handle"`
	All        bool   `help:"Fetch all pages"`
	Page       int    `help:"Page number" default:"1"`
	PerPage    int    `help:"Items per page" default:"25"`
}

type BlogPostsUpdateCmd struct {
	Blog        string   `required:"" help:"Blog ID or handle"`
	Post        string   `required:"" help:"Post ID or slug"`
	Locale      string   `help:"Content locale for localized post fields"`
	File        string   `help:"Read post JSON from file (use - for stdin)"`
	Assignments []string `arg:"" optional:"" help:"Inline assignments (e.g. title=Hello, status=published)"`
}

type BlogsCmd struct {
	List   BlogsListCmd   `cmd:"" help:"List blogs"`
	Get    BlogsGetCmd    `cmd:"" help:"Get blog details"`
	Create BlogsCreateCmd `cmd:"" help:"Create a blog"`
	Update BlogsUpdateCmd `cmd:"" help:"Update a blog"`
	Delete BlogsDeleteCmd `cmd:"" help:"Delete a blog"`
	Count  BlogsCountCmd  `cmd:"" help:"Count blogs"`
	Posts  BlogPostsCmd   `cmd:"" help:"Manage blog articles" aliases:"articles"`
	Copy   BlogsCopyCmd   `cmd:"" help:"Copy blogs and posts between sites"`
}

type BlogsCopyCmd struct {
	Handle   string `help:"Blog handle to copy" default:"*" name:"only"`
	From     string `help:"Source site" required:"" name:"from"`
	To       string `help:"Target site" required:"" name:"to"`
	FromHost string `help:"Source API base URL or host" name:"from-host"`
	ToHost   string `help:"Target API base URL or host" name:"to-host"`
}

type BlogsCountCmd struct {
	CountQueryFlags `embed:""`
}

type BlogsCreateCmd struct {
	Locale      string   `help:"Content locale for localized blog fields"`
	File        string   `help:"Read blog JSON from file (use - for stdin)"`
	Assignments []string `arg:"" optional:"" help:"Inline assignments (e.g. name=Blog, slug=news)"`
}

type BlogsDeleteCmd struct {
	Blog string `required:"" help:"Blog ID or handle"`
}

type BlogsGetCmd struct {
	Blog   string `required:"" help:"Blog ID or handle"`
	Locale string `help:"Content locale for localized blog fields"`
}

type BlogsListCmd struct {
	QueryFlags `embed:""`
	All        bool `help:"Fetch all pages"`
	Page       int  `help:"Page number" default:"1"`
	PerPage    int  `help:"Items per page" default:"25"`
}

type BlogsUpdateCmd struct {
	Blog        string   `required:"" help:"Blog ID or handle"`
	Locale      string   `help:"Content locale for localized blog fields"`
	File        string   `help:"Read blog JSON from file (use - for stdin)"`
	Assignments []string `arg:"" optional:"" help:"Inline assignments (e.g. name=Blog, slug=news)"`
}

type CLI struct {
	RootFlags `embed:""`

	HelpAll             bool                   `help:"Show all flags including hidden" name:"help-all" hidden:""`
	Version             kong.VersionFlag       `help:"Print version and exit"`
	Auth                AuthCmd                `cmd:"" help:"Authentication and credentials"`
	Init                InitCmd                `cmd:"" help:"Bootstrap a local theme project"`
	Sites               SitesCmd               `cmd:"" help:"Manage sites"`
	Schema              SchemaCmd              `cmd:"" help:"Manage declarative schemas"`
	Release             ReleaseCmd             `cmd:"" help:"Release schema, cloud code and theme"`
	Releases            ReleasesCmd            `cmd:"" help:"List successful releases"`
	Channels            ChannelsCmd            `cmd:"" help:"Manage channels and entries"`
	Pages               PagesCmd               `cmd:"" help:"Manage pages"`
	Menus               MenusCmd               `cmd:"" help:"Manage navigation menus"`
	Products            ProductsCmd            `cmd:"" help:"Manage products"`
	ShippingRates       ShippingRatesCmd       `cmd:"" name:"shipping-rates" help:"Manage shipping rates"`
	Collections         CollectionsCmd         `cmd:"" help:"Manage collections"`
	Coupons             CouponsCmd             `cmd:"" help:"Manage coupons"`
	Domains             DomainsCmd             `cmd:"" help:"Manage custom domains"`
	Orders              OrdersCmd              `cmd:"" help:"Manage orders"`
	Customers           CustomersCmd           `cmd:"" help:"Manage customers"`
	Mails               MailsCmd               `cmd:"" aliases:"mail" help:"Sync notification templates to local files"`
	Announcements       AnnouncementsCmd       `cmd:"" help:"Manage platform announcements"`
	DomainRegistrations DomainRegistrationsCmd `cmd:"" name:"domain-registrations" help:"Manage domain registrations"`
	Settings            SettingsCmd            `cmd:"" help:"Manage site settings"`
	Events              EventsCmd              `cmd:"" help:"Track and ingest events"`
	Realtime            RealtimeCmd            `cmd:"" help:"Realtime grants and live queries"`
	Notifications       NotificationsCmd       `cmd:"" help:"Manage notifications"`
	Roles               RolesCmd               `cmd:"" help:"Manage roles"`
	Redirects           RedirectsCmd           `cmd:"" help:"Manage redirects"`
	Functions           FunctionsCmd           `cmd:"" help:"Execute cloud functions"`
	Jobs                JobsCmd                `cmd:"" help:"Execute cloud jobs"`
	Apps                AppsCmd                `cmd:"" help:"Manage OAuth apps"`
	Senders             SendersCmd             `cmd:"" help:"Manage email sender domains"`
	Themes              ThemesCmd              `cmd:"" help:"Manage themes"`
	Uploads             UploadsCmd             `cmd:"" help:"Manage uploads"`
	Blogs               BlogsCmd               `cmd:"" help:"Manage blogs"`
	Webhooks            WebhooksCmd            `cmd:"" help:"Manage webhooks"`
	Translations        TranslationsCmd        `cmd:"" help:"Manage translations"`
	Server              ServerCmd              `cmd:"" help:"Run local simulator proxy with child dev server"`
	Env                 EnvCmd                 `cmd:"" help:"Manage project environments"`
	Config              ConfigCmd              `cmd:"" help:"Manage configuration"`
	API                 APICmd                 `cmd:"" help:"Raw API access"`
	Commands            CommandsCmd            `cmd:"" help:"Export the machine-readable command contract"`
	Completion          CompletionCmd          `cmd:"" help:"Generate shell completions"`
	Complete            InternalCompleteCmd    `cmd:"" name:"__complete" hidden:""`
}

type ChannelEntriesCmd struct {
	List    ChannelEntriesListCmd    `cmd:"" help:"List channel entries"`
	Get     ChannelEntriesGetCmd     `cmd:"" help:"Get entry by ID or slug"`
	Create  ChannelEntriesCreateCmd  `cmd:"" help:"Create entry from JSON"`
	Update  ChannelEntriesUpdateCmd  `cmd:"" help:"Update entry"`
	Delete  ChannelEntriesDeleteCmd  `cmd:"" help:"Delete entry"`
	Count   ChannelEntriesCountCmd   `cmd:"" help:"Count entries"`
	Copy    ChannelEntriesCopyCmd    `cmd:"" help:"Copy channel entries between sites"`
	Gallery ChannelEntriesGalleryCmd `cmd:"" help:"Manage gallery fields on channel entries"`
	Watch   ChannelEntriesWatchCmd   `cmd:"" help:"Stream live entry events over the realtime socket"`
}

type ChannelEntriesCopyCmd struct {
	From          string `help:"Source site/channel" required:"" name:"from"`
	To            string `help:"Target site/channel" required:"" name:"to"`
	FromHost      string `help:"Source API base URL or host" name:"from-host"`
	ToHost        string `help:"Target API base URL or host" name:"to-host"`
	Recursive     bool   `help:"Recursively copy referenced channel entries"`
	Only          string `help:"Comma-separated channel allowlist when using --recursive"`
	Query         string `help:"Raw query string to append to the source entry list"`
	Where         string `help:"Where expression for source entry selection"`
	PerPage       int    `help:"Items per page" name:"per-page"`
	Upsert        string `help:"Comma-separated upsert fields, optionally channel-scoped as channel:field"`
	CopyCustomers bool   `name:"copy-customers" help:"Copy related customers for owners and customer fields"`
	AllowErrors   bool   `name:"allow-errors" help:"Continue on item-level validation errors"`
	DryRun        bool   `name:"dry-run" help:"Reserved for parity; currently reports planned selection only"`
}

type ChannelEntriesCountCmd struct {
	CountQueryFlags `embed:""`
	Channel         string `required:"" help:"Channel ID or slug"`
}

type ChannelEntriesCreateCmd struct {
	Channel     string   `required:"" help:"Channel ID or slug"`
	Locale      string   `help:"Content locale for localized channel fields"`
	File        string   `help:"Read entry JSON from file (use - for stdin)"`
	Assignments []string `arg:"" optional:"" help:"Inline assignments (e.g. title=Hello, fields.teaser=Text)"`
}

type ChannelEntriesDeleteCmd struct {
	Channel string `required:"" help:"Channel ID or slug"`
	Entry   string `required:"" help:"Entry ID or slug"`
}

type ChannelEntriesGalleryAddCmd struct {
	Channel   string   `required:"" help:"Channel ID or slug"`
	Entry     string   `required:"" help:"Entry ID or slug"`
	Field     string   `required:"" help:"Gallery field name"`
	Images    []string `name:"image" help:"Local image path (repeatable)"`
	Captions  []string `name:"caption" help:"Caption for each image, matched by order"`
	Positions []int    `name:"position" help:"Position for each image, matched by order"`
	Locale    string   `help:"Content locale for localized channel fields"`
	DryRun    bool     `name:"dry-run" help:"Print the payload without updating the entry"`
}

type ChannelEntriesGalleryCmd struct {
	List    ChannelEntriesGalleryListCmd    `cmd:"" help:"List gallery images"`
	Set     ChannelEntriesGallerySetCmd     `cmd:"" help:"Replace gallery images"`
	Add     ChannelEntriesGalleryAddCmd     `cmd:"" help:"Append gallery images"`
	Update  ChannelEntriesGalleryUpdateCmd  `cmd:"" help:"Update one gallery image"`
	Remove  ChannelEntriesGalleryRemoveCmd  `cmd:"" help:"Remove gallery images"`
	Reorder ChannelEntriesGalleryReorderCmd `cmd:"" help:"Reorder gallery images"`
}

type ChannelEntriesGalleryListCmd struct {
	Channel string `required:"" help:"Channel ID or slug"`
	Entry   string `required:"" help:"Entry ID or slug"`
	Field   string `required:"" help:"Gallery field name"`
	Locale  string `help:"Content locale for localized channel fields"`
}

type ChannelEntriesGalleryRemoveCmd struct {
	Channel  string   `required:"" help:"Channel ID or slug"`
	Entry    string   `required:"" help:"Entry ID or slug"`
	Field    string   `required:"" help:"Gallery field name"`
	ImageIDs []string `name:"image-id" required:"" help:"Gallery image ID to remove (repeatable)"`
	Locale   string   `help:"Content locale for localized channel fields"`
	DryRun   bool     `name:"dry-run" help:"Print the payload without updating the entry"`
}

type ChannelEntriesGalleryReorderCmd struct {
	Channel string `required:"" help:"Channel ID or slug"`
	Entry   string `required:"" help:"Entry ID or slug"`
	Field   string `required:"" help:"Gallery field name"`
	Order   string `required:"" help:"Comma-separated gallery image IDs in desired order"`
	Locale  string `help:"Content locale for localized channel fields"`
	DryRun  bool   `name:"dry-run" help:"Print the payload without updating the entry"`
}

type ChannelEntriesGallerySetCmd struct {
	Channel   string   `required:"" help:"Channel ID or slug"`
	Entry     string   `required:"" help:"Entry ID or slug"`
	Field     string   `required:"" help:"Gallery field name"`
	Images    []string `name:"image" help:"Local image path (repeatable)"`
	Captions  []string `name:"caption" help:"Caption for each image, matched by order"`
	Positions []int    `name:"position" help:"Position for each image, matched by order"`
	Locale    string   `help:"Content locale for localized channel fields"`
	DryRun    bool     `name:"dry-run" help:"Print the payload without updating the entry"`
}

type ChannelEntriesGalleryUpdateCmd struct {
	Channel  string  `required:"" help:"Channel ID or slug"`
	Entry    string  `required:"" help:"Entry ID or slug"`
	Field    string  `required:"" help:"Gallery field name"`
	ImageID  string  `name:"image-id" required:"" help:"Gallery image ID"`
	Caption  *string `help:"Updated caption"`
	Position *int    `help:"Updated position"`
	Image    string  `name:"image" help:"Replacement local image path"`
	Locale   string  `help:"Content locale for localized channel fields"`
	DryRun   bool    `name:"dry-run" help:"Print the payload without updating the entry"`
}

type ChannelEntriesGetCmd struct {
	QueryFlags `embed:""`
	Channel    string `required:"" help:"Channel ID or slug"`
	Entry      string `required:"" help:"Entry ID or slug"`
}

type ChannelEntriesListCmd struct {
	QueryFlags `embed:""`
	Channel    string `required:"" help:"Channel ID or slug"`
	All        bool   `help:"Fetch all pages"`
	Page       int    `help:"Page number" default:"1"`
	PerPage    int    `help:"Items per page" default:"25"`
}

type ChannelEntriesUpdateCmd struct {
	Channel     string   `required:"" help:"Channel ID or slug"`
	Entry       string   `required:"" help:"Entry ID or slug"`
	Locale      string   `` /* 179-byte string literal not displayed */
	File        string   `help:"Read entry JSON from file (use - for stdin)"`
	Assignments []string `arg:"" optional:"" help:"Inline assignments (e.g. title=Hello, fields.teaser=Text)"`
}

type ChannelEntriesWatchCmd struct {
	Channel  string        `required:"" help:"Channel ID or slug" group:"Query"`
	Where    string        `help:"Filter expression (same syntax as --filters where=...)" group:"Query"`
	Filters  []string      `aliases:"filter" help:"Filter entries by key=value or key.op=value, repeatable" group:"Query"`
	Once     bool          `help:"Exit after the first event"`
	For      time.Duration `name:"for" help:"Stop watching after this duration, e.g. 30s"`
	Host     string        `help:"Override the site host used for the websocket (e.g. localhost:3000 for dev)"`
	Insecure bool          `help:"Skip TLS verification for the websocket (dev only)"`
}

type ChannelsCmd struct {
	List    ChannelsListCmd   `cmd:"" help:"List channels"`
	Get     ChannelsGetCmd    `cmd:"" help:"Get channel details"`
	Create  ChannelsCreateCmd `cmd:"" help:"Create a channel from JSON or inline assignments"`
	Info    ChannelsInfoCmd   `cmd:"" help:"Show rich channel info and TypeScript output"`
	Types   ChannelsTypesCmd  `cmd:"" help:"Generate one TypeScript module with the types of all channels"`
	Copy    ChannelsCopyCmd   `cmd:"" help:"Copy channel configuration between sites"`
	Diff    ChannelsDiffCmd   `cmd:"" help:"Diff channel configuration between sites"`
	Empty   ChannelsEmptyCmd  `cmd:"" help:"Empty a channel after strict confirmation"`
	Delete  ChannelsDeleteCmd `cmd:"" help:"Delete a channel (requires --force)"`
	Entries ChannelEntriesCmd `cmd:"" help:"Manage channel entries"`
	Fields  ChannelsFieldsCmd `cmd:"" help:"Manage channel fields"`
}

type ChannelsCopyCmd struct {
	All      bool   `help:"Copy all channels from source to target"`
	From     string `help:"Source site/channel or site when using --all" required:"" name:"from"`
	To       string `help:"Target site/channel or site when using --all" required:"" name:"to"`
	FromHost string `help:"Source API base URL or host" name:"from-host"`
	ToHost   string `help:"Target API base URL or host" name:"to-host"`
}

type ChannelsCreateCmd struct {
	File        string   `help:"Read channel JSON from file (use - for stdin)"`
	Assignments []string `` /* 136-byte string literal not displayed */
}

type ChannelsDeleteCmd struct {
	Channel string `required:"" help:"Channel ID or slug"`
}

type ChannelsDiffCmd struct {
	From     string `help:"Source site/channel" required:"" name:"from"`
	To       string `help:"Target site/channel" required:"" name:"to"`
	FromHost string `help:"Source API base URL or host" name:"from-host"`
	ToHost   string `help:"Target API base URL or host" name:"to-host"`
}

type ChannelsEmptyCmd struct {
	Channel string `required:"" help:"Channel ID or slug"`
	Confirm string `help:"Exact channel slug confirmation"`
}

type ChannelsFieldsAddCmd struct {
	Channel     string   `required:"" help:"Channel slug"`
	Name        string   `required:"" help:"Field name"`
	Assignments []string `arg:"" optional:"" help:"Field attributes (e.g. type=string label=Title)"`
}

type ChannelsFieldsApplyCmd struct {
	Channel string `required:"" help:"Channel slug"`
	File    string `required:"" help:"Read field JSON array from file (use - for stdin)"`
}

type ChannelsFieldsCmd struct {
	List    ChannelsFieldsListCmd    `cmd:"" help:"List channel fields"`
	Add     ChannelsFieldsAddCmd     `cmd:"" help:"Add a channel field"`
	Update  ChannelsFieldsUpdateCmd  `cmd:"" help:"Update a channel field"`
	Delete  ChannelsFieldsDeleteCmd  `cmd:"" help:"Delete a channel field"`
	Apply   ChannelsFieldsApplyCmd   `cmd:"" help:"Apply channel fields from JSON"`
	Replace ChannelsFieldsReplaceCmd `cmd:"" help:"Replace channel fields from JSON"`
	Diff    ChannelsFieldsDiffCmd    `cmd:"" help:"Diff channel fields against JSON"`
}

type ChannelsFieldsDeleteCmd struct {
	Channel string `required:"" help:"Channel slug"`
	Field   string `required:"" help:"Field ID or name"`
}

type ChannelsFieldsDiffCmd struct {
	Channel string `required:"" help:"Channel slug"`
	File    string `required:"" help:"Read field JSON array from file (use - for stdin)"`
}

type ChannelsFieldsListCmd struct {
	Channel string `required:"" help:"Channel slug"`
}

type ChannelsFieldsReplaceCmd struct {
	Channel string `required:"" help:"Channel slug"`
	File    string `required:"" help:"Read field JSON array from file (use - for stdin)"`
}

type ChannelsFieldsUpdateCmd struct {
	Channel     string   `required:"" help:"Channel slug"`
	Field       string   `required:"" help:"Field ID or name"`
	Assignments []string `arg:"" optional:"" help:"Field attributes to update (e.g. label=Headline required:=true)"`
}

type ChannelsGetCmd struct {
	Channel string `required:"" help:"Channel slug"`
}

type ChannelsInfoCmd struct {
	Channel    string `required:"" help:"Channel slug or site/channel"`
	TypeScript bool   `name:"typescript" help:"Render a TypeScript type instead of the rich summary"`
}

type ChannelsListCmd struct {
	QueryFlags     `embed:""`
	All            bool `help:"Fetch all pages"`
	Page           int  `help:"Page number" default:"1"`
	PerPage        int  `help:"Items per page" default:"25"`
	WithEntryCount bool `name:"with-entry-count" help:"Fetch entry count for each channel" default:"true"`
	NoEntryCount   bool `name:"no-entry-count" help:"Skip fetching entry count for each channel"`
}

type ChannelsTypesCmd struct {
	Channel []string `help:"Only include these channels (slug or ID; repeatable or comma-separated)"`
	Output  string   `help:"Write the module to this path instead of stdout (- for stdout)" short:"o"`
}

type CollectionsCmd struct {
	List   CollectionsListCmd   `cmd:"" help:"List collections"`
	Get    CollectionsGetCmd    `cmd:"" help:"Get collection details"`
	Create CollectionsCreateCmd `cmd:"" help:"Create collection from JSON"`
	Update CollectionsUpdateCmd `cmd:"" help:"Update collection"`
	Delete CollectionsDeleteCmd `cmd:"" help:"Delete collection"`
	Count  CollectionsCountCmd  `cmd:"" help:"Count collections"`
	Copy   CollectionsCopyCmd   `cmd:"" help:"Copy collections between sites"`
}

type CollectionsCopyCmd struct {
	From        string `help:"Source site" required:"" name:"from"`
	To          string `help:"Target site" required:"" name:"to"`
	FromHost    string `help:"Source API base URL or host" name:"from-host"`
	ToHost      string `help:"Target API base URL or host" name:"to-host"`
	AllowErrors bool   `name:"allow-errors" help:"Continue on item-level validation errors"`
}

type CollectionsCountCmd struct {
	CountQueryFlags `embed:""`
}

type CollectionsCreateCmd struct {
	Locale      string   `help:"Content locale for localized collection fields"`
	File        string   `help:"Read collection JSON from file (use - for stdin)"`
	Assignments []string `arg:"" optional:"" help:"Inline assignments (e.g. name=Summer, slug=summer)"`
}

type CollectionsDeleteCmd struct {
	Collection string `required:"" help:"Collection ID or slug"`
}

type CollectionsGetCmd struct {
	Collection string `required:"" help:"Collection ID or slug"`
	Locale     string `help:"Content locale for localized collection fields"`
}

type CollectionsListCmd struct {
	QueryFlags `embed:""`
	All        bool `help:"Fetch all pages"`
	Page       int  `help:"Page number" default:"1"`
	PerPage    int  `help:"Items per page" default:"25"`
}

type CollectionsUpdateCmd struct {
	Collection  string   `required:"" help:"Collection ID or slug"`
	Locale      string   `help:"Content locale for localized collection fields"`
	File        string   `help:"Read collection JSON from file (use - for stdin)"`
	Assignments []string `arg:"" optional:"" help:"Inline assignments (e.g. name=Summer, slug=summer)"`
}

type CommandContract struct {
	SchemaVersion int                      `json:"schema_version"`
	CLI           string                   `json:"cli"`
	GlobalFlags   []CommandContractFlag    `json:"global_flags,omitempty"`
	Commands      []CommandContractCommand `json:"commands"`
}

type CommandContractArgument struct {
	Name     string `json:"name"`
	Required bool   `json:"required"`
	Help     string `json:"help,omitempty"`
}

type CommandContractCommand struct {
	Path      string                    `json:"path"`
	Help      string                    `json:"help,omitempty"`
	Aliases   []string                  `json:"aliases,omitempty"`
	Arguments []CommandContractArgument `json:"arguments,omitempty"`
	Flags     []CommandContractFlag     `json:"flags,omitempty"`
}

type CommandContractFlag struct {
	Name     string   `json:"name"`
	Short    string   `json:"short,omitempty"`
	Required bool     `json:"required"`
	Default  string   `json:"default,omitempty"`
	Help     string   `json:"help,omitempty"`
	Aliases  []string `json:"aliases,omitempty"`
}

type CommandsCmd struct{}

type CompletionCmd struct {
	Shell string `help:"Shell to generate completions for (bash, zsh, fish)" default:"bash"`
}

type ConfigBannerCmd struct{}

type ConfigCmd struct {
	List   ConfigListCmd   `cmd:"" help:"List all config values"`
	Get    ConfigGetCmd    `cmd:"" help:"Get a config value"`
	Set    ConfigSetCmd    `cmd:"" help:"Set a config value"`
	Unset  ConfigUnsetCmd  `cmd:"" help:"Unset a config value"`
	Path   ConfigPathCmd   `cmd:"" help:"Print config file path"`
	Banner ConfigBannerCmd `cmd:"" help:"Pick a banner theme interactively"`
}

type ConfigGetCmd struct {
	Key string `required:"" help:"Config key to get"`
}

type ConfigListCmd struct{}

type ConfigPathCmd struct{}

type ConfigSetCmd struct {
	Key   string `required:"" help:"Config key to set"`
	Value string `required:"" help:"Value to set"`
}

type ConfigUnsetCmd struct {
	Key string `required:"" help:"Config key to unset"`
}

type CountQueryFlags struct {
	Locale  string   `help:"Locale filter; localized resources use it as content locale" group:"Query"`
	Filters []string `help:"Filter by key=value, repeatable" group:"Query"`
}

type CouponsCmd struct {
	List   CouponsListCmd   `cmd:"" help:"List coupons"`
	Get    CouponsGetCmd    `cmd:"" help:"Get coupon details"`
	Create CouponsCreateCmd `cmd:"" help:"Create coupon from JSON"`
	Update CouponsUpdateCmd `cmd:"" help:"Update coupon"`
	Delete CouponsDeleteCmd `cmd:"" help:"Delete coupon"`
	Count  CouponsCountCmd  `cmd:"" help:"Count coupons"`
}

type CouponsCountCmd struct {
	CountQueryFlags `embed:""`
}

type CouponsCreateCmd struct {
	File        string   `help:"Read coupon JSON from file (use - for stdin)"`
	Assignments []string `arg:"" optional:"" help:"Inline assignments (e.g. name=Promo, code=SPRING)"`
}

type CouponsDeleteCmd struct {
	Coupon string `required:"" help:"Coupon ID"`
}

type CouponsGetCmd struct {
	Coupon string `required:"" help:"Coupon ID"`
}

type CouponsListCmd struct {
	QueryFlags `embed:""`
	All        bool `help:"Fetch all pages"`
	Page       int  `help:"Page number" default:"1"`
	PerPage    int  `help:"Items per page" default:"25"`
}

type CouponsUpdateCmd struct {
	Coupon      string   `required:"" help:"Coupon ID"`
	File        string   `help:"Read coupon JSON from file (use - for stdin)"`
	Assignments []string `arg:"" optional:"" help:"Inline assignments (e.g. name=Promo, code=SPRING)"`
}

type CustomerRolesAddCmd struct {
	Customer string   `required:"" help:"Customer ID, slug, or email"`
	Roles    []string `required:"" name:"role" help:"Role ID or name, repeatable"`
}

type CustomerRolesCmd struct {
	List   CustomerRolesListCmd   `cmd:"" help:"List directly assigned customer roles"`
	Set    CustomerRolesSetCmd    `cmd:"" help:"Replace directly assigned customer roles"`
	Add    CustomerRolesAddCmd    `cmd:"" help:"Add directly assigned customer roles"`
	Remove CustomerRolesRemoveCmd `cmd:"" help:"Remove directly assigned customer roles"`
}

type CustomerRolesListCmd struct {
	Customer string `required:"" help:"Customer ID, slug, or email"`
}

type CustomerRolesRemoveCmd struct {
	Customer string   `required:"" help:"Customer ID, slug, or email"`
	Roles    []string `required:"" name:"role" help:"Role ID or name, repeatable"`
}

type CustomerRolesSetCmd struct {
	Customer string   `required:"" help:"Customer ID, slug, or email"`
	Roles    []string `required:"" name:"role" help:"Role ID or name, repeatable"`
}

type CustomersCmd struct {
	List               CustomersListCmd               `cmd:"" help:"List customers"`
	Get                CustomersGetCmd                `cmd:"" help:"Get customer by ID or email"`
	Create             CustomersCreateCmd             `cmd:"" help:"Create a customer"`
	Update             CustomersUpdateCmd             `cmd:"" help:"Update a customer"`
	Delete             CustomersDeleteCmd             `cmd:"" help:"Delete a customer"`
	Count              CustomersCountCmd              `cmd:"" help:"Count customers"`
	Copy               CustomersCopyCmd               `cmd:"" help:"Copy customers between sites"`
	Fields             CustomersFieldsCmd             `cmd:"" help:"Show customer field schema"`
	Config             CustomersConfigCmd             `cmd:"" help:"Copy or diff customer customizations"`
	ResetPassword      CustomersResetPasswordCmd      `cmd:"reset-password" help:"Send password reset instructions"`
	ResendConfirmation CustomersResendConfirmationCmd `cmd:"resend-confirmation" help:"Resend confirmation instructions"`
	Roles              CustomerRolesCmd               `cmd:"" help:"Manage customer roles"`
}

type CustomersConfigCmd struct {
	Copy   CustomersConfigCopyCmd `cmd:"" help:"Copy customer customizations between sites"`
	Diff   CustomersConfigDiffCmd `cmd:"" help:"Diff customer customizations between sites"`
	Fields CustomersFieldsCmd     `cmd:"" help:"Alias for customers fields" hidden:""`
}

type CustomersConfigCopyCmd struct {
	From     string `help:"Source site" required:"" name:"from"`
	To       string `help:"Target site" required:"" name:"to"`
	FromHost string `help:"Source API base URL or host" name:"from-host"`
	ToHost   string `help:"Target API base URL or host" name:"to-host"`
}

type CustomersConfigDiffCmd struct {
	From     string `help:"Source site" required:"" name:"from"`
	To       string `help:"Target site" required:"" name:"to"`
	FromHost string `help:"Source API base URL or host" name:"from-host"`
	ToHost   string `help:"Target API base URL or host" name:"to-host"`
}

type CustomersCopyCmd struct {
	From           string `help:"Source site" required:"" name:"from"`
	To             string `help:"Target site" required:"" name:"to"`
	FromHost       string `help:"Source API base URL or host" name:"from-host"`
	ToHost         string `help:"Target API base URL or host" name:"to-host"`
	Query          string `help:"Raw query string to append to the source customer list"`
	Where          string `help:"Where expression for source customer selection"`
	PerPage        int    `help:"Items per page" name:"per-page"`
	Upsert         string `help:"Comma-separated upsert fields" default:"email"`
	PasswordLength int    `help:"Generated password length for newly created customers" name:"password-length" default:"12"`
	AllowErrors    bool   `name:"allow-errors" help:"Continue on item-level validation errors"`
}

type CustomersCountCmd struct {
	CountQueryFlags `embed:""`
}

type CustomersCreateCmd struct {
	File        string   `help:"Read customer JSON from file (use - for stdin)"`
	Assignments []string `arg:"" optional:"" help:"Inline assignments (e.g. email=a@b.com, first_name=Ana)"`
}

type CustomersDeleteCmd struct {
	Customer string `required:"" help:"Customer ID or email"`
}

type CustomersFieldsCmd struct{}

type CustomersGetCmd struct {
	Customer string `required:"" help:"Customer ID or email"`
}

type CustomersListCmd struct {
	QueryFlags `embed:""`
	All        bool `help:"Fetch all pages"`
	Page       int  `help:"Page number" default:"1"`
	PerPage    int  `help:"Items per page" default:"25"`
}

type CustomersResendConfirmationCmd struct {
	Customer string `required:"" help:"Customer ID or email"`
}

type CustomersResetPasswordCmd struct {
	Customer string `required:"" help:"Customer ID or email"`
}

type CustomersUpdateCmd struct {
	Customer    string   `required:"" help:"Customer ID or email"`
	File        string   `help:"Read customer JSON from file (use - for stdin)"`
	Assignments []string `arg:"" optional:"" help:"Inline assignments (e.g. first_name=Ana, phone=+32...)"`
}

type DomainRegistrationsCmd struct {
	List   DomainRegistrationsListCmd   `cmd:"" help:"List domain registrations"`
	Get    DomainRegistrationsGetCmd    `cmd:"" help:"Get a domain registration"`
	Count  DomainRegistrationsCountCmd  `cmd:"" help:"Count domain registrations"`
	Upsert DomainRegistrationsUpsertCmd `cmd:"" help:"Upsert registrar-managed facts by domain"`
	Update DomainRegistrationsUpdateCmd `cmd:"" help:"Update commercial fields by domain"`
}

type DomainRegistrationsCountCmd struct {
	CountQueryFlags `embed:""`
}

type DomainRegistrationsGetCmd struct {
	ID string `required:"" help:"Domain registration short ID"`
}

type DomainRegistrationsListCmd struct {
	QueryFlags `embed:""`
	All        bool `help:"Fetch all pages"`
	Page       int  `default:"1" help:"Page number"`
	PerPage    int  `default:"25" help:"Items per page"`
}

type DomainRegistrationsUpdateCmd struct {
	File        string   `help:"Read JSON from file (use - for stdin)"`
	Assignments []string `arg:"" optional:"" help:"Inline commercial field assignments"`
}

type DomainRegistrationsUpsertCmd struct {
	File        string   `help:"Read JSON from file (use - for stdin)"`
	Assignments []string `arg:"" optional:"" help:"Inline registrar fact assignments"`
}

type DomainsCmd struct {
	List        DomainsListCmd        `cmd:"" help:"List domains"`
	Get         DomainsGetCmd         `cmd:"" help:"Get domain details"`
	Create      DomainsCreateCmd      `cmd:"" help:"Create a domain"`
	Update      DomainsUpdateCmd      `cmd:"" help:"Update a domain"`
	Delete      DomainsDeleteCmd      `cmd:"" help:"Delete a domain"`
	MakePrimary DomainsMakePrimaryCmd `cmd:"" help:"Make a domain primary"`
}

type DomainsCreateCmd struct {
	Domain      string   `required:"" help:"Hostname"`
	File        string   `help:"Read domain JSON from file (use - for stdin)"`
	Assignments []string `arg:"" optional:"" help:"Inline assignments (e.g. redirect_domain=www.example.com, default_locale=nl)"`
}

type DomainsDeleteCmd struct {
	Domain string `required:"" help:"Domain ID or hostname"`
}

type DomainsGetCmd struct {
	Domain string `required:"" help:"Domain ID or hostname"`
}

type DomainsListCmd struct {
	QueryFlags `embed:""`
	All        bool `help:"Fetch all pages"`
	Page       int  `help:"Page number" default:"1"`
	PerPage    int  `help:"Items per page" default:"25"`
}

type DomainsMakePrimaryCmd struct {
	Domain string `required:"" help:"Domain ID or hostname"`
}

type DomainsUpdateCmd struct {
	Domain      string   `required:"" help:"Domain ID or hostname"`
	File        string   `help:"Read domain JSON from file (use - for stdin)"`
	Assignments []string `arg:"" optional:"" help:"Inline assignments (e.g. redirect_domain=www.example.com, default_locale=nl)"`
}

type EnvAddCmd struct {
	Name      string `arg:"" required:"" help:"Environment name"`
	Host      string `required:"" help:"API host"`
	Protected bool   `help:"Require confirmation for schema apply and release"`
}

type EnvCmd struct {
	List   EnvListCmd   `cmd:"" help:"List project environments"`
	Add    EnvAddCmd    `cmd:"" help:"Add a project environment"`
	Remove EnvRemoveCmd `cmd:"" help:"Remove a project environment"`
}

type EnvListCmd struct{}

type EnvRemoveCmd struct {
	Name string `arg:"" required:"" help:"Environment name"`
}

type EventsCmd struct {
	Track  EventsTrackCmd  `cmd:"" help:"Track a single named event"`
	Ingest EventsIngestCmd `cmd:"" help:"Ingest Count.ly-compatible events and metrics"`
}

type EventsIngestCmd struct {
	DeviceID        string `required:"" name:"device-id" help:"Analytics device identifier"`
	Events          string `help:"JSON array of events"`
	Metrics         string `help:"JSON metrics object"`
	Timestamp       string `help:"Unix timestamp"`
	BeginSession    bool   `name:"begin-session" help:"Mark the beginning of a session"`
	EndSession      bool   `name:"end-session" help:"Mark the end of a session"`
	SessionDuration string `name:"session-duration" help:"Session duration in seconds"`
}

type EventsTrackCmd struct {
	Event       string   `required:"" help:"Event name"`
	File        string   `help:"Read JSON from file (use - for stdin)"`
	Assignments []string `arg:"" optional:"" help:"Inline event payload assignments"`
}

type ExitError struct {
	Code int
	Err  error
}

type FunctionsCmd struct {
	Run FunctionsRunCmd `cmd:"" help:"Execute cloud function"`
}

type FunctionsRunCmd struct {
	Function    string   `help:"Function identifier"`
	File        string   `help:"Read function params JSON from file (use - for stdin)"`
	Assignments []string `arg:"" optional:"" help:"Inline assignments (e.g. foo=bar, amount:=2)"`
}

type InitCmd struct {
	Directory string `` /* 169-byte string literal not displayed */
	Repo      string `help:"GitHub repo shorthand for the starterskit" default:"zenjoy/theme-starterskit"`
	Branch    string `help:"Branch to bootstrap from" default:"main"`
	Dir       string `help:"Use a local starterskit directory instead of cloning"`
	OutputDir string `help:"Parent directory for the new project"`
}

type InternalCompleteCmd struct {
	Shell        string   `help:"Shell requesting completions" default:"bash"`
	Current      string   `help:"Current token being completed"`
	FlagNames    bool     `help:"Complete flag names" hidden:""`
	CommandNames bool     `help:"Complete command names" hidden:""`
	Words        []string `arg:"" optional:"" passthrough:""`
}

type JobsCmd struct {
	Run  JobsRunCmd  `cmd:"" help:"Schedule cloud job"`
	List JobsListCmd `cmd:"" help:"List jobs registered on the server"`
}

type JobsListCmd struct {
	App string `help:"Only jobs from this app (key or name)"`
}

type JobsRunCmd struct {
	Job         string   `help:"Job identifier"`
	File        string   `help:"Read job params JSON from file (use - for stdin)"`
	Wait        bool     `help:"After scheduling, tail the job's cloud-code logs until interrupted"`
	Assignments []string `arg:"" optional:"" help:"Inline assignments (e.g. foo=bar, retry:=true)"`
}

type MailsCmd struct {
	Pull NotificationsPullCmd `cmd:"" help:"Download notification templates"`
	Push NotificationsPushCmd `cmd:"" help:"Upload notification templates"`
}

type MenusCmd struct {
	List   MenusListCmd   `cmd:"" help:"List menus"`
	Get    MenusGetCmd    `cmd:"" help:"Get menu details"`
	Create MenusCreateCmd `cmd:"" help:"Create menu from JSON"`
	Update MenusUpdateCmd `cmd:"" help:"Update menu"`
	Delete MenusDeleteCmd `cmd:"" help:"Delete menu"`
	Count  MenusCountCmd  `cmd:"" help:"Count menus"`
	Copy   MenusCopyCmd   `cmd:"" help:"Copy menus between sites"`
}

type MenusCopyCmd struct {
	Slug     string `help:"Menu slug to copy" default:"*" name:"only"`
	From     string `help:"Source site" required:"" name:"from"`
	To       string `help:"Target site" required:"" name:"to"`
	FromHost string `help:"Source API base URL or host" name:"from-host"`
	ToHost   string `help:"Target API base URL or host" name:"to-host"`
}

type MenusCountCmd struct {
	CountQueryFlags `embed:""`
}

type MenusCreateCmd struct {
	Locale      string   `help:"Content locale for localized menu fields"`
	File        string   `help:"Read menu JSON from file (use - for stdin)"`
	Assignments []string `arg:"" optional:"" help:"Inline assignments (e.g. name=Main, handle=main)"`
}

type MenusDeleteCmd struct {
	Menu string `required:"" help:"Menu ID or handle"`
}

type MenusGetCmd struct {
	Menu   string `required:"" help:"Menu slug or handle"`
	Locale string `help:"Content locale for localized menu fields"`
}

type MenusListCmd struct {
	QueryFlags `embed:""`
	All        bool `help:"Fetch all pages"`
	Page       int  `help:"Page number" default:"1"`
	PerPage    int  `help:"Items per page" default:"25"`
}

type MenusUpdateCmd struct {
	Menu        string   `required:"" help:"Menu slug or handle"`
	Locale      string   `help:"Content locale for localized menu fields"`
	File        string   `help:"Read menu JSON from file (use - for stdin)"`
	Assignments []string `arg:"" optional:"" help:"Inline assignments (e.g. name=Main, handle=main)"`
}

type NotificationsCmd struct {
	List   NotificationsListCmd   `cmd:"" help:"List notifications"`
	Get    NotificationsGetCmd    `cmd:"" help:"Get notification details"`
	Pull   NotificationsPullCmd   `cmd:"" help:"Download notification templates"`
	Push   NotificationsPushCmd   `cmd:"" help:"Upload notification templates"`
	Create NotificationsCreateCmd `cmd:"" help:"Create notification from JSON"`
	Update NotificationsUpdateCmd `cmd:"" help:"Update notification"`
	Delete NotificationsDeleteCmd `cmd:"" help:"Delete notification"`
	Count  NotificationsCountCmd  `cmd:"" help:"Count notifications"`
	Copy   NotificationsCopyCmd   `cmd:"" help:"Copy notifications between sites"`
}

type NotificationsCopyCmd struct {
	Slug     string `help:"Notification slug to copy" default:"*" name:"only"`
	From     string `help:"Source site" required:"" name:"from"`
	To       string `help:"Target site" required:"" name:"to"`
	FromHost string `help:"Source API base URL or host" name:"from-host"`
	ToHost   string `help:"Target API base URL or host" name:"to-host"`
}

type NotificationsCountCmd struct {
	CountQueryFlags `embed:""`
}

type NotificationsCreateCmd struct {
	Locale      string   `help:"Content locale for localized notification fields"`
	File        string   `help:"Read notification JSON from file (use - for stdin)"`
	Assignments []string `arg:"" optional:"" help:"Inline assignments (e.g. slug=order_created, subject=Hello)"`
}

type NotificationsDeleteCmd struct {
	Notification string `required:"" help:"Notification slug or identifier"`
}

type NotificationsGetCmd struct {
	Notification string `required:"" help:"Notification slug or identifier"`
	Locale       string `help:"Content locale for localized notification fields"`
}

type NotificationsListCmd struct {
	QueryFlags `embed:""`
	All        bool `help:"Fetch all pages"`
	Page       int  `help:"Page number" default:"1"`
	PerPage    int  `help:"Items per page" default:"25"`
}

type NotificationsPullCmd struct {
	Only []string `help:"Only these notification slugs" name:"only"`
}

type NotificationsPushCmd struct {
	Only []string `help:"Notification slugs to push" short:"o"`
}

type NotificationsUpdateCmd struct {
	Notification string   `required:"" help:"Notification slug or identifier"`
	Locale       string   `help:"Content locale for localized notification fields"`
	File         string   `help:"Read notification JSON from file (use - for stdin)"`
	Assignments  []string `arg:"" optional:"" help:"Inline assignments (e.g. subject=Hello, html_enabled:=true)"`
}

type OrdersArchiveCmd struct {
	Order string `required:"" help:"Order ID or number"`
}

type OrdersCancelCmd struct {
	Order        string `required:"" help:"Order ID or number"`
	Notify       bool   `help:"Send notification" default:"true"`
	CancelReason string `name:"reason" help:"Cancel reason"`
}

type OrdersCmd struct {
	List    OrdersListCmd    `cmd:"" help:"List orders"`
	Get     OrdersGetCmd     `cmd:"" help:"Get order by ID or number"`
	Update  OrdersUpdateCmd  `cmd:"" help:"Update order (status changes)"`
	Count   OrdersCountCmd   `cmd:"" help:"Count orders"`
	Pay     OrdersPayCmd     `cmd:"" help:"Record manual payment for an order"`
	Finish  OrdersFinishCmd  `cmd:"" help:"Finish a paid order"`
	Cancel  OrdersCancelCmd  `cmd:"" help:"Cancel a completed order"`
	Reopen  OrdersReopenCmd  `cmd:"" help:"Reopen a done or canceled order"`
	Archive OrdersArchiveCmd `cmd:"" help:"Archive a done or canceled order"`
}

type OrdersCountCmd struct {
	CountQueryFlags `embed:""`
	Status          string `help:"Filter by status"`
}

type OrdersFinishCmd struct {
	Order  string `required:"" help:"Order ID or number"`
	Notify bool   `help:"Send notification" default:"true"`
}

type OrdersGetCmd struct {
	Order string `required:"" help:"Order ID or number"`
}

type OrdersListCmd struct {
	QueryFlags `embed:""`
	Status     string `help:"Filter by status"`
	All        bool   `help:"Fetch all pages"`
	Page       int    `help:"Page number" default:"1"`
	PerPage    int    `help:"Items per page" default:"25"`
}

type OrdersPayCmd struct {
	Order string `required:"" help:"Order ID or number"`
}

type OrdersReopenCmd struct {
	Order string `required:"" help:"Order ID or number"`
}

type OrdersUpdateCmd struct {
	Order       string   `required:"" help:"Order ID or number"`
	Status      string   `help:"Set order status"`
	File        string   `help:"Read order JSON from file (use - for stdin)"`
	Assignments []string `arg:"" optional:"" help:"Inline assignments (e.g. status=paid, note=Done)"`
}

type PageVersionsCmd struct {
	List    PageVersionsListCmd    `cmd:"" help:"List page versions"`
	Get     PageVersionsGetCmd     `cmd:"" help:"Get a page version"`
	Restore PageVersionsRestoreCmd `cmd:"" help:"Restore a page version"`
}

type PageVersionsGetCmd struct {
	Page    string `required:"" help:"Page ID or path"`
	Version string `required:"" name:"page-version" help:"Page version ID"`
}

type PageVersionsListCmd struct {
	Page string `required:"" help:"Page ID or path"`
}

type PageVersionsRestoreCmd struct {
	Page    string `required:"" help:"Page ID or path"`
	Version string `required:"" name:"page-version" help:"Page version ID"`
}

type PagesBatchCmd struct {
	Page   string `required:"" help:"Page fullpath or id"`
	File   string `required:"" help:"JSON operations object or array"`
	Atomic bool   `default:"true" negatable:"" help:"Fail the whole batch if any operation fails"`
	Locale string `help:"Content locale for localized fields"`
	Diff   bool   `help:"Show a unified diff of each changed subtree"`
	DryRun bool   `help:"Resolve paths and print the operations without writing"`
	Draft  bool   `help:"Write to the page draft instead of the live page"`
}

type PagesCmd struct {
	List        PagesListCmd        `cmd:"" help:"List pages"`
	Get         PagesGetCmd         `cmd:"" help:"Get page details"`
	Create      PagesCreateCmd      `cmd:"" help:"Create page from JSON"`
	Update      PagesUpdateCmd      `cmd:"" help:"Update page"`
	Delete      PagesDeleteCmd      `cmd:"" help:"Delete page"`
	Set         PagesSetCmd         `cmd:"" help:"Set one page field or editable by path"`
	Insert      PagesInsertCmd      `cmd:"" help:"Insert a repeatable into a canvas"`
	DeleteBlock PagesDeleteBlockCmd `cmd:"" name:"delete-block" help:"Delete a repeatable block"`
	Move        PagesMoveCmd        `cmd:"" help:"Move a repeatable within its canvas"`
	Batch       PagesBatchCmd       `cmd:"" help:"Apply multiple page operations from a file"`
	Draft       PagesDraftCmd       `cmd:"" help:"Work on page drafts (edit and preview without publishing)"`
	Items       PagesItemsCmd       `cmd:"" help:"Get a resolved items subtree"`
	Schema      PagesSchemaCmd      `cmd:"" help:"Show the page template schema"`
	Count       PagesCountCmd       `cmd:"" help:"Count pages"`
	Copy        PagesCopyCmd        `cmd:"" help:"Copy pages between sites"`
	Versions    PageVersionsCmd     `cmd:"" help:"Manage page versions"`
}

type PagesCopyCmd struct {
	Fullpath    string `help:"Page fullpath or prefix* to copy" default:"*" name:"only"`
	From        string `help:"Source site" required:"" name:"from"`
	To          string `help:"Target site" required:"" name:"to"`
	FromHost    string `help:"Source API base URL or host" name:"from-host"`
	ToHost      string `help:"Target API base URL or host" name:"to-host"`
	AllowErrors bool   `help:"Continue on page-level errors" name:"allow-errors"`
}

type PagesCountCmd struct {
	CountQueryFlags `embed:""`
}

type PagesCreateCmd struct {
	Locale      string   `help:"Content locale for localized page fields"`
	File        string   `help:"Read page JSON from file (use - for stdin)"`
	Assignments []string `arg:"" optional:"" help:"Inline assignments (e.g. slug=about, title=About)"`
}