data-preheating-astro 0.1.2 → 0.1.3

package/README.md

@@ -16,13 +16,14 @@
 
 所有环境变量均可不设置，项目会使用默认值；但当存在启用 i18n 的模块时，建议明确设置语言列表。
 
-- `EXPORT_BASE_URL`：Strapi 基础地址，例如 `https://example.com`
+- `PUBLIC_API_URL`：Strapi 基础地址，例如 `https://example.com`
 - `EXPORT_API_TOKEN`：可选，若接口需要鉴权则使用 `Authorization: Bearer ...`
 - `EXPORT_MAX_CONCURRENCY`：最大并发数，默认 `50`
 - `EXPORT_FAIL_STRATEGY`：失败策略，默认 `fail_fast`；可选 `continue`
 - `EXPORT_LANGS`：多语言列表，例如 `en,zh-Hans`（仅在模块启用 i18n 时使用）
 - `EXPORT_DEFAULT_LANG`：默认语言，默认 `en`
 - `EXPORT_OUTPUT_DIR`：输出目录，默认 `data`
+ - `ITALKIN_API`：Italkin 基础地址，例如 `https://example.com`（用于前置表单接口）
 
 ## 运行
 
@@ -34,6 +35,14 @@ npm run build
 npm run start
 ```
 
+## 在其它项目中使用（作为 CLI 依赖）
+
+当本工具作为依赖安装到其它项目中并通过命令 `strapi-content-exporter` 执行时：
+
+- 运行时会以“目标项目根目录”为当前工作目录（`process.cwd()`）。
+- 会自动尝试读取目标项目根目录下的 `.env` 并注入到环境变量（仅补齐未设置的变量，不覆盖已有值）。
+- 因此建议把 `PUBLIC_API_URL` 等配置写在“目标项目根目录”的 `.env` 中。
+
 ## 模块配置
 
 在 `src/config/modules/` 下为每个 Strapi 接口创建一个模块配置文件，并在 `src/config/app.config.ts` 中引入。

package/dist/cli.js

@@ -17,6 +17,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * - 纯工具函数（如 slug/url_slug 规范化）：放在 `src/transform/`
  * - 本文件只做导出流程编排与串联，尽量避免写具体业务协议细节
  */
+const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const app_config_1 = require("./config/app.config");
 const keywords_1 = require("./config/keywords");
@@ -53,7 +54,16 @@ let httpTrace = null;
  * - 只在“到达阈值”时打印，避免分页过多导致刷屏。
  */
 async function main() {
-    const cfg = (0, app_config_1.loadAppConfig)();
+    loadDotEnvFromCwd();
+    let cfg;
+    try {
+        cfg = (0, app_config_1.loadAppConfig)();
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.error(`配置错误：${msg}`);
+        throw err;
+    }
     // 一键监控开关：EXPORT_MONITOR=0 时关闭过程打印/HTTP trace/统计 CSV。
     const monitor = (0, progress_1.createProgressMonitor)({ enabled: cfg.monitorEnabled });
     const workDirAbs = process.cwd();
@@ -449,6 +459,50 @@ async function fetchPage(combo, start, limit, cfg) {
     }
     return { items, total };
 }
+/**
+ * 从当前工作目录读取 .env 并注入到 process.env（最小实现）。
+ *
+ * 说明：
+ * - 只处理 KEY=VALUE 形式；忽略空行与以 # 开头的注释行
+ * - 支持 `export KEY=VALUE` 形式（兼容部分 shell 风格）
+ * - 不覆盖已存在的环境变量（保持调用方显式传参优先）
+ */
+function loadDotEnvFromCwd() {
+    const envPath = node_path_1.default.join(process.cwd(), ".env");
+    try {
+        if (!node_fs_1.default.existsSync(envPath))
+            return;
+        const text = node_fs_1.default.readFileSync(envPath, "utf8");
+        const lines = text.split(/\r?\n/);
+        for (const raw of lines) {
+            const line = raw.trim();
+            if (!line)
+                continue;
+            if (line.startsWith("#"))
+                continue;
+            const noExport = line.startsWith("export ") ? line.slice("export ".length).trim() : line;
+            const idx = noExport.indexOf("=");
+            if (idx <= 0)
+                continue;
+            const key = noExport.slice(0, idx).trim();
+            if (!key)
+                continue;
+            // 不覆盖调用方已设置的值
+            if (typeof process.env[key] !== "undefined")
+                continue;
+            let value = noExport.slice(idx + 1).trim();
+            // 去掉包裹引号（最小处理，保持简单）
+            if ((value.startsWith('"') && value.endsWith('"') && value.length >= 2) ||
+                (value.startsWith("'") && value.endsWith("'") && value.length >= 2)) {
+                value = value.slice(1, -1);
+            }
+            process.env[key] = value;
+        }
+    }
+    catch {
+        // 读取 .env 失败不应阻断主流程：保持行为简单、可预测
+    }
+}
 main()
     .then(() => {
     // 成功结束已由 monitor.done() 打印，这里无需重复输出。

package/dist/config/app.config.js

@@ -100,9 +100,9 @@ function loadModulesAuto() {
  * 读取环境变量并构建配置。
  */
 function loadAppConfig() {
-    const baseUrl = (process.env.EXPORT_BASE_URL || "").trim();
+    const baseUrl = (process.env.PUBLIC_API_URL || "").trim();
     if (!baseUrl) {
-        throw new Error("缺少 EXPORT_BASE_URL（Strapi 基础地址）");
+        throw new Error("缺少 PUBLIC_API_URL（Strapi 基础地址）");
     }
     const apiToken = (process.env.EXPORT_API_TOKEN || "").trim() || undefined;
     // 监控开关：默认开启；设置 EXPORT_MONITOR=0 可一键关闭监控相关输出与落盘日志。

package/dist/prereq/italkinForm.js

@@ -28,10 +28,10 @@ const output_1 = require("../write/output");
  * - 缺少 companyId/siteId（companies/websites 落盘缺失）属于依赖错误：必须抛错阻断
  */
 async function fetchAndWriteItalkinForm(params) {
-    const baseUrl = (process.env.EXPORT_ITALKIN_API || process.env.ITALKIN_API || "").trim();
+    const baseUrl = (process.env.ITALKIN_API || "").trim();
     // 默认启用：严格校验环境变量，缺失应阻断（构建期关键数据）。
     if (!baseUrl) {
-        throw new Error("缺少 Italkin 接口地址：请设置 EXPORT_ITALKIN_API 或 ITALKIN_API");
+        throw new Error("缺少 Italkin 接口地址：请设置 ITALKIN_API");
     }
     const derived = await resolveItalkinCompanyAndSiteId({ outputDirAbs: params.outputDirAbs });
     if (!derived.companyId || !derived.siteId) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "data-preheating-astro",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "private": false,
   "description": "从 Strapi 并发拉取数据并落盘到 data 目录。",
   "license": "UNLICENSED",