@resolution/atlassian-api-common 0.1.0

package/LICENSE.md

@@ -0,0 +1,19 @@
+Copyright (c) 2024 resolution Reichert Network Solutions GmbH
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -0,0 +1,5 @@
+# atlassian-api-common
+
+This package contains common code for Atlassian OpenAPI-based clients.
+
+It is not intended to be used directly, but rather as a dependency of other Atlassian OpenAPI-based clients.

package/lib/ApiError.d.ts

@@ -0,0 +1,13 @@
+import type { CommonHttpClientFetchRequest, CommonHttpClientFetchResponse, CommonHttpClientOptions } from "api-typescript-generator/openapi-client";
+/**
+ * API Error for all API-Client libraries.
+ *
+ * Stored in common package in order to have the same class pointer for all the packages.
+ */
+export declare class ApiError extends Error {
+    readonly url: URL;
+    readonly request: CommonHttpClientFetchRequest | undefined;
+    readonly response: CommonHttpClientFetchResponse | undefined;
+    readonly options: CommonHttpClientOptions | undefined;
+    constructor(url: URL, request: CommonHttpClientFetchRequest | undefined, response: CommonHttpClientFetchResponse | undefined, options: CommonHttpClientOptions | undefined, message: string);
+}

package/lib/ApiError.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApiError = void 0;
+/**
+ * API Error for all API-Client libraries.
+ *
+ * Stored in common package in order to have the same class pointer for all the packages.
+ */
+class ApiError extends Error {
+    constructor(url, request, response, options, message) {
+        super(message);
+        this.name = "ApiError";
+        this.url = url;
+        this.request = request;
+        this.response = response;
+        this.options = options;
+    }
+}
+exports.ApiError = ApiError;
+//# sourceMappingURL=ApiError.js.map

package/lib/ApiError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApiError.js","sourceRoot":"","sources":["../src/ApiError.ts"],"names":[],"mappings":";;;AAMA;;;;GAIG;AACH,MAAa,QAAS,SAAQ,KAAK;IAKjC,YACE,GAAQ,EACR,OAAiD,EACjD,QAAmD,EACnD,OAA4C,EAC5C,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAnBD,4BAmBC"}

package/lib/fetch/common/index.d.ts

@@ -0,0 +1,2 @@
+export declare const contentTypeHeaderName = "content-type";
+export declare const isJsonMediaType: (mediaType: string) => boolean;

package/lib/fetch/common/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isJsonMediaType = exports.contentTypeHeaderName = void 0;
+exports.contentTypeHeaderName = "content-type";
+const isJsonMediaType = (mediaType) => Boolean(mediaType.match(/^application\/(\w+\+)?json/));
+exports.isJsonMediaType = isJsonMediaType;
+//# sourceMappingURL=index.js.map

package/lib/fetch/common/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/fetch/common/index.ts"],"names":[],"mappings":";;;AAAa,QAAA,qBAAqB,GAAG,cAAc,CAAC;AAE7C,MAAM,eAAe,GAAG,CAAC,SAAiB,EAAW,EAAE,CAC5D,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC,CAAC;AAD5C,QAAA,eAAe,mBAC6B"}

package/lib/fetch/createAceFetch.d.ts

@@ -0,0 +1,23 @@
+import type { CommonHttpClientFetchRequest, CommonHttpClientFetchResponse } from "api-typescript-generator/openapi-client";
+import type { AddOn } from "atlassian-connect-express";
+/**
+ * ACE-based API client options.
+ */
+export interface ApiClientAceOptions {
+    /**
+     * ACE instance.
+     */
+    ace: AddOn;
+    /**
+     * ACE client key.
+     */
+    clientKey: string;
+    /**
+     * ACE user account ID. If not provided, the request will be made on behalf of the add-on.
+     */
+    userAccountId?: string;
+}
+/**
+ * Creates a fetch function for ACE-based API client.
+ */
+export declare function createAceFetch({ ace, clientKey, userAccountId, }: ApiClientAceOptions): (url: URL, request: CommonHttpClientFetchRequest) => Promise<CommonHttpClientFetchResponse>;

