mark-deco 0.28.0 → 0.29.0

package/dist/browser.cjs

@@ -1,11 +1,11 @@
 /*!
  * name: mark-deco
- * version: 0.28.0
+ * version: 0.29.0
  * description: Flexible Markdown to HTML conversion library
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT
  * repository.url: https://github.com/kekyo/mark-deco
- * git.commit.hash: 124aac654302073ffbbd202ac2794d6c9cdc56ea
+ * git.commit.hash: 671fab29f293a6a2bb863f3b1d1d00cb1c3112d5
  */
 
 "use strict";

package/dist/browser.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: mark-deco
- * version: 0.28.0
+ * version: 0.29.0
  * description: Flexible Markdown to HTML conversion library
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT
  * repository.url: https://github.com/kekyo/mark-deco
- * git.commit.hash: 124aac654302073ffbbd202ac2794d6c9cdc56ea
+ * git.commit.hash: 671fab29f293a6a2bb863f3b1d1d00cb1c3112d5
  */
 
 /**

package/dist/browser.mjs

@@ -1,11 +1,11 @@
 /*!
  * name: mark-deco
- * version: 0.28.0
+ * version: 0.29.0
  * description: Flexible Markdown to HTML conversion library
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT
  * repository.url: https://github.com/kekyo/mark-deco
- * git.commit.hash: 124aac654302073ffbbd202ac2794d6c9cdc56ea
+ * git.commit.hash: 671fab29f293a6a2bb863f3b1d1d00cb1c3112d5
  */
 
 import { createMutex } from "async-primitives";

package/dist/card-oembed-fallback.cjs

@@ -1,11 +1,11 @@
 /*!
  * name: mark-deco
- * version: 0.28.0
+ * version: 0.29.0
  * description: Flexible Markdown to HTML conversion library
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT
  * repository.url: https://github.com/kekyo/mark-deco
- * git.commit.hash: 124aac654302073ffbbd202ac2794d6c9cdc56ea
+ * git.commit.hash: 671fab29f293a6a2bb863f3b1d1d00cb1c3112d5
  */
 
 "use strict";

package/dist/card-oembed-fallback.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: mark-deco
- * version: 0.28.0
+ * version: 0.29.0
  * description: Flexible Markdown to HTML conversion library
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT
  * repository.url: https://github.com/kekyo/mark-deco
- * git.commit.hash: 124aac654302073ffbbd202ac2794d6c9cdc56ea
+ * git.commit.hash: 671fab29f293a6a2bb863f3b1d1d00cb1c3112d5
  */
 
 /**

package/dist/card-oembed-fallback.mjs

@@ -1,11 +1,11 @@
 /*!
  * name: mark-deco
- * version: 0.28.0
+ * version: 0.29.0
  * description: Flexible Markdown to HTML conversion library
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT
  * repository.url: https://github.com/kekyo/mark-deco
- * git.commit.hash: 124aac654302073ffbbd202ac2794d6c9cdc56ea
+ * git.commit.hash: 671fab29f293a6a2bb863f3b1d1d00cb1c3112d5
  */
 
 import { f as fetchOEmbedData, b as generateHtml, C as CORSError } from "./html-generator-CClcgkAK.js";

package/dist/html-generator-BKd2MyoO.cjs

@@ -1,11 +1,11 @@
 /*!
  * name: mark-deco
- * version: 0.28.0
+ * version: 0.29.0
  * description: Flexible Markdown to HTML conversion library
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT
  * repository.url: https://github.com/kekyo/mark-deco
- * git.commit.hash: 124aac654302073ffbbd202ac2794d6c9cdc56ea
+ * git.commit.hash: 671fab29f293a6a2bb863f3b1d1d00cb1c3112d5
  */
 
 "use strict";

package/dist/html-generator-BlVRLqE6.cjs

@@ -1,11 +1,11 @@
 /*!
  * name: mark-deco
- * version: 0.28.0
+ * version: 0.29.0
  * description: Flexible Markdown to HTML conversion library
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT
  * repository.url: https://github.com/kekyo/mark-deco
- * git.commit.hash: 124aac654302073ffbbd202ac2794d6c9cdc56ea
+ * git.commit.hash: 671fab29f293a6a2bb863f3b1d1d00cb1c3112d5
  */
 
 "use strict";

package/dist/html-generator-CClcgkAK.js

@@ -1,11 +1,11 @@
 /*!
  * name: mark-deco
- * version: 0.28.0
+ * version: 0.29.0
  * description: Flexible Markdown to HTML conversion library
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT
  * repository.url: https://github.com/kekyo/mark-deco
- * git.commit.hash: 124aac654302073ffbbd202ac2794d6c9cdc56ea
+ * git.commit.hash: 671fab29f293a6a2bb863f3b1d1d00cb1c3112d5
  */
 
 import { f as fetchText, a as isCORSError, c as createTimeoutSignal, b as combineAbortSignals, d as fetchJson, i as isBrowser } from "./utils-B06SsBEd.js";

package/dist/html-generator-DOlAM9Ff.js

@@ -1,11 +1,11 @@
 /*!
  * name: mark-deco
- * version: 0.28.0
+ * version: 0.29.0
  * description: Flexible Markdown to HTML conversion library
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT
  * repository.url: https://github.com/kekyo/mark-deco
- * git.commit.hash: 124aac654302073ffbbd202ac2794d6c9cdc56ea
+ * git.commit.hash: 671fab29f293a6a2bb863f3b1d1d00cb1c3112d5
  */
 
 import * as cheerio from "cheerio";

package/dist/index.cjs

@@ -1,11 +1,11 @@
 /*!
  * name: mark-deco
- * version: 0.28.0
+ * version: 0.29.0
  * description: Flexible Markdown to HTML conversion library
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT
  * repository.url: https://github.com/kekyo/mark-deco
- * git.commit.hash: 124aac654302073ffbbd202ac2794d6c9cdc56ea
+ * git.commit.hash: 671fab29f293a6a2bb863f3b1d1d00cb1c3112d5
  */
 
 "use strict";

package/dist/index.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: mark-deco
- * version: 0.28.0
+ * version: 0.29.0
  * description: Flexible Markdown to HTML conversion library
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT
  * repository.url: https://github.com/kekyo/mark-deco
- * git.commit.hash: 124aac654302073ffbbd202ac2794d6c9cdc56ea
+ * git.commit.hash: 671fab29f293a6a2bb863f3b1d1d00cb1c3112d5
  */
 
 import { HTMLBeautifyOptions } from 'js-beautify';

package/dist/index.mjs

@@ -1,11 +1,11 @@
 /*!
  * name: mark-deco
- * version: 0.28.0
+ * version: 0.29.0
  * description: Flexible Markdown to HTML conversion library
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT
  * repository.url: https://github.com/kekyo/mark-deco
- * git.commit.hash: 124aac654302073ffbbd202ac2794d6c9cdc56ea
+ * git.commit.hash: 671fab29f293a6a2bb863f3b1d1d00cb1c3112d5
  */
 
 import __screwUpDefaultImportModule0$2 from "js-beautify";

package/dist/internal.cjs

@@ -1,11 +1,11 @@
 /*!
  * name: mark-deco
- * version: 0.28.0
+ * version: 0.29.0
  * description: Flexible Markdown to HTML conversion library
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT
  * repository.url: https://github.com/kekyo/mark-deco
- * git.commit.hash: 124aac654302073ffbbd202ac2794d6c9cdc56ea
+ * git.commit.hash: 671fab29f293a6a2bb863f3b1d1d00cb1c3112d5
  */
 
 "use strict";

package/dist/internal.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: mark-deco
- * version: 0.28.0
+ * version: 0.29.0
  * description: Flexible Markdown to HTML conversion library
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT
  * repository.url: https://github.com/kekyo/mark-deco
- * git.commit.hash: 124aac654302073ffbbd202ac2794d6c9cdc56ea
+ * git.commit.hash: 671fab29f293a6a2bb863f3b1d1d00cb1c3112d5
  */
 
 import * as cheerio_2 from 'cheerio';

package/dist/internal.mjs

@@ -1,11 +1,11 @@
 /*!
  * name: mark-deco
- * version: 0.28.0
+ * version: 0.29.0
  * description: Flexible Markdown to HTML conversion library
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT
  * repository.url: https://github.com/kekyo/mark-deco
- * git.commit.hash: 124aac654302073ffbbd202ac2794d6c9cdc56ea
+ * git.commit.hash: 671fab29f293a6a2bb863f3b1d1d00cb1c3112d5
  */
 
 import { c, e, a, b, f, d, g, h, i, r, t } from "./html-generator-DOlAM9Ff.js";

package/dist/misc.cjs

@@ -1,11 +1,11 @@
 /*!
  * name: mark-deco
- * version: 0.28.0
+ * version: 0.29.0
  * description: Flexible Markdown to HTML conversion library
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT
  * repository.url: https://github.com/kekyo/mark-deco
- * git.commit.hash: 124aac654302073ffbbd202ac2794d6c9cdc56ea
+ * git.commit.hash: 671fab29f293a6a2bb863f3b1d1d00cb1c3112d5
  */
 
 "use strict";

package/dist/misc.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: mark-deco
- * version: 0.28.0
+ * version: 0.29.0
  * description: Flexible Markdown to HTML conversion library
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT
  * repository.url: https://github.com/kekyo/mark-deco
