@xurenxiang1219/pingcode-mcp 0.3.1

package/dist/sources/metadata-source.js

@@ -0,0 +1,167 @@
+import { PingCodeError } from "../pingcode/errors.js";
+import { directoryUserMetadataSchema, directoryGroupMetadataSchema, directoryRoleMetadataSchema, metadataNamedValueSchema, metadataPropertySchema, paginatedSchema, projectMemberMetadataSchema, projectMetadataSchema, testLibraryMemberSchema, testLibraryMetadataSchema, projectStageMetadataSchema, shipIdeaPriorityMetadataSchema, } from "../pingcode/schemas.js";
+const namedCatalogSchema = paginatedSchema(metadataNamedValueSchema);
+const propertyCatalogSchema = paginatedSchema(metadataPropertySchema);
+export class PingCodeMetadataSource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async listProjects(input) {
+        return paginatedSchema(projectMetadataSchema).parse(await this.client.get("/v1/project/projects", listQuery(input)));
+    }
+    async getProject(projectId) {
+        return projectMetadataSchema.parse(await this.client.get(`/v1/project/projects/${encodeURIComponent(projectId)}`));
+    }
+    async listProjectMembers(projectId, input = {}) {
+        return paginatedSchema(projectMemberMetadataSchema).parse(await this.client.get(`/v1/project/projects/${encodeURIComponent(projectId)}/members`, { page_index: input.pageIndex, page_size: input.pageSize ?? 100 }));
+    }
+    async listTestLibraries(input) {
+        return paginatedSchema(testLibraryMetadataSchema).parse(await this.client.get("/v1/testhub/libraries", listQuery(input)));
+    }
+    async getTestLibrary(testLibraryId) {
+        return testLibraryMetadataSchema.parse(await this.client.get(`/v1/testhub/libraries/${encodeURIComponent(testLibraryId)}`));
+    }
+    async listTestLibraryMembers(testLibraryId, input = {}) {
+        return paginatedSchema(testLibraryMemberSchema).parse(await this.client.get(`/v1/testhub/libraries/${encodeURIComponent(testLibraryId)}/members`, { page_index: input.pageIndex, page_size: input.pageSize ?? 100 }));
+    }
+    async getTestLibraryMember(testLibraryId, memberId) {
+        return testLibraryMemberSchema.parse(await this.client.get(`/v1/testhub/libraries/${encodeURIComponent(testLibraryId)}/members/${encodeURIComponent(memberId)}`));
+    }
+    async searchUsers(input) {
+        // /v1/directory/users has no archived or deleted notion: sending the
+        // include_* filters that listQuery() adds for projects and test libraries
+        // makes PingCode return an empty page instead of ignoring them.
+        return paginatedSchema(directoryUserMetadataSchema).parse(await this.client.get("/v1/directory/users", {
+            keywords: input.keywords,
+            page_index: input.pageIndex,
+            page_size: input.pageSize ?? 100,
+        }));
+    }
+    async listTeams(input = {}) {
+        return paginatedSchema(directoryGroupMetadataSchema).parse(await this.client.get("/v1/directory/groups", {
+            keywords: input.keywords,
+            page_index: input.pageIndex,
+            page_size: input.pageSize ?? 100,
+        }));
+    }
+    async listProjectStages(input = {}) {
+        return paginatedSchema(projectStageMetadataSchema).parse(await this.client.get("/v1/pjm/stages", {
+            page_index: input.pageIndex,
+            page_size: input.pageSize ?? 100,
+        }));
+    }
+    async listShipIdeaPriorities(productId, input = {}) {
+        return paginatedSchema(shipIdeaPriorityMetadataSchema).parse(await this.client.get("/v1/ship/idea/priorities", {
+            product_id: productId,
+            page_index: input.pageIndex,
+            page_size: input.pageSize ?? 100,
+        }));
+    }
+    async listRoles(input = {}) {
+        return paginatedSchema(directoryRoleMetadataSchema).parse(await this.client.get("/v1/directory/roles", {
+            page_index: input.pageIndex,
+            page_size: input.pageSize ?? 100,
+        }));
+    }
+    async getWorkItemMetadata(input) {
+        const projectQuery = { project_id: input.projectId, page_size: 100 };
+        const typedProjectQuery = {
+            ...projectQuery,
+            work_item_type_id: input.workItemTypeId,
+        };
+        const boardPath = input.boardId
+            ? `/v1/project/projects/${encodeURIComponent(input.projectId)}/boards/${encodeURIComponent(input.boardId)}`
+            : null;
+        const requested = (catalog) => input.include === undefined || input.include.includes(catalog);
+        const [types, states, priorities, properties, sprints, versions, boards, entries, swimlanes] = await Promise.all([
+            requested("types")
+                ? this.catalog("/v1/project/work_item/types", projectQuery, namedCatalogSchema)
+                : Promise.resolve(notRequested("本次未请求 types 目录")),
+            requested("states")
+                ? input.workItemTypeId
+                    ? this.catalog("/v1/project/work_item/states", typedProjectQuery, namedCatalogSchema)
+                    : Promise.resolve(notRequested("请先选择 work_item_type_id"))
+                : Promise.resolve(notRequested("本次未请求 states 目录")),
+            requested("priorities")
+                ? this.catalog("/v1/project/work_item/priorities", projectQuery, namedCatalogSchema)
+                : Promise.resolve(notRequested("本次未请求 priorities 目录")),
+            requested("properties")
+                ? input.workItemTypeId
+                    ? this.catalog("/v1/project/work_item/properties", typedProjectQuery, propertyCatalogSchema)
+                    : Promise.resolve(notRequested("请先选择 work_item_type_id"))
+                : Promise.resolve(notRequested("本次未请求 properties 目录")),
+            requested("sprints")
+                ? this.catalog(`/v1/project/projects/${encodeURIComponent(input.projectId)}/sprints`, { page_size: 100 }, namedCatalogSchema)
+                : Promise.resolve(notRequested("本次未请求 sprints 目录")),
+            requested("versions")
+                ? this.catalog(`/v1/project/projects/${encodeURIComponent(input.projectId)}/versions`, { page_size: 100 }, namedCatalogSchema)
+                : Promise.resolve(notRequested("本次未请求 versions 目录")),
+            requested("boards")
+                ? this.catalog(`/v1/project/projects/${encodeURIComponent(input.projectId)}/boards`, { page_size: 100 }, namedCatalogSchema)
+                : Promise.resolve(notRequested("本次未请求 boards 目录")),
+            requested("entries")
+                ? boardPath
+                    ? this.catalog(`${boardPath}/entries`, { page_size: 100 }, namedCatalogSchema)
+                    : Promise.resolve(notRequested("请先选择 board_id"))
+                : Promise.resolve(notRequested("本次未请求 entries 目录")),
+            requested("swimlanes")
+                ? boardPath
+                    ? this.catalog(`${boardPath}/swimlanes`, { page_size: 100 }, namedCatalogSchema)
+                    : Promise.resolve(notRequested("请先选择 board_id"))
+                : Promise.resolve(notRequested("本次未请求 swimlanes 目录")),
+        ]);
+        const catalogs = { types, states, priorities, properties, sprints, versions, boards, entries, swimlanes };
+        const projectError = Object.values(catalogs).find((catalog) => !catalog.available && catalog.message.includes("[100300]") && catalog.message.includes("project"));
+        if (projectError && !projectError.available) {
+            throw new PingCodeError(`项目 ${input.projectId} 不存在或当前凭据无法访问`, "NOT_FOUND");
+        }
+        return catalogs;
+    }
+    async getTestCaseMetadata(testLibraryId, include) {
+        const requested = (catalog) => include === undefined || include.includes(catalog);
+        const [suites, states, types, importantLevels, properties] = await Promise.all([
+            requested("suites")
+                ? this.catalog(`/v1/testhub/libraries/${encodeURIComponent(testLibraryId)}/suites`, { page_size: 100 }, namedCatalogSchema)
+                : Promise.resolve(notRequested("本次未请求 suites 目录")),
+            requested("states")
+                ? this.catalog("/v1/testhub/case_states", { page_size: 100 }, namedCatalogSchema)
+                : Promise.resolve(notRequested("本次未请求 states 目录")),
+            requested("types")
+                ? this.catalog("/v1/testhub/case_types", { page_size: 100 }, namedCatalogSchema)
+                : Promise.resolve(notRequested("本次未请求 types 目录")),
+            requested("important_levels")
+                ? this.catalog("/v1/testhub/case_important_levels", { page_size: 100 }, namedCatalogSchema)
+                : Promise.resolve(notRequested("本次未请求 important_levels 目录")),
+            requested("properties")
+                ? this.catalog("/v1/testhub/case_properties", { page_size: 100 }, propertyCatalogSchema)
+                : Promise.resolve(notRequested("本次未请求 properties 目录")),
+        ]);
+        return { suites, states, types, importantLevels, properties };
+    }
+    async catalog(path, query, schema) {
+        try {
+            const parsed = schema.parse(await this.client.get(path, query));
+            return { available: true, values: parsed.values };
+        }
+        catch (error) {
+            if (error instanceof PingCodeError) {
+                return { available: false, errorCode: error.code, message: error.message };
+            }
+            throw error;
+        }
+    }
+}
+function listQuery(input) {
+    return {
+        keywords: input.keywords,
+        page_index: input.pageIndex,
+        page_size: input.pageSize ?? 100,
+        include_deleted: input.includeDeleted ?? false,
+        include_archived: input.includeArchived ?? false,
+    };
+}
+function notRequested(message) {
+    return { available: false, errorCode: "SELECTION_REQUIRED", message };
+}
+//# sourceMappingURL=metadata-source.js.map

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

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

