@dofe/infra-common 0.1.1

package/dist/interceptor/version/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./version-header.interceptor"), exports);
+//# sourceMappingURL=index.js.map

package/dist/interceptor/version/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/interceptor/version/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+DAA6C"}

package/dist/interceptor/version/version-header.interceptor.d.ts

@@ -0,0 +1,31 @@
+import { NestInterceptor, ExecutionContext, CallHandler } from '@nestjs/common';
+import { Observable } from 'rxjs';
+/**
+ * Version Header Interceptor
+ * 版本响应头拦截器
+ *
+ * 功能：
+ * 为所有响应添加版本相关的 Header：
+ * - X-API-Version: API 版本号
+ * - X-Server-Build: 后端构建版本
+ *
+ * @example
+ * ```typescript
+ * // 全局注册
+ * app.useGlobalInterceptors(new VersionHeaderInterceptor());
+ *
+ * // 响应头示例
+ * // X-API-Version: 1
+ * // X-Server-Build: 2025.03.18-abcdef-g42
+ * ```
+ */
+export declare class VersionHeaderInterceptor implements NestInterceptor {
+    private readonly serverBuild;
+    constructor();
+    intercept(context: ExecutionContext, next: CallHandler): Observable<any>;
+    /**
+     * 生成开发环境的构建版本
+     */
+    private generateDevBuild;
+}
+//# sourceMappingURL=version-header.interceptor.d.ts.map

package/dist/interceptor/version/version-header.interceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-header.interceptor.d.ts","sourceRoot":"","sources":["../../../src/interceptor/version/version-header.interceptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,eAAe,EACf,gBAAgB,EAChB,WAAW,EACZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAUlC;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBACa,wBAAyB,YAAW,eAAe;IAC9D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;;IAQrC,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,UAAU,CAAC,GAAG,CAAC;IAUxE;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAIzB"}

package/dist/interceptor/version/version-header.interceptor.js

@@ -0,0 +1,62 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VersionHeaderInterceptor = void 0;
+const common_1 = require("@nestjs/common");
+const infra_contracts_1 = require("@dofe/infra-contracts");
+const env_config_service_1 = require("@/config/env-config.service");
+/**
+ * Version Header Interceptor
+ * 版本响应头拦截器
+ *
+ * 功能：
+ * 为所有响应添加版本相关的 Header：
+ * - X-API-Version: API 版本号
+ * - X-Server-Build: 后端构建版本
+ *
+ * @example
+ * ```typescript
+ * // 全局注册
+ * app.useGlobalInterceptors(new VersionHeaderInterceptor());
+ *
+ * // 响应头示例
+ * // X-API-Version: 1
+ * // X-Server-Build: 2025.03.18-abcdef-g42
+ * ```
+ */
+let VersionHeaderInterceptor = class VersionHeaderInterceptor {
+    serverBuild;
+    constructor() {
+        // 从环境变量获取后端构建版本
+        // 格式: YYYY.MM.DD-<hash>-g<generation>
+        this.serverBuild = env_config_service_1.buildConfig.serverBuild || this.generateDevBuild();
+    }
+    intercept(context, next) {
+        const response = context.switchToHttp().getResponse();
+        // 设置版本响应头
+        response.header(infra_contracts_1.API_VERSION_HEADER, infra_contracts_1.API_VERSION_DEFAULT);
+        response.header(infra_contracts_1.SERVER_BUILD_HEADER, this.serverBuild);
+        return next.handle();
+    }
+    /**
+     * 生成开发环境的构建版本
+     */
+    generateDevBuild() {
+        const date = new Date().toISOString().slice(0, 10).replace(/-/g, '.');
+        return `${date}-dev-g${infra_contracts_1.API_GENERATION}`;
+    }
+};
+exports.VersionHeaderInterceptor = VersionHeaderInterceptor;
+exports.VersionHeaderInterceptor = VersionHeaderInterceptor = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [])
+], VersionHeaderInterceptor);
+//# sourceMappingURL=version-header.interceptor.js.map

