gitverse-api-sdk 1.0.0 → 2.0.0

package/dist/api/repositories.d.ts

@@ -0,0 +1,502 @@
+/**
+* Типы пользователей в системе
+*/
+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 LanguagesResponse {
+	/** Количество байт кода на каждом языке */
+	[language: string]: number;
+}
+/**
+* Параметры для создания репозитория
+*/
+interface CreateRepositoryParams {
+	/** Имя репозитория */
+	name: string;
+	/** Описание репозитория */
+	description?: string;
+	/** Приватный ли репозиторий */
+	private?: boolean;
+	/** Создать ли инициализирующий коммит */
+	auto_init?: boolean;
+	/** Список .gitignore шаблонов */
+	gitignores?: string[];
+	/** Лицензия репозитория */
+	license?: string;
+	/** Ветка по умолчанию */
+	default_branch?: 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;
+}
+/**
+* Параметры для обновления репозитория
+*/
+interface UpdateRepositoryParams {
+	/** Новое название репозитория */
+	name?: string;
+	/** Новое описание репозитория */
+	description?: string;
+	/** Веб-сайт проекта */
+	website?: string;
+	/** Приватный ли репозиторий */
+	private?: boolean;
+	/** Разрешены ли issues */
+	has_issues?: boolean;
+	/** Разрешена ли wiki */
+	has_wiki?: boolean;
+	/** Ветка по умолчанию */
+	default_branch?: string;
+	/** Архивирован ли репозиторий */
+	archived?: boolean;
+}
+/**
+* Интерфейс результата сравнения веток/коммитов
+*/
+interface CompareResponse {
+	/** URL для сравнения */
+	url: string;
+	/** Веб-ссылка для сравнения */
+	html_url: string;
+	/** Diff-ссылка */
+	diff_url: string;
+	/** Patch-ссылка */
+	patch_url: string;
+	/** Базовый коммит */
+	base_commit: Commit;
+	/** Сравниваемый коммит */
+	merge_base_commit: Commit;
+	/** Статус сравнения */
+	status: "ahead" | "behind" | "identical" | "diverged";
+	/** Количество коммитов впереди */
+	ahead_by: number;
+	/** Количество коммитов позади */
+	behind_by: number;
+	/** Общее количество коммитов */
+	total_commits: number;
+	/** Список коммитов */
+	commits: Commit[];
+	/** Изменённые файлы */
+	files: PullRequestFile[];
+}
+/**
+* Интерфейс файла в 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 RepositoriesApi {
+	private client;
+	/**
+	* Создает новый экземпляр API для работы с репозиториями
+	* @param client GitVerse клиент
+	*/
+	constructor(client: GitVerseClient);
+	/**
+	* Получает информацию о репозитории
+	* @param owner Владелец репозитория
+	* @param repo Название репозитория
+	* @returns Данные о репозитории
+	*/
+	get(owner: string, repo: string): Promise<Repository>;
+	/**
+	* Удаляет репозиторий
+	* @param owner Владелец репозитория
+	* @param repo Название репозитория
+	* @returns Результат операции
+	*/
+	delete(owner: string, repo: string): Promise<void>;
+	/**
+	* Обновляет информацию о репозитории
+	* @param owner Владелец репозитория
+	* @param repo Название репозитория
+	* @param params Параметры для обновления
+	* @returns Обновлённый репозиторий
+	*/
+	update(owner: string, repo: string, params: UpdateRepositoryParams): Promise<Repository>;
+	/**
+	* Сравнивает две ветки или коммита
+	* @param owner Владелец репозитория
+	* @param repo Название репозитория
+	* @param basehead Строка в формате "base...head" для сравнения
+	* @returns Результат сравнения с коммитами и изменёнными файлами
+	*/
+	compare(owner: string, repo: string, basehead: string): Promise<CompareResponse>;
+	/**
+	* Получает информацию о языках программирования в репозитории
+	* @param owner Владелец репозитория
+	* @param repo Название репозитория
+	* @returns Объект с языками и количеством байт кода
+	*/
+	getLanguages(owner: string, repo: string): Promise<LanguagesResponse>;
+	/**
+	* Получает список репозиториев авторизованного пользователя
+	* @returns Массив репозиториев пользователя
+	*/
+	listForAuthenticatedUser(): Promise<Repository[]>;
+	/**
+	* Создает новый репозиторий для авторизованного пользователя
+	* @param params Параметры создания репозитория
+	* @returns Созданный репозиторий
+	*/
+	create(params: CreateRepositoryParams): Promise<Repository>;
+}
+export { RepositoriesApi };

package/dist/api/repositories.js

