@stewardhq/sdk 0.1.0-rc.0

package/dist/_chunks/steward.js

@@ -0,0 +1,578 @@
+import { D as API_VERSION, L as ErrorResponseSchema, O as ActorRefSchema, p as AccountDeleteResponseSchema, w as EntitlementSnapshotSchema, y as AccountStateSchema } from "./events.js";
+import { $ as HEADER_SDK, B as AccountDetailSchema, C as WebhookEndpointListSchema, Et as CheckoutSessionCreatedSchema, H as BillingProfileResponseSchema, I as ResyncResultSchema, J as GrantCreateResponseSchema, Jt as AccountsRefreshResultSchema, K as EventListSchema, P as PlanSetResponseSchema, Q as HEADER_REQUEST_ID, R as errorCodeSpec, T as WebhookEndpointSchema, U as CancelSubscriptionResponseSchema, V as AccountUpsertResponseSchema, W as CheckoutSessionResponseSchema, X as HEADER_API_VERSION, Y as HEADER_ACTOR_REF, Yt as CatalogSchema, Z as HEADER_IDEMPOTENCY_KEY, Zt as CatalogSyncResultSchema, _t as StatsSchema, et as InvoiceIssueResponseSchema, nt as ManualInvoiceResponseSchema, q as EventRecordSchema, tt as InvoiceVoidResponseSchema, u as DoctorReportSchema, xt as PortalSessionSchema, zt as ProductSettingsSchema } from "./src.js";
+import { a as StewardNetworkError, n as StewardConfigError, r as StewardContractError, t as StewardApiError } from "./errors.js";
+import { z } from "zod";
+//#region ../contract/src/client.ts
+/**
+* `Retry-After` başlığını milisaniyeye çevirir: saniye (tam sayı) ya da HTTP
+* tarihi. Geçmiş tarih 0; okunamayan değer null.
+*/
+function parseRetryAfter(value, now = Date.now()) {
+	if (value === null || value === void 0) return null;
+	const trimmed = value.trim();
+	if (/^\d+$/.test(trimmed)) return Number(trimmed) * 1e3;
+	if (!/^[A-Za-z]/.test(trimmed)) return null;
+	const at = Date.parse(trimmed);
+	return Number.isNaN(at) ? null : Math.max(0, at - now);
+}
+const SDK_HEADER_VALUE = /^[\x21-\x7e][\x20-\x7e]{0,199}$/;
+function createBillingClient(options) {
+	const baseUrl = options.baseUrl.replace(/\/$/, "");
+	const doFetch = options.fetch ?? fetch;
+	const timeoutMs = options.timeoutMs ?? 1e4;
+	if (options.sdk !== void 0 && !SDK_HEADER_VALUE.test(options.sdk)) throw new Error("sdk: yazdırılabilir ASCII, en çok 200 karakter");
+	function meta(res) {
+		const out = {};
+		const requestId = res.headers.get(HEADER_REQUEST_ID);
+		if (requestId) out.requestId = requestId;
+		if (res.status === 429 || res.status === 503) {
+			const retryAfterMs = parseRetryAfter(res.headers.get("retry-after"));
+			if (retryAfterMs !== null) out.retryAfterMs = retryAfterMs;
+		}
+		return out;
+	}
+	async function send(method, path, body, call, extraHeaders) {
+		const headers = {
+			authorization: `Bearer ${options.apiKey}`,
+			accept: "application/json",
+			[HEADER_API_VERSION]: API_VERSION,
+			...extraHeaders
+		};
+		if (options.sdk !== void 0) headers[HEADER_SDK] = options.sdk;
+		if (method !== "GET") headers[HEADER_IDEMPOTENCY_KEY] = call?.idempotencyKey ?? globalThis.crypto.randomUUID();
+		if (call?.actorRef) headers[HEADER_ACTOR_REF] = call.actorRef;
+		if (body !== void 0) headers["content-type"] = "application/json";
+		try {
+			return { res: await doFetch(`${baseUrl}${path}`, {
+				method,
+				headers,
+				...body !== void 0 ? { body: JSON.stringify(body) } : {},
+				signal: AbortSignal.timeout(timeoutMs)
+			}) };
+		} catch (error) {
+			return {
+				ok: false,
+				status: 0,
+				error: error instanceof Error && (error.name === "TimeoutError" || error.name === "AbortError") ? "timeout" : "network_error"
+			};
+		}
+	}
+	async function failure(res) {
+		const json = await res.json().catch(() => null);
+		const parsed = ErrorResponseSchema.safeParse(json);
+		const { requestId, retryAfterMs } = meta(res);
+		const common = {
+			...requestId !== void 0 ? { requestId } : {},
+			...retryAfterMs !== void 0 ? { retryAfterMs } : {}
+		};
+		if (parsed.success) {
+			const { error, message, category, retryable } = parsed.data;
+			const bodyRequestId = requestId === void 0 ? parsed.data.requestId : void 0;
+			return {
+				ok: false,
+				status: res.status,
+				error,
+				...message !== void 0 ? { message } : {},
+				...category !== void 0 ? { category } : {},
+				...retryable !== void 0 ? { retryable } : {},
+				...bodyRequestId !== void 0 ? { requestId: bodyRequestId } : {},
+				...common
+			};
+		}
+		return {
+			ok: false,
+			status: res.status,
+			error: `http_${res.status}`,
+			...common
+		};
+	}
+	function success(res, data) {
+		const { requestId } = meta(res);
+		return {
+			ok: true,
+			status: res.status,
+			data,
+			...requestId !== void 0 ? { requestId } : {}
+		};
+	}
+	function invalid(res) {
+		const { requestId } = meta(res);
+		return {
+			ok: false,
+			status: res.status,
+			error: "invalid_response",
+			...requestId !== void 0 ? { requestId } : {}
+		};
+	}
+	async function call(schema, method, path, body, opts) {
+		const sent = await send(method, path, body, opts);
+		if (!("res" in sent)) return sent;
+		const { res } = sent;
+		if (!res.ok) return failure(res);
+		const json = await res.json().catch(() => void 0);
+		const parsed = schema.safeParse(json);
+		if (!parsed.success) return invalid(res);
+		return success(res, parsed.data);
+	}
+	async function empty(method, path, opts) {
+		const sent = await send(method, path, void 0, opts);
+		if (!("res" in sent)) return sent;
+		const { res } = sent;
+		if (!res.ok) return failure(res);
+		return success(res, null);
+	}
+	const ref = (value) => encodeURIComponent(value);
+	return {
+		getCatalog: () => call(CatalogSchema, "GET", "/v1/catalog"),
+		syncCatalog: (input, opts) => call(CatalogSyncResultSchema, "PUT", "/v1/admin/catalog", input, opts),
+		upsertAccount: (accountRef, input, opts) => call(AccountUpsertResponseSchema, "PUT", `/v1/accounts/${ref(accountRef)}`, input, opts),
+		getAccount: (accountRef, include = []) => call(AccountDetailSchema, "GET", `/v1/accounts/${ref(accountRef)}${include.length ? `?include=${include.join(",")}` : ""}`),
+		getEntitlements: (accountRef) => call(EntitlementSnapshotSchema, "GET", `/v1/accounts/${ref(accountRef)}/entitlements`),
+		/**
+		* Hesap durumu (`AccountState`). ETag = `"<version>"`; önceki yanıtın
+		* `etag`'i verilirse ve durum değişmediyse 304 → `{notModified: true}`.
+		*/
+		getAccountState: async (accountRef, opts = {}) => {
+			const sent = await send("GET", `/v1/accounts/${ref(accountRef)}/state`, void 0, void 0, opts.etag !== void 0 ? { "if-none-match": opts.etag } : void 0);
+			if (!("res" in sent)) return sent;
+			const { res } = sent;
+			const etag = res.headers.get("etag");
+			if (res.status === 304) {
+				const current = etag ?? opts.etag;
+				return current === void 0 ? invalid(res) : success(res, {
+					notModified: true,
+					etag: current
+				});
+			}
+			if (!res.ok) return failure(res);
+			const parsed = AccountStateSchema.safeParse(await res.json().catch(() => void 0));
+			if (!parsed.success) return invalid(res);
+			return success(res, {
+				notModified: false,
+				etag,
+				state: parsed.data
+			});
+		},
+		putBillingProfile: (accountRef, profile, opts) => call(BillingProfileResponseSchema, "PUT", `/v1/accounts/${ref(accountRef)}/billing-profile`, profile, opts),
+		/** Atomik plan (K6): aktif plan grant'leri → tek plan grant'i (`planCode: null` kaldırır); `strict`'te 409 `subscription_plan_higher`. */
+		setPlan: (accountRef, input, opts) => call(PlanSetResponseSchema, "PUT", `/v1/accounts/${ref(accountRef)}/plan`, input, opts),
+		/** Saklı durumu `account.state_changed` (`cause: "resync"`) olarak yeniden yayınlar; version değişmez (202). */
+		resync: (accountRef, opts) => call(ResyncResultSchema, "POST", `/v1/accounts/${ref(accountRef)}/resync`, void 0, opts),
+		/** KVKK anonimleştirme (F4e): `{ref, deletedAt}`; silinmişse 410 `account_deleted`, canlı abonelikte 409 `subscription_active`. */
+		deleteAccount: (accountRef, opts) => call(AccountDeleteResponseSchema, "DELETE", `/v1/accounts/${ref(accountRef)}`, void 0, opts),
+		createCheckoutSession: (accountRef, input, opts) => call(CheckoutSessionCreatedSchema, "POST", `/v1/accounts/${ref(accountRef)}/checkout-sessions`, input, opts),
+		getCheckoutSession: (id) => call(CheckoutSessionResponseSchema, "GET", `/v1/checkout-sessions/${ref(id)}`),
+		createPortalSession: (accountRef, input = {}, opts) => call(PortalSessionSchema, "POST", `/v1/accounts/${ref(accountRef)}/portal-sessions`, input, opts),
+		cancelSubscription: (id, input, opts) => call(CancelSubscriptionResponseSchema, "POST", `/v1/subscriptions/${ref(id)}/cancel`, input, opts),
+		createGrant: (accountRef, input, opts) => call(GrantCreateResponseSchema, "POST", `/v1/accounts/${ref(accountRef)}/grants`, input, opts),
+		revokeGrant: (id, opts) => empty("DELETE", `/v1/grants/${ref(id)}`, opts),
+		getStats: () => call(StatsSchema, "GET", "/v1/stats"),
+		doctor: () => call(DoctorReportSchema, "GET", "/v1/doctor"),
+		issueInvoice: (id, input, opts) => call(InvoiceIssueResponseSchema, "POST", `/v1/invoices/${ref(id)}/issue`, input, opts),
+		/** Manuel taslak fatura (F4f): profil gerekir (422 `billing_profile_required`); `issueInvoice` ile kesilir. */
+		createManualInvoice: (accountRef, input, opts) => call(ManualInvoiceResponseSchema, "POST", `/v1/accounts/${ref(accountRef)}/invoices`, input, opts),
+		/** Yalnızca manuel fatura (409 `invoice_has_payment` / `invoice_not_voidable`); `invoice.voided`. */
+		voidInvoice: (id, input, opts) => call(InvoiceVoidResponseSchema, "POST", `/v1/invoices/${ref(id)}/void`, input, opts),
+		getInvoiceDocument: async (id) => {
+			const sent = await send("GET", `/v1/invoices/${ref(id)}/document`, void 0, void 0);
+			if (!("res" in sent)) return sent;
+			const { res } = sent;
+			if (!res.ok) return failure(res);
+			return success(res, {
+				contentType: res.headers.get("content-type") ?? "application/octet-stream",
+				bytes: new Uint8Array(await res.arrayBuffer())
+			});
+		},
+		listEvents: (query = {}) => {
+			const params = new URLSearchParams();
+			if (query.accountRef) params.set("account", query.accountRef);
+			if (query.cursor) params.set("cursor", query.cursor);
+			if (query.limit) params.set("limit", String(query.limit));
+			const qs = params.toString();
+			return call(EventListSchema, "GET", `/v1/events${qs ? `?${qs}` : ""}`);
+		},
+		redeliverEvent: (id, opts) => call(EventRecordSchema, "POST", `/v1/events/${ref(id)}/redeliver`, void 0, opts),
+		getSettings: () => call(ProductSettingsSchema, "GET", "/v1/admin/settings"),
+		updateSettings: (patch, opts) => call(ProductSettingsSchema, "PATCH", "/v1/admin/settings", patch, opts),
+		listWebhookEndpoints: () => call(WebhookEndpointListSchema, "GET", "/v1/admin/webhook-endpoints"),
+		createWebhookEndpoint: (input, opts) => call(WebhookEndpointSchema, "POST", "/v1/admin/webhook-endpoints", input, opts),
+		rotateWebhookEndpointSecret: (id, input, opts) => call(WebhookEndpointSchema, "POST", `/v1/admin/webhook-endpoints/${ref(id)}/rotate`, input, opts),
+		deactivateWebhookEndpoint: (id, opts) => call(WebhookEndpointSchema, "POST", `/v1/admin/webhook-endpoints/${ref(id)}/deactivate`, void 0, opts)
+	};
+}
+//#endregion
+//#region src/retry.ts
+const RETRY_CLASSES = [
+	"network",
+	"5xx",
+	"429"
+];
+const BASE_DELAY_MS = 250;
+function retryPolicy(options = {}) {
+	const attempts = options.attempts ?? 2;
+	const maxDelayMs = options.maxDelayMs ?? 5e3;
+	const on = options.on ?? RETRY_CLASSES;
+	const problems = [];
+	if (!Number.isInteger(attempts) || attempts < 0) problems.push(`retries.attempts negatif olmayan tam sayı olmalı: ${attempts}`);
+	if (!Number.isFinite(maxDelayMs) || maxDelayMs < 0) problems.push(`retries.maxDelayMs negatif olmayan sayı olmalı: ${maxDelayMs}`);
+	for (const value of on) if (!RETRY_CLASSES.includes(value)) problems.push(`retries.on bilinmeyen sınıf: ${String(value)} (${RETRY_CLASSES.join(", ")})`);
+	if (problems.length > 0) throw new StewardConfigError({ message: `createSteward: ${problems.join("; ")}` });
+	return {
+		attempts,
+		on: new Set(on),
+		maxDelayMs,
+		sleep: options.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms))),
+		random: options.random ?? Math.random
+	};
+}
+/** Başarısız sonucun tekrar sınıfı; hiçbirine girmiyorsa null (4xx, sözleşme hatası). */
+function retryClassOf(failure) {
+	if (failure.status === 0) return "network";
+	if (failure.status === 429) return "429";
+	if (failure.status >= 500) return "5xx";
+	return null;
+}
+function shouldRetry(request, failure, policy) {
+	if (request.method !== "GET" && request.idempotencyKey === void 0) return false;
+	const kind = retryClassOf(failure);
+	if (kind === null || !policy.on.has(kind)) return false;
+	if (kind === "network") return true;
+	return (failure.retryable ?? errorCodeSpec(failure.error)?.retryable) !== false;
+}
+/** `retry`. tekrardan (1'den başlar) önceki bekleme, ms. */
+function retryDelayMs(retry, failure, policy) {
+	if (failure.retryAfterMs !== void 0) return Math.min(failure.retryAfterMs, policy.maxDelayMs);
+	const ceiling = Math.min(policy.maxDelayMs, BASE_DELAY_MS * 2 ** (retry - 1));
+	return Math.round(ceiling / 2 + policy.random() * ceiling / 2);
+}
+/** `send`'i politika izin verdikçe tekrarlar; son sonucu (başarılı ya da değil) döner. */
+async function withRetries(request, policy, send) {
+	let result = await send();
+	for (let retry = 1; retry <= policy.attempts && !result.ok && shouldRetry(request, result, policy); retry++) {
+		await policy.sleep(retryDelayMs(retry, result, policy));
+		result = await send();
+	}
+	return result;
+}
+//#endregion
+//#region src/steward.ts
+const SDK_HEADER = `@stewardhq/sdk/0.1.0-rc.0`;
+const MeSchema = z.object({
+	product: z.string(),
+	keyName: z.string(),
+	scope: z.enum(["product", "admin"])
+});
+const defaultEnv = () => globalThis.process?.env ?? {};
+function isHttpUrl(value) {
+	try {
+		const { protocol } = new URL(value);
+		return protocol === "http:" || protocol === "https:";
+	} catch {
+		return false;
+	}
+}
+/** Nesne ağacındaki her metodu, istek göndermeden `error(yol)` ile reddeden eşiyle değiştirir. */
+function rejectAll(api, error, prefix = "") {
+	return Object.fromEntries(Object.entries(api).map(([name, value]) => {
+		const path = `${prefix}${name}`;
+		if (typeof value === "function") return [name, () => Promise.reject(error(path))];
+		return [name, typeof value === "object" && value !== null ? rejectAll(value, error, `${path}.`) : value];
+	}));
+}
+function createSteward(options = {}) {
+	const env = options.env ?? defaultEnv();
+	const setting = (value, name) => {
+		const text = (value ?? env[name])?.trim();
+		return text === void 0 || text === "" ? void 0 : text;
+	};
+	const baseUrl = setting(options.baseUrl, "STEWARD_URL");
+	const apiKey = setting(options.apiKey, "STEWARD_API_KEY");
+	const adminBaseUrl = setting(options.adminBaseUrl, "STEWARD_ADMIN_URL");
+	const adminApiKey = setting(options.adminApiKey, "STEWARD_ADMIN_API_KEY");
+	const timeoutMs = options.timeoutMs ?? 1e4;
+	const adminOnly = baseUrl === void 0 && apiKey === void 0 && adminBaseUrl !== void 0 && adminApiKey !== void 0;
+	const problems = [];
+	if (!adminOnly) {
+		if (baseUrl === void 0) problems.push("STEWARD_URL (baseUrl) tanımlı değil");
+		else if (!isHttpUrl(baseUrl)) problems.push("STEWARD_URL (baseUrl) geçerli bir http(s) adresi değil");
+		if (apiKey === void 0) problems.push("STEWARD_API_KEY (apiKey) tanımlı değil");
+	}
+	if (adminBaseUrl !== void 0 && !isHttpUrl(adminBaseUrl)) problems.push("STEWARD_ADMIN_URL (adminBaseUrl) geçerli bir http(s) adresi değil");
+	if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) problems.push(`timeoutMs pozitif sayı olmalı: ${timeoutMs}`);
+	if (options.actorRef !== void 0 && !ActorRefSchema.safeParse(options.actorRef).success) problems.push("actorRef biçimi geçersiz (tür[:kimlik], ör. system, user:42)");
+	if (problems.length > 0) {
+		const hint = baseUrl === void 0 && apiKey === void 0 ? " (yalnızca admin.* için STEWARD_ADMIN_URL + STEWARD_ADMIN_API_KEY yeter)" : "";
+		throw new StewardConfigError({ message: `createSteward: ${problems.join("; ")}${hint}` });
+	}
+	const policy = retryPolicy(options.retries);
+	const doFetch = options.fetch ?? fetch;
+	const clientOptions = (target) => ({
+		...target,
+		timeoutMs,
+		sdk: SDK_HEADER,
+		...options.fetch !== void 0 ? { fetch: options.fetch } : {}
+	});
+	const adminTarget = adminBaseUrl !== void 0 && adminApiKey !== void 0 ? {
+		baseUrl: adminBaseUrl.replace(/\/$/, ""),
+		apiKey: adminApiKey
+	} : null;
+	const adminClient = adminTarget === null ? null : createBillingClient(clientOptions(adminTarget));
+	const productTarget = baseUrl !== void 0 && apiKey !== void 0 ? {
+		baseUrl: baseUrl.replace(/\/$/, ""),
+		apiKey
+	} : null;
+	const missingProduct = (name) => new StewardConfigError({ message: `steward.${name}: STEWARD_URL (baseUrl) ve STEWARD_API_KEY (apiKey) tanımlı değil; istemci yalnızca admin.* için yapılandırıldı` });
+	const raw = productTarget !== null ? createBillingClient(clientOptions(productTarget)) : rejectAll(createBillingClient(clientOptions({
+		baseUrl: "http://steward.invalid",
+		apiKey: "-"
+	})), (name) => missingProduct(`raw.${name}`));
+	const eitherTarget = productTarget ?? adminTarget;
+	const eitherClient = productTarget !== null ? raw : adminClient;
+	function requireAdmin() {
+		if (adminClient !== null && adminTarget !== null) return {
+			client: adminClient,
+			target: adminTarget
+		};
+		const missing = [...adminBaseUrl === void 0 ? ["STEWARD_ADMIN_URL (adminBaseUrl)"] : [], ...adminApiKey === void 0 ? ["STEWARD_ADMIN_API_KEY (adminApiKey)"] : []];
+		throw new StewardConfigError({ message: `steward.admin: ${missing.join(" ve ")} tanımlı değil` });
+	}
+	async function send(target, method, path, call, extraHeaders = {}) {
+		const headers = {
+			authorization: `Bearer ${target.apiKey}`,
+			accept: "application/json",
+			[HEADER_API_VERSION]: API_VERSION,
+			[HEADER_SDK]: SDK_HEADER,
+			...extraHeaders
+		};
+		if (call.idempotencyKey !== void 0) headers[HEADER_IDEMPOTENCY_KEY] = call.idempotencyKey;
+		if (call.actorRef !== void 0) headers[HEADER_ACTOR_REF] = call.actorRef;
+		try {
+			return { res: await doFetch(`${target.baseUrl}${path}`, {
+				method,
+				headers,
+				signal: AbortSignal.timeout(timeoutMs)
+			}) };
+		} catch (error) {
+			const name = typeof error === "object" && error !== null ? error.name : void 0;
+			return {
+				ok: false,
+				status: 0,
+				error: name === "TimeoutError" || name === "AbortError" ? "timeout" : "network_error"
+			};
+		}
+	}
+	function meta(res) {
+		const requestId = res.headers.get(HEADER_REQUEST_ID);
+		const retryAfterMs = res.status === 429 || res.status === 503 ? parseRetryAfter(res.headers.get("retry-after")) : null;
+		return {
+			...requestId ? { requestId } : {},
+			...retryAfterMs !== null ? { retryAfterMs } : {}
+		};
+	}
+	async function failureOf(res) {
+		const parsed = ErrorResponseSchema.safeParse(await res.json().catch(() => null));
+		const { requestId, retryAfterMs } = meta(res);
+		const common = { ...retryAfterMs !== void 0 ? { retryAfterMs } : {} };
+		if (!parsed.success) return {
+			ok: false,
+			status: res.status,
+			error: `http_${res.status}`,
+			...requestId !== void 0 ? { requestId } : {},
+			...common
+		};
+		const { error, message, category, retryable } = parsed.data;
+		const id = requestId ?? parsed.data.requestId;
+		return {
+			ok: false,
+			status: res.status,
+			error,
+			...message !== void 0 ? { message } : {},
+			...category !== void 0 ? { category } : {},
+			...retryable !== void 0 ? { retryable } : {},
+			...id !== void 0 ? { requestId: id } : {},
+			...common
+		};
+	}
+	function success(res, data) {
+		const { requestId } = meta(res);
+		return {
+			ok: true,
+			status: res.status,
+			data,
+			...requestId !== void 0 ? { requestId } : {}
+		};
+	}
+	function invalid(res) {
+		const { requestId } = meta(res);
+		return {
+			ok: false,
+			status: res.status,
+			error: "invalid_response",
+			...requestId !== void 0 ? { requestId } : {}
+		};
+	}
+	async function sendParsed(target, method, path, schema, call) {
+		const sent = await send(target, method, path, call);
+		if (!("res" in sent)) return sent;
+		if (!sent.res.ok) return failureOf(sent.res);
+		const parsed = schema.safeParse(await sent.res.json().catch(() => void 0));
+		return parsed.success ? success(sent.res, parsed.data) : invalid(sent.res);
+	}
+	async function readCatalog(etag) {
+		const sent = await send(productTarget, "GET", "/v1/catalog", {}, etag !== void 0 ? { "if-none-match": etag } : {});
+		if (!("res" in sent)) return sent;
+		const { res } = sent;
+		const responseEtag = res.headers.get("etag");
+		if (res.status === 304) {
+			const current = responseEtag ?? etag;
+			return current === void 0 ? invalid(res) : success(res, {
+				notModified: true,
+				etag: current
+			});
+		}
+		if (!res.ok) return failureOf(res);
+		const parsed = CatalogSchema.safeParse(await res.json().catch(() => void 0));
+		return parsed.success ? success(res, {
+			notModified: false,
+			etag: responseEtag,
+			catalog: parsed.data
+		}) : invalid(res);
+	}
+	function toError(failure) {
+		const context = {
+			...failure.requestId !== void 0 ? { requestId: failure.requestId } : {},
+			...failure.retryAfterMs !== void 0 ? { retryAfterMs: failure.retryAfterMs } : {}
+		};
+		if (failure.status === 0) return new StewardNetworkError({
+			code: failure.error === "timeout" ? "timeout" : "network_error",
+			...context
+		});
+		if (failure.error === "invalid_response") return new StewardContractError({
+			httpStatus: failure.status,
+			...context
+		});
+		return new StewardApiError({
+			code: failure.error,
+			httpStatus: failure.status,
+			...failure.message !== void 0 ? { message: failure.message } : {},
+			...failure.category !== void 0 ? { category: failure.category } : {},
+			...failure.retryable !== void 0 ? { retryable: failure.retryable } : {},
+			...context
+		});
+	}
+	async function run(method, call, attempt) {
+		let effective = {};
+		if (method !== "GET") {
+			const actorRef = call?.actorRef ?? options.actorRef;
+			if (actorRef === void 0) throw new StewardConfigError({
+				code: "actor_ref_required",
+				message: "actorRef yok: createSteward({ actorRef }) ya da çağrıda { actorRef } verin (tür[:kimlik], ör. user:42, system)"
+			});
+			if (!ActorRefSchema.safeParse(actorRef).success) throw new StewardConfigError({
+				code: "invalid_actor_ref",
+				message: "actorRef biçimi geçersiz (tür[:kimlik], ör. user:42, system)"
+			});
+			effective = {
+				idempotencyKey: call?.idempotencyKey ?? globalThis.crypto.randomUUID(),
+				actorRef
+			};
+		}
+		const result = await withRetries({
+			method,
+			...effective.idempotencyKey !== void 0 ? { idempotencyKey: effective.idempotencyKey } : {}
+		}, policy, () => attempt(effective));
+		if (result.ok) return result.data;
+		throw toError(result);
+	}
+	const read = (attempt) => run("GET", void 0, attempt);
+	const productApi = {
+		accounts: {
+			upsert: (ref, input, call) => run("PUT", call, (c) => raw.upsertAccount(ref, input, c)),
+			get: (ref, opts = {}) => read(() => raw.getAccount(ref, opts.include)),
+			state: async (ref) => {
+				const result = await read(() => raw.getAccountState(ref));
+				if (result.notModified) throw new StewardContractError({ httpStatus: 304 });
+				return result.state;
+			},
+			readState: (ref, opts = {}) => read(() => raw.getAccountState(ref, opts.etag !== void 0 ? { etag: opts.etag } : {})),
+			entitlements: (ref) => read(() => raw.getEntitlements(ref)),
+			putBillingProfile: (ref, profile, call) => run("PUT", call, (c) => raw.putBillingProfile(ref, profile, c)),
+			setPlan: (ref, input, call) => run("PUT", call, (c) => raw.setPlan(ref, input, c)),
+			resync: (ref, call) => run("POST", call, (c) => raw.resync(ref, c)),
+			delete: (ref, call) => run("DELETE", call, (c) => raw.deleteAccount(ref, c))
+		},
+		checkoutSessions: {
+			create: (ref, input, call) => run("POST", call, (c) => raw.createCheckoutSession(ref, input, c)),
+			get: (id) => read(() => raw.getCheckoutSession(id))
+		},
+		portalSessions: { create: (ref, input = {}, call) => run("POST", call, (c) => raw.createPortalSession(ref, input, c)) },
+		subscriptions: { cancel: (id, input, call) => run("POST", call, (c) => raw.cancelSubscription(id, input, c)) },
+		grants: {
+			create: (ref, input, call) => run("POST", call, (c) => raw.createGrant(ref, input, c)),
+			revoke: async (id, call) => {
+				await run("DELETE", call, (c) => raw.revokeGrant(id, c));
+			}
+		},
+		invoices: {
+			issue: (id, input, call) => run("POST", call, (c) => raw.issueInvoice(id, input, c)),
+			document: (id) => read(() => raw.getInvoiceDocument(id)),
+			createManual: (ref, input, call) => run("POST", call, (c) => raw.createManualInvoice(ref, input, c)),
+			void: (id, input, call) => run("POST", call, (c) => raw.voidInvoice(id, input, c))
+		},
+		catalog: {
+			get: () => read(() => raw.getCatalog()),
+			read: (opts = {}) => read(() => readCatalog(opts.etag))
+		},
+		events: {
+			list: (query = {}) => read(() => raw.listEvents(query)),
+			redeliver: (id, call) => run("POST", call, (c) => raw.redeliverEvent(id, c))
+		},
+		stats: () => read(() => raw.getStats())
+	};
+	return {
+		...productTarget !== null ? productApi : rejectAll(productApi, missingProduct),
+		me: () => read(() => sendParsed(eitherTarget, "GET", "/v1/me", MeSchema, {})),
+		doctor: () => read(() => eitherClient.doctor()),
+		admin: {
+			catalog: { sync: async (input, call) => {
+				const { client } = requireAdmin();
+				return run("PUT", call, (c) => client.syncCatalog(input, c));
+			} },
+			accounts: { refresh: async (call) => {
+				const { target } = requireAdmin();
+				return run("POST", call, (c) => sendParsed(target, "POST", "/v1/admin/accounts/refresh", AccountsRefreshResultSchema, c));
+			} },
+			settings: {
+				get: async () => {
+					const { client } = requireAdmin();
+					return read(() => client.getSettings());
+				},
+				update: async (patch, call) => {
+					const { client } = requireAdmin();
+					return run("PATCH", call, (c) => client.updateSettings(patch, c));
+				}
+			},
+			endpoints: {
+				list: async () => {
+					const { client } = requireAdmin();
+					return read(() => client.listWebhookEndpoints());
+				},
+				create: async (input, call) => {
+					const { client } = requireAdmin();
+					return run("POST", call, (c) => client.createWebhookEndpoint(input, c));
+				},
+				rotate: async (id, input, call) => {
+					const { client } = requireAdmin();
+					return run("POST", call, (c) => client.rotateWebhookEndpointSecret(id, input, c));
+				},
+				deactivate: async (id, call) => {
+					const { client } = requireAdmin();
+					return run("POST", call, (c) => client.deactivateWebhookEndpoint(id, c));
+				}
+			}
+		},
+		raw
+	};
+}
+//#endregion
+export { createBillingClient as n, parseRetryAfter as r, createSteward as t };