package/dist/interceptor/version/version-header.interceptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-header.interceptor.js","sourceRoot":"","sources":["../../../src/interceptor/version/version-header.interceptor.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAKwB;AAGxB,2DAK+B;AAC/B,oEAA0D;AAE1D;;;;;;;;;;;;;;;;;;GAkBG;AAEI,IAAM,wBAAwB,GAA9B,MAAM,wBAAwB;IAClB,WAAW,CAAS;IAErC;QACE,gBAAgB;QAChB,sCAAsC;QACtC,IAAI,CAAC,WAAW,GAAG,gCAAW,CAAC,WAAW,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;IACxE,CAAC;IAED,SAAS,CAAC,OAAyB,EAAE,IAAiB;QACpD,MAAM,QAAQ,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,WAAW,EAAgB,CAAC;QAEpE,UAAU;QACV,QAAQ,CAAC,MAAM,CAAC,oCAAkB,EAAE,qCAAmB,CAAC,CAAC;QACzD,QAAQ,CAAC,MAAM,CAAC,qCAAmB,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAEvD,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;IACvB,CAAC;IAED;;OAEG;IACK,gBAAgB;QACtB,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACtE,OAAO,GAAG,IAAI,SAAS,gCAAc,EAAE,CAAC;IAC1C,CAAC;CACF,CAAA;AA1BY,4DAAwB;mCAAxB,wBAAwB;IADpC,IAAA,mBAAU,GAAE;;GACA,wBAAwB,CA0BpC"}

package/dist/middleware/request.middleware.d.ts

@@ -0,0 +1,27 @@
+import { NestMiddleware } from '@nestjs/common';
+import { IncomingMessage, ServerResponse } from 'http';
+import { Logger } from 'winston';
+export declare const TRACE_ID_HEADER = "x-trace-id";
+export declare const clsNamespace: import("cls-hooked").Namespace<Record<string, any>>;
+/**
+ * RequestMiddleware
+ *
+ * 重要说明：在 Fastify 适配器下，NestMiddleware 的 use 方法接收的参数类型
+ * 实际上是原生的 Node.js 对象（IncomingMessage 和 ServerResponse），
+ * 而不是 Fastify 的封装对象（FastifyRequest 和 FastifyReply）。
+ *
+ * 这是因为：
+ * 1. NestJS 中间件接口设计为接收原生对象，以保持与不同 HTTP 框架的兼容性
+ * 2. Fastify 适配器通过 middie 包处理中间件，传递的是原生对象
+ * 3. 虽然类型声明可以使用 FastifyRequest/FastifyReply，但运行时实际是原生对象
+ *
+ * 解决方案：
+ * - 使用泛型参数明确指定类型：NestMiddleware<IncomingMessage, ServerResponse>
+ * - 或者保持 any 类型，在运行时通过类型断言访问 Fastify 特有的属性
+ */
+export default class RequestMiddleware implements NestMiddleware<IncomingMessage, ServerResponse> {
+    private readonly logger;
+    constructor(logger: Logger);
+    use(req: IncomingMessage, res: ServerResponse, next: () => void): Promise<void>;
+}
+//# sourceMappingURL=request.middleware.d.ts.map

package/dist/middleware/request.middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.middleware.d.ts","sourceRoot":"","sources":["../../src/middleware/request.middleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,cAAc,EAEf,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAIvD,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAQjC,eAAO,MAAM,eAAe,eAAe,CAAC;AAE5C,eAAO,MAAM,YAAY,qDAAyB,CAAC;AAcnD;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,CAAC,OAAO,OAAO,iBAAkB,YAAW,cAAc,CAC9D,eAAe,EACf,cAAc,CACf;IAEoC,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,MAAM;IAG5D,GAAG,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,IAAI;CA4CtE"}

package/dist/middleware/request.middleware.js

