movie-agent 1.0.0

package/dist/cache.js

@@ -0,0 +1,133 @@
+"use strict";
+/**
+ * Simple in-memory cache with TTL support
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Cache = void 0;
+exports.getCache = getCache;
+exports.resetCache = resetCache;
+exports.generateDiscoverCacheKey = generateDiscoverCacheKey;
+exports.generateProvidersCacheKey = generateProvidersCacheKey;
+class Cache {
+    /**
+     * Creates a new cache instance
+     * @param defaultTtl Default time-to-live in seconds
+     */
+    constructor(defaultTtl = 3600) {
+        this.store = new Map();
+        this.defaultTtl = defaultTtl;
+    }
+    /**
+     * Sets a value in the cache
+     * @param key Cache key
+     * @param value Value to cache
+     * @param ttl Time-to-live in seconds (optional, uses default if not provided)
+     */
+    set(key, value, ttl) {
+        const effectiveTtl = ttl ?? this.defaultTtl;
+        const expiresAt = Date.now() + effectiveTtl * 1000;
+        this.store.set(key, { value, expiresAt });
+    }
+    /**
+     * Gets a value from the cache
+     * @param key Cache key
+     * @returns Cached value or undefined if not found or expired
+     */
+    get(key) {
+        const entry = this.store.get(key);
+        if (!entry) {
+            return undefined;
+        }
+        // Check if entry has expired
+        if (Date.now() > entry.expiresAt) {
+            this.store.delete(key);
+            return undefined;
+        }
+        return entry.value;
+    }
+    /**
+     * Checks if a key exists and is not expired
+     * @param key Cache key
+     * @returns true if key exists and is not expired
+     */
+    has(key) {
+        return this.get(key) !== undefined;
+    }
+    /**
+     * Deletes a key from the cache
+     * @param key Cache key
+     * @returns true if key existed and was deleted
+     */
+    delete(key) {
+        return this.store.delete(key);
+    }
+    /**
+     * Clears all entries from the cache
+     */
+    clear() {
+        this.store.clear();
+    }
+    /**
+     * Gets the number of entries in the cache (including expired ones)
+     * @returns Number of entries
+     */
+    size() {
+        return this.store.size;
+    }
+    /**
+     * Removes all expired entries from the cache
+     * @returns Number of entries removed
+     */
+    prune() {
+        const now = Date.now();
+        let removed = 0;
+        for (const [key, entry] of this.store.entries()) {
+            if (now > entry.expiresAt) {
+                this.store.delete(key);
+                removed++;
+            }
+        }
+        return removed;
+    }
+}
+exports.Cache = Cache;
+// Singleton instance for application-wide use
+let cacheInstance = null;
+/**
+ * Gets the global cache instance
+ * @param ttl Default TTL for the cache (only used on first call)
+ * @returns Global cache instance
+ */
+function getCache(ttl) {
+    if (!cacheInstance) {
+        cacheInstance = new Cache(ttl);
+    }
+    return cacheInstance;
+}
+/**
+ * Resets the global cache instance (useful for testing)
+ */
+function resetCache() {
+    cacheInstance = null;
+}
+/**
+ * Generates a cache key for discover parameters
+ * @param params Discover parameters object
+ * @returns Cache key string
+ */
+function generateDiscoverCacheKey(params) {
+    // Sort keys to ensure consistent key generation
+    const sortedKeys = Object.keys(params).sort();
+    const keyParts = sortedKeys.map(key => `${key}=${params[key]}`);
+    return `discover:${keyParts.join('&')}`;
+}
+/**
+ * Generates a cache key for watch providers
+ * @param movieId Movie ID
+ * @param region Region code
+ * @returns Cache key string
+ */
+function generateProvidersCacheKey(movieId, region) {
+    return `providers:${movieId}:${region}`;
+}
+//# sourceMappingURL=cache.js.map

