npmrelease

type CommandResult struct {
	Output string
	Code   int
	Err    error
}

type CommandRunner interface {
	Run(context.Context, string, ...string) CommandResult
}

type OSCommandRunner struct{}

type Options struct {
	Apply        bool
	DryRun       bool
	Resume       bool
	Ref          string
	Timeout      time.Duration
	PollInterval time.Duration
	Registry     string
	ReportDir    string
	Runner       CommandRunner
	Now          func() time.Time
	Persist      func(Report) error
	Previous     *Report
	Progress     progress.Reporter
	// contains filtered or unexported fields
}

type Receipt struct {
	Release
	Status     string    `json:"status" yaml:"status"`
	Reason     string    `json:"reason,omitempty" yaml:"reason,omitempty"`
	DispatchAt time.Time `json:"dispatch_at,omitempty" yaml:"dispatch_at,omitempty"`
	HeadSHA    string    `json:"head_sha,omitempty" yaml:"head_sha,omitempty"`
	// DispatchBaselineAt and DispatchBaselineRunIDs are captured before the
	// workflow_dispatch request. They are the primary identity fence for a
	// resume: only an exact-head run absent from this set can be the run WB
	// dispatched. A timestamp is retained solely as a bounded secondary check
	// against a delayed, pre-existing run that was absent from GitHub's list.
	DispatchBaselineAt     time.Time `json:"dispatch_baseline_at,omitempty" yaml:"dispatch_baseline_at,omitempty"`
	DispatchBaselineRunIDs []string  `json:"dispatch_baseline_run_ids,omitempty" yaml:"dispatch_baseline_run_ids,omitempty"`
	RunID                  string    `json:"run_id,omitempty" yaml:"run_id,omitempty"`
	RunURL                 string    `json:"run_url,omitempty" yaml:"run_url,omitempty"`
	RunHeadSHA             string    `json:"run_head_sha,omitempty" yaml:"run_head_sha,omitempty"`
	RunStatus              string    `json:"run_status,omitempty" yaml:"run_status,omitempty"`
	RunConclusion          string    `json:"run_conclusion,omitempty" yaml:"run_conclusion,omitempty"`
	RunCreatedAt           time.Time `json:"run_created_at,omitempty" yaml:"run_created_at,omitempty"`
	RunCompletedAt         time.Time `json:"run_completed_at,omitempty" yaml:"run_completed_at,omitempty"`
	RegistryVersion        string    `json:"registry_version,omitempty" yaml:"registry_version,omitempty"`
	RegistryURL            string    `json:"registry_url,omitempty" yaml:"registry_url,omitempty"`
	RegistryCheckedAt      time.Time `json:"registry_checked_at,omitempty" yaml:"registry_checked_at,omitempty"`
}

type Release struct {
	Repository       string `json:"repository" yaml:"repository"`
	Workflow         string `json:"workflow" yaml:"workflow"`
	Package          string `json:"package" yaml:"package"`
	Version          string `json:"version" yaml:"version"`
	Ref              string `json:"ref" yaml:"ref"`
	InputFingerprint string `json:"input_fingerprint,omitempty" yaml:"input_fingerprint,omitempty"`
	// Inputs are deliberately process-local. Even safe-looking workflow field
	// values can carry a credential by mistake, so reports and stdout retain
	// only InputFingerprint for resume identity and never serialize raw values.
	Inputs map[string]string `json:"-" yaml:"-"`
}

type Report struct {
	SchemaVersion        int                 `json:"schema_version" yaml:"schema_version"`
	Operation            string              `json:"operation" yaml:"operation"`
	Generation           string              `json:"generation,omitempty" yaml:"generation,omitempty"`
	Status               string              `json:"status" yaml:"status"`
	Ref                  string              `json:"ref" yaml:"ref"`
	Releases             []Receipt           `json:"releases" yaml:"releases"`
	Events               []deps.ReleaseEvent `json:"events,omitempty" yaml:"events,omitempty"`
	PropagationOperation string              `json:"propagation_operation,omitempty" yaml:"propagation_operation,omitempty"`
	// Propagation is the same persisted BumpReport the regular `wb deps bump
	// npm` engine produces. Keeping it here makes the publication receipt
	// independently resumable and machine-readable without a parallel wave
	// orchestration format.
	Propagation *deps.BumpReport `json:"propagation,omitempty" yaml:"propagation,omitempty"`
}