gitverse-api-sdk 1.0.0 → 2.0.0

package/dist/api/branches.d.ts

@@ -0,0 +1,154 @@
+/**
+* Интерфейс ветки репозитория
+*/
+interface Branch {
+	/** Имя ветки */
+	name: string;
+	/** SHA-хеш последнего коммита */
+	commit: {
+		sha: string
+		url: string
+	};
+	/** Защищена ли ветка */
+	protected?: boolean;
+}
+/**
+* Предупреждение об устаревшей версии API
+*/
+declare class ApiVersionWarning {
+	/** Текущая используемая версия */
+	readonly currentVersion: string;
+	/** Последняя доступная версия */
+	readonly latestVersion: string;
+	/** Дата вывода из эксплуатации */
+	readonly decommissioning?: string;
+	constructor(currentVersion: string, latestVersion: string, decommissioning?: string);
+	/**
+	* Возвращает сообщение о предупреждении
+	*/
+	getMessage(): string;
+}
+declare const HTTPMethods: {
+	readonly DELETE: "DELETE"
+	readonly GET: "GET"
+	readonly PATCH: "PATCH"
+	readonly POST: "POST"
+	readonly PUT: "PUT"
+};
+type HTTPMethods = (typeof HTTPMethods)[keyof typeof HTTPMethods];
+/**
+* Параметры для конфигурации GitVerse клиента
+*/
+interface GitVerseClientConfig {
+	/**
+	* Базовый URL API GitVerse
+	* @default 'https://api.gitverse.ru'
+	*/
+	baseUrl?: string;
+	/**
+	* Токен доступа для авторизации в API
+	*/
+	token?: string;
+	/**
+	* Версия API
+	* @default '1'
+	*/
+	apiVersion?: string;
+}
+/**
+* Основной класс для работы с GitVerse API
+*/
+declare class GitVerseClient {
+	private baseUrl;
+	private token?;
+	private apiVersion;
+	/**
+	* Callback для обработки предупреждений об устаревшей версии API
+	*/
+	onApiVersionWarning?: (warning: ApiVersionWarning) => void;
+	/**
+	* Создает новый экземпляр GitVerse клиента
+	* @param config Конфигурация клиента
+	*/
+	constructor(config?: GitVerseClientConfig);
+	/**
+	* Устанавливает токен авторизации
+	* @param token Токен доступа
+	*/
+	setToken(token: string): void;
+	/**
+	* Извлекает информацию о Rate Limit из заголовков ответа
+	*/
+	private extractRateLimitInfo;
+	/**
+	* Извлекает информацию о версии API из заголовков ответа
+	*/
+	private extractApiVersionInfo;
+	/**
+	* Извлекает метаданные из заголовков ответа
+	*/
+	private extractMetadata;
+	/**
+	* Выполняет API-запрос с учетом авторизации и версии API
+	* @param path Путь к API-ресурсу
+	* @param method HTTP-метод
+	* @param body Тело запроса (опционально)
+	* @returns Ответ от API
+	* @throws {RateLimitError} При превышении лимита запросов (429)
+	* @throws {GitVerseApiError} При других ошибках API
+	*/
+	request<T>(path: string, method: HTTPMethods, body?: unknown): Promise<T>;
+	/**
+	* Выполняет GET-запрос
+	* @param path Путь к API-ресурсу
+	* @returns Ответ от API
+	*/
+	get<T>(path: string): Promise<T>;
+	/**
+	* Выполняет POST-запрос
+	* @param path Путь к API-ресурсу
+	* @param body Тело запроса
+	* @returns Ответ от API
+	*/
+	post<T>(path: string, body?: unknown): Promise<T>;
+	/**
+	* Выполняет PUT-запрос
+	* @param path Путь к API-ресурсу
+	* @param body Тело запроса
+	* @returns Ответ от API
+	*/
+	put<T>(path: string, body?: unknown): Promise<T>;
+	/**
+	* Выполняет DELETE-запрос
+	* @param path Путь к API-ресурсу
+	* @param body Тело запроса (опционально)
+	* @returns Ответ от API
+	*/
+	delete<T>(path: string, body?: unknown): Promise<T>;
+	/**
+	* Выполняет PATCH-запрос
+	* @param path Путь к API-ресурсу
+	* @param body Тело запроса
+	* @returns Ответ от API
+	*/
+	patch<T>(path: string, body?: unknown): Promise<T>;
+}
+/**
+* API для работы с ветками репозитория
+*/
+declare class BranchesApi {
+	private client;
+	/**
+	* Создает новый экземпляр API для работы с ветками
+	* @param client GitVerse клиент
+	*/
+	constructor(client: GitVerseClient);
+	/**
+	* Получает список веток репозитория
+	* @param owner Владелец репозитория
+	* @param repo Название репозитория
+	* @returns Список веток
+	*/
+	list(owner: string, repo: string): Promise<Branch[]>;
+}
+export { BranchesApi };

