@gitkraken/core-gitlens 0.3.1 → 0.4.100

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

@@ -0,0 +1,313 @@
+import { isIssueResourceDescriptor, isRepositoryDescriptor } from '../../../git/utils/resourceDescriptor.utils.js';
+import { Logger } from '../../../utils/logger.js';
+import { GitCloudHostIntegrationId, GitSelfManagedHostIntegrationId, IssuesCloudHostIntegrationId, } from '../constants.js';
+import { isCloudGitSelfManagedHostIntegrationId } from '../utils/integration.utils.js';
+import { isGitHubDotCom, isGitLabDotCom } from './models.js';
+// Local runtime copies of the `@gitkraken/provider-apis` entity-identifier string enums, duplicated for
+// the same CJS-from-ESM reason as the enums in `models.ts`. Exported so the enum-parity test can guard
+// them against upstream drift. `EntityVersion` is an intentional subset: the package only ever writes
+// version 1, so the parity test asserts each local entry matches the SDK rather than a full mirror.
+export const EntityIdentifierProviderType = {
+    Azure: 'azure',
+    AzureDevOpsServer: 'azureDevOpsServer',
+    Github: 'github',
+    GithubEnterprise: 'githubEnterprise',
+    Gitlab: 'gitlab',
+    GitlabSelfHosted: 'gitlabSelfHosted',
+    Bitbucket: 'bitbucket',
+    BitbucketServer: 'bitbucketServer',
+    Jira: 'jira',
+    JiraServer: 'jiraServer',
+    Linear: 'linear',
+    Trello: 'trello',
+};
+export const EntityType = {
+    PullRequest: 'pr',
+    Issue: 'issue',
+};
+export const EntityVersion = {
+    One: '1',
+};
+function isLaunchpadItem(item) {
+    return item.uuid !== undefined;
+}
+function isIssue(item) {
+    return item.type === 'issue';
+}
+export function getEntityIdentifierInput(entity) {
+    let entityType = EntityType.Issue;
+    if (entity.type === 'pullrequest') {
+        entityType = EntityType.PullRequest;
+    }
+    let provider = fromStringToEntityIdentifierProviderType(entity.provider.id);
+    let domain = null;
+    if (provider === EntityIdentifierProviderType.Github && !isGitHubDotCom(entity.provider.domain)) {
+        provider = EntityIdentifierProviderType.GithubEnterprise;
+        domain = entity.provider.domain ?? null;
+    }
+    if (provider === EntityIdentifierProviderType.Gitlab && !isGitLabDotCom(entity.provider.domain)) {
+        provider = EntityIdentifierProviderType.GitlabSelfHosted;
+        domain = entity.provider.domain ?? null;
+    }
+    if (provider === EntityIdentifierProviderType.AzureDevOpsServer) {
+        domain = entity.provider.domain ?? null;
+    }
+    let projectId = null;
+    let resourceId = null;
+    let accountOrOrgId = null;
+    let organizationName = null;
+    let repoId = null;
+    if (provider === EntityIdentifierProviderType.Jira) {
+        if (!isIssue(entity) || entity.project == null) {
+            throw new Error('Jira issues must have a project');
+        }
+        projectId = entity.project.id;
+        resourceId = entity.project.resourceId;
+    }
+    else if (provider === EntityIdentifierProviderType.Azure ||
+        provider === EntityIdentifierProviderType.AzureDevOpsServer) {
+        const project = isLaunchpadItem(entity) ? entity.underlyingPullRequest?.project : entity.project;
+        if (project == null) {
+            throw new Error('Azure issues and PRs must have a project to be encoded');
+        }
+        projectId = project.id;
+        organizationName = project.resourceName;
+        repoId = isLaunchpadItem(entity) ? entity.underlyingPullRequest?.repository?.id : entity.repository?.id;
+        if (entityType === EntityType.PullRequest && repoId == null) {
+            throw new Error('Azure PRs must have a repository ID to be encoded');
+        }
+    }
+    else if (provider === EntityIdentifierProviderType.Trello) {
+        if (!isIssue(entity) || entity.project == null) {
+            throw new Error('Trello issues must have a board project to be encoded');
+        }
+        projectId = entity.project.id;
+        // Trello currently exposes the board but not a separate workspace/org id here. Reuse the board id in
+        // both serialization slots so branch associations remain round-trippable until the upstream shape grows.
+        accountOrOrgId = entity.project.resourceId || entity.project.id;
+    }
+    else if (provider === EntityIdentifierProviderType.Bitbucket ||
+        provider === EntityIdentifierProviderType.BitbucketServer) {
+        repoId = isLaunchpadItem(entity) ? entity.underlyingPullRequest?.repository?.id : entity.repository?.id;
+    }
+    let entityId = isLaunchpadItem(entity) ? entity.graphQLId : entity.nodeId;
+    if (provider === EntityIdentifierProviderType.Azure ||
+        provider === EntityIdentifierProviderType.AzureDevOpsServer) {
+        entityId = (isLaunchpadItem(entity) ? entity.underlyingPullRequest?.id : entity.id);
+    }
+    // `AnyEntityIdentifierInput` includes the catch-all `EntityIdentifier`
+    // variant which requires all fields, while each provider-specific variant
+    // requires a different subset. The function builds a polymorphic value
+    // that's correct at runtime per `provider` but the literal can't be
+    // structurally narrowed to any single variant. The 2-step cast through
+    // `unknown` is the documented escape for this discriminated-union pattern.
+    return {
+        accountOrOrgId: accountOrOrgId,
+        organizationName: organizationName, // needed for Azure issues and PRs, once supported
+        projectId: projectId,
+        repoId: repoId ?? null, // needed for Azure and BitBucket PRs, once supported
+        resourceId: resourceId, // needed for Jira issues
+        provider: provider,
+        entityType: entityType,
+        version: EntityVersion.One,
+        domain: domain,
+        entityId: entityId,
+    };
+}
+export function getProviderIdFromEntityIdentifier(entityIdentifier) {
+    switch (entityIdentifier.provider) {
+        case EntityIdentifierProviderType.Github:
+            return GitCloudHostIntegrationId.GitHub;
+        case EntityIdentifierProviderType.GithubEnterprise:
+            return GitSelfManagedHostIntegrationId.CloudGitHubEnterprise;
+        case EntityIdentifierProviderType.Gitlab:
+            return GitCloudHostIntegrationId.GitLab;
+        case EntityIdentifierProviderType.GitlabSelfHosted:
+            return GitSelfManagedHostIntegrationId.CloudGitLabSelfHosted;
+        case EntityIdentifierProviderType.Jira:
+            return IssuesCloudHostIntegrationId.Jira;
+        case EntityIdentifierProviderType.Linear:
+            return IssuesCloudHostIntegrationId.Linear;
+        case EntityIdentifierProviderType.Trello:
+            return IssuesCloudHostIntegrationId.Trello;
+        case EntityIdentifierProviderType.Azure:
+            return GitCloudHostIntegrationId.AzureDevOps;
+        case EntityIdentifierProviderType.AzureDevOpsServer:
+            return GitSelfManagedHostIntegrationId.AzureDevOpsServer;
+        case EntityIdentifierProviderType.Bitbucket:
+            return GitCloudHostIntegrationId.Bitbucket;
+        case EntityIdentifierProviderType.BitbucketServer:
+            return isGitConfigEntityIdentifier(entityIdentifier) && entityIdentifier.metadata.isCloudEnterprise
+                ? GitSelfManagedHostIntegrationId.BitbucketServer
+                : undefined;
+        default:
+            return undefined;
+    }
+}
+function fromStringToEntityIdentifierProviderType(str) {
+    switch (str) {
+        case 'github':
+            return EntityIdentifierProviderType.Github;
+        case 'cloud-github-enterprise':
+            return EntityIdentifierProviderType.GithubEnterprise;
+        case 'cloud-gitlab-self-hosted':
+            return EntityIdentifierProviderType.GitlabSelfHosted;
+        case 'gitlab':
+            return EntityIdentifierProviderType.Gitlab;
+        case 'jira':
+            return EntityIdentifierProviderType.Jira;
+        case 'linear':
+            return EntityIdentifierProviderType.Linear;
+        case 'trello':
+            return EntityIdentifierProviderType.Trello;
+        case 'azure':
+        case 'azureDevOps':
+        case 'azure-devops':
+            return EntityIdentifierProviderType.Azure;
+        case GitSelfManagedHostIntegrationId.AzureDevOpsServer:
+            return EntityIdentifierProviderType.AzureDevOpsServer;
+        case 'bitbucket':
+            return EntityIdentifierProviderType.Bitbucket;
+        case 'bitbucket-server':
+            return EntityIdentifierProviderType.BitbucketServer;
+        default:
+            throw new Error(`Unknown provider type '${str}'`);
+    }
+}
+export function encodeIssueOrPullRequestForGitConfig(entity, owner) {
+    const encodedOwner = {
+        key: owner.key,
+        name: owner.name,
+        id: undefined,
+        owner: undefined,
+    };
+    if (isRepositoryDescriptor(owner)) {
+        encodedOwner.owner = owner.owner;
+    }
+    else if (isIssueResourceDescriptor(owner)) {
+        encodedOwner.id = owner.id;
+    }
+    else {
+        throw new Error('Invalid owner');
+    }
+    return {
+        ...getEntityIdentifierInput(entity),
+        metadata: {
+            id: entity.id,
+            owner: encodedOwner,
+            createdDate: new Date().toISOString(),
+            isCloudEnterprise: isCloudGitSelfManagedHostIntegrationId(entity.provider.id),
+        },
+    };
+}
+export function isGitConfigEntityIdentifier(entity) {
+    return (entity != null &&
+        typeof entity === 'object' &&
+        'provider' in entity &&
+        entity.provider != null &&
+        'entityType' in entity &&
+        entity.entityType != null &&
+        'version' in entity &&
+        entity.version != null &&
+        'entityId' in entity &&
+        entity.entityId != null &&
+        'metadata' in entity &&
+        entity.metadata != null &&
+        typeof entity.metadata === 'object' &&
+        'id' in entity.metadata &&
+        entity.metadata.id != null &&
+        'owner' in entity.metadata &&
+        entity.metadata.owner != null &&
+        'createdDate' in entity.metadata &&
+        entity.metadata.createdDate != null);
+}
+export function isGitConfigEntityIdentifiers(entities) {
+    return Array.isArray(entities) && entities.every(entity => isGitConfigEntityIdentifier(entity));
+}
+export function decodeEntityIdentifiersFromGitConfig(str) {
+    const decoded = JSON.parse(str);
+    if (!isGitConfigEntityIdentifiers(decoded)) {
+        debugger;
+        Logger.error('Invalid entity identifiers in git config');
+        return [];
+    }
+    for (const decodedEntity of decoded) {
+        if (decodedEntity.provider === EntityIdentifierProviderType.Jira &&
+            (decodedEntity.resourceId == null || decodedEntity.projectId == null)) {
+            debugger;
+            Logger.error('Invalid Jira issue in git config');
+        }
+    }
+    return decoded;
+}
+export async function getIssueFromGitConfigEntityIdentifier(resolveIntegration, identifier, options) {
+    if (identifier.entityType !== EntityType.Issue) {
+        return undefined;
+    }
+    // TODO: Centralize where we represent all supported providers for issues
+    if (identifier.provider !== EntityIdentifierProviderType.Jira &&
+        identifier.provider !== EntityIdentifierProviderType.Linear &&
+        identifier.provider !== EntityIdentifierProviderType.Github &&
+        identifier.provider !== EntityIdentifierProviderType.Gitlab &&
+        identifier.provider !== EntityIdentifierProviderType.GithubEnterprise &&
+        identifier.provider !== EntityIdentifierProviderType.GitlabSelfHosted &&
+        identifier.provider !== EntityIdentifierProviderType.Bitbucket &&
+        identifier.provider !== EntityIdentifierProviderType.BitbucketServer &&
+        identifier.provider !== EntityIdentifierProviderType.AzureDevOpsServer &&
+        identifier.provider !== EntityIdentifierProviderType.Azure &&
+        identifier.provider !== EntityIdentifierProviderType.Trello) {
+        return undefined;
+    }
+    const integrationId = getProviderIdFromEntityIdentifier(identifier);
+    if (integrationId == null) {
+        return undefined;
+    }
+    const integration = await resolveIntegration(integrationId);
+    const resource = {
+        id: identifier.metadata.owner.id,
+        key: identifier.metadata.owner.key,
+        owner: identifier.metadata.owner.owner,
+        name: identifier.metadata.owner.name,
+    };
+    const remoteLookupId = identifier.provider === EntityIdentifierProviderType.Trello ? identifier.entityId : identifier.metadata.id;
+    // Cache-only read (no remote fetch). The package can't reach the host cache directly, so defer to the
+    // host-supplied reader; without one, honor the no-fetch contract by returning undefined. The cache key
+    // is resource+id (the integration only affects the etag), so peek even when the integration is
+    // unresolvable — a still-cached issue must survive an unconfigured/disconnected integration.
+    if (options?.cached) {
+        const cachedIssue = options.peekCachedIssue?.(integration, resource, identifier.metadata.id);
+        if (cachedIssue != null ||
+            (identifier.provider !== EntityIdentifierProviderType.Trello &&
+                identifier.provider !== EntityIdentifierProviderType.Linear)) {
+            return cachedIssue;
+        }
+        // Two id generations coexist for these providers: Trello identifiers persisted before the stable-id
+        // switch carry the board-local `idShort` in `metadata.id` while the cache is keyed by the stable card
+        // id (`entityId`); Linear identifiers persisted before `Issue.id` became the human identifier carry
+        // the UUID in `metadata.id` while fresh cache entries key by the identifier — and vice versa, the
+        // UUID always survives in `entityId` (via `nodeId`). Peeking both keys resolves either generation.
+        return options.peekCachedIssue?.(integration, resource, identifier.entityId);
+    }
+    if (integration == null) {
+        return undefined;
+    }
+    return integration.getIssue(resource, remoteLookupId);
+}
+export function getIssueOwner(issue) {
+    const isAzure = ['azure', GitCloudHostIntegrationId.AzureDevOps, 'azure-devops'].includes(issue.provider.id);
+    return issue.repository
+        ? {
+            key: `${issue.repository.owner}/${issue.repository.repo}`,
+            owner: issue.repository.owner,
+            name: issue.repository.repo,
+        }
+        : issue.project
+            ? {
+                key: isAzure ? issue.project.id : issue.project.resourceId,
+                id: isAzure ? issue.project.id : issue.project.resourceId,
+                owner: isAzure ? issue.project.resourceName : undefined,
+                name: isAzure ? issue.project.name : issue.project.resourceName,
+            }
+            : undefined;
+}
+//# sourceMappingURL=utils.js.map

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

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

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

