@scoutello/i18n-magic 0.64.0 → 0.66.0

package/dist/lib/languges.js.map

@@ -1 +1 @@
-{"version":3,"file":"languges.js","sourceRoot":"","sources":["../../src/lib/languges.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"languges.js","sourceRoot":"","sources":["../../src/lib/languges.ts"],"names":[],"mappings":"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"}

package/dist/lib/locale-storage.d.ts

@@ -0,0 +1,7 @@
+import type { Configuration } from "./types.js";
+export declare class LocaleConfigurationError extends Error {
+    constructor(message: string);
+}
+export declare const resolveConfiguredLocale: (config: Pick<Configuration, "defaultLocale" | "locales">, requested?: string) => string;
+export declare const resolveLocaleTemplatePath: (template: string, locale: string, namespace: string) => string;
+//# sourceMappingURL=locale-storage.d.ts.map

package/dist/lib/locale-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale-storage.d.ts","sourceRoot":"","sources":["../../src/lib/locale-storage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C,qBAAa,wBAAyB,SAAQ,KAAK;gBACrC,OAAO,EAAE,MAAM;CAI5B;AAED,eAAO,MAAM,uBAAuB,GAClC,QAAQ,IAAI,CAAC,aAAa,EAAE,eAAe,GAAG,SAAS,CAAC,EACxD,YAAY,MAAM,WAWnB,CAAA;AA2BD,eAAO,MAAM,yBAAyB,GACpC,UAAU,MAAM,EAChB,QAAQ,MAAM,EACd,WAAW,MAAM,WAsBlB,CAAA"}

package/dist/lib/locale-storage.js

@@ -0,0 +1,49 @@
+import path from "node:path";
+export class LocaleConfigurationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "LocaleConfigurationError";
+    }
+}
+export const resolveConfiguredLocale = (config, requested) => {
+    const locale = requested ?? config.defaultLocale;
+    if (!config.locales.includes(locale)) {
+        throw new LocaleConfigurationError(`Unsupported locale "${locale}". Expected one of: ${config.locales.join(", ")}.`);
+    }
+    return locale;
+};
+const getConfiguredBasePath = (template) => {
+    const placeholderIndexes = [
+        template.indexOf("{{lng}}"),
+        template.indexOf("{{ns}}"),
+    ].filter((index) => index >= 0);
+    if (placeholderIndexes.length === 0) {
+        return path.dirname(path.resolve(template));
+    }
+    const firstPlaceholder = Math.min(...placeholderIndexes);
+    const staticPrefix = template.slice(0, firstPlaceholder);
+    if (staticPrefix.length === 0 ||
+        staticPrefix.endsWith(path.sep) ||
+        staticPrefix.endsWith("/") ||
+        staticPrefix.endsWith("\\")) {
+        return path.resolve(staticPrefix || ".");
+    }
+    return path.dirname(path.resolve(staticPrefix));
+};
+export const resolveLocaleTemplatePath = (template, locale, namespace) => {
+    const configuredBase = getConfiguredBasePath(template);
+    const expandedPath = template
+        .split("{{lng}}")
+        .join(locale)
+        .split("{{ns}}")
+        .join(namespace);
+    const resolvedPath = path.resolve(expandedPath);
+    const relativePath = path.relative(configuredBase, resolvedPath);
+    if (relativePath === ".." ||
+        relativePath.startsWith(`..${path.sep}`) ||
+        path.isAbsolute(relativePath)) {
+        throw new LocaleConfigurationError("Expanded locale path escapes the configured storage base.");
+    }
+    return resolvedPath;
+};
+//# sourceMappingURL=locale-storage.js.map

