@supadata/js 1.0.0 → 1.0.2

package/README.md

@@ -1,6 +1,11 @@
-# @supadata/ts
+# Supadata JS SDK
 
-Official TypeScript/JavaScript SDK for the Supadata API.
+[![NPM package](https://img.shields.io/npm/v/@supadata/js.svg?branch=main)](https://www.npmjs.com/package/@supadata/js)
+[![MIT license](https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat)](http://opensource.org/licenses/MIT)
+
+The official TypeScript/JavaScript SDK for Supadata.
+
+Get your free API key at [supadata.ai](https://supadata.ai) and start scraping data in minutes.
 
 ## Installation
 
@@ -11,29 +16,29 @@ npm install @supadata/js
 ## Usage
 
 ```typescript
-import { Supadata, Transcript } from "@supadata/js";
+import { Supadata, Transcript } from '@supadata/js';
 
 // Initialize the client
 const supadata = new Supadata({
-  apiKey: "YOUR_API_KEY",
+  apiKey: 'YOUR_API_KEY',
 });
 
 // Get YouTube transcript
 const transcript = await supadata.youtube.transcript({
-  videoId: "VIDEO_ID",
+  videoId: 'VIDEO_ID',
 });
 
 // Translate YouTube transcript
 const translated = await supadata.youtube.translate({
-  videoId: "VIDEO_ID",
-  lang: "es",
+  videoId: 'VIDEO_ID',
+  lang: 'es',
 });
 
 // Scrape web content
-const webContent = await supadata.web.scrape("https://supadata.ai");
+const webContent = await supadata.web.scrape('https://supadata.ai');
 
 // Map website URLs
-const siteMap = await supadata.web.map("https://supadata.ai");
+const siteMap = await supadata.web.map('https://supadata.ai');
 ```
 
 ## Error Handling
@@ -41,18 +46,18 @@ const siteMap = await supadata.web.map("https://supadata.ai");
 The SDK throws `SupadataError` for API-related errors. You can catch and handle these errors as follows:
 
 ```typescript
-import { SupadataError } from "@supadata/js";
+import { SupadataError } from '@supadata/js';
 
 try {
   const transcript = await supadata.youtube.transcript({
-    videoId: "INVALID_ID",
+    videoId: 'INVALID_ID',
   });
-} catch (error) {
-  if (error instanceof SupadataError) {
-    console.error(error.code); // e.g., 'video-not-found'
-    console.error(error.title); // Human readable error title
-    console.error(error.message); // Detailed error description
-    console.error(error.documentationUrl); // Link to error documentation
+} catch (e) {
+  if (e instanceof SupadataError) {
+    console.error(e.error); // e.g., 'video-not-found'
+    console.error(e.message); // Human readable error message
+    console.error(e.details); // Detailed error description
+    console.error(e.documentationUrl); // Link to error documentation (optional)
   }
 }
 ```

package/dist/index.cjs

@@ -0,0 +1,3 @@
+'use strict';var e=class extends Error{error;details;documentationUrl;constructor(r){super(r.message||"An unexpected error occurred"),this.error=r.error||"internal-error",this.details=r.details||"An unexpected error occurred",this.documentationUrl=r.documentationUrl||"",this.name="SupadataError";}};var o={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"}},g=(t,r)=>t in o?new e({...o[t],message:o[t].message,details:r||o[t].details}):new e({error:"internal-error",message:"An unexpected error occurred",details:r});var s=class{config;constructor(r){this.config=r;}async fetch(r,l){let m=`${this.config.baseUrl||"https://api.supadata.ai/v1"}${r.startsWith("/")?r:`/${r}`}`;if(l){let a=new URLSearchParams;Object.entries(l).forEach(([h,d])=>{d!=null&&a.append(h,String(d));}),m+=`?${a.toString()}`;}let n=await fetch(m,{method:"GET",headers:{"x-api-key":this.config.apiKey,"Content-Type":"application/json"}}),u=n.headers.get("content-type");if(!n.ok){if([403,404,429].includes(n.status)){let a=await n.json();throw g(n.status,a.message)}if(u?.includes("application/json")){let a=await n.json();throw new e(a)}else throw new e({error:"internal-error",message:"Unexpected error response format",details:await n.text()})}try{if(!u?.includes("application/json"))throw new e({error:"internal-error",message:"Invalid response format",details:"Expected JSON response but received different content type"});return await n.json()}catch(a){throw new e({error:"internal-error",message:"Failed to parse response",details:a instanceof Error?a.message:"Unknown error"})}}};var c=class extends s{async transcript(r){return this.fetch("/youtube/transcript",r)}async translate(r){return this.fetch("/youtube/transcript/translate",r)}};var p=class extends s{async scrape(r){return this.fetch("/web/scrape",{url:r})}async map(r){return this.fetch("/web/map",{url:r})}};var f=class{youtube;web;constructor(r){this.youtube=new c(r),this.web=new p(r);}};
+exports.BaseClient=s;exports.Supadata=f;exports.SupadataError=e;exports.WebService=p;exports.YouTubeService=c;//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +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","url","queryParams","key","value","response","contentType","errorData","YouTubeService","WebService","Supadata"],"mappings":"aAqCaA,IAAAA,CAAAA,CAAN,cAA4B,KAAM,CACvC,MASA,OACA,CAAA,gBAAA,CAEA,YAAYC,CAKT,CAAA,CACD,MAAMA,CAAM,CAAA,OAAA,EAAW,8BAA8B,CACrD,CAAA,IAAA,CAAK,MAAQA,CAAM,CAAA,KAAA,EAAS,iBAC5B,IAAK,CAAA,OAAA,CAAUA,EAAM,OAAW,EAAA,8BAAA,CAChC,KAAK,gBAAmBA,CAAAA,CAAAA,CAAM,kBAAoB,EAClD,CAAA,IAAA,CAAK,KAAO,gBACd,CACF,ECvDA,IAAMC,CAAAA,CAAwB,CAC5B,GAAK,CAAA,CACH,MAAO,iBACP,CAAA,OAAA,CAAS,4BACT,CAAA,OAAA,CAAS,iDACX,CAAA,CACA,IAAK,CACH,KAAA,CAAO,kBACP,OAAS,CAAA,yBAAA,CACT,QAAS,0DACX,CAAA,CACA,IAAK,CACH,KAAA,CAAO,iBACP,OAAS,CAAA,gBAAA,CACT,QAAS,4DACX,CACF,EAEaC,CAAkB,CAAA,CAC7BC,CACAC,CAAAA,CAAAA,GAEID,CAAcF,IAAAA,CAAAA,CACT,IAAIF,CAAc,CAAA,CACvB,GAAGE,CACDE,CAAAA,CACF,EACA,OACEF,CAAAA,CAAAA,CAAsBE,CAAgD,CACnE,CAAA,OAAA,CACL,QACEC,CACAH,EAAAA,CAAAA,CAAsBE,CAAgD,CACnE,CAAA,OACP,CAAC,CAII,CAAA,IAAIJ,CAAc,CAAA,CACvB,KAAO,CAAA,gBAAA,CACP,QAAS,8BACT,CAAA,OAAA,CAASK,CACX,CAAC,CAAA,KC9CUC,CAAN,CAAA,KAAiB,CACZ,MAEV,CAAA,WAAA,CAAYC,EAAwB,CAClC,IAAA,CAAK,OAASA,EAChB,CAEA,MAAM,KACJC,CAAAA,CAAAA,CACAC,EACY,CAEZ,IAAIC,EAAM,CADM,EAAA,IAAA,CAAK,OAAO,OAAW,EAAA,4BACnB,GAClBF,CAAS,CAAA,UAAA,CAAW,GAAG,CAAIA,CAAAA,CAAAA,CAAW,IAAIA,CAAQ,CAAA,CACpD,GAEA,GAAIC,CAAAA,CAAQ,CACV,IAAME,CAAAA,CAAc,IAAI,eAAA,CACxB,MAAO,CAAA,OAAA,CAAQF,CAAM,CAAE,CAAA,OAAA,CAAQ,CAAC,CAACG,CAAAA,CAAKC,CAAK,CAAM,GAAA,CACpBA,GAAU,IACnCF,EAAAA,CAAAA,CAAY,OAAOC,CAAK,CAAA,MAAA,CAAOC,CAAK,CAAC,EAEzC,CAAC,CACDH,CAAAA,CAAAA,EAAO,CAAIC,CAAAA,EAAAA,CAAAA,CAAY,QAAS,EAAC,GACnC,CAEA,IAAMG,EAAW,MAAM,KAAA,CAAMJ,EAAK,CAChC,MAAA,CAAQ,MACR,OAAS,CAAA,CACP,YAAa,IAAK,CAAA,MAAA,CAAO,OACzB,cAAgB,CAAA,kBAClB,CACF,CAAC,CAAA,CAEKK,CAAcD,CAAAA,CAAAA,CAAS,OAAQ,CAAA,GAAA,CAAI,cAAc,CAEvD,CAAA,GAAI,CAACA,CAAS,CAAA,EAAA,CAAI,CAEhB,GAAI,CAAC,IAAK,GAAK,CAAA,GAAG,EAAE,QAASA,CAAAA,CAAAA,CAAS,MAAM,CAAG,CAAA,CAC7C,IAAME,CAAY,CAAA,MAAMF,EAAS,IAAK,EAAA,CACtC,MAAMX,CAAgBW,CAAAA,CAAAA,CAAS,OAAQE,CAAU,CAAA,OAAO,CAC1D,CAGA,GAAID,GAAa,QAAS,CAAA,kBAAkB,EAAG,CAC7C,IAAMC,EAAY,MAAMF,CAAAA,CAAS,MACjC,CAAA,MAAM,IAAId,CAAAA,CAAcgB,CAAS,CACnC,MAEQ,MAAA,IAAIhB,EAAc,CACtB,KAAA,CAAO,iBACP,OAAS,CAAA,kCAAA,CACT,QAAS,MAAMc,CAAAA,CAAS,MAC1B,CAAC,CAEL,CAEA,GAAI,CACF,GAAI,CAACC,CAAa,EAAA,QAAA,CAAS,kBAAkB,CAAA,CAC3C,MAAM,IAAIf,CAAAA,CAAc,CACtB,KAAO,CAAA,gBAAA,CACP,QAAS,yBACT,CAAA,OAAA,CAAS,4DACX,CAAC,CAAA,CAGH,OAAQ,MAAMc,CAAAA,CAAS,MACzB,CAAA,MAASb,EAAO,CACd,MAAM,IAAID,CAAAA,CAAc,CACtB,KAAA,CAAO,iBACP,OAAS,CAAA,0BAAA,CACT,QAASC,CAAiB,YAAA,KAAA,CAAQA,EAAM,OAAU,CAAA,eACpD,CAAC,CACH,CACF,CACF,ECjEO,IAAMgB,EAAN,cAA6BX,CAAW,CAC7C,MAAM,UAAA,CAAWG,EAA+C,CAC9D,OAAO,KAAK,KAAkB,CAAA,qBAAA,CAAuBA,CAAM,CAC7D,CAEA,MAAM,SAAUA,CAAAA,CAAAA,CAAwD,CACtE,OAAO,IAAA,CAAK,MACV,+BACAA,CAAAA,CACF,CACF,CACF,MCrBaS,CAAN,CAAA,cAAyBZ,CAAW,CACzC,MAAM,MAAA,CAAOI,EAA8B,CACzC,OAAO,KAAK,KAAc,CAAA,aAAA,CAAe,CAAE,GAAAA,CAAAA,CAAI,CAAC,CAClD,CAEA,MAAM,GAAIA,CAAAA,CAAAA,CAA2B,CACnC,OAAO,IAAA,CAAK,MAAW,UAAY,CAAA,CAAE,GAAAA,CAAAA,CAAI,CAAC,CAC5C,CACF,ECFO,IAAMS,EAAN,KAAe,CACX,QACA,GAET,CAAA,WAAA,CAAYZ,EAAwB,CAClC,IAAA,CAAK,QAAU,IAAIU,CAAAA,CAAeV,CAAM,CACxC,CAAA,IAAA,CAAK,IAAM,IAAIW,CAAAA,CAAWX,CAAM,EAClC,CACF","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 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  async fetch<T>(\n    endpoint: string,\n    params: Record<string, unknown> | object\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 (params) {\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    const response = await fetch(url, {\n      method: 'GET',\n      headers: {\n        'x-api-key': this.config.apiKey,\n        'Content-Type': 'application/json',\n      },\n    });\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\nexport interface TranscriptParams {\n  videoId: string;\n  lang?: string;\n  text?: boolean;\n}\n\nexport interface TranslateParams extends TranscriptParams {\n  lang: string;\n}\n\nexport class YouTubeService extends BaseClient {\n  async transcript(params: TranscriptParams): Promise<Transcript> {\n    return this.fetch<Transcript>('/youtube/transcript', params);\n  }\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 } from '../types.js';\n\nexport class WebService extends BaseClient {\n  async scrape(url: string): Promise<Scrape> {\n    return this.fetch<Scrape>('/web/scrape', { url });\n  }\n\n  async map(url: string): Promise<Map> {\n    return this.fetch<Map>('/web/map', { url });\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

@@ -0,0 +1,74 @@
+interface TranscriptChunk {
+    text: string;
+    offset: number;
+    duration: number;
+    lang: string;
+}
+interface Transcript {
+    content: TranscriptChunk[] | string;
+    lang: string;
+    availableLangs: string[];
+}
+interface TranslatedTranscript {
+    content: TranscriptChunk[] | string;
+    lang: string;
+}
+interface Scrape {
+    url: string;
+    content: string;
+    name: string;
+    description: string;
+    ogUrl: string;
+    countCharacters: number;
+    urls: string[];
+}
+interface Map {
+    urls: string[];
+}
+interface SupadataConfig {
+    apiKey: string;
+    baseUrl?: string;
+}
+declare class SupadataError extends Error {
+    error: 'invalid-request' | 'missing-parameters' | 'internal-error' | 'transcript-unavailable' | 'video-not-found' | 'video-id-invalid' | 'youtube-api-error' | 'limit-exceeded';
+    details: string;
+    documentationUrl: string;
+    constructor(error: {
+        error: SupadataError['error'];
+        message?: string;
+        details?: string;
+        documentationUrl?: string;
+    });
+}
+
+declare class BaseClient {
+    protected config: SupadataConfig;
+    constructor(config: SupadataConfig);
+    fetch<T>(endpoint: string, params: Record<string, unknown> | object): Promise<T>;
+}
+
+interface TranscriptParams {
+    videoId: string;
+    lang?: string;
+    text?: boolean;
+}
+interface TranslateParams extends TranscriptParams {
+    lang: string;
+}
+declare class YouTubeService extends BaseClient {
+    transcript(params: TranscriptParams): Promise<Transcript>;
+    translate(params: TranslateParams): Promise<TranslatedTranscript>;
+}
+
+declare class WebService extends BaseClient {
+    scrape(url: string): Promise<Scrape>;
+    map(url: string): Promise<Map>;
+}
+
+declare class Supadata {
+    readonly youtube: YouTubeService;
+    readonly web: WebService;
+    constructor(config: SupadataConfig);
+}
+
+export { BaseClient, type Map, type Scrape, Supadata, type SupadataConfig, SupadataError, type Transcript, type TranscriptChunk, type TranscriptParams, type TranslateParams, type TranslatedTranscript, WebService, YouTubeService };

package/dist/index.d.ts

@@ -1,12 +1,74 @@
-import { SupadataConfig } from './types.js';
-import { YouTubeService } from './services/youtube.js';
-import { WebService } from './services/web.js';
-export * from './types.js';
-export * from './client.js';
-export * from './services/youtube.js';
-export * from './services/web.js';
-export declare class Supadata {
+interface TranscriptChunk {
+    text: string;
+    offset: number;
+    duration: number;
+    lang: string;
+}
+interface Transcript {
+    content: TranscriptChunk[] | string;
+    lang: string;
+    availableLangs: string[];
+}
+interface TranslatedTranscript {
+    content: TranscriptChunk[] | string;
+    lang: string;
+}
+interface Scrape {
+    url: string;
+    content: string;
+    name: string;
+    description: string;
+    ogUrl: string;
+    countCharacters: number;
+    urls: string[];
+}
+interface Map {
+    urls: string[];
+}
+interface SupadataConfig {
+    apiKey: string;
+    baseUrl?: string;
+}
+declare class SupadataError extends Error {
+    error: 'invalid-request' | 'missing-parameters' | 'internal-error' | 'transcript-unavailable' | 'video-not-found' | 'video-id-invalid' | 'youtube-api-error' | 'limit-exceeded';
+    details: string;
+    documentationUrl: string;
+    constructor(error: {
+        error: SupadataError['error'];
+        message?: string;
+        details?: string;
+        documentationUrl?: string;
+    });
+}
+
+declare class BaseClient {
+    protected config: SupadataConfig;
+    constructor(config: SupadataConfig);
+    fetch<T>(endpoint: string, params: Record<string, unknown> | object): Promise<T>;
+}
+
+interface TranscriptParams {
+    videoId: string;
+    lang?: string;
+    text?: boolean;
+}
+interface TranslateParams extends TranscriptParams {
+    lang: string;
+}
+declare class YouTubeService extends BaseClient {
+    transcript(params: TranscriptParams): Promise<Transcript>;
+    translate(params: TranslateParams): Promise<TranslatedTranscript>;
+}
+
+declare class WebService extends BaseClient {
+    scrape(url: string): Promise<Scrape>;
+    map(url: string): Promise<Map>;
+}
+
+declare class Supadata {
     readonly youtube: YouTubeService;
     readonly web: WebService;
     constructor(config: SupadataConfig);
 }
+
+export { BaseClient, type Map, type Scrape, Supadata, type SupadataConfig, SupadataError, type Transcript, type TranscriptChunk, type TranscriptParams, type TranslateParams, type TranslatedTranscript, WebService, YouTubeService };

package/dist/index.mjs

@@ -0,0 +1,3 @@
+var e=class extends Error{error;details;documentationUrl;constructor(r){super(r.message||"An unexpected error occurred"),this.error=r.error||"internal-error",this.details=r.details||"An unexpected error occurred",this.documentationUrl=r.documentationUrl||"",this.name="SupadataError";}};var c={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=(t,r)=>t in c?new e({...c[t],message:c[t].message,details:r||c[t].details}):new e({error:"internal-error",message:"An unexpected error occurred",details:r});var s=class{config;constructor(r){this.config=r;}async fetch(r,m){let u=`${this.config.baseUrl||"https://api.supadata.ai/v1"}${r.startsWith("/")?r:`/${r}`}`;if(m){let a=new URLSearchParams;Object.entries(m).forEach(([T,l])=>{l!=null&&a.append(T,String(l));}),u+=`?${a.toString()}`;}let n=await fetch(u,{method:"GET",headers:{"x-api-key":this.config.apiKey,"Content-Type":"application/json"}}),g=n.headers.get("content-type");if(!n.ok){if([403,404,429].includes(n.status)){let a=await n.json();throw f(n.status,a.message)}if(g?.includes("application/json")){let a=await n.json();throw new e(a)}else throw new e({error:"internal-error",message:"Unexpected error response format",details:await n.text()})}try{if(!g?.includes("application/json"))throw new e({error:"internal-error",message:"Invalid response format",details:"Expected JSON response but received different content type"});return await n.json()}catch(a){throw new e({error:"internal-error",message:"Failed to parse response",details:a instanceof Error?a.message:"Unknown error"})}}};var p=class extends s{async transcript(r){return this.fetch("/youtube/transcript",r)}async translate(r){return this.fetch("/youtube/transcript/translate",r)}};var d=class extends s{async scrape(r){return this.fetch("/web/scrape",{url:r})}async map(r){return this.fetch("/web/map",{url:r})}};var h=class{youtube;web;constructor(r){this.youtube=new p(r),this.web=new d(r);}};
+export{s as BaseClient,h as Supadata,e as SupadataError,d as WebService,p as YouTubeService};//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +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","url","queryParams","key","value","response","contentType","errorData","YouTubeService","WebService","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 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  async fetch<T>(\n    endpoint: string,\n    params: Record<string, unknown> | object\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 (params) {\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    const response = await fetch(url, {\n      method: 'GET',\n      headers: {\n        'x-api-key': this.config.apiKey,\n        'Content-Type': 'application/json',\n      },\n    });\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\nexport interface TranscriptParams {\n  videoId: string;\n  lang?: string;\n  text?: boolean;\n}\n\nexport interface TranslateParams extends TranscriptParams {\n  lang: string;\n}\n\nexport class YouTubeService extends BaseClient {\n  async transcript(params: TranscriptParams): Promise<Transcript> {\n    return this.fetch<Transcript>('/youtube/transcript', params);\n  }\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 } from '../types.js';\n\nexport class WebService extends BaseClient {\n  async scrape(url: string): Promise<Scrape> {\n    return this.fetch<Scrape>('/web/scrape', { url });\n  }\n\n  async map(url: string): Promise<Map> {\n    return this.fetch<Map>('/web/map', { url });\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,19 +1,23 @@
 {
   "name": "@supadata/js",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "TypeScript / JavaScript SDK for Supadata API",
-  "type": "module",
-  "main": "./dist/index.js",
-  "module": "./dist/index.js",
+  "homepage": "https://supadata.ai",
+  "repository": "https://github.com/supadata-ai/js",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.mjs"
     }
   },
   "scripts": {
-    "build": "tsc",
+    "dev": "tsup --watch",
+    "build": "tsup",
     "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js",
     "prepare": "npm run build",
     "format": "prettier --write \"src/**/*.{js,ts}\"",
@@ -41,6 +45,7 @@
     "jest-fetch-mock": "^3.0.3",
     "prettier": "^3.4.2",
     "ts-jest": "^29.2.5",
-    "typescript": "^5.7.3"
+    "typescript": "^5.7.3",
+    "tsup": "^8.3.6"
   }
 }

package/dist/client.d.ts

@@ -1,12 +0,0 @@
-import { SupadataConfig, Error } from "./types.js";
-export declare class BaseClient {
-    protected config: SupadataConfig;
-    constructor(config: SupadataConfig);
-    fetch<T>(endpoint: string, params: Record<string, unknown> | object): Promise<T>;
-}
-export declare class SupadataError extends Error {
-    code: Error["code"];
-    title: string;
-    documentationUrl: string;
-    constructor(error: Error);
-}

package/dist/client.js

@@ -1,43 +0,0 @@
-export class BaseClient {
-    config;
-    constructor(config) {
-        this.config = config;
-    }
-    async fetch(endpoint, params) {
-        const baseUrl = this.config.baseUrl || "https://api.supadata.ai/v1";
-        let url = `${baseUrl}${endpoint.startsWith("/") ? endpoint : `/${endpoint}`}`;
-        if (params) {
-            const queryParams = new URLSearchParams();
-            Object.entries(params).forEach(([key, value]) => {
-                if (value !== undefined && value !== null) {
-                    queryParams.append(key, String(value));
-                }
-            });
-            url += `?${queryParams.toString()}`;
-        }
-        const response = await fetch(url, {
-            method: "GET",
-            headers: {
-                "x-api-key": this.config.apiKey,
-                "Content-Type": "application/json",
-            },
-        });
-        const data = await response.json();
-        if (!response.ok) {
-            const error = data;
-            throw new SupadataError(error);
-        }
-        return data;
-    }
-}
-export class SupadataError extends Error {
-    code;
-    title;
-    documentationUrl;
-    constructor(error) {
-        super(error.description);
-        this.code = error.code;
-        this.title = error.title;
-        this.documentationUrl = error.documentationUrl;
-    }
-}

package/dist/index.js

@@ -1,14 +0,0 @@
-import { YouTubeService } from './services/youtube.js';
-import { WebService } from './services/web.js';
-export * from './types.js';
-export * from './client.js';
-export * from './services/youtube.js';
-export * from './services/web.js';
-export class Supadata {
-    youtube;
-    web;
-    constructor(config) {
-        this.youtube = new YouTubeService(config);
-        this.web = new WebService(config);
-    }
-}

package/dist/services/web.d.ts

@@ -1,6 +0,0 @@
-import { BaseClient } from '../client.js';
-import { Scrape, Map } from '../types.js';
-export declare class WebService extends BaseClient {
-    scrape(url: string): Promise<Scrape>;
-    map(url: string): Promise<Map>;
-}

package/dist/services/web.js

@@ -1,9 +0,0 @@
-import { BaseClient } from '../client.js';
-export class WebService extends BaseClient {
-    async scrape(url) {
-        return this.fetch('/web/scrape', { url });
-    }
-    async map(url) {
-        return this.fetch('/web/map', { url });
-    }
-}

package/dist/services/youtube.d.ts

@@ -1,14 +0,0 @@
-import { BaseClient } from "../client.js";
-import { Transcript, TranslatedTranscript } from "../types.js";
-export interface TranscriptParams {
-    videoId: string;
-    lang?: string;
-    text?: boolean;
-}
-export interface TranslateParams extends TranscriptParams {
-    lang: string;
-}
-export declare class YouTubeService extends BaseClient {
-    transcript(params: TranscriptParams): Promise<Transcript>;
-    translate(params: TranslateParams): Promise<TranslatedTranscript>;
-}

package/dist/services/youtube.js

@@ -1,9 +0,0 @@
-import { BaseClient } from "../client.js";
-export class YouTubeService extends BaseClient {
-    async transcript(params) {
-        return this.fetch("/youtube/transcript", params);
-    }
-    async translate(params) {
-        return this.fetch("/youtube/transcript/translate", params);
-    }
-}

package/dist/types.d.ts

@@ -1,37 +0,0 @@
-export interface TranscriptChunk {
-    text: string;
-    offset: number;
-    duration: number;
-    lang: string;
-}
-export interface Transcript {
-    content: TranscriptChunk[] | string;
-    lang: string;
-    availableLangs: string[];
-}
-export interface TranslatedTranscript {
-    content: TranscriptChunk[] | string;
-    lang: string;
-}
-export interface Scrape {
-    url: string;
-    content: string;
-    name: string;
-    description: string;
-    ogUrl: string;
-    countCharacters: number;
-    urls: string[];
-}
-export interface Map {
-    urls: string[];
-}
-export interface SupadataConfig {
-    apiKey: string;
-    baseUrl?: string;
-}
-export interface Error {
-    code: 'invalid-request' | 'missing-parameters' | 'internal-error' | 'transcript-unavailable' | 'video-not-found' | 'video-id-invalid' | 'youtube-api-error' | 'quota-exceeded' | 'rate-limit-exceeded';
-    title: string;
-    description: string;
-    documentationUrl: string;
-}

package/dist/types.js

@@ -1 +0,0 @@
-export {};