@plusplusoneplusplus/coc 1.0.0

package/dist/validation/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./schemas"), exports);
+//# sourceMappingURL=index.js.map

package/dist/validation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAA0B"}

package/dist/validation/schemas.d.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+export declare const nonEmptyString: z.ZodString;
+export declare const portNumber: z.ZodNumber;
+export declare const filePath: z.ZodString;
+export declare const absolutePath: z.ZodEffects<z.ZodString, string, string>;
+export declare function withDefaults<T extends z.ZodTypeAny>(schema: T, defaults: z.infer<T>): z.ZodDefault<T>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/validation/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/validation/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,cAAc,aAAyC,CAAC;AACrE,eAAO,MAAM,UAAU,aAAqC,CAAC;AAG7D,eAAO,MAAM,QAAQ,aAAoB,CAAC;AAC1C,eAAO,MAAM,YAAY,2CAGxB,CAAC;AAGF,wBAAgB,YAAY,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EACjD,MAAM,EAAE,CAAC,EACT,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GACnB,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAEjB"}

package/dist/validation/schemas.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.absolutePath = exports.filePath = exports.portNumber = exports.nonEmptyString = void 0;
+exports.withDefaults = withDefaults;
+const zod_1 = require("zod");
+// Base string schemas
+exports.nonEmptyString = zod_1.z.string().min(1, 'Must not be empty');
+exports.portNumber = zod_1.z.number().int().min(1).max(65535);
+// File path schemas
+exports.filePath = zod_1.z.string().min(1);
+exports.absolutePath = zod_1.z.string().refine((path) => path.startsWith('/') || /^[A-Za-z]:/.test(path), 'Must be an absolute path');
+// Helper: Create schema with optional defaults
+function withDefaults(schema, defaults) {
+    return schema.default(defaults);
+}
+//# sourceMappingURL=schemas.js.map

package/dist/validation/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/validation/schemas.ts"],"names":[],"mappings":";;;AAcA,oCAKC;AAnBD,6BAAwB;AAExB,sBAAsB;AACT,QAAA,cAAc,GAAG,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC;AACxD,QAAA,UAAU,GAAG,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAE7D,oBAAoB;AACP,QAAA,QAAQ,GAAG,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAC7B,QAAA,YAAY,GAAG,OAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAC3C,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EACzD,0BAA0B,CAC3B,CAAC;AAEF,+CAA+C;AAC/C,SAAgB,YAAY,CAC1B,MAAS,EACT,QAAoB;IAEpB,OAAO,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;AAClC,CAAC"}

package/node_modules/@plusplusoneplusplus/forge/dist/ado/ado-connection-factory.d.ts

@@ -0,0 +1,17 @@
+import type { AdoClientOptions, AdoConnectionResult } from './types';
+export declare class AdoConnectionFactory {
+    private constructor();
+    static getInstance(): AdoConnectionFactory;
+    static resetInstance(): void;
+    connect(options?: AdoClientOptions): Promise<AdoConnectionResult>;
+    /**
+     * Resolve a valid bearer token, using the on-disk cache when possible
+     * and falling back to `az account get-access-token` otherwise.
+     */
+    private resolveTokenCache;
+    /** Call az CLI to get a fresh token + account info and persist to cache. */
+    private fetchAndCacheToken;
+}
+export declare function getAdoConnectionFactory(): AdoConnectionFactory;
+export declare function resetAdoConnectionFactory(): void;
+//# sourceMappingURL=ado-connection-factory.d.ts.map

package/node_modules/@plusplusoneplusplus/forge/dist/ado/ado-connection-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ado-connection-factory.d.ts","sourceRoot":"","sources":["../../src/ado/ado-connection-factory.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAcrE,qBAAa,oBAAoB;IAC7B,OAAO;IAEP,MAAM,CAAC,WAAW,IAAI,oBAAoB;IAO1C,MAAM,CAAC,aAAa,IAAI,IAAI;IAItB,OAAO,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA+BvE;;;OAGG;YACW,iBAAiB;IAe/B,4EAA4E;YAC9D,kBAAkB;CAqDnC;AAED,wBAAgB,uBAAuB,IAAI,oBAAoB,CAE9D;AAED,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD"}

