@payloadcms/figma 0.0.1-alpha.44 → 0.0.1-alpha.45

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

@@ -0,0 +1,15 @@
+/**
+ * PathType can be either a simple string type or an object with additional metadata.
+ *
+ * Simple types: "array" - for array fields, blocks, or hasMany relationships/selects
+ *
+ * Relationship types include collection info needed for Content API to perform JOINs:
+ * - type: "relationship" for stored references, "join" for virtual reverse lookups
+ * - collection: target collection slug (or array for polymorphic)
+ * - hasMany: whether it stores multiple references
+ *
+ * TODO: This type is defined here temporarily so Content API can test the integration.
+ * Once Content API implements support for this, the type should be generated from openapi.json.
+ */ export { };
+
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/db-content-api/temp-utilities/types.ts"],"sourcesContent":["/**\n * PathType can be either a simple string type or an object with additional metadata.\n *\n * Simple types: \"array\" - for array fields, blocks, or hasMany relationships/selects\n *\n * Relationship types include collection info needed for Content API to perform JOINs:\n * - type: \"relationship\" for stored references, \"join\" for virtual reverse lookups\n * - collection: target collection slug (or array for polymorphic)\n * - hasMany: whether it stores multiple references\n *\n * TODO: This type is defined here temporarily so Content API can test the integration.\n * Once Content API implements support for this, the type should be generated from openapi.json.\n */\nexport type PathTypeValue =\n  | 'array'\n  | {\n      collection: string | string[]\n      hasMany?: boolean\n      /** For join fields, the field path in the related collection that points back */\n      on?: string\n      type: 'join' | 'relationship'\n    }\n\nexport type PathTypesRecord = Record<string, PathTypeValue>\n"],"names":[],"mappings":"AAAA;;;;;;;;;;;;CAYC,GAWD,WAA2D"}

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

@@ -1,6 +1,18 @@
 import type { Payload } from 'payload';
 import type { components } from '../../generated/content-api-types.js';
 type DataWithOperations = components['schemas']['DataWithOperations'];
+interface DataToContentAPIOptions {
+    /** Apply static defaults for undefined fields */
+    applyDefaults?: boolean;
+    /** Add createdAt timestamp */
+    createdAt?: boolean;
+    /**
+     * Transform publishedLocale to localizeStatus format.
+     * When provided, converts `_status: 'published'` + `publishedLocale: 'en'`
+     * to `_status: { en: 'published' }` format.
+     */
+    publishedLocale?: string;
+}
 /**
  * Transform data before sending to Content API (WRITE operations)
  *
@@ -10,13 +22,11 @@ type DataWithOperations = components['schemas']['DataWithOperations'];
  * - RichText fields: Objects -> JSON strings
  * - Virtual fields: Remove fields with `virtual: true` (pure virtual fields should never be saved)
  * - Timestamps: Add updatedAt (always), and createdAt (when createdAt=true)
+ * - publishedLocale: Transform to localizeStatus format (when publishedLocale is provided)
  *
  * Note: Date fields are automatically converted to ISO strings by JSON.stringify()
  */
