@stewardhq/sdk 0.2.0 → 0.5.0

package/dist/_chunks/index.d.ts

@@ -1,4 +1,4 @@
-import { G as EntitlementSnapshot, f as EventType, q as SubscriptionStatus } from "./events.js";
+import { $ as EntitlementSnapshot, U as AccountState, f as EventType, tt as SubscriptionStatus } from "./events.js";
 import { z } from "zod";
 //#region ../contract/src/common.d.ts
 declare const API_VERSION = "2026-10-01";
@@ -26,6 +26,33 @@ type EntitlementValue = z.infer<typeof EntitlementValueSchema>;
 declare const EntitlementsSchema: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodBoolean, z.ZodString, z.ZodNull]>>;
 type Entitlements = z.infer<typeof EntitlementsSchema>;
 declare const MetadataSchema: z.ZodRecord<z.ZodString, z.ZodString>;
+/**
+ * Why an invoice was written (Polar `billing_reason`): `subscription_create` first period,
+ * `subscription_cycle` renewal (phase 2 adds overage lines to it), `subscription_update` plan
+ * change, `purchase` reserved (one-off purchases are deferred), `manual` staff-written.
+ */
+declare const INVOICE_BILLING_REASONS: readonly ["subscription_create", "subscription_cycle", "subscription_update", "purchase", "manual"];
+declare const InvoiceBillingReasonSchema: z.ZodEnum<{
+  subscription_create: "subscription_create";
+  subscription_cycle: "subscription_cycle";
+  subscription_update: "subscription_update";
+  purchase: "purchase";
+  manual: "manual";
+}>;
+type InvoiceBillingReason = z.infer<typeof InvoiceBillingReasonSchema>;
+/**
+ * Collection state of an invoice written before payment: `unpaid` (open, has `dueAt`), `paid`,
+ * `uncollectible` (given up after dunning), `waived` (operator forgave it). Invoices written the
+ * pre-billing-core way (after a payment, manual invoices) carry no payment status.
+ */
+declare const INVOICE_PAYMENT_STATUSES: readonly ["unpaid", "paid", "uncollectible", "waived"];
+declare const InvoicePaymentStatusSchema: z.ZodEnum<{
+  unpaid: "unpaid";
+  paid: "paid";
+  uncollectible: "uncollectible";
+  waived: "waived";
+}>;
+type InvoicePaymentStatus = z.infer<typeof InvoicePaymentStatusSchema>;
 declare const ERROR_CATEGORIES: readonly ["validation", "not_found", "conflict", "config", "provider", "unavailable"];
 declare const ErrorCategorySchema: z.ZodEnum<{
   validation: "validation";
@@ -58,6 +85,602 @@ declare const ErrorResponseSchema: z.ZodObject<{
 }, z.core.$strip>;
 type ErrorResponse = z.infer<typeof ErrorResponseSchema>;
 //#endregion
+//#region ../contract/src/meters.d.ts
+declare const METER_FILTER_OPERATORS: readonly ["eq", "ne", "gt", "gte", "lt", "lte", "like", "not_like"];
+type MeterFilterOperator = (typeof METER_FILTER_OPERATORS)[number];
+/** Deepest nesting of `and`/`or` groups. */
+declare const METER_FILTER_MAX_DEPTH = 3;
+/** Most conditions in one filter. */
+declare const METER_FILTER_MAX_CONDITIONS = 20;
+type MeterFilterValue = string | number | boolean;
+type MeterFilterOperand = {
+  readonly eq: MeterFilterValue;
+} | {
+  readonly ne: MeterFilterValue;
+} | {
+  readonly gt: number;
+} | {
+  readonly gte: number;
+} | {
+  readonly lt: number;
+} | {
+  readonly lte: number;
+} | {
+  readonly like: string;
+} | {
+  readonly not_like: string;
+};
+/** One condition: exactly one property (`name` or `metadata.<key>`). */
+type MeterFilterCondition = {
+  readonly [property: string]: MeterFilterValue | MeterFilterOperand;
+};
+type MeterFilterGroup = {
+  readonly and: readonly MeterFilter[];
+} | {
+  readonly or: readonly MeterFilter[];
+};
+type MeterFilter = MeterFilterGroup | MeterFilterCondition;
+/** A condition in explicit form. `property` is `name` or `metadata.<key>`. */
+type MeterFilterClause = {
+  property: string;
+  operator: MeterFilterOperator;
+  value: MeterFilterValue;
+};
+/**
+ * The explicit form of a condition, or `null` when it is not a valid condition (the schema reports
+ * why). `{name: "x"}` → `{property: "name", operator: "eq", value: "x"}`.
+ */
+declare function meterFilterClauseOf(condition: MeterFilterCondition): MeterFilterClause | null;
+/** Meter filter (see the syntax above). Validates structure; the value is kept as given. */
+declare const MeterFilterSchema: z.ZodCustom<MeterFilter, MeterFilter>;
+/**
+ * Canonical form of a valid filter: every condition explicit (`{name: "x"}` → `{name: {eq: "x"}}`),
+ * a fresh object. Two filters that differ only by the shorthand have the same canonical JSON
+ * (the lock check, M4, compares canonical filters). Throws on an invalid filter.
+ */
+declare function canonicalMeterFilter(filter: MeterFilter): MeterFilter;
+/**
+ * What a meter computes over its matching events in a period (M4; no `min`/`avg`):
+ * `count` events; `sum` / `max` of the finite, non-negative number at `metadata.<key>` (decimals
+ * allowed); `unique` count of distinct values at `metadata.<key>`. An event without a usable
+ * value adds nothing to that meter (`invalid_value`, shown by doctor).
+ */
+declare const METER_AGGREGATION_KINDS: readonly ["count", "sum", "max", "unique"];
+type MeterAggregationKind = (typeof METER_AGGREGATION_KINDS)[number];
+declare const MeterAggregationSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  kind: z.ZodLiteral<"count">;
+}, z.core.$strip>, z.ZodObject<{
+  kind: z.ZodLiteral<"sum">;
+  key: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+  kind: z.ZodLiteral<"max">;
+  key: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+  kind: z.ZodLiteral<"unique">;
+  key: z.ZodString;
+}, z.core.$strip>], "kind">;
+type MeterAggregation = z.infer<typeof MeterAggregationSchema>;
+/** Largest unit amount in a definition (credit, rollover cap, credit grant): exact as a JSON number. */
+declare const MAX_METER_UNITS = 1000000000000000;
+/** Default `lowAt` (M14): standing becomes `low` at 80% of the credit. */
+declare const DEFAULT_METER_LOW_AT = 0.8;
+/** A positive unit amount in a definition: at most 6 decimals (M4), at most `MAX_METER_UNITS`. */
+declare const MeterUnitsSchema: z.ZodNumber;
+/** Customer-facing text per locale (hosted checkout and portal). Both locales are required. */
+declare const MeterLabelSchema: z.ZodObject<{
+  tr: z.ZodString;
+  en: z.ZodString;
+}, z.core.$strip>;
+type MeterLabel = z.infer<typeof MeterLabelSchema>;
+/** Share of the credit at which standing becomes `low`: 0 < x ≤ 1, at most 6 decimals. */
+declare const MeterLowAtSchema: z.ZodNumber;
+/**
+ * Meter definition (catalog sync input; the record key is the meter code). Input takes `event`
+ * and/or `filter`; the output has only `filter`, canonical, `event` folded in (`{and: [{name:
+ * {eq: event}}, …filter]}`). Filter and aggregation lock once the meter's first period opened
+ * (`422 meter_locked`; M4): a change means a new code.
+ */
+declare const MeterDefSchema: z.ZodPipe<z.ZodObject<{
+  event: z.ZodOptional<z.ZodString>;
+  filter: z.ZodOptional<z.ZodCustom<MeterFilter, MeterFilter>>;
+  aggregation: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"count">;
+  }, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"sum">;
+    key: z.ZodString;
+  }, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"max">;
+    key: z.ZodString;
+  }, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"unique">;
+    key: z.ZodString;
+  }, z.core.$strip>], "kind">;
+  label: z.ZodObject<{
+    tr: z.ZodString;
+    en: z.ZodString;
+  }, z.core.$strip>;
+  unitLabel: z.ZodOptional<z.ZodObject<{
+    tr: z.ZodString;
+    en: z.ZodString;
+  }, z.core.$strip>>;
+  displayPer: z.ZodOptional<z.ZodNumber>;
+  lowAt: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strip>, z.ZodTransform<{
+  aggregation: {
+    kind: "count";
+  } | {
+    kind: "sum";
+    key: string;
+  } | {
+    kind: "max";
+    key: string;
+  } | {
+    kind: "unique";
+    key: string;
+  };
+  label: {
+    tr: string;
+    en: string;
+  };
+  lowAt: number | null;
+  unitLabel?: {
+    tr: string;
+    en: string;
+  } | undefined;
+  displayPer?: number | undefined;
+  filter: MeterFilter;
+}, {
+  aggregation: {
+    kind: "count";
+  } | {
+    kind: "sum";
+    key: string;
+  } | {
+    kind: "max";
+    key: string;
+  } | {
+    kind: "unique";
+    key: string;
+  };
+  label: {
+    tr: string;
+    en: string;
+  };
+  lowAt: number | null;
+  event?: string | undefined;
+  filter?: MeterFilter | undefined;
+  unitLabel?: {
+    tr: string;
+    en: string;
+  } | undefined;
+  displayPer?: number | undefined;
+}>>;
+type MeterDef = z.output<typeof MeterDefSchema>;
+type MeterDefInput = z.input<typeof MeterDefSchema>;
+/**
+ * A meter as returned by `GET /v1/catalog` (active meters). Lenient for forward compatibility: a
+ * newer steward may use filter or aggregation forms this version does not define; narrow `filter`
+ * with `MeterFilterSchema` and `aggregation` with `MeterAggregationSchema`.
+ */
+declare const CatalogMeterSchema: z.ZodObject<{
+  filter: z.ZodUnknown;
+  aggregation: z.ZodObject<{
+    kind: z.ZodString;
+    key: z.ZodOptional<z.ZodString>;
+  }, z.core.$loose>;
+  label: z.ZodObject<{
+    tr: z.ZodString;
+    en: z.ZodString;
+  }, z.core.$strip>;
+  unitLabel: z.ZodOptional<z.ZodObject<{
+    tr: z.ZodString;
+    en: z.ZodString;
+  }, z.core.$strip>>;
+  displayPer: z.ZodOptional<z.ZodNumber>;
+  lowAt: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+type CatalogMeter = z.infer<typeof CatalogMeterSchema>;
+/**
+ * `meter_credit` benefit properties (M5, M6): `units` granted at the start of every meter period
+ * (plan + add-ons for the same meter add up; the default plan's credit only when no other layer
+ * credits the meter — `meterCreditsOf`); `rolloverCapUnits` turns rollover on — the unused
+ * balance carries over up to the cap (absent: unused credit expires; debt never carries).
+ */
+declare const MeterCreditPropertiesSchema: z.ZodObject<{
+  meter: z.ZodString;
+  units: z.ZodNumber;
+  rolloverCapUnits: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+type MeterCreditProperties = z.infer<typeof MeterCreditPropertiesSchema>;
+/** Largest `perUnits` of a metered price. */
+declare const MAX_METERED_PRICE_PER_UNITS = 1000000000000;
+/**
+ * Metered price (catalog sync input; MF5, M20): overage above the credit is billed
+ * `amountMinor` per `perUnits` units ("₺12,50 / 1.000 token" = `{amountMinor: 1250, perUnits:
+ * 1000}`; an integer pair, no decimal unit price). Key `(planCode, meter, currency)`. Tax terms
+ * must equal the plan's base prices in that currency (`metered_price_tax_mismatch`). `capMinor`
+ * caps the overage amount per meter period. Mutable in place like base prices (M36); a
+ * subscription locks the rate it started with.
+ */
+declare const MeteredPriceDefSchema: z.ZodObject<{
+  planCode: z.ZodString;
+  meter: z.ZodString;
+  currency: z.ZodString;
+  amountMinor: z.ZodNumber;
+  perUnits: z.ZodNumber;
+  taxInclusive: z.ZodBoolean;
+  taxRateBps: z.ZodNumber;
+  capMinor: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+type MeteredPriceDef = z.infer<typeof MeteredPriceDefSchema>;
+/** Metered price as returned by `GET /v1/catalog` (active ones). */
+declare const MeteredPriceSchema: z.ZodObject<{
+  planCode: z.ZodString;
+  meter: z.ZodString;
+  currency: z.ZodString;
+  amountMinor: z.ZodNumber;
+  perUnits: z.ZodNumber;
+  taxInclusive: z.ZodBoolean;
+  taxRateBps: z.ZodNumber;
+  id: z.ZodUUID;
+  active: z.ZodBoolean;
+  capMinor: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+  createdAt: z.ZodISODateTime;
+}, z.core.$strip>;
+type MeteredPrice = z.infer<typeof MeteredPriceSchema>;
+/**
+ * Credit standing of a meter in its period (M14): `low` once consumption reaches `lowAt` × credit,
+ * `exhausted` once the balance is ≤ 0; a meter without credit is always `ok`. Standing describes
+ * the credit only: a billable meter (metered price) keeps working past `exhausted` (M15).
+ */
+declare const METER_STANDINGS: readonly ["ok", "low", "exhausted"];
+declare const MeterStandingSchema: z.ZodEnum<{
+  ok: "ok";
+  low: "low";
+  exhausted: "exhausted";
+}>;
+type MeterStanding = z.infer<typeof MeterStandingSchema>;
+/**
+ * Units as a decimal string (invoice lines, meter charges): non-negative, at most 6 decimals.
+ * Steward writes the canonical form (`microToDecimalString`: no exponent, no trailing zeros).
+ */
+declare const DecimalUnitsStringSchema: z.ZodString;
+/** One meter of `GET /v1/accounts/:ref/meters`: the meter's OPEN period (periods are per meter, M7). */
+declare const AccountMeterSchema: z.ZodObject<{
+  periodStart: z.ZodISODateTime;
+  periodEnd: z.ZodISODateTime;
+  includedUnits: z.ZodNullable<z.ZodNumber>;
+  consumedUnits: z.ZodNumber;
+  creditedUnits: z.ZodNumber;
+  balance: z.ZodNumber;
+  overageUnits: z.ZodNumber;
+  standing: z.ZodEnum<{
+    ok: "ok";
+    low: "low";
+    exhausted: "exhausted";
+  }>;
+  billable: z.ZodBoolean;
+  amountDueMinor: z.ZodNullable<z.ZodNumber>;
+  currency: z.ZodNullable<z.ZodString>;
+  capReached: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+type AccountMeter = z.infer<typeof AccountMeterSchema>;
+/**
+ * `GET /v1/accounts/:ref/meters` (M13): a meter READ, not a second state model — no version, no
+ * events. ETag = the account's `meters_seq` (rollup and credit writes); `If-None-Match` → 304.
+ * `rolledUpThrough`: events received before this moment are counted.
+ */
+declare const AccountMetersSchema: z.ZodObject<{
+  ref: z.ZodString;
+  asOf: z.ZodISODateTime;
+  rolledUpThrough: z.ZodISODateTime;
+  meters: z.ZodRecord<z.ZodString, z.ZodObject<{
+    periodStart: z.ZodISODateTime;
+    periodEnd: z.ZodISODateTime;
+    includedUnits: z.ZodNullable<z.ZodNumber>;
+    consumedUnits: z.ZodNumber;
+    creditedUnits: z.ZodNumber;
+    balance: z.ZodNumber;
+    overageUnits: z.ZodNumber;
+    standing: z.ZodEnum<{
+      ok: "ok";
+      low: "low";
+      exhausted: "exhausted";
+    }>;
+    billable: z.ZodBoolean;
+    amountDueMinor: z.ZodNullable<z.ZodNumber>;
+    currency: z.ZodNullable<z.ZodString>;
+    capReached: z.ZodOptional<z.ZodBoolean>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type AccountMeters = z.infer<typeof AccountMetersSchema>;
+declare const METER_PERIOD_STATUSES: readonly ["open", "closing", "closed"];
+declare const MeterPeriodStatusSchema: z.ZodEnum<{
+  open: "open";
+  closing: "closing";
+  closed: "closed";
+}>;
+type MeterPeriodStatus = z.infer<typeof MeterPeriodStatusSchema>;
+/** A meter period (`GET /v1/accounts/:ref/meters/periods`; closed periods, newest first). */
+declare const MeterPeriodSchema: z.ZodObject<{
+  meter: z.ZodString;
+  periodStart: z.ZodISODateTime;
+  periodEnd: z.ZodISODateTime;
+  status: z.ZodEnum<{
+    open: "open";
+    closing: "closing";
+    closed: "closed";
+  }>;
+  subscriptionId: z.ZodNullable<z.ZodUUID>;
+  consumedUnits: z.ZodNumber;
+  creditedUnits: z.ZodNumber;
+  overageUnits: z.ZodNumber;
+  closedAt: z.ZodNullable<z.ZodISODateTime>;
+}, z.core.$strip>;
+type MeterPeriod = z.infer<typeof MeterPeriodSchema>;
+declare const MeterPeriodListSchema: z.ZodObject<{
+  ref: z.ZodString;
+  periods: z.ZodArray<z.ZodObject<{
+    meter: z.ZodString;
+    periodStart: z.ZodISODateTime;
+    periodEnd: z.ZodISODateTime;
+    status: z.ZodEnum<{
+      open: "open";
+      closing: "closing";
+      closed: "closed";
+    }>;
+    subscriptionId: z.ZodNullable<z.ZodUUID>;
+    consumedUnits: z.ZodNumber;
+    creditedUnits: z.ZodNumber;
+    overageUnits: z.ZodNumber;
+    closedAt: z.ZodNullable<z.ZodISODateTime>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type MeterPeriodList = z.infer<typeof MeterPeriodListSchema>;
+/**
+ * `POST /v1/accounts/:ref/credits` (M5): a one-off credit for the meter's open period (goodwill,
+ * campaign). Needs no benefit; recorded in the append-only credit ledger with the actor.
+ * Unknown meter: `422 meter_not_found`.
+ */
+declare const CreditGrantInputSchema: z.ZodObject<{
+  meter: z.ZodString;
+  units: z.ZodNumber;
+  reason: z.ZodString;
+}, z.core.$strip>;
+type CreditGrantInput = z.input<typeof CreditGrantInputSchema>;
+/** Credit ledger entry kinds (M5). Entries are never rewritten. */
+declare const METER_CREDIT_ENTRY_KINDS: readonly ["cycle_grant", "rollover", "plan_change", "manual_grant", "adjustment"];
+declare const MeterCreditEntryKindSchema: z.ZodEnum<{
+  cycle_grant: "cycle_grant";
+  rollover: "rollover";
+  plan_change: "plan_change";
+  manual_grant: "manual_grant";
+  adjustment: "adjustment";
+}>;
+type MeterCreditEntryKind = z.infer<typeof MeterCreditEntryKindSchema>;
+declare const MeterCreditEntrySchema: z.ZodObject<{
+  id: z.ZodUUID;
+  meter: z.ZodString;
+  kind: z.ZodEnum<{
+    cycle_grant: "cycle_grant";
+    rollover: "rollover";
+    plan_change: "plan_change";
+    manual_grant: "manual_grant";
+    adjustment: "adjustment";
+  }>;
+  units: z.ZodNumber;
+  periodStart: z.ZodISODateTime;
+  reason: z.ZodNullable<z.ZodString>;
+  actorRef: z.ZodNullable<z.ZodString>;
+  createdAt: z.ZodISODateTime;
+}, z.core.$strip>;
+type MeterCreditEntry = z.infer<typeof MeterCreditEntrySchema>;
+declare const METER_CHARGE_STATUSES: readonly ["dry_run", "carried", "invoiced"];
+declare const MeterChargeStatusSchema: z.ZodEnum<{
+  dry_run: "dry_run";
+  carried: "carried";
+  invoiced: "invoiced";
+}>;
+type MeterChargeStatus = z.infer<typeof MeterChargeStatusSchema>;
+/** One priced meter of a charge (M21): overage × locked rate, capped. Units are decimal strings. */
+declare const MeterChargeLineSchema: z.ZodObject<{
+  meter: z.ZodString;
+  consumedUnits: z.ZodString;
+  creditedUnits: z.ZodString;
+  overageUnits: z.ZodString;
+  priceAmountMinor: z.ZodNumber;
+  pricePerUnits: z.ZodNumber;
+  capMinor: z.ZodNullable<z.ZodNumber>;
+  amountMinor: z.ZodNumber;
+}, z.core.$strip>;
+type MeterChargeLine = z.infer<typeof MeterChargeLineSchema>;
+/**
+ * Pricing record of a closed meter period (M21; money data, never rewritten). Totals use the
+ * invoice rule (`meterChargeTotals`, one rounding). `status`: `dry_run` (chargeMode `dry_run`:
+ * recorded, not invoiced), `carried` (below `billing.minInvoiceMinor` on an overage-only invoice:
+ * carried into the next invoice), `invoiced` (`invoiceId` set). `carriedInMinor`: earlier carried
+ * amounts included here.
+ */
+declare const MeterChargeSchema: z.ZodObject<{
+  id: z.ZodUUID;
+  subscriptionId: z.ZodNullable<z.ZodUUID>;
+  periodStart: z.ZodISODateTime;
+  periodEnd: z.ZodISODateTime;
+  currency: z.ZodString;
+  taxInclusive: z.ZodBoolean;
+  taxRateBps: z.ZodNumber;
+  lines: z.ZodArray<z.ZodObject<{
+    meter: z.ZodString;
+    consumedUnits: z.ZodString;
+    creditedUnits: z.ZodString;
+    overageUnits: z.ZodString;
+    priceAmountMinor: z.ZodNumber;
+    pricePerUnits: z.ZodNumber;
+    capMinor: z.ZodNullable<z.ZodNumber>;
+    amountMinor: z.ZodNumber;
+  }, z.core.$strip>>;
+  subtotalMinor: z.ZodNumber;
+  taxMinor: z.ZodNumber;
+  totalMinor: z.ZodNumber;
+  carriedInMinor: z.ZodNumber;
+  status: z.ZodEnum<{
+    dry_run: "dry_run";
+    carried: "carried";
+    invoiced: "invoiced";
+  }>;
+  invoiceId: z.ZodNullable<z.ZodUUID>;
+  createdAt: z.ZodISODateTime;
+}, z.core.$strip>;
+type MeterCharge = z.infer<typeof MeterChargeSchema>;
+/** `GET /v1/accounts/:ref/meter-charges` (newest first). */
+declare const MeterChargeListSchema: z.ZodObject<{
+  ref: z.ZodString;
+  charges: z.ZodArray<z.ZodObject<{
+    id: z.ZodUUID;
+    subscriptionId: z.ZodNullable<z.ZodUUID>;
+    periodStart: z.ZodISODateTime;
+    periodEnd: z.ZodISODateTime;
+    currency: z.ZodString;
+    taxInclusive: z.ZodBoolean;
+    taxRateBps: z.ZodNumber;
+    lines: z.ZodArray<z.ZodObject<{
+      meter: z.ZodString;
+      consumedUnits: z.ZodString;
+      creditedUnits: z.ZodString;
+      overageUnits: z.ZodString;
+      priceAmountMinor: z.ZodNumber;
+      pricePerUnits: z.ZodNumber;
+      capMinor: z.ZodNullable<z.ZodNumber>;
+      amountMinor: z.ZodNumber;
+    }, z.core.$strip>>;
+    subtotalMinor: z.ZodNumber;
+    taxMinor: z.ZodNumber;
+    totalMinor: z.ZodNumber;
+    carriedInMinor: z.ZodNumber;
+    status: z.ZodEnum<{
+      dry_run: "dry_run";
+      carried: "carried";
+      invoiced: "invoiced";
+    }>;
+    invoiceId: z.ZodNullable<z.ZodUUID>;
+    createdAt: z.ZodISODateTime;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type MeterChargeList = z.infer<typeof MeterChargeListSchema>;
+//#endregion
+//#region ../contract/src/benefits.d.ts
+/** Benefit types this contract version defines. */
+declare const BENEFIT_TYPES: readonly ["feature_flag", "meter_credit"];
+declare const BenefitTypeSchema: z.ZodEnum<{
+  feature_flag: "feature_flag";
+  meter_credit: "meter_credit";
+}>;
+type BenefitType = z.infer<typeof BenefitTypeSchema>;
+/** Customer-facing description per locale (hosted checkout and portal "what's included"). */
+declare const BenefitDescriptionSchema: z.ZodObject<{
+  tr: z.ZodOptional<z.ZodString>;
+  en: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type BenefitDescription = z.infer<typeof BenefitDescriptionSchema>;
+/** `feature_flag` properties: catalog feature key → value (K4 typing; checked against `features` on catalog sync). */
+declare const FeatureFlagPropertiesSchema: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodBoolean, z.ZodString, z.ZodNull]>>;
+type FeatureFlagProperties = z.infer<typeof FeatureFlagPropertiesSchema>;
+declare const FeatureFlagBenefitDefSchema: z.ZodObject<{
+  type: z.ZodLiteral<"feature_flag">;
+  properties: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodBoolean, z.ZodString, z.ZodNull]>>;
+  description: z.ZodOptional<z.ZodObject<{
+    tr: z.ZodOptional<z.ZodString>;
+    en: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type FeatureFlagBenefitDef = z.infer<typeof FeatureFlagBenefitDefSchema>;
+/** `meter_credit` definition (metering phase 2): the meter must be a catalog meter (checked on catalog sync). */
+declare const MeterCreditBenefitDefSchema: z.ZodObject<{
+  type: z.ZodLiteral<"meter_credit">;
+  properties: z.ZodObject<{
+    meter: z.ZodString;
+    units: z.ZodNumber;
+    rolloverCapUnits: z.ZodOptional<z.ZodNumber>;
+  }, z.core.$strip>;
+  description: z.ZodOptional<z.ZodObject<{
+    tr: z.ZodOptional<z.ZodString>;
+    en: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type MeterCreditBenefitDef = z.infer<typeof MeterCreditBenefitDefSchema>;
+/** Catalog benefit definition (catalog sync input), discriminated by `type`. */
+declare const BenefitDefSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  type: z.ZodLiteral<"feature_flag">;
+  properties: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodBoolean, z.ZodString, z.ZodNull]>>;
+  description: z.ZodOptional<z.ZodObject<{
+    tr: z.ZodOptional<z.ZodString>;
+    en: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"meter_credit">;
+  properties: z.ZodObject<{
+    meter: z.ZodString;
+    units: z.ZodNumber;
+    rolloverCapUnits: z.ZodOptional<z.ZodNumber>;
+  }, z.core.$strip>;
+  description: z.ZodOptional<z.ZodObject<{
+    tr: z.ZodOptional<z.ZodString>;
+    en: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+}, z.core.$strip>], "type">;
+type BenefitDef = z.infer<typeof BenefitDefSchema>;
+/**
+ * Benefit definition as returned by `GET /v1/catalog`. `type` is an open set (a newer steward may
+ * return types this version does not define); narrow with `type === "feature_flag"`.
+ */
+declare const CatalogBenefitSchema: z.ZodObject<{
+  type: z.ZodString;
+  properties: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+  description: z.ZodOptional<z.ZodObject<{
+    tr: z.ZodOptional<z.ZodString>;
+    en: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type CatalogBenefit = z.infer<typeof CatalogBenefitSchema>;
+/**
+ * Where a granted benefit comes from, e.g. `plan:<code>` (default plan or a live subscription's
+ * plan), `grant:<id>` (a grant), `override` (account overrides). Open set: informational.
+ */
+declare const BenefitSourceSchema: z.ZodString;
+/**
+ * A benefit granted to the account (`AccountState.benefits[]`; Polar granted benefit).
+ * `code` is the catalog benefit code; `null` for an implicit benefit that has no catalog code
+ * (a plan's entitlement matrix, account overrides). `type` is an open set (see
+ * `CatalogBenefitSchema`); `properties` are the values granted.
+ */
+declare const AccountBenefitSchema: 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>;
+type AccountBenefit = z.infer<typeof AccountBenefitSchema>;
+type FeatureFlagAccountBenefit = AccountBenefit & {
+  type: "feature_flag";
+  properties: FeatureFlagProperties;
+};
+/** Narrows a granted benefit to `feature_flag` (type and property values checked). */
+declare function isFeatureFlagBenefit(benefit: AccountBenefit): benefit is FeatureFlagAccountBenefit;
+type MeterCreditAccountBenefit = AccountBenefit & {
+  type: "meter_credit";
+  properties: MeterCreditProperties;
+};
+/** Narrows a granted benefit to `meter_credit` (type and properties checked). */
+declare function isMeterCreditBenefit(benefit: AccountBenefit): benefit is MeterCreditAccountBenefit;
+/** Feature types (same values as `FeatureTypeSchema` in `catalog.ts`). */
+type BenefitFeatureType = "limit" | "boolean" | "string";
+/**
+ * Whether a value fits a feature type (K4): `limit` → integer ≥ 0 or `null` (unlimited),
+ * `boolean` → boolean, `string` → string. `null` is only valid for `limit`.
+ */
+declare function featureValueMatchesType(type: BenefitFeatureType, value: EntitlementValue): boolean;
+//#endregion
 //#region ../contract/src/catalog.d.ts
 declare const FeatureTypeSchema: z.ZodEnum<{
   string: "string";
@@ -74,14 +697,28 @@ declare const FeatureDefSchema: z.ZodObject<{
   description: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 type FeatureDef = z.infer<typeof FeatureDefSchema>;
+/** Upper bound of benefits a plan lists. */
+declare const MAX_PLAN_BENEFITS = 100;
+/** Plan in the catalog sync input. */
 declare const PlanDefSchema: z.ZodObject<{
   code: z.ZodString;
   name: z.ZodString;
-  rank: z.ZodNumber;
+  rank: z.ZodDefault<z.ZodNumber>;
   sellable: z.ZodBoolean;
   entitlements: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodBoolean, z.ZodString, z.ZodNull]>>;
+  benefits: z.ZodDefault<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 type PlanDef = z.infer<typeof PlanDefSchema>;
+/** Plan as returned by `GET /v1/catalog`. */
+declare const CatalogPlanSchema: z.ZodObject<{
+  code: z.ZodString;
+  name: z.ZodString;
+  rank: z.ZodDefault<z.ZodNumber>;
+  sellable: z.ZodBoolean;
+  entitlements: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodBoolean, z.ZodString, z.ZodNull]>>;
+  benefits: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+type CatalogPlan = z.infer<typeof CatalogPlanSchema>;
 declare const PriceDefSchema: z.ZodObject<{
   planCode: z.ZodString;
   interval: z.ZodEnum<{
@@ -95,6 +732,14 @@ declare const PriceDefSchema: z.ZodObject<{
   taxRateBps: z.ZodNumber;
 }, z.core.$strip>;
 type PriceDef = z.infer<typeof PriceDefSchema>;
+/** Upper bound of benefit definitions in one catalog. */
+declare const MAX_CATALOG_BENEFITS = 200;
+/** Upper bound of meters in one catalog. */
+declare const MAX_CATALOG_METERS = 100;
+/** Upper bound of metered prices in one catalog. */
+declare const MAX_CATALOG_METERED_PRICES = 500;
+/** Issue `params.code` of a metered price whose tax terms differ from the plan's base price (M20). */
+declare const METERED_PRICE_TAX_MISMATCH = "metered_price_tax_mismatch";
 declare const CatalogSyncInputSchema: z.ZodObject<{
   defaultPlanCode: z.ZodString;
   features: z.ZodArray<z.ZodObject<{
@@ -109,9 +754,10 @@ declare const CatalogSyncInputSchema: z.ZodObject<{
   plans: z.ZodArray<z.ZodObject<{
     code: z.ZodString;
     name: z.ZodString;
-    rank: z.ZodNumber;
+    rank: z.ZodDefault<z.ZodNumber>;
     sellable: z.ZodBoolean;
     entitlements: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodBoolean, z.ZodString, z.ZodNull]>>;
+    benefits: z.ZodDefault<z.ZodArray<z.ZodString>>;
   }, z.core.$strip>>;
   prices: z.ZodArray<z.ZodObject<{
     planCode: z.ZodString;
@@ -125,6 +771,110 @@ declare const CatalogSyncInputSchema: z.ZodObject<{
     taxInclusive: z.ZodBoolean;
     taxRateBps: z.ZodNumber;
   }, z.core.$strip>>;
+  benefits: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"feature_flag">;
+    properties: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodBoolean, z.ZodString, z.ZodNull]>>;
+    description: z.ZodOptional<z.ZodObject<{
+      tr: z.ZodOptional<z.ZodString>;
+      en: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"meter_credit">;
+    properties: z.ZodObject<{
+      meter: z.ZodString;
+      units: z.ZodNumber;
+      rolloverCapUnits: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    description: z.ZodOptional<z.ZodObject<{
+      tr: z.ZodOptional<z.ZodString>;
+      en: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+  }, z.core.$strip>], "type">>>;
+  meters: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodPipe<z.ZodObject<{
+    event: z.ZodOptional<z.ZodString>;
+    filter: z.ZodOptional<z.ZodCustom<MeterFilter, MeterFilter>>;
+    aggregation: z.ZodDiscriminatedUnion<[z.ZodObject<{
+      kind: z.ZodLiteral<"count">;
+    }, z.core.$strip>, z.ZodObject<{
+      kind: z.ZodLiteral<"sum">;
+      key: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+      kind: z.ZodLiteral<"max">;
+      key: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+      kind: z.ZodLiteral<"unique">;
+      key: z.ZodString;
+    }, z.core.$strip>], "kind">;
+    label: z.ZodObject<{
+      tr: z.ZodString;
+      en: z.ZodString;
+    }, z.core.$strip>;
+    unitLabel: z.ZodOptional<z.ZodObject<{
+      tr: z.ZodString;
+      en: z.ZodString;
+    }, z.core.$strip>>;
+    displayPer: z.ZodOptional<z.ZodNumber>;
+    lowAt: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+  }, z.core.$strip>, z.ZodTransform<{
+    aggregation: {
+      kind: "count";
+    } | {
+      kind: "sum";
+      key: string;
+    } | {
+      kind: "max";
+      key: string;
+    } | {
+      kind: "unique";
+      key: string;
+    };
+    label: {
+      tr: string;
+      en: string;
+    };
+    lowAt: number | null;
+    unitLabel?: {
+      tr: string;
+      en: string;
+    } | undefined;
+    displayPer?: number | undefined;
+    filter: MeterFilter;
+  }, {
+    aggregation: {
+      kind: "count";
+    } | {
+      kind: "sum";
+      key: string;
+    } | {
+      kind: "max";
+      key: string;
+    } | {
+      kind: "unique";
+      key: string;
+    };
+    label: {
+      tr: string;
+      en: string;
+    };
+    lowAt: number | null;
+    event?: string | undefined;
+    filter?: MeterFilter | undefined;
+    unitLabel?: {
+      tr: string;
+      en: string;
+    } | undefined;
+    displayPer?: number | undefined;
+  }>>>>;
+  meteredPrices: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    planCode: z.ZodString;
+    meter: z.ZodString;
+    currency: z.ZodString;
+    amountMinor: z.ZodNumber;
+    perUnits: z.ZodNumber;
+    taxInclusive: z.ZodBoolean;
+    taxRateBps: z.ZodNumber;
+    capMinor: z.ZodOptional<z.ZodNumber>;
+  }, z.core.$strip>>>;
 }, z.core.$strip>;
 type CatalogSyncInput = z.input<typeof CatalogSyncInputSchema>;
 declare const PriceSchema: z.ZodObject<{
@@ -158,9 +908,10 @@ declare const CatalogSchema: z.ZodObject<{
   plans: z.ZodArray<z.ZodObject<{
     code: z.ZodString;
     name: z.ZodString;
-    rank: z.ZodNumber;
+    rank: z.ZodDefault<z.ZodNumber>;
     sellable: z.ZodBoolean;
     entitlements: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodBoolean, z.ZodString, z.ZodNull]>>;
+    benefits: z.ZodOptional<z.ZodArray<z.ZodString>>;
   }, z.core.$strip>>;
   prices: z.ZodArray<z.ZodObject<{
     planCode: z.ZodString;
@@ -177,6 +928,44 @@ declare const CatalogSchema: z.ZodObject<{
     active: z.ZodBoolean;
     createdAt: z.ZodISODateTime;
   }, z.core.$strip>>;
+  benefits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+    type: z.ZodString;
+    properties: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    description: z.ZodOptional<z.ZodObject<{
+      tr: z.ZodOptional<z.ZodString>;
+      en: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>>;
+  meters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+    filter: z.ZodUnknown;
+    aggregation: z.ZodObject<{
+      kind: z.ZodString;
+      key: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+    label: z.ZodObject<{
+      tr: z.ZodString;
+      en: z.ZodString;
+    }, z.core.$strip>;
+    unitLabel: z.ZodOptional<z.ZodObject<{
+      tr: z.ZodString;
+      en: z.ZodString;
+    }, z.core.$strip>>;
+    displayPer: z.ZodOptional<z.ZodNumber>;
+    lowAt: z.ZodNullable<z.ZodNumber>;
+  }, z.core.$strip>>>;
+  meteredPrices: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    planCode: z.ZodString;
+    meter: z.ZodString;
+    currency: z.ZodString;
+    amountMinor: z.ZodNumber;
+    perUnits: z.ZodNumber;
+    taxInclusive: z.ZodBoolean;
+    taxRateBps: z.ZodNumber;
+    id: z.ZodUUID;
+    active: z.ZodBoolean;
+    capMinor: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    createdAt: z.ZodISODateTime;
+  }, z.core.$strip>>>;
 }, z.core.$strip>;
 type Catalog = z.infer<typeof CatalogSchema>;
 declare const CatalogSyncResultSchema: z.ZodObject<{
@@ -192,6 +981,14 @@ declare const CatalogSyncResultSchema: z.ZodObject<{
     provider: z.ZodString;
     code: z.ZodString;
   }, z.core.$strip>>;
+  changedBenefits: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  archivedBenefits: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  updatedPrices: z.ZodOptional<z.ZodArray<z.ZodUUID>>;
+  changedMeters: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  archivedMeters: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  createdMeteredPrices: z.ZodOptional<z.ZodArray<z.ZodUUID>>;
+  updatedMeteredPrices: z.ZodOptional<z.ZodArray<z.ZodUUID>>;
+  deactivatedMeteredPrices: z.ZodOptional<z.ZodArray<z.ZodUUID>>;
 }, z.core.$strip>;
 type CatalogSyncResult = z.infer<typeof CatalogSyncResultSchema>;
 /** `POST /v1/admin/accounts/refresh` — ürünün tüm hesaplarının snapshot'ı yeniden hesaplanır. */
@@ -201,6 +998,16 @@ declare const AccountsRefreshResultSchema: z.ZodObject<{
 type AccountsRefreshResult = z.infer<typeof AccountsRefreshResultSchema>;
 //#endregion
 //#region ../contract/src/checkout.d.ts
+/**
+ * Identity number sent to the payment provider (and, when the invoice needs one, used on the
+ * invoice) for an INDIVIDUAL buyer (M31): steward never asks for or stores a TCKN; the Turkish
+ * "final consumer" placeholder goes instead. A company buyer's VKN comes from the billing profile.
+ *
+ * It deliberately FAILS the TCKN checksum (`isValidTckn("11111111111") === false`): never run it
+ * through a TCKN validator and never show it as a customer's TCKN. Kept here, not in a provider
+ * adapter, because another provider may need a different rule.
+ */
+declare const INDIVIDUAL_IDENTITY_PLACEHOLDER = "11111111111";
 /** Accepted document — content lives in the product, steward keeps only the trace. */
 declare const ConsentSchema: z.ZodObject<{
   document: z.ZodString;
@@ -397,6 +1204,7 @@ declare const CheckoutSessionCreatedSchema: z.ZodObject<{
           year: "year";
         }>;
         effectiveAt: z.ZodISODateTime;
+        amountMinor: z.ZodOptional<z.ZodNumber>;
       }, z.core.$strip>>;
     }, z.core.$strip>>;
     openCheckout: z.ZodNullable<z.ZodObject<{
@@ -418,12 +1226,77 @@ declare const CheckoutSessionCreatedSchema: z.ZodObject<{
         company: "company";
       }>>;
     }, z.core.$strip>;
+    subscriptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      id: z.ZodUUID;
+      status: z.ZodEnum<{
+        active: "active";
+        suspended: "suspended";
+        past_due: "past_due";
+        canceled: "canceled";
+        expired: "expired";
+      }>;
+      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<{
+        subscription_create: "subscription_create";
+        subscription_cycle: "subscription_cycle";
+        subscription_update: "subscription_update";
+        purchase: "purchase";
+        manual: "manual";
+      }>;
+      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<{
+        ok: "ok";
+        low: "low";
+        exhausted: "exhausted";
+      }>;
+    }, z.core.$strip>>>;
   }, z.core.$strip>>;
 }, z.core.$strip>;
 type CheckoutSessionCreated = z.infer<typeof CheckoutSessionCreatedSchema>;
 /** `STATUS` value of the outcome redirect (`{STATUS}` placeholder in `successUrl`). */
 type CheckoutReturnStatus = "success" | "failed" | "pending";
-/** Redirect input: the stored session fields (service row, fake steward record). */
+/** Redirect input: the stored session fields (service row). */
 type CheckoutRedirectTarget = {
   id: string;
   successUrl: string;
@@ -431,14 +1304,14 @@ type CheckoutRedirectTarget = {
   accountRef: string;
 };
 /**
- * Browser redirect for a checkout outcome — the service and the fake steward share it.
+ * Browser redirect for a checkout outcome — used by the service.
  * Placeholders in `successUrl` (`{CHECKOUT_ID}` `{STATUS}` `{ACCOUNT_REF}` `{LOCALE}`) are
  * filled with URL-encoded values; nothing is appended, so a URL without placeholders is used
  * as-is. An encoded value cannot change the origin; it is still checked, and if the origin
  * would change the URL is returned unfilled.
  */
 declare function checkoutRedirectUrl(target: CheckoutRedirectTarget, status: CheckoutReturnStatus): string;
-declare const CHECKOUT_ERRORS: readonly ["account_not_found", "already_subscribed", "plan_not_sellable", "return_url_not_allowed", "provider_not_configured", "provider_error", "account_deleted"];
+declare const CHECKOUT_ERRORS: readonly ["account_not_found", "already_subscribed", "plan_not_sellable", "return_url_not_allowed", "provider_not_configured", "provider_error", "account_deleted", "meter_already_billed"];
 type CheckoutError = (typeof CHECKOUT_ERRORS)[number];
 //#endregion
 //#region ../contract/src/portal.d.ts
@@ -500,6 +1373,32 @@ declare const CancelSubscriptionInputSchema: z.ZodObject<{
   skipProvider: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
 type CancelSubscriptionInput = z.input<typeof CancelSubscriptionInputSchema>;
+/**
+ * `POST /v1/subscriptions/{id}/change` (billing core MF9): schedule a change for the next period
+ * boundary (`AccountState.subscription.scheduledChange`); the next renewal invoice is written from
+ * the new terms. `planCode` / `interval` pick another price of the subscription's currency;
+ * `price: "current"` re-locks the current amount of the (possibly updated) price and the plan's
+ * current metered rates — a metered price added later is attached only this way (M20, M36). At
+ * least one of the three. `when` is required so other timings can be added later. A second change
+ * replaces the first; asking for the current plan and interval while a change is pending takes it
+ * back ("keep my plan"; a move to the current price the operator announced stays).
+ * Errors: 404 `subscription_not_found`; 409 `already_subscribed` (another live subscription of the
+ * account holds the target plan or is moving to it), `meter_already_billed` (the target prices a
+ * meter another live subscription bills; for `price: "current"` only when that is the only
+ * difference); 422 `plan_not_found`, `plan_not_sellable`, `subscription_change_invalid` (no such
+ * price, nothing changes, the subscription is not live, has a cancellation scheduled or is a legacy
+ * provider subscription).
+ */
+declare const SubscriptionChangeInputSchema: z.ZodObject<{
+  planCode: z.ZodOptional<z.ZodString>;
+  interval: z.ZodOptional<z.ZodEnum<{
+    month: "month";
+    year: "year";
+  }>>;
+  price: z.ZodOptional<z.ZodLiteral<"current">>;
+  when: z.ZodLiteral<"next_period">;
+}, z.core.$strip>;
+type SubscriptionChangeInput = z.input<typeof SubscriptionChangeInputSchema>;
 declare const PaymentSchema: z.ZodObject<{
   id: z.ZodUUID;
   subscriptionId: z.ZodUUID;
@@ -515,9 +1414,12 @@ declare const PaymentSchema: z.ZodObject<{
   occurredAt: z.ZodISODateTime;
 }, z.core.$strip>;
 type Payment = z.infer<typeof PaymentSchema>;
+/** Upper bound of named benefits in one grant. */
+declare const MAX_GRANT_BENEFITS = 100;
 declare const GrantCreateInputSchema: z.ZodObject<{
   planCode: z.ZodOptional<z.ZodString>;
   overrides: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodBoolean, z.ZodString, z.ZodNull]>>>;
+  benefitCodes: z.ZodOptional<z.ZodArray<z.ZodString>>;
   reason: z.ZodString;
   startsAt: z.ZodOptional<z.ZodISODateTime>;
   endsAt: z.ZodOptional<z.ZodISODateTime>;
@@ -528,6 +1430,7 @@ declare const GrantSchema: z.ZodObject<{
   accountRef: z.ZodString;
   planCode: z.ZodNullable<z.ZodString>;
   overrides: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodBoolean, z.ZodString, z.ZodNull]>>;
+  benefitCodes: z.ZodOptional<z.ZodArray<z.ZodString>>;
   reason: z.ZodString;
   actorRef: z.ZodNullable<z.ZodString>;
   startsAt: z.ZodISODateTime;
@@ -560,6 +1463,10 @@ declare const InvoiceLineSchema: z.ZodObject<{
   quantity: z.ZodNumber;
   unitAmountMinor: z.ZodNumber;
   amountMinor: z.ZodNumber;
+  meter: z.ZodOptional<z.ZodString>;
+  units: z.ZodOptional<z.ZodString>;
+  priceAmountMinor: z.ZodOptional<z.ZodNumber>;
+  pricePerUnits: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 type InvoiceLine = z.infer<typeof InvoiceLineSchema>;
 declare const InvoiceSchema: z.ZodObject<{
@@ -598,6 +1505,10 @@ declare const InvoiceSchema: z.ZodObject<{
     quantity: z.ZodNumber;
     unitAmountMinor: z.ZodNumber;
     amountMinor: z.ZodNumber;
+    meter: z.ZodOptional<z.ZodString>;
+    units: z.ZodOptional<z.ZodString>;
+    priceAmountMinor: z.ZodOptional<z.ZodNumber>;
+    pricePerUnits: z.ZodOptional<z.ZodNumber>;
   }, z.core.$strip>>;
   issuer: z.ZodString;
   externalRef: z.ZodNullable<z.ZodString>;
@@ -608,6 +1519,21 @@ declare const InvoiceSchema: z.ZodObject<{
   note: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   voidedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
   voidReason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  billingReason: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+    subscription_create: "subscription_create";
+    subscription_cycle: "subscription_cycle";
+    subscription_update: "subscription_update";
+    purchase: "purchase";
+    manual: "manual";
+  }>>>;
+  paymentStatus: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+    unpaid: "unpaid";
+    paid: "paid";
+    uncollectible: "uncollectible";
+    waived: "waived";
+  }>>>;
+  periodStart: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+  periodEnd: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
 }, z.core.$strip>;
 type Invoice = z.infer<typeof InvoiceSchema>;
 declare const InvoiceIssueInputSchema: z.ZodObject<{
@@ -649,6 +1575,34 @@ declare const InvoiceVoidInputSchema: z.ZodObject<{
   reason: z.ZodString;
 }, z.core.$strip>;
 type InvoiceVoidInput = z.input<typeof InvoiceVoidInputSchema>;
+/**
+ * `POST /v1/invoices/{id}/payment-sessions` — opens steward's hosted pay page for an unpaid
+ * invoice (the product's own "Pay invoice" button; emails and the portal link to the same page).
+ * 409 `invoice_not_payable` when the invoice is not unpaid.
+ */
+declare const InvoicePaymentSessionCreateInputSchema: z.ZodObject<{
+  locale: z.ZodOptional<z.ZodEnum<{
+    tr: "tr";
+    en: "en";
+  }>>;
+  returnUrl: z.ZodOptional<z.ZodURL>;
+}, z.core.$strip>;
+type InvoicePaymentSessionCreateInput = z.input<typeof InvoicePaymentSessionCreateInputSchema>;
+/** Pay page session: redirect the customer to `url` (it carries the page key; do not log it). */
+declare const InvoicePaymentSessionSchema: z.ZodObject<{
+  id: z.ZodUUID;
+  url: z.ZodString;
+  expiresAt: z.ZodISODateTime;
+}, z.core.$strip>;
+type InvoicePaymentSession = z.infer<typeof InvoicePaymentSessionSchema>;
+/**
+ * `POST /v1/invoices/{id}/waive` — an operator forgives an unpaid invoice (`paymentStatus:
+ * "waived"`, e.g. before deleting the account). 409 `invoice_not_waivable` otherwise.
+ */
+declare const InvoiceWaiveInputSchema: z.ZodObject<{
+  reason: z.ZodString;
+}, z.core.$strip>;
+type InvoiceWaiveInput = z.input<typeof InvoiceWaiveInputSchema>;
 /**
  * Vergi dahil tutardan matrah ve vergiyi ayrıştırır (tam sayı, kuruşa
  * yuvarlama). Toplam her zaman korunur: subtotal + tax === total.
@@ -717,6 +1671,11 @@ declare const AccountDetailSchema: z.ZodObject<{
       cancelAt: z.ZodNullable<z.ZodISODateTime>;
     }, z.core.$strip>>;
   }, z.core.$strip>;
+  notificationEmails: z.ZodDefault<z.ZodArray<z.ZodString>>;
+  locale: z.ZodDefault<z.ZodNullable<z.ZodEnum<{
+    tr: "tr";
+    en: "en";
+  }>>>;
   profile: z.ZodOptional<z.ZodNullable<z.ZodObject<{
     kind: z.ZodEnum<{
       individual: "individual";
@@ -845,6 +1804,10 @@ declare const AccountDetailSchema: z.ZodObject<{
       quantity: z.ZodNumber;
       unitAmountMinor: z.ZodNumber;
       amountMinor: z.ZodNumber;
+      meter: z.ZodOptional<z.ZodString>;
+      units: z.ZodOptional<z.ZodString>;
+      priceAmountMinor: z.ZodOptional<z.ZodNumber>;
+      pricePerUnits: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
     issuer: z.ZodString;
     externalRef: z.ZodNullable<z.ZodString>;
@@ -855,12 +1818,28 @@ declare const AccountDetailSchema: z.ZodObject<{
     note: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     voidedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
     voidReason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    billingReason: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+      subscription_create: "subscription_create";
+      subscription_cycle: "subscription_cycle";
+      subscription_update: "subscription_update";
+      purchase: "purchase";
+      manual: "manual";
+    }>>>;
+    paymentStatus: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+      unpaid: "unpaid";
+      paid: "paid";
+      uncollectible: "uncollectible";
+      waived: "waived";
+    }>>>;
+    periodStart: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+    periodEnd: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
   }, z.core.$strip>>>;
   grants: z.ZodOptional<z.ZodArray<z.ZodObject<{
     id: z.ZodUUID;
     accountRef: z.ZodString;
     planCode: z.ZodNullable<z.ZodString>;
     overrides: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodBoolean, z.ZodString, z.ZodNull]>>;
+    benefitCodes: z.ZodOptional<z.ZodArray<z.ZodString>>;
     reason: z.ZodString;
     actorRef: z.ZodNullable<z.ZodString>;
     startsAt: z.ZodISODateTime;
@@ -904,6 +1883,11 @@ declare const AccountUpsertResponseSchema: z.ZodObject<{
       cancelAt: z.ZodNullable<z.ZodISODateTime>;
     }, z.core.$strip>>;
   }, z.core.$strip>;
+  notificationEmails: z.ZodDefault<z.ZodArray<z.ZodString>>;
+  locale: z.ZodDefault<z.ZodNullable<z.ZodEnum<{
+    tr: "tr";
+    en: "en";
+  }>>>;
   account: z.ZodOptional<z.ZodObject<{
     version: z.ZodNumber;
     planCode: z.ZodString;
@@ -948,6 +1932,7 @@ declare const AccountUpsertResponseSchema: z.ZodObject<{
           year: "year";
         }>;
         effectiveAt: z.ZodISODateTime;
+        amountMinor: z.ZodOptional<z.ZodNumber>;
       }, z.core.$strip>>;
     }, z.core.$strip>>;
     openCheckout: z.ZodNullable<z.ZodObject<{
@@ -969,6 +1954,71 @@ declare const AccountUpsertResponseSchema: z.ZodObject<{
         company: "company";
       }>>;
     }, z.core.$strip>;
+    subscriptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      id: z.ZodUUID;
+      status: z.ZodEnum<{
+        active: "active";
+        suspended: "suspended";
+        past_due: "past_due";
+        canceled: "canceled";
+        expired: "expired";
+      }>;
+      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<{
+        subscription_create: "subscription_create";
+        subscription_cycle: "subscription_cycle";
+        subscription_update: "subscription_update";
+        purchase: "purchase";
+        manual: "manual";
+      }>;
+      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<{
+        ok: "ok";
+        low: "low";
+        exhausted: "exhausted";
+      }>;
+    }, z.core.$strip>>>;
   }, z.core.$strip>>;
 }, z.core.$strip>;
 type AccountUpsertResponse = z.infer<typeof AccountUpsertResponseSchema>;
@@ -978,6 +2028,7 @@ declare const GrantCreateResponseSchema: z.ZodObject<{
   accountRef: z.ZodString;
   planCode: z.ZodNullable<z.ZodString>;
   overrides: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodBoolean, z.ZodString, z.ZodNull]>>;
+  benefitCodes: z.ZodOptional<z.ZodArray<z.ZodString>>;
   reason: z.ZodString;
   actorRef: z.ZodNullable<z.ZodString>;
   startsAt: z.ZodISODateTime;
@@ -1028,6 +2079,7 @@ declare const GrantCreateResponseSchema: z.ZodObject<{
           year: "year";
         }>;
         effectiveAt: z.ZodISODateTime;
+        amountMinor: z.ZodOptional<z.ZodNumber>;
       }, z.core.$strip>>;
     }, z.core.$strip>>;
     openCheckout: z.ZodNullable<z.ZodObject<{
@@ -1049,6 +2101,71 @@ declare const GrantCreateResponseSchema: z.ZodObject<{
         company: "company";
       }>>;
     }, z.core.$strip>;
+    subscriptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      id: z.ZodUUID;
+      status: z.ZodEnum<{
+        active: "active";
+        suspended: "suspended";
+        past_due: "past_due";
+        canceled: "canceled";
+        expired: "expired";
+      }>;
+      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<{
+        subscription_create: "subscription_create";
+        subscription_cycle: "subscription_cycle";
+        subscription_update: "subscription_update";
+        purchase: "purchase";
+        manual: "manual";
+      }>;
+      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<{
+        ok: "ok";
+        low: "low";
+        exhausted: "exhausted";
+      }>;
+    }, z.core.$strip>>>;
   }, z.core.$strip>>;
 }, z.core.$strip>;
 type GrantCreateResponse = z.infer<typeof GrantCreateResponseSchema>;
@@ -1125,6 +2242,7 @@ declare const CancelSubscriptionResponseSchema: z.ZodObject<{
           year: "year";
         }>;
         effectiveAt: z.ZodISODateTime;
+        amountMinor: z.ZodOptional<z.ZodNumber>;
       }, z.core.$strip>>;
     }, z.core.$strip>>;
     openCheckout: z.ZodNullable<z.ZodObject<{
@@ -1146,6 +2264,71 @@ declare const CancelSubscriptionResponseSchema: z.ZodObject<{
         company: "company";
       }>>;
     }, z.core.$strip>;
+    subscriptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      id: z.ZodUUID;
+      status: z.ZodEnum<{
+        active: "active";
+        suspended: "suspended";
+        past_due: "past_due";
+        canceled: "canceled";
+        expired: "expired";
+      }>;
+      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<{
+        subscription_create: "subscription_create";
+        subscription_cycle: "subscription_cycle";
+        subscription_update: "subscription_update";
+        purchase: "purchase";
+        manual: "manual";
+      }>;
+      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<{
+        ok: "ok";
+        low: "low";
+        exhausted: "exhausted";
+      }>;
+    }, z.core.$strip>>>;
   }, z.core.$strip>>;
 }, z.core.$strip>;
 type CancelSubscriptionResponse = z.infer<typeof CancelSubscriptionResponseSchema>;
@@ -1186,6 +2369,10 @@ declare const InvoiceIssueResponseSchema: z.ZodObject<{
     quantity: z.ZodNumber;
     unitAmountMinor: z.ZodNumber;
     amountMinor: z.ZodNumber;
+    meter: z.ZodOptional<z.ZodString>;
+    units: z.ZodOptional<z.ZodString>;
+    priceAmountMinor: z.ZodOptional<z.ZodNumber>;
+    pricePerUnits: z.ZodOptional<z.ZodNumber>;
   }, z.core.$strip>>;
   issuer: z.ZodString;
   externalRef: z.ZodNullable<z.ZodString>;
@@ -1196,6 +2383,21 @@ declare const InvoiceIssueResponseSchema: z.ZodObject<{
   note: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   voidedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
   voidReason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  billingReason: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+    subscription_create: "subscription_create";
+    subscription_cycle: "subscription_cycle";
+    subscription_update: "subscription_update";
+    purchase: "purchase";
+    manual: "manual";
+  }>>>;
+  paymentStatus: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+    unpaid: "unpaid";
+    paid: "paid";
+    uncollectible: "uncollectible";
+    waived: "waived";
+  }>>>;
+  periodStart: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+  periodEnd: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
   account: z.ZodOptional<z.ZodObject<{
     version: z.ZodNumber;
     planCode: z.ZodString;
@@ -1240,6 +2442,7 @@ declare const InvoiceIssueResponseSchema: z.ZodObject<{
           year: "year";
         }>;
         effectiveAt: z.ZodISODateTime;
+        amountMinor: z.ZodOptional<z.ZodNumber>;
       }, z.core.$strip>>;
     }, z.core.$strip>>;
     openCheckout: z.ZodNullable<z.ZodObject<{
@@ -1261,6 +2464,71 @@ declare const InvoiceIssueResponseSchema: z.ZodObject<{
         company: "company";
       }>>;
     }, z.core.$strip>;
+    subscriptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      id: z.ZodUUID;
+      status: z.ZodEnum<{
+        active: "active";
+        suspended: "suspended";
+        past_due: "past_due";
+        canceled: "canceled";
+        expired: "expired";
+      }>;
+      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<{
+        subscription_create: "subscription_create";
+        subscription_cycle: "subscription_cycle";
+        subscription_update: "subscription_update";
+        purchase: "purchase";
+        manual: "manual";
+      }>;
+      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<{
+        ok: "ok";
+        low: "low";
+        exhausted: "exhausted";
+      }>;
+    }, z.core.$strip>>>;
   }, z.core.$strip>>;
 }, z.core.$strip>;
 type InvoiceIssueResponse = z.infer<typeof InvoiceIssueResponseSchema>;
@@ -1301,6 +2569,10 @@ declare const ManualInvoiceResponseSchema: z.ZodObject<{
     quantity: z.ZodNumber;
     unitAmountMinor: z.ZodNumber;
     amountMinor: z.ZodNumber;
+    meter: z.ZodOptional<z.ZodString>;
+    units: z.ZodOptional<z.ZodString>;
+    priceAmountMinor: z.ZodOptional<z.ZodNumber>;
+    pricePerUnits: z.ZodOptional<z.ZodNumber>;
   }, z.core.$strip>>;
   issuer: z.ZodString;
   externalRef: z.ZodNullable<z.ZodString>;
@@ -1311,6 +2583,21 @@ declare const ManualInvoiceResponseSchema: z.ZodObject<{
   note: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   voidedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
   voidReason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  billingReason: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+    subscription_create: "subscription_create";
+    subscription_cycle: "subscription_cycle";
+    subscription_update: "subscription_update";
+    purchase: "purchase";
+    manual: "manual";
+  }>>>;
+  paymentStatus: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+    unpaid: "unpaid";
+    paid: "paid";
+    uncollectible: "uncollectible";
+    waived: "waived";
+  }>>>;
+  periodStart: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+  periodEnd: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
   account: z.ZodOptional<z.ZodObject<{
     version: z.ZodNumber;
     planCode: z.ZodString;
@@ -1355,6 +2642,7 @@ declare const ManualInvoiceResponseSchema: z.ZodObject<{
           year: "year";
         }>;
         effectiveAt: z.ZodISODateTime;
+        amountMinor: z.ZodOptional<z.ZodNumber>;
       }, z.core.$strip>>;
     }, z.core.$strip>>;
     openCheckout: z.ZodNullable<z.ZodObject<{
@@ -1376,6 +2664,71 @@ declare const ManualInvoiceResponseSchema: z.ZodObject<{
         company: "company";
       }>>;
     }, z.core.$strip>;
+    subscriptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      id: z.ZodUUID;
+      status: z.ZodEnum<{
+        active: "active";
+        suspended: "suspended";
+        past_due: "past_due";
+        canceled: "canceled";
+        expired: "expired";
+      }>;
+      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<{
+        subscription_create: "subscription_create";
+        subscription_cycle: "subscription_cycle";
+        subscription_update: "subscription_update";
+        purchase: "purchase";
+        manual: "manual";
+      }>;
+      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<{
+        ok: "ok";
+        low: "low";
+        exhausted: "exhausted";
+      }>;
+    }, z.core.$strip>>>;
   }, z.core.$strip>>;
 }, z.core.$strip>;
 type ManualInvoiceResponse = z.infer<typeof ManualInvoiceResponseSchema>;
@@ -1416,6 +2769,10 @@ declare const InvoiceVoidResponseSchema: z.ZodObject<{
     quantity: z.ZodNumber;
     unitAmountMinor: z.ZodNumber;
     amountMinor: z.ZodNumber;
+    meter: z.ZodOptional<z.ZodString>;
+    units: z.ZodOptional<z.ZodString>;
+    priceAmountMinor: z.ZodOptional<z.ZodNumber>;
+    pricePerUnits: z.ZodOptional<z.ZodNumber>;
   }, z.core.$strip>>;
   issuer: z.ZodString;
   externalRef: z.ZodNullable<z.ZodString>;
@@ -1426,6 +2783,21 @@ declare const InvoiceVoidResponseSchema: z.ZodObject<{
   note: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   voidedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
   voidReason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  billingReason: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+    subscription_create: "subscription_create";
+    subscription_cycle: "subscription_cycle";
+    subscription_update: "subscription_update";
+    purchase: "purchase";
+    manual: "manual";
+  }>>>;
+  paymentStatus: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+    unpaid: "unpaid";
+    paid: "paid";
+    uncollectible: "uncollectible";
+    waived: "waived";
+  }>>>;
+  periodStart: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+  periodEnd: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
   account: z.ZodOptional<z.ZodObject<{
     version: z.ZodNumber;
     planCode: z.ZodString;
@@ -1470,6 +2842,7 @@ declare const InvoiceVoidResponseSchema: z.ZodObject<{
           year: "year";
         }>;
         effectiveAt: z.ZodISODateTime;
+        amountMinor: z.ZodOptional<z.ZodNumber>;
       }, z.core.$strip>>;
     }, z.core.$strip>>;
     openCheckout: z.ZodNullable<z.ZodObject<{
@@ -1491,6 +2864,71 @@ declare const InvoiceVoidResponseSchema: z.ZodObject<{
         company: "company";
       }>>;
     }, z.core.$strip>;
+    subscriptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      id: z.ZodUUID;
+      status: z.ZodEnum<{
+        active: "active";
+        suspended: "suspended";
+        past_due: "past_due";
+        canceled: "canceled";
+        expired: "expired";
+      }>;
+      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<{
+        subscription_create: "subscription_create";
+        subscription_cycle: "subscription_cycle";
+        subscription_update: "subscription_update";
+        purchase: "purchase";
+        manual: "manual";
+      }>;
+      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<{
+        ok: "ok";
+        low: "low";
+        exhausted: "exhausted";
+      }>;
+    }, z.core.$strip>>>;
   }, z.core.$strip>>;
 }, z.core.$strip>;
 type InvoiceVoidResponse = z.infer<typeof InvoiceVoidResponseSchema>;
@@ -1572,6 +3010,7 @@ declare const CheckoutSessionResponseSchema: z.ZodObject<{
           year: "year";
         }>;
         effectiveAt: z.ZodISODateTime;
+        amountMinor: z.ZodOptional<z.ZodNumber>;
       }, z.core.$strip>>;
     }, z.core.$strip>>;
     openCheckout: z.ZodNullable<z.ZodObject<{
@@ -1593,32 +3032,822 @@ declare const CheckoutSessionResponseSchema: z.ZodObject<{
         company: "company";
       }>>;
     }, z.core.$strip>;
-  }, z.core.$strip>>;
-}, z.core.$strip>;
-type CheckoutSessionResponse = z.infer<typeof CheckoutSessionResponseSchema>;
-/** Değişiklik yapan her istekte zorunlu başlıklar. */
-declare const HEADER_IDEMPOTENCY_KEY = "idempotency-key";
-declare const HEADER_ACTOR_REF = "x-actor-ref";
-declare const HEADER_API_VERSION = "steward-api-version";
-declare const HEADER_SDK = "x-steward-sdk";
-declare const HEADER_REQUEST_ID = "x-request-id";
-//#endregion
-//#region ../contract/src/errors.d.ts
-type ErrorCodeSpec = {
-  readonly httpStatus: number;
-  readonly category: ErrorCategory;
-  readonly retryable: boolean;
-};
-declare const ERROR_CODES: Readonly<{
-  invalid_json: ErrorCodeSpec;
-  invalid_request: ErrorCodeSpec;
-  invalid_account_ref: ErrorCodeSpec;
-  invalid_include: ErrorCodeSpec;
-  invalid_actor_ref: ErrorCodeSpec;
-  actor_ref_required: ErrorCodeSpec;
-  idempotency_key_required: ErrorCodeSpec;
-  invalid_idempotency_key: ErrorCodeSpec;
-  /** Anahtar yok / iptal / yanlış — neden ayrıştırılmaz. */
+    subscriptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      id: z.ZodUUID;
+      status: z.ZodEnum<{
+        active: "active";
+        suspended: "suspended";
+        past_due: "past_due";
+        canceled: "canceled";
+        expired: "expired";
+      }>;
+      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<{
+        subscription_create: "subscription_create";
+        subscription_cycle: "subscription_cycle";
+        subscription_update: "subscription_update";
+        purchase: "purchase";
+        manual: "manual";
+      }>;
+      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<{
+        ok: "ok";
+        low: "low";
+        exhausted: "exhausted";
+      }>;
+    }, z.core.$strip>>>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type CheckoutSessionResponse = z.infer<typeof CheckoutSessionResponseSchema>;
+/** `POST /v1/invoices/{id}/waive` (billing core): the waived invoice and the state after it (`openInvoices` shrinks). */
+declare const InvoiceWaiveResponseSchema: z.ZodObject<{
+  id: z.ZodUUID;
+  accountRef: z.ZodString;
+  subscriptionId: z.ZodNullable<z.ZodUUID>;
+  paymentId: z.ZodNullable<z.ZodUUID>;
+  status: z.ZodEnum<{
+    void: "void";
+    draft: "draft";
+    issued: "issued";
+  }>;
+  number: z.ZodNullable<z.ZodString>;
+  currency: z.ZodString;
+  subtotalMinor: z.ZodNumber;
+  taxMinor: z.ZodNumber;
+  totalMinor: z.ZodNumber;
+  taxRateBps: z.ZodNumber;
+  buyer: z.ZodObject<{
+    kind: z.ZodEnum<{
+      individual: "individual";
+      company: "company";
+    }>;
+    contactName: z.ZodString;
+    companyName: z.ZodOptional<z.ZodString>;
+    taxOffice: z.ZodOptional<z.ZodString>;
+    taxId: z.ZodOptional<z.ZodString>;
+    email: z.ZodEmail;
+    phone: z.ZodString;
+    address: z.ZodString;
+    city: z.ZodString;
+    country: z.ZodDefault<z.ZodString>;
+  }, z.core.$strip>;
+  lines: z.ZodArray<z.ZodObject<{
+    description: z.ZodString;
+    quantity: z.ZodNumber;
+    unitAmountMinor: z.ZodNumber;
+    amountMinor: z.ZodNumber;
+    meter: z.ZodOptional<z.ZodString>;
+    units: z.ZodOptional<z.ZodString>;
+    priceAmountMinor: z.ZodOptional<z.ZodNumber>;
+    pricePerUnits: z.ZodOptional<z.ZodNumber>;
+  }, z.core.$strip>>;
+  issuer: z.ZodString;
+  externalRef: z.ZodNullable<z.ZodString>;
+  hasDocument: z.ZodBoolean;
+  issuedAt: z.ZodNullable<z.ZodISODateTime>;
+  createdAt: z.ZodISODateTime;
+  dueAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+  note: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  voidedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+  voidReason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  billingReason: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+    subscription_create: "subscription_create";
+    subscription_cycle: "subscription_cycle";
+    subscription_update: "subscription_update";
+    purchase: "purchase";
+    manual: "manual";
+  }>>>;
+  paymentStatus: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+    unpaid: "unpaid";
+    paid: "paid";
+    uncollectible: "uncollectible";
+    waived: "waived";
+  }>>>;
+  periodStart: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+  periodEnd: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+  account: z.ZodOptional<z.ZodObject<{
+    version: z.ZodNumber;
+    planCode: z.ZodString;
+    accessState: z.ZodEnum<{
+      active: "active";
+      suspended: "suspended";
+    }>;
+    entitlements: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodBoolean, z.ZodString, z.ZodNull]>>;
+    ref: z.ZodString;
+    displayName: z.ZodString;
+    updatedAt: z.ZodISODateTime;
+    catalogVersion: z.ZodNullable<z.ZodString>;
+    subscription: z.ZodNullable<z.ZodObject<{
+      id: z.ZodUUID;
+      status: z.ZodEnum<{
+        active: "active";
+        suspended: "suspended";
+        past_due: "past_due";
+        canceled: "canceled";
+        expired: "expired";
+      }>;
+      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>>;
+    openCheckout: z.ZodNullable<z.ZodObject<{
+      id: z.ZodUUID;
+      planCode: z.ZodString;
+      interval: z.ZodEnum<{
+        month: "month";
+        year: "year";
+      }>;
+      intervalCount: z.ZodNumber;
+      currency: z.ZodString;
+      amountMinor: z.ZodNumber;
+      expiresAt: z.ZodISODateTime;
+    }, z.core.$strip>>;
+    profile: z.ZodObject<{
+      present: z.ZodBoolean;
+      kind: z.ZodNullable<z.ZodEnum<{
+        individual: "individual";
+        company: "company";
+      }>>;
+    }, z.core.$strip>;
+    subscriptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      id: z.ZodUUID;
+      status: z.ZodEnum<{
+        active: "active";
+        suspended: "suspended";
+        past_due: "past_due";
+        canceled: "canceled";
+        expired: "expired";
+      }>;
+      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<{
+        subscription_create: "subscription_create";
+        subscription_cycle: "subscription_cycle";
+        subscription_update: "subscription_update";
+        purchase: "purchase";
+        manual: "manual";
+      }>;
+      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<{
+        ok: "ok";
+        low: "low";
+        exhausted: "exhausted";
+      }>;
+    }, z.core.$strip>>>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type InvoiceWaiveResponse = z.infer<typeof InvoiceWaiveResponseSchema>;
+/** `POST /v1/subscriptions/{id}/change` (billing core MF9): the subscription and the state with `scheduledChange`. */
+declare const ChangeSubscriptionResponseSchema: z.ZodObject<{
+  id: z.ZodUUID;
+  accountRef: z.ZodString;
+  status: z.ZodEnum<{
+    active: "active";
+    suspended: "suspended";
+    past_due: "past_due";
+    canceled: "canceled";
+    expired: "expired";
+  }>;
+  planCode: z.ZodString;
+  priceId: z.ZodUUID;
+  interval: z.ZodEnum<{
+    month: "month";
+    year: "year";
+  }>;
+  amountMinor: z.ZodNumber;
+  currency: z.ZodString;
+  provider: z.ZodString;
+  providerSubscriptionRef: z.ZodString;
+  cancelAtPeriodEnd: z.ZodBoolean;
+  cancelAt: z.ZodNullable<z.ZodISODateTime>;
+  cancelReason: z.ZodNullable<z.ZodString>;
+  canceledAt: z.ZodNullable<z.ZodISODateTime>;
+  startedAt: z.ZodISODateTime;
+  currentPeriodStart: z.ZodNullable<z.ZodISODateTime>;
+  currentPeriodEnd: z.ZodNullable<z.ZodISODateTime>;
+  dunningStartedAt: z.ZodNullable<z.ZodISODateTime>;
+  account: z.ZodOptional<z.ZodObject<{
+    version: z.ZodNumber;
+    planCode: z.ZodString;
+    accessState: z.ZodEnum<{
+      active: "active";
+      suspended: "suspended";
+    }>;
+    entitlements: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodBoolean, z.ZodString, z.ZodNull]>>;
+    ref: z.ZodString;
+    displayName: z.ZodString;
+    updatedAt: z.ZodISODateTime;
+    catalogVersion: z.ZodNullable<z.ZodString>;
+    subscription: z.ZodNullable<z.ZodObject<{
+      id: z.ZodUUID;
+      status: z.ZodEnum<{
+        active: "active";
+        suspended: "suspended";
+        past_due: "past_due";
+        canceled: "canceled";
+        expired: "expired";
+      }>;
+      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>>;
+    openCheckout: z.ZodNullable<z.ZodObject<{
+      id: z.ZodUUID;
+      planCode: z.ZodString;
+      interval: z.ZodEnum<{
+        month: "month";
+        year: "year";
+      }>;
+      intervalCount: z.ZodNumber;
+      currency: z.ZodString;
+      amountMinor: z.ZodNumber;
+      expiresAt: z.ZodISODateTime;
+    }, z.core.$strip>>;
+    profile: z.ZodObject<{
+      present: z.ZodBoolean;
+      kind: z.ZodNullable<z.ZodEnum<{
+        individual: "individual";
+        company: "company";
+      }>>;
+    }, z.core.$strip>;
+    subscriptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      id: z.ZodUUID;
+      status: z.ZodEnum<{
+        active: "active";
+        suspended: "suspended";
+        past_due: "past_due";
+        canceled: "canceled";
+        expired: "expired";
+      }>;
+      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<{
+        subscription_create: "subscription_create";
+        subscription_cycle: "subscription_cycle";
+        subscription_update: "subscription_update";
+        purchase: "purchase";
+        manual: "manual";
+      }>;
+      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<{
+        ok: "ok";
+        low: "low";
+        exhausted: "exhausted";
+      }>;
+    }, z.core.$strip>>>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type ChangeSubscriptionResponse = z.infer<typeof ChangeSubscriptionResponseSchema>;
+/** `POST /v1/subscriptions/{id}/uncancel` (billing core MF9): the scheduled cancellation is taken back. */
+declare const UncancelSubscriptionResponseSchema: z.ZodObject<{
+  id: z.ZodUUID;
+  accountRef: z.ZodString;
+  status: z.ZodEnum<{
+    active: "active";
+    suspended: "suspended";
+    past_due: "past_due";
+    canceled: "canceled";
+    expired: "expired";
+  }>;
+  planCode: z.ZodString;
+  priceId: z.ZodUUID;
+  interval: z.ZodEnum<{
+    month: "month";
+    year: "year";
+  }>;
+  amountMinor: z.ZodNumber;
+  currency: z.ZodString;
+  provider: z.ZodString;
+  providerSubscriptionRef: z.ZodString;
+  cancelAtPeriodEnd: z.ZodBoolean;
+  cancelAt: z.ZodNullable<z.ZodISODateTime>;
+  cancelReason: z.ZodNullable<z.ZodString>;
+  canceledAt: z.ZodNullable<z.ZodISODateTime>;
+  startedAt: z.ZodISODateTime;
+  currentPeriodStart: z.ZodNullable<z.ZodISODateTime>;
+  currentPeriodEnd: z.ZodNullable<z.ZodISODateTime>;
+  dunningStartedAt: z.ZodNullable<z.ZodISODateTime>;
+  account: z.ZodOptional<z.ZodObject<{
+    version: z.ZodNumber;
+    planCode: z.ZodString;
+    accessState: z.ZodEnum<{
+      active: "active";
+      suspended: "suspended";
+    }>;
+    entitlements: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodBoolean, z.ZodString, z.ZodNull]>>;
+    ref: z.ZodString;
+    displayName: z.ZodString;
+    updatedAt: z.ZodISODateTime;
+    catalogVersion: z.ZodNullable<z.ZodString>;
+    subscription: z.ZodNullable<z.ZodObject<{
+      id: z.ZodUUID;
+      status: z.ZodEnum<{
+        active: "active";
+        suspended: "suspended";
+        past_due: "past_due";
+        canceled: "canceled";
+        expired: "expired";
+      }>;
+      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>>;
+    openCheckout: z.ZodNullable<z.ZodObject<{
+      id: z.ZodUUID;
+      planCode: z.ZodString;
+      interval: z.ZodEnum<{
+        month: "month";
+        year: "year";
+      }>;
+      intervalCount: z.ZodNumber;
+      currency: z.ZodString;
+      amountMinor: z.ZodNumber;
+      expiresAt: z.ZodISODateTime;
+    }, z.core.$strip>>;
+    profile: z.ZodObject<{
+      present: z.ZodBoolean;
+      kind: z.ZodNullable<z.ZodEnum<{
+        individual: "individual";
+        company: "company";
+      }>>;
+    }, z.core.$strip>;
+    subscriptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      id: z.ZodUUID;
+      status: z.ZodEnum<{
+        active: "active";
+        suspended: "suspended";
+        past_due: "past_due";
+        canceled: "canceled";
+        expired: "expired";
+      }>;
+      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<{
+        subscription_create: "subscription_create";
+        subscription_cycle: "subscription_cycle";
+        subscription_update: "subscription_update";
+        purchase: "purchase";
+        manual: "manual";
+      }>;
+      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<{
+        ok: "ok";
+        low: "low";
+        exhausted: "exhausted";
+      }>;
+    }, z.core.$strip>>>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type UncancelSubscriptionResponse = z.infer<typeof UncancelSubscriptionResponseSchema>;
+/**
+ * `POST /v1/accounts/{ref}/credits` (metering MF2): the ledger entry written, the meters after it
+ * and (K5) the account state after it (a credit may change a meter's standing).
+ */
+declare const CreditGrantResponseSchema: z.ZodObject<{
+  account: z.ZodOptional<z.ZodObject<{
+    version: z.ZodNumber;
+    planCode: z.ZodString;
+    accessState: z.ZodEnum<{
+      active: "active";
+      suspended: "suspended";
+    }>;
+    entitlements: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodBoolean, z.ZodString, z.ZodNull]>>;
+    ref: z.ZodString;
+    displayName: z.ZodString;
+    updatedAt: z.ZodISODateTime;
+    catalogVersion: z.ZodNullable<z.ZodString>;
+    subscription: z.ZodNullable<z.ZodObject<{
+      id: z.ZodUUID;
+      status: z.ZodEnum<{
+        active: "active";
+        suspended: "suspended";
+        past_due: "past_due";
+        canceled: "canceled";
+        expired: "expired";
+      }>;
+      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>>;
+    openCheckout: z.ZodNullable<z.ZodObject<{
+      id: z.ZodUUID;
+      planCode: z.ZodString;
+      interval: z.ZodEnum<{
+        month: "month";
+        year: "year";
+      }>;
+      intervalCount: z.ZodNumber;
+      currency: z.ZodString;
+      amountMinor: z.ZodNumber;
+      expiresAt: z.ZodISODateTime;
+    }, z.core.$strip>>;
+    profile: z.ZodObject<{
+      present: z.ZodBoolean;
+      kind: z.ZodNullable<z.ZodEnum<{
+        individual: "individual";
+        company: "company";
+      }>>;
+    }, z.core.$strip>;
+    subscriptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      id: z.ZodUUID;
+      status: z.ZodEnum<{
+        active: "active";
+        suspended: "suspended";
+        past_due: "past_due";
+        canceled: "canceled";
+        expired: "expired";
+      }>;
+      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<{
+        subscription_create: "subscription_create";
+        subscription_cycle: "subscription_cycle";
+        subscription_update: "subscription_update";
+        purchase: "purchase";
+        manual: "manual";
+      }>;
+      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<{
+        ok: "ok";
+        low: "low";
+        exhausted: "exhausted";
+      }>;
+    }, z.core.$strip>>>;
+  }, z.core.$strip>>;
+  entry: z.ZodObject<{
+    id: z.ZodUUID;
+    meter: z.ZodString;
+    kind: z.ZodEnum<{
+      cycle_grant: "cycle_grant";
+      rollover: "rollover";
+      plan_change: "plan_change";
+      manual_grant: "manual_grant";
+      adjustment: "adjustment";
+    }>;
+    units: z.ZodNumber;
+    periodStart: z.ZodISODateTime;
+    reason: z.ZodNullable<z.ZodString>;
+    actorRef: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodISODateTime;
+  }, z.core.$strip>;
+  meters: z.ZodObject<{
+    ref: z.ZodString;
+    asOf: z.ZodISODateTime;
+    rolledUpThrough: z.ZodISODateTime;
+    meters: z.ZodRecord<z.ZodString, z.ZodObject<{
+      periodStart: z.ZodISODateTime;
+      periodEnd: z.ZodISODateTime;
+      includedUnits: z.ZodNullable<z.ZodNumber>;
+      consumedUnits: z.ZodNumber;
+      creditedUnits: z.ZodNumber;
+      balance: z.ZodNumber;
+      overageUnits: z.ZodNumber;
+      standing: z.ZodEnum<{
+        ok: "ok";
+        low: "low";
+        exhausted: "exhausted";
+      }>;
+      billable: z.ZodBoolean;
+      amountDueMinor: z.ZodNullable<z.ZodNumber>;
+      currency: z.ZodNullable<z.ZodString>;
+      capReached: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+  }, z.core.$strip>;
+}, z.core.$strip>;
+type CreditGrantResponse = z.infer<typeof CreditGrantResponseSchema>;
+/**
+ * Known `GET /v1/me` capabilities (M27): what this steward understands beyond the 0.2 contract.
+ * `steward catalog push` sends a catalog with `benefits` only when `benefits` is listed (an older
+ * steward would silently drop the key); phase 2 adds `events` (`POST /v1/events/ingest`), `meters`
+ * (catalog `meters`, `meter_credit` benefits, `GET …/meters`, credits) and `overage` (metered
+ * prices, meter charges). A steward lists a capability only once it implements it. Open set.
+ */
+declare const STEWARD_CAPABILITIES: readonly ["benefits", "events", "meters", "overage"];
+type StewardCapability = (typeof STEWARD_CAPABILITIES)[number];
+/** `GET /v1/me`: the key's product and scope (setup check). `capabilities` absent from older steward. */
+declare const MeResponseSchema: z.ZodObject<{
+  product: z.ZodString;
+  keyName: z.ZodString;
+  scope: z.ZodEnum<{
+    product: "product";
+    admin: "admin";
+    checkout: "checkout";
+  }>;
+  capabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+type MeResponse = z.infer<typeof MeResponseSchema>;
+/** Değişiklik yapan her istekte zorunlu başlıklar. */
+declare const HEADER_IDEMPOTENCY_KEY = "idempotency-key";
+declare const HEADER_ACTOR_REF = "x-actor-ref";
+declare const HEADER_API_VERSION = "steward-api-version";
+declare const HEADER_SDK = "x-steward-sdk";
+declare const HEADER_REQUEST_ID = "x-request-id";
+//#endregion
+//#region ../contract/src/errors.d.ts
+type ErrorCodeSpec = {
+  readonly httpStatus: number;
+  readonly category: ErrorCategory;
+  readonly retryable: boolean;
+};
+declare const ERROR_CODES: Readonly<{
+  invalid_json: ErrorCodeSpec;
+  invalid_request: ErrorCodeSpec;
+  invalid_account_ref: ErrorCodeSpec;
+  invalid_include: ErrorCodeSpec;
+  invalid_actor_ref: ErrorCodeSpec;
+  actor_ref_required: ErrorCodeSpec;
+  idempotency_key_required: ErrorCodeSpec;
+  invalid_idempotency_key: ErrorCodeSpec;
+  /** Anahtar yok / iptal / yanlış — neden ayrıştırılmaz. */
   unauthorized: ErrorCodeSpec;
   /** Admin kapsamı gereken uç. */
   forbidden: ErrorCodeSpec;
@@ -1643,10 +3872,16 @@ declare const ERROR_CODES: Readonly<{
   override_type_mismatch: ErrorCodeSpec;
   /** Grant girdisindeki plan katalogda yok. */
   plan_not_found: ErrorCodeSpec;
+  /** Grant `benefitCodes`: a code is not an active (not archived) catalog benefit of the product. */
+  benefit_not_found: ErrorCodeSpec;
   invalid_window: ErrorCodeSpec;
   already_subscribed: ErrorCodeSpec;
   already_canceled: ErrorCodeSpec;
-  /** `PUT …/plan` `mode: "strict"`: canlı aboneliğin planı hedefi geçiyor; hiçbir şey yazılmadı. */
+  /**
+   * LEGACY — no longer produced (billing core, M35: no plan rank). Steward before the billing core
+   * answered `PUT …/plan` `mode: "strict"` with it when a live subscription's plan outranked the
+   * target. Kept so clients that handle it keep compiling.
+   */
   subscription_plan_higher: ErrorCodeSpec;
   plan_not_sellable: ErrorCodeSpec;
   /**
@@ -1672,6 +3907,35 @@ declare const ERROR_CODES: Readonly<{
   invoice_not_voidable: ErrorCodeSpec;
   /** Void: ödemeli fatura; iptali iade yolundadır (F4d). */
   invoice_has_payment: ErrorCodeSpec;
+  /** `DELETE /v1/accounts/:ref`: the account has an unpaid invoice; pay or waive it first. */
+  invoice_open: ErrorCodeSpec;
+  /** Pay page session: the invoice is not unpaid (paid, waived, uncollectible, or not an invoice-first invoice). */
+  invoice_not_payable: ErrorCodeSpec;
+  /** Waive: the invoice is not unpaid. */
+  invoice_not_waivable: ErrorCodeSpec;
+  /**
+   * `POST /v1/subscriptions/:id/change`: the requested change is not possible — no active price for
+   * the target plan/interval in the subscription's currency, nothing would change, or the
+   * subscription is not live. Plan lookup errors keep their codes (`plan_not_found`, `plan_not_sellable`).
+   */
+  subscription_change_invalid: ErrorCodeSpec;
+  /**
+   * `POST /v1/subscriptions/:id/uncancel`: the live subscription has no cancellation scheduled for
+   * the period end (an ended or immediately canceled one is `already_canceled`).
+   */
+  cancel_not_scheduled: ErrorCodeSpec;
+  /** `POST /v1/events/ingest`: more than 1 000 events (or a body over 1 MiB) in one batch; split it. */
+  batch_too_large: ErrorCodeSpec;
+  /** `POST /v1/events/ingest`: the unprocessed event backlog is too large; `Retry-After`, keep the batch queued (M11). */
+  events_backlog: ErrorCodeSpec;
+  /** Catalog sync: a meter's filter or aggregation changed after its first period opened; use a new meter code (M4). */
+  meter_locked: ErrorCodeSpec;
+  /** Credit grant (or another meter lookup): the code is not an active catalog meter of the product. */
+  meter_not_found: ErrorCodeSpec;
+  /** Catalog sync: a metered price's tax terms differ from the plan's base price in that currency (M20). */
+  metered_price_tax_mismatch: ErrorCodeSpec;
+  /** A second live subscription would bill the same meter's overage (M20: one billing subscription per meter). */
+  meter_already_billed: ErrorCodeSpec;
   internal_error: ErrorCodeSpec;
   /** `/health`: veritabanına ulaşılamıyor. */
   database_unavailable: ErrorCodeSpec;
@@ -1690,61 +3954,384 @@ declare function isKnownErrorCode(code: string): code is ErrorCode;
 /** Bilinen kodun tanımı; bilinmeyen kod için null. */
 declare function errorCodeSpec(code: string): ErrorCodeSpec | null;
 //#endregion
-//#region ../contract/src/rules.d.ts
-/** Hesap başına en fazla bir abonelik bu durumlardan birindedir. */
-declare const LIVE_SUBSCRIPTION_STATUSES: readonly ["active", "past_due", "suspended"];
-declare function isLiveSubscriptionStatus(status: SubscriptionStatus): boolean;
-type Instant = string | Date;
-/** Kuralın katalogdan okuduğu kadarı; `Catalog` ve `CatalogSyncInput` doğrudan verilebilir. */
-type EntitlementRulesCatalog = {
-  defaultPlanCode: string;
-  features: readonly {
-    key: string;
-  }[];
+//#region ../contract/src/rules.d.ts
+/** Live subscription statuses. An account may hold several live subscriptions (billing core, M34). */
+declare const LIVE_SUBSCRIPTION_STATUSES: readonly ["active", "past_due", "suspended"];
+declare function isLiveSubscriptionStatus(status: SubscriptionStatus): boolean;
+type Instant = string | Date;
+/** Catalog benefit definition as the rule reads it (catalog input and `GET /v1/catalog` both fit). */
+type BenefitRulesDefinition = {
+  type: string;
+  properties: Readonly<Record<string, unknown>>;
+};
+/** What the rule reads from the catalog; `Catalog` and `CatalogSyncInput` can be passed as they are. */
+type EntitlementRulesCatalog = {
+  defaultPlanCode: string;
+  /**
+   * Feature `type` picks the merge rule. Without it the value decides: number or `null` → limit,
+   * boolean → OR, string → last layer wins.
+   */
+  features: readonly {
+    key: string;
+    type?: BenefitFeatureType | undefined;
+  }[];
+  /**
+   * Every plan a subscription or grant refers to must be here: a plan removed from the catalog
+   * (inactive) that a subscription/grant still refers to is passed as well. `rank` is not read.
+   */
+  plans: readonly {
+    code: string;
+    rank?: number | undefined;
+    entitlements: Readonly<Record<string, EntitlementValue>>;
+    /** Codes of catalog `benefits` the plan includes, in display order. */
+    benefits?: readonly string[] | undefined;
+  }[];
+  /** Grantable (not archived) catalog benefits by code. A code that is not here is not granted. */
+  benefits?: Readonly<Record<string, BenefitRulesDefinition>> | undefined;
+};
+type EntitlementRulesGrant = {
+  /** Null/absent unless it is a plan grant. */
+  planCode?: string | null | undefined;
+  overrides?: Readonly<Record<string, EntitlementValue>> | undefined;
+  /** Named catalog benefits granted independently of a plan (billing core, M32). */
+  benefitCodes?: readonly string[] | null | undefined;
+  startsAt?: Instant | undefined;
+  endsAt?: Instant | null | undefined;
+  revokedAt?: Instant | null | undefined;
+  /** When every grant has it, grants are ordered by `createdAt`, then `id`; otherwise the given order is the creation order. */
+  createdAt?: Instant | undefined;
+  id?: string | undefined;
+};
+type BenefitRulesSubscription = {
+  planCode: string;
+  status: SubscriptionStatus;
+  /** When every subscription has it, they are ordered by `startedAt`, then `id`; otherwise the given order is the start order. */
+  startedAt?: Instant | undefined;
+  id?: string | undefined;
+};
+type ResolveBenefitsInput = {
+  catalog: EntitlementRulesCatalog;
+  /** The account's subscriptions; those not live (canceled/expired) are ignored. */
+  subscriptions: readonly BenefitRulesSubscription[];
+  grants?: readonly EntitlementRulesGrant[] | undefined;
+  /**
+   * Instant at which grant windows (`startsAt <= at < endsAt`) are evaluated. Without it windows
+   * are not evaluated: the caller passes only active grants (a revoked grant is always ignored).
+   */
+  at?: Instant | undefined;
+};
+type ResolveEntitlementsInput = {
+  catalog: EntitlementRulesCatalog;
+  /** The account's subscription; ignored unless live. */
+  subscription: {
+    planCode: string;
+    status: SubscriptionStatus;
+  } | null;
+  grants?: readonly EntitlementRulesGrant[] | undefined;
+  /** See `ResolveBenefitsInput.at`. */
+  at?: Instant | undefined;
+};
+/** A granted benefit (`AccountState.benefits[]` without `grantedAt`, which the service keeps in its grant log). */
+type ResolvedBenefit = {
+  /** Catalog benefit code; `null` for a plan's implicit benefit and for account overrides. */
+  code: string | null;
+  type: string;
+  properties: Record<string, unknown>;
+  /** `plan:<code>`, `grant:<id>` or `override`. */
+  source: string;
+};
+type ResolvedEntitlements = Pick<EntitlementSnapshot, "planCode" | "accessState" | "entitlements">;
+type ResolvedBenefits = ResolvedEntitlements & {
+  /** Granted benefits in layer order; the `override` benefit (if any) is last. */
+  benefits: ResolvedBenefit[];
+};
+/** Type of a plan's implicit benefit and of account overrides. */
+declare const FEATURE_FLAG_BENEFIT_TYPE = "feature_flag";
+/** Source of the account overrides benefit. */
+declare const OVERRIDE_BENEFIT_SOURCE = "override";
+/** Not revoked and (when `at` is given) inside its window. */
+declare function isGrantActive(grant: EntitlementRulesGrant, at?: Instant): boolean;
+/**
+ * The account's granted benefits and their projection (planCode, accessState, entitlements).
+ * Throws when a plan it refers to is not in the catalog (inconsistent data; the service
+ * guarantees it with foreign keys).
+ */
+declare function resolveBenefits(input: ResolveBenefitsInput): ResolvedBenefits;
+/**
+ * The account's effective plan, entitlements and access state: the projection of
+ * `resolveBenefits` for a single subscription (the pre-billing-core signature).
+ */
+declare function resolveEntitlements(input: ResolveEntitlementsInput): ResolvedEntitlements;
+//#endregion
+//#region ../contract/src/ingest.d.ts
+/** Most events in one ingest batch (M11). */
+declare const EVENTS_INGEST_MAX_EVENTS = 1000;
+/** Largest ingest request body in bytes (M11; enforced on the route, not by the schema). */
+declare const EVENTS_INGEST_MAX_BYTES = 1048576;
+declare const EVENT_NAME_MAX_LENGTH = 128;
+declare const EVENT_METADATA_MAX_PAIRS = 50;
+declare const EVENT_METADATA_KEY_MAX_LENGTH = 40;
+declare const EVENT_METADATA_STRING_MAX_LENGTH = 500;
+/** How far back an event `timestamp` may lie, relative to its receipt (M18). */
+declare const EVENT_TIMESTAMP_MAX_AGE_DAYS = 35;
+/** How far ahead an event `timestamp` may lie, relative to its receipt (clock skew, M18). */
+declare const EVENT_TIMESTAMP_MAX_SKEW_MINUTES = 5;
+/** Whether a string contains C0 control characters or DEL (kept out of names and keys shown in logs and doctor). */
+declare function hasControlCharacters(value: string): boolean;
+/** Event name (free text, e.g. `ai.completion`); meters select events by it. */
+declare const EventNameSchema: z.ZodString;
+/** Product-chosen dedup key of an event, unique within the product (`cmpl_<id>`, `req_<id>`; M10). */
+declare const EventExternalIdSchema: z.ZodString;
+/** Metadata key; a meter filter reads it as `metadata.<key>`. `__proto__` is reserved. */
+declare const EventMetadataKeySchema: z.ZodString;
+declare const EventMetadataValueSchema: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
+type EventMetadataValue = z.infer<typeof EventMetadataValueSchema>;
+declare const EventMetadataSchema: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+type EventMetadata = z.infer<typeof EventMetadataSchema>;
+/** One event the product sends (product → steward; not a webhook `BillingEvent`). */
+declare const IngestEventSchema: z.ZodObject<{
+  accountRef: z.ZodString;
+  name: z.ZodString;
+  externalId: z.ZodString;
+  timestamp: z.ZodOptional<z.ZodISODateTime>;
+  metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+}, z.core.$strip>;
+type IngestEvent = z.infer<typeof IngestEventSchema>;
+/** `POST /v1/events/ingest` body. */
+declare const EventsIngestInputSchema: z.ZodObject<{
+  events: z.ZodArray<z.ZodObject<{
+    accountRef: z.ZodString;
+    name: z.ZodString;
+    externalId: z.ZodString;
+    timestamp: z.ZodOptional<z.ZodISODateTime>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type EventsIngestInput = z.infer<typeof EventsIngestInputSchema>;
+/** Per-event rejection codes this version knows (M12). The result schema accepts others too. */
+declare const INGEST_REJECT_CODES: readonly ["account_not_found", "account_deleted", "timestamp_out_of_range"];
+declare const IngestRejectCodeSchema: z.ZodEnum<{
+  account_not_found: "account_not_found";
+  account_deleted: "account_deleted";
+  timestamp_out_of_range: "timestamp_out_of_range";
+}>;
+type IngestRejectCode = z.infer<typeof IngestRejectCodeSchema>;
+declare const IngestRejectionSchema: z.ZodObject<{
+  index: z.ZodNumber;
+  externalId: z.ZodString;
+  code: z.ZodType<"account_not_found" | "account_deleted" | "timestamp_out_of_range" | (string & Record<never, never>), string, z.core.$ZodTypeInternals<"account_not_found" | "account_deleted" | "timestamp_out_of_range" | (string & Record<never, never>), string>>;
+}, z.core.$strip>;
+type IngestRejection = z.infer<typeof IngestRejectionSchema>;
+/**
+ * `POST /v1/events/ingest` result (200): `inserted` new events, `duplicates` already stored
+ * (`externalId` seen before), `rejected` per event (sorted by `index`; the SDK does not retry them).
+ */
+declare const EventsIngestResultSchema: z.ZodObject<{
+  inserted: z.ZodNumber;
+  duplicates: z.ZodNumber;
+  rejected: z.ZodArray<z.ZodObject<{
+    index: z.ZodNumber;
+    externalId: z.ZodString;
+    code: z.ZodType<"account_not_found" | "account_deleted" | "timestamp_out_of_range" | (string & Record<never, never>), string, z.core.$ZodTypeInternals<"account_not_found" | "account_deleted" | "timestamp_out_of_range" | (string & Record<never, never>), string>>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type EventsIngestResult = z.infer<typeof EventsIngestResultSchema>;
+/**
+ * Whether an event `timestamp` is accepted for an event received at `receivedAt` (M18):
+ * [received − 35 days, received + 5 minutes], both ends inclusive. Outside: `timestamp_out_of_range`.
+ */
+declare function isEventTimestampInRange(timestamp: Date, receivedAt: Date): boolean;
+//#endregion
+//#region ../contract/src/meter-rules.d.ts
+/** What the rules read from an event (an `IngestEvent`, a stored event row, a queued SDK event). */
+type MeterRulesEvent = {
+  readonly name: string;
+  readonly metadata?: Readonly<Record<string, unknown>> | undefined;
+};
+/** What the rules read from a meter (`MeterDef`, or a stored meter row). */
+type MeterRulesMeter = {
+  readonly filter: MeterFilter;
+  readonly aggregation: MeterAggregation;
+};
+/**
+ * Whether an event matches a meter filter (syntax and semantics: `meters.ts`). A condition on an
+ * absent metadata key is false for every operator; `eq` needs the same type; `like` is a
+ * case-sensitive substring. Throws on a filter the schema would reject.
+ */
+declare function matchesFilter(event: MeterRulesEvent, filter: MeterFilter): boolean;
+/**
+ * What one matching event contributes to a meter (M4):
+ * - `count`: `{kind: "count"}` (one unit);
+ * - `sum` / `max`: the number at `metadata.<key>` in micro units (beyond 6 decimals half up);
+ * - `unique`: the canonical value at `metadata.<key>` — `s:<string>`, `n:<plain decimal>`,
+ *   `b:true|false` (types never collide: `"500"` ≠ `500`; numbers without exponent, so
+ *   `1e21` and `1000000000000000000000` are one value);
+ * - `{kind: "invalid_value"}`: the key is absent, or (`sum`/`max`) its value is not a finite,
+ *   non-negative number — a numeric string does not count. The event adds nothing to that meter.
+ */
+type MeterContribution = {
+  kind: "count";
+} | {
+  kind: "sum" | "max";
+  micro: bigint;
+} | {
+  kind: "unique";
+  value: string;
+} | {
+  kind: "invalid_value";
+};
+declare function contributionOf(event: MeterRulesEvent, aggregation: MeterAggregation): MeterContribution;
+/**
+ * A meter's value over a set of events (reference computation; the service recomputes a closing
+ * period from raw events with the same result, M8): `count` → matching events, `sum` → total,
+ * `max` → the largest value (0 when none), `unique` → distinct values. `matched` counts events
+ * that passed the filter (invalid ones included), `invalid` those without a usable value.
+ */
+declare function consumptionOf(events: Iterable<MeterRulesEvent>, meter: MeterRulesMeter): {
+  consumedMicro: bigint;
+  matched: number;
+  invalid: number;
+};
+/**
+ * A granted benefit as the credit rule reads it: `AccountState.benefits[]`, a `ResolvedBenefit`
+ * of `resolveBenefits` (`rules.ts`), or a catalog benefit row. Only `meter_credit` benefits with
+ * a code count.
+ */
+type MeterCreditBenefit = {
+  readonly code: string | null;
+  readonly type: string;
+  readonly properties: Readonly<Record<string, unknown>>;
+  /** The granting layer: `plan:<code>`, `grant:<id>` (absent when unknown). */
+  readonly source?: string | undefined;
+};
+/** What the granted `meter_credit` benefits give one meter per period. */
+type GrantedMeterCredit = {
+  /** Sum of the counted benefits' `units` (micro units). */
+  unitsMicro: bigint;
+  /** Sum of the counted benefits' `rolloverCapUnits` (a benefit without a cap adds none); null when none has a cap (rollover off, M6). */
+  rolloverCapMicro: bigint | null;
   /**
-   * Adayların (abonelik ve grant planları) TÜMÜ burada olmalı; katalogdan
-   * çıkarılıp pasifleşmiş plana bağlı abonelik/grant varsa o plan da verilir.
+   * The counted benefits, in grant order (one entry per benefit code); `source` is the layer of the
+   * grant that counts (null when the input had none).
    */
-  plans: readonly {
+  benefits: {
     code: string;
-    rank: number;
-    entitlements: Readonly<Record<string, EntitlementValue>>;
+    source: string | null;
+    unitsMicro: bigint;
+    rolloverCapMicro: bigint | null;
   }[];
 };
-type EntitlementRulesGrant = {
-  /** Plan grant'i değilse null/yok. */
-  planCode?: string | null;
-  overrides?: Readonly<Record<string, EntitlementValue>>;
-  startsAt?: Instant;
-  endsAt?: Instant | null;
-  revokedAt?: Instant | null;
-  /** Varsa (tümünde) grant'ler `createdAt`, sonra `id` ile sıralanır; yoksa verilen sıra oluşturulma sırasıdır. */
-  createdAt?: Instant;
-  id?: string;
-};
-type ResolveEntitlementsInput = {
-  catalog: EntitlementRulesCatalog;
-  /** Hesabın aboneliği; durumu canlı değilse (canceled/expired) yok sayılır. */
-  subscription: {
-    planCode: string;
-    status: SubscriptionStatus;
-  } | null;
-  grants?: readonly EntitlementRulesGrant[];
+type MeterCreditsOptions = {
   /**
-   * Grant penceresinin (`startsAt <= at < endsAt`) değerlendirildiği an.
-   * Verilmezse pencere değerlendirilmez: çağıran yalnızca aktif grant'leri
-   * verir (iptal edilmiş grant her durumda yok sayılır).
+   * The product's default plan. Its `meter_credit` benefits (source `plan:<default>`) count for a
+   * meter only when no other layer grants a `meter_credit` for that meter: a paid plan REPLACES the
+   * free quota, it does not stack on it. Omitted or null: every layer counts (e.g. the credits of
+   * one plan on its own).
    */
-  at?: Instant;
+  defaultPlanCode?: string | null | undefined;
 };
-type ResolvedEntitlements = Pick<EntitlementSnapshot, "planCode" | "accessState" | "entitlements">;
-/** İptal edilmemiş ve (`at` verildiyse) penceresi içinde olan grant. */
-declare function isGrantActive(grant: EntitlementRulesGrant, at?: Instant): boolean;
 /**
- * Hesabın etkin planı, hakları ve erişim durumu. Adaylardan biri katalogda
- * yoksa fırlatır (tutarsız veri; servis bunu FK ile garanti eder).
+ * The credit rule (M5; decided 2026-09-19): the granted `meter_credit` benefits per meter code.
+ * - Several benefits on one meter sum their units AND their rollover caps (plan + add-on).
+ * - A benefit code granted by several layers counts once (its first counted grant).
+ * - The default plan's credit for a meter counts only when no other layer credits that meter
+ *   (`options.defaultPlanCode`): free 50k + team 2M → 2M, free only → 50k.
+ * - Benefits of another type, without a code, or whose properties do not parse are ignored.
+ * The service (`AccountState.meters.includedUnits`, cycle grants) and the SDK (`stateOf`,
+ * `Meters()` fallback) both use this function. Vectors: `credits.json`.
  */
-declare function resolveEntitlements(input: ResolveEntitlementsInput): ResolvedEntitlements;
+declare function meterCreditsOf(benefits: Iterable<MeterCreditBenefit>, options?: MeterCreditsOptions): Map<string, GrantedMeterCredit>;
+/** `max(0, consumed − credited)` (M21). */
+declare function overageOf(input: {
+  consumedMicro: bigint;
+  creditedMicro: bigint;
+}): bigint;
+/**
+ * Credit standing of a meter (M14): no credit (`creditedMicro` 0) → `ok`; balance
+ * (`credited − consumed`) ≤ 0 → `exhausted`; consumption ≥ `lowAt` × credit → `low` (`lowAt`
+ * null disables `low`); else `ok`. Exact integer comparison (`lowAt` read as micro units).
+ * `billable` does not change the standing — it describes the credit; a billable meter goes
+ * `low`/`exhausted` too and only the gate stays open (M15).
+ */
+declare function standingOf(input: {
+  creditedMicro: bigint;
+  consumedMicro: bigint;
+  lowAt: number | null;
+  billable?: boolean | undefined;
+}): MeterStanding;
+/**
+ * Credit carried into the next period (M6): `min(max(closing balance, 0), cap)`; `capMicro`
+ * null (rollover off) → 0. Debt never carries.
+ */
+declare function rolloverOf(input: {
+  closingBalanceMicro: bigint;
+  capMicro: bigint | null;
+}): bigint;
+/**
+ * `from` + `months` months in UTC with the month-end clamp of the service's `addInterval`
+ * (`service/src/periods.ts`, date-fns `addMonths` on `UTCDate`): the day of month is kept, or the
+ * last day of a shorter month (Jan 31 + 1 → Feb 28/29); the time of day is kept.
+ */
+declare function addUtcMonths(from: Date, months: number): Date;
+/**
+ * The monthly meter period containing `at` (M7): `[anchor + n months, anchor + (n + 1) months)`,
+ * start inclusive, end exclusive, where every boundary is computed FROM THE ANCHOR (`addUtcMonths`;
+ * Jan 31 → Feb 28 → Mar 31, no drift) — the same grid as the billing cycle's `nextPeriodEnd` for a
+ * monthly subscription. `n` may be negative (`at` before the anchor). UTC throughout.
+ */
+declare function periodBoundsOf(anchor: Date, at: Date): {
+  start: Date;
+  end: Date;
+};
+/** A period's overage and the (locked) metered rate that prices it. */
+type OverageRateInput = {
+  overageMicro: bigint;
+  amountMinor: number;
+  perUnits: number;
+  capMinor?: number | null | undefined;
+};
+/**
+ * Overage amount in minor units (M21): `round_half_up(overage × amountMinor / perUnits)` on micro
+ * units with BigInt — proportional (no block rounding), always whole minor units — then clipped
+ * by `capMinor`. Tax terms are the price's (gross when tax-inclusive).
+ */
+declare function rateOverage(input: OverageRateInput): number;
+/**
+ * Whether the period's priced overage reached the rate's `capMinor` (M15: the SDK gate closes on a
+ * billable meter once the cap is reached — further use would be free): there is overage
+ * (`overageMicro` > 0) and its amount before the cap (`rateOverage` without `capMinor`) is ≥ the
+ * cap. No cap → false. Same validation as `rateOverage`.
+ */
+declare function overageCapReached(input: OverageRateInput): boolean;
+/**
+ * A line of an invoice that carries overage (a meter line) or not (the base fee, a carried
+ * amount). `amountMinor` is in the price's tax terms (gross when tax-inclusive).
+ */
+type MeterChargeTotalsLine = {
+  readonly description: string;
+  readonly amountMinor: number;
+  readonly meter?: string | undefined;
+  /** Overage units, decimal string (`microToDecimalString`). */
+  readonly units?: string | undefined;
+  readonly priceAmountMinor?: number | undefined;
+  readonly pricePerUnits?: number | undefined;
+};
+/**
+ * Totals and stored lines of an invoice (or meter charge) with overage lines: the manual invoice
+ * rule (`manualInvoiceTotals`) with every line at quantity 1 — ONE rounding at invoice level
+ * (tax-inclusive: the total is kept and split with `splitInclusiveTax`, the net spread over the
+ * lines by largest remainder; exclusive: tax added on the sum). Stored lines are net and keep
+ * their meter fields (`meter`, `units`, `priceAmountMinor`, `pricePerUnits`).
+ */
+declare function meterChargeTotals(lines: readonly MeterChargeTotalsLine[], terms: {
+  taxInclusive: boolean;
+  taxRateBps: number;
+}): {
+  subtotalMinor: number;
+  taxMinor: number;
+  totalMinor: number;
+  lines: InvoiceLine[];
+};
 //#endregion
 //#region ../contract/src/plan.d.ts
 declare const PLAN_SET_MODES: readonly ["ensure", "strict"];
@@ -1764,7 +4351,7 @@ declare const PlanSetInputSchema: z.ZodObject<{
   overrides: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodBoolean, z.ZodString, z.ZodNull]>>>;
 }, z.core.$strip>;
 type PlanSetInput = z.input<typeof PlanSetInputSchema>;
-/** `warnings[].code` — bilinen değerler; küme açık. */
+/** `warnings[].code` — open set. None is produced since the billing core; `subscription_plan_higher` is legacy. */
 type PlanSetWarningCode = "subscription_plan_higher" | (string & Record<never, never>);
 declare const PlanSetWarningSchema: z.ZodObject<{
   code: z.ZodString;
@@ -1778,6 +4365,7 @@ declare const PlanSetResponseSchema: z.ZodObject<{
     accountRef: z.ZodString;
     planCode: z.ZodNullable<z.ZodString>;
     overrides: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodBoolean, z.ZodString, z.ZodNull]>>;
+    benefitCodes: z.ZodOptional<z.ZodArray<z.ZodString>>;
     reason: z.ZodString;
     actorRef: z.ZodNullable<z.ZodString>;
     startsAt: z.ZodISODateTime;
@@ -1829,6 +4417,7 @@ declare const PlanSetResponseSchema: z.ZodObject<{
           year: "year";
         }>;
         effectiveAt: z.ZodISODateTime;
+        amountMinor: z.ZodOptional<z.ZodNumber>;
       }, z.core.$strip>>;
     }, z.core.$strip>>;
     openCheckout: z.ZodNullable<z.ZodObject<{
@@ -1850,6 +4439,71 @@ declare const PlanSetResponseSchema: z.ZodObject<{
         company: "company";
       }>>;
     }, z.core.$strip>;
+    subscriptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      id: z.ZodUUID;
+      status: z.ZodEnum<{
+        active: "active";
+        suspended: "suspended";
+        past_due: "past_due";
+        canceled: "canceled";
+        expired: "expired";
+      }>;
+      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<{
+        subscription_create: "subscription_create";
+        subscription_cycle: "subscription_cycle";
+        subscription_update: "subscription_update";
+        purchase: "purchase";
+        manual: "manual";
+      }>;
+      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<{
+        ok: "ok";
+        low: "low";
+        exhausted: "exhausted";
+      }>;
+    }, z.core.$strip>>>;
   }, z.core.$strip>;
   warnings: z.ZodArray<z.ZodObject<{
     code: z.ZodString;
@@ -1863,6 +4517,377 @@ declare const ResyncResultSchema: z.ZodObject<{
 }, z.core.$strip>;
 type ResyncResult = z.infer<typeof ResyncResultSchema>;
 //#endregion
+//#region ../contract/src/emails.d.ts
+declare const EMAIL_TEMPLATES: readonly ["subscription_started", "payment_receipt", "payment_failed", "cancel_scheduled", "subscription_ended", "access_suspended", "subscription_terminated", "invoice_issued", "invoice_payment_due", "price_change_notice"];
+declare const EmailTemplateSchema: z.ZodEnum<{
+  subscription_started: "subscription_started";
+  payment_receipt: "payment_receipt";
+  payment_failed: "payment_failed";
+  cancel_scheduled: "cancel_scheduled";
+  subscription_ended: "subscription_ended";
+  access_suspended: "access_suspended";
+  subscription_terminated: "subscription_terminated";
+  invoice_issued: "invoice_issued";
+  invoice_payment_due: "invoice_payment_due";
+  price_change_notice: "price_change_notice";
+}>;
+type EmailTemplate = z.infer<typeof EmailTemplateSchema>;
+/** `invoice_payment_due`: summary of an unpaid invoice, its due date and the hosted pay page link. */
+declare const InvoicePaymentDueEmailSchema: z.ZodObject<{
+  invoiceId: z.ZodUUID;
+  number: z.ZodNullable<z.ZodString>;
+  billingReason: z.ZodEnum<{
+    subscription_create: "subscription_create";
+    subscription_cycle: "subscription_cycle";
+    subscription_update: "subscription_update";
+    purchase: "purchase";
+    manual: "manual";
+  }>;
+  planName: z.ZodNullable<z.ZodString>;
+  totalMinor: z.ZodNumber;
+  currency: z.ZodString;
+  periodStart: z.ZodNullable<z.ZodISODateTime>;
+  periodEnd: z.ZodNullable<z.ZodISODateTime>;
+  dueAt: z.ZodISODateTime;
+  payUrl: z.ZodURL;
+  reminder: z.ZodBoolean;
+}, z.core.$strip>;
+type InvoicePaymentDueEmail = z.infer<typeof InvoicePaymentDueEmailSchema>;
+/** A metered (overage) rate as a notice shows it: `amountMinor` per `perUnits` units, at most `capMinor` per usage period. */
+declare const NoticedMeteredRateSchema: z.ZodObject<{
+  amountMinor: z.ZodNumber;
+  perUnits: z.ZodNumber;
+  capMinor: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+type NoticedMeteredRate = z.infer<typeof NoticedMeteredRateSchema>;
+/**
+ * One meter whose overage rate changes with the move to the current terms (metering M20, M36): the
+ * subscription's locked rate and the plan's current one, in the notice's currency and tax terms.
+ * The meter's labels as they were when the notice was written (the e-mail is never recomputed).
+ */
+declare const PriceChangeNoticeMeteredRateSchema: z.ZodObject<{
+  meter: z.ZodString;
+  label: z.ZodObject<{
+    tr: z.ZodString;
+    en: z.ZodString;
+  }, z.core.$strip>;
+  unitLabel: z.ZodNullable<z.ZodObject<{
+    tr: z.ZodString;
+    en: z.ZodString;
+  }, z.core.$strip>>;
+  displayPer: z.ZodNullable<z.ZodNumber>;
+  oldRate: z.ZodNullable<z.ZodObject<{
+    amountMinor: z.ZodNumber;
+    perUnits: z.ZodNumber;
+    capMinor: z.ZodNullable<z.ZodNumber>;
+  }, z.core.$strip>>;
+  newRate: z.ZodNullable<z.ZodObject<{
+    amountMinor: z.ZodNumber;
+    perUnits: z.ZodNumber;
+    capMinor: z.ZodNullable<z.ZodNumber>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type PriceChangeNoticeMeteredRate = z.infer<typeof PriceChangeNoticeMeteredRateSchema>;
+/**
+ * `price_change_notice`: a subscription moves to the current terms of its plan from `effectiveAt` —
+ * its per-period amount and/or its metered rates (`meteredRates`: only the meters whose rate
+ * changes; absent when none does). Old and new amount are equal when only metered rates change.
+ */
+declare const PriceChangeNoticeEmailSchema: z.ZodObject<{
+  subscriptionId: z.ZodUUID;
+  planCode: z.ZodString;
+  planName: z.ZodString;
+  interval: z.ZodEnum<{
+    month: "month";
+    year: "year";
+  }>;
+  currency: z.ZodString;
+  oldAmountMinor: z.ZodNumber;
+  newAmountMinor: z.ZodNumber;
+  taxInclusive: z.ZodBoolean;
+  effectiveAt: z.ZodISODateTime;
+  meteredRates: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    meter: z.ZodString;
+    label: z.ZodObject<{
+      tr: z.ZodString;
+      en: z.ZodString;
+    }, z.core.$strip>;
+    unitLabel: z.ZodNullable<z.ZodObject<{
+      tr: z.ZodString;
+      en: z.ZodString;
+    }, z.core.$strip>>;
+    displayPer: z.ZodNullable<z.ZodNumber>;
+    oldRate: z.ZodNullable<z.ZodObject<{
+      amountMinor: z.ZodNumber;
+      perUnits: z.ZodNumber;
+      capMinor: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>>;
+    newRate: z.ZodNullable<z.ZodObject<{
+      amountMinor: z.ZodNumber;
+      perUnits: z.ZodNumber;
+      capMinor: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>>;
+}, z.core.$strip>;
+type PriceChangeNoticeEmail = z.infer<typeof PriceChangeNoticeEmailSchema>;
+/** Payload schema per billing core template. */
+declare const EMAIL_PAYLOAD_SCHEMAS: Readonly<{
+  readonly invoice_payment_due: z.ZodObject<{
+    invoiceId: z.ZodUUID;
+    number: z.ZodNullable<z.ZodString>;
+    billingReason: z.ZodEnum<{
+      subscription_create: "subscription_create";
+      subscription_cycle: "subscription_cycle";
+      subscription_update: "subscription_update";
+      purchase: "purchase";
+      manual: "manual";
+    }>;
+    planName: z.ZodNullable<z.ZodString>;
+    totalMinor: z.ZodNumber;
+    currency: z.ZodString;
+    periodStart: z.ZodNullable<z.ZodISODateTime>;
+    periodEnd: z.ZodNullable<z.ZodISODateTime>;
+    dueAt: z.ZodISODateTime;
+    payUrl: z.ZodURL;
+    reminder: z.ZodBoolean;
+  }, z.core.$strip>;
+  readonly price_change_notice: z.ZodObject<{
+    subscriptionId: z.ZodUUID;
+    planCode: z.ZodString;
+    planName: z.ZodString;
+    interval: z.ZodEnum<{
+      month: "month";
+      year: "year";
+    }>;
+    currency: z.ZodString;
+    oldAmountMinor: z.ZodNumber;
+    newAmountMinor: z.ZodNumber;
+    taxInclusive: z.ZodBoolean;
+    effectiveAt: z.ZodISODateTime;
+    meteredRates: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      meter: z.ZodString;
+      label: z.ZodObject<{
+        tr: z.ZodString;
+        en: z.ZodString;
+      }, z.core.$strip>;
+      unitLabel: z.ZodNullable<z.ZodObject<{
+        tr: z.ZodString;
+        en: z.ZodString;
+      }, z.core.$strip>>;
+      displayPer: z.ZodNullable<z.ZodNumber>;
+      oldRate: z.ZodNullable<z.ZodObject<{
+        amountMinor: z.ZodNumber;
+        perUnits: z.ZodNumber;
+        capMinor: z.ZodNullable<z.ZodNumber>;
+      }, z.core.$strip>>;
+      newRate: z.ZodNullable<z.ZodObject<{
+        amountMinor: z.ZodNumber;
+        perUnits: z.ZodNumber;
+        capMinor: z.ZodNullable<z.ZodNumber>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+  }, z.core.$strip>;
+}>;
+/**
+ * Which event triggers which template. Events not listed send no email. The billing core
+ * templates (`invoice_payment_due`, `price_change_notice`) are not triggered by an event type alone.
+ */
+declare const EMAIL_TEMPLATE_BY_EVENT: Readonly<Partial<Record<EventType, EmailTemplate>>>;
+declare function emailTemplateOf(type: string): EmailTemplate | null;
+declare const EMAIL_LOCALES: readonly ["tr", "en"];
+type EmailLocale = (typeof EMAIL_LOCALES)[number];
+/** Upper bound of product-provided recipients per account. */
+declare const MAX_NOTIFICATION_EMAILS = 10;
+declare const NotificationEmailsSchema: z.ZodPipe<z.ZodArray<z.ZodEmail>, z.ZodTransform<string[], string[]>>;
+/** Case-insensitive de-duplication; keeps the first spelling and the order. */
+declare function uniqueEmails(emails: readonly string[]): string[];
+/** Profile email first, then the account's notification emails. */
+declare function emailRecipients(profileEmail: string | null | undefined, notificationEmails: readonly string[]): string[];
+declare function emailLocaleOf(accountLocale: string | null | undefined, lastCheckoutLocale: string | null | undefined, defaultLocale: EmailLocale): EmailLocale;
+declare const EmailExtraTextSchema: z.ZodObject<{
+  tr: z.ZodOptional<z.ZodString>;
+  en: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const EmailTemplateSettingsSchema: z.ZodObject<{
+  enabled: z.ZodDefault<z.ZodBoolean>;
+  extraText: z.ZodOptional<z.ZodObject<{
+    tr: z.ZodOptional<z.ZodString>;
+    en: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type EmailTemplateSettings = z.output<typeof EmailTemplateSettingsSchema>;
+declare const EmailSenderSchema: z.ZodObject<{
+  name: z.ZodOptional<z.ZodString>;
+  address: z.ZodOptional<z.ZodEmail>;
+}, z.core.$strip>;
+/** Placeholders a billing path may use. */
+declare const BILLING_PATH_PLACEHOLDERS: readonly ["{LOCALE}", "{ACCOUNT_REF}"];
+declare const BillingPathSchema: z.ZodString;
+declare const EmailSettingsSchema: z.ZodObject<{
+  from: z.ZodOptional<z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    address: z.ZodOptional<z.ZodEmail>;
+  }, z.core.$strip>>;
+  replyTo: z.ZodOptional<z.ZodEmail>;
+  billingPath: z.ZodOptional<z.ZodString>;
+  templates: z.ZodDefault<z.ZodObject<{
+    subscription_started: z.ZodOptional<z.ZodObject<{
+      enabled: z.ZodDefault<z.ZodBoolean>;
+      extraText: z.ZodOptional<z.ZodObject<{
+        tr: z.ZodOptional<z.ZodString>;
+        en: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    payment_receipt: z.ZodOptional<z.ZodObject<{
+      enabled: z.ZodDefault<z.ZodBoolean>;
+      extraText: z.ZodOptional<z.ZodObject<{
+        tr: z.ZodOptional<z.ZodString>;
+        en: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    payment_failed: z.ZodOptional<z.ZodObject<{
+      enabled: z.ZodDefault<z.ZodBoolean>;
+      extraText: z.ZodOptional<z.ZodObject<{
+        tr: z.ZodOptional<z.ZodString>;
+        en: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    cancel_scheduled: z.ZodOptional<z.ZodObject<{
+      enabled: z.ZodDefault<z.ZodBoolean>;
+      extraText: z.ZodOptional<z.ZodObject<{
+        tr: z.ZodOptional<z.ZodString>;
+        en: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    subscription_ended: z.ZodOptional<z.ZodObject<{
+      enabled: z.ZodDefault<z.ZodBoolean>;
+      extraText: z.ZodOptional<z.ZodObject<{
+        tr: z.ZodOptional<z.ZodString>;
+        en: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    access_suspended: z.ZodOptional<z.ZodObject<{
+      enabled: z.ZodDefault<z.ZodBoolean>;
+      extraText: z.ZodOptional<z.ZodObject<{
+        tr: z.ZodOptional<z.ZodString>;
+        en: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    subscription_terminated: z.ZodOptional<z.ZodObject<{
+      enabled: z.ZodDefault<z.ZodBoolean>;
+      extraText: z.ZodOptional<z.ZodObject<{
+        tr: z.ZodOptional<z.ZodString>;
+        en: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    invoice_issued: z.ZodOptional<z.ZodObject<{
+      enabled: z.ZodDefault<z.ZodBoolean>;
+      extraText: z.ZodOptional<z.ZodObject<{
+        tr: z.ZodOptional<z.ZodString>;
+        en: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    invoice_payment_due: z.ZodOptional<z.ZodObject<{
+      enabled: z.ZodDefault<z.ZodBoolean>;
+      extraText: z.ZodOptional<z.ZodObject<{
+        tr: z.ZodOptional<z.ZodString>;
+        en: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    price_change_notice: z.ZodOptional<z.ZodObject<{
+      enabled: z.ZodDefault<z.ZodBoolean>;
+      extraText: z.ZodOptional<z.ZodObject<{
+        tr: z.ZodOptional<z.ZodString>;
+        en: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type EmailSettings = z.output<typeof EmailSettingsSchema>;
+declare const EmailSettingsPatchSchema: z.ZodObject<{
+  from: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    address: z.ZodOptional<z.ZodEmail>;
+  }, z.core.$strict>>>;
+  replyTo: z.ZodOptional<z.ZodNullable<z.ZodEmail>>;
+  billingPath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  templates: z.ZodOptional<z.ZodObject<{
+    subscription_started: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+      enabled: z.ZodOptional<z.ZodBoolean>;
+      extraText: z.ZodOptional<typeof EmailExtraTextSchema>;
+    }, z.core.$strict>>>;
+    payment_receipt: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+      enabled: z.ZodOptional<z.ZodBoolean>;
+      extraText: z.ZodOptional<typeof EmailExtraTextSchema>;
+    }, z.core.$strict>>>;
+    payment_failed: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+      enabled: z.ZodOptional<z.ZodBoolean>;
+      extraText: z.ZodOptional<typeof EmailExtraTextSchema>;
+    }, z.core.$strict>>>;
+    cancel_scheduled: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+      enabled: z.ZodOptional<z.ZodBoolean>;
+      extraText: z.ZodOptional<typeof EmailExtraTextSchema>;
+    }, z.core.$strict>>>;
+    subscription_ended: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+      enabled: z.ZodOptional<z.ZodBoolean>;
+      extraText: z.ZodOptional<typeof EmailExtraTextSchema>;
+    }, z.core.$strict>>>;
+    access_suspended: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+      enabled: z.ZodOptional<z.ZodBoolean>;
+      extraText: z.ZodOptional<typeof EmailExtraTextSchema>;
+    }, z.core.$strict>>>;
+    subscription_terminated: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+      enabled: z.ZodOptional<z.ZodBoolean>;
+      extraText: z.ZodOptional<typeof EmailExtraTextSchema>;
+    }, z.core.$strict>>>;
+    invoice_issued: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+      enabled: z.ZodOptional<z.ZodBoolean>;
+      extraText: z.ZodOptional<typeof EmailExtraTextSchema>;
+    }, z.core.$strict>>>;
+    invoice_payment_due: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+      enabled: z.ZodOptional<z.ZodBoolean>;
+      extraText: z.ZodOptional<typeof EmailExtraTextSchema>;
+    }, z.core.$strict>>>;
+    price_change_notice: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+      enabled: z.ZodOptional<z.ZodBoolean>;
+      extraText: z.ZodOptional<typeof EmailExtraTextSchema>;
+    }, z.core.$strict>>>;
+  }, z.core.$strict>>;
+}, z.core.$strict>;
+type EmailSettingsPatch = z.output<typeof EmailSettingsPatchSchema>;
+/** Pure merge of a validated patch (see the patch rules above). */
+declare function applyEmailSettingsPatch(current: EmailSettings, patch: EmailSettingsPatch | null): EmailSettings;
+declare function emailTemplateSettings(settings: EmailSettings, template: EmailTemplate): EmailTemplateSettings;
+/**
+ * Button target: `appUrl` + `billingPath` with placeholders filled (the ref is URL-encoded).
+ * Null without `appUrl`, or when the result would leave the `appUrl` origin.
+ */
+declare function billingPageUrl(appUrl: string | undefined, billingPath: string | undefined, locale: EmailLocale, accountRef: string): string | null;
+type EmailRelevanceFacts = {
+  /** Current (stored) account state at send time. */
+  state: AccountState;
+  /** `detail.subscriptionId` of the triggering event, if any (looked up in `state.subscriptions`). */
+  subscriptionId: string | null;
+  /** Current status of the invoice (`invoice_issued`). */
+  invoiceStatus?: string | null;
+  /** Current payment status of the invoice (`invoice_payment_due`). */
+  invoicePaymentStatus?: string | null;
+};
+/**
+ * The event's subscription among the account's live subscriptions at send time, or null when it
+ * is not live. Looked up by id in `subscriptions` (billing core, M34: any live subscription, not
+ * only the primary one); a state without that list (older steward) has only the primary
+ * `subscription`.
+ */
+declare function liveSubscriptionOf(state: AccountState, subscriptionId: string | null): AccountState["subscription"];
+/**
+ * Whether the email still describes the account at send time. Receipts, the welcome email
+ * (legal confirmation) and the final termination notice always go; the others only while
+ * the situation they describe still holds for the event's subscription (which need not be the
+ * primary one when the account has several).
+ */
+declare function isEmailRelevant(template: EmailTemplate, facts: EmailRelevanceFacts): boolean;
+//#endregion
 //#region ../contract/src/settings.d.ts
 /** https; http yalnızca localhost / 127.0.0.1 / [::1]. */
 declare const WebUrlSchema: z.ZodURL;
@@ -1884,6 +4909,59 @@ declare const BrandingSchema: z.ZodObject<{
   supportEmail: z.ZodOptional<z.ZodEmail>;
 }, z.core.$strip>;
 type Branding = z.infer<typeof BrandingSchema>;
+declare const DEFAULT_PAYMENT_DUE_DAYS = 7;
+declare const DEFAULT_MIN_INVOICE_MINOR = 1000;
+declare const PaymentDueDaysSchema: z.ZodNumber;
+declare const BillingSettingsSchema: z.ZodObject<{
+  paymentDueDays: z.ZodDefault<z.ZodNumber>;
+  minInvoiceMinor: z.ZodDefault<z.ZodNumber>;
+  allowMultipleSubscriptions: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+type BillingSettings = z.output<typeof BillingSettingsSchema>;
+/** Patch of `settings.billing`: an omitted field is unchanged, `null` restores its default. */
+declare const BillingSettingsPatchSchema: z.ZodObject<{
+  paymentDueDays: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+  minInvoiceMinor: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+  allowMultipleSubscriptions: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+}, z.core.$strict>;
+declare const DEFAULT_EVENT_RETENTION_DAYS = 120;
+declare const DEFAULT_LATE_GRACE_MINUTES = 60;
+declare const METER_CHARGE_MODES: readonly ["off", "dry_run", "live"];
+declare const MeterChargeModeSchema: z.ZodEnum<{
+  off: "off";
+  dry_run: "dry_run";
+  live: "live";
+}>;
+type MeterChargeMode = z.infer<typeof MeterChargeModeSchema>;
+declare const DEFAULT_METER_CHARGE_MODE: MeterChargeMode;
+declare const EventRetentionDaysSchema: z.ZodNumber;
+declare const LateGraceMinutesSchema: z.ZodNumber;
+declare const EventsSettingsSchema: z.ZodObject<{
+  retentionDays: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+type EventsSettings = z.output<typeof EventsSettingsSchema>;
+declare const MeteringSettingsSchema: z.ZodObject<{
+  lateGraceMinutes: z.ZodDefault<z.ZodNumber>;
+  chargeMode: z.ZodDefault<z.ZodEnum<{
+    off: "off";
+    dry_run: "dry_run";
+    live: "live";
+  }>>;
+}, z.core.$strip>;
+type MeteringSettings = z.output<typeof MeteringSettingsSchema>;
+/** Patch of `settings.events`: an omitted field is unchanged, `null` restores its default. */
+declare const EventsSettingsPatchSchema: z.ZodObject<{
+  retentionDays: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strict>;
+/** Patch of `settings.metering`: an omitted field is unchanged, `null` restores its default. */
+declare const MeteringSettingsPatchSchema: z.ZodObject<{
+  lateGraceMinutes: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+  chargeMode: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+    off: "off";
+    dry_run: "dry_run";
+    live: "live";
+  }>>>;
+}, z.core.$strict>;
 declare const ProductSettingsSchema: z.ZodObject<{
   provider: z.ZodDefault<z.ZodString>;
   appUrl: z.ZodOptional<z.ZodURL>;
@@ -1903,8 +4981,110 @@ declare const ProductSettingsSchema: z.ZodObject<{
   }, z.core.$strip>>;
   checkoutTtlMinutes: z.ZodDefault<z.ZodNumber>;
   portalTtlMinutes: z.ZodDefault<z.ZodNumber>;
+  emails: z.ZodDefault<z.ZodObject<{
+    from: z.ZodOptional<z.ZodObject<{
+      name: z.ZodOptional<z.ZodString>;
+      address: z.ZodOptional<z.ZodEmail>;
+    }, z.core.$strip>>;
+    replyTo: z.ZodOptional<z.ZodEmail>;
+    billingPath: z.ZodOptional<z.ZodString>;
+    templates: z.ZodDefault<z.ZodObject<{
+      subscription_started: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        extraText: z.ZodOptional<z.ZodObject<{
+          tr: z.ZodOptional<z.ZodString>;
+          en: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+      }, z.core.$strip>>;
+      payment_receipt: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        extraText: z.ZodOptional<z.ZodObject<{
+          tr: z.ZodOptional<z.ZodString>;
+          en: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+      }, z.core.$strip>>;
+      payment_failed: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        extraText: z.ZodOptional<z.ZodObject<{
+          tr: z.ZodOptional<z.ZodString>;
+          en: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+      }, z.core.$strip>>;
+      cancel_scheduled: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        extraText: z.ZodOptional<z.ZodObject<{
+          tr: z.ZodOptional<z.ZodString>;
+          en: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+      }, z.core.$strip>>;
+      subscription_ended: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        extraText: z.ZodOptional<z.ZodObject<{
+          tr: z.ZodOptional<z.ZodString>;
+          en: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+      }, z.core.$strip>>;
+      access_suspended: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        extraText: z.ZodOptional<z.ZodObject<{
+          tr: z.ZodOptional<z.ZodString>;
+          en: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+      }, z.core.$strip>>;
+      subscription_terminated: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        extraText: z.ZodOptional<z.ZodObject<{
+          tr: z.ZodOptional<z.ZodString>;
+          en: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+      }, z.core.$strip>>;
+      invoice_issued: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        extraText: z.ZodOptional<z.ZodObject<{
+          tr: z.ZodOptional<z.ZodString>;
+          en: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+      }, z.core.$strip>>;
+      invoice_payment_due: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        extraText: z.ZodOptional<z.ZodObject<{
+          tr: z.ZodOptional<z.ZodString>;
+          en: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+      }, z.core.$strip>>;
+      price_change_notice: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        extraText: z.ZodOptional<z.ZodObject<{
+          tr: z.ZodOptional<z.ZodString>;
+          en: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>;
+  billing: z.ZodOptional<z.ZodObject<{
+    paymentDueDays: z.ZodDefault<z.ZodNumber>;
+    minInvoiceMinor: z.ZodDefault<z.ZodNumber>;
+    allowMultipleSubscriptions: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$strip>>;
+  events: z.ZodOptional<z.ZodObject<{
+    retentionDays: z.ZodDefault<z.ZodNumber>;
+  }, z.core.$strip>>;
+  metering: z.ZodOptional<z.ZodObject<{
+    lateGraceMinutes: z.ZodDefault<z.ZodNumber>;
+    chargeMode: z.ZodDefault<z.ZodEnum<{
+      off: "off";
+      dry_run: "dry_run";
+      live: "live";
+    }>>;
+  }, z.core.$strip>>;
 }, z.core.$strip>;
 type ProductSettings = z.output<typeof ProductSettingsSchema>;
+/** `settings.billing` with defaults filled in. */
+declare function billingSettingsOf(settings: Pick<ProductSettings, "billing">): BillingSettings;
+/** `settings.events` with defaults filled in. */
+declare function eventsSettingsOf(settings: Pick<ProductSettings, "events">): EventsSettings;
+/** `settings.metering` with defaults filled in. */
+declare function meteringSettingsOf(settings: Pick<ProductSettings, "metering">): MeteringSettings;
 declare const BrandingPatchSchema: z.ZodObject<{
   name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   logoUrl: z.ZodOptional<z.ZodNullable<z.ZodURL>>;
@@ -1930,6 +5110,72 @@ declare const ProductSettingsPatchSchema: z.ZodObject<{
   }, z.core.$strict>>>;
   checkoutTtlMinutes: z.ZodOptional<z.ZodNumber>;
   portalTtlMinutes: z.ZodOptional<z.ZodNumber>;
+  emails: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+    from: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+      name: z.ZodOptional<z.ZodString>;
+      address: z.ZodOptional<z.ZodEmail>;
+    }, z.core.$strict>>>;
+    replyTo: z.ZodOptional<z.ZodNullable<z.ZodEmail>>;
+    billingPath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    templates: z.ZodOptional<z.ZodObject<{
+      subscription_started: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        extraText: z.ZodOptional<typeof EmailExtraTextSchema>;
+      }, z.core.$strict>>>;
+      payment_receipt: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        extraText: z.ZodOptional<typeof EmailExtraTextSchema>;
+      }, z.core.$strict>>>;
+      payment_failed: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        extraText: z.ZodOptional<typeof EmailExtraTextSchema>;
+      }, z.core.$strict>>>;
+      cancel_scheduled: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        extraText: z.ZodOptional<typeof EmailExtraTextSchema>;
+      }, z.core.$strict>>>;
+      subscription_ended: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        extraText: z.ZodOptional<typeof EmailExtraTextSchema>;
+      }, z.core.$strict>>>;
+      access_suspended: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        extraText: z.ZodOptional<typeof EmailExtraTextSchema>;
+      }, z.core.$strict>>>;
+      subscription_terminated: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        extraText: z.ZodOptional<typeof EmailExtraTextSchema>;
+      }, z.core.$strict>>>;
+      invoice_issued: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        extraText: z.ZodOptional<typeof EmailExtraTextSchema>;
+      }, z.core.$strict>>>;
+      invoice_payment_due: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        extraText: z.ZodOptional<typeof EmailExtraTextSchema>;
+      }, z.core.$strict>>>;
+      price_change_notice: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        extraText: z.ZodOptional<typeof EmailExtraTextSchema>;
+      }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+  }, z.core.$strict>>>;
+  billing: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+    paymentDueDays: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    minInvoiceMinor: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    allowMultipleSubscriptions: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+  }, z.core.$strict>>>;
+  events: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+    retentionDays: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+  }, z.core.$strict>>>;
+  metering: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+    lateGraceMinutes: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    chargeMode: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+      off: "off";
+      dry_run: "dry_run";
+      live: "live";
+    }>>>;
+  }, z.core.$strict>>>;
 }, z.core.$strict>;
 type ProductSettingsPatch = z.input<typeof ProductSettingsPatchSchema>;
 /**
@@ -1971,6 +5217,13 @@ declare const EventTypeSchema: z.ZodEnum<{
   "invoice.voided": "invoice.voided";
   "account.state_changed": "account.state_changed";
   "account.deleted": "account.deleted";
+  "invoice.paid": "invoice.paid";
+  "benefit_grant.created": "benefit_grant.created";
+  "benefit_grant.updated": "benefit_grant.updated";
+  "benefit_grant.revoked": "benefit_grant.revoked";
+  "benefit_grant.cycled": "benefit_grant.cycled";
+  "meter.threshold_crossed": "meter.threshold_crossed";
+  "meter.period_closed": "meter.period_closed";
 }>;
 declare const WEBHOOK_ENDPOINT_STATUSES: readonly ["active", "paused", "inactive"];
 declare const WebhookEndpointStatusSchema: z.ZodEnum<{
@@ -2010,7 +5263,14 @@ declare const WebhookEndpointCreateInputSchema: z.ZodObject<{
     "invoice.voided": "invoice.voided";
     "account.state_changed": "account.state_changed";
     "account.deleted": "account.deleted";
-  }>>, z.ZodTransform<("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" | "invoice.voided" | "account.state_changed" | "account.deleted")[], ("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" | "invoice.voided" | "account.state_changed" | "account.deleted")[]>>>;
+    "invoice.paid": "invoice.paid";
+    "benefit_grant.created": "benefit_grant.created";
+    "benefit_grant.updated": "benefit_grant.updated";
+    "benefit_grant.revoked": "benefit_grant.revoked";
+    "benefit_grant.cycled": "benefit_grant.cycled";
+    "meter.threshold_crossed": "meter.threshold_crossed";
+    "meter.period_closed": "meter.period_closed";
+  }>>, z.ZodTransform<("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" | "invoice.voided" | "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")[], ("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" | "invoice.voided" | "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")[]>>>;
   description: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 type WebhookEndpointCreateInput = z.input<typeof WebhookEndpointCreateInputSchema>;
@@ -2065,6 +5325,13 @@ declare const WebhookEndpointSchema: z.ZodObject<{
     "invoice.voided": "invoice.voided";
     "account.state_changed": "account.state_changed";
     "account.deleted": "account.deleted";
+    "invoice.paid": "invoice.paid";
+    "benefit_grant.created": "benefit_grant.created";
+    "benefit_grant.updated": "benefit_grant.updated";
+    "benefit_grant.revoked": "benefit_grant.revoked";
+    "benefit_grant.cycled": "benefit_grant.cycled";
+    "meter.threshold_crossed": "meter.threshold_crossed";
+    "meter.period_closed": "meter.period_closed";
   }>>>;
   description: z.ZodNullable<z.ZodString>;
   createdAt: z.ZodISODateTime;
@@ -2111,6 +5378,13 @@ declare const WebhookEndpointListSchema: z.ZodObject<{
       "invoice.voided": "invoice.voided";
       "account.state_changed": "account.state_changed";
       "account.deleted": "account.deleted";
+      "invoice.paid": "invoice.paid";
+      "benefit_grant.created": "benefit_grant.created";
+      "benefit_grant.updated": "benefit_grant.updated";
+      "benefit_grant.revoked": "benefit_grant.revoked";
+      "benefit_grant.cycled": "benefit_grant.cycled";
+      "meter.threshold_crossed": "meter.threshold_crossed";
+      "meter.period_closed": "meter.period_closed";
     }>>>;
     description: z.ZodNullable<z.ZodString>;
     createdAt: z.ZodISODateTime;
@@ -2141,7 +5415,7 @@ declare const DoctorSeveritySchema: z.ZodEnum<{
 }>;
 type DoctorSeverity = z.infer<typeof DoctorSeveritySchema>;
 /** `warnings[].code` — bu sürümün ürettiği kodlar; küme açık. */
-type DoctorWarningCode = "catalog_not_synced" | "price_not_synced_with_provider" | "price_unsellable" | "provider_not_configured" | "provider_unhealthy" | "no_return_origin" | "app_url_missing" | "branding_incomplete" | "legal_links_missing" | "no_active_endpoint" | "no_state_changed_endpoint" | "endpoint_wrong_secret" | "endpoint_old_contract" | "endpoint_unreachable" | "endpoint_failing" | "endpoint_dead_deliveries" | "endpoint_pending_backlog" | "dunning_dry_run" | (string & Record<never, never>);
+type DoctorWarningCode = "catalog_not_synced" | "price_unsellable" | "price_drift" | "legacy_provider_subscription" | "provider_not_configured" | "provider_unhealthy" | "no_return_origin" | "app_url_missing" | "branding_incomplete" | "legal_links_missing" | "no_active_endpoint" | "no_state_changed_endpoint" | "endpoint_wrong_secret" | "endpoint_old_contract" | "endpoint_unreachable" | "endpoint_failing" | "endpoint_dead_deliveries" | "endpoint_pending_backlog" | "dunning_dry_run" | "email_not_configured" | "email_sender_missing" | "email_billing_link_missing" | "events_backlog" | "meter_rollup_lag" | "events_invalid_value" | "meter_without_events" | "events_unmatched" | "overage_charge_mode_off" | "overage_dry_run" | "overage_unrated_subscriptions" | (string & Record<never, never>);
 declare const DoctorWarningSchema: z.ZodObject<{
   code: z.ZodString;
   severity: z.ZodEnum<{
@@ -2154,10 +5428,10 @@ declare const DoctorWarningSchema: z.ZodObject<{
 }, z.core.$strip>;
 type DoctorWarning = z.infer<typeof DoctorWarningSchema>;
 /**
- * Satılamayan fiyatın nedeni — küme açık:
- * `provider_price_missing` (sağlayıcıda plan karşılığı yok; katalog senkronu yeniden koşulur),
- * `provider_not_configured`, `unsupported_currency`, `interval_count_unsupported`
- * (checkout yalnızca `intervalCount: 1` satar).
+ * Why an active price cannot be sold — open set: `provider_not_configured`,
+ * `unsupported_currency`, `interval_count_unsupported` (checkout sells `intervalCount: 1` only).
+ * `provider_price_missing` (no provider plan for the price) is produced only by steward before the
+ * billing core: prices live only in steward now (M30).
  */
 type DoctorUnsellableReason = "provider_price_missing" | "provider_not_configured" | "unsupported_currency" | "interval_count_unsupported" | (string & Record<never, never>);
 declare const DoctorUnsellablePriceSchema: z.ZodObject<{
@@ -2188,15 +5462,56 @@ declare const DoctorCatalogSchema: z.ZodObject<{
     currency: z.ZodString;
     reason: z.ZodString;
   }, z.core.$strip>>;
+  priceDriftSubscriptions: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 type DoctorCatalog = z.infer<typeof DoctorCatalogSchema>;
+/** Billing core facts (M30). Absent from older steward. */
+declare const DoctorBillingSchema: z.ZodObject<{
+  legacyProviderSubscriptions: z.ZodNumber;
+}, z.core.$strip>;
+type DoctorBilling = z.infer<typeof DoctorBillingSchema>;
+/**
+ * Event ingest and rollup facts (metering phase 2, M29; only for a product that defines meters).
+ * Absent from older steward. Names and meter codes only: no metadata, no account refs.
+ */
+declare const DoctorEventsSchema: z.ZodObject<{
+  meters: z.ZodNumber;
+  backfillingMeters: z.ZodArray<z.ZodString>;
+  backlogRows: z.ZodNumber;
+  rollupLagSeconds: z.ZodNumber;
+  backlogged: z.ZodBoolean;
+  sampledEvents: z.ZodNumber;
+  unmatchedEventNames: z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    events: z.ZodNumber;
+  }, z.core.$strip>>;
+  invalidValues: z.ZodArray<z.ZodObject<{
+    meter: z.ZodString;
+    events: z.ZodNumber;
+  }, z.core.$strip>>;
+  metersWithoutEvents: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+type DoctorEvents = z.infer<typeof DoctorEventsSchema>;
+/** Rollup lag above which the doctor warns (the `rollup lag > 60 s` alert, M29). */
+declare const DOCTOR_ROLLUP_LAG_WARN_SECONDS = 60;
+/**
+ * Overage facts (metering MF5, M20/M21): present when the catalog has a metered price or the
+ * product has meter charges. Absent from older steward.
+ */
+declare const DoctorOverageSchema: z.ZodObject<{
+  chargeMode: z.ZodString;
+  meteredPrices: z.ZodNumber;
+  unratedSubscriptions: z.ZodNumber;
+  carriedCharges: z.ZodNumber;
+}, z.core.$strip>;
+type DoctorOverage = z.infer<typeof DoctorOverageSchema>;
 declare const DOCTOR_PROVIDER_ENVIRONMENTS: readonly ["sandbox", "live", "fake"];
 declare const DoctorProviderSchema: z.ZodObject<{
   id: z.ZodString;
   configured: z.ZodBoolean;
   environment: z.ZodNullable<z.ZodEnum<{
-    sandbox: "sandbox";
     live: "live";
+    sandbox: "sandbox";
     fake: "fake";
   }>>;
   merchantId: z.ZodNullable<z.ZodString>;
@@ -2262,6 +5577,13 @@ declare const DoctorEndpointSchema: z.ZodObject<{
     "invoice.voided": "invoice.voided";
     "account.state_changed": "account.state_changed";
     "account.deleted": "account.deleted";
+    "invoice.paid": "invoice.paid";
+    "benefit_grant.created": "benefit_grant.created";
+    "benefit_grant.updated": "benefit_grant.updated";
+    "benefit_grant.revoked": "benefit_grant.revoked";
+    "benefit_grant.cycled": "benefit_grant.cycled";
+    "meter.threshold_crossed": "meter.threshold_crossed";
+    "meter.period_closed": "meter.period_closed";
   }>>>;
   pending: z.ZodNumber;
   dead: z.ZodNumber;
@@ -2280,6 +5602,14 @@ declare const DoctorEndpointSchema: z.ZodObject<{
   diagnosis: z.ZodString;
 }, z.core.$strip>;
 type DoctorEndpoint = z.infer<typeof DoctorEndpointSchema>;
+/** Billing emails (issue #15). */
+declare const DoctorEmailsSchema: z.ZodObject<{
+  transportConfigured: z.ZodBoolean;
+  senderConfigured: z.ZodBoolean;
+  disabledTemplates: z.ZodArray<z.ZodString>;
+  ready: z.ZodBoolean;
+}, z.core.$strip>;
+type DoctorEmails = z.infer<typeof DoctorEmailsSchema>;
 declare const DoctorReportSchema: z.ZodObject<{
   ok: z.ZodBoolean;
   checkedAt: z.ZodISODateTime;
@@ -2303,13 +5633,14 @@ declare const DoctorReportSchema: z.ZodObject<{
       currency: z.ZodString;
       reason: z.ZodString;
     }, z.core.$strip>>;
+    priceDriftSubscriptions: z.ZodOptional<z.ZodNumber>;
   }, z.core.$strip>;
   provider: z.ZodObject<{
     id: z.ZodString;
     configured: z.ZodBoolean;
     environment: z.ZodNullable<z.ZodEnum<{
-      sandbox: "sandbox";
       live: "live";
+      sandbox: "sandbox";
       fake: "fake";
     }>>;
     merchantId: z.ZodNullable<z.ZodString>;
@@ -2360,6 +5691,13 @@ declare const DoctorReportSchema: z.ZodObject<{
       "invoice.voided": "invoice.voided";
       "account.state_changed": "account.state_changed";
       "account.deleted": "account.deleted";
+      "invoice.paid": "invoice.paid";
+      "benefit_grant.created": "benefit_grant.created";
+      "benefit_grant.updated": "benefit_grant.updated";
+      "benefit_grant.revoked": "benefit_grant.revoked";
+      "benefit_grant.cycled": "benefit_grant.cycled";
+      "meter.threshold_crossed": "meter.threshold_crossed";
+      "meter.period_closed": "meter.period_closed";
     }>>>;
     pending: z.ZodNumber;
     dead: z.ZodNumber;
@@ -2380,6 +5718,38 @@ declare const DoctorReportSchema: z.ZodObject<{
   dunning: z.ZodObject<{
     dryRun: z.ZodBoolean;
   }, z.core.$strip>;
+  emails: z.ZodOptional<z.ZodObject<{
+    transportConfigured: z.ZodBoolean;
+    senderConfigured: z.ZodBoolean;
+    disabledTemplates: z.ZodArray<z.ZodString>;
+    ready: z.ZodBoolean;
+  }, z.core.$strip>>;
+  billing: z.ZodOptional<z.ZodObject<{
+    legacyProviderSubscriptions: z.ZodNumber;
+  }, z.core.$strip>>;
+  events: z.ZodOptional<z.ZodObject<{
+    meters: z.ZodNumber;
+    backfillingMeters: z.ZodArray<z.ZodString>;
+    backlogRows: z.ZodNumber;
+    rollupLagSeconds: z.ZodNumber;
+    backlogged: z.ZodBoolean;
+    sampledEvents: z.ZodNumber;
+    unmatchedEventNames: z.ZodArray<z.ZodObject<{
+      name: z.ZodString;
+      events: z.ZodNumber;
+    }, z.core.$strip>>;
+    invalidValues: z.ZodArray<z.ZodObject<{
+      meter: z.ZodString;
+      events: z.ZodNumber;
+    }, z.core.$strip>>;
+    metersWithoutEvents: z.ZodArray<z.ZodString>;
+  }, z.core.$strip>>;
+  overage: z.ZodOptional<z.ZodObject<{
+    chargeMode: z.ZodString;
+    meteredPrices: z.ZodNumber;
+    unratedSubscriptions: z.ZodNumber;
+    carriedCharges: z.ZodNumber;
+  }, z.core.$strip>>;
   warnings: z.ZodArray<z.ZodObject<{
     code: z.ZodString;
     severity: z.ZodEnum<{
@@ -2398,10 +5768,23 @@ type DoctorFacts = {
   product: DoctorReport["product"];
   catalog: DoctorCatalog;
   provider: DoctorProvider;
-  settings: Pick<ProductSettings, "appUrl" | "extraReturnOrigins" | "privacyUrl" | "termsUrl" | "branding">;
+  settings: Pick<ProductSettings, "appUrl" | "extraReturnOrigins" | "privacyUrl" | "termsUrl" | "branding"> & Partial<Pick<ProductSettings, "emails">>;
   endpoints: Omit<DoctorEndpoint, "diagnosis">[];
   dunning: DoctorReport["dunning"];
+  /** Deployment email transport facts; omitted: no email section in the report. */
+  emailTransport?: {
+    configured: boolean;
+    defaultFromConfigured: boolean;
+  };
+  /** Billing core facts; omitted: no billing section in the report. */
+  billing?: DoctorBilling;
+  /** Event ingest and rollup facts; omitted: no events section (a product without meters). */
+  events?: DoctorEvents;
+  /** Overage facts (MF5); omitted: no overage section in the report. */
+  overage?: DoctorOverage;
 };
+/** Email readiness from settings and the deployment's transport (pure). */
+declare function emailReadinessOf(settings: DoctorFacts["settings"], transport: NonNullable<DoctorFacts["emailTransport"]>): DoctorEmails;
 /** Bekleyen en eski teslimat bundan eskiyse `endpoint_pending_backlog` (K23 alarmıyla aynı eşik). */
 declare const DOCTOR_PENDING_BACKLOG_MS: number;
 /** Son denenmiş teslimattan endpoint teşhisi (saf). */
@@ -2411,4 +5794,4 @@ declare function hostedReadinessOf(settings: DoctorFacts["settings"]): DoctorHos
 /** Olgulardan raporu türetir (saf): endpoint teşhisleri, hosted hazırlığı, uyarılar ve `ok`. */
 declare function buildDoctorReport(facts: DoctorFacts): DoctorReport;
 //#endregion
-export { DEFAULT_CHECKOUT_TTL_MINUTES as $, CheckoutSessionCreatedSchema as $n, HEADER_SDK as $t, hostedReadinessOf as A, Stats as An, Currency as Ar, ResolvedEntitlements as At, WebhookEndpointRotateInput as B, CHECKOUT_ERRORS as Bn, ErrorResponse as Br, AccountDetailSchema as Bt, DoctorUnsellablePriceSchema as C, CancelSubscriptionInputSchema as Cn, PriceDef as Cr, PlanSetWarningSchema as Ct, DoctorWarningSchema as D, GrantSchema as Dn, ActorRefSchema as Dr, EntitlementRulesGrant as Dt, DoctorWarningCode as E, GrantCreateInputSchema as En, API_VERSION as Er, EntitlementRulesCatalog as Et, WebhookEndpoint as F, PortalSession as Fn, EntitlementValueSchema as Fr, ErrorCode as Ft, WebhookLastDelivery as G, CheckoutPrefillSchema as Gn, IntervalSchema as Gr, CheckoutSessionResponse as Gt, WebhookEndpointSchema as H, CheckoutConsentInputSchema as Hn, ExternalRefSchema as Hr, AccountUpsertResponseSchema as Ht, WebhookEndpointCreateInput as I, PortalSessionCreateInput as In, Entitlements as Ir, ErrorCodeSpec as It, generateWebhookSecret as J, CheckoutSession as Jn, GrantCreateResponseSchema as Jt, WebhookLastDeliverySchema as K, CheckoutRedirectTarget as Kn, MetadataSchema as Kr, CheckoutSessionResponseSchema as Kt, WebhookEndpointCreateInputSchema as L, PortalSessionCreateInputSchema as Ln, EntitlementsSchema as Lr, errorCodeSpec as Lt, EventTypeSchema as M, Subscription as Mn, DateTimeSchema as Mr, isLiveSubscriptionStatus as Mt, WEBHOOK_ENDPOINT_STATUSES as N, SubscriptionSchema as Nn, ERROR_CATEGORIES as Nr, resolveEntitlements as Nt, buildDoctorReport as O, Payment as On, AmountMinorSchema as Or, LIVE_SUBSCRIPTION_STATUSES as Ot, WEBHOOK_SECRET_PREFIX as P, PORTAL_SESSION_ERRORS as Pn, EntitlementValue as Pr, ERROR_CODES as Pt, BrandingSchema as Q, CheckoutSessionCreated as Qn, HEADER_REQUEST_ID as Qt, WebhookEndpointList as R, PortalSessionError as Rn, ErrorCategory as Rr, isKnownErrorCode as Rt, DoctorUnsellablePrice as S, CancelSubscriptionInput as Sn, Price as Sr, PlanSetWarningCode as St, DoctorWarning as T, GrantCreateInput as Tn, PriceSchema as Tr, ResyncResultSchema as Tt, WebhookEndpointStatus as U, CheckoutError as Un, IdSchema as Ur, CancelSubscriptionResponse as Ut, WebhookEndpointRotateInputSchema as V, CheckoutConsentInput as Vn, ErrorResponseSchema as Vr, AccountUpsertResponse as Vt, WebhookEndpointStatusSchema as W, CheckoutPrefill as Wn, Interval as Wr, CancelSubscriptionResponseSchema as Wt, Branding as X, CheckoutSessionCreateInputSchema as Xn, HEADER_API_VERSION as Xt, webhookEndpointUrlProblem as Y, CheckoutSessionCreateInput as Yn, HEADER_ACTOR_REF as Yt, BrandingPatchSchema as Z, CheckoutSessionCreateParsed as Zn, HEADER_IDEMPOTENCY_KEY as Zt, DoctorReportSchema as _, ManualInvoiceInputSchema as _n, FeatureDef as _r, PlanSetMode as _t, DOCTOR_SEVERITIES as a, ManualInvoiceResponseSchema as an, MAX_CHECKOUT_CONSENT_DOCS as ar, ReturnOriginSchema as at, DoctorSeverity as b, manualInvoiceTotals as bn, PlanDef as br, PlanSetResponseSchema as bt, DoctorEndpoint as c, InvoiceIssueInputSchema as cn, checkoutRedirectUrl as cr, SettingsLocaleSchema as ct, DoctorFacts as d, InvoiceSchema as dn, Catalog as dr, applySettingsPatch as dt, InvoiceIssueResponse as en, CheckoutSessionSchema as er, DEFAULT_PORTAL_TTL_MINUTES as et, DoctorHosted as f, InvoiceStatusSchema as fn, CatalogSchema as fr, isReturnUrlAllowed as ft, DoctorReport as g, ManualInvoiceInput as gn, CatalogSyncResultSchema as gr, PlanSetInputSchema as gt, DoctorProviderSchema as h, MANUAL_INVOICE_MAX_AMOUNT_MINOR as hn, CatalogSyncResult as hr, PlanSetInput as ht, DOCTOR_REQUIRED_LEGAL_LINKS as i, ManualInvoiceResponse as in, ConsentSchema as ir, ProductSettingsSchema as it, DEFAULT_ENDPOINT_EVENT_TYPES as j, StatsSchema as jn, CurrencySchema as jr, isGrantActive as jt, endpointDiagnosisOf as k, PaymentSchema as kn, CodeSchema as kr, ResolveEntitlementsInput as kt, DoctorEndpointDiagnosis as l, InvoiceLine as ln, AccountsRefreshResult as lr, TtlMinutesSchema as lt, DoctorProvider as m, InvoiceVoidInputSchema as mn, CatalogSyncInputSchema as mr, PLAN_SET_MODES as mt, DOCTOR_PROVIDER_ENVIRONMENTS as n, InvoiceVoidResponse as nn, CheckoutStatusSchema as nr, ProductSettingsPatch as nt, DoctorCatalog as o, Invoice as on, ProviderPayload as or, SETTINGS_LOCALES as ot, DoctorHostedSchema as p, InvoiceVoidInput as pn, CatalogSyncInput as pr, returnOriginsOf as pt, WebhookSecretSchema as q, CheckoutReturnStatus as qn, GrantCreateResponse as qt, DOCTOR_REQUIRED_BRANDING as r, InvoiceVoidResponseSchema as rn, Consent as rr, ProductSettingsPatchSchema as rt, DoctorCatalogSchema as s, InvoiceIssueInput as sn, ProviderPayloadSchema as sr, SettingsLocale as st, DOCTOR_PENDING_BACKLOG_MS as t, InvoiceIssueResponseSchema as tn, CheckoutStatus as tr, ProductSettings as tt, DoctorEndpointSchema as u, InvoiceLineSchema as un, AccountsRefreshResultSchema as ur, WebUrlSchema as ut, DoctorSettings as v, ManualInvoiceLineInput as vn, FeatureDefSchema as vr, PlanSetModeSchema as vt, DoctorUnsellableReason as w, Grant as wn, PriceDefSchema as wr, ResyncResult as wt, DoctorSeveritySchema as x, splitInclusiveTax as xn, PlanDefSchema as xr, PlanSetWarning as xt, DoctorSettingsSchema as y, ManualInvoiceLineInputSchema as yn, FeatureTypeSchema as yr, PlanSetResponse as yt, WebhookEndpointListSchema as z, PortalSessionSchema as zn, ErrorCategorySchema as zr, AccountDetail as zt };
+export { WebhookEndpointStatus as $, CatalogPlanSchema as $a, ManualInvoiceInputSchema as $i, matchesFilter as $n, MAX_METERED_PRICE_PER_UNITS as $o, ErrorCode as $r, canonicalMeterFilter as $s, EmailExtraTextSchema as $t, DoctorSeveritySchema as A, CheckoutPrefillSchema as Aa, MeResponse as Ai, PLAN_SET_MODES as An, CatalogBenefit as Ao, IngestRejectCode as Ar, MeterFilterClause as As, PaymentDueDaysSchema as At, hostedReadinessOf as B, CheckoutStatus as Ba, InvoiceLineSchema as Bi, ResyncResult as Bn, featureValueMatchesType as Bo, FEATURE_FLAG_BENEFIT_TYPE as Br, MeterPeriod as Bs, WebUrlSchema as Bt, DoctorProvider as C, PortalSessionError as Ca, InvoiceBillingReason as Cc, InvoiceIssueResponseSchema as Ci, emailLocaleOf as Cn, BenefitDefSchema as Co, EventsIngestInput as Cr, MeterCreditEntrySchema as Cs, LateGraceMinutesSchema as Ct, DoctorSettings as D, CheckoutConsentInputSchema as Da, MetadataSchema as Dc, InvoiceWaiveResponseSchema as Di, isEmailRelevant as Dn, BenefitSourceSchema as Do, INGEST_REJECT_CODES as Dr, MeterDefInput as Ds, MeteringSettings as Dt, DoctorReportSchema as E, CheckoutConsentInput as Ea, InvoicePaymentStatusSchema as Ec, InvoiceWaiveResponse as Ei, emailTemplateSettings as En, BenefitFeatureType as Eo, EventsIngestResultSchema as Er, MeterDef as Es, MeterChargeModeSchema as Et, DoctorWarningCode as F, CheckoutSessionCreateInputSchema as Fa, UncancelSubscriptionResponseSchema as Fi, PlanSetResponse as Fn, FeatureFlagProperties as Fo, isEventTimestampInRange as Fr, MeterFilterSchema as Fs, ReturnOriginSchema as Ft, WebhookEndpoint as G, MAX_CHECKOUT_CONSENT_DOCS as Ga, InvoiceSchema as Gi, MeterCreditBenefit as Gn, AccountMeters as Go, ResolvedBenefit as Gr, MeterPeriodStatusSchema as Gs, meteringSettingsOf as Gt, EventTypeSchema as H, Consent as Ha, InvoicePaymentSessionCreateInput as Hi, GrantedMeterCredit as Hn, isMeterCreditBenefit as Ho, OVERRIDE_BENEFIT_SOURCE as Hr, MeterPeriodListSchema as Hs, billingSettingsOf as Ht, DoctorWarningSchema as I, CheckoutSessionCreateParsed as Ia, Invoice as Ii, PlanSetResponseSchema as In, FeatureFlagPropertiesSchema as Io, BenefitRulesDefinition as Ir, MeterFilterValue as Is, SETTINGS_LOCALES as It, WebhookEndpointList as J, checkoutRedirectUrl as Ja, InvoiceVoidInputSchema as Ji, MeterRulesMeter as Jn, CatalogMeterSchema as Jo, isGrantActive as Jr, MeterUnitsSchema as Js, BillingPathSchema as Jt, WebhookEndpointCreateInput as K, ProviderPayload as Ka, InvoiceStatusSchema as Ki, MeterCreditsOptions as Kn, AccountMetersSchema as Ko, ResolvedBenefits as Kr, MeterStanding as Ks, returnOriginsOf as Kt, buildDoctorReport as L, CheckoutSessionCreated as La, InvoiceIssueInput as Li, PlanSetWarning as Ln, MeterCreditAccountBenefit as Lo, BenefitRulesSubscription as Lr, MeterLabel as Ls, SettingsLocale as Lt, DoctorUnsellablePriceSchema as M, CheckoutReturnStatus as Ma, STEWARD_CAPABILITIES as Mi, PlanSetInputSchema as Mn, FeatureFlagAccountBenefit as Mo, IngestRejection as Mr, MeterFilterGroup as Ms, ProductSettingsPatch as Mt, DoctorUnsellableReason as N, CheckoutSession as Na, StewardCapability as Ni, PlanSetMode as Nn, FeatureFlagBenefitDef as No, IngestRejectionSchema as Nr, MeterFilterOperand as Ns, ProductSettingsPatchSchema as Nt, DoctorSettingsSchema as O, CheckoutError as Oa, ManualInvoiceResponse as Oi, liveSubscriptionOf as On, BenefitType as Oo, IngestEvent as Or, MeterDefSchema as Os, MeteringSettingsPatchSchema as Ot, DoctorWarning as P, CheckoutSessionCreateInput as Pa, UncancelSubscriptionResponse as Pi, PlanSetModeSchema as Pn, FeatureFlagBenefitDefSchema as Po, hasControlCharacters as Pr, MeterFilterOperator as Ps, ProductSettingsSchema as Pt, WebhookEndpointSchema as Q, CatalogPlan as Qa, ManualInvoiceInput as Qi, contributionOf as Qn, DecimalUnitsStringSchema as Qo, ERROR_CODES as Qr, MeteredPriceSchema as Qs, EMAIL_TEMPLATE_BY_EVENT as Qt, emailReadinessOf as R, CheckoutSessionCreatedSchema as Ra, InvoiceIssueInputSchema as Ri, PlanSetWarningCode as Rn, MeterCreditBenefitDef as Ro, EntitlementRulesCatalog as Rr, MeterLabelSchema as Rs, SettingsLocaleSchema as Rt, DoctorOverageSchema as S, PortalSessionCreateInputSchema as Sa, IntervalSchema as Sc, InvoiceIssueResponse as Si, billingPageUrl as Sn, BenefitDef as So, EventNameSchema as Sr, MeterCreditEntryKindSchema as Ss, EventsSettingsSchema as St, DoctorReport as T, CHECKOUT_ERRORS as Ta, InvoicePaymentStatus as Tc, InvoiceVoidResponseSchema as Ti, emailTemplateOf as Tn, BenefitDescriptionSchema as To, EventsIngestResult as Tr, MeterCreditPropertiesSchema as Ts, MeterChargeMode as Tt, WEBHOOK_ENDPOINT_STATUSES as U, ConsentSchema as Ua, InvoicePaymentSessionCreateInputSchema as Ui, MeterChargeTotalsLine as Un, AccountMeter as Uo, ResolveBenefitsInput as Ur, MeterPeriodSchema as Us, eventsSettingsOf as Ut, DEFAULT_ENDPOINT_EVENT_TYPES as V, CheckoutStatusSchema as Va, InvoicePaymentSession as Vi, ResyncResultSchema as Vn, isFeatureFlagBenefit as Vo, LIVE_SUBSCRIPTION_STATUSES as Vr, MeterPeriodList as Vs, applySettingsPatch as Vt, WEBHOOK_SECRET_PREFIX as W, INDIVIDUAL_IDENTITY_PLACEHOLDER as Wa, InvoicePaymentSessionSchema as Wi, MeterContribution as Wn, AccountMeterSchema as Wo, ResolveEntitlementsInput as Wr, MeterPeriodStatus as Ws, isReturnUrlAllowed as Wt, WebhookEndpointRotateInput as X, AccountsRefreshResultSchema as Xa, InvoiceWaiveInputSchema as Xi, addUtcMonths as Xn, CreditGrantInputSchema as Xo, resolveBenefits as Xr, MeteredPriceDef as Xs, EMAIL_PAYLOAD_SCHEMAS as Xt, WebhookEndpointListSchema as Y, AccountsRefreshResult as Ya, InvoiceWaiveInput as Yi, OverageRateInput as Yn, CreditGrantInput as Yo, isLiveSubscriptionStatus as Yr, MeteredPrice as Ys, EMAIL_LOCALES as Yt, WebhookEndpointRotateInputSchema as Z, Catalog as Za, MANUAL_INVOICE_MAX_AMOUNT_MINOR as Zi, consumptionOf as Zn, DEFAULT_METER_LOW_AT as Zo, resolveEntitlements as Zr, MeteredPriceDefSchema as Zs, EMAIL_TEMPLATES as Zt, DoctorEventsSchema as _, SubscriptionChangeInputSchema as _a, ExternalRefSchema as _c, HEADER_ACTOR_REF as _i, PriceChangeNoticeEmail as _n, PriceDefSchema as _o, EventMetadata as _r, MeterChargeSchema as _s, DEFAULT_PAYMENT_DUE_DAYS as _t, DOCTOR_ROLLUP_LAG_WARN_SECONDS as a, CancelSubscriptionInputSchema as aa, Currency as ac, AccountUpsertResponse as ai, EmailSettingsPatchSchema as an, FeatureDef as ao, rateOverage as ar, METER_FILTER_MAX_DEPTH as as, webhookEndpointUrlProblem as at, DoctorHostedSchema as b, PortalSession as ba, IdSchema as bc, HEADER_REQUEST_ID as bi, PriceChangeNoticeMeteredRateSchema as bn, AccountBenefitSchema as bo, EventMetadataValue as br, MeterCreditEntry as bs, EventsSettings as bt, DoctorBillingSchema as c, GrantCreateInputSchema as ca, ERROR_CATEGORIES as cc, CancelSubscriptionResponseSchema as ci, EmailTemplateSchema as cn, MAX_CATALOG_BENEFITS as co, EVENTS_INGEST_MAX_BYTES as cr, METER_STANDINGS as cs, BillingSettingsSchema as ct, DoctorEmails as d, Payment as da, Entitlements as dc, CheckoutSessionResponse as di, InvoicePaymentDueEmail as dn, MAX_PLAN_BENEFITS as do, EVENT_METADATA_MAX_PAIRS as dr, MeterAggregationSchema as ds, BrandingSchema as dt, ManualInvoiceLineInput as ea, meterFilterClauseOf as ec, ErrorCodeSpec as ei, EmailLocale as en, CatalogSchema as eo, meterChargeTotals as er, MAX_METER_UNITS as es, WebhookEndpointStatusSchema as et, DoctorEmailsSchema as f, PaymentSchema as fa, EntitlementsSchema as fc, CheckoutSessionResponseSchema as fi, InvoicePaymentDueEmailSchema as fn, METERED_PRICE_TAX_MISMATCH as fo, EVENT_METADATA_STRING_MAX_LENGTH as fr, MeterCharge as fs, DEFAULT_CHECKOUT_TTL_MINUTES as ft, DoctorEvents as g, SubscriptionChangeInput as ga, ErrorResponseSchema as gc, GrantCreateResponseSchema as gi, NotificationEmailsSchema as gn, PriceDef as go, EventExternalIdSchema as gr, MeterChargeListSchema as gs, DEFAULT_MIN_INVOICE_MINOR as gt, DoctorEndpointSchema as h, Subscription as ha, ErrorResponse as hc, GrantCreateResponse as hi, NoticedMeteredRateSchema as hn, Price as ho, EVENT_TIMESTAMP_MAX_SKEW_MINUTES as hr, MeterChargeList as hs, DEFAULT_METER_CHARGE_MODE as ht, DOCTOR_REQUIRED_LEGAL_LINKS as i, CancelSubscriptionInput as ia, CodeSchema as ic, AccountDetailSchema as ii, EmailSettingsPatch as in, CatalogSyncResultSchema as io, periodBoundsOf as ir, METER_FILTER_MAX_CONDITIONS as is, generateWebhookSecret as it, DoctorUnsellablePrice as j, CheckoutRedirectTarget as ja, MeResponseSchema as ji, PlanSetInput as jn, CatalogBenefitSchema as jo, IngestRejectCodeSchema as jr, MeterFilterCondition as js, ProductSettings as jt, DoctorSeverity as k, CheckoutPrefill as ka, ManualInvoiceResponseSchema as ki, uniqueEmails as kn, BenefitTypeSchema as ko, IngestEventSchema as kr, MeterFilter as ks, MeteringSettingsSchema as kt, DoctorCatalog as l, GrantSchema as la, EntitlementValue as lc, ChangeSubscriptionResponse as li, EmailTemplateSettings as ln, MAX_CATALOG_METERED_PRICES as lo, EVENTS_INGEST_MAX_EVENTS as lr, MeterAggregation as ls, Branding as lt, DoctorEndpointDiagnosis as m, StatsSchema as ma, ErrorCategorySchema as mc, CreditGrantResponseSchema as mi, NoticedMeteredRate as mn, PlanDefSchema as mo, EVENT_TIMESTAMP_MAX_AGE_DAYS as mr, MeterChargeLineSchema as ms, DEFAULT_LATE_GRACE_MINUTES as mt, DOCTOR_PROVIDER_ENVIRONMENTS as n, manualInvoiceTotals as na, ActorRefSchema as nc, isKnownErrorCode as ni, EmailSenderSchema as nn, CatalogSyncInputSchema as no, overageCapReached as nr, METER_CHARGE_STATUSES as ns, WebhookLastDeliverySchema as nt, DOCTOR_SEVERITIES as o, Grant as oa, CurrencySchema as oc, AccountUpsertResponseSchema as oi, EmailSettingsSchema as on, FeatureDefSchema as oo, rolloverOf as or, METER_FILTER_OPERATORS as os, BillingSettings as ot, DoctorEndpoint as p, Stats as pa, ErrorCategory as pc, CreditGrantResponse as pi, MAX_NOTIFICATION_EMAILS as pn, PlanDef as po, EVENT_NAME_MAX_LENGTH as pr, MeterChargeLine as ps, DEFAULT_EVENT_RETENTION_DAYS as pt, WebhookEndpointCreateInputSchema as q, ProviderPayloadSchema as qa, InvoiceVoidInput as qi, MeterRulesEvent as qn, CatalogMeter as qo, ResolvedEntitlements as qr, MeterStandingSchema as qs, BILLING_PATH_PLACEHOLDERS as qt, DOCTOR_REQUIRED_BRANDING as r, splitInclusiveTax as ra, AmountMinorSchema as rc, AccountDetail as ri, EmailSettings as rn, CatalogSyncResult as ro, overageOf as rr, METER_CREDIT_ENTRY_KINDS as rs, WebhookSecretSchema as rt, DoctorBilling as s, GrantCreateInput as sa, DateTimeSchema as sc, CancelSubscriptionResponse as si, EmailTemplate as sn, FeatureTypeSchema as so, standingOf as sr, METER_PERIOD_STATUSES as ss, BillingSettingsPatchSchema as st, DOCTOR_PENDING_BACKLOG_MS as t, ManualInvoiceLineInputSchema as ta, API_VERSION as tc, errorCodeSpec as ti, EmailRelevanceFacts as tn, CatalogSyncInput as to, meterCreditsOf as tr, METER_AGGREGATION_KINDS as ts, WebhookLastDelivery as tt, DoctorCatalogSchema as u, MAX_GRANT_BENEFITS as ua, EntitlementValueSchema as uc, ChangeSubscriptionResponseSchema as ui, EmailTemplateSettingsSchema as un, MAX_CATALOG_METERS as uo, EVENT_METADATA_KEY_MAX_LENGTH as ur, MeterAggregationKind as us, BrandingPatchSchema as ut, DoctorFacts as v, SubscriptionSchema as va, INVOICE_BILLING_REASONS as vc, HEADER_API_VERSION as vi, PriceChangeNoticeEmailSchema as vn, PriceSchema as vo, EventMetadataKeySchema as vr, MeterChargeStatus as vs, DEFAULT_PORTAL_TTL_MINUTES as vt, DoctorProviderSchema as w, PortalSessionSchema as wa, InvoiceBillingReasonSchema as wc, InvoiceVoidResponse as wi, emailRecipients as wn, BenefitDescription as wo, EventsIngestInputSchema as wr, MeterCreditProperties as ws, METER_CHARGE_MODES as wt, DoctorOverage as x, PortalSessionCreateInput as xa, Interval as xc, HEADER_SDK as xi, applyEmailSettingsPatch as xn, BENEFIT_TYPES as xo, EventMetadataValueSchema as xr, MeterCreditEntryKind as xs, EventsSettingsPatchSchema as xt, DoctorHosted as y, PORTAL_SESSION_ERRORS as ya, INVOICE_PAYMENT_STATUSES as yc, HEADER_IDEMPOTENCY_KEY as yi, PriceChangeNoticeMeteredRate as yn, AccountBenefit as yo, EventMetadataSchema as yr, MeterChargeStatusSchema as ys, EventRetentionDaysSchema as yt, endpointDiagnosisOf as z, CheckoutSessionSchema as za, InvoiceLine as zi, PlanSetWarningSchema as zn, MeterCreditBenefitDefSchema as zo, EntitlementRulesGrant as zr, MeterLowAtSchema as zs, TtlMinutesSchema as zt };