gitverse-api-sdk 1.1.1 → 2.0.0

package/dist/api/pulls.d.ts

@@ -1,83 +1,3 @@
-declare const HTTPMethods: {
-	readonly DELETE: "DELETE"
-	readonly GET: "GET"
-	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;
-	/**
-	* Создает новый экземпляр GitVerse клиента
-	* @param config Конфигурация клиента
-	*/
-	constructor(config?: GitVerseClientConfig);
-	/**
-	* Устанавливает токен авторизации
-	* @param token Токен доступа
-	*/
-	setToken(token: string): void;
-	/**
-	* Выполняет API-запрос с учетом авторизации и версии API
-	* @param path Путь к API-ресурсу
-	* @param method HTTP-метод
-	* @param body Тело запроса (опционально)
-	* @returns Ответ от API
-	* @throws {Error} Если запрос завершится с ошибкой
-	*/
-	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>;
-}
 /**
 * Типы пользователей в системе
 */
@@ -319,6 +239,214 @@ interface Milestone {
 	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 {
@@ -352,5 +480,38 @@ declare class PullsApi {
 	* @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

@@ -1,4 +1,4 @@
-class k{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 j=new URL(`/repos/${d}/${g}/pulls`,"http://localhost");if(f)j.searchParams.set("state",f);return this.client.get(j.href.replace("http://localhost",""))}}export{k as PullsApi};
-export{k as b};
+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=963F71559DEBC71164756E2164756E21
+//# debugId=35A0A924DAC8BD1664756E2164756E21

package/dist/api/pulls.js.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../src/api/pulls.ts"],
   "sourcesContent": [
-    "import type { GitVerseClient } from \"../client\";\nimport type { PullRequestState } from \"../enums\";\nimport type { CreatePullRequestParams, PullRequest } from \"../types\";\n\n/**\n * API для работы с запросами на слияние (пулл-реквестами)\n */\nexport class PullsApi {\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: CreatePullRequestParams): Promise<PullRequest> {\n    return this.client.post<PullRequest>(`/repos/${owner}/${repo}/pulls`, params);\n  }\n\n  /**\n   * Получает запрос на слияние по его номеру\n   * @param owner Владелец репозитория\n   * @param repo Название репозитория\n   * @param number Номер запроса на слияние\n   * @returns Информация о запросе на слияние\n   */\n  get(owner: string, repo: string, number: number): Promise<PullRequest> {\n    return this.client.get<PullRequest>(`/repos/${owner}/${repo}/pulls/${number}`);\n  }\n\n  /**\n   * Получает список запросов на слияние в репозитории\n   * @param owner Владелец репозитория\n   * @param repo Название репозитория\n   * @param state Состояние запросов на слияние (открытые/закрытые/все)\n   * @returns Список запросов на слияние\n   */\n  list(owner: string, repo: string, state?: PullRequestState): Promise<PullRequest[]> {\n    const TEMP = \"http://localhost\";\n\n    const path = new URL(`/repos/${owner}/${repo}/pulls`, TEMP);\n    if (state) {\n      path.searchParams.set(\"state\", state);\n    }\n    return this.client.get<PullRequest[]>(path.href.replace(TEMP, \"\"));\n  }\n}\n"
+    "import type { GitVerseClient } from \"../client\";\nimport type { PullRequestState } from \"../enums\";\nimport type { Commit, CreatePullRequestParams, PullRequest, PullRequestFile, UpdatePullRequestParams } from \"../types\";\n\n/**\n * API для работы с запросами на слияние (пулл-реквестами)\n */\nexport class PullsApi {\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: CreatePullRequestParams): Promise<PullRequest> {\n    return this.client.post<PullRequest>(`/repos/${owner}/${repo}/pulls`, params);\n  }\n\n  /**\n   * Получает запрос на слияние по его номеру\n   * @param owner Владелец репозитория\n   * @param repo Название репозитория\n   * @param number Номер запроса на слияние\n   * @returns Информация о запросе на слияние\n   */\n  get(owner: string, repo: string, number: number): Promise<PullRequest> {\n    return this.client.get<PullRequest>(`/repos/${owner}/${repo}/pulls/${number}`);\n  }\n\n  /**\n   * Получает список запросов на слияние в репозитории\n   * @param owner Владелец репозитория\n   * @param repo Название репозитория\n   * @param state Состояние запросов на слияние (открытые/закрытые/все)\n   * @returns Список запросов на слияние\n   */\n  list(owner: string, repo: string, state?: PullRequestState): Promise<PullRequest[]> {\n    const TEMP = \"http://localhost\";\n\n    const path = new URL(`/repos/${owner}/${repo}/pulls`, TEMP);\n    if (state) {\n      path.searchParams.set(\"state\", state);\n    }\n    return this.client.get<PullRequest[]>(path.href.replace(TEMP, \"\"));\n  }\n\n  /**\n   * Обновляет pull request\n   * @param owner Владелец репозитория\n   * @param repo Название репозитория\n   * @param number Номер pull request\n   * @param params Параметры для обновления\n   * @returns Обновлённый pull request\n   */\n  update(owner: string, repo: string, number: number, params: UpdatePullRequestParams): Promise<PullRequest> {\n    return this.client.patch<PullRequest>(`/repos/${owner}/${repo}/pulls/${number}`, params);\n  }\n\n  /**\n   * Получает список файлов в pull request\n   * @param owner Владелец репозитория\n   * @param repo Название репозитория\n   * @param number Номер pull request\n   * @returns Список изменённых файлов\n   */\n  getFiles(owner: string, repo: string, number: number): Promise<PullRequestFile[]> {\n    return this.client.get<PullRequestFile[]>(`/repos/${owner}/${repo}/pulls/${number}/files`);\n  }\n\n  /**\n   * Обновляет ветку pull request с базовой веткой\n   * @param owner Владелец репозитория\n   * @param repo Название репозитория\n   * @param number Номер pull request\n   * @returns Результат операции\n   */\n  updateBranch(owner: string, repo: string, number: number): Promise<void> {\n    return this.client.put<void>(`/repos/${owner}/${repo}/pulls/${number}/update-branch`, {});\n  }\n\n  /**\n   * Получает список коммитов в pull request\n   * @param owner Владелец репозитория\n   * @param repo Название репозитория\n   * @param number Номер pull request\n   * @returns Список коммитов\n   */\n  getCommits(owner: string, repo: string, number: number): Promise<Commit[]> {\n    return this.client.get<Commit[]>(`/repos/${owner}/${repo}/pulls/${number}/commits`);\n  }\n}\n"
   ],
-  "mappings": "AAOO,MAAM,CAAS,CACZ,OAMR,WAAW,CAAC,EAAwB,CAClC,KAAK,OAAS,EAUhB,MAAM,CAAC,EAAe,EAAc,EAAuD,CACzF,OAAO,KAAK,OAAO,KAAkB,UAAU,KAAS,UAAc,CAAM,EAU9E,GAAG,CAAC,EAAe,EAAc,EAAsC,CACrE,OAAO,KAAK,OAAO,IAAiB,UAAU,KAAS,WAAc,GAAQ,EAU/E,IAAI,CAAC,EAAe,EAAc,EAAkD,CAGlF,IAAM,EAAO,IAAI,IAAI,UAAU,KAAS,UAF3B,kBAE6C,EAC1D,GAAI,EACF,EAAK,aAAa,IAAI,QAAS,CAAK,EAEtC,OAAO,KAAK,OAAO,IAAmB,EAAK,KAAK,QANnC,mBAMiD,EAAE,CAAC,EAErE",
-  "debugId": "963F71559DEBC71164756E2164756E21",
+  "mappings": "AAOO,MAAM,CAAS,CACZ,OAMR,WAAW,CAAC,EAAwB,CAClC,KAAK,OAAS,EAUhB,MAAM,CAAC,EAAe,EAAc,EAAuD,CACzF,OAAO,KAAK,OAAO,KAAkB,UAAU,KAAS,UAAc,CAAM,EAU9E,GAAG,CAAC,EAAe,EAAc,EAAsC,CACrE,OAAO,KAAK,OAAO,IAAiB,UAAU,KAAS,WAAc,GAAQ,EAU/E,IAAI,CAAC,EAAe,EAAc,EAAkD,CAGlF,IAAM,EAAO,IAAI,IAAI,UAAU,KAAS,UAF3B,kBAE6C,EAC1D,GAAI,EACF,EAAK,aAAa,IAAI,QAAS,CAAK,EAEtC,OAAO,KAAK,OAAO,IAAmB,EAAK,KAAK,QANnC,mBAMiD,EAAE,CAAC,EAWnE,MAAM,CAAC,EAAe,EAAc,EAAgB,EAAuD,CACzG,OAAO,KAAK,OAAO,MAAmB,UAAU,KAAS,WAAc,IAAU,CAAM,EAUzF,QAAQ,CAAC,EAAe,EAAc,EAA4C,CAChF,OAAO,KAAK,OAAO,IAAuB,UAAU,KAAS,WAAc,SAAc,EAU3F,YAAY,CAAC,EAAe,EAAc,EAA+B,CACvE,OAAO,KAAK,OAAO,IAAU,UAAU,KAAS,WAAc,kBAAwB,CAAC,CAAC,EAU1F,UAAU,CAAC,EAAe,EAAc,EAAmC,CACzE,OAAO,KAAK,OAAO,IAAc,UAAU,KAAS,WAAc,WAAgB,EAEtF",
+  "debugId": "35A0A924DAC8BD1664756E2164756E21",
   "names": []
 }