@gitkraken/core-gitlens 0.4.0 → 0.4.101

package/dist/plus/integrations/reads/sweeps.js.map

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

package/dist/plus/integrations/reads/warnings.d.ts

@@ -0,0 +1,47 @@
+import type { IntegrationIds } from '../constants.js';
+import type { IssueFilter, PullRequestFilter } from '../providerFilters.js';
+import type { ProviderWarning } from '../results.js';
+/**
+ * The warnings the provider facade raises on its OWN terms, as opposed to the ones derived from a caught
+ * provider error ({@link toProviderWarning}) or from SDK collection metadata (`collectionMetadata.ts`).
+ *
+ * These are pure message builders, kept together and out of the service so a read method reads as the decision
+ * it makes ("this surface doesn't apply, refuse it") rather than as the wording of the refusal, and so the same
+ * refusal can't be phrased two ways in two reads.
+ */
+/**
+ * The single builder for a provider-neutral, non-auth warning: an unsupported capability, a
+ * contradictory/inexpressible request, or a read that couldn't confirm completeness. Every `kind: 'other'`
+ * warning the facade emits goes through here (directly, or via one of the named builders below that pin a
+ * recurring message), so the discriminant is assigned in exactly one place.
+ *
+ * The kinds that carry a programmatic remedy — `auth`, `rate-limit`, `not-found`, `no-connection` — are derived
+ * from the caught error's type instead and never come from here; see `ProviderWarningKind` and
+ * {@link noConnectionWarning}.
+ */
+export declare function otherWarning(id: IntegrationIds, domain: string | undefined, connectionId: string | undefined, message: string): ProviderWarning;
+/**
+ * Builds a `no-connection` warning for a per-connection read that resolved neither a session nor an error: the
+ * requested `connectionId` no longer resolves (deleted, or its authentication is invalid). Consumers use this
+ * to tell a truly empty account apart from a broken connection.
+ */
+export declare function noConnectionWarning(id: IntegrationIds, domain: string | undefined, connectionId?: string): ProviderWarning;
+/** Warning for an issue-tracker provider asked for a surface only a git host serves (repos, PRs, sweeps). */
+export declare function gitHostOnlySurfaceWarning(id: IntegrationIds, domain: string | undefined, connectionId: string | undefined, surface: string): ProviderWarning;
+/** Warning for a git host asked for a surface only an issue tracker serves (resource → project issue reads). */
+export declare function issueTrackerOnlySurfaceWarning(id: IntegrationIds, connectionId: string | undefined, surface: string): ProviderWarning;
+/**
+ * Builds a warning for a drain that stopped short of completeness (hit a page backstop, or a single-page read
+ * that couldn't confirm it drained everything). `truncated`/`allPages` already carry this on the result, but
+ * consumers that only inspect `warnings` would otherwise see no signal the read is partial.
+ */
+export declare function truncationWarning(id: IntegrationIds, domain: string | undefined, connectionId: string | undefined, readKind: 'Pull request' | 'Issue' | 'Repository'): ProviderWarning;
+/** Warning for an account-wide issue read whose requested filters the provider can't express server-side. */
+export declare function unsupportedAccountWideIssueFiltersWarning(id: IntegrationIds, domain: string | undefined, connectionId: string | undefined, filters: IssueFilter[]): ProviderWarning;
+/** Warning for an account-wide PR read whose requested relationship union cannot be expressed exactly. */
+export declare function unsupportedAccountWidePullRequestFiltersWarning(id: IntegrationIds, domain: string | undefined, connectionId: string | undefined, filters: PullRequestFilter[]): ProviderWarning;
+/** Warning for a repo-scoped PR read whose requested filters the provider supports none of. */
+export declare function unsupportedFiltersWarning(id: IntegrationIds, domain: string | undefined, connectionId: string | undefined): ProviderWarning;
+/** Warning for a git host that doesn't expose issues on this surface (e.g. Bitbucket, deprecated in favor of Jira). */
+export declare function issuesUnsupportedWarning(id: IntegrationIds, domain: string | undefined, connectionId: string | undefined): ProviderWarning;
+//# sourceMappingURL=warnings.d.ts.map

package/dist/plus/integrations/reads/warnings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warnings.d.ts","sourceRoot":"","sources":["../../../../src/plus/integrations/reads/warnings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE5E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD;;;;;;;GAOG;AAEH;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC3B,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,OAAO,EAAE,MAAM,GACb,eAAe,CASjB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAClC,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,YAAY,CAAC,EAAE,MAAM,GACnB,eAAe,CAYjB;AAED,6GAA6G;AAC7G,wBAAgB,yBAAyB,CACxC,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,OAAO,EAAE,MAAM,GACb,eAAe,CAOjB;AAED,gHAAgH;AAChH,wBAAgB,8BAA8B,CAC7C,EAAE,EAAE,cAAc,EAClB,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,OAAO,EAAE,MAAM,GACb,eAAe,CAOjB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAChC,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,QAAQ,EAAE,cAAc,GAAG,OAAO,GAAG,YAAY,GAC/C,eAAe,CAOjB;AAED,6GAA6G;AAC7G,wBAAgB,yCAAyC,CACxD,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,OAAO,EAAE,WAAW,EAAE,GACpB,eAAe,CAQjB;AAED,0GAA0G;AAC1G,wBAAgB,+CAA+C,CAC9D,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,OAAO,EAAE,iBAAiB,EAAE,GAC1B,eAAe,CAQjB;AAED,+FAA+F;AAC/F,wBAAgB,yBAAyB,CACxC,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,YAAY,EAAE,MAAM,GAAG,SAAS,GAC9B,eAAe,CAOjB;AAED,uHAAuH;AACvH,wBAAgB,wBAAwB,CACvC,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,YAAY,EAAE,MAAM,GAAG,SAAS,GAC9B,eAAe,CAOjB"}