package/node_modules/@plusplusoneplusplus/forge/dist/ado/ado-connection-factory.js

@@ -0,0 +1,146 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdoConnectionFactory = void 0;
+exports.getAdoConnectionFactory = getAdoConnectionFactory;
+exports.resetAdoConnectionFactory = resetAdoConnectionFactory;
+const azdev = __importStar(require("azure-devops-node-api"));
+const logger_1 = require("../logger");
+const exec_utils_1 = require("../utils/exec-utils");
+const ado_session_cache_1 = require("./ado-session-cache");
+const ENV_ORG_URL = 'AZURE_DEVOPS_ORG_URL';
+/** Azure DevOps resource ID for OAuth token requests. */
+const ADO_RESOURCE_ID = '499b84ac-1321-427f-aa17-267ca6975798';
+let _instance = null;
+class AdoConnectionFactory {
+    constructor() { }
+    static getInstance() {
+        if (!_instance) {
+            _instance = new AdoConnectionFactory();
+        }
+        return _instance;
+    }
+    static resetInstance() {
+        _instance = null;
+    }
+    async connect(options) {
+        const logger = (0, logger_1.getLogger)();
+        const orgUrl = options?.orgUrl ?? process.env[ENV_ORG_URL];
+        if (!orgUrl) {
+            const msg = `${ENV_ORG_URL} is not set`;
+            logger.warn(logger_1.LogCategory.ADO, msg);
+            return { connected: false, error: msg };
+        }
+        const dataDir = options?.dataDir;
+        const cache = await this.resolveTokenCache(dataDir);
+        if (!cache.success) {
+            logger.warn(logger_1.LogCategory.ADO, cache.error);
+            return { connected: false, error: cache.error };
+        }
+        const authHandler = azdev.getBearerHandler(cache.token);
+        logger.info(logger_1.LogCategory.ADO, 'Using Azure CLI bearer token for authentication');
+        try {
+            const connection = new azdev.WebApi(orgUrl, authHandler);
+            logger.info(logger_1.LogCategory.ADO, `Connected to Azure DevOps at ${orgUrl}`);
+            return { connected: true, connection, account: cache.account };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            logger.error(logger_1.LogCategory.ADO, `Failed to create Azure DevOps connection: ${msg}`);
+            return { connected: false, error: msg };
+        }
+    }
+    /**
+     * Resolve a valid bearer token, using the on-disk cache when possible
+     * and falling back to `az account get-access-token` otherwise.
+     */
+    async resolveTokenCache(dataDir) {
+        const logger = (0, logger_1.getLogger)();
+        const cached = await (0, ado_session_cache_1.readAdoSessionCache)(dataDir);
+        if (cached && (0, ado_session_cache_1.isTokenValid)(cached)) {
+            logger.info(logger_1.LogCategory.ADO, 'Using cached ADO bearer token');
+            return { success: true, token: cached.token, account: cached.account };
+        }
+        return this.fetchAndCacheToken(dataDir);
+    }
+    /** Call az CLI to get a fresh token + account info and persist to cache. */
+    async fetchAndCacheToken(dataDir) {
+        const logger = (0, logger_1.getLogger)();
+        try {
+            // Fetch token + expiry in one call.
+            const { stdout: tokenJson } = await (0, exec_utils_1.execAsync)(`az account get-access-token --resource ${ADO_RESOURCE_ID} --query "{token:accessToken,expiresOn:expiresOn}" -o json`);
+            const tokenData = JSON.parse(tokenJson.trim());
+            if (!tokenData.token) {
+                return { success: false, error: 'Azure CLI returned an empty token' };
+            }
+            const expiresAt = new Date(tokenData.expiresOn).getTime();
+            // Fetch account info (best-effort).
+            let account = null;
+            try {
+                const { stdout: accountJson } = await (0, exec_utils_1.execAsync)(`az account show --query "{upn:user.name,displayName:user.name}" -o json`);
+                const accountData = JSON.parse(accountJson.trim());
+                account = { upn: accountData.upn, displayName: accountData.displayName, adoId: null };
+            }
+            catch (accountErr) {
+                const msg = accountErr instanceof Error ? accountErr.message : String(accountErr);
+                logger.warn(logger_1.LogCategory.ADO, `Failed to fetch account info from Azure CLI: ${msg}`);
+            }
+            const newCache = { token: tokenData.token, expiresAt, account };
+            try {
+                await (0, ado_session_cache_1.writeAdoSessionCache)(newCache, dataDir);
+            }
+            catch (writeErr) {
+                const msg = writeErr instanceof Error ? writeErr.message : String(writeErr);
+                logger.warn(logger_1.LogCategory.ADO, `Failed to write ADO session cache: ${msg}`);
+            }
+            return { success: true, token: tokenData.token, account };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return {
+                success: false,
+                error: `Failed to get token from Azure CLI: ${msg}. Run 'az login' to authenticate.`,
+            };
+        }
+    }
+}
+exports.AdoConnectionFactory = AdoConnectionFactory;
+function getAdoConnectionFactory() {
+    return AdoConnectionFactory.getInstance();
+}
+function resetAdoConnectionFactory() {
+    AdoConnectionFactory.resetInstance();
+}
+//# sourceMappingURL=ado-connection-factory.js.map