@@ -0,0 +1,141 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clsNamespace = exports.TRACE_ID_HEADER = void 0;
+const common_1 = require("@nestjs/common");
+const uuid_1 = require("uuid");
+const cls_hooked_1 = require("cls-hooked");
+const nest_winston_1 = require("nest-winston");
+const winston_1 = require("winston");
+const infra_utils_1 = require("@dofe/infra-utils");
+const parser = __importStar(require("accept-language-parser"));
+const ip_util_1 = __importDefault(require("@dofe/infra-utils/ip.util"));
+const environment_util_1 = __importDefault(require("@dofe/infra-utils/environment.util"));
+// Trace ID 请求头名称
+exports.TRACE_ID_HEADER = 'x-trace-id';
+exports.clsNamespace = (0, cls_hooked_1.createNamespace)('app');
+/**
+ * 获取或生成 Trace ID
+ * 优先从请求头获取 (支持分布式追踪)，否则生成新的 UUID
+ */
+function getOrCreateTraceId(req) {
+    const headerTraceId = req.headers[exports.TRACE_ID_HEADER];
+    if (headerTraceId && typeof headerTraceId === 'string') {
+        return headerTraceId;
+    }
+    return (0, uuid_1.v4)();
+}
+/**
+ * RequestMiddleware
+ *
+ * 重要说明：在 Fastify 适配器下，NestMiddleware 的 use 方法接收的参数类型
+ * 实际上是原生的 Node.js 对象（IncomingMessage 和 ServerResponse），
+ * 而不是 Fastify 的封装对象（FastifyRequest 和 FastifyReply）。
+ *
+ * 这是因为：
+ * 1. NestJS 中间件接口设计为接收原生对象，以保持与不同 HTTP 框架的兼容性
+ * 2. Fastify 适配器通过 middie 包处理中间件，传递的是原生对象
+ * 3. 虽然类型声明可以使用 FastifyRequest/FastifyReply，但运行时实际是原生对象
+ *
+ * 解决方案：
+ * - 使用泛型参数明确指定类型：NestMiddleware<IncomingMessage, ServerResponse>
+ * - 或者保持 any 类型，在运行时通过类型断言访问 Fastify 特有的属性
+ */
+let RequestMiddleware = class RequestMiddleware {
+    logger;
+    constructor(logger) {
+        this.logger = logger;
+    }
+    async use(req, res, next) {
+        exports.clsNamespace.bind(req);
+        exports.clsNamespace.bind(res);
+        // 获取或生成 Trace ID (支持分布式追踪)
+        const traceId = getOrCreateTraceId(req);
+        // 添加到请求对象 (便于 Controller/Service 访问)
+        // 注意：在中间件中，req 是原生 IncomingMessage
+        // 但在 Controller 中，可以通过 context.switchToHttp().getRequest<FastifyRequest>() 获取 FastifyRequest
+        req.traceId = traceId;
+        // 添加到响应头 (使用原生 Node.js API)
+        res.setHeader(exports.TRACE_ID_HEADER, traceId);
+        // 解析语言
+        const acceptLanguage = req.headers['accept-language'] || '';
+        const languages = parser.parse(acceptLanguage);
+        let primaryLanguage = languages[0]?.code || 'en';
+        if (!['zh-CN', 'en'].includes(primaryLanguage)) {
+            primaryLanguage = 'en';
+        }
+        req.locale = primaryLanguage;
+        // 提取 IP 地址
+        // 注意：ipUtil.extractIp 期望 FastifyRequest，但中间件中接收的是 IncomingMessage
+        // 这里使用类型断言，因为 IncomingMessage 和 FastifyRequest 在 headers 属性上兼容
+        const realIp = ip_util_1.default.extractIp(req);
+        req.realIp = realIp;
+        exports.clsNamespace.run(() => {
+            exports.clsNamespace.set('traceID', traceId);
+            next();
+            // 记录日志 (包含 traceId)
+            // 注意：getReqMainInfo 期望 FastifyRequest/FastifyReply，但中间件中是原生对象
+            // 使用类型断言以兼容现有函数
+            if (environment_util_1.default.isProduction()) {
+                this.logger.info('RequestMiddleware', {
+                    traceId,
+                    ...(0, infra_utils_1.getReqMainInfo)(req, res),
+                });
+            }
+        });
+    }
+};
+RequestMiddleware = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(nest_winston_1.WINSTON_MODULE_PROVIDER)),
+    __metadata("design:paramtypes", [winston_1.Logger])
+], RequestMiddleware);
+exports.default = RequestMiddleware;
+//# sourceMappingURL=request.middleware.js.map

