azure-devops-extension-api 4.248.0 → 4.248.1

package/src/Graph/index.ts

@@ -1,2 +0,0 @@
-export * from "./Graph";
-export * from "./GraphClient";

package/src/Identities/Identities.ts

@@ -1,261 +0,0 @@
-/*
- * ---------------------------------------------------------
- * Copyright(C) Microsoft Corporation. All rights reserved.
- * ---------------------------------------------------------
- */
-
-/**
- * Container class for changed identities
- */
-export interface ChangedIdentities {
-    /**
-     * Changed Identities
-     */
-    identities: Identity[];
-    /**
-     * More data available, set to true if pagesize is specified.
-     */
-    moreData: boolean;
-    /**
-     * Last Identity SequenceId
-     */
-    sequenceContext: ChangedIdentitiesContext;
-}
-
-/**
- * Context class for changed identities
- */
-export interface ChangedIdentitiesContext {
-    /**
-     * Last Group SequenceId
-     */
-    groupSequenceId: number;
-    /**
-     * Last Identity SequenceId
-     */
-    identitySequenceId: number;
-    /**
-     * Last Group OrganizationIdentitySequenceId
-     */
-    organizationIdentitySequenceId: number;
-    /**
-     * Page size
-     */
-    pageSize: number;
-}
-
-export interface CreateScopeInfo {
-    adminGroupDescription: string;
-    adminGroupName: string;
-    creatorId: string;
-    parentScopeId: string;
-    scopeName: string;
-    scopeType: GroupScopeType;
-}
-
-export interface FrameworkIdentityInfo {
-    displayName: string;
-    identifier: string;
-    identityType: FrameworkIdentityType;
-    role: string;
-}
-
-export enum FrameworkIdentityType {
-    None = 0,
-    ServiceIdentity = 1,
-    AggregateIdentity = 2,
-    ImportedIdentity = 3
-}
-
-export interface GroupMembership {
-    active: boolean;
-    descriptor: IdentityDescriptor;
-    id: string;
-    queriedId: string;
-}
-
-export enum GroupScopeType {
-    Generic = 0,
-    ServiceHost = 1,
-    TeamProject = 2
-}
-
-export interface Identity extends IdentityBase {
-}
-
-/**
- * Base Identity class to allow "trimmed" identity class in the GetConnectionData API Makes sure that on-the-wire representations of the derived classes are compatible with each other (e.g. Server responds with PublicIdentity object while client deserializes it as Identity object) Derived classes should not have additional [DataMember] properties
- */
-export interface IdentityBase {
-    /**
-     * The custom display name for the identity (if any). Setting this property to an empty string will clear the existing custom display name. Setting this property to null will not affect the existing persisted value (since null values do not get sent over the wire or to the database)
-     */
-    customDisplayName: string;
-    descriptor: IdentityDescriptor;
-    /**
-     * Identity Identifier. Also called Storage Key, or VSID
-     */
-    id: string;
-    /**
-     * True if the identity has a membership in any Azure Devops group in the organization.
-     */
-    isActive: boolean;
-    /**
-     * True if the identity is a group.
-     */
-    isContainer: boolean;
-    masterId: string;
-    /**
-     * Id of the members of the identity (groups only).
-     */
-    memberIds: string[];
-    memberOf: IdentityDescriptor[];
-    members: IdentityDescriptor[];
-    metaTypeId: number;
-    properties: any;
-    /**
-     * The display name for the identity as specified by the source identity provider.
-     */
-    providerDisplayName: string;
-    resourceVersion: number;
-    socialDescriptor: string;
-    /**
-     * Subject descriptor of a Graph entity.
-     */
-    subjectDescriptor: string;
-    uniqueUserId: number;
-}
-
-export interface IdentityBatchInfo {
-    descriptors: IdentityDescriptor[];
-    identityIds: string[];
-    includeRestrictedVisibility: boolean;
-    propertyNames: string[];
-    queryMembership: QueryMembership;
-    socialDescriptors: string[];
-    subjectDescriptors: string[];
-}
-
-/**
- * An Identity descriptor is a wrapper for the identity type (Windows SID, Passport) along with a unique identifier such as the SID or PUID.
- */
-export interface IdentityDescriptor {
-    /**
-     * The unique identifier for this identity, not exceeding 256 chars, which will be persisted.
-     */
-    identifier: string;
-    /**
-     * Type of descriptor (for example, Windows, Passport, etc.).
-     */
-    identityType: string;
-}
-
-export interface IdentityRightsTransferData {
-    userPrincipalNameMappings: { [key: string] : string; };
-}
-
-export interface IdentityScope {
-    administrators: IdentityDescriptor;
-    id: string;
-    isActive: boolean;
-    isGlobal: boolean;
-    localScopeId: string;
-    name: string;
-    parentId: string;
-    scopeType: GroupScopeType;
-    securingHostId: string;
-    subjectDescriptor: string;
-}
-
-/**
- * Identity information.
- */
-export interface IdentitySelf {
-    /**
-     * The UserPrincipalName (UPN) of the account. This value comes from the source provider.
-     */
-    accountName: string;
-    /**
-     * The display name. For AAD accounts with multiple tenants this is the display name of the profile in the home tenant.
-     */
-    displayName: string;
-    /**
-     * This represents the name of the container of origin. For AAD accounts this is the tenantID of the home tenant. For MSA accounts this is the string "Windows Live ID".
-     */
-    domain: string;
-    /**
-     * This is the VSID of the home tenant profile. If the profile is signed into the home tenant or if the profile has no tenants then this Id is the same as the Id returned by the profile/profiles/me endpoint. Going forward it is recommended that you use the combined values of Origin, OriginId and Domain to uniquely identify a user rather than this Id.
-     */
-    id: string;
-    /**
-     * The type of source provider for the origin identifier. For MSA accounts this is "msa". For AAD accounts this is "aad".
-     */
-    origin: string;
-    /**
-     * The unique identifier from the system of origin. If there are multiple tenants this is the unique identifier of the account in the home tenant. (For MSA this is the PUID in hex notation, for AAD this is the object id.)
-     */
-    originId: string;
-    /**
-     * For AAD accounts this is all of the tenants that this account is a member of.
-     */
-    tenants: TenantInfo[];
-}
-
-export interface IdentitySnapshot {
-    groups: Identity[];
-    identityIds: string[];
-    memberships: GroupMembership[];
-    scopeId: string;
-    scopes: IdentityScope[];
-}
-
-export interface IdentityUpdateData {
-    id: string;
-    index: number;
-    updated: boolean;
-}
-
-export interface PagedIdentities {
-    continuationToken: string[];
-    identities: Identity[];
-}
-
-export enum QueryMembership {
-    /**
-     * Query will not return any membership data
-     */
-    None = 0,
-    /**
-     * Query will return only direct membership data
-     */
-    Direct = 1,
-    /**
-     * Query will return expanded membership data
-     */
-    Expanded = 2,
-    /**
-     * Query will return expanded up membership data (parents only)
-     */
-    ExpandedUp = 3,
-    /**
-     * Query will return expanded down membership data (children only)
-     */
-    ExpandedDown = 4
-}
-
-export enum ReadIdentitiesOptions {
-    None = 0,
-    FilterIllegalMemberships = 1
-}
-
-export interface SwapIdentityInfo {
-    id1: string;
-    id2: string;
-}
-
-export interface TenantInfo {
-    homeTenant: boolean;
-    tenantId: string;
-    tenantName: string;
-    verifiedDomains: string[];
-}

