@payloadcms/figma 0.0.1-alpha.3 → 0.0.1-alpha.30

package/dist/db-content-api/temp-utilities/pagination.js

@@ -0,0 +1,45 @@
+// Convert Content API pagination response to Payload's expected format
+// Content API already calculates next/prev pages, we just need to transform the structure
+//
+// Content API format (nested):
+// {
+//   data: [...],
+//   pagination: {
+//     total: 100,
+//     current: { limit: 10, page: 2 },
+//     next: { limit: 10, page: 3 },
+//     prev: { limit: 10, page: 1 }
+//   }
+// }
+//
+// Payload format (flat):
+// {
+//   docs: [...],
+//   hasNextPage: true,
+//   hasPrevPage: true,
+//   limit: 10,
+//   nextPage: 3,
+//   page: 2,
+//   pagingCounter: 11,
+//   prevPage: 1,
+//   totalDocs: 100,
+//   totalPages: 10
+// }
+export const getPaginationData = (contentAPIPagination, pagination)=>{
+    const { current, next, prev, total } = contentAPIPagination;
+    const hasNextPage = pagination !== false && next !== undefined;
+    const hasPrevPage = pagination !== false && prev !== undefined;
+    return {
+        hasNextPage,
+        hasPrevPage,
+        limit: current.limit,
+        nextPage: next?.page ?? null,
+        page: current.page,
+        pagingCounter: (current.page - 1) * current.limit + 1,
+        prevPage: prev?.page ?? null,
+        totalDocs: total,
+        totalPages: current.limit > 0 ? Math.ceil(total / current.limit) : 1
+    };
+};
+
+//# sourceMappingURL=pagination.js.map

package/dist/db-content-api/temp-utilities/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/db-content-api/temp-utilities/pagination.ts"],"sourcesContent":["import type { components } from '../generated/content-api-types.js'\n\n// Convert Content API pagination response to Payload's expected format\n// Content API already calculates next/prev pages, we just need to transform the structure\n//\n// Content API format (nested):\n// {\n//   data: [...],\n//   pagination: {\n//     total: 100,\n//     current: { limit: 10, page: 2 },\n//     next: { limit: 10, page: 3 },\n//     prev: { limit: 10, page: 1 }\n//   }\n// }\n//\n// Payload format (flat):\n// {\n//   docs: [...],\n//   hasNextPage: true,\n//   hasPrevPage: true,\n//   limit: 10,\n//   nextPage: 3,\n//   page: 2,\n//   pagingCounter: 11,\n//   prevPage: 1,\n//   totalDocs: 100,\n//   totalPages: 10\n// }\nexport const getPaginationData = (\n  contentAPIPagination: components['schemas']['Pagination'],\n  pagination?: boolean,\n) => {\n  const { current, next, prev, total } = contentAPIPagination\n  const hasNextPage = pagination !== false && next !== undefined\n  const hasPrevPage = pagination !== false && prev !== undefined\n\n  return {\n    hasNextPage,\n    hasPrevPage,\n    limit: current.limit,\n    nextPage: next?.page ?? null,\n    page: current.page,\n    pagingCounter: (current.page - 1) * current.limit + 1,\n    prevPage: prev?.page ?? null,\n    totalDocs: total,\n    totalPages: current.limit > 0 ? Math.ceil(total / current.limit) : 1,\n  }\n}\n"],"names":["getPaginationData","contentAPIPagination","pagination","current","next","prev","total","hasNextPage","undefined","hasPrevPage","limit","nextPage","page","pagingCounter","prevPage","totalDocs","totalPages","Math","ceil"],"mappings":"AAEA,uEAAuE;AACvE,0FAA0F;AAC1F,EAAE;AACF,+BAA+B;AAC/B,IAAI;AACJ,iBAAiB;AACjB,kBAAkB;AAClB,kBAAkB;AAClB,uCAAuC;AACvC,oCAAoC;AACpC,mCAAmC;AACnC,MAAM;AACN,IAAI;AACJ,EAAE;AACF,yBAAyB;AACzB,IAAI;AACJ,iBAAiB;AACjB,uBAAuB;AACvB,uBAAuB;AACvB,eAAe;AACf,iBAAiB;AACjB,aAAa;AACb,uBAAuB;AACvB,iBAAiB;AACjB,oBAAoB;AACpB,mBAAmB;AACnB,IAAI;AACJ,OAAO,MAAMA,oBAAoB,CAC/BC,sBACAC;IAEA,MAAM,EAAEC,OAAO,EAAEC,IAAI,EAAEC,IAAI,EAAEC,KAAK,EAAE,GAAGL;IACvC,MAAMM,cAAcL,eAAe,SAASE,SAASI;IACrD,MAAMC,cAAcP,eAAe,SAASG,SAASG;IAErD,OAAO;QACLD;QACAE;QACAC,OAAOP,QAAQO,KAAK;QACpBC,UAAUP,MAAMQ,QAAQ;QACxBA,MAAMT,QAAQS,IAAI;QAClBC,eAAe,AAACV,CAAAA,QAAQS,IAAI,GAAG,CAAA,IAAKT,QAAQO,KAAK,GAAG;QACpDI,UAAUT,MAAMO,QAAQ;QACxBG,WAAWT;QACXU,YAAYb,QAAQO,KAAK,GAAG,IAAIO,KAAKC,IAAI,CAACZ,QAAQH,QAAQO,KAAK,IAAI;IACrE;AACF,EAAC"}

package/dist/db-content-api/temp-utilities/slug.d.ts

@@ -0,0 +1,2 @@
+export declare const getGlobalSlug: (slug: string) => string;
+//# sourceMappingURL=slug.d.ts.map

package/dist/db-content-api/temp-utilities/slug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug.d.ts","sourceRoot":"","sources":["../../../src/db-content-api/temp-utilities/slug.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,SAAU,MAAM,WAAsB,CAAA"}

package/dist/db-content-api/temp-utilities/slug.js

