@mediaryorg/contracts 1.0.10 → 2.0.0

package/dist/proto/paths.d.ts

@@ -2,6 +2,14 @@ export declare const PROTO_PATH: {
     readonly AUTH: string;
     readonly USER: string;
     readonly PROFILE: string;
+    readonly MEDIA: string;
+    readonly COLLECTION: string;
+    readonly LIBRARY: string;
+    readonly FAVORITE: string;
+    readonly MEDIA_REQUEST: string;
+    readonly IMAGE: string;
+    readonly SEARCH: string;
+    readonly RECOMMENDATION: string;
 };
 /**
  * Root directories for protobuf imports.

package/dist/proto/paths.js

@@ -7,6 +7,14 @@ exports.PROTO_PATH = {
     AUTH: (0, path_1.join)(PROTO_DIR, "auth/v1/auth.proto"),
     USER: (0, path_1.join)(PROTO_DIR, "user/v1/user.proto"),
     PROFILE: (0, path_1.join)(PROTO_DIR, "profile/v1/profile.proto"),
+    MEDIA: (0, path_1.join)(PROTO_DIR, "media/v1/media.proto"),
+    COLLECTION: (0, path_1.join)(PROTO_DIR, "collection/v1/collection.proto"),
+    LIBRARY: (0, path_1.join)(PROTO_DIR, "library/v1/library.proto"),
+    FAVORITE: (0, path_1.join)(PROTO_DIR, "favorite/v1/favorite.proto"),
+    MEDIA_REQUEST: (0, path_1.join)(PROTO_DIR, "media_request/v1/media_request.proto"),
+    IMAGE: (0, path_1.join)(PROTO_DIR, "image/v1/image.proto"),
+    SEARCH: (0, path_1.join)(PROTO_DIR, "search/v1/search.proto"),
+    RECOMMENDATION: (0, path_1.join)(PROTO_DIR, "recommendation/v1/recommendation.proto"),
 };
 /**
  * Root directories for protobuf imports.

package/generated/collection/v1/collection.ts

@@ -0,0 +1,235 @@
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.11.6
+//   protoc               v3.21.12
+// source: collection/v1/collection.proto
+
+/* eslint-disable */
+import { GrpcMethod, GrpcStreamMethod } from "@nestjs/microservices";
+import { Observable } from "rxjs";
+
+export const protobufPackage = "collection.v1";
+
+export interface Collection {
+  id: string;
+  name: string;
+  createdAt: string;
+  updatedAt: string;
+  /** Number of Media records linked to the collection (returned by list/get). */
+  mediaCount: number;
+}
+
+export interface CollectionWithUserStatus {
+  collection: Collection | undefined;
+  isAdded: boolean;
+}
+
+export interface UserCollection {
+  id: string;
+  userId: string;
+  collectionId: string;
+  collection: Collection | undefined;
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface ListCollectionsRequest {
+}
+
+export interface ListCollectionsResponse {
+  items: Collection[];
+}
+
+export interface GetCollectionByIdRequest {
+  collectionId: string;
+}
+
+export interface GetCollectionByIdResponse {
+  collection: Collection | undefined;
+}
+
+export interface GetCollectionByNameRequest {
+  name: string;
+}
+
+export interface GetCollectionByNameResponse {
+  collection: Collection | undefined;
+}
+
+export interface SeedInitialCollectionsRequest {
+}
+
+export interface SeedInitialCollectionsResponse {
+  items: Collection[];
+}
+
+export interface GetUserCollectionsRequest {
+  userId: string;
+}
+
+export interface GetUserCollectionsResponse {
+  items: Collection[];
+}
+
+export interface GetAllCollectionsWithUserStatusRequest {
+  userId: string;
+}
+
+export interface GetAllCollectionsWithUserStatusResponse {
+  items: CollectionWithUserStatus[];
+}
+
+export interface GetAvailableCollectionsRequest {
+  userId: string;
+}
+
+export interface GetAvailableCollectionsResponse {
+  items: Collection[];
+}
+
+export interface AddCollectionToUserRequest {
+  userId: string;
+  collectionId: string;
+}
+
+export interface AddCollectionToUserResponse {
+  userCollection: UserCollection | undefined;
+}
+
+export interface RemoveCollectionFromUserRequest {
+  userId: string;
+  collectionId: string;
+}
+
+export interface RemoveCollectionFromUserResponse {
+  collectionId: string;
+}
+
+export interface InitializeDefaultCollectionsRequest {
+  userId: string;
+}
+
+export interface InitializeDefaultCollectionsResponse {
+  items: UserCollection[];
+}
+
+export const COLLECTION_V1_PACKAGE_NAME = "collection.v1";
+
+export interface CollectionServiceClient {
+  /** Global catalog of media collections (Movies, Series, Books, ...). */
+
+  listCollections(request: ListCollectionsRequest): Observable<ListCollectionsResponse>;
+
+  getCollectionById(request: GetCollectionByIdRequest): Observable<GetCollectionByIdResponse>;
+
+  getCollectionByName(request: GetCollectionByNameRequest): Observable<GetCollectionByNameResponse>;
+
+  seedInitialCollections(request: SeedInitialCollectionsRequest): Observable<SeedInitialCollectionsResponse>;
+
+  /** Per-user enabled collections. */
+
+  getUserCollections(request: GetUserCollectionsRequest): Observable<GetUserCollectionsResponse>;
+
+  getAllCollectionsWithUserStatus(
+    request: GetAllCollectionsWithUserStatusRequest,
+  ): Observable<GetAllCollectionsWithUserStatusResponse>;
+
+  getAvailableCollections(request: GetAvailableCollectionsRequest): Observable<GetAvailableCollectionsResponse>;
+
+  addCollectionToUser(request: AddCollectionToUserRequest): Observable<AddCollectionToUserResponse>;
+
+  removeCollectionFromUser(request: RemoveCollectionFromUserRequest): Observable<RemoveCollectionFromUserResponse>;
+
+  initializeDefaultCollections(
+    request: InitializeDefaultCollectionsRequest,
+  ): Observable<InitializeDefaultCollectionsResponse>;
+}
+
+export interface CollectionServiceController {
+  /** Global catalog of media collections (Movies, Series, Books, ...). */
+
+  listCollections(
+    request: ListCollectionsRequest,
+  ): Promise<ListCollectionsResponse> | Observable<ListCollectionsResponse> | ListCollectionsResponse;
+
+  getCollectionById(
+    request: GetCollectionByIdRequest,
+  ): Promise<GetCollectionByIdResponse> | Observable<GetCollectionByIdResponse> | GetCollectionByIdResponse;
+
+  getCollectionByName(
+    request: GetCollectionByNameRequest,
+  ): Promise<GetCollectionByNameResponse> | Observable<GetCollectionByNameResponse> | GetCollectionByNameResponse;
+
+  seedInitialCollections(
+    request: SeedInitialCollectionsRequest,
+  ):
+    | Promise<SeedInitialCollectionsResponse>
+    | Observable<SeedInitialCollectionsResponse>
+    | SeedInitialCollectionsResponse;
+
+  /** Per-user enabled collections. */
+
+  getUserCollections(
+    request: GetUserCollectionsRequest,
+  ): Promise<GetUserCollectionsResponse> | Observable<GetUserCollectionsResponse> | GetUserCollectionsResponse;
+
+  getAllCollectionsWithUserStatus(
+    request: GetAllCollectionsWithUserStatusRequest,
+  ):
+    | Promise<GetAllCollectionsWithUserStatusResponse>
+    | Observable<GetAllCollectionsWithUserStatusResponse>
+    | GetAllCollectionsWithUserStatusResponse;
+
+  getAvailableCollections(
+    request: GetAvailableCollectionsRequest,
+  ):
+    | Promise<GetAvailableCollectionsResponse>
+    | Observable<GetAvailableCollectionsResponse>
+    | GetAvailableCollectionsResponse;
+
+  addCollectionToUser(
+    request: AddCollectionToUserRequest,
+  ): Promise<AddCollectionToUserResponse> | Observable<AddCollectionToUserResponse> | AddCollectionToUserResponse;
+
+  removeCollectionFromUser(
+    request: RemoveCollectionFromUserRequest,
+  ):
+    | Promise<RemoveCollectionFromUserResponse>
+    | Observable<RemoveCollectionFromUserResponse>
+    | RemoveCollectionFromUserResponse;
+
+  initializeDefaultCollections(
+    request: InitializeDefaultCollectionsRequest,
+  ):
+    | Promise<InitializeDefaultCollectionsResponse>
+    | Observable<InitializeDefaultCollectionsResponse>
+    | InitializeDefaultCollectionsResponse;
+}
+
+export function CollectionServiceControllerMethods() {
+  return function (constructor: Function) {
+    const grpcMethods: string[] = [
+      "listCollections",
+      "getCollectionById",
+      "getCollectionByName",
+      "seedInitialCollections",
+      "getUserCollections",
+      "getAllCollectionsWithUserStatus",
+      "getAvailableCollections",
+      "addCollectionToUser",
+      "removeCollectionFromUser",
+      "initializeDefaultCollections",
+    ];
+    for (const method of grpcMethods) {
+      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+      GrpcMethod("CollectionService", method)(constructor.prototype[method], method, descriptor);
+    }
+    const grpcStreamMethods: string[] = [];
+    for (const method of grpcStreamMethods) {
+      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+      GrpcStreamMethod("CollectionService", method)(constructor.prototype[method], method, descriptor);
+    }
+  };
+}
+
+export const COLLECTION_SERVICE_NAME = "CollectionService";

package/generated/favorite/v1/favorite.ts

@@ -0,0 +1,146 @@
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.11.6
+//   protoc               v3.21.12
+// source: favorite/v1/favorite.proto
+
+/* eslint-disable */
+import { GrpcMethod, GrpcStreamMethod } from "@nestjs/microservices";
+import { Observable } from "rxjs";
+
+export const protobufPackage = "favorite.v1";
+
+export interface Favorite {
+  id: string;
+  userId: string;
+  mediaId: string;
+  createdAt: string;
+}
+
+export interface CheckMultipleFavoritesRequest {
+  userId: string;
+  mediaIds: string[];
+}
+
+/** `results` is a `media_id -> bool` map (matches the legacy REST shape). */
+export interface CheckMultipleFavoritesResponse {
+  results: { [key: string]: boolean };
+}
+
+export interface CheckMultipleFavoritesResponse_ResultsEntry {
+  key: string;
+  value: boolean;
+}
+
+export interface ToggleFavoriteRequest {
+  userId: string;
+  mediaId: string;
+}
+
+export interface ToggleFavoriteResponse {
+  isInFavorites: boolean;
+}
+
+export interface IsFavoriteRequest {
+  userId: string;
+  mediaId: string;
+}
+
+export interface IsFavoriteResponse {
+  isInFavorites: boolean;
+}
+
+export interface ListUserFavoritesRequest {
+  userId: string;
+  search?: string | undefined;
+  collectionId?: string | undefined;
+  page: number;
+  limit: number;
+  sortBy: string;
+  sortOrder: string;
+}
+
+export interface FavoritePaginationMeta {
+  page: number;
+  limit: number;
+  total: number;
+  totalPages: number;
+  hasNextPage: boolean;
+  hasPrevPage: boolean;
+}
+
+export interface ListUserFavoritesResponse {
+  data: Favorite[];
+  meta: FavoritePaginationMeta | undefined;
+}
+
+/** Used as a side-effect by library/media when content disappears. */
+export interface RemoveAllForMediaRequest {
+  mediaId: string;
+}
+
+export interface RemoveAllForMediaResponse {
+  removedCount: number;
+}
+
+export const FAVORITE_V1_PACKAGE_NAME = "favorite.v1";
+
+export interface FavoriteServiceClient {
+  checkMultipleFavorites(request: CheckMultipleFavoritesRequest): Observable<CheckMultipleFavoritesResponse>;
+
+  toggleFavorite(request: ToggleFavoriteRequest): Observable<ToggleFavoriteResponse>;
+
+  isFavorite(request: IsFavoriteRequest): Observable<IsFavoriteResponse>;
+
+  listUserFavorites(request: ListUserFavoritesRequest): Observable<ListUserFavoritesResponse>;
+
+  removeAllForMedia(request: RemoveAllForMediaRequest): Observable<RemoveAllForMediaResponse>;
+}
+
+export interface FavoriteServiceController {
+  checkMultipleFavorites(
+    request: CheckMultipleFavoritesRequest,
+  ):
+    | Promise<CheckMultipleFavoritesResponse>
+    | Observable<CheckMultipleFavoritesResponse>
+    | CheckMultipleFavoritesResponse;
+
+  toggleFavorite(
+    request: ToggleFavoriteRequest,
+  ): Promise<ToggleFavoriteResponse> | Observable<ToggleFavoriteResponse> | ToggleFavoriteResponse;
+
+  isFavorite(
+    request: IsFavoriteRequest,
+  ): Promise<IsFavoriteResponse> | Observable<IsFavoriteResponse> | IsFavoriteResponse;
+
+  listUserFavorites(
+    request: ListUserFavoritesRequest,
+  ): Promise<ListUserFavoritesResponse> | Observable<ListUserFavoritesResponse> | ListUserFavoritesResponse;
+
+  removeAllForMedia(
+    request: RemoveAllForMediaRequest,
+  ): Promise<RemoveAllForMediaResponse> | Observable<RemoveAllForMediaResponse> | RemoveAllForMediaResponse;
+}
+
+export function FavoriteServiceControllerMethods() {
+  return function (constructor: Function) {
+    const grpcMethods: string[] = [
+      "checkMultipleFavorites",
+      "toggleFavorite",
+      "isFavorite",
+      "listUserFavorites",
+      "removeAllForMedia",
+    ];
+    for (const method of grpcMethods) {
+      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+      GrpcMethod("FavoriteService", method)(constructor.prototype[method], method, descriptor);
+    }
+    const grpcStreamMethods: string[] = [];
+    for (const method of grpcStreamMethods) {
+      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+      GrpcStreamMethod("FavoriteService", method)(constructor.prototype[method], method, descriptor);
+    }
+  };
+}
+
+export const FAVORITE_SERVICE_NAME = "FavoriteService";

package/generated/image/v1/image.ts

@@ -0,0 +1,140 @@
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.11.6
+//   protoc               v3.21.12
+// source: image/v1/image.proto
+
+/* eslint-disable */
+import { GrpcMethod, GrpcStreamMethod } from "@nestjs/microservices";
+import { Observable } from "rxjs";
+
+export const protobufPackage = "image.v1";
+
+/** TMDB poster size variants accepted by the legacy controller. */
+export enum TmdbPosterSize {
+  TMDB_POSTER_SIZE_UNSPECIFIED = 0,
+  TMDB_POSTER_SIZE_W92 = 1,
+  TMDB_POSTER_SIZE_W154 = 2,
+  TMDB_POSTER_SIZE_W185 = 3,
+  TMDB_POSTER_SIZE_W342 = 4,
+  TMDB_POSTER_SIZE_W500 = 5,
+  TMDB_POSTER_SIZE_W780 = 6,
+  TMDB_POSTER_SIZE_ORIGINAL = 7,
+  UNRECOGNIZED = -1,
+}
+
+export interface ProxyImageRequest {
+  url: string;
+  width?: number | undefined;
+  height?: number | undefined;
+}
+
+export interface ProxyImageResponse {
+  data: Uint8Array;
+  contentType: string;
+  contentLength: number;
+}
+
+export interface GetTmdbPosterUrlRequest {
+  posterPath: string;
+  size: TmdbPosterSize;
+}
+
+export interface GetTmdbPosterUrlResponse {
+  url: string;
+}
+
+export interface UploadImageRequest {
+  /**
+   * Raw file bytes. Allowed mime types: image/jpeg, image/png, image/webp.
+   * Max size: 4 MiB.
+   */
+  data: Uint8Array;
+  originalName: string;
+  mimeType: string;
+}
+
+export interface UploadImageResponse {
+  url: string;
+  originalName: string;
+  size: number;
+}
+
+export interface DeleteImageRequest {
+  /** Either a full URL (with public-host prefix) or just the storage key. */
+  urlOrKey: string;
+}
+
+export interface DeleteImageResponse {
+}
+
+export const IMAGE_V1_PACKAGE_NAME = "image.v1";
+
+export interface ImageServiceClient {
+  /**
+   * Returns the binary image (proxied + optionally resized).
+   * Useful when the gateway streams it back to the client. Size hints are
+   * advisory; the implementation may ignore them.
+   */
+
+  proxyImage(request: ProxyImageRequest): Observable<ProxyImageResponse>;
+
+  /** Resolves a TMDB poster path (e.g. "/abc.jpg") to an absolute URL. */
+
+  getTmdbPosterUrl(request: GetTmdbPosterUrlRequest): Observable<GetTmdbPosterUrlResponse>;
+
+  /** Uploads a single image to object storage (R2) and returns its public URL. */
+
+  uploadImage(request: UploadImageRequest): Observable<UploadImageResponse>;
+
+  /** Removes an image from object storage by its public URL or key. */
+
+  deleteImage(request: DeleteImageRequest): Observable<DeleteImageResponse>;
+}
+
+export interface ImageServiceController {
+  /**
+   * Returns the binary image (proxied + optionally resized).
+   * Useful when the gateway streams it back to the client. Size hints are
+   * advisory; the implementation may ignore them.
+   */
+
+  proxyImage(
+    request: ProxyImageRequest,
+  ): Promise<ProxyImageResponse> | Observable<ProxyImageResponse> | ProxyImageResponse;
+
+  /** Resolves a TMDB poster path (e.g. "/abc.jpg") to an absolute URL. */
+
+  getTmdbPosterUrl(
+    request: GetTmdbPosterUrlRequest,
+  ): Promise<GetTmdbPosterUrlResponse> | Observable<GetTmdbPosterUrlResponse> | GetTmdbPosterUrlResponse;
+
+  /** Uploads a single image to object storage (R2) and returns its public URL. */
+
+  uploadImage(
+    request: UploadImageRequest,
+  ): Promise<UploadImageResponse> | Observable<UploadImageResponse> | UploadImageResponse;
+
+  /** Removes an image from object storage by its public URL or key. */
+
+  deleteImage(
+    request: DeleteImageRequest,
+  ): Promise<DeleteImageResponse> | Observable<DeleteImageResponse> | DeleteImageResponse;
+}
+
+export function ImageServiceControllerMethods() {
+  return function (constructor: Function) {
+    const grpcMethods: string[] = ["proxyImage", "getTmdbPosterUrl", "uploadImage", "deleteImage"];
+    for (const method of grpcMethods) {
+      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+      GrpcMethod("ImageService", method)(constructor.prototype[method], method, descriptor);
+    }
+    const grpcStreamMethods: string[] = [];
+    for (const method of grpcStreamMethods) {
+      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+      GrpcStreamMethod("ImageService", method)(constructor.prototype[method], method, descriptor);
+    }
+  };
+}
+
+export const IMAGE_SERVICE_NAME = "ImageService";