/**
 * Parse a `Cookie` header into a record.
 *
 * Was copy-pasted into both servers; identical in both, which is the mild case
 * of the same problem this module exists to fix.
 */
export declare function parseCookieHeader(header: string | null | undefined): Record<string, string>;
/**
 * Build the object both servers publish as `globalThis.requestContext`.
 *
 * `read` is called per access rather than captured, because the snapshot is
 * replaced between requests — capturing it would pin the first request's
 * cookies onto every later one.
 */
export declare function createRequestContext(read: () => RequestContextSnapshot | undefined): StacksRequestContext;
/**
 * Install the context as the `requestContext` global and return it.
 *
 * Both servers call exactly this, so neither can publish a differently-shaped
 * object by accident.
 */
export declare function installRequestContext(read: () => RequestContextSnapshot | undefined): StacksRequestContext;
/**
 * The single accessor (#2232 ask 4), for callers who would rather have one
 * object than reach for ambient globals.
 *
 * Always returns something: with no request in flight every field is its empty
 * value, so a standalone or SSG render reads `useRequestEvent().query.site` and
 * gets `undefined` instead of a ReferenceError.
 */
export declare function useRequestEvent(): {
  url: string
  path: string
  search: string
  query: Record<string, string>
  cookies: Record<string, string>
  params: Record<string, string>
  locale: string
  ip: string
  host: string
  site: SiteSnapshot | null
};
/**
 * One request object for `<script server>` blocks (stacksjs/stacks#2232).
 *
 * `requestContext` was installed twice — once by the dev views server, once by
 * the production server — with two different backings, two different sets of
 * methods, and no shared type. Both installers were `(globalThis as any)`, so
 * nothing could catch a divergence. Two already shipped:
 *
 *   - production's `url()` returned only the query string, so a page doing
 *     `new URL(requestContext.url())` worked in dev and threw on the box
 *   - production had no `locale()` at all, so a page that branched on locale
 *     threw "requestContext.locale is not a function" on the box
 *
 * Both were found by an end-to-end test, not by inspection, because there was
 * nothing to inspect against.
 *
 * A shared TYPE would only have made those detectable. A shared FACTORY makes
 * them impossible: each server supplies a snapshot reader and gets the same
 * object built the same way. The only thing a server still chooses is where
 * the snapshot comes from, which is the one thing that genuinely differs (dev
 * has AsyncLocalStorage available; production established it does not survive
 * into stx-serve's render).
 *
 * Home of convenience: `@stacksjs/config` is the only package both the dev
 * server (`@stacksjs/actions`) and the production server (`@stacksjs/buddy`)
 * already depend on. It is not conceptually config, and moving it later is a
 * re-export away.
 */
/**
 * What a server knows about the request in flight.
 *
 * Every field optional: a snapshot is assembled by whichever server booted, an
 * older stx may not populate all of them, and a standalone or SSG render has no
 * request at all. Readers below supply a shaped empty value rather than
 * throwing, so a page never needs `typeof requestContext !== 'undefined'`.
 */
export declare interface RequestContextSnapshot {
  cookies?: Record<string, string>
  url?: string
  path?: string
  search?: string
  locale?: string | null
  params?: Record<string, string>
  ip?: string
  host?: string
  site?: SiteSnapshot | null
}
/**
 * The site a multi-site server resolved for this request's Host header.
 *
 * Carried on the snapshot rather than AsyncLocalStorage because ALS does not
 * survive into stx-serve's render (see the module comment): a `<script server>`
 * block that asked an ALS-backed `currentSite()` would silently get undefined.
 * The resolving server (`@stacksjs/sites` middleware / onRequest hook) stashes
 * it here; pages read `requestContext.site()`.
 */
export declare interface SiteSnapshot {
  id: number
  uuid?: string
  name?: string
  subdomain?: string
  settings?: Record<string, unknown>
}
/** What a `<script server>` block sees as `requestContext`. */
export declare interface StacksRequestContext {
  cookie: (name: string) => string | null
  cookies: () => Record<string, string>
  url: () => string
  path: () => string
  search: () => string
  query: () => Record<string, string>
  params: () => Record<string, string>
  locale: () => string
  ip: () => string
  host: () => string
  site: () => SiteSnapshot | null
}