tmdb-kit 1.0.0 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.cjs CHANGED
@@ -1,823 +1,802 @@
1
- Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
2
- //#region src/errors.ts
3
- /** Base class for all SDK-originated errors. */
4
- var TMDBError = class extends Error {
5
- constructor(message, options) {
6
- super(message, options);
7
- this.name = "TMDBError";
8
- }
1
+ var __defProp = Object.defineProperty;
2
+ var __getOwnPropNames = Object.getOwnPropertyNames;
3
+ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
4
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
5
+ function __accessProp(key) {
6
+ return this[key];
7
+ }
8
+ var __toCommonJS = (from) => {
9
+ var entry = (__moduleCache ??= new WeakMap).get(from), desc;
10
+ if (entry)
11
+ return entry;
12
+ entry = __defProp({}, "__esModule", { value: true });
13
+ if (from && typeof from === "object" || typeof from === "function") {
14
+ for (var key of __getOwnPropNames(from))
15
+ if (!__hasOwnProp.call(entry, key))
16
+ __defProp(entry, key, {
17
+ get: __accessProp.bind(from, key),
18
+ enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
19
+ });
20
+ }
21
+ __moduleCache.set(from, entry);
22
+ return entry;
9
23
  };
10
- /** Thrown before a request is sent or when fetch itself rejects. */
11
- var TMDBRequestError = class extends TMDBError {
12
- constructor(message, options) {
13
- super(message, options);
14
- this.name = "TMDBRequestError";
15
- }
24
+ var __moduleCache;
25
+ var __returnValue = (v) => v;
26
+ function __exportSetter(name, newValue) {
27
+ this[name] = __returnValue.bind(null, newValue);
28
+ }
29
+ var __export = (target, all) => {
30
+ for (var name in all)
31
+ __defProp(target, name, {
32
+ get: all[name],
33
+ enumerable: true,
34
+ configurable: true,
35
+ set: __exportSetter.bind(all, name)
36
+ });
16
37
  };
17
- /** Thrown when TMDB returns a non-2xx response. */
18
- var TMDBResponseError = class extends TMDBError {
19
- body;
20
- headers;
21
- requestId;
22
- status;
23
- statusCode;
24
- statusMessage;
25
- statusText;
26
- url;
27
- constructor(message, options) {
28
- super(message);
29
- this.name = "TMDBResponseError";
30
- this.body = options.body;
31
- this.headers = options.headers;
32
- this.requestId = options.headers.get("x-request-id");
33
- this.status = options.status;
34
- this.statusText = options.statusText;
35
- this.url = options.url;
36
- const body = isErrorResponseBody(options.body) ? options.body : void 0;
37
- this.statusCode = body?.status_code;
38
- this.statusMessage = body?.status_message;
39
- }
40
- /** True when TMDB has asked the caller to back off (HTTP 429). */
41
- get isRateLimit() {
42
- return this.status === 429;
43
- }
44
- /** True when the resource was not found (HTTP 404). */
45
- get isNotFound() {
46
- return this.status === 404;
47
- }
48
- /** True when the request was rejected as unauthenticated (HTTP 401). */
49
- get isUnauthorized() {
50
- return this.status === 401;
51
- }
52
- /** True when the request was rejected as forbidden (HTTP 403). */
53
- get isForbidden() {
54
- return this.status === 403;
55
- }
56
- /** True when the upstream returned a 5xx server error. */
57
- get isServerError() {
58
- return this.status >= 500 && this.status < 600;
59
- }
60
- };
61
- /**
62
- * Thrown when TMDB returns HTTP 429.
63
- *
64
- * The SDK does NOT retry automatically — that decision is left to the
65
- * caller, since retry policies vary widely. Inspect `retryAfter` to
66
- * implement your own backoff.
67
- */
68
- var TMDBRateLimitError = class extends TMDBResponseError {
69
- retryAfter;
70
- constructor(message, options) {
71
- super(message, options);
72
- this.name = "TMDBRateLimitError";
73
- this.retryAfter = options.retryAfter;
74
- }
75
- };
76
- /**
77
- * Create the appropriate error instance for a non-2xx TMDB response.
78
- *
79
- * Returns a {@link TMDBRateLimitError} when the status is 429, otherwise
80
- * a generic {@link TMDBResponseError}. The error message is extracted from
81
- * the TMDB `status_message` field when available.
82
- */
38
+
39
+ // src/index.ts
40
+ var exports_src = {};
41
+ __export(exports_src, {
42
+ KNOWN_BACKDROP_SIZES: () => KNOWN_BACKDROP_SIZES,
43
+ KNOWN_IMAGE_SIZES: () => KNOWN_IMAGE_SIZES,
44
+ KNOWN_LOGO_SIZES: () => KNOWN_LOGO_SIZES,
45
+ KNOWN_POSTER_SIZES: () => KNOWN_POSTER_SIZES,
46
+ KNOWN_PROFILE_SIZES: () => KNOWN_PROFILE_SIZES,
47
+ KNOWN_STILL_SIZES: () => KNOWN_STILL_SIZES,
48
+ TMDBClient: () => TMDBClient,
49
+ TMDBError: () => TMDBError,
50
+ TMDBRateLimitError: () => TMDBRateLimitError,
51
+ TMDBRequestError: () => TMDBRequestError,
52
+ TMDBResponseError: () => TMDBResponseError,
53
+ buildImageUrl: () => buildImageUrl,
54
+ createTMDB: () => createTMDB,
55
+ isKnownBackdropSize: () => isKnownBackdropSize,
56
+ isKnownImageSize: () => isKnownImageSize,
57
+ isKnownLogoSize: () => isKnownLogoSize,
58
+ isKnownPosterSize: () => isKnownPosterSize,
59
+ isKnownProfileSize: () => isKnownProfileSize,
60
+ isKnownStillSize: () => isKnownStillSize,
61
+ isMovie: () => isMovie,
62
+ isMovieSearchResult: () => isMovieSearchResult,
63
+ isPerson: () => isPerson,
64
+ isPersonSearchResult: () => isPersonSearchResult,
65
+ isTV: () => isTV,
66
+ isTVSearchResult: () => isTVSearchResult
67
+ });
68
+ module.exports = __toCommonJS(exports_src);
69
+
70
+ // src/errors.ts
71
+ class TMDBError extends Error {
72
+ constructor(message, options) {
73
+ super(message, options);
74
+ this.name = "TMDBError";
75
+ }
76
+ }
77
+
78
+ class TMDBRequestError extends TMDBError {
79
+ constructor(message, options) {
80
+ super(message, options);
81
+ this.name = "TMDBRequestError";
82
+ }
83
+ }
84
+
85
+ class TMDBResponseError extends TMDBError {
86
+ body;
87
+ headers;
88
+ requestId;
89
+ status;
90
+ statusCode;
91
+ statusMessage;
92
+ statusText;
93
+ url;
94
+ constructor(message, options) {
95
+ super(message);
96
+ this.name = "TMDBResponseError";
97
+ this.body = options.body;
98
+ this.headers = options.headers;
99
+ this.requestId = options.headers.get("x-request-id");
100
+ this.status = options.status;
101
+ this.statusText = options.statusText;
102
+ this.url = options.url;
103
+ const body = isErrorResponseBody(options.body) ? options.body : undefined;
104
+ this.statusCode = body?.status_code;
105
+ this.statusMessage = body?.status_message;
106
+ }
107
+ get isRateLimit() {
108
+ return this.status === 429;
109
+ }
110
+ get isNotFound() {
111
+ return this.status === 404;
112
+ }
113
+ get isUnauthorized() {
114
+ return this.status === 401;
115
+ }
116
+ get isForbidden() {
117
+ return this.status === 403;
118
+ }
119
+ get isServerError() {
120
+ return this.status >= 500 && this.status < 600;
121
+ }
122
+ }
123
+
124
+ class TMDBRateLimitError extends TMDBResponseError {
125
+ retryAfter;
126
+ constructor(message, options) {
127
+ super(message, options);
128
+ this.name = "TMDBRateLimitError";
129
+ this.retryAfter = options.retryAfter;
130
+ }
131
+ }
83
132
  function createResponseError(options) {
84
- const message = (isErrorResponseBody(options.body) ? options.body : void 0)?.status_message ?? `${options.status} ${options.statusText}`.trim();
85
- if (options.status === 429) return new TMDBRateLimitError(message, {
86
- ...options,
87
- retryAfter: parseRetryAfter(options.headers.get("retry-after"))
88
- });
89
- return new TMDBResponseError(message, options);
90
- }
91
- /**
92
- * Parse the `Retry-After` header into seconds. Accepts both delta-seconds
93
- * (e.g. "5") and HTTP-date forms (e.g. "Wed, 21 Oct 2026 07:28:00 GMT").
94
- * Falls back to 1 second when the header is missing or unparseable.
95
- */
133
+ const body = isErrorResponseBody(options.body) ? options.body : undefined;
134
+ const message = body?.status_message ?? `${options.status} ${options.statusText}`.trim();
135
+ if (options.status === 429) {
136
+ return new TMDBRateLimitError(message, {
137
+ ...options,
138
+ retryAfter: parseRetryAfter(options.headers.get("retry-after"))
139
+ });
140
+ }
141
+ return new TMDBResponseError(message, options);
142
+ }
96
143
  function parseRetryAfter(value) {
97
- if (value === null || value === void 0) return 1;
98
- const trimmed = value.trim();
99
- if (trimmed === "") return 1;
100
- const seconds = Number(trimmed);
101
- if (Number.isFinite(seconds) && seconds >= 0) return seconds;
102
- const date = Date.parse(trimmed);
103
- if (Number.isFinite(date)) {
104
- const deltaMs = date - Date.now();
105
- return Math.max(1, Math.ceil(deltaMs / 1e3));
106
- }
107
- return 1;
108
- }
109
- /** Check if a value has the shape of a TMDB error response body. */
144
+ if (value === null || value === undefined) {
145
+ return 1;
146
+ }
147
+ const trimmed = value.trim();
148
+ if (trimmed === "") {
149
+ return 1;
150
+ }
151
+ const seconds = Number(trimmed);
152
+ if (Number.isFinite(seconds) && seconds >= 0) {
153
+ return seconds;
154
+ }
155
+ const date = Date.parse(trimmed);
156
+ if (Number.isFinite(date)) {
157
+ const deltaMs = date - Date.now();
158
+ return Math.max(1, Math.ceil(deltaMs / 1000));
159
+ }
160
+ return 1;
161
+ }
110
162
  function isErrorResponseBody(value) {
111
- return typeof value === "object" && value !== null;
112
- }
113
- /**
114
- * Append query parameters to a URL object.
115
- *
116
- * - `undefined` and `null` values are skipped.
117
- * - Arrays are joined with commas (TMDB convention).
118
- * - All values are converted to strings.
119
- */
163
+ return typeof value === "object" && value !== null;
164
+ }
165
+
166
+ // src/query.ts
167
+ var DEFAULT_API_BASE_URL = "https://api.themoviedb.org/3";
168
+ var DEFAULT_IMAGE_BASE_URL = "https://image.tmdb.org/t/p";
120
169
  function appendQuery(url, query) {
121
- for (const [key, value] of Object.entries(query)) {
122
- if (value === void 0 || value === null) continue;
123
- if (Array.isArray(value)) {
124
- url.searchParams.set(key, value.map(String).join(","));
125
- continue;
126
- }
127
- url.searchParams.set(key, String(value));
128
- }
129
- }
130
- /**
131
- * Merge a language query parameter with client defaults.
132
- *
133
- * If `query.language` is set it takes precedence; otherwise the client's
134
- * default language is used.
135
- */
170
+ for (const [key, value] of Object.entries(query)) {
171
+ if (value === undefined || value === null) {
172
+ continue;
173
+ }
174
+ if (Array.isArray(value)) {
175
+ url.searchParams.set(key, value.map(String).join(","));
176
+ continue;
177
+ }
178
+ url.searchParams.set(key, String(value));
179
+ }
180
+ }
136
181
  function withLanguage(defaults, query) {
137
- const language = typeof query.language === "string" ? query.language : defaults.language;
138
- return {
139
- ...query,
140
- language
141
- };
142
- }
143
- /**
144
- * Merge language and region defaults for list endpoints.
145
- *
146
- * Combines {@link withLanguage} with region fallback from client defaults.
147
- */
182
+ const language = typeof query.language === "string" ? query.language : defaults.language;
183
+ return {
184
+ ...query,
185
+ language
186
+ };
187
+ }
148
188
  function withListDefaults(defaults, query) {
149
- const region = typeof query.region === "string" ? query.region : defaults.region;
150
- return {
151
- ...withLanguage(defaults, query),
152
- region
153
- };
154
- }
155
- /**
156
- * Convert a string or string array to a comma-separated list.
157
- *
158
- * Returns `undefined` if the input is `undefined` (skips the parameter).
159
- * TMDB uses comma-separated values for multi-value query parameters.
160
- */
189
+ const region = typeof query.region === "string" ? query.region : defaults.region;
190
+ return {
191
+ ...withLanguage(defaults, query),
192
+ region
193
+ };
194
+ }
161
195
  function toCommaList(value) {
162
- if (value === void 0) return;
163
- return typeof value === "string" ? value : value.join(",");
164
- }
165
- /**
166
- * Validate and convert a numeric ID to a string for use in URL paths.
167
- *
168
- * @throws {TMDBRequestError} If `value` is not a positive integer.
169
- */
196
+ if (value === undefined) {
197
+ return;
198
+ }
199
+ return typeof value === "string" ? value : value.join(",");
200
+ }
170
201
  function toId(value, name) {
171
- if (!Number.isInteger(value) || value <= 0) throw new TMDBRequestError(`${name} must be a positive integer`);
172
- return String(value);
173
- }
174
- /**
175
- * Validate and trim a search query string.
176
- *
177
- * @throws {TMDBRequestError} If the query is empty after trimming.
178
- */
202
+ if (!Number.isInteger(value) || value <= 0) {
203
+ throw new TMDBRequestError(`${name} must be a positive integer`);
204
+ }
205
+ return String(value);
206
+ }
179
207
  function toSearchQuery(value) {
180
- const query = value.trim();
181
- if (query.length === 0) throw new TMDBRequestError("search query must not be empty");
182
- return query;
183
- }
184
- /**
185
- * Validate a trending time window value.
186
- *
187
- * @throws {TMDBRequestError} If `value` is not `"day"` or `"week"`.
188
- */
208
+ const query = value.trim();
209
+ if (query.length === 0) {
210
+ throw new TMDBRequestError("search query must not be empty");
211
+ }
212
+ return query;
213
+ }
189
214
  function toTimeWindow(value) {
190
- if (value !== "day" && value !== "week") throw new TMDBRequestError("timeWindow must be either \"day\" or \"week\"");
191
- return value;
215
+ if (value !== "day" && value !== "week") {
216
+ throw new TMDBRequestError('timeWindow must be either "day" or "week"');
217
+ }
218
+ return value;
192
219
  }
