@stoneforge/quarry 1.10.2 → 1.13.0

package/dist/external-sync/providers/github/github-api.js

@@ -0,0 +1,366 @@
+/**
+ * GitHub REST API Client
+ *
+ * Pure fetch-based client for GitHub issue operations.
+ * Supports Personal Access Token (PAT) auth, rate limit handling,
+ * and configurable base URL for GitHub Enterprise.
+ *
+ * No external dependencies — uses only the standard fetch API.
+ */
+// ============================================================================
+// Error Types
+// ============================================================================
+/**
+ * Typed error for GitHub API failures.
+ * Wraps fetch errors with status code, message, and rate limit info.
+ */
+export class GitHubApiError extends Error {
+    /** HTTP status code from GitHub's response */
+    status;
+    /** Human-readable error message from GitHub */
+    statusText;
+    /** Rate limit information at the time of the error */
+    rateLimit;
+    /** Parsed error body from GitHub (if available) */
+    responseBody;
+    constructor(message, status, statusText, rateLimit = null, responseBody = null, cause) {
+        super(message);
+        this.name = 'GitHubApiError';
+        this.status = status;
+        this.statusText = statusText;
+        this.rateLimit = rateLimit;
+        this.responseBody = responseBody;
+        this.cause = cause;
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, GitHubApiError);
+        }
+    }
+    /**
+     * Whether this error is due to rate limiting
+     */
+    get isRateLimited() {
+        return this.status === 403 && this.rateLimit !== null && this.rateLimit.remaining === 0;
+    }
+    /**
+     * Whether this error is due to authentication failure
+     */
+    get isAuthError() {
+        return this.status === 401;
+    }
+    /**
+     * Whether this error is a not-found response
+     */
+    get isNotFound() {
+        return this.status === 404;
+    }
+    /**
+     * Returns a JSON-serializable representation of the error
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            status: this.status,
+            statusText: this.statusText,
+            rateLimit: this.rateLimit,
+            responseBody: this.responseBody,
+        };
+    }
+}
+/**
+ * Type guard for GitHubApiError
+ */
+export function isGitHubApiError(error) {
+    return error instanceof GitHubApiError;
+}
+// ============================================================================
+// Rate Limit Warning Threshold
+// ============================================================================
+/** Default threshold of remaining requests before logging a warning */
+const DEFAULT_RATE_LIMIT_WARNING_THRESHOLD = 10;
+// ============================================================================
+// Client Implementation
+// ============================================================================
+/**
+ * Fetch-based GitHub REST API client for issue operations.
+ *
+ * Features:
+ * - Personal Access Token (PAT) authentication
+ * - Rate limit tracking with warnings when approaching limit
+ * - Configurable base URL for GitHub Enterprise
+ * - Typed errors with status code and rate limit info
+ * - Automatic pagination for listing issues
+ *
+ * @example
+ * ```typescript
+ * const client = new GitHubApiClient({ token: 'ghp_...' });
+ * const issue = await client.getIssue('owner', 'repo', 42);
+ * const issues = await client.listIssues('owner', 'repo', { state: 'open' });
+ * ```
+ */
+export class GitHubApiClient {
+    token;
+    apiBaseUrl;
+    rateLimitWarningThreshold;
+    /** Most recently observed rate limit info (updated after each request) */
+    lastRateLimit = null;
+    constructor(options) {
+        if (!options.token) {
+            throw new Error('GitHub API token is required');
+        }
+        this.token = options.token;
+        this.apiBaseUrl = (options.apiBaseUrl ?? 'https://api.github.com').replace(/\/$/, '');
+        this.rateLimitWarningThreshold =
+            options.rateLimitWarningThreshold ?? DEFAULT_RATE_LIMIT_WARNING_THRESHOLD;
+    }
+    /**
+     * Returns the most recently observed rate limit info, or null if no requests have been made.
+     */
+    getRateLimit() {
+        return this.lastRateLimit;
+    }
+    // --------------------------------------------------------------------------
+    // Public API Methods
+    // --------------------------------------------------------------------------
+    /**
+     * Fetch a single issue by number.
+     *
+     * GET /repos/{owner}/{repo}/issues/{issue_number}
+     */
+    async getIssue(owner, repo, issueNumber) {
+        return this.request('GET', `/repos/${enc(owner)}/${enc(repo)}/issues/${issueNumber}`);
+    }
+    /**
+     * List issues for a repository.
+     *
+     * GET /repos/{owner}/{repo}/issues?since=...&state=all
+     *
+     * When no explicit `page` is provided, this method automatically iterates
+     * through all pages using the Link header and returns every matching issue.
+     * When a `page` is specified, only that single page is returned.
+     */
+    async listIssues(owner, repo, options = {}) {
+        const params = new URLSearchParams();
+        if (options.since)
+            params.set('since', options.since);
+        if (options.state)
+            params.set('state', options.state);
+        if (options.per_page)
+            params.set('per_page', String(options.per_page));
+        // If a specific page was requested, fetch only that page
+        if (options.page !== undefined) {
+            params.set('page', String(options.page));
+            const path = `/repos/${enc(owner)}/${enc(repo)}/issues`;
+            const queryString = params.toString();
+            const url = queryString ? `${path}?${queryString}` : path;
+            return this.request('GET', url);
+        }
+        // Otherwise, auto-paginate through all pages
+        return this.paginatedRequest(`/repos/${enc(owner)}/${enc(repo)}/issues`, params);
+    }
+    /**
+     * Create a new issue.
+     *
+     * POST /repos/{owner}/{repo}/issues
+     */
+    async createIssue(owner, repo, input) {
+        return this.request('POST', `/repos/${enc(owner)}/${enc(repo)}/issues`, input);
+    }
+    /**
+     * Update an existing issue.
+     *
+     * PATCH /repos/{owner}/{repo}/issues/{issue_number}
+     */
+    async updateIssue(owner, repo, issueNumber, updates) {
+        return this.request('PATCH', `/repos/${enc(owner)}/${enc(repo)}/issues/${issueNumber}`, updates);
+    }
+    /**
+     * List all labels for a repository.
+     *
+     * GET /repos/{owner}/{repo}/labels
+     *
+     * Auto-paginates through all pages to return the complete label set.
+     */
+    async getLabels(owner, repo) {
+        return this.paginatedRequest(`/repos/${enc(owner)}/${enc(repo)}/labels`, new URLSearchParams());
+    }
+    /**
+     * Create a new label on a repository.
+     *
+     * POST /repos/{owner}/{repo}/labels
+     */
+    async createLabel(owner, repo, input) {
+        return this.request('POST', `/repos/${enc(owner)}/${enc(repo)}/labels`, input);
+    }
+    // --------------------------------------------------------------------------
+    // Internal: HTTP Request Handling
+    // --------------------------------------------------------------------------
+    /**
+     * Performs a single HTTP request to the GitHub API.
+     */
+    async request(method, path, body) {
+        const url = `${this.apiBaseUrl}${path}`;
+        const headers = {
+            Authorization: `Bearer ${this.token}`,
+            Accept: 'application/vnd.github+json',
+            'X-GitHub-Api-Version': '2022-11-28',
+        };
+        if (body !== undefined) {
+            headers['Content-Type'] = 'application/json';
+        }
+        let response;
+        try {
+            response = await fetch(url, {
+                method,
+                headers,
+                body: body !== undefined ? JSON.stringify(body) : undefined,
+            });
+        }
+        catch (err) {
+            throw new GitHubApiError(`Network error requesting ${method} ${path}: ${err instanceof Error ? err.message : String(err)}`, 0, 'Network Error', null, null, err instanceof Error ? err : undefined);
+        }
+        // Parse rate limit headers from every response
+        const rateLimit = parseRateLimitHeaders(response.headers);
+        if (rateLimit) {
+            this.lastRateLimit = rateLimit;
+            this.checkRateLimitWarning(rateLimit, method, path);
+        }
+        if (!response.ok) {
+            await this.handleErrorResponse(response, rateLimit, method, path);
+        }
+        return (await response.json());
+    }
+    /**
+     * Performs a paginated request, following Link headers to collect all pages.
+     */
+    async paginatedRequest(basePath, params) {
+        const allItems = [];
+        // Start at page 1 if not set
+        if (!params.has('page')) {
+            params.set('page', '1');
+        }
+        // Default to 100 per page for efficiency if not set
+        if (!params.has('per_page')) {
+            params.set('per_page', '100');
+        }
+        let nextUrl = `${this.apiBaseUrl}${basePath}?${params.toString()}`;
+        while (nextUrl) {
+            const headers = {
+                Authorization: `Bearer ${this.token}`,
+                Accept: 'application/vnd.github+json',
+                'X-GitHub-Api-Version': '2022-11-28',
+            };
+            let response;
+            try {
+                response = await fetch(nextUrl, { method: 'GET', headers });
+            }
+            catch (err) {
+                throw new GitHubApiError(`Network error during paginated request to ${nextUrl}: ${err instanceof Error ? err.message : String(err)}`, 0, 'Network Error', null, null, err instanceof Error ? err : undefined);
+            }
+            const rateLimit = parseRateLimitHeaders(response.headers);
+            if (rateLimit) {
+                this.lastRateLimit = rateLimit;
+                this.checkRateLimitWarning(rateLimit, 'GET', basePath);
+            }
+            if (!response.ok) {
+                await this.handleErrorResponse(response, rateLimit, 'GET', basePath);
+            }
+            const items = (await response.json());
+            allItems.push(...items);
+            // Parse Link header for next page
+            nextUrl = parseLinkHeaderNext(response.headers.get('Link'));
+        }
+        return allItems;
+    }
+    // --------------------------------------------------------------------------
+    // Internal: Error and Rate Limit Handling
+    // --------------------------------------------------------------------------
+    /**
+     * Handles non-OK responses by throwing a GitHubApiError.
+     */
+    async handleErrorResponse(response, rateLimit, method, path) {
+        let responseBody = null;
+        let errorMessage;
+        try {
+            responseBody = (await response.json());
+            errorMessage =
+                typeof responseBody.message === 'string'
+                    ? responseBody.message
+                    : `GitHub API error: ${response.status} ${response.statusText}`;
+        }
+        catch {
+            errorMessage = `GitHub API error: ${response.status} ${response.statusText}`;
+        }
+        // Special messaging for rate limit exhaustion
+        if (response.status === 403 && rateLimit && rateLimit.remaining === 0) {
+            const resetDate = new Date(rateLimit.reset * 1000);
+            errorMessage = `GitHub API rate limit exhausted. Resets at ${resetDate.toISOString()} (${rateLimit.reset}). ${errorMessage}`;
+        }
+        throw new GitHubApiError(`${method} ${path} failed: ${errorMessage}`, response.status, response.statusText, rateLimit, responseBody);
+    }
+    /**
+     * Logs a warning when rate limit is approaching exhaustion.
+     */
+    checkRateLimitWarning(rateLimit, method, path) {
+        if (rateLimit.remaining <= this.rateLimitWarningThreshold && rateLimit.remaining > 0) {
+            const resetDate = new Date(rateLimit.reset * 1000);
+            console.warn(`[GitHubApiClient] Rate limit warning: ${rateLimit.remaining}/${rateLimit.limit} requests remaining. ` +
+                `Resets at ${resetDate.toISOString()}. ` +
+                `Triggered by ${method} ${path}`);
+        }
+    }
+}
+// ============================================================================
+// Utility Functions
+// ============================================================================
+/**
+ * URI-encodes a path segment for safe inclusion in URLs.
+ */
+function enc(value) {
+    return encodeURIComponent(value);
+}
+/**
+ * Parses rate limit information from GitHub response headers.
+ * Returns null if the headers are not present.
+ */
+function parseRateLimitHeaders(headers) {
+    const limit = headers.get('X-RateLimit-Limit');
+    const remaining = headers.get('X-RateLimit-Remaining');
+    const reset = headers.get('X-RateLimit-Reset');
+    if (limit === null || remaining === null || reset === null) {
+        return null;
+    }
+    const parsedLimit = parseInt(limit, 10);
+    const parsedRemaining = parseInt(remaining, 10);
+    const parsedReset = parseInt(reset, 10);
+    if (isNaN(parsedLimit) || isNaN(parsedRemaining) || isNaN(parsedReset)) {
+        return null;
+    }
+    return {
+        limit: parsedLimit,
+        remaining: parsedRemaining,
+        reset: parsedReset,
+    };
+}
+/**
+ * Parses the GitHub Link header to find the "next" page URL.
+ * Returns null if there is no next page.
+ *
+ * The Link header format is:
+ *   <https://api.github.com/...?page=2>; rel="next", <https://api.github.com/...?page=5>; rel="last"
+ */
+function parseLinkHeaderNext(linkHeader) {
+    if (!linkHeader)
+        return null;
+    const links = linkHeader.split(',');
+    for (const link of links) {
+        const match = link.match(/<([^>]+)>;\s*rel="next"/);
+        if (match) {
+            return match[1];
+        }
+    }
+    return null;
+}
+// Export utility functions for testing
+export { parseRateLimitHeaders, parseLinkHeaderNext };
+//# sourceMappingURL=github-api.js.map

