80 Commits

Author SHA1 Message Date
Blake
c56ecbef47 Update package.json 2024-03-10 14:23:57 -04:00
Blake
876d2cac0f Merge pull request #49 from pypp/feat/undocumented-backdrop-size
Add w500 size to backdrop
2024-03-10 04:10:01 -04:00
Blake
9dae7144b2 Merge pull request #50 from pypp/feat/trending-page-options
Add pageOption to the trending endpoint
2024-03-10 04:09:51 -04:00
Netanel Henya
f99dbac1d2 feat: add pageOption to the trending endpoint 2024-02-23 11:36:05 +02:00
Netanel Henya
43f5d16dc3 feat: added w500 size to backdrop, this size is not in the officel documentation but it still exists 2024-02-23 08:16:29 +02:00
Blake
682cf48cb0 Merge pull request #48 from blakejoy/chore/add-error-res
Feat: Add error response.
2024-01-15 12:02:07 -05:00
Blake Joynes
1146ca8ad2 add error. linting 2024-01-15 11:59:48 -05:00
Blake
6a68e9973b Merge pull request #46 from blakejoy/chore/v1.6
Update package.json
2023-12-28 21:32:30 -05:00
Blake
ad2b27ca72 Update package.json 2023-12-28 21:32:20 -05:00
Blake
76f62210be Merge pull request #42 from jeremyVignelles/fix/39-language-options
[i18n]Fixed all implemented methods that should allow LanguageOptions to be passed
2023-12-28 21:31:20 -05:00
Jérémy VIGNELLES
101457cdd7 Moved interfaces as requested 2023-11-16 14:22:17 +01:00
Jérémy VIGNELLES
7d4b3fcb60 Added languages options for genres 2023-11-16 13:41:45 +01:00
Jérémy VIGNELLES
eb53747570 Fix a bad union type typing 2023-11-16 13:41:44 +01:00
Jérémy VIGNELLES
8c615edbfa Fixed language options on all supported entrypoints 2023-11-16 13:41:35 +01:00
Blake
1628ea05bd Merge pull request #44 from blakejoy/blakejoy-patch-2
Update patch version
2023-11-14 01:13:18 -05:00
Blake
90b70a9c88 Update package.json 2023-11-14 01:13:04 -05:00
Blake
52c874b79f Merge pull request #41 from benlei/master
Adding company data, network data, tv show aggregate credits
2023-11-09 09:44:05 -05:00
Benjamin Lei
31f9cc3fac updating version 2023-09-06 17:19:21 -07:00
Benjamin Lei
d5013db314 adding tv networks 2023-09-01 19:27:15 -07:00
Benjamin Lei
8738ac7fda omit type like rest 2023-09-01 18:53:24 -07:00
Benjamin Lei
152e742883 fixing season aggregate credit type 2023-09-01 18:51:09 -07:00
Benjamin Lei
8c59fe859c format 2023-09-01 18:34:54 -07:00
Benjamin Lei
ab1925d32c adding in aggregate credits 2023-09-01 18:32:37 -07:00
Benjamin Lei
b11187c093 Need to also add in companies getter 2023-08-30 19:43:45 -07:00
Benjamin Lei
f605edf354 applying format 2023-08-30 17:58:37 -07:00
Benjamin Lei
caae3009d5 adding 2023-08-30 17:52:48 -07:00
Benjamin Lei
1c79599c41 Add company endpoints 2023-08-30 17:52:43 -07:00
Blake
d50ec7eb31 Merge pull request #37 from Der-Penz/endpoint/tv-season
Endpoint/tvSeason
2023-05-20 09:02:24 -04:00
DerPenz
f3469510c3 bumbed version : 1.4.0 2023-05-20 12:30:27 +02:00
DerPenz
0020057097 append to response tvSeason support 2023-05-15 13:30:52 +02:00
DerPenz
dbb93f5104 Merge branch 'master' into endpoint/tv-season 2023-05-15 13:13:20 +02:00
Blake
1b8138b971 Merge pull request #35 from Der-Penz/endpoint/tv-episode
Endpoint/tv episode
2023-05-13 16:38:47 -04:00
DerPenz
f6a5375c8c tv seasons endpoint 2023-05-08 17:11:56 +02:00
DerPenz
54cb13c23e bumbed version : 1.3.0 2023-05-06 19:32:14 +02:00
DerPenz
e46f140890 append to response support 2023-05-06 19:29:36 +02:00
DerPenz
33830afe92 refactored change type 2023-05-06 19:22:40 +02:00
DerPenz
9457dce115 base tv-episode integration 2023-05-06 18:57:20 +02:00
Blake
b0b6398169 Merge pull request #33 from xanderbarkhatov/feature/multi-search
Add multi-search, adjust types to allow type narrowing
2023-05-06 10:13:16 -04:00
Alexander B
5d9c61971d Merge branch 'master' of github.com:blakejoy/tmdb-ts into feature/multi-search 2023-05-04 21:38:37 +06:00
Alexander B
16c8b9e4ff chore: bump minor version 2023-05-04 21:35:22 +06:00
Blake
80a5e5e5bd Merge pull request #30 from Der-Penz/feature/append-result
Feature: append_to_result support
2023-05-04 07:49:39 -04:00
DerPenz
4b88e795f1 fixed wrong ImageConfiguration interface 2023-04-30 18:18:57 +02:00
Alexander B
da6427807f feat: add multi-search, adjust types to allow type narrowing 2023-04-28 20:26:34 +06:00
DerPenz
2e6cc38995 Merge branch 'master' into feature/append-result 2023-04-27 11:31:07 +02:00
DerPenz
738a0a7a24 version: 1.1.0 2023-04-27 11:30:34 +02:00
DerPenz
0a7590e989 fixed grammar mistakes 2023-04-27 11:27:12 +02:00
Blake
2705f52160 Merge pull request #32 from blakejoy/blakejoy-patch-1
Update README.md
2023-04-25 22:56:15 -04:00
Blake
2fed644950 Update README.md 2023-04-25 22:56:07 -04:00
DerPenz
bb5e9ad50f fixed bug with undefined second parameter 2023-04-22 15:44:17 +02:00
DerPenz
7d96ad04d1 full support for /person 2023-04-22 15:33:28 +02:00
DerPenz
cf7a561e3f full support for /movie and /tv 2023-04-21 20:59:12 +02:00
Blake
e5ce15d58d Merge pull request #28 from blakejoy/v1
feat: remove default export
2023-04-21 09:15:52 -04:00
Blake Joynes
7f98a557dc remove commented tsconfig 2023-04-20 06:27:35 -04:00
Blake Joynes
9e54e26e87 run prettier 2023-04-20 06:26:53 -04:00
DerPenz
cc41646798 append_to_response changes support 2023-04-19 20:23:16 +02:00
DerPenz
5927f95f0a format & combined equal changes type 2023-04-19 20:20:56 +02:00
DerPenz
a5acac981c support for most of the append_to_response options 2023-04-19 20:12:09 +02:00
DerPenz
4f5c39ba7a fixed wrong image type 2023-04-19 19:32:55 +02:00
Blake Joynes
69a883e845 remove default exports
major version 1.x
2023-04-16 15:39:45 -04:00
Blake Joynes
de2f76d257 add nvmrc \n update packages 2023-04-16 11:27:36 -04:00
Blake
af7dc02a07 Merge pull request #26 from blakejoy/feat/publish-npm
Create npm-publish.yml
2023-04-15 14:52:19 -04:00
Blake
6e111921b5 Create npm-publish.yml 2023-04-15 14:51:27 -04:00
Blake
c95a66baae Merge pull request #23 from Der-Penz/refactor/parsing-options-superclass
Refactor/ moved parsing of parameters into superclass
2023-04-15 14:47:56 -04:00
DerPenz
f3f4868ef8 version: 0.2.0 2023-04-15 20:22:45 +02:00
DerPenz
6bcddc62f1 Merge branch 'master' into refactor/parsing-options-superclass 2023-04-15 18:38:17 +02:00
DerPenz
2b26b7b848 run npm format 2023-04-15 18:32:53 +02:00
DerPenz
6c361002bf Squashed commit of the following:
commit 5d38a76997
Merge: 7cccdb9 f160e23
Author: Blake <blakejoy@users.noreply.github.com>
Date:   Sat Apr 15 11:44:39 2023 -0400

    Merge pull request #22 from blakejoy/feat/add_linting

    feat - add linting and prettier

commit f160e2362c
Author: Blake Joynes <blakejoynes@gmail.com>
Date:   Sat Apr 15 11:44:00 2023 -0400

    add pre commit hook

commit 0fd8317884
Merge: bc91674 d1e87ba
Author: Blake Joynes <blakejoynes@gmail.com>
Date:   Sat Apr 15 11:41:28 2023 -0400

    add husky

commit bc91674c4b
Author: Blake Joynes <blakejoynes@gmail.com>
Date:   Sat Apr 15 11:39:24 2023 -0400

    add husky

commit d1e87ba7be
Author: Blake <blakejoy@users.noreply.github.com>
Date:   Fri Apr 14 08:48:33 2023 -0400

    Update .prettierrc

commit d064d4d86f
Author: Blake Joynes <blakejoynes@gmail.com>
Date:   Fri Apr 14 03:09:39 2023 -0400

    turn off linebreak rules

commit 06155bd323
Author: Blake Joynes <blakejoynes@gmail.com>
Date:   Thu Apr 13 21:58:41 2023 -0400

    add linting and prettier
2023-04-15 18:32:06 +02:00
Blake
6fd471b921 Merge pull request #24 from blakejoy/update_any_types
fix warnings for any type
2023-04-15 12:20:25 -04:00
Blake Joynes
60a2f8e00e update version 2023-04-15 12:17:50 -04:00
Blake Joynes
933ebf25a3 fix warnings for any type 2023-04-15 12:16:57 -04:00
Blake
5d38a76997 Merge pull request #22 from blakejoy/feat/add_linting
feat - add linting and prettier
2023-04-15 11:44:39 -04:00
Blake Joynes
f160e2362c add pre commit hook 2023-04-15 11:44:00 -04:00
Blake Joynes
0fd8317884 add husky 2023-04-15 11:41:28 -04:00
Blake Joynes
bc91674c4b add husky 2023-04-15 11:39:24 -04:00
DerPenz
562864a70f removed unused parameter parsing 2023-04-14 16:01:35 +02:00
DerPenz
1200064194 moved option parsing in superclass 'get' method 2023-04-14 15:54:27 +02:00
Blake
d1e87ba7be Update .prettierrc 2023-04-14 08:48:33 -04:00
Blake Joynes
d064d4d86f turn off linebreak rules 2023-04-14 03:09:39 -04:00
Blake Joynes
06155bd323 add linting and prettier 2023-04-13 21:58:41 -04:00
Blake
7cccdb9929 Merge pull request #20 from blakejoy/blakejoy-patch_v0.1.8
Update package.json
2023-04-13 06:56:05 -04:00
57 changed files with 3874 additions and 2440 deletions

View File