package/lib/fetch/createAceFetch.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAceFetch = void 0;
+const common_1 = require("./common");
+/**
+ * Creates a fetch function for ACE-based API client.
+ */
+function createAceFetch({ ace, clientKey, userAccountId, }) {
+    let httpClient = ace.httpClient({ clientKey, userAccountId });
+    if (userAccountId) {
+        httpClient = httpClient.asUserByAccountId(userAccountId);
+    }
+    function toLowerCase(input) {
+        return input.toLowerCase();
+    }
+    function getJsonFromAceResponse(body) {
+        if (typeof body === "object" &&
+            body !== null &&
+            body.constructor !== undefined &&
+            body.constructor.name === "Buffer") {
+            const buffer = body;
+            const textDecoder = new TextDecoder();
+            const text = textDecoder.decode(buffer.subarray(buffer.byteOffset, buffer.byteOffset + buffer.byteLength));
+            try {
+                return JSON.parse(text);
+            }
+            catch (e) {
+                throw new Error(`Failed to parse JSON: ${e}, source: ${text}`);
+            }
+        }
+        return body;
+    }
+    function getBlob(buffer) {
+        return new Blob([
+            buffer.buffer.slice(buffer.byteOffset, buffer.byteOffset + buffer.byteLength),
+        ]);
+    }
+    return function aceFetch(url, request) {
+        const lowerMethodName = toLowerCase(request.method);
+        if (lowerMethodName === "connect" || lowerMethodName === "options") {
+            throw new Error(`${request.method} is not supported`);
+        }
+        const methodName = lowerMethodName === "delete" ? "del" : lowerMethodName;
+        return new Promise((resolve, reject) => {
+            const bodyOrFormData = {};
+            if (request.headers[common_1.contentTypeHeaderName] !== undefined &&
+                request.headers[common_1.contentTypeHeaderName].includes("multipart/form-data") === true) {
+                bodyOrFormData.multipartFormData = request.body;
+            }
+            else {
+                bodyOrFormData.body = request.body;
+            }
+            // eslint-disable-next-line @typescript-eslint/no-floating-promises
+            httpClient[methodName](Object.assign(Object.assign({ json: true, url: `${url.pathname}${url.search}`, headers: request.headers }, bodyOrFormData), { followRedirect: request.redirect === "follow", encoding: null }), (error, response, body) => {
+                if (error) {
+                    return reject(error);
+                }
+                resolve({
+                    url: response.request.uri.href,
+                    headers: response.headers,
+                    status: response.statusCode,
+                    statusText: response.statusMessage,
+                    customRequestProps: request.customRequestProps,
+                    ok: response.statusCode >= 200 && response.statusCode < 300,
+                    body: response.headers[common_1.contentTypeHeaderName] !== undefined &&
+                        (0, common_1.isJsonMediaType)(response.headers[common_1.contentTypeHeaderName])
+                        ? { type: "json", data: getJsonFromAceResponse(body) }
+                        : { type: "blob", data: getBlob(body) },
+                });
+            });
+        });
+    };
+}
+exports.createAceFetch = createAceFetch;
+//# sourceMappingURL=createAceFetch.js.map

package/lib/fetch/createAceFetch.js.map

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

package/lib/fetch/createApFetch.d.ts

@@ -0,0 +1,14 @@
+import type { CommonHttpClientFetchRequest, CommonHttpClientFetchResponse } from "api-typescript-generator/openapi-client";
+/**
+ * AP-based API client options.
+ */
+export interface ApiClientApOptions {
+    /**
+     * AP instance. Can be accessed via `window.AP`.
+     */
+    AP: typeof window.AP;
+}
+/**
+ * Creates a fetch function for AP-based API client.
+ */
+export declare function createApFetch({ AP }: ApiClientApOptions): (url: URL, request: CommonHttpClientFetchRequest) => Promise<CommonHttpClientFetchResponse>;

package/lib/fetch/createApFetch.js

