@mediaryorg/contracts 1.0.8 → 2.0.0

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";

package/generated/library/v1/library.ts

@@ -0,0 +1,216 @@
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.11.6
+//   protoc               v3.21.12
+// source: library/v1/library.proto
+
+/* eslint-disable */
+import { GrpcMethod, GrpcStreamMethod } from "@nestjs/microservices";
+import { Observable } from "rxjs";
+import { Media, MediaSource } from "../../media/v1/media";
+
+export const protobufPackage = "library.v1";
+
+/** Mirrors prisma enum Status (PLANNED/IN_PROGRESS/COMPLETED/DROPPED). */
+export enum LibraryItemStatus {
+  LIBRARY_ITEM_STATUS_UNSPECIFIED = 0,
+  LIBRARY_ITEM_STATUS_PLANNED = 1,
+  LIBRARY_ITEM_STATUS_IN_PROGRESS = 2,
+  LIBRARY_ITEM_STATUS_COMPLETED = 3,
+  LIBRARY_ITEM_STATUS_DROPPED = 4,
+  UNRECOGNIZED = -1,
+}
+
+export interface LibraryItem {
+  id: string;
+  userId: string;
+  mediaId: string;
+  status: LibraryItemStatus;
+  rating?: number | undefined;
+  notes?: string | undefined;
+  addedAt: string;
+  updatedAt: string;
+  /** Embedded media snapshot for the read paths (denormalized view). */
+  media:
+    | Media
+    | undefined;
+  /** Pre-aggregated counts to avoid extra round-trips on the gateway side. */
+  libraryCount: number;
+  reviewsCount: number;
+  isFavorite: boolean;
+}
+
+/** Compact search hit accepted by AddFromSearch (mirrors AddFromSearchDto.searchResult). */
+export interface LibrarySearchHit {
+  id: string;
+  title: string;
+  subtitle?: string | undefined;
+  imageUrl?: string | undefined;
+  year?: string | undefined;
+  type: string;
+  source: string;
+  externalId?: string | undefined;
+  rating?: number | undefined;
+  genres: string[];
+}
+
+export interface AddFromSearchRequest {
+  userId: string;
+  searchResult: LibrarySearchHit | undefined;
+  status?: LibraryItemStatus | undefined;
+  rating?: number | undefined;
+  notes?: string | undefined;
+}
+
+export interface AddFromSearchResponse {
+  item: LibraryItem | undefined;
+}
+
+export interface GetUserLibraryRequest {
+  userId: string;
+  statuses: LibraryItemStatus[];
+  collectionName?: string | undefined;
+  source?: MediaSource | undefined;
+  search?: string | undefined;
+  genres: string[];
+  minRating?: number | undefined;
+  maxRating?: number | undefined;
+  minYear?: number | undefined;
+  maxYear?: number | undefined;
+  page: number;
+  limit: number;
+  /** addedAt | rating | title | releaseYear | favorites */
+  sortBy: string;
+  sortOrder: string;
+}
+
+export interface LibraryPaginationMeta {
+  page: number;
+  limit: number;
+  total: number;
+  totalPages: number;
+  hasNextPage: boolean;
+  hasPrevPage: boolean;
+}
+
+export interface GetUserLibraryResponse {
+  data: LibraryItem[];
+  meta: LibraryPaginationMeta | undefined;
+}
+
+export interface GetLibraryItemRequest {
+  userId: string;
+  mediaId: string;
+}
+
+export interface GetLibraryItemResponse {
+  item: LibraryItem | undefined;
+}
+
+export interface UpdateLibraryItemRequest {
+  userId: string;
+  mediaId: string;
+  status?: LibraryItemStatus | undefined;
+  rating?: number | undefined;
+  notes?: string | undefined;
+}
+
+export interface UpdateLibraryItemResponse {
+  item: LibraryItem | undefined;
+}
+
+export interface RemoveFromLibraryRequest {
+  userId: string;
+  mediaId: string;
+}
+
+export interface RemoveFromLibraryResponse {
+}
+
+export interface IsInLibraryRequest {
+  userId: string;
+  mediaId: string;
+}
+
+export interface IsInLibraryResponse {
+  isInLibrary: boolean;
+}
+
+export interface GetGenresRequest {
+  userId: string;
+}
+
+export interface GetGenresResponse {
+  genres: string[];
+}
+
+export const LIBRARY_V1_PACKAGE_NAME = "library.v1";
+
+export interface LibraryServiceClient {
+  addFromSearch(request: AddFromSearchRequest): Observable<AddFromSearchResponse>;
+
+  getUserLibrary(request: GetUserLibraryRequest): Observable<GetUserLibraryResponse>;
+
+  getLibraryItem(request: GetLibraryItemRequest): Observable<GetLibraryItemResponse>;
+
+  updateLibraryItem(request: UpdateLibraryItemRequest): Observable<UpdateLibraryItemResponse>;
+
+  removeFromLibrary(request: RemoveFromLibraryRequest): Observable<RemoveFromLibraryResponse>;
+
+  isInLibrary(request: IsInLibraryRequest): Observable<IsInLibraryResponse>;
+
+  getGenres(request: GetGenresRequest): Observable<GetGenresResponse>;
+}
+
+export interface LibraryServiceController {
+  addFromSearch(
+    request: AddFromSearchRequest,
+  ): Promise<AddFromSearchResponse> | Observable<AddFromSearchResponse> | AddFromSearchResponse;
+
+  getUserLibrary(
+    request: GetUserLibraryRequest,
+  ): Promise<GetUserLibraryResponse> | Observable<GetUserLibraryResponse> | GetUserLibraryResponse;
+
+  getLibraryItem(
+    request: GetLibraryItemRequest,
+  ): Promise<GetLibraryItemResponse> | Observable<GetLibraryItemResponse> | GetLibraryItemResponse;
+
+  updateLibraryItem(
+    request: UpdateLibraryItemRequest,
+  ): Promise<UpdateLibraryItemResponse> | Observable<UpdateLibraryItemResponse> | UpdateLibraryItemResponse;
+
+  removeFromLibrary(
+    request: RemoveFromLibraryRequest,
+  ): Promise<RemoveFromLibraryResponse> | Observable<RemoveFromLibraryResponse> | RemoveFromLibraryResponse;
+
+  isInLibrary(
+    request: IsInLibraryRequest,
+  ): Promise<IsInLibraryResponse> | Observable<IsInLibraryResponse> | IsInLibraryResponse;
+
+  getGenres(request: GetGenresRequest): Promise<GetGenresResponse> | Observable<GetGenresResponse> | GetGenresResponse;
+}
+
+export function LibraryServiceControllerMethods() {
+  return function (constructor: Function) {
+    const grpcMethods: string[] = [
+      "addFromSearch",
+      "getUserLibrary",
+      "getLibraryItem",
+      "updateLibraryItem",
+      "removeFromLibrary",
+      "isInLibrary",
+      "getGenres",
+    ];
+    for (const method of grpcMethods) {
+      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+      GrpcMethod("LibraryService", method)(constructor.prototype[method], method, descriptor);
+    }
+    const grpcStreamMethods: string[] = [];
+    for (const method of grpcStreamMethods) {
+      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+      GrpcStreamMethod("LibraryService", method)(constructor.prototype[method], method, descriptor);
+    }
+  };
+}
+
+export const LIBRARY_SERVICE_NAME = "LibraryService";

