@zyrab/domo-og/src/manifest.js

An OG (Open Graph) image generator with SVG templates.

import fs from "fs";

let manifestCache = null;
let manifestLoaded = false;
let manifestPathCache = null;

let debounceTimer = null;
const DEBOUNCE_DELAY = 500; // ms

function loadManifest(manifestPath) {
  try {
    return fs.existsSync(manifestPath) ? JSON.parse(fs.readFileSync(manifestPath, "utf8")) : {};
  } catch (err) {
    console.error("❌ Failed to load cache manifest");
    return {};
  }
}

function saveManifest(manifestPath, manifest) {
  try {
    fs.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2));
  } catch {
    console.error("❌ Failed to Save cache manifest");
  }
}

export function getManifest(manifestPath) {
  if (!manifestLoaded) {
    manifestCache = loadManifest(manifestPath);
    manifestPathCache = manifestPath;
    manifestLoaded = true;
  }
  return manifestCache;
}

export function requestManifestWrite() {
  if (debounceTimer) clearTimeout(debounceTimer);
  debounceTimer = setTimeout(() => {
    if (manifestLoaded && manifestPathCache && manifestCache) {
      saveManifest(manifestPathCache, manifestCache);
    }
    debounceTimer = null;
  }, DEBOUNCE_DELAY);
}

export function flushManifestImmediately() {
  if (debounceTimer) {
    clearTimeout(debounceTimer);
    debounceTimer = null;
  }
  if (manifestLoaded && manifestPathCache && manifestCache) {
    saveManifest(manifestPathCache, manifestCache);
  }
}

// <-- this i may add in next version keeping kere for referance
// let staleKeys = null;
// export function startBuildCleanup(manifest) {
//   staleKeys = { ...manifest };
// }

//  if (staleKeys && staleKeys[key]) {
//    delete staleKeys[key];
//  }
//  export function finishBuildCleanup(outputDir) {
//    for (const key of Object.keys(staleKeys)) {
//      const imagePath = path.join(outputDir, staleKeys[key].path);
//      if (fs.existsSync(imagePath)) fs.unlinkSync(imagePath);
//      delete manifest[key];
//    }
//    saveManifest(manifestPath, manifest); // final write after cleanup
//    staleKeys = null;
//  }