@rawcast/sdk 0.1.0

package/dist/resources/movies.d.ts

@@ -0,0 +1,43 @@
+import { SourcesResponse } from '../response';
+import type { HttpTransport } from '../transport';
+import type { DownloadResult, GetMovieDownloadOptions, GetMovieSourcesOptions, MediaDownloadResult } from '../types';
+export declare class MoviesResource {
+    private readonly transport;
+    constructor(transport: HttpTransport);
+    /**
+     * Resolves ranked streaming servers, adaptive HLS/DASH playlists, and subtitles for a movie.
+     *
+     * @param tmdbId TMDB Movie ID (e.g. 550 for Fight Club)
+     * @param options Optional language or title parameters
+     *
+     * @example
+     * ```typescript
+     * const sources = await rawcast.movies.getSources('550');
+     * const stream = sources.bestStream({ preferFormat: 'hls', maxQuality: '1080p' });
+     * console.log(stream.manifestUrl);
+     * ```
+     */
+    getSources(tmdbId: string | number, options?: GetMovieSourcesOptions): Promise<SourcesResponse>;
+    /**
+     * Fetches direct MP4 video download URLs with RFC 6266 filename attachment headers.
+     *
+     * @param tmdbId TMDB Movie ID
+     * @param options Target quality (e.g. '1080p', '720p') and preferred audio
+     *
+     * @example
+     * ```typescript
+     * // Fetch single quality download:
+     * const download = await rawcast.movies.getDownload('550', { quality: '1080p' });
+     * console.log(download.downloadUrl, download.filename);
+     *
+     * // Fetch all available qualities:
+     * const list = await rawcast.movies.getDownload('550');
+     * console.log(list.downloads);
+     * ```
+     */
+    getDownload(tmdbId: string | number, options: GetMovieDownloadOptions & {
+        quality: NonNullable<GetMovieDownloadOptions['quality']>;
+    }): Promise<DownloadResult>;
+    getDownload(tmdbId: string | number, options?: GetMovieDownloadOptions): Promise<DownloadResult | MediaDownloadResult>;
+}
+//# sourceMappingURL=movies.d.ts.map

package/dist/resources/movies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"movies.d.ts","sourceRoot":"","sources":["../../src/resources/movies.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EACV,cAAc,EACd,uBAAuB,EACvB,sBAAsB,EACtB,mBAAmB,EAGpB,MAAM,UAAU,CAAC;AAElB,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,aAAa;IAErD;;;;;;;;;;;;OAYG;IACU,UAAU,CACrB,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,eAAe,CAAC;IAe3B;;;;;;;;;;;;;;;;OAgBG;IACU,WAAW,CACtB,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,OAAO,EAAE,uBAAuB,GAAG;QAAE,OAAO,EAAE,WAAW,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC,CAAA;KAAE,GAC9F,OAAO,CAAC,cAAc,CAAC;IACb,WAAW,CACtB,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAAC,cAAc,GAAG,mBAAmB,CAAC;CAgBjD"}

package/dist/resources/resolve.d.ts

@@ -0,0 +1,48 @@
+import type { HttpTransport } from '../transport';
+export interface ResolveUrlOptions {
+    /**
+     * If true, signals the resolver to attach Content-Disposition headers for direct download.
+     */
+    download?: boolean;
+    /**
+     * Custom filename title override for download attachment.
+     */
+    title?: string;
+}
+export declare class ResolveResource {
+    private readonly transport;
+    constructor(transport: HttpTransport);
+    /**
+     * Constructs the full public resolution URL for a stream token.
+     * Can be passed directly into video player `src` (Video.js, Hls.js, Plyr, or HTML5 `<video>`).
+     *
+     * @param token Stream token from `stream.token`
+     * @param options Download flag and title options
+     */
+    getStreamUrl(token: string, options?: ResolveUrlOptions): string;
+    /**
+     * Constructs the direct download URL for a stream token.
+     * Triggers an immediate browser download attachment.
+     *
+     * @param token Stream token from `stream.token`
+     * @param options Custom filename title override
+     */
+    getDownloadUrl(token: string, options?: {
+        title?: string;
+    }): string;
+    /**
+     * Constructs the proxied HLS master playlist URL for an HLS stream token.
+     *
+     * @param token Stream token from `stream.token`
+     */
+    getHlsManifestUrl(token: string): string;
+    /**
+     * Resolves a token and returns the underlying upstream CDN video URL directly
+     * by following the HTTP 302 redirect.
+     *
+     * @param token Stream token
+     * @param options Download flag and title options
+     */
+    resolveDirect(token: string, options?: ResolveUrlOptions): Promise<string>;
+}
+//# sourceMappingURL=resolve.d.ts.map

