@xurenxiang1219/pingcode-mcp 0.3.1

package/dist/sources/relation-source.js

@@ -0,0 +1,129 @@
+import { PingCodeError } from "../pingcode/errors.js";
+import { paginatedSchema, relationSchema, shipIdeaSchema, testCaseSchema, wikiPageSchema, workItemSchema, } from "../pingcode/schemas.js";
+/** Resource types accepted by the official Relation response/list contract. */
+export const traceableResourceTypes = [
+    "idea",
+    "ticket",
+    "work_item",
+    "test_plan",
+    "test_run",
+    "test_case",
+    "page",
+];
+const supportedRelationReadTargets = {
+    idea: ["ticket", "work_item", "test_case", "idea", "page"],
+    ticket: ["idea", "work_item", "ticket", "page"],
+    work_item: ["test_case", "idea", "ticket", "page"],
+    test_plan: ["work_item"],
+    test_run: ["work_item"],
+    test_case: ["idea", "work_item", "page"],
+    page: ["idea", "ticket", "work_item", "test_case"],
+};
+export class RelationSource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async listRelations(input) {
+        if (!isSupportedRelationReadPair(input.principalType, input.targetType)) {
+            throw new PingCodeError(`官方 Relation 不支持查询 ${input.principalType} -> ${input.targetType} 组合；请按官方参数组合重新选择 target_type`, "BAD_REQUEST");
+        }
+        return paginatedSchema(relationSchema).parse(await this.client.get("/v1/relations", {
+            principal_type: input.principalType,
+            principal_id: input.principalId,
+            target_type: input.targetType,
+            page_index: input.pageIndex,
+            page_size: input.pageSize,
+        }));
+    }
+    async getRelation(relationId) {
+        return relationSchema.parse(await this.client.get(`/v1/relations/${encodeURIComponent(relationId)}`));
+    }
+    async findExactRelation(input) {
+        let pageIndex = 0;
+        for (;;) {
+            const page = await this.listRelations({ ...input, pageIndex, pageSize: 100 });
+            const target = page.values.find((relation) => relationTargetResourceId(relation) === input.targetId);
+            if (target) {
+                return target;
+            }
+            const consumed = (page.page_index + 1) * page.page_size;
+            if (consumed >= page.total || page.values.length === 0) {
+                return null;
+            }
+            pageIndex = page.page_index + 1;
+        }
+    }
+    async createRelation(fields) {
+        const response = await this.client.post("/v1/relations", {
+            principal_type: fields.principalType,
+            principal_id: fields.principalId,
+            target_type: fields.targetType,
+            target_id: fields.targetId,
+        });
+        try {
+            return relationSchema.parse(response);
+        }
+        catch (error) {
+            throw new PingCodeError("PingCode 已接受关联创建请求，但返回内容无法确认 Relation 身份；请使用 pingcode_relation_list 在 MCP 内回读，禁止更换幂等键重试", "WRITE_OUTCOME_UNKNOWN", { cause: error });
+        }
+    }
+    async deleteRelation(relationId) {
+        if (!this.client.delete) {
+            throw new PingCodeError("当前 PingCode Client 不支持 DELETE 请求", "NOT_CONFIGURED");
+        }
+        await this.client.delete(`/v1/relations/${encodeURIComponent(relationId)}`);
+    }
+    async readResource(type, id) {
+        if (type === "idea") {
+            const value = shipIdeaSchema.parse(await this.client.get(`/v1/ship/ideas/${encodeURIComponent(id)}`));
+            return {
+                type,
+                id: value.id,
+                identifier: value.identifier,
+                title: value.title,
+            };
+        }
+        if (type === "work_item") {
+            const value = workItemSchema.parse(await this.client.get(`/v1/project/work_items/${encodeURIComponent(id)}`));
+            return {
+                type,
+                id: value.id,
+                identifier: value.identifier,
+                title: value.title,
+                workItemType: value.type,
+            };
+        }
+        if (type === "test_case") {
+            const value = testCaseSchema.parse(await this.client.get(`/v1/testhub/cases/${encodeURIComponent(id)}`));
+            return { type, id: value.id, identifier: value.identifier, title: value.title };
+        }
+        if (type === "page") {
+            const value = wikiPageSchema.parse(await this.client.get(`/v1/wiki/pages/${encodeURIComponent(id)}`));
+            return { type, id: value.id, identifier: value.short_id ?? null, title: value.name };
+        }
+        throw new PingCodeError(`${type} 已被官方 Relation 响应支持，但当前 MCP 尚未接入该资源目录，不能按名称解析；请使用官方回读得到的资源 ID`, "BAD_REQUEST");
+    }
+}
+export function isSupportedRelationReadPair(principalType, targetType) {
+    return supportedRelationReadTargets[principalType].includes(targetType);
+}
+export function isSupportedRelationWritePair(principalType, targetType) {
+    if (principalType === "idea") {
+        return targetType === "work_item" || targetType === "test_case" || targetType === "page";
+    }
+    if (principalType === "work_item") {
+        return targetType === "idea" || targetType === "test_case" || targetType === "page";
+    }
+    if (principalType === "test_case") {
+        return targetType === "idea" || targetType === "work_item" || targetType === "page";
+    }
+    return false;
+}
+export function relationPrincipalResourceId(relation) {
+    return relation.principal_id ?? relation.principal?.id;
+}
+export function relationTargetResourceId(relation) {
+    return relation.target_id ?? relation.target?.id;
+}
+//# sourceMappingURL=relation-source.js.map

