@boodibox/api-client 0.1.0 → 0.1.2

package/README.md

@@ -1,18 +1,27 @@
 # @boodibox/api-client
 
-این بسته برای **ارسال خودکار پست‌ها به `https://boodibox.com/posts`** طراحی شده — یعنی شما می‌توانید به‌سرعت پست منتشر کنید یا یک بات بسازید که محتوای شما را خودکار ارسال کند.  
-کتابخانه جریان کامل را پوشش می‌دهد: آپلود تصویر (اختیاری) → نظارت روی وضعیت تا زمانی که پردازش شود → ارسال پست با `medias` که سرور تولید می‌کند.
+<div dir="rtl">
 
-**آموزش گرفتن API Key:** https://boodibox.com/dev/api-key
+این بسته برای ارسال خودکار **پست‌ها** به https://boodibox.com/posts طراحی شده یعنی شما می‌توانید به‌سرعت پست منتشر کنید یا یک بات بسازید که محتوای شما را خودکار ارسال کند.  
+
+کتابخانه جریان کامل را پوشش می‌دهد: آپلود تصویر (اختیاری) ← نظارت روی وضعیت تا زمانی که پردازش شود ← ارسال پست با `medias` که سرور تولید می‌کند.
 
+**آموزش گرفتن API Key:** https://boodibox.com/dev/api-key
 
 ## نصب
+
+</div>
+
 ```bash
 npm install @boodibox/api-client
-# یا
+```
+یا
+```bash
 yarn add @boodibox/api-client
 ````
 
+<div dir="rtl">
+
 > این کتابخانه از امکانات بومی Node (fetch, FormData, Blob) استفاده می‌کند. از Node >= 18 استفاده کنید، یا برای محیط‌هایی که `FormData` / `Blob` ندارند یک polyfill نصب کنید (مثلاً `formdata-node`).
 
 ---
@@ -32,6 +41,8 @@ yarn add @boodibox/api-client
 
 ## استفادهٔ سریع
 
+</div>
+
 ```js
 const createClient = require('@boodibox/api-client');
 
