@crvouga/mockingbird-service-junction 0.1.0 → 0.1.2

package/README.md

@@ -23,9 +23,8 @@ npm install -D @crvouga/mockingbird-service-junction
 ```
 
 ESM only. Requires Node >= 22 or Bun >= 1.2. No native dependencies: state lives in an in-memory
-SQLite engine (`@crvouga/mockingbird-service-sqlite`, pure TypeScript). To serve it over HTTP also
-install `@crvouga/mockingbird-adapter-node` (works under Node and Bun) or
-`@crvouga/mockingbird-adapter-bun`.
+SQLite engine (pure TypeScript, bundled in). To serve it over HTTP use `Bun.serve` under Bun, or
+install `@hono/node-server` under Node.
 
 ## Usage
 
@@ -99,21 +98,34 @@ delayed transition is applied on the next `GET /v3/order/{id}` whose `now` is pa
 ### Over HTTP
 
 ```ts
-import { serve } from "@crvouga/mockingbird-adapter-node"
 import { JunctionAPI } from "@crvouga/mockingbird-service-junction"
 
 const junction = new JunctionAPI()
-const server = await serve(junction, { port: 0, host: "127.0.0.1" }) // port 0 = ephemeral
-const address = server.address()
-if (address === null || typeof address === "string") throw new Error("not listening")
-const baseUrl = `http://127.0.0.1:${address.port}`
+const server = Bun.serve({
+  port: 0, // ephemeral
+  hostname: "127.0.0.1",
+  fetch: (request) => junction.fetch(request),
+})
+const baseUrl = `http://127.0.0.1:${server.port}`
 
 const response = await fetch(`${baseUrl}/v2/user`, {
   headers: { "x-vital-api-key": "sk_us_mockingbird" },
 })
 console.log(response.status) // 200
 
