@usethrottle/webhook-types 0.2.0 → 0.3.0

package/dist/index.d.ts

@@ -2,17 +2,104 @@
  * @usethrottle/webhook-types
  *
  * TypeScript discriminated unions for every Throttle outbound webhook event.
- * Keyed by `event.type`, this lets your handler narrow `event.data` without
- * casts or `Record<string, unknown>` ceremony.
+ * Keyed by `event.type` (legacy) or top-level `type` (ThrottleEventEnvelope),
+ * this lets your handler narrow the payload without casts.
  *
- * Coverage: all 69 outbound event types are enumerated in `WebhookEventType`.
- * Payload shapes are typed for the 24 most-integrated events (cart, order,
- * payment, fulfillment, subscription core lifecycle). The remaining events
- * resolve to `data: Record<string, unknown>` until typed in a future release.
+ * Coverage: all 68 outbound event types emitted by the Throttle outbound bus
+ * are enumerated in `WebhookEventType`. The most-integrated events (cart,
+ * checkout, order, payment, fulfillment, subscription, customer core lifecycle)
+ * get typed `data` shapes. The remaining events resolve to
+ * `data: Record<string, unknown>`.
  *
- * Tracks the canonical event registry in `@platform/webhooks` so adding a new
- * event type there is a compile-time error here until the union is updated.
+ * Source of truth: `packages/platform-webhooks/src/outbound/events.ts` in the
+ * Throttle monorepo. The event registry there is the only place event names
+ * are allowed to be added; this package mirrors that file.
+ *
+ * Includes a Stripe-compatible signature verification helper.
+ *
+ * ## Wire format (ThrottleEventEnvelope)
+ *
+ * The outbound worker (`packages/platform-webhooks/src/outbound/dispatcher.ts`)
+ * delivers the following flat JSON body to your endpoint:
+ *
+ * ```json
+ * {
+ *   "id": "<uuid-v7>",
+ *   "type": "<event-type>",
+ *   "version": "1",
+ *   "createdAt": "<ISO-8601>",
+ *   "mode": "test" | "live",
+ *   "workspaceId": "<ws_...>",
+ *   "data": { ... }
+ * }
+ * ```
+ *
+ * `version` is `'1'` for all currently-defined events; Throttle will increment
+ * it on breaking payload changes. `mode` disambiguates test vs live deliveries —
+ * a single extension `webhookUrl` can receive both from separate per-mode installs.
+ * The internal `isTest` flag is used for endpoint routing only and is not present
+ * in the delivered body. `applicationId` is also not exposed at the envelope level.
+ *
+ * **Existing `WebhookEnvelope` consumers are unaffected** — the `event:
+ * { type, data }` nesting in that type is an in-memory representation only.
+ * The wire format flattens `type` and `data` to the top level of the envelope.
+ *
+ * The legacy `WebhookEnvelope` type (with its `event: { type, data }` nesting)
+ * is retained for back-compat and describes the in-memory representation used
+ * by internal consumers; external integrations should use `ThrottleEventEnvelope`.
+ */
+/**
+ * Versioned event envelope for webhook consumers and extension handlers.
+ * The `type` field is the discriminant key — cast to `ThrottleEvent` to
+ * narrow `data` without specifying the generic parameters:
+ *
+ * ```ts
+ * import type { ThrottleEvent, ThrottleEventOfType } from '@usethrottle/webhook-types';
+ *
+ * app.post('/webhook', (req, res) => {
+ *   const event = req.body as ThrottleEvent;
+ *   switch (event.type) {
+ *     case 'order.created':
+ *       console.log(event.data.order);  // typed as OrderCreatedData['order']
+ *       break;
+ *     case 'payment.captured':
+ *       console.log(event.data.paymentId, event.data.amount);
+ *       break;
+ *   }
+ * });
+ *
+ * // Or for a single-event handler:
+ * function onOrderCreated(ev: ThrottleEventOfType<'order.created'>) {
+ *   console.log(ev.data.order);
+ * }
+ * ```
+ *
+ * @typeParam TType - The event type string literal, e.g. `'order.created'`
+ * @typeParam TData - The typed `data` payload for this event type
  */
