Function handRefsCheck

packages/plugins/apps/src/git-client/hand.ts:95–135

(
  url: string,
  ref?: string,
  opts: { token?: string; fetchImpl?: typeof fetch; allowPrivateHosts?: boolean } = {},
)

// refs-only cheap check
export async function handRefsCheck(
  url: string,
  ref?: string,
  opts: { token?: string; fetchImpl?: typeof fetch; allowPrivateHosts?: boolean } = {},
): Promise<{
  ok: boolean;
  refCount?: number;
  headSha?: string;
  head?: string;
  sha?: string;
  resolvedRef?: string;
  wallMs?: number;
  error?: string;
}> {
  const t0 = Date.now();
  try {
    const host = new URL(url).host;
    const auth = authForHost(host, opts.token);
    const refs = await checkRefs(url, auth, opts.fetchImpl, {
      allowPrivateHosts: opts.allowPrivateHosts,
    });
    const head = refs.adv.headTarget;
    const headSha = head ? refs.adv.refs.get(head) : refs.adv.refs.get("HEAD");
    const wanted = resolveWant(refs.adv, ref);
    return {
      ok: true,
      refCount: refs.adv.refs.size,
      head,
      headSha,
      sha: wanted.sha,
      resolvedRef: wanted.resolvedRef,
      wallMs: Date.now() - t0,
    };
  } catch (e) {
    return {
      ok: false,
      error: String(e instanceof Error ? e.message : e),
      wallMs: Date.now() - t0,
    };
  }
}