chore: v3

Author: neverlane

package.json

@@ -5,7 +5,7 @@
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {
-    "build": "tsup",
+    "build": "rm -rf ./dist && tsup",
     "test": "vitest"
   },
   "devDependencies": {

src/client.ts

@@ -5,7 +5,7 @@ export interface ClientOptions {
   kodikApiUrl?: string;
 }
 
-const KODIK_API_URL = 'https://kodikapi.com';
+export const KODIK_API_URL = 'https://kodikapi.com';
 
 const endpointsArr: (keyof APIMethods)[] =
   ['countries', 'genres', 'list', 'qualities', 'search', 'translations', 'years', 'qualitiesV2', 'translationsV2'];
@@ -21,7 +21,6 @@ export class ClientError extends Error {
 
 // eslint-disable-next-line @typescript-eslint/no-unsafe-declaration-merging
 export class Client {
-  // private agent: Agent;
   public KODIK_API_URL: string;
 
   constructor({ token, kodikApiUrl }: ClientOptions) {

src/errors/index.ts

@@ -1,2 +1 @@
-export * from './parse';
 export * from './video-links';

src/errors/parse.ts

@@ -1,3 +1,42 @@
+export interface VideoLinksErrorOptions {
+  code: string;
+  description: string;
+  data?: unknown;
+  cause?: unknown;
+}
+
 export class VideoLinksError extends Error {
-  name: string = 'VideoLinksError';
+  /** Error code */
+  code: string;
+  /** Error stack */
+  stack!: string;
+  /** Error data */
+  data?: unknown;
+  /** Error cause */
+  cause?: unknown;
+
+  constructor ({ code, description, data, cause }: VideoLinksErrorOptions) {
+    super(description);
+
+    this.code = code;
+    this.data = data;
+    this.name = this.constructor.name;
+    this.cause = cause;
+
+    Error.captureStackTrace(this, this.constructor);
+  }
+
+  get [Symbol.toStringTag] () {
+    return this.constructor.name;
+  }
+
+  toJSON (): Pick<this, keyof this> {
+    const json = {} as Pick<this, keyof this>;
+
+    for (const key of Object.getOwnPropertyNames(this)) {
+      json[key as keyof this] = this[key as keyof this];
+    }
+
+    return json;
+  }
 }

src/errors/video-links.ts

@@ -1,8 +1,8 @@
-export * from './countries';
-export * from './genres';
-export * from './list';
-export * from './qualities';
-export * from './search';
-export * from './translations';
-export * from './years';
-export * from './shared-types';
+export type * from './countries';
+export type * from './genres';
+export type * from './list';
+export type * from './qualities';
+export type * from './search';
+export type * from './translations';
+export type * from './years';
+export type * from './shared-types';

src/resources/index.ts

@@ -1,4 +1,4 @@
-import { ParseError, VideoLinksError } from './errors';
+import { VideoLinksError } from './errors';
 import type { ObjectOrUnknown } from './types';
 
 export const KODIK_PLAYER_DOMAIN = 'kodik.info';
@@ -63,13 +63,22 @@ export const kodikPlayerLinkRegexp = /^(?<protocol>http[s]?:|)\/\/(?<host>[a-z0-
 
 export class VideoLinks {
   static async parseLink<Extended extends boolean>({ extended, link }: VideoLinksParseParams<Extended>): Promise<KodikParsedLink<Extended>> {
-    if (!link) throw new ParseError('link is undefined');
+    if (!link)
+      throw new VideoLinksError({
+        code: 'parse-link-invalid',
+        description: 'link is not provided',
+        data: { link }
+      });
 
     const kodikLink = this.normalizeKodikLink(link);
-    if (!kodikPlayerLinkRegexp.test(link)) throw new ParseError('kodikLink is not allowed');
+    if (!kodikPlayerLinkRegexp.test(link))
+      throw new VideoLinksError({
+        code: 'parse-link-invalid',
+        description: 'link is not valid',
+        data: { link }
+      });
 
-    const linkParams = kodikPlayerLinkRegexp.exec(kodikLink)?.groups;
-    if (!linkParams) throw new ParseError('cannot get \'groups\' from \'linkParams\'');
+    const linkParams = kodikPlayerLinkRegexp.exec(kodikLink)!.groups!;
 
     const { host, hash, id, quality, type } = linkParams;
     const parsedLink: KodikParsedLink = {
@@ -85,8 +94,16 @@ export class VideoLinks {
     const skipButtons = page.match(/parseSkipButtons?\("(?<data>[^"]+)"\s*,\s*"(?<type>[^"]+)"\)/is)?.groups;
     const playerSingleUrl = page.match(/src="(?<link>\/assets\/js\/app\.player_single\.[a-z0-9]+\.js)"/is)?.groups?.link;
 
-    if (!urlParams) throw new ParseError('cannot get urlParams');
-    if (!translation) throw new ParseError('cannot get translation');
+    if (!urlParams) throw new VideoLinksError({
+      code: 'parse-link-ex-invalid',
+      description: 'cannot get url params',
+      data: { link, page }
+    });
+    if (!translation) throw new VideoLinksError({
+      code: 'parse-link-ex-invalid',
+      description: 'cannot get translation',
+      data: { link, page }
+    });
 
     const extendedParsedLink: KodikParsedLink<true> = {
       ...parsedLink,
@@ -126,25 +143,38 @@ export class VideoLinks {
     );
     const videoInfoResponse = await fetch(url);
     if (videoInfoResponse.headers.get('content-type') !== 'application/json')
-      throw new VideoLinksError('videoInfoResponse is not json');
+      throw new VideoLinksError({
+        code: 'get-links-invalid-response',
+        description: 'videoInfoResponse is not json',
+        data: { videoInfoResponse }
+      });
 
     const videoInfoJson = await videoInfoResponse.json();
 
     if (typeof videoInfoJson !== 'object' || videoInfoJson === null)
-      throw new VideoLinksError('videoInfoJson is not object');
+      throw new VideoLinksError({
+        code: 'get-links-invalid-response',
+        description: 'videoInfoJson is not object',
+        data: { videoInfoResponse, videoInfoJson }
+      });
     if (typeof videoInfoJson.links !== 'object')
-      throw new VideoLinksError('videoInfoJson.links is not object');
+      throw new VideoLinksError({
+        code: 'get-links-invalid-response',
+        description: 'videoInfoJson.links is not object',
+        data: { videoInfoResponse, videoInfoJson }
+      });
 
     const links = videoInfoJson.links as KodikVideoLinks;
     const zCharCode = 'Z'.charCodeAt(0);
 
     // decrypt source links
     for (const [, sources] of Object.entries(links)) {
       for (const source of sources) {
-        source.src = Buffer.from(source.src.replace(/[a-zA-Z]/g, e => {
+        const decryptedBase64 = source.src.replace(/[a-zA-Z]/g, e => {
           let eCharCode = e.charCodeAt(0);
           return String.fromCharCode((eCharCode <= zCharCode ? 90 : 122) >= (eCharCode = eCharCode + 13) ? eCharCode : eCharCode - 26);
-        }), 'base64').toString('utf8');
+        });
+        source.src = atob(decryptedBase64);
       }
     }