package/dist/api/branches.js

@@ -0,0 +1,4 @@
+class f{client;constructor(b){this.client=b}list(b,d){return this.client.get(`/repos/${b}/${d}/branches`)}}export{f as BranchesApi};
+export{f};
+
+//# debugId=FD830EC0D6616EE464756E2164756E21

package/dist/api/branches.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/api/branches.ts"],
+  "sourcesContent": [
+    "import type { GitVerseClient } from \"../client\";\nimport type { Branch } from \"../types\";\n\n/**\n * API для работы с ветками репозитория\n */\nexport class BranchesApi {\n  private client: GitVerseClient;\n\n  /**\n   * Создает новый экземпляр API для работы с ветками\n   * @param client GitVerse клиент\n   */\n  constructor(client: GitVerseClient) {\n    this.client = client;\n  }\n\n  /**\n   * Получает список веток репозитория\n   * @param owner Владелец репозитория\n   * @param repo Название репозитория\n   * @returns Список веток\n   */\n  list(owner: string, repo: string): Promise<Branch[]> {\n    return this.client.get<Branch[]>(`/repos/${owner}/${repo}/branches`);\n  }\n}\n"
+  ],
+  "mappings": "AAMO,MAAM,CAAY,CACf,OAMR,WAAW,CAAC,EAAwB,CAClC,KAAK,OAAS,EAShB,IAAI,CAAC,EAAe,EAAiC,CACnD,OAAO,KAAK,OAAO,IAAc,UAAU,KAAS,YAAe,EAEvE",
+  "debugId": "FD830EC0D6616EE464756E2164756E21",
+  "names": []
+}

package/dist/api/collaborators.d.ts

