@verbatra/sdk 0.6.3 → 0.6.4

package/dist/index.d.cts

@@ -527,6 +527,7 @@ type GlossaryProvenance = {
     readonly path: string;
 };
 
+/** Where {@link loadConfig} should obtain the configuration. The three sources are alternatives. */
 interface LoadConfigOptions {
     /** Directory to start the search from. Defaults to the current working directory. */
     readonly cwd?: string;

package/dist/index.d.ts

@@ -527,6 +527,7 @@ type GlossaryProvenance = {
     readonly path: string;
 };
 
+/** Where {@link loadConfig} should obtain the configuration. The three sources are alternatives. */
 interface LoadConfigOptions {
     /** Directory to start the search from. Defaults to the current working directory. */
     readonly cwd?: string;

package/dist/index.js

@@ -122,6 +122,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;
@@ -1919,7 +1931,7 @@ async function loadExplicitWithMeta(explorer, configPath, cwd, fs) {
   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);
@@ -1944,7 +1956,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) {
@@ -2029,15 +2041,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);
   }
@@ -2627,6 +2639,9 @@ async function fsyncDirBestEffort(path) {
   }
 }
 var nodeOps = {
+  mkdir: async (path) => {
+    await mkdir(path, { recursive: true });
+  },
   writeFile: (path, data) => writeFile(path, data, "utf8"),
   fsyncFile: (path) => fsyncPath(path),
   rename: (from, to) => rename(from, to),
@@ -2643,8 +2658,10 @@ function tempFileName2(path) {
   return join(dirname(path), `.${basename(path)}.tmp-${process.pid}-${Date.now()}-${randomUUID()}`);
 }
 async function atomicWriteFile(path, data, ops = nodeOps) {
+  const directory = dirname(path);
   const tmp = tempFileName2(path);
   try {
+    await ops.mkdir(directory);
     await ops.writeFile(tmp, data);
     await ops.fsyncFile(tmp);
     await ops.rename(tmp, path);
@@ -2653,7 +2670,7 @@ async function atomicWriteFile(path, data, ops = nodeOps) {
     throw error;
   }
   try {
-    await ops.fsyncDir(dirname(path));
+    await ops.fsyncDir(directory);
   } catch {
   }
 }
@@ -4014,7 +4031,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}`
@@ -4314,7 +4331,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}`
@@ -4537,13 +4554,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,
@@ -4563,7 +4573,7 @@ function failureSummary(locale, error) {
     unfilled: [],
     malformedRows: [],
     duplicateKeys: [],
-    error: describeError(error)
+    error: describeError(error, "LOCALE_FAILED")
   };
 }
 function deriveLocaleStatus(parts) {
@@ -4997,6 +5007,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,
@@ -5082,15 +5098,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,
@@ -6350,7 +6373,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 = {
@@ -6436,13 +6459,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;
@@ -6474,7 +6490,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() {