- * git.commit.hash: 124aac654302073ffbbd202ac2794d6c9cdc56ea
+ * git.commit.hash: 671fab29f293a6a2bb863f3b1d1d00cb1c3112d5
  */
 
 import { load } from 'cheerio';

package/dist/misc.mjs

@@ -1,11 +1,11 @@
 /*!
  * name: mark-deco
- * version: 0.28.0
+ * version: 0.29.0
  * description: Flexible Markdown to HTML conversion library
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT
  * repository.url: https://github.com/kekyo/mark-deco
- * git.commit.hash: 124aac654302073ffbbd202ac2794d6c9cdc56ea
+ * git.commit.hash: 671fab29f293a6a2bb863f3b1d1d00cb1c3112d5
  */
 
 const resolveUrl = (url, baseUrl) => {

package/dist/node.cjs

@@ -1,11 +1,11 @@
 /*!
  * name: mark-deco
- * version: 0.28.0
+ * version: 0.29.0
  * description: Flexible Markdown to HTML conversion library
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT
  * repository.url: https://github.com/kekyo/mark-deco
- * git.commit.hash: 124aac654302073ffbbd202ac2794d6c9cdc56ea
+ * git.commit.hash: 671fab29f293a6a2bb863f3b1d1d00cb1c3112d5
  */
 
 "use strict";
@@ -47,13 +47,12 @@ const generateFileHash = async (input) => {
     throw new Error(`Failed to generate hash: ${error}`);
   }
 };
