components/publish-gate/publish-transition.ts

Functions

Imports

It imports no other module of this repo. Imported by components/publish-gate/publish-gate.ts.

Source

1// The publish transitions a post editor offers, and the draft flag each one asks for. Pure, with no
2// DOM, so a server action imports it as `capsomer/publish-transition` beside the gate's page.
3//
4// The pressed button's intent carries the transition, not a hidden field: a submitter's value is the
5// one part of a form sent because of what was pressed, so the buttons mean the same without script.
6
7export type PostState = "draft" | "scheduled" | "published";
8
9export interface Transition {
10  id: string;
11  label: string;
12  wantsDraft: boolean;
13  ceremony: boolean;
14  danger: boolean;
15}
16
17const SAVE_DRAFT: Transition = { id: "save-draft", label: "Save draft", wantsDraft: true, ceremony: false, danger: false };
18
19const SAVE_CHANGES: Transition = { id: "save", label: "Update", wantsDraft: false, ceremony: false, danger: false };
20
21const UNPUBLISH: Transition = {
22  id: "unpublish",
23  label: "Revert to draft",
24  wantsDraft: true,
25  ceremony: false,
26  // Not destructive, but it takes something off the public site.
27  danger: true,
28};
29
30export function transitionsFor(state: PostState, everPublished: boolean): [Transition, ...Transition[]] {
31  if (state === "draft") {
32    return [
33      {
34        id: everPublished ? "republish" : "publish",
35        label: everPublished ? "Republish" : "Publish",
36        wantsDraft: false,
37        // Only a never-public post gets the ceremony; asking again on republish trains click-through.
38        ceremony: !everPublished,
39        danger: false,
40      },
41      SAVE_DRAFT,
42    ];
43  }
44  // Published and scheduled are both draft: false; publish_at is the schedule control's, not this table's.
45  return [SAVE_CHANGES, UNPUBLISH];
46}
47
48/** Publish is the ask and this is the answer; both mean draft: false, only this passes the ceremony. */
49export const PUBLISH_CONFIRMED_INTENT = "publish-confirmed";
50
51/** What the first-publication confirmation says, with or without script. */
52export const FIRST_PUBLICATION_NOTE = "It has never been public. Publishing puts it on the blog, in the feed, the sitemap, the search index and the AI answer layer.";
53
54// No prototype, so an intent such as "constructor" is unknown here too, not Object.prototype's.
55export const DRAFT_BY_INTENT: Readonly<Record<string, boolean>> = Object.freeze(
56  Object.assign(Object.create(null) as Record<string, boolean>, Object.fromEntries([
57    ...[...transitionsFor("draft", false), ...transitionsFor("draft", true), ...transitionsFor("published", true)].map((t) => [t.id, t.wantsDraft]),
58    [PUBLISH_CONFIRMED_INTENT, false],
59  ])),
60);
61
62/** Fails closed: an unknown intent is a draft, so the failure mode is a post that stays private. */
63export function draftForIntent(intent: string | null): boolean {
64  if (intent === null) return true;
65  return DRAFT_BY_INTENT[intent] ?? true;
66}
67
68/** Cmd+S submits with no submitter, so it has to name the transition that keeps the current state. */
69export function saveInPlaceIntent(state: PostState): string {
70  const wantsDraft = state === "draft";
71  // everPublished does not change which transition saves in place, so false is passed.
72  const match = transitionsFor(state, false).find((t) => t.wantsDraft === wantsDraft);
73  return match ? match.id : SAVE_DRAFT.id;
74}
75
76/** Takes now rather than reading the clock, so a component recomputing it cannot hydrate a different word. */
77export function stateOf(fields: { draft: boolean; publishAt: string }, now: number): PostState {
78  if (fields.draft) return "draft";
79  if (!fields.publishAt) return "published";
80  const at = Date.parse(fields.publishAt);
81  // An unparseable publish_at is not a schedule; treating it as one would hide a live post.
82  if (Number.isNaN(at)) return "published";
83  return at > now ? "scheduled" : "published";
84}