@lark-apaas/coding-preset-vite-react 1.0.13-alpha.0 → 1.0.13-alpha.10

package/lib/server-log/openapi/utils.js.map

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

package/lib/server-log/register.d.ts

@@ -0,0 +1,34 @@
+import type { Middleware, MiddlewareContext, ExpressApp, ViteMiddleware } from './types';
+/**
+ * Register middlewares for Express-compatible servers or Vite.
+ *
+ * MUST stay synchronous (no async/await).
+ *
+ * Why: when called from webpack/rspack-dev-server's `setupMiddlewares` callback,
+ * any `await` here yields a microtask, allowing dev-server to finish registering
+ * its own built-ins (proxy, historyApiFallback, serveStatic, ...) BEFORE our
+ * later iterations run. The first router lands before historyApiFallback while
+ * subsequent routers land after — causing extensionless GETs (e.g. `/dev/openapi/spec`
+ * with a wildcard Accept header) to be rewritten to `/index.html`. All registered work
+ * (`server.use`, `createRouter`, `createHandler`) is sync, so async/await is also
+ * unnecessary.
+ *
+ * @example
+ * ```typescript
+ * // In rspack/webpack setupMiddlewares
+ * setupMiddlewares: (middlewares, devServer) => {
+ *   if (devServer.app) {
+ *     registerMiddlewares(devServer.app, [
+ *       createDevLogsMiddleware({ logDir: './logs' }),
+ *       createOpenapiMiddleware({ openapiFilePath: './openapi.json' })
+ *     ], { basePath: '/api', isDev: true, rootDir: __dirname });
+ *   }
+ *   return middlewares;
+ * }
+ * ```
+ */
+export declare function registerMiddlewares(server: ExpressApp | ViteMiddleware, middlewares: Middleware[], options?: Partial<MiddlewareContext>): void;
+export type { Middleware, RouteMiddleware, GlobalMiddleware, MiddlewareContext, RouteInfo, } from './types';
+export { createDevLogsMiddleware } from './dev-logs';
+export { sendJson, sendError, sendSuccess, getQuery, getQueryParam } from './compat';
+//# sourceMappingURL=register.d.ts.map

package/lib/server-log/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../src/server-log/register.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,UAAU,EAGV,iBAAiB,EACjB,UAAU,EACV,cAAc,EACf,MAAM,SAAS,CAAC;AAmIjB;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,UAAU,GAAG,cAAc,EACnC,WAAW,EAAE,UAAU,EAAE,EACzB,OAAO,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GACnC,IAAI,CAsDN;AAGD,YAAY,EACV,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,SAAS,GACV,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAErD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC"}

package/lib/server-log/register.js

