@saeris/tmdbkit 0.0.0-stage → 0.1.0

package/dist/requests/request.mjs

@@ -0,0 +1,62 @@
+import { tmdb } from "./TmdbSession.mjs";
+import { isObject } from "../utils/isObject.mjs";
+import { toCamelKeys } from "../utils/toCamelKeys.mjs";
+import { toSnakeKeys } from "../utils/toSnakeKeys.mjs";
+// src/requests/request.ts
+/**
+* A structured error thrown when the TMDB API responds with a non-2xx status. TMDB reports failures as `{ status_code, status_message }` in the body; `statusCode` is `0` when the body didn't carry one.
+*
+* The message names the method and path but never the query string, which can hold a v3 `api_key`.
+*/
+var TmdbApiError = class extends Error {
+	status;
+	statusCode;
+	statusMessage;
+	constructor(status, statusCode, statusMessage, request) {
+		const where = request ? ` for ${request.method} ${request.path}` : ``;
+		super(`TMDB API error ${status} (${statusCode})${where}: ${statusMessage}`);
+		this.name = `TmdbApiError`;
+		this.status = status;
+		this.statusCode = statusCode;
+		this.statusMessage = statusMessage;
+	}
+};
+const request = async (resource, method = `GET`, body, options) => {
+	if (!tmdb.hasAuth) tmdb.resolveAuth();
+	/**
+	* Serialize the body. TMDB expects snake_case keys, so the (camelCase) request object is converted before it is stringified.
+	*/
+	const serializeBody = () => {
+		if (!body) return body;
+		try {
+			return JSON.stringify(toSnakeKeys(body));
+		} catch (cause) {
+			throw new Error(`Failed to serialize request body!`, { cause });
+		}
+	};
+	const res = await tmdb.fetch(resource, {
+		method,
+		body: serializeBody(),
+		signal: options?.signal
+	});
+	if (!res.ok) {
+		let statusCode = 0;
+		let statusMessage = res.statusText;
+		try {
+			const err = await res.json();
+			if (isObject(err)) {
+				if (typeof err.status_code === `number`) statusCode = err.status_code;
+				if (typeof err.status_message === `string`) statusMessage = err.status_message;
+			}
+		} catch {}
+		throw new TmdbApiError(res.status, statusCode, statusMessage, {
+			method,
+			path: resource.pathname
+		});
+	}
+	if (res.status === 204) return;
+	return toCamelKeys(await res.json());
+};
+export { TmdbApiError, request };
+
+//# sourceMappingURL=request.mjs.map

package/dist/requests/request.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.mjs","names":[],"sources":["../../src/requests/request.ts"],"sourcesContent":["import { tmdb } from \"./TmdbSession.js\";\nimport { isObject } from \"../utils/isObject.js\";\nimport { toCamelKeys } from \"../utils/toCamelKeys.js\";\nimport { toSnakeKeys } from \"../utils/toSnakeKeys.js\";\n\nexport type RequestBody = object | null | undefined;\n\n/**\n * The HTTP methods the TMDB REST API uses, and the only ones the typed helpers in `methods.ts` emit. Most of TMDB is read-only `GET`; the account, list, rating and session endpoints also `POST` and `DELETE`.\n */\nexport type RequestMethod = `GET` | `POST` | `PUT` | `PATCH` | `DELETE`;\n\n/**\n * Per-call options a {@link Fetcher} accepts as its last argument and forwards to the request layer.\n */\nexport interface RequestOptions {\n  /** Abort the request: while it waits for a rate-limit slot, while it is in flight, or while it backs off before a retry. */\n  signal?: AbortSignal;\n}\n\n/**\n * A structured error thrown when the TMDB API responds with a non-2xx status. TMDB reports failures as `{ status_code, status_message }` in the body; `statusCode` is `0` when the body didn't carry one.\n *\n * The message names the method and path but never the query string, which can hold a v3 `api_key`.\n */\nexport class TmdbApiError extends Error {\n  readonly status: number;\n  readonly statusCode: number;\n  readonly statusMessage: string;\n\n  constructor(\n    status: number,\n    statusCode: number,\n    statusMessage: string,\n    request?: { method: RequestMethod; path: string }\n  ) {\n    const where = request ? ` for ${request.method} ${request.path}` : ``;\n    super(`TMDB API error ${status} (${statusCode})${where}: ${statusMessage}`);\n    this.name = `TmdbApiError`;\n    this.status = status;\n    this.statusCode = statusCode;\n    this.statusMessage = statusMessage;\n  }\n}\n\nexport const request = async <T>(\n  resource: URL,\n  method: RequestMethod = `GET`,\n  body?: RequestBody,\n  options?: RequestOptions\n): Promise<T> => {\n  // Fail early with a clear message if no credentials are configured.\n  if (!tmdb.hasAuth) {\n    tmdb.resolveAuth(); // throws the canonical \"No TMDB credentials\" error\n  }\n\n  /**\n   * Serialize the body. TMDB expects snake_case keys, so the (camelCase) request object is converted before it is stringified.\n   */\n  const serializeBody = (): string | null | undefined => {\n    if (!body) return body;\n    try {\n      return JSON.stringify(toSnakeKeys(body));\n    } catch (cause) {\n      throw new Error(`Failed to serialize request body!`, { cause });\n    }\n  };\n\n  const res = await tmdb.fetch(resource, {\n    method,\n    body: serializeBody(),\n    signal: options?.signal\n  });\n\n  if (!res.ok) {\n    let statusCode = 0;\n    let statusMessage = res.statusText;\n    try {\n      const err: unknown = await res.json();\n      if (isObject(err)) {\n        if (typeof err.status_code === `number`) statusCode = err.status_code;\n        if (typeof err.status_message === `string`) {\n          statusMessage = err.status_message;\n        }\n      }\n    } catch {\n      // Body was not JSON — fall back to the status text.\n    }\n    throw new TmdbApiError(res.status, statusCode, statusMessage, {\n      method,\n      path: resource.pathname\n    });\n  }\n\n  // Return `void` on `204 No Content` responses.\n  if (res.status === 204) {\n    // @ts-expect-error\n    return;\n  }\n\n  // TMDB is snake_case on the wire; convert to camelCase at the boundary so the rest of the app is camelCase.\n  return toCamelKeys(await res.json());\n};\n"],"mappings":";;;;;;;;;;AAyBA,IAAa,eAAb,cAAkC,MAAM;CACtC;CACA;CACA;CAEA,YACE,QACA,YACA,eACA,SACA;EACA,MAAM,QAAQ,UAAU,QAAQ,QAAQ,OAAO,GAAG,QAAQ,SAAS;EACnE,MAAM,kBAAkB,OAAO,IAAI,WAAW,GAAG,MAAM,IAAI,eAAe;EAC1E,KAAK,OAAO;EACZ,KAAK,SAAS;EACd,KAAK,aAAa;EAClB,KAAK,gBAAgB;CACvB;AACF;AAEA,MAAa,UAAU,OACrB,UACA,SAAwB,OACxB,MACA,YACe;CAEf,IAAI,CAAC,KAAK,SACR,KAAK,YAAY;;;;CAMnB,MAAM,sBAAiD;EACrD,IAAI,CAAC,MAAM,OAAO;EAClB,IAAI;GACF,OAAO,KAAK,UAAU,YAAY,IAAI,CAAC;EACzC,SAAS,OAAO;GACd,MAAM,IAAI,MAAM,qCAAqC,EAAE,MAAM,CAAC;EAChE;CACF;CAEA,MAAM,MAAM,MAAM,KAAK,MAAM,UAAU;EACrC;EACA,MAAM,cAAc;EACpB,QAAQ,SAAS;CACnB,CAAC;CAED,IAAI,CAAC,IAAI,IAAI;EACX,IAAI,aAAa;EACjB,IAAI,gBAAgB,IAAI;EACxB,IAAI;GACF,MAAM,MAAe,MAAM,IAAI,KAAK;GACpC,IAAI,SAAS,GAAG,GAAG;IACjB,IAAI,OAAO,IAAI,gBAAgB,UAAU,aAAa,IAAI;IAC1D,IAAI,OAAO,IAAI,mBAAmB,UAChC,gBAAgB,IAAI;GAExB;EACF,QAAQ,CAER;EACA,MAAM,IAAI,aAAa,IAAI,QAAQ,YAAY,eAAe;GAC5D;GACA,MAAM,SAAS;EACjB,CAAC;CACH;CAGA,IAAI,IAAI,WAAW,KAEjB;CAIF,OAAO,YAAY,MAAM,IAAI,KAAK,CAAC;AACrC"}