package/dist/_chunks/validators.d.ts

@@ -0,0 +1,23 @@
+//#region ../contract/src/validators.d.ts
+/**
+ * T.C. kimlik numarası: 11 hane, ilk hane 0 değil;
+ * 10. hane = ((1.+3.+5.+7.+9.) × 7 − (2.+4.+6.+8.)) mod 10,
+ * 11. hane = (ilk 10 hanenin toplamı) mod 10.
+ */
+declare function isValidTckn(value: unknown): boolean;
+/**
+ * Vergi kimlik numarası (GİB): 10 hane; i = 0…8 için
+ * t = (hane + 9 − i) mod 10, p = t × 2^(9 − i) mod 9 (t ≠ 0 ve p = 0 ise 9),
+ * son hane = (10 − Σp mod 10) mod 10.
+ */
+declare function isValidVkn(value: unknown): boolean;
+/**
+ * E.164 telefon: `+`, sıfırla başlamayan ülke kodu, toplam 8–15 hane
+ * (steward fatura profili şemasıyla aynı). `{country: "TR"}`: `+90` ve 10 hane
+ * (iyzico'nun istediği biçim).
+ */
+declare function isE164(value: unknown, options?: {
+  country?: "TR";
+}): boolean;
+//#endregion
+export { isValidTckn as n, isValidVkn as r, isE164 as t };