npm - @vennyx/solicrm-mcp - Versions diffs - 0.1.0 - Mend

@vennyx/solicrm-mcp 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (6) hide show

package/dist/index.js ADDED Viewed

@@ -0,0 +1,4140 @@
+import { z } from "zod";
+import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { WebStandardStreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+//#region packages/contracts/src/fields.ts
+/**
+* Alan kataloğu — `field_key` → kolon/tip/yetenek eşlemesi.
+*
+* NEDEN VAR: kaydedilmiş görünümler, filtreler, sıralama, CSV içe/dışa aktarma
+* ve MCP/SDK tip üretimi HEPSİ bu katalogdan okur. Hiçbir yerde kullanıcıdan
+* gelen bir değer doğrudan kolon adına dönüşmez — `resolveField()` bilinmeyen
+* anahtar için `undefined` döner ve çağıran 400 verir. Bu, SQL enjeksiyonu ve
+* bilgi sızdırmanın sınırıdır.
+*
+* İLERİYE DÖNÜK: özel alanlar (custom fields) eklendiğinde katalog runtime'da
+* tenant'ın tanımlarıyla genişletilir; tüketici kod değişmez (bkz. spec §6.7).
+*/
+const CRM_RESOURCES = [
+	"contacts",
+	"companies",
+	"deals",
+	"tasks"
+];
+const FIELD_CATALOG = {
+	contacts: {
+		first_name: {
+			column: "first_name",
+			type: "text",
+			filterable: true,
+			sortable: true
+		},
+		last_name: {
+			column: "last_name",
+			type: "text",
+			filterable: true,
+			sortable: true
+		},
+		email: {
+			column: "email",
+			type: "text",
+			filterable: true,
+			sortable: true
+		},
+		phone: {
+			column: "phone",
+			type: "text",
+			filterable: true,
+			sortable: false
+		},
+		job_title: {
+			column: "job_title",
+			type: "text",
+			filterable: true,
+			sortable: true
+		},
+		city: {
+			column: "city",
+			type: "text",
+			filterable: true,
+			sortable: true
+		},
+		country: {
+			column: "country",
+			type: "text",
+			filterable: true,
+			sortable: true
+		},
+		status: {
+			column: "status",
+			type: "enum",
+			filterable: true,
+			sortable: true,
+			values: [
+				"lead",
+				"active",
+				"inactive"
+			]
+		},
+		company_id: {
+			column: "company_id",
+			type: "uuid",
+			filterable: true,
+			sortable: false
+		},
+		owner_user_id: {
+			column: "owner_user_id",
+			type: "uuid",
+			filterable: true,
+			sortable: false
+		},
+		created_at: {
+			column: "created_at",
+			type: "date",
+			filterable: true,
+			sortable: true
+		}
+	},
+	companies: {
+		name: {
+			column: "name",
+			type: "text",
+			filterable: true,
+			sortable: true
+		},
+		domain: {
+			column: "domain",
+			type: "text",
+			filterable: true,
+			sortable: true
+		},
+		industry: {
+			column: "industry",
+			type: "text",
+			filterable: true,
+			sortable: true
+		},
+		city: {
+			column: "city",
+			type: "text",
+			filterable: true,
+			sortable: true
+		},
+		country: {
+			column: "country",
+			type: "text",
+			filterable: true,
+			sortable: true
+		},
+		annual_revenue: {
+			column: "annual_revenue",
+			type: "money",
+			filterable: true,
+			sortable: true
+		},
+		owner_user_id: {
+			column: "owner_user_id",
+			type: "uuid",
+			filterable: true,
+			sortable: false
+		},
+		created_at: {
+			column: "created_at",
+			type: "date",
+			filterable: true,
+			sortable: true
+		}
+	},
+	deals: {
+		title: {
+			column: "title",
+			type: "text",
+			filterable: true,
+			sortable: true
+		},
+		amount: {
+			column: "amount",
+			type: "money",
+			filterable: true,
+			sortable: true
+		},
+		currency_code: {
+			column: "currency_code",
+			type: "text",
+			filterable: true,
+			sortable: false
+		},
+		stage_id: {
+			column: "stage_id",
+			type: "uuid",
+			filterable: true,
+			sortable: false
+		},
+		pipeline_id: {
+			column: "pipeline_id",
+			type: "uuid",
+			filterable: true,
+			sortable: false
+		},
+		company_id: {
+			column: "company_id",
+			type: "uuid",
+			filterable: true,
+			sortable: false
+		},
+		outcome: {
+			column: "outcome",
+			type: "enum",
+			filterable: true,
+			sortable: true,
+			values: [
+				"open",
+				"won",
+				"lost"
+			]
+		},
+		expected_close_date: {
+			column: "expected_close_date",
+			type: "date",
+			filterable: true,
+			sortable: true
+		},
+		owner_user_id: {
+			column: "owner_user_id",
+			type: "uuid",
+			filterable: true,
+			sortable: false
+		},
+		created_at: {
+			column: "created_at",
+			type: "date",
+			filterable: true,
+			sortable: true
+		}
+	},
+	tasks: {
+		title: {
+			column: "title",
+			type: "text",
+			filterable: true,
+			sortable: true
+		},
+		due_at: {
+			column: "due_at",
+			type: "date",
+			filterable: true,
+			sortable: true
+		},
+		completed_at: {
+			column: "completed_at",
+			type: "date",
+			filterable: true,
+			sortable: true
+		},
+		priority: {
+			column: "priority",
+			type: "enum",
+			filterable: true,
+			sortable: true,
+			values: [
+				"low",
+				"normal",
+				"high",
+				"urgent"
+			]
+		},
+		assignee_user_id: {
+			column: "assignee_user_id",
+			type: "uuid",
+			filterable: true,
+			sortable: false
+		},
+		created_at: {
+			column: "created_at",
+			type: "date",
+			filterable: true,
+			sortable: true
+		}
+	}
+};
+/**
+* Bir `field_key`'i katalogdan çözer. Bilinmeyen anahtar → `undefined`
+* (çağıran 400 döner). ASLA anahtarı kolon adı olarak varsaymaz.
+*/
+function resolveField(resource, key) {
+	const catalog = FIELD_CATALOG[resource];
+	return Object.hasOwn(catalog, key) ? catalog[key] : void 0;
+}
+//#endregion
+//#region packages/contracts/src/crm.ts
+/**
+* CRM domain genelinde paylaşılan zod katalogları (spec §6.2/§6.3).
+*
+* NOT — Task 3 (deals) genişletmesi: `targetTypeSchema` artık `'deal'`
+* içeriyor (tek satırlık, geriye uyumlu genişleme; hiçbir tüketici tipi
+* DARALTILMADI, yalnız genişledi — bkz. `apps/api/src/lib/polymorphic-target.ts`,
+* `packages/db/drizzle/0028_deals_guard.sql`'daki `CREATE OR REPLACE FUNCTION`).
+*
+* NOT — spec'in tam liste vermediği katalog değerleri (bu dosyanın kararı):
+* `contactSourceSchema` ve `companySizeSchema` spec §6.2'de yalnız "text+katalog"
+* / kendine özgü alan olarak anılıyor, değer kümesi verilmiyor — makul bir
+* başlangıç kümesi seçildi (bkz. plan "Yeni ortak altyapı kararları / D").
+*/
+const targetTypeSchema = z.enum([
+	"contact",
+	"company",
+	"deal"
+], "geçerli bir hedef türü olmalı (contact, company, deal)");
+/** Fırsat sonucu (spec §6.2) — DB'de `deals_outcome_check` CHECK kısıtıyla eşleşir */
+const dealOutcomeSchema = z.enum([
+	"open",
+	"won",
+	"lost"
+], "geçerli bir sonuç olmalı (open, won, lost)");
+const contactStatusSchema = z.enum([
+	"lead",
+	"active",
+	"inactive"
+], "geçerli bir durum olmalı (lead, active, inactive)");
+/** Spec'te tam liste verilmemiş — makul bir başlangıç kümesi (bkz. dosya başı NOT) */
+const contactSourceSchema = z.enum([
+	"website",
+	"referral",
+	"cold_outreach",
+	"event",
+	"social_media",
+	"other"
+], "geçerli bir kaynak olmalı");
+/** Spec'te tam liste verilmemiş — makul bir başlangıç kümesi (bkz. dosya başı NOT) */
+const companySizeSchema = z.enum([
+	"1-10",
+	"11-50",
+	"51-200",
+	"201-500",
+	"500+"
+], "geçerli bir şirket büyüklüğü olmalı");
+const sortDirectionSchema = z.enum(["asc", "desc"], "yön asc veya desc olmalı");
+const filterOperandSchema = z.enum([
+	"eq",
+	"neq",
+	"contains",
+	"starts_with",
+	"gt",
+	"gte",
+	"lt",
+	"lte",
+	"in",
+	"is_null",
+	"is_not_null"
+], "geçerli bir karşılaştırma operatörü olmalı");
+/**
+* Aktivite türü (spec §6.2) — `stage_change` Faz 5 Task 3'ün `/move` ucunun
+* ürettiği otomatik aktiviteyle eşleşir (bkz. `apps/api/src/routes/deals.ts`).
+*/
+const activityKindSchema = z.enum([
+	"call",
+	"meeting",
+	"email",
+	"note",
+	"task",
+	"stage_change"
+], "geçerli bir aktivite türü olmalı (call, meeting, email, note, task, stage_change)");
+/** Spec'te tam liste verilmemiş — makul bir başlangıç kümesi (bkz. plan "Yeni ortak altyapı kararları / D") */
+const taskStatusSchema = z.enum([
+	"todo",
+	"in_progress",
+	"done",
+	"cancelled"
+], "geçerli bir durum olmalı (todo, in_progress, done, cancelled)");
+/** Spec'in verdiği tam liste (§6.2) */
+const taskPrioritySchema = z.enum([
+	"low",
+	"normal",
+	"high",
+	"urgent"
+], "geçerli bir öncelik olmalı (low, normal, high, urgent)");
+z.object({
+	targetType: targetTypeSchema,
+	targetId: z.uuid("geçerli bir hedef kimliği olmalı")
+});
+/**
+* Kaydedilmiş görünüm katalogları (spec §6.5, Faz 5 Task 5).
+* `savedViewResourceSchema` = `CRM_RESOURCES`'ın zod karşılığı — `fields.ts`
+* DEĞİŞTİRİLMEDEN (`CRM_RESOURCES` sabiti oradan İÇE AKTARILIR, yeniden
+* TANIMLANMAZ, tek gerçek kaynak korunur).
+*/
+const savedViewResourceSchema = z.enum(CRM_RESOURCES, "geçerli bir CRM kaynağı olmalı (contacts, companies, deals, tasks)");
+const savedViewLayoutSchema = z.enum(["table", "kanban"], "geçerli bir düzen olmalı (table, kanban)");
+const savedViewVisibilitySchema = z.enum(["private", "tenant"], "geçerli bir görünürlük olmalı (private, tenant)");
+const filterLogicalOperatorSchema = z.enum([
+	"and",
+	"or",
+	"not"
+], "geçerli bir mantıksal operatör olmalı (and, or, not)");
+/**
+* `numeric(18,2)` DB kolonuna eşlenen PARA alanları için ORTAK biçim
+* doğrulaması (spec §6.1 — para asla native `number`/aritmetikle hesaplanmaz,
+* yalnız string olarak taşınır, `bignumber.js` dışında ASLA işlenmez).
+*
+* [Fix round 2 — doğruluk reviewer'ının bulduğu, Task 3'ün `deals.amount`
+* fix'iyle BİREBİR aynı sınıf hata]: `companies.annual_revenue` DB'de `text`
+* kolondu ama `FIELD_CATALOG.companies.annual_revenue` `type:'money'`,
+* `sortable:true`, `filterable:true` ilan ediyordu — `text` kolonda `ORDER
+* BY`/`>`/`<` LEXICOGRAPHIC karşılaştırma yapar (`"100" < "20" < "9"`), bu
+* SESSİZ bir doğruluk hatasıdır. Bu şema, Task 3'ün önceden yalnız
+* `deals.ts` içinde TANIMLADIĞI `dealAmountSchema`'nın (aynı kısıtlar: en
+* fazla 2 ondalık basamak, en fazla 18 anlamlı basamak — `numeric(18,2)`
+* sınırı) buraya TAŞINMIŞ/PAYLAŞILAN hâlidir — İKİ ayrı DB kolonu (deals.amount,
+* companies.annual_revenue) TEK doğrulama mantığından geçer (drift riski
+* olmasın diye, DRY).
+*/
+const numericMoneySchema = z.string().trim().max(40, "en fazla 40 karakter olabilir").regex(/^-?\d+(\.\d{1,2})?$/, "geçerli bir ondalık tutar olmalı, en fazla 2 ondalık basamak (örn. 1234.56)").refine((v) => v.replace(/[-.]/g, "").length <= 18, "en fazla 18 anlamlı basamak olabilir (numeric(18,2) sınırı)");
+const pageQuerySchema = z.object({
+	cursor: z.string().max(2e3, "geçersiz sayfalama imleci").optional(),
+	limit: z.coerce.number("sayı olmalı").int("tam sayı olmalı").min(1, "en az 1 olmalı").max(100, `en fazla 100 olabilir`).optional()
+});
+function pagedResponseSchema(itemSchema) {
+	return z.object({
+		items: z.array(itemSchema),
+		nextCursor: z.string().nullable(),
+		hasMore: z.boolean()
+	});
+}
+//#endregion
+//#region packages/contracts/src/notes.ts
+/**
+* Not (note) sözleşmeleri (spec §6.2/§6.3) — `tasks.ts`'in BİREBİR aynı kalıbı,
+* `assigneeUserId` yerine `authorUserId`, `status`/`priority` YOK.
+*/
+const noteBodySchema = z.record(z.string(), z.unknown());
+const createNoteRequestSchema = z.object({
+	title: z.string().trim().max(200, "en fazla 200 karakter olabilir").optional(),
+	body: noteBodySchema.optional(),
+	bodyFormat: z.string().trim().max(40, "en fazla 40 karakter olabilir").optional(),
+	authorUserId: z.uuid("geçerli bir kullanıcı kimliği olmalı").optional()
+});
+z.object({
+	title: z.string().trim().max(200, "en fazla 200 karakter olabilir").nullable().optional(),
+	body: noteBodySchema.optional(),
+	bodyFormat: z.string().trim().max(40, "en fazla 40 karakter olabilir").optional(),
+	authorUserId: z.uuid("geçerli bir kullanıcı kimliği olmalı").nullable().optional()
+});
+const noteLinkResponseSchema = z.object({
+	id: z.uuid(),
+	targetType: targetTypeSchema,
+	targetId: z.uuid(),
+	targetCachedName: z.string(),
+	createdAt: z.iso.datetime()
+});
+const noteResponseSchema = z.object({
+	id: z.uuid(),
+	title: z.string().nullable(),
+	body: noteBodySchema.nullable(),
+	bodyFormat: z.string().nullable(),
+	authorUserId: z.uuid().nullable(),
+	createdAt: z.iso.datetime(),
+	updatedAt: z.iso.datetime()
+});
+noteResponseSchema.extend({ links: z.array(noteLinkResponseSchema) });
+pagedResponseSchema(noteResponseSchema);
+//#endregion
+//#region packages/contracts/src/tasks.ts
+/**
+* Görev (task) sözleşmeleri (spec §6.2/§6.3).
+*
+* KRİTİK KURAL: `dueAt`/`completedAt` kullanıcının Date/Time Handling
+* Guideline'ına uygun olarak `apps/api/src/routes/tasks.ts`'te luxon
+* (`DateTime`) ile dönüştürülür — burada yalnız ISO 8601 biçim doğrulaması
+* yapılır (zod), gerçek dönüşüm route katmanının işidir.
+*
+* `assigneeUserId` PATCH'te `null` gönderilerek atamanın KALDIRILMASI
+* desteklenir (`nullable().optional()`) — `undefined` "değiştirme", `null`
+* "kaldır" anlamına gelir (companies/contacts/deals'ın PARTIAL şemalarından
+* FARKLI bir kalıp, çünkü onlarda "atamayı kaldır" ihtiyacı yoktu).
+*/
+const taskBodySchema = z.record(z.string(), z.unknown());
+const createTaskRequestSchema = z.object({
+	title: z.string().trim().min(1, "başlık gerekli").max(200, "en fazla 200 karakter olabilir"),
+	body: taskBodySchema.optional(),
+	bodyFormat: z.string().trim().max(40, "en fazla 40 karakter olabilir").optional(),
+	dueAt: z.iso.datetime("geçerli bir tarih olmalı").optional(),
+	status: taskStatusSchema.default("todo"),
+	priority: taskPrioritySchema.default("normal"),
+	assigneeUserId: z.uuid("geçerli bir kullanıcı kimliği olmalı").optional()
+});
+z.object({
+	title: z.string().trim().min(1, "başlık gerekli").max(200, "en fazla 200 karakter olabilir").optional(),
+	body: taskBodySchema.optional(),
+	bodyFormat: z.string().trim().max(40, "en fazla 40 karakter olabilir").optional(),
+	dueAt: z.iso.datetime("geçerli bir tarih olmalı").nullable().optional(),
+	status: taskStatusSchema.optional(),
+	priority: taskPrioritySchema.optional(),
+	assigneeUserId: z.uuid("geçerli bir kullanıcı kimliği olmalı").nullable().optional()
+});
+const taskLinkResponseSchema = z.object({
+	id: z.uuid(),
+	targetType: targetTypeSchema,
+	targetId: z.uuid(),
+	targetCachedName: z.string(),
+	createdAt: z.iso.datetime()
+});
+const taskResponseSchema = z.object({
+	id: z.uuid(),
+	title: z.string(),
+	body: taskBodySchema.nullable(),
+	bodyFormat: z.string().nullable(),
+	dueAt: z.iso.datetime().nullable(),
+	completedAt: z.iso.datetime().nullable(),
+	status: taskStatusSchema,
+	priority: taskPrioritySchema,
+	assigneeUserId: z.uuid().nullable(),
+	createdAt: z.iso.datetime(),
+	updatedAt: z.iso.datetime()
+});
+taskResponseSchema.extend({ links: z.array(taskLinkResponseSchema) });
+pagedResponseSchema(taskResponseSchema);
+//#endregion
+//#region packages/contracts/src/activities.ts
+/**
+* Aktivite (activity) sözleşmeleri (spec §6.2/§6.3).
+*
+* KRİTİK KURAL: `updateActivityRequestSchema` `.strict()`'tir ve `kind`/
+* `targetType`/`targetId`'yi hiç TANIMLAMAZ — bir aktivitenin hedefi/türü
+* OLUŞTURULDUKTAN SONRA değiştirilemez (bkz. `packages/db/src/schema/activities.ts`
+* dosya başı yorumu, `apps/api/src/routes/activities.ts`). `deals.ts`'teki
+* `updateDealRequestSchema`'nın AYNI kalıbı (bkz. o dosyanın dosya başı yorumu).
+*
+* TEKNİK BORÇ KAPANIŞI (Faz 6 Task 7): `GET /v1/tenants/:id/targets/
+* :targetType/:targetId/timeline` ucu Faz 5 Task 4'ün plan dışı eklediği bir
+* uçtu ve YANIT ZARFI için bir sözleşme şeması export ETMEMİŞTİ — SPA
+* (`apps/dashboard/src/lib/timeline-one-shot.ts`) bu yüzden kendi elle yazılmış
+* bir tipe (`.array()` bileşimi) doğrulama yapıyordu. `targetTimelineResponseSchema`
+* artık TEK gerçek kaynak; iki taraf da (`apps/api/src/routes/activities.ts`
+* VE SPA) buradan okur. `TIMELINE_LIMIT_PER_RESOURCE` de AYNI nedenle burada:
+* backend'in `activities.ts`'teki elle kopyalanmış `= 50` sabiti ile SPA'nın
+* `timeline-panel.tsx`'teki `TIMELINE_ONE_SHOT_CAP = 50` sabiti birbirinden
+* BAĞIMSIZ, elle senkron tutuluyordu (drift riski, bkz. Faz 6 Task 6 raporu
+* "Endişeler").
+*/
+const activityPropertiesSchema = z.record(z.string(), z.unknown());
+const createActivityRequestSchema = z.object({
+	kind: activityKindSchema,
+	subject: z.string().trim().max(200, "en fazla 200 karakter olabilir").optional(),
+	body: z.string().trim().max(1e4, "en fazla 10000 karakter olabilir").optional(),
+	happensAt: z.iso.datetime("geçerli bir tarih olmalı"),
+	durationMinutes: z.number("sayı olmalı").int("tam sayı olmalı").min(0, "negatif olamaz").max(43200, "en fazla 43200 dakika (30 gün) olabilir").optional(),
+	targetType: targetTypeSchema,
+	targetId: z.uuid("geçerli bir hedef kimliği olmalı"),
+	actorUserId: z.uuid("geçerli bir kullanıcı kimliği olmalı").optional(),
+	properties: activityPropertiesSchema.optional()
+});
+z.object({
+	subject: z.string().trim().max(200, "en fazla 200 karakter olabilir").optional(),
+	body: z.string().trim().max(1e4, "en fazla 10000 karakter olabilir").optional(),
+	happensAt: z.iso.datetime("geçerli bir tarih olmalı").optional(),
+	durationMinutes: z.number("sayı olmalı").int("tam sayı olmalı").min(0, "negatif olamaz").max(43200, "en fazla 43200 dakika (30 gün) olabilir").optional(),
+	actorUserId: z.uuid("geçerli bir kullanıcı kimliği olmalı").optional(),
+	properties: activityPropertiesSchema.optional()
+}).strict();
+const activityResponseSchema = z.object({
+	id: z.uuid(),
+	kind: activityKindSchema,
+	subject: z.string().nullable(),
+	body: z.string().nullable(),
+	happensAt: z.iso.datetime(),
+	durationMinutes: z.number().nullable(),
+	targetType: targetTypeSchema,
+	targetId: z.uuid(),
+	targetCachedName: z.string(),
+	properties: activityPropertiesSchema,
+	actorUserId: z.uuid().nullable(),
+	createdAt: z.iso.datetime(),
+	updatedAt: z.iso.datetime()
+});
+pagedResponseSchema(activityResponseSchema);
+z.object({
+	activities: activityResponseSchema.array(),
+	tasks: taskResponseSchema.array(),
+	notes: noteResponseSchema.array()
+});
+clone();
+var isNumeric = /^-?(?:\d+(?:\.\d*)?|\.\d+)(?:e[+-]?\d+)?$/i;
+var mathceil = Math.ceil;
+var mathfloor = Math.floor;
+var bignumberError = "[BigNumber Error] ";
+var BASE = 0x5af3107a4000;
+var LOG_BASE = 14;
+var MAX_SAFE_INTEGER = 9007199254740991;
+var POWS_TEN = [
+	1,
+	10,
+	100,
+	1e3,
+	1e4,
+	1e5,
+	1e6,
+	1e7,
+	1e8,
+	1e9,
+	1e10,
+	1e11,
+	0xe8d4a51000,
+	0x9184e72a000
+];
+var SQRT_BASE = 1e7;
+var MAX = 1e9;
+function clone(configObject) {
+	var div, convertBase, basePrefix = /^(-?)0([xbo])(?=[^.])/i, isInfinityOrNaN = /^-?(Infinity|NaN)$/, whitespaceOrPlus = /^\s*\+(?!-)|^\s+|\s+$/g, P = BigNumber.prototype = {
+		constructor: BigNumber,
+		toString: null,
+		valueOf: null
+	}, ONE = new BigNumber(1), DECIMAL_PLACES = 20, ROUNDING_MODE = 4, TO_EXP_NEG = -7, TO_EXP_POS = 21, MIN_EXP = -1e7, MAX_EXP = 1e7, CRYPTO = false, STRICT = true, MODULO_MODE = 1, POW_PRECISION = 0, FORMAT = {
+		prefix: "",
+		negativeSign: "-",
+		positiveSign: "",
+		groupSeparator: ",",
+		groupSize: 3,
+		secondaryGroupSize: 0,
+		decimalSeparator: ".",
+		fractionGroupSeparator: "",
+		fractionGroupSize: 0,
+		suffix: ""
+	}, ALPHABET = "0123456789abcdefghijklmnopqrstuvwxyz";
+	function BigNumber(v, b) {
+		var e, i, str, t, x = this;
+		if (!(x instanceof BigNumber)) return new BigNumber(v, b);
+		t = typeof v;
+		if (b == null) {
+			if (isBigNumber(v)) {
+				x.s = v.s;
+				if (!v.c || v.e > MAX_EXP) x.c = x.e = null;
+				else if (v.e < MIN_EXP) x.c = [x.e = 0];
+				else {
+					x.e = v.e;
+					x.c = v.c.slice();
+				}
+				return;
+			}
+			if (t == "number") {
+				if (v * 0 != 0) {
+					x.s = isNaN(v) ? null : v < 0 ? -1 : 1;
+					x.c = x.e = null;
+					return;
+				}
+				x.s = 1 / v < 0 ? (v = -v, -1) : 1;
+				if (v === ~~v) {
+					for (e = 0, i = v; i >= 10; i /= 10, e++);
+					if (e > MAX_EXP) x.c = x.e = null;
+					else {
+						x.e = e;
+						x.c = [v];
+					}
+					return;
+				}
+				return parseValidString(x, String(v));
+			}
+			if (t == "bigint") {
+				x.s = v < 0 ? (v = -v, -1) : 1;
+				return parseValidString(x, String(v));
+			}
+			if (t == "string") str = v;
+			else {
+				if (STRICT) throw Error(bignumberError + "BigNumber, string, number, or BigInt expected: " + v);
+				str = String(v);
+			}
+			if (isNumeric.test(str)) {
+				x.s = str.charCodeAt(0) == 45 ? (str = str.slice(1), -1) : 1;
+				return parseValidString(x, str);
+			}
+			str = str.replace(whitespaceOrPlus, "");
+			if (isInfinityOrNaN.test(str)) {
+				x.s = isNaN(str) ? null : str < 0 ? -1 : 1;
+				x.c = x.e = null;
+				return;
+			}
+			str = str.replace(basePrefix, function(m, p1, p2) {
+				b = (p2 = p2.toLowerCase()) == "x" ? 16 : p2 == "b" ? 2 : 8;
+				return p1;
+			});
+			if (b) return parseBaseString(x, str, b, v);
+			str = str.replace(/(\d)_(?=\d)/g, "$1");
+			if (isNumeric.test(str)) {
+				x.s = str.charCodeAt(0) == 45 ? (str = str.slice(1), -1) : 1;
+				return parseValidString(x, str);
+			}
+			if (STRICT) throw Error(bignumberError + "Not a number: " + v);
+			x.s = x.c = x.e = null;
+		} else {
+			if (t != "string") {
+				if (STRICT) throw Error(bignumberError + "String expected: " + v);
+				v = String(v);
+			}
+			intCheck(b, 2, ALPHABET.length, "Base");
+			parseBaseString(x, v.replace(whitespaceOrPlus, ""), b, v);
+		}
+	}
+	BigNumber.clone = clone;
+	BigNumber.ROUND_UP = 0;
+	BigNumber.ROUND_DOWN = 1;
+	BigNumber.ROUND_CEIL = 2;
+	BigNumber.ROUND_FLOOR = 3;
+	BigNumber.ROUND_HALF_UP = 4;
+	BigNumber.ROUND_HALF_DOWN = 5;
+	BigNumber.ROUND_HALF_EVEN = 6;
+	BigNumber.ROUND_HALF_CEIL = 7;
+	BigNumber.ROUND_HALF_FLOOR = 8;
+	BigNumber.EUCLID = 9;
+	BigNumber.config = BigNumber.set = function(obj) {
+		var p, v;
+		if (obj != null) if (typeof obj == "object") {
+			if (obj.hasOwnProperty(p = "DECIMAL_PLACES")) DECIMAL_PLACES = intCheck(obj[p], 0, MAX, p);
+			if (obj.hasOwnProperty(p = "ROUNDING_MODE")) ROUNDING_MODE = intCheck(obj[p], 0, 8, p);
+			if (obj.hasOwnProperty(p = "EXPONENTIAL_AT")) {
+				v = obj[p];
+				if (isArray(v)) {
+					intCheck(v[0], -MAX, 0, p);
+					intCheck(v[1], 0, MAX, p);
+					TO_EXP_NEG = v[0];
+					TO_EXP_POS = v[1];
+				} else TO_EXP_NEG = -(TO_EXP_POS = intCheck(v, -MAX, MAX, p) < 0 ? -v : v);
+			}
+			if (obj.hasOwnProperty(p = "RANGE")) {
+				v = obj[p];
+				if (v) if (isArray(v)) {
+					intCheck(v[0], -MAX, -1, p);
+					intCheck(v[1], 1, MAX, p);
+					MIN_EXP = v[0];
+					MAX_EXP = v[1];
+				} else MIN_EXP = -(MAX_EXP = intCheck(v, -MAX, MAX, p) < 0 ? -v : v);
+				else throw Error(bignumberError + p + " cannot be zero: " + v);
+			}
+			if (obj.hasOwnProperty(p = "CRYPTO")) {
+				v = obj[p];
+				if (v === !!v) if (v) if (typeof crypto != "undefined" && crypto && (crypto.getRandomValues || crypto.randomBytes)) CRYPTO = v;
+				else {
+					CRYPTO = !v;
+					throw Error(bignumberError + "crypto unavailable");
+				}
+				else CRYPTO = v;
+				else throw Error(bignumberError + p + " not true or false: " + v);
+			}
+			if (obj.hasOwnProperty(p = "STRICT")) {
+				v = obj[p];
+				if (v === !!v) STRICT = v;
+				else throw Error(bignumberError + p + " not true or false: " + v);
+			}
+			if (obj.hasOwnProperty(p = "MODULO_MODE")) MODULO_MODE = intCheck(obj[p], 0, 9, p);
+			if (obj.hasOwnProperty(p = "POW_PRECISION")) POW_PRECISION = intCheck(obj[p], 0, MAX, p);
+			if (obj.hasOwnProperty(p = "FORMAT")) {
+				v = obj[p];
+				if (typeof v == "object") {
+					for (p in v) if (v.hasOwnProperty(p) && FORMAT.hasOwnProperty(p)) FORMAT[p] = v[p];
+				} else throw Error(bignumberError + p + " not an object: " + v);
+			}
+			if (obj.hasOwnProperty(p = "ALPHABET")) {
+				v = obj[p];
+				if (typeof v == "string" && !/^.?$|[+\-.\s]|(.).*\1/.test(v)) ALPHABET = v;
+				else throw Error(bignumberError + p + " invalid: " + v);
+			}
+		} else throw Error(bignumberError + "Object expected: " + obj);
+		return {
+			DECIMAL_PLACES,
+			ROUNDING_MODE,
+			EXPONENTIAL_AT: [TO_EXP_NEG, TO_EXP_POS],
+			RANGE: [MIN_EXP, MAX_EXP],
+			CRYPTO,
+			STRICT,
+			MODULO_MODE,
+			POW_PRECISION,
+			FORMAT,
+			ALPHABET
+		};
+	};
+	BigNumber.fromFormat = function(str, options) {
+		if (typeof str !== "string") throw Error(bignumberError + "Not a string: " + str);
+		if (options == null) options = FORMAT;
+		else if (typeof options != "object") throw Error(bignumberError + "Argument not an object: " + options);
+		else options = resolveFormatOptions(options);
+		var i, isNeg, integerPart, fractionPart, negativeSign = options.negativeSign || "-", positiveSign = options.positiveSign || "", prefix = options.prefix || "", suffix = options.suffix || "", groupSeparator = options.groupSeparator || "", decimalSeparator = options.decimalSeparator || ".", fractionGroupSeparator = options.fractionGroupSeparator || "";
+		if (prefix && str.indexOf(prefix) === 0) str = str.slice(prefix.length);
+		if (suffix && str.lastIndexOf(suffix) === str.length - suffix.length) str = str.slice(0, -suffix.length);
+		if (negativeSign && str.indexOf(negativeSign) === 0) {
+			str = str.slice(negativeSign.length);
+			isNeg = true;
+		} else if (positiveSign && str.indexOf(positiveSign) === 0) str = str.slice(positiveSign.length);
+		i = str.indexOf(decimalSeparator);
+		if (i < 0) {
+			if (groupSeparator) while (str.indexOf(groupSeparator) > -1) str = str.replace(groupSeparator, "");
+		} else {
+			integerPart = str.slice(0, i);
+			fractionPart = str.slice(i + decimalSeparator.length);
+			if (groupSeparator) while (integerPart.indexOf(groupSeparator) > -1) integerPart = integerPart.replace(groupSeparator, "");
+			if (fractionGroupSeparator) while (fractionPart.indexOf(fractionGroupSeparator) > -1) fractionPart = fractionPart.replace(fractionGroupSeparator, "");
+			str = integerPart + "." + fractionPart;
+		}
+		return new BigNumber(isNeg ? "-" + str : str);
+	};
+	BigNumber.isBigNumber = function(v) {
+		if (!isBigNumber(v)) return false;
+		var i, n, c = v.c, e = v.e, s = v.s;
+		if (!isArray(c)) return c === null && e === null && (s === null || s === 1 || s === -1);
+		if (s !== 1 && s !== -1 || e < -MAX || e > MAX || e !== mathfloor(e)) return false;
+		if (c[0] === 0) return e === 0 && c.length === 1;
+		i = (e + 1) % LOG_BASE;
+		if (i < 1) i += LOG_BASE;
+		if (String(c[0]).length !== i) return false;
+		for (i = 0; i < c.length; i++) {
+			n = c[i];
+			if (n < 0 || n >= BASE || n !== mathfloor(n)) return false;
+		}
+		return n !== 0;
+	};
+	BigNumber.maximum = BigNumber.max = function() {
+		return maxOrMin(arguments, -1);
+	};
+	BigNumber.minimum = BigNumber.min = function() {
+		return maxOrMin(arguments, 1);
+	};
+	BigNumber.random = (function() {
+		var pow2_53 = 9007199254740992;
+		var random53bitInt = Math.random() * pow2_53 & 2097151 ? function() {
+			return mathfloor(Math.random() * pow2_53);
+		} : function() {
+			return (Math.random() * 1073741824 | 0) * 8388608 + (Math.random() * 8388608 | 0);
+		};
+		return function(dp) {
+			var a, b, e, k, v, i = 0, c = [], rand = new BigNumber(ONE);
+			dp = dp == null ? DECIMAL_PLACES : intCheck(dp, 0, MAX);
+			k = mathceil(dp / LOG_BASE);
+			if (CRYPTO) if (crypto.getRandomValues) {
+				a = crypto.getRandomValues(new Uint32Array(k *= 2));
+				for (; i < k;) {
+					v = a[i] * 131072 + (a[i + 1] >>> 11);
+					if (v >= 9e15) {
+						b = crypto.getRandomValues(/* @__PURE__ */ new Uint32Array(2));
+						a[i] = b[0];
+						a[i + 1] = b[1];
+					} else {
+						c.push(v % 0x5af3107a4000);
+						i += 2;
+					}
+				}
+				i = k / 2;
+			} else if (crypto.randomBytes) {
+				a = crypto.randomBytes(k *= 7);
+				for (; i < k;) {
+					v = (a[i] & 31) * 281474976710656 + a[i + 1] * 1099511627776 + a[i + 2] * 4294967296 + a[i + 3] * 16777216 + (a[i + 4] << 16) + (a[i + 5] << 8) + a[i + 6];
+					if (v >= 9e15) crypto.randomBytes(7).copy(a, i);
+					else {
+						c.push(v % 0x5af3107a4000);
+						i += 7;
+					}
+				}
+				i = k / 7;
+			} else {
+				CRYPTO = false;
+				throw Error(bignumberError + "crypto unavailable");
+			}
+			if (!CRYPTO) for (; i < k;) {
+				v = random53bitInt();
+				if (v < 9e15) c[i++] = v % 0x5af3107a4000;
+			}
+			k = c[--i];
+			dp %= LOG_BASE;
+			if (k && dp) {
+				v = POWS_TEN[LOG_BASE - dp];
+				c[i] = mathfloor(k / v) * v;
+			}
+			for (; c[i] === 0; c.pop(), i--);
+			if (i < 0) c = [e = 0];
+			else {
+				for (e = -1; c[0] === 0; c.splice(0, 1), e -= LOG_BASE);
+				for (i = 1, v = c[0]; v >= 10; v /= 10, i++);
+				if (i < LOG_BASE) e -= LOG_BASE - i;
+			}
+			rand.e = e;
+			rand.c = c;
+			return rand;
+		};
+	})();
+	BigNumber.sum = function() {
+		var i = 0, sum = new BigNumber(0);
+		for (; i < arguments.length;) sum = sum.plus(arguments[i++]);
+		return sum;
+	};
+	function parseValidString(x, str) {
+		var e, i, len;
+		if ((e = str.indexOf(".")) > -1) str = str.replace(".", "");
+		if ((i = str.search(/e/i)) > 0) {
+			if (e < 0) e = i;
+			e += +str.slice(i + 1);
+			str = str.substring(0, i);
+		} else if (e < 0) e = str.length;
+		for (i = 0; str.charCodeAt(i) === 48; i++);
+		for (len = str.length; str.charCodeAt(--len) === 48;);
+		if (str = str.slice(i, ++len)) {
+			len -= i;
+			e = e - i - 1;
+			if (e > MAX_EXP) x.c = x.e = null;
+			else if (e < MIN_EXP) x.c = [x.e = 0];
+			else {
+				x.e = e;
+				x.c = [];
+				i = (e + 1) % LOG_BASE;
+				if (e < 0) i += LOG_BASE;
+				if (i < len) {
+					if (i) x.c.push(+str.slice(0, i));
+					for (len -= LOG_BASE; i < len;) x.c.push(+str.slice(i, i += LOG_BASE));
+					i = LOG_BASE - (str = str.slice(i)).length;
+				} else i -= len;
+				for (; i--; str += "0");
+				x.c.push(+str);
+			}
+		} else x.c = [x.e = 0];
+	}
+	function parseBaseString(x, str, b, v) {
+		var c, len, alphabet = ALPHABET.slice(0, b), i = 0, clean = "", hasDot = false, prevIsNumeral = false, caseChanged = false;
+		x.s = str.charCodeAt(0) === 45 ? (str = str.slice(1), -1) : 1;
+		for (len = str.length; i < len; i++) {
+			c = str.charAt(i);
+			if (alphabet.indexOf(c) >= 0) {
+				clean += c;
+				prevIsNumeral = true;
+				continue;
+			}
+			if (c == "_") {
+				if (prevIsNumeral && i + 1 < len) {
+					prevIsNumeral = false;
+					continue;
+				}
+			} else if (c == ".") {
+				if (i == 0 || !hasDot && prevIsNumeral) {
+					if (i + 1 == len) break;
+					if (i == 0) clean = "0";
+					clean += c;
+					hasDot = true;
+					prevIsNumeral = false;
+					continue;
+				}
+			} else if (!caseChanged) {
+				if (str == str.toUpperCase() && alphabet == alphabet.toLowerCase() && (str = str.toLowerCase()) || str == str.toLowerCase() && alphabet == alphabet.toUpperCase() && (str = str.toUpperCase())) {
+					i = -1;
+					clean = "";
+					caseChanged = true;
+					hasDot = prevIsNumeral = false;
+					continue;
+				}
+			}
+			if (STRICT) throw Error(bignumberError + "Not a base " + b + " number: " + v);
+			x.s = x.c = x.e = null;
+			return;
+		}
+		parseValidString(x, convertBase(clean, b, 10, x.s));
+	}
+	convertBase = (function() {
+		var decimal = "0123456789";
+		function toBaseOut(str, baseIn, baseOut, alphabet) {
+			var j, arr = [0], arrL, i = 0, len = str.length;
+			for (; i < len;) {
+				for (arrL = arr.length; arrL--; arr[arrL] *= baseIn);
+				arr[0] += alphabet.indexOf(str.charAt(i++));
+				for (j = 0; j < arr.length; j++) if (arr[j] > baseOut - 1) {
+					if (arr[j + 1] == null) arr[j + 1] = 0;
+					arr[j + 1] += arr[j] / baseOut | 0;
+					arr[j] %= baseOut;
+				}
+			}
+			return arr.reverse();
+		}
+		return function(str, baseIn, baseOut, sign, callerIsToString) {
+			var alphabet, d, e, k, r, x, xc, y, i = str.indexOf("."), dp = DECIMAL_PLACES, rm = ROUNDING_MODE;
+			if (i >= 0) {
+				k = POW_PRECISION;
+				POW_PRECISION = 0;
+				str = str.replace(".", "");
+				y = new BigNumber(baseIn);
+				x = y.pow(str.length - i);
+				POW_PRECISION = k;
+				y.c = toBaseOut(toFixedPoint(coeffToString(x.c), x.e, "0"), 10, baseOut, decimal);
+				y.e = y.c.length;
+			}
+			xc = toBaseOut(str, baseIn, baseOut, callerIsToString ? (alphabet = ALPHABET, decimal) : (alphabet = decimal, ALPHABET));
+			e = k = xc.length;
+			for (; xc[--k] == 0; xc.pop());
+			if (!xc[0]) return alphabet.charAt(0);
+			if (i < 0) --e;
+			else {
+				x.c = xc;
+				x.e = e;
+				x.s = sign;
+				x = div(x, y, dp, rm, baseOut);
+				xc = x.c;
+				r = x.r;
+				e = x.e;
+			}
+			d = e + dp + 1;
+			i = xc[d];
+			k = baseOut / 2;
+			r = r || d < 0 || xc[d + 1] != null;
+			r = rm < 4 ? (i != null || r) && (rm == 0 || rm == (x.s < 0 ? 3 : 2)) : i > k || i == k && (rm == 4 || r || rm == 6 && xc[d - 1] & 1 || rm == (x.s < 0 ? 8 : 7));
+			if (d < 1 || !xc[0]) str = r ? toFixedPoint(alphabet.charAt(1), -dp, alphabet.charAt(0)) : alphabet.charAt(0);
+			else {
+				if (d < xc.length) xc.length = d;
+				if (r) for (--baseOut; ++xc[--d] > baseOut;) {
+					xc[d] = 0;
+					if (!d) {
+						++e;
+						xc = [1].concat(xc);
+					}
+				}
+				for (k = xc.length; !xc[--k];);
+				for (i = 0, str = ""; i <= k; str += alphabet.charAt(xc[i++]));
+				str = toFixedPoint(str, e, alphabet.charAt(0));
+			}
+			return str;
+		};
+	})();
+	div = (function() {
+		function multiply(x, k, base) {
+			var m, temp, xlo, xhi, carry = 0, i = x.length, klo = k % SQRT_BASE, khi = k / SQRT_BASE | 0;
+			for (x = x.slice(); i--;) {
+				xlo = x[i] % SQRT_BASE;
+				xhi = x[i] / SQRT_BASE | 0;
+				m = khi * xlo + xhi * klo;
+				temp = klo * xlo + m % SQRT_BASE * SQRT_BASE + carry;
+				carry = (temp / base | 0) + (m / SQRT_BASE | 0) + khi * xhi;
+				x[i] = temp % base;
+			}
+			if (carry) x = [carry].concat(x);
+			return x;
+		}
+		function compare(a, b, aL, bL) {
+			var i, cmp;
+			if (aL != bL) cmp = aL > bL ? 1 : -1;
+			else for (i = cmp = 0; i < aL; i++) if (a[i] != b[i]) {
+				cmp = a[i] > b[i] ? 1 : -1;
+				break;
+			}
+			return cmp;
+		}
+		function subtract(a, b, aL, base) {
+			var i = 0;
+			for (; aL--;) {
+				a[aL] -= i;
+				i = a[aL] < b[aL] ? 1 : 0;
+				a[aL] = i * base + a[aL] - b[aL];
+			}
+			for (; !a[0] && a.length > 1; a.splice(0, 1));
+		}
+		return function(x, y, dp, rm, base) {
+			var cmp, e, i, more, n, prod, prodL, q, qc, rem, remL, rem0, xi, xL, yc0, yL, yz, s = x.s == y.s ? 1 : -1, xc = x.c, yc = y.c;
+			if (!xc || !xc[0] || !yc || !yc[0]) return new BigNumber(!x.s || !y.s || (xc ? yc && xc[0] == yc[0] : !yc) ? NaN : xc && xc[0] == 0 || !yc ? s * 0 : s / 0);
+			q = new BigNumber(s);
+			qc = q.c = [];
+			e = x.e - y.e;
+			s = dp + e + 1;
+			if (!base) {
+				base = BASE;
+				e = bitFloor(x.e / LOG_BASE) - bitFloor(y.e / LOG_BASE);
+				s = s / LOG_BASE | 0;
+			}
+			for (i = 0; yc[i] == (xc[i] || 0); i++);
+			if (yc[i] > (xc[i] || 0)) e--;
+			if (s < 0) {
+				qc.push(1);
+				more = true;
+			} else {
+				xL = xc.length;
+				yL = yc.length;
+				i = 0;
+				s += 2;
+				n = mathfloor(base / (yc[0] + 1));
+				if (n > 1) {
+					yc = multiply(yc, n, base);
+					xc = multiply(xc, n, base);
+					yL = yc.length;
+					xL = xc.length;
+				}
+				xi = yL;
+				rem = xc.slice(0, yL);
+				remL = rem.length;
+				for (; remL < yL; rem[remL++] = 0);
+				yz = yc.slice();
+				yz = [0].concat(yz);
+				yc0 = yc[0];
+				if (yc[1] >= base / 2) yc0++;
+				do {
+					n = 0;
+					cmp = compare(yc, rem, yL, remL);
+					if (cmp < 0) {
+						rem0 = rem[0];
+						if (yL != remL) rem0 = rem0 * base + (rem[1] || 0);
+						n = mathfloor(rem0 / yc0);
+						if (n > 1) {
+							if (n >= base) n = base - 1;
+							prod = multiply(yc, n, base);
+							prodL = prod.length;
+							remL = rem.length;
+							while (compare(prod, rem, prodL, remL) == 1) {
+								n--;
+								subtract(prod, yL < prodL ? yz : yc, prodL, base);
+								prodL = prod.length;
+								cmp = 1;
+							}
+						} else {
+							if (n == 0) cmp = n = 1;
+							prod = yc.slice();
+							prodL = prod.length;
+						}
+						if (prodL < remL) prod = [0].concat(prod);
+						subtract(rem, prod, remL, base);
+						remL = rem.length;
+						if (cmp == -1) while (compare(yc, rem, yL, remL) < 1) {
+							n++;
+							subtract(rem, yL < remL ? yz : yc, remL, base);
+							remL = rem.length;
+						}
+					} else if (cmp === 0) {
+						n++;
+						rem = [0];
+					}
+					qc[i++] = n;
+					if (rem[0]) rem[remL++] = xc[xi] || 0;
+					else {
+						rem = [xc[xi]];
+						remL = 1;
+					}
+				} while ((xi++ < xL || rem[0] != null) && s--);
+				more = rem[0] != null;
+				if (!qc[0]) qc.splice(0, 1);
+			}
+			if (base == BASE) {
+				for (i = 1, s = qc[0]; s >= 10; s /= 10, i++);
+				round(q, dp + (q.e = i + e * LOG_BASE - 1) + 1, rm, more);
+			} else {
+				q.e = e;
+				q.r = +more;
+			}
+			return q;
+		};
+	})();
+	function format(n, i, rm, id) {
+		var c0, e, ne, len, str;
+		rm = rm == null ? ROUNDING_MODE : intCheck(rm, 0, 8);
+		if (!n.c) return n.toString();
+		c0 = n.c[0];
+		ne = n.e;
+		if (i == null) {
+			str = coeffToString(n.c);
+			str = id == 1 || id == 2 && (ne <= TO_EXP_NEG || ne >= TO_EXP_POS) ? toExponential(str, ne) : toFixedPoint(str, ne, "0");
+		} else {
+			n = round(new BigNumber(n), i, rm);
+			e = n.e;
+			str = coeffToString(n.c);
+			len = str.length;
+			if (id == 1 || id == 2 && (i <= e || e <= TO_EXP_NEG)) {
+				for (; len < i; str += "0", len++);
+				str = toExponential(str, e);
+			} else {
+				i -= ne + (id === 2 && e > ne);
+				str = toFixedPoint(str, e, "0");
+				if (e + 1 > len) {
+					if (--i > 0) for (str += "."; i--; str += "0");
+				} else {
+					i += e - len;
+					if (i > 0) {
+						if (e + 1 == len) str += ".";
+						for (; i--; str += "0");
+					}
+				}
+			}
+		}
+		return n.s < 0 && c0 ? "-" + str : str;
+	}
+	function isBigNumber(v) {
+		return v instanceof BigNumber || !!v && v._isBigNumber === true;
+	}
+	function maxOrMin(args, n) {
+		var k, y, i = 1, x = new BigNumber(args[0]);
+		for (; i < args.length; i++) {
+			y = new BigNumber(args[i]);
+			if (!y.s || (k = compare(x, y)) === n || k === 0 && x.s === n) x = y;
+		}
+		return x;
+	}
+	function normalise(n, c, e) {
+		var i = 1, j = c.length;
+		for (; !c[--j]; c.pop());
+		for (j = c[0]; j >= 10; j /= 10, i++);
+		if ((e = i + e * LOG_BASE - 1) > MAX_EXP) n.c = n.e = null;
+		else if (e < MIN_EXP) n.c = [n.e = 0];
+		else {
+			n.e = e;
+			n.c = c;
+		}
+		return n;
+	}
+	function resolveFormatOptions(options) {
+		var key, resolved = {};
+		for (key in FORMAT) if (FORMAT.hasOwnProperty(key)) resolved[key] = options.hasOwnProperty(key) ? options[key] : FORMAT[key];
+		return resolved;
+	}
+	function round(x, sd, rm, r) {
+		var d, i, j, k, n, ni, rd, xc = x.c, pows10 = POWS_TEN;
+		if (xc) {
+			out: {
+				for (d = 1, k = xc[0]; k >= 10; k /= 10, d++);
+				i = sd - d;
+				if (i < 0) {
+					i += LOG_BASE;
+					j = sd;
+					n = xc[ni = 0];
+					rd = mathfloor(n / pows10[d - j - 1] % 10);
+				} else {
+					ni = mathceil((i + 1) / LOG_BASE);
+					if (ni >= xc.length) if (r) {
+						for (; xc.length <= ni; xc.push(0));
+						n = rd = 0;
+						d = 1;
+						i %= LOG_BASE;
+						j = i - LOG_BASE + 1;
+					} else break out;
+					else {
+						n = k = xc[ni];
+						for (d = 1; k >= 10; k /= 10, d++);
+						i %= LOG_BASE;
+						j = i - LOG_BASE + d;
+						rd = j < 0 ? 0 : mathfloor(n / pows10[d - j - 1] % 10);
+					}
+				}
+				r = r || sd < 0 || xc[ni + 1] != null || (j < 0 ? n : n % pows10[d - j - 1]);
+				r = rm < 4 ? (rd || r) && (rm == 0 || rm == (x.s < 0 ? 3 : 2)) : rd > 5 || rd == 5 && (rm == 4 || r || rm == 6 && (i > 0 ? j > 0 ? n / pows10[d - j] : 0 : xc[ni - 1]) % 10 & 1 || rm == (x.s < 0 ? 8 : 7));
+				if (sd < 1 || !xc[0]) {
+					xc.length = 0;
+					if (r) {
+						sd -= x.e + 1;
+						xc[0] = pows10[(LOG_BASE - sd % LOG_BASE) % LOG_BASE];
+						x.e = -sd || 0;
+					} else xc[0] = x.e = 0;
+					return x;
+				}
+				if (i == 0) {
+					xc.length = ni;
+					k = 1;
+					ni--;
+				} else {
+					xc.length = ni + 1;
+					k = pows10[LOG_BASE - i];
+					xc[ni] = j > 0 ? mathfloor(n / pows10[d - j] % pows10[j]) * k : 0;
+				}
+				if (r) for (;;) if (ni == 0) {
+					for (i = 1, j = xc[0]; j >= 10; j /= 10, i++);
+					j = xc[0] += k;
+					for (k = 1; j >= 10; j /= 10, k++);
+					if (i != k) {
+						x.e++;
+						if (xc[0] == BASE) xc[0] = 1;
+					}
+					break;
+				} else {
+					xc[ni] += k;
+					if (xc[ni] != BASE) break;
+					xc[ni--] = 0;
+					k = 1;
+				}
+				for (i = xc.length; xc[--i] === 0; xc.pop());
+			}
+			if (x.e > MAX_EXP) x.c = x.e = null;
+			else if (x.e < MIN_EXP) x.c = [x.e = 0];
+		}
+		return x;
+	}
+	function valueOf(n) {
+		var str, e = n.e;
+		if (e === null) return n.toString();
+		str = coeffToString(n.c);
+		str = e <= TO_EXP_NEG || e >= TO_EXP_POS ? toExponential(str, e) : toFixedPoint(str, e, "0");
+		return n.s < 0 ? "-" + str : str;
+	}
+	P.absoluteValue = P.abs = function() {
+		var x = new BigNumber(this);
+		if (x.s < 0) x.s = 1;
+		return x;
+	};
+	P.comparedTo = function(y, b) {
+		return compare(this, new BigNumber(y, b));
+	};
+	P.decimalPlaces = P.dp = function(dp, rm) {
+		var c, n, v, x = this;
+		if (dp != null) return round(new BigNumber(x), intCheck(dp, -MAX, MAX) + x.e + 1, rm == null ? ROUNDING_MODE : intCheck(rm, 0, 8));
+		if (!(c = x.c)) return null;
+		n = ((v = c.length - 1) - bitFloor(this.e / LOG_BASE)) * LOG_BASE;
+		if (v = c[v]) for (; v % 10 == 0; v /= 10, n--);
+		if (n < 0) n = 0;
+		return n;
+	};
+	P.dividedBy = P.div = function(y, b) {
+		return div(this, new BigNumber(y, b), DECIMAL_PLACES, ROUNDING_MODE);
+	};
+	P.dividedToIntegerBy = P.idiv = function(y, b) {
+		return div(this, new BigNumber(y, b), 0, 1);
+	};
+	P.exponentiatedBy = P.pow = function(n, m) {
+		var half, isModExp, i, k, more, nIsBig, nIsNeg, nIsOdd, y, x = this;
+		n = new BigNumber(n);
+		if (n.c && !n.isInteger()) throw Error(bignumberError + "Exponent not an integer: " + valueOf(n));
+		if (m != null) m = new BigNumber(m);
+		nIsBig = n.e > 14;
+		if (!x.c || !x.c[0] || x.c[0] == 1 && !x.e && x.c.length == 1 || !n.c || !n.c[0]) {
+			y = new BigNumber(Math.pow(+valueOf(x), nIsBig ? n.s * (2 - isOdd(n)) : +valueOf(n)));
+			return m ? y.mod(m) : y;
+		}
+		nIsNeg = n.s < 0;
+		if (m) {
+			if (m.c ? !m.c[0] : !m.s) return new BigNumber(NaN);
+			isModExp = !nIsNeg && x.isInteger() && m.isInteger();
+			if (isModExp) x = x.mod(m);
+		} else if (n.e > 9 && (x.e > 0 || x.e < -1 || (x.e == 0 ? x.c[0] > 1 || nIsBig && x.c[1] >= 24e7 : x.c[0] < 8e13 || nIsBig && x.c[0] <= 9999975e7))) {
+			k = x.s < 0 && isOdd(n) ? -0 : 0;
+			if (x.e > -1) k = 1 / k;
+			return new BigNumber(nIsNeg ? 1 / k : k);
+		} else if (POW_PRECISION) k = mathceil(POW_PRECISION / LOG_BASE + 2);
+		if (nIsBig) {
+			half = new BigNumber(.5);
+			if (nIsNeg) n.s = 1;
+			nIsOdd = isOdd(n);
+		} else {
+			i = Math.abs(+valueOf(n));
+			nIsOdd = i % 2;
+		}
+		y = new BigNumber(ONE);
+		for (;;) {
+			if (nIsOdd) {
+				y = y.times(x);
+				if (!y.c) break;
+				if (k) {
+					if (y.c.length > k) y.c.length = k;
+				} else if (isModExp) y = y.mod(m);
+			}
+			if (i) {
+				i = mathfloor(i / 2);
+				if (i === 0) break;
+				nIsOdd = i % 2;
+			} else {
+				n = n.times(half);
+				round(n, n.e + 1, 1);
+				if (n.e > 14) nIsOdd = isOdd(n);
+				else {
+					i = +valueOf(n);
+					if (i === 0) break;
+					nIsOdd = i % 2;
+				}
+			}
+			x = x.times(x);
+			if (k) {
+				if (x.c && x.c.length > k) x.c.length = k;
+			} else if (isModExp) x = x.mod(m);
+		}
+		if (isModExp) return y;
+		if (nIsNeg) y = ONE.div(y);
+		return m ? y.mod(m) : k ? round(y, POW_PRECISION, ROUNDING_MODE, more) : y;
+	};
+	P.integerValue = function(rm) {
+		var n = new BigNumber(this);
+		return round(n, n.e + 1, rm == null ? ROUNDING_MODE : intCheck(rm, 0, 8));
+	};
+	P.isEqualTo = P.eq = function(y, b) {
+		return compare(this, new BigNumber(y, b)) === 0;
+	};
+	P.isFinite = function() {
+		return !!this.c;
+	};
+	P.isGreaterThan = P.gt = function(y, b) {
+		return compare(this, new BigNumber(y, b)) > 0;
+	};
+	P.isGreaterThanOrEqualTo = P.gte = function(y, b) {
+		return (b = compare(this, new BigNumber(y, b))) === 1 || b === 0;
+	};
+	P.isInteger = function() {
+		return !!this.c && bitFloor(this.e / LOG_BASE) > this.c.length - 2;
+	};
+	P.isLessThan = P.lt = function(y, b) {
+		return compare(this, new BigNumber(y, b)) < 0;
+	};
+	P.isLessThanOrEqualTo = P.lte = function(y, b) {
+		return (b = compare(this, new BigNumber(y, b))) === -1 || b === 0;
+	};
+	P.isNaN = function() {
+		return !this.s;
+	};
+	P.isNegative = function() {
+		return this.s < 0;
+	};
+	P.isPositive = function() {
+		return this.s > 0;
+	};
+	P.isZero = function() {
+		return !!this.c && this.c[0] == 0;
+	};
+	P.minus = function(y, b) {
+		var i, j, t, xLTy, x = this, a = x.s;
+		y = new BigNumber(y, b);
+		b = y.s;
+		if (!a || !b) return new BigNumber(NaN);
+		if (a != b) {
+			y.s = -b;
+			return x.plus(y);
+		}
+		var xe = x.e / LOG_BASE, ye = y.e / LOG_BASE, xc = x.c, yc = y.c;
+		if (!xe || !ye) {
+			if (!xc || !yc) return xc ? (y.s = -b, y) : new BigNumber(yc ? x : NaN);
+			if (!xc[0] || !yc[0]) return yc[0] ? (y.s = -b, y) : new BigNumber(xc[0] ? x : ROUNDING_MODE == 3 ? -0 : 0);
+		}
+		xe = bitFloor(xe);
+		ye = bitFloor(ye);
+		xc = xc.slice();
+		if (a = xe - ye) {
+			if (xLTy = a < 0) {
+				a = -a;
+				t = xc;
+			} else {
+				ye = xe;
+				t = yc;
+			}
+			t.reverse();
+			for (b = a; b--; t.push(0));
+			t.reverse();
+		} else {
+			j = (xLTy = (a = xc.length) < (b = yc.length)) ? a : b;
+			for (a = b = 0; b < j; b++) if (xc[b] != yc[b]) {
+				xLTy = xc[b] < yc[b];
+				break;
+			}
+		}
+		if (xLTy) {
+			t = xc;
+			xc = yc;
+			yc = t;
+			y.s = -y.s;
+		}
+		b = (j = yc.length) - (i = xc.length);
+		if (b > 0) for (; b--; xc[i++] = 0);
+		b = BASE - 1;
+		for (; j > a;) {
+			if (xc[--j] < yc[j]) {
+				for (i = j; i && !xc[--i]; xc[i] = b);
+				--xc[i];
+				xc[j] += BASE;
+			}
+			xc[j] -= yc[j];
+		}
+		for (; xc[0] == 0; xc.splice(0, 1), --ye);
+		if (!xc[0]) {
+			y.s = ROUNDING_MODE == 3 ? -1 : 1;
+			y.c = [y.e = 0];
+			return y;
+		}
+		return normalise(y, xc, ye);
+	};
+	P.modulo = P.mod = function(y, b) {
+		var q, s, x = this;
+		y = new BigNumber(y, b);
+		if (!x.c || !y.s || y.c && !y.c[0]) return new BigNumber(NaN);
+		else if (!y.c || x.c && !x.c[0]) return new BigNumber(x);
+		if (MODULO_MODE == 9) {
+			s = y.s;
+			y.s = 1;
+			q = div(x, y, 0, 3);
+			y.s = s;
+			q.s *= s;
+		} else q = div(x, y, 0, MODULO_MODE);
+		y = x.minus(q.times(y));
+		if (!y.c[0] && MODULO_MODE == 1) y.s = x.s;
+		return y;
+	};
+	P.multipliedBy = P.times = function(y, b) {
+		var c, e, i, j, k, m, xcL, xlo, xhi, ycL, ylo, yhi, zc, base, sqrtBase, x = this, xc = x.c, yc = (y = new BigNumber(y, b)).c;
+		if (!xc || !yc || !xc[0] || !yc[0]) {
+			if (!x.s || !y.s || xc && !xc[0] && !yc || yc && !yc[0] && !xc) y.c = y.e = y.s = null;
+			else {
+				y.s *= x.s;
+				if (!xc || !yc) y.c = y.e = null;
+				else {
+					y.c = [0];
+					y.e = 0;
+				}
+			}
+			return y;
+		}
+		e = bitFloor(x.e / LOG_BASE) + bitFloor(y.e / LOG_BASE);
+		y.s *= x.s;
+		xcL = xc.length;
+		ycL = yc.length;
+		if (xcL < ycL) {
+			zc = xc;
+			xc = yc;
+			yc = zc;
+			i = xcL;
+			xcL = ycL;
+			ycL = i;
+		}
+		for (i = xcL + ycL, zc = []; i--; zc.push(0));
+		base = BASE;
+		sqrtBase = SQRT_BASE;
+		for (i = ycL; --i >= 0;) {
+			c = 0;
+			ylo = yc[i] % sqrtBase;
+			yhi = yc[i] / sqrtBase | 0;
+			for (k = xcL, j = i + k; j > i;) {
+				xlo = xc[--k] % sqrtBase;
+				xhi = xc[k] / sqrtBase | 0;
+				m = yhi * xlo + xhi * ylo;
+				xlo = ylo * xlo + m % sqrtBase * sqrtBase + zc[j] + c;
+				c = (xlo / base | 0) + (m / sqrtBase | 0) + yhi * xhi;
+				zc[j--] = xlo % base;
+			}
+			zc[j] = c;
+		}
+		if (c) ++e;
+		else zc.splice(0, 1);
+		return normalise(y, zc, e);
+	};
+	P.negated = function() {
+		var x = new BigNumber(this);
+		x.s = -x.s || null;
+		return x;
+	};
+	P.plus = function(y, b) {
+		var t, x = this, a = x.s;
+		y = new BigNumber(y, b);
+		b = y.s;
+		if (!a || !b) return new BigNumber(NaN);
+		if (a != b) {
+			y.s = -b;
+			return x.minus(y);
+		}
+		var xe = x.e / LOG_BASE, ye = y.e / LOG_BASE, xc = x.c, yc = y.c;
+		if (!xe || !ye) {
+			if (!xc || !yc) return new BigNumber(a / 0);
+			if (!xc[0] || !yc[0]) return yc[0] ? y : new BigNumber(xc[0] ? x : a * 0);
+		}
+		xe = bitFloor(xe);
+		ye = bitFloor(ye);
+		xc = xc.slice();
+		if (a = xe - ye) {
+			if (a > 0) {
+				ye = xe;
+				t = yc;
+			} else {
+				a = -a;
+				t = xc;
+			}
+			t.reverse();
+			for (; a--; t.push(0));
+			t.reverse();
+		}
+		a = xc.length;
+		b = yc.length;
+		if (a - b < 0) {
+			t = yc;
+			yc = xc;
+			xc = t;
+			b = a;
+		}
+		for (a = 0; b;) {
+			a = (xc[--b] = xc[b] + yc[b] + a) / BASE | 0;
+			xc[b] = BASE === xc[b] ? 0 : xc[b] % BASE;
+		}
+		if (a) {
+			xc = [a].concat(xc);
+			++ye;
+		}
+		return normalise(y, xc, ye);
+	};
+	P.precision = P.sd = function(sd, rm) {
+		var c, n, v, x = this;
+		if (sd != null && sd !== !!sd) return round(new BigNumber(x), intCheck(sd, 1, MAX), rm == null ? ROUNDING_MODE : intCheck(rm, 0, 8));
+		if (!(c = x.c)) return null;
+		v = c.length - 1;
+		n = v * LOG_BASE + 1;
+		if (v = c[v]) {
+			for (; v % 10 == 0; v /= 10, n--);
+			for (v = c[0]; v >= 10; v /= 10, n++);
+		}
+		if (sd && x.e + 1 > n) n = x.e + 1;
+		return n;
+	};
+	P.shiftedBy = function(k) {
+		return this.times("1e" + intCheck(k, -MAX_SAFE_INTEGER, MAX_SAFE_INTEGER));
+	};
+	P.squareRoot = P.sqrt = function() {
+		var m, n, r, rep, t, x = this, c = x.c, s = x.s, e = x.e, dp = DECIMAL_PLACES + 4, half = new BigNumber("0.5");
+		if (s !== 1 || !c || !c[0]) return new BigNumber(!s || s < 0 && (!c || c[0]) ? NaN : c ? x : Infinity);
+		s = Math.sqrt(+valueOf(x));
+		if (s == 0 || s == Infinity) {
+			n = coeffToString(c);
+			if ((n.length + e) % 2 == 0) n += "0";
+			s = Math.sqrt(+n);
+			e = bitFloor((e + 1) / 2) - (e < 0 || e % 2);
+			if (s == Infinity) n = "5e" + e;
+			else {
+				n = s.toExponential();
+				n = n.slice(0, n.indexOf("e") + 1) + e;
+			}
+			r = new BigNumber(n);
+		} else r = new BigNumber(s + "");
+		if (r.c[0]) {
+			e = r.e;
+			s = e + dp;
+			if (s < 3) s = 0;
+			for (;;) {
+				t = r;
+				r = half.times(t.plus(div(x, t, dp, 1)));
+				if (coeffToString(t.c).slice(0, s) === (n = coeffToString(r.c)).slice(0, s)) {
+					if (r.e < e) --s;
+					n = n.slice(s - 3, s + 1);
+					if (n == "9999" || !rep && n == "4999") {
+						if (!rep) {
+							round(t, t.e + DECIMAL_PLACES + 2, 0);
+							if (t.times(t).eq(x)) {
+								r = t;
+								break;
+							}
+						}
+						dp += 4;
+						s += 4;
+						rep = 1;
+					} else {
+						if (!+n || !+n.slice(1) && n.charAt(0) == "5") {
+							round(r, r.e + DECIMAL_PLACES + 2, 1);
+							m = !r.times(r).eq(x);
+						}
+						break;
+					}
+				}
+			}
+		}
+		return round(r, r.e + DECIMAL_PLACES + 1, ROUNDING_MODE, m);
+	};
+	if (typeof BigInt == "function") P.toBigInt = function(rm) {
+		var x = this;
+		if (!x.c) return null;
+		return BigInt(format(x, x.e + 1, rm));
+	};
+	P.toExponential = function(dp, rm) {
+		return format(this, dp == null ? dp : intCheck(dp, 0, MAX) + 1, rm, 1);
+	};
+	P.toFixed = function(dp, rm) {
+		return format(this, dp == null ? dp : intCheck(dp, -MAX, MAX) + this.e + 1, rm);
+	};
+	P.toFormat = function(dp, rm, options) {
+		var isNeg, min, max, str, x = this;
+		if (options == null) {
+			options = FORMAT;
+			if (dp != null) {
+				if (rm != null) {
+					if (typeof rm == "object") {
+						options = resolveFormatOptions(rm);
+						rm = null;
+					}
+				} else if (typeof dp == "object" && !isArray(dp)) {
+					options = resolveFormatOptions(dp);
+					dp = rm = null;
+				}
+			}
+		} else if (typeof options != "object") throw Error(bignumberError + "Argument not an object: " + options);
+		else options = resolveFormatOptions(options);
+		if (dp != null) if (isArray(dp) && dp.length <= 2) {
+			min = dp[0];
+			max = dp[1];
+			dp = x.dp();
+			if (max != null && dp > intCheck(max, 0, MAX)) dp = max;
+			if (min != null && intCheck(min, 0, MAX) !== 0) {
+				if (max != null && min > max) throw Error(bignumberError + "Minimum must not exceed maximum");
+				if (dp < min) dp = min;
+			}
+		} else intCheck(dp, -MAX, MAX);
+		str = x.toFixed(dp, rm);
+		isNeg = str.charCodeAt(0) === 45;
+		if (isNeg) str = str.slice(1);
+		if (x.c) {
+			var i, arr = str.split("."), g1 = +options.groupSize, g2 = +options.secondaryGroupSize, groupSeparator = options.groupSeparator || "", intPart = arr[0], fractionPart = arr[1], len = intPart.length;
+			if (g2) {
+				i = g1;
+				g1 = g2;
+				g2 = i;
+				len -= i;
+			}
+			if (g1 > 0 && len > 0) {
+				i = len % g1 || g1;
+				str = intPart.substr(0, i);
+				for (; i < len; i += g1) str += groupSeparator + intPart.substr(i, g1);
+				if (g2 > 0) str += groupSeparator + intPart.slice(i);
+			} else str = intPart;
+			if (fractionPart) {
+				i = +options.fractionGroupSize;
+				if (i) fractionPart = fractionPart.replace(new RegExp("\\d{" + i + "}\\B", "g"), "$&" + (options.fractionGroupSeparator || ""));
+				str += (options.decimalSeparator || "") + fractionPart;
+			}
+		}
+		return (options.prefix || "") + (isNeg ? options.negativeSign || "" : x.s > 0 ? options.positiveSign || "" : "") + str + (options.suffix || "");
+	};
+	P.toFraction = function(md) {
+		var d, d0, d1, d2, e, exp, n, n0, n1, q, r, s, xd, xn, x = this, xc = x.c;
+		if (md != null) {
+			n = new BigNumber(md);
+			if (!n.isInteger() && (n.c || n.s !== 1) || n.lt(ONE)) throw Error(bignumberError + "Argument " + (n.isInteger() ? "out of range: " : "not an integer: ") + valueOf(n));
+		}
+		if (!xc) return [new BigNumber(x.s || 0), new BigNumber(0)];
+		d = new BigNumber(ONE);
+		n1 = d0 = new BigNumber(ONE);
+		d1 = n0 = new BigNumber(ONE);
+		s = coeffToString(xc);
+		e = d.e = s.length - x.e - 1;
+		d.c[0] = POWS_TEN[(exp = e % LOG_BASE) < 0 ? LOG_BASE + exp : exp];
+		md = !md || n.comparedTo(d) > 0 ? e > 0 ? d : n1 : n;
+		exp = MAX_EXP;
+		MAX_EXP = Infinity;
+		n = new BigNumber(s);
+		xn = n;
+		xd = d;
+		n0.c[0] = 0;
+		for (;;) {
+			q = div(n, d, 0, 1);
+			d2 = d0.plus(q.times(d1));
+			if (d2.comparedTo(md) == 1) break;
+			d0 = d1;
+			d1 = d2;
+			n1 = n0.plus(q.times(d2 = n1));
+			n0 = d2;
+			d = n.minus(q.times(d2 = d));
+			n = d2;
+		}
+		d2 = div(md.minus(d0), d1, 0, 1);
+		n0 = n0.plus(d2.times(n1));
+		d0 = d0.plus(d2.times(d1));
+		r = n1.times(xd).minus(xn.times(d1)).abs().times(d0).comparedTo(n0.times(xd).minus(xn.times(d0)).abs().times(d1)) < 1 ? [n1, d1] : [n0, d0];
+		r[0].s = x.s;
+		MAX_EXP = exp;
+		return r;
+	};
+	P.toNumber = function() {
+		return +valueOf(this);
+	};
+	P.toObject = function() {
+		var x = this;
+		return {
+			c: x.c ? x.c.slice() : null,
+			e: x.e,
+			s: x.s
+		};
+	};
+	P.toPrecision = function(sd, rm) {
+		return format(this, sd == null ? sd : intCheck(sd, 1, MAX), rm, 2);
+	};
+	P.toString = function(b) {
+		var str, n = this, s = n.s, e = n.e;
+		if (e === null) if (s) {
+			str = "Infinity";
+			if (s < 0) str = "-" + str;
+		} else str = "NaN";
+		else {
+			if (b == null) str = e <= TO_EXP_NEG || e >= TO_EXP_POS ? toExponential(coeffToString(n.c), e) : toFixedPoint(coeffToString(n.c), e, "0");
+			else {
+				intCheck(b, 2, ALPHABET.length, "Base");
+				str = convertBase(toFixedPoint(coeffToString(n.c), e, "0"), 10, b, s, true);
+			}
+			if (s < 0 && n.c[0]) str = "-" + str;
+		}
+		return str;
+	};
+	P.valueOf = P.toJSON = function() {
+		return valueOf(this);
+	};
+	P._isBigNumber = true;
+	if (configObject != null) BigNumber.set(configObject);
+	return BigNumber;
+}
+function bitFloor(n) {
+	var i = n | 0;
+	return n > 0 || n === i ? i : i - 1;
+}
+function coeffToString(a) {
+	var s, z, i = 1, j = a.length, r = a[0] + "";
+	for (; i < j;) {
+		s = a[i++] + "";
+		z = LOG_BASE - s.length;
+		for (; z--; s = "0" + s);
+		r += s;
+	}
+	for (j = r.length; r.charCodeAt(--j) === 48;);
+	return r.slice(0, j + 1 || 1);
+}
+function compare(x, y) {
+	var a, b, xc = x.c, yc = y.c, i = x.s, j = y.s, k = x.e, l = y.e;
+	if (!i || !j) return null;
+	a = xc && !xc[0];
+	b = yc && !yc[0];
+	if (a || b) return a ? b ? 0 : -j : i;
+	if (i != j) return i;
+	a = i < 0;
+	b = k == l;
+	if (!xc || !yc) return b ? 0 : !xc ^ a ? 1 : -1;
+	if (!b) return k > l ^ a ? 1 : -1;
+	j = (k = xc.length) < (l = yc.length) ? k : l;
+	for (i = 0; i < j; i++) if (xc[i] != yc[i]) return xc[i] > yc[i] ^ a ? 1 : -1;
+	return k == l ? 0 : k > l ^ a ? 1 : -1;
+}
+function intCheck(n, min, max, name) {
+	if (n < min || n > max || n !== mathfloor(n)) throw Error(bignumberError + (name || "Argument") + (typeof n == "number" ? n < min || n > max ? " out of range: " : " not an integer: " : " not a primitive number: ") + String(n));
+	return n;
+}
+function isArray(obj) {
+	return {}.toString.call(obj) == "[object Array]";
+}
+function isOdd(n) {
+	var k = n.c.length - 1;
+	return bitFloor(n.e / LOG_BASE) == k && n.c[k] % 2 != 0;
+}
+function toExponential(str, e) {
+	return (str.length > 1 ? str.charAt(0) + "." + str.slice(1) : str) + (e < 0 ? "e" : "e+") + e;
+}
+function toFixedPoint(str, e, z) {
+	var len, zs;
+	if (e < 0) {
+		for (zs = z + "."; ++e; zs += z);
+		str = zs + str;
+	} else {
+		len = str.length;
+		if (++e > len) {
+			for (zs = z, e -= len; --e; zs += z);
+			str += zs;
+		} else if (e < len) str = str.slice(0, e) + "." + str.slice(e);
+	}
+	return str;
+}
+//#endregion
+//#region packages/contracts/src/api-keys.ts
+/**
+* API anahtarı sözleşmeleri — permission-mask modeli (spec §5.5).
+*
+* KRİTİK KURAL: `scope`, oluşturma anındaki tavandır — gerçek etkili kapsam
+* istek anında sahibinin GÜNCEL tenant rolüyle kesişiminden hesaplanır (bkz.
+* apps/api/src/lib/api-key-auth.ts). Bu şemalar yalnız gövde şeklini tanımlar,
+* yetki hesabını YAPMAZ.
+*/
+const apiKeyScopeSchema = z.enum([
+	"read",
+	"write",
+	"admin"
+], "geçerli bir kapsam olmalı (read, write, admin)");
+z.object({
+	name: z.string().trim().min(2, "ad en az 2 karakter olmalı").max(80, "ad en fazla 80 karakter olabilir"),
+	scope: apiKeyScopeSchema
+});
+z.object({
+	id: z.uuid(),
+	name: z.string(),
+	scope: apiKeyScopeSchema,
+	prefix: z.string(),
+	token: z.string()
+});
+const apiKeyResponseSchema = z.object({
+	id: z.uuid(),
+	name: z.string(),
+	scope: apiKeyScopeSchema,
+	prefix: z.string(),
+	lastUsedAt: z.iso.datetime().nullable(),
+	revokedAt: z.iso.datetime().nullable(),
+	createdAt: z.iso.datetime()
+});
+z.object({ keys: z.array(apiKeyResponseSchema) });
+//#endregion
+//#region packages/contracts/src/common.ts
+/**
+* Ortak zod şemaları ve doğrulayıcılar — birden fazla domain tarafından
+* paylaşılan küçük yapı taşları. Domain'e özgü şemalar kendi dosyalarında
+* durur (ör. plans.ts, fields.ts).
+*
+* Hata mesajları Türkçe: bu şemalar doğrudan API yanıtına dönüşüyor.
+*/
+/** Tenant üyeliği rolü — sıralı: viewer < member < admin < owner */
+const memberRoleSchema = z.enum([
+	"owner",
+	"admin",
+	"member",
+	"viewer"
+], "geçerli bir rol olmalı (owner, admin, member, viewer)");
+/**
+* Tenant slug'ı. NOT: "ayrılmış adlar" (ör. `admin`, `api`, `www`) şu anda
+* route katmanında FİLTRELENMİYOR — slug bir subdomain değil path-prefix
+* olarak kullanıldığından (bkz. spec) bu bir güvenlik açığı oluşturmuyor;
+* yalnız kullanıcı deneyimi/marka çakışması riski Faz 4A kapsamı dışında
+* bırakıldı. İleride ayrılmış ad listesi eklenirse burası genişletilir.
+*/
+const tenantSlugSchema = z.string().min(2, "en az 2 karakter olmalı").max(64, "en fazla 64 karakter olabilir").regex(/^[a-z][a-z0-9-]*$/, "küçük harf, rakam ve tire kullanılabilir");
+/**
+* Katı hex renk — tenant branding'inde doğrudan CSS'e yazıldığı için
+* serbest string ASLA kabul edilmez (CSS enjeksiyonu sınırı).
+*/
+const hexColorSchema = z.string().regex(/^#([0-9a-fA-F]{6}|[0-9a-fA-F]{3})$/, "geçerli bir hex renk olmalı (örn. #14b8a6)");
+z.string().regex(/^\+[1-9]\d{7,14}$/, "uluslararası biçimde olmalı (örn. +905321234567)");
+/** Muhasebe/bildirim e-postası */
+const emailSchema = z.email("geçerli bir e-posta adresi olmalı").max(160, "en fazla 160 karakter olabilir");
+/**
+* TC Kimlik Numarası checksum doğrulaması (11 hane, sıfırla başlamaz).
+* 10. hane: (tek konumların toplamı×7 - çift konumların toplamı) mod 10
+* 11. hane: ilk 10 hanenin toplamı mod 10
+*/
+function validateTckn(value) {
+	if (!/^[1-9]\d{10}$/.test(value)) return false;
+	const d = [...value].map(Number);
+	let oddSum = 0;
+	let evenSum = 0;
+	for (let i = 0; i < 9; i += 1) {
+		const digit = d[i];
+		if (digit === void 0) return false;
+		if (i % 2 === 0) oddSum += digit;
+		else evenSum += digit;
+	}
+	const tenth = d[9];
+	const eleventh = d[10];
+	if (tenth === void 0 || eleventh === void 0) return false;
+	if (((oddSum * 7 - evenSum) % 10 + 10) % 10 !== tenth) return false;
+	return d.slice(0, 10).reduce((a, b) => a + b, 0) % 10 === eleventh;
+}
+/**
+* Vergi Kimlik Numarası checksum doğrulaması (10 hane).
+* Maliye Bakanlığı algoritması.
+*/
+function validateVkn(value) {
+	if (!/^\d{10}$/.test(value)) return false;
+	const d = [...value].map(Number);
+	let sum = 0;
+	for (let i = 0; i < 9; i += 1) {
+		const digit = d[i];
+		if (digit === void 0) return false;
+		const tmp = (digit + 10 - (i + 1)) % 10;
+		if (tmp === 9) sum += tmp;
+		else sum += tmp * 2 ** (10 - (i + 1)) % 9;
+	}
+	const last = d[9];
+	if (last === void 0) return false;
+	return (10 - sum % 10) % 10 === last;
+}
+z.object({
+	/** Zitadel'den PKCE akışıyla alınan id_token */
+	idToken: z.string().min(1, "idToken gerekli").max(8192, "idToken çok uzun"),
+	/** id_token profil claim'i taşımıyorsa userinfo tamamlaması için (opsiyonel) */
+	accessToken: z.string().min(1, "accessToken boş olamaz").max(8192, "accessToken çok uzun").optional()
+});
+z.object({
+	token: z.string(),
+	user: z.object({
+		id: z.uuid(),
+		email: z.string(),
+		name: z.string()
+	})
+});
+z.object({
+	user: z.object({
+		id: z.uuid(),
+		email: z.string(),
+		name: z.string()
+	}),
+	tenants: z.array(z.object({
+		id: z.uuid(),
+		name: z.string(),
+		slug: z.string(),
+		role: memberRoleSchema
+	}))
+});
+z.object({
+	name: z.string().trim().min(2, "ad en az 2 karakter olmalı").max(120, "ad en fazla 120 karakter olabilir"),
+	slug: tenantSlugSchema
+});
+z.object({
+	id: z.uuid(),
+	name: z.string(),
+	slug: z.string(),
+	role: memberRoleSchema
+});
+/** `GET /v1/tenants/:id/members` yanıtındaki tek üye satırı */
+const tenantMemberSchema = z.object({
+	userId: z.uuid(),
+	email: z.string(),
+	name: z.string(),
+	role: memberRoleSchema
+});
+z.object({ members: z.array(tenantMemberSchema) });
+z.object({ role: memberRoleSchema });
+z.object({
+	userId: z.uuid(),
+	role: memberRoleSchema
+});
+const COUNTRY_CODE_SET = /* @__PURE__ */ new Set([
+	"AD",
+	"AE",
+	"AF",
+	"AG",
+	"AI",
+	"AL",
+	"AM",
+	"AO",
+	"AQ",
+	"AR",
+	"AS",
+	"AT",
+	"AU",
+	"AW",
+	"AX",
+	"AZ",
+	"BA",
+	"BB",
+	"BD",
+	"BE",
+	"BF",
+	"BG",
+	"BH",
+	"BI",
+	"BJ",
+	"BL",
+	"BM",
+	"BN",
+	"BO",
+	"BQ",
+	"BR",
+	"BS",
+	"BT",
+	"BV",
+	"BW",
+	"BY",
+	"BZ",
+	"CA",
+	"CC",
+	"CD",
+	"CF",
+	"CG",
+	"CH",
+	"CI",
+	"CK",
+	"CL",
+	"CM",
+	"CN",
+	"CO",
+	"CR",
+	"CU",
+	"CV",
+	"CW",
+	"CX",
+	"CY",
+	"CZ",
+	"DE",
+	"DJ",
+	"DK",
+	"DM",
+	"DO",
+	"DZ",
+	"EC",
+	"EE",
+	"EG",
+	"EH",
+	"ER",
+	"ES",
+	"ET",
+	"FI",
+	"FJ",
+	"FK",
+	"FM",
+	"FO",
+	"FR",
+	"GA",
+	"GB",
+	"GD",
+	"GE",
+	"GF",
+	"GG",
+	"GH",
+	"GI",
+	"GL",
+	"GM",
+	"GN",
+	"GP",
+	"GQ",
+	"GR",
+	"GS",
+	"GT",
+	"GU",
+	"GW",
+	"GY",
+	"HK",
+	"HM",
+	"HN",
+	"HR",
+	"HT",
+	"HU",
+	"ID",
+	"IE",
+	"IL",
+	"IM",
+	"IN",
+	"IO",
+	"IQ",
+	"IR",
+	"IS",
+	"IT",
+	"JE",
+	"JM",
+	"JO",
+	"JP",
+	"KE",
+	"KG",
+	"KH",
+	"KI",
+	"KM",
+	"KN",
+	"KP",
+	"KR",
+	"KW",
+	"KY",
+	"KZ",
+	"LA",
+	"LB",
+	"LC",
+	"LI",
+	"LK",
+	"LR",
+	"LS",
+	"LT",
+	"LU",
+	"LV",
+	"LY",
+	"MA",
+	"MC",
+	"MD",
+	"ME",
+	"MF",
+	"MG",
+	"MH",
+	"MK",
+	"ML",
+	"MM",
+	"MN",
+	"MO",
+	"MP",
+	"MQ",
+	"MR",
+	"MS",
+	"MT",
+	"MU",
+	"MV",
+	"MW",
+	"MX",
+	"MY",
+	"MZ",
+	"NA",
+	"NC",
+	"NE",
+	"NF",
+	"NG",
+	"NI",
+	"NL",
+	"NO",
+	"NP",
+	"NR",
+	"NU",
+	"NZ",
+	"OM",
+	"PA",
+	"PE",
+	"PF",
+	"PG",
+	"PH",
+	"PK",
+	"PL",
+	"PM",
+	"PN",
+	"PR",
+	"PS",
+	"PT",
+	"PW",
+	"PY",
+	"QA",
+	"RE",
+	"RO",
+	"RS",
+	"RU",
+	"RW",
+	"SA",
+	"SB",
+	"SC",
+	"SD",
+	"SE",
+	"SG",
+	"SH",
+	"SI",
+	"SJ",
+	"SK",
+	"SL",
+	"SM",
+	"SN",
+	"SO",
+	"SR",
+	"SS",
+	"ST",
+	"SV",
+	"SX",
+	"SY",
+	"SZ",
+	"TC",
+	"TD",
+	"TF",
+	"TG",
+	"TH",
+	"TJ",
+	"TK",
+	"TL",
+	"TM",
+	"TN",
+	"TO",
+	"TR",
+	"TT",
+	"TV",
+	"TW",
+	"TZ",
+	"UA",
+	"UG",
+	"UM",
+	"US",
+	"UY",
+	"UZ",
+	"VA",
+	"VC",
+	"VE",
+	"VG",
+	"VI",
+	"VN",
+	"VU",
+	"WF",
+	"WS",
+	"YE",
+	"YT",
+	"ZA",
+	"ZM",
+	"ZW"
+]);
+//#endregion
+//#region packages/contracts/src/plans.ts
+const PLAN_CODES = [
+	"free",
+	"pro",
+	"team",
+	"enterprise"
+];
+/** Platform admin yanıtlarında (bkz. contracts/platform.ts) `tenants.planCode`'un doğrulaması */
+const planCodeSchema = z.enum(PLAN_CODES, "geçerli bir plan olmalı");
+const BILLING_PERIODS = ["monthly", "yearly"];
+//#endregion
+//#region packages/contracts/src/billing.ts
+/**
+* Faturalama sözleşmeleri — fatura profili (ülke/bireysel/kurumsal/yurtdışı),
+* checkout isteği, abonelik/fatura yanıt şekilleri (spec §8.5–§8.8).
+*
+* KRİTİK KURAL: `accountingEmail` HER ÜÇ varyantta da ZORUNLU ve ülkeden
+* BAĞIMSIZDIR (brief madde 8) — tüm muhasebe e-postaları BURAYA gider.
+*/
+const countryCodeSchema = z.string().length(2, "ISO 3166-1 iki harfli ülke kodu olmalı").refine((value) => COUNTRY_CODE_SET.has(value), "geçerli bir ülke kodu olmalı");
+z.enum([
+	"tr_individual",
+	"tr_corporate",
+	"international"
+], "geçerli bir fatura profili türü olmalı");
+const trIndividualInputSchema = z.object({
+	kind: z.literal("tr_individual"),
+	country: z.literal("TR"),
+	fullName: z.string().trim().min(1, "ad soyad gerekli").max(200, "en fazla 200 karakter olabilir"),
+	tckn: z.string().refine(validateTckn, "geçerli bir TC Kimlik Numarası olmalı"),
+	address: z.string().trim().min(1, "adres gerekli").max(500, "en fazla 500 karakter olabilir"),
+	city: z.string().trim().min(1, "şehir gerekli").max(120, "en fazla 120 karakter olabilir"),
+	district: z.string().trim().min(1, "ilçe gerekli").max(120, "en fazla 120 karakter olabilir"),
+	accountingEmail: emailSchema
+});
+const trCorporateInputSchema = z.object({
+	kind: z.literal("tr_corporate"),
+	country: z.literal("TR"),
+	legalName: z.string().trim().min(1, "unvan gerekli").max(250, "en fazla 250 karakter olabilir"),
+	vkn: z.string().refine(validateVkn, "geçerli bir Vergi Kimlik Numarası olmalı"),
+	taxOffice: z.string().trim().min(1, "vergi dairesi gerekli").max(120, "en fazla 120 karakter olabilir"),
+	address: z.string().trim().min(1, "adres gerekli").max(500, "en fazla 500 karakter olabilir"),
+	city: z.string().trim().min(1, "şehir gerekli").max(120, "en fazla 120 karakter olabilir"),
+	district: z.string().trim().min(1, "ilçe gerekli").max(120, "en fazla 120 karakter olabilir"),
+	accountingEmail: emailSchema
+});
+const internationalInputSchema = z.object({
+	kind: z.literal("international"),
+	country: countryCodeSchema.refine((value) => value !== "TR", "yurt dışı profilde ülke TR olamaz"),
+	fullName: z.string().trim().min(1, "ad/unvan gerekli").max(250, "en fazla 250 karakter olabilir"),
+	address: z.string().trim().min(1, "adres gerekli").max(500, "en fazla 500 karakter olabilir"),
+	taxId: z.string().trim().max(60, "en fazla 60 karakter olabilir").optional(),
+	accountingEmail: emailSchema
+});
+const billingProfileInputSchema = z.discriminatedUnion("kind", [
+	trIndividualInputSchema,
+	trCorporateInputSchema,
+	internationalInputSchema
+]);
+z.object({
+	data: billingProfileInputSchema,
+	maskedTaxId: z.string().nullable(),
+	createdAt: z.iso.datetime(),
+	updatedAt: z.iso.datetime()
+});
+const purchasablePlanCodeSchema = z.enum(PLAN_CODES, "geçerli bir plan olmalı").refine((value) => value === "pro" || value === "team", "yalnız pro veya team paketleri için satın alma başlatılabilir");
+z.object({
+	planCode: purchasablePlanCodeSchema,
+	billingPeriod: z.enum(BILLING_PERIODS, "geçerli bir dönem olmalı")
+});
+z.object({ purchaseUrl: z.url() });
+z.object({ code: z.literal("billing_profile_required") });
+const subscriptionStatusValueSchema = z.enum([
+	"trialing",
+	"active",
+	"past_due",
+	"cancelled",
+	"refunded"
+]);
+z.object({
+	planCode: z.enum(PLAN_CODES),
+	billingPeriod: z.enum(BILLING_PERIODS).nullable(),
+	status: subscriptionStatusValueSchema.nullable(),
+	currentPeriodEnd: z.iso.datetime().nullable(),
+	cancelAtPeriodEnd: z.boolean()
+});
+const invoiceResponseSchema = z.object({
+	id: z.uuid(),
+	invoiceNumber: z.string(),
+	kind: z.enum(["invoice", "refund"]),
+	status: z.enum([
+		"draft",
+		"formalized",
+		"cancelled"
+	]),
+	amountGross: z.string(),
+	amountNet: z.string(),
+	amountVat: z.string(),
+	currencyCode: z.string(),
+	vatRate: z.string(),
+	vatExemptionCode: z.string().nullable(),
+	hasPdf: z.boolean(),
+	issuedAt: z.iso.datetime()
+});
+z.object({
+	items: z.array(invoiceResponseSchema),
+	nextCursor: z.string().nullable(),
+	hasMore: z.boolean()
+});
+z.enum(["invoice", "refund"]);
+//#endregion
+//#region packages/contracts/src/companies.ts
+/**
+* Şirket (company) sözleşmeleri (spec §6.2).
+*
+* KRİTİK KURAL: `annualRevenue` PARA alanıdır — string olarak taşınır, hiçbir
+* yerde native `number`'a çevrilip aritmetik yapılmaz (bkz. spec §6.1,
+* `bignumber.js` dışında ASLA hesaplanmaz).
+*
+* [Fix round 2 — doğruluk reviewer'ının bulduğu, Task 3'ün `deals.amount`
+* fix'iyle BİREBİR aynı sınıf hata]: DB kolonu `text`TEN `numeric(18,2)`'ye
+* taşındı (`FIELD_CATALOG.companies.annual_revenue` `sortable`/`filterable`
+* ilan ediyordu ama `text`te `ORDER BY`/`>`/`<` LEXICOGRAPHIC karşılaştırma
+* yapıyordu — bkz. `packages/db/src/schema/companies.ts` dosya başı yorumu,
+* `packages/db/drizzle/0035_companies_annual_revenue_numeric.sql`). Biçim
+* kısıtı `deals.amount` ile AYNI (`./crm.ts` `numericMoneySchema`, DRY).
+*/
+const createCompanyRequestSchema = z.object({
+	name: z.string().trim().min(1, "ad gerekli").max(200, "en fazla 200 karakter olabilir"),
+	domain: z.string().trim().max(255, "en fazla 255 karakter olabilir").optional(),
+	industry: z.string().trim().max(120, "en fazla 120 karakter olabilir").optional(),
+	size: companySizeSchema.optional(),
+	phone: z.string().trim().max(40, "en fazla 40 karakter olabilir").optional(),
+	website: z.url("geçerli bir URL olmalı").max(500, "en fazla 500 karakter olabilir").optional(),
+	address: z.string().trim().max(500, "en fazla 500 karakter olabilir").optional(),
+	city: z.string().trim().max(120, "en fazla 120 karakter olabilir").optional(),
+	country: z.string().trim().max(120, "en fazla 120 karakter olabilir").optional(),
+	/** PARA — bkz. dosya başı KRİTİK KURAL, `numeric(18,2)` ile eşleşen biçim kısıtı */
+	annualRevenue: numericMoneySchema.optional(),
+	linkedinUrl: z.url("geçerli bir URL olmalı").max(500, "en fazla 500 karakter olabilir").optional(),
+	ownerUserId: z.uuid("geçerli bir kullanıcı kimliği olmalı").optional()
+});
+const updateCompanyRequestSchema = createCompanyRequestSchema.partial();
+pagedResponseSchema(z.object({
+	id: z.uuid(),
+	name: z.string(),
+	domain: z.string().nullable(),
+	industry: z.string().nullable(),
+	size: companySizeSchema.nullable(),
+	phone: z.string().nullable(),
+	website: z.string().nullable(),
+	address: z.string().nullable(),
+	city: z.string().nullable(),
+	country: z.string().nullable(),
+	annualRevenue: z.string().nullable(),
+	linkedinUrl: z.string().nullable(),
+	ownerUserId: z.uuid().nullable(),
+	createdAt: z.iso.datetime(),
+	updatedAt: z.iso.datetime()
+}));
+//#endregion
+//#region packages/contracts/src/contacts.ts
+/**
+* Kişi (contact) sözleşmeleri (spec §6.2). `companyId` nullable — bir kişi
+* şirketsiz de var olabilir (bireysel müşteri).
+*/
+const createContactRequestSchema = z.object({
+	firstName: z.string().trim().min(1, "ad gerekli").max(120, "en fazla 120 karakter olabilir"),
+	lastName: z.string().trim().min(1, "soyad gerekli").max(120, "en fazla 120 karakter olabilir"),
+	email: z.email("geçerli bir e-posta adresi olmalı").max(160).optional(),
+	phone: z.string().trim().max(40, "en fazla 40 karakter olabilir").optional(),
+	mobile: z.string().trim().max(40, "en fazla 40 karakter olabilir").optional(),
+	jobTitle: z.string().trim().max(160, "en fazla 160 karakter olabilir").optional(),
+	linkedinUrl: z.url("geçerli bir URL olmalı").max(500, "en fazla 500 karakter olabilir").optional(),
+	avatarUrl: z.url("geçerli bir URL olmalı").max(500, "en fazla 500 karakter olabilir").optional(),
+	city: z.string().trim().max(120, "en fazla 120 karakter olabilir").optional(),
+	country: z.string().trim().max(120, "en fazla 120 karakter olabilir").optional(),
+	ownerUserId: z.uuid("geçerli bir kullanıcı kimliği olmalı").optional(),
+	source: contactSourceSchema.optional(),
+	status: contactStatusSchema.default("lead"),
+	companyId: z.uuid("geçerli bir şirket kimliği olmalı").optional()
+});
+/**
+* [Fix round 1 — Faz 10 Task 3] `status` AÇIKÇA yeniden tanımlanır; düz
+* `.partial()` YETMEZ.
+*
+* ÖLÇÜLEN KUSUR: zod 4'te `.partial()` bir alanı `.optional()` yapar ama
+* `.default()`'unu KALDIRMAZ ⇒ `createContactRequestSchema.partial()`'in
+* `status`'ü hâlâ `.default('lead')` taşıyordu ve
+* `updateContactRequestSchema.parse({ city: 'x' })` → `{ city:'x',
+* status:'lead' }` üretiyordu (canlı ölçüldü). `PATCH /v1/tenants/:id/
+* contacts/:contactId` gövdeyi `validateJson(updateContactRequestSchema)` ile
+* doğrulayıp `.set({ ...body, updatedById })` yazdığı için
+* (`apps/api/src/routes/contacts.ts:314`) `status` GÖNDERMEYEN her kısmi
+* güncelleme, `active`/`inactive` bir kişiyi SESSİZCE `lead`'e geri
+* düşürüyordu — dashboard'ın düzenleme formu `status`'ü her zaman gönderdiği
+* için belirti orada görünmüyordu; kusuru MCP'nin `update_contact` aracı
+* (yalnız verilen alanları gönderir) ortaya çıkardı.
+*
+* KARDEŞ ŞEMALARDA AYNI KUSUR YOK ama gerekçesi TESADÜF: `companies`/
+* `pipelines`'ın create şemalarında `.default()`'lu alan HİÇ YOK,
+* `updateDealRequestSchema` ise `.partial()` DEĞİL elle yazılmış bir şemadır.
+* ⇒ `.default()`'lu bir alan içeren bir create şemasından `.partial()` ile
+* update şeması TÜRETİRKEN o alanı DAİMA açıkça `.optional()` olarak ez.
+*/
+const updateContactRequestSchema = createContactRequestSchema.partial().extend({ status: contactStatusSchema.optional() });
+pagedResponseSchema(z.object({
+	id: z.uuid(),
+	firstName: z.string(),
+	lastName: z.string(),
+	email: z.string().nullable(),
+	phone: z.string().nullable(),
+	mobile: z.string().nullable(),
+	jobTitle: z.string().nullable(),
+	linkedinUrl: z.string().nullable(),
+	avatarUrl: z.string().nullable(),
+	city: z.string().nullable(),
+	country: z.string().nullable(),
+	ownerUserId: z.uuid().nullable(),
+	source: contactSourceSchema.nullable(),
+	status: contactStatusSchema,
+	companyId: z.uuid().nullable(),
+	createdAt: z.iso.datetime(),
+	updatedAt: z.iso.datetime()
+}));
+z.object({
+	code: z.literal("contact_limit_reached"),
+	limit: z.number(),
+	planCode: planCodeSchema
+});
+z.string().regex(/^[A-Z]{3}$/, "geçerli bir 3 harfli para birimi kodu olmalı (örn. TRY)");
+//#endregion
+//#region packages/contracts/src/deals.ts
+/**
+* Fırsat (deal) sözleşmeleri (spec §6.2/§6.4).
+*
+* KRİTİK KURAL: `updateDealRequestSchema` `.strict()`'tir ve `stageId`/
+* `pipelineId`/`position`/`outcome`/`closedAt` alanlarını hiç TANIMLAMAZ —
+* bu alanlar yalnız `moveDealRequestSchema` (`/move` ucu) üzerinden değişir
+* (bkz. `packages/db/src/schema/deals.ts` dosya başı KRİTİK KURAL 2,
+* `apps/api/src/routes/deals.ts`). `.strict()` altında bilinmeyen bir anahtar
+* zod'un `unrecognized_keys` hatasını üretir; bu, `apps/api/src/lib/validate.ts`
+* içindeki `ZOD_DEFAULT_MESSAGE` deseniyle ZATEN eşleşiyor (`Unrecognized key`
+* ile başlar) — bu yüzden ayrı bir Türkçe mesaj GEREKMEZ, jenerik "Geçersiz
+* istek gövdesi" mesajına düşer (bu, Global Constraints #3'ün belgelediği
+* bilinçli istisna).
+*
+* FIX ROUND 1 (bkz. task-3-report.md): `amount` DB'de `numeric(18,2)`'ye
+* taşındı (önceden `text` idi — `sortable`/`filterable` ilan edilmiş bir
+* alanın metin karşılaştırmasıyla sıralanması sessiz bir doğruluk hatasıydı).
+* Biçim kısıtı (yalnız `-?\d+(\.\d{1,2})?`, en fazla 18 anlamlı basamak) ARTIK
+* `./crm.ts`'teki `numericMoneySchema`'da PAYLAŞILIYOR (Fix round 2 —
+* `companies.annual_revenue` AYNI sınıf hatayı taşıdığı için oraya taşındı,
+* bkz. o dosyanın JSDoc'u) — bilimsel gösterim (`1e10`), `NaN`/`Infinity`,
+* çift işaret (`--5`), virgüllü ondalık (`1,5`) ve 2'den fazla ondalık basamak
+* hep REDDEDİLİR. PARA YİNE string olarak taşınır, `bignumber.js` dışında
+* hesaplanmaz.
+*/
+/** ISO 4217 kodu — 3 büyük harf (DB `char(3)` kolonuyla eşleşir) */
+const currencyCodeSchema = z.string().trim().regex(/^[A-Z]{3}$/, "ISO 4217 biçiminde 3 büyük harf olmalı (örn. TRY)");
+/** Fırsat tutarı — DB `numeric(18,2)` ile BİREBİR eşleşen ortak biçim kısıtı (bkz. `crm.ts` `numericMoneySchema`) */
+const dealAmountSchema = numericMoneySchema;
+const createDealRequestSchema = z.object({
+	title: z.string().trim().min(1, "başlık gerekli").max(200, "en fazla 200 karakter olabilir"),
+	pipelineId: z.uuid("geçerli bir pipeline kimliği olmalı"),
+	stageId: z.uuid("geçerli bir aşama kimliği olmalı"),
+	amount: dealAmountSchema.optional(),
+	currencyCode: currencyCodeSchema.default("TRY"),
+	companyId: z.uuid("geçerli bir şirket kimliği olmalı").optional(),
+	primaryContactId: z.uuid("geçerli bir kişi kimliği olmalı").optional(),
+	expectedCloseDate: z.iso.datetime("geçerli bir tarih olmalı").optional(),
+	ownerUserId: z.uuid("geçerli bir kullanıcı kimliği olmalı").optional()
+});
+/**
+* Genel güncelleme — `stageId`/`pipelineId`/`position`/`outcome`/`closedAt`
+* BİLEREK YOK (bkz. dosya başı KRİTİK KURAL). `.strict()`: bu alanlardan biri
+* gönderilirse 400 (bkz. `apps/api/test/deals.test.ts`).
+*/
+const updateDealRequestSchema = z.object({
+	title: z.string().trim().min(1, "başlık gerekli").max(200, "en fazla 200 karakter olabilir").optional(),
+	amount: dealAmountSchema.optional(),
+	currencyCode: currencyCodeSchema.optional(),
+	companyId: z.uuid("geçerli bir şirket kimliği olmalı").optional(),
+	primaryContactId: z.uuid("geçerli bir kişi kimliği olmalı").optional(),
+	expectedCloseDate: z.iso.datetime("geçerli bir tarih olmalı").optional(),
+	ownerUserId: z.uuid("geçerli bir kullanıcı kimliği olmalı").optional(),
+	lostReason: z.string().trim().max(500, "en fazla 500 karakter olabilir").optional()
+}).strict();
+/**
+* Kanban taşıma kontratı (spec §6.4) — pipeline'ın `reorderRequestSchema`'sıyla
+* AYNI komşu şekli (`beforeId`/`afterId`), yalnız `stageId` hedefi eklenir.
+* `pipelineId` YOK: hedef aşamanın pipeline'ı, fırsatın yeni pipeline'ı olarak
+* KABUL EDİLİR (bkz. routes/deals.ts) — istemcinin ayrıca tutarlı bir
+* `pipelineId` göndermesini gerektirmeden çapraz-pipeline taşımaya izin verir.
+*/
+const moveDealRequestSchema = z.object({
+	stageId: z.uuid("geçerli bir aşama kimliği olmalı"),
+	beforeId: z.uuid("geçerli bir kimlik olmalı").optional(),
+	afterId: z.uuid("geçerli bir kimlik olmalı").optional()
+});
+z.object({
+	contactId: z.uuid("geçerli bir kişi kimliği olmalı"),
+	role: z.string().trim().max(80, "en fazla 80 karakter olabilir").optional()
+});
+const dealContactResponseSchema = z.object({
+	contactId: z.uuid(),
+	role: z.string().nullable(),
+	createdAt: z.iso.datetime()
+});
+const dealResponseSchema = z.object({
+	id: z.uuid(),
+	pipelineId: z.uuid(),
+	stageId: z.uuid(),
+	companyId: z.uuid().nullable(),
+	primaryContactId: z.uuid().nullable(),
+	title: z.string(),
+	amount: z.string().nullable(),
+	currencyCode: z.string(),
+	position: z.number(),
+	expectedCloseDate: z.iso.datetime().nullable(),
+	closedAt: z.iso.datetime().nullable(),
+	outcome: dealOutcomeSchema,
+	lostReason: z.string().nullable(),
+	ownerUserId: z.uuid().nullable(),
+	createdAt: z.iso.datetime(),
+	updatedAt: z.iso.datetime()
+});
+dealResponseSchema.extend({ contacts: z.array(dealContactResponseSchema) });
+pagedResponseSchema(dealResponseSchema);
+z.object({
+	email: emailSchema,
+	role: memberRoleSchema
+});
+const inviteStatusSchema = z.enum([
+	"pending",
+	"accepted",
+	"revoked"
+]);
+/** Tenant içi davet listesi satırı — token/hash ASLA yer almaz */
+const inviteResponseSchema = z.object({
+	id: z.uuid(),
+	email: z.string(),
+	role: memberRoleSchema,
+	status: inviteStatusSchema,
+	expiresAt: z.iso.datetime(),
+	createdAt: z.iso.datetime()
+});
+z.object({ invites: z.array(inviteResponseSchema) });
+z.object({
+	tenantName: z.string(),
+	email: z.string(),
+	role: memberRoleSchema,
+	status: inviteStatusSchema,
+	expiresAt: z.iso.datetime()
+});
+z.object({
+	tenantId: z.uuid(),
+	tenantName: z.string(),
+	role: memberRoleSchema
+});
+//#endregion
+//#region packages/contracts/src/legal/company.ts
+const VENNYX_COMPANY = {
+	legalName: "Vennyx Yazılım Danışmanlık A.Ş.",
+	taxOffice: "Uluçınar Vergi Dairesi",
+	taxNumber: "9241072735",
+	tradeRegistryNo: "40690",
+	tradeRegistryCity: "Gebze",
+	mersisNo: "0924107273500001",
+	address: "Muallimköy Mah. Deniz Cad. No: 143/8 - 1.1.C1 Blok - Zemin Kat - Kapı No: Z01 - 41400 Gebze/Kocaeli",
+	kepAddress: "vennyxyazilim@hs01.kep.tr",
+	phone: "+90 (850) 242 8992",
+	website: "https://solicrm.com",
+	legalEmail: "legal@solicrm.com",
+	privacyEmail: "privacy@solicrm.com"
+};
+/** Hukuki belgelerin "Veri Sorumlusu/Sağlayıcı Kimliği" bölümünde tekrar eden paragraf */
+function companyIdentityParagraph(locale) {
+	const c = VENNYX_COMPANY;
+	if (locale === "tr") return `${c.legalName} · ${c.taxOffice} · VN ${c.taxNumber} · ${c.tradeRegistryCity} Ticaret Sicil No ${c.tradeRegistryNo} · MERSİS ${c.mersisNo} · ${c.address}`;
+	return `${c.legalName} · Tax office: ${c.taxOffice} · Tax No: ${c.taxNumber} · Trade Registry No (${c.tradeRegistryCity}): ${c.tradeRegistryNo} · MERSIS: ${c.mersisNo} · ${c.address}, Türkiye`;
+}
+/** İletişim/başvuru bölümünde tekrar eden paragraf */
+function contactParagraph(locale) {
+	const c = VENNYX_COMPANY;
+	if (locale === "tr") return `KEP: ${c.kepAddress} · Tel: ${c.phone} · Hukuki başvurular: ${c.legalEmail} · Gizlilik başvuruları: ${c.privacyEmail}`;
+	return `Registered e-mail (KEP): ${c.kepAddress} · Phone: ${c.phone} · Legal inquiries: ${c.legalEmail} · Privacy inquiries: ${c.privacyEmail}`;
+}
+contactParagraph("tr"), contactParagraph("en");
+companyIdentityParagraph("tr"), contactParagraph("tr"), companyIdentityParagraph("en"), contactParagraph("en");
+companyIdentityParagraph("tr"), contactParagraph("tr"), companyIdentityParagraph("en"), contactParagraph("en");
+companyIdentityParagraph("tr"), contactParagraph("tr"), companyIdentityParagraph("en"), contactParagraph("en");
+companyIdentityParagraph("tr"), contactParagraph("tr"), companyIdentityParagraph("en"), contactParagraph("en");
+contactParagraph("tr"), contactParagraph("en");
+contactParagraph("tr"), contactParagraph("en");
+contactParagraph("tr"), contactParagraph("en");
+companyIdentityParagraph("tr"), contactParagraph("tr"), companyIdentityParagraph("en"), contactParagraph("en");
+//#endregion
+//#region packages/contracts/src/legal/slugs.ts
+/** Spec §10'un tam listesi — 9 belge, sıra `/legal` hub'ının kart sırasıdır */
+const LEGAL_SLUGS = [
+	"terms",
+	"privacy",
+	"cookies",
+	"kvkk",
+	"distance-sales",
+	"refund-policy",
+	"dpa",
+	"subprocessors",
+	"sla"
+];
+//#endregion
+//#region packages/contracts/src/legal/types.ts
+/**
+* `@solicrm/i18n`'in `SupportedLanguage`'ı İLE AYNI kümedir ama BAĞIMSIZ
+* tanımlanır (contracts, i18n'e bağımlı OLMAMALI — katman ihlali). Senkron
+* kalması `test/legal-locale-parity.test.ts` ile mekanik olarak zorlanır.
+*/
+const LEGAL_LOCALES = ["tr", "en"];
+z.object({ documentSlug: z.enum(LEGAL_SLUGS, "geçerli bir belge olmalı") });
+const legalAcceptanceResponseSchema = z.object({
+	id: z.uuid(),
+	documentSlug: z.enum(LEGAL_SLUGS),
+	locale: z.enum(LEGAL_LOCALES),
+	effectiveDate: z.string(),
+	acceptedAt: z.iso.datetime(),
+	isCurrentVersion: z.boolean()
+});
+z.object({ acceptances: z.array(legalAcceptanceResponseSchema) });
+//#endregion
+//#region packages/contracts/src/pipelines.ts
+/**
+* Pipeline + aşama (stage) sözleşmeleri (spec §6.2/§6.4).
+*
+* KRİTİK KURAL: `probability` (yüzde 0-100) PARA DEĞİLDİR — native `number`
+* kabul edilir (bkz. spec §6.1/plan Global Constraints #19, DB kolonu
+* `numeric(5,2)`). `pipelineStageColorSchema`, `common.ts`'teki `hexColorSchema`'yı
+* YENİDEN KULLANIR — spec renk formatı vermiyor, yeni bir renk kataloğu
+* İCAT EDİLMEDİ.
+*/
+const pipelineStageColorSchema = hexColorSchema;
+z.object({
+	name: z.string().trim().min(1, "ad gerekli").max(120, "en fazla 120 karakter olabilir"),
+	isDefault: z.boolean().optional()
+}).partial();
+const pipelineResponseSchema = z.object({
+	id: z.uuid(),
+	name: z.string(),
+	isDefault: z.boolean(),
+	position: z.number(),
+	createdAt: z.iso.datetime(),
+	updatedAt: z.iso.datetime()
+});
+z.object({ pipelines: z.array(pipelineResponseSchema) });
+/**
+* `key`, programatik eşleştirme için kullanılır (ör. `is_won`/`is_lost`
+* kanban kolonunu bulmak) — bu yüzden slug benzeri kısıtlı bir biçim taşır
+* (küçük harf, rakam, alt çizgi).
+*/
+const stageKeySchema = z.string().trim().min(1, "anahtar gerekli").max(60, "en fazla 60 karakter olabilir").regex(/^[a-z][a-z0-9_]*$/, "küçük harf, rakam ve alt çizgi kullanılabilir");
+z.object({
+	key: stageKeySchema,
+	label: z.string().trim().min(1, "etiket gerekli").max(120, "en fazla 120 karakter olabilir"),
+	color: pipelineStageColorSchema.optional(),
+	probability: z.number().min(0, "en az 0 olmalı").max(100, "en fazla 100 olmalı").optional(),
+	isWon: z.boolean().optional(),
+	isLost: z.boolean().optional()
+}).partial();
+const stageResponseSchema = z.object({
+	id: z.uuid(),
+	pipelineId: z.uuid(),
+	key: z.string(),
+	label: z.string(),
+	color: z.string().nullable(),
+	position: z.number(),
+	probability: z.string().nullable(),
+	isWon: z.boolean(),
+	isLost: z.boolean(),
+	createdAt: z.iso.datetime(),
+	updatedAt: z.iso.datetime()
+});
+z.object({ stages: z.array(stageResponseSchema) });
+z.object({
+	beforeId: z.uuid("geçerli bir kimlik olmalı").optional(),
+	afterId: z.uuid("geçerli bir kimlik olmalı").optional()
+});
+//#endregion
+//#region packages/contracts/src/platform.ts
+/**
+* Platform yönetimi sözleşmeleri (spec §5.8) — yalnız Vennyx personeli
+* (`SOLICRM_ADMIN_EMAILS` allowlist'i, bkz. `apps/api/src/lib/platform-admin.ts`)
+* tarafından tüketilir.
+*/
+const platformTenantSummarySchema = z.object({
+	id: z.uuid(),
+	name: z.string(),
+	slug: z.string(),
+	planCode: planCodeSchema,
+	suspendedAt: z.iso.datetime().nullable(),
+	createdAt: z.iso.datetime(),
+	memberCount: z.number().int().nonnegative()
+});
+z.object({ tenants: z.array(platformTenantSummarySchema) });
+z.object({
+	memberCount: z.number().int().nonnegative(),
+	activeApiKeyCount: z.number().int().nonnegative(),
+	pendingInviteCount: z.number().int().nonnegative(),
+	ssoEnabled: z.boolean()
+});
+z.object({ email: z.string() });
+/**
+* `GET /v1/admin/tenants/:id/audit-logs` satırı (Faz 9 Task 2, plan kararı "E").
+*
+* `data` NEDEN `z.unknown()`: `audit_logs.data` şemasız bir jsonb kolonudur —
+* her `writeAudit()` çağrısı kendi eylemine özgü bir şekil yazar (18 dosyada 55
+* çağrı), ortak bir yapı YOKTUR. Burada bir şekil DAYATMAK, bugün geçerli bir
+* denetim satırını yarın şema hatasıyla GÖRÜNMEZ kılardı — denetim kaydı
+* append-only olduğu için o satır bir daha DÜZELTİLEMEZ. Zod v4'te `z.unknown()`
+* anahtarın VARLIĞINI yine zorunlu kılar (ölçüldü: `{}` girdisi `success:false`),
+* yani "alan hiç gelmedi" ile "alan null" ayrımı KORUNUR.
+*
+* KRİTİK — `data` NORMALİZE EDİLMİŞ şekli tanımlar: ham `tx.execute()` yolu bu
+* kolonu jsonb çift-encode kusuru nedeniyle STRING olarak döndürebilir; route
+* katmanı tek bir `JSON.parse` ile bunu geri alır (bkz.
+* `apps/api/src/routes/platform-audit.ts`).
+*/
+const adminAuditLogEntrySchema = z.object({
+	id: z.uuid(),
+	actorEmail: z.string().nullable(),
+	action: z.string(),
+	target: z.string().nullable(),
+	data: z.unknown().nullable(),
+	createdAt: z.iso.datetime()
+});
+z.object({
+	items: z.array(adminAuditLogEntrySchema),
+	nextCursor: z.string().nullable(),
+	hasMore: z.boolean()
+});
+/**
+* Zehirli/çözülmemiş webhook olayı satırı — `GET /v1/admin/webhook-events`
+* (Faz 7 Task 6'nın ürettiği uç, Faz 9 Task 3 tüketicisi).
+*
+* KRİTİK — `payload` BİLİNÇLİ OLARAK YOK: `webhook_events.payload` Whop'un ham
+* gövdesidir (müşteri/ödeme bilgisi taşır, `safeJsonb` kolonu). Bu sözleşme onu
+* TAŞIMAZ ve route katmanı kolonu SELECT bile ETMEZ — operatör ekranı olayı
+* TANIMLAMAYA yeten alanlarla sınırlıdır (kaynak/tür/zaman/hata). Ham gövdeye
+* ihtiyaç duyulursa doğru yer DB erişimidir, bir HTTP yanıtı değil.
+*
+* `error` SERBEST METİNDİR ve route katmanında hassas sayı dizileri (VKN/TCKN/
+* kart benzeri) MASKELENMİŞ olarak gelir — bkz. `apps/api/src/lib/mask-sensitive.ts`.
+*
+* İKİ "çözülmemiş" sınıfı bu üç alandan TÜRETİLİR (bkz. `lib/webhook-health.ts`):
+* `error !== null` ⇒ iş kuralı hatası; `error === null && processedAt === null`
+* ⇒ hiç işlenemedi/sıkıştı.
+*/
+const adminWebhookEventSchema = z.object({
+	id: z.uuid(),
+	source: z.string(),
+	eventType: z.string(),
+	receivedAt: z.iso.datetime(),
+	processedAt: z.iso.datetime().nullable(),
+	error: z.string().nullable()
+});
+z.object({ items: z.array(adminWebhookEventSchema) });
+z.object({ reason: z.string().trim().min(1, "kapatma gerekçesi gerekli").max(1e3, "en fazla 1000 karakter olabilir") });
+z.object({
+	id: z.uuid(),
+	closedAt: z.iso.datetime(),
+	closedReason: z.string(),
+	closedBy: z.string()
+});
+z.object({
+	effective: z.boolean(),
+	source: z.enum(["platform-setting", "env-fallback"]),
+	envFallback: z.boolean(),
+	updatedAt: z.iso.datetime().nullable(),
+	updatedByEmail: z.string().nullable()
+});
+z.object({ enabled: z.boolean("etkin değeri true veya false olmalı") });
+z.object({
+	paymentId: z.uuid(),
+	tenantId: z.uuid(),
+	tenantName: z.string(),
+	whopPaymentId: z.string(),
+	paymentStatus: z.string(),
+	/** `numeric(18,2)` — API'de DAİMA dizge (kesinlik korunur, bkz. CLAUDE.md) */
+	amountGross: z.string(),
+	refundedAmount: z.string(),
+	currencyCode: z.string(),
+	/** `'passed' | 'out_of_band' | 'not_verifiable'` — bant dışı bir ödemeyi iade etmek ÖZEL dikkat ister */
+	amountCheckStatus: z.string(),
+	paidAt: z.iso.datetime().nullable(),
+	invoice: z.object({
+		id: z.uuid(),
+		invoiceNumber: z.string(),
+		status: z.string(),
+		amountGross: z.string(),
+		currencyCode: z.string(),
+		formalizedAt: z.iso.datetime().nullable()
+	}).nullable(),
+	billing: z.object({
+		kind: z.string(),
+		country: z.string(),
+		maskedTaxId: z.string().nullable()
+	}).nullable(),
+	openRefund: z.object({
+		id: z.uuid(),
+		status: z.string(),
+		amountGross: z.string(),
+		attemptCount: z.number().int().nonnegative(),
+		lastAttemptAt: z.iso.datetime().nullable()
+	}).nullable()
+});
+z.object({
+	refundId: z.uuid(),
+	status: z.enum([
+		"pending",
+		"completed",
+		"awaiting_balance",
+		"failed"
+	]),
+	message: z.string()
+});
+const filterLeafSchema = z.object({
+	fieldKey: z.string().trim().min(1, "alan adı gerekli").max(80, "en fazla 80 karakter olabilir"),
+	operand: filterOperandSchema,
+	value: z.unknown()
+});
+const filterGroupSchema = z.lazy(() => z.object({
+	logicalOperator: filterLogicalOperatorSchema,
+	filters: z.array(filterLeafSchema).max(20, "bir grupta en fazla 20 filtre olabilir"),
+	groups: z.array(filterGroupSchema).max(5, "bir grupta en fazla 5 alt grup olabilir")
+}));
+/** Bir filtre grubu ağacının GERÇEK azami derinliğini ölçer (bkz. dosya başı KRİTİK KURAL) */
+function filterGroupDepth(group) {
+	if (group.groups.length === 0) return 1;
+	return 1 + Math.max(...group.groups.map(filterGroupDepth));
+}
+const fieldSelectionSchema = z.object({
+	fieldKey: z.string().trim().min(1, "alan adı gerekli").max(80, "en fazla 80 karakter olabilir"),
+	isVisible: z.boolean().default(true)
+});
+const sortSelectionSchema = z.object({
+	fieldKey: z.string().trim().min(1, "alan adı gerekli").max(80, "en fazla 80 karakter olabilir"),
+	direction: sortDirectionSchema
+});
+/** Derinlik aşımını yakalayan paylaşılan `superRefine` — create/update ŞEMASI ikisi de kullanır */
+function checkFilterGroupDepth(rootFilterGroup, ctx) {
+	if (rootFilterGroup === void 0) return;
+	if (filterGroupDepth(rootFilterGroup) > 5) ctx.addIssue({
+		code: "custom",
+		path: ["rootFilterGroup"],
+		message: `filtre grubu en fazla 5 seviye iç içe olabilir`
+	});
+}
+z.object({
+	name: z.string().trim().min(1, "ad gerekli").max(120, "en fazla 120 karakter olabilir"),
+	icon: z.string().trim().max(60, "en fazla 60 karakter olabilir").optional(),
+	resource: savedViewResourceSchema,
+	layout: savedViewLayoutSchema.default("table"),
+	visibility: savedViewVisibilitySchema.default("private"),
+	groupByFieldKey: z.string().trim().min(1, "alan adı gerekli").max(80, "en fazla 80 karakter olabilir").optional(),
+	isDefault: z.boolean().optional(),
+	fields: z.array(fieldSelectionSchema).max(60, "en fazla 60 kolon olabilir").default([]),
+	sorts: z.array(sortSelectionSchema).max(5, "en fazla 5 sıralama alanı olabilir").default([]),
+	rootFilterGroup: filterGroupSchema.optional()
+}).superRefine((data, ctx) => checkFilterGroupDepth(data.rootFilterGroup, ctx));
+z.object({
+	name: z.string().trim().min(1, "ad gerekli").max(120, "en fazla 120 karakter olabilir").optional(),
+	icon: z.string().trim().max(60, "en fazla 60 karakter olabilir").nullable().optional(),
+	layout: savedViewLayoutSchema.optional(),
+	visibility: savedViewVisibilitySchema.optional(),
+	groupByFieldKey: z.string().trim().min(1, "alan adı gerekli").max(80, "en fazla 80 karakter olabilir").nullable().optional(),
+	isDefault: z.boolean().optional(),
+	fields: z.array(fieldSelectionSchema).max(60, "en fazla 60 kolon olabilir").optional(),
+	sorts: z.array(sortSelectionSchema).max(5, "en fazla 5 sıralama alanı olabilir").optional(),
+	rootFilterGroup: filterGroupSchema.nullable().optional()
+}).strict().superRefine((data, ctx) => {
+	if (data.rootFilterGroup !== null) checkFilterGroupDepth(data.rootFilterGroup, ctx);
+});
+const savedViewFieldResponseSchema = z.object({
+	fieldKey: z.string(),
+	isVisible: z.boolean()
+});
+const savedViewSortResponseSchema = z.object({
+	fieldKey: z.string(),
+	direction: sortDirectionSchema
+});
+z.object({
+	id: z.uuid(),
+	name: z.string(),
+	icon: z.string().nullable(),
+	resource: savedViewResourceSchema,
+	layout: savedViewLayoutSchema,
+	/** Sidebar sırası — `pipelineResponseSchema`/`stageResponseSchema` ile TUTARLILIK için döndürülür (bu fazda bir /reorder ucu YOK, yalnız append-only, bkz. routes/saved-views.ts `nextViewPosition`) */
+	position: z.number(),
+	visibility: savedViewVisibilitySchema,
+	createdById: z.uuid(),
+	groupByFieldKey: z.string().nullable(),
+	isDefault: z.boolean(),
+	fields: z.array(savedViewFieldResponseSchema),
+	sorts: z.array(savedViewSortResponseSchema),
+	rootFilterGroup: filterGroupSchema.nullable(),
+	createdAt: z.iso.datetime(),
+	updatedAt: z.iso.datetime()
+});
+/**
+* Liste ucu (`GET /saved-views`) YANITI — özet şekil, `fields`/`sorts`/
+* `rootFilterGroup` İÇERMEZ (bkz. `apps/api/src/routes/saved-views.ts`
+* KRİTİK KURAL — N+1 önleme: bir tenant'ın TÜM görünümlerini listelerken
+* her biri için 4 ek sorgu (fields/sorts/groups/filters) atmak N+1 olurdu;
+* tam detay yalnız TEKİL görünüm uçlarında (`GET .../saved-views/:viewId`,
+* `POST .../apply`) döner — o uçlarda "N" zaten 1'dir).
+*/
+const savedViewSummaryResponseSchema = z.object({
+	id: z.uuid(),
+	name: z.string(),
+	icon: z.string().nullable(),
+	resource: savedViewResourceSchema,
+	layout: savedViewLayoutSchema,
+	position: z.number(),
+	visibility: savedViewVisibilitySchema,
+	createdById: z.uuid(),
+	isDefault: z.boolean(),
+	createdAt: z.iso.datetime(),
+	updatedAt: z.iso.datetime()
+});
+z.object({ views: z.array(savedViewSummaryResponseSchema) });
+const searchableResourceSchema = z.enum([
+	"contacts",
+	"companies",
+	"deals"
+]);
+const searchResultItemSchema = z.object({
+	id: z.uuid("geçersiz kimlik"),
+	resource: searchableResourceSchema,
+	/** Kaynağın görünen adı — contacts: ad soyad, companies: unvan, deals: başlık */
+	title: z.string(),
+	/** İkincil satır (e-posta / alan adı / tutar) — kolon boşsa `null` */
+	snippet: z.string().nullable()
+});
+z.object({ items: z.array(searchResultItemSchema) });
+const searchQuerySchema = z.object({
+	q: z.string().trim().min(1, "arama metni boş olamaz").max(200, `en fazla 200 karakter olabilir`),
+	limit: z.coerce.number("sayı olmalı").int("tam sayı olmalı").min(1, "en az 1 olmalı").max(50, `en fazla 50 olabilir`).optional(),
+	/**
+	* Aranacak kaynakları daraltır (virgülle ayrılmış). Verilmezse ÜÇÜ de
+	* aranır. Bilinmeyen bir kaynak adı 400 üretir — sessizce yok SAYILMAZ
+	* (fail-closed: "tanımadığım filtreyi görmezden gel" bir fail-open kalıbıdır).
+	*/
+	resources: z.string().transform((raw) => raw.split(",").map((part) => part.trim())).pipe(z.array(searchableResourceSchema).min(1, "en az bir kaynak belirtilmeli")).optional()
+});
+//#endregion
+//#region packages/contracts/src/sso.ts
+/**
+* BYO-SSO tenant bağlantısı sözleşmeleri (spec §5.7).
+*
+* KRİTİK KURAL: `ssoConnectionResponseSchema` `clientSecret`/`clientSecretEncrypted`
+* ALANI TAŞIMAZ — sır listeleme/okuma yanıtlarında ASLA dönmez.
+*/
+const DOMAIN_RE = /^(?!-)[a-z0-9-]{1,63}(?<!-)(\.[a-z0-9-]{1,63})+$/;
+/**
+* Genel (kişisel) e-posta sağlayıcı alan adları — bunlar SSO `emailDomain`
+* olarak KABUL EDİLMEZ (spec'in "gmail.com gibi genel bir alan adını
+* doğrulamaya çalışırsa?" tehdidi — bir tenant bu alan adını doğrulayabilseydi
+* TÜM Gmail kullanıcılarını kendi tenant'ına çekebilirdi). TAM/kapsayıcı bir
+* liste DEĞİLDİR — ileride genişletilebilir bir başlangıç kümesidir (bkz.
+* plan "Belirsiz bırakılan noktalar" #4).
+*
+* Plandaki temel liste (gmail/outlook/yahoo/icloud ailesi ve büyük bölgesel
+* sağlayıcılar) OLDUĞU GİBİ alındı. Task brifinginin "eksik görürsen genişlet"
+* talimatıyla implementasyon anında GENUINE olarak eklenenler (regex her biri
+* AYRI bir alan adı olduğu için kök alan adı listede olsa da eşleşmez):
+* Microsoft'un bölgesel tüketici alan adları (`outlook.co.uk`, `hotmail.co.uk`,
+* `live.co.uk`, `hotmail.fr`, `live.fr`, `hotmail.de`, `live.de` — `outlook.com`/
+* `hotmail.com`/`live.com` zaten listede ama bunlar ayrı TLD'ler) ve büyük ISP
+* webmail'leri (kurumsal alan adı OLMASI beklenmeyen, geniş bireysel kullanıcı
+* tabanına sahip): `comcast.net`/`att.net`/`verizon.net`/`sbcglobal.net` (ABD),
+* `btinternet.com` (İngiltere), `free.fr` (Fransa).
+*/
+const PUBLIC_EMAIL_DOMAINS = /* @__PURE__ */ new Set([
+	"gmail.com",
+	"googlemail.com",
+	"outlook.com",
+	"hotmail.com",
+	"live.com",
+	"msn.com",
+	"yahoo.com",
+	"yahoo.co.uk",
+	"yahoo.fr",
+	"ymail.com",
+	"icloud.com",
+	"me.com",
+	"mac.com",
+	"aol.com",
+	"protonmail.com",
+	"proton.me",
+	"pm.me",
+	"gmx.com",
+	"gmx.de",
+	"gmx.net",
+	"mail.com",
+	"yandex.com",
+	"yandex.ru",
+	"zoho.com",
+	"fastmail.com",
+	"hey.com",
+	"hushmail.com",
+	"tutanota.com",
+	"tuta.io",
+	"inbox.com",
+	"mail.ru",
+	"qq.com",
+	"163.com",
+	"126.com",
+	"naver.com",
+	"daum.net",
+	"web.de",
+	"t-online.de",
+	"orange.fr",
+	"laposte.net",
+	"libero.it",
+	"virgilio.it",
+	"seznam.cz",
+	"wp.pl",
+	"onet.pl",
+	"rocketmail.com",
+	"outlook.co.uk",
+	"hotmail.co.uk",
+	"live.co.uk",
+	"hotmail.fr",
+	"live.fr",
+	"hotmail.de",
+	"live.de",
+	"comcast.net",
+	"att.net",
+	"verizon.net",
+	"sbcglobal.net",
+	"btinternet.com",
+	"free.fr"
+]);
+/**
+* [Fix round 1 — Minor 1, code review bulgusu]: `PUBLIC_EMAIL_DOMAINS.has(value)`
+* yalnız TAM eşleşme kontrol ediyordu — `mail.gmail.com` gibi bir ALT alan adı
+* engeli atlıyordu (canlı doğrulandı: `ACCEPTED` dönüyordu). Pratikte risk
+* düşük (saldırgan gerçek sağlayıcının alt alan DNS'ini kontrol edemez, TXT
+* sahiplik kanıtı hâlâ gerekir) ama kafa karıştırıcı/gereksiz bir açık —
+* engellenen bir kök alan adının HER alt alan adı da (`x.gmail.com`,
+* `a.b.gmail.com` vb.) reddedilir. `value` zaten `.toLowerCase()`'dan SONRA
+* buraya gelir (zincirleme sırası), bu yüzden büyük/küçük harf normalize
+* edilmiş durumda.
+*/
+function isPublicEmailProviderDomain(domain) {
+	if (PUBLIC_EMAIL_DOMAINS.has(domain)) return true;
+	for (const blocked of PUBLIC_EMAIL_DOMAINS) if (domain.endsWith(`.${blocked}`)) return true;
+	return false;
+}
+const ssoEmailDomainSchema = z.string().trim().toLowerCase().max(255, "en fazla 255 karakter olabilir").regex(DOMAIN_RE, "geçerli bir alan adı olmalı (örn. ornek.com)").refine((value) => !isPublicEmailProviderDomain(value), "genel bir e-posta sağlayıcı alan adı SSO için kullanılamaz");
+/**
+* Format kontrolü — prod'da yalnız https zorunluluğu ROUTE katmanında ayrıca
+* uygulanır (bkz. sso-admin.ts, `NODE_ENV==='production'` kontrolü).
+*
+* [Fix round 1 — Minor 2, code review bulgusu]: bu şema ÖNCEDEN
+* `http://127.0.0.1:PORT`'u da (localhost ile AYNI) dev istisnasına
+* sokuyordu, ama `lib/ssrf-guard.ts`'in `assertPublicHttpsUrl`'i yalnız
+* `localhost` HOST ADINI dev-bypass eder — çıplak `127.0.0.1` IP'sini HER
+* ZAMAN reddeder (bkz. o dosyanın KRİTİK KURAL 1 yorumu: kritik güvenlik
+* kuralı "özel IP aralıklarına (…, 127/8, …) gitmemeli" der, istisna YALNIZ
+* `localhost` için tanımlıdır). Sonuç: `http://127.0.0.1:9000` issuer'ıyla
+* bağlantı OLUŞTURULABİLİYORDU (bu şema kabul ediyordu) ama `/test` ucu HER
+* ZAMAN başarısız oluyordu (guard reddediyordu) — güvenlik açığı değil ama
+* kafa karıştırıcı bir tutarsızlık.
+*
+* ÇÖZÜM YÖNÜ — şema DARALTILDI (guard GENİŞLETİLMEDİ): guard'ın davranışı
+* kritik güvenlik kuralının kelimesi kelimesine yazdığı, implementasyon
+* anında canlı test edilip reviewer tarafından bağımsız doğrulanmış bir
+* karardı (bkz. Task 1 raporu) — bunu GEVŞETMEK yerine şemayı guard'a
+* UYDURMAK, sistemin her yerinde AYNI (daha sıkı) kuralı korur. Artık yalnız
+* `http://localhost` (port'lu/portsuz) dev istisnası kabul edilir; çıplak
+* `127.0.0.1` (ve `::1`) issuer olarak asla kabul edilmez — bu ikisi zaten
+* `ssrf-guard.ts`'te de reddediliyordu.
+*/
+const ssoIssuerSchema = z.url("geçerli bir URL olmalı").max(500, "en fazla 500 karakter olabilir").refine((value) => value.startsWith("https://") || /^http:\/\/localhost(:\d+)?(\/|$)/.test(value), "issuer https olmalı (yalnız geliştirmede localhost istisnası var)");
+z.object({
+	issuer: ssoIssuerSchema,
+	clientId: z.string().trim().min(1, "clientId gerekli").max(255, "en fazla 255 karakter olabilir"),
+	clientSecret: z.string().trim().min(1, "clientSecret gerekli").max(2e3, "en fazla 2000 karakter olabilir"),
+	emailDomain: ssoEmailDomainSchema
+});
+z.object({
+	id: z.uuid(),
+	issuer: z.string(),
+	clientId: z.string(),
+	emailDomain: z.string(),
+	domainVerificationToken: z.string(),
+	domainVerified: z.boolean(),
+	enabled: z.boolean(),
+	createdAt: z.iso.datetime(),
+	updatedAt: z.iso.datetime()
+});
+z.object({
+	ok: z.boolean(),
+	reason: z.string().optional()
+});
+z.object({
+	code: z.literal("integration_requires_plan"),
+	requiredPlans: z.array(z.enum(["team", "enterprise"]))
+});
+z.object({
+	ssoAvailable: z.boolean(),
+	tenantId: z.uuid().optional(),
+	tenantName: z.string().optional()
+});
+z.object({ code: z.string().min(1, "code gerekli").max(200, "en fazla 200 karakter olabilir") });
+//#endregion
+//#region packages/mcp/src/config.ts
+/**
+* `npx @vennyx/solicrm-mcp`'nin ortam değişkeninden yapılandırma okuması.
+*
+* KRİTİK KURAL 1 — ZORUNLU DEĞER YOKSA AÇIK HATA, VARSAYILANA DÜŞÜLMEZ.
+* `SOLICRM_API_KEY` ve `SOLICRM_TENANT_ID` ikisi de ZORUNLUDUR ve eksikse
+* süreç net bir Türkçe mesajla ölür. Sessiz bir varsayılan (`''`, `'default'`)
+* ilk araç çağrısında anlaşılmaz bir 401/404'e dönüşürdü — bu projenin beş
+* ayrı yerden çıkmış kusur sınıfı (bkz. kök `CLAUDE.md` "Sessiz kusurlar").
+*
+* KRİTİK KURAL 2 — `SOLICRM_TENANT_ID` NEDEN GEREKLİ. SoliCRM'in URL şeması
+* `/v1/tenants/:tenantId/...`'dir (bkz. `@vennyx/solicrm`'in
+* `TenantScopedResource`) ve API anahtarının hangi tenant'a bağlı olduğunu
+* SÖYLEYEN bir uç YOK — anahtarı çözen tek yer sunucunun kendi
+* `app_resolve_api_key`'idir ve o HTTP'ye açık değildir. Yani istemci URL'i
+* kuramaz. İleride "anahtarımın tenant'ı ne" ucu eklenirse bu env
+* GEREKSİZLEŞİR (barındırılan `POST /mcp` ucu zaten tenant'ı anahtardan
+* çözdüğü için ondan hiçbir env istemez).
+*
+* KRİTİK KURAL 3 — `SOLICRM_SCOPE` BİR GÜVENLİK KAPISI DEĞİLDİR, UX
+* FİLTRESİDİR. Bu değer `tools/list`'in hangi araçları göstereceğini belirler
+* (bkz. `scope.ts` KRİTİK KURAL 3a: "LLM göremediği aracı denemez"). GERÇEK
+* yetki sınırı sunucudadır ve HER istekte yeniden hesaplanır
+* (`ROLE_SCOPE_CEILING[güncel rol] ∩ anahtar kapsamı`,
+* `apps/api/src/lib/crm-access.ts`). Bu yüzden VERİLMEZSE `admin`'e düşer:
+* tüm araçlar kaydedilir, yetkisiz olanı sunucu 403'le reddeder. `read`'e
+* düşmek daha "güvenli" GÖRÜNÜR ama değildir — hiçbir şeyi kapatmaz, yalnız
+* yazma yetkisi OLAN bir anahtarın yazma araçlarını görünmez yapıp
+* kullanıcının teşhis edemeyeceği bir arıza üretir. VERİLİRSE ve geçersizse
+* (`Admin`, `full`, ...) SESSİZCE varsayılana düşülMEZ, açık hata verilir.
+*/
+/** Bkz. KRİTİK KURAL 3 — kapsam verilmediğinde sunucuyu yetkili taraf sayarız */
+const DEFAULT_MCP_SCOPE = "admin";
+function readTrimmed(env, name) {
+	const raw = env[name];
+	if (raw === void 0) return void 0;
+	const trimmed = raw.trim();
+	return trimmed.length === 0 ? void 0 : trimmed;
+}
+function loadConfigFromEnv(env) {
+	const apiKey = readTrimmed(env, "SOLICRM_API_KEY");
+	if (apiKey === void 0) throw new Error("SOLICRM_API_KEY ortam değişkeni zorunludur (dashboard → API anahtarları bölümünden oluşturun).");
+	const tenantId = readTrimmed(env, "SOLICRM_TENANT_ID");
+	if (tenantId === void 0) throw new Error("SOLICRM_TENANT_ID ortam değişkeni zorunludur (dashboard → kiracı ayarlarındaki kiracı kimliği).");
+	const rawScope = readTrimmed(env, "SOLICRM_SCOPE");
+	let scope = DEFAULT_MCP_SCOPE;
+	if (rawScope !== void 0) {
+		const parsed = apiKeyScopeSchema.safeParse(rawScope);
+		if (!parsed.success) throw new Error(`SOLICRM_SCOPE geçersiz: "${rawScope}". Geçerli değerler: read, write, admin (boş bırakılırsa ${DEFAULT_MCP_SCOPE}).`);
+		scope = parsed.data;
+	}
+	return {
+		apiKey,
+		tenantId,
+		baseUrl: readTrimmed(env, "SOLICRM_BASE_URL"),
+		scope
+	};
+}
+//#endregion
+//#region packages/mcp/src/prompts.ts
+const MCP_PROMPT_NAMES = ["summarize_pipeline"];
+function registerSummarizePipelinePrompt(server) {
+	return server.registerPrompt("summarize_pipeline", {
+		title: "Pipeline özeti",
+		description: "Guides an agent through summarising the health of one sales pipeline using the SoliCRM tools.",
+		argsSchema: { pipelineName: z.string().describe("Name of the pipeline to summarise, as shown by list_pipelines") }
+	}, ({ pipelineName }) => ({ messages: [{
+		role: "user",
+		content: {
+			type: "text",
+			text: [
+				`Summarise the health of the SoliCRM pipeline named "${pipelineName}".`,
+				"1. Call list_pipelines and find the pipeline whose name matches; note its id and the ordered stages.",
+				"2. Call list_deals with filters { pipeline_id: \"<that id>\" } and page through with the returned nextCursor until hasMore is false.",
+				"3. Group the deals by stage. For each stage report the count, the summed amount and the oldest deal.",
+				"4. Amounts are decimal STRINGS (numeric(18,2)) — add them with exact decimal arithmetic, never with floating-point math, and keep the currency code with every total.",
+				"5. Close with the two or three stages that look most at risk (largest value sitting in the earliest stages, or deals with the oldest expectedCloseDate)."
+			].join("\n")
+		}
+	}] }));
+}
+//#endregion
+//#region packages/mcp/src/errors.ts
+/**
+* MCP katmanının KENDİ hata sınıfları — sunucudan GELMEYEN, bu paketin
+* ürettiği başarısızlıklar.
+*
+* DİL İSTİSNASI (Global Constraints #8): buradaki mesajlar İngilizce'dir.
+* "Kullanıcıya dönen mesajlar Türkçe" kuralı `apps/api`'nin `jsonError()`
+* zarfı içindir; bu paket global npm tüketicilerine (Claude Code/Desktop) gider
+* ve mesajları bir LLM okur. Sunucudan gelen TÜRKÇE metin ise ÇEVRİLMEZ,
+* `toMcpToolError` onu AYNEN taşır (bkz. `result.ts`).
+*/
+/** Bu paketin ürettiği her hatanın taban sınıfı — tüketici tek `catch` ile kapsar. */
+var SolicrmMcpError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "SolicrmMcpError";
+		Object.setPrototypeOf(this, new.target.prototype);
+	}
+};
+/**
+* Çağıranın etkin kapsamı aracın gerektirdiği minimumun ALTINDA.
+*
+* KRİTİK KURAL — bu hata TEK yetki sınırı DEĞİLDİR, İKİNCİ katmandır. Gerçek
+* yetki kontrolü sunucu tarafındadır: her araç çağrısı SDK üzerinden
+* `/v1/tenants/:id/...` uçlarına gider ve orada
+* `checkApiKeyTenantAndScope` (`apps/api/src/lib/crm-access.ts`) çalışır — o
+* kontrol `effectiveScope`'u (= `ROLE_SCOPE_CEILING[güncel rol] ∩ anahtar
+* kapsamı`) HER istekte DB'den YENİDEN hesaplar. Bu paketteki `scope` ise
+* sunucu kurulurken bir kez alınmış bir ANLIK GÖRÜNTÜDÜR (bkz. `scope.ts`).
+*/
+var McpScopeError = class extends SolicrmMcpError {
+	toolName;
+	requiredScope;
+	actualScope;
+	constructor(params) {
+		super(`Tool "${params.toolName}" requires the "${params.requiredScope}" API key scope, but this key's effective scope is "${params.actualScope}".`);
+		this.name = "McpScopeError";
+		this.toolName = params.toolName;
+		this.requiredScope = params.requiredScope;
+		this.actualScope = params.actualScope;
+	}
+};
+/**
+* Araç girdisi zod şemasını GEÇTİ ama anlamsal olarak tutarsız (ör. sıralama
+* yönü verilmiş, sıralanacak alan verilmemiş).
+*
+* NEDEN AYRI BİR HATA: bu projenin "fail-open savunma savunma değildir"
+* dersinin doğrudan uygulaması — tutarsız girdiyi SESSİZCE yok saymak
+* (`sortDirection`'ı görmezden gelip sırasız sonuç döndürmek) çağırana
+* "istediğin sıralamayı yaptım" yalanını söylerdi.
+*/
+var McpInputError = class extends SolicrmMcpError {
+	constructor(message) {
+		super(message);
+		this.name = "McpInputError";
+	}
+};
+//#endregion
+//#region packages/mcp/src/scope.ts
+/**
+* Araç adı → gereken MİNİMUM coarse kapsam kataloğu, ve iki kapsam katmanının
+* paylaştığı karşılaştırma.
+*
+* KRİTİK KURAL 1 — KATALOG TOTAL, `Record<string, ApiKeyScope>` DEĞİL.
+* `TOOL_MIN_SCOPE`'un anahtarı `McpToolName` literal union'ıdır, bu yüzden
+* `TOOL_MIN_SCOPE[name]` HİÇBİR ZAMAN `undefined` olamaz (`noUncheckedIndexedAccess`
+* altında bile). Plan taslağı `Record<string, ApiKeyScope>` + `if (need !== undefined)`
+* yazıyordu; o biçimde katalogda UNUTULAN bir araç adı `undefined` verir ve kapı
+* SESSİZCE HİÇ UYGULANMAZ — projenin "fail-open savunma savunma değildir"
+* dersinin ta kendisi. Bu biçimde ise yeni bir araç adı eklerken kapsamını
+* yazmamak DERLEME HATASIDIR.
+*
+* KRİTİK KURAL 2 — BU PAKETTEKİ `scope` BİR ANLIK GÖRÜNTÜDÜR, YETKİ SINIRI
+* DEĞİLDİR. `createSolicrmMcpServer(client, scope)` çağrıldığı anda geçerli olan
+* etkin kapsam kapanışta (closure) taşınır; süreç yaşarken YENİDEN
+* HESAPLANMAZ. Gerçek yetki sınırı sunucudadır: her araç çağrısı SDK üzerinden
+* API'ye gider ve `checkApiKeyTenantAndScope` (`apps/api/src/lib/crm-access.ts`)
+* `effectiveScope`'u (= `ROLE_SCOPE_CEILING[güncel rol] ∩ anahtar kapsamı`) HER
+* istekte DB'den yeniden hesaplar — bu yüzden anahtarın sahibi demote edilince
+* ayrı bir iptal job'ı gerekmiyor. Plan Task 3 Step 4'ün "çağrı-anı kontrolü
+* gerekli ÇÜNKÜ stdio süreci uzun ömürlü ve sahibin rolü düşürülebilir"
+* gerekçesi YANLIŞTIR: çağrı-anı kontrolü de AYNI dondurulmuş `scope`'u okur,
+* demote'u göremez. Çağrı-anı kontrolünün GERÇEK değeri aşağıdaki KRİTİK
+* KURAL 3'tür.
+*
+* KRİTİK KURAL 3 — İKİ KATMAN, İKİ AYRI KUSURA KARŞI. (a) Kayıt-anı
+* `.disable()` `tools/list`'i filtreler: LLM göremediği bir aracı denemez
+* (bağlam kirliliği + gereksiz 403 turu yok). (b) Çağrı-anı `assertScope`
+* BİZİM KENDİ REGRESYONUMUZA karşıdır: `server.ts`'in disable döngüsü
+* kaldırılır/yanlış sıraya konursa ya da bir araç kayıt listesine eklenip
+* döngüye girmezse, handler yine reddeder. İkisi bağımsız testlerle sabitlenir.
+*/
+/**
+* Kayıtlı TÜM araçların kanonik ad listesi (spec §12.1'in 22 aracı — `search`
+* dâhil; plan metninin "21 araç" sayımı hatalıdır, `search` ZATEN §12.1
+* listesindedir, ona EK değildir).
+*
+* Bu dizi TEK gerçek kaynaktır: `TOOL_MIN_SCOPE` ondan tiplenir ve
+* `test/server.test.ts` `tools/list` çıktısının bununla BİREBİR eşleştiğini
+* doğrular.
+*/
+const MCP_TOOL_NAMES = [
+	"list_contacts",
+	"get_contact",
+	"create_contact",
+	"update_contact",
+	"list_companies",
+	"get_company",
+	"create_company",
+	"update_company",
+	"list_deals",
+	"get_deal",
+	"create_deal",
+	"update_deal",
+	"move_deal_stage",
+	"list_pipelines",
+	"list_activities",
+	"create_activity",
+	"list_tasks",
+	"create_task",
+	"complete_task",
+	"create_note",
+	"search",
+	"list_saved_views"
+];
+/**
+* Kapsam rütbeleri — `apps/api/src/lib/api-key-auth.ts`'in `SCOPE_RANK`'ıyla
+* BİREBİR aynı. İçe aktarılMAZ çünkü bu paket npm'e yayınlanır ve `apps/api`'ye
+* (Hono, Drizzle, Postgres) bağımlı OLAMAZ. Drift riski TİP SEVİYESİNDE
+* kapatılmıştır: `Record<ApiKeyScope, number>` `@solicrm/contracts`'ın
+* `apiKeyScopeSchema` enum'una bağlıdır ⇒ contracts'a dördüncü bir kapsam
+* eklenirse bu satır DERLENMEZ.
+*/
+const SCOPE_RANK = {
+	read: 0,
+	write: 1,
+	admin: 2
+};
+/** `SCOPE_RANK`'ın anahtar kümesinin contracts'la aynı olduğunu ÇALIŞMA ZAMANINDA da kanıtlanabilir kılar. */
+const API_KEY_SCOPES = apiKeyScopeSchema.options;
+const TOOL_MIN_SCOPE = {
+	list_contacts: "read",
+	get_contact: "read",
+	create_contact: "write",
+	update_contact: "write",
+	list_companies: "read",
+	get_company: "read",
+	create_company: "write",
+	update_company: "write",
+	list_deals: "read",
+	get_deal: "read",
+	create_deal: "write",
+	update_deal: "write",
+	move_deal_stage: "write",
+	list_pipelines: "read",
+	list_activities: "read",
+	create_activity: "write",
+	list_tasks: "read",
+	create_task: "write",
+	complete_task: "write",
+	create_note: "write",
+	search: "read",
+	list_saved_views: "read"
+};
+/** `actual`, `required` kapsamını karşılıyor mu (read < write < admin) */
+function scopeSatisfies(actual, required) {
+	return SCOPE_RANK[actual] >= SCOPE_RANK[required];
+}
+/**
+* Çağrı-anı kapsam kapısı — HER araç handler'ının İLK satırı (bkz. KRİTİK
+* KURAL 3/b). Yetersizse fırlatır; `toMcpToolError` bunu `isError: true`
+* sonucuna çevirir.
+*/
+function assertScope(scope, toolName) {
+	const required = TOOL_MIN_SCOPE[toolName];
+	if (!scopeSatisfies(scope, required)) throw new McpScopeError({
+		toolName,
+		requiredScope: required,
+		actualScope: scope
+	});
+}
+//#endregion
+//#region packages/mcp/src/resources.ts
+const MCP_RESOURCE_NAMES = ["contact", "deal"];
+/** Kaynak → gereken minimum kapsam. `TOOL_MIN_SCOPE` gibi TOTAL (fail-open yok). */
+const RESOURCE_MIN_SCOPE = {
+	contact: "read",
+	deal: "read"
+};
+/** URI şablonu değişkeni tek değer de dizi de olabilir — ilkini alır, yoksa hata. */
+function firstVariable(value, name) {
+	const first = Array.isArray(value) ? value[0] : value;
+	if (first === void 0 || first.length === 0) throw new McpInputError(`Resource URI is missing the "${name}" segment.`);
+	return first;
+}
+function assertResourceScope(scope, name) {
+	const required = RESOURCE_MIN_SCOPE[name];
+	if (!scopeSatisfies(scope, required)) throw new McpInputError(`Resource "${name}" requires the "${required}" API key scope, but this key's effective scope is "${scope}".`);
+}
+function registerCrmResources(server, client, scope) {
+	return [["contact", server.registerResource("contact", new ResourceTemplate("solicrm://contacts/{id}", { list: void 0 }), {
+		title: "SoliCRM kişisi",
+		mimeType: "application/json"
+	}, async (uri, variables) => {
+		assertResourceScope(scope, "contact");
+		const contact = await client.contacts.get(firstVariable(variables.id, "id"));
+		return { contents: [{
+			uri: uri.href,
+			mimeType: "application/json",
+			text: JSON.stringify(contact, null, 2)
+		}] };
+	})], ["deal", server.registerResource("deal", new ResourceTemplate("solicrm://deals/{id}", { list: void 0 }), {
+		title: "SoliCRM fırsatı",
+		mimeType: "application/json"
+	}, async (uri, variables) => {
+		assertResourceScope(scope, "deal");
+		const deal = await client.deals.get(firstVariable(variables.id, "id"));
+		return { contents: [{
+			uri: uri.href,
+			mimeType: "application/json",
+			text: JSON.stringify(deal, null, 2)
+		}] };
+	})]];
+}
+//#endregion
+//#region packages/mcp/src/result.ts
+/** Beklenmeyen (bizim kusurumuz olan) hatalar için TEK jenerik metin. */
+const UNEXPECTED_ERROR_MESSAGE = "An unexpected error occurred while calling the SoliCRM API.";
+/**
+* SDK'nın hata sınıflarının `this.name` değerlerinin KAPALI listesi. Listede
+* OLMAYAN her şey jenerik metne düşer (fail-closed).
+*/
+const SDK_ERROR_NAMES = [
+	"SolicrmError",
+	"SolicrmApiError",
+	"SolicrmResponseError"
+];
+/**
+* TİP DÜZEYİ KANIT (a): gerçek `SolicrmApiError` yukarıdaki yapısal sözleşmeyi
+* KARŞILIYOR. Hiç çağrılmaz; tek işi bir sapmada `tsc -b`'yi kırmaktır.
+*/
+function assertApiErrorShape(err) {
+	return err;
+}
+/**
+* TİP DÜZEYİ KANIT (a-2): `SDK_ERROR_NAMES`'in karşılık geldiği ÜÇ sınıf
+* gerçekten var ve hepsi `Error` alt sınıfı. Biri kaldırılır/yeniden
+* adlandırılırsa import satırı ve bu imza DERLENMEZ.
+*/
+function assertSdkErrorNames(errors) {
+	return errors;
+}
+/** Her aracın ORTAK başarı biçimi — veriyi okunabilir (girintili) JSON metne çevirir. */
+function jsonResult(data) {
+	return { content: [{
+		type: "text",
+		text: JSON.stringify(data, null, 2)
+	}] };
+}
+/** Bir hatayı MCP'nin `isError: true` sonucuna çevirir (JSON-RPC hatası DEĞİL). */
+function toMcpToolError(err) {
+	return {
+		isError: true,
+		content: [{
+			type: "text",
+			text: describeError(err)
+		}]
+	};
+}
+/** Ham gövdeyi + status'ü koruyan API hatası okuması; hata bu şekilde değilse `undefined`. */
+function readApiError(err) {
+	if (!(err instanceof Error) || err.name !== "SolicrmApiError") return void 0;
+	if (!("status" in err) || typeof err.status !== "number") return void 0;
+	if (!("body" in err) || !("serverMessage" in err)) return void 0;
+	const serverMessage = err.serverMessage;
+	return {
+		status: err.status,
+		body: err.body,
+		serverMessage: typeof serverMessage === "string" ? serverMessage : void 0,
+		message: err.message
+	};
+}
+function describeError(err) {
+	if (err instanceof SolicrmMcpError) return err.message;
+	const apiError = readApiError(err);
+	if (apiError !== void 0) return JSON.stringify({
+		status: apiError.status,
+		message: apiError.serverMessage ?? apiError.message,
+		body: apiError.body
+	}, null, 2);
+	if (err instanceof Error && SDK_ERROR_NAMES.includes(err.name)) return err.message;
+	return UNEXPECTED_ERROR_MESSAGE;
+}
+//#endregion
+//#region packages/mcp/src/tools/define.ts
+/**
+* Bir araç handler'ını MCP callback'ine çevirir: kapsam kapısı → handler →
+* `jsonResult`; her fırlatma `isError: true` sonucuna dönüşür (JSON-RPC
+* hatasına DEĞİL — LLM hatayı okuyup düzeltebilsin).
+*/
+function guarded(scope, name, handler) {
+	return async (args) => {
+		try {
+			assertScope(scope, name);
+			return jsonResult(await handler(args));
+		} catch (err) {
+			return toMcpToolError(err);
+		}
+	};
+}
+/** Girdi almayan araçlar için (`list_pipelines`) — aynı üç garanti, argümansız. */
+function guardedNoArgs(scope, name, handler) {
+	return async () => {
+		try {
+			assertScope(scope, name);
+			return jsonResult(await handler());
+		} catch (err) {
+			return toMcpToolError(err);
+		}
+	};
+}
+//#endregion
+//#region packages/mcp/src/tools/ids.ts
+/**
+* Araç girdilerindeki kimlik (id) alanlarının TEK tanımı. `@solicrm/contracts`
+* kaynak gövdelerinde `z.uuid('geçerli bir <şey> kimliği olmalı')` kalıbını
+* kullanıyor; yol parametreleri için bir sözleşme şeması YOK (uçlar onları yol
+* segmentinden okur), bu yüzden aynı kalıp burada tek yerde kurulur — 8 araç
+* dosyasında tekrarlanmaz.
+*/
+/** `label` Türkçe okunur bir isimdir ("kişi", "şirket", "fırsat"...) */
+function idField(label) {
+	return z.uuid(`geçerli bir ${label} kimliği olmalı`);
+}
+//#endregion
+//#region packages/mcp/src/tools/activities.ts
+const listActivitiesInputSchema = pageQuerySchema.extend({
+	targetType: targetTypeSchema.optional(),
+	targetId: idField("hedef").optional()
+});
+function toActivityListQuery(args) {
+	if (args.targetType !== void 0 !== (args.targetId !== void 0)) throw new McpInputError("targetType and targetId must be provided together. Send both to filter by a target, or neither to list every activity.");
+	const query = {
+		cursor: args.cursor,
+		limit: args.limit
+	};
+	if (args.targetType !== void 0 && args.targetId !== void 0) query.target = {
+		type: args.targetType,
+		id: args.targetId
+	};
+	return query;
+}
+function registerActivityTools(server, client, scope) {
+	return [["list_activities", server.registerTool("list_activities", {
+		title: "Aktiviteleri listele",
+		description: "Lists activities, cursor-paginated. Pass targetType AND targetId together to see one record’s timeline.",
+		inputSchema: listActivitiesInputSchema
+	}, guarded(scope, "list_activities", (args) => client.activities.list(toActivityListQuery(args))))], ["create_activity", server.registerTool("create_activity", {
+		title: "Aktivite oluştur",
+		description: "Logs an activity (call, meeting, email, note...) against a contact, company or deal. `happensAt` is an ISO 8601 UTC timestamp.",
+		inputSchema: createActivityRequestSchema
+	}, guarded(scope, "create_activity", (args) => client.activities.create(args)))]];
+}
+//#endregion
+//#region packages/mcp/src/list-input.ts
+/**
+* CRM liste araçlarının (`list_contacts`/`list_companies`/`list_deals`/
+* `list_tasks`) PAYLAŞTIĞI girdi şeması ve SDK sorgusuna çevirisi.
+*
+* KRİTİK KURAL 1 — ALAN KATALOĞU KOPYALANMAZ. Geçerli `sortField`/`filters`
+* anahtarları `@solicrm/contracts`'ın `FIELD_CATALOG`'undan ÇALIŞMA ZAMANINDA
+* okunur (araç açıklaması bile oradan üretilir, bkz. `describeCrmListFields`);
+* bu dosyada tek bir alan adı literali YOKTUR. Doğrulamanın kendisi de burada
+* TEKRARLANMAZ — SDK'nın `buildCrmListQuery`'si `resolveField` + `sortable`/
+* `filterable` bayrak kontrolünü zaten yapıyor ve bilinmeyen/uygun olmayan
+* alanda `SolicrmError` fırlatıyor (fail-closed).
+*
+* KRİTİK KURAL 2 — SAYFA SINIRLARI DA KOPYALANMAZ. `cursor`/`limit`
+* `pageQuerySchema`'dan `.extend()` ile MİRAS ALINIR ⇒ `PAGE_MAX_LIMIT`
+* değişirse araç şeması da değişir. `z.coerce.number()`'ın JSON Schema
+* karşılığının `{"type":"integer","minimum":1,"maximum":100}` olduğu canlı
+* ölçüldü — MCP tarafında sorun ÜRETMİYOR.
+*
+* KRİTİK KURAL 3 — `sortDirection` VERİLİP `sortField` VERİLMEZSE SESSİZCE
+* YOK SAYILMAZ, HATA VERİLİR (`McpInputError`). "Tanımadığım/eksik girdiyi
+* görmezden gel" bir fail-open kalıbıdır: çağıran sıralama istediğini sanır,
+* sırasız sonuç alır.
+*
+* KRİTİK KURAL 4 — ALAN ADLARI KANONİK KATALOĞA KARŞI DOĞRULANIR, DESENE
+* KARŞI DEĞİL. İlk uygulama `propertyNames` deseni (`^[a-z][a-z0-9_]*$`)
+* kullanıyor ve JSDoc'u "`__proto__`/`constructor` şema seviyesinde
+* reddedilir" diye İDDİA ediyordu. **Ölçüm bu iddiayı ÇÜRÜTTÜ:** `constructor`
+* deseni SAĞLIYOR (tamamı küçük harf) ⇒ belgelenen koruma YOKTU. Bu, bu
+* deponun "belgelenen koruma hiç çağrılmamış olabilir" kusur sınıfının ta
+* kendisi. Düzeltme: anahtarlar `resolveField(resource, key)` ile doğrulanır;
+* o fonksiyon `Object.hasOwn` allowlist'i olduğu için prototip zincirinden
+* gelen hiçbir ad kolon adına dönüşemez. Bu yüzden şema artık bir FABRİKADIR
+* — kaynağı bilmeden doğrulama yapılamaz.
+*
+* `__proto__` İSTİSNASI, DÜRÜST HÂLİ (ölçüldü): `zod@4.4.3`'ün `z.record`'u
+* `JSON.parse` ile gelen own `__proto__` anahtarını **doğrulamadan SESSİZCE
+* ATAR** — `safeParse` `success: true` döner ama çıktı `{}`'dir, yani anahtar
+* `refine`'a HİÇ ULAŞMAZ. Sonuç güvenlik açısından güvenlidir (anahtar
+* `buildCrmListQuery`'ye ve dolayısıyla SQL'e hiç geçmez) ama bir REDDETME
+* DEĞİL, bir DÜŞÜRMEDİR; `test/list-input.test.ts` bu ayrımı olduğu gibi
+* sabitler. Diğer prototip adları (`constructor`, `hasOwnProperty`,
+* `toString`, `valueOf`, `prototype`) GERÇEKTEN reddedilir.
+*
+* BAYRAK KONTROLÜ BURADA TEKRARLANMAZ: `sortable`/`filterable` denetimi
+* SDK'nın `buildCrmListQuery`'sinde yaşar (TEK sahip). Buradaki kontrol yalnız
+* "bu kaynakta böyle bir alan VAR MI" sorusunu yanıtlar.
+*/
+/**
+* Bir CRM kaynağı için liste aracı girdi şeması. Alan adları o kaynağın
+* `FIELD_CATALOG` girdisine karşı doğrulanır (bkz. KRİTİK KURAL 4).
+*/
+function buildCrmListInputSchema(resource) {
+	const knownField = (key) => resolveField(resource, key) !== void 0;
+	const unknownFieldMessage = `${resource} kaynağında böyle bir alan yok`;
+	return pageQuerySchema.extend({
+		sortField: z.string().trim().refine(knownField, unknownFieldMessage).optional(),
+		sortDirection: sortDirectionSchema.optional(),
+		filters: z.record(z.string().trim().refine(knownField, unknownFieldMessage), z.string().max(500, "en fazla 500 karakter olabilir")).optional()
+	});
+}
+/**
+* Araç girdisini SDK'nın `CrmListQuery`'sine çevirir. `tenantId` DİYE BİR ALAN
+* YOKTUR ve olamaz — tenant her zaman `SolicrmClient`'ın kurulduğu andaki
+* değerdir (bkz. `server.ts` dosya başı).
+*/
+function toCrmListQuery(args) {
+	if (args.sortField === void 0 && args.sortDirection !== void 0) throw new McpInputError("sortDirection was given without sortField. Provide the field to sort by, or omit both.");
+	const query = {
+		cursor: args.cursor,
+		limit: args.limit,
+		filters: args.filters
+	};
+	if (args.sortField !== void 0) query.sort = {
+		field: args.sortField,
+		direction: args.sortDirection ?? "asc"
+	};
+	return query;
+}
+/**
+* Bir kaynağın sıralanabilir/filtrelenebilir alanlarını araç açıklamasına
+* yazılacak metne çevirir — LLM'in geçersiz alan adı denemesini azaltır.
+* Liste `FIELD_CATALOG`'dan ÜRETİLİR, elle yazılmaz.
+*/
+function describeCrmListFields(resource) {
+	const catalog = FIELD_CATALOG[resource];
+	const sortable = [];
+	const filterable = [];
+	for (const [key, def] of Object.entries(catalog)) {
+		if (def.sortable) sortable.push(key);
+		if (def.filterable) filterable.push(key);
+	}
+	return `Sortable fields: ${sortable.join(", ")}. Filterable fields: ${filterable.join(", ")}.`;
+}
+//#endregion
+//#region packages/mcp/src/tools/companies.ts
+const listCompaniesInputSchema = buildCrmListInputSchema("companies");
+const getCompanyInputSchema = z.object({ companyId: idField("şirket") });
+const updateCompanyInputSchema = updateCompanyRequestSchema.extend({ companyId: idField("şirket") });
+function registerCompanyTools(server, client, scope) {
+	return [
+		["list_companies", server.registerTool("list_companies", {
+			title: "Şirketleri listele",
+			description: `Lists companies in the tenant, cursor-paginated. ${describeCrmListFields("companies")}`,
+			inputSchema: listCompaniesInputSchema
+		}, guarded(scope, "list_companies", (args) => client.companies.list(toCrmListQuery(args))))],
+		["get_company", server.registerTool("get_company", {
+			title: "Şirket getir",
+			description: "Fetches a single company by id.",
+			inputSchema: getCompanyInputSchema
+		}, guarded(scope, "get_company", (args) => client.companies.get(args.companyId)))],
+		["create_company", server.registerTool("create_company", {
+			title: "Şirket oluştur",
+			description: "Creates a company. `annualRevenue` is a decimal STRING (e.g. \"1250000.00\"), never a JSON number — the API stores it as numeric(18,2).",
+			inputSchema: createCompanyRequestSchema
+		}, guarded(scope, "create_company", (args) => client.companies.create(args)))],
+		["update_company", server.registerTool("update_company", {
+			title: "Şirketi güncelle",
+			description: "Updates a company. Only the fields you send are changed.",
+			inputSchema: updateCompanyInputSchema
+		}, guarded(scope, "update_company", ({ companyId, ...body }) => client.companies.update(companyId, body)))]
+	];
+}
+//#endregion
+//#region packages/mcp/src/tools/contacts.ts
+const listContactsInputSchema = buildCrmListInputSchema("contacts");
+const getContactInputSchema = z.object({ contactId: idField("kişi") });
+const updateContactInputSchema = updateContactRequestSchema.extend({ contactId: idField("kişi") });
+function registerContactTools(server, client, scope) {
+	return [
+		["list_contacts", server.registerTool("list_contacts", {
+			title: "Kişileri listele",
+			description: `Lists contacts in the tenant, cursor-paginated. ${describeCrmListFields("contacts")}`,
+			inputSchema: listContactsInputSchema
+		}, guarded(scope, "list_contacts", (args) => client.contacts.list(toCrmListQuery(args))))],
+		["get_contact", server.registerTool("get_contact", {
+			title: "Kişi getir",
+			description: "Fetches a single contact by id.",
+			inputSchema: getContactInputSchema
+		}, guarded(scope, "get_contact", (args) => client.contacts.get(args.contactId)))],
+		["create_contact", server.registerTool("create_contact", {
+			title: "Kişi oluştur",
+			description: "Creates a contact. Counts against the tenant plan limit — a 402 result carries the limit and plan code in its body.",
+			inputSchema: createContactRequestSchema
+		}, guarded(scope, "create_contact", (args) => client.contacts.create(args)))],
+		["update_contact", server.registerTool("update_contact", {
+			title: "Kişiyi güncelle",
+			description: "Updates a contact. Only the fields you send are changed.",
+			inputSchema: updateContactInputSchema
+		}, guarded(scope, "update_contact", ({ contactId, ...body }) => client.contacts.update(contactId, body)))]
+	];
+}
+//#endregion
+//#region packages/mcp/src/tools/deals.ts
+const listDealsInputSchema = buildCrmListInputSchema("deals");
+const getDealInputSchema = z.object({ dealId: idField("fırsat") });
+const updateDealInputSchema = updateDealRequestSchema.extend({ dealId: idField("fırsat") });
+const moveDealInputSchema = moveDealRequestSchema.extend({ dealId: idField("fırsat") });
+function registerDealTools(server, client, scope) {
+	return [
+		["list_deals", server.registerTool("list_deals", {
+			title: "Fırsatları listele",
+			description: `Lists deals in the tenant, cursor-paginated. ${describeCrmListFields("deals")}`,
+			inputSchema: listDealsInputSchema
+		}, guarded(scope, "list_deals", (args) => client.deals.list(toCrmListQuery(args))))],
+		["get_deal", server.registerTool("get_deal", {
+			title: "Fırsat getir",
+			description: "Fetches a single deal by id, including its stage and linked contacts.",
+			inputSchema: getDealInputSchema
+		}, guarded(scope, "get_deal", (args) => client.deals.get(args.dealId)))],
+		["create_deal", server.registerTool("create_deal", {
+			title: "Fırsat oluştur",
+			description: "Creates a deal in a pipeline stage. `amount` is a decimal STRING (e.g. \"45000.00\"), never a JSON number. Call list_pipelines first to get valid pipelineId/stageId values.",
+			inputSchema: createDealRequestSchema
+		}, guarded(scope, "create_deal", (args) => client.deals.create(args)))],
+		["update_deal", server.registerTool("update_deal", {
+			title: "Fırsatı güncelle",
+			description: "Updates a deal. Stage/pipeline changes are rejected here by design — use move_deal_stage instead.",
+			inputSchema: updateDealInputSchema
+		}, guarded(scope, "update_deal", ({ dealId, ...body }) => client.deals.update(dealId, body)))],
+		["move_deal_stage", server.registerTool("move_deal_stage", {
+			title: "Fırsatı aşamaya taşı",
+			description: "Moves a deal to another stage (kanban). Optional beforeId/afterId place it between two neighbouring deals; omit both to append.",
+			inputSchema: moveDealInputSchema
+		}, guarded(scope, "move_deal_stage", ({ dealId, ...body }) => client.deals.move(dealId, body)))]
+	];
+}
+//#endregion
+//#region packages/mcp/src/tools/notes.ts
+function registerNoteTools(server, client, scope) {
+	return [["create_note", server.registerTool("create_note", {
+		title: "Not oluştur",
+		description: "Creates a note. `body` is a free-form JSON object (rich text document). NOTE: the note is created unlinked — it will not appear on any contact/company/deal timeline until it is attached, which this MCP server does not expose.",
+		inputSchema: createNoteRequestSchema
+	}, guarded(scope, "create_note", (args) => client.notes.create(args)))]];
+}
+//#endregion
+//#region packages/mcp/src/tools/pipelines.ts
+function registerPipelineTools(server, client, scope) {
+	return [["list_pipelines", server.registerTool("list_pipelines", {
+		title: "Pipeline’ları listele",
+		description: "Lists every pipeline with its ordered stages. Use this to resolve pipelineId/stageId before creating or moving a deal."
+	}, guardedNoArgs(scope, "list_pipelines", () => client.pipelines.list()))]];
+}
+//#endregion
+//#region packages/mcp/src/tools/search.ts
+const searchInputSchema = z.object({
+	q: searchQuerySchema.shape.q,
+	limit: searchQuerySchema.shape.limit,
+	resources: z.array(searchableResourceSchema).min(1, "en az bir kaynak belirtilmeli").optional()
+});
+function toSearchParams(args) {
+	return {
+		q: args.q,
+		limit: args.limit,
+		resources: args.resources
+	};
+}
+function registerSearchTools(server, client, scope) {
+	return [["search", server.registerTool("search", {
+		title: "Çapraz arama",
+		description: "Full-text search across contacts, companies and deals in one call. Returns the best matches only (single page, no cursor). Omit `resources` to search all three.",
+		inputSchema: searchInputSchema
+	}, guarded(scope, "search", (args) => client.search.query(toSearchParams(args))))]];
+}
+//#endregion
+//#region packages/mcp/src/tools/tasks.ts
+const listTasksInputSchema = buildCrmListInputSchema("tasks");
+const completeTaskInputSchema = z.object({ taskId: idField("görev") });
+function registerTaskTools(server, client, scope) {
+	return [
+		["list_tasks", server.registerTool("list_tasks", {
+			title: "Görevleri listele",
+			description: `Lists tasks in the tenant, cursor-paginated. ${describeCrmListFields("tasks")}`,
+			inputSchema: listTasksInputSchema
+		}, guarded(scope, "list_tasks", (args) => client.tasks.list(toCrmListQuery(args))))],
+		["create_task", server.registerTool("create_task", {
+			title: "Görev oluştur",
+			description: "Creates a task. NOTE: the task is created unlinked — it will not appear on any contact/company/deal timeline until it is attached, which this MCP server does not expose. `dueAt` is an ISO 8601 UTC timestamp.",
+			inputSchema: createTaskRequestSchema
+		}, guarded(scope, "create_task", (args) => client.tasks.create(args)))],
+		["complete_task", server.registerTool("complete_task", {
+			title: "Görevi tamamla",
+			description: "Marks a task as completed and returns the updated task.",
+			inputSchema: completeTaskInputSchema
+		}, guarded(scope, "complete_task", (args) => client.tasks.complete(args.taskId)))]
+	];
+}
+//#endregion
+//#region packages/mcp/src/tools/views.ts
+const listSavedViewsInputSchema = z.object({ resource: savedViewResourceSchema.optional() });
+function registerSavedViewTools(server, client, scope) {
+	return [["list_saved_views", server.registerTool("list_saved_views", {
+		title: "Kaydedilmiş görünümleri listele",
+		description: "Lists saved views (the tenant’s stored filter/sort presets) with their fields, sorts and filters. Optionally narrow to one CRM resource.",
+		inputSchema: listSavedViewsInputSchema
+	}, guarded(scope, "list_saved_views", (args) => client.views.list(args)))]];
+}
+//#endregion
+//#region packages/mcp/src/tools/index.ts
+function registerAllTools(server, client, scope) {
+	return [
+		...registerContactTools(server, client, scope),
+		...registerCompanyTools(server, client, scope),
+		...registerDealTools(server, client, scope),
+		...registerPipelineTools(server, client, scope),
+		...registerActivityTools(server, client, scope),
+		...registerTaskTools(server, client, scope),
+		...registerNoteTools(server, client, scope),
+		...registerSearchTools(server, client, scope),
+		...registerSavedViewTools(server, client, scope)
+	];
+}
+//#endregion
+//#region packages/mcp/src/server.ts
+/**
+* SoliCRM ürün MCP sunucusu — 22 araç, 2 kaynak, 1 prompt. TRANSPORT-AGNOSTİK:
+* bu dosya ne HTTP ne stdio bilir; çağıran (Task 4) `server.connect(transport)`
+* ile bir taşımaya bağlar.
+*
+* KRİTİK KURAL 1 — TENANT HER ZAMAN `SolicrmClient`'IN KURULDUĞU ANDAKİ
+* DEĞERDİR, HİÇBİR ARAÇ GİRDİSİNDEN GELMEZ. Bu iddia üç bağımsız mekanizmayla
+* ayakta duruyor ve üçü de ölçülmüş durumda:
+*   (a) Hiçbir araç girdi şemasında `tenantId` alanı TANIMLI DEĞİL, ve
+*       `test/server.test.ts` `tools/list`'in ÜRETTİĞİ JSON Schema'ları
+*       tarayarak bunu her araç için doğruluyor (gelecekte eklenen bir araç da
+*       yakalanır).
+*   (b) MCP SDK girdiyi zod ile ayrıştırır ve zod obje şemaları BİLİNMEYEN
+*       ANAHTARLARI ATAR (canlı ölçüldü: `{firstName, lastName, tenantId:
+*       'ATTACKER-TENANT'}` → handler `{firstName, lastName, status:'lead'}`
+*       görüyor) ⇒ bir LLM `tenantId` uydursa bile handler'a hiç ULAŞMAZ.
+*   (c) Araç handler'ları argümanları SDK'nın `CallOptions` (`{ tenantId }`)
+*       parametresine GEÇİRMEZ — `guarded()`'ın imzası öyle bir kanal
+*       sunmuyor (bkz. `tools/define.ts` KRİTİK KURAL 1).
+* `[H4]` kanıtı `test/tenant-isolation.test.ts`'te: şemaya GEÇİCİ bir
+* `tenantId` alanı eklenip (yani (b) devre dışı bırakılıp) isteğin YİNE
+* client'ın tenant'ına gittiği ölçülüyor.
+*
+* KRİTİK KURAL 2 — STATELESS: her `createSolicrmMcpServer` çağrısı KENDİ
+* kapanışını kurar. Paylaşılan mutable state, modül düzeyi cache veya
+* `reset*()` gerektiren bir singleton YOKTUR ⇒ eşzamanlı isteklerde yarış
+* yapısal olarak imkânsız. Bu pakete cache EKLENMEZ; gerekirse önce
+* "ilk dolum yarışı + hata sonrası zehirlenme" sorularının ikisi de
+* yanıtlanır (bkz. kök `CLAUDE.md` "Yeni cache = iki zorunlu soru").
+*
+* KRİTİK KURAL 3 — KAPSAM İKİ KATMANLIDIR, ama İKİSİ DE SUNUCUNUN YERİNE
+* GEÇMEZ. Ayrıntı ve dürüst sınırlar için bkz. `scope.ts` KRİTİK KURAL 2/3.
+*/
+/** `dist/cli.js`'nin (Task 4) `package.json` okumadan taşıdığı sürüm sabiti. */
+const SOLICRM_MCP_VERSION = "0.1.0";
+const SOLICRM_MCP_SERVER_NAME = "solicrm";
+/**
+* Verilen istemci ve etkin kapsam için TAZE bir `McpServer` kurar.
+*
+* @param client Kurulmuş `SolicrmClient` — `tenantId`'si (ve API anahtarı)
+*   çağıranın kimliğinden gelir; bu fonksiyon onu SORGULAMAZ ve DEĞİŞTİRMEZ.
+* @param scope Çağıranın ŞU ANDAKİ etkin kapsamı (`ROLE_SCOPE_CEILING[rol] ∩
+*   anahtar kapsamı`). Anlık görüntüdür — bkz. `scope.ts` KRİTİK KURAL 2.
+*/
+function createSolicrmMcpServer(client, scope) {
+	const server = new McpServer({
+		name: SOLICRM_MCP_SERVER_NAME,
+		version: SOLICRM_MCP_VERSION
+	});
+	const toolHandles = registerAllTools(server, client, scope);
+	const resourceHandles = registerCrmResources(server, client, scope);
+	registerSummarizePipelinePrompt(server);
+	for (const [name, handle] of toolHandles) if (!scopeSatisfies(scope, TOOL_MIN_SCOPE[name])) handle.disable();
+	for (const [name, handle] of resourceHandles) if (!scopeSatisfies(scope, RESOURCE_MIN_SCOPE[name])) handle.disable();
+	return server;
+}
+//#endregion
+//#region packages/mcp/src/transports/http.ts
+/** Bkz. KRİTİK KURAL 1(a) */
+const DEFAULT_HTTP_HOST = "127.0.0.1";
+const DEFAULT_HTTP_PORT = 3737;
+/** `--http` sunucusunun MCP yolu */
+const MCP_HTTP_PATH = "/mcp";
+const BROWSER_ORIGIN_REJECTED_MESSAGE = "Tarayıcıdan gelen istekler reddedilir (Origin başlığı taşıyor).";
+const METHOD_NOT_ALLOWED_MESSAGE = "Bu uçta yalnız POST desteklenir (stateless MCP).";
+const NOT_FOUND_MESSAGE = `Yalnız POST ${MCP_HTTP_PATH} desteklenir.`;
+function jsonResponse(status, body, headers = {}) {
+	return new Response(JSON.stringify(body), {
+		status,
+		headers: {
+			"content-type": "application/json",
+			...headers
+		}
+	});
+}
+/** Bkz. KRİTİK KURAL 1(b) — saf, tek satırlık, ayrı test edilebilir karar */
+function hasBrowserOrigin(request) {
+	const origin = request.headers.get("origin");
+	return origin !== null && origin.trim().length > 0;
+}
+/**
+* `Request → Response`. Port açmaz, soket kurmaz ⇒ testte doğrudan çağrılır.
+* Protokol hataları JSON-RPC zarfıyla transport'tan gelir; BU katmanın kendi
+* redleri (405/404/403) `{error}` zarfını kullanır — hosted uçtaki AYNI ayrım
+* (bkz. `apps/api/src/routes/mcp.ts` KRİTİK KURAL 5).
+*/
+function createMcpHttpHandler(deps) {
+	return async (request) => {
+		if (hasBrowserOrigin(request)) return jsonResponse(403, { error: BROWSER_ORIGIN_REJECTED_MESSAGE });
+		const { pathname } = new URL(request.url);
+		if (pathname !== "/mcp") return jsonResponse(404, { error: NOT_FOUND_MESSAGE });
+		if (request.method !== "POST") return jsonResponse(405, { error: METHOD_NOT_ALLOWED_MESSAGE }, { Allow: "POST" });
+		const server = deps.createServer();
+		const transport = new WebStandardStreamableHTTPServerTransport({ enableJsonResponse: true });
+		await server.connect(transport);
+		return await transport.handleRequest(request);
+	};
+}
+/**
+* `node:http` yapıştırıcısı — Node ve Bun'da AYNI şekilde çalışır (`Bun.serve`
+* kullanılmadı: paket npm'e yayınlanıyor ve `npx` altında Node ile koşuyor).
+*/
+async function startMcpHttpServer(options) {
+	const { createServer } = await import("node:http");
+	const host = options.host ?? "127.0.0.1";
+	const port = options.port ?? 3737;
+	const server = createServer((req, res) => {
+		(async () => {
+			try {
+				const chunks = [];
+				for await (const chunk of req) chunks.push(typeof chunk === "string" ? new TextEncoder().encode(chunk) : chunk);
+				const method = req.method ?? "GET";
+				const headers = new Headers();
+				for (const [key, value] of Object.entries(req.headers)) if (typeof value === "string") headers.set(key, value);
+				else if (Array.isArray(value)) for (const item of value) headers.append(key, item);
+				const hasBody = method !== "GET" && method !== "HEAD" && chunks.length > 0;
+				const request = new Request(`http://${host}:${port}${req.url ?? "/"}`, {
+					method,
+					headers,
+					...hasBody ? { body: Buffer.concat(chunks) } : {}
+				});
+				for (const [key, value] of headers) request.headers.set(key, value);
+				const response = await options.handler(request);
+				const outHeaders = {};
+				response.headers.forEach((value, key) => {
+					outHeaders[key] = value;
+				});
+				res.writeHead(response.status, outHeaders);
+				res.end(response.body === null ? void 0 : Buffer.from(await response.arrayBuffer()));
+			} catch (error) {
+				console.error("solicrm-mcp http isteği başarısız:", error);
+				if (!res.headersSent) res.writeHead(500, { "content-type": "application/json" });
+				res.end(JSON.stringify({ error: "Sunucu hatası" }));
+			}
+		})();
+	});
+	await new Promise((resolve, reject) => {
+		server.once("error", reject);
+		server.listen(port, host, () => {
+			server.removeListener("error", reject);
+			resolve();
+		});
+	});
+	const address = server.address();
+	return {
+		host,
+		port: typeof address === "object" && address !== null ? address.port : port,
+		close: () => new Promise((resolve, reject) => {
+			server.close((err) => err === void 0 || err === null ? resolve() : reject(err));
+		})
+	};
+}
+//#endregion
+//#region packages/mcp/src/transports/stdio.ts
+async function connectStdioTransport(server) {
+	const transport = new StdioServerTransport();
+	await server.connect(transport);
+	return transport;
+}
+//#endregion
+//#region packages/mcp/src/cli.ts
+const PORT_PATTERN = /^[0-9]+$/;
+const USAGE = `solicrm-mcp — SoliCRM MCP sunucusu (v${SOLICRM_MCP_VERSION})
+Kullanım:
+  solicrm-mcp                 stdio taşımasıyla başlar (varsayılan)
+  solicrm-mcp --http [port]   bağımsız Streamable HTTP sunucusu (varsayılan port ${DEFAULT_HTTP_PORT})
+  solicrm-mcp --help          bu metni yazar
+  solicrm-mcp --version       sürümü yazar
+Ortam değişkenleri:
+  SOLICRM_API_KEY    (zorunlu) scrm_ ile başlayan tenant API anahtarı
+  SOLICRM_TENANT_ID  (zorunlu) kiracı kimliği (UUID)
+  SOLICRM_BASE_URL   (opsiyonel) API tabanı; verilmezse https://api.solicrm.com
+  SOLICRM_SCOPE      (opsiyonel) read|write|admin — yalnız tools/list filtresi,
+                     gerçek yetki sunucuda her istekte yeniden hesaplanır`;
+/** Bkz. KRİTİK KURAL 3 */
+function parsePort(raw) {
+	if (!PORT_PATTERN.test(raw)) throw new Error(`--http için geçersiz port: "${raw}". 1–65535 arası bir tam sayı bekleniyor.`);
+	const port = Number.parseInt(raw, 10);
+	if (port < 1 || port > 65535) throw new Error(`--http için geçersiz port: "${raw}". 1–65535 arası bir tam sayı bekleniyor.`);
+	return port;
+}
+function parseCliArgs(argv) {
+	let transport = "stdio";
+	let port;
+	let help = false;
+	let version = false;
+	for (let i = 0; i < argv.length; i += 1) {
+		const arg = argv[i];
+		if (arg === void 0) continue;
+		if (arg === "--help" || arg === "-h") {
+			help = true;
+			continue;
+		}
+		if (arg === "--version" || arg === "-v") {
+			version = true;
+			continue;
+		}
+		if (arg === "--http") {
+			transport = "http";
+			const next = argv[i + 1];
+			if (next !== void 0 && !next.startsWith("-")) {
+				port = parsePort(next);
+				i += 1;
+			}
+			continue;
+		}
+		if (arg.startsWith("--http=")) {
+			transport = "http";
+			port = parsePort(arg.slice(7));
+			continue;
+		}
+		throw new Error(`Bilinmeyen argüman: "${arg}". Kullanım için --help.`);
+	}
+	return {
+		transport,
+		port,
+		help,
+		version
+	};
+}
+/**
+* `@vennyx/solicrm`'i ÇALIŞMA ZAMANINDA import eder. `await import(...)`
+* BİLİNÇLİ: modül düzeyinde statik bir import, `--help`/`--version` gibi
+* SDK'ya hiç ihtiyaç duymayan yolları da SDK'nın yüklenmesine bağlardı.
+*/
+async function createRealClient(config) {
+	const { SolicrmClient } = await import("@vennyx/solicrm");
+	return new SolicrmClient({
+		apiKey: config.apiKey,
+		tenantId: config.tenantId,
+		baseUrl: config.baseUrl
+	});
+}
+async function runCli(argv, deps = {}) {
+	const log = deps.log ?? ((message) => console.error(message));
+	const args = parseCliArgs(argv);
+	if (args.help) {
+		log(USAGE);
+		return;
+	}
+	if (args.version) {
+		log(SOLICRM_MCP_VERSION);
+		return;
+	}
+	const config = (deps.loadConfig ?? loadConfigFromEnv)(deps.env ?? process.env);
+	const createClient = deps.createClient;
+	const client = createClient === void 0 ? await createRealClient(config) : createClient(config);
+	const createServer = deps.createServer ?? createSolicrmMcpServer;
+	if (args.transport === "http") {
+		const running = await (deps.startHttp ?? (async ({ handler, port }) => await startMcpHttpServer({
+			handler,
+			port
+		})))({
+			handler: createMcpHttpHandler({ createServer: () => createServer(client, config.scope) }),
+			port: args.port
+		});
+		log(`solicrm-mcp HTTP dinliyor: http://${running.host}:${running.port}${MCP_HTTP_PATH}`);
+		return;
+	}
+	await (deps.connectStdio ?? connectStdioTransport)(createServer(client, config.scope));
+	log("solicrm-mcp stdio taşımasında hazır.");
+}
+//#endregion
+//#region packages/mcp/src/client.ts
+/**
+* TİP DÜZEYİ KANIT — gerçek `SolicrmClient` bu dar yüzeyi KARŞILIYOR.
+* Fonksiyon hiç ÇAĞRILMAZ; tek işi `tsc -b`'yi bir sapmada kırmaktır (bir
+* metot adı değişir/kaldırılırsa derleme burada patlar). `as` cast'i YOK,
+* çalışma zamanı maliyeti YOK.
+*/
+function assertSolicrmClientSatisfiesMcpSurface(client) {
+	return client;
+}
+//#endregion
+export { API_KEY_SCOPES, BROWSER_ORIGIN_REJECTED_MESSAGE, DEFAULT_HTTP_HOST, DEFAULT_HTTP_PORT, DEFAULT_MCP_SCOPE, MCP_HTTP_PATH, MCP_PROMPT_NAMES, MCP_RESOURCE_NAMES, MCP_TOOL_NAMES, McpInputError, McpScopeError, RESOURCE_MIN_SCOPE, SCOPE_RANK, SDK_ERROR_NAMES, SOLICRM_MCP_SERVER_NAME, SOLICRM_MCP_VERSION, SolicrmMcpError, TOOL_MIN_SCOPE, UNEXPECTED_ERROR_MESSAGE, USAGE, apiKeyScopeSchema, assertApiErrorShape, assertScope, assertSdkErrorNames, assertSolicrmClientSatisfiesMcpSurface, buildCrmListInputSchema, connectStdioTransport, createMcpHttpHandler, createSolicrmMcpServer, describeCrmListFields, firstVariable, guarded, guardedNoArgs, hasBrowserOrigin, idField, jsonResult, loadConfigFromEnv, parseCliArgs, parsePort, registerActivityTools, registerAllTools, registerCompanyTools, registerContactTools, registerCrmResources, registerDealTools, registerNoteTools, registerPipelineTools, registerSavedViewTools, registerSearchTools, registerSummarizePipelinePrompt, registerTaskTools, runCli, scopeSatisfies, startMcpHttpServer, toActivityListQuery, toCrmListQuery, toMcpToolError, toSearchParams };