@stewardhq/sdk 0.1.0-rc.0 → 0.2.0

package/dist/index.js

@@ -1,62 +1,8 @@
 import { A as CodeSchema, B as IntervalSchema, C as BillingProfileSchema, D as API_VERSION, E as SubscriptionSummarySchema, F as EntitlementsSchema, I as ErrorCategorySchema, L as ErrorResponseSchema, M as DateTimeSchema, N as ERROR_CATEGORIES, O as ActorRefSchema, P as EntitlementValueSchema, R as ExternalRefSchema, S as BillingProfileKindSchema, T as SubscriptionStatusSchema, V as MetadataSchema, _ as AccountScheduledChangeSchema, a as EVENT_TYPES, b as AccountSubscriptionStateSchema, c as PING_EVENT_TYPE, d as ACCOUNT_INCLUDES, f as AccessStateSchema, g as AccountProfileStateSchema, h as AccountOpenCheckoutSchema, i as EVENT_DETAIL_SCHEMAS, j as CurrencySchema, k as AmountMinorSchema, l as PingSchema, m as AccountDunningStateSchema, n as ApiVersionSchema, o as EventIdSchema, p as AccountDeleteResponseSchema, r as BillingEventSchema, s as LEGACY_EVENT_TYPES, t as AnyBillingEventSchema, u as isEventType, v as AccountSchema, w as EntitlementSnapshotSchema, x as AccountUpsertInputSchema, y as AccountStateSchema, z as IdSchema } from "./_chunks/events.js";
-import { $ as HEADER_SDK, $t as FeatureTypeSchema, A as webhookEndpointUrlProblem, At as MAX_CHECKOUT_CONSENT_DOCS, B as AccountDetailSchema, Bt as ReturnOriginSchema, C as WebhookEndpointListSchema, Ct as CheckoutConsentInputSchema, D as WebhookLastDeliverySchema, Dt as CheckoutSessionSchema, E as WebhookEndpointStatusSchema, Et as CheckoutSessionCreatedSchema, F as PlanSetWarningSchema, Ft as BrandingSchema, G as DeliverySchema, Gt as applySettingsPatch, H as BillingProfileResponseSchema, Ht as SettingsLocaleSchema, I as ResyncResultSchema, It as DEFAULT_CHECKOUT_TTL_MINUTES, J as GrantCreateResponseSchema, Jt as AccountsRefreshResultSchema, K as EventListSchema, Kt as isReturnUrlAllowed, L as ERROR_CODES, Lt as DEFAULT_PORTAL_TTL_MINUTES, M as PlanSetInputSchema, Mt as checkoutRedirectUrl, N as PlanSetModeSchema, Nt as isLegacyCheckoutInput, O as WebhookSecretSchema, Ot as CheckoutStatusSchema, P as PlanSetResponseSchema, Pt as BrandingPatchSchema, Q as HEADER_REQUEST_ID, Qt as FeatureDefSchema, R as errorCodeSpec, Rt as ProductSettingsPatchSchema, S as WebhookEndpointCreateInputSchema, St as CHECKOUT_ERRORS, T as WebhookEndpointSchema, Tt as CheckoutSessionCreateInputSchema, U as CancelSubscriptionResponseSchema, Ut as TtlMinutesSchema, V as AccountUpsertResponseSchema, Vt as SETTINGS_LOCALES, W as CheckoutSessionResponseSchema, Wt as WebUrlSchema, X as HEADER_API_VERSION, Xt as CatalogSyncInputSchema, Y as HEADER_ACTOR_REF, Yt as CatalogSchema, Z as HEADER_IDEMPOTENCY_KEY, Zt as CatalogSyncResultSchema, _ as hostedReadinessOf, _t as StatsSchema, a as DOCTOR_SEVERITIES, at as InvoiceSchema, b as WEBHOOK_ENDPOINT_STATUSES, bt as PortalSessionCreateInputSchema, c as DoctorHostedSchema, ct as MANUAL_INVOICE_MAX_AMOUNT_MINOR, d as DoctorSettingsSchema, dt as manualInvoiceTotals, en as PlanDefSchema, et as InvoiceIssueResponseSchema, f as DoctorSeveritySchema, ft as splitInclusiveTax, g as endpointDiagnosisOf, gt as PaymentSchema, h as buildDoctorReport, ht as GrantSchema, i as DOCTOR_REQUIRED_LEGAL_LINKS, it as InvoiceLineSchema, j as PLAN_SET_MODES, jt as ProviderPayloadSchema, k as generateWebhookSecret, kt as ConsentSchema, l as DoctorProviderSchema, lt as ManualInvoiceInputSchema, m as DoctorWarningSchema, mt as GrantCreateInputSchema, n as DOCTOR_PROVIDER_ENVIRONMENTS, nn as PriceSchema, nt as ManualInvoiceResponseSchema, o as DoctorCatalogSchema, ot as InvoiceStatusSchema, p as DoctorUnsellablePriceSchema, pt as CancelSubscriptionInputSchema, q as EventRecordSchema, qt as returnOriginsOf, r as DOCTOR_REQUIRED_BRANDING, rt as InvoiceIssueInputSchema, s as DoctorEndpointSchema, st as InvoiceVoidInputSchema, t as DOCTOR_PENDING_BACKLOG_MS, tn as PriceDefSchema, tt as InvoiceVoidResponseSchema, u as DoctorReportSchema, ut as ManualInvoiceLineInputSchema, v as DEFAULT_ENDPOINT_EVENT_TYPES, vt as SubscriptionSchema, w as WebhookEndpointRotateInputSchema, wt as CheckoutPrefillSchema, x as WEBHOOK_SECRET_PREFIX, xt as PortalSessionSchema, y as EventTypeSchema, yt as PORTAL_SESSION_ERRORS, z as isKnownErrorCode, zt as ProductSettingsSchema } from "./_chunks/src.js";
+import { $ as InvoiceIssueInputSchema, A as webhookEndpointUrlProblem, At as BrandingSchema, B as AccountDetailSchema, Bt as applySettingsPatch, C as WebhookEndpointListSchema, Ct as CheckoutSessionSchema, D as WebhookLastDeliverySchema, Dt as ProviderPayloadSchema, E as WebhookEndpointStatusSchema, Et as MAX_CHECKOUT_CONSENT_DOCS, F as PlanSetWarningSchema, Ft as ReturnOriginSchema, G as HEADER_ACTOR_REF, Gt as CatalogSyncInputSchema, H as CancelSubscriptionResponseSchema, Ht as returnOriginsOf, I as ResyncResultSchema, It as SETTINGS_LOCALES, J as HEADER_REQUEST_ID, Jt as FeatureTypeSchema, K as HEADER_API_VERSION, Kt as CatalogSyncResultSchema, L as ERROR_CODES, Lt as SettingsLocaleSchema, M as PlanSetInputSchema, Mt as DEFAULT_PORTAL_TTL_MINUTES, N as PlanSetModeSchema, Nt as ProductSettingsPatchSchema, O as WebhookSecretSchema, Ot as checkoutRedirectUrl, P as PlanSetResponseSchema, Pt as ProductSettingsSchema, Q as ManualInvoiceResponseSchema, R as errorCodeSpec, Rt as TtlMinutesSchema, S as WebhookEndpointCreateInputSchema, St as CheckoutSessionCreatedSchema, T as WebhookEndpointSchema, Tt as ConsentSchema, U as CheckoutSessionResponseSchema, Ut as AccountsRefreshResultSchema, V as AccountUpsertResponseSchema, Vt as isReturnUrlAllowed, W as GrantCreateResponseSchema, Wt as CatalogSchema, X as InvoiceIssueResponseSchema, Xt as PriceDefSchema, Y as HEADER_SDK, Yt as PlanDefSchema, Z as InvoiceVoidResponseSchema, Zt as PriceSchema, _ as hostedReadinessOf, _t as PortalSessionSchema, a as DOCTOR_SEVERITIES, at as ManualInvoiceInputSchema, b as WEBHOOK_ENDPOINT_STATUSES, bt as CheckoutPrefillSchema, c as DoctorHostedSchema, ct as splitInclusiveTax, d as DoctorSettingsSchema, dt as GrantSchema, et as InvoiceLineSchema, f as DoctorSeveritySchema, ft as PaymentSchema, g as endpointDiagnosisOf, gt as PortalSessionCreateInputSchema, h as buildDoctorReport, ht as PORTAL_SESSION_ERRORS, i as DOCTOR_REQUIRED_LEGAL_LINKS, it as MANUAL_INVOICE_MAX_AMOUNT_MINOR, j as PLAN_SET_MODES, jt as DEFAULT_CHECKOUT_TTL_MINUTES, k as generateWebhookSecret, kt as BrandingPatchSchema, l as DoctorProviderSchema, lt as CancelSubscriptionInputSchema, m as DoctorWarningSchema, mt as SubscriptionSchema, n as DOCTOR_PROVIDER_ENVIRONMENTS, nt as InvoiceStatusSchema, o as DoctorCatalogSchema, ot as ManualInvoiceLineInputSchema, p as DoctorUnsellablePriceSchema, pt as StatsSchema, q as HEADER_IDEMPOTENCY_KEY, qt as FeatureDefSchema, r as DOCTOR_REQUIRED_BRANDING, rt as InvoiceVoidInputSchema, s as DoctorEndpointSchema, st as manualInvoiceTotals, t as DOCTOR_PENDING_BACKLOG_MS, tt as InvoiceSchema, u as DoctorReportSchema, ut as GrantCreateInputSchema, v as DEFAULT_ENDPOINT_EVENT_TYPES, vt as CHECKOUT_ERRORS, w as WebhookEndpointRotateInputSchema, wt as CheckoutStatusSchema, x as WEBHOOK_SECRET_PREFIX, xt as CheckoutSessionCreateInputSchema, y as EventTypeSchema, yt as CheckoutConsentInputSchema, z as isKnownErrorCode, zt as WebUrlSchema } from "./_chunks/src.js";
 import { a as isGrantActive, i as LIVE_SUBSCRIPTION_STATUSES, n as isValidTckn, o as isLiveSubscriptionStatus, r as isValidVkn, s as resolveEntitlements, t as isE164 } from "./_chunks/validators.js";
