fx-spec-hub 0.0.1

package/dist/env/admin/.env.common

@@ -0,0 +1,13 @@
+# sentry 团队slug
+VITE_SENTRY_ORG=sentry
+# sentry 地址
+VITE_SENTRY_URL=https://sentry.finex18.com
+# sentry 认证token
+VITE_SENTRY_AUTH_TOKEN=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
+VITE_SENTRY_PROJECT=exchange-admin-frontend
+
+# dev 分支有的环境变量
+# EDITOR=vscode
+# FALLBACK_LNG=en
+# SENTRY_DISABLED=true
+

package/dist/env/admin/.env.dev

@@ -0,0 +1,14 @@
+VITE_OTEL_EXPORTER_OTLP_ENDPOINT =
+VITE_SENTRY_DSN =
+
+# SERVER_BASE_URL=http://10.1.9.121/api
+ACCESS_CONTROL_ALLOW_ORIGIN=https://www.894568.xyz
+STRAPI_INTERNAL_DOMAIN=https://cms.894568.xyz
+SENTRY_DISABLED=true
+
+VITE_APP_BASE_URL=https://api-admin.894568.xyz
+VITE_APP_CMS_URL=https://cms.894568.xyz/api
+VITE_APP_MOCK_URL=https://api-admin.894568.xyz
+VITE_APP_TPS_URL =
+VITE_APP_CPU_URL =
+VITE_APP_GRAFANA_URL = https://grafana.894568.xyz/d/eeet5hhf3xszkc/cpu-memory

package/dist/env/admin/.env.test

@@ -0,0 +1,13 @@
+VITE_OTEL_EXPORTER_OTLP_ENDPOINT = https://otel.finex-test.com/v1/traces
+VITE_SENTRY_DSN = https://4f08e4744edf25ca7b9cb2e1eae2b6bb@sentry.finex18.com/12
+
+# API 地址
+VITE_APP_BASE_URL = https://api-admin.finex-test.com
+VITE_APP_CMS_URL = https://cms.finex-test.com/api
+VITE_APP_MOCK_URL = https://api-admin.finex-test.com
+VITE_API_PROXY_TARGET = https://api-admin.finex-test.com
+# Grafana 地址
+VITE_APP_TPS_URL =
+VITE_APP_CPU_URL =
+VITE_APP_GRAFANA_URL = https://grafana.finex-test.com/d/eeet5hhf3xszkc/cpu-memory
+VITE_IS_TEST_ENVIRONMENT = true

package/dist/env/admin/.env.uat

@@ -0,0 +1,14 @@
+VITE_OTEL_EXPORTER_OTLP_ENDPOINT =
+VITE_SENTRY_DSN =
+
+# API 地址
+VITE_APP_BASE_URL = https://api-admin.finex-uat.com
+VITE_APP_CMS_URL = https://cms.finex-uat.com/api
+VITE_APP_MOCK_URL = https://api-admin.finex-uat.com
+VITE_API_PROXY_TARGET = https://api-admin.finex-uat.com
+# Grafana 地址
+VITE_APP_TPS_URL = https://grafana.finex-uat.com/d/aeet5otmhyd4wc/spotclearing?orgId=1&from=now-24h&to=now&timezone=browser&refresh=5s&kiosk&theme=light&kiosk
+VITE_APP_CPU_URL = https://grafana.finex-uat.com/d/beet5sfiedr0gc/cpu-memory?orgId=1&from=now-24h&to=now&timezone=browser&refresh=5s&kiosk&theme=light&kiosk
+VITE_APP_GRAFANA_URL = https://grafana.894577.com/d/eeet5hhf3xszkc/cpu-memory
+VITE_IS_TEST_ENVIRONMENT = false
+

package/dist/env/user/.env.common

@@ -0,0 +1,13 @@
+EDITOR=vscode
+FALLBACK_LNG=en
+
+SENTRY_DISABLED=true
+
+# sentry 团队slug
+SENTRY_ORG=sentry
+# sentry 地址
+SENTRY_URL=https://sentry.finex18.com
+# sentry 认证token
+SENTRY_AUTH_TOKEN=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
+SENTRY_PROJECT=exchange-user-frontend
+SENTRY_DSN=https://81c5d8bcda525c50c97758448b545dc8@sentry.finex18.com/4

package/dist/env/user/.env.dev

