@payloadcms/figma 0.0.1-alpha.57 → 0.0.1-alpha.59

package/dist/commands/deploy.js

@@ -1,13 +1,13 @@
 import * as p from '@clack/prompts';
 import spawn from 'cross-spawn';
-import path from 'path';
 import pc from 'picocolors';
 import { ControlPlaneError, createDeployment, getBootstrapInfo, performDeployment } from '../api/control-plane.js';
-import { tryGetAccessToken } from '../auth/oauth-flow.js';
+import { tryGetCredential } from '../auth/oauth-flow.js';
 import { getTokenStore } from '../auth/token-store.js';
 import { getInfraEnvironment, getProjectNotFoundMessage } from '../constants.js';
-import { collectStaticAssets, createLambdaZip, getFileSize } from '../utils/asset-collection.js';
+import { getFileSize } from '../utils/asset-collection.js';
 import { detectBuild, getBuildCommand } from '../utils/build-detection.js';
+import { detectAdapter } from '../utils/deploy-adapter.js';
 import { getEnvVar } from '../utils/env-management.js';
 import * as log from '../utils/log.js';
 import { getPackageManager } from '../utils/package-manager.js';
@@ -71,12 +71,12 @@ import { loginCommand } from './login.js';
         }
         // Check authentication
         const tokenStore = getTokenStore();
