@xurenxiang1219/pingcode-mcp 0.3.1

package/dist/mcp/write-approval.js

@@ -0,0 +1,321 @@
+import * as z from "zod/v4";
+import { PingCodeError } from "../pingcode/errors.js";
+export function requiresWriteConfirmation(policy, actions) {
+    if (policy === "none")
+        return false;
+    if (policy === "required")
+        return true;
+    if (policy === "update")
+        return actions.includes("delete");
+    return actions.some((action) => action !== "delete");
+}
+export function approvalTokenSchema(_mode) {
+    return z
+        .string()
+        .min(20)
+        .max(4096)
+        .optional()
+        .describe("审批凭证由当前客户端的确认流程处理；用户不应手动构造。当前部署要求显式凭证时由受信任审批端提供。");
+}
+export async function resolveCommitVerification(runtime, input, resourceType) {
+    if (input.previewId !== undefined && input.approvalContextId !== undefined && input.previewId !== input.approvalContextId) {
+        throw new PingCodeError("preview_id 與 approval_context_id 不一致", "CONFLICT");
+    }
+    const approvalContextId = input.approvalContextId ??
+        input.previewId ??
+        (input.requestHash === undefined
+            ? undefined
+            : await runtime.findApprovalContextIdForRequest({
+                resourceType,
+                requestHash: input.requestHash,
+                ...(input.agentSessionId === undefined ? {} : { agentSessionId: input.agentSessionId }),
+                ...(input.authInfo === undefined ? {} : { authInfo: input.authInfo }),
+            }));
+    if (approvalContextId === undefined) {
+        throw new PingCodeError("找不到对应的 Preview：请先用完全相同的 plan_id 和 operations 调用对应的 Preview Tool，然后立即 Commit（Approval Context 有效期内）。若 Preview 已过期，请重新 Preview。", "APPROVAL_CONTEXT_INVALID");
+    }
+    let resolvedApprovalContextId = approvalContextId;
+    let context;
+    try {
+        context = await runtime.resolveApprovalContext(resolvedApprovalContextId);
+    }
+    catch (error) {
+        // Only an omitted preview_id may be recovered from the exact request-hash
+        // index. A caller-supplied identifier is an assertion and must validate.
+        if ((input.previewId !== undefined || input.approvalContextId !== undefined) ||
+            input.requestHash === undefined ||
+            !(error instanceof PingCodeError && error.code === "APPROVAL_CONTEXT_INVALID")) {
+            throw error;
+        }
+        const recoveredApprovalContextId = await runtime.findApprovalContextIdForRequest({
+            resourceType,
+            requestHash: input.requestHash,
+            ...(input.agentSessionId === undefined ? {} : { agentSessionId: input.agentSessionId }),
+            ...(input.authInfo === undefined ? {} : { authInfo: input.authInfo }),
+        });
+        if (recoveredApprovalContextId === undefined || recoveredApprovalContextId === resolvedApprovalContextId) {
+            throw error;
+        }
+        resolvedApprovalContextId = recoveredApprovalContextId;
+        context = await runtime.resolveApprovalContext(resolvedApprovalContextId);
+    }
+    if (context.resourceType !== resourceType) {
+        throw new PingCodeError("Preview Context 不适用于当前写入资源类型", "APPROVAL_CONTEXT_INVALID");
+    }
+    return {
+        approvalContextId: resolvedApprovalContextId,
+        requestHash: context.requestHash,
+        evidenceHash: context.evidenceHash,
+        sessionBinding: context.sessionBinding,
+        idempotencyKey: input.idempotencyKey ?? `preview-${resolvedApprovalContextId}`,
+    };
+}
+export async function requestClientWriteConfirmation(server, logger, mode, approvalToken, message, confirmationRequired = true) {
+    if (!confirmationRequired || mode !== "client_confirmation" || approvalToken !== undefined) {
+        return;
+    }
+    if (!server.server.getClientCapabilities()?.elicitation?.form) {
+        logger.info("MCP Client 不支援寫入確認表單，使用 Commit Tool 執行許可作為人工確認", {
+            approvalMode: mode,
+        });
+        return;
+    }
+    const response = await server.server.elicitInput({
+        mode: "form",
+        message,
+        requestedSchema: {
+            type: "object",
+            properties: {
+                decision: {
+                    type: "string",
+                    title: "写入决定",
+                    description: "选择“确认写入”后将立即修改 PingCode。",
+                    oneOf: [
+                        { const: "cancel", title: "取消" },
+                        { const: "confirm", title: "确认写入" },
+                    ],
+                    default: "cancel",
+                },
+            },
+            required: ["decision"],
+        },
+    });
+    if (response.action !== "accept" || response.content?.decision !== "confirm") {
+        throw new PingCodeError("使用者未批准本次 PingCode 寫入", "APPROVAL_INVALID");
+    }
+}
+export function formatWriteToolResult(result) {
+    const value = result;
+    const lines = [
+        value.partial
+            ? "PingCode 批量写入已完成，部分操作失败"
+            : value.replayed
+                ? "PingCode 写入已完成（幂等重放，未重复写入）"
+                : "PingCode 写入成功",
+    ];
+    lines.push(`- 写入结果：${value.replayed === true ? "本次请求已处理，未重复创建或更新" : "已完成一次写入"}`);
+    if (value.replayed !== undefined)
+        lines.push(`- replayed：${value.replayed ? "true" : "false"}`);
+    if (typeof value.auditId === "string")
+        lines.push(`- auditId：${value.auditId}`);
+    let resourceIndex = 0;
+    for (const resource of value.resources ?? []) {
+        resourceIndex += 1;
+        const label = resource.title ?? resource.name ?? resource.identifier ?? "已确认资源";
+        const identifier = resource.identifier ? ` (${resource.identifier})` : "";
+        lines.push(`- ${resourceIndex}. ${writeActionLabel(resource.action)}：${label}${identifier}`);
+        if (resource.relationIds && resource.relationIds.length > 0) {
+            lines.push(`  已建立关系：${resource.relationIds.length} 个`);
+        }
+        if (resource.verified === true) {
+            lines.push(`  结果回读：已验证${resource.verifiedMembers === undefined ? "" : `，成员 ${resource.verifiedMembers} 个`}`);
+        }
+    }
+    for (const [index, failure] of (value.failures ?? []).entries()) {
+        lines.push(`- 未完成操作 ${index + 1}${failure.title ? `：${failure.title}` : ""}`);
+        lines.push(`  状态：${failure.state ?? "failed"}`);
+        lines.push(`  原因：${failure.message ?? "PingCode 未返回详细错误"}`);
+    }
+    if ((value.failures ?? []).length > 0)
+        lines.push("下一步：先处理未完成操作的原因；不要更换幂等键重复提交已确认成功的资源。");
+    return lines.join("\n");
+}
+export function formatWriteConfirmationMessage(title, details, finalNotice = "确认后将立即写入，请核对以上内容和 Preview 差异。") {
+    const detailLines = details.map((detail) => `- ${detail}`);
+    return [title, detailLines.join("\n"), finalNotice]
+        .filter((section) => section.length > 0)
+        .join("\n\n");
+}
+export function formatPreviewToolResult(result) {
+    const value = result;
+    const counts = value.counts ?? {};
+    const lines = [
+        "PingCode 变更预览",
+        "当前尚未写入 PingCode，请核对以下内容。",
+        `摘要：创建 ${counts.creates ?? 0} 个，更新 ${counts.updates ?? 0} 个，关系 ${counts.relations ?? 0} 个`,
+    ];
+    for (const [index, operation] of (value.operations ?? []).entries()) {
+        lines.push(`\n${index + 1}. ${previewActionLabel(operation.action)}`);
+        const changes = operation.changes ?? {};
+        for (const [field, change] of Object.entries(changes)) {
+            const nameField = field.endsWith("_id") ? `${field.slice(0, -3)}_name` : undefined;
+            if (nameField !== undefined && Object.prototype.hasOwnProperty.call(changes, nameField))
+                continue;
+            const displayedValue = change.after === null && change.before !== undefined ? change.before : change.after;
+            lines.push(`   字段 ${formatPreviewField(field)}：${formatPreviewValue(displayedValue, field)}`);
+        }
+        if (operation.relatedWorkItemIds && operation.relatedWorkItemIds.length > 0) {
+            lines.push(`   新增关系：${operation.relatedWorkItemIds.length} 个`);
+        }
+        const references = (operation.sourceReferences ?? [])
+            .map((reference) => sourceTypeLabel(reference.type))
+            .join("、");
+        if (references) {
+            lines.push(`   来源：${references}`);
+        }
+    }
+    for (const warning of value.warnings ?? []) {
+        lines.push(`\n需要注意：${warning}`);
+    }
+    lines.push("\n下一步：请确认以上目标和变更。确认后由 Agent 提交写入；你不需要填写或复制任何内部校验字段。");
+    return lines.join("\n");
+}
+const PREVIEW_FIELD_LABELS = {
+    title: "标题",
+    name: "名称",
+    identifier: "标识",
+    description: "描述",
+    type: "类型",
+    visibility: "可见性",
+    project_id: "项目",
+    project_name: "项目",
+    type_id: "工作项类型",
+    type_name: "工作项类型",
+    test_library_id: "测试库",
+    test_library_name: "测试库",
+    product_id: "产品",
+    product_name: "产品",
+    suite_id: "需求模块",
+    suite_name: "需求模块",
+    state_id: "状态",
+    state_name: "状态",
+    priority_id: "优先级",
+    priority_name: "优先级",
+    assignee_id: "负责人",
+    assignee_name: "负责人",
+    parent_id: "父工作项",
+    parent_name: "父工作项",
+    members: "普通成员",
+    member_ids: "成员",
+    steps: "步骤",
+    expected_content_hash: "内容版本",
+    content_hash: "内容版本",
+    properties: "自定义属性",
+    custom_properties: "自定义属性",
+    source_references: "来源",
+    parent_operation_id: "父操作",
+};
+function formatPreviewField(field) {
+    if (PREVIEW_FIELD_LABELS[field])
+        return PREVIEW_FIELD_LABELS[field];
+    if (field.endsWith("_id"))
+        return field.slice(0, -3) || field;
+    return field;
+}
+function sourceTypeLabel(type) {
+    const labels = {
+        wiki: "Wiki",
+        spec: "规格说明",
+        plan: "计划",
+        code: "代码",
+        task: "工作项",
+        test_case: "测试用例",
+        project: "项目",
+        test_library: "测试库",
+        ship_idea: "产品需求",
+    };
+    return labels[type ?? ""] ?? "来源资料";
+}
+function formatPreviewValue(value, field) {
+    if (value === null || value === undefined) {
+        return "未设置";
+    }
+    if ((field === "start_at" || field === "end_at") && typeof value === "number" && Number.isFinite(value)) {
+        return `${value}（${new Date(value * 1000).toISOString()}）`;
+    }
+    if (typeof value === "string") {
+        if (field?.endsWith("_hash"))
+            return "已核对当前版本";
+        if (field === "parent_operation_id")
+            return "已关联前置操作";
+        if (field?.endsWith("_id") && field !== "content_hash") {
+            return /[\s\u3400-\u9fff（）()]/u.test(value) ? value : "已通过目录确认";
+        }
+        return value.length > 500 ? `${value.slice(0, 500)}…` : value;
+    }
+    if (Array.isArray(value)) {
+        if (field === "members")
+            return `${value.length} 个成员`;
+        if (field?.endsWith("_ids"))
+            return `${value.length} 个已确认引用`;
+        return value.length === 0 ? "未设置" : `${value.length} 项`;
+    }
+    if (field === "properties" || field === "custom_properties") {
+        return typeof value === "object" && value !== null ? `${Object.keys(value).length} 个属性` : "已设置";
+    }
+    try {
+        const serialized = JSON.stringify(value) ?? String(value);
+        return serialized.length > 500 ? `${serialized.slice(0, 500)}…` : serialized;
+    }
+    catch {
+        return "[复杂值]";
+    }
+}
+function writeActionLabel(action) {
+    if (action === "create") {
+        return "已创建";
+    }
+    if (action === "update") {
+        return "已更新";
+    }
+    if (action === "delete") {
+        return "已删除";
+    }
+    return "已写入";
+}
+function previewActionLabel(action) {
+    if (action === "create") {
+        return "创建操作";
+    }
+    if (action === "update") {
+        return "更新操作";
+    }
+    if (action === "delete") {
+        return "删除操作";
+    }
+    return "同步操作";
+}
+export function commitWithApproval(runtime, mode, input) {
+    const common = {
+        resourceType: input.resourceType,
+        requestHash: input.requestHash,
+        evidenceHash: input.evidenceHash,
+        approvalContextId: input.approvalContextId,
+        sessionBinding: input.sessionBinding,
+        ...(input.agentSessionId === undefined ? {} : { agentSessionId: input.agentSessionId }),
+        idempotencyKey: input.idempotencyKey,
+        ...(input.authInfo === undefined ? {} : { authInfo: input.authInfo }),
+        action: input.action,
+    };
+    if (input.approvalToken !== undefined) {
+        return runtime.commit({ ...common, approvalToken: input.approvalToken });
+    }
+    if (!runtime.requiresConfirmation(input.actions ?? ["create"])) {
+        return runtime.commitAutomatic(common);
+    }
+    if (mode !== "client_confirmation") {
+        throw new PingCodeError("目前的 Commit 審批策略要求提供有效審批憑證", "APPROVAL_INVALID");
+    }
+    return runtime.commitInteractive(common);
+}
+//# sourceMappingURL=write-approval.js.map

