@payloadcms/figma 0.0.1-alpha.0

package/LICENSE.md

@@ -0,0 +1,11 @@
+Copyright (c) 2025 Figma
+
+This source code is protected under international copyright law. All rights
+reserved and protected by the copyright holders.
+All contents of this code repository are confidential and only available to authorized individuals with the
+permission of the copyright holders. If you encounter this source code and do not have
+permission, please contact the copyright holders and delete this file.
+
+Further, the contents of this repository are strictly for demonstration purposes only
+and an Enterprise Agreement must be signed and in place between Payload CMS, Inc. and
+the party seeking to use this code in any way outside of demonstration purposes.

package/bin/cli.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+
+import { main } from '../dist/cli.js'
+main()

package/dist/api/control-plane.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Control Plane API Client
+ *
+ * TODO: Replace with real API calls when Control Plane is available
+ */
+import type { Tenant } from '../types/config.js';
+/**
+ * Error thrown when Control Plane API calls fail
+ */
+export declare class ControlPlaneError extends Error {
+    statusCode?: number | undefined;
+    cause?: Error | undefined;
+    constructor(message: string, statusCode?: number | undefined, cause?: Error | undefined);
+}
+/**
+ * Options for creating a new tenant
+ */
+export interface CreateTenantOptions {
+    /** Name for the new CMS instance */
+    name: string;
+    /** Optional parent ID */
+    parentId?: string;
+    /** Optional parent type */
+    parentType?: 'org' | 'team' | 'workspace';
+}
+/**
+ * Options for creating a new deployment
+ */
+export interface CreateDeploymentOptions {
+    /** List of static asset paths that need upload URLs */
+    staticAssets: string[];
+}
+/**
+ * Response from creating a new deployment
+ */
+export interface CreateDeploymentResponse {
+    /** Upload URL for the Lambda function code zip */
+    codeUploadUrl: string;
+    /** Unique deployment ID */
+    deploymentId: string;
+    /** Map of static asset paths to their signed S3 upload URLs */
+    staticAssetUploadUrls: Record<string, string>;
+}
+export interface CreateDeploymentApiResponse {
+    error: boolean;
+    meta: {
+        code_upload_url: string;
+        deployment_id: string;
+        static_asset_upload_urls: Record<string, string>;
+    };
+    status: number;
+}
+/**
+ * Options for performing a deployment
+ */
+export interface PerformDeploymentOptions {
+    /** Deployment ID from createDeployment */
+    deploymentId: string;
+}
+/**
+ * Response from performing a deployment
+ */
+export interface PerformDeploymentResponse {
+    /** Deployment ID that was deployed */
+    deploymentId: string;
+    /** Status message */
+    message: string;
+}
+export interface PerformDeploymentApiResponse {
+    error: boolean;
+    meta: {
+        deployment_id: string;
+        message: string;
+        status: string;
+    };
+    status: number;
+}
+/**
+ * List all tenant instances for the authenticated user
+ * Maps to: GET /v1/tenant
+ *
+ * @param accessToken - OAuth access token
+ * @returns Array of tenant instances
+ */
+export declare function listTenants(accessToken: string): Promise<Tenant[]>;
+/**
+ * Create a new tenant instance
+ * Maps to: POST /v1/tenant
+ *
+ * @param accessToken - OAuth access token
+ * @param options - Tenant creation options
+ * @returns Newly created tenant
+ */
+export declare function createTenant(accessToken: string, options: CreateTenantOptions): Promise<Tenant>;
+/**
+ * Get details for a specific tenant
+ * Maps to: GET /v1/tenant/{tenant_id}
+ *
+ * @param accessToken - OAuth access token
+ * @param tenantId - Tenant ID
+ * @returns Tenant details
+ */
+export declare function getTenantDetails(accessToken: string, tenantId: string): Promise<Tenant>;
+/**
+ * Create a new deployment and get signed upload URLs
+ * Maps to: POST /v1/tenant/{tenant_id}/deploy/create
+ *
+ * @param accessToken - OAuth access token
+ * @param tenantId - Tenant ID
+ * @param options - Deployment creation options
+ * @returns Deployment ID and upload URLs
+ */
+export declare function createDeployment(accessToken: string, tenantId: string, options: CreateDeploymentOptions): Promise<CreateDeploymentResponse>;
+/**
+ * Perform deployment for a created deployment ID
+ * Maps to: POST /v1/tenant/{tenant_id}/deploy/perform
+ *
+ * @param accessToken - OAuth access token
+ * @param tenantId - Tenant ID
+ * @param options - Deployment perform options
+ * @returns Deployment status and message
+ */
+export declare function performDeployment(accessToken: string, tenantId: string, options: PerformDeploymentOptions): Promise<PerformDeploymentResponse>;
+//# sourceMappingURL=control-plane.d.ts.map