package/dist/requests/toValidated.d.mts

@@ -0,0 +1,11 @@
+import { Fetcher } from "./methods.mjs";
+import { GenericSchema, GenericSchemaAsync } from "valibot";
+/**
+ * Given a {@link Fetcher} and its input and output Valibot schemas, return a new {@link Fetcher} that validates its input before the request is sent and its result before it resolves. Useful wherever the input comes from outside your app, or wherever you want a TMDB response shape change to fail loudly at the boundary.
+ *
+ * The resolved value is the fetched value itself (as in discordkit): tmdbkit's schemas have no transforms, so the parsed and fetched values are the same.
+ *
+ * @__NO_SIDE_EFFECTS__
+ */
+export declare const toValidated: <S extends GenericSchema | GenericSchemaAsync | null = null, R = void>(fn: Fetcher<S, R>, input?: S | null, output?: GenericSchema<unknown, R> | GenericSchemaAsync<unknown, R>) => Fetcher<S, R>;
+//# sourceMappingURL=toValidated.d.mts.map

package/dist/requests/toValidated.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toValidated.d.mts","names":[],"sources":["../../src/requests/toValidated.ts"],"mappings":";;;;;;;;;qBAgBa,cACX,UAAU,gBAAgB,kCAC1B,UAEA,IAAI,QAAQ,GAAG,IACf,QAAQ,UACR,SAAS,uBAAuB,KAAK,4BAA4B,OAChE,QAAQ,GAAG"}

package/dist/requests/toValidated.mjs

@@ -0,0 +1,24 @@
+import { isOfKind, safeParseAsync, summarize } from "valibot";
+// src/requests/toValidated.ts
+/**
+* Given a {@link Fetcher} and its input and output Valibot schemas, return a new {@link Fetcher} that validates its input before the request is sent and its result before it resolves. Useful wherever the input comes from outside your app, or wherever you want a TMDB response shape change to fail loudly at the boundary.
+*
+* The resolved value is the fetched value itself (as in discordkit): tmdbkit's schemas have no transforms, so the parsed and fetched values are the same.
+*
+* @__NO_SIDE_EFFECTS__
+*/
+const toValidated = (fn, input, output) => new Proxy(fn, { async apply(target, _, args) {
+	if (input && isOfKind(`schema`, input)) {
+		const { issues } = await safeParseAsync(input, args[0]);
+		if (issues) throw new Error(`Failed to parse input schema: ${input.reference.name}\n\n${summarize(issues)}`);
+	}
+	const result = await target(...args);
+	if (output && isOfKind(`schema`, output)) {
+		const { issues } = await safeParseAsync(output, result);
+		if (issues) throw new Error(`Failed to parse output schema: ${output.reference.name}\n\n${summarize(issues)}`);
+	}
+	return result;
+} });
+export { toValidated };
+
+//# sourceMappingURL=toValidated.mjs.map