@@ -0,0 +1,3 @@
+export const getGlobalSlug = (slug)=>`_global-${slug}`;
+
+//# sourceMappingURL=slug.js.map

package/dist/db-content-api/temp-utilities/slug.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/db-content-api/temp-utilities/slug.ts"],"sourcesContent":["export const getGlobalSlug = (slug: string) => `_global-${slug}`\n"],"names":["getGlobalSlug","slug"],"mappings":"AAAA,OAAO,MAAMA,gBAAgB,CAACC,OAAiB,CAAC,QAAQ,EAAEA,MAAM,CAAA"}

package/dist/db-content-api/temp-utilities/sorting.d.ts

@@ -0,0 +1,7 @@
+import type { CollectionConfig } from 'payload';
+export declare function addFallbackSort(sort: string | string[] | undefined, collectionConfig: CollectionConfig | undefined): string | string[] | undefined;
+export declare function convertPayloadSortToContentAPI(sort: string | string[] | undefined): Array<{
+    direction: 'asc' | 'desc';
+    path: string;
+}> | undefined;
+//# sourceMappingURL=sorting.d.ts.map

package/dist/db-content-api/temp-utilities/sorting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sorting.d.ts","sourceRoot":"","sources":["../../../src/db-content-api/temp-utilities/sorting.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAK/C,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,EACnC,gBAAgB,EAAE,gBAAgB,GAAG,SAAS,GAC7C,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CA4B/B;AAcD,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,GAClC,KAAK,CAAC;IAAE,SAAS,EAAE,KAAK,GAAG,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,SAAS,CA2BhE"}

package/dist/db-content-api/temp-utilities/sorting.js

@@ -0,0 +1,71 @@
+// Add fallback sort to ensure consistent ordering when sorting by non-unique fields
+// Matches MongoDB adapter behavior
+// TO-DECIDE: Should this live here or in content-api?
+export function addFallbackSort(sort, collectionConfig) {
+    if (!sort || !collectionConfig) {
+        return sort;
+    }
+    const sortArray = Array.isArray(sort) ? sort : [
+        sort
+    ];
+    // Determine fallback sort field
+    let fallbackSort = '-id';
+    if (collectionConfig.timestamps !== false) {
+        fallbackSort = '-createdAt';
+    }
+    // Check if fallback sort is already included
+    const hasFallback = sortArray.some((item)=>item === fallbackSort || item === fallbackSort.replace('-', ''));
+    if (hasFallback) {
+        return sort;
+    }
+    // Check if all sort fields are unique (then no fallback needed)
+    // For simplicity, we'll always add fallback - checking uniqueness requires field traversal
+    // which would be expensive. This matches the conservative approach.
+    // Add fallback sort - always return array to preserve multiple sort fields
+    return [
+        ...sortArray,
+        fallbackSort
+    ];
+}
+// ⚠️ TEMPORARY WORKAROUND - Remove once Content API is fixed
+//
+// TODO: Content API should accept Payload's native Sort format instead of requiring conversion.
+// This converter exists because Content API expects a different format.
+//
+// Payload's format: "-createdAt" or ["createdAt", "-updatedAt"]
+// Content API expects: [{ path: "createdAt", direction: "dsc" }]
+//
+// Once Content API accepts Payload's format:
+// 1. Remove this function entirely
+// 2. Remove all calls to convertPayloadSortToContentAPI()
+// 3. Pass `sort` directly to Content API endpoints
+export function convertPayloadSortToContentAPI(sort) {
+    if (!sort) {
+        return undefined;
+    }
+    const sortArray = Array.isArray(sort) ? sort : [
+        sort
+    ];
+    return sortArray.map((field)=>{
+        let path = field;
+        let direction = 'asc';
+        // Check if field starts with '-' for descending
+        if (field.startsWith('-')) {
+            path = field.substring(1); // Remove the '-'
+            direction = 'desc';
+        }
+        // ⚠️ WORKAROUND: Strip "version." prefix from field names
+        // Payload sends "-version.createdAt" for version sort fields
+        // but Content API expects just "createdAt"
+        // TODO: Content API should handle version field paths correctly
+        if (path.startsWith('version.')) {
+            path = path.substring(8); // Remove "version." prefix
+        }
+        return {
+            direction,
+            path
+        };
+    });
+}
+
+//# sourceMappingURL=sorting.js.map