package/dist/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAiHH,4BAKC;AAKD,gCAEC;AAOD,4DAKC;AAQD,8DAKC;AA/ID,MAAa,KAAK;IAIhB;;;OAGG;IACH,YAAY,aAAqB,IAAI;QACnC,IAAI,CAAC,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAI,GAAW,EAAE,KAAQ,EAAE,GAAY;QACxC,MAAM,YAAY,GAAG,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC;QAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,YAAY,GAAG,IAAI,CAAC;QACnD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAI,GAAW;QAChB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAElC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,6BAA6B;QAC7B,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,KAAK,CAAC,KAAU,CAAC;IAC1B,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC;IACrC,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,GAAW;QAChB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED;;;OAGG;IACH,IAAI;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,KAAK;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,OAAO,GAAG,CAAC,CAAC;QAEhB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YAChD,IAAI,GAAG,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;gBAC1B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACvB,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAhGD,sBAgGC;AAED,8CAA8C;AAC9C,IAAI,aAAa,GAAiB,IAAI,CAAC;AAEvC;;;;GAIG;AACH,SAAgB,QAAQ,CAAC,GAAY;IACnC,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,aAAa,GAAG,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,SAAgB,UAAU;IACxB,aAAa,GAAG,IAAI,CAAC;AACvB,CAAC;AAED;;;;GAIG;AACH,SAAgB,wBAAwB,CAAC,MAA2B;IAClE,gDAAgD;IAChD,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9C,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChE,OAAO,YAAY,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AAC1C,CAAC;AAED;;;;;GAKG;AACH,SAAgB,yBAAyB,CACvC,OAAwB,EACxB,MAAc;IAEd,OAAO,aAAa,OAAO,IAAI,MAAM,EAAE,CAAC;AAC1C,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,17 @@
+export interface Config {
+    TMDB_API_KEY: string;
+    TMDB_BASE_URL: string;
+    TMDB_REGION: string;
+    CACHE_TTL: number;
+    MAX_RECOMMENDATIONS: number;
+    MIN_RECOMMENDATIONS: number;
+    LLM_PROVIDER: 'gemini' | 'azure';
+    GEMINI_API_KEY?: string;
+    AZURE_OPENAI_API_KEY?: string;
+    AZURE_OPENAI_ENDPOINT?: string;
+    AZURE_OPENAI_DEPLOYMENT?: string;
+    OPENAI_API_KEY?: string;
+}
+declare const config: Config;
+export default config;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,MAAM;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAG5B,YAAY,EAAE,QAAQ,GAAG,OAAO,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAkBD,QAAA,MAAM,MAAM,EAAE,MAwBb,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/config.js

@@ -0,0 +1,31 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const dotenv_1 = __importDefault(require("dotenv"));
+dotenv_1.default.config();
+function getEnvVar(key, required = false, defaultValue) {
+    const value = process.env[key];
+    if (required && !value) {
+        throw new Error(`Missing required environment variable: ${key}`);
+    }
+    return value ?? defaultValue;
+}
+const LLM_PROVIDER = getEnvVar('LLM_PROVIDER', false, 'gemini');
+const config = {
+    TMDB_API_KEY: getEnvVar('TMDB_API_KEY', false) || '', // Made optional - factory pattern handles this
+    TMDB_BASE_URL: getEnvVar('TMDB_BASE_URL', false, 'https://api.themoviedb.org/3'),
+    TMDB_REGION: getEnvVar('TMDB_REGION', false, 'CA'),
+    CACHE_TTL: parseInt(getEnvVar('CACHE_TTL', false, '86400'), 10),
+    MAX_RECOMMENDATIONS: parseInt(getEnvVar('MAX_RECOMMENDATIONS', false, '5'), 10),
+    MIN_RECOMMENDATIONS: parseInt(getEnvVar('MIN_RECOMMENDATIONS', false, '3'), 10),
+    LLM_PROVIDER,
+    GEMINI_API_KEY: getEnvVar('GEMINI_API_KEY', false), // Made optional
+    AZURE_OPENAI_API_KEY: getEnvVar('AZURE_OPENAI_API_KEY', false),
+    AZURE_OPENAI_ENDPOINT: getEnvVar('AZURE_OPENAI_ENDPOINT', false),
+    AZURE_OPENAI_DEPLOYMENT: getEnvVar('AZURE_OPENAI_DEPLOYMENT', false),
+    OPENAI_API_KEY: getEnvVar('OPENAI_API_KEY', false),
+};
+exports.default = config;
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;;;;AAAA,oDAA4B;AAC5B,gBAAM,CAAC,MAAM,EAAE,CAAC;AAmBhB,SAAS,SAAS,CAChB,GAAW,EACX,QAAQ,GAAG,KAAK,EAChB,YAAqB;IAErB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,QAAQ,IAAI,CAAC,KAAK,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,0CAA0C,GAAG,EAAE,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,KAAK,IAAI,YAAY,CAAC;AAC/B,CAAC;AAED,MAAM,YAAY,GAAG,SAAS,CAAC,cAAc,EAAE,KAAK,EAAE,QAAQ,CAEnD,CAAC;AAEZ,MAAM,MAAM,GAAW;IACrB,YAAY,EAAE,SAAS,CAAC,cAAc,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,+CAA+C;IACrG,aAAa,EAAE,SAAS,CACtB,eAAe,EACf,KAAK,EACL,8BAA8B,CAC9B;IACF,WAAW,EAAE,SAAS,CAAC,aAAa,EAAE,KAAK,EAAE,IAAI,CAAE;IACnD,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC,WAAW,EAAE,KAAK,EAAE,OAAO,CAAE,EAAE,EAAE,CAAC;IAChE,mBAAmB,EAAE,QAAQ,CAC3B,SAAS,CAAC,qBAAqB,EAAE,KAAK,EAAE,GAAG,CAAE,EAC7C,EAAE,CACH;IACD,mBAAmB,EAAE,QAAQ,CAC3B,SAAS,CAAC,qBAAqB,EAAE,KAAK,EAAE,GAAG,CAAE,EAC7C,EAAE,CACH;IAED,YAAY;IACZ,cAAc,EAAE,SAAS,CAAC,gBAAgB,EAAE,KAAK,CAAC,EAAE,gBAAgB;IACpE,oBAAoB,EAAE,SAAS,CAAC,sBAAsB,EAAE,KAAK,CAAC;IAC9D,qBAAqB,EAAE,SAAS,CAAC,uBAAuB,EAAE,KAAK,CAAC;IAChE,uBAAuB,EAAE,SAAS,CAAC,yBAAyB,EAAE,KAAK,CAAC;IACpE,cAAc,EAAE,SAAS,CAAC,gBAAgB,EAAE,KAAK,CAAC;CACnD,CAAC;AAEF,kBAAe,MAAM,CAAC"}

