Supabase کنیکٹر

ڈیٹا بیس ریکارڈز، صارف تصدیق ڈیٹا، فائل اسٹوریج ایونٹس، اور گاہک engagement آٹومیشن کے لیے ریئل ٹائم تبدیلیوں کو سنک کرنے کے لیے اپنے Supabase پروجیکٹ کو منسلک کریں۔

جائزہ

خصوصیات

• خودکار تیار شدہ REST API, PostgREST کے ذریعے کسی بھی Postgres ٹیبل پر CRUD آپریشنز، کوئی کوڈ درکار نہیں
• Auth صارف سنک, Supabase Auth صارفین (ای میل، فون، سوشل لاگ ان) کو اپنے engagement پلیٹ فارم پر سنک کریں
• ریئل ٹائم سبسکرپشنز, کسی بھی ٹیبل پر INSERT, UPDATE, DELETE ایونٹس کو ریئل ٹائم میں سنیں
• Row Level Security, تمام API رسائی محفوظ ملٹی ٹیننٹ ڈیٹا کے لیے Postgres RLS پالیسیوں کا احترام کرتی ہے
• اسٹوریج انٹیگریشن, Storage buckets میں فائل اپ لوڈز ٹریک کریں اور اثاثوں کا انتظام کریں
• Edge Functions, کسٹم لاجک اور webhooks کے لیے serverless Deno فنکشنز کو invoke کریں
• مکمل ٹیکسٹ سرچ, API کے ذریعے Postgres مکمل ٹیکسٹ سرچ صلاحیتوں کا فائدہ اٹھائیں

شرائط

شروع کرنے سے پہلے، یقینی بنائیں کہ آپ کے پاس ہے:

1. Supabase پروجیکٹ (app.supabase.com)
2. آپ کے پروجیکٹ کا API URL اور API keys (Settings → API میں ملتے ہیں)
3. API رسائی کے ساتھ Tajo اکاؤنٹ

تصدیق

Supabase API key تصدیق استعمال کرتا ہے۔ ہر درخواست کو apikey ہیڈر اور اختیاری طور پر صارف اسکوپڈ رسائی کے لیے Authorization bearer ٹوکن درکار ہوتا ہے۔

# Using anon key (respects RLS)
curl 'https://<project_ref>.supabase.co/rest/v1/customers' \
  -H "apikey: <SUPABASE_ANON_KEY>" \
  -H "Authorization: Bearer <SUPABASE_ANON_KEY>"

# Using service_role key (bypasses RLS)
curl 'https://<project_ref>.supabase.co/rest/v1/customers' \
  -H "apikey: <SUPABASE_SERVICE_ROLE_KEY>" \
  -H "Authorization: Bearer <SUPABASE_SERVICE_ROLE_KEY>"

تشکیل

بنیادی سیٹ اپ

connectors:
  supabase:
    enabled: true
    project_url: "https://xyzcompany.supabase.co"
    api_key: "${SUPABASE_SERVICE_ROLE_KEY}"

    # Data sync options
    sync:
      users: true
      tables:
        - customers
        - orders
        - products
      storage: true
      realtime: true

    # Map Supabase Auth users to contacts
    user_mapping:
      email: email
      phone: SMS
      user_metadata.full_name: FIRSTNAME
      created_at: SIGNUP_DATE

فیلڈ میپنگ

Supabase ٹیبل کالمز کو engagement پلیٹ فارم خصوصیات پر میپ کریں:

کسٹم ٹیبل میپنگ

table_mapping:
  customers:
    # Column → Attribute mapping
    email: email
    full_name: FIRSTNAME
    company: COMPANY
    plan: SUBSCRIPTION_PLAN
    mrr: MONTHLY_REVENUE
    created_at: SIGNUP_DATE

  orders:
    # Track as events
    sync_as: events
    event_name: "order_placed"
    properties:
      total: amount
      status: order_status
      items: line_items

API اینڈ پوائنٹس

Supabase REST API آپ کے ڈیٹا بیس اسکیما سے https://<ref>.supabase.co/rest/v1/ پر خودکار تیار ہوتی ہے۔

فلٹرنگ آپریٹرز

ایونٹس

Auth ایونٹس

ڈیٹا بیس ایونٹس (Realtime)

Webhook ایونٹس

کوڈ کی مثالیں

