@syra.fm/sdk 0.3.0 → 0.5.0

package/lib/commonjs/live/types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["live/types.ts"],"mappings":"","ignoreList":[]}

package/lib/commonjs/live/validation.js

@@ -0,0 +1,238 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.ZStreamInfo = exports.ZStartStreamResponse = exports.ZSeriesEpisode = exports.ZSeries = exports.ZRoomTemplate = exports.ZRoomParticipant = exports.ZRoomAttachment = exports.ZRoom = exports.ZRecurrence = exports.ZRecording = exports.ZPodcastQueueItem = exports.ZHouseMember = exports.ZHouse = exports.ZGenerateStreamKeyResponse = void 0;
+exports.validateHouse = validateHouse;
+exports.validateRecording = validateRecording;
+exports.validateRecordings = validateRecordings;
+exports.validateRoom = validateRoom;
+exports.validateRooms = validateRooms;
+exports.validateSeries = validateSeries;
+var _zod = require("zod");
+// --- Podcast queue ---
+
+/**
+ * One podcast episode queued behind the current stream. `episodeId` is the
+ * opaque Syra episode handle; `syraPodcastId` (when present) identifies its show.
+ * The playable audio URL is never carried here — it is resolved server-side at
+ * play-time.
+ */
+const ZPodcastQueueItem = exports.ZPodcastQueueItem = _zod.z.object({
+  syraPodcastId: _zod.z.string().optional(),
+  episodeId: _zod.z.string()
+}).passthrough();
+// --- Room (replaces Space) ---
+
+const ZRoom = exports.ZRoom = _zod.z.object({
+  _id: _zod.z.string(),
+  id: _zod.z.string().optional(),
+  title: _zod.z.string(),
+  description: _zod.z.string().nullish(),
+  // Ownership
+  ownerType: _zod.z.enum(['profile', 'house', 'agora']).default('profile'),
+  host: _zod.z.string(),
+  houseId: _zod.z.string().optional().nullable(),
+  createdByAdmin: _zod.z.string().optional().nullable(),
+  // Classification
+  type: _zod.z.enum(['talk', 'stage', 'broadcast']).default('talk'),
+  broadcastKind: _zod.z.enum(['user', 'agora']).optional().nullable(),
+  // Lifecycle
+  status: _zod.z.enum(['scheduled', 'live', 'ended']),
+  scheduledStart: _zod.z.string().nullish(),
+  startedAt: _zod.z.string().nullish(),
+  endedAt: _zod.z.string().nullish(),
+  // Participation
+  speakerPermission: _zod.z.enum(['everyone', 'followers', 'invited']).nullish(),
+  participants: _zod.z.array(_zod.z.string()).default([]),
+  speakers: _zod.z.array(_zod.z.string()).default([]),
+  maxParticipants: _zod.z.number().default(100),
+  // Content
+  topic: _zod.z.string().nullish(),
+  tags: _zod.z.array(_zod.z.string()).optional(),
+  archived: _zod.z.boolean().optional().default(false),
+  seriesId: _zod.z.string().nullish(),
+  // Stats
+  stats: _zod.z.object({
+    peakListeners: _zod.z.number(),
+    totalJoined: _zod.z.number()
+  }).optional(),
+  // Streaming
+  activeIngressId: _zod.z.string().nullish(),
+  activeStreamUrl: _zod.z.string().nullish(),
+  streamTitle: _zod.z.string().nullish(),
+  streamImage: _zod.z.string().nullish(),
+  streamDescription: _zod.z.string().nullish(),
+  rtmpUrl: _zod.z.string().nullish(),
+  rtmpStreamKey: _zod.z.string().nullish(),
+  // Stream progress + podcast lifecycle (shared contract with the backend).
+  // `streamStartedAt` is an ISO timestamp; `streamDurationSec` is the current
+  // stream's total length in seconds when known (e.g. a podcast episode);
+  // `podcastQueue` holds the episodes queued behind the current one.
+  streamStartedAt: _zod.z.string().nullish(),
+  streamDurationSec: _zod.z.number().nullish(),
+  podcastQueue: _zod.z.array(ZPodcastQueueItem).nullish(),
+  // Recording
+  recordingEnabled: _zod.z.boolean().optional().default(true),
+  recordingEgressId: _zod.z.string().nullish(),
+  createdAt: _zod.z.string()
+}).passthrough();
+// --- Room Participant ---
+
+const ZRoomParticipant = exports.ZRoomParticipant = _zod.z.object({
+  userId: _zod.z.string(),
+  role: _zod.z.enum(['host', 'speaker', 'listener']),
+  isMuted: _zod.z.boolean(),
+  joinedAt: _zod.z.string()
+}).passthrough();
+// --- House ---
+
+const ZHouseMember = exports.ZHouseMember = _zod.z.object({
+  userId: _zod.z.string(),
+  role: _zod.z.enum(['owner', 'admin', 'host', 'member']),
+  joinedAt: _zod.z.string()
+}).passthrough();
+const ZHouse = exports.ZHouse = _zod.z.object({
+  _id: _zod.z.string(),
+  id: _zod.z.string().optional(),
+  name: _zod.z.string(),
+  description: _zod.z.string().optional(),
+  avatar: _zod.z.string().optional().nullable(),
+  coverImage: _zod.z.string().optional().nullable(),
+  members: _zod.z.array(ZHouseMember).default([]),
+  createdBy: _zod.z.string(),
+  isPublic: _zod.z.boolean().default(true),
+  tags: _zod.z.array(_zod.z.string()).optional(),
+  createdAt: _zod.z.string()
+}).passthrough();
+// --- Series ---
+
+const ZRecurrence = exports.ZRecurrence = _zod.z.object({
+  type: _zod.z.enum(['daily', 'weekly', 'biweekly', 'monthly']),
+  dayOfWeek: _zod.z.number().min(0).max(6).optional(),
+  dayOfMonth: _zod.z.number().min(1).max(31).optional(),
+  time: _zod.z.string().regex(/^\d{2}:\d{2}$/),
+  timezone: _zod.z.string().default('UTC')
+}).passthrough();
+const ZRoomTemplate = exports.ZRoomTemplate = _zod.z.object({
+  titlePattern: _zod.z.string(),
+  type: _zod.z.enum(['talk', 'stage', 'broadcast']).default('talk'),
+  description: _zod.z.string().optional(),
+  maxParticipants: _zod.z.number().default(100),
+  speakerPermission: _zod.z.enum(['everyone', 'followers', 'invited']).default('invited'),
+  tags: _zod.z.array(_zod.z.string()).optional()
+}).passthrough();
+const ZSeriesEpisode = exports.ZSeriesEpisode = _zod.z.object({
+  roomId: _zod.z.string(),
+  scheduledStart: _zod.z.string(),
+  episodeNumber: _zod.z.number()
+}).passthrough();
+const ZSeries = exports.ZSeries = _zod.z.object({
+  _id: _zod.z.string(),
+  id: _zod.z.string().optional(),
+  title: _zod.z.string(),
+  description: _zod.z.string().optional(),
+  coverImage: _zod.z.string().optional().nullable(),
+  houseId: _zod.z.string().optional().nullable(),
+  createdBy: _zod.z.string(),
+  recurrence: ZRecurrence,
+  roomTemplate: ZRoomTemplate,
+  episodes: _zod.z.array(ZSeriesEpisode).default([]),
+  nextEpisodeNumber: _zod.z.number().default(1),
+  isActive: _zod.z.boolean().default(true),
+  createdAt: _zod.z.string()
+}).passthrough();
+// --- Recording ---
+
+const ZRecording = exports.ZRecording = _zod.z.object({
+  _id: _zod.z.string(),
+  roomId: _zod.z.string(),
+  roomTitle: _zod.z.string(),
+  host: _zod.z.string(),
+  status: _zod.z.enum(['recording', 'processing', 'ready', 'failed', 'deleted']),
+  egressId: _zod.z.string(),
+  objectKey: _zod.z.string(),
+  fileSize: _zod.z.number().nullish(),
+  durationMs: _zod.z.number().nullish(),
+  startedAt: _zod.z.string(),
+  stoppedAt: _zod.z.string().nullish(),
+  access: _zod.z.enum(['public', 'participants']).default('public'),
+  participantIds: _zod.z.array(_zod.z.string()).default([]),
+  expiresAt: _zod.z.string(),
+  createdAt: _zod.z.string()
+}).passthrough();
+// --- Stream responses ---
+
+const ZStartStreamResponse = exports.ZStartStreamResponse = _zod.z.object({
+  ingressId: _zod.z.string(),
+  url: _zod.z.string()
+}).passthrough();
+const ZGenerateStreamKeyResponse = exports.ZGenerateStreamKeyResponse = _zod.z.object({
+  rtmpUrl: _zod.z.string(),
+  streamKey: _zod.z.string()
+}).passthrough();
+const ZStreamInfo = exports.ZStreamInfo = _zod.z.object({
+  title: _zod.z.string().optional(),
+  image: _zod.z.string().optional(),
+  description: _zod.z.string().optional()
+}).passthrough();
+// --- Room attachment for posts ---
+
+const ZRoomAttachment = exports.ZRoomAttachment = _zod.z.object({
+  roomId: _zod.z.string(),
+  title: _zod.z.string(),
+  status: _zod.z.enum(['scheduled', 'live', 'ended']).optional(),
+  type: _zod.z.enum(['talk', 'stage', 'broadcast']).optional(),
+  topic: _zod.z.string().optional(),
+  host: _zod.z.string().optional()
+}).passthrough();
+// --- Validators ---
+
+function validateRoom(data) {
+  const result = ZRoom.safeParse(data);
+  if (result.success) return result.data;
+  console.warn('[live] Invalid Room:', result.error.issues[0]);
+  return null;
+}
+function validateRooms(items) {
+  if (!Array.isArray(items)) return [];
+  const valid = [];
+  for (const item of items) {
+    const parsed = ZRoom.safeParse(item);
+    if (parsed.success) {
+      valid.push(parsed.data);
+    } else {
+      console.warn('[live] Dropping invalid room:', parsed.error.issues[0]);
+    }
+  }
+  return valid;
+}
+function validateHouse(data) {
+  const result = ZHouse.safeParse(data);
+  if (result.success) return result.data;
+  console.warn('[live] Invalid House:', result.error.issues[0]);
+  return null;
+}
+function validateRecording(data) {
+  const result = ZRecording.safeParse(data);
+  if (result.success) return result.data;
+  console.warn('[live] Invalid Recording:', result.error.issues[0]);
+  return null;
+}
+function validateRecordings(items) {
+  if (!Array.isArray(items)) return [];
+  const valid = [];
+  for (const item of items) {
+    const parsed = ZRecording.safeParse(item);
+    if (parsed.success) valid.push(parsed.data);
+  }
+  return valid;
+}
+function validateSeries(data) {
+  const result = ZSeries.safeParse(data);
+  if (result.success) return result.data;
+  console.warn('[live] Invalid Series:', result.error.issues[0]);
+  return null;
+}
+//# sourceMappingURL=validation.js.map