package/dist/sources/relation-source.js.map

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

package/dist/sources/requirement-source.d.ts

@@ -0,0 +1,5 @@
+import type { RequirementContext } from "../domain/requirement-context.js";
+export interface RequirementSource {
+    getRequirementContext(reference: string): Promise<RequirementContext>;
+}
+//# sourceMappingURL=requirement-source.d.ts.map

package/dist/sources/requirement-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requirement-source.d.ts","sourceRoot":"","sources":["../../src/sources/requirement-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAE3E,MAAM,WAAW,iBAAiB;IAChC,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACvE"}

package/dist/sources/requirement-source.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=requirement-source.js.map

package/dist/sources/requirement-source.js.map

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

package/dist/sources/ship-source.d.ts

@@ -0,0 +1,67 @@
+import type { PingCodeWriteClientLike } from "../pingcode/client.js";
+import { type ShipIdea, type ShipProduct, type ShipSuite } from "../pingcode/schemas.js";
+export interface ShipListInput {
+    keywords?: string;
+    productId?: string;
+    pageIndex?: number;
+    pageSize?: number;
+}
+export interface ShipProductMember {
+    id: string;
+    type: "user" | "user_group";
+}
+export interface ShipProductWriteFields {
+    scopeType?: "organization" | "user_group";
+    scopeId?: string;
+    name?: string;
+    visibility?: "public" | "private";
+    identifier?: string;
+    description?: string;
+    members?: ShipProductMember[];
+}
+export interface ShipIdeaWriteFields {
+    productId?: string;
+    title?: string;
+    assigneeId?: string;
+    description?: string;
+    suiteId?: string;
+    priorityId?: string;
+    properties?: Record<string, unknown>;
+}
+export interface ShipSuiteWriteFields {
+    name: string;
+    type: "product" | "module";
+    parentId?: string;
+}
+export declare class ShipSource {
+    private readonly client;
+    constructor(client: PingCodeWriteClientLike);
+    listProducts(input: ShipListInput): Promise<{
+        page_size: number;
+        page_index: number;
+        total: number;
+        values: ShipProduct[];
+    }>;
+    getProduct(productId: string): Promise<ShipProduct>;
+    createProduct(fields: ShipProductWriteFields): Promise<ShipProduct>;
+    updateProduct(productId: string, fields: ShipProductWriteFields): Promise<ShipProduct>;
+    listIdeas(input: ShipListInput): Promise<{
+        page_size: number;
+        page_index: number;
+        total: number;
+        values: ShipIdea[];
+    }>;
+    getIdea(ideaId: string): Promise<ShipIdea>;
+    createIdea(fields: ShipIdeaWriteFields): Promise<ShipIdea>;
+    updateIdea(ideaId: string, fields: ShipIdeaWriteFields): Promise<ShipIdea>;
+    listSuites(productId: string, input?: Pick<ShipListInput, "pageIndex" | "pageSize">): Promise<{
+        page_size: number;
+        page_index: number;
+        total: number;
+        values: ShipSuite[];
+    }>;
+    getSuite(productId: string, suiteId: string): Promise<ShipSuite>;
+    createSuite(productId: string, fields: ShipSuiteWriteFields): Promise<ShipSuite>;
+    removeSuite(productId: string, suiteId: string): Promise<void>;
+}
+//# sourceMappingURL=ship-source.d.ts.map