package/dist/middleware/request.middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.middleware.js","sourceRoot":"","sources":["../../src/middleware/request.middleware.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,2CAKwB;AAGxB,+BAAoC;AACpC,2CAA6C;AAC7C,+CAAuD;AACvD,qCAAiC;AAEjC,mDAAmD;AACnD,+DAAiD;AACjD,wEAA+C;AAC/C,0FAA4D;AAE5D,iBAAiB;AACJ,QAAA,eAAe,GAAG,YAAY,CAAC;AAE/B,QAAA,YAAY,GAAG,IAAA,4BAAe,EAAC,KAAK,CAAC,CAAC;AAEnD;;;GAGG;AACH,SAAS,kBAAkB,CAAC,GAAqC;IAC/D,MAAM,aAAa,GAAG,GAAG,CAAC,OAAO,CAAC,uBAAe,CAAC,CAAC;IACnD,IAAI,aAAa,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;QACvD,OAAO,aAAa,CAAC;IACvB,CAAC;IACD,OAAO,IAAA,SAAM,GAAE,CAAC;AAClB,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AAEY,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;IAKgB;IADpD,YACoD,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAC/D,CAAC;IAEJ,KAAK,CAAC,GAAG,CAAC,GAAoB,EAAE,GAAmB,EAAE,IAAgB;QACnE,oBAAY,CAAC,IAAI,CAAC,GAAU,CAAC,CAAC;QAC9B,oBAAY,CAAC,IAAI,CAAC,GAAU,CAAC,CAAC;QAE9B,2BAA2B;QAC3B,MAAM,OAAO,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;QAExC,qCAAqC;QACrC,mCAAmC;QACnC,6FAA6F;QAC5F,GAAW,CAAC,OAAO,GAAG,OAAO,CAAC;QAE/B,4BAA4B;QAC5B,GAAG,CAAC,SAAS,CAAC,uBAAe,EAAE,OAAO,CAAC,CAAC;QAExC,OAAO;QACP,MAAM,cAAc,GAAG,GAAG,CAAC,OAAO,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC;QAC5D,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QAC/C,IAAI,eAAe,GAAG,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,IAAI,CAAC;QACjD,IAAI,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;YAC/C,eAAe,GAAG,IAAI,CAAC;QACzB,CAAC;QACA,GAAW,CAAC,MAAM,GAAG,eAAe,CAAC;QAEtC,WAAW;QACX,kEAAkE;QAClE,+DAA+D;QAC/D,MAAM,MAAM,GAAG,iBAAM,CAAC,SAAS,CAAC,GAAU,CAAC,CAAC;QAC3C,GAAW,CAAC,MAAM,GAAG,MAAM,CAAC;QAE7B,oBAAY,CAAC,GAAG,CAAC,GAAG,EAAE;YACpB,oBAAY,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACrC,IAAI,EAAE,CAAC;YACP,oBAAoB;YACpB,8DAA8D;YAC9D,gBAAgB;YAChB,IAAI,0BAAU,CAAC,YAAY,EAAE,EAAE,CAAC;gBAC9B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,mBAAmB,EAAE;oBACpC,OAAO;oBACP,GAAG,IAAA,4BAAc,EAAC,GAAU,EAAE,GAAU,CAAC;iBAC1C,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AApDoB,iBAAiB;IADrC,IAAA,mBAAU,GAAE;IAMR,WAAA,IAAA,eAAM,EAAC,sCAAuB,CAAC,CAAA;qCAA0B,gBAAM;GAL/C,iBAAiB,CAoDrC;kBApDoB,iBAAiB"}