package/dist/requests/toValidated.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"toValidated.mjs","names":["call"],"sources":["../../src/requests/toValidated.ts"],"sourcesContent":["import {\n  type GenericSchema,\n  type GenericSchemaAsync,\n  isOfKind,\n  safeParseAsync,\n  summarize\n} from \"valibot\";\nimport type { Fetcher } from \"./methods.js\";\n\n/**\n * Given a {@link Fetcher} and its input and output Valibot schemas, return a new {@link Fetcher} that validates its input before the request is sent and its result before it resolves. Useful wherever the input comes from outside your app, or wherever you want a TMDB response shape change to fail loudly at the boundary.\n *\n * The resolved value is the fetched value itself (as in discordkit): tmdbkit's schemas have no transforms, so the parsed and fetched values are the same.\n *\n * @__NO_SIDE_EFFECTS__\n */\nexport const toValidated = <\n  S extends GenericSchema | GenericSchemaAsync | null = null,\n  R = void\n>(\n  fn: Fetcher<S, R>,\n  input?: S | null,\n  output?: GenericSchema<unknown, R> | GenericSchemaAsync<unknown, R>\n): Fetcher<S, R> =>\n  new Proxy<Fetcher<S, R>>(fn, {\n    async apply(target, _, args: unknown[]): Promise<R> {\n      // Validate the fetcher args before fetching. Fetchers without an input schema take only the options.\n      if (input && isOfKind(`schema`, input)) {\n        const { issues } = await safeParseAsync(input, args[0]);\n        if (issues) {\n          throw new Error(\n            `Failed to parse input schema: ${input.reference.name}\\n\\n${summarize(issues)}`\n          );\n        }\n      }\n\n      // Forward every argument, including the per-call options (signal). `Fetcher<S, R>` is a conditional type, so the proxy target can't be called without erasing it first; the result is `R` by the fetcher's own signature.\n      // oxlint-disable-next-line typescript/no-unsafe-type-assertion\n      const call = target as unknown as (\n        ...rest: unknown[]\n      ) => Promise<unknown>;\n      // oxlint-disable-next-line typescript/no-unsafe-type-assertion\n      const result = (await call(...args)) as R;\n\n      // Validate the result of the fetch call before returning.\n      if (output && isOfKind(`schema`, output)) {\n        const { issues } = await safeParseAsync(output, result);\n        if (issues) {\n          throw new Error(\n            `Failed to parse output schema: ${output.reference.name}\\n\\n${summarize(issues)}`\n          );\n        }\n      }\n\n      return result;\n    }\n  });\n"],"mappings":";;;;;;;;;AAgBA,MAAa,eAIX,IACA,OACA,WAEA,IAAI,MAAqB,IAAI,EAC3B,MAAM,MAAM,QAAQ,GAAG,MAA6B;CAElD,IAAI,SAAS,SAAS,UAAU,KAAK,GAAG;EACtC,MAAM,EAAE,WAAW,MAAM,eAAe,OAAO,KAAK,EAAE;EACtD,IAAI,QACF,MAAM,IAAI,MACR,iCAAiC,MAAM,UAAU,KAAK,MAAM,UAAU,MAAM,GAC9E;CAEJ;CAQA,MAAM,SAAU,MAAMA,OAAK,GAAG,IAAI;CAGlC,IAAI,UAAU,SAAS,UAAU,MAAM,GAAG;EACxC,MAAM,EAAE,WAAW,MAAM,eAAe,QAAQ,MAAM;EACtD,IAAI,QACF,MAAM,IAAI,MACR,kCAAkC,OAAO,UAAU,KAAK,MAAM,UAAU,MAAM,GAChF;CAEJ;CAEA,OAAO;AACT,EACF,CAAC"}

package/dist/review/getReview.d.mts

@@ -0,0 +1,13 @@
+import { Fetcher } from "../requests/methods.mjs";
+import { ReviewDetails } from "./types/Review.mjs";
+import * as v from "valibot";
+export declare const getReviewSchema: v.ObjectSchema<{
+  readonly reviewId: v.StringSchema<undefined>;
+}, undefined>;
+/**
+ * ### [Details](https://developer.themoviedb.org/reference/review-details)
+ *
+ * **GET** `/review/{review_id}`
+ */
+export declare const getReview: Fetcher<typeof getReviewSchema, ReviewDetails>;
+//# sourceMappingURL=getReview.d.mts.map

package/dist/review/getReview.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getReview.d.mts","names":[],"sources":["../../src/review/getReview.ts"],"mappings":";;;qBAIa,iBAAe,EAAA;;;;;;;;qBASf,WAAW,eAAe,iBAAiB"}

package/dist/review/getReview.mjs

@@ -0,0 +1,13 @@
+import { get } from "../requests/methods.mjs";
+import * as v from "valibot";
+// src/review/getReview.ts
+const getReviewSchema = v.object({ reviewId: v.string() });
+/**
+* ### [Details](https://developer.themoviedb.org/reference/review-details)
+*
+* **GET** `/review/{review_id}`
+*/
+const getReview = async ({ reviewId }, options) => get(`/review/${encodeURIComponent(reviewId)}`, void 0, options);
+export { getReview, getReviewSchema };
+
+//# sourceMappingURL=getReview.mjs.map