@@ -0,0 +1,12 @@
+ACCESS_CONTROL_ALLOW_ORIGIN=https://www.894568.xyz
+SENTRY_DISABLED=true
+
+BASE_URL=https://web-api-service.894568.xyz
+APP_BASE_URL=https://app-api-service.894568.xyz
+SERVER_BASE_URL=http:2000-exchange-web-api-service-http.apisix:9080
+WS_URL=wss://ws.894568.xyz
+STRAPI_BASE_DOMAIN=https://cms.894568.xyz
+STATIC_DOMAIN=https://static.894568.xyz
+GA_ID=
+CAPTCHA_ID=8d57f6d065f143e645d86ed6ff7206f5
+REOWN_PROJECT_ID=1f5038de5b4e29414710cb53ccfd92f0

package/dist/env/user/.env.test

@@ -0,0 +1,11 @@
+ACCESS_CONTROL_ALLOW_ORIGIN=https://www.finex-test.com
+
+BASE_URL=https://web-api.finex-test.com
+SERVER_BASE_URL=http:exchange-web-api-service:9000
+APP_BASE_URL=https://app-api.finex-test.com
+WS_URL=wss://ws.finex-test.com
+STRAPI_BASE_DOMAIN=https://cms.finex-test.com
+STATIC_DOMAIN=https://static.finex-test.com
+GA_ID=
+CAPTCHA_ID=8d57f6d065f143e645d86ed6ff7206f5
+REOWN_PROJECT_ID=1f5038de5b4e29414710cb53ccfd92f0

package/dist/env/user/.env.uat

@@ -0,0 +1,11 @@
+ACCESS_CONTROL_ALLOW_ORIGIN=https://www.finex-uat.com
+
+BASE_URL=https://web-api.finex-uat.com
+SERVER_BASE_URL=http:exchange-web-api-service:9000
+APP_BASE_URL=https://app-api.finex-uat.com
+WS_URL=wss://ws.finex-uat.com
+STRAPI_BASE_DOMAIN=https://cms.finex-uat.com
+STATIC_DOMAIN=https://static.finex-uat.com
+GA_ID=
+CAPTCHA_ID=8d57f6d065f143e645d86ed6ff7206f5
+REOWN_PROJECT_ID=1f5038de5b4e29414710cb53ccfd92f0

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { generateSwaggerApi } from './swagger';
+export type { SwaggerGenerateOptions, SwaggerGenerateResult, SwaggerHttpClientType, } from './swagger';
+export { generateStrapiEnums } from './strapi-enums';
+export type { StrapiEnumsGenerateOptions } from './strapi-enums';