package/dist/api/control-plane.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-plane.d.ts","sourceRoot":"","sources":["../../src/api/control-plane.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAqBhD;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAGjC,UAAU,CAAC,EAAE,MAAM;IACnB,KAAK,CAAC,EAAE,KAAK;gBAFpB,OAAO,EAAE,MAAM,EACR,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,KAAK,CAAC,EAAE,KAAK,YAAA;CAKvB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,2BAA2B;IAC3B,UAAU,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,WAAW,CAAA;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,uDAAuD;IACvD,YAAY,EAAE,MAAM,EAAE,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,kDAAkD;IAClD,aAAa,EAAE,MAAM,CAAA;IACrB,2BAA2B;IAC3B,YAAY,EAAE,MAAM,CAAA;IACpB,+DAA+D;IAC/D,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC9C;AAED,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,OAAO,CAAA;IACd,IAAI,EAAE;QACJ,eAAe,EAAE,MAAM,CAAA;QACvB,aAAa,EAAE,MAAM,CAAA;QACrB,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KACjD,CAAA;IACD,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,0CAA0C;IAC1C,YAAY,EAAE,MAAM,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAA;IACpB,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,4BAA4B;IAC3C,KAAK,EAAE,OAAO,CAAA;IACd,IAAI,EAAE;QACJ,aAAa,EAAE,MAAM,CAAA;QACrB,OAAO,EAAE,MAAM,CAAA;QACf,MAAM,EAAE,MAAM,CAAA;KACf,CAAA;IACD,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAyCxE;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,MAAM,CAAC,CAuCjB;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAgC7F;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,wBAAwB,CAAC,CA4DnC;AAED;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,yBAAyB,CAAC,CA0CpC"}

package/dist/api/control-plane.js