@@ -0,0 +1,91 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createApFetch = void 0;
+const common_1 = require("./common");
+/**
+ * Creates a fetch function for AP-based API client.
+ */
+function createApFetch({ AP }) {
+    function extractHeaders(xhr) {
+        return Object.fromEntries(xhr
+            .getAllResponseHeaders()
+            .split("\r\n")
+            .map((s) => s.trim())
+            .map((s) => s.match(/^([^:]+):.*$/))
+            .filter((match) => Boolean(match))
+            .map((match) => match[1])
+            .map((headerName) => [
+            headerName.toLowerCase(),
+            xhr.getResponseHeader(headerName),
+        ])
+            .filter((headerEntry) => headerEntry[1] !== null));
+    }
+    function buildResponse({ xhr, body, request, }) {
+        const headers = extractHeaders(xhr);
+        return {
+            url: xhr.responseURL,
+            headers,
+            status: xhr.status,
+            statusText: xhr.statusText,
+            customRequestProps: request.customRequestProps,
+            ok: xhr.status >= 200 && xhr.status < 300,
+            body: headers[common_1.contentTypeHeaderName] !== undefined &&
+                (0, common_1.isJsonMediaType)(headers[common_1.contentTypeHeaderName])
+                ? { type: "json", data: JSON.parse(textDecoder.decode(body)) }
+                : { type: "blob", data: new Blob([body]) },
+        };
+    }
+    const textDecoder = new TextDecoder();
+    return function apFetch(url, request) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const { body, xhr } = yield AP.request({
+                    url: `${url.pathname}${url.search}`,
+                    type: request.method,
+                    contentType: request.headers[common_1.contentTypeHeaderName],
+                    data: request.body,
+                    headers: request.headers,
+                    cache: request.cache === "force-cache",
+                    binaryAttachment: true,
+                });
+                return buildResponse({ xhr, body, request });
+            }
+            catch (error) {
+                if (typeof error === "object" &&
+                    error &&
+                    "xhr" in error &&
+                    "err" in error) {
+                    // Apparently, that's how AP.request errors are thrown.
+                    // https://bitbucket.org/atlassian/atlassian-connect-js-extra/src/973398917b69f3e68686216f44bdfafd5043ae76/packages/atlassian-connect-js-request/src/plugin/index.js#lines-123
+                    // `err` is defined in multiple places with completely different types:
+                    // https://bitbucket.org/atlassian/atlassian-connect-js-extra/src/973398917b69f3e68686216f44bdfafd5043ae76/packages/atlassian-connect-js-request/src/host/index.js#lines-316
+                    // https://bitbucket.org/atlassian/atlassian-connect-js-extra/src/973398917b69f3e68686216f44bdfafd5043ae76/packages/atlassian-connect-js-request/src/host/index.js#lines-327
+                    // https://bitbucket.org/atlassian/atlassian-connect-js-extra/src/973398917b69f3e68686216f44bdfafd5043ae76/packages/atlassian-connect-js-request/src/host/index.js#lines-352
+                    const { xhr, err } = error;
+                    if (err instanceof Error) {
+                        throw err;
+                    }
+                    if (typeof err === "string") {
+                        throw new Error(err);
+                    }
+                    if (xhr.status === 0) {
+                        throw new Error(textDecoder.decode(err));
+                    }
+                    return buildResponse({ xhr, body: err, request });
+                }
+                throw error;
+            }
+        });
+    };
+}
+exports.createApFetch = createApFetch;
+//# sourceMappingURL=createApFetch.js.map

package/lib/fetch/createApFetch.js.map

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

package/lib/fetch/createForgeApiExternalFetch.d.ts

@@ -0,0 +1,16 @@
+import type { fetch as externalFetch } from "@forge/api";
+import type { CommonHttpClientFetchRequest, CommonHttpClientFetchResponse } from "api-typescript-generator/openapi-client";
+/**
+ * Options for creating a Forge API fetch function.
+ */
+export interface ApiClientForgeApiExternalOptions {
+    /**
+     * Fetch function from the browser or `@forge/api` package.
+     */
+    fetch: typeof externalFetch;
+    /**
+     * Base URL for the cloud website.
+     */
+    baseUrl: string;
+}
+export declare function createForgeApiExternalFetch({ fetch, }: ApiClientForgeApiExternalOptions): (url: URL, request: CommonHttpClientFetchRequest) => Promise<CommonHttpClientFetchResponse>;

package/lib/fetch/createForgeApiExternalFetch.js