-export declare function dataToContentAPI(payload: Payload, collectionSlug: string, data: unknown, options?: {
-    applyDefaults?: boolean;
-    createdAt?: boolean;
-}): DataWithOperations;
+export declare function dataToContentAPI(payload: Payload, collectionSlug: string, data: unknown, options?: DataToContentAPIOptions): DataWithOperations;
 /**
  * Transform data received from Content API (READ operations)
  *

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/db-content-api/utilities/data/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkC,OAAO,EAA0B,MAAM,SAAS,CAAA;AAI9F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sCAAsC,CAAA;AAOtE,KAAK,kBAAkB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,oBAAoB,CAAC,CAAA;AAErE;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,OAAO,EAChB,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GACzD,kBAAkB,CA8EpB;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,OAAO,EAChB,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,OAAO,GACZ,OAAO,CAyGT"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/db-content-api/utilities/data/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkC,OAAO,EAA0B,MAAM,SAAS,CAAA;AAI9F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sCAAsC,CAAA;AAQtE,KAAK,kBAAkB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,oBAAoB,CAAC,CAAA;AAErE,UAAU,uBAAuB;IAC/B,iDAAiD;IACjD,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,8BAA8B;IAC9B,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,OAAO,EAChB,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE,uBAAuB,GAChC,kBAAkB,CAoFpB;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,OAAO,EAChB,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,OAAO,GACZ,OAAO,CA4GT"}

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

@@ -3,6 +3,7 @@ import { applyDefaults } from './applyDefaults.js';
 import { castFieldValue } from './castFieldValue.js';
 import { removeVirtualFields } from './removeVirtualFields.js';
 import { stripFields } from './stripFields.js';
+import { transformToLocalizeStatus } from './transformPublishedLocale.js';
 /**
  * Transform data before sending to Content API (WRITE operations)
  *
@@ -12,14 +13,17 @@ import { stripFields } from './stripFields.js';
  * - RichText fields: Objects -> JSON strings
  * - Virtual fields: Remove fields with `virtual: true` (pure virtual fields should never be saved)
  * - Timestamps: Add updatedAt (always), and createdAt (when createdAt=true)
+ * - publishedLocale: Transform to localizeStatus format (when publishedLocale is provided)
  *
  * Note: Date fields are automatically converted to ISO strings by JSON.stringify()
  */ export function dataToContentAPI(payload, collectionSlug, data, options) {
     if (!data || typeof data !== 'object') {
         return data;
     }
+    // Transform publishedLocale to localizeStatus format before other transformations
+    const dataWithLocalizedStatus = transformToLocalizeStatus(data, options?.publishedLocale);
     // Deep clone to avoid mutating original data
-    const transformed = JSON.parse(JSON.stringify(data));
+    const transformed = JSON.parse(JSON.stringify(dataWithLocalizedStatus));
     // Get collection config
     const isGlobal = collectionSlug.startsWith('_global-');
     const actualSlug = isGlobal ? collectionSlug.substring(8) : collectionSlug;
@@ -134,15 +138,18 @@ import { stripFields } from './stripFields.js';
             // Content API may store localized fields as JSON strings like "{\"en\":\"value\"}"
             // so we need to parse them back to objects.
             // Note: We return the full locale object - Payload Core handles flattening to requested locale.
+            // When requesting a specific locale (not 'all'), values are simple strings that won't parse.
+            // In that case, we silently keep the original value.
             if ('localized' in field && field.localized && 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 localized field '${fieldPath}' in collection '${collectionSlug}'`
-                    });
+                    const parsed = JSON.parse(value);
+                    // Only use parsed value if it's actually an object (locale -> value mapping)
+                    // Simple strings like "EN Title" would parse to themselves, which we don't want
+                    if (typeof parsed === 'object' && parsed !== null) {
+                        current[field.name] = parsed;
+                    }
+                } catch  {
+                // Not valid JSON - keep original value (this is expected for single-locale requests)
                 }
             } else if (field.type === 'richText' && typeof value === 'string') {
                 try {

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/db-content-api/utilities/data/index.ts"],"sourcesContent":["import type { CollectionConfig, GlobalConfig, Payload, TraverseFieldsCallback } from 'payload'\n\nimport { flattenAllFields, traverseFields } from 'payload'\n\nimport type { components } from '../../generated/content-api-types.js'\n\nimport { applyDefaults } from './applyDefaults.js'\nimport { castFieldValue } from './castFieldValue.js'\nimport { removeVirtualFields } from './removeVirtualFields.js'\nimport { stripFields } from './stripFields.js'\n\ntype DataWithOperations = components['schemas']['DataWithOperations']\n\n/**\n * Transform data before sending to Content API (WRITE operations)\n *\n * Conversions applied:\n * - Default values: Apply static defaults for undefined fields (when applyDefaults=true)\n * - Type casting: Convert values to match field types (e.g., number -> string for text fields)\n * - RichText fields: Objects -> JSON strings\n * - Virtual fields: Remove fields with `virtual: true` (pure virtual fields should never be saved)\n * - Timestamps: Add updatedAt (always), and createdAt (when createdAt=true)\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  options?: { applyDefaults?: boolean; createdAt?: boolean },\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  // Apply static defaults recursively to handle nested structures (arrays, groups)\n  // This must happen before traverseFields to ensure defaults are in place\n  if (options?.applyDefaults) {\n    applyDefaults(transformed, collectionConfig.fields)\n  }\n\n  // Use Payload's traverseFields to iterate over all fields for transformations\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    let value = current[field.name]\n\n    // Transform existing values\n    if (value !== null && value !== undefined) {\n      // Step 1: Apply type casting (e.g., number -> string for text fields)\n      value = castFieldValue(field, value)\n      current[field.name] = value\n\n      // Step 2: Apply Content API specific transformations\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, fillEmpty: false, ref: transformed })\n\n  stripFields({\n    config: payload.config,\n    data: transformed,\n    fields: flattenAllFields({ cache: true, fields: collectionConfig.fields }),\n    reservedKeys: ['id', 'globalType'],\n  })\n\n  removeVirtualFields(transformed, collectionConfig.fields)\n\n  // Convert numeric ID to string for Content API\n  const customIDType = payload.collections?.[collectionSlug]?.customIDType\n  if (customIDType === 'number') {\n    transformed.id = String(transformed.id)\n  }\n\n  // Add timestamps (Content API no longer auto-sets these in DB)\n  // updatedAt is always set, createdAt only on create operations\n  const now = new Date().toISOString()\n  transformed.updatedAt = now\n  if (options?.createdAt) {\n    transformed.createdAt = now\n  }\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 * - Virtual fields: Remove fields with `virtual: true` (should not be in DB but Content API backend may add them)\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    // Normalize undefined → null for optional fields\n    // Content API may omit fields (undefined) but Payload expects null for optional fields\n    if (value === undefined) {\n      const isRequired = 'required' in field && field.required\n      if (!isRequired) {\n        current[field.name] = null\n      }\n      return\n    }\n\n    if (value !== null) {\n      // Localized fields: JSON string -> parsed object\n      // Content API may store localized fields as JSON strings like \"{\\\"en\\\":\\\"value\\\"}\"\n      // so we need to parse them back to objects.\n      // Note: We return the full locale object - Payload Core handles flattening to requested locale.\n      if ('localized' in field && field.localized && 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 localized field '${fieldPath}' in collection '${collectionSlug}'`,\n          })\n        }\n      }\n      // RichText: JSON string -> object\n      else 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, fillEmpty: false, ref: transformed })\n\n  // Convert string ID to number if collection uses numeric custom ID\n  const customIDType = payload.collections?.[collectionSlug]?.customIDType\n  if (customIDType === 'number') {\n    transformed.id = Number(transformed.id)\n  }\n\n  stripFields({\n    config: payload.config,\n    data: transformed,\n    fields: flattenAllFields({ cache: true, fields: collectionConfig.fields }),\n    reservedKeys: ['id', 'globalType'],\n  })\n\n  // Remove virtual fields - must happen AFTER stripFields\n  removeVirtualFields(transformed, collectionConfig.fields)\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)) {\n        transformed[fieldName] = null\n      }\n    }\n  }\n\n  return transformed\n}\n"],"names":["flattenAllFields","traverseFields","applyDefaults","castFieldValue","removeVirtualFields","stripFields","dataToContentAPI","payload","collectionSlug","data","options","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","fillEmpty","cache","reservedKeys","customIDType","id","String","now","Date","toISOString","updatedAt","createdAt","dataFromContentAPI","parentPath","isRequired","required","localized","error","fieldPath","logger","warn","err","Error","msg","Number","auth","authFields","fieldName"],"mappings":"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"}
+{"version":3,"sources":["../../../../src/db-content-api/utilities/data/index.ts"],"sourcesContent":["import type { CollectionConfig, GlobalConfig, Payload, TraverseFieldsCallback } from 'payload'\n\nimport { flattenAllFields, traverseFields } from 'payload'\n\nimport type { components } from '../../generated/content-api-types.js'\n\nimport { applyDefaults } from './applyDefaults.js'\nimport { castFieldValue } from './castFieldValue.js'\nimport { removeVirtualFields } from './removeVirtualFields.js'\nimport { stripFields } from './stripFields.js'\nimport { transformToLocalizeStatus } from './transformPublishedLocale.js'\n\ntype DataWithOperations = components['schemas']['DataWithOperations']\n\ninterface DataToContentAPIOptions {\n  /** Apply static defaults for undefined fields */\n  applyDefaults?: boolean\n  /** Add createdAt timestamp */\n  createdAt?: boolean\n  /**\n   * Transform publishedLocale to localizeStatus format.\n   * When provided, converts `_status: 'published'` + `publishedLocale: 'en'`\n   * to `_status: { en: 'published' }` format.\n   */\n  publishedLocale?: string\n}\n\n/**\n * Transform data before sending to Content API (WRITE operations)\n *\n * Conversions applied:\n * - Default values: Apply static defaults for undefined fields (when applyDefaults=true)\n * - Type casting: Convert values to match field types (e.g., number -> string for text fields)\n * - RichText fields: Objects -> JSON strings\n * - Virtual fields: Remove fields with `virtual: true` (pure virtual fields should never be saved)\n * - Timestamps: Add updatedAt (always), and createdAt (when createdAt=true)\n * - publishedLocale: Transform to localizeStatus format (when publishedLocale is provided)\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  options?: DataToContentAPIOptions,\n): DataWithOperations {\n  if (!data || typeof data !== 'object') {\n    return data as DataWithOperations\n  }\n\n  // Transform publishedLocale to localizeStatus format before other transformations\n  const dataWithLocalizedStatus = transformToLocalizeStatus(\n    data as Record<string, unknown>,\n    options?.publishedLocale,\n  )\n\n  // Deep clone to avoid mutating original data\n  const transformed = JSON.parse(JSON.stringify(dataWithLocalizedStatus))\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  // Apply static defaults recursively to handle nested structures (arrays, groups)\n  // This must happen before traverseFields to ensure defaults are in place\n  if (options?.applyDefaults) {\n    applyDefaults(transformed, collectionConfig.fields)\n  }\n\n  // Use Payload's traverseFields to iterate over all fields for transformations\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    let value = current[field.name]\n\n    // Transform existing values\n    if (value !== null && value !== undefined) {\n      // Step 1: Apply type casting (e.g., number -> string for text fields)\n      value = castFieldValue(field, value)\n      current[field.name] = value\n\n      // Step 2: Apply Content API specific transformations\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, fillEmpty: false, ref: transformed })\n\n  stripFields({\n    config: payload.config,\n    data: transformed,\n    fields: flattenAllFields({ cache: true, fields: collectionConfig.fields }),\n    reservedKeys: ['id', 'globalType'],\n  })\n\n  removeVirtualFields(transformed, collectionConfig.fields)\n\n  // Convert numeric ID to string for Content API\n  const customIDType = payload.collections?.[collectionSlug]?.customIDType\n  if (customIDType === 'number') {\n    transformed.id = String(transformed.id)\n  }\n\n  // Add timestamps (Content API no longer auto-sets these in DB)\n  // updatedAt is always set, createdAt only on create operations\n  const now = new Date().toISOString()\n  transformed.updatedAt = now\n  if (options?.createdAt) {\n    transformed.createdAt = now\n  }\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 * - Virtual fields: Remove fields with `virtual: true` (should not be in DB but Content API backend may add them)\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    // Normalize undefined → null for optional fields\n    // Content API may omit fields (undefined) but Payload expects null for optional fields\n    if (value === undefined) {\n      const isRequired = 'required' in field && field.required\n      if (!isRequired) {\n        current[field.name] = null\n      }\n      return\n    }\n\n    if (value !== null) {\n      // Localized fields: JSON string -> parsed object\n      // Content API may store localized fields as JSON strings like \"{\\\"en\\\":\\\"value\\\"}\"\n      // so we need to parse them back to objects.\n      // Note: We return the full locale object - Payload Core handles flattening to requested locale.\n      // When requesting a specific locale (not 'all'), values are simple strings that won't parse.\n      // In that case, we silently keep the original value.\n      if ('localized' in field && field.localized && typeof value === 'string') {\n        try {\n          const parsed = JSON.parse(value)\n          // Only use parsed value if it's actually an object (locale -> value mapping)\n          // Simple strings like \"EN Title\" would parse to themselves, which we don't want\n          if (typeof parsed === 'object' && parsed !== null) {\n            current[field.name] = parsed\n          }\n        } catch {\n          // Not valid JSON - keep original value (this is expected for single-locale requests)\n        }\n      }\n      // RichText: JSON string -> object\n      else 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, fillEmpty: false, ref: transformed })\n\n  // Convert string ID to number if collection uses numeric custom ID\n  const customIDType = payload.collections?.[collectionSlug]?.customIDType\n  if (customIDType === 'number') {\n    transformed.id = Number(transformed.id)\n  }\n\n  stripFields({\n    config: payload.config,\n    data: transformed,\n    fields: flattenAllFields({ cache: true, fields: collectionConfig.fields }),\n    reservedKeys: ['id', 'globalType'],\n  })\n\n  // Remove virtual fields - must happen AFTER stripFields\n  removeVirtualFields(transformed, collectionConfig.fields)\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)) {\n        transformed[fieldName] = null\n      }\n    }\n  }\n\n  return transformed\n}\n"],"names":["flattenAllFields","traverseFields","applyDefaults","castFieldValue","removeVirtualFields","stripFields","transformToLocalizeStatus","dataToContentAPI","payload","collectionSlug","data","options","dataWithLocalizedStatus","publishedLocale","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","fillEmpty","cache","reservedKeys","customIDType","id","String","now","Date","toISOString","updatedAt","createdAt","dataFromContentAPI","parentPath","isRequired","required","localized","parsed","error","fieldPath","logger","warn","err","Error","msg","Number","auth","authFields","fieldName"],"mappings":"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"}

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