package/dist/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateStrapiEnums = exports.generateSwaggerApi = void 0;
+var swagger_1 = require("./swagger");
+Object.defineProperty(exports, "generateSwaggerApi", { enumerable: true, get: function () { return swagger_1.generateSwaggerApi; } });
+var strapi_enums_1 = require("./strapi-enums");
+Object.defineProperty(exports, "generateStrapiEnums", { enumerable: true, get: function () { return strapi_enums_1.generateStrapiEnums; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,qCAA+C;AAAtC,6GAAA,kBAAkB,OAAA;AAO3B,+CAAqD;AAA5C,mHAAA,mBAAmB,OAAA"}

package/dist/index.mjs

@@ -0,0 +1,6 @@
+import cjs from './index.js';
+
+export const generateSwaggerApi = cjs.generateSwaggerApi;
+export const generateStrapiEnums = cjs.generateStrapiEnums;
+
+export default cjs;

package/dist/logger.d.ts

@@ -0,0 +1,2 @@
+export declare function log(message: string): void;
+export declare function logError(error: unknown): void;

package/dist/logger.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.log = log;
+exports.logError = logError;
+function log(message) {
+    // eslint-disable-next-line no-console
+    console.log(`[swagger-admin] ${message}`);
+}
+function logError(error) {
+    const message = error instanceof Error ? `${error.message}\n${error.stack ?? ''}` : String(error);
+    // eslint-disable-next-line no-console
+    console.error(`[swagger-admin] ${message}`);
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":";;AAAA,kBAGC;AAED,4BAKC;AAVD,SAAgB,GAAG,CAAC,OAAe;IACjC,sCAAsC;IACtC,OAAO,CAAC,GAAG,CAAC,mBAAmB,OAAO,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,SAAgB,QAAQ,CAAC,KAAc;IACrC,MAAM,OAAO,GACX,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,OAAO,KAAK,KAAK,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACpF,sCAAsC;IACtC,OAAO,CAAC,KAAK,CAAC,mBAAmB,OAAO,EAAE,CAAC,CAAC;AAC9C,CAAC"}

package/dist/strapi-enums.d.ts

@@ -0,0 +1,17 @@
+export interface StrapiEnumsGenerateOptions {
+    /**
+     * 输入：
+     * - URL（https://.../api/options 或完整带 query 的 URL）
+     * - 本地 JSON 文件路径（用于离线生成）
+     */
+    input?: string;
+    /** 输出文件路径（相对/绝对） */
+    output: string;
+    /** pageSize（当 input 不含 query 时才会自动拼默认 query） */
+    pageSize?: number;
+    /** locale（当 input 不含 query 时才会自动拼默认 query） */
+    locale?: string;
+    /** 指定 prettier 配置文件路径（可选） */
+    prettierConfig?: string;
+}
+export declare function generateStrapiEnums(options: StrapiEnumsGenerateOptions): Promise<void>;

package/dist/strapi-enums.js

@@ -0,0 +1,143 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateStrapiEnums = generateStrapiEnums;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const prettier_1 = __importDefault(require("prettier"));
+const qs_1 = __importDefault(require("qs"));
+const defaultStrapiEnumOptionsPath = node_path_1.default.resolve(__dirname, './data/strapi-enum-options.json');
+function resolveFromCwd(maybePath) {
+    return node_path_1.default.isAbsolute(maybePath) ? maybePath : node_path_1.default.resolve(process.cwd(), maybePath);
+}
+function isURL(str) {
+    return (/^https?:\/\/([a-z0-9-]{1,63}\.){1,}[a-z]{2,63}(:\d{1,5})?(\/[^\s]*)?$/i.test(str) || /^https?:\/\/(\d{1,3}\.){3}\d{1,3}(:\d{1,5})?(\/[^\s]*)?$/i.test(str));
+}
+async function fetchJson(url) {
+    const response = await fetch(url);
+    if (!response.ok) {
+        throw new Error(`请求失败：${response.status} ${response.statusText}`);
+    }
+    return response.json();
+}
+function toValidIdentifier(raw) {
+    let identifier = '';
+    for (const char of String(raw ?? '')) {
+        const isLower = char >= 'a' && char <= 'z';
+        const isUpper = char >= 'A' && char <= 'Z';
+        const isDigit = char >= '0' && char <= '9';
+        const isUnderscore = char === '_';
+        identifier += isLower || isUpper || isDigit || isUnderscore ? char : '_';
+    }
+    if (/^\d/.test(identifier)) {
+        identifier = 'V_' + identifier;
+    }
+    let prev = '';
+    while (prev !== identifier) {
+        prev = identifier;
+        identifier = identifier.replace('__', '_');
+    }
+    let start = 0;
+    let end = identifier.length;
+    while (start < identifier.length && identifier[start] === '_')
+        start++;
+    while (end > start && identifier[end - 1] === '_')
+        end--;
+    identifier = identifier.slice(start, end);
+    return identifier || 'UNKNOWN';
+}
+function generateEnumCode(rows) {
+    const grouped = new Map();
+    for (const item of rows) {
+        const typeName = item.options_type?.name;
+        const typeRemark = item.options_type?.remark ?? '';
+        if (!typeName)
+            continue;
+        const bucket = grouped.get(typeName) ??
+            (() => {
+                const next = { remark: typeRemark, options: [] };
+                grouped.set(typeName, next);
+                return next;
+            })();
+        bucket.options.push({
+            value: item.value,
+            label_cn: item.label_cn,
+            sort: item.sort,
+        });
+    }
+    let enumCode = '';
+    const optionsTypeParts = [];
+    for (const [typeName, typeData] of grouped.entries()) {
+        typeData.options.sort((a, b) => a.sort - b.sort);
+        enumCode += `/**\n * ${typeData.remark}\n */\n`;
+        enumCode += `export enum ${typeName} {\n`;
+        for (const option of typeData.options) {
+            enumCode += `  /**\n   * ${option.label_cn}\n   */\n`;
+            const enumKey = toValidIdentifier(option.value);
+            enumCode += `  ${enumKey} = '${option.value}',\n`;
+        }
+        enumCode += '}\n\n';
+        optionsTypeParts.push(`'${typeName}'`);
+    }
+    enumCode += `export type OptionsType = ${optionsTypeParts.join(' | ')}`;
+    return enumCode.trim();
+}
+function normalizeRows(json) {
+    if (Array.isArray(json))
+        return json;
+    if (json && typeof json === 'object') {
+        const code = json.code;
+        if (typeof code === 'string' && code !== 'OK') {
+            throw new Error(`接口返回非 OK：${code}`);
+        }
+        const data = json.data;
+        if (Array.isArray(data))
+            return data;
+    }
+    throw new Error('输入数据格式不正确：需要 Array 或包含 data:Array 的对象');
+}
+function buildDefaultQuery(pageSize, locale) {
+    return qs_1.default.stringify({
+        'pagination[pageSize]': pageSize,
+        locale,
+        populate: {
+            options_type: {
+                fields: ['name', 'remark'],
+            },
+        },
+    }, { encodeValuesOnly: true });
+}
+function withDefaultQueryIfNeeded(url, pageSize, locale) {
+    if (url.includes('?'))
+        return url;
+    return `${url}?${buildDefaultQuery(pageSize, locale)}`;
+}
+async function formatWithPrettier(code, outputPath, configPath) {
+    const config = await prettier_1.default
+        .resolveConfig(outputPath, configPath ? { config: resolveFromCwd(configPath) } : undefined)
+        .catch(() => null);
+    return prettier_1.default.format(code, {
+        parser: 'typescript',
+        ...(config ?? {}),
+    });
+}
+async function generateStrapiEnums(options) {
+    const { input, output, pageSize = 1000, locale = 'zh-CN', prettierConfig } = options;
+    const outputPath = resolveFromCwd(output);
+    const outputDir = node_path_1.default.dirname(outputPath);
+    await node_fs_1.default.promises.mkdir(outputDir, { recursive: true });
+    const resolvedInput = input ?? defaultStrapiEnumOptionsPath;
+    if (!input && !node_fs_1.default.existsSync(resolvedInput)) {
+        throw new Error(`未找到默认 Strapi 枚举数据文件：${resolvedInput}`);
+    }
+    const json = isURL(resolvedInput)
+        ? await fetchJson(withDefaultQueryIfNeeded(resolvedInput, pageSize, locale))
+        : JSON.parse(await node_fs_1.default.promises.readFile(resolveFromCwd(resolvedInput), 'utf-8'));
+    const rows = normalizeRows(json);
+    const code = generateEnumCode(rows);
+    const formatted = await formatWithPrettier(code, outputPath, prettierConfig);
+    await node_fs_1.default.promises.writeFile(outputPath, formatted, 'utf-8');
+}
+//# sourceMappingURL=strapi-enums.js.map

package/dist/strapi-enums.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strapi-enums.js","sourceRoot":"","sources":["../src/strapi-enums.ts"],"names":[],"mappings":";;;;;AA8KA,kDAsBC;AApMD,sDAAyB;AACzB,0DAA6B;AAC7B,wDAAgC;AAChC,4CAAoB;AAEpB,MAAM,4BAA4B,GAAG,mBAAI,CAAC,OAAO,CAAC,SAAS,EAAE,iCAAiC,CAAC,CAAC;AA2BhG,SAAS,cAAc,CAAC,SAAiB;IACvC,OAAO,mBAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,mBAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC;AACzF,CAAC;AAED,SAAS,KAAK,CAAC,GAAW;IACxB,OAAO,CACL,wEAAwE,CAAC,IAAI,CAC3E,GAAG,CACJ,IAAI,2DAA2D,CAAC,IAAI,CAAC,GAAG,CAAC,CAC3E,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,GAAW;IAClC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,QAAQ,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,EAAsB,CAAC;AAC7C,CAAC;AAED,SAAS,iBAAiB,CAAC,GAAY;IACrC,IAAI,UAAU,GAAG,EAAE,CAAC;IACpB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,CAAC;QACrC,MAAM,OAAO,GAAG,IAAI,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,CAAC;QAC3C,MAAM,OAAO,GAAG,IAAI,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,CAAC;QAC3C,MAAM,OAAO,GAAG,IAAI,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,CAAC;QAC3C,MAAM,YAAY,GAAG,IAAI,KAAK,GAAG,CAAC;QAClC,UAAU,IAAI,OAAO,IAAI,OAAO,IAAI,OAAO,IAAI,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;IAC3E,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3B,UAAU,GAAG,IAAI,GAAG,UAAU,CAAC;IACjC,CAAC;IAED,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,OAAO,IAAI,KAAK,UAAU,EAAE,CAAC;QAC3B,IAAI,GAAG,UAAU,CAAC;QAClB,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC7C,CAAC;IAED,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,GAAG,GAAG,UAAU,CAAC,MAAM,CAAC;IAC5B,OAAO,KAAK,GAAG,UAAU,CAAC,MAAM,IAAI,UAAU,CAAC,KAAK,CAAC,KAAK,GAAG;QAAE,KAAK,EAAE,CAAC;IACvE,OAAO,GAAG,GAAG,KAAK,IAAI,UAAU,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,GAAG;QAAE,GAAG,EAAE,CAAC;IAEzD,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC1C,OAAO,UAAU,IAAI,SAAS,CAAC;AACjC,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAuB;IAC/C,MAAM,OAAO,GAAG,IAAI,GAAG,EAGpB,CAAC;IAEJ,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;QACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC;QACzC,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,EAAE,MAAM,IAAI,EAAE,CAAC;QACnD,IAAI,CAAC,QAAQ;YAAE,SAAS;QAExB,MAAM,MAAM,GACV,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;YACrB,CAAC,GAAG,EAAE;gBACJ,MAAM,IAAI,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,EAAW,EAAE,CAAC;gBAC1D,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;gBAC5B,OAAO,IAAI,CAAC;YACd,CAAC,CAAC,EAAE,CAAC;QAEP,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;YAClB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,CAAC,CAAC;IACL,CAAC;IAED,IAAI,QAAQ,GAAG,EAAE,CAAC;IAClB,MAAM,gBAAgB,GAAa,EAAE,CAAC;IAEtC,KAAK,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QACrD,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;QAEjD,QAAQ,IAAI,WAAW,QAAQ,CAAC,MAAM,SAAS,CAAC;QAChD,QAAQ,IAAI,eAAe,QAAQ,MAAM,CAAC;QAE1C,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACtC,QAAQ,IAAI,eAAe,MAAM,CAAC,QAAQ,WAAW,CAAC;YACtD,MAAM,OAAO,GAAG,iBAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAChD,QAAQ,IAAI,KAAK,OAAO,OAAO,MAAM,CAAC,KAAK,MAAM,CAAC;QACpD,CAAC;QAED,QAAQ,IAAI,OAAO,CAAC;QACpB,gBAAgB,CAAC,IAAI,CAAC,IAAI,QAAQ,GAAG,CAAC,CAAC;IACzC,CAAC;IAED,QAAQ,IAAI,6BAA6B,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;IACxE,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;AACzB,CAAC;AAED,SAAS,aAAa,CAAC,IAAa;IAClC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,IAAyB,CAAC;IAC1D,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACrC,MAAM,IAAI,GAAI,IAAY,CAAC,IAAI,CAAC;QAChC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;QACtC,CAAC;QACD,MAAM,IAAI,GAAI,IAAY,CAAC,IAAI,CAAC;QAChC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;YAAE,OAAO,IAAyB,CAAC;IAC5D,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;AAC3D,CAAC;AAED,SAAS,iBAAiB,CAAC,QAAgB,EAAE,MAAc;IACzD,OAAO,YAAE,CAAC,SAAS,CACjB;QACE,sBAAsB,EAAE,QAAQ;QAChC,MAAM;QACN,QAAQ,EAAE;YACR,YAAY,EAAE;gBACZ,MAAM,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC;aAC3B;SACF;KACF,EACD,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAC3B,CAAC;AACJ,CAAC;AAED,SAAS,wBAAwB,CAAC,GAAW,EAAE,QAAgB,EAAE,MAAc;IAC7E,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IAClC,OAAO,GAAG,GAAG,IAAI,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC;AACzD,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,IAAY,EAAE,UAAkB,EAAE,UAAmB;IACrF,MAAM,MAAM,GAAG,MAAM,kBAAQ;SAC1B,aAAa,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;SAC1F,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAErB,OAAO,kBAAQ,CAAC,MAAM,CAAC,IAAI,EAAE;QAC3B,MAAM,EAAE,YAAY;QACpB,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC;KAClB,CAAC,CAAC;AACL,CAAC;AAEM,KAAK,UAAU,mBAAmB,CAAC,OAAmC;IAC3E,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAG,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC;IAErF,MAAM,UAAU,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,mBAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3C,MAAM,iBAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAExD,MAAM,aAAa,GAAG,KAAK,IAAI,4BAA4B,CAAC;IAE5D,IAAI,CAAC,KAAK,IAAI,CAAC,iBAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,uBAAuB,aAAa,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,aAAa,CAAC;QAC/B,CAAC,CAAC,MAAM,SAAS,CAAC,wBAAwB,CAAC,aAAa,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC5E,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,iBAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IAEnF,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,SAAS,GAAG,MAAM,kBAAkB,CAAC,IAAI,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC;IAE7E,MAAM,iBAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,UAAU,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;AAC9D,CAAC"}

package/dist/swagger.d.ts

@@ -0,0 +1,43 @@
+export type SwaggerHttpClientType = 'axios' | 'fetch';
+export interface SwaggerGenerateResult {
+    outputDir: string;
+    templatesDir: string;
+    modules: {
+        name: string;
+    }[];
+    indexPath: string;
+    dataContractsPath: string;
+    files: unknown[];
+}
+export interface SwaggerGenerateOptions {
+    /**
+     * OpenAPI 输入：
+     * - URL（https://...）
+     * - 本地文件路径（相对/绝对）
+     * - 已解析的 JSON 对象（spec）
+     */
+    input?: string | Record<string, unknown>;
+    /** 输出目录（相对/绝对） */
+    output: string;
+    /** swagger-typescript-api 模板目录（默认使用本包自带 swagger-template） */
+    templateDir?: string;
+    /** 生成的 index.ts 中的 baseURL（字符串字面量），例如：https://api.example.com */
+    baseURL: string;
+    /** 生成的 index.ts 中 HttpClient 的 import 路径 */
+    httpClientPath?: string;
+    /** swagger-typescript-api 的客户端类型 */
+    httpClientType?: SwaggerHttpClientType;
+    /** 是否拆分模块输出 */
+    modular?: boolean;
+    /** 生成前清空输出目录 */
+    cleanOutput?: boolean;
+    /** 是否解包响应体（依赖模板实现） */
+    unwrapResponseData?: boolean;
+    /** 是否提取 enum */
+    extractEnums?: boolean;
+    /** 是否生成联合类型枚举 */
+    generateUnionEnums?: boolean;
+    /** 生成成功后的回调（在 index.ts 写入完成后触发） */
+    onSuccess?: (result: SwaggerGenerateResult) => void | Promise<void>;
+}
+export declare function generateSwaggerApi(options: SwaggerGenerateOptions, isStrapi?: boolean): Promise<SwaggerGenerateResult>;

package/dist/swagger.js

@@ -0,0 +1,96 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateSwaggerApi = generateSwaggerApi;
+const ejs_1 = __importDefault(require("ejs"));
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const swagger_typescript_api_1 = require("swagger-typescript-api");
+const webBackendApiPath = node_path_1.default.resolve(__dirname, './data/web-backend-api.json');
+const adminBackendApiPath = node_path_1.default.resolve(__dirname, './data/admin-backend-api.json');
+const strapiBackendApiPath = node_path_1.default.resolve(__dirname, './data/strapi-backend-api.json');
+function isURL(str) {
+    return (/^https?:\/\/([a-z0-9-]{1,63}\.){1,}[a-z]{2,63}(:\d{1,5})?(\/[^\s]*)?$/i.test(str) || /^https?:\/\/(\d{1,3}\.){3}\d{1,3}(:\d{1,5})?(\/[^\s]*)?$/i.test(str));
+}
+function isJSONObject(data) {
+    return typeof data === 'object' && data !== null && !Array.isArray(data);
+}
+function resolveFromCwd(maybePath) {
+    return node_path_1.default.isAbsolute(maybePath) ? maybePath : node_path_1.default.resolve(process.cwd(), maybePath);
+}
+function getDefaultTemplateDir() {
+    // 源码在 src/，构建后在 dist/，两者都能通过 ../swagger-template 指向包根目录模板
+    return node_path_1.default.resolve(__dirname, '../swagger-template');
+}
+async function generateSwaggerApi(options, isStrapi = false) {
+    const { input, output, templateDir = getDefaultTemplateDir(), baseURL, httpClientPath = '@/utils/request', httpClientType = 'axios', modular = true, cleanOutput = true, unwrapResponseData = true, extractEnums = true, generateUnionEnums = false, onSuccess, } = options;
+    if (typeof baseURL !== 'string' || baseURL.length === 0) {
+        throw new Error('baseURL 必须是非空字符串');
+    }
+    const outputDir = resolveFromCwd(output);
+    const templatesDir = resolveFromCwd(templateDir);
+    let apiConfig = {};
+    if (!input) {
+        const inputPath = isStrapi ? strapiBackendApiPath : process.env.CLIENT_TYPE === 'admin' ? adminBackendApiPath : webBackendApiPath;
+        if (!node_fs_1.default.existsSync(inputPath)) {
+            throw new Error(`未找到默认 OpenAPI 文件：${inputPath}`);
+        }
+        apiConfig = { input: inputPath };
+    }
+    else if (isJSONObject(input)) {
+        apiConfig = { spec: input };
+    }
+    else if (isURL(input)) {
+        apiConfig = { url: input };
+    }
+    else {
+        apiConfig = { input: resolveFromCwd(input) };
+    }
+    const { files } = await (0, swagger_typescript_api_1.generateApi)({
+        output: outputDir,
+        ...apiConfig,
+        httpClientType,
+        modular,
+        cleanOutput,
+        unwrapResponseData,
+        extractEnums,
+        generateUnionEnums,
+        templates: templatesDir,
+        // @ts-expect-error swagger-typescript-api 的类型声明对 httpClient 扩展不完整
+        httpClient: {
+            path: httpClientPath,
+        },
+    });
+    const modules = files
+        .filter((file) => !file.fileName.includes('-'))
+        .map((file) => ({ name: file.fileName }));
+    // 后处理：移除 data-contracts.ts 中的 @ts-nocheck（模板可能会插入）
+    const dataContractsPath = node_path_1.default.join(outputDir, 'data-contracts.ts');
+    if (node_fs_1.default.existsSync(dataContractsPath)) {
+        const content = await node_fs_1.default.promises.readFile(dataContractsPath, 'utf-8');
+        const cleaned = content.replace(/\/\/ @ts-nocheck\n?/, '');
+        await node_fs_1.default.promises.writeFile(dataContractsPath, cleaned, 'utf-8');
+    }
+    const indexTemplate = httpClientType === 'fetch' ? 'index-fetch.ejs' : 'index-axios.ejs';
+    const baseURLCode = JSON.stringify(baseURL);
+    const indexSource = await ejs_1.default.renderFile(node_path_1.default.join(templatesDir, indexTemplate), {
+        modules,
+        baseURL: baseURLCode,
+        httpClientPath,
+    });
+    const indexPath = node_path_1.default.join(outputDir, 'index.ts');
+    await node_fs_1.default.promises.writeFile(indexPath, indexSource, 'utf-8');
+    const result = {
+        outputDir,
+        templatesDir,
+        modules,
+        indexPath,
+        dataContractsPath,
+        files: files,
+    };
+    await onSuccess?.(result);
+    return result;
+}
+//# sourceMappingURL=swagger.js.map

package/dist/swagger.js.map

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

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "fx-spec-hub",
+  "version": "0.0.1",
+  "description": "API 规范中心/控制台",
+  "type": "commonjs",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./bootstrap": {
+      "types": "./dist/bootstrap.d.ts",
+      "import": "./dist/bootstrap.mjs",
+      "require": "./dist/bootstrap.js"
+    }
+  },
+  "bin": {
+    "swagger-admin": "./bin/swagger-admin.js"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "scripts",
+    "swagger-template",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "rimraf dist && tsc -p tsconfig.json && node scripts/postbuild.mjs",
+    "dev": "tsx src/cli.ts",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "dotenv": "^17.3.1",
+    "ejs": "^3.1.10",
+    "minimist": "^1.2.8",
+    "prettier": "^3.6.0",
+    "qs": "^6.14.0",
+    "swagger-typescript-api": "^13.2.0"
+  },
+  "devDependencies": {
+    "@types/ejs": "^3.1.5",
+    "@types/minimist": "^1.2.5",
+    "@types/node": "^22.13.0",
+    "@types/qs": "^6.9.18",
+    "rimraf": "^6.0.1",
+    "tsx": "^4.19.3",
+    "typescript": "^5.8.2"
+  }
+}

package/scripts/postbuild.mjs

@@ -0,0 +1,32 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+
+const distDir = path.resolve(process.cwd(), 'dist');
+const srcEnvDir = path.resolve(process.cwd(), 'src/env');
+const srcDataDir = path.resolve(process.cwd(), 'src/data');
+
+// 为 ESM 使用场景提供真正的 ESM 入口（命名导出可用）。
+// 运行时依然复用 CommonJS 构建产物（dist/index.js）。
+const indexMjs = `
+import cjs from './index.js';
+
+export const generateSwaggerApi = cjs.generateSwaggerApi;
+export const generateStrapiEnums = cjs.generateStrapiEnums;
+
+export default cjs;
+`.trimStart();
+
+await fs.writeFile(path.join(distDir, 'index.mjs'), indexMjs, 'utf-8');
+
+// 为 bootstrap 提供 ESM 入口（用于 import 'swagger-admin/bootstrap' 场景）。
+const bootstrapMjs = `
+import './bootstrap.js';
+`.trimStart();
+
+await fs.writeFile(path.join(distDir, 'bootstrap.mjs'), bootstrapMjs, 'utf-8');
+
+// 将 env 文件复制到 dist/env，供 bootstrap 在运行时读取。
+await fs.cp(srcEnvDir, path.join(distDir, 'env'), { recursive: true });
+
+// 将默认 OpenAPI JSON 复制到 dist/data，供 generateSwaggerApi 在未传 input 时使用。
+await fs.cp(srcDataDir, path.join(distDir, 'data'), { recursive: true });

package/swagger-template/api.ejs

@@ -0,0 +1,30 @@
+<%
+const { utils, route, config, modelTypes } = it;
+const { _, pascalCase, require } = utils;
+const apiClassName = pascalCase(route.moduleName);
+const routes = route.routes;
+const dataContracts = _.map(modelTypes, "name");
+%>
+
+<% if (config.httpClientType === config.constants.HTTP_CLIENT.AXIOS) { %>
+import { useRequest } from 'ahooks';
+import { Options } from '@/types/useRequest';
+import type { AxiosRequestConfig, AxiosResponse } from "axios"; <% } %>
+import { HttpClient, RequestParams, ContentType, HttpResponse } from "<%= config.httpClient.path %>";
+<% if (dataContracts.length) { %>
+import { <%~ dataContracts.join(", ") %>, DataType, DataTypeWrap } from "./<%~ config.fileNames.dataContracts %>"
+<% } %>
+
+export class <%= apiClassName %><SecurityDataType = unknown><% if (!config.singleHttpClient) { %> extends HttpClient<SecurityDataType> <% } %> {
+<% if(config.singleHttpClient) { %>
+  http: HttpClient<SecurityDataType>;
+
+  constructor (http: HttpClient<SecurityDataType>) {
+    this.http = http;
+  }
+<% } %>
+
+    <% for (const route of routes) { %>
+        <%~ includeFile('./procedure-call.ejs', { ...it, route }) %>
+    <% } %>
+}

package/swagger-template/data-contract-jsdoc.ejs

@@ -0,0 +1,37 @@
+<%
+const { data, utils } = it;
+const { formatDescription, require, _ } = utils;
+
+const stringify = (value) => _.isObject(value) ? JSON.stringify(value) : _.isString(value) ? `"${value}"` : value
+
+const jsDocLines = _.compact([
+    data.title,
+    data.description && formatDescription(data.description),
+    !_.isUndefined(data.deprecated) && data.deprecated && '@deprecated',
+    !_.isUndefined(data.format) && `@format ${data.format}`,
+    !_.isUndefined(data.minimum) && `@min ${data.minimum}`,
+    !_.isUndefined(data.multipleOf) && `@multipleOf ${data.multipleOf}`,
+    !_.isUndefined(data.exclusiveMinimum) && `@exclusiveMin ${data.exclusiveMinimum}`,
+    !_.isUndefined(data.maximum) && `@max ${data.maximum}`,
+    !_.isUndefined(data.minLength) && `@minLength ${data.minLength}`,
+    !_.isUndefined(data.maxLength) && `@maxLength ${data.maxLength}`,
+    !_.isUndefined(data.exclusiveMaximum) && `@exclusiveMax ${data.exclusiveMaximum}`,
+    !_.isUndefined(data.maxItems) && `@maxItems ${data.maxItems}`,
+    !_.isUndefined(data.minItems) && `@minItems ${data.minItems}`,
+    !_.isUndefined(data.uniqueItems) && `@uniqueItems ${data.uniqueItems}`,
+    !_.isUndefined(data.default) && `@default ${stringify(data.default)}`,
+    !_.isUndefined(data.pattern) && `@pattern ${data.pattern}`,
+    !_.isUndefined(data.example) && `@example ${stringify(data.example)}`
+]).join('\n').split('\n');
+%>
+<% if (jsDocLines.every(_.isEmpty)) { %>
+<% } else if (jsDocLines.length === 1) { %>
+/** <%~ jsDocLines[0] %> */
+<% } else if (jsDocLines.length) { %>
+/**
+<% for (jsDocLine of jsDocLines) { %>
+ * <%~ jsDocLine %>
+
+<% } %>
+ */
+<% } %>