@@ -0,0 +1,64 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createForgeApiExternalFetch = void 0;
+const common_1 = require("./common");
+function createForgeApiExternalFetch({ fetch, }) {
+    return function forgeBridgeFetch(url, request) {
+        var _a;
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestProps = __rest(request, []);
+            const requestInit = requestProps;
+            const response = yield fetch(url.toString(), Object.assign(Object.assign({}, requestInit), { headers: request.headers, 
+                // Body types should be compatible.
+                body: request.body }));
+            const body = (0, common_1.isJsonMediaType)((_a = response.headers.get(common_1.contentTypeHeaderName)) !== null && _a !== void 0 ? _a : "")
+                ? {
+                    type: "json",
+                    data: yield response.json(),
+                }
+                : {
+                    type: "blob",
+                    data: new Blob([yield response.arrayBuffer()]),
+                };
+            const headers = {};
+            response.headers.forEach((value, key) => {
+                headers[key] = value;
+            });
+            if (response.headers.has("set-cookie") === true &&
+                "getSetCookie" in response.headers) {
+                headers["set-cookie"] = response.headers.getSetCookie();
+            }
+            return {
+                status: response.status,
+                statusText: response.statusText,
+                body,
+                url: url.toString(),
+                headers,
+                ok: response.ok,
+                customRequestProps: request.customRequestProps,
+            };
+        });
+    };
+}
+exports.createForgeApiExternalFetch = createForgeApiExternalFetch;
+//# sourceMappingURL=createForgeApiExternalFetch.js.map

package/lib/fetch/createForgeApiExternalFetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createForgeApiExternalFetch.js","sourceRoot":"","sources":["../../src/fetch/createForgeApiExternalFetch.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAQA,qCAAkE;AAgBlE,SAAgB,2BAA2B,CAAC,EAC1C,KAAK,GAC4B;IACjC,OAAO,SAAe,gBAAgB,CACpC,GAAQ,EACR,OAAqC;;;YAErC,MAAW,YAAY,UAAK,OAAO,EAA7B,EAAmB,CAAU,CAAC;YACpC,MAAM,WAAW,GAAgB,YAAY,CAAC;YAC9C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,kCACtC,WAAW,KACd,OAAO,EAAE,OAAO,CAAC,OAAiC;gBAClD,mCAAmC;gBACnC,IAAI,EAAE,OAAO,CAAC,IAAa,IAC3B,CAAC;YACH,MAAM,IAAI,GAAsC,IAAA,wBAAe,EAC7D,MAAA,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,8BAAqB,CAAC,mCAAI,EAAE,CAClD;gBACC,CAAC,CAAC;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,MAAM,QAAQ,CAAC,IAAI,EAAE;iBAC5B;gBACH,CAAC,CAAC;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,IAAI,CAAC,CAAC,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;iBAC/C,CAAC;YACN,MAAM,OAAO,GAAoC,EAAE,CAAC;YACpD,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;gBACtC,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACvB,CAAC,CAAC,CAAC;YACH,IACE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,IAAI;gBAC3C,cAAc,IAAI,QAAQ,CAAC,OAAO,EAClC,CAAC;gBACD,OAAO,CAAC,YAAY,CAAC,GACnB,QAAQ,CAAC,OAGV,CAAC,YAAY,EAAE,CAAC;YACnB,CAAC;YACD,OAAO;gBACL,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;gBAC/B,IAAI;gBACJ,GAAG,EAAE,GAAG,CAAC,QAAQ,EAAE;gBACnB,OAAO;gBACP,EAAE,EAAE,QAAQ,CAAC,EAAE;gBACf,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;aAC/C,CAAC;;KACH,CAAC;AACJ,CAAC;AAlDD,kEAkDC"}

package/lib/fetch/createForgeApiFetch.d.ts

@@ -0,0 +1,19 @@
+import type * as ForgeApi from "@forge/api";
+import type { CommonHttpClientFetchRequest, CommonHttpClientFetchResponse } from "api-typescript-generator/openapi-client";
+/**
+ * Forge-based API client options.
+ */
+export interface ApiClientForgeApiOptions {
+    /**
+     * Forge API namespace. Can be imported using: import * as forgeApi from `@forge/api`;
+     */
+    forgeApi: typeof ForgeApi;
+    /**
+     * Whether to make requests as an app. If not provided, the request will be made on behalf of the user.
+     */
+    asApp?: boolean;
+}
+/**
+ * Creates a fetch function for Forge-based API client.
+ */
+export declare function createForgeApiFetch({ forgeApi, asApp, }: ApiClientForgeApiOptions): (url: URL, request: CommonHttpClientFetchRequest) => Promise<CommonHttpClientFetchResponse>;

package/lib/fetch/createForgeApiFetch.js

