cc-agentic-framework 1.14.1

package/dist/lib/confluence/confluence-client.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Confluence client configuration
+ */
+export interface ConfluenceClientConfig {
+    baseUrl: string;
+    email: string;
+    apiToken: string;
+}
+/**
+ * Atlassian Document Format (ADF) document structure
+ */
+export interface AdfDocument {
+    version: number;
+    type: string;
+    content: unknown[];
+}
+/**
+ * Confluence page representation
+ */
+export interface ConfluencePage {
+    id: string;
+    title: string;
+    spaceId: string;
+    status: string;
+    parentId?: string;
+    version: {
+        number: number;
+    };
+    body?: {
+        atlas_doc_format?: {
+            representation: string;
+            value: string;
+        };
+    };
+    _links?: {
+        webui: string;
+    };
+    [key: string]: unknown;
+}
+/**
+ * Custom Confluence API error class
+ */
+export declare class ConfluenceApiError extends Error {
+    status?: number;
+    statusText?: string;
+    data?: unknown;
+    constructor(message: string, status?: number, statusText?: string, data?: unknown);
+}
+/**
+ * Confluence API client for interacting with Confluence REST API v2
+ *
+ * Features:
+ * - Basic Authentication with email and API token
+ * - CRUD operations on pages
+ * - CQL search support
+ * - Error handling for 401, 404, 400, 409, and 500 errors
+ */
+export declare class ConfluenceClient {
+    private axiosInstance;
+    private config;
+    constructor(config: ConfluenceClientConfig);
+    /**
+     * Handle API errors and convert to ConfluenceApiError
+     */
+    private handleError;
+    /**
+     * Get space ID from space key
+     *
+     * @param spaceKey - Space key (e.g., "TEST")
+     * @returns Space ID
+     * @throws ConfluenceApiError if space not found
+     */
+    private getSpaceId;
+    /**
+     * Create a new Confluence page
+     *
+     * @param spaceKey - Space key (e.g., "TEST")
+     * @param title - Page title
+     * @param content - Page content in ADF format
+     * @param parentId - Optional parent page ID
+     * @returns Page ID of created page
+     * @throws ConfluenceApiError on failure
+     */
+    createPage(spaceKey: string, title: string, content: AdfDocument, parentId?: string): Promise<string>;
+    /**
+     * Update an existing Confluence page
+     *
+     * @param pageId - Page ID
+     * @param title - Updated page title
+     * @param content - Updated page content in ADF format
+     * @param version - Current version number (for optimistic locking)
+     * @throws ConfluenceApiError on failure
+     */
+    updatePage(pageId: string, title: string, content: AdfDocument, version: number): Promise<void>;
+    /**
+     * Get a Confluence page by ID
+     *
+     * @param pageId - Page ID
+     * @returns Confluence page object
+     * @throws ConfluenceApiError on failure
+     */
+    getPage(pageId: string): Promise<ConfluencePage>;
+    /**
+     * Get a Confluence page by title and space
+     *
+     * @param spaceKey - Space key (e.g., "TEST")
+     * @param title - Page title
+     * @returns Confluence page object or null if not found
+     * @throws ConfluenceApiError on failure
+     */
+    getPageByTitle(spaceKey: string, title: string): Promise<ConfluencePage | null>;
+    /**
+     * Search for Confluence pages using CQL (Confluence Query Language)
+     *
+     * @param cql - CQL query string (e.g., 'space = TEST AND type = page')
+     * @returns Array of matching Confluence pages
+     * @throws ConfluenceApiError on failure
+     */
+    searchPages(cql: string): Promise<ConfluencePage[]>;
+}
+//# sourceMappingURL=confluence-client.d.ts.map