@@ -0,0 +1,196 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getQueryParam = exports.getQuery = exports.sendSuccess = exports.sendError = exports.sendJson = exports.createDevLogsMiddleware = void 0;
+exports.registerMiddlewares = registerMiddlewares;
+const node_path_1 = __importDefault(require("node:path"));
+/**
+ * Enhance Request/Response objects with Express-compatible methods
+ * This allows middleware written for Express to work with Vite/Connect
+ */
+function enhanceForCompat(req, res) {
+    // Enhance Response with Express-like methods
+    if (!res.status) {
+        res.status = function (code) {
+            res.statusCode = code;
+            return res;
+        };
+    }
+    if (!res.json) {
+        res.json = function (data) {
+            res.setHeader('Content-Type', 'application/json');
+            res.end(JSON.stringify(data));
+            return res;
+        };
+    }
+    if (!res.send) {
+        res.send = function (data) {
+            if (typeof data === 'object' && data !== null) {
+                res.setHeader('Content-Type', 'application/json');
+                res.end(JSON.stringify(data));
+            }
+            else {
+                res.end(String(data));
+            }
+            return res;
+        };
+    }
+    // Enhance Request with parsed query
+    if (!req.query) {
+        const url = new URL(req.url || '', `http://${req.headers.host || 'localhost'}`);
+        req.query = Object.fromEntries(url.searchParams.entries());
+    }
+}
+/**
+ * Detect if the server is a Connect/Vite middleware server (not Express)
+ * Connect servers don't have Express-specific methods like 'set' or 'engine'
+ */
+function isConnectServer(server) {
+    return (typeof server === 'function' &&
+        !('set' in server) &&
+        !('engine' in server));
+}
+/**
+ * Type guard to check if middleware is route-based
+ */
+function isRouteMiddleware(middleware) {
+    return 'createRouter' in middleware && middleware.createRouter !== undefined;
+}
+/**
+ * Type guard to check if middleware is global
+ */
+function isGlobalMiddleware(middleware) {
+    return 'createHandler' in middleware && middleware.createHandler !== undefined;
+}
+/**
+ * Compute the full mount path by combining basePath and middleware mountPath
+ */
+function computeMountPath(basePath, mountPath) {
+    const routePath = node_path_1.default.posix.join(basePath, mountPath);
+    return routePath.startsWith('/') ? routePath : `/${routePath}`;
+}
+/**
+ * Log middleware registration with routes info
+ */
+function logMiddlewareRegistration(middleware, fullMountPath) {
+    if (middleware.routes && middleware.routes.length > 0) {
+        console.log(`[Middleware] Registered: ${middleware.name} at ${fullMountPath}`);
+        middleware.routes.forEach((route) => {
+            const routePath = route.path === '/' ? fullMountPath : node_path_1.default.posix.join(fullMountPath, route.path);
+            console.log(`  ${route.method} ${routePath} - ${route.description}`);
+        });
+    }
+    else {
+        console.log(`[Middleware] Registered: ${middleware.name} at ${fullMountPath}`);
+    }
+}
+// MUST stay synchronous. See note on `registerMiddlewares` below.
+function registerRouteMiddleware(server, middleware, context) {
+    if (!middleware.mountPath) {
+        console.error(`[Middleware] ${middleware.name}: Route middleware must have mountPath. Skipping.`);
+        return;
+    }
+    const router = middleware.createRouter(context);
+    const fullMountPath = computeMountPath(context.basePath, middleware.mountPath);
+    server.use(fullMountPath, router);
+    logMiddlewareRegistration(middleware, fullMountPath);
+}
+// MUST stay synchronous. See note on `registerMiddlewares` below.
+function registerGlobalMiddleware(server, middleware, context) {
+    if (middleware.mountPath) {
+        console.warn(`[Middleware] ${middleware.name}: Global middleware should not have mountPath. ` +
+            `Ignoring mountPath "${middleware.mountPath}".`);
+    }
+    const handler = middleware.createHandler(context);
+    server.use(handler);
+    console.log(`[Middleware] Registered global: ${middleware.name}`);
+}
+/**
+ * Register middlewares for Express-compatible servers or Vite.
+ *
+ * MUST stay synchronous (no async/await).
+ *
+ * Why: when called from webpack/rspack-dev-server's `setupMiddlewares` callback,
+ * any `await` here yields a microtask, allowing dev-server to finish registering
+ * its own built-ins (proxy, historyApiFallback, serveStatic, ...) BEFORE our
+ * later iterations run. The first router lands before historyApiFallback while
+ * subsequent routers land after — causing extensionless GETs (e.g. `/dev/openapi/spec`
+ * with a wildcard Accept header) to be rewritten to `/index.html`. All registered work
+ * (`server.use`, `createRouter`, `createHandler`) is sync, so async/await is also
+ * unnecessary.
+ *
+ * @example
+ * ```typescript
+ * // In rspack/webpack setupMiddlewares
+ * setupMiddlewares: (middlewares, devServer) => {
+ *   if (devServer.app) {
+ *     registerMiddlewares(devServer.app, [
+ *       createDevLogsMiddleware({ logDir: './logs' }),
+ *       createOpenapiMiddleware({ openapiFilePath: './openapi.json' })
+ *     ], { basePath: '/api', isDev: true, rootDir: __dirname });
+ *   }
+ *   return middlewares;
+ * }
+ * ```
+ */
+function registerMiddlewares(server, middlewares, options) {
+    // Build context with defaults
+    const context = {
+        basePath: '/',
+        isDev: process.env.NODE_ENV !== 'production',
+        rootDir: process.cwd(),
+        ...options,
+    };
+    // If running in Connect/Vite environment, register compatibility middleware first
+    // This adds Express-like methods (res.status, res.json, req.query) to the request/response
+    if (isConnectServer(server)) {
+        server.use((req, res, next) => {
+            enhanceForCompat(req, res);
+            next();
+        });
+        console.log('[Middleware] Registered Express compatibility layer for Connect/Vite');
+    }
+    // 合并默认中间件和用户提供的中间件
+    const allMiddlewares = [...middlewares];
+    for (const middleware of allMiddlewares) {
+        // Check if middleware should be enabled
+        if (middleware.enabled && !middleware.enabled(context)) {
+            continue;
+        }
+        try {
+            // Check if both createRouter and createHandler are provided (type-unsafe case)
+            const hasCreateRouter = 'createRouter' in middleware && typeof middleware.createRouter === 'function';
+            const hasCreateHandler = 'createHandler' in middleware && typeof middleware.createHandler === 'function';
+            if (hasCreateRouter && hasCreateHandler) {
+                console.warn(`[Middleware] ${middleware.name}: Both createRouter and createHandler provided. ` +
+                    `Using createRouter and ignoring createHandler.`);
+            }
+            if (isRouteMiddleware(middleware)) {
+                registerRouteMiddleware(server, middleware, context);
+            }
+            else if (isGlobalMiddleware(middleware)) {
+                registerGlobalMiddleware(server, middleware, context);
+            }
+            else {
+                // Type-unsafe middleware that has neither createRouter nor createHandler
+                console.error(`[Middleware] ${middleware.name || 'unknown'}: Must provide either createRouter or createHandler.`);
+            }
+        }
+        catch (error) {
+            console.error(`[Middleware] Failed to register ${middleware.name}:`, error);
+        }
+    }
+}
+// openapi / collect-logs middleware 没搬过来 (preset 用不到), 只保留 dev-logs
+var dev_logs_1 = require("./dev-logs");
+Object.defineProperty(exports, "createDevLogsMiddleware", { enumerable: true, get: function () { return dev_logs_1.createDevLogsMiddleware; } });
+// Export compat utilities for controllers that want to explicitly use them
+var compat_1 = require("./compat");
+Object.defineProperty(exports, "sendJson", { enumerable: true, get: function () { return compat_1.sendJson; } });
+Object.defineProperty(exports, "sendError", { enumerable: true, get: function () { return compat_1.sendError; } });
+Object.defineProperty(exports, "sendSuccess", { enumerable: true, get: function () { return compat_1.sendSuccess; } });
+Object.defineProperty(exports, "getQuery", { enumerable: true, get: function () { return compat_1.getQuery; } });
+Object.defineProperty(exports, "getQueryParam", { enumerable: true, get: function () { return compat_1.getQueryParam; } });
+//# sourceMappingURL=register.js.map