@@ -0,0 +1,54 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createForgeApiFetch = void 0;
+const common_1 = require("./common");
+/**
+ * Creates a fetch function for Forge-based API client.
+ */
+function createForgeApiFetch({ forgeApi, asApp, }) {
+    return function forgeApiFetch(url, request) {
+        var _a;
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield (asApp ? forgeApi.asApp() : forgeApi.asUser()).requestJira(forgeApi.assumeTrustedRoute(`${url.pathname}${url.search}`), Object.assign(Object.assign({}, request), { 
+                // Forge API package uses BodyInit from `node-fetch` package, which is a bit different to the native one.
+                body: request.body }));
+            const body = (0, common_1.isJsonMediaType)((_a = response.headers.get(common_1.contentTypeHeaderName)) !== null && _a !== void 0 ? _a : "")
+                ? {
+                    type: "json",
+                    data: yield response.json(),
+                }
+                : {
+                    type: "blob",
+                    data: new Blob([yield response.arrayBuffer()]),
+                };
+            const headers = {};
+            response.headers.forEach((value, key) => {
+                headers[key] = value;
+            });
+            if (response.headers.has("set-cookie") === true &&
+                "getSetCookie" in response.headers) {
+                headers["set-cookie"] = response.headers.getSetCookie();
+            }
+            return {
+                status: response.status,
+                statusText: response.statusText,
+                body,
+                url: url.toString(),
+                headers,
+                ok: response.ok,
+                customRequestProps: request.customRequestProps,
+            };
+        });
+    };
+}
+exports.createForgeApiFetch = createForgeApiFetch;
+//# sourceMappingURL=createForgeApiFetch.js.map

package/lib/fetch/createForgeApiFetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createForgeApiFetch.js","sourceRoot":"","sources":["../../src/fetch/createForgeApiFetch.ts"],"names":[],"mappings":";;;;;;;;;;;;AAQA,qCAAkE;AAgBlE;;GAEG;AACH,SAAgB,mBAAmB,CAAC,EAClC,QAAQ,EACR,KAAK,GACoB;IACzB,OAAO,SAAe,aAAa,CACjC,GAAQ,EACR,OAAqC;;;YAErC,MAAM,QAAQ,GAAG,MAAM,CACrB,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,CAC7C,CAAC,WAAW,CAAC,QAAQ,CAAC,kBAAkB,CAAC,GAAG,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,kCACpE,OAAO;gBACV,yGAAyG;gBACzG,IAAI,EAAE,OAAO,CAAC,IAAa,IAC3B,CAAC;YACH,MAAM,IAAI,GAAsC,IAAA,wBAAe,EAC7D,MAAA,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,8BAAqB,CAAC,mCAAI,EAAE,CAClD;gBACC,CAAC,CAAC;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,MAAM,QAAQ,CAAC,IAAI,EAAE;iBAC5B;gBACH,CAAC,CAAC;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,IAAI,CAAC,CAAC,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;iBAC/C,CAAC;YACN,MAAM,OAAO,GAAoC,EAAE,CAAC;YACpD,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;gBACtC,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACvB,CAAC,CAAC,CAAC;YACH,IACE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,IAAI;gBAC3C,cAAc,IAAI,QAAQ,CAAC,OAAO,EAClC,CAAC;gBACD,OAAO,CAAC,YAAY,CAAC,GACnB,QAAQ,CAAC,OAGV,CAAC,YAAY,EAAE,CAAC;YACnB,CAAC;YACD,OAAO;gBACL,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;gBAC/B,IAAI;gBACJ,GAAG,EAAE,GAAG,CAAC,QAAQ,EAAE;gBACnB,OAAO;gBACP,EAAE,EAAE,QAAQ,CAAC,EAAE;gBACf,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;aAC/C,CAAC;;KACH,CAAC;AACJ,CAAC;AAlDD,kDAkDC"}

package/lib/fetch/createForgeBridgeFetch.d.ts

@@ -0,0 +1,10 @@
+import type { requestConfluence, requestJira } from "@forge/bridge";
+import type { CommonHttpClientFetchRequest, CommonHttpClientFetchResponse } from "api-typescript-generator/openapi-client";
+export type JiraApiClientForgeBridgeOptions = {
+    requestJira: typeof requestJira;
+};
+export type ConfluenceApiClientForgeBridgeOptions = {
+    requestConfluence: typeof requestConfluence;
+};
+export declare const createJiraForgeBridgeFetch: ({ requestJira, }: JiraApiClientForgeBridgeOptions) => (url: URL, request: CommonHttpClientFetchRequest) => Promise<CommonHttpClientFetchResponse>;
+export declare const createConfluenceForgeBridgeFetch: ({ requestConfluence, }: ConfluenceApiClientForgeBridgeOptions) => (url: URL, request: CommonHttpClientFetchRequest) => Promise<CommonHttpClientFetchResponse>;

