@space-ai/contracts 0.1.1 → 0.1.3

package/README.md

@@ -2,13 +2,13 @@
 
 npm-пакет с TypeScript-типами и функциями HTTP-запросов к API.
 
-Axios устанавливается автоматически как зависимость пакета. Базовый URL API задаётся через глобальную переменную `window.BASE_API_URL`.
+Axios устанавливается автоматически как зависимость пакета. Базовый URL API задаётся через `BASE_API_URL` на глобальном объекте: **`window`** (браузер) или **`global`** / `globalThis` (Node.js, тесты).
 
 ## Содержание
 
 - [Установка](#установка)
 - [Быстрый старт](#быстрый-старт)
-- [window.BASE_API_URL](#windowbase_api_url)
+- [BASE_API_URL (window / global)](#base_api_url-window--global)
 - [Способы инициализации](#способы-инициализации)
 - [Использование API-функций](#использование-api-функций)
 - [TypeScript](#typescript)
@@ -29,10 +29,14 @@ npm install @space-ai/contracts
 
 ## Быстрый старт
 
-**1.** Задайте базовый URL API на `window`:
+**1.** Задайте базовый URL API:
 
 ```typescript
+// браузер
 window.BASE_API_URL = 'https://api.example.com';
+
+// Node.js / тесты
+global.BASE_API_URL = 'http://localhost:3000';
 ```
 
 **2.** Подключите автоинициализацию axios (один раз в точке входа):
@@ -49,23 +53,101 @@ import { getUser } from '@space-ai/contracts';
 const user = await getUser(1);
 ```
 
-Axios создаётся с `baseURL: window.BASE_API_URL`, сохраняется в `window.axios` и используется всеми API-функциями.
+Axios создаётся с `baseURL: BASE_API_URL`, сохраняется в `window.axios` / `global.axios` и используется всеми API-функциями.
 
 ---
 
-## window.BASE_API_URL
+## BASE_API_URL (window / global)
+
+Пакет читает и пишет одни и те же поля на `globalThis` — в браузере это `window`, в Node.js — `global`.
 
 | Свойство | Тип | Описание |
 |----------|-----|----------|
-| `window.BASE_API_URL` | `string` | Базовый URL API → передаётся в `axios.create({ baseURL })` |
-| `window.axios` | `AxiosInstance` | Экземпляр axios (создаётся пакетом, можно использовать напрямую) |
+| `BASE_API_URL` | `string` | Базовый URL API → `axios.create({ baseURL })` |
+| `API_PREFIX` | `string` | Опциональный префикс (`api` → `{BASE_API_URL}/api`) |
+| `axios` | `AxiosInstance` | Экземпляр axios (создаётся пакетом) |
+| `CONTRACTS_AUTH` | `AuthProvider` | Провайдер токена (альтернатива `configureAuth`) |
+
+Примеры:
+
+```typescript
+// браузер
+window.BASE_API_URL = '/api';
+
+// Node.js, Vitest, Jest
+global.BASE_API_URL = 'http://localhost:3000';
+```
+
+---
+
+## Инициализация axios и авторизация
+
+Пакет создаёт axios как на фронтенде:
+
+- `baseURL` из `BASE_API_URL` + опциональный `API_PREFIX`
+- заголовки `Content-Type` / `Accept: application/json`
+- **request interceptor** — подставляет `Authorization: Bearer <token>`
+- **response interceptor** — проверка статуса и проброс ошибок
+
+### Провайдер токена
+
+Keycloak, Zustand и прочее остаются в приложении. Пакет не знает про них — вы передаёте `AuthProvider`:
+
+```typescript
+import { configureAuth, setupApiClient } from '@space-ai/contracts';
+import { getAccessToken, updateToken } from '@/api/keycloak';
+import { dispatchLogout, useAuth } from '@/stores/auth';
+
+configureAuth({
+  getAccessToken: () => getAccessToken() ?? useAuth.getState().token ?? null,
+  updateToken: (minValiditySeconds = 30) => updateToken(minValiditySeconds),
+  onSessionExpired: () => dispatchLogout(),
+});
+
+window.BASE_API_URL = import.meta.env.VITE_API_URL;
+window.API_PREFIX = 'api'; // опционально
 
-Примеры значений:
+setupApiClient();
+```
+
+Логика interceptor (как в `src/api/axios.ts` на фронте):
+
+1. `getAccessToken()` — если токена нет, запрос уходит без `Authorization`
+2. `updateToken(30)` — обновление перед запросом; при ошибке → `onSessionExpired()` и `Session expired`
+3. повторный `getAccessToken()` — свежий токен в заголовок
+
+### Альтернатива — `global.CONTRACTS_AUTH`
+
+```typescript
+global.CONTRACTS_AUTH = {
+  getAccessToken: () => getAccessToken() ?? useAuth.getState().token ?? null,
+  updateToken,
+  onSessionExpired: dispatchLogout,
+};
+```
+
+### Полный пример `main.tsx`
 
 ```typescript
-window.BASE_API_URL = 'https://api.example.com';     // prod
-window.BASE_API_URL = 'https://staging.example.com'; // staging
-window.BASE_API_URL = '/api';                        // proxy через dev-сервер
+import { configureAuth, setupApiClient } from '@space-ai/contracts';
+import { getAccessToken, updateToken } from '@/api/keycloak';
+import { dispatchLogout, useAuth } from '@/stores/auth';
+
+configureAuth({
+  getAccessToken: () => getAccessToken() ?? useAuth.getState().token ?? null,
+  updateToken: (s = 30) => updateToken(s),
+  onSessionExpired: dispatchLogout,
+});
+
+window.BASE_API_URL = import.meta.env.VITE_API_URL;
+window.API_PREFIX = 'api';
+
+setupApiClient();
+
+import { createRoot } from 'react-dom/client';
+import App from './App';
+
+createRoot(document.getElementById('root')!).render(<App />);
 ```
 
 ---
@@ -204,7 +286,7 @@ const created = await createUser({
 Прямой доступ к axios (после инициализации):
 
 ```typescript
-const client = window.axios;
+const client = globalThis.axios; // window.axios в браузере
 await client.get('/health');
 ```
 
@@ -212,12 +294,12 @@ await client.get('/health');
 
 ## TypeScript
 
-Пакет расширяет `Window`:
+Пакет расширяет глобальную область (`global` / `window`):
 
 ```typescript
-interface Window {
-  BASE_API_URL?: string;
-  axios?: import('axios').AxiosInstance;
+declare global {
+  var BASE_API_URL: string | undefined;
+  var axios: import('axios').AxiosInstance | undefined;
 }
 ```
 
@@ -272,6 +354,6 @@ CI (`.github/workflows/publish.yml`) выполнит `npm publish` при те
 
 | Симптом | Решение |
 |---------|---------|
-| `Axios не найден` | Задайте `window.BASE_API_URL`, импортируйте `@space-ai/contracts/axios` или вызовите `setupApiClient()` |
+| `Axios не найден` | Задайте `BASE_API_URL` на `window` / `global`, импортируйте `@space-ai/contracts/axios` или вызовите `setupApiClient()` |
 | Запросы без baseURL | `BASE_API_URL` не был задан до инициализации — используйте **Способ 1** или **Способ 2** |
 | Двойной axios | Не вызывайте и `setupApiClient()`, и `initApiClient()` с разными инстансами без необходимости |

package/dist/axios.js

@@ -1,6 +1,7 @@
 import { enableAutoInit, setupApiClient } from './core/setup-api-client.js';
+import { getBaseApiUrl } from './core/runtime.js';
 enableAutoInit();
-if (typeof window !== 'undefined' && window.BASE_API_URL) {
+if (getBaseApiUrl()) {
     setupApiClient();
 }
 //# sourceMappingURL=axios.js.map

package/dist/axios.js.map

@@ -1 +1 @@
-{"version":3,"file":"axios.js","sourceRoot":"","sources":["../src/axios.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5E,cAAc,EAAE,CAAC;AAEjB,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;IACzD,cAAc,EAAE,CAAC;AACnB,CAAC"}
+{"version":3,"file":"axios.js","sourceRoot":"","sources":["../src/axios.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,cAAc,EAAE,CAAC;AAEjB,IAAI,aAAa,EAAE,EAAE,CAAC;IACpB,cAAc,EAAE,CAAC;AACnB,CAAC"}

package/dist/core/auth.d.ts

@@ -0,0 +1,12 @@
+export interface AuthProvider {
+    /** Текущий access token (Keycloak, store и т.д.) */
+    getAccessToken(): string | null | undefined;
+    /** Обновить токен, если истекает в течение minValiditySeconds */
+    updateToken?(minValiditySeconds?: number): Promise<void>;
+    /** Сессия невалидна — logout, редирект и т.д. */
+    onSessionExpired?(): void;
+}
+export declare function configureAuth(provider: AuthProvider): void;
+export declare function getAuthProvider(): AuthProvider | undefined;
+export declare function resetAuthProvider(): void;
+//# sourceMappingURL=auth.d.ts.map

package/dist/core/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/core/auth.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,cAAc,IAAI,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC5C,iEAAiE;IACjE,WAAW,CAAC,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,iDAAiD;IACjD,gBAAgB,CAAC,IAAI,IAAI,CAAC;CAC3B;AAID,wBAAgB,aAAa,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAE1D;AAED,wBAAgB,eAAe,IAAI,YAAY,GAAG,SAAS,CAE1D;AAED,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}

package/dist/core/auth.js

@@ -0,0 +1,12 @@
+import { getRuntime } from './runtime.js';
+let authProvider = null;
+export function configureAuth(provider) {
+    authProvider = provider;
+}
+export function getAuthProvider() {
+    return authProvider ?? getRuntime()?.CONTRACTS_AUTH;
+}
+export function resetAuthProvider() {
+    authProvider = null;
+}
+//# sourceMappingURL=auth.js.map

package/dist/core/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/core/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAW1C,IAAI,YAAY,GAAwB,IAAI,CAAC;AAE7C,MAAM,UAAU,aAAa,CAAC,QAAsB;IAClD,YAAY,GAAG,QAAQ,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,YAAY,IAAI,UAAU,EAAE,EAAE,cAAc,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,YAAY,GAAG,IAAI,CAAC;AACtB,CAAC"}

package/dist/core/axios-instance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"axios-instance.d.ts","sourceRoot":"","sources":["../../src/core/axios-instance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAQ3C,wBAAgB,QAAQ,IAAI,aAAa,CAmBxC;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAEnD;AAED,wBAAgB,UAAU,IAAI,IAAI,CAEjC"}
+{"version":3,"file":"axios-instance.d.ts","sourceRoot":"","sources":["../../src/core/axios-instance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAS3C,wBAAgB,QAAQ,IAAI,aAAa,CAoBxC;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAEnD;AAED,wBAAgB,UAAU,IAAI,IAAI,CAEjC"}

package/dist/core/axios-instance.js

@@ -1,21 +1,23 @@
 import { isAutoInitEnabled, setupApiClient } from './setup-api-client.js';
+import { getBaseApiUrl, getRuntimeAxios } from './runtime.js';
 import { getStoredAxios, resetStoredAxios, setStoredAxios, } from './state.js';
 export function getAxios() {
     let instance = getStoredAxios();
     if (instance)
         return instance;
-    if (isAutoInitEnabled() && typeof window !== 'undefined' && window.BASE_API_URL) {
+    if (isAutoInitEnabled() && getBaseApiUrl()) {
         setupApiClient();
         instance = getStoredAxios();
         if (instance)
             return instance;
     }
-    if (typeof window !== 'undefined' && window.axios) {
-        setStoredAxios(window.axios);
-        return window.axios;
+    const runtimeAxios = getRuntimeAxios();
+    if (runtimeAxios) {
+        setStoredAxios(runtimeAxios);
+        return runtimeAxios;
     }
-    throw new Error('Axios не найден. Задайте window.BASE_API_URL и импортируйте @space-ai/contracts/axios, ' +
-        'вызовите setupApiClient() или initApiClient(axios)');
+    throw new Error('Axios не найден. Задайте global.BASE_API_URL / window.BASE_API_URL, ' +
+        'импортируйте @space-ai/contracts/axios, вызовите setupApiClient() или initApiClient(axios)');
 }
 export function setAxios(axios) {
     setStoredAxios(axios);

package/dist/core/axios-instance.js.map

@@ -1 +1 @@
-{"version":3,"file":"axios-instance.js","sourceRoot":"","sources":["../../src/core/axios-instance.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,MAAM,UAAU,QAAQ;IACtB,IAAI,QAAQ,GAAG,cAAc,EAAE,CAAC;IAChC,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE9B,IAAI,iBAAiB,EAAE,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;QAChF,cAAc,EAAE,CAAC;QACjB,QAAQ,GAAG,cAAc,EAAE,CAAC;QAC5B,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;IAChC,CAAC;IAED,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAClD,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC7B,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IAED,MAAM,IAAI,KAAK,CACb,yFAAyF;QACvF,oDAAoD,CACvD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAoB;IAC3C,cAAc,CAAC,KAAK,CAAC,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,gBAAgB,EAAE,CAAC;AACrB,CAAC"}
+{"version":3,"file":"axios-instance.js","sourceRoot":"","sources":["../../src/core/axios-instance.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,MAAM,UAAU,QAAQ;IACtB,IAAI,QAAQ,GAAG,cAAc,EAAE,CAAC;IAChC,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE9B,IAAI,iBAAiB,EAAE,IAAI,aAAa,EAAE,EAAE,CAAC;QAC3C,cAAc,EAAE,CAAC;QACjB,QAAQ,GAAG,cAAc,EAAE,CAAC;QAC5B,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;IAChC,CAAC;IAED,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC;IACvC,IAAI,YAAY,EAAE,CAAC;QACjB,cAAc,CAAC,YAAY,CAAC,CAAC;QAC7B,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,MAAM,IAAI,KAAK,CACb,sEAAsE;QACpE,4FAA4F,CAC/F,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAoB;IAC3C,cAAc,CAAC,KAAK,CAAC,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,gBAAgB,EAAE,CAAC;AACrB,CAAC"}

package/dist/core/create-axios-instance.d.ts

@@ -0,0 +1,4 @@
+import { type AxiosInstance } from 'axios';
+export declare function resolveBaseURL(): string | undefined;
+export declare function createConfiguredAxios(baseURL?: string): AxiosInstance;
+//# sourceMappingURL=create-axios-instance.d.ts.map

package/dist/core/create-axios-instance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-axios-instance.d.ts","sourceRoot":"","sources":["../../src/core/create-axios-instance.ts"],"names":[],"mappings":"AAAA,OAAc,EACZ,KAAK,aAAa,EAEnB,MAAM,OAAO,CAAC;AAMf,wBAAgB,cAAc,IAAI,MAAM,GAAG,SAAS,CAUnD;AAED,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,aAAa,CAWrE"}

package/dist/core/create-axios-instance.js

@@ -0,0 +1,63 @@
+import axios from 'axios';
+import { getAuthProvider } from './auth.js';
+import { getBaseApiUrl, getRuntime } from './runtime.js';
+const INTERCEPTORS_ATTACHED = Symbol('contracts.interceptors');
+export function resolveBaseURL() {
+    const base = getBaseApiUrl();
+    if (!base)
+        return undefined;
+    const prefix = getRuntime()?.API_PREFIX;
+    if (!prefix)
+        return base;
+    const normalizedBase = base.replace(/\/$/, '');
+    const normalizedPrefix = prefix.replace(/^\//, '').replace(/\/$/, '');
+    return `${normalizedBase}/${normalizedPrefix}`;
+}
+export function createConfiguredAxios(baseURL) {
+    const instance = axios.create({
+        baseURL: baseURL ?? resolveBaseURL(),
+        headers: {
+            'Content-Type': 'application/json',
+            Accept: 'application/json',
+        },
+    });
+    attachInterceptors(instance);
+    return instance;
+}
+function attachInterceptors(instance) {
+    const marked = instance;
+    if (marked[INTERCEPTORS_ATTACHED])
+        return;
+    marked[INTERCEPTORS_ATTACHED] = true;
+    instance.interceptors.request.use(async (config) => {
+        const auth = getAuthProvider();
+        if (!auth)
+            return config;
+        const token = auth.getAccessToken();
+        if (!token)
+            return config;
+        if (auth.updateToken) {
+            try {
+                await auth.updateToken(30);
+            }
+            catch {
+                auth.onSessionExpired?.();
+                return Promise.reject(new Error('Session expired'));
+            }
+        }
+        const fresh = auth.getAccessToken();
+        const currentToken = fresh ?? token;
+        if (currentToken) {
+            config.headers.Authorization = `Bearer ${currentToken}`;
+        }
+        return config;
+    }, (error) => Promise.reject(error));
+    instance.interceptors.response.use((res) => {
+        if (res.status >= 200 && res.status < 300)
+            return res;
+        throw new Error(res.data);
+    }, (err) => {
+        throw new Error(err);
+    });
+}
+//# sourceMappingURL=create-axios-instance.js.map

package/dist/core/create-axios-instance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-axios-instance.js","sourceRoot":"","sources":["../../src/core/create-axios-instance.ts"],"names":[],"mappings":"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"}

package/dist/core/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/core/init.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAG3C,wBAAgB,aAAa,CAAC,KAAK,CAAC,EAAE,aAAa,GAAG,IAAI,CAYzD"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/core/init.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAI3C,wBAAgB,aAAa,CAAC,KAAK,CAAC,EAAE,aAAa,GAAG,IAAI,CAazD"}

package/dist/core/init.js

@@ -1,13 +1,15 @@
 import { setAxios } from './axios-instance.js';
+import { getRuntimeAxios } from './runtime.js';
 export function initApiClient(axios) {
     if (axios) {
         setAxios(axios);
         return;
     }
-    if (typeof window !== 'undefined' && window.axios) {
-        setAxios(window.axios);
+    const runtimeAxios = getRuntimeAxios();
+    if (runtimeAxios) {
+        setAxios(runtimeAxios);
         return;
     }
-    throw new Error('Не передан axios и нет window.axios');
+    throw new Error('Не передан axios и нет global.axios / window.axios');
 }
 //# sourceMappingURL=init.js.map

package/dist/core/init.js.map

@@ -1 +1 @@
-{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/core/init.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C,MAAM,UAAU,aAAa,CAAC,KAAqB;IACjD,IAAI,KAAK,EAAE,CAAC;QACV,QAAQ,CAAC,KAAK,CAAC,CAAC;QAChB,OAAO;IACT,CAAC;IAED,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAClD,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvB,OAAO;IACT,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;AACzD,CAAC"}
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/core/init.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,UAAU,aAAa,CAAC,KAAqB;IACjD,IAAI,KAAK,EAAE,CAAC;QACV,QAAQ,CAAC,KAAK,CAAC,CAAC;QAChB,OAAO;IACT,CAAC;IAED,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC;IACvC,IAAI,YAAY,EAAE,CAAC;QACjB,QAAQ,CAAC,YAAY,CAAC,CAAC;QACvB,OAAO;IACT,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;AACxE,CAAC"}

package/dist/core/runtime.d.ts

@@ -0,0 +1,7 @@
+import type { AxiosInstance } from 'axios';
+/** Браузер (`window`) или Node.js (`global` / `globalThis`). */
+export declare function getRuntime(): typeof globalThis | undefined;
+export declare function getBaseApiUrl(): string | undefined;
+export declare function getRuntimeAxios(): AxiosInstance | undefined;
+export declare function setRuntimeAxios(instance: AxiosInstance): void;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/core/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/core/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE3C,gEAAgE;AAChE,wBAAgB,UAAU,IAAI,OAAO,UAAU,GAAG,SAAS,CAK1D;AAED,wBAAgB,aAAa,IAAI,MAAM,GAAG,SAAS,CAElD;AAED,wBAAgB,eAAe,IAAI,aAAa,GAAG,SAAS,CAE3D;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAK7D"}

package/dist/core/runtime.js

@@ -0,0 +1,20 @@
+/** Браузер (`window`) или Node.js (`global` / `globalThis`). */
+export function getRuntime() {
+    if (typeof globalThis !== 'undefined') {
+        return globalThis;
+    }
+    return undefined;
+}
+export function getBaseApiUrl() {
+    return getRuntime()?.BASE_API_URL;
+}
+export function getRuntimeAxios() {
+    return getRuntime()?.axios;
+}
+export function setRuntimeAxios(instance) {
+    const runtime = getRuntime();
+    if (runtime) {
+        runtime.axios = instance;
+    }
+}
+//# sourceMappingURL=runtime.js.map

package/dist/core/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/core/runtime.ts"],"names":[],"mappings":"AAEA,gEAAgE;AAChE,MAAM,UAAU,UAAU;IACxB,IAAI,OAAO,UAAU,KAAK,WAAW,EAAE,CAAC;QACtC,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,UAAU,EAAE,EAAE,YAAY,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,UAAU,EAAE,EAAE,KAAK,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAuB;IACrD,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,GAAG,QAAQ,CAAC;IAC3B,CAAC;AACH,CAAC"}

package/dist/core/setup-api-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setup-api-client.d.ts","sourceRoot":"","sources":["../../src/core/setup-api-client.ts"],"names":[],"mappings":"AAKA,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAED,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED,wBAAgB,cAAc,IAAI,IAAI,CAqBrC"}
+{"version":3,"file":"setup-api-client.d.ts","sourceRoot":"","sources":["../../src/core/setup-api-client.ts"],"names":[],"mappings":"AAaA,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAED,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED,wBAAgB,cAAc,IAAI,IAAI,CAyBrC"}

package/dist/core/setup-api-client.js

@@ -1,4 +1,5 @@
-import axios from 'axios';
+import { createConfiguredAxios, resolveBaseURL, } from './create-axios-instance.js';
+import { getRuntime, getRuntimeAxios, setRuntimeAxios, } from './runtime.js';
 import { setStoredAxios } from './state.js';
 let autoInitEnabled = false;
 export function enableAutoInit() {
@@ -8,20 +9,23 @@ export function isAutoInitEnabled() {
     return autoInitEnabled;
 }
 export function setupApiClient() {
-    if (typeof window === 'undefined') {
-        setStoredAxios(axios.create());
+    const runtime = getRuntime();
+    const baseURL = resolveBaseURL();
+    if (!runtime) {
+        setStoredAxios(createConfiguredAxios(baseURL));
         return;
     }
-    const baseURL = window.BASE_API_URL;
     if (!baseURL) {
-        console.warn('@space-ai/contracts: window.BASE_API_URL не задан — axios создаётся без baseURL');
+        console.warn('@space-ai/contracts: BASE_API_URL не задан (global / window) — axios создаётся без baseURL');
     }
-    if (!window.axios) {
-        window.axios = axios.create({ baseURL });
+    let instance = getRuntimeAxios();
+    if (!instance) {
+        instance = createConfiguredAxios(baseURL);
+        setRuntimeAxios(instance);
     }
     else if (baseURL) {
-        window.axios.defaults.baseURL = baseURL;
+        instance.defaults.baseURL = baseURL;
     }
-    setStoredAxios(window.axios);
+    setStoredAxios(instance);
 }
 //# sourceMappingURL=setup-api-client.js.map

package/dist/core/setup-api-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"setup-api-client.js","sourceRoot":"","sources":["../../src/core/setup-api-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,IAAI,eAAe,GAAG,KAAK,CAAC;AAE5B,MAAM,UAAU,cAAc;IAC5B,eAAe,GAAG,IAAI,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,cAAc,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAC/B,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,YAAY,CAAC;IAEpC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CACV,iFAAiF,CAClF,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IAC3C,CAAC;SAAM,IAAI,OAAO,EAAE,CAAC;QACnB,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,GAAG,OAAO,CAAC;IAC1C,CAAC;IAED,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC"}
+{"version":3,"file":"setup-api-client.js","sourceRoot":"","sources":["../../src/core/setup-api-client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,cAAc,GACf,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,UAAU,EACV,eAAe,EACf,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,IAAI,eAAe,GAAG,KAAK,CAAC;AAE5B,MAAM,UAAU,cAAc;IAC5B,eAAe,GAAG,IAAI,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;IAEjC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,cAAc,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC;QAC/C,OAAO;IACT,CAAC;IAED,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CACV,4FAA4F,CAC7F,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,GAAG,eAAe,EAAE,CAAC;IAEjC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,QAAQ,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;QAC1C,eAAe,CAAC,QAAQ,CAAC,CAAC;IAC5B,CAAC;SAAM,IAAI,OAAO,EAAE,CAAC;QACnB,QAAQ,CAAC,QAAQ,CAAC,OAAO,GAAG,OAAO,CAAC;IACtC,CAAC;IAED,cAAc,CAAC,QAAQ,CAAC,CAAC;AAC3B,CAAC"}

package/dist/index.d.ts

@@ -1,4 +1,6 @@
 export { initApiClient } from './core/init.js';
 export { setupApiClient, enableAutoInit } from './core/setup-api-client.js';
 export { getAxios, resetAxios } from './core/axios-instance.js';
+export { configureAuth, resetAuthProvider, type AuthProvider, } from './core/auth.js';
+export { createConfiguredAxios, resolveBaseURL, } from './core/create-axios-instance.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5E,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5E,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,KAAK,YAAY,GAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,qBAAqB,EACrB,cAAc,GACf,MAAM,iCAAiC,CAAC"}

package/dist/index.js

@@ -1,4 +1,6 @@
 export { initApiClient } from './core/init.js';
 export { setupApiClient, enableAutoInit } from './core/setup-api-client.js';
 export { getAxios, resetAxios } from './core/axios-instance.js';
+export { configureAuth, resetAuthProvider, } from './core/auth.js';
+export { createConfiguredAxios, resolveBaseURL, } from './core/create-axios-instance.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5E,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5E,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EACL,aAAa,EACb,iBAAiB,GAElB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,qBAAqB,EACrB,cAAc,GACf,MAAM,iCAAiC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@space-ai/contracts",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Типы и функции HTTP-запросов к API (axios устанавливается вместе с пакетом)",
   "type": "module",
   "main": "./dist/index.js",