-import { n as createBillingClient, r as parseRetryAfter, t as createSteward } from "./_chunks/steward.js";
+import { t as createSteward } from "./_chunks/steward.js";
 import { a as StewardNetworkError, i as StewardError, n as StewardConfigError, r as StewardContractError, t as StewardApiError } from "./_chunks/errors.js";
-import { n as localeOf } from "./_chunks/locale.js";
-//#region src/catalog-cache.ts
-function createCatalogCache(steward, options = {}) {
-	const ttlMs = options.ttlMs ?? 6e4;
-	if (!Number.isFinite(ttlMs) || ttlMs < 0) throw new StewardConfigError({ message: `createCatalogCache: ttlMs negatif olmayan sayı olmalı: ${ttlMs}` });
-	const logger = options.logger ?? console;
-	let entry = null;
-	let inflight = null;
-	async function refresh() {
-		const previous = entry;
-		try {
-			const read = await steward.catalog.read(previous?.etag ? { etag: previous.etag } : {});
-			let next;
-			if (!read.notModified) next = {
-				catalog: read.catalog,
-				etag: read.etag,
-				fetchedAt: Date.now()
-			};
-			else if (previous !== null) next = {
-				...previous,
-				etag: read.etag,
-				fetchedAt: Date.now()
-			};
-			else throw new StewardContractError({ httpStatus: 304 });
-			entry = next;
-			return next.catalog;
-		} catch (error) {
-			if (previous === null) throw error;
-			const { code, requestId } = typeof error === "object" && error !== null ? error : {};
-			logger.warn("steward katalogu tazelenemedi; bayat değer kullanılıyor", {
-				code: typeof code === "string" ? code : null,
-				requestId: typeof requestId === "string" ? requestId : null,
-				ageMs: Date.now() - previous.fetchedAt
-			});
-			return previous.catalog;
-		}
-	}
-	return {
-		get() {
-			if (entry !== null && Date.now() - entry.fetchedAt < ttlMs) return Promise.resolve(entry.catalog);
-			inflight ??= refresh().finally(() => {
-				inflight = null;
-			});
-			return inflight;
-		},
-		invalidate() {
-			if (entry !== null) entry = {
-				...entry,
-				fetchedAt: Number.NEGATIVE_INFINITY
-			};
-		}
-	};
-}
-//#endregion
 //#region src/state-cache.ts
 const MANY_CONCURRENCY = 8;
 const FAILURE_BACKOFF_MS = 5e3;
@@ -410,148 +356,6 @@ function httpStatusFor(err, options = {}) {
 	};
 }
 //#endregion
