@kawanua/license-sdk

SDK resmi untuk klien yang menggunakan sistem lisensi Kawanua. SDK ini menyediakan metode verifikasi lisensi berbasis JWT (RS256) di sisi klien dengan fitur auto-branding dan kontrol akses fitur yang dinamis.

Fitur Utama

• Verifikasi Aman: Memverifikasi token JWT lisensi menggunakan RS256.
• Dukungan Multi-Environment: Mendukung browser (via <script>), CommonJS, dan ESM.
• Kontrol Fitur: Mendukung limitasi fitur berdasarkan plan (Starter, Professional, Enterprise).
• Auto-Branding: Secara otomatis menyuntikkan atau menyembunyikan elemen "Powered by Kawanua" sesuai ketentuan lisensi.
• Auto-Refresh: Mekanisme pembaruan token otomatis sebelum masa berlaku habis.

Instalasi

via CDN (Browser)

Tambahkan script berikut sebelum tag </body>:

<script src="https://cdn.kawanua.id/sdk/license.min.js"></script>

via NPM

npm install @kawanua/license-sdk

Penggunaan

Inisialisasi

import { KawanuaLicense } from '@kawanua/license-sdk';

KawanuaLicense.init({
  token: 'YOUR_JWT_TOKEN',
  onRefresh: async () => {
    // Implementasi untuk fetch token baru dari server kamu
    const res = await fetch('/api/license/refresh');
    const { token } = await res.json();
    return token;
  },
  onReady: (state) => {
    console.log('Lisensi aktif, plan:', state.plan);
  },
  onError: (err) => {
    console.error('Inisialisasi gagal:', err.message);
  }
});

React

import { useEffect, useState } from 'react';

function App() {
  const [license, setLicense] = useState(null);

  useEffect(() => {
    KawanuaLicense.init({
      token: window.__LICENSE_TOKEN__, // inject dari server-side rendering
      onReady: (state) => setLicense(state),
    });
    return () => KawanuaLicense.destroy();
  }, []);

  if (!license) return <p>Memverifikasi lisensi...</p>;

  return (
    <div>
      <h1>Dashboard</h1>
      {KawanuaLicense.can('api_access') && <ApiSection />}
      <p>Plan: {license.plan}</p>
    </div>
  );
}

Vue 3

import { onMounted, onUnmounted } from 'vue';

onMounted(() => {
  KawanuaLicense.init({
    token: import.meta.env.VITE_LICENSE_TOKEN,
    onReady: (state) => { license.value = state; },
  });
});
onUnmounted(() => KawanuaLicense.destroy());

Vanilla JS

<script src="https://cdn.kawanua.id/sdk/license.min.js"></script>
<script>
  KawanuaLicense.init({
    token: document.querySelector('meta[name="license-token"]').content,
    onReady: (state) => {
      if (!KawanuaLicense.can('white_label')) {
        document.getElementById('footer-branding').style.display = 'block';
      }
    },
  });
</script>

Mengecek Akses Fitur

Setelah inisialisasi berhasil, kamu bisa mengecek apakah sebuah fitur diperbolehkan:

// Mengecek boolean
if (KawanuaLicense.can('api_access')) {
  // Tampilkan fitur API
}

// Mendapatkan nilai (misal: limit jumlah user)
const maxUsers = KawanuaLicense.get('max_users');

Referensi Plan

SDK secara otomatis mengatur batasan fitur berdasarkan plan:

| Fitur | Starter | Professional | Enterprise | | :--- | :---: | :---: | :---: | | Remove Branding | ❌ | ✅ | ✅ | | Custom Domain | ❌ | ❌ | ✅ | | API Access | ❌ | ✅ | ✅ | | Max Users | 5 | 50 | ∞ |

Lisensi

ISC

Dibuat oleh Kawanua Indo Digital