@jaaq/jaaq-sdk-js 1.1.1 → 1.2.0-dev-ec79f7e-20260605

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","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.mjs","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/jaaq-sdk.min.js

@@ -1,2 +1,2 @@
-!function(t,e){"object"==typeof exports&&"undefined"!=typeof module?e(exports):"function"==typeof define&&define.amd?define(["exports"],e):e((t="undefined"!=typeof globalThis?globalThis:t||self).JaaqSDK={})}(this,function(t){"use strict";function e(t){const{baseUrl:e,apiKey:n,clientId:o,fetch:i}=t,c=i??globalThis.fetch;if(!c)throw new Error("No fetch implementation found. Provide one in SDKConfig.fetch for Node or custom environments.");const s={"Content-Type":"application/json","x-api-key":n},r=t=>function(t,e,n){if(/^https?:\/\//i.test(n))return n;const o=t.replace(/\/+$/,""),i=n.replace(/^\/+/,"");return`${o}/b2b/v1/subscription/${encodeURIComponent(e)}${i.startsWith("/")?i:`/${i}`}`}(e,o,t),a=async(t,e,n,o)=>{const i={method:t,headers:{...s,...n?.headers},...n};void 0!==o&&(i.body=JSON.stringify(o));return async function(t){if(!t.ok){const e=await t.text().catch(()=>"");throw new Error(`HTTP ${t.status}: ${e||t.statusText}`)}if(204!==t.status)return t.json()}(await c(r(e),i))};return{get:(t,e)=>a("GET",t,e),post:(t,e,n)=>a("POST",t,n,e),put:(t,e,n)=>a("PUT",t,n,e),patch:(t,e,n)=>a("PATCH",t,n,e),delete:(t,e)=>a("DELETE",t,e)}}const n="https://api.jaaq.app";class o{constructor(t){this.videos=function(t){return{async getById(e){const n=`/videos/${encodeURIComponent(e)}`;return(await t.get(n)).video}}}(t),this.collections=function(t){return{list:async()=>(await t.get("/collections")).collections,async getById(e){const n=`/collections/${encodeURIComponent(e)}`;return(await t.get(n)).collection}}}(t)}static fromHttp(t){return new o(t)}static init(t){return i(t)}}function i(t){const{baseUrl:i=n,apiKey:c,clientId:s,fetch:r}=t,a=e({baseUrl:i,apiKey:c,clientId:s,fetch:r??globalThis.fetch});return o.fromHttp(a)}t.BASE_URL=n,t.JaaqClient=o,t.createJaaqClient=function(t){return i(t)}});
+!function(t,e){"object"==typeof exports&&"undefined"!=typeof module?e(exports):"function"==typeof define&&define.amd?define(["exports"],e):e((t="undefined"!=typeof globalThis?globalThis:t||self).JaaqSDK={})}(this,function(t){"use strict";function e(t){const{baseUrl:e,apiKey:n,clientId:o,fetch:i,apiVersion:c}=t,s=i??globalThis.fetch;if(!s)throw new Error("No fetch implementation found. Provide one in SDKConfig.fetch for Node or custom environments.");const r={"Content-Type":"application/json","x-api-key":n},a=t=>function(t,e,n,o){if(/^https?:\/\//i.test(o))return o;const i=t.replace(/\/+$/,""),c=o.replace(/^\/+/,"");return`${i}/b2b/${e}/subscription/${encodeURIComponent(n)}${c.startsWith("/")?c:`/${c}`}`}(e,function(t){const e=t.toLowerCase();return"v1"===e||"v2"===e?e:"v1"}(c),o,t),l=async(t,e,n,o)=>{const i={method:t,headers:{...r,...n?.headers},...n};void 0!==o&&(i.body=JSON.stringify(o));return async function(t){if(!t.ok){const e=await t.text().catch(()=>"");throw new Error(`HTTP ${t.status}: ${e||t.statusText}`)}if(204!==t.status)return t.json()}(await s(a(e),i))};return{get:(t,e)=>l("GET",t,e),post:(t,e,n)=>l("POST",t,n,e),put:(t,e,n)=>l("PUT",t,n,e),patch:(t,e,n)=>l("PATCH",t,n,e),delete:(t,e)=>l("DELETE",t,e)}}const n="https://api.jaaq.app";class o{constructor(t,e){"v2"===e?(this.videos=function(t){return{async getById(e){const n=`/videos/${encodeURIComponent(e)}`;return(await t.get(n)).video}}}(t),this.collections=function(t){return{list:async()=>(await t.get("/collections")).collections,async getById(e){const n=`/collections/${encodeURIComponent(e)}`;return(await t.get(n)).collection}}}(t)):(this.videos=function(t){return{async getById(e){const n=`/videos/${encodeURIComponent(e)}`;return(await t.get(n)).video}}}(t),this.collections=function(t){return{list:async()=>(await t.get("/collections")).collections,async getById(e){const n=`/collections/${encodeURIComponent(e)}`;return(await t.get(n)).collection}}}(t))}static fromHttp(t,e){return new o(t,e)}static init(t){return c(t)}}function i(t){return c(t)}function c(t){const{baseUrl:i=n,apiKey:c,clientId:s,fetch:r,apiVersion:a="v1"}=t,l=e({baseUrl:i,apiKey:c,clientId:s,fetch:r??globalThis.fetch,apiVersion:a});return o.fromHttp(l,a)}t.BASE_URL=n,t.JaaqClient=o,t.createJaaqClient=i,t.createJaaqClientV1=function(t){return i({...t,apiVersion:"v1"})},t.createJaaqClientV2=function(t){return i({...t,apiVersion:"v2"})}});
 //# sourceMappingURL=jaaq-sdk.min.js.map

package/dist/jaaq-sdk.min.js.map

@@ -1 +1 @@
-{"version":3,"file":"jaaq-sdk.min.js","sources":["../src/core/httpClient.ts","../src/index.ts","../src/resources/videos.ts","../src/resources/collections.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 { 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","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"],"names":["createHttpClient","config","baseUrl","apiKey","clientId","fetch","fetchImpl","f","globalThis","Error","baseHeaders","fullUrl","path","test","base","replace","relative","encodeURIComponent","startsWith","joinUrl","request","async","method","init","body","reqInit","headers","undefined","JSON","stringify","res","ok","text","catch","status","statusText","json","parseJson","get","post","put","patch","delete","BASE_URL","JaaqClient","constructor","http","this","videos","getById","id","video","createVideosResource","collections","collection","createCollectionsResource","fromHttp","buildClient"],"mappings":"8OAqCM,SAAUA,EAAiBC,GAC/B,MAAMC,QAAEA,EAAOC,OAAEA,EAAMC,SAAEA,EAAUC,MAAOC,GAAcL,EAElDM,EAA2BD,GAAcE,WAAWH,MAC1D,IAAKE,EACH,MAAM,IAAIE,MAAM,kGAGlB,MAAMC,EAAsC,CAC1C,eAAgB,mBAChB,YAAaP,GAGTQ,EAAWC,GArBnB,SAAiBV,EAAiBE,EAAkBQ,GAElD,GAAI,gBAAgBC,KAAKD,GAAO,OAAOA,EACvC,MAAME,EAAOZ,EAAQa,QAAQ,OAAQ,IAC/BC,EAAWJ,EAAKG,QAAQ,OAAQ,IACtC,MAAO,GAAGD,yBAA4BG,mBAAmBb,KAAYY,EAASE,WAAW,KAAOF,EAAW,IAAIA,KACjH,CAeoCG,CAAQjB,EAASE,EAAUQ,GAEvDQ,EAAUC,MAAUC,EAAgBV,EAAcW,EAAuBC,KAC7E,MAAMC,EAA0B,CAC9BH,SACAI,QAAS,IACJhB,KACCa,GAAMG,YAETH,QAEQI,IAATH,IAAoBC,EAAQD,KAAOI,KAAKC,UAAUL,IAEtD,OA3CJH,eAA4BS,GAC1B,IAAKA,EAAIC,GAAI,CACX,MAAMC,QAAaF,EAAIE,OAAOC,MAAM,IAAM,IAC1C,MAAM,IAAIxB,MAAM,QAAQqB,EAAII,WAAWF,GAAQF,EAAIK,aACrD,CACA,GAAmB,MAAfL,EAAII,OACR,OAAOJ,EAAIM,MACb,CAoCWC,OADW9B,EAAEI,EAAQC,GAAOa,KAIrC,MAAO,CACLa,IAAK,CAAI1B,EAAcW,IAA0BH,EAAW,MAAOR,EAAMW,GACzEgB,KAAM,CAAI3B,EAAcY,EAAgBD,IAA0BH,EAAW,OAAQR,EAAMW,EAAMC,GACjGgB,IAAK,CAAI5B,EAAcY,EAAgBD,IAA0BH,EAAW,MAAOR,EAAMW,EAAMC,GAC/FiB,MAAO,CAAI7B,EAAcY,EAAgBD,IAA0BH,EAAW,QAASR,EAAMW,EAAMC,GACnGkB,OAAQ,CAAI9B,EAAcW,IAA0BH,EAAW,SAAUR,EAAMW,GAEnF,CClEO,MAAMoB,EAAW,6BAUXC,EAKX,WAAAC,CAAoBC,GAClBC,KAAKC,OChBH,SAA+BF,GACnC,MAAO,CACL,aAAMG,CAAQC,GACZ,MAAMtC,EAAO,WAAWK,mBAAmBiC,KAE3C,aADuBJ,EAAKR,IAAyB1B,IACrCuC,KAClB,EAEJ,CDQkBC,CAAqBN,GACnCC,KAAKM,YEhBH,SAAoCP,GACxC,MAAO,CACLzB,KAAU,gBAEeyB,EAAKR,IADf,iBAEGe,YAElB,aAAMJ,CAAQC,GACZ,MAAMtC,EAAO,gBAAgBK,mBAAmBiC,KAEhD,aADuBJ,EAAKR,IAAmC1B,IAC/C0C,UAClB,EAEJ,CFGuBC,CAA0BT,EAC/C,CAOA,eAAOU,CAASV,GACd,OAAO,IAAIF,EAAWE,EACxB,CAMA,WAAOvB,CAAKtB,GACV,OAAOwD,EAAYxD,EACrB,EAgBF,SAASwD,EAAYxD,GACnB,MAAMC,QAAEA,EAAUyC,EAAQxC,OAAEA,EAAMC,SAAEA,EAAUC,MAAOC,GAAcL,EAE7D6C,EAAO9C,EAAiB,CAC5BE,UACAC,SACAC,WACAC,MAAOC,GAAcE,WAAWH,QAGlC,OAAOuC,EAAWY,SAASV,EAC7B,gDApBM,SAA2B7C,GAC/B,OAAOwD,EAAYxD,EACrB"}
+{"version":3,"file":"jaaq-sdk.min.js","sources":["../src/core/httpClient.ts","../src/index.ts","../src/resources/v2/videos.ts","../src/resources/v2/collections.ts","../src/resources/v1/videos.ts","../src/resources/v1/collections.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 { 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","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 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"],"names":["createHttpClient","config","baseUrl","apiKey","clientId","fetch","fetchImpl","apiVersion","f","globalThis","Error","baseHeaders","fullUrl","path","test","base","replace","relative","encodeURIComponent","startsWith","joinUrl","version","v","toLowerCase","convertToValidAPIVersion","request","async","method","init","body","reqInit","headers","undefined","JSON","stringify","res","ok","text","catch","status","statusText","json","parseJson","get","post","put","patch","delete","BASE_URL","JaaqClient","constructor","http","this","videos","getById","id","video","createVideosResourceV2","collections","collection","createCollectionsResourceV2","createVideosResource","createCollectionsResource","fromHttp","buildClient","createJaaqClient"],"mappings":"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"}

package/dist/ui/index.cjs

@@ -11,16 +11,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.');
@@ -29,7 +35,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,
@@ -78,20 +84,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.
@@ -114,14 +151,15 @@ function createJaaqClient(config) {
  * 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);
 }
 
 /**
@@ -4053,6 +4091,7 @@ class JaaqCollectionPlayer {
                 apiKey: config.apiKey,
                 clientId: config.clientId,
                 baseUrl: config.baseUrl || BASE_URL,
+                apiVersion: config.apiVersion,
             });
         }
         else {
@@ -4084,7 +4123,8 @@ class JaaqCollectionPlayer {
                 throw new Error('Client is not initialized');
             }
             this.collectionData = await this.client.collections.getById(collectionId);
-            if (!this.collectionData.videos || this.collectionData.videos.length === 0) {
+            const videos = this.getVideosFromCollection(this.collectionData);
+            if (videos.length === 0) {
                 this.emitError(new Error('No videos found in collection'));
                 return;
             }
@@ -4105,6 +4145,21 @@ class JaaqCollectionPlayer {
       </div>
     `;
     }
+    getVideosFromCollection(collection) {
+        if (collection.videos && collection.videos.length > 0) {
+            return collection.videos;
+        }
+        if (collection.videoGroups && collection.videoGroups.length > 0) {
+            const videos = [];
+            collection.videoGroups.forEach((group) => {
+                if (group.videos && group.videos.length > 0) {
+                    videos.push(...group.videos);
+                }
+            });
+            return videos;
+        }
+        return [];
+    }
     renderCarousel() {
         if (!this.playerElement || !this.collectionData)
             return;
@@ -4115,7 +4170,8 @@ class JaaqCollectionPlayer {
         track.className = 'splide__track';
         const list = document.createElement('ul');
         list.className = 'splide__list';
-        this.collectionData.videos.forEach((video) => {
+        const videos = this.getVideosFromCollection(this.collectionData);
+        videos.forEach((video) => {
             const slide = document.createElement('li');
             slide.className = 'splide__slide';
             const player = document.createElement('jaaq-video-player');
@@ -4126,6 +4182,8 @@ class JaaqCollectionPlayer {
                 player.setAttribute('client-id', this.config.clientId);
             if (this.config.baseUrl)
                 player.setAttribute('base-url', this.config.baseUrl);
+            if (this.config.apiVersion)
+                player.setAttribute('api-version', this.config.apiVersion);
             player.setAttribute('autoplay', 'false');
             player.setAttribute('width', '100%');
             if (this.config.videoSettings) {
@@ -4195,7 +4253,8 @@ class JaaqCollectionPlayer {
         this.splide.on('moved', (newIndex) => {
             this.handleSlideChange(newIndex);
             if (this.collectionData) {
-                this.emit('slidechange', { index: newIndex, video: this.collectionData.videos[newIndex] });
+                const videos = this.getVideosFromCollection(this.collectionData);
+                this.emit('slidechange', { index: newIndex, video: videos[newIndex] });
             }
         });
         this.splide.mount();
@@ -4340,6 +4399,10 @@ function parseDataAttributes(element) {
     if (baseUrl) {
         config.baseUrl = baseUrl;
     }
+    const apiVersion = element.getAttribute('data-api-version');
+    if (apiVersion) {
+        config.apiVersion = apiVersion;
+    }
     const className = element.getAttribute('data-class-name');
     if (className) {
         config.className = className;
@@ -4522,6 +4585,21 @@ class JaaqCollectionPlayerElement extends HTMLElement {
             return defaultValue;
         return v !== 'false';
     }
+    getVideosFromCollection(collection) {
+        if (collection.videos && collection.videos.length > 0) {
+            return collection.videos;
+        }
+        if (collection.videoGroups && collection.videoGroups.length > 0) {
+            const videos = [];
+            collection.videoGroups.forEach((group) => {
+                if (group.videos && group.videos.length > 0) {
+                    videos.push(...group.videos);
+                }
+            });
+            return videos;
+        }
+        return [];
+    }
     render() {
         if (!this.shadowRoot)
             return;
@@ -4548,6 +4626,7 @@ class JaaqCollectionPlayerElement extends HTMLElement {
         const apiKey = this.getAttribute('api-key');
         const clientId = this.getAttribute('client-id');
         const baseUrl = this.getAttribute('base-url') || undefined;
+        const apiVersion = this.getAttribute('api-version') || undefined;
         if (!this.clientInstance && !apiKey && !clientId) {
             this.emitError(new Error('Either client property or api-key and client-id attributes are required'));
             return;
@@ -4559,9 +4638,11 @@ class JaaqCollectionPlayerElement extends HTMLElement {
                     apiKey: apiKey,
                     clientId: clientId,
                     baseUrl: baseUrl || BASE_URL,
+                    apiVersion: apiVersion,
                 });
             this.collectionData = await client.collections.getById(collectionId);
-            if (!this.collectionData.videos || this.collectionData.videos.length === 0) {
+            const videos = this.getVideosFromCollection(this.collectionData);
+            if (videos.length === 0) {
                 this.emitError(new Error('No videos found in collection'));
                 return;
             }
@@ -4609,7 +4690,8 @@ class JaaqCollectionPlayerElement extends HTMLElement {
                 console.warn('[CollectionPlayer] Failed to parse video-settings attribute', e);
             }
         }
-        this.collectionData.videos.forEach((video) => {
+        const videos = this.getVideosFromCollection(this.collectionData);
+        videos.forEach((video) => {
             const slide = document.createElement('li');
             slide.className = 'splide__slide';
             const player = document.createElement('jaaq-video-player');
@@ -4691,8 +4773,9 @@ class JaaqCollectionPlayerElement extends HTMLElement {
                 Components: this.splide?.Components,
             });
             this.handleSlideChange(newIndex);
+            const videos = this.collectionData ? this.getVideosFromCollection(this.collectionData) : [];
             this.dispatchEvent(new CustomEvent('jaaq:collection:slidechange', {
-                detail: { index: newIndex, video: this.collectionData?.videos[newIndex] },
+                detail: { index: newIndex, video: videos[newIndex] },
                 bubbles: true,
                 composed: true,
             }));
@@ -4974,6 +5057,7 @@ class JaaqVideoPlayerElement extends HTMLElement {
         const apiKey = this.getAttribute('api-key');
         const clientId = this.getAttribute('client-id');
         const baseUrl = this.getAttribute('base-url') || undefined;
+        const apiVersion = this.getAttribute('api-version') || undefined;
         const autoplay = this.hasAttribute('autoplay') && this.getAttribute('autoplay') !== 'false';
         const controls = !this.hasAttribute('controls') || this.getAttribute('controls') !== 'false';
         const showLogo = !this.hasAttribute('show-logo') || this.getAttribute('show-logo') !== 'false';
@@ -4993,6 +5077,7 @@ class JaaqVideoPlayerElement extends HTMLElement {
                 clientId: clientId ?? undefined,
                 client: this.clientInstance || undefined,
                 baseUrl,
+                apiVersion,
                 autoplay,
                 controls,
                 showLogo,