@translation-cms/sync 1.2.1 → 1.2.4

package/dist/core/api-internals/pull.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull.d.ts","sourceRoot":"","sources":["../../../src/core/api-internals/pull.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAuC9C;;;GAGG;AACH,wBAAsB,gBAAgB,CAClC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,WAAW,GAClB,OAAO,CAAC,IAAI,CAAC,CAgHf"}

package/dist/core/api-internals/pull.js

@@ -0,0 +1,124 @@
+/**
+ * Pull (fetch) published translations from CMS to local JSON files.
+ */
+import fs from 'fs';
+import path from 'path';
+import { getLastPulledTime, saveLastPulledTime, PULL_META_FILE, DEFAULT_PULL_TTL_MS, } from '../cache.js';
+/**
+ * Converts a flat `{ "namespace:key": value }` object into
+ * `{ namespace: { key: value } }`, with dot-notation key support.
+ */
+function nestTranslationKeys(flat) {
+    const nested = {};
+    for (const [key, value] of Object.entries(flat)) {
+        const colon = key.indexOf(':');
+        if (colon === -1)
+            continue;
+        const ns = key.slice(0, colon);
+        const k = key.slice(colon + 1);
+        if (!nested[ns])
+            nested[ns] = {};
+        const parts = k.split('.');
+        let current = nested[ns];
+        for (let i = 0; i < parts.length - 1; i++) {
+            const part = parts[i];
+            if (part && !current[part])
+                current[part] = {};
+            if (part)
+                current = current[part];
+        }
+        const lastPart = parts[parts.length - 1];
+        if (lastPart)
+            current[lastPart] = value;
+    }
+    return nested;
+}
+/**
+ * Fetch published translations from the CMS and write them to local JSON files.
+ * Supports caching with TTL and force refresh.
+ */
+export async function pullTranslations(config, opts) {
+    const ttl = opts.ttlMs ?? DEFAULT_PULL_TTL_MS;
+    console.log(`[CMS] Checking for ${PULL_META_FILE}...`);
+    if (!opts.force) {
+        const lastPulled = getLastPulledTime(opts.outputDir);
+        if (lastPulled !== null) {
+            const age = Date.now() - lastPulled;
+            const ageS = Math.round(age / 1000);
+            const ttlS = Math.round(ttl / 1000);
+            console.log(`[CMS] ${PULL_META_FILE} found: ${new Date(lastPulled).toISOString()}`);
+            if (age < ttl) {
+                console.log(`[CMS] ✓ Translations fresh (age: ${ageS}s < TTL: ${ttlS}s) — using local files`);
+                return;
+            }
+            console.log(`[CMS] ⟳ Translations stale (age: ${ageS}s ≥ TTL: ${ttlS}s) — refreshing...`);
+        }
+        else {
+            console.log(`[CMS] ${PULL_META_FILE} not found, will refresh`);
+        }
+    }
+    else {
+        console.log(`[CMS] --force flag detected, refreshing...`);
+    }
+    let url = `${config.cmsUrl.replace(/\/$/, '')}/api/translations/${config.projectId}`;
+    if (opts.env) {
+        url += `?env=${encodeURIComponent(opts.env)}`;
+        console.log(`[CMS] Environment: ${opts.env}`);
+    }
+    console.log(`[CMS] Fetching from: ${url}`);
+    const response = await fetch(url, {
+        headers: { 'x-api-key': config.apiKey },
+    });
+    if (!response.ok) {
+        console.error(`[CMS] ✗ Pull failed: ${response.status} ${response.statusText}`);
+        process.exit(1);
+    }
+    const data = (await response.json());
+    const processed = {};
+    for (const [locale, content] of Object.entries(data)) {
+        if (typeof content !== 'object' || content === null)
+            continue;
+        const obj = content;
+        const firstVal = Object.values(obj)[0];
+        processed[locale] =
+            typeof firstVal === 'string'
+                ? nestTranslationKeys(obj)
+                : obj;
+    }
+    fs.mkdirSync(opts.outputDir, { recursive: true });
+    const writtenFiles = new Set();
+    let fileCount = 0;
+    // Write one file per locale: {outputDir}/{locale}.json
+    // Structure: { namespace: { key: value } }
+    // Compatible with i18next-resources-to-backend
+    for (const [locale, namespaces] of Object.entries(processed)) {
+        const filePath = path.join(opts.outputDir, `${locale}.json`);
+        fs.writeFileSync(filePath, JSON.stringify(namespaces, null, 2), 'utf-8');
+        writtenFiles.add(filePath);
+        fileCount++;
+    }
+    // Empty locale files that no longer exist in CMS (don't delete — static imports would break)
+    let emptied = 0;
+    for (const entry of fs.readdirSync(opts.outputDir, {
+        withFileTypes: true,
+    })) {
+        if (entry.name === PULL_META_FILE)
+            continue;
+        if (!entry.isFile() || !entry.name.endsWith('.json'))
+            continue;
+        const filePath = path.join(opts.outputDir, entry.name);
+        if (!writtenFiles.has(filePath)) {
+            fs.writeFileSync(filePath, '{}\n', 'utf-8');
+            console.log(`[CMS] ○  Emptied: ${entry.name} (no data in CMS)`);
+            emptied++;
+        }
+    }
+    saveLastPulledTime(opts.outputDir);
+    if (emptied > 0) {
+        console.log(`[CMS] ✓ Refresh complete: wrote ${fileCount} files, emptied ${emptied} stale files`);
+    }
+    else {
+        console.log(`[CMS] ✓ Refresh complete: wrote ${fileCount} JSON files, updated ${PULL_META_FILE}`);
+    }
+}
+//# sourceMappingURL=pull.js.map