package/dist/review/getReview.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"getReview.mjs","names":[],"sources":["../../src/review/getReview.ts"],"sourcesContent":["import * as v from \"valibot\";\nimport { get, type Fetcher } from \"../requests/methods.js\";\nimport type { ReviewDetails } from \"./types/Review.js\";\n\nexport const getReviewSchema = v.object({\n  reviewId: v.string()\n});\n\n/**\n * ### [Details](https://developer.themoviedb.org/reference/review-details)\n *\n * **GET** `/review/{review_id}`\n */\nexport const getReview: Fetcher<typeof getReviewSchema, ReviewDetails> = async (\n  { reviewId },\n  options\n) => get(`/review/${encodeURIComponent(reviewId)}`, undefined, options);\n"],"mappings":";;;AAIA,MAAa,kBAAkB,EAAE,OAAO,EACtC,UAAU,EAAE,OAAO,EACrB,CAAC;;;;;;AAOD,MAAa,YAA4D,OACvE,EAAE,YACF,YACG,IAAI,WAAW,mBAAmB,QAAQ,KAAK,KAAA,GAAW,OAAO"}

package/dist/review/index.d.mts

@@ -0,0 +1,4 @@
+import { Review, ReviewDetails, Reviews, reviewDetailsSchema, reviewEntries, reviewSchema, reviewsSchema } from "./types/Review.mjs";
+import { getReview, getReviewSchema } from "./getReview.mjs";
+import "./types/index.mjs";
+export { Review, ReviewDetails, Reviews, getReview, getReviewSchema, reviewDetailsSchema, reviewEntries, reviewSchema, reviewsSchema };

package/dist/review/index.mjs

@@ -0,0 +1,3 @@
+import { reviewDetailsSchema, reviewEntries, reviewSchema, reviewsSchema } from "./types/Review.mjs";
+import { getReview, getReviewSchema } from "./getReview.mjs";
+export { getReview, getReviewSchema, reviewDetailsSchema, reviewEntries, reviewSchema, reviewsSchema };

package/dist/review/types/Review.d.mts

@@ -0,0 +1,79 @@
+import * as v from "valibot";
+export declare const reviewEntries: {
+  readonly id: v.StringSchema<undefined>;
+  readonly author: v.StringSchema<undefined>;
+  readonly authorDetails: v.ObjectSchema<{
+    /** `""` when the author hasn't set one. */
+    readonly name: v.StringSchema<undefined>;
+    readonly username: v.StringSchema<undefined>;
+    readonly avatarPath: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    /** Out of 10, or `null` when the review has no rating. */
+    readonly rating: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+  }, undefined>;
+  readonly content: v.StringSchema<undefined>;
+  /** ISO 8601 timestamp. */
+  readonly createdAt: v.StringSchema<undefined>;
+  readonly updatedAt: v.StringSchema<undefined>;
+  readonly url: v.StringSchema<undefined>;
+};
+declare const _reviewSchema: v.ObjectSchema<{
+  readonly id: v.StringSchema<undefined>;
+  readonly author: v.StringSchema<undefined>;
+  readonly authorDetails: v.ObjectSchema<{
+    /** `""` when the author hasn't set one. */
+    readonly name: v.StringSchema<undefined>;
+    readonly username: v.StringSchema<undefined>;
+    readonly avatarPath: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    /** Out of 10, or `null` when the review has no rating. */
+    readonly rating: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+  }, undefined>;
+  readonly content: v.StringSchema<undefined>;
+  /** ISO 8601 timestamp. */
+  readonly createdAt: v.StringSchema<undefined>;
+  readonly updatedAt: v.StringSchema<undefined>;
+  readonly url: v.StringSchema<undefined>;
+}, undefined>;
+export interface Review extends v.InferOutput<typeof _reviewSchema> {}
+/**
+ * ### Review
+ *
+ * A user review of a movie or TV series.
+ */
+export declare const reviewSchema: v.GenericSchema<Review>;
+declare const _reviewsSchema: v.ObjectSchema<{
+  readonly results: v.ArraySchema<v.GenericSchema<Review>, undefined>;
+  readonly page: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
+  readonly totalPages: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
+  readonly totalResults: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
+  readonly id: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
+}, undefined>;
+export interface Reviews extends v.InferOutput<typeof _reviewsSchema> {}
+/** A page of a movie's or TV series' reviews (`getMovieReviews`, `getTvSeriesReviews`). */
+export declare const reviewsSchema: v.GenericSchema<Reviews>;
+declare const _reviewDetailsSchema: v.ObjectSchema<{
+  readonly iso_639_1: v.StringSchema<undefined>;
+  readonly mediaId: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
+  readonly mediaTitle: v.StringSchema<undefined>;
+  /** `movie` or `tv`. */
+  readonly mediaType: v.StringSchema<undefined>;
+  readonly id: v.StringSchema<undefined>;
+  readonly author: v.StringSchema<undefined>;
+  readonly authorDetails: v.ObjectSchema<{
+    /** `""` when the author hasn't set one. */
+    readonly name: v.StringSchema<undefined>;
+    readonly username: v.StringSchema<undefined>;
+    readonly avatarPath: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    /** Out of 10, or `null` when the review has no rating. */
+    readonly rating: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+  }, undefined>;
+  readonly content: v.StringSchema<undefined>;
+  /** ISO 8601 timestamp. */
+  readonly createdAt: v.StringSchema<undefined>;
+  readonly updatedAt: v.StringSchema<undefined>;
+  readonly url: v.StringSchema<undefined>;
+}, undefined>;
+export interface ReviewDetails extends v.InferOutput<typeof _reviewDetailsSchema> {}
+/** One review with the title it's about (`getReview`). */
+export declare const reviewDetailsSchema: v.GenericSchema<ReviewDetails>;
+export {};
+//# sourceMappingURL=Review.d.mts.map

