gtx-cli 2.5.48 → 2.5.49

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # gtx-cli
 
+## 2.5.49
+
+### Patch Changes
+
+- [#953](https://github.com/generaltranslation/gt/pull/953) [`4fca112`](https://github.com/generaltranslation/gt/commit/4fca1123d797883b8ad73a770ad177b5068a4707) Thanks [@fernando-aviles](https://github.com/fernando-aviles)! - Add handling for OpenAPI configurations via Mintlify's `docs.json`
+
 ## 2.5.48
 
 ### Patch Changes

package/dist/generated/version.d.ts

@@ -1 +1 @@
-export declare const PACKAGE_VERSION = "2.5.48";
+export declare const PACKAGE_VERSION = "2.5.49";

package/dist/generated/version.js

@@ -1,2 +1,2 @@
 // This file is auto-generated. Do not edit manually.
-export const PACKAGE_VERSION = '2.5.48';
+export const PACKAGE_VERSION = '2.5.49';

package/dist/utils/processOpenApi.js

@@ -72,10 +72,194 @@ export default async function processOpenApi(settings, includeFiles) {
             }
         }
     }
+    const docsJsonTargets = collectDocsJsonTargets(settings, fileMapping, includeFiles);
+    for (const target of docsJsonTargets) {
+        if (!fs.existsSync(target.path))
+            continue;
+        const content = fs.readFileSync(target.path, 'utf8');
+        const updated = rewriteDocsJsonOpenApi(content, target.path, target.localeHint, specAnalyses, fileMappingAbs, fileMapping, warnings, configDir, settings.defaultLocale);
+        if (updated?.changed) {
+            await fs.promises.writeFile(target.path, updated.content, 'utf8');
+        }
+    }
     for (const message of warnings) {
         logger.warn(message);
     }
 }