-//#region src/messages.ts
-/** SDK'nın kendisinin ürettiği kodlar (yanıt yok ya da istek hiç gönderilmedi). */
-const CLIENT_ERROR_CODES = [
-	"network_error",
-	"timeout",
-	"invalid_response",
-	"config_error"
-];
-const STEWARD_ERROR_CODES = Object.freeze([...Object.keys(ERROR_CODES), ...CLIENT_ERROR_CODES]);
-const TR_CONFIG = "Ödeme sistemi yapılandırmasında bir sorun var. Lütfen destekle iletişime geçin.";
-const TR_RETRY = "İstek işlenemedi. Lütfen tekrar deneyin.";
-const TR_LATER = "Ödeme sistemi şu anda kullanılamıyor. Lütfen biraz sonra tekrar deneyin.";
-const EN_CONFIG = "There is a problem with the billing configuration. Please contact support.";
-const EN_RETRY = "The request could not be processed. Please try again.";
-const errorMessages = {
-	tr: {
-		unauthorized: TR_CONFIG,
-		forbidden: TR_CONFIG,
-		invalid_actor_ref: TR_RETRY,
-		actor_ref_required: TR_RETRY,
-		idempotency_key_required: TR_RETRY,
-		invalid_idempotency_key: TR_RETRY,
-		idempotency_key_reused: "Bu istek daha önce farklı bilgilerle gönderildi. Sayfayı yenileyip tekrar deneyin.",
-		request_in_progress: "Aynı işlem şu anda sürüyor. Birkaç saniye sonra tekrar deneyin.",
-		invalid_json: TR_RETRY,
-		invalid_request: "Gönderilen bilgiler geçersiz. Lütfen kontrol edip tekrar deneyin.",
-		invalid_account_ref: "Hesap bilgisi geçersiz.",
-		invalid_include: TR_RETRY,
-		invalid_cursor: TR_RETRY,
-		invalid_limit: TR_RETRY,
-		not_found: "Kayıt bulunamadı.",
-		account_not_found: "Faturalandırma hesabı bulunamadı.",
-		account_deleted: "Faturalandırma hesabı silinmiş.",
-		subscription_active: "Hesabın etkin bir aboneliği var; önce aboneliği iptal edin.",
-		checkout_in_progress: "Hesapta süren bir ödeme işlemi var. Lütfen daha sonra tekrar deneyin.",
-		checkout_session_not_found: "Ödeme oturumu bulunamadı.",
-		subscription_not_found: "Abonelik bulunamadı.",
-		invoice_not_found: "Fatura bulunamadı.",
-		document_not_found: "Fatura belgesi bulunamadı.",
-		grant_not_found: "Tanımlı plan hakkı bulunamadı.",
-		event_not_found: "Kayıt bulunamadı.",
-		webhook_endpoint_not_found: "Kayıt bulunamadı.",
-		plan_not_found: "Plan bulunamadı.",
-		catalog_not_configured: "Planlar henüz tanımlanmadı. Lütfen daha sonra tekrar deneyin.",
-		already_subscribed: "Bu hesabın zaten etkin bir aboneliği var.",
-		plan_not_sellable: "Bu plan satın alınamıyor.",
-		return_url_not_allowed: TR_CONFIG,
-		provider_not_configured: "Şu anda ödeme alınamıyor. Lütfen daha sonra tekrar deneyin.",
-		provider_error: "Ödeme sağlayıcısında bir sorun oluştu. Lütfen biraz sonra tekrar deneyin.",
-		already_canceled: "Abonelik zaten iptal edilmiş.",
-		subscription_plan_higher: "Hesabın etkin aboneliği bu plandan daha yüksek bir planda.",
-		override_type_mismatch: "Hak değeri, özelliğin türüyle uyuşmuyor.",
-		invalid_window: "Bitiş tarihi başlangıçtan sonra olmalı.",
-		plan_missing_feature: "Katalogdaki bir plan, özelliklerden birine değer vermiyor.",
-		already_issued: "Bu fatura zaten kesilmiş.",
-		number_taken: "Bu fatura numarası başka bir faturada kullanılıyor.",
-		invalid_document: "Fatura belgesi geçersiz: en fazla 5 MB PDF yükleyin.",
-		billing_profile_required: "Fatura için önce hesabın fatura bilgileri girilmeli.",
-		invoice_not_voidable: "Bu fatura zaten iptal edilmiş.",
-		invoice_has_payment: "Ödemesi alınmış fatura iptal edilemez; iade süreci gerekir.",
-		internal_error: "Ödeme sisteminde beklenmeyen bir hata oluştu. Lütfen daha sonra tekrar deneyin.",
-		database_unavailable: TR_LATER,
-		unknown_provider: TR_CONFIG,
-		bad_signature: TR_CONFIG,
-		invalid_payload: TR_RETRY,
-		stale_event: TR_RETRY,
-		not_configured: "Şu anda ödeme alınamıyor. Lütfen daha sonra tekrar deneyin.",
-		unknown_subscription: "Abonelik bulunamadı.",
-		network_error: "Ödeme sistemine ulaşılamadı. Lütfen biraz sonra tekrar deneyin.",
-		timeout: "Ödeme sistemi zamanında yanıt vermedi. Lütfen biraz sonra tekrar deneyin.",
-		rate_limited: "Şu anda çok fazla istek var. Lütfen birkaç saniye sonra tekrar deneyin.",
-		invalid_response: "Ödeme sisteminden beklenmeyen bir yanıt alındı. Lütfen daha sonra tekrar deneyin.",
-		config_error: TR_CONFIG,
-		fallback: "Bir hata oluştu. Lütfen daha sonra tekrar deneyin."
-	},
-	en: {
-		unauthorized: EN_CONFIG,
-		forbidden: EN_CONFIG,
-		invalid_actor_ref: EN_RETRY,
-		actor_ref_required: EN_RETRY,
-		idempotency_key_required: EN_RETRY,
-		invalid_idempotency_key: EN_RETRY,
-		idempotency_key_reused: "This request was already sent with different details. Refresh the page and try again.",
-		request_in_progress: "The same operation is already in progress. Try again in a few seconds.",
-		invalid_json: EN_RETRY,
-		invalid_request: "Some of the details are invalid. Please check them and try again.",
-		invalid_account_ref: "The account reference is invalid.",
-		invalid_include: EN_RETRY,
-		invalid_cursor: EN_RETRY,
-		invalid_limit: EN_RETRY,
-		not_found: "Not found.",
-		account_not_found: "Billing account not found.",
-		account_deleted: "The billing account has been deleted.",
-		subscription_active: "The account has an active subscription; cancel it first.",
-		checkout_in_progress: "A payment is in progress for this account. Please try again later.",
-		checkout_session_not_found: "Checkout session not found.",
-		subscription_not_found: "Subscription not found.",
-		invoice_not_found: "Invoice not found.",
-		document_not_found: "Invoice document not found.",
-		grant_not_found: "Plan grant not found.",
-		event_not_found: "Not found.",
-		webhook_endpoint_not_found: "Not found.",
-		plan_not_found: "Plan not found.",
-		catalog_not_configured: "Plans are not set up yet. Please try again later.",
-		already_subscribed: "This account already has an active subscription.",
-		plan_not_sellable: "This plan cannot be purchased.",
-		return_url_not_allowed: EN_CONFIG,
-		provider_not_configured: "Payments are unavailable right now. Please try again later.",
-		provider_error: "The payment provider ran into a problem. Please try again shortly.",
-		already_canceled: "The subscription is already canceled.",
-		subscription_plan_higher: "The account's active subscription is on a higher plan than this one.",
-		override_type_mismatch: "The entitlement value does not match the feature type.",
-		invalid_window: "The end date must be after the start date.",
-		plan_missing_feature: "A plan in the catalog is missing a value for one of the features.",
-		already_issued: "This invoice has already been issued.",
-		number_taken: "This invoice number is already used by another invoice.",
-		invalid_document: "Invalid invoice document: upload a PDF of at most 5 MB.",
-		billing_profile_required: "Enter the account's billing details before creating an invoice.",
-		invoice_not_voidable: "This invoice is already void.",
-		invoice_has_payment: "A paid invoice cannot be voided; it requires a refund.",
-		internal_error: "Billing ran into an unexpected error. Please try again later.",
-		database_unavailable: "Billing is temporarily unavailable. Please try again shortly.",
-		unknown_provider: EN_CONFIG,
-		bad_signature: EN_CONFIG,
-		invalid_payload: EN_RETRY,
-		stale_event: EN_RETRY,
-		not_configured: "Payments are unavailable right now. Please try again later.",
-		unknown_subscription: "Subscription not found.",
-		network_error: "Could not reach billing. Please try again shortly.",
-		timeout: "Billing did not respond in time. Please try again shortly.",
-		rate_limited: "Too many requests right now. Please try again in a few seconds.",
-		invalid_response: "Billing returned an unexpected response. Please try again later.",
-		config_error: EN_CONFIG,
-		fallback: "Something went wrong. Please try again later."
-	}
-};
-/** Kullanıcıya gösterilecek metin (`tr`, `tr-TR` → tr; diğer diller → en); tanınmayan kodda genel metin. */
-function messageFor(code, locale) {
-	const messages = errorMessages[localeOf(locale)];
-	return Object.hasOwn(messages, code) ? messages[code] : messages.fallback;
-}
-//#endregion
 //#region src/catalog.ts
 const feature = (type, options) => options?.description === void 0 ? { type } : {
 	type,
@@ -714,71 +518,4 @@ function defineCatalog(definition) {
 	});
 }
 //#endregion