193
- /**
194
- * Build a full TMDB image URL from the path returned by API payloads.
195
- * Returns null for nullish image paths so UI code can branch naturally.
196
- */
197
220
  function buildImageUrl(path, size = "original", options = {}) {
198
- if (path === void 0 || path === null || path.trim() === "") return null;
199
- const url = `${normalizeBaseUrl(options.baseUrl ?? "https://image.tmdb.org/t/p")}/${size}${path.startsWith("/") ? path : `/${path}`}`;
200
- return options.transform ? options.transform(url) : url;
221
+ if (path === undefined || path === null || path.trim() === "") {
222
+ return null;
223
+ }
224
+ const baseUrl = normalizeBaseUrl(options.baseUrl ?? DEFAULT_IMAGE_BASE_URL);
225
+ const normalizedPath = path.startsWith("/") ? path : `/${path}`;
226
+ const url = `${baseUrl}/${size}${normalizedPath}`;
227
+ return options.transform ? options.transform(url) : url;
201
228
  }
202
- /**
203
- * Strip trailing slashes from a base URL to ensure consistent path joining.
204
- */
205
229
  function normalizeBaseUrl(baseUrl) {
206
- return baseUrl.replace(/\/+$/, "");
207
- }
208
- //#endregion
209
- //#region src/http.ts
210
- /**
211
- * Built-in HTTP transport that uses the Fetch API.
212
- *
213
- * Handles authentication (API key or access token), URL construction,
214
- * request headers, and response parsing. Use the factory function
215
- * {@link createTMDB} instead of instantiating this directly.
216
- */
217
- var TMDBHttpClient = class {
218
- defaults;
219
- imageTransform;
220
- #apiKey;
221
- #accessToken;
222
- #baseUrl;
223
- #fetch;
224
- #headers;
225
- constructor(options) {
226
- const accessToken = normalizeSecret("accessToken" in options ? options.accessToken : void 0);
227
- const apiKey = normalizeSecret("apiKey" in options ? options.apiKey : void 0);
228
- if (Boolean(accessToken) === Boolean(apiKey)) throw new TMDBRequestError("Provide exactly one of accessToken or apiKey");
229
- this.#accessToken = accessToken;
230
- this.#apiKey = apiKey;
231
- this.#baseUrl = normalizeBaseUrl(options.baseUrl ?? "https://api.themoviedb.org/3");
232
- this.#fetch = options.fetch;
233
- this.#headers = options.headers;
234
- this.defaults = {
235
- imageBaseUrl: normalizeBaseUrl(options.imageBaseUrl ?? "https://image.tmdb.org/t/p"),
236
- language: options.defaultLanguage,
237
- region: options.defaultRegion
238
- };
239
- this.imageTransform = options.images?.transform;
240
- }
241
- async get(path, options = {}) {
242
- const url = this.#createUrl(path, options.query ?? {});
243
- const headers = this.#createHeaders(options.headers);
244
- const fetchImpl = this.#resolveFetch();
245
- let response;
246
- try {
247
- response = await fetchImpl(url, {
248
- headers,
249
- method: "GET",
250
- signal: options.signal
251
- });
252
- } catch (error) {
253
- throw new TMDBRequestError(`TMDB request failed: ${String(error)}`, { cause: error });
254
- }
255
- const body = await readJson(response);
256
- if (!response.ok) throw createResponseError({
257
- body,
258
- headers: response.headers,
259
- status: response.status,
260
- statusText: response.statusText,
261
- url
262
- });
263
- return body;
264
- }
265
- #resolveFetch() {
266
- if (this.#fetch !== void 0) return this.#fetch;
267
- const globalFetch = globalThis.fetch;
268
- if (typeof globalFetch !== "function") throw new TMDBRequestError("No fetch implementation found. Pass options.fetch in this runtime.");
269
- return globalFetch.bind(globalThis);
270
- }
271
- #createHeaders(headersInit) {
272
- const headers = new Headers(this.#headers);
273
- const requestHeaders = new Headers(headersInit);
274
- headers.set("Accept", "application/json");
275
- for (const [key, value] of requestHeaders) headers.set(key, value);
276
- if (this.#accessToken !== void 0) headers.set("Authorization", `Bearer ${this.#accessToken}`);
277
- return headers;
278
- }
279
- #createUrl(path, query) {
280
- const relativePath = path.replace(/^\/+/, "");
281
- const url = new URL(relativePath, `${this.#baseUrl}/`);
282
- appendQuery(url, {
283
- ...query,
284
- api_key: this.#apiKey
285
- });
286
- return url.toString();
287
- }
288
- };
289
- /**
290
- * Read and parse a JSON response body.
291
- *
292
- * Returns `undefined` for empty responses. If the body is not valid JSON,
293
- * the raw text string is returned as-is (TMDB occasionally returns plain
294
- * text for certain error conditions).
295
- */
230
+ return baseUrl.replace(/\/+$/, "");
231
+ }
232
+
233
+ // src/http.ts
234
+ class TMDBHttpClient {
235
+ defaults;
236
+ imageTransform;
237
+ #apiKey;
238
+ #accessToken;
239
+ #baseUrl;
240
+ #fetch;
241
+ #headers;
242
+ constructor(options) {
243
+ const accessToken = normalizeSecret("accessToken" in options ? options.accessToken : undefined);
244
+ const apiKey = normalizeSecret("apiKey" in options ? options.apiKey : undefined);
245
+ if (Boolean(accessToken) === Boolean(apiKey)) {
246
+ throw new TMDBRequestError("Provide exactly one of accessToken or apiKey");
247
+ }
248
+ this.#accessToken = accessToken;
249
+ this.#apiKey = apiKey;
250
+ this.#baseUrl = normalizeBaseUrl(options.baseUrl ?? DEFAULT_API_BASE_URL);
251
+ this.#fetch = options.fetch;
252
+ this.#headers = options.headers;
253
+ this.defaults = {
254
+ imageBaseUrl: normalizeBaseUrl(options.imageBaseUrl ?? DEFAULT_IMAGE_BASE_URL),
255
+ language: options.defaultLanguage,
256
+ region: options.defaultRegion
257
+ };
258
+ this.imageTransform = options.images?.transform;
259
+ }
260
+ async get(path, options = {}) {
261
+ const url = this.#createUrl(path, options.query ?? {});
262
+ const headers = this.#createHeaders(options.headers);
263
+ const fetchImpl = this.#resolveFetch();
264
+ let response;
265
+ try {
266
+ response = await fetchImpl(url, {
267
+ headers,
268
+ method: "GET",
269
+ signal: options.signal
270
+ });
271
+ } catch (error) {
272
+ throw new TMDBRequestError(`TMDB request failed: ${String(error)}`, { cause: error });
273
+ }
274
+ const body = await readJson(response);
275
+ if (!response.ok) {
276
+ throw createResponseError({
277
+ body,
278
+ headers: response.headers,
279
+ status: response.status,
280
+ statusText: response.statusText,
281
+ url
282
+ });
283
+ }
284
+ return body;
285
+ }
286
+ #resolveFetch() {
287
+ if (this.#fetch !== undefined) {
288
+ return this.#fetch;
289
+ }
290
+ const globalFetch = globalThis.fetch;
291
+ if (typeof globalFetch !== "function") {
292
+ throw new TMDBRequestError("No fetch implementation found. Pass options.fetch in this runtime.");
293
+ }
294
+ return globalFetch.bind(globalThis);
295
+ }
296
+ #createHeaders(headersInit) {
297
+ const headers = new Headers(this.#headers);
298
+ const requestHeaders = new Headers(headersInit);
299
+ headers.set("Accept", "application/json");
300
+ for (const [key, value] of requestHeaders) {
301
+ headers.set(key, value);
302
+ }
303
+ if (this.#accessToken !== undefined) {
304
+ headers.set("Authorization", `Bearer ${this.#accessToken}`);
305
+ }
306
+ return headers;
307
+ }
308
+ #createUrl(path, query) {
309
+ const relativePath = path.replace(/^\/+/, "");
310
+ const url = new URL(relativePath, `${this.#baseUrl}/`);
311
+ appendQuery(url, {
312
+ ...query,
313
+ api_key: this.#apiKey
314
+ });
315
+ return url.toString();
316
+ }
317
+ }
296
318
  async function readJson(response) {
297
- const text = await response.text();
298
- if (text.length === 0) return;
299
- try {
300
- return JSON.parse(text);
301
- } catch {
302
- return text;
303
- }
304
- }
305
- /**
306
- * Normalize a secret value by trimming whitespace and treating empty
307
- * strings as undefined (not provided).
308
- */
319
+ const text = await response.text();
320
+ if (text.length === 0) {
321
+ return;
322
+ }
323
+ try {
324
+ return JSON.parse(text);
325
+ } catch {
326
+ return text;
327
+ }
328
+ }
309
329
  function normalizeSecret(value) {
310
- const secret = value?.trim();
311
- return secret === "" ? void 0 : secret;
312
- }
313
- //#endregion
314
- //#region src/resources/configuration.ts
315
- /**
316
- * Access TMDB configuration data (image sizes, countries, languages, etc.).
317
- *
318
- * Obtained via `client.configuration`.
319
- */
320
- var ConfigurationResource = class {
321
- #transport;
322
- constructor(transport) {
323
- this.#transport = transport;
324
- }
325
- details() {
326
- return this.#transport.get("/configuration");
327
- }
328
- countries() {
329
- return this.#transport.get("/configuration/countries");
330
- }
331
- jobs() {
332
- return this.#transport.get("/configuration/jobs");
333
- }
334
- languages() {
335
- return this.#transport.get("/configuration/languages");
336
- }
337
- primaryTranslations() {
338
- return this.#transport.get("/configuration/primary_translations");
339
- }
340
- timezones() {
341
- return this.#transport.get("/configuration/timezones");
342
- }
343
- };
344
- //#endregion
345
- //#region src/resources/genres.ts
346
- /**
347
- * Access TMDB genre lists for movies and TV shows.
348
- *
349
- * Obtained via `client.genres`.
350
- */
351
- var GenresResource = class {
352
- #transport;
353
- constructor(transport) {
354
- this.#transport = transport;
355
- }
356
- movies(options = {}) {
357
- return this.#transport.get("/genre/movie/list", { query: withLanguage(this.#transport.defaults, { language: options.language }) });
358
- }
359
- tv(options = {}) {
360
- return this.#transport.get("/genre/tv/list", { query: withLanguage(this.#transport.defaults, { language: options.language }) });
361
- }
362
- };
363
- //#endregion
364
- //#region src/resources/images.ts
365
- /**
366
- * Helper for constructing TMDB image URLs from API path values.
367
- *
368
- * Obtained via `client.images`. Supports optional URL transforms for
369
- * routing image requests through a CDN or proxy.
370
- */
371
- var ImagesHelper = class {
372
- #transport;
373
- #transform;
374
- constructor(transport, transform) {
375
- this.#transport = transport;
376
- this.#transform = transform;
377
- }
378
- url(path, size = "original", options = {}) {
379
- return buildImageUrl(path, size, {
380
- baseUrl: this.#transport.defaults.imageBaseUrl,
381
- transform: options.transform ?? this.#transform
382
- });
383
- }
384
- };
385
- //#endregion
386
- //#region src/resources/movies.ts
387
- /**
388
- * Access TMDB movie endpoints (popular, top-rated, details, credits, etc.).
389
- *
390
- * Obtained via `client.movies`.
391
- */
392
- var MoviesResource = class {
393
- #transport;
394
- constructor(transport) {
395
- this.#transport = transport;
396
- }
397
- popular(options = {}) {
398
- return this.#transport.get("/movie/popular", { query: movieListQuery(this.#transport, options) });
399
- }
400
- topRated(options = {}) {
401
- return this.#transport.get("/movie/top_rated", { query: movieListQuery(this.#transport, options) });
402
- }
403
- nowPlaying(options = {}) {
404
- return this.#transport.get("/movie/now_playing", { query: movieListQuery(this.#transport, options) });
405
- }
406
- upcoming(options = {}) {
407
- return this.#transport.get("/movie/upcoming", { query: movieListQuery(this.#transport, options) });
408
- }
409
- details(movieId, options = {}) {
410
- return this.#transport.get(`/movie/${toId(movieId, "movieId")}`, { query: withLanguage(this.#transport.defaults, {
411
- append_to_response: toCommaList(options.appendToResponse),
412
- language: options.language
413
- }) });
414
- }
415
- credits(movieId, options = {}) {
416
- return this.#transport.get(`/movie/${toId(movieId, "movieId")}/credits`, { query: withLanguage(this.#transport.defaults, { language: options.language }) });
417
- }
418
- images(movieId, options = {}) {
419
- return this.#transport.get(`/movie/${toId(movieId, "movieId")}/images`, { query: withLanguage(this.#transport.defaults, {
420
- include_image_language: toCommaList(options.includeImageLanguage),
421
- language: options.language
422
- }) });
423
- }
424
- recommendations(movieId, options = {}) {
425
- return this.#transport.get(`/movie/${toId(movieId, "movieId")}/recommendations`, { query: movieListQuery(this.#transport, options) });
426
- }
427
- similar(movieId, options = {}) {
428
- return this.#transport.get(`/movie/${toId(movieId, "movieId")}/similar`, { query: movieListQuery(this.#transport, options) });
429
- }
430
- videos(movieId, options = {}) {
431
- return this.#transport.get(`/movie/${toId(movieId, "movieId")}/videos`, { query: withLanguage(this.#transport.defaults, { language: options.language }) });
432
- }
433
- };
434
- /** Build query parameters for movie list endpoints. */
330
+ const secret = value?.trim();
331
+ return secret === "" ? undefined : secret;
332
+ }
333
+
334
+ // src/resources/configuration.ts
335
+ class ConfigurationResource {
336
+ #transport;
337
+ constructor(transport) {
338
+ this.#transport = transport;
339
+ }
340
+ details() {
341
+ return this.#transport.get("/configuration");
342
+ }
343
+ countries() {
344
+ return this.#transport.get("/configuration/countries");
345
+ }
346
+ jobs() {
347
+ return this.#transport.get("/configuration/jobs");
348
+ }
349
+ languages() {
350
+ return this.#transport.get("/configuration/languages");
351
+ }
352
+ primaryTranslations() {
353
+ return this.#transport.get("/configuration/primary_translations");
354
+ }
355
+ timezones() {
356
+ return this.#transport.get("/configuration/timezones");
357
+ }
358
+ }
359
+
360
+ // src/resources/genres.ts
361
+ class GenresResource {
362
+ #transport;
363
+ constructor(transport) {
364
+ this.#transport = transport;
365
+ }
366
+ movies(options = {}) {
367
+ return this.#transport.get("/genre/movie/list", {
368
+ query: withLanguage(this.#transport.defaults, {
369
+ language: options.language
370
+ })
371
+ });
372
+ }
373
+ tv(options = {}) {
374
+ return this.#transport.get("/genre/tv/list", {
375
+ query: withLanguage(this.#transport.defaults, {
376
+ language: options.language
377
+ })
378
+ });
379
+ }
380
+ }
381
+
382
+ // src/resources/images.ts
383
+ class ImagesHelper {
384
+ #transport;
385
+ #transform;
386
+ constructor(transport, transform) {
387
+ this.#transport = transport;
388
+ this.#transform = transform;
389
+ }
390
+ url(path, size = "original", options = {}) {
391
+ return buildImageUrl(path, size, {
392
+ baseUrl: this.#transport.defaults.imageBaseUrl,
393
+ transform: options.transform ?? this.#transform
394
+ });
395
+ }
396
+ }
397
+
398
+ // src/resources/movies.ts
399
+ class MoviesResource {
400
+ #transport;
401
+ constructor(transport) {
402
+ this.#transport = transport;
403
+ }
404
+ popular(options = {}) {
405
+ return this.#transport.get("/movie/popular", {
406
+ query: movieListQuery(this.#transport, options)
407
+ });
408
+ }
409
+ topRated(options = {}) {
410
+ return this.#transport.get("/movie/top_rated", {
411
+ query: movieListQuery(this.#transport, options)
412
+ });
413
+ }
414
+ nowPlaying(options = {}) {
415
+ return this.#transport.get("/movie/now_playing", {
416
+ query: movieListQuery(this.#transport, options)
417
+ });
418
+ }
419
+ upcoming(options = {}) {
420
+ return this.#transport.get("/movie/upcoming", {
421
+ query: movieListQuery(this.#transport, options)
422
+ });
423
+ }
424
+ details(movieId, options = {}) {
425
+ return this.#transport.get(`/movie/${toId(movieId, "movieId")}`, {
426
+ query: withLanguage(this.#transport.defaults, {
427
+ append_to_response: toCommaList(options.appendToResponse),
428
+ language: options.language
429
+ })
430
+ });
431
+ }
432
+ credits(movieId, options = {}) {
433
+ return this.#transport.get(`/movie/${toId(movieId, "movieId")}/credits`, {
434
+ query: withLanguage(this.#transport.defaults, {
435
+ language: options.language
436
+ })
437
+ });
438
+ }
439
+ images(movieId, options = {}) {
440
+ return this.#transport.get(`/movie/${toId(movieId, "movieId")}/images`, {
441
+ query: withLanguage(this.#transport.defaults, {
442
+ include_image_language: toCommaList(options.includeImageLanguage),
443
+ language: options.language
444
+ })
445
+ });
446
+ }
447
+ recommendations(movieId, options = {}) {
448
+ return this.#transport.get(`/movie/${toId(movieId, "movieId")}/recommendations`, {
449
+ query: movieListQuery(this.#transport, options)
450
+ });
451
+ }
452
+ similar(movieId, options = {}) {
453
+ return this.#transport.get(`/movie/${toId(movieId, "movieId")}/similar`, {
454
+ query: movieListQuery(this.#transport, options)
455
+ });
456
+ }
457
+ videos(movieId, options = {}) {
458
+ return this.#transport.get(`/movie/${toId(movieId, "movieId")}/videos`, {
459
+ query: withLanguage(this.#transport.defaults, {
460
+ language: options.language
461
+ })
462
+ });
463
+ }
464
+ }
435
465
  function movieListQuery(transport, options) {
436
- return withListDefaults(transport.defaults, {
437
- language: options.language,
438
- page: options.page,
439
- region: options.region
440
- });
441
- }
442
- //#endregion
443
- //#region src/resources/people.ts
444
- /**
445
- * Access TMDB person (actor, director, etc.) endpoints.
446
- *
447
- * Obtained via `client.people`.
448
- */
449
- var PeopleResource = class {
450
- #transport;
451
- constructor(transport) {
452
- this.#transport = transport;
453
- }
454
- popular(options = {}) {
455
- return this.#transport.get("/person/popular", { query: peopleListQuery(this.#transport, options) });
456
- }
457
- details(personId, options = {}) {
458
- return this.#transport.get(`/person/${toId(personId, "personId")}`, { query: withLanguage(this.#transport.defaults, { language: options.language }) });
459
- }
460
- };
461
- /** Build query parameters for person list endpoints. */
466
+ return withListDefaults(transport.defaults, {
467
+ language: options.language,
468
+ page: options.page,
469
+ region: options.region
470
+ });
471
+ }
472
+
473
+ // src/resources/people.ts
474
+ class PeopleResource {
475
+ #transport;
476
+ constructor(transport) {
477
+ this.#transport = transport;
478
+ }
479
+ popular(options = {}) {
480
+ return this.#transport.get("/person/popular", {
481
+ query: peopleListQuery(this.#transport, options)
482
+ });
483
+ }
484
+ details(personId, options = {}) {
485
+ return this.#transport.get(`/person/${toId(personId, "personId")}`, {
486
+ query: withLanguage(this.#transport.defaults, {
487
+ language: options.language
488
+ })
489
+ });
490
+ }
491
+ combinedCredits(personId, options = {}) {
492
+ return this.#transport.get(`/person/${toId(personId, "personId")}/combined_credits`, {
493
+ query: withLanguage(this.#transport.defaults, {
494
+ language: options.language
495
+ })
496
+ });
497
+ }
498
+ }
462
499
  function peopleListQuery(transport, options) {
463
- return withLanguage(transport.defaults, {
464
- language: options.language,
465
- page: options.page
466
- });
467
- }
468
- //#endregion
469
- //#region src/resources/search.ts
470
- /**
471
- * Search TMDB for movies, TV shows, people, or all media types.
472
- *
473
- * Obtained via `client.search`.
474
- */
475
- var SearchResource = class {
476
- #transport;
477
- constructor(transport) {
478
- this.#transport = transport;
479
- }
480
- movies(query, options = {}) {
481
- return this.#transport.get("/search/movie", { query: movieSearchQuery(this.#transport, query, options) });
482
- }
483
- tv(query, options = {}) {
484
- return this.#transport.get("/search/tv", { query: tvSearchQuery(this.#transport, query, options) });
485
- }
486
- people(query, options = {}) {
487
- return this.#transport.get("/search/person", { query: commonSearchQuery(this.#transport, query, options) });
488
- }
489
- async multi(query, options = {}) {
490
- const response = await this.#transport.get("/search/multi", { query: commonSearchQuery(this.#transport, query, options) });
491
- const excluded = options.exclude;
492
- if (excluded === void 0 || excluded.length === 0) return response;
493
- const excludedSet = new Set(excluded);
494
- return {
495
- ...response,
496
- results: response.results.filter((result) => !excludedSet.has(result.media_type))
497
- };
498
- }
499
- };
500
- /** Build query parameters for movie search. */
500
+ return withLanguage(transport.defaults, {
501
+ language: options.language,
502
+ page: options.page
503
+ });
504
+ }
505
+
506
+ // src/resources/search.ts
507
+ class SearchResource {
508
+ #transport;
509
+ constructor(transport) {
510
+ this.#transport = transport;
511
+ }
512
+ movies(query, options = {}) {
513
+ return this.#transport.get("/search/movie", {
514
+ query: movieSearchQuery(this.#transport, query, options)
515
+ });
516
+ }
517
+ tv(query, options = {}) {
518
+ return this.#transport.get("/search/tv", {
519
+ query: tvSearchQuery(this.#transport, query, options)
520
+ });
521
+ }
522
+ people(query, options = {}) {
523
+ return this.#transport.get("/search/person", {
524
+ query: commonSearchQuery(this.#transport, query, options)
525
+ });
526
+ }
527
+ async multi(query, options = {}) {
528
+ const response = await this.#transport.get("/search/multi", {
529
+ query: commonSearchQuery(this.#transport, query, options)
530
+ });
531
+ const excluded = options.exclude;
532
+ if (excluded === undefined || excluded.length === 0) {
533
+ return response;
534
+ }
535
+ const excludedSet = new Set(excluded);
536
+ return {
537
+ ...response,
538
+ results: response.results.filter((result) => !excludedSet.has(result.media_type))
539
+ };
540
+ }
541
+ }
501
542
  function movieSearchQuery(transport, query, options) {
502
- return withListDefaults(transport.defaults, {
503
- include_adult: options.includeAdult,
504
- language: options.language,
505
- page: options.page,
506
- primary_release_year: options.primaryReleaseYear,
507
- query: toSearchQuery(query),
508
- region: options.region,
509
- year: options.year
510
- });
511
- }
512
- /** Build query parameters for TV search. */
543
+ return withListDefaults(transport.defaults, {
544
+ include_adult: options.includeAdult,
545
+ language: options.language,
546
+ page: options.page,
547
+ primary_release_year: options.primaryReleaseYear,
548
+ query: toSearchQuery(query),
549
+ region: options.region,
550
+ year: options.year
551
+ });
552
+ }
513
553
  function tvSearchQuery(transport, query, options) {
514
- return withLanguage(transport.defaults, {
515
- first_air_date_year: options.firstAirDateYear,
516
- include_adult: options.includeAdult,
517
- language: options.language,
518
- page: options.page,
519
- query: toSearchQuery(query),
520
- year: options.year
521
- });
522
- }
523
- /** Build query parameters for person and multi-search. */
554
+ return withLanguage(transport.defaults, {
555
+ first_air_date_year: options.firstAirDateYear,
556
+ include_adult: options.includeAdult,
557
+ language: options.language,
558
+ page: options.page,
559
+ query: toSearchQuery(query),
560
+ year: options.year
561
+ });
562
+ }
524
563
  function commonSearchQuery(transport, query, options) {
525
- return withLanguage(transport.defaults, {
526
- include_adult: options.includeAdult,
527
- language: options.language,
528
- page: options.page,
529
- query: toSearchQuery(query)
530
- });
531
- }
532
- //#endregion
533
- //#region src/resources/trending.ts
534
- /**
535
- * Access TMDB trending content (movies, TV, people) for day/week windows.
536
- *
537
- * Obtained via `client.trending`.
538
- */
539
- var TrendingResource = class {
540
- #transport;
541
- constructor(transport) {
542
- this.#transport = transport;
543
- }
544
- all(timeWindow = "day", options = {}) {
545
- return this.#transport.get(`/trending/all/${toTimeWindow(timeWindow)}`, { query: withLanguage(this.#transport.defaults, { language: options.language }) });
546
- }
547
- movies(timeWindow = "day", options = {}) {
548
- return this.#transport.get(`/trending/movie/${toTimeWindow(timeWindow)}`, { query: withLanguage(this.#transport.defaults, { language: options.language }) });
549
- }
550
- tv(timeWindow = "day", options = {}) {
551
- return this.#transport.get(`/trending/tv/${toTimeWindow(timeWindow)}`, { query: withLanguage(this.#transport.defaults, { language: options.language }) });
552
- }
553
- people(timeWindow = "day", options = {}) {
554
- return this.#transport.get(`/trending/person/${toTimeWindow(timeWindow)}`, { query: withLanguage(this.#transport.defaults, { language: options.language }) });
555
- }
556
- };
557
- //#endregion
558
- //#region src/resources/tv.ts
559
- /**
560
- * Access TMDB TV show endpoints (popular, top-rated, details, seasons, etc.).
561
- *
562
- * Obtained via `client.tv`.
563
- */
564
- var TVResource = class {
565
- #transport;
566
- constructor(transport) {
567
- this.#transport = transport;
568
- }
569
- popular(options = {}) {
570
- return this.#transport.get("/tv/popular", { query: tvListQuery(this.#transport, options) });
571
- }
572
- topRated(options = {}) {
573
- return this.#transport.get("/tv/top_rated", { query: tvListQuery(this.#transport, options) });
574
- }
575
- airingToday(options = {}) {
576
- return this.#transport.get("/tv/airing_today", { query: tvListQuery(this.#transport, options) });
577
- }
578
- onTheAir(options = {}) {
579
- return this.#transport.get("/tv/on_the_air", { query: tvListQuery(this.#transport, options) });
580
- }
581
- details(seriesId, options = {}) {
582
- return this.#transport.get(`/tv/${toId(seriesId, "seriesId")}`, { query: withLanguage(this.#transport.defaults, {
583
- append_to_response: toCommaList(options.appendToResponse),
584
- language: options.language
585
- }) });
586
- }
587
- credits(seriesId, options = {}) {
588
- return this.#transport.get(`/tv/${toId(seriesId, "seriesId")}/credits`, { query: withLanguage(this.#transport.defaults, { language: options.language }) });
589
- }
590
- images(seriesId, options = {}) {
591
- return this.#transport.get(`/tv/${toId(seriesId, "seriesId")}/images`, { query: withLanguage(this.#transport.defaults, {
592
- include_image_language: toCommaList(options.includeImageLanguage),
593
- language: options.language
594
- }) });
595
- }
596
- recommendations(seriesId, options = {}) {
597
- return this.#transport.get(`/tv/${toId(seriesId, "seriesId")}/recommendations`, { query: tvListQuery(this.#transport, options) });
598
- }
599
- similar(seriesId, options = {}) {
600
- return this.#transport.get(`/tv/${toId(seriesId, "seriesId")}/similar`, { query: tvListQuery(this.#transport, options) });
601
- }
602
- videos(seriesId, options = {}) {
603
- return this.#transport.get(`/tv/${toId(seriesId, "seriesId")}/videos`, { query: withLanguage(this.#transport.defaults, { language: options.language }) });
604
- }
605
- seasonDetails(seriesId, seasonNumber, options = {}) {
606
- return this.#transport.get(`/tv/${toId(seriesId, "seriesId")}/season/${toId(seasonNumber, "seasonNumber")}`, { query: withLanguage(this.#transport.defaults, {
607
- append_to_response: toCommaList(options.appendToResponse),
608
- language: options.language
609
- }) });
610
- }
611
- };
612
- /** Build query parameters for TV list endpoints. */
564
+ return withLanguage(transport.defaults, {
565
+ include_adult: options.includeAdult,
566
+ language: options.language,
567
+ page: options.page,
568
+ query: toSearchQuery(query)
569
+ });
570
+ }
571
+
572
+ // src/resources/trending.ts
573
+ class TrendingResource {
574
+ #transport;
575
+ constructor(transport) {
576
+ this.#transport = transport;
577
+ }
578
+ all(timeWindow = "day", options = {}) {
579
+ return this.#transport.get(`/trending/all/${toTimeWindow(timeWindow)}`, {
580
+ query: withLanguage(this.#transport.defaults, {
581
+ language: options.language,
582
+ page: options.page
583
+ })
584
+ });
585
+ }
586
+ movies(timeWindow = "day", options = {}) {
587
+ return this.#transport.get(`/trending/movie/${toTimeWindow(timeWindow)}`, {
588
+ query: withLanguage(this.#transport.defaults, {
589
+ language: options.language,
590
+ page: options.page
591
+ })
592
+ });
593
+ }
594
+ tv(timeWindow = "day", options = {}) {
595
+ return this.#transport.get(`/trending/tv/${toTimeWindow(timeWindow)}`, {
596
+ query: withLanguage(this.#transport.defaults, {
597
+ language: options.language,
598
+ page: options.page
599
+ })
600
+ });
601
+ }
602
+ people(timeWindow = "day", options = {}) {
603
+ return this.#transport.get(`/trending/person/${toTimeWindow(timeWindow)}`, {
604
+ query: withLanguage(this.#transport.defaults, {
605
+ language: options.language,
606
+ page: options.page
607
+ })
608
+ });
609
+ }
610
+ }
611
+
612
+ // src/resources/tv.ts
613
+ class TVResource {
614
+ #transport;
615
+ constructor(transport) {
616
+ this.#transport = transport;
617
+ }
618
+ popular(options = {}) {
619
+ return this.#transport.get("/tv/popular", {
620
+ query: tvListQuery(this.#transport, options)
621
+ });
622
+ }
623
+ topRated(options = {}) {
624
+ return this.#transport.get("/tv/top_rated", {
625
+ query: tvListQuery(this.#transport, options)
626
+ });
627
+ }
628
+ airingToday(options = {}) {
629
+ return this.#transport.get("/tv/airing_today", {
630
+ query: tvListQuery(this.#transport, options)
631
+ });
632
+ }
633
+ onTheAir(options = {}) {
634
+ return this.#transport.get("/tv/on_the_air", {
635
+ query: tvListQuery(this.#transport, options)
636
+ });
637
+ }
638
+ details(seriesId, options = {}) {
639
+ return this.#transport.get(`/tv/${toId(seriesId, "seriesId")}`, {
640
+ query: withLanguage(this.#transport.defaults, {
641
+ append_to_response: toCommaList(options.appendToResponse),
642
+ language: options.language
643
+ })
644
+ });
645
+ }
646
+ credits(seriesId, options = {}) {
647
+ return this.#transport.get(`/tv/${toId(seriesId, "seriesId")}/credits`, {
648
+ query: withLanguage(this.#transport.defaults, {
649
+ language: options.language
650
+ })
651
+ });
652
+ }
653
+ images(seriesId, options = {}) {
654
+ return this.#transport.get(`/tv/${toId(seriesId, "seriesId")}/images`, {
655
+ query: withLanguage(this.#transport.defaults, {
656
+ include_image_language: toCommaList(options.includeImageLanguage),
657
+ language: options.language
658
+ })
659
+ });
660
+ }
661
+ recommendations(seriesId, options = {}) {
662
+ return this.#transport.get(`/tv/${toId(seriesId, "seriesId")}/recommendations`, {
663
+ query: tvListQuery(this.#transport, options)
664
+ });
665
+ }
666
+ similar(seriesId, options = {}) {
667
+ return this.#transport.get(`/tv/${toId(seriesId, "seriesId")}/similar`, {
668
+ query: tvListQuery(this.#transport, options)
669
+ });
670
+ }
671
+ videos(seriesId, options = {}) {
672
+ return this.#transport.get(`/tv/${toId(seriesId, "seriesId")}/videos`, {
673
+ query: withLanguage(this.#transport.defaults, {
674
+ language: options.language
675
+ })
676
+ });
677
+ }
678
+ seasonDetails(seriesId, seasonNumber, options = {}) {
679
+ return this.#transport.get(`/tv/${toId(seriesId, "seriesId")}/season/${toId(seasonNumber, "seasonNumber")}`, {
680
+ query: withLanguage(this.#transport.defaults, {
681
+ append_to_response: toCommaList(options.appendToResponse),
682
+ language: options.language
683
+ })
684
+ });
685
+ }
686
+ }
613
687
  function tvListQuery(transport, options) {
614
- return withLanguage(transport.defaults, {
615
- language: options.language,
616
- page: options.page
617
- });
618
- }
619
- //#endregion
620
- //#region src/client.ts
621
- /**
622
- * Main SDK entry point.
623
- *
624
- * Resource properties are intentionally small and explicit. The SDK focuses on
625
- * common TMDB workflows first, while request<T>() keeps uncommon endpoints easy
626
- * to call without waiting for a generated surface area.
627
- */
628
- var TMDBClient = class {
629
- configuration;
630
- genres;
631
- images;
632
- movies;
633
- people;
634
- search;
635
- trending;
636
- tv;
637
- #transport;
638
- constructor(options) {
639
- const { transport, images, ...httpOptions } = options;
640
- const fallbackTransform = images?.transform;
641
- const builtInClient = transport === void 0 ? new TMDBHttpClient({
642
- ...httpOptions,
643
- images
644
- }) : void 0;
645
- this.#transport = builtInClient ?? transport;
646
- this.configuration = new ConfigurationResource(this.#transport);
647
- this.genres = new GenresResource(this.#transport);
648
- this.images = new ImagesHelper(this.#transport, builtInClient ? builtInClient.imageTransform : fallbackTransform);
649
- this.movies = new MoviesResource(this.#transport);
650
- this.people = new PeopleResource(this.#transport);
651
- this.search = new SearchResource(this.#transport);
652
- this.trending = new TrendingResource(this.#transport);
653
- this.tv = new TVResource(this.#transport);
654
- }
655
- /**
656
- * Make a raw GET request to any TMDB endpoint.
657
- *
658
- * This is an escape hatch for endpoints not covered by the typed resource
659
- * helpers. The `path` should be relative to the API base URL (e.g.
660
- * `/movie/{id}/credits`). Response is parsed as JSON and cast to `T`.
661
- *
662
- * @param path - API path relative to the base URL (e.g. `/movie/123`)
663
- * @param options - Optional request-level overrides (headers, query, signal)
664
- * @returns Parsed JSON response typed as `T`
665
- */
666
- request(path, options) {
667
- return this.#transport.get(path, options);
668
- }
669
- };
670
- /**
671
- * Create a new {@link TMDBClient} instance.
672
- *
673
- * @example
674
- * ```ts
675
- * const tmdb = createTMDB({ accessToken: 'YOUR_TOKEN' })
676
- * const { results } = await tmdb.search.movies('Inception')
677
- * ```
678
- *
679
- * @param options - Authentication and configuration options
680
- * @returns A configured TMDBClient ready to make API calls
681
- */
688
+ return withLanguage(transport.defaults, {
689
+ language: options.language,
690
+ page: options.page
691
+ });
692
+ }
693
+
694
+ // src/client.ts
695
+ class TMDBClient {
696
+ configuration;
697
+ genres;
698
+ images;
699
+ movies;
700
+ people;
701
+ search;
702
+ trending;
703
+ tv;
704
+ #transport;
705
+ constructor(options) {
706
+ const { transport, images, ...httpOptions } = options;
707
+ const fallbackTransform = images?.transform;
708
+ const builtInClient = transport === undefined ? new TMDBHttpClient({ ...httpOptions, images }) : undefined;
709
+ this.#transport = builtInClient ?? transport;
710
+ this.configuration = new ConfigurationResource(this.#transport);
711
+ this.genres = new GenresResource(this.#transport);
712
+ this.images = new ImagesHelper(this.#transport, builtInClient ? builtInClient.imageTransform : fallbackTransform);
713
+ this.movies = new MoviesResource(this.#transport);
714
+ this.people = new PeopleResource(this.#transport);
715
+ this.search = new SearchResource(this.#transport);
716
+ this.trending = new TrendingResource(this.#transport);
717
+ this.tv = new TVResource(this.#transport);
718
+ }
719
+ request(path, options) {
720
+ return this.#transport.get(path, options);
721
+ }
722
+ }
682
723
  function createTMDB(options) {
683
- return new TMDBClient(options);
724
+ return new TMDBClient(options);
684
725
  }
685
- //#endregion
686
- //#region src/search-guards.ts
726
+ // src/search-guards.ts
687
727
  function isMovieSearchResult(result) {
688
- return isObjectWithMediaType(result, "movie");
728
+ return isObjectWithMediaType(result, "movie");
689
729
  }
690
730
  function isTVSearchResult(result) {
691
- return isObjectWithMediaType(result, "tv");
731
+ return isObjectWithMediaType(result, "tv");
692
732
  }
693
733
  function isPersonSearchResult(result) {
694
- return isObjectWithMediaType(result, "person");
734
+ return isObjectWithMediaType(result, "person");
695
735
  }
696
736
  function isMovie(result) {
697
- return isObjectWithMediaType(result, "movie");
737
+ return isObjectWithMediaType(result, "movie");
698
738
  }
699
739
  function isTV(result) {
700
- return isObjectWithMediaType(result, "tv");
740
+ return isObjectWithMediaType(result, "tv");
701
741
  }
702
742
  function isPerson(result) {
703
- return isObjectWithMediaType(result, "person");
743
+ return isObjectWithMediaType(result, "person");
704
744
  }
705
- /** Internal helper: check if a value is an object with a matching `media_type` field. */
706
745
  function isObjectWithMediaType(value, mediaType) {
707
- return typeof value === "object" && value !== null && "media_type" in value && value.media_type === mediaType;
708
- }
709
- //#endregion
710
- //#region src/types.ts
711
- /**
712
- * Public set of image sizes TMDB currently documents. The SDK does not
713
- * pin to a static copy of the TMDB docs — TMDB has added new sizes in
714
- * the past (e.g. `h632` for profile) without notice — but exposing the
715
- * canonical list lets callers:
716
- *
717
- * - iterate over the set to build a size picker
718
- * - validate user-supplied sizes with `isKnownBackdropSize(...)` etc.
719
- * - type a variable as a "known" size without giving up the
720
- * `(string & {})` escape hatch for forward-compatibility
721
- *
722
- * If TMDB publishes a new size, the SDK will still accept it at runtime
723
- * (every helper is `(string & {})` permissive), but you will need to
724
- * add the literal to these constants to get autocomplete on it.
725
- */
726
- const KNOWN_BACKDROP_SIZES = Object.freeze([
727
- "w300",
728
- "w780",
729
- "w1280",
730
- "original"
746
+ return typeof value === "object" && value !== null && "media_type" in value && value.media_type === mediaType;
747
+ }
748
+ // src/types.ts
749
+ var KNOWN_BACKDROP_SIZES = Object.freeze([
750
+ "w300",
751
+ "w780",
752
+ "w1280",
753
+ "original"
731
754
  ]);
732
- const KNOWN_LOGO_SIZES = Object.freeze([
733
- "w45",
734
- "w92",
735
- "w154",
736
- "w185",
737
- "w300",
738
- "w500",
739
- "original"
755
+ var KNOWN_LOGO_SIZES = Object.freeze(["w45", "w92", "w154", "w185", "w300", "w500", "original"]);
756
+ var KNOWN_POSTER_SIZES = Object.freeze(["w92", "w154", "w185", "w342", "w500", "w780", "original"]);
757
+ var KNOWN_PROFILE_SIZES = Object.freeze([
758
+ "w45",
759
+ "w185",
760
+ "h632",
761
+ "original"
740
762
  ]);
741
- const KNOWN_POSTER_SIZES = Object.freeze([
742
- "w92",
743
- "w154",
744
- "w185",
745
- "w342",
746
- "w500",
747
- "w780",
748
- "original"
763
+ var KNOWN_STILL_SIZES = Object.freeze([
764
+ "w92",
765
+ "w185",
766
+ "w300",
767
+ "original"
749
768
  ]);
750
- const KNOWN_PROFILE_SIZES = Object.freeze([
751
- "w45",
752
- "w185",
753
- "h632",
754
- "original"
769
+ var KNOWN_IMAGE_SIZES = Object.freeze([
770
+ ...KNOWN_BACKDROP_SIZES,
771
+ ...KNOWN_LOGO_SIZES,
772
+ ...KNOWN_POSTER_SIZES,
773
+ ...KNOWN_PROFILE_SIZES,
774
+ ...KNOWN_STILL_SIZES
755
775
  ]);
756
- const KNOWN_STILL_SIZES = Object.freeze([
757
- "w92",
758
- "w185",
759
- "w300",
760
- "original"
761
- ]);
762
- /** Union of every documented image size. */
763
- const KNOWN_IMAGE_SIZES = Object.freeze([
764
- ...KNOWN_BACKDROP_SIZES,
765
- ...KNOWN_LOGO_SIZES,
766
- ...KNOWN_POSTER_SIZES,
767
- ...KNOWN_PROFILE_SIZES,
768
- ...KNOWN_STILL_SIZES
769
- ]);
770
- /** O(1) membership check backed by a Set. */
771
- const KNOWN_BACKDROP_SET = new Set(KNOWN_BACKDROP_SIZES);
772
- const KNOWN_LOGO_SET = new Set(KNOWN_LOGO_SIZES);
773
- const KNOWN_POSTER_SET = new Set(KNOWN_POSTER_SIZES);
774
- const KNOWN_PROFILE_SET = new Set(KNOWN_PROFILE_SIZES);
775
- const KNOWN_STILL_SET = new Set(KNOWN_STILL_SIZES);
776
- const KNOWN_IMAGE_SET = new Set(KNOWN_IMAGE_SIZES);
776
+ var KNOWN_BACKDROP_SET = new Set(KNOWN_BACKDROP_SIZES);
777
+ var KNOWN_LOGO_SET = new Set(KNOWN_LOGO_SIZES);
778
+ var KNOWN_POSTER_SET = new Set(KNOWN_POSTER_SIZES);
779
+ var KNOWN_PROFILE_SET = new Set(KNOWN_PROFILE_SIZES);
780
+ var KNOWN_STILL_SET = new Set(KNOWN_STILL_SIZES);
781
+ var KNOWN_IMAGE_SET = new Set(KNOWN_IMAGE_SIZES);
777
782
  function isKnownBackdropSize(value) {
778
- return KNOWN_BACKDROP_SET.has(value);
783
+ return KNOWN_BACKDROP_SET.has(value);
779
784
  }
780
785
  function isKnownLogoSize(value) {
781
- return KNOWN_LOGO_SET.has(value);
786
+ return KNOWN_LOGO_SET.has(value);
782
787
  }
783
788
  function isKnownPosterSize(value) {
784
- return KNOWN_POSTER_SET.has(value);
789
+ return KNOWN_POSTER_SET.has(value);
785
790
  }
786
791
  function isKnownProfileSize(value) {
787
- return KNOWN_PROFILE_SET.has(value);
792
+ return KNOWN_PROFILE_SET.has(value);
788
793
  }
789
794
  function isKnownStillSize(value) {
790
- return KNOWN_STILL_SET.has(value);
795
+ return KNOWN_STILL_SET.has(value);
791
796
  }
792
- /** True if `value` is in any documented size set. */
793
797
  function isKnownImageSize(value) {
794
- return KNOWN_IMAGE_SET.has(value);
795
- }
796
- //#endregion
797
- exports.KNOWN_BACKDROP_SIZES = KNOWN_BACKDROP_SIZES;
798
- exports.KNOWN_IMAGE_SIZES = KNOWN_IMAGE_SIZES;
799
- exports.KNOWN_LOGO_SIZES = KNOWN_LOGO_SIZES;
800
- exports.KNOWN_POSTER_SIZES = KNOWN_POSTER_SIZES;
801
- exports.KNOWN_PROFILE_SIZES = KNOWN_PROFILE_SIZES;
802
- exports.KNOWN_STILL_SIZES = KNOWN_STILL_SIZES;
803
- exports.TMDBClient = TMDBClient;
804
- exports.TMDBError = TMDBError;
805
- exports.TMDBRateLimitError = TMDBRateLimitError;
806
- exports.TMDBRequestError = TMDBRequestError;
807
- exports.TMDBResponseError = TMDBResponseError;
808
- exports.buildImageUrl = buildImageUrl;
809
- exports.createTMDB = createTMDB;
810
- exports.isKnownBackdropSize = isKnownBackdropSize;
811
- exports.isKnownImageSize = isKnownImageSize;
812
- exports.isKnownLogoSize = isKnownLogoSize;
813
- exports.isKnownPosterSize = isKnownPosterSize;
814
- exports.isKnownProfileSize = isKnownProfileSize;
815
- exports.isKnownStillSize = isKnownStillSize;
816
- exports.isMovie = isMovie;
817
- exports.isMovieSearchResult = isMovieSearchResult;
818
- exports.isPerson = isPerson;
819
- exports.isPersonSearchResult = isPersonSearchResult;
820
- exports.isTV = isTV;
821
- exports.isTVSearchResult = isTVSearchResult;
798
+ return KNOWN_IMAGE_SET.has(value);
799
+ }
822
800
 
823
- //# sourceMappingURL=index.cjs.map
801
+ //# debugId=CD39AE1F6030D61F64756E2164756E21
802
+ //# sourceMappingURL=index.cjs.map