glotstack 0.0.4 → 0.0.7

package/dist/cli.js

@@ -1,5 +1,28 @@
 #!/usr/bin/env node
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
     return new (P || (P = Promise))(function (resolve, reject) {
@@ -20,12 +43,140 @@ const findConfig_1 = require("./util/findConfig");
 const process_1 = require("process");
 const object_1 = require("./util/object");
 const yaml_1 = require("./util/yaml");
+const eslint_1 = __importDefault(require("eslint"));
+const readline = __importStar(require("node:readline/promises"));
+const node_process_1 = require("node:process");
+const undici_1 = require("undici");
+const undici_2 = require("undici");
+const node_fs_1 = require("node:fs");
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const fetchGlotstack = function (url, apiKey, body, overrideHeaders) {
+    return __awaiter(this, void 0, void 0, function* () {
+        console.info(`Extracting translations with: ${url}`);
+        const headers = Object.assign({ 'authorization': `Bearer ${apiKey}` }, (overrideHeaders == null ? {} : overrideHeaders));
+        let payloadBody;
+        if (!(body instanceof undici_2.FormData)) {
+            headers['content-type'] = 'application/json';
+            payloadBody = JSON.stringify(body);
+        }
+        else {
+            payloadBody = body;
+        }
+        try {
+            const res = yield (0, undici_1.fetch)(url, { method: 'POST', body: payloadBody, headers });
+            if (!res.ok)
+                throw new Error(`HTTP ${res.status}: ${res.statusText}`);
+            return res.json();
+        }
+        catch (err) {
+            console.error('Fetch failed:', err);
+            process.exit(1);
+        }
+    });
+};
+function unflatten(flat) {
+    const result = {};
+    for (const flatKey in flat) {
+        const parts = flatKey.split('.');
+        let current = result;
+        parts.forEach((part, idx) => {
+            if (idx === parts.length - 1) {
+                current[part] = flat[flatKey];
+            }
+            else {
+                if (!(part in current)) {
+                    current[part] = {};
+                }
+                current = current[part];
+            }
+        });
+    }
+    return result;
+}
+function resolveConfigAndOptions(options) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const configPath = (0, findConfig_1.findGlotstackConfig)((0, process_1.cwd)());
+        let config = {};
+        if (configPath != null) {
+            console.info('Loading config file at ', configPath);
+            try {
+                const text = yield fs_1.promises.readFile(configPath, 'utf-8');
+                config = JSON.parse(text);
+                console.info('Loaded config file', config);
+            }
+            catch (err) {
+                //pass
+            }
+        }
+        if ('outputLocales' in options) {
+            if (options.outputLocales.includes('en-US')) {
+                console.warn('en-US detected in outputLocales, removing');
+                options.outputLocales = options.outputLocales.filter((x) => x !== 'en-US');
+            }
+        }
+        return (0, object_1.merge)(config, options);
+    });
+}
 function run(args) {
     return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b;
+        commander_1.program
+            .command('extract-translations')
+            .description('extract translations from all compatible source files.')
+            .option('--source-path [path]', 'to source files root directory', '.')
+            .option('--api-origin [url]', 'glotstack api origin', (_a = process.env.GLOTSTACK_HOST) !== null && _a !== void 0 ? _a : 'https://glotstack.ai')
+            .option('--api-key [key]', 'api key for glotstack.ai')
+            .option('--yes', 'skip confirm checks', false)
+            .action((options) => __awaiter(this, void 0, void 0, function* () {
+            if (!options.apiOrigin) {
+                throw new Error('apiOrigin must be specified');
+            }
+            const linter = new eslint_1.default.ESLint({ overrideConfigFile: path_1.default.join(__dirname, '..', 'eslint-raw-string.mjs') });
+            const results = yield linter.lintFiles(["./**/*"]);
+            const filesWithIssues = results
+                .filter((r) => r.errorCount + r.warningCount > 0)
+                .map((r) => r.filePath);
+            const rl = readline.createInterface({ input: node_process_1.stdin, output: node_process_1.stdout });
+            const askToSend = () => __awaiter(this, void 0, void 0, function* () {
+                if (options.yes) {
+                    return true;
+                }
+                const response = yield rl.question(`Your source are going to be sent to our LLM -- they should not contain any secrets. Proceed? (yes/no):`);
+                if (response === 'yes') {
+                    return true;
+                }
+                else if (response !== 'no') {
+                    console.error('Please respond with yes or no.');
+                    return askToSend();
+                }
+                else {
+                    return false;
+                }
+            });
+            const send = yield askToSend();
+            if (send) {
+                console.info('Sending files to LLM');
+                const url = `${options.apiOrigin}/uploads/translations/extract`;
+                const form = new undici_2.FormData();
+                for (let i = 0; i < filesWithIssues.length; i++) {
+                    const filePath = filesWithIssues[i];
+                    form.append(`file_${i}`, yield (0, node_fs_1.openAsBlob)(filePath), filePath);
+                    console.debug(`Uploading file: ${filePath}`);
+                }
+                const data = yield fetchGlotstack(url, options.apiKey, form);
+                data.translations.map(elem => console.info(`${elem.name}:\n  ${elem.modified_source.url}\n\n`));
+                rl.close();
+            }
+            else {
+                rl.close();
+            }
+        }));
         commander_1.program
             .command('get-translations')
+            .description('fetch translations for all [output-locals...]. Use .glotstack.json for repeatable results.')
             .option('--source-path [path]', 'path to en-US.json (or your canonical source json)')
-            .option('--api-origin [url]', 'glotstack api origin', 'http://localhost:4001')
+            .option('--api-origin [url]', 'glotstack api origin', (_b = process.env.GLOTSTACK_HOST) !== null && _b !== void 0 ? _b : 'https://glotstack.ai')
             .option('--output-dir [path]', 'path to output directory')
             .option('--api-key [key]', 'api key for glotstack.ai')
             .option('--project-id [id]', '(optional) specific project to use')
@@ -44,24 +195,17 @@ function run(args) {
                     //pass
                 }
             }