@@ -0,0 +1,23 @@
+/**
+ * Transform publishedLocale to localizeStatus format
+ *
+ * publishedLocale is a legacy API that is going to be removed in Payload v4 in favor of localizeStatus.
+ * The db-adapter transforms publishedLocale here so Content API doesn't need to know about it.
+ */
+type VersionData = Record<string, unknown>;
+/**
+ * Transforms version data to use localizeStatus format
+ *
+ * If `publishedLocale` is provided and `_status` is a string, transforms to object format.
+ * If `_status` is already an object, leaves it unchanged.
+ *
+ * @example
+ * // Input (old format):
+ * { _status: 'published', text: 'Hello' }, publishedLocale: 'en'
+ *
+ * // Output (new format):
+ * { _status: { en: 'published' }, text: 'Hello' }
+ */
+export declare function transformToLocalizeStatus(versionData: VersionData, publishedLocale?: string): VersionData;
+export {};
+//# sourceMappingURL=transformPublishedLocale.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transformPublishedLocale.d.ts","sourceRoot":"","sources":["../../../../src/db-content-api/utilities/data/transformPublishedLocale.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,KAAK,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAE1C;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,WAAW,EACxB,eAAe,CAAC,EAAE,MAAM,GACvB,WAAW,CA0Bb"}

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

@@ -0,0 +1,42 @@
+/**
+ * Transform publishedLocale to localizeStatus format
+ *
+ * publishedLocale is a legacy API that is going to be removed in Payload v4 in favor of localizeStatus.
+ * The db-adapter transforms publishedLocale here so Content API doesn't need to know about it.
+ */ /**
+ * Transforms version data to use localizeStatus format
+ *
+ * If `publishedLocale` is provided and `_status` is a string, transforms to object format.
+ * If `_status` is already an object, leaves it unchanged.
+ *
+ * @example
+ * // Input (old format):
+ * { _status: 'published', text: 'Hello' }, publishedLocale: 'en'
+ *
+ * // Output (new format):
+ * { _status: { en: 'published' }, text: 'Hello' }
+ */ export function transformToLocalizeStatus(versionData, publishedLocale) {
+    // No publishedLocale provided - no transformation needed
+    if (!publishedLocale) {
+        return versionData;
+    }
+    const status = versionData._status;
+    // If _status is already an object (localizeStatus format), return as-is
+    if (typeof status === 'object' && status !== null) {
+        return versionData;
+    }
+    // Transform: publishedLocale + string status → object status
+    if (typeof status === 'string') {
+        // Only the specified locale gets the status, others remain undefined
+        // (Content API / Payload will handle merging with existing locale statuses)
+        return {
+            ...versionData,
+            _status: {
+                [publishedLocale]: status
+            }
+        };
+    }
+    return versionData;
+}
+
+//# sourceMappingURL=transformPublishedLocale.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/db-content-api/utilities/data/transformPublishedLocale.ts"],"sourcesContent":["/**\n * Transform publishedLocale to localizeStatus format\n *\n * publishedLocale is a legacy API that is going to be removed in Payload v4 in favor of localizeStatus.\n * The db-adapter transforms publishedLocale here so Content API doesn't need to know about it.\n */\n\ntype VersionData = Record<string, unknown>\n\n/**\n * Transforms version data to use localizeStatus format\n *\n * If `publishedLocale` is provided and `_status` is a string, transforms to object format.\n * If `_status` is already an object, leaves it unchanged.\n *\n * @example\n * // Input (old format):\n * { _status: 'published', text: 'Hello' }, publishedLocale: 'en'\n *\n * // Output (new format):\n * { _status: { en: 'published' }, text: 'Hello' }\n */\nexport function transformToLocalizeStatus(\n  versionData: VersionData,\n  publishedLocale?: string,\n): VersionData {\n  // No publishedLocale provided - no transformation needed\n  if (!publishedLocale) {\n    return versionData\n  }\n\n  const status = versionData._status\n\n  // If _status is already an object (localizeStatus format), return as-is\n  if (typeof status === 'object' && status !== null) {\n    return versionData\n  }\n\n  // Transform: publishedLocale + string status → object status\n  if (typeof status === 'string') {\n    // Only the specified locale gets the status, others remain undefined\n    // (Content API / Payload will handle merging with existing locale statuses)\n    return {\n      ...versionData,\n      _status: {\n        [publishedLocale]: status,\n      },\n    }\n  }\n\n  return versionData\n}\n"],"names":["transformToLocalizeStatus","versionData","publishedLocale","status","_status"],"mappings":"AAAA;;;;;CAKC,GAID;;;;;;;;;;;;CAYC,GACD,OAAO,SAASA,0BACdC,WAAwB,EACxBC,eAAwB;IAExB,yDAAyD;IACzD,IAAI,CAACA,iBAAiB;QACpB,OAAOD;IACT;IAEA,MAAME,SAASF,YAAYG,OAAO;IAElC,wEAAwE;IACxE,IAAI,OAAOD,WAAW,YAAYA,WAAW,MAAM;QACjD,OAAOF;IACT;IAEA,6DAA6D;IAC7D,IAAI,OAAOE,WAAW,UAAU;QAC9B,qEAAqE;QACrE,4EAA4E;QAC5E,OAAO;YACL,GAAGF,WAAW;YACdG,SAAS;gBACP,CAACF,gBAAgB,EAAEC;YACrB;QACF;IACF;IAEA,OAAOF;AACT"}

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