package/dist/external-sync/providers/github/github-api.js.map

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

package/dist/external-sync/providers/github/github-field-map.d.ts

@@ -0,0 +1,76 @@
+/**
+ * GitHub Field Map Configuration
+ *
+ * Defines how Stoneforge task fields map to GitHub issue fields.
+ * Used by the GitHubTaskAdapter and the shared task sync adapter utilities.
+ *
+ * Key mappings:
+ * - Priority (1-5) -> labels with 'priority:' prefix
+ * - TaskType (bug/feature/task/chore) -> labels with 'type:' prefix
+ * - Status -> GitHub issue state ('open' or 'closed')
+ * - Tags -> labels (user-managed, no prefix)
+ * - Sync-managed labels use the 'sf:' prefix
+ */
+import type { TaskStatus, Priority, TaskTypeValue } from '@stoneforge/core';
+import type { TaskSyncFieldMapConfig } from '../../adapters/task-sync-adapter.js';
+/**
+ * Maps Stoneforge priority values (1-5) to GitHub label names.
+ * These labels are prefixed with 'sf:' when pushed to GitHub to
+ * distinguish sync-managed labels from user-created labels.
+ */
+export declare const GITHUB_PRIORITY_LABELS: Record<Priority, string>;
+/**
+ * Maps Stoneforge task type values to GitHub label names.
+ * These labels are prefixed with 'sf:' when pushed to GitHub.
+ */
+export declare const GITHUB_TASK_TYPE_LABELS: Record<TaskTypeValue, string>;
+/**
+ * Prefix for Stoneforge-managed labels on GitHub issues.
+ * Labels with this prefix are created and managed by the sync system.
+ * User labels without this prefix are preserved during sync.
+ */
+export declare const GITHUB_SYNC_LABEL_PREFIX = "sf:";
+/**
+ * Maps Stoneforge TaskStatus values to GitHub label names.
+ * These labels are prefixed with 'sf:' when pushed to GitHub to
+ * provide granular status visibility beyond GitHub's binary open/closed state.
+ */
+export declare const GITHUB_STATUS_LABELS: Record<TaskStatus, string>;
+/**
+ * Maps Stoneforge TaskStatus to GitHub issue state.
+ *
+ * GitHub only supports two issue states: 'open' and 'closed'.
+ * Most Stoneforge statuses map to 'open' since GitHub can't
+ * distinguish between open, in_progress, review, blocked, etc.
+ *
+ * Mapping:
+ * - open, in_progress, review, blocked, deferred, backlog -> 'open'
+ * - closed, tombstone -> 'closed'
+ */
+export declare function statusToGitHubState(status: TaskStatus): 'open' | 'closed';
+/**
+ * Maps GitHub issue state + labels back to Stoneforge TaskStatus.
+ *
+ * Uses sf:status:* labels for granular status inference when available.
+ * If a status label is found, it takes precedence over the basic
+ * open/closed state mapping. Falls back to the simple state mapping
+ * when no status label is present.
+ *
+ * Mapping with labels:
+ * - 'sf:status:in-progress' → 'in_progress'
+ * - 'sf:status:blocked' → 'blocked'
+ * - etc.
+ *
+ * Fallback mapping (no status label):
+ * - 'open' → 'open'
+ * - 'closed' → 'closed'
+ */
+export declare function gitHubStateToStatus(state: 'open' | 'closed', labels: string[]): TaskStatus;
+/**
+ * Complete GitHub-specific field mapping configuration.
+ *
+ * Used by the shared task sync adapter utilities to convert between
+ * Stoneforge tasks and GitHub issues (in both push and pull directions).
+ */
+export declare const GITHUB_FIELD_MAP_CONFIG: TaskSyncFieldMapConfig;
+//# sourceMappingURL=github-field-map.d.ts.map