package/dist/resources/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/resources/resolve.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,aAAa;IAErD;;;;;;OAMG;IACI,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,MAAM;IAU3E;;;;;;OAMG;IACI,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,MAAM;IAS9E;;;;OAIG;IACI,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAK/C;;;;;;OAMG;IACU,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC;CA6B5F"}

package/dist/resources/subtitles.d.ts

@@ -0,0 +1,52 @@
+import type { HttpTransport } from '../transport';
+import type { GetSubtitlesOptions, GetTvSubtitlesOptions, SubtitleTrack } from '../types';
+export interface SubtitlesListResult {
+    subtitles: SubtitleTrack[];
+}
+export declare class SubtitlesResource {
+    private readonly transport;
+    constructor(transport: HttpTransport);
+    /**
+     * Fetches the complete list of available subtitle tracks for a movie.
+     *
+     * @param tmdbId TMDB Movie ID
+     * @param options Language filter options (e.g. { lang: 'en' })
+     *
+     * @example
+     * ```typescript
+     * const { subtitles } = await rawcast.subtitles.getMovie(550, { lang: 'en' });
+     * console.log(subtitles);
+     * ```
+     */
+    getMovie(tmdbId: string | number, options?: GetSubtitlesOptions): Promise<SubtitlesListResult>;
+    /**
+     * Fetches the complete list of available subtitle tracks for a TV episode.
+     *
+     * @param tmdbId TMDB TV Show ID or options object
+     * @param season Season number (1-indexed)
+     * @param episode Episode number (1-indexed)
+     * @param options Language filter options
+     *
+     * @example
+     * ```typescript
+     * const { subtitles } = await rawcast.subtitles.getTv(1399, 1, 1, { lang: 'en' });
+     * ```
+     */
+    getTv(tmdbIdOrOptions: string | number | (GetTvSubtitlesOptions & {
+        tmdbId: string | number;
+    }), season?: number, episode?: number, options?: GetSubtitlesOptions): Promise<SubtitlesListResult>;
+    /**
+     * Builds the formatted WebVTT proxy URL for a raw upstream subtitle URL.
+     * Useful for passing directly to `<track src="..." />` in HTML5 video, Video.js, or Plyr.
+     *
+     * @param rawSubtitleUrl Upstream SRT or VTT URL
+     */
+    getVttUrl(rawSubtitleUrl: string): string;
+    /**
+     * Fetches and converts a remote SRT/VTT subtitle file to standardized WebVTT plain text.
+     *
+     * @param rawSubtitleUrl Upstream subtitle URL
+     */
+    fetchVtt(rawSubtitleUrl: string): Promise<string>;
+}
+//# sourceMappingURL=subtitles.d.ts.map

package/dist/resources/subtitles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subtitles.d.ts","sourceRoot":"","sources":["../../src/resources/subtitles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE1F,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,aAAa,EAAE,CAAC;CAC5B;AAED,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,aAAa;IAErD;;;;;;;;;;;OAWG;IACU,QAAQ,CACnB,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,mBAAmB,CAAC;IAS/B;;;;;;;;;;;;OAYG;IACU,KAAK,CAChB,eAAe,EAAE,MAAM,GAAG,MAAM,GAAG,CAAC,qBAAqB,GAAG;QAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC,EACxF,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,mBAAmB,CAAC;IA8B/B;;;;;OAKG;IACI,SAAS,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM;IAKhD;;;;OAIG;IACU,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAK/D"}

package/dist/resources/tv.d.ts

