@gitkraken/core-gitlens 0.3.1 → 0.4.0

package/dist/plus/integrations/index.js

@@ -0,0 +1,62 @@
+// Public facade for `@gitkraken/core-gitlens/plus/integrations`.
+//
+// External consumers should import from this entry point only, not from the
+// package's internal subpaths. The internal classes (IntegrationService,
+// IntegrationAuthenticationService, etc.) are not part of the public API and
+// may be refactored without semver bumps.
+import { CloudIntegrationService } from './authentication/cloudIntegrationService.js';
+import { ConfiguredIntegrationService } from './authentication/configuredIntegrationService.js';
+import { IntegrationAuthenticationService } from './authentication/integrationAuthenticationService.js';
+import { IntegrationService } from './integrationService.js';
+/**
+ * Construct an `@gitkraken/core-gitlens/plus/integrations` manager bound to the supplied runtime.
+ *
+ * The runtime is the **single** cross-boundary contract — anything the
+ * package needs (HTTP, storage, cache, auth, subscription, telemetry, UI,
+ * configuration, environment) flows through it. The package never imports
+ * `vscode`, `Container`, or any consumer-internal types.
+ *
+ * The returned manager owns its internal services; dispose it (or its
+ * containing scope) to release every cached integration plus the runtime's
+ * own VS Code subscriptions.
+ */
+export function createIntegrationManager(ctx) {
+    const configured = new ConfiguredIntegrationService(ctx);
+    // The cloud token-exchange client is a pure package service (needs only `ctx`); construct it here
+    // rather than round-tripping through a host hook.
+    const cloud = new CloudIntegrationService(ctx);
+    // Cloud auth providers need to (re)initiate the connect flow that lives on the service, but the
+    // service is constructed after the auth service (it depends on it). Break the cycle here at the
+    // composition root with a lazy, readonly accessor — preserving constructor injection while
+    // keeping the flow in-package (no host round-trip).
+    let service;
+    const auth = new IntegrationAuthenticationService(configured, ctx, () => service, cloud);
+    service = new IntegrationService(auth, configured, ctx);
+    // One-time cleanup of storage left behind by integration ids retired in the cloud-only refactor (the
+    // local self-managed `github-enterprise`/`gitlab-self-hosted` providers). Best-effort and guarded so it
+    // runs once; a no-op for consumers that never stored those ids.
+    void purgeRetiredIntegrationStorage(ctx, configured);
+    return service;
+}
+const retiredIntegrationsStorageKey = 'integrations:migrated:cloudOnly';
+async function purgeRetiredIntegrationStorage(ctx, configured) {
+    if (ctx.storage.get(retiredIntegrationsStorageKey))
+        return;
+    try {
+        await configured.purgeStoredConfiguration(['github-enterprise', 'gitlab-self-hosted']);
+        // Only mark the migration done once the purge fully succeeds. A partial/failed purge stays
+        // un-flagged so it retries (idempotently) on the next startup, rather than orphaning the
+        // retired-id config/secrets forever.
+        await ctx.storage.store(retiredIntegrationsStorageKey, true);
+    }
+    catch {
+        // Best-effort cleanup: swallow so the failure doesn't reject the fire-and-forget caller; the
+        // unset flag guarantees a retry next startup.
+    }
+}
+// Convenience: wrap a static access token (env var, CLI flag, secret manager)
+// as an `IntegrationAuthenticationProvider`. For OAuth/refresh flows, implement
+// the interface directly — this helper is for non-interactive consumers only.
+export { createManualTokenAuthProvider, } from './authentication/manualTokenProvider.js';
+export { GitCloudHostIntegrationId, GitSelfManagedHostIntegrationId, IssuesCloudHostIntegrationId, isIntegrationId, isSupportedCloudIntegrationId, } from './constants.js';
+//# sourceMappingURL=index.js.map