package/dist/discover.d.ts

@@ -0,0 +1,38 @@
+import TmdbApiClient, { DiscoverMoviesParams, DiscoverMoviesResponse } from './tmdbApi';
+/**
+ * Input for building discover parameters.
+ */
+export interface DiscoverInput {
+    /** Optional mood to map to genres */
+    mood?: string;
+    /** Explicit genre names (e.g., ["Action", "Comedy"]) */
+    genres?: string[];
+    /** Specific release year */
+    year?: number;
+    /** Minimum release year */
+    yearMin?: number;
+    /** Maximum release year */
+    yearMax?: number;
+    /** Minimum runtime in minutes */
+    runtimeMin?: number;
+    /** Maximum runtime in minutes */
+    runtimeMax?: number;
+    /** Page number for pagination */
+    page?: number;
+    /** Sort order (e.g., "popularity.desc", "release_date.desc") */
+    sortBy?: string;
+}
+/**
+ * Builds TMDb discover parameters from user input.
+ * @param input - User input with mood, genres, year range, runtime constraints, etc.
+ * @returns DiscoverMoviesParams object ready for API call
+ */
+export declare function buildDiscoverParams(input: DiscoverInput): DiscoverMoviesParams;
+/**
+ * Discovers movies based on user input.
+ * @param input - User input with mood, genres, year range, runtime constraints, etc.
+ * @param apiClient - Optional TMDb API client instance (defaults to new instance)
+ * @returns Promise resolving to discover movies response
+ */
+export declare function discoverMovies(input: DiscoverInput, apiClient?: TmdbApiClient): Promise<DiscoverMoviesResponse>;
+//# sourceMappingURL=discover.d.ts.map

package/dist/discover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../src/discover.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,EAAE,EACpB,oBAAoB,EACpB,sBAAsB,EACvB,MAAM,WAAW,CAAC;AAKnB;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,4BAA4B;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA+CD;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,aAAa,GACnB,oBAAoB,CA6CtB;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,aAAa,EACpB,SAAS,CAAC,EAAE,aAAa,GACxB,OAAO,CAAC,sBAAsB,CAAC,CAoBjC"}

package/dist/discover.js