-        let accessToken = await tryGetAccessToken(tokenStore);
-        if (!accessToken) {
+        let credential = await tryGetCredential(tokenStore);
+        if (!credential) {
             p.log.message('Please log in to continue');
             await loginCommand();
-            accessToken = await tryGetAccessToken(tokenStore);
-            if (!accessToken) {
+            credential = await tryGetCredential(tokenStore);
+            if (!credential) {
                 p.log.error(pc.red('✗ Authentication failed'));
                 process.exit(1);
             }
@@ -85,7 +85,7 @@ import { loginCommand } from './login.js';
         spinner.start('Resolving deployment target...');
         let tenantInstanceId;
         try {
-            const bootstrapInfo = await getBootstrapInfo(accessToken, projectId);
+            const bootstrapInfo = await getBootstrapInfo(credential, projectId);
             const resolvedEnv = resolveEnvironment({
                 environmentName,
                 environments: bootstrapInfo.environments
@@ -183,68 +183,98 @@ import { loginCommand } from './login.js';
             // Verify build output
             buildInfo = await detectBuild(projectPath);
             if (!buildInfo) {
-                p.log.error(pc.red('✗ Build completed but standalone build not found'));
-                p.note('Ensure next.config has output: "standalone"', 'Check Lambda Configuration');
+                p.log.error(pc.red('✗ Build completed but build output not found'));
+                p.note('Ensure your build produces a valid output directory.', 'Check Build Configuration');
                 process.exit(1);
             }
         }
         // ===== DEPLOYMENT PREPARATION =====
-        // Create Lambda zip
+        // Detect framework adapter
+        spinner.start('Detecting framework...');
+        const adapter = await detectAdapter(projectPath, options.adapter);
+        spinner.stop(pc.green(`✓ Detected ${adapter.name} adapter`));
+        // Collect pages and assets
+        spinner.start('Collecting assets...');
+        const pages = await adapter.collectPages(projectPath);
+        const assets = await adapter.collectAssets(projectPath);
+        const allAssetKeys = [
+            ...pages.uploadKeys,
+            ...assets.uploadKeys
+        ];
+        const combinedPathMap = {
+            ...pages.pathMap,
+            ...assets.pathMap
+        };
+        spinner.stop(pc.green(`✓ ${pages.routes.length} pages, ${assets.routes.length} assets detected`));
+        // Create deployment package (if server adapter)
+        let zipPath = null;
+        let zipSize = 0;
         spinner.start('Creating deployment package...');
         try {
-            await createLambdaZip(projectPath);
-            spinner.stop(pc.green('✓ Deployment package created'));
+            zipPath = await adapter.prepareLambdaBundle(projectPath);
+            if (zipPath) {
+                zipSize = await getFileSize(zipPath);
+                spinner.stop(pc.green(`✓ Deployment package created (${formatBytes(zipSize)})`));
+            } else {
+                spinner.stop(pc.green('✓ Static site — no server package needed'));
+            }
         } catch (error) {
             spinner.stop(pc.red('✗ Failed to create deployment package'));
             throw error;
         }
-        // Collect static assets
-        spinner.start('Collecting static assets...');
-        const staticAssets = await collectStaticAssets(projectPath);
-        const zipPath = path.join(projectPath, 'lambda.zip');
-        const zipSize = await getFileSize(zipPath);
-        spinner.stop(pc.green(`✓ ${staticAssets.length} static assets detected`));
-        log.debug(`Lambda zip size: ${formatBytes(zipSize)}`);
-        log.debug(`Static assets: ${staticAssets.length} files`);
+        log.debug(`Adapter: ${adapter.name}`);
+        if (zipPath) {
+            log.debug(`Lambda zip size: ${formatBytes(zipSize)}`);
+        }
+        log.debug(`Pages: ${pages.routes.length} routes`);
+        log.debug(`Assets: ${assets.routes.length} files`);
         // ===== DEPLOYMENT CONFIRMATION =====
         if (!options.yes) {
             p.note([
+                `${pc.cyan('Adapter:')} ${adapter.name}`,
                 `${pc.cyan('Build ID:')} ${buildInfo.buildId}`,
-                `${pc.cyan('Date:')} ${formatDate(buildInfo.timestamp)}`,
-                `${pc.cyan('Code size:')} ${formatBytes(zipSize)}`,
-                `${pc.cyan('Static assets:')} ${staticAssets.length} files`
+                zipPath ? `${pc.cyan('Code size:')} ${formatBytes(zipSize)}` : `${pc.cyan('Code:')} No server`,
+                `${pc.cyan('Pages:')} ${pages.routes.length} routes`,
+                `${pc.cyan('Assets:')} ${assets.routes.length} files`
             ].join('\n'), 'Details');
         }
         // ===== DEPLOYMENT EXECUTION =====
         // Step 1: Create deployment
         spinner.start('Creating deployment...');
-        const createResponse = await createDeployment(accessToken, tenantInstanceId, {
-            staticAssets
+        const createResponse = await createDeployment(credential, tenantInstanceId, {
+            staticAssets: allAssetKeys
         });
         const deploymentId = createResponse.deploymentId;
         const codeUploadUrl = createResponse.codeUploadUrl;
         const staticAssetUploadUrls = createResponse.staticAssetUploadUrls;
         log.debug(`Deployment ID: ${deploymentId}`);
-        // Step 2: Upload code
-        spinner.message(`Uploading code (${formatBytes(zipSize)})...`);
-        await uploadLambdaZip(zipPath, codeUploadUrl);
-        spinner.stop(pc.green(`✓ Code uploaded (${formatBytes(zipSize)})`));
+        // Step 2: Upload code (skip for static sites)
+        if (zipPath) {
+            spinner.message(`Uploading code (${formatBytes(zipSize)})...`);
+            await uploadLambdaZip(zipPath, codeUploadUrl);
+            spinner.stop(pc.green(`✓ Code uploaded (${formatBytes(zipSize)})`));
+        }
         // Step 3: Upload static assets
-        if (staticAssets.length > 0) {
-            spinner.start('Uploading static assets...');
-            const uploadResults = await uploadStaticAssets(projectPath, staticAssetUploadUrls, (uploaded, total)=>{
-                spinner.message(`Uploading static assets (${uploaded}/${total})...`);
+        if (allAssetKeys.length > 0) {
+            spinner.start('Uploading assets...');
+            const uploadResults = await uploadStaticAssets({
+                assetUrls: staticAssetUploadUrls,
+                onProgress: (uploaded, total)=>{
+                    spinner.message(`Uploading assets (${uploaded}/${total})...`);
+                },
+                pathMap: combinedPathMap,
+                projectPath
             });
             if (uploadResults.assetsFailed > 0) {
-                spinner.stop(pc.yellow(`⚠ ${uploadResults.assetsUploaded}/${staticAssets.length} assets uploaded (${uploadResults.assetsFailed} failed)`));
+                spinner.stop(pc.yellow(`⚠ ${uploadResults.assetsUploaded}/${allAssetKeys.length} assets uploaded (${uploadResults.assetsFailed} failed)`));
                 p.log.warning(`${uploadResults.assetsFailed} assets failed to upload. Deployment may be incomplete.`);
             } else {
-                spinner.stop(pc.green(`✓ Static assets uploaded (${uploadResults.assetsUploaded} files, ${formatBytes(uploadResults.totalBytesUploaded)})`));
+                spinner.stop(pc.green(`✓ Assets uploaded (${uploadResults.assetsUploaded} files, ${formatBytes(uploadResults.totalBytesUploaded)})`));
             }
         }
         // Step 4: Perform deployment
         spinner.start('Performing deployment...');
-        const result = await performDeployment(accessToken, tenantInstanceId, {
+        const result = await performDeployment(credential, tenantInstanceId, {
             deploymentId
         });
         const tenantDomains = result.tenantDomains ?? [];

package/dist/commands/env.js

@@ -1,7 +1,7 @@
 import * as p from '@clack/prompts';
 import pc from 'picocolors';
 import { getBootstrapInfo } from '../api/control-plane.js';
-import { getValidAccessToken } from '../auth/oauth-flow.js';
+import { getValidCredential } from '../auth/oauth-flow.js';
 import { getTokenStore } from '../auth/token-store.js';
 import { cacheAllEnvironments } from '../utils/cache-bootstrap.js';
 import { addOrUpdateEnvVar, getEnvVar } from '../utils/env-management.js';
@@ -22,8 +22,8 @@ import * as log from '../utils/log.js';
     const currentEnv = await getEnvVar(cwd, 'FIGMA_ENVIRONMENT_NAME');
     // Authenticate
     const tokenStore = getTokenStore();
-    const accessToken = await getValidAccessToken(tokenStore);
-    if (!accessToken) {
+    const credential = await getValidCredential(tokenStore);
+    if (!credential) {
         p.log.error(pc.red('Not authenticated. Run `@payloadcms/figma login` first.'));
         process.exit(1);
     }
@@ -32,7 +32,7 @@ import * as log from '../utils/log.js';
     spinner.start('Fetching environments...');
     let environments;
     try {
-        const bootstrapInfo = await getBootstrapInfo(accessToken, projectId);
+        const bootstrapInfo = await getBootstrapInfo(credential, projectId);
         environments = bootstrapInfo.environments;
         cacheAllEnvironments(tokenStore, projectId, bootstrapInfo);
     } catch (error) {

package/dist/commands/init.js

@@ -4,7 +4,7 @@ import path from 'path';
 import pc from 'picocolors';
 import { ControlPlaneError, getBootstrapInfo } from '../api/control-plane.js';
 import { FigmaApiError } from '../api/figma-api.js';
-import { tryGetAccessToken } from '../auth/oauth-flow.js';
+import { tryGetCredential } from '../auth/oauth-flow.js';
 import { getValidProjectToken, ProjectTokenError } from '../auth/project-token.js';
 import { getTokenStore } from '../auth/token-store.js';
 import { getInfraEnvironment, getProjectNotFoundMessage } from '../constants.js';
@@ -81,14 +81,14 @@ import { cacheAllEnvironments } from '../utils/cache-bootstrap.js';
         if (!tokenStore.hasValidTokens()) {
             // Need to refresh or authenticate - show spinner for API call
             s.start('Checking authentication...');
-            const token = await tryGetAccessToken(tokenStore);
-            if (!token) {
+            const credential = await tryGetCredential(tokenStore);
+            if (!credential) {
                 s.stop('Authentication required to continue');
                 await loginCommand({
                     showNextSteps: false
                 });
-                const newToken = await tryGetAccessToken(tokenStore);
-                if (!newToken) {
+                const newCredential = await tryGetCredential(tokenStore);
+                if (!newCredential) {
                     p.log.error('Authentication failed');
                     process.exit(1);
                 }
@@ -113,10 +113,10 @@ import { cacheAllEnvironments } from '../utils/cache-bootstrap.js';
     let oauthClientId = null;
     let oauthClientSecret = null;
     if (!options.skipAuth) {
-        const accessToken = await tryGetAccessToken(tokenStore);
-        if (accessToken) {
+        const credential = await tryGetCredential(tokenStore);
+        if (credential) {
             try {
-                bootstrapInfo = await getBootstrapInfo(accessToken, cmsResourceId);
+                bootstrapInfo = await getBootstrapInfo(credential, cmsResourceId);
             } catch (error) {
                 log.debug(`Control Plane Error: ${error.statusCode} - ${error.message}`);
                 if (error instanceof ControlPlaneError && (error.statusCode === 404 || error.statusCode === 410)) {
@@ -217,23 +217,8 @@ import { cacheAllEnvironments } from '../utils/cache-bootstrap.js';
                 p.log.warn(pc.yellow(`⚠ Failed to update .env file: ${error instanceof Error ? error.message : 'Unknown error'}`));
             }
         } else {
-            // Has package.json but no Payload - offer to add Payload
-            p.log.warn(pc.yellow('⚠ No Payload detected in this project'));
-            const shouldAddPayload = await p.confirm({
-                initialValue: true,
-                message: 'Would you like to add Payload to this project?'
-            });
-            if (p.isCancel(shouldAddPayload)) {
-                p.cancel('Operation cancelled');
-                process.exit(0);
-            }
-            if (!shouldAddPayload) {
-                p.log.error('Payload is required to use Figma CMS');
-                process.exit(1);
-            }
-            // TODO: Add Payload to existing project (future enhancement)
-            p.log.error('Adding Payload to existing projects is not yet supported');
-            p.note('Create a new project or manually add Payload dependencies', 'Action Required');
+            p.log.warn(pc.yellow('⚠ Payload was not detected in this project'));
+            p.note('Run this command in a directory without an existing project or in an existing Payload project.', 'Action Required');
             process.exit(1);
         }
         // Generate import map to prevent errors on first dev run

package/dist/commands/login.js

@@ -1,7 +1,7 @@
 import * as p from '@clack/prompts';
 import pc from 'picocolors';
 import { CallbackError } from '../auth/callback-server.js';
-import { executeOAuthFlow, getValidAccessToken, OAuthFlowError } from '../auth/oauth-flow.js';
+import { executeOAuthFlow, getValidCredential, OAuthFlowError } from '../auth/oauth-flow.js';
 import { getTokenStore } from '../auth/token-store.js';
 import { getOAuthConfig } from '../config/oauth.js';
 import { getInfraEnvironment } from '../constants.js';
@@ -20,8 +20,8 @@ import * as log from '../utils/log.js';
     const tokenStore = getTokenStore(env);
     // Check for existing valid tokens
     try {
-        const existingToken = await getValidAccessToken(tokenStore);
-        if (existingToken) {
+        const existingCredential = await getValidCredential(tokenStore);
+        if (existingCredential) {
             const tokens = tokenStore.getTokens();
             p.log.warn(pc.yellow(`Already logged in${formatEnvSuffix(env)}`));
             if (tokens?.userId) {

package/dist/commands/upgrade.js

@@ -5,7 +5,7 @@ import pc from 'picocolors';
 import { Project } from 'ts-morph';
 import { fileURLToPath } from 'url';
 import { getBootstrapInfo, getCmsResourceId } from '../api/control-plane.js';
-import { getValidAccessToken } from '../auth/oauth-flow.js';
+import { getValidCredential } from '../auth/oauth-flow.js';
 import { getTokenStore } from '../auth/token-store.js';
 import { cacheAllEnvironments } from '../utils/cache-bootstrap.js';
 import { addOrUpdateEnvVar, getEnvVar, removeEnvVar } from '../utils/env-management.js';
@@ -110,16 +110,16 @@ async function migrateProjectId({ changes, cwd, isDryRun, warnings = [] }) {
             return;
         }
         const store = getTokenStore();
-        const accessToken = await getValidAccessToken(store);
-        if (!accessToken) {
+        const credential = await getValidCredential(store);
+        if (!credential) {
             warnings.push('Not authenticated — could not resolve FIGMA_PROJECT_ID. Run `npx @payloadcms/figma login` first.');
             return;
         }
-        const cmsResourceId = await getCmsResourceId(accessToken, oldContentSystemId);
+        const cmsResourceId = await getCmsResourceId(credential, oldContentSystemId);
         await addOrUpdateEnvVar(cwd, 'FIGMA_PROJECT_ID', cmsResourceId);
         // Resolve actual environment name from bootstrap API
         try {
-            const bootstrapInfo = await getBootstrapInfo(accessToken, cmsResourceId);
+            const bootstrapInfo = await getBootstrapInfo(credential, cmsResourceId);
             cacheAllEnvironments(store, cmsResourceId, bootstrapInfo);
             const envName = bootstrapInfo.environments[0]?.name ?? 'production';
             await addOrUpdateEnvVar(cwd, 'FIGMA_ENVIRONMENT_NAME', envName);
@@ -144,11 +144,11 @@ async function ensureBootstrapCached(params) {
         if (store.getBootstrapData(projectId, environmentName)) {
             return;
         }
-        const accessToken = await getValidAccessToken(store);
-        if (!accessToken) {
+        const credential = await getValidCredential(store);
+        if (!credential) {
             return;
         }
-        const bootstrapInfo = await getBootstrapInfo(accessToken, projectId);
+        const bootstrapInfo = await getBootstrapInfo(credential, projectId);
         cacheAllEnvironments(store, projectId, bootstrapInfo);
         // Fix FIGMA_ENVIRONMENT_NAME if it doesn't match any actual environment
         const envNames = bootstrapInfo.environments.map((e)=>e.name);
@@ -190,10 +190,10 @@ async function migrateRemoveDeprecatedEnvVars({ changes, cwd, isDryRun, warnings
         const bootstrapData = store.getBootstrapData(projectId, environmentName);
         if (!bootstrapData) {
             // Try fetching from API
-            const accessToken = await getValidAccessToken(store);
-            if (accessToken) {
+            const credential = await getValidCredential(store);
+            if (credential) {
                 try {
-                    const bootstrapInfo = await getBootstrapInfo(accessToken, projectId);
+                    const bootstrapInfo = await getBootstrapInfo(credential, projectId);
                     cacheAllEnvironments(store, projectId, bootstrapInfo);
                 } catch  {
                     warnings.push('Could not verify bootstrap data — keeping deprecated env vars. Run `npx @payloadcms/figma init` to complete migration.');

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

@@ -116,7 +116,7 @@ async function findMany({ collection, joins, limit, locale: localeArg, page, pag
     if (!response) {
         throw new Error('No response from findMany');
     }
-    return unwrapFindResponse(this.payload, response.result, collection);
+    return unwrapFindResponse(this.payload, response.result, collection, localeArg);
 }
 async function find(args) {
     const collectionConfig = this.payload.config.collections.find((c)=>c.slug === args.collection);
@@ -124,8 +124,11 @@ async function find(args) {
         collection: args.collection,
         joins: args.joins,
         // TODO: FindArgs.limit should be 'number' not 'number | undefined'
-        // is sanitized by Payload Core before calling the adapter (defaults to 10 or 0 based on pagination)
-        limit: args.limit,
+        // Payload Core sanitizes limit before calling the adapter when going through findOperation
+        // (defaults to 10 or 0 based on pagination), but some callers (e.g. deleteOperation) call
+        // db.find() directly without a limit. Default to 0 (unlimited) to avoid the Content API
+        // falling back to its own default of 10.
+        limit: args.limit ?? 0,
         locale: args.locale,
         page: args.page ?? 1,
         pagination: args.pagination,
@@ -165,7 +168,7 @@ async function findVersions(args) {
     if (!response) {
         throw new Error('No response from findVersions');
     }
-    return unwrapFindResponse(this.payload, response.result, args.collection);
+    return unwrapFindResponse(this.payload, response.result, args.collection, args.locale);
 }
 async function queryDrafts(args) {
     const versionsResult = await this.findVersions({
@@ -216,7 +219,11 @@ async function createVersion(args) {
     if (!response) {
         throw new Error('No response from createVersion');
     }
-    return unwrapDocument(this.payload, response.result, args.collectionSlug);
+    return unwrapDocument({
+        collectionSlug: args.collectionSlug,
+        doc: response.result,
+        payload: this.payload
+    });
 }
 async function updateVersion(args) {
     const where = args.where ?? {
@@ -262,7 +269,12 @@ async function updateVersion(args) {
     if (!doc) {
         return null;
     }
-    return unwrapDocument(this.payload, doc, args.collection);
+    return unwrapDocument({
+        collectionSlug: args.collection,
+        doc,
+        locale: args.locale,
+        payload: this.payload
+    });
 }
 async function deleteVersions(args) {
     if (!args.collection) {
@@ -357,7 +369,12 @@ async function updateMany(args) {
         throw new Error('No response from updateMany');
     }
     if (response.result && 'data' in response.result) {
-        return response.result.data.map((doc)=>unwrapDocument(this.payload, doc, args.collection));
+        return response.result.data.map((doc)=>unwrapDocument({
+                collectionSlug: args.collection,
+                doc,
+                locale: args.locale,
+                payload: this.payload
+            }));
     }
     return null;
 }
@@ -397,7 +414,12 @@ async function updateOne(args) {
     if (!doc) {
         return null;
     }
-    return unwrapDocument(this.payload, doc, args.collection);
+    return unwrapDocument({
+        collectionSlug: args.collection,
+        doc,
+        locale: args.locale,
+        payload: this.payload
+    });
 }
 async function deleteMany(args) {
     const locale = addFallbackLocale(args.req?.locale, this.payload);
@@ -444,7 +466,12 @@ async function deleteOne(args) {
     if (!doc) {
         return null;
     }
-    return unwrapDocument(this.payload, doc, args.collection);
+    return unwrapDocument({
+        collectionSlug: args.collection,
+        doc,
+        locale: args.req?.locale === null ? undefined : args.req?.locale,
+        payload: this.payload
+    });
 }
 async function create(args) {
     const isGlobalCollection = args.collection.startsWith('_global-');
@@ -487,7 +514,12 @@ async function create(args) {
     if (!response) {
         throw new Error('No response from create');
     }
-    return unwrapDocument(this.payload, response.result, args.collection);
+    return unwrapDocument({
+        collectionSlug: args.collection,
+        doc: response.result,
+        locale: args.locale,
+        payload: this.payload
+    });
 }
 async function clearDatabase() {
     this.payload.logger.info(`---- CLEARING CONTENT API DATABASE ----`);
@@ -604,7 +636,12 @@ async function upsert(args) {
     if (!doc) {
         throw new Error('No document data in upsert response');
     }
-    return unwrapDocument(this.payload, doc, args.collection);
+    return unwrapDocument({
+        collectionSlug: args.collection,
+        doc,
+        locale: args.locale,
+        payload: this.payload
+    });
 }
 function createGlobal(args) {
     return this.create({

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

@@ -1,3 +1,3 @@
 import type { Payload } from 'payload';
-export declare function addFallbackSort(sort: string | string[] | undefined, payload: Payload, collectionSlug: string): string | string[] | undefined;
+export declare function addFallbackSort(sort: string | string[] | undefined, payload: Payload, collectionSlug: string, defaultSort?: string | string[]): string | string[] | undefined;
 //# sourceMappingURL=sorting.d.ts.map

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

@@ -1,9 +1,12 @@
 // Add fallback sort to ensure consistent ordering when sorting by non-unique fields
 // Matches MongoDB adapter behavior
 // TO-DECIDE: Should this live here or in content-api?
-export function addFallbackSort(sort, payload, collectionSlug) {
+export function addFallbackSort(sort, payload, collectionSlug, defaultSort) {
     const collectionConfig = payload.config.collections.find((c)=>c.slug === collectionSlug);
     if (!sort || !collectionConfig) {
+        if (defaultSort) {
+            return addFallbackSort(defaultSort, payload, collectionSlug);
+        }
         return sort;
     }
     const sortArray = Array.isArray(sort) ? sort : [

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

@@ -6,8 +6,13 @@ type DocumentResponse = {
 type DocumentVersionResponse = {
     id: string;
 } & components['schemas']['DocumentVersion'];
-export declare function unwrapDocument(payload: Payload, doc: DocumentResponse | DocumentVersionResponse, collectionSlug?: string): Record<string, unknown>;
-export declare const unwrapFindResponse: (payload: Payload, response: components["schemas"]["FindDocumentsResponse"]["result"] | components["schemas"]["FindDocumentVersionsResponse"]["result"], collection: string) => {
+export declare function unwrapDocument(args: {
+    collectionSlug?: string;
+    doc: DocumentResponse | DocumentVersionResponse;
+    locale?: string;
+    payload: Payload;
+}): Record<string, unknown>;
+export declare const unwrapFindResponse: (payload: Payload, response: components["schemas"]["FindDocumentsResponse"]["result"] | components["schemas"]["FindDocumentVersionsResponse"]["result"], collection: string, locale?: string) => {
     totalDocs: number;
     limit: number;
     page: number;

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

@@ -6,7 +6,8 @@ import { dataFromContentAPI } from '../utilities/data/index.js';
 // Payload expects:
 //   - For documents: { id, ...fields, createdAt, updatedAt }
 //   - For versions: { id, parent, latest, version: { ...fields }, createdAt, updatedAt }
-export function unwrapDocument(payload, doc, collectionSlug) {
+export function unwrapDocument(args) {
+    const { collectionSlug, doc, locale, payload } = args;
     if (!doc) {
         return doc;
     }
@@ -21,7 +22,7 @@ export function unwrapDocument(payload, doc, collectionSlug) {
         // Transform data from Content API format to Payload format
         if (collectionSlug) {
             // Only transform the nested 'version' field
-            baseDoc.version = dataFromContentAPI(payload, collectionSlug, baseDoc.version);
+            baseDoc.version = dataFromContentAPI(payload, collectionSlug, baseDoc.version, locale);
             // Also convert version ID if collection uses numeric custom ID
             const customIDType = payload.collections?.[collectionSlug]?.customIDType;
             if (customIDType === 'number') {
@@ -38,14 +39,19 @@ export function unwrapDocument(payload, doc, collectionSlug) {
     };
     // Transform data from Content API format to Payload format
     if (collectionSlug) {
-        return dataFromContentAPI(payload, collectionSlug, baseDoc);
+        return dataFromContentAPI(payload, collectionSlug, baseDoc, locale);
     }
     return baseDoc;
 }
-export const unwrapFindResponse = (payload, response, collection)=>{
+export const unwrapFindResponse = (payload, response, collection, locale)=>{
     const { data, ...paginationFields } = response;
     return {
-        docs: data.map((doc)=>unwrapDocument(payload, doc, collection)),
+        docs: data.map((doc)=>unwrapDocument({
+                collectionSlug: collection,
+                doc: doc,
+                locale,
+                payload
+            })),
         ...paginationFields
     };
 };

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

@@ -10,7 +10,6 @@
         return value;
     }
     if (field.type === 'number') {
-        // Handle hasMany: true - array of numbers
         if ('hasMany' in field && field.hasMany && Array.isArray(value)) {
             return value.map((item)=>{
                 if (typeof item === 'number') {
@@ -19,20 +18,21 @@
                 if (typeof item === 'string' || typeof item === 'boolean') {
                     return Number(item);
                 }
-                return item // Pass through other types (will likely fail validation)
-                ;
+                return item;
             });
         }
-        // Handle single number
         if (typeof value !== 'number') {
             if (typeof value === 'string' || typeof value === 'boolean') {
                 return Number(value);
             }
-            // For objects/arrays (when not hasMany), return as-is (will likely fail validation later)
             return value;
         }
     }
     if (field.type === 'checkbox' && typeof value !== 'boolean') {
+        // Localized fields store locale-keyed objects like { en: true } — don't cast
+        if ('localized' in field && field.localized && typeof value === 'object' && value !== null) {
+            return value;
+        }
         if (typeof value === 'string') {
             if (value.toLowerCase() === 'true' || value === '1') {
                 return true;
@@ -45,24 +45,23 @@
     }
     // Matches Mongoose behavior: stores dates as ISO strings
     if (field.type === 'date' && typeof value !== 'string') {
+        // Localized fields store locale-keyed objects like { en: '2024-01-01' } — don't cast
+        if ('localized' in field && field.localized && typeof value === 'object' && value !== null) {
+            return value;
+        }
         if (value instanceof Date) {
             return value.toISOString();
         }
         if (typeof value === 'number') {
             return new Date(value).toISOString();
         }
-        // For other types, return as-is (will likely fail validation)
         return value;
     }
-    // Text-like fields: convert non-strings to JSON strings
-    // This handles text, textarea, email, and code fields
-    // EXCEPTIONS:
-    // - Localized fields are stored as objects like {"en": "value", "es": "valor"}
-    // - hasMany fields are stored as arrays like ["value1", "value2"]
+    // Text-like fields: convert non-strings to JSON strings.
+    // Exceptions: localized (stored as locale map) and hasMany (stored as array).
     if ((field.type === 'text' || field.type === 'textarea' || field.type === 'email' || field.type === 'code') && typeof value !== 'string' && !('localized' in field && field.localized) && !('hasMany' in field && field.hasMany && Array.isArray(value))) {
         return JSON.stringify(value);
     }
-    // No casting needed for other types or already correct types
     return value;
 }
 

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

@@ -44,6 +44,6 @@ export declare function dataToContentAPI(payload: Payload, collectionSlug: strin
  * object by filtering out known metadata keys.
  */
 export declare function resolveVersionContent(version: unknown, versionMeta: Record<string, unknown>): unknown;
-export declare function dataFromContentAPI(payload: Payload, collectionSlug: string, data: unknown): unknown;
+export declare function dataFromContentAPI(payload: Payload, collectionSlug: string, data: unknown, locale?: string): unknown;
 export {};
 //# sourceMappingURL=index.d.ts.map