@movie-effect/watchmode

An Effect-based client for the Watchmode API.

Installation

npm install @movie-effect/watchmode effect @effect/platform @effect/platform-node
# or
pnpm add @movie-effect/watchmode effect @effect/platform @effect/platform-node

Features

• Full TypeScript support with Effect
• Type-safe API responses with Schema validation
• Built-in rate limiting
• Streaming availability data
• Observability with Effect tracing

Authentication

This library requires a Watchmode API key.

1. Create an account at api.watchmode.com
2. Subscribe to a plan (free tier available with limited requests)
3. Copy your API key from the dashboard

For local development, set the WATCHMODE_API_KEY environment variable:

export WATCHMODE_API_KEY="your-api-key"

Quick Start

import { NodeHttpClient } from "@effect/platform-node";
import { WatchmodeClient, WatchmodeConfig } from "@movie-effect/watchmode";
import { Console, Effect } from "effect";

const program = Effect.gen(function* () {
  const client = yield* WatchmodeClient;
  const sources = yield* client.getSources();
  yield* Console.log(sources);
});

const runnable = program.pipe(
  Effect.provide(WatchmodeClient.Default),
  Effect.provide(WatchmodeConfig.layer({ apiKey: "your-api-key" })),
  Effect.provide(NodeHttpClient.layer),
);

Effect.runPromise(runnable);

API Coverage

• Streaming sources and availability
• Title search and details
• Release information

Related Packages

• @movie-effect/watchmode-cli - CLI for Watchmode
• @movie-effect/core - Shared utilities

License

MIT