package/lib/fetch/createForgeBridgeFetch.js

@@ -0,0 +1,65 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createConfluenceForgeBridgeFetch = exports.createJiraForgeBridgeFetch = void 0;
+const index_1 = require("./common/index");
+const createJiraForgeBridgeFetch = ({ requestJira, }) => createForgeBridgeFetch({ bridgeRequest: requestJira });
+exports.createJiraForgeBridgeFetch = createJiraForgeBridgeFetch;
+const createConfluenceForgeBridgeFetch = ({ requestConfluence, }) => createForgeBridgeFetch({ bridgeRequest: requestConfluence });
+exports.createConfluenceForgeBridgeFetch = createConfluenceForgeBridgeFetch;
+function createForgeBridgeFetch({ bridgeRequest, }) {
+    return function forgeBridgeFetch(url, request) {
+        var _a;
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestProps = __rest(request, []);
+            const requestInit = requestProps;
+            const response = yield bridgeRequest(`${url.pathname}${url.search}`, requestInit);
+            const body = (0, index_1.isJsonMediaType)((_a = response.headers.get("content-type")) !== null && _a !== void 0 ? _a : "")
+                ? {
+                    type: "json",
+                    data: yield response.json(),
+                }
+                : {
+                    type: "blob",
+                    data: yield response.blob(),
+                };
+            const headers = {};
+            response.headers.forEach((value, key) => {
+                headers[key] = value;
+            });
+            if (response.headers.has("set-cookie") === true &&
+                "getSetCookie" in response.headers) {
+                headers["set-cookie"] = response.headers.getSetCookie();
+            }
+            return {
+                status: response.status,
+                statusText: response.statusText,
+                body,
+                url: response.url,
+                headers,
+                ok: response.ok,
+                customRequestProps: request.customRequestProps,
+            };
+        });
+    };
+}
+//# sourceMappingURL=createForgeBridgeFetch.js.map

package/lib/fetch/createForgeBridgeFetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createForgeBridgeFetch.js","sourceRoot":"","sources":["../../src/fetch/createForgeBridgeFetch.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAQA,0CAAiD;AAU1C,MAAM,0BAA0B,GAAG,CAAC,EACzC,WAAW,GACqB,EAAE,EAAE,CACpC,sBAAsB,CAAC,EAAE,aAAa,EAAE,WAAW,EAAE,CAAC,CAAC;AAH5C,QAAA,0BAA0B,8BAGkB;AAElD,MAAM,gCAAgC,GAAG,CAAC,EAC/C,iBAAiB,GACqB,EAAE,EAAE,CAC1C,sBAAsB,CAAC,EAAE,aAAa,EAAE,iBAAiB,EAAE,CAAC,CAAC;AAHlD,QAAA,gCAAgC,oCAGkB;AAQ/D,SAAS,sBAAsB,CAAC,EAC9B,aAAa,GACe;IAC5B,OAAO,SAAe,gBAAgB,CACpC,GAAQ,EACR,OAAqC;;;YAErC,MAAW,YAAY,UAAK,OAAO,EAA7B,EAAmB,CAAU,CAAC;YACpC,MAAM,WAAW,GAAgB,YAAY,CAAC;YAC9C,MAAM,QAAQ,GAAG,MAAM,aAAa,CAClC,GAAG,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,MAAM,EAAE,EAC9B,WAAW,CACZ,CAAC;YACF,MAAM,IAAI,GAAsC,IAAA,uBAAe,EAC7D,MAAA,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,mCAAI,EAAE,CAC3C;gBACC,CAAC,CAAC;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,MAAM,QAAQ,CAAC,IAAI,EAAE;iBAC5B;gBACH,CAAC,CAAC;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,MAAM,QAAQ,CAAC,IAAI,EAAE;iBAC5B,CAAC;YACN,MAAM,OAAO,GAAoC,EAAE,CAAC;YACpD,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;gBACtC,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACvB,CAAC,CAAC,CAAC;YACH,IACE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,IAAI;gBAC3C,cAAc,IAAI,QAAQ,CAAC,OAAO,EAClC,CAAC;gBACD,OAAO,CAAC,YAAY,CAAC,GACnB,QAAQ,CAAC,OAGV,CAAC,YAAY,EAAE,CAAC;YACnB,CAAC;YACD,OAAO;gBACL,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;gBAC/B,IAAI;gBACJ,GAAG,EAAE,QAAQ,CAAC,GAAG;gBACjB,OAAO;gBACP,EAAE,EAAE,QAAQ,CAAC,EAAE;gBACf,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;aAC/C,CAAC;;KACH,CAAC;AACJ,CAAC"}

