İçeriğe geç
Docs

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.

npm kayıt defteri · 12 Kas 2026 · saatte bir yenilenir

PaketSürümYayınNe işe yarar
@tecof/cli0.2.011 Eki 2026Tecof CLI
@tecof/theme-editor0.0.9812 Kas 2026Tecof Studio (theme-editor)
@tecof/analytics0.0.328 Tem 2026Analytics SDK
@tecof/app-sdk0.1.011 Eki 2026App SDK (sunucu)
@tecof/app-bridge0.1.011 Eki 2026App Bridge
@tecof/app-ui0.1.011 Eki 2026App UI (tasarım kimliği)
@tecof/invoice-kit0.2.011 Eki 2026Invoice Kit
@tecof/mcp0.2.728 Eyl 2026Tecof MCP (stdio)

Tema#

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

@tecof/theme-editor

Tecof Studio (theme-editor)

v0.0.98npm

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

Yayın tarihi
12 Kas 2026
Gereksinim
—
Lisans · boyut
MIT · 16.3 MB
Terminal
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 || ^19react-dom@^18 || ^19@tiptap/pm@^3.0.0@tiptap/core@^3.0.0lucide-react@>=0.408.0 <2@tiptap/react@^3.0.0

Sürüm geçmişi

  1. 0.0.98 · 12 Kas 2026
  2. 0.0.97 · 15 Eki 2026
  3. 0.0.96 · 23 Eyl 2026
  4. 0.0.94 · 21 Eyl 2026
  5. 0.0.93 · 21 Eyl 2026

Toplam 94 sürüm · tümü npm’de

app/[slug]/page.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} />;
}

@tecof/analytics

Analytics SDK

v0.0.3npm

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

Yayın tarihi
28 Tem 2026
Gereksinim
—
Lisans · boyut
— · 38 KB
Terminal
npm install @tecof/analytics

Giriş noktaları

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

Peer bağımlılıklar

react@^18 || ^19react-dom@^18 || ^19

Sürüm geçmişi

  1. 0.0.3 · 28 Tem 2026
  2. 0.0.2 · 13 Tem 2026
  3. 0.0.1 · 30 Haz 2026
app/layout.tsx
import { TecofAnalyticsProvider } from "@tecof/analytics";

<TecofAnalyticsProvider merchantId={merchantId} />

Uygulama#

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

@tecof/app-sdk

App SDK (sunucu)

v0.1.0npm

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).

Yayın tarihi
11 Eki 2026
Gereksinim
node >=18
Lisans · boyut
UNLICENSED · 262 KB
Terminal
npm install @tecof/app-sdk

Giriş noktaları

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

Sürüm geçmişi

  1. 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.

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

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

@tecof/app-bridge

App Bridge

v0.1.0npm

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ı.

Yayın tarihi
11 Eki 2026
Gereksinim
—
Lisans · boyut
UNLICENSED · 154 KB
Terminal
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

Sürüm geçmişi

  1. 0.1.0 · 11 Eki 2026

    İlk sürüm.

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

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

@tecof/app-ui

App UI (tasarım kimliği)

v0.1.0npm

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).

Yayın tarihi
11 Eki 2026
Gereksinim
—
Lisans · boyut
UNLICENSED · 683 KB
Terminal
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.0rsuite@^6.2.0react-dom@^19.0.0lucide-react@>=0.400.0 || ^1.0.0@tecof/app-bridge@^0.1.0

Sürüm geçmişi

  1. 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ı.

app/globals.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";

@tecof/invoice-kit

Invoice Kit

v0.2.0npm

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).

Yayın tarihi
11 Eki 2026
Gereksinim
node >=18
Lisans · boyut
UNLICENSED · 622 KB
Terminal
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.0rsuite@^6.2.0react-dom@^19.0.0lucide-react@>=0.400.0 || ^1.0.0@tecof/app-ui@^0.1.0@tecof/app-bridge@^0.1.0

Sürüm geçmişi

  1. 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ı).

  2. 0.1.0 · 11 Eki 2026

    İlk sürüm: sipariş → Türk faturası çekirdeği ve UBL-TR 1.2.

lib/invoice.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
}

CLI ve AI#

Terminal, CI ve AI ajanları için.

@tecof/cli

Tecof CLI

v0.2.0npm

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.

Yayın tarihi
11 Eki 2026
Gereksinim
node >=20
Lisans · boyut
UNLICENSED · 867 KB
Terminal
npm install -g @tecof/cli
Kurmadan çalıştır
npx @tecof/cli@latest doctor

Giriş noktaları

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

Sürüm geçmişi

  1. 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.

  2. 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.

Terminal
tecof login
tecof doctor
tecof theme ls

@tecof/mcp

Tecof MCP (stdio)

v0.2.7npm

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.

Yayın tarihi
28 Eyl 2026
Gereksinim
node >=20
Lisans · boyut
MIT · 1.5 MB
Terminal
npx -y @tecof/mcp@latest

Giriş noktaları

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

Sürüm geçmişi

  1. 0.2.7 · 28 Eyl 2026
  2. 0.2.6 · 21 Eyl 2026
  3. 0.2.5 · 19 Eyl 2026
  4. 0.2.4 · 18 Eyl 2026
  5. 0.2.3 · 14 Eyl 2026

Toplam 13 sürüm · tümü npm’de

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

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ükseltmek 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.
  • Projede kurulu sürümü npm ls @tecof/<paket> ile görün; bu sayfanın Markdown’ı (packages.md) AI araçları için de aynı veriyi verir.