package/dist/mcp/write-approval.js.map

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

package/dist/observability/metrics.d.ts

@@ -0,0 +1,46 @@
+export interface MetricsSnapshot {
+    generatedAt: string;
+    uptimeSeconds: number;
+    mcpHttp: {
+        requestsTotal: number;
+        authenticatedRequestsTotal: number;
+        responsesByStatus: Record<string, number>;
+        durationMsTotal: number;
+    };
+    tools: {
+        callsTotal: number;
+        failuresTotal: number;
+        durationMsTotal: number;
+    };
+    pingcodeApi: {
+        requestsTotal: number;
+        failuresTotal: number;
+        retriesTotal: number;
+        rateLimitedTotal: number;
+        durationMsTotal: number;
+    };
+}
+export declare class MetricsRegistry {
+    private readonly now;
+    private readonly startedAtMs;
+    private mcpRequestsTotal;
+    private mcpAuthenticatedRequestsTotal;
+    private readonly mcpResponsesByStatus;
+    private mcpDurationMsTotal;
+    private toolCallsTotal;
+    private toolFailuresTotal;
+    private toolDurationMsTotal;
+    private pingCodeRequestsTotal;
+    private pingCodeFailuresTotal;
+    private pingCodeRetriesTotal;
+    private pingCodeRateLimitedTotal;
+    private pingCodeDurationMsTotal;
+    constructor(now?: () => number, startedAtMs?: number);
+    recordMcpHttpResponse(status: number, durationMs: number, authenticated: boolean): void;
+    recordToolCall(durationMs: number, failed: boolean): void;
+    recordPingCodeRequest(status: number | undefined, durationMs: number): void;
+    recordPingCodeRetry(): void;
+    snapshot(): MetricsSnapshot;
+}
+export declare const metrics: MetricsRegistry;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/observability/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/observability/metrics.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE;QACP,aAAa,EAAE,MAAM,CAAC;QACtB,0BAA0B,EAAE,MAAM,CAAC;QACnC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC1C,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,KAAK,EAAE;QACL,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,EAAE,MAAM,CAAC;QACtB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,WAAW,EAAE;QACX,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAED,qBAAa,eAAe;IAgBxB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAftB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,6BAA6B,CAAK;IAC1C,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA6B;IAClE,OAAO,CAAC,kBAAkB,CAAK;IAC/B,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,mBAAmB,CAAK;IAChC,OAAO,CAAC,qBAAqB,CAAK;IAClC,OAAO,CAAC,qBAAqB,CAAK;IAClC,OAAO,CAAC,oBAAoB,CAAK;IACjC,OAAO,CAAC,wBAAwB,CAAK;IACrC,OAAO,CAAC,uBAAuB,CAAK;gBAGjB,GAAG,GAAE,MAAM,MAAiB,EAC7C,WAAW,CAAC,EAAE,MAAM;IAKtB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,GAAG,IAAI;IASvF,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IAQzD,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAW3E,mBAAmB,IAAI,IAAI;IAI3B,QAAQ,IAAI,eAAe;CA4B5B;AAED,eAAO,MAAM,OAAO,iBAAwB,CAAC"}