@@ -0,0 +1,121 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildDiscoverParams = buildDiscoverParams;
+exports.discoverMovies = discoverMovies;
+const tmdbApi_1 = __importDefault(require("./tmdbApi"));
+const mood_1 = require("./mood");
+const cache_1 = require("./cache");
+const config_1 = __importDefault(require("./config"));
+/**
+ * Maps genre names to genre IDs based on TMDb's genre list.
+ * This is a static mapping of common movie genres.
+ */
+const GENRE_NAME_TO_ID = {
+    Action: 28,
+    Adventure: 12,
+    Animation: 16,
+    Biography: 99, // Note: Biography is not a standard TMDb genre, using Documentary
+    Comedy: 35,
+    Crime: 80,
+    Documentary: 99,
+    Drama: 18,
+    Family: 10751,
+    Fantasy: 14,
+    History: 36,
+    Horror: 27,
+    Music: 10402,
+    Musical: 10402, // Music and Musical map to the same ID
+    Mystery: 9648,
+    Romance: 10749,
+    'Science Fiction': 878,
+    Thriller: 53,
+    'TV Movie': 10770,
+    War: 10752,
+    Western: 37,
+};
+/**
+ * Converts genre names to comma-separated genre IDs.
+ * @param genreNames - Array of genre names
+ * @returns Comma-separated string of genre IDs, or undefined if no valid genres
+ */
+function genreNamesToIds(genreNames) {
+    const ids = genreNames
+        .map(name => GENRE_NAME_TO_ID[name])
+        .filter(id => id !== undefined);
+    if (ids.length === 0) {
+        return undefined;
+    }
+    return ids.join(',');
+}
+/**
+ * Builds TMDb discover parameters from user input.
+ * @param input - User input with mood, genres, year range, runtime constraints, etc.
+ * @returns DiscoverMoviesParams object ready for API call
+ */
+function buildDiscoverParams(input) {
+    const params = {};
+    // Handle genres - prioritize explicit genres over mood
+    let genreNames = [];
+    if (input.genres && input.genres.length > 0) {
+        genreNames = input.genres;
+    }
+    else if (input.mood) {
+        genreNames = (0, mood_1.moodToGenres)(input.mood);
+    }
+    if (genreNames.length > 0) {
+        params.with_genres = genreNamesToIds(genreNames);
+    }
+    // Handle year - specific year takes precedence over range
+    if (input.year) {
+        params.year = input.year;
+    }
+    else {
+        // Use date range if no specific year
+        if (input.yearMin) {
+            params['primary_release_date.gte'] = `${input.yearMin}-01-01`;
+        }
+        if (input.yearMax) {
+            params['primary_release_date.lte'] = `${input.yearMax}-12-31`;
+        }
+    }
+    // Handle runtime constraints
+    if (input.runtimeMin !== undefined) {
+        params['with_runtime.gte'] = input.runtimeMin;
+    }
+    if (input.runtimeMax !== undefined) {
+        params['with_runtime.lte'] = input.runtimeMax;
+    }
+    // Handle pagination
+    if (input.page !== undefined) {
+        params.page = input.page;
+    }
+    // Handle sort order (default to popularity descending)
+    params.sort_by = input.sortBy ?? 'popularity.desc';
+    return params;
+}
+/**
+ * Discovers movies based on user input.
+ * @param input - User input with mood, genres, year range, runtime constraints, etc.
+ * @param apiClient - Optional TMDb API client instance (defaults to new instance)
+ * @returns Promise resolving to discover movies response
+ */
+async function discoverMovies(input, apiClient) {
+    const client = apiClient ?? new tmdbApi_1.default();
+    const params = buildDiscoverParams(input);
+    // Check cache first
+    const cache = (0, cache_1.getCache)(config_1.default.CACHE_TTL);
+    const cacheKey = (0, cache_1.generateDiscoverCacheKey)(params);
+    const cachedResult = cache.get(cacheKey);
+    if (cachedResult) {
+        return cachedResult;
+    }
+    // Cache miss - fetch from API
+    const result = await client.discoverMovies(params);
+    // Store in cache
+    cache.set(cacheKey, result);
+    return result;
+}
+//# sourceMappingURL=discover.js.map

package/dist/discover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.js","sourceRoot":"","sources":["../src/discover.ts"],"names":[],"mappings":"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"}

package/dist/factory.d.ts