package/dist/db-content-api/temp-utilities/sorting.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/db-content-api/temp-utilities/sorting.ts"],"sourcesContent":["import type { CollectionConfig } from 'payload'\n\n// Add fallback sort to ensure consistent ordering when sorting by non-unique fields\n// Matches MongoDB adapter behavior\n// TO-DECIDE: Should this live here or in content-api?\nexport function addFallbackSort(\n  sort: string | string[] | undefined,\n  collectionConfig: CollectionConfig | undefined,\n): string | string[] | undefined {\n  if (!sort || !collectionConfig) {\n    return sort\n  }\n\n  const sortArray = Array.isArray(sort) ? sort : [sort]\n\n  // Determine fallback sort field\n  let fallbackSort = '-id'\n  if (collectionConfig.timestamps !== false) {\n    fallbackSort = '-createdAt'\n  }\n\n  // Check if fallback sort is already included\n  const hasFallback = sortArray.some(\n    (item) => item === fallbackSort || item === fallbackSort.replace('-', ''),\n  )\n\n  if (hasFallback) {\n    return sort\n  }\n\n  // Check if all sort fields are unique (then no fallback needed)\n  // For simplicity, we'll always add fallback - checking uniqueness requires field traversal\n  // which would be expensive. This matches the conservative approach.\n\n  // Add fallback sort - always return array to preserve multiple sort fields\n  return [...sortArray, fallbackSort]\n}\n\n// ⚠️ TEMPORARY WORKAROUND - Remove once Content API is fixed\n//\n// TODO: Content API should accept Payload's native Sort format instead of requiring conversion.\n// This converter exists because Content API expects a different format.\n//\n// Payload's format: \"-createdAt\" or [\"createdAt\", \"-updatedAt\"]\n// Content API expects: [{ path: \"createdAt\", direction: \"dsc\" }]\n//\n// Once Content API accepts Payload's format:\n// 1. Remove this function entirely\n// 2. Remove all calls to convertPayloadSortToContentAPI()\n// 3. Pass `sort` directly to Content API endpoints\nexport function convertPayloadSortToContentAPI(\n  sort: string | string[] | undefined,\n): Array<{ direction: 'asc' | 'desc'; path: string }> | undefined {\n  if (!sort) {\n    return undefined\n  }\n\n  const sortArray = Array.isArray(sort) ? sort : [sort]\n\n  return sortArray.map((field) => {\n    let path = field\n    let direction: 'asc' | 'desc' = 'asc'\n\n    // Check if field starts with '-' for descending\n    if (field.startsWith('-')) {\n      path = field.substring(1) // Remove the '-'\n      direction = 'desc'\n    }\n\n    // ⚠️ WORKAROUND: Strip \"version.\" prefix from field names\n    // Payload sends \"-version.createdAt\" for version sort fields\n    // but Content API expects just \"createdAt\"\n    // TODO: Content API should handle version field paths correctly\n    if (path.startsWith('version.')) {\n      path = path.substring(8) // Remove \"version.\" prefix\n    }\n\n    return { direction, path }\n  })\n}\n"],"names":["addFallbackSort","sort","collectionConfig","sortArray","Array","isArray","fallbackSort","timestamps","hasFallback","some","item","replace","convertPayloadSortToContentAPI","undefined","map","field","path","direction","startsWith","substring"],"mappings":"AAEA,oFAAoF;AACpF,mCAAmC;AACnC,sDAAsD;AACtD,OAAO,SAASA,gBACdC,IAAmC,EACnCC,gBAA8C;IAE9C,IAAI,CAACD,QAAQ,CAACC,kBAAkB;QAC9B,OAAOD;IACT;IAEA,MAAME,YAAYC,MAAMC,OAAO,CAACJ,QAAQA,OAAO;QAACA;KAAK;IAErD,gCAAgC;IAChC,IAAIK,eAAe;IACnB,IAAIJ,iBAAiBK,UAAU,KAAK,OAAO;QACzCD,eAAe;IACjB;IAEA,6CAA6C;IAC7C,MAAME,cAAcL,UAAUM,IAAI,CAChC,CAACC,OAASA,SAASJ,gBAAgBI,SAASJ,aAAaK,OAAO,CAAC,KAAK;IAGxE,IAAIH,aAAa;QACf,OAAOP;IACT;IAEA,gEAAgE;IAChE,2FAA2F;IAC3F,oEAAoE;IAEpE,2EAA2E;IAC3E,OAAO;WAAIE;QAAWG;KAAa;AACrC;AAEA,6DAA6D;AAC7D,EAAE;AACF,gGAAgG;AAChG,wEAAwE;AACxE,EAAE;AACF,gEAAgE;AAChE,iEAAiE;AACjE,EAAE;AACF,6CAA6C;AAC7C,mCAAmC;AACnC,0DAA0D;AAC1D,mDAAmD;AACnD,OAAO,SAASM,+BACdX,IAAmC;IAEnC,IAAI,CAACA,MAAM;QACT,OAAOY;IACT;IAEA,MAAMV,YAAYC,MAAMC,OAAO,CAACJ,QAAQA,OAAO;QAACA;KAAK;IAErD,OAAOE,UAAUW,GAAG,CAAC,CAACC;QACpB,IAAIC,OAAOD;QACX,IAAIE,YAA4B;QAEhC,gDAAgD;QAChD,IAAIF,MAAMG,UAAU,CAAC,MAAM;YACzBF,OAAOD,MAAMI,SAAS,CAAC,IAAG,iBAAiB;YAC3CF,YAAY;QACd;QAEA,0DAA0D;QAC1D,6DAA6D;QAC7D,2CAA2C;QAC3C,gEAAgE;QAChE,IAAID,KAAKE,UAAU,CAAC,aAAa;YAC/BF,OAAOA,KAAKG,SAAS,CAAC,IAAG,2BAA2B;QACtD;QAEA,OAAO;YAAEF;YAAWD;QAAK;IAC3B;AACF"}

package/dist/db-content-api/temp-utilities/unwrapDocument.d.ts

@@ -0,0 +1,4 @@
+import type { Payload } from 'payload';
+import type { components } from '../generated/content-api-types.js';
+export declare function unwrapDocument(payload: Payload, doc: components['schemas']['Document'] | components['schemas']['DocumentVersion'], collectionSlug?: string): Record<string, unknown>;
+//# sourceMappingURL=unwrapDocument.d.ts.map

package/dist/db-content-api/temp-utilities/unwrapDocument.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unwrapDocument.d.ts","sourceRoot":"","sources":["../../../src/db-content-api/temp-utilities/unwrapDocument.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAA;AAUnE,wBAAgB,cAAc,CAC5B,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC,UAAU,CAAC,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,iBAAiB,CAAC,EACjF,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA6CzB"}

package/dist/db-content-api/temp-utilities/unwrapDocument.js

@@ -0,0 +1,45 @@
+import { dataFromContentAPI } from '../utilities/data.js';
+// Helper to unwrap Content API document format to Payload format
+// Content API returns: { id, data: { ...fields }, createdAt, updatedAt }
+// Payload expects:
+//   - For documents: { id, ...fields, createdAt, updatedAt }
+//   - For versions: { id, version: { ...fields }, createdAt, updatedAt, ... }
+export function unwrapDocument(payload, doc, collectionSlug) {
+    if (!doc) {
+        return doc;
+    }
+    // Check if this is a DocumentVersion (has documentId and latest fields)
+    const isVersion = 'documentId' in doc && 'latest' in doc;
+    if (isVersion) {
+        // For versions, Payload expects nested structure with 'version' field
+        const versionDoc = doc;
+        const baseDoc = {
+            id: versionDoc.id,
+            createdAt: versionDoc.createdAt,
+            latest: versionDoc.latest,
+            updatedAt: versionDoc.updatedAt,
+            version: versionDoc.data
+        };
+        // Transform data from Content API format to Payload format
+        if (collectionSlug) {
+            // Only transform the nested 'version' field
+            baseDoc.version = dataFromContentAPI(payload, collectionSlug, baseDoc.version);
+        }
+        return baseDoc;
+    } else {
+        // For regular documents, spread data at root level
+        const baseDoc = {
+            ...doc.data,
+            id: doc.id,
+            createdAt: doc.createdAt,
+            updatedAt: doc.updatedAt
+        };
+        // Transform data from Content API format to Payload format
+        if (collectionSlug) {
+            return dataFromContentAPI(payload, collectionSlug, baseDoc);
+        }
+        return baseDoc;
+    }
+}
+
+//# sourceMappingURL=unwrapDocument.js.map