package/dist/lib/confluence/confluence-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confluence-client.d.ts","sourceRoot":"","sources":["../../../src/lib/confluence/confluence-client.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,IAAI,CAAC,EAAE;QACL,gBAAgB,CAAC,EAAE;YACjB,cAAc,EAAE,MAAM,CAAC;YACvB,KAAK,EAAE,MAAM,CAAC;SACf,CAAC;KACH,CAAC;IACF,MAAM,CAAC,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;gBAEV,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO;CAOlF;AAED;;;;;;;;GAQG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,MAAM,CAAyB;gBAE3B,MAAM,EAAE,sBAAsB;IAkC1C;;OAEG;IACH,OAAO,CAAC,WAAW;IA4CnB;;;;;;OAMG;YACW,UAAU;IAgBxB;;;;;;;;;OASG;IACG,UAAU,CACd,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,WAAW,EACpB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC;IAuClB;;;;;;;;OAQG;IACG,UAAU,CACd,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC;IAqBhB;;;;;;OAMG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IActD;;;;;;;OAOG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAoBrF;;;;;;OAMG;IACG,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;CAc1D"}

package/dist/lib/confluence/confluence-client.js

@@ -0,0 +1,249 @@
+import axios from 'axios';
+/**
+ * Custom Confluence API error class
+ */
+export class ConfluenceApiError extends Error {
+    status;
+    statusText;
+    data;
+    constructor(message, status, statusText, data) {
+        super(message);
+        this.name = 'ConfluenceApiError';
+        this.status = status;
+        this.statusText = statusText;
+        this.data = data;
+    }
+}
+/**
+ * Confluence API client for interacting with Confluence REST API v2
+ *
+ * Features:
+ * - Basic Authentication with email and API token
+ * - CRUD operations on pages
+ * - CQL search support
+ * - Error handling for 401, 404, 400, 409, and 500 errors
+ */
+export class ConfluenceClient {
+    axiosInstance;
+    config;
+    constructor(config) {
+        // Validate required config
+        if (!config.baseUrl) {
+            throw new Error('ConfluenceClientConfig: baseUrl is required');
+        }
+        if (!config.email) {
+            throw new Error('ConfluenceClientConfig: email is required');
+        }
+        if (!config.apiToken) {
+            throw new Error('ConfluenceClientConfig: apiToken is required');
+        }
+        this.config = {
+            ...config,
+            baseUrl: config.baseUrl.replace(/\/$/, ''), // Strip trailing slash
+        };
+        // Create axios instance with Confluence-specific configuration
+        const axiosConfig = {
+            baseURL: `${this.config.baseUrl}/api/v2`,
+            timeout: 30000, // 30 seconds
+            auth: {
+                username: this.config.email,
+                password: this.config.apiToken,
+            },
+            headers: {
+                'Content-Type': 'application/json',
+                'Accept': 'application/json',
+            },
+        };
+        this.axiosInstance = axios.create(axiosConfig);
+    }
+    /**
+     * Handle API errors and convert to ConfluenceApiError
+     */
+    handleError(error) {
+        const isAxiosLike = axios.isAxiosError(error) ||
+            (typeof error === 'object' && error !== null && 'isAxiosError' in error && error.isAxiosError === true);
+        if (isAxiosLike) {
+            const axiosError = error;
+            // Handle timeout errors
+            if (axiosError.code === 'ECONNABORTED') {
+                throw new ConfluenceApiError('Request timeout');
+            }
+            // Handle network errors
+            if (axiosError.code === 'ENOTFOUND' || axiosError.code === 'ECONNREFUSED') {
+                throw new ConfluenceApiError('Network error');
+            }
+            // Handle response errors
+            if (axiosError.response) {
+                const { status, statusText, data } = axiosError.response;
+                let message = statusText || 'Request failed';
+                // Extract error message from Confluence response
+                if (data && typeof data === 'object' && data !== null && 'message' in data) {
+                    const dataMessage = data.message;
+                    if (typeof dataMessage === 'string') {
+                        message = dataMessage;
+                    }
+                }
+                throw new ConfluenceApiError(message, status, statusText, data);
+            }
+            // Handle request errors
+            throw new ConfluenceApiError(axiosError.message);
+        }
+        // Handle non-axios errors
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        throw new ConfluenceApiError(errorMessage);
+    }
+    /**
+     * Get space ID from space key
+     *
+     * @param spaceKey - Space key (e.g., "TEST")
+     * @returns Space ID
+     * @throws ConfluenceApiError if space not found
+     */
+    async getSpaceId(spaceKey) {
+        try {
+            const response = await this.axiosInstance.get('/spaces', {
+                params: { keys: spaceKey },
+            });
+            if (!response.data.results || response.data.results.length === 0) {
+                throw new Error(`Space not found: ${spaceKey}`);
+            }
+            return response.data.results[0].id;
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+    /**
+     * Create a new Confluence page
+     *
+     * @param spaceKey - Space key (e.g., "TEST")
+     * @param title - Page title
+     * @param content - Page content in ADF format
+     * @param parentId - Optional parent page ID
+     * @returns Page ID of created page
+     * @throws ConfluenceApiError on failure
+     */
+    async createPage(spaceKey, title, content, parentId) {
+        try {
+            // Get space ID from space key
+            const spaceId = await this.getSpaceId(spaceKey);
+            // Build request payload
+            const payload = {
+                spaceId,
+                status: 'current',
+                title,
+                body: {
+                    representation: 'atlas_doc_format',
+                    value: JSON.stringify(content),
+                },
+            };
+            // Add parent ID if specified
+            if (parentId) {
+                payload.parentId = parentId;
+            }
+            // Create page
+            const response = await this.axiosInstance.post('/pages', payload, {});
+            return response.data.id;
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+    /**
+     * Update an existing Confluence page
+     *
+     * @param pageId - Page ID
+     * @param title - Updated page title
+     * @param content - Updated page content in ADF format
+     * @param version - Current version number (for optimistic locking)
+     * @throws ConfluenceApiError on failure
+     */
+    async updatePage(pageId, title, content, version) {
+        try {
+            const payload = {
+                id: pageId,
+                status: 'current',
+                title,
+                body: {
+                    representation: 'atlas_doc_format',
+                    value: JSON.stringify(content),
+                },
+                version: {
+                    number: version,
+                },
+            };
+            await this.axiosInstance.put(`/pages/${pageId}`, payload, {});
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+    /**
+     * Get a Confluence page by ID
+     *
+     * @param pageId - Page ID
+     * @returns Confluence page object
+     * @throws ConfluenceApiError on failure
+     */
+    async getPage(pageId) {
+        try {
+            const response = await this.axiosInstance.get(`/pages/${pageId}`, {
+                params: {
+                    'body-format': 'atlas_doc_format',
+                },
+            });
+            return response.data;
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+    /**
+     * Get a Confluence page by title and space
+     *
+     * @param spaceKey - Space key (e.g., "TEST")
+     * @param title - Page title
+     * @returns Confluence page object or null if not found
+     * @throws ConfluenceApiError on failure
+     */
+    async getPageByTitle(spaceKey, title) {
+        try {
+            const response = await this.axiosInstance.get('/pages', {
+                params: {
+                    spaceKey,
+                    title,
+                    'body-format': 'atlas_doc_format',
+                },
+            });
+            if (!response.data.results || response.data.results.length === 0) {
+                return null;
+            }
+            return response.data.results[0];
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+    /**
+     * Search for Confluence pages using CQL (Confluence Query Language)
+     *
+     * @param cql - CQL query string (e.g., 'space = TEST AND type = page')
+     * @returns Array of matching Confluence pages
+     * @throws ConfluenceApiError on failure
+     */
+    async searchPages(cql) {
+        try {
+            const response = await this.axiosInstance.get('/pages', {
+                params: {
+                    cql,
+                    'body-format': 'atlas_doc_format',
+                },
+            });
+            return response.data.results || [];
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+}
+//# sourceMappingURL=confluence-client.js.map

package/dist/lib/confluence/confluence-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confluence-client.js","sourceRoot":"","sources":["../../../src/lib/confluence/confluence-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAwD,MAAM,OAAO,CAAC;AA4C7E;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IACpC,MAAM,CAAU;IAChB,UAAU,CAAU;IACpB,IAAI,CAAW;IAEtB,YAAY,OAAe,EAAE,MAAe,EAAE,UAAmB,EAAE,IAAc;QAC/E,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,OAAO,gBAAgB;IACnB,aAAa,CAAgB;IAC7B,MAAM,CAAyB;IAEvC,YAAY,MAA8B;QACxC,2BAA2B;QAC3B,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACjE,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAClE,CAAC;QAED,IAAI,CAAC,MAAM,GAAG;YACZ,GAAG,MAAM;YACT,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,uBAAuB;SACpE,CAAC;QAEF,+DAA+D;QAC/D,MAAM,WAAW,GAAuB;YACtC,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,SAAS;YACxC,OAAO,EAAE,KAAK,EAAE,aAAa;YAC7B,IAAI,EAAE;gBACJ,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;gBAC3B,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;aAC/B;YACD,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,QAAQ,EAAE,kBAAkB;aAC7B;SACF,CAAC;QAEF,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACjD,CAAC;IAED;;OAEG;IACK,WAAW,CAAC,KAAc;QAChC,MAAM,WAAW,GACf,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC;YACzB,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,cAAc,IAAI,KAAK,IAAI,KAAK,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC;QAE1G,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,UAAU,GAAG,KAAmB,CAAC;YAEvC,wBAAwB;YACxB,IAAI,UAAU,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;gBACvC,MAAM,IAAI,kBAAkB,CAAC,iBAAiB,CAAC,CAAC;YAClD,CAAC;YAED,wBAAwB;YACxB,IAAI,UAAU,CAAC,IAAI,KAAK,WAAW,IAAI,UAAU,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;gBAC1E,MAAM,IAAI,kBAAkB,CAAC,eAAe,CAAC,CAAC;YAChD,CAAC;YAED,yBAAyB;YACzB,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC;gBACxB,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,UAAU,CAAC,QAAQ,CAAC;gBACzD,IAAI,OAAO,GAAG,UAAU,IAAI,gBAAgB,CAAC;gBAE7C,iDAAiD;gBACjD,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,SAAS,IAAI,IAAI,EAAE,CAAC;oBAC3E,MAAM,WAAW,GAAI,IAA8B,CAAC,OAAO,CAAC;oBAC5D,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;wBACpC,OAAO,GAAG,WAAW,CAAC;oBACxB,CAAC;gBACH,CAAC;gBAED,MAAM,IAAI,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;YAClE,CAAC;YAED,wBAAwB;YACxB,MAAM,IAAI,kBAAkB,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QACnD,CAAC;QAED,0BAA0B;QAC1B,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QAC3D,MAAM,IAAI,kBAAkB,CAAC,YAAY,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;;OAMG;IACK,KAAK,CAAC,UAAU,CAAC,QAAgB;QACvC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,EAAE;gBACvD,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aAC3B,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACjE,MAAM,IAAI,KAAK,CAAC,oBAAoB,QAAQ,EAAE,CAAC,CAAC;YAClD,CAAC;YAED,OAAO,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACrC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,UAAU,CACd,QAAgB,EAChB,KAAa,EACb,OAAoB,EACpB,QAAiB;QAEjB,IAAI,CAAC;YACH,8BAA8B;YAC9B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YAEhD,wBAAwB;YACxB,MAAM,OAAO,GAST;gBACF,OAAO;gBACP,MAAM,EAAE,SAAS;gBACjB,KAAK;gBACL,IAAI,EAAE;oBACJ,cAAc,EAAE,kBAAkB;oBAClC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;iBAC/B;aACF,CAAC;YAEF,6BAA6B;YAC7B,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;YAC9B,CAAC;YAED,cAAc;YACd,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;YAEtE,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,UAAU,CACd,MAAc,EACd,KAAa,EACb,OAAoB,EACpB,OAAe;QAEf,IAAI,CAAC;YACH,MAAM,OAAO,GAAG;gBACd,EAAE,EAAE,MAAM;gBACV,MAAM,EAAE,SAAS;gBACjB,KAAK;gBACL,IAAI,EAAE;oBACJ,cAAc,EAAE,kBAAkB;oBAClC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;iBAC/B;gBACD,OAAO,EAAE;oBACP,MAAM,EAAE,OAAO;iBAChB;aACF,CAAC;YAEF,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,UAAU,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;QAChE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,CAAC,MAAc;QAC1B,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,CAAiB,UAAU,MAAM,EAAE,EAAE;gBAChF,MAAM,EAAE;oBACN,aAAa,EAAE,kBAAkB;iBAClC;aACF,CAAC,CAAC;YAEH,OAAO,QAAQ,CAAC,IAAI,CAAC;QACvB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,cAAc,CAAC,QAAgB,EAAE,KAAa;QAClD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,EAAE;gBACtD,MAAM,EAAE;oBACN,QAAQ;oBACR,KAAK;oBACL,aAAa,EAAE,kBAAkB;iBAClC;aACF,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACjE,OAAO,IAAI,CAAC;YACd,CAAC;YAED,OAAO,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAClC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,WAAW,CAAC,GAAW;QAC3B,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,EAAE;gBACtD,MAAM,EAAE;oBACN,GAAG;oBACH,aAAa,EAAE,kBAAkB;iBAClC;aACF,CAAC,CAAC;YAEH,OAAO,QAAQ,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;QACrC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;CACF"}

package/dist/lib/confluence/confluence-commands.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Confluence Commands
+ *
+ * Core logic for Confluence CLI commands:
+ * - createPageCommand: Create Confluence page from markdown file
+ * - fetchPageCommand: Fetch page from Confluence and save as markdown
+ * - importReportsCommand: Batch import markdown reports to Confluence
+ */
+import { ConfluenceClientConfig } from './confluence-client.js';
+/**
+ * Options for create-page command
+ */
+export interface CreatePageOptions {
+    parentId?: string;
+    dryRun?: boolean;
+}
+/**
+ * Options for import-reports command
+ */
+export interface ImportReportsOptions {
+    dryRun?: boolean;
+}
+/**
+ * Result of import-reports command
+ */
+export interface ImportReportsResult {
+    total: number;
+    created: number;
+    updated: number;
+    skipped: number;
+    errors: number;
+}
+/**
+ * Create a Confluence page from a markdown file
+ *
+ * @param markdownPath - Path to markdown file with YAML frontmatter
+ * @param config - Confluence client configuration
+ * @param options - Command options
+ */
+export declare function createPageCommand(markdownPath: string, config: ConfluenceClientConfig, options?: CreatePageOptions): Promise<void>;
+/**
+ * Fetch a Confluence page and save as markdown
+ *
+ * @param pageId - Confluence page ID
+ * @param outputPath - Path to save markdown file
+ * @param config - Confluence client configuration
+ */
+export declare function fetchPageCommand(pageId: string, outputPath: string, config: ConfluenceClientConfig): Promise<void>;
+/**
+ * Import markdown reports to Confluence (batch processing)
+ *
+ * @param reportsDir - Directory containing markdown reports
+ * @param config - Confluence client configuration
+ * @param options - Command options
+ * @returns Import result statistics
+ */
+export declare function importReportsCommand(reportsDir: string, config: ConfluenceClientConfig, options?: ImportReportsOptions): Promise<ImportReportsResult>;
+//# sourceMappingURL=confluence-commands.d.ts.map

package/dist/lib/confluence/confluence-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confluence-commands.d.ts","sourceRoot":"","sources":["../../../src/lib/confluence/confluence-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAoB,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAIlF;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,sBAAsB,EAC9B,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAqEf;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAgDf;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,sBAAsB,EAC9B,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,mBAAmB,CAAC,CAqI9B"}

package/dist/lib/confluence/confluence-commands.js

@@ -0,0 +1,231 @@
+/**
+ * Confluence Commands
+ *
+ * Core logic for Confluence CLI commands:
+ * - createPageCommand: Create Confluence page from markdown file
+ * - fetchPageCommand: Fetch page from Confluence and save as markdown
+ * - importReportsCommand: Batch import markdown reports to Confluence
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import { ConfluenceClient } from './confluence-client.js';
+import { markdownToAdf, adfToMarkdown } from './adf-converter.js';
+import { parseFrontmatter, stringifyFrontmatter } from '../common/yaml-frontmatter.js';
+/**
+ * Create a Confluence page from a markdown file
+ *
+ * @param markdownPath - Path to markdown file with YAML frontmatter
+ * @param config - Confluence client configuration
+ * @param options - Command options
+ */
+export async function createPageCommand(markdownPath, config, options = {}) {
+    // Read markdown file
+    const content = await fs.readFile(markdownPath, 'utf-8');
+    // Parse frontmatter and body
+    const { data: frontmatter, content: body } = parseFrontmatter(content);
+    // Validate required fields
+    if (!frontmatter.title) {
+        throw new Error('Missing required field "title" in YAML frontmatter');
+    }
+    if (!frontmatter.spaceKey) {
+        throw new Error('Missing required field "spaceKey" in YAML frontmatter');
+    }
+    const title = frontmatter.title;
+    const spaceKey = frontmatter.spaceKey;
+    const parentId = options.parentId || frontmatter.parentId;
+    console.log(`Creating page: ${title}`);
+    console.log(`Space: ${spaceKey}`);
+    if (parentId) {
+        console.log(`Parent ID: ${parentId}`);
+    }
+    // Convert markdown to ADF
+    console.log('Converting markdown to ADF...');
+    const adf = markdownToAdf(body);
+    if (options.dryRun) {
+        console.log('[DRY RUN] Would create page in Confluence');
+        console.log(`Title: ${title}`);
+        console.log(`Space: ${spaceKey}`);
+        console.log(`Parent: ${parentId || 'none'}`);
+        return;
+    }
+    // Create Confluence client
+    const client = new ConfluenceClient(config);
+    // Create page
+    console.log('Creating page in Confluence...');
+    const pageId = await client.createPage(spaceKey, title, adf, parentId);
+    // Fetch created page to get metadata
+    const page = await client.getPage(pageId);
+    console.log('\nPage created successfully!');
+    console.log(`  Page ID: ${pageId}`);
+    console.log(`  Version: ${page.version.number}`);
+    console.log(`  URL: ${config.baseUrl}${page._links?.webui || ''}`);
+    // Update frontmatter in markdown file
+    const updatedFrontmatter = {
+        ...frontmatter,
+        pageId: pageId,
+        version: page.version.number,
+        confluenceUrl: `${config.baseUrl}${page._links?.webui || ''}`,
+    };
+    const updatedContent = stringifyFrontmatter(updatedFrontmatter, body);
+    await fs.writeFile(markdownPath, updatedContent, 'utf-8');
+    console.log(`\nUpdated local file: ${markdownPath}`);
+}
+/**
+ * Fetch a Confluence page and save as markdown
+ *
+ * @param pageId - Confluence page ID
+ * @param outputPath - Path to save markdown file
+ * @param config - Confluence client configuration
+ */
+export async function fetchPageCommand(pageId, outputPath, config) {
+    console.log(`Fetching page ${pageId} from Confluence...`);
+    // Create Confluence client
+    const client = new ConfluenceClient(config);
+    // Fetch page
+    const page = await client.getPage(pageId);
+    console.log(`Fetched page: ${page.title}`);
+    console.log(`Space: ${page.spaceId}`);
+    console.log(`Version: ${page.version.number}`);
+    // Extract ADF content
+    if (!page.body?.atlas_doc_format?.value) {
+        throw new Error('Page does not contain ADF content');
+    }
+    const adf = JSON.parse(page.body.atlas_doc_format.value);
+    // Convert ADF to markdown
+    console.log('Converting ADF to markdown...');
+    const markdown = adfToMarkdown(adf);
+    // Build frontmatter
+    const frontmatter = {
+        title: page.title,
+        pageId: page.id,
+        spaceKey: page.spaceId,
+        version: page.version.number,
+        status: page.status,
+        confluenceUrl: `${config.baseUrl}${page._links?.webui || ''}`,
+    };
+    if (page.parentId) {
+        frontmatter.parentId = page.parentId;
+    }
+    // Combine frontmatter and markdown
+    const fullContent = stringifyFrontmatter(frontmatter, markdown);
+    // Ensure output directory exists
+    const outputDir = path.dirname(outputPath);
+    await fs.ensureDir(outputDir);
+    // Write to file
+    await fs.writeFile(outputPath, fullContent, 'utf-8');
+    console.log(`\nPage saved to: ${outputPath}`);
+}
+/**
+ * Import markdown reports to Confluence (batch processing)
+ *
+ * @param reportsDir - Directory containing markdown reports
+ * @param config - Confluence client configuration
+ * @param options - Command options
+ * @returns Import result statistics
+ */
+export async function importReportsCommand(reportsDir, config, options = {}) {
+    const result = {
+        total: 0,
+        created: 0,
+        updated: 0,
+        skipped: 0,
+        errors: 0,
+    };
+    // Check if directory exists
+    const exists = await fs.pathExists(reportsDir);
+    if (!exists) {
+        throw new Error(`Reports directory not found: ${reportsDir}`);
+    }
+    // Find all markdown files
+    const files = await fs.readdir(reportsDir);
+    const markdownFiles = files.filter((f) => f.endsWith('.md'));
+    result.total = markdownFiles.length;
+    if (markdownFiles.length === 0) {
+        console.log('No markdown files found in reports directory');
+        return result;
+    }
+    console.log(`Found ${markdownFiles.length} markdown files`);
+    // Create Confluence client
+    const client = new ConfluenceClient(config);
+    // Process each file
+    for (const file of markdownFiles) {
+        const filePath = path.join(reportsDir, file);
+        try {
+            console.log(`\nProcessing: ${file}`);
+            // Read file
+            const content = await fs.readFile(filePath, 'utf-8');
+            // Parse frontmatter
+            const { data: frontmatter, content: body } = parseFrontmatter(content);
+            // Validate required fields
+            if (!frontmatter.title || !frontmatter.spaceKey) {
+                console.log(`  Skipped: Missing title or spaceKey in frontmatter`);
+                result.skipped++;
+                continue;
+            }
+            const title = frontmatter.title;
+            const spaceKey = frontmatter.spaceKey;
+            const parentId = frontmatter.parentId;
+            // Convert markdown to ADF
+            const adf = markdownToAdf(body);
+            if (options.dryRun) {
+                console.log(`  [DRY RUN] Would process: ${title}`);
+                continue;
+            }
+            // Check if page already exists
+            const existingPage = await client.getPageByTitle(spaceKey, title);
+            if (existingPage) {
+                // Update existing page
+                console.log(`  Updating existing page (ID: ${existingPage.id})...`);
+                const newVersion = existingPage.version.number + 1;
+                await client.updatePage(existingPage.id, title, adf, newVersion);
+                // Fetch updated page
+                const updatedPage = await client.getPage(existingPage.id);
+                // Update frontmatter
+                const updatedFrontmatter = {
+                    ...frontmatter,
+                    pageId: existingPage.id,
+                    version: updatedPage.version.number,
+                    confluenceUrl: `${config.baseUrl}${updatedPage._links?.webui || ''}`,
+                };
+                const updatedContent = stringifyFrontmatter(updatedFrontmatter, body);
+                await fs.writeFile(filePath, updatedContent, 'utf-8');
+                console.log(`  Updated successfully (Version: ${updatedPage.version.number})`);
+                result.updated++;
+            }
+            else {
+                // Create new page
+                console.log(`  Creating new page...`);
+                const pageId = await client.createPage(spaceKey, title, adf, parentId);
+                // Fetch created page
+                const createdPage = await client.getPage(pageId);
+                // Update frontmatter
+                const updatedFrontmatter = {
+                    ...frontmatter,
+                    pageId: pageId,
+                    version: createdPage.version.number,
+                    confluenceUrl: `${config.baseUrl}${createdPage._links?.webui || ''}`,
+                };
+                const updatedContent = stringifyFrontmatter(updatedFrontmatter, body);
+                await fs.writeFile(filePath, updatedContent, 'utf-8');
+                console.log(`  Created successfully (ID: ${pageId})`);
+                result.created++;
+            }
+        }
+        catch (error) {
+            console.error(`  Error: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            result.errors++;
+        }
+    }
+    // Print summary
+    console.log('\n' + '='.repeat(60));
+    console.log('IMPORT SUMMARY');
+    console.log('='.repeat(60));
+    console.log(`Total files: ${result.total}`);
+    console.log(`Created: ${result.created}`);
+    console.log(`Updated: ${result.updated}`);
+    console.log(`Skipped: ${result.skipped}`);
+    console.log(`Errors: ${result.errors}`);
+    console.log('='.repeat(60));
+    return result;
+}
+//# sourceMappingURL=confluence-commands.js.map