@payloadcms/figma 0.0.1-alpha.5 → 0.0.1-alpha.50

package/dist/config/oauth.d.ts

@@ -1,19 +1,9 @@
 import type { OAuthConfig } from '../auth/types.js';
-export declare const URLS: Record<'prod' | 'staging', Pick<OAuthConfig, 'authorizationUrl' | 'refreshUrl' | 'tokenUrl'>>;
+export declare const DEFAULT_CALLBACK_PORT = 34462;
 /**
- * Figma OAuth2 configuration for public CLI client
- *
- * This is a PUBLIC OAuth client using PKCE (Proof Key for Code Exchange).
- * No client secret is used because CLIs cannot securely store secrets.
- * PKCE provides security through the code_verifier/code_challenge mechanism.
- *
- * For production use, register a public OAuth app with Figma.
- * To register an OAuth app, visit: https://www.figma.com/developers/api#oauth2
- */
-export declare const OAUTH_CONFIG: OAuthConfig;
-/**
- * Buffer time (in seconds) before token expiration to consider token as expired
- * This helps avoid using tokens that are about to expire
+ * Get OAuth configuration for current environment
+ * Uses getEnvConfig() to determine staging vs production
  */
+export declare function getOAuthConfig(): OAuthConfig;
 export declare const TOKEN_EXPIRY_BUFFER_SECONDS = 300;
 //# sourceMappingURL=oauth.d.ts.map

package/dist/config/oauth.js

@@ -1,43 +1,21 @@
-import { FIGMA_CLIENT_IDS } from '../constants.js';
-export const URLS = {
-    prod: {
-        authorizationUrl: 'https://www.figma.com/oauth',
-        refreshUrl: 'https://api.figma.com/v1/oauth/refresh',
-        tokenUrl: 'https://api.figma.com/v1/oauth/token'
-    },
-    staging: {
-        authorizationUrl: 'https://staging.figma.com/oauth',
-        refreshUrl: 'https://api.staging.figma.com/v1/oauth/refresh',
-        tokenUrl: 'https://api.staging.figma.com/v1/oauth/token'
-    }
-};
+import { getEnvConfig } from '../constants.js';
+export const DEFAULT_CALLBACK_PORT = 34462;
 /**
- * Figma OAuth2 configuration for public CLI client
- *
- * This is a PUBLIC OAuth client using PKCE (Proof Key for Code Exchange).
- * No client secret is used because CLIs cannot securely store secrets.
- * PKCE provides security through the code_verifier/code_challenge mechanism.
- *
- * For production use, register a public OAuth app with Figma.
- * To register an OAuth app, visit: https://www.figma.com/developers/api#oauth2
- */ export const OAUTH_CONFIG = {
-    // OAuth client ID (public client)
-    // Uses staging client ID by default since we use staging endpoints
-    clientId: process.env.FIGMA_CLIENT_ID || FIGMA_CLIENT_IDS.staging,
-    // No client secret - this is a public OAuth client using PKCE
-    // Public clients cannot securely store secrets in CLI environments
-    redirectUri: process.env.FIGMA_REDIRECT_URI || 'http://localhost:3000/callback',
-    // Only current_user:read scope is needed for basic user info
-    scopes: [
-        'current_user:read'
-    ],
-    // TODO: Dynamically choose between prod and staging based on environment
-    ...URLS.staging
-};
-/**
- * Buffer time (in seconds) before token expiration to consider token as expired
- * This helps avoid using tokens that are about to expire
- */ export const TOKEN_EXPIRY_BUFFER_SECONDS = 300 // 5 minutes
-;
+ * Get OAuth configuration for current environment
+ * Uses getEnvConfig() to determine staging vs production
+ */ export function getOAuthConfig() {
+    const { apiBaseUrl, authorizationUrl, clientId } = getEnvConfig();
+    return {
+        authorizationUrl,
+        clientId: process.env.FIGMA_CLIENT_ID || clientId,
+        redirectUri: process.env.FIGMA_REDIRECT_URI || `http://localhost:${DEFAULT_CALLBACK_PORT}/callback`,
+        refreshUrl: `${apiBaseUrl}/v1/oauth/refresh`,
+        scopes: [
+            'current_user:read'
+        ],
+        tokenUrl: `${apiBaseUrl}/v1/oauth/token`
+    };
+}
+export const TOKEN_EXPIRY_BUFFER_SECONDS = 300;
 
 //# sourceMappingURL=oauth.js.map

package/dist/constants.d.ts

@@ -1,27 +1,44 @@
-export declare const FIGMA_CLIENT_IDS: {
-    production: string;
-    staging: string;
-};
-export declare const JWKS_URI: {
-    production: string;
-    staging: string;
-};
 /**
- * Figma environment (production or staging)
+ * Figma infrastructure environment (production or staging)
  */
 export type Environment = 'production' | 'staging';
