gitverse-api-sdk 1.0.0 → 2.0.0

package/dist/api/organizations.d.ts

@@ -0,0 +1,140 @@
+/**
+* Предупреждение об устаревшей версии 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 OrganizationsApi {
+	private client;
+	/**
+	* Создает новый экземпляр API для работы с организациями
+	* @param client GitVerse клиент
+	*/
+	constructor(client: GitVerseClient);
+	/**
+	* Проверяет членство пользователя в организации
+	* @param org Название организации
+	* @param username Имя пользователя
+	* @returns true если пользователь является членом организации, false если нет
+	*/
+	checkMembership(org: string, username: string): Promise<boolean>;
+}
+export { OrganizationsApi };

package/dist/api/organizations.js

@@ -0,0 +1,4 @@
+class j{client;constructor(b){this.client=b}async checkMembership(b,h){try{return await this.client.get(`/orgs/${b}/members/${h}`),!0}catch(d){if(d instanceof Error&&d.message.includes("404"))return!1;throw d}}}export{j as OrganizationsApi};
+export{j as a};
+
+//# debugId=C13270CF8AD6E2A964756E2164756E21

package/dist/api/organizations.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/api/organizations.ts"],
+  "sourcesContent": [
+    "import type { GitVerseClient } from \"../client\";\n\n/**\n * API для работы с организациями\n */\nexport class OrganizationsApi {\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 org Название организации\n   * @param username Имя пользователя\n   * @returns true если пользователь является членом организации, false если нет\n   */\n  async checkMembership(org: string, username: string): Promise<boolean> {\n    try {\n      await this.client.get<void>(`/orgs/${org}/members/${username}`);\n      return true;\n    } catch (error: unknown) {\n      if (error instanceof Error && error.message.includes(\"404\")) {\n        return false;\n      }\n      throw error;\n    }\n  }\n}\n"
+  ],
+  "mappings": "AAKO,MAAM,CAAiB,CACpB,OAMR,WAAW,CAAC,EAAwB,CAClC,KAAK,OAAS,OASV,gBAAe,CAAC,EAAa,EAAoC,CACrE,GAAI,CAEF,OADA,MAAM,KAAK,OAAO,IAAU,SAAS,aAAe,GAAU,EACvD,GACP,MAAO,EAAgB,CACvB,GAAI,aAAiB,OAAS,EAAM,QAAQ,SAAS,KAAK,EACxD,MAAO,GAET,MAAM,GAGZ",
+  "debugId": "C13270CF8AD6E2A964756E2164756E21",
+  "names": []
+}

package/dist/api/pulls.d.ts

