@translation-cms/sync 1.2.28 → 1.2.30

package/dist/commands/init.js

@@ -0,0 +1,107 @@
+import path from 'path';
+import fs from 'fs';
+import { scaffoldI18n } from '../scaffold/index.js';
+/**
+ * Interactive `init` command.
+ *
+ * Walks the user through a series of prompts and writes a
+ * `.translationsrc.json` config file to the project root.
+ * Optionally scaffolds the i18n boilerplate files (settings,
+ * client, server, provider) into the chosen i18n directory.
+ */
+export async function runInit(root) {
+    const { createInterface } = await import('readline');
+    // Use readline so we can show prompts and read answers synchronously one by one
+    const rl = createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    const question = (prompt) => new Promise(resolve => rl.question(prompt, resolve));
+    // eslint-disable-next-line no-console
+    console.log('sync-translations init\n');
+    // eslint-disable-next-line no-console
+    console.log('This creates .translationsrc.json in your project root.');
+    // eslint-disable-next-line no-console
+    console.log('Values here override env vars for the sync-translations CLI.\n');
+    // Collect required config values from the user
+    const cmsUrl = await question('CMS URL (e.g. https://cms.example.com): ');
+    const projectId = await question('Project ID: ');
+    const apiKey = await question('API key: ');
+    const i18nDirInput = await question('i18n directory [./src/lib/i18n]: ');
+    const pullTtlInput = await question('Pull TTL in seconds [300]: ');
+    const scaffoldInput = await question('Scaffold i18n files (settings, client, server, provider)? [Y/n]: ');
+    rl.close();
+    // Apply defaults for optional fields
+    const i18nDir = i18nDirInput.trim() || './src/lib/i18n';
+    // Dictionaries live one level deeper than the i18n dir
+    const outputDir = `${i18nDir.replace(/\/$/, '')}/dictionaries`;
+    // Build the config object — only include keys that the user actually provided
+    const config = {
+        $schema: './node_modules/@translation-cms/sync/schema.json',
+    };
+    if (cmsUrl.trim())
+        config['cmsUrl'] = cmsUrl.trim();
+    if (projectId.trim())
+        config['projectId'] = projectId.trim();
+    if (apiKey.trim())
+        config['apiKey'] = apiKey.trim();
+    config['outputDir'] = outputDir;
+    if (pullTtlInput.trim()) {
+        const ttlSec = parseInt(pullTtlInput.trim(), 10);
+        // Convert seconds → milliseconds for the config field
+        if (!isNaN(ttlSec))
+            config['pullTtlMs'] = ttlSec * 1000;
+    }
+    // Write the config file
+    const configPath = path.join(root, '.translationsrc.json');
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf-8');
+    console.log(`\nCreated: ${configPath}`);
+    // Warn if an API key was written to disk — it should ideally stay in .env.local
+    if (config['apiKey']) {
+        console.log('\nWarning: .translationsrc.json contains an API key. Consider adding it to .gitignore:');
+        console.log('  echo ".translationsrc.json" >> .gitignore');
+        console.log('Or move the API key to CMS_SYNC_API_KEY in .env.local instead.');
+    }
+    // Default to scaffolding unless the user explicitly answers "n"
+    const doScaffold = scaffoldInput.trim().toLowerCase() !== 'n';
+    if (doScaffold) {
+        const absI18nDir = path.isAbsolute(i18nDir)
+            ? i18nDir
+            : path.resolve(root, i18nDir);
+        const { written, skipped } = scaffoldI18n({ i18nDir: absI18nDir });
+        if (written.length > 0) {
+            console.log('\nScaffolded i18n files:');
+            for (const f of written)
+                console.log(`  + src/lib/i18n/${f}`);
+        }
+        if (skipped.length > 0) {
+            // Files that already exist are left untouched to avoid overwriting customizations
+            console.log('\nSkipped (already exist):');
+            for (const f of skipped)
+                console.log(`  ~ src/lib/i18n/${f}`);
+        }
+        console.log('\nNext steps:');
+        console.log('  1. Install peer deps: pnpm add i18next react-i18next i18next-resources-to-backend');
+        console.log('  2. Add to next.config.ts:');
+        console.log('');
+        console.log("     import { PHASE_DEVELOPMENT_SERVER, PHASE_PRODUCTION_BUILD } from 'next/constants';");
+        console.log("     import { syncTranslations, pullTranslations, watchTranslations } from '@translation-cms/sync/api';");
+        console.log('');
+        console.log('     export default async function config(phase) {');
+        console.log('       if (phase === PHASE_DEVELOPMENT_SERVER) {');
+        console.log("         await syncTranslations({ projectRoot: '.' });");
+        console.log("         await pullTranslations({ projectRoot: '.' });");
+        console.log("         watchTranslations({ projectRoot: '.' }); // auto-pull on publish");
+        console.log('       }');
+        console.log('       if (phase === PHASE_PRODUCTION_BUILD) {');
+        console.log("         await syncTranslations({ projectRoot: '.' });");
+        console.log("         await pullTranslations({ projectRoot: '.' });");
+        console.log('       }');
+        console.log('       return { /* your next.js config */ };');
+        console.log('     }');
+        console.log('');
+        console.log('  3. Pull translations: sync-translations pull');
+        console.log('  4. Wrap your root layout with <TranslationProvider locale={locale}>');
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/pull.d.ts

@@ -0,0 +1,10 @@
+import type { Config, TranslationsConfig } from '../config/resolve-config.js';
+/**
+ * `pull` command — fetches published translations from the CMS and writes
+ * them as JSON dictionary files to the output directory.
+ *
+ * Resolution order for each option:
+ *   CLI flag  >  .translationsrc.json  >  built-in default
+ */
+export declare function runPull(root: string, config: Config, fileConfig: TranslationsConfig, args: string[]): Promise<void>;
+//# sourceMappingURL=pull.d.ts.map

package/dist/commands/pull.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull.d.ts","sourceRoot":"","sources":["../../src/commands/pull.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAG7E;;;;;;GAMG;AACH,wBAAsB,OAAO,CACzB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,kBAAkB,EAC9B,IAAI,EAAE,MAAM,EAAE,GACf,OAAO,CAAC,IAAI,CAAC,CAiBf"}

package/dist/commands/pull.js

@@ -0,0 +1,35 @@
+import path from 'path';
+import { pullTranslations } from '../core/api.js';
+/**
+ * `pull` command — fetches published translations from the CMS and writes
+ * them as JSON dictionary files to the output directory.
+ *
+ * Resolution order for each option:
+ *   CLI flag  >  .translationsrc.json  >  built-in default
+ */
+export async function runPull(root, config, fileConfig, args) {
+    // --output overrides the config file value; fall back to public/locales
+    const outputArg = getFlag(args, '--output');
+    const outputDir = outputArg
+        ? path.resolve(root, outputArg)
+        : fileConfig.outputDir
+            ? path.resolve(root, fileConfig.outputDir)
+            : path.join(root, 'public', 'locales');
+    // --ttl overrides the config file value (already in ms)
+    const ttlArg = getFlag(args, '--ttl');
+    await pullTranslations(config, {
+        outputDir,
+        force: args.includes('--force'), // skip TTL cache check and always re-fetch
+        ttlMs: ttlArg ? parseInt(ttlArg, 10) : fileConfig.pullTtlMs,
+        env: getFlag(args, '--env'), // target a specific environment (e.g. staging)
+    });
+}
+/**
+ * Returns the value of a named CLI flag (`--flag value`),
+ * or `undefined` if the flag is absent or has no value after it.
+ */
+function getFlag(args, flag) {
+    const idx = args.indexOf(flag);
+    return idx !== -1 && args[idx + 1] ? args[idx + 1] : undefined;
+}
+//# sourceMappingURL=pull.js.map

package/dist/commands/pull.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull.js","sourceRoot":"","sources":["../../src/commands/pull.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CACzB,IAAY,EACZ,MAAc,EACd,UAA8B,EAC9B,IAAc;IAEd,wEAAwE;IACxE,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,SAAS;QACvB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC;QAC/B,CAAC,CAAC,UAAU,CAAC,SAAS;YACpB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC,SAAS,CAAC;YAC1C,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IAE7C,wDAAwD;IACxD,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACtC,MAAM,gBAAgB,CAAC,MAAM,EAAE;QAC3B,SAAS;QACT,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,2CAA2C;QAC5E,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS;QAC3D,GAAG,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,+CAA+C;KAC/E,CAAC,CAAC;AACP,CAAC;AAED;;;GAGG;AACH,SAAS,OAAO,CAAC,IAAc,EAAE,IAAY;IACzC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,OAAO,GAAG,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACnE,CAAC"}

package/dist/commands/status.d.ts

@@ -0,0 +1,15 @@
+import { type ScanOptions } from '../core/scanner.js';
+/**
+ * `status` command — scans the project for translation keys and compares
+ * the result against the last sync cache (.cms-sync-cache.json).
+ *
+ * Outputs a human-readable diff showing:
+ *   +  keys that are new since the last sync
+ *   -  keys that have been removed
+ *   ~  keys whose preview routes have changed
+ *   =  keys that are unchanged
+ *
+ * Does not write anything — safe to run at any time.
+ */
+export declare function runStatus(root: string, scanOpts: ScanOptions): void;
+//# sourceMappingURL=status.d.ts.map

package/dist/commands/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAQlE;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI,CA8DnE"}

package/dist/commands/status.js

@@ -0,0 +1,62 @@
+import { scanProject } from '../core/scanner.js';
+import { serializeNamespaces, loadSyncCache, computeDiff, formatPreviewRoutes, } from '../core/cache.js';
+/**
+ * `status` command — scans the project for translation keys and compares
+ * the result against the last sync cache (.cms-sync-cache.json).
+ *
+ * Outputs a human-readable diff showing:
+ *   +  keys that are new since the last sync
+ *   -  keys that have been removed
+ *   ~  keys whose preview routes have changed
+ *   =  keys that are unchanged
+ *
+ * Does not write anything — safe to run at any time.
+ */
+export function runStatus(root, scanOpts) {
+    console.log(`Scanning project: ${root}`);
+    const namespaces = scanProject(root, scanOpts);
+    // Flatten the NamespaceMap into a plain serializable object and get the total key count
+    const { serialized, totalKeys } = serializeNamespaces(namespaces);
+    const namespaceCount = Object.keys(serialized).length;
+    console.log(`\nFound ${totalKeys} key(s) across ${namespaceCount} namespace(s): ${Object.keys(serialized).join(', ')}`);
+    // Load the baseline written by the last successful sync
+    const cached = loadSyncCache(root);
+    if (!cached) {
+        console.log('\nNo sync cache found (.cms-sync-cache.json). Run sync first to establish a baseline.');
+        return;
+    }
+    // Diff current scan against the cached snapshot
+    const diff = computeDiff(serialized, cached);
+    console.log('\nStatus vs last sync:');
+    console.log(`  + ${diff.added.length} new key(s)`);
+    console.log(`  - ${diff.removed.length} removed key(s)`);
+    console.log(`  ~ ${diff.routesChanged.length} route update(s)`);
+    console.log(`  = ${diff.unchanged} unchanged`);
+    if (diff.added.length > 0) {
+        console.log('\nNew keys:');
+        for (const { namespace, key, routes } of diff.added) {
+            console.log(`  + ${namespace}:${key}  (${formatPreviewRoutes(routes)})`);
+        }
+    }
+    if (diff.removed.length > 0) {
+        console.log('\nRemoved keys:');
+        for (const { namespace, key } of diff.removed) {
+            console.log(`  - ${namespace}:${key}`);
+        }
+    }
+    if (diff.routesChanged.length > 0) {
+        console.log('\nRoute updates:');
+        for (const { namespace, key, before, after } of diff.routesChanged) {
+            console.log(`  ~ ${namespace}:${key}  [${formatPreviewRoutes(before)}] -> [${formatPreviewRoutes(after)}]`);
+        }
+    }
+    // Only prompt to sync if there are actual changes
+    const total = diff.added.length + diff.removed.length + diff.routesChanged.length;
+    if (total > 0) {
+        console.log('\nRun "sync-translations sync" to push these changes.');
+    }
+    else {
+        console.log('\nEverything is in sync.');
+    }
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

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

package/dist/commands/sync.d.ts

@@ -0,0 +1,24 @@
+import type { Config } from '../config/resolve-config.js';
+import { type ScanOptions } from '../core/scanner.js';
+export interface SyncCommandOptions {
+    outputDir: string;
+    dryRun: boolean;
+    force: boolean;
+    reportPath?: string;
+    /** Path (relative to root) for the generated mock-params TS file. */
+    mockDataPath?: string;
+    /** User-configured route params from config file (merged into mock data). */
+    userRouteParams?: Record<string, Record<string, string>>;
+}
+/**
+ * `sync` command — the main push/pull cycle:
+ *
+ *  1. Scan the project for translation keys and their preview routes.
+ *  2. Auto-generate mock route params for any dynamic routes (e.g. /[slug]).
+ *     If a mockDataPath is configured, write a TS file with the merged params
+ *     so the CMS can render live previews.
+ *  3. POST the discovered keys to the CMS (dry-run: report only, no writes).
+ *  4. Pull the latest published translations back to disk (skipped on dry-run).
+ */
+export declare function runSync(root: string, config: Config, scanOpts: ScanOptions, opts: SyncCommandOptions): Promise<void>;
+//# sourceMappingURL=sync.d.ts.map

package/dist/commands/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/commands/sync.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAe,KAAK,WAAW,EAAY,MAAM,mBAAmB,CAAC;AAQ5E,MAAM,WAAW,kBAAkB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6EAA6E;IAC7E,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC5D;AAED;;;;;;;;;GASG;AACH,wBAAsB,OAAO,CACzB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,WAAW,EACrB,IAAI,EAAE,kBAAkB,GACzB,OAAO,CAAC,IAAI,CAAC,CA2Df"}

package/dist/commands/sync.js

@@ -0,0 +1,131 @@
+import fs from 'fs';
+import path from 'path';
+import { scanProject, routeKey } from '../core/scanner.js';
+import { postToSync, pullTranslations } from '../core/api.js';
+import { generateRouteParams, saveRouteParamsCache, writeMockDataFile, } from '../core/cache.js';
+/**
+ * `sync` command — the main push/pull cycle:
+ *
+ *  1. Scan the project for translation keys and their preview routes.
+ *  2. Auto-generate mock route params for any dynamic routes (e.g. /[slug]).
+ *     If a mockDataPath is configured, write a TS file with the merged params
+ *     so the CMS can render live previews.
+ *  3. POST the discovered keys to the CMS (dry-run: report only, no writes).
+ *  4. Pull the latest published translations back to disk (skipped on dry-run).
+ */
+export async function runSync(root, config, scanOpts, opts) {
+    console.log(`Scanning project: ${root}`);
+    const namespaces = scanProject(root, scanOpts);
+    // Collect every unique route string found across all keys so we can
+    // generate placeholder params for dynamic segments (e.g. [slug], [id]).
+    const detectedRoutes = new Set();
+    for (const keyMap of Object.values(namespaces)) {
+        for (const routes of keyMap.values()) {
+            for (const route of routes) {
+                // routeKey normalises PreviewRoute objects to plain strings
+                const routeStr = routeKey(route);
+                detectedRoutes.add(routeStr);
+            }
+        }
+    }
+    if (detectedRoutes.size > 0) {
+        const autoParams = generateRouteParams(Array.from(detectedRoutes));
+        if (Object.keys(autoParams).length > 0) {
+            // Persist the auto-generated params to cache so subsequent scans
+            // can reuse them without re-deriving them from scratch
+            saveRouteParamsCache(root, autoParams);
+            console.log(`[route-params] Auto-generated params for ${Object.keys(autoParams).length} dynamic routes`);
+            if (opts.mockDataPath) {
+                // Merge auto-generated with user-configured params (user wins on conflict)
+                const merged = {
+                    ...autoParams,
+                    ...(opts.userRouteParams ?? {}),
+                };
+                writeMockDataFile(root, merged, opts.mockDataPath);
+            }
+        }
+    }
+    // Read local translation values from JSON files to bootstrap drafts in CMS.
+    // Keys that already have a draft in the CMS are never overwritten.
+    const localValues = readLocalValues(opts.outputDir);
+    // Push discovered keys to the CMS; dry-run mode only prints a report
+    await postToSync(config, namespaces, {
+        root,
+        force: opts.force,
+        dryRun: opts.dryRun,
+        reportPath: opts.reportPath,
+        localValues,
+    });
+    // Pull translations back to disk after a successful push.
+    // Skip when dry-running — there's nothing new to pull yet.
+    if (!opts.dryRun) {
+        await pullTranslations(config, {
+            outputDir: opts.outputDir,
+            force: opts.force,
+        });
+    }
+}
+/**
+ * Flatten a nested object to dot-notation keys.
+ * e.g. { button: { save: "Save" } } → { "button.save": "Save" }
+ */
+function flattenObject(obj, prefix = '') {
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        const fullKey = prefix ? `${prefix}.${key}` : key;
+        if (typeof value === 'string') {
+            result[fullKey] = value;
+        }
+        else if (typeof value === 'object' && value !== null) {
+            Object.assign(result, flattenObject(value, fullKey));
+        }
+    }
+    return result;
+}
+/**
+ * Read all `{locale}.json` files from outputDir and return a nested map:
+ * namespace → translationKey → locale → value
+ *
+ * Local JSON files use the nested format written by `pull`:
+ * { namespace: { "dot.notation.key": "value" } }
+ */
+function readLocalValues(outputDir) {
+    const result = {};
+    if (!fs.existsSync(outputDir))
+        return result;
+    let files;
+    try {
+        files = fs
+            .readdirSync(outputDir)
+            .filter(f => f.endsWith('.json') && f !== '.last-pulled');
+    }
+    catch {
+        return result;
+    }
+    for (const file of files) {
+        const locale = file.replace('.json', '');
+        try {
+            const raw = fs.readFileSync(path.join(outputDir, file), 'utf-8');
+            const content = JSON.parse(raw);
+            for (const [namespace, keys] of Object.entries(content)) {
+                if (typeof keys !== 'object' || keys === null)
+                    continue;
+                const flat = flattenObject(keys);
+                if (!result[namespace])
+                    result[namespace] = {};
+                for (const [key, value] of Object.entries(flat)) {
+                    if (!value.trim())
+                        continue;
+                    if (!result[namespace][key])
+                        result[namespace][key] = {};
+                    result[namespace][key][locale] = value;
+                }
+            }
+        }
+        catch {
+            // Skip malformed files silently
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=sync.js.map

package/dist/commands/sync.js.map

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

package/dist/commands/watch.d.ts

@@ -0,0 +1,18 @@
+import type { Config } from '../config/resolve-config.js';
+import { type ScanOptions } from '../core/scanner.js';
+/**
+ * `watch` command — runs a full sync on startup, then re-syncs automatically
+ * whenever a source file changes.
+ *
+ * Flow on each change:
+ *   1. Debounce 500 ms to coalesce rapid saves (e.g. editor auto-format).
+ *   2. Scan the project for translation keys.
+ *   3. POST discovered keys to the CMS (force — bypass TTL cache).
+ *   4. Pull the latest translations back to disk (force).
+ *
+ * Concurrent syncs are prevented by the `running` guard — if a sync is
+ * already in progress when a new change fires, the new event is dropped.
+ * Ctrl+C closes the watcher cleanly before exiting.
+ */
+export declare function runWatch(root: string, config: Config, outputDir: string, scanOpts: ScanOptions): Promise<void>;
+//# sourceMappingURL=watch.d.ts.map

package/dist/commands/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../src/commands/watch.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGlE;;;;;;;;;;;;;GAaG;AACH,wBAAsB,QAAQ,CAC1B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,WAAW,GACtB,OAAO,CAAC,IAAI,CAAC,CA0Df"}

package/dist/commands/watch.js

@@ -0,0 +1,71 @@
+import path from 'path';
+import fs from 'fs';
+import { scanProject } from '../core/scanner.js';
+import { postToSync, pullTranslations } from '../core/api.js';
+/**
+ * `watch` command — runs a full sync on startup, then re-syncs automatically
+ * whenever a source file changes.
+ *
+ * Flow on each change:
+ *   1. Debounce 500 ms to coalesce rapid saves (e.g. editor auto-format).
+ *   2. Scan the project for translation keys.
+ *   3. POST discovered keys to the CMS (force — bypass TTL cache).
+ *   4. Pull the latest translations back to disk (force).
+ *
+ * Concurrent syncs are prevented by the `running` guard — if a sync is
+ * already in progress when a new change fires, the new event is dropped.
+ * Ctrl+C closes the watcher cleanly before exiting.
+ */
+export async function runWatch(root, config, outputDir, scanOpts) {
+    console.log(`[watch] Watching ${root} for changes...`);
+    console.log('[watch] Press Ctrl+C to stop.\n');
+    // Only react to source files — ignore CSS, JSON, lock files, etc.
+    const sourceExtensions = new Set(scanOpts.sourceExtensions ?? ['.ts', '.tsx', '.js', '.jsx']);
+    let debounce = null;
+    // Prevents overlapping syncs if a change fires while a sync is still running
+    let running = false;
+    const runSync = async () => {
+        if (running)
+            return;
+        running = true;
+        try {
+            const namespaces = scanProject(root, scanOpts);
+            // force: true bypasses the TTL cache so changes are always pushed/pulled
+            await postToSync(config, namespaces, { root, force: true });
+            await pullTranslations(config, { outputDir, force: true });
+        }
+        catch (err) {
+            // Log errors without crashing the watcher process
+            console.error('[watch] Sync error:', err instanceof Error ? err.message : String(err));
+        }
+        finally {
+            running = false;
+        }
+    };
+    // Run an initial sync so the local dictionaries are up-to-date before watching
+    await runSync();
+    // fs.watch with recursive:true covers the entire tree in one watcher instance
+    const watcher = fs.watch(root, { recursive: true }, (_evt, filename) => {
+        if (!filename)
+            return;
+        const ext = path.extname(filename);
+        if (!sourceExtensions.has(ext))
+            return;
+        // Coalesce rapid saves within 500 ms into a single sync run
+        if (debounce)
+            clearTimeout(debounce);
+        debounce = setTimeout(() => {
+            console.log(`[watch] Change detected: ${filename}`);
+            void runSync();
+        }, 500);
+    });
+    // Clean up the watcher before exiting on Ctrl+C
+    process.on('SIGINT', () => {
+        watcher.close();
+        console.log('\n[watch] Stopped.');
+        process.exit(0);
+    });
+    // Hold the event loop open indefinitely — the watcher keeps us alive until SIGINT
+    await new Promise(() => undefined);
+}
+//# sourceMappingURL=watch.js.map

package/dist/commands/watch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.js","sourceRoot":"","sources":["../../src/commands/watch.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB,OAAO,EAAE,WAAW,EAAoB,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAE7D;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC1B,IAAY,EACZ,MAAc,EACd,SAAiB,EACjB,QAAqB;IAErB,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,iBAAiB,CAAC,CAAC;IACvD,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;IAE/C,kEAAkE;IAClE,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAC5B,QAAQ,CAAC,gBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAC9D,CAAC;IAEF,IAAI,QAAQ,GAAyC,IAAI,CAAC;IAC1D,6EAA6E;IAC7E,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,MAAM,OAAO,GAAG,KAAK,IAAmB,EAAE;QACtC,IAAI,OAAO;YAAE,OAAO;QACpB,OAAO,GAAG,IAAI,CAAC;QACf,IAAI,CAAC;YACD,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YAC/C,yEAAyE;YACzE,MAAM,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5D,MAAM,gBAAgB,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,kDAAkD;YAClD,OAAO,CAAC,KAAK,CACT,qBAAqB,EACrB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CACnD,CAAC;QACN,CAAC;gBAAS,CAAC;YACP,OAAO,GAAG,KAAK,CAAC;QACpB,CAAC;IACL,CAAC,CAAC;IAEF,+EAA+E;IAC/E,MAAM,OAAO,EAAE,CAAC;IAEhB,8EAA8E;IAC9E,MAAM,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE;QACnE,IAAI,CAAC,QAAQ;YAAE,OAAO;QACtB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACnC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO;QAEvC,4DAA4D;QAC5D,IAAI,QAAQ;YAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;QACrC,QAAQ,GAAG,UAAU,CAAC,GAAG,EAAE;YACvB,OAAO,CAAC,GAAG,CAAC,4BAA4B,QAAQ,EAAE,CAAC,CAAC;YACpD,KAAK,OAAO,EAAE,CAAC;QACnB,CAAC,EAAE,GAAG,CAAC,CAAC;IACZ,CAAC,CAAC,CAAC;IAEH,gDAAgD;IAChD,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;QACtB,OAAO,CAAC,KAAK,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC,CAAC,CAAC;IAEH,kFAAkF;IAClF,MAAM,IAAI,OAAO,CAAQ,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;AAC9C,CAAC"}

package/dist/config/config-internals/args.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Parses CLI arguments that override resolved config values.
+ */
+import type { Config } from './types.js';
+/**
+ * Scan process.argv for --project-id, --api-key, and --cms-url flags.
+ * Returns only the fields that were explicitly provided — missing flags are
+ * omitted so they can be overridden by lower-priority sources (env vars, file).
+ */
+export declare function parseArgs(): Partial<Config>;
+//# sourceMappingURL=args.d.ts.map

package/dist/config/config-internals/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../../src/config/config-internals/args.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAU3C"}

package/dist/config/config-internals/args.js

@@ -0,0 +1,22 @@
+/**
+ * Parses CLI arguments that override resolved config values.
+ */
+/**
+ * Scan process.argv for --project-id, --api-key, and --cms-url flags.
+ * Returns only the fields that were explicitly provided — missing flags are
+ * omitted so they can be overridden by lower-priority sources (env vars, file).
+ */
+export function parseArgs() {
+    const args = process.argv.slice(2);
+    const result = {};
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === '--project-id' && args[i + 1])
+            result.projectId = args[++i];
+        if (args[i] === '--api-key' && args[i + 1])
+            result.apiKey = args[++i];
+        if (args[i] === '--cms-url' && args[i + 1])
+            result.cmsUrl = args[++i];
+    }
+    return result;
+}
+//# sourceMappingURL=args.js.map

package/dist/config/config-internals/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../../../src/config/config-internals/args.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;GAIG;AACH,MAAM,UAAU,SAAS;IACrB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,MAAM,GAAoB,EAAE,CAAC;IACnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,cAAc,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YACzC,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QACjC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,WAAW,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YAAE,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QACtE,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,WAAW,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YAAE,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/config/config-internals/env.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Reads .env.local files and parses them into a key/value map.
+ */
+/**
+ * Parse a .env.local file at the given root into a plain key/value map.
+ * Skips blank lines and comments. Strips surrounding quotes from values.
+ * Returns an empty object when the file does not exist — never throws.
+ */
+export declare function loadEnvLocal(root: string): Record<string, string>;
+//# sourceMappingURL=env.d.ts.map

package/dist/config/config-internals/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../src/config/config-internals/env.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAqBjE"}

package/dist/config/config-internals/env.js

@@ -0,0 +1,35 @@
+/**
+ * Reads .env.local files and parses them into a key/value map.
+ */
+import fs from 'fs';
+import path from 'path';
+/**
+ * Parse a .env.local file at the given root into a plain key/value map.
+ * Skips blank lines and comments. Strips surrounding quotes from values.
+ * Returns an empty object when the file does not exist — never throws.
+ */
+export function loadEnvLocal(root) {
+    const envPath = path.join(root, '.env.local');
+    if (!fs.existsSync(envPath))
+        return {};
+    const vars = {};
+    const lines = fs.readFileSync(envPath, 'utf-8').split('\n');
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Skip blank lines and comments
+        if (!trimmed || trimmed.startsWith('#'))
+            continue;
+        const eq = trimmed.indexOf('=');
+        if (eq === -1)
+            continue;
+        const key = trimmed.slice(0, eq).trim();
+        // Strip surrounding single or double quotes from the value
+        const value = trimmed
+            .slice(eq + 1)
+            .trim()
+            .replace(/^["']|["']$/g, '');
+        vars[key] = value;
+    }
+    return vars;
+}
+//# sourceMappingURL=env.js.map

package/dist/config/config-internals/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../../src/config/config-internals/env.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACrC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAC9C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC;IAEvC,MAAM,IAAI,GAA2B,EAAE,CAAC;IACxC,MAAM,KAAK,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,gCAAgC;QAChC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAClD,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,EAAE,KAAK,CAAC,CAAC;YAAE,SAAS;QACxB,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACxC,2DAA2D;QAC3D,MAAM,KAAK,GAAG,OAAO;aAChB,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC;aACb,IAAI,EAAE;aACN,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;QACjC,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACtB,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC"}