@jaaq/jaaq-sdk-js 0.0.1

package/README.md

@@ -0,0 +1,210 @@
+# JAAQ TypeScript SDK (`jaaq-sdk-js`)
+
+A lightweight, type-safe SDK for interacting with the **JAAQ API (v1)**.  
+It provides a simple client with typed resources generated from the backend OpenAPI specification.
+
+---
+
+## Project Structure
+
+- src/
+  - core/ # HTTP client
+  - gen/ # Generated OpenAPI types
+  - resources/ # API resources (e.g., videos)
+  - index.ts
+- test/
+  - handlers/
+  - mocks/
+  - setup.ts
+
+## Relative paths:
+
+```bash
+"@src/*": ["src/*"],
+"@core/*": ["src/core/*"],
+"@resources/*": ["src/resources/*"],
+"@gen/*": ["src/gen/*"],
+"@tests/*": ["tests/*"]
+```
+
+## Installation
+
+```bash
+pnpm install
+```
+
+## Build
+
+```bash
+pnpm build
+```
+
+## Run tests
+
+```bash
+pnpm test
+```
+
+or
+
+```bash
+pnpm test:watch
+```
+
+## Create types
+
+Once we have the last openApi.json file from the Back-end
+
+```bash
+pnpm openapi:gen
+```
+
+And then:
+
+```bash
+import type { paths, components } from '@gen/openapi';
+
+type GetVideosResponse = components['schemas']['GetVideosResponse'];
+type GetVideosParams = paths['/videos']['get']['parameters']['query'];
+
+```
+
+## Configuration options:
+
+- apiKey (required) – Provided by backend.
+- clientId (required) – Provided by consuming company.
+- baseUrl (optional) – Defaults to https://api.jaaq.app/v1.
+- fetch (optional) – Custom fetch implementation (for Node < 18).
+- timeoutMs (optional) – Request timeout in ms.
+- headers (optional) – Extra headers for all requests.
+- apiKeyHeaderName (optional) – Defaults to x-api-key.
+
+## Linting
+
+- ESLint (code rules) and Prettier (formatting).
+- On save: use the Prettier editor extension (Format on Save).
+- Pre-commit: lint-staged runs ESLint --fix on TS/JS and Prettier on staged files.
+- Manual:
+  - `pnpm lint` / `pnpm lint:fix`
+  - `pnpm format` / `pnpm format:check`
+- Commit messages: validated by commitlint (Husky commit-msg hook).
+- PRs: CI runs `pnpm lint` and `pnpm format:check` on pull_request.
+
+## Usage:
+
+#### install module:
+
+![Install module screenshot](./docs/install-sdk.png)
+
+#### classic mode:
+
+```bash
+// Import module
+import { JaaqClient } from "jaaq-sdk-js";
+
+const client = JaaqClient.init({
+  apiKey: '<YOUR_API_KEY>',
+  clientId: '<YOUR_CLIENT_ID>',
+});
+```
+
+#### JS mode:
+
+```bash
+// Import module
+import { createJaaqClient } from "jaaq-sdk-js";
+
+const client = createJaaqClient({
+  apiKey: '<YOUR_API_KEY>',
+  clientId: '<YOUR_CLIENT_ID>',
+});
+```
+
+#### Access to the different resources:
+
+```bash
+client.videos.getById('xxxxxx')
+```
+
+or
+
+```bash
+client.collections.list()
+```
+
+#### Ex: Getting and displaying a video
+
+```bash
+import { useEffect, useRef } from "react";
+import { createJaaqClient } from "jaaq-sdk-js";
+
+const API_KEY = import.meta.env.VITE_JAAQ_API_KEY;
+const CLIENT_ID = import.meta.env.VITE_JAAQ_CLIENT_ID;
+
+export default function VideoExample({ id }: { id: string }) {
+  const videoRef = useRef<HTMLVideoElement | null>(null);
+
+  useEffect(() => {
+    (async () => {
+      const client = createJaaqClient({
+        apiKey: API_KEY,
+        clientId: CLIENT_ID
+      });
+      const resp = await client.videos.getById(id);
+      const url = resp.video.videoUrl;
+      videoRef.current.src = url;
+    })();
+  }, [id]);
+
+  return (
+    <video
+      ref={videoRef}
+      autoPlay
+      controls
+    />;
+  )
+}
+```
+
+#### If extension is .m3u8
+
+```bash
+import { useEffect, useRef } from "react";
+import { createJaaqClient } from "jaaq-sdk-js";
+import Hls from "hls.js";
+
+const API_KEY = import.meta.env.VITE_JAAQ_API_KEY!;
+const CLIENT_ID = import.meta.env.VITE_JAAQ_CLIENT_ID!;
+
+export default function VideoExample({ id }: { id: string }) {
+  const videoRef = useRef<HTMLVideoElement | null>(null);
+
+  useEffect(() => {
+    let hls: Hls | undefined;
+
+    (async () => {
+      const client = createJaaqClient({ apiKey: API_KEY, clientId: CLIENT_ID });
+      const resp = await client.videos.getById(id);
+      const url = resp.video.videoUrl; // e.g. https://.../video.m3u8
+      const video = videoRef.current;
+      if (!video || !url) return;
+
+      if (Hls.isSupported()) {
+        hls = new Hls();
+        hls.loadSource(url);
+        hls.attachMedia(video);
+      }
+    })();
+
+    return () => hls?.destroy();
+  }, [id]);
+
+  return (
+    <video
+      ref={videoRef}
+      autoPlay
+      controls
+    />;
+  )
+}
+```

