@markwinap/confluence-sync-core 1.0.2

package/.github/workflows/publish.yml

@@ -0,0 +1,40 @@
+name: Publish package
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: read
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          registry-url: https://registry.npmjs.org
+          cache: npm
+
+      - run: npm ci
+
+      - id: package
+        run: |
+          echo "name=$(node -p "require('./package.json').name")" >> "$GITHUB_OUTPUT"
+          echo "version=$(node -p "require('./package.json').version")" >> "$GITHUB_OUTPUT"
+
+      - id: version
+        env:
+          PACKAGE_NAME: ${{ steps.package.outputs.name }}
+          PACKAGE_VERSION: ${{ steps.package.outputs.version }}
+        run: |
+          if npm view "${PACKAGE_NAME}@${PACKAGE_VERSION}" version --registry=https://registry.npmjs.org > /dev/null 2>&1; then
+            echo "publish=false" >> "$GITHUB_OUTPUT"
+          else
+            echo "publish=true" >> "$GITHUB_OUTPUT"
+          fi
+

package/README.md

@@ -0,0 +1,9 @@
+# @markwinap/confluence-sync-core
+
+Framework-neutral Confluence content synchronization library.
+
+This package provides the shared engine used by `confluence-sync` (CLI) and the VS Code extension. It is not intended to be used directly by end users.
+
+## Publishing
+
+Push a commit to `main` with a new `version` in `package.json` to publish it. The GitHub repository requires an `NPM_TOKEN` Actions secret containing an npm granular access token with publish permission for `@markwinap/confluence-sync-core`.

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const config_1 = require("./config");
+const confluenceClient_1 = require("./confluenceClient");
+const manifest_1 = require("./manifest");
+const pull_1 = require("./pull");
+const push_1 = require("./push");
+const status_1 = require("./status");
+async function main() {
+    const [command, ...args] = process.argv.slice(2);
+    if (!command || command === "help" || args.includes("--help"))
+        return usage();
+    const contentDir = process.env.CONFLUENCE_SYNC_CONTENT_DIR;
+    const config = (0, config_1.loadConfig)(contentDir);
+    const client = new confluenceClient_1.ConfluenceClient(config);
+    if (command === "pull") {
+        const dryRun = args.includes("--dry-run");
+        const trashFlag = args.includes("--trash") || process.env.PULL_TRASH_DELETED === "1";
+        const result = await (0, pull_1.pull)(config, client, { prune: trashFlag, dryRun });
+        const deletionCount = result.manifest.deletions?.length || 0;
+        const deletionMsg = deletionCount ? `, ${deletionCount} deletion(s) detected` : "";
+        const trashMsg = trashFlag && !dryRun ? " and moved to trash" : trashFlag && dryRun ? " (dry-run, not moved)" : "";
+        console.log(`Pull complete: ${result.manifest.items.length} item(s), ${result.manifest.warnings.length} warning(s)${deletionMsg}${trashMsg}.`);
+    }
+    else if (command === "status") {
+        (0, status_1.printStatus)(await (0, status_1.getStatus)(config.contentDir, (0, manifest_1.readManifest)(config.contentDir), client));
+    }
+    else if (command === "push") {
+        const manifest = (0, manifest_1.readManifest)(config.contentDir);
+        const changes = await (0, status_1.getStatus)(config.contentDir, manifest, client);
+        (0, status_1.printStatus)(changes);
+        await (0, push_1.push)(config, manifest, changes, client, args.includes("--dry-run"));
+    }
+    else
+        throw new Error(`Unknown command: ${command}`);
+}
+function usage() {
+    console.log("Usage: npm run <pull|status|push> [-- --dry-run]\n\nCommands:\n  pull             Download the configured Confluence subtree\n  pull -- --trash  Move locally-stored items deleted from Confluence to the trash folder\n  pull -- --trash --dry-run  Preview which local items would be moved to trash\n                   (On Windows/PowerShell with npm run, set PULL_TRASH_DELETED=1 instead of --trash)\n  status           Compare local hashes and remote versions\n  push -- --dry-run  Preview safe upserts\n  push             Apply safe page and attachment upserts");
+}
+main().catch(error => { console.error(error instanceof Error ? error.message : error); process.exitCode = 1; });
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,15 @@
+export interface Config {
+    email: string;
+    token: string;
+    baseUrl: string;
+    spaceKey: string;
+    rootPageId: string;
+    contentDir: string;
+    minDelayMs: number;
+    maxDelayMs: number;
+    attachmentMinDelayMs: number;
+    attachmentMaxDelayMs: number;
+    concurrency?: number;
+}
+export declare function loadConfig(contentDir?: string): Config;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAyBtD"}

