import { QueryRecorder } from "./database/instrumentation.mjs";
import { t as DeferredTaskTracker } from "./deferred-tasks-DfqxH5Xf.mjs";

//#region src/request-context.d.ts
/**
 * Lightweight always-on counters surfaced in Server-Timing.
 *
 * Bumped by the Kysely log hook (db queries) and by `requestCached`
 * (cache hits/misses). Read by middleware after the response is
 * generated to emit `db.*` and `cache.*` Server-Timing fields.
 *
 * Offsets are milliseconds from `start` (the request's entry into
 * middleware), captured via `performance.now()`.
 */
interface RequestMetrics {
  start: number;
  dbCount: number;
  dbTotalMs: number;
  dbFirstOffset: number | null;
  dbLastOffset: number | null;
  cacheHits: number;
  cacheMisses: number;
  /**
   * Physical database round trips. Differs from `dbCount` (logical queries)
   * when a backend batches: the DO SQL driver coalesces same-turn SELECTs into
   * one RPC, so `rpcCount` can be far lower than `dbCount`. Bumped by the
   * adapter, not the Kysely log hook.
   */
  rpcCount: number;
}
declare function createRequestMetrics(start: number): RequestMetrics;
interface EmDashRequestContext {
  /** Whether the current request is in visual editing mode */
  editMode: boolean;
  /** Preview token info, if this is a preview request */
  preview?: {
    collection: string;
    id: string;
  };
  /** Current locale from Astro's i18n routing (when configured) */
  locale?: string;
  /**
   * Per-request database override.
   *
   * Set by middleware when D1 read replica sessions are enabled.
   * The runtime's `db` getter checks this first, falling back to
   * the singleton instance. Also used by the DO preview pattern.
   */
  db?: unknown;
  /**
   * Indicates the per-request `db` points at an isolated database
   * instance whose schema may diverge from the configured one
   * (playground, DO preview sessions). When true, schema-derived caches
   * (manifest, taxonomy defs, etc.) must not be reused across requests.
   *
   * Plain D1 Sessions API routing does NOT set this — sessions are just
   * a routing hint over the same schema, so the module-scoped manifest
   * cache remains valid.
   */
  dbIsIsolated?: boolean;
  /**
   * Query recorder attached by middleware when EMDASH_QUERY_LOG_FILE is set.
   * The Kysely `log` hook appends an event per query; middleware flushes
   * to NDJSON after the response.
   */
  queryRecorder?: QueryRecorder;
  /**
   * Per-request metrics for Server-Timing. Always attached by middleware
   * for requests that emit timing headers; bumped by the Kysely log hook
   * and `requestCached`.
   */
  metrics?: RequestMetrics;
  /** Deferred work that owns resources scoped to this request. */
  deferredTasks?: DeferredTaskTracker;
}
/**
 * Run a function within an EmDash request context.
 * Called by middleware to wrap next().
 */
declare function runWithContext<T>(ctx: EmDashRequestContext, fn: () => T): T;
/**
 * Get the current request context.
 * Returns undefined if no context is set (logged-out fast path).
 */
declare function getRequestContext(): EmDashRequestContext | undefined;
//#endregion
export { EmDashRequestContext, RequestMetrics, createRequestMetrics, getRequestContext, runWithContext };
//# sourceMappingURL=request-context.d.mts.map