+type EnvironmentConfig = {
+    /** Figma API base URL. Override: FIGMA_API_BASE_URL */
+    apiBaseUrl: string;
+    /** OAuth authorization URL (CLI auth) */
+    authorizationUrl: string;
+    /** OAuth client ID. Override: FIGMA_CLIENT_ID or FIGMA_OAUTH_CLIENT_ID */
+    clientId: string;
+    /** Content API base URL. Override: FIGMA_CONTENT_API_URL */
+    contentApiUrl: string;
+    /** OIDC discovery endpoint */
+    identityMetadata: string;
+    /** JSON Web Key Set URL for token validation */
+    jwksUri: string;
+};
+/**
+ * Environment-specific configuration for Figma integration.
+ * Selected via FIGMA_INFRA_ENV ('production' | 'staging'), defaults to 'production'.
+ */
+export declare const ENV_CONFIG: Record<Environment, EnvironmentConfig>;
+/**
+ * User-facing error message when Content API returns 404 or 410.
+ * Used across CLI commands and the db adapter for consistent messaging.
+ */
+export declare const CONTENT_SYSTEM_NOT_FOUND_MESSAGE = "Content system not found. Verify your Content System ID is correct, or contact your team admin for assistance.";
+/**
+ * Set infrastructure environment override (used by --infra-env CLI flag)
+ * Pass undefined to clear the override
+ */
+export declare function setInfraEnvironment(env: Environment | undefined): void;
 /**
- * Get current Figma environment from environment variable
- * Defaults to 'staging' if not specified
- *
- * @returns Current environment
+ * Get current Figma infrastructure environment
+ * Priority: 1) setInfraEnvironment override, 2) FIGMA_INFRA_ENV env var, 3) .env file, 4) 'production' default
  */
-export declare function getEnvironment(): Environment;
 /**
- * Get JWKS URI for a given environment
- *
- * @param env - Environment (defaults to current environment)
- * @returns JWKS URI for the environment
+ * Get the resolved EnvironmentConfig for the current infrastructure environment
  */
-export declare function getJWKSUri(env?: Environment): string;
+export declare function getEnvConfig(): EnvironmentConfig;
+export declare function getInfraEnvironment(): Environment;
+export {};
 //# sourceMappingURL=constants.d.ts.map

package/dist/constants.js

@@ -1,27 +1,65 @@
-export const FIGMA_CLIENT_IDS = {
-    production: '',
-    staging: 'wqAToBAp4UI9AZ5M6wTfT9'
-};
-export const JWKS_URI = {
-    production: 'https://static.figmacontent.com/.well_known/jwks.json',
-    staging: 'https://static.figmacontentstaging.com/.well_known/jwks.json'
+import { getEnvVarSync } from './utils/env-management.js';
+/**
+ * Environment-specific configuration for Figma integration.
+ * Selected via FIGMA_INFRA_ENV ('production' | 'staging'), defaults to 'production'.
+ */ export const ENV_CONFIG = {
+    production: {
+        apiBaseUrl: 'https://api.figma.com',
+        authorizationUrl: 'https://www.figma.com/oauth',
+        clientId: 'lelKVTAzOekFnirnlAMbuD',
+        contentApiUrl: 'https://us-east-1.cms-tenants-001-production.figmacontent.com',
+        identityMetadata: 'https://www.figma.com/.well-known/openid-configuration',
+        jwksUri: 'https://static.figmacontent.com/.well_known/jwks.json'
+    },
+    staging: {
+        apiBaseUrl: 'https://api.staging.figma.com',
+        authorizationUrl: 'https://staging.figma.com/oauth',
+        clientId: 'wqAToBAp4UI9AZ5M6wTfT9',
+        contentApiUrl: 'https://us-east-1.cms-tenants-001-staging.figmacontentstaging.com',
+        identityMetadata: 'https://staging.figma.com/.well-known/openid-configuration',
+        jwksUri: 'https://static.figmacontentstaging.com/.well_known/jwks.json'
+    }
 };
 /**
- * Get current Figma environment from environment variable
- * Defaults to 'staging' if not specified
- *
- * @returns Current environment
- */ export function getEnvironment() {
-    return process.env.FIGMA_ENV === 'production' ? 'production' : 'staging';
+ * User-facing error message when Content API returns 404 or 410.
+ * Used across CLI commands and the db adapter for consistent messaging.
+ */ export const CONTENT_SYSTEM_NOT_FOUND_MESSAGE = 'Content system not found. Verify your Content System ID is correct, or contact your team admin for assistance.';
+let envOverride;
+/**
+ * Set infrastructure environment override (used by --infra-env CLI flag)
+ * Pass undefined to clear the override
+ */ export function setInfraEnvironment(env) {
+    envOverride = env;
 }
 /**
- * Get JWKS URI for a given environment
- *
- * @param env - Environment (defaults to current environment)
- * @returns JWKS URI for the environment
- */ export function getJWKSUri(env) {
-    const environment = env || getEnvironment();
-    return JWKS_URI[environment];
+ * Get current Figma infrastructure environment
+ * Priority: 1) setInfraEnvironment override, 2) FIGMA_INFRA_ENV env var, 3) .env file, 4) 'production' default
+ */ /**
+ * Get the resolved EnvironmentConfig for the current infrastructure environment
+ */ export function getEnvConfig() {
+    return ENV_CONFIG[getInfraEnvironment()];
+}
+export function getInfraEnvironment() {
+    if (envOverride) {
+        return envOverride;
+    }
+    // Check process.env first (case-insensitive)
+    if (process.env.FIGMA_INFRA_ENV?.toLowerCase() === 'staging') {
+        return 'staging';
+    }
+    // Fall back to .env file in cwd
+    const envFileValue = getEnvVarSync(process.cwd(), 'FIGMA_INFRA_ENV');
+    if (envFileValue) {
+        const env = envFileValue.toLowerCase();
+        if (env === 'staging') {
+            return 'staging';
+        }
+        if (env !== 'production') {
+            console.warn(`Warning: Invalid FIGMA_INFRA_ENV value "${envFileValue}" in .env file. Using production.`);
+        }
+        return 'production';
+    }
+    return 'production';
 }
 
 //# sourceMappingURL=constants.js.map

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

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