package/dist/review/types/Review.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Review.d.mts","names":[],"sources":["../../../src/review/types/Review.ts"],"mappings":";qBAKa;;;;;;;;;;;;;;;;;cAkBP,eAAa,EAAA;;;;;;;;;;;;;;;;;iBAEF,eAAe,EAAE,mBAAmB;;;;;;qBAOxC,cAAY,EAAA,cAAA;cAEnB,gBAAc,EAAA;;;;;;;iBAMH,gBAAgB,EAAE,mBAAmB;;qBAGzC,eAAa,EAAA,cAAA;cAEpB,sBAAoB,EAAA;;;;;;;;;;;;;;;;;;;;;;iBAST,sBAAsB,EAAE,mBAChC;;qBAII,qBAAmB,EAAA,cAAA"}

package/dist/review/types/Review.mjs

@@ -0,0 +1,49 @@
+import { schema } from "../../validations/schema.mjs";
+import { integer } from "../../validations/integer.mjs";
+import { pageEntries } from "../../types/PagedResults.mjs";
+import * as v from "valibot";
+// src/review/types/Review.ts
+const reviewEntries = {
+	id: v.string(),
+	author: v.string(),
+	authorDetails: v.object({
+		/** `""` when the author hasn't set one. */
+		name: v.string(),
+		username: v.string(),
+		avatarPath: v.nullable(v.string()),
+		/** Out of 10, or `null` when the review has no rating. */
+		rating: v.nullable(v.number())
+	}),
+	content: v.string(),
+	/** ISO 8601 timestamp. */
+	createdAt: v.string(),
+	updatedAt: v.string(),
+	url: v.string()
+};
+const _reviewSchema = v.object(reviewEntries);
+/**
+* ### Review
+*
+* A user review of a movie or TV series.
+*/
+const reviewSchema = schema(_reviewSchema);
+const _reviewsSchema = v.object({
+	id: integer,
+	...pageEntries,
+	results: v.array(reviewSchema)
+});
+/** A page of a movie's or TV series' reviews (`getMovieReviews`, `getTvSeriesReviews`). */
+const reviewsSchema = schema(_reviewsSchema);
+const _reviewDetailsSchema = v.object({
+	...reviewEntries,
+	iso_639_1: v.string(),
+	mediaId: integer,
+	mediaTitle: v.string(),
+	/** `movie` or `tv`. */
+	mediaType: v.string()
+});
+/** One review with the title it's about (`getReview`). */
+const reviewDetailsSchema = schema(_reviewDetailsSchema);
+export { reviewDetailsSchema, reviewEntries, reviewSchema, reviewsSchema };
+
+//# sourceMappingURL=Review.mjs.map

package/dist/review/types/Review.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Review.mjs","names":[],"sources":["../../../src/review/types/Review.ts"],"sourcesContent":["import * as v from \"valibot\";\nimport { schema } from \"../../validations/schema.js\";\nimport { integer } from \"../../validations/integer.js\";\nimport { pageEntries } from \"../../types/PagedResults.js\";\n\nexport const reviewEntries = {\n  id: v.string(),\n  author: v.string(),\n  authorDetails: v.object({\n    /** `\"\"` when the author hasn't set one. */\n    name: v.string(),\n    username: v.string(),\n    avatarPath: v.nullable(v.string()),\n    /** Out of 10, or `null` when the review has no rating. */\n    rating: v.nullable(v.number())\n  }),\n  content: v.string(),\n  /** ISO 8601 timestamp. */\n  createdAt: v.string(),\n  updatedAt: v.string(),\n  url: v.string()\n} as const;\n\nconst _reviewSchema = v.object(reviewEntries);\n\nexport interface Review extends v.InferOutput<typeof _reviewSchema> {}\n\n/**\n * ### Review\n *\n * A user review of a movie or TV series.\n */\nexport const reviewSchema = schema<Review>(_reviewSchema);\n\nconst _reviewsSchema = v.object({\n  id: integer,\n  ...pageEntries,\n  results: v.array(reviewSchema)\n});\n\nexport interface Reviews extends v.InferOutput<typeof _reviewsSchema> {}\n\n/** A page of a movie's or TV series' reviews (`getMovieReviews`, `getTvSeriesReviews`). */\nexport const reviewsSchema = schema<Reviews>(_reviewsSchema);\n\nconst _reviewDetailsSchema = v.object({\n  ...reviewEntries,\n  iso_639_1: v.string(),\n  mediaId: integer,\n  mediaTitle: v.string(),\n  /** `movie` or `tv`. */\n  mediaType: v.string()\n});\n\nexport interface ReviewDetails extends v.InferOutput<\n  typeof _reviewDetailsSchema\n> {}\n\n/** One review with the title it's about (`getReview`). */\nexport const reviewDetailsSchema = schema<ReviewDetails>(_reviewDetailsSchema);\n"],"mappings":";;;;;AAKA,MAAa,gBAAgB;CAC3B,IAAI,EAAE,OAAO;CACb,QAAQ,EAAE,OAAO;CACjB,eAAe,EAAE,OAAO;;EAEtB,MAAM,EAAE,OAAO;EACf,UAAU,EAAE,OAAO;EACnB,YAAY,EAAE,SAAS,EAAE,OAAO,CAAC;;EAEjC,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC;CAC/B,CAAC;CACD,SAAS,EAAE,OAAO;;CAElB,WAAW,EAAE,OAAO;CACpB,WAAW,EAAE,OAAO;CACpB,KAAK,EAAE,OAAO;AAChB;AAEA,MAAM,gBAAgB,EAAE,OAAO,aAAa;;;;;;AAS5C,MAAa,eAAe,OAAe,aAAa;AAExD,MAAM,iBAAiB,EAAE,OAAO;CAC9B,IAAI;CACJ,GAAG;CACH,SAAS,EAAE,MAAM,YAAY;AAC/B,CAAC;;AAKD,MAAa,gBAAgB,OAAgB,cAAc;AAE3D,MAAM,uBAAuB,EAAE,OAAO;CACpC,GAAG;CACH,WAAW,EAAE,OAAO;CACpB,SAAS;CACT,YAAY,EAAE,OAAO;;CAErB,WAAW,EAAE,OAAO;AACtB,CAAC;;AAOD,MAAa,sBAAsB,OAAsB,oBAAoB"}

