7 files changed, 122 insertions, 0 deletions

diff --git a/packages/models/src/search/boolean-both-query.model.ts b/packages/models/src/search/boolean-both-query.model.ts
new file mode 100644
index 000000000..d6a438249
--- /dev/null
+++ b/packages/models/src/search/boolean-both-query.model.ts
@@ -0,0 +1,2 @@
+export type BooleanBothQuery = 'true' | 'false' | 'both'
+export type BooleanQuery = 'true' | 'false'
diff --git a/packages/models/src/search/index.ts b/packages/models/src/search/index.ts
new file mode 100644
index 000000000..5c4de1eea
--- /dev/null
+++ b/packages/models/src/search/index.ts
@@ -0,0 +1,6 @@
+export * from './boolean-both-query.model.js'
+export * from './search-target-query.model.js'
+export * from './videos-common-query.model.js'
+export * from './video-channels-search-query.model.js'
+export * from './video-playlists-search-query.model.js'
+export * from './videos-search-query.model.js'
diff --git a/packages/models/src/search/search-target-query.model.ts b/packages/models/src/search/search-target-query.model.ts
new file mode 100644
index 000000000..3bb2e0d31
--- /dev/null
+++ b/packages/models/src/search/search-target-query.model.ts
@@ -0,0 +1,5 @@
+export type SearchTargetType = 'local' | 'search-index'
+
+export interface SearchTargetQuery {
+  searchTarget?: SearchTargetType
+}
diff --git a/packages/models/src/search/video-channels-search-query.model.ts b/packages/models/src/search/video-channels-search-query.model.ts
new file mode 100644
index 000000000..7e84359cf
--- /dev/null
+++ b/packages/models/src/search/video-channels-search-query.model.ts
@@ -0,0 +1,18 @@
+import { SearchTargetQuery } from './search-target-query.model.js'
+
+export interface VideoChannelsSearchQuery extends SearchTargetQuery {
+  search?: string
+
+  start?: number
+  count?: number
+  sort?: string
+
+  host?: string
+  handles?: string[]
+}
+
+export interface VideoChannelsSearchQueryAfterSanitize extends VideoChannelsSearchQuery {
+  start: number
+  count: number
+  sort: string
+}
diff --git a/packages/models/src/search/video-playlists-search-query.model.ts b/packages/models/src/search/video-playlists-search-query.model.ts
new file mode 100644
index 000000000..65ac7b4d7
--- /dev/null
+++ b/packages/models/src/search/video-playlists-search-query.model.ts
@@ -0,0 +1,20 @@
+import { SearchTargetQuery } from './search-target-query.model.js'
+
+export interface VideoPlaylistsSearchQuery extends SearchTargetQuery {
+  search?: string
+
+  start?: number
+  count?: number
+  sort?: string
+
+  host?: string
+
+  // UUIDs or short UUIDs
+  uuids?: string[]
+}
+
+export interface VideoPlaylistsSearchQueryAfterSanitize extends VideoPlaylistsSearchQuery {
+  start: number
+  count: number
+  sort: string
+}
diff --git a/packages/models/src/search/videos-common-query.model.ts b/packages/models/src/search/videos-common-query.model.ts
new file mode 100644
index 000000000..45181a739
--- /dev/null
+++ b/packages/models/src/search/videos-common-query.model.ts
@@ -0,0 +1,45 @@
+import { VideoIncludeType } from '../videos/video-include.enum.js'
+import { VideoPrivacyType } from '../videos/video-privacy.enum.js'
+import { BooleanBothQuery } from './boolean-both-query.model.js'
+
+// These query parameters can be used with any endpoint that list videos
+export interface VideosCommonQuery {
+  start?: number
+  count?: number
+  sort?: string
+
+  nsfw?: BooleanBothQuery
+
+  isLive?: boolean
+
+  isLocal?: boolean
+  include?: VideoIncludeType
+
+  categoryOneOf?: number[]
+
+  licenceOneOf?: number[]
+
+  languageOneOf?: string[]
+
+  privacyOneOf?: VideoPrivacyType[]
+
+  tagsOneOf?: string[]
+  tagsAllOf?: string[]
+
+  hasHLSFiles?: boolean
+
+  hasWebtorrentFiles?: boolean // TODO: remove in v7
+  hasWebVideoFiles?: boolean
+
+  skipCount?: boolean
+
+  search?: string
+
+  excludeAlreadyWatched?: boolean
+}
+
+export interface VideosCommonQueryAfterSanitize extends VideosCommonQuery {
+  start: number
+  count: number
+  sort: string
+}
diff --git a/packages/models/src/search/videos-search-query.model.ts b/packages/models/src/search/videos-search-query.model.ts
new file mode 100644
index 000000000..bbaa8d23f
--- /dev/null
+++ b/packages/models/src/search/videos-search-query.model.ts
@@ -0,0 +1,26 @@
+import { SearchTargetQuery } from './search-target-query.model.js'
+import { VideosCommonQuery } from './videos-common-query.model.js'
+
+export interface VideosSearchQuery extends SearchTargetQuery, VideosCommonQuery {
+  search?: string
+
+  host?: string
+
+  startDate?: string // ISO 8601
+  endDate?: string // ISO 8601
+
+  originallyPublishedStartDate?: string // ISO 8601
+  originallyPublishedEndDate?: string // ISO 8601
+
+  durationMin?: number // seconds
+  durationMax?: number // seconds
+
+  // UUIDs or short UUIDs
+  uuids?: string[]
+}
+
+export interface VideosSearchQueryAfterSanitize extends VideosSearchQuery {
+  start: number
+  count: number
+  sort: string
+}