gitverse-api-sdk 1.0.0 → 2.0.0

package/dist/api/emails.d.ts

@@ -0,0 +1,184 @@
+/**
+* Интерфейс email адреса
+*/
+interface Email {
+	/** Email адрес */
+	email: string;
+	/** Подтвержден ли email */
+	verified: boolean;
+	/** Является ли основным */
+	primary: boolean;
+	/** Публичный ли email */
+	is_public: boolean;
+}
+/**
+* Параметры для добавления email адресов
+*/
+interface AddEmailParams {
+	/** Массив email адресов для добавления */
+	emails: string[];
+}
+/**
+* Параметры для удаления email адресов
+*/
+interface RemoveEmailParams {
+	/** Массив email адресов для удаления */
+	emails: string[];
+}
+/**
+* Ответ на операции с email
+*/
+interface EmailOperationResponse {
+	/** Сообщение о результате операции */
+	message: string;
+	/** Удаленные email адреса (только для операции удаления) */
+	deleted_emails?: string[];
+	/** HTTP статус код */
+	status: number;
+}
+/**
+* Предупреждение об устаревшей версии 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>;
+}
+/**
+* Класс для работы с email адресами пользователя
+*/
+declare class EmailsApi {
+	private client;
+	constructor(client: GitVerseClient);
+	/**
+	* Получить список email адресов текущего пользователя
+	* @returns {Promise<Email[]>} Массив email адресов
+	*/
+	list(): Promise<Email[]>;
+	/**
+	* Добавить email адреса к аккаунту пользователя
+	* @param {AddEmailParams} params - Параметры для добавления email
+	* @returns {Promise<EmailOperationResponse>} Результат операции
+	*/
+	add(params: AddEmailParams): Promise<EmailOperationResponse>;
+	/**
+	* Удалить email адреса из аккаунта пользователя
+	* @param {RemoveEmailParams} params - Параметры для удаления email
+	* @returns {Promise<EmailOperationResponse>} Результат операции
+	*/
+	remove(params: RemoveEmailParams): Promise<EmailOperationResponse>;
+}
+export { EmailsApi };

package/dist/api/emails.js

@@ -0,0 +1,4 @@
+class c{client;constructor(b){this.client=b}list(){return this.client.get("/user/emails")}add(b){return this.client.post("/user/emails",b)}remove(b){return this.client.delete("/user/emails",b)}}export{c as EmailsApi};
+export{c as y};
+
+//# debugId=6DE1EE65561D6E5D64756E2164756E21

package/dist/api/emails.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/api/emails.ts"],
+  "sourcesContent": [
+    "import type { GitVerseClient } from \"../client\";\nimport type { AddEmailParams, Email, EmailOperationResponse, RemoveEmailParams } from \"../types\";\n\n/**\n * Класс для работы с email адресами пользователя\n */\nexport class EmailsApi {\n  constructor(private client: GitVerseClient) {}\n\n  /**\n   * Получить список email адресов текущего пользователя\n   * @returns {Promise<Email[]>} Массив email адресов\n   */\n  list(): Promise<Email[]> {\n    return this.client.get<Email[]>(\"/user/emails\");\n  }\n\n  /**\n   * Добавить email адреса к аккаунту пользователя\n   * @param {AddEmailParams} params - Параметры для добавления email\n   * @returns {Promise<EmailOperationResponse>} Результат операции\n   */\n  add(params: AddEmailParams): Promise<EmailOperationResponse> {\n    return this.client.post<EmailOperationResponse>(\"/user/emails\", params);\n  }\n\n  /**\n   * Удалить email адреса из аккаунта пользователя\n   * @param {RemoveEmailParams} params - Параметры для удаления email\n   * @returns {Promise<EmailOperationResponse>} Результат операции\n   */\n  remove(params: RemoveEmailParams): Promise<EmailOperationResponse> {\n    return this.client.delete<EmailOperationResponse>(\"/user/emails\", params);\n  }\n}\n"
+  ],
+  "mappings": "AAMO,MAAM,CAAU,CACD,OAApB,WAAW,CAAS,EAAwB,CAAxB,cAMpB,IAAI,EAAqB,CACvB,OAAO,KAAK,OAAO,IAAa,cAAc,EAQhD,GAAG,CAAC,EAAyD,CAC3D,OAAO,KAAK,OAAO,KAA6B,eAAgB,CAAM,EAQxE,MAAM,CAAC,EAA4D,CACjE,OAAO,KAAK,OAAO,OAA+B,eAAgB,CAAM,EAE5E",
+  "debugId": "6DE1EE65561D6E5D64756E2164756E21",
+  "names": []
+}

package/dist/api/forks.d.ts