package/dist/sources/ship-source.d.ts.map

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

package/dist/sources/ship-source.js

@@ -0,0 +1,135 @@
+import { PingCodeError } from "../pingcode/errors.js";
+import { paginatedSchema, shipIdeaSchema, shipProductSchema, shipSuiteSchema, } from "../pingcode/schemas.js";
+import { extractWriteResourceId, unknownWriteResponse, unwrapWriteResponse } from "../pingcode/write-response.js";
+export class ShipSource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async listProducts(input) {
+        return paginatedSchema(shipProductSchema).parse(await this.client.get("/v1/ship/products", listQuery(input)));
+    }
+    async getProduct(productId) {
+        return shipProductSchema.parse(await this.client.get(`/v1/ship/products/${encodeURIComponent(productId)}`));
+    }
+    async createProduct(fields) {
+        const raw = unwrapWriteResponse(await this.client.post("/v1/ship/products", mapProductFields(fields)));
+        const id = extractWriteResourceId(raw);
+        if (id === undefined)
+            throw unknownWriteResponse("Ship 产品创建", raw);
+        const parsed = shipProductSchema.safeParse({
+            ...raw,
+            id,
+            identifier: typeof raw.identifier === "string" ? raw.identifier : fields.identifier,
+            name: typeof raw.name === "string" ? raw.name : fields.name,
+        });
+        if (parsed.success)
+            return parsed.data;
+        try {
+            return shipProductSchema.parse(await this.client.get(`/v1/ship/products/${encodeURIComponent(id)}`));
+        }
+        catch (error) {
+            throw unknownWriteResponse(`Ship 产品创建（${id}）`, error);
+        }
+    }
+    async updateProduct(productId, fields) {
+        return shipProductSchema.parse(await this.client.patch(`/v1/ship/products/${encodeURIComponent(productId)}`, mapProductUpdateFields(fields)));
+    }
+    async listIdeas(input) {
+        return paginatedSchema(shipIdeaSchema).parse(await this.client.get("/v1/ship/ideas", listQuery(input)));
+    }
+    async getIdea(ideaId) {
+        return shipIdeaSchema.parse(await this.client.get(`/v1/ship/ideas/${encodeURIComponent(ideaId)}`));
+    }
+    async createIdea(fields) {
+        const raw = unwrapWriteResponse(await this.client.post("/v1/ship/ideas", mapIdeaFields(fields)));
+        const id = extractWriteResourceId(raw);
+        if (id === undefined)
+            throw unknownWriteResponse("Ship 需求创建", raw);
+        const parsed = shipIdeaSchema.safeParse({
+            ...raw,
+            id,
+            title: typeof raw.title === "string" ? raw.title : fields.title,
+        });
+        if (parsed.success)
+            return parsed.data;
+        try {
+            return shipIdeaSchema.parse(await this.client.get(`/v1/ship/ideas/${encodeURIComponent(id)}`));
+        }
+        catch (error) {
+            throw unknownWriteResponse(`Ship 需求创建（${id}）`, error);
+        }
+    }
+    async updateIdea(ideaId, fields) {
+        return shipIdeaSchema.parse(await this.client.patch(`/v1/ship/ideas/${encodeURIComponent(ideaId)}`, mapIdeaUpdateFields(fields)));
+    }
+    async listSuites(productId, input = {}) {
+        return paginatedSchema(shipSuiteSchema).parse(await this.client.get(`/v1/ship/products/${encodeURIComponent(productId)}/suites`, {
+            page_index: input.pageIndex,
+            page_size: input.pageSize,
+        }));
+    }
+    async getSuite(productId, suiteId) {
+        return shipSuiteSchema.parse(await this.client.get(`/v1/ship/products/${encodeURIComponent(productId)}/suites/${encodeURIComponent(suiteId)}`));
+    }
+    async createSuite(productId, fields) {
+        return shipSuiteSchema.parse(await this.client.post(`/v1/ship/products/${encodeURIComponent(productId)}/suites`, compact({ name: fields.name, type: fields.type, parent_id: fields.parentId })));
+    }
+    async removeSuite(productId, suiteId) {
+        if (!this.client.delete) {
+            throw new PingCodeError("当前 PingCode Client 不支持 DELETE 请求", "NOT_CONFIGURED");
+        }
+        await this.client.delete(`/v1/ship/products/${encodeURIComponent(productId)}/suites/${encodeURIComponent(suiteId)}`);
+    }
+}
+function listQuery(input) {
+    return {
+        keywords: input.keywords,
+        product_id: input.productId,
+        page_index: input.pageIndex,
+        page_size: input.pageSize,
+    };
+}
+function mapProductFields(fields) {
+    return compact({
+        scope_type: fields.scopeType,
+        scope_id: fields.scopeId,
+        name: fields.name,
+        visibility: fields.visibility,
+        identifier: fields.identifier,
+        description: fields.description,
+        members: fields.members,
+    });
+}
+function mapProductUpdateFields(fields) {
+    return compact({
+        name: fields.name,
+        identifier: fields.identifier,
+        description: fields.description,
+    });
+}
+function mapIdeaFields(fields) {
+    return compact({
+        product_id: fields.productId,
+        title: fields.title,
+        assignee_id: fields.assigneeId,
+        description: fields.description,
+        suite_id: fields.suiteId,
+        priority_id: fields.priorityId,
+        properties: fields.properties,
+    });
+}
+function mapIdeaUpdateFields(fields) {
+    return compact({
+        title: fields.title,
+        assignee_id: fields.assigneeId,
+        description: fields.description,
+        suite_id: fields.suiteId,
+        priority_id: fields.priorityId,
+        properties: fields.properties,
+    });
+}
+function compact(value) {
+    return Object.fromEntries(Object.entries(value).filter(([, nested]) => nested !== undefined));
+}
+//# sourceMappingURL=ship-source.js.map

