@supadata/js 1.0.0 → 1.0.1

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 t=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 x={"endpoint is not configured":{error:"invalid-request",message:"The requested endpoint is not configured",details:"The API endpoint you are trying to access does not exist"},"No valid access key found":{error:"invalid-request",message:"Invalid or missing API key",details:"Please ensure you have provided a valid API key"},"quota exceeded":{error:"quota-exceeded",message:"API quota exceeded",details:"You have exceeded your API quota for the current period"}},g=(s,r)=>{let o=Object.entries(x).find(([u])=>r.includes(u));return o?new t(o[1]):new t({error:"internal-error",message:"An unexpected error occurred",details:r})};var n=class{config;constructor(r){this.config=r;}async fetch(r,o){let l=`${this.config.baseUrl||"https://api.supadata.ai/v1"}${r.startsWith("/")?r:`/${r}`}`;if(o){let e=new URLSearchParams;Object.entries(o).forEach(([h,d])=>{d!=null&&e.append(h,String(d));}),l+=`?${e.toString()}`;}let a=await fetch(l,{method:"GET",headers:{"x-api-key":this.config.apiKey,"Content-Type":"application/json"}}),m=a.headers.get("content-type");if(!a.ok)if(m?.includes("application/json")){let e=await a.json();throw new t(e)}else {let e=await a.text();throw g(a.status,e)}try{if(!m?.includes("application/json"))throw new t({error:"internal-error",message:"Invalid response format",details:"Expected JSON response but received different content type"});return await a.json()}catch(e){throw new t({error:"internal-error",message:"Failed to parse response",details:e instanceof Error?e.message:"Unknown error"})}}};var c=class extends n{async transcript(r){return this.fetch("/youtube/transcript",r)}async translate(r){return this.fetch("/youtube/transcript/translate",r)}};var p=class extends n{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=n;exports.Supadata=f;exports.SupadataError=t;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_ERROR_PATTERNS","mapGatewayError","statusCode","errorText","matchedError","pattern","BaseClient","config","endpoint","params","url","queryParams","key","value","response","contentType","errorData","YouTubeService","WebService","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 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    | 'quota-exceeded'\n    | 'rate-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_ERROR_PATTERNS = {\n  'endpoint is not configured': {\n    error: 'invalid-request' as const,\n    message: 'The requested endpoint is not configured',\n    details: 'The API endpoint you are trying to access does not exist',\n  },\n  'No valid access key found': {\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  'quota exceeded': {\n    error: 'quota-exceeded' as const,\n    message: 'API quota exceeded',\n    details: 'You have exceeded your API quota for the current period',\n  },\n};\n\nexport const mapGatewayError = (\n  statusCode: number,\n  errorText: string\n): SupadataError => {\n  const matchedError = Object.entries(GATEWAY_ERROR_PATTERNS).find(\n    ([pattern]) => errorText.includes(pattern)\n  );\n\n  if (matchedError) {\n    return new SupadataError(matchedError[1]);\n  }\n\n  // Default error if no pattern matches\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      if (contentType?.includes('application/json')) {\n        const errorData = await response.json();\n        throw new SupadataError(errorData);\n      } else {\n        const errorText = await response.text();\n        throw mapGatewayError(response.status, errorText);\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}","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}"]}

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' | 'quota-exceeded' | 'rate-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' | 'quota-exceeded' | 'rate-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 t=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 T={"endpoint is not configured":{error:"invalid-request",message:"The requested endpoint is not configured",details:"The API endpoint you are trying to access does not exist"},"No valid access key found":{error:"invalid-request",message:"Invalid or missing API key",details:"Please ensure you have provided a valid API key"},"quota exceeded":{error:"quota-exceeded",message:"API quota exceeded",details:"You have exceeded your API quota for the current period"}},f=(s,r)=>{let o=Object.entries(T).find(([l])=>r.includes(l));return o?new t(o[1]):new t({error:"internal-error",message:"An unexpected error occurred",details:r})};var n=class{config;constructor(r){this.config=r;}async fetch(r,o){let m=`${this.config.baseUrl||"https://api.supadata.ai/v1"}${r.startsWith("/")?r:`/${r}`}`;if(o){let e=new URLSearchParams;Object.entries(o).forEach(([x,u])=>{u!=null&&e.append(x,String(u));}),m+=`?${e.toString()}`;}let a=await fetch(m,{method:"GET",headers:{"x-api-key":this.config.apiKey,"Content-Type":"application/json"}}),g=a.headers.get("content-type");if(!a.ok)if(g?.includes("application/json")){let e=await a.json();throw new t(e)}else {let e=await a.text();throw f(a.status,e)}try{if(!g?.includes("application/json"))throw new t({error:"internal-error",message:"Invalid response format",details:"Expected JSON response but received different content type"});return await a.json()}catch(e){throw new t({error:"internal-error",message:"Failed to parse response",details:e instanceof Error?e.message:"Unknown error"})}}};var p=class extends n{async transcript(r){return this.fetch("/youtube/transcript",r)}async translate(r){return this.fetch("/youtube/transcript/translate",r)}};var d=class extends n{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{n as BaseClient,h as Supadata,t 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_ERROR_PATTERNS","mapGatewayError","statusCode","errorText","matchedError","pattern","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    | 'quota-exceeded'\n    | 'rate-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_ERROR_PATTERNS = {\n  'endpoint is not configured': {\n    error: 'invalid-request' as const,\n    message: 'The requested endpoint is not configured',\n    details: 'The API endpoint you are trying to access does not exist',\n  },\n  'No valid access key found': {\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  'quota exceeded': {\n    error: 'quota-exceeded' as const,\n    message: 'API quota exceeded',\n    details: 'You have exceeded your API quota for the current period',\n  },\n};\n\nexport const mapGatewayError = (\n  statusCode: number,\n  errorText: string\n): SupadataError => {\n  const matchedError = Object.entries(GATEWAY_ERROR_PATTERNS).find(\n    ([pattern]) => errorText.includes(pattern)\n  );\n\n  if (matchedError) {\n    return new SupadataError(matchedError[1]);\n  }\n\n  // Default error if no pattern matches\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      if (contentType?.includes('application/json')) {\n        const errorData = await response.json();\n        throw new SupadataError(errorData);\n      } else {\n        const errorText = await response.text();\n        throw mapGatewayError(response.status, errorText);\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}","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}"]}

package/package.json

@@ -1,19 +1,23 @@
 {
   "name": "@supadata/js",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "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 {};