@verbatra/sdk 0.6.3 → 0.6.4

package/dist/index.cjs

@@ -152,6 +152,18 @@ function defineConfig(config) {
 }
 
 // src/errors.ts
+function errorMessage(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+function stringCode(error) {
+  if (error instanceof Error && "code" in error && typeof error.code === "string") {
+    return error.code;
+  }
+  return void 0;
+}
+function describeError(error, fallbackCode) {
+  return { code: stringCode(error) ?? fallbackCode, message: errorMessage(error) };
+}
 var SdkError = class extends Error {
   /** The stable {@link SdkErrorCode} for this failure; branch on this, not the message. */
   code;
@@ -1949,7 +1961,7 @@ async function loadExplicitWithMeta(explorer, configPath, cwd, fs$1) {
   try {
     result = await explorer.load(resolved);
   } catch (error) {
-    const detail = error instanceof Error ? error.message : String(error);
+    const detail = errorMessage(error);
     throw new SdkError("CONFIG_INVALID", `Failed to load the verbatra configuration: ${detail}`);
   }
   const parsed = parseConfig(result?.config);
@@ -1974,7 +1986,7 @@ async function loadConfigWithMeta(options = {}) {
   try {
     result = await explorer.search(options.cwd);
   } catch (error) {
-    const detail = error instanceof Error ? error.message : String(error);
+    const detail = errorMessage(error);
     throw new SdkError("CONFIG_INVALID", `Failed to load the verbatra configuration: ${detail}`);
   }
   if (result === null || result.isEmpty === true) {
@@ -2059,15 +2071,15 @@ async function acquireLock(path, fs, pollIntervalMs, deadline, notify) {
     if (await fs.createExclusive(path, lockPayload())) {
       return;
     }
+    if (notify !== void 0) {
+      await notify();
+    }
     if (Date.now() >= deadline) {
       throw new SdkError(
         "LOCK_CONTENDED",
         `Could not acquire the write lock at ${path}: another process may be holding it. If no verbatra process is currently running, this lock file was likely left behind by one that was killed; delete it and retry.`
       );
     }
-    if (notify !== void 0) {
-      await notify();
-    }
     const jitter = Math.random() * pollIntervalMs;
     await sleep(pollIntervalMs + jitter);
   }
@@ -2657,6 +2669,9 @@ async function fsyncDirBestEffort(path) {
   }
 }
 var nodeOps = {
+  mkdir: async (path) => {
+    await promises.mkdir(path, { recursive: true });
+  },
   writeFile: (path, data) => promises.writeFile(path, data, "utf8"),
   fsyncFile: (path) => fsyncPath(path),
   rename: (from, to) => promises.rename(from, to),
@@ -2673,8 +2688,10 @@ function tempFileName2(path$1) {
   return path.join(path.dirname(path$1), `.${path.basename(path$1)}.tmp-${process.pid}-${Date.now()}-${crypto.randomUUID()}`);
 }
 async function atomicWriteFile(path$1, data, ops = nodeOps) {
+  const directory = path.dirname(path$1);
   const tmp = tempFileName2(path$1);
   try {
+    await ops.mkdir(directory);
     await ops.writeFile(tmp, data);
     await ops.fsyncFile(tmp);
     await ops.rename(tmp, path$1);
@@ -2683,7 +2700,7 @@ async function atomicWriteFile(path$1, data, ops = nodeOps) {
     throw error;
   }
   try {
-    await ops.fsyncDir(path.dirname(path$1));
+    await ops.fsyncDir(directory);
   } catch {
   }
 }
@@ -4044,7 +4061,7 @@ async function readSource(config, cwd, fs, adapter) {
   try {
     return await adapter.read(sourcePath, config.sourceLocale);
   } catch (error) {
-    const detail = error instanceof Error ? error.message : String(error);
+    const detail = errorMessage(error);
     throw new SdkError(
       "SOURCE_INVALID",
       `The source locale file at ${sourcePath} could not be read: ${detail}`
@@ -4344,7 +4361,7 @@ function selectProvider(config, createProvider = buildProvider) {
   try {
     return createProvider(config);
   } catch (error) {
-    const detail = error instanceof Error ? error.message : String(error);
+    const detail = errorMessage(error);
     throw new SdkError(
       "PROVIDER_CONSTRUCTION_FAILED",
       `Failed to construct provider "${config.id}": ${detail}`
@@ -4567,13 +4584,6 @@ function budgetExceededNotice(tracker) {
 }
 
 // src/flow/locale-failure.ts
-function describeError(error) {
-  if (error instanceof Error) {
-    const code = error.code;
-    return { code: typeof code === "string" ? code : "LOCALE_FAILED", message: error.message };
-  }
-  return { code: "LOCALE_FAILED", message: String(error) };
-}
 function failureSummary(locale, error) {
   return {
     locale,
@@ -4593,7 +4603,7 @@ function failureSummary(locale, error) {
     unfilled: [],
     malformedRows: [],
     duplicateKeys: [],
-    error: describeError(error)
+    error: describeError(error, "LOCALE_FAILED")
   };
 }
 function deriveLocaleStatus(parts) {
@@ -5027,6 +5037,12 @@ function buildRequest3(params, entries) {
     ...params.adapter.comparePlaceholders !== void 0 ? { comparePlaceholders: params.adapter.comparePlaceholders } : {}
   };
 }
+async function shouldWriteTarget(params, path, changed) {
+  if (changed.accepted > 0 || changed.pruned > 0 || changed.generated > 0) {
+    return true;
+  }
+  return !await params.fs.fileExists(path);
+}
 async function runLocale(params) {
   const target = await readTargetResource({
     cwd: params.cwd,
@@ -5112,15 +5128,22 @@ async function runLocale(params) {
     merged.set(form.targetKey, { ...form.entry, namespace: target.namespace });
   }
   const path = localeFilePath(params.cwd, params.filesPattern, params.targetLocale);
-  await params.adapter.write(
-    {
-      locale: params.targetLocale,
-      namespace: target.namespace,
-      format: params.format,
-      entries: merged
-    },
-    path
-  );
+  const writeNeeded = await shouldWriteTarget(params, path, {
+    accepted: accepted.size,
+    pruned: pruned.length,
+    generated: generation.accepted.length
+  });
+  if (writeNeeded) {
+    await params.adapter.write(
+      {
+        locale: params.targetLocale,
+        namespace: target.namespace,
+        format: params.format,
+        entries: merged
+      },
+      path
+    );
+  }
   const pluralNotices = params.generatePlurals ? pluralNoticeFor(params, merged) : sdkNotices;
   const notices = [
     ...pluralNotices,
@@ -6380,7 +6403,7 @@ async function importWorkbook(input, deps = {}) {
   try {
     data = await readWorkbook(bytes);
   } catch (error) {
-    throw new SdkError("SOURCE_INVALID", error.message);
+    throw new SdkError("SOURCE_INVALID", errorMessage(error));
   }
   const lock = await readLockFile(lockFilePath(cwd), fs);
   const ctx = {
@@ -6466,13 +6489,6 @@ function defaultRunTranslate(deps) {
 
 // src/watch/watch.ts
 var DEFAULT_DEBOUNCE_MS = 300;
-function describeError2(error) {
-  if (error instanceof Error) {
-    const code = error.code;
-    return { code: typeof code === "string" ? code : "WATCH_RUN_FAILED", message: error.message };
-  }
-  return { code: "WATCH_RUN_FAILED", message: String(error) };
-}
 async function watch(input, deps = {}) {
   const cwd = input.cwd ?? process.cwd();
   const debounceMs = input.debounceMs ?? DEFAULT_DEBOUNCE_MS;
@@ -6504,7 +6520,7 @@ async function watch(input, deps = {}) {
     try {
       input.onRun({ status: "succeeded", summary: await runTranslate(runInput) });
     } catch (error) {
-      input.onRun({ status: "failed", error: describeError2(error) });
+      input.onRun({ status: "failed", error: describeError(error, "WATCH_RUN_FAILED") });
     }
   }
   function startRun() {