package/lib/commonjs/live/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_zod","require","ZPodcastQueueItem","exports","z","object","syraPodcastId","string","optional","episodeId","passthrough","ZRoom","_id","id","title","description","nullish","ownerType","enum","default","host","houseId","nullable","createdByAdmin","type","broadcastKind","status","scheduledStart","startedAt","endedAt","speakerPermission","participants","array","speakers","maxParticipants","number","topic","tags","archived","boolean","seriesId","stats","peakListeners","totalJoined","activeIngressId","activeStreamUrl","streamTitle","streamImage","streamDescription","rtmpUrl","rtmpStreamKey","streamStartedAt","streamDurationSec","podcastQueue","recordingEnabled","recordingEgressId","createdAt","ZRoomParticipant","userId","role","isMuted","joinedAt","ZHouseMember","ZHouse","name","avatar","coverImage","members","createdBy","isPublic","ZRecurrence","dayOfWeek","min","max","dayOfMonth","time","regex","timezone","ZRoomTemplate","titlePattern","ZSeriesEpisode","roomId","episodeNumber","ZSeries","recurrence","roomTemplate","episodes","nextEpisodeNumber","isActive","ZRecording","roomTitle","egressId","objectKey","fileSize","durationMs","stoppedAt","access","participantIds","expiresAt","ZStartStreamResponse","ingressId","url","ZGenerateStreamKeyResponse","streamKey","ZStreamInfo","image","ZRoomAttachment","validateRoom","data","result","safeParse","success","console","warn","error","issues","validateRooms","items","Array","isArray","valid","item","parsed","push","validateHouse","validateRecording","validateRecordings","validateSeries"],"sourceRoot":"../../../src","sources":["live/validation.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/lib/commonjs/schema.js

