gitverse-api-sdk 5.0.0 → 5.1.0

package/dist/api/contents.d.ts

@@ -1,389 +0,0 @@
-/**
-* Типы содержимого в репозитории
-*/
-declare const ContentType: {
-	readonly Directory: "dir"
-	readonly File: "file"
-};
-/**
-* Тип для типов содержимого
-*/
-type ContentType = (typeof ContentType)[keyof typeof ContentType];
-/**
-* Опции для выполнения HTTP-запросов
-*/
-interface RequestOptions {
-	/**
-	* AbortSignal для отмены запроса
-	* @example
-	* const controller = new AbortController();
-	* const promise = client.users.getCurrent({ signal: controller.signal });
-	* controller.abort(); // Отменяет запрос
-	*/
-	signal?: AbortSignal;
-}
-/**
-* Интерфейс информации о файле
-*/
-interface FileContent {
-	/** Имя файла */
-	name: string;
-	/** Путь к файлу относительно корня репозитория */
-	path: string;
-	/** SHA-хеш содержимого файла */
-	sha: string;
-	/** Размер файла в байтах */
-	size: number;
-	/** Тип объекта (всегда 'file' для файла) */
-	type: typeof ContentType.File;
-	/** Кодировка содержимого файла (например, 'base64') */
-	encoding?: string;
-	/** Содержимое файла в формате Base64 */
-	content?: string;
-	/** Определенный язык программирования файла */
-	language?: string;
-	/** API-ссылка на файл */
-	url?: string;
-	/** Веб-ссылка на файл */
-	html_url?: string;
-	/** Git-URL для файла */
-	git_url?: string;
-	/** URL для скачивания файла */
-	download_url?: string;
-}
-/**
-* Интерфейс информации о директории
-*/
-interface DirectoryContent {
-	/** Тип объекта (всегда 'dir' для директории) */
-	type: typeof ContentType.Directory;
-	/** Размер директории (всегда 0) */
-	size: number;
-	/** Имя директории */
-	name: string;
-	/** Путь к директории относительно корня репозитория */
-	path: string;
-	/** SHA-хеш объекта директории */
-	sha: string;
-	/** Список файлов и поддиректорий внутри директории */
-	entries: Array<FileContent | DirectoryContent>;
-}
-/**
-* Тип для содержимого репозитория (файл или директория)
-*/
-type Content = FileContent | DirectoryContent;
-/**
-* Интерфейс информации о коммите
-*/
-interface CommitInfo {
-	/** SHA-хеш коммита */
-	sha: string;
-	/** Node ID коммита */
-	node_id?: string;
-	/** API-ссылка на коммит */
-	url: string;
-	/** Веб-ссылка на коммит */
-	html_url: string;
-	/** Информация об авторе коммита */
-	author: {
-		/** Имя автора */
-		name: string
-		/** Email автора */
-		email: string
-		/** Дата создания коммита */
-		date: string
-	};
-	/** Информация о коммиттере */
-	committer: {
-		/** Имя коммиттера */
-		name: string
-		/** Email коммиттера */
-		email: string
-		/** Дата коммита */
-		date: string
-	};
-	/** Сообщение коммита */
-	message: string;
-	/** Информация о дереве коммита */
-	tree: {
-		/** SHA-хеш дерева */
-		sha: string
-		/** URL дерева */
-		url: string
-	};
-	/** Родительские коммиты */
-	parents: Array<{
-		/** SHA-хеш родительского коммита */
-		sha: string
-		/** API-ссылка на родительский коммит */
-		url: string
-		/** Веб-ссылка на родительский коммит */
-		html_url: string
-	}>;
-}
-/**
-* Интерфейс ответа на создание файла
-*/
-interface FileCreationResponse {
-	/** Информация о созданном файле */
-	content: FileContent;
-	/** Информация о коммите */
-	commit: CommitInfo;
-}
-/**
-* Интерфейс ответа на удаление файла
-*/
-interface FileDeletionResponse {
-	/** Информация о содержимом (null для удаленного файла) */
-	content: null;
-	/** Информация о коммите удаления */
-	commit: CommitInfo;
-}
-/**
-* Параметры для получения содержимого репозитория
-*/
-interface GetContentParams {
-	/** Ссылка на ветку/тег/коммит (по умолчанию основная ветка) */
-	ref?: string;
-	/** Уровень детализации информации о коммите (по умолчанию "fast") */
-	scope?: "fast" | "full";
-}
-/**
-* Интерфейс параметров для создания файла
-*/
-interface CreateFileParams {
-	/** Имя ветки, в которую будет добавлен файл (по умолчанию - основная ветка) */
-	branch?: string;
-	/** Содержимое файла, закодированное в Base64 */
-	content: string;
-	/** Сообщение коммита */
-	message?: string;
-	/** Имя новой ветки, которая будет создана для этого изменения */
-	new_branch?: string;
-	/** Добавлять ли подпись (Signed-off-by) в коммит */
-	signoff?: boolean;
-	/** Путь исходного файла (для копирования/перемещения) */
-	from_path?: string;
-	/** SHA-хеш файла (для обновления существующего файла) */
-	sha?: string;
-}
-/**
-* Интерфейс параметров для обновления файла
-*/
-interface UpdateFileParams {
-	/** Имя ветки, в которой находится файл */
-	branch?: string;
-	/** Новое содержимое файла, закодированное в Base64 */
-	content: string;
-	/** SHA-хеш текущего содержимого файла */
-	sha: string;
-	/** Если файл переименовывается, указывает старый путь к файлу */
-	from_path?: string;
-	/** Сообщение коммита */
-	message?: string;
-	/** Имя новой ветки, которая будет создана для этого изменения */
-	new_branch?: string;
-	/** Добавлять ли подпись (Signed-off-by) в коммит */
-	signoff?: boolean;
-}
-/**
-* Интерфейс параметров для удаления файла
-*/
-interface DeleteFileParams {
-	/** SHA-хеш текущего содержимого файла */
-	sha: string;
-	/** Имя ветки, в которой находится файл */
-	branch?: string;
-	/** Сообщение коммита */
-	message?: string;
-	/** Имя новой ветки, которая будет создана для этого изменения */
-	new_branch?: string;
-	/** Добавлять ли подпись (Signed-off-by) в коммит */
-	signoff?: 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 Тело запроса (опционально)
-	* @param options Опции запроса (опционально)
-	* @returns Ответ от API
-	* @throws {RateLimitError} При превышении лимита запросов (429)
-	* @throws {GitVerseApiError} При других ошибках API
-	*/
-	request<T>(path: string, method: HTTPMethods, body?: unknown, options?: RequestOptions): Promise<T>;
-	/**
-	* Выполняет GET-запрос
-	* @param path Путь к API-ресурсу
-	* @param options Опции запроса (опционально)
-	* @returns Ответ от API
-	*/
-	get<T>(path: string, options?: RequestOptions): Promise<T>;
-	/**
-	* Выполняет POST-запрос
-	* @param path Путь к API-ресурсу
-	* @param body Тело запроса
-	* @param options Опции запроса (опционально)
-	* @returns Ответ от API
-	*/
-	post<T>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
-	/**
-	* Выполняет PUT-запрос
-	* @param path Путь к API-ресурсу
-	* @param body Тело запроса
-	* @param options Опции запроса (опционально)
-	* @returns Ответ от API
-	*/
-	put<T>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
-	/**
-	* Выполняет DELETE-запрос
-	* @param path Путь к API-ресурсу
-	* @param body Тело запроса (опционально)
-	* @param options Опции запроса (опционально)
-	* @returns Ответ от API
-	*/
-	delete<T>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
-	/**
-	* Выполняет PATCH-запрос
-	* @param path Путь к API-ресурсу
-	* @param body Тело запроса
-	* @param options Опции запроса (опционально)
-	* @returns Ответ от API
-	*/
-	patch<T>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
-	/**
-	* Выполняет загрузку файла через multipart/form-data
-	* @param path Путь к API-ресурсу
-	* @param fieldName Имя поля для файла
-	* @param file Файл для загрузки (Blob или ArrayBuffer)
-	* @param fileName Имя файла
-	* @param options Опции запроса (опционально)
-	* @returns Ответ от API
-	*/
-	uploadFile<T>(path: string, fieldName: string, file: Blob | ArrayBuffer, fileName: string, options?: RequestOptions): Promise<T>;
-}
-/**
-* API для работы с содержимым репозитория (файлами и папками)
-*/
-declare class ContentsApi {
-	private client;
-	/**
-	* Создает новый экземпляр API для работы с содержимым репозитория
-	* @param client GitVerse клиент
-	*/
-	constructor(client: GitVerseClient);
-	/**
-	* Получает содержимое файла или список файлов в директории
-	* @param owner Владелец репозитория
-	* @param repo Название репозитория
-	* @param path Путь к файлу или директории
-	* @param params Параметры запроса (ref, scope)
-	* @param options Опции запроса
-	* @returns Содержимое файла или директории
-	*/
-	get(owner: string, repo: string, path: string, params?: GetContentParams, options?: RequestOptions): Promise<Content>;
-	/**
-	* Создает новый файл в репозитории
-	* @param owner Владелец репозитория
-	* @param repo Название репозитория
-	* @param path Путь к файлу, который будет создан
-	* @param params Параметры создания файла
-	* @returns Информация о созданном файле и коммите
-	*/
-	createFile(owner: string, repo: string, path: string, params: CreateFileParams, options?: RequestOptions): Promise<FileCreationResponse>;
-	/**
-	* Обновляет существующий файл в репозитории
-	* @param owner Владелец репозитория
-	* @param repo Название репозитория
-	* @param path Путь к файлу, который будет обновлен
-	* @param params Параметры обновления файла
-	* @returns Информация об обновленном файле и коммите
-	*/
-	updateFile(owner: string, repo: string, path: string, params: UpdateFileParams, options?: RequestOptions): Promise<FileCreationResponse>;
-	/**
-	* Удаляет файл из репозитория
-	* @param owner Владелец репозитория
-	* @param repo Название репозитория
-	* @param path Путь к файлу, который будет удален
-	* @param params Параметры удаления файла
-	* @returns Информация об удаленном файле и коммите
-	*/
-	deleteFile(owner: string, repo: string, path: string, params: DeleteFileParams, options?: RequestOptions): Promise<FileDeletionResponse>;
-}
-export { ContentsApi };

