@taicode/common-server 4.0.0-beta.1 → 4.0.0-beta.10

package/output/index.js

@@ -1,6 +1,26 @@
-// 根 index.ts，统一导出 mock 目录下所有能力
-export * from './schema/index.js';
+// 包根出口（`@taicode/common-server`）：业务侧直接使用的**构件**——
+// 路由 / 查询 schema 工厂、请求上下文构造、Redis 缓存、限流实现、Redis 队列。
+//
+// 目录布局（见 `common/product/designs/create-server/design.md` §7.1）：
+// ```
+// source/
+// ├── core/            核心设计（锁定：不可替换、不可修改，**不对外导出装配**）
+// ├── app/             服务入口 barrel（defineServer / startServer / generateOpenApi）
+// ├── auth/            可选：鉴权中间件
+// ├── cors/            可选：CORS 中间件
+// ├── rate-limit/      可选：限流中间件 + 限流实现
+// ├── redis/           请求期 Redis / 缓存
+// └── redis-queue/     可选：Redis 队列
+// ```
+//
+// 框架自己装配的一切（`createFastify` / `registerCore` / 各 core 单元 / `request.ctx` 装配 /
+// 默认中间件预设）都不在这里：**固定下来的东西不再交给外面组装**。
+export * from './core/modules/schema/builders.js';
+export { createSuccessResponse, createErrorResponse } from './core/modules/response/index.js';
+export { createContext } from './core/modules/context/index.js';
+export * from './redis/index.js';
+export * from './rate-limit/limiter.js';
+export * from './rate-limit/memory-store.js';
+export * from './rate-limit/redis-store.js';
+export * from './rate-limit/types.js';
 export * from './redis-queue/index.js';
-export * from './redis-cache/index.js';
-export * from './rate-limiter/index.js';
-export * from './context/index.js';

package/output/rate-limit/index.d.ts

@@ -0,0 +1,23 @@
+import type { MiddlewareContext, MiddlewareUnit } from '../core/types.js';
+import type { RateLimitStore } from './types.js';
+/**
+ * 标准中间件单元 `rateLimit`（可替换；**不在默认预设内**）。
+ *
+ * **规则只有一个来源：路由的 `config.rateLimit`**（与 `auth` 的 `accessControls` 同一取向）。
+ * 存储后端由调用方注入（缺省进程内 memory）。`TOO_MANY_REQUESTS` 经 `UserError` 仍映射 **400**。
+ * 路由未声明 `config.rateLimit` 时该项空转。
+ *
+ * 注：中间件的 ctx 看不到 `resources`（中间件不得直连数据层），因此 Redis store 需由调用方
+ * 在 `services` 侧构造后注入（`store`），框架不再自行探测 Redis。
+ */
+export interface RateLimitMiddlewareOptions {
+    /** 存储后端（缺省进程内 memory） */
+    store?: RateLimitStore;
+}
+export declare function createRateLimitMiddleware<C = unknown, S = unknown>(_ctx: MiddlewareContext<C, S>, options?: RateLimitMiddlewareOptions): MiddlewareUnit;
+export { RateLimiter, createRateLimitKey } from './limiter.js';
+export { MemoryRateLimitStore } from './memory-store.js';
+export { RedisRateLimitStore } from './redis-store.js';
+export type { RedisRateLimitStoreOptions } from './redis-store.js';
+export type { RateLimitConfig, RateLimitInfo, RateLimiterOptions, RateLimitResult, RateLimitStore } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/output/rate-limit/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../source/rate-limit/index.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAc,iBAAiB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACrF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAGhD;;;;;;;;;GASG;AAEH,MAAM,WAAW,0BAA0B;IACzC,yBAAyB;IACzB,KAAK,CAAC,EAAE,cAAc,CAAA;CACvB;AAqBD,wBAAgB,yBAAyB,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,GAAE,0BAA+B,GAAG,cAAc,CAoB3J;AAGD,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AACtD,YAAY,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAA;AAClE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,kBAAkB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA"}

package/output/rate-limit/index.js

