@freqhole/api-client 0.3.1 → 0.3.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@freqhole/api-client",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "type": "module",
   "repository": {
     "type": "git",

package/src/codegen/routes.ts

@@ -261,6 +261,7 @@ export const routes = {
     query_video_series: { method: 'POST', path: '/api/video/series/query', req: s.QueryParamsSchema, resp: s.SeriesQueryResultSchema, auth: { type: 'authenticated' } as const },
     query_videos: { method: 'POST', path: '/api/video/videos/query', req: s.QueryVideosRequestSchema, resp: s.VideosQueryResultSchema, auth: { type: 'authenticated' } as const },
     recently_added_videos: { method: 'POST', path: '/api/video/relations/recently-added-videos', req: s.RecentlyAddedVideosRequestSchema, resp: s.RecentlyAddedVideosResponseSchema, auth: { type: 'authenticated' } as const },
+    reprocess_video: { method: 'POST', path: '/api/video/videos/reprocess', req: s.ReprocessVideoRequestSchema, resp: s.ReprocessVideoResultSchema, auth: { type: 'role', role: 'admin' } as const },
     sync_video_by_blake3: { method: 'POST', path: '/api/sync/video-by-blake3', req: s.SyncVideoByBlake3RequestSchema, resp: s.SyncVideoByBlake3ResponseSchema, auth: { type: 'role', role: 'member' } as const },
     unassigned_videos: { method: 'POST', path: '/api/video/relations/unassigned-videos', req: s.UnassignedVideosRequestSchema, resp: s.UnassignedVideosResponseSchema, auth: { type: 'authenticated' } as const },
     update_video_season: { method: 'POST', path: '/api/video/seasons/update', req: s.UpdateVideoSeasonRequestSchema, resp: s.VideoSeasonSchema, auth: { type: 'role', role: 'admin' } as const },

package/src/codegen/schema.ts

@@ -2340,6 +2340,8 @@ export const FavoriteItemSchema = z.union([z.intersection(z.object({
   title: z.string(),
   description: z.string().nullish(),
   is_public: z.number(),
+  collaborative: z.number(),
+  private: z.number(),
   images: z.array(z.object({
   blob_id: z.string(),
   is_primary: z.number(),
@@ -2357,6 +2359,7 @@ export const FavoriteItemSchema = z.union([z.intersection(z.object({
   deleted_by: z.string().nullish(),
   created_by: z.string().nullish(),
   updated_by: z.string().nullish(),
+  created_by_username: z.string().nullish(),
   song_count: z.number()
 }),
   song_count: z.number(),
@@ -2420,6 +2423,8 @@ export const FavoritePlaylistResultSchema = z.object({
   title: z.string(),
   description: z.string().nullish(),
   is_public: z.number(),
+  collaborative: z.number(),
+  private: z.number(),
   images: z.array(z.object({
   blob_id: z.string(),
   is_primary: z.number(),
@@ -2437,6 +2442,7 @@ export const FavoritePlaylistResultSchema = z.object({
   deleted_by: z.string().nullish(),
   created_by: z.string().nullish(),
   updated_by: z.string().nullish(),
+  created_by_username: z.string().nullish(),
   song_count: z.number()
 }),
   song_count: z.number(),
@@ -3246,6 +3252,11 @@ export const JobStateSnapshotSchema = z.object({
   created_by: z.string().nullish(),
   last_stage: z.string().nullish(),
   last_message: z.string().nullish(),
+  errors: z.array(z.object({
+  error_type: z.string(),
+  title: z.string(),
+  detail: z.string()
+})).nullish(),
   updated_at: z.number()
 });
 export type JobStateSnapshot = z.infer<typeof JobStateSnapshotSchema>;
@@ -3625,6 +3636,8 @@ export const ListFavoritesResponseSchema = z.object({
   title: z.string(),
   description: z.string().nullish(),
   is_public: z.number(),
+  collaborative: z.number(),
+  private: z.number(),
   images: z.array(z.object({
   blob_id: z.string(),
   is_primary: z.number(),
@@ -3642,6 +3655,7 @@ export const ListFavoritesResponseSchema = z.object({
   deleted_by: z.string().nullish(),
   created_by: z.string().nullish(),
   updated_by: z.string().nullish(),
+  created_by_username: z.string().nullish(),
   song_count: z.number()
 }),
   song_count: z.number(),
@@ -4623,6 +4637,8 @@ export const PlaylistSchema = z.object({
   title: z.string(),
   description: z.string().nullish(),
   is_public: z.number(),
+  collaborative: z.number(),
+  private: z.number(),
   images: z.array(z.object({
   blob_id: z.string(),
   is_primary: z.number(),
@@ -4640,6 +4656,7 @@ export const PlaylistSchema = z.object({
   deleted_by: z.string().nullish(),
   created_by: z.string().nullish(),
   updated_by: z.string().nullish(),
+  created_by_username: z.string().nullish(),
   song_count: z.number()
 });
 export type Playlist = z.infer<typeof PlaylistSchema>;
@@ -4667,6 +4684,8 @@ export const PlaylistQueryResultSchema = z.object({
   title: z.string(),
   description: z.string().nullish(),
   is_public: z.number(),
+  collaborative: z.number(),
+  private: z.number(),
   images: z.array(z.object({
   blob_id: z.string(),
   is_primary: z.number(),
@@ -4684,6 +4703,7 @@ export const PlaylistQueryResultSchema = z.object({
   deleted_by: z.string().nullish(),
   created_by: z.string().nullish(),
   updated_by: z.string().nullish(),
+  created_by_username: z.string().nullish(),
   song_count: z.number()
 }),
   song_count: z.number(),
@@ -5004,6 +5024,8 @@ export const PlaylistsQueryResultSchema = z.object({
   title: z.string(),
   description: z.string().nullish(),
   is_public: z.number(),
+  collaborative: z.number(),
+  private: z.number(),
   images: z.array(z.object({
   blob_id: z.string(),
   is_primary: z.number(),
@@ -5021,6 +5043,7 @@ export const PlaylistsQueryResultSchema = z.object({
   deleted_by: z.string().nullish(),
   created_by: z.string().nullish(),
   updated_by: z.string().nullish(),
+  created_by_username: z.string().nullish(),
   song_count: z.number()
 }),
   song_count: z.number(),
@@ -5265,7 +5288,9 @@ export const QueryParamsSchema = z.object({
   min_rating: z.number().nullish(),
   mb_lookup_status: z.array(z.string()).nullish(),
   pending_review: z.boolean().nullish(),
-  caller_is_admin: z.boolean().nullish()
+  own_or_collaborative_only: z.boolean().nullish(),
+  caller_is_admin: z.boolean().nullish(),
+  caller_user_id: z.string().nullish()
 });
 export type QueryParams = z.infer<typeof QueryParamsSchema>;
 
@@ -5315,7 +5340,9 @@ export const QueryVideosRequestSchema = z.object({
   min_rating: z.number().nullish(),
   mb_lookup_status: z.array(z.string()).nullish(),
   pending_review: z.boolean().nullish(),
-  caller_is_admin: z.boolean().nullish()
+  own_or_collaborative_only: z.boolean().nullish(),
+  caller_is_admin: z.boolean().nullish(),
+  caller_user_id: z.string().nullish()
 }),
   series_id: z.string().nullish(),
   season_id: z.string().nullish(),
@@ -5882,6 +5909,17 @@ export const ReplaceAlbumsTagsRequestSchema = z.object({
 });
 export type ReplaceAlbumsTagsRequest = z.infer<typeof ReplaceAlbumsTagsRequestSchema>;
 
+export const ReprocessVideoRequestSchema = z.object({
+  id: z.string()
+});
+export type ReprocessVideoRequest = z.infer<typeof ReprocessVideoRequestSchema>;
+
+export const ReprocessVideoResultSchema = z.object({
+  video_id: z.string(),
+  job_id: z.string().nullish()
+});
+export type ReprocessVideoResult = z.infer<typeof ReprocessVideoResultSchema>;
+
 export const RequeryEnrichmentRequestSchema = z.object({
   album_id: z.string(),
   source: z.union([z.literal('Mb'), z.literal('Lastfm'), z.literal('Audiodb')]),
@@ -7402,6 +7440,8 @@ export const UpdatePlaylistRequestSchema = z.object({
   title: z.string().nullish(),
   description: z.string().nullish(),
   is_public: z.boolean().nullish(),
+  collaborative: z.boolean().nullish(),
+  private: z.boolean().nullish(),
   entity_urls: z.array(z.object({
   id: z.string().nullish(),
   name: z.string().nullish(),

package/src/domains/video.ts

@@ -167,6 +167,18 @@ export function createVideoMethods(call: CallFn) {
       );
     },
 
+    reprocessVideo: (params: s.ReprocessVideoRequest) => {
+      return call(
+        "video",
+        "reprocess_video",
+        routes.video.reprocess_video.resp,
+        routes.video.reprocess_video.req,
+        routes.video.reprocess_video.method,
+        routes.video.reprocess_video.path,
+        params,
+      );
+    },
+
     // playback progress
     upsertPlaybackProgress: (params: s.UpsertPlaybackProgressRequest) => {
       return call(

package/src/permissions.ts

@@ -120,13 +120,17 @@ export function canUpdatePlaylist(
 
 /**
  * check if user can add songs to a playlist.
- * playlists use OwnerOr(Admin).
+ * playlists use OwnerOr(Admin) - collaborative playlists additionally
+ * allow any authenticated user, mirroring the backend's
+ * `require_owner_or_collaborative_or_scope`.
  */
 export function canAddSongsToPlaylist(
   userId: string,
   playlistOwnerId: string | null,
   userRole: UserRoleName,
+  isCollaborative = false,
 ): boolean {
+  if (isCollaborative) return true;
   const auth = routes.music.add_songs_to_playlist.auth;
   if (auth.type === "owner_or") {
     return canAccessOwnerOr(userId, playlistOwnerId, userRole, auth.role);
@@ -136,13 +140,16 @@ export function canAddSongsToPlaylist(
 
 /**
  * check if user can remove songs from a playlist.
- * playlists use OwnerOr(Admin).
+ * playlists use OwnerOr(Admin) - collaborative playlists additionally
+ * allow any authenticated user.
  */
 export function canRemoveSongsFromPlaylist(
   userId: string,
   playlistOwnerId: string | null,
   userRole: UserRoleName,
+  isCollaborative = false,
 ): boolean {
+  if (isCollaborative) return true;
   const auth = routes.music.remove_songs_from_playlist.auth;
   if (auth.type === "owner_or") {
     return canAccessOwnerOr(userId, playlistOwnerId, userRole, auth.role);
@@ -402,13 +409,16 @@ export function canAccessMusicBrainz(userRole: UserRoleName): boolean {
 
 /**
  * check if user can reorder songs in a playlist.
- * playlists use OwnerOr(Admin).
+ * playlists use OwnerOr(Admin) - collaborative playlists additionally
+ * allow any authenticated user.
  */
 export function canReorderPlaylistSongs(
   userId: string,
   playlistOwnerId: string | null,
   userRole: UserRoleName,
+  isCollaborative = false,
 ): boolean {
+  if (isCollaborative) return true;
   const auth = routes.music.reorder_playlist_songs.auth;
   if (auth.type === "owner_or") {
     return canAccessOwnerOr(userId, playlistOwnerId, userRole, auth.role);