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

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"}

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

@@ -0,0 +1,130 @@
+import { convertPayloadSortToContentAPI } from '../temp-utilities/sorting.js';
+import { convertPayloadWhereToContentAPI } from './where.js';
+/**
+ * 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 function convertPayloadJoinsToContentAPI(payload, collectionConfig, joins) {
+    // joins === false means explicitly disable all joins
+    // joins === undefined means use defaults (no custom query params)
+    if (joins === false || !joins) {
+        return undefined;
+    }
+    const result = [];
+    // Iterate through all join paths in the query
+    for (const [joinPath, joinQueryValue] of Object.entries(joins)){
+        // joinQuery === false means skip this specific join
+        if (joinQueryValue === false) {
+            continue;
+        }
+        // Normalize undefined/empty to empty object
+        const joinQuery = joinQueryValue ?? {};
+        // Find the SanitizedJoin config for this joinPath
+        // SanitizedJoins is indexed by the collection being joined FROM
+        let foundJoin;
+        // Search through all collections in the joins config
+        for (const [collectionSlug, sanitizedJoins] of Object.entries(collectionConfig.joins)){
+            for (const sanitizedJoin of sanitizedJoins){
+                if (sanitizedJoin.joinPath === joinPath) {
+                    foundJoin = {
+                        collectionSlug,
+                        on: sanitizedJoin.field.on
+                    };
+                    break;
+                }
+            }
+            if (foundJoin) {
+                break;
+            }
+        }
+        // Also check polymorphic joins
+        if (!foundJoin) {
+            for (const sanitizedJoin of collectionConfig.polymorphicJoins){
+                if (sanitizedJoin.joinPath === joinPath) {
+                    // For polymorphic joins, collection is an array - use first one
+                    const collections = sanitizedJoin.field.collection;
+                    foundJoin = {
+                        collectionSlug: Array.isArray(collections) ? collections[0] : collections,
+                        on: sanitizedJoin.field.on
+                    };
+                    break;
+                }
+            }
+        }
+        if (!foundJoin) {
+            payload.logger.warn(`Join path '${joinPath}' not found in collection config for '${collectionConfig.slug}'`);
+            continue;
+        }
+        // Convert pagination: Payload uses page, Content API JoinClause uses offset
+        let offset;
+        if (joinQuery.page && joinQuery.page > 1 && joinQuery.limit) {
+            offset = (joinQuery.page - 1) * joinQuery.limit;
+        }
+        const contentAPIJoin = {
+            collectionId: foundJoin.collectionSlug,
+            count: joinQuery.count ?? false,
+            on: foundJoin.on,
+            path: joinPath,
+            ...joinQuery.limit !== undefined && {
+                limit: joinQuery.limit
+            },
+            ...offset !== undefined && {
+                offset
+            },
+            ...joinQuery.sort && {
+                sort: convertPayloadSortToContentAPI(joinQuery.sort)
+            },
+            ...joinQuery.where && {
+                where: convertPayloadWhereToContentAPI(joinQuery.where)
+            }
+        };
+        result.push(contentAPIJoin);
+    }
+    return result.length > 0 ? result : undefined;
+}
+
+//# sourceMappingURL=joins.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/db-content-api/utilities/joins.ts"],"sourcesContent":["import type { JoinQuery, Payload, SanitizedCollectionConfig } from 'payload'\n\nimport type { components } from '../generated/content-api-types.js'\n\nimport { convertPayloadSortToContentAPI } from '../temp-utilities/sorting.js'\nimport { convertPayloadWhereToContentAPI } from './where.js'\n\n// JoinClause is an array type, so we extract the element type\ntype ContentAPIJoin = components['schemas']['JoinClause'][number]\n\n/**\n * Convert Payload's JoinQuery to Content API's join format.\n *\n * ## Content API Join Limitations\n *\n * The following Payload join features are NOT YET supported by Content API:\n *\n * 1. **hasMany relationships** - Content API's join uses `data#>'{path}'#>>'{}'` to extract\n *    a single ID. HasMany relationships store arrays `[\"id1\", \"id2\"]` which can't match.\n *\n * 2. **Array field relationships** - `on: 'array.category'` expects iteration over array\n *    elements, but Content API treats the path as a single JSONB extraction.\n *\n * 3. **Polymorphic relationships** - Stored as `{ relationTo, value }` objects, but\n *    Content API expects a simple ID string.\n *\n * 4. **Localized relationship fields** - Locale-aware joins not implemented.\n *\n * Note: \"Where querying through joins\" (e.g., `where: { 'relatedPosts.title': { equals: 'x' } }`)\n * is a separate Payload feature that filters documents based on joined data. This is NOT\n * a join feature but a where clause feature, and would need separate Content API support.\n *\n * Payload's JoinQuery format (at runtime):\n * {\n *   'group.relatedPosts': {    // joinPath - where results go in the document\n *     sort: '-title',          // Payload sort format\n *     limit: 10,\n *     page: 2,                 // page-based pagination\n *     where: { ... },          // Payload where format\n *     count: true\n *   }\n * }\n *\n * Content API's join format:\n * [{\n *   collectionId: 'posts',     // collection to join FROM\n *   on: 'group.category',      // field in joined collection pointing to this doc\n *   path: 'group.relatedPosts', // where to put results\n *   count: false,\n *   where: { ... },            // Content API where format\n *   sort: [{ path, direction }], // Content API sort format\n *   limit: 10,\n *   offset: 10                 // offset-based pagination\n * }]\n *\n * The mapping requires the collection config to resolve:\n * - Which collection each join field refers to\n * - What the 'on' field is for each join\n */\nexport function convertPayloadJoinsToContentAPI(\n  payload: Payload,\n  collectionConfig: SanitizedCollectionConfig,\n  joins: false | JoinQuery | undefined,\n): ContentAPIJoin[] | undefined {\n  // joins === false means explicitly disable all joins\n  // joins === undefined means use defaults (no custom query params)\n  if (joins === false || !joins) {\n    return undefined\n  }\n\n  const result: ContentAPIJoin[] = []\n\n  // Iterate through all join paths in the query\n  for (const [joinPath, joinQueryValue] of Object.entries(joins)) {\n    // joinQuery === false means skip this specific join\n    if (joinQueryValue === false) {\n      continue\n    }\n\n    // Normalize undefined/empty to empty object\n    const joinQuery = joinQueryValue ?? {}\n\n    // Find the SanitizedJoin config for this joinPath\n    // SanitizedJoins is indexed by the collection being joined FROM\n    let foundJoin: { collectionSlug: string; on: string } | undefined\n\n    // Search through all collections in the joins config\n    for (const [collectionSlug, sanitizedJoins] of Object.entries(collectionConfig.joins)) {\n      for (const sanitizedJoin of sanitizedJoins) {\n        if (sanitizedJoin.joinPath === joinPath) {\n          foundJoin = {\n            collectionSlug,\n            on: sanitizedJoin.field.on,\n          }\n          break\n        }\n      }\n      if (foundJoin) {\n        break\n      }\n    }\n\n    // Also check polymorphic joins\n    if (!foundJoin) {\n      for (const sanitizedJoin of collectionConfig.polymorphicJoins) {\n        if (sanitizedJoin.joinPath === joinPath) {\n          // For polymorphic joins, collection is an array - use first one\n          const collections = sanitizedJoin.field.collection\n          foundJoin = {\n            collectionSlug: Array.isArray(collections) ? collections[0] : collections,\n            on: sanitizedJoin.field.on,\n          }\n          break\n        }\n      }\n    }\n\n    if (!foundJoin) {\n      payload.logger.warn(\n        `Join path '${joinPath}' not found in collection config for '${collectionConfig.slug}'`,\n      )\n      continue\n    }\n\n    // Convert pagination: Payload uses page, Content API JoinClause uses offset\n    let offset: number | undefined\n    if (joinQuery.page && joinQuery.page > 1 && joinQuery.limit) {\n      offset = (joinQuery.page - 1) * joinQuery.limit\n    }\n\n    const contentAPIJoin: ContentAPIJoin = {\n      collectionId: foundJoin.collectionSlug,\n      count: joinQuery.count ?? false,\n      on: foundJoin.on,\n      path: joinPath,\n      ...(joinQuery.limit !== undefined && { limit: joinQuery.limit }),\n      ...(offset !== undefined && { offset }),\n      ...(joinQuery.sort && { sort: convertPayloadSortToContentAPI(joinQuery.sort) }),\n      ...(joinQuery.where && { where: convertPayloadWhereToContentAPI(joinQuery.where) }),\n    }\n\n    result.push(contentAPIJoin)\n  }\n\n  return result.length > 0 ? result : undefined\n}\n"],"names":["convertPayloadSortToContentAPI","convertPayloadWhereToContentAPI","convertPayloadJoinsToContentAPI","payload","collectionConfig","joins","undefined","result","joinPath","joinQueryValue","Object","entries","joinQuery","foundJoin","collectionSlug","sanitizedJoins","sanitizedJoin","on","field","polymorphicJoins","collections","collection","Array","isArray","logger","warn","slug","offset","page","limit","contentAPIJoin","collectionId","count","path","sort","where","push","length"],"mappings":"AAIA,SAASA,8BAA8B,QAAQ,+BAA8B;AAC7E,SAASC,+BAA+B,QAAQ,aAAY;AAK5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgDC,GACD,OAAO,SAASC,gCACdC,OAAgB,EAChBC,gBAA2C,EAC3CC,KAAoC;IAEpC,qDAAqD;IACrD,kEAAkE;IAClE,IAAIA,UAAU,SAAS,CAACA,OAAO;QAC7B,OAAOC;IACT;IAEA,MAAMC,SAA2B,EAAE;IAEnC,8CAA8C;IAC9C,KAAK,MAAM,CAACC,UAAUC,eAAe,IAAIC,OAAOC,OAAO,CAACN,OAAQ;QAC9D,oDAAoD;QACpD,IAAII,mBAAmB,OAAO;YAC5B;QACF;QAEA,4CAA4C;QAC5C,MAAMG,YAAYH,kBAAkB,CAAC;QAErC,kDAAkD;QAClD,gEAAgE;QAChE,IAAII;QAEJ,qDAAqD;QACrD,KAAK,MAAM,CAACC,gBAAgBC,eAAe,IAAIL,OAAOC,OAAO,CAACP,iBAAiBC,KAAK,EAAG;YACrF,KAAK,MAAMW,iBAAiBD,eAAgB;gBAC1C,IAAIC,cAAcR,QAAQ,KAAKA,UAAU;oBACvCK,YAAY;wBACVC;wBACAG,IAAID,cAAcE,KAAK,CAACD,EAAE;oBAC5B;oBACA;gBACF;YACF;YACA,IAAIJ,WAAW;gBACb;YACF;QACF;QAEA,+BAA+B;QAC/B,IAAI,CAACA,WAAW;YACd,KAAK,MAAMG,iBAAiBZ,iBAAiBe,gBAAgB,CAAE;gBAC7D,IAAIH,cAAcR,QAAQ,KAAKA,UAAU;oBACvC,gEAAgE;oBAChE,MAAMY,cAAcJ,cAAcE,KAAK,CAACG,UAAU;oBAClDR,YAAY;wBACVC,gBAAgBQ,MAAMC,OAAO,CAACH,eAAeA,WAAW,CAAC,EAAE,GAAGA;wBAC9DH,IAAID,cAAcE,KAAK,CAACD,EAAE;oBAC5B;oBACA;gBACF;YACF;QACF;QAEA,IAAI,CAACJ,WAAW;YACdV,QAAQqB,MAAM,CAACC,IAAI,CACjB,CAAC,WAAW,EAAEjB,SAAS,sCAAsC,EAAEJ,iBAAiBsB,IAAI,CAAC,CAAC,CAAC;YAEzF;QACF;QAEA,4EAA4E;QAC5E,IAAIC;QACJ,IAAIf,UAAUgB,IAAI,IAAIhB,UAAUgB,IAAI,GAAG,KAAKhB,UAAUiB,KAAK,EAAE;YAC3DF,SAAS,AAACf,CAAAA,UAAUgB,IAAI,GAAG,CAAA,IAAKhB,UAAUiB,KAAK;QACjD;QAEA,MAAMC,iBAAiC;YACrCC,cAAclB,UAAUC,cAAc;YACtCkB,OAAOpB,UAAUoB,KAAK,IAAI;YAC1Bf,IAAIJ,UAAUI,EAAE;YAChBgB,MAAMzB;YACN,GAAII,UAAUiB,KAAK,KAAKvB,aAAa;gBAAEuB,OAAOjB,UAAUiB,KAAK;YAAC,CAAC;YAC/D,GAAIF,WAAWrB,aAAa;gBAAEqB;YAAO,CAAC;YACtC,GAAIf,UAAUsB,IAAI,IAAI;gBAAEA,MAAMlC,+BAA+BY,UAAUsB,IAAI;YAAE,CAAC;YAC9E,GAAItB,UAAUuB,KAAK,IAAI;gBAAEA,OAAOlC,gCAAgCW,UAAUuB,KAAK;YAAE,CAAC;QACpF;QAEA5B,OAAO6B,IAAI,CAACN;IACd;IAEA,OAAOvB,OAAO8B,MAAM,GAAG,IAAI9B,SAASD;AACtC"}

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

@@ -0,0 +1,12 @@
+import type { Where } from 'payload';
+import type { components } from '../generated/content-api-types.js';
+type WhereClause = components['schemas']['WhereClause'];
+type ConvertOptions = {
+    /** Internal flag to track if we're inside a logical operator (and/or) */
+    insideLogicalOperator?: boolean;
+    /** If true, transform 'parent' field to 'documentId' (used for version queries) */
+    parentToDocumentId?: boolean;
+};
+export declare function convertPayloadWhereToContentAPI(where: undefined | Where, options?: ConvertOptions): WhereClause;
+export {};
+//# sourceMappingURL=where.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"where.d.ts","sourceRoot":"","sources":["../../../src/db-content-api/utilities/where.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAEpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAA;AAEnE,KAAK,WAAW,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,aAAa,CAAC,CAAA;AASvD,KAAK,cAAc,GAAG;IACpB,yEAAyE;IACzE,qBAAqB,CAAC,EAAE,OAAO,CAAA;IAC/B,mFAAmF;IACnF,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAC7B,CAAA;AAED,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,SAAS,GAAG,KAAK,EACxB,OAAO,GAAE,cAAmB,GAC3B,WAAW,CA2Db"}

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

@@ -0,0 +1,63 @@
+export function convertPayloadWhereToContentAPI(where, options = {}) {
+    // Empty where {} should be { and: [] } not undefined
+    // Content API requires a where clause structure even for "no filter"
+    if (!where || Object.keys(where).length === 0) {
+        return {
+            and: []
+        };
+    }
+    const conditions = [];
+    for (const [key, value] of Object.entries(where)){
+        if (key === 'and') {
+            // Recursively convert nested 'and' conditions, preserving options
+            const nestedConditions = value.map((item)=>convertPayloadWhereToContentAPI(item, {
+                    ...options,
+                    insideLogicalOperator: true
+                }));
+            return {
+                and: nestedConditions
+            };
+        } else if (key === 'or') {
+            // Recursively convert nested 'or' conditions, preserving options
+            const nestedConditions = value.map((item)=>convertPayloadWhereToContentAPI(item, {
+                    ...options,
+                    insideLogicalOperator: true
+                }));
+            return {
+                or: nestedConditions
+            };
+        } else {
+            // TODO: fix this in content api
+            // WORKAROUND: Payload uses 'parent' for version queries, but Content API expects 'documentId'
+            let fieldPath = key;
+            if (options.parentToDocumentId && key === 'parent') {
+                fieldPath = 'documentId';
+            }
+            // Convert field conditions: { fieldName: { operator: value } }
+            // to: { path: fieldName, operator, value }
+            const operators = value;
+            for (const [op, operatorValue] of Object.entries(operators)){
+                let finalValue = operatorValue;
+                // Add wildcards for contains/like operators (Payload doesn't add them)
+                if ((op === 'contains' || op === 'like') && typeof operatorValue === 'string') {
+                    finalValue = `%${operatorValue}%`;
+                }
+                conditions.push({
+                    operator: op,
+                    path: fieldPath,
+                    value: finalValue
+                });
+            }
+        }
+    }
+    // If inside a logical operator (and/or), return conditions directly
+    // Otherwise, wrap in 'and' to match WhereClause type
+    if (options.insideLogicalOperator && conditions.length === 1) {
+        return conditions[0];
+    }
+    return {
+        and: conditions
+    };
+}
+
+//# sourceMappingURL=where.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/db-content-api/utilities/where.ts"],"sourcesContent":["import type { Where } from 'payload'\n\nimport type { components } from '../generated/content-api-types.js'\n\ntype WhereClause = components['schemas']['WhereClause']\n\n// Payload's format: { fieldName: { operator: value }, and: [...], or: [...] }\n// Content API expects: { and: [{ path, operator, value }], or: [{ path, operator, value }] }\n//\n// The format stays different. This allows the Content API to evolve its filter schema,\n// for example to support composite types like Point, which are not lexicographically sortable.\n// Semantics must remain identical to Payload.\n\ntype ConvertOptions = {\n  /** Internal flag to track if we're inside a logical operator (and/or) */\n  insideLogicalOperator?: boolean\n  /** If true, transform 'parent' field to 'documentId' (used for version queries) */\n  parentToDocumentId?: boolean\n}\n\nexport function convertPayloadWhereToContentAPI(\n  where: undefined | Where,\n  options: ConvertOptions = {},\n): WhereClause {\n  // Empty where {} should be { and: [] } not undefined\n  // Content API requires a where clause structure even for \"no filter\"\n  if (!where || Object.keys(where).length === 0) {\n    return { and: [] }\n  }\n\n  // Extract the condition type (the variant with 'path', 'operator', 'value') from WhereClause union\n  type WhereCondition = Extract<WhereClause, { path: string }>\n  const conditions: WhereClause[] = []\n\n  for (const [key, value] of Object.entries(where)) {\n    if (key === 'and') {\n      // Recursively convert nested 'and' conditions, preserving options\n      const nestedConditions = (value as Where[]).map((item) =>\n        convertPayloadWhereToContentAPI(item, { ...options, insideLogicalOperator: true }),\n      )\n      return { and: nestedConditions }\n    } else if (key === 'or') {\n      // Recursively convert nested 'or' conditions, preserving options\n      const nestedConditions = (value as Where[]).map((item) =>\n        convertPayloadWhereToContentAPI(item, { ...options, insideLogicalOperator: true }),\n      )\n      return { or: nestedConditions }\n    } else {\n      // TODO: fix this in content api\n      // WORKAROUND: Payload uses 'parent' for version queries, but Content API expects 'documentId'\n      let fieldPath = key\n      if (options.parentToDocumentId && key === 'parent') {\n        fieldPath = 'documentId'\n      }\n\n      // Convert field conditions: { fieldName: { operator: value } }\n      // to: { path: fieldName, operator, value }\n      const operators = value as Record<string, unknown>\n      for (const [op, operatorValue] of Object.entries(operators)) {\n        let finalValue = operatorValue\n\n        // Add wildcards for contains/like operators (Payload doesn't add them)\n        if ((op === 'contains' || op === 'like') && typeof operatorValue === 'string') {\n          finalValue = `%${operatorValue}%`\n        }\n\n        conditions.push({\n          operator: op as WhereCondition['operator'],\n          path: fieldPath,\n          value: finalValue,\n        } as WhereCondition)\n      }\n    }\n  }\n\n  // If inside a logical operator (and/or), return conditions directly\n  // Otherwise, wrap in 'and' to match WhereClause type\n  if (options.insideLogicalOperator && conditions.length === 1) {\n    return conditions[0]\n  }\n\n  return { and: conditions }\n}\n"],"names":["convertPayloadWhereToContentAPI","where","options","Object","keys","length","and","conditions","key","value","entries","nestedConditions","map","item","insideLogicalOperator","or","fieldPath","parentToDocumentId","operators","op","operatorValue","finalValue","push","operator","path"],"mappings":"AAoBA,OAAO,SAASA,gCACdC,KAAwB,EACxBC,UAA0B,CAAC,CAAC;IAE5B,qDAAqD;IACrD,qEAAqE;IACrE,IAAI,CAACD,SAASE,OAAOC,IAAI,CAACH,OAAOI,MAAM,KAAK,GAAG;QAC7C,OAAO;YAAEC,KAAK,EAAE;QAAC;IACnB;IAIA,MAAMC,aAA4B,EAAE;IAEpC,KAAK,MAAM,CAACC,KAAKC,MAAM,IAAIN,OAAOO,OAAO,CAACT,OAAQ;QAChD,IAAIO,QAAQ,OAAO;YACjB,kEAAkE;YAClE,MAAMG,mBAAmB,AAACF,MAAkBG,GAAG,CAAC,CAACC,OAC/Cb,gCAAgCa,MAAM;oBAAE,GAAGX,OAAO;oBAAEY,uBAAuB;gBAAK;YAElF,OAAO;gBAAER,KAAKK;YAAiB;QACjC,OAAO,IAAIH,QAAQ,MAAM;YACvB,iEAAiE;YACjE,MAAMG,mBAAmB,AAACF,MAAkBG,GAAG,CAAC,CAACC,OAC/Cb,gCAAgCa,MAAM;oBAAE,GAAGX,OAAO;oBAAEY,uBAAuB;gBAAK;YAElF,OAAO;gBAAEC,IAAIJ;YAAiB;QAChC,OAAO;YACL,gCAAgC;YAChC,8FAA8F;YAC9F,IAAIK,YAAYR;YAChB,IAAIN,QAAQe,kBAAkB,IAAIT,QAAQ,UAAU;gBAClDQ,YAAY;YACd;YAEA,+DAA+D;YAC/D,2CAA2C;YAC3C,MAAME,YAAYT;YAClB,KAAK,MAAM,CAACU,IAAIC,cAAc,IAAIjB,OAAOO,OAAO,CAACQ,WAAY;gBAC3D,IAAIG,aAAaD;gBAEjB,uEAAuE;gBACvE,IAAI,AAACD,CAAAA,OAAO,cAAcA,OAAO,MAAK,KAAM,OAAOC,kBAAkB,UAAU;oBAC7EC,aAAa,CAAC,CAAC,EAAED,cAAc,CAAC,CAAC;gBACnC;gBAEAb,WAAWe,IAAI,CAAC;oBACdC,UAAUJ;oBACVK,MAAMR;oBACNP,OAAOY;gBACT;YACF;QACF;IACF;IAEA,oEAAoE;IACpE,qDAAqD;IACrD,IAAInB,QAAQY,qBAAqB,IAAIP,WAAWF,MAAM,KAAK,GAAG;QAC5D,OAAOE,UAAU,CAAC,EAAE;IACtB;IAEA,OAAO;QAAED,KAAKC;IAAW;AAC3B"}

package/dist/plugin/build-config.d.ts

@@ -42,6 +42,7 @@ export type FigmaConfig = {
 } & {
     figma: {
         contentSystemId: string;
+        storage?: boolean;
         useContentSystem?: boolean;
     };
 } & Omit<Config, 'db' | 'editor' | 'secret'> & Partial<Pick<Config, 'db'>>;

package/dist/plugin/build-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build-config.d.ts","sourceRoot":"","sources":["../../src/plugin/build-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAUtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAA;CAC1B,GAAG;IACF,KAAK,EAAE;QACL,eAAe,EAAE,MAAM,CAAA;QACvB,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAC3B,CAAA;CACF,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,GAAG,QAAQ,GAAG,QAAQ,CAAC,GAC1C,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAA;AAE7B;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC,CA8EpF"}
+{"version":3,"file":"build-config.d.ts","sourceRoot":"","sources":["../../src/plugin/build-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AActD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAA;CAC1B,GAAG;IACF,KAAK,EAAE;QACL,eAAe,EAAE,MAAM,CAAA;QACvB,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAC3B,CAAA;CACF,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,GAAG,QAAQ,GAAG,QAAQ,CAAC,GAC1C,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAA;AAE7B;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC,CA+GpF"}

package/dist/plugin/build-config.js

@@ -1,9 +1,11 @@
+import { cloudStoragePlugin } from '@payloadcms/plugin-cloud-storage';
 import { lexicalEditor } from '@payloadcms/richtext-lexical';
 import { buildConfig as payloadBuildConfig } from 'payload';
 import { getTokenStore } from '../auth/token-store.js';
 import { contentAPIAdapter } from '../db-content-api/index.js';
 import { health } from '../endpoints/health.js';
 import { oAuth2Plugin } from '../oauth/index.js';
+import { contentApiStorageAdapter } from '../storage-content-api/index.js';
 /**
  * Figma platform wrapper for Payload's buildConfig.
  * Automatically injects:
@@ -52,6 +54,39 @@ import { oAuth2Plugin } from '../oauth/index.js';
             url
         });
     }
+    // Build storage plugin if there are upload collections and storage is not disabled
+    const uploadCollections = (config.collections || []).filter((c)=>c.upload);
+    let storagePlugin;
+    if (uploadCollections.length > 0 && config.figma.storage !== false) {
+        const storageConfig = process.env.FIGMA_CONTENT_API_ACCESS_KEY ? {
+            baseUrl: url,
+            contentApiKey: process.env.FIGMA_CONTENT_API_ACCESS_KEY
+        } : process.env.FIGMA_DEV_JWT === 'true' ? {
+            auth: {
+                mode: 'devJwt'
+            },
+            baseUrl: url,
+            contentSystemId
+        } : {
+            auth: {
+                mode: 'tokenStore',
+                tokenStore: getTokenStore()
+            },
+            baseUrl: url,
+            contentSystemId
+        };
+        const adapter = contentApiStorageAdapter(storageConfig);
+        const collectionsMap = uploadCollections.reduce((acc, c)=>{
+            acc[c.slug] = {
+                adapter,
+                disableLocalStorage: true
+            };
+            return acc;
+        }, {});
+        storagePlugin = cloudStoragePlugin({
+            collections: collectionsMap
+        });
+    }
     // Build complete config with Figma platform defaults
     const configWithFigmaDefaults = {
         ...config,
@@ -68,6 +103,9 @@ import { oAuth2Plugin } from '../oauth/index.js';
         // Add oauth to plugins if not already present
         plugins: [
             ...config.plugins ?? [],
+            ...storagePlugin ? [
+                storagePlugin
+            ] : [],
             oAuth2Plugin({
                 collections: [
                     {

package/dist/plugin/build-config.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/plugin/build-config.ts"],"sourcesContent":["import type { Config, SanitizedConfig } from 'payload'\n\nimport { lexicalEditor } from '@payloadcms/richtext-lexical'\nimport { buildConfig as payloadBuildConfig } from 'payload'\n\nimport { getTokenStore } from '../auth/token-store.js'\nimport { contentAPIAdapter } from '../db-content-api/index.js'\nimport { health } from '../endpoints/health.js'\nimport { oAuth2Plugin } from '../oauth/index.js'\n\n/**\n * Configuration type for Payload projects on the Figma platform.\n *\n * Differences from standard Payload Config:\n * - `db`: Omitted (auto-injected by Figma platform)\n * - `secret`: Omitted (auto-injected by Figma platform)\n * - `editor`: Optional (defaults to lexicalEditor() if not provided)\n *\n * @example\n * // Minimal config\n * const config: FigmaConfig = {\n *   figma: {\n *     contentSystemId: process.env.FIGMA_CONTENT_SYSTEM_ID!\n *   },\n *   collections: [...]\n * }\n *\n * @example\n * // With custom editor\n * const config: FigmaConfig = {\n *   figma: {\n *     contentSystemId: process.env.FIGMA_CONTENT_SYSTEM_ID!\n *   },\n *   collections: [...],\n *   editor: lexicalEditor({ features: [...] })\n * }\n *\n * @example\n * // Disable Content System (use custom db)\n * const config: FigmaConfig = {\n *   figma: {\n *     contentSystemId: process.env.FIGMA_CONTENT_SYSTEM_ID!,\n *     useContentSystem: false\n *   },\n *   db: mongooseAdapter({ url: process.env.DATABASE_URI }),\n *   collections: [...]\n * }\n */\nexport type FigmaConfig = {\n  editor?: Config['editor']\n} & {\n  figma: {\n    contentSystemId: string\n    useContentSystem?: boolean\n  }\n} & Omit<Config, 'db' | 'editor' | 'secret'> &\n  Partial<Pick<Config, 'db'>>\n\n/**\n * Figma platform wrapper for Payload's buildConfig.\n * Automatically injects:\n * - Figma database adapter\n * - Secret (platform-provided)\n * - Default lexicalEditor (if no custom editor specified)\n *\n * @param config - Payload configuration (db and secret omitted, editor optional)\n * @returns Promise<SanitizedConfig> - Built Payload configuration\n */\nexport async function buildFigmaConfig(config: FigmaConfig): Promise<SanitizedConfig> {\n  // Validate required environment variable\n  if (!config.figma.contentSystemId) {\n    throw new Error(\n      'FIGMA_CONTENT_SYSTEM_ID is required. ' +\n        'Ensure your .env file contains: FIGMA_CONTENT_SYSTEM_ID=your-content-system-id',\n    )\n  }\n\n  const DEFAULT_CONTENT_API_URL =\n    'https://us-east-1.cms-tenants-001-staging.figmacontentstaging.com'\n\n  const url = process.env.FIGMA_CONTENT_API_URL || DEFAULT_CONTENT_API_URL\n  const { contentSystemId } = config.figma\n\n  // Determine database adapter based on environment\n  let db: Config['db']\n\n  if (config.figma.useContentSystem === false) {\n    db = config.db!\n  } else if (process.env.FIGMA_CONTENT_API_ACCESS_KEY) {\n    db = contentAPIAdapter({\n      auth: { apiKey: process.env.FIGMA_CONTENT_API_ACCESS_KEY, mode: 'apiKey' },\n      contentSystemId,\n      url,\n    })\n  } else if (process.env.FIGMA_DEV_JWT === 'true') {\n    db = contentAPIAdapter({\n      auth: { mode: 'devJwt' },\n      contentSystemId,\n      url,\n    })\n  } else {\n    db = contentAPIAdapter({\n      auth: { mode: 'tokenStore', tokenStore: getTokenStore() },\n      contentSystemId,\n      url,\n    })\n  }\n\n  // Build complete config with Figma platform defaults\n  const configWithFigmaDefaults: Config = {\n    ...config,\n    custom: {\n      figma: config.figma || {},\n    },\n    db,\n    editor: config.editor ?? lexicalEditor(),\n    endpoints: [...(config.endpoints ?? []), health],\n    secret: 'MY_SECRET',\n    // Add oauth to plugins if not already present\n    plugins: [\n      ...(config.plugins ?? []),\n      oAuth2Plugin({\n        collections: [\n          {\n            slug: 'users',\n            // Use adapter because Figma app doesn't support OIDC scopes\n            authorizationURLParams: {\n              response_mode: 'query',\n              response_type: 'code',\n            },\n            clientID: process.env.FIGMA_OAUTH_CLIENT_ID!,\n            clientSecret: process.env.FIGMA_OAUTH_CLIENT_SECRET,\n            identityMetadata: 'https://staging.figma.com/.well-known/openid-configuration',\n            scope: ['current_user:read'],\n            token: 'id_token', // Adapter creates JWT id_token from Figma user info\n            usernameField: 'email',\n          },\n        ],\n        debug: !!process.env.DEBUG,\n        disabled: false,\n      }),\n    ],\n  }\n\n  // Delegate to Payload's buildConfig\n  return await payloadBuildConfig(configWithFigmaDefaults)\n}\n"],"names":["lexicalEditor","buildConfig","payloadBuildConfig","getTokenStore","contentAPIAdapter","health","oAuth2Plugin","buildFigmaConfig","config","figma","contentSystemId","Error","DEFAULT_CONTENT_API_URL","url","process","env","FIGMA_CONTENT_API_URL","db","useContentSystem","FIGMA_CONTENT_API_ACCESS_KEY","auth","apiKey","mode","FIGMA_DEV_JWT","tokenStore","configWithFigmaDefaults","custom","editor","endpoints","secret","plugins","collections","slug","authorizationURLParams","response_mode","response_type","clientID","FIGMA_OAUTH_CLIENT_ID","clientSecret","FIGMA_OAUTH_CLIENT_SECRET","identityMetadata","scope","token","usernameField","debug","DEBUG","disabled"],"mappings":"AAEA,SAASA,aAAa,QAAQ,+BAA8B;AAC5D,SAASC,eAAeC,kBAAkB,QAAQ,UAAS;AAE3D,SAASC,aAAa,QAAQ,yBAAwB;AACtD,SAASC,iBAAiB,QAAQ,6BAA4B;AAC9D,SAASC,MAAM,QAAQ,yBAAwB;AAC/C,SAASC,YAAY,QAAQ,oBAAmB;AAkDhD;;;;;;;;;CASC,GACD,OAAO,eAAeC,iBAAiBC,MAAmB;IACxD,yCAAyC;IACzC,IAAI,CAACA,OAAOC,KAAK,CAACC,eAAe,EAAE;QACjC,MAAM,IAAIC,MACR,0CACE;IAEN;IAEA,MAAMC,0BACJ;IAEF,MAAMC,MAAMC,QAAQC,GAAG,CAACC,qBAAqB,IAAIJ;IACjD,MAAM,EAAEF,eAAe,EAAE,GAAGF,OAAOC,KAAK;IAExC,kDAAkD;IAClD,IAAIQ;IAEJ,IAAIT,OAAOC,KAAK,CAACS,gBAAgB,KAAK,OAAO;QAC3CD,KAAKT,OAAOS,EAAE;IAChB,OAAO,IAAIH,QAAQC,GAAG,CAACI,4BAA4B,EAAE;QACnDF,KAAKb,kBAAkB;YACrBgB,MAAM;gBAAEC,QAAQP,QAAQC,GAAG,CAACI,4BAA4B;gBAAEG,MAAM;YAAS;YACzEZ;YACAG;QACF;IACF,OAAO,IAAIC,QAAQC,GAAG,CAACQ,aAAa,KAAK,QAAQ;QAC/CN,KAAKb,kBAAkB;YACrBgB,MAAM;gBAAEE,MAAM;YAAS;YACvBZ;YACAG;QACF;IACF,OAAO;QACLI,KAAKb,kBAAkB;YACrBgB,MAAM;gBAAEE,MAAM;gBAAcE,YAAYrB;YAAgB;YACxDO;YACAG;QACF;IACF;IAEA,qDAAqD;IACrD,MAAMY,0BAAkC;QACtC,GAAGjB,MAAM;QACTkB,QAAQ;YACNjB,OAAOD,OAAOC,KAAK,IAAI,CAAC;QAC1B;QACAQ;QACAU,QAAQnB,OAAOmB,MAAM,IAAI3B;QACzB4B,WAAW;eAAKpB,OAAOoB,SAAS,IAAI,EAAE;YAAGvB;SAAO;QAChDwB,QAAQ;QACR,8CAA8C;QAC9CC,SAAS;eACHtB,OAAOsB,OAAO,IAAI,EAAE;YACxBxB,aAAa;gBACXyB,aAAa;oBACX;wBACEC,MAAM;wBACN,4DAA4D;wBAC5DC,wBAAwB;4BACtBC,eAAe;4BACfC,eAAe;wBACjB;wBACAC,UAAUtB,QAAQC,GAAG,CAACsB,qBAAqB;wBAC3CC,cAAcxB,QAAQC,GAAG,CAACwB,yBAAyB;wBACnDC,kBAAkB;wBAClBC,OAAO;4BAAC;yBAAoB;wBAC5BC,OAAO;wBACPC,eAAe;oBACjB;iBACD;gBACDC,OAAO,CAAC,CAAC9B,QAAQC,GAAG,CAAC8B,KAAK;gBAC1BC,UAAU;YACZ;SACD;IACH;IAEA,oCAAoC;IACpC,OAAO,MAAM5C,mBAAmBuB;AAClC"}
+{"version":3,"sources":["../../src/plugin/build-config.ts"],"sourcesContent":["import type { Config, SanitizedConfig } from 'payload'\n\nimport { cloudStoragePlugin } from '@payloadcms/plugin-cloud-storage'\nimport { lexicalEditor } from '@payloadcms/richtext-lexical'\nimport { buildConfig as payloadBuildConfig } from 'payload'\n\nimport type { StorageClientConfig } from '../storage-content-api/index.js'\n\nimport { getTokenStore } from '../auth/token-store.js'\nimport { contentAPIAdapter } from '../db-content-api/index.js'\nimport { health } from '../endpoints/health.js'\nimport { oAuth2Plugin } from '../oauth/index.js'\nimport { contentApiStorageAdapter } from '../storage-content-api/index.js'\n\n/**\n * Configuration type for Payload projects on the Figma platform.\n *\n * Differences from standard Payload Config:\n * - `db`: Omitted (auto-injected by Figma platform)\n * - `secret`: Omitted (auto-injected by Figma platform)\n * - `editor`: Optional (defaults to lexicalEditor() if not provided)\n *\n * @example\n * // Minimal config\n * const config: FigmaConfig = {\n *   figma: {\n *     contentSystemId: process.env.FIGMA_CONTENT_SYSTEM_ID!\n *   },\n *   collections: [...]\n * }\n *\n * @example\n * // With custom editor\n * const config: FigmaConfig = {\n *   figma: {\n *     contentSystemId: process.env.FIGMA_CONTENT_SYSTEM_ID!\n *   },\n *   collections: [...],\n *   editor: lexicalEditor({ features: [...] })\n * }\n *\n * @example\n * // Disable Content System (use custom db)\n * const config: FigmaConfig = {\n *   figma: {\n *     contentSystemId: process.env.FIGMA_CONTENT_SYSTEM_ID!,\n *     useContentSystem: false\n *   },\n *   db: mongooseAdapter({ url: process.env.DATABASE_URI }),\n *   collections: [...]\n * }\n */\nexport type FigmaConfig = {\n  editor?: Config['editor']\n} & {\n  figma: {\n    contentSystemId: string\n    storage?: boolean\n    useContentSystem?: boolean\n  }\n} & Omit<Config, 'db' | 'editor' | 'secret'> &\n  Partial<Pick<Config, 'db'>>\n\n/**\n * Figma platform wrapper for Payload's buildConfig.\n * Automatically injects:\n * - Figma database adapter\n * - Secret (platform-provided)\n * - Default lexicalEditor (if no custom editor specified)\n *\n * @param config - Payload configuration (db and secret omitted, editor optional)\n * @returns Promise<SanitizedConfig> - Built Payload configuration\n */\nexport async function buildFigmaConfig(config: FigmaConfig): Promise<SanitizedConfig> {\n  // Validate required environment variable\n  if (!config.figma.contentSystemId) {\n    throw new Error(\n      'FIGMA_CONTENT_SYSTEM_ID is required. ' +\n        'Ensure your .env file contains: FIGMA_CONTENT_SYSTEM_ID=your-content-system-id',\n    )\n  }\n\n  const DEFAULT_CONTENT_API_URL =\n    'https://us-east-1.cms-tenants-001-staging.figmacontentstaging.com'\n\n  const url = process.env.FIGMA_CONTENT_API_URL || DEFAULT_CONTENT_API_URL\n  const { contentSystemId } = config.figma\n\n  // Determine database adapter based on environment\n  let db: Config['db']\n\n  if (config.figma.useContentSystem === false) {\n    db = config.db!\n  } else if (process.env.FIGMA_CONTENT_API_ACCESS_KEY) {\n    db = contentAPIAdapter({\n      auth: { apiKey: process.env.FIGMA_CONTENT_API_ACCESS_KEY, mode: 'apiKey' },\n      contentSystemId,\n      url,\n    })\n  } else if (process.env.FIGMA_DEV_JWT === 'true') {\n    db = contentAPIAdapter({\n      auth: { mode: 'devJwt' },\n      contentSystemId,\n      url,\n    })\n  } else {\n    db = contentAPIAdapter({\n      auth: { mode: 'tokenStore', tokenStore: getTokenStore() },\n      contentSystemId,\n      url,\n    })\n  }\n\n  // Build storage plugin if there are upload collections and storage is not disabled\n  const uploadCollections = (config.collections || []).filter((c) => c.upload)\n  let storagePlugin: ReturnType<typeof cloudStoragePlugin> | undefined\n\n  if (uploadCollections.length > 0 && config.figma.storage !== false) {\n    const storageConfig: StorageClientConfig = process.env.FIGMA_CONTENT_API_ACCESS_KEY\n      ? { baseUrl: url, contentApiKey: process.env.FIGMA_CONTENT_API_ACCESS_KEY }\n      : process.env.FIGMA_DEV_JWT === 'true'\n        ? {\n            auth: { mode: 'devJwt' },\n            baseUrl: url,\n            contentSystemId,\n          }\n        : {\n            auth: { mode: 'tokenStore', tokenStore: getTokenStore() },\n            baseUrl: url,\n            contentSystemId,\n          }\n\n    const adapter = contentApiStorageAdapter(storageConfig)\n\n    const collectionsMap = uploadCollections.reduce(\n      (acc, c) => {\n        acc[c.slug] = { adapter, disableLocalStorage: true }\n        return acc\n      },\n      {} as Record<string, { adapter: typeof adapter; disableLocalStorage: boolean }>,\n    )\n\n    storagePlugin = cloudStoragePlugin({ collections: collectionsMap })\n  }\n\n  // Build complete config with Figma platform defaults\n  const configWithFigmaDefaults: Config = {\n    ...config,\n    custom: {\n      figma: config.figma || {},\n    },\n    db,\n    editor: config.editor ?? lexicalEditor(),\n    endpoints: [...(config.endpoints ?? []), health],\n    secret: 'MY_SECRET',\n    // Add oauth to plugins if not already present\n    plugins: [\n      ...(config.plugins ?? []),\n      ...(storagePlugin ? [storagePlugin] : []),\n      oAuth2Plugin({\n        collections: [\n          {\n            slug: 'users',\n            // Use adapter because Figma app doesn't support OIDC scopes\n            authorizationURLParams: {\n              response_mode: 'query',\n              response_type: 'code',\n            },\n            clientID: process.env.FIGMA_OAUTH_CLIENT_ID!,\n            clientSecret: process.env.FIGMA_OAUTH_CLIENT_SECRET,\n            identityMetadata: 'https://staging.figma.com/.well-known/openid-configuration',\n            scope: ['current_user:read'],\n            token: 'id_token', // Adapter creates JWT id_token from Figma user info\n            usernameField: 'email',\n          },\n        ],\n        debug: !!process.env.DEBUG,\n        disabled: false,\n      }),\n    ],\n  }\n\n  // Delegate to Payload's buildConfig\n  return await payloadBuildConfig(configWithFigmaDefaults)\n}\n"],"names":["cloudStoragePlugin","lexicalEditor","buildConfig","payloadBuildConfig","getTokenStore","contentAPIAdapter","health","oAuth2Plugin","contentApiStorageAdapter","buildFigmaConfig","config","figma","contentSystemId","Error","DEFAULT_CONTENT_API_URL","url","process","env","FIGMA_CONTENT_API_URL","db","useContentSystem","FIGMA_CONTENT_API_ACCESS_KEY","auth","apiKey","mode","FIGMA_DEV_JWT","tokenStore","uploadCollections","collections","filter","c","upload","storagePlugin","length","storage","storageConfig","baseUrl","contentApiKey","adapter","collectionsMap","reduce","acc","slug","disableLocalStorage","configWithFigmaDefaults","custom","editor","endpoints","secret","plugins","authorizationURLParams","response_mode","response_type","clientID","FIGMA_OAUTH_CLIENT_ID","clientSecret","FIGMA_OAUTH_CLIENT_SECRET","identityMetadata","scope","token","usernameField","debug","DEBUG","disabled"],"mappings":"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"}