@@ -0,0 +1,43 @@
+import { UserError } from '@taicode/common-base';
+import { createRateLimitKey, RateLimiter } from './limiter.js';
+import { MemoryRateLimitStore } from './memory-store.js';
+import { readServerIdentity } from '../core/modules/identity/index.js';
+function resolveRule(request) {
+    return request.routeOptions?.config?.rateLimit;
+}
+function buildKeys(request, keys) {
+    return keys.map((key) => {
+        if (key === 'ip') {
+            return `ip:${request.ip}`;
+        }
+        if (key === 'user') {
+            return `user:${String(request.user?.id ?? 'anonymous')}`;
+        }
+        if (key === 'path') {
+            return `path:${request.routeOptions?.url ?? request.url}`;
+        }
+        return `${key}:${String(request[key] ?? '')}`;
+    });
+}
+export function createRateLimitMiddleware(_ctx, options = {}) {
+    const register = (app) => {
+        const limiter = new RateLimiter({ store: options.store ?? new MemoryRateLimitStore() });
+        const prefix = `${readServerIdentity(app)?.service ?? ''}:`;
+        app.addHook('preValidation', async (request) => {
+            const rule = resolveRule(request);
+            if (!rule) {
+                return;
+            }
+            const keys = buildKeys(request, rule.keys ?? ['ip']).map((key) => createRateLimitKey(prefix, key));
+            const result = await limiter.checkMultiLimit(keys, { limit: rule.limit, window: rule.window });
+            if (!result.allowed) {
+                throw new UserError('TOO_MANY_REQUESTS', undefined, '请求过于频繁');
+            }
+        });
+    };
+    return { name: 'rateLimit', register };
+}
+// ── 限流实现（与中间件同一模块）─────────────────────────────────
+export { RateLimiter, createRateLimitKey } from './limiter.js';
+export { MemoryRateLimitStore } from './memory-store.js';
+export { RedisRateLimitStore } from './redis-store.js';

package/output/{rate-limiter/rate-limiter.d.ts → rate-limit/limiter.d.ts}

@@ -14,4 +14,4 @@ export declare class RateLimiter {
  * 创建限流键的辅助函数
  */
 export declare function createRateLimitKey(prefix: string, ...parts: string[]): string;
-//# sourceMappingURL=rate-limiter.d.ts.map
+//# sourceMappingURL=limiter.d.ts.map

package/output/rate-limit/limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"limiter.d.ts","sourceRoot":"","sources":["../../source/rate-limit/limiter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,kBAAkB,EAAE,eAAe,EAAkB,MAAM,YAAY,CAAA;AAErH,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAAgB;gBAEjB,OAAO,GAAE,kBAAuB;IAItC,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAoC1E,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAItC,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAI9D;;OAEG;IACG,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;CAezF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAE7E"}

package/output/{rate-limiter → rate-limit}/memory-store.d.ts

@@ -7,6 +7,12 @@ export declare class MemoryRateLimitStore implements RateLimitStore {
     set(key: string, info: RateLimitInfo): Promise<void>;
     delete(key: string): Promise<void>;
     cleanup(): Promise<void>;
+    /**
+     * 清空全部计数，**保留定时清理器**（它只是 GC，不属于「数据」）。
+     *
+     * 只影响本实例：进程内 store 的键本来就只在本进程可见。
+     */
+    clear(): Promise<void>;
     destroy(): void;
 }
 //# sourceMappingURL=memory-store.d.ts.map

package/output/rate-limit/memory-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-store.d.ts","sourceRoot":"","sources":["../../source/rate-limit/memory-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAO/D,qBAAa,oBAAqB,YAAW,cAAc;IACzD,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,eAAe,CAA8B;gBAEzC,iBAAiB,SAAQ;IAY/B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAY/C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAS9B;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,OAAO,IAAI,IAAI;CAOhB"}

package/output/{rate-limiter → rate-limit}/memory-store.js

@@ -36,6 +36,14 @@ export class MemoryRateLimitStore {
             }
         }
     }
