@stewardhq/sdk 0.1.0-rc.0

package/dist/_chunks/steward.d.ts

@@ -0,0 +1,2588 @@
+import { $t as EventRecord, An as CancelSubscriptionInput, B as WebhookEndpointRotateInput, Cr as CatalogSyncInput, F as WebhookEndpoint, Gt as CancelSubscriptionResponse, I as WebhookEndpointCreateInput, Jr as ErrorCategory, Nn as GrantCreateInput, R as WebhookEndpointList, Rn as Stats, Tr as CatalogSyncResult, Un as PortalSession, Ut as BillingProfileResponse, Vt as AccountUpsertResponse, Wn as PortalSessionCreateInput, Zt as EventList, cn as InvoiceIssueResponse, fn as ManualInvoiceResponse, g as DoctorReport, hn as InvoiceIssueInput, ht as PlanSetInput, nt as ProductSettingsPatch, or as CheckoutSessionCreated, qt as CheckoutSessionResponse, rr as CheckoutSessionCreateInput, tn as GrantCreateResponse, tt as ProductSettings, un as InvoiceVoidResponse, wn as ManualInvoiceInput, wt as ResyncResult, xn as InvoiceVoidInput, xr as Catalog, yr as AccountsRefreshResult, yt as PlanSetResponse, zt as AccountDetail } from "./index.js";
+import { C as AccountDeleteResponse, D as AccountInclude, F as AccountState, G as EntitlementSnapshot, H as BillingProfileInput, z as AccountUpsertInput } from "./events.js";
+//#region ../contract/src/client.d.ts
+type BillingClientOptions = {
+  baseUrl: string;
+  apiKey: string;
+  fetch?: typeof fetch;
+  timeoutMs?: number;
+  /** `X-Steward-Sdk` başlığı, ör. `@stewardhq/sdk/0.2.0` (gözlem; steward loglar). */
+  sdk?: string;
+};
+type CallOptions = {
+  idempotencyKey?: string;
+  actorRef?: string;
+};
+type ClientResult<T> = {
+  ok: true;
+  status: number;
+  data: T;
+  requestId?: string;
+} | {
+  ok: false;
+  status: number;
+  error: string;
+  message?: string;
+  category?: ErrorCategory;
+  retryable?: boolean;
+  requestId?: string;
+  /** 429/503 yanıtındaki `Retry-After` (saniye ya da HTTP tarihi) milisaniyeye çevrilmiş. */
+  retryAfterMs?: number;
+};
+/** `getAccountState` sonucu: 304'te gövde yok, elindeki durum güncel. */
+type AccountStateRead = {
+  notModified: false;
+  etag: string | null;
+  state: AccountState;
+} | {
+  notModified: true;
+  etag: string;
+};
+/**
+ * `Retry-After` başlığını milisaniyeye çevirir: saniye (tam sayı) ya da HTTP
+ * tarihi. Geçmiş tarih 0; okunamayan değer null.
+ */
+declare function parseRetryAfter(value: string | null | undefined, now?: number): number | null;
+type BillingClient = ReturnType<typeof createBillingClient>;
+declare function createBillingClient(options: BillingClientOptions): {
+  getCatalog: () => Promise<ClientResult<{
+    product: string;
+    defaultPlanCode: string;
+    features: {
+      key: string;
+      type: "string" | "boolean" | "limit";
+      description?: string | undefined;
+    }[];
+    plans: {
+      code: string;
+      name: string;
+      rank: number;
+      sellable: boolean;
+      entitlements: Record<string, string | number | boolean | null>;
+    }[];
+    prices: {
+      planCode: string;
+      interval: "month" | "year";
+      intervalCount: number;
+      currency: string;
+      amountMinor: number;
+      taxInclusive: boolean;
+      taxRateBps: number;
+      id: string;
+      active: boolean;
+      createdAt: string;
+    }[];
+  }>>;
+  syncCatalog: (input: CatalogSyncInput, opts?: CallOptions) => Promise<ClientResult<{
+    unchanged: boolean;
+    createdPrices: string[];
+    deactivatedPrices: string[];
+    changedPlans: string[];
+    retiredPlans: string[];
+    removedFeatures: string[];
+    defaultPlanChanged: boolean;
+    providerErrors: {
+      priceId: string;
+      provider: string;
+      code: string;
+    }[];
+  }>>;
+  upsertAccount: (accountRef: string, input: AccountUpsertInput, opts?: CallOptions) => Promise<ClientResult<{
+    ref: string;
+    displayName: string;
+    metadata: Record<string, string>;
+    createdAt: string;
+    snapshot: {
+      version: number;
+      planCode: string;
+      accessState: "active" | "suspended";
+      entitlements: Record<string, string | number | boolean | null>;
+      subscription: {
+        id: string;
+        status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+        planCode: string;
+        interval: "month" | "year";
+        amountMinor: number;
+        currency: string;
+        currentPeriodEnd: string | null;
+        cancelAt: string | null;
+      } | null;
+    };
+    account?: {
+      version: number;
+      planCode: string;
+      accessState: "active" | "suspended";
+      entitlements: Record<string, string | number | boolean | null>;
+      ref: string;
+      displayName: string;
+      updatedAt: string;
+      catalogVersion: string | null;
+      subscription: {
+        id: string;
+        status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+        planCode: string;
+        interval: "month" | "year";
+        amountMinor: number;
+        currency: string;
+        currentPeriodEnd: string | null;
+        cancelAt: string | null;
+        cancelAtPeriodEnd: boolean;
+        pastDueSince: string | null;
+        currentPeriodStart: string | null;
+        dunning: {
+          step: number;
+          nextActionAt: string | null;
+        } | null;
+        scheduledChange: {
+          planCode: string;
+          interval: "month" | "year";
+          effectiveAt: string;
+        } | null;
+      } | null;
+      openCheckout: {
+        id: string;
+        planCode: string;
+        interval: "month" | "year";
+        intervalCount: number;
+        currency: string;
+        amountMinor: number;
+        expiresAt: string;
+      } | null;
+      profile: {
+        present: boolean;
+        kind: "individual" | "company" | null;
+      };
+    } | undefined;
+  }>>;
+  getAccount: (accountRef: string, include?: readonly AccountInclude[]) => Promise<ClientResult<{
+    ref: string;
+    displayName: string;
+    metadata: Record<string, string>;
+    createdAt: string;
+    snapshot: {
+      version: number;
+      planCode: string;
+      accessState: "active" | "suspended";
+      entitlements: Record<string, string | number | boolean | null>;
+      subscription: {
+        id: string;
+        status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+        planCode: string;
+        interval: "month" | "year";
+        amountMinor: number;
+        currency: string;
+        currentPeriodEnd: string | null;
+        cancelAt: string | null;
+      } | null;
+    };
+    profile?: {
+      kind: "individual" | "company";
+      contactName: string;
+      email: string;
+      phone: string;
+      address: string;
+      city: string;
+      country: string;
+      companyName?: string | undefined;
+      taxOffice?: string | undefined;
+      taxId?: string | undefined;
+    } | null | undefined;
+    subscriptions?: {
+      id: string;
+      accountRef: string;
+      status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+      planCode: string;
+      priceId: string;
+      interval: "month" | "year";
+      amountMinor: number;
+      currency: string;
+      provider: string;
+      providerSubscriptionRef: string;
+      cancelAtPeriodEnd: boolean;
+      cancelAt: string | null;
+      cancelReason: string | null;
+      canceledAt: string | null;
+      startedAt: string;
+      currentPeriodStart: string | null;
+      currentPeriodEnd: string | null;
+      dunningStartedAt: string | null;
+    }[] | undefined;
+    checkouts?: {
+      id: string;
+      accountRef: string;
+      status: "canceled" | "expired" | "open" | "completed" | "failed";
+      planCode: string;
+      interval: "month" | "year";
+      amountMinor: number;
+      currency: string;
+      provider: string;
+      locale: string;
+      returnUrl: string;
+      consents: {
+        document: string;
+        version: string;
+        acceptedAt: string;
+        url?: string | undefined;
+      }[];
+      actorRef: string | null;
+      failureReason: string | null;
+      subscriptionId: string | null;
+      expiresAt: string;
+      createdAt: string;
+      completedAt: string | null;
+      successUrl?: string | undefined;
+      cancelUrl?: string | null | undefined;
+    }[] | undefined;
+    payments?: {
+      id: string;
+      subscriptionId: string;
+      providerOrderRef: string;
+      status: "failed" | "succeeded";
+      amountMinor: number;
+      currency: string;
+      periodStart: string | null;
+      periodEnd: string | null;
+      occurredAt: string;
+    }[] | undefined;
+    invoices?: {
+      id: string;
+      accountRef: string;
+      subscriptionId: string | null;
+      paymentId: string | null;
+      status: "void" | "draft" | "issued";
+      number: string | null;
+      currency: string;
+      subtotalMinor: number;
+      taxMinor: number;
+      totalMinor: number;
+      taxRateBps: number;
+      buyer: {
+        kind: "individual" | "company";
+        contactName: string;
+        email: string;
+        phone: string;
+        address: string;
+        city: string;
+        country: string;
+        companyName?: string | undefined;
+        taxOffice?: string | undefined;
+        taxId?: string | undefined;
+      };
+      lines: {
+        description: string;
+        quantity: number;
+        unitAmountMinor: number;
+        amountMinor: number;
+      }[];
+      issuer: string;
+      externalRef: string | null;
+      hasDocument: boolean;
+      issuedAt: string | null;
+      createdAt: string;
+      dueAt?: string | null | undefined;
+      note?: string | null | undefined;
+      voidedAt?: string | null | undefined;
+      voidReason?: string | null | undefined;
+    }[] | undefined;
+    grants?: {
+      id: string;
+      accountRef: string;
+      planCode: string | null;
+      overrides: Record<string, string | number | boolean | null>;
+      reason: string;
+      actorRef: string | null;
+      startsAt: string;
+      endsAt: string | null;
+      revokedAt: string | null;
+      createdAt: string;
+    }[] | undefined;
+  }>>;
+  getEntitlements: (accountRef: string) => Promise<ClientResult<{
+    version: number;
+    planCode: string;
+    accessState: "active" | "suspended";
+    entitlements: Record<string, string | number | boolean | null>;
+    subscription: {
+      id: string;
+      status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+      planCode: string;
+      interval: "month" | "year";
+      amountMinor: number;
+      currency: string;
+      currentPeriodEnd: string | null;
+      cancelAt: string | null;
+    } | null;
+  }>>;
+  /**
+   * Hesap durumu (`AccountState`). ETag = `"<version>"`; önceki yanıtın
+   * `etag`'i verilirse ve durum değişmediyse 304 → `{notModified: true}`.
+   */
+  getAccountState: (accountRef: string, opts?: {
+    etag?: string;
+  }) => Promise<ClientResult<AccountStateRead>>;
+  putBillingProfile: (accountRef: string, profile: BillingProfileInput, opts?: CallOptions) => Promise<ClientResult<{
+    kind: "individual" | "company";
+    contactName: string;
+    email: string;
+    phone: string;
+    address: string;
+    city: string;
+    country: string;
+    companyName?: string | undefined;
+    taxOffice?: string | undefined;
+    taxId?: string | undefined;
+    account?: {
+      version: number;
+      planCode: string;
+      accessState: "active" | "suspended";
+      entitlements: Record<string, string | number | boolean | null>;
+      ref: string;
+      displayName: string;
+      updatedAt: string;
+      catalogVersion: string | null;
+      subscription: {
+        id: string;
+        status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+        planCode: string;
+        interval: "month" | "year";
+        amountMinor: number;
+        currency: string;
+        currentPeriodEnd: string | null;
+        cancelAt: string | null;
+        cancelAtPeriodEnd: boolean;
+        pastDueSince: string | null;
+        currentPeriodStart: string | null;
+        dunning: {
+          step: number;
+          nextActionAt: string | null;
+        } | null;
+        scheduledChange: {
+          planCode: string;
+          interval: "month" | "year";
+          effectiveAt: string;
+        } | null;
+      } | null;
+      openCheckout: {
+        id: string;
+        planCode: string;
+        interval: "month" | "year";
+        intervalCount: number;
+        currency: string;
+        amountMinor: number;
+        expiresAt: string;
+      } | null;
+      profile: {
+        present: boolean;
+        kind: "individual" | "company" | null;
+      };
+    } | undefined;
+  }>>;
+  /** Atomik plan (K6): aktif plan grant'leri → tek plan grant'i (`planCode: null` kaldırır); `strict`'te 409 `subscription_plan_higher`. */
+  setPlan: (accountRef: string, input: PlanSetInput, opts?: CallOptions) => Promise<ClientResult<{
+    grant: {
+      id: string;
+      accountRef: string;
+      planCode: string | null;
+      overrides: Record<string, string | number | boolean | null>;
+      reason: string;
+      actorRef: string | null;
+      startsAt: string;
+      endsAt: string | null;
+      revokedAt: string | null;
+      createdAt: string;
+    } | null;
+    account: {
+      version: number;
+      planCode: string;
+      accessState: "active" | "suspended";
+      entitlements: Record<string, string | number | boolean | null>;
+      ref: string;
+      displayName: string;
+      updatedAt: string;
+      catalogVersion: string | null;
+      subscription: {
+        id: string;
+        status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+        planCode: string;
+        interval: "month" | "year";
+        amountMinor: number;
+        currency: string;
+        currentPeriodEnd: string | null;
+        cancelAt: string | null;
+        cancelAtPeriodEnd: boolean;
+        pastDueSince: string | null;
+        currentPeriodStart: string | null;
+        dunning: {
+          step: number;
+          nextActionAt: string | null;
+        } | null;
+        scheduledChange: {
+          planCode: string;
+          interval: "month" | "year";
+          effectiveAt: string;
+        } | null;
+      } | null;
+      openCheckout: {
+        id: string;
+        planCode: string;
+        interval: "month" | "year";
+        intervalCount: number;
+        currency: string;
+        amountMinor: number;
+        expiresAt: string;
+      } | null;
+      profile: {
+        present: boolean;
+        kind: "individual" | "company" | null;
+      };
+    };
+    warnings: {
+      code: string;
+      message: string;
+    }[];
+  }>>;
+  /** Saklı durumu `account.state_changed` (`cause: "resync"`) olarak yeniden yayınlar; version değişmez (202). */
+  resync: (accountRef: string, opts?: CallOptions) => Promise<ClientResult<{
+    queued: true;
+    eventId?: string | undefined;
+  }>>;
+  /** KVKK anonimleştirme (F4e): `{ref, deletedAt}`; silinmişse 410 `account_deleted`, canlı abonelikte 409 `subscription_active`. */
+  deleteAccount: (accountRef: string, opts?: CallOptions) => Promise<ClientResult<{
+    ref: string;
+    deletedAt: string;
+  }>>;
+  createCheckoutSession: (accountRef: string, input: CheckoutSessionCreateInput, opts?: CallOptions) => Promise<ClientResult<{
+    id: string;
+    accountRef: string;
+    status: "canceled" | "expired" | "open" | "completed" | "failed";
+    planCode: string;
+    interval: "month" | "year";
+    amountMinor: number;
+    currency: string;
+    provider: string;
+    locale: string;
+    returnUrl: string;
+    consents: {
+      document: string;
+      version: string;
+      acceptedAt: string;
+      url?: string | undefined;
+    }[];
+    actorRef: string | null;
+    failureReason: string | null;
+    subscriptionId: string | null;
+    expiresAt: string;
+    createdAt: string;
+    completedAt: string | null;
+    url: string | null;
+    successUrl?: string | undefined;
+    cancelUrl?: string | null | undefined;
+    providerPayload?: {
+      type: "html_snippet";
+      html: string;
+    } | {
+      type: "redirect";
+      url: string;
+    } | undefined;
+    account?: {
+      version: number;
+      planCode: string;
+      accessState: "active" | "suspended";
+      entitlements: Record<string, string | number | boolean | null>;
+      ref: string;
+      displayName: string;
+      updatedAt: string;
+      catalogVersion: string | null;
+      subscription: {
+        id: string;
+        status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+        planCode: string;
+        interval: "month" | "year";
+        amountMinor: number;
+        currency: string;
+        currentPeriodEnd: string | null;
+        cancelAt: string | null;
+        cancelAtPeriodEnd: boolean;
+        pastDueSince: string | null;
+        currentPeriodStart: string | null;
+        dunning: {
+          step: number;
+          nextActionAt: string | null;
+        } | null;
+        scheduledChange: {
+          planCode: string;
+          interval: "month" | "year";
+          effectiveAt: string;
+        } | null;
+      } | null;
+      openCheckout: {
+        id: string;
+        planCode: string;
+        interval: "month" | "year";
+        intervalCount: number;
+        currency: string;
+        amountMinor: number;
+        expiresAt: string;
+      } | null;
+      profile: {
+        present: boolean;
+        kind: "individual" | "company" | null;
+      };
+    } | undefined;
+  }>>;
+  getCheckoutSession: (id: string) => Promise<ClientResult<{
+    id: string;
+    accountRef: string;
+    status: "canceled" | "expired" | "open" | "completed" | "failed";
+    planCode: string;
+    interval: "month" | "year";
+    amountMinor: number;
+    currency: string;
+    provider: string;
+    locale: string;
+    returnUrl: string;
+    consents: {
+      document: string;
+      version: string;
+      acceptedAt: string;
+      url?: string | undefined;
+    }[];
+    actorRef: string | null;
+    failureReason: string | null;
+    subscriptionId: string | null;
+    expiresAt: string;
+    createdAt: string;
+    completedAt: string | null;
+    successUrl?: string | undefined;
+    cancelUrl?: string | null | undefined;
+    account?: {
+      version: number;
+      planCode: string;
+      accessState: "active" | "suspended";
+      entitlements: Record<string, string | number | boolean | null>;
+      ref: string;
+      displayName: string;
+      updatedAt: string;
+      catalogVersion: string | null;
+      subscription: {
+        id: string;
+        status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+        planCode: string;
+        interval: "month" | "year";
+        amountMinor: number;
+        currency: string;
+        currentPeriodEnd: string | null;
+        cancelAt: string | null;
+        cancelAtPeriodEnd: boolean;
+        pastDueSince: string | null;
+        currentPeriodStart: string | null;
+        dunning: {
+          step: number;
+          nextActionAt: string | null;
+        } | null;
+        scheduledChange: {
+          planCode: string;
+          interval: "month" | "year";
+          effectiveAt: string;
+        } | null;
+      } | null;
+      openCheckout: {
+        id: string;
+        planCode: string;
+        interval: "month" | "year";
+        intervalCount: number;
+        currency: string;
+        amountMinor: number;
+        expiresAt: string;
+      } | null;
+      profile: {
+        present: boolean;
+        kind: "individual" | "company" | null;
+      };
+    } | undefined;
+  }>>;
+  createPortalSession: (accountRef: string, input?: PortalSessionCreateInput, opts?: CallOptions) => Promise<ClientResult<{
+    id: string;
+    url: string;
+    expiresAt: string;
+  }>>;
+  cancelSubscription: (id: string, input: CancelSubscriptionInput, opts?: CallOptions) => Promise<ClientResult<{
+    id: string;
+    accountRef: string;
+    status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+    planCode: string;
+    priceId: string;
+    interval: "month" | "year";
+    amountMinor: number;
+    currency: string;
+    provider: string;
+    providerSubscriptionRef: string;
+    cancelAtPeriodEnd: boolean;
+    cancelAt: string | null;
+    cancelReason: string | null;
+    canceledAt: string | null;
+    startedAt: string;
+    currentPeriodStart: string | null;
+    currentPeriodEnd: string | null;
+    dunningStartedAt: string | null;
+    account?: {
+      version: number;
+      planCode: string;
+      accessState: "active" | "suspended";
+      entitlements: Record<string, string | number | boolean | null>;
+      ref: string;
+      displayName: string;
+      updatedAt: string;
+      catalogVersion: string | null;
+      subscription: {
+        id: string;
+        status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+        planCode: string;
+        interval: "month" | "year";
+        amountMinor: number;
+        currency: string;
+        currentPeriodEnd: string | null;
+        cancelAt: string | null;
+        cancelAtPeriodEnd: boolean;
+        pastDueSince: string | null;
+        currentPeriodStart: string | null;
+        dunning: {
+          step: number;
+          nextActionAt: string | null;
+        } | null;
+        scheduledChange: {
+          planCode: string;
+          interval: "month" | "year";
+          effectiveAt: string;
+        } | null;
+      } | null;
+      openCheckout: {
+        id: string;
+        planCode: string;
+        interval: "month" | "year";
+        intervalCount: number;
+        currency: string;
+        amountMinor: number;
+        expiresAt: string;
+      } | null;
+      profile: {
+        present: boolean;
+        kind: "individual" | "company" | null;
+      };
+    } | undefined;
+  }>>;
+  createGrant: (accountRef: string, input: GrantCreateInput, opts?: CallOptions) => Promise<ClientResult<{
+    id: string;
+    accountRef: string;
+    planCode: string | null;
+    overrides: Record<string, string | number | boolean | null>;
+    reason: string;
+    actorRef: string | null;
+    startsAt: string;
+    endsAt: string | null;
+    revokedAt: string | null;
+    createdAt: string;
+    account?: {
+      version: number;
+      planCode: string;
+      accessState: "active" | "suspended";
+      entitlements: Record<string, string | number | boolean | null>;
+      ref: string;
+      displayName: string;
+      updatedAt: string;
+      catalogVersion: string | null;
+      subscription: {
+        id: string;
+        status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+        planCode: string;
+        interval: "month" | "year";
+        amountMinor: number;
+        currency: string;
+        currentPeriodEnd: string | null;
+        cancelAt: string | null;
+        cancelAtPeriodEnd: boolean;
+        pastDueSince: string | null;
+        currentPeriodStart: string | null;
+        dunning: {
+          step: number;
+          nextActionAt: string | null;
+        } | null;
+        scheduledChange: {
+          planCode: string;
+          interval: "month" | "year";
+          effectiveAt: string;
+        } | null;
+      } | null;
+      openCheckout: {
+        id: string;
+        planCode: string;
+        interval: "month" | "year";
+        intervalCount: number;
+        currency: string;
+        amountMinor: number;
+        expiresAt: string;
+      } | null;
+      profile: {
+        present: boolean;
+        kind: "individual" | "company" | null;
+      };
+    } | undefined;
+  }>>;
+  revokeGrant: (id: string, opts?: CallOptions) => Promise<ClientResult<null>>;
+  getStats: () => Promise<ClientResult<{
+    subscriptions: Record<"active" | "suspended" | "past_due" | "canceled" | "expired", number>;
+    mrrMinor: Record<string, number>;
+    accounts: number;
+  }>>;
+  doctor: () => Promise<ClientResult<{
+    ok: boolean;
+    checkedAt: string;
+    product: {
+      code: string;
+      name: string;
+    };
+    catalog: {
+      synced: boolean;
+      version: string | null;
+      plans: number;
+      sellablePrices: number;
+      unsellablePrices: {
+        priceId: string;
+        planCode: string;
+        interval: "month" | "year";
+        intervalCount: number;
+        currency: string;
+        reason: string;
+      }[];
+    };
+    provider: {
+      id: string;
+      configured: boolean;
+      environment: "sandbox" | "live" | "fake" | null;
+      merchantId: string | null;
+      healthy: boolean | null;
+      lastError: {
+        code: string;
+        operation: string;
+        at: string;
+      } | null;
+    };
+    settings: {
+      appUrl: string | null;
+      returnOrigins: string[];
+    };
+    hosted: {
+      branding: {
+        missing: string[];
+      };
+      legalLinks: {
+        missing: string[];
+      };
+      ready: boolean;
+    };
+    endpoints: {
+      id: string;
+      url: string;
+      status: "active" | "paused" | "inactive";
+      eventTypes: ("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")[] | null;
+      pending: number;
+      dead: number;
+      oldestPendingAt: string | null;
+      lastDelivery: {
+        status: "pending" | "dead" | "delivered";
+        httpStatus: number | null;
+        error: string | null;
+        attempts: number;
+        at: string;
+      } | null;
+      diagnosis: string;
+    }[];
+    dunning: {
+      dryRun: boolean;
+    };
+    warnings: {
+      code: string;
+      severity: "error" | "warning" | "info";
+      message: string;
+      endpointId?: string | undefined;
+    }[];
+  }>>;
+  issueInvoice: (id: string, input: InvoiceIssueInput, opts?: CallOptions) => Promise<ClientResult<{
+    id: string;
+    accountRef: string;
+    subscriptionId: string | null;
+    paymentId: string | null;
+    status: "void" | "draft" | "issued";
+    number: string | null;
+    currency: string;
+    subtotalMinor: number;
+    taxMinor: number;
+    totalMinor: number;
+    taxRateBps: number;
+    buyer: {
+      kind: "individual" | "company";
+      contactName: string;
+      email: string;
+      phone: string;
+      address: string;
+      city: string;
+      country: string;
+      companyName?: string | undefined;
+      taxOffice?: string | undefined;
+      taxId?: string | undefined;
+    };
+    lines: {
+      description: string;
+      quantity: number;
+      unitAmountMinor: number;
+      amountMinor: number;
+    }[];
+    issuer: string;
+    externalRef: string | null;
+    hasDocument: boolean;
+    issuedAt: string | null;
+    createdAt: string;
+    dueAt?: string | null | undefined;
+    note?: string | null | undefined;
+    voidedAt?: string | null | undefined;
+    voidReason?: string | null | undefined;
+    account?: {
+      version: number;
+      planCode: string;
+      accessState: "active" | "suspended";
+      entitlements: Record<string, string | number | boolean | null>;
+      ref: string;
+      displayName: string;
+      updatedAt: string;
+      catalogVersion: string | null;
+      subscription: {
+        id: string;
+        status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+        planCode: string;
+        interval: "month" | "year";
+        amountMinor: number;
+        currency: string;
+        currentPeriodEnd: string | null;
+        cancelAt: string | null;
+        cancelAtPeriodEnd: boolean;
+        pastDueSince: string | null;
+        currentPeriodStart: string | null;
+        dunning: {
+          step: number;
+          nextActionAt: string | null;
+        } | null;
+        scheduledChange: {
+          planCode: string;
+          interval: "month" | "year";
+          effectiveAt: string;
+        } | null;
+      } | null;
+      openCheckout: {
+        id: string;
+        planCode: string;
+        interval: "month" | "year";
+        intervalCount: number;
+        currency: string;
+        amountMinor: number;
+        expiresAt: string;
+      } | null;
+      profile: {
+        present: boolean;
+        kind: "individual" | "company" | null;
+      };
+    } | undefined;
+  }>>;
+  /** Manuel taslak fatura (F4f): profil gerekir (422 `billing_profile_required`); `issueInvoice` ile kesilir. */
+  createManualInvoice: (accountRef: string, input: ManualInvoiceInput, opts?: CallOptions) => Promise<ClientResult<{
+    id: string;
+    accountRef: string;
+    subscriptionId: string | null;
+    paymentId: string | null;
+    status: "void" | "draft" | "issued";
+    number: string | null;
+    currency: string;
+    subtotalMinor: number;
+    taxMinor: number;
+    totalMinor: number;
+    taxRateBps: number;
+    buyer: {
+      kind: "individual" | "company";
+      contactName: string;
+      email: string;
+      phone: string;
+      address: string;
+      city: string;
+      country: string;
+      companyName?: string | undefined;
+      taxOffice?: string | undefined;
+      taxId?: string | undefined;
+    };
+    lines: {
+      description: string;
+      quantity: number;
+      unitAmountMinor: number;
+      amountMinor: number;
+    }[];
+    issuer: string;
+    externalRef: string | null;
+    hasDocument: boolean;
+    issuedAt: string | null;
+    createdAt: string;
+    dueAt?: string | null | undefined;
+    note?: string | null | undefined;
+    voidedAt?: string | null | undefined;
+    voidReason?: string | null | undefined;
+    account?: {
+      version: number;
+      planCode: string;
+      accessState: "active" | "suspended";
+      entitlements: Record<string, string | number | boolean | null>;
+      ref: string;
+      displayName: string;
+      updatedAt: string;
+      catalogVersion: string | null;
+      subscription: {
+        id: string;
+        status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+        planCode: string;
+        interval: "month" | "year";
+        amountMinor: number;
+        currency: string;
+        currentPeriodEnd: string | null;
+        cancelAt: string | null;
+        cancelAtPeriodEnd: boolean;
+        pastDueSince: string | null;
+        currentPeriodStart: string | null;
+        dunning: {
+          step: number;
+          nextActionAt: string | null;
+        } | null;
+        scheduledChange: {
+          planCode: string;
+          interval: "month" | "year";
+          effectiveAt: string;
+        } | null;
+      } | null;
+      openCheckout: {
+        id: string;
+        planCode: string;
+        interval: "month" | "year";
+        intervalCount: number;
+        currency: string;
+        amountMinor: number;
+        expiresAt: string;
+      } | null;
+      profile: {
+        present: boolean;
+        kind: "individual" | "company" | null;
+      };
+    } | undefined;
+  }>>;
+  /** Yalnızca manuel fatura (409 `invoice_has_payment` / `invoice_not_voidable`); `invoice.voided`. */
+  voidInvoice: (id: string, input: InvoiceVoidInput, opts?: CallOptions) => Promise<ClientResult<{
+    id: string;
+    accountRef: string;
+    subscriptionId: string | null;
+    paymentId: string | null;
+    status: "void" | "draft" | "issued";
+    number: string | null;
+    currency: string;
+    subtotalMinor: number;
+    taxMinor: number;
+    totalMinor: number;
+    taxRateBps: number;
+    buyer: {
+      kind: "individual" | "company";
+      contactName: string;
+      email: string;
+      phone: string;
+      address: string;
+      city: string;
+      country: string;
+      companyName?: string | undefined;
+      taxOffice?: string | undefined;
+      taxId?: string | undefined;
+    };
+    lines: {
+      description: string;
+      quantity: number;
+      unitAmountMinor: number;
+      amountMinor: number;
+    }[];
+    issuer: string;
+    externalRef: string | null;
+    hasDocument: boolean;
+    issuedAt: string | null;
+    createdAt: string;
+    dueAt?: string | null | undefined;
+    note?: string | null | undefined;
+    voidedAt?: string | null | undefined;
+    voidReason?: string | null | undefined;
+    account?: {
+      version: number;
+      planCode: string;
+      accessState: "active" | "suspended";
+      entitlements: Record<string, string | number | boolean | null>;
+      ref: string;
+      displayName: string;
+      updatedAt: string;
+      catalogVersion: string | null;
+      subscription: {
+        id: string;
+        status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+        planCode: string;
+        interval: "month" | "year";
+        amountMinor: number;
+        currency: string;
+        currentPeriodEnd: string | null;
+        cancelAt: string | null;
+        cancelAtPeriodEnd: boolean;
+        pastDueSince: string | null;
+        currentPeriodStart: string | null;
+        dunning: {
+          step: number;
+          nextActionAt: string | null;
+        } | null;
+        scheduledChange: {
+          planCode: string;
+          interval: "month" | "year";
+          effectiveAt: string;
+        } | null;
+      } | null;
+      openCheckout: {
+        id: string;
+        planCode: string;
+        interval: "month" | "year";
+        intervalCount: number;
+        currency: string;
+        amountMinor: number;
+        expiresAt: string;
+      } | null;
+      profile: {
+        present: boolean;
+        kind: "individual" | "company" | null;
+      };
+    } | undefined;
+  }>>;
+  getInvoiceDocument: (id: string) => Promise<ClientResult<{
+    contentType: string;
+    bytes: Uint8Array;
+  }>>;
+  listEvents: (query?: {
+    accountRef?: string;
+    cursor?: string;
+    limit?: number;
+  }) => Promise<ClientResult<{
+    items: {
+      event: {
+        id: string;
+        type: "account.updated";
+        apiVersion: string;
+        createdAt: string;
+        product: string;
+        accountRef: string;
+        data: {
+          account: {
+            version: number;
+            planCode: string;
+            accessState: "active" | "suspended";
+            entitlements: Record<string, string | number | boolean | null>;
+            subscription: {
+              id: string;
+              status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+              planCode: string;
+              interval: "month" | "year";
+              amountMinor: number;
+              currency: string;
+              currentPeriodEnd: string | null;
+              cancelAt: string | null;
+            } | null;
+          };
+          detail: {
+            changed: string[];
+          };
+        };
+      } | {
+        id: string;
+        type: "checkout.completed";
+        apiVersion: string;
+        createdAt: string;
+        product: string;
+        accountRef: string;
+        data: {
+          account: {
+            version: number;
+            planCode: string;
+            accessState: "active" | "suspended";
+            entitlements: Record<string, string | number | boolean | null>;
+            subscription: {
+              id: string;
+              status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+              planCode: string;
+              interval: "month" | "year";
+              amountMinor: number;
+              currency: string;
+              currentPeriodEnd: string | null;
+              cancelAt: string | null;
+            } | null;
+          };
+          detail: {
+            subscriptionId: string;
+            checkoutSessionId: string;
+          };
+        };
+      } | {
+        id: string;
+        type: "checkout.failed";
+        apiVersion: string;
+        createdAt: string;
+        product: string;
+        accountRef: string;
+        data: {
+          account: {
+            version: number;
+            planCode: string;
+            accessState: "active" | "suspended";
+            entitlements: Record<string, string | number | boolean | null>;
+            subscription: {
+              id: string;
+              status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+              planCode: string;
+              interval: "month" | "year";
+              amountMinor: number;
+              currency: string;
+              currentPeriodEnd: string | null;
+              cancelAt: string | null;
+            } | null;
+          };
+          detail: {
+            checkoutSessionId: string;
+            reason: string;
+          };
+        };
+      } | {
+        id: string;
+        type: "checkout.expired";
+        apiVersion: string;
+        createdAt: string;
+        product: string;
+        accountRef: string;
+        data: {
+          account: {
+            version: number;
+            planCode: string;
+            accessState: "active" | "suspended";
+            entitlements: Record<string, string | number | boolean | null>;
+            subscription: {
+              id: string;
+              status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+              planCode: string;
+              interval: "month" | "year";
+              amountMinor: number;
+              currency: string;
+              currentPeriodEnd: string | null;
+              cancelAt: string | null;
+            } | null;
+          };
+          detail: {
+            checkoutSessionId: string;
+          };
+        };
+      } | {
+        id: string;
+        type: "subscription.activated";
+        apiVersion: string;
+        createdAt: string;
+        product: string;
+        accountRef: string;
+        data: {
+          account: {
+            version: number;
+            planCode: string;
+            accessState: "active" | "suspended";
+            entitlements: Record<string, string | number | boolean | null>;
+            subscription: {
+              id: string;
+              status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+              planCode: string;
+              interval: "month" | "year";
+              amountMinor: number;
+              currency: string;
+              currentPeriodEnd: string | null;
+              cancelAt: string | null;
+            } | null;
+          };
+          detail: {
+            planCode: string;
+            interval: "month" | "year";
+            amountMinor: number;
+            currency: string;
+            actorRef: string | null;
+            subscriptionId: string;
+          };
+        };
+      } | {
+        id: string;
+        type: "subscription.renewed";
+        apiVersion: string;
+        createdAt: string;
+        product: string;
+        accountRef: string;
+        data: {
+          account: {
+            version: number;
+            planCode: string;
+            accessState: "active" | "suspended";
+            entitlements: Record<string, string | number | boolean | null>;
+            subscription: {
+              id: string;
+              status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+              planCode: string;
+              interval: "month" | "year";
+              amountMinor: number;
+              currency: string;
+              currentPeriodEnd: string | null;
+              cancelAt: string | null;
+            } | null;
+          };
+          detail: {
+            paymentId: string;
+            periodStart: string | null;
+            periodEnd: string | null;
+            invoiceId: string | null;
+            subscriptionId: string;
+          };
+        };
+      } | {
+        id: string;
+        type: "subscription.payment_failed";
+        apiVersion: string;
+        createdAt: string;
+        product: string;
+        accountRef: string;
+        data: {
+          account: {
+            version: number;
+            planCode: string;
+            accessState: "active" | "suspended";
+            entitlements: Record<string, string | number | boolean | null>;
+            subscription: {
+              id: string;
+              status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+              planCode: string;
+              interval: "month" | "year";
+              amountMinor: number;
+              currency: string;
+              currentPeriodEnd: string | null;
+              cancelAt: string | null;
+            } | null;
+          };
+          detail: {
+            paymentId: string | null;
+            attempt: number;
+            nextRetryAt: string | null;
+            subscriptionId: string;
+          };
+        };
+      } | {
+        id: string;
+        type: "subscription.suspended";
+        apiVersion: string;
+        createdAt: string;
+        product: string;
+        accountRef: string;
+        data: {
+          account: {
+            version: number;
+            planCode: string;
+            accessState: "active" | "suspended";
+            entitlements: Record<string, string | number | boolean | null>;
+            subscription: {
+              id: string;
+              status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+              planCode: string;
+              interval: "month" | "year";
+              amountMinor: number;
+              currency: string;
+              currentPeriodEnd: string | null;
+              cancelAt: string | null;
+            } | null;
+          };
+          detail: {
+            dunningDay: number;
+            subscriptionId: string;
+          };
+        };
+      } | {
+        id: string;
+        type: "subscription.reactivated";
+        apiVersion: string;
+        createdAt: string;
+        product: string;
+        accountRef: string;
+        data: {
+          account: {
+            version: number;
+            planCode: string;
+            accessState: "active" | "suspended";
+            entitlements: Record<string, string | number | boolean | null>;
+            subscription: {
+              id: string;
+              status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+              planCode: string;
+              interval: "month" | "year";
+              amountMinor: number;
+              currency: string;
+              currentPeriodEnd: string | null;
+              cancelAt: string | null;
+            } | null;
+          };
+          detail: {
+            paymentId: string | null;
+            subscriptionId: string;
+          };
+        };
+      } | {
+        id: string;
+        type: "subscription.cancel_scheduled";
+        apiVersion: string;
+        createdAt: string;
+        product: string;
+        accountRef: string;
+        data: {
+          account: {
+            version: number;
+            planCode: string;
+            accessState: "active" | "suspended";
+            entitlements: Record<string, string | number | boolean | null>;
+            subscription: {
+              id: string;
+              status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+              planCode: string;
+              interval: "month" | "year";
+              amountMinor: number;
+              currency: string;
+              currentPeriodEnd: string | null;
+              cancelAt: string | null;
+            } | null;
+          };
+          detail: {
+            cancelAt: string;
+            reason: string;
+            actorRef: string | null;
+            subscriptionId: string;
+          };
+        };
+      } | {
+        id: string;
+        type: "subscription.canceled";
+        apiVersion: string;
+        createdAt: string;
+        product: string;
+        accountRef: string;
+        data: {
+          account: {
+            version: number;
+            planCode: string;
+            accessState: "active" | "suspended";
+            entitlements: Record<string, string | number | boolean | null>;
+            subscription: {
+              id: string;
+              status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+              planCode: string;
+              interval: "month" | "year";
+              amountMinor: number;
+              currency: string;
+              currentPeriodEnd: string | null;
+              cancelAt: string | null;
+            } | null;
+          };
+          detail: {
+            reason: string;
+            effectiveAt: string;
+            actorRef: string | null;
+            subscriptionId: string;
+          };
+        };
+      } | {
+        id: string;
+        type: "subscription.expired";
+        apiVersion: string;
+        createdAt: string;
+        product: string;
+        accountRef: string;
+        data: {
+          account: {
+            version: number;
+            planCode: string;
+            accessState: "active" | "suspended";
+            entitlements: Record<string, string | number | boolean | null>;
+            subscription: {
+              id: string;
+              status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+              planCode: string;
+              interval: "month" | "year";
+              amountMinor: number;
+              currency: string;
+              currentPeriodEnd: string | null;
+              cancelAt: string | null;
+            } | null;
+          };
+          detail: {
+            effectiveAt: string;
+            subscriptionId: string;
+          };
+        };
+      } | {
+        id: string;
+        type: "subscription.terminated";
+        apiVersion: string;
+        createdAt: string;
+        product: string;
+        accountRef: string;
+        data: {
+          account: {
+            version: number;
+            planCode: string;
+            accessState: "active" | "suspended";
+            entitlements: Record<string, string | number | boolean | null>;
+            subscription: {
+              id: string;
+              status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+              planCode: string;
+              interval: "month" | "year";
+              amountMinor: number;
+              currency: string;
+              currentPeriodEnd: string | null;
+              cancelAt: string | null;
+            } | null;
+          };
+          detail: {
+            reason: "nonpayment";
+            dunningDay: number;
+            subscriptionId: string;
+          };
+        };
+      } | {
+        id: string;
+        type: "invoice.created";
+        apiVersion: string;
+        createdAt: string;
+        product: string;
+        accountRef: string;
+        data: {
+          account: {
+            version: number;
+            planCode: string;
+            accessState: "active" | "suspended";
+            entitlements: Record<string, string | number | boolean | null>;
+            subscription: {
+              id: string;
+              status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+              planCode: string;
+              interval: "month" | "year";
+              amountMinor: number;
+              currency: string;
+              currentPeriodEnd: string | null;
+              cancelAt: string | null;
+            } | null;
+          };
+          detail: {
+            invoiceId: string;
+            totalMinor: number;
+            currency: string;
+          };
+        };
+      } | {
+        id: string;
+        type: "invoice.issued";
+        apiVersion: string;
+        createdAt: string;
+        product: string;
+        accountRef: string;
+        data: {
+          account: {
+            version: number;
+            planCode: string;
+            accessState: "active" | "suspended";
+            entitlements: Record<string, string | number | boolean | null>;
+            subscription: {
+              id: string;
+              status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+              planCode: string;
+              interval: "month" | "year";
+              amountMinor: number;
+              currency: string;
+              currentPeriodEnd: string | null;
+              cancelAt: string | null;
+            } | null;
+          };
+          detail: {
+            invoiceId: string;
+            number: string;
+            totalMinor: number;
+            currency: string;
+          };
+        };
+      } | {
+        id: string;
+        type: "invoice.voided";
+        apiVersion: string;
+        createdAt: string;
+        product: string;
+        accountRef: string;
+        data: {
+          account: {
+            version: number;
+            planCode: string;
+            accessState: "active" | "suspended";
+            entitlements: Record<string, string | number | boolean | null>;
+            subscription: {
+              id: string;
+              status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+              planCode: string;
+              interval: "month" | "year";
+              amountMinor: number;
+              currency: string;
+              currentPeriodEnd: string | null;
+              cancelAt: string | null;
+            } | null;
+          };
+          detail: {
+            invoiceId: string;
+            number: string | null;
+            totalMinor: number;
+            currency: string;
+            reason: string;
+          };
+        };
+      } | {
+        id: string;
+        type: "account.state_changed";
+        apiVersion: string;
+        createdAt: string;
+        product: string;
+        accountRef: string;
+        data: {
+          account: {
+            version: number;
+            planCode: string;
+            accessState: "active" | "suspended";
+            entitlements: Record<string, string | number | boolean | null>;
+            ref: string;
+            displayName: string;
+            updatedAt: string;
+            catalogVersion: string | null;
+            subscription: {
+              id: string;
+              status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+              planCode: string;
+              interval: "month" | "year";
+              amountMinor: number;
+              currency: string;
+              currentPeriodEnd: string | null;
+              cancelAt: string | null;
+              cancelAtPeriodEnd: boolean;
+              pastDueSince: string | null;
+              currentPeriodStart: string | null;
+              dunning: {
+                step: number;
+                nextActionAt: string | null;
+              } | null;
+              scheduledChange: {
+                planCode: string;
+                interval: "month" | "year";
+                effectiveAt: string;
+              } | null;
+            } | null;
+            openCheckout: {
+              id: string;
+              planCode: string;
+              interval: "month" | "year";
+              intervalCount: number;
+              currency: string;
+              amountMinor: number;
+              expiresAt: string;
+            } | null;
+            profile: {
+              present: boolean;
+              kind: "individual" | "company" | null;
+            };
+          };
+          detail: {
+            cause: string;
+            causeEventId: string | null;
+          };
+        };
+      } | {
+        id: string;
+        type: "account.deleted";
+        apiVersion: string;
+        createdAt: string;
+        product: string;
+        accountRef: string;
+        data: {
+          account: {
+            version: number;
+            planCode: string;
+            accessState: "active" | "suspended";
+            entitlements: Record<string, string | number | boolean | null>;
+            ref: string;
+            displayName: string;
+            updatedAt: string;
+            catalogVersion: string | null;
+            subscription: {
+              id: string;
+              status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+              planCode: string;
+              interval: "month" | "year";
+              amountMinor: number;
+              currency: string;
+              currentPeriodEnd: string | null;
+              cancelAt: string | null;
+              cancelAtPeriodEnd: boolean;
+              pastDueSince: string | null;
+              currentPeriodStart: string | null;
+              dunning: {
+                step: number;
+                nextActionAt: string | null;
+              } | null;
+              scheduledChange: {
+                planCode: string;
+                interval: "month" | "year";
+                effectiveAt: string;
+              } | null;
+            } | null;
+            openCheckout: {
+              id: string;
+              planCode: string;
+              interval: "month" | "year";
+              intervalCount: number;
+              currency: string;
+              amountMinor: number;
+              expiresAt: string;
+            } | null;
+            profile: {
+              present: boolean;
+              kind: "individual" | "company" | null;
+            };
+          };
+          detail: {
+            deletedAt: string;
+            actorRef: string | null;
+          };
+        };
+      };
+      deliveries: {
+        endpointId: string;
+        status: "pending" | "dead" | "delivered";
+        attempts: number;
+        lastHttpStatus: number | null;
+        lastError: string | null;
+        nextAttemptAt: string | null;
+        deliveredAt: string | null;
+      }[];
+    }[];
+    nextCursor: string | null;
+  }>>;
+  redeliverEvent: (id: string, opts?: CallOptions) => Promise<ClientResult<{
+    event: {
+      id: string;
+      type: "account.updated";
+      apiVersion: string;
+      createdAt: string;
+      product: string;
+      accountRef: string;
+      data: {
+        account: {
+          version: number;
+          planCode: string;
+          accessState: "active" | "suspended";
+          entitlements: Record<string, string | number | boolean | null>;
+          subscription: {
+            id: string;
+            status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+            planCode: string;
+            interval: "month" | "year";
+            amountMinor: number;
+            currency: string;
+            currentPeriodEnd: string | null;
+            cancelAt: string | null;
+          } | null;
+        };
+        detail: {
+          changed: string[];
+        };
+      };
+    } | {
+      id: string;
+      type: "checkout.completed";
+      apiVersion: string;
+      createdAt: string;
+      product: string;
+      accountRef: string;
+      data: {
+        account: {
+          version: number;
+          planCode: string;
+          accessState: "active" | "suspended";
+          entitlements: Record<string, string | number | boolean | null>;
+          subscription: {
+            id: string;
+            status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+            planCode: string;
+            interval: "month" | "year";
+            amountMinor: number;
+            currency: string;
+            currentPeriodEnd: string | null;
+            cancelAt: string | null;
+          } | null;
+        };
+        detail: {
+          subscriptionId: string;
+          checkoutSessionId: string;
+        };
+      };
+    } | {
+      id: string;
+      type: "checkout.failed";
+      apiVersion: string;
+      createdAt: string;
+      product: string;
+      accountRef: string;
+      data: {
+        account: {
+          version: number;
+          planCode: string;
+          accessState: "active" | "suspended";
+          entitlements: Record<string, string | number | boolean | null>;
+          subscription: {
+            id: string;
+            status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+            planCode: string;
+            interval: "month" | "year";
+            amountMinor: number;
+            currency: string;
+            currentPeriodEnd: string | null;
+            cancelAt: string | null;
+          } | null;
+        };
+        detail: {
+          checkoutSessionId: string;
+          reason: string;
+        };
+      };
+    } | {
+      id: string;
+      type: "checkout.expired";
+      apiVersion: string;
+      createdAt: string;
+      product: string;
+      accountRef: string;
+      data: {
+        account: {
+          version: number;
+          planCode: string;
+          accessState: "active" | "suspended";
+          entitlements: Record<string, string | number | boolean | null>;
+          subscription: {
+            id: string;
+            status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+            planCode: string;
+            interval: "month" | "year";
+            amountMinor: number;
+            currency: string;
+            currentPeriodEnd: string | null;
+            cancelAt: string | null;
+          } | null;
+        };
+        detail: {
+          checkoutSessionId: string;
+        };
+      };
+    } | {
+      id: string;
+      type: "subscription.activated";
+      apiVersion: string;
+      createdAt: string;
+      product: string;
+      accountRef: string;
+      data: {
+        account: {
+          version: number;
+          planCode: string;
+          accessState: "active" | "suspended";
+          entitlements: Record<string, string | number | boolean | null>;
+          subscription: {
+            id: string;
+            status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+            planCode: string;
+            interval: "month" | "year";
+            amountMinor: number;
+            currency: string;
+            currentPeriodEnd: string | null;
+            cancelAt: string | null;
+          } | null;
+        };
+        detail: {
+          planCode: string;
+          interval: "month" | "year";
+          amountMinor: number;
+          currency: string;
+          actorRef: string | null;
+          subscriptionId: string;
+        };
+      };
+    } | {
+      id: string;
+      type: "subscription.renewed";
+      apiVersion: string;
+      createdAt: string;
+      product: string;
+      accountRef: string;
+      data: {
+        account: {
+          version: number;
+          planCode: string;
+          accessState: "active" | "suspended";
+          entitlements: Record<string, string | number | boolean | null>;
+          subscription: {
+            id: string;
+            status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+            planCode: string;
+            interval: "month" | "year";
+            amountMinor: number;
+            currency: string;
+            currentPeriodEnd: string | null;
+            cancelAt: string | null;
+          } | null;
+        };
+        detail: {
+          paymentId: string;
+          periodStart: string | null;
+          periodEnd: string | null;
+          invoiceId: string | null;
+          subscriptionId: string;
+        };
+      };
+    } | {
+      id: string;
+      type: "subscription.payment_failed";
+      apiVersion: string;
+      createdAt: string;
+      product: string;
+      accountRef: string;
+      data: {
+        account: {
+          version: number;
+          planCode: string;
+          accessState: "active" | "suspended";
+          entitlements: Record<string, string | number | boolean | null>;
+          subscription: {
+            id: string;
+            status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+            planCode: string;
+            interval: "month" | "year";
+            amountMinor: number;
+            currency: string;
+            currentPeriodEnd: string | null;
+            cancelAt: string | null;
+          } | null;
+        };
+        detail: {
+          paymentId: string | null;
+          attempt: number;
+          nextRetryAt: string | null;
+          subscriptionId: string;
+        };
+      };
+    } | {
+      id: string;
+      type: "subscription.suspended";
+      apiVersion: string;
+      createdAt: string;
+      product: string;
+      accountRef: string;
+      data: {
+        account: {
+          version: number;
+          planCode: string;
+          accessState: "active" | "suspended";
+          entitlements: Record<string, string | number | boolean | null>;
+          subscription: {
+            id: string;
+            status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+            planCode: string;
+            interval: "month" | "year";
+            amountMinor: number;
+            currency: string;
+            currentPeriodEnd: string | null;
+            cancelAt: string | null;
+          } | null;
+        };
+        detail: {
+          dunningDay: number;
+          subscriptionId: string;
+        };
+      };
+    } | {
+      id: string;
+      type: "subscription.reactivated";
+      apiVersion: string;
+      createdAt: string;
+      product: string;
+      accountRef: string;
+      data: {
+        account: {
+          version: number;
+          planCode: string;
+          accessState: "active" | "suspended";
+          entitlements: Record<string, string | number | boolean | null>;
+          subscription: {
+            id: string;
+            status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+            planCode: string;
+            interval: "month" | "year";
+            amountMinor: number;
+            currency: string;
+            currentPeriodEnd: string | null;
+            cancelAt: string | null;
+          } | null;
+        };
+        detail: {
+          paymentId: string | null;
+          subscriptionId: string;
+        };
+      };
+    } | {
+      id: string;
+      type: "subscription.cancel_scheduled";
+      apiVersion: string;
+      createdAt: string;
+      product: string;
+      accountRef: string;
+      data: {
+        account: {
+          version: number;
+          planCode: string;
+          accessState: "active" | "suspended";
+          entitlements: Record<string, string | number | boolean | null>;
+          subscription: {
+            id: string;
+            status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+            planCode: string;
+            interval: "month" | "year";
+            amountMinor: number;
+            currency: string;
+            currentPeriodEnd: string | null;
+            cancelAt: string | null;
+          } | null;
+        };
+        detail: {
+          cancelAt: string;
+          reason: string;
+          actorRef: string | null;
+          subscriptionId: string;
+        };
+      };
+    } | {
+      id: string;
+      type: "subscription.canceled";
+      apiVersion: string;
+      createdAt: string;
+      product: string;
+      accountRef: string;
+      data: {
+        account: {
+          version: number;
+          planCode: string;
+          accessState: "active" | "suspended";
+          entitlements: Record<string, string | number | boolean | null>;
+          subscription: {
+            id: string;
+            status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+            planCode: string;
+            interval: "month" | "year";
+            amountMinor: number;
+            currency: string;
+            currentPeriodEnd: string | null;
+            cancelAt: string | null;
+          } | null;
+        };
+        detail: {
+          reason: string;
+          effectiveAt: string;
+          actorRef: string | null;
+          subscriptionId: string;
+        };
+      };
+    } | {
+      id: string;
+      type: "subscription.expired";
+      apiVersion: string;
+      createdAt: string;
+      product: string;
+      accountRef: string;
+      data: {
+        account: {
+          version: number;
+          planCode: string;
+          accessState: "active" | "suspended";
+          entitlements: Record<string, string | number | boolean | null>;
+          subscription: {
+            id: string;
+            status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+            planCode: string;
+            interval: "month" | "year";
+            amountMinor: number;
+            currency: string;
+            currentPeriodEnd: string | null;
+            cancelAt: string | null;
+          } | null;
+        };
+        detail: {
+          effectiveAt: string;
+          subscriptionId: string;
+        };
+      };
+    } | {
+      id: string;
+      type: "subscription.terminated";
+      apiVersion: string;
+      createdAt: string;
+      product: string;
+      accountRef: string;
+      data: {
+        account: {
+          version: number;
+          planCode: string;
+          accessState: "active" | "suspended";
+          entitlements: Record<string, string | number | boolean | null>;
+          subscription: {
+            id: string;
+            status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+            planCode: string;
+            interval: "month" | "year";
+            amountMinor: number;
+            currency: string;
+            currentPeriodEnd: string | null;
+            cancelAt: string | null;
+          } | null;
+        };
+        detail: {
+          reason: "nonpayment";
+          dunningDay: number;
+          subscriptionId: string;
+        };
+      };
+    } | {
+      id: string;
+      type: "invoice.created";
+      apiVersion: string;
+      createdAt: string;
+      product: string;
+      accountRef: string;
+      data: {
+        account: {
+          version: number;
+          planCode: string;
+          accessState: "active" | "suspended";
+          entitlements: Record<string, string | number | boolean | null>;
+          subscription: {
+            id: string;
+            status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+            planCode: string;
+            interval: "month" | "year";
+            amountMinor: number;
+            currency: string;
+            currentPeriodEnd: string | null;
+            cancelAt: string | null;
+          } | null;
+        };
+        detail: {
+          invoiceId: string;
+          totalMinor: number;
+          currency: string;
+        };
+      };
+    } | {
+      id: string;
+      type: "invoice.issued";
+      apiVersion: string;
+      createdAt: string;
+      product: string;
+      accountRef: string;
+      data: {
+        account: {
+          version: number;
+          planCode: string;
+          accessState: "active" | "suspended";
+          entitlements: Record<string, string | number | boolean | null>;
+          subscription: {
+            id: string;
+            status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+            planCode: string;
+            interval: "month" | "year";
+            amountMinor: number;
+            currency: string;
+            currentPeriodEnd: string | null;
+            cancelAt: string | null;
+          } | null;
+        };
+        detail: {
+          invoiceId: string;
+          number: string;
+          totalMinor: number;
+          currency: string;
+        };
+      };
+    } | {
+      id: string;
+      type: "invoice.voided";
+      apiVersion: string;
+      createdAt: string;
+      product: string;
+      accountRef: string;
+      data: {
+        account: {
+          version: number;
+          planCode: string;
+          accessState: "active" | "suspended";
+          entitlements: Record<string, string | number | boolean | null>;
+          subscription: {
+            id: string;
+            status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+            planCode: string;
+            interval: "month" | "year";
+            amountMinor: number;
+            currency: string;
+            currentPeriodEnd: string | null;
+            cancelAt: string | null;
+          } | null;
+        };
+        detail: {
+          invoiceId: string;
+          number: string | null;
+          totalMinor: number;
+          currency: string;
+          reason: string;
+        };
+      };
+    } | {
+      id: string;
+      type: "account.state_changed";
+      apiVersion: string;
+      createdAt: string;
+      product: string;
+      accountRef: string;
+      data: {
+        account: {
+          version: number;
+          planCode: string;
+          accessState: "active" | "suspended";
+          entitlements: Record<string, string | number | boolean | null>;
+          ref: string;
+          displayName: string;
+          updatedAt: string;
+          catalogVersion: string | null;
+          subscription: {
+            id: string;
+            status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+            planCode: string;
+            interval: "month" | "year";
+            amountMinor: number;
+            currency: string;
+            currentPeriodEnd: string | null;
+            cancelAt: string | null;
+            cancelAtPeriodEnd: boolean;
+            pastDueSince: string | null;
+            currentPeriodStart: string | null;
+            dunning: {
+              step: number;
+              nextActionAt: string | null;
+            } | null;
+            scheduledChange: {
+              planCode: string;
+              interval: "month" | "year";
+              effectiveAt: string;
+            } | null;
+          } | null;
+          openCheckout: {
+            id: string;
+            planCode: string;
+            interval: "month" | "year";
+            intervalCount: number;
+            currency: string;
+            amountMinor: number;
+            expiresAt: string;
+          } | null;
+          profile: {
+            present: boolean;
+            kind: "individual" | "company" | null;
+          };
+        };
+        detail: {
+          cause: string;
+          causeEventId: string | null;
+        };
+      };
+    } | {
+      id: string;
+      type: "account.deleted";
+      apiVersion: string;
+      createdAt: string;
+      product: string;
+      accountRef: string;
+      data: {
+        account: {
+          version: number;
+          planCode: string;
+          accessState: "active" | "suspended";
+          entitlements: Record<string, string | number | boolean | null>;
+          ref: string;
+          displayName: string;
+          updatedAt: string;
+          catalogVersion: string | null;
+          subscription: {
+            id: string;
+            status: "active" | "suspended" | "past_due" | "canceled" | "expired";
+            planCode: string;
+            interval: "month" | "year";
+            amountMinor: number;
+            currency: string;
+            currentPeriodEnd: string | null;
+            cancelAt: string | null;
+            cancelAtPeriodEnd: boolean;
+            pastDueSince: string | null;
+            currentPeriodStart: string | null;
+            dunning: {
+              step: number;
+              nextActionAt: string | null;
+            } | null;
+            scheduledChange: {
+              planCode: string;
+              interval: "month" | "year";
+              effectiveAt: string;
+            } | null;
+          } | null;
+          openCheckout: {
+            id: string;
+            planCode: string;
+            interval: "month" | "year";
+            intervalCount: number;
+            currency: string;
+            amountMinor: number;
+            expiresAt: string;
+          } | null;
+          profile: {
+            present: boolean;
+            kind: "individual" | "company" | null;
+          };
+        };
+        detail: {
+          deletedAt: string;
+          actorRef: string | null;
+        };
+      };
+    };
+    deliveries: {
+      endpointId: string;
+      status: "pending" | "dead" | "delivered";
+      attempts: number;
+      lastHttpStatus: number | null;
+      lastError: string | null;
+      nextAttemptAt: string | null;
+      deliveredAt: string | null;
+    }[];
+  }>>;
+  getSettings: () => Promise<ClientResult<{
+    provider: string;
+    defaultCurrency: string;
+    defaultLocale: "tr" | "en";
+    extraReturnOrigins: string[];
+    branding: {
+      name?: string | undefined;
+      logoUrl?: string | undefined;
+      accentColor?: string | undefined;
+      supportEmail?: string | undefined;
+    };
+    checkoutTtlMinutes: number;
+    portalTtlMinutes: number;
+    appUrl?: string | undefined;
+    privacyUrl?: string | undefined;
+    termsUrl?: string | undefined;
+  }>>;
+  updateSettings: (patch: ProductSettingsPatch, opts?: CallOptions) => Promise<ClientResult<{
+    provider: string;
+    defaultCurrency: string;
+    defaultLocale: "tr" | "en";
+    extraReturnOrigins: string[];
+    branding: {
+      name?: string | undefined;
+      logoUrl?: string | undefined;
+      accentColor?: string | undefined;
+      supportEmail?: string | undefined;
+    };
+    checkoutTtlMinutes: number;
+    portalTtlMinutes: number;
+    appUrl?: string | undefined;
+    privacyUrl?: string | undefined;
+    termsUrl?: string | undefined;
+  }>>;
+  listWebhookEndpoints: () => Promise<ClientResult<{
+    items: {
+      id: string;
+      url: string;
+      status: "active" | "paused" | "inactive";
+      eventTypes: ("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")[] | null;
+      description: string | null;
+      createdAt: string;
+      rotatedAt: string | null;
+      lastDelivery: {
+        status: "pending" | "dead" | "delivered";
+        httpStatus: number | null;
+        error: string | null;
+        attempts: number;
+        at: string;
+      } | null;
+    }[];
+  }>>;
+  createWebhookEndpoint: (input: WebhookEndpointCreateInput, opts?: CallOptions) => Promise<ClientResult<{
+    id: string;
+    url: string;
+    status: "active" | "paused" | "inactive";
+    eventTypes: ("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")[] | null;
+    description: string | null;
+    createdAt: string;
+    rotatedAt: string | null;
+    lastDelivery: {
+      status: "pending" | "dead" | "delivered";
+      httpStatus: number | null;
+      error: string | null;
+      attempts: number;
+      at: string;
+    } | null;
+  }>>;
+  rotateWebhookEndpointSecret: (id: string, input: WebhookEndpointRotateInput, opts?: CallOptions) => Promise<ClientResult<{
+    id: string;
+    url: string;
+    status: "active" | "paused" | "inactive";
+    eventTypes: ("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")[] | null;
+    description: string | null;
+    createdAt: string;
+    rotatedAt: string | null;
+    lastDelivery: {
+      status: "pending" | "dead" | "delivered";
+      httpStatus: number | null;
+      error: string | null;
+      attempts: number;
+      at: string;
+    } | null;
+  }>>;
+  deactivateWebhookEndpoint: (id: string, opts?: CallOptions) => Promise<ClientResult<{
+    id: string;
+    url: string;
+    status: "active" | "paused" | "inactive";
+    eventTypes: ("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")[] | null;
+    description: string | null;
+    createdAt: string;
+    rotatedAt: string | null;
+    lastDelivery: {
+      status: "pending" | "dead" | "delivered";
+      httpStatus: number | null;
+      error: string | null;
+      attempts: number;
+      at: string;
+    } | null;
+  }>>;
+};
+//#endregion
+//#region src/retry.d.ts
+type RetryClass = "network" | "5xx" | "429";
+type RetryOptions = {
+  /** İlk istekten sonraki en çok tekrar sayısı; 0 kapatır. Varsayılan 2. */
+  attempts?: number;
+  /** Tekrar denenen hata sınıfları. Varsayılan hepsi. */
+  on?: readonly RetryClass[];
+  /** Tek bir beklemenin üst sınırı (Retry-After dahil), ms. Varsayılan 5000. */
+  maxDelayMs?: number;
+  /** Test için: bekleme. Varsayılan `setTimeout`. */
+  sleep?: (ms: number) => Promise<void>;
+  /** Test için: jitter kaynağı, [0, 1). Varsayılan `Math.random`. */
+  random?: () => number;
+};
+//#endregion
+//#region src/steward.d.ts
+type StewardEnv = Readonly<Record<string, string | undefined>>;
+type StewardOptions = {
+  /** Varsayılan `STEWARD_URL`. Ürün adresi ve anahtarı ikisi de yoksa ve admin ayarları tamsa istemci yalnızca `admin.*` içindir. */
+  baseUrl?: string;
+  /** Varsayılan `STEWARD_API_KEY`. */
+  apiKey?: string;
+  /** Ayarların okunduğu ortam; varsayılan `process.env` (varsa). */
+  env?: StewardEnv;
+  fetch?: typeof fetch;
+  /** Deneme başına zaman aşımı, ms. Varsayılan 10 sn. */
+  timeoutMs?: number;
+  /**
+   * Mutasyonlarda varsayılan `X-Actor-Ref` (ör. `system`); çağrıdaki `actorRef` ezer. İkisi de
+   * yoksa mutasyon istek göndermeden `StewardConfigError` (`actor_ref_required`) fırlatır.
+   */
+  actorRef?: string;
+  /** Varsayılan `STEWARD_ADMIN_URL`; yalnızca `admin.*` için. */
+  adminBaseUrl?: string;
+  /** Varsayılan `STEWARD_ADMIN_API_KEY`; yalnızca `admin.*` için. */
+  adminApiKey?: string;
+  retries?: RetryOptions;
+};
+/** Mutasyon çağrısı seçenekleri: `Idempotency-Key` ve `X-Actor-Ref`. */
+type MutationOptions = CallOptions;
+/** Koşullu katalog okuması: 304'te gövde yok, elindeki katalog güncel. */
+type CatalogRead = {
+  notModified: false;
+  etag: string | null;
+  catalog: Catalog;
+} | {
+  notModified: true;
+  etag: string;
+};
+type EventListQuery = {
+  accountRef?: string;
+  cursor?: string;
+  limit?: number;
+};
+type InvoiceDocument = {
+  contentType: string;
+  bytes: Uint8Array;
+};
+/** `GET /v1/me`: anahtarın ürünü ve kapsamı (kurulum doğrulaması). */
+type StewardMe = {
+  product: string;
+  keyName: string;
+  scope: "product" | "admin";
+};
+type Steward = {
+  accounts: {
+    /** `PUT /v1/accounts/{ref}` — hesabı oluşturur ya da günceller. */
+    upsert(ref: string, input: AccountUpsertInput, options?: MutationOptions): Promise<AccountUpsertResponse>;
+    get(ref: string, options?: {
+      include?: readonly AccountInclude[];
+    }): Promise<AccountDetail>;
+    /** `GET /v1/accounts/{ref}/state`. */
+    state(ref: string): Promise<AccountState>;
+    /** Koşullu durum okuması (önbellekler için): `etag` verilir ve durum değişmediyse `{notModified: true}`. */
+    readState(ref: string, options?: {
+      etag?: string;
+    }): Promise<AccountStateRead>;
+    /** `GET /v1/accounts/{ref}/entitlements` (snapshot; `state`'in alt kümesi). */
+    entitlements(ref: string): Promise<EntitlementSnapshot>;
+    putBillingProfile(ref: string, profile: BillingProfileInput, options?: MutationOptions): Promise<BillingProfileResponse>;
+    /**
+     * `PUT /v1/accounts/{ref}/plan` — atomik plan (K6): aktif plan grant'leri tek plan
+     * grant'iyle değişir, `planCode: null` kaldırır. Canlı abonelik planı hedefi
+     * geçiyorsa `mode: "ensure"` (varsayılan) sonuç + `warnings`, `"strict"`
+     * `StewardApiError` `subscription_plan_higher` (409). Yanıttaki `account` önbelleğe `prime` edilebilir.
+     */
+    setPlan(ref: string, input: PlanSetInput, options?: MutationOptions): Promise<PlanSetResponse>;
+    /** `POST /v1/accounts/{ref}/resync` — saklı durumu `account.state_changed` (`cause: "resync"`) olarak yeniden yayınlar; version değişmez. */
+    resync(ref: string, options?: MutationOptions): Promise<ResyncResult>;
+    /**
+     * `DELETE /v1/accounts/{ref}` — KVKK anonimleştirme (F4e): profil ve kişisel veri silinir,
+     * faturalar kalır → `{ref, deletedAt}`. Sonra hesabın her ucu `account_deleted` (410; aynı
+     * ref'le `upsert` dahil). Canlı abonelikte `subscription_active` (409; önce `immediate`
+     * iptal), formu açık checkout'ta `checkout_in_progress` (409; süresi dolunca tekrar);
+     * zaten silinmişse `account_deleted` — iş tekrarında başarı sayılabilir.
+     */
+    delete(ref: string, options?: MutationOptions): Promise<AccountDeleteResponse>;
+  };
+  checkoutSessions: {
+    create(ref: string, input: CheckoutSessionCreateInput, options?: MutationOptions): Promise<CheckoutSessionCreated>;
+    get(id: string): Promise<CheckoutSessionResponse>;
+  };
+  /**
+   * Hosted müşteri portalı (F3a): `POST /v1/accounts/{ref}/portal-sessions` → `{id, url, expiresAt}`.
+   * Tarayıcı `url`e yönlendirilir (iptal, ödemeyi yeniden dene, fatura, profil steward'da).
+   * Yetki üründe; `actorRef` portalı açan kullanıcı. Durum değişmez, event yok.
+   */
+  portalSessions: {
+    create(ref: string, input?: PortalSessionCreateInput, options?: MutationOptions): Promise<PortalSession>;
+  };
+  subscriptions: {
+    cancel(id: string, input: CancelSubscriptionInput, options?: MutationOptions): Promise<CancelSubscriptionResponse>;
+  };
+  grants: {
+    create(ref: string, input: GrantCreateInput, options?: MutationOptions): Promise<GrantCreateResponse>;
+    revoke(id: string, options?: MutationOptions): Promise<void>;
+  };
+  invoices: {
+    issue(id: string, input: InvoiceIssueInput, options?: MutationOptions): Promise<InvoiceIssueResponse>;
+    document(id: string): Promise<InvoiceDocument>;
+    /**
+     * `POST /v1/accounts/{ref}/invoices` (F4f) — manuel taslak fatura (Enterprise satışı); `issue` ile kesilir.
+     * Hesabın fatura profili gerekir (422 `billing_profile_required`). `invoice.created` yayınlanır, durum değişmez.
+     */
+    createManual(ref: string, input: ManualInvoiceInput, options?: MutationOptions): Promise<ManualInvoiceResponse>;
+    /**
+     * `POST /v1/invoices/{id}/void` (F4f) — yalnızca manuel fatura (taslak ya da kesilmiş; numara ve belge kalır).
+     * Ödemeli fatura 409 `invoice_has_payment`, zaten void 409 `invoice_not_voidable`. `invoice.voided` yayınlanır.
+     */
+    void(id: string, input: InvoiceVoidInput, options?: MutationOptions): Promise<InvoiceVoidResponse>;
+  };
+  catalog: {
+    get(): Promise<Catalog>;
+    /** Koşullu okuma (`If-None-Match`); `createCatalogCache` kullanır. */
+    read(options?: {
+      etag?: string;
+    }): Promise<CatalogRead>;
+  };
+  events: {
+    list(query?: EventListQuery): Promise<EventList>;
+    redeliver(id: string, options?: MutationOptions): Promise<EventRecord>;
+  };
+  stats(): Promise<Stats>;
+  me(): Promise<StewardMe>;
+  /**
+   * `GET /v1/doctor` — kurulum teşhisi (K11): katalog senkronu, sağlayıcı, ayarlar, hosted
+   * sayfa hazırlığı, endpoint teslimat teşhisi (`wrong_secret` = son teslimat 401),
+   * dunning ve `warnings[{code, severity, message}]`; `ok` = `error` önemde uyarı yok.
+   * Ürün anahtarıyla çalışır (yalnızca admin ayarlı istemcide admin anahtarıyla). Sağlayıcı
+   * sağlığı yanıtı veren pod'un gözlemidir.
+   */
+  doctor(): Promise<DoctorReport>;
+  /** Admin kapsamlı uçlar: `adminBaseUrl`/`adminApiKey` (ya da `STEWARD_ADMIN_*`) gerekir. */
+  admin: {
+    catalog: {
+      sync(input: CatalogSyncInput, options?: MutationOptions): Promise<CatalogSyncResult>;
+    };
+    accounts: {
+      refresh(options?: MutationOptions): Promise<AccountsRefreshResult>;
+    };
+    settings: {
+      /** `GET /v1/admin/settings`. */
+      get(): Promise<ProductSettings>;
+      /** `PATCH /v1/admin/settings`: verilmeyen alan değişmez, `null` temizler, `branding` sığ birleşir. */
+      update(patch: ProductSettingsPatch, options?: MutationOptions): Promise<ProductSettings>;
+    };
+    /**
+     * Webhook endpoint'leri. Sırrı çağıran üretir (`generateWebhookSecret()`) ve
+     * saklar; steward hiçbir yanıtta geri vermez.
+     */
+    endpoints: {
+      list(): Promise<WebhookEndpointList>;
+      /** `eventTypes` verilmezse yalnızca `account.state_changed`. */
+      create(input: WebhookEndpointCreateInput, options?: MutationOptions): Promise<WebhookEndpoint>;
+      /** Yeni sır; eskisi ürün geçişi bitene kadar ikinci imza olarak kalır. */
+      rotate(id: string, input: WebhookEndpointRotateInput, options?: MutationOptions): Promise<WebhookEndpoint>;
+      /** `status: inactive`; geri alınmaz (yeni endpoint açılır). */
+      deactivate(id: string, options?: MutationOptions): Promise<WebhookEndpoint>;
+    };
+  };
+  /**
+   * Fırlatmayan, tekrar denemeyen sözleşme istemcisi (`ClientResult`; ürün hedefi). Aktör
+   * denetimi yapmaz. Yalnızca admin ayarlı istemcide her metot `StewardConfigError` ile reddeder.
+   */
+  raw: BillingClient;
+};
+declare function createSteward(options?: StewardOptions): Steward;
+//#endregion
+export { createBillingClient as _, Steward as a, StewardOptions as c, RetryOptions as d, AccountStateRead as f, ClientResult as g, CallOptions as h, MutationOptions as i, createSteward as l, BillingClientOptions as m, EventListQuery as n, StewardEnv as o, BillingClient as p, InvoiceDocument as r, StewardMe as s, CatalogRead as t, RetryClass as u, parseRetryAfter as v };