@skillsmith/core 0.1.0

package/dist/src/sources/BaseSourceAdapter.js

@@ -0,0 +1,287 @@
+/**
+ * Base Source Adapter
+ * Abstract base class providing common functionality for source adapters
+ *
+ * SMI-1013: Enhanced with token bucket rate limiting and request queuing
+ */
+import { validateUrl } from '../validation/index.js';
+import { RateLimiter, InMemoryRateLimitStorage, RATE_LIMIT_PRESETS, } from '../security/RateLimiter.js';
+import { fetchWithRetry } from '../utils/retry.js';
+/**
+ * Default rate limit configuration (legacy window-based)
+ */
+const DEFAULT_RATE_LIMIT = {
+    maxRequests: 30,
+    windowMs: 60000,
+    minDelayMs: 150,
+};
+/**
+ * Abstract base class for source adapters
+ *
+ * Provides:
+ * - Configuration management
+ * - Rate limiting
+ * - Request timing
+ * - Error handling utilities
+ *
+ * Subclasses must implement:
+ * - search()
+ * - getRepository()
+ * - fetchSkillContent()
+ * - doHealthCheck()
+ */
+export class BaseSourceAdapter {
+    config;
+    id;
+    name;
+    type;
+    initialized = false;
+    lastRequestTime = 0;
+    requestCount = 0;
+    windowStart = 0;
+    /** Token bucket rate limiter (SMI-1013) */
+    rateLimiter = null;
+    constructor(config) {
+        this.config = {
+            ...config,
+            rateLimit: config.rateLimit ?? DEFAULT_RATE_LIMIT,
+        };
+        this.id = config.id;
+        this.name = config.name;
+        this.type = config.type;
+        // Initialize token bucket rate limiter if enabled (SMI-1013)
+        const extConfig = config;
+        if (extConfig.useTokenBucket) {
+            const tokenBucketConfig = extConfig.tokenBucketConfig ?? {
+                ...RATE_LIMIT_PRESETS.STANDARD,
+                enableQueue: true,
+                queueTimeoutMs: 30000,
+                maxQueueSize: 100,
+                keyPrefix: `adapter:${config.id}`,
+            };
+            this.rateLimiter = new RateLimiter(tokenBucketConfig, new InMemoryRateLimitStorage());
+        }
+    }
+    /**
+     * Initialize the adapter
+     * Override in subclasses for custom initialization
+     */
+    async initialize() {
+        if (this.initialized)
+            return;
+        await this.doInitialize();
+        this.initialized = true;
+    }
+    /**
+     * Subclass initialization hook
+     */
+    async doInitialize() {
+        // Default: no-op, override in subclasses
+    }
+    /**
+     * Check source health
+     */
+    async checkHealth() {
+        const startTime = Date.now();
+        try {
+            const result = await this.doHealthCheck();
+            return {
+                healthy: result.healthy ?? true,
+                responseTimeMs: Date.now() - startTime,
+                lastCheck: new Date().toISOString(),
+                rateLimitRemaining: result.rateLimitRemaining,
+                rateLimitReset: result.rateLimitReset,
+                error: result.error,
+            };
+        }
+        catch (error) {
+            return {
+                healthy: false,
+                responseTimeMs: Date.now() - startTime,
+                lastCheck: new Date().toISOString(),
+                error: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    }
+    /**
+     * Check if skill exists at location
+     */
+    async skillExists(location) {
+        try {
+            await this.fetchSkillContent(location);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get skill file SHA for change detection
+     */
+    async getSkillSha(location) {
+        try {
+            const content = await this.fetchSkillContent(location);
+            return content.sha;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Dispose of resources
+     */
+    async dispose() {
+        // SMI-1013: Dispose rate limiter
+        if (this.rateLimiter) {
+            this.rateLimiter.dispose();
+            this.rateLimiter = null;
+        }
+        await this.doDispose();
+        this.initialized = false;
+    }
+    /**
+     * Subclass disposal hook
+     */
+    async doDispose() {
+        // Default: no-op, override in subclasses
+    }
+    /**
+     * Wait for rate limit before making a request
+     */
+    async waitForRateLimit() {
+        const config = this.config.rateLimit ?? DEFAULT_RATE_LIMIT;
+        const now = Date.now();
+        // Reset window if expired
+        if (now - this.windowStart > config.windowMs) {
+            this.windowStart = now;
+            this.requestCount = 0;
+        }
+        // Check if we've exceeded the rate limit
+        if (this.requestCount >= config.maxRequests) {
+            const waitTime = config.windowMs - (now - this.windowStart);
+            if (waitTime > 0) {
+                await this.delay(waitTime);
+                this.windowStart = Date.now();
+                this.requestCount = 0;
+            }
+        }
+        // Ensure minimum delay between requests
+        const timeSinceLastRequest = now - this.lastRequestTime;
+        if (timeSinceLastRequest < config.minDelayMs) {
+            await this.delay(config.minDelayMs - timeSinceLastRequest);
+        }
+        this.lastRequestTime = Date.now();
+        this.requestCount++;
+    }
+    /**
+     * Make a rate-limited fetch request with retry support
+     *
+     * SMI-1013: Uses token bucket rate limiter with queue support when enabled,
+     * otherwise falls back to legacy window-based rate limiting.
+     *
+     * SMI-880: Automatically retries on transient network failures (ETIMEDOUT,
+     * ECONNRESET, 5xx) with exponential backoff when enableRetry is true.
+     */
+    async fetchWithRateLimit(url, options) {
+        validateUrl(url);
+        // SMI-1013: Use token bucket rate limiter if available
+        if (this.rateLimiter) {
+            // waitForToken will queue the request if rate limited
+            await this.rateLimiter.waitForToken(this.id);
+        }
+        else {
+            // Legacy window-based rate limiting
+            await this.waitForRateLimit();
+        }
+        const headers = new Headers(options?.headers);
+        // Add auth header if configured
+        if (this.config.auth?.type === 'token' && this.config.auth.credentials) {
+            headers.set('Authorization', `Bearer ${this.config.auth.credentials}`);
+        }
+        else if (this.config.auth?.type === 'basic' && this.config.auth.credentials) {
+            headers.set('Authorization', `Basic ${this.config.auth.credentials}`);
+        }
+        const fetchOptions = {
+            ...options,
+            headers,
+        };
+        // SMI-880: Use retry logic if explicitly enabled
+        const extendedConfig = this.config;
+        let response;
+        if (extendedConfig.enableRetry === true) {
+            // Opt-in retry for resilience against transient failures
+            response = await fetchWithRetry(url, fetchOptions, extendedConfig.retryConfig);
+        }
+        else {
+            response = await fetch(url, fetchOptions);
+        }
+        // Update rate limit info from response headers if available
+        this.updateRateLimitFromResponse(response);
+        return response;
+    }
+    /**
+     * Get rate limiter status (SMI-1013)
+     *
+     * Returns information about the token bucket rate limiter state,
+     * including queue status if queuing is enabled.
+     */
+    getRateLimiterStatus() {
+        if (!this.rateLimiter) {
+            return { usingTokenBucket: false };
+        }
+        return {
+            usingTokenBucket: true,
+            queueStatus: this.rateLimiter.getQueueStatus(),
+        };
+    }
+    /**
+     * Update rate limit tracking from response headers
+     */
+    updateRateLimitFromResponse(response) {
+        // Common rate limit headers (GitHub, GitLab, etc.)
+        const remaining = response.headers.get('x-ratelimit-remaining');
+        const reset = response.headers.get('x-ratelimit-reset');
+        if (remaining !== null) {
+            const remainingNum = parseInt(remaining, 10);
+            if (remainingNum <= 0 && reset) {
+                // We've hit the rate limit, update window
+                const resetTime = parseInt(reset, 10) * 1000;
+                this.windowStart = Date.now();
+                this.requestCount = this.config.rateLimit?.maxRequests ?? DEFAULT_RATE_LIMIT.maxRequests;
+            }
+        }
+    }
+    /**
+     * Build the default skill file path
+     */
+    getDefaultSkillPath(location) {
+        return location.path ?? 'SKILL.md';
+    }
+    /**
+     * Build the default branch
+     */
+    getDefaultBranch(location) {
+        return location.branch ?? 'main';
+    }
+    /**
+     * Delay helper
+     */
+    delay(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    /**
+     * Validate configuration
+     */
+    validateConfig() {
+        if (!this.config.id) {
+            throw new Error('Source adapter requires an id');
+        }
+        if (!this.config.name) {
+            throw new Error('Source adapter requires a name');
+        }
+        if (!this.config.baseUrl) {
+            throw new Error('Source adapter requires a baseUrl');
+        }
+    }
+}
+//# sourceMappingURL=BaseSourceAdapter.js.map

package/dist/src/sources/BaseSourceAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseSourceAdapter.js","sourceRoot":"","sources":["../../../src/sources/BaseSourceAdapter.ts"],"names":[],"mappings":"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"}

package/dist/src/sources/GitHubSourceAdapter.d.ts

@@ -0,0 +1,98 @@
+/**
+ * GitHub Source Adapter (SMI-590)
+ *
+ * Implements the ISourceAdapter interface for GitHub repositories.
+ * Provides search, repository metadata, and skill content fetching.
+ */
+import { BaseSourceAdapter } from './BaseSourceAdapter.js';
+import type { SourceConfig, SourceLocation, SourceRepository, SourceSearchOptions, SourceSearchResult, SkillContent, SourceHealth } from './types.js';
+/**
+ * GitHub Source Adapter
+ *
+ * Connects to GitHub API to search for and fetch skill repositories.
+ *
+ * @example
+ * ```typescript
+ * const adapter = new GitHubSourceAdapter({
+ *   id: 'github',
+ *   name: 'GitHub',
+ *   type: 'github',
+ *   baseUrl: 'https://api.github.com',
+ *   enabled: true,
+ *   auth: {
+ *     type: 'token',
+ *     credentials: process.env.GITHUB_TOKEN
+ *   }
+ * })
+ *
+ * await adapter.initialize()
+ * const result = await adapter.search({ topics: ['claude-skill'] })
+ * ```
+ */
+export declare class GitHubSourceAdapter extends BaseSourceAdapter {
+    private readonly apiBaseUrl;
+    constructor(config: SourceConfig);
+    /**
+     * Check GitHub API health via rate limit endpoint
+     */
+    protected doHealthCheck(): Promise<Partial<SourceHealth>>;
+    /**
+     * Search GitHub for skill repositories
+     */
+    search(options?: SourceSearchOptions): Promise<SourceSearchResult>;
+    /**
+     * Get repository metadata by location
+     */
+    getRepository(location: SourceLocation): Promise<SourceRepository>;
+    /**
+     * Fetch skill content from repository
+     */
+    fetchSkillContent(location: SourceLocation): Promise<SkillContent>;
+    /**
+     * Check if skill file exists
+     */
+    skillExists(location: SourceLocation): Promise<boolean>;
+    /**
+     * Get skill file SHA for change detection
+     */
+    getSkillSha(location: SourceLocation): Promise<string | null>;
+    /**
+     * Paginated search with cursor
+     */
+    searchWithCursor(options: SourceSearchOptions, page: number): Promise<SourceSearchResult>;
+    /**
+     * Map GitHub API repository to SourceRepository
+     */
+    private mapApiRepository;
+}
+/**
+ * Configuration for createGitHubAdapter factory
+ */
+export interface GitHubAdapterConfig {
+    /** Unique identifier for this source instance */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Whether this source is enabled */
+    enabled: boolean;
+    /** Base URL for API requests (default: https://api.github.com) */
+    baseUrl?: string;
+    /** Rate limiting configuration */
+    rateLimit?: {
+        maxRequests: number;
+        windowMs: number;
+        minDelayMs: number;
+    };
+    /** Authentication configuration */
+    auth?: {
+        type: 'token' | 'basic' | 'oauth' | 'none';
+        credentials?: string;
+    };
+    /** Additional source-specific options */
+    options?: Record<string, unknown>;
+}
+/**
+ * Factory function for creating GitHub adapters
+ */
+export declare function createGitHubAdapter(config: GitHubAdapterConfig): GitHubSourceAdapter;
+//# sourceMappingURL=GitHubSourceAdapter.d.ts.map

package/dist/src/sources/GitHubSourceAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitHubSourceAdapter.d.ts","sourceRoot":"","sources":["../../../src/sources/GitHubSourceAdapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAQ1D,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,EACZ,YAAY,EACb,MAAM,YAAY,CAAA;AA0EnB;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,mBAAoB,SAAQ,iBAAiB;IACxD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;gBAEvB,MAAM,EAAE,YAAY;IAMhC;;OAEG;cACa,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAoB/D;;OAEG;IACG,MAAM,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAwC5E;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAuBxE;;OAEG;IACG,iBAAiB,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC;IAoCxE;;OAEG;IACG,WAAW,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAqB7D;;OAEG;IACG,WAAW,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAsBnE;;OAEG;IACG,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA0C/F;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAqBzB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,EAAE,EAAE,MAAM,CAAA;IACV,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAA;IAChB,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,kCAAkC;IAClC,SAAS,CAAC,EAAE;QACV,WAAW,EAAE,MAAM,CAAA;QACnB,QAAQ,EAAE,MAAM,CAAA;QAChB,UAAU,EAAE,MAAM,CAAA;KACnB,CAAA;IACD,mCAAmC;IACnC,IAAI,CAAC,EAAE;QACL,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAA;QAC1C,WAAW,CAAC,EAAE,MAAM,CAAA;KACrB,CAAA;IACD,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,mBAAmB,CAMpF"}

package/dist/src/sources/GitHubSourceAdapter.js

@@ -0,0 +1,269 @@
+/**
+ * GitHub Source Adapter (SMI-590)
+ *
+ * Implements the ISourceAdapter interface for GitHub repositories.
+ * Provides search, repository metadata, and skill content fetching.
+ */
+import { BaseSourceAdapter } from './BaseSourceAdapter.js';
+import { validateUrl } from '../validation/index.js';
+import { decodeBase64Content, isRateLimitStatus, SKILL_FILE_PATHS as SHARED_SKILL_FILE_PATHS, } from './shared.js';
+import { ApiError } from '../errors/SkillsmithError.js';
+/**
+ * Default topics to search for skill repositories
+ */
+const DEFAULT_TOPICS = ['claude-code-skill', 'claude-code', 'anthropic-claude', 'claude-skill'];
+/**
+ * Default skill file paths to check (use shared paths, SMI-879)
+ */
+const SKILL_FILE_PATHS = SHARED_SKILL_FILE_PATHS;
+/**
+ * GitHub Source Adapter
+ *
+ * Connects to GitHub API to search for and fetch skill repositories.
+ *
+ * @example
+ * ```typescript
+ * const adapter = new GitHubSourceAdapter({
+ *   id: 'github',
+ *   name: 'GitHub',
+ *   type: 'github',
+ *   baseUrl: 'https://api.github.com',
+ *   enabled: true,
+ *   auth: {
+ *     type: 'token',
+ *     credentials: process.env.GITHUB_TOKEN
+ *   }
+ * })
+ *
+ * await adapter.initialize()
+ * const result = await adapter.search({ topics: ['claude-skill'] })
+ * ```
+ */
+export class GitHubSourceAdapter extends BaseSourceAdapter {
+    apiBaseUrl;
+    constructor(config) {
+        super(config);
+        this.apiBaseUrl = config.baseUrl || 'https://api.github.com';
+        validateUrl(this.apiBaseUrl);
+    }
+    /**
+     * Check GitHub API health via rate limit endpoint
+     */
+    async doHealthCheck() {
+        const response = await this.fetchWithRateLimit(`${this.apiBaseUrl}/rate_limit`);
+        if (!response.ok) {
+            return {
+                healthy: false,
+                error: `GitHub API returned ${response.status}`,
+            };
+        }
+        const data = (await response.json());
+        const searchLimit = data.resources.search;
+        return {
+            healthy: true,
+            rateLimitRemaining: searchLimit.remaining,
+            rateLimitReset: new Date(searchLimit.reset * 1000).toISOString(),
+        };
+    }
+    /**
+     * Search GitHub for skill repositories
+     */
+    async search(options = {}) {
+        await this.waitForRateLimit();
+        const topics = options.topics ?? DEFAULT_TOPICS;
+        const limit = options.limit ?? 100;
+        const perPage = Math.min(limit, 100);
+        // Build search query
+        const topicQueries = topics.map((t) => `topic:${t}`).join(' ');
+        const query = options.query ? `${options.query} ${topicQueries}` : topicQueries;
+        const searchQuery = encodeURIComponent(query);
+        const url = `${this.apiBaseUrl}/search/repositories?q=${searchQuery}&per_page=${perPage}&sort=updated&order=desc`;
+        const response = await this.fetchWithRateLimit(url);
+        if (!response.ok) {
+            if (isRateLimitStatus(response.status)) {
+                throw new ApiError('GitHub API rate limit exceeded', {
+                    statusCode: response.status,
+                    url,
+                });
+            }
+            throw new ApiError(`GitHub API error: ${response.status}`, {
+                statusCode: response.status,
+                url,
+            });
+        }
+        const data = (await response.json());
+        const repositories = data.items.map((item) => this.mapApiRepository(item));
+        return {
+            repositories,
+            totalCount: data.total_count,
+            hasMore: data.total_count > perPage,
+            nextCursor: perPage < data.total_count ? String(perPage) : undefined,
+        };
+    }
+    /**
+     * Get repository metadata by location
+     */
+    async getRepository(location) {
+        await this.waitForRateLimit();
+        const url = `${this.apiBaseUrl}/repos/${location.owner}/${location.repo}`;
+        const response = await this.fetchWithRateLimit(url);
+        if (!response.ok) {
+            if (response.status === 404) {
+                throw new ApiError(`Repository not found: ${location.owner}/${location.repo}`, {
+                    statusCode: 404,
+                    url,
+                });
+            }
+            throw new ApiError(`GitHub API error: ${response.status}`, {
+                statusCode: response.status,
+                url,
+            });
+        }
+        const data = (await response.json());
+        return this.mapApiRepository(data);
+    }
+    /**
+     * Fetch skill content from repository
+     */
+    async fetchSkillContent(location) {
+        await this.waitForRateLimit();
+        const branch = this.getDefaultBranch(location);
+        const paths = location.path ? [location.path] : SKILL_FILE_PATHS;
+        // Try each possible skill file path
+        for (const path of paths) {
+            try {
+                const url = `${this.apiBaseUrl}/repos/${location.owner}/${location.repo}/contents/${path}?ref=${branch}`;
+                const response = await this.fetchWithRateLimit(url);
+                if (response.ok) {
+                    const data = (await response.json());
+                    // SMI-879: Use shared decodeBase64Content utility
+                    const rawContent = decodeBase64Content(data.content, data.encoding);
+                    return {
+                        rawContent,
+                        sha: data.sha,
+                        location,
+                        filePath: data.path,
+                        encoding: 'utf-8',
+                    };
+                }
+            }
+            catch {
+                // Try next path
+                continue;
+            }
+        }
+        throw new Error(`No skill file found in ${location.owner}/${location.repo}. Searched: ${paths.join(', ')}`);
+    }
+    /**
+     * Check if skill file exists
+     */
+    async skillExists(location) {
+        const paths = location.path ? [location.path] : SKILL_FILE_PATHS;
+        const branch = this.getDefaultBranch(location);
+        for (const path of paths) {
+            try {
+                await this.waitForRateLimit();
+                const url = `${this.apiBaseUrl}/repos/${location.owner}/${location.repo}/contents/${path}?ref=${branch}`;
+                const response = await this.fetchWithRateLimit(url);
+                if (response.ok) {
+                    return true;
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+        return false;
+    }
+    /**
+     * Get skill file SHA for change detection
+     */
+    async getSkillSha(location) {
+        const paths = location.path ? [location.path] : SKILL_FILE_PATHS;
+        const branch = this.getDefaultBranch(location);
+        for (const path of paths) {
+            try {
+                await this.waitForRateLimit();
+                const url = `${this.apiBaseUrl}/repos/${location.owner}/${location.repo}/contents/${path}?ref=${branch}`;
+                const response = await this.fetchWithRateLimit(url);
+                if (response.ok) {
+                    const data = (await response.json());
+                    return data.sha;
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+        return null;
+    }
+    /**
+     * Paginated search with cursor
+     */
+    async searchWithCursor(options, page) {
+        await this.waitForRateLimit();
+        const topics = options.topics ?? DEFAULT_TOPICS;
+        const perPage = Math.min(options.limit ?? 30, 100);
+        // Build search query
+        const topicQueries = topics.map((t) => `topic:${t}`).join(' ');
+        const query = options.query ? `${options.query} ${topicQueries}` : topicQueries;
+        const searchQuery = encodeURIComponent(query);
+        const url = `${this.apiBaseUrl}/search/repositories?q=${searchQuery}&per_page=${perPage}&page=${page}&sort=updated&order=desc`;
+        const response = await this.fetchWithRateLimit(url);
+        if (!response.ok) {
+            if (isRateLimitStatus(response.status)) {
+                throw new ApiError('GitHub API rate limit exceeded', {
+                    statusCode: response.status,
+                    url,
+                });
+            }
+            throw new ApiError(`GitHub API error: ${response.status}`, {
+                statusCode: response.status,
+                url,
+            });
+        }
+        const data = (await response.json());
+        const repositories = data.items.map((item) => this.mapApiRepository(item));
+        const totalPages = Math.ceil(data.total_count / perPage);
+        const hasMore = page < totalPages;
+        return {
+            repositories,
+            totalCount: data.total_count,
+            hasMore,
+            nextCursor: hasMore ? String(page + 1) : undefined,
+        };
+    }
+    /**
+     * Map GitHub API repository to SourceRepository
+     */
+    mapApiRepository(item) {
+        return {
+            id: String(item.id),
+            name: item.name,
+            url: item.html_url,
+            description: item.description,
+            owner: item.owner.login,
+            defaultBranch: item.default_branch,
+            stars: item.stargazers_count,
+            forks: item.forks_count,
+            topics: item.topics || [],
+            updatedAt: item.updated_at,
+            createdAt: item.created_at,
+            license: item.license?.spdx_id ?? null,
+            metadata: {
+                fullName: item.full_name,
+            },
+        };
+    }
+}
+/**
+ * Factory function for creating GitHub adapters
+ */
+export function createGitHubAdapter(config) {
+    return new GitHubSourceAdapter({
+        ...config,
+        type: 'github',
+        baseUrl: config.baseUrl ?? 'https://api.github.com',
+    });
+}
+//# sourceMappingURL=GitHubSourceAdapter.js.map

package/dist/src/sources/GitHubSourceAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitHubSourceAdapter.js","sourceRoot":"","sources":["../../../src/sources/GitHubSourceAdapter.ts"],"names":[],"mappings":"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"}