Made of little things.

// The score-card share contract between the game (SDK-free) and src/share.

/** The finished campaign run shown on the card and in the note. */
export interface RunSummary {
  score: number;
  brined: number;
  onions: number;
  tears: number;
  wins: number;
  newBest: boolean;
}

export interface ScoreCard {
  /** The drawn card, shown as the composer preview. */
  preview: HTMLCanvasElement;
  png: Blob;
}

export interface ShareResult {
  ok: boolean;
  /** No further attempt should be offered (posted, or partly posted). */
  done: boolean;
  message: string;
}

export interface ScoreShare {
  /** A viewer is signed in and identity, upload and outbox are all present. */
  readonly available: boolean;
  onChange(listener: () => void): void;
  /** Draw the card over a 16:9 snapshot of the victory scene. */
  makeCard(run: RunSummary, scene: HTMLCanvasElement): Promise<ScoreCard>;
  /** Upload the PNG, then publish a kind 1 note that embeds it. */
  post(png: Blob, text: string, onStatus: (text: string) => void): Promise<ShareResult>;
}