package/lib/fetch/index.d.ts

@@ -0,0 +1,12 @@
+import type { CommonHttpClientOptions } from "api-typescript-generator/openapi-client";
+import { type ApiClientAceOptions } from "./createAceFetch";
+import { type ApiClientApOptions } from "./createApFetch";
+import { type ApiClientForgeApiExternalOptions } from "./createForgeApiExternalFetch";
+import { type ApiClientForgeApiOptions } from "./createForgeApiFetch";
+import { type ConfluenceApiClientForgeBridgeOptions, type JiraApiClientForgeBridgeOptions } from "./createForgeBridgeFetch";
+export type AllOpenApiClientOptions = ApiClientAceOptions | ApiClientApOptions | ApiClientForgeApiOptions | JiraApiClientForgeBridgeOptions | ConfluenceApiClientForgeBridgeOptions | ApiClientForgeApiExternalOptions;
+export declare function getApiClientOptions<TOptions extends AllOpenApiClientOptions>(options: TOptions): Partial<CommonHttpClientOptions>;
+type CommonApiClientOptions = ApiClientAceOptions | ApiClientApOptions | ApiClientForgeApiOptions | ApiClientForgeApiExternalOptions;
+export declare function createAsAppMethod<TClass extends new (options: CommonApiClientOptions) => unknown>(): () => InstanceType<TClass>;
+export declare function createAsUserMethod<TClass extends new (options: CommonApiClientOptions) => unknown>(): (userAccountId: string) => InstanceType<TClass>;
+export {};

package/lib/fetch/index.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAsUserMethod = exports.createAsAppMethod = exports.getApiClientOptions = void 0;
+const ApiError_1 = require("../ApiError");
+const createAceFetch_1 = require("./createAceFetch");
+const createApFetch_1 = require("./createApFetch");
+const createForgeApiExternalFetch_1 = require("./createForgeApiExternalFetch");
+const createForgeApiFetch_1 = require("./createForgeApiFetch");
+const createForgeBridgeFetch_1 = require("./createForgeBridgeFetch");
+/**
+ * Get fetch function by API client options.
+ * We have a huge number of fetch-functions here!
+ */
+function getFetchByOptions(options) {
+    if ("forgeApi" in options) {
+        return (0, createForgeApiFetch_1.createForgeApiFetch)(options);
+    }
+    else if ("ace" in options) {
+        return (0, createAceFetch_1.createAceFetch)(options);
+    }
+    else if ("AP" in options) {
+        return (0, createApFetch_1.createApFetch)(options);
+    }
+    else if ("requestJira" in options) {
+        return (0, createForgeBridgeFetch_1.createJiraForgeBridgeFetch)(options);
+    }
+    else if ("requestConfluence" in options) {
+        return (0, createForgeBridgeFetch_1.createConfluenceForgeBridgeFetch)(options);
+    }
+    else if ("fetch" in options) {
+        return (0, createForgeApiExternalFetch_1.createForgeApiExternalFetch)(options);
+    }
+    throw new Error("Unknown API Client options.");
+}
+/**
+ * Error format description: https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/#status-codes
+ */
+function formatHttpErrorMessage(response) {
+    let additionalDetails = "";
+    if (response.body.type === "json" &&
+        typeof response.body.data === "object" &&
+        response.body.data !== null) {
+        if ("errorMessages" in response.body.data &&
+            Array.isArray(response.body.data.errorMessages)) {
+            additionalDetails += ": " + response.body.data.errorMessages.join(",");
+        }
+        if ("errors" in response.body.data &&
+            typeof response.body.data.errors === "object" &&
+            response.body.data.errors !== null) {
+            additionalDetails +=
+                ": " +
+                    Object.entries(response.body.data.errors)
+                        .map(([key, value]) => `${key}: ${value}`)
+                        .join(",");
+        }
+    }
+    return `HTTP Error ${response.status} (${response.statusText})${additionalDetails}`;
+}
+function getApiClientOptions(options) {
+    return {
+        fetch: getFetchByOptions(options),
+        formatHttpErrorMessage,
+        errorClass: ApiError_1.ApiError,
+    };
+}
+exports.getApiClientOptions = getApiClientOptions;
+function createAsAppMethod() {
+    return function asAppMethod() {
+        if (!("forgeApi" in this.options) && !("ace" in this.options)) {
+            throw new Error("Cannot switch to asApp for non ForgeAPI/ACE-based JiraApiClient.");
+        }
+        return new this.constructor(Object.assign(Object.assign({}, this.options), { asApp: true, userAccountId: undefined }));
+    };
+}
+exports.createAsAppMethod = createAsAppMethod;
+function createAsUserMethod() {
+    return function asUserMethod(userAccountId) {
+        if (!("ace" in this.options) && !("forgeApi" in this.options)) {
+            throw new Error("Cannot switch to asApp for non ForgeAPI/ACE-based API Client.");
+        }
+        if ("ace" in this.options && !userAccountId) {
+            throw new Error("userAccountId is required for ACE-based JiraApiClient.");
+        }
+        return new this.constructor(Object.assign(Object.assign({}, this.options), { userAccountId, asApp: false }));
+    };
+}
+exports.createAsUserMethod = createAsUserMethod;
+//# sourceMappingURL=index.js.map