-//#region src/money.ts
-function assertInteger(name, value) {
-	if (!Number.isInteger(value) || value < 0) throw new RangeError(`${name} negatif olmayan tam sayı olmalı: ${value}`);
-}
-/**
-* Vergi dahil fiyatta toplam korunur, matrah kuruşa yuvarlanır ve vergi kalandır;
-* vergi hariç fiyatta vergi kuruşa yuvarlanıp üstüne eklenir.
-*/
-function taxBreakdown(price) {
-	const { amountMinor, taxRateBps } = price;
-	assertInteger("amountMinor", amountMinor);
-	assertInteger("taxRateBps", taxRateBps);
-	if (price.taxInclusive) {
-		const subtotalMinor = Math.round(amountMinor * 1e4 / (1e4 + taxRateBps));
-		return {
-			subtotalMinor,
-			taxMinor: amountMinor - subtotalMinor,
-			totalMinor: amountMinor
-		};
-	}
-	const taxMinor = Math.round(amountMinor * taxRateBps / 1e4);
-	return {
-		subtotalMinor: amountMinor,
-		taxMinor,
-		totalMinor: amountMinor + taxMinor
-	};
-}
-const TAX_LABEL = {
-	tr: {
-		inclusive: "KDV dahil",
-		exclusive: "KDV hariç"
-	},
-	en: {
-		inclusive: "VAT included",
-		exclusive: "VAT excluded"
-	}
-};
-/**
-* Tutar, para biriminin ondalık hanesiyle (TRY/USD 2, JPY 0): `₺1.250,00`
-* (tr), `₺1,250.00` (en). Sembol dar biçimde (`TRY 1,250.00` değil).
-*/
-function formatMoney(amountMinor, currency, locale) {
-	if (!Number.isInteger(amountMinor)) throw new RangeError(`amountMinor tam sayı olmalı: ${amountMinor}`);
-	const digits = new Intl.NumberFormat("en", {
-		style: "currency",
-		currency
-	}).resolvedOptions().maximumFractionDigits ?? 2;
-	return new Intl.NumberFormat(locale, {
-		style: "currency",
-		currency,
-		currencyDisplay: "narrowSymbol",
-		minimumFractionDigits: digits,
-		maximumFractionDigits: digits
-	}).format(amountMinor / 10 ** digits);
-}
-/**
-* Fiyat etiketi: `₺1.250,00 · KDV dahil` (tr), `₺1,250.00 · VAT included` (en).
-* Vergi oranı 0 ise vergi ibaresi yazılmaz. Sayı biçimi `locale`'in kendisiyle,
-* ibare `tr*` → Türkçe, diğerleri İngilizce.
-*/
-function formatPrice(price, locale) {
-	const amount = formatMoney(price.amountMinor, price.currency, locale);
-	if (price.taxRateBps === 0) return amount;
-	const labels = TAX_LABEL[localeOf(locale)];
-	return `${amount} · ${price.taxInclusive ? labels.inclusive : labels.exclusive}`;
-}
-//#endregion
-export { ACCOUNT_INCLUDES, API_VERSION, AccessStateSchema, AccountDeleteResponseSchema, AccountDetailSchema, AccountDunningStateSchema, AccountOpenCheckoutSchema, AccountProfileStateSchema, AccountScheduledChangeSchema, AccountSchema, AccountStateSchema, AccountSubscriptionStateSchema, AccountUpsertInputSchema, AccountUpsertResponseSchema, AccountsRefreshResultSchema, ActorRefSchema, AmountMinorSchema, AnyBillingEventSchema, ApiVersionSchema, BillingEventSchema, BillingProfileKindSchema, BillingProfileResponseSchema, BillingProfileSchema, BrandingPatchSchema, BrandingSchema, CHECKOUT_ERRORS, CancelSubscriptionInputSchema, CancelSubscriptionResponseSchema, CatalogSchema, CatalogSyncInputSchema, CatalogSyncResultSchema, CheckoutConsentInputSchema, CheckoutPrefillSchema, CheckoutSessionCreateInputSchema, CheckoutSessionCreatedSchema, CheckoutSessionResponseSchema, CheckoutSessionSchema, CheckoutStatusSchema, CodeSchema, ConsentSchema, CurrencySchema, DEFAULT_CHECKOUT_TTL_MINUTES, DEFAULT_ENDPOINT_EVENT_TYPES, DEFAULT_PORTAL_TTL_MINUTES, DOCTOR_PENDING_BACKLOG_MS, DOCTOR_PROVIDER_ENVIRONMENTS, DOCTOR_REQUIRED_BRANDING, DOCTOR_REQUIRED_LEGAL_LINKS, DOCTOR_SEVERITIES, DateTimeSchema, DeliverySchema, DoctorCatalogSchema, DoctorEndpointSchema, DoctorHostedSchema, DoctorProviderSchema, DoctorReportSchema, DoctorSettingsSchema, DoctorSeveritySchema, DoctorUnsellablePriceSchema, DoctorWarningSchema, ERROR_CATEGORIES, ERROR_CODES, EVENT_DETAIL_SCHEMAS, EVENT_TYPES, EntitlementSnapshotSchema, EntitlementValueSchema, EntitlementsSchema, ErrorCategorySchema, ErrorResponseSchema, EventIdSchema, EventListSchema, EventRecordSchema, EventTypeSchema, ExternalRefSchema, FeatureDefSchema, FeatureTypeSchema, GrantCreateInputSchema, GrantCreateResponseSchema, GrantSchema, HEADER_ACTOR_REF, HEADER_API_VERSION, HEADER_IDEMPOTENCY_KEY, HEADER_REQUEST_ID, HEADER_SDK, IdSchema, IntervalSchema, InvoiceIssueInputSchema, InvoiceIssueResponseSchema, InvoiceLineSchema, InvoiceSchema, InvoiceStatusSchema, InvoiceVoidInputSchema, InvoiceVoidResponseSchema, LEGACY_EVENT_TYPES, LIVE_SUBSCRIPTION_STATUSES, MANUAL_INVOICE_MAX_AMOUNT_MINOR, MAX_CHECKOUT_CONSENT_DOCS, ManualInvoiceInputSchema, ManualInvoiceLineInputSchema, ManualInvoiceResponseSchema, MetadataSchema, PING_EVENT_TYPE, PLAN_SET_MODES, PORTAL_SESSION_ERRORS, PaymentSchema, PingSchema, PlanDefSchema, PlanSetInputSchema, PlanSetModeSchema, PlanSetResponseSchema, PlanSetWarningSchema, PortalSessionCreateInputSchema, PortalSessionSchema, PriceDefSchema, PriceSchema, ProductSettingsPatchSchema, ProductSettingsSchema, ProviderPayloadSchema, ResyncResultSchema, ReturnOriginSchema, SETTINGS_LOCALES, STEWARD_ERROR_CODES, SettingsLocaleSchema, StatsSchema, StewardApiError, StewardConfigError, StewardContractError, StewardError, StewardNetworkError, SubscriptionSchema, SubscriptionStatusSchema, SubscriptionSummarySchema, TtlMinutesSchema, WEBHOOK_ENDPOINT_STATUSES, WEBHOOK_SECRET_PREFIX, WebUrlSchema, WebhookEndpointCreateInputSchema, WebhookEndpointListSchema, WebhookEndpointRotateInputSchema, WebhookEndpointSchema, WebhookEndpointStatusSchema, WebhookLastDeliverySchema, WebhookSecretSchema, applySettingsPatch, buildDoctorReport, checkoutRedirectUrl, createBillingClient, createCatalogCache, createSteward, defineCatalog, endpointDiagnosisOf, errorCodeSpec, errorMessages, flag, formatMoney, formatPrice, generateWebhookSecret, hostedReadinessOf, httpStatusFor, isE164, isEventType, isGrantActive, isKnownErrorCode, isLegacyCheckoutInput, isLiveSubscriptionStatus, isReturnUrlAllowed, isValidTckn, isValidVkn, limit, manualInvoiceTotals, messageFor, parseRetryAfter, resolveEntitlements, returnOriginsOf, splitInclusiveTax, stateCache, taxBreakdown, text, webhookEndpointUrlProblem };
+export { ACCOUNT_INCLUDES, API_VERSION, AccessStateSchema, AccountDeleteResponseSchema, AccountDetailSchema, AccountDunningStateSchema, AccountOpenCheckoutSchema, AccountProfileStateSchema, AccountScheduledChangeSchema, AccountSchema, AccountStateSchema, AccountSubscriptionStateSchema, AccountUpsertInputSchema, AccountUpsertResponseSchema, AccountsRefreshResultSchema, ActorRefSchema, AmountMinorSchema, AnyBillingEventSchema, ApiVersionSchema, BillingEventSchema, BillingProfileKindSchema, BillingProfileSchema, BrandingPatchSchema, BrandingSchema, CHECKOUT_ERRORS, CancelSubscriptionInputSchema, CancelSubscriptionResponseSchema, CatalogSchema, CatalogSyncInputSchema, CatalogSyncResultSchema, CheckoutConsentInputSchema, CheckoutPrefillSchema, CheckoutSessionCreateInputSchema, CheckoutSessionCreatedSchema, CheckoutSessionResponseSchema, CheckoutSessionSchema, CheckoutStatusSchema, CodeSchema, ConsentSchema, CurrencySchema, DEFAULT_CHECKOUT_TTL_MINUTES, DEFAULT_ENDPOINT_EVENT_TYPES, DEFAULT_PORTAL_TTL_MINUTES, DOCTOR_PENDING_BACKLOG_MS, DOCTOR_PROVIDER_ENVIRONMENTS, DOCTOR_REQUIRED_BRANDING, DOCTOR_REQUIRED_LEGAL_LINKS, DOCTOR_SEVERITIES, DateTimeSchema, DoctorCatalogSchema, DoctorEndpointSchema, DoctorHostedSchema, DoctorProviderSchema, DoctorReportSchema, DoctorSettingsSchema, DoctorSeveritySchema, DoctorUnsellablePriceSchema, DoctorWarningSchema, ERROR_CATEGORIES, ERROR_CODES, EVENT_DETAIL_SCHEMAS, EVENT_TYPES, EntitlementSnapshotSchema, EntitlementValueSchema, EntitlementsSchema, ErrorCategorySchema, ErrorResponseSchema, EventIdSchema, EventTypeSchema, ExternalRefSchema, FeatureDefSchema, FeatureTypeSchema, GrantCreateInputSchema, GrantCreateResponseSchema, GrantSchema, HEADER_ACTOR_REF, HEADER_API_VERSION, HEADER_IDEMPOTENCY_KEY, HEADER_REQUEST_ID, HEADER_SDK, IdSchema, IntervalSchema, InvoiceIssueInputSchema, InvoiceIssueResponseSchema, InvoiceLineSchema, InvoiceSchema, InvoiceStatusSchema, InvoiceVoidInputSchema, InvoiceVoidResponseSchema, LEGACY_EVENT_TYPES, LIVE_SUBSCRIPTION_STATUSES, MANUAL_INVOICE_MAX_AMOUNT_MINOR, MAX_CHECKOUT_CONSENT_DOCS, ManualInvoiceInputSchema, ManualInvoiceLineInputSchema, ManualInvoiceResponseSchema, MetadataSchema, PING_EVENT_TYPE, PLAN_SET_MODES, PORTAL_SESSION_ERRORS, PaymentSchema, PingSchema, PlanDefSchema, PlanSetInputSchema, PlanSetModeSchema, PlanSetResponseSchema, PlanSetWarningSchema, PortalSessionCreateInputSchema, PortalSessionSchema, PriceDefSchema, PriceSchema, ProductSettingsPatchSchema, ProductSettingsSchema, ProviderPayloadSchema, ResyncResultSchema, ReturnOriginSchema, SETTINGS_LOCALES, SettingsLocaleSchema, StatsSchema, StewardApiError, StewardConfigError, StewardContractError, StewardError, StewardNetworkError, SubscriptionSchema, SubscriptionStatusSchema, SubscriptionSummarySchema, TtlMinutesSchema, WEBHOOK_ENDPOINT_STATUSES, WEBHOOK_SECRET_PREFIX, WebUrlSchema, WebhookEndpointCreateInputSchema, WebhookEndpointListSchema, WebhookEndpointRotateInputSchema, WebhookEndpointSchema, WebhookEndpointStatusSchema, WebhookLastDeliverySchema, WebhookSecretSchema, applySettingsPatch, buildDoctorReport, checkoutRedirectUrl, createSteward, defineCatalog, endpointDiagnosisOf, errorCodeSpec, flag, generateWebhookSecret, hostedReadinessOf, httpStatusFor, isE164, isEventType, isGrantActive, isKnownErrorCode, isLiveSubscriptionStatus, isReturnUrlAllowed, isValidTckn, isValidVkn, limit, manualInvoiceTotals, resolveEntitlements, returnOriginsOf, splitInclusiveTax, stateCache, text, webhookEndpointUrlProblem };