@@ -0,0 +1,48 @@
+import { SourcesResponse } from '../response';
+import type { HttpTransport } from '../transport';
+import type { DownloadResult, GetTvDownloadOptions, GetTvSourcesOptions, MediaDownloadResult } from '../types';
+export declare class TvResource {
+    private readonly transport;
+    constructor(transport: HttpTransport);
+    /**
+     * Resolves ranked streaming servers, adaptive HLS/DASH playlists, and subtitles for a TV episode.
+     *
+     * @param tmdbId TMDB TV Show ID (e.g. 1399 for Game of Thrones) or options object
+     * @param season Season number (1-indexed)
+     * @param episode Episode number (1-indexed)
+     * @param options Optional audio language or title override
+     *
+     * @example
+     * ```typescript
+     * const sources = await rawcast.tv.getSources(1399, 1, 1);
+     * const stream = sources.bestStream({ preferFormat: 'hls' });
+     * console.log(stream.manifestUrl);
+     * ```
+     */
+    getSources(tmdbIdOrOptions: string | number | GetTvSourcesOptions, season?: number, episode?: number, options?: {
+        lang?: string;
+        preferredLang?: string;
+        title?: string;
+    }): Promise<SourcesResponse>;
+    /**
+     * Fetches direct MP4 video download URLs with RFC 6266 filename attachment headers for a TV episode.
+     *
+     * @param tmdbId TMDB TV Show ID or options object
+     * @param season Season number (1-indexed)
+     * @param episode Episode number (1-indexed)
+     * @param options Target quality (e.g. '1080p', '720p') and filename title override
+     *
+     * @example
+     * ```typescript
+     * // Fetch single quality download:
+     * const download = await rawcast.tv.getDownload(1399, 1, 1, { quality: '1080p' });
+     * console.log(download.downloadUrl, download.filename);
+     *
+     * // Fetch all available qualities:
+     * const list = await rawcast.tv.getDownload(1399, 1, 1);
+     * console.log(list.downloads);
+     * ```
+     */
+    getDownload(tmdbIdOrOptions: string | number | GetTvDownloadOptions, season?: number, episode?: number, options?: Omit<GetTvDownloadOptions, 'season' | 'episode'>): Promise<DownloadResult | MediaDownloadResult>;
+}
+//# sourceMappingURL=tv.d.ts.map

package/dist/resources/tv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tv.d.ts","sourceRoot":"","sources":["../../src/resources/tv.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EAGpB,MAAM,UAAU,CAAC;AAElB,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,aAAa;IAErD;;;;;;;;;;;;;;OAcG;IACU,UAAU,CACrB,eAAe,EAAE,MAAM,GAAG,MAAM,GAAG,mBAAmB,EACtD,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GACtE,OAAO,CAAC,eAAe,CAAC;IAuC3B;;;;;;;;;;;;;;;;;;OAkBG;IACU,WAAW,CACtB,eAAe,EAAE,MAAM,GAAG,MAAM,GAAG,oBAAoB,EACvD,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,GAAE,IAAI,CAAC,oBAAoB,EAAE,QAAQ,GAAG,SAAS,CAAM,GAC7D,OAAO,CAAC,cAAc,GAAG,mBAAmB,CAAC;CAuCjD"}

package/dist/response.d.ts

@@ -0,0 +1,46 @@
+import type { BestStreamOptions, ServerGroup, StreamItem, SubtitleTrack } from './types';
+/**
+ * Rich wrapper class around media sources response, providing stream selection
+ * algorithms and subtitle helpers.
+ */
+export declare class SourcesResponse {
+    readonly servers: ServerGroup[];
+    readonly subtitles: SubtitleTrack[];
+    constructor(data: {
+        servers?: ServerGroup[];
+        subtitles?: SubtitleTrack[];
+    });
+    /**
+     * Flattened list of all available stream renditions across all server groups.
+     */
+    get allStreams(): StreamItem[];
+    /**
+     * All HLS (.m3u8) streams across all servers.
+     */
+    get hlsStreams(): StreamItem[];
+    /**
+     * All MPEG-DASH (.mpd) streams across all servers.
+     */
+    get dashStreams(): StreamItem[];
+    /**
+     * All direct MP4 video streams across all servers.
+     */
+    get mp4Streams(): StreamItem[];
+    /**
+     * Selects the single best stream according to format preference, audio, and quality criteria.
+     *
+     * @example
+     * ```typescript
+     * const stream = sources.bestStream({ preferFormat: 'hls', maxQuality: '1080p' });
+     * console.log(stream.manifestUrl);
+     * ```
+     */
+    bestStream(options?: BestStreamOptions): StreamItem | null;
+    /**
+     * Filters subtitles matching the requested language name or ISO code.
+     *
+     * @param languageOrCode e.g. "English", "en", "Spanish", "es"
+     */
+    subtitlesByLang(languageOrCode: string): SubtitleTrack[];
+}
+//# sourceMappingURL=response.d.ts.map

