@payloadcms/figma 0.0.1-alpha.8 → 0.1.0-alpha.0

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

@@ -1,110 +1,75 @@
-import type { FigmaTokens, JWTPayload, ProjectToken, TokenStoreConfig } from './types.js';
+import type { Environment } from '../constants.js';
+import type { BootstrapData, FigmaTokens, ProjectStoreScope, ProjectToken, TokenStoreConfig } from './types.js';
 /**
- * Secure storage manager for Figma OAuth2 tokens
- *
- * Uses the `conf` library to store tokens in an OS-specific secure location:
- * - macOS: ~/Library/Preferences/payloadcms-figma
- * - Linux: ~/.config/payloadcms-figma or $XDG_CONFIG_HOME/payloadcms-figma
- * - Windows: %APPDATA%/payloadcms-figma/Config
+ * Get the singleton TokenStore instance for an environment.
+ */
+export declare function getTokenStore(environment?: Environment): TokenStore;
+/**
+ * Secure storage manager for OAuth tokens and project-scoped bootstrap/token data.
  *
- * Tokens are encrypted at rest with a machine-specific key and file permissions
- * are set to 0600 (owner read/write only)
+ * For production code, use getTokenStore() to get the singleton instance.
+ * The constructor is still exported for test isolation.
  */
 export declare class TokenStore {
-    private config;
+    private baseConfigName;
+    private deriveLegacyKey;
+    private encryptionKey;
+    private environment;
+    private legacyRootDir;
+    private oauthConfig;
+    private projectName;
+    private projectStoreConfigs;
     constructor(options?: TokenStoreConfig);
-    /**
-     * Retrieve stored tokens
-     * @returns FigmaTokens if stored, null otherwise
-     */
-    getTokens(): FigmaTokens | null;
-    /**
-     * Store OAuth2 tokens securely
-     * @param tokens - Figma OAuth2 tokens to store
-     */
+    getOauthInfo(): FigmaTokens | null;
     setTokens(tokens: FigmaTokens): void;
-    /**
-     * Clear all stored tokens (used for logout)
-     */
     clearTokens(): void;
-    /**
-     * Check if valid (non-expired) tokens exist
-     * @returns true if tokens exist and are not expired
-     */
-    hasValidTokens(): boolean;
-    /**
-     * Check if the current access token is expired
-     * Includes a buffer time to avoid using tokens that are about to expire
-     * @returns true if token is expired or will expire within buffer time
-     */
-    isExpired(): boolean;
-    /**
-     * Get the access token if it exists and is valid
-     * @returns Access token string or null if expired/missing
-     */
-    getAccessToken(): null | string;
-    /**
-     * Get the refresh token if it exists
-     * @returns Refresh token string or null if missing
-     */
-    getRefreshToken(): null | string;
-    /**
-     * Update just the access token after a refresh
-     * Preserves the existing refresh token and other metadata
-     * @param accessToken - New access token
-     * @param expiresIn - Expiration time in seconds
-     */
+    hasValidOauthToken(): boolean;
+    isOauthExpired(): boolean;
+    getCurrentOauthToken(): null | string;
+    getCurrentRefreshToken(): null | string;
     updateAccessToken(accessToken: string, expiresIn: number): void;
     /**
-     * Get the path to the config file (useful for debugging)
-     * @returns Absolute path to the token storage file
+     * Returns the OAuth storage file path.
      */
     getStoragePath(): string;
-    /**
-     * Retrieve a project token for a specific tenant
-     * Automatically removes expired tokens from storage
-     * @param tenantId - The tenant/CMS ID
-     * @returns ProjectToken if stored and valid, null otherwise
-     */
-    getProjectToken(tenantId: string): null | ProjectToken;
-    /**
-     * Store a project token for a specific tenant
-     * @param tenantId - The tenant/CMS ID
-     * @param projectToken - The project token to store
-     */
-    setProjectToken(tenantId: string, projectToken: ProjectToken): void;
-    /**
-     * Clear a project token for a specific tenant
-     * @param tenantId - The tenant/CMS ID
-     */
-    clearProjectToken(tenantId: string): void;
-    /**
-     * Clear all project tokens
-     */
-    clearAllProjectTokens(): void;
-    /**
-     * Check if a project token is expired
-     * Includes a buffer time to avoid using tokens that are about to expire
-     * @param projectToken - The project token to check
-     * @returns true if token is expired or will expire within buffer time
-     */
-    isProjectTokenExpired(projectToken: ProjectToken): boolean;
-    /**
-     * Check if a valid (non-expired) project token exists for a tenant
-     * @param tenantId - The tenant/CMS ID
-     * @returns true if token exists and is not expired
-     */
-    hasValidProjectToken(tenantId: string): boolean;
-    /**
-     * Get validated JWT claims from a project token
-     * @param tenantId - The tenant/CMS ID
-     * @returns JWT payload claims or null if token not found or has no claims
-     */
-    getProjectTokenClaims(tenantId: string): JWTPayload | null;
-    /**
-     * Get all tenant IDs that have stored project tokens
-     * @returns Array of tenant IDs
-     */
-    getAllProjectTokenTenantIds(): string[];
+    getProjectToken({ projectInfo, }?: {
+        projectInfo?: ProjectStoreScope;
+    }): null | ProjectToken;
+    setProjectToken({ projectInfo, token, }: {
+        projectInfo?: ProjectStoreScope;
+        token: ProjectToken;
+    }): void;
+    clearProjectToken({ projectInfo }?: {
+        projectInfo?: ProjectStoreScope;
+    }): void;
+    isProjectTokenExpired(token: ProjectToken): boolean;
+    hasValidProjectToken({ projectInfo }?: {
+        projectInfo?: ProjectStoreScope;
+    }): boolean;
+    /**
+     * Get the tenantId (contentSystemId) for the project scope.
+     * Returns null if bootstrap data is not available.
+     */
+    getTenantId({ projectInfo }?: {
+        projectInfo?: ProjectStoreScope;
+    }): null | string;
+    /**
+     * Derive project info from environment variables.
+     * Returns null if either FIGMA_PROJECT_ID or FIGMA_ENVIRONMENT_NAME is not set.
+     */
+    private getProjectInfoFromEnv;
+    getBootstrapData(projectId: string, environmentName: string): BootstrapData | null;
+    setBootstrapData(projectId: string, environmentName: string, data: BootstrapData): void;
+    clearBootstrapData(projectId: string, environmentName: string): void;
+    private buildOAuthConfigName;
+    private buildOAuthStoreCwd;
+    private buildProjectStoreConfigName;
+    private buildProjectStoreCwd;
+    private sanitizeConfigSegment;
+    private projectInfoKey;
+    private getLegacyRootDir;
+    private getProjectStore;
+    private createConfig;
+    private tryMigrateLegacyKey;
+    private safeGet;
 }
-//# sourceMappingURL=token-store.d.ts.map