package/dist/review/types/index.d.mts

@@ -0,0 +1,2 @@
+import { Review, ReviewDetails, Reviews, reviewDetailsSchema, reviewEntries, reviewSchema, reviewsSchema } from "./Review.mjs";
+export { Review, ReviewDetails, Reviews, reviewDetailsSchema, reviewEntries, reviewSchema, reviewsSchema };

package/dist/review/types/index.mjs

@@ -0,0 +1 @@
+export { reviewDetailsSchema, reviewEntries, reviewSchema, reviewsSchema } from "./Review.mjs";

package/dist/search/index.d.mts

@@ -0,0 +1,8 @@
+import { searchCollections, searchCollectionsSchema } from "./searchCollections.mjs";
+import { searchCompanies, searchCompaniesSchema } from "./searchCompanies.mjs";
+import { searchKeywords, searchKeywordsSchema } from "./searchKeywords.mjs";
+import { searchMovies, searchMoviesSchema } from "./searchMovies.mjs";
+import { searchMulti, searchMultiSchema } from "./searchMulti.mjs";
+import { searchPeople, searchPeopleSchema } from "./searchPeople.mjs";
+import { searchTvSeries, searchTvSeriesSchema } from "./searchTvSeries.mjs";
+export { searchCollections, searchCollectionsSchema, searchCompanies, searchCompaniesSchema, searchKeywords, searchKeywordsSchema, searchMovies, searchMoviesSchema, searchMulti, searchMultiSchema, searchPeople, searchPeopleSchema, searchTvSeries, searchTvSeriesSchema };

package/dist/search/index.mjs

@@ -0,0 +1,8 @@
+import { searchCollections, searchCollectionsSchema } from "./searchCollections.mjs";
+import { searchCompanies, searchCompaniesSchema } from "./searchCompanies.mjs";
+import { searchKeywords, searchKeywordsSchema } from "./searchKeywords.mjs";
+import { searchMovies, searchMoviesSchema } from "./searchMovies.mjs";
+import { searchMulti, searchMultiSchema } from "./searchMulti.mjs";
+import { searchPeople, searchPeopleSchema } from "./searchPeople.mjs";
+import { searchTvSeries, searchTvSeriesSchema } from "./searchTvSeries.mjs";
+export { searchCollections, searchCollectionsSchema, searchCompanies, searchCompaniesSchema, searchKeywords, searchKeywordsSchema, searchMovies, searchMoviesSchema, searchMulti, searchMultiSchema, searchPeople, searchPeopleSchema, searchTvSeries, searchTvSeriesSchema };

package/dist/search/searchCollections.d.mts

@@ -0,0 +1,58 @@
+import { Fetcher } from "../requests/methods.mjs";
+import { PagedCollectionResults } from "../collection/types/CollectionListItem.mjs";
+import * as v from "valibot";
+export declare const searchCollectionsSchema: v.ObjectSchema<{
+  readonly query: v.StringSchema<undefined>;
+  readonly params: v.ExactOptionalSchema<Omit<v.ObjectSchema<{
+    readonly includeAdult: v.BooleanSchema<undefined>;
+    readonly language: v.StringSchema<undefined>;
+    readonly page: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
+    readonly region: v.StringSchema<undefined>;
+  }, undefined>, "~types" | "~run" | "~standard" | "entries"> & {
+    readonly entries: {
+      readonly includeAdult: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+      readonly language: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+      readonly page: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>, undefined>;
+      readonly region: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    };
+    readonly "~standard": v.StandardProps<{
+      includeAdult?: boolean | undefined;
+      language?: string | undefined;
+      page?: number | undefined;
+      region?: string | undefined;
+    }, {
+      includeAdult?: boolean | undefined;
+      language?: string | undefined;
+      page?: number | undefined;
+      region?: string | undefined;
+    }>;
+    readonly "~run": (dataset: v.UnknownDataset, config: v.Config<v.BaseIssue<unknown>>) => v.OutputDataset<{
+      includeAdult?: boolean | undefined;
+      language?: string | undefined;
+      page?: number | undefined;
+      region?: string | undefined;
+    }, v.StringIssue | v.ObjectIssue | v.BooleanIssue | v.NumberIssue | v.IntegerIssue<number>>;
+    readonly "~types"?: {
+      readonly input: {
+        includeAdult?: boolean | undefined;
+        language?: string | undefined;
+        page?: number | undefined;
+        region?: string | undefined;
+      };
+      readonly output: {
+        includeAdult?: boolean | undefined;
+        language?: string | undefined;
+        page?: number | undefined;
+        region?: string | undefined;
+      };
+      readonly issue: v.StringIssue | v.ObjectIssue | v.BooleanIssue | v.NumberIssue | v.IntegerIssue<number>;
+    } | undefined;
+  }, undefined>;
+}, undefined>;
+/**
+ * ### [Collection](https://developer.themoviedb.org/reference/search-collection)
+ *
+ * **GET** `/search/collection`
+ */
+export declare const searchCollections: Fetcher<typeof searchCollectionsSchema, PagedCollectionResults>;
+//# sourceMappingURL=searchCollections.d.mts.map

