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

package/dist/auth/crypto-utils.d.ts

@@ -30,4 +30,10 @@
  * @throws Error if unable to derive key due to missing machine information
  */
 export declare function deriveEncryptionKey(): string;
+/**
+ * Get a short hash of the encryption key for diagnostics.
+ * Returns first 8 chars of SHA-256 hash — enough to compare across invocations
+ * without exposing the actual key.
+ */
+export declare function getEncryptionKeyHash(): string;
 //# sourceMappingURL=crypto-utils.d.ts.map

package/dist/auth/crypto-utils.js

@@ -33,19 +33,13 @@ import os from 'os';
  * @throws Error if unable to gather sufficient entropy
  */ function gatherMachineEntropy() {
     try {
-        const userInfo = os.userInfo();
-        const networkInterfaces = os.networkInterfaces();
-        // Get MAC address from first available network interface (if available)
-        const macAddress = Object.values(networkInterfaces).flat().find((iface)=>iface && !iface.internal && iface.mac !== '00:00:00:00:00:00')?.mac;
         const entropy = [
             os.hostname(),
             os.homedir(),
-            userInfo.username,
+            os.userInfo().username,
             os.platform(),
-            os.arch(),
-            macAddress
-        ].filter(Boolean) // Remove any undefined values
-        ;
+            os.arch()
+        ];
         if (entropy.length < 4) {
             throw new Error('Insufficient machine entropy available');
         }
@@ -92,5 +86,13 @@ import os from 'os';
     const key = crypto.pbkdf2Sync(machineId, salt, 100000, 32, 'sha256');
     return key.toString('hex');
 }
+/**
+ * Get a short hash of the encryption key for diagnostics.
+ * Returns first 8 chars of SHA-256 hash — enough to compare across invocations
+ * without exposing the actual key.
+ */ export function getEncryptionKeyHash() {
+    const key = deriveEncryptionKey();
+    return crypto.createHash('sha256').update(key).digest('hex').substring(0, 8);
+}
 
 //# sourceMappingURL=crypto-utils.js.map

package/dist/auth/oauth-flow.d.ts

@@ -59,4 +59,9 @@ export declare function executeOAuthFlow(tokenStore: TokenStore, options?: OAuth
  * @throws OAuthFlowError if refresh fails
  */
 export declare function getValidAccessToken(tokenStore: TokenStore): Promise<null | string>;
+/**
+ * Like getValidAccessToken but returns null instead of throwing on refresh failure.
+ * Use in commands that want to fall through to a login prompt on failure.
+ */
+export declare function tryGetAccessToken(tokenStore: TokenStore): Promise<null | string>;
 //# sourceMappingURL=oauth-flow.d.ts.map

package/dist/auth/oauth-flow.js

@@ -155,19 +155,36 @@ import { exchangeCodeForTokens, refreshAccessToken, TokenRefreshError } from './
     if (!refreshToken) {
         return null;
     }
-    // Try to refresh
+    // Try to refresh (with one retry for transient auth errors)
     try {
         const tokens = await refreshAccessToken(refreshToken);
         tokenStore.setTokens(tokens);
         return tokens.accessToken;
     } catch (error) {
-        // Only clear tokens for actual auth failures, not transient errors
         const isAuthFailure = error instanceof TokenRefreshError && (error.statusCode === 401 || error.statusCode === 403 || error.statusCode === 400 && error.errorCode === 'invalid_grant');
         if (isAuthFailure) {
-            tokenStore.clearTokens();
+            // Retry once — a transient 401 (e.g. misconfigured proxy) shouldn't wipe tokens
+            try {
+                const tokens = await refreshAccessToken(refreshToken);
+                tokenStore.setTokens(tokens);
+                return tokens.accessToken;
+            } catch  {
+                // Retry also failed — token is genuinely revoked
+                tokenStore.clearTokens();
+            }
         }
         throw new OAuthFlowError('Failed to refresh access token', error instanceof Error ? error : undefined);
     }
 }
+/**
+ * Like getValidAccessToken but returns null instead of throwing on refresh failure.
+ * Use in commands that want to fall through to a login prompt on failure.
+ */ export async function tryGetAccessToken(tokenStore) {
+    try {
+        return await getValidAccessToken(tokenStore);
+    } catch  {
+        return null;
+    }
+}
 
 //# sourceMappingURL=oauth-flow.js.map

