@magradze/bog-payment-react არის თანამედროვე, უსაფრთხო და მარტივად გამოსაყენებელი ბიბლიოთეკა, რომელიც შექმნილია საქართველოს ბანკის Payments API-სთან სამუშაოდ Next.js-ის (App Router) არქიტექტურის გათვალისწინებით.

ბიბლიოთეკა გთავაზობთ კლიენტისა და სერვერის ფუნქციების მძლავრ ნაკრებს, რომელიც უზრუნველყოფს როგორც უსაფრთხოებას, ასევე შესანიშნავ დეველოპერულ გამოცდილებას (DX).

✨ მთავარი პრინციპები

• 🔐 უსაფრთხოება უპირველეს ყოვლისა: client_secret-ი და სხვა სენსიტიური ოპერაციები რჩება მხოლოდ სერვერზე.
• 🧠 გამიჯნული ლოგიკა: ბიბლიოთეკა დაყოფილია ორ ნაწილად:
  • @magradze/bog-payment-react/server: უსაფრთხო ფუნქციები სერვერისთვის.
  • @magradze/bog-payment-react/client: React ჰუკები და კომპონენტები კლიენტისთვის.
• ⚛️ თანამედროვე React: შექმნილია Next.js App Router-ისა და Server Actions-ების პარადიგმისთვის.
• 📄 ამომწურავი დოკუმენტაცია: დეტალური გზამკვლევები და მაგალითები ქართულ ენაზე.

📦 ინსტალაცია

npm install @magradze/bog-payment-react

🚀 სწრაფი სტარტი

ნახეთ, რა მარტივია ახალი არქიტექტურის გამოყენება:

1. შექმენი Server Action:

// app/actions/bog.ts
"use server";

import { createOrderAction } from '@magradze/bog-payment-react/server';

export const handleCreateOrder = async (payload) => {
  const config = {
    accessToken: "YOUR_ACCESS_TOKEN", // მიიღეთ უსაფრთხოდ
    baseUrl: process.env.NEXT_PUBLIC_BOG_BASE_URL,
  };
  return createOrderAction(config, payload);
};

2. გამოიყენე ჰუკი კლიენტზე:

// app/page.tsx
"use client";

import { useCreateOrder } from '@magradze/bog-payment-react/client';
import { handleCreateOrder } from './actions/bog';

const MyButton = () => {
  const { createOrder, data, isLoading } = useCreateOrder(handleCreateOrder);
  // ...
};

უფრო დეტალური მაგალითებისთვის, იხილეთ ჩვენი საწყისი გზამკვლევი.

📚 დოკუმენტაცია

• 🚀 საწყისი გზამკვლევი: ნაბიჯ-ნაბიჯ ინსტრუქცია სრული ინტეგრაციისთვის. დაიწყეთ აქედან!
• ⚙️ სერვერის ფუნქციები: ყველა სერვერის ფუნქციის დეტალური აღწერა.
• 🪝 კლიენტის ჰუკები: ყველა React ჰუკის დეტალური აღწერა.
• 🔵 Google Pay: ისწავლეთ, როგორ გამოიყენოთ <GooglePayButton /> კომპონენტი.

🤝 კონტრიბუცია

პროექტი ღიაა და მივესალმებით ნებისმიერ კონტრიბუციას. თუ გაქვთ იდეა, შენიშვნა ან გსურთ კოდის გაუმჯობესება, გთხოვთ, გახსენით Issue ან შექმენით Pull Request.

📄 ლიცენზია

ეს პროექტი ვრცელდება MIT ლიცენზიით.