@@ -0,0 +1,245 @@
+/**
+ * Control Plane API Client
+ *
+ * TODO: Replace with real API calls when Control Plane is available
+ */ import { getEnvironment } from '../constants.js';
+import { isDebug } from '../utils/is-debug.js';
+import * as log from '../utils/log.js';
+/**
+ * Control Plane API base URLs
+ */ const CONTROL_PLANE_API_URLS = {
+    production: 'https://api.figma.com',
+    staging: 'https://api.staging.figma.com'
+};
+/**
+ * Get the Control Plane API base URL based on environment
+ */ function getControlPlaneBaseUrl() {
+    return process.env.FIGMA_API_BASE_URL || CONTROL_PLANE_API_URLS[getEnvironment()];
+}
+/**
+ * Error thrown when Control Plane API calls fail
+ */ export class ControlPlaneError extends Error {
+    statusCode;
+    cause;
+    constructor(message, statusCode, cause){
+        super(message), this.statusCode = statusCode, this.cause = cause;
+        this.name = 'ControlPlaneError';
+    }
+}
+/**
+ * List all tenant instances for the authenticated user
+ * Maps to: GET /v1/tenant
+ *
+ * @param accessToken - OAuth access token
+ * @returns Array of tenant instances
+ */ export async function listTenants(accessToken) {
+    // Check if control plane API should be mocked
+    // Default to true until real API is available
+    const shouldMock = process.env.FIGMA_MOCK_CONTROL_PLANE !== 'false';
+    if (shouldMock) {
+        // MOCK IMPLEMENTATION: Return sample tenants for testing
+        log.debug('Using mock Control Plane API for listTenants (FIGMA_MOCK_CONTROL_PLANE != "false")');
+        return [
+            {
+                id: 'tenant_abc123',
+                createdAt: '2025-01-15T10:00:00Z',
+                domain: 'my-blog.figmacms.com',
+                parentId: 'team_456',
+                parentType: 'team',
+                status: 'active'
+            },
+            {
+                id: 'tenant_def456',
+                createdAt: '2025-01-10T14:30:00Z',
+                domain: 'my-store.figmacms.com',
+                parentId: 'team_456',
+                parentType: 'team',
+                status: 'active'
+            }
+        ];
+    }
+    // REAL API IMPLEMENTATION
+    const response = await fetch(`${getControlPlaneBaseUrl()}/v1/tenant`, {
+        headers: {
+            Authorization: `Bearer ${accessToken}`
+        }
+    });
+    if (!response.ok) {
+        throw new ControlPlaneError(`Failed to list tenants: ${response.status} ${response.statusText}`, response.status);
+    }
+    return response.json();
+}
+/**
+ * Create a new tenant instance
+ * Maps to: POST /v1/tenant
+ *
+ * @param accessToken - OAuth access token
+ * @param options - Tenant creation options
+ * @returns Newly created tenant
+ */ export async function createTenant(accessToken, options) {
+    // Check if control plane API should be mocked
+    const shouldMock = process.env.FIGMA_MOCK_CONTROL_PLANE !== 'false';
+    if (shouldMock) {
+        // MOCK IMPLEMENTATION: Generate mock tenant for testing
+        log.debug('Using mock Control Plane API for createTenant (FIGMA_MOCK_CONTROL_PLANE != "false")');
+        const tenantId = `tenant_${Math.random().toString(36).substring(2, 11)}`;
+        const slug = options.name.toLowerCase().replace(/[^a-z0-9]+/g, '-');
+        const domain = `${slug}.figmacms.com`;
+        return {
+            id: tenantId,
+            createdAt: new Date().toISOString(),
+            domain,
+            parentId: options.parentId || 'team_456',
+            parentType: options.parentType || 'team',
+            status: 'provisioning'
+        };
+    }
+    // REAL API IMPLEMENTATION
+    const response = await fetch(`${getControlPlaneBaseUrl()}/v1/tenant`, {
+        body: JSON.stringify({
+            name: options.name
+        }),
+        headers: {
+            Authorization: `Bearer ${accessToken}`,
+            'Content-Type': 'application/json'
+        },
+        method: 'POST'
+    });
+    if (!response.ok) {
+        throw new ControlPlaneError(`Failed to create tenant: ${response.status} ${response.statusText}`, response.status);
+    }
+    return response.json();
+}
+/**
+ * Get details for a specific tenant
+ * Maps to: GET /v1/tenant/{tenant_id}
+ *
+ * @param accessToken - OAuth access token
+ * @param tenantId - Tenant ID
+ * @returns Tenant details
+ */ export async function getTenantDetails(accessToken, tenantId) {
+    // Check if control plane API should be mocked
+    const shouldMock = process.env.FIGMA_MOCK_CONTROL_PLANE !== 'false';
+    if (shouldMock) {
+        // MOCK IMPLEMENTATION: Return mock tenant details for testing
+        log.debug('Using mock Control Plane API for getTenantDetails (FIGMA_MOCK_CONTROL_PLANE != "false")');
+        return {
+            id: tenantId,
+            createdAt: '2025-01-15T10:00:00Z',
+            domain: 'example.figmacms.com',
+            parentId: 'team_456',
+            parentType: 'team',
+            status: 'active'
+        };
+    }
+    // REAL API IMPLEMENTATION
+    const response = await fetch(`${getControlPlaneBaseUrl()}/v1/tenant/${tenantId}`, {
+        headers: {
+            Authorization: `Bearer ${accessToken}`
+        }
+    });
+    if (!response.ok) {
+        throw new ControlPlaneError(`Failed to get tenant details: ${response.status} ${response.statusText}`, response.status);
+    }
+    return response.json();
+}
+/**
+ * Create a new deployment and get signed upload URLs
+ * Maps to: POST /v1/tenant/{tenant_id}/deploy/create
+ *
+ * @param accessToken - OAuth access token
+ * @param tenantId - Tenant ID
+ * @param options - Deployment creation options
+ * @returns Deployment ID and upload URLs
+ */ export async function createDeployment(accessToken, tenantId, options) {
+    // Check if control plane API should be mocked
+    const shouldMock = process.env.FIGMA_MOCK_CONTROL_PLANE !== 'false';
+    if (shouldMock) {
+        // MOCK IMPLEMENTATION: Generate mock deployment and signed URLs
+        if (isDebug()) {
+            log.debug('Using mock Control Plane API for createDeployment (FIGMA_MOCK_CONTROL_PLANE != "false")');
+        }
+        const deploymentId = `deploy_${Math.random().toString(36).substring(2, 11)}`;
+        const mockBucket = 'figma-cms-deployments-mock';
+        const mockRegion = 'us-west-2';
+        const mockBaseUrl = `https://${mockBucket}.s3.${mockRegion}.amazonaws.com`;
+        // Generate mock signed URLs for static assets
+        const staticAssetUploadUrls = {};
+        for (const assetPath of options.staticAssets){
+            const encodedPath = encodeURIComponent(assetPath);
+            staticAssetUploadUrls[assetPath] = `${mockBaseUrl}/${tenantId}/${deploymentId}/static/${encodedPath}?X-Amz-Signature=mock`;
+        }
+        // Generate mock signed URL for code zip
+        const codeUploadUrl = `${mockBaseUrl}/${tenantId}/${deploymentId}/lambda.zip?X-Amz-Signature=mock`;
+        return {
+            codeUploadUrl,
+            deploymentId,
+            staticAssetUploadUrls
+        };
+    }
+    // REAL API IMPLEMENTATION
+    const response = await fetch(`${getControlPlaneBaseUrl()}/v1/tenant/${tenantId}/deploy/create`, {
+        body: JSON.stringify({
+            static_assets: options.staticAssets
+        }),
+        headers: {
+            Authorization: `Bearer ${accessToken}`,
+            'Content-Type': 'application/json'
+        },
+        method: 'POST'
+    });
+    if (!response.ok) {
+        throw new ControlPlaneError(`Failed to create deployment: ${response.status} ${response.statusText}`, response.status);
+    }
+    const data = await response.json();
+    // Map API response format to our interface
+    return {
+        codeUploadUrl: data.meta.code_upload_url,
+        deploymentId: data.meta.deployment_id,
+        staticAssetUploadUrls: data.meta.static_asset_upload_urls
+    };
+}
+/**
+ * Perform deployment for a created deployment ID
+ * Maps to: POST /v1/tenant/{tenant_id}/deploy/perform
+ *
+ * @param accessToken - OAuth access token
+ * @param tenantId - Tenant ID
+ * @param options - Deployment perform options
+ * @returns Deployment status and message
+ */ export async function performDeployment(accessToken, tenantId, options) {
+    // Check if control plane API should be mocked
+    const shouldMock = process.env.FIGMA_MOCK_CONTROL_PLANE !== 'false';
+    if (shouldMock) {
+        // MOCK IMPLEMENTATION: Return mock deployment status
+        if (isDebug()) {
+            log.debug('Using mock Control Plane API for performDeployment (FIGMA_MOCK_CONTROL_PLANE != "false")');
+        }
+        return {
+            deploymentId: options.deploymentId,
+            message: 'Deployment initiated successfully'
+        };
+    }
+    // REAL API IMPLEMENTATION
+    const response = await fetch(`${getControlPlaneBaseUrl()}/v1/tenant/${tenantId}/deploy/perform`, {
+        body: JSON.stringify({
+            deployment_id: options.deploymentId
+        }),
+        headers: {
+            Authorization: `Bearer ${accessToken}`,
+            'Content-Type': 'application/json'
+        },
+        method: 'POST'
+    });
+    if (!response.ok) {
+        throw new ControlPlaneError(`Failed to perform deployment: ${response.status} ${response.statusText}`, response.status);
+    }
+    const data = await response.json();
+    // Map API response to our interface
+    return {
+        deploymentId: data.meta.deployment_id,
+        message: data.meta.message || 'Deployment initiated'
+    };
+}
+
+//# sourceMappingURL=control-plane.js.map