@@ -2,42 +2,21 @@ module.exports = {
env: {
browser: false,
es2021: true,
node: true,
},
extends: [
'plugin:@typescript-eslint/recommended',
"eslint:recommended",
"plugin:@typescript-eslint/eslint-recommended",
"plugin:@typescript-eslint/recommended",
"prettier",
],
parser: '@typescript-eslint/parser',
parser: "@typescript-eslint/parser",
parserOptions: {
ecmaVersion: 12,
sourceType: 'module',
sourceType: "module",
},
plugins: [
'@typescript-eslint',
],
rules: {
'@typescript-eslint/no-var-requires': 'off',
'@typescript-eslint/no-explicit-any': 'off',
'@typescript-eslint/interface-name-prefix': 'off',
'@typescript-eslint/no-non-null-assertion': 'off',
'@typescript-eslint/no-use-before-define': 'off',
'@typescript-eslint/no-empty-interface': 'off',
'@typescript-eslint/explicit-function-return-type': ['warn', { allowExpressions: true }],
indent: 'off',
'@typescript-eslint/indent': ['error', 2],
'no-trailing-spaces': 'error',
quotes: ['error', 'single', { allowTemplateLiterals: true }],
semi: ['error', 'always'],
'spaced-comment': ['error', 'always'],
'no-irregular-whitespace': ['error', { 'skipComments': true }],
'space-infix-ops': 'error',
'array-bracket-spacing': 'error',
'object-curly-spacing': ['error', 'always'],
'space-before-function-paren': ['error', {
named: 'never',
anonymous: 'never',
asyncArrow: 'always',
}],
'comma-dangle': ['warn', 'always-multiline'],
'no-multiple-empty-lines': 'error',
rules:{
'linebreak-style': ['off', 'unix'],
},
plugins: ["@typescript-eslint"],
};

33
.github/workflows/npm-publish.yml vendored Normal file
View File

@@ -0,0 +1,33 @@
# This workflow will run tests using node and then publish a package to GitHub Packages when a release is created
# For more information see: https://docs.github.com/en/actions/publishing-packages/publishing-nodejs-packages
name: Node.js Package
on:
release:
types: [created]
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- uses: actions/setup-node@v3
with:
node-version: 16
- run: npm ci
- run: npm test
publish-npm:
needs: build
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- uses: actions/setup-node@v3
with:
node-version: 16
registry-url: https://registry.npmjs.org/
- run: npm ci
- run: npm publish
env:
NODE_AUTH_TOKEN: ${{secrets.npm_token}}

4
.husky/pre-commit Executable file
View File

@@ -0,0 +1,4 @@
#!/usr/bin/env sh
. "$(dirname -- "$0")/_/husky.sh"
npm run lint

1
.nvmrc Normal file
View File

@@ -0,0 +1 @@
v18.16.0

3
.prettierignore Normal file
View File

@@ -0,0 +1,3 @@
dist
node_modules
.github

12
.prettierrc Normal file
View File

@@ -0,0 +1,12 @@
{
"printWidth": 80,
"tabWidth": 2,
"useTabs": false,
"semi": true,
"singleQuote": true,
"trailingComma": "es5",
"bracketSpacing": true,
"arrowParens": "always",
"proseWrap": "never",
"htmlWhitespaceSensitivity": "strict"
}

View File

@@ -14,8 +14,10 @@ Installation:
npm install --save tmdb-ts
``
Version 1.0 removed the default import so make sure you update accordingly!
```js
import TMDB from 'tmdb-ts';
import { TMDB } from 'tmdb-ts';
const tmdb = new TMDB('accessToken');

4170
package-lock.json generated

File diff suppressed because it is too large Load Diff

View File

@@ -1,15 +1,15 @@
{
"name": "tmdb-ts",
"version": "0.1.8",
"version": "1.7.0",
"description": "TMDB v3 library wrapper",
"main": "dist/index.js",
"types": "dist/index.d.ts",
"scripts": {
"compile": "rm -rf dist && tsc -d && npm run copy-types",
"compile": "rm -rf dist && tsc -d",
"lint": "eslint --ext .ts src/",
"lint:fix": "eslint --ext .ts src/ --fix",
"prepublish": "tsc",
"copy-types": "mkdir dist/types && cp src/types/*.d.ts dist/types"
"format": "npx prettier --write src",
"pre-commit": "npm run lint"
},
"bugs": {
"url": "https://github.com/blakejoy/tmdb-ts/issues",
@@ -29,24 +29,32 @@
"author": "Blake Joynes",
"license": "MIT",
"devDependencies": {
"@types/node": "^15.3.0",
"@types/node": "^18.15.11",
"@types/node-fetch": "^2.5.10",
"@typescript-eslint/eslint-plugin": "^4.23.0",
"@typescript-eslint/parser": "^4.23.0",
"@typescript-eslint/eslint-plugin": "^5.58.0",
"@typescript-eslint/parser": "^5.58.0",
"dotenv": "^9.0.2",
"eslint": "^7.26.0",
"eslint-config-airbnb-base": "^14.2.1",
"eslint-plugin-import": "^2.23.1",
"ts-node": "^9.1.1",
"typescript": "^4.2.4"
"eslint": "^8.38.0",
"eslint-config-airbnb-typescript": "^17.0.0",
"eslint-config-prettier": "^8.8.0",
"eslint-plugin-prettier": "^4.2.1",
"husky": "^8.0.3",
"prettier": "^2.8.7",
"ts-node": "^10.9.1",
"typescript": "^4.9.5"
},
"dependencies": {
"cross-fetch": "^3.1.4"
},
"volta": {
"node": "15.13.0",
"yarn": "1.19.2",
"npm": "7.12.1"
"node": "18.16.0",
"yarn": "1.22.4",
"npm": "9.5.1"
},
"husky": {
"hooks": {
"pre-commit": "npm run pre-commit"
}
},
"files": [
"dist"

View File

@@ -1,20 +1,28 @@
import fetch from 'cross-fetch';
import { parseOptions } from './utils';
import { ErrorResponse } from './types';
const BASE_URL_V3 = 'https://api.themoviedb.org/3';
export default class Api {
export class Api {
constructor(private accessToken: string) {
this.accessToken = accessToken;
}
async get<T>(path: string): Promise<T> {
const response = await fetch(`${BASE_URL_V3}${path}`, {
async get<T>(path: string, options?: Record<string, any>): Promise<T> {
const params = parseOptions(options);
const response = await fetch(`${BASE_URL_V3}${path}?${params}`, {
method: 'GET',
headers: {
Authorization: `Bearer ${this.accessToken}`,
'Content-Type': 'application/json;charset=utf-8',
},
});
return await response.json() as T;
if (!response.ok) {
return Promise.reject((await response.json()) as ErrorResponse);
}
return (await response.json()) as T;
}
}

View File

@@ -1,11 +1,12 @@
import { BaseEndpoint } from './base';
import { AccountDetails } from '../types/account';
export class AccountEndpoint extends BaseEndpoint {
constructor(accessToken: string) {
super(accessToken);
}
async details(): Promise<any> {
async details(): Promise<AccountDetails> {
return await this.api.get('/account');
}
}

View File

@@ -1,4 +1,4 @@
import Api from '../api';
import { Api } from '../api';
export class BaseEndpoint {
protected api: Api;

View File

@@ -1,4 +1,4 @@
import { BaseEndpoint } from './base';
import { BaseEndpoint } from './base';
import { Certifications } from '../types/certification';
export class CertificationEndpoint extends BaseEndpoint {

View File

@@ -1,25 +1,20 @@
import { ChangeOption, MediaChanges } from '../types';
import { BaseEndpoint } from './base';
import { ChangeOptions, Changes } from '../types/changes';
import { parseOptions } from '../utils';
export class ChangeEndpoint extends BaseEndpoint {
constructor(protected readonly accessToken: string) {
super(accessToken);
}
async movies(options?: ChangeOptions): Promise<Changes> {
const params = parseOptions(options);
return await this.api.get<Changes>(`/movie/changes?${params}`);
async movies(options?: ChangeOption): Promise<MediaChanges> {
return await this.api.get<MediaChanges>(`/movie/changes`, options);
}
async tvShows(options?: ChangeOptions): Promise<Changes> {
const params = parseOptions(options);
return await this.api.get<Changes>(`/tv/changes?${params}`);
async tvShows(options?: ChangeOption): Promise<MediaChanges> {
return await this.api.get<MediaChanges>(`/tv/changes`, options);
}
async person(options?: ChangeOptions): Promise<Changes> {
const params = parseOptions(options);
return await this.api.get<Changes>(`/person/changes${params}`);
async person(options?: ChangeOption): Promise<MediaChanges> {
return await this.api.get<MediaChanges>(`/person/change`, options);
}
}

View File

@@ -1,6 +1,11 @@
import { DetailedCollection, ImageCollection, LanguageOption, Translations } from '../types';
import { parseOptions } from '../utils';
import { BaseEndpoint } from './base';
import {
CollectionImageOptions,
DetailedCollection,
ImageCollection,
LanguageOption,
Translations,
} from '../types';
import { BaseEndpoint } from './base';
const BASE_COLLECTION = '/collection';
@@ -9,18 +14,37 @@ export class CollectionsEndpoint extends BaseEndpoint {
super(accessToken);
}
async details(id: number, options? : LanguageOption): Promise<DetailedCollection> {
const params = parseOptions(options);
return await this.api.get<DetailedCollection>(`${BASE_COLLECTION}/${id}?${params}`);
async details(
id: number,
options?: LanguageOption
): Promise<DetailedCollection> {
return await this.api.get<DetailedCollection>(
`${BASE_COLLECTION}/${id}`,
options
);
}
async images(id: number, options? : LanguageOption): Promise<ImageCollection> {
const params = parseOptions(options);
return await this.api.get<ImageCollection>(`${BASE_COLLECTION}/${id}/images?${params}`);
async images(
id: number,
options?: CollectionImageOptions
): Promise<ImageCollection> {
const computedOptions = {
include_image_language: options?.include_image_language?.join(','),
language: options?.language,
};
return await this.api.get<ImageCollection>(
`${BASE_COLLECTION}/${id}/images`,
computedOptions
);
}
async translations(id: number, options? : LanguageOption): Promise<Translations> {
const params = parseOptions(options);
return await this.api.get<Translations>(`${BASE_COLLECTION}/${id}/translations?${params}`);
async translations(
id: number,
options?: LanguageOption
): Promise<Translations> {
return await this.api.get<Translations>(
`${BASE_COLLECTION}/${id}/translations`,
options
);
}
}
}

View File

@@ -0,0 +1,26 @@
import {
CompanyDetails,
AlternativeNames,
CompanyImages,
} from './../types/companies';
import { BaseEndpoint } from './base';
export class CompaniesEndpoint extends BaseEndpoint {
constructor(protected readonly accessToken: string) {
super(accessToken);
}
async details(id: number): Promise<CompanyDetails> {
return await this.api.get<CompanyDetails>(`/company/${id}`);
}
async alternativeNames(id: number): Promise<AlternativeNames> {
return await this.api.get<AlternativeNames>(
`/company/${id}/alternative_names`
);
}
async images(id: number): Promise<CompanyImages> {
return await this.api.get<CompanyImages>(`/company/${id}/images`);
}
}

View File

@@ -9,5 +9,4 @@ export class ConfigurationEndpoint extends BaseEndpoint {
async getCurrent(): Promise<Configuration> {
return await this.api.get<Configuration>(`/configuration`);
}
}

View File

@@ -1,7 +1,6 @@
import { BaseEndpoint } from './base';
import { CreditResponse } from '../types/credits';
export class CreditsEndpoint extends BaseEndpoint {
constructor(protected readonly accessToken: string) {
super(accessToken);
@@ -10,5 +9,4 @@ export class CreditsEndpoint extends BaseEndpoint {
async getById(id: string): Promise<CreditResponse> {
return await this.api.get<CreditResponse>(`/credit/${id}`);
}
}

View File

@@ -1,5 +1,8 @@
import { MovieDiscoverResult, SortOption, TvShowDiscoverResult } from '../types';
import { parseOptions } from '../utils';
import {
MovieDiscoverResult,
SortOption,
TvShowDiscoverResult,
} from '../types';
import { BaseEndpoint } from './base';
const BASE_DISCOVER = '/discover';
@@ -26,7 +29,7 @@ interface DiscoverQueryOptions {
with_companies?: string;
}
interface MovieQueryOptions extends DiscoverQueryOptions{
interface MovieQueryOptions extends DiscoverQueryOptions {
region?: string;
certification_country?: string;
certification?: string;
@@ -46,7 +49,7 @@ interface MovieQueryOptions extends DiscoverQueryOptions{
with_people?: string;
}
interface TvShowQueryOptions extends DiscoverQueryOptions{
interface TvShowQueryOptions extends DiscoverQueryOptions {
'air_date.gte'?: string;
'air_date.lte'?: string;
'first_air_date.gte'?: string;
@@ -66,12 +69,16 @@ export class DiscoverEndpoint extends BaseEndpoint {
}
async movie(options?: MovieQueryOptions): Promise<MovieDiscoverResult> {
const params = parseOptions(options);
return await this.api.get<MovieDiscoverResult>(`${BASE_DISCOVER}/movie?${params}`);
return await this.api.get<MovieDiscoverResult>(
`${BASE_DISCOVER}/movie`,
options
);
}
async tvShow(options?: TvShowQueryOptions): Promise<TvShowDiscoverResult> {
const params = parseOptions(options);
return await this.api.get<TvShowDiscoverResult>(`${BASE_DISCOVER}/tv?${params}`);
return await this.api.get<TvShowDiscoverResult>(
`${BASE_DISCOVER}/tv`,
options
);
}
}

View File

@@ -1,14 +1,15 @@
import { BaseEndpoint } from './base';
import { ExternalIdOptions, FindResult } from '../types';
import { parseOptions } from '../utils';
export class FindEndpoint extends BaseEndpoint {
constructor(accessToken: string) {
super(accessToken);
}
async byId(externalId: string, options: ExternalIdOptions): Promise<FindResult> {
const params = parseOptions(options);
return await this.api.get<FindResult>(`/find/${externalId}?${params}`);
async byId(
externalId: string,
options: ExternalIdOptions
): Promise<FindResult> {
return await this.api.get<FindResult>(`/find/${externalId}`, options);
}
}

View File

@@ -1,7 +1,8 @@
import { BaseEndpoint } from './base';
import { LanguageOption } from '../types';
import { BaseEndpoint } from './base';
export interface Genres {
genres: Array<{id: number, name: string}>
genres: Array<{ id: number; name: string }>;
}
export class GenreEndpoint extends BaseEndpoint {
@@ -9,11 +10,11 @@ export class GenreEndpoint extends BaseEndpoint {
super(accessToken);
}
async movies(): Promise<Genres> {
return await this.api.get<Genres>('/genre/movie/list');
async movies(options?: LanguageOption): Promise<Genres> {
return await this.api.get<Genres>('/genre/movie/list', options);
}
async tvShows(): Promise<Genres> {
return await this.api.get<Genres>('/genre/tv/list');
async tvShows(options?: LanguageOption): Promise<Genres> {
return await this.api.get<Genres>('/genre/tv/list', options);
}
}

View File

@@ -1,5 +1,3 @@
export * from './account';
export * from './certification';
export * from './changes';
@@ -16,4 +14,5 @@ export * from './trending';
export * from './find';
export * from './keywords';
export * from './collections';
export * from './tv-seasons';
export * from './tv-episode';

View File

@@ -1,6 +1,5 @@
import { BaseEndpoint } from './base';
import { BelongingMovies, Keyword, KeywordsOptions } from '../types';
import { parseOptions } from '../utils';
const BASE_Keyword = '/keyword';
@@ -9,12 +8,17 @@ export class KeywordsEndpoint extends BaseEndpoint {
super(accessToken);
}
async details(keywordId : number): Promise<Keyword> {
async details(keywordId: number): Promise<Keyword> {
return await this.api.get<Keyword>(`${BASE_Keyword}/${keywordId}`);
}
async belongingMovies(keywordId : number, options?: KeywordsOptions): Promise<BelongingMovies> {
const params = parseOptions(options);
return await this.api.get<BelongingMovies>(`${BASE_Keyword}/${keywordId}/movies?${params}`);
async belongingMovies(
keywordId: number,
options?: KeywordsOptions
): Promise<BelongingMovies> {
return await this.api.get<BelongingMovies>(
`${BASE_Keyword}/${keywordId}/movies`,
options
);
}
}

View File

@@ -1,14 +1,17 @@
import { BaseEndpoint } from './base';
import {
AlternativeTitles,
ChangeOptions,
AppendToResponse,
AppendToResponseMovieKey,
ChangeOption,
Changes,
Credits,
ExternalIds,
Images,
Keywords,
LanguageOption,
LatestMovie,
MovieChanges,
MovieChangeValue,
MovieDetails,
MovieLists,
MoviesPlayingNow,
@@ -19,112 +22,177 @@ import {
ReleaseDates,
Reviews,
SimilarMovies,
TopRatedMovies, Translations,
TopRatedMovies,
Translations,
UpcomingMovies,
Videos,
WatchProviders,
} from '../types';
import { parseOptions } from '../utils';
const BASE_MOVIE = '/movie';
export class MoviesEndpoint extends BaseEndpoint{
export interface MoviesImageSearchOptions extends LanguageOption {
/**
* a list of ISO-639-1 values to query
*/
include_image_language?: string[];
}
export class MoviesEndpoint extends BaseEndpoint {
constructor(protected readonly accessToken: string) {
super(accessToken);
}
async details(id: number): Promise<MovieDetails>{
return await this.api.get<MovieDetails>(`${BASE_MOVIE}/${id}`);
async details<T extends AppendToResponseMovieKey[] | undefined>(
id: number,
appendToResponse?: T,
language?: string
) {
const options = {
append_to_response: appendToResponse
? appendToResponse.join(',')
: undefined,
language: language,
};
return await this.api.get<AppendToResponse<MovieDetails, T, 'movie'>>(
`${BASE_MOVIE}/${id}`,
options
);
}
async alternativeTitles(id: number): Promise<AlternativeTitles>{
return await this.api.get<AlternativeTitles>(`${BASE_MOVIE}/${id}/alternative_titles`);
async alternativeTitles(id: number): Promise<AlternativeTitles> {
return await this.api.get<AlternativeTitles>(
`${BASE_MOVIE}/${id}/alternative_titles`
);
}
async changes(id: number, options?: ChangeOptions): Promise<MovieChanges>{
const params = parseOptions(options);
return await this.api.get<MovieChanges>(`${BASE_MOVIE}/${id}/changes?${params}`);
async changes(
id: number,
options?: ChangeOption
): Promise<Changes<MovieChangeValue>> {
return await this.api.get<Changes<MovieChangeValue>>(
`${BASE_MOVIE}/${id}/changes`,
options
);
}
async credits(id: number): Promise<Credits>{
return await this.api.get<Credits>(`${BASE_MOVIE}/${id}/credits`);
async credits(id: number, options?: LanguageOption): Promise<Credits> {
return await this.api.get<Credits>(`${BASE_MOVIE}/${id}/credits`, options);
}
async externalIds(id: number): Promise<ExternalIds>{
async externalIds(id: number): Promise<ExternalIds> {
return await this.api.get<ExternalIds>(`${BASE_MOVIE}/${id}/external_ids`);
}
async images(id: number): Promise<Images>{
return await this.api.get<Images>(`${BASE_MOVIE}/${id}/images`);
async images(
id: number,
options?: MoviesImageSearchOptions
): Promise<Images> {
const computedOptions = {
include_image_language: options?.include_image_language?.join(','),
language: options?.language,
};
return await this.api.get<Images>(
`${BASE_MOVIE}/${id}/images`,
computedOptions
);
}
async keywords(id: number): Promise<Keywords>{
async keywords(id: number): Promise<Keywords> {
return await this.api.get<Keywords>(`${BASE_MOVIE}/${id}/keywords`);
}
async lists(id: number, options?: LanguageOption | PageOption): Promise<MovieLists>{
const params = parseOptions(options);
return await this.api.get<MovieLists>(`${BASE_MOVIE}/${id}/lists?${params}`);
async lists(
id: number,
options?: LanguageOption & PageOption
): Promise<MovieLists> {
return await this.api.get<MovieLists>(`${BASE_MOVIE}/${id}/lists`, options);
}
async recommendations(id: number, options?: PageOption): Promise<Recommendations>{
const params = parseOptions(options);
return await this.api.get<Recommendations>(`${BASE_MOVIE}/${id}/recommendations?${params}`);
async recommendations(
id: number,
options?: LanguageOption & PageOption
): Promise<Recommendations> {
return await this.api.get<Recommendations>(
`${BASE_MOVIE}/${id}/recommendations`,
options
);
}
async releaseDates(id: number): Promise<ReleaseDates>{
return await this.api.get<ReleaseDates>(`${BASE_MOVIE}/${id}/release_dates`);
async releaseDates(id: number): Promise<ReleaseDates> {
return await this.api.get<ReleaseDates>(
`${BASE_MOVIE}/${id}/release_dates`
);
}
async reviews(id: number, options?: PageOption): Promise<Reviews>{
const params = parseOptions(options);
return await this.api.get<Reviews>(`${BASE_MOVIE}/${id}/reviews?${params}`);
async reviews(
id: number,
options?: LanguageOption & PageOption
): Promise<Reviews> {
return await this.api.get<Reviews>(`${BASE_MOVIE}/${id}/reviews`, options);
}
async similar(id: number, options?: PageOption): Promise<SimilarMovies>{
const params = parseOptions(options);
return await this.api.get<SimilarMovies>(`${BASE_MOVIE}/${id}/similar?${params}`);
async similar(
id: number,
options?: LanguageOption & PageOption
): Promise<SimilarMovies> {
return await this.api.get<SimilarMovies>(
`${BASE_MOVIE}/${id}/similar`,
options
);
}
async translations(id: number): Promise<Translations>{
async translations(id: number): Promise<Translations> {
return await this.api.get<Translations>(`${BASE_MOVIE}/${id}/translations`);
}
async videos(id: number): Promise<Videos>{
return await this.api.get<Videos>(`${BASE_MOVIE}/${id}/videos`);
async videos(id: number, options?: LanguageOption): Promise<Videos> {
return await this.api.get<Videos>(`${BASE_MOVIE}/${id}/videos`, options);
}
/**
* Powered by JustWatch
* @param id
*/
async watchProviders(id: number): Promise<WatchProviders>{
return await this.api.get<WatchProviders>(`${BASE_MOVIE}/${id}/watch/providers`);
async watchProviders(id: number): Promise<WatchProviders> {
return await this.api.get<WatchProviders>(
`${BASE_MOVIE}/${id}/watch/providers`
);
}
async latest(): Promise<LatestMovie>{
async latest(): Promise<LatestMovie> {
return await this.api.get<LatestMovie>(`${BASE_MOVIE}/latest`);
}
async nowPlaying(options?: PageOption & LanguageOption & RegionOption): Promise<MoviesPlayingNow>{
const params = parseOptions(options);
return await this.api.get<MoviesPlayingNow>(`${BASE_MOVIE}/now_playing?${params}`);
async nowPlaying(
options?: PageOption & LanguageOption & RegionOption
): Promise<MoviesPlayingNow> {
return await this.api.get<MoviesPlayingNow>(
`${BASE_MOVIE}/now_playing`,
options
);
}
async popular(options?: PageOption): Promise<PopularMovies>{
const params = parseOptions(options);
return await this.api.get<PopularMovies>(`${BASE_MOVIE}/popular?${params}`);
async popular(options?: LanguageOption & PageOption): Promise<PopularMovies> {
return await this.api.get<PopularMovies>(`${BASE_MOVIE}/popular`, options);
}
async topRated(options?: PageOption & LanguageOption & RegionOption): Promise<TopRatedMovies>{
const params = parseOptions(options);
return await this.api.get<TopRatedMovies>(`${BASE_MOVIE}/top_rated?${params}`);
async topRated(
options?: PageOption & LanguageOption & RegionOption
): Promise<TopRatedMovies> {
return await this.api.get<TopRatedMovies>(
`${BASE_MOVIE}/top_rated`,
options
);
}
async upcoming(options?: PageOption & LanguageOption & RegionOption): Promise<UpcomingMovies>{
const params = parseOptions(options);
return await this.api.get<UpcomingMovies>(`${BASE_MOVIE}/upcoming?${params}`);
async upcoming(
options?: PageOption & LanguageOption & RegionOption
): Promise<UpcomingMovies> {
return await this.api.get<UpcomingMovies>(
`${BASE_MOVIE}/upcoming`,
options
);
}
}

23
src/endpoints/networks.ts Normal file
View File

@@ -0,0 +1,23 @@
import { NetworkDetails, NetworkImages } from '..';
import { AlternativeNames } from './../types/companies';
import { BaseEndpoint } from './base';
export class NetworksEndpoint extends BaseEndpoint {
constructor(protected readonly accessToken: string) {
super(accessToken);
}
async details(id: number): Promise<NetworkDetails> {
return await this.api.get<NetworkDetails>(`/network/${id}`);
}
async alternativeNames(id: number): Promise<AlternativeNames> {
return await this.api.get<AlternativeNames>(
`/network/${id}/alternative_names`
);
}
async images(id: number): Promise<NetworkImages> {
return await this.api.get<NetworkImages>(`/network/${id}/images`);
}
}

View File

@@ -1,18 +1,21 @@
import {
ChangeOptions,
AppendToResponse,
AppendToResponsePersonKey,
ChangeOption,
ExternalIds,
Image,
PageOption,
PeopleTranslations,
PersonChanges,
PeopleImages,
PersonTranslations,
PersonCombinedCredits,
PersonDetail,
PersonDetails,
PersonMovieCredit,
PersonTvShowCredit,
PopularPersons,
TaggedImages,
Changes,
PersonChangeValue,
LanguageOption,
} from '../types';
import { parseOptions } from '../utils';
import { BaseEndpoint } from './base';
const BASE_PERSON = '/person';
@@ -22,50 +25,94 @@ export class PeopleEndpoint extends BaseEndpoint {
super(accessToken);
}
async details(id: number): Promise<PersonDetail> {
return await this.api.get<PersonDetail>(`${BASE_PERSON}/${id}`);
async details<T extends AppendToResponsePersonKey[] | undefined>(
id: number,
appendToResponse?: T,
language?: string
) {
const options = {
append_to_response: appendToResponse
? appendToResponse.join(',')
: undefined,
language: language,
};
return await this.api.get<AppendToResponse<PersonDetails, T, 'person'>>(
`${BASE_PERSON}/${id}`,
options
);
}
async changes(id: number, options? : ChangeOptions): Promise<PersonChanges> {
const params = parseOptions(options);
return await this.api.get<PersonChanges>(`${BASE_PERSON}/${id}/changes?${params}`);
async changes(
id: number,
options?: ChangeOption
): Promise<Changes<PersonChangeValue>> {
return await this.api.get<Changes<PersonChangeValue>>(
`${BASE_PERSON}/${id}/changes`,
options
);
}
async movieCredits(id: number): Promise<PersonMovieCredit> {
return await this.api.get<PersonMovieCredit>(`${BASE_PERSON}/${id}/movie_credits`);
async movieCredits(
id: number,
options?: LanguageOption
): Promise<PersonMovieCredit> {
return await this.api.get<PersonMovieCredit>(
`${BASE_PERSON}/${id}/movie_credits`,
options
);
}
async tvShowCredits(id: number): Promise<PersonTvShowCredit> {
return await this.api.get<PersonTvShowCredit>(`${BASE_PERSON}/${id}/tv_credits`);
async tvShowCredits(
id: number,
options?: LanguageOption
): Promise<PersonTvShowCredit> {
return await this.api.get<PersonTvShowCredit>(
`${BASE_PERSON}/${id}/tv_credits`,
options
);
}
async combinedCredits(id: number) : Promise<PersonCombinedCredits> {
return await this.api.get<PersonCombinedCredits>(`${BASE_PERSON}/${id}/combined_credits`);
async combinedCredits(
id: number,
options?: LanguageOption
): Promise<PersonCombinedCredits> {
return await this.api.get<PersonCombinedCredits>(
`${BASE_PERSON}/${id}/combined_credits`,
options
);
}
async externalId(id: number): Promise<ExternalIds>{
async externalId(id: number): Promise<ExternalIds> {
return await this.api.get<ExternalIds>(`${BASE_PERSON}/${id}/external_ids`);
}
async images(id: number): Promise<{id: number, profiles: Image[]}>{
return await this.api.get<{id: number, profiles: Image[]}>(`${BASE_PERSON}/${id}/images`);
async images(id: number): Promise<PeopleImages> {
return await this.api.get<PeopleImages>(`${BASE_PERSON}/${id}/images`);
}
async taggedImages(id: number, options?: PageOption): Promise<TaggedImages>{
const params = parseOptions(options);
return await this.api.get<TaggedImages>(`${BASE_PERSON}/${id}/tagged_images?${params}`);
async taggedImages(id: number, options?: PageOption): Promise<TaggedImages> {
return await this.api.get<TaggedImages>(
`${BASE_PERSON}/${id}/tagged_images`,
options
);
}
async translation(id: number) : Promise<PeopleTranslations>{
return await this.api.get<PeopleTranslations>(`${BASE_PERSON}/${id}/translations`);
async translation(id: number): Promise<PersonTranslations> {
return await this.api.get<PersonTranslations>(
`${BASE_PERSON}/${id}/translations`
);
}
async latest(): Promise<PersonDetail>{
return await this.api.get<PersonDetail>(`${BASE_PERSON}/latest`);
async latest(): Promise<PersonDetails> {
return await this.api.get<PersonDetails>(`${BASE_PERSON}/latest`);
}
async popular(options?: PageOption): Promise<PopularPersons>{
const params = parseOptions(options);
return await this.api.get<PopularPersons>(`${BASE_PERSON}/popular?${params}`);
async popular(
options?: LanguageOption & PageOption
): Promise<PopularPersons> {
return await this.api.get<PopularPersons>(
`${BASE_PERSON}/popular`,
options
);
}
}

View File

@@ -1,7 +1,15 @@
import { BaseEndpoint } from './base';
import { Search } from '../types/search';
import { Collection, Company, Movie, Person, TV } from '../types';
import { parseOptions } from '../utils';
import { MultiSearchResult, Search } from '../types/search';
import {
Collection,
Company,
LanguageOption,
Movie,
PageOption,
Person,
RegionOption,
TV,
} from '../types';
const BASE_SEARCH = '/search';
@@ -10,18 +18,44 @@ export interface SearchOptions {
page?: number;
}
export interface MovieSearchOptions extends SearchOptions {
export interface MovieSearchOptions
extends SearchOptions,
LanguageOption,
PageOption,
RegionOption {
include_adult?: boolean;
year?: number;
primary_release_year?: number;
}
export interface TvSearchOptions extends SearchOptions{
export interface CollectionSearchOptions
extends SearchOptions,
LanguageOption,
PageOption,
RegionOption {
include_adult?: boolean;
}
export interface TvSearchOptions
extends SearchOptions,
LanguageOption,
PageOption {
include_adult?: boolean;
year?: number;
first_air_date_year?: number;
}
export interface PeopleSearchOptions extends SearchOptions{
export interface PeopleSearchOptions
extends SearchOptions,
LanguageOption,
PageOption {
include_adult?: boolean;
}
export interface MultiSearchOptions
extends SearchOptions,
LanguageOption,
PageOption {
include_adult?: boolean;
}
@@ -30,35 +64,45 @@ export class SearchEndpoint extends BaseEndpoint {
super(accessToken);
}
async companies(options: SearchOptions): Promise<Search<Company>>{
const params = parseOptions(options);
return await this.api.get<Search<Company>>(`${BASE_SEARCH}/company?${params}`);
async companies(options: SearchOptions): Promise<Search<Company>> {
return await this.api.get<Search<Company>>(
`${BASE_SEARCH}/company`,
options
);
}
async collections(options: SearchOptions): Promise<Search<Collection>>{
const params = parseOptions(options);
return await this.api.get<Search<Collection>>(`${BASE_SEARCH}/collection?${params}`);
async collections(options: SearchOptions): Promise<Search<Collection>> {
return await this.api.get<Search<Collection>>(
`${BASE_SEARCH}/collection`,
options
);
}
async keywords(options: SearchOptions): Promise<Search<{ id: string, name: string }>>{
const params = parseOptions(options);
return await this.api.get<Search<{ id: string, name: string }>>(`${BASE_SEARCH}/keyword?${params}`);
async keywords(
options: SearchOptions
): Promise<Search<{ id: string; name: string }>> {
return await this.api.get<Search<{ id: string; name: string }>>(
`${BASE_SEARCH}/keyword`,
options
);
}
async movies(options: MovieSearchOptions): Promise<Search<Movie>>{
const params = parseOptions(options);
return await this.api.get<Search<Movie>>(`${BASE_SEARCH}/movie?${params}`);
async movies(options: MovieSearchOptions): Promise<Search<Movie>> {
return await this.api.get<Search<Movie>>(`${BASE_SEARCH}/movie`, options);
}
async people(options: PeopleSearchOptions): Promise<Search<Person>>{
const params = parseOptions(options);
return await this.api.get<Search<Person>>(`${BASE_SEARCH}/person?${params}`);
async people(options: PeopleSearchOptions): Promise<Search<Person>> {
return await this.api.get<Search<Person>>(`${BASE_SEARCH}/person`, options);
}
// TODO: Multi search
async tvShows(options: TvSearchOptions): Promise<Search<TV>> {
return await this.api.get<Search<TV>>(`${BASE_SEARCH}/tv`, options);
}
async tvShows(options: TvSearchOptions): Promise<Search<TV>>{
const params = parseOptions(options);
return await this.api.get<Search<TV>>(`${BASE_SEARCH}/tv?${params}`);
async multi(options: MultiSearchOptions): Promise<Search<MultiSearchResult>> {
return await this.api.get<Search<MultiSearchResult>>(
`${BASE_SEARCH}/multi`,
options
);
}
}

View File

@@ -1,4 +1,10 @@
import { MediaType, TimeWindow, TrendingResults } from '../types';
import {
TrendingMediaType,
TimeWindow,
TrendingResults,
LanguageOption,
PageOption,
} from '../types';
import { BaseEndpoint } from './base';
export class TrendingEndpoint extends BaseEndpoint {
@@ -6,9 +12,14 @@ export class TrendingEndpoint extends BaseEndpoint {
super(accessToken);
}
async trending<T extends MediaType>(mediaType : T, timeWindow: TimeWindow): Promise<TrendingResults<T>> {
return await this.api.get<TrendingResults<T>>(`/trending/${mediaType}/${timeWindow}`);
async trending<T extends TrendingMediaType>(
mediaType: T,
timeWindow: TimeWindow,
options?: LanguageOption & PageOption
): Promise<TrendingResults<T>> {
return await this.api.get<TrendingResults<T>>(
`/trending/${mediaType}/${timeWindow}`,
options
);
}
}

111
src/endpoints/tv-episode.ts Normal file
View File

@@ -0,0 +1,111 @@
import {
Episode,
EpisodeSelection,
LanguageOption,
ChangeOption,
TvEpisodeCredit,
ExternalIds,
Images,
TvEpisodeTranslations,
Videos,
AppendToResponse,
Changes,
TvEpisodeChangeValue,
AppendToResponseTvEpisodeKey,
} from '..';
import { BaseEndpoint } from './base';
const BASE_EPISODE = (episodeSelection: EpisodeSelection): string => {
return `/tv/${episodeSelection.tvShowID}/season/${episodeSelection.seasonNumber}/episode/${episodeSelection.episodeNumber}`;
};
export interface TvEpisodeImageSearchOptions extends LanguageOption {
/**
* a list of ISO-639-1 values to query
*/
include_image_language?: string[];
}
export interface TvEpisodeVideoSearchOptions extends LanguageOption {
/**
* a list of ISO-639-1 values to query
*/
include_video_language?: string[];
}
export class TvEpisodesEndpoint extends BaseEndpoint {
constructor(accessToken: string) {
super(accessToken);
}
async details<T extends AppendToResponseTvEpisodeKey[] | undefined>(
episodeSelection: EpisodeSelection,
appendToResponse?: T,
options?: LanguageOption
) {
const combinedOptions = {
append_to_response: appendToResponse
? appendToResponse.join(',')
: undefined,
...options,
};
return await this.api.get<
AppendToResponse<Omit<Episode, 'show_id'>, T, 'tvEpisode'>
>(`${BASE_EPISODE(episodeSelection)}`, combinedOptions);
}
async changes(episodeID: number, options?: ChangeOption) {
return await this.api.get<Changes<TvEpisodeChangeValue>>(
`/tv/episode/${episodeID}/changes`,
options
);
}
async credits(episodeSelection: EpisodeSelection, options?: LanguageOption) {
return await this.api.get<TvEpisodeCredit>(
`${BASE_EPISODE(episodeSelection)}/credits`,
options
);
}
async externalIds(episodeSelection: EpisodeSelection) {
return await this.api.get<ExternalIds>(
`${BASE_EPISODE(episodeSelection)}/external_ids`
);
}
async images(
episodeSelection: EpisodeSelection,
options?: TvEpisodeImageSearchOptions
) {
const computedOptions = {
include_image_language: options?.include_image_language?.join(','),
language: options?.language,
};
return await this.api.get<Images>(
`${BASE_EPISODE(episodeSelection)}/images`,
computedOptions
);
}
async translations(episodeSelection: EpisodeSelection) {
return await this.api.get<TvEpisodeTranslations>(
`${BASE_EPISODE(episodeSelection)}/translations`
);
}
async videos(
episodeSelection: EpisodeSelection,
options?: TvEpisodeVideoSearchOptions
) {
const computedOptions = {
include_video_language: options?.include_video_language?.join(','),
language: options?.language,
};
return await this.api.get<Videos>(
`${BASE_EPISODE(episodeSelection)}/videos`,
computedOptions
);
}
}

131
src/endpoints/tv-seasons.ts Normal file
View File

@@ -0,0 +1,131 @@
import {
ChangeOption,
Changes,
Credits,
ExternalIds,
Images,
LanguageOption,
TvSeasonChangeValue,
SeasonDetails,
SeasonSelection,
Translations,
Videos,
AppendToResponseTvSeasonKey,
AppendToResponse,
AggregateCredits,
} from '..';
import { BaseEndpoint } from './base';
const BASE_SEASON = (seasonSelection: SeasonSelection): string => {
return `/tv/${seasonSelection.tvShowID}/season/${seasonSelection.seasonNumber}`;
};
export interface TvSeasonImageSearchOptions extends LanguageOption {
/**
* a list of ISO-639-1 values to query
*/
include_image_language?: string[];
}
export interface TvSeasonVideoSearchOptions extends LanguageOption {
/**
* a list of ISO-639-1 values to query
*/
include_video_language?: string[];
}
export class TvSeasonsEndpoint extends BaseEndpoint {
constructor(accessToken: string) {
super(accessToken);
}
async details<T extends AppendToResponseTvSeasonKey[] | undefined>(
seasonSelection: SeasonSelection,
appendToResponse?: T,
options?: LanguageOption
) {
const combinedOptions = {
append_to_response: appendToResponse
? appendToResponse.join(',')
: undefined,
...options,
};
return await this.api.get<AppendToResponse<SeasonDetails, T, 'tvSeason'>>(
`${BASE_SEASON(seasonSelection)}`,
combinedOptions
);
}
async aggregateCredits(
seasonSelection: SeasonSelection,
options?: LanguageOption
) {
return await this.api.get<AggregateCredits>(
`${BASE_SEASON(seasonSelection)}/aggregate_credits`,
options
);
}
async changes(seasonId: number, options?: ChangeOption) {
return await this.api.get<Changes<TvSeasonChangeValue>>(
`/tv/season/${seasonId}/changes`,
options
);
}
async credits(seasonSelection: SeasonSelection, options?: LanguageOption) {
return await this.api.get<Credits>(
`${BASE_SEASON(seasonSelection)}/credits`,
options
);
}
async externalIds(
seasonSelection: SeasonSelection,
options?: LanguageOption
) {
return await this.api.get<ExternalIds>(
`${BASE_SEASON(seasonSelection)}/external_ids`,
options
);
}
async images(
seasonSelection: SeasonSelection,
options?: TvSeasonImageSearchOptions
) {
const computedOptions = {
include_image_language: options?.include_image_language?.join(','),
language: options?.language,
};
return await this.api.get<Images>(
`${BASE_SEASON(seasonSelection)}/images`,
computedOptions
);
}
async videos(
seasonSelection: SeasonSelection,
options?: TvSeasonVideoSearchOptions
) {
const computedOptions = {
include_video_language: options?.include_video_language?.join(','),
language: options?.language,
};
return await this.api.get<Videos>(
`${BASE_SEASON(seasonSelection)}/videos`,
computedOptions
);
}
async translations(
seasonSelection: SeasonSelection,
options?: LanguageOption
) {
return await this.api.get<Translations>(
`${BASE_SEASON(seasonSelection)}/translations`,
options
);
}
}

View File

@@ -1,7 +1,11 @@
import { BaseEndpoint } from './base';
import {
AggregateCredits,
AlternativeTitles,
ChangeOptions,
AppendToResponse,
AppendToResponseTvKey,
ChangeOption,
Changes,
ContentRatings,
Credits,
EpisodeGroups,
@@ -14,124 +18,197 @@ import {
PageOption,
PopularTvShows,
Recommendations,
RegionOption,
Reviews,
ScreenedTheatrically,
SeasonDetails,
SimilarTvShows,
TimezoneOption,
TopRatedTvShows,
Translations,
TvShowChanges,
TvShowImageOptions,
TvShowVideoOptions,
TvShowChangeValue,
TvShowDetails,
TvShowsAiringToday,
Videos,
WatchProviders,
} from '../types';
import { parseOptions } from '../utils';
const BASE_TV = '/tv';
export class TvShowsEndpoint extends BaseEndpoint{
export class TvShowsEndpoint extends BaseEndpoint {
constructor(protected readonly accessToken: string) {
super(accessToken);
}
async details(id: number): Promise<TvShowDetails>{
return await this.api.get<TvShowDetails>(`${BASE_TV}/${id}`);
async details<T extends AppendToResponseTvKey[] | undefined>(
id: number,
appendToResponse?: T,
language?: string
) {
const options = {
append_to_response: appendToResponse
? appendToResponse.join(',')
: undefined,
language: language,
};
return await this.api.get<AppendToResponse<TvShowDetails, T, 'tvShow'>>(
`${BASE_TV}/${id}`,
options
);
}
async alternativeTitles(id: number): Promise<AlternativeTitles>{
return await this.api.get<AlternativeTitles>(`${BASE_TV}/${id}/alternative_titles`);
async alternativeTitles(id: number): Promise<AlternativeTitles> {
return await this.api.get<AlternativeTitles>(
`${BASE_TV}/${id}/alternative_titles`
);
}
async changes(id: number, options?: ChangeOptions): Promise<TvShowChanges>{
const params = parseOptions(options);
return await this.api.get<TvShowChanges>(`${BASE_TV}/${id}/changes?${params}`);
async changes(
id: number,
options?: ChangeOption
): Promise<Changes<TvShowChangeValue>> {
return await this.api.get<Changes<TvShowChangeValue>>(
`${BASE_TV}/${id}/changes`,
options
);
}
async contentRatings(id: number): Promise<ContentRatings>{
return await this.api.get<ContentRatings>(`${BASE_TV}/${id}/content_ratings`);
async contentRatings(id: number): Promise<ContentRatings> {
return await this.api.get<ContentRatings>(
`${BASE_TV}/${id}/content_ratings`
);
}
async credits(id: number): Promise<Credits>{
return await this.api.get<Credits>(`${BASE_TV}/${id}/credits`);
async aggregateCredits(
id: number,
options?: LanguageOption
): Promise<AggregateCredits> {
return await this.api.get<AggregateCredits>(
`${BASE_TV}/${id}/aggregate_credits`,
options
);
}
async season(tvId: number, seasonNumber: number): Promise<SeasonDetails>{
return await this.api.get<SeasonDetails>(`${BASE_TV}/${tvId}/season/${seasonNumber}`);
async credits(id: number, options?: LanguageOption): Promise<Credits> {
return await this.api.get<Credits>(`${BASE_TV}/${id}/credits`, options);
}
async episodeGroups(id: number): Promise<EpisodeGroups>{
async season(tvId: number, seasonNumber: number): Promise<SeasonDetails> {
return await this.api.get<SeasonDetails>(
`${BASE_TV}/${tvId}/season/${seasonNumber}`
);
}
async episodeGroups(id: number): Promise<EpisodeGroups> {
return await this.api.get<EpisodeGroups>(`${BASE_TV}/${id}/episode_groups`);
}
async externalIds(id: number): Promise<ExternalIds>{
async externalIds(id: number): Promise<ExternalIds> {
return await this.api.get<ExternalIds>(`${BASE_TV}/${id}/external_ids`);
}
async images(id: number): Promise<Images>{
return await this.api.get<Images>(`${BASE_TV}/${id}/images`);
async images(id: number, options?: TvShowImageOptions): Promise<Images> {
const computedOptions = {
include_image_language: options?.include_image_language?.join(','),
language: options?.language,
};
return await this.api.get<Images>(
`${BASE_TV}/${id}/images`,
computedOptions
);
}
async keywords(id: number): Promise<Keywords>{
async keywords(id: number): Promise<Keywords> {
return await this.api.get<Keywords>(`${BASE_TV}/${id}/keywords`);
}
async recommendations(id: number, options?: PageOption): Promise<Recommendations>{
const params = parseOptions(options);
return await this.api.get<Recommendations>(`${BASE_TV}/${id}/recommendations?${params}`);
async recommendations(
id: number,
options?: LanguageOption & PageOption
): Promise<Recommendations> {
return await this.api.get<Recommendations>(
`${BASE_TV}/${id}/recommendations`,
options
);
}
async reviews(id: number, options?: PageOption): Promise<Reviews>{
const params = parseOptions(options);
return await this.api.get<Reviews>(`${BASE_TV}/${id}/reviews?${params}`);
async reviews(
id: number,
options?: LanguageOption & PageOption
): Promise<Reviews> {
return await this.api.get<Reviews>(`${BASE_TV}/${id}/reviews`, options);
}
async screenedTheatrically(id: number): Promise<ScreenedTheatrically>{
return await this.api.get<ScreenedTheatrically>(`${BASE_TV}/${id}/screened_theatrically`);
async screenedTheatrically(id: number): Promise<ScreenedTheatrically> {
return await this.api.get<ScreenedTheatrically>(
`${BASE_TV}/${id}/screened_theatrically`
);
}
async similar(id: number, options?: PageOption): Promise<SimilarTvShows>{
const params = parseOptions(options);
return await this.api.get<SimilarTvShows>(`${BASE_TV}/${id}/similar?${params}`);
async similar(
id: number,
options?: LanguageOption & PageOption
): Promise<SimilarTvShows> {
return await this.api.get<SimilarTvShows>(
`${BASE_TV}/${id}/similar`,
options
);
}
async translations(id: number): Promise<Translations>{
async translations(id: number): Promise<Translations> {
return await this.api.get<Translations>(`${BASE_TV}/${id}/translations`);
}
async videos(id: number): Promise<Videos>{
return await this.api.get<Videos>(`${BASE_TV}/${id}/videos`);
async videos(id: number, options?: TvShowVideoOptions): Promise<Videos> {
const computedOptions = {
include_video_language: options?.include_video_language?.join(','),
language: options?.language,
};
return await this.api.get<Videos>(
`${BASE_TV}/${id}/videos`,
computedOptions
);
}
/**
* Powered by JustWatch
* @param id
*/
async watchProviders(id: number): Promise<WatchProviders>{
return await this.api.get<WatchProviders>(`${BASE_TV}/${id}/watch/providers`);
* Powered by JustWatch
* @param id
*/
async watchProviders(id: number): Promise<WatchProviders> {
return await this.api.get<WatchProviders>(
`${BASE_TV}/${id}/watch/providers`
);
}
async latest(): Promise<LatestTvShows>{
async latest(): Promise<LatestTvShows> {
return await this.api.get<LatestTvShows>(`${BASE_TV}/latest`);
}
async onTheAir(): Promise<OnTheAir>{
return await this.api.get<OnTheAir>(`${BASE_TV}/on_the_air`);
async onTheAir(
options?: PageOption & LanguageOption & TimezoneOption
): Promise<OnTheAir> {
return await this.api.get<OnTheAir>(`${BASE_TV}/on_the_air`, options);
}
async airingToday(options?: PageOption & LanguageOption & RegionOption): Promise<TvShowsAiringToday>{
const params = parseOptions(options);
return await this.api.get<TvShowsAiringToday>(`${BASE_TV}/airing_today?${params}`);
async airingToday(
options?: PageOption & LanguageOption & TimezoneOption
): Promise<TvShowsAiringToday> {
return await this.api.get<TvShowsAiringToday>(
`${BASE_TV}/airing_today`,
options
);
}
async popular(options?: PageOption & LanguageOption & RegionOption): Promise<PopularTvShows>{
const params = parseOptions(options);
return await this.api.get<PopularTvShows>(`${BASE_TV}/popular?${params}`);
async popular(
options?: PageOption & LanguageOption
): Promise<PopularTvShows> {
return await this.api.get<PopularTvShows>(`${BASE_TV}/popular`, options);
}
async topRated(options?: PageOption & LanguageOption & RegionOption): Promise<TopRatedTvShows>{
const params = parseOptions(options);
return await this.api.get<TopRatedTvShows>(`${BASE_TV}/top_rated?${params}`);
async topRated(
options?: PageOption & LanguageOption
): Promise<TopRatedTvShows> {
return await this.api.get<TopRatedTvShows>(`${BASE_TV}/top_rated`, options);
}
}

View File

@@ -1,6 +1,6 @@
import TMDB from './tmdb';
import { TMDB } from './tmdb';
export * from './types';
export * from './utils';
export default TMDB;
export { TMDB };

View File

@@ -15,9 +15,13 @@ import {
FindEndpoint,
KeywordsEndpoint,
CollectionsEndpoint,
TvSeasonsEndpoint,
TvEpisodesEndpoint,
} from './endpoints';
import { CompaniesEndpoint } from './endpoints/companies';
import { NetworksEndpoint } from './endpoints/networks';
export default class TMDB {
export class TMDB {
private readonly accessToken: string;
constructor(accessToken: string) {
@@ -44,47 +48,63 @@ export default class TMDB {
return new CreditsEndpoint(this.accessToken);
}
get search(): SearchEndpoint{
get companies(): CompaniesEndpoint {
return new CompaniesEndpoint(this.accessToken);
}
get networks(): NetworksEndpoint {
return new NetworksEndpoint(this.accessToken);
}
get search(): SearchEndpoint {
return new SearchEndpoint(this.accessToken);
}
get genres(): GenreEndpoint{
get genres(): GenreEndpoint {
return new GenreEndpoint(this.accessToken);
}
get movies(): MoviesEndpoint{
get movies(): MoviesEndpoint {
return new MoviesEndpoint(this.accessToken);
}
get tvShows(): TvShowsEndpoint{
get tvShows(): TvShowsEndpoint {
return new TvShowsEndpoint(this.accessToken);
}
get discover(): DiscoverEndpoint{
get tvEpisode(): TvEpisodesEndpoint {
return new TvEpisodesEndpoint(this.accessToken);
}
get discover(): DiscoverEndpoint {
return new DiscoverEndpoint(this.accessToken);
}
get people(): PeopleEndpoint{
get people(): PeopleEndpoint {
return new PeopleEndpoint(this.accessToken);
}
get review(): ReviewEndpoint{
get review(): ReviewEndpoint {
return new ReviewEndpoint(this.accessToken);
}
get trending(): TrendingEndpoint{
get trending(): TrendingEndpoint {
return new TrendingEndpoint(this.accessToken);
}
get find() : FindEndpoint{
get find(): FindEndpoint {
return new FindEndpoint(this.accessToken);
}
get keywords() : KeywordsEndpoint{
get keywords(): KeywordsEndpoint {
return new KeywordsEndpoint(this.accessToken);
}
get collections() : CollectionsEndpoint{
get collections(): CollectionsEndpoint {
return new CollectionsEndpoint(this.accessToken);
}
get tvSeasons(): TvSeasonsEndpoint {
return new TvSeasonsEndpoint(this.accessToken);
}
}

17
src/types/account.ts Normal file
View File

@@ -0,0 +1,17 @@
export interface Gravatar {
hash: string;
}
export interface Avatar {
gravatar: Gravatar;
}
export interface AccountDetails {
avatar: Avatar;
id: number;
include_adult: boolean;
iso_3166_1: string;
iso_639_1: string;
name: string;
username: string;
}

View File

@@ -6,14 +6,14 @@ export interface Certification {
export interface Certifications {
certifications: {
US: Certification[],
CA: Certification[],
DE: Certification[],
GB: Certification[],
AU: Certification[],
BR: Certification[],
FR: Certification[],
NZ: Certification[],
IN: Certification[],
}
US: Certification[];
CA: Certification[];
DE: Certification[];
GB: Certification[];
AU: Certification[];
BR: Certification[];
FR: Certification[];
NZ: Certification[];
IN: Certification[];
};
}

View File

@@ -1,17 +1,29 @@
export interface Change {
export interface MediaChange {
id: number;
adult: boolean | undefined;
}
export interface Changes{
results: Change[];
export interface MediaChanges {
results: MediaChange[];
page: number;
total_pages: number;
total_results: number;
}
export interface ChangeOptions {
end_date?: string;
start_date?: string;
page?: number;
export interface Changes<T> {
changes: Change<T>[];
}
export interface Change<T> {
key: string;
items: ChangeItem<T>[];
}
export interface ChangeItem<T> {
id: string;
action: string;
time: string;
value: T;
iso_639_1: string;
original_value: T;
}

View File

@@ -1,4 +1,4 @@
import { Movie } from '.';
import { LanguageOption, Movie } from '.';
export interface Collection {
id: number;
@@ -12,5 +12,12 @@ export interface Collection {
}
export interface DetailedCollection extends Collection {
parts: Movie[]
parts: Movie[];
}
export interface CollectionImageOptions extends LanguageOption {
/**
* a list of ISO-639-1 values to query
*/
include_image_language?: string[];
}

33
src/types/companies.ts Normal file
View File

@@ -0,0 +1,33 @@
import { Image } from '.';
export interface CompanyDetails {
description: string;
headquarters: string;
homepage: string;
id: number;
logo_path: string;
name: string;
origin_country: string;
parent_company: ParentCompany;
}
export interface ParentCompany {
name: string;
id: number;
logo_path: string;
}
export interface AlternativeNames {
id: number;
results: Name[];
}
export interface Name {
name: string;
type: string;
}
export interface CompanyImages {
id: number;
logos: Image[];
}

View File

@@ -1,5 +1,4 @@
export interface Images {
export interface ImageConfiguration {
base_url: string;
secure_base_url: string;
backdrop_sizes: BackdropSizes[];
@@ -10,51 +9,50 @@ export interface Images {
}
export interface Configuration {
images: Images;
images: ImageConfiguration;
change_keys: ChangeKeys[];
}
export const enum BackdropSizes {
W300 = 'w300',
W500 = 'w500',
W780 = 'w780',
W1280 = 'w1280',
ORIGINAL = 'original'
ORIGINAL = 'original',
}
export const enum LogoSizes {
W45= 'w45',
W92= 'w92',
W154= 'w154',
W185= 'w185',
W45 = 'w45',
W92 = 'w92',
W154 = 'w154',
W185 = 'w185',
W300 = 'w300',
W500 = 'w500',
ORIGINAL = 'original'
ORIGINAL = 'original',
}
export const enum PosterSizes {
W92= 'w92',
W154= 'w154',
W185='w185',
W92 = 'w92',
W154 = 'w154',
W185 = 'w185',
W300 = 'w300',
W500 = 'w500',
W780 = 'w780',
ORIGINAL = 'original'
ORIGINAL = 'original',
}
export const enum ProfileSizes {
W45 = 'w45',
W185 = 'w185',
W632 = 'w632',
ORIGINAL = 'original'
ORIGINAL = 'original',
}
export const enum StillSizes {
W92= 'w92',
W92 = 'w92',
W185 = 'w185',
W300 = 'w300',
ORIGINAL = 'original'
ORIGINAL = 'original',
}
export const enum ChangeKeys {
@@ -110,5 +108,5 @@ export const enum ChangeKeys {
TVRAGE_ID = 'tvrage_id',
TYPE = 'type',
VIDEO = 'video',
VIDEOS = 'videos'
VIDEOS = 'videos',
}

View File

@@ -6,10 +6,9 @@ export interface CreditSeason {
season_number?: number;
}
export interface Media{
export interface Media {
i?: number;
name?:string;
name?: string;
first_air_date?: string;
vote_count?: number;
overview?: string;
@@ -87,8 +86,6 @@ export interface ImageCollection {
backdrops: Image[];
posters: Image[];
}
export interface Video {
id: string;
iso_639_1: string;
@@ -103,4 +100,50 @@ export interface Video {
export interface Videos {
id: number;
results: Video[];
}
}
export interface AggregateCredits {
id: number;
cast: AggregateCast[];
crew: AggregateCrew[];
}
export interface CastRole {
credit_id: string;
character: string;
episode_count: number;
}
export interface AggregateCast {
adult: boolean;
gender: number;
id: number;
known_for_department: string;
name: string;
original_name: string;
popularity: number;
profile_path: string;
roles: CastRole[];
total_episode_count: number;
order: number;
}
export interface CrewJob {
credit_id: string;
job: string;
episode_count: number;
}
export interface AggregateCrew {
adult: boolean;
gender: number;
id: number;
known_for_department: string;
name: string;
original_name: string;
popularity: number;
profile_path: string;
jobs: CrewJob[];
department: string;
total_episode_count: number;
}

View File

@@ -1,29 +1,29 @@
import { Movie, TV } from '.';
export type SortOption =
| 'popularity.asc'
| 'popularity.desc'
| 'release_date.asc'
| 'release_date.desc'
| 'revenue.asc'
| 'revenue.desc'
| 'primary_release_date.asc'
| 'primary_release_date.desc'
| 'original_title.asc'
| 'original_title.desc'
| 'vote_average.asc'
| 'vote_average.desc'
| 'vote_count.asc'
| 'vote_count.desc';
| 'popularity.asc'
| 'popularity.desc'
| 'release_date.asc'
| 'release_date.desc'
| 'revenue.asc'
| 'revenue.desc'
| 'primary_release_date.asc'
| 'primary_release_date.desc'
| 'original_title.asc'
| 'original_title.desc'
| 'vote_average.asc'
| 'vote_average.desc'
| 'vote_count.asc'
| 'vote_count.desc';
export interface MovieDiscoverResult{
export interface MovieDiscoverResult {
page: number;
results: Movie[];
total_results: number;
total_pages: number;
}
export interface TvShowDiscoverResult{
export interface TvShowDiscoverResult {
page: number;
results: TV[];
total_results: number;

View File

@@ -1,8 +1,10 @@
export * from './options';
export * from './certification';
export * from './credits';
export * from './credits';
export * from './companies';
export * from './networks';
export * from './configuration';
export * from './changes';
export * from './changes';
export * from './movies';
export * from './search';
export * from './tv-shows';
@@ -14,6 +16,16 @@ export * from './trending';
export * from './find';
export * from './keywords';
export * from './collections';
export * from './tv-episode';
export * from './tv-seasons';
export interface ErrorResponse {
status_code: number;
status_message: string;
success: boolean;
}
export type MediaType = 'movie' | 'tv' | 'person';
export interface AuthorDetails {
name: string;
@@ -22,23 +34,7 @@ export interface AuthorDetails {
rating?: number;
}
export interface KnownFor {
id: number;
overview: string;
release_date: string;
video: boolean;
adult: boolean;
backdrop_path: string;
media_type: string;
genre_ids: number[];
title: string;
original_language: string;
original_title: string;
poster_path: string;
vote_count: number;
vote_average: number;
popularity: number;
}
export type KnownFor = MovieWithMediaType | TVWithMediaType;
export interface Person {
id: number;
@@ -51,6 +47,10 @@ export interface Person {
popularity: number;
}
export interface PersonWithMediaType extends Person {
media_type: 'person';
}
export interface Movie {
id: number;
poster_path: string;
@@ -68,6 +68,10 @@ export interface Movie {
vote_average: number;
}
export interface MovieWithMediaType extends Movie {
media_type: 'movie';
}
export interface Company {
id: number;
logo_path: string;
@@ -77,7 +81,7 @@ export interface Company {
export interface TV {
id: number;
name:string;
name: string;
first_air_date: string;
backdrop_path: string;
genre_ids: number[];
@@ -91,6 +95,10 @@ export interface TV {
vote_average: number;
}
export interface TVWithMediaType extends TV {
media_type: 'tv';
}
export interface Genre {
id: number;
name: string;
@@ -122,27 +130,27 @@ export interface SpokenLanguage {
name: string;
}
export interface ContentRatings{
export interface ContentRatings {
results: ContentRatingsResult[];
id: number;
}
export interface ContentRatingsResult {
descriptor: unknown[];
iso_3166_1: string;
rating: string;
}
export interface Recommendation {
adult: boolean;
backdrop_path?: any;
backdrop_path?: string;
genre_ids: number[];
id: number;
original_language: string;
original_title: string;
overview: string;
release_date: string;
poster_path?: any;
poster_path?: string;
popularity: number;
title: string;
video: boolean;
@@ -150,7 +158,6 @@ export interface Recommendation {
vote_count: number;
}
export interface Recommendations {
page: number;
results: Recommendation[];
@@ -176,7 +183,6 @@ export interface Reviews {
total_results: number;
}
export interface TranslationData {
title: string;
overview: string;
@@ -196,7 +202,7 @@ export interface Translations {
translations: Translation[];
}
export interface Image{
export interface Image {
aspect_ratio: number;
file_path: string;
height: number;
@@ -204,4 +210,11 @@ export interface Image{
vote_average: number;
vote_count: number;
width: number;
}
}
export interface Images {
id: number;
backdrops: Image[];
logos: Image[];
posters: Image[];
}

View File

@@ -1,18 +1,19 @@
import { Movie } from '.';
import { PageOption } from './options';
export interface KeywordsOptions {
export interface KeywordsOptions extends PageOption {
include_adult?: boolean;
language?: string;
}
export interface BelongingMovies{
export interface BelongingMovies {
page: number;
results: Movie[];
total_results: number;
total_pages: number;
}
export interface Keyword{
export interface Keyword {
id: number;
name: string;
}
@@ -20,4 +21,4 @@ export interface Keyword{
export interface Keywords {
id: number;
keywords: Keyword[];
}
}

View File

@@ -1,9 +1,22 @@
import { Genre, Movie, ProductionCompany, ProductionCountry, SpokenLanguage } from './';
import {
Genre,
Movie,
ProductionCompany,
ProductionCountry,
SpokenLanguage,
} from './';
export interface BelongsToCollection {
id: number;
name: string;
poster_path: string;
backdrop_path: string;
}
export interface MovieDetails {
adult: boolean;
backdrop_path: string;
belongs_to_collection?: any;
belongs_to_collection?: BelongsToCollection;
budget: number;
genres: Genre[];
homepage: string;
@@ -13,7 +26,7 @@ export interface MovieDetails {
original_title: string;
overview: string;
popularity: number;
poster_path?: any;
poster_path?: string;
production_companies: ProductionCompany[];
production_countries: ProductionCountry[];
release_date: string;
@@ -34,7 +47,7 @@ export enum ReleaseDateType {
'Theatrical',
'Digital',
'Physical',
'TV'
'TV',
}
export interface ReleaseDate {
@@ -55,7 +68,6 @@ export interface ReleaseDates {
results: ReleaseDateResult[];
}
export interface SimilarMovies {
page: number;
results: Movie[];
@@ -82,29 +94,10 @@ export interface MovieLists {
total_results: number;
}
export interface MovieChangeItem {
id: string;
action: string;
time: string;
iso_639_1: string;
value: string;
original_value: string;
}
export interface MovieChange {
key: string;
items: MovieChangeItem[];
}
export interface MovieChanges {
changes: MovieChange[];
}
export interface LatestMovie {
adult: boolean;
backdrop_path?: any;
belongs_to_collection?: any;
backdrop_path?: string;
belongs_to_collection?: BelongsToCollection;
budget: number;
genres: Genre[];
homepage: string;
@@ -115,12 +108,12 @@ export interface LatestMovie {
overview: string;
popularity: number;
poster_path: string;
production_companies: any[];
production_countries: any[];
production_companies: ProductionCompany[];
production_countries: ProductionCountry[];
release_date: string;
revenue: number;
runtime: number;
spoken_languages: any[];
spoken_languages: SpokenLanguage[];
status: string;
tagline: string;
title: string;
@@ -129,7 +122,6 @@ export interface LatestMovie {
vote_count: number;
}
export interface Dates {
maximum: string;
minimum: string;
@@ -163,3 +155,14 @@ export interface UpcomingMovies {
total_results: number;
total_pages: number;
}
export type MovieChangeValue =
| string
| {
person_id: number;
character: string;
order: number;
cast_id: number;
credit_id: string;
}
| unknown;

15
src/types/networks.ts Normal file
View File

@@ -0,0 +1,15 @@
import { Image } from '.';
export interface NetworkDetails {
headquarters: string;
homepage: string;
id: number;
logo_path: string;
name: string;
origin_country: string;
}
export interface NetworkImages {
id: number;
logos: Image[];
}

View File

@@ -1,3 +1,37 @@
import {
AlternativeTitles,
Changes,
ContentRatings,
Credits,
EpisodeGroups,
ExternalIds,
Images,
Keywords,
MovieLists,
PeopleImages,
PersonTranslations,
PersonCombinedCredits,
PersonMovieCredit,
PersonTvShowCredit,
Recommendations,
ReleaseDates,
Reviews,
ScreenedTheatrically,
SimilarMovies,
SimilarTvShows,
TaggedImages,
Translations,
Videos,
WatchProviders,
PersonChangeValue,
MovieChangeValue,
TvShowChangeValue,
TvEpisodeChangeValue,
TvEpisodeCredit,
TvEpisodeTranslations,
TvSeasonChangeValue,
} from '.';
export interface LanguageOption {
language?: string;
}
@@ -6,6 +40,201 @@ export interface RegionOption {
region?: string;
}
export interface TimezoneOption {
timezone?: string;
}
export interface PageOption {
page?: number;
}
export interface ChangeOption extends PageOption {
start_date?: Date;
end_date?: Date;
}
export type AppendToResponseMovieKey =
| 'images'
| 'videos'
| 'credits'
| 'recommendations'
| 'reviews'
| 'changes'
| 'similar'
| 'lists'
| 'release_dates'
| 'alternative_titles'
| 'external_ids'
| 'translations'
| 'watch/providers'
| 'keywords';
export type AppendToResponseTvKey =
| 'content_ratings'
| 'images'
| 'videos'
| 'credits'
| 'recommendations'
| 'reviews'
| 'changes'
| 'similar'
| 'alternative_titles'
| 'external_ids'
| 'translations'
| 'watch/providers'
| 'aggregate_credits'
| 'episode_groups'
| 'screened_theatrically'
| 'keywords';
export type AppendToResponsePersonKey =
| 'images'
| 'changes'
| 'movie_credits'
| 'tv_credits'
| 'combined_credits'
| 'external_ids'
| 'tagged_images'
| 'translations';
export type AppendToResponseTvEpisodeKey =
| 'images'
| 'credits'
| 'external_ids'
| 'videos'
| 'translations';
export type AppendToResponseTvSeasonKey =
| 'images'
| 'credits'
| 'external_ids'
| 'videos'
| 'aggregate_credits'
| 'translations';
type AppendToResponseAllKeys =
| AppendToResponseTvKey
| AppendToResponseMovieKey
| AppendToResponseTvEpisodeKey
| AppendToResponseTvSeasonKey
| AppendToResponsePersonKey;
export type AppendToResponseMediaType =
| 'movie'
| 'tvShow'
| 'person'
| 'tvSeason'
| 'tvEpisode';
export type AppendToResponse<
K,
T extends AppendToResponseAllKeys[] | undefined,
Media extends AppendToResponseMediaType
> = K &
(T extends undefined
? object
: T extends Array<unknown>
? ('credits' extends T[number]
? {
credits: Media extends 'tvEpisode'
? TvEpisodeCredit
: Omit<Credits, 'id'>;
}
: object) &
('videos' extends T[number] ? { videos: Omit<Videos, 'id'> } : object) &
('images' extends T[number]
? {
images: Omit<
Media extends 'person' ? PeopleImages : Images,
'id'
>;
}
: object) &
('recommendations' extends T[number]
? { recommendations: Recommendations }
: object) &
('reviews' extends T[number]
? { reviews: Omit<Reviews, 'id'> }
: object) &
('reviews' extends T[number]
? { reviews: Omit<Translations, 'id'> }
: object) &
('changes' extends T[number]
? {
changes: Changes<
Media extends 'person'
? PersonChangeValue
: Media extends 'movie'
? MovieChangeValue
: Media extends 'tvShow'
? TvShowChangeValue
: Media extends 'tvSeason'
? TvSeasonChangeValue
: TvEpisodeChangeValue
>;
}
: object) &
('keywords' extends T[number]
? { keywords: Omit<Keywords, 'id'> }
: object) &
('lists' extends T[number]
? { lists: Omit<MovieLists, 'id'> }
: object) &
('release_dates' extends T[number]
? { release_dates: Omit<ReleaseDates, 'id'> }
: object) &
('alternative_titles' extends T[number]
? { alternative_titles: Omit<AlternativeTitles, 'id'> }
: object) &
('external_ids' extends T[number]
? { external_ids: Omit<ExternalIds, 'id'> }
: object) &
('translations' extends T[number]
? {
translations: Omit<
Media extends 'person'
? PersonTranslations
: Media extends 'tvEpisode'
? TvEpisodeTranslations
: Translations,
'id'
>;
}
: object) &
('watch/providers' extends T[number]
? { 'watch/providers': Omit<WatchProviders, 'id'> }
: object) &
('aggregate_credits' extends T[number]
? { aggregate_credits: Omit<Credits, 'id'> }
: object) &
('episode_groups' extends T[number]
? { episode_groups: Omit<EpisodeGroups, 'id'> }
: object) &
('screened_theatrically' extends T[number]
? { screened_theatrically: Omit<ScreenedTheatrically, 'id'> }
: object) &
('similar' extends T[number]
? {
similar: Media extends 'movie'
? SimilarMovies
: Media extends 'tvShow'
? SimilarTvShows
: unknown;
}
: object) &
('content_ratings' extends T[number]
? { content_ratings: Omit<ContentRatings, 'id'> }
: object) &
('movie_credits' extends T[number]
? { movie_credits: Omit<PersonMovieCredit, 'id'> }
: object) &
('tv_credits' extends T[number]
? { tv_credits: Omit<PersonTvShowCredit, 'id'> }
: object) &
('combined_credits' extends T[number]
? { combined_credits: Omit<PersonCombinedCredits, 'id'> }
: object) &
('tagged_images' extends T[number]
? { tagged_images: TaggedImages }
: object)
: never);

View File

@@ -1,4 +1,4 @@
import { Movie, Person, TV } from '.';
import { Image, Movie, Person, TV } from '.';
interface Cast {
character: string;
@@ -79,7 +79,7 @@ export interface PersonCombinedCredits {
id: number;
}
export interface PersonDetail {
export interface PersonDetails {
birthday: string;
known_for_department: string;
deathday: string;
@@ -96,22 +96,13 @@ export interface PersonDetail {
homepage: string;
}
export interface PersonChange {
id: string;
action: string;
time: string;
iso_639_1: string;
iso_3166_1: string;
value: string | { profile: { file_path: string } };
original_value: string | { profile: { file_path: string } };
}
export interface PersonChanges {
changes: {
key: string;
items: PersonChange[];
}[];
}
export type PersonChangeValue =
| string
| {
profile: {
file_path: string;
};
};
export interface PopularPersons {
page: number;
@@ -120,6 +111,11 @@ export interface PopularPersons {
total_pages: number;
}
export interface PeopleImages {
id: number;
profiles: Image[];
}
export interface TaggedImage {
aspect_ratio: number;
file_path: string;
@@ -141,7 +137,7 @@ export interface TaggedImages {
total_pages: number;
}
export interface PeopleTranslations {
export interface PersonTranslations {
id: number;
translations: {
iso_3166_1: string;

View File

@@ -1,8 +1,8 @@
import { Review } from './';
export interface ReviewDetails extends Review{
export interface ReviewDetails extends Review {
iso_639_1: string;
media_id: number;
media_title: number;
media_type: number;
}
}

View File

@@ -1,3 +1,5 @@
import { MovieWithMediaType, PersonWithMediaType, TVWithMediaType } from '.';
export interface Search<T> {
page: number;
results: T[];
@@ -5,4 +7,7 @@ export interface Search<T> {
total_results: number;
}
export type MultiSearchResult =
| MovieWithMediaType
| TVWithMediaType
| PersonWithMediaType;

View File

@@ -1,19 +1,28 @@
import { Movie, Person, TV } from '.';
export type MediaType = 'all' | 'movie' | 'tv' | 'person';
import {
Movie,
Person,
TV,
MediaType,
MovieWithMediaType,
TVWithMediaType,
PersonWithMediaType,
} from '.';
export type TimeWindow = 'day' | 'week';
type TrendingResult<T extends MediaType> = T extends 'tv'
export type TrendingMediaType = MediaType | 'all';
type TrendingResult<T extends TrendingMediaType> = T extends 'tv'
? TV
: T extends 'movie'
? Movie
: T extends 'person'
? Person
: TV | Movie | Person;
? Movie
: T extends 'person'
? Person
: TVWithMediaType | MovieWithMediaType | PersonWithMediaType;
export interface TrendingResults<T extends MediaType> {
export interface TrendingResults<T extends TrendingMediaType> {
page: number;
results: (TrendingResult<T> & {media_type: MediaType})[];
results: TrendingResult<T>[];
total_pages: number;
total_results: number;
}
}

58
src/types/tv-episode.ts Normal file
View File

@@ -0,0 +1,58 @@
import { Credits, Crew } from '.';
export interface EpisodeSelection {
tvShowID: number;
seasonNumber: number;
episodeNumber: number;
}
export interface Episode {
air_date: string;
episode_number: number;
crew: Crew[];
guest_stars: GuestStar[];
id: number;
name: string;
overview: string;
production_code: string;
season_number: number;
still_path: string;
vote_average: number;
vote_count: number;
runtime: number;
show_id: number;
}
export interface GuestStar {
credit_id: string;
order: number;
character: string;
adult: boolean;
gender: number | null;
id: number;
known_for_department: string;
name: string;
original_name: string;
popularity: number;
profile_path: string | null;
}
export interface TvEpisodeCredit extends Credits {
guest_stars: GuestStar[];
}
export interface TvEpisodeTranslations {
id: number;
translations: {
iso_3166_1: string;
iso_639_1: string;
name: string;
english_name: string;
data: {
name: string;
overview: string;
};
};
}
export type TvEpisodeChangeValue = string | unknown;

23
src/types/tv-seasons.ts Normal file
View File

@@ -0,0 +1,23 @@
import { Episode } from '.';
export interface SeasonSelection {
tvShowID: number;
seasonNumber: number;
}
export interface SeasonDetails {
air_date: string;
episodes: Episode[];
name: string;
overview: string;
id: number;
poster_path: string | null;
season_number: number;
}
export type TvSeasonChangeValue =
| string
| {
episode_id: number;
episode_number: number;
};

View File

@@ -1,4 +1,10 @@
import { Genre, ProductionCompany, ProductionCountry, SpokenLanguage, Crew } from './';
import {
Genre,
ProductionCompany,
ProductionCountry,
SpokenLanguage,
LanguageOption,
} from './';
export interface CreatedBy {
id: number;
@@ -8,6 +14,21 @@ export interface CreatedBy {
profile_path: string;
}
export interface NextEpisodeToAir {
id: number;
name: string;
overview: string;
vote_average: number;
vote_count: number;
air_date: string;
episode_number: number;
production_code: string;
runtime: number;
season_number: number;
show_id: number;
still_path: string;
}
export interface LastEpisodeToAir {
air_date: string;
episode_number: number;
@@ -51,7 +72,7 @@ export interface TvShowDetails {
last_air_date: string;
last_episode_to_air: LastEpisodeToAir;
name: string;
next_episode_to_air?: any;
next_episode_to_air?: NextEpisodeToAir;
networks: Network[];
number_of_episodes: number;
number_of_seasons: number;
@@ -72,66 +93,6 @@ export interface TvShowDetails {
vote_count: number;
}
export interface GuestStar {
credit_id: string
order: number
character: string
adult: boolean
gender: number | null
id: number
known_for_department: string
name: string
original_name: string
popularity: number
profile_path: string | null
}
export interface Episode {
air_date: string
episode_number: number
crew: Crew[]
guest_stars: GuestStar[]
id: number
name: string
overview: string
production_code: string
season_number: number
still_path: string
vote_average: number
vote_count: number
show_id: number;
runtime: number;
}
export interface SeasonDetails {
air_date: string
episodes: Episode[]
name: string
overview: string
id: number
poster_path: string | null
season_number: number
}
export interface TvShowItem {
id: string;
action: string;
time: string;
value: any;
iso_639_1: string;
original_value: any;
}
export interface TvShowChange {
key: string;
items: TvShowItem[];
}
export interface TvShowChanges {
changes: TvShowChange[];
}
export interface Network {
id: number;
logo_path: string;
@@ -165,7 +126,6 @@ export interface ScreenedTheatrically {
results: ScreenedTheatricallyResult[];
}
export interface SimilarTvShow {
backdrop_path: string;
first_air_date: string;
@@ -190,8 +150,8 @@ export interface SimilarTvShows {
}
export interface LatestTvShows {
backdrop_path?: any;
created_by: any[];
backdrop_path?: string;
created_by: CreatedBy[];
episode_run_time: number[];
first_air_date: string;
genres: Genre[];
@@ -207,10 +167,10 @@ export interface LatestTvShows {
origin_country: string[];
original_language: string;
original_name: string;
overview?: any;
overview?: string;
popularity: number;
poster_path?: any;
production_companies: any[];
poster_path?: string;
production_companies: ProductionCompany[];
seasons: Season[];
status: string;
type: string;
@@ -218,7 +178,6 @@ export interface LatestTvShows {
vote_count: number;
}
export interface OnTheAirResult {
poster_path: string;
popularity: number;
@@ -242,7 +201,6 @@ export interface OnTheAir {
total_pages: number;
}
export interface AiringTodayResult {
poster_path: string;
popularity: number;
@@ -266,7 +224,6 @@ export interface TvShowsAiringToday {
total_pages: number;
}
export interface PopularTvShowResult {
poster_path: string;
popularity: number;
@@ -290,7 +247,6 @@ export interface PopularTvShows {
total_pages: number;
}
export interface TopRatedTvShowResult {
poster_path: string;
popularity: number;
@@ -314,4 +270,21 @@ export interface TopRatedTvShows {
total_pages: number;
}
export interface TvShowChangeValue {
season_id: number;
season_number: number;
}
export interface TvShowImageOptions extends LanguageOption {
/**
* a list of ISO-639-1 values to query
*/
include_image_language?: string[];
}
export interface TvShowVideoOptions extends LanguageOption {
/**
* a list of ISO-639-1 values to query
*/
include_video_language?: string[];
}

View File

@@ -1,4 +1,3 @@
export interface Flatrate {
display_priority: number;
logo_path: string;
@@ -20,7 +19,6 @@ export interface Buy {
provider_name: string;
}
export interface WatchLocale {
AR: {
link: string;
@@ -298,5 +296,3 @@ export interface WatchProviders {
id: number;
results: WatchLocale;
}

View File

@@ -8,7 +8,12 @@
* @param {string} imagePath raw image path
* @param {boolean} svg get svg version if true
*/
export const getFullImagePath = (baseUrl: string, fileSize: string, imagePath: string, svg = false): string => {
export const getFullImagePath = (
baseUrl: string,
fileSize: string,
imagePath: string,
svg = false
): string => {
const imagePathArr = imagePath.split('.');
const imageFormat = svg ? 'svg' : imagePathArr[1];

View File

@@ -1,7 +1,4 @@
export function parseOptions(
options?: { [s: string]: any },
): string {
return options
? new URLSearchParams(Object.entries(options)).toString()
: '';
export function parseOptions(options?: Record<string, any>): string {
/* eslint-disable @typescript-eslint/no-explicit-any */
return options ? new URLSearchParams(Object.entries(options)).toString() : '';
}

View File

@@ -1,28 +1,18 @@
{
"compilerOptions": {
"target": "es2020" /* Specify ECMAScript target version: 'ES3' (default), 'ES5', 'ES2015', 'ES2016', 'ES2017', 'ES2018', 'ES2019', 'ES2020', or 'ESNEXT'. */,
"module": "commonjs" /* Specify module code generation: 'none', 'commonjs', 'amd', 'system', 'umd', 'es2015', 'es2020', or 'ESNext'. */,
"target": "ES2022" /* Specify ECMAScript target version: 'ES3' (default), 'ES5', 'ES2015', 'ES2016', 'ES2017', 'ES2018', 'ES2019', 'ES2020', or 'ESNEXT'. */,
"module": "CommonJS" /* Specify module code generation: 'none', 'commonjs', 'amd', 'system', 'umd', 'es2015', 'es2020', or 'ESNext'. */,
"moduleResolution": "node16",
"sourceMap": true /* Generates corresponding '.map' file. */,
"outDir": "dist" /* Redirect output structure to the directory. */,
"strict": true /* Enable all strict type-checking options. */,
"allowSyntheticDefaultImports": true, /* Allow default imports from modules with no default export. This does not affect code emit, just typechecking. */
"types": ["node"],
"esModuleInterop": true /* Enables emit interoperability between CommonJS and ES Modules via creation of namespace objects for all imports. Implies 'allowSyntheticDefaultImports'. */,
"experimentalDecorators": true /* Enables experimental support for ES7 decorators. */,
"emitDecoratorMetadata": true /* Enables experimental support for emitting type metadata for decorators. */,
"skipLibCheck": true /* Skip type checking of declaration files. */,
"forceConsistentCasingInFileNames": true, /* Disallow inconsistently-cased references to the same file. */
"typeRoots": [
"./src/types"
]
"forceConsistentCasingInFileNames": true /* Disallow inconsistently-cased references to the same file. */,
"typeRoots": ["./src/types"]
},
"types": ["node"],
"include": [
"src"
],
"exclude": [
"node_modules",
"dist",
"./src/types/*.ts"
]
"include": ["src"],
"exclude": ["node_modules", "dist", "./src/types/*.ts"]
}