package/dist/auth/token-store.d.ts

@@ -24,7 +24,9 @@ export declare function getTokenStore(environment?: Environment): TokenStore;
  */
 export declare class TokenStore {
     private config;
+    private environment;
     constructor(options?: TokenStoreConfig);
+    private safeGet;
     /**
      * Retrieve stored tokens
      * @returns FigmaTokens if stored, null otherwise

package/dist/auth/token-store.js

@@ -1,6 +1,8 @@
 /* eslint-disable perfectionist/sort-classes */ import Conf from 'conf';
+import fsSync from 'node:fs';
 import { TOKEN_EXPIRY_BUFFER_SECONDS } from '../config/oauth.js';
 import { getInfraEnvironment } from '../constants.js';
+import * as log from '../utils/log.js';
 import { deriveEncryptionKey } from './crypto-utils.js';
 /**
  * Environment-keyed instances for singleton pattern
@@ -34,24 +36,57 @@ import { deriveEncryptionKey } from './crypto-utils.js';
  * The constructor is still exported for test isolation.
  */ export class TokenStore {
     config;
+    environment;
     constructor(options){
         if (process.env.AWS_EXECUTION_ENV) {
             throw new Error('TokenStore cannot be used in AWS Lambda environments');
         }
         const environment = options?.environment ?? 'production';
         const projectName = environment === 'production' ? 'payloadcms-figma' : `payloadcms-figma-${environment}`;
-        this.config = new Conf({
-            clearInvalidConfig: true,
+        this.environment = environment;
+        const confOptions = {
+            clearInvalidConfig: false,
             configName: options?.configName || projectName,
             encryptionKey: options?.encryptionKey || deriveEncryptionKey(),
             projectName
-        });
+        };
+        try {
+            this.config = new Conf(confOptions);
+        } catch (error) {
+            // Deserialization failed (e.g. encryption key changed).
+            // Log diagnostics, clear the corrupted file, then create a fresh store.
+            if (environment === 'staging') {
+                log.warning(`Token store corrupted, resetting. ` + `Error: ${error instanceof Error ? error.message : 'Unknown'}`);
+            }
+            // Temporarily allow clearing so Conf can reinitialize
+            this.config = new Conf({
+                ...confOptions,
+                clearInvalidConfig: true
+            });
+            // Force a write so the corrupt file is replaced with an empty store.
+            // Without this, clearInvalidConfig only ignores bad reads in memory
+            // and the corrupt file persists, triggering this fallback every time.
+            this.config.clear();
+        }
+    }
+    safeGet(key) {
+        try {
+            return this.config.get(key);
+        } catch (error) {
+            if (this.environment === 'staging') {
+                const filePath = this.config.path;
+                const fileExists = fsSync.existsSync(filePath);
+                const fileSize = fileExists ? fsSync.statSync(filePath).size : 0;
+                log.warning(`Token store read failed (key: ${key}). ` + `File: ${filePath}, exists: ${fileExists}, size: ${fileSize}B. ` + `Error: ${error instanceof Error ? error.message : 'Unknown'}`);
+            }
+            return undefined;
+        }
     }
     /**
    * Retrieve stored tokens
    * @returns FigmaTokens if stored, null otherwise
    */ getTokens() {
-        const tokens = this.config.get('tokens');
+        const tokens = this.safeGet('tokens');
         return tokens || null;
     }
     /**
@@ -59,6 +94,16 @@ import { deriveEncryptionKey } from './crypto-utils.js';
    * @param tokens - Figma OAuth2 tokens to store
    */ setTokens(tokens) {
         this.config.set('tokens', tokens);
+        // Verify the round-trip: read back what we just wrote
+        const readBack = this.safeGet('tokens');
+        if (!readBack || readBack.accessToken !== tokens.accessToken) {
+            if (this.environment === 'staging') {
+                const filePath = this.config.path;
+                const fileExists = fsSync.existsSync(filePath);
+                const fileSize = fileExists ? fsSync.statSync(filePath).size : 0;
+                log.warning(`Token verify-after-write FAILED. ` + `File: ${filePath}, exists: ${fileExists}, size: ${fileSize}B. ` + `Written accessToken starts: ${tokens.accessToken.substring(0, 10)}..., ` + `Read back: ${readBack ? readBack.accessToken.substring(0, 10) + '...' : 'null'}`);
+            }
+        }
     }
     /**
    * Clear all stored tokens (used for logout)
@@ -80,8 +125,7 @@ import { deriveEncryptionKey } from './crypto-utils.js';
    * Includes a buffer time to avoid using tokens that are about to expire
    * @returns true if token is expired or will expire within buffer time
    */ isExpired() {
-        // Access config directly to avoid circular dependency with getTokens()
-        const tokens = this.config.get('tokens');
+        const tokens = this.safeGet('tokens');
         if (!tokens) {
             return true;
         }
@@ -136,7 +180,7 @@ import { deriveEncryptionKey } from './crypto-utils.js';
    * @param tenantId - The tenant/CMS ID
    * @returns ProjectToken if stored and valid, null otherwise
    */ getProjectToken(tenantId) {
-        const projectTokens = this.config.get('projectTokens') || {};
+        const projectTokens = this.safeGet('projectTokens') || {};
         const projectToken = projectTokens[tenantId];
         if (!projectToken) {
             return null;
@@ -153,7 +197,7 @@ import { deriveEncryptionKey } from './crypto-utils.js';
    * @param tenantId - The tenant/CMS ID
    * @param projectToken - The project token to store
    */ setProjectToken(tenantId, projectToken) {
-        const projectTokens = this.config.get('projectTokens') || {};
+        const projectTokens = this.safeGet('projectTokens') || {};
         projectTokens[tenantId] = projectToken;
         this.config.set('projectTokens', projectTokens);
     }
@@ -161,7 +205,7 @@ import { deriveEncryptionKey } from './crypto-utils.js';
    * Clear a project token for a specific tenant
    * @param tenantId - The tenant/CMS ID
    */ clearProjectToken(tenantId) {
-        const projectTokens = this.config.get('projectTokens') || {};
+        const projectTokens = this.safeGet('projectTokens') || {};
         delete projectTokens[tenantId];
         this.config.set('projectTokens', projectTokens);
     }
@@ -204,7 +248,7 @@ import { deriveEncryptionKey } from './crypto-utils.js';
    * Get all tenant IDs that have stored project tokens
    * @returns Array of tenant IDs
    */ getAllProjectTokenTenantIds() {
-        const projectTokens = this.config.get('projectTokens') || {};
+        const projectTokens = this.safeGet('projectTokens') || {};
         return Object.keys(projectTokens);
     }
     /**
@@ -221,7 +265,7 @@ import { deriveEncryptionKey } from './crypto-utils.js';
    * @param environmentName - The environment name
    * @returns BootstrapData if stored, null otherwise
    */ getBootstrapData(projectId, environmentName) {
-        const allData = this.config.get('bootstrapData') || {};
+        const allData = this.safeGet('bootstrapData') || {};
         return allData[this.bootstrapKey(projectId, environmentName)] || null;
     }
     /**
@@ -230,7 +274,7 @@ import { deriveEncryptionKey } from './crypto-utils.js';
    * @param environmentName - The environment name
    * @param data - The bootstrap data to store
    */ setBootstrapData(projectId, environmentName, data) {
-        const allData = this.config.get('bootstrapData') || {};
+        const allData = this.safeGet('bootstrapData') || {};
         allData[this.bootstrapKey(projectId, environmentName)] = data;
         this.config.set('bootstrapData', allData);
     }
@@ -239,7 +283,7 @@ import { deriveEncryptionKey } from './crypto-utils.js';
    * @param projectId - The CMS resource/project ID
    * @param environmentName - The environment name
    */ clearBootstrapData(projectId, environmentName) {
-        const allData = this.config.get('bootstrapData') || {};
+        const allData = this.safeGet('bootstrapData') || {};
         delete allData[this.bootstrapKey(projectId, environmentName)];
         this.config.set('bootstrapData', allData);
     }

package/dist/cli.js

@@ -43,8 +43,11 @@ class Main {
             '--version': Boolean,
             '--yes': Boolean,
             // Aliases
+            '--environment': '--env',
+            '-e': '--env',
             '-f': '--force',
             '-h': '--help',
+            '-n': '--name',
             '-v': '--version',
             '-y': '--yes'
         }, {

package/dist/commands/debug.js

@@ -2,6 +2,7 @@ import fsSync from 'node:fs';
 import { createRequire } from 'node:module';
 import os from 'node:os';
 import path from 'node:path';
+import { getEncryptionKeyHash } from '../auth/crypto-utils.js';
 import { getTokenStore } from '../auth/token-store.js';
 import { getInfraEnvironment } from '../constants.js';
 import { getEnvVarSync } from '../utils/env-management.js';
@@ -22,6 +23,7 @@ import { getOwnVersion } from '../utils/version-check.js';
     ];
     appendSystemSection(lines, env);
     appendAuthSection(lines, tokenStore, cwd);
+    appendTokenStoreDiagnostics(lines, tokenStore);
     appendProjectSection(lines, tokenStore, cwd);
     await appendPackagesSection(lines);
     // eslint-disable-next-line no-console
@@ -52,6 +54,19 @@ function appendAuthSection(lines, tokenStore, cwd) {
     lines.push(`  Token Expires:    ${formatExpiryTime(tokens.expiresAt)}`);
     lines.push('');
 }
+function appendTokenStoreDiagnostics(lines, tokenStore) {
+    lines.push('Token Store:');
+    const filePath = tokenStore.getStoragePath();
+    const fileExists = fsSync.existsSync(filePath);
+    const fileSize = fileExists ? fsSync.statSync(filePath).size : 0;
+    lines.push(`  File:             ${filePath}`);
+    lines.push(`  File Exists:      ${fileExists}`);
+    lines.push(`  File Size:        ${fileSize}B`);
+    const canRead = tokenStore.getTokens() !== null || tokenStore.getRefreshToken() !== null;
+    lines.push(`  Decryption:       ${fileExists ? canRead || fileSize === 0 ? 'OK' : 'FAILED' : 'N/A'}`);
+    lines.push(`  Key Hash:         ${getEncryptionKeyHash()}`);
+    lines.push('');
+}
 function appendProjectSection(lines, tokenStore, cwd) {
     const projectId = getEnvVarSync(cwd, 'FIGMA_PROJECT_ID');
     const environmentName = getEnvVarSync(cwd, 'FIGMA_ENVIRONMENT_NAME');

package/dist/commands/deploy.js

@@ -3,9 +3,9 @@ import spawn from 'cross-spawn';
 import path from 'path';
 import pc from 'picocolors';
 import { ControlPlaneError, createDeployment, getBootstrapInfo, performDeployment } from '../api/control-plane.js';
-import { getValidAccessToken } from '../auth/oauth-flow.js';
+import { tryGetAccessToken } from '../auth/oauth-flow.js';
 import { getTokenStore } from '../auth/token-store.js';
-import { CONTENT_SYSTEM_NOT_FOUND_MESSAGE } from '../constants.js';
+import { getInfraEnvironment, getProjectNotFoundMessage } from '../constants.js';
 import { collectStaticAssets, createLambdaZip, getFileSize } from '../utils/asset-collection.js';
 import { detectBuild, getBuildCommand } from '../utils/build-detection.js';
 import { getEnvVar } from '../utils/env-management.js';
@@ -71,11 +71,11 @@ import { loginCommand } from './login.js';
         }
         // Check authentication
         const tokenStore = getTokenStore();
-        let accessToken = await getValidAccessToken(tokenStore);
+        let accessToken = await tryGetAccessToken(tokenStore);
         if (!accessToken) {
             p.log.message('Please log in to continue');
             await loginCommand();
-            accessToken = await getValidAccessToken(tokenStore);
+            accessToken = await tryGetAccessToken(tokenStore);
             if (!accessToken) {
                 p.log.error(pc.red('✗ Authentication failed'));
                 process.exit(1);
@@ -94,14 +94,19 @@ import { loginCommand } from './login.js';
             spinner.stop(pc.green(`✓ Target: ${resolvedEnv.name}`));
         } catch (error) {
             if (error instanceof ControlPlaneError && (error.statusCode === 404 || error.statusCode === 410)) {
-                spinner.stop(pc.red('✗ Content system not found'));
-                p.log.error(pc.red(CONTENT_SYSTEM_NOT_FOUND_MESSAGE));
+                spinner.stop(pc.red('✗ Project not found'));
+                p.log.error(pc.red(getProjectNotFoundMessage({
+                    environment: getInfraEnvironment(),
+                    projectId
+                })));
                 process.exit(1);
             }
             spinner.stop(pc.red('✗ Failed to resolve deployment target'));
             p.log.error(error instanceof Error ? error.message : 'Unknown error');
             process.exit(1);
         }
+        // Signal buildFigmaConfig to extract schedules during build
+        process.env.FIGMA_EXTRACT_SCHEDULES = 'true';
         // ===== BUILD =====
         let buildInfo;
         if (options.skipBuild) {
@@ -179,7 +184,7 @@ import { loginCommand } from './login.js';
             buildInfo = await detectBuild(projectPath);
             if (!buildInfo) {
                 p.log.error(pc.red('✗ Build completed but standalone build not found'));
-                p.note('Ensure next.config.js has output: "standalone"', 'Check Lambda Configuration');
+                p.note('Ensure next.config has output: "standalone"', 'Check Lambda Configuration');
                 process.exit(1);
             }
         }

package/dist/commands/init.js

@@ -4,10 +4,10 @@ import path from 'path';
 import pc from 'picocolors';
 import { ControlPlaneError, getBootstrapInfo } from '../api/control-plane.js';
 import { FigmaApiError } from '../api/figma-api.js';
-import { getValidAccessToken } from '../auth/oauth-flow.js';
+import { tryGetAccessToken } from '../auth/oauth-flow.js';
 import { getValidProjectToken, ProjectTokenError } from '../auth/project-token.js';
 import { getTokenStore } from '../auth/token-store.js';
-import { CONTENT_SYSTEM_NOT_FOUND_MESSAGE, getInfraEnvironment } from '../constants.js';
+import { getInfraEnvironment, getProjectNotFoundMessage } from '../constants.js';
 import { ensureGitignore } from '../utils/config.js';
 import { addOrUpdateEnvVar } from '../utils/env-management.js';
 import { isDebug } from '../utils/is-debug.js';
@@ -77,33 +77,24 @@ import { cacheAllEnvironments } from '../utils/cache-bootstrap.js';
         // Skip authentication for testing/development
         p.log.warn(pc.yellow('Skipping authentication (--skip-auth mode)'));
     } else {
-        try {
-            // Check for valid cached tokens first (no API call needed)
-            if (!tokenStore.hasValidTokens()) {
-                // Need to refresh or authenticate - show spinner for API call
-                s.start('Checking authentication...');
-                const token = await getValidAccessToken(tokenStore);
-                if (!token) {
-                    s.stop('Authentication required to continue');
-                    // Run login command
-                    await loginCommand({
-                        showNextSteps: false
-                    });
-                    // Get token after auth
-                    const newToken = await getValidAccessToken(tokenStore);
-                    if (!newToken) {
-                        p.log.error('Authentication failed');
-                        process.exit(1);
-                    }
-                } else {
-                    s.stop(pc.green('✓ Authenticated'));
+        // Check for valid cached tokens first (no API call needed)
+        if (!tokenStore.hasValidTokens()) {
+            // Need to refresh or authenticate - show spinner for API call
+            s.start('Checking authentication...');
+            const token = await tryGetAccessToken(tokenStore);
+            if (!token) {
+                s.stop('Authentication required to continue');
+                await loginCommand({
+                    showNextSteps: false
+                });
+                const newToken = await tryGetAccessToken(tokenStore);
+                if (!newToken) {
+                    p.log.error('Authentication failed');
+                    process.exit(1);
                 }
+            } else {
+                s.stop(pc.green('✓ Authenticated'));
             }
-        } catch (error) {
-            s.stop(pc.red('✗ Authentication failed'));
-            log.error(error instanceof Error ? error.message : 'Unknown error');
-            p.note('Run `figma auth` to authenticate', 'Tip');
-            process.exit(1);
         }
     }
     // Note: We no longer check for figma.config.json here
@@ -122,21 +113,17 @@ import { cacheAllEnvironments } from '../utils/cache-bootstrap.js';
     let oauthClientId = null;
     let oauthClientSecret = null;
     if (!options.skipAuth) {
-        const accessToken = await getValidAccessToken(tokenStore);
+        const accessToken = await tryGetAccessToken(tokenStore);
         if (accessToken) {
             try {
                 bootstrapInfo = await getBootstrapInfo(accessToken, cmsResourceId);
-                const envName = options.env ?? process.env.FIGMA_ENVIRONMENT_NAME ?? undefined;
-                resolvedEnv = resolveEnvironment({
-                    environmentName: envName,
-                    environments: bootstrapInfo.environments
-                });
-                oauthClientId = bootstrapInfo.oauthCredentials.oauthClientId;
-                oauthClientSecret = bootstrapInfo.oauthCredentials.oauthClientSecret;
             } catch (error) {
                 log.debug(`Control Plane Error: ${error.statusCode} - ${error.message}`);
                 if (error instanceof ControlPlaneError && (error.statusCode === 404 || error.statusCode === 410)) {
-                    p.log.error(pc.red(CONTENT_SYSTEM_NOT_FOUND_MESSAGE));
+                    p.log.error(pc.red(getProjectNotFoundMessage({
+                        environment: getInfraEnvironment(),
+                        projectId: cmsResourceId
+                    })));
                     process.exit(1);
                 }
                 const message = error instanceof Error ? error.message : 'Unknown error';
@@ -144,6 +131,18 @@ import { cacheAllEnvironments } from '../utils/cache-bootstrap.js';
                 p.log.error(pc.dim(`Details: ${message}`));
                 process.exit(1);
             }
+            try {
+                const envName = options.env ?? process.env.FIGMA_ENVIRONMENT_NAME ?? undefined;
+                resolvedEnv = resolveEnvironment({
+                    environmentName: envName,
+                    environments: bootstrapInfo.environments
+                });
+                oauthClientId = bootstrapInfo.oauthCredentials.oauthClientId;
+                oauthClientSecret = bootstrapInfo.oauthCredentials.oauthClientSecret;
+            } catch (error) {
+                p.log.error(pc.red(error instanceof Error ? error.message : 'Unknown error'));
+                process.exit(1);
+            }
         }
     }
     // Step 4: Detect or scaffold Payload project
@@ -238,7 +237,10 @@ import { cacheAllEnvironments } from '../utils/cache-bootstrap.js';
             process.exit(1);
         }
         // Generate import map to prevent errors on first dev run
-        await runScript(process.cwd(), 'generate:importmap', packageManager);
+        const importMapResult = await runScript(process.cwd(), 'generate:importmap', packageManager);
+        if (!importMapResult) {
+            p.log.warn(pc.yellow('⚠ Import map generation failed — it will be generated on first dev run'));
+        }
         // Apply Lambda modifications (run.sh, standalone output, lambda:buildzip script)
         await applyLambdaModifications(process.cwd(), packageManager);
         // Ensure .gitignore has required entries
@@ -260,27 +262,30 @@ import { cacheAllEnvironments } from '../utils/cache-bootstrap.js';
     } else {
         // ===== NEW PROJECT FLOW =====
         // p.log.info('No project detected - Creating New Project')
-        // Prompt for path
-        const projectPathInput = await p.text({
-            initialValue: './',
-            message: 'Enter path to create project:',
-            placeholder: './my-cms-project',
-            validate: (value)=>{
-                if (!value) {
-                    return 'Path is required';
+        let projectPath;
+        if (options.name) {
+            projectPath = options.name;
+        } else {
+            const projectPathInput = await p.text({
+                initialValue: './',
+                message: 'Enter path to create project:',
+                placeholder: './my-cms-project',
+                validate: (value)=>{
+                    if (!value) {
+                        return 'Path is required';
+                    }
+                    // Allow relative or absolute paths
+                    return undefined;
                 }
-                // Allow relative or absolute paths
-                return undefined;
+            });
+            if (p.isCancel(projectPathInput)) {
+                p.cancel('Operation cancelled');
+                process.exit(0);
             }
-        });
-        if (p.isCancel(projectPathInput)) {
-            p.cancel('Operation cancelled');
-            process.exit(0);
+            projectPath = projectPathInput;
         }
-        const projectPath = projectPathInput;
         const fullPath = path.resolve(process.cwd(), projectPath);
-        // Get project name from path or prompt
-        const projectName = options.name || path.basename(fullPath);
+        const projectName = path.basename(fullPath);
         const packageManager = detectPackageManagerFromEnvironment();
         // Create directory
         try {
@@ -346,7 +351,10 @@ import { cacheAllEnvironments } from '../utils/cache-bootstrap.js';
             p.log.warn(pc.yellow(`⚠ Failed to update .env file: ${error instanceof Error ? error.message : 'Unknown error'}`));
         }
         // Generate import map to prevent errors on first dev run
-        await runScript(fullPath, 'generate:importmap', packageManager);
+        const importMapResult = await runScript(fullPath, 'generate:importmap', packageManager);
+        if (!importMapResult) {
+            p.log.warn(pc.yellow('⚠ Import map generation failed — it will be generated on first dev run'));
+        }
         // Generate project token (unless skipping auth)
         if (!options.skipAuth && resolvedEnv) {
             await generateProjectTokenWithFeedback(tokenStore, resolvedEnv.contentSystemId, s);

package/dist/constants.d.ts

@@ -23,9 +23,17 @@ type EnvironmentConfig = {
 export declare const ENV_CONFIG: Record<Environment, EnvironmentConfig>;
 /**
  * User-facing error message when Content API returns 404 or 410.
- * Used across CLI commands and the db adapter for consistent messaging.
+ * Used by the db adapter for consistent messaging at runtime.
  */
 export declare const CONTENT_SYSTEM_NOT_FOUND_MESSAGE = "Content system not found. Verify your Content System ID is correct, or contact your team admin for assistance.";
+/**
+ * Build a user-facing error message for CLI commands when a project is not found (404/410).
+ * Includes infra-env context and actionable suggestions.
+ */
+export declare function getProjectNotFoundMessage(params: {
+    environment: Environment;
+    projectId: string;
+}): string;
 /**
  * Set infrastructure environment override (used by --infra-env CLI flag)
  * Pass undefined to clear the override

package/dist/constants.js

@@ -22,8 +22,22 @@ import { getEnvVarSync } from './utils/env-management.js';
 };
 /**
  * User-facing error message when Content API returns 404 or 410.
- * Used across CLI commands and the db adapter for consistent messaging.
+ * Used by the db adapter for consistent messaging at runtime.
  */ export const CONTENT_SYSTEM_NOT_FOUND_MESSAGE = 'Content system not found. Verify your Content System ID is correct, or contact your team admin for assistance.';
+/**
+ * Build a user-facing error message for CLI commands when a project is not found (404/410).
+ * Includes infra-env context and actionable suggestions.
+ */ export function getProjectNotFoundMessage(params) {
+    const { environment, projectId } = params;
+    return [
+        `Project not found on ${environment} (ID: ${projectId}).`,
+        '',
+        'Suggestions:',
+        '  • Verify your project ID is correct',
+        "  • Ensure you're logged into the correct Figma account",
+        '  • Contact your team admin for assistance'
+    ].join('\n');
+}
 let envOverride;
 /**
  * Set infrastructure environment override (used by --infra-env CLI flag)
@@ -55,6 +69,7 @@ export function getInfraEnvironment() {
             return 'staging';
         }
         if (env !== 'production') {
+            // eslint-disable-next-line no-console
             console.warn(`Warning: Invalid FIGMA_INFRA_ENV value "${envFileValue}" in .env file. Using production.`);
         }
         return 'production';

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

@@ -13,6 +13,7 @@ export type ContentAPIAdapter = {
     clearDatabase: () => Promise<void>;
     client: ReturnType<typeof createClient<paths>>;
     contentSystemId: string;
+    idType: 'uuid';
     url: string;
 } & BaseDatabaseAdapter;
 export declare const contentAPIAdapter: (opts: ContentAPIOptions) => DatabaseAdapterObj;