package/dist/api/control-plane.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/api/control-plane.ts"],"sourcesContent":["/**\n * Control Plane API Client\n *\n * TODO: Replace with real API calls when Control Plane is available\n */\n\nimport type { Tenant } from '../types/config.js'\n\nimport { getEnvironment } from '../constants.js'\nimport { isDebug } from '../utils/is-debug.js'\nimport * as log from '../utils/log.js'\n\n/**\n * Control Plane API base URLs\n */\nconst CONTROL_PLANE_API_URLS = {\n  production: 'https://api.figma.com',\n  staging: 'https://api.staging.figma.com',\n}\n\n/**\n * Get the Control Plane API base URL based on environment\n */\nfunction getControlPlaneBaseUrl(): string {\n  return process.env.FIGMA_API_BASE_URL || CONTROL_PLANE_API_URLS[getEnvironment()]\n}\n\n/**\n * Error thrown when Control Plane API calls fail\n */\nexport class ControlPlaneError extends Error {\n  constructor(\n    message: string,\n    public statusCode?: number,\n    public cause?: Error,\n  ) {\n    super(message)\n    this.name = 'ControlPlaneError'\n  }\n}\n\n/**\n * Options for creating a new tenant\n */\nexport interface CreateTenantOptions {\n  /** Name for the new CMS instance */\n  name: string\n  /** Optional parent ID */\n  parentId?: string\n  /** Optional parent type */\n  parentType?: 'org' | 'team' | 'workspace'\n}\n\n/**\n * Options for creating a new deployment\n */\nexport interface CreateDeploymentOptions {\n  /** List of static asset paths that need upload URLs */\n  staticAssets: string[]\n}\n\n/**\n * Response from creating a new deployment\n */\nexport interface CreateDeploymentResponse {\n  /** Upload URL for the Lambda function code zip */\n  codeUploadUrl: string\n  /** Unique deployment ID */\n  deploymentId: string\n  /** Map of static asset paths to their signed S3 upload URLs */\n  staticAssetUploadUrls: Record<string, string>\n}\n\nexport interface CreateDeploymentApiResponse {\n  error: boolean\n  meta: {\n    code_upload_url: string\n    deployment_id: string\n    static_asset_upload_urls: Record<string, string>\n  }\n  status: number\n}\n\n/**\n * Options for performing a deployment\n */\nexport interface PerformDeploymentOptions {\n  /** Deployment ID from createDeployment */\n  deploymentId: string\n}\n\n/**\n * Response from performing a deployment\n */\nexport interface PerformDeploymentResponse {\n  /** Deployment ID that was deployed */\n  deploymentId: string\n  /** Status message */\n  message: string\n}\n\nexport interface PerformDeploymentApiResponse {\n  error: boolean\n  meta: {\n    deployment_id: string\n    message: string\n    status: string\n  }\n  status: number\n}\n\n/**\n * List all tenant instances for the authenticated user\n * Maps to: GET /v1/tenant\n *\n * @param accessToken - OAuth access token\n * @returns Array of tenant instances\n */\nexport async function listTenants(accessToken: string): Promise<Tenant[]> {\n  // Check if control plane API should be mocked\n  // Default to true until real API is available\n  const shouldMock = process.env.FIGMA_MOCK_CONTROL_PLANE !== 'false'\n\n  if (shouldMock) {\n    // MOCK IMPLEMENTATION: Return sample tenants for testing\n    log.debug('Using mock Control Plane API for listTenants (FIGMA_MOCK_CONTROL_PLANE != \"false\")')\n    return [\n      {\n        id: 'tenant_abc123',\n        createdAt: '2025-01-15T10:00:00Z',\n        domain: 'my-blog.figmacms.com',\n        parentId: 'team_456',\n        parentType: 'team',\n        status: 'active',\n      },\n      {\n        id: 'tenant_def456',\n        createdAt: '2025-01-10T14:30:00Z',\n        domain: 'my-store.figmacms.com',\n        parentId: 'team_456',\n        parentType: 'team',\n        status: 'active',\n      },\n    ]\n  }\n\n  // REAL API IMPLEMENTATION\n  const response = await fetch(`${getControlPlaneBaseUrl()}/v1/tenant`, {\n    headers: { Authorization: `Bearer ${accessToken}` },\n  })\n\n  if (!response.ok) {\n    throw new ControlPlaneError(\n      `Failed to list tenants: ${response.status} ${response.statusText}`,\n      response.status,\n    )\n  }\n\n  return response.json()\n}\n\n/**\n * Create a new tenant instance\n * Maps to: POST /v1/tenant\n *\n * @param accessToken - OAuth access token\n * @param options - Tenant creation options\n * @returns Newly created tenant\n */\nexport async function createTenant(\n  accessToken: string,\n  options: CreateTenantOptions,\n): Promise<Tenant> {\n  // Check if control plane API should be mocked\n  const shouldMock = process.env.FIGMA_MOCK_CONTROL_PLANE !== 'false'\n\n  if (shouldMock) {\n    // MOCK IMPLEMENTATION: Generate mock tenant for testing\n    log.debug('Using mock Control Plane API for createTenant (FIGMA_MOCK_CONTROL_PLANE != \"false\")')\n    const tenantId = `tenant_${Math.random().toString(36).substring(2, 11)}`\n    const slug = options.name.toLowerCase().replace(/[^a-z0-9]+/g, '-')\n    const domain = `${slug}.figmacms.com`\n\n    return {\n      id: tenantId,\n      createdAt: new Date().toISOString(),\n      domain,\n      parentId: options.parentId || 'team_456',\n      parentType: options.parentType || 'team',\n      status: 'provisioning',\n    }\n  }\n\n  // REAL API IMPLEMENTATION\n  const response = await fetch(`${getControlPlaneBaseUrl()}/v1/tenant`, {\n    body: JSON.stringify({ name: options.name }),\n    headers: {\n      Authorization: `Bearer ${accessToken}`,\n      'Content-Type': 'application/json',\n    },\n    method: 'POST',\n  })\n\n  if (!response.ok) {\n    throw new ControlPlaneError(\n      `Failed to create tenant: ${response.status} ${response.statusText}`,\n      response.status,\n    )\n  }\n\n  return response.json()\n}\n\n/**\n * Get details for a specific tenant\n * Maps to: GET /v1/tenant/{tenant_id}\n *\n * @param accessToken - OAuth access token\n * @param tenantId - Tenant ID\n * @returns Tenant details\n */\nexport async function getTenantDetails(accessToken: string, tenantId: string): Promise<Tenant> {\n  // Check if control plane API should be mocked\n  const shouldMock = process.env.FIGMA_MOCK_CONTROL_PLANE !== 'false'\n\n  if (shouldMock) {\n    // MOCK IMPLEMENTATION: Return mock tenant details for testing\n    log.debug(\n      'Using mock Control Plane API for getTenantDetails (FIGMA_MOCK_CONTROL_PLANE != \"false\")',\n    )\n    return {\n      id: tenantId,\n      createdAt: '2025-01-15T10:00:00Z',\n      domain: 'example.figmacms.com',\n      parentId: 'team_456',\n      parentType: 'team',\n      status: 'active',\n    }\n  }\n\n  // REAL API IMPLEMENTATION\n  const response = await fetch(`${getControlPlaneBaseUrl()}/v1/tenant/${tenantId}`, {\n    headers: { Authorization: `Bearer ${accessToken}` },\n  })\n\n  if (!response.ok) {\n    throw new ControlPlaneError(\n      `Failed to get tenant details: ${response.status} ${response.statusText}`,\n      response.status,\n    )\n  }\n\n  return response.json()\n}\n\n/**\n * Create a new deployment and get signed upload URLs\n * Maps to: POST /v1/tenant/{tenant_id}/deploy/create\n *\n * @param accessToken - OAuth access token\n * @param tenantId - Tenant ID\n * @param options - Deployment creation options\n * @returns Deployment ID and upload URLs\n */\nexport async function createDeployment(\n  accessToken: string,\n  tenantId: string,\n  options: CreateDeploymentOptions,\n): Promise<CreateDeploymentResponse> {\n  // Check if control plane API should be mocked\n  const shouldMock = process.env.FIGMA_MOCK_CONTROL_PLANE !== 'false'\n\n  if (shouldMock) {\n    // MOCK IMPLEMENTATION: Generate mock deployment and signed URLs\n    if (isDebug()) {\n      log.debug(\n        'Using mock Control Plane API for createDeployment (FIGMA_MOCK_CONTROL_PLANE != \"false\")',\n      )\n    }\n\n    const deploymentId = `deploy_${Math.random().toString(36).substring(2, 11)}`\n    const mockBucket = 'figma-cms-deployments-mock'\n    const mockRegion = 'us-west-2'\n    const mockBaseUrl = `https://${mockBucket}.s3.${mockRegion}.amazonaws.com`\n\n    // Generate mock signed URLs for static assets\n    const staticAssetUploadUrls: Record<string, string> = {}\n    for (const assetPath of options.staticAssets) {\n      const encodedPath = encodeURIComponent(assetPath)\n      staticAssetUploadUrls[assetPath] =\n        `${mockBaseUrl}/${tenantId}/${deploymentId}/static/${encodedPath}?X-Amz-Signature=mock`\n    }\n\n    // Generate mock signed URL for code zip\n    const codeUploadUrl = `${mockBaseUrl}/${tenantId}/${deploymentId}/lambda.zip?X-Amz-Signature=mock`\n\n    return {\n      codeUploadUrl,\n      deploymentId,\n      staticAssetUploadUrls,\n    }\n  }\n\n  // REAL API IMPLEMENTATION\n  const response = await fetch(`${getControlPlaneBaseUrl()}/v1/tenant/${tenantId}/deploy/create`, {\n    body: JSON.stringify({ static_assets: options.staticAssets }),\n    headers: {\n      Authorization: `Bearer ${accessToken}`,\n      'Content-Type': 'application/json',\n    },\n    method: 'POST',\n  })\n\n  if (!response.ok) {\n    throw new ControlPlaneError(\n      `Failed to create deployment: ${response.status} ${response.statusText}`,\n      response.status,\n    )\n  }\n\n  const data = (await response.json()) as CreateDeploymentApiResponse\n\n  // Map API response format to our interface\n  return {\n    codeUploadUrl: data.meta.code_upload_url,\n    deploymentId: data.meta.deployment_id,\n    staticAssetUploadUrls: data.meta.static_asset_upload_urls,\n  }\n}\n\n/**\n * Perform deployment for a created deployment ID\n * Maps to: POST /v1/tenant/{tenant_id}/deploy/perform\n *\n * @param accessToken - OAuth access token\n * @param tenantId - Tenant ID\n * @param options - Deployment perform options\n * @returns Deployment status and message\n */\nexport async function performDeployment(\n  accessToken: string,\n  tenantId: string,\n  options: PerformDeploymentOptions,\n): Promise<PerformDeploymentResponse> {\n  // Check if control plane API should be mocked\n  const shouldMock = process.env.FIGMA_MOCK_CONTROL_PLANE !== 'false'\n\n  if (shouldMock) {\n    // MOCK IMPLEMENTATION: Return mock deployment status\n    if (isDebug()) {\n      log.debug(\n        'Using mock Control Plane API for performDeployment (FIGMA_MOCK_CONTROL_PLANE != \"false\")',\n      )\n    }\n\n    return {\n      deploymentId: options.deploymentId,\n      message: 'Deployment initiated successfully',\n    }\n  }\n\n  // REAL API IMPLEMENTATION\n  const response = await fetch(`${getControlPlaneBaseUrl()}/v1/tenant/${tenantId}/deploy/perform`, {\n    body: JSON.stringify({ deployment_id: options.deploymentId }),\n    headers: {\n      Authorization: `Bearer ${accessToken}`,\n      'Content-Type': 'application/json',\n    },\n    method: 'POST',\n  })\n\n  if (!response.ok) {\n    throw new ControlPlaneError(\n      `Failed to perform deployment: ${response.status} ${response.statusText}`,\n      response.status,\n    )\n  }\n\n  const data = (await response.json()) as PerformDeploymentApiResponse\n\n  // Map API response to our interface\n  return {\n    deploymentId: data.meta.deployment_id,\n    message: data.meta.message || 'Deployment initiated',\n  }\n}\n"],"names":["getEnvironment","isDebug","log","CONTROL_PLANE_API_URLS","production","staging","getControlPlaneBaseUrl","process","env","FIGMA_API_BASE_URL","ControlPlaneError","Error","message","statusCode","cause","name","listTenants","accessToken","shouldMock","FIGMA_MOCK_CONTROL_PLANE","debug","id","createdAt","domain","parentId","parentType","status","response","fetch","headers","Authorization","ok","statusText","json","createTenant","options","tenantId","Math","random","toString","substring","slug","toLowerCase","replace","Date","toISOString","body","JSON","stringify","method","getTenantDetails","createDeployment","deploymentId","mockBucket","mockRegion","mockBaseUrl","staticAssetUploadUrls","assetPath","staticAssets","encodedPath","encodeURIComponent","codeUploadUrl","static_assets","data","meta","code_upload_url","deployment_id","static_asset_upload_urls","performDeployment"],"mappings":"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"}

package/dist/api/control-plane.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=control-plane.spec.d.ts.map

package/dist/api/control-plane.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-plane.spec.d.ts","sourceRoot":"","sources":["../../src/api/control-plane.spec.ts"],"names":[],"mappings":""}