@payloadcms/figma 0.0.1-alpha.5 → 0.0.1-alpha.51

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

@@ -0,0 +1,136 @@
+import { addFallbackSort } 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',
+ *     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: '-title',
+ *   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, collectionSlug, joins) {
+    const collectionConfig = payload.config.collections.find((c)=>c.slug === collectionSlug);
+    if (!collectionConfig) {
+        return undefined;
+    }
+    // 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;
+        }
+        // Add fallback sort for the joined collection
+        const sortWithFallback = addFallbackSort(joinQuery.sort, payload, foundJoin.collectionSlug);
+        const contentAPIJoin = {
+            collectionId: foundJoin.collectionSlug,
+            count: joinQuery.count ?? false,
+            on: foundJoin.on,
+            path: joinPath,
+            ...joinQuery.limit !== undefined && {
+                limit: joinQuery.limit
+            },
+            ...offset !== undefined && {
+                offset
+            },
+            ...sortWithFallback && {
+                sort: sortWithFallback
+            },
+            ...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/locale/index.d.ts

@@ -0,0 +1,10 @@
+import type { Payload } from 'payload';
+/**
+ * Determines what locale to send to Content API based on request locale value
+ * and config's defaultLocale.
+ *
+ * If no locale is provided, falls back to the default locale from config.
+ * Returns undefined for 'all' and '*' (special Payload values for returning all locales).
+ */
+export declare function addFallbackLocale(locale: null | string | undefined, payload: Payload): string | undefined;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,21 @@
+/**
+ * Determines what locale to send to Content API based on request locale value
+ * and config's defaultLocale.
+ *
+ * If no locale is provided, falls back to the default locale from config.
+ * Returns undefined for 'all' and '*' (special Payload values for returning all locales).
+ */ export function addFallbackLocale(locale, payload) {
+    const defaultLocale = payload.config.localization ? payload.config.localization.defaultLocale : undefined;
+    if (locale) {
+        // 'all' and '*' are special Payload values meaning "return all locales" - don't send to Content API
+        if (locale === 'all' || locale === '*') {
+            return undefined;
+        }
+        return locale;
+    } else if (defaultLocale) {
+        return defaultLocale;
+    }
+    return undefined;
+}
+
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,11 @@
+import type { Payload } from 'payload';
+/**
+ * Extracts all localized field paths from a collection's field configuration.
+ * Recursively traverses nested structures (groups, arrays, blocks, tabs) to find fields marked as localized.
+ *
+ * @param payload - The Payload instance containing collection configurations
+ * @param collectionSlug - The slug of the collection to extract localized paths from
+ * @returns Array of dot-notation paths to localized fields (e.g., ['title', 'metadata.description'])
+ */
+export declare function buildLocalizedPaths(payload: Payload, collectionSlug: string): string[];
+//# sourceMappingURL=buildLocalizedPaths.d.ts.map

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

@@ -0,0 +1,66 @@
+/**
+ * Extracts all localized field paths from a collection's field configuration.
+ * Recursively traverses nested structures (groups, arrays, blocks, tabs) to find fields marked as localized.
+ *
+ * @param payload - The Payload instance containing collection configurations
+ * @param collectionSlug - The slug of the collection to extract localized paths from
+ * @returns Array of dot-notation paths to localized fields (e.g., ['title', 'metadata.description'])
+ */ export function buildLocalizedPaths(payload, collectionSlug) {
+    const collectionConfig = payload.config.collections.find((c)=>c.slug === collectionSlug);
+    if (!collectionConfig) {
+        return [];
+    }
+    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) {
+    for (const field of fields){
+        // Only field types that have names can support localization
+        // See: https://payloadcms.com/docs/configuration/localization
+        //
+        // This will skip presentational fields like ui, collapsible, row, tabs (if unnamed), groups (if unnamed)
+        // which do not store data in the database and thus are not relevant for querying localized paths
+        // See: https://payloadcms.com/docs/fields/overview#presentational-fields
+        if (!('name' in field)) {
+            continue;
+        }
+        const fieldPath = buildPath(parentPath, field.name);
+        const isLocalized = 'localized' in field && field.localized === true;
+        const includeNestedPaths = isLocalized || parentIsLocalized;
+        // Add field to results if localized or parent is localized
+        if (includeNestedPaths) {
+            localizedPaths.push(fieldPath);
+        }
+        // Handle blocks field - has a special 'blocks' array structure and each block has its own nested fields
+        if (field.type === 'blocks' && 'blocks' in field) {
+            for (const block of field.blocks){
+                if ('fields' in block) {
+                    traverseFields(block.fields, localizedPaths, fieldPath, includeNestedPaths);
+                }
+            }
+            continue;
+        }
+        // Handle field type that support nested fields
+        // Recursively handle nested structures (groups, arrays, tab, etc)
+        if ('fields' in field) {
+            traverseFields(field.fields, localizedPaths, fieldPath, includeNestedPaths);
+        }
+    }
+}
+/** Builds a dot-notation path from parent path and field name */ function buildPath(parentPath, fieldName) {
+    return parentPath ? `${parentPath}.${fieldName}` : fieldName;
+}
+
+//# sourceMappingURL=buildLocalizedPaths.js.map

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

@@ -0,0 +1,37 @@
+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?: 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;
+    where?: Where;
+}
+/**
+ * Builds the `meta` object for Content API requests.
+ * Combines pathTypes (for array field handling) and localizedPaths (for locale queries).
+ *
+ * @param payload - The Payload instance
+ * @param options - Options including collection slug, locale, and where clause
+ * @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?: ContentAPIMetaGenerated;
+};
+export {};
+//# sourceMappingURL=buildMeta.d.ts.map

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

@@ -0,0 +1,33 @@
+import { buildLocalizedPaths } from './buildLocalizedPaths.js';
+import { buildPathTypes } from './buildPathTypes.js';
+/**
+ * Builds the `meta` object for Content API requests.
+ * Combines pathTypes (for array field handling) and localizedPaths (for locale queries).
+ *
+ * @param payload - The Payload instance
+ * @param options - Options including collection slug, locale, and where clause
+ * @returns Object with meta property ready to spread into request body, or empty object if no meta needed
+ */ export function buildMeta(payload, options) {
+    const { collection, locale, where } = options;
+    const meta = {};
+    // Add pathTypes if there are array fields in the where clause
+    const pathTypes = buildPathTypes(payload, collection, where);
+    if (Object.keys(pathTypes).length > 0) {
+        meta.pathTypes = pathTypes;
+    }
+    // Add localizedPaths if locale is specified (but not 'all')
+    if (locale && locale !== 'all') {
+        const localizedPaths = buildLocalizedPaths(payload, collection);
+        if (localizedPaths.length > 0) {
+            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
+    } : {};
+}
+
+//# sourceMappingURL=buildMeta.js.map

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

@@ -0,0 +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 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): PathTypesRecord;
+//# sourceMappingURL=buildPathTypes.d.ts.map

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