package/dist/sources/ship-source.js.map

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

package/dist/sources/test-case-source.d.ts

@@ -0,0 +1,30 @@
+import type { TestCaseContext } from "../domain/test-case-context.js";
+import type { PingCodeClientLike } from "../pingcode/client.js";
+import { type TestCase } from "../pingcode/schemas.js";
+import type { ListResult } from "./wiki-source.js";
+export interface ListTestCasesInput {
+    libraryId?: string;
+    maintenanceId?: string;
+    stateId?: string;
+    importantLevelId?: string;
+    tagId?: string;
+    keywords?: string;
+    pageIndex?: number;
+    pageSize?: number;
+}
+export declare class TestCaseRequirementSource {
+    private readonly client;
+    private readonly now;
+    constructor(client: PingCodeClientLike, now?: () => Date);
+    listTestCases(input: ListTestCasesInput): Promise<ListResult<TestCase>>;
+    getTestCaseContext(reference: string): Promise<TestCaseContext>;
+    /**
+     * PingCode's write response and HTML URL can expose a display identifier
+     * (for example LIB-12), while the detail endpoint requires the internal ID.
+     * Resolve that identifier through the read-only list endpoint before giving
+     * up, so newly-created cases remain usable by subsequent tools.
+     */
+    private getTestCasePayload;
+    private listTestCaseRelations;
+}
+//# sourceMappingURL=test-case-source.d.ts.map

