pocketcasts-api 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,210 @@
+import { z } from 'zod';
+export declare const PlayingStatusSchema: z.ZodUnion<readonly [z.ZodPipe<z.ZodNumber, z.ZodTransform<"unplayed" | "playing" | "played", number>>, z.ZodEnum<{
+    unplayed: "unplayed";
+    playing: "playing";
+    played: "played";
+}>]>;
+export type PlayingStatus = 'unplayed' | 'playing' | 'played';
+export declare const PLAYING_STATUS_TO_API: Record<PlayingStatus, number>;
+export declare const PodcastSchema: z.ZodPipe<z.ZodObject<{
+    uuid: z.ZodString;
+    title: z.ZodString;
+    author: z.ZodString;
+    description: z.ZodDefault<z.ZodString>;
+    url: z.ZodString;
+    thumbnail_url: z.ZodOptional<z.ZodString>;
+    language: z.ZodOptional<z.ZodString>;
+    categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    media_type: z.ZodOptional<z.ZodString>;
+    sort_order: z.ZodOptional<z.ZodNumber>;
+}, z.core.$loose>, z.ZodTransform<{
+    thumbnailUrl: string | undefined;
+    mediaType: string | undefined;
+    sortOrder: number | undefined;
+    uuid: string;
+    title: string;
+    author: string;
+    description: string;
+    url: string;
+    language?: string | undefined;
+    categories?: string[] | undefined;
+}, {
+    [x: string]: unknown;
+    uuid: string;
+    title: string;
+    author: string;
+    description: string;
+    url: string;
+    thumbnail_url?: string | undefined;
+    language?: string | undefined;
+    categories?: string[] | undefined;
+    media_type?: string | undefined;
+    sort_order?: number | undefined;
+}>>;
+export type Podcast = z.output<typeof PodcastSchema>;
+export declare const EpisodeSchema: z.ZodPipe<z.ZodObject<{
+    uuid: z.ZodString;
+    title: z.ZodString;
+    url: z.ZodDefault<z.ZodString>;
+    podcastUuid: z.ZodOptional<z.ZodString>;
+    podcast_uuid: z.ZodOptional<z.ZodString>;
+    podcastTitle: z.ZodOptional<z.ZodString>;
+    podcast_title: z.ZodOptional<z.ZodString>;
+    duration: z.ZodDefault<z.ZodNumber>;
+    published: z.ZodOptional<z.ZodString>;
+    publishedAt: z.ZodOptional<z.ZodString>;
+    published_at: z.ZodOptional<z.ZodString>;
+    fileType: z.ZodOptional<z.ZodString>;
+    file_type: z.ZodOptional<z.ZodString>;
+    size: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>]>>;
+    playingStatus: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodNumber, z.ZodTransform<"unplayed" | "playing" | "played", number>>, z.ZodEnum<{
+        unplayed: "unplayed";
+        playing: "playing";
+        played: "played";
+    }>]>>;
+    playing_status: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodNumber, z.ZodTransform<"unplayed" | "playing" | "played", number>>, z.ZodEnum<{
+        unplayed: "unplayed";
+        playing: "playing";
+        played: "played";
+    }>]>>;
+    playedUpTo: z.ZodOptional<z.ZodNumber>;
+    played_up_to: z.ZodOptional<z.ZodNumber>;
+    starred: z.ZodDefault<z.ZodUnion<readonly [z.ZodBoolean, z.ZodPipe<z.ZodNumber, z.ZodTransform<boolean, number>>]>>;
+    isDeleted: z.ZodDefault<z.ZodUnion<readonly [z.ZodBoolean, z.ZodPipe<z.ZodNumber, z.ZodTransform<boolean, number>>]>>;
+    is_deleted: z.ZodDefault<z.ZodUnion<readonly [z.ZodBoolean, z.ZodPipe<z.ZodNumber, z.ZodTransform<boolean, number>>]>>;
+    isVideo: z.ZodDefault<z.ZodUnion<readonly [z.ZodBoolean, z.ZodPipe<z.ZodNumber, z.ZodTransform<boolean, number>>]>>;
+    is_video: z.ZodDefault<z.ZodUnion<readonly [z.ZodBoolean, z.ZodPipe<z.ZodNumber, z.ZodTransform<boolean, number>>]>>;
+}, z.core.$loose>, z.ZodTransform<{
+    podcastUuid: string;
+    podcastTitle: string | undefined;
+    publishedAt: string;
+    fileType: string | undefined;
+    playingStatus: "unplayed" | "playing" | "played";
+    playedUpTo: number;
+    isDeleted: boolean;
+    isVideo: boolean;
+    uuid: string;
+    title: string;
+    url: string;
+    duration: number;
+    starred: boolean;
+    is_deleted: boolean;
+    is_video: boolean;
+    podcast_uuid?: string | undefined;
+    podcast_title?: string | undefined;
+    published?: string | undefined;
+    published_at?: string | undefined;
+    file_type?: string | undefined;
+    size?: number | undefined;
+    playing_status?: "unplayed" | "playing" | "played" | undefined;
+    played_up_to?: number | undefined;
+}, {
+    [x: string]: unknown;
+    uuid: string;
+    title: string;
+    url: string;
+    duration: number;
+    starred: boolean;
+    isDeleted: boolean;
+    is_deleted: boolean;
+    isVideo: boolean;
+    is_video: boolean;
+    podcastUuid?: string | undefined;
+    podcast_uuid?: string | undefined;
+    podcastTitle?: string | undefined;
+    podcast_title?: string | undefined;
+    published?: string | undefined;
+    publishedAt?: string | undefined;
+    published_at?: string | undefined;
+    fileType?: string | undefined;
+    file_type?: string | undefined;
+    size?: number | undefined;
+    playingStatus?: "unplayed" | "playing" | "played" | undefined;
+    playing_status?: "unplayed" | "playing" | "played" | undefined;
+    playedUpTo?: number | undefined;
+    played_up_to?: number | undefined;
+}>>;
+export type Episode = z.output<typeof EpisodeSchema>;
+export declare const SearchResultSchema: z.ZodPipe<z.ZodObject<{
+    uuid: z.ZodString;
+    title: z.ZodString;
+    author: z.ZodDefault<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    thumbnail_url: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>, z.ZodTransform<{
+    thumbnailUrl: string | undefined;
+    uuid: string;
+    title: string;
+    author: string;
+    description?: string | undefined;
+}, {
+    [x: string]: unknown;
+    uuid: string;
+    title: string;
+    author: string;
+    description?: string | undefined;
+    thumbnail_url?: string | undefined;
+}>>;
+export type SearchResult = z.output<typeof SearchResultSchema>;
+export declare const ListeningStatsSchema: z.ZodPipe<z.ZodObject<{
+    timeSilenceRemoval: z.ZodDefault<z.ZodUnion<readonly [z.ZodNumber, z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>]>>;
+    timeListened: z.ZodDefault<z.ZodUnion<readonly [z.ZodNumber, z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>]>>;
+    timeSkipping: z.ZodDefault<z.ZodUnion<readonly [z.ZodNumber, z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>]>>;
+    timeIntroSkipping: z.ZodDefault<z.ZodUnion<readonly [z.ZodNumber, z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>]>>;
+    timeVariableSpeed: z.ZodDefault<z.ZodUnion<readonly [z.ZodNumber, z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>]>>;
+    totalPodcasts: z.ZodDefault<z.ZodUnion<readonly [z.ZodNumber, z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>]>>;
+    totalEpisodes: z.ZodDefault<z.ZodUnion<readonly [z.ZodNumber, z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>]>>;
+    timesStartedAt: z.ZodOptional<z.ZodString>;
+    startedAt: z.ZodOptional<z.ZodString>;
+    time_silence_removal: z.ZodDefault<z.ZodUnion<readonly [z.ZodNumber, z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>]>>;
+    time_listened: z.ZodDefault<z.ZodUnion<readonly [z.ZodNumber, z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>]>>;
+    time_skipping: z.ZodDefault<z.ZodUnion<readonly [z.ZodNumber, z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>]>>;
+    time_intro_skipping: z.ZodDefault<z.ZodUnion<readonly [z.ZodNumber, z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>]>>;
+    time_variable_speed: z.ZodDefault<z.ZodUnion<readonly [z.ZodNumber, z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>]>>;
+    total_podcasts: z.ZodDefault<z.ZodUnion<readonly [z.ZodNumber, z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>]>>;
+    total_episodes: z.ZodDefault<z.ZodUnion<readonly [z.ZodNumber, z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>]>>;
+    started_at: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>, z.ZodTransform<{
+    timeSilenceRemoval: number;
+    timeListened: number;
+    timeSkipping: number;
+    timeIntroSkipping: number;
+    timeVariableSpeed: number;
+    totalPodcasts: number;
+    totalEpisodes: number;
+    startedAt: string;
+    time_silence_removal: number;
+    time_listened: number;
+    time_skipping: number;
+    time_intro_skipping: number;
+    time_variable_speed: number;
+    total_podcasts: number;
+    total_episodes: number;
+    timesStartedAt?: string | undefined;
+    started_at?: string | undefined;
+}, {
+    [x: string]: unknown;
+    timeSilenceRemoval: number;
+    timeListened: number;
+    timeSkipping: number;
+    timeIntroSkipping: number;
+    timeVariableSpeed: number;
+    totalPodcasts: number;
+    totalEpisodes: number;
+    time_silence_removal: number;
+    time_listened: number;
+    time_skipping: number;
+    time_intro_skipping: number;
+    time_variable_speed: number;
+    total_podcasts: number;
+    total_episodes: number;
+    timesStartedAt?: string | undefined;
+    startedAt?: string | undefined;
+    started_at?: string | undefined;
+}>>;
+export type ListeningStats = z.output<typeof ListeningStatsSchema>;
+export declare const LoginResponseSchema: z.ZodObject<{
+    token: z.ZodString;
+    uuid: z.ZodString;
+}, z.core.$strip>;
+//# 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":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAgBxB,eAAO,MAAM,mBAAmB;;;;IAG9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE9D,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAI/D,CAAC;AAIF,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkBrB,CAAC;AAEN,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,aAAa,CAAC,CAAC;AAarD,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCrB,CAAC;AAEN,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,aAAa,CAAC,CAAC;AAIrD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;GAW1B,CAAC;AAEN,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAS/D,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgC5B,CAAC;AAEN,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAInE,eAAO,MAAM,mBAAmB;;;iBAG9B,CAAC"}

package/dist/types.js

@@ -0,0 +1,145 @@
+import { z } from 'zod';
+// --- Playing Status ---
+// The API returns playing status as either:
+//   - a number: 0=unplayed, 1=not played (same as unplayed), 2=playing, 3=played
+//   - a string: "unplayed", "playing", "played"
+const PLAYING_STATUS_NUM_MAP = {
+    0: 'unplayed',
+    1: 'unplayed', // value 1 appears in the wild, treat as unplayed
+    2: 'playing',
+    3: 'played',
+};
+const PLAYING_STATUS_STRINGS = ['unplayed', 'playing', 'played'];
+export const PlayingStatusSchema = z.union([
+    z.number().transform((n) => PLAYING_STATUS_NUM_MAP[n] ?? 'unplayed'),
+    z.enum(PLAYING_STATUS_STRINGS),
+]);
+export const PLAYING_STATUS_TO_API = {
+    unplayed: 0,
+    playing: 2,
+    played: 3,
+};
+// --- Podcast ---
+export const PodcastSchema = z
+    .looseObject({
+    uuid: z.string(),
+    title: z.string(),
+    author: z.string(),
+    description: z.string().default(''),
+    url: z.string(),
+    thumbnail_url: z.string().optional(),
+    language: z.string().optional(),
+    categories: z.array(z.string()).optional(),
+    media_type: z.string().optional(),
+    sort_order: z.number().optional(),
+})
+    .transform(({ thumbnail_url, media_type, sort_order, ...rest }) => ({
+    ...rest,
+    thumbnailUrl: thumbnail_url,
+    mediaType: media_type,
+    sortOrder: sort_order,
+}));
+// --- Episode ---
+// The real API returns camelCase fields (podcastUuid, playingStatus, etc.)
+// We accept both camelCase and snake_case for flexibility.
+const boolOrNum = z
+    .union([z.boolean(), z.number().transform((n) => n === 1)])
+    .default(false);
+const stringOrNum = z
+    .union([z.number(), z.string().transform((s) => parseInt(s, 10) || 0)])
+    .optional();
+export const EpisodeSchema = z
+    .looseObject({
+    uuid: z.string(),
+    title: z.string(),
+    url: z.string().default(''),
+    // Accept both camelCase (real API) and snake_case
+    podcastUuid: z.string().optional(),
+    podcast_uuid: z.string().optional(),
+    podcastTitle: z.string().optional(),
+    podcast_title: z.string().optional(),
+    duration: z.number().default(0),
+    published: z.string().optional(),
+    publishedAt: z.string().optional(),
+    published_at: z.string().optional(),
+    fileType: z.string().optional(),
+    file_type: z.string().optional(),
+    size: stringOrNum,
+    playingStatus: PlayingStatusSchema.optional(),
+    playing_status: PlayingStatusSchema.optional(),
+    playedUpTo: z.number().optional(),
+    played_up_to: z.number().optional(),
+    starred: boolOrNum,
+    isDeleted: boolOrNum,
+    is_deleted: boolOrNum,
+    isVideo: boolOrNum,
+    is_video: boolOrNum,
+})
+    .transform((e) => ({
+    ...e,
+    podcastUuid: e.podcastUuid ?? e.podcast_uuid ?? '',
+    podcastTitle: e.podcastTitle ?? e.podcast_title,
+    publishedAt: e.publishedAt || e.published_at || e.published || '',
+    fileType: e.fileType ?? e.file_type,
+    playingStatus: e.playingStatus ?? e.playing_status ?? 'unplayed',
+    playedUpTo: e.playedUpTo ?? e.played_up_to ?? 0,
+    isDeleted: e.isDeleted || e.is_deleted || false,
+    isVideo: e.isVideo || e.is_video || false,
+}));
+// --- Search Result ---
+export const SearchResultSchema = z
+    .looseObject({
+    uuid: z.string(),
+    title: z.string(),
+    author: z.string().default(''),
+    description: z.string().optional(),
+    thumbnail_url: z.string().optional(),
+})
+    .transform(({ thumbnail_url, ...rest }) => ({
+    ...rest,
+    thumbnailUrl: thumbnail_url,
+}));
+// --- Listening Stats ---
+// Real API returns camelCase with some values as strings (not numbers).
+const numOrStr = z
+    .union([z.number(), z.string().transform((s) => parseFloat(s) || 0)])
+    .default(0);
+export const ListeningStatsSchema = z
+    .looseObject({
+    // camelCase (real API)
+    timeSilenceRemoval: numOrStr,
+    timeListened: numOrStr,
+    timeSkipping: numOrStr,
+    timeIntroSkipping: numOrStr,
+    timeVariableSpeed: numOrStr,
+    totalPodcasts: numOrStr,
+    totalEpisodes: numOrStr,
+    timesStartedAt: z.string().optional(),
+    startedAt: z.string().optional(),
+    // snake_case fallback
+    time_silence_removal: numOrStr,
+    time_listened: numOrStr,
+    time_skipping: numOrStr,
+    time_intro_skipping: numOrStr,
+    time_variable_speed: numOrStr,
+    total_podcasts: numOrStr,
+    total_episodes: numOrStr,
+    started_at: z.string().optional(),
+})
+    .transform((s) => ({
+    ...s,
+    timeSilenceRemoval: s.timeSilenceRemoval || s.time_silence_removal || 0,
+    timeListened: s.timeListened || s.time_listened || 0,
+    timeSkipping: s.timeSkipping || s.time_skipping || 0,
+    timeIntroSkipping: s.timeIntroSkipping || s.time_intro_skipping || 0,
+    timeVariableSpeed: s.timeVariableSpeed || s.time_variable_speed || 0,
+    totalPodcasts: s.totalPodcasts || s.total_podcasts || 0,
+    totalEpisodes: s.totalEpisodes || s.total_episodes || 0,
+    startedAt: s.timesStartedAt ?? s.startedAt ?? s.started_at ?? '',
+}));
+// --- Login Response ---
+export const LoginResponseSchema = z.object({
+    token: z.string(),
+    uuid: z.string(),
+});
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "pocketcasts-api",
+  "version": "0.1.0",
+  "description": "Unofficial TypeScript client for the Pocket Casts API",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:integration": "RUN_INTEGRATION=true vitest run test/integration.test.ts",
+    "lint": "eslint . && tsc --noEmit",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "pocketcasts",
+    "pocket-casts",
+    "podcast",
+    "api"
+  ],
+  "license": "MIT",
+  "author": "Madison Rickert",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/madisonrickert/pocketcasts-api.git"
+  },
+  "bugs": {
+    "url": "https://github.com/madisonrickert/pocketcasts-api/issues"
+  },
+  "homepage": "https://github.com/madisonrickert/pocketcasts-api#readme",
+  "dependencies": {
+    "zod": "^4.4"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "eslint": "^10.4.0",
+    "prettier": "^3.8.3",
+    "typescript": "^6.0",
+    "typescript-eslint": "^8.60.0",
+    "vitest": "^4.1"
+  }
+}

