Add format script and apply prettier formatting

Author: FlorianKoerner

.vscode/settings.json

@@ -1,3 +1,3 @@
 {
-    "editor.wordBasedSuggestions": "off"
-}
+  "editor.wordBasedSuggestions": "off"
+}

CLAUDE.md

@@ -28,33 +28,39 @@ node --test tests/http.test.js
 ## Architecture
 
 ### Multi-Version Support
+
 The API uses npm workspaces to maintain multiple DiceBear library versions side-by-side:
+
 - `versions/5.x/` through `versions/9.x/` - Each contains a package.json that pins specific `@dicebear/core` and `@dicebear/collection` versions
 - Versions are loaded dynamically via `src/utils/versions.ts` based on the `VERSIONS` env var
 - Routes are prefixed by version: `/:version/:style/:format` (e.g., `/9.x/avataaars/svg`)
 
 ### Route Structure
+
 ```
 src/routes/version.ts   → Registers routes for each enabled version
 src/routes/collection.ts → Registers routes for each avatar style in a version
 src/routes/style.ts     → Defines the actual endpoints (/:format, /:format/:options, /schema.json)
 ```
 
 ### Request Flow
+
 1. Request hits `/:version/:style/:format` or `/:version/:style/:format/:options`
 2. Query string parsing via `src/utils/query-string.ts` (supports both `?key=value` and path-based `/key=value`)
 3. Options validated against combined JSON Schema from core + style
 4. `src/handler/avatar.ts` creates avatar using the appropriate DiceBear version
 5. Format conversion (PNG, JPEG, WebP, AVIF) via `@dicebear/converter`
 
 ### Font System
+
 - `scripts/build-fonts.ts` - Pre-build script that extracts TTF fonts from @fontsource packages
 - Fonts are used for rendering text in raster formats (initials style, etc.)
 - Font selection based on Unicode ranges in `fonts/fonts.json`
 
 ## Configuration
 
 All configuration is via environment variables (see `src/config.ts`):
+
 - `PORT`, `HOST`, `WORKERS` - Server settings
 - `VERSIONS` - Comma-separated list of versions to enable (default: 5,6,7,8,9)
 - `PNG`, `JPEG`, `WEBP`, `AVIF`, `JSON` - Enable/disable output formats (0/1)

CODE_OF_CONDUCT.md

@@ -17,23 +17,23 @@ diverse, inclusive, and healthy community.
 Examples of behavior that contributes to a positive environment for our
 community include:
 
-* Demonstrating empathy and kindness toward other people
-* Being respectful of differing opinions, viewpoints, and experiences
-* Giving and gracefully accepting constructive feedback
-* Accepting responsibility and apologizing to those affected by our mistakes,
+- Demonstrating empathy and kindness toward other people
+- Being respectful of differing opinions, viewpoints, and experiences
+- Giving and gracefully accepting constructive feedback
+- Accepting responsibility and apologizing to those affected by our mistakes,
   and learning from the experience
-* Focusing on what is best not just for us as individuals, but for the
+- Focusing on what is best not just for us as individuals, but for the
   overall community
 
 Examples of unacceptable behavior include:
 
-* The use of sexualized language or imagery, and sexual attention or
+- The use of sexualized language or imagery, and sexual attention or
   advances of any kind
-* Trolling, insulting or derogatory comments, and personal or political attacks
-* Public or private harassment
-* Publishing others' private information, such as a physical or email
+- Trolling, insulting or derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others' private information, such as a physical or email
   address, without their explicit permission
-* Other conduct which could reasonably be considered inappropriate in a
+- Other conduct which could reasonably be considered inappropriate in a
   professional setting
 
 ## Enforcement Responsibilities
@@ -106,7 +106,7 @@ Violating these terms may lead to a permanent ban.
 ### 4. Permanent Ban
 
 **Community Impact**: Demonstrating a pattern of violation of community
-standards, including sustained inappropriate behavior,  harassment of an
+standards, including sustained inappropriate behavior, harassment of an
 individual, or aggression toward or disparagement of classes of individuals.
 
 **Consequence**: A permanent ban from any sort of public interaction within

package.json

@@ -10,7 +10,8 @@
     "prebuild": "tsx ./scripts/build-fonts.ts",
     "build": "tsc --build",
     "start": "node ./dist/server.js",