package/dist/plus/integrations/reads/warnings.js

@@ -0,0 +1,81 @@
+import { providersMetadata } from '../providers/models.js';
+/**
+ * The warnings the provider facade raises on its OWN terms, as opposed to the ones derived from a caught
+ * provider error ({@link toProviderWarning}) or from SDK collection metadata (`collectionMetadata.ts`).
+ *
+ * These are pure message builders, kept together and out of the service so a read method reads as the decision
+ * it makes ("this surface doesn't apply, refuse it") rather than as the wording of the refusal, and so the same
+ * refusal can't be phrased two ways in two reads.
+ */
+/**
+ * The single builder for a provider-neutral, non-auth warning: an unsupported capability, a
+ * contradictory/inexpressible request, or a read that couldn't confirm completeness. Every `kind: 'other'`
+ * warning the facade emits goes through here (directly, or via one of the named builders below that pin a
+ * recurring message), so the discriminant is assigned in exactly one place.
+ *
+ * The kinds that carry a programmatic remedy — `auth`, `rate-limit`, `not-found`, `no-connection` — are derived
+ * from the caught error's type instead and never come from here; see `ProviderWarningKind` and
+ * {@link noConnectionWarning}.
+ */
+export function otherWarning(id, domain, connectionId, message) {
+    return {
+        providerId: id,
+        domain: domain,
+        connectionId: connectionId,
+        message: message,
+        kind: 'other',
+        isAuth: false,
+    };
+}
+/**
+ * Builds a `no-connection` warning for a per-connection read that resolved neither a session nor an error: the
+ * requested `connectionId` no longer resolves (deleted, or its authentication is invalid). Consumers use this
+ * to tell a truly empty account apart from a broken connection.
+ */
+export function noConnectionWarning(id, domain, connectionId) {
+    return {
+        providerId: id,
+        domain: domain,
+        connectionId: connectionId,
+        message: connectionId != null
+            ? `Connection '${connectionId}' for '${id}' could not be resolved (deleted or invalid authentication).`
+            : `No active connection for '${id}' could be resolved.`,
+        kind: 'no-connection',
+        isAuth: false,
+    };
+}
+/** Warning for an issue-tracker provider asked for a surface only a git host serves (repos, PRs, sweeps). */
+export function gitHostOnlySurfaceWarning(id, domain, connectionId, surface) {
+    return otherWarning(id, domain, connectionId, `${surface} is not supported by '${id}'; use a git-host integration instead.`);
+}
+/** Warning for a git host asked for a surface only an issue tracker serves (resource → project issue reads). */
+export function issueTrackerOnlySurfaceWarning(id, connectionId, surface) {
+    return otherWarning(id, undefined, connectionId, `${surface} is not supported by '${id}'; use an issue-tracker integration instead.`);
+}
+/**
+ * Builds a warning for a drain that stopped short of completeness (hit a page backstop, or a single-page read
+ * that couldn't confirm it drained everything). `truncated`/`allPages` already carry this on the result, but
+ * consumers that only inspect `warnings` would otherwise see no signal the read is partial.
+ */
+export function truncationWarning(id, domain, connectionId, readKind) {
+    return otherWarning(id, domain, connectionId, `${readKind} read for '${id}' was truncated (a page backstop was reached); results may be incomplete.`);
+}
+/** Warning for an account-wide issue read whose requested filters the provider can't express server-side. */
+export function unsupportedAccountWideIssueFiltersWarning(id, domain, connectionId, filters) {
+    const supported = providersMetadata[id]?.supportedAccountWideIssueFilters ?? [];
+    return otherWarning(id, domain, connectionId, `The requested account-wide issue filters (${filters.join(', ')}) are not supported by '${id}'${supported.length ? ` (supported: ${supported.join(', ')})` : ''}; skipped to avoid returning a wider result than requested.`);
+}
+/** Warning for an account-wide PR read whose requested relationship union cannot be expressed exactly. */
+export function unsupportedAccountWidePullRequestFiltersWarning(id, domain, connectionId, filters) {
+    const supported = providersMetadata[id]?.supportedAccountWidePullRequestFilters ?? [];
+    return otherWarning(id, domain, connectionId, `The requested account-wide pull request filters (${filters.join(', ')}) are not supported by '${id}'${supported.length ? ` (supported: ${supported.join(', ')})` : ''}; skipped to avoid returning a wider result than requested.`);
+}
+/** Warning for a repo-scoped PR read whose requested filters the provider supports none of. */
+export function unsupportedFiltersWarning(id, domain, connectionId) {
+    return otherWarning(id, domain, connectionId, `The requested pull request filters are not supported by '${id}'; skipped to avoid returning unfiltered results.`);
+}
+/** Warning for a git host that doesn't expose issues on this surface (e.g. Bitbucket, deprecated in favor of Jira). */
+export function issuesUnsupportedWarning(id, domain, connectionId) {
+    return otherWarning(id, domain, connectionId, `Issues are not supported by '${id}'; use a dedicated issue integration (e.g. Jira) instead.`);
+}
+//# sourceMappingURL=warnings.js.map

