@stewardhq/sdk 0.3.0 → 0.6.0

package/dist/_chunks/events.d.ts

@@ -1,27 +1,27 @@
 import { z } from "zod";
 //#region ../contract/src/accounts.d.ts
 declare const AccountLocaleSchema: z.ZodEnum<{
-  tr: "tr";
   en: "en";
+  tr: "tr";
 }>;
 declare const AccountUpsertInputSchema: z.ZodObject<{
   displayName: z.ZodString;
   metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
   notificationEmails: z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodEmail>, z.ZodTransform<string[], string[]>>>;
   locale: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-    tr: "tr";
     en: "en";
+    tr: "tr";
   }>>>;
 }, z.core.$strip>;
 type AccountUpsertInput = z.input<typeof AccountUpsertInputSchema>;
 declare const BillingProfileKindSchema: z.ZodEnum<{
-  individual: "individual";
   company: "company";
+  individual: "individual";
 }>;
 declare const BillingProfileSchema: z.ZodObject<{
   kind: z.ZodEnum<{
-    individual: "individual";
     company: "company";
+    individual: "individual";
   }>;
   contactName: z.ZodString;
   companyName: z.ZodOptional<z.ZodString>;
@@ -42,10 +42,10 @@ declare const AccessStateSchema: z.ZodEnum<{
 type AccessState = z.infer<typeof AccessStateSchema>;
 declare const SubscriptionStatusSchema: z.ZodEnum<{
   active: "active";
-  suspended: "suspended";
-  past_due: "past_due";
   canceled: "canceled";
   expired: "expired";
+  past_due: "past_due";
+  suspended: "suspended";
 }>;
 type SubscriptionStatus = z.infer<typeof SubscriptionStatusSchema>;
 /** Snapshot içindeki canlı abonelik özeti (yoksa null). */
@@ -53,10 +53,10 @@ declare const SubscriptionSummarySchema: z.ZodObject<{
   id: z.ZodUUID;
   status: z.ZodEnum<{
     active: "active";
-    suspended: "suspended";
-    past_due: "past_due";
     canceled: "canceled";
     expired: "expired";
+    past_due: "past_due";
+    suspended: "suspended";
   }>;
   planCode: z.ZodString;
   interval: z.ZodEnum<{
@@ -81,10 +81,10 @@ declare const EntitlementSnapshotSchema: z.ZodObject<{
     id: z.ZodUUID;
     status: z.ZodEnum<{
       active: "active";
-      suspended: "suspended";
-      past_due: "past_due";
       canceled: "canceled";
       expired: "expired";
+      past_due: "past_due";
+      suspended: "suspended";
     }>;
     planCode: z.ZodString;
     interval: z.ZodEnum<{
@@ -104,7 +104,10 @@ declare const AccountDunningStateSchema: z.ZodObject<{
   nextActionAt: z.ZodNullable<z.ZodISODateTime>;
 }, z.core.$strip>;
 type AccountDunningState = z.infer<typeof AccountDunningStateSchema>;
-/** Dönem sonunda uygulanacak plan değişikliği. F4b'ye kadar her zaman null. */
+/**
+ * Change applied at the period end (`POST /v1/subscriptions/:id/change`, MF9). Null until then.
+ * `price: "current"` on the same plan shows the same `planCode`/`interval` with the new `amountMinor`.
+ */
 declare const AccountScheduledChangeSchema: z.ZodObject<{
   planCode: z.ZodString;
   interval: z.ZodEnum<{
@@ -112,16 +115,17 @@ declare const AccountScheduledChangeSchema: z.ZodObject<{
     year: "year";
   }>;
   effectiveAt: z.ZodISODateTime;
+  amountMinor: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 type AccountScheduledChange = z.infer<typeof AccountScheduledChangeSchema>;
 declare const AccountSubscriptionStateSchema: z.ZodObject<{
   id: z.ZodUUID;
   status: z.ZodEnum<{
     active: "active";
-    suspended: "suspended";
-    past_due: "past_due";
     canceled: "canceled";
     expired: "expired";
+    past_due: "past_due";
+    suspended: "suspended";
   }>;
   planCode: z.ZodString;
   interval: z.ZodEnum<{
@@ -146,6 +150,7 @@ declare const AccountSubscriptionStateSchema: z.ZodObject<{
       year: "year";
     }>;
     effectiveAt: z.ZodISODateTime;
+    amountMinor: z.ZodOptional<z.ZodNumber>;
   }, z.core.$strip>>;
 }, z.core.$strip>;
 type AccountSubscriptionState = z.infer<typeof AccountSubscriptionStateSchema>;
@@ -161,14 +166,64 @@ declare const AccountOpenCheckoutSchema: z.ZodObject<{
   currency: z.ZodString;
   amountMinor: z.ZodNumber;
   expiresAt: z.ZodISODateTime;
+  paymentMethod: z.ZodOptional<z.ZodEnum<{
+    bank_transfer: "bank_transfer";
+    card: "card";
+  }>>;
 }, z.core.$strip>;
 type AccountOpenCheckout = z.infer<typeof AccountOpenCheckoutSchema>;
+/**
+ * An unpaid invoice of the account (billing core, M22/M34): renewal or final invoices written
+ * before payment. Account level (not under a subscription) so the final invoice of an ended
+ * subscription stays visible; the product can show a banner before `dueAt`.
+ */
+declare const AccountOpenInvoiceSchema: z.ZodObject<{
+  id: z.ZodUUID;
+  subscriptionId: z.ZodNullable<z.ZodUUID>;
+  billingReason: z.ZodEnum<{
+    manual: "manual";
+    purchase: "purchase";
+    subscription_create: "subscription_create";
+    subscription_cycle: "subscription_cycle";
+    subscription_update: "subscription_update";
+  }>;
+  totalMinor: z.ZodNumber;
+  currency: z.ZodString;
+  dueAt: z.ZodISODateTime;
+}, z.core.$strip>;
+type AccountOpenInvoice = z.infer<typeof AccountOpenInvoiceSchema>;
+/**
+ * Low-churn meter facts of the account state (metering, M13; Polar `active_meters`, coarse). One
+ * entry per catalog meter. Balances and period bounds are NOT here (they change with every event;
+ * read them with `GET /v1/accounts/:ref/meters`): this block changes when the plan changes, a
+ * threshold is crossed or a new period resets the standing — never per event.
+ */
+declare const AccountMeterStateSchema: z.ZodObject<{
+  includedUnits: z.ZodNullable<z.ZodNumber>;
+  billable: z.ZodBoolean;
+  standing: z.ZodEnum<{
+    exhausted: "exhausted";
+    low: "low";
+    ok: "ok";
+  }>;
+}, z.core.$strip>;
+type AccountMeterState = z.infer<typeof AccountMeterStateSchema>;
+declare const AccountMetersStateSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
+  includedUnits: z.ZodNullable<z.ZodNumber>;
+  billable: z.ZodBoolean;
+  standing: z.ZodEnum<{
+    exhausted: "exhausted";
+    low: "low";
+    ok: "ok";
+  }>;
+}, z.core.$strip>>;
+type AccountMetersState = z.infer<typeof AccountMetersStateSchema>;
 /** Fatura profili özeti: yalnızca var mı ve türü (alanlar PII, burada yok). */
 declare const AccountProfileStateSchema: z.ZodObject<{
   present: z.ZodBoolean;
   kind: z.ZodNullable<z.ZodEnum<{
-    individual: "individual";
     company: "company";
+    individual: "individual";
   }>>;
 }, z.core.$strip>;
 type AccountProfileState = z.infer<typeof AccountProfileStateSchema>;
@@ -188,10 +243,10 @@ declare const AccountStateSchema: z.ZodObject<{
     id: z.ZodUUID;
     status: z.ZodEnum<{
       active: "active";
-      suspended: "suspended";
-      past_due: "past_due";
       canceled: "canceled";
       expired: "expired";
+      past_due: "past_due";
+      suspended: "suspended";
     }>;
     planCode: z.ZodString;
     interval: z.ZodEnum<{
@@ -216,6 +271,7 @@ declare const AccountStateSchema: z.ZodObject<{
         year: "year";
       }>;
       effectiveAt: z.ZodISODateTime;
+      amountMinor: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
   }, z.core.$strip>>;
   openCheckout: z.ZodNullable<z.ZodObject<{
@@ -229,14 +285,84 @@ declare const AccountStateSchema: z.ZodObject<{
     currency: z.ZodString;
     amountMinor: z.ZodNumber;
     expiresAt: z.ZodISODateTime;
+    paymentMethod: z.ZodOptional<z.ZodEnum<{
+      bank_transfer: "bank_transfer";
+      card: "card";
+    }>>;
   }, z.core.$strip>>;
   profile: z.ZodObject<{
     present: z.ZodBoolean;
     kind: z.ZodNullable<z.ZodEnum<{
-      individual: "individual";
       company: "company";
+      individual: "individual";
     }>>;
   }, z.core.$strip>;
+  subscriptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    id: z.ZodUUID;
+    status: z.ZodEnum<{
+      active: "active";
+      canceled: "canceled";
+      expired: "expired";
+      past_due: "past_due";
+      suspended: "suspended";
+    }>;
+    planCode: z.ZodString;
+    interval: z.ZodEnum<{
+      month: "month";
+      year: "year";
+    }>;
+    amountMinor: z.ZodNumber;
+    currency: z.ZodString;
+    currentPeriodEnd: z.ZodNullable<z.ZodISODateTime>;
+    cancelAt: z.ZodNullable<z.ZodISODateTime>;
+    cancelAtPeriodEnd: z.ZodBoolean;
+    pastDueSince: z.ZodNullable<z.ZodISODateTime>;
+    currentPeriodStart: z.ZodNullable<z.ZodISODateTime>;
+    dunning: z.ZodNullable<z.ZodObject<{
+      step: z.ZodNumber;
+      nextActionAt: z.ZodNullable<z.ZodISODateTime>;
+    }, z.core.$strip>>;
+    scheduledChange: z.ZodNullable<z.ZodObject<{
+      planCode: z.ZodString;
+      interval: z.ZodEnum<{
+        month: "month";
+        year: "year";
+      }>;
+      effectiveAt: z.ZodISODateTime;
+      amountMinor: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>>;
+  openInvoices: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    id: z.ZodUUID;
+    subscriptionId: z.ZodNullable<z.ZodUUID>;
+    billingReason: z.ZodEnum<{
+      manual: "manual";
+      purchase: "purchase";
+      subscription_create: "subscription_create";
+      subscription_cycle: "subscription_cycle";
+      subscription_update: "subscription_update";
+    }>;
+    totalMinor: z.ZodNumber;
+    currency: z.ZodString;
+    dueAt: z.ZodISODateTime;
+  }, z.core.$strip>>>;
+  benefits: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    code: z.ZodNullable<z.ZodString>;
+    type: z.ZodString;
+    properties: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    source: z.ZodString;
+    grantedAt: z.ZodISODateTime;
+  }, z.core.$strip>>>;
+  meters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+    includedUnits: z.ZodNullable<z.ZodNumber>;
+    billable: z.ZodBoolean;
+    standing: z.ZodEnum<{
+      exhausted: "exhausted";
+      low: "low";
+      ok: "ok";
+    }>;
+  }, z.core.$strip>>>;
+  bankTransferCode: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 type AccountState = z.infer<typeof AccountStateSchema>;
 declare const AccountSchema: z.ZodObject<{
@@ -256,10 +382,10 @@ declare const AccountSchema: z.ZodObject<{
       id: z.ZodUUID;
       status: z.ZodEnum<{
         active: "active";
-        suspended: "suspended";
-        past_due: "past_due";
         canceled: "canceled";
         expired: "expired";
+        past_due: "past_due";
+        suspended: "suspended";
       }>;
       planCode: z.ZodString;
       interval: z.ZodEnum<{
@@ -274,8 +400,8 @@ declare const AccountSchema: z.ZodObject<{
   }, z.core.$strip>;
   notificationEmails: z.ZodDefault<z.ZodArray<z.ZodString>>;
   locale: z.ZodDefault<z.ZodNullable<z.ZodEnum<{
-    tr: "tr";
     en: "en";
+    tr: "tr";
   }>>>;
 }, z.core.$strip>;
 type Account = z.infer<typeof AccountSchema>;
@@ -284,28 +410,29 @@ declare const AccountDeleteResponseSchema: z.ZodObject<{
   deletedAt: z.ZodISODateTime;
 }, z.core.$strip>;
 type AccountDeleteResponse = z.infer<typeof AccountDeleteResponseSchema>;
-declare const ACCOUNT_INCLUDES: readonly ["profile", "subscriptions", "checkouts", "payments", "invoices", "grants"];
+declare const ACCOUNT_INCLUDES: readonly ['profile', 'subscriptions', 'checkouts', 'payments', 'invoices', 'grants'];
 type AccountInclude = (typeof ACCOUNT_INCLUDES)[number];
 //#endregion
 //#region ../contract/src/events.d.ts
 declare const EventIdSchema: z.ZodString;
 declare const ApiVersionSchema: z.ZodString;
 declare const EVENT_DETAIL_SCHEMAS: {
-  readonly "account.updated": z.ZodObject<{
+  readonly 'account.updated': z.ZodObject<{
     changed: z.ZodArray<z.ZodString>;
   }, z.core.$strip>;
-  readonly "checkout.completed": z.ZodObject<{
+  readonly 'checkout.completed': z.ZodObject<{
     subscriptionId: z.ZodUUID;
     checkoutSessionId: z.ZodUUID;
   }, z.core.$strip>;
-  readonly "checkout.failed": z.ZodObject<{
+  readonly 'checkout.failed': z.ZodObject<{
     checkoutSessionId: z.ZodUUID;
     reason: z.ZodString;
   }, z.core.$strip>;
-  readonly "checkout.expired": z.ZodObject<{
+  readonly 'checkout.expired': z.ZodObject<{
     checkoutSessionId: z.ZodUUID;
   }, z.core.$strip>;
-  readonly "subscription.activated": z.ZodObject<{
+  readonly 'subscription.activated': z.ZodObject<{
+    subscriptionId: z.ZodUUID;
     planCode: z.ZodString;
     interval: z.ZodEnum<{
       month: "month";
@@ -314,78 +441,167 @@ declare const EVENT_DETAIL_SCHEMAS: {
     amountMinor: z.ZodNumber;
     currency: z.ZodString;
     actorRef: z.ZodNullable<z.ZodString>;
-    subscriptionId: z.ZodUUID;
+    replacedSubscriptionId: z.ZodOptional<z.ZodUUID>;
   }, z.core.$strip>;
-  readonly "subscription.renewed": z.ZodObject<{
+  readonly 'subscription.renewed': z.ZodObject<{
+    subscriptionId: z.ZodUUID;
     paymentId: z.ZodUUID;
     periodStart: z.ZodNullable<z.ZodISODateTime>;
     periodEnd: z.ZodNullable<z.ZodISODateTime>;
     invoiceId: z.ZodNullable<z.ZodUUID>;
-    subscriptionId: z.ZodUUID;
   }, z.core.$strip>;
-  readonly "subscription.payment_failed": z.ZodObject<{
+  readonly 'subscription.payment_failed': z.ZodObject<{
+    subscriptionId: z.ZodUUID;
     paymentId: z.ZodNullable<z.ZodUUID>;
     attempt: z.ZodNumber;
     nextRetryAt: z.ZodNullable<z.ZodISODateTime>;
-    subscriptionId: z.ZodUUID;
+    invoiceId: z.ZodOptional<z.ZodUUID>;
   }, z.core.$strip>;
-  readonly "subscription.suspended": z.ZodObject<{
-    dunningDay: z.ZodNumber;
+  readonly 'subscription.suspended': z.ZodObject<{
     subscriptionId: z.ZodUUID;
+    dunningDay: z.ZodNumber;
   }, z.core.$strip>;
-  readonly "subscription.reactivated": z.ZodObject<{
-    paymentId: z.ZodNullable<z.ZodUUID>;
+  readonly 'subscription.reactivated': z.ZodObject<{
     subscriptionId: z.ZodUUID;
+    paymentId: z.ZodNullable<z.ZodUUID>;
   }, z.core.$strip>;
-  readonly "subscription.cancel_scheduled": z.ZodObject<{
+  readonly 'subscription.cancel_scheduled': z.ZodObject<{
+    subscriptionId: z.ZodUUID;
     cancelAt: z.ZodISODateTime;
     reason: z.ZodString;
     actorRef: z.ZodNullable<z.ZodString>;
-    subscriptionId: z.ZodUUID;
   }, z.core.$strip>;
-  readonly "subscription.canceled": z.ZodObject<{
+  readonly 'subscription.canceled': z.ZodObject<{
+    subscriptionId: z.ZodUUID;
     reason: z.ZodString;
     effectiveAt: z.ZodISODateTime;
     actorRef: z.ZodNullable<z.ZodString>;
-    subscriptionId: z.ZodUUID;
   }, z.core.$strip>;
-  readonly "subscription.expired": z.ZodObject<{
-    effectiveAt: z.ZodISODateTime;
+  readonly 'subscription.expired': z.ZodObject<{
     subscriptionId: z.ZodUUID;
+    effectiveAt: z.ZodISODateTime;
   }, z.core.$strip>;
-  readonly "subscription.terminated": z.ZodObject<{
+  readonly 'subscription.terminated': z.ZodObject<{
+    subscriptionId: z.ZodUUID;
     reason: z.ZodEnum<{
       nonpayment: "nonpayment";
     }>;
     dunningDay: z.ZodNumber;
-    subscriptionId: z.ZodUUID;
   }, z.core.$strip>;
-  readonly "invoice.created": z.ZodObject<{
+  readonly 'invoice.created': z.ZodObject<{
     invoiceId: z.ZodUUID;
     totalMinor: z.ZodNumber;
     currency: z.ZodString;
   }, z.core.$strip>;
-  readonly "invoice.issued": z.ZodObject<{
+  readonly 'invoice.issued': z.ZodObject<{
     invoiceId: z.ZodUUID;
     number: z.ZodString;
     totalMinor: z.ZodNumber;
     currency: z.ZodString;
   }, z.core.$strip>;
-  readonly "invoice.voided": z.ZodObject<{
+  readonly 'invoice.voided': z.ZodObject<{
     invoiceId: z.ZodUUID;
     number: z.ZodNullable<z.ZodString>;
     totalMinor: z.ZodNumber;
     currency: z.ZodString;
     reason: z.ZodString;
   }, z.core.$strip>;
-  readonly "account.state_changed": z.ZodObject<{
+  readonly 'account.state_changed': z.ZodObject<{
     cause: z.ZodString;
     causeEventId: z.ZodNullable<z.ZodString>;
   }, z.core.$strip>;
-  readonly "account.deleted": z.ZodObject<{
+  readonly 'account.deleted': z.ZodObject<{
     deletedAt: z.ZodISODateTime;
     actorRef: z.ZodNullable<z.ZodString>;
   }, z.core.$strip>;
+  readonly 'invoice.paid': z.ZodObject<{
+    invoiceId: z.ZodUUID;
+    subscriptionId: z.ZodNullable<z.ZodUUID>;
+    paymentId: z.ZodUUID;
+    billingReason: z.ZodNullable<z.ZodEnum<{
+      manual: "manual";
+      purchase: "purchase";
+      subscription_create: "subscription_create";
+      subscription_cycle: "subscription_cycle";
+      subscription_update: "subscription_update";
+    }>>;
+    totalMinor: z.ZodNumber;
+    currency: z.ZodString;
+    paidAt: z.ZodISODateTime;
+  }, z.core.$strip>;
+  readonly 'benefit_grant.created': z.ZodObject<{
+    grantId: z.ZodUUID;
+    benefit: z.ZodObject<{
+      code: z.ZodNullable<z.ZodString>;
+      type: z.ZodString;
+      properties: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+      source: z.ZodString;
+      grantedAt: z.ZodISODateTime;
+    }, z.core.$strip>;
+  }, z.core.$strip>;
+  readonly 'benefit_grant.updated': z.ZodObject<{
+    grantId: z.ZodUUID;
+    benefit: z.ZodObject<{
+      code: z.ZodNullable<z.ZodString>;
+      type: z.ZodString;
+      properties: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+      source: z.ZodString;
+      grantedAt: z.ZodISODateTime;
+    }, z.core.$strip>;
+    previousProperties: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+  }, z.core.$strip>;
+  readonly 'benefit_grant.revoked': z.ZodObject<{
+    grantId: z.ZodUUID;
+    benefit: z.ZodObject<{
+      code: z.ZodNullable<z.ZodString>;
+      type: z.ZodString;
+      properties: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+      source: z.ZodString;
+      grantedAt: z.ZodISODateTime;
+    }, z.core.$strip>;
+    revokedAt: z.ZodISODateTime;
+  }, z.core.$strip>;
+  readonly 'benefit_grant.cycled': z.ZodObject<{
+    grantId: z.ZodUUID;
+    benefit: z.ZodObject<{
+      code: z.ZodNullable<z.ZodString>;
+      type: z.ZodString;
+      properties: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+      source: z.ZodString;
+      grantedAt: z.ZodISODateTime;
+    }, z.core.$strip>;
+    periodStart: z.ZodISODateTime;
+    periodEnd: z.ZodISODateTime;
+  }, z.core.$strip>;
+  readonly 'meter.threshold_crossed': z.ZodObject<{
+    meter: z.ZodString;
+    standing: z.ZodEnum<{
+      exhausted: "exhausted";
+      low: "low";
+      ok: "ok";
+    }>;
+    previous: z.ZodEnum<{
+      exhausted: "exhausted";
+      low: "low";
+      ok: "ok";
+    }>;
+    periodStart: z.ZodISODateTime;
+    periodEnd: z.ZodISODateTime;
+    consumedUnits: z.ZodNumber;
+    creditedUnits: z.ZodNumber;
+  }, z.core.$strip>;
+  readonly 'meter.period_closed': z.ZodObject<{
+    periodStart: z.ZodISODateTime;
+    periodEnd: z.ZodISODateTime;
+    subscriptionId: z.ZodNullable<z.ZodUUID>;
+    meters: z.ZodArray<z.ZodObject<{
+      meter: z.ZodString;
+      consumedUnits: z.ZodNumber;
+      creditedUnits: z.ZodNumber;
+      overageUnits: z.ZodNumber;
+    }, z.core.$strip>>;
+    meterChargeId: z.ZodNullable<z.ZodUUID>;
+  }, z.core.$strip>;
 };
 type EventType = keyof typeof EVENT_DETAIL_SCHEMAS;
 /** Tüm event tipleri (yenileri dahil). */
@@ -397,9 +613,11 @@ declare const EVENT_TYPES: EventType[];
 declare const LEGACY_EVENT_TYPES: readonly ["account.updated", "checkout.completed", "checkout.failed", "checkout.expired", "subscription.activated", "subscription.renewed", "subscription.payment_failed", "subscription.suspended", "subscription.reactivated", "subscription.cancel_scheduled", "subscription.canceled", "subscription.expired", "subscription.terminated", "invoice.created", "invoice.issued"];
 type LegacyEventType = (typeof LEGACY_EVENT_TYPES)[number];
 /** `account.state_changed.detail.cause` — bilinen değerler; küme açık. */
-type AccountStateChangeCause = LegacyEventType | "account.upserted" | "billing_profile.updated" | "checkout.opened" | "checkout.initialize_failed" | "checkout.canceled" | "grant.created" | "grant.revoked" | "grant.window_applied" | "dunning.advanced" | "dunning_policy.updated" | "payment.recorded" | "catalog.synced" | "account.refreshed" | "grant.plan_set" | "resync" | "account.deleted" | (string & Record<never, never>);
-type FullStateEventType = "account.state_changed" | "account.deleted";
+type AccountStateChangeCause = LegacyEventType | 'account.upserted' | 'billing_profile.updated' | 'checkout.opened' | 'checkout.initialize_failed' | 'checkout.canceled' | 'grant.created' | 'grant.revoked' | 'grant.window_applied' | 'dunning.advanced' | 'dunning_policy.updated' | 'payment.recorded' | 'catalog.synced' | 'account.refreshed' | 'grant.plan_set' | 'resync' | 'account.deleted' | 'invoice.paid' | 'subscription.period_advanced' | 'subscription.uncanceled' | 'subscription.change_scheduled' | 'invoice.waived' | 'invoice.payment_reminder' | 'meter.threshold_crossed' | 'meter.period_rolled' | 'credits.granted' | 'bank_transfer.code_assigned' | (string & Record<never, never>);
+type FullStateEventType = 'account.state_changed' | 'account.deleted' | 'invoice.paid' | 'benefit_grant.created' | 'benefit_grant.updated' | 'benefit_grant.revoked' | 'benefit_grant.cycled' | 'meter.threshold_crossed' | 'meter.period_closed';
 type AccountSchemaOf<T extends EventType> = T extends FullStateEventType ? typeof AccountStateSchema : typeof EntitlementSnapshotSchema;
+/** Event types whose `data.account` is the full `AccountState` (the others: the entitlement snapshot). */
+declare const FULL_STATE_EVENT_TYPES: ReadonlySet<string>;
 declare function envelope<T extends EventType>(type: T): z.ZodObject<{
   id: z.ZodString;
   type: z.ZodLiteral<T>;
@@ -410,21 +628,22 @@ declare function envelope<T extends EventType>(type: T): z.ZodObject<{
   data: z.ZodObject<{
     account: AccountSchemaOf<T>;
     detail: {
-      readonly "account.updated": z.ZodObject<{
+      readonly 'account.updated': z.ZodObject<{
         changed: z.ZodArray<z.ZodString>;
       }, z.core.$strip>;
-      readonly "checkout.completed": z.ZodObject<{
+      readonly 'checkout.completed': z.ZodObject<{
         subscriptionId: z.ZodUUID;
         checkoutSessionId: z.ZodUUID;
       }, z.core.$strip>;
-      readonly "checkout.failed": z.ZodObject<{
+      readonly 'checkout.failed': z.ZodObject<{
         checkoutSessionId: z.ZodUUID;
         reason: z.ZodString;
       }, z.core.$strip>;
-      readonly "checkout.expired": z.ZodObject<{
+      readonly 'checkout.expired': z.ZodObject<{
         checkoutSessionId: z.ZodUUID;
       }, z.core.$strip>;
-      readonly "subscription.activated": z.ZodObject<{
+      readonly 'subscription.activated': z.ZodObject<{
+        subscriptionId: z.ZodUUID;
         planCode: z.ZodString;
         interval: z.ZodEnum<{
           month: "month";
@@ -433,78 +652,167 @@ declare function envelope<T extends EventType>(type: T): z.ZodObject<{
         amountMinor: z.ZodNumber;
         currency: z.ZodString;
         actorRef: z.ZodNullable<z.ZodString>;
-        subscriptionId: z.ZodUUID;
+        replacedSubscriptionId: z.ZodOptional<z.ZodUUID>;
       }, z.core.$strip>;
-      readonly "subscription.renewed": z.ZodObject<{
+      readonly 'subscription.renewed': z.ZodObject<{
+        subscriptionId: z.ZodUUID;
         paymentId: z.ZodUUID;
         periodStart: z.ZodNullable<z.ZodISODateTime>;
         periodEnd: z.ZodNullable<z.ZodISODateTime>;
         invoiceId: z.ZodNullable<z.ZodUUID>;
-        subscriptionId: z.ZodUUID;
       }, z.core.$strip>;
-      readonly "subscription.payment_failed": z.ZodObject<{
+      readonly 'subscription.payment_failed': z.ZodObject<{
+        subscriptionId: z.ZodUUID;
         paymentId: z.ZodNullable<z.ZodUUID>;
         attempt: z.ZodNumber;
         nextRetryAt: z.ZodNullable<z.ZodISODateTime>;
-        subscriptionId: z.ZodUUID;
+        invoiceId: z.ZodOptional<z.ZodUUID>;
       }, z.core.$strip>;
-      readonly "subscription.suspended": z.ZodObject<{
-        dunningDay: z.ZodNumber;
+      readonly 'subscription.suspended': z.ZodObject<{
         subscriptionId: z.ZodUUID;
+        dunningDay: z.ZodNumber;
       }, z.core.$strip>;
-      readonly "subscription.reactivated": z.ZodObject<{
-        paymentId: z.ZodNullable<z.ZodUUID>;
+      readonly 'subscription.reactivated': z.ZodObject<{
         subscriptionId: z.ZodUUID;
+        paymentId: z.ZodNullable<z.ZodUUID>;
       }, z.core.$strip>;
-      readonly "subscription.cancel_scheduled": z.ZodObject<{
+      readonly 'subscription.cancel_scheduled': z.ZodObject<{
+        subscriptionId: z.ZodUUID;
         cancelAt: z.ZodISODateTime;
         reason: z.ZodString;
         actorRef: z.ZodNullable<z.ZodString>;
-        subscriptionId: z.ZodUUID;
       }, z.core.$strip>;
-      readonly "subscription.canceled": z.ZodObject<{
+      readonly 'subscription.canceled': z.ZodObject<{
+        subscriptionId: z.ZodUUID;
         reason: z.ZodString;
         effectiveAt: z.ZodISODateTime;
         actorRef: z.ZodNullable<z.ZodString>;
-        subscriptionId: z.ZodUUID;
       }, z.core.$strip>;
-      readonly "subscription.expired": z.ZodObject<{
-        effectiveAt: z.ZodISODateTime;
+      readonly 'subscription.expired': z.ZodObject<{
         subscriptionId: z.ZodUUID;
+        effectiveAt: z.ZodISODateTime;
       }, z.core.$strip>;
-      readonly "subscription.terminated": z.ZodObject<{
+      readonly 'subscription.terminated': z.ZodObject<{
+        subscriptionId: z.ZodUUID;
         reason: z.ZodEnum<{
           nonpayment: "nonpayment";
         }>;
         dunningDay: z.ZodNumber;
-        subscriptionId: z.ZodUUID;
       }, z.core.$strip>;
-      readonly "invoice.created": z.ZodObject<{
+      readonly 'invoice.created': z.ZodObject<{
         invoiceId: z.ZodUUID;
         totalMinor: z.ZodNumber;
         currency: z.ZodString;
       }, z.core.$strip>;
-      readonly "invoice.issued": z.ZodObject<{
+      readonly 'invoice.issued': z.ZodObject<{
         invoiceId: z.ZodUUID;
         number: z.ZodString;
         totalMinor: z.ZodNumber;
         currency: z.ZodString;
       }, z.core.$strip>;
-      readonly "invoice.voided": z.ZodObject<{
+      readonly 'invoice.voided': z.ZodObject<{
         invoiceId: z.ZodUUID;
         number: z.ZodNullable<z.ZodString>;
         totalMinor: z.ZodNumber;
         currency: z.ZodString;
         reason: z.ZodString;
       }, z.core.$strip>;
-      readonly "account.state_changed": z.ZodObject<{
+      readonly 'account.state_changed': z.ZodObject<{
         cause: z.ZodString;
         causeEventId: z.ZodNullable<z.ZodString>;
       }, z.core.$strip>;
-      readonly "account.deleted": z.ZodObject<{
+      readonly 'account.deleted': z.ZodObject<{
         deletedAt: z.ZodISODateTime;
         actorRef: z.ZodNullable<z.ZodString>;
       }, z.core.$strip>;
+      readonly 'invoice.paid': z.ZodObject<{
+        invoiceId: z.ZodUUID;
+        subscriptionId: z.ZodNullable<z.ZodUUID>;
+        paymentId: z.ZodUUID;
+        billingReason: z.ZodNullable<z.ZodEnum<{
+          manual: "manual";
+          purchase: "purchase";
+          subscription_create: "subscription_create";
+          subscription_cycle: "subscription_cycle";
+          subscription_update: "subscription_update";
+        }>>;
+        totalMinor: z.ZodNumber;
+        currency: z.ZodString;
+        paidAt: z.ZodISODateTime;
+      }, z.core.$strip>;
+      readonly 'benefit_grant.created': z.ZodObject<{
+        grantId: z.ZodUUID;
+        benefit: z.ZodObject<{
+          code: z.ZodNullable<z.ZodString>;
+          type: z.ZodString;
+          properties: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+          source: z.ZodString;
+          grantedAt: z.ZodISODateTime;
+        }, z.core.$strip>;
+      }, z.core.$strip>;
+      readonly 'benefit_grant.updated': z.ZodObject<{
+        grantId: z.ZodUUID;
+        benefit: z.ZodObject<{
+          code: z.ZodNullable<z.ZodString>;
+          type: z.ZodString;
+          properties: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+          source: z.ZodString;
+          grantedAt: z.ZodISODateTime;
+        }, z.core.$strip>;
+        previousProperties: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+      }, z.core.$strip>;
+      readonly 'benefit_grant.revoked': z.ZodObject<{
+        grantId: z.ZodUUID;
+        benefit: z.ZodObject<{
+          code: z.ZodNullable<z.ZodString>;
+          type: z.ZodString;
+          properties: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+          source: z.ZodString;
+          grantedAt: z.ZodISODateTime;
+        }, z.core.$strip>;
+        revokedAt: z.ZodISODateTime;
+      }, z.core.$strip>;
+      readonly 'benefit_grant.cycled': z.ZodObject<{
+        grantId: z.ZodUUID;
+        benefit: z.ZodObject<{
+          code: z.ZodNullable<z.ZodString>;
+          type: z.ZodString;
+          properties: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+          source: z.ZodString;
+          grantedAt: z.ZodISODateTime;
+        }, z.core.$strip>;
+        periodStart: z.ZodISODateTime;
+        periodEnd: z.ZodISODateTime;
+      }, z.core.$strip>;
+      readonly 'meter.threshold_crossed': z.ZodObject<{
+        meter: z.ZodString;
+        standing: z.ZodEnum<{
+          exhausted: "exhausted";
+          low: "low";
+          ok: "ok";
+        }>;
+        previous: z.ZodEnum<{
+          exhausted: "exhausted";
+          low: "low";
+          ok: "ok";
+        }>;
+        periodStart: z.ZodISODateTime;
+        periodEnd: z.ZodISODateTime;
+        consumedUnits: z.ZodNumber;
+        creditedUnits: z.ZodNumber;
+      }, z.core.$strip>;
+      readonly 'meter.period_closed': z.ZodObject<{
+        periodStart: z.ZodISODateTime;
+        periodEnd: z.ZodISODateTime;
+        subscriptionId: z.ZodNullable<z.ZodUUID>;
+        meters: z.ZodArray<z.ZodObject<{
+          meter: z.ZodString;
+          consumedUnits: z.ZodNumber;
+          creditedUnits: z.ZodNumber;
+          overageUnits: z.ZodNumber;
+        }, z.core.$strip>>;
+        meterChargeId: z.ZodNullable<z.ZodUUID>;
+      }, z.core.$strip>;
     }[T];
   }, z.core.$strip>;
 }, z.core.$strip>;
@@ -548,4 +856,4 @@ declare const PingSchema: z.ZodObject<{
 }, z.core.$strip>;
 type Ping = z.infer<typeof PingSchema>;
 //#endregion
-export { AccountOpenCheckoutSchema as A, AccountUpsertInput as B, AccountDeleteResponse as C, AccountInclude as D, AccountDunningStateSchema as E, AccountSchema as F, BillingProfileSchema as G, BillingProfile as H, AccountState as I, SubscriptionStatus as J, EntitlementSnapshot as K, AccountStateSchema as L, AccountProfileStateSchema as M, AccountScheduledChange as N, AccountLocaleSchema as O, AccountScheduledChangeSchema as P, AccountSubscriptionState as R, Account as S, AccountDunningState as T, BillingProfileInput as U, AccountUpsertInputSchema as V, BillingProfileKindSchema as W, SubscriptionSummary as X, SubscriptionStatusSchema as Y, SubscriptionSummarySchema as Z, PingSchema as _, BillingEvent as a, AccessState as b, EVENT_DETAIL_SCHEMAS as c, EventIdSchema as d, EventType as f, Ping as g, PING_EVENT_TYPE as h, ApiVersionSchema as i, AccountProfileState as j, AccountOpenCheckout as k, EVENT_TYPES as l, LegacyEventType as m, AnyBillingEvent as n, BillingEventOf as o, LEGACY_EVENT_TYPES as p, EntitlementSnapshotSchema as q, AnyBillingEventSchema as r, BillingEventSchema as s, AccountStateChangeCause as t, EventDetail as u, isEventType as v, AccountDeleteResponseSchema as w, AccessStateSchema as x, ACCOUNT_INCLUDES as y, AccountSubscriptionStateSchema as z };
+export { EntitlementSnapshot as $, AccountMeterState as A, AccountScheduledChange as B, Account as C, AccountDunningStateSchema as D, AccountDunningState as E, AccountOpenCheckoutSchema as F, AccountSubscriptionState as G, AccountSchema as H, AccountOpenInvoice as I, AccountUpsertInputSchema as J, AccountSubscriptionStateSchema as K, AccountOpenInvoiceSchema as L, AccountMetersState as M, AccountMetersStateSchema as N, AccountInclude as O, AccountOpenCheckout as P, BillingProfileSchema as Q, AccountProfileState as R, AccessStateSchema as S, AccountDeleteResponseSchema as T, AccountState as U, AccountScheduledChangeSchema as V, AccountStateSchema as W, BillingProfileInput as X, BillingProfile as Y, BillingProfileKindSchema as Z, Ping as _, BillingEvent as a, ACCOUNT_INCLUDES as b, EVENT_DETAIL_SCHEMAS as c, EventIdSchema as d, EntitlementSnapshotSchema as et, EventType as f, PING_EVENT_TYPE as g, LegacyEventType as h, ApiVersionSchema as i, SubscriptionSummarySchema as it, AccountMeterStateSchema as j, AccountLocaleSchema as k, EVENT_TYPES as l, LEGACY_EVENT_TYPES as m, AnyBillingEvent as n, SubscriptionStatusSchema as nt, BillingEventOf as o, FULL_STATE_EVENT_TYPES as p, AccountUpsertInput as q, AnyBillingEventSchema as r, SubscriptionSummary as rt, BillingEventSchema as s, AccountStateChangeCause as t, SubscriptionStatus as tt, EventDetail as u, PingSchema as v, AccountDeleteResponse as w, AccessState as x, isEventType as y, AccountProfileStateSchema as z };