-    "test": "node --test tests/*.js"
+    "test": "node --test tests/*.js",
+    "format": "prettier --write ."
   },
   "workspaces": [
     "./versions/*"

src/config.ts

@@ -31,7 +31,10 @@ export const config: Config = {
 };
 
 // Format metadata mapping request formats to config keys and content types
-export const IMAGE_FORMATS: Record<string, { configKey: ImageFormat; contentType: string }> = {
+export const IMAGE_FORMATS: Record<
+  string,
+  { configKey: ImageFormat; contentType: string }
+> = {
   png: { configKey: 'png', contentType: 'image/png' },
   jpg: { configKey: 'jpeg', contentType: 'image/jpeg' },
   jpeg: { configKey: 'jpeg', contentType: 'image/jpeg' },

src/handler/avatar.ts

@@ -23,7 +23,7 @@ const FORMAT_CONVERTERS = {
 export function avatarHandler(app: FastifyInstance, core: Core, style: any) {
   return async (
     request: FastifyRequest<AvatarRequest>,
-    reply: FastifyReply
+    reply: FastifyReply,
   ) => {
     const options = request.query;
     const format = request.params.format;
@@ -35,7 +35,10 @@ export function avatarHandler(app: FastifyInstance, core: Core, style: any) {
     // Validate and apply size constraints for image formats
     if (formatConfig) {
       options['size'] = options['size']
-        ? Math.min(Math.max(options['size'], formatConfig.size.min), formatConfig.size.max)
+        ? Math.min(
+            Math.max(options['size'], formatConfig.size.min),
+            formatConfig.size.max,
+          )
         : formatConfig.size.default;
     }
 
@@ -64,7 +67,8 @@ export function avatarHandler(app: FastifyInstance, core: Core, style: any) {
     }
 
     // Handle image formats (png, jpg, jpeg, webp, avif)
-    const converter = FORMAT_CONVERTERS[format as keyof typeof FORMAT_CONVERTERS];
+    const converter =
+      FORMAT_CONVERTERS[format as keyof typeof FORMAT_CONVERTERS];
     if (converter && formatConfig) {
       const svgString = avatar.toString();
       const fonts = app.fontLookup.getRequiredFonts(svgString);

src/routes/collection.ts

@@ -10,7 +10,7 @@ type Options = {
 export const collectionRoutes: FastifyPluginCallback<Options> = (
   app,
   { version },
-  done
+  done,
 ) => {
   for (const [prefix, style] of Object.entries(version.collection)) {
     app.register(styleRoutes, {

src/routes/version.ts

@@ -9,7 +9,7 @@ type Options = {
 export const versionRoutes: FastifyPluginCallback<Options> = (
   app,
   { versions },
-  done
+  done,
 ) => {
   for (const [prefix, version] of Object.entries(versions)) {
     app.register(collectionRoutes, {

src/server.ts

@@ -11,7 +11,7 @@ if (cluster.isPrimary && useCluster) {
 
   cluster.on('exit', (worker, code, signal) => {
     console.log(
-      `Worker ${worker.process.pid} died with code ${code} and signal ${signal}`
+      `Worker ${worker.process.pid} died with code ${code} and signal ${signal}`,
     );
 
     // Fork a new worker
@@ -34,6 +34,6 @@ if (cluster.isPrimary && useCluster) {
       }
 
       console.info(`Server listening at http://${config.host}:${config.port}`);
-    }
+    },
   );
 }

src/types.ts

@@ -11,7 +11,7 @@ declare module 'fastify' {
 export type Core = {
   createAvatar: (
     style: any,
-    options?: any
+    options?: any,
   ) => {
     toString: () => string;
     toJson: () => {
@@ -41,7 +41,14 @@ export type ImageFormatConfig = {
 };
 
 export type ImageFormat = 'png' | 'jpeg' | 'webp' | 'avif';
-export type RequestFormat = 'svg' | 'png' | 'jpg' | 'jpeg' | 'webp' | 'avif' | 'json';
+export type RequestFormat =
+  | 'svg'
+  | 'png'
+  | 'jpg'
+  | 'jpeg'
+  | 'webp'
+  | 'avif'
+  | 'json';
 
 export type Config = {
   port: number;