package/dist/search/searchCollections.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchCollections.d.mts","names":[],"sources":["../../src/search/searchCollections.ts"],"mappings":";;;qBAKa,yBAAuB,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAmBvB,mBAAmB,eACvB,yBACP"}

package/dist/search/searchCollections.mjs

@@ -0,0 +1,25 @@
+import { get } from "../requests/methods.mjs";
+import { integer } from "../validations/integer.mjs";
+import * as v from "valibot";
+// src/search/searchCollections.ts
+const searchCollectionsSchema = v.object({
+	query: v.string(),
+	params: v.exactOptional(v.partial(v.object({
+		includeAdult: v.boolean(),
+		language: v.string(),
+		page: integer,
+		region: v.string()
+	})))
+});
+/**
+* ### [Collection](https://developer.themoviedb.org/reference/search-collection)
+*
+* **GET** `/search/collection`
+*/
+const searchCollections = async ({ query, params }, options) => get(`/search/collection`, {
+	...params,
+	query
+}, options);
+export { searchCollections, searchCollectionsSchema };
+
+//# sourceMappingURL=searchCollections.mjs.map

package/dist/search/searchCollections.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchCollections.mjs","names":[],"sources":["../../src/search/searchCollections.ts"],"sourcesContent":["import * as v from \"valibot\";\nimport { get, type Fetcher } from \"../requests/methods.js\";\nimport { integer } from \"../validations/integer.js\";\nimport type { PagedCollectionResults } from \"../collection/types/CollectionListItem.js\";\n\nexport const searchCollectionsSchema = v.object({\n  query: v.string(),\n  params: v.exactOptional(\n    v.partial(\n      v.object({\n        includeAdult: v.boolean(),\n        language: v.string(),\n        page: integer,\n        region: v.string()\n      })\n    )\n  )\n});\n\n/**\n * ### [Collection](https://developer.themoviedb.org/reference/search-collection)\n *\n * **GET** `/search/collection`\n */\nexport const searchCollections: Fetcher<\n  typeof searchCollectionsSchema,\n  PagedCollectionResults\n> = async ({ query, params }, options) =>\n  get(`/search/collection`, { ...params, query }, options);\n"],"mappings":";;;;AAKA,MAAa,0BAA0B,EAAE,OAAO;CAC9C,OAAO,EAAE,OAAO;CAChB,QAAQ,EAAE,cACR,EAAE,QACA,EAAE,OAAO;EACP,cAAc,EAAE,QAAQ;EACxB,UAAU,EAAE,OAAO;EACnB,MAAM;EACN,QAAQ,EAAE,OAAO;CACnB,CAAC,CACH,CACF;AACF,CAAC;;;;;;AAOD,MAAa,oBAGT,OAAO,EAAE,OAAO,UAAU,YAC5B,IAAI,sBAAsB;CAAE,GAAG;CAAQ;AAAM,GAAG,OAAO"}

package/dist/search/searchCompanies.d.mts

@@ -0,0 +1,37 @@
+import { Fetcher } from "../requests/methods.mjs";
+import { PagedCompanyResults } from "../company/types/CompanyListItem.mjs";
+import * as v from "valibot";
+export declare const searchCompaniesSchema: v.ObjectSchema<{
+  readonly query: v.StringSchema<undefined>;
+  readonly params: v.ExactOptionalSchema<Omit<v.ObjectSchema<{
+    readonly page: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
+  }, undefined>, "~types" | "~run" | "~standard" | "entries"> & {
+    readonly entries: {
+      readonly page: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>, undefined>;
+    };
+    readonly "~standard": v.StandardProps<{
+      page?: number | undefined;
+    }, {
+      page?: number | undefined;
+    }>;
+    readonly "~run": (dataset: v.UnknownDataset, config: v.Config<v.BaseIssue<unknown>>) => v.OutputDataset<{
+      page?: number | undefined;
+    }, v.ObjectIssue | v.NumberIssue | v.IntegerIssue<number>>;
+    readonly "~types"?: {
+      readonly input: {
+        page?: number | undefined;
+      };
+      readonly output: {
+        page?: number | undefined;
+      };
+      readonly issue: v.ObjectIssue | v.NumberIssue | v.IntegerIssue<number>;
+    } | undefined;
+  }, undefined>;
+}, undefined>;
+/**
+ * ### [Company](https://developer.themoviedb.org/reference/search-company)
+ *
+ * **GET** `/search/company`
+ */
+export declare const searchCompanies: Fetcher<typeof searchCompaniesSchema, PagedCompanyResults>;
+//# sourceMappingURL=searchCompanies.d.mts.map

package/dist/search/searchCompanies.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchCompanies.d.mts","names":[],"sources":["../../src/search/searchCompanies.ts"],"mappings":";;;qBAKa,uBAAqB,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAgBrB,iBAAiB,eACrB,uBACP"}

package/dist/search/searchCompanies.mjs

@@ -0,0 +1,20 @@
+import { get } from "../requests/methods.mjs";
+import { integer } from "../validations/integer.mjs";
+import * as v from "valibot";
+// src/search/searchCompanies.ts
+const searchCompaniesSchema = v.object({
+	query: v.string(),
+	params: v.exactOptional(v.partial(v.object({ page: integer })))
+});
+/**
+* ### [Company](https://developer.themoviedb.org/reference/search-company)
+*
+* **GET** `/search/company`
+*/
+const searchCompanies = async ({ query, params }, options) => get(`/search/company`, {
+	...params,
+	query
+}, options);
+export { searchCompanies, searchCompaniesSchema };
+
+//# sourceMappingURL=searchCompanies.mjs.map