@@ -0,0 +1,224 @@
+/**
+* Типы пользователей в системе
+*/
+declare const UserType: {
+	readonly Organization: "Organization"
+	readonly User: "User"
+};
+/**
+* Тип для типов пользователей
+*/
+type UserType = (typeof UserType)[keyof typeof UserType];
+/**
+* Типы видимости для репозиториев и пользователей
+*/
+declare const VisibilityType: {
+	readonly Limited: "limited"
+	readonly Private: "private"
+	readonly Public: "public"
+};
+/**
+* Тип для типов видимости
+*/
+type VisibilityType = (typeof VisibilityType)[keyof typeof VisibilityType];
+/**
+* Интерфейс пользователя
+*/
+interface User2 {
+	/** Уникальный идентификатор пользователя */
+	id: number;
+	/** Имя пользователя */
+	name?: string;
+	/** Логин пользователя */
+	login: string;
+	/** Полное имя пользователя */
+	full_name?: string;
+	/** Тип аккаунта: пользователь или организация */
+	type: UserType;
+	/** Биография пользователя */
+	bio?: string;
+	/** Электронная почта пользователя */
+	email?: string;
+	/** URL аватара пользователя */
+	avatar_url: string;
+	/** Веб-ссылка на профиль пользователя */
+	html_url: string;
+	/** API-ссылка на профиль пользователя */
+	url?: string;
+	/** API-ссылка на список подписчиков пользователя */
+	followers_url?: string;
+	/** API-ссылка на репозитории пользователя */
+	repos_url?: string;
+	/** API-ссылка на организации пользователя */
+	organizations_url?: string;
+	/** Права администратора */
+	site_admin: boolean;
+	/** Местоположение пользователя */
+	location?: string;
+	/** Верификация аккаунта */
+	is_verified?: boolean;
+	/** Настройки приватности профиля */
+	visibility?: VisibilityType;
+	/** Персональный веб-сайт */
+	website?: string;
+	/** Количество подписчиков */
+	followers?: number;
+	/** Количество подписок */
+	following?: number;
+	/** Количество публичных репозиториев */
+	public_repos?: number;
+	/** Количество репозиториев, отмеченных звездой */
+	stars_count?: number;
+	/** Дата создания аккаунта */
+	created_at: string;
+	/** Дата последнего обновления аккаунта */
+	updated_at?: string;
+}
+/**
+* Предупреждение об устаревшей версии API
+*/
+declare class ApiVersionWarning {
+	/** Текущая используемая версия */
+	readonly currentVersion: string;
+	/** Последняя доступная версия */
+	readonly latestVersion: string;
+	/** Дата вывода из эксплуатации */
+	readonly decommissioning?: string;
+	constructor(currentVersion: string, latestVersion: string, decommissioning?: string);
+	/**
+	* Возвращает сообщение о предупреждении
+	*/
+	getMessage(): string;
+}
+declare const HTTPMethods: {
+	readonly DELETE: "DELETE"
+	readonly GET: "GET"
+	readonly PATCH: "PATCH"
+	readonly POST: "POST"
+	readonly PUT: "PUT"
+};
+type HTTPMethods = (typeof HTTPMethods)[keyof typeof HTTPMethods];
+/**
+* Параметры для конфигурации GitVerse клиента
+*/
+interface GitVerseClientConfig {
+	/**
+	* Базовый URL API GitVerse
+	* @default 'https://api.gitverse.ru'
+	*/
+	baseUrl?: string;
+	/**
+	* Токен доступа для авторизации в API
+	*/
+	token?: string;
+	/**
+	* Версия API
+	* @default '1'
+	*/
+	apiVersion?: string;
+}
+/**
+* Основной класс для работы с GitVerse API
+*/
+declare class GitVerseClient {
+	private baseUrl;
+	private token?;
+	private apiVersion;
+	/**
+	* Callback для обработки предупреждений об устаревшей версии API
+	*/
+	onApiVersionWarning?: (warning: ApiVersionWarning) => void;
+	/**
+	* Создает новый экземпляр GitVerse клиента
+	* @param config Конфигурация клиента
+	*/
+	constructor(config?: GitVerseClientConfig);
+	/**
+	* Устанавливает токен авторизации
+	* @param token Токен доступа
+	*/
+	setToken(token: string): void;
+	/**
+	* Извлекает информацию о Rate Limit из заголовков ответа
+	*/
+	private extractRateLimitInfo;
+	/**
+	* Извлекает информацию о версии API из заголовков ответа
+	*/
+	private extractApiVersionInfo;
+	/**
+	* Извлекает метаданные из заголовков ответа
+	*/
+	private extractMetadata;
+	/**
+	* Выполняет API-запрос с учетом авторизации и версии API
+	* @param path Путь к API-ресурсу
+	* @param method HTTP-метод
+	* @param body Тело запроса (опционально)
+	* @returns Ответ от API
+	* @throws {RateLimitError} При превышении лимита запросов (429)
+	* @throws {GitVerseApiError} При других ошибках API
+	*/
+	request<T>(path: string, method: HTTPMethods, body?: unknown): Promise<T>;
+	/**
+	* Выполняет GET-запрос
+	* @param path Путь к API-ресурсу
+	* @returns Ответ от API
+	*/
+	get<T>(path: string): Promise<T>;
+	/**
+	* Выполняет POST-запрос
+	* @param path Путь к API-ресурсу
+	* @param body Тело запроса
+	* @returns Ответ от API
+	*/
+	post<T>(path: string, body?: unknown): Promise<T>;
+	/**
+	* Выполняет PUT-запрос
+	* @param path Путь к API-ресурсу
+	* @param body Тело запроса
+	* @returns Ответ от API
+	*/
+	put<T>(path: string, body?: unknown): Promise<T>;
+	/**
+	* Выполняет DELETE-запрос
+	* @param path Путь к API-ресурсу
+	* @param body Тело запроса (опционально)
+	* @returns Ответ от API
+	*/
+	delete<T>(path: string, body?: unknown): Promise<T>;
+	/**
+	* Выполняет PATCH-запрос
+	* @param path Путь к API-ресурсу
+	* @param body Тело запроса
+	* @returns Ответ от API
+	*/
+	patch<T>(path: string, body?: unknown): Promise<T>;
+}
+/**
+* API для работы с коллабораторами репозитория
+*/
+declare class CollaboratorsApi {
+	private client;
+	/**
+	* Создает новый экземпляр API для работы с коллабораторами
+	* @param client GitVerse клиент
+	*/
+	constructor(client: GitVerseClient);
+	/**
+	* Получает список коллабораторов репозитория
+	* @param owner Владелец репозитория
+	* @param repo Название репозитория
+	* @returns Список коллабораторов
+	*/
+	list(owner: string, repo: string): Promise<User2[]>;
+	/**
+	* Добавляет коллаборатора к репозиторию
+	* @param owner Владелец репозитория
+	* @param repo Название репозитория
+	* @param collaborator Имя пользователя коллаборатора
+	* @returns Результат операции
+	*/
+	add(owner: string, repo: string, collaborator: string): Promise<void>;
+}
+export { CollaboratorsApi };