@@ -0,0 +1,181 @@
+/**
+ * Extracts all field paths from a where clause recursively
+ */ function extractPathsFromWhere(where, paths = new Set()) {
+    if (!where || typeof where !== 'object') {
+        return paths;
+    }
+    // Handle 'and' operator
+    if ('and' in where && Array.isArray(where.and)) {
+        for (const clause of where.and){
+            extractPathsFromWhere(clause, paths);
+        }
+        return paths;
+    }
+    // Handle 'or' operator
+    if ('or' in where && Array.isArray(where.or)) {
+        for (const clause of where.or){
+            extractPathsFromWhere(clause, paths);
+        }
+        return paths;
+    }
+    // Handle regular conditions - keys are field paths
+    for(const key in where){
+        if (key === 'and' || key === 'or') {
+            continue;
+        }
+        // Add the path
+        paths.add(key);
+        // Check if the value is a nested where clause (for relationships)
+        const value = where[key];
+        if (value && typeof value === 'object' && !('equals' in value) && !('in' in value)) {
+            // Might be a nested where, recurse
+            extractPathsFromWhere(value, paths);
+        }
+    }
+    return paths;
+}
+/**
+ * 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') {
+        return 'array';
+    }
+    // Blocks field (array of objects)
+    if (field.type === 'blocks') {
+        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';
+    }
+    // Objects (group, collapsible, row, tabs) don't need traversal
+    return null;
+}
+/**
+ * Finds a field in the collection schema by its path
+ * Supports nested paths like "access.read.users"
+ */ function findFieldByPath(payload, collectionSlug, path) {
+    const collectionConfig = payload.config.collections.find((c)=>c.slug === collectionSlug);
+    if (!collectionConfig) {
+        return undefined;
+    }
+    const pathSegments = path.split('.');
+    // Walk through the path segments to find the field
+    let currentFields = collectionConfig.fields;
+    let currentField = undefined;
+    for(let i = 0; i < pathSegments.length; i++){
+        const segment = pathSegments[i];
+        // First try to find a direct match
+        currentField = currentFields.find((f)=>'name' in f && f.name === segment);
+        // If not found, check if any unnamed container fields (collapsible, row) contain it
+        if (!currentField) {
+            for (const field of currentFields){
+                if (!('name' in field) || !field.name) {
+                    // This is an unnamed field, check its contents
+                    if ('fields' in field && field.type === 'collapsible' || 'fields' in field && field.type === 'row') {
+                        currentField = field.fields.find((f)=>'name' in f && f.name === segment);
+                        if (currentField) {
+                            break;
+                        }
+                    } else if ('tabs' in field && field.type === 'tabs') {
+                        // Check all tabs
+                        for (const tab of field.tabs){
+                            currentField = tab.fields.find((f)=>'name' in f && f.name === segment);
+                            if (currentField) {
+                                break;
+                            }
+                        }
+                        if (currentField) {
+                            break;
+                        }
+                    }
+                }
+            }
+        }
+        if (!currentField) {
+            return undefined;
+        }
+        // If we're not at the end, get nested fields
+        if (i < pathSegments.length - 1) {
+            if (currentField.type === 'group' && 'fields' in currentField) {
+                currentFields = currentField.fields;
+            } else if (currentField.type === 'array' && 'fields' in currentField) {
+                currentFields = currentField.fields;
+            } else if (currentField.type === 'blocks' && 'blocks' in currentField) {
+                // For blocks, we can't determine the exact field without knowing the block type
+                // Return the blocks field itself
+                return currentField;
+            } else {
+                // Field doesn't have nested fields, can't continue
+                return undefined;
+            }
+        }
+    }
+    return currentField;
+}
+/**
+ * Builds pathTypes metadata for Content API request.
+ * 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 {};
+    }
+    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/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 !== null) {
+                    pathTypes[partialPath] = fieldType;
+                }
+            }
+        }
+    }
+    return pathTypes;
+}
+
+//# sourceMappingURL=buildPathTypes.js.map

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

@@ -0,0 +1,20 @@
+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;
+    /**
+     * 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 {};
+//# sourceMappingURL=where.d.ts.map

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

@@ -0,0 +1,127 @@
+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
+                }))// TODO: A better solution would be to make the `where` schema of `zod` in `content-api`
+            // more permissive. For now I'll do it this way because I have an idea to simplify
+            // everything we're doing with `where` (Post EAP) anyway.
+            // Filter out empty conditions { and: [] } that would be invalid
+            .filter((condition)=>{
+                if ('and' in condition) {
+                    return condition.and.length > 0;
+                }
+                if ('or' in condition) {
+                    return condition.or.length > 0;
+                }
+                return true // Keep path/operator/value conditions
+                ;
+            });
+            // If filtering resulted in no conditions, return empty and
+            if (nestedConditions.length === 0) {
+                return {
+                    and: []
+                };
+            }
+            return {
+                and: nestedConditions
+            };
+        } else if (key === 'or') {
+            // Recursively convert nested 'or' conditions, preserving options
+            const nestedConditions = value.map((item)=>convertPayloadWhereToContentAPI(item, {
+                    ...options,
+                    insideLogicalOperator: true
+                }))// Filter out empty conditions { and: [] } or { or: [] } that would be invalid
+            .filter((condition)=>{
+                if ('and' in condition) {
+                    return condition.and.length > 0;
+                }
+                if ('or' in condition) {
+                    return condition.or.length > 0;
+                }
+                return true // Keep path/operator/value conditions
+                ;
+            });
+            // If filtering resulted in no conditions, return empty and
+            if (nestedConditions.length === 0) {
+                return {
+                    and: []
+                };
+            }
+            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';
+            }
+            // 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 } }
+            // If value is a primitive (string, number, boolean, null) or not a plain object,
+            // treat it as an implicit 'equals' operator
+            const isPrimitive = value === null || typeof value !== 'object' || Array.isArray(value);
+            if (isPrimitive) {
+                // Shorthand format: { id: "some-value" } means { id: { equals: "some-value" } }
+                conditions.push({
+                    operator: 'equals',
+                    path: fieldPath,
+                    value
+                });
+                continue;
+            }
+            const operators = value;
+            // Skip empty operator objects { fieldName: {} }
+            if (Object.keys(operators).length === 0) {
+                continue;
+            }
+            for (const [op, operatorValue] of Object.entries(operators)){
+                // Skip operators with undefined values (e.g., { equals: undefined })
+                // This can happen when Payload sends incomplete where clauses
+                if (operatorValue === undefined) {
+                    continue;
+                }
+                let finalValue = operatorValue;
+                // Convert string booleans to actual booleans for exists operator
+                // REST API sends "true"/"false" as strings, but Content API requires boolean
+                if (op === 'exists' && typeof operatorValue === 'string') {
+                    finalValue = operatorValue === 'true';
+                }
+                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/endpoints/health.d.ts

@@ -0,0 +1,3 @@
+import type { Endpoint } from 'payload';
+export declare const health: Endpoint;
+//# sourceMappingURL=health.d.ts.map