@@ -52,20 +63,29 @@ await client.submitPostWithFiles({
 
 ---
 
+<div dir="auto">
+
 ## APIها (توابع اصلی)
 
 * `createClient({ baseUrl, apiKey })` – ساخت کلاینت
-* `uploadFiles(files)` – آپلود فایل‌ها (برمی‌گرداند آرایه‌ای از apiupload ids)
+* `uploadFiles(files)` – آپلود فایل‌ها (برمی‌گرداند آرایه‌ای از upload ids)
 * `pollUntilProcessed(uploadId, options)` – نظارت تا وضعیت `PROCESSED`
 * `submitPost({ body, medias, replyPermission, quotePostID, userIP })`
 * `submitPostWithFiles({ body, files, replyPermission, quotePostID, pollOptions, timeoutMs })`
 
-  * این تابع به‌صورت convenience تمامی مراحل را انجام می‌دهد: آپلود فایل‌ها → poll تا پردازش → ارسال پست با `medias` برگشتی
+---
+  * این تابع به‌صورت convenience تمامی مراحل را انجام می‌دهد: آپلود فایل‌ها ← poll تا پردازش ← ارسال پست با `medias` برگشتی
+
+<!-- <div align="left"> -->
+
+---- 
 
 ### شکل فایل‌ها (files)
 
 هر عنصر می‌تواند یکی از موارد باشد:
 
+<!-- </div> -->
+
 * `{ path: "./file.jpg" }` — خواندن از دیسک
 * `{ buffer: Buffer, filename: "a.jpg" }`
 * `{ file: File }` (در مرورگر)
@@ -84,12 +104,14 @@ await client.submitPostWithFiles({
 
 برای اجرای تست‌های یکپارچه (integration) به صورت اختیاری از متغیرهای محیطی زیر استفاده کنید:
 
-* `API_KEY` — مقدار API key (فرمت: `Bearer <token>` یا فقط توکن)
-* `TEST_INTEGRATION=true` — اگر این مقدار تنظیم نشده باشد، تست یکپارچه نادیده گرفته می‌شود
-* `BASE_URL` — آدرس سرور (مثلاً `http://localhost:3000` یا `https://boodibox.com`)
+* `API_KEY` :مقدار API key (فرمت: `Bearer <token>` یا فقط توکن)
+* `TEST_INTEGRATION=true` :اگر این مقدار تنظیم نشده باشد، تست یکپارچه نادیده گرفته می‌شود
+* `BASE_URL` :آدرس سرور (مثلاً `http://localhost:3000` یا `https://boodibox.com`)
 
 نمونه:
 
+</div>
+
 ```bash
 export API_KEY="Bearer xxxxx"
 export TEST_INTEGRATION=true
@@ -97,11 +119,15 @@ export BASE_URL="http://localhost:3000"
 bun test
 ```
 
+<div dir="rtl">
+
 ## لینک مفید
 * راهنمای گرفتن API Key: [https://boodibox.com/dev/api-key](https://boodibox.com/dev/api-key)
 
 * پست ها بودیباکس: [https://boodibox.com/posts](https://boodibox.com/posts)
 
+</div>
+
 ## License
 
 MIT License

package/index.js

@@ -5,6 +5,7 @@
  * Changes:
  *  - replyPermission defaults to "PUBLIC" when omitted
  *  - explicitly empty or falsey replyPermission values are rejected
+ *  - submitPost now requires either a non-empty body or at least one media
  *  - other behavior unchanged (upload -> poll -> submit)
  */
 
@@ -186,6 +187,7 @@ function createClient(opts = {}) {
    * submitPost
    * replyPermission: if undefined -> defaults to PUBLIC
    * if explicitly provided but empty/falsey -> throws
+   * now enforces: post must have non-empty body OR at least one media
    */
   async function submitPost({ body = '', medias = [], replyPermission = undefined, quotePostID = null, userIP = null }) {
     // Handle replyPermission defaulting and validation
@@ -199,6 +201,13 @@ function createClient(opts = {}) {
 
     const qid = quotePostID == null ? null : validateQuotePostID(quotePostID);
 
+    // Validation: require either a non-empty body or at least one media
+    const bodyStr = (body == null ? '' : String(body)).trim();
+    const hasMedias = Array.isArray(medias) && medias.length > 0;
+    if (!bodyStr && !hasMedias) {
+      throw new Error('Post must include a non-empty body or at least one media.');
+    }
+
     const url = new URL(config.postsPath, config.baseUrl).toString();
     const payload = { body, medias, replyPermission: rp, quotePostID: qid };
     if (userIP) payload.userIP = userIP;
@@ -222,21 +231,26 @@ function createClient(opts = {}) {
    * submitPostWithFiles
    * - If replyPermission undefined -> defaults to PUBLIC
    * - If replyPermission explicitly provided but empty -> throw
+   * - Requires either body or files; if files provided they will be uploaded
    */
   async function submitPostWithFiles({ body = '', files = [], replyPermission = undefined, quotePostID = null, pollOptions = {}, timeoutMs = 120000 }) {
-    if (!Array.isArray(files) || files.length === 0) {
-      // still require replyPermission defaulting behavior
-      return submitPost({ body, medias: [], replyPermission, quotePostID });
+    // If no files and empty body -> reject early
+    const bodyStr = (body == null ? '' : String(body)).trim();
+    if ((!Array.isArray(files) || files.length === 0) && !bodyStr) {
+      throw new Error('Post must include a non-empty body or at least one file to upload.');
     }
 
-    // validate upfront: default or validate
-    if (replyPermission === undefined) {
-      // allow defaulting later in submitPost, but keep same normalization here
-    } else {
+    // validate upfront: default or validate replyPermission and quotePostID
+    if (replyPermission !== undefined) {
       validateReplyPermission(replyPermission);
     }
     if (quotePostID != null) validateQuotePostID(quotePostID);
 
+    if (!Array.isArray(files) || files.length === 0) {
+      // no files to upload, delegate to submitPost which also validates
+      return submitPost({ body, medias: [], replyPermission, quotePostID });
+    }
+
     const uploads = await retryAsync(() => uploadFiles(files), config.maxRetries, 300).catch(err => {
       throw new Error(`Uploading files failed: ${err.message}`);
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@boodibox/api-client",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Minimal client for BoodiBox API - submit posts - automate - upload media.",
   "main": "index.js",
   "license": "MIT",