@@ -0,0 +1,87 @@
+import { MovieAgent } from './agent';
+/**
+ * Configuration options for creating a MovieAgent instance
+ */
+export interface MovieAgentConfig {
+    tmdbApiKey: string;
+    tmdbBaseUrl?: string;
+    tmdbRegion?: string;
+    llmProvider?: 'gemini' | 'azure';
+    geminiApiKey?: string;
+    azureOpenAiApiKey?: string;
+    azureOpenAiEndpoint?: string;
+    azureOpenAiDeployment?: string;
+    openaiApiKey?: string;
+    cacheTtl?: number;
+    maxRecommendations?: number;
+    minRecommendations?: number;
+    debug?: boolean;
+}
+/**
+ * Factory class for creating configured MovieAgent instances
+ *
+ * This class provides a clean interface for external projects to create
+ * MovieAgent instances without needing to manage TMDb API clients or
+ * environment variables directly.
+ *
+ * @example
+ * ```typescript
+ * import { MovieAgentFactory } from 'movie-agent';
+ *
+ * const agent = MovieAgentFactory.create({
+ *   tmdbApiKey: process.env.TMDB_API_KEY,
+ *   tmdbRegion: 'CA',
+ *   debug: true
+ * });
+ *
+ * const recommendations = await agent.getRecommendations({
+ *   mood: 'excited',
+ *   genre: 'Action'
+ * });
+ * ```
+ */
+export declare class MovieAgentFactory {
+    /**
+     * Creates a configured MovieAgent instance
+     *
+     * @param config - Configuration options for the MovieAgent
+     * @returns A fully configured MovieAgent instance ready to use
+     * @throws Error if required configuration is missing
+     */
+    static create(config: MovieAgentConfig): MovieAgent;
+    /**
+     * Creates a MovieAgent instance from environment variables
+     *
+     * This is a convenience method for projects that use environment variables.
+     * It reads from process.env and creates a MovieAgent with the standard
+     * environment variable names.
+     *
+     * Expected environment variables:
+     * - TMDB_API_KEY (required)
+     * - TMDB_BASE_URL (optional)
+     * - TMDB_REGION (optional, defaults to 'CA')
+     * - LLM_PROVIDER (optional)
+     * - GEMINI_API_KEY (optional)
+     * - AZURE_OPENAI_API_KEY (optional)
+     * - AZURE_OPENAI_ENDPOINT (optional)
+     * - AZURE_OPENAI_DEPLOYMENT (optional)
+     * - OPENAI_API_KEY (optional)
+     *
+     * @param debug - Enable debug logging (default: false)
+     * @returns A fully configured MovieAgent instance
+     * @throws Error if TMDB_API_KEY is not set in environment
+     *
+     * @example
+     * ```typescript
+     * import { MovieAgentFactory } from 'movie-agent';
+     *
+     * // Make sure to load your .env file first
+     * import dotenv from 'dotenv';
+     * dotenv.config();
+     *
+     * const agent = MovieAgentFactory.fromEnv(true);
+     * ```
+     */
+    static fromEnv(debug?: boolean): MovieAgent;
+}
+//# sourceMappingURL=factory.d.ts.map

package/dist/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAGrC;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAE/B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,WAAW,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IAGtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAG5B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,iBAAiB;IAC5B;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,UAAU;IAwBnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACH,MAAM,CAAC,OAAO,CAAC,KAAK,UAAQ,GAAG,UAAU;CAiC1C"}

package/dist/factory.js