package/dist/external-sync/providers/github/github-field-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-field-map.d.ts","sourceRoot":"","sources":["../../../../src/external-sync/providers/github/github-field-map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAMlF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAM/B,CAAC;AAM9B;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAKhC,CAAC;AAMnC;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,QAAQ,CAAC;AAM9C;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAS3D,CAAC;AAMF;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,CAczE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,GAAG,QAAQ,EACxB,MAAM,EAAE,MAAM,EAAE,GACf,UAAU,CA0BZ;AAMD;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,EAAE,sBAOrC,CAAC"}

package/dist/external-sync/providers/github/github-field-map.js

@@ -0,0 +1,157 @@
+/**
+ * GitHub Field Map Configuration
+ *
+ * Defines how Stoneforge task fields map to GitHub issue fields.
+ * Used by the GitHubTaskAdapter and the shared task sync adapter utilities.
+ *
+ * Key mappings:
+ * - Priority (1-5) -> labels with 'priority:' prefix
+ * - TaskType (bug/feature/task/chore) -> labels with 'type:' prefix
+ * - Status -> GitHub issue state ('open' or 'closed')
+ * - Tags -> labels (user-managed, no prefix)
+ * - Sync-managed labels use the 'sf:' prefix
+ */
+// ============================================================================
+// Priority Label Mapping
+// ============================================================================
+/**
+ * Maps Stoneforge priority values (1-5) to GitHub label names.
+ * These labels are prefixed with 'sf:' when pushed to GitHub to
+ * distinguish sync-managed labels from user-created labels.
+ */
+export const GITHUB_PRIORITY_LABELS = {
+    1: 'priority:critical',
+    2: 'priority:high',
+    3: 'priority:medium',
+    4: 'priority:low',
+    5: 'priority:minimal',
+};
+// ============================================================================
+// Task Type Label Mapping
+// ============================================================================
+/**
+ * Maps Stoneforge task type values to GitHub label names.
+ * These labels are prefixed with 'sf:' when pushed to GitHub.
+ */
+export const GITHUB_TASK_TYPE_LABELS = {
+    bug: 'type:bug',
+    feature: 'type:feature',
+    task: 'type:task',
+    chore: 'type:chore',
+};
+// ============================================================================
+// Sync Label Prefix
+// ============================================================================
+/**
+ * Prefix for Stoneforge-managed labels on GitHub issues.
+ * Labels with this prefix are created and managed by the sync system.
+ * User labels without this prefix are preserved during sync.
+ */
+export const GITHUB_SYNC_LABEL_PREFIX = 'sf:';
+// ============================================================================
+// Status Label Mapping
+// ============================================================================
+/**
+ * Maps Stoneforge TaskStatus values to GitHub label names.
+ * These labels are prefixed with 'sf:' when pushed to GitHub to
+ * provide granular status visibility beyond GitHub's binary open/closed state.
+ */
+export const GITHUB_STATUS_LABELS = {
+    open: 'status:open',
+    in_progress: 'status:in-progress',
+    blocked: 'status:blocked',
+    deferred: 'status:deferred',
+    backlog: 'status:backlog',
+    review: 'status:review',
+    closed: 'status:closed',
+    tombstone: 'status:tombstone',
+};
+// ============================================================================
+// Status <-> State Mapping
+// ============================================================================
+/**
+ * Maps Stoneforge TaskStatus to GitHub issue state.
+ *
+ * GitHub only supports two issue states: 'open' and 'closed'.
+ * Most Stoneforge statuses map to 'open' since GitHub can't
+ * distinguish between open, in_progress, review, blocked, etc.
+ *
+ * Mapping:
+ * - open, in_progress, review, blocked, deferred, backlog -> 'open'
+ * - closed, tombstone -> 'closed'
+ */
+export function statusToGitHubState(status) {
+    switch (status) {
+        case 'closed':
+        case 'tombstone':
+            return 'closed';
+        case 'open':
+        case 'in_progress':
+        case 'review':
+        case 'blocked':
+        case 'deferred':
+        case 'backlog':
+        default:
+            return 'open';
+    }
+}
+/**
+ * Maps GitHub issue state + labels back to Stoneforge TaskStatus.
+ *
+ * Uses sf:status:* labels for granular status inference when available.
+ * If a status label is found, it takes precedence over the basic
+ * open/closed state mapping. Falls back to the simple state mapping
+ * when no status label is present.
+ *
+ * Mapping with labels:
+ * - 'sf:status:in-progress' → 'in_progress'
+ * - 'sf:status:blocked' → 'blocked'
+ * - etc.
+ *
+ * Fallback mapping (no status label):
+ * - 'open' → 'open'
+ * - 'closed' → 'closed'
+ */
+export function gitHubStateToStatus(state, labels) {
+    // Build a reverse lookup from status labels: 'status:open' → 'open', etc.
+    const statusByLabel = new Map();
+    for (const [status, label] of Object.entries(GITHUB_STATUS_LABELS)) {
+        statusByLabel.set(label, status);
+    }
+    // Check labels for a status label (strip the sync prefix first)
+    for (const label of labels) {
+        if (label.startsWith(GITHUB_SYNC_LABEL_PREFIX)) {
+            const value = label.slice(GITHUB_SYNC_LABEL_PREFIX.length);
+            const matchedStatus = statusByLabel.get(value);
+            if (matchedStatus !== undefined) {
+                return matchedStatus;
+            }
+        }
+    }
+    // Fallback: basic open/closed mapping
+    switch (state) {
+        case 'closed':
+            return 'closed';
+        case 'open':
+        default:
+            return 'open';
+    }
+}
+// ============================================================================
+// Combined Field Map Config
+// ============================================================================
+/**
+ * Complete GitHub-specific field mapping configuration.
+ *
+ * Used by the shared task sync adapter utilities to convert between
+ * Stoneforge tasks and GitHub issues (in both push and pull directions).
+ */
+export const GITHUB_FIELD_MAP_CONFIG = {
+    priorityLabels: GITHUB_PRIORITY_LABELS,
+    taskTypeLabels: GITHUB_TASK_TYPE_LABELS,
+    statusLabels: GITHUB_STATUS_LABELS,
+    syncLabelPrefix: GITHUB_SYNC_LABEL_PREFIX,
+    statusToState: statusToGitHubState,
+    stateToStatus: gitHubStateToStatus,
+};
+//# sourceMappingURL=github-field-map.js.map