@@ -0,0 +1,102 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.trackSummarySchema = exports.podcastSummarySchema = exports.episodeSummarySchema = exports.coverArtVariantSchema = exports.coverArtSizesSchema = void 0;
+var _zod = require("zod");
+/**
+ * Minimal, self-contained schemas for the public Syra API response shapes this
+ * SDK consumes. Intentionally NOT shared with the Syra backend's internal
+ * types — the SDK validates only the fields it returns, and tolerantly strips
+ * everything else (Zod object schemas drop unknown keys by default), so the API
+ * can evolve without breaking external consumers.
+ */
+
+/** A single artwork variant. The backend serializes `url` as `/api/images/:id`. */
+const coverArtVariantSchema = exports.coverArtVariantSchema = _zod.z.object({
+  id: _zod.z.string().optional(),
+  url: _zod.z.string(),
+  width: _zod.z.number().optional(),
+  height: _zod.z.number().optional()
+});
+/** Named artwork variants keyed by size. */
+const coverArtSizesSchema = exports.coverArtSizesSchema = _zod.z.object({
+  small: coverArtVariantSchema.optional(),
+  medium: coverArtVariantSchema.optional(),
+  large: coverArtVariantSchema.optional(),
+  xlarge: coverArtVariantSchema.optional(),
+  xxlarge: coverArtVariantSchema.optional(),
+  original: coverArtVariantSchema.optional()
+});
+
+/** Artwork size name. */
+
+/**
+ * The summary view of a track returned by the public catalog endpoints — just
+ * enough to render a song row and play its preview.
+ */
+const trackSummarySchema = exports.trackSummarySchema = _zod.z.object({
+  id: _zod.z.string(),
+  title: _zod.z.string(),
+  artistId: _zod.z.string().optional(),
+  artistName: _zod.z.string(),
+  albumId: _zod.z.string().optional(),
+  albumName: _zod.z.string().optional(),
+  duration: _zod.z.number(),
+  coverArt: _zod.z.string().optional(),
+  coverArtSizes: coverArtSizesSchema.optional(),
+  previewAvailable: _zod.z.boolean().optional()
+});
+/**
+ * The summary view of a podcast SHOW returned by the public podcast endpoints
+ * (`GET /api/podcasts/search`, `GET /api/podcasts/:id`) — just enough to render
+ * a show card and deep-link into the Syra app.
+ *
+ * Artwork mirrors tracks: `image` is the re-hosted Syra image id (resolved via
+ * `/api/images/:id`); `imageSizes` is the multi-resolution variant set (each
+ * variant `url` is `/api/images/:id`); `imageSourceUrl` keeps the original
+ * external artwork URL as an absolute fallback when re-hosting has not run yet.
+ */
+const podcastSummarySchema = exports.podcastSummarySchema = _zod.z.object({
+  id: _zod.z.string(),
+  title: _zod.z.string(),
+  author: _zod.z.string().optional(),
+  description: _zod.z.string().optional(),
+  image: _zod.z.string().optional(),
+  imageSizes: coverArtSizesSchema.optional(),
+  imageSourceUrl: _zod.z.string().optional()
+});
+/**
+ * The summary view of a podcast EPISODE returned by the public podcast endpoints
+ * (`GET /api/podcasts/:id/episodes`, `GET /api/episodes/:id`) — just enough to
+ * list an episode and stream its audio.
+ *
+ * `enclosureUrl` is the direct audio file URL (e.g.
+ * `https://api.fastcast.ai/audio/<guid>.mp3`) and is REQUIRED: an episode with
+ * no enclosure is unplayable, so a row missing it is treated as malformed and
+ * dropped rather than surfaced as a dead entry. `enclosureType` /
+ * `enclosureLength` describe that file (MIME type and byte length); `duration`
+ * is the runtime in seconds and `pubDate` the ISO publish timestamp.
+ *
+ * Artwork mirrors the podcast SHOW: `image` is the re-hosted Syra image id
+ * (resolved via `/api/images/:id`); `imageSizes` is the multi-resolution variant
+ * set (each variant `url` is `/api/images/:id`); `imageSourceUrl` keeps the
+ * original external artwork URL as an absolute fallback when re-hosting has not
+ * run yet.
+ */
+const episodeSummarySchema = exports.episodeSummarySchema = _zod.z.object({
+  id: _zod.z.string(),
+  podcastId: _zod.z.string(),
+  title: _zod.z.string(),
+  description: _zod.z.string().optional(),
+  enclosureUrl: _zod.z.string(),
+  enclosureType: _zod.z.string().optional(),
+  enclosureLength: _zod.z.number().optional(),
+  duration: _zod.z.number().optional(),
+  pubDate: _zod.z.string().optional(),
+  image: _zod.z.string().optional(),
+  imageSizes: coverArtSizesSchema.optional(),
+  imageSourceUrl: _zod.z.string().optional()
+});
+//# sourceMappingURL=schema.js.map

