@payloadcms/figma 0.0.1-alpha.1 → 0.0.1-alpha.11

package/dist/plugin/build-config.js

@@ -1,6 +1,10 @@
 import { lexicalEditor } from '@payloadcms/richtext-lexical';
 import { buildConfig as payloadBuildConfig } from 'payload';
-import { figmaContentSystem } from './adapter.js';
+import { getValidProjectToken } from '../auth/project-token.js';
+import { TokenStore } from '../auth/token-store.js';
+import { contentAPIAdapter } from '../db-adapter.js';
+import { health } from '../endpoints/health.js';
+import { oAuth2Plugin } from '../oauth/index.js';
 /**
  * Figma platform wrapper for Payload's buildConfig.
  * Automatically injects:
@@ -11,12 +15,58 @@ import { figmaContentSystem } from './adapter.js';
  * @param config - Payload configuration (db and secret omitted, editor optional)
  * @returns Promise<SanitizedConfig> - Built Payload configuration
  */ export async function buildConfig(config) {
+    let projectToken = '';
+    if (!process.env.FIGMA_CONTENT_API_ACCESS_KEY) {
+        const retrievedToken = await getValidProjectToken(new TokenStore(), config.figma.tenantId);
+        if (retrievedToken) {
+            projectToken = retrievedToken;
+        }
+    }
     // Build complete config with Figma platform defaults
     const configWithFigmaDefaults = {
         ...config,
-        db: figmaContentSystem(),
+        custom: {
+            figma: config.figma || {}
+        },
+        // TODO: - cms-tenants-001-staging needs to be dynamic in the future
+        db: config.figma.useContentSystem !== false ? contentAPIAdapter({
+            contentApiKey: process.env.FIGMA_CONTENT_API_ACCESS_KEY,
+            contentApiUrl: process.env.FIGMA_CONTENT_API_URL || `https://${config.figma.region}.cms-tenants-001-staging.figmacontentstaging.com`,
+            contentSystemId: config.figma.tenantId,
+            projectToken
+        }) : config.db,
         editor: config.editor ?? lexicalEditor(),
-        secret: 'MY_SECRET'
+        endpoints: [
+            ...config.endpoints ?? [],
+            health
+        ],
+        secret: 'MY_SECRET',
+        // Add oauth to plugins if not already present
+        plugins: [
+            ...config.plugins ?? [],
+            oAuth2Plugin({
+                collections: [
+                    {
+                        slug: 'users',
+                        // Use adapter because Figma app doesn't support OIDC scopes
+                        authorizationURLParams: {
+                            response_mode: 'query',
+                            response_type: 'code'
+                        },
+                        clientID: process.env.FIGMA_OAUTH_CLIENT_ID,
+                        clientSecret: process.env.FIGMA_OAUTH_CLIENT_SECRET,
+                        identityMetadata: 'https://staging.figma.com/.well-known/openid-configuration',
+                        scope: [
+                            'current_user:read'
+                        ],
+                        token: 'id_token',
+                        usernameField: 'email'
+                    }
+                ],
+                debug: !!process.env.DEBUG,
+                disabled: false
+            })
+        ]
     };
     // Delegate to Payload's buildConfig
     return await payloadBuildConfig(configWithFigmaDefaults);

package/dist/plugin/build-config.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/plugin/build-config.ts"],"sourcesContent":["import type { Config, SanitizedConfig } from 'payload'\n\nimport { lexicalEditor } from '@payloadcms/richtext-lexical'\nimport { buildConfig as payloadBuildConfig } from 'payload'\n\nimport { figmaContentSystem } from './adapter.js'\n\n/**\n * Configuration type for Payload projects on the Figma platform.\n *\n * Differences from standard Payload Config:\n * - `db`: Omitted (auto-injected by Figma platform)\n * - `secret`: Omitted (auto-injected by Figma platform)\n * - `editor`: Optional (defaults to lexicalEditor() if not provided)\n *\n * @example\n * // Minimal config\n * const config: FigmaConfig = {\n *   collections: [...]\n * }\n *\n * @example\n * // With custom editor\n * const config: FigmaConfig = {\n *   collections: [...],\n *   editor: lexicalEditor({ features: [...] })\n * }\n */\nexport type FigmaConfig = {\n  editor?: Config['editor']\n} & Omit<Config, 'db' | 'editor' | 'secret'>\n\n/**\n * Figma platform wrapper for Payload's buildConfig.\n * Automatically injects:\n * - Figma database adapter\n * - Secret (platform-provided)\n * - Default lexicalEditor (if no custom editor specified)\n *\n * @param config - Payload configuration (db and secret omitted, editor optional)\n * @returns Promise<SanitizedConfig> - Built Payload configuration\n */\nexport async function buildConfig(config: FigmaConfig): Promise<SanitizedConfig> {\n  // Build complete config with Figma platform defaults\n  const configWithFigmaDefaults: Config = {\n    ...config,\n    db: figmaContentSystem(),\n    editor: config.editor ?? lexicalEditor(),\n    secret: 'MY_SECRET',\n  }\n\n  // Delegate to Payload's buildConfig\n  return await payloadBuildConfig(configWithFigmaDefaults)\n}\n"],"names":["lexicalEditor","buildConfig","payloadBuildConfig","figmaContentSystem","config","configWithFigmaDefaults","db","editor","secret"],"mappings":"AAEA,SAASA,aAAa,QAAQ,+BAA8B;AAC5D,SAASC,eAAeC,kBAAkB,QAAQ,UAAS;AAE3D,SAASC,kBAAkB,QAAQ,eAAc;AA2BjD;;;;;;;;;CASC,GACD,OAAO,eAAeF,YAAYG,MAAmB;IACnD,qDAAqD;IACrD,MAAMC,0BAAkC;QACtC,GAAGD,MAAM;QACTE,IAAIH;QACJI,QAAQH,OAAOG,MAAM,IAAIP;QACzBQ,QAAQ;IACV;IAEA,oCAAoC;IACpC,OAAO,MAAMN,mBAAmBG;AAClC"}
+{"version":3,"sources":["../../src/plugin/build-config.ts"],"sourcesContent":["import type { Config, SanitizedConfig } from 'payload'\n\nimport { lexicalEditor } from '@payloadcms/richtext-lexical'\nimport { buildConfig as payloadBuildConfig } from 'payload'\n\nimport { getValidProjectToken } from '../auth/project-token.js'\nimport { TokenStore } from '../auth/token-store.js'\nimport { contentAPIAdapter } from '../db-adapter.js'\nimport { health } from '../endpoints/health.js'\nimport { oAuth2Plugin } from '../oauth/index.js'\n\n/**\n * Configuration type for Payload projects on the Figma platform.\n *\n * Differences from standard Payload Config:\n * - `db`: Omitted (auto-injected by Figma platform)\n * - `secret`: Omitted (auto-injected by Figma platform)\n * - `editor`: Optional (defaults to lexicalEditor() if not provided)\n *\n * @example\n * // Minimal config\n * const config: FigmaConfig = {\n *   collections: [...]\n * }\n *\n * @example\n * // With custom editor\n * const config: FigmaConfig = {\n *   collections: [...],\n *   editor: lexicalEditor({ features: [...] })\n * }\n */\nexport type FigmaConfig = {\n  editor?: Config['editor']\n} & {\n  figma: {\n    region: string\n    tenantId: string\n    useContentSystem?: boolean\n  }\n} & Omit<Config, 'db' | 'editor' | 'secret'> &\n  Partial<Pick<Config, 'db'>>\n\n/**\n * Figma platform wrapper for Payload's buildConfig.\n * Automatically injects:\n * - Figma database adapter\n * - Secret (platform-provided)\n * - Default lexicalEditor (if no custom editor specified)\n *\n * @param config - Payload configuration (db and secret omitted, editor optional)\n * @returns Promise<SanitizedConfig> - Built Payload configuration\n */\nexport async function buildConfig(config: FigmaConfig): Promise<SanitizedConfig> {\n  let projectToken = ''\n\n  if (!process.env.FIGMA_CONTENT_API_ACCESS_KEY) {\n    const retrievedToken = await getValidProjectToken(new TokenStore(), config.figma.tenantId)\n    if (retrievedToken) {\n      projectToken = retrievedToken\n    }\n  }\n\n  // Build complete config with Figma platform defaults\n  const configWithFigmaDefaults: Config = {\n    ...config,\n    custom: {\n      figma: config.figma || {},\n    },\n    // TODO: - cms-tenants-001-staging needs to be dynamic in the future\n    db:\n      config.figma.useContentSystem !== false\n        ? contentAPIAdapter({\n            contentApiKey: process.env.FIGMA_CONTENT_API_ACCESS_KEY!,\n            contentApiUrl:\n              process.env.FIGMA_CONTENT_API_URL ||\n              `https://${config.figma.region}.cms-tenants-001-staging.figmacontentstaging.com`,\n            contentSystemId: config.figma.tenantId,\n            projectToken,\n          })\n        : config.db!,\n    editor: config.editor ?? lexicalEditor(),\n    endpoints: [...(config.endpoints ?? []), health],\n    secret: 'MY_SECRET',\n    // Add oauth to plugins if not already present\n    plugins: [\n      ...(config.plugins ?? []),\n      oAuth2Plugin({\n        collections: [\n          {\n            slug: 'users',\n            // Use adapter because Figma app doesn't support OIDC scopes\n            authorizationURLParams: {\n              response_mode: 'query',\n              response_type: 'code',\n            },\n            clientID: process.env.FIGMA_OAUTH_CLIENT_ID!,\n            clientSecret: process.env.FIGMA_OAUTH_CLIENT_SECRET,\n            identityMetadata: 'https://staging.figma.com/.well-known/openid-configuration',\n            scope: ['current_user:read'],\n            token: 'id_token', // Adapter creates JWT id_token from Figma user info\n            usernameField: 'email',\n          },\n        ],\n        debug: !!process.env.DEBUG,\n        disabled: false,\n      }),\n    ],\n  }\n\n  // Delegate to Payload's buildConfig\n  return await payloadBuildConfig(configWithFigmaDefaults)\n}\n"],"names":["lexicalEditor","buildConfig","payloadBuildConfig","getValidProjectToken","TokenStore","contentAPIAdapter","health","oAuth2Plugin","config","projectToken","process","env","FIGMA_CONTENT_API_ACCESS_KEY","retrievedToken","figma","tenantId","configWithFigmaDefaults","custom","db","useContentSystem","contentApiKey","contentApiUrl","FIGMA_CONTENT_API_URL","region","contentSystemId","editor","endpoints","secret","plugins","collections","slug","authorizationURLParams","response_mode","response_type","clientID","FIGMA_OAUTH_CLIENT_ID","clientSecret","FIGMA_OAUTH_CLIENT_SECRET","identityMetadata","scope","token","usernameField","debug","DEBUG","disabled"],"mappings":"AAEA,SAASA,aAAa,QAAQ,+BAA8B;AAC5D,SAASC,eAAeC,kBAAkB,QAAQ,UAAS;AAE3D,SAASC,oBAAoB,QAAQ,2BAA0B;AAC/D,SAASC,UAAU,QAAQ,yBAAwB;AACnD,SAASC,iBAAiB,QAAQ,mBAAkB;AACpD,SAASC,MAAM,QAAQ,yBAAwB;AAC/C,SAASC,YAAY,QAAQ,oBAAmB;AAkChD;;;;;;;;;CASC,GACD,OAAO,eAAeN,YAAYO,MAAmB;IACnD,IAAIC,eAAe;IAEnB,IAAI,CAACC,QAAQC,GAAG,CAACC,4BAA4B,EAAE;QAC7C,MAAMC,iBAAiB,MAAMV,qBAAqB,IAAIC,cAAcI,OAAOM,KAAK,CAACC,QAAQ;QACzF,IAAIF,gBAAgB;YAClBJ,eAAeI;QACjB;IACF;IAEA,qDAAqD;IACrD,MAAMG,0BAAkC;QACtC,GAAGR,MAAM;QACTS,QAAQ;YACNH,OAAON,OAAOM,KAAK,IAAI,CAAC;QAC1B;QACA,oEAAoE;QACpEI,IACEV,OAAOM,KAAK,CAACK,gBAAgB,KAAK,QAC9Bd,kBAAkB;YAChBe,eAAeV,QAAQC,GAAG,CAACC,4BAA4B;YACvDS,eACEX,QAAQC,GAAG,CAACW,qBAAqB,IACjC,CAAC,QAAQ,EAAEd,OAAOM,KAAK,CAACS,MAAM,CAAC,gDAAgD,CAAC;YAClFC,iBAAiBhB,OAAOM,KAAK,CAACC,QAAQ;YACtCN;QACF,KACAD,OAAOU,EAAE;QACfO,QAAQjB,OAAOiB,MAAM,IAAIzB;QACzB0B,WAAW;eAAKlB,OAAOkB,SAAS,IAAI,EAAE;YAAGpB;SAAO;QAChDqB,QAAQ;QACR,8CAA8C;QAC9CC,SAAS;eACHpB,OAAOoB,OAAO,IAAI,EAAE;YACxBrB,aAAa;gBACXsB,aAAa;oBACX;wBACEC,MAAM;wBACN,4DAA4D;wBAC5DC,wBAAwB;4BACtBC,eAAe;4BACfC,eAAe;wBACjB;wBACAC,UAAUxB,QAAQC,GAAG,CAACwB,qBAAqB;wBAC3CC,cAAc1B,QAAQC,GAAG,CAAC0B,yBAAyB;wBACnDC,kBAAkB;wBAClBC,OAAO;4BAAC;yBAAoB;wBAC5BC,OAAO;wBACPC,eAAe;oBACjB;iBACD;gBACDC,OAAO,CAAC,CAAChC,QAAQC,GAAG,CAACgC,KAAK;gBAC1BC,UAAU;YACZ;SACD;IACH;IAEA,oCAAoC;IACpC,OAAO,MAAM1C,mBAAmBc;AAClC"}

package/dist/types/config.d.ts

@@ -1,17 +1,6 @@
 /**
  * Figma CMS Configuration Types
  */
-/**
- * Configuration stored in figma.config.json
- */
-export interface FigmaConfig {
-    /** Domain for the CMS instance */
-    domain: string;
-    /** Optional custom subdomain */
-    subdomain?: string;
-    /** Tenant ID from Control Plane */
-    tenantId: string;
-}
 /**
  * Tenant instance from Control Plane API
  */

package/dist/types/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAA;IACd,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAA;IACd,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,yCAAyC;IACzC,UAAU,EAAE,KAAK,GAAG,MAAM,GAAG,WAAW,CAAA;IACxC,oBAAoB;IACpB,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,cAAc,CAAA;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,mCAAmC;IACnC,UAAU,EAAE,OAAO,CAAA;IACnB,iDAAiD;IACjD,cAAc,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAA;IACxC,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,mCAAmC;IACnC,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAA;IACd,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,yCAAyC;IACzC,UAAU,EAAE,KAAK,GAAG,MAAM,GAAG,WAAW,CAAA;IACxC,oBAAoB;IACpB,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,cAAc,CAAA;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,mCAAmC;IACnC,UAAU,EAAE,OAAO,CAAA;IACnB,iDAAiD;IACjD,cAAc,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAA;IACxC,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,mCAAmC;IACnC,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB"}

package/dist/types/config.js

@@ -1,7 +1,7 @@
 /**
  * Figma CMS Configuration Types
  */ /**
- * Configuration stored in figma.config.json
+ * Tenant instance from Control Plane API
  */ /**
  * Project information from detection
  */ export { };

package/dist/types/config.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/types/config.ts"],"sourcesContent":["/**\n * Figma CMS Configuration Types\n */\n\n/**\n * Configuration stored in figma.config.json\n */\nexport interface FigmaConfig {\n  /** Domain for the CMS instance */\n  domain: string\n  /** Optional custom subdomain */\n  subdomain?: string\n  /** Tenant ID from Control Plane */\n  tenantId: string\n}\n\n/**\n * Tenant instance from Control Plane API\n */\nexport interface Tenant {\n  /** Creation timestamp */\n  createdAt?: string\n  /** Domain name (e.g., my-cms.figmacms.com) */\n  domain: string\n  /** Unique tenant ID */\n  id: string\n  /** Parent ID */\n  parentId: string\n  /** Parent type (team, org, workspace) */\n  parentType: 'org' | 'team' | 'workspace'\n  /** Tenant status */\n  status: 'active' | 'inactive' | 'provisioning'\n}\n\n/**\n * Project information from detection\n */\nexport interface ProjectInfo {\n  /** Whether Payload is installed */\n  hasPayload: boolean\n  /** Package manager detected (npm, pnpm, yarn) */\n  packageManager?: 'npm' | 'pnpm' | 'yarn'\n  /** Project root path */\n  path: string\n  /** Payload version if installed */\n  payloadVersion?: string\n}\n"],"names":[],"mappings":"AAAA;;CAEC,GAED;;CAEC,GA4BD;;CAEC,GACD,WASC"}
+{"version":3,"sources":["../../src/types/config.ts"],"sourcesContent":["/**\n * Figma CMS Configuration Types\n */\n\n/**\n * Tenant instance from Control Plane API\n */\nexport interface Tenant {\n  /** Creation timestamp */\n  createdAt?: string\n  /** Domain name (e.g., my-cms.figmacms.com) */\n  domain: string\n  /** Unique tenant ID */\n  id: string\n  /** Parent ID */\n  parentId: string\n  /** Parent type (team, org, workspace) */\n  parentType: 'org' | 'team' | 'workspace'\n  /** Tenant status */\n  status: 'active' | 'inactive' | 'provisioning'\n}\n\n/**\n * Project information from detection\n */\nexport interface ProjectInfo {\n  /** Whether Payload is installed */\n  hasPayload: boolean\n  /** Package manager detected (npm, pnpm, yarn) */\n  packageManager?: 'npm' | 'pnpm' | 'yarn'\n  /** Project root path */\n  path: string\n  /** Payload version if installed */\n  payloadVersion?: string\n}\n"],"names":[],"mappings":"AAAA;;CAEC,GAED;;CAEC,GAgBD;;CAEC,GACD,WASC"}

package/dist/utils/config.d.ts

@@ -1,28 +1,6 @@
 /**
  * Configuration file management utilities
  */
-import type { FigmaConfig } from '../types/config.js';
-/**
- * Read figma.config.json from the current directory
- *
- * @param projectPath - Path to project directory (defaults to cwd)
- * @returns Parsed configuration or null if not found
- */
-export declare function readFigmaConfig(projectPath?: string): Promise<FigmaConfig | null>;
-/**
- * Write figma.config.json to the current directory
- *
- * @param config - Configuration to write
- * @param projectPath - Path to project directory (defaults to cwd)
- */
-export declare function writeFigmaConfig(config: FigmaConfig, projectPath?: string): Promise<void>;
-/**
- * Check if figma.config.json exists
- *
- * @param projectPath - Path to project directory (defaults to cwd)
- * @returns True if config file exists
- */
-export declare function hasFigmaConfig(projectPath?: string): Promise<boolean>;
 /**
  * Ensure .gitignore exists and optionally add entries
  *

package/dist/utils/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAKrD;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,WAAW,GAAE,MAAsB,GAClC,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAY7B;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,WAAW,EACnB,WAAW,GAAE,MAAsB,GAClC,OAAO,CAAC,IAAI,CAAC,CASf;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,WAAW,GAAE,MAAsB,GAAG,OAAO,CAAC,OAAO,CAAC,CAS1F;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BhG"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BhG"}

package/dist/utils/config.js

@@ -2,53 +2,7 @@
  * Configuration file management utilities
  */ import fs from 'fs/promises';
 import path from 'path';
-const CONFIG_FILENAME = 'figma.config.json';
 const GITIGNORE_FILENAME = '.gitignore';
-/**
- * Read figma.config.json from the current directory
- *
- * @param projectPath - Path to project directory (defaults to cwd)
- * @returns Parsed configuration or null if not found
- */ export async function readFigmaConfig(projectPath = process.cwd()) {
-    const configPath = path.join(projectPath, CONFIG_FILENAME);
-    try {
-        const content = await fs.readFile(configPath, 'utf-8');
-        return JSON.parse(content);
-    } catch (error) {
-        if (error.code === 'ENOENT') {
-            return null;
-        }
-        throw new Error(`Failed to read ${CONFIG_FILENAME}: ${error.message}`);
-    }
-}
-/**
- * Write figma.config.json to the current directory
- *
- * @param config - Configuration to write
- * @param projectPath - Path to project directory (defaults to cwd)
- */ export async function writeFigmaConfig(config, projectPath = process.cwd()) {
-    const configPath = path.join(projectPath, CONFIG_FILENAME);
-    try {
-        const content = JSON.stringify(config, null, 2);
-        await fs.writeFile(configPath, content + '\n', 'utf-8');
-    } catch (error) {
-        throw new Error(`Failed to write ${CONFIG_FILENAME}: ${error.message}`);
-    }
-}
-/**
- * Check if figma.config.json exists
- *
- * @param projectPath - Path to project directory (defaults to cwd)
- * @returns True if config file exists
- */ export async function hasFigmaConfig(projectPath = process.cwd()) {
-    const configPath = path.join(projectPath, CONFIG_FILENAME);
-    try {
-        await fs.access(configPath);
-        return true;
-    } catch  {
-        return false;
-    }
-}
 /**
  * Ensure .gitignore exists and optionally add entries
  *

package/dist/utils/config.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/config.ts"],"sourcesContent":["/**\n * Configuration file management utilities\n */\n\nimport fs from 'fs/promises'\nimport path from 'path'\n\nimport type { FigmaConfig } from '../types/config.js'\n\nconst CONFIG_FILENAME = 'figma.config.json'\nconst GITIGNORE_FILENAME = '.gitignore'\n\n/**\n * Read figma.config.json from the current directory\n *\n * @param projectPath - Path to project directory (defaults to cwd)\n * @returns Parsed configuration or null if not found\n */\nexport async function readFigmaConfig(\n  projectPath: string = process.cwd(),\n): Promise<FigmaConfig | null> {\n  const configPath = path.join(projectPath, CONFIG_FILENAME)\n\n  try {\n    const content = await fs.readFile(configPath, 'utf-8')\n    return JSON.parse(content) as FigmaConfig\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code === 'ENOENT') {\n      return null\n    }\n    throw new Error(`Failed to read ${CONFIG_FILENAME}: ${(error as Error).message}`)\n  }\n}\n\n/**\n * Write figma.config.json to the current directory\n *\n * @param config - Configuration to write\n * @param projectPath - Path to project directory (defaults to cwd)\n */\nexport async function writeFigmaConfig(\n  config: FigmaConfig,\n  projectPath: string = process.cwd(),\n): Promise<void> {\n  const configPath = path.join(projectPath, CONFIG_FILENAME)\n\n  try {\n    const content = JSON.stringify(config, null, 2)\n    await fs.writeFile(configPath, content + '\\n', 'utf-8')\n  } catch (error) {\n    throw new Error(`Failed to write ${CONFIG_FILENAME}: ${(error as Error).message}`)\n  }\n}\n\n/**\n * Check if figma.config.json exists\n *\n * @param projectPath - Path to project directory (defaults to cwd)\n * @returns True if config file exists\n */\nexport async function hasFigmaConfig(projectPath: string = process.cwd()): Promise<boolean> {\n  const configPath = path.join(projectPath, CONFIG_FILENAME)\n\n  try {\n    await fs.access(configPath)\n    return true\n  } catch {\n    return false\n  }\n}\n\n/**\n * Ensure .gitignore exists and optionally add entries\n *\n * @param projectPath - Path to project directory\n * @param entries - Optional entries to add to .gitignore\n */\nexport async function ensureGitignore(projectPath: string, entries: string[] = []): Promise<void> {\n  const gitignorePath = path.join(projectPath, GITIGNORE_FILENAME)\n\n  let existingContent = ''\n  try {\n    existingContent = await fs.readFile(gitignorePath, 'utf-8')\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code !== 'ENOENT') {\n      throw new Error(`Failed to read ${GITIGNORE_FILENAME}: ${(error as Error).message}`)\n    }\n  }\n\n  // Parse existing entries\n  const existingLines = existingContent.split('\\n').filter((line) => line.trim())\n  const existingSet = new Set(existingLines)\n\n  // Add new entries that don't exist\n  const newEntries = entries.filter((entry) => !existingSet.has(entry))\n\n  if (newEntries.length > 0) {\n    const newContent = existingContent\n      ? `${existingContent.trimEnd()}\\n\\n# Figma CMS\\n${newEntries.join('\\n')}\\n`\n      : `# Figma CMS\\n${newEntries.join('\\n')}\\n`\n\n    await fs.writeFile(gitignorePath, newContent, 'utf-8')\n  }\n}\n"],"names":["fs","path","CONFIG_FILENAME","GITIGNORE_FILENAME","readFigmaConfig","projectPath","process","cwd","configPath","join","content","readFile","JSON","parse","error","code","Error","message","writeFigmaConfig","config","stringify","writeFile","hasFigmaConfig","access","ensureGitignore","entries","gitignorePath","existingContent","existingLines","split","filter","line","trim","existingSet","Set","newEntries","entry","has","length","newContent","trimEnd"],"mappings":"AAAA;;CAEC,GAED,OAAOA,QAAQ,cAAa;AAC5B,OAAOC,UAAU,OAAM;AAIvB,MAAMC,kBAAkB;AACxB,MAAMC,qBAAqB;AAE3B;;;;;CAKC,GACD,OAAO,eAAeC,gBACpBC,cAAsBC,QAAQC,GAAG,EAAE;IAEnC,MAAMC,aAAaP,KAAKQ,IAAI,CAACJ,aAAaH;IAE1C,IAAI;QACF,MAAMQ,UAAU,MAAMV,GAAGW,QAAQ,CAACH,YAAY;QAC9C,OAAOI,KAAKC,KAAK,CAACH;IACpB,EAAE,OAAOI,OAAO;QACd,IAAI,AAACA,MAAgCC,IAAI,KAAK,UAAU;YACtD,OAAO;QACT;QACA,MAAM,IAAIC,MAAM,CAAC,eAAe,EAAEd,gBAAgB,EAAE,EAAE,AAACY,MAAgBG,OAAO,EAAE;IAClF;AACF;AAEA;;;;;CAKC,GACD,OAAO,eAAeC,iBACpBC,MAAmB,EACnBd,cAAsBC,QAAQC,GAAG,EAAE;IAEnC,MAAMC,aAAaP,KAAKQ,IAAI,CAACJ,aAAaH;IAE1C,IAAI;QACF,MAAMQ,UAAUE,KAAKQ,SAAS,CAACD,QAAQ,MAAM;QAC7C,MAAMnB,GAAGqB,SAAS,CAACb,YAAYE,UAAU,MAAM;IACjD,EAAE,OAAOI,OAAO;QACd,MAAM,IAAIE,MAAM,CAAC,gBAAgB,EAAEd,gBAAgB,EAAE,EAAE,AAACY,MAAgBG,OAAO,EAAE;IACnF;AACF;AAEA;;;;;CAKC,GACD,OAAO,eAAeK,eAAejB,cAAsBC,QAAQC,GAAG,EAAE;IACtE,MAAMC,aAAaP,KAAKQ,IAAI,CAACJ,aAAaH;IAE1C,IAAI;QACF,MAAMF,GAAGuB,MAAM,CAACf;QAChB,OAAO;IACT,EAAE,OAAM;QACN,OAAO;IACT;AACF;AAEA;;;;;CAKC,GACD,OAAO,eAAegB,gBAAgBnB,WAAmB,EAAEoB,UAAoB,EAAE;IAC/E,MAAMC,gBAAgBzB,KAAKQ,IAAI,CAACJ,aAAaF;IAE7C,IAAIwB,kBAAkB;IACtB,IAAI;QACFA,kBAAkB,MAAM3B,GAAGW,QAAQ,CAACe,eAAe;IACrD,EAAE,OAAOZ,OAAO;QACd,IAAI,AAACA,MAAgCC,IAAI,KAAK,UAAU;YACtD,MAAM,IAAIC,MAAM,CAAC,eAAe,EAAEb,mBAAmB,EAAE,EAAE,AAACW,MAAgBG,OAAO,EAAE;QACrF;IACF;IAEA,yBAAyB;IACzB,MAAMW,gBAAgBD,gBAAgBE,KAAK,CAAC,MAAMC,MAAM,CAAC,CAACC,OAASA,KAAKC,IAAI;IAC5E,MAAMC,cAAc,IAAIC,IAAIN;IAE5B,mCAAmC;IACnC,MAAMO,aAAaV,QAAQK,MAAM,CAAC,CAACM,QAAU,CAACH,YAAYI,GAAG,CAACD;IAE9D,IAAID,WAAWG,MAAM,GAAG,GAAG;QACzB,MAAMC,aAAaZ,kBACf,GAAGA,gBAAgBa,OAAO,GAAG,iBAAiB,EAAEL,WAAW1B,IAAI,CAAC,MAAM,EAAE,CAAC,GACzE,CAAC,aAAa,EAAE0B,WAAW1B,IAAI,CAAC,MAAM,EAAE,CAAC;QAE7C,MAAMT,GAAGqB,SAAS,CAACK,eAAea,YAAY;IAChD;AACF"}
+{"version":3,"sources":["../../src/utils/config.ts"],"sourcesContent":["/**\n * Configuration file management utilities\n */\n\nimport fs from 'fs/promises'\nimport path from 'path'\n\nconst GITIGNORE_FILENAME = '.gitignore'\n\n/**\n * Ensure .gitignore exists and optionally add entries\n *\n * @param projectPath - Path to project directory\n * @param entries - Optional entries to add to .gitignore\n */\nexport async function ensureGitignore(projectPath: string, entries: string[] = []): Promise<void> {\n  const gitignorePath = path.join(projectPath, GITIGNORE_FILENAME)\n\n  let existingContent = ''\n  try {\n    existingContent = await fs.readFile(gitignorePath, 'utf-8')\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code !== 'ENOENT') {\n      throw new Error(`Failed to read ${GITIGNORE_FILENAME}: ${(error as Error).message}`)\n    }\n  }\n\n  // Parse existing entries\n  const existingLines = existingContent.split('\\n').filter((line) => line.trim())\n  const existingSet = new Set(existingLines)\n\n  // Add new entries that don't exist\n  const newEntries = entries.filter((entry) => !existingSet.has(entry))\n\n  if (newEntries.length > 0) {\n    const newContent = existingContent\n      ? `${existingContent.trimEnd()}\\n\\n# Figma CMS\\n${newEntries.join('\\n')}\\n`\n      : `# Figma CMS\\n${newEntries.join('\\n')}\\n`\n\n    await fs.writeFile(gitignorePath, newContent, 'utf-8')\n  }\n}\n"],"names":["fs","path","GITIGNORE_FILENAME","ensureGitignore","projectPath","entries","gitignorePath","join","existingContent","readFile","error","code","Error","message","existingLines","split","filter","line","trim","existingSet","Set","newEntries","entry","has","length","newContent","trimEnd","writeFile"],"mappings":"AAAA;;CAEC,GAED,OAAOA,QAAQ,cAAa;AAC5B,OAAOC,UAAU,OAAM;AAEvB,MAAMC,qBAAqB;AAE3B;;;;;CAKC,GACD,OAAO,eAAeC,gBAAgBC,WAAmB,EAAEC,UAAoB,EAAE;IAC/E,MAAMC,gBAAgBL,KAAKM,IAAI,CAACH,aAAaF;IAE7C,IAAIM,kBAAkB;IACtB,IAAI;QACFA,kBAAkB,MAAMR,GAAGS,QAAQ,CAACH,eAAe;IACrD,EAAE,OAAOI,OAAO;QACd,IAAI,AAACA,MAAgCC,IAAI,KAAK,UAAU;YACtD,MAAM,IAAIC,MAAM,CAAC,eAAe,EAAEV,mBAAmB,EAAE,EAAE,AAACQ,MAAgBG,OAAO,EAAE;QACrF;IACF;IAEA,yBAAyB;IACzB,MAAMC,gBAAgBN,gBAAgBO,KAAK,CAAC,MAAMC,MAAM,CAAC,CAACC,OAASA,KAAKC,IAAI;IAC5E,MAAMC,cAAc,IAAIC,IAAIN;IAE5B,mCAAmC;IACnC,MAAMO,aAAahB,QAAQW,MAAM,CAAC,CAACM,QAAU,CAACH,YAAYI,GAAG,CAACD;IAE9D,IAAID,WAAWG,MAAM,GAAG,GAAG;QACzB,MAAMC,aAAajB,kBACf,GAAGA,gBAAgBkB,OAAO,GAAG,iBAAiB,EAAEL,WAAWd,IAAI,CAAC,MAAM,EAAE,CAAC,GACzE,CAAC,aAAa,EAAEc,WAAWd,IAAI,CAAC,MAAM,EAAE,CAAC;QAE7C,MAAMP,GAAG2B,SAAS,CAACrB,eAAemB,YAAY;IAChD;AACF"}

package/dist/utils/messages.js

@@ -6,7 +6,7 @@ export function helpMessage() {
     console.log(`
   ${pc.bold('USAGE')}
 
-      ${pc.dim('payloadcms-figma <command> [options]')}
+      ${pc.dim('@payloadcms/figma <command> [options]')}
 
   ${pc.bold('COMMANDS')}
 
@@ -23,21 +23,21 @@ export function helpMessage() {
 
   ${pc.bold('AUTHENTICATION')}
 
-      ${pc.cyan('payloadcms-figma login')}                Authenticate with Figma
-      ${pc.cyan('payloadcms-figma logout')}               Clear all tokens (with confirmation)
-      ${pc.cyan('payloadcms-figma list-tokens')}          Display stored OAuth and project tokens
+      ${pc.cyan('@payloadcms/figma login')}                Authenticate with Figma
+      ${pc.cyan('@payloadcms/figma logout')}               Clear all tokens (with confirmation)
+      ${pc.cyan('@payloadcms/figma list-tokens')}          Display stored OAuth and project tokens
 
   ${pc.bold('INIT COMMAND')}
 
-      ${pc.cyan('payloadcms-figma init --id <cms-id>')}   Initialize project with CMS ID
-      ${pc.cyan('payloadcms-figma init')}                 Initialize (prompts for CMS ID)
-      ${pc.cyan('payloadcms-figma init --name my-cms')}   Specify project name for new projects
-      ${pc.cyan('payloadcms-figma init --force')}         Force reconfiguration of existing project
-      ${pc.cyan('payloadcms-figma init --skip-auth')}     Skip authentication (testing only)
+      ${pc.cyan('@payloadcms/figma init --id <cms-id>')}   Initialize project with CMS ID
+      ${pc.cyan('@payloadcms/figma init')}                 Initialize (prompts for CMS ID)
+      ${pc.cyan('@payloadcms/figma init --name my-cms')}   Specify project name for new projects
+      ${pc.cyan('@payloadcms/figma init --force')}         Force reconfiguration of existing project
+      ${pc.cyan('@payloadcms/figma init --skip-auth')}     Skip authentication (testing only)
 
   ${pc.bold('DEPLOY COMMAND')}
 
-      ${pc.cyan('payloadcms-figma deploy')}               Deploy your project to Figma
+      ${pc.cyan('@payloadcms/figma deploy')}               Deploy your project to Figma
       ${pc.dim('--yes, -y')}          Skip confirmation prompts
 
   ${pc.bold('DOCUMENTATION')}
@@ -86,7 +86,7 @@ ${pc.bold('To continue:')}
 
 It is recommended to do this from your IDE if your app has existing file references.
 
-Once moved, rerun the payloadcms-figma command again.
+Once moved, rerun the @payloadcms/figma command again.
 `;
 }
 export function feedbackOutro() {

package/dist/utils/messages.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/messages.ts"],"sourcesContent":["/* eslint-disable no-console */\nimport path from 'path'\nimport pc from 'picocolors'\nimport terminalLink from 'terminal-link'\n\nimport type { PackageManager } from '../types.js'\n\nconst header = (message: string): string => pc.bold(message)\n\nexport function helpMessage(): void {\n  console.log(`\n  ${pc.bold('USAGE')}\n\n      ${pc.dim('payloadcms-figma <command> [options]')}\n\n  ${pc.bold('COMMANDS')}\n\n      ${pc.cyan('login')}            Authenticate with Figma OAuth2\n      ${pc.cyan('logout')}           Clear all stored tokens\n      ${pc.cyan('list-tokens')}      Show stored token information\n      ${pc.cyan('init')}             Initialize a Figma CMS project\n      ${pc.cyan('deploy')}           Deploy your project to Figma\n\n  ${pc.bold('OPTIONS')}\n\n      ${pc.dim('-h, --help          Show help')}\n      ${pc.dim('--debug             Enable debug logging')}\n\n  ${pc.bold('AUTHENTICATION')}\n\n      ${pc.cyan('payloadcms-figma login')}                Authenticate with Figma\n      ${pc.cyan('payloadcms-figma logout')}               Clear all tokens (with confirmation)\n      ${pc.cyan('payloadcms-figma list-tokens')}          Display stored OAuth and project tokens\n\n  ${pc.bold('INIT COMMAND')}\n\n      ${pc.cyan('payloadcms-figma init --id <cms-id>')}   Initialize project with CMS ID\n      ${pc.cyan('payloadcms-figma init')}                 Initialize (prompts for CMS ID)\n      ${pc.cyan('payloadcms-figma init --name my-cms')}   Specify project name for new projects\n      ${pc.cyan('payloadcms-figma init --force')}         Force reconfiguration of existing project\n      ${pc.cyan('payloadcms-figma init --skip-auth')}     Skip authentication (testing only)\n\n  ${pc.bold('DEPLOY COMMAND')}\n\n      ${pc.cyan('payloadcms-figma deploy')}               Deploy your project to Figma\n      ${pc.dim('--yes, -y')}          Skip confirmation prompts\n\n  ${pc.bold('DOCUMENTATION')}\n\n      ${createTerminalLink('Getting Started', 'https://payloadcms.com/docs/getting-started/what-is-payload')}\n      ${createTerminalLink('Figma CMS Docs', 'https://www.figma.com/developers/api')}\n`)\n}\n\n// Create terminalLink with fallback for unsupported terminals\nfunction createTerminalLink(text: string, url: string) {\n  return terminalLink(text, url, {\n    fallback: (text, url) => `${text}: ${url}`,\n  })\n}\n\nexport function successMessage(projectDir: string, packageManager: PackageManager): string {\n  const relativePath = path.relative(process.cwd(), projectDir)\n  return `\n${header('Launch Application:')}\n\n  - cd ./${relativePath}\n  - ${packageManager === 'npm' ? 'npm run' : packageManager} dev or follow directions in README.md\n\n${header('Documentation:')}\n\n  - ${createTerminalLink(\n    'Getting Started',\n    'https://payloadcms.com/docs/getting-started/what-is-payload',\n  )}\n  - ${createTerminalLink('Configuration', 'https://payloadcms.com/docs/configuration/overview')}\n\n`\n}\n\nexport function successfulNextInit(): string {\n  return `- ${createTerminalLink(\n    'Getting Started',\n    'https://payloadcms.com/docs/getting-started/what-is-payload',\n  )}\n- ${createTerminalLink('Configuration', 'https://payloadcms.com/docs/configuration/overview')}\n`\n}\n\nexport function moveMessage(args: { nextAppDir: string; projectDir: string }): string {\n  const relativeAppDir = path.relative(process.cwd(), args.nextAppDir)\n  return `\n${header('Next Steps:')}\n\nPayload does not support a top-level layout.tsx file in the app directory.\n\n${pc.bold('To continue:')}\n\n- Create a new directory in ./${relativeAppDir} such as ./${relativeAppDir}/${pc.bold('(app)')}\n- Move all files from ./${relativeAppDir} into that directory\n\nIt is recommended to do this from your IDE if your app has existing file references.\n\nOnce moved, rerun the payloadcms-figma command again.\n`\n}\n\nexport function feedbackOutro(): string {\n  return `${pc.bgCyan(pc.black(' Have feedback? '))} Visit us on ${createTerminalLink('GitHub', 'https://github.com/payloadcms/payload')}.`\n}\n"],"names":["path","pc","terminalLink","header","message","bold","helpMessage","console","log","dim","cyan","createTerminalLink","text","url","fallback","successMessage","projectDir","packageManager","relativePath","relative","process","cwd","successfulNextInit","moveMessage","args","relativeAppDir","nextAppDir","feedbackOutro","bgCyan","black"],"mappings":"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"}
+{"version":3,"sources":["../../src/utils/messages.ts"],"sourcesContent":["/* eslint-disable no-console */\nimport path from 'path'\nimport pc from 'picocolors'\nimport terminalLink from 'terminal-link'\n\nimport type { PackageManager } from '../types.js'\n\nconst header = (message: string): string => pc.bold(message)\n\nexport function helpMessage(): void {\n  console.log(`\n  ${pc.bold('USAGE')}\n\n      ${pc.dim('@payloadcms/figma <command> [options]')}\n\n  ${pc.bold('COMMANDS')}\n\n      ${pc.cyan('login')}            Authenticate with Figma OAuth2\n      ${pc.cyan('logout')}           Clear all stored tokens\n      ${pc.cyan('list-tokens')}      Show stored token information\n      ${pc.cyan('init')}             Initialize a Figma CMS project\n      ${pc.cyan('deploy')}           Deploy your project to Figma\n\n  ${pc.bold('OPTIONS')}\n\n      ${pc.dim('-h, --help          Show help')}\n      ${pc.dim('--debug             Enable debug logging')}\n\n  ${pc.bold('AUTHENTICATION')}\n\n      ${pc.cyan('@payloadcms/figma login')}                Authenticate with Figma\n      ${pc.cyan('@payloadcms/figma logout')}               Clear all tokens (with confirmation)\n      ${pc.cyan('@payloadcms/figma list-tokens')}          Display stored OAuth and project tokens\n\n  ${pc.bold('INIT COMMAND')}\n\n      ${pc.cyan('@payloadcms/figma init --id <cms-id>')}   Initialize project with CMS ID\n      ${pc.cyan('@payloadcms/figma init')}                 Initialize (prompts for CMS ID)\n      ${pc.cyan('@payloadcms/figma init --name my-cms')}   Specify project name for new projects\n      ${pc.cyan('@payloadcms/figma init --force')}         Force reconfiguration of existing project\n      ${pc.cyan('@payloadcms/figma init --skip-auth')}     Skip authentication (testing only)\n\n  ${pc.bold('DEPLOY COMMAND')}\n\n      ${pc.cyan('@payloadcms/figma deploy')}               Deploy your project to Figma\n      ${pc.dim('--yes, -y')}          Skip confirmation prompts\n\n  ${pc.bold('DOCUMENTATION')}\n\n      ${createTerminalLink('Getting Started', 'https://payloadcms.com/docs/getting-started/what-is-payload')}\n      ${createTerminalLink('Figma CMS Docs', 'https://www.figma.com/developers/api')}\n`)\n}\n\n// Create terminalLink with fallback for unsupported terminals\nfunction createTerminalLink(text: string, url: string) {\n  return terminalLink(text, url, {\n    fallback: (text, url) => `${text}: ${url}`,\n  })\n}\n\nexport function successMessage(projectDir: string, packageManager: PackageManager): string {\n  const relativePath = path.relative(process.cwd(), projectDir)\n  return `\n${header('Launch Application:')}\n\n  - cd ./${relativePath}\n  - ${packageManager === 'npm' ? 'npm run' : packageManager} dev or follow directions in README.md\n\n${header('Documentation:')}\n\n  - ${createTerminalLink(\n    'Getting Started',\n    'https://payloadcms.com/docs/getting-started/what-is-payload',\n  )}\n  - ${createTerminalLink('Configuration', 'https://payloadcms.com/docs/configuration/overview')}\n\n`\n}\n\nexport function successfulNextInit(): string {\n  return `- ${createTerminalLink(\n    'Getting Started',\n    'https://payloadcms.com/docs/getting-started/what-is-payload',\n  )}\n- ${createTerminalLink('Configuration', 'https://payloadcms.com/docs/configuration/overview')}\n`\n}\n\nexport function moveMessage(args: { nextAppDir: string; projectDir: string }): string {\n  const relativeAppDir = path.relative(process.cwd(), args.nextAppDir)\n  return `\n${header('Next Steps:')}\n\nPayload does not support a top-level layout.tsx file in the app directory.\n\n${pc.bold('To continue:')}\n\n- Create a new directory in ./${relativeAppDir} such as ./${relativeAppDir}/${pc.bold('(app)')}\n- Move all files from ./${relativeAppDir} into that directory\n\nIt is recommended to do this from your IDE if your app has existing file references.\n\nOnce moved, rerun the @payloadcms/figma command again.\n`\n}\n\nexport function feedbackOutro(): string {\n  return `${pc.bgCyan(pc.black(' Have feedback? '))} Visit us on ${createTerminalLink('GitHub', 'https://github.com/payloadcms/payload')}.`\n}\n"],"names":["path","pc","terminalLink","header","message","bold","helpMessage","console","log","dim","cyan","createTerminalLink","text","url","fallback","successMessage","projectDir","packageManager","relativePath","relative","process","cwd","successfulNextInit","moveMessage","args","relativeAppDir","nextAppDir","feedbackOutro","bgCyan","black"],"mappings":"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"}

package/dist/utils/payload-config-ast.d.ts

@@ -1,6 +1,5 @@
 import type { SourceFile } from 'ts-morph';
 export type DetectionResult = {
-    buildConfigNotFound?: boolean;
     dbProperty?: {
         adapter: string;
         importSource: string;
@@ -9,7 +8,9 @@ export type DetectionResult = {
         importSource: string;
         isDefault: boolean;
     };
+    figmaObjectExists: boolean;
     hasAlias: boolean;
+    hasBuildConfig?: boolean;
     hasOtherPayloadImports: boolean;
     needsImportChange: boolean;
     secretProperty?: boolean;
@@ -27,4 +28,19 @@ export type ASTModificationResult = {
  * Modifies the AST in memory - caller must call sourceFile.save()
  */
 export declare function applyModifications(sourceFile: SourceFile, detection: DetectionResult): ASTModificationResult;
+export type FigmaPropertyConfig = {
+    region: string;
+    tenantId: string;
+    useContentSystem: boolean;
+};
+/**
+ * Add figma property to buildConfig if it doesn't exist
+ * Modifies the AST in memory - caller must call sourceFile.save()
+ */
+export declare function addFigmaProperty(sourceFile: SourceFile, config: FigmaPropertyConfig): ASTModificationResult;
+/**
+ * Read figma configuration from payload.config.ts
+ * Returns the figma object if it exists, null otherwise
+ */
+export declare function readFigmaConfig(sourceFile: SourceFile): FigmaPropertyConfig | null;
 //# sourceMappingURL=payload-config-ast.d.ts.map

package/dist/utils/payload-config-ast.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"payload-config-ast.d.ts","sourceRoot":"","sources":["../../src/utils/payload-config-ast.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAO1C,MAAM,MAAM,eAAe,GAAG;IAC5B,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B,UAAU,CAAC,EAAE;QACX,OAAO,EAAE,MAAM,CAAA;QACf,YAAY,EAAE,MAAM,CAAA;KACrB,CAAA;IACD,cAAc,CAAC,EAAE;QACf,YAAY,EAAE,MAAM,CAAA;QACpB,SAAS,EAAE,OAAO,CAAA;KACnB,CAAA;IACD,QAAQ,EAAE,OAAO,CAAA;IACjB,sBAAsB,EAAE,OAAO,CAAA;IAC/B,iBAAiB,EAAE,OAAO,CAAA;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB,CAAA;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,UAAU,GAAG,eAAe,CA8I7E;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,QAAQ,EAAE,OAAO,CAAA;CAClB,CAAA;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,eAAe,GACzB,qBAAqB,CAoJvB"}
+{"version":3,"file":"payload-config-ast.d.ts","sourceRoot":"","sources":["../../src/utils/payload-config-ast.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAM1C,MAAM,MAAM,eAAe,GAAG;IAC5B,UAAU,CAAC,EAAE;QACX,OAAO,EAAE,MAAM,CAAA;QACf,YAAY,EAAE,MAAM,CAAA;KACrB,CAAA;IACD,cAAc,CAAC,EAAE;QACf,YAAY,EAAE,MAAM,CAAA;QACpB,SAAS,EAAE,OAAO,CAAA;KACnB,CAAA;IACD,iBAAiB,EAAE,OAAO,CAAA;IAC1B,QAAQ,EAAE,OAAO,CAAA;IACjB,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,sBAAsB,EAAE,OAAO,CAAA;IAC/B,iBAAiB,EAAE,OAAO,CAAA;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB,CAAA;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,UAAU,GAAG,eAAe,CAiJ7E;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,QAAQ,EAAE,OAAO,CAAA;CAClB,CAAA;AA0CD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,eAAe,GACzB,qBAAqB,CAyJvB;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,gBAAgB,EAAE,OAAO,CAAA;CAC1B,CAAA;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,mBAAmB,GAC1B,qBAAqB,CA+CvB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,UAAU,GAAG,mBAAmB,GAAG,IAAI,CA0ElF"}

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

@@ -1,10 +1,10 @@
 import { Node, SyntaxKind } from 'ts-morph';
-import { isDebug } from './is-debug.js';
 import * as log from './log.js';
 /**
  * Detect what changes are needed in the payload config file
  */ export function detectRequiredChanges(sourceFile) {
     const result = {
+        figmaObjectExists: false,
         hasAlias: false,
         hasOtherPayloadImports: false,
         needsImportChange: false
@@ -13,21 +13,17 @@ import * as log from './log.js';
     const imports = sourceFile.getImportDeclarations();
     const payloadImport = imports.find((imp)=>imp.getModuleSpecifierValue() === 'payload' || imp.getModuleSpecifierValue() === '@payloadcms/figma');
     if (!payloadImport) {
-        if (isDebug()) {
-            log.debug('No payload or @payloadcms/figma import found');
-        }
-        result.buildConfigNotFound = true;
+        log.debug('No payload or @payloadcms/figma import found');
+        result.hasBuildConfig = false;
         return result;
     }
-    if (isDebug()) {
-        log.debug(`Found import from: ${payloadImport.getModuleSpecifierValue()}`);
-    }
+    log.debug(`Found import from: ${payloadImport.getModuleSpecifierValue()}`);
     const moduleSpecifier = payloadImport.getModuleSpecifierValue();
     const namedImports = payloadImport.getNamedImports();
     // Check if buildConfig is imported
     const buildConfigImport = namedImports.find((ni)=>ni.getName() === 'buildConfig');
     if (!buildConfigImport) {
-        result.buildConfigNotFound = true;
+        result.hasBuildConfig = false;
         return result;
     }
     // Check for alias and get the actual name used in code
@@ -65,7 +61,7 @@ import * as log from './log.js';
         });
     }
     if (!buildConfigCall) {
-        result.buildConfigNotFound = true;
+        result.hasBuildConfig = false;
         return result;
     }
     // Get config object
@@ -113,23 +109,67 @@ import * as log from './log.js';
             }
         }
     }
+    // Check for figma property
+    const figmaProperty = configArg.getProperty('figma');
+    if (figmaProperty) {
+        result.figmaObjectExists = true;
+    }
     return result;
 }
+/**
+ * Remove all comments
+ * @returns true if any comments were removed
+ */ function removeAllComments(sourceFile) {
+    const ranges = [];
+    // Recursively collect comments from node and ALL children (including tokens)
+    const collectComments = (node)=>{
+        node.getLeadingCommentRanges().forEach((range)=>{
+            ranges.push([
+                range.getPos(),
+                range.getEnd()
+            ]);
+        });
+        node.getTrailingCommentRanges().forEach((range)=>{
+            ranges.push([
+                range.getPos(),
+                range.getEnd()
+            ]);
+        });
+        // Process ALL children including token nodes (commas, braces, etc.)
+        node.getChildren().forEach(collectComments);
+    };
+    collectComments(sourceFile);
+    if (ranges.length === 0) {
+        return false;
+    }
+    // Remove duplicates and sort in reverse order to avoid position shifts
+    const uniqueRanges = Array.from(new Set(ranges.map((r)=>JSON.stringify(r)))).map((r)=>JSON.parse(r));
+    uniqueRanges.sort((a, b)=>b[0] - a[0]);
+    // Remove each comment range
+    for (const [pos, end] of uniqueRanges){
+        sourceFile.removeText(pos, end);
+    }
+    return true;
+}
 /**
  * Apply modifications to the source file based on detection result
  * Modifies the AST in memory - caller must call sourceFile.save()
  */ export function applyModifications(sourceFile, detection) {
     const changes = [];
     let modified = false;
-    if (detection.buildConfigNotFound || detection.hasAlias) {
-        if (isDebug()) {
-            log.debug(`Skipping modifications: buildConfigNotFound=${detection.buildConfigNotFound}, hasAlias=${detection.hasAlias}`);
-        }
+    if (detection.hasBuildConfig === false || detection.hasAlias) {
+        log.debug(`Skipping modifications: hasBuildConfig=${detection.hasBuildConfig}, hasAlias=${detection.hasAlias}`);
         return {
             changes: [],
             modified: false
         };
     }
+    // 1. Remove all comments FIRST (before AST modifications that might shift positions)
+    const hadComments = removeAllComments(sourceFile);
+    if (hadComments) {
+        changes.push('Removed comments');
+        modified = true;
+    }
     // Find the import declarations
     const imports = sourceFile.getImportDeclarations();
     const payloadImport = imports.find((imp)=>imp.getModuleSpecifierValue() === 'payload');
@@ -255,5 +295,117 @@ import * as log from './log.js';
         modified
     };
 }
+/**
+ * Add figma property to buildConfig if it doesn't exist
+ * Modifies the AST in memory - caller must call sourceFile.save()
+ */ export function addFigmaProperty(sourceFile, config) {
+    const changes = [];
+    let modified = false;
+    // Find buildConfig call
+    const callExpressions = sourceFile.getDescendantsOfKind(SyntaxKind.CallExpression);
+    const buildConfigCall = callExpressions.find((ce)=>{
+        const expr = ce.getExpression();
+        const text = expr.getText();
+        return text === 'buildConfig' || text.endsWith('.buildConfig');
+    });
+    if (!buildConfigCall) {
+        log.debug('No buildConfig call found');
+        return {
+            changes: [],
+            modified: false
+        };
+    }
+    // Get config object argument
+    const configArg = buildConfigCall.getArguments()[0];
+    if (!configArg || !Node.isObjectLiteralExpression(configArg)) {
+        log.debug('buildConfig argument is not an object literal');
+        return {
+            changes: [],
+            modified: false
+        };
+    }
+    // Check if figma property already exists
+    const existingFigmaProperty = configArg.getProperty('figma');
+    if (existingFigmaProperty) {
+        log.debug('figma property already exists, skipping');
+        return {
+            changes: [
+                'Skipped: figma property already exists'
+            ],
+            modified: false
+        };
+    }
+    // Add figma property
+    configArg.addPropertyAssignment({
+        name: 'figma',
+        initializer: `{
+    region: '${config.region}',
+    tenantId: '${config.tenantId}',
+    useContentSystem: ${config.useContentSystem},
+  }`
+    });
+    changes.push(`Added figma property (region: ${config.region}, tenantId: ${config.tenantId}, useContentSystem: ${config.useContentSystem})`);
+    modified = true;
+    return {
+        changes,
+        modified
+    };
+}
+/**
+ * Read figma configuration from payload.config.ts
+ * Returns the figma object if it exists, null otherwise
+ */ export function readFigmaConfig(sourceFile) {
+    // Find buildConfig call
+    const callExpressions = sourceFile.getDescendantsOfKind(SyntaxKind.CallExpression);
+    const buildConfigCall = callExpressions.find((ce)=>{
+        const expr = ce.getExpression();
+        const text = expr.getText();
+        return text === 'buildConfig' || text.endsWith('.buildConfig');
+    });
+    if (!buildConfigCall) {
+        log.debug('No buildConfig call found');
+        return null;
+    }
+    // Get config object argument
+    const configArg = buildConfigCall.getArguments()[0];
+    if (!configArg || !Node.isObjectLiteralExpression(configArg)) {
+        log.debug('buildConfig argument is not an object literal');
+        return null;
+    }
+    // Find figma property
+    const figmaProperty = configArg.getProperty('figma');
+    if (!figmaProperty || !Node.isPropertyAssignment(figmaProperty)) {
+        log.debug('No figma property found in buildConfig');
+        return null;
+    }
+    // Get initializer (the object value)
+    const initializer = figmaProperty.getInitializer();
+    if (!initializer || !Node.isObjectLiteralExpression(initializer)) {
+        log.debug('figma property is not an object literal');
+        return null;
+    }
+    // Extract values
+    const regionProp = initializer.getProperty('region');
+    const tenantIdProp = initializer.getProperty('tenantId');
+    const useContentSystemProp = initializer.getProperty('useContentSystem');
+    if (!regionProp || !tenantIdProp) {
+        log.debug('Missing required figma properties (region or tenantId)');
+        return null;
+    }
+    // Extract string values (remove quotes)
+    const region = Node.isPropertyAssignment(regionProp) ? regionProp.getInitializer()?.getText().replace(/['"]/g, '') : undefined;
+    const tenantId = Node.isPropertyAssignment(tenantIdProp) ? tenantIdProp.getInitializer()?.getText().replace(/['"]/g, '') : undefined;
+    const useContentSystem = Node.isPropertyAssignment(useContentSystemProp) ? useContentSystemProp.getInitializer()?.getText() === 'true' : true // Default to true if not specified
+    ;
+    if (!region || !tenantId) {
+        log.debug('Could not extract region or tenantId values');
+        return null;
+    }
+    return {
+        region,
+        tenantId,
+        useContentSystem
+    };
+}
 
 //# sourceMappingURL=payload-config-ast.js.map