@gitkraken/core-gitlens 0.3.1 → 0.4.100

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

@@ -0,0 +1,348 @@
+import { mapBounded } from '../../../utils/promise.js';
+import { mergeAssessmentInto } from '../collectionMetadata.js';
+import { GitCloudHostIntegrationId, GitSelfManagedHostIntegrationId, providerFanOutConcurrency, supportedOrderedCloudIntegrationIds, supportedOrderedCloudIssuesIntegrationIds, } from '../constants.js';
+import { isIssuesIntegration } from '../models/issuesIntegration.js';
+import { toProviderRepositoryShape } from '../providers/models.js';
+import { appendDedupedWarning } from '../results.js';
+import { isGitHostIntegration, isIssuesHostIntegrationId, warnOnMissingSessionForDomain, } from '../utils/integration.utils.js';
+import { runCaptured } from './drains.js';
+import { assertHierarchyReadTarget, orgForProject, resourceMatchesOrg, resourceToOrg, withProviderContext, } from './hierarchy.utils.js';
+import { pageToCursor, refusedPage, resolveContinuation, resolveCurrentPage, toProviderPageInfo } from './paging.js';
+import { gitHostOnlySurfaceWarning, otherWarning } from './warnings.js';
+export async function listOrgs(ctx, options) {
+    assertHierarchyReadTarget('listOrgs', options);
+    const ids = options?.providerId != null ? [options.providerId] : supportedOrderedCloudIntegrationIds;
+    const singleProvider = ids.length === 1;
+    const connectionId = singleProvider ? options?.connectionId : undefined;
+    const requestedDomain = singleProvider ? options?.domain : undefined;
+    const results = await mapBounded(ids, providerFanOutConcurrency, async (id) => {
+        const integration = await ctx.getIntegrationForRead(id, connectionId, requestedDomain);
+        if (integration == null) {
+            // A specifically requested connection that can't be resolved is a broken connection, not a
+            // provider with no orgs — surface it (warning + fetchFailed) instead of dropping the id
+            // silently, so a caller can tell it apart from an account that genuinely has no orgs.
+            const early = ctx.earlyReturnConnectionWarnings(id, connectionId, requestedDomain);
+            return {
+                items: [],
+                warnings: early.warnings,
+                fetchFailed: early.fetchFailed,
+            };
+        }
+        const items = [];
+        const warnings = [];
+        let fetchFailed = false;
+        const domain = ctx.domainForRead(integration, id, connectionId, requestedDomain);
+        const warnOnMissingSession = warnOnMissingSessionForDomain(id, requestedDomain);
+        if (isIssuesIntegration(integration)) {
+            // Issue trackers expose "resources" (Jira sites, Linear orgs, …) as their org analogue.
+            const { value: resources, warning } = await runCaptured(id, domain, connectionId, () => integration.getResourcesForUserResult(connectionId), { warnOnMissingSession: warnOnMissingSession });
+            if (resources != null) {
+                items.push(...resources.map(r => resourceToOrg(id, r)));
+            }
+            if (warning != null) {
+                warnings.push(warning);
+                // A warning with no value is a hard read failure, not an empty account.
+                if (resources == null) {
+                    fetchFailed = true;
+                }
+            }
+        }
+        else if (!integration.supportsOrganizationDiscovery) {
+            // The provider registers no org-discovery hook (e.g. Bitbucket Data Center). Report it as
+            // explicitly unsupported rather than contributing a silent empty list that a caller can't
+            // tell apart from "this account has no orgs".
+            fetchFailed = true;
+            warnings.push(otherWarning(id, domain, connectionId, `Organization discovery is not supported by '${id}'.`));
+        }
+        else {
+            const { value, warning } = await runCaptured(id, domain, connectionId, () => integration.getOrganizationsForUserResult(connectionId), { warnOnMissingSession: warnOnMissingSession });
+            if (value != null) {
+                items.push(...value.values.map(org => withProviderContext(id, org)));
+                if (value.truncated) {
+                    warnings.push(otherWarning(id, domain, connectionId, 'Organization listing was truncated before the upstream results were exhausted.'));
+                    // `ProviderResult` has no page object on which to carry truncation. Mark the flat
+                    // hierarchy result incomplete so consumers don't treat omitted orgs as authoritative.
+                    fetchFailed = true;
+                }
+                const assessment = mergeAssessmentInto(warnings, id, domain, connectionId, value.metadata);
+                if (assessment.fetchFailed || assessment.truncated) {
+                    fetchFailed = true;
+                }
+            }
+            if (warning != null) {
+                warnings.push(warning);
+                if (value == null) {
+                    fetchFailed = true;
+                }
+            }
+        }
+        return { items: items, warnings: warnings, fetchFailed: fetchFailed };
+    });
+    const items = [];
+    const warnings = [];
+    let fetchFailed = false;
+    for (const result of results) {
+        if (result == null) {
+            continue;
+        }
+        items.push(...result.items);
+        // Dedupe across the multi-provider fan-out (matches listProjects): a warning that repeats verbatim
+        // across scopes — e.g. the same account surfaced under two ids — shouldn't be reported twice.
+        for (const w of result.warnings) {
+            appendDedupedWarning(warnings, w);
+        }
+        if (result.fetchFailed) {
+            fetchFailed = true;
+        }
+    }
+    return { items: items, warnings: warnings, fetchFailed: fetchFailed || undefined };
+}
+export async function listProjects(ctx, options) {
+    assertHierarchyReadTarget('listProjects', options);
+    const ids = options?.providerId != null
+        ? [options.providerId]
+        : [
+            ...supportedOrderedCloudIssuesIntegrationIds,
+            GitCloudHostIntegrationId.AzureDevOps,
+            GitSelfManagedHostIntegrationId.AzureDevOpsServer,
+        ];
+    const singleProvider = ids.length === 1;
+    const connectionId = singleProvider ? options?.connectionId : undefined;
+    const requestedDomain = singleProvider ? options?.domain : undefined;
+    const results = await mapBounded(ids, providerFanOutConcurrency, async (id) => {
+        const integration = await ctx.getIntegrationForRead(id, connectionId, requestedDomain);
+        if (integration == null) {
+            // A requested connection that can't be resolved is a broken connection, not a provider with
+            // no projects — surface it (warning + fetchFailed) instead of dropping the id silently.
+            const early = ctx.earlyReturnConnectionWarnings(id, connectionId, requestedDomain);
+            return {
+                items: [],
+                warnings: early.warnings,
+                fetchFailed: early.fetchFailed,
+            };
+        }
+        const items = [];
+        const warnings = [];
+        let fetchFailed = false;
+        const domain = ctx.domainForRead(integration, id, connectionId, requestedDomain);
+        const org = options?.org;
+        const warnOnMissingSession = warnOnMissingSessionForDomain(id, requestedDomain);
+        // Git hosts with a project tier (Azure DevOps) read projects through their own hierarchy hook,
+        // scoped to `org` when given. Non-Azure git hosts have no project tier and return undefined.
+        if (!isIssuesIntegration(integration)) {
+            // Check the capability first, like listOrgs/listRepos/listIssuesPage do. Without it, a host
+            // with no project tier returns `undefined` from a successful read, which `runCaptured` can't
+            // tell apart from an unresolvable session — turning a healthy provider into a `no-connection`
+            // warning + `fetchFailed` (and, in Kepler, a spurious reconnect prompt).
+            if (!integration.supportsProjectDiscovery) {
+                return { items: items, warnings: warnings, fetchFailed: false };
+            }
+            const { value: projects, warning } = await runCaptured(id, domain, connectionId, () => integration.getProjectsForOrgResult(org, connectionId), { warnOnMissingSession: warnOnMissingSession });
+            if (warning != null) {
+                warnings.push(warning);
+                if (projects == null) {
+                    fetchFailed = true;
+                }
+            }
+            if (projects != null) {
+                items.push(...projects.values.map(project => withProviderContext(id, project)));
+                if (projects.truncated) {
+                    warnings.push(otherWarning(id, domain, connectionId, 'Project listing was truncated before the upstream results were exhausted.'));
+                    // Unlike paged repository reads, this flattened hierarchy result has no continuation
+                    // or page metadata. `fetchFailed` is its structural non-authoritative signal.
+                    fetchFailed = true;
+                }
+                const assessment = mergeAssessmentInto(warnings, id, domain, connectionId, projects.metadata);
+                if (assessment.fetchFailed || assessment.truncated) {
+                    fetchFailed = true;
+                }
+            }
+            return { items: items, warnings: warnings, fetchFailed: fetchFailed };
+        }
+        const { value: resources, warning: resourcesWarning } = await runCaptured(id, domain, connectionId, () => integration.getResourcesForUserResult(connectionId), { warnOnMissingSession: warnOnMissingSession });
+        if (resourcesWarning != null) {
+            warnings.push(resourcesWarning);
+            if (resources == null) {
+                fetchFailed = true;
+            }
+        }
+        const scopedResources = org != null ? resources?.filter(resource => resourceMatchesOrg(resource, org)) : resources;
+        if (scopedResources != null && scopedResources.length !== 0) {
+            const { value: projects, warning: projectsWarning } = await runCaptured(id, domain, connectionId, () => integration.getProjectsForResourcesWithMetadataResult(scopedResources, connectionId));
+            if (projectsWarning != null) {
+                warnings.push(projectsWarning);
+                if (projects == null) {
+                    fetchFailed = true;
+                }
+            }
+            if (projects != null) {
+                items.push(...projects.values.map(project => resourceToOrg(id, project, orgForProject(id, project, scopedResources))));
+            }
+            const assessment = mergeAssessmentInto(warnings, id, domain, connectionId, projects?.metadata);
+            if (assessment.fetchFailed || assessment.truncated) {
+                fetchFailed = true;
+            }
+        }
+        return { items: items, warnings: warnings, fetchFailed: fetchFailed };
+    });
+    const items = [];
+    const warnings = [];
+    let fetchFailed = false;
+    for (const result of results) {
+        if (result == null) {
+            continue;
+        }
+        items.push(...result.items);
+        for (const w of result.warnings) {
+            appendDedupedWarning(warnings, w);
+        }
+        if (result.fetchFailed) {
+            fetchFailed = true;
+        }
+    }
+    return { items: items, warnings: warnings, fetchFailed: fetchFailed || undefined };
+}
+export async function listRepos(ctx, options) {
+    const page = Math.max(1, options.page ?? 1);
+    if (isIssuesHostIntegrationId(options.providerId)) {
+        return refusedPage(page, [gitHostOnlySurfaceWarning(options.providerId, undefined, options.connectionId, 'repository discovery')], true);
+    }
+    const integration = await ctx.getIntegrationForRead(options.providerId, options.connectionId, options.domain);
+    if (integration == null) {
+        // A supplied connection or domain that no longer resolves is a broken target, not an empty account —
+        // surface a no-connection warning + fetchFailed rather than a silent empty page.
+        const early = ctx.earlyReturnConnectionWarnings(options.providerId, options.connectionId, options.domain);
+        return refusedPage(page, early.warnings, early.fetchFailed);
+    }
+    if (!isGitHostIntegration(integration)) {
+        return refusedPage(page, [gitHostOnlySurfaceWarning(options.providerId, undefined, options.connectionId, 'repository discovery')], true);
+    }
+    const domain = ctx.domainForRead(integration, options.providerId, options.connectionId, options.domain);
+    const accountWide = options.org == null;
+    const supported = accountWide
+        ? integration.supportsUserRepositoryDiscovery
+        : integration.supportsRepositoryDiscovery;
+    if (!supported) {
+        // No matching repo-discovery hook — org-scoped (e.g. Bitbucket Data Center) or account-wide (e.g.
+        // Bitbucket/Azure, whose repos can only be walked per workspace/org). Report unsupported rather than
+        // a silent empty page indistinguishable from "no repos"; for the account-wide case the caller should
+        // fan out per org from listOrgs instead.
+        return refusedPage(page, [
+            otherWarning(options.providerId, domain, options.connectionId, accountWide
+                ? `Account-wide repository discovery is not supported by '${options.providerId}'; list repositories per org instead.`
+                : `Repository discovery is not supported by '${options.providerId}'.`),
+        ], true);
+    }
+    const org = options.org;
+    const cursor = options.cursor ?? pageToCursor(page);
+    const { value, warning } = await runCaptured(options.providerId, domain, options.connectionId, () => org == null
+        ? integration.getRepositoriesForUserResult({
+            cursor: cursor,
+            connectionId: options.connectionId,
+        })
+        : integration.getRepositoriesForOrgResult(org, {
+            project: options.project,
+            cursor: cursor,
+            connectionId: options.connectionId,
+        }), { warnOnMissingSession: warnOnMissingSessionForDomain(options.providerId, options.domain) });
+    const items = value?.values ?? [];
+    const warnings = warning != null ? [warning] : [];
+    // The repos read core is cursor-only and can't accept a page size, so don't echo the requested
+    // `itemsPerPage` as if it were applied — report what the provider returned (its own pageSize when
+    // available, else the actual item count).
+    const paged = toProviderPageInfo(items.length, value?.paging);
+    // Convert the SDK collection metadata into scope-aware warnings + failure/truncation flags, appending
+    // them to any captured thrown-error warning without discarding the partial result's items.
+    const assessment = mergeAssessmentInto(warnings, options.providerId, domain, options.connectionId, value?.metadata);
+    // Whether this read honors a page NUMBER, decided from what the provider actually reported rather than
+    // guessed from the absence of a cursor. A numbered-page repos host reports its position (`paging.page`)
+    // and/or its successor (`paging.nextPage`) — Bitbucket's workspace walk consumes `page` as a real 1-based
+    // page and reports `nextPage` without echoing `currentPage`, so both signals have to count. Every wired
+    // cursor-based repos read (GitHub's org/user walks, GitLab's user walk, Bitbucket's cursor read) reports
+    // neither. Keying off `paged.cursor == null` instead read the paging layer's "reported another page,
+    // handed back no continuation" sentinel as evidence of a numbered host, which is exactly backwards.
+    const pageAdvanceable = value?.paging?.page != null || value?.paging?.nextPage != null;
+    // Numbered-page hosts that don't echo `currentPage` may still be advanced by the requested `page` (initial
+    // read) or by the cursor the caller threaded back. A cursor-only host ignores an UNTHREADED `page`
+    // request, so its page-less first page is page 1.
+    const currentPage = resolveCurrentPage({
+        providerPage: paged.page.currentPage,
+        requestedPage: page,
+        suppliedCursor: options.cursor,
+        pageAdvanceable: pageAdvanceable,
+    });
+    // Never advertise `hasMore` without a continuation the caller can act on — the same contract
+    // `listPullRequestsPage`, `listIssuesPage` and `broadenIssues` hold, via the same helper. A provider that
+    // reports another page but hands back neither `endCursor` nor `nextPage` (surfaced as the `'{}'` sentinel,
+    // which `toProviderPageInfo` drops) is terminal-but-incomplete: `hasMore: false` + `page.truncated`.
+    // Synthesizing a page-number cursor for a cursor-only host instead — which is what this read used to do
+    // unconditionally — handed back a continuation the provider ignores, so it answered with its FIRST page
+    // again while still reporting `hasMore: true`. A consumer draining until `hasMore` clears (Kepler's repo
+    // drain does exactly that) then looped to its own page cap, accumulating a duplicate copy of every repo
+    // per round, and never saw a truncation signal.
+    const continuation = resolveContinuation(paged, pageAdvanceable ? currentPage + 1 : undefined);
+    // The org-hierarchy read can also stop at a defensive backstop with more repos unlisted and no cursor to
+    // resume (top-level `truncated`, or `paging.truncated` on a single-page read). Metadata incompleteness and
+    // a demoted continuation are two further, independent sources of the same signal.
+    const truncated = (value?.truncated ?? false) ||
+        (value?.paging?.truncated ?? false) ||
+        assessment.truncated ||
+        continuation.truncated;
+    const result = {
+        // Normalize the raw provider-apis repos to the GitLens-owned shape at the surface boundary.
+        items: items.map(toProviderRepositoryShape),
+        warnings: warnings,
+        page: { ...paged.page, currentPage: currentPage, truncated: truncated || undefined },
+        hasMore: continuation.hasMore,
+        cursor: continuation.cursor,
+        fetchFailed: assessment.fetchFailed || (warning != null && value == null) || undefined,
+    };
+    // A cursor-only host ignores the synthesized page cursor above and returns page 1. Detect that from
+    // the provider's own paging metadata, then advance through its real continuations. Numbered hosts
+    // keep their one-request path because `pageAdvanceable` is true.
+    if (options.cursor == null && page > 1 && !pageAdvanceable) {
+        const traversalWarnings = [...result.warnings];
+        let traversalFetchFailed = result.fetchFailed === true;
+        let traversalTruncated = result.page.truncated === true;
+        let previous = result;
+        for (let currentPage = 2; currentPage <= page; currentPage++) {
+            if (!previous.hasMore || previous.cursor == null) {
+                return {
+                    items: [],
+                    warnings: traversalWarnings,
+                    page: {
+                        currentPage: page,
+                        itemsPerPage: 0,
+                        truncated: traversalTruncated || undefined,
+                    },
+                    hasMore: false,
+                    fetchFailed: traversalFetchFailed || undefined,
+                };
+            }
+            const requested = await listRepos(ctx, {
+                ...options,
+                page: currentPage,
+                cursor: previous.cursor,
+            });
+            for (const traversalWarning of requested.warnings) {
+                appendDedupedWarning(traversalWarnings, traversalWarning);
+            }
+            traversalFetchFailed ||= requested.fetchFailed === true;
+            traversalTruncated ||= requested.page.truncated === true;
+            if (currentPage === page) {
+                return {
+                    ...requested,
+                    warnings: traversalWarnings,
+                    page: {
+                        ...requested.page,
+                        truncated: traversalTruncated || undefined,
+                    },
+                    fetchFailed: traversalFetchFailed || undefined,
+                };
+            }
+            previous = requested;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=hierarchy.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hierarchy.js","sourceRoot":"","sources":["../../../../src/plus/integrations/reads/hierarchy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EACN,yBAAyB,EACzB,+BAA+B,EAE/B,yBAAyB,EACzB,mCAAmC,EACnC,yCAAyC,GACzC,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAQnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EACN,oBAAoB,EACpB,yBAAyB,EACzB,6BAA6B,GAC7B,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EACN,yBAAyB,EACzB,aAAa,EACb,kBAAkB,EAClB,aAAa,EACb,mBAAmB,GACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACrH,OAAO,EAAE,yBAAyB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAExE,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC7B,GAAwB,EACxB,OAAyB;IAEzB,yBAAyB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC/C,MAAM,GAAG,GAAG,OAAO,EAAE,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,mCAAmC,CAAC;IACrG,MAAM,cAAc,GAAG,GAAG,CAAC,MAAM,KAAK,CAAC,CAAC;IACxC,MAAM,YAAY,GAAG,cAAc,CAAC,CAAC,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC;IACxE,MAAM,eAAe,GAAG,cAAc,CAAC,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IAErE,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,yBAAyB,EAAE,KAAK,EAAC,EAAE,EAAC,EAAE;QAC3E,MAAM,WAAW,GAAG,MAAM,GAAG,CAAC,qBAAqB,CAAC,EAAE,EAAE,YAAY,EAAE,eAAe,CAAC,CAAC;QACvF,IAAI,WAAW,IAAI,IAAI,EAAE,CAAC;YACzB,2FAA2F;YAC3F,wFAAwF;YACxF,sFAAsF;YACtF,MAAM,KAAK,GAAG,GAAG,CAAC,6BAA6B,CAAC,EAAE,EAAE,YAAY,EAAE,eAAe,CAAC,CAAC;YACnF,OAAO;gBACN,KAAK,EAAE,EAA4B;gBACnC,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,WAAW,EAAE,KAAK,CAAC,WAAW;aAC9B,CAAC;QACH,CAAC;QAED,MAAM,KAAK,GAA2B,EAAE,CAAC;QACzC,MAAM,QAAQ,GAAsB,EAAE,CAAC;QACvC,IAAI,WAAW,GAAG,KAAK,CAAC;QACxB,MAAM,MAAM,GAAG,GAAG,CAAC,aAAa,CAAC,WAAW,EAAE,EAAE,EAAE,YAAY,EAAE,eAAe,CAAC,CAAC;QACjF,MAAM,oBAAoB,GAAG,6BAA6B,CAAC,EAAE,EAAE,eAAe,CAAC,CAAC;QAChF,IAAI,mBAAmB,CAAC,WAAW,CAAC,EAAE,CAAC;YACtC,wFAAwF;YACxF,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,MAAM,WAAW,CACtD,EAAE,EACF,MAAM,EACN,YAAY,EACZ,GAAG,EAAE,CAAC,WAAW,CAAC,yBAAyB,CAAC,YAAY,CAAC,EACzD,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,CAC9C,CAAC;YACF,IAAI,SAAS,IAAI,IAAI,EAAE,CAAC;gBACvB,KAAK,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YACzD,CAAC;YACD,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;gBACrB,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACvB,wEAAwE;gBACxE,IAAI,SAAS,IAAI,IAAI,EAAE,CAAC;oBACvB,WAAW,GAAG,IAAI,CAAC;gBACpB,CAAC;YACF,CAAC;QACF,CAAC;aAAM,IAAI,CAAC,WAAW,CAAC,6BAA6B,EAAE,CAAC;YACvD,0FAA0F;YAC1F,0FAA0F;YAC1F,8CAA8C;YAC9C,WAAW,GAAG,IAAI,CAAC;YACnB,QAAQ,CAAC,IAAI,CACZ,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,+CAA+C,EAAE,IAAI,CAAC,CAC7F,CAAC;QACH,CAAC;aAAM,CAAC;YACP,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,WAAW,CAC3C,EAAE,EACF,MAAM,EACN,YAAY,EACZ,GAAG,EAAE,CAAC,WAAW,CAAC,6BAA6B,CAAC,YAAY,CAAC,EAC7D,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,CAC9C,CAAC;YACF,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;gBACnB,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,mBAAmB,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;gBACrE,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;oBACrB,QAAQ,CAAC,IAAI,CACZ,YAAY,CACX,EAAE,EACF,MAAM,EACN,YAAY,EACZ,gFAAgF,CAChF,CACD,CAAC;oBACF,kFAAkF;oBAClF,sFAAsF;oBACtF,WAAW,GAAG,IAAI,CAAC;gBACpB,CAAC;gBAED,MAAM,UAAU,GAAG,mBAAmB,CAAC,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;gBAC3F,IAAI,UAAU,CAAC,WAAW,IAAI,UAAU,CAAC,SAAS,EAAE,CAAC;oBACpD,WAAW,GAAG,IAAI,CAAC;gBACpB,CAAC;YACF,CAAC;YACD,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;gBACrB,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACvB,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;oBACnB,WAAW,GAAG,IAAI,CAAC;gBACpB,CAAC;YACF,CAAC;QACF,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;IACvE,CAAC,CAAC,CAAC;IAEH,MAAM,KAAK,GAA2B,EAAE,CAAC;IACzC,MAAM,QAAQ,GAAsB,EAAE,CAAC;IACvC,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC9B,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;YACpB,SAAS;QACV,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,mGAAmG;QACnG,8FAA8F;QAC9F,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACjC,oBAAoB,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QACnC,CAAC;QACD,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YACxB,WAAW,GAAG,IAAI,CAAC;QACpB,CAAC;IACF,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,IAAI,SAAS,EAAE,CAAC;AACpF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CACjC,GAAwB,EACxB,OAA6B;IAE7B,yBAAyB,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IACnD,MAAM,GAAG,GACR,OAAO,EAAE,UAAU,IAAI,IAAI;QAC1B,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;QACtB,CAAC,CAAC;YACA,GAAG,yCAAyC;YAC5C,yBAAyB,CAAC,WAAW;YACrC,+BAA+B,CAAC,iBAAiB;SACjD,CAAC;IACL,MAAM,cAAc,GAAG,GAAG,CAAC,MAAM,KAAK,CAAC,CAAC;IACxC,MAAM,YAAY,GAAG,cAAc,CAAC,CAAC,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC;IACxE,MAAM,eAAe,GAAG,cAAc,CAAC,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IAErE,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,yBAAyB,EAAE,KAAK,EAAC,EAAE,EAAC,EAAE;QAC3E,MAAM,WAAW,GAAG,MAAM,GAAG,CAAC,qBAAqB,CAAC,EAAE,EAAE,YAAY,EAAE,eAAe,CAAC,CAAC;QACvF,IAAI,WAAW,IAAI,IAAI,EAAE,CAAC;YACzB,4FAA4F;YAC5F,wFAAwF;YACxF,MAAM,KAAK,GAAG,GAAG,CAAC,6BAA6B,CAAC,EAAE,EAAE,YAAY,EAAE,eAAe,CAAC,CAAC;YACnF,OAAO;gBACN,KAAK,EAAE,EAA4B;gBACnC,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,WAAW,EAAE,KAAK,CAAC,WAAW;aAC9B,CAAC;QACH,CAAC;QAED,MAAM,KAAK,GAA2B,EAAE,CAAC;QACzC,MAAM,QAAQ,GAAsB,EAAE,CAAC;QACvC,IAAI,WAAW,GAAG,KAAK,CAAC;QACxB,MAAM,MAAM,GAAG,GAAG,CAAC,aAAa,CAAC,WAAW,EAAE,EAAE,EAAE,YAAY,EAAE,eAAe,CAAC,CAAC;QACjF,MAAM,GAAG,GAAG,OAAO,EAAE,GAAG,CAAC;QACzB,MAAM,oBAAoB,GAAG,6BAA6B,CAAC,EAAE,EAAE,eAAe,CAAC,CAAC;QAEhF,+FAA+F;QAC/F,6FAA6F;QAC7F,IAAI,CAAC,mBAAmB,CAAC,WAAW,CAAC,EAAE,CAAC;YACvC,4FAA4F;YAC5F,6FAA6F;YAC7F,8FAA8F;YAC9F,yEAAyE;YACzE,IAAI,CAAC,WAAW,CAAC,wBAAwB,EAAE,CAAC;gBAC3C,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;YACjE,CAAC;YAED,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,WAAW,CACrD,EAAE,EACF,MAAM,EACN,YAAY,EACZ,GAAG,EAAE,CAAC,WAAW,CAAC,uBAAuB,CAAC,GAAG,EAAE,YAAY,CAAC,EAC5D,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,CAC9C,CAAC;YACF,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;gBACrB,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACvB,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;oBACtB,WAAW,GAAG,IAAI,CAAC;gBACpB,CAAC;YACF,CAAC;YACD,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;gBACtB,KAAK,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,mBAAmB,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;gBAEhF,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;oBACxB,QAAQ,CAAC,IAAI,CACZ,YAAY,CACX,EAAE,EACF,MAAM,EACN,YAAY,EACZ,2EAA2E,CAC3E,CACD,CAAC;oBACF,qFAAqF;oBACrF,8EAA8E;oBAC9E,WAAW,GAAG,IAAI,CAAC;gBACpB,CAAC;gBAED,MAAM,UAAU,GAAG,mBAAmB,CAAC,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBAC9F,IAAI,UAAU,CAAC,WAAW,IAAI,UAAU,CAAC,SAAS,EAAE,CAAC;oBACpD,WAAW,GAAG,IAAI,CAAC;gBACpB,CAAC;YACF,CAAC;YACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;QACvE,CAAC;QAED,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,gBAAgB,EAAE,GAAG,MAAM,WAAW,CACxE,EAAE,EACF,MAAM,EACN,YAAY,EACZ,GAAG,EAAE,CAAC,WAAW,CAAC,yBAAyB,CAAC,YAAY,CAAC,EACzD,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,CAC9C,CAAC;QACF,IAAI,gBAAgB,IAAI,IAAI,EAAE,CAAC;YAC9B,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YAChC,IAAI,SAAS,IAAI,IAAI,EAAE,CAAC;gBACvB,WAAW,GAAG,IAAI,CAAC;YACpB,CAAC;QACF,CAAC;QAED,MAAM,eAAe,GACpB,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,kBAAkB,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5F,IAAI,eAAe,IAAI,IAAI,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7D,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,eAAe,EAAE,GAAG,MAAM,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,CACtG,WAAW,CAAC,yCAAyC,CAAC,eAAe,EAAE,YAAY,CAAC,CACpF,CAAC;YACF,IAAI,eAAe,IAAI,IAAI,EAAE,CAAC;gBAC7B,QAAQ,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;gBAC/B,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;oBACtB,WAAW,GAAG,IAAI,CAAC;gBACpB,CAAC;YACF,CAAC;YACD,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;gBACtB,KAAK,CAAC,IAAI,CACT,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAChC,aAAa,CAAC,EAAE,EAAE,OAAO,EAAE,aAAa,CAAC,EAAE,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC,CACvE,CACD,CAAC;YACH,CAAC;YACD,MAAM,UAAU,GAAG,mBAAmB,CAAC,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;YAC/F,IAAI,UAAU,CAAC,WAAW,IAAI,UAAU,CAAC,SAAS,EAAE,CAAC;gBACpD,WAAW,GAAG,IAAI,CAAC;YACpB,CAAC;QACF,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;IACvE,CAAC,CAAC,CAAC;IAEH,MAAM,KAAK,GAA2B,EAAE,CAAC;IACzC,MAAM,QAAQ,GAAsB,EAAE,CAAC;IACvC,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC9B,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;YACpB,SAAS;QACV,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACjC,oBAAoB,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QACnC,CAAC;QACD,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YACxB,WAAW,GAAG,IAAI,CAAC;QACpB,CAAC;IACF,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,IAAI,SAAS,EAAE,CAAC;AACpF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAC9B,GAAwB,EACxB,OASC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;IAC5C,IAAI,yBAAyB,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACnD,OAAO,WAAW,CACjB,IAAI,EACJ,CAAC,yBAAyB,CAAC,OAAO,CAAC,UAAU,EAAE,SAAS,EAAE,OAAO,CAAC,YAAY,EAAE,sBAAsB,CAAC,CAAC,EACxG,IAAI,CACJ,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,GAAG,CAAC,qBAAqB,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9G,IAAI,WAAW,IAAI,IAAI,EAAE,CAAC;QACzB,qGAAqG;QACrG,iFAAiF;QACjF,MAAM,KAAK,GAAG,GAAG,CAAC,6BAA6B,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAC1G,OAAO,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IAC7D,CAAC;IACD,IAAI,CAAC,oBAAoB,CAAC,WAAW,CAAC,EAAE,CAAC;QACxC,OAAO,WAAW,CACjB,IAAI,EACJ,CAAC,yBAAyB,CAAC,OAAO,CAAC,UAAU,EAAE,SAAS,EAAE,OAAO,CAAC,YAAY,EAAE,sBAAsB,CAAC,CAAC,EACxG,IAAI,CACJ,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,GAAG,CAAC,aAAa,CAAC,WAAW,EAAE,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAExG,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC;IACxC,MAAM,SAAS,GAAG,WAAW;QAC5B,CAAC,CAAC,WAAW,CAAC,+BAA+B;QAC7C,CAAC,CAAC,WAAW,CAAC,2BAA2B,CAAC;IAC3C,IAAI,CAAC,SAAS,EAAE,CAAC;QAChB,kGAAkG;QAClG,qGAAqG;QACrG,qGAAqG;QACrG,yCAAyC;QACzC,OAAO,WAAW,CACjB,IAAI,EACJ;YACC,YAAY,CACX,OAAO,CAAC,UAAU,EAClB,MAAM,EACN,OAAO,CAAC,YAAY,EACpB,WAAW;gBACV,CAAC,CAAC,0DAA0D,OAAO,CAAC,UAAU,uCAAuC;gBACrH,CAAC,CAAC,6CAA6C,OAAO,CAAC,UAAU,IAAI,CACtE;SACD,EACD,IAAI,CACJ,CAAC;IACH,CAAC;IAED,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IACxB,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;IACpD,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,WAAW,CAC3C,OAAO,CAAC,UAAU,EAClB,MAAM,EACN,OAAO,CAAC,YAAY,EACpB,GAAG,EAAE,CACJ,GAAG,IAAI,IAAI;QACV,CAAC,CAAC,WAAW,CAAC,4BAA4B,CAAC;YACzC,MAAM,EAAE,MAAM;YACd,YAAY,EAAE,OAAO,CAAC,YAAY;SAClC,CAAC;QACH,CAAC,CAAC,WAAW,CAAC,2BAA2B,CAAC,GAAG,EAAE;YAC7C,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,MAAM,EAAE,MAAM;YACd,YAAY,EAAE,OAAO,CAAC,YAAY;SAClC,CAAC,EACL,EAAE,oBAAoB,EAAE,6BAA6B,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,CAC3F,CAAC;IAEF,MAAM,KAAK,GAAG,KAAK,EAAE,MAAM,IAAI,EAAE,CAAC;IAClC,MAAM,QAAQ,GAAG,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAClD,+FAA+F;IAC/F,kGAAkG;IAClG,0CAA0C;IAC1C,MAAM,KAAK,GAAG,kBAAkB,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAC9D,sGAAsG;IACtG,2FAA2F;IAC3F,MAAM,UAAU,GAAG,mBAAmB,CAAC,QAAQ,EAAE,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,YAAY,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IACpH,uGAAuG;IACvG,wGAAwG;IACxG,0GAA0G;IAC1G,wGAAwG;IACxG,yGAAyG;IACzG,qGAAqG;IACrG,oGAAoG;IACpG,MAAM,eAAe,GAAG,KAAK,EAAE,MAAM,EAAE,IAAI,IAAI,IAAI,IAAI,KAAK,EAAE,MAAM,EAAE,QAAQ,IAAI,IAAI,CAAC;IACvF,2GAA2G;IAC3G,mGAAmG;IACnG,kDAAkD;IAClD,MAAM,WAAW,GAAG,kBAAkB,CAAC;QACtC,YAAY,EAAE,KAAK,CAAC,IAAI,CAAC,WAAW;QACpC,aAAa,EAAE,IAAI;QACnB,cAAc,EAAE,OAAO,CAAC,MAAM;QAC9B,eAAe,EAAE,eAAe;KAChC,CAAC,CAAC;IACH,6FAA6F;IAC7F,0GAA0G;IAC1G,2GAA2G;IAC3G,qGAAqG;IACrG,wGAAwG;IACxG,wGAAwG;IACxG,yGAAyG;IACzG,wGAAwG;IACxG,gDAAgD;IAChD,MAAM,YAAY,GAAG,mBAAmB,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC/F,yGAAyG;IACzG,2GAA2G;IAC3G,kFAAkF;IAClF,MAAM,SAAS,GACd,CAAC,KAAK,EAAE,SAAS,IAAI,KAAK,CAAC;QAC3B,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,IAAI,KAAK,CAAC;QACnC,UAAU,CAAC,SAAS;QACpB,YAAY,CAAC,SAAS,CAAC;IACxB,MAAM,MAAM,GAAiD;QAC5D,4FAA4F;QAC5F,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,yBAAyB,CAAC;QAC3C,QAAQ,EAAE,QAAQ;QAClB,IAAI,EAAE,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,IAAI,SAAS,EAAE;QACpF,OAAO,EAAE,YAAY,CAAC,OAAO;QAC7B,MAAM,EAAE,YAAY,CAAC,MAAM;QAC3B,WAAW,EAAE,UAAU,CAAC,WAAW,IAAI,CAAC,OAAO,IAAI,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,IAAI,SAAS;KACtF,CAAC;IAEF,oGAAoG;IACpG,kGAAkG;IAClG,iEAAiE;IACjE,IAAI,OAAO,CAAC,MAAM,IAAI,IAAI,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;QAC5D,MAAM,iBAAiB,GAAG,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC/C,IAAI,oBAAoB,GAAG,MAAM,CAAC,WAAW,KAAK,IAAI,CAAC;QACvD,IAAI,kBAAkB,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC;QACxD,IAAI,QAAQ,GAAG,MAAM,CAAC;QAEtB,KAAK,IAAI,WAAW,GAAG,CAAC,EAAE,WAAW,IAAI,IAAI,EAAE,WAAW,EAAE,EAAE,CAAC;YAC9D,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC;gBAClD,OAAO;oBACN,KAAK,EAAE,EAAE;oBACT,QAAQ,EAAE,iBAAiB;oBAC3B,IAAI,EAAE;wBACL,WAAW,EAAE,IAAI;wBACjB,YAAY,EAAE,CAAC;wBACf,SAAS,EAAE,kBAAkB,IAAI,SAAS;qBAC1C;oBACD,OAAO,EAAE,KAAK;oBACd,WAAW,EAAE,oBAAoB,IAAI,SAAS;iBAC9C,CAAC;YACH,CAAC;YAED,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE;gBACtC,GAAG,OAAO;gBACV,IAAI,EAAE,WAAW;gBACjB,MAAM,EAAE,QAAQ,CAAC,MAAM;aACvB,CAAC,CAAC;YACH,KAAK,MAAM,gBAAgB,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;gBACnD,oBAAoB,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAAC;YAC3D,CAAC;YACD,oBAAoB,KAAK,SAAS,CAAC,WAAW,KAAK,IAAI,CAAC;YACxD,kBAAkB,KAAK,SAAS,CAAC,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC;YAEzD,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;gBAC1B,OAAO;oBACN,GAAG,SAAS;oBACZ,QAAQ,EAAE,iBAAiB;oBAC3B,IAAI,EAAE;wBACL,GAAG,SAAS,CAAC,IAAI;wBACjB,SAAS,EAAE,kBAAkB,IAAI,SAAS;qBAC1C;oBACD,WAAW,EAAE,oBAAoB,IAAI,SAAS;iBAC9C,CAAC;YACH,CAAC;YAED,QAAQ,GAAG,SAAS,CAAC;QACtB,CAAC;IACF,CAAC;IAED,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/plus/integrations/reads/hierarchy.utils.d.ts

@@ -0,0 +1,53 @@
+import type { ResourceDescriptor } from '../../../git/models/resourceDescriptor.js';
+import type { IntegrationIds } from '../constants.js';
+import type { ProviderOrganization } from '../results.js';
+/**
+ * Mapping of a provider's own hierarchy vocabulary onto the single {@link ProviderOrganization} shape the facade
+ * publishes.
+ *
+ * Providers disagree about what sits above a repo or an issue: git hosts have orgs (and Azure DevOps a project
+ * tier below that), while issue trackers have "resources" (Jira sites, Linear orgs, Trello workspaces) with
+ * projects beneath them. `listOrgs`/`listProjects` unify all of it, so these helpers exist to keep the
+ * per-provider shape-guessing — which field is the id, which is the display label, which resource is a
+ * project's parent — in one place instead of inline in those reads.
+ *
+ * Everything here reads through the base {@link ResourceDescriptor} (which only guarantees `key`) and casts to
+ * the concrete {@link IssueResourceDescriptor} for the optional `id`/`name`. That cast is why the fallbacks are
+ * spelled out rather than assumed.
+ */
+/** The label to show for a resource: its name, else its id, else the key that is always present. */
+export declare function resourceLabel(resource: ResourceDescriptor): string;
+/** Whether `org` addresses this resource by any of the identifiers a caller could reasonably have. */
+export declare function resourceMatchesOrg(resource: ResourceDescriptor, org: string): boolean;
+/**
+ * Maps an issue-tracker resource descriptor to the unified {@link ProviderOrganization} org shape. `url` is
+ * synthesized when the descriptor carries none, rather than widening the shared `ProviderOrganization.url` to
+ * optional for the one provider family that may omit it.
+ */
+export declare function resourceToOrg(providerId: IntegrationIds, resource: ResourceDescriptor, org?: string): ProviderOrganization;
+/**
+ * The resource a project belongs under, as a display label — the `org` of the project's unified org shape.
+ *
+ * A project doesn't reliably name its parent, so try each identifier it does carry against the resources that
+ * were read alongside it. When none matches but only ONE resource was in scope, that resource is the parent by
+ * construction. Trello is excluded: its boards have no enclosing resource to name.
+ */
+export declare function orgForProject(providerId: IntegrationIds, project: ResourceDescriptor, resources: ResourceDescriptor[]): string | undefined;
+/**
+ * Stamps the provider onto an org the provider's own client produced. A git host's client fills the rest of the
+ * shape but doesn't know which integration id it was reached through — and on a self-managed host the same
+ * client serves several — so the fan-out attributes it here.
+ */
+export declare function withProviderContext(providerId: IntegrationIds, item: ProviderOrganization): ProviderOrganization;
+/**
+ * Rejects a hierarchy read whose scoped selectors have no provider to apply to. `connectionId` and `domain`
+ * both select among the connections OF a provider, so either one without `providerId` is ambiguous rather than
+ * merely redundant — the fan-out would have to guess which provider the caller meant, and silently picking one
+ * would read that connection's data under another provider's name.
+ */
+export declare function assertHierarchyReadTarget(method: 'listOrgs' | 'listProjects', options: {
+    providerId?: IntegrationIds;
+    connectionId?: string;
+    domain?: string;
+} | undefined): void;
+//# sourceMappingURL=hierarchy.utils.d.ts.map

package/dist/plus/integrations/reads/hierarchy.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hierarchy.utils.d.ts","sourceRoot":"","sources":["../../../../src/plus/integrations/reads/hierarchy.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA2B,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAE7G,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAE1D;;;;;;;;;;;;;GAaG;AAEH,oGAAoG;AACpG,wBAAgB,aAAa,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,CAGlE;AAED,sGAAsG;AACtG,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAGrF;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC5B,UAAU,EAAE,cAAc,EAC1B,QAAQ,EAAE,kBAAkB,EAC5B,GAAG,CAAC,EAAE,MAAM,GACV,oBAAoB,CAStB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC5B,UAAU,EAAE,cAAc,EAC1B,OAAO,EAAE,kBAAkB,EAC3B,SAAS,EAAE,kBAAkB,EAAE,GAC7B,MAAM,GAAG,SAAS,CAcpB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,cAAc,EAAE,IAAI,EAAE,oBAAoB,GAAG,oBAAoB,CAMhH;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACxC,MAAM,EAAE,UAAU,GAAG,cAAc,EACnC,OAAO,EAAE;IAAE,UAAU,CAAC,EAAE,cAAc,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,GAC1F,IAAI,CAIN"}

package/dist/plus/integrations/reads/hierarchy.utils.js

@@ -0,0 +1,85 @@
+import { IssuesCloudHostIntegrationId } from '../constants.js';
+/**
+ * Mapping of a provider's own hierarchy vocabulary onto the single {@link ProviderOrganization} shape the facade
+ * publishes.
+ *
+ * Providers disagree about what sits above a repo or an issue: git hosts have orgs (and Azure DevOps a project
+ * tier below that), while issue trackers have "resources" (Jira sites, Linear orgs, Trello workspaces) with
+ * projects beneath them. `listOrgs`/`listProjects` unify all of it, so these helpers exist to keep the
+ * per-provider shape-guessing — which field is the id, which is the display label, which resource is a
+ * project's parent — in one place instead of inline in those reads.
+ *
+ * Everything here reads through the base {@link ResourceDescriptor} (which only guarantees `key`) and casts to
+ * the concrete {@link IssueResourceDescriptor} for the optional `id`/`name`. That cast is why the fallbacks are
+ * spelled out rather than assumed.
+ */
+/** The label to show for a resource: its name, else its id, else the key that is always present. */
+export function resourceLabel(resource) {
+    const typed = resource;
+    return typed.name ?? typed.id ?? resource.key;
+}
+/** Whether `org` addresses this resource by any of the identifiers a caller could reasonably have. */
+export function resourceMatchesOrg(resource, org) {
+    const typed = resource;
+    return resource.key === org || typed.id === org || typed.name === org;
+}
+/**
+ * Maps an issue-tracker resource descriptor to the unified {@link ProviderOrganization} org shape. `url` is
+ * synthesized when the descriptor carries none, rather than widening the shared `ProviderOrganization.url` to
+ * optional for the one provider family that may omit it.
+ */
+export function resourceToOrg(providerId, resource, org) {
+    const typed = resource;
+    return {
+        id: typed.id ?? resource.key,
+        providerId: providerId,
+        name: resourceLabel(resource),
+        ...(org != null ? { org: org } : {}),
+        url: typed.url ?? '',
+    };
+}
+/**
+ * The resource a project belongs under, as a display label — the `org` of the project's unified org shape.
+ *
+ * A project doesn't reliably name its parent, so try each identifier it does carry against the resources that
+ * were read alongside it. When none matches but only ONE resource was in scope, that resource is the parent by
+ * construction. Trello is excluded: its boards have no enclosing resource to name.
+ */
+export function orgForProject(providerId, project, resources) {
+    if (providerId === IssuesCloudHostIntegrationId.Trello)
+        return undefined;
+    const typedProject = project;
+    const parentMatch = [typedProject.resourceId, typedProject.id, project.key]
+        .filter((value) => value != null)
+        .map(candidate => resources.find(resource => resourceMatchesOrg(resource, candidate)))
+        .find((resource) => resource != null);
+    return parentMatch != null
+        ? resourceLabel(parentMatch)
+        : resources.length === 1
+            ? resourceLabel(resources[0])
+            : undefined;
+}
+/**
+ * Stamps the provider onto an org the provider's own client produced. A git host's client fills the rest of the
+ * shape but doesn't know which integration id it was reached through — and on a self-managed host the same
+ * client serves several — so the fan-out attributes it here.
+ */
+export function withProviderContext(providerId, item) {
+    return {
+        ...item,
+        providerId: providerId,
+        ...(item.org != null ? { org: item.org } : {}),
+    };
+}
+/**
+ * Rejects a hierarchy read whose scoped selectors have no provider to apply to. `connectionId` and `domain`
+ * both select among the connections OF a provider, so either one without `providerId` is ambiguous rather than
+ * merely redundant — the fan-out would have to guess which provider the caller meant, and silently picking one
+ * would read that connection's data under another provider's name.
+ */
+export function assertHierarchyReadTarget(method, options) {
+    if (options?.providerId == null && (options?.connectionId != null || options?.domain != null)) {
+        throw new TypeError(`'${method}' requires 'providerId' when 'connectionId' or 'domain' is supplied`);
+    }
+}
+//# sourceMappingURL=hierarchy.utils.js.map

package/dist/plus/integrations/reads/hierarchy.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hierarchy.utils.js","sourceRoot":"","sources":["../../../../src/plus/integrations/reads/hierarchy.utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAC;AAI/D;;;;;;;;;;;;;GAaG;AAEH,oGAAoG;AACpG,MAAM,UAAU,aAAa,CAAC,QAA4B;IACzD,MAAM,KAAK,GAAG,QAAmC,CAAC;IAClD,OAAO,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,EAAE,IAAI,QAAQ,CAAC,GAAG,CAAC;AAC/C,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,kBAAkB,CAAC,QAA4B,EAAE,GAAW;IAC3E,MAAM,KAAK,GAAG,QAAmC,CAAC;IAClD,OAAO,QAAQ,CAAC,GAAG,KAAK,GAAG,IAAI,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;AACvE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAC5B,UAA0B,EAC1B,QAA4B,EAC5B,GAAY;IAEZ,MAAM,KAAK,GAAG,QAAsD,CAAC;IACrE,OAAO;QACN,EAAE,EAAE,KAAK,CAAC,EAAE,IAAI,QAAQ,CAAC,GAAG;QAC5B,UAAU,EAAE,UAAU;QACtB,IAAI,EAAE,aAAa,CAAC,QAAQ,CAAC;QAC7B,GAAG,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpC,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,EAAE;KACpB,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAC5B,UAA0B,EAC1B,OAA2B,EAC3B,SAA+B;IAE/B,IAAI,UAAU,KAAK,4BAA4B,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAEzE,MAAM,YAAY,GAAG,OAA4D,CAAC;IAClF,MAAM,WAAW,GAAG,CAAC,YAAY,CAAC,UAAU,EAAE,YAAY,CAAC,EAAE,EAAE,OAAO,CAAC,GAAG,CAAC;SACzE,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,KAAK,IAAI,IAAI,CAAC;SACjD,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,kBAAkB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;SACrF,IAAI,CAAC,CAAC,QAAQ,EAAkC,EAAE,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC;IAEvE,OAAO,WAAW,IAAI,IAAI;QACzB,CAAC,CAAC,aAAa,CAAC,WAAW,CAAC;QAC5B,CAAC,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;YACvB,CAAC,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;YAC7B,CAAC,CAAC,SAAS,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAA0B,EAAE,IAA0B;IACzF,OAAO;QACN,GAAG,IAAI;QACP,UAAU,EAAE,UAAU;QACtB,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9C,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CACxC,MAAmC,EACnC,OAA4F;IAE5F,IAAI,OAAO,EAAE,UAAU,IAAI,IAAI,IAAI,CAAC,OAAO,EAAE,YAAY,IAAI,IAAI,IAAI,OAAO,EAAE,MAAM,IAAI,IAAI,CAAC,EAAE,CAAC;QAC/F,MAAM,IAAI,SAAS,CAAC,IAAI,MAAM,qEAAqE,CAAC,CAAC;IACtG,CAAC;AACF,CAAC"}

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

@@ -0,0 +1,19 @@
+import type { IssueShape } from '../../../git/models/issue.js';
+import { type IntegrationIds } from '../constants.js';
+import { IssueFilter } from '../providers/models.js';
+import type { ProviderPagedResult } from '../results.js';
+import type { ProviderReadContext } from './context.js';
+export declare function listIssueTrackerIssuesPage(ctx: ProviderReadContext, options: {
+    providerId: IntegrationIds;
+    org?: string;
+    project?: string;
+    filters?: IssueFilter[];
+    /** Broadens the read to every assignee. Scopes to user-assigned issues when omitted. */
+    includeAllAssignees?: boolean;
+    forceSync?: boolean;
+    page?: number;
+    cursor?: string;
+    itemsPerPage?: number;
+    connectionId?: string;
+}): Promise<ProviderPagedResult<IssueShape>>;
+//# sourceMappingURL=issueTracker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"issueTracker.d.ts","sourceRoot":"","sources":["../../../../src/plus/integrations/reads/issueTracker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAI/D,OAAO,EAA6B,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjF,OAAO,EAAE,WAAW,EAAqB,MAAM,wBAAwB,CAAC;AAExE,OAAO,KAAK,EAAE,mBAAmB,EAAmB,MAAM,eAAe,CAAC;AAE1E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAMxD,wBAAsB,0BAA0B,CAC/C,GAAG,EAAE,mBAAmB,EACxB,OAAO,EAAE;IACR,UAAU,EAAE,cAAc,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;IACxB,wFAAwF;IACxF,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB,GACC,OAAO,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC,CA+b1C"}