package/dist/middleware/tenant-isolation.middleware.d.ts

@@ -0,0 +1,12 @@
+import { NestMiddleware } from '@nestjs/common';
+import { FastifyRequest, FastifyReply } from 'fastify';
+/**
+ * 租户隔离中间件
+ * 强制所有请求携带 tenantId，并注入到请求上下文
+ */
+export declare class TenantIsolationMiddleware implements NestMiddleware {
+    use(req: FastifyRequest, res: FastifyReply, next: () => void): void;
+    private extractTenantId;
+    private userBelongsToTenant;
+}
+//# sourceMappingURL=tenant-isolation.middleware.d.ts.map

package/dist/middleware/tenant-isolation.middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant-isolation.middleware.d.ts","sourceRoot":"","sources":["../../src/middleware/tenant-isolation.middleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,cAAc,EAEf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvD;;;GAGG;AACH,qBACa,yBAA0B,YAAW,cAAc;IAC9D,GAAG,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,IAAI;IAoB5D,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,mBAAmB;CAM5B"}

package/dist/middleware/tenant-isolation.middleware.js

@@ -0,0 +1,51 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TenantIsolationMiddleware = void 0;
+const common_1 = require("@nestjs/common");
+/**
+ * 租户隔离中间件
+ * 强制所有请求携带 tenantId，并注入到请求上下文
+ */
+let TenantIsolationMiddleware = class TenantIsolationMiddleware {
+    use(req, res, next) {
+        // 从 JWT 或请求头获取 tenantId
+        const tenantId = this.extractTenantId(req);
+        if (!tenantId) {
+            throw new common_1.UnauthorizedException('Missing tenantId in request context');
+        }
+        // 验证用户是否属于该租户
+        const user = req.user;
+        if (user && !this.userBelongsToTenant(user, tenantId)) {
+            throw new common_1.UnauthorizedException('Access denied to this tenant');
+        }
+        // 注入 tenantId 到请求对象
+        req.tenantId = tenantId;
+        next();
+    }
+    extractTenantId(req) {
+        // 1. 从请求头获取
+        const headerTenantId = req.headers['x-tenant-id'];
+        if (headerTenantId)
+            return headerTenantId;
+        // 2. 从 JWT 用户信息获取
+        const user = req.user;
+        if (user?.currentTenantId)
+            return user.currentTenantId;
+        return null;
+    }
+    userBelongsToTenant(user, tenantId) {
+        // 检查用户是否属于该租户
+        return (user.tenants?.includes(tenantId) || user.currentTenantId === tenantId);
+    }
+};
+exports.TenantIsolationMiddleware = TenantIsolationMiddleware;
+exports.TenantIsolationMiddleware = TenantIsolationMiddleware = __decorate([
+    (0, common_1.Injectable)()
+], TenantIsolationMiddleware);
+//# sourceMappingURL=tenant-isolation.middleware.js.map