package/lib/server-log/register.js.map

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

package/lib/server-log/types.d.ts

@@ -0,0 +1,99 @@
+import type { Application, Router, RequestHandler } from 'express';
+/**
+ * Shared context passed to all middlewares
+ */
+export interface MiddlewareContext {
+    /** Base path for the application (e.g., '/', '/app') */
+    basePath: string;
+    /** Whether running in development mode */
+    isDev: boolean;
+    /** Root directory of the project */
+    rootDir: string;
+    /** Additional custom options */
+    [key: string]: any;
+}
+/**
+ * Express-compatible app (rspack/webpack dev server)
+ */
+export type ExpressApp = Application;
+/**
+ * Vite-compatible middleware handler (Connect server)
+ * Using 'any' to avoid dependency on vite types
+ */
+export type ViteMiddleware = any;
+/**
+ * Route registration info for better visibility
+ */
+export interface RouteInfo {
+    /** HTTP method (GET, POST, etc.) or '*' for all methods */
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'ALL' | '*';
+    /** Route path (relative to mount point) */
+    path: string;
+    /** Description of what this route does */
+    description: string;
+}
+/**
+ * Route-based middleware
+ * Mounts a router at a specific path
+ */
+export interface RouteMiddleware {
+    /** Unique name for this middleware */
+    name: string;
+    /**
+     * Mount path for this middleware (relative to basePath)
+     * e.g., '/dev/logs', '/openapi.json'
+     * Required for route-based middlewares
+     */
+    mountPath: string;
+    /**
+     * List of routes provided by this middleware
+     * Useful for debugging and documentation
+     */
+    routes?: RouteInfo[];
+    /**
+     * Determine if this middleware should be enabled
+     * @param context - Shared context
+     * @returns true if middleware should be registered
+     */
+    enabled?: (context: MiddlewareContext) => boolean;
+    /**
+     * Create router for this middleware
+     * @param context - Shared context
+     * @returns Express Router
+     */
+    createRouter: (context: MiddlewareContext) => Router;
+    /** Explicitly disallow createHandler for route middleware */
+    createHandler?: never;
+}
+/**
+ * Global middleware
+ * Applies to all requests without a specific mount path
+ */
+export interface GlobalMiddleware {
+    /** Unique name for this middleware */
+    name: string;
+    /**
+     * Global middlewares should not have a mount path
+     * If you need path-specific behavior, use RouteMiddleware instead
+     */
+    mountPath?: never;
+    /**
+     * Determine if this middleware should be enabled
+     * @param context - Shared context
+     * @returns true if middleware should be registered
+     */
+    enabled?: (context: MiddlewareContext) => boolean;
+    /**
+     * Create handler for this middleware
+     * @param context - Shared context
+     * @returns Express request handler
+     */
+    createHandler: (context: MiddlewareContext) => RequestHandler;
+    /** Explicitly disallow createRouter for global middleware */
+    createRouter?: never;
+}
+/**
+ * Middleware can be either route-based or global
+ */
+export type Middleware = RouteMiddleware | GlobalMiddleware;
+//# sourceMappingURL=types.d.ts.map

