gutterpress 0.11.23-alpha.4 → 0.11.23-alpha.6

package/dist/{index-yc3xj266.js → index-wm4x7xbf.js}

@@ -19,7 +19,7 @@ import {
   stringValueAt,
   toFolioPage,
   wantsRecto
-} from "./index-5kh4c78h.js";
+} from "./index-2vxzxyyj.js";
 import {
   launchChromium
 } from "./index-bt0qws5c.js";

package/dist/index.js

@@ -32,6 +32,7 @@ import {
   connectGoogleDrive,
   connectPublishProvider,
   defaultConfigDir,
+  deleteRevision,
   deleteSnippet,
   describeVersions,
   diagnoseProjectRemote,
@@ -79,6 +80,7 @@ import {
   readPageSetup,
   readPublishSettings,
   refreshRemoteCopies,
+  renameRevision,
   repairOnlineBackup,
   reportMissingTools,
   requireGoogleClientCredentials,
@@ -100,6 +102,7 @@ import {
   runPublish,
   sanitizeCloneFolderName,
   saveProjectAsTemplate,
+  savePublishSettings,
   saveSnippet,
   scaffoldExtension,
   scaffoldProject,
@@ -116,7 +119,7 @@ import {
   substituteVariables,
   syncProject,
   testRemoteAccess
-} from "./index-ea94zbq4.js";
+} from "./index-ejbfetdn.js";
 import {
   DEFAULT_NPM_REGISTRY,
   MANIFEST_FILENAMES,
@@ -146,7 +149,7 @@ import {
   setExtensionEnabled,
   updateExtensions,
   validateProjectExtensions
-} from "./index-kaks3mm2.js";
+} from "./index-cmakyf43.js";
 import {
   BUNDLED_EXTENSIONS,
   EXTENSION_MANIFEST_FILENAME,
@@ -162,12 +165,12 @@ import {
   pathEscapesFolder,
   readExtensionMeta,
   resolveExtension
-} from "./index-8ywkd2sv.js";
+} from "./index-1zqkfzcd.js";
 import"./index-ht1bcqdd.js";
 import {
   BUILD_DIAGNOSTIC_CODES
-} from "./index-yc3xj266.js";
-import"./index-5kh4c78h.js";
+} from "./index-wm4x7xbf.js";
+import"./index-2vxzxyyj.js";
 import {
   BuildError
 } from "./index-46ycxe6r.js";
@@ -183,14 +186,16 @@ import {
   RESTORE_BACKUP_MESSAGE,
   SWITCH_BRANCH_SNAPSHOT_MESSAGE,
   countUnversionedChanges,
+  createRevision,
   isNoChangesError,
-  listLocalBranches,
+  listRevisions,
   providerFor,
   resolveLogger,
   restoreVersionWithBackup,
+  revisionNameFrom,
   switchBranch,
   whenGitIdle
-} from "./index-h6yk5tjx.js";
+} from "./index-cw03e9p4.js";
 import {
   EXTENSIONS_DIR
 } from "./index-5x42amh8.js";