package/dist/middleware/tenant-isolation.middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant-isolation.middleware.js","sourceRoot":"","sources":["../../src/middleware/tenant-isolation.middleware.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAIwB;AAGxB;;;GAGG;AAEI,IAAM,yBAAyB,GAA/B,MAAM,yBAAyB;IACpC,GAAG,CAAC,GAAmB,EAAE,GAAiB,EAAE,IAAgB;QAC1D,wBAAwB;QACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;QAE3C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,8BAAqB,CAAC,qCAAqC,CAAC,CAAC;QACzE,CAAC;QAED,cAAc;QACd,MAAM,IAAI,GAAI,GAAW,CAAC,IAAI,CAAC;QAC/B,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC;YACtD,MAAM,IAAI,8BAAqB,CAAC,8BAA8B,CAAC,CAAC;QAClE,CAAC;QAED,oBAAoB;QACnB,GAAW,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAEjC,IAAI,EAAE,CAAC;IACT,CAAC;IAEO,eAAe,CAAC,GAAmB;QACzC,YAAY;QACZ,MAAM,cAAc,GAAG,GAAG,CAAC,OAAO,CAAC,aAAa,CAAW,CAAC;QAC5D,IAAI,cAAc;YAAE,OAAO,cAAc,CAAC;QAE1C,kBAAkB;QAClB,MAAM,IAAI,GAAI,GAAW,CAAC,IAAI,CAAC;QAC/B,IAAI,IAAI,EAAE,eAAe;YAAE,OAAO,IAAI,CAAC,eAAe,CAAC;QAEvD,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,mBAAmB,CAAC,IAAS,EAAE,QAAgB;QACrD,cAAc;QACd,OAAO,CACL,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,eAAe,KAAK,QAAQ,CACtE,CAAC;IACJ,CAAC;CACF,CAAA;AAvCY,8DAAyB;oCAAzB,yBAAyB;IADrC,IAAA,mBAAU,GAAE;GACA,yBAAyB,CAuCrC"}

package/dist/pipes/transform-root.pipe.d.ts

@@ -0,0 +1,5 @@
+import { PipeTransform, ArgumentMetadata } from '@nestjs/common';
+export declare class TransformRootPipe implements PipeTransform {
+    transform(value: any, _metadata: ArgumentMetadata): any;
+}
+//# sourceMappingURL=transform-root.pipe.d.ts.map

package/dist/pipes/transform-root.pipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform-root.pipe.d.ts","sourceRoot":"","sources":["../../src/pipes/transform-root.pipe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAc,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAE7E,qBACa,iBAAkB,YAAW,aAAa;IAErD,SAAS,CAAC,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,gBAAgB;CAMlD"}

package/dist/pipes/transform-root.pipe.js

@@ -0,0 +1,24 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransformRootPipe = void 0;
+const common_1 = require("@nestjs/common");
+let TransformRootPipe = class TransformRootPipe {
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    transform(value, _metadata) {
+        if (value?.folderId && value.folderId === 'root') {
+            value.folderId = undefined;
+        }
+        return value;
+    }
+};
+exports.TransformRootPipe = TransformRootPipe;
+exports.TransformRootPipe = TransformRootPipe = __decorate([
+    (0, common_1.Injectable)()
+], TransformRootPipe);
+//# sourceMappingURL=transform-root.pipe.js.map

package/dist/pipes/transform-root.pipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform-root.pipe.js","sourceRoot":"","sources":["../../src/pipes/transform-root.pipe.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAA6E;AAGtE,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;IAC5B,6DAA6D;IAC7D,SAAS,CAAC,KAAU,EAAE,SAA2B;QAC/C,IAAI,KAAK,EAAE,QAAQ,IAAI,KAAK,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;YACjD,KAAK,CAAC,QAAQ,GAAG,SAAS,CAAC;QAC7B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF,CAAA;AARY,8CAAiB;4BAAjB,iBAAiB;IAD7B,IAAA,mBAAU,GAAE;GACA,iBAAiB,CAQ7B"}

