@stoneforge/quarry 1.12.0 → 1.13.0

package/dist/external-sync/provider-registry.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Provider Registry — manages ExternalProvider registrations
+ *
+ * Provides a central registry for external sync providers (GitHub, Linear, etc.).
+ * Supports registration, lookup by name, listing all providers, and querying
+ * providers by adapter type.
+ *
+ * Usage:
+ * ```typescript
+ * import { createProviderRegistry } from '@stoneforge/quarry';
+ *
+ * const registry = createProviderRegistry();
+ * registry.register(myProvider);
+ * const github = registry.get('github');
+ * const taskProviders = registry.getAdaptersOfType('task');
+ * ```
+ */
+import type { ExternalProvider, ProviderConfig, SyncAdapterType, TaskSyncAdapter, DocumentSyncAdapter, MessageSyncAdapter } from '@stoneforge/core';
+/**
+ * Result from getAdaptersOfType — a provider and its adapter for the requested type
+ */
+export interface ProviderAdapterEntry {
+    readonly provider: ExternalProvider;
+    readonly adapter: TaskSyncAdapter | DocumentSyncAdapter | MessageSyncAdapter;
+}
+/**
+ * Registry for external sync providers.
+ *
+ * Manages registration and lookup of ExternalProvider instances.
+ * Providers are keyed by their `name` property (e.g., 'github', 'linear').
+ */
+export declare class ProviderRegistry {
+    private readonly providers;
+    /**
+     * Register a provider.
+     *
+     * @param provider - The provider to register
+     * @throws Error if a provider with the same name is already registered
+     */
+    register(provider: ExternalProvider): void;
+    /**
+     * Look up a provider by name.
+     *
+     * @param name - The provider name (e.g., 'github')
+     * @returns The provider, or undefined if not found
+     */
+    get(name: string): ExternalProvider | undefined;
+    /**
+     * List all registered providers.
+     *
+     * @returns Array of all registered providers
+     */
+    list(): ExternalProvider[];
+    /**
+     * Find all providers that support a given adapter type, and return
+     * the provider paired with its adapter for that type.
+     *
+     * @param type - The adapter type to filter by ('task', 'document', 'message')
+     * @returns Array of { provider, adapter } for all matching providers
+     */
+    getAdaptersOfType(type: SyncAdapterType): ProviderAdapterEntry[];
+    /**
+     * Check if a provider is registered.
+     *
+     * @param name - The provider name
+     * @returns true if the provider is registered
+     */
+    has(name: string): boolean;
+    /**
+     * Unregister a provider by name.
+     *
+     * @param name - The provider name to remove
+     * @returns true if the provider was removed, false if not found
+     */
+    unregister(name: string): boolean;
+    /**
+     * Remove all registered providers.
+     */
+    clear(): void;
+}
+/**
+ * Create a new ProviderRegistry instance.
+ *
+ * @returns A new, empty ProviderRegistry
+ */
+export declare function createProviderRegistry(): ProviderRegistry;
+/**
+ * Create a ProviderRegistry with default providers registered.
+ *
+ * Registers placeholder providers for GitHub and Linear by default.
+ * The actual provider implementations replace these when configured with API keys.
+ *
+ * @returns A ProviderRegistry with default providers
+ */
+export declare function createDefaultProviderRegistry(): ProviderRegistry;
+/**
+ * Create a ProviderRegistry with real configured providers.
+ *
+ * Starts with placeholder providers for all known providers (GitHub, Linear),
+ * then replaces placeholders with real configured providers for any configs
+ * that have a token set. This ensures providers without tokens remain as
+ * placeholders (which throw descriptive errors), while configured providers
+ * are ready for actual sync operations.
+ *
+ * @param providerConfigs - Array of provider configurations (from settings)
+ * @returns A ProviderRegistry with configured providers replacing placeholders
+ */
+export declare function createConfiguredProviderRegistry(providerConfigs: readonly ProviderConfig[]): ProviderRegistry;
+//# sourceMappingURL=provider-registry.d.ts.map

package/dist/external-sync/provider-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-registry.d.ts","sourceRoot":"","sources":["../../src/external-sync/provider-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,kBAAkB,CAAC;AAQ1B;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,mBAAmB,GAAG,kBAAkB,CAAC;CAC9E;AAMD;;;;;GAKG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuC;IAEjE;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAU1C;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAI/C;;;;OAIG;IACH,IAAI,IAAI,gBAAgB,EAAE;IAI1B;;;;;;OAMG;IACH,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,oBAAoB,EAAE;IAiBhE;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd;AA6BD;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,gBAAgB,CAEzD;AAED;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,IAAI,gBAAgB,CAKhE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gCAAgC,CAC9C,eAAe,EAAE,SAAS,cAAc,EAAE,GACzC,gBAAgB,CAkClB"}

