تسجيل المستخدم

✅ هدف السيناريو:

• نحصل على نموذج التسجيل لإنشاء نموذج الواجهة الأمامية
• يدخل المستخدم البيانات المطلوبة ويسجل.
• بعد التسجيل، يتلقى المستخدم رمز التفعيل عبر البريد الإلكتروني/الرسائل القصيرة
• يدخل المستخدم رمز التفعيل ويفعل المستخدم الذي تم إنشاؤه.

✅ ما تحتاجه:

• عنوان URL صالح للمشروع و APP_TOKEN للمصادقة مع واجهة برمجة تطبيقات OneEntry.
• نموذج تسجيل مع علامة "reg"
• حقول النموذج (السمات) مع علامات "email_reg"، "password_reg"، "name_reg"، "phone_reg"
• بريد إلكتروني/رقم هاتف صالح لاستقبال رمز التفعيل

📌 مهم:

• لا نتعامل مع الأخطاء في هذه الأمثلة.
• يمكنك التعامل مع الأخطاء في trycatch أو في بناء مثل "await Promise.catch((error) => error)"

السيناريو

1. استيراد oneEntry وتحديد عنوان URL وtoken

مثال:

import { defineOneEntry } from 'oneentry';

const PROJECT_URL = 'your-project-url';
const APP_TOKEN = 'your-app-token';

2. إنشاء عميل API باستخدام دالة defineOneEntry()

مثال:

const { Forms, FormData } = defineOneEntry(PROJECT_URL, {
  token: APP_TOKEN,
});

3. نحصل على نموذج تسجيل باستخدام Forms.getFormByMarker() لإنشاء نموذج واجهة أمامية

مثال:

const form = await Forms.getFormByMarker('reg');

النتيجة:

{
  "id": 4,
  "attributeSetId": 5,
  "type": "sing_in_up",
  "localizeInfos": {
    "title": "تسجيل",
    "titleForSite": "",
    "successMessage": "",
    "unsuccessMessage": "",
    "urlAddress": "",
    "database": "0",
    "script": "0"
  },
  "version": 0,
  "position": 1,
  "identifier": "reg",
  "processingType": "script",
  "templateId": null,
  "attributes": [
    {
      "type": "string",
      "marker": "email_reg",
      "isLogin": true,
      "isSignUp": false,
      "position": 1,
      "settings": {},
      "isVisible": true,
      "listTitles": [],
      "validators": {
        "requiredValidator": {
          "strict": true
        },
        "emailInspectionValidator": true
      },
      "localizeInfos": {
        "title": "البريد الإلكتروني"
      },
      "additionalFields": [],
      "isNotificationEmail": false,
      "isNotificationPhoneSMS": null,
      "isNotificationPhonePush": null
    },
    {
      "type": "string",
      "marker": "name_reg",
      "isLogin": null,
      "isSignUp": true,
      "position": 2,
      "settings": {},
      "isVisible": true,
      "listTitles": [],
      "validators": {
        "requiredValidator": {
          "strict": true
        }
      },
      "localizeInfos": {
        "title": "الاسم"
      },
      "additionalFields": [],
      "isNotificationEmail": false,
      "isNotificationPhoneSMS": null,
      "isNotificationPhonePush": null
    },
    {
      "type": "string",
      "marker": "phone_reg",
      "isLogin": null,
      "isSignUp": true,
      "position": 3,
      "settings": {},
      "isVisible": true,
      "listTitles": [],
      "validators": {
        "requiredValidator": {
          "strict": true
        }
      },
      "localizeInfos": {
        "title": "الهاتف"
      },
      "additionalFields": [],
      "isNotificationEmail": false,
      "isNotificationPhoneSMS": null,
      "isNotificationPhonePush": null
    },
    {
      "type": "string",
      "marker": "password_reg",
      "isLogin": null,
      "isSignUp": null,
      "position": 4,
      "settings": {},
      "isVisible": true,
      "listTitles": [],
      "validators": {
        "requiredValidator": {
          "strict": true
        },
        "stringInspectionValidator": {
          "stringMax": 0,
          "stringMin": 0,
          "stringLength": 0
        }
      },
      "localizeInfos": {
        "title": "كلمة المرور"
      },
      "additionalFields": [],
      "isNotificationEmail": false,
      "isNotificationPhoneSMS": null,
      "isNotificationPhonePush": null
    },
    {
      "type": "string",
      "marker": "email_notification_reg",
      "isLogin": null,
      "isSignUp": null,
      "position": 5,
      "settings": {},
      "isVisible": true,
      "listTitles": [],
      "validators": {},
      "localizeInfos": {
        "title": "البريد الإلكتروني للإشعار"
      },
      "additionalFields": [],
      "isNotificationEmail": true,
      "isNotificationPhoneSMS": null,
      "isNotificationPhonePush": null
    }
  ]
}

4. إعداد البيانات لتسجيل المستخدم وتسجيل المستخدم باستخدام AuthProvider.signUp()

البيانات:

{
  "formIdentifier": "reg",
  "authData": [
    {
      "marker": "email_reg",
      "value": "your-user@email.com"
    },
    {
      "marker": "password_reg",
      "value": "123456"
    }
  ],
  "formData": {
    "en_US": [
      {
        "marker": "name_reg",
        "type": "string",
        "value": "UserName"
      },
      {
        "marker": "phone_reg",
        "type": "string",
        "value": "+18007986545"
      },
      {
        "marker": "email_notification_reg",
        "type": "string",
        "value": "your-user@email.com"
      }
    ]
  },
  "notificationData": {
    "email": "your-user@email.com",
    "phonePush": [],
    "phoneSMS": "+18007986545"
  },
  "langCode": "en_US"
}

مثال:

const newUser = await AuthProvider.signUp('email', registrationData);

النتيجة:

{
  "identifier": "your-user@email.com",
  "isActive": false,
  "formData": [
    {
      "marker": "name_reg",
      "type": "string",
      "value": "UserName"
    },
    {
      "marker": "phone_reg",
      "type": "string",
      "value": "+18007986545"
    },
    {
      "marker": "email_notification_reg",
      "type": "string",
      "value": "your-user@email.com"
    }
  ],
  "notificationData": {
    "email": "your-user@email.com",
    "phonePush": [],
    "phoneSMS": "+18007986545"
  },
  "locale": "en_US",
  "updatedDate": "2025-04-30T20:07:38.156Z",
  "deletedAt": null,
  "id": 33,
  "version": 0,
  "state": {}
}

5. توليد رمز تأكيد باستخدام AuthProvider.generateCode() وإرساله إلى البريد الإلكتروني/الرسائل القصيرة

البيانات:

your-user@email.com

مثال:

const generateCode = await AuthProvider.generateCode('email', emailReg, 'auth');

النتيجة:

{
  "statusCode": 400,
  "timestamp": "2025-04-30T20:07:39.755Z",
  "message": "لدى المستخدم بالفعل رمز",
  "pageData": null
}

6. يدخل المستخدم الرمز → التحقق

مثال:

const code = prompt('أدخل رمز التحقق:') as string;

7. تحقق من الرمز باستخدام AuthProvider.checkCode() إذا كان الرمز صحيحًا، قم بتنشيط المستخدم

مثال:

const isCorrect = await AuthProvider.checkCode(
  'email',
  emailReg,
  '1',
  code,
);
if (isCorrect) {
  await AuthProvider.activateUser('email', emailReg, code);
  console.log('✅ تم تفعيل المستخدم!');
} else {
  console.log('❌ رمز التحقق غير صالح');
}

8. مصادقة المستخدم باستخدام AuthProvider.auth()

مثال:

const authResponse = await AuthProvider.auth('email', {
  authData,
});

النتيجة:

{
  "userIdentifier": "your-user@email.com",
  "authProviderIdentifier": "email",
  "accessToken": "eyJhbGciOiJIUzI1NiIsInR...pZCI6MTYsImF1dGhQ"
  "refreshToken": "1745494429101-...-2834edf8"
}

المثال النهائي

// 1. استيراد oneEntry وتحديد PROJECT_URL و APP_TOKEN
import { defineOneEntry } from 'oneentry';

const PROJECT_URL = 'your-project-url';
const APP_TOKEN = 'your-app-token';

const emailReg = 'your-user@email.com';

// 2. إنشاء عميل API:
const { Forms, AuthProvider } = defineOneEntry(PROJECT_URL, {
  token: APP_TOKEN,
});

// 3. نحصل على نموذج تسجيل مع حقول مخصصة لإنشاء نموذج واجهة أمامية
const form = await Forms.getFormByMarker('reg');

// 4. إعداد البيانات لتسجيل المستخدم وتسجيل المستخدم
const authData = [
  {
    marker: 'email_reg',
    value: 'your-user@email.com',
  },
  {
    marker: 'password_reg',
    value: '123456',
  },
];
const formData = [
  {
    marker: 'name_reg',
    type: 'string',
    value: 'UserName',
  },
  {
    marker: 'phone_reg',
    type: 'string',
    value: '+18007986545',
  },
  {
    marker: 'email_notification_reg',
    type: 'string',
    value: emailReg,
  },
];
const notificationData = {
  email: emailReg,
  phonePush: [],
  phoneSMS: '+18007986545',
};
const registrationData = {
  formIdentifier: 'reg',
  authData: authData,
  formData: formData,
  notificationData: notificationData,
};
let newUser = await AuthProvider.signUp('email', registrationData);

// 5. توليد رمز تأكيد (إرساله إلى البريد الإلكتروني)
let generateCode = await AuthProvider.generateCode('email', emailReg, 'auth');

// 6. يدخل المستخدم الرمز → التحقق
const code = prompt('أدخل رمز التحقق:') as string;

// 7. تنشيط المستخدم
const isCorrect = await AuthProvider.checkCode(
  'email',
  emailReg,
  '1',
  code,
);

if (isCorrect) {
  await AuthProvider.activateUser('email', emailReg, code);
  console.log('✅ تم تفعيل المستخدم!');
} else {
  console.log('❌ رمز التحقق غير صالح');
}

// 8. مصادقة المستخدم
const authResponse = await AuthProvider.auth('email', {
  authData,
});
console.log(authResponse);