package/dist/ts-rest/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * ts-rest Utilities Export
+ * ts-rest 工具导出
+ *
+ * 提供标准化的响应辅助函数：
+ *
+ * 成功响应：
+ * - success(data) - 成功响应 (200)
+ * - created(data) - 创建成功响应 (201)
+ * - deleted() - 删除成功响应 (200)
+ * - deletedWithData(data) - 删除成功并返回数据 (200)
+ * - paginated(list, total, page, limit) - 分页响应 (200)
+ *
+ * 错误响应（ts-rest）：
+ * - error(errorCode, errorData?) - 从错误码创建错误响应
+ * - errorResponse(errorCode, errorData?) - error() 的别名，语义更清晰
+ * - notFound(errorData?) - 404 响应
+ * - badRequest(errorData?) - 400 响应
+ * - unauthorized(errorData?) - 401 响应
+ * - forbidden(errorData?) - 403 响应
+ * - conflict(errorData?) - 409 响应
+ * - internalError(errorData?) - 500 响应
+ * - errorFromType(type, code, status, data?) - 从错误类型创建响应
+ * - errorSimple(code, msg, status?) - 简单错误响应
+ *
+ * 普通 NestJS 控制器（不使用 ts-rest）：
+ * - successBody(data) - 成功响应体
+ * - paginatedBody(list, total, page, limit) - 分页响应体
+ * - deletedBody() - 删除成功响应体
+ * - errorBody(errorCode, errorData?) - 错误响应体
+ *
+ * 工具函数：
+ * - serializeDates(obj) - 递归转换 Date 为 ISO 字符串
+ */
+export { success, created, deleted, deletedWithData, paginated, error, errorResponse, notFound, badRequest, unauthorized, forbidden, conflict, internalError, errorFromType, errorSimple, fetchOrNull, successBody, paginatedBody, deletedBody, errorBody, serializeDates, type TsRestResponse, type TsRestSuccessResponse, type SuccessBody, type ErrorBody, } from './response.helper';
+//# sourceMappingURL=index.d.ts.map

package/dist/ts-rest/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ts-rest/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EAEL,OAAO,EACP,OAAO,EACP,OAAO,EACP,eAAe,EACf,SAAS,EAET,KAAK,EACL,aAAa,EACb,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,aAAa,EACb,aAAa,EACb,WAAW,EAEX,WAAW,EAEX,WAAW,EACX,aAAa,EACb,WAAW,EACX,SAAS,EAET,cAAc,EAEd,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,WAAW,EAChB,KAAK,SAAS,GACf,MAAM,mBAAmB,CAAC"}

package/dist/ts-rest/index.js

