Function assertForkMainCurrent

packages/wl-sdk/src/ops/state.ts:191–231

(opts: {
  auth: DoltHubAuth;
  upstream: { owner: string; db: string };
  fork: { forkOwner: string; forkDb: string };
  fetch?: typeof fetch;
  hooks?: DoltFetchHooks;
})

 * no-op than to block a healthy mutation on a transient read error).
 */
export async function assertForkMainCurrent(opts: {
  auth: DoltHubAuth;
  upstream: { owner: string; db: string };
  fork: { forkOwner: string; forkDb: string };
  fetch?: typeof fetch;
  hooks?: DoltFetchHooks;
}): Promise<void> {
  const [upstreamHead, forkHead] = await Promise.all([
    readBranchHead({
      auth: opts.auth,
      owner: opts.upstream.owner,
      db: opts.upstream.db,
      branch: 'main',
      fetch: opts.fetch,
      hooks: opts.hooks,
    }),
    readBranchHead({
      auth: opts.auth,
      owner: opts.fork.forkOwner,
      db: opts.fork.forkDb,
      branch: 'main',
      fetch: opts.fetch,
      hooks: opts.hooks,
    }),
  ]);

  // If either read returned null, we can't decide. Don't block.
  if (upstreamHead === null || forkHead === null) return;
  if (upstreamHead === forkHead) return;

  // Drift detected. Compose the deep-link to the fork's pulls/new page,
  // which is where DoltHub surfaces the "Sync from upstream" UI.
  const syncUrl = `https://www.dolthub.com/repositories/${encodeURIComponent(opts.fork.forkOwner)}/${encodeURIComponent(opts.fork.forkDb)}/pulls/new`;
  throw new WlError(
    `Your DoltHub fork ${opts.fork.forkOwner}/${opts.fork.forkDb} is behind upstream ${opts.upstream.owner}/${opts.upstream.db}. ` +
      `DoltHub's API doesn't support a programmatic fork-sync, so you'll need to sync manually before this mutation can proceed. ` +
      `Visit ${syncUrl} and open a pull request from ${opts.upstream.owner}/${opts.upstream.db}:main into your fork's main, then merge it. ` +
      `After the sync lands, retry this action.`,
    'precondition'
  );
}