package/dist/lib/locale-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale-storage.js","sourceRoot":"","sources":["../../src/lib/locale-storage.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAA;AAG5B,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IACjD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAA;IACxC,CAAC;CACF;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACrC,MAAwD,EACxD,SAAkB,EAClB,EAAE;IACF,MAAM,MAAM,GAAG,SAAS,IAAI,MAAM,CAAC,aAAa,CAAA;IAEhD,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,wBAAwB,CAChC,uBAAuB,MAAM,uBAAuB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACjF,CAAA;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAED,MAAM,qBAAqB,GAAG,CAAC,QAAgB,EAAE,EAAE;IACjD,MAAM,kBAAkB,GAAG;QACzB,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC;QAC3B,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC;KAC3B,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,CAAC,CAAA;IAE/B,IAAI,kBAAkB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAA;IAC7C,CAAC;IAED,MAAM,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,kBAAkB,CAAC,CAAA;IACxD,MAAM,YAAY,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAA;IAExD,IACE,YAAY,CAAC,MAAM,KAAK,CAAC;QACzB,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC;QAC/B,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC;QAC1B,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,EAC3B,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,IAAI,GAAG,CAAC,CAAA;IAC1C,CAAC;IAED,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAA;AACjD,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,yBAAyB,GAAG,CACvC,QAAgB,EAChB,MAAc,EACd,SAAiB,EACjB,EAAE;IACF,MAAM,cAAc,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAA;IACtD,MAAM,YAAY,GAAG,QAAQ;SAC1B,KAAK,CAAC,SAAS,CAAC;SAChB,IAAI,CAAC,MAAM,CAAC;SACZ,KAAK,CAAC,QAAQ,CAAC;SACf,IAAI,CAAC,SAAS,CAAC,CAAA;IAClB,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAA;IAC/C,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,YAAY,CAAC,CAAA;IAEhE,IACE,YAAY,KAAK,IAAI;QACrB,YAAY,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC;QACxC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAC7B,CAAC;QACD,MAAM,IAAI,wBAAwB,CAChC,2DAA2D,CAC5D,CAAA;IACH,CAAC;IAED,OAAO,YAAY,CAAA;AACrB,CAAC,CAAA"}

package/dist/lib/translation-response.d.ts

@@ -0,0 +1,8 @@
+export declare class TranslationResponseError extends Error {
+    constructor(message: string);
+}
+export declare class TranslationProviderUnavailableError extends Error {
+    constructor();
+}
+export declare const parseTranslationResponse: (content: string | null, requestedKeys: string[]) => Record<string, string>;
+//# sourceMappingURL=translation-response.d.ts.map

package/dist/lib/translation-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translation-response.d.ts","sourceRoot":"","sources":["../../src/lib/translation-response.ts"],"names":[],"mappings":"AAAA,qBAAa,wBAAyB,SAAQ,KAAK;gBACrC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,mCAAoC,SAAQ,KAAK;;CAO7D;AAED,eAAO,MAAM,wBAAwB,GACnC,SAAS,MAAM,GAAG,IAAI,EACtB,eAAe,MAAM,EAAE,KACtB,MAAM,CAAC,MAAM,EAAE,MAAM,CAuCvB,CAAA"}

package/dist/lib/translation-response.js

@@ -0,0 +1,43 @@
+export class TranslationResponseError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "TranslationResponseError";
+    }
+}
+export class TranslationProviderUnavailableError extends Error {
+    constructor() {
+        super("A translation provider is required for this operation, but no provider credentials are configured.");
+        this.name = "TranslationProviderUnavailableError";
+    }
+}
+export const parseTranslationResponse = (content, requestedKeys) => {
+    let parsed;
+    try {
+        parsed = content === null ? null : JSON.parse(content);
+    }
+    catch {
+        throw new TranslationResponseError("Translation provider returned malformed JSON.");
+    }
+    if (parsed === null || Array.isArray(parsed) || typeof parsed !== "object") {
+        throw new TranslationResponseError("Translation provider returned a value that is not a JSON object.");
+    }
+    const response = parsed;
+    const requested = new Set(requestedKeys);
+    const responseKeys = Object.keys(response);
+    const missingKeys = requestedKeys.filter((key) => !Object.hasOwn(response, key));
+    const extraKeys = responseKeys.filter((key) => !requested.has(key));
+    const invalidValueKeys = responseKeys.filter((key) => typeof response[key] !== "string");
+    if (missingKeys.length > 0 || extraKeys.length > 0 || invalidValueKeys.length > 0) {
+        const problems = [];
+        if (missingKeys.length > 0)
+            problems.push(`missing keys: ${missingKeys.join(", ")}`);
+        if (extraKeys.length > 0)
+            problems.push(`extra keys: ${extraKeys.join(", ")}`);
+        if (invalidValueKeys.length > 0) {
+            problems.push(`non-string values: ${invalidValueKeys.join(", ")}`);
+        }
+        throw new TranslationResponseError(`Translation provider returned an invalid key/value shape (${problems.join("; ")}).`);
+    }
+    return response;
+};
+//# sourceMappingURL=translation-response.js.map

