# Paketler ve Güncel Sürümler

> Tüm @tecof npm paketleri: güncel sürüm, kurulum komutu, giriş noktaları, peer bağımlılıklar ve sürüm geçmişi. Sürümler npm kayıt defterinden saatlik olarak yenilenir.
>
> Kaynak: https://tecof-app-dev.vercel.app/packages · Veri: npm kayıt defteri · Alındı: 2026-11-12

| Paket | Sürüm | Yayın tarihi | Ne işe yarar |
| :--- | :--- | :--- | :--- |
| `@tecof/cli` | 0.2.0 | 11 Eki 2026 | Tecof CLI |
| `@tecof/theme-editor` | 0.0.98 | 12 Kas 2026 | Tecof Studio (theme-editor) |
| `@tecof/analytics` | 0.0.3 | 28 Tem 2026 | Analytics SDK |
| `@tecof/app-sdk` | 0.1.0 | 11 Eki 2026 | App SDK (sunucu) |
| `@tecof/app-bridge` | 0.1.0 | 11 Eki 2026 | App Bridge |
| `@tecof/app-ui` | 0.1.0 | 11 Eki 2026 | App UI (tasarım kimliği) |
| `@tecof/invoice-kit` | 0.2.0 | 11 Eki 2026 | Invoice Kit |
| `@tecof/mcp` | 0.2.7 | 28 Eyl 2026 | Tecof MCP (stdio) |

## Tema

Next.js temaları ve Tecof Studio için.

### @tecof/theme-editor