+    /**
+     * 清空全部计数，**保留定时清理器**（它只是 GC，不属于「数据」）。
+     *
+     * 只影响本实例：进程内 store 的键本来就只在本进程可见。
+     */
+    async clear() {
+        this.store.clear();
+    }
     destroy() {
         if (this.cleanupInterval) {
             clearInterval(this.cleanupInterval);

package/output/{rate-limiter → rate-limit}/redis-store.d.ts

@@ -39,6 +39,24 @@ export declare class RedisRateLimitStore implements RateLimitStore {
     delete(key: string): Promise<void>;
     /** Redis 的键自带过期时间，无需额外清理 */
     cleanup(): Promise<void>;
+    /**
+     * 清空**本前缀下**的全部计数（`SCAN` + `DEL`，不用 `KEYS`——后者在大库上会阻塞）。
+     *
+     * `fallback` 一并清掉：降级期间写入的计数也是计数，漏清就会留下「只有降级那段没重置」
+     * 的诡异状态。
+     *
+     * 前缀是构造参数，所以它只会删自己这批键，不会碰同一 Redis 上其它用途的数据。
+     *
+     * ## 已知不足：扫描中途失败只记日志、不抛
+     *
+     * 与 `get` / `set` 的降级策略保持一致（Redis 抖动不该让业务抛错），但 `clear()` 的
+     * 唯一用途是「让下一条用例从零配额开始」：静默失败 = 旧桶保留 = 又变成「顺序相关的
+     * 偶发红」，正是本方法要消灭的形态。
+     *
+     * TODO（需单独评审，行为变更）：测试路径上让失败冒泡（或返回 `boolean` 交由
+     * `cleanServiceUnits()` 判错），生产路径继续降级。当前 Redis 侧无对应单测。
+     */
+    clear(): Promise<void>;
     private buildKey;
     private logError;
 }

package/output/rate-limit/redis-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-store.d.ts","sourceRoot":"","sources":["../../source/rate-limit/redis-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,eAAe,EAAE,MAAM,OAAO,CAAA;AAG1D,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAE/D,MAAM,WAAW,0BAA0B;IACzC,wBAAwB;IACxB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,kCAAkC;IAClC,WAAW,CAAC,EAAE,eAAe,CAAA;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAA;CAC1B;AAED;;;;;;;;;;GAUG;AACH,qBAAa,mBAAoB,YAAW,cAAc;IACxD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA+B;IACrD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiB;IACjD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IAEzC,OAAO,CAAC,gBAAgB,CAAI;gBAEhB,OAAO,GAAE,0BAA+B;IAyBvC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAK9B,UAAU,IAAI,IAAI;IAKZ,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAqB/C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBpD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY/C,4BAA4B;IACf,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrC;;;;;;;;;;;;;;;;OAgBG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBnC,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,QAAQ;CAOjB"}

package/output/{rate-limiter → rate-limit}/redis-store.js

@@ -101,6 +101,41 @@ export class RedisRateLimitStore {
     async cleanup() {
         await this.fallback.cleanup?.();
     }
+    /**
+     * 清空**本前缀下**的全部计数（`SCAN` + `DEL`，不用 `KEYS`——后者在大库上会阻塞）。
+     *
+     * `fallback` 一并清掉：降级期间写入的计数也是计数，漏清就会留下「只有降级那段没重置」
+     * 的诡异状态。
+     *
+     * 前缀是构造参数，所以它只会删自己这批键，不会碰同一 Redis 上其它用途的数据。
+     *
+     * ## 已知不足：扫描中途失败只记日志、不抛
+     *
+     * 与 `get` / `set` 的降级策略保持一致（Redis 抖动不该让业务抛错），但 `clear()` 的
+     * 唯一用途是「让下一条用例从零配额开始」：静默失败 = 旧桶保留 = 又变成「顺序相关的
+     * 偶发红」，正是本方法要消灭的形态。
+     *
+     * TODO（需单独评审，行为变更）：测试路径上让失败冒泡（或返回 `boolean` 交由
+     * `cleanServiceUnits()` 判错），生产路径继续降级。当前 Redis 侧无对应单测。
+     */
+    async clear() {
+        await this.fallback.clear?.();
+        if (!this.redis?.isReady)
+            return;
+        try {
+            let cursor = '0';
+            do {
+                const reply = await this.redis.scan(cursor, { MATCH: `${this.prefix}*`, COUNT: 200 });
+                cursor = reply.cursor;
+                if (reply.keys.length > 0) {
+                    await this.redis.del(reply.keys);
+                }
+            } while (cursor !== '0');
+        }
+        catch (error) {
+            this.logError('clear', error);
+        }
+    }
     buildKey(key) {
         return `${this.prefix}${key}`;
     }

package/output/rate-limit/redis-store.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-store.test.d.ts","sourceRoot":"","sources":["../../source/rate-limit/redis-store.test.ts"],"names":[],"mappings":""}

package/output/{rate-limiter → rate-limit}/redis-store.test.js

@@ -1,6 +1,6 @@
 import { afterEach, beforeEach, describe, expect, it } from 'vitest';
-import { createRedisClient } from '../redis-cache/redis-cache.js';
-import { RateLimiter } from './rate-limiter.js';
+import { createRedisClient } from '../redis/cache.js';
+import { RateLimiter } from './limiter.js';
 import { RedisRateLimitStore } from './redis-store.js';
 const REDIS_URL = process.env.REDIS_URL || 'redis://localhost:6379';
 describe('RedisRateLimitStore', () => {

package/output/rate-limit/types.d.ts

@@ -0,0 +1,45 @@
+export interface RateLimitInfo {
+    count: number;
+    windowStart: Date;
+    windowEnd: Date;
+}
+export interface RateLimitResult {
+    allowed: boolean;
+    remaining: number;
+    resetAt: Date;
+    limit: number;
+    window: number;
+}
+export interface RateLimitStore {
+    get(key: string): Promise<RateLimitInfo | null>;
+    set(key: string, info: RateLimitInfo): Promise<void>;
+    delete(key: string): Promise<void>;
+    cleanup?(): Promise<void>;
+    /**
+     * **清空全部计数**（不是「删一个键」——那是 `delete`）。
+     *
+     * ## 为什么这是存储层的职责，而不是「测试自己换个 key」
+     *
+     * 限流的键是 `ip:` / `user:` / `path:` —— 由请求本身的属性拼成，测试**改不了**（除非
+     * 伪造 `remoteAddress`）。没有 `clear()` 的时候，想「从干净配额开始」只能给每次请求换一个
+     * 假 IP：一个测试文件里铺一串 `ipSeq` 计数器，注释里还得解释「为什么不能回退序号」。
+     *
+     * 这完全是**测试在迁就实现细节**：用例真正想表达的是「这条用例从零计数开始」，而它被
+     * 迫描述成「这次请用 10.31.0.7 访问」。有了 `clear()`，`beforeEach` 一行搞定，而且
+     * 不再需要任何假 IP——测试与真实请求的差别越小，证明力越强。
+     *
+     * ## 可选，但不是可忽略
+     *
+     * 声明为可选只为了让**第三方自定义 store** 不必立刻实现它；框架自带的两个实现都有。
+     * 测试里用 `store.clear?.()` 而不是硬调。
+     */
+    clear?(): Promise<void>;
+}
+export interface RateLimitConfig {
+    limit: number;
+    window: number;
+}
+export interface RateLimiterOptions {
+    store?: RateLimitStore;
+}
+//# sourceMappingURL=types.d.ts.map

package/output/rate-limit/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../source/rate-limit/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,IAAI,CAAA;IACjB,SAAS,EAAE,IAAI,CAAA;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,IAAI,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAA;IAC/C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACpD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAClC,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACzB;;;;;;;;;;;;;;;;;OAiBG;IACH,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,cAAc,CAAA;CACvB"}

package/output/rate-limit/types.js

@@ -0,0 +1 @@
+export {};

package/output/{redis-cache/redis-cache.d.ts → redis/cache.d.ts}

@@ -136,4 +136,4 @@ export interface CreateRedisClientOptions {
     connectTimeoutMs?: number;
 }
 export declare function createRedisClient(options: CreateRedisClientOptions): RedisClientType;
-//# sourceMappingURL=redis-cache.d.ts.map
+//# sourceMappingURL=cache.d.ts.map

package/output/redis/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../source/redis/cache.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,eAAe,EAAE,MAAM,OAAO,CAAA;AAE1D;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAA;IACd,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,kDAAkD;IAClD,WAAW,CAAC,EAAE,eAAe,CAAA;IAC7B,uBAAuB;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,kCAAkC;IAClC,EAAE,CAAC,EAAE,mBAAmB,GAAG,KAAK,CAAA;CACjC;AAaD;;;;;;;;;;GAUG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA+B;IACrD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiB;IACjD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAQ;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;IAEvC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAA0B;IAC7C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAEhC,gDAAgD;IAChD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsC;IAE/D,OAAO,CAAC,gBAAgB,CAAI;gBAEhB,OAAO,EAAE,iBAAiB;IA6BtC,uBAAuB;IACvB,IAAW,IAAI,IAAI,MAAM,CAExB;IAED,sBAAsB;IACtB,IAAW,QAAQ,IAAI,MAAM,CAE5B;IAED,wCAAwC;IACxC,IAAW,WAAW,IAAI,OAAO,CAEhC;IAED;;;OAGG;IACU,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAOrC,0BAA0B;IACnB,UAAU,IAAI,IAAI;IAOzB;;;;;OAKG;IACU,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAMrC;;;OAGG;IACI,KAAK,IAAI,IAAI;IAQP,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAItC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa/C;;;;;;OAMG;IACU,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAwB5D;;;;;;OAMG;IACU,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IA6BhG;;;;OAIG;IACH,OAAO,CAAC,QAAQ;IAIhB,8CAA8C;YAChC,aAAa;YAmBb,aAAa;IAY3B,OAAO,CAAC,QAAQ;IAahB,OAAO,CAAC,QAAQ;IAUhB,OAAO,CAAC,UAAU;IAalB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,QAAQ;CAOjB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,wBAAwB;IACvC,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,eAAe,CAkBpF"}

package/output/redis/cache.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cache.test.d.ts.map

package/output/redis/cache.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.test.d.ts","sourceRoot":"","sources":["../../source/redis/cache.test.ts"],"names":[],"mappings":""}

package/output/{redis-cache/redis-cache.test.js → redis/cache.test.js}

@@ -1,5 +1,5 @@
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-import { RedisCache, createRedisClient } from './redis-cache.js';
+import { RedisCache, createRedisClient } from './cache.js';
 const REDIS_URL = process.env.REDIS_URL || 'redis://localhost:6379';
 describe('RedisCache', () => {
     describe('纯一级缓存（未配置 Redis）', () => {

package/output/{app/redis.d.ts → redis/index.d.ts}

@@ -1,23 +1,25 @@
-import { RedisCache } from '../redis-cache/index.js';
-import type { ConfigEnv } from './env.js';
-import type { LoggerLike, RedisHandle } from './types.js';
+import { RedisCache } from './cache.js';
+import type { ConfigEnv } from '../core/env.js';
+import type { LoggerLike, RedisHandle } from '../core/types.js';
 /**
  * 引导期 Redis / cache helper（N2 §2.13）。
  *
- * 在 `resources(ctx)` 槽位里按需调用（框架自己**不**创建 Redis）：
+ * 在 `resources(ctx)` 槽位里按需调用（框架自己**不**创建 Redis）；释放**在创建处**登记：
  *
  * ```ts
  * resources: (ctx) => {
  *   const redis = createRedis(ctx.env, ctx.log)          // 无 REDIS_URL → undefined
+ *   if (redis) {
+ *     ctx.disposer.add(() => redis.dispose())            // 关闭时 resources 阶段最后 flush
+ *   }
  *   return { redis, cache: createCache({ env: ctx.env, prefix: 'account', redis }) }
  * }
  * ```
  *
  * `REDIS_URL` 由 helper 直接读 `env`（固定约定），**不**取自 `config`；`redis` / `cache` 一律是
  * **惰性包装**：构造时不建连、不 ping，首次真正使用才建连 —— 「出 spec 不连库/Redis」结构性成立。
+ * 释放永远走调用方在 `ctx.disposer` 里的登记，框架不替资源持有句柄。
  */
-/** 一级/二级缓存默认 TTL（秒），与 `RedisCache` 默认一致 */
-export declare const DEFAULT_REDIS_CACHE_TTL_SECONDS = 300;
 /**
  * 构造 Redis 句柄（惰性包装：不建连、不 ping）。
  *
@@ -42,4 +44,7 @@ export interface CacheSetupParams {
  * - 都没有 → 纯进程内一级缓存（不建连）。
  */
 export declare function createCache(params: CacheSetupParams): RedisCache;
-//# sourceMappingURL=redis.d.ts.map
+export { RedisCache, createRedisClient } from './cache.js';
+export type { CreateRedisClientOptions, RedisCacheL1Options, RedisCacheOptions } from './cache.js';
+export type { RedisClientType } from 'redis';
+//# sourceMappingURL=index.d.ts.map

package/output/redis/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../source/redis/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,UAAU,EAAE,MAAM,YAAY,CAAA;AAE1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAE/D;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,CAAC,EAAE,UAAU,GAAG,WAAW,GAAG,SAAS,CAwBrF;AAED,uBAAuB;AACvB,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,SAAS,CAAA;IACd,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAA;IACd,iDAAiD;IACjD,KAAK,CAAC,EAAE,WAAW,CAAA;IACnB,GAAG,CAAC,EAAE,UAAU,CAAA;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,gBAAgB,GAAG,UAAU,CAYhE;AAGD,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAC1D,YAAY,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAClG,YAAY,EAAE,eAAe,EAAE,MAAM,OAAO,CAAA"}

package/output/{app/redis.js → redis/index.js}

@@ -1,21 +1,23 @@
-import { createRedisClient, RedisCache } from '../redis-cache/index.js';
+import { createRedisClient, RedisCache } from './cache.js';
 /**
  * 引导期 Redis / cache helper（N2 §2.13）。
  *
- * 在 `resources(ctx)` 槽位里按需调用（框架自己**不**创建 Redis）：
+ * 在 `resources(ctx)` 槽位里按需调用（框架自己**不**创建 Redis）；释放**在创建处**登记：
  *
  * ```ts
  * resources: (ctx) => {
  *   const redis = createRedis(ctx.env, ctx.log)          // 无 REDIS_URL → undefined
+ *   if (redis) {
+ *     ctx.disposer.add(() => redis.dispose())            // 关闭时 resources 阶段最后 flush
+ *   }
  *   return { redis, cache: createCache({ env: ctx.env, prefix: 'account', redis }) }
  * }
  * ```
  *
  * `REDIS_URL` 由 helper 直接读 `env`（固定约定），**不**取自 `config`；`redis` / `cache` 一律是
  * **惰性包装**：构造时不建连、不 ping，首次真正使用才建连 —— 「出 spec 不连库/Redis」结构性成立。
+ * 释放永远走调用方在 `ctx.disposer` 里的登记，框架不替资源持有句柄。
  */
-/** 一级/二级缓存默认 TTL（秒），与 `RedisCache` 默认一致 */
-export const DEFAULT_REDIS_CACHE_TTL_SECONDS = 300;
 /**
  * 构造 Redis 句柄（惰性包装：不建连、不 ping）。
  *
@@ -36,7 +38,13 @@ export function createRedis(env, log) {
                 await client.quit().catch(() => undefined);
             }
             else {
-                client.destroy();
+                // 未建连（从未使用过）时 `destroy()` 会抛 "The client is closed"；释放必须是幂等的
+                try {
+                    client.destroy();
+                }
+                catch {
+                    // 已关闭：无事可做
+                }
             }
         },
     };
@@ -59,3 +67,5 @@ export function createCache(params) {
     params.log?.debug({}, '[redis] REDIS_URL not configured; cache falls back to in-process L1');
     return new RedisCache({ prefix: params.prefix });
 }
+// ── 缓存 / 客户端实现（与引导期 helper 同一模块）───────────────
+export { RedisCache, createRedisClient } from './cache.js';

package/output/redis/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/output/{context → redis}/index.test.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../source/context/index.test.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../source/redis/index.test.ts"],"names":[],"mappings":""}

package/output/redis/index.test.js

@@ -0,0 +1,55 @@
+import { describe, expect, it } from 'vitest';
+import { RedisCache } from './cache.js';
+import { createCache, createRedis } from './index.js';
+function createRecordingLogger() {
+    const entries = [];
+    const record = (level) => (obj, msg) => {
+        entries.push({ level, obj, msg });
+    };
+    return { entries, debug: record('debug'), info: record('info'), warn: record('warn'), error: record('error') };
+}
+/** 测试用 `ConfigEnv`（固定读取约定：`ENV` / `API_PORT` / `LOG_LEVEL` / `DATABASE_URL` / `REDIS_URL`） */
+function createTestConfigEnv(overrides = {}) {
+    return { ENV: 'test', API_PORT: '', LOG_LEVEL: 'info', DATABASE_URL: '', REDIS_URL: undefined, ...overrides };
+}
+describe('createRedis', () => {
+    it('无 REDIS_URL → undefined，并留一条 debug 线索', () => {
+        const log = createRecordingLogger();
+        const handle = createRedis(createTestConfigEnv({ REDIS_URL: undefined }), log);
+        expect(handle).toBeUndefined();
+        expect(log.entries.filter((entry) => entry.level === 'debug')).toHaveLength(1);
+    });
+    it('有 REDIS_URL → 句柄（client + dispose），构造期不建连', () => {
+        const handle = createRedis(createTestConfigEnv({ REDIS_URL: 'redis://127.0.0.1:6379/0' }));
+        expect(handle).toBeDefined();
+        expect(handle?.client).toBeDefined();
+        expect(typeof handle?.dispose).toBe('function');
+        // 惰性：尚未 connect，客户端未打开
+        expect((handle?.client).isOpen).toBe(false);
+    });
+    it('dispose：未建连时直接销毁客户端，不抛错、可重复调用', async () => {
+        const handle = createRedis(createTestConfigEnv({ REDIS_URL: 'redis://127.0.0.1:6379/0' }));
+        await expect(handle?.dispose()).resolves.toBeUndefined();
+        await expect(handle?.dispose()).resolves.toBeUndefined();
+    });
+});
+describe('createCache', () => {
+    it('无 redis 句柄、无 REDIS_URL → 纯进程内 L1（不建连）', () => {
+        const log = createRecordingLogger();
+        const cache = createCache({ env: createTestConfigEnv({ REDIS_URL: undefined }), prefix: 'test:', log });
+        expect(cache).toBeInstanceOf(RedisCache);
+        expect(log.entries.filter((entry) => entry.level === 'debug')).toHaveLength(1);
+    });
+    it('复用传入的 redis 句柄（一条连接同时给 cache 与其它消费者）', () => {
+        const handle = createRedis(createTestConfigEnv({ REDIS_URL: 'redis://127.0.0.1:6379/0' }));
+        const cache = createCache({ env: createTestConfigEnv(), prefix: 'test:', redis: handle });
+        expect(cache).toBeInstanceOf(RedisCache);
+    });
+    it('无句柄但有 REDIS_URL → 自建客户端（由 RedisCache 自己持有）', () => {
+        const cache = createCache({
+            env: createTestConfigEnv({ REDIS_URL: 'redis://127.0.0.1:6379/0' }),
+            prefix: 'test:',
+        });
+        expect(cache).toBeInstanceOf(RedisCache);
+    });
+});

package/output/redis-queue/index.js

@@ -2,5 +2,5 @@
 export { RedisQueueProvider } from './redis-queue-provider.js';
 export { RedisQueueConsumer } from './redis-queue-consumer.js';
 export { RedisQueueBatchConsumer } from './redis-queue-batch-consumer.js';
-// 测试辅助函数导出
+// 测试辅助函数导出（与队列实现同一出口：谁提供的功能，谁提供配套的测试工具）
 export * as test from './test-helpers.js';

package/output/redis-queue/test-helpers.d.ts

@@ -14,7 +14,7 @@ import type { AnyRegistry, QueueStats, RedisQueueRegistry, Task } from './types.
  *
  * @example
  * ```ts
- * import { dispatchQueueTask } from '@taicode/common-server/redis-queue/test-helpers'
+ * import { dispatchQueueTask } from '@taicode/common-server/redis-queue'
  * import { RedisQueueProvider, RedisQueueConsumer } from '@taicode/common-server/redis-queue'
  *
  * describe('My Queue Tests', () => {

package/output/redis-queue/test-helpers.js

@@ -11,7 +11,7 @@ import { RedisQueueConsumer } from './redis-queue-consumer.js';
  *
  * @example
  * ```ts
- * import { dispatchQueueTask } from '@taicode/common-server/redis-queue/test-helpers'
+ * import { dispatchQueueTask } from '@taicode/common-server/redis-queue'
  * import { RedisQueueProvider, RedisQueueConsumer } from '@taicode/common-server/redis-queue'
  *
  * describe('My Queue Tests', () => {

package/output/redis-queue/types.d.ts

@@ -109,24 +109,18 @@ export interface RedisQueueCommonConfig {
 /**
  * 队列生产者配置
  */
-export interface RedisQueueProviderConfig {
-    redisUrl?: string;
-    redisClient?: RedisClientType;
-    cleanupDelay?: number;
+export interface RedisQueueProviderConfig extends RedisQueueCommonConfig {
     processingDelay?: number;
 }
 /**
  * 队列消费者配置
  */
-export interface RedisQueueConsumerConfig<T extends TaskData = TaskData> {
-    redisUrl?: string;
-    redisClient?: RedisClientType;
+export interface RedisQueueConsumerConfig<T extends TaskData = TaskData> extends RedisQueueCommonConfig {
     handler: TaskHandler<T>;
     maxRetries?: number;
     concurrency?: number;
     consumerInterval?: number;
     processingTimeout?: number;
-    cleanupDelay?: number;
 }
 /**
  * 任务处理器函数
@@ -135,14 +129,11 @@ export type TaskHandler<T extends TaskData = TaskData> = (data: T) => Promise<Ca
 /**
  * 批量消费者配置
  */
-export interface BatchConsumerConfig<T extends TaskData = TaskData> {
-    redisUrl?: string;
-    redisClient?: RedisClientType;
+export interface BatchConsumerConfig<T extends TaskData = TaskData> extends RedisQueueCommonConfig {
     handler: BatchTaskHandler<T>;
     batchSize?: number;
     maxRetries?: number;
     concurrency?: number;
-    cleanupDelay?: number;
     consumerInterval?: number;
     processingTimeout?: number;
 }

package/output/redis-queue/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../source/redis-queue/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../source/redis-queue/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,OAAO,CAAA;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AAEH,MAAM,WAAW,kBAAkB;CAElC;AAED;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,SAAS,GAAG,YAAY,GAAG,WAAW,GAAG,QAAQ,CAAA;AAEtE;;;;;GAKG;AAEH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;AAE7C;;GAEG;AAEH,MAAM,MAAM,QAAQ,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,CAAA;AAE1D;;GAEG;AACH,MAAM,WAAW,IAAI,CAAC,CAAC,GAAG,QAAQ;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,CAAC,CAAA;IACP,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,mBAAmB,CAAC,EAAE,MAAM,CAAA;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,eAAe,CAAA;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,sBAAsB;IACtE,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB,CAAC,CAAC,SAAS,QAAQ,GAAG,QAAQ,CAAE,SAAQ,sBAAsB;IACrG,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,CAAA;IACvB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,QAAQ,GAAG,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAA;AAE3G;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,QAAQ,GAAG,QAAQ,CAAE,SAAQ,sBAAsB;IAChG,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAA;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,QAAQ,GAAG,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,KAAK,OAAO,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taicode/common-server",
-  "version": "4.0.0-beta.1",
+  "version": "4.0.0-beta.10",
   "author": "Alain",
   "license": "ISC",
   "description": "",
@@ -27,7 +27,7 @@
     "@fastify/cookie": "^11",
     "@fastify/cors": "^11",
     "@fastify/swagger": "^9",
-    "@scalar/fastify-api-reference": "^1",
+    "@taicode/auth-sdk": "^1.0.9",
     "dotenv": "^17.3.1",
     "fastify-type-provider-zod": "^6",
     "zod": "^4.3.6"
@@ -35,7 +35,7 @@
   "peerDependencies": {
     "fastify": "^5.5.0",
     "redis": "^5.11.0",
-    "@taicode/common-base": "^4.0.0-beta.1"
+    "@taicode/common-base": "^4.0.0-beta.10"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.3",
@@ -49,14 +49,14 @@
     "redis": "^5.11.0",
     "typescript-eslint": "^8.56.1",
     "vitest": "^3.2.4",
-    "@taicode/common-base": "^4.0.0-beta.1"
+    "@taicode/common-base": "^4.0.0-beta.10"
   },
   "scripts": {
     "test": "vitest run",
     "test:ci": "vitest run",
     "lint": "eslint && tsc --noEmit",
     "typecheck": "tsc --noEmit",
-    "build": "tsc -p tsconfig.json",
+    "build": "rm -rf output && tsc -p tsconfig.json",
     "dev": "tsc -p tsconfig.json --watch"
   }
 }

package/output/app/auth.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=auth.test.d.ts.map

package/output/app/auth.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"auth.test.d.ts","sourceRoot":"","sources":["../../source/app/auth.test.ts"],"names":[],"mappings":""}