package/node_modules/@plusplusoneplusplus/forge/dist/ado/ado-connection-factory.js.map

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

package/node_modules/@plusplusoneplusplus/forge/dist/ado/ado-identity-resolver.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Lazy ADO identity GUID resolver.
+ *
+ * Resolves a user's ADO identity GUID (adoId) from their UPN via the
+ * Azure DevOps Identities API, then persists the result back to the
+ * session cache so future calls do not need to re-resolve.
+ *
+ * Best-effort: on any failure the function logs a warning and returns null.
+ * No VS Code dependencies — pure Node.js.
+ */
+import type { WebApi } from 'azure-devops-node-api';
+/**
+ * Call the ADO Identities API to resolve `upn` → identity GUID.
+ *
+ * @param connection - An authenticated `WebApi` instance.
+ * @param orgUrl     - Full org URL, e.g. `https://dev.azure.com/myorg`.
+ * @param upn        - User principal name (email address).
+ * @returns The identity GUID string, or `null` on failure.
+ */
+export declare function resolveAdoIdentity(connection: WebApi, orgUrl: string, upn: string): Promise<string | null>;
+/**
+ * Resolve the ADO identity GUID for the current cached account and persist
+ * `adoId` back to the session cache.
+ *
+ * No-op when the cache is missing, has no account, or already has an adoId.
+ *
+ * @returns The resolved GUID, or `null` when resolution was skipped or failed.
+ */
+export declare function resolveAndCacheAdoIdentity(connection: WebApi, orgUrl: string, dataDir?: string): Promise<string | null>;
+//# sourceMappingURL=ado-identity-resolver.d.ts.map

package/node_modules/@plusplusoneplusplus/forge/dist/ado/ado-identity-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ado-identity-resolver.d.ts","sourceRoot":"","sources":["../../src/ado/ado-identity-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAIpD;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACpC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA8BxB;AAED;;;;;;;GAOG;AACH,wBAAsB,0BAA0B,CAC5C,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAqBxB"}

package/node_modules/@plusplusoneplusplus/forge/dist/ado/ado-identity-resolver.js

