@jaaq/jaaq-sdk-js 1.1.1-dev-e4e4d9c-20251219 → 1.1.1-dev-b3e6bfd-20260515

package/README.md

@@ -63,13 +63,14 @@ const collection = await client.collections.getById('collection-id');
 
 ### Client config
 
-| Option      | Type           | Required | Default                | Notes                                |
-| ----------- | -------------- | -------- | ---------------------- | ------------------------------------ |
-| `apiKey`    | `string`       | Yes      | -                      | Required for authentication          |
-| `clientId`  | `string`       | Yes      | -                      | Used as subscription identifier      |
-| `baseUrl`   | `string`       | No       | `https://api.jaaq.app` | API base URL                         |
-| `fetch`     | `typeof fetch` | No       | `globalThis.fetch`     | Provide for Node/custom runtimes     |
-| `timeoutMs` | `number`       | No       | -                      | Passed through to HTTP client config |
+| Option       | Type           | Required | Default                | Notes                                |
+| ------------ | -------------- | -------- | ---------------------- | ------------------------------------ |
+| `apiKey`     | `string`       | Yes      | -                      | Required for authentication          |
+| `clientId`   | `string`       | Yes      | -                      | Used as subscription identifier      |
+| `baseUrl`    | `string`       | No       | `https://api.jaaq.app` | API base URL                         |
+| `apiVersion` | `string`       | No       | `v1`                   | API version                          |
+| `fetch`      | `typeof fetch` | No       | `globalThis.fetch`     | Provide for Node/custom runtimes     |
+| `timeoutMs`  | `number`       | No       | -                      | Passed through to HTTP client config |
 
 ## UI Overview
 
@@ -310,6 +311,7 @@ export function App() {
 | `clientId`           | `string`                          | Conditional | -       |
 | `client`             | `JaaqClient`                      | Conditional | -       |
 | `baseUrl`            | `string`                          | No          | -       |
+| `apiVersion`         | `string`                          | Conditional | `v1`    |
 | `autoplay`           | `boolean`                         | No          | `false` |
 | `controls`           | `boolean`                         | No          | `true`  |
 | `width`              | `string`                          | No          | `100%`  |
@@ -384,6 +386,7 @@ export function App() {
 | `subscriptionId` | `string`                                                               | No          | -       |
 | `client`         | `JaaqClient`                                                           | Conditional | -       |
 | `baseUrl`        | `string`                                                               | No          | -       |
+| `apiVersion`     | `string`                                                               | Conditional | `v1`    |
 | `autoplay`       | `boolean`                                                              | No          | `false` |
 | `showArrows`     | `boolean`                                                              | No          | `true`  |
 | `showDots`       | `boolean`                                                              | No          | `true`  |
@@ -438,6 +441,7 @@ player.on('error', (err) => console.error(err));
 | `clientId`        | `string`     | Conditional | -       |
 | `client`          | `JaaqClient` | Conditional | -       |
 | `baseUrl`         | `string`     | No          | -       |
+| `apiVersion`      | `string`     | Conditional | `v1`    |
 | `autoplay`        | `boolean`    | No          | `false` |
 | `controls`        | `boolean`    | No          | `true`  |
 | `width`           | `string`     | No          | `100%`  |
@@ -512,6 +516,7 @@ player.on('error', (err) => console.error(err));
 | `clientId`      | `string`        | Conditional | -       |
 | `client`        | `JaaqClient`    | Conditional | -       |
 | `baseUrl`       | `string`        | No          | -       |
+| `apiVersion`    | `string`        | No          | `v1`    |
 | `autoplay`      | `boolean`       | No          | `false` |
 | `showArrows`    | `boolean`       | No          | `true`  |
 | `showDots`      | `boolean`       | No          | `true`  |
@@ -694,6 +699,7 @@ import { VideoPlayer } from '@jaaq/jaaq-sdk-js/ui/react';
 | `width`      | No       | CSS width                 |
 | `height`     | No       | CSS height                |
 | `baseUrl`    | No       | API base URL              |
+| `apiVersion` | No       | API version               |
 
 ### postMessage protocol
 
@@ -769,6 +775,7 @@ Embed a collection of videos in a carousel format:
 | `collectionId`    | Yes      | Collection ID             |
 | `autoplay`        | No       | `true`, `false`, `1`, `0` |
 | `baseUrl`         | No       | API base URL              |
+| `apiVersion`      | No       | API version               |
 | `controls`        | No       | `true`, `false`, `1`, `0` |
 | `showLogo`        | No       | `true`, `false`, `1`, `0` |
 | `showTitle`       | No       | `true`, `false`, `1`, `0` |

package/dist/embed/embed-collection.html

@@ -118,6 +118,11 @@
           config.baseUrl = baseUrl;
         }
 
+        const apiVersion = params.get('apiVersion');
+        if (apiVersion) {
+          config.apiVersion = apiVersion;
+        }
+
         const showArrows = params.get('showArrows');
         if (showArrows !== null) {
           config.showArrows = showArrows === 'true' || showArrows === '1';
@@ -188,6 +193,10 @@
             player.setAttribute('base-url', config.baseUrl);
           }
 
+          if (config.apiVersion) {
+            player.setAttribute('api-version', config.apiVersion);
+          }
+
           if (config.autoplay) {
             player.setAttribute('autoplay', 'true');
           }
@@ -227,7 +236,8 @@
                 name: collection.name,
                 description: collection.description,
               },
