simple-dynamsoft-mcp 6.3.0 → 7.0.0

package/src/data/download-utils.js

@@ -0,0 +1,99 @@
+import { dirname, join } from "node:path";
+import { existsSync, renameSync, rmSync } from "node:fs";
+
+function sleepMs(delayMs) {
+  return new Promise((resolve) => setTimeout(resolve, delayMs));
+}
+
+function parseHttpStatus(message) {
+  const match = String(message || "").match(/HTTP\s+(\d{3})/i);
+  if (!match) return 0;
+  return Number.parseInt(match[1], 10);
+}
+
+function shouldRetryDownloadError(error) {
+  const message = String(error?.message || "");
+  const status = parseHttpStatus(message);
+  if (status === 408 || status === 429) return true;
+  if (status >= 500 && status <= 599) return true;
+
+  if (error?.name === "AbortError") return true;
+  if (/timed?\s*out/i.test(message)) return true;
+  if (/ECONNRESET|ECONNREFUSED|ENOTFOUND|EAI_AGAIN/i.test(message)) return true;
+  return false;
+}
+
+function getBackoffDelayMs(attempt, baseDelayMs, maxDelayMs) {
+  const exp = Math.max(0, attempt - 1);
+  const delay = baseDelayMs * (2 ** exp);
+  return Math.min(delay, maxDelayMs);
+}
+
+async function withRetry(operation, {
+  maxAttempts,
+  baseDelayMs,
+  maxDelayMs,
+  shouldRetry,
+  onRetry
+}) {
+  let lastError = null;
+  for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
+    try {
+      return await operation(attempt);
+    } catch (error) {
+      lastError = error;
+      const canRetry = attempt < maxAttempts && shouldRetry(error);
+      if (!canRetry) throw error;
+      const delayMs = getBackoffDelayMs(attempt, baseDelayMs, maxDelayMs);
+      if (typeof onRetry === "function") {
+        onRetry({ attempt, delayMs, error });
+      }
+      await sleepMs(delayMs);
+    }
+  }
+  throw lastError || new Error("Retry operation failed");
+}
+
+function replaceDirectoryWithRollback(targetPath, stagedPath) {
+  const parent = dirname(targetPath);
+  const backupPath = join(parent, `${targetPath.split("/").pop() || "repo"}.bak-${Date.now()}`);
+  let movedExisting = false;
+  try {
+    if (existsSync(targetPath)) {
+      renameSync(targetPath, backupPath);
+      movedExisting = true;
+    }
+
+    renameSync(stagedPath, targetPath);
+    if (movedExisting && existsSync(backupPath)) {
+      rmSync(backupPath, { recursive: true, force: true });
+    }
+  } catch (error) {
+    if (existsSync(targetPath)) {
+      rmSync(targetPath, { recursive: true, force: true });
+    }
+    if (movedExisting && existsSync(backupPath)) {
+      renameSync(backupPath, targetPath);
+    }
+    throw error;
+  }
+}
+
+function buildHydrationFailureMessage({ reason, scopeSummary }) {
+  const lines = [
+    `Lazy hydration failed: ${reason}`,
+    scopeSummary ? `Scope: ${scopeSummary}` : "",
+    "Try one of the following:",
+    "- retry the same request",
+    "- set MCP_DATA_HYDRATION_MODE=eager to prefetch repos at startup",
+    "- set MCP_DATA_DOWNLOAD_TIMEOUT_MS to a higher value in slow networks"
+  ].filter(Boolean);
+  return lines.join("\n");
+}
+
+export {
+  shouldRetryDownloadError,
+  withRetry,
+  replaceDirectoryWithRollback,
+  buildHydrationFailureMessage
+};

package/src/data/hydration-mode.js

@@ -0,0 +1,15 @@
+function normalizeEnvValue(value) {
+  if (value === undefined || value === null) return "";
+  return String(value).trim().toLowerCase();
+}
+
+function resolveHydrationMode(env = process.env) {
+  const mode = normalizeEnvValue(env.MCP_DATA_HYDRATION_MODE);
+  if (!mode) return "lazy";
+  if (mode === "lazy" || mode === "eager") return mode;
+  return "eager";
+}
+
+export {
+  resolveHydrationMode
+};

