livelocale 0.8.1 → 0.9.0

package/dist/server/index.cjs

@@ -593,14 +593,6 @@ var KeyScanner = class {
 };
 
 // src/server/file-mutator.ts
-function assertEnabled(component) {
-  const reason = getDisabledReason();
-  if (reason !== null) {
-    throw new Error(
-      `[livelocale] ${component} can only be executed in development mode (${reason}).`
-    );
-  }
-}
 var FileMutex = class {
   queue = Promise.resolve();
   async acquire(fn) {
@@ -616,7 +608,23 @@ var FileMutex = class {
 };
 var FileMutator = class {
   fileLocks = /* @__PURE__ */ new Map();
-  scanner = new KeyScanner();
+  requireEnabled;
+  quiet;
+  scanner;
+  constructor(options = {}) {
+    this.requireEnabled = options.requireEnabled ?? true;
+    this.quiet = options.quiet ?? false;
+    this.scanner = new KeyScanner({ requireEnabled: this.requireEnabled });
+  }
+  assertEnabled() {
+    if (!this.requireEnabled) return;
+    const reason = getDisabledReason();
+    if (reason !== null) {
+      throw new Error(
+        `[livelocale] FileMutator can only be executed in development mode (${reason}).`
+      );
+    }
+  }
   /**
    * Helper to serialize execution per file path
    */
@@ -634,7 +642,7 @@ var FileMutator = class {
    * structural JSON validation, and concurrency serialization.
    */
   async updateLocaleKey(basePath, locale, keyPath, newValue) {
-    assertEnabled("FileMutator");
+    this.assertEnabled();
     if (!isSafeLocaleSegment(locale)) {
       throw new Error(
         `[livelocale] Path traversal attempt detected in locale identifier: "${locale}"`
@@ -737,7 +745,9 @@ var FileMutator = class {
           `[livelocale] Failed to rename temp file to target at ${filePath}. Operation: rename. Original error: ${err.message}`
         );
       }
-      console.log(`[livelocale] Updated key '${keyPath}' in locale '${locale}'`);
+      if (!this.quiet) {
+        console.log(`[livelocale] Updated key '${keyPath}' in locale '${locale}'`);
+      }
     });
   }
   /**
@@ -745,7 +755,7 @@ var FileMutator = class {
    * `*.json` inside the `{locale}/` folder merged under its namespace.
    */
   async readLocale(basePath, locale) {
-    assertEnabled("FileMutator");
+    this.assertEnabled();
     const localePath = path3.resolve(basePath, locale);
     let isDir = false;
     try {
@@ -772,7 +782,7 @@ var FileMutator = class {
    * Lists all locale codes dynamically scanned from the locales directory.
    */
   async listLocales(basePath) {
-    assertEnabled("FileMutator");
+    this.assertEnabled();
     const resolvedBasePath = path3.resolve(basePath);
     const items = await import_fs2.promises.readdir(resolvedBasePath, { withFileTypes: true });
     const localesSet = /* @__PURE__ */ new Set();
@@ -794,7 +804,7 @@ var FileMutator = class {
    * Adds a new locale directory/file based on current repository structure.
    */
   async addLocale(basePath, locale) {
-    assertEnabled("FileMutator");
+    this.assertEnabled();
     if (!isSafeLocaleSegment(locale)) {
       throw new Error(
         `[livelocale] Path traversal attempt detected in locale identifier: "${locale}"`
@@ -850,7 +860,7 @@ var FileMutator = class {
    * Renames an existing locale (directory or file) to a new name.
    */
   async renameLocale(basePath, oldLocale, newLocale) {
-    assertEnabled("FileMutator");
+    this.assertEnabled();
     if (!isSafeLocaleSegment(oldLocale) || !isSafeLocaleSegment(newLocale)) {
       throw new Error("[livelocale] Path traversal attempt detected");
     }
@@ -908,7 +918,7 @@ var FileMutator = class {
    * Deletes an existing locale (directory or file).
    */
   async deleteLocale(basePath, locale) {
-    assertEnabled("FileMutator");
+    this.assertEnabled();
     if (!isSafeLocaleSegment(locale)) {
       throw new Error("[livelocale] Path traversal attempt detected");
     }
@@ -1699,6 +1709,67 @@ function validateMessageSyntax(message) {
   return parseIcu(prepared).error;
 }
 
+// src/core/save-rules.ts
+var reject = (status, code, error) => ({
+  ok: false,
+  status,
+  code,
+  error
+});
+function validateWrite(input, options = {}) {
+  const { locale, key, value } = input;
+  if (!isValidLocaleFormat(locale)) {
+    return reject(400, "INVALID_LOCALE_FORMAT", "Invalid locale string parameter.");
+  }
+  if (!isValidKeyFormat(key)) {
+    return reject(
+      400,
+      "INVALID_KEY_FORMAT",
+      "Invalid key path. Must be 1-200 characters containing alphanumeric, dots, underscores, or hyphens."
+    );
+  }
+  if (!isSafeKeyPath(key)) {
+    return reject(
+      400,
+      "INVALID_KEY_FORMAT",
+      "Forbidden key path: segments like __proto__, constructor, or prototype are not allowed."
+    );
+  }
+  if (!isValidValueFormat(value)) {
+    return reject(
+      400,
+      "INVALID_VALUE_FORMAT",
+      "Invalid value. Must be a string less than 10000 characters."
+    );
+  }
+  const accepted = {
+    ok: true,
+    locale,
+    key,
+    value
+  };
+  if (options.force === true) return accepted;
+  const syntaxError = validateMessageSyntax(accepted.value);
+  if (syntaxError) {
+    return reject(422, "MESSAGE_SYNTAX", `Message syntax: ${syntaxError}.`);
+  }
+  const comparison = comparePlaceholders(options.reference, accepted.value);
+  if (!comparison.ok) {
+    const parts = [];
+    if (comparison.missing.length) parts.push(`missing ${comparison.missing.join(", ")}`);
+    if (comparison.extra.length) parts.push(`unexpected ${comparison.extra.join(", ")}`);
+    return {
+      ...reject(
+        422,
+        "PLACEHOLDER_MISMATCH",
+        `Placeholders differ from the reference: ${parts.join("; ")}.`
+      ),
+      details: { missing: comparison.missing, extra: comparison.extra }
+    };
+  }
+  return accepted;
+}
+
 // src/server/router.ts
 var DEFAULT_ALLOWED_ORIGINS = ["http://localhost:3010", "http://127.0.0.1:3010"];
 var MAX_BODY_BYTES = 1e6;
@@ -1886,53 +1957,18 @@ function createMutationRouter(mutator, options) {
       await mutator.deleteLocale(basePath, locale);
       return json(200, headers, { success: true, locale });
     }
-    if (!isValidLocaleFormat(locale)) {
-      return json(400, headers, {
-        error: "Invalid locale string parameter.",
-        code: "INVALID_LOCALE_FORMAT"
-      });
-    }
-    if (!isValidKeyFormat(key)) {
-      return json(400, headers, {
-        error: "Invalid key path. Must be 1-200 characters containing alphanumeric, dots, underscores, or hyphens.",
-        code: "INVALID_KEY_FORMAT"
-      });
-    }
-    if (!isSafeKeyPath(key)) {
-      return json(400, headers, {
-        error: "Forbidden key path: segments like __proto__, constructor, or prototype are not allowed.",
-        code: "INVALID_KEY_FORMAT"
-      });
-    }
-    if (!isValidValueFormat(value)) {
-      return json(400, headers, {
-        error: "Invalid value. Must be a string less than 10000 characters.",
-        code: "INVALID_VALUE_FORMAT"
+    const verdict = validateWrite(
+      { locale, key, value },
+      { reference: typeof reference === "string" ? reference : null, force: force === true }
+    );
+    if (!verdict.ok) {
+      return json(verdict.status, headers, {
+        error: verdict.error,
+        code: verdict.code,
+        details: verdict.details
       });
     }
-    if (force !== true) {
-      const syntaxError = validateMessageSyntax(value);
-      if (syntaxError) {
-        return json(422, headers, {
-          error: `Message syntax: ${syntaxError}.`,
-          code: "MESSAGE_SYNTAX"
-        });
-      }
-      if (typeof reference === "string") {
-        const comparison = comparePlaceholders(reference, value);
-        if (!comparison.ok) {
-          const parts = [];
-          if (comparison.missing.length) parts.push(`missing ${comparison.missing.join(", ")}`);
-          if (comparison.extra.length) parts.push(`unexpected ${comparison.extra.join(", ")}`);
-          return json(422, headers, {
-            error: `Placeholders differ from the reference: ${parts.join("; ")}.`,
-            code: "PLACEHOLDER_MISMATCH",
-            details: { missing: comparison.missing, extra: comparison.extra }
-          });
-        }
-      }
-    }
-    await mutator.updateLocaleKey(basePath, locale, key, value);
+    await mutator.updateLocaleKey(basePath, verdict.locale, verdict.key, verdict.value);
     return json(200, headers, { success: true, key, locale });
   }
   return {
@@ -2006,7 +2042,7 @@ var BodyTooLargeError = class extends Error {
   }
 };
 function readNodeBody(req, maxBytes) {
-  return new Promise((resolve5, reject) => {
+  return new Promise((resolve5, reject2) => {
     let bodyText = "";
     let settled = false;
     req.on("data", (chunk) => {
@@ -2014,7 +2050,7 @@ function readNodeBody(req, maxBytes) {
       bodyText += chunk.toString();
       if (Buffer.byteLength(bodyText, "utf-8") > maxBytes) {
         settled = true;
-        reject(new BodyTooLargeError());
+        reject2(new BodyTooLargeError());
         req.destroy?.();
       }
     });
@@ -2026,7 +2062,7 @@ function readNodeBody(req, maxBytes) {
     req.on("error", (err) => {
       if (settled) return;
       settled = true;
-      reject(err);
+      reject2(err);
     });
   });
 }