@stewardhq/sdk 0.1.0-rc.0

package/dist/_chunks/src.js

@@ -0,0 +1,1202 @@
+import { A as CodeSchema, B as IntervalSchema, C as BillingProfileSchema, F as EntitlementsSchema, M as DateTimeSchema, O as ActorRefSchema, R as ExternalRefSchema, S as BillingProfileKindSchema, T as SubscriptionStatusSchema, a as EVENT_TYPES, j as CurrencySchema, k as AmountMinorSchema, o as EventIdSchema, r as BillingEventSchema, v as AccountSchema, y as AccountStateSchema, z as IdSchema } from "./events.js";
+import { z } from "zod";
+//#region ../contract/src/catalog.ts
+const FeatureTypeSchema = z.enum([
+	"limit",
+	"boolean",
+	"string"
+]);
+const FeatureDefSchema = z.object({
+	key: CodeSchema,
+	type: FeatureTypeSchema,
+	description: z.string().max(500).optional()
+});
+const PlanDefSchema = z.object({
+	code: CodeSchema,
+	name: z.string().min(1).max(200),
+	/** Yükseltme/düşürme sırası: büyük olan üst plan. */
+	rank: z.number().int().nonnegative(),
+	/** Self-servis satın alınabilir mi (false: yalnızca grant ile verilir). */
+	sellable: z.boolean(),
+	entitlements: EntitlementsSchema
+});
+const PriceDefSchema = z.object({
+	planCode: CodeSchema,
+	interval: IntervalSchema,
+	intervalCount: z.number().int().positive().default(1),
+	currency: CurrencySchema,
+	amountMinor: AmountMinorSchema,
+	/** Tutar vergi dahil mi (faturada vergi bu tutardan ayrıştırılır). */
+	taxInclusive: z.boolean(),
+	/** Baz puan: %20 = 2000. */
+	taxRateBps: z.number().int().min(0).max(1e4)
+});
+const CatalogSyncInputSchema = z.object({
+	defaultPlanCode: CodeSchema,
+	features: z.array(FeatureDefSchema),
+	plans: z.array(PlanDefSchema).min(1),
+	prices: z.array(PriceDefSchema)
+}).superRefine((c, ctx) => {
+	const features = new Set(c.features.map((f) => f.key));
+	const plans = new Set(c.plans.map((p) => p.code));
+	if (features.size !== c.features.length) ctx.addIssue({
+		code: "custom",
+		message: "tekrarlanan feature"
+	});
+	if (plans.size !== c.plans.length) ctx.addIssue({
+		code: "custom",
+		message: "tekrarlanan plan"
+	});
+	if (!plans.has(c.defaultPlanCode)) ctx.addIssue({
+		code: "custom",
+		path: ["defaultPlanCode"],
+		message: "varsayılan plan katalogda yok"
+	});
+	for (const [i, p] of c.plans.entries()) for (const key of Object.keys(p.entitlements)) if (!features.has(key)) ctx.addIssue({
+		code: "custom",
+		path: [
+			"plans",
+			i,
+			"entitlements",
+			key
+		],
+		message: "tanımsız feature"
+	});
+	const seen = /* @__PURE__ */ new Set();
+	for (const [i, p] of c.prices.entries()) {
+		if (!plans.has(p.planCode)) ctx.addIssue({
+			code: "custom",
+			path: [
+				"prices",
+				i,
+				"planCode"
+			],
+			message: "tanımsız plan"
+		});
+		const key = `${p.planCode}/${p.interval}/${p.intervalCount}/${p.currency}`;
+		if (seen.has(key)) ctx.addIssue({
+			code: "custom",
+			path: ["prices", i],
+			message: `aynı fiyat anahtarı iki kez: ${key}`
+		});
+		seen.add(key);
+	}
+});
+const PriceSchema = PriceDefSchema.extend({
+	id: IdSchema,
+	active: z.boolean(),
+	createdAt: DateTimeSchema
+});
+const CatalogSchema = z.object({
+	product: CodeSchema,
+	defaultPlanCode: CodeSchema,
+	features: z.array(FeatureDefSchema),
+	plans: z.array(PlanDefSchema),
+	/** Varsayılan olarak yalnızca aktif fiyatlar. */
+	prices: z.array(PriceSchema)
+});
+const CatalogSyncResultSchema = z.object({
+	/** Aynı girdiyle tekrar senkron: hiçbir şey değişmedi. */
+	unchanged: z.boolean(),
+	createdPrices: z.array(IdSchema),
+	deactivatedPrices: z.array(IdSchema),
+	/** Yeni, yeniden aktifleşen ya da adı/sırası/satılabilirliği/hakları değişen planlar. */
+	changedPlans: z.array(CodeSchema),
+	/** Katalogdan çıkarılıp pasifleşen planlar. */
+	retiredPlans: z.array(CodeSchema),
+	removedFeatures: z.array(CodeSchema),
+	defaultPlanChanged: z.boolean(),
+	/** Sağlayıcıda karşılığı oluşturulamayan fiyatlar (tekrar senkronla düzelir). */
+	providerErrors: z.array(z.object({
+		priceId: IdSchema,
+		provider: z.string(),
+		code: z.string()
+	}))
+});
+/** `POST /v1/admin/accounts/refresh` — ürünün tüm hesaplarının snapshot'ı yeniden hesaplanır. */
+const AccountsRefreshResultSchema = z.object({ 
+/** Snapshot'ı değişen (version'ı artıp `account.updated` yayınlayan) hesap sayısı. */
+changed: z.number().int().nonnegative() });
+//#endregion
+//#region ../contract/src/settings.ts
+const LOOPBACK_HOSTS$1 = /* @__PURE__ */ new Set([
+	"localhost",
+	"127.0.0.1",
+	"[::1]"
+]);
+const MAX_URL_LENGTH = 2e3;
+function parseUrl(value) {
+	try {
+		return new URL(value);
+	} catch {
+		return null;
+	}
+}
+/** Kimlik bilgisi taşımayan http(s) adresi. */
+const HttpUrlSchema = z.url({ protocol: /^https?$/ }).max(MAX_URL_LENGTH).refine((value) => {
+	const url = parseUrl(value);
+	return url !== null && url.username === "" && url.password === "";
+}, "adreste kullanıcı bilgisi olamaz");
+/** https; http yalnızca localhost / 127.0.0.1 / [::1]. */
+const WebUrlSchema = HttpUrlSchema.refine((value) => {
+	const url = parseUrl(value);
+	return url !== null && (url.protocol === "https:" || LOOPBACK_HOSTS$1.has(url.hostname));
+}, "https olmalı (http yalnızca localhost)");
+/** http(s) adresinin origin'i (ör. `https://app.example.com`). */
+const ReturnOriginSchema = HttpUrlSchema.transform((value) => new URL(value).origin);
+const ReturnOriginsSchema = z.array(ReturnOriginSchema).max(20).transform((origins) => [...new Set(origins)]);
+const SETTINGS_LOCALES = ["tr", "en"];
+const SettingsLocaleSchema = z.enum(SETTINGS_LOCALES);
+const TtlMinutesSchema = z.number().int().min(5).max(1440);
+const DEFAULT_CHECKOUT_TTL_MINUTES = 30;
+const DEFAULT_PORTAL_TTL_MINUTES = 30;
+const BrandingNameSchema = z.string().trim().min(1).max(100);
+const LogoUrlSchema = z.url({ protocol: /^https$/ }).max(MAX_URL_LENGTH);
+const AccentColorSchema = z.string().regex(/^#[0-9a-fA-F]{6}$/, "#rrggbb").transform((value) => value.toLowerCase());
+const SupportEmailSchema = z.email().max(254);
+const BrandingSchema = z.object({
+	/** Hosted sayfada görünen ürün adı. */
+	name: BrandingNameSchema.optional(),
+	/** Yalnızca https (hosted sayfanın CSP'si logonun origin'ine izin verir). */
+	logoUrl: LogoUrlSchema.optional(),
+	/** `#rrggbb` (küçük harfe indirgenir). */
+	accentColor: AccentColorSchema.optional(),
+	supportEmail: SupportEmailSchema.optional()
+});
+const ProductSettingsSchema = z.object({
+	/** Checkout'ları alan ödeme sağlayıcısı. Operatör ayarıdır (pod CLI); yönetim ucundan yazılmaz. */
+	provider: z.string().min(1).default("iyzico"),
+	appUrl: WebUrlSchema.optional(),
+	defaultCurrency: CurrencySchema.default("TRY"),
+	defaultLocale: SettingsLocaleSchema.default("tr"),
+	extraReturnOrigins: ReturnOriginsSchema.default([]),
+	privacyUrl: WebUrlSchema.optional(),
+	termsUrl: WebUrlSchema.optional(),
+	branding: BrandingSchema.default({}),
+	/** Açık checkout oturumunun ömrü (sağlayıcının form ömrü daha kısaysa o geçerli). */
+	checkoutTtlMinutes: TtlMinutesSchema.default(30),
+	portalTtlMinutes: TtlMinutesSchema.default(30)
+});
+const BrandingPatchSchema = z.object({
+	name: BrandingNameSchema.nullable().optional(),
+	logoUrl: LogoUrlSchema.nullable().optional(),
+	accentColor: AccentColorSchema.nullable().optional(),
+	supportEmail: SupportEmailSchema.nullable().optional()
+}).strict();
+/** `PATCH /v1/admin/settings` gövdesi. */
+const ProductSettingsPatchSchema = z.object({
+	appUrl: WebUrlSchema.nullable().optional(),
+	defaultCurrency: CurrencySchema.optional(),
+	defaultLocale: SettingsLocaleSchema.optional(),
+	extraReturnOrigins: ReturnOriginsSchema.optional(),
+	privacyUrl: WebUrlSchema.nullable().optional(),
+	termsUrl: WebUrlSchema.nullable().optional(),
+	branding: BrandingPatchSchema.nullable().optional(),
+	checkoutTtlMinutes: TtlMinutesSchema.optional(),
+	portalTtlMinutes: TtlMinutesSchema.optional()
+}).strict();
+/**
+* Doğrulanmış yamayı ayarlara uygular (saf). Sonuç şemadan geçer; alan kuralları
+* yamada zaten denetlendiği için yalnızca programlama hatasında fırlatır.
+*/
+function applySettingsPatch(current, patch) {
+	const next = { ...current };
+	for (const [key, value] of Object.entries(patch)) {
+		if (value === void 0) continue;
+		if (key === "branding") {
+			const branding = value === null ? {} : { ...current.branding };
+			if (value !== null) {
+				for (const [field, fieldValue] of Object.entries(value)) if (fieldValue === null) delete branding[field];
+				else if (fieldValue !== void 0) branding[field] = fieldValue;
+			}
+			next.branding = branding;
+		} else if (value === null) delete next[key];
+		else next[key] = value;
+	}
+	return ProductSettingsSchema.parse(next);
+}
+/** Checkout dönüşüne izinli origin'ler: `appUrl`'in origin'i + `extraReturnOrigins`. */
+function returnOriginsOf(settings) {
+	const app = settings.appUrl === void 0 ? null : parseUrl(settings.appUrl);
+	return [.../* @__PURE__ */ new Set([...app ? [app.origin] : [], ...settings.extraReturnOrigins])];
+}
+/** `returnUrl`'in origin'i izinli mi (geçersiz adres: hayır). */
+function isReturnUrlAllowed(settings, returnUrl) {
+	const url = parseUrl(returnUrl);
+	return url !== null && returnOriginsOf(settings).includes(url.origin);
+}
+//#endregion
+//#region ../contract/src/checkout.ts
+const ReturnUrlSchema = z.url({ protocol: /^https?$/ });
+/** Kabul edilen sözleşme — içerik üründe yaşar, burada yalnızca iz. */
+const ConsentSchema = z.object({
+	document: z.string().min(1).max(100),
+	version: z.string().min(1).max(100),
+	acceptedAt: DateTimeSchema,
+	/** Belgenin bağı (hosted akışta her zaman; eski gövdede verildiyse). */
+	url: z.string().optional()
+});
+/** Checkout gövdesindeki onay: hosted akışta onaylatılacak belge, eski gövdede kabul izi. */
+const CheckoutConsentInputSchema = z.object({
+	document: z.string().min(1).max(100),
+	version: z.string().min(1).max(100),
+	/** Hosted akışta zorunlu: sayfadaki belge bağı. */
+	url: z.url({ protocol: /^https?$/ }).max(2e3).optional(),
+	/** Yalnızca eski gövdede (ve orada zorunlu): ürün onayı kendisi aldı. */
+	acceptedAt: DateTimeSchema.optional()
+});
+/** Hosted sayfanın ön doldurması (profil/kimlik verisi değil; K21). */
+const CheckoutPrefillSchema = z.object({
+	email: z.email().max(200).optional(),
+	name: z.string().trim().min(1).max(200).optional(),
+	kind: BillingProfileKindSchema.optional()
+});
+/** Hosted akışta onaylatılabilecek en çok belge sayısı. */
+const MAX_CHECKOUT_CONSENT_DOCS = 20;
+const CheckoutSessionCreateInputSchema = z.object({
+	planCode: CodeSchema,
+	interval: IntervalSchema,
+	/** Verilmezse ürün ayarı `defaultCurrency` (eski gövdede zorunlu). */
+	currency: CurrencySchema.optional(),
+	/** Hosted: `tr` | `en`, verilmezse ürün ayarı `defaultLocale`. Eski gövdede zorunlu, iki harf. */
+	locale: z.string().regex(/^[a-z]{2}$/).optional(),
+	/**
+	* Sonuç bu adrese döner. Adreste yer tutucu (`{CHECKOUT_ID}`, `{STATUS}`,
+	* `{ACCOUNT_REF}`, `{LOCALE}`) varsa (yalnızca hosted) steward yalnızca onları
+	* doldurur, parametre eklemez; yoksa `?session=<id>&status=success|failed|pending`
+	* eklenir. pending: sağlayıcıya ulaşılamadı, oturum açık; ürün "işleniyor" gösterir.
+	* Origin'i ürün ayarlarında izinli olmalı (`appUrl` + `extraReturnOrigins`).
+	*/
+	successUrl: ReturnUrlSchema.optional(),
+	/** `successUrl`in eski adı. */
+	returnUrl: ReturnUrlSchema.optional(),
+	/** Yalnızca hosted: sayfadaki "Vazgeç" hedefi (yoksa ürün ayarı `appUrl`). Origin kuralı `successUrl`le aynı. */
+	cancelUrl: ReturnUrlSchema.optional(),
+	/** Hesap yoksa bu adla açılır; hesap varsa adı değiştirmez. */
+	displayName: z.string().min(1).max(200).optional(),
+	/** Yalnızca hosted. */
+	prefill: CheckoutPrefillSchema.optional(),
+	consents: z.array(CheckoutConsentInputSchema).optional(),
+	/** Yalnızca eski gövde. */
+	profile: BillingProfileSchema.optional(),
+	/**
+	* Yalnızca eski gövde: sağlayıcının istediği kimlik numarası (ör. TCKN/VKN).
+	* Yalnızca sağlayıcıya iletilir; servis bunu SAKLAMAZ ve LOGLAMAZ.
+	*/
+	identityNumber: z.string().regex(/^\d{10,11}$/).optional()
+}).superRefine((body, ctx) => {
+	const issue = (path, message) => ctx.addIssue({
+		code: "custom",
+		path: [path],
+		message
+	});
+	if (body.successUrl !== void 0 && body.returnUrl !== void 0) issue("returnUrl", "successUrl ve returnUrl (eski ad) birlikte verilemez");
+	if (body.successUrl === void 0 && body.returnUrl === void 0) issue("successUrl", "zorunlu");
+	const hasProfile = body.profile !== void 0;
+	if (hasProfile !== (body.identityNumber !== void 0)) {
+		issue(hasProfile ? "identityNumber" : "profile", "eski gövde profile ve identityNumber'ı birlikte taşır; hosted checkout ikisini de taşımaz");
+		return;
+	}
+	if (hasProfile) {
+		if (body.currency === void 0) issue("currency", "eski gövdede zorunlu");
+		if (body.locale === void 0) issue("locale", "eski gövdede zorunlu");
+		if (body.consents === void 0) issue("consents", "eski gövdede zorunlu");
+		body.consents?.forEach((consent, i) => {
+			if (consent.acceptedAt === void 0) ctx.addIssue({
+				code: "custom",
+				path: [
+					"consents",
+					i,
+					"acceptedAt"
+				],
+				message: "eski gövdede zorunlu"
+			});
+		});
+		if (body.cancelUrl !== void 0) issue("cancelUrl", "yalnızca hosted checkout");
+		if (body.prefill !== void 0) issue("prefill", "yalnızca hosted checkout");
+		return;
+	}
+	if (body.locale !== void 0 && !SETTINGS_LOCALES.includes(body.locale)) issue("locale", `hosted checkout: ${SETTINGS_LOCALES.join(" | ")}`);
+	const consents = body.consents ?? [];
+	if (consents.length > 20) issue("consents", `en çok 20 belge`);
+	const seen = /* @__PURE__ */ new Set();
+	consents.forEach((consent, i) => {
+		if (consent.url === void 0) ctx.addIssue({
+			code: "custom",
+			path: [
+				"consents",
+				i,
+				"url"
+			],
+			message: "hosted checkout'ta zorunlu"
+		});
+		if (consent.acceptedAt !== void 0) ctx.addIssue({
+			code: "custom",
+			path: [
+				"consents",
+				i,
+				"acceptedAt"
+			],
+			message: "hosted checkout'ta onayı sayfa kaydeder"
+		});
+		if (seen.has(consent.document)) ctx.addIssue({
+			code: "custom",
+			path: [
+				"consents",
+				i,
+				"document"
+			],
+			message: "belge adı tekrar ediyor"
+		});
+		seen.add(consent.document);
+	});
+}).transform(({ returnUrl, successUrl, ...rest }) => ({
+	...rest,
+	successUrl: successUrl ?? returnUrl
+}));
+/** Doğrulanmış gövde eski akışı mı istiyor (K16). Hosted: false. */
+function isLegacyCheckoutInput(input) {
+	return input.profile !== void 0 && input.identityNumber !== void 0;
+}
+/**
+* `canceled` (F2b): müşteri hosted sayfada vazgeçti. Eski (0.2.0 öncesi hosted'sız)
+* istemci bu değeri tanımaz; yalnızca hosted akışı kullanan ürün görür.
+*/
+const CheckoutStatusSchema = z.enum([
+	"open",
+	"completed",
+	"failed",
+	"expired",
+	"canceled"
+]);
+const ProviderPayloadSchema = z.discriminatedUnion("type", [z.object({
+	type: z.literal("html_snippet"),
+	html: z.string()
+}), z.object({
+	type: z.literal("redirect"),
+	url: z.url()
+})]);
+const CheckoutSessionSchema = z.object({
+	id: IdSchema,
+	accountRef: ExternalRefSchema,
+	status: CheckoutStatusSchema,
+	planCode: CodeSchema,
+	interval: IntervalSchema,
+	amountMinor: AmountMinorSchema,
+	currency: CurrencySchema,
+	provider: z.string(),
+	locale: z.string(),
+	/** Eski ad; `successUrl` ile aynı değer. */
+	returnUrl: z.string(),
+	successUrl: z.string().optional(),
+	/** Hosted: "Vazgeç" hedefi (verilmediyse null; sayfa ürün ayarı `appUrl`e döner). */
+	cancelUrl: z.string().nullable().optional(),
+	/** Kabul edilen belgeler (hosted: sayfada onaylandıktan sonra dolar). */
+	consents: z.array(ConsentSchema),
+	actorRef: ActorRefSchema.nullable(),
+	failureReason: z.string().nullable(),
+	subscriptionId: IdSchema.nullable(),
+	expiresAt: DateTimeSchema,
+	createdAt: DateTimeSchema,
+	completedAt: DateTimeSchema.nullable()
+});
+/**
+* `POST /v1/accounts/{ref}/checkout-sessions` yanıtı.
+* - hosted: `url` = steward checkout sayfası (`…/public/v1/checkout/{id}?k=<anahtar>`;
+*   anahtar yalnızca burada), `providerPayload` yok, `account` işlem sonrası durum.
+* - eski gövde: `url: null`, `providerPayload` sağlayıcı formu.
+* `url` F2b öncesi steward'da yoktur (null okunur).
+*/
+const CheckoutSessionCreatedSchema = CheckoutSessionSchema.extend({
+	url: z.string().nullable().default(null),
+	providerPayload: ProviderPayloadSchema.optional(),
+	account: AccountStateSchema.optional()
+});
+const RETURN_PLACEHOLDER_RE = /\{(CHECKOUT_ID|STATUS|ACCOUNT_REF|LOCALE)\}/g;
+function originOf(value) {
+	try {
+		return new URL(value).origin;
+	} catch {
+		return null;
+	}
+}
+/**
+* Checkout sonucunun tarayıcı yönlendirmesi — servis ve sahte steward aynı fonksiyonu
+* kullanır. Eski oturum: `returnUrl?session=&status=`. Hosted: `successUrl`de yer tutucu
+* (`{CHECKOUT_ID}` `{STATUS}` `{ACCOUNT_REF}` `{LOCALE}`) varsa YALNIZCA onlar doldurulur
+* (değerler URL-kodlu), parametre eklenmez; yoksa eski biçim. Kodlu değer origin'i
+* değiştiremez; yine de denetlenir, değişirse eski biçime düşülür.
+*/
+function checkoutRedirectUrl(target, status) {
+	const template = target.successUrl;
+	if (template !== null && template.match(RETURN_PLACEHOLDER_RE)) {
+		const values = {
+			CHECKOUT_ID: target.id,
+			STATUS: status,
+			ACCOUNT_REF: target.accountRef,
+			LOCALE: target.locale
+		};
+		const filled = template.replace(RETURN_PLACEHOLDER_RE, (_, name) => encodeURIComponent(values[name]));
+		if (originOf(filled) !== null && originOf(filled) === originOf(template)) return filled;
+	}
+	const url = new URL(template ?? target.returnUrl);
+	url.searchParams.set("session", target.id);
+	url.searchParams.set("status", status);
+	return url.toString();
+}
+const CHECKOUT_ERRORS = [
+	"account_not_found",
+	"already_subscribed",
+	"plan_not_sellable",
+	"return_url_not_allowed",
+	"provider_not_configured",
+	"provider_error",
+	"account_deleted"
+];
+//#endregion
+//#region ../contract/src/portal.ts
+const PortalSessionCreateInputSchema = z.object({
+	/** Sayfa dili; verilmezse ürün ayarı `defaultLocale`. */
+	locale: SettingsLocaleSchema.optional(),
+	/**
+	* "Ürüne dön" hedefi; verilmezse ürün ayarı `appUrl`. Origin'i ürün ayarlarında
+	* izinli olmalı (`appUrl` + `extraReturnOrigins`), değilse 422 `return_url_not_allowed`.
+	*/
+	returnUrl: z.url({ protocol: /^https?$/ }).max(2e3).optional()
+});
+/** `POST /v1/accounts/{ref}/portal-sessions` yanıtı (201). */
+const PortalSessionSchema = z.object({
+	id: IdSchema,
+	/** Steward portal sayfası (sayfa anahtarı dahil); tarayıcı buraya yönlendirilir. */
+	url: z.string(),
+	expiresAt: DateTimeSchema
+});
+const PORTAL_SESSION_ERRORS = ["account_not_found", "return_url_not_allowed"];
+//#endregion
+//#region ../contract/src/subscriptions.ts
+const SubscriptionSchema = z.object({
+	id: IdSchema,
+	accountRef: ExternalRefSchema,
+	status: SubscriptionStatusSchema,
+	planCode: CodeSchema,
+	priceId: IdSchema,
+	interval: IntervalSchema,
+	amountMinor: AmountMinorSchema,
+	currency: CurrencySchema,
+	provider: z.string(),
+	providerSubscriptionRef: z.string(),
+	cancelAtPeriodEnd: z.boolean(),
+	cancelAt: DateTimeSchema.nullable(),
+	cancelReason: z.string().nullable(),
+	canceledAt: DateTimeSchema.nullable(),
+	startedAt: DateTimeSchema,
+	currentPeriodStart: DateTimeSchema.nullable(),
+	currentPeriodEnd: DateTimeSchema.nullable(),
+	/** Ödeme alınamadığı günden beri dunning'de ise başlangıcı. */
+	dunningStartedAt: DateTimeSchema.nullable()
+});
+const CancelSubscriptionInputSchema = z.object({
+	/** at_period_end: haklar dönem sonuna kadar sürer; immediate: hemen varsayılan plana düşer. */
+	mode: z.enum(["at_period_end", "immediate"]),
+	reason: z.string().min(3).max(500),
+	/** Sağlayıcıda zaten iptal edildiyse (panelden) sağlayıcı çağrısını atla. */
+	skipProvider: z.boolean().default(false)
+});
+const PaymentSchema = z.object({
+	id: IdSchema,
+	subscriptionId: IdSchema,
+	providerOrderRef: z.string(),
+	status: z.enum(["succeeded", "failed"]),
+	amountMinor: AmountMinorSchema,
+	currency: CurrencySchema,
+	periodStart: DateTimeSchema.nullable(),
+	periodEnd: DateTimeSchema.nullable(),
+	occurredAt: DateTimeSchema
+});
+const GrantCreateInputSchema = z.object({
+	planCode: CodeSchema.optional(),
+	/** Plan değerlerinin üzerine yazılan tek tek haklar. */
+	overrides: EntitlementsSchema.default({}),
+	reason: z.string().min(3).max(500),
+	startsAt: DateTimeSchema.optional(),
+	endsAt: DateTimeSchema.optional()
+}).refine((g) => g.planCode !== void 0 || Object.keys(g.overrides).length > 0, { message: "planCode ya da en az bir override gerekli" });
+const GrantSchema = z.object({
+	id: IdSchema,
+	accountRef: ExternalRefSchema,
+	planCode: CodeSchema.nullable(),
+	overrides: EntitlementsSchema,
+	reason: z.string(),
+	actorRef: ActorRefSchema.nullable(),
+	startsAt: DateTimeSchema,
+	endsAt: DateTimeSchema.nullable(),
+	revokedAt: DateTimeSchema.nullable(),
+	createdAt: DateTimeSchema
+});
+const StatsSchema = z.object({
+	subscriptions: z.record(SubscriptionStatusSchema, z.number().int().nonnegative()),
+	/** Aylık yinelenen gelir, para birimine göre (yıllık fiyat / 12, yuvarlanmış). */
+	mrrMinor: z.record(z.string(), AmountMinorSchema),
+	accounts: z.number().int().nonnegative()
+});
+//#endregion
+//#region ../contract/src/invoices.ts
+const InvoiceStatusSchema = z.enum([
+	"draft",
+	"issued",
+	"void"
+]);
+const InvoiceLineSchema = z.object({
+	description: z.string(),
+	quantity: z.number().int().positive(),
+	unitAmountMinor: AmountMinorSchema,
+	amountMinor: AmountMinorSchema
+});
+const InvoiceSchema = z.object({
+	id: IdSchema,
+	accountRef: ExternalRefSchema,
+	subscriptionId: IdSchema.nullable(),
+	paymentId: IdSchema.nullable(),
+	status: InvoiceStatusSchema,
+	number: z.string().nullable(),
+	currency: CurrencySchema,
+	subtotalMinor: AmountMinorSchema,
+	taxMinor: AmountMinorSchema,
+	totalMinor: AmountMinorSchema,
+	taxRateBps: z.number().int().min(0).max(1e4),
+	/** Ödeme anındaki fatura profili (sonradan profil değişse de fatura değişmez). */
+	buyer: BillingProfileSchema,
+	lines: z.array(InvoiceLineSchema),
+	issuer: z.string(),
+	externalRef: z.string().nullable(),
+	hasDocument: z.boolean(),
+	issuedAt: DateTimeSchema.nullable(),
+	createdAt: DateTimeSchema,
+	/** Manuel faturanın vadesi (bilgi; steward tahsil etmez). */
+	dueAt: DateTimeSchema.nullable().optional(),
+	/** Manuel faturanın notu (ör. sözleşme ya da teklif referansı). */
+	note: z.string().nullable().optional(),
+	voidedAt: DateTimeSchema.nullable().optional(),
+	voidReason: z.string().nullable().optional()
+});
+const InvoiceIssueInputSchema = z.object({
+	number: z.string().min(1).max(100),
+	issuedAt: DateTimeSchema.optional(),
+	/** PDF, base64 (en fazla ~5 MB). */
+	documentBase64: z.base64().max(7e6).optional(),
+	externalRef: z.string().max(200).optional()
+}).refine((i) => i.documentBase64 !== void 0 || i.externalRef !== void 0, { message: "belge ya da harici referans gerekli" });
+/** Manuel faturada satır tutarları toplamının üst sınırı: vergi hesabı `Number` içinde tam kalır. */
+const MANUAL_INVOICE_MAX_AMOUNT_MINOR = 9e11;
+const ManualInvoiceLineInputSchema = z.object({
+	description: z.string().trim().min(1).max(500),
+	quantity: z.number().int().min(1).max(1e6),
+	/** Birim fiyat, en küçük birimde; `taxInclusive` ise KDV dahil. */
+	unitAmountMinor: AmountMinorSchema.max(MANUAL_INVOICE_MAX_AMOUNT_MINOR)
+});
+/**
+* `POST /v1/accounts/{ref}/invoices` — manuel taslak fatura. Alıcı hesabın o
+* anki fatura profilinin kopyasıdır (profil yoksa 422 `billing_profile_required`).
+* Para birimi katalogdan bağımsızdır (Enterprise teklifi katalog dışıdır).
+* Tutarlar `manualInvoiceTotals` ile hesaplanır.
+*/
+const ManualInvoiceInputSchema = z.object({
+	lines: z.array(ManualInvoiceLineInputSchema).min(1).max(100),
+	currency: CurrencySchema,
+	/** Baz puan: %20 = 2000. */
+	taxRateBps: z.number().int().min(0).max(1e4),
+	/** Katalog fiyatıyla aynı anlam; varsayılan true: birim fiyatlar KDV dahil, vergi toplamdan ayrıştırılır. */
+	taxInclusive: z.boolean().default(true),
+	dueAt: DateTimeSchema.optional(),
+	note: z.string().trim().min(1).max(1e3).optional()
+}).refine((i) => i.lines.reduce((sum, l) => sum + l.quantity * l.unitAmountMinor, 0) <= MANUAL_INVOICE_MAX_AMOUNT_MINOR, {
+	message: "toplam tutar çok büyük",
+	path: ["lines"]
+});
+/** `POST /v1/invoices/{id}/void` — yalnızca manuel fatura; numara serbest kalmaz, belge silinmez. */
+const InvoiceVoidInputSchema = z.object({ reason: z.string().trim().min(3).max(500) });
+/**
+* Vergi dahil tutardan matrah ve vergiyi ayrıştırır (tam sayı, kuruşa
+* yuvarlama). Toplam her zaman korunur: subtotal + tax === total.
+*/
+function splitInclusiveTax(totalMinor, taxRateBps) {
+	if (!Number.isInteger(totalMinor) || totalMinor < 0) throw new Error(`tutar tam sayı olmalı: ${totalMinor}`);
+	if (!Number.isInteger(taxRateBps) || taxRateBps < 0) throw new Error(`oran tam sayı bps olmalı: ${taxRateBps}`);
+	const subtotalMinor = Math.round(totalMinor * 1e4 / (1e4 + taxRateBps));
+	return {
+		subtotalMinor,
+		taxMinor: totalMinor - subtotalMinor
+	};
+}
+/**
+* Manuel faturanın tutarları ve saklanan satırları.
+*
+* Ödemeli faturanın kuralı, fatura düzeyinde TEK yuvarlamayla: satır tutarları
+* (adet × birim) toplanır; `taxInclusive` ise toplam korunur ve matrah/vergi
+* `splitInclusiveTax` ile ayrıştırılır, değilse vergi matrahın üstüne eklenir
+* (`Math.round`). Tek satır ve adet 1 girdi, aynı tutarlı ödemeli faturanın
+* toplamlarını ve satırını birebir üretir.
+*
+* Saklanan satırlar ödemeli faturadaki gibi KDV HARİÇTİR ve tutarları matrahı
+* tam verir: vergi dahil girdide matrah satırlara tutarları oranında dağıtılır
+* (en büyük kalan; eşitlikte önceki satır). Satırın `amountMinor`'u esastır;
+* adet > 1 ise `unitAmountMinor` onun yuvarlanmış birim payıdır.
+*/
+function manualInvoiceTotals(input) {
+	const amounts = input.lines.map((l) => l.quantity * l.unitAmountMinor);
+	const amountMinor = amounts.reduce((sum, a) => sum + a, 0);
+	if (!input.taxInclusive) {
+		const taxMinor = Math.round(amountMinor * input.taxRateBps / 1e4);
+		return {
+			subtotalMinor: amountMinor,
+			taxMinor,
+			totalMinor: amountMinor + taxMinor,
+			lines: input.lines.map((l, i) => ({
+				description: l.description,
+				quantity: l.quantity,
+				unitAmountMinor: l.unitAmountMinor,
+				amountMinor: amounts[i]
+			}))
+		};
+	}
+	const { subtotalMinor, taxMinor } = splitInclusiveTax(amountMinor, input.taxRateBps);
+	const net = allocate(subtotalMinor, amounts);
+	return {
+		subtotalMinor,
+		taxMinor,
+		totalMinor: amountMinor,
+		lines: input.lines.map((l, i) => ({
+			description: l.description,
+			quantity: l.quantity,
+			unitAmountMinor: Math.round(net[i] / l.quantity),
+			amountMinor: net[i]
+		}))
+	};
+}
+/** `total`'ı ağırlıklar oranında tam sayılara böler; toplam korunur (en büyük kalan). BigInt: çarpım 2^53'ü aşabilir. */
+function allocate(total, weights) {
+	const sum = BigInt(weights.reduce((s, w) => s + w, 0));
+	if (sum === 0n) return weights.map(() => 0);
+	const shares = weights.map((w, index) => {
+		const scaled = BigInt(total) * BigInt(w);
+		return {
+			index,
+			base: scaled / sum,
+			remainder: scaled % sum
+		};
+	});
+	let left = BigInt(total) - shares.reduce((s, x) => s + x.base, 0n);
+	const order = [...shares].sort((a, b) => a.remainder === b.remainder ? a.index - b.index : a.remainder > b.remainder ? -1 : 1);
+	for (const share of order) {
+		if (left === 0n) break;
+		share.base += 1n;
+		left -= 1n;
+	}
+	return shares.map((x) => Number(x.base));
+}
+//#endregion
+//#region ../contract/src/api.ts
+/** `GET /v1/accounts/{ref}?include=…` — istenmeyen alanlar yanıtta yoktur. */
+const AccountDetailSchema = AccountSchema.extend({
+	profile: BillingProfileSchema.nullable().optional(),
+	subscriptions: z.array(SubscriptionSchema).optional(),
+	checkouts: z.array(CheckoutSessionSchema).optional(),
+	payments: z.array(PaymentSchema).optional(),
+	invoices: z.array(InvoiceSchema).optional(),
+	grants: z.array(GrantSchema).optional()
+});
+const withAccount = { account: AccountStateSchema.optional() };
+/** `PUT /v1/accounts/{ref}` (201 ya da 200). */
+const AccountUpsertResponseSchema = AccountSchema.extend(withAccount);
+/** `PUT /v1/accounts/{ref}/billing-profile` */
+const BillingProfileResponseSchema = BillingProfileSchema.extend(withAccount);
+/** `POST /v1/accounts/{ref}/grants` */
+const GrantCreateResponseSchema = GrantSchema.extend(withAccount);
+/** `POST /v1/subscriptions/{id}/cancel` */
+const CancelSubscriptionResponseSchema = SubscriptionSchema.extend(withAccount);
+/** `POST /v1/invoices/{id}/issue` */
+const InvoiceIssueResponseSchema = InvoiceSchema.extend(withAccount);
+/** `POST /v1/accounts/{ref}/invoices` (201; F4f). Durum değişmez: mevcut durum. */
+const ManualInvoiceResponseSchema = InvoiceSchema.extend(withAccount);
+/** `POST /v1/invoices/{id}/void` (F4f). Durum değişmez: mevcut durum. */
+const InvoiceVoidResponseSchema = InvoiceSchema.extend(withAccount);
+/** `GET /v1/checkout-sessions/{id}` — `account` yalnızca oturum `completed` ise. */
+const CheckoutSessionResponseSchema = CheckoutSessionSchema.extend(withAccount);
+const DeliverySchema = z.object({
+	endpointId: IdSchema,
+	status: z.enum([
+		"pending",
+		"delivered",
+		"dead"
+	]),
+	attempts: z.number().int().nonnegative(),
+	lastHttpStatus: z.number().int().nullable(),
+	lastError: z.string().nullable(),
+	nextAttemptAt: DateTimeSchema.nullable(),
+	deliveredAt: DateTimeSchema.nullable()
+});
+const EventRecordSchema = z.object({
+	event: BillingEventSchema,
+	deliveries: z.array(DeliverySchema)
+});
+const EventListSchema = z.object({
+	items: z.array(EventRecordSchema),
+	nextCursor: z.string().nullable()
+});
+/** Değişiklik yapan her istekte zorunlu başlıklar. */
+const HEADER_IDEMPOTENCY_KEY = "idempotency-key";
+const HEADER_ACTOR_REF = "x-actor-ref";
+const HEADER_API_VERSION = "steward-api-version";
+const HEADER_SDK = "x-steward-sdk";
+const HEADER_REQUEST_ID = "x-request-id";
+//#endregion
+//#region ../contract/src/errors.ts
+const spec = (httpStatus, category, retryable = false) => ({
+	httpStatus,
+	category,
+	retryable
+});
+const ERROR_CODES = Object.freeze({
+	invalid_json: spec(400, "validation"),
+	invalid_request: spec(400, "validation"),
+	invalid_account_ref: spec(400, "validation"),
+	invalid_include: spec(400, "validation"),
+	invalid_cursor: spec(400, "validation"),
+	invalid_limit: spec(400, "validation"),
+	invalid_actor_ref: spec(400, "validation"),
+	actor_ref_required: spec(400, "validation"),
+	idempotency_key_required: spec(400, "validation"),
+	invalid_idempotency_key: spec(400, "validation"),
+	/** Anahtar yok / iptal / yanlış — neden ayrıştırılmaz. */
+	unauthorized: spec(401, "config"),
+	/** Admin kapsamı gereken uç. */
+	forbidden: spec(403, "config"),
+	/** Aynı anahtarlı önceki istek sürüyor; aynı anahtarla sonra tekrar dene. */
+	request_in_progress: spec(409, "conflict", true),
+	/** Anahtar farklı bir istekte kullanılmış. */
+	idempotency_key_reused: spec(422, "conflict"),
+	/** Bilinmeyen yol ya da biçimi geçersiz fatura id'si. */
+	not_found: spec(404, "not_found"),
+	account_not_found: spec(404, "not_found"),
+	subscription_not_found: spec(404, "not_found"),
+	grant_not_found: spec(404, "not_found"),
+	invoice_not_found: spec(404, "not_found"),
+	document_not_found: spec(404, "not_found"),
+	event_not_found: spec(404, "not_found"),
+	checkout_session_not_found: spec(404, "not_found"),
+	/** Yönetim ucu: endpoint yok ya da başka ürünün. */
+	webhook_endpoint_not_found: spec(404, "not_found"),
+	/** Ürün için henüz katalog senkronlanmadı (404 ama kurulum eksiği). */
+	catalog_not_configured: spec(404, "config"),
+	plan_missing_feature: spec(422, "validation"),
+	/** Katalog senkronu ve grant override'ı. */
+	override_type_mismatch: spec(422, "validation"),
+	/** Grant girdisindeki plan katalogda yok. */
+	plan_not_found: spec(422, "validation"),
+	invalid_window: spec(422, "validation"),
+	already_subscribed: spec(409, "conflict"),
+	already_canceled: spec(409, "conflict"),
+	/** `PUT …/plan` `mode: "strict"`: canlı aboneliğin planı hedefi geçiyor; hiçbir şey yazılmadı. */
+	subscription_plan_higher: spec(409, "conflict"),
+	plan_not_sellable: spec(422, "validation"),
+	/**
+	* F4e: hesap silinmiş (anonimleştirilmiş). `/v1/accounts/:ref` altındaki her uç (tekrar
+	* `DELETE` ve aynı ref'le `PUT` dahil) 410 döner; hesap geri açılmaz.
+	*/
+	account_deleted: spec(410, "not_found"),
+	/** `DELETE /v1/accounts/:ref`: canlı abonelik (dönem sonunda iptali planlı dahil) var; önce hemen iptal. */
+	subscription_active: spec(409, "conflict"),
+	/** `DELETE /v1/accounts/:ref`: sağlayıcı formu açık checkout oturumu var; süresi dolup kapanınca tekrar dene. */
+	checkout_in_progress: spec(409, "conflict", true),
+	/** `returnUrl` ürünün izinli origin'lerinde değil: ürün yapılandırması hatalı. */
+	return_url_not_allowed: spec(422, "config"),
+	/** Bu deployment'ta sağlayıcı yapılandırılmamış (503 ama beklemekle düzelmez). */
+	provider_not_configured: spec(503, "config"),
+	provider_error: spec(502, "provider"),
+	already_issued: spec(409, "conflict"),
+	number_taken: spec(409, "conflict"),
+	invalid_document: spec(422, "validation"),
+	/** Manuel fatura (F4f): hesabın fatura profili yok (alıcı profilin kopyasıdır). */
+	billing_profile_required: spec(422, "conflict"),
+	/** Void: fatura zaten `void`. */
+	invoice_not_voidable: spec(409, "conflict"),
+	/** Void: ödemeli fatura; iptali iade yolundadır (F4d). */
+	invoice_has_payment: spec(409, "conflict"),
+	internal_error: spec(500, "unavailable", true),
+	/** `/health`: veritabanına ulaşılamıyor. */
+	database_unavailable: spec(503, "unavailable", true),
+	/** F2c (K26): anahtar prefix'i başına bütçe aşıldı; `Retry-After` başlığı taşır. */
+	rate_limited: spec(429, "unavailable", true),
+	unknown_provider: spec(404, "not_found"),
+	bad_signature: spec(401, "config"),
+	invalid_payload: spec(400, "validation"),
+	stale_event: spec(400, "validation"),
+	not_configured: spec(503, "config"),
+	/** Yalnızca sahte sağlayıcı (yerel/test). */
+	unknown_subscription: spec(404, "not_found")
+});
+function isKnownErrorCode(code) {
+	return Object.hasOwn(ERROR_CODES, code);
+}
+/** Bilinen kodun tanımı; bilinmeyen kod için null. */
+function errorCodeSpec(code) {
+	return isKnownErrorCode(code) ? ERROR_CODES[code] : null;
+}
+//#endregion
+//#region ../contract/src/plan.ts
+const PLAN_SET_MODES = ["ensure", "strict"];
+const PlanSetModeSchema = z.enum(PLAN_SET_MODES);
+const PlanSetInputSchema = z.object({
+	/** Hedef plan; `null` elle verilmiş planı kaldırır (hesap aboneliğe ya da varsayılan plana döner). Alan zorunludur. */
+	planCode: CodeSchema.nullable(),
+	reason: z.string().min(3).max(500),
+	mode: PlanSetModeSchema.default("ensure"),
+	/** Planın bitişi; verilmezse süresiz. */
+	endsAt: DateTimeSchema.optional(),
+	/** Plan değerlerinin üzerine yazılan tek tek haklar (grant override'ı ile aynı tip kuralı). */
+	overrides: EntitlementsSchema.default({})
+}).superRefine((input, ctx) => {
+	if (input.planCode !== null) return;
+	if (input.endsAt !== void 0) ctx.addIssue({
+		code: "custom",
+		path: ["endsAt"],
+		message: "planCode null iken verilemez"
+	});
+	if (Object.keys(input.overrides).length > 0) ctx.addIssue({
+		code: "custom",
+		path: ["overrides"],
+		message: "planCode null iken verilemez"
+	});
+});
+const PlanSetWarningSchema = z.object({
+	code: z.string().min(1).max(100),
+	message: z.string()
+});
+/** `PUT /v1/accounts/{ref}/plan` (200). */
+const PlanSetResponseSchema = z.object({
+	/** Hesabın geçerli plan grant'i; `planCode: null` ise null. */
+	grant: GrantSchema.nullable(),
+	/** İşlem sonrası hesap durumu (K5). */
+	account: AccountStateSchema,
+	warnings: z.array(PlanSetWarningSchema)
+});
+const ResyncResultSchema = z.object({
+	queued: z.literal(true),
+	/** Yazılan `account.state_changed` event'inin id'si. */
+	eventId: EventIdSchema.optional()
+});
+//#endregion
+//#region ../contract/src/webhook-endpoints.ts
+const WEBHOOK_SECRET_PREFIX = "whsec_";
+const SECRET_MARKERS = [WEBHOOK_SECRET_PREFIX, "stw_"];
+const hasSecretMarker = (value) => SECRET_MARKERS.some((marker) => value.includes(marker));
+/**
+* `whsec_` + en az 32 karakter (base64/base64url alfabesi; virgül ve boşluk yok —
+* ürün sırları `yeni,eski` listesi olarak tutar). Düşük çeşitlilikteki değer
+* (ör. tek karakter tekrarı) reddedilir; `generateWebhookSecret` 32 rastgele bayt üretir.
+*/
+const WebhookSecretSchema = z.string().regex(/^whsec_[A-Za-z0-9_\-+/=]{32,200}$/, "whsec_ + en az 32 karakter (A-Z a-z 0-9 _ - + / =)").refine((value) => new Set(value.slice(6)).size >= 8, "sır yeterince rastgele değil");
+const EventTypeSchema = z.enum(EVENT_TYPES);
+const WEBHOOK_ENDPOINT_STATUSES = [
+	"active",
+	"paused",
+	"inactive"
+];
+const WebhookEndpointStatusSchema = z.enum(WEBHOOK_ENDPOINT_STATUSES);
+const LOOPBACK_HOSTS = /* @__PURE__ */ new Set([
+	"localhost",
+	"127.0.0.1",
+	"[::1]"
+]);
+const CLUSTER_SUFFIX = ".svc.cluster.local";
+/**
+* Adres politikası; uygunsa null, değilse nedeni. `allowLoopback` üretimde false.
+* Şemadan ayrıdır: üretim bilgisi yalnızca serviste var (servis ve sahte steward
+* gövde şemasına `superRefine` ile ekler).
+*/
+function webhookEndpointUrlProblem(value, options) {
+	let url;
+	try {
+		url = new URL(value);
+	} catch {
+		return "geçerli bir adres değil";
+	}
+	if (url.username !== "" || url.password !== "") return "adreste kullanıcı bilgisi olamaz";
+	if (url.protocol === "https:") return null;
+	const host = url.hostname.toLowerCase();
+	if (url.protocol === "http:") {
+		if (host.endsWith(CLUSTER_SUFFIX) && host.length > 18) return null;
+		if (options.allowLoopback && LOOPBACK_HOSTS.has(host)) return null;
+	}
+	return options.allowLoopback ? "https://, cluster içi http://*.svc.cluster.local ya da http://localhost olmalı" : "https:// ya da cluster içi http://*.svc.cluster.local olmalı";
+}
+const EndpointUrlSchema = z.url({ protocol: /^https?$/ }).max(2e3).refine((value) => !hasSecretMarker(value), "adres sır içeremez");
+const DescriptionSchema = z.string().trim().min(1).max(200).refine((value) => !hasSecretMarker(value), "açıklama sır içeremez");
+/** `POST /v1/admin/webhook-endpoints`. `eventTypes` verilmezse yalnızca `account.state_changed` (plan §7.5). */
+const WebhookEndpointCreateInputSchema = z.object({
+	url: EndpointUrlSchema,
+	secret: WebhookSecretSchema,
+	eventTypes: z.array(EventTypeSchema).min(1).transform((types) => [...new Set(types)]).optional(),
+	description: DescriptionSchema.optional()
+}).strict();
+/** Yönetim ucuyla açılan endpoint'in varsayılan filtresi. */
+const DEFAULT_ENDPOINT_EVENT_TYPES = Object.freeze(["account.state_changed"]);
+/** `POST /v1/admin/webhook-endpoints/{id}/rotate`. */
+const WebhookEndpointRotateInputSchema = z.object({ secret: WebhookSecretSchema }).strict();
+/**
+* Endpoint'in en son DENENMİŞ teslimatı. `at`: teslim edildiyse teslim anı, değilse
+* teslimatın kuyruğa girdiği an. `httpStatus` 401 = ürün yanlış sırla doğruluyor.
+*/
+const WebhookLastDeliverySchema = z.object({
+	status: z.enum([
+		"pending",
+		"delivered",
+		"dead"
+	]),
+	httpStatus: z.number().int().nullable(),
+	/** `http_<kod>`, `timeout`, `network_error`, `endpoint_inactive`; başarıda null. */
+	error: z.string().nullable(),
+	attempts: z.number().int().nonnegative(),
+	at: DateTimeSchema
+});
+/** Yanıt gövdesi. Sır alanı yoktur (K9). */
+const WebhookEndpointSchema = z.object({
+	id: IdSchema,
+	url: z.string(),
+	status: WebhookEndpointStatusSchema,
+	/** null: filtre yok, yalnızca 0.1'in 15 eski tipi (`LEGACY_EVENT_TYPES`). */
+	eventTypes: z.array(EventTypeSchema).nullable(),
+	description: z.string().nullable(),
+	createdAt: DateTimeSchema,
+	rotatedAt: DateTimeSchema.nullable(),
+	lastDelivery: WebhookLastDeliverySchema.nullable()
+});
+/** `GET /v1/admin/webhook-endpoints` (oluşturulma sırasıyla). */
+const WebhookEndpointListSchema = z.object({ items: z.array(WebhookEndpointSchema) });
+/** `whsec_` + 32 rastgele bayt (base64url). Web Crypto; Node ≥22, edge ve workerd. */
+function generateWebhookSecret() {
+	const bytes = globalThis.crypto.getRandomValues(/* @__PURE__ */ new Uint8Array(32));
+	const base64 = btoa(String.fromCharCode(...bytes));
+	return `${WEBHOOK_SECRET_PREFIX}${base64.replaceAll("+", "-").replaceAll("/", "_").replace(/=+$/, "")}`;
+}
+//#endregion
+//#region ../contract/src/doctor.ts
+const DOCTOR_SEVERITIES = [
+	"error",
+	"warning",
+	"info"
+];
+const DoctorSeveritySchema = z.enum(DOCTOR_SEVERITIES);
+const DoctorWarningSchema = z.object({
+	code: z.string().min(1).max(100),
+	severity: DoctorSeveritySchema,
+	/** İnsan için (tr); makine `code`'a bakar. */
+	message: z.string(),
+	/** Uyarı tek bir endpoint'e aitse. */
+	endpointId: IdSchema.optional()
+});
+const DoctorUnsellablePriceSchema = z.object({
+	priceId: IdSchema,
+	planCode: z.string(),
+	interval: IntervalSchema,
+	intervalCount: z.number().int().positive(),
+	currency: z.string(),
+	reason: z.string()
+});
+const DoctorCatalogSchema = z.object({
+	/** Katalog en az bir kez senkronlandı (`GET /v1/catalog` 200). */
+	synced: z.boolean(),
+	/** `GET /v1/catalog` ETag'inin tırnaksız değeri (`AccountState.catalogVersion`); senkron yoksa null. */
+	version: z.string().nullable(),
+	/** Aktif plan sayısı. */
+	plans: z.number().int().nonnegative(),
+	/** Satışa açık planların (`sellable`) bugün checkout'ta satılabilen aktif fiyatları. */
+	sellablePrices: z.number().int().nonnegative(),
+	/** Satışa açık planların satılamayan aktif fiyatları (satışa kapalı planların fiyatları sayılmaz). */
+	unsellablePrices: z.array(DoctorUnsellablePriceSchema)
+});
+const DOCTOR_PROVIDER_ENVIRONMENTS = [
+	"sandbox",
+	"live",
+	"fake"
+];
+const DoctorProviderSchema = z.object({
+	/** Ürün ayarındaki sağlayıcı (`settings.provider`). */
+	id: z.string(),
+	/** Sağlayıcı bu deployment'ta yapılandırılmış mı (anahtarlar var). */
+	configured: z.boolean(),
+	/** `sandbox` | `live` (iyzico taban adresinden) | `fake`; yapılandırılmamışsa null (K20). */
+	environment: z.enum(DOCTOR_PROVIDER_ENVIRONMENTS).nullable(),
+	/** Sağlayıcı hesabı (iyzico merchant id; sır değildir); bilinmiyorsa null (K20). */
+	merchantId: z.string().nullable(),
+	/**
+	* Yanıtı veren pod'un gözlemi: art arda erişilebilirlik hatası yoksa true (çağrı
+	* olmaması da true). Pod başına, süreç içi; yapılandırılmamışsa null.
+	*/
+	healthy: z.boolean().nullable(),
+	/** Bu pod'un gördüğü son sağlayıcı hatası (kod ve işlem; mesaj yok). */
+	lastError: z.object({
+		/** Sağlayıcı hata kodu, ör. `iyzico:timeout`, `iyzico:1001`. */
+		code: z.string(),
+		/** `ensure_price` | `create_checkout` | `retrieve_checkout` | `retrieve_subscription` | `cancel_subscription` | `retry_payment`. */
+		operation: z.string(),
+		at: DateTimeSchema
+	}).nullable()
+});
+const DoctorSettingsSchema = z.object({
+	appUrl: z.string().nullable(),
+	/** Checkout dönüşüne izinli origin'ler (`appUrl`'in origin'i + `extraReturnOrigins`). */
+	returnOrigins: z.array(z.string())
+});
+/** Hosted sayfanın (F2b checkout, F3a portal) zorunlu saydığı marka alanları; logo ve renk nötr varsayılana düşer. */
+const DOCTOR_REQUIRED_BRANDING = ["name", "supportEmail"];
+/** KVKK/mesafeli satış bağları. */
+const DOCTOR_REQUIRED_LEGAL_LINKS = ["privacyUrl", "termsUrl"];
+const DoctorHostedSchema = z.object({
+	branding: z.object({ missing: z.array(z.string()) }),
+	legalLinks: z.object({ missing: z.array(z.string()) }),
+	/** Marka ve yasal bağ eksiği yok ve `appUrl` var (sayfanın "ürüne dön" hedefi). */
+	ready: z.boolean()
+});
+const DoctorEndpointSchema = z.object({
+	id: IdSchema,
+	/** Ürünün kaydettiği adres. */
+	url: z.string(),
+	status: WebhookEndpointStatusSchema,
+	/** null: filtre yok, yalnızca 0.1'in 15 eski tipi (`account.state_changed` almaz). */
+	eventTypes: z.array(EventTypeSchema).nullable(),
+	/** Bekleyen teslimat sayısı. */
+	pending: z.number().int().nonnegative(),
+	/** Vazgeçilmiş (dead) teslimat sayısı; `resync` ile kurtarılır. */
+	dead: z.number().int().nonnegative(),
+	/** Bekleyen en eski teslimatın kuyruğa girdiği an. */
+	oldestPendingAt: DateTimeSchema.nullable(),
+	/** `GET /v1/admin/webhook-endpoints` ile aynı: en son denenmiş teslimat. */
+	lastDelivery: WebhookLastDeliverySchema.nullable(),
+	diagnosis: z.string()
+});
+const DoctorReportSchema = z.object({
+	/** `error` önemde uyarı yok. */
+	ok: z.boolean(),
+	checkedAt: DateTimeSchema,
+	product: z.object({
+		code: z.string(),
+		name: z.string()
+	}),
+	catalog: DoctorCatalogSchema,
+	provider: DoctorProviderSchema,
+	settings: DoctorSettingsSchema,
+	hosted: DoctorHostedSchema,
+	/** Pasif (`inactive`) olmayan endpoint'ler, oluşturulma sırasıyla. */
+	endpoints: z.array(DoctorEndpointSchema),
+	dunning: z.object({ 
+	/** true: dunning adımları yalnızca iz yazar (askı/sonlandırma yok). */
+dryRun: z.boolean() }),
+	warnings: z.array(DoctorWarningSchema)
+});
+/** Bekleyen en eski teslimat bundan eskiyse `endpoint_pending_backlog` (K23 alarmıyla aynı eşik). */
+const DOCTOR_PENDING_BACKLOG_MS = 36e5;
+/** Son denenmiş teslimattan endpoint teşhisi (saf). */
+function endpointDiagnosisOf(last) {
+	if (last === null) return "no_deliveries";
+	if (last.status === "delivered") return "ok";
+	if (last.httpStatus === 401) return "wrong_secret";
+	if (last.httpStatus === 400) return "old_contract";
+	if (last.error === "timeout" || last.error === "network_error") return "unreachable";
+	if (last.status === "pending" && last.httpStatus === null && last.error === null) return "in_progress";
+	return "failing";
+}
+/** Hosted sayfa hazırlığı: eksik zorunlu marka alanları ve yasal bağlar (saf). */
+function hostedReadinessOf(settings) {
+	const branding = DOCTOR_REQUIRED_BRANDING.filter((field) => settings.branding[field] === void 0);
+	const legalLinks = DOCTOR_REQUIRED_LEGAL_LINKS.filter((field) => settings[field] === void 0);
+	return {
+		branding: { missing: [...branding] },
+		legalLinks: { missing: [...legalLinks] },
+		ready: branding.length === 0 && legalLinks.length === 0 && settings.appUrl !== void 0
+	};
+}
+const receivesStateChanged = (endpoint) => endpoint.status === "active" && (endpoint.eventTypes ?? []).includes("account.state_changed");
+const DIAGNOSIS_WARNINGS = {
+	wrong_secret: {
+		code: "endpoint_wrong_secret",
+		severity: "error",
+		message: "son teslimat 401 aldı: ürün imzayı yanlış sırla doğruluyor (rotasyonda `yeni,eski` listesi)"
+	},
+	old_contract: {
+		code: "endpoint_old_contract",
+		severity: "error",
+		message: "son teslimat 400 aldı: alıcı gövdeyi tanımıyor (eski SDK ya da filtredeki tipi bilmiyor)"
+	},
+	unreachable: {
+		code: "endpoint_unreachable",
+		severity: "error",
+		message: "son teslimat adrese ulaşamadı (zaman aşımı ya da ağ hatası)"
+	},
+	failing: {
+		code: "endpoint_failing",
+		severity: "warning",
+		message: "son teslimat başarısız yanıt aldı; steward yeniden deniyor"
+	}
+};
+/** Olgulardan raporu türetir (saf): endpoint teşhisleri, hosted hazırlığı, uyarılar ve `ok`. */
+function buildDoctorReport(facts) {
+	const warnings = [];
+	const warn = (severity, code, message, endpointId) => {
+		warnings.push({
+			code,
+			severity,
+			message,
+			...endpointId !== void 0 ? { endpointId } : {}
+		});
+	};
+	const { catalog, provider, settings, dunning } = facts;
+	if (!catalog.synced) warn("error", "catalog_not_synced", "katalog senkronlanmamış: `PUT /v1/admin/catalog` (steward catalog push)");
+	const byReason = (reason) => catalog.unsellablePrices.filter((p) => p.reason === reason);
+	const unsynced = byReason("provider_price_missing");
+	if (unsynced.length > 0) warn("error", "price_not_synced_with_provider", `${unsynced.length} fiyatın sağlayıcıda karşılığı yok (checkout plan_not_sellable döner): katalog senkronunu yeniden koşun`);
+	const otherUnsellable = catalog.unsellablePrices.filter((p) => p.reason !== "provider_price_missing" && p.reason !== "provider_not_configured");
+	if (otherUnsellable.length > 0) {
+		const reasons = [...new Set(otherUnsellable.map((p) => p.reason))].join(", ");
+		warn("warning", "price_unsellable", `${otherUnsellable.length} fiyat satılamaz (${reasons})`);
+	}
+	if (!provider.configured) warn("error", "provider_not_configured", `ödeme sağlayıcısı ${provider.id} bu deployment'ta yapılandırılmamış`);
+	else if (provider.healthy === false) warn("warning", "provider_unhealthy", `ödeme sağlayıcısı ${provider.id} art arda erişilemedi (yanıtı veren pod'un gözlemi)`);
+	const returnOrigins = returnOriginsOf(settings);
+	if (returnOrigins.length === 0) warn("error", "no_return_origin", "checkout dönüşüne izinli origin yok: `appUrl` ayarlanmalı (her checkout return_url_not_allowed alır)");
+	if (settings.appUrl === void 0) warn("warning", "app_url_missing", "`appUrl` ayarlı değil: `PATCH /v1/admin/settings`");
+	const hosted = hostedReadinessOf(settings);
+	if (hosted.branding.missing.length > 0) warn("warning", "branding_incomplete", `hosted sayfa markası eksik: branding.${hosted.branding.missing.join(", branding.")}`);
+	if (hosted.legalLinks.missing.length > 0) warn("warning", "legal_links_missing", `hosted sayfa yasal bağları eksik: ${hosted.legalLinks.missing.join(", ")}`);
+	const endpoints = facts.endpoints.map((endpoint) => ({
+		...endpoint,
+		diagnosis: endpointDiagnosisOf(endpoint.lastDelivery)
+	}));
+	const active = endpoints.filter((e) => e.status === "active");
+	if (active.length === 0) warn("error", "no_active_endpoint", "aktif webhook endpoint'i yok: ürün durum değişikliklerini almaz");
+	else if (!active.some(receivesStateChanged)) warn("warning", "no_state_changed_endpoint", "hiçbir aktif endpoint account.state_changed almıyor (filtresiz endpoint yalnızca 0.1 tiplerini alır)");
+	for (const endpoint of endpoints) {
+		const diagnosis = DIAGNOSIS_WARNINGS[endpoint.diagnosis];
+		if (diagnosis) warn(diagnosis.severity, diagnosis.code, diagnosis.message, endpoint.id);
+		if (endpoint.dead > 0) warn("warning", "endpoint_dead_deliveries", `${endpoint.dead} teslimattan vazgeçildi (dead): etkilenen hesaplar için resync`, endpoint.id);
+		if (endpoint.oldestPendingAt !== null && facts.checkedAt.getTime() - Date.parse(endpoint.oldestPendingAt) > 36e5) warn("warning", "endpoint_pending_backlog", `${endpoint.pending} teslimat bekliyor; en eskisi bir saatten eski`, endpoint.id);
+	}
+	if (dunning.dryRun) warn("info", "dunning_dry_run", "dunning dry-run: adımlar yalnızca iz yazar, askı ve sonlandırma uygulanmaz");
+	return {
+		ok: !warnings.some((w) => w.severity === "error"),
+		checkedAt: facts.checkedAt.toISOString(),
+		product: facts.product,
+		catalog,
+		provider,
+		settings: {
+			appUrl: settings.appUrl ?? null,
+			returnOrigins
+		},
+		hosted,
+		endpoints,
+		dunning,
+		warnings
+	};
+}
+//#endregion
+export { HEADER_SDK as $, FeatureTypeSchema as $t, webhookEndpointUrlProblem as A, MAX_CHECKOUT_CONSENT_DOCS as At, AccountDetailSchema as B, ReturnOriginSchema as Bt, WebhookEndpointListSchema as C, CheckoutConsentInputSchema as Ct, WebhookLastDeliverySchema as D, CheckoutSessionSchema as Dt, WebhookEndpointStatusSchema as E, CheckoutSessionCreatedSchema as Et, PlanSetWarningSchema as F, BrandingSchema as Ft, DeliverySchema as G, applySettingsPatch as Gt, BillingProfileResponseSchema as H, SettingsLocaleSchema as Ht, ResyncResultSchema as I, DEFAULT_CHECKOUT_TTL_MINUTES as It, GrantCreateResponseSchema as J, AccountsRefreshResultSchema as Jt, EventListSchema as K, isReturnUrlAllowed as Kt, ERROR_CODES as L, DEFAULT_PORTAL_TTL_MINUTES as Lt, PlanSetInputSchema as M, checkoutRedirectUrl as Mt, PlanSetModeSchema as N, isLegacyCheckoutInput as Nt, WebhookSecretSchema as O, CheckoutStatusSchema as Ot, PlanSetResponseSchema as P, BrandingPatchSchema as Pt, HEADER_REQUEST_ID as Q, FeatureDefSchema as Qt, errorCodeSpec as R, ProductSettingsPatchSchema as Rt, WebhookEndpointCreateInputSchema as S, CHECKOUT_ERRORS as St, WebhookEndpointSchema as T, CheckoutSessionCreateInputSchema as Tt, CancelSubscriptionResponseSchema as U, TtlMinutesSchema as Ut, AccountUpsertResponseSchema as V, SETTINGS_LOCALES as Vt, CheckoutSessionResponseSchema as W, WebUrlSchema as Wt, HEADER_API_VERSION as X, CatalogSyncInputSchema as Xt, HEADER_ACTOR_REF as Y, CatalogSchema as Yt, HEADER_IDEMPOTENCY_KEY as Z, CatalogSyncResultSchema as Zt, hostedReadinessOf as _, StatsSchema as _t, DOCTOR_SEVERITIES as a, InvoiceSchema as at, WEBHOOK_ENDPOINT_STATUSES as b, PortalSessionCreateInputSchema as bt, DoctorHostedSchema as c, MANUAL_INVOICE_MAX_AMOUNT_MINOR as ct, DoctorSettingsSchema as d, manualInvoiceTotals as dt, PlanDefSchema as en, InvoiceIssueResponseSchema as et, DoctorSeveritySchema as f, splitInclusiveTax as ft, endpointDiagnosisOf as g, PaymentSchema as gt, buildDoctorReport as h, GrantSchema as ht, DOCTOR_REQUIRED_LEGAL_LINKS as i, InvoiceLineSchema as it, PLAN_SET_MODES as j, ProviderPayloadSchema as jt, generateWebhookSecret as k, ConsentSchema as kt, DoctorProviderSchema as l, ManualInvoiceInputSchema as lt, DoctorWarningSchema as m, GrantCreateInputSchema as mt, DOCTOR_PROVIDER_ENVIRONMENTS as n, PriceSchema as nn, ManualInvoiceResponseSchema as nt, DoctorCatalogSchema as o, InvoiceStatusSchema as ot, DoctorUnsellablePriceSchema as p, CancelSubscriptionInputSchema as pt, EventRecordSchema as q, returnOriginsOf as qt, DOCTOR_REQUIRED_BRANDING as r, InvoiceIssueInputSchema as rt, DoctorEndpointSchema as s, InvoiceVoidInputSchema as st, DOCTOR_PENDING_BACKLOG_MS as t, PriceDefSchema as tn, InvoiceVoidResponseSchema as tt, DoctorReportSchema as u, ManualInvoiceLineInputSchema as ut, DEFAULT_ENDPOINT_EVENT_TYPES as v, SubscriptionSchema as vt, WebhookEndpointRotateInputSchema as w, CheckoutPrefillSchema as wt, WEBHOOK_SECRET_PREFIX as x, PortalSessionSchema as xt, EventTypeSchema as y, PORTAL_SESSION_ERRORS as yt, isKnownErrorCode as z, ProductSettingsSchema as zt };