@cvtoolman/pingcode-cli 0.2.0

package/dist/client/auth.js

@@ -0,0 +1,159 @@
+/**
+ * PingCode OAuth 认证管理器
+ *
+ * 支持两种认证模式：
+ * - client: 客户端凭证模式（应用级别）
+ * - user: 授权码模式（用户级别）
+ */
+import 'dotenv/config';
+import { TokenStore } from './token-store.js';
+export class PingCodeAuth {
+    apiRoot;
+    authMode;
+    clientId;
+    clientSecret;
+    tokenStore;
+    accessToken;
+    refreshTokenValue;
+    expiresAt;
+    constructor(options = {}) {
+        this.apiRoot = (options.apiRoot || process.env.PINGCODE_API_ROOT || 'https://open.pingcode.com').replace(/\/+$/, '');
+        this.authMode = options.authMode || process.env.PINGCODE_AUTH_MODE || 'client';
+        this.tokenStore = new TokenStore(options.tokenFile || process.env.PINGCODE_TOKEN_FILE || '.pingcode_token.json');
+        if (this.authMode === 'user') {
+            this.clientId = options.clientId || process.env.PINGCODE_USER_CLIENT_ID;
+            this.clientSecret = options.clientSecret || process.env.PINGCODE_USER_CLIENT_SECRET;
+        }
+        else {
+            this.clientId = options.clientId || process.env.PINGCODE_CLIENT_ID;
+            this.clientSecret = options.clientSecret || process.env.PINGCODE_CLIENT_SECRET;
+        }
+        this.refreshTokenValue = options.refreshToken;
+        this._loadTokens();
+        if (this.accessToken && this.isTokenValid)
+            return;
+        if (options.code) {
+            // 不在构造函数中 await，延迟到 getToken
+        }
+    }
+    get isTokenValid() {
+        if (!this.accessToken || !this.expiresAt)
+            return false;
+        return Date.now() / 1000 < this.expiresAt - 86400;
+    }
+    getAuthorizeUrl() {
+        if (!this.clientId) {
+            throw new Error('缺少 client_id，请检查 PINGCODE_USER_CLIENT_ID 配置');
+        }
+        return `${this.apiRoot}/oauth2/authorize?response_type=code&client_id=${this.clientId}`;
+    }
+    _loadTokens() {
+        const data = this.tokenStore.load();
+        if (!data)
+            return;
+        if (data.auth_mode && data.auth_mode !== this.authMode)
+            return;
+        this.accessToken = data.access_token;
+        this.refreshTokenValue = data.refresh_token ?? this.refreshTokenValue;
+        this.expiresAt = data.expires_at;
+    }
+    _saveTokens() {
+        if (!this.accessToken)
+            return;
+        this.tokenStore.save({
+            access_token: this.accessToken,
+            refresh_token: this.refreshTokenValue,
+            expires_at: this.expiresAt,
+            auth_mode: this.authMode,
+            updated_at: Date.now() / 1000,
+        });
+    }
+    async getUserToken(code) {
+        if (!this.clientId || !this.clientSecret) {
+            throw new Error('缺少授权码模式的凭据，请在 .env 中配置：\n  PINGCODE_USER_CLIENT_ID=xxx\n  PINGCODE_USER_CLIENT_SECRET=xxx');
+        }
+        const url = `${this.apiRoot}/v1/auth/token?grant_type=authorization_code&client_id=${this.clientId}&client_secret=${this.clientSecret}&code=${code}`;
+        const res = await fetch(url, { method: 'GET', signal: AbortSignal.timeout(10000) });
+        if (!res.ok)
+            throw new Error(`获取用户令牌失败: HTTP ${res.status} - ${await res.text()}`);
+        const result = await res.json();
+        if (!result.access_token)
+            throw new Error('API 返回的响应中缺少 access_token');
+        this.accessToken = result.access_token;
+        this.refreshTokenValue = result.refresh_token;
+        if (result.expires_in)
+            this.expiresAt = result.expires_in;
+        this._saveTokens();
+        return result;
+    }
+    async getClientToken() {
+        if (!this.clientId || !this.clientSecret) {
+            throw new Error('缺少客户端凭证，请在 .env 中配置：\n  PINGCODE_CLIENT_ID=xxx\n  PINGCODE_CLIENT_SECRET=xxx');
+        }
+        const url = `${this.apiRoot}/v1/auth/token?grant_type=client_credentials&client_id=${this.clientId}&client_secret=${this.clientSecret}`;
+        const res = await fetch(url, { method: 'GET', signal: AbortSignal.timeout(10000) });
+        if (!res.ok)
+            throw new Error(`获取客户端令牌失败: HTTP ${res.status} - ${await res.text()}`);
+        const result = await res.json();
+        if (!result.access_token)
+            throw new Error('API 返回的响应中缺少 access_token');
+        this.accessToken = result.access_token;
+        if (result.expires_in)
+            this.expiresAt = result.expires_in;
+        this._saveTokens();
+        return result;
+    }
+    async refreshUserToken() {
+        if (!this.refreshTokenValue) {
+            throw new Error('没有 refresh_token，无法刷新。请重新获取授权码');
+        }
+        const url = `${this.apiRoot}/v1/auth/token?grant_type=refresh_token&refresh_token=${this.refreshTokenValue}`;
+        const res = await fetch(url, { method: 'GET', signal: AbortSignal.timeout(10000) });
+        if (!res.ok)
+            throw new Error(`刷新用户令牌失败: HTTP ${res.status} - ${await res.text()}`);
+        const result = await res.json();
+        if (!result.access_token)
+            throw new Error('API 返回的响应中缺少 access_token');
+        this.accessToken = result.access_token;
+        if (result.expires_in)
+            this.expiresAt = result.expires_in;
+        this._saveTokens();
+        return result;
+    }
+    async getToken() {
+        if (!this.accessToken) {
+            if (this.authMode === 'user') {
+                throw new Error(`当前为授权码模式，但未找到有效令牌。\n\n请运行 pingcode-cli auth login 重新登录`);
+            }
+            else {
+                if (this.clientId && this.clientSecret) {
+                    await this.getClientToken();
+                }
+                else {
+                    throw new Error('未配置认证信息。请运行 pingcode-cli auth login 进行配置');
+                }
+            }
+        }
+        // 检查是否需要刷新（提前 1 天刷新）
+        if (this.expiresAt && Date.now() / 1000 >= this.expiresAt - 86400) {
+            if (this.refreshTokenValue) {
+                await this.refreshUserToken();
+            }
+            else if (this.authMode === 'client') {
+                await this.getClientToken();
+            }
+            else {
+                throw new Error(`用户令牌已过期且无 refresh_token。\n请运行 pingcode-cli auth login 重新登录`);
+            }
+        }
+        return this.accessToken;
+    }
+    async getHeaders() {
+        const token = await this.getToken();
+        return {
+            'Authorization': `Bearer ${token}`,
+            'Content-Type': 'application/json',
+        };
+    }
+}
+//# sourceMappingURL=auth.js.map

