feat: add request media (#1811)

packages/api/src/router/search-engine/search-engine-router.ts

@@ -2,8 +2,10 @@ import { TRPCError } from "@trpc/server";
 
 import { createId, eq, like, sql } from "@homarr/db";
 import { searchEngines } from "@homarr/db/schema";
+import { integrationCreator } from "@homarr/integrations";
 import { validation } from "@homarr/validation";
 
+import { createOneIntegrationMiddleware } from "../../middlewares/integration";
 import { createTRPCRouter, permissionRequiredProcedure, protectedProcedure } from "../../trpc";
 
 export const searchEngineRouter = createTRPCRouter({
@@ -56,9 +58,32 @@ export const searchEngineRouter = createTRPCRouter({
   search: protectedProcedure.input(validation.common.search).query(async ({ ctx, input }) => {
     return await ctx.db.query.searchEngines.findMany({
       where: like(searchEngines.short, `${input.query.toLowerCase().trim()}%`),
+      with: {
+        integration: {
+          columns: {
+            kind: true,
+            url: true,
+            id: true,
+          },
+        },
+      },
       limit: input.limit,
     });
   }),
+  getMediaRequestOptions: protectedProcedure
+    .unstable_concat(createOneIntegrationMiddleware("query", "jellyseerr", "overseerr"))
+    .input(validation.common.mediaRequestOptions)
+    .query(async ({ ctx, input }) => {
+      const integration = integrationCreator(ctx.integration);
+      return await integration.getSeriesInformationAsync(input.mediaType, input.mediaId);
+    }),
+  requestMedia: protectedProcedure
+    .unstable_concat(createOneIntegrationMiddleware("interact", "jellyseerr", "overseerr"))
+    .input(validation.common.requestMedia)
+    .mutation(async ({ ctx, input }) => {
+      const integration = integrationCreator(ctx.integration);
+      return await integration.requestMediaAsync(input.mediaType, input.mediaId, input.seasons);
+    }),
   create: permissionRequiredProcedure
     .requiresPermission("search-engine-create")
     .input(validation.searchEngine.manage)

packages/definitions/src/docs/homarr-docs-sitemap.ts

@@ -90,6 +90,7 @@ export type HomarrDocumentationPath =
   | "/docs/tags/lists"
   | "/docs/tags/management"
   | "/docs/tags/media"
+  | "/docs/tags/minecraft"
   | "/docs/tags/monitoring"
   | "/docs/tags/news"
   | "/docs/tags/notebook"
@@ -190,6 +191,7 @@ export type HomarrDocumentationPath =
   | "/docs/widgets/indexer-manager"
   | "/docs/widgets/media-requests"
   | "/docs/widgets/media-server"
+  | "/docs/widgets/minecraft-server-status"
   | "/docs/widgets/notebook"
   | "/docs/widgets/rss"
   | "/docs/widgets/video"

packages/integrations/src/base/searchable-integration.ts

@@ -1,3 +1,3 @@
-export interface ISearchableIntegration {
-  searchAsync(query: string): Promise<{ image?: string; name: string; link: string }[]>;
+export interface ISearchableIntegration<TResult extends { image?: string; name: string; link: string }> {
+  searchAsync(query: string): Promise<TResult[]>;
 }

packages/integrations/src/overseerr/overseerr-integration.ts

@@ -6,11 +6,20 @@ import type { ISearchableIntegration } from "../base/searchable-integration";
 import type { MediaRequest, RequestStats, RequestUser } from "../interfaces/media-requests/media-request";
 import { MediaAvailability, MediaRequestStatus } from "../interfaces/media-requests/media-request";
 
+interface OverseerrSearchResult {
+  id: number;
+  name: string;
+  link: string;
+  image?: string;
+  text?: string;
+  type: Exclude<z.infer<typeof searchSchema>["results"], undefined>[number]["mediaType"];
+}
+
 /**
  * Overseerr Integration. See https://api-docs.overseerr.dev
  */
-export class OverseerrIntegration extends Integration implements ISearchableIntegration {
-  public async searchAsync(query: string): Promise<{ image?: string; name: string; link: string; text?: string }[]> {
+export class OverseerrIntegration extends Integration implements ISearchableIntegration<OverseerrSearchResult> {
+  public async searchAsync(query: string) {
     const response = await fetch(this.url("/api/v1/search", { query }), {
       headers: {
         "X-Api-Key": this.getSecretValue("apiKey"),
@@ -23,13 +32,53 @@ export class OverseerrIntegration extends Integration implements ISearchableInte
     }
 
     return schemaData.results.map((result) => ({
+      id: result.id,
       name: "name" in result ? result.name : result.title,
       link: this.url(`/${result.mediaType}/${result.id}`).toString(),
       image: constructSearchResultImage(result),
       text: "overview" in result ? result.overview : undefined,
+      type: result.mediaType,
+      inLibrary: result.mediaInfo !== undefined,
     }));
   }
 
+  public async getSeriesInformationAsync(mediaType: "movie" | "tv", id: number) {
+    const url = mediaType === "tv" ? this.url(`/api/v1/tv/${id}`) : this.url(`/api/v1/movie/${id}`);
+    const response = await fetch(url, {
+      headers: {
+        "X-Api-Key": this.getSecretValue("apiKey"),
+      },
+    });
+    return await mediaInformationSchema.parseAsync(await response.json());
+  }
+
+  /**
+   * Request a media. See https://api-docs.overseerr.dev/#/request/post_request
+   * @param mediaType The media type to request. Can be "movie" or "tv".
+   * @param id The Overseerr ID of the media to request.
+   * @param seasons A list of the seasons that should be requested.
+   */
+  public async requestMediaAsync(mediaType: "movie" | "tv", id: number, seasons?: number[]): Promise<void> {
+    const url = this.url("/api/v1/request");
+    const response = await fetch(url, {
+      method: "POST",
+      body: JSON.stringify({
+        mediaType,
+        mediaId: id,
+        seasons,
+      }),
+      headers: {
+        "X-Api-Key": this.getSecretValue("apiKey"),
+        "Content-Type": "application/json",
+      },
+    });
+    if (response.status !== 201) {
+      throw new Error(
+        `Status code ${response.status} does not match the expected status code. The request was likely not created. Response: ${await response.text()}`,
+      );
+    }
+  }
+
   public async testConnectionAsync(): Promise<void> {
     const response = await fetch(this.url("/api/v1/auth/me"), {
       headers: {
@@ -220,6 +269,27 @@ interface MovieInformation {
   releaseDate: string;
 }
 
+const mediaInformationSchema = z.union([
+  z.object({
+    id: z.number(),
+    overview: z.string(),
+    seasons: z.array(
+      z.object({
+        id: z.number(),
+        name: z.string().min(0),
+        episodeCount: z.number().min(0),
+      }),
+    ),
+    numberOfSeasons: z.number(),
+    posterPath: z.string().startsWith("/"),
+  }),
+  z.object({
+    id: z.number(),
+    overview: z.string(),
+    posterPath: z.string().startsWith("/"),
+  }),
+]);
+
 const searchSchema = z.object({
   results: z
     .array(
@@ -230,19 +300,22 @@ const searchSchema = z.object({
           name: z.string(),
           posterPath: z.string().startsWith("/").endsWith(".jpg").nullable(),
           overview: z.string(),
+          mediaInfo: z.object({}).optional(),
         }),
         z.object({
           id: z.number(),
           mediaType: z.literal("movie"),
           title: z.string(),
           posterPath: z.string().startsWith("/").endsWith(".jpg").nullable(),
           overview: z.string(),
+          mediaInfo: z.object({}).optional(),
         }),
         z.object({
           id: z.number(),
           mediaType: z.literal("person"),
           name: z.string(),
           profilePath: z.string().startsWith("/").endsWith(".jpg").nullable(),
+          mediaInfo: z.object({}).optional(),
         }),
       ]),
     )

packages/modals-collection/src/index.ts

@@ -1,3 +1,4 @@
 export * from "./boards";
 export * from "./invites";
 export * from "./groups";
+export * from "./search-engines";

packages/modals-collection/src/search-engines/index.ts

@@ -0,0 +1 @@
+export { RequestMediaModal } from "./request-media-modal";

packages/modals-collection/src/search-engines/request-media-modal.tsx

@@ -0,0 +1,119 @@
+import { useMemo } from "react";
+import { Button, Group, Image, LoadingOverlay, Stack, Text } from "@mantine/core";
+import type { MRT_ColumnDef } from "mantine-react-table";
+import { MRT_Table } from "mantine-react-table";
+
+import { clientApi } from "@homarr/api/client";
+import { createModal } from "@homarr/modals";
+import { showSuccessNotification } from "@homarr/notifications";
+import { useI18n } from "@homarr/translation/client";
+import { useTranslatedMantineReactTable } from "@homarr/ui/hooks";
+
+interface RequestMediaModalProps {
+  integrationId: string;
+  mediaId: number;
+  mediaType: "movie" | "tv";
+}
+
+export const RequestMediaModal = createModal<RequestMediaModalProps>(({ actions, innerProps }) => {
+  const { data, isPending: isPendingQuery } = clientApi.searchEngine.getMediaRequestOptions.useQuery({
+    integrationId: innerProps.integrationId,
+    mediaId: innerProps.mediaId,
+    mediaType: innerProps.mediaType,
+  });
+
+  const { mutate, isPending: isPendingMutation } = clientApi.searchEngine.requestMedia.useMutation({
+    onSuccess() {
+      actions.closeModal();
+      showSuccessNotification({
+        message: t("common.notification.create.success"),
+      });
+    },
+  });
+
+  const isPending = isPendingQuery || isPendingMutation;
+  const t = useI18n();
+
+  const columns = useMemo<MRT_ColumnDef<Season>[]>(
+    () => [
+      {
+        accessorKey: "name",
+        header: t("search.engine.media.request.modal.table.header.season"),
+      },
+      {
+        accessorKey: "episodeCount",
+        header: t("search.engine.media.request.modal.table.header.episodes"),
+      },
+    ],
+    [],
+  );
+
+  const table = useTranslatedMantineReactTable({
+    columns,
+    data: data && "seasons" in data ? data.seasons : [],
+    enableColumnActions: false,
+    enableColumnFilters: false,
+    enablePagination: false,
+    enableSorting: false,
+    enableSelectAll: true,
+    enableRowSelection: true,
+    mantineTableProps: {
+      highlightOnHover: false,
+      striped: "odd",
+      withColumnBorders: true,
+      withRowBorders: true,
+      withTableBorder: true,
+    },
+    initialState: {
+      density: "xs",
+    },
+  });
+
+  const anySelected = Object.keys(table.getState().rowSelection).length > 0;
+
+  const handleMutate = () => {
+    const selectedSeasons = table.getSelectedRowModel().rows.flatMap((row) => row.original.id);
+    mutate({
+      integrationId: innerProps.integrationId,
+      mediaId: innerProps.mediaId,
+      mediaType: innerProps.mediaType,
+      seasons: selectedSeasons,
+    });
+  };
+
+  return (
+    <Stack>
+      <LoadingOverlay visible={isPending} zIndex={1000} overlayProps={{ radius: "sm", blur: 2 }} />
+      {data && (
+        <Group wrap="nowrap" align="start">
+          <Image
+            src={`https://image.tmdb.org/t/p/w600_and_h900_bestv2${data.posterPath}`}
+            alt="poster"
+            w={100}
+            radius="md"
+          />
+          <Text c="dimmed" style={{ flex: "1" }}>
+            {data.overview}
+          </Text>
+        </Group>
+      )}
+      {innerProps.mediaType === "tv" && <MRT_Table table={table} />}
+      <Group justify="end">
+        <Button onClick={actions.closeModal} variant="light">
+          {t("common.action.cancel")}
+        </Button>
+        <Button onClick={handleMutate} disabled={!anySelected && innerProps.mediaType === "tv"}>
+          {t("search.engine.media.request.modal.button.send")}
+        </Button>
+      </Group>
+    </Stack>
+  );
+}).withOptions({
+  size: "xl",
+});
+
+interface Season {
+  id: number;
+  name: string;
+  episodeCount: number;
+}

packages/spotlight/src/components/actions/children-actions.tsx

@@ -4,14 +4,25 @@ import { ChildrenActionItem } from "./items/children-action-item";
 interface SpotlightChildrenActionsProps {
   childrenOptions: inferSearchInteractionOptions<"children">;
   query: string;
+  setChildrenOptions: (options: inferSearchInteractionOptions<"children">) => void;
 }
 
-export const SpotlightChildrenActions = ({ childrenOptions, query }: SpotlightChildrenActionsProps) => {
+export const SpotlightChildrenActions = ({
+  childrenOptions,
+  query,
+  setChildrenOptions,
+}: SpotlightChildrenActionsProps) => {
   const actions = childrenOptions.useActions(childrenOptions.option, query);
 
   return actions
     .filter((action) => (typeof action.hide === "function" ? !action.hide(childrenOptions.option) : !action.hide))
     .map((action) => (
-      <ChildrenActionItem key={action.key} childrenOptions={childrenOptions} query={query} action={action} />
+      <ChildrenActionItem
+        key={action.key}
+        childrenOptions={childrenOptions}
+        query={query}
+        action={action}
+        setChildrenOptions={setChildrenOptions}
+      />
     ));
 };

packages/spotlight/src/components/actions/items/children-action-item.tsx

@@ -8,9 +8,10 @@ interface ChildrenActionItemProps {
   childrenOptions: inferSearchInteractionOptions<"children">;
   query: string;
   action: ReturnType<inferSearchInteractionOptions<"children">["useActions"]>[number];
+  setChildrenOptions: (options: inferSearchInteractionOptions<"children">) => void;
 }
 
-export const ChildrenActionItem = ({ childrenOptions, action, query }: ChildrenActionItemProps) => {
+export const ChildrenActionItem = ({ childrenOptions, action, query, setChildrenOptions }: ChildrenActionItemProps) => {
   const interaction = action.useInteraction(childrenOptions.option, query);
 
   const renderRoot =
@@ -20,10 +21,20 @@ export const ChildrenActionItem = ({ childrenOptions, action, query }: ChildrenA
         }
       : undefined;
 
-  const onClick = interaction.type === "javaScript" ? interaction.onSelect : undefined;
+  const onClick =
+    interaction.type === "javaScript"
+      ? interaction.onSelect
+      : interaction.type === "children"
+        ? () => setChildrenOptions(interaction)
+        : undefined;
 
   return (
-    <Spotlight.Action renderRoot={renderRoot} onClick={onClick} className={classes.spotlightAction}>
+    <Spotlight.Action
+      renderRoot={renderRoot}
+      onClick={onClick}
+      closeSpotlightOnTrigger={interaction.type !== "children"}
+      className={classes.spotlightAction}
+    >
       <action.Component {...childrenOptions.option} />
     </Spotlight.Action>
   );

packages/spotlight/src/components/spotlight.tsx

@@ -140,7 +140,11 @@ const SpotlightWithActiveMode = ({ modeState, activeMode, defaultMode }: Spotlig
 
       <MantineSpotlight.ActionsList>
         {childrenOptions ? (
-          <SpotlightChildrenActions childrenOptions={childrenOptions} query={query} />
+          <SpotlightChildrenActions
+            childrenOptions={childrenOptions}
+            query={query}
+            setChildrenOptions={setChildrenOptions}
+          />
         ) : (
           <SpotlightActionGroups
             setMode={(mode) => {