package/dist/db-content-api/temp-utilities/unwrapDocument.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/db-content-api/temp-utilities/unwrapDocument.ts"],"sourcesContent":["import type { Payload } from 'payload'\n\nimport type { components } from '../generated/content-api-types.js'\n\nimport { dataFromContentAPI } from '../utilities/data.js'\n\n// Helper to unwrap Content API document format to Payload format\n// Content API returns: { id, data: { ...fields }, createdAt, updatedAt }\n// Payload expects:\n//   - For documents: { id, ...fields, createdAt, updatedAt }\n\n//   - For versions: { id, version: { ...fields }, createdAt, updatedAt, ... }\nexport function unwrapDocument(\n  payload: Payload,\n  doc: components['schemas']['Document'] | components['schemas']['DocumentVersion'],\n  collectionSlug?: string,\n): Record<string, unknown> {\n  if (!doc) {\n    return doc as unknown as Record<string, unknown>\n  }\n\n  // Check if this is a DocumentVersion (has documentId and latest fields)\n  const isVersion = 'documentId' in doc && 'latest' in doc\n\n  if (isVersion) {\n    // For versions, Payload expects nested structure with 'version' field\n    const versionDoc = doc\n    const baseDoc = {\n      id: versionDoc.id,\n      createdAt: versionDoc.createdAt,\n      latest: versionDoc.latest,\n      updatedAt: versionDoc.updatedAt,\n      version: versionDoc.data, // Nest data inside 'version'\n    }\n\n    // Transform data from Content API format to Payload format\n    if (collectionSlug) {\n      // Only transform the nested 'version' field\n      baseDoc.version = dataFromContentAPI(payload, collectionSlug, baseDoc.version) as Record<\n        string,\n        unknown\n      >\n    }\n\n    return baseDoc as Record<string, unknown>\n  } else {\n    // For regular documents, spread data at root level\n    const baseDoc = {\n      ...doc.data, // Spread the actual document fields\n      id: doc.id,\n      createdAt: doc.createdAt,\n      updatedAt: doc.updatedAt,\n    }\n\n    // Transform data from Content API format to Payload format\n    if (collectionSlug) {\n      return dataFromContentAPI(payload, collectionSlug, baseDoc) as Record<string, unknown>\n    }\n\n    return baseDoc as Record<string, unknown>\n  }\n}\n"],"names":["dataFromContentAPI","unwrapDocument","payload","doc","collectionSlug","isVersion","versionDoc","baseDoc","id","createdAt","latest","updatedAt","version","data"],"mappings":"AAIA,SAASA,kBAAkB,QAAQ,uBAAsB;AAEzD,iEAAiE;AACjE,yEAAyE;AACzE,mBAAmB;AACnB,6DAA6D;AAE7D,8EAA8E;AAC9E,OAAO,SAASC,eACdC,OAAgB,EAChBC,GAAiF,EACjFC,cAAuB;IAEvB,IAAI,CAACD,KAAK;QACR,OAAOA;IACT;IAEA,wEAAwE;IACxE,MAAME,YAAY,gBAAgBF,OAAO,YAAYA;IAErD,IAAIE,WAAW;QACb,sEAAsE;QACtE,MAAMC,aAAaH;QACnB,MAAMI,UAAU;YACdC,IAAIF,WAAWE,EAAE;YACjBC,WAAWH,WAAWG,SAAS;YAC/BC,QAAQJ,WAAWI,MAAM;YACzBC,WAAWL,WAAWK,SAAS;YAC/BC,SAASN,WAAWO,IAAI;QAC1B;QAEA,2DAA2D;QAC3D,IAAIT,gBAAgB;YAClB,4CAA4C;YAC5CG,QAAQK,OAAO,GAAGZ,mBAAmBE,SAASE,gBAAgBG,QAAQK,OAAO;QAI/E;QAEA,OAAOL;IACT,OAAO;QACL,mDAAmD;QACnD,MAAMA,UAAU;YACd,GAAGJ,IAAIU,IAAI;YACXL,IAAIL,IAAIK,EAAE;YACVC,WAAWN,IAAIM,SAAS;YACxBE,WAAWR,IAAIQ,SAAS;QAC1B;QAEA,2DAA2D;QAC3D,IAAIP,gBAAgB;YAClB,OAAOJ,mBAAmBE,SAASE,gBAAgBG;QACrD;QAEA,OAAOA;IACT;AACF"}

package/dist/db-content-api/utilities/auth.d.ts

@@ -0,0 +1,30 @@
+import type { Middleware } from 'openapi-fetch';
+import type { Payload } from 'payload';
+import type { TokenStore } from '../../auth/token-store.js';
+type ApiKeyAuth = {
+    apiKey: string;
+    mode: 'apiKey';
+};
+type TokenStoreAuth = {
+    mode: 'tokenStore';
+    tokenStore: TokenStore;
+};
+type DevJwtAuth = {
+    mode: 'devJwt';
+};
+export type AuthMode = ApiKeyAuth | DevJwtAuth | TokenStoreAuth;
+export declare function fetchDevJwt(url: string, contentSystemId: string): Promise<string>;
+export declare function createAuthMiddleware(opts: {
+    auth: AuthMode;
+    contentSystemId: string;
+    logger: Payload['logger'];
+    url: string;
+}): Middleware;
+export declare function createErrorMiddleware(opts: {
+    auth: AuthMode;
+    contentSystemId: string;
+    logger: Payload['logger'];
+    url: string;
+}): Middleware;
+export {};
+//# sourceMappingURL=auth.d.ts.map

