@crvouga/mockingbird-service-junction 0.2.0 → 0.4.0

package/dist/index.d.ts

@@ -98,7 +98,12 @@ type FaultRule = {
      * rules added through `POST /__admin/faults` default to the calling namespace.
      */
     namespace?: string;
-    status: number;
+    /**
+     * Status of the injected response. Omit for a rule that only delays (`delayMs` /
+     * `latencyMs`), only drops the connection (`drop`), or only switches on an `effect`:
+     * the request then still reaches the service.
+     */
+    status?: number;
     /** Response body, serialized as JSON. A string is sent as-is. */
     body?: unknown;
     headers?: Record<string, string>;
@@ -108,6 +113,34 @@ type FaultRule = {
     rate?: number;
     /** Hold the response back this long, to exercise timeouts. */
     delayMs?: number;
+    /** Alias of `delayMs`. */
+    latencyMs?: number;
+    /**
+     * Drop the connection instead of answering: an in-process `fetch` rejects with a
+     * `TypeError`, and a served mock destroys the socket. Models "unknown outcome" failures.
+     */
+    drop?: boolean;
+    /**
+     * A named service behaviour to switch on for the matching request instead of (or
+     * before) a canned response, e.g. `created_but_500` or `numeric_tracking_id`. Services
+     * read it with `faultEffects(request)`.
+     */
+    effect?: string;
+    /** Parameters for `effect`. */
+    params?: Record<string, unknown>;
+    /** From the preset this rule was expanded from, if any. */
+    preset?: string;
+};
+/** A fault that fired for one request. */
+type FaultHit = {
+    id: string;
+    /** The injected response; absent when the rule only delays, drops, or sets an effect. */
+    response?: Response;
+    drop?: boolean;
+    effect?: {
+        name: string;
+        params: Record<string, unknown>;
+    };
 };
 /** What a request looks like to the fault matcher. */
 type FaultCandidate = {
@@ -125,13 +158,11 @@ type FaultRegistry = {
     remove(id: string): boolean;
     clear(): void;
     /**
-     * The fault this request should get, or `undefined` to let it through.
-     * Consumes one of the matching rule's remaining uses.
+     * Every fault this request should get, in rule order, stopping at the first that answers
+     * or drops (effect-only and delay-only rules let later rules match too). Consumes one of
+     * each matching rule's remaining uses.
      */
-    take(candidate: FaultCandidate): Promise<{
-        id: string;
-        response: Response;
-    } | undefined>;
+    take(candidate: FaultCandidate): Promise<FaultHit[]>;
 };
 
 /** One handled request, as the structured log sees it. */
@@ -147,6 +178,10 @@ type RequestLog = {
     unmatched: boolean;
     /** Set when a fault rule produced the response. */
     faultId?: string;
+    /** Resource ids the handler touched (`userId`, `orderId`, …), when the service reports them. */
+    ids?: Record<string, string>;
+    /** Set when the service created a resource the request referred to but that did not exist. */
+    adopted?: boolean;
 };
 type MetricsReport = {
     requests: number;
@@ -172,6 +207,28 @@ type Metrics = {
     reset(): void;
 };
 
+/** One journal entry: a request log stamped with when (on the mock clock) it was handled. */
+type JournalEntry = RequestLog & {
+    at: string;
+};
+type JournalQuery = {
+    /** Only this namespace. Omit for every namespace, oldest first across all of them. */
+    namespace?: string;
+    operationId?: string;
+    status?: number;
+    /** Only entries at or after this instant (epoch ms). */
+    since?: number;
+    /** At most this many, the most recent kept. */
+    limit?: number;
+};
+type Journal = {
+    readonly size: number;
+    record(entry: JournalEntry): void;
+    list(query?: JournalQuery): JournalEntry[];
+    /** Forget one namespace's entries, or every namespace's. */
+    clear(namespace?: string): void;
+};
+
 /**
  * A point-in-time copy of everything a service namespace holds.
  *
@@ -194,6 +251,18 @@ type NamespaceSnapshot = {
     }[];
 };
 
+/** Credential → namespace mapping behind `PUT /__admin/credentials`. */
+type CredentialRegistry = {
+    set(credential: string, namespace: string): void;
+    get(credential: string): string | undefined;
+    remove(credential: string): boolean;
+    clear(): void;
+    entries(): {
+        credential: string;
+        namespace: string;
+    }[];
+};
+
 /**
  * Anything that can answer a Fetch `Request` with a `Response`.
  *
@@ -204,6 +273,82 @@ interface FetchAPI$1 {
     fetch(request: Request): Promise<Response>;
 }
 
+type WebhookEndpoint$1 = {
+    /** Stable id; generated when omitted. */
+    id?: string;
+    url: string;
+    secret?: string;
+    /** Event types to deliver; omit or include `"*"` for every type. */
+    events?: string[];
+    /** Deliver only messages whose tags include all of these (e.g. `{ account: "mso" }`). */
+    tags?: Record<string, string>;
+    /** The public URL the receiver verifies signatures against (Twilio), when it differs. */
+    signUrl?: string;
+    headers?: Record<string, string>;
+};
+type WebhookMessage = {
+    id: string;
+    namespace: string;
+    type: string;
+    body: string;
+    contentType: string;
+    tags: Record<string, string>;
+    /** Wall-clock ISO-8601 time of publication. */
+    publishedAt: string;
+};
+type WebhookAttempt$1 = {
+    attempt: number;
+    at: string;
+    status: number | null;
+    error: string | null;
+    durationMs: number;
+};
+type WebhookDelivery$1 = {
+    id: string;
+    messageId: string;
+    namespace: string;
+    type: string;
+    endpointId: string;
+    url: string;
+    state: "pending" | "delivered" | "failed" | "dropped";
+    attempts: WebhookAttempt$1[];
+};
+/** A delivery-level fault: what happens to the next `count` messages in a namespace. */
+type WebhookFault = {
+    mode: "duplicate" | "reorder" | "drop";
+    /** Messages affected; default 1. */
+    count?: number;
+};
+type PublishInput = {
+    namespace: string;
+    type: string;
+    /** Exact body; objects are JSON-encoded. */
+    body: string | Record<string, unknown> | unknown[];
+    /** Default `application/json`, or form-encoded when `form` is given. */
+    contentType?: string;
+    /** Form parameters, when the vendor posts `application/x-www-form-urlencoded`. */
+    form?: Record<string, string>;
+    tags?: Record<string, string>;
+    /** Message id; generated when omitted. */
+    id?: string;
+};
+type WebhookHub = {
+    publish(input: PublishInput): WebhookMessage;
+    /** Replace a namespace's own endpoints (`PUT /__admin/webhook-endpoints`). */
+    setEndpoints(namespace: string, endpoints: WebhookEndpoint$1[]): WebhookEndpoint$1[];
+    /** The endpoints a namespace delivers to: its own, plus the global ones. */
+    endpoints(namespace: string): WebhookEndpoint$1[];
+    messages(namespace?: string): WebhookMessage[];
+    deliveries(namespace?: string): WebhookDelivery$1[];
+    replay(deliveryId: string): Promise<WebhookDelivery$1 | undefined>;
+    /** Run every pending retry (and release held reordered messages) now. */
+    flush(): Promise<void>;
+    /** Resolve once nothing is in flight. */
+    idle(): Promise<void>;
+    fault(namespace: string, fault: WebhookFault): void;
+    clear(namespace?: string): void;
+};
+
 /** What the runtime needs from a service: a Fetch handler it can reset. */
 type ServiceInstance = FetchAPI$1 & {
     reset(): Promise<void>;
@@ -214,7 +359,13 @@ type ServiceRuntime<T extends ServiceInstance> = FetchAPI$1 & {
     readonly clock: Clock;
     readonly faults: FaultRegistry;
     readonly metrics: Metrics;
+    readonly journal: Journal;
     readonly rng: Rng;
+    readonly credentials: CredentialRegistry;
+    /** The webhook hub, when the service has outbound webhooks. */
+    readonly webhooks: WebhookHub | undefined;
+    /** Expand a named preset into fault rules (and webhook faults) for `namespace`. */
+    applyPreset(name: string, namespace?: string, overrides?: Partial<FaultRule>): FaultRule[];
     /** The instance behind `namespace` (the default one when omitted), created on first use. */
     instance(namespace?: string): T;
     /** Public names of every namespace created so far. */
@@ -319,6 +470,95 @@ type LabTestRecord = {
     worst_case_tat_days: number | null;
 };
 
+/**
+ * The test backdoor: users and orders put straight into a namespace, with ids a suite
+ * chooses — the Junction `user_id`s a database fixture already carries, or an order
+ * already in some status — plus the lenient identity mode that adopts unknown users.
+ *
+ * Everything inserted here goes through the records `create_user` and `create_order`
+ * build, so no read path can tell a fixture from an API-created resource.
+ */
+
+/** How requests referring to a user the namespace does not hold are answered. */
+type IdentityMode = "strict" | "adopt-users";
+declare const IDENTITY_MODES: readonly IdentityMode[];
+type UserFixture = {
+    /** Default: a fresh id, as `create_user` would mint. */
+    user_id?: string;
+    client_user_id: string;
+    /** ISO-8601. Default: the mock clock's now. */
+    created_on?: string;
+    /** An IANA zone, or the full `{ id, source_slug, updated_at }` object. */
+    fallback_time_zone?: string | UserRecord["fallback_time_zone"];
+    /** `YYYY-MM-DD`, or the full `{ value, source_slug, updated_at }` object. */
+    fallback_birth_date?: string | UserRecord["fallback_birth_date"];
+    ingestion_start?: string | null;
+    ingestion_end?: string | null;
+};
+type OrderFixture = {
+    /** Default: a fresh id, as `create_order` would mint. */
+    order_id?: string;
+    user_id: string;
+    lab_test_id: string;
+    lab_account_id?: string;
+    /** A transition target (`completed`, `at_lab`, or a full status). Default: just ordered. */
+    status?: string;
+    /** Default: the lab test's own method. */
+    collection_method?: string;
+    patient_details?: Record<string, unknown>;
+    patient_address?: Record<string, unknown>;
+    billing_type?: string;
+    icd_codes?: string[] | null;
+    passthrough?: string | null;
+    clinical_notes?: string | null;
+    /** ISO-8601. Default: the mock clock's now. */
+    created_at?: string;
+    /** Results served for the order, as `PUT /__admin/results/{id}` takes them. */
+    result_fixture?: Omit<ResultFixture, "name"> & {
+        name?: string;
+    };
+};
+type JunctionFixtures = {
+    users?: readonly UserFixture[];
+    orders?: readonly OrderFixture[];
+};
+type InsertOptions = {
+    /** Publish the webhooks the equivalent API calls would. Default `false`. */
+    emitWebhooks?: boolean;
+};
+/** A backdoor failure: `status` 400 for a bad fixture, 404 for a missing reference, 409 for a clash. */
+declare class FixtureError extends Error {
+    readonly status: 400 | 404 | 409;
+    constructor(status: 400 | 404 | 409, message: string);
+}
+
+/** Key prefixes of sandbox team keys. `corpus pull` and `verify` refuse any other key. */
+declare const SANDBOX_KEY_PREFIXES: readonly ["sk_us_", "sk_eu_"];
+declare const isSandboxKey: (key: string) => boolean;
+type JunctionLimits = {
+    /**
+     * Live users a team may hold; creating one more answers the sandbox's
+     * "maximum of 50 Sandbox users" 400. Deleted users free their slot. `null`: unlimited.
+     */
+    maxUsers: number | null;
+    /** Refuse `POST /v3/order/{id}/test` unless the API key is a sandbox key (`sk_us_…`/`sk_eu_…`). */
+    simulateRequiresSandbox: boolean;
+    /** Vendor requests per second per namespace before a 429. `null`: unlimited. */
+    rateLimitPerSecond: number | null;
+};
+type JunctionLimitsInput = {
+    [K in keyof JunctionLimits]?: JunctionLimits[K] | undefined;
+};
+/** Every limit off: what a default instance enforces. */
+declare const DEFAULT_LIMITS: Readonly<JunctionLimits>;
+/** The 400 the sandbox answers once a team holds its 50th user, byte for byte. */
+declare const sandboxUserQuotaBody: (max: number) => {
+    detail: {
+        error_type: string;
+        error_message: string;
+    };
+};
+
 type GetCacheEntry = {
     status: number;
     headers: Record<string, string>;
@@ -340,6 +580,27 @@ type WebhookDeliveryAttempt = {
     timeout_ms: number;
     acknowledged: boolean;
 };
+type UserRecord = {
+    user_id: string;
+    team_id: string;
+    client_user_id: string;
+    created_on: string;
+    connected_sources: unknown[];
+    fallback_time_zone: {
+        id: string;
+        source_slug: string;
+        updated_at: string;
+    } | null;
+    fallback_birth_date: {
+        value: string;
+        source_slug: string;
+        updated_at: string;
+    } | null;
+    ingestion_start: string | null;
+    ingestion_end: string | null;
+};
+/** Fixed mock team id — volatile on the real side, stable in the mock. */
+declare const MOCK_TEAM_ID = "11111111-1111-4111-8111-111111111111";
 type OrderEventRecord = {
     id: number;
     created_at: string;
@@ -472,7 +733,16 @@ type LabAccountRecord = {
 };
 /** The 50 `USState` values from the docs, alphabetical by state name. */
 declare const US_STATES: readonly string[];
+/** A team the mock is not, for fixtures that model another team's account. */
+declare const OTHER_TEAM_ID: string;
 declare const TEAM_LAB_ACCOUNTS: readonly LabAccountRecord[];
+/**
+ * Whether `teamId` may use an account. An empty `team_id_allowlist` counts as linked:
+ * a real team's listing returns such accounts (observed — Junction's own Quest, Labcorp
+ * and BioReference accounts carry `[]`), so the mock treats them as the team's. Whether
+ * ordering through one by explicit id behaves the same is unverified; SUPPORT.md tracks it.
+ */
+declare const isLinkedToTeam: (entry: LabAccountRecord, teamId: string) => boolean;
 /**
  * A lab account as a consumer configures it. Mirrors `ClientFacingLabAccount`, with
  * every field but `id` and `lab` optional, plus a `states` shorthand for the common
@@ -493,17 +763,58 @@ type LabAccountInput = {
     allowed_billing?: Record<string, readonly string[]>;
     /** Shorthand for `allowed_billing: { client_bill: states }`. Default: every state. */
     states?: readonly string[];
-    /** Teams the account is linked to. Default: the mock team, so it is selectable. */
+    /** Teams the account is linked to. Default: the configured team, so it is selectable. */
     team_id_allowlist?: readonly string[];
 };
-/** Normalize a consumer's configuration into the record the ordering rules read. */
-declare const labAccountFromInput: (input: LabAccountInput) => LabAccountRecord;
+/**
+ * Normalize a consumer's configuration into the record the ordering rules read.
+ * `teamId` is the default allowlist, so an account is selectable unless told otherwise.
+ */
+declare const labAccountFromInput: (input: LabAccountInput, teamId?: string) => LabAccountRecord;
+
+/**
+ * Named lab accounts a suite can add in one call, modelled on a real team's recorded
+ * listing (a BioReference-linked team, recorded 2026-09-21 from the Junction sandbox).
+ *
+ * Where a preset copies a recorded account, its states and billing types are the
+ * recording's. `bioreference_ny_nj_delegated` is not a recorded account: it is the
+ * NY/NJ client-bill shape a consumer asked for, kept because suites depend on it.
+ */
+
+/** Junction's own Quest, Labcorp and BioReference accounts client-bill in these 47 states. */
+declare const PLATFORM_ACCOUNT_STATES: readonly string[];
+/** The recorded order-delegated BioReference account: every state but New York and New Jersey. */
+declare const DELEGATED_ACCOUNT_STATES: readonly string[];
+type Preset = Omit<LabAccountInput, "id">;
+/**
+ * Every preset, without its id. A preset with no `team_id_allowlist` is linked to the
+ * configured team; the platform presets carry `[]`, as Junction's own accounts do.
+ */
+declare const LAB_ACCOUNT_PRESETS: Readonly<Record<string, Preset>>;
+/** A preset's id when none is given: stable across runs and namespaces. */
+declare const presetAccountId: (name: string) => string;
+/**
+ * A lab-account layout as a file or option declares it: a bare list of accounts, or
+ * presets (by name, or `{ name, id }`) plus accounts, added in that order.
+ */
+type LabAccountLayout = readonly LabAccountInput[] | {
+    presets?: readonly (string | {
+        name: string;
+        id?: string;
+    })[];
+    accounts?: readonly LabAccountInput[];
+};
 
 /**
  * Version of the sealed-corpus on-disk format. Bumped whenever the shape changes so a
  * stale recording is rejected instead of half-applied.
+ *
+ * - 1: observations, catalog and lab accounts.
+ * - 2: adds `teamId`, the recording team, so lab-account allowlists load verbatim.
  */
-declare const SEALED_CORPUS_VERSION = 1;
+declare const SEALED_CORPUS_VERSION = 2;
+/** Versions `parseSealedCorpus` still loads. A version-1 corpus behaves as it did in 0.2.0. */
+declare const SUPPORTED_SEALED_CORPUS_VERSIONS: readonly number[];
 /**
  * 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
@@ -511,9 +822,14 @@ declare const SEALED_CORPUS_VERSION = 1;
  * `booking_key`s can never match a live cache key, so it stays with the generator.
  */
 type SealedCorpus = {
-    version: typeof SEALED_CORPUS_VERSION;
+    version: 1 | typeof SEALED_CORPUS_VERSION;
     recordedAt: string;
     source: string;
+    /**
+     * The recording team's id (version 2+). When present it is the mock's default team,
+     * and each lab account's `team_id_allowlist` is kept exactly as recorded.
+     */
+    teamId?: string;
     /** SHA-256 of the recording's content, written by `corpus pull`. Identifies it in logs. */
     fingerprint?: string;
     observations: Record<string, GetCacheEntry>;
@@ -645,10 +961,38 @@ type JunctionAdminOptions = {
     webhooks: WebhookDispatcher | undefined;
 };
 
+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>;
+
 declare const DEFAULT_JUNCTION_BASE_URL = "https://api.sandbox.tryvital.io";
-/** Key prefixes of sandbox team keys. `corpus pull` and `verify` refuse any other key. */
-declare const SANDBOX_KEY_PREFIXES: readonly ["sk_us_", "sk_eu_"];
-declare const isSandboxKey: (key: string) => boolean;
+
 type PullCorpusOptions = {
     apiKey: string;
     baseUrl?: string;
@@ -677,6 +1021,11 @@ type SetDiff = {
 };
 type CorpusDiff = {
     identical: boolean;
+    /** Set when the recorded team differs (or one side recorded none). */
+    teamId?: {
+        before: string | null;
+        after: string | null;
+    };
     observations: SetDiff;
     labTests: SetDiff;
     labAccounts: SetDiff;
@@ -870,40 +1219,20 @@ type OpenAPIDocument = {
 };
 
 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 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_tests_for_team_v3_lab_tests_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_tests_for_team_v3_lab_tests_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_tests_for_team_v3_lab_tests_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_tests_for_team_v3_lab_tests_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 PrefetchTarget = {
-    baseUrl: string;
-    fetch: (request: Request) => Promise<Response>;
-    headers: () => Promise<Record<string, string>> | Record<string, string>;
-};
+/** The `detail` of each order-scoped operation's 404 for an order that does not exist. */
+declare const ORDER_NOT_FOUND: Readonly<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.
+ * Names the missing resource: `order <id>`, `user <id>`, or `user client:<client_user_id>`
+ * (the id percent-encoded). Never part of Junction's answer.
  */
-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>;
+declare const MISS_HEADER = "x-mockingbird-miss";
+/** What the namespace does hold: `users=<n> orders=<n>`. */
+declare const KNOWN_HEADER = "x-mockingbird-known";
 
 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 = {
@@ -980,8 +1309,18 @@ type JunctionRuntimeOptions = {
     corpus?: SealedCorpus;
     /** Default: `corpus` when a corpus is loaded, otherwise `synthetic`. */
     geo?: GeoMode;
-    /** The team's lab accounts; see {@link JunctionAPIOptions.labAccounts}. */
-    labAccounts?: readonly LabAccountInput[];
+    /** The team's lab accounts, or `{ presets, accounts }`; see {@link JunctionAPIOptions.labAccounts}. */
+    labAccounts?: LabAccountLayout;
+    /** The team the mock answers as. Default: the corpus's recorded team, else a fixed id. */
+    teamId?: string;
+    /** Sandbox-only restrictions, every one off by default; per namespace via `PUT /__admin/limits`. */
+    limits?: JunctionLimitsInput;
+    /** `adopt-users` creates unknown user ids on first use. Default `strict`. */
+    identity?: IdentityMode;
+    /** Users and orders every namespace starts with, re-applied on each reset. */
+    fixtures?: JunctionFixtures;
+    /** Requests each namespace's journal keeps (`GET /__admin/requests`). Default 1000. */
+    journalSize?: number;
     /** Deliver signed webhooks here, with Svix's retry schedule. */
     webhooks?: WebhookEndpoint;
     /** Called in-process for every webhook event, delivered or not. */
@@ -1028,8 +1367,12 @@ declare const UNKNOWN_ZIP_ERROR_TYPE = "MOCKINGBIRD_UNKNOWN_ZIP";
  *   optionally orders) run against both sides, comparing status codes, response
  *   shapes, and — for the documented error bodies — exact bytes.
  *
+ * The scenario also replays every order-scoped operation against a random unknown order
+ * (each 404 body compared exactly) and, with `orders` and a corpus holding an account whose
+ * `team_id_allowlist` is empty, orders through that account with and without its id.
+ *
  * Only a sandbox team should be used: the scenario creates, and always deletes, one
- * user (and, with `orders`, places and cancels one order).
+ * user (and, with `orders`, places and cancels its orders).
  */
 type VerifyOptions = {
     realKey: string;
@@ -1089,10 +1432,22 @@ type JunctionAPIOptions = APIOptions & {
      */
     geo?: GeoMode;
     /**
-     * The team's lab accounts, replacing the built-in fixtures (and any from the corpus).
-     * `create_order` routes, accepts and rejects `lab_account_id` against these.
+     * The team's lab accounts, replacing the built-in fixtures (and any from the corpus):
+     * a list of accounts, or `{ presets: [...], accounts: [...] }`. `create_order` routes,
+     * accepts and rejects `lab_account_id` against these.
+     */
+    labAccounts?: LabAccountLayout;
+    /**
+     * The team the mock answers as: `team_id` on users and orders, and the team lab-account
+     * allowlists are checked against. Default: the corpus's recorded team, else a fixed id.
      */
-    labAccounts?: readonly LabAccountInput[];
+    teamId?: string;
+    /** Sandbox-only restrictions to enforce. Every one is off unless set here. */
+    limits?: JunctionLimitsInput;
+    /** `adopt-users` creates an unknown (well-formed) `user_id` on first use. Default `strict`. */
+    identity?: IdentityMode;
+    /** Users and orders to load into every namespace, re-applied on every `reset()`. */
+    fixtures?: JunctionFixtures;
 };
 /** What a loaded corpus covers, for `/health` and startup logs. */
 type CorpusInfo = {
@@ -1103,6 +1458,8 @@ type CorpusInfo = {
     labTests: number;
     labAccounts: number;
     zips: number;
+    /** The recording team, when the corpus recorded one (version 2+). */
+    teamId?: string;
 };
 /** A short, stable name for a corpus: its recording date plus a digest of what it holds. */
 declare const corpusLabel: (corpus: SealedCorpus) => string;
@@ -1111,6 +1468,10 @@ declare class JunctionAPI implements FetchAPI {
     readonly sqlite: SqliteClient;
     private readonly service;
     private readonly state;
+    private readonly now;
+    private readonly explicitTeamId;
+    private readonly fixtures;
+    private readonly rateWindow;
     private corpus;
     private labAccountConfig;
     constructor(options?: JunctionAPIOptions);
@@ -1127,9 +1488,40 @@ declare class JunctionAPI implements FetchAPI {
      * recorded from a team with no accounts leaves in place).
      */
     private seedLabAccounts;
-    /** Replace the team's lab accounts; `undefined` restores the default. Kept across resets. */
-    configureLabAccounts(accounts: readonly LabAccountInput[] | undefined): StoredLabAccount[];
+    /** The team this namespace answers as. */
+    get teamId(): string;
+    /**
+     * Replace the team's lab accounts (a list, or `{ presets, accounts }`); `undefined`
+     * restores the default. Kept across `reset()`, per namespace.
+     */
+    configureLabAccounts(accounts: LabAccountLayout | undefined): StoredLabAccount[];
     labAccounts(): StoredLabAccount[];
+    /** Apply one change to the effective account list and keep it as this namespace's config. */
+    private editLabAccounts;
+    /** Add one account. Throws `LabAccountConflict` when the id is taken. Kept across resets. */
+    addLabAccount(input: LabAccountInput | StoredLabAccount): StoredLabAccount;
+    /** Add a named preset (see `LAB_ACCOUNT_PRESETS`); `undefined` for an unknown name. */
+    addLabAccountPreset(name: string, id?: string): StoredLabAccount | undefined;
+    /** Merge fields into an account; `undefined` when there is none with that id. */
+    patchLabAccount(id: string, patch: Partial<LabAccountInput>): StoredLabAccount | undefined;
+    removeLabAccount(id: string): boolean;
+    /** The sandbox limits this namespace enforces. Every one is off unless configured. */
+    get limits(): JunctionLimits;
+    /** Change some limits (`null` lifts a numeric one); kept across `reset()`. */
+    configureLimits(input: JunctionLimitsInput): JunctionLimits;
+    get identity(): IdentityMode;
+    set identity(mode: IdentityMode);
+    /** Insert users with chosen ids, all or none. Throws `FixtureError` (400/404/409). */
+    insertUsers(users: readonly UserFixture[]): UserRecord[];
+    /** Remove a user outright, leaving no deletion tombstone. */
+    hardDeleteUser(userId: string): boolean;
+    /** Insert orders, optionally already in a status. No webhook fires unless asked. */
+    insertOrders(orders: readonly OrderFixture[], options?: InsertOptions): OrderRecord[];
+    /** Load users, then orders, in one call. */
+    importFixtures(fixtures: JunctionFixtures, options?: InsertOptions): {
+        users: UserRecord[];
+        orders: OrderRecord[];
+    };
     corpusInfo(): CorpusInfo | undefined;
     get geoMode(): GeoMode;
     set geoMode(mode: GeoMode);
@@ -1154,6 +1546,11 @@ declare class JunctionAPI implements FetchAPI {
     webhookEvents(): JunctionWebhookEvent[];
     webhookDeliveryAttempts(): WebhookDeliveryAttempt[];
 }
+/** Raised by `addLabAccount` for an id the namespace already has. */
+declare class LabAccountConflict extends Error {
+    readonly id: string;
+    constructor(id: string);
+}
 
-export { AVAILABILITY_ADDRESS, AVAILABILITY_START_DATE, COVERAGE_ZIPS, DEFAULT_JUNCTION_BASE_URL, FAULT_PRESETS, JUNCTION_NAMESPACE, JunctionAPI, ORDER_STATUSES_BY_METHOD, PHLEBOTOMY_AVAILABILITY_ZIPS, PSC_AVAILABILITY_ZIPS, PSC_LAB_IDS, RESULT_FIXTURES, SANDBOX_KEY_PREFIXES, SEALED_CORPUS_VERSION, TEAM_LAB_ACCOUNTS, TRANSITION_ALIASES, UNKNOWN_ZIP_ERROR_TYPE, UNKNOWN_ZIP_STATUS, US_STATES, corpusLabel, createRuntime, createWebhookDispatcher, diffCorpus, document, fingerprintCorpus, isSandboxKey, labAccountFromInput, observationCacheKey, operationIds, parseSealedCorpus, prefetchCoverageObservations, pullCorpus, reshapeCoverageGeoCommand, resolveTransition, signSvix, supportedOperationIds, verifyAgainstReal, verifySvix };
-export type { CorpusDiff, CorpusInfo, Divergence, FetchAPI, GeoMode, GetCacheEntry, JunctionAPIOptions, JunctionAdminOptions, JunctionRuntime, JunctionRuntimeOptions, JunctionWebhookEvent, JunctionWebhookOptions, LabAccountDelegatedFlow, LabAccountInput, LabAccountRecord, LabAccountStatus, OperationId, OrderRecord, PullCorpusOptions, ResultFixture, SealedCorpus, SeedObservations, SeedReport, SeedSource, SetDiff, SqliteClient, StoredLabAccount, SupportedOperationId, VerifyOptions, VerifyReport, WebhookAttempt, WebhookDelivery, WebhookDispatcher, WebhookEndpoint, WebhookPublisher };
+export { AVAILABILITY_ADDRESS, AVAILABILITY_START_DATE, COVERAGE_ZIPS, DEFAULT_JUNCTION_BASE_URL, DEFAULT_LIMITS, DELEGATED_ACCOUNT_STATES, FAULT_PRESETS, FixtureError, IDENTITY_MODES, JUNCTION_NAMESPACE, JunctionAPI, KNOWN_HEADER, LAB_ACCOUNT_PRESETS, LabAccountConflict, MISS_HEADER, MOCK_TEAM_ID, ORDER_NOT_FOUND, ORDER_STATUSES_BY_METHOD, OTHER_TEAM_ID, PHLEBOTOMY_AVAILABILITY_ZIPS, PLATFORM_ACCOUNT_STATES, PSC_AVAILABILITY_ZIPS, PSC_LAB_IDS, RESULT_FIXTURES, SANDBOX_KEY_PREFIXES, SEALED_CORPUS_VERSION, SUPPORTED_SEALED_CORPUS_VERSIONS, TEAM_LAB_ACCOUNTS, TRANSITION_ALIASES, UNKNOWN_ZIP_ERROR_TYPE, UNKNOWN_ZIP_STATUS, US_STATES, corpusLabel, createRuntime, createWebhookDispatcher, diffCorpus, document, fingerprintCorpus, isLinkedToTeam, isSandboxKey, labAccountFromInput, observationCacheKey, operationIds, parseSealedCorpus, prefetchCoverageObservations, presetAccountId, pullCorpus, reshapeCoverageGeoCommand, resolveTransition, sandboxUserQuotaBody, signSvix, supportedOperationIds, verifyAgainstReal, verifySvix };
+export type { CorpusDiff, CorpusInfo, Divergence, FetchAPI, GeoMode, GetCacheEntry, IdentityMode, InsertOptions, JunctionAPIOptions, JunctionAdminOptions, JunctionFixtures, JunctionLimits, JunctionLimitsInput, JunctionRuntime, JunctionRuntimeOptions, JunctionWebhookEvent, JunctionWebhookOptions, LabAccountDelegatedFlow, LabAccountInput, LabAccountLayout, LabAccountRecord, LabAccountStatus, OperationId, OrderFixture, OrderRecord, PullCorpusOptions, ResultFixture, SealedCorpus, SeedObservations, SeedReport, SeedSource, SetDiff, SqliteClient, StoredLabAccount, SupportedOperationId, UserFixture, UserRecord, VerifyOptions, VerifyReport, WebhookAttempt, WebhookDelivery, WebhookDispatcher, WebhookEndpoint, WebhookPublisher };