livelocale 0.8.0 → 0.9.0

package/dist/server/index.d.cts

@@ -1,8 +1,18 @@
-export { W as WrapOptions, d as decodeKey, e as encodeKey, h as hasWatermark, s as sanitizeZeroWidth, a as stripWatermark, u as unwrap, w as wrapNextIntl, b as wrapTranslationEngine } from '../wrap-CsOtHp8r.cjs';
+export { W as WrapOptions, d as decodeKey, e as encodeKey, h as hasWatermark, r as removeWatermarks, s as sanitizeZeroWidth, a as stripWatermark, u as unwrap, w as wrapNextIntl, b as wrapTranslationEngine } from '../wrap-2qVxLN9Q.cjs';
 
+interface FileMutatorOptions {
+    /** Refuse to run unless LiveLocale is enabled. Default true; only CLI tooling passes false. */
+    requireEnabled?: boolean;
+    /** Skip the console line each `updateLocaleKey` write prints. Default false. */
+    quiet?: boolean;
+}
 declare class FileMutator {
     private fileLocks;
-    private scanner;
+    private readonly requireEnabled;
+    private readonly quiet;
+    private readonly scanner;
+    constructor(options?: FileMutatorOptions);
+    private assertEnabled;
     /**
      * Helper to serialize execution per file path
      */
@@ -359,4 +369,4 @@ declare function getLiveLocaleMode(): LiveLocaleMode;
 /** True when watermarking, the mutation API, and the client scanner should run. */
 declare function isLiveLocaleEnabled(): boolean;
 
-export { type CreateTranslationsOptions, FileMutator, type GitChange, GitClient, type GitGateway, type GitHubGateway, type GitHubGatewayConfig, type GitStatus, type HandlerConfig, KeyScanner, type LiveLocaleMode, type MutationGateway, type MutationRouter, createGitHubGateway, createLiveLocaleHandler, createMutationRouter, createTranslations, getLiveLocaleMode, isLiveLocaleEnabled };
+export { type CreateTranslationsOptions, FileMutator, type FileMutatorOptions, type GitChange, GitClient, type GitGateway, type GitHubGateway, type GitHubGatewayConfig, type GitStatus, type HandlerConfig, KeyScanner, type LiveLocaleMode, type MutationGateway, type MutationRouter, createGitHubGateway, createLiveLocaleHandler, createMutationRouter, createTranslations, getLiveLocaleMode, isLiveLocaleEnabled };

package/dist/server/index.d.ts

@@ -1,8 +1,18 @@
-export { W as WrapOptions, d as decodeKey, e as encodeKey, h as hasWatermark, s as sanitizeZeroWidth, a as stripWatermark, u as unwrap, w as wrapNextIntl, b as wrapTranslationEngine } from '../wrap-CsOtHp8r.js';
+export { W as WrapOptions, d as decodeKey, e as encodeKey, h as hasWatermark, r as removeWatermarks, s as sanitizeZeroWidth, a as stripWatermark, u as unwrap, w as wrapNextIntl, b as wrapTranslationEngine } from '../wrap-2qVxLN9Q.js';
 
+interface FileMutatorOptions {
+    /** Refuse to run unless LiveLocale is enabled. Default true; only CLI tooling passes false. */
+    requireEnabled?: boolean;
+    /** Skip the console line each `updateLocaleKey` write prints. Default false. */
+    quiet?: boolean;
+}
 declare class FileMutator {
     private fileLocks;
-    private scanner;
+    private readonly requireEnabled;
+    private readonly quiet;
+    private readonly scanner;
+    constructor(options?: FileMutatorOptions);
+    private assertEnabled;
     /**
      * Helper to serialize execution per file path
      */
@@ -359,4 +369,4 @@ declare function getLiveLocaleMode(): LiveLocaleMode;
 /** True when watermarking, the mutation API, and the client scanner should run. */
 declare function isLiveLocaleEnabled(): boolean;
 
-export { type CreateTranslationsOptions, FileMutator, type GitChange, GitClient, type GitGateway, type GitHubGateway, type GitHubGatewayConfig, type GitStatus, type HandlerConfig, KeyScanner, type LiveLocaleMode, type MutationGateway, type MutationRouter, createGitHubGateway, createLiveLocaleHandler, createMutationRouter, createTranslations, getLiveLocaleMode, isLiveLocaleEnabled };
+export { type CreateTranslationsOptions, FileMutator, type FileMutatorOptions, type GitChange, GitClient, type GitGateway, type GitHubGateway, type GitHubGatewayConfig, type GitStatus, type HandlerConfig, KeyScanner, type LiveLocaleMode, type MutationGateway, type MutationRouter, createGitHubGateway, createLiveLocaleHandler, createMutationRouter, createTranslations, getLiveLocaleMode, isLiveLocaleEnabled };

package/dist/server/index.js

@@ -540,14 +540,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) {
@@ -563,7 +555,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
    */
@@ -581,7 +589,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}"`
@@ -684,7 +692,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}'`);
+      }
     });
   }
   /**
@@ -692,7 +702,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 {
@@ -719,7 +729,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 fs2.readdir(resolvedBasePath, { withFileTypes: true });
     const localesSet = /* @__PURE__ */ new Set();
@@ -741,7 +751,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}"`
@@ -797,7 +807,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");
     }
@@ -855,7 +865,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");
     }
@@ -1646,6 +1656,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;
@@ -1833,53 +1904,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 {
@@ -1953,7 +1989,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) => {
@@ -1961,7 +1997,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?.();
       }
     });
@@ -1973,7 +2009,7 @@ function readNodeBody(req, maxBytes) {
     req.on("error", (err) => {
       if (settled) return;
       settled = true;
-      reject(err);
+      reject2(err);
     });
   });
 }
@@ -2073,10 +2109,11 @@ import { readdirSync, statSync as statSync2 } from "fs";
 import { join as join4 } from "path";
 
 // src/client/watermark.ts
-var DELIM = "\u200D";
+var DELIM = "\u200C";
 var BIT_0 = "\u200B";
-var BIT_1 = "\u200C";
+var BIT_1 = "\u200D";
 var ZW_RE = /[\u200B\u200C\u200D]/g;
+var WATERMARK_RE = /\u200C(?:[\u200B\u200D]{8})+\u200C/g;
 function encodeKey(text, key) {
   const bytes = new TextEncoder().encode(key);
   let bits = "";
@@ -2123,6 +2160,9 @@ function stripWatermark(text) {
 function sanitizeZeroWidth(text) {
   return text.replace(ZW_RE, "");
 }
+function removeWatermarks(text) {
+  return text.replace(WATERMARK_RE, "");
+}
 function hasWatermark(text) {
   return text.startsWith(DELIM);
 }
@@ -2372,6 +2412,7 @@ export {
   getLiveLocaleMode,
   hasWatermark,
   isLiveLocaleEnabled,
+  removeWatermarks,
   sanitizeZeroWidth,
   stripWatermark,
   unwrap,