package/dist/api/contents.js

@@ -1,4 +0,0 @@
-class A{client;constructor(d){this.client=d}get(d,f,j,b,k){let v=new URLSearchParams;if(b?.ref)v.append("ref",b.ref);if(b?.scope)v.append("scope",b.scope);let x=v.toString(),z=`/repos/${d}/${f}/contents/${j}${x?`?${x}`:""}`;return this.client.get(z,k)}createFile(d,f,j,b,k){return this.client.put(`/repos/${d}/${f}/contents/${j}`,b,k)}updateFile(d,f,j,b,k){return this.client.put(`/repos/${d}/${f}/contents/${j}`,b,k)}deleteFile(d,f,j,b,k){return this.client.delete(`/repos/${d}/${f}/contents/${j}`,b,k)}}export{A as ContentsApi};
-export{A as a};
-
-//# debugId=434F8CC05BE6612264756E2164756E21

package/dist/api/contents.js.map

@@ -1,10 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../src/api/contents.ts"],
-  "sourcesContent": [
-    "import type { GitVerseClient } from \"../client\";\nimport type {\n  Content,\n  CreateFileParams,\n  DeleteFileParams,\n  FileCreationResponse,\n  FileDeletionResponse,\n  GetContentParams,\n  RequestOptions,\n  UpdateFileParams,\n} from \"../types\";\n\n/**\n * API для работы с содержимым репозитория (файлами и папками)\n */\nexport class ContentsApi {\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 path Путь к файлу или директории\n   * @param params Параметры запроса (ref, scope)\n   * @param options Опции запроса\n   * @returns Содержимое файла или директории\n   */\n  get(\n    owner: string,\n    repo: string,\n    path: string,\n    params?: GetContentParams,\n    options?: RequestOptions,\n  ): Promise<Content> {\n    const searchParams = new URLSearchParams();\n    if (params?.ref) searchParams.append(\"ref\", params.ref);\n    if (params?.scope) searchParams.append(\"scope\", params.scope);\n\n    const queryString = searchParams.toString();\n    const url = `/repos/${owner}/${repo}/contents/${path}${queryString ? `?${queryString}` : \"\"}`;\n\n    return this.client.get<Content>(url, options);\n  }\n\n  /**\n   * Создает новый файл в репозитории\n   * @param owner Владелец репозитория\n   * @param repo Название репозитория\n   * @param path Путь к файлу, который будет создан\n   * @param params Параметры создания файла\n   * @returns Информация о созданном файле и коммите\n   */\n  createFile(\n    owner: string,\n    repo: string,\n    path: string,\n    params: CreateFileParams,\n    options?: RequestOptions,\n  ): Promise<FileCreationResponse> {\n    return this.client.put<FileCreationResponse>(`/repos/${owner}/${repo}/contents/${path}`, params, options);\n  }\n\n  /**\n   * Обновляет существующий файл в репозитории\n   * @param owner Владелец репозитория\n   * @param repo Название репозитория\n   * @param path Путь к файлу, который будет обновлен\n   * @param params Параметры обновления файла\n   * @returns Информация об обновленном файле и коммите\n   */\n  updateFile(\n    owner: string,\n    repo: string,\n    path: string,\n    params: UpdateFileParams,\n    options?: RequestOptions,\n  ): Promise<FileCreationResponse> {\n    return this.client.put<FileCreationResponse>(`/repos/${owner}/${repo}/contents/${path}`, params, options);\n  }\n\n  /**\n   * Удаляет файл из репозитория\n   * @param owner Владелец репозитория\n   * @param repo Название репозитория\n   * @param path Путь к файлу, который будет удален\n   * @param params Параметры удаления файла\n   * @returns Информация об удаленном файле и коммите\n   */\n  deleteFile(\n    owner: string,\n    repo: string,\n    path: string,\n    params: DeleteFileParams,\n    options?: RequestOptions,\n  ): Promise<FileDeletionResponse> {\n    return this.client.delete<FileDeletionResponse>(`/repos/${owner}/${repo}/contents/${path}`, params, options);\n  }\n}\n"
-  ],
-  "mappings": "AAeO,MAAM,CAAY,CACf,OAMR,WAAW,CAAC,EAAwB,CAClC,KAAK,OAAS,EAYhB,GAAG,CACD,EACA,EACA,EACA,EACA,EACkB,CAClB,IAAM,EAAe,IAAI,gBACzB,GAAI,GAAQ,IAAK,EAAa,OAAO,MAAO,EAAO,GAAG,EACtD,GAAI,GAAQ,MAAO,EAAa,OAAO,QAAS,EAAO,KAAK,EAE5D,IAAM,EAAc,EAAa,SAAS,EACpC,EAAM,UAAU,KAAS,cAAiB,IAAO,EAAc,IAAI,IAAgB,KAEzF,OAAO,KAAK,OAAO,IAAa,EAAK,CAAO,EAW9C,UAAU,CACR,EACA,EACA,EACA,EACA,EAC+B,CAC/B,OAAO,KAAK,OAAO,IAA0B,UAAU,KAAS,cAAiB,IAAQ,EAAQ,CAAO,EAW1G,UAAU,CACR,EACA,EACA,EACA,EACA,EAC+B,CAC/B,OAAO,KAAK,OAAO,IAA0B,UAAU,KAAS,cAAiB,IAAQ,EAAQ,CAAO,EAW1G,UAAU,CACR,EACA,EACA,EACA,EACA,EAC+B,CAC/B,OAAO,KAAK,OAAO,OAA6B,UAAU,KAAS,cAAiB,IAAQ,EAAQ,CAAO,EAE/G",
-  "debugId": "434F8CC05BE6612264756E2164756E21",
-  "names": []
-}