-            const resolved = (0, object_1.merge)(config, options, { outputLocales });
-            const { apiOrigin, sourcePath, outputDir, projectId } = resolved;
-            if (resolved.outputLocales.includes('en-US')) {
-                console.warn('en-US detected in outputLocales, removing');
-                resolved.outputLocales = resolved.outputLocales.filter((x) => x !== 'en-US');
-            }
-            if (!sourcePath) {
+            const resolved = yield resolveConfigAndOptions(Object.assign(Object.assign({}, options), { outputLocales: outputLocales }));
+            if (!resolved.sourcePath) {
                 throw new Error('sourcePath must be specified');
             }
-            if (!apiOrigin) {
+            if (!resolved.apiOrigin) {
                 throw new Error('apiOrigin must be specified');
             }
-            if (!outputDir) {
+            if (!resolved.outputDir) {
                 throw new Error('outputDir must be specified');
             }
-            const url = `${apiOrigin}/api/translations`;
-            console.info(`Fetching translations from: ${url}`);
-            const absPath = path_1.default.resolve(sourcePath);
+            const absPath = path_1.default.resolve(resolved.sourcePath);
             const fileContent = yield fs_1.promises.readFile(absPath, 'utf-8');
             let json = null;
             try {
@@ -76,28 +220,55 @@ function run(args) {
                     throw err;
                 }
             }
-            const body = Object.assign({ locales: resolved.outputLocales, translations: json }, Object.assign({}, (projectId != null ? { projectId } : {})));
-            const headers = {
-                'Content-Type': 'application/json',
-                'Authorization': `Bearer ${resolved.apiKey}`,
-            };
-            try {
-                const res = yield fetch(url, { method: 'POST', body: JSON.stringify(body), headers });
-                if (!res.ok)
-                    throw new Error(`HTTP ${res.status}: ${res.statusText}`);
-                const data = yield res.json();
-                console.info('Received translations:', data);
-                Object.entries(data.data).map(([key, val]) => {
-                    const p = `${outputDir}/${key}.json`;
-                    console.info(`Writing file ${p}`);
-                    fs_1.promises.writeFile(`${outputDir}/${key}.json`, JSON.stringify(val, null, 2));
-                });
-                // fs.writeFile(`${outputDir}/source.json`, JSON.stringify(json, null, 2))
+            const body = Object.assign({ locales: resolved.outputLocales, translations: json }, Object.assign({}, (resolved.projectId != null ? { projectId: resolved.projectId } : {})));
+            const url = `${options.apiOrigin}/api/translations`;
+            const data = yield fetchGlotstack(url, resolved.apiKey, body);
+            console.info('Received translations:', data);
+            Object.entries(data.data).map(([key, val]) => {
+                const p = `${resolved.outputDir}/${key}.json`;
+                console.info(`Writing file ${p}`);
+                fs_1.promises.writeFile(`${resolved.outputDir}/${key}.json`, JSON.stringify(val, null, 2));
+            });
+        }));
+        commander_1.program
+            .command('format-json')
+            .description('format files in --source-path [path] to nested (not flat)')
+            .option('--source-path [path]', 'to source files root directory', '.')
+            .option('--yes', 'skip confirm checks', false)
+            .action((options) => __awaiter(this, void 0, void 0, function* () {
+            if (!options.sourcePath) {
+                throw new Error('sourcePath must be specified');
             }
-            catch (err) {
-                console.error('Fetch failed:', err);
-                process.exit(1);
+            const rl = readline.createInterface({ input: node_process_1.stdin, output: node_process_1.stdout });
+            const askToSend = () => __awaiter(this, void 0, void 0, function* () {
+                if (options.yes) {
+                    return true;
+                }
+                const response = yield rl.question(`This will update your source files -- have you checked them into SCM/git? Type yes to proceed (yes/no):`);
+                if (response === 'yes') {
+                    return true;
+                }
+                else if (response !== 'no') {
+                    console.error('Please respond with yes or no.');
+                    return askToSend();
+                }
+                else {
+                    return false;
+                }
+            });
+            const yes = yield askToSend();
+            if (yes) {
+                const files = yield (0, promises_1.readdir)(options.sourcePath);
+                for (let i = 0; i < (yield files).length; i++) {
+                    const fp = (0, node_path_1.resolve)(options.sourcePath, files[i]);
+                    const text = yield (0, promises_1.readFile)(fp, 'utf-8');
+                    const json = JSON.parse(text);
+                    const formatted = JSON.stringify(unflatten(json), null, 2);
+                    yield (0, promises_1.writeFile)(fp, formatted);
+                }
+                rl.close();
             }
+            rl.close();
         }));
         yield commander_1.program.parseAsync(args);
     });