package/dist/plus/integrations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/plus/integrations/index.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,EAAE;AACF,4EAA4E;AAC5E,yEAAyE;AACzE,6EAA6E;AAC7E,0CAA0C;AAE1C,OAAO,EAAE,uBAAuB,EAAE,MAAM,6CAA6C,CAAC;AACtF,OAAO,EAAE,4BAA4B,EAAE,MAAM,kDAAkD,CAAC;AAChG,OAAO,EAAE,gCAAgC,EAAE,MAAM,sDAAsD,CAAC;AAExG,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAS7D;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,wBAAwB,CAAC,GAA8B;IACtE,MAAM,UAAU,GAAG,IAAI,4BAA4B,CAAC,GAAG,CAAC,CAAC;IACzD,kGAAkG;IAClG,kDAAkD;IAClD,MAAM,KAAK,GAAG,IAAI,uBAAuB,CAAC,GAAG,CAAC,CAAC;IAC/C,gGAAgG;IAChG,gGAAgG;IAChG,2FAA2F;IAC3F,oDAAoD;IACpD,IAAI,OAA2B,CAAC;IAChC,MAAM,IAAI,GAAG,IAAI,gCAAgC,CAAC,UAAU,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACzF,OAAO,GAAG,IAAI,kBAAkB,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;IACxD,qGAAqG;IACrG,wGAAwG;IACxG,gEAAgE;IAChE,KAAK,8BAA8B,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IACrD,OAAO,OAAO,CAAC;AAChB,CAAC;AAED,MAAM,6BAA6B,GAAG,iCAAiC,CAAC;AACxE,KAAK,UAAU,8BAA8B,CAC5C,GAA8B,EAC9B,UAAwC;IAExC,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAU,6BAA6B,CAAC;QAAE,OAAO;IAEpE,IAAI,CAAC;QACJ,MAAM,UAAU,CAAC,wBAAwB,CAAC,CAAC,mBAAmB,EAAE,oBAAoB,CAAC,CAAC,CAAC;QACvF,2FAA2F;QAC3F,yFAAyF;QACzF,qCAAqC;QACrC,MAAM,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,IAAI,CAAC,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC;QACR,6FAA6F;QAC7F,8CAA8C;IAC/C,CAAC;AACF,CAAC;AAoCD,8EAA8E;AAC9E,gFAAgF;AAChF,8EAA8E;AAC9E,OAAO,EACN,6BAA6B,GAE7B,MAAM,yCAAyC,CAAC;AAEjD,OAAO,EACN,yBAAyB,EACzB,+BAA+B,EAC/B,4BAA4B,EAC5B,eAAe,EACf,6BAA6B,GAC7B,MAAM,gBAAgB,CAAC"}

package/dist/plus/integrations/integrationService.d.ts