package/dist/external-sync/provider-registry.js

@@ -0,0 +1,188 @@
+/**
+ * Provider Registry — manages ExternalProvider registrations
+ *
+ * Provides a central registry for external sync providers (GitHub, Linear, etc.).
+ * Supports registration, lookup by name, listing all providers, and querying
+ * providers by adapter type.
+ *
+ * Usage:
+ * ```typescript
+ * import { createProviderRegistry } from '@stoneforge/quarry';
+ *
+ * const registry = createProviderRegistry();
+ * registry.register(myProvider);
+ * const github = registry.get('github');
+ * const taskProviders = registry.getAdaptersOfType('task');
+ * ```
+ */
+import { createGitHubProvider, createGitHubPlaceholderProvider } from './providers/github/index.js';
+import { createLinearProvider, createLinearPlaceholderProvider } from './providers/linear/index.js';
+// ============================================================================
+// ProviderRegistry
+// ============================================================================
+/**
+ * Registry for external sync providers.
+ *
+ * Manages registration and lookup of ExternalProvider instances.
+ * Providers are keyed by their `name` property (e.g., 'github', 'linear').
+ */
+export class ProviderRegistry {
+    providers = new Map();
+    /**
+     * Register a provider.
+     *
+     * @param provider - The provider to register
+     * @throws Error if a provider with the same name is already registered
+     */
+    register(provider) {
+        if (this.providers.has(provider.name)) {
+            throw new Error(`Provider '${provider.name}' is already registered. ` +
+                `Unregister it first or use a different name.`);
+        }
+        this.providers.set(provider.name, provider);
+    }
+    /**
+     * Look up a provider by name.
+     *
+     * @param name - The provider name (e.g., 'github')
+     * @returns The provider, or undefined if not found
+     */
+    get(name) {
+        return this.providers.get(name);
+    }
+    /**
+     * List all registered providers.
+     *
+     * @returns Array of all registered providers
+     */
+    list() {
+        return Array.from(this.providers.values());
+    }
+    /**
+     * Find all providers that support a given adapter type, and return
+     * the provider paired with its adapter for that type.
+     *
+     * @param type - The adapter type to filter by ('task', 'document', 'message')
+     * @returns Array of { provider, adapter } for all matching providers
+     */
+    getAdaptersOfType(type) {
+        const results = [];
+        for (const provider of this.providers.values()) {
+            if (!provider.supportedAdapters.includes(type)) {
+                continue;
+            }
+            const adapter = getAdapterByType(provider, type);
+            if (adapter) {
+                results.push({ provider, adapter });
+            }
+        }
+        return results;
+    }
+    /**
+     * Check if a provider is registered.
+     *
+     * @param name - The provider name
+     * @returns true if the provider is registered
+     */
+    has(name) {
+        return this.providers.has(name);
+    }
+    /**
+     * Unregister a provider by name.
+     *
+     * @param name - The provider name to remove
+     * @returns true if the provider was removed, false if not found
+     */
+    unregister(name) {
+        return this.providers.delete(name);
+    }
+    /**
+     * Remove all registered providers.
+     */
+    clear() {
+        this.providers.clear();
+    }
+}
+// ============================================================================
+// Helper Functions
+// ============================================================================
+/**
+ * Get the adapter from a provider for a given adapter type.
+ */
+function getAdapterByType(provider, type) {
+    switch (type) {
+        case 'task':
+            return provider.getTaskAdapter?.();
+        case 'document':
+            return provider.getDocumentAdapter?.();
+        case 'message':
+            return provider.getMessageAdapter?.();
+        default:
+            return undefined;
+    }
+}
+// ============================================================================
+// Factory
+// ============================================================================
+/**
+ * Create a new ProviderRegistry instance.
+ *
+ * @returns A new, empty ProviderRegistry
+ */
+export function createProviderRegistry() {
+    return new ProviderRegistry();
+}
+/**
+ * Create a ProviderRegistry with default providers registered.
+ *
+ * Registers placeholder providers for GitHub and Linear by default.
+ * The actual provider implementations replace these when configured with API keys.
+ *
+ * @returns A ProviderRegistry with default providers
+ */
+export function createDefaultProviderRegistry() {
+    const registry = new ProviderRegistry();
+    registry.register(createGitHubPlaceholderProvider());
+    registry.register(createLinearPlaceholderProvider());
+    return registry;
+}
+/**
+ * Create a ProviderRegistry with real configured providers.
+ *
+ * Starts with placeholder providers for all known providers (GitHub, Linear),
+ * then replaces placeholders with real configured providers for any configs
+ * that have a token set. This ensures providers without tokens remain as
+ * placeholders (which throw descriptive errors), while configured providers
+ * are ready for actual sync operations.
+ *
+ * @param providerConfigs - Array of provider configurations (from settings)
+ * @returns A ProviderRegistry with configured providers replacing placeholders
+ */
+export function createConfiguredProviderRegistry(providerConfigs) {
+    const registry = createDefaultProviderRegistry();
+    for (const config of providerConfigs) {
+        if (!config.token) {
+            continue;
+        }
+        // Replace the placeholder with a real configured provider
+        registry.unregister(config.provider);
+        switch (config.provider) {
+            case 'github':
+                registry.register(createGitHubProvider({
+                    provider: 'github',
+                    token: config.token,
+                    apiBaseUrl: config.apiBaseUrl,
+                    defaultProject: config.defaultProject,
+                }));
+                break;
+            case 'linear':
+                registry.register(createLinearProvider({
+                    apiKey: config.token,
+                }));
+                break;
+            // Unknown providers are silently skipped — their placeholders remain
+        }
+    }
+    return registry;
+}
+//# sourceMappingURL=provider-registry.js.map

