adobe-sdk-patterns

# Adobe SDK Patterns ## Overview Production-ready patterns for Adobe SDK usage across Firefly Services (`@adobe/firefly-apis`, `@adobe/photoshop-apis`, `@adobe/lightroom-apis`), PDF Services (`@adobe/pdfservices-node-sdk`), and direct REST API calls. ## Prerequisites - Completed `adobe-install-auth` setup - Familiarity with async/await patterns - Understanding of the Adobe API you are integrating ## Instructions ### Pattern 1: Singleton Auth Client with Token Caching ```typescript // src/adobe/client.ts import { ServicePrincipalCredentials, PDFServices } from '@adobe/pdfservices-node-sdk'; let pdfServicesInstance: PDFServices | null = null; let tokenCache: { token: string; expiresAt: number } | null = null; export function getPDFServices(): PDFServices { if (!pdfServicesInstance) { const credentials = new ServicePrincipalCredentials({ clientId: process.env.ADOBE_CLIENT_ID!, clientSecret: process.env.ADOBE_CLIENT_SECRET!, }); pdfServicesInstance = new PDFServices({ credentials }); } return pdfServicesInstance; } export async function getAccessToken(): Promise<string> { if (tokenCache && tokenCache.expiresAt > Date.now() + 300_000) { return tokenCache.token; } const res = await fetch('https://ims-na1.adobelogin.com/ims/token/v3', { method: 'POST', headers: { 'Content-Type': 'application/x-www-form-urlencoded' }, body: new URLSearchParams({ client_id: process.env.ADOBE_CLIENT_ID!, client_secret: process.e...