@@ -0,0 +1,118 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MovieAgentFactory = void 0;
+// src/factory.ts
+const agent_1 = require("./agent");
+const tmdbApi_1 = __importDefault(require("./tmdbApi"));
+/**
+ * Factory class for creating configured MovieAgent instances
+ *
+ * This class provides a clean interface for external projects to create
+ * MovieAgent instances without needing to manage TMDb API clients or
+ * environment variables directly.
+ *
+ * @example
+ * ```typescript
+ * import { MovieAgentFactory } from 'movie-agent';
+ *
+ * const agent = MovieAgentFactory.create({
+ *   tmdbApiKey: process.env.TMDB_API_KEY,
+ *   tmdbRegion: 'CA',
+ *   debug: true
+ * });
+ *
+ * const recommendations = await agent.getRecommendations({
+ *   mood: 'excited',
+ *   genre: 'Action'
+ * });
+ * ```
+ */
+class MovieAgentFactory {
+    /**
+     * Creates a configured MovieAgent instance
+     *
+     * @param config - Configuration options for the MovieAgent
+     * @returns A fully configured MovieAgent instance ready to use
+     * @throws Error if required configuration is missing
+     */
+    static create(config) {
+        // Validate required configuration
+        if (!config.tmdbApiKey) {
+            throw new Error('TMDB API key is required. Please provide tmdbApiKey in the configuration.');
+        }
+        // Create TMDb API client with provided configuration
+        const tmdbClient = new tmdbApi_1.default(config.tmdbBaseUrl || 'https://api.themoviedb.org/3', config.tmdbApiKey, config.tmdbRegion || 'CA');
+        // Create logger function if debug is enabled
+        const logger = config.debug
+            ? (message) => console.log(`[MovieAgent] ${message}`)
+            : undefined;
+        // Create and return MovieAgent instance
+        return new agent_1.MovieAgent(tmdbClient, logger);
+    }
+    /**
+     * Creates a MovieAgent instance from environment variables
+     *
+     * This is a convenience method for projects that use environment variables.
+     * It reads from process.env and creates a MovieAgent with the standard
+     * environment variable names.
+     *
+     * Expected environment variables:
+     * - TMDB_API_KEY (required)
+     * - TMDB_BASE_URL (optional)
+     * - TMDB_REGION (optional, defaults to 'CA')
+     * - LLM_PROVIDER (optional)
+     * - GEMINI_API_KEY (optional)
+     * - AZURE_OPENAI_API_KEY (optional)
+     * - AZURE_OPENAI_ENDPOINT (optional)
+     * - AZURE_OPENAI_DEPLOYMENT (optional)
+     * - OPENAI_API_KEY (optional)
+     *
+     * @param debug - Enable debug logging (default: false)
+     * @returns A fully configured MovieAgent instance
+     * @throws Error if TMDB_API_KEY is not set in environment
+     *
+     * @example
+     * ```typescript
+     * import { MovieAgentFactory } from 'movie-agent';
+     *
+     * // Make sure to load your .env file first
+     * import dotenv from 'dotenv';
+     * dotenv.config();
+     *
+     * const agent = MovieAgentFactory.fromEnv(true);
+     * ```
+     */
+    static fromEnv(debug = false) {
+        const tmdbApiKey = process.env.TMDB_API_KEY;
+        if (!tmdbApiKey) {
+            throw new Error('TMDB_API_KEY environment variable is required. ' +
+                'Please set it in your .env file or environment.');
+        }
+        return MovieAgentFactory.create({
+            tmdbApiKey,
+            tmdbBaseUrl: process.env.TMDB_BASE_URL,
+            tmdbRegion: process.env.TMDB_REGION,
+            llmProvider: process.env.LLM_PROVIDER || undefined,
+            geminiApiKey: process.env.GEMINI_API_KEY,
+            azureOpenAiApiKey: process.env.AZURE_OPENAI_API_KEY,
+            azureOpenAiEndpoint: process.env.AZURE_OPENAI_ENDPOINT,
+            azureOpenAiDeployment: process.env.AZURE_OPENAI_DEPLOYMENT,
+            openaiApiKey: process.env.OPENAI_API_KEY,
+            cacheTtl: process.env.CACHE_TTL
+                ? parseInt(process.env.CACHE_TTL, 10)
+                : undefined,
+            maxRecommendations: process.env.MAX_RECOMMENDATIONS
+                ? parseInt(process.env.MAX_RECOMMENDATIONS, 10)
+                : undefined,
+            minRecommendations: process.env.MIN_RECOMMENDATIONS
+                ? parseInt(process.env.MIN_RECOMMENDATIONS, 10)
+                : undefined,
+            debug,
+        });
+    }
+}
+exports.MovieAgentFactory = MovieAgentFactory;
+//# sourceMappingURL=factory.js.map

