feat: add movie service

Author: vo1x

.eslintrc.js

@@ -0,0 +1,14 @@
+/** @type {import('eslint').Linter.Config} */
+module.exports = {
+  root: true,
+  env: { node: true, es2021: true },
+  parser: "@typescript-eslint/parser",
+  parserOptions: { sourceType: "module" },
+  plugins: ["@typescript-eslint"],
+  extends: [
+    "eslint:recommended",
+    "plugin:@typescript-eslint/recommended",
+    "prettier"
+  ],
+  ignorePatterns: ["dist/**"]
+};

.gitignore

@@ -0,0 +1,37 @@
+# dependencies (bun install)
+node_modules
+
+# output
+out
+dist
+*.tgz
+
+# code coverage
+coverage
+*.lcov
+
+# logs
+logs
+_.log
+report.[0-9]_.[0-9]_.[0-9]_.[0-9]_.json
+
+# dotenv environment variable files
+.env
+.env.development.local
+.env.test.local
+.env.production.local
+.env.local
+
+# caches
+.eslintcache
+.cache
+*.tsbuildinfo
+
+# IntelliJ based IDEs
+.idea
+
+# Finder (MacOS) folder config
+.DS_Store
+
+# Build output
+/dist

.npmignore

@@ -0,0 +1,12 @@
+src/
+tests/
+coverage/
+.github/
+.vscode/
+.eslintrc.js
+.prettierrc
+tsconfig.json
+tsconfig.build.json
+vitest.config.ts
+*.log
+.env

.npmrc

@@ -0,0 +1 @@
+access=public

.prettierrc

@@ -0,0 +1,6 @@
+{
+  "printWidth": 100,
+  "singleQuote": false,
+  "semi": true,
+  "trailingComma": "es5"
+}

README.md

@@ -0,0 +1,54 @@
+# tmdb
+
+> Unofficial TypeScript SDK for The Movie Database (TMDb) API v3.  
+> Works in Node 18+ and modern browsers.  
+> This product uses the TMDb API but is not endorsed or certified by TMDb.
+
+## Install
+
+```sh
+npm install @vo1x/tmdb
+# or
+pnpm add @vo1x/tmdb
+```
+
+## Quick Start
+
+```ts
+import { TMDB } from "@vo1x/tmdb";
+
+const tmdb = new TMDB({
+  apiKey: process.env.TMDB_API_KEY!, // required
+  language: "en-US"                  // optional default
+});
+
+async function main() {
+  // Get movie details
+  const movie = await tmdb.movie.getById(27205);
+  console.log(movie.title); // "Inception"
+
+  // Get movie credits
+  const credits = await tmdb.movie.credits(27205);
+  console.log(credits.cast.map(c => c.name));
+
+  // Get recommendations
+  const recs = await tmdb.movie.recommendations(27205, { page: 1 });
+  for (const r of recs.results) {
+    console.log(r.title);
+  }
+}
+
+main();
+```
+
+## API
+
+Currently supports:
+- Movies — details, credits, images, recommendations, similar
+
+## Requirements
+- Node.js 18+ or modern browsers (global fetch available)
+- TMDb v3 API key (get one at https://www.themoviedb.org/settings/api)
+
+## License
+MIT © vo1x