@faisalbz/tester-sdk

مكتبة TesterSDK لـ Expo / React Native — JavaScript خالصة، تعمل في Expo Go. الربط يلتقط الرمز تلقائياً من رابط الدعوة الذي يُفتح به التطبيق، ويحفظه على الجهاز بلا نافذة إدخال. والمرات التالية يجده محفوظاً فلا يعيد شيئاً.

التثبيت (في مشروع المطوّر)

npm install @faisalbz/tester-sdk
npx expo install expo-secure-store expo-device expo-application expo-linking

الإعداد

1) سجّل مخطط التطبيق (scheme) في app.json

{ "expo": { "scheme": "myapp" } }

2) هيّئ المكتبة في المكوّن الجذري — هذا كل ما يكتبه المطوّر:

import { useEffect } from 'react';
import * as TesterSdk from '@faisalbz/tester-sdk';

export default function App() {
  useEffect(() => {
    TesterSdk.init({
      appKey: 'pk_live_...',
      endpoint: 'https://api.yourplatform.com',
    });
  }, []);

  // ... بقية التطبيق
}

بعد هذا: حين يفتح المختبِر رابط الدعوة (myapp://bind?token=...)، يلتقط الـ SDK الرمز، يربط، ويحفظه — تلقائياً وبلا أي شاشة.

كيف يصل الرمز

المنصة ترسل للمختبِر رابطاً بمخطط تطبيق المطوّر:

myapp://bind?token=<BIND_TOKEN>

المختبِر يفتحه → يُفتح التطبيق → يُربط تلقائياً.

الحدّ الصادق

الربط "من تثبيت Google Play مباشرة بلا فتح رابط" يتطلب Install Referrer، وهو كود أصلي لا يتوفّر في JavaScript. النسخة السهلة تربط حين يُفتح التطبيق عبر رابط الدعوة (نقرة واحدة من المختبِر). للربط التلقائي الكامل من التثبيت، استخدم النسخة الأصلية (Kotlin AAR) مع Install Referrer.

الواجهة

• init({ appKey, endpoint, autoBind? }) — تهيئة + رصد جلسات + التقاط تلقائي للرمز.
• bind(token) — ربط يدوي (احتياطي).
• bindFromUrl(url) — استخراج الرمز من رابط ثم الربط.
• isBound() — هل النسخة مربوطة (الرمز محفوظ).

النشر (لك)

npm login
npm publish

ملاحظات

• التوقيع HMAC مطابق لخادم Laravel بالبايت.
• autoBind افتراضي true؛ مرّر false لتعطيله والربط يدوياً فقط.