package/dist/search/searchCompanies.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchCompanies.mjs","names":[],"sources":["../../src/search/searchCompanies.ts"],"sourcesContent":["import * as v from \"valibot\";\nimport { get, type Fetcher } from \"../requests/methods.js\";\nimport { integer } from \"../validations/integer.js\";\nimport type { PagedCompanyResults } from \"../company/types/CompanyListItem.js\";\n\nexport const searchCompaniesSchema = v.object({\n  query: v.string(),\n  params: v.exactOptional(\n    v.partial(\n      v.object({\n        page: integer\n      })\n    )\n  )\n});\n\n/**\n * ### [Company](https://developer.themoviedb.org/reference/search-company)\n *\n * **GET** `/search/company`\n */\nexport const searchCompanies: Fetcher<\n  typeof searchCompaniesSchema,\n  PagedCompanyResults\n> = async ({ query, params }, options) =>\n  get(`/search/company`, { ...params, query }, options);\n"],"mappings":";;;;AAKA,MAAa,wBAAwB,EAAE,OAAO;CAC5C,OAAO,EAAE,OAAO;CAChB,QAAQ,EAAE,cACR,EAAE,QACA,EAAE,OAAO,EACP,MAAM,QACR,CAAC,CACH,CACF;AACF,CAAC;;;;;;AAOD,MAAa,kBAGT,OAAO,EAAE,OAAO,UAAU,YAC5B,IAAI,mBAAmB;CAAE,GAAG;CAAQ;AAAM,GAAG,OAAO"}

package/dist/search/searchKeywords.d.mts

@@ -0,0 +1,37 @@
+import { Fetcher } from "../requests/methods.mjs";
+import { PagedKeywordResults } from "../types/Keyword.mjs";
+import * as v from "valibot";
+export declare const searchKeywordsSchema: v.ObjectSchema<{
+  readonly query: v.StringSchema<undefined>;
+  readonly params: v.ExactOptionalSchema<Omit<v.ObjectSchema<{
+    readonly page: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>;
+  }, undefined>, "~types" | "~run" | "~standard" | "entries"> & {
+    readonly entries: {
+      readonly page: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>, undefined>;
+    };
+    readonly "~standard": v.StandardProps<{
+      page?: number | undefined;
+    }, {
+      page?: number | undefined;
+    }>;
+    readonly "~run": (dataset: v.UnknownDataset, config: v.Config<v.BaseIssue<unknown>>) => v.OutputDataset<{
+      page?: number | undefined;
+    }, v.ObjectIssue | v.NumberIssue | v.IntegerIssue<number>>;
+    readonly "~types"?: {
+      readonly input: {
+        page?: number | undefined;
+      };
+      readonly output: {
+        page?: number | undefined;
+      };
+      readonly issue: v.ObjectIssue | v.NumberIssue | v.IntegerIssue<number>;
+    } | undefined;
+  }, undefined>;
+}, undefined>;
+/**
+ * ### [Keyword](https://developer.themoviedb.org/reference/search-keyword)
+ *
+ * **GET** `/search/keyword`
+ */
+export declare const searchKeywords: Fetcher<typeof searchKeywordsSchema, PagedKeywordResults>;
+//# sourceMappingURL=searchKeywords.d.mts.map

package/dist/search/searchKeywords.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchKeywords.d.mts","names":[],"sources":["../../src/search/searchKeywords.ts"],"mappings":";;;qBAKa,sBAAoB,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAgBpB,gBAAgB,eACpB,sBACP"}

package/dist/search/searchKeywords.mjs

@@ -0,0 +1,20 @@
+import { get } from "../requests/methods.mjs";
+import { integer } from "../validations/integer.mjs";
+import * as v from "valibot";
+// src/search/searchKeywords.ts
+const searchKeywordsSchema = v.object({
+	query: v.string(),
+	params: v.exactOptional(v.partial(v.object({ page: integer })))
+});
+/**
+* ### [Keyword](https://developer.themoviedb.org/reference/search-keyword)
+*
+* **GET** `/search/keyword`
+*/
+const searchKeywords = async ({ query, params }, options) => get(`/search/keyword`, {
+	...params,
+	query
+}, options);
+export { searchKeywords, searchKeywordsSchema };
+
+//# sourceMappingURL=searchKeywords.mjs.map

package/dist/search/searchKeywords.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchKeywords.mjs","names":[],"sources":["../../src/search/searchKeywords.ts"],"sourcesContent":["import * as v from \"valibot\";\nimport { get, type Fetcher } from \"../requests/methods.js\";\nimport { integer } from \"../validations/integer.js\";\nimport type { PagedKeywordResults } from \"../types/Keyword.js\";\n\nexport const searchKeywordsSchema = v.object({\n  query: v.string(),\n  params: v.exactOptional(\n    v.partial(\n      v.object({\n        page: integer\n      })\n    )\n  )\n});\n\n/**\n * ### [Keyword](https://developer.themoviedb.org/reference/search-keyword)\n *\n * **GET** `/search/keyword`\n */\nexport const searchKeywords: Fetcher<\n  typeof searchKeywordsSchema,\n  PagedKeywordResults\n> = async ({ query, params }, options) =>\n  get(`/search/keyword`, { ...params, query }, options);\n"],"mappings":";;;;AAKA,MAAa,uBAAuB,EAAE,OAAO;CAC3C,OAAO,EAAE,OAAO;CAChB,QAAQ,EAAE,cACR,EAAE,QACA,EAAE,OAAO,EACP,MAAM,QACR,CAAC,CACH,CACF;AACF,CAAC;;;;;;AAOD,MAAa,iBAGT,OAAO,EAAE,OAAO,UAAU,YAC5B,IAAI,mBAAmB;CAAE,GAAG;CAAQ;AAAM,GAAG,OAAO"}