-              videoCount: collection.videos?.length || 0,
+              videoCount:
+                collection.videos?.length || collection.videoGroups?.reduce((sum, group) => sum + (group.videos?.length || 0), 0) || 0,
             });
           });
 
@@ -317,8 +327,11 @@
 
     <script
       src="https://cdn-dev.jaaq.app/latest/jaaq-webcomponents-bundled.min.js"
-      onerror="console.error('[Embed Collection] Failed to load web component script'); showError('Failed to load collection player script');"
-      onload="console.log('[Embed Collection] Web component script loaded');"
+      onerror="
+        console.error('[Embed Collection] Failed to load web component script');
+        showError('Failed to load collection player script');
+      "
+      onload="console.log('[Embed Collection] Web component script loaded')"
     ></script>
   </body>
 </html>

package/dist/embed/embed.html

@@ -118,6 +118,11 @@
           config.baseUrl = baseUrl;
         }
 
+        const apiVersion = params.get('apiVersion');
+        if (apiVersion) {
+          config.apiVersion = apiVersion;
+        }
+
         const controls = params.get('controls');
         if (controls !== null) {
           config.controls = controls === 'true' || controls === '1';
@@ -186,6 +191,10 @@
             player.setAttribute('base-url', config.baseUrl);
           }
 
+          if (config.apiVersion) {
+            player.setAttribute('api-version', config.apiVersion);
+          }
+
           if (config.autoplay) {
             player.setAttribute('autoplay', 'true');
           }
@@ -326,8 +335,11 @@
 
     <script
       src="https://cdn-dev.jaaq.app/latest/jaaq-webcomponents-bundled.min.js"
-      onerror="console.error('[Embed] Failed to load web component script'); showError('Failed to load player script');"
-      onload="console.log('[Embed] Web component script loaded');"
+      onerror="
+        console.error('[Embed] Failed to load web component script');
+        showError('Failed to load player script');
+      "
+      onload="console.log('[Embed] Web component script loaded')"
     ></script>
   </body>
 </html>

package/dist/index.cjs

@@ -9,16 +9,22 @@ async function parseJson(res) {
         return undefined;
     return res.json();
 }
