@space-ai/contracts 0.1.0

package/README.md

@@ -0,0 +1,55 @@
+# @space-ai/contracts
+
+npm-пакет с типами и функциями HTTP-запросов к API. Axios не входит в бандл — передаётся при инициализации (`peerDependency`).
+
+## Структура
+
+```
+src/          — исходники (типы, api, core)
+dist/         — сборка для npm (генерируется, в git не коммитится)
+```
+
+## Локальная разработка
+
+```bash
+npm install
+npm run build
+```
+
+## Использование
+
+```typescript
+import axios from 'axios';
+import { initApiClient, getUser } from '@space-ai/contracts';
+
+const api = axios.create({ baseURL: '/api' });
+initApiClient(api);
+
+const user = await getUser(1);
+```
+
+## Публикация в npm
+
+1. Создайте организацию/scope на [npmjs.com](https://www.npmjs.com/) (например `@space-ai`).
+2. Сгенерируйте **Automation token** (не publish token с 2FA-проблемами): npm → Access Tokens → Granular Access Token → Read and write, scope — ваш пакет/org.
+3. В GitHub: **Settings → Secrets and variables → Actions → New repository secret** → имя `NPM_TOKEN`, значение — токен.
+4. Обновите в `package.json`: `name`, `repository.url` (пакет публикуется как **public** scoped).
+5. Локально поднимите версию и запушьте тег:
+
+```bash
+npm version patch   # или minor / major
+git push origin main --tags
+```
+
+CI workflow `.github/workflows/publish.yml` соберёт пакет и выполнит `npm publish` при пуше тега `v*.*.*`.
+
+## GitHub
+
+| Что | Зачем |
+|-----|-------|
+| Secret `NPM_TOKEN` | авторизация `npm publish` в Actions |
+| Workflow `ci.yml` | проверка сборки на PR и push в main |
+| Workflow `publish.yml` | публикация по git-тегу |
+| (опционально) Branch protection | merge только после зелёного CI |
+
+Первый релиз: после настройки секрета выполните `npm version 0.1.0 && git push origin main --tags`.

package/dist/api/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC"}

package/dist/api/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,5 @@
+import type { AxiosInstance } from 'axios';
+export declare function getAxios(): AxiosInstance;
+export declare function setAxios(axios: AxiosInstance): void;
+export declare function resetAxios(): void;
+//# sourceMappingURL=axios-instance.d.ts.map

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

@@ -0,0 +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;AAI3C,wBAAgB,QAAQ,IAAI,aAAa,CAWxC;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAEnD;AAED,wBAAgB,UAAU,IAAI,IAAI,CAEjC"}

package/dist/core/axios-instance.js

@@ -0,0 +1,17 @@
+let instance = null;
+export function getAxios() {
+    if (instance)
+        return instance;
+    if (typeof window !== 'undefined' && window.axios) {
+        instance = window.axios;
+        return instance;
+    }
+    throw new Error('Axios не найден. Вызовите initApiClient(axios) или установите window.axios');
+}
+export function setAxios(axios) {
+    instance = axios;
+}
+export function resetAxios() {
+    instance = null;
+}
+//# sourceMappingURL=axios-instance.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"axios-instance.js","sourceRoot":"","sources":["../../src/core/axios-instance.ts"],"names":[],"mappings":"AAEA,IAAI,QAAQ,GAAyB,IAAI,CAAC;AAE1C,MAAM,UAAU,QAAQ;IACtB,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE9B,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAClD,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC;QACxB,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,IAAI,KAAK,CACb,4EAA4E,CAC7E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAoB;IAC3C,QAAQ,GAAG,KAAK,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,QAAQ,GAAG,IAAI,CAAC;AAClB,CAAC"}

package/dist/core/init.d.ts

@@ -0,0 +1,3 @@
+import type { AxiosInstance } from 'axios';
+export declare function initApiClient(axios?: AxiosInstance): void;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +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"}

package/dist/core/init.js

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

package/dist/core/init.js.map

@@ -0,0 +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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { initApiClient } from './core/init.js';
+export { getAxios, resetAxios } from './core/axios-instance.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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,QAAQ,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { initApiClient } from './core/init.js';
+export { getAxios, resetAxios } from './core/axios-instance.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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,QAAQ,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,2 @@
+export type {};
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@space-ai/contracts",
+  "version": "0.1.0",
+  "description": "Типы и функции HTTP-запросов к API (axios — peer dependency)",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "axios": "^1.0.0"
+  },
+  "devDependencies": {
+    "axios": "^1.7.0",
+    "typescript": "^5.7.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/YOUR_ORG/contracts.git"
+  },
+  "license": "UNLICENSED"
+}