package/dist/index.cjs

@@ -0,0 +1,134 @@
+'use strict';
+
+async function parseJson(res) {
+    if (!res.ok) {
+        const text = await res.text().catch(() => '');
+        throw new Error(`HTTP ${res.status}: ${text || res.statusText}`);
+    }
+    if (res.status === 204)
+        return undefined;
+    return res.json();
+}
+/**
+ * Join base URL and path avoiding duplicate slashes.
+ * - Preserves absolute paths (http/https) as-is.
+ * - Trims trailing slashes from base and leading slashes from path.
+ */
+function joinUrl(baseUrl, 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}/${relative}`;
+}
+function createHttpClient(config) {
+    const { baseUrl, apiKey, clientId, fetch: fetchImpl, headers, apiKeyHeaderName = 'x-api-key' } = 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.');
+    }
+    const baseHeaders = {
+        'Content-Type': 'application/json',
+        [apiKeyHeaderName]: apiKey,
+        'x-client-id': clientId,
+        ...headers,
+    };
+    const fullUrl = (path) => joinUrl(baseUrl, path);
+    const request = async (method, path, init, body) => {
+        const reqInit = {
+            method,
+            headers: {
+                ...baseHeaders,
+                ...init?.headers,
+            },
+            ...init,
+        };
+        if (body !== undefined)
+            reqInit.body = JSON.stringify(body);
+        const res = await f(fullUrl(path), reqInit);
+        return parseJson(res);
+    };
+    return {
+        get: (path, init) => request('GET', path, init),
+        post: (path, body, init) => request('POST', path, init, body),
+        put: (path, body, init) => request('PUT', path, init, body),
+        patch: (path, body, init) => request('PATCH', path, init, body),
+        delete: (path, init) => request('DELETE', path, init),
+    };
+}
+
+function createVideosResource(http) {
+    return {
+        async getById(id) {
+            const path = `b2b/videos/${encodeURIComponent(id)}`;
+            return http.get(path);
+        },
+    };
+}
+
+function createCollectionsResource(http) {
+    return {
+        async list() {
+            const path = 'b2b/collections';
+            return http.get(path);
+        },
+        async getById(id) {
+            const path = `b2b/collections/${encodeURIComponent(id)}`;
+            return http.get(path);
+        },
+    };
+}
+
+const BASE_URL = undefined;
+class JaaqClient {
+    // Keep constructor private to enforce controlled instantiation.
+    constructor(http) {
+        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);
+    }
+    /**
+     * OO-friendly static initializer.
+     * Delegates to the single source of truth: `buildClient`.
+     */
+    static init(config) {
+        return buildClient(config);
+    }
+}
+/**
+ * Canonical factory (idiomatic for JS/TS).
+ * Delegates to the single source of truth: `buildClient`.
+ */
+function createJaaqClient(config) {
+    return buildClient(config);
+}
+/**
+ * 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, headers, apiKeyHeaderName = 'x-api-key' } = config;
+    const http = createHttpClient({
+        baseUrl,
+        apiKey,
+        clientId,
+        apiKeyHeaderName,
+        fetch: fetchImpl ?? globalThis.fetch,
+        headers,
+    });
+    return JaaqClient.fromHttp(http);
+}
+
+exports.BASE_URL = BASE_URL;
+exports.JaaqClient = JaaqClient;
+exports.createJaaqClient = createJaaqClient;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +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  apiKeyHeaderName?: string;\n  fetch?: FetchLike;\n  timeoutMs?: number;\n  headers?: Record<string, string>;\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\n/**\n * Join base URL and path avoiding duplicate slashes.\n * - Preserves absolute paths (http/https) as-is.\n * - Trims trailing slashes from base and leading slashes from path.\n */\nfunction joinUrl(baseUrl: 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}/${relative}`;\n}\n\nexport function createHttpClient(config: HttpClientConfig): HttpClient {\n  const { baseUrl, apiKey, clientId, fetch: fetchImpl, headers, apiKeyHeaderName = 'x-api-key' } = 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    [apiKeyHeaderName]: apiKey,\n    'x-client-id': clientId,\n    ...headers,\n  };\n\n  const fullUrl = (path: string) => joinUrl(baseUrl, 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 { Video } from '@src/types/videos';\n\nexport interface VideosResource {\n  getById(_id: string): Promise<Video>;\n}\n\nexport function createVideosResource(http: HttpClient): VideosResource {\n  return {\n    async getById(id: string) {\n      const path = `b2b/videos/${encodeURIComponent(id)}`;\n      return http.get<Video>(path);\n    },\n  };\n}\n","import type { HttpClient } from '@core/httpClient';\nimport type { Collection } from '@src/types/collection';\n\nexport interface CollectionsResource {\n  list(): Promise<Collection[]>;\n  getById(_id: string): Promise<Collection>;\n}\n\nexport function createCollectionsResource(http: HttpClient): CollectionsResource {\n  return {\n    async list() {\n      const path = 'b2b/collections';\n      return http.get<Collection[]>(path);\n    },\n    async getById(id: string) {\n      const path = `b2b/collections/${encodeURIComponent(id)}`;\n      return http.get<Collection>(path);\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 as string;\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  headers?: Record<string, string>; // Pending to approve\n  apiKeyHeaderName?: string;\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, headers, apiKeyHeaderName = 'x-api-key' } = config;\n\n  const http = createHttpClient({\n    baseUrl,\n    apiKey,\n    clientId,\n    apiKeyHeaderName,\n    fetch: fetchImpl ?? (globalThis.fetch as FetchLike | undefined),\n    headers,\n  });\n\n  return JaaqClient.fromHttp(http);\n}\n"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,93 @@
+type FetchLike = typeof globalThis.fetch;
+type RequestOptions = Parameters<typeof globalThis.fetch>[1];
+interface HttpClient {
+    get<T>(_path: string, _init?: RequestOptions): Promise<T>;
+    post<T>(_path: string, _body?: unknown, _init?: RequestOptions): Promise<T>;
+    put<T>(_path: string, _body?: unknown, _init?: RequestOptions): Promise<T>;
+    patch<T>(_path: string, _body?: unknown, _init?: RequestOptions): Promise<T>;
+    delete<T>(_path: string, _init?: RequestOptions): Promise<T>;
+}
+
+interface Video {
+    id: string;
+    videoId: string;
+    questionId: string;
+    question: string;
+    status: number | null;
+    transcription: string | null;
+    createdAt: string;
+    modifiedAt: string;
+    videoUrl: string;
+    published: boolean;
+    tags: string[];
+    severity: number | null;
+    duration: number;
+    subTopics: string[];
+    description: string;
+}
+
+interface VideosResource {
+    getById(_id: string): Promise<Video>;
+}
+
+interface Collection {
+    id: string;
+    name: string;
+    description: string;
+    imageUrl: string;
+    videos: Video[];
+}
+
+interface CollectionsResource {
+    list(): Promise<Collection[]>;
+    getById(_id: string): Promise<Collection>;
+}
+
+type ISODateTimeString = string;
+interface ApiError {
+    description: string;
+    error: string;
+}
+
+interface Subtopic {
+    id: string;
+    name: string;
+    createdAt: ISODateTimeString;
+    modifiedAt: ISODateTimeString;
+    modifiedBy: ISODateTimeString;
+}
+
+declare const BASE_URL: string;
+interface SDKConfig {
+    baseUrl?: string;
+    apiKey: string;
+    clientId: string;
+    fetch?: FetchLike;
+    timeoutMs?: number;
+    headers?: Record<string, string>;
+    apiKeyHeaderName?: string;
+}
+declare class JaaqClient {
+    readonly videos: VideosResource;
+    readonly collections: CollectionsResource;
+    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;
+    /**
+     * OO-friendly static initializer.
+     * Delegates to the single source of truth: `buildClient`.
+     */
+    static init(config: SDKConfig): JaaqClient;
+}
+/**
+ * Canonical factory (idiomatic for JS/TS).
+ * Delegates to the single source of truth: `buildClient`.
+ */
+declare function createJaaqClient(config: SDKConfig): JaaqClient;
+
+export { BASE_URL, JaaqClient, createJaaqClient };
+export type { ApiError, Collection, ISODateTimeString, SDKConfig, Subtopic, Video };

package/dist/index.mjs

@@ -0,0 +1,130 @@
+async function parseJson(res) {
+    if (!res.ok) {
+        const text = await res.text().catch(() => '');
+        throw new Error(`HTTP ${res.status}: ${text || res.statusText}`);
+    }
+    if (res.status === 204)
+        return undefined;
+    return res.json();
+}
+/**
+ * Join base URL and path avoiding duplicate slashes.
+ * - Preserves absolute paths (http/https) as-is.
+ * - Trims trailing slashes from base and leading slashes from path.
+ */
+function joinUrl(baseUrl, 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}/${relative}`;
+}
+function createHttpClient(config) {
+    const { baseUrl, apiKey, clientId, fetch: fetchImpl, headers, apiKeyHeaderName = 'x-api-key' } = 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.');
+    }
+    const baseHeaders = {
+        'Content-Type': 'application/json',
+        [apiKeyHeaderName]: apiKey,
+        'x-client-id': clientId,
+        ...headers,
+    };
+    const fullUrl = (path) => joinUrl(baseUrl, path);
+    const request = async (method, path, init, body) => {
+        const reqInit = {
+            method,
+            headers: {
+                ...baseHeaders,
+                ...init?.headers,
+            },
+            ...init,
+        };
+        if (body !== undefined)
+            reqInit.body = JSON.stringify(body);
+        const res = await f(fullUrl(path), reqInit);
+        return parseJson(res);
+    };
+    return {
+        get: (path, init) => request('GET', path, init),
+        post: (path, body, init) => request('POST', path, init, body),
+        put: (path, body, init) => request('PUT', path, init, body),
+        patch: (path, body, init) => request('PATCH', path, init, body),
+        delete: (path, init) => request('DELETE', path, init),
+    };
+}
+
+function createVideosResource(http) {
+    return {
+        async getById(id) {
+            const path = `b2b/videos/${encodeURIComponent(id)}`;
+            return http.get(path);
+        },
+    };
+}
+
+function createCollectionsResource(http) {
+    return {
+        async list() {
+            const path = 'b2b/collections';
+            return http.get(path);
+        },
+        async getById(id) {
+            const path = `b2b/collections/${encodeURIComponent(id)}`;
+            return http.get(path);
+        },
+    };
+}
+
+const BASE_URL = undefined;
+class JaaqClient {
+    // Keep constructor private to enforce controlled instantiation.
+    constructor(http) {
+        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);
+    }
+    /**
+     * OO-friendly static initializer.
+     * Delegates to the single source of truth: `buildClient`.
+     */
+    static init(config) {
+        return buildClient(config);
+    }
+}
+/**
+ * Canonical factory (idiomatic for JS/TS).
+ * Delegates to the single source of truth: `buildClient`.
+ */
+function createJaaqClient(config) {
+    return buildClient(config);
+}
+/**
+ * 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, headers, apiKeyHeaderName = 'x-api-key' } = config;
+    const http = createHttpClient({
+        baseUrl,
+        apiKey,
+        clientId,
+        apiKeyHeaderName,
+        fetch: fetchImpl ?? globalThis.fetch,
+        headers,
+    });
+    return JaaqClient.fromHttp(http);
+}
+
+export { BASE_URL, JaaqClient, createJaaqClient };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +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  apiKeyHeaderName?: string;\n  fetch?: FetchLike;\n  timeoutMs?: number;\n  headers?: Record<string, string>;\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\n/**\n * Join base URL and path avoiding duplicate slashes.\n * - Preserves absolute paths (http/https) as-is.\n * - Trims trailing slashes from base and leading slashes from path.\n */\nfunction joinUrl(baseUrl: 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}/${relative}`;\n}\n\nexport function createHttpClient(config: HttpClientConfig): HttpClient {\n  const { baseUrl, apiKey, clientId, fetch: fetchImpl, headers, apiKeyHeaderName = 'x-api-key' } = 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    [apiKeyHeaderName]: apiKey,\n    'x-client-id': clientId,\n    ...headers,\n  };\n\n  const fullUrl = (path: string) => joinUrl(baseUrl, 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 { Video } from '@src/types/videos';\n\nexport interface VideosResource {\n  getById(_id: string): Promise<Video>;\n}\n\nexport function createVideosResource(http: HttpClient): VideosResource {\n  return {\n    async getById(id: string) {\n      const path = `b2b/videos/${encodeURIComponent(id)}`;\n      return http.get<Video>(path);\n    },\n  };\n}\n","import type { HttpClient } from '@core/httpClient';\nimport type { Collection } from '@src/types/collection';\n\nexport interface CollectionsResource {\n  list(): Promise<Collection[]>;\n  getById(_id: string): Promise<Collection>;\n}\n\nexport function createCollectionsResource(http: HttpClient): CollectionsResource {\n  return {\n    async list() {\n      const path = 'b2b/collections';\n      return http.get<Collection[]>(path);\n    },\n    async getById(id: string) {\n      const path = `b2b/collections/${encodeURIComponent(id)}`;\n      return http.get<Collection>(path);\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 as string;\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  headers?: Record<string, string>; // Pending to approve\n  apiKeyHeaderName?: string;\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, headers, apiKeyHeaderName = 'x-api-key' } = config;\n\n  const http = createHttpClient({\n    baseUrl,\n    apiKey,\n    clientId,\n    apiKeyHeaderName,\n    fetch: fetchImpl ?? (globalThis.fetch as FetchLike | undefined),\n    headers,\n  });\n\n  return JaaqClient.fromHttp(http);\n}\n"],"names":[],"mappings":"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"}

package/dist/jaaq-sdk.min.js

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

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

@@ -0,0 +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  apiKeyHeaderName?: string;\n  fetch?: FetchLike;\n  timeoutMs?: number;\n  headers?: Record<string, string>;\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\n/**\n * Join base URL and path avoiding duplicate slashes.\n * - Preserves absolute paths (http/https) as-is.\n * - Trims trailing slashes from base and leading slashes from path.\n */\nfunction joinUrl(baseUrl: 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}/${relative}`;\n}\n\nexport function createHttpClient(config: HttpClientConfig): HttpClient {\n  const { baseUrl, apiKey, clientId, fetch: fetchImpl, headers, apiKeyHeaderName = 'x-api-key' } = 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    [apiKeyHeaderName]: apiKey,\n    'x-client-id': clientId,\n    ...headers,\n  };\n\n  const fullUrl = (path: string) => joinUrl(baseUrl, 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 as string;\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  headers?: Record<string, string>; // Pending to approve\n  apiKeyHeaderName?: string;\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, headers, apiKeyHeaderName = 'x-api-key' } = config;\n\n  const http = createHttpClient({\n    baseUrl,\n    apiKey,\n    clientId,\n    apiKeyHeaderName,\n    fetch: fetchImpl ?? (globalThis.fetch as FetchLike | undefined),\n    headers,\n  });\n\n  return JaaqClient.fromHttp(http);\n}\n","import type { HttpClient } from '@core/httpClient';\nimport type { Video } from '@src/types/videos';\n\nexport interface VideosResource {\n  getById(_id: string): Promise<Video>;\n}\n\nexport function createVideosResource(http: HttpClient): VideosResource {\n  return {\n    async getById(id: string) {\n      const path = `b2b/videos/${encodeURIComponent(id)}`;\n      return http.get<Video>(path);\n    },\n  };\n}\n","import type { HttpClient } from '@core/httpClient';\nimport type { Collection } from '@src/types/collection';\n\nexport interface CollectionsResource {\n  list(): Promise<Collection[]>;\n  getById(_id: string): Promise<Collection>;\n}\n\nexport function createCollectionsResource(http: HttpClient): CollectionsResource {\n  return {\n    async list() {\n      const path = 'b2b/collections';\n      return http.get<Collection[]>(path);\n    },\n    async getById(id: string) {\n      const path = `b2b/collections/${encodeURIComponent(id)}`;\n      return http.get<Collection>(path);\n    },\n  };\n}\n"],"names":["createHttpClient","config","baseUrl","apiKey","clientId","fetch","fetchImpl","headers","apiKeyHeaderName","f","globalThis","Error","baseHeaders","request","async","method","path","init","body","reqInit","undefined","JSON","stringify","res","test","replace","joinUrl","fullUrl","ok","text","catch","status","statusText","json","parseJson","get","post","put","patch","delete","BASE_URL","JaaqClient","constructor","http","this","videos","getById","id","encodeURIComponent","createVideosResource","collections","createCollectionsResource","fromHttp","buildClient"],"mappings":"8OA4CM,SAAUA,EAAiBC,GAC/B,MAAMC,QAAEA,EAAOC,OAAEA,EAAMC,SAAEA,EAAUC,MAAOC,EAASC,QAAEA,EAAOC,iBAAEA,EAAmB,aAAgBP,EAE3FQ,EAA2BH,GAAcI,WAAWL,MAC1D,IAAKI,EACH,MAAM,IAAIE,MAAM,kGAGlB,MAAMC,EAAsC,CAC1C,eAAgB,mBAChBJ,CAACA,GAAmBL,EACpB,cAAeC,KACZG,GAKCM,EAAUC,MAAUC,EAAgBC,EAAcC,EAAuBC,KAC7E,MAAMC,EAA0B,CAC9BJ,SACAR,QAAS,IACJK,KACCK,GAAMV,YAETU,QAEQG,IAATF,IAAoBC,EAAQD,KAAOG,KAAKC,UAAUJ,IACtD,MAAMK,QAAYd,EAZJ,CAACO,GAvBnB,SAAiBd,EAAiBc,GAEhC,MAAI,gBAAgBQ,KAAKR,GAAcA,EAGhC,GAFMd,EAAQuB,QAAQ,OAAQ,OACpBT,EAAKS,QAAQ,OAAQ,KAExC,CAiBoCC,CAAQxB,EAASc,GAY7BW,CAAQX,GAAOG,GACnC,OAlDJL,eAA4BS,GAC1B,IAAKA,EAAIK,GAAI,CACX,MAAMC,QAAaN,EAAIM,OAAOC,MAAM,IAAM,IAC1C,MAAM,IAAInB,MAAM,QAAQY,EAAIQ,WAAWF,GAAQN,EAAIS,aACrD,CACA,GAAmB,MAAfT,EAAIQ,OACR,OAAOR,EAAIU,MACb,CA2CWC,CAAaX,IAGtB,MAAO,CACLY,IAAK,CAAInB,EAAcC,IAA0BJ,EAAW,MAAOG,EAAMC,GACzEmB,KAAM,CAAIpB,EAAcE,EAAgBD,IAA0BJ,EAAW,OAAQG,EAAMC,EAAMC,GACjGmB,IAAK,CAAIrB,EAAcE,EAAgBD,IAA0BJ,EAAW,MAAOG,EAAMC,EAAMC,GAC/FoB,MAAO,CAAItB,EAAcE,EAAgBD,IAA0BJ,EAAW,QAASG,EAAMC,EAAMC,GACnGqB,OAAQ,CAAIvB,EAAcC,IAA0BJ,EAAW,SAAUG,EAAMC,GAEnF,OC3EauB,OAAWpB,QAYXqB,EAKX,WAAAC,CAAoBC,GAClBC,KAAKC,OClBH,SAA+BF,GACnC,MAAO,CACL,aAAMG,CAAQC,GACZ,MAAM/B,EAAO,cAAcgC,mBAAmBD,KAC9C,OAAOJ,EAAKR,IAAWnB,EACzB,EAEJ,CDWkBiC,CAAqBN,GACnCC,KAAKM,YElBH,SAAoCP,GACxC,MAAO,CACL7B,KAAU,SAED6B,EAAKR,IADC,mBAGf,aAAMW,CAAQC,GACZ,MAAM/B,EAAO,mBAAmBgC,mBAAmBD,KACnD,OAAOJ,EAAKR,IAAgBnB,EAC9B,EAEJ,CFOuBmC,CAA0BR,EAC/C,CAOA,eAAOS,CAAST,GACd,OAAO,IAAIF,EAAWE,EACxB,CAMA,WAAO1B,CAAKhB,GACV,OAAOoD,EAAYpD,EACrB,EAgBF,SAASoD,EAAYpD,GACnB,MAAMC,QAAEA,EAAUsC,EAAQrC,OAAEA,EAAMC,SAAEA,EAAUC,MAAOC,EAASC,QAAEA,EAAOC,iBAAEA,EAAmB,aAAgBP,EAEtG0C,EAAO3C,EAAiB,CAC5BE,UACAC,SACAC,WACAI,mBACAH,MAAOC,GAAcI,WAAWL,MAChCE,YAGF,OAAOkC,EAAWW,SAAST,EAC7B,gDAtBM,SAA2B1C,GAC/B,OAAOoD,EAAYpD,EACrB"}

package/package.json

@@ -0,0 +1,102 @@
+{
+  "name": "@jaaq/jaaq-sdk-js",
+  "version": "0.0.1",
+  "description": "Official JavaScript SDK for JAAQ API",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "rollup -c",
+    "dev": "dotenvx run -f .env.development -- rollup -c --watch",
+    "build:dev": "dotenvx run -f .env.development -- rollup -c",
+    "build:staging": "dotenvx run -f .env.staging -- rollup -c",
+    "build:prod": "dotenvx run -f .env.production -- rollup -c",
+    "test": "vitest run --exclude=tests/build",
+    "test:watch": "vitest --exclude=tests/build",
+    "test:coverage": "vitest run --coverage --exclude=tests/build",
+    "test:coverage:watch": "vitest --coverage --exclude=tests/build",
+    "test:smoke:dev": "dotenvx run -f .env.development -- vitest run tests/build",
+    "test:smoke:staging": "dotenvx run -f .env.staging -- vitest run tests/build",
+    "test:smoke:prod": "dotenvx run -f .env.production -- vitest run tests/build",
+    "test:smoke:ci": "vitest run tests/build",
+    "check-paths-in-bundle": "grep -R -nE --exclude='*.map' '@core/|@resources/' dist || echo 'OK no aliases found'",
+    "openapi:gen": "openapi-typescript ./openapi.json -o ./src/gen/openapi.ts",
+    "audit:moderate": "pnpm audit --audit-level=moderate",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "prepare": "husky"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.mjs"
+    }
+  },
+  "keywords": [
+    "jaaq",
+    "sdk",
+    "api",
+    "video",
+    "collections"
+  ],
+  "author": "JAAQ",
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jaaq-eng/jaaq-sdk-js.git"
+  },
+  "bugs": {
+    "url": "https://github.com/jaaq-eng/jaaq-sdk-js/issues"
+  },
+  "homepage": "https://github.com/jaaq-eng/jaaq-sdk-js#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "packageManager": "pnpm@10.17.1",
+  "lint-staged": {
+    "*.{ts,tsx,js}": [
+      "eslint --fix --max-warnings=0"
+    ],
+    "*.{json,md,yml,yaml,ts,tsx,js}": [
+      "prettier --write"
+    ]
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "devDependencies": {
+    "@commitlint/cli": "^20.1.0",
+    "@commitlint/config-conventional": "^20.0.0",
+    "@dotenvx/dotenvx": "^1.51.1",
+    "@eslint/js": "^9.39.1",
+    "@rollup/plugin-commonjs": "^29.0.0",
+    "@rollup/plugin-node-resolve": "^16.0.3",
+    "@rollup/plugin-replace": "^6.0.3",
+    "@rollup/plugin-terser": "^0.4.4",
+    "@rollup/plugin-typescript": "^12.3.0",
+    "@types/node": "^24.10.0",
+    "@typescript-eslint/eslint-plugin": "^8.46.3",
+    "@typescript-eslint/parser": "^8.46.3",
+    "eslint": "^9.39.1",
+    "eslint-config-prettier": "^10.1.8",
+    "globals": "^16.5.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.2.6",
+    "msw": "^2.12.1",
+    "openapi-typescript": "^7.10.1",
+    "prettier": "^3.6.2",
+    "rollup": "^4.53.2",
+    "rollup-plugin-dts": "^6.2.3",
+    "tslib": "^2.8.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.8",
+    "@vitest/coverage-v8": "^4.0.8",
+    "rollup-plugin-tsconfig-paths": "^1.5.2"
+  }
+}