package/dist/sources/project-context-source.d.ts

@@ -0,0 +1,61 @@
+import { z } from "zod";
+declare const CONTEXT_RELATIVE_PATH = ".pingcode-mcp/context.json";
+declare const selectionSchema: z.ZodObject<{
+    id: z.ZodString;
+    identifier: z.ZodString;
+    name: z.ZodString;
+}, z.core.$strict>;
+export declare const projectContextSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    pingcode: z.ZodObject<{
+        project: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            identifier: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strict>>;
+        shipProduct: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            identifier: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strict>>;
+        testLibrary: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            identifier: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type ProjectContext = z.infer<typeof projectContextSchema>;
+export type ProjectContextResource = keyof ProjectContext["pingcode"];
+export type ProjectContextSelection = z.infer<typeof selectionSchema>;
+export interface ProjectRoot {
+    uri: string;
+    name?: string;
+}
+export interface ProjectRootProvider {
+    listRoots(): Promise<{
+        roots: ProjectRoot[];
+    }>;
+}
+export interface LoadedProjectContext {
+    context: ProjectContext;
+    source: {
+        rootUri: string;
+        rootName: string | null;
+        path: typeof CONTEXT_RELATIVE_PATH;
+    };
+}
+export declare class ProjectContextSource {
+    private readonly roots;
+    private readonly maxBytes;
+    constructor(roots: ProjectRootProvider, maxBytes?: number);
+    get(): Promise<LoadedProjectContext>;
+    save(resource: ProjectContextResource, selection: ProjectContextSelection): Promise<LoadedProjectContext>;
+    private resolveSaveRoot;
+    private readRoot;
+    private rootPath;
+    private safeRealpath;
+    private invalidFileError;
+}
+export {};
+//# sourceMappingURL=project-context-source.d.ts.map

package/dist/sources/project-context-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-context-source.d.ts","sourceRoot":"","sources":["../../src/sources/project-context-source.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,QAAA,MAAM,qBAAqB,+BAA+B,CAAC;AAE3D,QAAA,MAAM,eAAe;;;;kBAMV,CAAC;AAEZ,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;kBAe9B,CAAC;AAEJ,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,sBAAsB,GAAG,MAAM,cAAc,CAAC,UAAU,CAAC,CAAC;AACtE,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAEtE,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,WAAW,EAAE,CAAA;KAAE,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,IAAI,EAAE,OAAO,qBAAqB,CAAC;KACpC,CAAC;CACH;AAED,qBAAa,oBAAoB;IAE7B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBADR,KAAK,EAAE,mBAAmB,EAC1B,QAAQ,SAAoB;IAGzC,GAAG,IAAI,OAAO,CAAC,oBAAoB,CAAC;IA+BpC,IAAI,CACR,QAAQ,EAAE,sBAAsB,EAChC,SAAS,EAAE,uBAAuB,GACjC,OAAO,CAAC,oBAAoB,CAAC;YA8DlB,eAAe;YAiBf,QAAQ;IA0DtB,OAAO,CAAC,QAAQ;YAsBF,YAAY;IAW1B,OAAO,CAAC,gBAAgB;CAMzB"}

package/dist/sources/project-context-source.js

@@ -0,0 +1,224 @@
+import { mkdir, readFile, realpath, rename, stat, lstat, unlink, writeFile } from "node:fs/promises";
+import { fileURLToPath } from "node:url";
+import { isAbsolute, join, relative, resolve } from "node:path";
+import { randomUUID } from "node:crypto";
+import { z } from "zod";
+import { PingCodeError } from "../pingcode/errors.js";
+const MAX_CONTEXT_BYTES = 64 * 1024;
+const CONTEXT_RELATIVE_PATH = ".pingcode-mcp/context.json";
+const selectionSchema = z
+    .object({
+    id: z.string().trim().min(1).max(200),
+    identifier: z.string().trim().min(1).max(200),
+    name: z.string().trim().min(1).max(500),
+})
+    .strict();
+export const projectContextSchema = z
+    .object({
+    version: z.literal(1),
+    pingcode: z
+        .object({
+        project: selectionSchema.optional(),
+        shipProduct: selectionSchema.optional(),
+        testLibrary: selectionSchema.optional(),
+    })
+        .strict(),
+})
+    .strict()
+    .refine((value) => Object.values(value.pingcode).some((selection) => selection !== undefined), "至少配置一个 PingCode 项目、Ship 产品或 Test Library");
+export class ProjectContextSource {
+    roots;
+    maxBytes;
+    constructor(roots, maxBytes = MAX_CONTEXT_BYTES) {
+        this.roots = roots;
+        this.maxBytes = maxBytes;
+    }
+    async get() {
+        let rootList;
+        try {
+            rootList = await this.roots.listRoots();
+        }
+        catch (error) {
+            throw new PingCodeError("当前 MCP Client 未提供可读取的工作区根目录", "PROJECT_CONTEXT_INVALID", { cause: error });
+        }
+        const candidates = rootList.roots.map((root) => this.readRoot(root));
+        const loaded = (await Promise.all(candidates)).filter((value) => value !== null);
+        if (loaded.length === 0) {
+            throw new PingCodeError(`未找到 ${CONTEXT_RELATIVE_PATH}；请先由 Agent 或用户在当前项目创建该文件`, "PROJECT_CONTEXT_INVALID");
+        }
+        if (loaded.length > 1) {
+            throw new PingCodeError(`当前工作区存在多个 ${CONTEXT_RELATIVE_PATH}，无法自动判断使用哪一份`, "PROJECT_CONTEXT_INVALID");
+        }
+        return loaded[0];
+    }
+    async save(resource, selection) {
+        let rootList;
+        try {
+            rootList = await this.roots.listRoots();
+        }
+        catch (error) {
+            throw new PingCodeError("当前 MCP Client 未提供可写入的工作区根目录", "PROJECT_CONTEXT_INVALID", { cause: error });
+        }
+        const root = await this.resolveSaveRoot(rootList.roots);
+        const rootPath = this.rootPath(root.uri);
+        const rootRealPath = await this.safeRealpath(rootPath);
+        if (!rootRealPath) {
+            throw new PingCodeError("当前工作区根目录不存在，无法保存 PingCode 上下文", "PROJECT_CONTEXT_INVALID");
+        }
+        const contextDirectory = join(rootRealPath, ".pingcode-mcp");
+        await mkdir(contextDirectory, { recursive: true, mode: 0o700 });
+        const directoryStat = await lstat(contextDirectory).catch(() => null);
+        if (!directoryStat || !directoryStat.isDirectory() || directoryStat.isSymbolicLink()) {
+            throw new PingCodeError(".pingcode-mcp 必须是当前工作区内的真实目录，拒绝写入链接路径", "PROJECT_CONTEXT_INVALID");
+        }
+        const contextPath = join(contextDirectory, "context.json");
+        const existing = await this.readRoot(root);
+        const nextContext = projectContextSchema.parse({
+            version: 1,
+            pingcode: {
+                ...(existing?.context.pingcode ?? {}),
+                [resource]: selection,
+            },
+        });
+        const existingFile = await lstat(contextPath).catch(() => null);
+        if (existingFile?.isSymbolicLink() || (existingFile !== null && !existingFile.isFile())) {
+            throw new PingCodeError(".pingcode-mcp/context.json 必须是当前工作区内的普通文件，拒绝覆盖链接或特殊文件", "PROJECT_CONTEXT_INVALID");
+        }
+        const temporaryPath = join(contextDirectory, `.context.json.${randomUUID()}.tmp`);
+        try {
+            await writeFile(temporaryPath, `${JSON.stringify(nextContext, null, 2)}\n`, {
+                encoding: "utf8",
+                mode: 0o600,
+                flag: "wx",
+            });
+            await rename(temporaryPath, contextPath);
+        }
+        catch (error) {
+            await unlink(temporaryPath).catch(() => undefined);
+            throw new PingCodeError("保存 .pingcode-mcp/context.json 失败，未完成上下文更新", "PROJECT_CONTEXT_INVALID", { cause: error });
+        }
+        return {
+            context: nextContext,
+            source: {
+                rootUri: root.uri,
+                rootName: root.name ?? null,
+                path: CONTEXT_RELATIVE_PATH,
+            },
+        };
+    }
+    async resolveSaveRoot(roots) {
+        if (roots.length === 1 && roots[0])
+            return roots[0];
+        const loaded = (await Promise.all(roots.map((root) => this.readRoot(root)))).filter((value) => value !== null);
+        if (loaded.length === 1) {
+            const match = roots.find((root) => root.uri === loaded[0]?.source.rootUri);
+            if (match)
+                return match;
+        }
+        throw new PingCodeError(roots.length === 0
+            ? "当前 MCP Client 未提供工作区根目录，无法保存 PingCode 上下文"
+            : "当前工作区有多个根目录且无法唯一确定上下文保存位置；请只保留一个工作区根目录后重试", "PROJECT_CONTEXT_INVALID");
+    }
+    async readRoot(root) {
+        const rootPath = this.rootPath(root.uri);
+        const rootRealPath = await this.safeRealpath(rootPath);
+        if (!rootRealPath) {
+            return null;
+        }
+        const contextPath = join(rootRealPath, CONTEXT_RELATIVE_PATH);
+        let contextRealPath;
+        try {
+            contextRealPath = await realpath(contextPath);
+        }
+        catch (error) {
+            if (isMissingFile(error)) {
+                return null;
+            }
+            throw this.invalidFileError();
+        }
+        if (!isWithin(rootRealPath, contextRealPath)) {
+            throw this.invalidFileError();
+        }
+        let fileStat;
+        try {
+            fileStat = await stat(contextRealPath);
+        }
+        catch {
+            throw this.invalidFileError();
+        }
+        if (!fileStat.isFile() || fileStat.size > this.maxBytes) {
+            throw this.invalidFileError();
+        }
+        let raw;
+        try {
+            raw = await readFile(contextRealPath, "utf8");
+        }
+        catch {
+            throw this.invalidFileError();
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch {
+            throw this.invalidFileError();
+        }
+        const result = projectContextSchema.safeParse(parsed);
+        if (!result.success) {
+            throw this.invalidFileError();
+        }
+        return {
+            context: result.data,
+            source: {
+                rootUri: root.uri,
+                rootName: root.name ?? null,
+                path: CONTEXT_RELATIVE_PATH,
+            },
+        };
+    }
+    rootPath(uri) {
+        let parsed;
+        try {
+            parsed = new URL(uri);
+        }
+        catch {
+            throw this.invalidFileError();
+        }
+        if (parsed.protocol !== "file:" || (parsed.hostname !== "" && parsed.hostname !== "localhost")) {
+            throw this.invalidFileError();
+        }
+        let path;
+        try {
+            path = fileURLToPath(parsed);
+        }
+        catch {
+            throw this.invalidFileError();
+        }
+        if (!isAbsolute(path)) {
+            throw this.invalidFileError();
+        }
+        return resolve(path);
+    }
+    async safeRealpath(path) {
+        try {
+            return await realpath(path);
+        }
+        catch (error) {
+            if (isMissingFile(error)) {
+                return null;
+            }
+            throw this.invalidFileError();
+        }
+    }
+    invalidFileError() {
+        return new PingCodeError(`${CONTEXT_RELATIVE_PATH} 不存在、格式无效或超出允许的文件范围`, "PROJECT_CONTEXT_INVALID");
+    }
+}
+function isWithin(rootPath, childPath) {
+    const childRelative = relative(rootPath, childPath);
+    return childRelative === "" || (!childRelative.startsWith("..") && !isAbsolute(childRelative));
+}
+function isMissingFile(error) {
+    return Boolean(error && typeof error === "object" && "code" in error && error.code === "ENOENT");
+}
+//# sourceMappingURL=project-context-source.js.map

package/dist/sources/project-context-source.js.map

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

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

@@ -0,0 +1,83 @@
+import type { PingCodeWriteClientLike } from "../pingcode/client.js";
+import { type Relation } from "../pingcode/schemas.js";
+/** Resource types accepted by the official Relation response/list contract. */
+export declare const traceableResourceTypes: readonly ["idea", "ticket", "work_item", "test_plan", "test_run", "test_case", "page"];
+export type TraceableResourceType = (typeof traceableResourceTypes)[number];
+export interface RelationListInput {
+    principalType: TraceableResourceType;
+    principalId: string;
+    targetType: TraceableResourceType;
+    pageIndex?: number;
+    pageSize?: number;
+}
+type ExactRelationInput = RelationListInput & {
+    targetType: TraceableResourceType;
+    targetId: string;
+};
+export interface RelationResourceSummary {
+    type: TraceableResourceType;
+    id: string;
+    identifier: string | null;
+    title: string;
+    /** Work Item subtype required by the official Relation write contract. */
+    workItemType?: string;
+}
+export interface RelationCreateFields {
+    principalType: Exclude<TraceableResourceType, "page">;
+    principalId: string;
+    targetType: TraceableResourceType;
+    targetId: string;
+}
+export declare class RelationSource {
+    private readonly client;
+    constructor(client: PingCodeWriteClientLike);
+    listRelations(input: RelationListInput): Promise<{
+        page_size: number;
+        page_index: number;
+        total: number;
+        values: {
+            [x: string]: unknown;
+            id: string;
+            url: string;
+            principal_type: string;
+            target_type: string;
+            principal_id?: string | undefined;
+            principal?: {
+                [x: string]: unknown;
+                id: string;
+            } | undefined;
+            target_id?: string | undefined;
+            target?: {
+                [x: string]: unknown;
+                id: string;
+            } | undefined;
+        }[];
+    }>;
+    getRelation(relationId: string): Promise<Relation>;
+    findExactRelation(input: ExactRelationInput): Promise<{
+        [x: string]: unknown;
+        id: string;
+        url: string;
+        principal_type: string;
+        target_type: string;
+        principal_id?: string | undefined;
+        principal?: {
+            [x: string]: unknown;
+            id: string;
+        } | undefined;
+        target_id?: string | undefined;
+        target?: {
+            [x: string]: unknown;
+            id: string;
+        } | undefined;
+    } | null>;
+    createRelation(fields: RelationCreateFields): Promise<Relation>;
+    deleteRelation(relationId: string): Promise<void>;
+    readResource(type: TraceableResourceType, id: string): Promise<RelationResourceSummary>;
+}
+export declare function isSupportedRelationReadPair(principalType: TraceableResourceType, targetType: TraceableResourceType): boolean;
+export declare function isSupportedRelationWritePair(principalType: TraceableResourceType, targetType: TraceableResourceType): principalType is Exclude<TraceableResourceType, "page">;
+export declare function relationPrincipalResourceId(relation: Relation): string | undefined;
+export declare function relationTargetResourceId(relation: Relation): string | undefined;
+export {};
+//# sourceMappingURL=relation-source.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"relation-source.d.ts","sourceRoot":"","sources":["../../src/sources/relation-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAErE,OAAO,EAOL,KAAK,QAAQ,EACd,MAAM,wBAAwB,CAAC;AAEhC,+EAA+E;AAC/E,eAAO,MAAM,sBAAsB,wFAQzB,CAAC;AACX,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5E,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,qBAAqB,CAAC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,qBAAqB,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAYD,KAAK,kBAAkB,GAAG,iBAAiB,GAAG;IAC5C,UAAU,EAAE,qBAAqB,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,qBAAqB,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,uBAAuB;IAEtD,aAAa,CAAC,KAAK,EAAE,iBAAiB;;;;;;;;;;;;;;;;;;;;;;IAkBtC,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAMlD,iBAAiB,CACrB,KAAK,EAAE,kBAAkB;;;;;;;;;;;;;;;;;IAiBrB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAkB/D,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOjD,YAAY,CAAC,IAAI,EAAE,qBAAqB,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;CAyC9F;AAED,wBAAgB,2BAA2B,CACzC,aAAa,EAAE,qBAAqB,EACpC,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAET;AAED,wBAAgB,4BAA4B,CAC1C,aAAa,EAAE,qBAAqB,EACpC,UAAU,EAAE,qBAAqB,GAChC,aAAa,IAAI,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAWzD;AAED,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAElF;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAE/E"}