deepdebug-local-agent 0.3.1

package/src/fs-utils.js

@@ -0,0 +1,34 @@
+import fs from "fs";
+import path from "path";
+import { promisify } from "util";
+
+export const stat = promisify(fs.stat);
+export const readdir = promisify(fs.readdir);
+export const readFile = promisify(fs.readFile);
+export const writeFile = promisify(fs.writeFile);
+export const access = promisify(fs.access);
+
+export async function exists(p) {
+    try { await access(p, fs.constants.F_OK); return true; }
+    catch { return false; }
+}
+
+export async function listRecursive(root, { maxFiles = 5000, includeHidden = false } = {}) {
+    const results = [];
+    async function walk(dir) {
+        const entries = await readdir(dir, { withFileTypes: true });
+        for (const e of entries) {
+            if (!includeHidden && e.name.startsWith(".")) continue;
+            const full = path.join(dir, e.name);
+            if (e.isDirectory()) {
+                results.push({ type: "dir", path: path.relative(root, full) });
+                await walk(full);
+            } else {
+                results.push({ type: "file", path: path.relative(root, full) });
+                if (results.length >= maxFiles) return;
+            }
+        }
+    }
+    await walk(root);
+    return results;
+}

package/src/git/base-git-provider.js

@@ -0,0 +1,384 @@
+/**
+ * BaseGitProvider
+ *
+ * Interface abstrata para Git providers (GitHub, GitLab, Bitbucket).
+ * Cada provider deve implementar esta interface.
+ *
+ * @abstract
+ */
+export class BaseGitProvider {
+
+    constructor(config = {}) {
+        if (this.constructor === BaseGitProvider) {
+            throw new Error('BaseGitProvider is abstract and cannot be instantiated directly');
+        }
+
+        this.config = config;
+        this.accessToken = config.accessToken || null;
+    }
+
+    // ==========================================
+    // IDENTIFICATION
+    // ==========================================
+
+    /**
+     * Identificador único do provider
+     * @returns {string} Ex: 'github', 'gitlab', 'bitbucket'
+     */
+    getId() {
+        throw new Error('Method getId() must be implemented');
+    }
+
+    /**
+     * Nome amigável do provider
+     * @returns {string} Ex: 'GitHub', 'GitLab', 'Bitbucket'
+     */
+    getName() {
+        throw new Error('Method getName() must be implemented');
+    }
+
+    /**
+     * URL base da API
+     * @returns {string}
+     */
+    getApiBaseUrl() {
+        throw new Error('Method getApiBaseUrl() must be implemented');
+    }
+
+    // ==========================================
+    // AUTHENTICATION
+    // ==========================================
+
+    /**
+     * Define o token de acesso
+     * @param {string} token
+     */
+    setAccessToken(token) {
+        this.accessToken = token;
+    }
+
+    /**
+     * Retorna URL para OAuth authorization
+     * @param {string} redirectUri - URI de callback
+     * @param {string} state - State para CSRF protection
+     * @returns {string}
+     */
+    getAuthorizationUrl(redirectUri, state) {
+        throw new Error('Method getAuthorizationUrl() must be implemented');
+    }
+
+    /**
+     * Troca authorization code por access token
+     * @param {string} code - Authorization code
+     * @param {string} redirectUri - URI de callback
+     * @returns {Promise<TokenResponse>}
+     */
+    async exchangeCodeForToken(code, redirectUri) {
+        throw new Error('Method exchangeCodeForToken() must be implemented');
+    }
+
+    /**
+     * Valida se o token ainda é válido
+     * @returns {Promise<boolean>}
+     */
+    async validateToken() {
+        throw new Error('Method validateToken() must be implemented');
+    }
+
+    // ==========================================
+    // USER
+    // ==========================================
+
+    /**
+     * Obtém informações do usuário autenticado
+     * @returns {Promise<UserInfo>}
+     */
+    async getCurrentUser() {
+        throw new Error('Method getCurrentUser() must be implemented');
+    }
+
+    // ==========================================
+    // REPOSITORIES
+    // ==========================================
+
+    /**
+     * Lista repositórios do usuário
+     * @param {object} options - { page, perPage, sort }
+     * @returns {Promise<Repository[]>}
+     */
+    async listRepositories(options = {}) {
+        throw new Error('Method listRepositories() must be implemented');
+    }
+
+    /**
+     * Obtém informações de um repositório
+     * @param {string} owner - Owner do repo
+     * @param {string} repo - Nome do repo
+     * @returns {Promise<Repository>}
+     */
+    async getRepository(owner, repo) {
+        throw new Error('Method getRepository() must be implemented');
+    }
+
+    /**
+     * Clona um repositório
+     * @param {string} owner - Owner do repo
+     * @param {string} repo - Nome do repo
+     * @param {string} destPath - Caminho de destino
+     * @param {object} options - { branch, depth }
+     * @returns {Promise<CloneResult>}
+     */
+    async cloneRepository(owner, repo, destPath, options = {}) {
+        throw new Error('Method cloneRepository() must be implemented');
+    }
+
+    // ==========================================
+    // BRANCHES
+    // ==========================================
+
+    /**
+     * Lista branches do repositório
+     * @param {string} owner - Owner do repo
+     * @param {string} repo - Nome do repo
+     * @returns {Promise<Branch[]>}
+     */
+    async listBranches(owner, repo) {
+        throw new Error('Method listBranches() must be implemented');
+    }
+
+    /**
+     * Cria uma nova branch
+     * @param {string} owner - Owner do repo
+     * @param {string} repo - Nome do repo
+     * @param {string} branchName - Nome da nova branch
+     * @param {string} fromRef - Ref de origem (sha ou branch)
+     * @returns {Promise<Branch>}
+     */
+    async createBranch(owner, repo, branchName, fromRef) {
+        throw new Error('Method createBranch() must be implemented');
+    }
+
+    /**
+     * Obtém informações de uma branch
+     * @param {string} owner - Owner do repo
+     * @param {string} repo - Nome do repo
+     * @param {string} branch - Nome da branch
+     * @returns {Promise<Branch>}
+     */
+    async getBranch(owner, repo, branch) {
+        throw new Error('Method getBranch() must be implemented');
+    }
+
+    // ==========================================
+    // COMMITS
+    // ==========================================
+
+    /**
+     * Lista commits de uma branch
+     * @param {string} owner - Owner do repo
+     * @param {string} repo - Nome do repo
+     * @param {string} branch - Nome da branch
+     * @param {object} options - { page, perPage }
+     * @returns {Promise<Commit[]>}
+     */
+    async listCommits(owner, repo, branch, options = {}) {
+        throw new Error('Method listCommits() must be implemented');
+    }
+
+    /**
+     * Cria um commit com mudanças
+     * @param {string} owner - Owner do repo
+     * @param {string} repo - Nome do repo
+     * @param {string} branch - Nome da branch
+     * @param {string} message - Mensagem do commit
+     * @param {FileChange[]} changes - Lista de mudanças
+     * @returns {Promise<Commit>}
+     */
+    async createCommit(owner, repo, branch, message, changes) {
+        throw new Error('Method createCommit() must be implemented');
+    }
+
+    // ==========================================
+    // FILES
+    // ==========================================
+
+    /**
+     * Obtém conteúdo de um arquivo
+     * @param {string} owner - Owner do repo
+     * @param {string} repo - Nome do repo
+     * @param {string} path - Caminho do arquivo
+     * @param {string} ref - Branch ou sha
+     * @returns {Promise<FileContent>}
+     */
+    async getFileContent(owner, repo, path, ref = 'main') {
+        throw new Error('Method getFileContent() must be implemented');
+    }
+
+    /**
+     * Cria ou atualiza um arquivo
+     * @param {string} owner - Owner do repo
+     * @param {string} repo - Nome do repo
+     * @param {string} path - Caminho do arquivo
+     * @param {string} content - Conteúdo (base64 ou texto)
+     * @param {string} message - Mensagem do commit
+     * @param {string} branch - Branch
+     * @param {string} sha - SHA atual (para update)
+     * @returns {Promise<FileCommit>}
+     */
+    async createOrUpdateFile(owner, repo, path, content, message, branch, sha = null) {
+        throw new Error('Method createOrUpdateFile() must be implemented');
+    }
+
+    // ==========================================
+    // PULL REQUESTS
+    // ==========================================
+
+    /**
+     * Lista pull requests
+     * @param {string} owner - Owner do repo
+     * @param {string} repo - Nome do repo
+     * @param {object} options - { state, page, perPage }
+     * @returns {Promise<PullRequest[]>}
+     */
+    async listPullRequests(owner, repo, options = {}) {
+        throw new Error('Method listPullRequests() must be implemented');
+    }
+
+    /**
+     * Cria um pull request
+     * @param {string} owner - Owner do repo
+     * @param {string} repo - Nome do repo
+     * @param {object} pr - { title, body, head, base }
+     * @returns {Promise<PullRequest>}
+     */
+    async createPullRequest(owner, repo, pr) {
+        throw new Error('Method createPullRequest() must be implemented');
+    }
+
+    /**
+     * Obtém informações de um pull request
+     * @param {string} owner - Owner do repo
+     * @param {string} repo - Nome do repo
+     * @param {number} prNumber - Número do PR
+     * @returns {Promise<PullRequest>}
+     */
+    async getPullRequest(owner, repo, prNumber) {
+        throw new Error('Method getPullRequest() must be implemented');
+    }
+
+    // ==========================================
+    // WEBHOOKS
+    // ==========================================
+
+    /**
+     * Cria um webhook
+     * @param {string} owner - Owner do repo
+     * @param {string} repo - Nome do repo
+     * @param {object} webhook - { url, events, secret }
+     * @returns {Promise<Webhook>}
+     */
+    async createWebhook(owner, repo, webhook) {
+        throw new Error('Method createWebhook() must be implemented');
+    }
+
+    // ==========================================
+    // HELPER METHODS
+    // ==========================================
+
+    /**
+     * Constrói URL de clone
+     * @param {string} owner - Owner do repo
+     * @param {string} repo - Nome do repo
+     * @param {boolean} useHttps - Usar HTTPS (default) ou SSH
+     * @returns {string}
+     */
+    getCloneUrl(owner, repo, useHttps = true) {
+        throw new Error('Method getCloneUrl() must be implemented');
+    }
+
+    /**
+     * Parsea URL de repositório para extrair owner e repo
+     * @param {string} url - URL do repositório
+     * @returns {{ owner: string, repo: string }}
+     */
+    parseRepositoryUrl(url) {
+        throw new Error('Method parseRepositoryUrl() must be implemented');
+    }
+}
+
+// ==========================================
+// TYPE DEFINITIONS
+// ==========================================
+
+/**
+ * @typedef {object} TokenResponse
+ * @property {string} accessToken
+ * @property {string} tokenType
+ * @property {string} [refreshToken]
+ * @property {number} [expiresIn]
+ */
+
+/**
+ * @typedef {object} UserInfo
+ * @property {string} id
+ * @property {string} username
+ * @property {string} email
+ * @property {string} name
+ * @property {string} avatarUrl
+ */
+
+/**
+ * @typedef {object} Repository
+ * @property {string} id
+ * @property {string} name
+ * @property {string} fullName
+ * @property {string} description
+ * @property {string} defaultBranch
+ * @property {boolean} private
+ * @property {string} cloneUrl
+ * @property {string} htmlUrl
+ */
+
+/**
+ * @typedef {object} Branch
+ * @property {string} name
+ * @property {string} sha
+ * @property {boolean} protected
+ */
+
+/**
+ * @typedef {object} Commit
+ * @property {string} sha
+ * @property {string} message
+ * @property {string} authorName
+ * @property {string} authorEmail
+ * @property {Date} date
+ */
+
+/**
+ * @typedef {object} FileChange
+ * @property {string} path
+ * @property {string} content
+ * @property {string} action - 'create' | 'update' | 'delete'
+ */
+
+/**
+ * @typedef {object} FileContent
+ * @property {string} path
+ * @property {string} content
+ * @property {string} sha
+ * @property {string} encoding
+ */
+
+/**
+ * @typedef {object} PullRequest
+ * @property {number} number
+ * @property {string} title
+ * @property {string} body
+ * @property {string} state
+ * @property {string} head
+ * @property {string} base
+ * @property {string} htmlUrl
+ */
+
+export default BaseGitProvider;