@@ -0,0 +1,325 @@
+/**
+* Типы пользователей в системе
+*/
+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;
+}
+/**
+* Интерфейс репозитория
+*/
+interface Repository {
+	/** Уникальный идентификатор репозитория */
+	id: number;
+	/** Информация о владельце репозитория */
+	owner: User2;
+	/** Название репозитория */
+	name: string;
+	/** Полное название репозитория в формате {owner}/{repo} */
+	full_name: string;
+	/** Описание репозитория */
+	description?: string;
+	/** Список тем, связанных с репозиторием */
+	topics?: string[] | null;
+	/** Является ли репозиторий приватным */
+	private: boolean;
+	/** Является ли репозиторий форком другого репозитория */
+	fork: boolean;
+	/** Информация о родительском репозитории (если это форк) */
+	parent?: Repository | null;
+	/** Размер репозитория в килобайтах */
+	size: number;
+	/** Основной язык программирования, используемый в репозитории */
+	language?: string;
+	/** SSH-URL для клонирования репозитория */
+	ssh_url: string;
+	/** HTTPS-URL для клонирования репозитория */
+	clone_url: string;
+	/** Веб-ссылка на репозиторий */
+	html_url: string;
+	/** API-ссылка на репозиторий */
+	url: string;
+	/** Git-URL для клонирования репозитория */
+	git_url: string;
+	/** Зеркало репозитория (если доступно) */
+	mirror_url?: string;
+	/** Ссылка на вебсайт проекта */
+	website?: string;
+	/** Альтернативная ссылка на домашнюю страницу проекта */
+	homepage?: string;
+	/** Количество звезд у репозитория */
+	stargazers_count: number;
+	/** Количество форков репозитория */
+	forks: number;
+	/** Количество форков репозитория (дублирует поле forks) */
+	forks_count: number;
+	/** Количество наблюдателей за репозиторием */
+	watchers: number;
+	/** Количество наблюдателей за репозиторием (дублирует поле watchers) */
+	watchers_count: number;
+	/** Количество репозиториев в сети (форков и оригинала) */
+	network_count: number;
+	/** Количество подписчиков на уведомления о репозитории */
+	subscribers_count: number;
+	/** Количество открытых задач (issues) в репозитории */
+	open_issues: number;
+	/** Количество открытых задач (дублирует поле open_issues) */
+	open_issues_count: number;
+	/** Количество открытых pull requests */
+	open_pr_counter: number;
+	/** Основная ветка репозитория */
+	default_branch: string;
+	/** Архивирован ли репозиторий */
+	archived: boolean;
+	/** Разрешено ли создание задач (issues) */
+	has_issues: boolean;
+	/** Разрешено ли использование проектов */
+	has_projects: boolean;
+	/** Разрешено ли использование обсуждений */
+	has_discussions: boolean;
+	/** Разрешено ли использование wiki */
+	has_wiki: boolean;
+	/** Разрешено ли использование GitHub Pages */
+	has_pages: boolean;
+	/** Отключен ли репозиторий */
+	disabled: boolean;
+	/** Настройки приватности репозитория */
+	visibility: VisibilityType;
+	/** Является ли репозиторий шаблоном */
+	is_template: boolean;
+	/** Информация о шаблоне репозитория (если доступно) */
+	template_repository?: Repository | null;
+	/** Разрешены ли слияния через merge commits */
+	allow_merge_commits: boolean;
+	/** Разрешены ли слияния через squash commits */
+	allow_squash_merge: boolean;
+	/** Удалять ли ветку после слияния по умолчанию */
+	default_delete_branch_after_merge: boolean;
+	/** Дата создания репозитория */
+	created_at: string;
+	/** Дата последнего обновления репозитория */
+	updated_at: string;
+	/** Дата последнего push-события в репозиторий */
+	pushed_at: string;
+}
+/**
+* Интерфейс параметров для создания форка
+*/
+interface CreateForkParams {
+	/** Имя нового форка */
+	name?: string;
+	/** Название организации, в которую будет создан форк */
+	organization?: string;
+	/** Описание нового форка */
+	description?: 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 ForksApi {
+	private client;
+	/**
+	* Создает новый экземпляр API для работы с форками
+	* @param client GitVerse клиент
+	*/
+	constructor(client: GitVerseClient);
+	/**
+	* Создает форк репозитория
+	* @param owner Владелец исходного репозитория
+	* @param repo Название исходного репозитория
+	* @param params Параметры создания форка
+	* @returns Информация о созданном форке
+	*/
+	create(owner: string, repo: string, params?: CreateForkParams): Promise<Repository>;
+}
+export { ForksApi };

package/dist/api/forks.js

@@ -0,0 +1,4 @@
+class g{client;constructor(b){this.client=b}create(b,d,f){return this.client.post(`/repos/${b}/${d}/forks`,f)}}export{g as ForksApi};
+export{g as n};
+
+//# debugId=D08A809708FA35D364756E2164756E21

package/dist/api/forks.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/api/forks.ts"],
+  "sourcesContent": [
+    "import type { GitVerseClient } from \"../client\";\nimport type { CreateForkParams, Repository } from \"../types\";\n\n/**\n * API для работы с форками репозиториев\n */\nexport class ForksApi {\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   * @param params Параметры создания форка\n   * @returns Информация о созданном форке\n   */\n  create(owner: string, repo: string, params?: CreateForkParams): Promise<Repository> {\n    return this.client.post<Repository>(`/repos/${owner}/${repo}/forks`, params);\n  }\n}\n"
+  ],
+  "mappings": "AAMO,MAAM,CAAS,CACZ,OAMR,WAAW,CAAC,EAAwB,CAClC,KAAK,OAAS,EAUhB,MAAM,CAAC,EAAe,EAAc,EAAgD,CAClF,OAAO,KAAK,OAAO,KAAiB,UAAU,KAAS,UAAc,CAAM,EAE/E",
+  "debugId": "D08A809708FA35D364756E2164756E21",
+  "names": []
+}