@stewardhq/sdk 0.1.0-rc.0

package/dist/index.js

@@ -0,0 +1,784 @@
+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 { 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 { 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;
+function fieldsOf$1(error) {
+	const { code, httpStatus, requestId } = typeof error === "object" && error !== null ? error : {};
+	return {
+		code: typeof code === "string" ? code : null,
+		httpStatus: typeof httpStatus === "number" ? httpStatus : null,
+		requestId: typeof requestId === "string" ? requestId : null
+	};
+}
+function isOutage({ code, httpStatus }) {
+	if (httpStatus === 0) return code === "network_error" || code === "timeout";
+	return httpStatus !== null && (httpStatus >= 500 || httpStatus === 429);
+}
+const isNotFound = ({ code, httpStatus }) => httpStatus === 404 && code === "account_not_found";
+function stateCache(steward, options = {}) {
+	const ttlMs = options.ttlMs ?? 3e4;
+	const staleIfErrorMs = options.staleIfErrorMs ?? 6e5;
+	const maxEntries = options.maxEntries ?? 1e4;
+	const problems = [];
+	if (!(Number.isFinite(ttlMs) && ttlMs >= 0)) problems.push(`ttlMs negatif olmayan sayı olmalı: ${ttlMs}`);
+	if (!(Number.isFinite(staleIfErrorMs) && staleIfErrorMs >= 0)) problems.push(`staleIfErrorMs negatif olmayan sayı olmalı: ${staleIfErrorMs}`);
+	if (!(Number.isInteger(maxEntries) && maxEntries >= 1)) problems.push(`maxEntries pozitif tam sayı olmalı: ${maxEntries}`);
+	const missing = options.missing ?? "throw";
+	if (missing !== "throw" && missing !== "fallback") problems.push(`missing "throw" ya da "fallback" olmalı: ${String(missing)}`);
+	else if (missing === "fallback" && typeof options.fallback !== "function") problems.push("missing: \"fallback\" için fallback gerekli");
+	if (problems.length > 0) throw new StewardConfigError({ message: `stateCache: ${problems.join("; ")}` });
+	const { catalog, fallback, onFallback } = options;
+	const logger = options.logger ?? console;
+	const now = options.now ?? Date.now;
+	const backoffMs = Math.min(ttlMs, FAILURE_BACKOFF_MS);
+	const entries = /* @__PURE__ */ new Map();
+	const flights = /* @__PURE__ */ new Map();
+	let seq = 0;
+	function touch(ref) {
+		const entry = entries.get(ref);
+		if (entry) {
+			entries.delete(ref);
+			entries.set(ref, entry);
+		}
+		return entry;
+	}
+	function put(ref, entry) {
+		entries.delete(ref);
+		entries.set(ref, entry);
+		for (const oldest of entries.keys()) {
+			if (entries.size <= maxEntries) break;
+			entries.delete(oldest);
+		}
+	}
+	function confirmed(state, etag, at, expired = false) {
+		return {
+			state,
+			etag,
+			fetchedAt: at,
+			expiresAt: expired ? Number.NEGATIVE_INFINITY : at + ttlMs,
+			seq: ++seq,
+			failure: null
+		};
+	}
+	/** Kesintide: bayat değer → fallback → asıl hata. WARN her başarısız istekte ve bayattan fallback'e geçişte bir kez. */
+	async function degrade(ref, failure) {
+		const { error } = failure;
+		const { code, requestId } = fieldsOf$1(error);
+		const entry = entries.get(ref);
+		const t = now();
+		if (entry?.state && t < entry.fetchedAt + ttlMs + staleIfErrorMs) {
+			if (failure.warned !== "stale") logger.warn("steward hesap durumu okunamadı; bayat değer kullanılıyor", {
+				ref,
+				code,
+				requestId,
+				ageMs: t - entry.fetchedAt
+			});
+			failure.warned = "stale";
+			return entry.state;
+		}
+		if (fallback) {
+			let value;
+			try {
+				value = await fallback(ref);
+			} catch (fallbackError) {
+				logger.warn("stateCache fallback fırlattı; steward hatası iletiliyor", {
+					ref,
+					code,
+					error: String(fallbackError)
+				});
+				throw error;
+			}
+			if (value) {
+				if (failure.warned !== "fallback") logger.warn("steward hesap durumu okunamadı, bayat değer yok; fallback kullanılıyor", {
+					ref,
+					code,
+					requestId
+				});
+				failure.warned = "fallback";
+				try {
+					onFallback?.({
+						ref,
+						reason: code ?? "unknown"
+					});
+				} catch (hookError) {
+					logger.warn("stateCache onFallback fırlattı", {
+						ref,
+						error: String(hookError)
+					});
+				}
+				return value;
+			}
+		}
+		throw error;
+	}
+	/** `missing: "fallback"` ile bilinmeyen hesap: bayat değer yok, WARN yok; fallback fırlatır ya da `null` dönerse 404. */
+	async function missingFallback(ref, failure) {
+		let value;
+		try {
+			value = await fallback(ref);
+		} catch (fallbackError) {
+			logger.warn("stateCache fallback fırlattı; steward hatası iletiliyor", {
+				ref,
+				code: "account_not_found",
+				error: String(fallbackError)
+			});
+			throw failure.error;
+		}
+		if (!value) throw failure.error;
+		try {
+			onFallback?.({
+				ref,
+				reason: "account_not_found"
+			});
+		} catch (hookError) {
+			logger.warn("stateCache onFallback fırlattı", {
+				ref,
+				error: String(hookError)
+			});
+		}
+		return value;
+	}
+	async function load(ref, started, flight) {
+		const known = entries.get(ref);
+		let read;
+		try {
+			read = await steward.accounts.readState(ref, known?.state && known.etag !== null ? { etag: known.etag } : {});
+		} catch (error) {
+			const fields = fieldsOf$1(error);
+			if (isNotFound(fields)) {
+				if (missing === "throw") {
+					entries.delete(ref);
+					throw error;
+				}
+				const failure = {
+					error,
+					until: now() + backoffMs,
+					warned: null,
+					missing: true
+				};
+				put(ref, {
+					state: null,
+					etag: null,
+					fetchedAt: Number.NEGATIVE_INFINITY,
+					expiresAt: Number.NEGATIVE_INFINITY,
+					seq: ++seq,
+					failure
+				});
+				return missingFallback(ref, failure);
+			}
+			if (!isOutage(fields)) throw error;
+			const current = entries.get(ref);
+			const failure = {
+				error,
+				until: now() + backoffMs,
+				warned: null
+			};
+			if (current) current.failure = failure;
+			else put(ref, {
+				state: null,
+				etag: null,
+				fetchedAt: Number.NEGATIVE_INFINITY,
+				expiresAt: Number.NEGATIVE_INFINITY,
+				seq: ++seq,
+				failure
+			});
+			return degrade(ref, failure);
+		}
+		let state;
+		if (!read.notModified) state = read.state;
+		else if (known?.state) state = known.state;
+		else throw new StewardContractError({ httpStatus: 304 });
+		const current = entries.get(ref);
+		if (current?.state && current.seq > started && current.state.version >= state.version) return current.state;
+		put(ref, confirmed(state, read.etag, now(), flight.invalidated));
+		return state;
+	}
+	function join(ref) {
+		const running = flights.get(ref);
+		if (running) return running.promise;
+		const control = { invalidated: false };
+		const promise = load(ref, seq, control).finally(() => {
+			if (flights.get(ref)?.promise === promise) flights.delete(ref);
+		});
+		flights.set(ref, Object.assign(control, { promise }));
+		return promise;
+	}
+	async function state(ref, opts = {}) {
+		const entry = touch(ref);
+		if (entry && !opts.fresh) {
+			const t = now();
+			if (entry.state && t < entry.expiresAt) return entry.state;
+			if (entry.failure && t < entry.failure.until) return entry.failure.missing ? missingFallback(ref, entry.failure) : degrade(ref, entry.failure);
+		}
+		return join(ref);
+	}
+	return {
+		state,
+		async entitlements(ref, opts) {
+			const current = await state(ref, opts);
+			if (!catalog) return current.entitlements;
+			return catalog.resolve(current, { onFallback: (keys) => logger.warn("steward durumu katalogdaki anahtarları taşımıyor; plan değerleri kullanıldı", {
+				ref,
+				keys
+			}) });
+		},
+		async many(refs) {
+			const unique = [...new Set(refs)];
+			const results = /* @__PURE__ */ new Map();
+			const errors = [];
+			let next = 0;
+			const worker = async () => {
+				while (errors.length === 0 && next < unique.length) {
+					const ref = unique[next++];
+					try {
+						results.set(ref, await state(ref));
+					} catch (error) {
+						errors.push(error);
+					}
+				}
+			};
+			await Promise.all(Array.from({ length: Math.min(MANY_CONCURRENCY, unique.length) }, worker));
+			if (errors.length > 0) throw errors[0];
+			return new Map(unique.map((ref) => [ref, results.get(ref)]));
+		},
+		invalidate(ref) {
+			const flight = flights.get(ref);
+			if (flight) {
+				flight.invalidated = true;
+				flights.delete(ref);
+			}
+			const entry = entries.get(ref);
+			if (entry) Object.assign(entry, {
+				expiresAt: Number.NEGATIVE_INFINITY,
+				failure: null
+			});
+		},
+		prime(account) {
+			if (!account) return;
+			const current = entries.get(account.ref);
+			if (current?.state && account.version < current.state.version) return;
+			const etag = current?.state?.version === account.version ? current.etag : null;
+			put(account.ref, confirmed(account, etag, now()));
+		}
+	};
+}
+//#endregion
+//#region src/http-status.ts
+const STATUS = {
+	already_subscribed: 409,
+	plan_not_sellable: 422,
+	account_not_found: 404,
+	provider_error: 502,
+	provider_not_configured: 503,
+	timeout: 503,
+	network_error: 503,
+	rate_limited: 503,
+	return_url_not_allowed: 500
+};
+const BY_CATEGORY = {
+	not_found: 404,
+	conflict: 409,
+	provider: 502,
+	unavailable: 503
+};
+const isCategory = (value) => typeof value === "string" && ERROR_CATEGORIES.includes(value);
+function fieldsOf(err) {
+	if (typeof err !== "object" || err === null) return null;
+	const { code, category, retryable, requestId, retryAfterMs } = err;
+	if (typeof code !== "string") return null;
+	const spec = errorCodeSpec(code);
+	const resolvedCategory = isCategory(category) ? category : spec?.category;
+	const resolvedRetryable = typeof retryable === "boolean" ? retryable : spec?.retryable;
+	return {
+		code,
+		...resolvedCategory !== void 0 ? { category: resolvedCategory } : {},
+		...resolvedRetryable !== void 0 ? { retryable: resolvedRetryable } : {},
+		...typeof requestId === "string" ? { requestId } : {},
+		...typeof retryAfterMs === "number" && Number.isFinite(retryAfterMs) && retryAfterMs >= 0 ? { retryAfterMs } : {}
+	};
+}
+const retryAfter = (fields) => fields.retryAfterMs === void 0 ? {} : { "Retry-After": String(Math.max(1, Math.ceil(fields.retryAfterMs / 1e3))) };
+function httpStatusFor(err, options = {}) {
+	const logger = options.logger ?? console;
+	const fields = fieldsOf(err);
+	if (!fields) return {
+		status: 500,
+		headers: {}
+	};
+	const context = {
+		code: fields.code,
+		requestId: fields.requestId ?? null
+	};
+	if (Object.hasOwn(STATUS, fields.code)) {
+		const status = STATUS[fields.code];
+		switch (fields.code) {
+			case "rate_limited":
+				logger.warn("steward rate_limited: ürünün steward bütçesi aşıldı", {
+					...context,
+					retryAfterMs: fields.retryAfterMs ?? null
+				});
+				return {
+					status,
+					headers: retryAfter(fields)
+				};
+			case "return_url_not_allowed":
+				logger.error("ALARM steward return_url_not_allowed: steward ürün ayarlarında uygulamanın origin'i yok", context);
+				return {
+					status,
+					headers: {}
+				};
+			default: return {
+				status,
+				headers: {}
+			};
+		}
+	}
+	const byCategory = fields.category === void 0 ? void 0 : BY_CATEGORY[fields.category];
+	if (byCategory !== void 0) return {
+		status: byCategory,
+		headers: byCategory === 503 ? retryAfter(fields) : {}
+	};
+	if (fields.category === void 0 && fields.retryable === true) return {
+		status: 503,
+		headers: retryAfter(fields)
+	};
+	logger.error(`steward hatası eşlenmedi (${fields.code}) → 500`, {
+		...context,
+		category: fields.category ?? null
+	});
+	return {
+		status: 500,
+		headers: {}
+	};
+}
+//#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,
+	description: options.description
+};
+/** Sayısal limit: negatif olmayan tam sayı ya da `null` (sınırsız). */
+const limit = (options) => feature("limit", options);
+/** Açık/kapalı özellik. */
+const flag = (options) => feature("boolean", options);
+/** Serbest metin ayarı. */
+const text = (options) => feature("string", options);
+function matches(type, value) {
+	switch (type) {
+		case "limit": return value === null || typeof value === "number" && Number.isInteger(value) && value >= 0;
+		case "boolean": return typeof value === "boolean";
+		case "string": return typeof value === "string";
+	}
+}
+const EXPECTED = {
+	limit: "negatif olmayan tam sayı ya da null",
+	boolean: "boolean",
+	string: "string"
+};
+const show = (value) => value === void 0 ? "yok" : JSON.stringify(value);
+const has = (object, key) => Object.hasOwn(object, key);
+const isObject = (value) => typeof value === "object" && value !== null;
+function invalid(problems) {
+	return new StewardConfigError({
+		code: "invalid_catalog",
+		message: `defineCatalog: katalog geçersiz\n${problems.map((p) => `  - ${p}`).join("\n")}`
+	});
+}
+function defineCatalog(definition) {
+	const problems = [];
+	const input = definition;
+	const features = /* @__PURE__ */ new Map();
+	for (const [key, spec] of Object.entries(isObject(input.features) ? input.features : {})) if (isObject(spec) && typeof spec.type === "string" && has(EXPECTED, spec.type)) {
+		const type = spec.type;
+		features.set(key, typeof spec.description === "string" ? {
+			type,
+			description: spec.description
+		} : { type });
+	} else problems.push(`features.${key}: limit() / flag() / text() bekleniyor`);
+	if (!isObject(input.features)) problems.push("features: nesne bekleniyor");
+	if (!isObject(input.plans)) problems.push("plans: nesne bekleniyor");
+	if (!Array.isArray(input.prices)) problems.push("prices: dizi bekleniyor");
+	if (problems.length > 0) throw invalid(problems);
+	const plans = /* @__PURE__ */ new Map();
+	for (const [code, plan] of Object.entries(input.plans)) {
+		const given = isObject(plan) && isObject(plan.entitlements) ? plan.entitlements : {};
+		const entitlements = {};
+		for (const [key, { type }] of features) {
+			if (!has(given, key)) problems.push(`plans.${code}.entitlements.${key}: eksik (${EXPECTED[type]} bekleniyor)`);
+			else if (!matches(type, given[key])) problems.push(`plans.${code}.entitlements.${key}: ${EXPECTED[type]} bekleniyor, ${show(given[key])} geldi`);
+			entitlements[key] = given[key];
+		}
+		for (const key of Object.keys(given).filter((k) => !features.has(k))) problems.push(`plans.${code}.entitlements.${key}: tanımsız feature`);
+		const { name, rank, sellable } = isObject(plan) ? plan : {};
+		plans.set(code, {
+			name,
+			rank,
+			sellable,
+			entitlements
+		});
+	}
+	if (typeof input.defaultPlan !== "string" || !plans.has(input.defaultPlan)) problems.push(`defaultPlan: ${show(input.defaultPlan)} planlarda yok`);
+	const prices = input.prices.map((price, i) => {
+		const copy = { ...isObject(price) ? price : {} };
+		if (typeof copy.plan !== "string" || !plans.has(copy.plan)) problems.push(`prices.${i}.plan: ${show(copy.plan)} planlarda yok`);
+		return copy;
+	});
+	if (problems.length > 0) throw invalid(problems);
+	const toSyncInput = () => ({
+		defaultPlanCode: input.defaultPlan,
+		features: [...features].map(([key, spec]) => ({
+			key,
+			...spec
+		})),
+		plans: [...plans].map(([code, plan]) => ({
+			code,
+			...plan,
+			entitlements: { ...plan.entitlements }
+		})),
+		prices: prices.map(({ plan, ...rest }) => ({
+			planCode: plan,
+			...rest
+		}))
+	});
+	const parsed = CatalogSyncInputSchema.safeParse(toSyncInput());
+	if (!parsed.success) {
+		const codes = {
+			features: [...features.keys()],
+			plans: [...plans.keys()]
+		};
+		throw invalid(parsed.error.issues.map((issue) => {
+			const [head, index, ...rest] = issue.path;
+			return `${((head === "plans" || head === "features") && typeof index === "number" ? [
+				head,
+				codes[head][index],
+				...rest
+			] : issue.path).map(String).join(".") || "(kök)"}: ${issue.message}`;
+		}));
+	}
+	const defaultPlan = input.defaultPlan;
+	const isPlan = (code) => typeof code === "string" && plans.has(code);
+	const planEntitlements = (code) => plans.get(code).entitlements;
+	const entitlementsOf = (plan) => {
+		if (!isPlan(plan)) throw new StewardConfigError({
+			code: "unknown_plan",
+			message: `katalogda plan yok: ${show(plan)}`
+		});
+		return { ...planEntitlements(plan) };
+	};
+	const resolve = (state, options = {}) => {
+		const fallback = planEntitlements(isPlan(state?.planCode) ? state.planCode : defaultPlan);
+		if (!state) return { ...fallback };
+		const given = isObject(state.entitlements) ? state.entitlements : {};
+		const result = {};
+		const fellBack = [];
+		for (const [key, { type }] of features) if (has(given, key) && matches(type, given[key])) result[key] = given[key];
+		else {
+			result[key] = fallback[key];
+			fellBack.push(key);
+		}
+		if (fellBack.length > 0) options.onFallback?.(fellBack);
+		return result;
+	};
+	const stateOf = (ref, plan = defaultPlan, options = {}) => ({
+		ref,
+		displayName: options.displayName ?? ref,
+		version: 0,
+		updatedAt: (/* @__PURE__ */ new Date(0)).toISOString(),
+		catalogVersion: null,
+		planCode: plan,
+		accessState: options.accessState ?? "active",
+		entitlements: entitlementsOf(plan),
+		subscription: null,
+		openCheckout: null,
+		profile: {
+			present: false,
+			kind: null
+		}
+	});
+	const frozen = (value) => Object.freeze(value);
+	return frozen({
+		defaultPlan,
+		features: frozen(Object.fromEntries([...features].map(([key, spec]) => [key, frozen({ ...spec })]))),
+		plans: frozen(Object.fromEntries([...plans].map(([code, plan]) => [code, frozen({
+			...plan,
+			entitlements: frozen({ ...plan.entitlements })
+		})]))),
+		prices: frozen(prices.map((price) => frozen({ ...price }))),
+		$plan: void 0,
+		$entitlements: void 0,
+		toSyncInput,
+		entitlementsOf,
+		resolve,
+		isPlan,
+		stateOf
+	});
+}
+//#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 };