confluence-md-sync 0.8.8 → 0.8.10

package/dist/export/to-markdown.js

@@ -147,10 +147,38 @@ class Converter {
                 // tables:'records' — любую таблицу разворачиваем в записи.
                 if (this.tablesAsRecords)
                     return this.recordsTable(el);
-                // Простую таблицу — в чистый GFM (оба режима). Сложную tableToMd
-                // отклоняет: faithful → сырой HTML, readable → readableFallback
-                // (lossy++ и разворот в GFM через readableTable).
-                return this.tableToMd(el);
+                try {
+                    return this.tableToMd(el);
+                }
+                catch (e) {
+                    if (!(e instanceof Unrepresentable))
+                        throw e;
+                    // Строгая GFM-конвертация отклонила таблицу: то ли из-за косметики
+                    // (Confluence лепит class="wrapped" style="width:…%" на КАЖДУЮ
+                    // таблицу, а первую строку часто оформляет жирным <td> вместо <th>),
+                    // то ли из-за реальных объединений (colspan/rowspan). В faithful без
+                    // этой ветки ЛЮБАЯ такая таблица падала в дословный <table> HTML —
+                    // нормализуем в GFM тем же путём, что readable (buildTableGrid не
+                    // смотрит на атрибуты/семантику заголовка): оформление и объединения
+                    // теряются при повторной публикации, но данные — md-таблица, не теги.
+                    if (!this.readable) {
+                        const saved = this.readable;
+                        this.readable = true;
+                        try {
+                            const norm = this.readableTable(el);
+                            this.stats.normalized++;
+                            return norm;
+                        }
+                        catch (e2) {
+                            if (!(e2 instanceof Unrepresentable))
+                                throw e2;
+                        }
+                        finally {
+                            this.readable = saved;
+                        }
+                    }
+                    throw e;
+                }
             }
             if (el.name === 'ac:structured-macro')
                 return this.macroToMd(el);

package/dist/macros/registry.js

@@ -1,6 +1,6 @@
 import { Markdown } from '../markdown/markdown.js';
 import { unescapeParamValue } from './builder.js';
-import { generateMacroId, structuredMacro } from './xml.js';
+import { stableMacroId, structuredMacro } from './xml.js';
 /**
  * Реестр макросов. Пустой при создании — наполняется плагинами через
  * {@link use} или точечной регистрацией через {@link register}.
@@ -126,7 +126,9 @@ function processMacroType(storage, macroName, renderer) {
         }
         const bodyStart = startIdx + match[0].length;
         const body = storage.substring(bodyStart, endIdx).trim();
-        const macroId = generateMacroId();
+        // Стабильный id от содержимого маркера — иначе он менялся бы на КАЖДЫЙ
+        // рендер (см. stableMacroId), ломая content-hash идемпотентность publish.
+        const macroId = stableMacroId(`${macroName}\u0000${paramStr}\u0000${body}`);
         const macroXhtml = renderer({ params, body, macroId });
         const before = storage.substring(0, startIdx);
         const after = storage.substring(endIdx + endMarker.length);

package/dist/macros/xml.d.ts

@@ -2,8 +2,21 @@
 import type { MacroParam } from './types.js';
 /** Экранирует строку для XML-атрибутов и текстовых узлов. */
 export declare function escapeXmlAttr(s: string): string;
-/** Генерирует UUID для ac:macro-id. */
+/** Генерирует случайный UUID для ac:macro-id (когда стабильность не нужна). */
 export declare function generateMacroId(): string;
+/**
+ * Детерминированный macro-id (UUID-формы) от seed — как правило, от исходного
+ * содержимого маркера (имя+параметры+тело). ВАЖНО для идемпотентности
+ * content-hash: если id генерировать случайно на каждый рендер (см.
+ * {@link generateMacroId}), storage у страницы с любым макросом отличается
+ * при каждой публикации, даже когда исходный markdown не менялся — hash
+ * никогда не совпадает, и publish принудительно обновляет страницу заново
+ * при каждом прогоне (замечено на проде: 1 изменённый файл → 250+ страниц
+ * «обновились», потому что ~250 из них содержат макрос details/properties).
+ * Стабильный id по содержимому убирает этот псевдо-дрейф: одинаковый маркер
+ * даёт одинаковый storage → hash совпадает → UNCHANGED.
+ */
+export declare function stableMacroId(seed: string): string;
 export interface StructuredMacroOptions {
     /**
      * Macro parameters. `undefined` values are skipped. A key rendered as

package/dist/macros/xml.js

@@ -1,4 +1,5 @@
 /** XML helpers shared by macro renderers. */
+import { createHash } from 'node:crypto';
 /** Экранирует строку для XML-атрибутов и текстовых узлов. */
 export function escapeXmlAttr(s) {
     return s.replace(/[<>&"']/g, (c) => {
@@ -12,7 +13,7 @@ export function escapeXmlAttr(s) {
         }
     });
 }
-/** Генерирует UUID для ac:macro-id. */
+/** Генерирует случайный UUID для ac:macro-id (когда стабильность не нужна). */
 export function generateMacroId() {
     return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
         const r = (Math.random() * 16) | 0;
@@ -20,6 +21,24 @@ export function generateMacroId() {
         return v.toString(16);
     });
 }
+/**
+ * Детерминированный macro-id (UUID-формы) от seed — как правило, от исходного
+ * содержимого маркера (имя+параметры+тело). ВАЖНО для идемпотентности
+ * content-hash: если id генерировать случайно на каждый рендер (см.
+ * {@link generateMacroId}), storage у страницы с любым макросом отличается
+ * при каждой публикации, даже когда исходный markdown не менялся — hash
+ * никогда не совпадает, и publish принудительно обновляет страницу заново
+ * при каждом прогоне (замечено на проде: 1 изменённый файл → 250+ страниц
+ * «обновились», потому что ~250 из них содержат макрос details/properties).
+ * Стабильный id по содержимому убирает этот псевдо-дрейф: одинаковый маркер
+ * даёт одинаковый storage → hash совпадает → UNCHANGED.
+ */
+export function stableMacroId(seed) {
+    const hex = createHash('sha256').update(seed, 'utf-8').digest('hex');
+    const bytes = hex.slice(0, 32);
+    return (`${bytes.slice(0, 8)}-${bytes.slice(8, 12)}-4${bytes.slice(13, 16)}-` +
+        `${'89ab'[parseInt(bytes[16], 16) % 4]}${bytes.slice(17, 20)}-${bytes.slice(20, 32)}`);
+}
 /**
  * Assembles an `<ac:structured-macro>` element. Takes care of parameter
  * escaping, rich vs plain bodies and CDATA safety.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "confluence-md-sync",
-  "version": "0.8.8",
+  "version": "0.8.10",
   "description": "Publish Markdown to Confluence (Data Center & Cloud): idempotent page sync, attachment dedup, tables and a pluggable macro system",
   "keywords": [
     "confluence",