package/dist/observability/metrics.js

@@ -0,0 +1,79 @@
+export class MetricsRegistry {
+    now;
+    startedAtMs;
+    mcpRequestsTotal = 0;
+    mcpAuthenticatedRequestsTotal = 0;
+    mcpResponsesByStatus = new Map();
+    mcpDurationMsTotal = 0;
+    toolCallsTotal = 0;
+    toolFailuresTotal = 0;
+    toolDurationMsTotal = 0;
+    pingCodeRequestsTotal = 0;
+    pingCodeFailuresTotal = 0;
+    pingCodeRetriesTotal = 0;
+    pingCodeRateLimitedTotal = 0;
+    pingCodeDurationMsTotal = 0;
+    constructor(now = Date.now, startedAtMs) {
+        this.now = now;
+        this.startedAtMs = startedAtMs ?? now();
+    }
+    recordMcpHttpResponse(status, durationMs, authenticated) {
+        this.mcpRequestsTotal += 1;
+        this.mcpDurationMsTotal += nonNegative(durationMs);
+        this.mcpResponsesByStatus.set(status, (this.mcpResponsesByStatus.get(status) ?? 0) + 1);
+        if (authenticated) {
+            this.mcpAuthenticatedRequestsTotal += 1;
+        }
+    }
+    recordToolCall(durationMs, failed) {
+        this.toolCallsTotal += 1;
+        this.toolDurationMsTotal += nonNegative(durationMs);
+        if (failed) {
+            this.toolFailuresTotal += 1;
+        }
+    }
+    recordPingCodeRequest(status, durationMs) {
+        this.pingCodeRequestsTotal += 1;
+        this.pingCodeDurationMsTotal += nonNegative(durationMs);
+        if (status === undefined || status >= 400) {
+            this.pingCodeFailuresTotal += 1;
+        }
+        if (status === 429) {
+            this.pingCodeRateLimitedTotal += 1;
+        }
+    }
+    recordPingCodeRetry() {
+        this.pingCodeRetriesTotal += 1;
+    }
+    snapshot() {
+        return {
+            generatedAt: new Date(this.now()).toISOString(),
+            uptimeSeconds: Math.max(0, Math.floor((this.now() - this.startedAtMs) / 1000)),
+            mcpHttp: {
+                requestsTotal: this.mcpRequestsTotal,
+                authenticatedRequestsTotal: this.mcpAuthenticatedRequestsTotal,
+                responsesByStatus: Object.fromEntries([...this.mcpResponsesByStatus.entries()]
+                    .sort(([left], [right]) => left - right)
+                    .map(([status, count]) => [String(status), count])),
+                durationMsTotal: this.mcpDurationMsTotal,
+            },
+            tools: {
+                callsTotal: this.toolCallsTotal,
+                failuresTotal: this.toolFailuresTotal,
+                durationMsTotal: this.toolDurationMsTotal,
+            },
+            pingcodeApi: {
+                requestsTotal: this.pingCodeRequestsTotal,
+                failuresTotal: this.pingCodeFailuresTotal,
+                retriesTotal: this.pingCodeRetriesTotal,
+                rateLimitedTotal: this.pingCodeRateLimitedTotal,
+                durationMsTotal: this.pingCodeDurationMsTotal,
+            },
+        };
+    }
+}
+export const metrics = new MetricsRegistry();
+function nonNegative(value) {
+    return Number.isFinite(value) ? Math.max(0, value) : 0;
+}
+//# sourceMappingURL=metrics.js.map