@@ -0,0 +1,52 @@
+import type { ConfiguredIntegrationDescriptor } from '../authentication/models.js';
+import type { IntegrationIds } from '../constants.js';
+import type { Integration } from '../models/integration.js';
+import type { ProviderWarning } from '../results.js';
+/**
+ * Everything the facade's provider reads need from the service that owns connection state — and nothing else.
+ *
+ * The reads (`listOrgs`, `listRepos`, the paged PR/issue reads, the sweeps, `broadenIssues`,
+ * `resolveRepository`) are otherwise stateless: given a resolved integration they only transform provider
+ * results into the neutral shapes consumers get. What they can't do themselves is decide WHICH integration
+ * instance and which host a request addresses, because that depends on the configured connections, the
+ * per-domain instance cache, and the auth sessions the service holds.
+ *
+ * Naming that boundary explicitly is the point of this type. It keeps the reads out of connection lifecycle —
+ * they can't reach the instance cache, the connected-set, or the event emitters even by accident — and it makes
+ * the coupling auditable: anything a read needs beyond these five operations is a signal that either the read is
+ * doing connection management, or this contract genuinely has to grow.
+ */
+export interface ProviderReadContext {
+    /**
+     * The integration instance a read should use, or `undefined` when the requested target doesn't resolve.
+     * Absorbs the domain resolution below, so a read never picks a host itself.
+     */
+    getIntegrationForRead(id: IntegrationIds, connectionId: string | undefined, domain?: string): Promise<Integration | undefined>;
+    /**
+     * The host to ATTRIBUTE a read's results and warnings to, once the integration is resolved. Distinct from
+     * {@link resolveDomainForRead}, which selects the instance: this one falls back to the resolved
+     * integration's own domain, so a warning always names the host the read actually reached.
+     */
+    domainForRead(integration: Integration, id: IntegrationIds, connectionId: string | undefined, domain?: string): string | undefined;
+    /**
+     * The self-managed host a request SELECTS, from the configured connection or the caller's explicit domain.
+     * `undefined` for a cloud provider, which has only one host.
+     */
+    resolveDomainForRead(id: IntegrationIds, connectionId: string | undefined, domain: string | undefined): string | undefined;
+    /**
+     * Warnings for a read whose integration couldn't be resolved, distinguishing a broken explicit target
+     * (warning + `fetchFailed`) from a provider that simply isn't connected (silent empty).
+     */
+    earlyReturnConnectionWarnings(id: IntegrationIds, connectionId: string | undefined, domain?: string): {
+        warnings: ProviderWarning[];
+        fetchFailed: boolean;
+    };
+    /** Forces a session refresh before a read when the caller asked for one. Best-effort; never throws. */
+    forceRefreshIfRequested(integration: Integration, forceSync: boolean | undefined, connectionId: string | undefined): Promise<void>;
+    /** The configured connection descriptors, as `getConfigured` exposes them. */
+    getConfigured(id?: IntegrationIds, options?: {
+        cloud?: boolean;
+        domain?: string;
+    }): ConfiguredIntegrationDescriptor[];
+}
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../../src/plus/integrations/reads/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,6BAA6B,CAAC;AACnF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,mBAAmB;IACnC;;;OAGG;IACH,qBAAqB,CACpB,EAAE,EAAE,cAAc,EAClB,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,MAAM,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;IAEpC;;;;OAIG;IACH,aAAa,CACZ,WAAW,EAAE,WAAW,EACxB,EAAE,EAAE,cAAc,EAClB,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,MAAM,CAAC,EAAE,MAAM,GACb,MAAM,GAAG,SAAS,CAAC;IAEtB;;;OAGG;IACH,oBAAoB,CACnB,EAAE,EAAE,cAAc,EAClB,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,MAAM,EAAE,MAAM,GAAG,SAAS,GACxB,MAAM,GAAG,SAAS,CAAC;IAEtB;;;OAGG;IACH,6BAA6B,CAC5B,EAAE,EAAE,cAAc,EAClB,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,MAAM,CAAC,EAAE,MAAM,GACb;QAAE,QAAQ,EAAE,eAAe,EAAE,CAAC;QAAC,WAAW,EAAE,OAAO,CAAA;KAAE,CAAC;IAEzD,uGAAuG;IACvG,uBAAuB,CACtB,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,OAAO,GAAG,SAAS,EAC9B,YAAY,EAAE,MAAM,GAAG,SAAS,GAC9B,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB,8EAA8E;IAC9E,aAAa,CACZ,EAAE,CAAC,EAAE,cAAc,EACnB,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAC5C,+BAA+B,EAAE,CAAC;CACrC"}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=context.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../../src/plus/integrations/reads/context.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,66 @@
+import type { IntegrationIds } from '../constants.js';
+/**
+ * The COMPOSITE cursors, for the two reads a single provider cursor can't address.
+ *
+ * A plain paged read threads the provider's own opaque continuation. These two fan out instead — the
+ * issue-tracker read over a window of projects, the broaden read over a set of orgs — so one round produces
+ * several provider positions plus the bookkeeping needed to resume: which scopes failed and should be retried,
+ * and which are already drained and must NOT be re-read (a cursor-only provider handed a fresh page-1 request
+ * answers with its first page again, duplicating items).
+ *
+ * Both encodings are opaque to consumers and are parsed defensively: a cursor is caller-supplied data that may
+ * be stale, truncated, or from another read entirely, so anything unrecognized degrades to "no cursor" (which
+ * falls back to page paging) rather than throwing or being forwarded to a provider as a foreign string.
+ */
+export interface IssueTrackerPageCursor {
+    type: 'issue-tracker-page';
+    currentPage: number;
+    unpaged?: boolean;
+    nextPage?: number;
+    retryPages?: number[];
+    retryProjects?: string[];
+    completedProjects?: string[];
+}
+export declare function parseIssueTrackerPageCursor(cursor: string | undefined): IssueTrackerPageCursor | undefined;
+export declare function toIssueTrackerPageCursor(options: {
+    currentPage: number;
+    unpaged?: boolean;
+    nextPage?: number;
+    retryPages: readonly number[];
+    retryProjects: readonly string[];
+    completedProjects?: readonly string[];
+}): string | undefined;
+/** Identifies one org slice of the fan-out. Connection and domain are part of the key: two accounts, or two
+ * self-managed hosts, can each have an org of the same name. */
+export interface BroadenIssuesOrgKey {
+    providerId: IntegrationIds;
+    name: string;
+    connectionId?: string;
+    domain?: string;
+}
+/** One org's position in the bundle: either the provider's own cursor, or a page to retry after a failure. */
+export interface BroadenIssuesOrgCursor {
+    providerId: IntegrationIds;
+    org: string;
+    connectionId?: string;
+    domain?: string;
+    cursor?: string;
+    retryPage?: number;
+}
+export type BroadenIssuesExhaustedOrg = Omit<BroadenIssuesOrgCursor, 'cursor' | 'retryPage'>;
+/**
+ * The cursor to send for one org in this round: its entry in the bundle, or a synthesized page cursor.
+ *
+ * A single-org fan-out has no bundle to key into — its cursor IS the provider's, threaded straight through.
+ */
+export declare function getBroadenIssuesCursor(cursor: string | undefined, org: BroadenIssuesOrgKey, page: number, orgCount: number): string | undefined;
+/**
+ * Whether a prior round already drained this org (multi-org fan-out only). Once an org runs out of pages while
+ * another org keeps paging, the bundle records it as exhausted so the next round skips it instead of re-issuing
+ * a page-1 read — which cursor-only providers (having no page-number cursor to honor) would answer with their
+ * first page again, duplicating results.
+ */
+export declare function isBroadenIssuesOrgExhausted(cursor: string | undefined, org: BroadenIssuesOrgKey, orgCount: number): boolean;
+/** Encodes the round's per-org positions. A single-org fan-out emits that org's cursor directly, unwrapped. */
+export declare function toBroadenIssuesCursor(cursors: BroadenIssuesOrgCursor[], exhausted: BroadenIssuesExhaustedOrg[], orgCount: number): string | undefined;
+//# sourceMappingURL=cursors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cursors.d.ts","sourceRoot":"","sources":["../../../../src/plus/integrations/reads/cursors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAKtD;;;;;;;;;;;;GAYG;AAMH,MAAM,WAAW,sBAAsB;IACtC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAoBD,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,sBAAsB,GAAG,SAAS,CA+B1G;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC,GAAG,MAAM,GAAG,SAAS,CA8BrB;AAMD;gEACgE;AAChE,MAAM,WAAW,mBAAmB;IACnC,UAAU,EAAE,cAAc,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,8GAA8G;AAC9G,MAAM,WAAW,sBAAsB;IACtC,UAAU,EAAE,cAAc,CAAC;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAAC,sBAAsB,EAAE,QAAQ,GAAG,WAAW,CAAC,CAAC;AAe7F;;;;GAIG;AACH,wBAAgB,sBAAsB,CACrC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,GAAG,EAAE,mBAAmB,EACxB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACd,MAAM,GAAG,SAAS,CAepB;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAC1C,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,GAAG,EAAE,mBAAmB,EACxB,QAAQ,EAAE,MAAM,GACd,OAAO,CAST;AAED,+GAA+G;AAC/G,wBAAgB,qBAAqB,CACpC,OAAO,EAAE,sBAAsB,EAAE,EACjC,SAAS,EAAE,yBAAyB,EAAE,EACtC,QAAQ,EAAE,MAAM,GACd,MAAM,GAAG,SAAS,CASpB"}

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