package/generated/media/v1/media.ts

@@ -0,0 +1,294 @@
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.11.6
+//   protoc               v3.21.12
+// source: media/v1/media.proto
+
+/* eslint-disable */
+import { GrpcMethod, GrpcStreamMethod } from "@nestjs/microservices";
+import { Observable } from "rxjs";
+
+export const protobufPackage = "media.v1";
+
+/** MediaSource mirrors prisma enum MediaSource. */
+export enum MediaSource {
+  MEDIA_SOURCE_UNSPECIFIED = 0,
+  MEDIA_SOURCE_TMDB = 1,
+  MEDIA_SOURCE_GOOGLE_BOOKS = 2,
+  MEDIA_SOURCE_MAL = 3,
+  MEDIA_SOURCE_CUSTOM = 4,
+  UNRECOGNIZED = -1,
+}
+
+/**
+ * MediaData is the structured payload kept as JSON in the legacy database.
+ * `custom_fields_json` contains the type-specific customFields object as a
+ * JSON-encoded string so callers can extend without breaking the schema.
+ */
+export interface MediaData {
+  title: string;
+  originalTitle: string;
+  description: string;
+  year: number;
+  posterUrl: string;
+  genres: string[];
+  rating: number;
+  releaseDate: string;
+  country: string;
+  originalLanguage: string;
+  customFieldsJson: string;
+}
+
+export interface Media {
+  id: string;
+  source: MediaSource;
+  externalId: string;
+  mediaData: MediaData | undefined;
+  searchableTitle: string;
+  externalIdsJson: string;
+  collectionId: string;
+  addedById: string;
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface MediaCounts {
+  library: number;
+  reviews: number;
+  favorites: number;
+}
+
+export interface MediaWithCounts {
+  media: Media | undefined;
+  counts: MediaCounts | undefined;
+}
+
+export interface CreateMediaRequest {
+  source: MediaSource;
+  externalId: string;
+  mediaData: MediaData | undefined;
+  collectionId: string;
+  addedById: string;
+}
+
+export interface CreateMediaResponse {
+  media: Media | undefined;
+}
+
+export interface GetMediaByIdRequest {
+  mediaId: string;
+}
+
+export interface RatingDistributionEntry {
+  rating: number;
+  count: number;
+}
+
+export interface GetMediaByIdResponse {
+  media: Media | undefined;
+  counts: MediaCounts | undefined;
+  averageRating: number;
+  totalReviews: number;
+}
+
+export interface GetMediaByExternalIdRequest {
+  source: MediaSource;
+  externalId: string;
+}
+
+export interface GetMediaByExternalIdResponse {
+  media: Media | undefined;
+}
+
+export interface FindDuplicatesRequest {
+  title: string;
+  externalId: string;
+}
+
+export interface FindDuplicatesResponse {
+  items: Media[];
+}
+
+export interface GetMediaStatsRequest {
+  mediaId: string;
+}
+
+export interface MediaStats {
+  averageRating: number;
+  totalReviews: number;
+  ratingDistribution: RatingDistributionEntry[];
+}
+
+export interface GetMediaStatsResponse {
+  media: Media | undefined;
+  stats: MediaStats | undefined;
+}
+
+export interface UpdateMediaRequest {
+  mediaId: string;
+  source?: MediaSource | undefined;
+  externalId?: string | undefined;
+  mediaData?: MediaData | undefined;
+  collectionId?: string | undefined;
+}
+
+export interface UpdateMediaResponse {
+  media: Media | undefined;
+}
+
+export interface DeleteMediaRequest {
+  mediaId: string;
+}
+
+export interface DeleteMediaResponse {
+}
+
+export interface ListMediaRequest {
+  search?: string | undefined;
+  collectionId?: string | undefined;
+  source?: MediaSource | undefined;
+  year?: number | undefined;
+  page: number;
+  limit: number;
+  sortBy: string;
+  sortOrder: string;
+}
+
+export interface PaginationMeta {
+  page: number;
+  limit: number;
+  total: number;
+  totalPages: number;
+  hasNextPage: boolean;
+  hasPrevPage: boolean;
+}
+
+export interface ListMediaResponse {
+  data: MediaWithCounts[];
+  meta: PaginationMeta | undefined;
+}
+
+export interface EnsureMediaFromSearchRequest {
+  /**
+   * Source identifier coming from search-service results
+   * ("tmdb", "google_books", "mangadex", ..., or "local" for already-existing)
+   */
+  source: string;
+  /** External id within that source (or media id when source == "local") */
+  externalId: string;
+  /** Search media type label ("movie"|"series"|"book"|"anime"|"manga"|"manhwa"|"game"|"kdrama") */
+  mediaType: string;
+  title: string;
+  subtitle: string;
+  imageUrl: string;
+  year: string;
+  rating?: number | undefined;
+  genres: string[];
+  /** User who initiated the action (becomes addedBy on creation). */
+  requestedByUserId: string;
+}
+
+export interface EnsureMediaFromSearchResponse {
+  media:
+    | Media
+    | undefined;
+  /** True when the media row was just created, false when reused. */
+  created: boolean;
+}
+
+export const MEDIA_V1_PACKAGE_NAME = "media.v1";
+
+export interface MediaServiceClient {
+  createMedia(request: CreateMediaRequest): Observable<CreateMediaResponse>;
+
+  getMediaById(request: GetMediaByIdRequest): Observable<GetMediaByIdResponse>;
+
+  getMediaByExternalId(request: GetMediaByExternalIdRequest): Observable<GetMediaByExternalIdResponse>;
+
+  findDuplicates(request: FindDuplicatesRequest): Observable<FindDuplicatesResponse>;
+
+  getMediaStats(request: GetMediaStatsRequest): Observable<GetMediaStatsResponse>;
+
+  updateMedia(request: UpdateMediaRequest): Observable<UpdateMediaResponse>;
+
+  deleteMedia(request: DeleteMediaRequest): Observable<DeleteMediaResponse>;
+
+  listMedia(request: ListMediaRequest): Observable<ListMediaResponse>;
+
+  /**
+   * Cross-service: ensure media exists for a search hit.
+   * Used by library/favorites/recommendation flows so they don't need to write
+   * into the media database directly.
+   */
+
+  ensureMediaFromSearch(request: EnsureMediaFromSearchRequest): Observable<EnsureMediaFromSearchResponse>;
+}
+
+export interface MediaServiceController {
+  createMedia(
+    request: CreateMediaRequest,
+  ): Promise<CreateMediaResponse> | Observable<CreateMediaResponse> | CreateMediaResponse;
+
+  getMediaById(
+    request: GetMediaByIdRequest,
+  ): Promise<GetMediaByIdResponse> | Observable<GetMediaByIdResponse> | GetMediaByIdResponse;
+
+  getMediaByExternalId(
+    request: GetMediaByExternalIdRequest,
+  ): Promise<GetMediaByExternalIdResponse> | Observable<GetMediaByExternalIdResponse> | GetMediaByExternalIdResponse;
+
+  findDuplicates(
+    request: FindDuplicatesRequest,
+  ): Promise<FindDuplicatesResponse> | Observable<FindDuplicatesResponse> | FindDuplicatesResponse;
+
+  getMediaStats(
+    request: GetMediaStatsRequest,
+  ): Promise<GetMediaStatsResponse> | Observable<GetMediaStatsResponse> | GetMediaStatsResponse;
+
+  updateMedia(
+    request: UpdateMediaRequest,
+  ): Promise<UpdateMediaResponse> | Observable<UpdateMediaResponse> | UpdateMediaResponse;
+
+  deleteMedia(
+    request: DeleteMediaRequest,
+  ): Promise<DeleteMediaResponse> | Observable<DeleteMediaResponse> | DeleteMediaResponse;
+
+  listMedia(request: ListMediaRequest): Promise<ListMediaResponse> | Observable<ListMediaResponse> | ListMediaResponse;
+
+  /**
+   * Cross-service: ensure media exists for a search hit.
+   * Used by library/favorites/recommendation flows so they don't need to write
+   * into the media database directly.
+   */
+
+  ensureMediaFromSearch(
+    request: EnsureMediaFromSearchRequest,
+  ): Promise<EnsureMediaFromSearchResponse> | Observable<EnsureMediaFromSearchResponse> | EnsureMediaFromSearchResponse;
+}
+
+export function MediaServiceControllerMethods() {
+  return function (constructor: Function) {
+    const grpcMethods: string[] = [
+      "createMedia",
+      "getMediaById",
+      "getMediaByExternalId",
+      "findDuplicates",
+      "getMediaStats",
+      "updateMedia",
+      "deleteMedia",
+      "listMedia",
+      "ensureMediaFromSearch",
+    ];
+    for (const method of grpcMethods) {
+      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+      GrpcMethod("MediaService", method)(constructor.prototype[method], method, descriptor);
+    }
+    const grpcStreamMethods: string[] = [];
+    for (const method of grpcStreamMethods) {
+      const descriptor: any = Reflect.getOwnPropertyDescriptor(constructor.prototype, method);
+      GrpcStreamMethod("MediaService", method)(constructor.prototype[method], method, descriptor);
+    }
+  };
+}
+
+export const MEDIA_SERVICE_NAME = "MediaService";