@gitkraken/provider-apis 0.19.1 → 0.21.0

package/CHANGELOG.md

@@ -1,5 +1,67 @@
 # Changelog
 
+## 0.21.0
+
+### ⚠️ Breaking Changes
+
+Added new entity ID API for encoding/decoding entity IDs (previously known as unique IDs). This API replaces the `getPullRequestUniqueId` and `getIssueUniqueId` utility functions in older versions of this library.
+
+The `EntityIdentifier` type represents a particular pull request or issue for a particular provider. The information stored in this type is enough to query the provider's REST or GraphQL API to fetch additional information about the entity (i.e. title, description, assignees, etc) or mutate the entity. `EntityIdentifier` is designed to be 
+serialized so we can send it to our backend services, giving us a portable way to communicate about pull requests or issues.
+
+These are the new functions provided by the API:
+- `validate`: takes an `EntityIdentifier` as input and validates that it is correctly formed
+- `encode`: takes an `EntityIdentifier` as input and encodes it to an array of strings, which can be serialized and sent to our REST APIs
+- `decode`: takes an array string and decodes it to an `EntityIdentifier`
+
+Conversion guide:
+```ts
+const pullRequest: GitPullRequest = { /* ... pr from somewhere ... */ };
+const githubEnterpriseDomain: string | undefined = ...; // undefined if this PR exists on https://github.com
+
+// pre-v0.21.0 way to encode a unique ID (now called a V0 entity ID)
+Utils.github.getPullRequestUniqueId({
+  pullRequest.id,
+  githubEnterpriseDomain,
+});
+
+// v0.21.0 way to encode an entity ID
+encode({
+  provider: EntityIdentifierProviderType.Github,
+  entityType: EntityType.PullRequest,
+  version: EntityVersion.One,
+  domain: githubEnterpriseDomain ?? null,
+  resourceId: null,
+  accountOrOrgId: null,
+  organizationName: null,
+  projectId: null,
+  repoId: null,
+  entityId: pullRequest.id,
+});
+```
+
+## 0.20.0
+
+- added `getActionablePullRequests` utility function
+- `groupPullRequestsIntoBuckets` optionally takes a mapping of PRs to enriched items for "snoozed" and "pinned" bucketing
+
+- fixed error when normalizing empty review author object (GitHub)
+- fixed `getPullRequestsForRepos` hitting the GraphQL complexity limit (GitLab)
+
+### ⚠️ Breaking Changes
+
+- `getPullRequestsForRepos` no longer accepts `repoIds` as input (GitLab)
+- changed `pullRequests` argument type from `GitPullRequest[]` to `PullRequestWithUniqueID[]` (groupPullRequestsIntoBuckets)
+
+We re-organized provider-specific types into a new directory structure. The types that were moved will have broken imports, but they can be fixed by importing the type from "@gitkraken/provider-apis". Example
+```ts
+// provider-specific type import that is broken by v0.20.0
+import type { WorkItemState } from '@gitkraken/provider-apis/dist/providers/azureDevops/azureDevOpsTypes';
+
+// correct way to import this type in v0.20.0
+import type { WorkItemState } from '@gitkraken/provider-apis';
+```
+
 ## 0.19.1
 
 - added `getCurrentUser` (Bitbucket Server)

package/dist/defaults.d.ts

@@ -1,5 +1,5 @@
 import nodeFetch from 'node-fetch';
-import { Fetch } from './types';
+import { Fetch } from './types/exportedTypes/types';
 declare global {
     var fetch: Fetch | undefined;
 }

package/dist/fetchWrapper.d.ts

@@ -1,2 +1,2 @@
-import { Fetch, RequestFunction } from './types';
+import { Fetch, RequestFunction } from './types/exportedTypes/types';
 export declare const fetchWrapper: (fetch: Fetch) => RequestFunction;

package/dist/index.d.ts

@@ -4,17 +4,18 @@ import { BitbucketServer } from './providers/bitbucketServer/bitbucketServer';
 import { GitHub } from './providers/github/github';
 import { GitLab } from './providers/gitlab/gitlab';
 import { Jira } from './providers/jira/jira';
-import { JiraServer } from './providers/jiraServer/jiraServer';
+import { JiraServer } from './providers/jira/jiraServer';
 import { Trello } from './providers/trello/trello';
 import * as AzureDevopsUtils from './providerUtils/azureDevops';
 import * as BitbucketUtils from './providerUtils/bitbucket';
 import * as BitbucketServerUtils from './providerUtils/bitbucketServer';
+import * as EntityIdentifier from './providerUtils/entityIdentifiers/entityIdentifier';
 import * as GitProviderUtils from './providerUtils/gitProvider';
 import * as GitHubUtils from './providerUtils/github';
 import * as GitLabUtils from './providerUtils/gitlab';
 import * as JiraUtils from './providerUtils/jira';
 import * as TrelloUtils from './providerUtils/trello';
-import { Config } from './types';
+import { Config } from './types/exportedTypes/types';
 declare const makeProviderAPIs: (config?: Partial<Config>) => {
     azureDevOps: AzureDevOps;
     bitbucket: Bitbucket;
@@ -27,17 +28,15 @@ declare const makeProviderAPIs: (config?: Partial<Config>) => {
 };
 export default makeProviderAPIs;
 export { AzureDevOps, Bitbucket, BitbucketServer, GitHub, GitLab, Jira, JiraServer, Trello };
-export type * from './providers/azureDevops/azureDevOps';
-export type * from './providers/bitbucket/bitbucket';
-export type * from './providers/gitProvider';
-export type * from './providers/github/github';
-export type { FetchIssuesData, FetchPullRequestsData } from './providers/github/githubTypes';
-export type * from './providers/gitlab/gitlab';
-export type * from './providers/issueProvider';
-export type * from './providers/jira/jira';
-export type * from './providers/jiraServer/jiraServer';
-export type * from './providers/trello/trello';
-export type * from './types';
+export * from './types/exportedTypes/azureDevOps';
+export * from './types/exportedTypes/bitbucket';
+export * from './types/exportedTypes/gitProvider';
+export * from './types/exportedTypes/github';
+export * from './types/exportedTypes/gitlab';
+export * from './types/exportedTypes/issueProvider';
+export * from './types/exportedTypes/jira';
+export * from './types/exportedTypes/trello';
+export * from './types/exportedTypes/types';
 declare const Utils: {
     azureDevOps: typeof AzureDevopsUtils;
     bitbucket: typeof BitbucketUtils;
@@ -47,5 +46,6 @@ declare const Utils: {
     gitProvider: typeof GitProviderUtils;
     jira: typeof JiraUtils;
     trello: typeof TrelloUtils;
+    entityIdentifier: typeof EntityIdentifier;
 };
-export { AzureDevopsUtils, BitbucketServerUtils, BitbucketUtils, GitHubUtils, GitLabUtils, GitProviderUtils, JiraUtils, TrelloUtils, Utils, };
+export { AzureDevopsUtils, BitbucketServerUtils, BitbucketUtils, EntityIdentifier, GitHubUtils, GitLabUtils, GitProviderUtils, JiraUtils, TrelloUtils, Utils, };