@payloadcms/figma 0.1.0-alpha.2 → 0.1.0-alpha.4

package/dist/cli.js

@@ -11,10 +11,51 @@ import { initCommand } from './commands/init.js';
 import { listTokensCommand } from './commands/list-tokens.js';
 import { loginCommand } from './commands/login.js';
 import { logoutCommand } from './commands/logout.js';
+import { setupAgentCommand } from './commands/setup-agent.js';
 import { upgradeCommand } from './commands/upgrade.js';
 import { uploadSchemaCommand } from './commands/upload-schema.js';
 import { setInfraEnvironment } from './constants.js';
 import { helpMessage } from './utils/messages.js';
+export const cliArgSpec = {
+    '--adapter': String,
+    '--all': Boolean,
+    '--callback-url': String,
+    '--complete': String,
+    '--debug': Boolean,
+    '--description': String,
+    '--dry-run': Boolean,
+    '--env': String,
+    '--force': Boolean,
+    '--global': Boolean,
+    '--headless': Boolean,
+    '--help': Boolean,
+    '--id': String,
+    '--infra-env': String,
+    '--json': Boolean,
+    '--name': String,
+    '--no-agent': Boolean,
+    '--output': String,
+    '--payload-version': String,
+    '--project': Boolean,
+    '--region': String,
+    '--skip-auth': Boolean,
+    '--skip-build': Boolean,
+    '--skip-size-check': Boolean,
+    '--subdomain': String,
+    '--template': String,
+    '--version': Boolean,
+    '--workspace': String,
+    '--yes': Boolean,
+    // Aliases
+    '--environment': '--env',
+    '-e': '--env',
+    '-f': '--force',
+    '-h': '--help',
+    '-n': '--name',
+    '-t': '--template',
+    '-v': '--version',
+    '-y': '--yes'
+};
 /**
  * Entrypoint for bin/cli.js
  */ export async function main() {
@@ -31,39 +72,7 @@ class Main {
     args;
     constructor(){
         // @ts-expect-error bad typings
-        this.args = arg({
-            // Hidden flag — intentionally not displayed in help output yet.
-            // Auto-detection covers most cases; this is an escape hatch for testing.
-            // May expose in help text once multi-framework support is public.
-            '--adapter': String,
-            '--all': Boolean,
-            '--debug': Boolean,
-            '--dry-run': Boolean,
-            '--env': String,
-            '--force': Boolean,
-            '--help': Boolean,
-            '--id': String,
-            '--infra-env': String,
-            '--json': Boolean,
-            '--name': String,
-            '--no-skill': Boolean,
-            '--payload-version': String,
-            '--skip-auth': Boolean,
-            '--skip-build': Boolean,
-            '--skip-size-check': Boolean,
-            '--template': String,
-            '--version': Boolean,
-            '--yes': Boolean,
-            // Aliases
-            '--environment': '--env',
-            '-e': '--env',
-            '-f': '--force',
-            '-h': '--help',
-            '-n': '--name',
-            '-t': '--template',
-            '-v': '--version',
-            '-y': '--yes'
-        }, {
+        this.args = arg(cliArgSpec, {
             permissive: true
         });
         // Set debug flag globally
@@ -105,7 +114,16 @@ class Main {
                 helpMessage();
                 process.exit(0);
             }
-            // Debug command outputs plain text for copy-paste — skip styled intro
+            // JSON and debug commands output plain text — skip styled intro.
+            if (subcommand === 'login' && this.args['--json']) {
+                await loginCommand({
+                    callbackUrl: this.args['--callback-url'],
+                    completeSessionId: this.args['--complete'],
+                    headless: this.args['--headless'],
+                    json: true
+                });
+                process.exit(0);
+            }
             if (subcommand === 'debug') {
                 await debugCommand();
                 process.exit(0);
@@ -133,11 +151,17 @@ class Main {
                 case 'deploy':
                     await deployCommand({
                         id: this.args['--id'],
+                        name: this.args['--name'],
                         adapter: this.args['--adapter'],
                         debug: this.args['--debug'],
+                        description: this.args['--description'],
                         env: this.args['--env'],
+                        output: this.args['--output'],
+                        region: this.args['--region'],
                         skipBuild: this.args['--skip-build'],
                         skipSizeCheck: this.args['--skip-size-check'],
+                        subdomain: this.args['--subdomain'],
+                        workspace: this.args['--workspace'],
                         yes: this.args['--yes']
                     });
                     break;
@@ -153,7 +177,7 @@ class Main {
                         debug: this.args['--debug'],
                         env: this.args['--env'],
                         force: this.args['--force'],
-                        noSkill: this.args['--no-skill'],
+                        noAgent: this.args['--no-agent'],
                         payloadVersion: this.args['--payload-version'],
                         skipAuth: this.args['--skip-auth'],
                         template: this.args['--template']
@@ -166,7 +190,11 @@ class Main {
                     });
                     break;
                 case 'login':
-                    await loginCommand();
+                    await loginCommand({
+                        callbackUrl: this.args['--callback-url'],
+                        completeSessionId: this.args['--complete'],
+                        headless: this.args['--headless']
+                    });
                     break;
                 case 'logout':
                     await logoutCommand({
@@ -174,6 +202,13 @@ class Main {
                         debug: this.args['--debug']
                     });
                     break;
+                case 'setup-agent':
+                    await setupAgentCommand({
+                        global: this.args['--global'],
+                        project: this.args['--project'],
+                        yes: this.args['--yes']
+                    });
+                    break;
                 case 'upgrade':
                     await upgradeCommand({
                         isDryRun: this.args['--dry-run']

package/dist/commands/bootstrap.js

@@ -1,6 +1,7 @@
 import * as p from '@clack/prompts';
 import pc from 'picocolors';
-import { ControlPlaneError, getBootstrapInfo } from '../api/control-plane.js';
+import { getBootstrapInfo } from '../api/control-plane.js';
+import { ControlPlaneError } from '../api/control-plane-error.js';
 import { getValidCredential } from '../auth/oauth-flow.js';
 import { getTokenStore } from '../auth/token-store.js';
 import { getInfraEnvironment } from '../constants.js';

package/dist/commands/deploy.d.ts

@@ -7,14 +7,26 @@ export interface DeployCommandOptions {
     adapter?: AdapterName;
     /** Enable debug mode */
     debug?: boolean;
+    /** Description used when creating an uninitialized project */
+    description?: string;
     /** Figma environment name (e.g. 'production', 'staging') */
     env?: string;
     /** CMS Resource ID (overrides FIGMA_PROJECT_ID) */
     id?: string;
+    /** Name used when creating an uninitialized project */
+    name?: string;
+    /** Exact framework build output root */
+    output?: string;
+    /** Region used when creating an uninitialized project */
+    region?: string;
     /** Skip the build step (use existing build) */
     skipBuild?: boolean;
     /** Skip the client-side unzipped bundle size pre-flight check */
     skipSizeCheck?: boolean;
+    /** Subdomain used when creating an uninitialized project */
+    subdomain?: string;
+    /** Workspace plan key used when creating an uninitialized project */
+    workspace?: string;
     /** Skip confirmation prompts */
     yes?: boolean;
 }

package/dist/commands/deploy.js

@@ -1,7 +1,9 @@
 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 { createDeployment, getBootstrapInfo, performDeployment } from '../api/control-plane.js';
+import { ControlPlaneError } from '../api/control-plane-error.js';
 import { tryGetCredential } from '../auth/oauth-flow.js';
 import { getTokenStore } from '../auth/token-store.js';
 import { getInfraEnvironment, getProjectNotFoundMessage } from '../constants.js';
@@ -15,7 +17,10 @@ import { getPackageManager } from '../utils/package-manager.js';
 import { isInProjectDirectory } from '../utils/project.js';
 import { resolveEnvironment } from '../utils/resolve-environment.js';
 import { uploadLambdaZip, uploadStaticAssets } from '../utils/s3-upload.js';
+import { detectProjectResourceType } from './detect-project-resource-type.js';
 import { loginCommand } from './login.js';
+import { promptToCreateProject } from './prompt-to-create-project.js';
+import { writeProjectConfiguration } from './write-project-configuration.js';
 /**
  * Format bytes to human-readable string
  */ function formatBytes(bytes) {
@@ -51,23 +56,14 @@ import { loginCommand } from './login.js';
  */ export async function deployCommand(options) {
     const projectPath = process.cwd();
     const spinner = p.spinner();
-    // Resolve project ID
-    let projectId = options.id;
-    if (!projectId) {
-        projectId = await getEnvVar(projectPath, 'FIGMA_PROJECT_ID') ?? undefined;
-    }
-    if (!projectId) {
-        p.log.error(pc.red('✗ Project ID not found. Run `@payloadcms/figma init` first, or use --id.'));
-        process.exit(1);
-    }
     // Resolve environment name
     const environmentName = options.env ?? await getEnvVar(projectPath, 'FIGMA_ENVIRONMENT_NAME') ?? undefined;
     try {
         // ===== PRE-FLIGHT CHECKS =====
-        // Check if in project directory
-        if (!await isInProjectDirectory(projectPath)) {
-            p.log.error(pc.red("✗ 'deploy' command is not available outside of a Payload project."));
-            p.note('Create a project or connect an existing one to Figma: npx @payloadcms/figma init', 'Tip');
+        // Building requires package.json, but --skip-build can deploy a prebuilt artifact directly.
+        if (!options.skipBuild && !await isInProjectDirectory(projectPath)) {
+            p.log.error(pc.red('✗ Cannot build because package.json was not found in this directory.'));
+            p.note('Run from a package directory, or deploy prebuilt output with --skip-build --output <path>.', 'Tip');
             process.exit(1);
         }
         // Check authentication
@@ -75,13 +71,38 @@ import { loginCommand } from './login.js';
         let credential = await tryGetCredential(tokenStore);
         if (!credential) {
             p.log.message('Please log in to continue');
-            await loginCommand();
+            await loginCommand({
+                openBrowserWithoutPrompt: options.yes
+            });
             credential = await tryGetCredential(tokenStore);
             if (!credential) {
                 p.log.error(pc.red('✗ Authentication failed'));
                 process.exit(1);
             }
         }
+        // Resolve or create the CMS project.
+        let projectId = options.id;
+        if (!projectId) {
+            projectId = await getEnvVar(projectPath, 'FIGMA_PROJECT_ID') ?? undefined;
+        }
+        const isProjectCreated = !projectId;
+        if (!projectId) {
+            const resourceType = options.adapter === 'vite' ? 'vite' : options.adapter ? 'payload' : await detectProjectResourceType(projectPath);
+            const project = await promptToCreateProject({
+                credential,
+                inputs: {
+                    name: options.name,
+                    description: options.description,
+                    region: options.region,
+                    subdomain: options.subdomain,
+                    workspacePlanKey: options.workspace
+                },
+                nonInteractive: options.yes,
+                projectPath,
+                resourceType
+            });
+            projectId = project.id;
+        }
         // Resolve tenant instance ID via bootstrap
         spinner.start('Resolving deployment target...');
         let tenantInstanceId;
@@ -92,6 +113,14 @@ import { loginCommand } from './login.js';
                 environments: bootstrapInfo.environments
             });
             tenantInstanceId = resolvedEnv.tenantInstanceId;
+            await writeProjectConfiguration({
+                bootstrapInfo,
+                environmentName: resolvedEnv.name,
+                projectDir: projectPath,
+                projectId,
+                shouldWriteEnvironmentVariables: isProjectCreated,
+                tokenStore
+            });
             spinner.stop(pc.green(`✓ Target: ${resolvedEnv.name}`));
         } catch (error) {
             if (error instanceof ControlPlaneError && (error.statusCode === 404 || error.statusCode === 410)) {
@@ -110,13 +139,18 @@ import { loginCommand } from './login.js';
         process.env.FIGMA_EXTRACT_SCHEDULES = 'true';
         // ===== BUILD =====
         let buildInfo;
+        const buildOptions = {
+            adapter: options.adapter,
+            output: options.output
+        };
         if (options.skipBuild) {
             // User asserts build exists - verify it
             spinner.start('Checking for build...');
-            buildInfo = await detectBuild(projectPath);
+            buildInfo = await detectBuild(projectPath, buildOptions);
             if (!buildInfo) {
                 spinner.stop(pc.red('✗ No build found'));
-                p.log.error('Use deploy without --skip-build to build first.');
+                p.log.error(getMissingBuildMessage(projectPath, options));
+                p.note('Use deploy without --skip-build to build first.', 'Tip');
                 process.exit(1);
             }
             spinner.stop(pc.green('✓ Build found'));
@@ -182,9 +216,9 @@ import { loginCommand } from './login.js';
                 process.exit(1);
             }
             // Verify build output
-            buildInfo = await detectBuild(projectPath);
+            buildInfo = await detectBuild(projectPath, buildOptions);
             if (!buildInfo) {
-                p.log.error(pc.red('✗ Build completed but build output not found'));
+                p.log.error(pc.red(`✗ ${getMissingBuildMessage(projectPath, options)}`));
                 p.note('Ensure your build produces a valid output directory.', 'Check Build Configuration');
                 process.exit(1);
             }
@@ -192,12 +226,12 @@ import { loginCommand } from './login.js';
         // ===== DEPLOYMENT PREPARATION =====
         // Detect framework adapter
         spinner.start('Detecting framework...');
-        const adapter = await detectAdapter(projectPath, options.adapter);
+        const adapter = await detectAdapter(projectPath, options.adapter, options.output);
         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 pages = await adapter.collectPages(projectPath, options.output);
+        const assets = await adapter.collectAssets(projectPath, options.output);
         spinner.stop(pc.green(`✓ ${pages.routes.length} pages, ${assets.routes.length} assets detected`));
         // Create deployment package (if server adapter)
         let zipPath = null;
@@ -205,7 +239,7 @@ import { loginCommand } from './login.js';
         let unzippedBytes = 0;
         spinner.start('Creating deployment package...');
         try {
-            const bundle = await adapter.prepareLambdaBundle(projectPath);
+            const bundle = await adapter.prepareLambdaBundle(projectPath, options.output);
             if (bundle) {
                 zipPath = bundle.zipPath;
                 unzippedBytes = bundle.unzippedBytes;
@@ -342,3 +376,7 @@ import { loginCommand } from './login.js';
         process.exit(1);
     }
 }
+function getMissingBuildMessage(projectPath, options) {
+    const location = options.output ? ` at ${path.resolve(projectPath, options.output)}` : '';
+    return options.adapter ? `No ${options.adapter} build found${location}.` : `No supported build found${location}.`;
+}

package/dist/commands/detect-project-resource-type.d.ts

@@ -0,0 +1,3 @@
+import type { ProjectResourceType } from '../api/project-resource-type.js';
+/** Detect whether project provisioning should use static Vite or Payload infrastructure. */
+export declare function detectProjectResourceType(projectPath?: string): Promise<ProjectResourceType>;

package/dist/commands/detect-project-resource-type.js

@@ -0,0 +1,28 @@
+import fs from 'fs/promises';
+import path from 'path';
+/** Detect whether project provisioning should use static Vite or Payload infrastructure. */ export async function detectProjectResourceType(projectPath = process.cwd()) {
+    try {
+        const content = await fs.readFile(path.join(projectPath, 'package.json'), 'utf-8');
+        const packageJson = JSON.parse(content);
+        const dependencies = {
+            ...packageJson.dependencies,
+            ...packageJson.devDependencies
+        };
+        if (dependencies.payload) {
+            return 'payload';
+        }
+        if (dependencies.vite || Object.values(packageJson.scripts ?? {}).some((script)=>/\bvite\b/.test(script))) {
+            return 'vite';
+        }
+    } catch (error) {
+        if (error.code !== 'ENOENT') {
+            return 'payload';
+        }
+    }
+    try {
+        await fs.access(path.join(projectPath, 'index.html'));
+        return 'vite';
+    } catch  {
+        return 'payload';
+    }
+}

package/dist/commands/init.d.ts

@@ -12,8 +12,8 @@ export interface InitCommandOptions {
     id?: string;
     /** Project name (for scaffolding) */
     name?: string;
-    /** Skip Payload skill installation */
-    noSkill?: boolean;
+    /** Skip writing AI agent config files (AGENTS.md, CLAUDE.md) */
+    noAgent?: boolean;
     /** npm dist-tag or explicit version for core payload packages (e.g. 'canary', 'latest', '4.0.0-canary.16'); defaults to 'canary' */
     payloadVersion?: string;
     /** Skip authentication check (for testing/development) */