package/src/Identities/IdentityProvider.ts

@@ -1,90 +0,0 @@
-import {  getService } from "azure-devops-extension-sdk";
-import { IdentityServiceIds, IVssIdentityService, IIdentity, IdentitiesGetConnectionsResponseModel, IdentitiesSearchRequestModel } from "./IdentityService";
-
-export interface IPeoplePickerProvider {
-    /**
-     * Add identities to the MRU
-     * @returns A promise that returns true if successful false otherwise
-     */
-    addIdentitiesToMRU?: (identities: IIdentity[]) => Promise<boolean>;
-
-    /**
-     * Request Entity information given an entityId
-     */
-    getEntityFromUniqueAttribute: (entityId: string) => IIdentity | PromiseLike<IIdentity>;
-
-    /**
-     * If no input is in the search box when clicked, provide a set of identities to show (used for MRU)
-     */
-    onEmptyInputFocus?: () => IIdentity[] | PromiseLike<IIdentity[]> | null;
-
-    /**
-     * Given a list of currently selected items and a filter string, return a list of suggestions to put in the suggestion list
-     */
-    onFilterIdentities: (filter: string, selectedItems?: IIdentity[]) => IIdentity[] | PromiseLike<IIdentity[]> | null;
-
-    /**
-     * Request connection information about a given Entity.
-     */
-    onRequestConnectionInformation: (entity: IIdentity, getDirectReports?: boolean) => IdentitiesGetConnectionsResponseModel | PromiseLike<IdentitiesGetConnectionsResponseModel>;
-
-    /**
-     * Remove identities from the MRU
-     * @returns A promise that returns true if successful false otherwise
-     */
-    removeIdentitiesFromMRU?: (identities: IIdentity[]) => Promise<boolean>;
-}
-
-export class PeoplePickerProvider implements IPeoplePickerProvider {
-    private identityService: Promise<IVssIdentityService>;
-
-    constructor() {
-        this.identityService = getService<IVssIdentityService>(IdentityServiceIds.IdentityService);
-    }
-
-    public addIdentitiesToMRU = (identities: IIdentity[]): Promise<boolean> => {
-         return this.identityService.then(identityService => {return identityService.addMruIdentitiesAsync(identities);});
-    };
-
-    public getEntityFromUniqueAttribute = (entityId: string): IIdentity | PromiseLike<IIdentity> => {
-        return this.identityService.then(identityService => {return identityService
-            .searchIdentitiesAsync(entityId, ["user"], ["ims", "source"], "uid")
-            .then(x => x[0]);});
-    };
-
-    public onEmptyInputFocus = (): IIdentity[] | PromiseLike<IIdentity[]> => {
-        return this.identityService.then(identityService => {return identityService.getIdentityMruAsync().then(identities => {
-            return identities;
-        });;});
-    }
-
-    public onFilterIdentities = (filter: string, selectedItems?: IIdentity[]): Promise<IIdentity[]> | IIdentity[] => {
-        return this._onSearchPersona(filter, selectedItems ? selectedItems : []);
-    };
-
-    public onRequestConnectionInformation =  (
-        entity: IIdentity,
-        getDirectReports?: boolean
-    ): IdentitiesGetConnectionsResponseModel | PromiseLike<IdentitiesGetConnectionsResponseModel> => {
-        return this.identityService.then(identityService => {return identityService.getConnections(entity, getDirectReports);});
-    };
-
-    public removeIdentitiesFromMRU = (identities: IIdentity[]): Promise<boolean> => {
-        return this.identityService.then(identityService => {return identityService.removeMruIdentitiesAsync(identities);});
-    };
-
-    private _onSearchPersona = (searchText: string, items: IIdentity[]): Promise<IIdentity[]> => {
-        const searchRequest: IdentitiesSearchRequestModel = {  query: searchText };
-        return this.identityService.then(identityService => {return identityService
-            .searchIdentitiesAsync(
-                searchRequest.query,
-                searchRequest.identityTypes,
-                searchRequest.operationScopes,
-                searchRequest.queryTypeHint,
-                searchRequest.options
-            )
-            .then((identities: IIdentity[]) => {
-                return identities.filter(identity => !items.some(selectedIdentity => selectedIdentity.entityId === identity.entityId));
-            });});
-    };
-}

