Overview

Overview

Welcome to Firefly, Amazon Music’s GraphQL aggregation service.

Firefly unifies Amazon Music APIs for first and third party clients, providing a consistent experience across services, faster response times via caching, and built-in query optimization. Currently integrated with Artist, Album, Track, Playlist, Podcast, Likes, and Search data.

Code Structure

src/
├── authorizer/          # Authorization Lambda for validating calls
├── daos/                # Data Access Objects for downstream dependencies
├── decorators/          # Annotation functions used throughout service
├── handlers/            # Lambda entry points
│   ├── graphql.ts       # GraphQL API entrypoints
│   └── graphqlCore.ts   # GraphQL resolution service (internal)
├── models/              # Data models and GraphQL types
├── resolvers/           # GraphQL root and field resolver classes
├── transformers/        # Convert downstream data to Firefly schema
└── utils/               # Utility classes and functions

Getting Help

Support Channels

Engagement Model

For feature requests, service integration, design help, or schema changes, see our Engagement Model.

External Resources