@xstbot/cloudku 1.0.1 → 1.0.2

package/README.md

@@ -1,185 +1,184 @@
 # @xstbot/cloudku
 
-> **CloudKu Official SDK** — Solusi integrasi CDN yang cepat, aman, dan dirancang khusus untuk pengembang modern.
+> **CloudKu Official SDK** — Solusi integrasi CDN yang cepat, aman, dan dirancang khusus untuk pengembang modern.
 
 [![NPM Version](https://img.shields.io/npm/v/@xstbot/cloudku)](https://www.npmjs.com/package/@xstbot/cloudku)
 [![License](https://img.shields.io/npm/l/@xstbot/cloudku)](https://www.npmjs.com/package/@xstbot/cloudku)
+[![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue?logo=typescript)](https://www.typescriptlang.org/)
 [![Status](https://img.shields.io/badge/status-stable-brightgreen)]()
 
-📦 NPM Package : https://www.npmjs.com/package/@xstbot/cloudku  
-📖 Dokumentasi : https://cloudku.sbs/npm
+📦 NPM Package : https://www.npmjs.com/package/@xstbot/cloudku
+📖 Dokumentasi : https://cloudku.sbs/docs
 
 ---
 
-## 📋 Daftar Isi
+## 📋 Daftar Isi
 
 - [Tentang](#tentang)
 - [Instalasi](#instalasi)
 - [Penggunaan](#penggunaan)
   - [JavaScript (CommonJS)](#javascript-commonjs)
-  - [TypeScript](#typescript)
+  - [TypeScript / ESM](#typescript--esm)
+- [API Reference](#api-reference)
 - [Response Schema](#response-schema)
-- [Contoh Lengkap](#contoh-lengkap)
 - [Error Handling](#error-handling)
 - [Lisensi](#lisensi)
 
 ---
 
-## 📌 Tentang
+## 📌 Tentang
 
-`@xstbot/cloudku` adalah SDK resmi dari **CloudKu CDN** yang memungkinkan pengembang mengunggah file ke jaringan CDN secara mudah dan cepat. Library ini mendukung JavaScript (CommonJS) dan TypeScript, sehingga cocok digunakan di berbagai lingkungan pengembangan modern.
+`@xstbot/cloudku` adalah SDK resmi dari **CloudKu CDN** yang memungkinkan pengembang mengunggah file ke jaringan CDN secara mudah dan cepat. Library ini mendukung **JavaScript** (CJS & ESM) dan **TypeScript** dengan type definitions bawaan.
 
 ---
 
-## 🚀 Instalasi
+## 🚀 Instalasi
 
-Pasang library melalui NPM dengan perintah berikut:
-
-```bash
 npm install @xstbot/cloudku
-```
-
-Atau menggunakan Yarn:
-
-```bash
+# atau
 yarn add @xstbot/cloudku
-```
 
 ---
 
-## 📖 Penggunaan
+## 📖 Penggunaan
 
 ### JavaScript (CommonJS)
 
-Gunakan `require` untuk integrasi cepat pada proyek Node.js atau Express.
+const { CloudKu, uploadFile } = require('@xstbot/cloudku');
+const fs = require('fs');
 
-```js
-const { CloudKu } = require('@xstbot/cloudku');
+const buffer = fs.readFileSync('./photo.jpg');
 
-/**
- * Fungsi untuk menangani upload file
- * @param {Buffer} fileBuffer - Data buffer dari file
- * @param {String} fileName - Nama file yang diinginkan
- */
-async function handleFileUpload(fileBuffer, fileName) {
-  try {
-    const result = await CloudKu(fileBuffer, fileName);
+// Menggunakan Class (dengan konfigurasi)
+const client = new CloudKu({ timeout: 60_000 });
 
+async function handleUpload() {
+  try {
+    const result = await client.upload(buffer, 'photo.jpg');
     if (result.status === 'success') {
-      console.log('✅ File Berhasil Diunggah:', result.url);
+      console.log('✅ File berhasil diunggah:', result.url);
     } else {
-      console.error('❌ API Error:', result.message);
+      console.error('❌ API Error:', result.message);
     }
   } catch (err) {
-    console.error('🔥 System Error:', err.message);
+    console.error('🔥 System Error:', err.message);
   }
 }
-```
+
+// Menggunakan Fungsi Langsung (tanpa konfigurasi)
+async function quickUpload() {
+  const result = await uploadFile(buffer, 'photo.jpg');
+  console.log(result);
+}
 
 ---
 
-### TypeScript
+### TypeScript / ESM
 
-Dukungan penuh tipe data untuk pengalaman pengembangan yang lebih aman dan terstruktur.
+import { CloudKu, uploadFile } from '@xstbot/cloudku';
+import type { CloudKuResponse, CloudKuOptions } from '@xstbot/cloudku';
+import fs from 'fs';
 
-```ts
-import { CloudKu, CloudKuResponse } from '@xstbot/cloudku';
+const buffer = fs.readFileSync('./photo.jpg');
 
-const uploadToCDN = async (buffer: Buffer, name: string): Promise<void> => {
-  const response: CloudKuResponse = await CloudKu(buffer, name);
+// Menggunakan Class
+const options: CloudKuOptions = { timeout: 60_000 };
+const client = new CloudKu(options);
 
+const uploadWithClass = async (): Promise<void> => {
+  const response: CloudKuResponse = await client.upload(buffer, 'photo.jpg');
   if (response.status === 'success') {
-    // Properti 'url' sudah terdefinisi secara otomatis
-    process.stdout.write(`✅ File live at: ${response.url}`);
+    console.log(`✅ File live at: ${response.url}`);
   }
 };
-```
+
+// Menggunakan Fungsi Langsung
+const quickUpload = async (): Promise<void> => {
+  const response = await uploadFile(buffer, 'photo.jpg');
+  console.log(response);
+};
 
 ---
 
-## 📊 Response Schema
+## 📚 API Reference
+
+### uploadFile(fileBuffer, fileName, options?)
 
-Struktur data yang dikembalikan oleh setiap permintaan API:
+Fungsi langsung untuk upload file tanpa perlu membuat instance.
 
-| Property  | Type                  | Description                                         |
-|-----------|-----------------------|-----------------------------------------------------|
-| `status`  | `string`              | Mengembalikan `"success"` atau `"error"`            |
-| `message` | `string`              | Detail pesan respons atau informasi error           |
-| `url`     | `string \| undefined` | URL publik permanen file (hanya jika status sukses) |
+| Parameter         | Type     | Required | Description                         |
+|-------------------|----------|----------|-------------------------------------|
+| fileBuffer        | Buffer   | YES      | Isi file sebagai Node.js Buffer     |
+| fileName          | string   | YES      | Nama file beserta ekstensi          |
+| options.apiUrl    | string   | NO       | Custom API URL                      |
+| options.timeout   | number   | NO       | Timeout dalam ms (default: 30000)   |
 
 ---
 
-## 💡 Contoh Lengkap
+### new CloudKu(options?)
 
-Berikut contoh penggunaan lengkap untuk upload file dari sistem lokal:
+Instance-based client dengan konfigurasi persisten.
 
-```js
-const { CloudKu } = require('@xstbot/cloudku');
-const fs = require('fs');
-const path = require('path');
+| Option    | Type     | Default                           | Description         |
+|-----------|----------|-----------------------------------|---------------------|
+| apiUrl    | string   | https://cloudku.sbs/cdn/api.php   | Custom API endpoint |
+| timeout   | number   | 30000                             | Timeout dalam ms    |
 
-async function uploadLocalFile(filePath) {
-  const fileBuffer = fs.readFileSync(filePath);
-  const fileName = path.basename(filePath);
+Methods:
 
-  console.log(`📤 Mengupload: ${fileName}`);
+| Method                         | Return                     | Description                        |
+|--------------------------------|----------------------------|------------------------------------|
+| upload(fileBuffer, fileName)   | Promise<CloudKuResponse>   | Upload file ke CDN                 |
+| getOptions()                   | CloudKuOptions             | Melihat konfigurasi aktif instance |
 
-  const result = await CloudKu(fileBuffer, fileName);
+---
 
-  if (result.status === 'success') {
-    console.log('✅ Upload berhasil!');
-    console.log('🔗 URL File:', result.url);
-  } else {
-    console.error('❌ Upload gagal:', result.message);
-  }
-}
+## 📊 Response Schema
 
-// Contoh pemanggilan
-uploadLocalFile('./foto.jpg');
-```
+| Property   | Type                   | Description                                     |
+|------------|------------------------|-------------------------------------------------|
+| status     | "success" or "error"   | Status hasil operasi                            |
+| message    | string                 | Detail pesan atau informasi error               |
+| url        | string or undefined    | URL publik file (hanya tersedia jika success)   |
+| fileName   | string or undefined    | Nama file yang tersimpan di CDN                 |
 
 ---
 
-## ⚠️ Error Handling
+## ⚠️ Error Handling
 
-Selalu gunakan `try/catch` untuk menangani error yang mungkin terjadi:
+import { uploadFile } from '@xstbot/cloudku';
 
-```js
-const { CloudKu } = require('@xstbot/cloudku');
-
-async function safeUpload(buffer, filename) {
+async function safeUpload(buffer: Buffer, filename: string) {
   try {
-    const result = await CloudKu(buffer, filename);
-
+    const result = await uploadFile(buffer, filename);
     if (result.status === 'success') {
       return result.url;
     } else {
       throw new Error(result.message);
     }
   } catch (error) {
-    console.error('Upload gagal:', error.message);
+    console.error('Upload gagal:', (error as Error).message);
     return null;
   }
 }
-```
 
 ---
 
-## 🔗 Tautan Penting
+## 🔗 Tautan Penting
 
-| Sumber         | URL                                               |
-|----------------|---------------------------------------------------|
-| NPM Package    | https://www.npmjs.com/package/@xstbot/cloudku     |
-| Dokumentasi    | https://cloudku.sbs/npm                           |
-| CloudKu Utama  | https://cloudku.sbs                               |
+| Sumber        | URL                                           |
+|---------------|-----------------------------------------------|
+| NPM Package   | https://www.npmjs.com/package/@xstbot/cloudku |
+| Dokumentasi   | https://cloudku.sbs/docs                       |
+| CloudKu Utama | https://cloudku.sbs                           |
 
 ---
 
-## 📄 Lisensi
+## 📄 Lisensi
 
-Proyek ini dilisensikan di bawah lisensi yang tercantum pada halaman NPM resmi.  
+Proyek ini dilisensikan di bawah lisensi yang tercantum pada halaman NPM resmi.
 Kunjungi: https://www.npmjs.com/package/@xstbot/cloudku
 
 ---
 
-> © 2026 CloudKu CDN API • Developed for Modern Apps
+> © 2026 CloudKu CDN API • Developed for Modern Apps

package/dist/esm/index.js

@@ -0,0 +1,78 @@
+import axios from 'axios';
+import FormData from 'form-data';
+export const CloudKu_URL = 'https://cloudku.sbs/cdn/api.php';
+// ─── Core Upload Function ─────────────────────────────────────────────────────
+/**
+ * Upload a file Buffer to CloudKu CDN.
+ *
+ * @param fileBuffer - File content as a Node.js Buffer
+ * @param fileName   - File name including extension (e.g. `photo.jpg`)
+ * @param options    - Optional configuration (apiUrl, timeout)
+ * @returns CDN response object
+ *
+ * @example
+ * ```ts
+ * import { uploadFile } from 'cloudku-uploader';
+ * import fs from 'fs';
+ *
+ * const buffer = fs.readFileSync('./photo.jpg');
+ * const result = await uploadFile(buffer, 'photo.jpg');
+ * console.log(result);
+ * ```
+ */
+export const uploadFile = async (fileBuffer, fileName, options = {}) => {
+    var _a, _b;
+    if (!fileBuffer || !Buffer.isBuffer(fileBuffer)) {
+        throw new TypeError('fileBuffer must be a valid Buffer');
+    }
+    if (!fileName || typeof fileName !== 'string' || fileName.trim() === '') {
+        throw new TypeError('fileName must be a non-empty string');
+    }
+    const apiUrl = (_a = options.apiUrl) !== null && _a !== void 0 ? _a : CloudKu_URL;
+    const timeout = (_b = options.timeout) !== null && _b !== void 0 ? _b : 30000;
+    const form = new FormData();
+    form.append('file', fileBuffer, { filename: fileName });
+    const response = await axios.post(apiUrl, form, {
+        headers: { ...form.getHeaders() },
+        timeout,
+        maxContentLength: Infinity,
+        maxBodyLength: Infinity,
+    });
+    return response.data;
+};
+// ─── Class API ────────────────────────────────────────────────────────────────
+/**
+ * CloudKu class — instance-based client with persistent configuration.
+ *
+ * @example
+ * ```ts
+ * import { CloudKu } from 'cloudku-uploader';
+ *
+ * const client = new CloudKu({ timeout: 60_000 });
+ * const result = await client.upload(buffer, 'video.mp4');
+ * ```
+ */
+export class CloudKu {
+    constructor(options = {}) {
+        var _a, _b;
+        this.options = {
+            apiUrl: (_a = options.apiUrl) !== null && _a !== void 0 ? _a : CloudKu_URL,
+            timeout: (_b = options.timeout) !== null && _b !== void 0 ? _b : 30000,
+        };
+    }
+    /**
+     * Upload a file to CloudKu CDN.
+     * @param fileBuffer - File content as a Buffer
+     * @param fileName   - File name with extension
+     */
+    async upload(fileBuffer, fileName) {
+        return uploadFile(fileBuffer, fileName, this.options);
+    }
+    /** Returns the active configuration of this client instance */
+    getOptions() {
+        return { ...this.options };
+    }
+}
+// ─── Default Export ───────────────────────────────────────────────────────────
+export default CloudKu;
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,QAAQ,MAAM,WAAW,CAAC;AAEjC,MAAM,CAAC,MAAM,WAAW,GAAG,iCAAiC,CAAC;AAyB7D,iFAAiF;AAEjF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,EAC3B,UAAkB,EAClB,QAAgB,EAChB,UAA0B,EAAE,EACJ,EAAE;;IAC1B,IAAI,CAAC,UAAU,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,SAAS,CAAC,mCAAmC,CAAC,CAAC;IAC7D,CAAC;IACD,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACtE,MAAM,IAAI,SAAS,CAAC,qCAAqC,CAAC,CAAC;IAC/D,CAAC;IAED,MAAM,MAAM,GAAG,MAAA,OAAO,CAAC,MAAM,mCAAI,WAAW,CAAC;IAC7C,MAAM,OAAO,GAAG,MAAA,OAAO,CAAC,OAAO,mCAAI,KAAM,CAAC;IAE1C,MAAM,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;IAC5B,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;IAExD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAkB,MAAM,EAAE,IAAI,EAAE;QAC7D,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,UAAU,EAAE,EAAE;QACjC,OAAO;QACP,gBAAgB,EAAE,QAAQ;QAC1B,aAAa,EAAE,QAAQ;KAC1B,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC,IAAI,CAAC;AACzB,CAAC,CAAC;AAEF,iFAAiF;AAEjF;;;;;;;;;;GAUG;AACH,MAAM,OAAO,OAAO;IAGhB,YAAY,UAA0B,EAAE;;QACpC,IAAI,CAAC,OAAO,GAAG;YACX,MAAM,EAAE,MAAA,OAAO,CAAC,MAAM,mCAAI,WAAW;YACrC,OAAO,EAAE,MAAA,OAAO,CAAC,OAAO,mCAAI,KAAM;SACrC,CAAC;IACN,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,UAAkB,EAAE,QAAgB;QAC7C,OAAO,UAAU,CAAC,UAAU,EAAE,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED,+DAA+D;IAC/D,UAAU;QACN,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IAC/B,CAAC;CACJ;AAED,iFAAiF;AAEjF,eAAe,OAAO,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,62 @@
+export declare const CloudKu_URL = "https://cloudku.sbs/cdn/api.php";
+export interface CloudKuOptions {
+    /** Custom API endpoint. Default: CloudKu CDN */
+    apiUrl?: string;
+    /** Request timeout in milliseconds. Default: 30000 */
+    timeout?: number;
+}
+export interface CloudKuSuccessResponse {
+    status: 'success' | string;
+    url?: string;
+    fileName?: string;
+    [key: string]: unknown;
+}
+export interface CloudKuErrorResponse {
+    status: 'error';
+    message: string;
+}
+export type CloudKuResponse = CloudKuSuccessResponse | CloudKuErrorResponse;
+/**
+ * Upload a file Buffer to CloudKu CDN.
+ *
+ * @param fileBuffer - File content as a Node.js Buffer
+ * @param fileName   - File name including extension (e.g. `photo.jpg`)
+ * @param options    - Optional configuration (apiUrl, timeout)
+ * @returns CDN response object
+ *
+ * @example
+ * ```ts
+ * import { uploadFile } from 'cloudku-uploader';
+ * import fs from 'fs';
+ *
+ * const buffer = fs.readFileSync('./photo.jpg');
+ * const result = await uploadFile(buffer, 'photo.jpg');
+ * console.log(result);
+ * ```
+ */
+export declare const uploadFile: (fileBuffer: Buffer, fileName: string, options?: CloudKuOptions) => Promise<CloudKuResponse>;
+/**
+ * CloudKu class — instance-based client with persistent configuration.
+ *
+ * @example
+ * ```ts
+ * import { CloudKu } from 'cloudku-uploader';
+ *
+ * const client = new CloudKu({ timeout: 60_000 });
+ * const result = await client.upload(buffer, 'video.mp4');
+ * ```
+ */
+export declare class CloudKu {
+    private readonly options;
+    constructor(options?: CloudKuOptions);
+    /**
+     * Upload a file to CloudKu CDN.
+     * @param fileBuffer - File content as a Buffer
+     * @param fileName   - File name with extension
+     */
+    upload(fileBuffer: Buffer, fileName: string): Promise<CloudKuResponse>;
+    /** Returns the active configuration of this client instance */
+    getOptions(): Readonly<Required<CloudKuOptions>>;
+}
+export default CloudKu;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,WAAW,oCAAoC,CAAC;AAI7D,MAAM,WAAW,cAAc;IAC3B,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACnC,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACjC,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,eAAe,GAAG,sBAAsB,GAAG,oBAAoB,CAAC;AAI5E;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,UAAU,GACnB,YAAY,MAAM,EAClB,UAAU,MAAM,EAChB,UAAS,cAAmB,KAC7B,OAAO,CAAC,eAAe,CAsBzB,CAAC;AAIF;;;;;;;;;;GAUG;AACH,qBAAa,OAAO;IAChB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2B;gBAEvC,OAAO,GAAE,cAAmB;IAOxC;;;;OAIG;IACG,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAI5E,+DAA+D;IAC/D,UAAU,IAAI,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;CAGnD;AAID,eAAe,OAAO,CAAC"}

package/dist/index.js

@@ -0,0 +1,86 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CloudKu = exports.uploadFile = exports.CloudKu_URL = void 0;
+const axios_1 = __importDefault(require("axios"));
+const form_data_1 = __importDefault(require("form-data"));
+exports.CloudKu_URL = 'https://cloudku.sbs/cdn/api.php';
+// ─── Core Upload Function ─────────────────────────────────────────────────────
+/**
+ * Upload a file Buffer to CloudKu CDN.
+ *
+ * @param fileBuffer - File content as a Node.js Buffer
+ * @param fileName   - File name including extension (e.g. `photo.jpg`)
+ * @param options    - Optional configuration (apiUrl, timeout)
+ * @returns CDN response object
+ *
+ * @example
+ * ```ts
+ * import { uploadFile } from 'cloudku-uploader';
+ * import fs from 'fs';
+ *
+ * const buffer = fs.readFileSync('./photo.jpg');
+ * const result = await uploadFile(buffer, 'photo.jpg');
+ * console.log(result);
+ * ```
+ */
+const uploadFile = async (fileBuffer, fileName, options = {}) => {
+    var _a, _b;
+    if (!fileBuffer || !Buffer.isBuffer(fileBuffer)) {
+        throw new TypeError('fileBuffer must be a valid Buffer');
+    }
+    if (!fileName || typeof fileName !== 'string' || fileName.trim() === '') {
+        throw new TypeError('fileName must be a non-empty string');
+    }
+    const apiUrl = (_a = options.apiUrl) !== null && _a !== void 0 ? _a : exports.CloudKu_URL;
+    const timeout = (_b = options.timeout) !== null && _b !== void 0 ? _b : 30000;
+    const form = new form_data_1.default();
+    form.append('file', fileBuffer, { filename: fileName });
+    const response = await axios_1.default.post(apiUrl, form, {
+        headers: { ...form.getHeaders() },
+        timeout,
+        maxContentLength: Infinity,
+        maxBodyLength: Infinity,
+    });
+    return response.data;
+};
+exports.uploadFile = uploadFile;
+// ─── Class API ────────────────────────────────────────────────────────────────
+/**
+ * CloudKu class — instance-based client with persistent configuration.
+ *
+ * @example
+ * ```ts
+ * import { CloudKu } from 'cloudku-uploader';
+ *
+ * const client = new CloudKu({ timeout: 60_000 });
+ * const result = await client.upload(buffer, 'video.mp4');
+ * ```
+ */
+class CloudKu {
+    constructor(options = {}) {
+        var _a, _b;
+        this.options = {
+            apiUrl: (_a = options.apiUrl) !== null && _a !== void 0 ? _a : exports.CloudKu_URL,
+            timeout: (_b = options.timeout) !== null && _b !== void 0 ? _b : 30000,
+        };
+    }
+    /**
+     * Upload a file to CloudKu CDN.
+     * @param fileBuffer - File content as a Buffer
+     * @param fileName   - File name with extension
+     */
+    async upload(fileBuffer, fileName) {
+        return (0, exports.uploadFile)(fileBuffer, fileName, this.options);
+    }
+    /** Returns the active configuration of this client instance */
+    getOptions() {
+        return { ...this.options };
+    }
+}
+exports.CloudKu = CloudKu;
+// ─── Default Export ───────────────────────────────────────────────────────────
+exports.default = CloudKu;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;AAAA,kDAA0B;AAC1B,0DAAiC;AAEpB,QAAA,WAAW,GAAG,iCAAiC,CAAC;AAyB7D,iFAAiF;AAEjF;;;;;;;;;;;;;;;;;GAiBG;AACI,MAAM,UAAU,GAAG,KAAK,EAC3B,UAAkB,EAClB,QAAgB,EAChB,UAA0B,EAAE,EACJ,EAAE;;IAC1B,IAAI,CAAC,UAAU,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,SAAS,CAAC,mCAAmC,CAAC,CAAC;IAC7D,CAAC;IACD,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACtE,MAAM,IAAI,SAAS,CAAC,qCAAqC,CAAC,CAAC;IAC/D,CAAC;IAED,MAAM,MAAM,GAAG,MAAA,OAAO,CAAC,MAAM,mCAAI,mBAAW,CAAC;IAC7C,MAAM,OAAO,GAAG,MAAA,OAAO,CAAC,OAAO,mCAAI,KAAM,CAAC;IAE1C,MAAM,IAAI,GAAG,IAAI,mBAAQ,EAAE,CAAC;IAC5B,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;IAExD,MAAM,QAAQ,GAAG,MAAM,eAAK,CAAC,IAAI,CAAkB,MAAM,EAAE,IAAI,EAAE;QAC7D,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,UAAU,EAAE,EAAE;QACjC,OAAO;QACP,gBAAgB,EAAE,QAAQ;QAC1B,aAAa,EAAE,QAAQ;KAC1B,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC,IAAI,CAAC;AACzB,CAAC,CAAC;AA1BW,QAAA,UAAU,cA0BrB;AAEF,iFAAiF;AAEjF;;;;;;;;;;GAUG;AACH,MAAa,OAAO;IAGhB,YAAY,UAA0B,EAAE;;QACpC,IAAI,CAAC,OAAO,GAAG;YACX,MAAM,EAAE,MAAA,OAAO,CAAC,MAAM,mCAAI,mBAAW;YACrC,OAAO,EAAE,MAAA,OAAO,CAAC,OAAO,mCAAI,KAAM;SACrC,CAAC;IACN,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,UAAkB,EAAE,QAAgB;QAC7C,OAAO,IAAA,kBAAU,EAAC,UAAU,EAAE,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED,+DAA+D;IAC/D,UAAU;QACN,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IAC/B,CAAC;CACJ;AAvBD,0BAuBC;AAED,iFAAiF;AAEjF,kBAAe,OAAO,CAAC"}

package/package.json

@@ -1,20 +1,70 @@
 {
-  "name": "@xstbot/cloudku",
-  "version": "1.0.1",
-  "description": "CloudKu CDN Uploader Library",
-  "main": "index.js",
-  "types": "index.d.ts",
-  "scripts": {
-    "build": "npx tsc src/index.ts --declaration --outDir ./ --esModuleInterop --skipLibCheck --target ES6 --module CommonJS"
-  },
-  "author": "xstbot",
-  "license": "MIT",
-  "dependencies": {
-    "axios": "^1.6.0",
-    "form-data": "^4.0.0"
-  },
-  "devDependencies": {
-    "typescript": "^5.0.0",
-    "@types/node": "^20.0.0"
-  }
-}
+    "name": "@xstbot/cloudku",
+    "version": "1.0.2",
+    "description": "CloudKu CDN Uploader Library",
+    "author": "xstbot",
+    "license": "MIT",
+    "main": "dist/index.js",
+    "module": "dist/esm/index.js",
+    "types": "dist/index.d.ts",
+    "exports": {
+        ".": {
+            "import": "./dist/esm/index.js",
+            "require": "./dist/index.js",
+            "types": "./dist/index.d.ts"
+        }
+    },
+    "files": [
+        "dist"
+    ],
+    "scripts": {
+        "build:cjs": "tsc --project tsconfig.json",
+        "build:esm": "tsc --project tsconfig.esm.json",
+        "build": "npm run build:cjs && npm run build:esm",
+        "prepare": "npm run build",
+        "clean": "rimraf dist"
+    },
+"keywords": [
+  "cloudku",
+  "cloudku-cdn",
+  "cdn",
+  "free-cdn",
+  "cloud-storage",
+  "file-upload",
+  "upload-file",
+  "uploader",
+  "cloud-uploader",
+  "storage",
+  "object-storage",
+  "media-upload",
+  "image-upload",
+  "video-upload",
+  "nodejs",
+  "typescript",
+  "javascript",
+  "api-client",
+  "rest-api",
+  "cdn-uploader",
+  "file-hosting",
+  "hosting",
+  "cloud-service",
+  "free-cloud"
+],
+    "dependencies": {
+        "axios": "^1.6.0",
+        "form-data": "^4.0.0"
+    },
+    "devDependencies": {
+        "@types/node": "^20.0.0",
+        "@types/form-data": "^2.5.0",
+        "typescript": "^5.3.0",
+        "rimraf": "^5.0.0"
+    },
+    "engines": {
+        "node": ">=14.0.0"
+    },
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/xstbot-cloudku/cloudku.git"
+    }
+}

package/index.d.ts

@@ -1,7 +0,0 @@
-export interface CloudKuResponse {
-    status: string;
-    message: string;
-    url?: string;
-    [key: string]: any;
-}
-export declare const CloudKu: (fileBuffer: Buffer, fileName: string) => Promise<CloudKuResponse>;

package/index.js

@@ -1,39 +0,0 @@
-"use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CloudKu = void 0;
-const axios_1 = __importDefault(require("axios"));
-const form_data_1 = __importDefault(require("form-data"));
-const CloudKu = (fileBuffer, fileName) => __awaiter(void 0, void 0, void 0, function* () {
-    var _a, _b, _c;
-    try {
-        const url = 'https://cloudku.sbs/cdn/api.php';
-        const form = new form_data_1.default();
-        form.append('file', fileBuffer, { filename: fileName });
-        const response = yield axios_1.default.post(url, form, {
-            headers: Object.assign({}, form.getHeaders()),
-            maxContentLength: Infinity,
-            maxBodyLength: Infinity
-        });
-        return response.data;
-    }
-    catch (error) {
-        console.error('❌ CloudKu Upload Error:', ((_a = error.response) === null || _a === void 0 ? void 0 : _a.data) || error.message);
-        return {
-            status: 'error',
-            message: ((_c = (_b = error.response) === null || _b === void 0 ? void 0 : _b.data) === null || _c === void 0 ? void 0 : _c.message) || error.message
-        };
-    }
-});
-exports.CloudKu = CloudKu;

package/src/index.ts

@@ -1,29 +0,0 @@
-import axios from 'axios';
-import FormData from 'form-data';
-
-export interface CloudKuResponse {
-    status: string;
-    message: string;
-    url?: string;
-    [key: string]: any;
-}
-
-export const CloudKu = async (fileBuffer: Buffer, fileName: string): Promise<CloudKuResponse> => {
-    try {
-        const url = 'https://cloudku.sbs/cdn/api.php';
-        const form = new FormData();
-        form.append('file', fileBuffer, { filename: fileName });
-        const response = await axios.post(url, form, {
-            headers: { ...form.getHeaders() },
-            maxContentLength: Infinity,
-            maxBodyLength: Infinity
-        });
-        return response.data;
-    } catch (error: any) {
-        console.error('❌ CloudKu Upload Error:', error.response?.data || error.message);
-        return {
-            status: 'error',
-            message: error.response?.data?.message || error.message
-        };
-    }
-};