package/dist/server.d.ts

@@ -1,6 +1,6 @@
-import { Qn as CheckoutPrefill, Un as PortalSession, Wn as PortalSessionCreateInput, ei as Interval, lr as CheckoutStatus, or as CheckoutSessionCreated, qt as CheckoutSessionResponse, rr as CheckoutSessionCreateInput } from "./_chunks/index.js";
+import { Fn as PortalSession, Gt as CheckoutSessionResponse, In as PortalSessionCreateInput, Qn as CheckoutSessionCreated, Wn as CheckoutPrefill, Wr as Interval, Yn as CheckoutSessionCreateInput, tr as CheckoutStatus } from "./_chunks/index.js";
 import { D as AccountInclude, F as AccountState, V as BillingProfile, a as BillingEvent, f as EventType, n as AnyBillingEvent, o as BillingEventOf } from "./_chunks/events.js";
-import { i as MutationOptions } from "./_chunks/steward.js";
+import { r as MutationOptions } from "./_chunks/steward.js";
 import { r as StewardLogger, t as StewardLocale } from "./_chunks/locale.js";
 import { a as HeaderSource, s as VerifyRawFailure } from "./_chunks/webhook-core.js";
 import "./_chunks/webhook.js";
@@ -29,9 +29,9 @@ type CheckoutOptions = {
   steward: CheckoutSteward;
   cache?: CheckoutCache;
   /**
-   * Mutlak dönüş adresi; origin'i steward ürün ayarında izinli olmalı (`appUrl` +
-   * `extraReturnOrigins`). Yer tutucular `{CHECKOUT_ID}` `{STATUS}` `{ACCOUNT_REF}` `{LOCALE}`
-   * varsa steward yalnızca onları doldurur; yoksa `?session=&status=` ekler.
+   * Absolute return URL; its origin must be allowed by the steward product settings (`appUrl` +
+   * `extraReturnOrigins`). Steward fills the placeholders `{CHECKOUT_ID}` `{STATUS}` `{ACCOUNT_REF}`
+   * `{LOCALE}` if present and never appends query parameters, so a URL without placeholders is used as-is.
    */
   successUrl: string;
   /** Sayfadaki "Vazgeç" hedefi (mutlak); verilmezse steward ayarı `appUrl`. */

package/dist/server.js

@@ -1,8 +1,19 @@
 import { O as ActorRefSchema, R as ExternalRefSchema, a as EVENT_TYPES, c as PING_EVENT_TYPE, l as PingSchema, r as BillingEventSchema, t as AnyBillingEventSchema, y as AccountStateSchema, z as IdSchema } from "./_chunks/events.js";
 import "./_chunks/src.js";
 import { n as StewardConfigError, r as StewardContractError, t as StewardApiError } from "./_chunks/errors.js";
-import { t as hostedLocaleOf } from "./_chunks/locale.js";
 import { i as verifyWebhookRaw } from "./_chunks/webhook.js";
+//#region src/locale.ts
+/**
+* Hosted page language (`Checkout`, `CustomerPortal`): the primary subtag of a BCP-47-like tag
+* (`tr`, `tr-TR`, `EN_us` → tr/en). An unsupported or empty value → `undefined`: the caller sends
+* no locale and steward uses the product setting `defaultLocale`.
+*/
+function hostedLocaleOf(locale) {
+	if (typeof locale !== "string") return void 0;
+	const primary = locale.trim().toLowerCase().split(/[-_]/)[0];
+	return primary === "tr" || primary === "en" ? primary : void 0;
+}
+//#endregion
 //#region src/server/checkout.ts
 function isAbsoluteHttpUrl(value) {
 	if (typeof value !== "string") return false;

package/dist/testing.d.ts

@@ -1,6 +1,6 @@
-import { $t as EventRecord, Cr as CatalogSyncInput, Dr as FeatureDef, Ft as ErrorCode, Gn as PortalSessionCreateInputSchema, Gt as CancelSubscriptionResponse, Pn as GrantCreateInputSchema, Qn as CheckoutPrefill, Rn as Stats, Tr as CatalogSyncResult, Un as PortalSession, Ut as BillingProfileResponse, Vt as AccountUpsertResponse, Wr as EntitlementValue, Zt as EventList, ar as CheckoutSessionCreateParsed, cn as InvoiceIssueResponse, dr as Consent, ei as Interval, gn as InvoiceIssueInputSchema, gt as PlanSetInputSchema, jn as CancelSubscriptionInputSchema, mn as Invoice, nr as CheckoutSession, nt as ProductSettingsPatch, or as CheckoutSessionCreated, pr as LegacyCheckoutSessionCreateParsed, qt as CheckoutSessionResponse, tn as GrantCreateResponse, tt as ProductSettings, wr as CatalogSyncInputSchema, wt as ResyncResult, yr as AccountsRefreshResult, yt as PlanSetResponse, zt as AccountDetail } from "./_chunks/index.js";
+import { An as Stats, Cn as CancelSubscriptionInputSchema, En as GrantCreateInputSchema, Fn as PortalSession, Ft as ErrorCode, Gt as CheckoutSessionResponse, Jn as CheckoutSession, Ln as PortalSessionCreateInputSchema, Pr as EntitlementValue, Qn as CheckoutSessionCreated, Ut as CancelSubscriptionResponse, Vt as AccountUpsertResponse, Wn as CheckoutPrefill, Wr as Interval, Zn as CheckoutSessionCreateParsed, _r as FeatureDef, cn as InvoiceIssueInputSchema, en as InvoiceIssueResponse, gt as PlanSetInputSchema, hr as CatalogSyncResult, lr as AccountsRefreshResult, mr as CatalogSyncInputSchema, nt as ProductSettingsPatch, on as Invoice, pr as CatalogSyncInput, qt as GrantCreateResponse, rr as Consent, tt as ProductSettings, wt as ResyncResult, yt as PlanSetResponse, zt as AccountDetail } from "./_chunks/index.js";
 import { B as AccountUpsertInputSchema, C as AccountDeleteResponse, D as AccountInclude, F as AccountState, V as BillingProfile, a as BillingEvent, f as EventType, o as BillingEventOf, q as SubscriptionStatus, u as EventDetail } from "./_chunks/events.js";
-import { a as Steward, c as StewardOptions } from "./_chunks/steward.js";
+import { i as Steward, s as StewardOptions } from "./_chunks/steward.js";
 import { z } from "zod";
 //#endregion
 //#region src/testing/world.d.ts
@@ -93,12 +93,11 @@ type SessionRow = {
   priceId: string;
   status: CheckoutSession["status"];
   locale: string;
-  returnUrl: string;
-  /** Hosted oturum (F2b): başarı adresi (yer tutucularıyla); eski gövdede null. */
-  successUrl: string | null;
+  /** Success URL (with placeholders, if any). */
+  successUrl: string;
   /** Hosted: "Vazgeç" hedefi; verilmediyse null (dönüş `settings.appUrl`). */
   cancelUrl: string | null;
-  /** Hosted: onaylatılacak belgeler (eski gövdede boş). */
+  /** Hosted: onaylatılacak belgeler. */
   consentDocs: {
     document: string;
     version: string;
@@ -115,8 +114,6 @@ type SessionRow = {
   expiresAt: Ms;
   createdAt: Ms;
   completedAt: Ms | null;
-  /** Sahte sağlayıcı formu; hosted oturumda sahte sayfanın `details` adımı olmadığından null. */
-  providerToken: string | null;
 };
 type PaymentRow = {
   id: string;
@@ -205,7 +202,7 @@ type World = {
   settings: ProductSettings;
   /**
    * true: dönüş origin'i ayarlanana kadar (`appUrl`/`extraReturnOrigins` boş ve yamada
-   * verilmedi) her `returnUrl` kabul — sahtenin kolaylığı; servis ayar ister.
+   * verilmedi) every return URL is accepted — a fake convenience; the service requires the setting.
    */
   permissiveReturnOrigins: boolean;
   adminEndpoints: AdminEndpointRow[];
@@ -234,7 +231,7 @@ type World = {
   id(): string;
 };
 declare namespace operations_d_exports {
-  export { Failure, PORTAL_CANCEL_REASON, PORTAL_INVOICE_LIMIT, PORTAL_RETRY_INTERVAL_MS, PortalActionResult, PortalView, Result, accountDetail, advanceTo, applyRenewalPayment, cancelCheckout, cancelSubscription, checkoutSessionResponse, completeCheckout, createCheckoutSession, createGrant, createHostedCheckoutSession, createPortalSession, customerActorRef, deleteAccount, failCheckout, hostedPageUrl, hostedPortalUrl, issueInvoice, listEvents, livePortalSession, openHostedSession, openPortalSession, portalCancel, portalInvoiceDocument, portalRetryPayment, portalView, putBillingProfile, redeliverEvent, refreshAccounts, resyncAccount, revokeGrant, sessionRow, setPlan, stats, syncCatalog, updatePortalProfile, upsertAccount, validatePortalProfile };
+  export { Failure, PORTAL_CANCEL_REASON, PORTAL_INVOICE_LIMIT, PORTAL_RETRY_INTERVAL_MS, PortalActionResult, PortalView, Result, accountDetail, advanceTo, applyRenewalPayment, cancelCheckout, cancelSubscription, checkoutSessionResponse, completeCheckout, createCheckoutSession, createGrant, createPortalSession, customerActorRef, deleteAccount, failCheckout, hostedPageUrl, hostedPortalUrl, issueInvoice, livePortalSession, openHostedSession, openPortalSession, portalCancel, portalInvoiceDocument, portalRetryPayment, portalView, redeliverEvent, refreshAccounts, resyncAccount, revokeGrant, sessionRow, setPlan, stats, syncCatalog, updatePortalProfile, upsertAccount, validatePortalProfile };
 }
 type Failure = {
   ok: false;
@@ -247,9 +244,7 @@ type Result<T> = {
 } | Failure;
 type CatalogInput = z.output<typeof CatalogSyncInputSchema>;
 type UpsertInput = z.output<typeof AccountUpsertInputSchema>;
-/** Eski gövde (K16); hosted gövde `HostedCheckoutInput` (http.ts `isLegacyCheckoutInput` ile ayırır). */
-type CheckoutInput = LegacyCheckoutSessionCreateParsed;
-type HostedCheckoutInput = CheckoutSessionCreateParsed;
+type CheckoutInput = CheckoutSessionCreateParsed;
 type CancelInput = z.output<typeof CancelSubscriptionInputSchema>;
 type GrantInput = z.output<typeof GrantCreateInputSchema>;
 type IssueInput = z.output<typeof InvoiceIssueInputSchema>;
@@ -262,17 +257,15 @@ declare function upsertAccount(w: World, ref: string, input: UpsertInput): {
   account: AccountUpsertResponse;
   created: boolean;
 };
-declare function putBillingProfile(w: World, ref: string, profile: BillingProfile): Result<BillingProfileResponse>;
 declare function accountDetail(w: World, ref: string, include: readonly AccountInclude[]): AccountDetail | null;
 /** Hosted checkout sayfası (servisin `hostedCheckoutUrl`); sahtede `hosted.ts` sunar. */
 declare const hostedPageUrl: (baseUrl: string, id: string, pageKey: string) => string;
-declare function createCheckoutSession(w: World, baseUrl: string, ref: string, input: CheckoutInput, actorRef: string): Result<CheckoutSessionCreated>;
 /**
- * `createHostedCheckoutSession` (hosted gövde, F2b): sağlayıcıya gidilmez; doğrulama sırası ve
- * kodları servisle aynı (hesap, dönüş origin'leri, canlı abonelik, satılabilir fiyat). Hesap
- * yoksa `displayName` ile açılır. `url` sahte steward'ın hosted sayfasıdır (`hosted.ts`).
+ * `createHostedCheckoutSession` (service): no provider call; validation order and codes match the
+ * service (account, return origins, live subscription, sellable price). A missing account is
+ * opened with `displayName`. `url` is the fake steward's hosted page (`hosted.ts`).
  */
-declare function createHostedCheckoutSession(w: World, baseUrl: string, ref: string, input: HostedCheckoutInput, actorRef: string): Result<CheckoutSessionCreated>;
+declare function createCheckoutSession(w: World, baseUrl: string, ref: string, input: CheckoutInput, actorRef: string): Result<CheckoutSessionCreated>;
 declare function checkoutSessionResponse(w: World, id: string): CheckoutSessionResponse | null;
 declare function sessionRow(w: World, id: string): SessionRow;
 /** Hosted oturumun sayfası açık mı: anahtar bu oturumun, oturum açık ve süresi geçmemiş (servis `openSession`). */
@@ -304,8 +297,9 @@ declare function setPlan(w: World, ref: string, input: PlanSetInput, actorRef: s
 declare function resyncAccount(w: World, ref: string): Result<ResyncResult>;
 /**
  * `deleteAccount` (`domain/account-deletion.ts`, F4e): önkoşullar sırayla (hesap yok 404,
- * silinmiş 410, canlı abonelik, formu açık checkout — sahte steward'da yalnızca eski
- * gövdeli oturumun formu vardır) ve hiçbiri tutmazsa değişiklik yok. Sonra anonimleştirme:
+ * silinmiş 410, canlı abonelik) ve hiçbiri tutmazsa değişiklik yok. The service's
+ * `checkout_in_progress` (open provider form) never happens here: the fake hosted page has no
+ * provider form, so open sessions are formless and deletion closes them. Sonra anonimleştirme:
  * ad/metadata/profil, oturumların ön doldurması/anahtarı ve onay izinin `ipHash`/`userAgent`'ı,
  * portal oturumları, aktif grant'ler; eski event yüklerinde `displayName`. Faturalar kalır.
  */
@@ -395,12 +389,8 @@ declare function portalInvoiceDocument(w: World, session: PortalSessionRow, invo
   bytes: Uint8Array;
   filename: string;
 } | null;
-declare function listEvents(w: World, query: {
-  accountRef?: string;
-  cursor?: string;
-  limit: number;
-}): Result<EventList>;
-declare function redeliverEvent(w: World, id: string): EventRecord | null;
+/** Requeues the event's delivery (dead or delivered included); `false` if there is no such event. */
+declare function redeliverEvent(w: World, id: string): boolean;
 /**
  * Tahsilat sonucu. Dunning'deki abonelikte AYNI başarısız siparişin yeniden
  * denemesidir (iyzico retry'ı; servisin `existingPayment` yolu), aksi halde
@@ -445,12 +435,13 @@ type FakeStewardOptions = {
   /**
    * Başlangıç ürün ayarları (`PATCH /v1/admin/settings` yamasıyla aynı biçim). Sağlayıcı
    * her zaman sahte (`provider: "fake"`). Dönüş origin'i (`appUrl`, `extraReturnOrigins`,
-   * `returnOrigins`) hiç verilmez ve yamalanmazsa her `returnUrl` kabul edilir.
+   * `returnOrigins`) is never given or patched, every return URL (`successUrl`, `cancelUrl`,
+   * portal `returnUrl`) is accepted.
    */
   settings?: ProductSettingsPatch;
-  /** Checkout `returnUrl` origin listesi = `settings.extraReturnOrigins` (ikisi birlikte verilemez). */
+  /** Allowed return origins for checkout and portal = `settings.extraReturnOrigins` (cannot be given together). */
   returnOrigins?: readonly string[];
-  /** = `settings.checkoutTtlMinutes`; varsayılan 30 (sahte sağlayıcının formu da 30 dk). */
+  /** = `settings.checkoutTtlMinutes`; default 30. */
   checkoutTtlMinutes?: number;
   /** Varsayılan servisinki: `dryRun: true` (adımlar sayılır, askı/sonlandırma yok). */
   dunningPolicy?: FakeDunningPolicy;
@@ -574,6 +565,12 @@ type FakeSimulate = {
   deliver(type: EventType, options: FakeDeliverOptions): Promise<FakeDelivery[]>;
   /** Bekleyen (teslim edilmemiş) outbox event'lerini sırayla alıcıya gönderir. */
   flush(): Promise<FakeDelivery[]>;
+  /**
+   * Operator redelivery (the service's pod CLI `redeliver-event <product> <eventId>`): the event's
+   * delivery is requeued with attempts reset, the next `flush()` sends the same id and body again.
+   * Throws for an unknown event id. There is no product HTTP API for this.
+   */
+  redeliver(eventId: string): void;
 };
 type FakeSteward = {
   readonly baseUrl: string;
@@ -589,7 +586,7 @@ type FakeSteward = {
    * `webhook` seçeneği (sır, filtre) verilmemişse fırlatır.
    */
   connect(handler: FakeWebhookHandler): void;
-  /** Yayınlanan event'ler, yayın sırasıyla (`GET /v1/events`'in içeriği; eski tiplerde de tam durum). */
+  /** Published events in publish order (the outbox; legacy types carry the full state too). */
   events(ref?: string): readonly BillingEvent[];
   /** Sahte saat. */
   now(): Date;