package/dist/plus/integrations/reads/warnings.js.map

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

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

@@ -0,0 +1,189 @@
+import type { IntegrationIds } from './constants.js';
+export interface ConnectionStateChangeEvent {
+    key: string;
+    reason: 'connected' | 'disconnected';
+}
+/**
+ * A per-provider, per-connection warning surfaced alongside (partial) read results. Consumers use
+ * these to drive auth recovery, retry, or truncation messaging without the read itself throwing.
+ *
+ * `kind` is the programmatic discriminant (a rate-limit is retryable, a 404 is not, an auth failure
+ * needs re-connection); `isAuth` is retained as a convenience mirror of `kind === 'auth'`.
+ */
+export type ProviderWarningKind = 'auth' | 'rate-limit' | 'not-found' | 'no-connection' | 'other';
+export interface ProviderWarning {
+    providerId: IntegrationIds;
+    /** Disambiguates connections on self-managed hosts (where one provider id spans multiple domains). */
+    domain?: string;
+    /** The specific token/connection the read was pinned to, when a `connectionId` was supplied. */
+    connectionId?: string;
+    message: string;
+    kind: ProviderWarningKind;
+    /** Convenience mirror of `kind === 'auth'`. */
+    isAuth: boolean;
+}
+export interface ProviderPageInfo {
+    /**
+     * The 1-based POSITION of the returned page. One convention across every paged read, page-number and
+     * cursor paging alike, so a `getNextPageParam`-style consumer can key off it uniformly:
+     * - the page number the provider itself reported, when it reports one (authoritative);
+     * - else the position the caller addressed: the page encoded in a threaded page cursor, or the `page`
+     *   supplied alongside an opaque cursor (1 when the caller supplied no `page`);
+     * - else, for a read that can be advanced by page number, the requested `page` — the provider either
+     *   honored it or the internal drain reached it (see the paging contract on `IntegrationManager`);
+     * - else 1: a cursor-only read with no cursor threaded back ignores a requested page number and answers
+     *   with its first page, so echoing the request would mislabel page 1 as page N.
+     *
+     * A page past the provider's terminal cursor still reports the requested `page` with empty `items` — an
+     * empty page N, never page N-1 relabeled.
+     *
+     * Continue a cursor-paged read from `cursor`, NOT from `currentPage + 1`: a cursor-only host can't be
+     * addressed by number, so this is a position label and not always a resumable request parameter.
+     */
+    currentPage: number;
+    /**
+     * The page size IN EFFECT, which is not always the one requested — it is whichever of these the read can
+     * actually vouch for:
+     * - the size the provider reported for the page it served (numbered-page hosts), else
+     * - the `itemsPerPage` that was applied to the request (repo-scoped reads, which forward it), else
+     * - `items.length`, for a read that takes no page size at all: the account-wide PR/issue reads, `listRepos`
+     *   (cursor-only), and `listIssueTrackerIssuesPage`, whose `itemsPerPage` counts PROJECTS rather than issues.
+     *
+     * So it is a description of the page, not an echo of the request: don't derive a total from
+     * `currentPage * itemsPerPage`, and don't read `items.length < itemsPerPage` as "last page" — `hasMore` /
+     * `cursor` are the only continuation signals.
+     */
+    itemsPerPage: number;
+    /**
+     * A COMPLETENESS assertion, not a mode flag: `true` only when a sweep drained every page of every target
+     * without truncating or failing (`!truncated && !fetchFailed`). Set exclusively by `sweepPullRequests` /
+     * `sweepClosedPullRequests` and absent on every paged read, so `allPages !== true` does NOT by itself mean
+     * "this was a single page".
+     *
+     * This is the signal to gate on before caching a sweep as authoritative: unlike `truncated` it is `false`
+     * for BOTH kinds of incompleteness, so it can't be misread as a benign cap.
+     */
+    allPages?: boolean;
+    /**
+     * True when the read stopped before it could confirm it had everything. Deliberately does NOT distinguish
+     * WHY, and a consumer must not assume it means a provider ceiling — a sweep sets it from three different
+     * origins:
+     * - a provider-side ceiling or per-scope backstop propagated from below (e.g. GitHub Search's 1000-result
+     *   cap): the missing items are NOT reachable, so this really is "complete to the provider's limit";
+     * - the sweep's OWN `maxPages` cap (default 100) with a usable cursor still in hand: the missing items ARE
+     *   reachable and were simply not fetched — raise `maxPages` to get them;
+     * - the provider reporting another page but handing back no usable cursor: not reachable.
+     *
+     * Only the second is recoverable, and a sweep exposes no continuation cursor, so treating a truncated sweep
+     * as a complete set silently drops reachable data in that case. Prefer `allPages` for the cache decision.
+     */
+    truncated?: boolean;
+}
+export interface ProviderResult<T> {
+    items: T[];
+    warnings: ProviderWarning[];
+    /**
+     * True when `items` is incomplete — distinguishes a failed or truncated flat read from a genuinely empty
+     * result. Paged results additionally use `page.truncated` when a completed page could not confirm it
+     * drained everything.
+     */
+    fetchFailed?: boolean;
+}
+export interface ProviderPagedResult<T> extends ProviderResult<T> {
+    page: ProviderPageInfo;
+    hasMore: boolean;
+    /**
+     * Opaque cursor for cursor-based paging (GraphQL, per-repo/per-project cursors, etc.). For hosts that
+     * require the previous page's cursor, consumers should pass this value back to the next `cursor` option.
+     * A retry-only cursor may remain when `hasMore` is false: `hasMore` means automatic forward progress,
+     * while explicitly reusing such a cursor retries failed work without creating an infinite paging loop.
+     */
+    cursor?: string;
+}
+export interface ProviderSweepResult<T> extends ProviderResult<T> {
+    page: ProviderPageInfo;
+    hasMore: boolean;
+    /**
+     * Providers whose top-level read failed before returning any usable page. Partial per-scope failures stay
+     * represented by `warnings` + `fetchFailed` and are intentionally excluded.
+     */
+    failedProviderIds: IntegrationIds[];
+    /**
+     * Providers whose read started successfully but could not produce an authoritative complete slice (for
+     * example, a later page failed, collection metadata reported a partial scope, or a paging backstop was hit).
+     * Kept separate from
+     * `failedProviderIds` so consumers can accept healthy sibling providers while preserving an older snapshot
+     * for a provider whose returned slice has a gap.
+     */
+    incompleteProviderIds: IntegrationIds[];
+}
+export interface ProviderBroadenResult<T> extends ProviderPagedResult<T> {
+    broadenedProviderIds: IntegrationIds[];
+    /** Providers for which no requested org produced a usable issue result. */
+    failedProviderIds: IntegrationIds[];
+    /** Providers with both a usable org result and at least one failed or truncated org slice. */
+    incompleteProviderIds: IntegrationIds[];
+    fanOutCount: number;
+}
+export type RepositoryResolutionStatus = 'resolved' | 'not-found' | 'unauthorized' | 'unsupported-provider' | 'invalid-remote-url' | 'host-mismatch' | 'undetermined';
+export interface RepositoryIdentity {
+    providerId: IntegrationIds;
+    domain: string;
+    /** The provider's canonical owner/namespace (follows renames), falling back to the parsed remote when omitted. */
+    owner: string;
+    /** The provider's canonical repo name (follows renames), falling back to the parsed remote when omitted. */
+    name: string;
+    project?: string;
+    /** The original input remote URL, so the caller can key the resolution back to the remote it asked about. */
+    remoteUrl: string;
+    /**
+     * True when the provider's canonical owner/name differ from what the input remote URL carried — i.e. the
+     * repo was renamed/moved host-side and the local remote is stale. Case-insensitive, mirroring gkcli's
+     * `EqualFold` compare so hosts that echo the input casing (e.g. Bitbucket Server/Azure) aren't flagged.
+     */
+    renamed: boolean;
+}
+export interface RepositoryResolution {
+    status: RepositoryResolutionStatus;
+    identity?: RepositoryIdentity;
+    warning?: ProviderWarning;
+}
+export interface ResolveRepositoryResult {
+    resolution: RepositoryResolution;
+}
+/**
+ * Normalized org/workspace/group shape returned by the provider facade.
+ * `name` is the provider identifier to pass to follow-up reads, while `org` is an optional display label.
+ */
+export interface ProviderOrganization {
+    id: string;
+    providerId: IntegrationIds;
+    name: string;
+    org?: string;
+    url: string;
+}
+/** Normalized repository shape returned by the provider facade. */
+export interface ProviderRepositoryShape {
+    id: string;
+    namespace: string;
+    name: string;
+    /** Azure DevOps project; `undefined` for hosts without a project layer. */
+    project?: string;
+    /** Web (browser) URL, when the provider exposes it. */
+    url?: string;
+    /** HTTPS clone URL, when available. */
+    cloneUrlHttps?: string;
+    /** SSH clone URL, when available. */
+    cloneUrlSsh?: string;
+    /** Default branch name, when the provider reports it. */
+    defaultBranch?: string;
+}
+/**
+ * Classifies a caught provider exception into a neutral {@link ProviderWarning}. Ordering matters:
+ * `instanceof` is checked most-specific-first so a rate-limit isn't mislabeled as a generic error and
+ * a 404 isn't mislabeled as auth.
+ */
+export declare function toProviderWarning(providerId: IntegrationIds, domain: string | undefined, connectionId: string | undefined, ex: unknown): ProviderWarning;
+/** Appends `warning` to `into` only when an equal warning (by provider/connection/domain/kind/message) is absent. */
+export declare function appendDedupedWarning(into: ProviderWarning[], warning: ProviderWarning): void;
+//# sourceMappingURL=results.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"results.d.ts","sourceRoot":"","sources":["../../../src/plus/integrations/results.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,WAAW,0BAA0B;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,WAAW,GAAG,cAAc,CAAC;CACrC;AAED;;;;;;GAMG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,YAAY,GAAG,WAAW,GAAG,eAAe,GAAG,OAAO,CAAC;AAElG,MAAM,WAAW,eAAe;IAC/B,UAAU,EAAE,cAAc,CAAC;IAC3B,sGAAsG;IACtG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gGAAgG;IAChG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,mBAAmB,CAAC;IAC1B,+CAA+C;IAC/C,MAAM,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAChC;;;;;;;;;;;;;;;;OAgBG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;;;;;;;OAWG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,cAAc,CAAC,CAAC;IAChC,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB,CAAC,CAAC,CAAE,SAAQ,cAAc,CAAC,CAAC,CAAC;IAChE,IAAI,EAAE,gBAAgB,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB,CAAC,CAAC,CAAE,SAAQ,cAAc,CAAC,CAAC,CAAC;IAChE,IAAI,EAAE,gBAAgB,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,iBAAiB,EAAE,cAAc,EAAE,CAAC;IACpC;;;;;;OAMG;IACH,qBAAqB,EAAE,cAAc,EAAE,CAAC;CACxC;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC,CAAE,SAAQ,mBAAmB,CAAC,CAAC,CAAC;IACvE,oBAAoB,EAAE,cAAc,EAAE,CAAC;IACvC,2EAA2E;IAC3E,iBAAiB,EAAE,cAAc,EAAE,CAAC;IACpC,8FAA8F;IAC9F,qBAAqB,EAAE,cAAc,EAAE,CAAC;IACxC,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,0BAA0B,GACnC,UAAU,GACV,WAAW,GACX,cAAc,GACd,sBAAsB,GACtB,oBAAoB,GACpB,eAAe,GACf,cAAc,CAAC;AAElB,MAAM,WAAW,kBAAkB;IAClC,UAAU,EAAE,cAAc,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,kHAAkH;IAClH,KAAK,EAAE,MAAM,CAAC;IACd,4GAA4G;IAC5G,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6GAA6G;IAC7G,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,OAAO,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACpC,MAAM,EAAE,0BAA0B,CAAC;IACnC,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,OAAO,CAAC,EAAE,eAAe,CAAC;CAC1B;AAED,MAAM,WAAW,uBAAuB;IACvC,UAAU,EAAE,oBAAoB,CAAC;CACjC;AA4BD;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,cAAc,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACZ;AAED,mEAAmE;AACnE,MAAM,WAAW,uBAAuB;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAChC,UAAU,EAAE,cAAc,EAC1B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,EAAE,EAAE,OAAO,GACT,eAAe,CAoBjB;AASD,qHAAqH;AACrH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,eAAe,EAAE,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI,CAK5F"}