package/dist/lib/translation-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"translation-response.js","sourceRoot":"","sources":["../../src/lib/translation-response.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IACjD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAA;IACxC,CAAC;CACF;AAED,MAAM,OAAO,mCAAoC,SAAQ,KAAK;IAC5D;QACE,KAAK,CACH,oGAAoG,CACrG,CAAA;QACD,IAAI,CAAC,IAAI,GAAG,qCAAqC,CAAA;IACnD,CAAC;CACF;AAED,MAAM,CAAC,MAAM,wBAAwB,GAAG,CACtC,OAAsB,EACtB,aAAuB,EACC,EAAE;IAC1B,IAAI,MAAe,CAAA;IAEnB,IAAI,CAAC;QACH,MAAM,GAAG,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,wBAAwB,CAChC,+CAA+C,CAChD,CAAA;IACH,CAAC;IAED,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC3E,MAAM,IAAI,wBAAwB,CAChC,kEAAkE,CACnE,CAAA;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,MAAiC,CAAA;IAClD,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,CAAA;IACxC,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAC1C,MAAM,WAAW,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAA;IAChF,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAA;IACnE,MAAM,gBAAgB,GAAG,YAAY,CAAC,MAAM,CAC1C,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,QAAQ,CAAC,GAAG,CAAC,KAAK,QAAQ,CAC3C,CAAA;IAED,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClF,MAAM,QAAQ,GAAa,EAAE,CAAA;QAC7B,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC;YAAE,QAAQ,CAAC,IAAI,CAAC,iBAAiB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACpF,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;YAAE,QAAQ,CAAC,IAAI,CAAC,eAAe,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QAC9E,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,QAAQ,CAAC,IAAI,CAAC,sBAAsB,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACpE,CAAC;QACD,MAAM,IAAI,wBAAwB,CAChC,6DAA6D,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CACrF,CAAA;IACH,CAAC;IAED,OAAO,QAAkC,CAAA;AAC3C,CAAC,CAAA"}

package/dist/lib/types.d.ts

@@ -24,7 +24,7 @@ export interface Configuration {
 export interface CommandType {
     name: string;
     description: string;
-    action: (config: Configuration, ...args: any[]) => Promise<void>;
+    action: (config: Configuration, ...args: any[]) => Promise<unknown>;
 }
 export {};
 //# sourceMappingURL=types.d.ts.map

package/dist/lib/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAA;AAChC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAE3D,KAAK,KAAK,GACN,SAAS,GACT,0BAA0B,GAC1B,kBAAkB,GAClB,uBAAuB,CAAA;AAE3B,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,EAAE,CAAA;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EACJ,MAAM,GACN,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;IAC5E,QAAQ,EACJ,MAAM,GACN,CAAC,CACC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KACzB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;IACvB,aAAa,EAAE,MAAM,CAAA;IACrB,gBAAgB,EAAE,MAAM,CAAA;IACxB,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,YAAY,EAAE,CAAC,MAAM,GAAG,iBAAiB,CAAC,EAAE,CAAA;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4BAA4B,CAAC,EAAE,OAAO,CAAA;IACtC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACjE"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAA;AAChC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAE3D,KAAK,KAAK,GACN,SAAS,GACT,0BAA0B,GAC1B,kBAAkB,GAClB,uBAAuB,CAAA;AAE3B,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,EAAE,CAAA;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EACJ,MAAM,GACN,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;IAC5E,QAAQ,EACJ,MAAM,GACN,CAAC,CACC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KACzB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;IACvB,aAAa,EAAE,MAAM,CAAA;IACrB,gBAAgB,EAAE,MAAM,CAAA;IACxB,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,YAAY,EAAE,CAAC,MAAM,GAAG,iBAAiB,CAAC,EAAE,CAAA;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4BAA4B,CAAC,EAAE,OAAO,CAAA;IACtC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CACpE"}