package/lib/server-log/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/server-log/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,KAAK,EAAE,OAAO,CAAC;IACf,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC;AAErC;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,GAAG,CAAC;AAEjC;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,2DAA2D;IAC3D,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,KAAK,GAAG,GAAG,CAAC;IAClE,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IAEb;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IAErB;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC;IAElD;;;;OAIG;IACH,YAAY,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,MAAM,CAAC;IAErD,6DAA6D;IAC7D,aAAa,CAAC,EAAE,KAAK,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,SAAS,CAAC,EAAE,KAAK,CAAC;IAElB;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC;IAElD;;;;OAIG;IACH,aAAa,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,cAAc,CAAC;IAE9D,6DAA6D;IAC7D,YAAY,CAAC,EAAE,KAAK,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,eAAe,GAAG,gBAAgB,CAAC"}

package/lib/server-log/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/lib/server-log/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/server-log/types.ts"],"names":[],"mappings":""}

package/lib/utils/local-dev.d.ts

@@ -0,0 +1,46 @@
+/**
+ * 本地开发总开关。
+ *
+ * 由 `dev-local.sh`(平台 CLI `miaoda app sync` 同步到项目)export `MIAODA_LOCAL_DEV=1`。
+ * 沙箱 dev / 生产都不设此 env,所以本地专属逻辑(view-context 占位填充、__runtime__ 反代沙箱)
+ * 只在用户本机 `npm run dev:local` 时启用,沙箱 / 生产行为完全不受影响。
+ */
+export declare function isLocalDev(): boolean;
+/**
+ * 反代沙箱时的认证组装。两条入口：
+ *   - 新流（推荐）：env `FORCE_AUTHN_PREVIEW_SESSION_ID` —— 后端下发的单值 session（实际是
+ *     X-Force-Runtime-Session 的值）。SDK 自动拼 cookie，suda-csrf-token 用本地常量。
+ *   - 老流（兼容）：env `SANDBOX_COOKIE` —— 用户从浏览器手抠的完整 cookie 字符串（包含
+ *     X-Force-Runtime-Session / suda-csrf-token / suda_web_did 等）。原样透传，suda-csrf-token
+ *     从其中正则提取作为出向 x-suda-csrf-token header。
+ *
+ * 两个都给的话 `SANDBOX_COOKIE` 优先（"已显式拼好"信号更强）。两个都缺的话返回空字符串
+ * （local dev 跑不通，但不抛错——交给上层 `localDev && sandboxBase` 条件兜底）。
+ */
+export declare function composeSandboxOutboundAuth(): {
+    cookie: string;
+    csrfToken: string;
+};
+/**
+ * 解析沙箱反代的 target origin。两条入口：
+ *   - 新流（推荐）：env `MIAODA_DEV_PLATFORM_BASE` —— 后端下发的完整 URL，**可能带路径前缀**
+ *     （例如 `https://ai-tenant-<app>-<sandbox>.aiforce-boe-preview.bytedance.net/app/<app>`）。
+ *     SDK 抽 `new URL(...).origin` 拿 host，扔掉路径——避免反代 target 双前缀。
+ *   - 老流（兼容）：env `SANDBOX_COOKIE` 配套用的 `SANDBOX_PUBLIC_URL`（用户从沙箱信息手抠 host）。
+ *
+ * 两个都给的话 `MIAODA_DEV_PLATFORM_BASE` 优先。两个都缺的话返回空字符串
+ * （local dev 跑不通，但不抛错——交给上层 `localDev && sandboxBase` 条件兜底）。
+ */
+export declare function resolveSandboxOrigin(): string;
+/**
+ * 解析 `process.env.SUDA_WEBUSER`，容忍沙箱下发的 shell-quoted JSON。
+ *
+ * 沙箱 env pull 下发到 .env.local 的 SUDA_WEBUSER 是双引号包裹 + 内部 `\"` 转义；
+ * dotenv@17 剥外层引号后**不还原**内部 `\"`，导致 `process.env.SUDA_WEBUSER` 是
+ * `{\"user_id\":\"...\"}` 这种带反斜杠的字符串，直接 JSON.parse 会挂在
+ * `Expected property name or '}' in JSON at position 1`。
+ *
+ * 容错：先直接 parse；失败再 unescape `\"` 后 parse；都失败返回 null。
+ */
+export declare function parseSudaWebUserEnv<T = unknown>(raw: string | undefined): T | null;
+//# sourceMappingURL=local-dev.d.ts.map