@@ -0,0 +1,98 @@
+import type { Account } from '../../git/models/author.js';
+import type { IssueShape } from '../../git/models/issue.js';
+import type { PullRequest } from '../../git/models/pullRequest.js';
+import type { GitRemote } from '../../git/models/remote.js';
+import type { RemoteProviderId } from '../../git/models/remoteProvider.js';
+import type { Disposable } from '../../utils/disposable.js';
+import type { Event } from '../../utils/event.js';
+import type { ConfiguredIntegrationsChangeEvent, ConfiguredIntegrationService } from './authentication/configuredIntegrationService.js';
+import type { IntegrationAuthenticationService } from './authentication/integrationAuthenticationService.js';
+import type { ConfiguredIntegrationDescriptor } from './authentication/models.js';
+import type { CloudGitSelfManagedHostIntegrationIds, IntegrationIds, SupportedCloudIntegrationIds } from './constants.js';
+import { GitCloudHostIntegrationId, GitSelfManagedHostIntegrationId, IssuesCloudHostIntegrationId } from './constants.js';
+import type { IntegrationServiceContext } from './context.js';
+import type { GitHostIntegration } from './models/gitHostIntegration.js';
+import type { IntegrationBase, IntegrationById, IntegrationResult } from './models/integration.js';
+import type { IssuesIntegration } from './models/issuesIntegration.js';
+import type { ApiClients } from './providers/apiClients.js';
+import type { GitHubApi } from './providers/github/github.js';
+import type { Source } from './telemetry.js';
+export interface ConnectionStateChangeEvent {
+    key: string;
+    reason: 'connected' | 'disconnected';
+}
+/** @internal Event emitted when an integration connection state changes  */
+export interface IntegrationConnectionChangeEvent extends ConnectionStateChangeEvent {
+    integration: IntegrationBase;
+}
+export declare class IntegrationService implements Disposable {
+    private readonly authenticationService;
+    private readonly configuredIntegrationService;
+    private readonly ctx;
+    get onDidChange(): Event<ConfiguredIntegrationsChangeEvent>;
+    private readonly _onDidChangeConnectionState;
+    get onDidChangeConnectionState(): Event<ConnectionStateChangeEvent>;
+    private readonly _connectedCache;
+    private readonly _disposable;
+    private _integrations;
+    private readonly _onDidChangeIntegrationConnection;
+    private readonly _apiDisposables;
+    private _apis;
+    /** The package-built, memoized per-provider API clients (was injected via the now-removed `ctx.apis`). */
+    get apis(): ApiClients;
+    /** The shared `GitHubApi` instance — also consumed by the host's GitHub git provider (one instance). */
+    get github(): Promise<GitHubApi | undefined>;
+    constructor(authenticationService: IntegrationAuthenticationService, configuredIntegrationService: ConfiguredIntegrationService, ctx: IntegrationServiceContext);
+    dispose(): void;
+    connectCloudIntegrations(connect?: {
+        integrationIds: SupportedCloudIntegrationIds[];
+        skipIfConnected?: boolean;
+        skipPreSync?: boolean;
+    }, source?: Source): Promise<boolean>;
+    get(id: GitCloudHostIntegrationId): Promise<GitHostIntegration>;
+    get(id: IssuesCloudHostIntegrationId): Promise<IssuesIntegration>;
+    get(id: GitCloudHostIntegrationId | CloudGitSelfManagedHostIntegrationIds, domain?: string): Promise<GitHostIntegration | undefined>;
+    get(id: GitSelfManagedHostIntegrationId, domain: string): Promise<GitHostIntegration | undefined>;
+    get<T extends IntegrationIds>(id: T, domain?: string): Promise<IntegrationById<T> | undefined>;
+    getConfigured(id?: IntegrationIds, options?: {
+        cloud?: boolean;
+        domain?: string;
+    }): ConfiguredIntegrationDescriptor[];
+    /**
+     * Returns the connected integration for a `GitRemote`, if any.
+     * Internal counterpart to the host's `getRemoteIntegration(remote)` helper.
+     */
+    getByRemote(remote: GitRemote): Promise<GitHostIntegration | undefined>;
+    getMyIssues(integrationIds?: (GitCloudHostIntegrationId | IssuesCloudHostIntegrationId | GitSelfManagedHostIntegrationId)[], options?: {
+        openRepositoriesOnly?: boolean;
+        cancellation?: AbortSignal;
+    }): Promise<IssueShape[] | undefined>;
+    private getMyIssuesCore;
+    getMyIssuesForRemotes(remote: GitRemote): Promise<IssueShape[] | undefined>;
+    getMyIssuesForRemotes(remotes: GitRemote[]): Promise<IssueShape[] | undefined>;
+    getMyCurrentAccounts(integrationIds: (GitCloudHostIntegrationId | CloudGitSelfManagedHostIntegrationIds)[]): Promise<Map<GitCloudHostIntegrationId | CloudGitSelfManagedHostIntegrationIds, Account>>;
+    getMyPullRequests(integrationIds?: (GitCloudHostIntegrationId | CloudGitSelfManagedHostIntegrationIds)[], cancellation?: AbortSignal, silent?: boolean): Promise<IntegrationResult<PullRequest[] | undefined>>;
+    private getMyPullRequestsCore;
+    getMyPullRequestsForRemotes(remote: GitRemote): Promise<IntegrationResult<PullRequest[] | undefined>>;
+    getMyPullRequestsForRemotes(remotes: GitRemote[]): Promise<IntegrationResult<PullRequest[] | undefined>>;
+    private _ignoreSSLErrors;
+    ignoreSSLErrors(integration: GitHostIntegration | {
+        id: IntegrationIds;
+        domain?: string;
+    }): boolean | 'force';
+    manageCloudIntegrations(source: Source | undefined): Promise<void>;
+    reset(): Promise<void>;
+    supports(remoteProviderId: RemoteProviderId): boolean;
+    private onAuthenticationSessionsChanged;
+    private onIntegrationConnectionChanged;
+    private onSubscriptionChanged;
+    private onUserCheckedIn;
+    private _providersApi;
+    private getProvidersApi;
+    private getCached;
+    private getCacheKey;
+    private getSupportedCloudIntegrations;
+    private findCachedById;
+    private syncCloudIntegrations;
+}
+//# sourceMappingURL=integrationService.d.ts.map

package/dist/plus/integrations/integrationService.d.ts.map

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