package/dist/response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../src/response.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAazF;;;GAGG;AACH,qBAAa,eAAe;IAC1B,SAAgB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvC,SAAgB,SAAS,EAAE,aAAa,EAAE,CAAC;gBAE/B,IAAI,EAAE;QAAE,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;QAAC,SAAS,CAAC,EAAE,aAAa,EAAE,CAAA;KAAE;IAK1E;;OAEG;IACH,IAAW,UAAU,IAAI,UAAU,EAAE,CAEpC;IAED;;OAEG;IACH,IAAW,UAAU,IAAI,UAAU,EAAE,CAEpC;IAED;;OAEG;IACH,IAAW,WAAW,IAAI,UAAU,EAAE,CAErC;IAED;;OAEG;IACH,IAAW,UAAU,IAAI,UAAU,EAAE,CAEpC;IAED;;;;;;;;OAQG;IACI,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,UAAU,GAAG,IAAI;IAyErE;;;;OAIG;IACI,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,aAAa,EAAE;CAUhE"}

package/dist/transport.d.ts

@@ -0,0 +1,23 @@
+import type { QuotaState, RawcastOptions } from './types';
+export declare class HttpTransport {
+    readonly baseUrl: string;
+    private readonly apiKey;
+    private readonly timeoutMs;
+    private readonly maxRetries;
+    private readonly fetchFn;
+    readonly quota: QuotaState;
+    constructor(options: RawcastOptions);
+    private updateQuotaHeaders;
+    private sleep;
+    getBaseUrl(): string;
+    getApiKey(): string;
+    getFetch(): typeof fetch;
+    rawFetch(endpoint: string, options?: RequestInit & {
+        skipAuth?: boolean;
+    }): Promise<Response>;
+    request<T>(endpoint: string, options?: RequestInit & {
+        timeoutMs?: number;
+        skipAuth?: boolean;
+    }): Promise<T>;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE1D,qBAAa,aAAa;IACxB,SAAgB,OAAO,EAAE,MAAM,CAAC;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IAEvC,SAAgB,KAAK,EAAE,UAAU,CAK/B;gBAEU,OAAO,EAAE,cAAc;IAoBnC,OAAO,CAAC,kBAAkB;YAcZ,KAAK;IAIZ,UAAU,IAAI,MAAM;IAIpB,SAAS,IAAI,MAAM;IAInB,QAAQ,IAAI,OAAO,KAAK;IAIlB,QAAQ,CACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,WAAW,GAAG;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAO,GACjD,OAAO,CAAC,QAAQ,CAAC;IAgBP,OAAO,CAAC,CAAC,EACpB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,WAAW,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAO,GACrE,OAAO,CAAC,CAAC,CAAC;CAmId"}

package/dist/types.d.ts

@@ -0,0 +1,205 @@
+import type { DownloadOption, MediaDownloadResult, MovieMetadata, ServerGroup, StreamItem, SubtitleTrack, TvEpisodeMetadata, TvMetadata, TvSeasonInfo } from '@rawcast/shared';
+export type { DownloadOption, MediaDownloadResult, MovieMetadata, ServerGroup, StreamItem, SubtitleTrack, TvEpisodeMetadata, TvMetadata, TvSeasonInfo, };
+export interface HealthStatus {
+    status: string;
+    timestamp: string;
+    version: string;
+    uptime: number;
+}
+export interface ProviderHealthDashboard {
+    status: string;
+    healthyCount: number;
+    degradedCount: number;
+    downCount: number;
+    totalProviders: number;
+    timestamp: string;
+    servers: Record<string, string>;
+}
+/**
+ * Configuration options for the Rawcast SDK client.
+ */
+export interface RawcastOptions {
+    /**
+     * Your Rawcast API key (starts with rc_live_).
+     */
+    apiKey: string;
+    /**
+     * Base URL of the Rawcast API.
+     * @default "https://zeroms.space/v1"
+     */
+    baseUrl?: string;
+    /**
+     * Request timeout in milliseconds.
+     * @default 25000
+     */
+    timeoutMs?: number;
+    /**
+     * Maximum number of automatic retries on rate limits (HTTP 429) or transient 5xx errors.
+     * @default 2
+     */
+    maxRetries?: number;
+    /**
+     * Custom fetch implementation (useful for testing, mocked environments, or specialized proxies).
+     */
+    fetch?: typeof fetch;
+}
+/**
+ * Snapshot of the active rate-limit and quota headers returned by the API.
+ */
+export interface QuotaState {
+    /**
+     * Monthly request limit for your current subscription tier.
+     */
+    limit: number | null;
+    /**
+     * Remaining requests allowed in the current billing cycle.
+     */
+    remaining: number | null;
+    /**
+     * Unix timestamp (in seconds) when the quota resets.
+     */
+    reset: number | null;
+    /**
+     * Timestamp of the most recent quota header capture.
+     */
+    lastUpdated: number | null;
+}
+/**
+ * Options for resolving movie streams.
+ */
+export interface GetMovieSourcesOptions {
+    /**
+     * Preferred audio or subtitle language (e.g. 'en', 'es', 'fr', 'hi').
+     * @default 'en'
+     */
+    lang?: string;
+    /**
+     * Optional custom title override for generated download filenames.
+     */
+    title?: string;
+}
+/**
+ * Options for resolving TV episode streams.
+ */
+export interface GetTvSourcesOptions {
+    /**
+     * TMDB TV Show ID (e.g. '1399' for Game of Thrones).
+     */
+    tmdbId: string | number;
+    /**
+     * Season number (1-indexed).
+     */
+    season: number;
+    /**
+     * Episode number (1-indexed).
+     */
+    episode: number;
+    /**
+     * Preferred audio or subtitle language (e.g. 'en', 'es').
+     * @default 'en'
+     */
+    lang?: string;
+    /**
+     * Alias for lang.
+     */
+    preferredLang?: string;
+    /**
+     * Optional custom title override.
+     */
+    title?: string;
+}
+/**
+ * Options for fetching direct MP4 download links.
+ */
+export interface GetMovieDownloadOptions {
+    /**
+     * Desired video quality ('1080p', '720p', '480p', '360p').
+     */
+    quality?: '1080p' | '720p' | '480p' | '360p' | 'highest' | 'auto';
+    /**
+     * Preferred audio language.
+     */
+    lang?: string;
+    /**
+     * Custom title override for RFC 6266 filename attachment.
+     */
+    title?: string;
+}
+export interface GetTvDownloadOptions extends GetMovieDownloadOptions {
+    /**
+     * Optional TMDB ID if passing all options in a single object.
+     */
+    tmdbId?: string | number;
+    /**
+     * Season number (1-indexed).
+     */
+    season: number;
+    /**
+     * Episode number (1-indexed).
+     */
+    episode: number;
+}
+/**
+ * Direct MP4 download result.
+ */
+export interface DownloadResult {
+    tmdbId: string;
+    mediaType: 'movie' | 'tv';
+    title: string;
+    quality: string;
+    format: 'mp4';
+    url: string;
+    downloadUrl: string;
+    filename: string;
+}
+/**
+ * Options for querying subtitles.
+ */
+export interface GetSubtitlesOptions {
+    /**
+     * Filter subtitles by 2-letter ISO language code (e.g. 'en', 'es', 'fr').
+     */
+    lang?: string;
+}
+export interface GetTvSubtitlesOptions extends GetSubtitlesOptions {
+    season: number;
+    episode: number;
+}
+/**
+ * Options for querying TV show metadata.
+ */
+export interface GetTvMetadataOptions {
+    /**
+     * Target season to fetch detailed episode breakdown.
+     */
+    season?: number;
+    /**
+     * Localization language for overview and titles.
+     * @default 'en-US'
+     */
+    lang?: string;
+}
+/**
+ * Filter and ranking criteria for picking the best stream.
+ */
+export interface BestStreamOptions {
+    /**
+     * Preferred streaming format.
+     * @default 'hls'
+     */
+    preferFormat?: 'hls' | 'dash' | 'mp4';
+    /**
+     * Maximum acceptable video quality (e.g. '1080p', '720p').
+     */
+    maxQuality?: '1080p' | '720p' | '480p' | '360p';
+    /**
+     * Preferred audio language track.
+     * @default 'English'
+     */
+    preferredAudio?: string;
+    /**
+     * Whether to require a stream with download attachment headers.
+     */
+    requireDownload?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@rawcast/sdk",
+  "version": "0.1.0",
+  "description": "Official TypeScript/JavaScript SDK for Rawcast Media Resolution API",
+  "author": "Rawcast Team",
+  "license": "MIT",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "files": ["dist", "README.md"],
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "scripts": {
+    "build": "bun build ./src/index.ts --outfile ./dist/index.mjs --target node --format esm && bun build ./src/index.ts --outfile ./dist/index.cjs --target node --format cjs && tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@rawcast/shared": "workspace:*",
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.3"
+  }
+}