package/dist/api/collaborators.js

@@ -0,0 +1,4 @@
+class h{client;constructor(d){this.client=d}list(d,f){return this.client.get(`/repos/${d}/${f}/collaborators`)}add(d,f,g){return this.client.put(`/repos/${d}/${f}/collaborators/${g}`,{})}}export{h as CollaboratorsApi};
+export{h};
+
+//# debugId=38159AA44FAD0CBE64756E2164756E21

package/dist/api/collaborators.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/api/collaborators.ts"],
+  "sourcesContent": [
+    "import type { GitVerseClient } from \"../client\";\nimport type { User } from \"../types\";\n\n/**\n * API для работы с коллабораторами репозитория\n */\nexport class CollaboratorsApi {\n  private client: GitVerseClient;\n\n  /**\n   * Создает новый экземпляр API для работы с коллабораторами\n   * @param client GitVerse клиент\n   */\n  constructor(client: GitVerseClient) {\n    this.client = client;\n  }\n\n  /**\n   * Получает список коллабораторов репозитория\n   * @param owner Владелец репозитория\n   * @param repo Название репозитория\n   * @returns Список коллабораторов\n   */\n  list(owner: string, repo: string): Promise<User[]> {\n    return this.client.get<User[]>(`/repos/${owner}/${repo}/collaborators`);\n  }\n\n  /**\n   * Добавляет коллаборатора к репозиторию\n   * @param owner Владелец репозитория\n   * @param repo Название репозитория\n   * @param collaborator Имя пользователя коллаборатора\n   * @returns Результат операции\n   */\n  add(owner: string, repo: string, collaborator: string): Promise<void> {\n    return this.client.put<void>(`/repos/${owner}/${repo}/collaborators/${collaborator}`, {});\n  }\n}\n"
+  ],
+  "mappings": "AAMO,MAAM,CAAiB,CACpB,OAMR,WAAW,CAAC,EAAwB,CAClC,KAAK,OAAS,EAShB,IAAI,CAAC,EAAe,EAA+B,CACjD,OAAO,KAAK,OAAO,IAAY,UAAU,KAAS,iBAAoB,EAUxE,GAAG,CAAC,EAAe,EAAc,EAAqC,CACpE,OAAO,KAAK,OAAO,IAAU,UAAU,KAAS,mBAAsB,IAAgB,CAAC,CAAC,EAE5F",
+  "debugId": "38159AA44FAD0CBE64756E2164756E21",
+  "names": []
+}