+export interface ThrottleEventEnvelope<TType extends string = string, TData = unknown> {
+    /** Stable event identifier (UUID v7). */
+    id: string;
+    /** Event type string — use this to narrow the `data` payload. */
+    type: TType;
+    /**
+     * Payload schema version. Currently `'1'` for all events.
+     * Throttle will increment this when a breaking field change lands.
+     */
+    version: string;
+    /** ISO 8601 UTC timestamp the event was emitted. */
+    createdAt: string;
+    /**
+     * Whether the event originated from test-mode or live-mode resources.
+     * Test endpoints (`isTest=true`) only receive `'test'` events;
+     * live endpoints only receive `'live'` events.
+     */
+    mode: 'test' | 'live';
+    /** Workspace that owns the event source (e.g. `"ws_..."`). */
+    workspaceId: string;
+    /** Typed event payload — shape depends on `type`. */
+    data: TData;
+}
 export interface WebhookEnvelope<T extends WebhookEvent = WebhookEvent> {
     /** Stable event identifier (UUID v7). */
     id: string;
@@ -30,24 +117,25 @@ export interface WebhookEnvelope<T extends WebhookEvent = WebhookEvent> {
     /** Discriminated union — narrow by `event.type`. */
     event: T;
 }
-export interface MoneyAmount {
-    amount: number;
-    currency: string;
-}
+type CartId = string;
+type OrderId = string;
+type PaymentId = string;
+type SubscriptionId = string;
+type CustomerId = string;
 export interface CartCreatedData {
-    cartId: string;
+    cartId: CartId;
     sequence: number;
     applicationId: string;
     customerId: string | null;
     currency: string;
 }
 export interface CartUpdatedData {
-    cartId: string;
+    cartId: CartId;
     sequence: number;
     changedFields: string[];
 }
 export interface CartItemAddedData {
-    cartId: string;
+    cartId: CartId;
     sequence: number;
     itemId: string;
     name: string;
@@ -55,146 +143,357 @@ export interface CartItemAddedData {
     unitPrice: number;
 }
 export interface CartItemUpdatedData {
-    cartId: string;
+    cartId: CartId;
     sequence: number;
     itemId: string;
     quantity: number;
     unitPrice: number;
 }
 export interface CartItemRemovedData {
-    cartId: string;
+    cartId: CartId;
     sequence: number;
     itemId: string;
 }
 export interface CartShippingSelectedData {
-    cartId: string;
+    cartId: CartId;
     sequence: number;
     methodId: string;
     displayName: string;
     rateAmount: number;
     currency: string;
 }
+export interface CartShippingClearedData {
+    cartId: CartId;
+    sequence: number;
+}
 export interface CartDiscountAppliedData {
-    cartId: string;
+    cartId: CartId;
     sequence: number;
     code: string;
     amount: number;
     type: 'percentage' | 'fixed_amount';
     discountTotal: number;
 }
+export interface CartDiscountRemovedData {
+    cartId: CartId;
+    sequence: number;
+}
+export interface CartTaxRecomputedData {
+    cartId: CartId;
+    sequence: number;
+    lineCount: number;
+}
+export interface CartCheckoutStartedData {
+    cartId: CartId;
+    sequence: number;
+}
+export interface CartConvertedData {
+    cartId: CartId;
+    sequence: number;
+}
+export interface CartAbandonedData {
+    cartId: CartId;
+    sequence: number;
+}
+export interface CartExpiredData {
+    cartId: CartId;
+    sequence: number;
+}
+export interface CartMergedData {
+    cartId: CartId;
+    sequence: number;
+    fromCartId: CartId;
+    toCustomerId: CustomerId;
+}
+export interface CheckoutSessionCreatedData {
+    checkoutSessionId: string;
+    cartId?: CartId | null;
+    applicationId: string;
+    customerId?: CustomerId | null;
+}
+export interface CheckoutSessionCompletedData {
+    checkoutSessionId: string;
+    orderId?: OrderId | null;
+    customerId?: CustomerId | null;
+}
+type OrderRow = Record<string, unknown>;
 export interface OrderCreatedData {
-    orderId: string;
-    orderNumber: string;
-    customerId: string | null;
-    currency: string;
-    total: number;
-    status: 'draft' | 'pending' | 'paid' | 'cancelled' | 'refunded';
+    order: OrderRow;
+    fromCart?: {
+        id: CartId;
+    };
+    sessionId?: string;
 }
-export interface OrderUpdatedData {
-    orderId: string;
-    changedFields: string[];
+export interface OrderStatusTransitionData {
+    order: OrderRow;
+    status: string;
+    previousStatus: string;
+    action: string;
+    reason?: string | null;
 }
-export interface OrderCancelledData {
-    orderId: string;
-    reason: string | null;
+export interface OrderSyncFailedData {
+    mappingId: string;
+    connectionId: string;
+    externalId: string;
+    attempts: number;
+    error: string;
 }
-export interface OrderFulfilledData {
-    orderId: string;
-    fulfillmentId: string;
+export interface OrderSyncConflictData {
+    externalStatus: string;
+    throttleStatus: string;
+    dimension: string;
 }
-export interface PaymentCreatedData {
-    paymentId: string;
-    orderId: string | null;
+type PaymentRow = Record<string, unknown>;
+/** payment.pending / payment.authorized / payment.voided — embed the full payment row. */
+export interface PaymentEnvelopeData {
+    payment: PaymentRow;
+}
+export interface PaymentAuthorizationFailedData {
+    payment: PaymentRow;
+    errorCode: string;
+    errorMessage: string;
+}
+/** payment.captured — flat payload with monetary fields. */
+export interface PaymentCapturedData {
+    paymentId: PaymentId;
+    orderId: OrderId | null;
     amount: number;
     currency: string;
-    status: 'pending' | 'authorized' | 'captured' | 'failed' | 'refunded' | 'voided';
+    processor?: string | null;
+    processorTransactionId?: string | null;
+    gr4vyTransactionId?: string | null;
+    metadata?: Record<string, unknown> | null;
 }
-export interface PaymentCapturedData {
-    paymentId: string;
-    orderId: string | null;
+export interface PaymentCaptureFailedData {
+    paymentId: PaymentId;
+    orderId: OrderId | null;
     amount: number;
     currency: string;
+    errorCode: string;
+    errorMessage: string;
 }
+/** payment.failed — terminal failure/decline from the processor. */
 export interface PaymentFailedData {
-    paymentId: string;
-    orderId: string | null;
-    code: string;
-    message: string;
+    paymentId: PaymentId;
+    orderId: OrderId | null;
+    amount?: number | null;
+    currency?: string | null;
+    code?: string | null;
+    message?: string | null;
+    errorCode?: string | null;
+    errorMessage?: string | null;
 }
+export interface PaymentVoidFailedData {
+    payment: PaymentRow;
+    errorCode: string;
+    errorMessage: string;
+}
+/** payment.refunded / payment.partially_refunded — flat refund payload. */
 export interface PaymentRefundedData {
-    paymentId: string;
-    refundId: string;
+    paymentId: PaymentId;
+    orderId: OrderId | null;
+    refundedAmount: number;
+    paymentAmount: number;
+    currency: string;
+    status?: string | null;
+    processor?: string | null;
+    gr4vyRefundId?: string | null;
+}
+/** payment.refund_failed */
+export interface PaymentRefundFailedData {
+    paymentId: PaymentId;
+    orderId: OrderId | null;
     amount: number;
     currency: string;
+    gr4vyRefundId?: string | null;
+    errorCode?: string | null;
+    errorMessage?: string | null;
 }
-export interface FulfillmentCreatedData {
-    fulfillmentId: string;
-    orderId: string;
-    type: 'shipment' | 'digital' | 'access' | 'service' | 'in_person';
-    status: 'pending' | 'in_progress' | 'fulfilled' | 'cancelled';
+/** payment.vaulted — a reusable payment method was stored at checkout. */
+export interface PaymentVaultedData {
+    customerId: CustomerId;
+    paymentMethodId: string;
+    gr4vyBuyerId: string;
+    processor: string;
+    checkoutSessionId: string;
+    recurring?: boolean | null;
 }
-export interface FulfillmentShippedData {
-    fulfillmentId: string;
-    orderId: string;
-    trackingNumber: string | null;
-    carrier: string | null;
+export interface PaymentDisputedData {
+    paymentId: PaymentId;
+    reason: string;
+    openedAt: string;
 }
-export interface FulfillmentDeliveredData {
-    fulfillmentId: string;
-    orderId: string;
-    deliveredAt: string;
+export interface PaymentDisputeClearedData {
+    paymentId: PaymentId;
+}
+type FulfillmentRow = Record<string, unknown>;
+type ShipmentRow = Record<string, unknown>;
+export interface FulfillmentEnvelopeData {
+    fulfillment: FulfillmentRow;
+    order: {
+        id: OrderId;
+    };
+}
+export interface FulfillmentShipmentShippedData {
+    fulfillment: FulfillmentRow;
+    shipment: ShipmentRow;
+    order: {
+        id: OrderId;
+    };
 }
-export interface SubscriptionCreatedData {
-    subscriptionId: string;
-    customerId: string;
-    planReference: string;
-    status: 'active' | 'trialing' | 'past_due' | 'cancelled' | 'paused';
-    currentPeriodStart: string;
-    currentPeriodEnd: string;
+/** fulfillment.digital.delivered — digital asset was delivered to the customer. */
+export interface FulfillmentDigitalDeliveredData {
+    fulfillment: FulfillmentRow;
+    order: {
+        id: OrderId;
+    };
+}
+type SubscriptionRow = Record<string, unknown>;
+type PaymentMethodRow = Record<string, unknown>;
+type WorkspaceRow = Record<string, unknown>;
+type ChargeRow = Record<string, unknown>;
+type InvoiceRow = Record<string, unknown>;
+export interface SubscriptionEnvelopeData {
+    subscription: SubscriptionRow;
 }
 export interface SubscriptionUpdatedData {
-    subscriptionId: string;
-    changedFields: string[];
+    subscription: SubscriptionRow;
+    cancelAtPeriodEnd?: boolean;
 }
 export interface SubscriptionCancelledData {
-    subscriptionId: string;
-    cancelledAt: string;
-    reason: string | null;
+    subscription: SubscriptionRow;
+    reason?: string | null;
+    atPeriodEnd?: boolean;
+    lastError?: string | null;
 }
 export interface SubscriptionRenewedData {
-    subscriptionId: string;
-    currentPeriodStart: string;
-    currentPeriodEnd: string;
+    subscription: SubscriptionRow;
+    payment?: PaymentRow;
+    order?: OrderRow;
+    freeRenewal?: boolean;
 }
-export interface CustomerCreatedData {
-    customerId: string;
-    email: string | null;
-    externalId: string | null;
+export interface SubscriptionPaymentFailedData {
+    subscription: SubscriptionRow;
+    attempt: number;
+    nextRetryAt: string | null;
+    lastError: string;
 }
-export interface CustomerUpdatedData {
-    customerId: string;
-    changedFields: string[];
+export interface SubscriptionTrialBlockedData {
+    subscriptionId: SubscriptionId;
+    customerId: CustomerId;
+    paymentMethodId: string;
+    reason: string;
+    requestedTrialDays: number;
+}
+type CustomerRow = Record<string, unknown>;
+type CartRow = Record<string, unknown>;
+export interface DiscountAppliedData {
+    cart: CartRow;
+    code: string;
+    cartId: CartId;
+}
+export interface DiscountRemovedData {
+    cart: CartRow;
+    cartId: CartId;
+}
+export interface CustomerEnvelopeData {
+    customer: CustomerRow;
+}
+export interface CustomerPaymentMethodData {
+    paymentMethod: PaymentMethodRow;
+}
+export interface ShippingTaxProviderUnhealthyData {
+    connection_id: string;
+    axis: 'shipping' | 'tax';
+    provider: string;
+    environment: string;
+    application_id: string;
+    workspace_id: string;
+    consecutive_failures: number;
+    last_error_reason: string | null;
+    last_error_detail: string | null;
+    last_error_at: string;
+    fallback_policy: string;
+}
+export interface WorkspacePaymentMethodData {
+    workspace: WorkspaceRow;
+    paymentMethod: PaymentMethodRow;
+}
+export interface WorkspaceDefaultPaymentMethodChangedData {
+    workspace: WorkspaceRow;
+    paymentMethod: PaymentMethodRow;
+    previousPaymentMethod?: PaymentMethodRow | null;
+}
+export interface WorkspaceBackupPmUsedData {
+    workspace: WorkspaceRow;
+    primaryPaymentMethod: PaymentMethodRow;
+    backupPaymentMethod: PaymentMethodRow;
+    charge: ChargeRow;
+}
+export interface WorkspacePlatformChargeSucceededData {
+    workspace: WorkspaceRow;
+    invoice: InvoiceRow;
+    charge: ChargeRow;
+}
+export interface WorkspacePlatformChargeFailedData {
+    workspace: WorkspaceRow;
+    charge: ChargeRow;
+    error: string;
+}
+export interface WorkspaceTrialExpiredData {
+    workspace: WorkspaceRow;
+    expiredAt: string;
+}
+export interface InvoicePastDueData {
+    paymentId: string;
+    orderId: string;
+    invoiceNumber?: string | null;
+    daysPastDue: number;
+    tickFired: string;
+    dueDate: string;
+    totalAmount: number;
+    currency: string;
 }
 type Event<T extends string, D> = {
     type: T;
     data: D;
 };
-export type WebhookEvent = Event<'cart.created', CartCreatedData> | Event<'cart.updated', CartUpdatedData> | Event<'cart.item_added', CartItemAddedData> | Event<'cart.item_updated', CartItemUpdatedData> | Event<'cart.item_removed', CartItemRemovedData> | Event<'cart.shipping_selected', CartShippingSelectedData> | Event<'cart.shipping_cleared', {
-    cartId: string;
-    sequence: number;
-}> | Event<'cart.discount_applied', CartDiscountAppliedData> | Event<'cart.discount_removed', {
-    cartId: string;
-    sequence: number;
-}> | Event<'cart.tax_recomputed', {
-    cartId: string;
-    sequence: number;
-    lineCount: number;
-}> | Event<'order.created', OrderCreatedData> | Event<'order.updated', OrderUpdatedData> | Event<'order.cancelled', OrderCancelledData> | Event<'order.fulfilled', OrderFulfilledData> | Event<'payment.created', PaymentCreatedData> | Event<'payment.authorized', PaymentCreatedData> | Event<'payment.captured', PaymentCapturedData> | Event<'payment.failed', PaymentFailedData> | Event<'payment.refunded', PaymentRefundedData> | Event<'payment.voided', PaymentCreatedData> | Event<'fulfillment.created', FulfillmentCreatedData> | Event<'fulfillment.shipped', FulfillmentShippedData> | Event<'fulfillment.delivered', FulfillmentDeliveredData> | Event<'fulfillment.cancelled', {
-    fulfillmentId: string;
-    orderId: string;
-}> | Event<'subscription.created', SubscriptionCreatedData> | Event<'subscription.updated', SubscriptionUpdatedData> | Event<'subscription.cancelled', SubscriptionCancelledData> | Event<'subscription.renewed', SubscriptionRenewedData> | Event<'customer.created', CustomerCreatedData> | Event<'customer.updated', CustomerUpdatedData> | Event<Exclude<WebhookEventType, TypedEventType>, Record<string, unknown>>;
-type TypedEventType = 'cart.created' | 'cart.updated' | 'cart.item_added' | 'cart.item_updated' | 'cart.item_removed' | 'cart.shipping_selected' | 'cart.shipping_cleared' | 'cart.discount_applied' | 'cart.discount_removed' | 'cart.tax_recomputed' | 'order.created' | 'order.updated' | 'order.cancelled' | 'order.fulfilled' | 'payment.created' | 'payment.authorized' | 'payment.captured' | 'payment.failed' | 'payment.refunded' | 'payment.voided' | 'fulfillment.created' | 'fulfillment.shipped' | 'fulfillment.delivered' | 'fulfillment.cancelled' | 'subscription.created' | 'subscription.updated' | 'subscription.cancelled' | 'subscription.renewed' | 'customer.created' | 'customer.updated';
-export type WebhookEventType = 'cart.created' | 'cart.updated' | 'cart.item_added' | 'cart.item_updated' | 'cart.item_removed' | 'cart.shipping_selected' | 'cart.shipping_cleared' | 'cart.discount_applied' | 'cart.discount_removed' | 'cart.tax_recomputed' | 'cart.checked_out' | 'order.created' | 'order.updated' | 'order.cancelled' | 'order.refunded' | 'order.fulfilled' | 'order.completed' | 'payment.created' | 'payment.authorized' | 'payment.captured' | 'payment.failed' | 'payment.refunded' | 'payment.voided' | 'payment.pending' | 'fulfillment.created' | 'fulfillment.shipped' | 'fulfillment.delivered' | 'fulfillment.cancelled' | 'fulfillment.access_granted' | 'fulfillment.access_revoked' | 'subscription.created' | 'subscription.updated' | 'subscription.cancelled' | 'subscription.renewed' | 'subscription.trial_ending' | 'subscription.trial_ended' | 'subscription.past_due' | 'subscription.recovered' | 'subscription.paused' | 'subscription.resumed' | 'discount.created' | 'discount.updated' | 'discount.archived' | 'discount.redeemed' | 'customer.created' | 'customer.updated' | 'customer.deleted' | 'invoice.created' | 'invoice.paid' | 'invoice.overdue' | 'invoice.disputed' | 'invoice.refunded' | 'invoice.aged' | 'shipping.rate_calculated' | 'tax.calculated' | 'tax.recalculated' | 'workspace.payment_method.added' | 'workspace.payment_method.removed' | 'workspace.payment_method.set_default' | 'workspace.payment_method.set_backup' | 'platform.invoice.created' | 'platform.invoice.paid' | 'platform.invoice.failed' | 'platform.charge.refunded' | 'workspace.created' | 'workspace.trial_started' | 'workspace.trial_ending' | 'workspace.trial_ended' | 'workspace.subscribed';
+export type WebhookEvent = Event<'cart.created', CartCreatedData> | Event<'cart.updated', CartUpdatedData> | Event<'cart.item_added', CartItemAddedData> | Event<'cart.item_updated', CartItemUpdatedData> | Event<'cart.item_removed', CartItemRemovedData> | Event<'cart.shipping_selected', CartShippingSelectedData> | Event<'cart.shipping_cleared', CartShippingClearedData> | Event<'cart.discount_applied', CartDiscountAppliedData> | Event<'cart.discount_removed', CartDiscountRemovedData> | Event<'cart.tax_recomputed', CartTaxRecomputedData> | Event<'cart.checkout_started', CartCheckoutStartedData> | Event<'cart.converted', CartConvertedData> | Event<'cart.abandoned', CartAbandonedData> | Event<'cart.expired', CartExpiredData> | Event<'cart.merged', CartMergedData> | Event<'checkout.session.created', CheckoutSessionCreatedData> | Event<'checkout.session.completed', CheckoutSessionCompletedData> | Event<'order.created', OrderCreatedData> | Event<'order.updated', OrderStatusTransitionData> | Event<'order.completed', OrderStatusTransitionData> | Event<'order.cancelled', OrderStatusTransitionData> | Event<'order.closed', OrderStatusTransitionData> | Event<'order.sync_failed', OrderSyncFailedData> | Event<'order.sync_conflict', OrderSyncConflictData> | Event<'payment.pending', PaymentEnvelopeData> | Event<'payment.authorized', PaymentEnvelopeData> | Event<'payment.authorization_failed', PaymentAuthorizationFailedData> | Event<'payment.captured', PaymentCapturedData> | Event<'payment.capture_failed', PaymentCaptureFailedData> | Event<'payment.failed', PaymentFailedData> | Event<'payment.voided', PaymentEnvelopeData> | Event<'payment.void_failed', PaymentVoidFailedData> | Event<'payment.refunded', PaymentRefundedData> | Event<'payment.partially_refunded', PaymentRefundedData> | Event<'payment.refund_failed', PaymentRefundFailedData> | Event<'payment.vaulted', PaymentVaultedData> | Event<'payment.disputed', PaymentDisputedData> | Event<'payment.dispute_cleared', PaymentDisputeClearedData> | Event<'fulfillment.created', FulfillmentEnvelopeData> | Event<'fulfillment.completed', FulfillmentEnvelopeData> | Event<'fulfillment.cancelled', FulfillmentEnvelopeData> | Event<'fulfillment.shipment.shipped', FulfillmentShipmentShippedData> | Event<'fulfillment.shipment.delivered', FulfillmentEnvelopeData> | Event<'fulfillment.digital.delivered', FulfillmentDigitalDeliveredData> | Event<'subscription.created', SubscriptionEnvelopeData> | Event<'subscription.activated', SubscriptionEnvelopeData> | Event<'subscription.updated', SubscriptionUpdatedData> | Event<'subscription.paused', SubscriptionEnvelopeData> | Event<'subscription.resumed', SubscriptionEnvelopeData> | Event<'subscription.cancelled', SubscriptionCancelledData> | Event<'subscription.renewed', SubscriptionRenewedData> | Event<'subscription.past_due', SubscriptionEnvelopeData> | Event<'subscription.payment_failed', SubscriptionPaymentFailedData> | Event<'subscription.create_failed', SubscriptionEnvelopeData> | Event<'subscription.trial_blocked', SubscriptionTrialBlockedData> | Event<'discount.applied', DiscountAppliedData> | Event<'discount.removed', DiscountRemovedData> | Event<'customer.created', CustomerEnvelopeData> | Event<'customer.updated', CustomerEnvelopeData> | Event<'customer.deleted', CustomerEnvelopeData> | Event<'customer.payment_method_added', CustomerPaymentMethodData> | Event<'customer.payment_method_removed', CustomerPaymentMethodData> | Event<'invoice.past_due', InvoicePastDueData> | Event<'shipping_tax.provider_connection.unhealthy', ShippingTaxProviderUnhealthyData> | Event<'workspace.payment_method.added', WorkspacePaymentMethodData> | Event<'workspace.payment_method.removed', WorkspacePaymentMethodData> | Event<'workspace.payment_method.default_changed', WorkspaceDefaultPaymentMethodChangedData> | Event<'workspace.payment_method.backup_set', WorkspacePaymentMethodData> | Event<'workspace.payment_method.backup_used', WorkspaceBackupPmUsedData> | Event<'workspace.platform_charge.succeeded', WorkspacePlatformChargeSucceededData> | Event<'workspace.platform_charge.failed', WorkspacePlatformChargeFailedData> | Event<'workspace.trial_expired', WorkspaceTrialExpiredData>;
+/** Union of every event type string emitted by the Throttle outbound bus. */
+export type WebhookEventType = WebhookEvent['type'];
+/**
+ * A `ThrottleEventEnvelope` over the full `WebhookEvent` discriminated union.
+ * Cast incoming webhook bodies to this type and switch on `event.type` to
+ * get fully-narrowed `event.data` access with no explicit casts.
+ *
+ * ```ts
+ * const event = req.body as ThrottleEvent;
+ * if (event.type === 'order.created') {
+ *   // event.data is OrderCreatedData here
+ * }
+ * ```
+ */
+export type ThrottleEvent = {
+    [E in WebhookEvent as E['type']]: ThrottleEventEnvelope<E['type'], E['data']>;
+}[WebhookEvent['type']];
+/**
+ * Narrows a `ThrottleEvent` to a specific event type.
+ * Useful for single-event handler signatures:
+ *
+ * ```ts
+ * function onPaymentCaptured(ev: ThrottleEventOfType<'payment.captured'>) {
+ *   console.log(ev.data.paymentId, ev.data.amount);
+ * }
+ * ```
+ */
+export type ThrottleEventOfType<T extends WebhookEventType> = Extract<ThrottleEvent, {
+    type: T;
+}>;
+/** Runtime mirror of the WebhookEvent union — keep in lockstep with it.
+ *  The `satisfies` clause makes tsc fail if a string is not a real union member.
+ *  The parity test (event-parity.test.ts) makes it fail if any entry is missing
+ *  from the @core/scopes canonical registry. */
+export declare const WEBHOOK_EVENT_TYPES: readonly ["cart.created", "cart.updated", "cart.item_added", "cart.item_updated", "cart.item_removed", "cart.shipping_selected", "cart.shipping_cleared", "cart.discount_applied", "cart.discount_removed", "cart.tax_recomputed", "cart.checkout_started", "cart.converted", "cart.abandoned", "cart.expired", "cart.merged", "checkout.session.created", "checkout.session.completed", "order.created", "order.updated", "order.completed", "order.cancelled", "order.closed", "order.sync_failed", "order.sync_conflict", "payment.pending", "payment.authorized", "payment.authorization_failed", "payment.captured", "payment.capture_failed", "payment.failed", "payment.voided", "payment.void_failed", "payment.refunded", "payment.partially_refunded", "payment.refund_failed", "payment.vaulted", "payment.disputed", "payment.dispute_cleared", "fulfillment.created", "fulfillment.completed", "fulfillment.cancelled", "fulfillment.shipment.shipped", "fulfillment.shipment.delivered", "fulfillment.digital.delivered", "subscription.created", "subscription.activated", "subscription.updated", "subscription.paused", "subscription.resumed", "subscription.cancelled", "subscription.renewed", "subscription.past_due", "subscription.payment_failed", "subscription.create_failed", "subscription.trial_blocked", "discount.applied", "discount.removed", "customer.created", "customer.updated", "customer.deleted", "customer.payment_method_added", "customer.payment_method_removed", "invoice.past_due", "shipping_tax.provider_connection.unhealthy", "workspace.payment_method.added", "workspace.payment_method.removed", "workspace.payment_method.default_changed", "workspace.payment_method.backup_set", "workspace.payment_method.backup_used", "workspace.platform_charge.succeeded", "workspace.platform_charge.failed", "workspace.trial_expired"];
 /**
  * Verifies the `Throttle-Signature` header against the raw request body.
  * Use this from your webhook handler BEFORE parsing the JSON.

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -2,21 +2,102 @@
  * @usethrottle/webhook-types
  *
  * TypeScript discriminated unions for every Throttle outbound webhook event.
- * Keyed by `event.type`, this lets your handler narrow `event.data` without
- * casts or `Record<string, unknown>` ceremony.
+ * Keyed by `event.type` (legacy) or top-level `type` (ThrottleEventEnvelope),
+ * this lets your handler narrow the payload without casts.
  *
- * Coverage: all 69 outbound event types are enumerated in `WebhookEventType`.
- * Payload shapes are typed for the 24 most-integrated events (cart, order,
- * payment, fulfillment, subscription core lifecycle). The remaining events
- * resolve to `data: Record<string, unknown>` until typed in a future release.
+ * Coverage: all 68 outbound event types emitted by the Throttle outbound bus
+ * are enumerated in `WebhookEventType`. The most-integrated events (cart,
+ * checkout, order, payment, fulfillment, subscription, customer core lifecycle)
+ * get typed `data` shapes. The remaining events resolve to
+ * `data: Record<string, unknown>`.
  *
- * Tracks the canonical event registry in `@platform/webhooks` so adding a new
- * event type there is a compile-time error here until the union is updated.
+ * Source of truth: `packages/platform-webhooks/src/outbound/events.ts` in the
+ * Throttle monorepo. The event registry there is the only place event names
+ * are allowed to be added; this package mirrors that file.
+ *
+ * Includes a Stripe-compatible signature verification helper.
+ *
+ * ## Wire format (ThrottleEventEnvelope)
+ *
+ * The outbound worker (`packages/platform-webhooks/src/outbound/dispatcher.ts`)
+ * delivers the following flat JSON body to your endpoint:
+ *
+ * ```json
+ * {
+ *   "id": "<uuid-v7>",
+ *   "type": "<event-type>",
+ *   "version": "1",
+ *   "createdAt": "<ISO-8601>",
+ *   "mode": "test" | "live",
+ *   "workspaceId": "<ws_...>",
+ *   "data": { ... }
+ * }
+ * ```
+ *
+ * `version` is `'1'` for all currently-defined events; Throttle will increment
+ * it on breaking payload changes. `mode` disambiguates test vs live deliveries —
+ * a single extension `webhookUrl` can receive both from separate per-mode installs.
+ * The internal `isTest` flag is used for endpoint routing only and is not present
+ * in the delivered body. `applicationId` is also not exposed at the envelope level.
+ *
+ * **Existing `WebhookEnvelope` consumers are unaffected** — the `event:
+ * { type, data }` nesting in that type is an in-memory representation only.
+ * The wire format flattens `type` and `data` to the top level of the envelope.
+ *
+ * The legacy `WebhookEnvelope` type (with its `event: { type, data }` nesting)
+ * is retained for back-compat and describes the in-memory representation used
+ * by internal consumers; external integrations should use `ThrottleEventEnvelope`.
  */
+import { createHmac, timingSafeEqual } from 'node:crypto';
+/** Runtime mirror of the WebhookEvent union — keep in lockstep with it.
+ *  The `satisfies` clause makes tsc fail if a string is not a real union member.
+ *  The parity test (event-parity.test.ts) makes it fail if any entry is missing
+ *  from the @core/scopes canonical registry. */
+export const WEBHOOK_EVENT_TYPES = [
+    // Cart
+    'cart.created', 'cart.updated', 'cart.item_added', 'cart.item_updated', 'cart.item_removed',
+    'cart.shipping_selected', 'cart.shipping_cleared', 'cart.discount_applied', 'cart.discount_removed',
+    'cart.tax_recomputed', 'cart.checkout_started', 'cart.converted', 'cart.abandoned', 'cart.expired', 'cart.merged',
+    // Checkout session
+    'checkout.session.created', 'checkout.session.completed',
+    // Order
+    'order.created', 'order.updated', 'order.completed', 'order.cancelled', 'order.closed',
+    'order.sync_failed', 'order.sync_conflict',
+    // Payment
+    'payment.pending', 'payment.authorized', 'payment.authorization_failed', 'payment.captured',
+    'payment.capture_failed', 'payment.failed', 'payment.voided', 'payment.void_failed',
+    'payment.refunded', 'payment.partially_refunded', 'payment.refund_failed', 'payment.vaulted',
+    'payment.disputed', 'payment.dispute_cleared',
+    // Fulfillment
+    'fulfillment.created', 'fulfillment.completed', 'fulfillment.cancelled',
+    'fulfillment.shipment.shipped', 'fulfillment.shipment.delivered',
+    'fulfillment.digital.delivered',
+    // Subscription
+    'subscription.created', 'subscription.activated', 'subscription.updated', 'subscription.paused',
+    'subscription.resumed', 'subscription.cancelled', 'subscription.renewed', 'subscription.past_due',
+    'subscription.payment_failed', 'subscription.create_failed', 'subscription.trial_blocked',
+    // Discount
+    'discount.applied', 'discount.removed',
+    // Customer
+    'customer.created', 'customer.updated', 'customer.deleted',
+    'customer.payment_method_added', 'customer.payment_method_removed',
+    // AR / Net30 invoice
+    'invoice.past_due',
+    // Shipping & tax provider health
+    'shipping_tax.provider_connection.unhealthy',
+    // Workspace payment methods (platform-billing)
+    'workspace.payment_method.added', 'workspace.payment_method.removed',
+    'workspace.payment_method.default_changed', 'workspace.payment_method.backup_set',
+    'workspace.payment_method.backup_used',
+    // Platform billing charges
+    'workspace.platform_charge.succeeded', 'workspace.platform_charge.failed',
+    // Workspace lifecycle
+    'workspace.trial_expired',
+];
+const _assertAllEventsListed = true;
 // ----------------------------------------------------------------------------
 // Signature verification (Stripe-compatible scheme)
 // ----------------------------------------------------------------------------
-import { createHmac, timingSafeEqual } from 'node:crypto';
 /**
  * Verifies the `Throttle-Signature` header against the raw request body.
  * Use this from your webhook handler BEFORE parsing the JSON.

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAkUH,+EAA+E;AAC/E,oDAAoD;AACpD,+EAA+E;AAE/E,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE1D;;;;;;;;;GASG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAKtC;IACC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,gBAAgB,GAAG,GAAG,EAAE,GAAG,IAAI,CAAC;IAEjE,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAC9B,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAC1B,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC5B,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/B,CAAC,CAAC,CACH,CAAC;IAEF,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;QAAE,OAAO,KAAK,CAAC;IAExC,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9C,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,gBAAgB;QAAE,OAAO,KAAK,CAAC;IAE7E,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC;SAC1C,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC;SAC/B,MAAM,CAAC,KAAK,CAAC,CAAC;IAEjB,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAC9C,IAAI,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1D,OAAO,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;AACjE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usethrottle/webhook-types",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "TypeScript discriminated unions for every Throttle outbound webhook event.",
   "type": "module",
   "main": "./dist/index.js",
@@ -16,6 +16,7 @@
     "test": "tsc --noEmit && vitest run --passWithNoTests"
   },
   "devDependencies": {
+    "@core/scopes": "workspace:*",
     "@types/node": "^20.0.0",
     "typescript": "^5.7.0",
     "vitest": "^2.1.9"