-const createFileSystemCacheStorage = (cacheDir, options = {}) => {
+const createFileSystemCacheStorage = (cacheDir) => {
   if (utils.isBrowser()) {
     throw new Error(
       "File system cache is only available in Node.js environment, not in browsers"
     );
   }
-  const { enableCompression = true } = options;
   const mutex = asyncPrimitives.createMutex();
   let gzipAsync = null;
   let gunzipAsync = null;
@@ -69,17 +68,12 @@ const createFileSystemCacheStorage = (cacheDir, options = {}) => {
     const hash = await generateFileHash(key);
     return hash;
   };
-  const getPlainFileName = (baseName) => `${baseName}.json`;
   const getCompressedFileName = (baseName) => `${baseName}.json.gz`;
-  const readCacheEntry = async (filePath, compressed) => {
-    if (compressed) {
-      await ensureCompression();
-      const buffer = await promises.readFile(filePath);
-      const unzipped = await gunzipAsync(buffer);
-      return JSON.parse(unzipped.toString("utf-8"));
-    }
-    const content = await promises.readFile(filePath, "utf-8");
-    return JSON.parse(content);
+  const readCacheEntry = async (filePath) => {
+    await ensureCompression();
+    const buffer = await promises.readFile(filePath);
+    const unzipped = await gunzipAsync(buffer);
+    return JSON.parse(unzipped.toString("utf-8"));
   };
   const isMissingFileError = (error) => typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
   const ensureCacheDir = async () => {
@@ -93,7 +87,6 @@ const createFileSystemCacheStorage = (cacheDir, options = {}) => {
   };
   const get = async (key) => {
     const baseName = await generateFileBaseName(key);
-    const plainFilePath = path.join(cacheDir, getPlainFileName(baseName));
     const compressedFilePath = path.join(cacheDir, getCompressedFileName(baseName));
     try {
       await ensureCacheDir();
@@ -101,45 +94,16 @@ const createFileSystemCacheStorage = (cacheDir, options = {}) => {
       throw new Error(`Failed to ensure cache directory: ${error}`);
     }
     let entry;
-    let filePath;
-    if (enableCompression) {
-      try {
-        entry = await readCacheEntry(compressedFilePath, true);
-        filePath = compressedFilePath;
-      } catch (error) {
-        if (!isMissingFileError(error)) {
-          try {
-            await promises.unlink(compressedFilePath);
-          } catch (e) {
-          }
-          return null;
-        }
+    try {
+      entry = await readCacheEntry(compressedFilePath);
+    } catch (error) {
+      if (!isMissingFileError(error)) {
         try {
-          entry = await readCacheEntry(plainFilePath, false);
-          filePath = plainFilePath;
-        } catch (plainError) {
-          if (!isMissingFileError(plainError)) {
-            try {
-              await promises.unlink(plainFilePath);
-            } catch (e) {
-            }
-          }
-          return null;
-        }
-      }
-    } else {
-      try {
-        entry = await readCacheEntry(plainFilePath, false);
-        filePath = plainFilePath;
-      } catch (error) {
-        if (!isMissingFileError(error)) {
-          try {
-            await promises.unlink(plainFilePath);
-          } catch (e) {
-          }
+          await promises.unlink(compressedFilePath);
+        } catch (e) {
         }
-        return null;
       }
+      return null;
     }
     if (entry.ttl !== void 0) {
       const isExpired = entry.ttl === 0 || Date.now() > entry.timestamp + entry.ttl;
@@ -149,18 +113,7 @@ const createFileSystemCacheStorage = (cacheDir, options = {}) => {
           const currentTime = Date.now();
           const stillExpired = entry.ttl === 0 || currentTime > entry.timestamp + entry.ttl;
           if (stillExpired) {
-            await promises.unlink(filePath);
-            if (filePath === compressedFilePath) {
-              try {
-                await promises.unlink(plainFilePath);
-              } catch (e) {
-              }
-            } else if (filePath === plainFilePath) {
-              try {
-                await promises.unlink(compressedFilePath);
-              } catch (e) {
-              }
-            }
+            await promises.unlink(compressedFilePath);
           }
           return null;
         } catch (e) {
@@ -174,7 +127,6 @@ const createFileSystemCacheStorage = (cacheDir, options = {}) => {
   };
   const set = async (key, value, ttl) => {
     const baseName = await generateFileBaseName(key);
-    const plainFilePath = path.join(cacheDir, getPlainFileName(baseName));
     const compressedFilePath = path.join(cacheDir, getCompressedFileName(baseName));
     const entry = {
       data: value,
@@ -184,32 +136,32 @@ const createFileSystemCacheStorage = (cacheDir, options = {}) => {
       entry.ttl = ttl;
     }
     const serialized = JSON.stringify(entry, null, 2);
-    let payload;
-    if (enableCompression) {
-      await ensureCompression();
-      payload = await gzipAsync(serialized);
-    } else {
-      payload = serialized;
-    }
+    await ensureCompression();
+    const payload = await gzipAsync(serialized);
     const lockHandle = await mutex.lock();
     try {
       await ensureCacheDir();
-      const filePath = enableCompression ? compressedFilePath : plainFilePath;
+      const tempSuffix = `${process.pid}-${Date.now()}-${crypto.randomBytes(6).toString("hex")}`;
+      const tempFilePath = path.join(
+        cacheDir,
+        `${baseName}.json.gz.tmp-${tempSuffix}`
+      );
       try {
-        if (enableCompression) {
-          await promises.writeFile(filePath, payload);
-          try {
-            await promises.unlink(plainFilePath);
-          } catch (e) {
-          }
-        } else {
-          await promises.writeFile(filePath, payload, "utf-8");
+        await promises.writeFile(tempFilePath, payload);
+        try {
+          await promises.rename(tempFilePath, compressedFilePath);
+        } catch (e) {
           try {
             await promises.unlink(compressedFilePath);
-          } catch (e) {
+          } catch (e2) {
           }
+          await promises.rename(tempFilePath, compressedFilePath);
         }
       } catch (error) {
+        try {
+          await promises.unlink(tempFilePath);
+        } catch (e) {
+        }
         throw new Error(`Failed to write cache entry: ${error}`);
       }
     } catch (importError) {
@@ -220,15 +172,10 @@ const createFileSystemCacheStorage = (cacheDir, options = {}) => {
   };
   const deleteEntry = async (key) => {
     const baseName = await generateFileBaseName(key);
-    const plainFilePath = path.join(cacheDir, getPlainFileName(baseName));
     const compressedFilePath = path.join(cacheDir, getCompressedFileName(baseName));
     const lockHandle = await mutex.lock();
     try {
       await ensureCacheDir();
-      try {
-        await promises.unlink(plainFilePath);
-      } catch (e) {
-      }
       try {
         await promises.unlink(compressedFilePath);
       } catch (e) {
@@ -245,7 +192,7 @@ const createFileSystemCacheStorage = (cacheDir, options = {}) => {
       await ensureCacheDir();
       const files = await promises.readdir(cacheDir);
       const cacheFiles = files.filter(
-        (file) => file.endsWith(".json") || file.endsWith(".json.gz")
+        (file) => file.endsWith(".json.gz")
       );
       for (const file of cacheFiles) {
         const filePath = path.join(cacheDir, file);
@@ -264,7 +211,7 @@ const createFileSystemCacheStorage = (cacheDir, options = {}) => {
     await ensureCacheDir();
     const files = await promises.readdir(cacheDir);
     const cacheFiles = files.filter(
-      (file) => file.endsWith(".json") || file.endsWith(".json.gz")
+      (file) => file.endsWith(".json.gz")
     );
     if (cacheFiles.length === 0) {
       return 0;
@@ -275,9 +222,8 @@ const createFileSystemCacheStorage = (cacheDir, options = {}) => {
       let validCount = 0;
       for (const file of cacheFiles) {
         const filePath = path.join(cacheDir, file);
-        const isCompressed = file.endsWith(".json.gz");
         try {
-          const entry = await readCacheEntry(filePath, isCompressed);
+          const entry = await readCacheEntry(filePath);
           if (entry.ttl !== void 0) {
             const isExpired = entry.ttl === 0 || now > entry.timestamp + entry.ttl;
             if (isExpired) {

package/dist/node.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"node.cjs","sources":["../src/cache/filesystem.ts"],"sourcesContent":["// mark-deco - Flexible Markdown to HTML conversion library\n// Copyright (c) Kouji Matsui. (@kekyo@mi.kekyo.net)\n// Under MIT.\n// https://github.com/kekyo/mark-deco\n\nimport { mkdir, readdir, readFile, unlink, writeFile } from 'fs/promises';\nimport { join } from 'path';\nimport { createHash } from 'crypto';\nimport { createMutex } from 'async-primitives';\nimport { promisify } from 'util';\n\nimport type { CacheStorage, CacheEntry } from './index';\nimport { isBrowser } from '../utils';\n\n/**\n * Generate SHA-256 hash for cache key using Node.js crypto module\n * Provides better collision resistance than simple hash algorithms\n * @param input - Input string to hash\n * @returns Promise resolving to hexadecimal hash string\n */\nconst generateFileHash = async (input: string): Promise<string> => {\n  try {\n    const hash = createHash('sha256');\n    hash.update(input, 'utf8');\n    return hash.digest('hex');\n  } catch (error) {\n    throw new Error(`Failed to generate hash: ${error}`);\n  }\n};\n\nexport interface FileSystemCacheOptions {\n  /** Enable gzip compression for cache files (default: true) */\n  enableCompression?: boolean;\n}\n\n/**\n * Create file system-based cache storage instance\n * Uses Node.js file system to store cache entries as JSON files\n * @param cacheDir - Directory path to store cache files (will be created if it doesn't exist)\n * @param options - File system cache options (optional)\n * @returns FileSystemCache instance that uses file system\n * @throws Error if file system operations fail or if not running in Node.js environment\n */\nexport const createFileSystemCacheStorage = (\n  cacheDir: string,\n  options: FileSystemCacheOptions = {}\n): CacheStorage => {\n  // Check if we're in a browser environment\n  if (isBrowser()) {\n    throw new Error(\n      'File system cache is only available in Node.js environment, not in browsers'\n    );\n  }\n\n  const { enableCompression = true } = options;\n\n  const mutex = createMutex();\n  let gzipAsync: ((input: string | Buffer) => Promise<Buffer>) | null = null;\n  let gunzipAsync: ((input: Buffer) => Promise<Buffer>) | null = null;\n\n  const ensureCompression = async (): Promise<void> => {\n    if (gzipAsync && gunzipAsync) {\n      return;\n    }\n\n    const { gzip, gunzip } = await import('zlib');\n    gzipAsync = promisify(gzip);\n    gunzipAsync = promisify(gunzip);\n  };\n\n  /**\n   * Generate safe file name from cache key using hash\n   */\n  const generateFileBaseName = async (key: string): Promise<string> => {\n    const hash = await generateFileHash(key);\n    return hash;\n  };\n\n  const getPlainFileName = (baseName: string): string => `${baseName}.json`;\n  const getCompressedFileName = (baseName: string): string =>\n    `${baseName}.json.gz`;\n\n  const readCacheEntry = async (\n    filePath: string,\n    compressed: boolean\n  ): Promise<CacheEntry> => {\n    if (compressed) {\n      await ensureCompression();\n      const buffer = await readFile(filePath);\n      const unzipped = await gunzipAsync!(buffer);\n      return JSON.parse(unzipped.toString('utf-8'));\n    }\n\n    const content = await readFile(filePath, 'utf-8');\n    return JSON.parse(content);\n  };\n\n  const isMissingFileError = (error: unknown): boolean =>\n    typeof error === 'object' &&\n    error !== null &&\n    'code' in error &&\n    (error as { code?: string }).code === 'ENOENT';\n\n  /**\n   * Ensure cache directory exists\n   * This operation is idempotent and safe to call concurrently\n   */\n  const ensureCacheDir = async (): Promise<void> => {\n    try {\n      await mkdir(cacheDir, { recursive: true });\n    } catch (error: unknown) {\n      // Ignore EEXIST errors since directory already exists\n      if ((error as { code?: string }).code !== 'EEXIST') {\n        throw new Error(`Failed to create cache directory: ${error}`);\n      }\n    }\n  };\n\n  const get = async (key: string): Promise<string | null> => {\n    // Pre-compute file name outside of lock (pure function)\n    const baseName = await generateFileBaseName(key);\n    const plainFilePath = join(cacheDir, getPlainFileName(baseName));\n    const compressedFilePath = join(cacheDir, getCompressedFileName(baseName));\n\n    // Ensure cache directory exists (idempotent operation)\n    try {\n      await ensureCacheDir();\n    } catch (error) {\n      throw new Error(`Failed to ensure cache directory: ${error}`);\n    }\n\n    let entry: CacheEntry;\n    let filePath: string;\n\n    if (enableCompression) {\n      try {\n        entry = await readCacheEntry(compressedFilePath, true);\n        filePath = compressedFilePath;\n      } catch (error) {\n        if (!isMissingFileError(error)) {\n          try {\n            await unlink(compressedFilePath);\n          } catch {\n            // Ignore cleanup errors\n          }\n          return null;\n        }\n\n        try {\n          entry = await readCacheEntry(plainFilePath, false);\n          filePath = plainFilePath;\n        } catch (plainError) {\n          if (!isMissingFileError(plainError)) {\n            try {\n              await unlink(plainFilePath);\n            } catch {\n              // Ignore cleanup errors\n            }\n          }\n          return null;\n        }\n      }\n    } else {\n      try {\n        entry = await readCacheEntry(plainFilePath, false);\n        filePath = plainFilePath;\n      } catch (error) {\n        if (!isMissingFileError(error)) {\n          try {\n            await unlink(plainFilePath);\n          } catch {\n            // Ignore cleanup errors\n          }\n        }\n        return null;\n      }\n    }\n\n    // Check TTL expiration - only lock if we need to delete expired file\n    if (entry.ttl !== undefined) {\n      const isExpired =\n        entry.ttl === 0 || Date.now() > entry.timestamp + entry.ttl;\n      if (isExpired) {\n        // Lock only for the deletion operation\n        const lockHandle = await mutex.lock();\n        try {\n          // Double-check expiration under lock to avoid race conditions\n          const currentTime = Date.now();\n          const stillExpired =\n            entry.ttl === 0 || currentTime > entry.timestamp + entry.ttl;\n          if (stillExpired) {\n            await unlink(filePath);\n            if (filePath === compressedFilePath) {\n              try {\n                await unlink(plainFilePath);\n              } catch {\n                // Ignore cleanup errors\n              }\n            } else if (filePath === plainFilePath) {\n              try {\n                await unlink(compressedFilePath);\n              } catch {\n                // Ignore cleanup errors\n              }\n            }\n          }\n          return null;\n        } catch {\n          // File might have been deleted by another process, ignore\n          return null;\n        } finally {\n          lockHandle.release();\n        }\n      }\n    }\n\n    return entry.data;\n  };\n\n  const set = async (\n    key: string,\n    value: string,\n    ttl?: number\n  ): Promise<void> => {\n    // Pre-compute everything possible outside of lock\n    const baseName = await generateFileBaseName(key);\n    const plainFilePath = join(cacheDir, getPlainFileName(baseName));\n    const compressedFilePath = join(cacheDir, getCompressedFileName(baseName));\n    const entry: CacheEntry = {\n      data: value,\n      timestamp: Date.now(),\n    };\n\n    if (ttl !== undefined) {\n      entry.ttl = ttl;\n    }\n\n    const serialized = JSON.stringify(entry, null, 2);\n    let payload: string | Buffer;\n    if (enableCompression) {\n      await ensureCompression();\n      payload = await gzipAsync!(serialized);\n    } else {\n      payload = serialized;\n    }\n\n    const lockHandle = await mutex.lock();\n    try {\n      await ensureCacheDir();\n\n      const filePath = enableCompression ? compressedFilePath : plainFilePath;\n\n      try {\n        // For cache systems, last-write-wins is often acceptable\n        // We minimize lock time by only protecting the actual write operation\n        if (enableCompression) {\n          await writeFile(filePath, payload);\n          try {\n            await unlink(plainFilePath);\n          } catch {\n            // Ignore cleanup errors\n          }\n        } else {\n          await writeFile(filePath, payload, 'utf-8');\n          try {\n            await unlink(compressedFilePath);\n          } catch {\n            // Ignore cleanup errors\n          }\n        }\n      } catch (error) {\n        throw new Error(`Failed to write cache entry: ${error}`);\n      }\n    } catch (importError) {\n      throw new Error(`Failed to import required modules: ${importError}`);\n    } finally {\n      lockHandle.release();\n    }\n  };\n\n  const deleteEntry = async (key: string): Promise<void> => {\n    // Pre-compute file name outside of lock\n    const baseName = await generateFileBaseName(key);\n    const plainFilePath = join(cacheDir, getPlainFileName(baseName));\n    const compressedFilePath = join(cacheDir, getCompressedFileName(baseName));\n\n    const lockHandle = await mutex.lock();\n    try {\n      await ensureCacheDir();\n\n      try {\n        await unlink(plainFilePath);\n      } catch {\n        // File doesn't exist, ignore the error\n      }\n\n      try {\n        await unlink(compressedFilePath);\n      } catch {\n        // File doesn't exist, ignore the error\n      }\n    } catch (importError) {\n      throw new Error(`Failed to import required modules: ${importError}`);\n    } finally {\n      lockHandle.release();\n    }\n  };\n\n  const clear = async (): Promise<void> => {\n    const lockHandle = await mutex.lock();\n    try {\n      await ensureCacheDir();\n      const files = await readdir(cacheDir);\n\n      // Filter files outside the deletion loop for better performance\n      const cacheFiles = files.filter(\n        (file: string) => file.endsWith('.json') || file.endsWith('.json.gz')\n      );\n\n      for (const file of cacheFiles) {\n        const filePath = join(cacheDir, file);\n        try {\n          await unlink(filePath);\n        } catch {\n          // Ignore individual file deletion errors\n        }\n      }\n    } catch (importError) {\n      throw new Error(`Failed to import required modules: ${importError}`);\n    } finally {\n      lockHandle.release();\n    }\n  };\n\n  const size = async (): Promise<number> => {\n    await ensureCacheDir();\n\n    // Get file list without lock first\n    const files = await readdir(cacheDir);\n    const cacheFiles = files.filter(\n      (file: string) => file.endsWith('.json') || file.endsWith('.json.gz')\n    );\n\n    if (cacheFiles.length === 0) {\n      return 0;\n    }\n\n    // Clean up expired entries with lock\n    const lockHandle = await mutex.lock();\n    try {\n      const now = Date.now();\n      let validCount = 0;\n\n      for (const file of cacheFiles) {\n        const filePath = join(cacheDir, file);\n        const isCompressed = file.endsWith('.json.gz');\n        try {\n          const entry = await readCacheEntry(filePath, isCompressed);\n\n          // Check if entry is expired\n          if (entry.ttl !== undefined) {\n            const isExpired =\n              entry.ttl === 0 || now > entry.timestamp + entry.ttl;\n            if (isExpired) {\n              await unlink(filePath);\n              continue; // Don't count this file\n            }\n          }\n          validCount++;\n        } catch {\n          // If we can't read or parse the file, delete it\n          try {\n            await unlink(filePath);\n          } catch {\n            // Ignore unlink errors\n          }\n        }\n      }\n\n      return validCount;\n    } catch (importError) {\n      throw new Error(`Failed to import required modules: ${importError}`);\n    } finally {\n      lockHandle.release();\n    }\n  };\n\n  return {\n    get,\n    set,\n    delete: deleteEntry,\n    clear,\n    size,\n  };\n};\n"],"names":["createHash","isBrowser","createMutex","promisify","readFile","mkdir","join","unlink","writeFile","readdir","e"],"mappings":"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"}
+{"version":3,"file":"node.cjs","sources":["../src/cache/filesystem.ts"],"sourcesContent":["// mark-deco - Flexible Markdown to HTML conversion library\n// Copyright (c) Kouji Matsui. (@kekyo@mi.kekyo.net)\n// Under MIT.\n// https://github.com/kekyo/mark-deco\n\nimport {\n  mkdir,\n  readdir,\n  readFile,\n  rename,\n  unlink,\n  writeFile,\n} from 'fs/promises';\nimport { join } from 'path';\nimport { createHash, randomBytes } from 'crypto';\nimport { createMutex } from 'async-primitives';\nimport { promisify } from 'util';\n\nimport type { CacheStorage, CacheEntry } from './index';\nimport { isBrowser } from '../utils';\n\n/**\n * Generate SHA-256 hash for cache key using Node.js crypto module\n * Provides better collision resistance than simple hash algorithms\n * @param input - Input string to hash\n * @returns Promise resolving to hexadecimal hash string\n */\nconst generateFileHash = async (input: string): Promise<string> => {\n  try {\n    const hash = createHash('sha256');\n    hash.update(input, 'utf8');\n    return hash.digest('hex');\n  } catch (error) {\n    throw new Error(`Failed to generate hash: ${error}`);\n  }\n};\n\n/**\n * Create file system-based cache storage instance\n * Uses Node.js file system to store cache entries as gzip-compressed JSON files\n * @param cacheDir - Directory path to store cache files (will be created if it doesn't exist)\n * @returns FileSystemCache instance that uses file system\n * @throws Error if file system operations fail or if not running in Node.js environment\n */\nexport const createFileSystemCacheStorage = (\n  cacheDir: string\n): CacheStorage => {\n  // Check if we're in a browser environment\n  if (isBrowser()) {\n    throw new Error(\n      'File system cache is only available in Node.js environment, not in browsers'\n    );\n  }\n\n  const mutex = createMutex();\n  let gzipAsync: ((input: string | Buffer) => Promise<Buffer>) | null = null;\n  let gunzipAsync: ((input: Buffer) => Promise<Buffer>) | null = null;\n\n  const ensureCompression = async (): Promise<void> => {\n    if (gzipAsync && gunzipAsync) {\n      return;\n    }\n\n    const { gzip, gunzip } = await import('zlib');\n    gzipAsync = promisify(gzip);\n    gunzipAsync = promisify(gunzip);\n  };\n\n  /**\n   * Generate safe file name from cache key using hash\n   */\n  const generateFileBaseName = async (key: string): Promise<string> => {\n    const hash = await generateFileHash(key);\n    return hash;\n  };\n\n  const getCompressedFileName = (baseName: string): string =>\n    `${baseName}.json.gz`;\n\n  const readCacheEntry = async (filePath: string): Promise<CacheEntry> => {\n    await ensureCompression();\n    const buffer = await readFile(filePath);\n    const unzipped = await gunzipAsync!(buffer);\n    return JSON.parse(unzipped.toString('utf-8'));\n  };\n\n  const isMissingFileError = (error: unknown): boolean =>\n    typeof error === 'object' &&\n    error !== null &&\n    'code' in error &&\n    (error as { code?: string }).code === 'ENOENT';\n\n  /**\n   * Ensure cache directory exists\n   * This operation is idempotent and safe to call concurrently\n   */\n  const ensureCacheDir = async (): Promise<void> => {\n    try {\n      await mkdir(cacheDir, { recursive: true });\n    } catch (error: unknown) {\n      // Ignore EEXIST errors since directory already exists\n      if ((error as { code?: string }).code !== 'EEXIST') {\n        throw new Error(`Failed to create cache directory: ${error}`);\n      }\n    }\n  };\n\n  const get = async (key: string): Promise<string | null> => {\n    // Pre-compute file name outside of lock (pure function)\n    const baseName = await generateFileBaseName(key);\n    const compressedFilePath = join(cacheDir, getCompressedFileName(baseName));\n\n    // Ensure cache directory exists (idempotent operation)\n    try {\n      await ensureCacheDir();\n    } catch (error) {\n      throw new Error(`Failed to ensure cache directory: ${error}`);\n    }\n\n    let entry: CacheEntry;\n\n    try {\n      entry = await readCacheEntry(compressedFilePath);\n    } catch (error) {\n      if (!isMissingFileError(error)) {\n        try {\n          await unlink(compressedFilePath);\n        } catch {\n          // Ignore cleanup errors\n        }\n      }\n      return null;\n    }\n\n    // Check TTL expiration - only lock if we need to delete expired file\n    if (entry.ttl !== undefined) {\n      const isExpired =\n        entry.ttl === 0 || Date.now() > entry.timestamp + entry.ttl;\n      if (isExpired) {\n        // Lock only for the deletion operation\n        const lockHandle = await mutex.lock();\n        try {\n          // Double-check expiration under lock to avoid race conditions\n          const currentTime = Date.now();\n          const stillExpired =\n            entry.ttl === 0 || currentTime > entry.timestamp + entry.ttl;\n          if (stillExpired) {\n            await unlink(compressedFilePath);\n          }\n          return null;\n        } catch {\n          // File might have been deleted by another process, ignore\n          return null;\n        } finally {\n          lockHandle.release();\n        }\n      }\n    }\n\n    return entry.data;\n  };\n\n  const set = async (\n    key: string,\n    value: string,\n    ttl?: number\n  ): Promise<void> => {\n    // Pre-compute everything possible outside of lock\n    const baseName = await generateFileBaseName(key);\n    const compressedFilePath = join(cacheDir, getCompressedFileName(baseName));\n    const entry: CacheEntry = {\n      data: value,\n      timestamp: Date.now(),\n    };\n\n    if (ttl !== undefined) {\n      entry.ttl = ttl;\n    }\n\n    const serialized = JSON.stringify(entry, null, 2);\n    await ensureCompression();\n    const payload = await gzipAsync!(serialized);\n\n    const lockHandle = await mutex.lock();\n    try {\n      await ensureCacheDir();\n\n      const tempSuffix = `${process.pid}-${Date.now()}-${randomBytes(6).toString('hex')}`;\n      const tempFilePath = join(\n        cacheDir,\n        `${baseName}.json.gz.tmp-${tempSuffix}`\n      );\n\n      try {\n        // Write to a temp file then rename to avoid partial reads.\n        await writeFile(tempFilePath, payload);\n        try {\n          await rename(tempFilePath, compressedFilePath);\n        } catch {\n          // Fallback: remove existing file then rename (Windows-friendly).\n          try {\n            await unlink(compressedFilePath);\n          } catch {\n            // Ignore cleanup errors\n          }\n          await rename(tempFilePath, compressedFilePath);\n        }\n      } catch (error) {\n        try {\n          // Best-effort cleanup of temp file\n          await unlink(tempFilePath);\n        } catch {\n          // Ignore cleanup errors\n        }\n        throw new Error(`Failed to write cache entry: ${error}`);\n      }\n    } catch (importError) {\n      throw new Error(`Failed to import required modules: ${importError}`);\n    } finally {\n      lockHandle.release();\n    }\n  };\n\n  const deleteEntry = async (key: string): Promise<void> => {\n    // Pre-compute file name outside of lock\n    const baseName = await generateFileBaseName(key);\n    const compressedFilePath = join(cacheDir, getCompressedFileName(baseName));\n\n    const lockHandle = await mutex.lock();\n    try {\n      await ensureCacheDir();\n\n      try {\n        await unlink(compressedFilePath);\n      } catch {\n        // File doesn't exist, ignore the error\n      }\n    } catch (importError) {\n      throw new Error(`Failed to import required modules: ${importError}`);\n    } finally {\n      lockHandle.release();\n    }\n  };\n\n  const clear = async (): Promise<void> => {\n    const lockHandle = await mutex.lock();\n    try {\n      await ensureCacheDir();\n      const files = await readdir(cacheDir);\n\n      // Filter files outside the deletion loop for better performance\n      const cacheFiles = files.filter((file: string) =>\n        file.endsWith('.json.gz')\n      );\n\n      for (const file of cacheFiles) {\n        const filePath = join(cacheDir, file);\n        try {\n          await unlink(filePath);\n        } catch {\n          // Ignore individual file deletion errors\n        }\n      }\n    } catch (importError) {\n      throw new Error(`Failed to import required modules: ${importError}`);\n    } finally {\n      lockHandle.release();\n    }\n  };\n\n  const size = async (): Promise<number> => {\n    await ensureCacheDir();\n\n    // Get file list without lock first\n    const files = await readdir(cacheDir);\n    const cacheFiles = files.filter((file: string) =>\n      file.endsWith('.json.gz')\n    );\n\n    if (cacheFiles.length === 0) {\n      return 0;\n    }\n\n    // Clean up expired entries with lock\n    const lockHandle = await mutex.lock();\n    try {\n      const now = Date.now();\n      let validCount = 0;\n\n      for (const file of cacheFiles) {\n        const filePath = join(cacheDir, file);\n        try {\n          const entry = await readCacheEntry(filePath);\n\n          // Check if entry is expired\n          if (entry.ttl !== undefined) {\n            const isExpired =\n              entry.ttl === 0 || now > entry.timestamp + entry.ttl;\n            if (isExpired) {\n              await unlink(filePath);\n              continue; // Don't count this file\n            }\n          }\n          validCount++;\n        } catch {\n          // If we can't read or parse the file, delete it\n          try {\n            await unlink(filePath);\n          } catch {\n            // Ignore unlink errors\n          }\n        }\n      }\n\n      return validCount;\n    } catch (importError) {\n      throw new Error(`Failed to import required modules: ${importError}`);\n    } finally {\n      lockHandle.release();\n    }\n  };\n\n  return {\n    get,\n    set,\n    delete: deleteEntry,\n    clear,\n    size,\n  };\n};\n"],"names":["createHash","isBrowser","createMutex","promisify","readFile","mkdir","join","unlink","randomBytes","writeFile","rename","e","readdir"],"mappings":"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"}

package/dist/node.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: mark-deco
- * version: 0.28.0
+ * version: 0.29.0
  * description: Flexible Markdown to HTML conversion library
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT
  * repository.url: https://github.com/kekyo/mark-deco
- * git.commit.hash: 124aac654302073ffbbd202ac2794d6c9cdc56ea
+ * git.commit.hash: 671fab29f293a6a2bb863f3b1d1d00cb1c3112d5
  */
 
 /**
@@ -26,17 +26,11 @@ declare interface CacheStorage_2 {
 
 /**
  * Create file system-based cache storage instance
- * Uses Node.js file system to store cache entries as JSON files
+ * Uses Node.js file system to store cache entries as gzip-compressed JSON files
  * @param cacheDir - Directory path to store cache files (will be created if it doesn't exist)
- * @param options - File system cache options (optional)
  * @returns FileSystemCache instance that uses file system
  * @throws Error if file system operations fail or if not running in Node.js environment
  */
-export declare const createFileSystemCacheStorage: (cacheDir: string, options?: FileSystemCacheOptions) => CacheStorage_2;
-
-export declare interface FileSystemCacheOptions {
-    /** Enable gzip compression for cache files (default: true) */
-    enableCompression?: boolean;
-}
+export declare const createFileSystemCacheStorage: (cacheDir: string) => CacheStorage_2;
 
 export { }

package/dist/node.mjs

@@ -1,16 +1,16 @@
 /*!
  * name: mark-deco
- * version: 0.28.0
+ * version: 0.29.0
  * description: Flexible Markdown to HTML conversion library
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT
  * repository.url: https://github.com/kekyo/mark-deco
- * git.commit.hash: 124aac654302073ffbbd202ac2794d6c9cdc56ea
+ * git.commit.hash: 671fab29f293a6a2bb863f3b1d1d00cb1c3112d5
  */
 
-import { readdir, unlink, writeFile, mkdir, readFile } from "fs/promises";
+import { readdir, unlink, writeFile, rename, mkdir, readFile } from "fs/promises";
 import { join } from "path";
-import { createHash } from "crypto";
+import { randomBytes, createHash } from "crypto";
 import { createMutex } from "async-primitives";
 import { promisify } from "util";
 import { i as isBrowser } from "./utils-B06SsBEd.js";
@@ -23,13 +23,12 @@ const generateFileHash = async (input) => {
     throw new Error(`Failed to generate hash: ${error}`);
   }
 };
-const createFileSystemCacheStorage = (cacheDir, options = {}) => {
+const createFileSystemCacheStorage = (cacheDir) => {
   if (isBrowser()) {
     throw new Error(
       "File system cache is only available in Node.js environment, not in browsers"
     );
   }
-  const { enableCompression = true } = options;
   const mutex = createMutex();
   let gzipAsync = null;
   let gunzipAsync = null;
@@ -45,17 +44,12 @@ const createFileSystemCacheStorage = (cacheDir, options = {}) => {
     const hash = await generateFileHash(key);
     return hash;
   };
-  const getPlainFileName = (baseName) => `${baseName}.json`;
   const getCompressedFileName = (baseName) => `${baseName}.json.gz`;
-  const readCacheEntry = async (filePath, compressed) => {
-    if (compressed) {
-      await ensureCompression();
-      const buffer = await readFile(filePath);
-      const unzipped = await gunzipAsync(buffer);
-      return JSON.parse(unzipped.toString("utf-8"));
-    }
-    const content = await readFile(filePath, "utf-8");
-    return JSON.parse(content);
+  const readCacheEntry = async (filePath) => {
+    await ensureCompression();
+    const buffer = await readFile(filePath);
+    const unzipped = await gunzipAsync(buffer);
+    return JSON.parse(unzipped.toString("utf-8"));
   };
   const isMissingFileError = (error) => typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
   const ensureCacheDir = async () => {
@@ -69,7 +63,6 @@ const createFileSystemCacheStorage = (cacheDir, options = {}) => {
   };
   const get = async (key) => {
     const baseName = await generateFileBaseName(key);
-    const plainFilePath = join(cacheDir, getPlainFileName(baseName));
     const compressedFilePath = join(cacheDir, getCompressedFileName(baseName));
     try {
       await ensureCacheDir();
@@ -77,45 +70,16 @@ const createFileSystemCacheStorage = (cacheDir, options = {}) => {
       throw new Error(`Failed to ensure cache directory: ${error}`);
     }
     let entry;
-    let filePath;
-    if (enableCompression) {
-      try {
-        entry = await readCacheEntry(compressedFilePath, true);
-        filePath = compressedFilePath;
-      } catch (error) {
-        if (!isMissingFileError(error)) {
-          try {
-            await unlink(compressedFilePath);
-          } catch (e) {
-          }
-          return null;
-        }
+    try {
+      entry = await readCacheEntry(compressedFilePath);
+    } catch (error) {
+      if (!isMissingFileError(error)) {
         try {
-          entry = await readCacheEntry(plainFilePath, false);
-          filePath = plainFilePath;
-        } catch (plainError) {
-          if (!isMissingFileError(plainError)) {
-            try {
-              await unlink(plainFilePath);
-            } catch (e) {
-            }
-          }
-          return null;
-        }
-      }
-    } else {
-      try {
-        entry = await readCacheEntry(plainFilePath, false);
-        filePath = plainFilePath;
-      } catch (error) {
-        if (!isMissingFileError(error)) {
-          try {
-            await unlink(plainFilePath);
-          } catch (e) {
-          }
+          await unlink(compressedFilePath);
+        } catch (e) {
         }
-        return null;
       }
+      return null;
     }
     if (entry.ttl !== void 0) {
       const isExpired = entry.ttl === 0 || Date.now() > entry.timestamp + entry.ttl;
@@ -125,18 +89,7 @@ const createFileSystemCacheStorage = (cacheDir, options = {}) => {
           const currentTime = Date.now();
           const stillExpired = entry.ttl === 0 || currentTime > entry.timestamp + entry.ttl;
           if (stillExpired) {
-            await unlink(filePath);
-            if (filePath === compressedFilePath) {
-              try {
-                await unlink(plainFilePath);
-              } catch (e) {
-              }
-            } else if (filePath === plainFilePath) {
-              try {
-                await unlink(compressedFilePath);
-              } catch (e) {
-              }
-            }
+            await unlink(compressedFilePath);
           }
           return null;
         } catch (e) {
@@ -150,7 +103,6 @@ const createFileSystemCacheStorage = (cacheDir, options = {}) => {
   };
   const set = async (key, value, ttl) => {
     const baseName = await generateFileBaseName(key);
-    const plainFilePath = join(cacheDir, getPlainFileName(baseName));
     const compressedFilePath = join(cacheDir, getCompressedFileName(baseName));
     const entry = {
       data: value,
@@ -160,32 +112,32 @@ const createFileSystemCacheStorage = (cacheDir, options = {}) => {
       entry.ttl = ttl;
     }
     const serialized = JSON.stringify(entry, null, 2);
-    let payload;
-    if (enableCompression) {
-      await ensureCompression();
-      payload = await gzipAsync(serialized);
-    } else {
-      payload = serialized;
-    }
+    await ensureCompression();
+    const payload = await gzipAsync(serialized);
     const lockHandle = await mutex.lock();
     try {
       await ensureCacheDir();
-      const filePath = enableCompression ? compressedFilePath : plainFilePath;
+      const tempSuffix = `${process.pid}-${Date.now()}-${randomBytes(6).toString("hex")}`;
+      const tempFilePath = join(
+        cacheDir,
+        `${baseName}.json.gz.tmp-${tempSuffix}`
+      );
       try {
-        if (enableCompression) {
-          await writeFile(filePath, payload);
-          try {
-            await unlink(plainFilePath);
-          } catch (e) {
-          }
-        } else {
-          await writeFile(filePath, payload, "utf-8");
+        await writeFile(tempFilePath, payload);
+        try {
+          await rename(tempFilePath, compressedFilePath);
+        } catch (e) {
           try {
             await unlink(compressedFilePath);
-          } catch (e) {
+          } catch (e2) {
           }
+          await rename(tempFilePath, compressedFilePath);
         }
       } catch (error) {
+        try {
+          await unlink(tempFilePath);
+        } catch (e) {
+        }
         throw new Error(`Failed to write cache entry: ${error}`);
       }
     } catch (importError) {
@@ -196,15 +148,10 @@ const createFileSystemCacheStorage = (cacheDir, options = {}) => {
   };
   const deleteEntry = async (key) => {
     const baseName = await generateFileBaseName(key);
-    const plainFilePath = join(cacheDir, getPlainFileName(baseName));
     const compressedFilePath = join(cacheDir, getCompressedFileName(baseName));
     const lockHandle = await mutex.lock();
     try {
       await ensureCacheDir();
-      try {
-        await unlink(plainFilePath);
-      } catch (e) {
-      }
       try {
         await unlink(compressedFilePath);
       } catch (e) {
@@ -221,7 +168,7 @@ const createFileSystemCacheStorage = (cacheDir, options = {}) => {
       await ensureCacheDir();
       const files = await readdir(cacheDir);
       const cacheFiles = files.filter(
-        (file) => file.endsWith(".json") || file.endsWith(".json.gz")
+        (file) => file.endsWith(".json.gz")
       );
       for (const file of cacheFiles) {
         const filePath = join(cacheDir, file);
@@ -240,7 +187,7 @@ const createFileSystemCacheStorage = (cacheDir, options = {}) => {
     await ensureCacheDir();
     const files = await readdir(cacheDir);
     const cacheFiles = files.filter(
-      (file) => file.endsWith(".json") || file.endsWith(".json.gz")
+      (file) => file.endsWith(".json.gz")
     );
     if (cacheFiles.length === 0) {
       return 0;
@@ -251,9 +198,8 @@ const createFileSystemCacheStorage = (cacheDir, options = {}) => {
       let validCount = 0;
       for (const file of cacheFiles) {
         const filePath = join(cacheDir, file);
-        const isCompressed = file.endsWith(".json.gz");
         try {
-          const entry = await readCacheEntry(filePath, isCompressed);
+          const entry = await readCacheEntry(filePath);
           if (entry.ttl !== void 0) {
             const isExpired = entry.ttl === 0 || now > entry.timestamp + entry.ttl;
             if (isExpired) {

package/dist/node.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"node.mjs","sources":["../src/cache/filesystem.ts"],"sourcesContent":["// mark-deco - Flexible Markdown to HTML conversion library\n// Copyright (c) Kouji Matsui. (@kekyo@mi.kekyo.net)\n// Under MIT.\n// https://github.com/kekyo/mark-deco\n\nimport { mkdir, readdir, readFile, unlink, writeFile } from 'fs/promises';\nimport { join } from 'path';\nimport { createHash } from 'crypto';\nimport { createMutex } from 'async-primitives';\nimport { promisify } from 'util';\n\nimport type { CacheStorage, CacheEntry } from './index';\nimport { isBrowser } from '../utils';\n\n/**\n * Generate SHA-256 hash for cache key using Node.js crypto module\n * Provides better collision resistance than simple hash algorithms\n * @param input - Input string to hash\n * @returns Promise resolving to hexadecimal hash string\n */\nconst generateFileHash = async (input: string): Promise<string> => {\n  try {\n    const hash = createHash('sha256');\n    hash.update(input, 'utf8');\n    return hash.digest('hex');\n  } catch (error) {\n    throw new Error(`Failed to generate hash: ${error}`);\n  }\n};\n\nexport interface FileSystemCacheOptions {\n  /** Enable gzip compression for cache files (default: true) */\n  enableCompression?: boolean;\n}\n\n/**\n * Create file system-based cache storage instance\n * Uses Node.js file system to store cache entries as JSON files\n * @param cacheDir - Directory path to store cache files (will be created if it doesn't exist)\n * @param options - File system cache options (optional)\n * @returns FileSystemCache instance that uses file system\n * @throws Error if file system operations fail or if not running in Node.js environment\n */\nexport const createFileSystemCacheStorage = (\n  cacheDir: string,\n  options: FileSystemCacheOptions = {}\n): CacheStorage => {\n  // Check if we're in a browser environment\n  if (isBrowser()) {\n    throw new Error(\n      'File system cache is only available in Node.js environment, not in browsers'\n    );\n  }\n\n  const { enableCompression = true } = options;\n\n  const mutex = createMutex();\n  let gzipAsync: ((input: string | Buffer) => Promise<Buffer>) | null = null;\n  let gunzipAsync: ((input: Buffer) => Promise<Buffer>) | null = null;\n\n  const ensureCompression = async (): Promise<void> => {\n    if (gzipAsync && gunzipAsync) {\n      return;\n    }\n\n    const { gzip, gunzip } = await import('zlib');\n    gzipAsync = promisify(gzip);\n    gunzipAsync = promisify(gunzip);\n  };\n\n  /**\n   * Generate safe file name from cache key using hash\n   */\n  const generateFileBaseName = async (key: string): Promise<string> => {\n    const hash = await generateFileHash(key);\n    return hash;\n  };\n\n  const getPlainFileName = (baseName: string): string => `${baseName}.json`;\n  const getCompressedFileName = (baseName: string): string =>\n    `${baseName}.json.gz`;\n\n  const readCacheEntry = async (\n    filePath: string,\n    compressed: boolean\n  ): Promise<CacheEntry> => {\n    if (compressed) {\n      await ensureCompression();\n      const buffer = await readFile(filePath);\n      const unzipped = await gunzipAsync!(buffer);\n      return JSON.parse(unzipped.toString('utf-8'));\n    }\n\n    const content = await readFile(filePath, 'utf-8');\n    return JSON.parse(content);\n  };\n\n  const isMissingFileError = (error: unknown): boolean =>\n    typeof error === 'object' &&\n    error !== null &&\n    'code' in error &&\n    (error as { code?: string }).code === 'ENOENT';\n\n  /**\n   * Ensure cache directory exists\n   * This operation is idempotent and safe to call concurrently\n   */\n  const ensureCacheDir = async (): Promise<void> => {\n    try {\n      await mkdir(cacheDir, { recursive: true });\n    } catch (error: unknown) {\n      // Ignore EEXIST errors since directory already exists\n      if ((error as { code?: string }).code !== 'EEXIST') {\n        throw new Error(`Failed to create cache directory: ${error}`);\n      }\n    }\n  };\n\n  const get = async (key: string): Promise<string | null> => {\n    // Pre-compute file name outside of lock (pure function)\n    const baseName = await generateFileBaseName(key);\n    const plainFilePath = join(cacheDir, getPlainFileName(baseName));\n    const compressedFilePath = join(cacheDir, getCompressedFileName(baseName));\n\n    // Ensure cache directory exists (idempotent operation)\n    try {\n      await ensureCacheDir();\n    } catch (error) {\n      throw new Error(`Failed to ensure cache directory: ${error}`);\n    }\n\n    let entry: CacheEntry;\n    let filePath: string;\n\n    if (enableCompression) {\n      try {\n        entry = await readCacheEntry(compressedFilePath, true);\n        filePath = compressedFilePath;\n      } catch (error) {\n        if (!isMissingFileError(error)) {\n          try {\n            await unlink(compressedFilePath);\n          } catch {\n            // Ignore cleanup errors\n          }\n          return null;\n        }\n\n        try {\n          entry = await readCacheEntry(plainFilePath, false);\n          filePath = plainFilePath;\n        } catch (plainError) {\n          if (!isMissingFileError(plainError)) {\n            try {\n              await unlink(plainFilePath);\n            } catch {\n              // Ignore cleanup errors\n            }\n          }\n          return null;\n        }\n      }\n    } else {\n      try {\n        entry = await readCacheEntry(plainFilePath, false);\n        filePath = plainFilePath;\n      } catch (error) {\n        if (!isMissingFileError(error)) {\n          try {\n            await unlink(plainFilePath);\n          } catch {\n            // Ignore cleanup errors\n          }\n        }\n        return null;\n      }\n    }\n\n    // Check TTL expiration - only lock if we need to delete expired file\n    if (entry.ttl !== undefined) {\n      const isExpired =\n        entry.ttl === 0 || Date.now() > entry.timestamp + entry.ttl;\n      if (isExpired) {\n        // Lock only for the deletion operation\n        const lockHandle = await mutex.lock();\n        try {\n          // Double-check expiration under lock to avoid race conditions\n          const currentTime = Date.now();\n          const stillExpired =\n            entry.ttl === 0 || currentTime > entry.timestamp + entry.ttl;\n          if (stillExpired) {\n            await unlink(filePath);\n            if (filePath === compressedFilePath) {\n              try {\n                await unlink(plainFilePath);\n              } catch {\n                // Ignore cleanup errors\n              }\n            } else if (filePath === plainFilePath) {\n              try {\n                await unlink(compressedFilePath);\n              } catch {\n                // Ignore cleanup errors\n              }\n            }\n          }\n          return null;\n        } catch {\n          // File might have been deleted by another process, ignore\n          return null;\n        } finally {\n          lockHandle.release();\n        }\n      }\n    }\n\n    return entry.data;\n  };\n\n  const set = async (\n    key: string,\n    value: string,\n    ttl?: number\n  ): Promise<void> => {\n    // Pre-compute everything possible outside of lock\n    const baseName = await generateFileBaseName(key);\n    const plainFilePath = join(cacheDir, getPlainFileName(baseName));\n    const compressedFilePath = join(cacheDir, getCompressedFileName(baseName));\n    const entry: CacheEntry = {\n      data: value,\n      timestamp: Date.now(),\n    };\n\n    if (ttl !== undefined) {\n      entry.ttl = ttl;\n    }\n\n    const serialized = JSON.stringify(entry, null, 2);\n    let payload: string | Buffer;\n    if (enableCompression) {\n      await ensureCompression();\n      payload = await gzipAsync!(serialized);\n    } else {\n      payload = serialized;\n    }\n\n    const lockHandle = await mutex.lock();\n    try {\n      await ensureCacheDir();\n\n      const filePath = enableCompression ? compressedFilePath : plainFilePath;\n\n      try {\n        // For cache systems, last-write-wins is often acceptable\n        // We minimize lock time by only protecting the actual write operation\n        if (enableCompression) {\n          await writeFile(filePath, payload);\n          try {\n            await unlink(plainFilePath);\n          } catch {\n            // Ignore cleanup errors\n          }\n        } else {\n          await writeFile(filePath, payload, 'utf-8');\n          try {\n            await unlink(compressedFilePath);\n          } catch {\n            // Ignore cleanup errors\n          }\n        }\n      } catch (error) {\n        throw new Error(`Failed to write cache entry: ${error}`);\n      }\n    } catch (importError) {\n      throw new Error(`Failed to import required modules: ${importError}`);\n    } finally {\n      lockHandle.release();\n    }\n  };\n\n  const deleteEntry = async (key: string): Promise<void> => {\n    // Pre-compute file name outside of lock\n    const baseName = await generateFileBaseName(key);\n    const plainFilePath = join(cacheDir, getPlainFileName(baseName));\n    const compressedFilePath = join(cacheDir, getCompressedFileName(baseName));\n\n    const lockHandle = await mutex.lock();\n    try {\n      await ensureCacheDir();\n\n      try {\n        await unlink(plainFilePath);\n      } catch {\n        // File doesn't exist, ignore the error\n      }\n\n      try {\n        await unlink(compressedFilePath);\n      } catch {\n        // File doesn't exist, ignore the error\n      }\n    } catch (importError) {\n      throw new Error(`Failed to import required modules: ${importError}`);\n    } finally {\n      lockHandle.release();\n    }\n  };\n\n  const clear = async (): Promise<void> => {\n    const lockHandle = await mutex.lock();\n    try {\n      await ensureCacheDir();\n      const files = await readdir(cacheDir);\n\n      // Filter files outside the deletion loop for better performance\n      const cacheFiles = files.filter(\n        (file: string) => file.endsWith('.json') || file.endsWith('.json.gz')\n      );\n\n      for (const file of cacheFiles) {\n        const filePath = join(cacheDir, file);\n        try {\n          await unlink(filePath);\n        } catch {\n          // Ignore individual file deletion errors\n        }\n      }\n    } catch (importError) {\n      throw new Error(`Failed to import required modules: ${importError}`);\n    } finally {\n      lockHandle.release();\n    }\n  };\n\n  const size = async (): Promise<number> => {\n    await ensureCacheDir();\n\n    // Get file list without lock first\n    const files = await readdir(cacheDir);\n    const cacheFiles = files.filter(\n      (file: string) => file.endsWith('.json') || file.endsWith('.json.gz')\n    );\n\n    if (cacheFiles.length === 0) {\n      return 0;\n    }\n\n    // Clean up expired entries with lock\n    const lockHandle = await mutex.lock();\n    try {\n      const now = Date.now();\n      let validCount = 0;\n\n      for (const file of cacheFiles) {\n        const filePath = join(cacheDir, file);\n        const isCompressed = file.endsWith('.json.gz');\n        try {\n          const entry = await readCacheEntry(filePath, isCompressed);\n\n          // Check if entry is expired\n          if (entry.ttl !== undefined) {\n            const isExpired =\n              entry.ttl === 0 || now > entry.timestamp + entry.ttl;\n            if (isExpired) {\n              await unlink(filePath);\n              continue; // Don't count this file\n            }\n          }\n          validCount++;\n        } catch {\n          // If we can't read or parse the file, delete it\n          try {\n            await unlink(filePath);\n          } catch {\n            // Ignore unlink errors\n          }\n        }\n      }\n\n      return validCount;\n    } catch (importError) {\n      throw new Error(`Failed to import required modules: ${importError}`);\n    } finally {\n      lockHandle.release();\n    }\n  };\n\n  return {\n    get,\n    set,\n    delete: deleteEntry,\n    clear,\n    size,\n  };\n};\n"],"names":["e"],"mappings":"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"}
+{"version":3,"file":"node.mjs","sources":["../src/cache/filesystem.ts"],"sourcesContent":["// mark-deco - Flexible Markdown to HTML conversion library\n// Copyright (c) Kouji Matsui. (@kekyo@mi.kekyo.net)\n// Under MIT.\n// https://github.com/kekyo/mark-deco\n\nimport {\n  mkdir,\n  readdir,\n  readFile,\n  rename,\n  unlink,\n  writeFile,\n} from 'fs/promises';\nimport { join } from 'path';\nimport { createHash, randomBytes } from 'crypto';\nimport { createMutex } from 'async-primitives';\nimport { promisify } from 'util';\n\nimport type { CacheStorage, CacheEntry } from './index';\nimport { isBrowser } from '../utils';\n\n/**\n * Generate SHA-256 hash for cache key using Node.js crypto module\n * Provides better collision resistance than simple hash algorithms\n * @param input - Input string to hash\n * @returns Promise resolving to hexadecimal hash string\n */\nconst generateFileHash = async (input: string): Promise<string> => {\n  try {\n    const hash = createHash('sha256');\n    hash.update(input, 'utf8');\n    return hash.digest('hex');\n  } catch (error) {\n    throw new Error(`Failed to generate hash: ${error}`);\n  }\n};\n\n/**\n * Create file system-based cache storage instance\n * Uses Node.js file system to store cache entries as gzip-compressed JSON files\n * @param cacheDir - Directory path to store cache files (will be created if it doesn't exist)\n * @returns FileSystemCache instance that uses file system\n * @throws Error if file system operations fail or if not running in Node.js environment\n */\nexport const createFileSystemCacheStorage = (\n  cacheDir: string\n): CacheStorage => {\n  // Check if we're in a browser environment\n  if (isBrowser()) {\n    throw new Error(\n      'File system cache is only available in Node.js environment, not in browsers'\n    );\n  }\n\n  const mutex = createMutex();\n  let gzipAsync: ((input: string | Buffer) => Promise<Buffer>) | null = null;\n  let gunzipAsync: ((input: Buffer) => Promise<Buffer>) | null = null;\n\n  const ensureCompression = async (): Promise<void> => {\n    if (gzipAsync && gunzipAsync) {\n      return;\n    }\n\n    const { gzip, gunzip } = await import('zlib');\n    gzipAsync = promisify(gzip);\n    gunzipAsync = promisify(gunzip);\n  };\n\n  /**\n   * Generate safe file name from cache key using hash\n   */\n  const generateFileBaseName = async (key: string): Promise<string> => {\n    const hash = await generateFileHash(key);\n    return hash;\n  };\n\n  const getCompressedFileName = (baseName: string): string =>\n    `${baseName}.json.gz`;\n\n  const readCacheEntry = async (filePath: string): Promise<CacheEntry> => {\n    await ensureCompression();\n    const buffer = await readFile(filePath);\n    const unzipped = await gunzipAsync!(buffer);\n    return JSON.parse(unzipped.toString('utf-8'));\n  };\n\n  const isMissingFileError = (error: unknown): boolean =>\n    typeof error === 'object' &&\n    error !== null &&\n    'code' in error &&\n    (error as { code?: string }).code === 'ENOENT';\n\n  /**\n   * Ensure cache directory exists\n   * This operation is idempotent and safe to call concurrently\n   */\n  const ensureCacheDir = async (): Promise<void> => {\n    try {\n      await mkdir(cacheDir, { recursive: true });\n    } catch (error: unknown) {\n      // Ignore EEXIST errors since directory already exists\n      if ((error as { code?: string }).code !== 'EEXIST') {\n        throw new Error(`Failed to create cache directory: ${error}`);\n      }\n    }\n  };\n\n  const get = async (key: string): Promise<string | null> => {\n    // Pre-compute file name outside of lock (pure function)\n    const baseName = await generateFileBaseName(key);\n    const compressedFilePath = join(cacheDir, getCompressedFileName(baseName));\n\n    // Ensure cache directory exists (idempotent operation)\n    try {\n      await ensureCacheDir();\n    } catch (error) {\n      throw new Error(`Failed to ensure cache directory: ${error}`);\n    }\n\n    let entry: CacheEntry;\n\n    try {\n      entry = await readCacheEntry(compressedFilePath);\n    } catch (error) {\n      if (!isMissingFileError(error)) {\n        try {\n          await unlink(compressedFilePath);\n        } catch {\n          // Ignore cleanup errors\n        }\n      }\n      return null;\n    }\n\n    // Check TTL expiration - only lock if we need to delete expired file\n    if (entry.ttl !== undefined) {\n      const isExpired =\n        entry.ttl === 0 || Date.now() > entry.timestamp + entry.ttl;\n      if (isExpired) {\n        // Lock only for the deletion operation\n        const lockHandle = await mutex.lock();\n        try {\n          // Double-check expiration under lock to avoid race conditions\n          const currentTime = Date.now();\n          const stillExpired =\n            entry.ttl === 0 || currentTime > entry.timestamp + entry.ttl;\n          if (stillExpired) {\n            await unlink(compressedFilePath);\n          }\n          return null;\n        } catch {\n          // File might have been deleted by another process, ignore\n          return null;\n        } finally {\n          lockHandle.release();\n        }\n      }\n    }\n\n    return entry.data;\n  };\n\n  const set = async (\n    key: string,\n    value: string,\n    ttl?: number\n  ): Promise<void> => {\n    // Pre-compute everything possible outside of lock\n    const baseName = await generateFileBaseName(key);\n    const compressedFilePath = join(cacheDir, getCompressedFileName(baseName));\n    const entry: CacheEntry = {\n      data: value,\n      timestamp: Date.now(),\n    };\n\n    if (ttl !== undefined) {\n      entry.ttl = ttl;\n    }\n\n    const serialized = JSON.stringify(entry, null, 2);\n    await ensureCompression();\n    const payload = await gzipAsync!(serialized);\n\n    const lockHandle = await mutex.lock();\n    try {\n      await ensureCacheDir();\n\n      const tempSuffix = `${process.pid}-${Date.now()}-${randomBytes(6).toString('hex')}`;\n      const tempFilePath = join(\n        cacheDir,\n        `${baseName}.json.gz.tmp-${tempSuffix}`\n      );\n\n      try {\n        // Write to a temp file then rename to avoid partial reads.\n        await writeFile(tempFilePath, payload);\n        try {\n          await rename(tempFilePath, compressedFilePath);\n        } catch {\n          // Fallback: remove existing file then rename (Windows-friendly).\n          try {\n            await unlink(compressedFilePath);\n          } catch {\n            // Ignore cleanup errors\n          }\n          await rename(tempFilePath, compressedFilePath);\n        }\n      } catch (error) {\n        try {\n          // Best-effort cleanup of temp file\n          await unlink(tempFilePath);\n        } catch {\n          // Ignore cleanup errors\n        }\n        throw new Error(`Failed to write cache entry: ${error}`);\n      }\n    } catch (importError) {\n      throw new Error(`Failed to import required modules: ${importError}`);\n    } finally {\n      lockHandle.release();\n    }\n  };\n\n  const deleteEntry = async (key: string): Promise<void> => {\n    // Pre-compute file name outside of lock\n    const baseName = await generateFileBaseName(key);\n    const compressedFilePath = join(cacheDir, getCompressedFileName(baseName));\n\n    const lockHandle = await mutex.lock();\n    try {\n      await ensureCacheDir();\n\n      try {\n        await unlink(compressedFilePath);\n      } catch {\n        // File doesn't exist, ignore the error\n      }\n    } catch (importError) {\n      throw new Error(`Failed to import required modules: ${importError}`);\n    } finally {\n      lockHandle.release();\n    }\n  };\n\n  const clear = async (): Promise<void> => {\n    const lockHandle = await mutex.lock();\n    try {\n      await ensureCacheDir();\n      const files = await readdir(cacheDir);\n\n      // Filter files outside the deletion loop for better performance\n      const cacheFiles = files.filter((file: string) =>\n        file.endsWith('.json.gz')\n      );\n\n      for (const file of cacheFiles) {\n        const filePath = join(cacheDir, file);\n        try {\n          await unlink(filePath);\n        } catch {\n          // Ignore individual file deletion errors\n        }\n      }\n    } catch (importError) {\n      throw new Error(`Failed to import required modules: ${importError}`);\n    } finally {\n      lockHandle.release();\n    }\n  };\n\n  const size = async (): Promise<number> => {\n    await ensureCacheDir();\n\n    // Get file list without lock first\n    const files = await readdir(cacheDir);\n    const cacheFiles = files.filter((file: string) =>\n      file.endsWith('.json.gz')\n    );\n\n    if (cacheFiles.length === 0) {\n      return 0;\n    }\n\n    // Clean up expired entries with lock\n    const lockHandle = await mutex.lock();\n    try {\n      const now = Date.now();\n      let validCount = 0;\n\n      for (const file of cacheFiles) {\n        const filePath = join(cacheDir, file);\n        try {\n          const entry = await readCacheEntry(filePath);\n\n          // Check if entry is expired\n          if (entry.ttl !== undefined) {\n            const isExpired =\n              entry.ttl === 0 || now > entry.timestamp + entry.ttl;\n            if (isExpired) {\n              await unlink(filePath);\n              continue; // Don't count this file\n            }\n          }\n          validCount++;\n        } catch {\n          // If we can't read or parse the file, delete it\n          try {\n            await unlink(filePath);\n          } catch {\n            // Ignore unlink errors\n          }\n        }\n      }\n\n      return validCount;\n    } catch (importError) {\n      throw new Error(`Failed to import required modules: ${importError}`);\n    } finally {\n      lockHandle.release();\n    }\n  };\n\n  return {\n    get,\n    set,\n    delete: deleteEntry,\n    clear,\n    size,\n  };\n};\n"],"names":["e"],"mappings":"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"}

package/dist/utils-B06SsBEd.js

@@ -1,11 +1,11 @@
 /*!
  * name: mark-deco
- * version: 0.28.0
+ * version: 0.29.0
  * description: Flexible Markdown to HTML conversion library
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT
  * repository.url: https://github.com/kekyo/mark-deco
- * git.commit.hash: 124aac654302073ffbbd202ac2794d6c9cdc56ea
+ * git.commit.hash: 671fab29f293a6a2bb863f3b1d1d00cb1c3112d5
  */
 
 const isCORSError = (error) => {

package/dist/utils-CoXrMKLM.cjs

@@ -1,11 +1,11 @@
 /*!
  * name: mark-deco
- * version: 0.28.0
+ * version: 0.29.0
  * description: Flexible Markdown to HTML conversion library
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT
  * repository.url: https://github.com/kekyo/mark-deco
- * git.commit.hash: 124aac654302073ffbbd202ac2794d6c9cdc56ea
+ * git.commit.hash: 671fab29f293a6a2bb863f3b1d1d00cb1c3112d5
  */
 
 "use strict";

package/package.json

@@ -1,20 +1,20 @@
 {
   "git": {
     "tags": [
-      "0.28.0"
+      "0.29.0"
     ],
     "branches": [
       "main"
     ],
-    "version": "0.28.0",
+    "version": "0.29.0",
     "commit": {
-      "hash": "124aac654302073ffbbd202ac2794d6c9cdc56ea",
-      "shortHash": "124aac6",
-      "date": "2026-01-24T23:29:49+09:00",
+      "hash": "671fab29f293a6a2bb863f3b1d1d00cb1c3112d5",
+      "shortHash": "671fab2",
+      "date": "2026-01-25T16:54:44+09:00",
       "message": "Merge branch 'develop'"
     }
   },
-  "version": "0.28.0",
+  "version": "0.29.0",
   "description": "Flexible Markdown to HTML conversion library",
   "name": "mark-deco",
   "keywords": [
@@ -103,5 +103,5 @@
     "vite-plugin-dts": ">=4.5.4",
     "vitest": ">=1.0.0"
   },
-  "buildDate": "2026-01-24T23:33:32+09:00"
+  "buildDate": "2026-01-25T16:56:53+09:00"
 }