package/dist/core/api-internals/pull.js.map

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

package/dist/core/api-internals/route-config.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Fetch preview route configuration from CMS.
+ */
+import type { Config } from '../../config/resolve-config.js';
+/**
+ * Fetches the project's preview route config from the CMS and returns it as
+ * a routeParams Record (route pattern → params), ready to pass to scanProject.
+ *
+ * Returns an empty object when the CMS doesn't have any routes configured or
+ * when the request fails (non-fatal — a warning is printed instead).
+ */
+export declare function fetchRouteParams(config: Config): Promise<Record<string, Record<string, string>>>;
+//# sourceMappingURL=route-config.d.ts.map

package/dist/core/api-internals/route-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-config.d.ts","sourceRoot":"","sources":["../../../src/core/api-internals/route-config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAC;AAE7D;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAClC,MAAM,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CA8BjD"}

package/dist/core/api-internals/route-config.js

@@ -0,0 +1,34 @@
+/**
+ * Fetch preview route configuration from CMS.
+ */
+/**
+ * Fetches the project's preview route config from the CMS and returns it as
+ * a routeParams Record (route pattern → params), ready to pass to scanProject.
+ *
+ * Returns an empty object when the CMS doesn't have any routes configured or
+ * when the request fails (non-fatal — a warning is printed instead).
+ */
+export async function fetchRouteParams(config) {
+    const url = `${config.cmsUrl.replace(/\/$/, '')}/api/sync/${config.projectId}`;
+    try {
+        const response = await fetch(url, {
+            headers: { 'x-api-key': config.apiKey },
+        });
+        if (!response.ok) {
+            console.warn(`[CMS] Could not fetch route config (${response.status}) — using local routeParams only`);
+            return {};
+        }
+        const data = (await response.json());
+        const routeParams = data.routeParams ?? {};
+        const count = Object.keys(routeParams).length;
+        if (count > 0) {
+            console.log(`[CMS] Loaded ${count} preview route(s) from CMS config`);
+        }
+        return routeParams;
+    }
+    catch (err) {
+        console.warn(`[CMS] Could not fetch route config — using local routeParams only:`, err instanceof Error ? err.message : String(err));
+        return {};
+    }
+}
+//# sourceMappingURL=route-config.js.map

package/dist/core/api-internals/route-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-config.js","sourceRoot":"","sources":["../../../src/core/api-internals/route-config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAClC,MAAc;IAEd,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,MAAM,CAAC,SAAS,EAAE,CAAC;IAC/E,IAAI,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC9B,OAAO,EAAE,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE;SAC1C,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CACR,uCAAuC,QAAQ,CAAC,MAAM,kCAAkC,CAC3F,CAAC;YACF,OAAO,EAAE,CAAC;QACd,CAAC;QACD,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAElC,CAAC;QACF,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC;QAC9C,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACZ,OAAO,CAAC,GAAG,CACP,gBAAgB,KAAK,mCAAmC,CAC3D,CAAC;QACN,CAAC;QACD,OAAO,WAAW,CAAC;IACvB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,OAAO,CAAC,IAAI,CACR,oEAAoE,EACpE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CACnD,CAAC;QACF,OAAO,EAAE,CAAC;IACd,CAAC;AACL,CAAC"}

