किसी फ़ंक्शन का आह्वान करें

invoke एकमात्र कॉल है जो सार्वजनिक कुंजी कर सकती है। यह ब्राउज़र और सर्वर पर समान रूप से कार्य करता है।

import { createClient } from '@aurabase/aurabase-js'

const aura = createClient(process.env.AURA_URL!, process.env.AURA_ANON_KEY!)

const { data, error } = await aura.functions.invoke<{ greeting: string }>('hello', {
  body: { name: 'Ada' },
})
if (error) throw error
console.log(data?.greeting)

// साइन-इन करने के बाद, SDK प्रत्येक कॉल में उपयोगकर्ता का JWT जोड़ता है: कोई अतिरिक्त कोड नहीं।
await aura.auth.signInWithPassword({ email, password })
const { data } = await aura.functions.invoke('whoami')
// फ़ंक्शन x-aura-role: प्रमाणित और उपयोगकर्ता की आईडी देखता है।

सामान्य invoke<T> केवल प्रतिक्रिया टाइप करता है। संकलन के समय नाम और मुख्य भाग की जाँच नहीं की जाती है।

आपका फ़ंक्शन ठीक वही अनुरोध प्राप्त करता है जिसका आप वर्णन करते हैं, न कि उसके चारों ओर कोई आवरण।

await aura.functions.invoke('items', {
  method: 'PUT',
  path: '/items/1',
  headers: { 'x-source': 'dashboard' },
  body: { qty: 2 },
})

Deno.serve(async (req) => {
  const url = new URL(req.url)          // पथनाम: '/आइटम/1'
  const source = req.headers.get('x-source') // 'डैशबोर्ड'
  const body = await req.json()         // { मात्रा: 2 }
  return Response.json({ method: req.method, id: url.pathname.split('/').pop(), source, body })
})

जानने लायक नियम:

• GET और HEAD बिना किसी बॉडी के भेजे जाते हैं।
• एक बॉडी जो स्ट्रिंग नहीं है उसे JSON के रूप में content-type: application/json के साथ भेजा जाता है, जब तक कि आप एक सेट नहीं करते। एक स्ट्रिंग बॉडी को वैसे ही भेजा जाता है और उसे content-type: application/json भी मिलता है, इसलिए इसे req.text() के साथ पढ़ें।
• body के बिना, फ़ंक्शन को बिना किसी निकाय के एक अनुरोध प्राप्त होता है। एक खाली await req.json() फेंकता है, इसलिए जब कॉल पेलोड के बिना किया जा सकता है तो await req.json().catch(() => ({})) लिखें।
• मुख्य भाग JSON होना चाहिए: एक ऑब्जेक्ट, सरणी, स्ट्रिंग, संख्या या बूलियन। किसी भी अनुरोध को भेजने से पहले Blob, ArrayBuffer, टाइप की गई सरणी, FormData, URLSearchParams या ReadableStream को त्रुटि कोड invalid_body के साथ अस्वीकार कर दिया जाता है।
• फ़्रेमिंग हेडर (content-length, transfer-encoding, connection, host, ...) को नजरअंदाज कर दिया जाता है।

प्लेटफ़ॉर्म आपके फ़ंक्शन के चलने से पहले कुंजी और उपयोगकर्ता के टोकन को मान्य करता है, फिर इन हेडर को जोड़ता है:

Deno.serve((req) => {
  if (req.headers.get('x-aura-role') !== 'authenticated') {
    return new Response('Sign in first', { status: 401 })
  }
  return Response.json({ userId: req.headers.get('x-aura-user-id') })
})

तीन अलग-अलग कुंजियों के साथ इस कॉल के वास्तविक परिणाम:

{ "role": "anon",          "userId": null }
{ "role": "authenticated", "userId": "b125f8cd-ddc8-4042-9d9d-2e0aa3cebe51" }
{ "role": "service_role",  "userId": null }

SDK के बिना, एक JSON ऑब्जेक्ट भेजें जो अनुरोध का वर्णन करता हो। body फ़ील्ड वह है जो आपका फ़ंक्शन प्राप्त करता है।

curl -X POST "$AURA_URL/v1/functions/hello/invoke" \
  -H "apikey: $AURA_ANON_KEY" \
  -H "Content-Type: application/json" \
  -d '{"body":{"name":"Ada"}}'

apikey और Content-Type: application/json दोनों आवश्यक हैं। साइन-इन उपयोगकर्ता के रूप में कॉल करने के लिए Authorization: Bearer <user JWT> जोड़ें। डिफ़ॉल्ट प्रतिक्रिया एक लिफाफा है; X-Aurabase-Invoke-Mode: raw हेडर इसके बजाय आपके फ़ंक्शन की अपनी प्रतिक्रिया देता है, गैर-JSON प्रतिक्रियाएँ देखें।

invoke कभी नहीं फेंकता. यह { data, error } लौटाता है:

const { data, error } = await aura.functions.invoke('hello', { body: { name: 'Ada' } })

if (error) {
  // error.status: विफलता की HTTP स्थिति
  // error.message: आपके फ़ंक्शन द्वारा लौटाया गया टेक्स्ट, या प्लेटफ़ॉर्म का स्पष्टीकरण
  return
}
// जब फ़ंक्शन कोई सामग्री नहीं लौटाता तो डेटा शून्य हो जाता है (उदाहरण के लिए 204)
if (data === null) return
console.log(data)

जब आपको मान की आवश्यकता हो तो error के बजाय data का परीक्षण करें: TypeScript तब पता चलता है कि यह null नहीं है। विफलताओं को ठीक से संभालने के लिए, त्रुटियाँ, टाइमआउट और पुनः प्रयास पढ़ें।