package/src/data/hydration-policy.js

@@ -0,0 +1,39 @@
+const VALID_TYPES = new Set(["any", "doc", "sample"]);
+
+function normalizeValue(value) {
+  if (value === undefined || value === null) return "";
+  return String(value).trim().toLowerCase();
+}
+
+function normalizeHydrationScope(scope) {
+  if (!scope || typeof scope !== "object") return null;
+  const product = normalizeValue(scope.product);
+  if (!product) return null;
+
+  const edition = normalizeValue(scope.edition);
+  const platform = normalizeValue(scope.platform);
+  const requestedType = normalizeValue(scope.type);
+  const type = VALID_TYPES.has(requestedType) ? requestedType : "any";
+
+  return {
+    product,
+    edition,
+    platform,
+    type
+  };
+}
+
+function normalizeHydrationScopes(scopes = []) {
+  if (!Array.isArray(scopes)) return [];
+  const normalized = [];
+  for (const scope of scopes) {
+    const value = normalizeHydrationScope(scope);
+    if (value) normalized.push(value);
+  }
+  return normalized;
+}
+
+export {
+  normalizeHydrationScope,
+  normalizeHydrationScopes
+};

package/src/data/repo-map.js

@@ -0,0 +1,149 @@
+import { normalizeHydrationScopes } from "./hydration-policy.js";
+
+const REPO_MAP = {
+  dbr: {
+    docs: {
+      web: ["documentation/barcode-reader-docs-js"],
+      mobile: ["documentation/barcode-reader-docs-mobile"],
+      server: ["documentation/barcode-reader-docs-server"],
+      any: [
+        "documentation/barcode-reader-docs-js",
+        "documentation/barcode-reader-docs-mobile",
+        "documentation/barcode-reader-docs-server"
+      ]
+    },
+    samples: {
+      web: ["samples/dynamsoft-barcode-reader"],
+      mobile: [
+        "samples/dynamsoft-barcode-reader-mobile",
+        "samples/dynamsoft-barcode-reader-maui",
+        "samples/dynamsoft-barcode-reader-react-native",
+        "samples/dynamsoft-barcode-reader-flutter"
+      ],
+      server: [
+        "samples/dynamsoft-barcode-reader-python",
+        "samples/dynamsoft-barcode-reader-dotnet",
+        "samples/dynamsoft-barcode-reader-java",
+        "samples/dynamsoft-barcode-reader-c-cpp",
+        "samples/dynamsoft-capture-vision-nodejs"
+      ],
+      any: [
+        "samples/dynamsoft-barcode-reader",
+        "samples/dynamsoft-barcode-reader-mobile",
+        "samples/dynamsoft-barcode-reader-python",
+        "samples/dynamsoft-barcode-reader-dotnet",
+        "samples/dynamsoft-barcode-reader-java",
+        "samples/dynamsoft-barcode-reader-c-cpp",
+        "samples/dynamsoft-barcode-reader-maui",
+        "samples/dynamsoft-barcode-reader-react-native",
+        "samples/dynamsoft-barcode-reader-flutter",
+        "samples/dynamsoft-capture-vision-nodejs"
+      ]
+    }
+  },
+  dcv: {
+    docs: {
+      core: ["documentation/capture-vision-docs"],
+      web: ["documentation/capture-vision-docs-js"],
+      mobile: ["documentation/capture-vision-docs-mobile"],
+      server: ["documentation/capture-vision-docs-server"],
+      any: [
+        "documentation/capture-vision-docs",
+        "documentation/capture-vision-docs-js",
+        "documentation/capture-vision-docs-mobile",
+        "documentation/capture-vision-docs-server"
+      ]
+    },
+    samples: {
+      web: ["samples/dynamsoft-capture-vision-javascript"],
+      mobile: [
+        "samples/dynamsoft-capture-vision-mobile",
+        "samples/dynamsoft-capture-vision-maui",
+        "samples/dynamsoft-capture-vision-react-native",
+        "samples/dynamsoft-capture-vision-flutter",
+        "samples/dynamsoft-capture-vision-spm"
+      ],
+      server: [
+        "samples/dynamsoft-capture-vision-python",
+        "samples/dynamsoft-capture-vision-dotnet",
+        "samples/dynamsoft-capture-vision-java",
+        "samples/dynamsoft-capture-vision-c-cpp",
+        "samples/dynamsoft-capture-vision-nodejs"
+      ],
+      any: [
+        "samples/dynamsoft-capture-vision-javascript",
+        "samples/dynamsoft-capture-vision-mobile",
+        "samples/dynamsoft-capture-vision-python",
+        "samples/dynamsoft-capture-vision-dotnet",
+        "samples/dynamsoft-capture-vision-java",
+        "samples/dynamsoft-capture-vision-c-cpp",
+        "samples/dynamsoft-capture-vision-maui",
+        "samples/dynamsoft-capture-vision-react-native",
+        "samples/dynamsoft-capture-vision-flutter",
+        "samples/dynamsoft-capture-vision-nodejs",
+        "samples/dynamsoft-capture-vision-spm"
+      ]
+    }
+  },
+  dwt: {
+    docs: {
+      any: ["documentation/web-twain-docs"]
+    },
+    samples: {
+      any: ["samples/dynamic-web-twain"]
+    }
+  },
+  ddv: {
+    docs: {
+      any: ["documentation/document-viewer-docs"]
+    },
+    samples: {
+      any: ["samples/dynamsoft-document-viewer"]
+    }
+  }
+};
+
+function getMappedPaths(product, edition, sourceType) {
+  const productMap = REPO_MAP[product];
+  if (!productMap) return [];
+  const typeMap = productMap[sourceType];
+  if (!typeMap) return [];
+  if (edition && typeMap[edition]) return typeMap[edition];
+  return typeMap.any || [];
+}
+
+function resolveRepoPathsForScopes(scopes = [], manifest = null) {
+  const manifestPaths = new Set(
+    Array.isArray(manifest?.repos) ? manifest.repos.map((repo) => String(repo.path || "")) : []
+  );
+
+  const normalizedScopes = normalizeHydrationScopes(scopes);
+  if (normalizedScopes.length === 0) {
+    if (manifestPaths.size === 0) return [];
+    return Array.from(manifestPaths).sort((a, b) => a.localeCompare(b));
+  }
+
+  const resolved = new Set();
+  for (const scope of normalizedScopes) {
+    const includeDocs = scope.type === "any" || scope.type === "doc";
+    const includeSamples = scope.type === "any" || scope.type === "sample";
+
+    if (includeDocs) {
+      for (const path of getMappedPaths(scope.product, scope.edition, "docs")) {
+        resolved.add(path);
+      }
+    }
+    if (includeSamples) {
+      for (const path of getMappedPaths(scope.product, scope.edition, "samples")) {
+        resolved.add(path);
+      }
+    }
+  }
+
+  const filtered = Array.from(resolved).filter((path) => manifestPaths.size === 0 || manifestPaths.has(path));
+  return filtered.sort((a, b) => a.localeCompare(b));
+}
+
+export {
+  resolveRepoPathsForScopes
+};

package/src/{data-root.js → data/root.js}

@@ -2,7 +2,7 @@ import { dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
-const projectRoot = join(__dirname, "..");
+const projectRoot = join(__dirname, "..", "..");
 const bundledDataRoot = join(projectRoot, "data");
 
 function getResolvedDataRoot() {

package/src/{submodule-sync.js → data/submodule-sync.js}

@@ -4,7 +4,7 @@ import { join, dirname } from "node:path";
 import { fileURLToPath } from "node:url";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
-const projectRoot = join(__dirname, "..");
+const projectRoot = join(__dirname, "..", "..");
 
 function logDataSync(message) {
   console.error(`[data-sync] ${message}`);