@xurenxiang1219/pingcode-mcp 0.3.1

package/dist/pingcode/client.js

@@ -0,0 +1,300 @@
+import { randomUUID } from "node:crypto";
+import { metrics } from "../observability/metrics.js";
+import { PingCodeError } from "./errors.js";
+export class PingCodeClient {
+    apiBaseUrl;
+    tokenProvider;
+    timeoutMs;
+    maxResponseBytes;
+    logger;
+    fetchImpl;
+    maxRetries;
+    baseDelayMs;
+    maxDelayMs;
+    random;
+    now;
+    sleep;
+    constructor(apiBaseUrl, tokenProvider, timeoutMs, maxResponseBytes, logger, fetchImpl = fetch, retryOptions = {}) {
+        this.apiBaseUrl = apiBaseUrl;
+        this.tokenProvider = tokenProvider;
+        this.timeoutMs = timeoutMs;
+        this.maxResponseBytes = maxResponseBytes;
+        this.logger = logger;
+        this.fetchImpl = fetchImpl;
+        this.maxRetries = retryOptions.maxRetries ?? 2;
+        this.baseDelayMs = retryOptions.baseDelayMs ?? 250;
+        this.maxDelayMs = retryOptions.maxDelayMs ?? 2000;
+        this.random = retryOptions.random ?? Math.random;
+        this.now = retryOptions.now ?? Date.now;
+        this.sleep = retryOptions.sleep ?? delay;
+    }
+    async get(path, query = {}) {
+        return this.request("GET", path, query);
+    }
+    async post(path, body) {
+        return this.request("POST", path, {}, body);
+    }
+    async patch(path, body) {
+        return this.request("PATCH", path, {}, body);
+    }
+    async delete(path) {
+        return this.request("DELETE", path, {});
+    }
+    async request(method, path, query, body) {
+        if (!path.startsWith("/")) {
+            throw new PingCodeError("PingCode API 路徑必須以 '/' 開頭", "BAD_REQUEST");
+        }
+        const url = new URL(path, `${this.apiBaseUrl}/`);
+        for (const [key, value] of Object.entries(query)) {
+            if (value !== undefined) {
+                url.searchParams.set(key, String(value));
+            }
+        }
+        const requestId = randomUUID();
+        let lastError = null;
+        let tokenRefreshAttempted = false;
+        const maximumAttempts = method === "GET" ? this.maxRetries : 0;
+        for (let attempt = 0; attempt <= maximumAttempts; attempt += 1) {
+            const accessToken = await this.tokenProvider.getAccessToken();
+            let response;
+            const startedAt = this.now();
+            try {
+                response = await this.fetchImpl(url, {
+                    method,
+                    headers: {
+                        Accept: "application/json",
+                        Authorization: `Bearer ${accessToken}`,
+                        ...(body === undefined ? {} : { "Content-Type": "application/json" }),
+                        "User-Agent": "pingcode-mcp/0.1.0",
+                        "X-Request-ID": requestId,
+                    },
+                    ...(body === undefined ? {} : { body: JSON.stringify(body) }),
+                    signal: AbortSignal.timeout(this.timeoutMs),
+                });
+            }
+            catch (error) {
+                metrics.recordPingCodeRequest(undefined, this.now() - startedAt);
+                const timeout = isTimeoutError(error);
+                lastError =
+                    method === "GET"
+                        ? new PingCodeError(timeout ? "PingCode API 請求逾時" : "無法連線到 PingCode API", timeout ? "TIMEOUT" : "UPSTREAM_UNAVAILABLE", { retryable: true, requestId, cause: error })
+                        : new PingCodeError("PingCode 寫入請求結果不確定，為避免重複寫入不會自動重試", "WRITE_OUTCOME_UNKNOWN", { requestId, cause: error });
+                if (attempt < maximumAttempts) {
+                    await this.retry(requestId, path, attempt, lastError);
+                    continue;
+                }
+                throw lastError;
+            }
+            const durationMs = this.now() - startedAt;
+            metrics.recordPingCodeRequest(response.status, durationMs);
+            this.logger.debug("PingCode API 請求完成", {
+                requestId,
+                path,
+                status: response.status,
+                durationMs,
+            });
+            if (response.ok) {
+                return this.parseJsonResponse(response, requestId);
+            }
+            if (method === "GET" &&
+                response.status === 401 &&
+                !tokenRefreshAttempted &&
+                attempt < maximumAttempts) {
+                this.tokenProvider.invalidate();
+                tokenRefreshAttempted = true;
+                metrics.recordPingCodeRetry();
+                this.logger.warn("PingCode Access Token 失效，將刷新後重試", {
+                    requestId,
+                    path,
+                    attempt: attempt + 1,
+                });
+                continue;
+            }
+            const upstreamError = await readUpstreamError(response);
+            const mapped = method === "GET"
+                ? mapHttpError(response, requestId, this.now(), upstreamError)
+                : mapWriteHttpError(response, requestId, this.now(), upstreamError);
+            if (mapped.retryable && attempt < maximumAttempts) {
+                lastError = mapped;
+                await this.retry(requestId, path, attempt, mapped);
+                continue;
+            }
+            throw mapped;
+        }
+        throw lastError ?? new PingCodeError("PingCode API 請求失敗", "UPSTREAM_UNAVAILABLE", { requestId });
+    }
+    async retry(requestId, path, attempt, error) {
+        const delayMs = this.retryDelayMs(attempt, error.options.retryAfterSeconds);
+        metrics.recordPingCodeRetry();
+        this.logger.warn("PingCode API 暫時失敗，將進行有限重試", {
+            requestId,
+            path,
+            code: error.code,
+            status: error.options.status,
+            attempt: attempt + 1,
+            nextAttempt: attempt + 2,
+            delayMs,
+        });
+        await this.sleep(delayMs);
+    }
+    retryDelayMs(attempt, retryAfterSeconds) {
+        if (retryAfterSeconds !== undefined) {
+            return Math.min(retryAfterSeconds * 1000, this.maxDelayMs);
+        }
+        const exponential = Math.min(this.baseDelayMs * 2 ** attempt, this.maxDelayMs);
+        return Math.round(exponential * (0.5 + this.random() * 0.5));
+    }
+    async parseJsonResponse(response, requestId) {
+        const declaredLength = Number(response.headers.get("content-length"));
+        if (Number.isFinite(declaredLength) && declaredLength > this.maxResponseBytes) {
+            throw new PingCodeError("PingCode 響應超過設定的大小限制", "RESPONSE_TOO_LARGE", {
+                requestId,
+            });
+        }
+        const text = await response.text();
+        if (Buffer.byteLength(text, "utf8") > this.maxResponseBytes) {
+            throw new PingCodeError("PingCode 響應超過設定的大小限制", "RESPONSE_TOO_LARGE", {
+                requestId,
+            });
+        }
+        if (text.trim().length === 0) {
+            return null;
+        }
+        try {
+            return JSON.parse(text);
+        }
+        catch (error) {
+            throw new PingCodeError("PingCode 返回了無效的 JSON", "INVALID_RESPONSE", {
+                requestId,
+                cause: error,
+            });
+        }
+    }
+}
+function mapWriteHttpError(response, requestId, nowMs, upstreamError) {
+    if (response.status >= 500) {
+        return new PingCodeError("PingCode 寫入請求結果不確定，為避免重複寫入不會自動重試", "WRITE_OUTCOME_UNKNOWN", { status: response.status, requestId });
+    }
+    const mapped = mapHttpError(response, requestId, nowMs, upstreamError);
+    return new PingCodeError(mapped.message, mapped.code, {
+        ...mapped.options,
+        retryable: false,
+    });
+}
+function mapHttpError(response, requestId, nowMs, upstreamError) {
+    const retryAfterSeconds = parseRetryAfter(response.headers.get("retry-after"), nowMs);
+    if (response.status === 401) {
+        return new PingCodeError("PingCode 認證失敗", "AUTHENTICATION_FAILED", {
+            status: response.status,
+            requestId,
+        });
+    }
+    if (response.status === 403) {
+        return new PingCodeError("PingCode 應用無權存取此資源", "PERMISSION_DENIED", {
+            status: response.status,
+            requestId,
+        });
+    }
+    if (response.status === 404) {
+        return new PingCodeError("找不到請求的 PingCode 資源", "NOT_FOUND", {
+            status: response.status,
+            requestId,
+        });
+    }
+    if (response.status === 429) {
+        return new PingCodeError("PingCode API 請求頻率超過限制", "RATE_LIMITED", {
+            status: response.status,
+            requestId,
+            retryable: true,
+            ...(retryAfterSeconds === undefined ? {} : { retryAfterSeconds }),
+        });
+    }
+    if (response.status >= 500) {
+        return new PingCodeError("PingCode 服務暫時不可用", "UPSTREAM_UNAVAILABLE", {
+            status: response.status,
+            requestId,
+            retryable: true,
+        });
+    }
+    if (upstreamError?.includes("[100300]") && upstreamError.includes("不存在")) {
+        return new PingCodeError(`找不到请求的 PingCode 资源：${upstreamError}`, "NOT_FOUND", {
+            status: response.status,
+            requestId,
+        });
+    }
+    return new PingCodeError(upstreamError
+        ? `PingCode 拒绝了 API 请求：${upstreamError}`
+        : `PingCode 拒绝了 API 请求（HTTP ${response.status}），接口未返回具体字段说明`, "BAD_REQUEST", { status: response.status, requestId });
+}
+async function readUpstreamError(response) {
+    try {
+        const body = await response.clone().text();
+        if (body.trim().length === 0) {
+            return undefined;
+        }
+        let payload;
+        try {
+            payload = JSON.parse(body);
+        }
+        catch {
+            // Do not expose an arbitrary upstream response body to the Agent.
+            return undefined;
+        }
+        if (!payload || typeof payload !== "object") {
+            return undefined;
+        }
+        const record = payload;
+        const nested = record.error && typeof record.error === "object"
+            ? record.error
+            : undefined;
+        const code = [record.code, nested?.code].find((value) => typeof value === "string" && value.trim().length > 0);
+        const message = [record.message, record.detail, record.error, nested?.message, nested?.detail].find((value) => typeof value === "string" && value.trim().length > 0);
+        const errors = record.errors && typeof record.errors === "object"
+            ? record.errors
+            : nested?.errors && typeof nested.errors === "object"
+                ? nested.errors
+                : undefined;
+        const fieldErrors = errors
+            ? Object.entries(errors)
+                .flatMap(([field, value]) => {
+                const text = typeof value === "string"
+                    ? value
+                    : Array.isArray(value) && typeof value[0] === "string"
+                        ? value[0]
+                        : undefined;
+                return text ? [`${field}: ${text}`] : [];
+            })
+                .slice(0, 8)
+            : [];
+        const parts = [
+            code ? `[${code}]` : undefined,
+            message,
+            fieldErrors.length > 0 ? `字段问题：${fieldErrors.join("；")}` : undefined,
+        ].filter((value) => value !== undefined);
+        return parts.length > 0 ? parts.join(" ").replace(/[\r\n]+/g, " ").slice(0, 1000) : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function parseRetryAfter(value, nowMs) {
+    if (!value) {
+        return undefined;
+    }
+    const seconds = Number(value);
+    if (Number.isFinite(seconds) && seconds >= 0) {
+        return seconds;
+    }
+    const retryAtMs = Date.parse(value);
+    if (!Number.isFinite(retryAtMs)) {
+        return undefined;
+    }
+    return Math.max(0, Math.ceil((retryAtMs - nowMs) / 1000));
+}
+function isTimeoutError(error) {
+    return error instanceof Error && (error.name === "TimeoutError" || error.name === "AbortError");
+}
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=client.js.map

package/dist/pingcode/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/pingcode/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAuB5C,MAAM,OAAO,cAAc;IASN;IACA;IACA;IACA;IACA;IACA;IAbF,UAAU,CAAS;IACnB,WAAW,CAAS;IACpB,UAAU,CAAS;IACnB,MAAM,CAAe;IACrB,GAAG,CAAe;IAClB,KAAK,CAA0C;IAEhE,YACmB,UAAkB,EAClB,aAAkC,EAClC,SAAiB,EACjB,gBAAwB,EACxB,MAAc,EACd,YAAuB,KAAK,EAC7C,eAA2C,EAAE;QAN5B,eAAU,GAAV,UAAU,CAAQ;QAClB,kBAAa,GAAb,aAAa,CAAqB;QAClC,cAAS,GAAT,SAAS,CAAQ;QACjB,qBAAgB,GAAhB,gBAAgB,CAAQ;QACxB,WAAM,GAAN,MAAM,CAAQ;QACd,cAAS,GAAT,SAAS,CAAmB;QAG7C,IAAI,CAAC,UAAU,GAAG,YAAY,CAAC,UAAU,IAAI,CAAC,CAAC;QAC/C,IAAI,CAAC,WAAW,GAAG,YAAY,CAAC,WAAW,IAAI,GAAG,CAAC;QACnD,IAAI,CAAC,UAAU,GAAG,YAAY,CAAC,UAAU,IAAI,IAAI,CAAC;QAClD,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC;QACjD,IAAI,CAAC,GAAG,GAAG,YAAY,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;QACxC,IAAI,CAAC,KAAK,GAAG,YAAY,CAAC,KAAK,IAAI,KAAK,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,IAAY,EAAE,QAA+D,EAAE;QACvF,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,IAA6B;QACpD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAY,EAAE,IAA6B;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;IAC1C,CAAC;IAEO,KAAK,CAAC,OAAO,CACnB,MAA2C,EAC3C,IAAY,EACZ,KAA4D,EAC5D,IAA8B;QAE9B,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,aAAa,CAAC,2BAA2B,EAAE,aAAa,CAAC,CAAC;QACtE,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;QACjD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACjD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;QAED,MAAM,SAAS,GAAG,UAAU,EAAE,CAAC;QAC/B,IAAI,SAAS,GAAyB,IAAI,CAAC;QAC3C,IAAI,qBAAqB,GAAG,KAAK,CAAC;QAElC,MAAM,eAAe,GAAG,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/D,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,eAAe,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;YAC/D,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,cAAc,EAAE,CAAC;YAC9D,IAAI,QAAkB,CAAC;YACvB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAE7B,IAAI,CAAC;gBACH,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE;oBACnC,MAAM;oBACN,OAAO,EAAE;wBACP,MAAM,EAAE,kBAAkB;wBAC1B,aAAa,EAAE,UAAU,WAAW,EAAE;wBACtC,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC;wBACrE,YAAY,EAAE,oBAAoB;wBAClC,cAAc,EAAE,SAAS;qBAC1B;oBACD,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC7D,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;iBAC5C,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,qBAAqB,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,CAAC;gBACjE,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;gBACtC,SAAS;oBACP,MAAM,KAAK,KAAK;wBACd,CAAC,CAAC,IAAI,aAAa,CACf,OAAO,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,oBAAoB,EACpD,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,sBAAsB,EAC5C,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,CAC7C;wBACH,CAAC,CAAC,IAAI,aAAa,CACf,kCAAkC,EAClC,uBAAuB,EACvB,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,CAC5B,CAAC;gBACR,IAAI,OAAO,GAAG,eAAe,EAAE,CAAC;oBAC9B,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;oBACtD,SAAS;gBACX,CAAC;gBACD,MAAM,SAAS,CAAC;YAClB,CAAC;YAED,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YAC1C,OAAO,CAAC,qBAAqB,CAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;YAC3D,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,mBAAmB,EAAE;gBACrC,SAAS;gBACT,IAAI;gBACJ,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,UAAU;aACX,CAAC,CAAC;YAEH,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;gBAChB,OAAO,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YACrD,CAAC;YAED,IACE,MAAM,KAAK,KAAK;gBAChB,QAAQ,CAAC,MAAM,KAAK,GAAG;gBACvB,CAAC,qBAAqB;gBACtB,OAAO,GAAG,eAAe,EACzB,CAAC;gBACD,IAAI,CAAC,aAAa,CAAC,UAAU,EAAE,CAAC;gBAChC,qBAAqB,GAAG,IAAI,CAAC;gBAC7B,OAAO,CAAC,mBAAmB,EAAE,CAAC;gBAC9B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,iCAAiC,EAAE;oBAClD,SAAS;oBACT,IAAI;oBACJ,OAAO,EAAE,OAAO,GAAG,CAAC;iBACrB,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YAED,MAAM,aAAa,GAAG,MAAM,iBAAiB,CAAC,QAAQ,CAAC,CAAC;YACxD,MAAM,MAAM,GACV,MAAM,KAAK,KAAK;gBACd,CAAC,CAAC,YAAY,CAAC,QAAQ,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,aAAa,CAAC;gBAC9D,CAAC,CAAC,iBAAiB,CAAC,QAAQ,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,aAAa,CAAC,CAAC;YACxE,IAAI,MAAM,CAAC,SAAS,IAAI,OAAO,GAAG,eAAe,EAAE,CAAC;gBAClD,SAAS,GAAG,MAAM,CAAC;gBACnB,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;gBACnD,SAAS;YACX,CAAC;YAED,MAAM,MAAM,CAAC;QACf,CAAC;QAED,MAAM,SAAS,IAAI,IAAI,aAAa,CAAC,mBAAmB,EAAE,sBAAsB,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;IACnG,CAAC;IAEO,KAAK,CAAC,KAAK,CACjB,SAAiB,EACjB,IAAY,EACZ,OAAe,EACf,KAAoB;QAEpB,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;QAC5E,OAAO,CAAC,mBAAmB,EAAE,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,2BAA2B,EAAE;YAC5C,SAAS;YACT,IAAI;YACJ,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM;YAC5B,OAAO,EAAE,OAAO,GAAG,CAAC;YACpB,WAAW,EAAE,OAAO,GAAG,CAAC;YACxB,OAAO;SACR,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAEO,YAAY,CAAC,OAAe,EAAE,iBAA0B;QAC9D,IAAI,iBAAiB,KAAK,SAAS,EAAE,CAAC;YACpC,OAAO,IAAI,CAAC,GAAG,CAAC,iBAAiB,GAAG,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAC7D,CAAC;QACD,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,IAAI,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAC/E,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC;IAC/D,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAAC,QAAkB,EAAE,SAAiB;QACnE,MAAM,cAAc,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC;QACtE,IAAI,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,cAAc,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC9E,MAAM,IAAI,aAAa,CAAC,sBAAsB,EAAE,oBAAoB,EAAE;gBACpE,SAAS;aACV,CAAC,CAAC;QACL,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC5D,MAAM,IAAI,aAAa,CAAC,sBAAsB,EAAE,oBAAoB,EAAE;gBACpE,SAAS;aACV,CAAC,CAAC;QACL,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC;QACrC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,aAAa,CAAC,sBAAsB,EAAE,kBAAkB,EAAE;gBAClE,SAAS;gBACT,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF;AAED,SAAS,iBAAiB,CACxB,QAAkB,EAClB,SAAiB,EACjB,KAAa,EACb,aAAsB;IAEtB,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;QAC3B,OAAO,IAAI,aAAa,CACtB,kCAAkC,EAClC,uBAAuB,EACvB,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,CACvC,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC;IACvE,OAAO,IAAI,aAAa,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE;QACpD,GAAG,MAAM,CAAC,OAAO;QACjB,SAAS,EAAE,KAAK;KACjB,CAAC,CAAC;AACL,CAAC;AAED,SAAS,YAAY,CACnB,QAAkB,EAClB,SAAiB,EACjB,KAAa,EACb,aAAsB;IAEtB,MAAM,iBAAiB,GAAG,eAAe,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,KAAK,CAAC,CAAC;IAEtF,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QAC5B,OAAO,IAAI,aAAa,CAAC,eAAe,EAAE,uBAAuB,EAAE;YACjE,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,SAAS;SACV,CAAC,CAAC;IACL,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QAC5B,OAAO,IAAI,aAAa,CAAC,oBAAoB,EAAE,mBAAmB,EAAE;YAClE,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,SAAS;SACV,CAAC,CAAC;IACL,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QAC5B,OAAO,IAAI,aAAa,CAAC,oBAAoB,EAAE,WAAW,EAAE;YAC1D,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,SAAS;SACV,CAAC,CAAC;IACL,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QAC5B,OAAO,IAAI,aAAa,CAAC,uBAAuB,EAAE,cAAc,EAAE;YAChE,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,SAAS;YACT,SAAS,EAAE,IAAI;YACf,GAAG,CAAC,iBAAiB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,CAAC;SAClE,CAAC,CAAC;IACL,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;QAC3B,OAAO,IAAI,aAAa,CAAC,kBAAkB,EAAE,sBAAsB,EAAE;YACnE,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,SAAS;YACT,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;IACL,CAAC;IAED,IAAI,aAAa,EAAE,QAAQ,CAAC,UAAU,CAAC,IAAI,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACzE,OAAO,IAAI,aAAa,CAAC,sBAAsB,aAAa,EAAE,EAAE,WAAW,EAAE;YAC3E,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,SAAS;SACV,CAAC,CAAC;IACL,CAAC;IAED,OAAO,IAAI,aAAa,CACtB,aAAa;QACX,CAAC,CAAC,uBAAuB,aAAa,EAAE;QACxC,CAAC,CAAC,4BAA4B,QAAQ,CAAC,MAAM,eAAe,EAC9D,aAAa,EACb,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,CACvC,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,QAAkB;IACjD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC;QAC3C,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,IAAI,OAAgB,CAAC;QACrB,IAAI,CAAC;YACH,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,kEAAkE;YAClE,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC5C,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,MAAM,GAAG,OAAkC,CAAC;QAClD,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ;YAC7D,CAAC,CAAC,MAAM,CAAC,KAAgC;YACzC,CAAC,CAAC,SAAS,CAAC;QACd,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,IAAI,CAC3C,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CACjF,CAAC;QACF,MAAM,OAAO,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,IAAI,CACjG,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CACjF,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ;YAC/D,CAAC,CAAC,MAAM,CAAC,MAAM;YACf,CAAC,CAAC,MAAM,EAAE,MAAM,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ;gBACnD,CAAC,CAAC,MAAM,CAAC,MAAM;gBACf,CAAC,CAAC,SAAS,CAAC;QAChB,MAAM,WAAW,GAAG,MAAM;YACxB,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,MAAiC,CAAC;iBAChD,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE;gBAC1B,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,QAAQ;oBACpC,CAAC,CAAC,KAAK;oBACP,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ;wBACpD,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;wBACV,CAAC,CAAC,SAAS,CAAC;gBAChB,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3C,CAAC,CAAC;iBACD,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;YACd,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,KAAK,GAAG;YACZ,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,SAAS;YAC9B,OAAO;YACP,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS;SACrE,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;QAC1D,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAChG,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,KAAoB,EAAE,KAAa;IAC1D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9B,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;QAC7C,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACpC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAChC,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,SAAS,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,KAAK,YAAY,KAAK,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC;AAClG,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/pingcode/errors.d.ts

@@ -0,0 +1,20 @@
+export type PingCodeErrorCode = "NOT_CONFIGURED" | "AUTHENTICATION_FAILED" | "PERMISSION_DENIED" | "NOT_FOUND" | "RATE_LIMITED" | "UPSTREAM_UNAVAILABLE" | "TIMEOUT" | "INVALID_RESPONSE" | "PROJECT_CONTEXT_INVALID" | "RESPONSE_TOO_LARGE" | "WRITE_DISABLED" | "APPROVAL_INVALID" | "APPROVAL_CONTEXT_INVALID" | "SESSION_BINDING_MISMATCH" | "IDEMPOTENCY_CONFLICT" | "WRITE_OUTCOME_UNKNOWN" | "CONFLICT" | "BAD_REQUEST";
+export declare class PingCodeError extends Error {
+    readonly code: PingCodeErrorCode;
+    readonly options: {
+        status?: number;
+        retryable?: boolean;
+        retryAfterSeconds?: number;
+        requestId?: string;
+        cause?: unknown;
+    };
+    constructor(message: string, code: PingCodeErrorCode, options?: {
+        status?: number;
+        retryable?: boolean;
+        retryAfterSeconds?: number;
+        requestId?: string;
+        cause?: unknown;
+    });
+    get retryable(): boolean;
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/pingcode/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/pingcode/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GACzB,gBAAgB,GAChB,uBAAuB,GACvB,mBAAmB,GACnB,WAAW,GACX,cAAc,GACd,sBAAsB,GACtB,SAAS,GACT,kBAAkB,GAClB,yBAAyB,GACzB,oBAAoB,GACpB,gBAAgB,GAChB,kBAAkB,GAClB,0BAA0B,GAC1B,0BAA0B,GAC1B,sBAAsB,GACtB,uBAAuB,GACvB,UAAU,GACV,aAAa,CAAC;AAElB,qBAAa,aAAc,SAAQ,KAAK;aAGpB,IAAI,EAAE,iBAAiB;aACvB,OAAO,EAAE;QACvB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB;gBARD,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,iBAAiB,EACvB,OAAO,GAAE;QACvB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,OAAO,CAAC;KACZ;IAMR,IAAI,SAAS,IAAI,OAAO,CAEvB;CACF"}

package/dist/pingcode/errors.js

@@ -0,0 +1,14 @@
+export class PingCodeError extends Error {
+    code;
+    options;
+    constructor(message, code, options = {}) {
+        super(message, { cause: options.cause });
+        this.code = code;
+        this.options = options;
+        this.name = "PingCodeError";
+    }
+    get retryable() {
+        return this.options.retryable ?? false;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/pingcode/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/pingcode/errors.ts"],"names":[],"mappings":"AAoBA,MAAM,OAAO,aAAc,SAAQ,KAAK;IAGpB;IACA;IAHlB,YACE,OAAe,EACC,IAAuB,EACvB,UAMZ,EAAE;QAEN,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QATzB,SAAI,GAAJ,IAAI,CAAmB;QACvB,YAAO,GAAP,OAAO,CAMjB;QAGN,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC;IACzC,CAAC;CACF"}