package/dist/lib/update-translation-key.d.ts

@@ -0,0 +1,16 @@
+import type { Configuration } from "./types.js";
+export interface UpdateTranslationKeyResult {
+    key: string;
+    value: string;
+    sourceLocale: string;
+    targetNamespaces: string[];
+    updatedLocales: string[];
+    pendingLocales: string[];
+}
+export declare const updateTranslationKeyOperation: ({ config, key, value, language, }: {
+    config: Configuration;
+    key: string;
+    value: string;
+    language?: string;
+}) => Promise<UpdateTranslationKeyResult>;
+//# sourceMappingURL=update-translation-key.d.ts.map

package/dist/lib/update-translation-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-translation-key.d.ts","sourceRoot":"","sources":["../../src/lib/update-translation-key.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAQ/C,MAAM,WAAW,0BAA0B;IACzC,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,YAAY,EAAE,MAAM,CAAA;IACpB,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB,cAAc,EAAE,MAAM,EAAE,CAAA;CACzB;AAED,eAAO,MAAM,6BAA6B,GAAU,mCAKjD;IACD,MAAM,EAAE,aAAa,CAAA;IACrB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,KAAG,OAAO,CAAC,0BAA0B,CA2FrC,CAAA"}

package/dist/lib/update-translation-key.js

@@ -0,0 +1,67 @@
+import { resolveConfiguredLocale } from "./locale-storage.js";
+import { loadLocalesFile, translateKey, writeLocalesFile, } from "./utils.js";
+export const updateTranslationKeyOperation = async ({ config, key, value, language, }) => {
+    const sourceLocale = resolveConfiguredLocale(config, language);
+    const sourceFiles = await Promise.all(config.namespaces.map(async (namespace) => ({
+        namespace,
+        translations: await loadLocalesFile(config.loadPath, sourceLocale, namespace, { silent: true }),
+    })));
+    const targetNamespaces = sourceFiles
+        .filter(({ translations }) => Object.hasOwn(translations, key))
+        .map(({ namespace }) => namespace);
+    if (targetNamespaces.length === 0) {
+        throw new Error(`Key "${key}" does not exist in the ${sourceLocale} translation files. Use add_translation_key to create it.`);
+    }
+    const pendingLocales = config.openai
+        ? []
+        : config.locales.filter((locale) => locale !== sourceLocale);
+    const updatedLocales = config.openai ? [...config.locales] : [sourceLocale];
+    const translatedValues = {
+        [sourceLocale]: value,
+    };
+    if (config.openai) {
+        await Promise.all(config.locales
+            .filter((locale) => locale !== sourceLocale)
+            .map(async (locale) => {
+            const translation = await translateKey({
+                context: config.context || "",
+                inputLanguage: sourceLocale,
+                outputLanguage: locale,
+                object: { [key]: value },
+                openai: config.openai,
+                model: config.model,
+            });
+            translatedValues[locale] = translation[key];
+        }));
+    }
+    const snapshots = new Map();
+    await Promise.all(updatedLocales.flatMap((locale) => targetNamespaces.map(async (namespace) => {
+        const sourceSnapshot = locale === sourceLocale
+            ? sourceFiles.find((entry) => entry.namespace === namespace)
+                ?.translations
+            : undefined;
+        const existingKeys = sourceSnapshot ??
+            (await loadLocalesFile(config.loadPath, locale, namespace, {
+                silent: true,
+            }));
+        snapshots.set(JSON.stringify([locale, namespace]), { ...existingKeys, [key]: translatedValues[locale] });
+    })));
+    for (const locale of updatedLocales) {
+        for (const namespace of targetNamespaces) {
+            const snapshot = snapshots.get(JSON.stringify([locale, namespace]));
+            if (!snapshot) {
+                throw new Error(`Internal error: no staged snapshot for ${locale}/${namespace}.`);
+            }
+            await writeLocalesFile(config.savePath, locale, namespace, snapshot);
+        }
+    }
+    return {
+        key,
+        value,
+        sourceLocale,
+        targetNamespaces,
+        updatedLocales,
+        pendingLocales,
+    };
+};
+//# sourceMappingURL=update-translation-key.js.map