package/lib/commonjs/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_zod","require","coverArtVariantSchema","exports","z","object","id","string","optional","url","width","number","height","coverArtSizesSchema","small","medium","large","xlarge","xxlarge","original","trackSummarySchema","title","artistId","artistName","albumId","albumName","duration","coverArt","coverArtSizes","previewAvailable","boolean","podcastSummarySchema","author","description","image","imageSizes","imageSourceUrl","episodeSummarySchema","podcastId","enclosureUrl","enclosureType","enclosureLength","pubDate"],"sourceRoot":"../../src","sources":["schema.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/client.js

@@ -0,0 +1,264 @@
+"use strict";
+
+import { trackSummarySchema, podcastSummarySchema, episodeSummarySchema } from "./schema.js";
+import { SyraApiError } from "./errors.js";
+
+/** Default base URL of the public Syra API. */
+export const DEFAULT_SYRA_BASE_URL = 'https://api.syra.fm';
+
+/** Default base URL of the Syra web app, used for deep links. */
+export const DEFAULT_SYRA_WEB_BASE_URL = 'https://syra.fm';
+
+/**
+ * One page of paginated catalog search results.
+ *
+ * `hasMore` reflects the BACKEND's pagination over the full matching set — NOT
+ * `items.length`. {@link SyraClient.searchTracks} additionally filters its page
+ * client-side to preview-available tracks, so `items.length` can be smaller than
+ * `limit` while `hasMore` is still `true`; callers must paginate by advancing
+ * `offset` by `limit` (the page size), never by `items.length`.
+ */
+
+/** Minimal shape from which track artwork URLs can be derived. */
+
+/** Minimal shape from which podcast-show artwork URLs can be derived. */
+
+/** Minimal shape from which podcast-episode artwork URLs can be derived. */
+
+/** Order used to pick the best available artwork variant when none is named. */
+const ARTWORK_FALLBACK_ORDER = ['original', 'xxlarge', 'xlarge', 'large', 'medium', 'small'];
+const OBJECT_ID_PATTERN = /^[a-f\d]{24}$/i;
+
+/**
+ * Default episode page size, matching the backend's own default so the SDK's
+ * offset→page translation lines up with the server's pagination window.
+ */
+const DEFAULT_EPISODES_PAGE_SIZE = 20;
+
+/** Read a finite number from an unknown response field, else a fallback. */
+function numberOr(value, fallback) {
+  return typeof value === 'number' && Number.isFinite(value) ? value : fallback;
+}
+/**
+ * Create a headless client for the public Syra API. Public reads only — there
+ * is no authentication in this version.
+ */
+export function createSyraClient(options = {}) {
+  const baseURL = (options.baseURL ?? DEFAULT_SYRA_BASE_URL).replace(/\/+$/, '');
+  const webBaseURL = (options.webBaseURL ?? DEFAULT_SYRA_WEB_BASE_URL).replace(/\/+$/, '');
+  function resolveFetch() {
+    if (options.fetch) {
+      return options.fetch;
+    }
+    const globalFetch = globalThis.fetch;
+    if (typeof globalFetch === 'function') {
+      return globalFetch.bind(globalThis);
+    }
+    throw new Error('@syra.fm/sdk: no global fetch is available. Pass `fetch` in createSyraClient options, ' + 'or run on Node 18+, a browser, or React Native.');
+  }
+  async function getJson(path) {
+    const doFetch = resolveFetch();
+    const response = await doFetch(`${baseURL}${path}`, {
+      headers: {
+        Accept: 'application/json'
+      }
+    });
+    if (!response.ok) {
+      throw new SyraApiError(response.status, `Syra API request failed: ${response.status} ${response.statusText} (${path})`);
+    }
+    return response.json();
+  }
+  function resolveImageRef(ref) {
+    if (!ref) {
+      return undefined;
+    }
+    if (/^https?:\/\//i.test(ref)) {
+      return ref;
+    }
+    if (ref.startsWith('/api/images/')) {
+      return `${baseURL}${ref}`;
+    }
+    if (OBJECT_ID_PATTERN.test(ref)) {
+      return `${baseURL}/api/images/${ref}`;
+    }
+    return undefined;
+  }
+  return {
+    async searchTracks(query, searchOptions = {}) {
+      const params = new URLSearchParams({
+        q: query,
+        category: 'tracks'
+      });
+      if (typeof searchOptions.limit === 'number') {
+        params.set('limit', String(searchOptions.limit));
+      }
+      if (typeof searchOptions.offset === 'number') {
+        params.set('offset', String(searchOptions.offset));
+      }
+      const json = await getJson(`/api/search?${params.toString()}`);
+      const rawTracks = Array.isArray(json?.results?.tracks) ? json.results.tracks : [];
+      const items = [];
+      for (const raw of rawTracks) {
+        // A single malformed catalog row must not fail the whole search.
+        const parsed = trackSummarySchema.safeParse(raw);
+        if (parsed.success && parsed.data.previewAvailable === true) {
+          items.push(parsed.data);
+        }
+      }
+      return {
+        items,
+        // `hasMore` is sourced from the backend's pagination over the FULL result
+        // set; the client-side preview filter above may shrink `items` below
+        // `limit`, but must NOT corrupt `hasMore` (else a page whose tail was
+        // filtered out would falsely report the end of the catalog).
+        hasMore: json?.hasMore === true,
+        limit: numberOr(json?.limit, searchOptions.limit ?? rawTracks.length),
+        offset: numberOr(json?.offset, searchOptions.offset ?? 0)
+      };
+    },
+    async getTrack(id) {
+      const json = await getJson(`/api/tracks/${encodeURIComponent(id)}`);
+      return trackSummarySchema.parse(json);
+    },
+    previewUrl(id, startSec = 0) {
+      const safeStart = Number.isFinite(startSec) ? Math.max(0, Math.trunc(startSec)) : 0;
+      return `${baseURL}/api/preview/${encodeURIComponent(id)}.mp3?start=${safeStart}`;
+    },
+    artworkUrl(source, size) {
+      if (typeof source === 'string') {
+        return resolveImageRef(source);
+      }
+      if (size && source.coverArtSizes) {
+        const resolved = resolveImageRef(source.coverArtSizes[size]?.url);
+        if (resolved) {
+          return resolved;
+        }
+      }
+      const fromCoverArt = resolveImageRef(source.coverArt);
+      if (fromCoverArt) {
+        return fromCoverArt;
+      }
+      if (source.coverArtSizes) {
+        for (const key of ARTWORK_FALLBACK_ORDER) {
+          const resolved = resolveImageRef(source.coverArtSizes[key]?.url);
+          if (resolved) {
+            return resolved;
+          }
+        }
+      }
+      return undefined;
+    },
+    async searchPodcasts(query, searchOptions = {}) {
+      const params = new URLSearchParams({
+        q: query
+      });
+      if (typeof searchOptions.limit === 'number') {
+        params.set('limit', String(searchOptions.limit));
+      }
+      if (typeof searchOptions.offset === 'number') {
+        params.set('offset', String(searchOptions.offset));
+      }
+      const json = await getJson(`/api/podcasts/search?${params.toString()}`);
+      const rawPodcasts = Array.isArray(json?.data) ? json.data : [];
+      const items = [];
+      for (const raw of rawPodcasts) {
+        // A single malformed catalog row must not fail the whole search.
+        const parsed = podcastSummarySchema.safeParse(raw);
+        if (parsed.success) {
+          items.push(parsed.data);
+        }
+      }
+      return {
+        items,
+        // `hasMore` reflects the backend's pagination over the full result set.
+        hasMore: json?.hasMore === true,
+        limit: numberOr(json?.limit, searchOptions.limit ?? rawPodcasts.length),
+        offset: numberOr(json?.offset, searchOptions.offset ?? 0)
+      };
+    },
+    async getPodcast(id) {
+      const json = await getJson(`/api/podcasts/${encodeURIComponent(id)}`);
+      return podcastSummarySchema.parse(json?.data?.podcast);
+    },
+    podcastUrl(id) {
+      return `${webBaseURL}/podcasts/${encodeURIComponent(id)}`;
+    },
+    podcastArtworkUrl(source, size) {
+      if (size && source.imageSizes) {
+        const resolved = resolveImageRef(source.imageSizes[size]?.url);
+        if (resolved) {
+          return resolved;
+        }
+      }
+      const fromImage = resolveImageRef(source.image);
+      if (fromImage) {
+        return fromImage;
+      }
+      if (source.imageSizes) {
+        for (const key of ARTWORK_FALLBACK_ORDER) {
+          const resolved = resolveImageRef(source.imageSizes[key]?.url);
+          if (resolved) {
+            return resolved;
+          }
+        }
+      }
+      return resolveImageRef(source.imageSourceUrl);
+    },
+    async getPodcastEpisodes(podcastId, listOptions = {}) {
+      // The endpoint paginates by 1-based `page`; translate the SDK's uniform
+      // offset-based paging into it. `limit` must be concrete (unlike search,
+      // which can omit it) because the page number is derived from it.
+      const limit = listOptions.limit ?? DEFAULT_EPISODES_PAGE_SIZE;
+      const offset = listOptions.offset ?? 0;
+      const page = Math.floor(offset / limit) + 1;
+      const json = await getJson(`/api/podcasts/${encodeURIComponent(podcastId)}/episodes?page=${page}&limit=${limit}`);
+      const rawEpisodes = Array.isArray(json?.data) ? json.data : [];
+      const items = [];
+      for (const raw of rawEpisodes) {
+        // A single malformed episode row must not fail the whole listing.
+        const parsed = episodeSummarySchema.safeParse(raw);
+        if (parsed.success) {
+          items.push(parsed.data);
+        }
+      }
+
+      // `total` is the backend's full count over the show; derive `hasMore` from
+      // it rather than `items.length`, which the schema/enclosure filter above may
+      // shrink below `limit` on a page that is NOT the last one. Absent a count,
+      // fall back to what we have (this page ends the listing).
+      const total = numberOr(json?.total, offset + items.length);
+      return {
+        items,
+        hasMore: page * limit < total,
+        limit,
+        offset
+      };
+    },
+    async getEpisode(episodeId) {
+      const json = await getJson(`/api/episodes/${encodeURIComponent(episodeId)}`);
+      return episodeSummarySchema.parse(json?.data?.episode);
+    },
+    episodeImageUrl(source, size) {
+      if (size && source.imageSizes) {
+        const resolved = resolveImageRef(source.imageSizes[size]?.url);
+        if (resolved) {
+          return resolved;
+        }
+      }
+      const fromImage = resolveImageRef(source.image);
+      if (fromImage) {
+        return fromImage;
+      }
+      if (source.imageSizes) {
+        for (const key of ARTWORK_FALLBACK_ORDER) {
+          const resolved = resolveImageRef(source.imageSizes[key]?.url);
+          if (resolved) {
+            return resolved;
+          }
+        }
+      }
+      return resolveImageRef(source.imageSourceUrl);
+    }
+  };
+}
+//# sourceMappingURL=client.js.map