package/dist/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":";;;;;;AAAA,iBAAiB;AACjB,mCAAqC;AACrC,wDAAsC;AA4BtC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAa,iBAAiB;IAC5B;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,CAAC,MAAwB;QACpC,kCAAkC;QAClC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CACb,2EAA2E,CAC5E,CAAC;QACJ,CAAC;QAED,qDAAqD;QACrD,MAAM,UAAU,GAAG,IAAI,iBAAa,CAClC,MAAM,CAAC,WAAW,IAAI,8BAA8B,EACpD,MAAM,CAAC,UAAU,EACjB,MAAM,CAAC,UAAU,IAAI,IAAI,CAC1B,CAAC;QAEF,6CAA6C;QAC7C,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK;YACzB,CAAC,CAAC,CAAC,OAAe,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,OAAO,EAAE,CAAC;YAC7D,CAAC,CAAC,SAAS,CAAC;QAEd,wCAAwC;QACxC,OAAO,IAAI,kBAAU,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACH,MAAM,CAAC,OAAO,CAAC,KAAK,GAAG,KAAK;QAC1B,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;QAE5C,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CACb,iDAAiD;gBAC/C,iDAAiD,CACpD,CAAC;QACJ,CAAC;QAED,OAAO,iBAAiB,CAAC,MAAM,CAAC;YAC9B,UAAU;YACV,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa;YACtC,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW;YACnC,WAAW,EACR,OAAO,CAAC,GAAG,CAAC,YAAmC,IAAI,SAAS;YAC/D,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc;YACxC,iBAAiB,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB;YACnD,mBAAmB,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB;YACtD,qBAAqB,EAAE,OAAO,CAAC,GAAG,CAAC,uBAAuB;YAC1D,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc;YACxC,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS;gBAC7B,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,CAAC;gBACrC,CAAC,CAAC,SAAS;YACb,kBAAkB,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB;gBACjD,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,EAAE,CAAC;gBAC/C,CAAC,CAAC,SAAS;YACb,kBAAkB,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB;gBACjD,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,EAAE,CAAC;gBAC/C,CAAC,CAAC,SAAS;YACb,KAAK;SACN,CAAC,CAAC;IACL,CAAC;CACF;AAlGD,8CAkGC"}

package/dist/filters.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Runtime constraints for filtering movies by duration
+ */
+export interface RuntimeConstraints {
+    min?: number;
+    max?: number;
+}
+/**
+ * Year range for filtering movies by release year
+ */
+export interface YearRange {
+    from?: number;
+    to?: number;
+}
+/**
+ * Filter a movie by checking if it's available on any of the user's platforms
+ * @param movie The movie object with available platforms
+ * @param userPlatforms Array of platform names the user has access to
+ * @returns true if the movie is available on at least one of the user's platforms
+ */
+export declare function filterByPlatforms(movie: {
+    platforms?: string[];
+}, userPlatforms: string[]): boolean;
+/**
+ * Filter a movie by runtime constraints
+ * @param movie The movie object with runtime information
+ * @param constraints Runtime constraints (min and/or max)
+ * @returns true if the movie's runtime satisfies the constraints
+ */
+export declare function filterByRuntime(movie: {
+    runtime?: number;
+}, constraints: RuntimeConstraints): boolean;
+/**
+ * Filter a movie by release year
+ * @param movie The movie object with release_date
+ * @param year Either a specific year (number) or a year range object
+ * @returns true if the movie's release year matches the criteria
+ */
+export declare function filterByYear(movie: {
+    release_date?: string;
+}, year: number | YearRange): boolean;
+/**
+ * Options for filtering movies
+ */
+export interface FilterOptions {
+    platforms?: string[];
+    runtime?: RuntimeConstraints;
+    year?: number | YearRange;
+}
+/**
+ * Apply multiple filters to an array of movies
+ * @param movies Array of movies to filter
+ * @param options Filter options to apply
+ * @returns Filtered array of movies that pass all specified filters
+ */
+export declare function applyFilters<T extends {
+    platforms?: string[];
+    runtime?: number;
+    release_date?: string;
+}>(movies: T[], options: FilterOptions): T[];
+//# sourceMappingURL=filters.d.ts.map

package/dist/filters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filters.d.ts","sourceRoot":"","sources":["../src/filters.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,EAC/B,aAAa,EAAE,MAAM,EAAE,GACtB,OAAO,CAWT;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,EAC3B,WAAW,EAAE,kBAAkB,GAC9B,OAAO,CAmBT;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,EAChC,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,OAAO,CA6BT;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,CAAC,SAAS;IAAE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,EAC3E,MAAM,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,aAAa,GAAG,CAAC,EAAE,CAuB1C"}