Skip to main content 홈 크리에이터 comeonoliver skillshub adobe-sdk-patterns
adobe-sdk-patterns Apply production-ready patterns for Adobe Firefly Services SDK, PDF Services SDK,
and raw REST API usage in TypeScript and Python.
Use when implementing Adobe integrations, refactoring SDK usage,
or establishing team coding standards for Adobe APIs.
Trigger with phrases like "adobe SDK patterns", "adobe best practices",
"adobe code patterns", "idiomatic adobe", "adobe typescript".
설치로 이동 Skills Marketplace 커뮤니티가 만든 AI 스킬을 발견하고 탐색하세요.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.
npx skills add https://github.com/ComeOnOliver/skillshub --skill adobe-sdk-patterns명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.
로컬 사본을 원하시나요? SkillsMP에서 현재 제공할 수 있는 파일을 다운로드하세요.
Zip 다운로드 다운로드 중... 이 저장소의 다른 Skills Review product and feature risk before an AI coding agent starts implementation.
Use Xquik for X data and confirmation-gated X actions: tweet search, user lookup, follower export, media download, monitors, webhooks, MCP, and SDK workflows.
Canton Network open-source ecosystem guide covering DAML SDK, Canton runtime, and Splice applications. Use when working with Canton Network, DAML smart contracts, or building decentralized applications.
name adobe-sdk-patterns description Apply production-ready patterns for Adobe Firefly Services SDK, PDF Services SDK,
and raw REST API usage in TypeScript and Python.
Use when implementing Adobe integrations, refactoring SDK usage,
or establishing team coding standards for Adobe APIs.
Trigger with phrases like "adobe SDK patterns", "adobe best practices",
"adobe code patterns", "idiomatic adobe", "adobe typescript".
allowed-tools Read, Write, Edit version 1.0.0 license MIT author Jeremy Longshore <jeremy@intentsolutions.io> tags ["saas","design","adobe"] compatible-with claude-code
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
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
expiresAt
Date
now
300_000
return
token
const
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
env
ADOBE_CLIENT_ID
client_secret
env
ADOBE_CLIENT_SECRET
grant_type
'client_credentials'
scope
env
ADOBE_SCOPES
if
ok
throw
new
Error
`Adobe IMS token error: ${res.status} `
const
await
json
token
access_token
expiresAt
Date
now
expires_in
1000
return
token
Pattern 2: Typed API Wrapper with Error Classification
export class AdobeApiError extends Error {
constructor (
message : string ,
public readonly status : number ,
public readonly code : string ,
public readonly retryable : boolean ,
public readonly retryAfter ?: number
) {
super (message);
this .name = 'AdobeApiError' ;
}
}
export async function adobeApiFetch<T>(
url : string ,
options : RequestInit & { apiKey ?: string }
): Promise <T> {
const token = await getAccessToken ();
const { apiKey, ...fetchOptions } = options;
const response = await fetch (url, {
...fetchOptions,
headers : {
'Authorization' : `Bearer ${token} ` ,
'x-api-key' : apiKey || process.env .ADOBE_CLIENT_ID !,
'Content-Type' : 'application/json' ,
...fetchOptions.headers ,
},
});
if (!response.ok ) {
const body = await response.text ();
const retryAfter = response.headers .get ('Retry-After' );
throw new AdobeApiError (
`Adobe API ${response.status} : ${body} ` ,
response.status ,
response.status === 429 ? 'RATE_LIMITED' :
response.status === 401 ? 'AUTH_EXPIRED' :
response.status >= 500 ? 'SERVER_ERROR' : 'CLIENT_ERROR' ,
response.status === 429 || response.status >= 500 ,
retryAfter ? parseInt (retryAfter) : undefined
);
}
return response.json ();
}
Pattern 3: Retry with Exponential Backoff
export async function withRetry<T>(
operation : () => Promise <T>,
config = { maxRetries : 3 , baseDelayMs : 1000 }
): Promise <T> {
for (let attempt = 0 ; attempt <= config.maxRetries ; attempt++) {
try {
return await operation ();
} catch (err : any ) {
if (attempt === config.maxRetries ) throw err;
if (err instanceof AdobeApiError && !err.retryable ) throw err;
const delay = err.retryAfter
? err.retryAfter * 1000
: config.baseDelayMs * Math .pow (2 , attempt) + Math .random () * 500 ;
console .warn (`Adobe retry ${attempt + 1 } /${config.maxRetries} in ${delay} ms` );
await new Promise (r =>setTimeout (r, delay));
}
}
throw new Error ('Unreachable' );
}
Pattern 4: Job Polling for Async APIs (Photoshop, Lightroom)
interface AdobeJobStatus {
status : 'pending' | 'running' | 'succeeded' | 'failed' ;
_links ?: { self : { href : string } };
output ?: any ;
error ?: { code : string ; message : string };
}
export async function pollAdobeJob (
statusUrl : string ,
options = { intervalMs: 2000 , timeoutMs: 120_000 }
): Promise <AdobeJobStatus > {
const token = await getAccessToken ();
const deadline = Date .now () + options.timeoutMs ;
while (Date .now () < deadline) {
const res = await fetch (statusUrl, {
headers : {
'Authorization' : `Bearer ${token} ` ,
'x-api-key' : process.env .ADOBE_CLIENT_ID !,
},
});
const status : AdobeJobStatus = await res.json ();
if (status.status === 'succeeded' ) return status;
if (status.status === 'failed' ) {
throw new Error (`Adobe job failed: ${status.error?.message || 'Unknown error' } ` );
}
await new Promise (r =>setTimeout (r, options.intervalMs ));
}
throw new Error ('Adobe job polling timeout' );
}
Pattern 5: Zod Validation for API Responses import { z } from 'zod' ;
const FireflyImageOutputSchema = z.object ({
outputs : z.array (z.object ({
image : z.object ({
url : z.string ().url (),
}),
seed : z.number (),
})),
});
const PhotoshopJobSchema = z.object ({
status : z.enum (['pending' , 'running' , 'succeeded' , 'failed' ]),
_links : z.object ({
self : z.object ({ href : z.string ().url () }),
}).optional (),
});
const raw = await adobeApiFetch<unknown >(fireflyUrl, { method : 'POST' , body });
const validated = FireflyImageOutputSchema .parse (raw);
Output
Type-safe client singleton with token caching
Error classification (retryable vs permanent)
Automatic retry with Adobe Retry-After header support
Async job polling for Photoshop/Lightroom operations
Zod runtime validation for API responses
Error Handling Pattern Use Case Benefit Token caching All API calls Avoids redundant IMS token requests Error classification Retry decisions Only retries transient failures Job polling Photoshop/Lightroom Handles async operation lifecycle Zod validation All responses Catches API contract changes at runtime
Resources
Next Steps Apply patterns in adobe-core-workflow-a for real-world usage.
