@musallam/photoshop-client

TypeScript client library for the Adobe Photoshop API.

This package is part of the firefly-services-clients monorepo.

Features

• 🚀 Full TypeScript support with auto-generated types from OpenAPI spec
• 📦 API coverage for major Adobe Photoshop endpoints
• 🔄 Async job polling utilities for long-running operations
• 🔐 Built-in authentication via IMS client
• 📝 Comprehensive documentation and usage examples

Installation

npm install @musallam/photoshop-client

Quick Start

import {
  PhotoshopClient,
  PHOTOSHOP_AXIOS_INSTANCE,
  TokenIMSClient,
} from '@musallam/photoshop-client';

// 1. Setup authentication
const imsClient = new TokenIMSClient({
  clientId: 'YOUR_CLIENT_ID',
  clientSecret: 'YOUR_CLIENT_SECRET',
  scopes: ['openid', 'creative_sdk', 'AdobeID'],
});

// 2. Configure axios instance
PHOTOSHOP_AXIOS_INSTANCE.interceptors.request.use(async (config) => {
  const token = await imsClient.getAccessToken();
  config.headers.Authorization = `Bearer ${token}`;
  config.headers['x-api-key'] = 'YOUR_CLIENT_ID';
  return config;
});

// 3. Use the client
const jobs = await PhotoshopClient.getJobs({
  limit: 10,
});
console.log(jobs);

API Coverage

Jobs

• getJobs() - List jobs for your account
• createJob() - Submit a new Photoshop job
• getJob() - Retrieve details about a specific job
• cancelJob() - Cancel an in-progress job

Documents

• getDocument() - Retrieve a Photoshop document
• createDocument() - Create a new document
• updateDocument() - Update or edit an existing document

For full API reference and advanced usage, see: https://ahmed-musallam.github.io/firefly-services-clients/photoshop-client/