@supadata/js 1.0.4 → 1.0.6

package/README.md

@@ -17,12 +17,15 @@ npm install @supadata/js
 
 ```typescript
 import {
-  Supadata,
-  Transcript,
-  Scrape,
-  Map,
   Crawl,
   CrawlJob,
+  Map,
+  Scrape,
+  Supadata,
+  Transcript,
+  YoutubeChannel,
+  YoutubePlaylist,
+  YoutubeVideo,
 } from '@supadata/js';
 
 // Initialize the client
@@ -41,6 +44,34 @@ const translated: Transcript = await supadata.youtube.translate({
   lang: 'es',
 });
 
+// Get a YouTube Video metadata
+const video: YoutubeVideo = await supadata.youtube.video({
+  id: 'dQw4w9WgXcQ', // can be url or video id
+});
+
+// Get a YouTube channel metadata
+const channel: YoutubeChannel = await supadata.youtube.channel({
+  id: 'https://youtube.com/@RickAstleyVEVO', // can be url, channel id, handle
+});
+
+// Get a list of video IDs from a YouTube channel
+const channelVideos: VideoIds = await supadata.youtube.channel.videos({
+  id: 'https://youtube.com/@RickAstleyVEVO', // can be url, channel id, handle
+  type: 'all', // 'video', 'short', 'all'
+  limit: 10,
+});
+
+// Get the metadata of a YouTube playlist
+const playlist: YoutubePlaylist = await supadata.youtube.playlist({
+  id: 'PLFgquLnL59alCl_2TQvOiD5Vgm1hCaGSI', // can be url or playlist id
+});
+
+// Get a list of video IDs from a YouTube playlist
+const playlistVideos: VideoIds = await supadata.youtube.playlist.videos({
+  id: 'https://www.youtube.com/playlist?list=PLlaN88a7y2_plecYoJxvRFTLHVbIVAOoc', // can be url or playlist id
+  limit: 10,
+});
+
 // Scrape web content
 const webContent: Scrape = await supadata.web.scrape('https://supadata.ai');
 

package/dist/index.cjs

@@ -1,3 +1,3 @@
-'use strict';var a=class extends Error{error;details;documentationUrl;constructor(e){super(e.message||"An unexpected error occurred"),this.error=e.error||"internal-error",this.details=e.details||"An unexpected error occurred",this.documentationUrl=e.documentationUrl||"",this.name="SupadataError";}};var d={403:{error:"invalid-request",message:"Invalid or missing API key",details:"Please ensure you have provided a valid API key"},404:{error:"invalid-request",message:"Endpoint does not exist",details:"The API endpoint you are trying to access does not exist"},429:{error:"limit-exceeded",message:"Limit exceeded",details:"You have exceeded the allowed request rate or quota limits"}},f=(n,e)=>n in d?new a({...d[n],message:d[n].message,details:e||d[n].details}):new a({error:"internal-error",message:"An unexpected error occurred",details:e});var c=class{config;constructor(e){this.config=e;}async fetch(e,r={},s="GET"){let t=`${this.config.baseUrl||"https://api.supadata.ai/v1"}${e.startsWith("/")?e:`/${e}`}`;if(s==="GET"&&Object.keys(r).length>0){let p=new URLSearchParams;Object.entries(r).forEach(([o,m])=>{m!=null&&p.append(o,String(m));}),t+=`?${p.toString()}`;}return this.fetchUrl(t,s,r)}async fetchUrl(e,r="GET",s){let i={method:r,headers:{"x-api-key":this.config.apiKey,"Content-Type":"application/json"}};r==="POST"&&s&&(i.body=JSON.stringify(s));let t=await fetch(e,i),p=t.headers.get("content-type");if(!t.ok){if([403,404,429].includes(t.status)){let o=await t.json();throw f(t.status,o.message)}if(p?.includes("application/json")){let o=await t.json();throw new a(o)}else throw new a({error:"internal-error",message:"Unexpected error response format",details:await t.text()})}try{if(!p?.includes("application/json"))throw new a({error:"internal-error",message:"Invalid response format",details:"Expected JSON response but received different content type"});return await t.json()}catch(o){throw new a({error:"internal-error",message:"Failed to parse response",details:o instanceof Error?o.message:"Unknown error"})}}};var u=class extends c{async transcript(e){return this.fetch("/youtube/transcript",e)}async translate(e){return this.fetch("/youtube/transcript/translate",e)}};var g=class extends c{async scrape(e){return this.fetch("/web/scrape",{url:e})}async map(e){return this.fetch("/web/map",{url:e})}async crawl(e){return this.fetch("/web/crawl",e,"POST")}async getCrawlResults(e){let r,s=[],i;do r=await(i?this.fetchUrl(i):this.fetch(`/web/crawl/${e}`)),r.pages&&(s=[...s,...r.pages]),i=r.next;while(i);return r}};var T=class{youtube;web;constructor(e){this.youtube=new u(e),this.web=new g(e);}};
-exports.BaseClient=c;exports.Supadata=T;exports.SupadataError=a;exports.WebService=g;exports.YouTubeService=u;//# sourceMappingURL=index.cjs.map
+'use strict';var t=class extends Error{error;details;documentationUrl;constructor(e){super(e.message||"An unexpected error occurred"),this.error=e.error||"internal-error",this.details=e.details||"An unexpected error occurred",this.documentationUrl=e.documentationUrl||"",this.name="SupadataError";}};var d={403:{error:"invalid-request",message:"Invalid or missing API key",details:"Please ensure you have provided a valid API key"},404:{error:"invalid-request",message:"Endpoint does not exist",details:"The API endpoint you are trying to access does not exist"},429:{error:"limit-exceeded",message:"Limit exceeded",details:"You have exceeded the allowed request rate or quota limits"}},f=(n,e)=>n in d?new t({...d[n],message:d[n].message,details:e||d[n].details}):new t({error:"internal-error",message:"An unexpected error occurred",details:e});var c=class{config;constructor(e){this.config=e;}async fetch(e,r={},s="GET"){let i=`${this.config.baseUrl||"https://api.supadata.ai/v1"}${e.startsWith("/")?e:`/${e}`}`;if(s==="GET"&&Object.keys(r).length>0){let l=new URLSearchParams;Object.entries(r).forEach(([o,g])=>{g!=null&&l.append(o,String(g));}),i+=`?${l.toString()}`;}return this.fetchUrl(i,s,r)}async fetchUrl(e,r="GET",s){let a={method:r,headers:{"x-api-key":this.config.apiKey,"Content-Type":"application/json"}};r==="POST"&&s&&(a.body=JSON.stringify(s));let i=await fetch(e,a),l=i.headers.get("content-type");if(!i.ok){if([403,404,429].includes(i.status)){let o=await i.json();throw f(i.status,o.message)}if(l?.includes("application/json")){let o=await i.json();throw new t(o)}else throw new t({error:"internal-error",message:"Unexpected error response format",details:await i.text()})}try{if(!l?.includes("application/json"))throw new t({error:"internal-error",message:"Invalid response format",details:"Expected JSON response but received different content type"});return await i.json()}catch(o){throw new t({error:"internal-error",message:"Failed to parse response",details:o instanceof Error?o.message:"Unknown error"})}}};var p=class extends c{async transcript(e){return this.fetch("/youtube/transcript",e)}async translate(e){return this.fetch("/youtube/transcript/translate",e)}async video(e){return this.fetch("/youtube/video",e)}channel=Object.assign(async e=>this.fetch("/youtube/channel",e),{videos:async e=>(this.validateLimit(e),this.fetch("/youtube/channel/videos",e))});playlist=Object.assign(async e=>this.fetch("/youtube/playlist",e),{videos:async e=>(this.validateLimit(e),this.fetch("/youtube/playlist/videos",e))});validateLimit(e){if(e.limit!=null&&e.limit!=null&&(e.limit<1||e.limit>5e3))throw new t({error:"invalid-request",message:"Invalid limit.",details:"The limit must be between 1 and 5000."})}};var m=class extends c{async scrape(e){return this.fetch("/web/scrape",{url:e})}async map(e){return this.fetch("/web/map",{url:e})}async crawl(e){return this.fetch("/web/crawl",e,"POST")}async getCrawlResults(e){let r,s=[],a;do r=await(a?this.fetchUrl(a):this.fetch(`/web/crawl/${e}`)),r.pages&&(s=[...s,...r.pages]),a=r.next;while(a);return r}};var h=class{youtube;web;constructor(e){this.youtube=new p(e),this.web=new m(e);}};
+exports.BaseClient=c;exports.Supadata=h;exports.SupadataError=t;exports.WebService=m;exports.YouTubeService=p;//# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/types.ts","../src/gateway-error-mapper.ts","../src/client.ts","../src/services/youtube.ts","../src/services/web.ts","../src/index.ts"],"names":["SupadataError","error","GATEWAY_STATUS_ERRORS","mapGatewayError","statusCode","errorText","BaseClient","config","endpoint","params","method","url","queryParams","key","value","body","options","response","contentType","errorData","YouTubeService","WebService","request","jobId","pages","nextUrl","Supadata"],"mappings":"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","file":"index.cjs","sourcesContent":["export interface TranscriptChunk {\n  text: string;\n  offset: number;\n  duration: number;\n  lang: string;\n}\n\nexport interface Transcript {\n  content: TranscriptChunk[] | string;\n  lang: string;\n  availableLangs: string[];\n}\n\nexport interface TranslatedTranscript {\n  content: TranscriptChunk[] | string;\n  lang: string;\n}\n\nexport interface Scrape {\n  url: string;\n  content: string;\n  name: string;\n  description: string;\n  ogUrl: string;\n  countCharacters: number;\n  urls: string[];\n}\n\nexport interface Map {\n  urls: string[];\n}\n\nexport interface CrawlRequest {\n  url: string;\n  limit?: number;\n}\n\nexport interface Crawl {\n  jobId: string;\n}\n\nexport interface CrawlJob {\n  status: 'scraping' | 'completed' | 'failed' | 'cancelled';\n  pages?: Scrape[];\n  next?: string;\n}\n\nexport interface SupadataConfig {\n  apiKey: string;\n  baseUrl?: string;\n}\n\nexport class SupadataError extends Error {\n  error:\n    | 'invalid-request'\n    | 'missing-parameters'\n    | 'internal-error'\n    | 'transcript-unavailable'\n    | 'video-not-found'\n    | 'video-id-invalid'\n    | 'youtube-api-error'\n    | 'limit-exceeded';\n  details: string;\n  documentationUrl: string;\n\n  constructor(error: {\n    error: SupadataError['error'];\n    message?: string;\n    details?: string;\n    documentationUrl?: string;\n  }) {\n    super(error.message || 'An unexpected error occurred');\n    this.error = error.error || 'internal-error';\n    this.details = error.details || 'An unexpected error occurred';\n    this.documentationUrl = error.documentationUrl || '';\n    this.name = 'SupadataError';\n  }\n}\n","import { SupadataError } from './types';\n\n/*\nThe API gateway returns errors in text/plain content type. \nAs a temporary workaround we're mapping them to SupadataError.\n*/\n\nconst GATEWAY_STATUS_ERRORS = {\n  403: {\n    error: 'invalid-request' as const,\n    message: 'Invalid or missing API key',\n    details: 'Please ensure you have provided a valid API key',\n  },\n  404: {\n    error: 'invalid-request' as const,\n    message: 'Endpoint does not exist',\n    details: 'The API endpoint you are trying to access does not exist',\n  },\n  429: {\n    error: 'limit-exceeded' as const,\n    message: 'Limit exceeded',\n    details: 'You have exceeded the allowed request rate or quota limits',\n  },\n};\n\nexport const mapGatewayError = (\n  statusCode: number,\n  errorText: string\n): SupadataError => {\n  if (statusCode in GATEWAY_STATUS_ERRORS) {\n    return new SupadataError({\n      ...GATEWAY_STATUS_ERRORS[\n        statusCode as keyof typeof GATEWAY_STATUS_ERRORS\n      ],\n      message:\n        GATEWAY_STATUS_ERRORS[statusCode as keyof typeof GATEWAY_STATUS_ERRORS]\n          .message,\n      details:\n        errorText ||\n        GATEWAY_STATUS_ERRORS[statusCode as keyof typeof GATEWAY_STATUS_ERRORS]\n          .details,\n    });\n  }\n\n  // Default error if status code is not recognized\n  return new SupadataError({\n    error: 'internal-error',\n    message: 'An unexpected error occurred',\n    details: errorText,\n  });\n};\n","import { SupadataConfig, SupadataError } from './types.js';\nimport { mapGatewayError } from './gateway-error-mapper.js';\n\nexport class BaseClient {\n  protected config: SupadataConfig;\n\n  constructor(config: SupadataConfig) {\n    this.config = config;\n  }\n\n  protected async fetch<T>(\n    endpoint: string,\n    params: Record<string, any> = {},\n    method: 'GET' | 'POST' = 'GET'\n  ): Promise<T> {\n    const baseUrl = this.config.baseUrl || 'https://api.supadata.ai/v1';\n    let url = `${baseUrl}${\n      endpoint.startsWith('/') ? endpoint : `/${endpoint}`\n    }`;\n\n    if (method === 'GET' && Object.keys(params).length > 0) {\n      const queryParams = new URLSearchParams();\n      Object.entries(params).forEach(([key, value]) => {\n        if (value !== undefined && value !== null) {\n          queryParams.append(key, String(value));\n        }\n      });\n      url += `?${queryParams.toString()}`;\n    }\n\n    return this.fetchUrl<T>(url, method, params);\n  }\n\n  protected async fetchUrl<T>(\n    url: string,\n    method: 'GET' | 'POST' = 'GET',\n    body?: Record<string, any>\n  ): Promise<T> {\n    const options: RequestInit = {\n      method,\n      headers: {\n        'x-api-key': this.config.apiKey,\n        'Content-Type': 'application/json',\n      },\n    };\n\n    if (method === 'POST' && body) {\n      options.body = JSON.stringify(body);\n    }\n\n    const response = await fetch(url, options);\n\n    const contentType = response.headers.get('content-type');\n\n    if (!response.ok) {\n      // First check for gateway-specific status codes\n      if ([403, 404, 429].includes(response.status)) {\n        const errorData = await response.json();\n        throw mapGatewayError(response.status, errorData.message);\n      }\n\n      // Handle standard API errors\n      if (contentType?.includes('application/json')) {\n        const errorData = await response.json();\n        throw new SupadataError(errorData);\n      } else {\n        // Fallback for unexpected non-JSON errors\n        throw new SupadataError({\n          error: 'internal-error',\n          message: 'Unexpected error response format',\n          details: await response.text(),\n        });\n      }\n    }\n\n    try {\n      if (!contentType?.includes('application/json')) {\n        throw new SupadataError({\n          error: 'internal-error',\n          message: 'Invalid response format',\n          details: 'Expected JSON response but received different content type',\n        });\n      }\n\n      return (await response.json()) as T;\n    } catch (error) {\n      throw new SupadataError({\n        error: 'internal-error',\n        message: 'Failed to parse response',\n        details: error instanceof Error ? error.message : 'Unknown error',\n      });\n    }\n  }\n}\n","import { BaseClient } from '../client.js';\nimport { Transcript, TranslatedTranscript } from '../types.js';\n\n/**\n * Ensures exactly one property from the specified keys is provided.\n * @example\n * // Valid: { url: \"...\" } or { videoId: \"...\" }\n * // Invalid: {} or { url: \"...\", videoId: \"...\" }\n */\ntype ExactlyOne<T, Keys extends keyof T> = {\n  [K in Keys]: { [P in K]-?: T[P] } & { [P in Exclude<Keys, K>]?: never };\n}[Keys] &\n  Omit<T, Keys>;\n\nexport type TranscriptParams = {\n  lang?: string;\n  text?: boolean;\n} & ExactlyOne<{ videoId: string; url: string }, 'videoId' | 'url'>;\n\nexport interface TranslateParams extends Omit<TranscriptParams, 'lang'> {\n  lang: string;\n}\n\nexport class YouTubeService extends BaseClient {\n  /**\n   * Fetches a transcript for a YouTube video.\n   *\n   * @param params - Parameters for fetching the transcript\n   * @param params.videoId - The YouTube video ID (provide either this OR url)\n   * @param params.url - The YouTube video URL (provide either this OR videoId)\n   * @param params.lang - Optional language code for the transcript\n   * @param params.text - Optional flag to return plain text instead of timestamped list\n   * @returns A promise that resolves to the video transcript\n   */\n  async transcript(params: TranscriptParams): Promise<Transcript> {\n    return this.fetch<Transcript>('/youtube/transcript', params);\n  }\n\n  /**\n   * Translates a YouTube video transcript to a specified language.\n   *\n   * @param params - Parameters for translating the transcript\n   * @param params.videoId - The YouTube video ID (provide either this OR url)\n   * @param params.url - The YouTube video URL (provide either this OR videoId)\n   * @param params.lang - The target language code for translation\n   * @param params.text - Optional flag to return plain text instead of timestamped list\n   * @returns A promise that resolves to the translated transcript\n   */\n  async translate(params: TranslateParams): Promise<TranslatedTranscript> {\n    return this.fetch<TranslatedTranscript>(\n      '/youtube/transcript/translate',\n      params\n    );\n  }\n}\n","import { BaseClient } from '../client.js';\nimport { Scrape, Map, CrawlRequest, Crawl, CrawlJob } from '../types.js';\n\nexport class WebService extends BaseClient {\n  /**\n   * Extract content from any web page to Markdown format.\n   *\n   * @param url - URL of the webpage to scrape\n   * @returns A promise that resolves to the scraped content\n   */\n  async scrape(url: string): Promise<Scrape> {\n    return this.fetch<Scrape>('/web/scrape', { url });\n  }\n\n  /**\n   * Extract all links found on a webpage.\n   *\n   * @param url - URL of the webpage to map\n   * @returns A promise that resolves to a map of URLs found on the page\n   */\n  async map(url: string): Promise<Map> {\n    return this.fetch<Map>('/web/map', { url });\n  }\n\n  /**\n   * Create a crawl job to extract content from all pages on a website.\n   *\n   * @param request - Crawl request parameters\n   * @param request.url - URL of the website to crawl\n   * @param request.limit - Maximum number of pages to crawl (default: 100, max: 5000)\n   * @returns A promise that resolves to the crawl job id\n   */\n  async crawl(request: CrawlRequest): Promise<Crawl> {\n    return this.fetch<Crawl>('/web/crawl', request, 'POST');\n  }\n\n  /**\n   * Get the status and results of a crawl job.\n   * Automatically handles pagination to retrieve all pages from the crawl.\n   *\n   * @param jobId - The ID of the crawl job to retrieve\n   * @returns A promise that resolves to the complete crawl job results\n   */\n  async getCrawlResults(jobId: string): Promise<CrawlJob> {\n    let response: CrawlJob;\n    let pages: Scrape[] = [];\n    let nextUrl: string | undefined;\n\n    do {\n      response = await (nextUrl\n        ? this.fetchUrl<CrawlJob>(nextUrl)\n        : this.fetch<CrawlJob>(`/web/crawl/${jobId}`));\n\n      if (response.pages) {\n        pages = [...pages, ...response.pages];\n      }\n      nextUrl = response.next;\n    } while (nextUrl);\n\n    return response;\n  }\n}\n","import { SupadataConfig } from './types.js';\nimport { YouTubeService } from './services/youtube.js';\nimport { WebService } from './services/web.js';\n\nexport * from './types.js';\nexport * from './client.js';\nexport * from './services/youtube.js';\nexport * from './services/web.js';\n\nexport class Supadata {\n  readonly youtube: YouTubeService;\n  readonly web: WebService;\n\n  constructor(config: SupadataConfig) {\n    this.youtube = new YouTubeService(config);\n    this.web = new WebService(config);\n  }\n}\n"]}
+{"version":3,"sources":["../src/types.ts","../src/gateway-error-mapper.ts","../src/client.ts","../src/services/youtube.ts","../src/services/web.ts","../src/index.ts"],"names":["SupadataError","error","GATEWAY_STATUS_ERRORS","mapGatewayError","statusCode","errorText","BaseClient","config","endpoint","params","method","url","queryParams","key","value","body","options","response","contentType","errorData","YouTubeService","WebService","request","jobId","pages","nextUrl","Supadata"],"mappings":"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","file":"index.cjs","sourcesContent":["export interface TranscriptChunk {\n  text: string;\n  offset: number;\n  duration: number;\n  lang: string;\n}\n\nexport interface Transcript {\n  content: TranscriptChunk[] | string;\n  lang: string;\n  availableLangs: string[];\n}\n\nexport interface TranslatedTranscript {\n  content: TranscriptChunk[] | string;\n  lang: string;\n}\n\nexport interface Scrape {\n  url: string;\n  content: string;\n  name: string;\n  description: string;\n  ogUrl: string;\n  countCharacters: number;\n  urls: string[];\n}\n\nexport interface SiteMap {\n  urls: string[];\n}\n\nexport interface CrawlRequest {\n  url: string;\n  limit?: number;\n}\n\nexport interface Crawl {\n  jobId: string;\n}\n\nexport interface CrawlJob {\n  status: 'scraping' | 'completed' | 'failed' | 'cancelled';\n  pages?: Scrape[];\n  next?: string;\n}\n\nexport interface SupadataConfig {\n  apiKey: string;\n  baseUrl?: string;\n}\n\nexport class SupadataError extends Error {\n  error:\n    | 'invalid-request'\n    | 'missing-parameters'\n    | 'internal-error'\n    | 'transcript-unavailable'\n    | 'video-not-found'\n    | 'video-id-invalid'\n    | 'youtube-api-error'\n    | 'limit-exceeded';\n  details: string;\n  documentationUrl: string;\n\n  constructor(error: {\n    error: SupadataError['error'];\n    message?: string;\n    details?: string;\n    documentationUrl?: string;\n  }) {\n    super(error.message || 'An unexpected error occurred');\n    this.error = error.error || 'internal-error';\n    this.details = error.details || 'An unexpected error occurred';\n    this.documentationUrl = error.documentationUrl || '';\n    this.name = 'SupadataError';\n  }\n}\n\nexport interface YoutubeVideo {\n  id: string;\n  title: string;\n  description: string;\n  duration: number;\n  channel: {\n    id: string;\n    name: string;\n  };\n  tags: string[];\n  thumbnail: string;\n  uploadDate: string;\n  viewCount: number;\n  likeCount: number;\n  transcriptLanguages: string[];\n}\n\nexport interface YoutubeChannel {\n  id: string;\n  name: string;\n  handle: string;\n  description: string;\n  subscriberCount: number;\n  videoCount: number;\n  thumbnail: string;\n  banner: string;\n}\n\nexport interface YoutubePlaylist {\n  id: string;\n  title: string;\n  videoCount: number;\n  viewCount: number;\n  lastUpdated: string;\n  description: string;\n  thumbnail: string;\n}\n","import { SupadataError } from './types';\n\n/*\nThe API gateway returns errors in text/plain content type. \nAs a temporary workaround we're mapping them to SupadataError.\n*/\n\nconst GATEWAY_STATUS_ERRORS = {\n  403: {\n    error: 'invalid-request' as const,\n    message: 'Invalid or missing API key',\n    details: 'Please ensure you have provided a valid API key',\n  },\n  404: {\n    error: 'invalid-request' as const,\n    message: 'Endpoint does not exist',\n    details: 'The API endpoint you are trying to access does not exist',\n  },\n  429: {\n    error: 'limit-exceeded' as const,\n    message: 'Limit exceeded',\n    details: 'You have exceeded the allowed request rate or quota limits',\n  },\n};\n\nexport const mapGatewayError = (\n  statusCode: number,\n  errorText: string\n): SupadataError => {\n  if (statusCode in GATEWAY_STATUS_ERRORS) {\n    return new SupadataError({\n      ...GATEWAY_STATUS_ERRORS[\n        statusCode as keyof typeof GATEWAY_STATUS_ERRORS\n      ],\n      message:\n        GATEWAY_STATUS_ERRORS[statusCode as keyof typeof GATEWAY_STATUS_ERRORS]\n          .message,\n      details:\n        errorText ||\n        GATEWAY_STATUS_ERRORS[statusCode as keyof typeof GATEWAY_STATUS_ERRORS]\n          .details,\n    });\n  }\n\n  // Default error if status code is not recognized\n  return new SupadataError({\n    error: 'internal-error',\n    message: 'An unexpected error occurred',\n    details: errorText,\n  });\n};\n","import { SupadataConfig, SupadataError } from './types.js';\nimport { mapGatewayError } from './gateway-error-mapper.js';\n\nexport class BaseClient {\n  protected config: SupadataConfig;\n\n  constructor(config: SupadataConfig) {\n    this.config = config;\n  }\n\n  protected async fetch<T>(\n    endpoint: string,\n    params: Record<string, any> = {},\n    method: 'GET' | 'POST' = 'GET'\n  ): Promise<T> {\n    const baseUrl = this.config.baseUrl || 'https://api.supadata.ai/v1';\n    let url = `${baseUrl}${\n      endpoint.startsWith('/') ? endpoint : `/${endpoint}`\n    }`;\n\n    if (method === 'GET' && Object.keys(params).length > 0) {\n      const queryParams = new URLSearchParams();\n      Object.entries(params).forEach(([key, value]) => {\n        if (value !== undefined && value !== null) {\n          queryParams.append(key, String(value));\n        }\n      });\n      url += `?${queryParams.toString()}`;\n    }\n\n    return this.fetchUrl<T>(url, method, params);\n  }\n\n  protected async fetchUrl<T>(\n    url: string,\n    method: 'GET' | 'POST' = 'GET',\n    body?: Record<string, any>\n  ): Promise<T> {\n    const options: RequestInit = {\n      method,\n      headers: {\n        'x-api-key': this.config.apiKey,\n        'Content-Type': 'application/json',\n      },\n    };\n\n    if (method === 'POST' && body) {\n      options.body = JSON.stringify(body);\n    }\n\n    const response = await fetch(url, options);\n\n    const contentType = response.headers.get('content-type');\n\n    if (!response.ok) {\n      // First check for gateway-specific status codes\n      if ([403, 404, 429].includes(response.status)) {\n        const errorData = await response.json();\n        throw mapGatewayError(response.status, errorData.message);\n      }\n\n      // Handle standard API errors\n      if (contentType?.includes('application/json')) {\n        const errorData = await response.json();\n        throw new SupadataError(errorData);\n      } else {\n        // Fallback for unexpected non-JSON errors\n        throw new SupadataError({\n          error: 'internal-error',\n          message: 'Unexpected error response format',\n          details: await response.text(),\n        });\n      }\n    }\n\n    try {\n      if (!contentType?.includes('application/json')) {\n        throw new SupadataError({\n          error: 'internal-error',\n          message: 'Invalid response format',\n          details: 'Expected JSON response but received different content type',\n        });\n      }\n\n      return (await response.json()) as T;\n    } catch (error) {\n      throw new SupadataError({\n        error: 'internal-error',\n        message: 'Failed to parse response',\n        details: error instanceof Error ? error.message : 'Unknown error',\n      });\n    }\n  }\n}\n","import { BaseClient } from '../client.js';\nimport {\n  SupadataError,\n  Transcript,\n  TranslatedTranscript,\n  YoutubeChannel,\n  YoutubePlaylist,\n  YoutubeVideo,\n} from '../types.js';\n\n/**\n * Ensures exactly one property from the specified keys is provided.\n * @example\n * // Valid: { url: \"...\" } or { videoId: \"...\" }\n * // Invalid: {} or { url: \"...\", videoId: \"...\" }\n */\ntype ExactlyOne<T, Keys extends keyof T> = {\n  [K in Keys]: { [P in K]-?: T[P] } & { [P in Exclude<Keys, K>]?: never };\n}[Keys] &\n  Omit<T, Keys>;\n\nexport type TranscriptParams = {\n  lang?: string;\n  text?: boolean;\n} & ExactlyOne<{ videoId: string; url: string }, 'videoId' | 'url'>;\n\nexport interface TranslateParams extends Omit<TranscriptParams, 'lang'> {\n  lang: string;\n}\n\nexport interface ResourceParams {\n  id: string;\n}\n\nexport interface ChannelVideosParams extends ResourceParams {\n  limit?: number;\n  type?: 'video' | 'short' | 'all';\n}\n\nexport interface PlaylistVideosParams extends ResourceParams {\n  limit?: number;\n}\n\nexport interface VideoIds {\n  videoIds: string[];\n  shortIds: string[];\n}\n\nexport class YouTubeService extends BaseClient {\n  /**\n   * Fetches a transcript for a YouTube video.\n   *\n   * @param params - Parameters for fetching the transcript\n   * @param params.videoId - The YouTube video ID (provide either this OR url)\n   * @param params.url - The YouTube video URL (provide either this OR videoId)\n   * @param params.lang - Optional language code for the transcript\n   * @param params.text - Optional flag to return plain text instead of timestamped list\n   * @returns A promise that resolves to the video transcript\n   */\n  async transcript(params: TranscriptParams): Promise<Transcript> {\n    return this.fetch<Transcript>('/youtube/transcript', params);\n  }\n\n  /**\n   * Translates a YouTube video transcript to a specified language.\n   *\n   * @param params - Parameters for translating the transcript\n   * @param params.videoId - The YouTube video ID (provide either this OR url)\n   * @param params.url - The YouTube video URL (provide either this OR videoId)\n   * @param params.lang - The target language code for translation\n   * @param params.text - Optional flag to return plain text instead of timestamped list\n   * @returns A promise that resolves to the translated transcript\n   */\n  async translate(params: TranslateParams): Promise<TranslatedTranscript> {\n    return this.fetch<TranslatedTranscript>(\n      '/youtube/transcript/translate',\n      params\n    );\n  }\n\n  /**\n   * Fetches a YouTube video based on the provided parameters.\n   *\n   * @param params - The parameters required to fetch the YouTube video.\n   * @param params.id - The YouTube video ID.\n   * @returns A promise that resolves to a `YoutubeVideo` object.\n   */\n  async video(params: ResourceParams): Promise<YoutubeVideo> {\n    return this.fetch<YoutubeVideo>('/youtube/video', params);\n  }\n\n  /**\n   * Fetches YouTube channel information and videos.\n   *\n   * @param params - The parameters required to fetch the YouTube channel information.\n   * @param params.id - The YouTube channel ID.\n   * @returns A promise that resolves to a `YoutubeChannel` object containing the channel information.\n   *\n   * @property videos - Fetches the videos of the YouTube channel.\n   * @param params - The parameters required to fetch the YouTube channel videos.\n   * @param params.id - The YouTube channel ID.\n   * @param params.limit - The maximum number of videos to fetch.\n   *                       Default: 30. Max: 5000.\n   * @param params.type - The type of videos to fetch.\n   *                      Default: 'video'.\n   *                      Allowed values: 'video', 'short', 'all'.\n   * @returns A promise that resolves to an array of video IDs.\n   *\n   * @throws {SupadataError} If the limit is invalid (less than 1 or greater than 5000).\n   */\n  channel = Object.assign(\n    async (params: ResourceParams): Promise<YoutubeChannel> => {\n      return this.fetch<YoutubeChannel>('/youtube/channel', params);\n    },\n    {\n      videos: async (params: ChannelVideosParams): Promise<VideoIds> => {\n        // Validate the limit locally to avoid unnecessary API calls.\n        this.validateLimit(params);\n        return this.fetch<VideoIds>('/youtube/channel/videos', params);\n      },\n    }\n  );\n\n  /**\n   * Fetches a YouTube playlist and its videos.\n   *\n   * @param params - The parameters required to fetch the playlist.\n   * @param params.id - The YouTube playlist ID.\n   * @returns A promise that resolves to a `YoutubePlaylist` object.\n   *\n   * @property videos - Fetches the videos of a YouTube playlist.\n   * @param params - The parameters required to fetch the playlist videos.\n   * @param params.id - The YouTube playlist ID.\n   * @param params.limit - The maximum number of videos to fetch.\n   *                       Default: 30. Max: 5000.\n   * @returns A promise that resolves to an array of video IDs.\n   *\n   * @throws {SupadataError} If the limit is invalid (less than 1 or greater than 5000).\n   */\n  playlist = Object.assign(\n    async (params: ResourceParams): Promise<YoutubePlaylist> => {\n      return this.fetch<YoutubePlaylist>('/youtube/playlist', params);\n    },\n    {\n      videos: async (params: PlaylistVideosParams): Promise<VideoIds> => {\n        // Validate the limit locally to avoid unnecessary API calls.\n        this.validateLimit(params);\n        return this.fetch<VideoIds>('/youtube/playlist/videos', params);\n      },\n    }\n  );\n\n  private validateLimit(params: { limit?: number }) {\n    if (\n      params.limit != undefined &&\n      params.limit != null &&\n      (params.limit < 1 || params.limit > 5000)\n    ) {\n      throw new SupadataError({\n        error: 'invalid-request',\n        message: 'Invalid limit.',\n        details: 'The limit must be between 1 and 5000.',\n      });\n    }\n  }\n}\n","import { BaseClient } from '../client.js';\nimport { Crawl, CrawlJob, CrawlRequest, Scrape, SiteMap } from '../types.js';\n\nexport class WebService extends BaseClient {\n  /**\n   * Extract content from any web page to Markdown format.\n   *\n   * @param url - URL of the webpage to scrape\n   * @returns A promise that resolves to the scraped content\n   */\n  async scrape(url: string): Promise<Scrape> {\n    return this.fetch<Scrape>('/web/scrape', { url });\n  }\n\n  /**\n   * Extract all links found on a webpage.\n   *\n   * @param url - URL of the webpage to map\n   * @returns A promise that resolves to a map of URLs found on the page\n   */\n  async map(url: string): Promise<SiteMap> {\n    return this.fetch<SiteMap>('/web/map', { url });\n  }\n\n  /**\n   * Create a crawl job to extract content from all pages on a website.\n   *\n   * @param request - Crawl request parameters\n   * @param request.url - URL of the website to crawl\n   * @param request.limit - Maximum number of pages to crawl (default: 100, max: 5000)\n   * @returns A promise that resolves to the crawl job id\n   */\n  async crawl(request: CrawlRequest): Promise<Crawl> {\n    return this.fetch<Crawl>('/web/crawl', request, 'POST');\n  }\n\n  /**\n   * Get the status and results of a crawl job.\n   * Automatically handles pagination to retrieve all pages from the crawl.\n   *\n   * @param jobId - The ID of the crawl job to retrieve\n   * @returns A promise that resolves to the complete crawl job results\n   */\n  async getCrawlResults(jobId: string): Promise<CrawlJob> {\n    let response: CrawlJob;\n    let pages: Scrape[] = [];\n    let nextUrl: string | undefined;\n\n    do {\n      response = await (nextUrl\n        ? this.fetchUrl<CrawlJob>(nextUrl)\n        : this.fetch<CrawlJob>(`/web/crawl/${jobId}`));\n\n      if (response.pages) {\n        pages = [...pages, ...response.pages];\n      }\n      nextUrl = response.next;\n    } while (nextUrl);\n\n    return response;\n  }\n}\n","import { SupadataConfig } from './types.js';\nimport { YouTubeService } from './services/youtube.js';\nimport { WebService } from './services/web.js';\n\nexport * from './types.js';\nexport * from './client.js';\nexport * from './services/youtube.js';\nexport * from './services/web.js';\n\nexport class Supadata {\n  readonly youtube: YouTubeService;\n  readonly web: WebService;\n\n  constructor(config: SupadataConfig) {\n    this.youtube = new YouTubeService(config);\n    this.web = new WebService(config);\n  }\n}\n"]}

package/dist/index.d.mts

@@ -22,7 +22,7 @@ interface Scrape {
     countCharacters: number;
     urls: string[];
 }
-interface Map {
+interface SiteMap {
     urls: string[];
 }
 interface CrawlRequest {
@@ -52,6 +52,41 @@ declare class SupadataError extends Error {
         documentationUrl?: string;
     });
 }
+interface YoutubeVideo {
+    id: string;
+    title: string;
+    description: string;
+    duration: number;
+    channel: {
+        id: string;
+        name: string;
+    };
+    tags: string[];
+    thumbnail: string;
+    uploadDate: string;
+    viewCount: number;
+    likeCount: number;
+    transcriptLanguages: string[];
+}
+interface YoutubeChannel {
+    id: string;
+    name: string;
+    handle: string;
+    description: string;
+    subscriberCount: number;
+    videoCount: number;
+    thumbnail: string;
+    banner: string;
+}
+interface YoutubePlaylist {
+    id: string;
+    title: string;
+    videoCount: number;
+    viewCount: number;
+    lastUpdated: string;
+    description: string;
+    thumbnail: string;
+}
 
 declare class BaseClient {
     protected config: SupadataConfig;
@@ -83,6 +118,20 @@ type TranscriptParams = {
 interface TranslateParams extends Omit<TranscriptParams, 'lang'> {
     lang: string;
 }
+interface ResourceParams {
+    id: string;
+}
+interface ChannelVideosParams extends ResourceParams {
+    limit?: number;
+    type?: 'video' | 'short' | 'all';
+}
+interface PlaylistVideosParams extends ResourceParams {
+    limit?: number;
+}
+interface VideoIds {
+    videoIds: string[];
+    shortIds: string[];
+}
 declare class YouTubeService extends BaseClient {
     /**
      * Fetches a transcript for a YouTube video.
@@ -106,6 +155,56 @@ declare class YouTubeService extends BaseClient {
      * @returns A promise that resolves to the translated transcript
      */
     translate(params: TranslateParams): Promise<TranslatedTranscript>;
+    /**
+     * Fetches a YouTube video based on the provided parameters.
+     *
+     * @param params - The parameters required to fetch the YouTube video.
+     * @param params.id - The YouTube video ID.
+     * @returns A promise that resolves to a `YoutubeVideo` object.
+     */
+    video(params: ResourceParams): Promise<YoutubeVideo>;
+    /**
+     * Fetches YouTube channel information and videos.
+     *
+     * @param params - The parameters required to fetch the YouTube channel information.
+     * @param params.id - The YouTube channel ID.
+     * @returns A promise that resolves to a `YoutubeChannel` object containing the channel information.
+     *
+     * @property videos - Fetches the videos of the YouTube channel.
+     * @param params - The parameters required to fetch the YouTube channel videos.
+     * @param params.id - The YouTube channel ID.
+     * @param params.limit - The maximum number of videos to fetch.
+     *                       Default: 30. Max: 5000.
+     * @param params.type - The type of videos to fetch.
+     *                      Default: 'video'.
+     *                      Allowed values: 'video', 'short', 'all'.
+     * @returns A promise that resolves to an array of video IDs.
+     *
+     * @throws {SupadataError} If the limit is invalid (less than 1 or greater than 5000).
+     */
+    channel: ((params: ResourceParams) => Promise<YoutubeChannel>) & {
+        videos: (params: ChannelVideosParams) => Promise<VideoIds>;
+    };
+    /**
+     * Fetches a YouTube playlist and its videos.
+     *
+     * @param params - The parameters required to fetch the playlist.
+     * @param params.id - The YouTube playlist ID.
+     * @returns A promise that resolves to a `YoutubePlaylist` object.
+     *
+     * @property videos - Fetches the videos of a YouTube playlist.
+     * @param params - The parameters required to fetch the playlist videos.
+     * @param params.id - The YouTube playlist ID.
+     * @param params.limit - The maximum number of videos to fetch.
+     *                       Default: 30. Max: 5000.
+     * @returns A promise that resolves to an array of video IDs.
+     *
+     * @throws {SupadataError} If the limit is invalid (less than 1 or greater than 5000).
+     */
+    playlist: ((params: ResourceParams) => Promise<YoutubePlaylist>) & {
+        videos: (params: PlaylistVideosParams) => Promise<VideoIds>;
+    };
+    private validateLimit;
 }
 
 declare class WebService extends BaseClient {
@@ -122,7 +221,7 @@ declare class WebService extends BaseClient {
      * @param url - URL of the webpage to map
      * @returns A promise that resolves to a map of URLs found on the page
      */
-    map(url: string): Promise<Map>;
+    map(url: string): Promise<SiteMap>;
     /**
      * Create a crawl job to extract content from all pages on a website.
      *
@@ -148,4 +247,4 @@ declare class Supadata {
     constructor(config: SupadataConfig);
 }
 
-export { BaseClient, type Crawl, type CrawlJob, type CrawlRequest, type Map, type Scrape, Supadata, type SupadataConfig, SupadataError, type Transcript, type TranscriptChunk, type TranscriptParams, type TranslateParams, type TranslatedTranscript, WebService, YouTubeService };
+export { BaseClient, type ChannelVideosParams, type Crawl, type CrawlJob, type CrawlRequest, type PlaylistVideosParams, type ResourceParams, type Scrape, type SiteMap, Supadata, type SupadataConfig, SupadataError, type Transcript, type TranscriptChunk, type TranscriptParams, type TranslateParams, type TranslatedTranscript, type VideoIds, WebService, YouTubeService, type YoutubeChannel, type YoutubePlaylist, type YoutubeVideo };

package/dist/index.d.ts

@@ -22,7 +22,7 @@ interface Scrape {
     countCharacters: number;
     urls: string[];
 }
-interface Map {
+interface SiteMap {
     urls: string[];
 }
 interface CrawlRequest {
@@ -52,6 +52,41 @@ declare class SupadataError extends Error {
         documentationUrl?: string;
     });
 }
+interface YoutubeVideo {
+    id: string;
+    title: string;
+    description: string;
+    duration: number;
+    channel: {
+        id: string;
+        name: string;
+    };
+    tags: string[];
+    thumbnail: string;
+    uploadDate: string;
+    viewCount: number;
+    likeCount: number;
+    transcriptLanguages: string[];
+}
+interface YoutubeChannel {
+    id: string;
+    name: string;
+    handle: string;
+    description: string;
+    subscriberCount: number;
+    videoCount: number;
+    thumbnail: string;
+    banner: string;
+}
+interface YoutubePlaylist {
+    id: string;
+    title: string;
+    videoCount: number;
+    viewCount: number;
+    lastUpdated: string;
+    description: string;
+    thumbnail: string;
+}
 
 declare class BaseClient {
     protected config: SupadataConfig;
@@ -83,6 +118,20 @@ type TranscriptParams = {
 interface TranslateParams extends Omit<TranscriptParams, 'lang'> {
     lang: string;
 }
+interface ResourceParams {
+    id: string;
+}
+interface ChannelVideosParams extends ResourceParams {
+    limit?: number;
+    type?: 'video' | 'short' | 'all';
+}
+interface PlaylistVideosParams extends ResourceParams {
+    limit?: number;
+}
+interface VideoIds {
+    videoIds: string[];
+    shortIds: string[];
+}
 declare class YouTubeService extends BaseClient {
     /**
      * Fetches a transcript for a YouTube video.
@@ -106,6 +155,56 @@ declare class YouTubeService extends BaseClient {
      * @returns A promise that resolves to the translated transcript
      */
     translate(params: TranslateParams): Promise<TranslatedTranscript>;
+    /**
+     * Fetches a YouTube video based on the provided parameters.
+     *
+     * @param params - The parameters required to fetch the YouTube video.
+     * @param params.id - The YouTube video ID.
+     * @returns A promise that resolves to a `YoutubeVideo` object.
+     */
+    video(params: ResourceParams): Promise<YoutubeVideo>;
+    /**
+     * Fetches YouTube channel information and videos.
+     *
+     * @param params - The parameters required to fetch the YouTube channel information.
+     * @param params.id - The YouTube channel ID.
+     * @returns A promise that resolves to a `YoutubeChannel` object containing the channel information.
+     *
+     * @property videos - Fetches the videos of the YouTube channel.
+     * @param params - The parameters required to fetch the YouTube channel videos.
+     * @param params.id - The YouTube channel ID.
+     * @param params.limit - The maximum number of videos to fetch.
+     *                       Default: 30. Max: 5000.
+     * @param params.type - The type of videos to fetch.
+     *                      Default: 'video'.
+     *                      Allowed values: 'video', 'short', 'all'.
+     * @returns A promise that resolves to an array of video IDs.
+     *
+     * @throws {SupadataError} If the limit is invalid (less than 1 or greater than 5000).
+     */
+    channel: ((params: ResourceParams) => Promise<YoutubeChannel>) & {
+        videos: (params: ChannelVideosParams) => Promise<VideoIds>;
+    };
+    /**
+     * Fetches a YouTube playlist and its videos.
+     *
+     * @param params - The parameters required to fetch the playlist.
+     * @param params.id - The YouTube playlist ID.
+     * @returns A promise that resolves to a `YoutubePlaylist` object.
+     *
+     * @property videos - Fetches the videos of a YouTube playlist.
+     * @param params - The parameters required to fetch the playlist videos.
+     * @param params.id - The YouTube playlist ID.
+     * @param params.limit - The maximum number of videos to fetch.
+     *                       Default: 30. Max: 5000.
+     * @returns A promise that resolves to an array of video IDs.
+     *
+     * @throws {SupadataError} If the limit is invalid (less than 1 or greater than 5000).
+     */
+    playlist: ((params: ResourceParams) => Promise<YoutubePlaylist>) & {
+        videos: (params: PlaylistVideosParams) => Promise<VideoIds>;
+    };
+    private validateLimit;
 }
 
 declare class WebService extends BaseClient {
@@ -122,7 +221,7 @@ declare class WebService extends BaseClient {
      * @param url - URL of the webpage to map
      * @returns A promise that resolves to a map of URLs found on the page
      */
-    map(url: string): Promise<Map>;
+    map(url: string): Promise<SiteMap>;
     /**
      * Create a crawl job to extract content from all pages on a website.
      *
@@ -148,4 +247,4 @@ declare class Supadata {
     constructor(config: SupadataConfig);
 }
 
-export { BaseClient, type Crawl, type CrawlJob, type CrawlRequest, type Map, type Scrape, Supadata, type SupadataConfig, SupadataError, type Transcript, type TranscriptChunk, type TranscriptParams, type TranslateParams, type TranslatedTranscript, WebService, YouTubeService };
+export { BaseClient, type ChannelVideosParams, type Crawl, type CrawlJob, type CrawlRequest, type PlaylistVideosParams, type ResourceParams, type Scrape, type SiteMap, Supadata, type SupadataConfig, SupadataError, type Transcript, type TranscriptChunk, type TranscriptParams, type TranslateParams, type TranslatedTranscript, type VideoIds, WebService, YouTubeService, type YoutubeChannel, type YoutubePlaylist, type YoutubeVideo };

package/dist/index.mjs

@@ -1,3 +1,3 @@
-var a=class extends Error{error;details;documentationUrl;constructor(e){super(e.message||"An unexpected error occurred"),this.error=e.error||"internal-error",this.details=e.details||"An unexpected error occurred",this.documentationUrl=e.documentationUrl||"",this.name="SupadataError";}};var u={403:{error:"invalid-request",message:"Invalid or missing API key",details:"Please ensure you have provided a valid API key"},404:{error:"invalid-request",message:"Endpoint does not exist",details:"The API endpoint you are trying to access does not exist"},429:{error:"limit-exceeded",message:"Limit exceeded",details:"You have exceeded the allowed request rate or quota limits"}},T=(n,e)=>n in u?new a({...u[n],message:u[n].message,details:e||u[n].details}):new a({error:"internal-error",message:"An unexpected error occurred",details:e});var c=class{config;constructor(e){this.config=e;}async fetch(e,r={},s="GET"){let t=`${this.config.baseUrl||"https://api.supadata.ai/v1"}${e.startsWith("/")?e:`/${e}`}`;if(s==="GET"&&Object.keys(r).length>0){let p=new URLSearchParams;Object.entries(r).forEach(([o,f])=>{f!=null&&p.append(o,String(f));}),t+=`?${p.toString()}`;}return this.fetchUrl(t,s,r)}async fetchUrl(e,r="GET",s){let i={method:r,headers:{"x-api-key":this.config.apiKey,"Content-Type":"application/json"}};r==="POST"&&s&&(i.body=JSON.stringify(s));let t=await fetch(e,i),p=t.headers.get("content-type");if(!t.ok){if([403,404,429].includes(t.status)){let o=await t.json();throw T(t.status,o.message)}if(p?.includes("application/json")){let o=await t.json();throw new a(o)}else throw new a({error:"internal-error",message:"Unexpected error response format",details:await t.text()})}try{if(!p?.includes("application/json"))throw new a({error:"internal-error",message:"Invalid response format",details:"Expected JSON response but received different content type"});return await t.json()}catch(o){throw new a({error:"internal-error",message:"Failed to parse response",details:o instanceof Error?o.message:"Unknown error"})}}};var g=class extends c{async transcript(e){return this.fetch("/youtube/transcript",e)}async translate(e){return this.fetch("/youtube/transcript/translate",e)}};var m=class extends c{async scrape(e){return this.fetch("/web/scrape",{url:e})}async map(e){return this.fetch("/web/map",{url:e})}async crawl(e){return this.fetch("/web/crawl",e,"POST")}async getCrawlResults(e){let r,s=[],i;do r=await(i?this.fetchUrl(i):this.fetch(`/web/crawl/${e}`)),r.pages&&(s=[...s,...r.pages]),i=r.next;while(i);return r}};var y=class{youtube;web;constructor(e){this.youtube=new g(e),this.web=new m(e);}};
-export{c as BaseClient,y as Supadata,a as SupadataError,m as WebService,g as YouTubeService};//# sourceMappingURL=index.mjs.map
+var t=class extends Error{error;details;documentationUrl;constructor(e){super(e.message||"An unexpected error occurred"),this.error=e.error||"internal-error",this.details=e.details||"An unexpected error occurred",this.documentationUrl=e.documentationUrl||"",this.name="SupadataError";}};var p={403:{error:"invalid-request",message:"Invalid or missing API key",details:"Please ensure you have provided a valid API key"},404:{error:"invalid-request",message:"Endpoint does not exist",details:"The API endpoint you are trying to access does not exist"},429:{error:"limit-exceeded",message:"Limit exceeded",details:"You have exceeded the allowed request rate or quota limits"}},h=(n,e)=>n in p?new t({...p[n],message:p[n].message,details:e||p[n].details}):new t({error:"internal-error",message:"An unexpected error occurred",details:e});var c=class{config;constructor(e){this.config=e;}async fetch(e,r={},s="GET"){let i=`${this.config.baseUrl||"https://api.supadata.ai/v1"}${e.startsWith("/")?e:`/${e}`}`;if(s==="GET"&&Object.keys(r).length>0){let l=new URLSearchParams;Object.entries(r).forEach(([o,f])=>{f!=null&&l.append(o,String(f));}),i+=`?${l.toString()}`;}return this.fetchUrl(i,s,r)}async fetchUrl(e,r="GET",s){let a={method:r,headers:{"x-api-key":this.config.apiKey,"Content-Type":"application/json"}};r==="POST"&&s&&(a.body=JSON.stringify(s));let i=await fetch(e,a),l=i.headers.get("content-type");if(!i.ok){if([403,404,429].includes(i.status)){let o=await i.json();throw h(i.status,o.message)}if(l?.includes("application/json")){let o=await i.json();throw new t(o)}else throw new t({error:"internal-error",message:"Unexpected error response format",details:await i.text()})}try{if(!l?.includes("application/json"))throw new t({error:"internal-error",message:"Invalid response format",details:"Expected JSON response but received different content type"});return await i.json()}catch(o){throw new t({error:"internal-error",message:"Failed to parse response",details:o instanceof Error?o.message:"Unknown error"})}}};var m=class extends c{async transcript(e){return this.fetch("/youtube/transcript",e)}async translate(e){return this.fetch("/youtube/transcript/translate",e)}async video(e){return this.fetch("/youtube/video",e)}channel=Object.assign(async e=>this.fetch("/youtube/channel",e),{videos:async e=>(this.validateLimit(e),this.fetch("/youtube/channel/videos",e))});playlist=Object.assign(async e=>this.fetch("/youtube/playlist",e),{videos:async e=>(this.validateLimit(e),this.fetch("/youtube/playlist/videos",e))});validateLimit(e){if(e.limit!=null&&e.limit!=null&&(e.limit<1||e.limit>5e3))throw new t({error:"invalid-request",message:"Invalid limit.",details:"The limit must be between 1 and 5000."})}};var g=class extends c{async scrape(e){return this.fetch("/web/scrape",{url:e})}async map(e){return this.fetch("/web/map",{url:e})}async crawl(e){return this.fetch("/web/crawl",e,"POST")}async getCrawlResults(e){let r,s=[],a;do r=await(a?this.fetchUrl(a):this.fetch(`/web/crawl/${e}`)),r.pages&&(s=[...s,...r.pages]),a=r.next;while(a);return r}};var b=class{youtube;web;constructor(e){this.youtube=new m(e),this.web=new g(e);}};
+export{c as BaseClient,b as Supadata,t as SupadataError,g as WebService,m as YouTubeService};//# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/types.ts","../src/gateway-error-mapper.ts","../src/client.ts","../src/services/youtube.ts","../src/services/web.ts","../src/index.ts"],"names":["SupadataError","error","GATEWAY_STATUS_ERRORS","mapGatewayError","statusCode","errorText","BaseClient","config","endpoint","params","method","url","queryParams","key","value","body","options","response","contentType","errorData","YouTubeService","WebService","request","jobId","pages","nextUrl","Supadata"],"mappings":"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","file":"index.mjs","sourcesContent":["export interface TranscriptChunk {\n  text: string;\n  offset: number;\n  duration: number;\n  lang: string;\n}\n\nexport interface Transcript {\n  content: TranscriptChunk[] | string;\n  lang: string;\n  availableLangs: string[];\n}\n\nexport interface TranslatedTranscript {\n  content: TranscriptChunk[] | string;\n  lang: string;\n}\n\nexport interface Scrape {\n  url: string;\n  content: string;\n  name: string;\n  description: string;\n  ogUrl: string;\n  countCharacters: number;\n  urls: string[];\n}\n\nexport interface Map {\n  urls: string[];\n}\n\nexport interface CrawlRequest {\n  url: string;\n  limit?: number;\n}\n\nexport interface Crawl {\n  jobId: string;\n}\n\nexport interface CrawlJob {\n  status: 'scraping' | 'completed' | 'failed' | 'cancelled';\n  pages?: Scrape[];\n  next?: string;\n}\n\nexport interface SupadataConfig {\n  apiKey: string;\n  baseUrl?: string;\n}\n\nexport class SupadataError extends Error {\n  error:\n    | 'invalid-request'\n    | 'missing-parameters'\n    | 'internal-error'\n    | 'transcript-unavailable'\n    | 'video-not-found'\n    | 'video-id-invalid'\n    | 'youtube-api-error'\n    | 'limit-exceeded';\n  details: string;\n  documentationUrl: string;\n\n  constructor(error: {\n    error: SupadataError['error'];\n    message?: string;\n    details?: string;\n    documentationUrl?: string;\n  }) {\n    super(error.message || 'An unexpected error occurred');\n    this.error = error.error || 'internal-error';\n    this.details = error.details || 'An unexpected error occurred';\n    this.documentationUrl = error.documentationUrl || '';\n    this.name = 'SupadataError';\n  }\n}\n","import { SupadataError } from './types';\n\n/*\nThe API gateway returns errors in text/plain content type. \nAs a temporary workaround we're mapping them to SupadataError.\n*/\n\nconst GATEWAY_STATUS_ERRORS = {\n  403: {\n    error: 'invalid-request' as const,\n    message: 'Invalid or missing API key',\n    details: 'Please ensure you have provided a valid API key',\n  },\n  404: {\n    error: 'invalid-request' as const,\n    message: 'Endpoint does not exist',\n    details: 'The API endpoint you are trying to access does not exist',\n  },\n  429: {\n    error: 'limit-exceeded' as const,\n    message: 'Limit exceeded',\n    details: 'You have exceeded the allowed request rate or quota limits',\n  },\n};\n\nexport const mapGatewayError = (\n  statusCode: number,\n  errorText: string\n): SupadataError => {\n  if (statusCode in GATEWAY_STATUS_ERRORS) {\n    return new SupadataError({\n      ...GATEWAY_STATUS_ERRORS[\n        statusCode as keyof typeof GATEWAY_STATUS_ERRORS\n      ],\n      message:\n        GATEWAY_STATUS_ERRORS[statusCode as keyof typeof GATEWAY_STATUS_ERRORS]\n          .message,\n      details:\n        errorText ||\n        GATEWAY_STATUS_ERRORS[statusCode as keyof typeof GATEWAY_STATUS_ERRORS]\n          .details,\n    });\n  }\n\n  // Default error if status code is not recognized\n  return new SupadataError({\n    error: 'internal-error',\n    message: 'An unexpected error occurred',\n    details: errorText,\n  });\n};\n","import { SupadataConfig, SupadataError } from './types.js';\nimport { mapGatewayError } from './gateway-error-mapper.js';\n\nexport class BaseClient {\n  protected config: SupadataConfig;\n\n  constructor(config: SupadataConfig) {\n    this.config = config;\n  }\n\n  protected async fetch<T>(\n    endpoint: string,\n    params: Record<string, any> = {},\n    method: 'GET' | 'POST' = 'GET'\n  ): Promise<T> {\n    const baseUrl = this.config.baseUrl || 'https://api.supadata.ai/v1';\n    let url = `${baseUrl}${\n      endpoint.startsWith('/') ? endpoint : `/${endpoint}`\n    }`;\n\n    if (method === 'GET' && Object.keys(params).length > 0) {\n      const queryParams = new URLSearchParams();\n      Object.entries(params).forEach(([key, value]) => {\n        if (value !== undefined && value !== null) {\n          queryParams.append(key, String(value));\n        }\n      });\n      url += `?${queryParams.toString()}`;\n    }\n\n    return this.fetchUrl<T>(url, method, params);\n  }\n\n  protected async fetchUrl<T>(\n    url: string,\n    method: 'GET' | 'POST' = 'GET',\n    body?: Record<string, any>\n  ): Promise<T> {\n    const options: RequestInit = {\n      method,\n      headers: {\n        'x-api-key': this.config.apiKey,\n        'Content-Type': 'application/json',\n      },\n    };\n\n    if (method === 'POST' && body) {\n      options.body = JSON.stringify(body);\n    }\n\n    const response = await fetch(url, options);\n\n    const contentType = response.headers.get('content-type');\n\n    if (!response.ok) {\n      // First check for gateway-specific status codes\n      if ([403, 404, 429].includes(response.status)) {\n        const errorData = await response.json();\n        throw mapGatewayError(response.status, errorData.message);\n      }\n\n      // Handle standard API errors\n      if (contentType?.includes('application/json')) {\n        const errorData = await response.json();\n        throw new SupadataError(errorData);\n      } else {\n        // Fallback for unexpected non-JSON errors\n        throw new SupadataError({\n          error: 'internal-error',\n          message: 'Unexpected error response format',\n          details: await response.text(),\n        });\n      }\n    }\n\n    try {\n      if (!contentType?.includes('application/json')) {\n        throw new SupadataError({\n          error: 'internal-error',\n          message: 'Invalid response format',\n          details: 'Expected JSON response but received different content type',\n        });\n      }\n\n      return (await response.json()) as T;\n    } catch (error) {\n      throw new SupadataError({\n        error: 'internal-error',\n        message: 'Failed to parse response',\n        details: error instanceof Error ? error.message : 'Unknown error',\n      });\n    }\n  }\n}\n","import { BaseClient } from '../client.js';\nimport { Transcript, TranslatedTranscript } from '../types.js';\n\n/**\n * Ensures exactly one property from the specified keys is provided.\n * @example\n * // Valid: { url: \"...\" } or { videoId: \"...\" }\n * // Invalid: {} or { url: \"...\", videoId: \"...\" }\n */\ntype ExactlyOne<T, Keys extends keyof T> = {\n  [K in Keys]: { [P in K]-?: T[P] } & { [P in Exclude<Keys, K>]?: never };\n}[Keys] &\n  Omit<T, Keys>;\n\nexport type TranscriptParams = {\n  lang?: string;\n  text?: boolean;\n} & ExactlyOne<{ videoId: string; url: string }, 'videoId' | 'url'>;\n\nexport interface TranslateParams extends Omit<TranscriptParams, 'lang'> {\n  lang: string;\n}\n\nexport class YouTubeService extends BaseClient {\n  /**\n   * Fetches a transcript for a YouTube video.\n   *\n   * @param params - Parameters for fetching the transcript\n   * @param params.videoId - The YouTube video ID (provide either this OR url)\n   * @param params.url - The YouTube video URL (provide either this OR videoId)\n   * @param params.lang - Optional language code for the transcript\n   * @param params.text - Optional flag to return plain text instead of timestamped list\n   * @returns A promise that resolves to the video transcript\n   */\n  async transcript(params: TranscriptParams): Promise<Transcript> {\n    return this.fetch<Transcript>('/youtube/transcript', params);\n  }\n\n  /**\n   * Translates a YouTube video transcript to a specified language.\n   *\n   * @param params - Parameters for translating the transcript\n   * @param params.videoId - The YouTube video ID (provide either this OR url)\n   * @param params.url - The YouTube video URL (provide either this OR videoId)\n   * @param params.lang - The target language code for translation\n   * @param params.text - Optional flag to return plain text instead of timestamped list\n   * @returns A promise that resolves to the translated transcript\n   */\n  async translate(params: TranslateParams): Promise<TranslatedTranscript> {\n    return this.fetch<TranslatedTranscript>(\n      '/youtube/transcript/translate',\n      params\n    );\n  }\n}\n","import { BaseClient } from '../client.js';\nimport { Scrape, Map, CrawlRequest, Crawl, CrawlJob } from '../types.js';\n\nexport class WebService extends BaseClient {\n  /**\n   * Extract content from any web page to Markdown format.\n   *\n   * @param url - URL of the webpage to scrape\n   * @returns A promise that resolves to the scraped content\n   */\n  async scrape(url: string): Promise<Scrape> {\n    return this.fetch<Scrape>('/web/scrape', { url });\n  }\n\n  /**\n   * Extract all links found on a webpage.\n   *\n   * @param url - URL of the webpage to map\n   * @returns A promise that resolves to a map of URLs found on the page\n   */\n  async map(url: string): Promise<Map> {\n    return this.fetch<Map>('/web/map', { url });\n  }\n\n  /**\n   * Create a crawl job to extract content from all pages on a website.\n   *\n   * @param request - Crawl request parameters\n   * @param request.url - URL of the website to crawl\n   * @param request.limit - Maximum number of pages to crawl (default: 100, max: 5000)\n   * @returns A promise that resolves to the crawl job id\n   */\n  async crawl(request: CrawlRequest): Promise<Crawl> {\n    return this.fetch<Crawl>('/web/crawl', request, 'POST');\n  }\n\n  /**\n   * Get the status and results of a crawl job.\n   * Automatically handles pagination to retrieve all pages from the crawl.\n   *\n   * @param jobId - The ID of the crawl job to retrieve\n   * @returns A promise that resolves to the complete crawl job results\n   */\n  async getCrawlResults(jobId: string): Promise<CrawlJob> {\n    let response: CrawlJob;\n    let pages: Scrape[] = [];\n    let nextUrl: string | undefined;\n\n    do {\n      response = await (nextUrl\n        ? this.fetchUrl<CrawlJob>(nextUrl)\n        : this.fetch<CrawlJob>(`/web/crawl/${jobId}`));\n\n      if (response.pages) {\n        pages = [...pages, ...response.pages];\n      }\n      nextUrl = response.next;\n    } while (nextUrl);\n\n    return response;\n  }\n}\n","import { SupadataConfig } from './types.js';\nimport { YouTubeService } from './services/youtube.js';\nimport { WebService } from './services/web.js';\n\nexport * from './types.js';\nexport * from './client.js';\nexport * from './services/youtube.js';\nexport * from './services/web.js';\n\nexport class Supadata {\n  readonly youtube: YouTubeService;\n  readonly web: WebService;\n\n  constructor(config: SupadataConfig) {\n    this.youtube = new YouTubeService(config);\n    this.web = new WebService(config);\n  }\n}\n"]}
+{"version":3,"sources":["../src/types.ts","../src/gateway-error-mapper.ts","../src/client.ts","../src/services/youtube.ts","../src/services/web.ts","../src/index.ts"],"names":["SupadataError","error","GATEWAY_STATUS_ERRORS","mapGatewayError","statusCode","errorText","BaseClient","config","endpoint","params","method","url","queryParams","key","value","body","options","response","contentType","errorData","YouTubeService","WebService","request","jobId","pages","nextUrl","Supadata"],"mappings":"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","file":"index.mjs","sourcesContent":["export interface TranscriptChunk {\n  text: string;\n  offset: number;\n  duration: number;\n  lang: string;\n}\n\nexport interface Transcript {\n  content: TranscriptChunk[] | string;\n  lang: string;\n  availableLangs: string[];\n}\n\nexport interface TranslatedTranscript {\n  content: TranscriptChunk[] | string;\n  lang: string;\n}\n\nexport interface Scrape {\n  url: string;\n  content: string;\n  name: string;\n  description: string;\n  ogUrl: string;\n  countCharacters: number;\n  urls: string[];\n}\n\nexport interface SiteMap {\n  urls: string[];\n}\n\nexport interface CrawlRequest {\n  url: string;\n  limit?: number;\n}\n\nexport interface Crawl {\n  jobId: string;\n}\n\nexport interface CrawlJob {\n  status: 'scraping' | 'completed' | 'failed' | 'cancelled';\n  pages?: Scrape[];\n  next?: string;\n}\n\nexport interface SupadataConfig {\n  apiKey: string;\n  baseUrl?: string;\n}\n\nexport class SupadataError extends Error {\n  error:\n    | 'invalid-request'\n    | 'missing-parameters'\n    | 'internal-error'\n    | 'transcript-unavailable'\n    | 'video-not-found'\n    | 'video-id-invalid'\n    | 'youtube-api-error'\n    | 'limit-exceeded';\n  details: string;\n  documentationUrl: string;\n\n  constructor(error: {\n    error: SupadataError['error'];\n    message?: string;\n    details?: string;\n    documentationUrl?: string;\n  }) {\n    super(error.message || 'An unexpected error occurred');\n    this.error = error.error || 'internal-error';\n    this.details = error.details || 'An unexpected error occurred';\n    this.documentationUrl = error.documentationUrl || '';\n    this.name = 'SupadataError';\n  }\n}\n\nexport interface YoutubeVideo {\n  id: string;\n  title: string;\n  description: string;\n  duration: number;\n  channel: {\n    id: string;\n    name: string;\n  };\n  tags: string[];\n  thumbnail: string;\n  uploadDate: string;\n  viewCount: number;\n  likeCount: number;\n  transcriptLanguages: string[];\n}\n\nexport interface YoutubeChannel {\n  id: string;\n  name: string;\n  handle: string;\n  description: string;\n  subscriberCount: number;\n  videoCount: number;\n  thumbnail: string;\n  banner: string;\n}\n\nexport interface YoutubePlaylist {\n  id: string;\n  title: string;\n  videoCount: number;\n  viewCount: number;\n  lastUpdated: string;\n  description: string;\n  thumbnail: string;\n}\n","import { SupadataError } from './types';\n\n/*\nThe API gateway returns errors in text/plain content type. \nAs a temporary workaround we're mapping them to SupadataError.\n*/\n\nconst GATEWAY_STATUS_ERRORS = {\n  403: {\n    error: 'invalid-request' as const,\n    message: 'Invalid or missing API key',\n    details: 'Please ensure you have provided a valid API key',\n  },\n  404: {\n    error: 'invalid-request' as const,\n    message: 'Endpoint does not exist',\n    details: 'The API endpoint you are trying to access does not exist',\n  },\n  429: {\n    error: 'limit-exceeded' as const,\n    message: 'Limit exceeded',\n    details: 'You have exceeded the allowed request rate or quota limits',\n  },\n};\n\nexport const mapGatewayError = (\n  statusCode: number,\n  errorText: string\n): SupadataError => {\n  if (statusCode in GATEWAY_STATUS_ERRORS) {\n    return new SupadataError({\n      ...GATEWAY_STATUS_ERRORS[\n        statusCode as keyof typeof GATEWAY_STATUS_ERRORS\n      ],\n      message:\n        GATEWAY_STATUS_ERRORS[statusCode as keyof typeof GATEWAY_STATUS_ERRORS]\n          .message,\n      details:\n        errorText ||\n        GATEWAY_STATUS_ERRORS[statusCode as keyof typeof GATEWAY_STATUS_ERRORS]\n          .details,\n    });\n  }\n\n  // Default error if status code is not recognized\n  return new SupadataError({\n    error: 'internal-error',\n    message: 'An unexpected error occurred',\n    details: errorText,\n  });\n};\n","import { SupadataConfig, SupadataError } from './types.js';\nimport { mapGatewayError } from './gateway-error-mapper.js';\n\nexport class BaseClient {\n  protected config: SupadataConfig;\n\n  constructor(config: SupadataConfig) {\n    this.config = config;\n  }\n\n  protected async fetch<T>(\n    endpoint: string,\n    params: Record<string, any> = {},\n    method: 'GET' | 'POST' = 'GET'\n  ): Promise<T> {\n    const baseUrl = this.config.baseUrl || 'https://api.supadata.ai/v1';\n    let url = `${baseUrl}${\n      endpoint.startsWith('/') ? endpoint : `/${endpoint}`\n    }`;\n\n    if (method === 'GET' && Object.keys(params).length > 0) {\n      const queryParams = new URLSearchParams();\n      Object.entries(params).forEach(([key, value]) => {\n        if (value !== undefined && value !== null) {\n          queryParams.append(key, String(value));\n        }\n      });\n      url += `?${queryParams.toString()}`;\n    }\n\n    return this.fetchUrl<T>(url, method, params);\n  }\n\n  protected async fetchUrl<T>(\n    url: string,\n    method: 'GET' | 'POST' = 'GET',\n    body?: Record<string, any>\n  ): Promise<T> {\n    const options: RequestInit = {\n      method,\n      headers: {\n        'x-api-key': this.config.apiKey,\n        'Content-Type': 'application/json',\n      },\n    };\n\n    if (method === 'POST' && body) {\n      options.body = JSON.stringify(body);\n    }\n\n    const response = await fetch(url, options);\n\n    const contentType = response.headers.get('content-type');\n\n    if (!response.ok) {\n      // First check for gateway-specific status codes\n      if ([403, 404, 429].includes(response.status)) {\n        const errorData = await response.json();\n        throw mapGatewayError(response.status, errorData.message);\n      }\n\n      // Handle standard API errors\n      if (contentType?.includes('application/json')) {\n        const errorData = await response.json();\n        throw new SupadataError(errorData);\n      } else {\n        // Fallback for unexpected non-JSON errors\n        throw new SupadataError({\n          error: 'internal-error',\n          message: 'Unexpected error response format',\n          details: await response.text(),\n        });\n      }\n    }\n\n    try {\n      if (!contentType?.includes('application/json')) {\n        throw new SupadataError({\n          error: 'internal-error',\n          message: 'Invalid response format',\n          details: 'Expected JSON response but received different content type',\n        });\n      }\n\n      return (await response.json()) as T;\n    } catch (error) {\n      throw new SupadataError({\n        error: 'internal-error',\n        message: 'Failed to parse response',\n        details: error instanceof Error ? error.message : 'Unknown error',\n      });\n    }\n  }\n}\n","import { BaseClient } from '../client.js';\nimport {\n  SupadataError,\n  Transcript,\n  TranslatedTranscript,\n  YoutubeChannel,\n  YoutubePlaylist,\n  YoutubeVideo,\n} from '../types.js';\n\n/**\n * Ensures exactly one property from the specified keys is provided.\n * @example\n * // Valid: { url: \"...\" } or { videoId: \"...\" }\n * // Invalid: {} or { url: \"...\", videoId: \"...\" }\n */\ntype ExactlyOne<T, Keys extends keyof T> = {\n  [K in Keys]: { [P in K]-?: T[P] } & { [P in Exclude<Keys, K>]?: never };\n}[Keys] &\n  Omit<T, Keys>;\n\nexport type TranscriptParams = {\n  lang?: string;\n  text?: boolean;\n} & ExactlyOne<{ videoId: string; url: string }, 'videoId' | 'url'>;\n\nexport interface TranslateParams extends Omit<TranscriptParams, 'lang'> {\n  lang: string;\n}\n\nexport interface ResourceParams {\n  id: string;\n}\n\nexport interface ChannelVideosParams extends ResourceParams {\n  limit?: number;\n  type?: 'video' | 'short' | 'all';\n}\n\nexport interface PlaylistVideosParams extends ResourceParams {\n  limit?: number;\n}\n\nexport interface VideoIds {\n  videoIds: string[];\n  shortIds: string[];\n}\n\nexport class YouTubeService extends BaseClient {\n  /**\n   * Fetches a transcript for a YouTube video.\n   *\n   * @param params - Parameters for fetching the transcript\n   * @param params.videoId - The YouTube video ID (provide either this OR url)\n   * @param params.url - The YouTube video URL (provide either this OR videoId)\n   * @param params.lang - Optional language code for the transcript\n   * @param params.text - Optional flag to return plain text instead of timestamped list\n   * @returns A promise that resolves to the video transcript\n   */\n  async transcript(params: TranscriptParams): Promise<Transcript> {\n    return this.fetch<Transcript>('/youtube/transcript', params);\n  }\n\n  /**\n   * Translates a YouTube video transcript to a specified language.\n   *\n   * @param params - Parameters for translating the transcript\n   * @param params.videoId - The YouTube video ID (provide either this OR url)\n   * @param params.url - The YouTube video URL (provide either this OR videoId)\n   * @param params.lang - The target language code for translation\n   * @param params.text - Optional flag to return plain text instead of timestamped list\n   * @returns A promise that resolves to the translated transcript\n   */\n  async translate(params: TranslateParams): Promise<TranslatedTranscript> {\n    return this.fetch<TranslatedTranscript>(\n      '/youtube/transcript/translate',\n      params\n    );\n  }\n\n  /**\n   * Fetches a YouTube video based on the provided parameters.\n   *\n   * @param params - The parameters required to fetch the YouTube video.\n   * @param params.id - The YouTube video ID.\n   * @returns A promise that resolves to a `YoutubeVideo` object.\n   */\n  async video(params: ResourceParams): Promise<YoutubeVideo> {\n    return this.fetch<YoutubeVideo>('/youtube/video', params);\n  }\n\n  /**\n   * Fetches YouTube channel information and videos.\n   *\n   * @param params - The parameters required to fetch the YouTube channel information.\n   * @param params.id - The YouTube channel ID.\n   * @returns A promise that resolves to a `YoutubeChannel` object containing the channel information.\n   *\n   * @property videos - Fetches the videos of the YouTube channel.\n   * @param params - The parameters required to fetch the YouTube channel videos.\n   * @param params.id - The YouTube channel ID.\n   * @param params.limit - The maximum number of videos to fetch.\n   *                       Default: 30. Max: 5000.\n   * @param params.type - The type of videos to fetch.\n   *                      Default: 'video'.\n   *                      Allowed values: 'video', 'short', 'all'.\n   * @returns A promise that resolves to an array of video IDs.\n   *\n   * @throws {SupadataError} If the limit is invalid (less than 1 or greater than 5000).\n   */\n  channel = Object.assign(\n    async (params: ResourceParams): Promise<YoutubeChannel> => {\n      return this.fetch<YoutubeChannel>('/youtube/channel', params);\n    },\n    {\n      videos: async (params: ChannelVideosParams): Promise<VideoIds> => {\n        // Validate the limit locally to avoid unnecessary API calls.\n        this.validateLimit(params);\n        return this.fetch<VideoIds>('/youtube/channel/videos', params);\n      },\n    }\n  );\n\n  /**\n   * Fetches a YouTube playlist and its videos.\n   *\n   * @param params - The parameters required to fetch the playlist.\n   * @param params.id - The YouTube playlist ID.\n   * @returns A promise that resolves to a `YoutubePlaylist` object.\n   *\n   * @property videos - Fetches the videos of a YouTube playlist.\n   * @param params - The parameters required to fetch the playlist videos.\n   * @param params.id - The YouTube playlist ID.\n   * @param params.limit - The maximum number of videos to fetch.\n   *                       Default: 30. Max: 5000.\n   * @returns A promise that resolves to an array of video IDs.\n   *\n   * @throws {SupadataError} If the limit is invalid (less than 1 or greater than 5000).\n   */\n  playlist = Object.assign(\n    async (params: ResourceParams): Promise<YoutubePlaylist> => {\n      return this.fetch<YoutubePlaylist>('/youtube/playlist', params);\n    },\n    {\n      videos: async (params: PlaylistVideosParams): Promise<VideoIds> => {\n        // Validate the limit locally to avoid unnecessary API calls.\n        this.validateLimit(params);\n        return this.fetch<VideoIds>('/youtube/playlist/videos', params);\n      },\n    }\n  );\n\n  private validateLimit(params: { limit?: number }) {\n    if (\n      params.limit != undefined &&\n      params.limit != null &&\n      (params.limit < 1 || params.limit > 5000)\n    ) {\n      throw new SupadataError({\n        error: 'invalid-request',\n        message: 'Invalid limit.',\n        details: 'The limit must be between 1 and 5000.',\n      });\n    }\n  }\n}\n","import { BaseClient } from '../client.js';\nimport { Crawl, CrawlJob, CrawlRequest, Scrape, SiteMap } from '../types.js';\n\nexport class WebService extends BaseClient {\n  /**\n   * Extract content from any web page to Markdown format.\n   *\n   * @param url - URL of the webpage to scrape\n   * @returns A promise that resolves to the scraped content\n   */\n  async scrape(url: string): Promise<Scrape> {\n    return this.fetch<Scrape>('/web/scrape', { url });\n  }\n\n  /**\n   * Extract all links found on a webpage.\n   *\n   * @param url - URL of the webpage to map\n   * @returns A promise that resolves to a map of URLs found on the page\n   */\n  async map(url: string): Promise<SiteMap> {\n    return this.fetch<SiteMap>('/web/map', { url });\n  }\n\n  /**\n   * Create a crawl job to extract content from all pages on a website.\n   *\n   * @param request - Crawl request parameters\n   * @param request.url - URL of the website to crawl\n   * @param request.limit - Maximum number of pages to crawl (default: 100, max: 5000)\n   * @returns A promise that resolves to the crawl job id\n   */\n  async crawl(request: CrawlRequest): Promise<Crawl> {\n    return this.fetch<Crawl>('/web/crawl', request, 'POST');\n  }\n\n  /**\n   * Get the status and results of a crawl job.\n   * Automatically handles pagination to retrieve all pages from the crawl.\n   *\n   * @param jobId - The ID of the crawl job to retrieve\n   * @returns A promise that resolves to the complete crawl job results\n   */\n  async getCrawlResults(jobId: string): Promise<CrawlJob> {\n    let response: CrawlJob;\n    let pages: Scrape[] = [];\n    let nextUrl: string | undefined;\n\n    do {\n      response = await (nextUrl\n        ? this.fetchUrl<CrawlJob>(nextUrl)\n        : this.fetch<CrawlJob>(`/web/crawl/${jobId}`));\n\n      if (response.pages) {\n        pages = [...pages, ...response.pages];\n      }\n      nextUrl = response.next;\n    } while (nextUrl);\n\n    return response;\n  }\n}\n","import { SupadataConfig } from './types.js';\nimport { YouTubeService } from './services/youtube.js';\nimport { WebService } from './services/web.js';\n\nexport * from './types.js';\nexport * from './client.js';\nexport * from './services/youtube.js';\nexport * from './services/web.js';\n\nexport class Supadata {\n  readonly youtube: YouTubeService;\n  readonly web: WebService;\n\n  constructor(config: SupadataConfig) {\n    this.youtube = new YouTubeService(config);\n    this.web = new WebService(config);\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supadata/js",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "TypeScript / JavaScript SDK for Supadata API",
   "homepage": "https://supadata.ai",
   "repository": "https://github.com/supadata-ai/js",