package/lib/utils/local-dev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-dev.d.ts","sourceRoot":"","sources":["../../src/utils/local-dev.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAIpC;AAKD;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,IAAI;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAclF;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAU7C;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,CAAC,GAAG,IAAI,CAYlF"}

package/lib/utils/local-dev.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isLocalDev = isLocalDev;
+exports.composeSandboxOutboundAuth = composeSandboxOutboundAuth;
+exports.resolveSandboxOrigin = resolveSandboxOrigin;
+exports.parseSudaWebUserEnv = parseSudaWebUserEnv;
+/**
+ * 本地开发总开关。
+ *
+ * 由 `dev-local.sh`(平台 CLI `miaoda app sync` 同步到项目)export `MIAODA_LOCAL_DEV=1`。
+ * 沙箱 dev / 生产都不设此 env,所以本地专属逻辑(view-context 占位填充、__runtime__ 反代沙箱)
+ * 只在用户本机 `npm run dev:local` 时启用,沙箱 / 生产行为完全不受影响。
+ */
+function isLocalDev() {
+    if (process.env.NODE_ENV === 'production')
+        return false;
+    const flag = process.env.MIAODA_LOCAL_DEV;
+    return flag === '1' || flag === 'true';
+}
+/** 本地常量 csrf token —— sandbox 是 double-submit 模式（cookie===header 即放行），本地随便定一个一致值即可。 */
+const LOCAL_CSRF_TOKEN = 'local-dev-csrf';
+/**
+ * 反代沙箱时的认证组装。两条入口：
+ *   - 新流（推荐）：env `FORCE_AUTHN_PREVIEW_SESSION_ID` —— 后端下发的单值 session（实际是
+ *     X-Force-Runtime-Session 的值）。SDK 自动拼 cookie，suda-csrf-token 用本地常量。
+ *   - 老流（兼容）：env `SANDBOX_COOKIE` —— 用户从浏览器手抠的完整 cookie 字符串（包含
+ *     X-Force-Runtime-Session / suda-csrf-token / suda_web_did 等）。原样透传，suda-csrf-token
+ *     从其中正则提取作为出向 x-suda-csrf-token header。
+ *
+ * 两个都给的话 `SANDBOX_COOKIE` 优先（"已显式拼好"信号更强）。两个都缺的话返回空字符串
+ * （local dev 跑不通，但不抛错——交给上层 `localDev && sandboxBase` 条件兜底）。
+ */
+function composeSandboxOutboundAuth() {
+    const legacyCookie = process.env.SANDBOX_COOKIE;
+    if (legacyCookie) {
+        const m = legacyCookie.match(/(?:^|;\s*)suda-csrf-token=([^;]+)/i);
+        return { cookie: legacyCookie, csrfToken: m ? m[1] : '' };
+    }
+    const sessionId = process.env.FORCE_AUTHN_PREVIEW_SESSION_ID;
+    if (sessionId) {
+        return {
+            cookie: `X-Force-Runtime-Session=${sessionId}; suda-csrf-token=${LOCAL_CSRF_TOKEN}`,
+            csrfToken: LOCAL_CSRF_TOKEN,
+        };
+    }
+    return { cookie: '', csrfToken: '' };
+}
+/**
+ * 解析沙箱反代的 target origin。两条入口：
+ *   - 新流（推荐）：env `MIAODA_DEV_PLATFORM_BASE` —— 后端下发的完整 URL，**可能带路径前缀**
+ *     （例如 `https://ai-tenant-<app>-<sandbox>.aiforce-boe-preview.bytedance.net/app/<app>`）。
+ *     SDK 抽 `new URL(...).origin` 拿 host，扔掉路径——避免反代 target 双前缀。
+ *   - 老流（兼容）：env `SANDBOX_COOKIE` 配套用的 `SANDBOX_PUBLIC_URL`（用户从沙箱信息手抠 host）。
+ *
+ * 两个都给的话 `MIAODA_DEV_PLATFORM_BASE` 优先。两个都缺的话返回空字符串
+ * （local dev 跑不通，但不抛错——交给上层 `localDev && sandboxBase` 条件兜底）。
+ */
+function resolveSandboxOrigin() {
+    const platformBase = process.env.MIAODA_DEV_PLATFORM_BASE;
+    if (platformBase) {
+        try {
+            return new URL(platformBase).origin;
+        }
+        catch {
+            // 非合法 URL → 回落到 legacy
+        }
+    }
+    return process.env.SANDBOX_PUBLIC_URL || '';
+}
+/**
+ * 解析 `process.env.SUDA_WEBUSER`，容忍沙箱下发的 shell-quoted JSON。
+ *
+ * 沙箱 env pull 下发到 .env.local 的 SUDA_WEBUSER 是双引号包裹 + 内部 `\"` 转义；
+ * dotenv@17 剥外层引号后**不还原**内部 `\"`，导致 `process.env.SUDA_WEBUSER` 是
+ * `{\"user_id\":\"...\"}` 这种带反斜杠的字符串，直接 JSON.parse 会挂在
+ * `Expected property name or '}' in JSON at position 1`。
+ *
+ * 容错：先直接 parse；失败再 unescape `\"` 后 parse；都失败返回 null。
+ */
+function parseSudaWebUserEnv(raw) {
+    if (!raw)
+        return null;
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        // fall through to unescape attempt
+    }
+    try {
+        return JSON.parse(raw.replace(/\\"/g, '"'));
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=local-dev.js.map

package/lib/utils/local-dev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-dev.js","sourceRoot":"","sources":["../../src/utils/local-dev.ts"],"names":[],"mappings":";;AAOA,gCAIC;AAgBD,gEAcC;AAYD,oDAUC;AAYD,kDAYC;AAvFD;;;;;;GAMG;AACH,SAAgB,UAAU;IACxB,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY;QAAE,OAAO,KAAK,CAAC;IACxD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAC1C,OAAO,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,MAAM,CAAC;AACzC,CAAC;AAED,uFAAuF;AACvF,MAAM,gBAAgB,GAAG,gBAAgB,CAAC;AAE1C;;;;;;;;;;GAUG;AACH,SAAgB,0BAA0B;IACxC,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAChD,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACnE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAC5D,CAAC;IACD,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC;IAC7D,IAAI,SAAS,EAAE,CAAC;QACd,OAAO;YACL,MAAM,EAAE,2BAA2B,SAAS,qBAAqB,gBAAgB,EAAE;YACnF,SAAS,EAAE,gBAAgB;SAC5B,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;AACvC,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,oBAAoB;IAClC,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC;IAC1D,IAAI,YAAY,EAAE,CAAC;QACjB,IAAI,CAAC;YACH,OAAO,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC;QACtC,CAAC;QAAC,MAAM,CAAC;YACP,uBAAuB;QACzB,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,EAAE,CAAC;AAC9C,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,mBAAmB,CAAc,GAAuB;IACtE,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,mCAAmC;IACrC,CAAC;IACD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAM,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/lib/utils/proxy-error.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Dev server proxy 错误处理 —— nest hot reload 友好的等待 + 重试 + 重定向。
+ *
+ * 场景：fullstack 形态下 vite (8080) proxy 转发到 nest (3000)。user 改 server 代码
+ * 时 nest --watch 重新编译 + 重启,1~3 秒窗口期内 nest 没在 listen,vite proxy 收到
+ * ECONNREFUSED → 之前直接给浏览器抛 502 JSON("Backend service is not running"),
+ * user 看到黑屏。
+ *
+ * 实现搬自 `@lark-apaas/fullstack-toolkits` 的 handleDevProxyError (内联避免新跨包
+ * 依赖)。逻辑跟 fullstack-vite-preset 老版本保持一致。
+ *
+ * 处理策略：
+ *   1. **连接错误**(ECONNREFUSED / ECONNRESET / ETIMEDOUT / ENOTFOUND / ENETUNREACH)
+ *      → 服务可能在热重启,轮询 nest /  最多等 retryTimeout 毫秒
+ *      → 恢复了 sendRedirect 302 让浏览器重发原请求(无感)
+ *      → 超时仍未恢复才回 502
+ *   2. **其他错误**(socket hang up / 协议错等)→ 立即 502,没必要等
+ */
+import type { IncomingMessage, ServerResponse } from 'node:http';
+export interface ProxyErrorOptions {
+    /** 等待服务重启的超时时间（毫秒），默认 5000ms */
+    retryTimeout?: number;
+    /** 轮询检查服务的间隔时间（毫秒），默认 500ms */
+    retryInterval?: number;
+    /** 目标服务器地址，用于检查服务是否恢复，格式：http://localhost:3000 */
+    target?: string;
+}
+export declare function handleDevProxyError(err: Error, req: IncomingMessage, res: ServerResponse, options?: ProxyErrorOptions): void;
+//# sourceMappingURL=proxy-error.d.ts.map

package/lib/utils/proxy-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy-error.d.ts","sourceRoot":"","sources":["../../src/utils/proxy-error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEjE,MAAM,WAAW,iBAAiB;IAChC,gCAAgC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAqFD,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,KAAK,EACV,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,IAAI,CAmCN"}