package/src/Identities/IdentityService.ts

@@ -1,89 +0,0 @@
-/**
- * Contribution ids of identity services which can be obtained from DevOps.getService
- */
-export const enum IdentityServiceIds {
-    /**
-     * Provides a way to search for identities.
-     */
-    IdentityService = "ms.vss-features.identity-service"
-}
-
-
-export interface IIdentity {
-    entityId: string;
-    entityType: string;
-    originDirectory: string;
-    originId: string;
-}
-
-export interface IdentitiesGetConnectionsResponseModel {
-    successors?: IIdentity[];
-    managers?: IIdentity[];
-    directReports?: IIdentity[];
-}
-
-export interface IdentitiesSearchRequestModel {
-    query: string;
-    identityTypes?: string[];
-    operationScopes?: string[];
-    queryTypeHint?: string;
-    pagingToken?: string;
-    properties?: string[];
-    filterByAncestorEntityIds?: string[];
-    filterByEntityIds?: string[];
-    options?: any;
-}
-
-
-export interface IVssIdentityService {
-    /**
-     * Get a list of the Most Recently Used (MRU) identities
-     *
-     * @returns list of the Most Recently Used (MRU) identities
-     */
-    getIdentityMruAsync(): Promise<IIdentity[]>;
-
-    /**
-     * Given a search request model, return a list of Entities. If the filterIdentity callback is added, additionally filter the values before returning
-     *
-     * @param query The query to search the identities type with.
-     * @param identityTypes The types of identities to search (default "user" and "group")
-     * @param operationScopes The scope you would like to search (default "ims", "source")
-     * @param queryTypeHint A hint of what property your query is trying to search
-     * @param filterIdentity A filter passed in to alter the results of the identities found
-     * @param options Additional options to pass into the search
-     * @returns The list of filtered identities from the search.
-     */
-    searchIdentitiesAsync(
-        query: string,
-        identityTypes?: string[],
-        operationScopes?: string[],
-        queryTypeHint?: string,
-        options?: any,
-        filterIdentity?: (returnedEntities: IIdentity[]) => IIdentity[]
-    ): Promise<IIdentity[]>;
-
-    /**
-     * Add a list of identities to the MRU
-     *
-     * @param identities list of IdentityRefs to add to the MRU
-     * @returns True if the item was added, false otherwise
-     */
-    addMruIdentitiesAsync(identities: IIdentity[]): Promise<boolean>;
-
-    /**
-     * Remove a list of identities from the MRU
-     *
-     * @param identities list of IdentityRefs to remove from the MRU
-     * @returns True if the item was removed, false otherwise
-     */
-    removeMruIdentitiesAsync(identity: IIdentity[]): Promise<boolean>;
-
-    /**
-     * Gets a list of connections for a given identity
-     *
-     * @param identity Entity to look up connections
-     * @returns Connections for the given identity
-     */
-    getConnections(identity: IIdentity, getDirectReports?: boolean): Promise<IdentitiesGetConnectionsResponseModel>;
-}