package/dist/external-sync/provider-registry.js.map

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

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

@@ -0,0 +1,271 @@
+/**
+ * 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.
+ */
+/**
+ * Minimal type matching the fields we use from GitHub's issue response.
+ * Does not attempt to type the full GitHub API response.
+ */
+export interface GitHubIssue {
+    /** GitHub's internal issue ID */
+    readonly id: number;
+    /** Issue number within the repository */
+    readonly number: number;
+    /** Issue title */
+    readonly title: string;
+    /** Issue body/description (markdown) */
+    readonly body: string | null;
+    /** Issue state */
+    readonly state: 'open' | 'closed';
+    /** Labels attached to the issue */
+    readonly labels: readonly GitHubLabel[];
+    /** Users assigned to the issue */
+    readonly assignees: readonly GitHubUser[];
+    /** URL to view the issue in a browser */
+    readonly html_url: string;
+    /** Creation timestamp (ISO 8601) */
+    readonly created_at: string;
+    /** Last update timestamp (ISO 8601) */
+    readonly updated_at: string;
+    /** Closure timestamp (ISO 8601), null if still open */
+    readonly closed_at: string | null;
+}
+/**
+ * Minimal GitHub label representation
+ */
+export interface GitHubLabel {
+    readonly id: number;
+    readonly name: string;
+    readonly color: string;
+    readonly description: string | null;
+}
+/**
+ * Minimal GitHub user representation
+ */
+export interface GitHubUser {
+    readonly login: string;
+    readonly id: number;
+}
+/**
+ * Options for listing issues
+ */
+export interface ListIssuesOptions {
+    /** Only return issues updated after this ISO 8601 timestamp */
+    since?: string;
+    /** Filter by state */
+    state?: 'open' | 'closed' | 'all';
+    /** Results per page (max 100, default 30) */
+    per_page?: number;
+    /** Page number for manual pagination */
+    page?: number;
+}
+/**
+ * Input for creating a new label on a repository
+ */
+export interface CreateLabelInput {
+    /** Label name (required) */
+    name: string;
+    /** Label color as hex string without '#' prefix (e.g. '0075ca') */
+    color: string;
+    /** Optional description for the label */
+    description?: string;
+}
+/**
+ * Input for creating a new issue
+ */
+export interface CreateIssueInput {
+    /** Issue title (required) */
+    title: string;
+    /** Issue body/description */
+    body?: string;
+    /** Label names to attach */
+    labels?: string[];
+    /** Usernames to assign */
+    assignees?: string[];
+}
+/**
+ * Input for updating an existing issue
+ */
+export interface UpdateIssueInput {
+    /** Updated title */
+    title?: string;
+    /** Updated body */
+    body?: string;
+    /** Updated state */
+    state?: 'open' | 'closed';
+    /** Updated label names (replaces all labels) */
+    labels?: string[];
+    /** Updated assignees (replaces all assignees) */
+    assignees?: string[];
+}
+/**
+ * Rate limit information parsed from GitHub response headers
+ */
+export interface RateLimitInfo {
+    /** Total requests allowed per hour */
+    readonly limit: number;
+    /** Requests remaining in the current window */
+    readonly remaining: number;
+    /** UTC epoch timestamp when the rate limit resets */
+    readonly reset: number;
+}
+/**
+ * Configuration for creating a GitHubApiClient
+ */
+export interface GitHubApiClientOptions {
+    /** Personal Access Token for authentication */
+    token: string;
+    /** Base URL for GitHub API (default: https://api.github.com) */
+    apiBaseUrl?: string;
+    /** Remaining requests threshold to trigger warnings (default: 10) */
+    rateLimitWarningThreshold?: number;
+}
+/**
+ * Typed error for GitHub API failures.
+ * Wraps fetch errors with status code, message, and rate limit info.
+ */
+export declare class GitHubApiError extends Error {
+    /** HTTP status code from GitHub's response */
+    readonly status: number;
+    /** Human-readable error message from GitHub */
+    readonly statusText: string;
+    /** Rate limit information at the time of the error */
+    readonly rateLimit: RateLimitInfo | null;
+    /** Parsed error body from GitHub (if available) */
+    readonly responseBody: Record<string, unknown> | null;
+    constructor(message: string, status: number, statusText: string, rateLimit?: RateLimitInfo | null, responseBody?: Record<string, unknown> | null, cause?: Error);
+    /**
+     * Whether this error is due to rate limiting
+     */
+    get isRateLimited(): boolean;
+    /**
+     * Whether this error is due to authentication failure
+     */
+    get isAuthError(): boolean;
+    /**
+     * Whether this error is a not-found response
+     */
+    get isNotFound(): boolean;
+    /**
+     * Returns a JSON-serializable representation of the error
+     */
+    toJSON(): {
+        name: string;
+        message: string;
+        status: number;
+        statusText: string;
+        rateLimit: RateLimitInfo | null;
+        responseBody: Record<string, unknown> | null;
+    };
+}
+/**
+ * Type guard for GitHubApiError
+ */
+export declare function isGitHubApiError(error: unknown): error is GitHubApiError;
+/**
+ * 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 declare class GitHubApiClient {
+    private readonly token;
+    private readonly apiBaseUrl;
+    private readonly rateLimitWarningThreshold;
+    /** Most recently observed rate limit info (updated after each request) */
+    private lastRateLimit;
+    constructor(options: GitHubApiClientOptions);
+    /**
+     * Returns the most recently observed rate limit info, or null if no requests have been made.
+     */
+    getRateLimit(): RateLimitInfo | null;
+    /**
+     * Fetch a single issue by number.
+     *
+     * GET /repos/{owner}/{repo}/issues/{issue_number}
+     */
+    getIssue(owner: string, repo: string, issueNumber: number): Promise<GitHubIssue>;
+    /**
+     * 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.
+     */
+    listIssues(owner: string, repo: string, options?: ListIssuesOptions): Promise<GitHubIssue[]>;
+    /**
+     * Create a new issue.
+     *
+     * POST /repos/{owner}/{repo}/issues
+     */
+    createIssue(owner: string, repo: string, input: CreateIssueInput): Promise<GitHubIssue>;
+    /**
+     * Update an existing issue.
+     *
+     * PATCH /repos/{owner}/{repo}/issues/{issue_number}
+     */
+    updateIssue(owner: string, repo: string, issueNumber: number, updates: UpdateIssueInput): Promise<GitHubIssue>;
+    /**
+     * List all labels for a repository.
+     *
+     * GET /repos/{owner}/{repo}/labels
+     *
+     * Auto-paginates through all pages to return the complete label set.
+     */
+    getLabels(owner: string, repo: string): Promise<GitHubLabel[]>;
+    /**
+     * Create a new label on a repository.
+     *
+     * POST /repos/{owner}/{repo}/labels
+     */
+    createLabel(owner: string, repo: string, input: CreateLabelInput): Promise<GitHubLabel>;
+    /**
+     * Performs a single HTTP request to the GitHub API.
+     */
+    private request;
+    /**
+     * Performs a paginated request, following Link headers to collect all pages.
+     */
+    private paginatedRequest;
+    /**
+     * Handles non-OK responses by throwing a GitHubApiError.
+     */
+    private handleErrorResponse;
+    /**
+     * Logs a warning when rate limit is approaching exhaustion.
+     */
+    private checkRateLimitWarning;
+}
+/**
+ * Parses rate limit information from GitHub response headers.
+ * Returns null if the headers are not present.
+ */
+declare function parseRateLimitHeaders(headers: Headers): RateLimitInfo | null;
+/**
+ * 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"
+ */
+declare function parseLinkHeaderNext(linkHeader: string | null): string | null;
+export { parseRateLimitHeaders, parseLinkHeaderNext };
+//# sourceMappingURL=github-api.d.ts.map

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

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