@@ -0,0 +1,156 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveAdoIdentity = resolveAdoIdentity;
+exports.resolveAndCacheAdoIdentity = resolveAndCacheAdoIdentity;
+const logger_1 = require("../logger");
+const ado_session_cache_1 = require("./ado-session-cache");
+/**
+ * Call the ADO Identities API to resolve `upn` → identity GUID.
+ *
+ * @param connection - An authenticated `WebApi` instance.
+ * @param orgUrl     - Full org URL, e.g. `https://dev.azure.com/myorg`.
+ * @param upn        - User principal name (email address).
+ * @returns The identity GUID string, or `null` on failure.
+ */
+async function resolveAdoIdentity(connection, orgUrl, upn) {
+    const logger = (0, logger_1.getLogger)();
+    try {
+        const org = extractOrgName(orgUrl);
+        if (!org) {
+            logger.warn(logger_1.LogCategory.ADO, `resolveAdoIdentity: cannot parse org from "${orgUrl}"`);
+            return null;
+        }
+        // The Identities API lives under the VSSPS host.
+        const vsspsUrl = `https://vssps.dev.azure.com/${org}/_apis/identities?searchFilter=MailAddress&filterValue=${encodeURIComponent(upn)}&api-version=7.1`;
+        // Use the underlying rest client from the WebApi connection.
+        const client = await connection.rest;
+        // Fallback: use node-fetch / https if rest client unavailable.
+        const response = await fetchWithHandler(connection, vsspsUrl);
+        if (!response) {
+            logger.warn(logger_1.LogCategory.ADO, `resolveAdoIdentity: empty response for "${upn}"`);
+            return null;
+        }
+        const identities = response;
+        const id = identities?.value?.[0]?.id ?? null;
+        void client; // client resolved but we use fetchWithHandler
+        return id;
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        logger.warn(logger_1.LogCategory.ADO, `resolveAdoIdentity failed for "${upn}": ${msg}`);
+        return null;
+    }
+}
+/**
+ * Resolve the ADO identity GUID for the current cached account and persist
+ * `adoId` back to the session cache.
+ *
+ * No-op when the cache is missing, has no account, or already has an adoId.
+ *
+ * @returns The resolved GUID, or `null` when resolution was skipped or failed.
+ */
+async function resolveAndCacheAdoIdentity(connection, orgUrl, dataDir) {
+    const logger = (0, logger_1.getLogger)();
+    const cache = await (0, ado_session_cache_1.readAdoSessionCache)(dataDir);
+    if (!cache || !cache.account)
+        return null;
+    if (cache.account.adoId)
+        return cache.account.adoId;
+    const adoId = await resolveAdoIdentity(connection, orgUrl, cache.account.upn);
+    if (!adoId)
+        return null;
+    try {
+        await (0, ado_session_cache_1.writeAdoSessionCache)({ ...cache, account: { ...cache.account, adoId } }, dataDir);
+    }
+    catch (writeErr) {
+        const msg = writeErr instanceof Error ? writeErr.message : String(writeErr);
+        logger.warn(logger_1.LogCategory.ADO, `Failed to persist adoId to cache: ${msg}`);
+    }
+    return adoId;
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/** Extract the org name segment from a `https://dev.azure.com/<org>` URL. */
+function extractOrgName(orgUrl) {
+    try {
+        const url = new URL(orgUrl);
+        const segments = url.pathname.replace(/^\//, '').split('/').filter(Boolean);
+        return segments[0] ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Perform an authenticated GET using the WebApi's underlying credentials.
+ * Returns the parsed JSON body, or null on error.
+ */
+async function fetchWithHandler(connection, url) {
+    // WebApi exposes a `rest` property (VsoClient-wrapped RestClient) and a
+    // lower-level `http` client. We use the VsoClient's `_http` layer so we
+    // inherit the bearer token without re-implementing auth.
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const anyConn = connection;
+    const restClient = anyConn.rest ?? anyConn._client;
+    if (restClient && typeof restClient.get === 'function') {
+        const res = await restClient.get(url);
+        return res?.result ?? res;
+    }
+    // Final fallback: raw https.
+    return fetchViaHttps(url, connection);
+}
+async function fetchViaHttps(url, connection) {
+    const https = await Promise.resolve().then(() => __importStar(require('https')));
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const token = connection._authHandler?.token ?? '';
+    return new Promise((resolve, reject) => {
+        const req = https.get(url, { headers: { Authorization: `Bearer ${token}`, Accept: 'application/json' } }, (res) => {
+            let data = '';
+            res.on('data', (chunk) => (data += chunk));
+            res.on('end', () => {
+                try {
+                    resolve(JSON.parse(data));
+                }
+                catch {
+                    resolve(null);
+                }
+            });
+        });
+        req.on('error', reject);
+    });
+}
+//# sourceMappingURL=ado-identity-resolver.js.map

package/node_modules/@plusplusoneplusplus/forge/dist/ado/ado-identity-resolver.js.map

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

package/node_modules/@plusplusoneplusplus/forge/dist/ado/ado-pull-requests-adapter.d.ts

@@ -0,0 +1,22 @@
+import type { IPullRequestsService } from '../providers/interfaces';
+import type { CommentThread, CreatePullRequestInput, PullRequest, Reviewer, SearchCriteria, UpdatePullRequestInput } from '../providers/types';
+import type { AdoPullRequestsService } from './pull-requests-service';
+/**
+ * Adapter that wraps `AdoPullRequestsService` and implements the
+ * provider-agnostic `IPullRequestsService` interface.
+ */
+export declare class AdoPullRequestsAdapter implements IPullRequestsService {
+    private readonly service;
+    private readonly project?;
+    constructor(service: AdoPullRequestsService, project?: string | undefined);
+    listPullRequests(repositoryId: string, criteria?: SearchCriteria): Promise<PullRequest[]>;
+    getPullRequest(repositoryId: string, pullRequestId: number | string): Promise<PullRequest>;
+    createPullRequest(repositoryId: string, input: CreatePullRequestInput): Promise<PullRequest>;
+    updatePullRequest(repositoryId: string, pullRequestId: number | string, update: UpdatePullRequestInput): Promise<PullRequest>;
+    getThreads(repositoryId: string, pullRequestId: number | string): Promise<CommentThread[]>;
+    createThread(repositoryId: string, pullRequestId: number | string, body: string): Promise<CommentThread>;
+    getReviewers(repositoryId: string, pullRequestId: number | string): Promise<Reviewer[]>;
+    addReviewers(repositoryId: string, pullRequestId: number | string, reviewerIds: string[]): Promise<Reviewer[]>;
+    getDiff(repositoryId: string, pullRequestId: number | string): Promise<string>;
+}
+//# sourceMappingURL=ado-pull-requests-adapter.d.ts.map

package/node_modules/@plusplusoneplusplus/forge/dist/ado/ado-pull-requests-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ado-pull-requests-adapter.d.ts","sourceRoot":"","sources":["../../src/ado/ado-pull-requests-adapter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,KAAK,EAER,aAAa,EACb,sBAAsB,EAEtB,WAAW,EAEX,QAAQ,EAER,cAAc,EACd,sBAAsB,EACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAmGtE;;;GAGG;AACH,qBAAa,sBAAuB,YAAW,oBAAoB;IAE3D,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;gBADR,OAAO,EAAE,sBAAsB,EAC/B,OAAO,CAAC,EAAE,MAAM,YAAA;IAG/B,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAsBzF,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAQ1F,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,WAAW,CAAC;IAkB5F,iBAAiB,CACnB,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,GAAG,MAAM,EAC9B,MAAM,EAAE,sBAAsB,GAC/B,OAAO,CAAC,WAAW,CAAC;IAiBjB,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAQ1F,YAAY,CACd,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,GAAG,MAAM,EAC9B,IAAI,EAAE,MAAM,GACb,OAAO,CAAC,aAAa,CAAC;IAanB,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAQvF,YAAY,CACd,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,GAAG,MAAM,EAC9B,WAAW,EAAE,MAAM,EAAE,GACtB,OAAO,CAAC,QAAQ,EAAE,CAAC;IAahB,OAAO,CAAC,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAyDvF"}