adobe-reference-architecture

# Adobe Reference Architecture ## Overview Production-ready architecture patterns for Adobe API integrations, designed around the three main API families: Firefly Services (creative AI), PDF Services (document automation), and I/O Events (event-driven). ## Prerequisites - Understanding of layered architecture - TypeScript project setup - Decision on which Adobe APIs to integrate ## Instructions ### Step 1: Project Structure ``` my-adobe-project/ ├── src/ │ ├── adobe/ # Adobe client layer │ │ ├── auth.ts # OAuth Server-to-Server token management │ │ ├── firefly-client.ts # Firefly API wrapper (generate, fill, expand) │ │ ├── pdf-client.ts # PDF Services wrapper (create, extract, merge) │ │ ├── photoshop-client.ts # Photoshop API wrapper (cutout, actions) │ │ ├── events-client.ts # I/O Events registration and verification │ │ ├── types.ts # Shared Adobe types │ │ └── errors.ts # Error classification (retryable vs permanent) │ ├── services/ # Business logic layer │ │ ├── image-generation.ts # Orchestrates Firefly + Photoshop workflows │ │ ├── document-pipeline.ts # Orchestrates PDF create/extract/merge │ │ └── event-processor.ts # Routes and processes I/O Events │ ├── api/ # API layer (routes, controllers) │ │ ├── health.ts # Health check including Adobe IMS │ │ ├── webhooks/...