package/dist/client/auth.js.map

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

package/dist/client/client.d.ts

@@ -0,0 +1,46 @@
+/**
+ * PingCode API 主客户端
+ */
+import 'dotenv/config';
+import { PingCodeAuth } from './auth.js';
+import type { PingCodeClientOptions, PaginatedResponse } from './types.js';
+export declare class PingCodeClient {
+    readonly apiRoot: string;
+    readonly orgId?: string;
+    readonly productId?: string;
+    readonly auth: PingCodeAuth;
+    private _stories?;
+    private _workItems?;
+    private _sprints?;
+    private _deliverables?;
+    private _wiki?;
+    private _myself?;
+    private _comments?;
+    constructor(options?: PingCodeClientOptions);
+    private _lazyLoad;
+    private _subApisLoaded;
+    initSubApis(): Promise<void>;
+    get stories(): any;
+    get workItems(): any;
+    get sprints(): any;
+    get deliverables(): any;
+    get wiki(): any;
+    get myself(): any;
+    get comments(): any;
+    private _request;
+    get<T = any>(endpoint: string, params?: Record<string, any>): Promise<T>;
+    post<T = any>(endpoint: string, jsonData?: Record<string, any>): Promise<T>;
+    put<T = any>(endpoint: string, jsonData?: Record<string, any>): Promise<T>;
+    patch<T = any>(endpoint: string, jsonData?: Record<string, any>): Promise<T>;
+    delete<T = any>(endpoint: string): Promise<T>;
+    private _clampPageSize;
+    listProducts(pageIndex?: number, pageSize?: number): Promise<PaginatedResponse>;
+    getProduct(productId: string): Promise<any>;
+    listProjects(pageIndex?: number, pageSize?: number): Promise<PaginatedResponse>;
+    getProject(projectId: string): Promise<any>;
+    getProjectProperties(projectId: string): Promise<any>;
+    listProjectMembers(projectId: string, pageIndex?: number, pageSize?: number): Promise<PaginatedResponse>;
+    listEnterpriseUsers(pageIndex?: number, pageSize?: number): Promise<PaginatedResponse>;
+    getUser(userId: string): Promise<any>;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE3E,qBAAa,cAAc;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAE5B,OAAO,CAAC,QAAQ,CAAC,CAAM;IACvB,OAAO,CAAC,UAAU,CAAC,CAAM;IACzB,OAAO,CAAC,QAAQ,CAAC,CAAM;IACvB,OAAO,CAAC,aAAa,CAAC,CAAM;IAC5B,OAAO,CAAC,KAAK,CAAC,CAAM;IACpB,OAAO,CAAC,OAAO,CAAC,CAAM;IACtB,OAAO,CAAC,SAAS,CAAC,CAAM;gBAEZ,OAAO,GAAE,qBAA0B;YAkBjC,SAAS;IAWvB,OAAO,CAAC,cAAc,CAAS;IAEzB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBlC,IAAI,OAAO,QAA6B;IACxC,IAAI,SAAS,QAA+B;IAC5C,IAAI,OAAO,QAA6B;IACxC,IAAI,YAAY,QAAkC;IAClD,IAAI,IAAI,QAA0B;IAClC,IAAI,MAAM,QAA4B;IACtC,IAAI,QAAQ,QAA8B;YAI5B,QAAQ;IA2ChB,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAIxE,IAAI,CAAC,CAAC,GAAG,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAI3E,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAI1E,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAI5E,MAAM,CAAC,CAAC,GAAG,GAAG,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAMnD,OAAO,CAAC,cAAc;IAIhB,YAAY,CAAC,SAAS,SAAI,EAAE,QAAQ,SAAK,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAItE,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAI3C,YAAY,CAAC,SAAS,SAAI,EAAE,QAAQ,SAAK,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAItE,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAI3C,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAIrD,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,SAAI,EAAE,QAAQ,SAAK,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAI/F,mBAAmB,CAAC,SAAS,SAAI,EAAE,QAAQ,SAAK,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAI7E,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;CAG5C"}

package/dist/client/client.js

@@ -0,0 +1,157 @@
+/**
+ * PingCode API 主客户端
+ */
+import 'dotenv/config';
+import { PingCodeAuth } from './auth.js';
+import { AuthenticationError, ApiError } from './errors.js';
+export class PingCodeClient {
+    apiRoot;
+    orgId;
+    productId;
+    auth;
+    _stories;
+    _workItems;
+    _sprints;
+    _deliverables;
+    _wiki;
+    _myself;
+    _comments;
+    constructor(options = {}) {
+        this.apiRoot = (options.apiRoot || process.env.PINGCODE_API_ROOT || 'https://open.pingcode.com').replace(/\/+$/, '');
+        this.orgId = options.orgId || process.env.PINGCODE_ORG_ID;
+        this.productId = options.productId || process.env.PINGCODE_PRODUCT_ID;
+        this.auth = new PingCodeAuth({
+            clientId: options.clientId,
+            clientSecret: options.clientSecret,
+            apiRoot: this.apiRoot,
+            code: options.code,
+            refreshToken: options.refreshToken,
+            authMode: options.authMode,
+        });
+    }
+    // ============== 延迟加载子 API ==============
+    // 子 API 在首次访问时通过动态 import 加载并缓存
+    // 使用 any 类型避免循环依赖，实际类型在 index.ts 中导出
+    async _lazyLoad(field, modulePath, className) {
+        if (this[field])
+            return this[field];
+        const mod = await import(modulePath);
+        this[field] = new mod[className](this);
+        return this[field];
+    }
+    // 同步 getter 使用缓存实例（需先调用对应 init 方法或直接使用 async 版本）
+    // 为了保持与 Python 版本的 API 兼容性，提供同步 getter
+    // 子 API 模块会在 initSubApis() 中预加载
+    _subApisLoaded = false;
+    async initSubApis() {
+        if (this._subApisLoaded)
+            return;
+        const [stories, workItems, sprints, deliverables, wiki, myself, comments] = await Promise.all([
+            import('./api/stories.js'),
+            import('./api/work-items.js'),
+            import('./api/sprints.js'),
+            import('./api/deliverables.js'),
+            import('./api/wiki.js'),
+            import('./api/myself.js'),
+            import('./api/comments.js'),
+        ]);
+        this._stories = new stories.StoriesAPI(this);
+        this._workItems = new workItems.WorkItemsAPI(this);
+        this._sprints = new sprints.SprintsAPI(this);
+        this._deliverables = new deliverables.DeliverablesAPI(this);
+        this._wiki = new wiki.WikiAPI(this);
+        this._myself = new myself.MyselfAPI(this);
+        this._comments = new comments.CommentsAPI(this);
+        this._subApisLoaded = true;
+    }
+    get stories() { return this._stories; }
+    get workItems() { return this._workItems; }
+    get sprints() { return this._sprints; }
+    get deliverables() { return this._deliverables; }
+    get wiki() { return this._wiki; }
+    get myself() { return this._myself; }
+    get comments() { return this._comments; }
+    // ============== HTTP 方法 ==============
+    async _request(method, endpoint, params, jsonData) {
+        let url = `${this.apiRoot}${endpoint}`;
+        if (params && Object.keys(params).length > 0) {
+            const qs = new URLSearchParams();
+            for (const [k, v] of Object.entries(params)) {
+                if (v !== undefined && v !== null)
+                    qs.append(k, String(v));
+            }
+            url += `?${qs.toString()}`;
+        }
+        const headers = await this.auth.getHeaders();
+        const init = {
+            method,
+            headers,
+            signal: AbortSignal.timeout(30000),
+        };
+        if (jsonData && ['POST', 'PUT', 'PATCH'].includes(method)) {
+            init.body = JSON.stringify(jsonData);
+        }
+        let res;
+        try {
+            res = await fetch(url, init);
+        }
+        catch (err) {
+            throw new ApiError(`网络请求失败: ${err.message}`, 0);
+        }
+        if (!res.ok) {
+            const text = await res.text().catch(() => '');
+            if (res.status === 401 || res.status === 403) {
+                const lower = text.toLowerCase();
+                if (lower.includes('token') || lower.includes('unauthorized') || lower.includes('forbidden')) {
+                    throw new AuthenticationError('认证失败：访问令牌无效或已过期\n\n请尝试以下步骤：\n1. 运行 \'pingcode-cli auth status\' 检查当前认证状态\n2. 运行 \'pingcode-cli auth login\' 重新登录');
+                }
+            }
+            throw new ApiError(`API 请求失败: HTTP ${res.status}`, res.status, text);
+        }
+        return res.json();
+    }
+    async get(endpoint, params) {
+        return this._request('GET', endpoint, params);
+    }
+    async post(endpoint, jsonData) {
+        return this._request('POST', endpoint, undefined, jsonData);
+    }
+    async put(endpoint, jsonData) {
+        return this._request('PUT', endpoint, undefined, jsonData);
+    }
+    async patch(endpoint, jsonData) {
+        return this._request('PATCH', endpoint, undefined, jsonData);
+    }
+    async delete(endpoint) {
+        return this._request('DELETE', endpoint);
+    }
+    // ============== 顶层便捷方法 ==============
+    _clampPageSize(pageSize) {
+        return Math.min(pageSize, 100);
+    }
+    async listProducts(pageIndex = 0, pageSize = 30) {
+        return this.get('/v1/scm/products', { page_index: pageIndex, page_size: this._clampPageSize(pageSize) });
+    }
+    async getProduct(productId) {
+        return this.get(`/v1/scm/products/${productId}`);
+    }
+    async listProjects(pageIndex = 0, pageSize = 30) {
+        return this.get('/v1/project/projects', { page_index: pageIndex, page_size: this._clampPageSize(pageSize) });
+    }
+    async getProject(projectId) {
+        return this.get(`/v1/project/projects/${projectId}`);
+    }
+    async getProjectProperties(projectId) {
+        return this.get(`/v1/project/projects/${projectId}/project_properties`);
+    }
+    async listProjectMembers(projectId, pageIndex = 0, pageSize = 30) {
+        return this.get(`/v1/project/projects/${projectId}/members`, { page_index: pageIndex, page_size: this._clampPageSize(pageSize) });
+    }
+    async listEnterpriseUsers(pageIndex = 0, pageSize = 30) {
+        return this.get('/v1/directory/users', { page_index: pageIndex, page_size: this._clampPageSize(pageSize) });
+    }
+    async getUser(userId) {
+        return this.get(`/v1/directory/users/${userId}`);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5D,MAAM,OAAO,cAAc;IAChB,OAAO,CAAS;IAChB,KAAK,CAAU;IACf,SAAS,CAAU;IACnB,IAAI,CAAe;IAEpB,QAAQ,CAAO;IACf,UAAU,CAAO;IACjB,QAAQ,CAAO;IACf,aAAa,CAAO;IACpB,KAAK,CAAO;IACZ,OAAO,CAAO;IACd,SAAS,CAAO;IAExB,YAAY,UAAiC,EAAE;QAC7C,IAAI,CAAC,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,2BAA2B,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACrH,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;QAC1D,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;QACtE,IAAI,CAAC,IAAI,GAAG,IAAI,YAAY,CAAC;YAC3B,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CAAC,CAAC;IACL,CAAC;IAED,0CAA0C;IAC1C,gCAAgC;IAChC,qCAAqC;IAE7B,KAAK,CAAC,SAAS,CAAI,KAAa,EAAE,UAAkB,EAAE,SAAiB;QAC7E,IAAK,IAAY,CAAC,KAAK,CAAC;YAAE,OAAQ,IAAY,CAAC,KAAK,CAAC,CAAC;QACtD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;QACpC,IAAY,CAAC,KAAK,CAAC,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC;QAChD,OAAQ,IAAY,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED,iDAAiD;IACjD,uCAAuC;IACvC,gCAAgC;IAExB,cAAc,GAAG,KAAK,CAAC;IAE/B,KAAK,CAAC,WAAW;QACf,IAAI,IAAI,CAAC,cAAc;YAAE,OAAO;QAChC,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC5F,MAAM,CAAC,kBAAkB,CAAC;YAC1B,MAAM,CAAC,qBAAqB,CAAC;YAC7B,MAAM,CAAC,kBAAkB,CAAC;YAC1B,MAAM,CAAC,uBAAuB,CAAC;YAC/B,MAAM,CAAC,eAAe,CAAC;YACvB,MAAM,CAAC,iBAAiB,CAAC;YACzB,MAAM,CAAC,mBAAmB,CAAC;SAC5B,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC,UAAU,GAAG,IAAI,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACnD,IAAI,CAAC,QAAQ,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC,aAAa,GAAG,IAAI,YAAY,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAC5D,IAAI,CAAC,KAAK,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,OAAO,GAAG,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,SAAS,GAAG,IAAI,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;IAC7B,CAAC;IAED,IAAI,OAAO,KAAK,OAAO,IAAI,CAAC,QAAS,CAAC,CAAC,CAAC;IACxC,IAAI,SAAS,KAAK,OAAO,IAAI,CAAC,UAAW,CAAC,CAAC,CAAC;IAC5C,IAAI,OAAO,KAAK,OAAO,IAAI,CAAC,QAAS,CAAC,CAAC,CAAC;IACxC,IAAI,YAAY,KAAK,OAAO,IAAI,CAAC,aAAc,CAAC,CAAC,CAAC;IAClD,IAAI,IAAI,KAAK,OAAO,IAAI,CAAC,KAAM,CAAC,CAAC,CAAC;IAClC,IAAI,MAAM,KAAK,OAAO,IAAI,CAAC,OAAQ,CAAC,CAAC,CAAC;IACtC,IAAI,QAAQ,KAAK,OAAO,IAAI,CAAC,SAAU,CAAC,CAAC,CAAC;IAE1C,wCAAwC;IAEhC,KAAK,CAAC,QAAQ,CAAU,MAAc,EAAE,QAAgB,EAAE,MAA4B,EAAE,QAA8B;QAC5H,IAAI,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,GAAG,QAAQ,EAAE,CAAC;QACvC,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7C,MAAM,EAAE,GAAG,IAAI,eAAe,EAAE,CAAC;YACjC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC5C,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI;oBAAE,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7D,CAAC;YACD,GAAG,IAAI,IAAI,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC;QAC7B,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAgB;YACxB,MAAM;YACN,OAAO;YACP,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC;SACnC,CAAC;QACF,IAAI,QAAQ,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1D,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACvC,CAAC;QAED,IAAI,GAAa,CAAC;QAClB,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,MAAM,IAAI,QAAQ,CAAC,WAAW,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;QAClD,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YAC9C,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjC,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;oBAC7F,MAAM,IAAI,mBAAmB,CAC3B,kHAAkH,CACnH,CAAC;gBACJ,CAAC;YACH,CAAC;YACD,MAAM,IAAI,QAAQ,CAAC,kBAAkB,GAAG,CAAC,MAAM,EAAE,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACvE,CAAC;QAED,OAAO,GAAG,CAAC,IAAI,EAAgB,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,GAAG,CAAU,QAAgB,EAAE,MAA4B;QAC/D,OAAO,IAAI,CAAC,QAAQ,CAAI,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,IAAI,CAAU,QAAgB,EAAE,QAA8B;QAClE,OAAO,IAAI,CAAC,QAAQ,CAAI,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IACjE,CAAC;IAED,KAAK,CAAC,GAAG,CAAU,QAAgB,EAAE,QAA8B;QACjE,OAAO,IAAI,CAAC,QAAQ,CAAI,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IAChE,CAAC;IAED,KAAK,CAAC,KAAK,CAAU,QAAgB,EAAE,QAA8B;QACnE,OAAO,IAAI,CAAC,QAAQ,CAAI,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,MAAM,CAAU,QAAgB;QACpC,OAAO,IAAI,CAAC,QAAQ,CAAI,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAED,uCAAuC;IAE/B,cAAc,CAAC,QAAgB;QACrC,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,SAAS,GAAG,CAAC,EAAE,QAAQ,GAAG,EAAE;QAC7C,OAAO,IAAI,CAAC,GAAG,CAAC,kBAAkB,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC3G,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,SAAiB;QAChC,OAAO,IAAI,CAAC,GAAG,CAAC,oBAAoB,SAAS,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,SAAS,GAAG,CAAC,EAAE,QAAQ,GAAG,EAAE;QAC7C,OAAO,IAAI,CAAC,GAAG,CAAC,sBAAsB,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC/G,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,SAAiB;QAChC,OAAO,IAAI,CAAC,GAAG,CAAC,wBAAwB,SAAS,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,oBAAoB,CAAC,SAAiB;QAC1C,OAAO,IAAI,CAAC,GAAG,CAAC,wBAAwB,SAAS,qBAAqB,CAAC,CAAC;IAC1E,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,SAAiB,EAAE,SAAS,GAAG,CAAC,EAAE,QAAQ,GAAG,EAAE;QACtE,OAAO,IAAI,CAAC,GAAG,CAAC,wBAAwB,SAAS,UAAU,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACpI,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,SAAS,GAAG,CAAC,EAAE,QAAQ,GAAG,EAAE;QACpD,OAAO,IAAI,CAAC,GAAG,CAAC,qBAAqB,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC9G,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,MAAc;QAC1B,OAAO,IAAI,CAAC,GAAG,CAAC,uBAAuB,MAAM,EAAE,CAAC,CAAC;IACnD,CAAC;CACF"}

package/dist/client/errors.d.ts

@@ -0,0 +1,15 @@
+/**
+ * PingCode 自定义异常体系
+ */
+export declare class PingCodeError extends Error {
+    constructor(message: string);
+}
+export declare class AuthenticationError extends PingCodeError {
+    constructor(message: string);
+}
+export declare class ApiError extends PingCodeError {
+    readonly statusCode: number;
+    readonly details?: string;
+    constructor(message: string, statusCode: number, details?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/client/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,aAAc,SAAQ,KAAK;gBAC1B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,mBAAoB,SAAQ,aAAa;gBACxC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,QAAS,SAAQ,aAAa;IACzC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;gBAEd,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAMlE"}

package/dist/client/errors.js

@@ -0,0 +1,26 @@
+/**
+ * PingCode 自定义异常体系
+ */
+export class PingCodeError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'PingCodeError';
+    }
+}
+export class AuthenticationError extends PingCodeError {
+    constructor(message) {
+        super(message);
+        this.name = 'AuthenticationError';
+    }
+}
+export class ApiError extends PingCodeError {
+    statusCode;
+    details;
+    constructor(message, statusCode, details) {
+        super(message);
+        this.name = 'ApiError';
+        this.statusCode = statusCode;
+        this.details = details;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/client/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/client/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,aAAa;IACpD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,MAAM,OAAO,QAAS,SAAQ,aAAa;IAChC,UAAU,CAAS;IACnB,OAAO,CAAU;IAE1B,YAAY,OAAe,EAAE,UAAkB,EAAE,OAAgB;QAC/D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF"}

package/dist/client/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * PingCode API Client — 导出入口
+ */
+export { PingCodeClient } from './client.js';
+export { PingCodeAuth } from './auth.js';
+export { TokenStore } from './token-store.js';
+export { PingCodeError, AuthenticationError, ApiError } from './errors.js';
+export { StoriesAPI } from './api/stories.js';
+export { WorkItemsAPI } from './api/work-items.js';
+export { SprintsAPI } from './api/sprints.js';
+export { DeliverablesAPI } from './api/deliverables.js';
+export { WikiAPI } from './api/wiki.js';
+export { MyselfAPI } from './api/myself.js';
+export { CommentsAPI } from './api/comments.js';
+export type * from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,mBAAmB,YAAY,CAAC"}

package/dist/client/index.js

@@ -0,0 +1,15 @@
+/**
+ * PingCode API Client — 导出入口
+ */
+export { PingCodeClient } from './client.js';
+export { PingCodeAuth } from './auth.js';
+export { TokenStore } from './token-store.js';
+export { PingCodeError, AuthenticationError, ApiError } from './errors.js';
+export { StoriesAPI } from './api/stories.js';
+export { WorkItemsAPI } from './api/work-items.js';
+export { SprintsAPI } from './api/sprints.js';
+export { DeliverablesAPI } from './api/deliverables.js';
+export { WikiAPI } from './api/wiki.js';
+export { MyselfAPI } from './api/myself.js';
+export { CommentsAPI } from './api/comments.js';
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/client/token-store.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 令牌持久化存储
+ */
+import type { TokenData } from './types.js';
+export declare class TokenStore {
+    private filePath;
+    constructor(filePath: string);
+    load(): TokenData | null;
+    save(data: TokenData): void;
+    clear(): void;
+}
+//# sourceMappingURL=token-store.d.ts.map

package/dist/client/token-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-store.d.ts","sourceRoot":"","sources":["../../src/client/token-store.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,EAAE,MAAM;IAI5B,IAAI,IAAI,SAAS,GAAG,IAAI;IAUxB,IAAI,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAM3B,KAAK,IAAI,IAAI;CASd"}

package/dist/client/token-store.js

@@ -0,0 +1,38 @@
+/**
+ * 令牌持久化存储
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+export class TokenStore {
+    filePath;
+    constructor(filePath) {
+        this.filePath = filePath;
+    }
+    load() {
+        try {
+            if (!fs.existsSync(this.filePath))
+                return null;
+            const raw = fs.readFileSync(this.filePath, 'utf-8');
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+    save(data) {
+        const dir = path.dirname(path.resolve(this.filePath));
+        fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(this.filePath, JSON.stringify(data, null, 2), 'utf-8');
+    }
+    clear() {
+        try {
+            if (fs.existsSync(this.filePath)) {
+                fs.unlinkSync(this.filePath);
+            }
+        }
+        catch {
+            // ignore
+        }
+    }
+}
+//# sourceMappingURL=token-store.js.map

package/dist/client/token-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-store.js","sourceRoot":"","sources":["../../src/client/token-store.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,MAAM,OAAO,UAAU;IACb,QAAQ,CAAS;IAEzB,YAAY,QAAgB;QAC1B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,IAAI;QACF,IAAI,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC/C,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACpD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAc,CAAC;QACtC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,IAAI,CAAC,IAAe;QAClB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;QACtD,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvC,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAC1E,CAAC;IAED,KAAK;QACH,IAAI,CAAC;YACH,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACjC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;CACF"}