-function joinUrl(baseUrl, clientId, path) {
+function joinUrl(baseUrl, apiVersion, clientId, path) {
     // return path if it is an absolute URL
     if (/^https?:\/\//i.test(path))
         return path;
     const base = baseUrl.replace(/\/+$/, '');
     const relative = path.replace(/^\/+/, '');
-    return `${base}/b2b/v1/subscription/${encodeURIComponent(clientId)}${relative.startsWith('/') ? relative : `/${relative}`}`;
+    return `${base}/b2b/${apiVersion}/subscription/${encodeURIComponent(clientId)}${relative.startsWith('/') ? relative : `/${relative}`}`;
+}
+function convertToValidAPIVersion(version) {
+    const v = version.toLowerCase();
+    if (v === 'v1' || v === 'v2')
+        return v;
+    return 'v1'; // default to v1 if invalid version provided
 }
 function createHttpClient(config) {
-    const { baseUrl, apiKey, clientId, fetch: fetchImpl } = config;
+    const { baseUrl, apiKey, clientId, fetch: fetchImpl, apiVersion } = config;
     const f = fetchImpl ?? globalThis.fetch;
     if (!f) {
         throw new Error('No fetch implementation found. Provide one in SDKConfig.fetch for Node or custom environments.');
@@ -27,7 +33,7 @@ function createHttpClient(config) {
         'Content-Type': 'application/json',
         'x-api-key': apiKey,
     };
-    const fullUrl = (path) => joinUrl(baseUrl, clientId, path);
+    const fullUrl = (path) => joinUrl(baseUrl, convertToValidAPIVersion(apiVersion), clientId, path);
     const request = async (method, path, init, body) => {
         const reqInit = {
             method,
@@ -76,20 +82,51 @@ function createCollectionsResource(http) {
     };
 }
 
+function createVideosResourceV2(http) {
+    return {
+        async getById(id) {
+            const path = `/videos/${encodeURIComponent(id)}`;
+            const response = await http.get(path);
+            return response.video;
+        },
+    };
+}
+
+function createCollectionsResourceV2(http) {
+    return {
+        async list() {
+            const path = '/collections';
+            const response = await http.get(path);
+            return response.collections;
+        },
+        async getById(id) {
+            const path = `/collections/${encodeURIComponent(id)}`;
+            const response = await http.get(path);
+            return response.collection;
+        },
+    };
+}
+
 const BASE_URL = "https://api.jaaq.app";
 class JaaqClient {
     // Keep constructor private to enforce controlled instantiation.
-    constructor(http) {
-        this.videos = createVideosResource(http);
-        this.collections = createCollectionsResource(http);
+    constructor(http, apiVersion) {
+        if (apiVersion === 'v2') {
+            this.videos = createVideosResourceV2(http);
+            this.collections = createCollectionsResourceV2(http);
+        }
+        else {
+            this.videos = createVideosResource(http);
+            this.collections = createCollectionsResource(http);
+        }
     }
     /**
      * Public "friend" constructor that remains inside the class boundary.
      * This method is callable from the module-level build function
      * without exposing `new JaaqClient(...)` to consumers.
      */
-    static fromHttp(http) {
-        return new JaaqClient(http);
+    static fromHttp(http, apiVersion) {
+        return new JaaqClient(http, apiVersion);
     }
     /**
      * OO-friendly static initializer.
@@ -106,23 +143,32 @@ class JaaqClient {
 function createJaaqClient(config) {
     return buildClient(config);
 }
+function createJaaqClientV1(config) {
+    return createJaaqClient({ ...config, apiVersion: 'v1' });
+}
+function createJaaqClientV2(config) {
+    return createJaaqClient({ ...config, apiVersion: 'v2' });
+}
 /**
  * Single source of truth for constructing the client.
  * Both `createJaaqClient` and `JaaqClient.init` call this function.
  * The constructor stays private; instantiation is funneled via `JaaqClient.fromHttp`.
  */
 function buildClient(config) {
-    const { baseUrl = BASE_URL, apiKey, clientId, fetch: fetchImpl } = config;
+    const { baseUrl = BASE_URL, apiKey, clientId, fetch: fetchImpl, apiVersion = 'v1' } = config;
     const http = createHttpClient({
         baseUrl,
         apiKey,
         clientId,
         fetch: fetchImpl ?? globalThis.fetch,
+        apiVersion,
     });
-    return JaaqClient.fromHttp(http);
+    return JaaqClient.fromHttp(http, apiVersion);
 }
 
 exports.BASE_URL = BASE_URL;
 exports.JaaqClient = JaaqClient;
 exports.createJaaqClient = createJaaqClient;
+exports.createJaaqClientV1 = createJaaqClientV1;
+exports.createJaaqClientV2 = createJaaqClientV2;
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../src/core/httpClient.ts","../src/resources/videos.ts","../src/resources/collections.ts","../src/index.ts"],"sourcesContent":["export type FetchLike = typeof globalThis.fetch;\ntype RequestOptions = Parameters<typeof globalThis.fetch>[1];\ntype FetchResponse = Awaited<ReturnType<FetchLike>>;\n\nexport interface HttpClientConfig {\n  baseUrl: string;\n  apiKey: string;\n  clientId: string;\n  fetch?: FetchLike;\n  timeoutMs?: number;\n}\n\nexport interface HttpClient {\n  get<T>(_path: string, _init?: RequestOptions): Promise<T>;\n  post<T>(_path: string, _body?: unknown, _init?: RequestOptions): Promise<T>;\n  put<T>(_path: string, _body?: unknown, _init?: RequestOptions): Promise<T>;\n  patch<T>(_path: string, _body?: unknown, _init?: RequestOptions): Promise<T>;\n  delete<T>(_path: string, _init?: RequestOptions): Promise<T>;\n}\n\nasync function parseJson<T>(res: FetchResponse): Promise<T> {\n  if (!res.ok) {\n    const text = await res.text().catch(() => '');\n    throw new Error(`HTTP ${res.status}: ${text || res.statusText}`);\n  }\n  if (res.status === 204) return undefined as unknown as T;\n  return res.json() as Promise<T>;\n}\n\nfunction joinUrl(baseUrl: string, clientId: string, path: string): string {\n  // return path if it is an absolute URL\n  if (/^https?:\\/\\//i.test(path)) return path;\n  const base = baseUrl.replace(/\\/+$/, '');\n  const relative = path.replace(/^\\/+/, '');\n  return `${base}/b2b/v1/subscription/${encodeURIComponent(clientId)}${relative.startsWith('/') ? relative : `/${relative}`}`;\n}\n\nexport function createHttpClient(config: HttpClientConfig): HttpClient {\n  const { baseUrl, apiKey, clientId, fetch: fetchImpl } = config;\n\n  const f: FetchLike | undefined = fetchImpl ?? (globalThis.fetch as FetchLike | undefined);\n  if (!f) {\n    throw new Error('No fetch implementation found. Provide one in SDKConfig.fetch for Node or custom environments.');\n  }\n\n  const baseHeaders: Record<string, string> = {\n    'Content-Type': 'application/json',\n    'x-api-key': apiKey,\n  };\n\n  const fullUrl = (path: string) => joinUrl(baseUrl, clientId, path);\n\n  const request = async <T>(method: string, path: string, init?: RequestOptions, body?: unknown) => {\n    const reqInit: RequestOptions = {\n      method,\n      headers: {\n        ...baseHeaders,\n        ...(init?.headers as Record<string, string> | undefined),\n      },\n      ...init,\n    };\n    if (body !== undefined) reqInit.body = JSON.stringify(body);\n    const res = await f(fullUrl(path), reqInit);\n    return parseJson<T>(res);\n  };\n\n  return {\n    get: <T>(path: string, init?: RequestOptions) => request<T>('GET', path, init),\n    post: <T>(path: string, body?: unknown, init?: RequestOptions) => request<T>('POST', path, init, body),\n    put: <T>(path: string, body?: unknown, init?: RequestOptions) => request<T>('PUT', path, init, body),\n    patch: <T>(path: string, body?: unknown, init?: RequestOptions) => request<T>('PATCH', path, init, body),\n    delete: <T>(path: string, init?: RequestOptions) => request<T>('DELETE', path, init),\n  };\n}\n","import type { HttpClient } from '@core/httpClient';\nimport type { VideoDTO } from '@src/types/videos';\n\nexport type VideosResource = {\n  getById(_id: string): Promise<VideoDTO>;\n};\n\nexport function createVideosResource(http: HttpClient): VideosResource {\n  return {\n    async getById(id: string) {\n      const path = `/videos/${encodeURIComponent(id)}`;\n      const response = await http.get<{ video: VideoDTO }>(path);\n      return response.video;\n    },\n  };\n}\n","import type { HttpClient } from '@core/httpClient';\nimport type { CollectionDTO } from '@src/types/collection';\n\nexport type CollectionsResource = {\n  list(): Promise<CollectionDTO[]>;\n  getById(_id: string): Promise<CollectionDTO>;\n};\n\nexport function createCollectionsResource(http: HttpClient): CollectionsResource {\n  return {\n    async list() {\n      const path = '/collections';\n      const response = await http.get<{ collections: CollectionDTO[] }>(path);\n      return response.collections;\n    },\n    async getById(id: string) {\n      const path = `/collections/${encodeURIComponent(id)}`;\n      const response = await http.get<{ collection: CollectionDTO }>(path);\n      return response.collection;\n    },\n  };\n}\n","import { createHttpClient, type HttpClient, type FetchLike } from '@core/httpClient';\nimport { createVideosResource, type VideosResource } from '@resources/videos';\nimport { createCollectionsResource, type CollectionsResource } from '@resources/collections';\n\n// Public type exports for consumers (barrel)\nexport * from '@src/types';\n\nexport const BASE_URL = process.env.JAAQ_API_URL || 'https://api.jaaq.app';\n\nexport interface SDKConfig {\n  baseUrl?: string; // Pending to approve\n  apiKey: string; // Provided by backend per client\n  clientId: string; // Provided by each consuming company at init\n  fetch?: FetchLike; // Optional fetch injection (Node/custom envs) // Pending to approve\n  timeoutMs?: number;\n}\n\nexport class JaaqClient {\n  public readonly videos: VideosResource;\n  public readonly collections: CollectionsResource;\n\n  // Keep constructor private to enforce controlled instantiation.\n  private constructor(http: HttpClient) {\n    this.videos = createVideosResource(http);\n    this.collections = createCollectionsResource(http);\n  }\n\n  /**\n   * Public \"friend\" constructor that remains inside the class boundary.\n   * This method is callable from the module-level build function\n   * without exposing `new JaaqClient(...)` to consumers.\n   */\n  static fromHttp(http: HttpClient): JaaqClient {\n    return new JaaqClient(http);\n  }\n\n  /**\n   * OO-friendly static initializer.\n   * Delegates to the single source of truth: `buildClient`.\n   */\n  static init(config: SDKConfig): JaaqClient {\n    return buildClient(config);\n  }\n}\n\n/**\n * Canonical factory (idiomatic for JS/TS).\n * Delegates to the single source of truth: `buildClient`.\n */\nexport function createJaaqClient(config: SDKConfig): JaaqClient {\n  return buildClient(config);\n}\n\n/**\n * Single source of truth for constructing the client.\n * Both `createJaaqClient` and `JaaqClient.init` call this function.\n * The constructor stays private; instantiation is funneled via `JaaqClient.fromHttp`.\n */\nfunction buildClient(config: SDKConfig): JaaqClient {\n  const { baseUrl = BASE_URL, apiKey, clientId, fetch: fetchImpl } = config;\n\n  const http = createHttpClient({\n    baseUrl,\n    apiKey,\n    clientId,\n    fetch: fetchImpl ?? (globalThis.fetch as FetchLike | undefined),\n  });\n\n  return JaaqClient.fromHttp(http);\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.cjs","sources":["../src/core/httpClient.ts","../src/resources/v1/videos.ts","../src/resources/v1/collections.ts","../src/resources/v2/videos.ts","../src/resources/v2/collections.ts","../src/index.ts"],"sourcesContent":["export type FetchLike = typeof globalThis.fetch;\ntype RequestOptions = Parameters<typeof globalThis.fetch>[1];\ntype FetchResponse = Awaited<ReturnType<FetchLike>>;\n\nexport interface HttpClientConfig {\n  baseUrl: string;\n  apiVersion: string;\n  apiKey: string;\n  clientId: string;\n  fetch?: FetchLike;\n  timeoutMs?: number;\n}\n\nexport interface HttpClient {\n  get<T>(_path: string, _init?: RequestOptions): Promise<T>;\n  post<T>(_path: string, _body?: unknown, _init?: RequestOptions): Promise<T>;\n  put<T>(_path: string, _body?: unknown, _init?: RequestOptions): Promise<T>;\n  patch<T>(_path: string, _body?: unknown, _init?: RequestOptions): Promise<T>;\n  delete<T>(_path: string, _init?: RequestOptions): Promise<T>;\n}\n\nasync function parseJson<T>(res: FetchResponse): Promise<T> {\n  if (!res.ok) {\n    const text = await res.text().catch(() => '');\n    throw new Error(`HTTP ${res.status}: ${text || res.statusText}`);\n  }\n  if (res.status === 204) return undefined as unknown as T;\n  return res.json() as Promise<T>;\n}\n\nfunction joinUrl(baseUrl: string, apiVersion: string, clientId: string, path: string): string {\n  // return path if it is an absolute URL\n  if (/^https?:\\/\\//i.test(path)) return path;\n  const base = baseUrl.replace(/\\/+$/, '');\n  const relative = path.replace(/^\\/+/, '');\n  return `${base}/b2b/${apiVersion}/subscription/${encodeURIComponent(clientId)}${relative.startsWith('/') ? relative : `/${relative}`}`;\n}\n\nfunction convertToValidAPIVersion(version: string): string {\n  const v = version.toLowerCase();\n  if (v === 'v1' || v === 'v2') return v;\n  return 'v1'; // default to v1 if invalid version provided\n}\n\nexport function createHttpClient(config: HttpClientConfig): HttpClient {\n  const { baseUrl, apiKey, clientId, fetch: fetchImpl, apiVersion } = config;\n\n  const f: FetchLike | undefined = fetchImpl ?? (globalThis.fetch as FetchLike | undefined);\n  if (!f) {\n    throw new Error('No fetch implementation found. Provide one in SDKConfig.fetch for Node or custom environments.');\n  }\n\n  const baseHeaders: Record<string, string> = {\n    'Content-Type': 'application/json',\n    'x-api-key': apiKey,\n  };\n\n  const fullUrl = (path: string) => joinUrl(baseUrl, convertToValidAPIVersion(apiVersion), clientId, path);\n\n  const request = async <T>(method: string, path: string, init?: RequestOptions, body?: unknown) => {\n    const reqInit: RequestOptions = {\n      method,\n      headers: {\n        ...baseHeaders,\n        ...(init?.headers as Record<string, string> | undefined),\n      },\n      ...init,\n    };\n    if (body !== undefined) reqInit.body = JSON.stringify(body);\n    const res = await f(fullUrl(path), reqInit);\n    return parseJson<T>(res);\n  };\n\n  return {\n    get: <T>(path: string, init?: RequestOptions) => request<T>('GET', path, init),\n    post: <T>(path: string, body?: unknown, init?: RequestOptions) => request<T>('POST', path, init, body),\n    put: <T>(path: string, body?: unknown, init?: RequestOptions) => request<T>('PUT', path, init, body),\n    patch: <T>(path: string, body?: unknown, init?: RequestOptions) => request<T>('PATCH', path, init, body),\n    delete: <T>(path: string, init?: RequestOptions) => request<T>('DELETE', path, init),\n  };\n}\n","import type { HttpClient } from '@core/httpClient';\nimport type { VideoDTO } from '@src/types';\n\nexport type VideosResource = {\n  getById(_id: string): Promise<VideoDTO>;\n};\n\nexport function createVideosResource(http: HttpClient): VideosResource {\n  return {\n    async getById(id: string) {\n      const path = `/videos/${encodeURIComponent(id)}`;\n      const response = await http.get<{ video: VideoDTO }>(path);\n      return response.video;\n    },\n  };\n}\n","import type { HttpClient } from '@core/httpClient';\nimport type { CollectionDTO } from '@src/types';\n\nexport type CollectionsResource = {\n  list(): Promise<CollectionDTO[]>;\n  getById(_id: string): Promise<CollectionDTO>;\n};\n\nexport function createCollectionsResource(http: HttpClient): CollectionsResource {\n  return {\n    async list() {\n      const path = '/collections';\n      const response = await http.get<{ collections: CollectionDTO[] }>(path);\n      return response.collections;\n    },\n    async getById(id: string) {\n      const path = `/collections/${encodeURIComponent(id)}`;\n      const response = await http.get<{ collection: CollectionDTO }>(path);\n      return response.collection;\n    },\n  };\n}\n","import type { HttpClient } from '@core/httpClient';\nimport type { VideoV2DTO } from '@src/types';\n\nexport type VideosResourceV2 = {\n  getById(_id: string): Promise<VideoV2DTO>;\n};\n\nexport function createVideosResourceV2(http: HttpClient): VideosResourceV2 {\n  return {\n    async getById(id: string) {\n      const path = `/videos/${encodeURIComponent(id)}`;\n      const response = await http.get<{ video: VideoV2DTO }>(path);\n      return response.video;\n    },\n  };\n}\n","import type { HttpClient } from '@core/httpClient';\nimport type { CollectionV2DTO } from '@src/types';\n\nexport type CollectionsResourceV2 = {\n  list(): Promise<CollectionV2DTO[]>;\n  getById(_id: string): Promise<CollectionV2DTO>;\n};\n\nexport function createCollectionsResourceV2(http: HttpClient): CollectionsResourceV2 {\n  return {\n    async list() {\n      const path = '/collections';\n      const response = await http.get<{ collections: CollectionV2DTO[] }>(path);\n      return response.collections;\n    },\n    async getById(id: string) {\n      const path = `/collections/${encodeURIComponent(id)}`;\n      const response = await http.get<{ collection: CollectionV2DTO }>(path);\n      return response.collection;\n    },\n  };\n}\n","import { createHttpClient, type HttpClient, type FetchLike } from '@core/httpClient';\nimport {\n  createCollectionsResource,\n  createCollectionsResourceV2,\n  createVideosResource,\n  createVideosResourceV2,\n  type VideosResource,\n  type VideosResourceV2,\n  type CollectionsResource,\n  type CollectionsResourceV2,\n} from '@src/resources';\n\n// Public type exports for consumers (barrel)\nexport * from '@src/types';\n\nexport const BASE_URL = process.env.JAAQ_API_URL || 'https://api.jaaq.app';\n\nexport interface SDKConfig {\n  baseUrl?: string; // Pending to approve\n  apiVersion?: string; // Optional API version override (defaults to 'v1')\n  apiKey: string; // Provided by backend per client\n  clientId: string; // Provided by each consuming company at init\n  fetch?: FetchLike; // Optional fetch injection (Node/custom envs) // Pending to approve\n  timeoutMs?: number;\n}\n\nexport type V1 = {\n  videos: VideosResource;\n  collections: CollectionsResource;\n};\n\nexport type V2 = {\n  videos: VideosResourceV2;\n  collections: CollectionsResourceV2;\n};\n\nexport type ClientVersion = V1 | V2;\n\nexport class JaaqClient<T extends ClientVersion = V1> {\n  public readonly videos: T['videos'];\n  public readonly collections: T['collections'];\n\n  // Keep constructor private to enforce controlled instantiation.\n  private constructor(http: HttpClient, apiVersion: string) {\n    if (apiVersion === 'v2') {\n      this.videos = createVideosResourceV2(http);\n      this.collections = createCollectionsResourceV2(http);\n    } else {\n      this.videos = createVideosResource(http);\n      this.collections = createCollectionsResource(http);\n    }\n  }\n\n  /**\n   * Public \"friend\" constructor that remains inside the class boundary.\n   * This method is callable from the module-level build function\n   * without exposing `new JaaqClient(...)` to consumers.\n   */\n  static fromHttp<T extends ClientVersion = V1>(http: HttpClient, apiVersion: string): JaaqClient<T> {\n    return new JaaqClient(http, apiVersion);\n  }\n\n  /**\n   * OO-friendly static initializer.\n   * Delegates to the single source of truth: `buildClient`.\n   */\n  static init<T extends ClientVersion = V1>(config: SDKConfig): JaaqClient<T> {\n    return buildClient(config);\n  }\n}\n\n/**\n * Canonical factory (idiomatic for JS/TS).\n * Delegates to the single source of truth: `buildClient`.\n */\nexport function createJaaqClient<T extends ClientVersion = V1>(config: SDKConfig): JaaqClient<T> {\n  return buildClient(config);\n}\n\nexport function createJaaqClientV1(config: SDKConfig): JaaqClient<V1> {\n  return createJaaqClient({ ...config, apiVersion: 'v1' });\n}\n\nexport function createJaaqClientV2(config: SDKConfig): JaaqClient<V2> {\n  return createJaaqClient({ ...config, apiVersion: 'v2' });\n}\n\n/**\n * Single source of truth for constructing the client.\n * Both `createJaaqClient` and `JaaqClient.init` call this function.\n * The constructor stays private; instantiation is funneled via `JaaqClient.fromHttp`.\n */\nfunction buildClient<T extends ClientVersion = V1>(config: SDKConfig): JaaqClient<T> {\n  const { baseUrl = BASE_URL, apiKey, clientId, fetch: fetchImpl, apiVersion = 'v1' } = config;\n\n  const http = createHttpClient({\n    baseUrl,\n    apiKey,\n    clientId,\n    fetch: fetchImpl ?? (globalThis.fetch as FetchLike | undefined),\n    apiVersion,\n  });\n\n  return JaaqClient.fromHttp(http, apiVersion);\n}\n"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -8,6 +8,20 @@ interface HttpClient {
     delete<T>(_path: string, _init?: RequestOptions): Promise<T>;
 }
 
+type ISODateTimeString = string;
+interface ApiError {
+    description: string;
+    error: string;
+}
+
+interface Subtopic {
+    id: string;
+    name: string;
+    createdAt: ISODateTimeString;
+    modifiedAt: ISODateTimeString;
+    modifiedBy: ISODateTimeString;
+}
+
 type VideoDTO = {
     id: string;
     videoId: string;
@@ -27,10 +41,6 @@ type VideoDTO = {
     creatorBiography?: string;
 };
 
-type VideosResource = {
-    getById(_id: string): Promise<VideoDTO>;
-};
-
 type CollectionDTO = {
     id: string;
     name: string;
@@ -40,54 +50,101 @@ type CollectionDTO = {
     videos: VideoDTO[];
 };
 
-type CollectionsResource = {
-    list(): Promise<CollectionDTO[]>;
-    getById(_id: string): Promise<CollectionDTO>;
+type CreatorV2DTO = {
+    id: string;
+    name: string;
+    biography: string;
+    videoUrl: string;
+    type: string;
 };
 
-type ISODateTimeString = string;
-interface ApiError {
+type VideoV2DTO = {
+    id: string;
+    videoId: string;
+    question: string;
+    transcription: string;
+    subtitle: string;
+    videoUrl: string;
+    tags: string[];
+    severity: number | null;
+    duration: number;
     description: string;
-    error: string;
-}
+    creator?: CreatorV2DTO;
+};
 
-interface Subtopic {
+type VideoGroupV2DTO = {
+    id: string;
+    title: string;
+    videos: VideoV2DTO[];
+};
+
+type CollectionV2DTO = {
     id: string;
     name: string;
-    createdAt: ISODateTimeString;
-    modifiedAt: ISODateTimeString;
-    modifiedBy: ISODateTimeString;
-}
+    description: string;
+    imageUrl: string;
+    videoGroups: VideoGroupV2DTO[];
+};
+
+type VideosResource = {
+    getById(_id: string): Promise<VideoDTO>;
+};
+
+type CollectionsResource = {
+    list(): Promise<CollectionDTO[]>;
+    getById(_id: string): Promise<CollectionDTO>;
+};
+
+type VideosResourceV2 = {
+    getById(_id: string): Promise<VideoV2DTO>;
+};
+
+type CollectionsResourceV2 = {
+    list(): Promise<CollectionV2DTO[]>;
+    getById(_id: string): Promise<CollectionV2DTO>;
+};
 
 declare const BASE_URL: string;
 interface SDKConfig {
     baseUrl?: string;
+    apiVersion?: string;
     apiKey: string;
     clientId: string;
     fetch?: FetchLike;
     timeoutMs?: number;
 }
-declare class JaaqClient {
-    readonly videos: VideosResource;
-    readonly collections: CollectionsResource;
+type V1 = {
+    videos: VideosResource;
+    collections: CollectionsResource;
+};
+type V2 = {
+    videos: VideosResourceV2;
+    collections: CollectionsResourceV2;
+};
+type ClientVersion = V1 | V2;
+declare class JaaqClient<T extends ClientVersion = V1> {
+    readonly videos: T['videos'];
+    readonly collections: T['collections'];
     private constructor();
     /**
      * Public "friend" constructor that remains inside the class boundary.
      * This method is callable from the module-level build function
      * without exposing `new JaaqClient(...)` to consumers.
      */
-    static fromHttp(http: HttpClient): JaaqClient;
+    static fromHttp<T extends ClientVersion = V1>(http: HttpClient, apiVersion: string): JaaqClient<T>;
     /**
      * OO-friendly static initializer.
      * Delegates to the single source of truth: `buildClient`.
      */
-    static init(config: SDKConfig): JaaqClient;
+    static init<T extends ClientVersion = V1>(config: SDKConfig): JaaqClient<T>;
 }
 /**
  * Canonical factory (idiomatic for JS/TS).
  * Delegates to the single source of truth: `buildClient`.
  */
-declare function createJaaqClient(config: SDKConfig): JaaqClient;
+declare function createJaaqClient<T extends ClientVersion = V1>(config: SDKConfig): JaaqClient<T>;
+declare function createJaaqClientV1(config: SDKConfig): JaaqClient<V1>;
+declare function createJaaqClientV2(config: SDKConfig): JaaqClient<V2>;
 
-export { BASE_URL, JaaqClient, createJaaqClient };
-export type { ApiError, CollectionDTO, ISODateTimeString, SDKConfig, Subtopic, VideoDTO };
+export { BASE_URL, JaaqClient, createJaaqClient, createJaaqClientV1, createJaaqClientV2 };
+export type { ApiError, ClientVersion, CollectionDTO, CollectionV2DTO, CreatorV2DTO, ISODateTimeString, SDKConfig, Subtopic, V1, V2, VideoDTO, VideoGroupV2DTO, VideoV2DTO };

package/dist/index.mjs

@@ -7,16 +7,22 @@ async function parseJson(res) {
         return undefined;
     return res.json();
 }
-function joinUrl(baseUrl, clientId, path) {
+function joinUrl(baseUrl, apiVersion, clientId, path) {
     // return path if it is an absolute URL
     if (/^https?:\/\//i.test(path))
         return path;
     const base = baseUrl.replace(/\/+$/, '');
     const relative = path.replace(/^\/+/, '');
-    return `${base}/b2b/v1/subscription/${encodeURIComponent(clientId)}${relative.startsWith('/') ? relative : `/${relative}`}`;
+    return `${base}/b2b/${apiVersion}/subscription/${encodeURIComponent(clientId)}${relative.startsWith('/') ? relative : `/${relative}`}`;
+}
+function convertToValidAPIVersion(version) {
+    const v = version.toLowerCase();
+    if (v === 'v1' || v === 'v2')
+        return v;
+    return 'v1'; // default to v1 if invalid version provided
 }
 function createHttpClient(config) {
-    const { baseUrl, apiKey, clientId, fetch: fetchImpl } = config;
+    const { baseUrl, apiKey, clientId, fetch: fetchImpl, apiVersion } = config;
     const f = fetchImpl ?? globalThis.fetch;
     if (!f) {
         throw new Error('No fetch implementation found. Provide one in SDKConfig.fetch for Node or custom environments.');
@@ -25,7 +31,7 @@ function createHttpClient(config) {
         'Content-Type': 'application/json',
         'x-api-key': apiKey,
     };
-    const fullUrl = (path) => joinUrl(baseUrl, clientId, path);
+    const fullUrl = (path) => joinUrl(baseUrl, convertToValidAPIVersion(apiVersion), clientId, path);
     const request = async (method, path, init, body) => {
         const reqInit = {
             method,
@@ -74,20 +80,51 @@ function createCollectionsResource(http) {
     };
 }
 
+function createVideosResourceV2(http) {
+    return {
+        async getById(id) {
+            const path = `/videos/${encodeURIComponent(id)}`;
+            const response = await http.get(path);
+            return response.video;
+        },
+    };
+}
+
+function createCollectionsResourceV2(http) {
+    return {
+        async list() {
+            const path = '/collections';
+            const response = await http.get(path);
+            return response.collections;
+        },
+        async getById(id) {
+            const path = `/collections/${encodeURIComponent(id)}`;
+            const response = await http.get(path);
+            return response.collection;
+        },
+    };
+}
+
 const BASE_URL = "https://api.jaaq.app";
 class JaaqClient {
     // Keep constructor private to enforce controlled instantiation.
-    constructor(http) {
-        this.videos = createVideosResource(http);
-        this.collections = createCollectionsResource(http);
+    constructor(http, apiVersion) {
+        if (apiVersion === 'v2') {
+            this.videos = createVideosResourceV2(http);
+            this.collections = createCollectionsResourceV2(http);
+        }
+        else {
+            this.videos = createVideosResource(http);
+            this.collections = createCollectionsResource(http);
+        }
     }
     /**
      * Public "friend" constructor that remains inside the class boundary.
      * This method is callable from the module-level build function
      * without exposing `new JaaqClient(...)` to consumers.
      */
-    static fromHttp(http) {
-        return new JaaqClient(http);
+    static fromHttp(http, apiVersion) {
+        return new JaaqClient(http, apiVersion);
     }
     /**
      * OO-friendly static initializer.
@@ -104,21 +141,28 @@ class JaaqClient {
 function createJaaqClient(config) {
     return buildClient(config);
 }
+function createJaaqClientV1(config) {
+    return createJaaqClient({ ...config, apiVersion: 'v1' });
+}
+function createJaaqClientV2(config) {
+    return createJaaqClient({ ...config, apiVersion: 'v2' });
+}
 /**
  * Single source of truth for constructing the client.
  * Both `createJaaqClient` and `JaaqClient.init` call this function.
  * The constructor stays private; instantiation is funneled via `JaaqClient.fromHttp`.
  */
 function buildClient(config) {
-    const { baseUrl = BASE_URL, apiKey, clientId, fetch: fetchImpl } = config;
+    const { baseUrl = BASE_URL, apiKey, clientId, fetch: fetchImpl, apiVersion = 'v1' } = config;
     const http = createHttpClient({
         baseUrl,
         apiKey,
         clientId,
         fetch: fetchImpl ?? globalThis.fetch,
+        apiVersion,
     });
-    return JaaqClient.fromHttp(http);
+    return JaaqClient.fromHttp(http, apiVersion);
 }
 
-export { BASE_URL, JaaqClient, createJaaqClient };
+export { BASE_URL, JaaqClient, createJaaqClient, createJaaqClientV1, createJaaqClientV2 };
 //# sourceMappingURL=index.mjs.map