package/dist/external-sync/providers/github/github-field-map.js.map

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

package/dist/external-sync/providers/github/github-provider.d.ts

@@ -0,0 +1,36 @@
+/**
+ * GitHub Provider
+ *
+ * Full implementation of the GitHub ExternalProvider.
+ * Handles connection testing via the GitHub API and provides
+ * a TaskSyncAdapter for bidirectional task/issue synchronization.
+ *
+ * The provider uses a lazy-initialized GitHubTaskAdapter that
+ * requires a ProviderConfig with a valid token before use.
+ *
+ * Also exports the placeholder provider for backward compatibility
+ * with systems that register the provider before configuration.
+ */
+import type { ExternalProvider, ProviderConfig } from '@stoneforge/core';
+/**
+ * Create a configured GitHub provider.
+ *
+ * The provider is ready to use for sync operations when a valid
+ * token is provided in the config. The task adapter is initialized
+ * immediately with the provided credentials.
+ *
+ * @param config - Provider configuration with token and optional apiBaseUrl
+ * @returns A fully configured GitHub ExternalProvider
+ */
+export declare function createGitHubProvider(config: ProviderConfig): ExternalProvider;
+/**
+ * Create a placeholder GitHub provider.
+ *
+ * The provider is registered by default in the provider registry so that
+ * the system knows GitHub is an available provider. Connection testing
+ * always returns false and all adapter methods throw until configured.
+ *
+ * @returns A placeholder GitHub ExternalProvider
+ */
+export declare function createGitHubPlaceholderProvider(): ExternalProvider;
+//# sourceMappingURL=github-provider.d.ts.map

package/dist/external-sync/providers/github/github-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-provider.d.ts","sourceRoot":"","sources":["../../../../src/external-sync/providers/github/github-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EAMf,MAAM,kBAAkB,CAAC;AA4M1B;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,GAAG,gBAAgB,CAE7E;AAED;;;;;;;;GAQG;AACH,wBAAgB,+BAA+B,IAAI,gBAAgB,CAElE"}