@veribenim/core

@veribenim/core

Veribenim KVKK & GDPR çerez onayı SDK — Framework-agnostic çekirdek

Kurulum

npm install @veribenim/core

İki Kullanım Yolu

Sadece banner göstermek istiyorsanız — SDK'ya gerek yok. Panelden bundle URL'nizi kopyalayın ve HTML'e ekleyin:

<script src="https://bundles.veribenim.com/siteadiniz.js" async></script>

Form rızası, DSAR veya diğer API işlemleri için SDK'yı kullanın. Token'ı Veribenim Paneli'nden alın.

Kullanım

import { init } from '@veribenim/core';

const veribenim = init({
  token: 'BURAYA_TOKEN_YAPISTIRIN',
  lang: 'tr', // 'tr' | 'en' — varsayılan: 'tr'
});

// Onay kararlarını dinle
veribenim
  .onAccept((prefs) => {
    if (prefs.analytics) initGoogleAnalytics();
    if (prefs.marketing) initFBPixel();
  })
  .onDecline(() => {
    // Yalnızca zorunlu çerezler aktif
  });

Form Rızası Takibi

İletişim formu, üyelik, bülten gibi formlardaki KVKK onayını kaydedin:

await veribenim.logFormConsent({
  formName: 'contact',
  consented: true,
  consentText: 'KVKK kapsamında verilerimin işlenmesini onaylıyorum.',
  metadata: { email: 'kullanici@example.com' },
});

DSAR (Veri Sahibi Başvurusu)

await veribenim.submitDsar({
  requestType: 'erasure', // access | rectification | erasure | restriction | portability | objection | automated
  fullName: 'Ad Soyad',
  email: 'kullanici@example.com',
  description: 'Tüm verilerimin silinmesini talep ediyorum.',
});

Tercih Yönetimi

// Mevcut tercihleri oku
const result = await veribenim.getPreferences();
console.log(result?.preferences); // { necessary, analytics, marketing, preferences }

// Tercihleri kaydet
await veribenim.savePreferences({
  necessary: true,
  analytics: true,
  marketing: false,
  preferences: true,
});

Framework Paketleri

Paket	Açıklama
@veribenim/react	React için Provider ve hook'lar
@veribenim/nextjs	Next.js App Router + Pages Router
@veribenim/vue	Vue 3 plugin ve composable
@veribenim/nuxt	Nuxt 3 modülü

Veribenim Platform Özellikleri

SDK, Veribenim'in uçtan uca KVKK/GDPR yönetim platformuyla entegre çalışır:

• Veri Envanteri: Departman/süreç bazlı veri haritalama, 20 KVKK veri kategorisi, VERBİS uyumlu export
• Saklama-İmha Otomasyonu: Saklama politikaları, otomatik imha, imha tutanakları, 5 imha yöntemi
• Risk Yönetimi: 5x5 risk matrisi, 7 risk kategorisi, aksiyon takibi, risk raporu export
• İç Denetim & Aksiyon Takibi: 6 denetim tipi, 0-100 puanlama, aksiyon atama ve gecikme takibi
• Doküman Şablonları: 10 hazır KVKK/GDPR şablonu, değişken sistemi, çoklu dil, versiyon takibi
• Rıza Versiyonlama: Onay metni versiyon takibi, yeniden onay mekanizması, versiyon karşılaştırma
• Veri Hakkı Talepleri (DSAR): 7 talep tipi, 30 gün deadline — submitDsar() ile SDK'dan gönderin
• Veri İhlali Yönetimi: 72 saat countdown, risk seviyeleri, otorite bildirim kaydı
• VERBİS / RoPA Export: KVKK VERBİS ve GDPR Md.30 formatında CSV/JSON rapor
• Politika Yönetimi: Gizlilik, çerez politikası, KVKK aydınlatma — çoklu dil, PDF/HTML export
• Uyumluluk Skoru: 17 kural, A-F notlandırma, kategori bazlı düzeltme önerileri
• Form Rızası Takibi: logFormConsent() ile tüm form onaylarını kaydedin
• Webhook Sistemi: consent, DSAR, breach olaylarını Slack/Teams/CRM'e iletin
• Çerez Tarayıcı: 50+ tracker otomatik tespiti
• Tercih Merkezi: Kalıcı URL ile ziyaretçi rıza yönetimi + DSAR entegrasyonu
• AI Asistan: RAG tabanlı KVKK/GDPR bilgi asistanı

Lisans

MIT Pariette