@@ -0,0 +1,517 @@
+/**
+* Типы пользователей в системе
+*/
+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];
+/**
+* Состояния pull request
+*/
+declare const PullRequestState: {
+	readonly Closed: "closed"
+	readonly Open: "open"
+};
+/**
+* Тип для состояний pull request
+*/
+type PullRequestState = (typeof PullRequestState)[keyof typeof PullRequestState];
+/**
+* Интерфейс пользователя
+*/
+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;
+}
+/**
+* Интерфейс базовой или целевой ветки для pull request
+*/
+interface PullRequestBase {
+	/** Метка ветки */
+	label: string;
+	/** Имя ветки */
+	ref: string;
+	/** SHA-хеш последнего коммита в ветке */
+	sha: string;
+	/** ID репозитория */
+	repo_id: number;
+	/** Информация о репозитории */
+	repo: {
+		/** ID репозитория */
+		id: number
+		/** Название репозитория */
+		name: string
+		/** Полное название репозитория в формате {owner}/{repo} */
+		full_name: string
+		/** Является ли репозиторий приватным */
+		private: boolean
+		/** Основная ветка репозитория */
+		default_branch: string
+	};
+}
+/**
+* Интерфейс pull request
+*/
+interface PullRequest {
+	/** Уникальный идентификатор pull request */
+	id: number;
+	/** API-ссылка на pull request */
+	url: string;
+	/** Номер pull request в репозитории */
+	number: number;
+	/** Информация о пользователе, создавшем pull request */
+	user: {
+		/** ID пользователя */
+		id: number
+		/** Логин пользователя */
+		login: string
+		/** Тип аккаунта */
+		type: string
+		/** URL аватара пользователя */
+		avatar_url: string
+		/** Веб-ссылка на профиль пользователя */
+		html_url: string
+		/** Права администратора */
+		site_admin: boolean
+	};
+	/** Заголовок pull request */
+	title: string;
+	/** Описание pull request */
+	body?: string;
+	/** Список меток */
+	labels: Label[];
+	/** Информация о майлстоуне */
+	milestone?: Milestone;
+	/** Информация о назначенном пользователе */
+	assignee?: User2;
+	/** Список назначенных пользователей */
+	assignees?: User2[];
+	/** Состояние pull request (открыт/закрыт) */
+	state: PullRequestState;
+	/** Заблокирован ли pull request */
+	locked: boolean;
+	/** Количество комментариев */
+	comments: number;
+	/** Веб-ссылка на pull request */
+	html_url: string;
+	/** Ссылка на diff файл */
+	diff_url: string;
+	/** Ссылка на patch файл */
+	patch_url: string;
+	/** Можно ли слить pull request */
+	mergeable: boolean;
+	/** Был ли pull request слит */
+	merged: boolean;
+	/** Дата слияния (если был слит) */
+	merged_at?: string | null;
+	/** SHA-хеш коммита слияния (если был слит) */
+	merge_commit_sha?: string | null;
+	/** Пользователь, выполнивший слияние */
+	merged_by?: User2 | null;
+	/** Может ли мейнтейнер изменять pull request */
+	maintainer_can_modify: boolean;
+	/** Информация о целевой ветке */
+	base: PullRequestBase;
+	/** Информация о ветке с изменениями */
+	head: PullRequestBase;
+	/** Дата создания pull request */
+	created_at: string;
+	/** Дата обновления pull request */
+	updated_at: string;
+	/** Дата закрытия pull request (если закрыт) */
+	closed_at?: string | null;
+}
+/**
+* Интерфейс параметров для создания pull request
+*/
+interface CreatePullRequestParams {
+	/** Заголовок pull request */
+	title: string;
+	/** Описание pull request */
+	body?: string;
+	/** Имя ветки, из которой предлагаются изменения */
+	head: string;
+	/** Имя ветки, в которую будут внесены изменения */
+	base: string;
+}
+/**
+* Интерфейс метки (label) для issues и pull requests
+*/
+interface Label {
+	/** Идентификатор метки */
+	id: number;
+	/** Имя метки */
+	name: string;
+	/** Описание метки */
+	description?: string;
+	/** Цвет метки в формате HEX */
+	color: string;
+	/** URL метки */
+	url?: string;
+}
+/**
+* Интерфейс майлстоуна (milestone)
+*/
+interface Milestone {
+	/** Идентификатор майлстоуна */
+	id: number;
+	/** Номер майлстоуна */
+	number: number;
+	/** Название майлстоуна */
+	title: string;
+	/** Описание майлстоуна */
+	description?: string;
+	/** Создатель майлстоуна */
+	creator: User2;
+	/** Состояние майлстоуна (open/closed) */
+	state: "open" | "closed";
+	/** Количество открытых задач */
+	open_issues: number;
+	/** Количество закрытых задач */
+	closed_issues: number;
+	/** Дата создания */
+	created_at: string;
+	/** Дата обновления */
+	updated_at: string;
+	/** Дата окончания (due date) */
+	due_on?: string;
+}
+/**
+* Интерфейс коммита
+*/
+interface Commit {
+	/** SHA-хеш коммита */
+	sha: string;
+	/** Node ID коммита */
+	node_id?: string;
+	/** Информация о коммите */
+	commit: {
+		/** Автор коммита */
+		author: {
+			name: string
+			email: string
+			date: string
+		}
+		/** Коммиттер */
+		committer: {
+			name: string
+			email: string
+			date: string
+		}
+		/** Сообщение коммита */
+		message: string
+		/** Дерево коммита */
+		tree: {
+			sha: string
+			url: string
+		}
+	};
+	/** Автор (пользователь GitVerse) */
+	author?: User2 | null;
+	/** Коммиттер (пользователь GitVerse) */
+	committer?: User2 | null;
+	/** Родительские коммиты */
+	parents: Array<{
+		sha: string
+		url: string
+		html_url: string
+	}>;
+	/** API-ссылка на коммит */
+	url: string;
+	/** Веб-ссылка на коммит */
+	html_url: string;
+}
+/**
+* Параметры для обновления pull request
+*/
+interface UpdatePullRequestParams {
+	/** Новый заголовок */
+	title?: string;
+	/** Новое описание */
+	body?: string;
+	/** Новое состояние */
+	state?: PullRequestState;
+	/** Базовая ветка */
+	base?: string;
+	/** Можно ли мейнтейнерам модифицировать */
+	maintainer_can_modify?: boolean;
+}
+/**
+* Интерфейс файла в pull request
+*/
+interface PullRequestFile {
+	/** SHA-хеш файла */
+	sha: string;
+	/** Имя файла */
+	filename: string;
+	/** Статус изменения */
+	status: "added" | "removed" | "modified" | "renamed" | "copied" | "changed" | "unchanged";
+	/** Количество добавленных строк */
+	additions: number;
+	/** Количество удалённых строк */
+	deletions: number;
+	/** Общее количество изменений */
+	changes: number;
+	/** URL для получения содержимого */
+	blob_url: string;
+	/** Raw URL */
+	raw_url: string;
+	/** API URL */
+	contents_url: string;
+	/** Patch для файла */
+	patch?: string;
+	/** Предыдущее имя файла (для переименованных) */
+	previous_filename?: 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 PullsApi {
+	private client;
+	/**
+	* Создает новый экземпляр API для работы с пулл-реквестами
+	* @param client GitVerse клиент
+	*/
+	constructor(client: GitVerseClient);
+	/**
+	* Создает новый запрос на слияние в репозитории
+	* @param owner Владелец репозитория
+	* @param repo Название репозитория
+	* @param params Параметры создания запроса на слияние
+	* @returns Информация о созданном запросе на слияние
+	*/
+	create(owner: string, repo: string, params: CreatePullRequestParams): Promise<PullRequest>;
+	/**
+	* Получает запрос на слияние по его номеру
+	* @param owner Владелец репозитория
+	* @param repo Название репозитория
+	* @param number Номер запроса на слияние
+	* @returns Информация о запросе на слияние
+	*/
+	get(owner: string, repo: string, number: number): Promise<PullRequest>;
+	/**
+	* Получает список запросов на слияние в репозитории
+	* @param owner Владелец репозитория
+	* @param repo Название репозитория
+	* @param state Состояние запросов на слияние (открытые/закрытые/все)
+	* @returns Список запросов на слияние
+	*/
+	list(owner: string, repo: string, state?: PullRequestState): Promise<PullRequest[]>;
+	/**
+	* Обновляет pull request
+	* @param owner Владелец репозитория
+	* @param repo Название репозитория
+	* @param number Номер pull request
+	* @param params Параметры для обновления
+	* @returns Обновлённый pull request
+	*/
+	update(owner: string, repo: string, number: number, params: UpdatePullRequestParams): Promise<PullRequest>;
+	/**
+	* Получает список файлов в pull request
+	* @param owner Владелец репозитория
+	* @param repo Название репозитория
+	* @param number Номер pull request
+	* @returns Список изменённых файлов
+	*/
+	getFiles(owner: string, repo: string, number: number): Promise<PullRequestFile[]>;
+	/**
+	* Обновляет ветку pull request с базовой веткой
+	* @param owner Владелец репозитория
+	* @param repo Название репозитория
+	* @param number Номер pull request
+	* @returns Результат операции
+	*/
+	updateBranch(owner: string, repo: string, number: number): Promise<void>;
+	/**
+	* Получает список коммитов в pull request
+	* @param owner Владелец репозитория
+	* @param repo Название репозитория
+	* @param number Номер pull request
+	* @returns Список коммитов
+	*/
+	getCommits(owner: string, repo: string, number: number): Promise<Commit[]>;
+}
+export { PullsApi };

package/dist/api/pulls.js

@@ -0,0 +1,4 @@
+class v{client;constructor(d){this.client=d}create(d,g,f){return this.client.post(`/repos/${d}/${g}/pulls`,f)}get(d,g,f){return this.client.get(`/repos/${d}/${g}/pulls/${f}`)}list(d,g,f){let k=new URL(`/repos/${d}/${g}/pulls`,"http://localhost");if(f)k.searchParams.set("state",f);return this.client.get(k.href.replace("http://localhost",""))}update(d,g,f,j){return this.client.patch(`/repos/${d}/${g}/pulls/${f}`,j)}getFiles(d,g,f){return this.client.get(`/repos/${d}/${g}/pulls/${f}/files`)}updateBranch(d,g,f){return this.client.put(`/repos/${d}/${g}/pulls/${f}/update-branch`,{})}getCommits(d,g,f){return this.client.get(`/repos/${d}/${g}/pulls/${f}/commits`)}}export{v as PullsApi};
+export{v as m};
+
+//# debugId=35A0A924DAC8BD1664756E2164756E21