@@ -0,0 +1,133 @@
+import { toPageCursor } from '../providers/utils/providerPaging.js';
+import { hostFromDomain } from '../utils/domain.utils.js';
+import { pageToCursor } from './paging.js';
+/** Positive safe integers only, deduped; `undefined` when nothing survives (so the field is omitted). */
+function positiveIntegers(values) {
+    if (!Array.isArray(values))
+        return undefined;
+    const valid = values.filter((value) => typeof value === 'number' && Number.isSafeInteger(value) && value > 0);
+    return valid.length > 0 ? [...new Set(valid)] : undefined;
+}
+/** Non-empty strings only, deduped; `undefined` when nothing survives (so the field is omitted). */
+function nonEmptyStrings(values) {
+    if (!Array.isArray(values))
+        return undefined;
+    const valid = values.filter((value) => typeof value === 'string' && value.length > 0);
+    return valid.length > 0 ? [...new Set(valid)] : undefined;
+}
+export function parseIssueTrackerPageCursor(cursor) {
+    if (cursor == null)
+        return undefined;
+    try {
+        const parsed = JSON.parse(cursor);
+        if (parsed.type !== 'issue-tracker-page' ||
+            typeof parsed.currentPage !== 'number' ||
+            !Number.isSafeInteger(parsed.currentPage) ||
+            parsed.currentPage < 1) {
+            return undefined;
+        }
+        const retryPages = positiveIntegers(parsed.retryPages);
+        const retryProjects = nonEmptyStrings(parsed.retryProjects);
+        const completedProjects = nonEmptyStrings(parsed.completedProjects);
+        return {
+            type: 'issue-tracker-page',
+            currentPage: parsed.currentPage,
+            ...(parsed.unpaged === true ? { unpaged: true } : {}),
+            ...(typeof parsed.nextPage === 'number' && Number.isSafeInteger(parsed.nextPage) && parsed.nextPage > 0
+                ? { nextPage: parsed.nextPage }
+                : {}),
+            ...(retryPages != null ? { retryPages: retryPages } : {}),
+            ...(retryProjects != null ? { retryProjects: retryProjects } : {}),
+            ...(completedProjects != null ? { completedProjects: completedProjects } : {}),
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+export function toIssueTrackerPageCursor(options) {
+    const retryPages = [...new Set(options.retryPages)].sort((a, b) => a - b);
+    const retryProjects = [...new Set(options.retryProjects)].sort();
+    const completedProjects = retryPages.length > 0 || retryProjects.length > 0 || options.nextPage != null
+        ? [...new Set(options.completedProjects ?? [])].sort()
+        : [];
+    if (retryPages.length === 0 && retryProjects.length === 0 && options.nextPage == null) {
+        return undefined;
+    }
+    // Nothing to carry beyond the next window: emit the plain page cursor instead of a composite one, so an
+    // ordinary forward read round-trips through the same encoding every other paged read uses.
+    if (retryPages.length === 0 &&
+        retryProjects.length === 0 &&
+        completedProjects.length === 0 &&
+        options.nextPage != null &&
+        options.unpaged !== true) {
+        return toPageCursor(options.nextPage);
+    }
+    return JSON.stringify({
+        type: 'issue-tracker-page',
+        currentPage: options.currentPage,
+        ...(options.unpaged === true ? { unpaged: true } : {}),
+        ...(options.nextPage != null ? { nextPage: options.nextPage } : {}),
+        ...(retryPages.length > 0 ? { retryPages: retryPages } : {}),
+        ...(retryProjects.length > 0 ? { retryProjects: retryProjects } : {}),
+        ...(completedProjects.length > 0 ? { completedProjects: completedProjects } : {}),
+    });
+}
+/** Whether a bundle entry addresses the same org slice as `org`, comparing domains by host. */
+function matchesOrg(entry, org) {
+    return (entry.providerId === org.providerId &&
+        entry.org === org.name &&
+        entry.connectionId === org.connectionId &&
+        (hostFromDomain(entry.domain) ?? entry.domain) === (hostFromDomain(org.domain) ?? org.domain));
+}
+/**
+ * The cursor to send for one org in this round: its entry in the bundle, or a synthesized page cursor.
+ *
+ * A single-org fan-out has no bundle to key into — its cursor IS the provider's, threaded straight through.
+ */
+export function getBroadenIssuesCursor(cursor, org, page, orgCount) {
+    if (orgCount === 1)
+        return cursor ?? pageToCursor(page);
+    if (cursor != null) {
+        try {
+            const parsed = JSON.parse(cursor);
+            const match = parsed.cursors?.find(c => matchesOrg(c, org));
+            if (match?.cursor != null)
+                return match.cursor;
+            if (typeof match?.retryPage === 'number' && Number.isSafeInteger(match.retryPage) && match.retryPage > 0) {
+                return toPageCursor(match.retryPage);
+            }
+        }
+        catch { }
+    }
+    return pageToCursor(page);
+}
+/**
+ * Whether a prior round already drained this org (multi-org fan-out only). Once an org runs out of pages while
+ * another org keeps paging, the bundle records it as exhausted so the next round skips it instead of re-issuing
+ * a page-1 read — which cursor-only providers (having no page-number cursor to honor) would answer with their
+ * first page again, duplicating results.
+ */
+export function isBroadenIssuesOrgExhausted(cursor, org, orgCount) {
+    if (orgCount === 1 || cursor == null)
+        return false;
+    try {
+        const parsed = JSON.parse(cursor);
+        return parsed.exhausted?.some(e => matchesOrg(e, org)) ?? false;
+    }
+    catch {
+        return false;
+    }
+}
+/** Encodes the round's per-org positions. A single-org fan-out emits that org's cursor directly, unwrapped. */
+export function toBroadenIssuesCursor(cursors, exhausted, orgCount) {
+    if (cursors.length === 0)
+        return undefined;
+    if (orgCount === 1) {
+        return cursors[0].cursor ?? (cursors[0].retryPage != null ? toPageCursor(cursors[0].retryPage) : undefined);
+    }
+    // Carry the exhausted orgs alongside the still-active cursors so the next round can skip them (see
+    // isBroadenIssuesOrgExhausted). Only meaningful while at least one org still has more to read.
+    return JSON.stringify({ cursors: cursors, exhausted: exhausted });
+}
+//# sourceMappingURL=cursors.js.map

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

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