// Types for embed-debt-push.js — hand-written, same reason as kaito-push.d.ts: this is OUR module
// and its result rides into the publish response (`embedDebtSnapshotNotRecorded`), so a caller that
// mistakes "skipped" for "pushed" reports a snapshot as recorded when it is not.

/** `verifySite`'s own `summary.embedDebt` shape (src/embed-debt.js `siteEmbedDebt`) — passed
 *  through verbatim, never re-derived here. */
export interface EmbedDebtSummary {
  pages: number;
  embeds: number;
  withScript: number;
  contentOnly: number;
  chars: number;
  top: Array<{ rel: string; embeds: number; chars: number; contentOnly: number }>;
}

export interface EmbedDebtPushOptions {
  base?: string;
  secret?: string;
  at?: number;
  fetchFn?: typeof fetch;
}

export type EmbedDebtPushResult =
  | { pushed: true }
  | { pushed: false; reason: string; detail?: string };

export function pushEmbedDebtSnapshot(
  site: { key: string },
  embedDebt: unknown,
  opts?: EmbedDebtPushOptions,
): Promise<EmbedDebtPushResult>;