package/lib/fetch/index.js.map

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

package/lib/index.d.ts

@@ -0,0 +1,7 @@
+export { ApiError } from "./ApiError";
+export { createAsAppMethod, createAsUserMethod, getApiClientOptions, } from "./fetch";
+export { ApiClientAceOptions } from "./fetch/createAceFetch";
+export { ApiClientApOptions } from "./fetch/createApFetch";
+export { ApiClientForgeApiOptions } from "./fetch/createForgeApiFetch";
+export { ApiClientForgeApiExternalOptions } from "./fetch/createForgeApiExternalFetch";
+export { JiraApiClientForgeBridgeOptions, ConfluenceApiClientForgeBridgeOptions, } from "./fetch/createForgeBridgeFetch";

package/lib/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getApiClientOptions = exports.createAsUserMethod = exports.createAsAppMethod = exports.ApiError = void 0;
+var ApiError_1 = require("./ApiError");
+Object.defineProperty(exports, "ApiError", { enumerable: true, get: function () { return ApiError_1.ApiError; } });
+var fetch_1 = require("./fetch");
+Object.defineProperty(exports, "createAsAppMethod", { enumerable: true, get: function () { return fetch_1.createAsAppMethod; } });
+Object.defineProperty(exports, "createAsUserMethod", { enumerable: true, get: function () { return fetch_1.createAsUserMethod; } });
+Object.defineProperty(exports, "getApiClientOptions", { enumerable: true, get: function () { return fetch_1.getApiClientOptions; } });
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,uCAAsC;AAA7B,oGAAA,QAAQ,OAAA;AACjB,iCAIiB;AAHf,0GAAA,iBAAiB,OAAA;AACjB,2GAAA,kBAAkB,OAAA;AAClB,4GAAA,mBAAmB,OAAA"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@resolution/atlassian-api-common",
+  "version": "0.1.0",
+  "description": "Shared code across different implementations of Atlassian API Clients.",
+  "main": "lib/index.js",
+  "scripts": {
+    "lint": "yarn run -T eslint src config",
+    "build": "yarn run -T tsc -p tsconfig.build.json"
+  },
+  "files": [
+    "lib",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://bitbucket.org/resolutiongmbh/atlassian-api-clients.git"
+  },
+  "keywords": [
+    "atlassian",
+    "api",
+    "openapi",
+    "client"
+  ],
+  "author": "Marat Dulin (Resolution GmbH)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://bitbucket.org/resolutiongmbh/atlassian-api-clients/issues"
+  },
+  "homepage": "https://bitbucket.org/resolutiongmbh/atlassian-api-clients#readme",
+  "devDependencies": {
+    "@forge/api": "^3.6.0",
+    "@forge/bridge": "^3.4.0",
+    "@types/atlassian-connect-js": "^5.2.17",
+    "@types/request": "^2.48.12",
+    "atlassian-connect-express": "^10.0.2"
+  },
+  "peerDependencies": {
+    "zod": ">=3.23.8"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "gitHead": "3df939a1dcdef2794f26a40a676620ff452783de"
+}