package/dist/db-content-api/utilities/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/db-content-api/utilities/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAK3D,KAAK,UAAU,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAA;AACpD,KAAK,cAAc,GAAG;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,UAAU,EAAE,UAAU,CAAA;CAAE,CAAA;AACpE,KAAK,UAAU,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAA;AACpC,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,cAAc,CAAA;AAK/D,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBvF;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,IAAI,EAAE,QAAQ,CAAA;IACd,eAAe,EAAE,MAAM,CAAA;IACvB,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAA;IACzB,GAAG,EAAE,MAAM,CAAA;CACZ,GAAG,UAAU,CAyBb;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,IAAI,EAAE,QAAQ,CAAA;IACd,eAAe,EAAE,MAAM,CAAA;IACvB,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAA;IACzB,GAAG,EAAE,MAAM,CAAA;CACZ,GAAG,UAAU,CAqCb"}

package/dist/db-content-api/utilities/auth.js

@@ -0,0 +1,81 @@
+import { getValidProjectToken } from '../../auth/project-token.js';
+// Module-level cache for dev JWT tokens
+const devJwtCache = new Map();
+export async function fetchDevJwt(url, contentSystemId) {
+    const usesSuperUser = !contentSystemId || contentSystemId === 'test-system' || contentSystemId === '*';
+    const contentSystemIdForJWT = usesSuperUser ? '*' : contentSystemId;
+    const response = await fetch(`${url}/dev/jwt`, {
+        body: JSON.stringify({
+            content_system_id: contentSystemIdForJWT
+        }),
+        headers: {
+            'Content-Type': 'application/json'
+        },
+        method: 'POST'
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to get dev JWT: ${response.status} ${response.statusText}`);
+    }
+    const { token } = await response.json();
+    return token;
+}
+export function createAuthMiddleware(opts) {
+    return {
+        async onRequest ({ request }) {
+            if (opts.auth.mode === 'apiKey') {
+                request.headers.set('X-Api-Key', opts.auth.apiKey);
+            } else if (opts.auth.mode === 'tokenStore') {
+                const token = await getValidProjectToken(opts.auth.tokenStore, opts.contentSystemId);
+                if (!token) {
+                    throw new Error('Authentication required. Run `npx @payloadcms/figma login` to authenticate.');
+                }
+                request.headers.set('Authorization', `Bearer ${token}`);
+            } else {
+                let token = devJwtCache.get(opts.contentSystemId);
+                if (!token) {
+                    token = await fetchDevJwt(opts.url, opts.contentSystemId);
+                    devJwtCache.set(opts.contentSystemId, token);
+                    opts.logger.info(`Dev JWT acquired for content system: ${opts.contentSystemId}`);
+                }
+                request.headers.set('Authorization', `Bearer ${token}`);
+            }
+            return request;
+        }
+    };
+}
+export function createErrorMiddleware(opts) {
+    return {
+        async onResponse ({ request, response }) {
+            if (!response.ok) {
+                // Handle 401 retry for dev JWT
+                if (response.status === 401 && opts.auth.mode === 'devJwt') {
+                    const retryCount = parseInt(request.headers.get('X-Retry-Count') || '0', 10);
+                    if (retryCount < 1) {
+                        opts.logger.info('Dev JWT expired, refreshing...');
+                        devJwtCache.delete(opts.contentSystemId);
+                        const newToken = await fetchDevJwt(opts.url, opts.contentSystemId);
+                        devJwtCache.set(opts.contentSystemId, newToken);
+                        // duplex: 'half' is required for Node.js fetch with streaming body
+                        const newRequest = new Request(request.url, {
+                            body: request.body,
+                            duplex: 'half',
+                            headers: new Headers(request.headers),
+                            method: request.method
+                        });
+                        newRequest.headers.set('X-Retry-Count', '1');
+                        newRequest.headers.set('Authorization', `Bearer ${newToken}`);
+                        return fetch(newRequest);
+                    }
+                }
+                const text = await response.clone().text();
+                opts.logger.error({
+                    msg: `HTTP ${response.status} from ${request.url}`,
+                    response: text
+                });
+            }
+            return response;
+        }
+    };
+}
+
+//# sourceMappingURL=auth.js.map

package/dist/db-content-api/utilities/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/db-content-api/utilities/auth.ts"],"sourcesContent":["import type { Middleware } from 'openapi-fetch'\nimport type { Payload } from 'payload'\n\nimport type { TokenStore } from '../../auth/token-store.js'\n\nimport { getValidProjectToken } from '../../auth/project-token.js'\n\n// Auth mode types\ntype ApiKeyAuth = { apiKey: string; mode: 'apiKey' }\ntype TokenStoreAuth = { mode: 'tokenStore'; tokenStore: TokenStore }\ntype DevJwtAuth = { mode: 'devJwt' }\nexport type AuthMode = ApiKeyAuth | DevJwtAuth | TokenStoreAuth\n\n// Module-level cache for dev JWT tokens\nconst devJwtCache = new Map<string, string>()\n\nexport async function fetchDevJwt(url: string, contentSystemId: string): Promise<string> {\n  const usesSuperUser =\n    !contentSystemId || contentSystemId === 'test-system' || contentSystemId === '*'\n  const contentSystemIdForJWT = usesSuperUser ? '*' : contentSystemId\n\n  const response = await fetch(`${url}/dev/jwt`, {\n    body: JSON.stringify({ content_system_id: contentSystemIdForJWT }),\n    headers: { 'Content-Type': 'application/json' },\n    method: 'POST',\n  })\n\n  if (!response.ok) {\n    throw new Error(`Failed to get dev JWT: ${response.status} ${response.statusText}`)\n  }\n\n  const { token } = await response.json()\n  return token\n}\n\nexport function createAuthMiddleware(opts: {\n  auth: AuthMode\n  contentSystemId: string\n  logger: Payload['logger']\n  url: string\n}): Middleware {\n  return {\n    async onRequest({ request }) {\n      if (opts.auth.mode === 'apiKey') {\n        request.headers.set('X-Api-Key', opts.auth.apiKey)\n      } else if (opts.auth.mode === 'tokenStore') {\n        const token = await getValidProjectToken(opts.auth.tokenStore, opts.contentSystemId)\n        if (!token) {\n          throw new Error(\n            'Authentication required. Run `npx @payloadcms/figma login` to authenticate.',\n          )\n        }\n        request.headers.set('Authorization', `Bearer ${token}`)\n      } else {\n        let token = devJwtCache.get(opts.contentSystemId)\n        if (!token) {\n          token = await fetchDevJwt(opts.url, opts.contentSystemId)\n          devJwtCache.set(opts.contentSystemId, token)\n          opts.logger.info(`Dev JWT acquired for content system: ${opts.contentSystemId}`)\n        }\n        request.headers.set('Authorization', `Bearer ${token}`)\n      }\n      return request\n    },\n  }\n}\n\nexport function createErrorMiddleware(opts: {\n  auth: AuthMode\n  contentSystemId: string\n  logger: Payload['logger']\n  url: string\n}): Middleware {\n  return {\n    async onResponse({ request, response }) {\n      if (!response.ok) {\n        // Handle 401 retry for dev JWT\n        if (response.status === 401 && opts.auth.mode === 'devJwt') {\n          const retryCount = parseInt(request.headers.get('X-Retry-Count') || '0', 10)\n          if (retryCount < 1) {\n            opts.logger.info('Dev JWT expired, refreshing...')\n            devJwtCache.delete(opts.contentSystemId)\n\n            const newToken = await fetchDevJwt(opts.url, opts.contentSystemId)\n            devJwtCache.set(opts.contentSystemId, newToken)\n\n            // duplex: 'half' is required for Node.js fetch with streaming body\n            const newRequest = new Request(request.url, {\n              body: request.body,\n              duplex: 'half',\n              headers: new Headers(request.headers),\n              method: request.method,\n            } as RequestInit)\n            newRequest.headers.set('X-Retry-Count', '1')\n            newRequest.headers.set('Authorization', `Bearer ${newToken}`)\n\n            return fetch(newRequest)\n          }\n        }\n\n        const text = await response.clone().text()\n        opts.logger.error({\n          msg: `HTTP ${response.status} from ${request.url}`,\n          response: text,\n        })\n      }\n      return response\n    },\n  }\n}\n"],"names":["getValidProjectToken","devJwtCache","Map","fetchDevJwt","url","contentSystemId","usesSuperUser","contentSystemIdForJWT","response","fetch","body","JSON","stringify","content_system_id","headers","method","ok","Error","status","statusText","token","json","createAuthMiddleware","opts","onRequest","request","auth","mode","set","apiKey","tokenStore","get","logger","info","createErrorMiddleware","onResponse","retryCount","parseInt","delete","newToken","newRequest","Request","duplex","Headers","text","clone","error","msg"],"mappings":"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"}

package/dist/db-content-api/utilities/data.d.ts

@@ -0,0 +1,24 @@
+import type { Payload } from 'payload';
+import type { components } from '../generated/content-api-types.js';
+type DataWithOperations = components['schemas']['DataWithOperations'];
+/**
+ * Transform data before sending to Content API (WRITE operations)
+ *
+ * Conversions applied:
+ * - RichText fields: Objects -> JSON strings
+ *
+ * Note: Date fields are automatically converted to ISO strings by JSON.stringify()
+ */
+export declare function dataToContentAPI(payload: Payload, collectionSlug: string, data: unknown): DataWithOperations;
+/**
+ * Transform data received from Content API (READ operations)
+ *
+ * Conversions applied:
+ * - RichText fields: JSON strings -> Objects
+ *
+ * Note: Date fields come as ISO strings from Content API and stay as strings
+ * (matching MongoDB and other adapters' behavior)
+ */
+export declare function dataFromContentAPI(payload: Payload, collectionSlug: string, data: unknown): unknown;
+export {};
+//# sourceMappingURL=data.d.ts.map

package/dist/db-content-api/utilities/data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../../../src/db-content-api/utilities/data.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkC,OAAO,EAA0B,MAAM,SAAS,CAAA;AAI9F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAA;AAEnE,KAAK,kBAAkB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,oBAAoB,CAAC,CAAA;AAErE;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,OAAO,EAChB,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,OAAO,GACZ,kBAAkB,CA2CpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,OAAO,EAChB,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,OAAO,GACZ,OAAO,CAgET"}

package/dist/db-content-api/utilities/data.js

@@ -0,0 +1,118 @@
+import { traverseFields } from 'payload';
+/**
+ * Transform data before sending to Content API (WRITE operations)
+ *
+ * Conversions applied:
+ * - RichText fields: Objects -> JSON strings
+ *
+ * Note: Date fields are automatically converted to ISO strings by JSON.stringify()
+ */ export function dataToContentAPI(payload, collectionSlug, data) {
+    if (!data || typeof data !== 'object') {
+        return data;
+    }
+    // Deep clone to avoid mutating original data
+    const transformed = JSON.parse(JSON.stringify(data));
+    // Get collection config
+    const isGlobal = collectionSlug.startsWith('_global-');
+    const actualSlug = isGlobal ? collectionSlug.substring(8) : collectionSlug;
+    const collectionConfig = isGlobal ? payload.config.globals?.find((g)=>g.slug === actualSlug) : payload.config.collections.find((c)=>c.slug === actualSlug);
+    if (!collectionConfig?.fields) {
+        return transformed;
+    }
+    // Use Payload's traverseFields to iterate over all fields
+    const callback = ({ field, ref })=>{
+        if (!('name' in field) || !field.name) {
+            return;
+        }
+        if (!ref || typeof ref !== 'object') {
+            return;
+        }
+        const current = ref;
+        const value = current[field.name];
+        if (value !== null && value !== undefined) {
+            // RichText: object -> JSON string
+            if (field.type === 'richText' && typeof value !== 'string') {
+                current[field.name] = JSON.stringify(value);
+            }
+        // Date fields are already handled by JSON.stringify() which converts Date -> ISO string
+        }
+    };
+    traverseFields({
+        callback,
+        fields: collectionConfig.fields,
+        ref: transformed
+    });
+    return transformed;
+}
+/**
+ * Transform data received from Content API (READ operations)
+ *
+ * Conversions applied:
+ * - RichText fields: JSON strings -> Objects
+ *
+ * Note: Date fields come as ISO strings from Content API and stay as strings
+ * (matching MongoDB and other adapters' behavior)
+ */ export function dataFromContentAPI(payload, collectionSlug, data) {
+    if (!data || typeof data !== 'object') {
+        return data;
+    }
+    // Deep clone to avoid mutating original data
+    const transformed = JSON.parse(JSON.stringify(data));
+    // Get collection config
+    const isGlobal = collectionSlug.startsWith('_global-');
+    const actualSlug = isGlobal ? collectionSlug.substring(8) : collectionSlug;
+    const collectionConfig = isGlobal ? payload.config.globals?.find((g)=>g.slug === actualSlug) : payload.config.collections.find((c)=>c.slug === actualSlug);
+    if (!collectionConfig?.fields) {
+        return transformed;
+    }
+    // Use Payload's traverseFields to iterate over all fields
+    const callback = ({ field, parentPath, ref })=>{
+        if (!('name' in field) || !field.name) {
+            return;
+        }
+        if (!ref || typeof ref !== 'object') {
+            return;
+        }
+        const current = ref;
+        const value = current[field.name];
+        if (value !== null && value !== undefined) {
+            // RichText: JSON string -> object
+            if (field.type === 'richText' && typeof value === 'string') {
+                try {
+                    current[field.name] = JSON.parse(value);
+                } catch (error) {
+                    const fieldPath = parentPath ? `${parentPath}.${field.name}` : field.name;
+                    payload.logger.warn({
+                        err: error instanceof Error ? error : new Error(String(error)),
+                        msg: `Failed to parse richtext field '${fieldPath}' in collection '${collectionSlug}'`
+                    });
+                }
+            }
+        // Date fields: Already ISO strings from Content API, no conversion needed
+        }
+    };
+    traverseFields({
+        callback,
+        fields: collectionConfig.fields,
+        ref: transformed
+    });
+    // Handle auth-specific fields that aren't in the field schema
+    // When these fields are null in DB, Content API omits them from response (undefined)
+    // But Payload expects them to be null, not undefined
+    // Only add them if the collection has auth enabled
+    if ('auth' in collectionConfig && collectionConfig.auth) {
+        const authFields = [
+            'resetPasswordExpiration',
+            'lockUntil'
+        ];
+        for (const fieldName of authFields){
+            if (!(fieldName in transformed)) {
+                ;
+                transformed[fieldName] = null;
+            }
+        }
+    }
+    return transformed;
+}
+
+//# sourceMappingURL=data.js.map

package/dist/db-content-api/utilities/data.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/db-content-api/utilities/data.ts"],"sourcesContent":["import type { CollectionConfig, GlobalConfig, Payload, TraverseFieldsCallback } from 'payload'\n\nimport { traverseFields } from 'payload'\n\nimport type { components } from '../generated/content-api-types.js'\n\ntype DataWithOperations = components['schemas']['DataWithOperations']\n\n/**\n * Transform data before sending to Content API (WRITE operations)\n *\n * Conversions applied:\n * - RichText fields: Objects -> JSON strings\n *\n * Note: Date fields are automatically converted to ISO strings by JSON.stringify()\n */\nexport function dataToContentAPI(\n  payload: Payload,\n  collectionSlug: string,\n  data: unknown,\n): DataWithOperations {\n  if (!data || typeof data !== 'object') {\n    return data as DataWithOperations\n  }\n\n  // Deep clone to avoid mutating original data\n  const transformed = JSON.parse(JSON.stringify(data))\n\n  // Get collection config\n  const isGlobal = collectionSlug.startsWith('_global-')\n  const actualSlug = isGlobal ? collectionSlug.substring(8) : collectionSlug\n  const collectionConfig: CollectionConfig | GlobalConfig | undefined = isGlobal\n    ? payload.config.globals?.find((g) => g.slug === actualSlug)\n    : payload.config.collections.find((c) => c.slug === actualSlug)\n\n  if (!collectionConfig?.fields) {\n    return transformed as DataWithOperations\n  }\n\n  // Use Payload's traverseFields to iterate over all fields\n  const callback: TraverseFieldsCallback = ({ field, ref }) => {\n    if (!('name' in field) || !field.name) {\n      return\n    }\n    if (!ref || typeof ref !== 'object') {\n      return\n    }\n\n    const current = ref as Record<string, unknown>\n    const value = current[field.name]\n\n    if (value !== null && value !== undefined) {\n      // RichText: object -> JSON string\n      if (field.type === 'richText' && typeof value !== 'string') {\n        current[field.name] = JSON.stringify(value)\n      }\n      // Date fields are already handled by JSON.stringify() which converts Date -> ISO string\n    }\n  }\n\n  traverseFields({ callback, fields: collectionConfig.fields, ref: transformed })\n\n  return transformed as DataWithOperations\n}\n\n/**\n * Transform data received from Content API (READ operations)\n *\n * Conversions applied:\n * - RichText fields: JSON strings -> Objects\n *\n * Note: Date fields come as ISO strings from Content API and stay as strings\n * (matching MongoDB and other adapters' behavior)\n */\nexport function dataFromContentAPI(\n  payload: Payload,\n  collectionSlug: string,\n  data: unknown,\n): unknown {\n  if (!data || typeof data !== 'object') {\n    return data\n  }\n\n  // Deep clone to avoid mutating original data\n  const transformed = JSON.parse(JSON.stringify(data))\n\n  // Get collection config\n  const isGlobal = collectionSlug.startsWith('_global-')\n  const actualSlug = isGlobal ? collectionSlug.substring(8) : collectionSlug\n  const collectionConfig: CollectionConfig | GlobalConfig | undefined = isGlobal\n    ? payload.config.globals?.find((g) => g.slug === actualSlug)\n    : payload.config.collections.find((c) => c.slug === actualSlug)\n\n  if (!collectionConfig?.fields) {\n    return transformed\n  }\n\n  // Use Payload's traverseFields to iterate over all fields\n  const callback: TraverseFieldsCallback = ({ field, parentPath, ref }) => {\n    if (!('name' in field) || !field.name) {\n      return\n    }\n    if (!ref || typeof ref !== 'object') {\n      return\n    }\n\n    const current = ref as Record<string, unknown>\n    const value = current[field.name]\n\n    if (value !== null && value !== undefined) {\n      // RichText: JSON string -> object\n      if (field.type === 'richText' && typeof value === 'string') {\n        try {\n          current[field.name] = JSON.parse(value)\n        } catch (error) {\n          const fieldPath = parentPath ? `${parentPath}.${field.name}` : field.name\n          payload.logger.warn({\n            err: error instanceof Error ? error : new Error(String(error)),\n            msg: `Failed to parse richtext field '${fieldPath}' in collection '${collectionSlug}'`,\n          })\n        }\n      }\n      // Date fields: Already ISO strings from Content API, no conversion needed\n    }\n  }\n\n  traverseFields({ callback, fields: collectionConfig.fields, ref: transformed })\n\n  // Handle auth-specific fields that aren't in the field schema\n  // When these fields are null in DB, Content API omits them from response (undefined)\n  // But Payload expects them to be null, not undefined\n  // Only add them if the collection has auth enabled\n  if ('auth' in collectionConfig && collectionConfig.auth) {\n    const authFields = ['resetPasswordExpiration', 'lockUntil']\n    for (const fieldName of authFields) {\n      if (!(fieldName in (transformed as Record<string, unknown>))) {\n        ;(transformed as Record<string, unknown>)[fieldName] = null\n      }\n    }\n  }\n\n  return transformed\n}\n"],"names":["traverseFields","dataToContentAPI","payload","collectionSlug","data","transformed","JSON","parse","stringify","isGlobal","startsWith","actualSlug","substring","collectionConfig","config","globals","find","g","slug","collections","c","fields","callback","field","ref","name","current","value","undefined","type","dataFromContentAPI","parentPath","error","fieldPath","logger","warn","err","Error","String","msg","auth","authFields","fieldName"],"mappings":"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"}

package/dist/db-content-api/utilities/joins.d.ts

@@ -0,0 +1,55 @@
+import type { JoinQuery, Payload, SanitizedCollectionConfig } from 'payload';
+import type { components } from '../generated/content-api-types.js';
+type ContentAPIJoin = components['schemas']['JoinClause'][number];
+/**
+ * Convert Payload's JoinQuery to Content API's join format.
+ *
+ * ## Content API Join Limitations
+ *
+ * The following Payload join features are NOT YET supported by Content API:
+ *
+ * 1. **hasMany relationships** - Content API's join uses `data#>'{path}'#>>'{}'` to extract
+ *    a single ID. HasMany relationships store arrays `["id1", "id2"]` which can't match.
+ *
+ * 2. **Array field relationships** - `on: 'array.category'` expects iteration over array
+ *    elements, but Content API treats the path as a single JSONB extraction.
+ *
+ * 3. **Polymorphic relationships** - Stored as `{ relationTo, value }` objects, but
+ *    Content API expects a simple ID string.
+ *
+ * 4. **Localized relationship fields** - Locale-aware joins not implemented.
+ *
+ * Note: "Where querying through joins" (e.g., `where: { 'relatedPosts.title': { equals: 'x' } }`)
+ * is a separate Payload feature that filters documents based on joined data. This is NOT
+ * a join feature but a where clause feature, and would need separate Content API support.
+ *
+ * Payload's JoinQuery format (at runtime):
+ * {
+ *   'group.relatedPosts': {    // joinPath - where results go in the document
+ *     sort: '-title',          // Payload sort format
+ *     limit: 10,
+ *     page: 2,                 // page-based pagination
+ *     where: { ... },          // Payload where format
+ *     count: true
+ *   }
+ * }
+ *
+ * Content API's join format:
+ * [{
+ *   collectionId: 'posts',     // collection to join FROM
+ *   on: 'group.category',      // field in joined collection pointing to this doc
+ *   path: 'group.relatedPosts', // where to put results
+ *   count: false,
+ *   where: { ... },            // Content API where format
+ *   sort: [{ path, direction }], // Content API sort format
+ *   limit: 10,
+ *   offset: 10                 // offset-based pagination
+ * }]
+ *
+ * The mapping requires the collection config to resolve:
+ * - Which collection each join field refers to
+ * - What the 'on' field is for each join
+ */
+export declare function convertPayloadJoinsToContentAPI(payload: Payload, collectionConfig: SanitizedCollectionConfig, joins: false | JoinQuery | undefined): ContentAPIJoin[] | undefined;
+export {};
+//# sourceMappingURL=joins.d.ts.map

package/dist/db-content-api/utilities/joins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"joins.d.ts","sourceRoot":"","sources":["../../../src/db-content-api/utilities/joins.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAA;AAE5E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAA;AAMnE,KAAK,cAAc,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,OAAO,EAChB,gBAAgB,EAAE,yBAAyB,EAC3C,KAAK,EAAE,KAAK,GAAG,SAAS,GAAG,SAAS,GACnC,cAAc,EAAE,GAAG,SAAS,CAkF9B"}