TypeScript SDKv0.4.2

Instalasi & Pengaturan

Cara memasang dan menginisialisasi `@cloudizero/sdk` di Node.js, framework web modern, dan browser.

Instalasi Package

Pasang package melalui package manager pilihan Anda. SDK ini sudah dilengkapi definisi TypeScript bawaan tanpa dependensi eksternal yang berat:

pnpm add @cloudizero/sdk

Inisialisasi Klien

Impor Cloudizero dan buat instansiasi klien dengan opsi konfigurasi Anda:

lib/cloudizero.ts

import { Cloudizero } from "@cloudizero/sdk";

// 1. Zero-config: membaca process.env.CLOUDIZERO_API_KEY secara otomatis
export const cz = new Cloudizero();

// 2. Atau konfigurasi eksplisit / custom overrides:
export const czCustom = new Cloudizero({
  apiKey: process.env.CLOUDIZERO_API_KEY!,
  baseUrl: process.env.CLOUDIZERO_BASE_URL || "https://api.cloudizero.com",
  cdnUrl: "https://cdn.cloudizero.com",
});

Opsi Konfigurasi (`CloudizeroConfig`)

Parameter konstruktor yang diterima saat menjalankan new Cloudizero(config):

Property	Type	Default	Description
apiKey	string	process.env.CLOUDIZERO_API_KEY	Kunci API rahasia berawalan cz_live_ yang dibuat dari konsol Cloudizero.
baseUrl	string	https://api.cloudizero.com	URL dasar API deployment Cloudizero atau server development lokal Anda.
cdnUrl	string	https://cdn.cloudizero.com	Domain CDN publik kustom untuk pengiriman media. Jika diatur, hasil aset mengembalikan cdnUrl absolut.

Kompatibilitas Runtime

@cloudizero/sdk memanfaatkan Web API standar (fetch, FormData, XMLHttpRequest / Uint8Array), sehingga kompatibel penuh dengan:

Node.js 18+ (Dukungan fetch bawaan)
Next.js 14, 15 & 16 (Baik Server Components maupun Client Components)
Edge & Serverless Runtimes (Deno, Bun, Edge Functions)
Browser Modern (Chrome, Safari, Firefox, Edge)