@invezgo/sdk 1.3.1 → 2.0.1

package/README.md

@@ -1,313 +1,318 @@
-<div align="center">
-
-# 📈 Invezgo SDK - API Saham Indonesia Resmi untuk JavaScript & TypeScript
-
-![API Saham Indonesia](https://img.shields.io/badge/API%20Saham%20Indonesia-Lengkap-blue)
-![Official SDK](https://img.shields.io/badge/SDK-Resmi-green)
-![TypeScript](https://img.shields.io/badge/TypeScript-Ready-3178C6)
-![Node](https://img.shields.io/badge/Node-%3E%3D14-brightgreen)
-
-**SDK resmi untuk integrasi API Saham Indonesia yang lengkap, resmi, dan performance-oriented.**
-
-Dirancang untuk developer yang membangun aplikasi saham, dashboard analitik, screener, alert engine, watchlist, jurnal transaksi, dan backend service yang membutuhkan akses stabil ke **API Saham Indonesia** dari Invezgo.
-
-[🌐 Website Invezgo](https://invezgo.com) • [📚 Dokumentasi API](https://api.invezgo.com/documentation)
-
-</div>
-
----
-
-## 🚀 Mengapa Invezgo untuk API Saham Indonesia
-
-Jika Anda mencari **API Saham Indonesia** yang siap dipakai untuk production, `@invezgo/sdk` memberikan surface integrasi yang lebih rapi dibanding request manual. SDK ini dibuat untuk mempermudah integrasi **API Saham Indonesia resmi** ke aplikasi JavaScript dan TypeScript dengan kontrak yang konsisten, typing yang jelas, dan footprint runtime yang ringan.
-
-Keunggulan utamanya:
-
-- ✅ **Resmi**: mengikuti surface API resmi Invezgo
-- ✅ **Lengkap**: mencakup data saham, broker, index, screener, alert, watchlist, jurnal, portofolio, post, dan recommendation
-- ✅ **Cepat dan ringan**: memakai `fetch` native tanpa dependency runtime tambahan
-- ✅ **Developer-first**: mendukung TypeScript, DTO terstruktur, `CJS`, `ESM`, dan error handling yang jelas
-- ✅ **Production-ready**: cocok untuk backend service, internal tools, fintech product, dan dashboard monitoring
-
----
-
-## 🎯 Cocok untuk Use Case Berikut
-
-- 📊 Dashboard berbasis **API Saham Indonesia**
-- 🤖 Screener saham Indonesia dengan formula custom
-- 🔔 Alert saham dan monitoring market behavior
-- 🧾 Jurnal transaksi dan manajemen watchlist
-- 💼 Portofolio dan personal investment tools
-- 🏗️ Backend integration untuk aplikasi fintech dan wealth platform
-- 🧠 Research tooling untuk quant, trader, dan analis
-
----
-
-## 📦 Instalasi
-
-```bash
-npm install @invezgo/sdk
-```
-
----
-
-## 🛒 Cara Mulai dan Berlangganan
-
-Sebelum menggunakan SDK ini, Anda perlu memiliki akses aktif ke **API Saham Indonesia** dari Invezgo.
-
-### 1. Pilih paket langganan API
-
-Kunjungi halaman resmi API Saham Indonesia Invezgo untuk melihat paket yang tersedia dan memilih plan yang sesuai dengan kebutuhan aplikasi Anda:
-
-- Paket API Saham Indonesia: [https://invezgo.com/id/data-api-saham-indonesia](https://invezgo.com/id/data-api-saham-indonesia)
-
-### 2. Login ke akun Invezgo
-
-Setelah memilih paket, login ke akun Invezgo Anda melalui website utama:
-
-- Website Invezgo: [https://invezgo.com](https://invezgo.com)
-
-### 3. Generate API key
-
-Setelah langganan aktif, generate API key dari dashboard akun Invezgo Anda. API key inilah yang akan dipakai untuk autentikasi semua request ke **API Saham Indonesia**.
-
-### 4. Install SDK
-
-Install package JavaScript/TypeScript resmi:
-
-```bash
-npm install @invezgo/sdk
-```
-
-### 5. Simpan API key di environment variable
-
-Contoh yang direkomendasikan:
-
-```bash
-INVEZGO_API_KEY=your_api_key_here
-```
-
-### 6. Mulai integrasi
-
-Gunakan API key tersebut untuk mengakses endpoint Invezgo melalui SDK:
-
-```ts
-import Invezgo from '@invezgo/sdk';
-
-const client = new Invezgo({
-  apiKey: process.env.INVEZGO_API_KEY!,
-});
-```
-
----
-
-## ⚡ Quick Start
-
-```ts
-import Invezgo from '@invezgo/sdk';
-
-const client = new Invezgo({
-  apiKey: process.env.INVEZGO_API_KEY!,
-});
-
-const stocks = await client.analysis.getStockList();
-const indexes = await client.analysis.getIndexList();
-const intraday = await client.analysis.getIntradayData('BBCA', 'RG');
-
-console.log(stocks[0]);
-console.log(indexes[0]);
-console.log(intraday.close);
-```
-
----
-
-## 🧩 Fitur Utama API Saham Indonesia di SDK Ini
-
-### 📈 Data pasar dan analysis yang lengkap
-
-Modul `analysis` mencakup endpoint penting untuk **API Saham Indonesia**, termasuk:
-
-- daftar saham dan broker BEI
-- daftar index IDX
-- top gainer, top loser, top foreign, top accumulation, dan top retail flow
-- chart saham dan index
-- intraday chart, intraday summary, dan order book
-- broker summary, broker stalker, inventory chart, momentum chart
-- shareholder data, shareholder relation, insider activity, dan corporate action calendar
-- financial statement dan key statistics
-
-### 🛡️ SDK resmi yang lebih aman untuk production
-
-Menggunakan SDK resmi membantu mengurangi mismatch pada path, query params, payload, dan struktur response. Untuk tim yang membangun produk berbasis **API Saham Indonesia resmi**, pendekatan ini membuat proses development dan maintenance lebih efisien.
-
-### ⚙️ Ringan dan fokus pada performa
-
-`Invezgo SDK` tidak membawa dependency runtime tambahan. Ini relevan untuk aplikasi yang sensitif terhadap startup time, cold start, footprint container, atau deployment serverless.
-
-### 👨‍💻 Developer experience yang rapi
-
-- TypeScript-first
-- `InvezgoError` untuk error handling terstruktur
-- deklarasi tipe untuk DTO dan response utama
-- output build untuk `require` dan `import`
-
----
-
-## 🗂️ Modul yang Tersedia
-
-- `alerts`
-- `analysis`
-- `watchlists`
-- `journals`
-- `portfolios`
-- `search`
-- `profile`
-- `membership`
-- `posts`
-- `recommendation`
-- `trades`
-- `screener`
-- `usage`
-
----
-
-## 💡 Contoh Integrasi API Saham Indonesia
-
-### 🔔 Alert saham
-
-```ts
-await client.alerts.add({
-  name: 'Breakout volume',
-  formula: 'close > ema(20) and volume > sma(volume, 20)',
-  category: ['COMPOSITE'],
-  every: 'END_OF_DAY',
-  send: 'IN_OUT',
-});
-```
-
-### 📊 Analysis dan data intraday
-
-```ts
-const topRetail = await client.analysis.getTopRitel('2026-03-10');
-
-const intraday = await client.analysis.getIntradayData('BBCA', 'RG');
-
-const calendar = await client.analysis.getCalendar({
-  code: 'BBCA',
-  page: 1,
-  limit: 10,
-});
-```
-
-### 👀 Watchlist
-
-```ts
-await client.watchlists.add({
-  group: 'banking',
-  code: 'BBCA',
-  price: 9000,
-  scope: ['private'],
-  note: 'Area pantau',
-});
-
-await client.watchlists.updateGroup('group-id', {
-  name: 'Big Caps',
-});
-```
-
-### 🧾 Jurnal transaksi
-
-```ts
-await client.journals.add({
-  code: 'BBCA',
-  broker: 'AK',
-  date: '2026-03-10',
-  lot: 10,
-  fee: 15000,
-  price: 9050,
-  status: 'BUY',
-  scope: ['private'],
-  note: 'Entry bertahap',
-});
-```
-
-### 🔎 Screener saham Indonesia
-
-```ts
-const results = await client.screener.screen({
-  formula: 'close > ema(20)',
-  category: ['COMPOSITE', 'IDXFINANCE'],
-});
-```
-
-### 🤝 Recommendation
-
-```ts
-const recommendations = await client.recommendation.getUserRecommendations();
-```
-
-### 📊 API Usage Statistics
-
-```ts
-const usage = await client.usage.getApiUsage();
-console.log(`Remaining API calls: ${usage.remaining}/${usage.limit}`);
-```
-
----
-
-## 🏗️ Keunggulan untuk Tim Developer
-
-Saat membangun aplikasi di atas **API Saham Indonesia**, tim engineering biasanya membutuhkan kontrak yang jelas, integrasi yang ringan, dan surface yang mudah dipelihara. `Invezgo SDK` membantu menyederhanakan proses tersebut sehingga tim dapat fokus pada logic produk, bukan pada detail HTTP request yang berulang.
-
-Secara praktis, manfaatnya:
-
-- mengurangi boilerplate request manual
-- mengurangi risiko typo pada endpoint dan payload
-- mempercepat onboarding engineer baru
-- mempermudah review, testing, dan maintenance
-
----
-
-## 🔄 Catatan Migrasi Versi 1.2.0
-
-- ditambahkan `client.usage` untuk memantau limit dan kuota penggunaan API key
-- ditambahkan endpoint analysis baru: `getMultiTimeChart`, `getShareholderHigh`, `getShareholderClassification`, dan `getShareholderClassifyTable`
-- tipe data fully typed untuk seluruh endpoint yang baru ditambahkan
-
-## 🔄 Catatan Migrasi Versi 1.1.0
-
-- ditambahkan `client.alerts`
-- ditambahkan `client.recommendation`
-- ditambahkan endpoint analysis baru seperti index list, top retail flow, intraday summary, sector stalker, shareholder 1%, dan corporate action calendar
-- DTO `watchlists`, `journals`, `membership`, dan `screener` sudah mengikuti skema request terbaru
-- `client.ai` dan `client.health` dihapus karena tidak lagi tersedia pada kontrak API terbaru
-
----
-
-## 🛠️ Build
-
-```bash
-npm run build
-```
-
----
-
-## 🧠 Tipe yang Diekspor
-
-SDK ini mengekspor tipe inti seperti:
-
-- `InvezgoConfig`
-- `Stock`, `Broker`, `StockIndex`
-- `TopChangeResponse`, `TopRetailResponse`
-- `IntradayStockData`, `IntradayIndexData`
-- `ShareholderRelationResponse`
-- `FinancialStatementResponse`, `KeyStatResponse`
-- DTO endpoint seperti `AlertDto`, `CreateWatchlistDto`, `AddJournalTransactionDto`, `ScreenDto`
-
----
-
-## 🔗 Referensi
-
-- 🌐 Website utama: [https://invezgo.com](https://invezgo.com)
-- 📚 Dokumentasi API: [https://api.invezgo.com/documentation](https://api.invezgo.com/documentation)
-- 🧪 Contoh tambahan: [`docs/EXAMPLES.md`](./docs/EXAMPLES.md)
+# Invezgo JavaScript & TypeScript SDK
+
+[![npm](https://img.shields.io/npm/v/@invezgo/sdk.svg)](https://www.npmjs.com/package/@invezgo/sdk)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg)](https://nodejs.org)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+SDK resmi untuk [Invezgo API](https://invezgo.com), penyedia data pasar modal Indonesia (BEI/IDX). SDK ini menyediakan akses bertipe ke seluruh endpoint Invezgo API, dilengkapi cache in-memory dan rotasi API key otomatis.
+
+[Dokumentasi API](https://api.invezgo.com/documentation) · [Referensi SDK](docs/API.md) · [Changelog](CHANGELOG.md)
+
+## Daftar Isi
+
+- [Persyaratan](#persyaratan)
+- [Instalasi](#instalasi)
+- [Penggunaan](#penggunaan)
+- [Konfigurasi](#konfigurasi)
+- [Memanggil Endpoint](#memanggil-endpoint)
+- [Tipe Data](#tipe-data)
+- [Caching](#caching)
+- [Rotasi API Key](#rotasi-api-key)
+- [Penanganan Error](#penanganan-error)
+- [Pagination](#pagination)
+- [Praktik yang Disarankan](#praktik-yang-disarankan)
+- [Pengembangan](#pengembangan)
+- [Dukungan](#dukungan)
+- [Lisensi](#lisensi)
+
+## Persyaratan
+
+- Node.js 18 atau lebih baru (menggunakan `fetch` bawaan)
+- API key Invezgo, dapat dibuat di [halaman pengaturan API](https://invezgo.com/id/setting/api)
+
+SDK ini tidak memiliki dependency runtime dan mendukung ESM maupun CommonJS.
+
+## Instalasi
+
+```bash
+npm install @invezgo/sdk
+```
+
+## Penggunaan
+
+```ts
+import { Invezgo } from '@invezgo/sdk';
+
+const client = new Invezgo({ apiKey: process.env.INVEZGO_API_KEY! });
+
+const stocks = await client.analysis.getStockList();
+const info = await client.analysis.getInformation('BBCA');
+const top = await client.analysis.getTopChange({ date: '2024-12-30' });
+
+console.log(top.gain[0].code, top.gain[0].change);
+```
+
+CommonJS:
+
+```js
+const { Invezgo } = require('@invezgo/sdk');
+
+const client = new Invezgo({ apiKey: process.env.INVEZGO_API_KEY });
+```
+
+> **Penting:** gunakan SDK ini dari sisi server. Jangan menyertakan API key pada aplikasi browser atau mobile.
+
+## Konfigurasi
+
+```ts
+const client = new Invezgo({
+  apiKey: process.env.INVEZGO_API_KEY!,
+  additionalApiKeys: [process.env.INVEZGO_API_KEY_2!],
+  timeout: 30_000,
+  cache: { ttl: 60, realtimeTtl: 5 },
+});
+```
+
+| Opsi | Tipe | Default | Keterangan |
+|---|---|---|---|
+| `apiKey` | `string` | wajib | API key utama. |
+| `additionalApiKeys` | `string[]` | `[]` | API key cadangan, digunakan saat terjadi `429`. Lihat [Rotasi API Key](#rotasi-api-key). |
+| `baseUrl` | `string` | `https://api.invezgo.com` | Base URL API. |
+| `timeout` | `number` | `30000` | Timeout per request, dalam milidetik. |
+| `cache` | `boolean \| CacheOptions` | `true` | Konfigurasi cache. `false` untuk menonaktifkan. |
+| `cache.ttl` | `number` | `60` | TTL endpoint reguler, dalam detik. |
+| `cache.realtimeTtl` | `number` | `5` | TTL endpoint realtime, dalam detik. |
+| `cache.maxEntries` | `number` | `1000` | Jumlah maksimum entri cache. |
+| `cache.maxBytes` | `number` | `33554432` | Ukuran maksimum cache (32 MiB). |
+| `fetch` | `typeof fetch` | `globalThis.fetch` | Implementasi `fetch` alternatif, misalnya untuk proxy. |
+
+Buat satu instance client dan gunakan kembali di seluruh aplikasi. Cache dan status rotasi API key disimpan per instance.
+
+## Memanggil Endpoint
+
+Endpoint dikelompokkan berdasarkan resource:
+
+| Resource | Cakupan |
+|---|---|
+| `analysis` | Daftar saham, broker, dan indeks; harga, chart, intraday, order book, running trade; broker summary; pemegang saham; laporan keuangan; kalender aksi korporasi; berita dan keterbukaan informasi |
+| `batch` | Order book dan data intraday untuk beberapa saham dalam satu request |
+| `search` | Pencarian saham dan pengguna |
+| `screener` | Eksekusi screener dan pengelolaan preset |
+| `usage` | Pemakaian dan sisa kuota API |
+| `watchlists` | Watchlist dan grup watchlist |
+| `journals` | Jurnal transaksi |
+| `portfolios` | Portofolio |
+| `alerts` | Alert berbasis formula |
+| `posts` | Post, komentar, like, dan vote komunitas |
+| `trades` | Realized trade |
+
+Setiap method mengikuti pola berikut:
+
+```
+client.<resource>.<method>(...pathParams, body?, params?, options?)
+```
+
+| Argumen | Keterangan |
+|---|---|
+| `pathParams` | Parameter path sebagai argumen posisional, sesuai urutan di URL. |
+| `body` | Request body untuk `POST`, `PUT`, `PATCH`, dan `DELETE`, bertipe `*Request`. |
+| `params` | Query parameter dalam satu objek bertipe `<Nama>Params`. Nama field sama dengan nama di API. Wajib diisi jika endpoint memiliki query parameter wajib. |
+| `options` | `{ signal?: AbortSignal }` untuk membatalkan request. |
+
+```ts
+// Path parameter
+await client.analysis.getBrokerStalker('YP', 'BBCA', {
+  from: '2024-12-01',
+  to: '2024-12-31',
+  investor: 'all',
+  market: 'RG',
+});
+
+// Request body
+await client.screener.screen({ formula: 'close > prev AND volume > 1000000', category: ['SYARIAH'] });
+
+// Beberapa saham sekaligus, dihitung sebagai satu request
+await client.batch.getOrderBook('BBCA|BBRI|BMRI');
+
+// Membatalkan request
+const controller = new AbortController();
+setTimeout(() => controller.abort(), 2_000);
+await client.analysis.getOrderBook('BBCA', { market: 'RG' }, { signal: controller.signal });
+```
+
+Daftar lengkap method, parameter, nilai default, dan tipe kembalian tersedia di [docs/API.md](docs/API.md).
+
+## Tipe Data
+
+Seluruh model request, query parameter, dan response diekspor dari paket:
+
+```ts
+import type { TopChangeParams, TopChangeResponse } from '@invezgo/sdk';
+
+const params: TopChangeParams = {
+  date: '2024-12-30',
+  filter_column: 'change', // 'change' | 'value' | 'volume' | 'ratio'
+  filter_operator: '>',
+  filter_value: 5,
+};
+
+const top: TopChangeResponse = await client.analysis.getTopChange(params);
+```
+
+Ketentuan tipe:
+
+| Kasus | Representasi |
+|---|---|
+| Parameter enum | Literal union, misalnya `'BUY' \| 'SELL' \| 'ALL'` |
+| Field nullable | `T \| null` |
+| Field opsional | `field?: T` |
+| Response array | Alias `XResponse = XItem[]` |
+| Response yang dapat bernilai `null` | `Promise<X \| null>`, misalnya `getShareholderClassifyTable` |
+| Angka yang dapat dikirim sebagai string | `number \| string` |
+
+Response berbentuk union dapat dipersempit melalui field `type`:
+
+```ts
+const graph = await client.analysis.getShareholderRelation({ code: 'BBCA' });
+
+for (const node of graph.nodes) {
+  if (node.type === 'stock') {
+    console.log(node.code, node.company_name);
+  } else {
+    console.log(node.label);
+  }
+}
+```
+
+## Caching
+
+Cache in-memory aktif secara default untuk mengurangi pemakaian kuota dan latensi.
+
+- Hanya request `GET` yang disimpan. Cache key terdiri dari path dan query string yang telah dinormalisasi.
+- Cache menggunakan algoritma LRU dengan batas jumlah entri (`maxEntries`) dan total ukuran (`maxBytes`). Entri yang paling lama tidak digunakan akan dihapus saat salah satu batas terlampaui.
+- Endpoint realtime (order book, running trade, intraday, chart, batch, dan sejenisnya) menggunakan `realtimeTtl`. Endpoint lainnya menggunakan `ttl`.
+- Endpoint `usage` dan request selain `GET` tidak disimpan di cache.
+- Setiap request `POST`, `PUT`, `PATCH`, atau `DELETE` yang berhasil akan menghapus cache data personal (`watchlists`, `journals`, `portfolios`, `trades`, `alerts`, `screener`).
+
+```ts
+new Invezgo({ apiKey, cache: false });                // nonaktifkan cache
+new Invezgo({ apiKey, cache: { realtimeTtl: 0 } });   // nonaktifkan cache untuk endpoint realtime
+new Invezgo({ apiKey, cache: { ttl: 300 } });         // TTL endpoint reguler 5 menit
+
+client.clearCache();                                  // hapus seluruh cache
+```
+
+## Rotasi API Key
+
+Setiap API key memiliki batas request per menit untuk setiap endpoint dan kuota bulanan. Jika Anda memiliki lebih dari satu API key, tambahkan sebagai cadangan:
+
+```ts
+const client = new Invezgo({
+  apiKey: process.env.INVEZGO_API_KEY!,
+  additionalApiKeys: [process.env.INVEZGO_API_KEY_2!, process.env.INVEZGO_API_KEY_3!],
+});
+```
+
+Ketika API mengembalikan `429 Too Many Requests`:
+
+1. Lama penundaan diambil dari header `Retry-After`. Jika tidak tersedia, digunakan `X-RateLimit-Reset`, kemudian 60 detik.
+2. Untuk batas per menit, API key ditangguhkan hanya pada endpoint tersebut. Untuk kuota bulanan, API key ditangguhkan pada seluruh endpoint.
+3. Request dikirim ulang menggunakan API key berikutnya yang tersedia.
+4. API key utama digunakan kembali setelah masa penangguhan berakhir.
+5. Jika seluruh API key sedang ditangguhkan, SDK melempar `RateLimitError` tanpa mengirim request.
+
+Rotasi hanya dilakukan untuk status `429`. Untuk endpoint data personal seperti watchlist dan portofolio, gunakan API key dari akun yang sama.
+
+Sisa kuota dapat diperiksa tanpa mengurangi kuota:
+
+```ts
+const usage = await client.usage.getApiUsage();
+console.log(usage.usage, usage.limit, usage.remaining, usage.expire);
+```
+
+## Penanganan Error
+
+Seluruh error merupakan turunan `InvezgoError`.
+
+| Class | Status HTTP | Penyebab |
+|---|---|---|
+| `ValidationError` | 400, 422 | Parameter atau body tidak valid |
+| `AuthenticationError` | 401 | API key tidak valid atau kedaluwarsa |
+| `PaymentRequiredError` | 402 | Endpoint tidak termasuk dalam paket langganan |
+| `NotFoundError` | 404 | Data tidak ditemukan |
+| `RateLimitError` | 429 | Batas request atau kuota tercapai pada seluruh API key |
+| `ServerError` | 5xx | Kesalahan pada server |
+| `TimeoutError` | — | Request melebihi `timeout` |
+| `ConnectionError` | — | Kegagalan jaringan |
+
+Properti yang tersedia: `status`, `message`, `error`, `requestId`, `path`, dan `body`. `RateLimitError` juga menyediakan `retryAfter` (detik), `limit`, `remaining`, `reset`, dan `quotaExceeded`.
+
+```ts
+import { InvezgoError, RateLimitError, ValidationError } from '@invezgo/sdk';
+
+try {
+  await client.analysis.getSummaryStock('BBCA', {
+    from: '2024-12-01',
+    to: '2024-12-31',
+    investor: 'all',
+    market: 'RG',
+  });
+} catch (err) {
+  if (err instanceof RateLimitError) {
+    console.error(`Rate limit tercapai, coba lagi dalam ${err.retryAfter} detik`);
+  } else if (err instanceof ValidationError) {
+    console.error(`Parameter tidak valid: ${err.message}`);
+  } else if (err instanceof InvezgoError) {
+    console.error(err.status, err.message, err.requestId);
+  } else {
+    throw err;
+  }
+}
+```
+
+## Pagination
+
+Endpoint dengan pagination mengembalikan `page`, `totalPage`, dan `nextPage`. Nilai `nextPage` adalah `null` pada halaman terakhir.
+
+```ts
+let page: number | null = 1;
+
+while (page !== null) {
+  const res = await client.analysis.getNews({ page, limit: 50 });
+  for (const item of res.data) console.log(item.title);
+  page = res.nextPage;
+}
+```
+
+## Praktik yang Disarankan
+
+- Gunakan satu instance client untuk seluruh aplikasi.
+- Simpan API key di environment variable atau secret manager.
+- Gunakan format tanggal `YYYY-MM-DD`. Data end-of-day tersedia setelah pukul 18.00 WIB.
+- Field waktu bersufiks `Z` menggunakan waktu WIB (UTC+7); jangan dikonversi ke zona waktu lain.
+- Gunakan resource `batch` untuk mengambil data beberapa saham sekaligus.
+- Saat menerima `RateLimitError`, tunggu sesuai `retryAfter` sebelum mencoba kembali.
+- Untuk polling data realtime, sesuaikan `realtimeTtl` dengan interval polling.
+
+Contoh lengkap tersedia di direktori [examples](examples/).
+
+## Pengembangan
+
+File di `src/generated/` dan `docs/API.md` dihasilkan dari spesifikasi OpenAPI dan tidak boleh diubah secara manual.
+
+```bash
+npm run generate    # generate ulang kode dari OpenAPI
+npm run typecheck   # pemeriksaan tipe
+npm test            # build dan unit test
+```
+
+## Dukungan
+
+Sertakan nilai `requestId` dari error saat menghubungi tim dukungan Invezgo.
+
+- Website: [invezgo.com](https://invezgo.com)
+- Dokumentasi API: [api.invezgo.com/documentation](https://api.invezgo.com/documentation)
+
+## Lisensi
+
+Dirilis di bawah [MIT License](LICENSE).