> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Bun (تجريبي)

# Bun (تجريبي)

الهدف: تشغيل هذا المستودع باستخدام **Bun** (اختياري، غير موصى به لـ WhatsApp/Telegram)
من دون الانحراف عن سير عمل pnpm.

⚠️ **غير موصى به لبيئة تشغيل Gateway** (أخطاء WhatsApp/Telegram). استخدم Node للإنتاج.

## الحالة

* Bun هو بيئة تشغيل محلية اختيارية لتشغيل TypeScript مباشرةً (`bun run …`، `bun --watch …`).
* `pnpm` هو الافتراضي لعمليات البناء ويظل مدعومًا بالكامل (ويُستخدم بواسطة بعض أدوات التوثيق).
* لا يمكن لـ Bun استخدام `pnpm-lock.yaml` وسيتجاهله.

## التثبيت

الافتراضي:

```sh theme={"theme":{"light":"min-light","dark":"min-dark"}}
bun install
```

ملاحظة: يتم تجاهل `bun.lock`/`bun.lockb` عبر gitignore، لذا لا يحدث أي تغيّر في المستودع في كلتا الحالتين. إذا كنت تريد *عدم كتابة أي ملفات قفل*:

```sh theme={"theme":{"light":"min-light","dark":"min-dark"}}
bun install --no-save
```

## البناء / الاختبار (Bun)

```sh theme={"theme":{"light":"min-light","dark":"min-dark"}}
bun run build
bun run vitest run
```

## نصوص دورة حياة Bun (محجوبة افتراضيًا)

قد يحجب Bun نصوص دورة حياة التبعيات ما لم يتم الوثوق بها صراحةً (`bun pm untrusted` / `bun pm trust`).
بالنسبة لهذا المستودع، النصوص الشائعة التي تُحجب ليست مطلوبة:

* `@whiskeysockets/baileys` `preinstall`: يتحقق من أن الإصدار الرئيسي لـ Node >= 20 (نحن نشغّل Node 22+).
* `protobufjs` `postinstall`: يُصدر تحذيرات حول مخططات إصدارات غير متوافقة (من دون مخرجات بناء).

إذا واجهت مشكلة تشغيل حقيقية تتطلب هذه النصوص، فقم بالوثوق بها صراحةً:

```sh theme={"theme":{"light":"min-light","dark":"min-dark"}}
bun pm trust @whiskeysockets/baileys protobufjs
```

## التنبيهات

* لا تزال بعض النصوص تُضمّن pnpm بشكل ثابت (مثل `docs:build`، `ui:*`، `protocol:check`). شغّل هذه عبر pnpm في الوقت الحالي.