package/dist/plus/integrations/results.js

@@ -0,0 +1,62 @@
+import { AuthenticationError, RequestNotFoundError, RequestRateLimitError } from '../../git/errors.js';
+const maxProviderWarningMessageLength = 500;
+function providerWarningMessage(ex) {
+    const raw = (ex instanceof Error ? ex.message : String(ex)).trim();
+    const carrier = ex;
+    const status = typeof carrier?.status === 'number'
+        ? carrier.status
+        : typeof carrier?.response?.status === 'number'
+            ? carrier.response.status
+            : undefined;
+    // Gateways commonly answer API requests with a complete HTML error page. That payload is neither actionable
+    // nor suitable for a warning DTO consumed by UIs and logs; preserve the status without leaking the document.
+    if (/<(?:!doctype\s+html|html|head|body)\b/i.test(raw)) {
+        return status != null ? `Provider request failed with status ${status}.` : 'Provider request failed.';
+    }
+    if (!raw) {
+        return status != null ? `Provider request failed with status ${status}.` : 'Provider request failed.';
+    }
+    return raw.length > maxProviderWarningMessageLength
+        ? `${raw.slice(0, maxProviderWarningMessageLength - 3)}...`
+        : raw;
+}
+/**
+ * Classifies a caught provider exception into a neutral {@link ProviderWarning}. Ordering matters:
+ * `instanceof` is checked most-specific-first so a rate-limit isn't mislabeled as a generic error and
+ * a 404 isn't mislabeled as auth.
+ */
+export function toProviderWarning(providerId, domain, connectionId, ex) {
+    let kind;
+    if (ex instanceof AuthenticationError) {
+        kind = 'auth';
+    }
+    else if (ex instanceof RequestRateLimitError) {
+        kind = 'rate-limit';
+    }
+    else if (ex instanceof RequestNotFoundError) {
+        kind = 'not-found';
+    }
+    else {
+        kind = 'other';
+    }
+    return {
+        providerId: providerId,
+        domain: domain,
+        connectionId: connectionId,
+        message: providerWarningMessage(ex),
+        kind: kind,
+        isAuth: kind === 'auth',
+    };
+}
+/** A stable key for deduplicating warnings accumulated across drained pages / fan-out scopes. */
+function providerWarningKey(warning) {
+    return [warning.providerId, warning.connectionId ?? '', warning.domain ?? '', warning.kind, warning.message].join(' ');
+}
+/** Appends `warning` to `into` only when an equal warning (by provider/connection/domain/kind/message) is absent. */
+export function appendDedupedWarning(into, warning) {
+    const key = providerWarningKey(warning);
+    if (into.some(existing => providerWarningKey(existing) === key))
+        return;
+    into.push(warning);
+}
+//# sourceMappingURL=results.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"results.js","sourceRoot":"","sources":["../../../src/plus/integrations/results.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AA8K1G,MAAM,+BAA+B,GAAG,GAAG,CAAC;AAE5C,SAAS,sBAAsB,CAAC,EAAW;IAC1C,MAAM,GAAG,GAAG,CAAC,EAAE,YAAY,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACnE,MAAM,OAAO,GAAG,EAA8E,CAAC;IAC/F,MAAM,MAAM,GACX,OAAO,OAAO,EAAE,MAAM,KAAK,QAAQ;QAClC,CAAC,CAAC,OAAO,CAAC,MAAM;QAChB,CAAC,CAAC,OAAO,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,QAAQ;YAC9C,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM;YACzB,CAAC,CAAC,SAAS,CAAC;IAEf,4GAA4G;IAC5G,6GAA6G;IAC7G,IAAI,wCAAwC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACxD,OAAO,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,uCAAuC,MAAM,GAAG,CAAC,CAAC,CAAC,0BAA0B,CAAC;IACvG,CAAC;IAED,IAAI,CAAC,GAAG,EAAE,CAAC;QACV,OAAO,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,uCAAuC,MAAM,GAAG,CAAC,CAAC,CAAC,0BAA0B,CAAC;IACvG,CAAC;IACD,OAAO,GAAG,CAAC,MAAM,GAAG,+BAA+B;QAClD,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,+BAA+B,GAAG,CAAC,CAAC,KAAK;QAC3D,CAAC,CAAC,GAAG,CAAC;AACR,CAAC;AA+BD;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAChC,UAA0B,EAC1B,MAA0B,EAC1B,YAAgC,EAChC,EAAW;IAEX,IAAI,IAA6B,CAAC;IAClC,IAAI,EAAE,YAAY,mBAAmB,EAAE,CAAC;QACvC,IAAI,GAAG,MAAM,CAAC;IACf,CAAC;SAAM,IAAI,EAAE,YAAY,qBAAqB,EAAE,CAAC;QAChD,IAAI,GAAG,YAAY,CAAC;IACrB,CAAC;SAAM,IAAI,EAAE,YAAY,oBAAoB,EAAE,CAAC;QAC/C,IAAI,GAAG,WAAW,CAAC;IACpB,CAAC;SAAM,CAAC;QACP,IAAI,GAAG,OAAO,CAAC;IAChB,CAAC;IAED,OAAO;QACN,UAAU,EAAE,UAAU;QACtB,MAAM,EAAE,MAAM;QACd,YAAY,EAAE,YAAY;QAC1B,OAAO,EAAE,sBAAsB,CAAC,EAAE,CAAC;QACnC,IAAI,EAAE,IAAI;QACV,MAAM,EAAE,IAAI,KAAK,MAAM;KACvB,CAAC;AACH,CAAC;AAED,iGAAiG;AACjG,SAAS,kBAAkB,CAAC,OAAwB;IACnD,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,YAAY,IAAI,EAAE,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAChH,GAAG,CACH,CAAC;AACH,CAAC;AAED,qHAAqH;AACrH,MAAM,UAAU,oBAAoB,CAAC,IAAuB,EAAE,OAAwB;IACrF,MAAM,GAAG,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACxC,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,kBAAkB,CAAC,QAAQ,CAAC,KAAK,GAAG,CAAC;QAAE,OAAO;IAExE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACpB,CAAC"}

