@translation-cms/sync 1.2.28 → 1.2.30

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

@@ -0,0 +1,269 @@
+/**
+ * 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 '../../core/cache.js';
+/**
+ * Returns an error message string if any required config field is missing,
+ * or null when all fields are present.
+ */
+function validateConfig(config) {
+    if (!config.cmsUrl?.trim())
+        return 'cmsUrl is required';
+    if (!config.apiKey?.trim())
+        return 'apiKey is required';
+    if (!config.projectId?.trim())
+        return 'projectId is required';
+    return null;
+}
+/**
+ * Build the API URL for fetching translations.
+ * Uses the URL constructor to correctly handle base URLs with path prefixes.
+ * Appends ?env=<env> when a specific environment is requested.
+ */
+function buildFetchUrl(config, opts) {
+    try {
+        const baseUrl = new URL(config.cmsUrl);
+        baseUrl.pathname = `/api/translations/${encodeURIComponent(config.projectId)}`;
+        if (opts.env) {
+            baseUrl.searchParams.set('env', opts.env);
+        }
+        return baseUrl.toString();
+    }
+    catch (err) {
+        throw new Error(`Invalid CMS URL: ${config.cmsUrl} — ${err instanceof Error ? err.message : 'Unknown error'}`);
+    }
+}
+/**
+ * Fetch the URL with up to `maxRetries` attempts.
+ * Uses exponential backoff capped at 5 s: 0 ms, 1 s, 2 s, 4 s, 5 s, …
+ * Each attempt has a 30 s abort timeout to prevent hanging indefinitely.
+ */
+async function fetchWithRetry(url, apiKey, maxRetries = 3) {
+    let lastError = null;
+    for (let attempt = 1; attempt <= maxRetries; attempt++) {
+        try {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), 30000);
+            const response = await fetch(url, {
+                headers: { 'x-api-key': apiKey },
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                const body = await response.text().catch(() => '');
+                throw new Error(`HTTP ${response.status}: ${response.statusText}${body ? ` — ${body}` : ''}`);
+            }
+            return response;
+        }
+        catch (err) {
+            lastError = err instanceof Error ? err : new Error(String(err));
+            if (attempt < maxRetries) {
+                // Exponential backoff: 1 s, 2 s, 4 s, … capped at 5 s
+                const backoff = Math.min(1000 * Math.pow(2, attempt - 1), 5000);
+                console.log(`[CMS] ⟳ Retry ${attempt}/${maxRetries} after ${backoff}ms...`);
+                await new Promise(resolve => setTimeout(resolve, backoff));
+            }
+        }
+    }
+    throw lastError || new Error('Unknown fetch error');
+}
+/**
+ * Converts a flat `{ "namespace:key": value }` object into
+ * `{ namespace: { key: value } }`, with dot-notation key support.
+ *
+ * Keys that don't contain a colon, or have an empty namespace/key segment,
+ * are skipped to avoid creating malformed output.
+ */
+function nestTranslationKeys(flat) {
+    const nested = {};
+    for (const [key, value] of Object.entries(flat)) {
+        const colonIdx = key.indexOf(':');
+        // Skip invalid keys: no colon, empty namespace, or empty key after colon
+        if (colonIdx === -1 || colonIdx === 0 || colonIdx === key.length - 1) {
+            continue;
+        }
+        const namespace = key.slice(0, colonIdx);
+        const keyPath = key.slice(colonIdx + 1);
+        if (!nested[namespace]) {
+            nested[namespace] = {};
+        }
+        // Walk the dot-notation segments, creating intermediate objects as needed
+        const parts = keyPath.split('.');
+        const obj = nested[namespace];
+        const lastPart = parts[parts.length - 1];
+        let current = obj;
+        for (const part of parts.slice(0, -1)) {
+            if (!(part in current)) {
+                current[part] = {};
+            }
+            current = current[part];
+        }
+        current[lastPart] = value;
+    }
+    return nested;
+}
+/**
+ * Fetch published translations from the CMS and write them to local JSON files.
+ *
+ * Output format per locale: `{outputDir}/{locale}.json`
+ * Structure: `{ namespace: { key: value } }` — compatible with i18next-resources-to-backend.
+ *
+ * TTL cache: skips the network request if translations were pulled recently
+ * (configurable via opts.ttlMs). Bypassed when opts.force is true.
+ *
+ * Stale files: locale files that no longer exist in the CMS are emptied to `{}`
+ * rather than deleted, so static imports in the consuming app don't break.
+ */
+export async function pullTranslations(config, opts) {
+    const validationError = validateConfig(config);
+    if (validationError) {
+        console.error(`[CMS] ✗ Validation error: ${validationError}`);
+        process.exit(1);
+    }
+    const ttl = opts.ttlMs ?? DEFAULT_PULL_TTL_MS;
+    console.log(`[CMS] Checking for ${PULL_META_FILE}...`);
+    // TTL cache check — skip fetch if translations are still fresh
+    if (opts.force) {
+        console.log(`[CMS] --force flag detected, refreshing...`);
+    }
+    else {
+        const lastPulled = getLastPulledTime(opts.outputDir);
+        if (lastPulled === null) {
+            console.log(`[CMS] ${PULL_META_FILE} not found, will refresh`);
+        }
+        else {
+            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...`);
+        }
+    }
+    let url;
+    try {
+        url = buildFetchUrl(config, opts);
+    }
+    catch (err) {
+        console.error(`[CMS] ✗ Failed to build URL: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+    if (opts.env) {
+        console.log(`[CMS] Environment: ${opts.env}`);
+    }
+    console.log(`[CMS] Fetching from: ${url}`);
+    let response;
+    try {
+        response = await fetchWithRetry(url, config.apiKey);
+    }
+    catch (err) {
+        console.error(`[CMS] ✗ Pull failed after retries: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+    let data;
+    try {
+        data = (await response.json());
+    }
+    catch (err) {
+        console.error(`[CMS] ✗ Invalid JSON response: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+    console.log(`[CMS] API returned ${Object.keys(data).length} locale keys`);
+    // Normalise each locale's payload to `{ namespace: { key: value } }`.
+    // The API may return either the nested form directly, or a flat
+    // `{ "namespace:key": value }` form — detect by inspecting the first value.
+    const processed = {};
+    for (const [locale, content] of Object.entries(data)) {
+        if (typeof content !== 'object' || content === null) {
+            console.warn(`[CMS] ⚠ Skipping invalid locale "${locale}"`);
+            continue;
+        }
+        const obj = content;
+        if (Object.keys(obj).length === 0) {
+            console.warn(`[CMS] ⚠ Locale "${locale}" is empty`);
+            processed[locale] = {};
+            continue;
+        }
+        // If the first value is a string, the payload is flat and needs nesting
+        const firstVal = Object.values(obj)[0];
+        processed[locale] =
+            typeof firstVal === 'string'
+                ? nestTranslationKeys(obj)
+                : obj;
+    }
+    if (Object.keys(processed).length === 0) {
+        console.error(`[CMS] ✗ No valid locales received from API`);
+        console.error(`[CMS] This can happen when:\n` +
+            `  • Your sync just uploaded keys and no translations exist yet\n` +
+            `  • Your CMS project has no locales configured\n` +
+            `  • API credentials are incorrect\n\n` +
+            `Next steps:\n` +
+            `  1. Go to your CMS and add translations for the uploaded keys\n` +
+            `  2. Or verify your project ID/API key in .env.local\n` +
+            `  3. Then run: pnpm sync-translations pull`);
+        process.exit(1);
+    }
+    try {
+        fs.mkdirSync(opts.outputDir, { recursive: true });
+    }
+    catch (err) {
+        console.error(`[CMS] ✗ Failed to create output directory: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+    // Write one JSON file per locale
+    const writtenFiles = new Set();
+    let fileCount = 0;
+    for (const [locale, namespaces] of Object.entries(processed)) {
+        const filePath = path.join(opts.outputDir, `${locale}.json`);
+        try {
+            fs.writeFileSync(filePath, JSON.stringify(namespaces, null, 2), 'utf-8');
+            writtenFiles.add(filePath);
+            fileCount++;
+        }
+        catch (err) {
+            console.error(`[CMS] ✗ Failed to write ${locale}.json: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    // Empty locale files that are no longer returned by the CMS.
+    // We write `{}` instead of deleting so static imports in the consuming app
+    // don't break at build time.
+    let emptied = 0;
+    try {
+        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++;
+            }
+        }
+    }
+    catch (err) {
+        console.warn(`[CMS] ⚠ Failed to clean up stale files: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    // Update the pull timestamp so the TTL cache is valid on next run
+    try {
+        saveLastPulledTime(opts.outputDir);
+    }
+    catch (err) {
+        console.warn(`[CMS] ⚠ Failed to save cache metadata: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    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,4BAA4B,CAAC;AAEzD;;;;;;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,19 @@
+/**
+ * Sync (push) translation keys to CMS.
+ */
+import type { Config } from '../../config/resolve-config.js';
+import type { NamespaceMap } from '../../core/scanner.js';
+import type { PostToSyncOptions } from './types.js';
+/**
+ * Push discovered translation keys to the CMS sync endpoint.
+ *
+ * Three possible outcomes:
+ *  1. **Dry-run** (`opts.dryRun`) — prints a diff against the last cache and
+ *     optionally writes a report, but never POSTs to the CMS.
+ *  2. **No changes** — skips the POST when the serialized keys are identical
+ *     to the last cache and `--force` was not passed.
+ *  3. **Sync** — POSTs the full namespace map; on success saves the new cache
+ *     and optionally writes a report.
+ */
+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,4BAA4B,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAgB,MAAM,YAAY,CAAC;AAYlE;;;;;;;;;;GAUG;AACH,wBAAsB,UAAU,CAC5B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,YAAY,EACxB,IAAI,GAAE,iBAA2C,GAClD,OAAO,CAAC,IAAI,CAAC,CAoJf"}

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

@@ -0,0 +1,139 @@
+/**
+ * Sync (push) translation keys to CMS.
+ */
+import { loadSyncCache, saveSyncCache, isSyncNeeded, computeDiff, writeReport, serializeNamespaces, formatPreviewRoutes, } from '../../core/cache.js';
+import { resolveReportPath } from './helpers.js';
+/**
+ * Push discovered translation keys to the CMS sync endpoint.
+ *
+ * Three possible outcomes:
+ *  1. **Dry-run** (`opts.dryRun`) — prints a diff against the last cache and
+ *     optionally writes a report, but never POSTs to the CMS.
+ *  2. **No changes** — skips the POST when the serialized keys are identical
+ *     to the last cache and `--force` was not passed.
+ *  3. **Sync** — POSTs the full namespace map; on success saves the new cache
+ *     and optionally writes a report.
+ */
+export async function postToSync(config, namespaces, opts = { root: process.cwd() }) {
+    // Flatten NamespaceMap → plain serializable object for the API payload and cache
+    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;
+    }
+    // Load the baseline from the last successful sync to diff against
+    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 ------------------------------------------------
+    // isSyncNeeded compares serialized keys against the cache — if identical,
+    // there's nothing new for the CMS to process.
+    if (!opts.force && !isSyncNeeded(serialized, cached)) {
+        console.log('No changes detected — skipping sync. Use --force to override.');
+        if (opts.reportPath) {
+            // Write a report even when skipping so CI artefacts stay up-to-date
+            writeReport(resolveReportPath(opts.root, opts.reportPath), serialized);
+        }
+        return;
+    }
+    // ---- Post to CMS -------------------------------------------------------
+    // Strip trailing slash to avoid double slashes in the URL
+    const url = `${config.cmsUrl.replace(/\/$/, '')}/api/sync/${config.projectId}`;
+    console.log(`Posting to ${url}...`);
+    // Build the API payload — same as serialized but with optional values merged
+    // in per key. Values are excluded from the cache so key-change detection is
+    // not affected by local translation edits.
+    const apiPayload = opts.localValues && Object.keys(opts.localValues).length > 0
+        ? buildPayloadWithValues(serialized, opts.localValues)
+        : serialized;
+    const response = await fetch(url, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'x-api-key': config.apiKey,
+        },
+        body: JSON.stringify({ namespaces: apiPayload }),
+    });
+    const contentType = response.headers.get('content-type') ?? '';
+    const isJson = contentType.includes('application/json');
+    if (!response.ok) {
+        console.error(`Sync failed: ${response.status} ${response.statusText}`);
+        // HTML response usually means the endpoint doesn't exist (wrong URL / not deployed)
+        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);
+    }
+    // A 2xx with an HTML body is also invalid — guard against misconfigured proxies
+    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());
+    const valuesPart = data.valuesUploaded != null && data.valuesUploaded > 0
+        ? `, ${data.valuesUploaded} draft value(s) bootstrapped`
+        : '';
+    console.log(`Synced: ${data.created} created, ${data.updated ?? 0} routes updated, ${data.existing} existing${valuesPart}`);
+    if (data.message)
+        console.log(data.message);
+    // Persist the new baseline so subsequent runs can detect changes correctly
+    saveSyncCache(opts.root, serialized);
+    if (opts.reportPath) {
+        const diff = computeDiff(serialized, cached);
+        writeReport(resolveReportPath(opts.root, opts.reportPath), serialized, diff);
+    }
+}
+/**
+ * Merge local translation values into the serialized namespace payload.
+ * Values are attached per key but never included in the sync cache — this
+ * keeps key-change detection independent of translation edits.
+ */
+function buildPayloadWithValues(serialized, localValues) {
+    const payload = {};
+    for (const [ns, entries] of Object.entries(serialized)) {
+        const nsValues = localValues[ns] ?? {};
+        payload[ns] = entries.map(entry => {
+            const values = nsValues[entry.key];
+            if (values && Object.keys(values).length > 0) {
+                return { ...entry, values };
+            }
+            return entry;
+        });
+    }
+    return payload;
+}
+//# 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,33 @@
+/**
+ * TypeScript types for sync API.
+ */
+export interface SyncResponse {
+    created: number;
+    updated?: number;
+    existing: number;
+    valuesUploaded?: 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;
+    /**
+     * Translation values read from local JSON files, keyed by
+     * namespace → translationKey → locale → value.
+     * When provided, values are included in the sync payload so the CMS can
+     * store them as drafts (only where no draft exists yet).
+     */
+    localValues?: Record<string, Record<string, Record<string, 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,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,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;IACpB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;CACxE;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/core/cache-internals/format.d.ts

@@ -0,0 +1,20 @@
+import type { PreviewRoute } from '../../core/scanner.js';
+/**
+ * Format a single PreviewRoute for human-readable output.
+ *
+ * Plain string routes are returned as-is.
+ * Object routes (with params) are rendered as `/path (key=value, …)`.
+ *
+ * @example
+ * formatPreviewRoute('/dashboard')                          // → "/dashboard"
+ * formatPreviewRoute({ route: '/blog/[slug]', params: { slug: 'hello' } })
+ *                                                           // → "/blog/[slug] (slug=hello)"
+ */
+export declare function formatPreviewRoute(route: PreviewRoute): string;
+/**
+ * Format an array of PreviewRoutes as a comma-separated string.
+ * Returns `"no route"` for keys that have no associated preview routes
+ * (e.g. keys inside dialogs or overlays).
+ */
+export declare function formatPreviewRoutes(routes: PreviewRoute[]): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/core/cache-internals/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/core/cache-internals/format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAS9D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,CAGlE"}