package/dist/cli.js.map

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

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-export type LocaleRegion = 'en' | 'en-US' | 'en-US-genz' | 'fr-FR' | 'de-DE' | 'nl-NL' | 'jp-JP' | string;
+export type LocaleRegion = string;
 export interface TranslationLeaf {
     value: string;
     context?: string;
@@ -16,18 +16,28 @@ export interface ContextType {
     t: (key: string, options?: {
         locale?: LocaleRegion;
     }) => string;
+    ssr: boolean;
 }
 export declare const GlotstackContext: React.Context<ContextType>;
 interface GlotstackProviderProps {
     children: React.ReactNode;
-    initialTranslations?: Translations;
+    initialTranslations?: Record<string, Translations>;
     initialLocale?: LocaleRegion;
     onTranslationLoaded?: (locale: LocaleRegion, translations: Translations) => void;
     onLocaleChange?: (locale: LocaleRegion) => void;
-    importMethod: (locale: LocaleRegion) => Promise<Translations>;
+    importMethod: ContextType['importMethod'];
+    ssr?: boolean;
+}
+export declare enum LogLevel {
+    DEBUG = 0,
+    LOG = 1,
+    INFO = 2,
+    WARNING = 3,
+    ERROR = 4
 }
+export declare const setLogLevel: (level: LogLevel) => void;
 export declare const access: (key: string, locale: LocaleRegion, translations: Translations) => string;
-export declare const GlotstackProvider: ({ children, initialLocale, initialTranslations, onLocaleChange, onTranslationLoaded, importMethod }: GlotstackProviderProps) => React.JSX.Element;
+export declare const GlotstackProvider: ({ children, initialLocale, initialTranslations, onLocaleChange, onTranslationLoaded, importMethod, ssr }: GlotstackProviderProps) => import("react/jsx-runtime").JSX.Element;
 export declare const useGlotstack: () => ContextType;
 export declare const useTranslations: (_options?: Record<never, never>) => ContextType;
 export {};

package/dist/index.js

@@ -32,8 +32,10 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useTranslations = exports.useGlotstack = exports.GlotstackProvider = exports.access = exports.GlotstackContext = void 0;
+exports.useTranslations = exports.useGlotstack = exports.GlotstackProvider = exports.access = exports.setLogLevel = exports.LogLevel = exports.GlotstackContext = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
 const React = __importStar(require("react"));
+const object_1 = require("./util/object");
 exports.GlotstackContext = React.createContext({
     translations: {},
     loadTranslations: () => { throw new Error('no import method set'); },
@@ -41,9 +43,46 @@ exports.GlotstackContext = React.createContext({
     locale: null,
     importMethod: (_locale) => { throw new Error('import method not set'); },
     t: () => { throw new Error('import method not set'); },
+    ssr: false
 });
+var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["DEBUG"] = 0] = "DEBUG";
+    LogLevel[LogLevel["LOG"] = 1] = "LOG";
+    LogLevel[LogLevel["INFO"] = 2] = "INFO";
+    LogLevel[LogLevel["WARNING"] = 3] = "WARNING";
+    LogLevel[LogLevel["ERROR"] = 4] = "ERROR";
+})(LogLevel || (exports.LogLevel = LogLevel = {}));
+const LogLevelToFunc = {
+    [LogLevel.DEBUG]: console.debug,
+    [LogLevel.INFO]: console.info,
+    [LogLevel.LOG]: console.log,
+    [LogLevel.WARNING]: console.warn,
+    [LogLevel.ERROR]: console.error,
+};
+let logLevel = LogLevel.DEBUG;
+const setLogLevel = (level) => {
+    logLevel = level;
+};
+exports.setLogLevel = setLogLevel;
+const makeLoggingFunction = (level) => (...args) => {
+    const func = LogLevelToFunc[level];
+    if (level < logLevel) {
+        return;
+    }
+    return func(`[level=${level} logLevel=${logLevel}][glotstack.ai]`, ...args);
+};
+const logger = {
+    debug: makeLoggingFunction(LogLevel.DEBUG),
+    info: makeLoggingFunction(LogLevel.INFO),
+    warn: makeLoggingFunction(LogLevel.WARNING),
+    error: makeLoggingFunction(LogLevel.ERROR),
+};
 const access = (key, locale, translations) => {
     var _a;
+    if (translations == null) {
+        return key;
+    }
     const access = [...key.split('.')];
     const localeTranslations = translations === null || translations === void 0 ? void 0 : translations[locale];
     if (localeTranslations == null) {
@@ -56,61 +95,71 @@ const access = (key, locale, translations) => {
     return ((_a = value === null || value === void 0 ? void 0 : value.value) !== null && _a !== void 0 ? _a : key);
 };
 exports.access = access;
-const GlotstackProvider = ({ children, initialLocale, initialTranslations, onLocaleChange, onTranslationLoaded, importMethod }) => {
+const GlotstackProvider = ({ children, initialLocale, initialTranslations, onLocaleChange, onTranslationLoaded, importMethod, ssr }) => {
     if (initialLocale == null) {
         throw new Error('initialLocale must be set');
     }
     const [locale, setLocale] = React.useState(initialLocale);
-    const [translations, setTranslations] = React.useState(initialTranslations);
+    const translationsRef = React.useRef(initialTranslations || null);
     const loadingRef = React.useRef({});
-    const loadTranslations = React.useCallback((locale) => __awaiter(void 0, void 0, void 0, function* () {
-        var _a, _b;
+    const loadTranslations = React.useCallback((locale, opts) => __awaiter(void 0, void 0, void 0, function* () {
+        var _a, _b, _c, _d, _e, _f;
+        // TODO: if translations are loaded only reload if some condition is
         try {
-            if (((_a = loadingRef.current) === null || _a === void 0 ? void 0 : _a[locale]) != null) {
+            if (((_a = loadingRef.current) === null || _a === void 0 ? void 0 : _a[locale]) != null && (opts === null || opts === void 0 ? void 0 : opts.force) != true) {
+                logger.debug('Waiting for translations already loading', locale);
                 return (yield ((_b = loadingRef.current) === null || _b === void 0 ? void 0 : _b[locale]));
             }
-            loadingRef.current[locale] = importMethod(locale);
+            if (((_c = translationsRef.current) === null || _c === void 0 ? void 0 : _c[locale]) != null && (opts === null || opts === void 0 ? void 0 : opts.force) != true) {
+                logger.debug('Skipping load for translations', locale, (_d = translationsRef.current) === null || _d === void 0 ? void 0 : _d[locale], translationsRef.current);
+                return (_e = translationsRef.current) === null || _e === void 0 ? void 0 : _e[locale];
+            }
+            if (loadingRef.current != null) {
+                logger.debug('Loading translations', locale, (0, object_1.merge)({}, (_f = translationsRef.current) !== null && _f !== void 0 ? _f : {}));
+                loadingRef.current[locale] = importMethod(locale);
+            }
             const result = yield loadingRef.current[locale];
             if (result == null) {
                 throw new Error(`Failed to load translation ${locale} ${JSON.stringify(result)}`);
             }
-            setTranslations(Object.assign(Object.assign({}, translations), { [locale]: result }));
+            if (translationsRef.current) {
+                translationsRef.current[locale] = result;
+            }
             onTranslationLoaded === null || onTranslationLoaded === void 0 ? void 0 : onTranslationLoaded(locale, result);
             return result;
         }
         catch (err) {
-            console.error('Unable to import translations', err);
+            logger.error('Unable to import translations', err);
             throw err;
         }
-    }), [importMethod, translations, onTranslationLoaded, setTranslations]);
+    }), [importMethod, onTranslationLoaded]);
     React.useEffect(() => {
         const run = () => __awaiter(void 0, void 0, void 0, function* () {
             onLocaleChange === null || onLocaleChange === void 0 ? void 0 : onLocaleChange(locale);
-            const result = yield loadTranslations(locale);
+            yield loadTranslations(locale);
         });
         React.startTransition(() => {
             run();
         });
     }, [locale]);
     const context = React.useMemo(() => {
+        var _a;
         return {
             setLocale,
-            translations: translations !== null && translations !== void 0 ? translations : {},
+            translations: (_a = translationsRef.current) !== null && _a !== void 0 ? _a : {},
             locale,
             importMethod,
             loadTranslations,
             t: (key, opts) => {
-                React.useEffect(() => {
-                    if ((opts === null || opts === void 0 ? void 0 : opts.locale) == null) {
-                        return;
-                    }
-                    loadTranslations(opts === null || opts === void 0 ? void 0 : opts.locale);
-                }, [locale]);
-                return (0, exports.access)(key, locale, translations !== null && translations !== void 0 ? translations : {});
-            }
+                var _a, _b, _c;
+                const resolvedLocale = (_a = opts === null || opts === void 0 ? void 0 : opts.locale) !== null && _a !== void 0 ? _a : locale;
+                loadTranslations(resolvedLocale);
+                return (0, exports.access)(key, (_b = opts === null || opts === void 0 ? void 0 : opts.locale) !== null && _b !== void 0 ? _b : locale, (_c = translationsRef.current) !== null && _c !== void 0 ? _c : {});
+            },
+            ssr: ssr == true,
         };
-    }, [locale, importMethod, translations]);
-    return React.createElement(exports.GlotstackContext.Provider, { value: context }, children);
+    }, [locale, importMethod]);
+    return (0, jsx_runtime_1.jsx)(exports.GlotstackContext.Provider, { value: context, children: children });
 };
 exports.GlotstackProvider = GlotstackProvider;
 const useGlotstack = () => {

package/dist/index.js.map

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

package/eslint-raw-string.mjs

@@ -0,0 +1,15 @@
+import globals from "globals";
+import tseslint from "typescript-eslint";
+import { defineConfig, globalIgnores } from "eslint/config";
+import i18next from 'eslint-plugin-i18next';
+
+
+export default defineConfig([
+  { files: ["**/*.{js,mjs,cjs,ts,jsx,tsx}"], languageOptions: { globals: globals.browser } },
+  globalIgnores([
+    'node_modules/*', // ignore node modules
+    '**/*.d.ts', // ignore type definitions
+  ]),
+  tseslint.configs.base,
+  i18next.configs['flat/recommended'],
+]);

package/package.json

@@ -1,34 +1,41 @@
 {
   "name": "glotstack",
-  "version": "0.0.4",
+  "version": "0.0.7",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "author": "JD Cumpson",
   "license": "MIT",
   "private": false,
   "dependencies": {
-    "commander": "^13.1.0"
+    "@eslint/js": "^9.26.0",
+    "commander": "^13.1.0",
+    "eslint": "^9.26.0",
+    "eslint-plugin-i18next": "^6.1.1",
+    "eslint-plugin-react": "^7.37.5",
+    "form-data": "^4.0.2",
+    "undici": "^7.9.0"
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^22.15.17",
-    "@types/react": "^19.1.3",
+    "@types/react": "^18.3.1",
+    "@types/react-dom": "^18.3.1",
+    "globals": "^16.1.0",
     "js-yaml": "^4.1.0",
+    "nodemon": "^3.1.10",
     "typescript": "5.4.4",
-    "typescript-eslint": "^8.17.0"
+    "typescript-eslint": "^8.32.1"
   },
   "peerDependencies": {
-    "@types/react": "^19.1.3",
-    "react": "^18.3.1"
-  },
-  "resolutions": {
-    "react": "18.3.1"
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1"
   },
   "bin": {
     "glotstack": "dist/cli.js"
   },
   "scripts": {
     "build": "tsc && scripts/fix-shebang.sh dist/cli.js",
+    "watch": "nodemon --watch src --ext ts,tsx,mjs,json --exec \"bash -c 'npm run build'\"",
     "prepublishOnly": "yarn run build",
     "glotstack": "node dist/cli.js"
   }

package/src/cli.tsx

@@ -1,17 +1,155 @@
 import { Command, program } from 'commander'
 import path from 'path'
-import { promises as fs } from 'fs'
+import { promises as fs, createReadStream } from 'fs'
 import { findGlotstackConfig } from './util/findConfig'
 import { cwd } from 'process'
 import { merge } from './util/object'
 import { loadYaml } from './util/yaml'
+import eslint from 'eslint'
+import * as readline from "node:readline/promises"
+import { stdin as input, stdout as output } from "node:process"
+import { Translations } from 'src'
+import { fetch } from 'undici'
+import { FormData } from 'undici'
+import { openAsBlob } from 'node:fs'
+import { readdir, readFile, writeFile } from 'node:fs/promises'
+import { resolve } from 'node:path'
+
+const fetchGlotstack = async function <T>(url: string, apiKey: string, body: Record<string, any> | FormData, overrideHeaders?: Record<string, any>): Promise<T> {
+  console.info(`Extracting translations with: ${url}`)
+
+  const headers: Record<string, any> = {
+    'authorization': `Bearer ${apiKey}`,
+    ...(overrideHeaders == null ? {} : overrideHeaders),
+  }
+
+  let payloadBody: FormData | string
+
+  if (!(body instanceof FormData)) {
+    headers['content-type'] = 'application/json'
+    payloadBody = JSON.stringify(body)
+  } else {
+    payloadBody = body
+  }
+
+  try {
+    const res = await fetch(url, { method: 'POST', body: payloadBody, headers })
+    if (!res.ok) throw new Error(`HTTP ${res.status}: ${res.statusText}`)
+    return res.json() as T
+  } catch (err) {
+    console.error('Fetch failed:', err)
+    process.exit(1)
+  }
+}
+
+function unflatten(flat: Record<string, any>): Record<string, any> {
+  const result: Record<string, any> = {}
+
+  for (const flatKey in flat) {
+    const parts = flatKey.split('.')
+    let current = result
+
+    parts.forEach((part, idx) => {
+      if (idx === parts.length - 1) {
+        current[part] = flat[flatKey]
+      } else {
+        if (!(part in current)) {
+          current[part] = {}
+        }
+        current = current[part]
+      }
+    })
+  }
+
+  return result
+}
+
+async function resolveConfigAndOptions(options: Record<string, any>) {
+  
+  const configPath = findGlotstackConfig(cwd())
+  let config = {}
+
+  if (configPath != null) {
+    console.info('Loading config file at ', configPath)
+    try {
+      const text = await fs.readFile(configPath, 'utf-8')
+      config = JSON.parse(text)
+      console.info('Loaded config file', config)
+    } catch (err) {
+      //pass
+    }
+  }
+
+  if ('outputLocales' in options) {
+    if ((options.outputLocales as string[]).includes('en-US')) {
+      console.warn('en-US detected in outputLocales, removing')
+      options.outputLocales = options.outputLocales.filter((x: string) => x !== 'en-US')
+    }
+  }
+
+  return merge(config, options)
+}
 
 
 async function run(args: string[]) {
+  program
+    .command('extract-translations')
+    .description('extract translations from all compatible source files.')
+    .option('--source-path [path]', 'to source files root directory', '.')
+    .option('--api-origin [url]', 'glotstack api origin', process.env.GLOTSTACK_HOST ?? 'https://glotstack.ai')
+    .option('--api-key [key]', 'api key for glotstack.ai')
+    .option('--yes', 'skip confirm checks', false)
+    .action(async (options: Record<string, any>) => {
+      if (!options.apiOrigin) {
+        throw new Error('apiOrigin must be specified')
+      }
+
+      const linter = new eslint.ESLint({ overrideConfigFile: path.join(__dirname, '..', 'eslint-raw-string.mjs') })
+      const results = await linter.lintFiles(["./**/*"])
+      const filesWithIssues = results
+        .filter((r) => r.errorCount + r.warningCount > 0)
+        .map((r) => r.filePath)
+
+      const rl = readline.createInterface({ input, output })
+      const askToSend = async (): Promise<boolean> => {
+        if (options.yes) {
+          return true
+        }
+        const response = await rl.question(`Your source are going to be sent to our LLM -- they should not contain any secrets. Proceed? (yes/no):`)
+        if (response === 'yes') {
+          return true
+        } else if (response !== 'no') {
+          console.error('Please respond with yes or no.')
+          return askToSend()
+        } else {
+          return false
+        }
+      }
+
+      const send = await askToSend()
+      if (send) {
+        console.info('Sending files to LLM')
+        const url = `${options.apiOrigin}/uploads/translations/extract`
+        const form = new FormData()
+
+        for (let i = 0; i < filesWithIssues.length; i++) {
+          const filePath = filesWithIssues[i]
+          form.append(`file_${i}`, await openAsBlob(filePath), filePath)
+          console.debug(`Uploading file: ${filePath}`)
+        }
+        const data = await fetchGlotstack<{ translations: { name: string; modified_source: { url: string } }[] }>(url, options.apiKey, form)
+        data.translations.map(elem => console.info(`${elem.name}:\n  ${elem.modified_source.url}\n\n`))
+        rl.close()
+      } else {
+        rl.close()
+      }
+    })
+
   program
     .command('get-translations')
+    .description('fetch translations for all [output-locals...]. Use .glotstack.json for repeatable results.')
     .option('--source-path [path]', 'path to en-US.json (or your canonical source json)')
-    .option('--api-origin [url]', 'glotstack api origin', 'http://localhost:4001')
+    .option('--api-origin [url]', 'glotstack api origin', process.env.GLOTSTACK_HOST ?? 'https://glotstack.ai')
     .option('--output-dir [path]', 'path to output directory')
     .option('--api-key [key]', 'api key for glotstack.ai')
     .option('--project-id [id]', '(optional) specific project to use')
@@ -26,77 +164,95 @@ async function run(args: string[]) {
           const text = await fs.readFile(configPath, 'utf-8')
           config = JSON.parse(text)
           console.info('Loaded config file', config)
-        } catch(err) {
+        } catch (err) {
           //pass
         }
       }
 
-      const resolved = merge(config, options, { outputLocales })
-      const { apiOrigin, sourcePath, outputDir, projectId} = resolved
-
-      if ((resolved.outputLocales as string[]).includes('en-US')) {
-        console.warn('en-US detected in outputLocales, removing');
-        resolved.outputLocales = resolved.outputLocales.filter((x: string) => x !== 'en-US')
-      }
-
-      if (!sourcePath) {
+      const resolved = await resolveConfigAndOptions({...options, outputLocales: outputLocales})
+      if (!resolved.sourcePath) {
         throw new Error('sourcePath must be specified')
       }
-      if (!apiOrigin) {
+      if (!resolved.apiOrigin) {
         throw new Error('apiOrigin must be specified')
       }
-      if (!outputDir) {
+      if (!resolved.outputDir) {
         throw new Error('outputDir must be specified')
       }
 
-      const url = `${apiOrigin}/api/translations`
-      console.info(`Fetching translations from: ${url}`)
-
-      const absPath = path.resolve(sourcePath)
+      const absPath = path.resolve(resolved.sourcePath)
       const fileContent = await fs.readFile(absPath, 'utf-8')
 
       let json = null
       try {
         json = loadYaml(fileContent)
-      } catch(err) {
+      } catch (err) {
         try {
           json = JSON.parse(fileContent)
-        } catch(err) {
+        } catch (err) {
           console.error('Unable to parse source file ', absPath, err)
-          throw err;
+          throw err
         }
       }
 
       const body = {
         locales: resolved.outputLocales,
         translations: json,
-        ...{ ... (projectId != null ? {projectId} : {})},
+        ...{ ... (resolved.projectId != null ? { projectId: resolved.projectId } : {}) },
       }
 
-      const headers ={
-        'Content-Type': 'application/json',
-        'Authorization': `Bearer ${resolved.apiKey}` ,
-      }
+      const url = `${options.apiOrigin}/api/translations`
+      const data = await fetchGlotstack<{ data: Translations }>(url, resolved.apiKey, body)
+      console.info('Received translations:', data)
+      Object.entries(data.data).map(([key, val]) => {
+        const p = `${resolved.outputDir}/${key}.json`
+        console.info(`Writing file ${p}`)
+        fs.writeFile(`${resolved.outputDir}/${key}.json`, JSON.stringify(val, null, 2))
+      })
+    })
 
-      try {
-        const res = await fetch(url, { method: 'POST', body: JSON.stringify(body), headers })
-        if (!res.ok) throw new Error(`HTTP ${res.status}: ${res.statusText}`)
-
-        const data = await res.json()
-        console.info('Received translations:', data)
-        Object.entries(data.data).map(([key, val]) => {
-          const p = `${outputDir}/${key}.json`
-          console.info(`Writing file ${p}`)
-          fs.writeFile(`${outputDir}/${key}.json`, JSON.stringify(val, null, 2))
-        })
-        // fs.writeFile(`${outputDir}/source.json`, JSON.stringify(json, null, 2))
-      } catch (err) {
-        console.error('Fetch failed:', err)
-        process.exit(1)
+  program
+    .command('format-json')
+    .description('format files in --source-path [path] to nested (not flat)')
+    .option('--source-path [path]', 'to source files root directory', '.')
+    .option('--yes', 'skip confirm checks', false)
+    .action(async (options: Record<string, any>) => {
+
+      if (!options.sourcePath) {
+        throw new Error('sourcePath must be specified')
       }
+      const rl = readline.createInterface({ input, output })
+      const askToSend = async (): Promise<boolean> => {
+        if (options.yes) {
+          return true
+        }
+        const response = await rl.question(`This will update your source files -- have you checked them into SCM/git? Type yes to proceed (yes/no):`)
+        if (response === 'yes') {
+          return true
+        } else if (response !== 'no') {
+          console.error('Please respond with yes or no.')
+          return askToSend()
+        } else {
+          return false
+        }
+      }
+      const yes = await askToSend()
+      if (yes) {
+        const files = await readdir(options.sourcePath)
+        for (let i = 0; i < (await files).length; i++) {
+          const fp = resolve(options.sourcePath, files[i])
+          const text = await readFile(fp, 'utf-8')
+          const json = JSON.parse(text)
+          const formatted = JSON.stringify(unflatten(json), null, 2)
+          await writeFile(fp, formatted)
+        }
+        rl.close()
+      }
+      rl.close()
 
     })
 
+
   await program.parseAsync(args)
 }
 

package/src/index.tsx

@@ -1,15 +1,8 @@
 import * as React from 'react'
-import { merge, isEqual } from './util/object'
+import { merge } from './util/object'
+import { debug } from 'node:console'
 
-export type LocaleRegion =
-  | 'en'
-  | 'en-US'
-  | 'en-US-genz'
-  | 'fr-FR'
-  | 'de-DE'
-  | 'nl-NL'
-  | 'jp-JP'
-  | string
+export type LocaleRegion = string
 
 
 export interface TranslationLeaf {
@@ -21,13 +14,15 @@ export interface Translations {
   [key: string]: Translations | TranslationLeaf
 }
 
+
 export interface ContextType {
   translations: Translations
   locale: string | null
   loadTranslations: (locale: LocaleRegion) => Promise<Translations>
   setLocale: (locale: LocaleRegion) => void
-  importMethod: (locale: LocaleRegion) => Promise<Translations>
+  importMethod: (locale: LocaleRegion) => Promise<Translations> 
   t: (key: string, options?: { locale?: LocaleRegion }) => string
+  ssr: boolean
 }
 
 export const GlotstackContext = React.createContext<ContextType>({
@@ -37,18 +32,61 @@ export const GlotstackContext = React.createContext<ContextType>({
   locale: null,
   importMethod: (_locale: LocaleRegion) => { throw new Error('import method not set') },
   t: () => { throw new Error('import method not set') },
+  ssr: false
 })
 
 interface GlotstackProviderProps {
   children: React.ReactNode
-  initialTranslations?: Translations
+  initialTranslations?: Record<string, Translations>
   initialLocale?: LocaleRegion
   onTranslationLoaded?: (locale: LocaleRegion, translations: Translations) => void
   onLocaleChange?: (locale: LocaleRegion) => void
-  importMethod: (locale: LocaleRegion) => Promise<Translations>
+  importMethod: ContextType['importMethod']
+  ssr?: boolean
+}
+
+export enum LogLevel {
+  DEBUG = 0,
+  LOG = 1,
+  INFO = 2,
+  WARNING = 3,
+  ERROR = 4,
+}
+
+const LogLevelToFunc: Record<LogLevel, (...args: Parameters<typeof console.info>) => void> = {
+  [LogLevel.DEBUG]: console.debug,
+  [LogLevel.INFO]: console.info,
+  [LogLevel.LOG]: console.log,
+  [LogLevel.WARNING]: console.warn,
+  [LogLevel.ERROR]: console.error,
+} as const
+
+let logLevel: LogLevel = LogLevel.DEBUG
+
+export const setLogLevel = (level: LogLevel) => {
+  logLevel = level
+}
+
+const makeLoggingFunction = (level: LogLevel) => (...args: Parameters<typeof console.info>) => {
+  const func = LogLevelToFunc[level]
+  if (level < logLevel) {
+    return
+  }
+  return func(`[level=${level} logLevel=${logLevel}][glotstack.ai]`, ...args)
+}
+
+const logger = {
+  debug: makeLoggingFunction(LogLevel.DEBUG),
+  info: makeLoggingFunction(LogLevel.INFO),
+  warn: makeLoggingFunction(LogLevel.WARNING),
+  error: makeLoggingFunction(LogLevel.ERROR),
+
 }
 
 export const access = (key: string, locale: LocaleRegion, translations: Translations) => {
+  if (translations == null) {
+    return key
+  }
   const access = [...key.split('.')] as [LocaleRegion, ...string[]]
   const localeTranslations = translations?.[locale]
 
@@ -64,39 +102,49 @@ export const access = (key: string, locale: LocaleRegion, translations: Translat
   return (value?.value ?? key) as string
 }
 
-export const GlotstackProvider = ({ children, initialLocale, initialTranslations, onLocaleChange, onTranslationLoaded, importMethod }: GlotstackProviderProps) => {
+export const GlotstackProvider = ({ children, initialLocale, initialTranslations, onLocaleChange, onTranslationLoaded, importMethod, ssr}: GlotstackProviderProps) => {
   if (initialLocale == null) {
     throw new Error('initialLocale must be set')
   }
-
   const [locale, setLocale] = React.useState<LocaleRegion>(initialLocale)
-  const [translations, setTranslations] = React.useState(initialTranslations)
+  const translationsRef = React.useRef<Record<string, Translations>|null>(initialTranslations || null)
   const loadingRef = React.useRef<Record<string, Promise<Translations>>>({})
 
-  const loadTranslations = React.useCallback(async (locale: string) => {
+  const loadTranslations = React.useCallback(async (locale: string, opts?: {force?: boolean}) => {
+    // TODO: if translations are loaded only reload if some condition is
     try {
-      if (loadingRef.current?.[locale] != null) {
+      if (loadingRef.current?.[locale] != null && opts?.force != true) {
+        logger.debug('Waiting for translations already loading', locale)
         return (await loadingRef.current?.[locale])
       }
-      loadingRef.current[locale] = importMethod(locale)
+      if (translationsRef.current?.[locale] != null && opts?.force != true) {
+        logger.debug('Skipping load for translations', locale, translationsRef.current?.[locale], translationsRef.current)
+        return translationsRef.current?.[locale]
+      }
+      if (loadingRef.current != null) {
+        logger.debug('Loading translations', locale, merge({}, translationsRef.current ?? {}))
+        loadingRef.current[locale] = importMethod(locale)
+      }
       const result = await loadingRef.current[locale]
 
       if (result == null) {
         throw new Error(`Failed to load translation ${locale} ${JSON.stringify(result)}`)
       }
-      setTranslations({ ...translations, [locale]: result })
+      if (translationsRef.current) {
+        translationsRef.current[locale] = result
+      }
       onTranslationLoaded?.(locale, result)
       return result
     } catch (err) {
-      console.error('Unable to import translations', err)
+      logger.error('Unable to import translations', err)
       throw err
     }
-  }, [importMethod, translations, onTranslationLoaded, setTranslations])
+  }, [importMethod, onTranslationLoaded])
 
   React.useEffect(() => {
     const run = async () => {
       onLocaleChange?.(locale)
-      const result = await loadTranslations(locale)
+      await loadTranslations(locale)
     }
     React.startTransition(() => {
       run()
@@ -106,22 +154,18 @@ export const GlotstackProvider = ({ children, initialLocale, initialTranslations
   const context = React.useMemo(() => {
     return {
       setLocale,
-      translations: translations ?? {},
+      translations: translationsRef.current ?? {},
       locale,
       importMethod,
       loadTranslations,
       t: (key: string, opts?: { locale?: LocaleRegion }) => {
-        React.useEffect(() => {
-          if (opts?.locale == null) {
-            return
-          }
-          loadTranslations(opts?.locale)
-        }, [locale])
-        return access(key, locale, translations ?? {})
-      }
-
+        const resolvedLocale = opts?.locale ?? locale
+        loadTranslations(resolvedLocale)
+        return access(key, opts?.locale ?? locale, translationsRef.current ?? {})
+      },
+      ssr: ssr == true,
     }
-  }, [locale, importMethod, translations])
+  }, [locale, importMethod])
 
   return <GlotstackContext.Provider value={context}>
     {children}
@@ -132,7 +176,6 @@ export const useGlotstack = () => {
   return React.useContext(GlotstackContext)
 }
 
-
 export const useTranslations = (_options?: Record<never, never>) => {
   const context = React.useContext(GlotstackContext)
   return context

package/tsconfig.json

@@ -8,7 +8,7 @@
     "module": "CommonJS",
     "declaration": true,
     "strict": true,
-    "jsx": "react",
+    "jsx": "react-jsx",
     "sourceMap": true,
     "baseUrl": ".",
     "paths": {