**Güncel sürüm:** 0.0.98 (12 Kas 2026) · [npm](https://www.npmjs.com/package/@tecof/theme-editor)

Görsel sayfa editörü (TecofEditor / TecofStudio), yayın renderer’ı (TecofRender), alan fabrikaları, API istemcisi, stil/tema motoru ve e-posta doküman modeli.

```bash
npm install @tecof/theme-editor @tiptap/core @tiptap/pm @tiptap/react lucide-react
```

Giriş noktaları:

- `@tecof/theme-editor` — Editör, renderer, alanlar, API istemcisi, yardımcılar
- `@tecof/theme-editor/styles.css` — Editör ve alan arayüzü stilleri (zorunlu)
- `@tecof/theme-editor/email` — Pazarlama e-postası doküman modeli ve HTML render’ı
- `@tecof/theme-editor/under-construction` — Yapım aşaması sayfası bileşeni

Peer bağımlılıklar: `react@^18 || ^19`, `react-dom@^18 || ^19`, `@tiptap/pm@^3.0.0`, `@tiptap/core@^3.0.0`, `lucide-react@>=0.408.0 <2`, `@tiptap/react@^3.0.0`

Örnek (app/[slug]/page.tsx):

```tsx
import { TecofApiClient, TecofRender } from "@tecof/theme-editor";
import { editorConfig } from "@/app/editor-config";

const client = new TecofApiClient(process.env.NEXT_PUBLIC_BASE_URL!, process.env.NEXT_PUBLIC_MERCHANT_SECRET_KEY!);

export default async function Page({ params }: { params: Promise<{ slug: string }> }) {
  const { slug } = await params;
  const res = await client.getPublishedPage(slug, "tr");
  if (!res.success || !res.data) return null;
  return <TecofRender data={res.data.draftData} config={editorConfig} />;
}
```

Sürüm geçmişi:

- 0.0.98 — 12 Kas 2026
- 0.0.97 — 15 Eki 2026
- 0.0.96 — 23 Eyl 2026
- 0.0.94 — 21 Eyl 2026
- 0.0.93 — 21 Eyl 2026

Belgeler: [Tecof Studio’ya giriş](/theme-editor) · [Alanlar](/editor-fields) · [Yayın render’ı](/editor-render)

### @tecof/analytics

**Güncel sürüm:** 0.0.3 (28 Tem 2026) · [npm](https://www.npmjs.com/package/@tecof/analytics)

Gizlilik öncelikli, hafif vitrin analitiği: izleme betiğini enjekte eden TecofAnalyticsProvider ve özel olaylar için useTecofAnalytics().

```bash
npm install @tecof/analytics
```

Giriş noktaları:

- `@tecof/analytics` — TecofAnalyticsProvider, useTecofAnalytics (React 18/19)

Peer bağımlılıklar: `react@^18 || ^19`, `react-dom@^18 || ^19`

Örnek (app/layout.tsx):

```tsx
import { TecofAnalyticsProvider } from "@tecof/analytics";

<TecofAnalyticsProvider merchantId={merchantId} />
```

Sürüm geçmişi:

- 0.0.3 — 28 Tem 2026
- 0.0.2 — 13 Tem 2026
- 0.0.1 — 30 Haz 2026

Belgeler: [Tema mimarisi: analytics](/storefronts#analytics-entegrasyonu)

## Uygulama

Panelde çalışan partner uygulamaları için.

### @tecof/app-sdk

**Güncel sürüm:** 0.1.0 (11 Eki 2026) · [npm](https://www.npmjs.com/package/@tecof/app-sdk)

Partner uygulamalarının sunucu tarafı: oturum token’ı doğrulama, webhook/aksiyon imzası, kurulum token’ı ve /api/v1 istemcisi (siparişler, ayarlar, Vault, metafield, Tools API).

```bash
npm install @tecof/app-sdk
```

Giriş noktaları:

- `@tecof/app-sdk` — TecofApp, createWebhookHandler, verifyActionRequest, client(…) — Node.js ≥ 18

Gereksinim: node >=18

Örnek (lib/tecof.ts):

```ts
import { TecofApp } from "@tecof/app-sdk";

export const tecof = new TecofApp({
  clientId: process.env.TECOF_CLIENT_ID!,
  clientSecret: process.env.TECOF_CLIENT_SECRET!,
});
```

Sürüm geçmişi:

- 0.1.0 — 11 Eki 2026: İlk sürüm: oturum token’ı, imza doğrulama, kurulum token’ı ve /api/v1 istemcisi; sır döndürmede kendiliğinden süresi dolan önceki sır.

Belgeler: [Kimlik ve kapsamlar](/app-auth) · [Webhook’lar](/app-webhooks) · [Uygulama API’si](/app-api)

### @tecof/app-bridge

**Güncel sürüm:** 0.1.0 (11 Eki 2026) · [npm](https://www.npmjs.com/package/@tecof/app-bridge)

Panele gömülü (iframe) uygulamalar için el sıkışma, oturum token’ı, toast, onay, başlık ve gezinme; React sağlayıcısı ve kancaları.

```bash
npm install @tecof/app-bridge
```

Giriş noktaları:

- `@tecof/app-bridge` — Çerçeveden bağımsız köprü istemcisi
- `@tecof/app-bridge/react` — AppBridgeProvider, useSessionFetch ve diğer kancalar

Peer bağımlılıklar: `react@>=18`

Örnek (app/settings/page.tsx):

```tsx
"use client";
import { useSessionFetch } from "@tecof/app-bridge/react";

const fetch = useSessionFetch(); // her isteğe 60 sn'lik oturum token'ını ekler
```

Sürüm geçmişi:

- 0.1.0 — 11 Eki 2026: İlk sürüm.

Belgeler: [App Bridge](/app-bridge)

### @tecof/app-ui

**Güncel sürüm:** 0.1.0 (11 Eki 2026) · [npm](https://www.npmjs.com/package/@tecof/app-ui)

Tecof panel görünümünde uygulama arayüzü: React Suite 6 + Tailwind CSS 4 + lucide; AppShell, DataTable, StatusBadge, AppForm ve sunucu-güvenli şema (@tecof/app-ui/schema).

```bash
npm install @tecof/app-ui @tecof/app-bridge rsuite lucide-react geist
```

Giriş noktaları:

- `@tecof/app-ui` — İstemci bileşenleri ("use client")
- `@tecof/app-ui/schema` — Sunucu-güvenli şema, doğrulayıcılar, biçimlendiriciler
- `@tecof/app-ui/styles.css` — Tailwind 4 belirteçleri ve React Suite eşlemesi

Peer bağımlılıklar: `react@^19.0.0`, `rsuite@^6.2.0`, `react-dom@^19.0.0`, `lucide-react@>=0.400.0 || ^1.0.0`, `@tecof/app-bridge@^0.1.0`

Örnek (app/globals.css):

```css
@layer theme, base, rsuite, components, utilities;
@import "tailwindcss";
@import "rsuite/dist/rsuite-no-reset.min.css" layer(rsuite);
@import "@tecof/app-ui/styles.css";
```

Sürüm geçmişi:

- 0.1.0 — 11 Eki 2026: İlk sürüm: Tecof uygulama tasarım kimliği, tek şemalı formlar, TR telefon/VKN/TCKN/IBAN doğrulayıcıları.

Belgeler: [Tasarım kimliği](/app-ui) · [Formlar ve şema](/app-forms)

### @tecof/invoice-kit

**Güncel sürüm:** 0.2.0 (11 Eki 2026) · [npm](https://www.npmjs.com/package/@tecof/invoice-kit)

Tecof siparişini doğru Türk faturasına çeviren çekirdek: VKN/TCKN, alıcı sınıflandırma, KDV/indirim/yuvarlama, tutarın yazıyla gösterimi, UBL-TR 1.2 XML; fatura uygulamalarının ortak arayüzü (/ui).

```bash
npm install @tecof/invoice-kit
```

Giriş noktaları:

- `@tecof/invoice-kit` — Bağımlılıksız çekirdek (Node ≥ 18 ve tarayıcı)
- `@tecof/invoice-kit/ui` — Fatura uygulaması ekranları (InvoiceShell, ActionFrame…)
- `@tecof/invoice-kit/ui.css` — Arayüz stilleri

Peer bağımlılıklar: `react@^19.0.0`, `rsuite@^6.2.0`, `react-dom@^19.0.0`, `lucide-react@>=0.400.0 || ^1.0.0`, `@tecof/app-ui@^0.1.0`, `@tecof/app-bridge@^0.1.0`

Gereksinim: node >=18

Örnek (lib/invoice.ts):

```ts
import { toInvoiceDraft, buildUblInvoice } from "@tecof/invoice-kit";

const draft = toInvoiceDraft(order, { defaultVatRate: 20 });
if (draft.warnings.some((w) => w.code === "total-mismatch")) {
  // insan kontrolü gerekir
}
```

Sürüm geçmişi:

- 0.2.0 — 11 Eki 2026: @tecof/invoice-kit/ui (fatura uygulamalarının ortak arayüzü); siparişin satır indirim payları kullanılır (KDV matrahı indirim sonrası).
- 0.1.0 — 11 Eki 2026: İlk sürüm: sipariş → Türk faturası çekirdeği ve UBL-TR 1.2.

Belgeler: [Fatura uygulamaları](/app-invoicing)

## CLI ve AI

Terminal, CI ve AI ajanları için.

### @tecof/cli

**Güncel sürüm:** 0.2.0 (11 Eki 2026) · [npm](https://www.npmjs.com/package/@tecof/cli)

tecof komutu: cihaz akışıyla giriş, tema ve uygulama Spaces’leri, artımlı push, staged sürüm, anında canlıya alma/geri alma, bulut geliştirme, CI token’ları ve ajan modu.

```bash
npm install -g @tecof/cli
```

Kurmadan çalıştırmak için:

```bash
npx @tecof/cli@latest doctor
```

Giriş noktaları:

- `tecof` — Komut satırı (Node.js ≥ 20, çalışma zamanı bağımlılığı yok)

Gereksinim: node >=20

Örnek (Terminal):

```bash
tecof login
tecof doctor
tecof theme ls
```

Sürüm geçmişi:

- 0.2.0 — 11 Eki 2026: Tecof Spaces: tema/uygulama push, numaralı staged sürümler, promote/rollback, JSON makbuzları ve ajan modu; backend sınırlarıyla hizalama ve base-moved yönlendirmesi; `tecof app init` şablonları @tecof/app-ui kullanır.
- 0.1.0 — 11 Eki 2026: İlk sürüm: cihaz akışıyla giriş, `tecof app init / dev / deploy`, uygulama sırrı döndürme; çıkışta token sunucuda iptal edilir.

Belgeler: [CLI başvurusu](/cli-reference) · [Tema hızlı başlangıç](/theme-quickstart) · [Uygulama hızlı başlangıç](/app-quickstart)

### @tecof/mcp

**Güncel sürüm:** 0.2.7 (28 Eyl 2026) · [npm](https://www.npmjs.com/package/@tecof/mcp)

Tema reposunun içinden çalışan stdio MCP sunucusu: bileşen kataloğunu diskten okur, Developer API ile sayfa oluşturur/günceller; remote modda backend araç kataloğunu kullanır.

```bash
npx -y @tecof/mcp@latest
```

Giriş noktaları:

- `tecof-mcp` — stdio MCP sunucusu (Node.js ≥ 20)

Gereksinim: node >=20

Örnek (.mcp.json):

```json
{
  "mcpServers": {
    "tecof": { "command": "npx", "args": ["-y", "@tecof/mcp@latest"] }
  }
}
```

Sürüm geçmişi:

- 0.2.7 — 28 Eyl 2026
- 0.2.6 — 21 Eyl 2026
- 0.2.5 — 19 Eyl 2026
- 0.2.4 — 18 Eyl 2026
- 0.2.3 — 14 Eyl 2026

Belgeler: [Tecof MCP](/mcp#tecofmcp-stdio-paketi)

## Sürüm politikası

- `0.0.x` sürümlerde npm’in `^` aralığı yalnız aynı yamayı kabul eder (`^0.0.96` = `0.0.96`); yükseltme için sürümü `package.json`’da elle değiştirin.
- `0.x.y` sürümlerde `^0.2.0` yalnız `0.2.x` yamalarını alır.
- Bir temanın ya da uygulamanın kullandığı sürümü `npm ls @tecof/<paket>` ile görebilirsiniz.