+function collectDocsJsonTargets(settings, fileMapping, includeFiles) {
+    const targets = [];
+    const seen = new Map();
+    const addTarget = (filePath, locale) => {
+        const canonicalPath = path.resolve(filePath);
+        if (includeFiles &&
+            !includeFiles.has(filePath) &&
+            !includeFiles.has(canonicalPath)) {
+            return;
+        }
+        const locales = seen.get(canonicalPath) ?? new Set();
+        if (locale)
+            locales.add(locale);
+        seen.set(canonicalPath, locales);
+    };
+    if (!includeFiles && settings.files?.resolvedPaths.json) {
+        for (const filePath of settings.files.resolvedPaths.json) {
+            addTarget(filePath, settings.defaultLocale);
+        }
+    }
+    for (const [locale, filesMap] of Object.entries(fileMapping)) {
+        for (const filePath of Object.values(filesMap)) {
+            if (!filePath.endsWith('.json'))
+                continue;
+            addTarget(filePath, locale);
+        }
+    }
+    for (const [filePath, locales] of seen.entries()) {
+        const localeHint = locales.size === 1 ? Array.from(locales)[0] : undefined;
+        targets.push({ path: filePath, localeHint });
+    }
+    return targets;
+}
+function isMintlifyDocsJson(filePath, json) {
+    if (!isRecord(json))
+        return false;
+    const schema = json.$schema;
+    if (typeof schema === 'string') {
+        return (schema.includes('mintlify.com/docs.json') ||
+            schema.includes('mintlify.com/mint.json'));
+    }
+    const base = path.basename(filePath);
+    return base === 'docs.json' || base === 'mint.json';
+}
+function rewriteDocsJsonOpenApi(content, filePath, localeHint, specs, fileMappingAbs, fileMappingRel, warnings, configDir, defaultLocale) {
+    let json;
+    try {
+        json = JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+    if (!isMintlifyDocsJson(filePath, json))
+        return null;
+    let changed = false;
+    const visitNode = (node, activeLocale) => {
+        if (Array.isArray(node)) {
+            node.forEach((item) => visitNode(item, activeLocale));
+            return;
+        }
+        if (!isRecord(node))
+            return;
+        let nextLocale = activeLocale;
+        if (typeof node.language === 'string') {
+            nextLocale = node.language;
+        }
+        if (isRecord(node.openapi) && Array.isArray(node.pages)) {
+            const locale = nextLocale || localeHint || defaultLocale;
+            const openapiConfig = node.openapi;
+            const sourceValue = openapiConfig.source;
+            if (typeof sourceValue === 'string') {
+                const localizedSource = localizeDocsJsonSpecPath(sourceValue, locale, filePath, specs, fileMappingAbs, fileMappingRel, warnings, configDir);
+                if (localizedSource && localizedSource !== sourceValue) {
+                    openapiConfig.source = localizedSource;
+                    changed = true;
+                }
+            }
+            const pages = node.pages;
+            for (let i = 0; i < pages.length; i += 1) {
+                const page = pages[i];
+                if (typeof page !== 'string')
+                    continue;
+                const updated = stripLocaleFromOpenApiPage(page, locale);
+                if (updated !== page) {
+                    pages[i] = updated;
+                    changed = true;
+                }
+            }
+        }
+        for (const value of Object.values(node)) {
+            visitNode(value, nextLocale);
+        }
+    };
+    visitNode(json, undefined);
+    if (!changed)
+        return null;
+    return { changed, content: JSON.stringify(json, null, 2) };
+}
+function stripLocaleFromOpenApiPage(value, locale) {
+    const trimmed = value.trim();
+    const prefix = `${locale}/`;
+    if (!trimmed.startsWith(prefix))
+        return value;
+    const candidate = trimmed.slice(prefix.length);
+    const parsed = parseOpenApiValue(candidate);
+    if (!parsed)
+        return value;
+    return candidate;
+}
+function localizeDocsJsonSpecPath(source, locale, filePath, specs, fileMappingAbs, _fileMappingRel, warnings, configDir) {
+    const resolvedAbs = resolveDocsJsonSpecPath(source, filePath, configDir);
+    const matched = matchSpecBySource(source, resolvedAbs, specs, warnings);
+    if (!matched)
+        return source;
+    const localizedSpecPath = resolveLocalizedSpecPath(matched, locale, fileMappingAbs, configDir, source);
+    const localizedAbs = resolveDocsJsonSpecPath(localizedSpecPath, filePath, configDir);
+    if (!fs.existsSync(localizedAbs)) {
+        warnings.add(`OpenAPI source "${source}" localized for locale "${locale}" points to a missing file (${localizedAbs}). Keeping original source.`);
+        return source;
+    }
+    const rel = normalizeSlashes(path.relative(configDir, localizedAbs));
+    return formatSpecPathForDocsJson(rel, source);
+}
+function resolveDocsJsonSpecPath(source, filePath, configDir) {
+    if (source.startsWith('/')) {
+        return path.resolve(configDir, source.replace(/^\/+/, ''));
+    }
+    if (source.startsWith('./') || source.startsWith('../')) {
+        return path.resolve(path.dirname(filePath), source);
+    }
+    return path.resolve(configDir, source);
+}
+function matchSpecBySource(source, resolvedAbs, specs, warnings) {
+    const exact = specs.find((spec) => samePath(resolvedAbs, spec.absPath));
+    if (exact)
+        return exact;
+    const normalizedExplicit = normalizeSlashes(source).replace(/^\.?\/+/, '');
+    const explicitWithoutExt = stripExtension(normalizedExplicit);
+    const explicitBase = path.basename(normalizedExplicit);
+    const explicitBaseWithoutExt = stripExtension(explicitBase);
+    const matches = specs.filter((spec) => {
+        const configPath = normalizeSlashes(spec.configPath).replace(/^\.?\/+/, '');
+        const configBase = path.basename(configPath);
+        const configPathNoExt = stripExtension(configPath);
+        const configBaseNoExt = stripExtension(configBase);
+        return (configPath === normalizedExplicit ||
+            configPathNoExt === explicitWithoutExt ||
+            configBase === explicitBase ||
+            configBaseNoExt === explicitBaseWithoutExt);
+    });
+    if (matches.length === 1)
+        return matches[0];
+    if (matches.length > 1) {
+        warnings.add(`OpenAPI source "${source}" matches multiple specs (${matches
+            .map((m) => m.configPath)
+            .join(', ')}). Using the first configured match (${matches[0].configPath}).`);
+        return matches[0];
+    }
+    return null;
+}
+function formatSpecPathForDocsJson(relativePath, originalPathText) {
+    const normalized = normalizeSlashes(relativePath);
+    const base = normalized.replace(/^\.\//, '').replace(/\/+/g, '/');
+    if (originalPathText.startsWith('/')) {
+        return `/${base.replace(/^\/+/, '')}`;
+    }
+    if (originalPathText.startsWith('../')) {
+        return normalized;
+    }
+    if (originalPathText.startsWith('./')) {
+        return `./${base.replace(/^\/+/, '')}`;
+    }
+    return base.replace(/^\/+/, '');
+}
 /**
  * Resolve configured OpenAPI files to absolute paths and collect the operations,
  * schemas, and webhooks they expose. Warns and skips when files are missing,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gtx-cli",
-  "version": "2.5.48",
+  "version": "2.5.49",
   "main": "dist/index.js",
   "bin": "dist/main.js",
   "files": [