package/dist/core/api-internals/sync.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Sync (push) translation keys to CMS.
+ */
+import type { Config } from '../../config/resolve-config.js';
+import type { NamespaceMap } from '../scanner.js';
+import type { PostToSyncOptions } from './types.js';
+/**
+ * Push translation keys to the CMS for syncing.
+ * Optionally supports dry-run mode and report generation.
+ */
+export declare function postToSync(config: Config, namespaces: NamespaceMap, opts?: PostToSyncOptions): Promise<void>;
+//# sourceMappingURL=sync.d.ts.map

package/dist/core/api-internals/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../src/core/api-internals/sync.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAgB,MAAM,YAAY,CAAC;AAalE;;;GAGG;AACH,wBAAsB,UAAU,CAC5B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,YAAY,EACxB,IAAI,GAAE,iBAA2C,GAClD,OAAO,CAAC,IAAI,CAAC,CA+Hf"}

package/dist/core/api-internals/sync.js

@@ -0,0 +1,95 @@
+/**
+ * Sync (push) translation keys to CMS.
+ */
+import { loadSyncCache, saveSyncCache, isSyncNeeded, computeDiff, writeReport, serializeNamespaces, formatPreviewRoutes, } from '../cache.js';
+import { resolveReportPath } from './helpers.js';
+/**
+ * Push translation keys to the CMS for syncing.
+ * Optionally supports dry-run mode and report generation.
+ */
+export async function postToSync(config, namespaces, opts = { root: process.cwd() }) {
+    const { serialized, totalKeys } = serializeNamespaces(namespaces);
+    const namespaceCount = Object.keys(serialized).length;
+    console.log(`Found ${totalKeys} key(s) across ${namespaceCount} namespace(s): ${Object.keys(serialized).join(', ')}`);
+    if (totalKeys === 0) {
+        console.log('Nothing to sync.');
+        return;
+    }
+    const cached = loadSyncCache(opts.root);
+    // ---- Dry-run: print diff and return without posting --------------------
+    if (opts.dryRun) {
+        const diff = computeDiff(serialized, cached);
+        console.log('\n[dry-run] Would sync to CMS (not actually posting):');
+        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)}]`);
+            }
+        }
+        if (opts.reportPath) {
+            writeReport(resolveReportPath(opts.root, opts.reportPath), serialized, diff);
+        }
+        return;
+    }
+    // ---- Skip if no changes ------------------------------------------------
+    if (!opts.force && !isSyncNeeded(serialized, cached)) {
+        console.log('No changes detected — skipping sync. Use --force to override.');
+        if (opts.reportPath) {
+            writeReport(resolveReportPath(opts.root, opts.reportPath), serialized);
+        }
+        return;
+    }
+    // ---- Post to CMS -------------------------------------------------------
+    const url = `${config.cmsUrl.replace(/\/$/, '')}/api/sync/${config.projectId}`;
+    console.log(`Posting to ${url}...`);
+    const response = await fetch(url, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'x-api-key': config.apiKey,
+        },
+        body: JSON.stringify({ namespaces: serialized }),
+    });
+    const contentType = response.headers.get('content-type') ?? '';
+    const isJson = contentType.includes('application/json');
+    if (!response.ok) {
+        console.error(`Sync failed: ${response.status} ${response.statusText}`);
+        if (!isJson) {
+            console.error(`The CMS returned HTML instead of JSON. Is the sync endpoint available at ${url}?`);
+        }
+        else {
+            console.error(JSON.stringify(await response.json()));
+        }
+        process.exit(1);
+    }
+    if (!isJson) {
+        console.error(`The CMS returned HTML instead of JSON. Is the sync endpoint available at ${url}?`);
+        process.exit(1);
+    }
+    const data = (await response.json());
+    console.log(`Synced: ${data.created} created, ${data.updated ?? 0} routes updated, ${data.existing} existing`);
+    if (data.message)
+        console.log(data.message);
+    saveSyncCache(opts.root, serialized);
+    if (opts.reportPath) {
+        const diff = computeDiff(serialized, cached);
+        writeReport(resolveReportPath(opts.root, opts.reportPath), serialized, diff);
+    }
+}
+//# sourceMappingURL=sync.js.map

package/dist/core/api-internals/sync.js.map

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

package/dist/core/api-internals/types.d.ts

@@ -0,0 +1,25 @@
+/**
+ * TypeScript types for sync API.
+ */
+export interface SyncResponse {
+    created: number;
+    updated?: number;
+    existing: number;
+    message?: string;
+}
+export interface PostToSyncOptions {
+    root: string;
+    force?: boolean;
+    /** Preview what would be synced without posting to the CMS. */
+    dryRun?: boolean;
+    /** Write a JSON scan report to this file path. */
+    reportPath?: string;
+}
+export interface PullOptions {
+    outputDir: string;
+    force?: boolean;
+    ttlMs?: number;
+    /** Pull from a specific environment (e.g. "staging"). */
+    env?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/api-internals/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/api-internals/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,YAAY;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/core/api-internals/types.js

@@ -0,0 +1,5 @@
+/**
+ * TypeScript types for sync API.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/api-internals/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/api-internals/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/core/api.d.ts

@@ -0,0 +1,11 @@
+/**
+ * CMS Sync API — Orchestrator
+ *
+ * Coordinates pushing translation keys to the CMS and pulling published
+ * translations back to local JSON files.
+ */
+export type { SyncResponse, PostToSyncOptions, PullOptions, } from './api-internals/types.js';
+export { fetchRouteParams } from './api-internals/route-config.js';
+export { postToSync } from './api-internals/sync.js';
+export { pullTranslations } from './api-internals/pull.js';
+//# sourceMappingURL=api.d.ts.map

package/dist/core/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/core/api.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACR,YAAY,EACZ,iBAAiB,EACjB,WAAW,GACd,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/core/api.js

@@ -0,0 +1,11 @@
+/**
+ * CMS Sync API — Orchestrator
+ *
+ * Coordinates pushing translation keys to the CMS and pulling published
+ * translations back to local JSON files.
+ */
+// Re-export public functions
+export { fetchRouteParams } from './api-internals/route-config.js';
+export { postToSync } from './api-internals/sync.js';
+export { pullTranslations } from './api-internals/pull.js';
+//# sourceMappingURL=api.js.map

package/dist/core/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/core/api.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,6BAA6B;AAC7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/{sync.d.ts → core/cache.d.ts}

@@ -1,15 +1,8 @@
-import type { Config } from './resolve-config.js';
 import type { NamespaceMap, PreviewRoute } from './scanner.js';
 export type SerializedNamespaces = Record<string, Array<{
     key: string;
     previewRoutes: PreviewRoute[];
 }>>;
-export interface SyncResponse {
-    created: number;
-    updated?: number;
-    existing: number;
-    message?: string;
-}
 export interface SyncDiff {
     added: Array<{
         namespace: string;
@@ -28,21 +21,6 @@ export interface SyncDiff {
     }>;
     unchanged: number;
 }
-export interface PullOptions {
-    outputDir: string;
-    force?: boolean;
-    ttlMs?: number;
-    /** Pull from a specific environment (e.g. "staging"). Requires CMS support. */
-    env?: string;
-}
-export interface PostToSyncOptions {
-    root: string;
-    force?: boolean;
-    /** Preview what would be synced without posting to the CMS. */
-    dryRun?: boolean;
-    /** Write a JSON scan report to this file (absolute or relative to root). */
-    reportPath?: string;
-}
 export declare function loadSyncCache(root: string): SerializedNamespaces | null;
 export declare function saveSyncCache(root: string, data: SerializedNamespaces): void;
 export declare function isSyncNeeded(current: SerializedNamespaces, cached: SerializedNamespaces | null): boolean;
@@ -52,16 +30,10 @@ export declare function serializeNamespaces(namespaces: NamespaceMap): {
     serialized: SerializedNamespaces;
     totalKeys: number;
 };
+export declare const PULL_META_FILE = ".last-pulled";
+export declare const DEFAULT_PULL_TTL_MS: number;
+export declare function getLastPulledTime(outputDir: string): number | null;
+export declare function saveLastPulledTime(outputDir: string): void;
 export declare function formatPreviewRoute(route: PreviewRoute): string;
 export declare function formatPreviewRoutes(routes: PreviewRoute[]): string;
-/**
- * Fetches the project's preview route config from the CMS and returns it as
- * a routeParams Record (route pattern → params), ready to pass to scanProject.
- *
- * Returns an empty object when the CMS doesn't have any routes configured or
- * when the request fails (non-fatal — a warning is printed instead).
- */
-export declare function fetchRouteParams(config: Config): Promise<Record<string, Record<string, string>>>;
-export declare function postToSync(config: Config, namespaces: NamespaceMap, opts?: PostToSyncOptions): Promise<void>;
-export declare function pullTranslations(config: Config, opts: PullOptions): Promise<void>;
-//# sourceMappingURL=sync.d.ts.map
+//# sourceMappingURL=cache.d.ts.map

package/dist/core/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/core/cache.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAM/D,MAAM,MAAM,oBAAoB,GAAG,MAAM,CACrC,MAAM,EACN,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,YAAY,EAAE,CAAA;CAAE,CAAC,CACxD,CAAC;AAEF,MAAM,WAAW,QAAQ;IACrB,KAAK,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,EAAE,CAAA;KAAE,CAAC,CAAC;IACzE,OAAO,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,aAAa,EAAE,KAAK,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,YAAY,EAAE,CAAC;QACvB,KAAK,EAAE,YAAY,EAAE,CAAC;KACzB,CAAC,CAAC;IACH,SAAS,EAAE,MAAM,CAAC;CACrB;AAQD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CAQvE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,IAAI,CAM5E;AAED,wBAAgB,YAAY,CACxB,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,oBAAoB,GAAG,IAAI,GACpC,OAAO,CAGT;AAMD,wBAAgB,WAAW,CACvB,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,oBAAoB,GAAG,IAAI,GACpC,QAAQ,CA6CV;AAMD,wBAAgB,WAAW,CACvB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,oBAAoB,EAChC,IAAI,CAAC,EAAE,QAAQ,GAChB,IAAI,CASN;AAMD,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,YAAY,GAAG;IAC3D,UAAU,EAAE,oBAAoB,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;CACrB,CAYA;AAMD,eAAO,MAAM,cAAc,iBAAiB,CAAC;AAC7C,eAAO,MAAM,mBAAmB,QAAgB,CAAC;AAEjD,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASlE;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAO1D;AAUD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAQ9D;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,CAGlE"}

package/dist/core/cache.js

@@ -0,0 +1,143 @@
+import fs from 'fs';
+import path from 'path';
+// ---------------------------------------------------------------------------
+// Sync cache (.cms-sync-cache.json)
+// ---------------------------------------------------------------------------
+const CACHE_FILE = '.cms-sync-cache.json';
+export function loadSyncCache(root) {
+    const p = path.join(root, CACHE_FILE);
+    if (!fs.existsSync(p))
+        return null;
+    try {
+        return JSON.parse(fs.readFileSync(p, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+export function saveSyncCache(root, data) {
+    fs.writeFileSync(path.join(root, CACHE_FILE), JSON.stringify(data, null, 2), 'utf-8');
+}
+export function isSyncNeeded(current, cached) {
+    if (!cached)
+        return true;
+    return JSON.stringify(current) !== JSON.stringify(cached);
+}
+// ---------------------------------------------------------------------------
+// Diff
+// ---------------------------------------------------------------------------
+export function computeDiff(current, cached) {
+    const added = [];
+    const removed = [];
+    const routesChanged = [];
+    let unchanged = 0;
+    for (const [ns, keys] of Object.entries(current)) {
+        for (const { key, previewRoutes } of keys) {
+            const cachedEntry = cached?.[ns]?.find(k => k.key === key);
+            if (!cachedEntry) {
+                added.push({ namespace: ns, key, routes: previewRoutes });
+            }
+            else {
+                const before = [...cachedEntry.previewRoutes]
+                    .map(routeToString)
+                    .sort()
+                    .join(',');
+                const after = [...previewRoutes]
+                    .map(routeToString)
+                    .sort()
+                    .join(',');
+                if (before !== after) {
+                    routesChanged.push({
+                        namespace: ns,
+                        key,
+                        before: cachedEntry.previewRoutes,
+                        after: previewRoutes,
+                    });
+                }
+                else {
+                    unchanged++;
+                }
+            }
+        }
+    }
+    if (cached) {
+        for (const [ns, keys] of Object.entries(cached)) {
+            for (const { key } of keys) {
+                if (!(current[ns] ?? []).some(k => k.key === key)) {
+                    removed.push({ namespace: ns, key });
+                }
+            }
+        }
+    }
+    return { added, removed, routesChanged, unchanged };
+}
+// ---------------------------------------------------------------------------
+// Report
+// ---------------------------------------------------------------------------
+export function writeReport(reportPath, namespaces, diff) {
+    const report = {
+        generatedAt: new Date().toISOString(),
+        namespaces,
+    };
+    if (diff)
+        report['diff'] = diff;
+    fs.writeFileSync(reportPath, JSON.stringify(report, null, 2), 'utf-8');
+    console.log(`[report] Written to ${reportPath}`);
+}
+// ---------------------------------------------------------------------------
+// Serialization
+// ---------------------------------------------------------------------------
+export function serializeNamespaces(namespaces) {
+    const serialized = {};
+    let totalKeys = 0;
+    for (const [ns, keyMap] of Object.entries(namespaces)) {
+        serialized[ns] = [...keyMap.entries()]
+            .map(([key, previewRoutes]) => ({ key, previewRoutes }))
+            .sort((a, b) => a.key.localeCompare(b.key));
+        totalKeys += keyMap.size;
+    }
+    return { serialized, totalKeys };
+}
+// ---------------------------------------------------------------------------
+// Pull cache (.last-pulled)
+// ---------------------------------------------------------------------------
+export const PULL_META_FILE = '.last-pulled';
+export const DEFAULT_PULL_TTL_MS = 5 * 60 * 1000; // 5 minutes
+export function getLastPulledTime(outputDir) {
+    const p = path.join(outputDir, PULL_META_FILE);
+    if (!fs.existsSync(p))
+        return null;
+    try {
+        const ts = new Date(fs.readFileSync(p, 'utf-8').trim()).getTime();
+        return isNaN(ts) ? null : ts;
+    }
+    catch {
+        return null;
+    }
+}
+export function saveLastPulledTime(outputDir) {
+    fs.mkdirSync(outputDir, { recursive: true });
+    fs.writeFileSync(path.join(outputDir, PULL_META_FILE), new Date().toISOString(), 'utf-8');
+}
+// ---------------------------------------------------------------------------
+// Format helpers
+// ---------------------------------------------------------------------------
+function routeToString(r) {
+    return typeof r === 'string' ? r : JSON.stringify(r);
+}
+export function formatPreviewRoute(route) {
+    if (typeof route === 'string')
+        return route;
+    const params = route.params
+        ? ` (${Object.entries(route.params)
+            .map(([k, v]) => `${k}=${v}`)
+            .join(', ')})`
+        : '';
+    return `${route.route}${params}`;
+}
+export function formatPreviewRoutes(routes) {
+    if (routes.length === 0)
+        return 'no route';
+    return routes.map(formatPreviewRoute).join(', ');
+}
+//# sourceMappingURL=cache.js.map

package/dist/core/cache.js.map

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

package/dist/core/scanner-internals/ast.d.ts

@@ -0,0 +1,22 @@
+/**
+ * AST parsing and traversal utilities.
+ */
+import type { AstNode } from './types.js';
+/**
+ * Walk an AST tree depth-first, calling visit() for each node.
+ */
+export declare function walk(node: unknown, visit: (node: AstNode) => void): void;
+/**
+ * Parse source code using Babel with appropriate plugins based on file extension.
+ */
+export declare function parseSource(filePath: string, source: string): unknown;
+/**
+ * Returns the string value of a StringLiteral or no-expression TemplateLiteral node.
+ */
+export declare function stringValue(node: unknown): string | null;
+/**
+ * Extracts namespace string(s) from a useTranslation/getTranslation argument.
+ * Handles both single strings and arrays of strings.
+ */
+export declare function namespacesFromArg(node: unknown): string[];
+//# sourceMappingURL=ast.d.ts.map

package/dist/core/scanner-internals/ast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast.d.ts","sourceRoot":"","sources":["../../../src/core/scanner-internals/ast.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C;;GAEG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAWxE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAUrE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAgBxD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,EAAE,CAWzD"}