package/dist/observability/metrics.js.map

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

package/dist/pingcode/access-token-provider.d.ts

@@ -0,0 +1,5 @@
+export interface AccessTokenProvider {
+    getAccessToken(): Promise<string>;
+    invalidate(): void;
+}
+//# sourceMappingURL=access-token-provider.d.ts.map

package/dist/pingcode/access-token-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"access-token-provider.d.ts","sourceRoot":"","sources":["../../src/pingcode/access-token-provider.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAClC,UAAU,IAAI,IAAI,CAAC;CACpB"}

package/dist/pingcode/access-token-provider.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=access-token-provider.js.map

package/dist/pingcode/access-token-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"access-token-provider.js","sourceRoot":"","sources":["../../src/pingcode/access-token-provider.ts"],"names":[],"mappings":""}

package/dist/pingcode/client.d.ts

@@ -0,0 +1,43 @@
+import type { Logger } from "../logger.js";
+import type { AccessTokenProvider } from "./access-token-provider.js";
+import type { FetchLike } from "./token-provider.js";
+export interface PingCodeClientLike {
+    get(path: string, query?: Record<string, string | number | boolean | undefined>): Promise<unknown>;
+}
+export interface PingCodeWriteClientLike extends PingCodeClientLike {
+    post(path: string, body: Record<string, unknown>): Promise<unknown>;
+    patch(path: string, body: Record<string, unknown>): Promise<unknown>;
+    delete?(path: string): Promise<unknown>;
+}
+export interface PingCodeClientRetryOptions {
+    maxRetries?: number;
+    baseDelayMs?: number;
+    maxDelayMs?: number;
+    random?: () => number;
+    now?: () => number;
+    sleep?: (milliseconds: number) => Promise<void>;
+}
+export declare class PingCodeClient implements PingCodeWriteClientLike {
+    private readonly apiBaseUrl;
+    private readonly tokenProvider;
+    private readonly timeoutMs;
+    private readonly maxResponseBytes;
+    private readonly logger;
+    private readonly fetchImpl;
+    private readonly maxRetries;
+    private readonly baseDelayMs;
+    private readonly maxDelayMs;
+    private readonly random;
+    private readonly now;
+    private readonly sleep;
+    constructor(apiBaseUrl: string, tokenProvider: AccessTokenProvider, timeoutMs: number, maxResponseBytes: number, logger: Logger, fetchImpl?: FetchLike, retryOptions?: PingCodeClientRetryOptions);
+    get(path: string, query?: Record<string, string | number | boolean | undefined>): Promise<unknown>;
+    post(path: string, body: Record<string, unknown>): Promise<unknown>;
+    patch(path: string, body: Record<string, unknown>): Promise<unknown>;
+    delete(path: string): Promise<unknown>;
+    private request;
+    private retry;
+    private retryDelayMs;
+    private parseJsonResponse;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/pingcode/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACpG;AAED,MAAM,WAAW,uBAAwB,SAAQ,kBAAkB;IACjE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACpE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrE,MAAM,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,0BAA0B;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD;AAED,qBAAa,cAAe,YAAW,uBAAuB;IAS1D,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAb5B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0C;gBAG7C,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,mBAAmB,EAClC,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE,MAAM,EACd,SAAS,GAAE,SAAiB,EAC7C,YAAY,GAAE,0BAA+B;IAUzC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAItG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAInE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAIpE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;YAI9B,OAAO;YA6GP,KAAK;IAoBnB,OAAO,CAAC,YAAY;YAQN,iBAAiB;CA4BhC"}