package/dist/sources/test-case-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-case-source.d.ts","sourceRoot":"","sources":["../../src/sources/test-case-source.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,OAAO,EAIL,KAAK,QAAQ,EACd,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGnD,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,yBAAyB;IAElC,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG;gBADH,MAAM,EAAE,kBAAkB,EAC1B,GAAG,GAAE,MAAM,IAAuB;IAG/C,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAsBvE,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAsFrE;;;;;OAKG;YACW,kBAAkB;YAuBlB,qBAAqB;CAsBpC"}

package/dist/sources/test-case-source.js

@@ -0,0 +1,206 @@
+import { createHash } from "node:crypto";
+import { PingCodeError } from "../pingcode/errors.js";
+import { paginatedSchema, relationSchema, testCaseSchema, } from "../pingcode/schemas.js";
+import { normalizeContentHash } from "../domain/content-hash.js";
+export class TestCaseRequirementSource {
+    client;
+    now;
+    constructor(client, now = () => new Date()) {
+        this.client = client;
+        this.now = now;
+    }
+    async listTestCases(input) {
+        const payload = await this.client.get("/v1/testhub/cases", {
+            library_id: input.libraryId,
+            maintenance_id: input.maintenanceId,
+            state_id: input.stateId,
+            important_level_id: input.importantLevelId,
+            tag_id: input.tagId,
+            keywords: input.keywords,
+            page_index: input.pageIndex,
+            page_size: input.pageSize,
+            include_deleted: false,
+            include_archived: false,
+        });
+        const parsed = paginatedSchema(testCaseSchema).parse(payload);
+        return {
+            pageSize: parsed.page_size,
+            pageIndex: parsed.page_index,
+            total: parsed.total,
+            values: parsed.values,
+        };
+    }
+    async getTestCaseContext(reference) {
+        const normalizedReference = normalizeCaseReference(reference);
+        const { payload } = await this.getTestCasePayload(normalizedReference);
+        const testCase = testCaseSchema.parse(payload);
+        const effectiveCaseId = testCase.id;
+        let relations = [];
+        let relationsAvailable = true;
+        let relationErrorCode = null;
+        try {
+            relations = await this.listTestCaseRelations(effectiveCaseId);
+        }
+        catch (error) {
+            if (!(error instanceof PingCodeError)) {
+                throw error;
+            }
+            relationsAvailable = false;
+            relationErrorCode = error.code;
+        }
+        return {
+            source: {
+                type: "test_case",
+                id: testCase.id,
+                identifier: testCase.identifier,
+                shortId: testCase.short_id ?? null,
+                url: testCase.html_url ?? testCase.url,
+                apiUrl: testCase.url,
+                libraryId: testCase.library.id,
+                libraryIdentifier: testCase.library.identifier,
+                libraryName: testCase.library.name,
+                updatedAt: testCase.updated_at ?? null,
+                retrievedAt: this.now().toISOString(),
+                contentHash: normalizeContentHash(createHash("sha256").update(stableJson(testCase), "utf8").digest("hex")),
+            },
+            title: testCase.title,
+            description: testCase.description ?? null,
+            precondition: testCase.precondition ?? null,
+            level: testCase.level ?? null,
+            testType: testCase.test_type ?? null,
+            importantLevel: testCase.important_level
+                ? { id: testCase.important_level.id, name: testCase.important_level.name }
+                : null,
+            suite: testCase.suite
+                ? {
+                    id: testCase.suite.id,
+                    name: testCase.suite.name,
+                    paths: testCase.suite.paths ?? null,
+                }
+                : null,
+            state: testCase.state
+                ? {
+                    id: testCase.state.id,
+                    name: testCase.state.name,
+                    type: testCase.state.type ?? null,
+                }
+                : null,
+            type: testCase.type ? { id: testCase.type.id, name: testCase.type.name } : null,
+            maintenance: testCase.maintenance
+                ? {
+                    id: testCase.maintenance.id,
+                    name: testCase.maintenance.name ?? null,
+                    displayName: testCase.maintenance.display_name ?? null,
+                }
+                : null,
+            properties: testCase.properties ?? {},
+            relationsAvailable,
+            relationErrorCode,
+            relationIds: relations.map((relation) => relation.id),
+            relatedWorkItemIds: relations
+                .filter((relation) => relation.target_type === "work_item")
+                .map(relationTargetId)
+                .filter((id) => id !== undefined),
+            relations: relations.map((relation) => ({
+                id: relation.id,
+                targetType: relation.target_type,
+                targetId: relationTargetId(relation) ?? null,
+            })),
+            steps: (testCase.steps ?? []).map((step) => ({
+                stepId: step.step_id ?? null,
+                description: step.description,
+                expectedValue: step.expected_value ?? null,
+                isGroup: step.is_group ?? false,
+                groupId: step.group_id ?? null,
+            })),
+        };
+    }
+    /**
+     * PingCode's write response and HTML URL can expose a display identifier
+     * (for example LIB-12), while the detail endpoint requires the internal ID.
+     * Resolve that identifier through the read-only list endpoint before giving
+     * up, so newly-created cases remain usable by subsequent tools.
+     */
+    async getTestCasePayload(reference) {
+        try {
+            return {
+                payload: await this.client.get(`/v1/testhub/cases/${encodeURIComponent(reference)}`),
+            };
+        }
+        catch (error) {
+            if (!(error instanceof PingCodeError) || !["NOT_FOUND", "BAD_REQUEST"].includes(error.code)) {
+                throw error;
+            }
+            const listed = await this.listTestCases({ keywords: reference, pageIndex: 0, pageSize: 100 });
+            const matches = listed.values.filter((testCase) => testCase.id === reference || testCase.identifier === reference || testCase.short_id === reference);
+            if (matches.length === 1 && matches[0]) {
+                const resolvedId = matches[0].id;
+                return {
+                    payload: await this.client.get(`/v1/testhub/cases/${encodeURIComponent(resolvedId)}`),
+                };
+            }
+            throw error;
+        }
+    }
+    async listTestCaseRelations(caseId) {
+        const relations = [];
+        let pageIndex = 0;
+        for (;;) {
+            const page = paginatedSchema(relationSchema).parse(await this.client.get("/v1/relations", {
+                principal_type: "test_case",
+                principal_id: caseId,
+                target_type: "work_item",
+                page_index: pageIndex,
+                page_size: 100,
+            }));
+            relations.push(...page.values);
+            const consumed = (page.page_index + 1) * page.page_size;
+            if (consumed >= page.total || page.values.length === 0) {
+                return relations;
+            }
+            pageIndex = page.page_index + 1;
+        }
+    }
+}
+function relationTargetId(relation) {
+    return relation.target_id ?? relation.target?.id;
+}
+function normalizeCaseReference(reference) {
+    const normalized = reference.trim();
+    if (!normalized) {
+        throw new PingCodeError("caseReference 不能為空", "BAD_REQUEST");
+    }
+    if (!normalized.includes("://")) {
+        return normalized;
+    }
+    let url;
+    try {
+        url = new URL(normalized);
+    }
+    catch {
+        throw new PingCodeError("caseReference 不是有效的 Test Case URL", "BAD_REQUEST");
+    }
+    const match = url.pathname.match(/\/testhub\/cases\/([^/]+)\/?$/);
+    if (!match) {
+        throw new PingCodeError("caseReference URL 必須指向 PingCode Test Case API", "BAD_REQUEST");
+    }
+    try {
+        return decodeURIComponent(match[1]);
+    }
+    catch {
+        throw new PingCodeError("caseReference URL 包含無效的 Test Case ID", "BAD_REQUEST");
+    }
+}
+function stableJson(value) {
+    if (Array.isArray(value)) {
+        return `[${value.map(stableJson).join(",")}]`;
+    }
+    if (value && typeof value === "object") {
+        return `{${Object.entries(value)
+            .sort(([left], [right]) => left.localeCompare(right))
+            .map(([key, nested]) => `${JSON.stringify(key)}:${stableJson(nested)}`)
+            .join(",")}}`;
+    }
+    return JSON.stringify(value);
+}
+//# sourceMappingURL=test-case-source.js.map

package/dist/sources/test-case-source.js.map

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