@payloadcms/figma 0.0.1-alpha.63 → 0.0.1-alpha.65

package/dist/utils/payload-config-modifier.js

@@ -5,7 +5,7 @@ import * as log from './log.js';
 import { getAddCommand, getRunCommand } from './package-manager.js';
 import { addFigmaProperty, applyModifications, detectRequiredChanges } from './payload-config-ast.js';
 import { findPayloadConfig } from './payload-config-finder.js';
-import { checkPackageInstalled, getPayloadVersion, installPackage, uninstallPackage } from './payload-package-check.js';
+import { checkPackageInstalled, getPayloadVersion, installPackages, uninstallPackages } from './payload-package-check.js';
 import { runTypeScriptCheck } from './typescript-validator.js';
 import { getOwnVersion } from './version-check.js';
 /**
@@ -14,10 +14,9 @@ import { getOwnVersion } from './version-check.js';
  */ export async function ensurePayloadFigmaConfig(projectPath, packageManager, figmaConfig) {
     const changes = [];
     const warnings = [];
-    let modified = false;
+    let astModified = false;
     try {
         log.debug(`Starting payload config modification for: ${projectPath}`);
-        // 1. Find config file
         const configPath = await findPayloadConfig(projectPath);
         if (!configPath) {
             log.debug(`Config file not found in: ${projectPath}`);
@@ -29,32 +28,10 @@ import { getOwnVersion } from './version-check.js';
             };
         }
         log.debug(`Found config file: ${configPath}`);
-        // Get payload version to pin @payloadcms/* dependencies
+        // Pin @payloadcms/* packages to the project's payload version when possible.
         const payloadVersion = await getPayloadVersion(projectPath);
         log.debug(`Detected payload version: ${payloadVersion || 'unknown'}`);
-        // 2. Check/install @payloadcms/figma package
-        const isInstalled = await checkPackageInstalled(projectPath, '@payloadcms/figma');
-        if (!isInstalled) {
-            log.debug('@payloadcms/figma not installed, attempting installation...');
-            try {
-                const figmaVersion = await getOwnVersion();
-                await installPackage(projectPath, '@payloadcms/figma', packageManager, figmaVersion);
-                changes.push('Installed @payloadcms/figma');
-                modified = true;
-                log.debug('@payloadcms/figma installed successfully');
-            } catch (error) {
-                log.debug(`Failed to install @payloadcms/figma: ${error instanceof Error ? error.message : 'Unknown error'}`);
-                return {
-                    changes: [],
-                    error: 'Failed to install @payloadcms/figma',
-                    modified: false,
-                    success: false
-                };
-            }
-        } else {
-            log.debug('@payloadcms/figma already installed');
-        }
-        // 3. Parse config with ts-morph
+        // Parse first so a malformed config fails fast before we touch node_modules.
         log.debug('Parsing config file with ts-morph...');
         const project = new Project({
             manipulationSettings: {
@@ -64,17 +41,15 @@ import { getOwnVersion } from './version-check.js';
             skipAddingFilesFromTsConfig: true
         });
         const sourceFile = project.addSourceFileAtPath(configPath);
-        // 4. Detect required changes
         log.debug('Detecting required changes...');
         const detection = detectRequiredChanges(sourceFile);
         log.debug(`Detection results: needsImportChange=${detection.needsImportChange}, hasAlias=${detection.hasAlias}, hasBuildConfig=${detection.hasBuildConfig}`);
-        // Handle failure modes
         if (detection.hasAlias) {
             log.debug('Config uses import alias (e.g., buildConfig as X)');
             return {
                 changes,
                 error: 'Config uses import alias - manual modification required',
-                modified,
+                modified: false,
                 success: false
             };
         }
@@ -83,25 +58,95 @@ import { getOwnVersion } from './version-check.js';
             return {
                 changes,
                 error: 'Config structure not recognized (no buildConfig call found)',
-                modified,
+                modified: false,
                 success: false
             };
         }
-        // 5. Apply modifications
+        // Compute the full install/uninstall diff up front so each can run as a
+        // single package-manager call. npm leaves node_modules transient between
+        // back-to-back calls, which causes generate:importmap to silently miss
+        // subpath components — batching avoids that intermediate state.
+        const packagesToInstall = [];
+        const packagesToUninstall = [];
+        const figmaInstalled = await checkPackageInstalled(projectPath, '@payloadcms/figma');
+        if (!figmaInstalled) {
+            const figmaVersion = await getOwnVersion();
+            packagesToInstall.push({
+                name: '@payloadcms/figma',
+                changeMessage: 'Installed @payloadcms/figma',
+                version: figmaVersion
+            });
+        }
+        const editorIsDefault = !detection.editorProperty || detection.editorProperty.isDefault;
+        if (editorIsDefault) {
+            const hasLexical = await checkPackageInstalled(projectPath, '@payloadcms/richtext-lexical');
+            if (!hasLexical) {
+                packagesToInstall.push({
+                    name: '@payloadcms/richtext-lexical',
+                    changeMessage: 'Installed @payloadcms/richtext-lexical (default editor)',
+                    version: payloadVersion
+                });
+            }
+        } else {
+            log.debug(`Custom editor detected (${detection.editorProperty?.importSource}) - skipping lexical installation`);
+        }
+        const hasCloudStorage = await checkPackageInstalled(projectPath, '@payloadcms/plugin-cloud-storage');
+        if (!hasCloudStorage) {
+            packagesToInstall.push({
+                name: '@payloadcms/plugin-cloud-storage',
+                changeMessage: 'Installed @payloadcms/plugin-cloud-storage',
+                version: payloadVersion
+            });
+        }
+        if (detection.dbProperty) {
+            packagesToUninstall.push(detection.dbProperty.importSource);
+        }
+        if (detection.sharpProperty) {
+            packagesToUninstall.push('sharp');
+        }
+        if (packagesToInstall.length > 0) {
+            log.debug(`Installing ${packagesToInstall.length} packages in a single operation: ${packagesToInstall.map((p)=>p.name).join(', ')}`);
+            try {
+                await installPackages(projectPath, packagesToInstall.map(({ name, version })=>({
+                        name,
+                        version
+                    })), packageManager);
+                for (const { changeMessage } of packagesToInstall){
+                    changes.push(changeMessage);
+                }
+            } catch (error) {
+                const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+                log.debug(`Batched install failed: ${errorMessage}`);
+                const figmaInBatch = packagesToInstall.some((p)=>p.name === '@payloadcms/figma');
+                if (figmaInBatch) {
+                    // Without @payloadcms/figma the rewritten config would import a
+                    // missing package, so abort before touching the file.
+                    return {
+                        changes: [],
+                        error: 'Failed to install @payloadcms/figma',
+                        modified: false,
+                        success: false
+                    };
+                }
+                // Lexical and cloud-storage are non-fatal — payload still loads without
+                // them, so warn (with package names) and continue.
+                const failedNames = packagesToInstall.map((p)=>p.name).join(', ');
+                warnings.push(`Could not install dependencies (${failedNames}) — install them manually. Details: ${errorMessage}`);
+            }
+        }
         log.debug('Applying modifications...');
         const modResult = applyModifications(sourceFile, detection);
         if (modResult.modified) {
             changes.push(...modResult.changes);
-            modified = true;
+            astModified = true;
             log.debug(`Applied ${modResult.changes.length} modifications`);
         }
-        // 6. Add figma property if config provided and doesn't exist
         if (figmaConfig && !detection.figmaObjectExists) {
             log.debug('Adding figma property to buildConfig...');
             const figmaResult = addFigmaProperty(sourceFile, figmaConfig);
             if (figmaResult.modified) {
                 changes.push(...figmaResult.changes);
-                modified = true;
+                astModified = true;
                 log.debug(`Added figma property`);
             } else {
                 log.debug('Figma property not added (may already exist)');
@@ -109,95 +154,39 @@ import { getOwnVersion } from './version-check.js';
         } else if (detection.figmaObjectExists) {
             log.debug('Figma property already exists, skipping');
         }
-        // Save file if any modifications were made
-        if (modified) {
+        if (astModified) {
             sourceFile.formatText({
                 indentSize: 2,
                 tabSize: 2
             });
             await sourceFile.save();
             log.debug('Config file saved');
-            // 7. Handle package management
-            const packagesToUninstall = [];
-            // Uninstall db adapter (buildFigmaConfig provides its own)
-            if (detection.dbProperty) {
-                packagesToUninstall.push(detection.dbProperty.importSource);
-            }
-            // Uninstall sharp (Figma infrastructure handles image processing)
-            if (detection.sharpProperty) {
-                packagesToUninstall.push('sharp');
-            }
-            // Ensure lexical is installed if user doesn't have a custom editor
-            // (buildFigmaConfig uses lexicalEditor() as default)
-            if (!detection.editorProperty) {
-                log.debug('No editor property detected - will ensure lexical is installed for default editor');
-            } else if (detection.editorProperty.isDefault) {
-                log.debug('Default lexicalEditor() detected - will ensure lexical is installed');
-            } else {
-                log.debug(`Custom editor detected (${detection.editorProperty.importSource}) - skipping lexical installation`);
-            }
-            if (!detection.editorProperty || detection.editorProperty.isDefault) {
-                log.debug('Checking if @payloadcms/richtext-lexical is installed...');
-                const hasLexical = await checkPackageInstalled(projectPath, '@payloadcms/richtext-lexical');
-                if (!hasLexical) {
-                    log.debug('@payloadcms/richtext-lexical not found, installing...');
-                    try {
-                        await installPackage(projectPath, '@payloadcms/richtext-lexical', packageManager, payloadVersion);
-                        changes.push('Installed @payloadcms/richtext-lexical (default editor)');
-                        log.debug('Successfully installed @payloadcms/richtext-lexical');
-                    } catch (error) {
-                        log.debug(`Failed to install @payloadcms/richtext-lexical: ${error instanceof Error ? error.message : 'Unknown error'}`);
-                        // Don't fail on install error - user can install manually if needed
-                        warnings.push('Could not install @payloadcms/richtext-lexical - you may need to install it manually');
-                    }
-                } else {
-                    log.debug('@payloadcms/richtext-lexical already installed, skipping');
-                }
-            }
-            // Ensure cloud-storage is installed (required peer dependency for buildFigmaConfig)
-            log.debug('Checking if @payloadcms/plugin-cloud-storage is installed...');
-            const hasCloudStorage = await checkPackageInstalled(projectPath, '@payloadcms/plugin-cloud-storage');
-            if (!hasCloudStorage) {
-                log.debug('@payloadcms/plugin-cloud-storage not found, installing...');
-                try {
-                    await installPackage(projectPath, '@payloadcms/plugin-cloud-storage', packageManager, payloadVersion);
-                    changes.push('Installed @payloadcms/plugin-cloud-storage');
-                    log.debug('Successfully installed @payloadcms/plugin-cloud-storage');
-                } catch (error) {
-                    log.debug(`Failed to install @payloadcms/plugin-cloud-storage: ${error instanceof Error ? error.message : 'Unknown error'}`);
-                    warnings.push('Could not install @payloadcms/plugin-cloud-storage - you may need to install it manually');
-                }
-            } else {
-                log.debug('@payloadcms/plugin-cloud-storage already installed, skipping');
-            }
-            if (packagesToUninstall.length > 0) {
-                log.debug(`Uninstalling ${packagesToUninstall.length} orphaned packages...`);
-            }
-            for (const pkg of packagesToUninstall){
-                try {
-                    await uninstallPackage(projectPath, pkg, packageManager);
-                    changes.push(`Uninstalled ${pkg}`);
-                    log.debug(`Uninstalled ${pkg}`);
-                } catch (error) {
-                    log.debug(`Failed to uninstall ${pkg}: ${error instanceof Error ? error.message : 'Unknown error'}`);
-                // Don't fail on uninstall errors - orphaned package is better than broken config
-                }
-            }
-            // 8. Format file
             log.debug('Formatting config file...');
             const formatResult = await formatFile(configPath, packageManager);
             if (!formatResult.success && formatResult.warning) {
                 warnings.push(formatResult.warning);
                 log.debug(`Formatting warning: ${formatResult.warning}`);
             }
-            // 9. Run TypeScript validation
             log.debug('Running TypeScript validation...');
             const tsResult = await runTypeScriptCheck(projectPath, packageManager);
             if (!tsResult.success && tsResult.errors.length > 0) {
                 warnings.push(`TypeScript validation found issues - run '${getRunCommand(packageManager)} build' for details`);
                 log.debug(`TypeScript validation found ${tsResult.errors.length} issues`);
             }
-        } else {
+        }
+        if (packagesToUninstall.length > 0) {
+            log.debug(`Uninstalling ${packagesToUninstall.length} orphaned packages: ${packagesToUninstall.join(', ')}`);
+            const uninstallResult = await uninstallPackages(projectPath, packagesToUninstall, packageManager);
+            if (uninstallResult.success) {
+                for (const pkg of packagesToUninstall){
+                    changes.push(`Uninstalled ${pkg}`);
+                }
+            } else {
+                warnings.push(`Could not uninstall ${uninstallResult.failedPackages.join(', ')} — they may remain as orphaned dependencies in package.json`);
+            }
+        }
+        const modified = astModified || changes.length > 0;
+        if (!modified) {
             log.debug('No modifications needed - config already correct');
         }
         log.debug('Payload config modification completed successfully');
@@ -215,7 +204,7 @@ import { getOwnVersion } from './version-check.js';
         return {
             changes,
             error: error instanceof Error ? error.message : 'Unknown error occurred',
-            modified,
+            modified: astModified,
             success: false
         };
     }

package/dist/utils/payload-package-check.d.ts

@@ -1,4 +1,12 @@
 import type { PackageManager } from './package-manager.js';
+export type PackageSpec = {
+    name: string;
+    version?: string;
+};
+export type UninstallResult = {
+    failedPackages: string[];
+    success: boolean;
+};
 /**
  * Check if a package is installed in dependencies (not devDependencies)
  */
@@ -13,11 +21,23 @@ export declare function getPayloadVersion(projectPath: string): Promise<string |
  * @param version - Version to install (without caret). Defaults to 'latest'.
  */
 export declare function installPackage(projectPath: string, packageName: string, packageManager: PackageManager, version?: string): Promise<void>;
+/**
+ * Install multiple packages as production dependencies in a single package-manager call.
+ * No-op when packages is empty. Throws on failure with exit code and truncated stderr.
+ */
+export declare function installPackages(projectPath: string, packages: PackageSpec[], packageManager: PackageManager): Promise<void>;
 /**
  * Uninstall a package
  * Does not throw on failure - orphaned package is better than broken config
  */
-export declare function uninstallPackage(projectPath: string, packageName: string, packageManager: PackageManager): Promise<void>;
+export declare function uninstallPackage(projectPath: string, packageName: string, packageManager: PackageManager): Promise<UninstallResult>;
+/**
+ * Uninstall multiple packages in a single package-manager call.
+ * No-op when packageNames is empty. Does not throw — orphaned packages are
+ * preferable to a crash mid-config-rewrite. Returns a success flag so callers
+ * can avoid claiming "Uninstalled X" when the package manager actually failed.
+ */
+export declare function uninstallPackages(projectPath: string, packageNames: string[], packageManager: PackageManager): Promise<UninstallResult>;
 /**
  * Run an npm script from package.json
  * Does not throw on failure - logs warning and continues

package/dist/utils/payload-package-check.js

@@ -40,24 +40,33 @@ import * as log from './log.js';
  * Install a package as a production dependency
  * @param version - Version to install (without caret). Defaults to 'latest'.
  */ export async function installPackage(projectPath, packageName, packageManager, version = 'latest') {
+    return installPackages(projectPath, [
+        {
+            name: packageName,
+            version
+        }
+    ], packageManager);
+}
+/**
+ * Install multiple packages as production dependencies in a single package-manager call.
+ * No-op when packages is empty. Throws on failure with exit code and truncated stderr.
+ */ export async function installPackages(projectPath, packages, packageManager) {
+    if (packages.length === 0) {
+        return;
+    }
     return new Promise((resolve, reject)=>{
         const command = packageManager;
-        const packageSpec = packageName.endsWith('.tgz') ? packageName : `${packageName}@${version}`;
+        const packageSpecs = packages.map(({ name, version })=>name.endsWith('.tgz') ? name : `${name}@${version ?? 'latest'}`);
         const args = [
-            'add',
-            packageSpec
+            packageManager === 'npm' ? 'install' : 'add',
+            ...packageSpecs
         ];
-        // npm uses 'install' instead of 'add'
-        if (packageManager === 'npm') {
-            args[0] = 'install';
-        }
         log.debug(`Running: ${command} ${args.join(' ')} in ${projectPath}`);
         let stderr = '';
         const child = spawn(command, args, {
             cwd: projectPath,
             stdio: 'pipe'
         });
-        // Capture stderr for debug logging
         if (child.stderr) {
             child.stderr.on('data', (data)=>{
                 stderr += data.toString();
@@ -69,15 +78,17 @@ import * as log from './log.js';
         });
         child.on('close', (code)=>{
             if (code === 0) {
-                log.debug(`Successfully installed ${packageName}`);
+                log.debug(`Successfully installed ${packageSpecs.join(', ')}`);
                 resolve();
-            } else {
-                log.debug(`Failed to install ${packageName} (exit code: ${code})`);
-                if (stderr) {
-                    log.debug(`stderr: ${stderr}`);
-                }
-                reject(new Error(`Failed to install ${packageName}`));
+                return;
+            }
+            log.debug(`Batched install failed (exit code: ${code})`);
+            if (stderr) {
+                log.debug(`stderr: ${stderr}`);
             }
+            const truncatedStderr = stderr.trim().slice(-500);
+            const detail = truncatedStderr ? `\n${truncatedStderr}` : '';
+            reject(new Error(`Failed to install: ${packageSpecs.join(', ')} (exit code ${code})${detail}`));
         });
     });
 }
@@ -85,29 +96,58 @@ import * as log from './log.js';
  * Uninstall a package
  * Does not throw on failure - orphaned package is better than broken config
  */ export async function uninstallPackage(projectPath, packageName, packageManager) {
+    return uninstallPackages(projectPath, [
+        packageName
+    ], packageManager);
+}
+/**
+ * Uninstall multiple packages in a single package-manager call.
+ * No-op when packageNames is empty. Does not throw — orphaned packages are
+ * preferable to a crash mid-config-rewrite. Returns a success flag so callers
+ * can avoid claiming "Uninstalled X" when the package manager actually failed.
+ */ export async function uninstallPackages(projectPath, packageNames, packageManager) {
+    if (packageNames.length === 0) {
+        return {
+            failedPackages: [],
+            success: true
+        };
+    }
     return new Promise((resolve)=>{
         const command = packageManager;
         const args = [
-            'remove',
-            packageName
+            packageManager === 'npm' ? 'uninstall' : 'remove',
+            ...packageNames
         ];
-        // npm uses 'uninstall' instead of 'remove'
-        if (packageManager === 'npm') {
-            args[0] = 'uninstall';
-        }
         log.debug(`Running: ${command} ${args.join(' ')} in ${projectPath}`);
         const child = spawn(command, args, {
             cwd: projectPath,
             stdio: 'pipe'
         });
+        child.on('error', (error)=>{
+            log.debug(`Spawn error for ${command}: ${error.message}`);
+            resolve({
+                failedPackages: [
+                    ...packageNames
+                ],
+                success: false
+            });
+        });
         child.on('close', (code)=>{
             if (code === 0) {
-                log.debug(`Successfully uninstalled ${packageName}`);
-            } else {
-                log.debug(`Failed to uninstall ${packageName} (exit code: ${code}), continuing anyway`);
+                log.debug(`Successfully uninstalled ${packageNames.join(', ')}`);
+                resolve({
+                    failedPackages: [],
+                    success: true
+                });
+                return;
             }
-            // Always resolve, even on error
-            resolve();
+            log.debug(`Batched uninstall failed (exit code: ${code}), continuing anyway`);
+            resolve({
+                failedPackages: [
+                    ...packageNames
+                ],
+                success: false
+            });
         });
     });
 }

package/dist/utils/project.d.ts

@@ -2,6 +2,7 @@
  * Project detection and scaffolding utilities
  */
 import type { ProjectInfo } from '../types/config.js';
+import type { TemplateSource } from './download-template.js';
 import type { PackageManager } from './package-manager.js';
 /**
  * Detect if current directory has a Payload project
@@ -23,7 +24,7 @@ export declare function validatePayloadVersion(version: string): boolean;
  * @param projectPath - Path where to create the project
  * @param projectName - Name for the project
  */
-export declare function scaffoldProject(projectPath: string, projectName: string, packageManager?: PackageManager): Promise<void>;
+export declare function scaffoldProject(projectPath: string, projectName: string, packageManager?: PackageManager, templateSource?: Partial<TemplateSource>): Promise<void>;
 /**
  * Initialize git repository after all setup is complete
  *

package/dist/utils/project.js

@@ -120,13 +120,13 @@ import { getOwnVersion } from './version-check.js';
  *
  * @param projectPath - Path where to create the project
  * @param projectName - Name for the project
- */ export async function scaffoldProject(projectPath, projectName, packageManager = 'npm') {
+ */ export async function scaffoldProject(projectPath, projectName, packageManager = 'npm', templateSource) {
     // Create project directory if it doesn't exist
     await fs.mkdir(projectPath, {
         recursive: true
     });
     // Download template from GitHub
-    await downloadTemplateFromGitHub(projectPath);
+    await downloadTemplateFromGitHub(projectPath, templateSource);
     // Apply Lambda modifications BEFORE updating package.json
     // This ensures we don't overwrite version replacements
     await applyLambdaModifications(projectPath, packageManager);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@payloadcms/figma",
-  "version": "0.0.1-alpha.63",
+  "version": "0.0.1-alpha.65",
   "license": "SEE LICENSE IN LICENSE.md",
   "type": "module",
   "exports": {
@@ -47,10 +47,18 @@
     "uuid": "^10.0.0"
   },
   "devDependencies": {
+    "@payloadcms/eslint-config": "3.28.0",
+    "@payloadcms/eslint-plugin": "3.28.0",
+    "@swc/cli": "0.7.7",
     "@types/archiver": "7.0.0",
     "@types/cross-spawn": "6.0.6",
+    "@types/jsonwebtoken": "^9.0.10",
     "@types/node": "22.12.0",
+    "@types/uuid": "^8.3.4",
+    "copyfiles": "^2.4.1",
+    "eslint": "9.22.0",
     "openapi-typescript": "^7.13.0",
+    "rimraf": "^6.1.3",
     "tsx": "4.20.6",
     "typescript": "5.7.3",
     "vitest": "4.0.15"

package/dist/db-content-api/README.md

@@ -1,98 +0,0 @@
-# Content API Database Adapter Parity
-
-This document explains how the Content API database adapter differs from Payload today and how it will behave once alignment is complete.
-
-The Content API is an internal service built exclusively for Payload. Because of that, the adapter should match Payload by default and only diverge when there is a strong technical reason.
-
-## Where
-
-Now  
-`{ path: "slug", operator: "equals", value: "hello", type: "text" }`
-
-Future  
-`{ path: "slug", operator: "equals", value: "hello", type: "text" }`
-
-The format stays different. This allows the Content API to evolve its filter schema, for example to support composite types like Point, which are not lexicographically sortable. Semantics must remain identical to Payload.
-
-## Pagination
-
-~~Now~~  
-~~`{ limit: 10, offset: 20 }`~~
-
-✅ Partially Implemented  
-`{ limit: 10, page: 3 }`
-
-**Status:**
-
-- ✅ Content API main endpoints use `page` (matches Payload)
-
-- ⚠️ **Issue #1 (Joins):** `JoinClause` still uses `offset` instead of `page`
-  - Payload `JoinQuery`: `{ page?: number, limit?: number }`
-  - Content API `JoinClause`: `{ offset?: number, limit?: number }`
-  - **Inconsistent** with main endpoints which use `page`
-
-**Current workaround for joins:** The adapter converts `page` to `offset`:
-
-```typescript
-// Payload join query
-{ page: 2, limit: 5 }
-// Adapter converts to offset for Content API
-{ offset: 5, limit: 5 }
-```
-
-**Future:**
-
-1. Content API should support `skip` parameter for main endpoints
-2. Content API `JoinClause` should use `page` instead of `offset` (consistent with main endpoints)
-3. Content API pagination response should match Payload's flat structure
-
-### Pagination Response Structure
-
-**Payload format (flat):**
-
-```typescript
-{
-  docs: [...],
-  hasNextPage: boolean,
-  hasPrevPage: boolean,
-  limit: number,
-  nextPage: number | null,
-  page: number,
-  pagingCounter: number,
-  prevPage: number | null,
-  totalDocs: number,
-  totalPages: number
-}
-```
-
-**Content API format (nested):**
-
-```typescript
-{
-  data: [...],
-  pagination: {
-    total: number,
-    current: { limit: number, page: number },
-    next?: { limit: number, page: number },
-    prev?: { limit: number, page: number }
-  }
-}
-```
-
-**Current workaround:** The adapter transforms Content API's nested structure to Payload's flat structure using `getPaginationData()` utility.
-
-## Slugs
-
-Now  
-`{ collection: { key: "posts" } }`
-
-Future  
-`{ collection: { slug: "posts" } }`
-
-Collection identifiers will match Payload. Consumers should not be aware of internal collection IDs.
-
-## Temporary Conversions
-
-Helpers that translate Payload queries into the current Content API format are temporary and placed in the `temp-utilities` folder.
-
-They live in the `temp-utilities` folder until the Content API is fully aligned with Payload.