کنیکٹر کو انیشیلائز کریں

import { TajoClient } from '@tajo/sdk';
import { createClient } from '@supabase/supabase-js';

const tajo = new TajoClient({
  apiKey: process.env.TAJO_API_KEY,
});

// Connect Supabase project
await tajo.connectors.connect('supabase', {
  projectUrl: process.env.SUPABASE_URL,
  serviceRoleKey: process.env.SUPABASE_SERVICE_ROLE_KEY,
});

صارفین کو رابطوں میں سنک کریں

// Sync all Supabase Auth users as contacts
await tajo.connectors.sync('supabase', {
  type: 'full',
  resources: ['users'],
});

// Incremental sync (new/changed users only)
await tajo.connectors.sync('supabase', {
  type: 'incremental',
  resources: ['users'],
  since: '2024-01-01T00:00:00Z',
});

ریئل ٹائم تبدیلیاں سنیں

// Subscribe to new orders for engagement triggers
const supabase = createClient(
  process.env.SUPABASE_URL,
  process.env.SUPABASE_SERVICE_ROLE_KEY
);

supabase
  .channel('orders')
  .on('postgres_changes',
    { event: 'INSERT', schema: 'public', table: 'orders' },
    async (payload) => {
      // Forward to Tajo as an event
      await tajo.events.track({
        email: payload.new.customer_email,
        event: 'order_placed',
        properties: {
          order_id: payload.new.id,
          total: payload.new.total,
          items: payload.new.line_items,
        },
      });
    }
  )
  .subscribe();

کوئری اور سیگمنٹ

// Query customers by plan for targeted campaigns
const { data: proUsers } = await supabase
  .from('customers')
  .select('email, full_name, plan, mrr')
  .eq('plan', 'pro')
  .gt('mrr', 100)
  .order('mrr', { ascending: false });

// Sync to a Brevo list for campaign targeting
await tajo.lists.addContacts(PRO_LIST_ID, proUsers);

شرح کی حدود

ٹربل شوٹنگ

عام مسائل

ڈیبگ موڈ

connectors:
  supabase:
    debug: true
    log_level: verbose
    log_queries: true
    log_realtime: true

کنکشن ٹیسٹ کریں

tajo connectors test supabase
# ✓ API connection successful
# ✓ Auth endpoint accessible
# ✓ Tables readable (12 tables found)
# ✓ Storage accessible (3 buckets)
# ✓ Realtime connection established
# ✓ Edge Functions available (4 functions)

بہترین طرز عمل

1. service_role key صرف سرور سائڈ استعمال کریں, اسے کبھی کلائنٹ کوڈ میں ظاہر نہ کریں
2. تمام ٹیبلز پر RLS فعال کریں, service_role کے ساتھ بھی، defense in depth کے لیے RLS کے ساتھ ڈیزائن کریں
3. ایونٹ پر مبنی سنک کے لیے Realtime استعمال کریں, تبدیلیوں کے لیے polling سے زیادہ موثر
4. بیچ آپریشنز, اعلی حجم آپریشنز کے لیے بلک inserts اور in فلٹر استعمال کریں
5. صارف میٹا ڈیٹا میپ کریں, سائن اپ کے دوران engagement سے متعلقہ فیلڈز کو user_metadata میں محفوظ کریں
6. webhooks کے لیے Edge Functions استعمال کریں, کم latency ہینڈلنگ کے لیے Supabase Edge Functions کے ساتھ آنے والے webhooks پروسیس کریں

سیکیورٹی

• API Key تصدیق, تمام درخواستوں کو درست API keys درکار ہیں
• Row Level Security (RLS), Postgres نیٹیو رسائی کنٹرول فی سطر
• JWT تصدیق, Auth ٹوکنز دستخط شدہ JWTs ہیں جو ہر درخواست پر تصدیق ہوتے ہیں
• SSL/TLS, تمام کنکشنز ٹرانزٹ میں انکرپٹڈ
• SOC 2 Type II, Supabase SOC 2 کمپلائنٹ ہے
• نیٹ ورک پابندیاں, paid پلانز پر اختیاری IP allowlisting

متعلقہ وسائل

• Shopify کنیکٹر
• Stripe کنیکٹر
• Auth0 کنیکٹر
• Supabase آفیشل دستاویزات
• Supabase REST API گائیڈ
• Supabase Auth گائیڈ