package/src/git/git-provider-registry.js

@@ -0,0 +1,110 @@
+import { GitHubProvider } from './github-provider.js';
+
+/**
+ * GitProviderRegistry
+ *
+ * Factory/Registry para gerenciar Git providers.
+ */
+export class GitProviderRegistry {
+
+    constructor() {
+        this.providers = new Map();
+        this.registerDefaults();
+    }
+
+    registerDefaults() {
+        // Registrar providers disponíveis
+        this.register('github', GitHubProvider);
+
+        // GitLab e Bitbucket serão implementados depois
+        // this.register('gitlab', GitLabProvider);
+        // this.register('bitbucket', BitbucketProvider);
+    }
+
+    /**
+     * Registra um provider
+     * @param {string} id - ID do provider
+     * @param {class} ProviderClass - Classe do provider
+     */
+    register(id, ProviderClass) {
+        this.providers.set(id, ProviderClass);
+        console.log(`📦 Registered git provider: ${id}`);
+    }
+
+    /**
+     * Cria instância de um provider
+     * @param {string} id - ID do provider
+     * @param {object} config - Configuração do provider
+     * @returns {BaseGitProvider}
+     */
+    create(id, config = {}) {
+        const ProviderClass = this.providers.get(id);
+
+        if (!ProviderClass) {
+            throw new Error(`Git provider not found: ${id}`);
+        }
+
+        return new ProviderClass(config);
+    }
+
+    /**
+     * Lista IDs dos providers disponíveis
+     * @returns {string[]}
+     */
+    listProviders() {
+        return Array.from(this.providers.keys());
+    }
+
+    /**
+     * Detecta provider a partir da URL
+     * @param {string} url - URL do repositório
+     * @returns {string|null} - ID do provider
+     */
+    detectProviderFromUrl(url) {
+        if (url.includes('github.com')) {
+            return 'github';
+        }
+        if (url.includes('gitlab.com') || url.includes('gitlab')) {
+            return 'gitlab';
+        }
+        if (url.includes('bitbucket.org') || url.includes('bitbucket')) {
+            return 'bitbucket';
+        }
+        return null;
+    }
+
+    /**
+     * Cria provider a partir da URL do repositório
+     * @param {string} url - URL do repositório
+     * @param {object} config - Configuração
+     * @returns {BaseGitProvider}
+     */
+    createFromUrl(url, config = {}) {
+        const providerId = this.detectProviderFromUrl(url);
+
+        if (!providerId) {
+            throw new Error(`Unable to detect git provider from URL: ${url}`);
+        }
+
+        return this.create(providerId, config);
+    }
+}
+
+// ==========================================
+// SINGLETON INSTANCE
+// ==========================================
+
+let instance = null;
+
+/**
+ * Obtém instância singleton do GitProviderRegistry
+ * @returns {GitProviderRegistry}
+ */
+export function getGitProviderRegistry() {
+    if (!instance) {
+        instance = new GitProviderRegistry();
+    }
+    return instance;
+}
+
+export default GitProviderRegistry;