-server.close()
+server.stop()
+```
+
+On Node use any Fetch-style server, e.g. `@hono/node-server` (`npm install -D @hono/node-server`),
+whose callback receives the bound port:
+
+```js
+import { serve } from "@hono/node-server"
+const server = serve(
+  { fetch: (request) => junction.fetch(request), port: 0, hostname: "127.0.0.1" },
+  (info) => console.log(`http://127.0.0.1:${info.port}`),
+)
+// ... later: server.close()
 ```
 
 ### Pointing `@tryvital/vital-node` at it
@@ -217,7 +229,7 @@ it always comes from the deterministic generator.
 
 | Export | Description |
 | --- | --- |
-| `JunctionAPI` | Class. `new JunctionAPI(options?)`; implements `FetchAPI` (`fetch(request: Request): Promise<Response>`). |
+| `JunctionAPI` | Class. `new JunctionAPI(options?)`; implements the Fetch contract `fetch(request: Request): Promise<Response>`. |
 | `JUNCTION_NAMESPACE` | `"junction"` — SQLite namespace holding the mock's state when sharing a `sqlite` client. |
 | `document` | The vendored Junction OpenAPI document (Mockingbird subset) that drives routing. |
 | `operationIds` | Every `operationId` in `document`. |
@@ -316,4 +328,4 @@ Webhook parity needs a public receiver; see
 [docs/webhook-parity.md](https://github.com/crvouga/mockingbird/blob/main/packages/service/junction/docs/webhook-parity.md).
 The `client-parity*.ts` SDK scenarios are deprecated as proof and kept only as manual probes.
 
-Part of [mockingbird](https://github.com/crvouga/mockingbird) — agent integration guide: [`@crvouga/mockingbird`](https://github.com/crvouga/mockingbird/tree/main/packages/facade#readme).
+Part of [mockingbird](https://github.com/crvouga/mockingbird) — agent integration guide: [README](https://github.com/crvouga/mockingbird#readme) · [llms.txt](https://github.com/crvouga/mockingbird/blob/main/llms.txt).

package/dist/index.d.ts

@@ -1,31 +1,500 @@
-import type { FetchAPI } from "@crvouga/mockingbird-core";
-import { type APIOptions } from "@crvouga/mockingbird-service";
-import type { SqliteClient } from "@crvouga/mockingbird-sqlite";
-import type { Hono } from "hono";
-import type { SealedCorpus } from "./sealed-corpus.js";
-import { type SeedObservations, type SeedReport, type SeedSource } from "./seed-from.js";
-import { type JunctionWebhookEvent, type JunctionWebhookOptions, type WebhookPublisher } from "./state.js";
-export { COVERAGE_ZIPS, PHLEBOTOMY_AVAILABILITY_ZIPS, PSC_AVAILABILITY_ZIPS, PSC_LAB_IDS, } from "./coverage-corpus.js";
-export type { OperationId, SupportedOperationId } from "./generated/openapi.js";
-export { document, operationIds, supportedOperationIds } from "./generated/openapi.js";
-export { prefetchCoverageObservations } from "./prefetch.js";
-export { AVAILABILITY_ADDRESS, AVAILABILITY_START_DATE, reshapeCoverageGeoCommand, } from "./reshape.js";
-export { parseSealedCorpus, SEALED_CORPUS_VERSION, type SealedCorpus, } from "./sealed-corpus.js";
-export type { SeedObservations, SeedReport, SeedSource } from "./seed-from.js";
-export type { GetCacheEntry, JunctionWebhookEvent, JunctionWebhookOptions, WebhookPublisher, } from "./state.js";
-export { observationCacheKey } from "./state.js";
-export declare const JUNCTION_NAMESPACE = "junction";
+import { Hono } from 'hono';
+
+/** Bind values accepted by Mockingbird's SQLite port (matches sqlite-mem / better-sqlite3). */
+type SqliteValue$1 = null | number | bigint | string | Uint8Array | boolean;
+/** Mutation counters returned by {@link SqliteStatement.run}. */
+type SqliteRunResult$1 = {
+    changes: number;
+    lastInsertRowid: number | bigint;
+};
+/**
+ * Prepared statement bound to a {@link SqliteClient}.
+ *
+ * Pass bind values as rest arguments on each call (no sticky `bind()`).
+ */
+interface SqliteStatement$1 {
+    run(...params: SqliteValue$1[]): SqliteRunResult$1;
+    all<T = Record<string, unknown>>(...params: SqliteValue$1[]): T[];
+    get<T = Record<string, unknown>>(...params: SqliteValue$1[]): T | undefined;
+}
+/**
+ * Sync SQLite client port owned by Mockingbird.
+ *
+ * Duck-typed so `@crvouga/mockingbird-service-sqlite` `Database`, better-sqlite3, and wrapped
+ * `bun:sqlite` instances all work when they expose this surface.
+ */
+interface SqliteClient$1 {
+    exec(sql: string): void;
+    prepare(sql: string): SqliteStatement$1;
+    transaction<T>(fn: () => T): T;
+}
+
+/** Options every provider constructor accepts. */
+type APIOptions = {
+    /** Sync SQLite client. Defaults to `@crvouga/mockingbird-service-sqlite`. */
+    sqlite?: SqliteClient$1;
+    /** Clock used for `created`-style fields. Default `Date.now`. */
+    now?: () => number;
+};
+
+/** Bind values accepted by Mockingbird's SQLite port (matches sqlite-mem / better-sqlite3). */
+type SqliteValue = null | number | bigint | string | Uint8Array | boolean;
+/** Mutation counters returned by {@link SqliteStatement.run}. */
+type SqliteRunResult = {
+    changes: number;
+    lastInsertRowid: number | bigint;
+};
+/**
+ * Prepared statement bound to a {@link SqliteClient}.
+ *
+ * Pass bind values as rest arguments on each call (no sticky `bind()`).
+ */
+interface SqliteStatement {
+    run(...params: SqliteValue[]): SqliteRunResult;
+    all<T = Record<string, unknown>>(...params: SqliteValue[]): T[];
+    get<T = Record<string, unknown>>(...params: SqliteValue[]): T | undefined;
+}
+/**
+ * Sync SQLite client port owned by Mockingbird.
+ *
+ * Duck-typed so `@crvouga/mockingbird-service-sqlite` `Database`, better-sqlite3, and wrapped
+ * `bun:sqlite` instances all work when they expose this surface.
+ */
+interface SqliteClient {
+    exec(sql: string): void;
+    prepare(sql: string): SqliteStatement;
+    transaction<T>(fn: () => T): T;
+}
+
+/** Lab-test catalog mirrored from the Junction sandbox (`GET /v3/lab_test`). */
+type CatalogMarker = {
+    id: number;
+    name: string;
+    slug: string;
+    description: string | null;
+    lab_id: number | null;
+    provider_id: string | null;
+    type: string | null;
+    unit: string | null;
+    price: string | null;
+    aoe: unknown;
+    a_la_carte_enabled: boolean;
+    common_tat_days: number | null;
+    worst_case_tat_days: number | null;
+    is_orderable: boolean | null;
+};
+type ExpectedResultLoinc = {
+    id: number;
+    name: string;
+    slug: string;
+    code: string;
+    unit: string | null;
+};
+type ExpectedResult = {
+    id: number;
+    name: string;
+    slug: string;
+    lab_id: number | null;
+    provider_id: string | null;
+    required: boolean;
+    loinc: ExpectedResultLoinc | null;
+};
+type LabTestRecord = {
+    id: string;
+    slug: string;
+    name: string;
+    sample_type: string;
+    method: string;
+    price: number;
+    is_active: boolean;
+    status: string;
+    fasting: boolean;
+    lab: Record<string, unknown>;
+    markers: CatalogMarker[] | null;
+    is_delegated: boolean;
+    auto_generated: boolean;
+    has_collection_instructions: boolean | null;
+    common_tat_days: number | null;
+    worst_case_tat_days: number | null;
+};
+
+type GetCacheEntry = {
+    status: number;
+    headers: Record<string, string>;
+    body: unknown;
+};
+declare const observationCacheKey: (url: URL | string, method?: string, body?: unknown) => string;
+type JunctionWebhookEvent = {
+    event_type: "labtest.order.created" | "labtest.order.updated" | "labtest.appointment.updated";
+    data: Record<string, unknown>;
+    team_id: string;
+    user_id: string;
+    client_user_id: string;
+};
+type WebhookDeliveryAttempt = {
+    message_id: string;
+    event: JunctionWebhookEvent;
+    attempt: number;
+    scheduled_at: string;
+    timeout_ms: number;
+    acknowledged: boolean;
+};
+type WebhookPublisher = (event: JunctionWebhookEvent) => void;
+type JunctionWebhookOptions = {
+    seed?: number;
+    jitterRatio?: number;
+    timeoutMs?: number;
+};
+
+/**
+ * Anything that can answer a Fetch `Request` with a `Response`.
+ *
+ * Every Mockingbird service implements this, and every runtime adapter consumes it.
+ * It is the only contract shared across the whole graph.
+ */
+interface FetchAPI {
+    fetch(request: Request): Promise<Response>;
+}
+
+/**
+ * Version of the sealed-corpus on-disk format. Bumped whenever the shape changes so a
+ * stale recording is rejected instead of half-applied.
+ */
+declare const SEALED_CORPUS_VERSION = 1;
+/**
+ * Exact sandbox recording of the provider-owned reads a drop-in consumer depends on:
+ * parameter-stable GET observations (area/PSC inventory), the lab catalog, team labs, and
+ * lab accounts. Availability is intentionally absent — its slot dates and single-use
+ * `booking_key`s can never match a live cache key, so it stays with the generator.
+ */
+type SealedCorpus = {
+    version: typeof SEALED_CORPUS_VERSION;
+    recordedAt: string;
+    source: string;
+    observations: Record<string, GetCacheEntry>;
+    catalog: {
+        labTests: LabTestRecord[];
+        labs: Record<string, unknown>[];
+        expectedResults: Record<string, ExpectedResult[]>;
+    };
+    labAccounts: Record<string, unknown>[];
+};
+/** Throws on a non-object or an unrecognized `version`. */
+declare const parseSealedCorpus: (value: unknown) => SealedCorpus;
+
+type SeedSource = {
+    fetch: (request: Request) => Promise<Response>;
+    baseUrl: string;
+    headers: Record<string, string>;
+};
+type SeedObservations = {
+    getCache?: ReadonlyMap<string, GetCacheEntry>;
+};
+type SeedReport = {
+    users: number;
+    orders: number;
+    appointments: number;
+    catalogTests: number;
+    labs: number;
+    cacheEntries: number;
+};
+
+/** High-signal ZIPs for availability prefetch (full routing corpus still used for area/psc). */
+declare const PSC_AVAILABILITY_ZIPS: readonly ["85004", "85234", "11050", "10006", "90012", "96101", "92101", "60601", "33130", "98104", "75034", "07030"];
+/**
+ * Phlebotomy availability is only served for a narrow Vital sandbox set.
+ * Probed: 85004 works; broader scheduling zips often 400. Keep prefetch/reshape sealed.
+ */
+declare const PHLEBOTOMY_AVAILABILITY_ZIPS: readonly ["85004"];
+/**
+ * Curated real ZIPs used as this package's parity coverage corpus (one per US state plus DC,
+ * plus scheduling pins). Prefetched into the observation cache so area/PSC parity is sealed
+ * for those geos.
+ */
+declare const COVERAGE_ZIPS: readonly ["02108", "02903", "03101", "04101", "05401", "06103", "07030", "11050", "17316", "19107", "19801", "20001", "21201", "23219", "25301", "28202", "29201", "30303", "33130", "35203", "37219", "39201", "40202", "43215", "46204", "47630", "48226", "50309", "53202", "54977", "55415", "57104", "58102", "59101", "60601", "64106", "67202", "68102", "70112", "72201", "73102", "75034", "77002", "80202", "82001", "83702", "84111", "85004", "85234", "87102", "89101", "90012", "96101", "96813", "97204", "98104", "99501"];
+/** Lab ids exercised by walk-in / PSC parity flows (quest, labcorp, bioreference, sonora). */
+declare const PSC_LAB_IDS: readonly [4, 6, 13, 25];
+
+/**
+ * The slice of OpenAPI 3.1 (and JSON Schema 2020-12) Mockingbird understands.
+ * Unknown keys (including `x-*` extensions) are preserved on every object.
+ */
+type JsonPrimitive = string | number | boolean | null;
+type JsonValue = JsonPrimitive | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+type ReferenceObject = {
+    $ref: string;
+    description?: string;
+    summary?: string;
+};
+type SchemaType = "string" | "number" | "integer" | "boolean" | "object" | "array" | "null";
+type SchemaObject = {
+    $ref?: string;
+    type?: SchemaType | SchemaType[];
+    title?: string;
+    description?: string;
+    format?: string;
+    enum?: JsonValue[];
+    const?: JsonValue;
+    default?: JsonValue;
+    example?: JsonValue;
+    examples?: JsonValue[];
+    nullable?: boolean;
+    deprecated?: boolean;
+    readOnly?: boolean;
+    writeOnly?: boolean;
+    minimum?: number;
+    maximum?: number;
+    exclusiveMinimum?: number;
+    exclusiveMaximum?: number;
+    multipleOf?: number;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    minItems?: number;
+    maxItems?: number;
+    uniqueItems?: boolean;
+    items?: SchemaObject;
+    prefixItems?: SchemaObject[];
+    minProperties?: number;
+    maxProperties?: number;
+    required?: string[];
+    properties?: Record<string, SchemaObject>;
+    additionalProperties?: boolean | SchemaObject;
+    propertyNames?: SchemaObject;
+    oneOf?: SchemaObject[];
+    anyOf?: SchemaObject[];
+    allOf?: SchemaObject[];
+    not?: SchemaObject;
+    discriminator?: {
+        propertyName: string;
+        mapping?: Record<string, string>;
+    };
+    [extension: `x-${string}`]: unknown;
+};
+type ParameterLocation = "path" | "query" | "header" | "cookie";
+type ParameterObject = {
+    name: string;
+    in: ParameterLocation;
+    description?: string;
+    required?: boolean;
+    deprecated?: boolean;
+    style?: string;
+    explode?: boolean;
+    schema?: SchemaObject;
+    content?: Record<string, MediaTypeObject>;
+    example?: JsonValue;
+    [extension: `x-${string}`]: unknown;
+};
+type MediaTypeObject = {
+    schema?: SchemaObject;
+    example?: JsonValue;
+    examples?: Record<string, unknown>;
+    encoding?: Record<string, unknown>;
+    [extension: `x-${string}`]: unknown;
+};
+type RequestBodyObject = {
+    description?: string;
+    required?: boolean;
+    content: Record<string, MediaTypeObject>;
+    [extension: `x-${string}`]: unknown;
+};
+type HeaderObject = {
+    description?: string;
+    required?: boolean;
+    schema?: SchemaObject;
+    [extension: `x-${string}`]: unknown;
+};
+type ResponseObject = {
+    description: string;
+    headers?: Record<string, HeaderObject | ReferenceObject>;
+    content?: Record<string, MediaTypeObject>;
+    [extension: `x-${string}`]: unknown;
+};
+type ResponsesObject = Record<string, ResponseObject | ReferenceObject>;
+type SecurityRequirementObject = Record<string, string[]>;
+type OperationObject = {
+    operationId?: string;
+    summary?: string;
+    description?: string;
+    tags?: string[];
+    deprecated?: boolean;
+    parameters?: Array<ParameterObject | ReferenceObject>;
+    requestBody?: RequestBodyObject | ReferenceObject;
+    responses: ResponsesObject;
+    security?: SecurityRequirementObject[];
+    [extension: `x-${string}`]: unknown;
+};
+declare const HTTP_METHODS: readonly ["get", "put", "post", "delete", "options", "head", "patch", "trace"];
+type HttpMethod = (typeof HTTP_METHODS)[number];
+type PathItemObject = {
+    summary?: string;
+    description?: string;
+    parameters?: Array<ParameterObject | ReferenceObject>;
+    [extension: `x-${string}`]: unknown;
+} & Partial<Record<HttpMethod, OperationObject>>;
+type SecuritySchemeObject = {
+    type: "apiKey" | "http" | "oauth2" | "openIdConnect" | "mutualTLS";
+    description?: string;
+    name?: string;
+    in?: ParameterLocation;
+    scheme?: string;
+    bearerFormat?: string;
+    flows?: Record<string, unknown>;
+    openIdConnectUrl?: string;
+    [extension: `x-${string}`]: unknown;
+};
+type ComponentsObject = {
+    schemas?: Record<string, SchemaObject>;
+    responses?: Record<string, ResponseObject>;
+    parameters?: Record<string, ParameterObject>;
+    requestBodies?: Record<string, RequestBodyObject>;
+    headers?: Record<string, HeaderObject>;
+    securitySchemes?: Record<string, SecuritySchemeObject>;
+    [extension: `x-${string}`]: unknown;
+};
+type ServerObject = {
+    url: string;
+    description?: string;
+    variables?: Record<string, unknown>;
+    [extension: `x-${string}`]: unknown;
+};
+type InfoObject = {
+    title: string;
+    version: string;
+    description?: string;
+    [extension: `x-${string}`]: unknown;
+};
+type OpenAPIDocument = {
+    openapi: string;
+    info: InfoObject;
+    servers?: ServerObject[];
+    paths: Record<string, PathItemObject>;
+    components?: ComponentsObject;
+    security?: SecurityRequirementObject[];
+    tags?: Array<{
+        name: string;
+        description?: string;
+    }>;
+    [extension: `x-${string}`]: unknown;
+};
+
+declare const document: OpenAPIDocument;
+type OperationId = "get_teams_users_v2_user_get" | "create_user_v2_user_post" | "get_user_v2_user__user_id__get" | "delete_user_v2_user__user_id__delete" | "patch_user_v2_user__user_id__patch" | "get_user_by_client_user_id_v2_user_resolve__client_user_id__get" | "patch_user_info_v2_user__user_id__info_patch" | "get_latest_user_info_user_v2_user__user_id__info_latest_get" | "get_paginated_lab_tests_for_team_v3_lab_test_get" | "get_team_lab_accounts_v3_lab_test_lab_account_get" | "get_lab_test_for_team_v3_lab_tests__lab_test_id__get" | "get_labs_v3_lab_tests_labs_get" | "get_markers_for_lab_test_v3_lab_tests__lab_test_id__markers_get" | "list_order_set_markers_v3_lab_tests_list_order_set_markers_post" | "create_order_v3_order_post" | "get_area_info_v3_order_area_info_get" | "get_psc_info_v3_order_psc_info_get" | "get_phlebotomy_appointment_availability_v3_order_phlebotomy_appointment_availability_post" | "get_phlebotomy_appointment_cancellation_reason_v3_order_phlebotomy_appointment_cancellation_reasons_get" | "get_psc_appointment_availability_v3_order_psc_appointment_availability_post" | "get_psc_appointment_cancellation_reason_v3_order_psc_appointment_cancellation_reasons_get" | "get_phlebotomy_appointment_v3_order__order_id__phlebotomy_appointment_get" | "book_phlebotomy_appointment_v3_order__order_id__phlebotomy_appointment_book_post" | "reschedule_phlebotomy_appointment_v3_order__order_id__phlebotomy_appointment_reschedule_patch" | "cancel_phlebotomy_appointment_v3_order__order_id__phlebotomy_appointment_cancel_patch" | "get_psc_appointment_v3_order__order_id__psc_appointment_get" | "book_psc_appointment_v3_order__order_id__psc_appointment_book_post" | "reschedule_psc_appointment_v3_order__order_id__psc_appointment_reschedule_patch" | "cancel_psc_appointment_v3_order__order_id__psc_appointment_cancel_patch" | "get_order_v3_order__order_id__get" | "cancel_order_v3_order__order_id__cancel_post" | "simulate_order_v3_order__order_id__test_post" | "get_result_raw_v3_order__order_id__result_get" | "get_result_metadata_v3_order__order_id__result_metadata_get" | "get_result_pdf_v3_order__order_id__result_pdf_get" | "get_order_requisition_pdf_v3_order__order_id__requisition_pdf_get" | "get_orders_v3_orders_get" | "get_order_transaction_v3_order_transaction__transaction_id__get" | "get_order_transaction_result_v3_order_transaction__transaction_id__result_get";
+type SupportedOperationId = "get_teams_users_v2_user_get" | "create_user_v2_user_post" | "get_user_v2_user__user_id__get" | "delete_user_v2_user__user_id__delete" | "patch_user_v2_user__user_id__patch" | "get_user_by_client_user_id_v2_user_resolve__client_user_id__get" | "patch_user_info_v2_user__user_id__info_patch" | "get_latest_user_info_user_v2_user__user_id__info_latest_get" | "get_paginated_lab_tests_for_team_v3_lab_test_get" | "get_team_lab_accounts_v3_lab_test_lab_account_get" | "get_lab_test_for_team_v3_lab_tests__lab_test_id__get" | "get_labs_v3_lab_tests_labs_get" | "get_markers_for_lab_test_v3_lab_tests__lab_test_id__markers_get" | "list_order_set_markers_v3_lab_tests_list_order_set_markers_post" | "create_order_v3_order_post" | "get_area_info_v3_order_area_info_get" | "get_psc_info_v3_order_psc_info_get" | "get_phlebotomy_appointment_availability_v3_order_phlebotomy_appointment_availability_post" | "get_phlebotomy_appointment_cancellation_reason_v3_order_phlebotomy_appointment_cancellation_reasons_get" | "get_psc_appointment_availability_v3_order_psc_appointment_availability_post" | "get_psc_appointment_cancellation_reason_v3_order_psc_appointment_cancellation_reasons_get" | "get_phlebotomy_appointment_v3_order__order_id__phlebotomy_appointment_get" | "book_phlebotomy_appointment_v3_order__order_id__phlebotomy_appointment_book_post" | "reschedule_phlebotomy_appointment_v3_order__order_id__phlebotomy_appointment_reschedule_patch" | "cancel_phlebotomy_appointment_v3_order__order_id__phlebotomy_appointment_cancel_patch" | "get_psc_appointment_v3_order__order_id__psc_appointment_get" | "book_psc_appointment_v3_order__order_id__psc_appointment_book_post" | "reschedule_psc_appointment_v3_order__order_id__psc_appointment_reschedule_patch" | "cancel_psc_appointment_v3_order__order_id__psc_appointment_cancel_patch" | "get_order_v3_order__order_id__get" | "cancel_order_v3_order__order_id__cancel_post" | "simulate_order_v3_order__order_id__test_post" | "get_result_raw_v3_order__order_id__result_get" | "get_result_metadata_v3_order__order_id__result_metadata_get" | "get_result_pdf_v3_order__order_id__result_pdf_get" | "get_order_requisition_pdf_v3_order__order_id__requisition_pdf_get" | "get_orders_v3_orders_get" | "get_order_transaction_v3_order_transaction__transaction_id__get" | "get_order_transaction_result_v3_order_transaction__transaction_id__result_get";
+declare const operationIds: readonly ["get_teams_users_v2_user_get", "create_user_v2_user_post", "get_user_v2_user__user_id__get", "delete_user_v2_user__user_id__delete", "patch_user_v2_user__user_id__patch", "get_user_by_client_user_id_v2_user_resolve__client_user_id__get", "patch_user_info_v2_user__user_id__info_patch", "get_latest_user_info_user_v2_user__user_id__info_latest_get", "get_paginated_lab_tests_for_team_v3_lab_test_get", "get_team_lab_accounts_v3_lab_test_lab_account_get", "get_lab_test_for_team_v3_lab_tests__lab_test_id__get", "get_labs_v3_lab_tests_labs_get", "get_markers_for_lab_test_v3_lab_tests__lab_test_id__markers_get", "list_order_set_markers_v3_lab_tests_list_order_set_markers_post", "create_order_v3_order_post", "get_area_info_v3_order_area_info_get", "get_psc_info_v3_order_psc_info_get", "get_phlebotomy_appointment_availability_v3_order_phlebotomy_appointment_availability_post", "get_phlebotomy_appointment_cancellation_reason_v3_order_phlebotomy_appointment_cancellation_reasons_get", "get_psc_appointment_availability_v3_order_psc_appointment_availability_post", "get_psc_appointment_cancellation_reason_v3_order_psc_appointment_cancellation_reasons_get", "get_phlebotomy_appointment_v3_order__order_id__phlebotomy_appointment_get", "book_phlebotomy_appointment_v3_order__order_id__phlebotomy_appointment_book_post", "reschedule_phlebotomy_appointment_v3_order__order_id__phlebotomy_appointment_reschedule_patch", "cancel_phlebotomy_appointment_v3_order__order_id__phlebotomy_appointment_cancel_patch", "get_psc_appointment_v3_order__order_id__psc_appointment_get", "book_psc_appointment_v3_order__order_id__psc_appointment_book_post", "reschedule_psc_appointment_v3_order__order_id__psc_appointment_reschedule_patch", "cancel_psc_appointment_v3_order__order_id__psc_appointment_cancel_patch", "get_order_v3_order__order_id__get", "cancel_order_v3_order__order_id__cancel_post", "simulate_order_v3_order__order_id__test_post", "get_result_raw_v3_order__order_id__result_get", "get_result_metadata_v3_order__order_id__result_metadata_get", "get_result_pdf_v3_order__order_id__result_pdf_get", "get_order_requisition_pdf_v3_order__order_id__requisition_pdf_get", "get_orders_v3_orders_get", "get_order_transaction_v3_order_transaction__transaction_id__get", "get_order_transaction_result_v3_order_transaction__transaction_id__result_get"];
+declare const supportedOperationIds: readonly ["get_teams_users_v2_user_get", "create_user_v2_user_post", "get_user_v2_user__user_id__get", "delete_user_v2_user__user_id__delete", "patch_user_v2_user__user_id__patch", "get_user_by_client_user_id_v2_user_resolve__client_user_id__get", "patch_user_info_v2_user__user_id__info_patch", "get_latest_user_info_user_v2_user__user_id__info_latest_get", "get_paginated_lab_tests_for_team_v3_lab_test_get", "get_team_lab_accounts_v3_lab_test_lab_account_get", "get_lab_test_for_team_v3_lab_tests__lab_test_id__get", "get_labs_v3_lab_tests_labs_get", "get_markers_for_lab_test_v3_lab_tests__lab_test_id__markers_get", "list_order_set_markers_v3_lab_tests_list_order_set_markers_post", "create_order_v3_order_post", "get_area_info_v3_order_area_info_get", "get_psc_info_v3_order_psc_info_get", "get_phlebotomy_appointment_availability_v3_order_phlebotomy_appointment_availability_post", "get_phlebotomy_appointment_cancellation_reason_v3_order_phlebotomy_appointment_cancellation_reasons_get", "get_psc_appointment_availability_v3_order_psc_appointment_availability_post", "get_psc_appointment_cancellation_reason_v3_order_psc_appointment_cancellation_reasons_get", "get_phlebotomy_appointment_v3_order__order_id__phlebotomy_appointment_get", "book_phlebotomy_appointment_v3_order__order_id__phlebotomy_appointment_book_post", "reschedule_phlebotomy_appointment_v3_order__order_id__phlebotomy_appointment_reschedule_patch", "cancel_phlebotomy_appointment_v3_order__order_id__phlebotomy_appointment_cancel_patch", "get_psc_appointment_v3_order__order_id__psc_appointment_get", "book_psc_appointment_v3_order__order_id__psc_appointment_book_post", "reschedule_psc_appointment_v3_order__order_id__psc_appointment_reschedule_patch", "cancel_psc_appointment_v3_order__order_id__psc_appointment_cancel_patch", "get_order_v3_order__order_id__get", "cancel_order_v3_order__order_id__cancel_post", "simulate_order_v3_order__order_id__test_post", "get_result_raw_v3_order__order_id__result_get", "get_result_metadata_v3_order__order_id__result_metadata_get", "get_result_pdf_v3_order__order_id__result_pdf_get", "get_order_requisition_pdf_v3_order__order_id__requisition_pdf_get", "get_orders_v3_orders_get", "get_order_transaction_v3_order_transaction__transaction_id__get", "get_order_transaction_result_v3_order_transaction__transaction_id__result_get"];
+
+type SeedCacheEntry = {
+    status: number;
+    headers: Record<string, string>;
+    body: unknown;
+};
+
+type PrefetchTarget = {
+    baseUrl: string;
+    fetch: (request: Request) => Promise<Response>;
+    headers: () => Promise<Record<string, string>> | Record<string, string>;
+};
+/**
+ * Seal coverage-corpus routing ZIPs + availability POSTs into the seed observation cache.
+ * Call after warmup, before `seedFrom`, so compare walks can forceInclude geo/scheduling reads.
+ */
+declare const prefetchCoverageObservations: (args: {
+    real: PrefetchTarget;
+    getCache: Map<string, SeedCacheEntry>;
+    zips?: readonly string[];
+    /** ZIPs that also get PSC availability POST seals. Defaults to scheduling corpus. */
+    schedulingZips?: readonly string[];
+    /** ZIPs for phlebotomy availability (narrow served set). Defaults to PHLEBOTOMY_ZIPS. */
+    phlebotomyZips?: readonly string[];
+    labIds?: readonly number[];
+    /** Also prefetch phlebotomy + PSC availability. Default true. */
+    includeAvailability?: boolean;
+    sleep?: (ms: number) => Promise<void>;
+    minIntervalMs?: number;
+}) => Promise<void>;
+
+type Violation = "wrong-type" | "string-too-long" | "string-too-short" | "number-too-large" | "number-too-small" | "not-in-enum" | "missing-required" | "unexpected-property" | "array-too-long" | "array-too-short" | "bad-format";
+type Mutation = {
+    /** Location of the mutated value in generated *values* (not schema keywords). */
+    valuePath: Array<string | number>;
+    violation: Violation;
+    detail: string;
+};
+
+/**
+ * One generated API call. Concrete ids never appear here: resource references are
+ * {@link Placeholder}s resolved per side at execution time, which is what lets the same command
+ * run against the real API and the mock.
+ */
+type LogicalCommand = {
+    operationId: string;
+    /** Path, query and header parameter values by name. */
+    parameters: Record<string, unknown>;
+    body: unknown;
+    mediaType: string | undefined;
+    /** Set when the body was deliberately mutated to violate its schema. */
+    invalid: Mutation | undefined;
+};
+
+/** Mutable walk state consulted by {@link DynamicWeightFn}. */
+type ExploreState = {
+    /** operationId → times exercised in this walk. */
+    coverage: Record<string, number>;
+    /** Recent operationIds (oldest → newest), typically capped. */
+    history: readonly string[];
+    /** Active resource counts by type (user, order, …). */
+    resourceCounts: Record<string, number>;
+    phase: "warmup" | "compare" | "walk";
+    step: number;
+    maxSteps: number;
+    /** Optional observed GET cache size — used to unlock geo/scheduling reads. */
+    observationCacheSize?: number;
+};
+/** Mulberry32 PRNG — deterministic from a 32-bit seed. */
+declare const createExploreRng: (seed: number) => {
+    /** Uniform float in [0, 1). */
+    next: () => number;
+    /** Uniform int in [0, max] inclusive. */
+    nextInt: (max: number) => number;
+};
+type ExploreRng = ReturnType<typeof createExploreRng>;
+
+/** Stable address fields so availability observation-cache keys match prefetch (85004). */
+declare const AVAILABILITY_ADDRESS: {
+    readonly first_line: "1 N Central Ave";
+    readonly second_line: string | null;
+    readonly city: "Phoenix";
+    readonly state: "AZ";
+    readonly unit: string | null;
+};
+/** Far-future start date so slots are always generated relative to frozen test clocks. */
+declare const AVAILABILITY_START_DATE = "2099-06-15";
+/**
+ * Pin geo / availability params onto the coverage corpus so observation-cache hits stay
+ * sealed during seedParity compare walks.
+ */
+declare const reshapeCoverageGeoCommand: (command: LogicalCommand, _state: ExploreState, rng: ExploreRng, options?: {
+    zips?: readonly string[];
+    schedulingZips?: readonly string[];
+    phlebotomyZips?: readonly string[];
+    labIds?: readonly number[];
+}) => LogicalCommand;
+
+declare const JUNCTION_NAMESPACE = "junction";
 /**
  * Stateful mock of the Junction (Vital) API user and lab-testing surfaces.
  *
  * Docs: https://docs.junction.com/
  * Auth: `x-vital-api-key` — https://docs.junction.com/api-details/junction-api
  */
-export type JunctionAPIOptions = APIOptions & {
+type JunctionAPIOptions = APIOptions & {
     onWebhook?: WebhookPublisher;
     webhook?: JunctionWebhookOptions;
 };
-export declare class JunctionAPI implements FetchAPI {
+declare class JunctionAPI implements FetchAPI {
     readonly app: Hono;
     readonly sqlite: SqliteClient;
     private readonly service;
@@ -44,6 +513,8 @@ export declare class JunctionAPI implements FetchAPI {
     ensureOrders(source: SeedSource, ids: readonly string[]): Promise<number>;
     markUserDeleted(userId: string): void;
     webhookEvents(): JunctionWebhookEvent[];
-    webhookDeliveryAttempts(): import("./state.js").WebhookDeliveryAttempt[];
+    webhookDeliveryAttempts(): WebhookDeliveryAttempt[];
 }
-//# sourceMappingURL=index.d.ts.map
+
+export { AVAILABILITY_ADDRESS, AVAILABILITY_START_DATE, COVERAGE_ZIPS, JUNCTION_NAMESPACE, JunctionAPI, PHLEBOTOMY_AVAILABILITY_ZIPS, PSC_AVAILABILITY_ZIPS, PSC_LAB_IDS, SEALED_CORPUS_VERSION, document, observationCacheKey, operationIds, parseSealedCorpus, prefetchCoverageObservations, reshapeCoverageGeoCommand, supportedOperationIds };
+export type { FetchAPI, GetCacheEntry, JunctionAPIOptions, JunctionWebhookEvent, JunctionWebhookOptions, OperationId, SealedCorpus, SeedObservations, SeedReport, SeedSource, SqliteClient, SupportedOperationId, WebhookPublisher };