@@ -0,0 +1,4 @@
+class k{client;constructor(f){this.client=f}get(f,g){return this.client.get(`/repos/${f}/${g}`)}delete(f,g){return this.client.delete(`/repos/${f}/${g}`)}update(f,g,j){return this.client.patch(`/repos/${f}/${g}`,j)}compare(f,g,j){return this.client.get(`/repos/${f}/${g}/compare/${j}`)}getLanguages(f,g){return this.client.get(`/repos/${f}/${g}/languages`)}listForAuthenticatedUser(){return this.client.get("/user/repos")}create(f){return this.client.post("/user/repos",f)}}export{k as RepositoriesApi};
+export{k as g};
+
+//# debugId=0E93FD5F40DD639F64756E2164756E21

package/dist/api/repositories.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/api/repositories.ts"],
+  "sourcesContent": [
+    "import type { GitVerseClient } from \"../client\";\nimport type {\n  CompareResponse,\n  CreateRepositoryParams,\n  LanguagesResponse,\n  Repository,\n  UpdateRepositoryParams,\n} from \"../types\";\n\n/**\n * API для работы с репозиториями\n */\nexport class RepositoriesApi {\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  get(owner: string, repo: string): Promise<Repository> {\n    return this.client.get<Repository>(`/repos/${owner}/${repo}`);\n  }\n\n  /**\n   * Удаляет репозиторий\n   * @param owner Владелец репозитория\n   * @param repo Название репозитория\n   * @returns Результат операции\n   */\n  delete(owner: string, repo: string): Promise<void> {\n    return this.client.delete<void>(`/repos/${owner}/${repo}`);\n  }\n\n  /**\n   * Обновляет информацию о репозитории\n   * @param owner Владелец репозитория\n   * @param repo Название репозитория\n   * @param params Параметры для обновления\n   * @returns Обновлённый репозиторий\n   */\n  update(owner: string, repo: string, params: UpdateRepositoryParams): Promise<Repository> {\n    return this.client.patch<Repository>(`/repos/${owner}/${repo}`, params);\n  }\n\n  /**\n   * Сравнивает две ветки или коммита\n   * @param owner Владелец репозитория\n   * @param repo Название репозитория\n   * @param basehead Строка в формате \"base...head\" для сравнения\n   * @returns Результат сравнения с коммитами и изменёнными файлами\n   */\n  compare(owner: string, repo: string, basehead: string): Promise<CompareResponse> {\n    return this.client.get<CompareResponse>(`/repos/${owner}/${repo}/compare/${basehead}`);\n  }\n\n  /**\n   * Получает информацию о языках программирования в репозитории\n   * @param owner Владелец репозитория\n   * @param repo Название репозитория\n   * @returns Объект с языками и количеством байт кода\n   */\n  getLanguages(owner: string, repo: string): Promise<LanguagesResponse> {\n    return this.client.get<LanguagesResponse>(`/repos/${owner}/${repo}/languages`);\n  }\n\n  /**\n   * Получает список репозиториев авторизованного пользователя\n   * @returns Массив репозиториев пользователя\n   */\n  listForAuthenticatedUser(): Promise<Repository[]> {\n    return this.client.get<Repository[]>(\"/user/repos\");\n  }\n\n  /**\n   * Создает новый репозиторий для авторизованного пользователя\n   * @param params Параметры создания репозитория\n   * @returns Созданный репозиторий\n   */\n  create(params: CreateRepositoryParams): Promise<Repository> {\n    return this.client.post<Repository>(\"/user/repos\", params);\n  }\n}\n"
+  ],
+  "mappings": "AAYO,MAAM,CAAgB,CACnB,OAMR,WAAW,CAAC,EAAwB,CAClC,KAAK,OAAS,EAShB,GAAG,CAAC,EAAe,EAAmC,CACpD,OAAO,KAAK,OAAO,IAAgB,UAAU,KAAS,GAAM,EAS9D,MAAM,CAAC,EAAe,EAA6B,CACjD,OAAO,KAAK,OAAO,OAAa,UAAU,KAAS,GAAM,EAU3D,MAAM,CAAC,EAAe,EAAc,EAAqD,CACvF,OAAO,KAAK,OAAO,MAAkB,UAAU,KAAS,IAAQ,CAAM,EAUxE,OAAO,CAAC,EAAe,EAAc,EAA4C,CAC/E,OAAO,KAAK,OAAO,IAAqB,UAAU,KAAS,aAAgB,GAAU,EASvF,YAAY,CAAC,EAAe,EAA0C,CACpE,OAAO,KAAK,OAAO,IAAuB,UAAU,KAAS,aAAgB,EAO/E,wBAAwB,EAA0B,CAChD,OAAO,KAAK,OAAO,IAAkB,aAAa,EAQpD,MAAM,CAAC,EAAqD,CAC1D,OAAO,KAAK,OAAO,KAAiB,cAAe,CAAM,EAE7D",
+  "debugId": "0E93FD5F40DD639F64756E2164756E21",
+  "names": []
+}