package/dist/config.js

@@ -0,0 +1,73 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfig = loadConfig;
+const dotenv_1 = require("dotenv");
+const path = __importStar(require("path"));
+function loadConfig(contentDir) {
+    const rootDir = process.env.CONFLUENCE_SYNC_PROJECT_DIR || process.cwd();
+    (0, dotenv_1.config)({ path: path.resolve(rootDir, ".env") });
+    const email = process.env.ATLASSIAN_EMAIL;
+    const token = process.env.ATLASSIAN_API_TOKEN;
+    if (!email || !token)
+        throw new Error("ATLASSIAN_EMAIL and ATLASSIAN_API_TOKEN must be set in .env");
+    const baseUrl = new URL(process.env.CONFLUENCE_BASE_URL || "https://example.atlassian.net").origin;
+    const minDelayMs = numberEnv("RATE_LIMIT_MIN_MS", 250);
+    const maxDelayMs = numberEnv("RATE_LIMIT_MAX_MS", 750);
+    const attachmentMinDelayMs = numberEnv("ATTACHMENT_RATE_LIMIT_MIN_MS", 100);
+    const attachmentMaxDelayMs = numberEnv("ATTACHMENT_RATE_LIMIT_MAX_MS", 400);
+    if (minDelayMs > maxDelayMs || attachmentMinDelayMs > attachmentMaxDelayMs)
+        throw new Error("Minimum delays cannot exceed maximum delays");
+    return {
+        email,
+        token,
+        baseUrl,
+        spaceKey: process.env.CONFLUENCE_SPACE_KEY || "SPACE",
+        rootPageId: process.env.CONFLUENCE_ROOT_PAGE_ID || "0",
+        contentDir: contentDir || path.resolve(rootDir, "content"),
+        minDelayMs,
+        maxDelayMs,
+        attachmentMinDelayMs,
+        attachmentMaxDelayMs,
+        concurrency: 5,
+    };
+}
+function numberEnv(name, fallback) {
+    const value = Number(process.env[name] ?? fallback);
+    if (!Number.isFinite(value) || value < 0)
+        throw new Error(`${name} must be a non-negative number`);
+    return value;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiBA,gCAyBC;AA1CD,mCAA2C;AAC3C,2CAA6B;AAgB7B,SAAgB,UAAU,CAAC,UAAmB;IAC5C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,2BAA2B,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACzE,IAAA,eAAO,EAAC,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IAC1C,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;IAC9C,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;IACrG,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,+BAA+B,CAAC,CAAC,MAAM,CAAC;IACnG,MAAM,UAAU,GAAG,SAAS,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC;IACvD,MAAM,UAAU,GAAG,SAAS,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC;IACvD,MAAM,oBAAoB,GAAG,SAAS,CAAC,8BAA8B,EAAE,GAAG,CAAC,CAAC;IAC5E,MAAM,oBAAoB,GAAG,SAAS,CAAC,8BAA8B,EAAE,GAAG,CAAC,CAAC;IAC5E,IAAI,UAAU,GAAG,UAAU,IAAI,oBAAoB,GAAG,oBAAoB;QAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IAC3I,OAAO;QACL,KAAK;QACL,KAAK;QACL,OAAO;QACP,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,OAAO;QACrD,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,GAAG;QACtD,UAAU,EAAE,UAAU,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC;QAC1D,UAAU;QACV,UAAU;QACV,oBAAoB;QACpB,oBAAoB;QACpB,WAAW,EAAE,CAAC;KACf,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,IAAY,EAAE,QAAgB;IAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,CAAC;IACpD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,gCAAgC,CAAC,CAAC;IACnG,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/confluenceClient.d.ts

@@ -0,0 +1,19 @@
+import { Config } from "./config";
+import { ContentType, RemoteAttachment, RemoteContent } from "./types";
+export declare class ConfluenceClient {
+    private readonly config;
+    private readonly http;
+    constructor(config: Config);
+    getContent(id: string, type: ContentType): Promise<RemoteContent>;
+    getDescendants(pageId: string): Promise<RemoteContent[]>;
+    getAttachments(pageId: string): Promise<RemoteAttachment[]>;
+    downloadAttachment(pageId: string, attachment: RemoteAttachment): Promise<Buffer>;
+    createPage(spaceId: string, title: string, parentId: string | undefined, storage: string): Promise<RemoteContent>;
+    updatePage(id: string, title: string, version: number, storage: string): Promise<RemoteContent>;
+    uploadAttachment(pageId: string, file: string, existingId?: string): Promise<void>;
+    private paginate;
+    private request;
+    private pause;
+    private friendlyError;
+}
+//# sourceMappingURL=confluenceClient.d.ts.map

package/dist/confluenceClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confluenceClient.d.ts","sourceRoot":"","sources":["../src/confluenceClient.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAIvE,qBAAa,gBAAgB;IAEf,OAAO,CAAC,QAAQ,CAAC,MAAM;IADnC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgB;gBACR,MAAM,EAAE,MAAM;IAIrC,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC;IAMjE,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAgBxD,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAU3D,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IASjF,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAIjH,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAI/F,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAO1E,QAAQ;YAaR,OAAO;YAeP,KAAK;IAMnB,OAAO,CAAC,aAAa;CAKtB"}

package/dist/confluenceClient.js

@@ -0,0 +1,147 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfluenceClient = void 0;
+const axios_1 = __importStar(require("axios"));
+const form_data_1 = __importDefault(require("form-data"));
+const fs_1 = require("fs");
+class ConfluenceClient {
+    config;
+    http;
+    constructor(config) {
+        this.config = config;
+        this.http = axios_1.default.create({ baseURL: config.baseUrl, auth: { username: config.email, password: config.token }, timeout: 60000, headers: { Accept: "application/json", "User-Agent": "ConfluenceDocumentationSync/1.0" } });
+    }
+    async getContent(id, type) {
+        const plural = type === "database" ? "databases" : `${type}s`;
+        const params = type === "page" ? { "body-format": "storage" } : undefined;
+        return (await this.request({ method: "GET", url: `/wiki/api/v2/${plural}/${id}`, params })).data;
+    }
+    async getDescendants(pageId) {
+        const found = new Map();
+        const queue = [{ id: pageId, type: "page" }];
+        while (queue.length) {
+            const current = queue.shift();
+            const plural = current.type === "database" ? "databases" : `${current.type}s`;
+            const batch = await this.paginate(`/wiki/api/v2/${plural}/${current.id}/descendants`, { depth: 10, limit: 100 });
+            for (const item of batch) {
+                const normalized = { ...item, id: String(item.id) };
+                if (!found.has(normalized.id))
+                    found.set(normalized.id, normalized);
+                if (item.depth === 10)
+                    queue.push({ id: normalized.id, type: normalized.type });
+            }
+        }
+        return [...found.values()];
+    }
+    async getAttachments(pageId) {
+        const rows = await this.paginate(`/wiki/api/v2/pages/${pageId}/attachments`, { limit: 100 });
+        const attachments = [];
+        for (const row of rows) {
+            const detail = (await this.request({ method: "GET", url: `/wiki/api/v2/attachments/${row.id}` })).data;
+            attachments.push({ id: String(row.id), title: detail.title || row.title, fileId: detail.fileId || row.fileId, mediaType: detail.mediaType || row.mediaType, fileSize: detail.fileSize || row.fileSize, version: detail.version || row.version, downloadLink: detail.downloadLink || detail._links?.download });
+        }
+        return attachments;
+    }
+    async downloadAttachment(pageId, attachment) {
+        const endpoint = `/wiki/rest/api/content/${pageId}/child/attachment/${attachment.id}/download`;
+        const redirect = await this.request({ method: "GET", url: endpoint, responseType: "arraybuffer", headers: { Accept: "*/*" }, maxRedirects: 0, validateStatus: status => status === 302 || (status >= 200 && status < 300), delay: "attachment" });
+        if (redirect.status !== 302)
+            return Buffer.from(redirect.data);
+        const location = redirect.headers.location;
+        if (!location)
+            throw new Error(`Attachment ${attachment.id} returned a redirect without a Location header`);
+        return Buffer.from((await axios_1.default.get(new URL(location, this.config.baseUrl).href, { responseType: "arraybuffer", timeout: 60000 })).data);
+    }
+    async createPage(spaceId, title, parentId, storage) {
+        return (await this.request({ method: "POST", url: "/wiki/api/v2/pages", data: { spaceId, status: "current", title, parentId, body: { representation: "storage", value: storage } } })).data;
+    }
+    async updatePage(id, title, version, storage) {
+        return (await this.request({ method: "PUT", url: `/wiki/api/v2/pages/${id}`, data: { id, status: "current", title, body: { representation: "storage", value: storage }, version: { number: version + 1, message: "Synchronized from ConFluenceDocumentationSync" } } })).data;
+    }
+    async uploadAttachment(pageId, file, existingId) {
+        const form = new form_data_1.default();
+        form.append("file", (0, fs_1.createReadStream)(file));
+        const url = existingId ? `/wiki/rest/api/content/${pageId}/child/attachment/${existingId}/data` : `/wiki/rest/api/content/${pageId}/child/attachment`;
+        await this.request({ method: "POST", url, data: form, headers: { ...form.getHeaders(), "X-Atlassian-Token": "no-check" }, delay: "attachment", maxBodyLength: Infinity });
+    }
+    async paginate(url, params) {
+        const results = [];
+        let next = url;
+        let first = true;
+        while (next) {
+            const response = await this.request({ method: "GET", url: next, params: first ? params : undefined });
+            results.push(...response.data.results);
+            next = response.data._links?.next;
+            first = false;
+        }
+        return results;
+    }
+    async request(request) {
+        let lastError;
+        for (let attempt = 0; attempt < 4; attempt++) {
+            if (attempt || request.delay)
+                await this.pause(request.delay === "attachment");
+            try {
+                return await this.http.request(request);
+            }
+            catch (error) {
+                lastError = error;
+                const status = (0, axios_1.isAxiosError)(error) ? error.response?.status : undefined;
+                if (status && status < 500 && status !== 429)
+                    throw this.friendlyError(error);
+                if (attempt < 3)
+                    await new Promise(resolve => setTimeout(resolve, Math.min(1000 * 2 ** attempt, 10000)));
+            }
+        }
+        throw this.friendlyError(lastError);
+    }
+    async pause(attachment) {
+        const min = attachment ? this.config.attachmentMinDelayMs : this.config.minDelayMs;
+        const max = attachment ? this.config.attachmentMaxDelayMs : this.config.maxDelayMs;
+        await new Promise(resolve => setTimeout(resolve, min + Math.floor(Math.random() * (max - min + 1))));
+    }
+    friendlyError(error) {
+        if (!(0, axios_1.isAxiosError)(error))
+            return error instanceof Error ? error : new Error(String(error));
+        const detail = typeof error.response?.data === "object" ? JSON.stringify(error.response.data) : String(error.response?.data || error.message);
+        return new Error(`Confluence API ${error.response?.status || "network error"}: ${detail}`);
+    }
+}
+exports.ConfluenceClient = ConfluenceClient;
+//# sourceMappingURL=confluenceClient.js.map

package/dist/confluenceClient.js.map

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

package/dist/contracts.d.ts

@@ -0,0 +1,112 @@
+import type { Manifest, ManifestItem, PullOptions } from "./types";
+export type ContentType = "page" | "folder" | "whiteboard" | "database" | "embed";
+export type OperationPhase = "discovery" | "processing" | "applying" | "completed" | "cancelled" | "failed";
+export type ProgressKind = "indeterminate" | "determinate";
+export interface SyncProgress {
+    operation: "pull" | "status" | "push";
+    phase: OperationPhase;
+    kind: ProgressKind;
+    currentItem?: {
+        id?: string;
+        title: string;
+        type: ContentType;
+    };
+    currentFile?: {
+        name: string;
+        bytesLoaded?: number;
+        bytesTotal?: number;
+    };
+    totalItems?: number;
+    processed: number;
+    succeeded: number;
+    synced: number;
+    skipped: number;
+    conflicts: number;
+    failed: number;
+    attachments: {
+        total: number;
+        processed: number;
+        bytesTotal?: number;
+        bytesLoaded?: number;
+    };
+    percentage: number;
+    message?: string;
+}
+export interface OperationSummary {
+    operation: "pull" | "status" | "push";
+    elapsedMs: number;
+    discovered: number;
+    processed: number;
+    synced: number;
+    unchanged: number;
+    skipped: number;
+    conflicts: number;
+    failed: number;
+    attachments: {
+        processed: number;
+        bytes?: number;
+    };
+    dryRun: boolean;
+}
+export interface ProjectRef {
+    id: string;
+    displayName: string;
+    rootPath: string;
+    contentDir: string;
+}
+export interface SyncProjectConfig {
+    displayName?: string;
+    baseUrl: string;
+    spaceKey: string;
+    rootPageId: string;
+    contentDir?: string;
+    minDelayMs?: number;
+    maxDelayMs?: number;
+    attachmentMinDelayMs?: number;
+    attachmentMaxDelayMs?: number;
+    concurrency?: number;
+}
+export interface Credentials {
+    email: string;
+    token: string;
+}
+export type SyncErrorCode = "AUTH_MISSING" | "CONFIG_INVALID" | "PROJECT_AMBIGUOUS" | "NETWORK_ERROR" | "API_ERROR" | "CONFLICT" | "PUSH_BLOCKED" | "CANCELLED" | "INTERNAL";
+export declare class SyncError extends Error {
+    readonly code: SyncErrorCode;
+    readonly cause?: unknown | undefined;
+    constructor(code: SyncErrorCode, message: string, cause?: unknown | undefined);
+}
+export interface OperationContext {
+    onProgress?: (progress: SyncProgress) => void | Promise<void>;
+    onDiagnostic?: (level: "info" | "warn" | "error", message: string) => void | Promise<void>;
+    isCancelled?: () => boolean;
+}
+export interface PullPlan {
+    create: ManifestItem[];
+    update: ManifestItem[];
+    unchanged: ManifestItem[];
+    conflicts: ManifestItem[];
+    deleteCandidates: ManifestItem[];
+    warnings: string[];
+}
+export interface PullResult {
+    manifest: Manifest;
+    summary: OperationSummary;
+    warnings: string[];
+}
+export interface StatusResult {
+    changes: Change[];
+    summary: OperationSummary;
+}
+export interface PushResult {
+    summary: OperationSummary;
+}
+export interface Change {
+    item: ManifestItem;
+    kind: ChangeKind;
+    detail: string;
+    remoteVersion?: number;
+}
+export type ChangeKind = "unchanged" | "local" | "remote" | "new-local" | "conflict" | "format-conflict";
+export type { PullOptions };
+//# sourceMappingURL=contracts.d.ts.map

package/dist/contracts.d.ts.map

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

package/dist/contracts.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SyncError = void 0;
+class SyncError extends Error {
+    code;
+    cause;
+    constructor(code, message, cause) {
+        super(message);
+        this.code = code;
+        this.cause = cause;
+        this.name = "SyncError";
+    }
+}
+exports.SyncError = SyncError;
+//# sourceMappingURL=contracts.js.map

package/dist/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../src/contracts.ts"],"names":[],"mappings":";;;AAkFA,MAAa,SAAU,SAAQ,KAAK;IAEhB;IAEA;IAHlB,YACkB,IAAmB,EACnC,OAAe,EACC,KAAe;QAE/B,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,SAAI,GAAJ,IAAI,CAAe;QAEnB,UAAK,GAAL,KAAK,CAAU;QAG/B,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AATD,8BASC"}

package/dist/diff.d.ts

@@ -0,0 +1,14 @@
+import type { ManifestItem } from "./types";
+export interface DiffContent {
+    item: ManifestItem;
+    localStorage?: string;
+    localMarkdown?: string;
+    remoteStorage?: string;
+    baselineStorage?: string;
+}
+export declare function buildLocalDiff(contentDir: string, item: ManifestItem): DiffContent;
+export declare function buildRemoteDiff(remoteStorage: string, item: ManifestItem): DiffContent;
+export declare function previewStorageFromMarkdown(item: ManifestItem, contentDir: string): string | undefined;
+export declare function previewMarkdownFromStorage(item: ManifestItem, contentDir: string): string | undefined;
+export declare function hasLossyConstructs(storage: string): boolean;
+//# sourceMappingURL=diff.d.ts.map

package/dist/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../src/diff.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,YAAY,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,WAAW,CAKlF;AAED,wBAAgB,eAAe,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,WAAW,CAEtF;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAIrG;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAIrG;AAMD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE3D"}

package/dist/diff.js

@@ -0,0 +1,74 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildLocalDiff = buildLocalDiff;
+exports.buildRemoteDiff = buildRemoteDiff;
+exports.previewStorageFromMarkdown = previewStorageFromMarkdown;
+exports.previewMarkdownFromStorage = previewMarkdownFromStorage;
+exports.hasLossyConstructs = hasLossyConstructs;
+const path = __importStar(require("path"));
+const fs_1 = require("fs");
+const format_1 = require("./format");
+function buildLocalDiff(contentDir, item) {
+    const dir = path.join(contentDir, item.relativeDir);
+    const localStorage = readOptional(path.join(dir, "page.storage.xhtml"));
+    const localMarkdown = readOptional(path.join(dir, "page.md"));
+    return { item, localStorage, localMarkdown };
+}
+function buildRemoteDiff(remoteStorage, item) {
+    return { item, remoteStorage };
+}
+function previewStorageFromMarkdown(item, contentDir) {
+    const dir = path.join(contentDir, item.relativeDir);
+    const md = readOptional(path.join(dir, "page.md"));
+    return md ? (0, format_1.markdownToStorage)(md) : undefined;
+}
+function previewMarkdownFromStorage(item, contentDir) {
+    const dir = path.join(contentDir, item.relativeDir);
+    const storage = readOptional(path.join(dir, "page.storage.xhtml"));
+    return storage ? (0, format_1.storageToMarkdown)(storage) : undefined;
+}
+function readOptional(file) {
+    try {
+        return (0, fs_1.readFileSync)(file, "utf8");
+    }
+    catch {
+        return undefined;
+    }
+}
+function hasLossyConstructs(storage) {
+    return /<(ac:|ri:|atlassian|macro|structured-macro|layout)/i.test(storage);
+}
+//# sourceMappingURL=diff.js.map

package/dist/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../src/diff.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAaA,wCAKC;AAED,0CAEC;AAED,gEAIC;AAED,gEAIC;AAMD,gDAEC;AA1CD,2CAA6B;AAC7B,2BAAkC;AAClC,qCAAgE;AAWhE,SAAgB,cAAc,CAAC,UAAkB,EAAE,IAAkB;IACnE,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACpD,MAAM,YAAY,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC,CAAC;IACxE,MAAM,aAAa,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC;IAC9D,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,aAAa,EAAE,CAAC;AAC/C,CAAC;AAED,SAAgB,eAAe,CAAC,aAAqB,EAAE,IAAkB;IACvE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;AACjC,CAAC;AAED,SAAgB,0BAA0B,CAAC,IAAkB,EAAE,UAAkB;IAC/E,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACpD,MAAM,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC;IACnD,OAAO,EAAE,CAAC,CAAC,CAAC,IAAA,0BAAiB,EAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAChD,CAAC;AAED,SAAgB,0BAA0B,CAAC,IAAkB,EAAE,UAAkB;IAC/E,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC,CAAC;IACnE,OAAO,OAAO,CAAC,CAAC,CAAC,IAAA,0BAAiB,EAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1D,CAAC;AAED,SAAS,YAAY,CAAC,IAAY;IAChC,IAAI,CAAC;QAAC,OAAO,IAAA,iBAAY,EAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,SAAS,CAAC;IAAC,CAAC;AACxE,CAAC;AAED,SAAgB,kBAAkB,CAAC,OAAe;IAChD,OAAO,qDAAqD,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC7E,CAAC"}

package/dist/format.d.ts

@@ -0,0 +1,3 @@
+export declare function storageToMarkdown(storage: string): string;
+export declare function markdownToStorage(markdown: string): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAMA,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzD;AAkBD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAuH1D"}