package/src/client.ts

@@ -0,0 +1,231 @@
+import { PocketCastsAuthError, PocketCastsAPIError } from './errors.js';
+import {
+  LoginResponseSchema,
+  PodcastSchema,
+  EpisodeSchema,
+  SearchResultSchema,
+  ListeningStatsSchema,
+  type Podcast,
+  type Episode,
+  type SearchResult,
+  type ListeningStats,
+  type PlayingStatus,
+} from './types.js';
+import { z } from 'zod';
+
+const API_BASE = 'https://api.pocketcasts.com';
+const LISTS_BASE = 'https://lists.pocketcasts.com';
+
+type FetchFn = typeof globalThis.fetch;
+
+export interface PocketCastsOptions {
+  fetch?: FetchFn;
+}
+
+export class PocketCasts {
+  private token: string | null = null;
+  private fetch: FetchFn;
+
+  constructor(options: PocketCastsOptions = {}) {
+    this.fetch = options.fetch ?? globalThis.fetch;
+  }
+
+  async login(email: string, password: string): Promise<void> {
+    const res = await this.fetch(`${API_BASE}/user/login`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ email, password, scope: 'webplayer' }),
+    });
+
+    if (!res.ok) {
+      const text = await res.text();
+      throw new PocketCastsAuthError(`Login failed (${res.status}): ${text}`);
+    }
+
+    const data = LoginResponseSchema.parse(await res.json());
+    this.token = data.token;
+  }
+
+  private async postAuth<T>(path: string, body: object = {}): Promise<T> {
+    if (!this.token) {
+      throw new PocketCastsAuthError('Not logged in. Call login() first.');
+    }
+
+    const res = await this.fetch(`${API_BASE}${path}`, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        Authorization: `Bearer ${this.token}`,
+      },
+      body: JSON.stringify(body),
+    });
+
+    if (!res.ok) {
+      const text = await res.text();
+      throw new PocketCastsAPIError(
+        `API error (${res.status}): ${text}`,
+        res.status,
+      );
+    }
+
+    return (await res.json()) as T;
+  }
+
+  private async getPublic<T>(path: string): Promise<T> {
+    const res = await this.fetch(`${LISTS_BASE}${path}`);
+
+    if (!res.ok) {
+      const text = await res.text();
+      throw new PocketCastsAPIError(
+        `API error (${res.status}): ${text}`,
+        res.status,
+      );
+    }
+
+    return (await res.json()) as T;
+  }
+
+  async getSubscriptions(): Promise<{ podcasts: Podcast[] }> {
+    const data = await this.postAuth<{ podcasts: unknown[] }>(
+      '/user/podcast/list',
+    );
+    return { podcasts: z.array(PodcastSchema).parse(data.podcasts) };
+  }
+
+  async getNewReleases(): Promise<{ episodes: Episode[] }> {
+    const data = await this.postAuth<{ episodes: unknown[] }>(
+      '/user/new_releases',
+    );
+    return { episodes: z.array(EpisodeSchema).parse(data.episodes) };
+  }
+
+  async getInProgress(): Promise<{ episodes: Episode[] }> {
+    const data = await this.postAuth<{ episodes: unknown[] }>(
+      '/user/in_progress',
+    );
+    return { episodes: z.array(EpisodeSchema).parse(data.episodes) };
+  }
+
+  async getStarred(): Promise<{ episodes: Episode[] }> {
+    const data = await this.postAuth<{ episodes: unknown[] }>('/user/starred');
+    return { episodes: z.array(EpisodeSchema).parse(data.episodes) };
+  }
+
+  async getHistory(): Promise<{ episodes: Episode[] }> {
+    const data = await this.postAuth<{ episodes: unknown[] }>('/user/history');
+    return { episodes: z.array(EpisodeSchema).parse(data.episodes) };
+  }
+
+  async getStats(): Promise<ListeningStats> {
+    const data = await this.postAuth<unknown>('/user/stats/summary');
+    return ListeningStatsSchema.parse(data);
+  }
+
+  async getPodcast(uuid: string): Promise<Podcast> {
+    const data = await this.postAuth<unknown>('/podcasts/podcast', { uuid });
+    return PodcastSchema.parse(data);
+  }
+
+  async getEpisode(uuid: string): Promise<Episode> {
+    const data = await this.postAuth<unknown>('/episodes/episode', { uuid });
+    return EpisodeSchema.parse(data);
+  }
+
+  async getEpisodeNotes(uuid: string): Promise<string> {
+    const data = await this.postAuth<{ show_notes: string }>(
+      '/episodes/show_notes',
+      { uuid },
+    );
+    return data.show_notes;
+  }
+
+  async search(term: string): Promise<{ podcasts: SearchResult[] }> {
+    const data = await this.postAuth<{ podcasts: unknown[] }>(
+      '/discover/search',
+      { term },
+    );
+    return { podcasts: z.array(SearchResultSchema).parse(data.podcasts) };
+  }
+
+  async getTrending(): Promise<{ podcasts: SearchResult[] }> {
+    const data = await this.getPublic<{ podcasts: unknown[] }>(
+      '/trending.json',
+    );
+    return { podcasts: z.array(SearchResultSchema).parse(data.podcasts) };
+  }
+
+  async getPopular(): Promise<{ podcasts: SearchResult[] }> {
+    const data = await this.getPublic<{ podcasts: unknown[] }>('/popular.json');
+    return { podcasts: z.array(SearchResultSchema).parse(data.podcasts) };
+  }
+
+  async getFeatured(): Promise<{ podcasts: SearchResult[] }> {
+    const data = await this.getPublic<{ podcasts: unknown[] }>(
+      '/featured.json',
+    );
+    return { podcasts: z.array(SearchResultSchema).parse(data.podcasts) };
+  }
+
+  async subscribe(podcastUuid: string): Promise<void> {
+    await this.postAuth('/user/podcast/subscribe', { uuid: podcastUuid });
+  }
+
+  async unsubscribe(podcastUuid: string): Promise<void> {
+    await this.postAuth('/user/podcast/unsubscribe', { uuid: podcastUuid });
+  }
+
+  // Episode mutations use /sync/update_episode.
+  // The endpoint expects: uuid, podcast, and either status (1-4) or position/duration.
+  // Status values: 1=unplayed, 2=playing, 3=played, 4=? (validation says 1..4)
+
+  async starEpisode(podcastUuid: string, episodeUuid: string): Promise<void> {
+    // /sync/update_episode requires status or position alongside star
+    await this.postAuth('/sync/update_episode', {
+      uuid: episodeUuid,
+      podcast: podcastUuid,
+      star: 1,
+      status: 1, // required by validation, 1=unplayed (preserves current state)
+    });
+  }
+
+  async unstarEpisode(podcastUuid: string, episodeUuid: string): Promise<void> {
+    await this.postAuth('/sync/update_episode', {
+      uuid: episodeUuid,
+      podcast: podcastUuid,
+      star: 0,
+      status: 1,
+    });
+  }
+
+  async updatePlayingStatus(
+    podcastUuid: string,
+    episodeUuid: string,
+    status: PlayingStatus,
+  ): Promise<void> {
+    // The sync endpoint uses 1-based status: 1=unplayed, 2=playing, 3=played
+    const SYNC_STATUS_MAP: Record<PlayingStatus, number> = {
+      unplayed: 1,
+      playing: 2,
+      played: 3,
+    };
+    await this.postAuth('/sync/update_episode', {
+      uuid: episodeUuid,
+      podcast: podcastUuid,
+      status: SYNC_STATUS_MAP[status],
+    });
+  }
+
+  async updatePlaybackPosition(
+    podcastUuid: string,
+    episodeUuid: string,
+    position: number,
+    duration: number,
+  ): Promise<void> {
+    await this.postAuth('/sync/update_episode', {
+      uuid: episodeUuid,
+      podcast: podcastUuid,
+      position,
+      duration,
+    });
+  }
+}

package/src/errors.ts

@@ -0,0 +1,23 @@
+export class PocketCastsError extends Error {
+  constructor(message: string) {
+    super(message);
+    this.name = 'PocketCastsError';
+  }
+}
+
+export class PocketCastsAuthError extends PocketCastsError {
+  constructor(message: string) {
+    super(message);
+    this.name = 'PocketCastsAuthError';
+  }
+}
+
+export class PocketCastsAPIError extends PocketCastsError {
+  statusCode: number;
+
+  constructor(message: string, statusCode: number) {
+    super(message);
+    this.name = 'PocketCastsAPIError';
+    this.statusCode = statusCode;
+  }
+}