@brigadasos/nadeshiko-sdk 1.5.0-dev.996fd6f → 1.5.0-dev.9bfc5f7

package/dist/types.gen.d.ts

@@ -6,9 +6,9 @@ export type ClientOptions = {
  */
 export type MediaFilterItem = {
     /**
-     * Media ID to filter
+     * Media identifier (publicId or AniList external ID)
      */
-    mediaId: number;
+    mediaId: string;
     /**
      * Specific episodes (omit for all episodes)
      */
@@ -144,6 +144,10 @@ export type Segment = {
      * Unique identifier for the segment
      */
     uuid: string;
+    /**
+     * Public identifier for the segment (use this instead of uuid in public URLs)
+     */
+    publicId: string;
     /**
      * Position of the segment within the episode
      */
@@ -169,6 +173,10 @@ export type Segment = {
      * Media ID this segment belongs to
      */
     mediaId: number;
+    /**
+     * Public ID of the media this segment belongs to
+     */
+    mediaPublicId: string;
     textJa: {
         /**
          * Original Japanese content
@@ -250,6 +258,10 @@ export type Seiyuu = {
      * Internal seiyuu ID
      */
     id: number;
+    /**
+     * Public identifier for the seiyuu (use this in public URLs)
+     */
+    publicId: string;
     externalIds: ExternalId;
     /**
      * Japanese name of the voice actor
@@ -295,9 +307,13 @@ export type MediaCharacter = {
  */
 export type Media = {
     /**
-     * Unique identifier for the media
+     * Internal unique identifier for the media
      */
     id: number;
+    /**
+     * Public identifier for the media (use this in public URLs)
+     */
+    publicId: string;
     externalIds: ExternalId;
     /**
      * Original Japanese name of the media
@@ -390,7 +406,7 @@ export type SearchResponse = {
     segments: Array<Segment>;
     includes: {
         /**
-         * Media objects keyed by mediaId
+         * Media objects keyed by media publicId
          */
         media: {
             [key: string]: Media;
@@ -601,6 +617,10 @@ export type MediaSearchStats = {
      * Media identifier (look up full details in includes.media)
      */
     mediaId: number;
+    /**
+     * Public identifier for use in URLs and filters
+     */
+    publicId: string;
     /**
      * Number of matching segments found in this media
      */
@@ -627,7 +647,7 @@ export type SearchStatsResponse = {
     categories: Array<CategoryCount>;
     includes: {
         /**
-         * Media objects keyed by mediaId
+         * Media objects keyed by media publicId
          */
         media: {
             [key: string]: Media;
@@ -719,6 +739,20 @@ export type OpaqueCursorPagination = {
 export type MediaListResponse = {
     media: Array<Media>;
     pagination: OpaqueCursorPagination;
+    stats: {
+        /**
+         * Total number of media across all pages
+         */
+        totalMedia: number;
+        /**
+         * Total number of non-deleted segments
+         */
+        totalSegments: number;
+        /**
+         * Total number of episodes
+         */
+        totalEpisodes: number;
+    };
 };
 /**
  * Character data for creating/updating media
@@ -866,8 +900,65 @@ export type Error409 = {
         [key: string]: string;
     };
 };
+/**
+ * Slim media item returned by autocomplete (names + cover only)
+ */
+export type MediaAutocompleteItem = {
+    /**
+     * Unique identifier for the media
+     */
+    id: number;
+    /**
+     * Original Japanese name of the media
+     */
+    nameJa: string;
+    /**
+     * Romaji transliteration of the media name
+     */
+    nameRomaji: string;
+    /**
+     * English name of the media
+     */
+    nameEn: string;
+    /**
+     * Full URL to the cover image
+     */
+    coverUrl: string;
+    category: Category;
+};
 export type MediaAutocompleteResponse = {
-    media: Array<Media>;
+    media: Array<MediaAutocompleteItem>;
+};
+/**
+ * Segment with internal fields. For write operations (create, update) all fields are always populated.
+ * For GET, optional fields are only populated when requested via include[].
+ *
+ */
+export type SegmentInternal = Segment & {
+    /**
+     * Storage backend for segment assets
+     */
+    storage?: 'LOCAL' | 'R2';
+    /**
+     * Hash identifier for the segment
+     */
+    hashedId?: string;
+    /**
+     * Base path in the storage backend
+     */
+    storageBasePath?: string;
+    /**
+     * Raw WD Tagger v3 classifier output used to derive content rating
+     */
+    ratingAnalysis?: {
+        [key: string]: unknown;
+    };
+    /**
+     * POS tokenization results keyed by engine (sudachi, unidic)
+     */
+    posAnalysis?: {
+        [key: string]: unknown;
+    };
 };
 /**
  * Not Found error response
@@ -972,35 +1063,6 @@ export type SegmentUpdateRequest = {
      */
     hashedId?: string;
 };
-/**
- * Segment with internal fields (for internal API responses)
- */
-export type SegmentInternal = Segment & {
-    /**
-     * Storage backend for segment assets
-     */
-    storage: 'LOCAL' | 'R2';
-    /**
-     * Hash identifier for the segment
-     */
-    hashedId: string;
-    /**
-     * Base path in the storage backend
-     */
-    storageBasePath: string;
-    /**
-     * Raw WD Tagger v3 classifier output used to derive content rating
-     */
-    ratingAnalysis: {
-        [key: string]: unknown;
-    };
-    /**
-     * POS tokenization results keyed by engine (sudachi, unidic)
-     */
-    posAnalysis: {
-        [key: string]: unknown;
-    };
-};
 export type SegmentContextResponse = {
     segments: Array<Segment>;
     includes: {
@@ -1012,6 +1074,30 @@ export type SegmentContextResponse = {
         };
     };
 };
+export type SegmentRevision = {
+    /**
+     * Revision ID
+     */
+    id: number;
+    /**
+     * Sequential revision number per segment
+     */
+    revisionNumber: number;
+    /**
+     * Snapshot of editable fields at the time of the revision
+     */
+    snapshot: {
+        [key: string]: unknown;
+    };
+    /**
+     * Name of the user who made the change
+     */
+    userName?: string;
+    /**
+     * When the revision was created
+     */
+    createdAt: string;
+};
 /**
  * Ordered media series grouping
  */
@@ -1020,6 +1106,10 @@ export type Series = {
      * Series ID
      */
     id: number;
+    /**
+     * Public identifier for the series
+     */
+    publicId: string;
     /**
      * Japanese name of the series
      */
@@ -1076,6 +1166,10 @@ export type Character = {
      * Internal character ID
      */
     id: number;
+    /**
+     * Public identifier for the character (use this in public URLs)
+     */
+    publicId: string;
     externalIds: ExternalId;
     /**
      * Japanese name of the character
@@ -1397,6 +1491,9 @@ export type SegmentCreateRequest = {
      */
     hashedId: string;
 };
+export type SegmentBatchCreateRequest = {
+    segments: Array<SegmentCreateRequest>;
+};
 export type UserQuotaResponse = {
     /**
      * Number of API requests used in the current billing period.
@@ -1429,39 +1526,39 @@ export type ReportTargetMedia = {
      */
     type: 'MEDIA';
     /**
-     * Media ID this report targets
+     * Public ID of the media this report targets
      */
-    mediaId: number;
+    mediaId: string;
 };
-export type ReportTargetSegment = {
+export type ReportTargetSegmentInput = {
     /**
      * Report target type
      */
     type: 'SEGMENT';
     /**
-     * Media ID this report targets
+     * Public ID of the media this report targets
      */
-    mediaId: number;
+    mediaId: string;
     /**
      * Episode number containing the segment
      */
     episodeNumber?: number;
     /**
-     * Segment UUID this report targets
+     * Segment public ID or UUID
      */
-    segmentUuid: string;
+    segmentId: string;
 };
 export type UserReportTarget = ({
     type: 'MEDIA';
 } & ReportTargetMedia) | ({
     type: 'SEGMENT';
-} & ReportTargetSegment);
+} & ReportTargetSegmentInput);
 export type CreateReportRequest = {
     target: UserReportTarget;
     /**
      * Reason for the report
      */
-    reason: 'WRONG_TRANSLATION' | 'WRONG_TIMING' | 'WRONG_AUDIO' | 'NSFW_NOT_TAGGED' | 'DUPLICATE_SEGMENT' | 'WRONG_METADATA' | 'MISSING_EPISODES' | 'WRONG_COVER_IMAGE' | 'INAPPROPRIATE_CONTENT' | 'OTHER';
+    reason: 'WRONG_TRANSLATION' | 'WRONG_TIMING' | 'WRONG_AUDIO' | 'WRONG_JAPANESE_TEXT' | 'LOW_QUALITY_AUDIO' | 'NSFW_NOT_TAGGED' | 'DUPLICATE_SEGMENT' | 'WRONG_TITLE' | 'DUPLICATE_MEDIA' | 'WRONG_EPISODE_NUMBER' | 'IMAGE_ISSUE' | 'MISSING_EPISODES' | 'INAPPROPRIATE_CONTENT' | 'OTHER';
     /**
      * Optional description with additional details
      */
@@ -1473,14 +1570,32 @@ export type ReportTargetEpisode = {
      */
     type: 'EPISODE';
     /**
-     * Media ID this report targets
+     * Public ID of the media this report targets
      */
-    mediaId: number;
+    mediaId: string;
     /**
      * Episode number this report targets
      */
     episodeNumber: number;
 };
+export type ReportTargetSegment = {
+    /**
+     * Report target type
+     */
+    type: 'SEGMENT';
+    /**
+     * Public ID of the media this report targets
+     */
+    mediaId: string;
+    /**
+     * Episode number containing the segment
+     */
+    episodeNumber?: number;
+    /**
+     * Segment public ID or UUID
+     */
+    segmentId: string;
+};
 export type ReportTarget = ({
     type: 'MEDIA';
 } & ReportTargetMedia) | ({
@@ -1505,7 +1620,7 @@ export type Report = {
     /**
      * Reason for the report
      */
-    reason: 'WRONG_TRANSLATION' | 'WRONG_TIMING' | 'WRONG_AUDIO' | 'NSFW_NOT_TAGGED' | 'DUPLICATE_SEGMENT' | 'WRONG_METADATA' | 'MISSING_EPISODES' | 'WRONG_COVER_IMAGE' | 'INAPPROPRIATE_CONTENT' | 'OTHER' | 'LOW_SEGMENT_MEDIA' | 'EMPTY_EPISODES' | 'MISSING_EPISODES_AUTO' | 'BAD_SEGMENT_RATIO' | 'MEDIA_WITH_NO_EPISODES' | 'MISSING_TRANSLATIONS' | 'DB_ES_SYNC_ISSUES' | 'HIGH_REPORT_DENSITY';
+    reason: 'WRONG_TRANSLATION' | 'WRONG_TIMING' | 'WRONG_AUDIO' | 'WRONG_JAPANESE_TEXT' | 'LOW_QUALITY_AUDIO' | 'NSFW_NOT_TAGGED' | 'DUPLICATE_SEGMENT' | 'WRONG_METADATA' | 'MISSING_EPISODES' | 'WRONG_COVER_IMAGE' | 'WRONG_TITLE' | 'DUPLICATE_MEDIA' | 'WRONG_EPISODE_NUMBER' | 'IMAGE_ISSUE' | 'INAPPROPRIATE_CONTENT' | 'OTHER' | 'LOW_SEGMENT_MEDIA' | 'EMPTY_EPISODES' | 'MISSING_EPISODES_AUTO' | 'BAD_SEGMENT_RATIO' | 'MEDIA_WITH_NO_EPISODES' | 'MISSING_TRANSLATIONS' | 'DB_ES_SYNC_ISSUES' | 'HIGH_REPORT_DENSITY';
     /**
      * Optional description with additional details
      */
@@ -1584,17 +1699,26 @@ export type UserPreferences = {
 /**
  * Type of user activity
  */
-export type ActivityType = 'SEARCH' | 'ANKI_EXPORT' | 'SEGMENT_PLAY' | 'LIST_ADD_SEGMENT';
+export type ActivityType = 'SEARCH' | 'ANKI_EXPORT' | 'SEGMENT_PLAY' | 'SHARE';
 export type UserActivity = {
     id: number;
     activityType: ActivityType;
-    segmentUuid: string;
+    segmentId: number;
     mediaId: number;
     searchQuery: string;
     mediaName: string;
     japaneseText: string;
     createdAt: string;
 };
+/**
+ * Activity counts for a single day, broken down by type. Only types with at least 1 event are present.
+ */
+export type HeatmapDayCounts = {
+    SEARCH?: number;
+    SEGMENT_PLAY?: number;
+    ANKI_EXPORT?: number;
+    SHARE?: number;
+};
 /**
  * User segment collection
  */
@@ -1603,10 +1727,18 @@ export type Collection = {
      * Collection ID
      */
     id: number;
+    /**
+     * Public identifier for the collection
+     */
+    publicId: string;
     /**
      * Name of the collection
      */
     name: string;
+    /**
+     * Type of the collection
+     */
+    type: 'USER' | 'ANKI_EXPORT';
     /**
      * Visibility of the collection
      */
@@ -1626,9 +1758,9 @@ export type Collection = {
 };
 export type UserExportCollection = Collection & {
     /**
-     * Segment UUIDs in saved order
+     * Segment IDs in saved order
      */
-    segmentUuids: Array<string>;
+    segmentIds: Array<number>;
 };
 /**
  * User data export payload (identifier-oriented references)
@@ -2202,11 +2334,16 @@ export type GetSegmentByUuidData = {
     body?: never;
     path: {
         /**
-         * Segment UUID
+         * Segment UUID or publicId
          */
         uuid: string;
     };
-    query?: never;
+    query?: {
+        /**
+         * Additional internal fields to include in the response
+         */
+        include?: Array<'ratingAnalysis' | 'posAnalysis' | 'hashedId' | 'storageBasePath' | 'storage'>;
+    };
     url: '/v1/media/segments/{uuid}';
 };
 export type GetSegmentByUuidErrors = {
@@ -2215,7 +2352,7 @@ export type GetSegmentByUuidErrors = {
      */
     400: Error400;
     /**
-     * Unauthorized (API key)
+     * Unauthorized (API key or session)
      */
     401: Error401;
     /**
@@ -2238,16 +2375,16 @@ export type GetSegmentByUuidErrors = {
 export type GetSegmentByUuidError = GetSegmentByUuidErrors[keyof GetSegmentByUuidErrors];
 export type GetSegmentByUuidResponses = {
     /**
-     * OK
+     * Single segment response with internal fields
      */
-    200: Segment;
+    200: SegmentInternal;
 };
 export type GetSegmentByUuidResponse = GetSegmentByUuidResponses[keyof GetSegmentByUuidResponses];
 export type UpdateSegmentByUuidData = {
     body: SegmentUpdateRequest;
     path: {
         /**
-         * Segment UUID
+         * Segment UUID or publicId
          */
         uuid: string;
     };
@@ -2292,7 +2429,7 @@ export type GetSegmentContextData = {
     body?: never;
     path: {
         /**
-         * Segment UUID
+         * Segment UUID or publicId
          */
         uuid: string;
     };
@@ -2314,7 +2451,7 @@ export type GetSegmentContextErrors = {
      */
     400: Error400;
     /**
-     * Unauthorized (API key)
+     * Unauthorized (API key or session)
      */
     401: Error401;
     /**
@@ -2342,6 +2479,53 @@ export type GetSegmentContextResponses = {
     200: SegmentContextResponse;
 };
 export type GetSegmentContextResponse = GetSegmentContextResponses[keyof GetSegmentContextResponses];
+export type ListSegmentRevisionsData = {
+    body?: never;
+    path: {
+        /**
+         * Segment UUID or publicId
+         */
+        uuid: string;
+    };
+    query?: never;
+    url: '/v1/media/segments/{uuid}/revisions';
+};
+export type ListSegmentRevisionsErrors = {
+    /**
+     * Bad Request
+     */
+    400: Error400;
+    /**
+     * Unauthorized (API key or session)
+     */
+    401: Error401;
+    /**
+     * Forbidden
+     */
+    403: Error403;
+    /**
+     * Not Found
+     */
+    404: Error404;
+    /**
+     * Too Many Requests
+     */
+    429: Error429;
+    /**
+     * Internal Server Error
+     */
+    500: Error500;
+};
+export type ListSegmentRevisionsError = ListSegmentRevisionsErrors[keyof ListSegmentRevisionsErrors];
+export type ListSegmentRevisionsResponses = {
+    /**
+     * List of segment revisions
+     */
+    200: {
+        revisions: Array<SegmentRevision>;
+    };
+};
+export type ListSegmentRevisionsResponse = ListSegmentRevisionsResponses[keyof ListSegmentRevisionsResponses];
 export type ListSeriesData = {
     body?: never;
     path?: never;
@@ -2444,9 +2628,9 @@ export type DeleteSeriesData = {
     body?: never;
     path: {
         /**
-         * Series ID
+         * Series public ID
          */
-        id: number;
+        id: string;
     };
     query?: never;
     url: '/v1/media/series/{id}';
@@ -2489,9 +2673,9 @@ export type GetSeriesData = {
     body?: never;
     path: {
         /**
-         * Series ID
+         * Series public ID
          */
-        id: number;
+        id: string;
     };
     query?: {
         /**
@@ -2552,9 +2736,9 @@ export type UpdateSeriesData = {
     };
     path: {
         /**
-         * Series ID
+         * Series public ID
          */
-        id: number;
+        id: string;
     };
     query?: never;
     url: '/v1/media/series/{id}';
@@ -2596,9 +2780,9 @@ export type UpdateSeriesResponse = UpdateSeriesResponses[keyof UpdateSeriesRespo
 export type AddMediaToSeriesData = {
     body: {
         /**
-         * Media ID to add
+         * Media public ID to add
          */
-        mediaId: number;
+        mediaId: string;
         /**
          * Position in the series (1-indexed)
          */
@@ -2606,9 +2790,9 @@ export type AddMediaToSeriesData = {
     };
     path: {
         /**
-         * Series ID
+         * Series public ID
          */
-        id: number;
+        id: string;
     };
     query?: never;
     url: '/v1/media/series/{id}/media';
@@ -2651,13 +2835,13 @@ export type RemoveMediaFromSeriesData = {
     body?: never;
     path: {
         /**
-         * Series ID
+         * Series public ID
          */
-        id: number;
+        id: string;
         /**
-         * Media ID
+         * Media public ID
          */
-        mediaId: number;
+        mediaId: string;
     };
     query?: never;
     url: '/v1/media/series/{id}/media/{mediaId}';
@@ -2705,13 +2889,13 @@ export type UpdateSeriesMediaData = {
     };
     path: {
         /**
-         * Series ID
+         * Series public ID
          */
-        id: number;
+        id: string;
         /**
-         * Media ID
+         * Media public ID
          */
-        mediaId: number;
+        mediaId: string;
     };
     query?: never;
     url: '/v1/media/series/{id}/media/{mediaId}';
@@ -2754,7 +2938,7 @@ export type GetCharacterData = {
     body?: never;
     path: {
         /**
-         * Internal character ID
+         * Character ID
          */
         id: number;
     };
@@ -2844,9 +3028,9 @@ export type DeleteMediaData = {
     body?: never;
     path: {
         /**
-         * Media ID
+         * Media public ID
          */
-        id: number;
+        id: string;
     };
     query?: never;
     url: '/v1/media/{id}';
@@ -2889,9 +3073,9 @@ export type GetMediaData = {
     body?: never;
     path: {
         /**
-         * Media ID
+         * Media public ID
          */
-        id: number;
+        id: string;
     };
     query?: {
         /**
@@ -2939,9 +3123,9 @@ export type UpdateMediaData = {
     body: MediaUpdateRequest;
     path: {
         /**
-         * Media ID
+         * Media public ID
          */
-        id: number;
+        id: string;
     };
     query?: never;
     url: '/v1/media/{id}';
@@ -2984,9 +3168,9 @@ export type ListEpisodesData = {
     body?: never;
     path: {
         /**
-         * ID of the media
+         * Public ID of the media
          */
-        mediaId: number;
+        mediaId: string;
     };
     query?: {
         /**
@@ -3038,9 +3222,9 @@ export type CreateEpisodeData = {
     body: EpisodeCreateRequest;
     path: {
         /**
-         * ID of the media
+         * Public ID of the media
          */
-        mediaId: number;
+        mediaId: string;
     };
     query?: never;
     url: '/v1/media/{mediaId}/episodes';
@@ -3087,9 +3271,9 @@ export type DeleteEpisodeData = {
     body?: never;
     path: {
         /**
-         * ID of the media
+         * Public ID of the media
          */
-        mediaId: number;
+        mediaId: string;
         /**
          * Episode number
          */
@@ -3136,9 +3320,9 @@ export type GetEpisodeData = {
     body?: never;
     path: {
         /**
-         * ID of the media
+         * Public ID of the media
          */
-        mediaId: number;
+        mediaId: string;
         /**
          * Episode number
          */
@@ -3185,9 +3369,9 @@ export type UpdateEpisodeData = {
     body: EpisodeUpdateRequest;
     path: {
         /**
-         * ID of the media
+         * Public ID of the media
          */
-        mediaId: number;
+        mediaId: string;
         /**
          * Episode number
          */
@@ -3234,9 +3418,9 @@ export type ListSegmentsData = {
     body?: never;
     path: {
         /**
-         * ID of the media
+         * Public ID of the media
          */
-        mediaId: number;
+        mediaId: string;
         /**
          * Episode number
          */
@@ -3298,9 +3482,9 @@ export type CreateSegmentData = {
     body: SegmentCreateRequest;
     path: {
         /**
-         * ID of the media
+         * Public ID of the media
          */
-        mediaId: number;
+        mediaId: string;
         /**
          * Episode number
          */
@@ -3347,13 +3531,71 @@ export type CreateSegmentResponses = {
     201: SegmentInternal;
 };
 export type CreateSegmentResponse = CreateSegmentResponses[keyof CreateSegmentResponses];
+export type CreateSegmentsBatchData = {
+    body: SegmentBatchCreateRequest;
+    path: {
+        /**
+         * Public ID of the media
+         */
+        mediaId: string;
+        /**
+         * Episode number
+         */
+        episodeNumber: number;
+    };
+    query?: never;
+    url: '/v1/media/{mediaId}/episodes/{episodeNumber}/segments/batch';
+};
+export type CreateSegmentsBatchErrors = {
+    /**
+     * Bad Request
+     */
+    400: Error400;
+    /**
+     * Unauthorized (API key)
+     */
+    401: Error401;
+    /**
+     * Forbidden
+     */
+    403: Error403;
+    /**
+     * Not Found
+     */
+    404: Error404;
+    /**
+     * Too Many Requests
+     */
+    429: Error429;
+    /**
+     * Internal Server Error
+     */
+    500: Error500;
+};
+export type CreateSegmentsBatchError = CreateSegmentsBatchErrors[keyof CreateSegmentsBatchErrors];
+export type CreateSegmentsBatchResponses = {
+    /**
+     * Batch segment creation result
+     */
+    201: {
+        /**
+         * Number of segments successfully created
+         */
+        created: number;
+        /**
+         * Number of segments skipped due to duplicate UUIDs
+         */
+        skipped: number;
+    };
+};
+export type CreateSegmentsBatchResponse = CreateSegmentsBatchResponses[keyof CreateSegmentsBatchResponses];
 export type DeleteSegmentData = {
     body?: never;
     path: {
         /**
-         * ID of the media
+         * Public ID of the media
          */
-        mediaId: number;
+        mediaId: string;
         /**
          * Episode number
          */
@@ -3404,9 +3646,9 @@ export type GetSegmentData = {
     body?: never;
     path: {
         /**
-         * ID of the media
+         * Public ID of the media
          */
-        mediaId: number;
+        mediaId: string;
         /**
          * Episode number
          */
@@ -3457,9 +3699,9 @@ export type UpdateSegmentData = {
     body: SegmentUpdateRequest;
     path: {
         /**
-         * ID of the media
+         * Public ID of the media
          */
-        mediaId: number;
+        mediaId: string;
         /**
          * Episode number
          */
@@ -3695,8 +3937,8 @@ export type ListUserActivityResponses = {
 export type ListUserActivityResponse = ListUserActivityResponses[keyof ListUserActivityResponses];
 export type TrackUserActivityData = {
     body: {
-        activityType: 'SEGMENT_PLAY';
-        segmentUuid?: string;
+        activityType: 'SEGMENT_PLAY' | 'SHARE';
+        segmentId?: number;
         mediaId?: number;
         mediaName?: string;
         japaneseText?: string;
@@ -3735,10 +3977,6 @@ export type GetUserActivityHeatmapData = {
          * Number of days to include in the heatmap
          */
         days?: number;
-        /**
-         * Filter by activity type
-         */
-        activityType?: ActivityType;
     };
     url: '/v1/user/activity/heatmap';
 };
@@ -3759,10 +3997,10 @@ export type GetUserActivityHeatmapResponses = {
      */
     200: {
         /**
-         * Map of YYYY-MM-DD date strings to activity activityByDay
+         * Map of YYYY-MM-DD date strings to per-type activity counts
          */
         activityByDay: {
-            [key: string]: number;
+            [key: string]: HeatmapDayCounts;
         };
     };
 };
@@ -3798,6 +4036,7 @@ export type GetUserActivityStatsResponses = {
         totalExports: number;
         totalPlays: number;
         totalListAdds: number;
+        totalShares: number;
         topMedia: Array<{
             mediaId: number;
             count: number;
@@ -4072,9 +4311,9 @@ export type DeleteCollectionData = {
     body?: never;
     path: {
         /**
-         * Collection ID
+         * Collection public ID
          */
-        id: number;
+        id: string;
     };
     query?: never;
     url: '/v1/collections/{id}';
@@ -4117,9 +4356,9 @@ export type GetCollectionData = {
     body?: never;
     path: {
         /**
-         * Collection ID
+         * Collection public ID
          */
-        id: number;
+        id: string;
     };
     query?: {
         /**
@@ -4174,9 +4413,9 @@ export type UpdateCollectionData = {
     };
     path: {
         /**
-         * Collection ID
+         * Collection public ID
          */
-        id: number;
+        id: string;
     };
     query?: never;
     url: '/v1/collections/{id}';
@@ -4218,9 +4457,9 @@ export type UpdateCollectionResponse = UpdateCollectionResponses[keyof UpdateCol
 export type AddSegmentToCollectionData = {
     body: {
         /**
-         * UUID of the segment to add
+         * Public ID or UUID of the segment to add
          */
-        segmentUuid: string;
+        segmentId: string;
         /**
          * Optional annotation
          */
@@ -4228,9 +4467,9 @@ export type AddSegmentToCollectionData = {
     };
     path: {
         /**
-         * Collection ID
+         * Collection public ID
          */
-        id: number;
+        id: string;
     };
     query?: never;
     url: '/v1/collections/{id}/segments';
@@ -4273,16 +4512,16 @@ export type RemoveSegmentFromCollectionData = {
     body?: never;
     path: {
         /**
-         * Collection ID
+         * Collection public ID
          */
-        id: number;
+        id: string;
         /**
-         * Segment UUID
+         * Segment ID
          */
-        uuid: string;
+        segmentId: number;
     };
     query?: never;
-    url: '/v1/collections/{id}/segments/{uuid}';
+    url: '/v1/collections/{id}/segments/{segmentId}';
 };
 export type RemoveSegmentFromCollectionErrors = {
     /**
@@ -4331,16 +4570,16 @@ export type UpdateCollectionSegmentData = {
     };
     path: {
         /**
-         * Collection ID
+         * Collection public ID
          */
-        id: number;
+        id: string;
         /**
-         * Segment UUID
+         * Segment ID
          */
-        uuid: string;
+        segmentId: number;
     };
     query?: never;
-    url: '/v1/collections/{id}/segments/{uuid}';
+    url: '/v1/collections/{id}/segments/{segmentId}';
 };
 export type UpdateCollectionSegmentErrors = {
     /**
@@ -4380,9 +4619,9 @@ export type SearchCollectionSegmentsData = {
     body?: never;
     path: {
         /**
-         * Collection ID
+         * Collection public ID
          */
-        id: number;
+        id: string;
     };
     query?: {
         /**
@@ -4434,9 +4673,9 @@ export type GetCollectionStatsData = {
     body?: never;
     path: {
         /**
-         * Collection ID
+         * Collection public ID
          */
-        id: number;
+        id: string;
     };
     query?: never;
     url: '/v1/collections/{id}/stats';
@@ -4483,7 +4722,7 @@ export type GetAdminDashboardData = {
 };
 export type GetAdminDashboardErrors = {
     /**
-     * Unauthorized (API key)
+     * Unauthorized (session)
      */
     401: Error401;
     /**
@@ -4575,7 +4814,7 @@ export type GetAdminHealthData = {
 };
 export type GetAdminHealthErrors = {
     /**
-     * Unauthorized (API key)
+     * Unauthorized (session)
      */
     401: Error401;
     /**
@@ -4637,7 +4876,7 @@ export type TriggerReindexErrors = {
      */
     400: Error400;
     /**
-     * Unauthorized (API key)
+     * Unauthorized (session)
      */
     401: Error401;
     /**
@@ -4673,7 +4912,7 @@ export type ListAdminQueueStatsErrors = {
      */
     400: Error400;
     /**
-     * Unauthorized (API key)
+     * Unauthorized (session)
      */
     401: Error401;
     /**
@@ -4724,7 +4963,7 @@ export type GetAdminQueueErrors = {
      */
     400: Error400;
     /**
-     * Unauthorized (API key)
+     * Unauthorized (session)
      */
     401: Error401;
     /**
@@ -4809,7 +5048,7 @@ export type ListAdminQueueFailedErrors = {
      */
     400: Error400;
     /**
-     * Unauthorized (API key)
+     * Unauthorized (session)
      */
     401: Error401;
     /**
@@ -4867,7 +5106,7 @@ export type RetryAdminQueueFailedErrors = {
      */
     400: Error400;
     /**
-     * Unauthorized (API key)
+     * Unauthorized (session)
      */
     401: Error401;
     /**
@@ -4915,7 +5154,7 @@ export type PurgeAdminQueueFailedErrors = {
      */
     400: Error400;
     /**
-     * Unauthorized (API key)
+     * Unauthorized (session)
      */
     401: Error401;
     /**
@@ -4953,10 +5192,6 @@ export type ClearAdminImpersonationData = {
     url: '/v1/admin/impersonation';
 };
 export type ClearAdminImpersonationErrors = {
-    /**
-     * Unauthorized (session)
-     */
-    401: Error401;
     /**
      * Forbidden
      */
@@ -4996,10 +5231,6 @@ export type ImpersonateAdminUserErrors = {
      * Bad Request
      */
     400: Error400;
-    /**
-     * Unauthorized (session)
-     */
-    401: Error401;
     /**
      * Forbidden
      */
@@ -5065,9 +5296,9 @@ export type ListAdminReportsData = {
          */
         'target.episodeNumber'?: number;
         /**
-         * Filter by target segment UUID
+         * Filter by target segment ID
          */
-        'target.segmentUuid'?: string;
+        'target.segmentId'?: number;
         /**
          * Filter by audit run ID
          */
@@ -5077,7 +5308,7 @@ export type ListAdminReportsData = {
 };
 export type ListAdminReportsErrors = {
     /**
-     * Unauthorized (API key)
+     * Unauthorized (session)
      */
     401: Error401;
     /**
@@ -5118,7 +5349,7 @@ export type UpdateAdminReportErrors = {
      */
     400: Error400;
     /**
-     * Unauthorized (API key)
+     * Unauthorized (session)
      */
     401: Error401;
     /**
@@ -5154,7 +5385,7 @@ export type ListAdminMediaAuditsData = {
 };
 export type ListAdminMediaAuditsErrors = {
     /**
-     * Unauthorized (API key)
+     * Unauthorized (session)
      */
     401: Error401;
     /**
@@ -5206,7 +5437,7 @@ export type UpdateAdminMediaAuditErrors = {
      */
     400: Error400;
     /**
-     * Unauthorized (API key)
+     * Unauthorized (session)
      */
     401: Error401;
     /**
@@ -5252,7 +5483,7 @@ export type RunAdminMediaAuditData = {
 };
 export type RunAdminMediaAuditErrors = {
     /**
-     * Unauthorized (API key)
+     * Unauthorized (session)
      */
     401: Error401;
     /**
@@ -5301,7 +5532,7 @@ export type ListAdminMediaAuditRunsData = {
 };
 export type ListAdminMediaAuditRunsErrors = {
     /**
-     * Unauthorized (API key)
+     * Unauthorized (session)
      */
     401: Error401;
     /**
@@ -5341,7 +5572,7 @@ export type GetAdminMediaAuditRunData = {
 };
 export type GetAdminMediaAuditRunErrors = {
     /**
-     * Unauthorized (API key)
+     * Unauthorized (session)
      */
     401: Error401;
     /**
@@ -5372,4 +5603,80 @@ export type GetAdminMediaAuditRunResponses = {
     };
 };
 export type GetAdminMediaAuditRunResponse = GetAdminMediaAuditRunResponses[keyof GetAdminMediaAuditRunResponses];
+export type GetAnnouncementData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: '/v1/admin/announcement';
+};
+export type GetAnnouncementErrors = {
+    /**
+     * Too Many Requests
+     */
+    429: Error429;
+    /**
+     * Internal Server Error
+     */
+    500: Error500;
+};
+export type GetAnnouncementError = GetAnnouncementErrors[keyof GetAnnouncementErrors];
+export type GetAnnouncementResponses = {
+    /**
+     * OK
+     */
+    200: {
+        message: string;
+        type: 'info' | 'warning' | 'maintenance';
+        active: boolean;
+    };
+    /**
+     * No announcement set
+     */
+    204: void;
+};
+export type GetAnnouncementResponse = GetAnnouncementResponses[keyof GetAnnouncementResponses];
+export type UpdateAnnouncementData = {
+    body: {
+        message: string;
+        type: 'info' | 'warning' | 'maintenance';
+        active: boolean;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/admin/announcement';
+};
+export type UpdateAnnouncementErrors = {
+    /**
+     * Bad Request
+     */
+    400: Error400;
+    /**
+     * Unauthorized (session)
+     */
+    401: Error401;
+    /**
+     * Forbidden
+     */
+    403: Error403;
+    /**
+     * Too Many Requests
+     */
+    429: Error429;
+    /**
+     * Internal Server Error
+     */
+    500: Error500;
+};
+export type UpdateAnnouncementError = UpdateAnnouncementErrors[keyof UpdateAnnouncementErrors];
+export type UpdateAnnouncementResponses = {
+    /**
+     * Announcement updated
+     */
+    200: {
+        message: string;
+        type: 'info' | 'warning' | 'maintenance';
+        active: boolean;
+    };
+};
+export type UpdateAnnouncementResponse = UpdateAnnouncementResponses[keyof UpdateAnnouncementResponses];
 //# sourceMappingURL=types.gen.d.ts.map