@fubar-it-co/tmdb-client 0.0.5

package/src/index.ts

@@ -0,0 +1,28 @@
+/**
+ * @fileoverview TMDB HTTP Client package entry point.
+ *
+ * This package provides a type-safe HTTP client for the TMDB API,
+ * generated from the official OpenAPI specification using heyAPI.
+ *
+ * **Note**: The `./client` folder is generated by heyAPI.
+ * Run `pnpm generate` to create it.
+ *
+ * @example
+ * ```typescript
+ * // Import SDK functions
+ * import { moviePopularList, movieDetails } from '@fubar-it-co/tmdb-client'
+ *
+ * // Use with TanStack Query
+ * import { moviePopularListOptions } from '@fubar-it-co/tmdb-client'
+ * const { data } = useQuery(moviePopularListOptions())
+ * ```
+ *
+ * @see https://developer.themoviedb.org/docs - TMDB API Documentation
+ * @see https://heyapi.dev - heyAPI Documentation
+ */
+
+// Re-export generated client
+export * from './client'
+
+// Re-export custom types
+export type { TMDBError } from './types/errors'

package/src/tmdb-config.ts

@@ -0,0 +1,47 @@
+/// <reference types="vite/client" />
+
+/**
+ * @fileoverview TMDB API client runtime configuration.
+ *
+ * This file is referenced by heyAPI during client generation via the
+ * `runtimeConfigPath` option in `openapi-ts.config.ts`.
+ *
+ * It provides the base URL and authentication headers for all TMDB API requests.
+ * The API token is read from the environment variable `VITE_TMDB_API_TOKEN`.
+ *
+ * @see https://heyapi.dev/openapi-ts/clients/fetch#runtime-api
+ */
+import type { Config } from './client/client/types.gen'
+
+/**
+ * TMDB API Bearer token from environment variables.
+ * Must be set in `.env.local` at the monorepo root.
+ */
+const TMDB_API_TOKEN = import.meta.env.VITE_TMDB_API_TOKEN
+
+/**
+ * Creates the client configuration for TMDB API requests.
+ *
+ * This function is called by the generated `client.gen.ts` before
+ * initializing the client instance. It sets:
+ * - `baseUrl`: The TMDB API base URL
+ * - `Authorization`: Bearer token for authentication
+ *
+ * @param config - The default configuration from heyAPI
+ * @returns The merged configuration with TMDB-specific settings
+ */
+export const createClientConfig = <T extends Config>(config: T): T => {
+  const existingHeaders =
+    config.headers && !Array.isArray(config.headers)
+      ? (config.headers as Record<string, string>)
+      : {}
+
+  return {
+    ...config,
+    baseUrl: 'https://api.themoviedb.org',
+    headers: {
+      ...existingHeaders,
+      Authorization: `Bearer ${TMDB_API_TOKEN}`,
+    },
+  }
+}

package/src/types/errors.ts

@@ -0,0 +1,32 @@
+/**
+ * TMDB API Error Response
+ *
+ * This is the error format returned by the TMDB API when a request fails.
+ * The API returns this JSON structure with an HTTP error status code (401, 404, 500, etc.).
+ *
+ * @see https://developer.themoviedb.org/docs/errors
+ *
+ * @example
+ * // 401 Unauthorized (Invalid API key)
+ * {
+ *   success: false,
+ *   status_code: 7,
+ *   status_message: "Invalid API key: You must be granted a valid key."
+ * }
+ *
+ * @example
+ * // 404 Not Found (Resource not found)
+ * {
+ *   success: false,
+ *   status_code: 34,
+ *   status_message: "The resource you requested could not be found."
+ * }
+ */
+export interface TMDBError {
+  /** Always false for error responses */
+  success: false
+  /** TMDB internal status code (e.g., 7 for invalid API key, 34 for not found) */
+  status_code: number
+  /** Human-readable error message */
+  status_message: string
+}

package/src/vite-env.d.ts

@@ -0,0 +1,9 @@
+/// <reference types="vite/client" />
+
+interface ImportMetaEnv {
+  readonly VITE_TMDB_API_TOKEN: string
+}
+
+interface ImportMeta {
+  readonly env: ImportMetaEnv
+}

package/tsconfig.build.json

@@ -0,0 +1,12 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "noEmit": false,
+    "outDir": "dist",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "module": "ESNext",
+    "moduleResolution": "bundler"
+  },
+}

package/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "noEmit": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "isolatedModules": true,
+    "resolveJsonModule": true,
+    "types": ["vite/client"]
+  },
+  "include": ["src/index.ts", "src/tmdb-config.ts", "src/vite-env.d.ts"],
+  "exclude": ["node_modules"]
+}