@@ -1 +1 @@
-{"version":3,"file":"buildLocalizedPaths.d.ts","sourceRoot":"","sources":["../../../../src/db-content-api/utilities/meta/buildLocalizedPaths.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAS,OAAO,EAAE,MAAM,SAAS,CAAA;AAE7C;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,EAAE,CAStF"}
+{"version":3,"file":"buildLocalizedPaths.d.ts","sourceRoot":"","sources":["../../../../src/db-content-api/utilities/meta/buildLocalizedPaths.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAS,OAAO,EAAE,MAAM,SAAS,CAAA;AAE7C;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,EAAE,CAsCtF"}

package/dist/db-content-api/utilities/meta/buildLocalizedPaths.js

@@ -12,6 +12,17 @@
     }
     const localizedPaths = [];
     traverseFields(collectionConfig.fields, localizedPaths);
+    // Add _status to localized paths if localizeStatus is enabled for this collection
+    // _status is a base field added by Payload when versions.drafts is enabled,
+    // and it becomes localized when versions.drafts.localizeStatus is true
+    // localizeStatus requires both experimental flag AND collection-level config
+    const experimentalLocalizeStatus = 'experimental' in payload.config && payload.config.experimental && typeof payload.config.experimental === 'object' && 'localizeStatus' in payload.config.experimental && payload.config.experimental.localizeStatus === true;
+    const drafts = collectionConfig.versions && typeof collectionConfig.versions === 'object' ? collectionConfig.versions.drafts : false;
+    const collectionLocalizeStatus = drafts && typeof drafts === 'object' && 'localizeStatus' in drafts && drafts.localizeStatus === true;
+    const hasLocalizeStatus = payload.config.localization && experimentalLocalizeStatus && collectionLocalizeStatus;
+    if (hasLocalizeStatus && !localizedPaths.includes('_status')) {
+        localizedPaths.push('_status');
+    }
     return localizedPaths;
 }
 /** Recursively traverses fields to find and collect localized paths */ function traverseFields(fields, localizedPaths, parentPath = '', parentIsLocalized = false) {

package/dist/db-content-api/utilities/meta/buildLocalizedPaths.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/db-content-api/utilities/meta/buildLocalizedPaths.ts"],"sourcesContent":["import type { Field, Payload } from 'payload'\n\n/**\n * Extracts all localized field paths from a collection's field configuration.\n * Recursively traverses nested structures (groups, arrays, blocks, tabs) to find fields marked as localized.\n *\n * @param payload - The Payload instance containing collection configurations\n * @param collectionSlug - The slug of the collection to extract localized paths from\n * @returns Array of dot-notation paths to localized fields (e.g., ['title', 'metadata.description'])\n */\nexport function buildLocalizedPaths(payload: Payload, collectionSlug: string): string[] {\n  const collectionConfig = payload.config.collections.find((c) => c.slug === collectionSlug)\n  if (!collectionConfig) {\n    return []\n  }\n\n  const localizedPaths: string[] = []\n  traverseFields(collectionConfig.fields, localizedPaths)\n  return localizedPaths\n}\n\n/** Recursively traverses fields to find and collect localized paths */\nfunction traverseFields(\n  fields: Field[],\n  localizedPaths: string[],\n  parentPath = '',\n  parentIsLocalized = false,\n): void {\n  for (const field of fields) {\n    // Only field types that have names can support localization\n    // See: https://payloadcms.com/docs/configuration/localization\n    //\n    // This will skip presentational fields like ui, collapsible, row, tabs (if unnamed), groups (if unnamed)\n    // which do not store data in the database and thus are not relevant for querying localized paths\n    // See: https://payloadcms.com/docs/fields/overview#presentational-fields\n    if (!('name' in field)) {\n      continue\n    }\n\n    const fieldPath = buildPath(parentPath, field.name)\n    const isLocalized = 'localized' in field && field.localized === true\n    const includeNestedPaths = isLocalized || parentIsLocalized\n\n    // Add field to results if localized or parent is localized\n    if (includeNestedPaths) {\n      localizedPaths.push(fieldPath)\n    }\n\n    // Handle blocks field - has a special 'blocks' array structure and each block has its own nested fields\n    if (field.type === 'blocks' && 'blocks' in field) {\n      for (const block of field.blocks) {\n        if ('fields' in block) {\n          traverseFields(block.fields, localizedPaths, fieldPath, includeNestedPaths)\n        }\n      }\n      continue\n    }\n\n    // Handle field type that support nested fields\n    // Recursively handle nested structures (groups, arrays, tab, etc)\n    if ('fields' in field) {\n      traverseFields(field.fields, localizedPaths, fieldPath, includeNestedPaths)\n    }\n  }\n}\n\n/** Builds a dot-notation path from parent path and field name */\nfunction buildPath(parentPath: string, fieldName: string): string {\n  return parentPath ? `${parentPath}.${fieldName}` : fieldName\n}\n"],"names":["buildLocalizedPaths","payload","collectionSlug","collectionConfig","config","collections","find","c","slug","localizedPaths","traverseFields","fields","parentPath","parentIsLocalized","field","fieldPath","buildPath","name","isLocalized","localized","includeNestedPaths","push","type","block","blocks","fieldName"],"mappings":"AAEA;;;;;;;CAOC,GACD,OAAO,SAASA,oBAAoBC,OAAgB,EAAEC,cAAsB;IAC1E,MAAMC,mBAAmBF,QAAQG,MAAM,CAACC,WAAW,CAACC,IAAI,CAAC,CAACC,IAAMA,EAAEC,IAAI,KAAKN;IAC3E,IAAI,CAACC,kBAAkB;QACrB,OAAO,EAAE;IACX;IAEA,MAAMM,iBAA2B,EAAE;IACnCC,eAAeP,iBAAiBQ,MAAM,EAAEF;IACxC,OAAOA;AACT;AAEA,qEAAqE,GACrE,SAASC,eACPC,MAAe,EACfF,cAAwB,EACxBG,aAAa,EAAE,EACfC,oBAAoB,KAAK;IAEzB,KAAK,MAAMC,SAASH,OAAQ;QAC1B,4DAA4D;QAC5D,8DAA8D;QAC9D,EAAE;QACF,yGAAyG;QACzG,iGAAiG;QACjG,yEAAyE;QACzE,IAAI,CAAE,CAAA,UAAUG,KAAI,GAAI;YACtB;QACF;QAEA,MAAMC,YAAYC,UAAUJ,YAAYE,MAAMG,IAAI;QAClD,MAAMC,cAAc,eAAeJ,SAASA,MAAMK,SAAS,KAAK;QAChE,MAAMC,qBAAqBF,eAAeL;QAE1C,2DAA2D;QAC3D,IAAIO,oBAAoB;YACtBX,eAAeY,IAAI,CAACN;QACtB;QAEA,wGAAwG;QACxG,IAAID,MAAMQ,IAAI,KAAK,YAAY,YAAYR,OAAO;YAChD,KAAK,MAAMS,SAAST,MAAMU,MAAM,CAAE;gBAChC,IAAI,YAAYD,OAAO;oBACrBb,eAAea,MAAMZ,MAAM,EAAEF,gBAAgBM,WAAWK;gBAC1D;YACF;YACA;QACF;QAEA,+CAA+C;QAC/C,kEAAkE;QAClE,IAAI,YAAYN,OAAO;YACrBJ,eAAeI,MAAMH,MAAM,EAAEF,gBAAgBM,WAAWK;QAC1D;IACF;AACF;AAEA,+DAA+D,GAC/D,SAASJ,UAAUJ,UAAkB,EAAEa,SAAiB;IACtD,OAAOb,aAAa,GAAGA,WAAW,CAAC,EAAEa,WAAW,GAAGA;AACrD"}
+{"version":3,"sources":["../../../../src/db-content-api/utilities/meta/buildLocalizedPaths.ts"],"sourcesContent":["import type { Field, Payload } from 'payload'\n\n/**\n * Extracts all localized field paths from a collection's field configuration.\n * Recursively traverses nested structures (groups, arrays, blocks, tabs) to find fields marked as localized.\n *\n * @param payload - The Payload instance containing collection configurations\n * @param collectionSlug - The slug of the collection to extract localized paths from\n * @returns Array of dot-notation paths to localized fields (e.g., ['title', 'metadata.description'])\n */\nexport function buildLocalizedPaths(payload: Payload, collectionSlug: string): string[] {\n  const collectionConfig = payload.config.collections.find((c) => c.slug === collectionSlug)\n  if (!collectionConfig) {\n    return []\n  }\n\n  const localizedPaths: string[] = []\n  traverseFields(collectionConfig.fields, localizedPaths)\n\n  // Add _status to localized paths if localizeStatus is enabled for this collection\n  // _status is a base field added by Payload when versions.drafts is enabled,\n  // and it becomes localized when versions.drafts.localizeStatus is true\n  // localizeStatus requires both experimental flag AND collection-level config\n  const experimentalLocalizeStatus =\n    'experimental' in payload.config &&\n    payload.config.experimental &&\n    typeof payload.config.experimental === 'object' &&\n    'localizeStatus' in payload.config.experimental &&\n    payload.config.experimental.localizeStatus === true\n\n  const drafts =\n    collectionConfig.versions && typeof collectionConfig.versions === 'object'\n      ? collectionConfig.versions.drafts\n      : false\n  const collectionLocalizeStatus =\n    drafts &&\n    typeof drafts === 'object' &&\n    'localizeStatus' in drafts &&\n    drafts.localizeStatus === true\n\n  const hasLocalizeStatus =\n    payload.config.localization && experimentalLocalizeStatus && collectionLocalizeStatus\n\n  if (hasLocalizeStatus && !localizedPaths.includes('_status')) {\n    localizedPaths.push('_status')\n  }\n\n  return localizedPaths\n}\n\n/** Recursively traverses fields to find and collect localized paths */\nfunction traverseFields(\n  fields: Field[],\n  localizedPaths: string[],\n  parentPath = '',\n  parentIsLocalized = false,\n): void {\n  for (const field of fields) {\n    // Only field types that have names can support localization\n    // See: https://payloadcms.com/docs/configuration/localization\n    //\n    // This will skip presentational fields like ui, collapsible, row, tabs (if unnamed), groups (if unnamed)\n    // which do not store data in the database and thus are not relevant for querying localized paths\n    // See: https://payloadcms.com/docs/fields/overview#presentational-fields\n    if (!('name' in field)) {\n      continue\n    }\n\n    const fieldPath = buildPath(parentPath, field.name)\n    const isLocalized = 'localized' in field && field.localized === true\n    const includeNestedPaths = isLocalized || parentIsLocalized\n\n    // Add field to results if localized or parent is localized\n    if (includeNestedPaths) {\n      localizedPaths.push(fieldPath)\n    }\n\n    // Handle blocks field - has a special 'blocks' array structure and each block has its own nested fields\n    if (field.type === 'blocks' && 'blocks' in field) {\n      for (const block of field.blocks) {\n        if ('fields' in block) {\n          traverseFields(block.fields, localizedPaths, fieldPath, includeNestedPaths)\n        }\n      }\n      continue\n    }\n\n    // Handle field type that support nested fields\n    // Recursively handle nested structures (groups, arrays, tab, etc)\n    if ('fields' in field) {\n      traverseFields(field.fields, localizedPaths, fieldPath, includeNestedPaths)\n    }\n  }\n}\n\n/** Builds a dot-notation path from parent path and field name */\nfunction buildPath(parentPath: string, fieldName: string): string {\n  return parentPath ? `${parentPath}.${fieldName}` : fieldName\n}\n"],"names":["buildLocalizedPaths","payload","collectionSlug","collectionConfig","config","collections","find","c","slug","localizedPaths","traverseFields","fields","experimentalLocalizeStatus","experimental","localizeStatus","drafts","versions","collectionLocalizeStatus","hasLocalizeStatus","localization","includes","push","parentPath","parentIsLocalized","field","fieldPath","buildPath","name","isLocalized","localized","includeNestedPaths","type","block","blocks","fieldName"],"mappings":"AAEA;;;;;;;CAOC,GACD,OAAO,SAASA,oBAAoBC,OAAgB,EAAEC,cAAsB;IAC1E,MAAMC,mBAAmBF,QAAQG,MAAM,CAACC,WAAW,CAACC,IAAI,CAAC,CAACC,IAAMA,EAAEC,IAAI,KAAKN;IAC3E,IAAI,CAACC,kBAAkB;QACrB,OAAO,EAAE;IACX;IAEA,MAAMM,iBAA2B,EAAE;IACnCC,eAAeP,iBAAiBQ,MAAM,EAAEF;IAExC,kFAAkF;IAClF,4EAA4E;IAC5E,uEAAuE;IACvE,6EAA6E;IAC7E,MAAMG,6BACJ,kBAAkBX,QAAQG,MAAM,IAChCH,QAAQG,MAAM,CAACS,YAAY,IAC3B,OAAOZ,QAAQG,MAAM,CAACS,YAAY,KAAK,YACvC,oBAAoBZ,QAAQG,MAAM,CAACS,YAAY,IAC/CZ,QAAQG,MAAM,CAACS,YAAY,CAACC,cAAc,KAAK;IAEjD,MAAMC,SACJZ,iBAAiBa,QAAQ,IAAI,OAAOb,iBAAiBa,QAAQ,KAAK,WAC9Db,iBAAiBa,QAAQ,CAACD,MAAM,GAChC;IACN,MAAME,2BACJF,UACA,OAAOA,WAAW,YAClB,oBAAoBA,UACpBA,OAAOD,cAAc,KAAK;IAE5B,MAAMI,oBACJjB,QAAQG,MAAM,CAACe,YAAY,IAAIP,8BAA8BK;IAE/D,IAAIC,qBAAqB,CAACT,eAAeW,QAAQ,CAAC,YAAY;QAC5DX,eAAeY,IAAI,CAAC;IACtB;IAEA,OAAOZ;AACT;AAEA,qEAAqE,GACrE,SAASC,eACPC,MAAe,EACfF,cAAwB,EACxBa,aAAa,EAAE,EACfC,oBAAoB,KAAK;IAEzB,KAAK,MAAMC,SAASb,OAAQ;QAC1B,4DAA4D;QAC5D,8DAA8D;QAC9D,EAAE;QACF,yGAAyG;QACzG,iGAAiG;QACjG,yEAAyE;QACzE,IAAI,CAAE,CAAA,UAAUa,KAAI,GAAI;YACtB;QACF;QAEA,MAAMC,YAAYC,UAAUJ,YAAYE,MAAMG,IAAI;QAClD,MAAMC,cAAc,eAAeJ,SAASA,MAAMK,SAAS,KAAK;QAChE,MAAMC,qBAAqBF,eAAeL;QAE1C,2DAA2D;QAC3D,IAAIO,oBAAoB;YACtBrB,eAAeY,IAAI,CAACI;QACtB;QAEA,wGAAwG;QACxG,IAAID,MAAMO,IAAI,KAAK,YAAY,YAAYP,OAAO;YAChD,KAAK,MAAMQ,SAASR,MAAMS,MAAM,CAAE;gBAChC,IAAI,YAAYD,OAAO;oBACrBtB,eAAesB,MAAMrB,MAAM,EAAEF,gBAAgBgB,WAAWK;gBAC1D;YACF;YACA;QACF;QAEA,+CAA+C;QAC/C,kEAAkE;QAClE,IAAI,YAAYN,OAAO;YACrBd,eAAec,MAAMb,MAAM,EAAEF,gBAAgBgB,WAAWK;QAC1D;IACF;AACF;AAEA,+DAA+D,GAC/D,SAASJ,UAAUJ,UAAkB,EAAEY,SAAiB;IACtD,OAAOZ,aAAa,GAAGA,WAAW,CAAC,EAAEY,WAAW,GAAGA;AACrD"}

package/dist/db-content-api/utilities/meta/buildMeta.d.ts

@@ -1,8 +1,22 @@
 import type { Payload, Where } from 'payload';
+import type { components } from '../../generated/content-api-types.js';
+import type { PathTypesRecord } from '../../temp-utilities/types.js';
+/**
+ * Metadata sent to Content API for query processing.
+ *
+ * TODO: This interface is defined here temporarily so Content API can test the integration.
+ * Once Content API implements support for pathTypes with relationship info, this type
+ * should be generated from openapi.json and ContentAPIMeta can be removed.
+ */
 export interface ContentAPIMeta {
     localizedPaths?: string[];
-    pathTypes?: Record<string, 'array'>;
+    pathTypes?: PathTypesRecord;
 }
+/**
+ * The type that Content API currently expects (from generated types).
+ * This is more restrictive than ContentAPIMeta until Content API is updated.
+ */
+type ContentAPIMetaGenerated = components['schemas']['RequestMeta'];
 export interface BuildMetaOptions {
     collection: string;
     locale: string | undefined;
@@ -17,6 +31,7 @@ export interface BuildMetaOptions {
  * @returns Object with meta property ready to spread into request body, or empty object if no meta needed
  */
 export declare function buildMeta(payload: Payload, options: BuildMetaOptions): {
-    meta?: ContentAPIMeta;
+    meta?: ContentAPIMetaGenerated;
 };
+export {};
 //# sourceMappingURL=buildMeta.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"buildMeta.d.ts","sourceRoot":"","sources":["../../../../src/db-content-api/utilities/meta/buildMeta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAK7C,MAAM,WAAW,cAAc;IAC7B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACpC;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,KAAK,CAAC,EAAE,KAAK,CAAA;CACd;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,gBAAgB,GAAG;IAAE,IAAI,CAAC,EAAE,cAAc,CAAA;CAAE,CAoBhG"}
+{"version":3,"file":"buildMeta.d.ts","sourceRoot":"","sources":["../../../../src/db-content-api/utilities/meta/buildMeta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAE7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sCAAsC,CAAA;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAKpE;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB,SAAS,CAAC,EAAE,eAAe,CAAA;CAC5B;AAED;;;GAGG;AACH,KAAK,uBAAuB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,aAAa,CAAC,CAAA;AAEnE,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,KAAK,CAAC,EAAE,KAAK,CAAA;CACd;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CACvB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,gBAAgB,GACxB;IAAE,IAAI,CAAC,EAAE,uBAAuB,CAAA;CAAE,CAuBpC"}

package/dist/db-content-api/utilities/meta/buildMeta.js

@@ -22,8 +22,11 @@ import { buildPathTypes } from './buildPathTypes.js';
             meta.localizedPaths = localizedPaths;
         }
     }
+    // Cast to generated type - Content API will need to be updated to handle
+    // the new pathTypes format with relationship info. Until then, it will
+    // ignore the extra fields but still receive the data for testing.
     return Object.keys(meta).length > 0 ? {
-        meta
+        meta: meta
     } : {};
 }
 

package/dist/db-content-api/utilities/meta/buildMeta.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/db-content-api/utilities/meta/buildMeta.ts"],"sourcesContent":["import type { Payload, Where } from 'payload'\n\nimport { buildLocalizedPaths } from './buildLocalizedPaths.js'\nimport { buildPathTypes } from './buildPathTypes.js'\n\nexport interface ContentAPIMeta {\n  localizedPaths?: string[]\n  pathTypes?: Record<string, 'array'>\n}\n\nexport interface BuildMetaOptions {\n  collection: string\n  locale: string | undefined\n  where?: Where\n}\n\n/**\n * Builds the `meta` object for Content API requests.\n * Combines pathTypes (for array field handling) and localizedPaths (for locale queries).\n *\n * @param payload - The Payload instance\n * @param options - Options including collection slug, locale, and where clause\n * @returns Object with meta property ready to spread into request body, or empty object if no meta needed\n */\nexport function buildMeta(payload: Payload, options: BuildMetaOptions): { meta?: ContentAPIMeta } {\n  const { collection, locale, where } = options\n\n  const meta: ContentAPIMeta = {}\n\n  // Add pathTypes if there are array fields in the where clause\n  const pathTypes = buildPathTypes(payload, collection, where)\n  if (Object.keys(pathTypes).length > 0) {\n    meta.pathTypes = pathTypes\n  }\n\n  // Add localizedPaths if locale is specified (but not 'all')\n  if (locale && locale !== 'all') {\n    const localizedPaths = buildLocalizedPaths(payload, collection)\n    if (localizedPaths.length > 0) {\n      meta.localizedPaths = localizedPaths\n    }\n  }\n\n  return Object.keys(meta).length > 0 ? { meta } : {}\n}\n"],"names":["buildLocalizedPaths","buildPathTypes","buildMeta","payload","options","collection","locale","where","meta","pathTypes","Object","keys","length","localizedPaths"],"mappings":"AAEA,SAASA,mBAAmB,QAAQ,2BAA0B;AAC9D,SAASC,cAAc,QAAQ,sBAAqB;AAapD;;;;;;;CAOC,GACD,OAAO,SAASC,UAAUC,OAAgB,EAAEC,OAAyB;IACnE,MAAM,EAAEC,UAAU,EAAEC,MAAM,EAAEC,KAAK,EAAE,GAAGH;IAEtC,MAAMI,OAAuB,CAAC;IAE9B,8DAA8D;IAC9D,MAAMC,YAAYR,eAAeE,SAASE,YAAYE;IACtD,IAAIG,OAAOC,IAAI,CAACF,WAAWG,MAAM,GAAG,GAAG;QACrCJ,KAAKC,SAAS,GAAGA;IACnB;IAEA,4DAA4D;IAC5D,IAAIH,UAAUA,WAAW,OAAO;QAC9B,MAAMO,iBAAiBb,oBAAoBG,SAASE;QACpD,IAAIQ,eAAeD,MAAM,GAAG,GAAG;YAC7BJ,KAAKK,cAAc,GAAGA;QACxB;IACF;IAEA,OAAOH,OAAOC,IAAI,CAACH,MAAMI,MAAM,GAAG,IAAI;QAAEJ;IAAK,IAAI,CAAC;AACpD"}
+{"version":3,"sources":["../../../../src/db-content-api/utilities/meta/buildMeta.ts"],"sourcesContent":["import type { Payload, Where } from 'payload'\n\nimport type { components } from '../../generated/content-api-types.js'\nimport type { PathTypesRecord } from '../../temp-utilities/types.js'\n\nimport { buildLocalizedPaths } from './buildLocalizedPaths.js'\nimport { buildPathTypes } from './buildPathTypes.js'\n\n/**\n * Metadata sent to Content API for query processing.\n *\n * TODO: This interface is defined here temporarily so Content API can test the integration.\n * Once Content API implements support for pathTypes with relationship info, this type\n * should be generated from openapi.json and ContentAPIMeta can be removed.\n */\nexport interface ContentAPIMeta {\n  localizedPaths?: string[]\n  pathTypes?: PathTypesRecord\n}\n\n/**\n * The type that Content API currently expects (from generated types).\n * This is more restrictive than ContentAPIMeta until Content API is updated.\n */\ntype ContentAPIMetaGenerated = components['schemas']['RequestMeta']\n\nexport interface BuildMetaOptions {\n  collection: string\n  locale: string | undefined\n  where?: Where\n}\n\n/**\n * Builds the `meta` object for Content API requests.\n * Combines pathTypes (for array field handling) and localizedPaths (for locale queries).\n *\n * @param payload - The Payload instance\n * @param options - Options including collection slug, locale, and where clause\n * @returns Object with meta property ready to spread into request body, or empty object if no meta needed\n */\nexport function buildMeta(\n  payload: Payload,\n  options: BuildMetaOptions,\n): { meta?: ContentAPIMetaGenerated } {\n  const { collection, locale, where } = options\n\n  const meta: ContentAPIMeta = {}\n\n  // Add pathTypes if there are array fields in the where clause\n  const pathTypes = buildPathTypes(payload, collection, where)\n  if (Object.keys(pathTypes).length > 0) {\n    meta.pathTypes = pathTypes\n  }\n\n  // Add localizedPaths if locale is specified (but not 'all')\n  if (locale && locale !== 'all') {\n    const localizedPaths = buildLocalizedPaths(payload, collection)\n    if (localizedPaths.length > 0) {\n      meta.localizedPaths = localizedPaths\n    }\n  }\n\n  // Cast to generated type - Content API will need to be updated to handle\n  // the new pathTypes format with relationship info. Until then, it will\n  // ignore the extra fields but still receive the data for testing.\n  return Object.keys(meta).length > 0 ? { meta: meta as unknown as ContentAPIMetaGenerated } : {}\n}\n"],"names":["buildLocalizedPaths","buildPathTypes","buildMeta","payload","options","collection","locale","where","meta","pathTypes","Object","keys","length","localizedPaths"],"mappings":"AAKA,SAASA,mBAAmB,QAAQ,2BAA0B;AAC9D,SAASC,cAAc,QAAQ,sBAAqB;AA0BpD;;;;;;;CAOC,GACD,OAAO,SAASC,UACdC,OAAgB,EAChBC,OAAyB;IAEzB,MAAM,EAAEC,UAAU,EAAEC,MAAM,EAAEC,KAAK,EAAE,GAAGH;IAEtC,MAAMI,OAAuB,CAAC;IAE9B,8DAA8D;IAC9D,MAAMC,YAAYR,eAAeE,SAASE,YAAYE;IACtD,IAAIG,OAAOC,IAAI,CAACF,WAAWG,MAAM,GAAG,GAAG;QACrCJ,KAAKC,SAAS,GAAGA;IACnB;IAEA,4DAA4D;IAC5D,IAAIH,UAAUA,WAAW,OAAO;QAC9B,MAAMO,iBAAiBb,oBAAoBG,SAASE;QACpD,IAAIQ,eAAeD,MAAM,GAAG,GAAG;YAC7BJ,KAAKK,cAAc,GAAGA;QACxB;IACF;IAEA,yEAAyE;IACzE,uEAAuE;IACvE,kEAAkE;IAClE,OAAOH,OAAOC,IAAI,CAACH,MAAMI,MAAM,GAAG,IAAI;QAAEJ,MAAMA;IAA2C,IAAI,CAAC;AAChG"}

package/dist/db-content-api/utilities/meta/buildPathTypes.d.ts

@@ -1,7 +1,13 @@
 import type { Payload, Where } from 'payload';
+import type { PathTypesRecord } from '../../temp-utilities/types.js';
 /**
  * Builds pathTypes metadata for Content API request.
- * Returns a record of paths that are arrays for proper query generation.
+ * Returns a record of paths with their types for proper query generation.
+ *
+ * Includes:
+ * - Array fields (type: "array")
+ * - Relationship fields (type: { type: "relationship", collection, hasMany })
+ * - Join fields (type: { type: "join", collection, hasMany, on })
  */
-export declare function buildPathTypes(payload: Payload, collectionSlug: string, where: undefined | Where): Record<string, 'array'>;
+export declare function buildPathTypes(payload: Payload, collectionSlug: string, where: undefined | Where): PathTypesRecord;
 //# sourceMappingURL=buildPathTypes.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"buildPathTypes.d.ts","sourceRoot":"","sources":["../../../../src/db-content-api/utilities/meta/buildPathTypes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAS,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AA8JpD;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,OAAO,EAChB,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,SAAS,GAAG,KAAK,GACvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA0BzB"}
+{"version":3,"file":"buildPathTypes.d.ts","sourceRoot":"","sources":["../../../../src/db-content-api/utilities/meta/buildPathTypes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAS,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAEpD,OAAO,KAAK,EAAE,eAAe,EAAiB,MAAM,+BAA+B,CAAA;AAuKnF;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,OAAO,EAChB,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,SAAS,GAAG,KAAK,GACvB,eAAe,CAgCjB"}

package/dist/db-content-api/utilities/meta/buildPathTypes.js

@@ -35,7 +35,8 @@
     return paths;
 }
 /**
- * Determines the type of a field based on its configuration
+ * Determines the type of a field based on its configuration.
+ * Returns PathTypeValue for fields that need special handling in Content API queries.
  */ function getFieldType(field) {
     // Array field
     if (field.type === 'array') {
@@ -45,18 +46,38 @@
     if (field.type === 'blocks') {
         return 'array';
     }
-    // Relationship field with hasMany (array)
-    if (field.type === 'relationship' && 'hasMany' in field && field.hasMany) {
-        return 'array';
+    // Relationship field - always include for JOIN support
+    if (field.type === 'relationship') {
+        const { hasMany = false, relationTo: collection } = field;
+        return {
+            type: 'relationship',
+            collection,
+            hasMany
+        };
+    }
+    // Upload field - treated like relationship
+    if (field.type === 'upload') {
+        const { hasMany = false, relationTo: collection } = field;
+        return {
+            type: 'relationship',
+            collection,
+            hasMany
+        };
+    }
+    // Join field - virtual reverse lookup
+    if (field.type === 'join') {
+        const { collection, on } = field;
+        return {
+            type: 'join',
+            collection,
+            hasMany: true,
+            on
+        };
     }
     // Select field with hasMany (array)
     if (field.type === 'select' && 'hasMany' in field && field.hasMany) {
         return 'array';
     }
-    // Upload field with hasMany (array)
-    if (field.type === 'upload' && 'hasMany' in field && field.hasMany) {
-        return 'array';
-    }
     // Objects (group, collapsible, row, tabs) don't need traversal
     return null;
 }
@@ -124,7 +145,12 @@
 }
 /**
  * Builds pathTypes metadata for Content API request.
- * Returns a record of paths that are arrays for proper query generation.
+ * Returns a record of paths with their types for proper query generation.
+ *
+ * Includes:
+ * - Array fields (type: "array")
+ * - Relationship fields (type: { type: "relationship", collection, hasMany })
+ * - Join fields (type: { type: "join", collection, hasMany, on })
  */ export function buildPathTypes(payload, collectionSlug, where) {
     if (!where) {
         return {};
@@ -132,14 +158,18 @@
     const pathTypes = {};
     const paths = extractPathsFromWhere(where);
     for (const path of paths){
-        // For each path, we need to check all segments to see if any intermediate ones are arrays/objects
+        // For each path, we need to check all segments to see if any intermediate ones are arrays/relationships
         const segments = path.split('.');
         for(let i = 0; i < segments.length; i++){
             const partialPath = segments.slice(0, i + 1).join('.');
+            // Skip if we already have this path
+            if (partialPath in pathTypes) {
+                continue;
+            }
             const field = findFieldByPath(payload, collectionSlug, partialPath);
             if (field) {
                 const fieldType = getFieldType(field);
-                if (fieldType === 'array') {
+                if (fieldType !== null) {
                     pathTypes[partialPath] = fieldType;
                 }
             }

package/dist/db-content-api/utilities/meta/buildPathTypes.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/db-content-api/utilities/meta/buildPathTypes.ts"],"sourcesContent":["import type { Field, Payload, Where } from 'payload'\n\n/**\n * Extracts all field paths from a where clause recursively\n */\nfunction extractPathsFromWhere(where: Where, paths: Set<string> = new Set()): Set<string> {\n  if (!where || typeof where !== 'object') {\n    return paths\n  }\n\n  // Handle 'and' operator\n  if ('and' in where && Array.isArray(where.and)) {\n    for (const clause of where.and) {\n      extractPathsFromWhere(clause, paths)\n    }\n    return paths\n  }\n\n  // Handle 'or' operator\n  if ('or' in where && Array.isArray(where.or)) {\n    for (const clause of where.or) {\n      extractPathsFromWhere(clause, paths)\n    }\n    return paths\n  }\n\n  // Handle regular conditions - keys are field paths\n  for (const key in where) {\n    if (key === 'and' || key === 'or') {\n      continue\n    }\n\n    // Add the path\n    paths.add(key)\n\n    // Check if the value is a nested where clause (for relationships)\n    const value = where[key]\n    if (value && typeof value === 'object' && !('equals' in value) && !('in' in value)) {\n      // Might be a nested where, recurse\n      extractPathsFromWhere(value as Where, paths)\n    }\n  }\n\n  return paths\n}\n\n/**\n * Determines the type of a field based on its configuration\n */\nfunction getFieldType(field: Field): 'array' | null {\n  // Array field\n  if (field.type === 'array') {\n    return 'array'\n  }\n\n  // Blocks field (array of objects)\n  if (field.type === 'blocks') {\n    return 'array'\n  }\n\n  // Relationship field with hasMany (array)\n  if (field.type === 'relationship' && 'hasMany' in field && field.hasMany) {\n    return 'array'\n  }\n\n  // Select field with hasMany (array)\n  if (field.type === 'select' && 'hasMany' in field && field.hasMany) {\n    return 'array'\n  }\n\n  // Upload field with hasMany (array)\n  if (field.type === 'upload' && 'hasMany' in field && field.hasMany) {\n    return 'array'\n  }\n\n  // Objects (group, collapsible, row, tabs) don't need traversal\n  return null\n}\n\n/**\n * Finds a field in the collection schema by its path\n * Supports nested paths like \"access.read.users\"\n */\nfunction findFieldByPath(\n  payload: Payload,\n  collectionSlug: string,\n  path: string,\n): Field | undefined {\n  const collectionConfig = payload.config.collections.find((c) => c.slug === collectionSlug)\n  if (!collectionConfig) {\n    return undefined\n  }\n\n  const pathSegments = path.split('.')\n\n  // Walk through the path segments to find the field\n  let currentFields = collectionConfig.fields\n  let currentField: Field | undefined = undefined\n\n  for (let i = 0; i < pathSegments.length; i++) {\n    const segment = pathSegments[i]\n\n    // First try to find a direct match\n    currentField = currentFields.find((f) => 'name' in f && f.name === segment)\n\n    // If not found, check if any unnamed container fields (collapsible, row) contain it\n    if (!currentField) {\n      for (const field of currentFields) {\n        if (!('name' in field) || !field.name) {\n          // This is an unnamed field, check its contents\n          if (\n            ('fields' in field && field.type === 'collapsible') ||\n            ('fields' in field && field.type === 'row')\n          ) {\n            currentField = field.fields.find((f) => 'name' in f && f.name === segment)\n            if (currentField) {\n              break\n            }\n          } else if ('tabs' in field && field.type === 'tabs') {\n            // Check all tabs\n            for (const tab of field.tabs) {\n              currentField = tab.fields.find((f) => 'name' in f && f.name === segment)\n              if (currentField) {\n                break\n              }\n            }\n            if (currentField) {\n              break\n            }\n          }\n        }\n      }\n    }\n\n    if (!currentField) {\n      return undefined\n    }\n\n    // If we're not at the end, get nested fields\n    if (i < pathSegments.length - 1) {\n      if (currentField.type === 'group' && 'fields' in currentField) {\n        currentFields = currentField.fields\n      } else if (currentField.type === 'array' && 'fields' in currentField) {\n        currentFields = currentField.fields\n      } else if (currentField.type === 'blocks' && 'blocks' in currentField) {\n        // For blocks, we can't determine the exact field without knowing the block type\n        // Return the blocks field itself\n        return currentField\n      } else {\n        // Field doesn't have nested fields, can't continue\n        return undefined\n      }\n    }\n  }\n\n  return currentField\n}\n\n/**\n * Builds pathTypes metadata for Content API request.\n * Returns a record of paths that are arrays for proper query generation.\n */\nexport function buildPathTypes(\n  payload: Payload,\n  collectionSlug: string,\n  where: undefined | Where,\n): Record<string, 'array'> {\n  if (!where) {\n    return {}\n  }\n\n  const pathTypes: Record<string, 'array'> = {}\n  const paths = extractPathsFromWhere(where)\n\n  for (const path of paths) {\n    // For each path, we need to check all segments to see if any intermediate ones are arrays/objects\n    const segments = path.split('.')\n\n    for (let i = 0; i < segments.length; i++) {\n      const partialPath = segments.slice(0, i + 1).join('.')\n      const field = findFieldByPath(payload, collectionSlug, partialPath)\n\n      if (field) {\n        const fieldType = getFieldType(field)\n        if (fieldType === 'array') {\n          pathTypes[partialPath] = fieldType\n        }\n      }\n    }\n  }\n\n  return pathTypes\n}\n"],"names":["extractPathsFromWhere","where","paths","Set","Array","isArray","and","clause","or","key","add","value","getFieldType","field","type","hasMany","findFieldByPath","payload","collectionSlug","path","collectionConfig","config","collections","find","c","slug","undefined","pathSegments","split","currentFields","fields","currentField","i","length","segment","f","name","tab","tabs","buildPathTypes","pathTypes","segments","partialPath","slice","join","fieldType"],"mappings":"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"}
+{"version":3,"sources":["../../../../src/db-content-api/utilities/meta/buildPathTypes.ts"],"sourcesContent":["import type { Field, Payload, Where } from 'payload'\n\nimport type { PathTypesRecord, PathTypeValue } from '../../temp-utilities/types.js'\n\n/**\n * Extracts all field paths from a where clause recursively\n */\nfunction extractPathsFromWhere(where: Where, paths: Set<string> = new Set()): Set<string> {\n  if (!where || typeof where !== 'object') {\n    return paths\n  }\n\n  // Handle 'and' operator\n  if ('and' in where && Array.isArray(where.and)) {\n    for (const clause of where.and) {\n      extractPathsFromWhere(clause, paths)\n    }\n    return paths\n  }\n\n  // Handle 'or' operator\n  if ('or' in where && Array.isArray(where.or)) {\n    for (const clause of where.or) {\n      extractPathsFromWhere(clause, paths)\n    }\n    return paths\n  }\n\n  // Handle regular conditions - keys are field paths\n  for (const key in where) {\n    if (key === 'and' || key === 'or') {\n      continue\n    }\n\n    // Add the path\n    paths.add(key)\n\n    // Check if the value is a nested where clause (for relationships)\n    const value = where[key]\n    if (value && typeof value === 'object' && !('equals' in value) && !('in' in value)) {\n      // Might be a nested where, recurse\n      extractPathsFromWhere(value as Where, paths)\n    }\n  }\n\n  return paths\n}\n\n/**\n * Determines the type of a field based on its configuration.\n * Returns PathTypeValue for fields that need special handling in Content API queries.\n */\nfunction getFieldType(field: Field): null | PathTypeValue {\n  // Array field\n  if (field.type === 'array') {\n    return 'array'\n  }\n\n  // Blocks field (array of objects)\n  if (field.type === 'blocks') {\n    return 'array'\n  }\n\n  // Relationship field - always include for JOIN support\n  if (field.type === 'relationship') {\n    const { hasMany = false, relationTo: collection } = field\n    return { type: 'relationship', collection, hasMany }\n  }\n\n  // Upload field - treated like relationship\n  if (field.type === 'upload') {\n    const { hasMany = false, relationTo: collection } = field\n    return { type: 'relationship', collection, hasMany }\n  }\n\n  // Join field - virtual reverse lookup\n  if (field.type === 'join') {\n    const { collection, on } = field\n    return { type: 'join', collection, hasMany: true, on }\n  }\n\n  // Select field with hasMany (array)\n  if (field.type === 'select' && 'hasMany' in field && field.hasMany) {\n    return 'array'\n  }\n\n  // Objects (group, collapsible, row, tabs) don't need traversal\n  return null\n}\n\n/**\n * Finds a field in the collection schema by its path\n * Supports nested paths like \"access.read.users\"\n */\nfunction findFieldByPath(\n  payload: Payload,\n  collectionSlug: string,\n  path: string,\n): Field | undefined {\n  const collectionConfig = payload.config.collections.find((c) => c.slug === collectionSlug)\n  if (!collectionConfig) {\n    return undefined\n  }\n\n  const pathSegments = path.split('.')\n\n  // Walk through the path segments to find the field\n  let currentFields = collectionConfig.fields\n  let currentField: Field | undefined = undefined\n\n  for (let i = 0; i < pathSegments.length; i++) {\n    const segment = pathSegments[i]\n\n    // First try to find a direct match\n    currentField = currentFields.find((f) => 'name' in f && f.name === segment)\n\n    // If not found, check if any unnamed container fields (collapsible, row) contain it\n    if (!currentField) {\n      for (const field of currentFields) {\n        if (!('name' in field) || !field.name) {\n          // This is an unnamed field, check its contents\n          if (\n            ('fields' in field && field.type === 'collapsible') ||\n            ('fields' in field && field.type === 'row')\n          ) {\n            currentField = field.fields.find((f) => 'name' in f && f.name === segment)\n            if (currentField) {\n              break\n            }\n          } else if ('tabs' in field && field.type === 'tabs') {\n            // Check all tabs\n            for (const tab of field.tabs) {\n              currentField = tab.fields.find((f) => 'name' in f && f.name === segment)\n              if (currentField) {\n                break\n              }\n            }\n            if (currentField) {\n              break\n            }\n          }\n        }\n      }\n    }\n\n    if (!currentField) {\n      return undefined\n    }\n\n    // If we're not at the end, get nested fields\n    if (i < pathSegments.length - 1) {\n      if (currentField.type === 'group' && 'fields' in currentField) {\n        currentFields = currentField.fields\n      } else if (currentField.type === 'array' && 'fields' in currentField) {\n        currentFields = currentField.fields\n      } else if (currentField.type === 'blocks' && 'blocks' in currentField) {\n        // For blocks, we can't determine the exact field without knowing the block type\n        // Return the blocks field itself\n        return currentField\n      } else {\n        // Field doesn't have nested fields, can't continue\n        return undefined\n      }\n    }\n  }\n\n  return currentField\n}\n\n/**\n * Builds pathTypes metadata for Content API request.\n * Returns a record of paths with their types for proper query generation.\n *\n * Includes:\n * - Array fields (type: \"array\")\n * - Relationship fields (type: { type: \"relationship\", collection, hasMany })\n * - Join fields (type: { type: \"join\", collection, hasMany, on })\n */\nexport function buildPathTypes(\n  payload: Payload,\n  collectionSlug: string,\n  where: undefined | Where,\n): PathTypesRecord {\n  if (!where) {\n    return {}\n  }\n\n  const pathTypes: PathTypesRecord = {}\n  const paths = extractPathsFromWhere(where)\n\n  for (const path of paths) {\n    // For each path, we need to check all segments to see if any intermediate ones are arrays/relationships\n    const segments = path.split('.')\n\n    for (let i = 0; i < segments.length; i++) {\n      const partialPath = segments.slice(0, i + 1).join('.')\n\n      // Skip if we already have this path\n      if (partialPath in pathTypes) {\n        continue\n      }\n\n      const field = findFieldByPath(payload, collectionSlug, partialPath)\n\n      if (field) {\n        const fieldType = getFieldType(field)\n        if (fieldType !== null) {\n          pathTypes[partialPath] = fieldType\n        }\n      }\n    }\n  }\n\n  return pathTypes\n}\n"],"names":["extractPathsFromWhere","where","paths","Set","Array","isArray","and","clause","or","key","add","value","getFieldType","field","type","hasMany","relationTo","collection","on","findFieldByPath","payload","collectionSlug","path","collectionConfig","config","collections","find","c","slug","undefined","pathSegments","split","currentFields","fields","currentField","i","length","segment","f","name","tab","tabs","buildPathTypes","pathTypes","segments","partialPath","slice","join","fieldType"],"mappings":"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"}

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

@@ -6,6 +6,14 @@ type ConvertOptions = {
     insideLogicalOperator?: boolean;
     /** If true, transform 'parent' field to 'documentId' (used for version queries) */
     parentToDocumentId?: boolean;
+    /**
+     * If true, strip 'version.' prefix from field paths (used for version queries).
+     *
+     * Payload queries version content with paths like 'version._status.en', but Content API
+     * stores version data directly in the 'data' column (not nested under 'version').
+     * The 'version' wrapper is only added in API responses for client compatibility.
+     */
+    stripVersionPrefix?: boolean;
 };
 export declare function convertPayloadWhereToContentAPI(where: undefined | Where, options?: ConvertOptions): WhereClause;
 export {};

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

@@ -1 +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,CA6Hb"}
+{"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;IAC5B;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAC7B,CAAA;AAED,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,SAAS,GAAG,KAAK,EACxB,OAAO,GAAE,cAAmB,GAC3B,WAAW,CAoIb"}

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

@@ -68,6 +68,12 @@ export function convertPayloadWhereToContentAPI(where, options = {}) {
             if (options.parentToDocumentId && key === 'parent') {
                 fieldPath = 'documentId';
             }
+            // Strip 'version.' prefix from field paths for version queries
+            // Payload uses paths like 'version._status.en' but Content API stores version data
+            // directly in the 'data' column, not nested under 'version'
+            if (options.stripVersionPrefix && fieldPath.startsWith('version.')) {
+                fieldPath = fieldPath.slice('version.'.length);
+            }
             // Convert field conditions: { fieldName: { operator: value } }
             // to: { path: fieldName, operator, value }
             // Handle Payload's shorthand: { fieldName: value } → { fieldName: { equals: value } }