package/dist/plus/integrations/utils/domain.utils.d.ts

@@ -0,0 +1,5 @@
+/** Extracts the host from a domain expressed as either a URL or a bare host. */
+export declare function hostFromDomain(domain: string | undefined): string | undefined;
+/** Whether two URL-or-host domain values identify the same normalized host and port. */
+export declare function areDomainsOnSameHost(first: string | undefined, second: string | undefined): boolean;
+//# sourceMappingURL=domain.utils.d.ts.map

package/dist/plus/integrations/utils/domain.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.utils.d.ts","sourceRoot":"","sources":["../../../../src/plus/integrations/utils/domain.utils.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAiB7E;AAED,wFAAwF;AACxF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAInG"}

package/dist/plus/integrations/utils/domain.utils.js

@@ -0,0 +1,27 @@
+/** Extracts the host from a domain expressed as either a URL or a bare host. */
+export function hostFromDomain(domain) {
+    const value = domain?.trim();
+    if (!value)
+        return undefined;
+    if (/^[a-z][a-z\d+\-.]*:\/\//i.test(value)) {
+        try {
+            return new URL(value).host || undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    try {
+        return new URL(`https://${value}`).host || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Whether two URL-or-host domain values identify the same normalized host and port. */
+export function areDomainsOnSameHost(first, second) {
+    const firstHost = hostFromDomain(first);
+    const secondHost = hostFromDomain(second);
+    return firstHost != null && secondHost != null && firstHost === secondHost;
+}
+//# sourceMappingURL=domain.utils.js.map

package/dist/plus/integrations/utils/domain.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.utils.js","sourceRoot":"","sources":["../../../../src/plus/integrations/utils/domain.utils.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,MAAM,UAAU,cAAc,CAAC,MAA0B;IACxD,MAAM,KAAK,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAE7B,IAAI,0BAA0B,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5C,IAAI,CAAC;YACJ,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,IAAI,SAAS,CAAC;QACzC,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,SAAS,CAAC;QAClB,CAAC;IACF,CAAC;IAED,IAAI,CAAC;QACJ,OAAO,IAAI,GAAG,CAAC,WAAW,KAAK,EAAE,CAAC,CAAC,IAAI,IAAI,SAAS,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,SAAS,CAAC;IAClB,CAAC;AACF,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,oBAAoB,CAAC,KAAyB,EAAE,MAA0B;IACzF,MAAM,SAAS,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACxC,MAAM,UAAU,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IAC1C,OAAO,SAAS,IAAI,IAAI,IAAI,UAAU,IAAI,IAAI,IAAI,SAAS,KAAK,UAAU,CAAC;AAC5E,CAAC"}

package/dist/plus/integrations/utils/integration.utils.d.ts

@@ -1,6 +1,6 @@
 import type { RemoteProvider, RemoteProviderId } from '../../../git/models/remoteProvider.js';
 import type { CloudGitSelfManagedHostIntegrationIds, IntegrationIds } from '../constants.js';
-import { GitCloudHostIntegrationId, GitSelfManagedHostIntegrationId } from '../constants.js';
+import { GitCloudHostIntegrationId, GitSelfManagedHostIntegrationId, IssuesCloudHostIntegrationId } from '../constants.js';
 import type { GitHostIntegration } from '../models/gitHostIntegration.js';
 import type { Integration, IntegrationConnectedKey } from '../models/integration.js';
 export declare const supportedIntegrationIds: IntegrationIds[];
@@ -8,7 +8,33 @@ export declare function convertRemoteProviderIdToIntegrationId(remoteProviderId:
 export declare function getIntegrationConnectedKey<T extends IntegrationIds>(id: T, domain?: string): IntegrationConnectedKey<T>;
 export declare function getIntegrationIdForRemote(provider: RemoteProvider | undefined): GitCloudHostIntegrationId | GitSelfManagedHostIntegrationId | undefined;
 export declare function isCloudGitSelfManagedHostIntegrationId(id: IntegrationIds): id is CloudGitSelfManagedHostIntegrationIds;
+/**
+ * Whether a provider's cloud token uses `expiresIn: 0` to mean "never expires" (rather than "already
+ * expired"). GitHub and the cloud self-managed hosts always return 0 for their non-expiring tokens; Trello
+ * is issued with `expiration: never` (identity-service), so its cloud token comes back as 0 too. Callers
+ * must map 0 → a far-future expiry for these, or the session is immediately treated as expired.
+ */
+export declare function isNonExpiringZeroTokenIntegrationId(id: IntegrationIds): boolean;
 export declare function isGitHostIntegration(integration: Integration): integration is GitHostIntegration;
 export declare function isGitCloudHostIntegrationId(id: IntegrationIds): id is GitCloudHostIntegrationId;
 export declare function isGitSelfManagedHostIntegrationId(id: IntegrationIds): id is GitSelfManagedHostIntegrationId;
+/**
+ * Whether this id belongs to a dedicated issue tracker (resource → project) rather than a git host.
+ *
+ * Decided from the id alone, so a read can refuse a mismatched surface — a repo/PR read asked of Jira, or an
+ * issue-tracker project read asked of GitHub — before resolving a connection. The instance-level
+ * {@link isIssuesIntegration} answers the same question once an integration is in hand.
+ */
+export declare function isIssuesHostIntegrationId(id: IntegrationIds): id is IssuesCloudHostIntegrationId;
+/**
+ * Whether a read targeted only by an explicit self-managed `domain` (no `connectionId`) must treat a
+ * session-less core result as a broken target instead of an empty account. Without this, a self-managed host
+ * addressed only by domain — the manual-token/external-auth case `domain` exists to cover — returns an empty
+ * success with no warning and no `fetchFailed`, indistinguishable from "this host has nothing".
+ */
+export declare function warnOnMissingSessionForDomain(id: IntegrationIds, domain: string | undefined): boolean;
+/** Maps an integration id to the git-remote provider type used by the remote-URL matcher. */
+export declare function remoteProviderTypeForIntegration(id: IntegrationIds): RemoteProviderId | undefined;
+/** Normalizes a host remote-config `type` string (e.g. `'GitHub'`) to a git-remote provider type. */
+export declare function remoteProviderTypeForConfig(type: string): RemoteProviderId | undefined;
 //# sourceMappingURL=integration.utils.d.ts.map

package/dist/plus/integrations/utils/integration.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"integration.utils.d.ts","sourceRoot":"","sources":["../../src/utils/integration.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAC9F,OAAO,KAAK,EAAE,qCAAqC,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC7F,OAAO,EACN,yBAAyB,EACzB,+BAA+B,EAE/B,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,KAAK,EAAE,WAAW,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAuBrF,eAAO,MAAM,uBAAuB,EAAE,cAAc,EAS1C,CAAC;AAEX,wBAAgB,sCAAsC,CACrD,gBAAgB,EAAE,gBAAgB,GAChC,yBAAyB,GAAG,+BAA+B,GAAG,SAAS,CAezE;AAED,wBAAgB,0BAA0B,CAAC,CAAC,SAAS,cAAc,EAClE,EAAE,EAAE,CAAC,EACL,MAAM,CAAC,EAAE,MAAM,GACb,uBAAuB,CAAC,CAAC,CAAC,CAS5B;AAED,wBAAgB,yBAAyB,CACxC,QAAQ,EAAE,cAAc,GAAG,SAAS,GAClC,yBAAyB,GAAG,+BAA+B,GAAG,SAAS,CA0BzE;AAED,wBAAgB,sCAAsC,CACrD,EAAE,EAAE,cAAc,GAChB,EAAE,IAAI,qCAAqC,CAU7C;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,WAAW,GAAG,WAAW,IAAI,kBAAkB,CAEhG;AAED,wBAAgB,2BAA2B,CAAC,EAAE,EAAE,cAAc,GAAG,EAAE,IAAI,yBAAyB,CAU/F;AAED,wBAAgB,iCAAiC,CAAC,EAAE,EAAE,cAAc,GAAG,EAAE,IAAI,+BAA+B,CAE3G"}
+{"version":3,"file":"integration.utils.d.ts","sourceRoot":"","sources":["../../../../src/plus/integrations/utils/integration.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAC9F,OAAO,KAAK,EAAE,qCAAqC,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC7F,OAAO,EACN,yBAAyB,EACzB,+BAA+B,EAC/B,4BAA4B,EAC5B,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,KAAK,EAAE,WAAW,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAcrF,eAAO,MAAM,uBAAuB,EAAE,cAAc,EAQ1C,CAAC;AAEX,wBAAgB,sCAAsC,CACrD,gBAAgB,EAAE,gBAAgB,GAChC,yBAAyB,GAAG,+BAA+B,GAAG,SAAS,CAezE;AAED,wBAAgB,0BAA0B,CAAC,CAAC,SAAS,cAAc,EAClE,EAAE,EAAE,CAAC,EACL,MAAM,CAAC,EAAE,MAAM,GACb,uBAAuB,CAAC,CAAC,CAAC,CAS5B;AAED,wBAAgB,yBAAyB,CACxC,QAAQ,EAAE,cAAc,GAAG,SAAS,GAClC,yBAAyB,GAAG,+BAA+B,GAAG,SAAS,CA0BzE;AAED,wBAAgB,sCAAsC,CACrD,EAAE,EAAE,cAAc,GAChB,EAAE,IAAI,qCAAqC,CAU7C;AAED;;;;;GAKG;AACH,wBAAgB,mCAAmC,CAAC,EAAE,EAAE,cAAc,GAAG,OAAO,CAM/E;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,WAAW,GAAG,WAAW,IAAI,kBAAkB,CAEhG;AAED,wBAAgB,2BAA2B,CAAC,EAAE,EAAE,cAAc,GAAG,EAAE,IAAI,yBAAyB,CAU/F;AAED,wBAAgB,iCAAiC,CAAC,EAAE,EAAE,cAAc,GAAG,EAAE,IAAI,+BAA+B,CAE3G;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,cAAc,GAAG,EAAE,IAAI,4BAA4B,CAShG;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAErG;AAED,6FAA6F;AAC7F,wBAAgB,gCAAgC,CAAC,EAAE,EAAE,cAAc,GAAG,gBAAgB,GAAG,SAAS,CAkBjG;AAED,qGAAqG;AACrG,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAqBtF"}