@peable.to/contracts 0.4.0 → 1.0.0

package/dist/types/resources/events/events.d.ts

@@ -0,0 +1,731 @@
+import { z } from 'zod';
+import { type ObjectMap } from '../../common/objects';
+import { type WebhookEventObjectType, type WebhookEventType } from '../../vocabulary/events';
+/**
+ * Events (`evt_…`, ADR 0014 D4) — Stripe's event names (ADR 0019) with the
+ * resource nested under `data.object`. Stored once, in the transaction of the
+ * change it records, kept 30 days (`/v1/events`), and delivered HMAC-signed to
+ * every matching webhook endpoint: a delivery's body and `GET /v1/events/:id`
+ * are byte for byte the same object.
+ */
+/**
+ * The payload of `billing.observation.updated`: a wake-up, never paid or grant
+ * authority. Re-read the owner-bound resource it names.
+ */
+export declare const billingObservationSchema: z.ZodObject<{
+    object: z.ZodLiteral<"billing_observation">;
+    livemode: z.ZodBoolean;
+    resource_kind: z.ZodEnum<{
+        subscription: "subscription";
+        invoice: "invoice";
+    }>;
+    resource_id: z.ZodString;
+    subscription_id: z.ZodOptional<z.ZodString>;
+    revision: z.ZodNumber;
+    observed_at: z.ZodNumber;
+}, z.core.$strict>;
+export type BillingObservation = z.output<typeof billingObservationSchema>;
+/**
+ * What caused an event, when an API request did (Stripe's `event.request`).
+ * Both `null` for an event caused by something else — the chain watcher, the
+ * expiry sweeper, a provider's own notification.
+ */
+export declare const eventRequestSchema: z.ZodObject<{
+    id: z.ZodNullable<z.ZodString>;
+    idempotency_key: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export type WebhookEventRequest = z.output<typeof eventRequestSchema>;
+/** The envelope around `type` and `data.object`. */
+declare function envelope<T extends z.ZodType, O extends z.ZodType>(type: T, object: O): z.ZodObject<{
+    data: z.ZodObject<{
+        object: O;
+        previous_attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>;
+    request: z.ZodObject<{
+        id: z.ZodNullable<z.ZodString>;
+        idempotency_key: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>;
+    created: z.ZodNumber;
+    livemode: z.ZodBoolean;
+    api_version: z.ZodString;
+    account: z.ZodOptional<z.ZodString>;
+    type: T;
+    id: z.ZodString;
+    object: z.ZodLiteral<"event">;
+}, z.core.$strict>;
+/**
+ * An event of any type. `data.object` is the resource `type` names
+ * (`WEBHOOK_EVENT_OBJECTS`), checked against THAT object's schema — a
+ * `payment_intent.succeeded` carrying a Customer is refused even though a
+ * Customer is a valid event object.
+ */
+export declare const eventSchema: z.ZodObject<{
+    data: z.ZodObject<{
+        object: z.ZodUnion<z.ZodLazy<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>[]>;
+        previous_attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>;
+    request: z.ZodObject<{
+        id: z.ZodNullable<z.ZodString>;
+        idempotency_key: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>;
+    created: z.ZodNumber;
+    livemode: z.ZodBoolean;
+    api_version: z.ZodString;
+    account: z.ZodOptional<z.ZodString>;
+    type: z.ZodEnum<{
+        "payment_intent.created": "payment_intent.created";
+        "payment_intent.requires_action": "payment_intent.requires_action";
+        "payment_intent.processing": "payment_intent.processing";
+        "payment_intent.amount_capturable_updated": "payment_intent.amount_capturable_updated";
+        "payment_intent.succeeded": "payment_intent.succeeded";
+        "payment_intent.payment_failed": "payment_intent.payment_failed";
+        "payment_intent.canceled": "payment_intent.canceled";
+        "charge.refunded": "charge.refunded";
+        "charge.dispute.created": "charge.dispute.created";
+        "charge.dispute.updated": "charge.dispute.updated";
+        "charge.dispute.closed": "charge.dispute.closed";
+        "charge.dispute.funds_withdrawn": "charge.dispute.funds_withdrawn";
+        "charge.dispute.funds_reinstated": "charge.dispute.funds_reinstated";
+        "refund.created": "refund.created";
+        "refund.updated": "refund.updated";
+        "refund.failed": "refund.failed";
+        "customer.created": "customer.created";
+        "customer.updated": "customer.updated";
+        "customer.deleted": "customer.deleted";
+        "payment_method.attached": "payment_method.attached";
+        "payment_method.detached": "payment_method.detached";
+        "payment_method.updated": "payment_method.updated";
+        "setup_intent.created": "setup_intent.created";
+        "setup_intent.requires_action": "setup_intent.requires_action";
+        "setup_intent.succeeded": "setup_intent.succeeded";
+        "setup_intent.setup_failed": "setup_intent.setup_failed";
+        "setup_intent.canceled": "setup_intent.canceled";
+        "billing.observation.updated": "billing.observation.updated";
+        "connected_account.updated": "connected_account.updated";
+        "product.created": "product.created";
+        "product.updated": "product.updated";
+        "product.deleted": "product.deleted";
+        "price.created": "price.created";
+        "price.updated": "price.updated";
+        "coupon.created": "coupon.created";
+        "coupon.updated": "coupon.updated";
+        "coupon.deleted": "coupon.deleted";
+        "promotion_code.created": "promotion_code.created";
+        "promotion_code.updated": "promotion_code.updated";
+        "account.updated": "account.updated";
+        "application_fee.created": "application_fee.created";
+        "application_fee.refunded": "application_fee.refunded";
+        "payout.created": "payout.created";
+        "payout.updated": "payout.updated";
+        "payout.paid": "payout.paid";
+        "payout.failed": "payout.failed";
+        "payout.canceled": "payout.canceled";
+        "balance.available": "balance.available";
+        "checkout.session.completed": "checkout.session.completed";
+        "checkout.session.expired": "checkout.session.expired";
+        "checkout.session.async_payment_succeeded": "checkout.session.async_payment_succeeded";
+        "checkout.session.async_payment_failed": "checkout.session.async_payment_failed";
+        "payment_link.created": "payment_link.created";
+        "payment_link.updated": "payment_link.updated";
+        "reporting.report_run.succeeded": "reporting.report_run.succeeded";
+        "reporting.report_run.failed": "reporting.report_run.failed";
+        "customer.subscription.created": "customer.subscription.created";
+        "customer.subscription.updated": "customer.subscription.updated";
+        "customer.subscription.deleted": "customer.subscription.deleted";
+        "customer.subscription.trial_will_end": "customer.subscription.trial_will_end";
+        "customer.subscription.paused": "customer.subscription.paused";
+        "customer.subscription.resumed": "customer.subscription.resumed";
+        "invoice.created": "invoice.created";
+        "invoice.updated": "invoice.updated";
+        "invoice.deleted": "invoice.deleted";
+        "invoice.finalized": "invoice.finalized";
+        "invoice.paid": "invoice.paid";
+        "invoice.payment_failed": "invoice.payment_failed";
+        "invoice.payment_action_required": "invoice.payment_action_required";
+        "invoice.voided": "invoice.voided";
+        "invoice.marked_uncollectible": "invoice.marked_uncollectible";
+        "invoice.upcoming": "invoice.upcoming";
+        "invoice.sent": "invoice.sent";
+        "invoiceitem.created": "invoiceitem.created";
+        "invoiceitem.deleted": "invoiceitem.deleted";
+        "credit_note.created": "credit_note.created";
+        "credit_note.updated": "credit_note.updated";
+        "credit_note.voided": "credit_note.voided";
+        "test_helpers.test_clock.created": "test_helpers.test_clock.created";
+        "test_helpers.test_clock.advancing": "test_helpers.test_clock.advancing";
+        "test_helpers.test_clock.ready": "test_helpers.test_clock.ready";
+        "test_helpers.test_clock.deleted": "test_helpers.test_clock.deleted";
+        "billing.meter.created": "billing.meter.created";
+        "billing.meter.updated": "billing.meter.updated";
+        "billing.meter.deactivated": "billing.meter.deactivated";
+        "billing.meter.reactivated": "billing.meter.reactivated";
+        "entitlements.active_entitlement_summary.updated": "entitlements.active_entitlement_summary.updated";
+        "billing_portal.configuration.created": "billing_portal.configuration.created";
+        "billing_portal.configuration.updated": "billing_portal.configuration.updated";
+        "billing_portal.session.created": "billing_portal.session.created";
+        "tax.assessment.created": "tax.assessment.created";
+        "tax.review_item.created": "tax.review_item.created";
+        "tax.review_item.updated": "tax.review_item.updated";
+        "webhook_endpoint.test": "webhook_endpoint.test";
+    }>;
+    id: z.ZodString;
+    object: z.ZodLiteral<"event">;
+}, z.core.$strict>;
+/**
+ * The envelope of one event type, `data.object` narrowed to its object: the
+ * request body of that type's webhook in the OpenAPI document.
+ */
+export declare function eventSchemaOf<T extends WebhookEventType>(type: T): z.ZodObject<{
+    data: z.ZodObject<{
+        object: z.ZodLazy<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+        previous_attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>;
+    request: z.ZodObject<{
+        id: z.ZodNullable<z.ZodString>;
+        idempotency_key: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>;
+    created: z.ZodNumber;
+    livemode: z.ZodBoolean;
+    api_version: z.ZodString;
+    account: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<T>;
+    id: z.ZodString;
+    object: z.ZodLiteral<"event">;
+}, z.core.$strict>;
+/** The object an event of an object type carries, as its module registered it. */
+type EventObject<K extends string> = K extends keyof ObjectMap ? ObjectMap[K] : never;
+/**
+ * Which resource each event type carries under `data.object` — TOTAL over
+ * {@link WebhookEventType}, derived from `WEBHOOK_EVENT_OBJECTS`, so a new
+ * event type cannot exist without saying what it delivers.
+ */
+export type WebhookEventPayload = {
+    [T in WebhookEventType]: EventObject<WebhookEventObjectType<T>>;
+};
+type EventEnvelope = z.output<ReturnType<typeof envelope<z.ZodString, z.ZodUnknown>>>;
+/**
+ * One delivered event.
+ *
+ * A DISCRIMINATED union over every event type, so `data.object` is narrowed by
+ * a switch on `type` with no cast:
+ *
+ * ```ts
+ * if (event.type === 'charge.dispute.created') {
+ *   event.data.object.evidence_details; // Dispute, not PaymentIntent
+ * }
+ * ```
+ *
+ * The parameter narrows to a subset of event types —
+ * `WebhookEvent<'payment_intent.succeeded'>` is that event alone.
+ */
+export type WebhookEvent<K extends WebhookEventType = WebhookEventType> = {
+    [T in K]: {
+        [P in keyof EventEnvelope]: P extends 'type' ? T : P extends 'data' ? {
+            object: WebhookEventPayload[T];
+            previous_attributes?: Record<string, unknown>;
+        } : EventEnvelope[P];
+    };
+}[K];
+declare module '../../common/objects' {
+    interface ObjectMap {
+        billing_observation: BillingObservation;
+        event: WebhookEvent;
+    }
+}
+/** An event type filter as the repository reads it; `undefined` is every type. */
+export type EventTypeFilter = {
+    readonly kind: 'exact';
+    readonly type: string;
+} | {
+    readonly kind: 'prefix';
+    readonly prefix: string;
+};
+/** The filters `GET /v1/events` adds to the list parameters. */
+export declare const listEventsFilters: {
+    type: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<{
+        readonly kind: "exact";
+        readonly type: string;
+    } | {
+        readonly kind: "prefix";
+        readonly prefix: string;
+    } | undefined, string>>>;
+    delivery_success: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+        true: "true";
+        false: "false";
+    }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+    payment_intent: z.ZodOptional<z.ZodString>;
+};
+export declare const listEventsQuery: z.ZodObject<{
+    limit: z.ZodPipe<z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>>, z.ZodTransform<number, number | undefined>>;
+    starting_after: z.ZodOptional<z.ZodString>;
+    ending_before: z.ZodOptional<z.ZodString>;
+    created: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>, z.ZodTransform<import("../..").RangeFilter, number>>, z.ZodPipe<z.ZodObject<{
+        gt: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>>;
+        gte: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>>;
+        lt: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>>;
+        lte: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>>;
+    }, z.core.$strict>, z.ZodTransform<import("../..").RangeFilter, {
+        gt?: number | undefined;
+        gte?: number | undefined;
+        lt?: number | undefined;
+        lte?: number | undefined;
+    }>>]>>;
+    expand: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>, z.ZodArray<z.ZodString>>>;
+    type: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<{
+        readonly kind: "exact";
+        readonly type: string;
+    } | {
+        readonly kind: "prefix";
+        readonly prefix: string;
+    } | undefined, string>>>;
+    delivery_success: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+        true: "true";
+        false: "false";
+    }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+    payment_intent: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type ListEventsParams = z.input<typeof listEventsQuery>;
+export declare const retrieveEventQuery: z.ZodObject<{
+    expand: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>, z.ZodArray<z.ZodString>>>;
+}, z.core.$strict>;
+export type RetrieveEventParams = z.input<typeof retrieveEventQuery>;
+/**
+ * The stream's `types`: a comma-separated list of the same filters
+ * (`payment_intent.settled,connected_account.*`). Absent, or any `*`, is every
+ * event.
+ */
+export declare const streamEventsQuery: z.ZodObject<{
+    types: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string[], string>>, z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<{
+        readonly kind: "exact";
+        readonly type: string;
+    } | {
+        readonly kind: "prefix";
+        readonly prefix: string;
+    } | undefined, string>>>>>;
+}, z.core.$strict>;
+export type StreamEventsParams = z.input<typeof streamEventsQuery>;
+/** One line per event type: what happened when it is sent. Total, like the vocabulary. */
+export declare const WEBHOOK_EVENT_DESCRIPTIONS: Readonly<Record<WebhookEventType, string>>;
+export declare const eventRoutes: readonly [{
+    readonly operationId: "listEvents";
+    readonly method: "get";
+    readonly path: "/v1/events";
+    readonly tag: "Events";
+    readonly summary: "List events";
+    readonly description: "Every event of the last 30 days, newest first, rendered exactly as its webhook deliveries carried it.";
+    readonly auth: "service";
+    readonly scope: "payments:read";
+    readonly query: z.ZodObject<{
+        limit: z.ZodPipe<z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>>, z.ZodTransform<number, number | undefined>>;
+        starting_after: z.ZodOptional<z.ZodString>;
+        ending_before: z.ZodOptional<z.ZodString>;
+        created: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>, z.ZodTransform<import("../..").RangeFilter, number>>, z.ZodPipe<z.ZodObject<{
+            gt: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>>;
+            gte: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>>;
+            lt: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>>;
+            lte: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>, z.ZodNumber>>;
+        }, z.core.$strict>, z.ZodTransform<import("../..").RangeFilter, {
+            gt?: number | undefined;
+            gte?: number | undefined;
+            lt?: number | undefined;
+            lte?: number | undefined;
+        }>>]>>;
+        expand: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>, z.ZodArray<z.ZodString>>>;
+        type: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<{
+            readonly kind: "exact";
+            readonly type: string;
+        } | {
+            readonly kind: "prefix";
+            readonly prefix: string;
+        } | undefined, string>>>;
+        delivery_success: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+            true: "true";
+            false: "false";
+        }>]>, z.ZodTransform<boolean, boolean | "true" | "false">>>;
+        payment_intent: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    readonly response: z.ZodObject<{
+        object: z.ZodLiteral<"list">;
+        data: z.ZodArray<z.ZodObject<{
+            data: z.ZodObject<{
+                object: z.ZodUnion<z.ZodLazy<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>[]>;
+                previous_attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strict>;
+            request: z.ZodObject<{
+                id: z.ZodNullable<z.ZodString>;
+                idempotency_key: z.ZodNullable<z.ZodString>;
+            }, z.core.$strict>;
+            created: z.ZodNumber;
+            livemode: z.ZodBoolean;
+            api_version: z.ZodString;
+            account: z.ZodOptional<z.ZodString>;
+            type: z.ZodEnum<{
+                "payment_intent.created": "payment_intent.created";
+                "payment_intent.requires_action": "payment_intent.requires_action";
+                "payment_intent.processing": "payment_intent.processing";
+                "payment_intent.amount_capturable_updated": "payment_intent.amount_capturable_updated";
+                "payment_intent.succeeded": "payment_intent.succeeded";
+                "payment_intent.payment_failed": "payment_intent.payment_failed";
+                "payment_intent.canceled": "payment_intent.canceled";
+                "charge.refunded": "charge.refunded";
+                "charge.dispute.created": "charge.dispute.created";
+                "charge.dispute.updated": "charge.dispute.updated";
+                "charge.dispute.closed": "charge.dispute.closed";
+                "charge.dispute.funds_withdrawn": "charge.dispute.funds_withdrawn";
+                "charge.dispute.funds_reinstated": "charge.dispute.funds_reinstated";
+                "refund.created": "refund.created";
+                "refund.updated": "refund.updated";
+                "refund.failed": "refund.failed";
+                "customer.created": "customer.created";
+                "customer.updated": "customer.updated";
+                "customer.deleted": "customer.deleted";
+                "payment_method.attached": "payment_method.attached";
+                "payment_method.detached": "payment_method.detached";
+                "payment_method.updated": "payment_method.updated";
+                "setup_intent.created": "setup_intent.created";
+                "setup_intent.requires_action": "setup_intent.requires_action";
+                "setup_intent.succeeded": "setup_intent.succeeded";
+                "setup_intent.setup_failed": "setup_intent.setup_failed";
+                "setup_intent.canceled": "setup_intent.canceled";
+                "billing.observation.updated": "billing.observation.updated";
+                "connected_account.updated": "connected_account.updated";
+                "product.created": "product.created";
+                "product.updated": "product.updated";
+                "product.deleted": "product.deleted";
+                "price.created": "price.created";
+                "price.updated": "price.updated";
+                "coupon.created": "coupon.created";
+                "coupon.updated": "coupon.updated";
+                "coupon.deleted": "coupon.deleted";
+                "promotion_code.created": "promotion_code.created";
+                "promotion_code.updated": "promotion_code.updated";
+                "account.updated": "account.updated";
+                "application_fee.created": "application_fee.created";
+                "application_fee.refunded": "application_fee.refunded";
+                "payout.created": "payout.created";
+                "payout.updated": "payout.updated";
+                "payout.paid": "payout.paid";
+                "payout.failed": "payout.failed";
+                "payout.canceled": "payout.canceled";
+                "balance.available": "balance.available";
+                "checkout.session.completed": "checkout.session.completed";
+                "checkout.session.expired": "checkout.session.expired";
+                "checkout.session.async_payment_succeeded": "checkout.session.async_payment_succeeded";
+                "checkout.session.async_payment_failed": "checkout.session.async_payment_failed";
+                "payment_link.created": "payment_link.created";
+                "payment_link.updated": "payment_link.updated";
+                "reporting.report_run.succeeded": "reporting.report_run.succeeded";
+                "reporting.report_run.failed": "reporting.report_run.failed";
+                "customer.subscription.created": "customer.subscription.created";
+                "customer.subscription.updated": "customer.subscription.updated";
+                "customer.subscription.deleted": "customer.subscription.deleted";
+                "customer.subscription.trial_will_end": "customer.subscription.trial_will_end";
+                "customer.subscription.paused": "customer.subscription.paused";
+                "customer.subscription.resumed": "customer.subscription.resumed";
+                "invoice.created": "invoice.created";
+                "invoice.updated": "invoice.updated";
+                "invoice.deleted": "invoice.deleted";
+                "invoice.finalized": "invoice.finalized";
+                "invoice.paid": "invoice.paid";
+                "invoice.payment_failed": "invoice.payment_failed";
+                "invoice.payment_action_required": "invoice.payment_action_required";
+                "invoice.voided": "invoice.voided";
+                "invoice.marked_uncollectible": "invoice.marked_uncollectible";
+                "invoice.upcoming": "invoice.upcoming";
+                "invoice.sent": "invoice.sent";
+                "invoiceitem.created": "invoiceitem.created";
+                "invoiceitem.deleted": "invoiceitem.deleted";
+                "credit_note.created": "credit_note.created";
+                "credit_note.updated": "credit_note.updated";
+                "credit_note.voided": "credit_note.voided";
+                "test_helpers.test_clock.created": "test_helpers.test_clock.created";
+                "test_helpers.test_clock.advancing": "test_helpers.test_clock.advancing";
+                "test_helpers.test_clock.ready": "test_helpers.test_clock.ready";
+                "test_helpers.test_clock.deleted": "test_helpers.test_clock.deleted";
+                "billing.meter.created": "billing.meter.created";
+                "billing.meter.updated": "billing.meter.updated";
+                "billing.meter.deactivated": "billing.meter.deactivated";
+                "billing.meter.reactivated": "billing.meter.reactivated";
+                "entitlements.active_entitlement_summary.updated": "entitlements.active_entitlement_summary.updated";
+                "billing_portal.configuration.created": "billing_portal.configuration.created";
+                "billing_portal.configuration.updated": "billing_portal.configuration.updated";
+                "billing_portal.session.created": "billing_portal.session.created";
+                "tax.assessment.created": "tax.assessment.created";
+                "tax.review_item.created": "tax.review_item.created";
+                "tax.review_item.updated": "tax.review_item.updated";
+                "webhook_endpoint.test": "webhook_endpoint.test";
+            }>;
+            id: z.ZodString;
+            object: z.ZodLiteral<"event">;
+        }, z.core.$strict>>;
+        has_more: z.ZodBoolean;
+        url: z.ZodString;
+    }, z.core.$strict>;
+    readonly sdk: "events.list";
+    readonly expandable: "event";
+}, {
+    readonly operationId: "streamEvents";
+    readonly method: "get";
+    readonly path: "/v1/events/stream";
+    readonly tag: "Events";
+    readonly summary: "Stream events";
+    readonly description: "Server-Sent Events: every event of this merchant as it commits, rendered exactly as a webhook delivery carries it (`event: event`, `id:` the `evt_…`). Resumes after `Last-Event-ID`. Test mode only — what `peable listen` forwards to a local server.";
+    readonly auth: "service";
+    readonly scope: "payments:read";
+    readonly testModeOnly: true;
+    readonly query: z.ZodObject<{
+        types: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string[], string>>, z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<{
+            readonly kind: "exact";
+            readonly type: string;
+        } | {
+            readonly kind: "prefix";
+            readonly prefix: string;
+        } | undefined, string>>>>>;
+    }, z.core.$strict>;
+    readonly response: {
+        readonly kind: "stream";
+        readonly event: z.ZodObject<{
+            data: z.ZodObject<{
+                object: z.ZodUnion<z.ZodLazy<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>[]>;
+                previous_attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strict>;
+            request: z.ZodObject<{
+                id: z.ZodNullable<z.ZodString>;
+                idempotency_key: z.ZodNullable<z.ZodString>;
+            }, z.core.$strict>;
+            created: z.ZodNumber;
+            livemode: z.ZodBoolean;
+            api_version: z.ZodString;
+            account: z.ZodOptional<z.ZodString>;
+            type: z.ZodEnum<{
+                "payment_intent.created": "payment_intent.created";
+                "payment_intent.requires_action": "payment_intent.requires_action";
+                "payment_intent.processing": "payment_intent.processing";
+                "payment_intent.amount_capturable_updated": "payment_intent.amount_capturable_updated";
+                "payment_intent.succeeded": "payment_intent.succeeded";
+                "payment_intent.payment_failed": "payment_intent.payment_failed";
+                "payment_intent.canceled": "payment_intent.canceled";
+                "charge.refunded": "charge.refunded";
+                "charge.dispute.created": "charge.dispute.created";
+                "charge.dispute.updated": "charge.dispute.updated";
+                "charge.dispute.closed": "charge.dispute.closed";
+                "charge.dispute.funds_withdrawn": "charge.dispute.funds_withdrawn";
+                "charge.dispute.funds_reinstated": "charge.dispute.funds_reinstated";
+                "refund.created": "refund.created";
+                "refund.updated": "refund.updated";
+                "refund.failed": "refund.failed";
+                "customer.created": "customer.created";
+                "customer.updated": "customer.updated";
+                "customer.deleted": "customer.deleted";
+                "payment_method.attached": "payment_method.attached";
+                "payment_method.detached": "payment_method.detached";
+                "payment_method.updated": "payment_method.updated";
+                "setup_intent.created": "setup_intent.created";
+                "setup_intent.requires_action": "setup_intent.requires_action";
+                "setup_intent.succeeded": "setup_intent.succeeded";
+                "setup_intent.setup_failed": "setup_intent.setup_failed";
+                "setup_intent.canceled": "setup_intent.canceled";
+                "billing.observation.updated": "billing.observation.updated";
+                "connected_account.updated": "connected_account.updated";
+                "product.created": "product.created";
+                "product.updated": "product.updated";
+                "product.deleted": "product.deleted";
+                "price.created": "price.created";
+                "price.updated": "price.updated";
+                "coupon.created": "coupon.created";
+                "coupon.updated": "coupon.updated";
+                "coupon.deleted": "coupon.deleted";
+                "promotion_code.created": "promotion_code.created";
+                "promotion_code.updated": "promotion_code.updated";
+                "account.updated": "account.updated";
+                "application_fee.created": "application_fee.created";
+                "application_fee.refunded": "application_fee.refunded";
+                "payout.created": "payout.created";
+                "payout.updated": "payout.updated";
+                "payout.paid": "payout.paid";
+                "payout.failed": "payout.failed";
+                "payout.canceled": "payout.canceled";
+                "balance.available": "balance.available";
+                "checkout.session.completed": "checkout.session.completed";
+                "checkout.session.expired": "checkout.session.expired";
+                "checkout.session.async_payment_succeeded": "checkout.session.async_payment_succeeded";
+                "checkout.session.async_payment_failed": "checkout.session.async_payment_failed";
+                "payment_link.created": "payment_link.created";
+                "payment_link.updated": "payment_link.updated";
+                "reporting.report_run.succeeded": "reporting.report_run.succeeded";
+                "reporting.report_run.failed": "reporting.report_run.failed";
+                "customer.subscription.created": "customer.subscription.created";
+                "customer.subscription.updated": "customer.subscription.updated";
+                "customer.subscription.deleted": "customer.subscription.deleted";
+                "customer.subscription.trial_will_end": "customer.subscription.trial_will_end";
+                "customer.subscription.paused": "customer.subscription.paused";
+                "customer.subscription.resumed": "customer.subscription.resumed";
+                "invoice.created": "invoice.created";
+                "invoice.updated": "invoice.updated";
+                "invoice.deleted": "invoice.deleted";
+                "invoice.finalized": "invoice.finalized";
+                "invoice.paid": "invoice.paid";
+                "invoice.payment_failed": "invoice.payment_failed";
+                "invoice.payment_action_required": "invoice.payment_action_required";
+                "invoice.voided": "invoice.voided";
+                "invoice.marked_uncollectible": "invoice.marked_uncollectible";
+                "invoice.upcoming": "invoice.upcoming";
+                "invoice.sent": "invoice.sent";
+                "invoiceitem.created": "invoiceitem.created";
+                "invoiceitem.deleted": "invoiceitem.deleted";
+                "credit_note.created": "credit_note.created";
+                "credit_note.updated": "credit_note.updated";
+                "credit_note.voided": "credit_note.voided";
+                "test_helpers.test_clock.created": "test_helpers.test_clock.created";
+                "test_helpers.test_clock.advancing": "test_helpers.test_clock.advancing";
+                "test_helpers.test_clock.ready": "test_helpers.test_clock.ready";
+                "test_helpers.test_clock.deleted": "test_helpers.test_clock.deleted";
+                "billing.meter.created": "billing.meter.created";
+                "billing.meter.updated": "billing.meter.updated";
+                "billing.meter.deactivated": "billing.meter.deactivated";
+                "billing.meter.reactivated": "billing.meter.reactivated";
+                "entitlements.active_entitlement_summary.updated": "entitlements.active_entitlement_summary.updated";
+                "billing_portal.configuration.created": "billing_portal.configuration.created";
+                "billing_portal.configuration.updated": "billing_portal.configuration.updated";
+                "billing_portal.session.created": "billing_portal.session.created";
+                "tax.assessment.created": "tax.assessment.created";
+                "tax.review_item.created": "tax.review_item.created";
+                "tax.review_item.updated": "tax.review_item.updated";
+                "webhook_endpoint.test": "webhook_endpoint.test";
+            }>;
+            id: z.ZodString;
+            object: z.ZodLiteral<"event">;
+        }, z.core.$strict>;
+    };
+    readonly sdk: "events.stream";
+}, {
+    readonly operationId: "retrieveEvent";
+    readonly method: "get";
+    readonly path: "/v1/events/{id}";
+    readonly tag: "Events";
+    readonly summary: "Retrieve an event";
+    readonly description: "A `404` once the event is older than 30 days.";
+    readonly auth: "service";
+    readonly scope: "payments:read";
+    readonly params: {
+        readonly id: "The event (`evt_…`).";
+    };
+    readonly query: z.ZodObject<{
+        expand: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>, z.ZodArray<z.ZodString>>>;
+    }, z.core.$strict>;
+    readonly response: z.ZodObject<{
+        data: z.ZodObject<{
+            object: z.ZodUnion<z.ZodLazy<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>[]>;
+            previous_attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strict>;
+        request: z.ZodObject<{
+            id: z.ZodNullable<z.ZodString>;
+            idempotency_key: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>;
+        created: z.ZodNumber;
+        livemode: z.ZodBoolean;
+        api_version: z.ZodString;
+        account: z.ZodOptional<z.ZodString>;
+        type: z.ZodEnum<{
+            "payment_intent.created": "payment_intent.created";
+            "payment_intent.requires_action": "payment_intent.requires_action";
+            "payment_intent.processing": "payment_intent.processing";
+            "payment_intent.amount_capturable_updated": "payment_intent.amount_capturable_updated";
+            "payment_intent.succeeded": "payment_intent.succeeded";
+            "payment_intent.payment_failed": "payment_intent.payment_failed";
+            "payment_intent.canceled": "payment_intent.canceled";
+            "charge.refunded": "charge.refunded";
+            "charge.dispute.created": "charge.dispute.created";
+            "charge.dispute.updated": "charge.dispute.updated";
+            "charge.dispute.closed": "charge.dispute.closed";
+            "charge.dispute.funds_withdrawn": "charge.dispute.funds_withdrawn";
+            "charge.dispute.funds_reinstated": "charge.dispute.funds_reinstated";
+            "refund.created": "refund.created";
+            "refund.updated": "refund.updated";
+            "refund.failed": "refund.failed";
+            "customer.created": "customer.created";
+            "customer.updated": "customer.updated";
+            "customer.deleted": "customer.deleted";
+            "payment_method.attached": "payment_method.attached";
+            "payment_method.detached": "payment_method.detached";
+            "payment_method.updated": "payment_method.updated";
+            "setup_intent.created": "setup_intent.created";
+            "setup_intent.requires_action": "setup_intent.requires_action";
+            "setup_intent.succeeded": "setup_intent.succeeded";
+            "setup_intent.setup_failed": "setup_intent.setup_failed";
+            "setup_intent.canceled": "setup_intent.canceled";
+            "billing.observation.updated": "billing.observation.updated";
+            "connected_account.updated": "connected_account.updated";
+            "product.created": "product.created";
+            "product.updated": "product.updated";
+            "product.deleted": "product.deleted";
+            "price.created": "price.created";
+            "price.updated": "price.updated";
+            "coupon.created": "coupon.created";
+            "coupon.updated": "coupon.updated";
+            "coupon.deleted": "coupon.deleted";
+            "promotion_code.created": "promotion_code.created";
+            "promotion_code.updated": "promotion_code.updated";
+            "account.updated": "account.updated";
+            "application_fee.created": "application_fee.created";
+            "application_fee.refunded": "application_fee.refunded";
+            "payout.created": "payout.created";
+            "payout.updated": "payout.updated";
+            "payout.paid": "payout.paid";
+            "payout.failed": "payout.failed";
+            "payout.canceled": "payout.canceled";
+            "balance.available": "balance.available";
+            "checkout.session.completed": "checkout.session.completed";
+            "checkout.session.expired": "checkout.session.expired";
+            "checkout.session.async_payment_succeeded": "checkout.session.async_payment_succeeded";
+            "checkout.session.async_payment_failed": "checkout.session.async_payment_failed";
+            "payment_link.created": "payment_link.created";
+            "payment_link.updated": "payment_link.updated";
+            "reporting.report_run.succeeded": "reporting.report_run.succeeded";
+            "reporting.report_run.failed": "reporting.report_run.failed";
+            "customer.subscription.created": "customer.subscription.created";
+            "customer.subscription.updated": "customer.subscription.updated";
+            "customer.subscription.deleted": "customer.subscription.deleted";
+            "customer.subscription.trial_will_end": "customer.subscription.trial_will_end";
+            "customer.subscription.paused": "customer.subscription.paused";
+            "customer.subscription.resumed": "customer.subscription.resumed";
+            "invoice.created": "invoice.created";
+            "invoice.updated": "invoice.updated";
+            "invoice.deleted": "invoice.deleted";
+            "invoice.finalized": "invoice.finalized";
+            "invoice.paid": "invoice.paid";
+            "invoice.payment_failed": "invoice.payment_failed";
+            "invoice.payment_action_required": "invoice.payment_action_required";
+            "invoice.voided": "invoice.voided";
+            "invoice.marked_uncollectible": "invoice.marked_uncollectible";
+            "invoice.upcoming": "invoice.upcoming";
+            "invoice.sent": "invoice.sent";
+            "invoiceitem.created": "invoiceitem.created";
+            "invoiceitem.deleted": "invoiceitem.deleted";
+            "credit_note.created": "credit_note.created";
+            "credit_note.updated": "credit_note.updated";
+            "credit_note.voided": "credit_note.voided";
+            "test_helpers.test_clock.created": "test_helpers.test_clock.created";
+            "test_helpers.test_clock.advancing": "test_helpers.test_clock.advancing";
+            "test_helpers.test_clock.ready": "test_helpers.test_clock.ready";
+            "test_helpers.test_clock.deleted": "test_helpers.test_clock.deleted";
+            "billing.meter.created": "billing.meter.created";
+            "billing.meter.updated": "billing.meter.updated";
+            "billing.meter.deactivated": "billing.meter.deactivated";
+            "billing.meter.reactivated": "billing.meter.reactivated";
+            "entitlements.active_entitlement_summary.updated": "entitlements.active_entitlement_summary.updated";
+            "billing_portal.configuration.created": "billing_portal.configuration.created";
+            "billing_portal.configuration.updated": "billing_portal.configuration.updated";
+            "billing_portal.session.created": "billing_portal.session.created";
+            "tax.assessment.created": "tax.assessment.created";
+            "tax.review_item.created": "tax.review_item.created";
+            "tax.review_item.updated": "tax.review_item.updated";
+            "webhook_endpoint.test": "webhook_endpoint.test";
+        }>;
+        id: z.ZodString;
+        object: z.ZodLiteral<"event">;
+    }, z.core.$strict>;
+    readonly sdk: "events.retrieve";
+    readonly expandable: "event";
+}];
+export {};