package/dist/lib/update-translation-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-translation-key.js","sourceRoot":"","sources":["../../src/lib/update-translation-key.ts"],"names":[],"mappings":"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"}

package/dist/lib/utils.d.ts

@@ -85,6 +85,7 @@ export declare const addTranslationKeys: ({ keys, config, }: {
     results: {
         key: string;
         value: string;
+        providedLanguage: string;
         namespace: string;
         locale: string;
     }[];
@@ -103,6 +104,7 @@ export declare const addTranslationKey: ({ key, value, language, config, }: {
 }) => Promise<{
     key: string;
     value: string;
+    providedLanguage: string;
     namespace: string;
     locale: string;
 }>;

package/dist/lib/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/lib/utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/lib/utils.ts"],"names":[],"mappings":"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"}

package/dist/lib/utils.js

@@ -6,11 +6,12 @@ import { Parser } from "i18next-scanner";
 import { minimatch } from "minimatch";
 import prompts from "prompts";
 import { languages } from "./languges.js";
+import { resolveConfiguredLocale, resolveLocaleTemplatePath, } from "./locale-storage.js";
+import { parseTranslationResponse, TranslationProviderUnavailableError, TranslationResponseError, } from "./translation-response.js";
 export const loadConfig = async ({ configPath = "i18n-magic.js", } = {}) => {
     const filePath = path.join(process.cwd(), configPath);
     if (!fs.existsSync(filePath)) {
-        console.error("Config file does not exist:", filePath);
-        process.exit(1);
+        throw new Error(`Config file does not exist: ${filePath}`);
     }
     try {
         // Use dynamic import for ESM compatibility
@@ -23,18 +24,10 @@ export const loadConfig = async ({ configPath = "i18n-magic.js", } = {}) => {
         const errorMessage = error instanceof Error ? error.message : String(error);
         const isModuleNotFound = errorMessage.includes("MODULE_NOT_FOUND") ||
             errorMessage.includes("Cannot find module");
-        console.error("Error while loading config:", error);
-        if (isModuleNotFound) {
-            console.error("\n💡 Tip: This error usually occurs when:");
-            console.error("   1. Your config file imports dependencies that aren't installed");
-            console.error("   2. Dependencies are installed but have missing peer dependencies");
-            console.error("   3. You're using a custom storage solution (e.g., AWS S3) without proper dependencies");
-            console.error("\n   To fix:");
-            console.error("   - Check if your config file imports any external packages");
-            console.error("   - Ensure all dependencies are properly installed: pnpm install");
-            console.error("   - If using AWS SDK, ensure all @smithy/* peer dependencies are installed");
-        }
-        process.exit(1);
+        const hint = isModuleNotFound
+            ? " Check the config imports and installed dependencies."
+            : "";
+        throw new Error(`Error while loading config: ${errorMessage}.${hint}`);
     }
 };
 export function removeDuplicatesFromArray(arr) {
@@ -63,6 +56,10 @@ const extractKeysWithRegex = (content) => {
 export const translateKey = async ({ inputLanguage, context, object, openai, outputLanguage, model, onProgress, }) => {
     // Split object into chunks of 100 keys
     const entries = Object.entries(object);
+    if (entries.length === 0)
+        return {};
+    if (!openai)
+        throw new TranslationProviderUnavailableError();
     const chunks = [];
     for (let i = 0; i < entries.length; i += 100) {
         chunks.push(entries.slice(i, i + 100));
@@ -77,29 +74,47 @@ export const translateKey = async ({ inputLanguage, context, object, openai, out
     const totalKeys = entries.length;
     for (const chunk of chunks) {
         const chunkObject = Object.fromEntries(chunk);
-        const completion = await openai.chat.completions.create({
-            model,
-            messages: [
-                {
-                    content: `You are a bot that translates the values of a locales JSON. ${context
-                        ? `The user provided some additional context or guidelines about what to fill in the blanks: "${context}". `
-                        : ""}The user provides you a JSON with a field named "inputLanguage", which defines the language the values of the JSON are defined in. It also has a field named "outputLanguage", which defines the language you should translate the values to. The last field is named "data", which includes the object with the values to translate. The keys of the values should never be changed. You output only a JSON, which has the same keys as the input, but with translated values. I give you an example input: {"inputLanguage": "English", outputLanguage: "German", "keys": {"hello": "Hello", "world": "World"}}. The output should be {"hello": "Hallo", "world": "Welt"}.`,
-                    role: "system",
+        const requestedKeys = chunk.map(([key]) => key);
+        let translatedChunk;
+        for (let attempt = 0; attempt < 2; attempt++) {
+            const correctivePrompt = attempt === 1
+                ? ` The previous response was invalid. Return exactly these keys with string values and no additional keys: ${JSON.stringify(requestedKeys)}.`
+                : "";
+            const completion = await openai.chat.completions.create({
+                model,
+                messages: [
+                    {
+                        content: `You are a bot that translates the values of a locales JSON. ${context
+                            ? `The user provided some additional context or guidelines about what to fill in the blanks: "${context}". `
+                            : ""}The user provides you a JSON with a field named "inputLanguage", which defines the language the values of the JSON are defined in. It also has a field named "outputLanguage", which defines the language you should translate the values to. The last field is named "data", which includes the object with the values to translate. The keys of the values should never be changed. You output only a JSON, which has the same keys as the input, but with translated values. I give you an example input: {"inputLanguage": "English", outputLanguage: "German", "keys": {"hello": "Hello", "world": "World"}}. The output should be {"hello": "Hallo", "world": "Welt"}.${correctivePrompt}`,
+                        role: "system",
+                    },
+                    {
+                        content: JSON.stringify({
+                            inputLanguage: input,
+                            outputLanguage: output,
+                            data: chunkObject,
+                        }),
+                        role: "user",
+                    },
+                ],
+                response_format: {
+                    type: "json_object",
                 },
-                {
-                    content: JSON.stringify({
-                        inputLanguage: input,
-                        outputLanguage: output,
-                        data: chunkObject,
-                    }),
-                    role: "user",
-                },
-            ],
-            response_format: {
-                type: "json_object",
-            },
-        });
-        const translatedChunk = JSON.parse(completion.choices[0].message.content);
+            });
+            try {
+                translatedChunk = parseTranslationResponse(completion.choices[0]?.message.content ?? null, requestedKeys);
+                break;
+            }
+            catch (error) {
+                if (!(error instanceof TranslationResponseError) || attempt === 1) {
+                    throw error;
+                }
+            }
+        }
+        if (!translatedChunk) {
+            throw new TranslationResponseError("Translation provider did not return a valid response.");
+        }
         // Merge translated chunk with result
         result = { ...result, ...translatedChunk };
         // Report progress
@@ -115,9 +130,7 @@ export const translateKey = async ({ inputLanguage, context, object, openai, out
 export const loadLocalesFile = async (loadPath, locale, namespace, options) => {
     const silent = options?.silent ?? false;
     if (typeof loadPath === "string") {
-        const resolvedPath = loadPath
-            .replace("{{lng}}", locale)
-            .replace("{{ns}}", namespace);
+        const resolvedPath = resolveLocaleTemplatePath(loadPath, locale, namespace);
         // Check if file exists, return empty object if it doesn't
         if (!fs.existsSync(resolvedPath)) {
             if (!silent) {
@@ -138,9 +151,7 @@ export const loadLocalesFile = async (loadPath, locale, namespace, options) => {
 };
 export const writeLocalesFile = async (savePath, locale, namespace, data) => {
     if (typeof savePath === "string") {
-        const resolvedSavePath = savePath
-            .replace("{{lng}}", locale)
-            .replace("{{ns}}", namespace);
+        const resolvedSavePath = resolveLocaleTemplatePath(savePath, locale, namespace);
         // Ensure directory exists
         const dir = path.dirname(resolvedSavePath);
         if (!fs.existsSync(dir)) {
@@ -592,6 +603,11 @@ export const addTranslationKeys = async ({ keys, config, }) => {
             },
         };
     }
+    const validatedKeys = keys.map(({ key, value, language }) => ({
+        key,
+        value,
+        language: resolveConfiguredLocale(config, language),
+    }));
     const log = console.log;
     const namespaceResolutionDebug = process.env.DEBUG_NAMESPACE_RESOLUTION === "1" ||
         process.env.DEBUG_NAMESPACE_RESOLUTION === "true";
@@ -632,7 +648,7 @@ export const addTranslationKeys = async ({ keys, config, }) => {
             defaultLocaleKeysByNamespace.set(namespace, {});
         }
     }));
-    const preparedKeys = keys.map(({ key, value, language = "en" }) => {
+    const preparedKeys = validatedKeys.map(({ key, value, language }) => {
         const splitKey = key.split(":");
         const hasNamespacedKey = splitKey.length > 1 && namespaces.includes(splitKey[0]);
         const normalizedKey = hasNamespacedKey ? splitKey.slice(1).join(":") : key;
@@ -709,6 +725,7 @@ export const addTranslationKeys = async ({ keys, config, }) => {
     const fileIOStartTime = performance.now();
     const localeFiles = new Map();
     const originalKeyCounts = new Map();
+    const changedFiles = new Set();
     const loadErrors = [];
     // Load files for all locales × all affected namespaces in parallel (read-only)
     const localeLoadPromises = [];
@@ -746,6 +763,7 @@ export const addTranslationKeys = async ({ keys, config, }) => {
             existingKeys[key] = value;
         }
         localeFiles.set(fileKey, existingKeys);
+        changedFiles.add(fileKey);
     }
     // Step 7: Batch translate if OpenAI is configured
     const translationStartTime = performance.now();
@@ -776,12 +794,8 @@ export const addTranslationKeys = async ({ keys, config, }) => {
                     object: keysToTranslate,
                     openai,
                     model,
-                })
-                    .then((translated) => {
+                }).then((translated) => {
                     translationCache.set(`${inputLanguage}:${targetLocale}`, translated);
-                })
-                    .catch((error) => {
-                    log(`⚠️  Failed to translate ${keyValues.length} key(s) from ${inputLanguage} to ${targetLocale}: ${error instanceof Error ? error.message : "Unknown error"}`);
                 }));
             }
         }
@@ -794,7 +808,7 @@ export const addTranslationKeys = async ({ keys, config, }) => {
                 if (!translated)
                     continue;
                 for (const { key, namespaces } of keyValues) {
-                    if (translated[key]) {
+                    if (Object.hasOwn(translated, key)) {
                         for (const namespace of namespaces) {
                             const fileKey = `${targetLocale}:${namespace}`;
                             // File MUST already be loaded from step 5 - if not, something went wrong
@@ -804,6 +818,7 @@ export const addTranslationKeys = async ({ keys, config, }) => {
                             }
                             // Merge translated key with existing keys (don't overwrite the whole file)
                             localeFiles.get(fileKey)[key] = translated[key];
+                            changedFiles.add(fileKey);
                         }
                     }
                 }
@@ -828,6 +843,8 @@ export const addTranslationKeys = async ({ keys, config, }) => {
     }
     // All validations passed, now write files sequentially to avoid race conditions
     for (const [fileKey, keys] of localeFiles) {
+        if (!changedFiles.has(fileKey))
+            continue;
         const [locale, namespace] = fileKey.split(":");
         await writeLocalesFile(savePath, locale, namespace, keys);
     }
@@ -843,7 +860,7 @@ export const addTranslationKeys = async ({ keys, config, }) => {
             config.locales.forEach((locale) => {
                 if (locale !== language) {
                     const translated = translationCache.get(`${language}:${locale}`);
-                    if (translated?.[key]) {
+                    if (translated && Object.hasOwn(translated, key)) {
                         savedLocales.add(locale);
                     }
                 }
@@ -852,6 +869,7 @@ export const addTranslationKeys = async ({ keys, config, }) => {
         return {
             key,
             value,
+            providedLanguage: language,
             namespace: resolvedNamespaces.join(", "),
             locale: Array.from(savedLocales).sort().join(", "),
         };
@@ -866,7 +884,7 @@ export const addTranslationKeys = async ({ keys, config, }) => {
         },
     };
 };
-export const addTranslationKey = async ({ key, value, language = "en", config, }) => {
+export const addTranslationKey = async ({ key, value, language, config, }) => {
     const startTime = performance.now();
     const result = await addTranslationKeys({
         keys: [{ key, value, language }],