@@ -224,6 +229,7 @@ export {
   scaffoldProject,
   scaffoldExtension,
   saveSnippet,
+  savePublishSettings,
   saveProjectAsTemplate,
   sanitizeCloneFolderName,
   sameExtension,
@@ -234,6 +240,7 @@ export {
   ruleRiskyProps,
   ruleRemoteUrls,
   revokeGoogleCredential,
+  revisionNameFrom,
   restoreVersionWithBackup,
   restorePinnedExtensions,
   restoreFailureMessage,
@@ -255,6 +262,7 @@ export {
   repoRootForSource,
   repairOnlineBackup,
   reorderExtensions,
+  renameRevision,
   removeExtension,
   refreshRemoteCopies,
   readyProbeExpr,
@@ -278,6 +286,7 @@ export {
   loadManifestWithPath,
   loadManifest,
   listSnippets,
+  listRevisions,
   listRepoBooks,
   listPublishProviders,
   listPublishAccounts,
@@ -288,7 +297,6 @@ export {
   listMergedSnippets,
   listMarkerComponents,
   listLocationVariants,
-  listLocalBranches,
   listGitHubRepositories,
   listGitHubBranches,
   listCustomTemplates,
@@ -329,7 +337,9 @@ export {
   describeVersions,
   describeExtension,
   deleteSnippet,
+  deleteRevision,
   defaultConfigDir,
+  createRevision,
   countUnversionedChanges,
   connectPublishProvider,
   connectGoogleDrive,

package/dist/lib/publish/connect.d.ts

@@ -1,6 +1,7 @@
 import { type PublishDeps } from "./types.ts";
 export interface ConnectPublishProviderOptions {
-    projectDir: string;
+    /** The book whose manifest settings the check reads; omit to connect with no book open. */
+    projectDir?: string;
     providerId: string;
     /** The pasted API key. NEVER log this. */
     token: string;
@@ -11,6 +12,12 @@ export interface ConnectPublishProviderOptions {
      */
     account?: string;
     manifestPath?: string;
+    /**
+     * With no `projectDir` only: Shopify's store address (`publish.shopify.shop`
+     * in a book's manifest), which its key check needs. Used for the check and
+     * never stored; ignored when a book supplies its own settings.
+     */
+    shop?: string;
 }
 /**
  * Verify `token` with the platform, then store it. Throws a friendly,

package/dist/lib/publish/manifest-publish.d.ts

@@ -1,5 +1,10 @@
-/** All `publish.*` sections, as plain JSON keyed by provider id (absent → {}). */
-export declare function readPublishSettings(projectDir: string): Promise<Record<string, Record<string, unknown>>>;
+import type { PublishSelectionsStore } from "./selections.ts";
+/**
+ * All `publish.*` sections, as plain JSON keyed by provider id (absent → {}).
+ * With the person's private store, what they see: their own values for the
+ * book laid over the manifest's.
+ */
+export declare function readPublishSettings(projectDir: string, selections?: Pick<PublishSelectionsStore, "settings">): Promise<Record<string, Record<string, unknown>>>;
 /**
  * Merge `values` into `publish.<providerId>`. A value of `undefined`, `null`
  * or `""` deletes that key; emptied sections (and an emptied `publish:` map)
@@ -7,3 +12,22 @@ export declare function readPublishSettings(projectDir: string): Promise<Record<
  * from the in-memory document — no re-read.
  */
 export declare function setPublishProviderConfig(projectDir: string, providerId: string, values: Record<string, unknown>): Promise<Record<string, Record<string, unknown>>>;
+/**
+ * Save a provider's settings where each belongs. The team decides where the
+ * book is published, so that is shared and goes in the manifest
+ * ({@link setPublishProviderConfig}): which destinations, each one's target,
+ * store, folder, environment and format. Only what is one person's own goes in
+ * their private store, keyed to this book, and is removed from the manifest if
+ * an older book kept it there:
+ *
+ * - `credential`: which of their saved accounts the book publishes with.
+ * - the local output folder `dir`, when it lies outside the book (a personal
+ *   override). A folder inside the book is shared, and is written relative to
+ *   it (an absolute in-book path is rewritten) so it means the same thing on
+ *   every computer. An absolute path is never written to the manifest.
+ *
+ * Only the values passed are classified; the manifest is not rewritten unless
+ * one of them changes it. Empty values clear. Returns the settings as the
+ * person now sees them ({@link readPublishSettings}).
+ */
+export declare function savePublishSettings(projectDir: string, providerId: string, values: Record<string, unknown>, selections: Pick<PublishSelectionsStore, "settings" | "setSettings">): Promise<Record<string, Record<string, unknown>>>;

package/dist/lib/publish/selections.d.ts

@@ -1,3 +1,5 @@
+/** One provider's private values for a book (strings only, as the manifest's are). */
+type BookSettings = Record<string, string>;
 /** Both levels' explicit selections for a provider (for the UI). */
 export interface PublishAccountSelection {
     project?: string;
@@ -20,6 +22,15 @@ export declare class PublishSelectionsStore {
     levels(providerId: string, projectDir?: string): Promise<PublishAccountSelection>;
     /** Set (or clear, with an empty account) the global default for a provider. */
     setGlobal(providerId: string, account: string | null): Promise<void>;
-    /** Set (or clear) the default for one provider within one project. */
+    /** Set (or clear) the saved account one provider uses within one project. */
     setProject(projectDir: string, providerId: string, account: string | null): Promise<void>;
+    /** Every private value for one book, by provider id (empty when none). */
+    settings(projectDir: string): Promise<Record<string, BookSettings>>;
+    /**
+     * Merge `values` into one provider's private values for one book. A value of
+     * `null` or `""` clears that key; an emptied provider (and book) entry is
+     * removed rather than left dangling. Nothing is written when nothing changes.
+     */
+    setSettings(projectDir: string, providerId: string, values: Record<string, string | null>): Promise<void>;
 }
+export {};

package/dist/lib/publish/types.d.ts

@@ -19,6 +19,7 @@
  * host responses.
  */
 import type { HostCredential, TokenStore } from "../remote-auth/token-store.ts";
+import type { PublishSelectionsStore } from "./selections.ts";
 /**
  * One author-editable, NON-SECRET settings field (stored in the manifest's
  * `publish.<id>` section). Declared by each provider so settings UIs are
@@ -123,8 +124,9 @@ export interface PublishPluginContext {
     /** The one build output validated for this run: a PDF file, or the
      *  website export directory. */
     artifact: PublishArtifact;
-    /** The manifest's `publish.<package-name>` section, minus the two keys core
-     *  reads from it: `format` (which build to publish) and `credential`. */
+    /** The manifest's `publish.<package-name>` section, minus the keys core
+     *  reads from it: `format` (which build to publish), `credential` and
+     *  `enabled` (whether the desktop's Publish view ticks it). */
     settings: Record<string, unknown>;
     /** Progress line sink. Use this, never `console.log`: stdout carries
      *  `--json` output. */
@@ -197,11 +199,19 @@ export interface PublishDeps {
      * keyed by a compound `<host>#<account>` for named accounts (see
      * {@link publishCredentialKey}); empty/undefined resolves the legacy
      * bare-host entry, so existing single-credential setups keep working. The
-     * orchestrator sets this from the effective selection (book manifest →
-     * project/global default); providers read it transparently via
-     * {@link resolvePublishCredential}.
+     * orchestrator sets this from the effective selection (the person's private
+     * choice for the book → the book manifest → this front-end default);
+     * providers read it transparently via {@link resolvePublishCredential}.
      */
     credentialAccount?: string;
+    /**
+     * The person's PRIVATE publishing values for a book (see
+     * {@link PublishSelectionsStore}): which saved account to use and an output
+     * folder outside the book. When given, they win over the manifest's
+     * `publish.<id>` values in every request. Absent (the CLI today): the
+     * manifest alone.
+     */
+    selections?: Pick<PublishSelectionsStore, "settings">;
 }
 /**
  * The TokenStore key for a publishing provider credential. Named accounts use a

package/dist/lib/remote-auth/repair.d.ts

@@ -1,6 +1,6 @@
 import type { SyncOutcome, SyncProjectOptions } from "./sync-types.ts";
-/** Message recorded on the version a repair saves. */
-export declare const REPAIR_SNAPSHOT_MESSAGE = "Repaired online backup";
+/** Message recorded on the version a repair saves (older history says "Repaired online backup"). */
+export declare const REPAIR_SNAPSHOT_MESSAGE = "Repaired the online copy";
 export interface RepairOnlineBackupOptions extends Pick<SyncProjectOptions, "projectDir" | "credential" | "tokenStore" | "authorName" | "authorEmail" | "logFile" | "httpClient"> {
     /**
      * Where the old `.git` and the fresh download go — chosen by the host,

package/dist/lib/remote-auth/revisions.d.ts

@@ -0,0 +1,60 @@
+import { defaultGitHttp } from "./git-http.ts";
+import type { HostCredential, TokenStore } from "./token-store.ts";
+/** How the online copy is reached: the same options `refreshRemoteCopies` takes. */
+interface OnlineOptions {
+    credential?: HostCredential;
+    tokenStore?: TokenStore;
+    httpClient?: typeof defaultGitHttp;
+}
+export interface RenameRevisionOptions extends OnlineOptions {
+    projectDir: string;
+    from: string;
+    /** The new name as typed; spaces become hyphens. */
+    to: string;
+}
+export interface DeleteRevisionOptions extends OnlineOptions {
+    projectDir: string;
+    name: string;
+    /** Also remove it from the online copy (when it is there); default: this computer only. */
+    everywhere?: boolean;
+    /** Delete even though the revision holds versions found nowhere else. */
+    discard?: boolean;
+}
+/**
+ * Rename a revision. The open revision may be renamed (the book stays open on it).
+ *
+ * One that is also in the online copy is renamed there too, in an order that
+ * never loses anything, so each failure leaves a known state:
+ *  1. send the new name online — a failure leaves everything as it was;
+ *  2. remove the old name online — a failure removes the new name again, so
+ *     everything is as it was; only if that can't be done either (the network
+ *     dropped between the two) does the online copy keep both names, which the
+ *     error says;
+ *  3. rename on this computer — only a local failure is possible here, and it
+ *     leaves the online copy renamed and this computer under the old name, still
+ *     listed (the new name shows as online-only).
+ * Offline or a rejected sign-in: nothing is renamed, anywhere.
+ */
+export declare function renameRevision(options: RenameRevisionOptions): Promise<{
+    current: string | null;
+    name: string;
+}>;
+/**
+ * Delete a revision. Never the open one. By default only on this computer
+ * (a copy in the online copy stays, and shows as online-only); `everywhere`
+ * removes it from the online copy first, then here — a failure online leaves
+ * everything as it was, a failure here leaves it removed online and still
+ * listed on this computer.
+ *
+ * Nothing found only in the revision is deleted without a second look: when it
+ * holds versions found in no other revision (and, unless deleted everywhere, not
+ * in the online copy), the first call returns how many and deletes nothing; the
+ * caller asks and calls again with `discard: true`.
+ */
+export declare function deleteRevision(options: DeleteRevisionOptions): Promise<{
+    deleted: true;
+} | {
+    deleted: false;
+    versionsOnlyHere: number;
+}>;
+export {};

package/dist/lib/remote-auth/scorched-earth.d.ts

@@ -1,12 +1,12 @@
 import type { SyncProjectOptions } from "./sync-types.ts";
 export interface ScorchedEarthOptions extends Pick<SyncProjectOptions, "projectDir" | "credential" | "tokenStore" | "logFile" | "httpClient"> {
-    /** Where the full copy of the folder goes — OUTSIDE the folder. Kept indefinitely. */
+    /** Where the safety folder goes — OUTSIDE the book's folder. Kept indefinitely. */
     backupDir: string;
 }
 export interface ScorchedEarthResult {
     /** The folder that was reset (the repo root of `projectDir`). */
     dir: string;
-    /** Where the full copy of the folder (old `.git` included) was kept. */
+    /** Where the safety folder (the old folder, `.git` included) was kept. */
     backupDir: string;
     /** The branch the fresh copy has checked out. */
     branch?: string;

package/dist/lib/remote-auth/sync-messages.d.ts

@@ -1,39 +1,40 @@
 /**
- * Author-language copy for sync (never raw git words). Extracted from sync.ts
- * so the transport and orchestrator modules share ONE source of these
- * strings — their exact wording is part of the observable contract (the host
- * renders them verbatim).
+ * Author-language copy for backing up and getting the latest — never sync,
+ * push, pull, repository, branch or snapshot. Extracted from sync.ts so the
+ * transport and orchestrator modules share ONE source of these strings — their
+ * exact wording is part of the observable contract (the host renders them
+ * verbatim).
  */
-export declare const MSG_UP_TO_DATE = "Everything is in sync.";
-export declare const MSG_UP_TO_DATE_PULLED = "Everything is in sync. The latest online changes were downloaded to this computer.";
+export declare const MSG_UP_TO_DATE = "You're up to date with the online copy.";
+export declare const MSG_UP_TO_DATE_PULLED = "You're up to date. The latest changes from the online copy were downloaded to this computer.";
 export declare const MSG_SYNCED = "Your changes are online.";
 export declare const MSG_SYNCED_MERGED = "Your changes are online, combined with changes from the online copy.";
-export declare const MSG_OFFLINE = "Your changes are saved on this computer. Gutterpress couldn't reach the online repository \u2014 try syncing again when you're back online.";
-export declare const MSG_AUTH = "The online repository didn't accept the saved connection. Reconnect and try again.";
-export declare const MSG_INSECURE_TRANSPORT = "This book's online address isn't secure, so the saved connection wasn't sent \u2014 connections are never sent over an insecure address. Switch the address to a secure one (starting with https), or to a local loopback address for a server on this computer, to sync.";
-export declare const MSG_BUSY = "The online copy is changing very quickly right now. Your work is saved on this computer \u2014 try Sync again in a moment.";
+export declare const MSG_OFFLINE = "Your changes are saved on this computer. Gutterpress couldn't reach the online copy \u2014 try again when you're back online.";
+export declare const MSG_AUTH = "The online copy didn't accept the saved sign-in. Sign in again and try again.";
+export declare const MSG_INSECURE_TRANSPORT = "This book's online copy is at an address that isn't secure, so the saved sign-in wasn't sent \u2014 sign-ins are never sent over an insecure address. Switch the address to a secure one (starting with https), or to a local loopback address for a server on this computer, to back up.";
+export declare const MSG_BUSY = "The online copy is changing very quickly right now. Your work is saved on this computer \u2014 try again in a moment.";
 /**
- * The book's own version history is unreadable — a damaged or missing
- * `.git`. Says the three things that are actually true and useful: the writing
- * is safe, the HISTORY is what broke, and (sync always has a remote, so this
- * always applies here) Repair online backup is the way back.
+ * The book's own versions are unreadable — a damaged or missing `.git`. Says
+ * the three things that are actually true and useful: the writing is safe, the
+ * VERSIONS are what broke, and (backing up always has an online copy, so this
+ * always applies here) "Repair the online copy" is the way back.
  */
-export declare const MSG_HISTORY_UNREADABLE = "This book's version history can't be read, so syncing can't continue. Your writing is safe \u2014 every file is still here on this computer. Use Repair online backup (in Where your work is kept) to get history and syncing working again.";
-export declare const MSG_UNRELATED = "This book and the online copy have no history in common, so they can't be combined. Either the online address points at a different book, or this book's own history was lost and started over. Your writing is safe \u2014 every file is still here on this computer. Check the online address; if it is correct, use Repair online backup (in Where your work is kept).";
-export declare const MSG_NO_REMOTE = "This book isn't connected to an online repository yet.";
-export declare const MSG_SSH_REMOTE = "This book's online address uses SSH (git@\u2026), which Gutterpress can't sync to. Switch it to the web (HTTPS) address to sync from here.";
-export declare const MSG_NO_BRANCH = "This book's version history isn't on a named branch, so it can't be synced right now.";
-/** Message recorded on the automatic pre-sync snapshot (D5 invariant).
- *  Pre-0.10.1 history carries the old spelling "Snapshot before syncing". */
-export declare const SYNC_SNAPSHOT_MESSAGE = "Automatic backup of your work";
+export declare const MSG_HISTORY_UNREADABLE = "This book's versions can't be read, so backing up can't continue. Your writing is safe \u2014 every file is still here on this computer. Use \"Repair the online copy\" (in Book setup \u2192 Online copy) to get versions and backing up working again.";
+export declare const MSG_UNRELATED = "This book and the online copy have no versions in common, so they can't be combined. Either the online copy's address points at a different book, or this book's own versions were lost and started over. Your writing is safe \u2014 every file is still here on this computer. Check the online copy's address; if it is correct, use \"Repair the online copy\" (in Book setup \u2192 Online copy).";
+export declare const MSG_NO_REMOTE = "This book doesn't have an online copy yet.";
+export declare const MSG_SSH_REMOTE = "This book's online copy uses an SSH address (git@\u2026), which Gutterpress can't back up to. Switch it to the web (HTTPS) address to back up from here.";
+export declare const MSG_NO_BRANCH = "This book isn't on a named revision, so it can't be backed up right now.";
+/** Message recorded on the automatic version saved before backing up (D5 invariant).
+ *  Older history carries the spellings "Automatic backup of your work" and,
+ *  before 0.10.1, "Snapshot before syncing". */
+export declare const SYNC_SNAPSHOT_MESSAGE = "Automatic version before backing up";
 /**
  * Message recorded when an edit reached disk while the fetch was in flight —
- * after the pre-sync snapshot, before the merge (see the re-snapshot in
- * `syncProject`). Distinct wording so the race is legible in history; the
- * copy is already writer-voiced, so it deliberately stays unchanged (every
- * rename permanently grows the timeline's superseded-spelling list).
+ * after the pre-backup version, before the merge (see the re-snapshot in
+ * `syncProject`). Distinct wording so the race is legible in history. Older
+ * history carries the spelling "Saved the edit you made while syncing".
  */
-export declare const SYNC_LATE_EDIT_MESSAGE = "Saved the edit you made while syncing";
+export declare const SYNC_LATE_EDIT_MESSAGE = "Saved the edit you made while backing up";
 /**
  * The keep-both sibling contract, kept HERE rather than in converge-merge.ts
  * because every consumer needs it and converge-merge pulls in isomorphic-git:

package/dist/lib/remote-auth/sync-types.d.ts

@@ -54,6 +54,9 @@ export type SyncOutcome = {
      *  and then hold the push — the converge report still surfaces here. */
     combinedFiles?: string[];
     keptBothFiles?: KeptBothFile[];
+    /** A pull-merge-only pass that held the push: this computer has versions
+     *  the online copy lacks. Never set when the tips already matched. */
+    pushDeferred?: true;
 } | {
     status: "auth";
     message: string;

package/dist/lib/remote-auth/sync.d.ts

@@ -29,26 +29,25 @@ export declare function isUnrelatedHistories(e: unknown): boolean;
  */
 export declare function syncProject(options: SyncProjectOptions): Promise<SyncOutcome>;
 /**
- * Fetch every branch the remote has, so the project's copy list reflects what
+ * Fetch every branch the remote has, so the book's revision list reflects what
  * exists online rather than only what this clone happened to fetch before.
  *
- * The copy picker reads refs off disk (`listLocalBranches`). That makes a
- * branch pushed from anywhere else — another machine, the web UI, an agent
- * opening a PR — invisible here until someone runs `git fetch` in a terminal,
- * which is precisely the thing this app exists to avoid. So the picker calls
- * this first.
+ * `listRevisions` reads refs off disk. That makes a branch pushed from anywhere
+ * else — another machine, the web UI, an agent opening a PR — invisible here
+ * until someone runs `git fetch` in a terminal, which is precisely the thing
+ * this app exists to avoid. So the revision list calls this first.
  *
  * Unlike `fetchRemoteTip` this deliberately does NOT use `singleBranch`: the
  * whole point is the branches we do not have yet. It only ever writes
  * remote-tracking refs (`refs/remotes/<remote>/*`) — no local branch, no
  * working-tree change, no merge — so it is safe to call on a dirty tree.
  * `prune` drops tracking refs for branches deleted online, so the list cannot
- * offer a copy that is gone.
+ * offer a revision that is gone.
  *
  * Best-effort by contract: offline, unauthenticated, or no remote at all
  * resolves to `{ refreshed: false, reason }` rather than throwing. A stale
  * list beats an error dialog over a control the author did not explicitly ask
- * to sync — but it reports WHY, because a picker that silently omits copies
+ * to sync — but it reports WHY, because a list that silently omits revisions
  * is indistinguishable from a broken one, which is the bug this whole
  * function exists to fix.
  */

package/dist/lib/remote-auth/transport.d.ts

@@ -107,8 +107,15 @@ export declare function currentBranchOrThrow(dir: string): Promise<string>;
 export declare function guardTrackingRef<T>(dir: string, ref: string, cache: GitCache, fn: () => Promise<T>): Promise<T>;
 /**
  * Fetch the tracked branch's online tip. Returns `null` when the online
- * repository has no such branch yet (a freshly created empty repo).
+ * copy has no such revision yet (a freshly created empty repo, or a revision
+ * started on this computer).
  */
 export declare function fetchRemoteTip(dir: string, branch: string, transport: RemoteTransport, http: typeof httpNode, cache: GitCache): Promise<string | null>;
+/**
+ * The online copy's tip for `branch` as the server advertises it right now.
+ * Reads refs only (`listServerRefs`: no objects downloaded, no history walked,
+ * nothing written); `undefined` when the online copy has no such revision.
+ */
+export declare function serverTip(transport: RemoteTransport, branch: string, http: typeof httpNode): Promise<string | undefined>;
 /** First 8 chars of an oid for diagnostic log lines (null-safe). */
 export declare function short(oid: string | null | undefined): string;