Payload

payload() सोर्स के माध्यम से किसी Payload कलेक्शन को उसके REST API से पढ़ें और Lexical रिच टेक्स्ट बॉडी को Markdown में बदलें। इसके लिए कुछ भी इंस्टॉल करने की आवश्यकता नहीं है।

बिल्ट-इन payload() एडेप्टर Payload REST API (/api/<collection>) के माध्यम से कोई कलेक्शन पढ़ता है और प्रत्येक दस्तावेज़ की Lexical बॉडी को Markdown में बदलता है। इसमें पैराग्राफ़, हेडिंग, बुलेट, क्रमांकित और चेक सूचियाँ, उद्धरण, लिंक, अपलोड और क्षैतिज रेखाएँ शामिल हैं। यदि बॉडी किसी टेक्स्ट फ़ील्ड में रखी गई है, तो वह Markdown के रूप में ज्यों-की-त्यों आगे भेज दी जाती है। अपवाद केवल वे लिंक हैं जो वेब, मेल, फ़ोन या सापेक्ष पते की ओर नहीं ले जाते। ऐसे लिंक का केवल लेबल रखा जाता है। कुछ भी इंस्टॉल करने की आवश्यकता नहीं है।

import { defineConfig } from "blume";
import { filesystem, payload } from "blume/sources";

export default defineConfig({
  content: {
    sources: [
      filesystem({ root: "docs" }),
      payload({
        prefix: "handbook",
        url: "https://cms.example.com",
        collection: "docs",
        // Field paths default to title / description / slug / content / updatedAt
        fields: { body: "richText" },
        // Extra query parameters: where[...], sort
        params: { sort: "title" },
      }),
    ],
  },
});

API कुंजी PAYLOAD_API_KEY एनवायरनमेंट वेरिएबल से ली जाती है और users API-Key <key> के रूप में भेजी जाती है। यदि कुंजी किसी दूसरे auth-सक्षम कलेक्शन की है, तो authCollection सेट करें। केवल प्रकाशित दस्तावेज़ इम्पोर्ट किए जाते हैं। --preview ड्राफ़्ट भी माँगता है और उन्हें draft: true के साथ स्टेज करता है। दस्तावेज़ depth: 1 के साथ फ़ेच किए जाते हैं, ताकि अपलोड के साथ उनके URL भी आएँ। सापेक्ष अपलोड पथ (/media/x.png) url के आधार पर रिज़ॉल्व होता है। यदि आप payloadSource को सीधे बनाकर custom() को पास करते हैं, तो इंजन के serializers विकल्प से block या inlineBlock नोड को किसी Blume कॉम्पोनेंट से मैप किया जा सकता है। यह मैपिंग blockType के आधार पर होती है। serializers सेट करने पर सोर्स के पेज MDX के रूप में लिखे जाते हैं, ताकि लौटाए गए कॉम्पोनेंट रेंडर हो सकें। Markdown टेक्स्ट फ़ील्ड में रखी गई बॉडी Markdown ही रहती है।