@@ -0,0 +1,65 @@
+"use strict";
+/**
+ * ts-rest Utilities Export
+ * ts-rest 工具导出
+ *
+ * 提供标准化的响应辅助函数：
+ *
+ * 成功响应：
+ * - success(data) - 成功响应 (200)
+ * - created(data) - 创建成功响应 (201)
+ * - deleted() - 删除成功响应 (200)
+ * - deletedWithData(data) - 删除成功并返回数据 (200)
+ * - paginated(list, total, page, limit) - 分页响应 (200)
+ *
+ * 错误响应（ts-rest）：
+ * - error(errorCode, errorData?) - 从错误码创建错误响应
+ * - errorResponse(errorCode, errorData?) - error() 的别名，语义更清晰
+ * - notFound(errorData?) - 404 响应
+ * - badRequest(errorData?) - 400 响应
+ * - unauthorized(errorData?) - 401 响应
+ * - forbidden(errorData?) - 403 响应
+ * - conflict(errorData?) - 409 响应
+ * - internalError(errorData?) - 500 响应
+ * - errorFromType(type, code, status, data?) - 从错误类型创建响应
+ * - errorSimple(code, msg, status?) - 简单错误响应
+ *
+ * 普通 NestJS 控制器（不使用 ts-rest）：
+ * - successBody(data) - 成功响应体
+ * - paginatedBody(list, total, page, limit) - 分页响应体
+ * - deletedBody() - 删除成功响应体
+ * - errorBody(errorCode, errorData?) - 错误响应体
+ *
+ * 工具函数：
+ * - serializeDates(obj) - 递归转换 Date 为 ISO 字符串
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serializeDates = exports.errorBody = exports.deletedBody = exports.paginatedBody = exports.successBody = exports.fetchOrNull = exports.errorSimple = exports.errorFromType = exports.internalError = exports.conflict = exports.forbidden = exports.unauthorized = exports.badRequest = exports.notFound = exports.errorResponse = exports.error = exports.paginated = exports.deletedWithData = exports.deleted = exports.created = exports.success = void 0;
+var response_helper_1 = require("./response.helper");
+// 成功响应
+Object.defineProperty(exports, "success", { enumerable: true, get: function () { return response_helper_1.success; } });
+Object.defineProperty(exports, "created", { enumerable: true, get: function () { return response_helper_1.created; } });
+Object.defineProperty(exports, "deleted", { enumerable: true, get: function () { return response_helper_1.deleted; } });
+Object.defineProperty(exports, "deletedWithData", { enumerable: true, get: function () { return response_helper_1.deletedWithData; } });
+Object.defineProperty(exports, "paginated", { enumerable: true, get: function () { return response_helper_1.paginated; } });
+// 错误响应
+Object.defineProperty(exports, "error", { enumerable: true, get: function () { return response_helper_1.error; } });
+Object.defineProperty(exports, "errorResponse", { enumerable: true, get: function () { return response_helper_1.errorResponse; } });
+Object.defineProperty(exports, "notFound", { enumerable: true, get: function () { return response_helper_1.notFound; } });
+Object.defineProperty(exports, "badRequest", { enumerable: true, get: function () { return response_helper_1.badRequest; } });
+Object.defineProperty(exports, "unauthorized", { enumerable: true, get: function () { return response_helper_1.unauthorized; } });
+Object.defineProperty(exports, "forbidden", { enumerable: true, get: function () { return response_helper_1.forbidden; } });
+Object.defineProperty(exports, "conflict", { enumerable: true, get: function () { return response_helper_1.conflict; } });
+Object.defineProperty(exports, "internalError", { enumerable: true, get: function () { return response_helper_1.internalError; } });
+Object.defineProperty(exports, "errorFromType", { enumerable: true, get: function () { return response_helper_1.errorFromType; } });
+Object.defineProperty(exports, "errorSimple", { enumerable: true, get: function () { return response_helper_1.errorSimple; } });
+// 工具函数
+Object.defineProperty(exports, "fetchOrNull", { enumerable: true, get: function () { return response_helper_1.fetchOrNull; } });
+// 普通 NestJS 控制器
+Object.defineProperty(exports, "successBody", { enumerable: true, get: function () { return response_helper_1.successBody; } });
+Object.defineProperty(exports, "paginatedBody", { enumerable: true, get: function () { return response_helper_1.paginatedBody; } });
+Object.defineProperty(exports, "deletedBody", { enumerable: true, get: function () { return response_helper_1.deletedBody; } });
+Object.defineProperty(exports, "errorBody", { enumerable: true, get: function () { return response_helper_1.errorBody; } });
+// 工具函数
+Object.defineProperty(exports, "serializeDates", { enumerable: true, get: function () { return response_helper_1.serializeDates; } });
+//# sourceMappingURL=index.js.map

package/dist/ts-rest/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ts-rest/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;;;AAEH,qDAgC2B;AA/BzB,OAAO;AACP,0GAAA,OAAO,OAAA;AACP,0GAAA,OAAO,OAAA;AACP,0GAAA,OAAO,OAAA;AACP,kHAAA,eAAe,OAAA;AACf,4GAAA,SAAS,OAAA;AACT,OAAO;AACP,wGAAA,KAAK,OAAA;AACL,gHAAA,aAAa,OAAA;AACb,2GAAA,QAAQ,OAAA;AACR,6GAAA,UAAU,OAAA;AACV,+GAAA,YAAY,OAAA;AACZ,4GAAA,SAAS,OAAA;AACT,2GAAA,QAAQ,OAAA;AACR,gHAAA,aAAa,OAAA;AACb,gHAAA,aAAa,OAAA;AACb,8GAAA,WAAW,OAAA;AACX,OAAO;AACP,8GAAA,WAAW,OAAA;AACX,gBAAgB;AAChB,8GAAA,WAAW,OAAA;AACX,gHAAA,aAAa,OAAA;AACb,8GAAA,WAAW,OAAA;AACX,4GAAA,SAAS,OAAA;AACT,OAAO;AACP,iHAAA,cAAc,OAAA"}