package/src/Identities/index.ts

@@ -1,3 +0,0 @@
-export * from "./Identities";
-export * from "./IdentityProvider";
-export * from "./IdentityService";

package/src/Locations/Locations.ts

@@ -1,165 +0,0 @@
-/*
- * ---------------------------------------------------------
- * Copyright(C) Microsoft Corporation. All rights reserved.
- * ---------------------------------------------------------
- */
-
-import * as Identities from "../Identities/Identities";
-import * as WebApi from "../WebApi/WebApi";
-
-export interface AccessMapping {
-    accessPoint: string;
-    displayName: string;
-    moniker: string;
-    /**
-     * The service which owns this access mapping e.g. TFS, ELS, etc.
-     */
-    serviceOwner: string;
-    /**
-     * Part of the access mapping which applies context after the access point of the server.
-     */
-    virtualDirectory: string;
-}
-
-/**
- * Data transfer class that holds information needed to set up a connection with a VSS server.
- */
-export interface ConnectionData {
-    /**
-     * The Id of the authenticated user who made this request. More information about the user can be obtained by passing this Id to the Identity service
-     */
-    authenticatedUser: Identities.Identity;
-    /**
-     * The Id of the authorized user who made this request. More information about the user can be obtained by passing this Id to the Identity service
-     */
-    authorizedUser: Identities.Identity;
-    /**
-     * The id for the server.
-     */
-    deploymentId: string;
-    /**
-     * The type for the server Hosted/OnPremises.
-     */
-    deploymentType: WebApi.DeploymentFlags;
-    /**
-     * The instance id for this host.
-     */
-    instanceId: string;
-    /**
-     * The last user access for this instance.  Null if not requested specifically.
-     */
-    lastUserAccess: Date;
-    /**
-     * Data that the location service holds.
-     */
-    locationServiceData: LocationServiceData;
-    /**
-     * The virtual directory of the host we are talking to.
-     */
-    webApplicationRelativeDirectory: string;
-}
-
-export enum InheritLevel {
-    None = 0,
-    Deployment = 1,
-    Account = 2,
-    Collection = 4,
-    All = 7
-}
-
-export interface LocationMapping {
-    accessMappingMoniker: string;
-    location: string;
-}
-
-/**
- * Data transfer class used to transfer data about the location service data over the web service.
- */
-export interface LocationServiceData {
-    /**
-     * Data about the access mappings contained by this location service.
-     */
-    accessMappings: AccessMapping[];
-    /**
-     * Data that the location service holds.
-     */
-    clientCacheFresh: boolean;
-    /**
-     * The time to live on the location service cache.
-     */
-    clientCacheTimeToLive: number;
-    /**
-     * The default access mapping moniker for the server.
-     */
-    defaultAccessMappingMoniker: string;
-    /**
-     * The obsolete id for the last change that took place on the server (use LastChangeId64).
-     */
-    lastChangeId: number;
-    /**
-     * The non-truncated 64-bit id for the last change that took place on the server.
-     */
-    lastChangeId64: number;
-    /**
-     * Data about the service definitions contained by this location service.
-     */
-    serviceDefinitions: ServiceDefinition[];
-    /**
-     * The identifier of the deployment which is hosting this location data (e.g. SPS, TFS, ELS, Napa, etc.)
-     */
-    serviceOwner: string;
-}
-
-export enum RelativeToSetting {
-    Context = 0,
-    WebApplication = 2,
-    FullyQualified = 3
-}
-
-export interface ResourceAreaInfo {
-    id: string;
-    locationUrl: string;
-    name: string;
-}
-
-export interface ServiceDefinition {
-    description: string;
-    displayName: string;
-    identifier: string;
-    inheritLevel: InheritLevel;
-    locationMappings: LocationMapping[];
-    /**
-     * Maximum api version that this resource supports (current server version for this resource). Copied from \<c\>ApiResourceLocation\</c\>.
-     */
-    maxVersion: string;
-    /**
-     * Minimum api version that this resource supports. Copied from \<c\>ApiResourceLocation\</c\>.
-     */
-    minVersion: string;
-    parentIdentifier: string;
-    parentServiceType: string;
-    properties: any;
-    relativePath: string;
-    relativeToSetting: RelativeToSetting;
-    /**
-     * The latest version of this resource location that is in "Release" (non-preview) mode. Copied from \<c\>ApiResourceLocation\</c\>.
-     */
-    releasedVersion: string;
-    /**
-     * The current resource version supported by this resource location. Copied from \<c\>ApiResourceLocation\</c\>.
-     */
-    resourceVersion: number;
-    /**
-     * The service which owns this definition e.g. TFS, ELS, etc.
-     */
-    serviceOwner: string;
-    serviceType: string;
-    status: ServiceStatus;
-    toolId: string;
-}
-
-export enum ServiceStatus {
-    Assigned = 0,
-    Active = 1,
-    Moving = 2
-}