@crvouga/mockingbird-service-stripe 0.1.1 → 0.1.2

package/README.md

@@ -25,8 +25,8 @@ npm install -D @crvouga/mockingbird-service-stripe
 ```
 
 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 an adapter: `@crvouga/mockingbird-adapter-node` 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
 
@@ -75,11 +75,14 @@ console.log(((await listed.json()) as { data: unknown[] }).data.length) // 1
 ### Over HTTP
 
 ```ts
-import { serve } from "@crvouga/mockingbird-adapter-bun"
 import { StripeAPI } from "@crvouga/mockingbird-service-stripe"
 
 const stripe = new StripeAPI()
-const server = serve(stripe, { port: 0, hostname: "127.0.0.1" }) // port 0 = ephemeral
+const server = Bun.serve({
+  port: 0, // ephemeral
+  hostname: "127.0.0.1",
+  fetch: (request) => stripe.fetch(request),
+})
 const baseUrl = `http://127.0.0.1:${server.port}`
 
 const response = await fetch(`${baseUrl}/v1/products?limit=3`, {
@@ -90,13 +93,15 @@ console.log(response.status) // 200
 server.stop()
 ```
 
-On Node use `@crvouga/mockingbird-adapter-node`, whose `serve` is async and returns a
-`node:http` server:
+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 "@crvouga/mockingbird-adapter-node"
-const server = await serve(stripe, { port: 0, host: "127.0.0.1" })
-const { port } = server.address()
+import { serve } from "@hono/node-server"
+const server = serve(
+  { fetch: (request) => stripe.fetch(request), port: 0, hostname: "127.0.0.1" },
+  (info) => console.log(`http://127.0.0.1:${info.port}`),
+)
 // ... later: server.close()
 ```
 
@@ -111,7 +116,7 @@ import Stripe from "stripe"
 const client = new Stripe("sk_test_mockingbird", {
   apiVersion: "2024-06-20",
   host: "127.0.0.1",
-  port: server.port, // from serve() above
+  port: server.port, // from Bun.serve() above
   protocol: "http",
 })
 await client.customers.create({ email: "qa@example.com" })
@@ -184,7 +189,7 @@ QA corpus used by the parity suites.
 
 | Export | Description |
 | --- | --- |
-| `StripeAPI` | Class. `new StripeAPI(options?)`; implements `FetchAPI` (`fetch(request: Request): Promise<Response>`). |
+| `StripeAPI` | Class. `new StripeAPI(options?)`; implements the Fetch contract `fetch(request: Request): Promise<Response>`. |
 | `accountOfKey` | `(key: string) => string` — the opaque `acct_...` partition id for an API key (use it to filter `webhookEvents`). |
 | `accountOf` | `(request: Request) => string` — the partition id for a request's bearer key. |
 | `STRIPE_NAMESPACE` | `"stripe"` — SQLite namespace holding every Stripe record when sharing a `sqlite` client. |
@@ -199,7 +204,7 @@ QA corpus used by the parity suites.
 | `QA_TEST_CARD_TOKENS` | Test card tokens the suites use (`tok_visa`, decline tokens, ...). |
 | `QA_SEARCH_QUERIES` | Search queries the suites issue against `/v1/customers/search`. |
 | `QA_COUPON_CODES` | Coupon / promotion codes used by the coupon flows. |
-| `reshapeQaCommand` | Parity-walk hook that pins sampled commands onto QA corpus values (for `@crvouga/mockingbird-parity`). |
+| `reshapeQaCommand` | Parity-walk hook that pins sampled commands onto QA corpus values (for the repo's parity runner). |
 
 `StripeAPI` members:
 
@@ -226,8 +231,9 @@ type WebhookPublisher = (event: StripeWebhookEvent) => void
 type OperationId / SupportedOperationId  // string unions of operationIds / supportedOperationIds
 ```
 
-`SqliteClient` is the port from `@crvouga/mockingbird-sqlite`; `Database` from
-`@crvouga/mockingbird-service-sqlite` satisfies it, as do better-sqlite3 and wrapped `bun:sqlite`.
+`SqliteClient` is the storage port bundled with this package (`exec`, `prepare(sql).run/all/get`,
+`transaction`); `Database` from `@crvouga/mockingbird-service-sqlite` satisfies it, as do
+better-sqlite3 and wrapped `bun:sqlite`.
 
 ## Development
 
@@ -251,4 +257,4 @@ PORT=12111 MOCKINGBIRD_STRIPE_WEBHOOK_TARGETS='[{"apiKey":"sk_test_mso","url":"h
 
 Live parity needs a real `sk_test_` key and mutates a shared test account.
 
-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,16 +1,360 @@
-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 { StripeWebhookEvent, WebhookPublisher } from "./internal.js";
-export { accountOf, accountOfKey } from "./account.js";
-export { STRIPE_NAMESPACE } from "./constants.js";
-export type { OperationId, SupportedOperationId } from "./generated/openapi.js";
-export { document, operationIds, supportedOperationIds } from "./generated/openapi.js";
-export type { StripeWebhookEvent, WebhookPublisher } from "./internal.js";
-export { QA_AMOUNTS, QA_COUPON_CODES, QA_CUSTOMER, QA_METADATA, QA_SEARCH_QUERIES, QA_SURFACE_OPS, QA_TEST_CARD_TOKENS, QA_TEST_PAYMENT_METHODS, } from "./qa-corpus.js";
-export { reshapeQaCommand } from "./reshape-qa.js";
-export type StripeAPIOptions = APIOptions & {
+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;
+}
+
+type WebhookDeliveryAttemptRecord = {
+    message_id: string;
+    account: string;
+    attempt: number;
+    scheduled_at: string;
+    timeout_ms: number;
+    acknowledged: boolean;
+};
+
+/**
+ * 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>;
+}
+
+/** What the server publishes when the mock records an event. */
+type StripeWebhookEvent = {
+    type: string;
+    account: string;
+    body: string;
+};
+type WebhookPublisher = (event: StripeWebhookEvent) => void;
+
+/**
+ * Real Stripe partitions objects by account; the mock partitions by the bearer key that created
+ * them, so two different test keys are two accounts and a PC object is `resource_missing` on the
+ * MSO account. The key itself is never stored — only this deterministic, opaque token.
+ */
+declare const accountOfKey: (key: string) => string;
+declare const accountOf: (request: Request) => string;
+
+/** SQLite namespace holding every Stripe record, sequence and event. */
+declare const STRIPE_NAMESPACE = "stripe";
+
+/**
+ * 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 = "GetBalanceTransactions" | "GetBalanceTransactionsId" | "GetCharges" | "PostCharges" | "GetChargesCharge" | "PostChargesCharge" | "GetCheckoutSessions" | "PostCheckoutSessions" | "GetCheckoutSessionsSession" | "PostCheckoutSessionsSession" | "PostCheckoutSessionsSessionExpire" | "GetCheckoutSessionsSessionLineItems" | "GetCoupons" | "PostCoupons" | "GetCouponsCoupon" | "PostCouponsCoupon" | "DeleteCouponsCoupon" | "GetCustomers" | "PostCustomers" | "GetCustomersCustomer" | "PostCustomersCustomer" | "DeleteCustomersCustomer" | "GetCustomersCustomerBalanceTransactions" | "PostCustomersCustomerBalanceTransactions" | "GetCustomersSearch" | "GetDisputes" | "GetDisputesDispute" | "PostDisputesDispute" | "GetEvents" | "GetEventsId" | "GetInvoiceitems" | "PostInvoiceitems" | "GetInvoiceitemsInvoiceitem" | "PostInvoiceitemsInvoiceitem" | "DeleteInvoiceitemsInvoiceitem" | "GetInvoices" | "PostInvoices" | "GetInvoicesInvoice" | "PostInvoicesInvoice" | "DeleteInvoicesInvoice" | "PostInvoicesInvoiceFinalize" | "GetInvoicesInvoiceLines" | "PostInvoicesInvoicePay" | "GetInvoicesUpcoming" | "GetPaymentIntents" | "PostPaymentIntents" | "GetPaymentIntentsIntent" | "PostPaymentIntentsIntent" | "PostPaymentIntentsIntentCancel" | "PostPaymentIntentsIntentCapture" | "PostPaymentIntentsIntentConfirm" | "GetPaymentIntentsSearch" | "GetPaymentMethods" | "PostPaymentMethods" | "GetPaymentMethodsPaymentMethod" | "PostPaymentMethodsPaymentMethod" | "PostPaymentMethodsPaymentMethodAttach" | "PostPaymentMethodsPaymentMethodDetach" | "GetPrices" | "PostPrices" | "GetPricesPrice" | "PostPricesPrice" | "GetProducts" | "PostProducts" | "GetProductsId" | "PostProductsId" | "DeleteProductsId" | "GetProductsSearch" | "GetPromotionCodes" | "PostPromotionCodes" | "GetPromotionCodesPromotionCode" | "PostPromotionCodesPromotionCode" | "GetRefunds" | "PostRefunds" | "GetRefundsRefund" | "PostRefundsRefund" | "GetSetupIntents" | "PostSetupIntents" | "GetSetupIntentsIntent" | "PostSetupIntentsIntent" | "PostSetupIntentsIntentCancel" | "PostSetupIntentsIntentConfirm" | "GetSubscriptionItems" | "PostSubscriptionItems" | "GetSubscriptionItemsItem" | "PostSubscriptionItemsItem" | "DeleteSubscriptionItemsItem" | "GetSubscriptionSchedules" | "PostSubscriptionSchedules" | "GetSubscriptionSchedulesSchedule" | "PostSubscriptionSchedulesSchedule" | "PostSubscriptionSchedulesScheduleCancel" | "PostSubscriptionSchedulesScheduleRelease" | "GetSubscriptions" | "PostSubscriptions" | "GetSubscriptionsSubscriptionExposedId" | "PostSubscriptionsSubscriptionExposedId" | "DeleteSubscriptionsSubscriptionExposedId" | "GetTestHelpersTestClocks" | "PostTestHelpersTestClocks" | "GetTestHelpersTestClocksTestClock" | "DeleteTestHelpersTestClocksTestClock" | "PostTestHelpersTestClocksTestClockAdvance" | "GetWebhookEndpoints" | "PostWebhookEndpoints" | "GetWebhookEndpointsWebhookEndpoint" | "PostWebhookEndpointsWebhookEndpoint" | "DeleteWebhookEndpointsWebhookEndpoint";
+type SupportedOperationId = "GetCharges" | "GetChargesCharge" | "GetCheckoutSessions" | "PostCheckoutSessions" | "GetCheckoutSessionsSession" | "PostCheckoutSessionsSessionExpire" | "GetCheckoutSessionsSessionLineItems" | "GetCoupons" | "PostCoupons" | "GetCouponsCoupon" | "PostCouponsCoupon" | "GetCustomers" | "PostCustomers" | "GetCustomersCustomer" | "PostCustomersCustomer" | "DeleteCustomersCustomer" | "GetCustomersCustomerBalanceTransactions" | "PostCustomersCustomerBalanceTransactions" | "GetCustomersSearch" | "GetDisputes" | "GetDisputesDispute" | "GetEvents" | "GetEventsId" | "GetInvoiceitems" | "PostInvoiceitems" | "GetInvoiceitemsInvoiceitem" | "PostInvoiceitemsInvoiceitem" | "DeleteInvoiceitemsInvoiceitem" | "GetInvoices" | "PostInvoices" | "GetInvoicesInvoice" | "PostInvoicesInvoice" | "DeleteInvoicesInvoice" | "PostInvoicesInvoiceFinalize" | "GetInvoicesInvoiceLines" | "PostInvoicesInvoicePay" | "GetInvoicesUpcoming" | "GetPaymentIntents" | "PostPaymentIntents" | "GetPaymentIntentsIntent" | "PostPaymentIntentsIntent" | "PostPaymentIntentsIntentCancel" | "PostPaymentIntentsIntentCapture" | "PostPaymentIntentsIntentConfirm" | "GetPaymentIntentsSearch" | "GetPaymentMethods" | "PostPaymentMethods" | "GetPaymentMethodsPaymentMethod" | "PostPaymentMethodsPaymentMethod" | "PostPaymentMethodsPaymentMethodAttach" | "PostPaymentMethodsPaymentMethodDetach" | "GetPrices" | "PostPrices" | "GetPricesPrice" | "PostPricesPrice" | "GetProducts" | "PostProducts" | "GetProductsId" | "PostProductsId" | "DeleteProductsId" | "GetProductsSearch" | "GetPromotionCodes" | "PostPromotionCodes" | "GetPromotionCodesPromotionCode" | "PostPromotionCodesPromotionCode" | "GetRefunds" | "PostRefunds" | "GetRefundsRefund" | "PostRefundsRefund" | "GetSetupIntents" | "PostSetupIntents" | "GetSetupIntentsIntent" | "PostSetupIntentsIntent" | "PostSetupIntentsIntentCancel" | "PostSetupIntentsIntentConfirm" | "GetSubscriptionItems" | "GetSubscriptionItemsItem" | "GetSubscriptionSchedules" | "PostSubscriptionSchedules" | "GetSubscriptionSchedulesSchedule" | "PostSubscriptionSchedulesSchedule" | "PostSubscriptionSchedulesScheduleCancel" | "PostSubscriptionSchedulesScheduleRelease" | "GetSubscriptions" | "PostSubscriptions" | "GetSubscriptionsSubscriptionExposedId" | "PostSubscriptionsSubscriptionExposedId" | "DeleteSubscriptionsSubscriptionExposedId";
+declare const operationIds: readonly ["GetBalanceTransactions", "GetBalanceTransactionsId", "GetCharges", "PostCharges", "GetChargesCharge", "PostChargesCharge", "GetCheckoutSessions", "PostCheckoutSessions", "GetCheckoutSessionsSession", "PostCheckoutSessionsSession", "PostCheckoutSessionsSessionExpire", "GetCheckoutSessionsSessionLineItems", "GetCoupons", "PostCoupons", "GetCouponsCoupon", "PostCouponsCoupon", "DeleteCouponsCoupon", "GetCustomers", "PostCustomers", "GetCustomersCustomer", "PostCustomersCustomer", "DeleteCustomersCustomer", "GetCustomersCustomerBalanceTransactions", "PostCustomersCustomerBalanceTransactions", "GetCustomersSearch", "GetDisputes", "GetDisputesDispute", "PostDisputesDispute", "GetEvents", "GetEventsId", "GetInvoiceitems", "PostInvoiceitems", "GetInvoiceitemsInvoiceitem", "PostInvoiceitemsInvoiceitem", "DeleteInvoiceitemsInvoiceitem", "GetInvoices", "PostInvoices", "GetInvoicesInvoice", "PostInvoicesInvoice", "DeleteInvoicesInvoice", "PostInvoicesInvoiceFinalize", "GetInvoicesInvoiceLines", "PostInvoicesInvoicePay", "GetInvoicesUpcoming", "GetPaymentIntents", "PostPaymentIntents", "GetPaymentIntentsIntent", "PostPaymentIntentsIntent", "PostPaymentIntentsIntentCancel", "PostPaymentIntentsIntentCapture", "PostPaymentIntentsIntentConfirm", "GetPaymentIntentsSearch", "GetPaymentMethods", "PostPaymentMethods", "GetPaymentMethodsPaymentMethod", "PostPaymentMethodsPaymentMethod", "PostPaymentMethodsPaymentMethodAttach", "PostPaymentMethodsPaymentMethodDetach", "GetPrices", "PostPrices", "GetPricesPrice", "PostPricesPrice", "GetProducts", "PostProducts", "GetProductsId", "PostProductsId", "DeleteProductsId", "GetProductsSearch", "GetPromotionCodes", "PostPromotionCodes", "GetPromotionCodesPromotionCode", "PostPromotionCodesPromotionCode", "GetRefunds", "PostRefunds", "GetRefundsRefund", "PostRefundsRefund", "GetSetupIntents", "PostSetupIntents", "GetSetupIntentsIntent", "PostSetupIntentsIntent", "PostSetupIntentsIntentCancel", "PostSetupIntentsIntentConfirm", "GetSubscriptionItems", "PostSubscriptionItems", "GetSubscriptionItemsItem", "PostSubscriptionItemsItem", "DeleteSubscriptionItemsItem", "GetSubscriptionSchedules", "PostSubscriptionSchedules", "GetSubscriptionSchedulesSchedule", "PostSubscriptionSchedulesSchedule", "PostSubscriptionSchedulesScheduleCancel", "PostSubscriptionSchedulesScheduleRelease", "GetSubscriptions", "PostSubscriptions", "GetSubscriptionsSubscriptionExposedId", "PostSubscriptionsSubscriptionExposedId", "DeleteSubscriptionsSubscriptionExposedId", "GetTestHelpersTestClocks", "PostTestHelpersTestClocks", "GetTestHelpersTestClocksTestClock", "DeleteTestHelpersTestClocksTestClock", "PostTestHelpersTestClocksTestClockAdvance", "GetWebhookEndpoints", "PostWebhookEndpoints", "GetWebhookEndpointsWebhookEndpoint", "PostWebhookEndpointsWebhookEndpoint", "DeleteWebhookEndpointsWebhookEndpoint"];
+declare const supportedOperationIds: readonly ["GetCharges", "GetChargesCharge", "GetCheckoutSessions", "PostCheckoutSessions", "GetCheckoutSessionsSession", "PostCheckoutSessionsSessionExpire", "GetCheckoutSessionsSessionLineItems", "GetCoupons", "PostCoupons", "GetCouponsCoupon", "PostCouponsCoupon", "GetCustomers", "PostCustomers", "GetCustomersCustomer", "PostCustomersCustomer", "DeleteCustomersCustomer", "GetCustomersCustomerBalanceTransactions", "PostCustomersCustomerBalanceTransactions", "GetCustomersSearch", "GetDisputes", "GetDisputesDispute", "GetEvents", "GetEventsId", "GetInvoiceitems", "PostInvoiceitems", "GetInvoiceitemsInvoiceitem", "PostInvoiceitemsInvoiceitem", "DeleteInvoiceitemsInvoiceitem", "GetInvoices", "PostInvoices", "GetInvoicesInvoice", "PostInvoicesInvoice", "DeleteInvoicesInvoice", "PostInvoicesInvoiceFinalize", "GetInvoicesInvoiceLines", "PostInvoicesInvoicePay", "GetInvoicesUpcoming", "GetPaymentIntents", "PostPaymentIntents", "GetPaymentIntentsIntent", "PostPaymentIntentsIntent", "PostPaymentIntentsIntentCancel", "PostPaymentIntentsIntentCapture", "PostPaymentIntentsIntentConfirm", "GetPaymentIntentsSearch", "GetPaymentMethods", "PostPaymentMethods", "GetPaymentMethodsPaymentMethod", "PostPaymentMethodsPaymentMethod", "PostPaymentMethodsPaymentMethodAttach", "PostPaymentMethodsPaymentMethodDetach", "GetPrices", "PostPrices", "GetPricesPrice", "PostPricesPrice", "GetProducts", "PostProducts", "GetProductsId", "PostProductsId", "DeleteProductsId", "GetProductsSearch", "GetPromotionCodes", "PostPromotionCodes", "GetPromotionCodesPromotionCode", "PostPromotionCodesPromotionCode", "GetRefunds", "PostRefunds", "GetRefundsRefund", "PostRefundsRefund", "GetSetupIntents", "PostSetupIntents", "GetSetupIntentsIntent", "PostSetupIntentsIntent", "PostSetupIntentsIntentCancel", "PostSetupIntentsIntentConfirm", "GetSubscriptionItems", "GetSubscriptionItemsItem", "GetSubscriptionSchedules", "PostSubscriptionSchedules", "GetSubscriptionSchedulesSchedule", "PostSubscriptionSchedulesSchedule", "PostSubscriptionSchedulesScheduleCancel", "PostSubscriptionSchedulesScheduleRelease", "GetSubscriptions", "PostSubscriptions", "GetSubscriptionsSubscriptionExposedId", "PostSubscriptionsSubscriptionExposedId", "DeleteSubscriptionsSubscriptionExposedId"];
+
+/**
+ * The Stripe surface the QA suites exercise: every operation the vendored contract marks
+ * supported (the unsupported ones answer a Stripe-shaped error by design and are listed with
+ * reasons in SUPPORT.md). Derived from the document so the list can never drift from the contract.
+ */
+declare const QA_SURFACE_OPS: readonly string[];
+/** Pinned values the suites use, so offline walks exercise realistic shapes. */
+declare const QA_METADATA: {
+    readonly intent: "e2e-test";
+    readonly source: "e2e-test";
+    readonly userId: "1001";
+};
+declare const QA_AMOUNTS: readonly [1000, 15000, 17999];
+declare const QA_CUSTOMER: {
+    readonly email: "qa+e2e@test.example.com";
+    readonly name: "Ada Lovelace";
+    readonly phone: "+15555550123";
+};
+/** Test payment methods and card tokens the suites attach by id. */
+declare const QA_TEST_PAYMENT_METHODS: readonly ["pm_card_visa", "pm_card_mastercard", "pm_card_authenticationRequired"];
+declare const QA_TEST_CARD_TOKENS: readonly ["tok_visa", "tok_mastercard", "tok_chargeDeclinedInsufficientFunds", "tok_chargeDeclinedExpiredCard", "tok_chargeCustomerFail"];
+/** Search queries the suites issue, covering every metadata key their handlers read. */
+declare const QA_SEARCH_QUERIES: readonly ["metadata['userId']:'1001'", "metadata['paymentId']:'1001'", "metadata['billingInvoiceId']:'inv_1001'", "email:'qa+e2e@test.example.com'"];
+/** Coupon / promotion-code fixture values used by the shop and coupon flows. */
+declare const QA_COUPON_CODES: readonly ["QA10", "QA-FREE-BLOODWORK"];
+
+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>;
+
+/**
+ * Pin sampled commands onto the values the QA suites actually send, so offline seedParity walks
+ * stay deterministic and hit the same code paths a real run does: amounts and currency from the
+ * corpus, the metadata keys the backend reads, and the documented test payment methods.
+ */
+declare const reshapeQaCommand: (command: LogicalCommand, _state: ExploreState, rng: ExploreRng) => LogicalCommand;
+
+type StripeAPIOptions = APIOptions & {
     /** Called with every event the mock records, so a server can deliver it. */
     onWebhook?: WebhookPublisher;
 };
@@ -19,7 +363,7 @@ export type StripeAPIOptions = APIOptions & {
  * behave like two accounts. Pass `sqlite` to share a client across services; omit it to get a
  * fresh `@crvouga/mockingbird-service-sqlite` database.
  */
-export declare class StripeAPI implements FetchAPI {
+declare class StripeAPI implements FetchAPI {
     readonly app: Hono;
     readonly sqlite: SqliteClient;
     private readonly service;
@@ -37,7 +381,9 @@ export declare class StripeAPI implements FetchAPI {
      * (`accountOfKey("sk_test_…")`); omit it for every partition the instance has seen.
      */
     webhookEvents(account?: string): StripeWebhookEvent[];
-    webhookDeliveryAttempts(account?: string): import("./state.js").WebhookDeliveryAttemptRecord[];
+    webhookDeliveryAttempts(account?: string): WebhookDeliveryAttemptRecord[];
     reset(): Promise<void>;
 }
-//# sourceMappingURL=index.d.ts.map
+
+export { QA_AMOUNTS, QA_COUPON_CODES, QA_CUSTOMER, QA_METADATA, QA_SEARCH_QUERIES, QA_SURFACE_OPS, QA_TEST_CARD_TOKENS, QA_TEST_PAYMENT_METHODS, STRIPE_NAMESPACE, StripeAPI, accountOf, accountOfKey, document, operationIds, reshapeQaCommand, supportedOperationIds };
+export type { FetchAPI, OperationId, SqliteClient, StripeAPIOptions, StripeWebhookEvent, SupportedOperationId, WebhookPublisher };