feat(genres): allow custom track genres (#14424)

Fresh branch off main — supersedes #14419.

## Summary
- Discovery indexer no longer rejects tracks whose genre isn't in the
hardcoded allowlist; just caps at 100 chars. The allowlist is retained
as a canonical reference for read-side trending/metrics scoping.
- SDK upload schemas for tracks, albums, and playlists changed from
`z.enum(Genre)` to `z.string().min(1).max(100)`. SDK regenerated from
updated swagger (generated `Genre` enum dropped). Manual `Genre` enum is
now the canonical export from `@audius/sdk` with PascalCase keys, plus a
new `GenreString = Genre | string` helper type.
- Web `SelectGenreField` rewritten from `<SelectField>` to `<TextField>`
+ native `<datalist>` — users can pick a known genre via autocomplete or
type a custom one. `maxLength=100` gives the built-in harmony character
counter.

Pairs with [AudiusProject/api
genres/custom](https://github.com/AudiusProject/api) — the Go API must
ship first (or together) so it stops rejecting custom-genre POSTs before
this indexer relaxation lands.

## What we deliberately did NOT change
- `index_trending.py` and `get_genre_metrics.py` still scope to
`genre_allowlist`. Custom-genre tracks silently won't appear in trending
or genre-metrics endpoints — intentional MVP cut.
- `packages/mobile` has its own genre picker that wasn't touched —
follow-up PR needed.
- No write-side normalization. "Hip-Hop" / "Hip Hop" / "hip hop" become
three distinct genres.

## Breaking change (browser dist only)
`packages/sdk/src/sdk/types/Genre.ts` keys changed from SCREAMING_SNAKE
to PascalCase to match the previously-generated enum that downstream
consumers all imported. External integrations referencing
`window.audiusSdk.Genre.HIP_HOP_RAP` etc. via the browser dist need to
update to `Genre.HipHopRap`.

## Test plan
- [x] `tsc --noEmit` in `packages/sdk` — clean
- [x] `vitest run` in `packages/sdk` — 17 files, 196 passed, 2 skipped
- [x] SDK regenerated via `node ./src/sdk/api/generator/gen.js --spec
<local-edited-swagger>` against the updated swagger
- [ ] Type a custom genre in the upload form, confirm it submits
- [ ] Existing known-genre flows still work
- [ ] Verify >100-char input is rejected client and server side
- [ ] Confirm no regression in trending/browse-by-genre for canonical
genres

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: dylanjeffers

packages/discovery-provider/src/tasks/entity_manager/entities/track.py

@@ -28,6 +28,7 @@
 from src.models.users.user import User
 from src.tasks.entity_manager.utils import (
     CHARACTER_LIMIT_DESCRIPTION,
+    CHARACTER_LIMIT_GENRE,
     TRACK_ID_OFFSET,
     Action,
     EntityType,
@@ -45,7 +46,6 @@
 )
 from src.tasks.task_helpers import generate_slug_and_collision_id
 from src.utils import helpers
-from src.utils.hardcoded_data import genre_allowlist
 from src.utils.structured_logger import StructuredLogger
 
 logger = StructuredLogger(__name__)
@@ -534,9 +534,9 @@ def validate_track_tx(params: ManageEntityParameters):
             )
         track_bio = params.metadata.get("description")
         track_genre = params.metadata.get("genre")
-        if track_genre is not None and track_genre not in genre_allowlist:
+        if track_genre is not None and len(track_genre) > CHARACTER_LIMIT_GENRE:
             raise IndexingValidationError(
-                f"Track {track_id} attempted to be placed in genre '{track_genre}' which is not in the allow list"
+                f"Track {track_id} genre exceeds character limit {CHARACTER_LIMIT_GENRE}"
             )
         if track_bio is not None and len(track_bio) > CHARACTER_LIMIT_DESCRIPTION:
             raise IndexingValidationError(

packages/discovery-provider/src/tasks/entity_manager/utils.py

@@ -67,6 +67,7 @@
 # limits
 CHARACTER_LIMIT_USER_BIO = 256
 CHARACTER_LIMIT_DESCRIPTION = 2500
+CHARACTER_LIMIT_GENRE = 100
 PLAYLIST_TRACK_LIMIT = 5000
 COMMENT_BODY_LIMIT = 400
 

packages/discovery-provider/src/utils/hardcoded_data.py

@@ -96,6 +96,10 @@ def has_badwords(s: str) -> bool:
     return any(badword in f for badword in handle_badwords_lower)
 
 
+# Known/canonical genres. No longer enforced as an allowlist at write time —
+# track genres can be arbitrary strings (capped at CHARACTER_LIMIT_GENRE).
+# Still used by trending (index_trending.py) and genre metrics
+# (get_genre_metrics.py) to scope read-side aggregations to canonical values.
 genre_allowlist = {
     "Acoustic",
     "Alternative",

packages/sdk/src/sdk/api/albums/AlbumsApi.test.ts

@@ -20,7 +20,8 @@ import {
 import { SolanaClient } from '../../services/Solana/programs/SolanaClient'
 import { Storage } from '../../services/Storage'
 import { StorageNodeSelector } from '../../services/StorageNodeSelector'
-import { Configuration, Genre, Mood } from '../generated/default'
+import { Genre } from '../../types/Genre'
+import { Configuration, Mood } from '../generated/default'
 import { PlaylistsApi as GeneratedPlaylistsApi } from '../generated/default/apis/PlaylistsApi'
 import type { PlaylistResponse } from '../generated/default/models/PlaylistResponse'
 import { TrackUploadHelper } from '../tracks/TrackUploadHelper'

packages/sdk/src/sdk/api/albums/types.ts

@@ -14,7 +14,7 @@ import { PublicKeySchema } from '../../services/Solana'
 import { DDEXResourceContributor, DDEXCopyright } from '../../types/DDEX'
 import { AudioFile, ImageFile } from '../../types/File'
 import { HashId } from '../../types/HashId'
-import { Mood, Genre } from '../generated/default'
+import { Mood } from '../generated/default'
 import type {
   CreatePlaylistRequestBody,
   UpdatePlaylistRequestBody
@@ -159,7 +159,7 @@ export const CreateAlbumSchema = z
 export type EntityManagerCreateAlbumRequest = z.input<typeof CreateAlbumSchema>
 
 export const UploadAlbumMetadataSchema = CreateAlbumMetadataSchema.extend({
-  genre: z.enum(Object.values(Genre) as [Genre, ...Genre[]]),
+  genre: z.string().min(1).max(100),
   mood: z.optional(z.enum(Object.values(Mood) as [Mood, ...Mood[]])),
   tags: z.optional(z.string())
 })

packages/sdk/src/sdk/api/generated/default/.openapi-generator/FILES

@@ -191,7 +191,6 @@ models/FollowNotificationAction.ts
 models/FollowNotificationActionData.ts
 models/FollowersResponse.ts
 models/FollowingResponse.ts
-models/Genre.ts
 models/GetChallenges.ts
 models/GetSupportedUsers.ts
 models/GetSupporter.ts

packages/sdk/src/sdk/api/generated/default/models/CreatePlaylistRequestBody.ts

@@ -37,12 +37,6 @@ import {
     DdexResourceContributorFromJSONTyped,
     DdexResourceContributorToJSON,
 } from './DdexResourceContributor';
-import type { Genre } from './Genre';
-import {
-    GenreFromJSON,
-    GenreFromJSONTyped,
-    GenreToJSON,
-} from './Genre';
 import type { Mood } from './Mood';
 import {
     MoodFromJSON,
@@ -93,11 +87,20 @@ export interface CreatePlaylistRequestBody {
      */
     isAlbum?: boolean;
     /**
+     * Music genre. Any string up to 100 characters is accepted. Known/canonical
+     * values (shown as autocomplete suggestions in clients): Electronic, Rock,
+     * Metal, Alternative, Hip-Hop/Rap, Experimental, Punk, Folk, Pop, Ambient,
+     * Soundtrack, World, Jazz, Acoustic, Funk, R&B/Soul, Devotional, Classical,
+     * Reggae, Podcasts, Country, Spoken Word, Comedy, Blues, Kids, Audiobooks,
+     * Latin, Lo-Fi, Hyperpop, Dancehall, Techno, Trap, House, Tech House,
+     * Deep House, Disco, Electro, Jungle, Progressive House, Hardstyle,
+     * Glitch Hop, Trance, Future Bass, Future House, Tropical House, Downtempo,
+     * Drum & Bass, Dubstep, Jersey Club, Vaporwave, Moombahton.
      * 
-     * @type {Genre}
+     * @type {string}
      * @memberof CreatePlaylistRequestBody
      */
-    genre?: Genre;
+    genre?: string;
     /**
      * 
      * @type {Mood}
@@ -227,7 +230,7 @@ export function CreatePlaylistRequestBodyFromJSONTyped(json: any, ignoreDiscrimi
         'description': !exists(json, 'description') ? undefined : json['description'],
         'isPrivate': !exists(json, 'is_private') ? undefined : json['is_private'],
         'isAlbum': !exists(json, 'is_album') ? undefined : json['is_album'],
-        'genre': !exists(json, 'genre') ? undefined : GenreFromJSON(json['genre']),
+        'genre': !exists(json, 'genre') ? undefined : json['genre'],
         'mood': !exists(json, 'mood') ? undefined : MoodFromJSON(json['mood']),
         'tags': !exists(json, 'tags') ? undefined : json['tags'],
         'license': !exists(json, 'license') ? undefined : json['license'],
@@ -262,7 +265,7 @@ export function CreatePlaylistRequestBodyToJSON(value?: CreatePlaylistRequestBod
         'description': value.description,
         'is_private': value.isPrivate,
         'is_album': value.isAlbum,
-        'genre': GenreToJSON(value.genre),
+        'genre': value.genre,
         'mood': MoodToJSON(value.mood),
         'tags': value.tags,
         'license': value.license,

packages/sdk/src/sdk/api/generated/default/models/CreateTrackRequestBody.ts

@@ -49,12 +49,6 @@ import {
     FieldVisibilityFromJSONTyped,
     FieldVisibilityToJSON,
 } from './FieldVisibility';
-import type { Genre } from './Genre';
-import {
-    GenreFromJSON,
-    GenreFromJSONTyped,
-    GenreToJSON,
-} from './Genre';
 import type { Mood } from './Mood';
 import {
     MoodFromJSON,
@@ -93,11 +87,20 @@ export interface CreateTrackRequestBody {
      */
     title: string;
     /**
+     * Music genre. Any string up to 100 characters is accepted. Known/canonical
+     * values (shown as autocomplete suggestions in clients): Electronic, Rock,
+     * Metal, Alternative, Hip-Hop/Rap, Experimental, Punk, Folk, Pop, Ambient,
+     * Soundtrack, World, Jazz, Acoustic, Funk, R&B/Soul, Devotional, Classical,
+     * Reggae, Podcasts, Country, Spoken Word, Comedy, Blues, Kids, Audiobooks,
+     * Latin, Lo-Fi, Hyperpop, Dancehall, Techno, Trap, House, Tech House,
+     * Deep House, Disco, Electro, Jungle, Progressive House, Hardstyle,
+     * Glitch Hop, Trance, Future Bass, Future House, Tropical House, Downtempo,
+     * Drum & Bass, Dubstep, Jersey Club, Vaporwave, Moombahton.
      * 
-     * @type {Genre}
+     * @type {string}
      * @memberof CreateTrackRequestBody
      */
-    genre: Genre;
+    genre: string;
     /**
      * Track description
      * @type {string}
@@ -370,7 +373,7 @@ export function CreateTrackRequestBodyFromJSONTyped(json: any, ignoreDiscriminat
 
         'trackId': !exists(json, 'track_id') ? undefined : json['track_id'],
         'title': json['title'],
-        'genre': GenreFromJSON(json['genre']),
+        'genre': json['genre'],
         'description': !exists(json, 'description') ? undefined : json['description'],
         'mood': !exists(json, 'mood') ? undefined : MoodFromJSON(json['mood']),
         'bpm': !exists(json, 'bpm') ? undefined : json['bpm'],
@@ -426,7 +429,7 @@ export function CreateTrackRequestBodyToJSON(value?: CreateTrackRequestBody | nu
 
         'track_id': value.trackId,
         'title': value.title,
-        'genre': GenreToJSON(value.genre),
+        'genre': value.genre,
         'description': value.description,
         'mood': MoodToJSON(value.mood),
         'bpm': value.bpm,

packages/sdk/src/sdk/api/generated/default/models/Genre.ts

@@ -37,12 +37,6 @@ import {
     DdexResourceContributorFromJSONTyped,
     DdexResourceContributorToJSON,
 } from './DdexResourceContributor';
-import type { Genre } from './Genre';
-import {
-    GenreFromJSON,
-    GenreFromJSONTyped,
-    GenreToJSON,
-} from './Genre';
 import type { Mood } from './Mood';
 import {
     MoodFromJSON,
@@ -87,11 +81,20 @@ export interface UpdatePlaylistRequestBody {
      */
     isAlbum?: boolean;
     /**
+     * Music genre. Any string up to 100 characters is accepted. Known/canonical
+     * values (shown as autocomplete suggestions in clients): Electronic, Rock,
+     * Metal, Alternative, Hip-Hop/Rap, Experimental, Punk, Folk, Pop, Ambient,
+     * Soundtrack, World, Jazz, Acoustic, Funk, R&B/Soul, Devotional, Classical,
+     * Reggae, Podcasts, Country, Spoken Word, Comedy, Blues, Kids, Audiobooks,
+     * Latin, Lo-Fi, Hyperpop, Dancehall, Techno, Trap, House, Tech House,
+     * Deep House, Disco, Electro, Jungle, Progressive House, Hardstyle,
+     * Glitch Hop, Trance, Future Bass, Future House, Tropical House, Downtempo,
+     * Drum & Bass, Dubstep, Jersey Club, Vaporwave, Moombahton.
      * 
-     * @type {Genre}
+     * @type {string}
      * @memberof UpdatePlaylistRequestBody
      */
-    genre?: Genre;
+    genre?: string;
     /**
      * 
      * @type {Mood}
@@ -219,7 +222,7 @@ export function UpdatePlaylistRequestBodyFromJSONTyped(json: any, ignoreDiscrimi
         'description': !exists(json, 'description') ? undefined : json['description'],
         'isPrivate': !exists(json, 'is_private') ? undefined : json['is_private'],
         'isAlbum': !exists(json, 'is_album') ? undefined : json['is_album'],
-        'genre': !exists(json, 'genre') ? undefined : GenreFromJSON(json['genre']),
+        'genre': !exists(json, 'genre') ? undefined : json['genre'],
         'mood': !exists(json, 'mood') ? undefined : MoodFromJSON(json['mood']),
         'tags': !exists(json, 'tags') ? undefined : json['tags'],
         'license': !exists(json, 'license') ? undefined : json['license'],
@@ -253,7 +256,7 @@ export function UpdatePlaylistRequestBodyToJSON(value?: UpdatePlaylistRequestBod
         'description': value.description,
         'is_private': value.isPrivate,
         'is_album': value.isAlbum,
-        'genre': GenreToJSON(value.genre),
+        'genre': value.genre,
         'mood': MoodToJSON(value.mood),
         'tags': value.tags,
         'license': value.license,