weifuwu 0.87.0 → 0.89.0

package/dist/server/core/collect.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Trie 遍历收集纯函数（ROUTER-CORE 波次 E 纯移动拆解——2027-10）
+ *
+ * 自 router.ts Router 类移出（零 this 依赖——树遍历纯函数）。
+ * - collectAll/collectAllWs：mount 展平负载（A1 wildcardValue 修复在案）
+ * - collectRoutes/collectWsRoutes：routes() 调试清单
+ */
+import type { Handler, Middleware } from '../types.ts';
+import type { WebSocketHandler } from './ws.ts';
+import type { TrieNode } from '../../shared/router/trie.ts';
+export type RouteValue = {
+    handlers: Map<string, Handler>;
+    middlewares: Map<string, Middleware[]>;
+};
+export type WsValue = {
+    handler: WebSocketHandler;
+    middlewares: Middleware[];
+};
+export declare function collectAll(node: TrieNode<RouteValue>, prefix?: string): Array<{
+    method: string;
+    path: string;
+    handler: Handler;
+    middlewares: Middleware[];
+}>;
+export declare function collectAllWs(node: TrieNode<WsValue>, prefix?: string): Array<{
+    path: string;
+    handler: WebSocketHandler;
+    middlewares: Middleware[];
+}>;
+export declare function collectRoutes(node: TrieNode<RouteValue>, prefix: string, result: string[]): void;
+export declare function collectWsRoutes(node: TrieNode<WsValue>, prefix: string, result: string[]): void;

package/dist/server/core/error-counter.d.ts

@@ -0,0 +1,11 @@
+/** handler 链 throw 时调用（router.ts handleError——console.error 去重门） */
+export declare function noteHandlerError(routeKey: string, e: unknown): void;
+/** 该路由请求正常完成时调用（恢复清出——再错再报） */
+export declare function clearHandlerError(routeKey: string): void;
+/** 可观测面（诊断/仪表接入点——total + byRoute 快照） */
+export declare function errorSnapshot(): {
+    total: number;
+    byRoute: Record<string, number>;
+};
+/** 测试复位 */
+export declare function resetErrorCounter(): void;

package/dist/server/core/hub.d.ts

@@ -0,0 +1,2 @@
+import type { Hub } from './ws.ts';
+export declare function createInMemoryHub(): Hub;

package/dist/server/core/router.d.ts

@@ -19,8 +19,14 @@ export declare class Router<T extends object = Context> {
     private _hasWildcard;
     private _hub?;
     private _wss?;
-    private _ctxFields;
+    private _ctxRegistry;
     private _closeables;
+    private _pipeline?;
+    /** 路由内核 pipeline（惰性构建——闭包 this 读 globalMws/errorHandler 最新态） */
+    private get pipeline();
+    private buildPipeline;
+    /** 链组装（S6：routeMws 空常态复用 globalMws 引用——免每请求数组分配） */
+    private runWithChain;
     private get wss();
     private get hub();
     wsHub(hub: Hub): this;
@@ -66,16 +72,8 @@ export declare class Router<T extends object = Context> {
     private _route;
     private _routeImpl;
     private _mountRouter;
-    private _collectAll;
-    private _collectAllWs;
-    private _collectRoutes;
-    private _collectWsRoutes;
-    private matchTrie;
-    private _resolveMatch;
     private matchWsTrie;
-    private handle;
     private handleError;
-    private runChain;
     /**
      * Register a Closeable resource for graceful shutdown.
      * Used for modules created outside of middleware chain (e.g., sub-router state).
@@ -84,7 +82,12 @@ export declare class Router<T extends object = Context> {
     /**
      * Gracefully shut down all registered Closeable resources.
      * Called by serve() during shutdown.
+     *
+     * S2（SERVER-PERF-PLAN）：WS 客户端 1001 握手先行——
+     * `server.closeAllConnections()` 对已升级的 WS 连接无效（实证：socket 残留、
+     * 客户端 close 事件永不触发）——必须经 `wss.clients` 优雅关闭。
      */
+    private _closed;
     close(): Promise<void>;
     private _checkMiddlewareMeta;
 }

package/dist/server/db/contracts.d.ts

@@ -14,6 +14,25 @@
  */
 import type { RespValue } from './redis/resp.ts';
 import type { RedisSubscriber } from './redis/subscriber.ts';
+/**
+ * Pipeline 面（S5——SERVER-PERF-PLAN 波次 2）：批量命令单次网络往返发送。
+ * 结果按命令顺序；错误命令对应位置为 Error 实例，其余命令不受影响。
+ *
+ * 结构化接口：RedisPipeline（真库）与 MemoryPipeline（内存）均满足。
+ * 与并发 command() 同连接交错安全（连接层 FIFO pending——按序匹配）。
+ */
+export interface RedisPipelineFace {
+    set(key: string, value: string | number, ttl?: number): RedisPipelineFace;
+    get(key: string): RedisPipelineFace;
+    del(...keys: string[]): RedisPipelineFace;
+    incr(key: string): RedisPipelineFace;
+    expire(key: string, seconds: number): RedisPipelineFace;
+    ttl(key: string): RedisPipelineFace;
+    /** 任意命令透传（不加 keyPrefix——对齐 pool.command 语义） */
+    raw(name: string, ...args: (string | number)[]): RedisPipelineFace;
+    /** 一次往返执行所有命令；exec 后可复用（cmds 清空） */
+    exec(): Promise<RespValue[]>;
+}
 /**
  * 连接池中的连接项（Postgres/Redis 通用）：生命周期 + 健康状态。
  * 各库特化（PostgresPoolConnection / RedisPoolConnection）扩展执行能力。
@@ -70,6 +89,11 @@ export interface Redis {
     createConnection(): Promise<RedisPoolConnection>;
     /** 原始命令（RespValue 返回值——RESP 协议层；阻塞命令超时 resolve(null)） */
     command(name: string, ...args: (string | number)[]): Promise<RespValue>;
+    /**
+     * 创建 pipeline（S5）：批量命令单次往返。池实现取轮询连接——
+     * 与并发命令交错安全（FIFO pending）。
+     */
+    pipeline(): Promise<RedisPipelineFace>;
     /** 创建订阅者（Pub/Sub，独立连接——messager 跨进程广播用） */
     createSubscriber(): RedisSubscriber;
     /** 发布消息到频道（订阅者回调触发） */

package/dist/server/db/memory-redis.d.ts

@@ -11,9 +11,8 @@
  * 未实现命令抛 ProtocolError('unsupported')——绝不静默降级。
  * ⚠️ 仅供开发/测试/单实例——多实例一致性与持久化由真实 Redis 承担（文档红线）。
  */
-import type { Redis, RedisPoolConnection } from './contracts.ts';
+import type { Redis, RedisPoolConnection, RedisPipelineFace } from './contracts.ts';
 import type { RespValue } from './redis/resp.ts';
-import type { RedisPipeline } from './redis/pipeline.ts';
 import type { RedisSubscriber } from './redis/subscriber.ts';
 /** 内存订阅者（RedisSubscriber 形状兼容）：psubscribe 模式匹配 + publish 派发 */
 declare class MemorySubscriber {
@@ -25,7 +24,7 @@ declare class MemorySubscriber {
     subscribe(channel: string, fn: (channel: string, message: string) => void): Promise<void>;
     psubscribe(pattern: string, fn: (channel: string, message: string) => void): Promise<void>;
     close(): Promise<void>;
-    _dispatch(channel: string, message: string): void;
+    _dispatch(channel: string, message: string): boolean;
 }
 export declare class MemoryRedis implements Redis {
     private strings;
@@ -72,7 +71,7 @@ export declare class MemoryRedis implements Redis {
     zadd(key: string, score: number, member: string | number): Promise<number>;
     zrange(key: string, start: number, stop: number): Promise<string[]>;
     publish(channel: string, message: string | number): Promise<number>;
-    pipeline(): Promise<RedisPipeline>;
+    pipeline(): Promise<RedisPipelineFace>;
     createSubscriber(): RedisSubscriber;
     /**
      * 独立连接视图：queue worker 的 stop 会 close 连接——视图 close 不关底层

package/dist/server/db/memory-sql.d.ts

@@ -1,7 +1,23 @@
 import type { Sql, Row, QueryResult } from './contracts.ts';
 import type { Query } from './query.ts';
+/** 事务快照表条目（rows + 元数据副本——restore 需复活事务内 DROP 掉的表） */
+export interface MemorySnapshotEntry {
+    rows: Row[];
+    nextId: number;
+    columns: string[];
+    columnTypes: Record<string, string>;
+    pk?: {
+        col: string;
+        defaultUuid: boolean;
+    };
+    uniques: string[];
+    defaultNow: string[];
+}
+export type MemorySnapshot = Map<string, MemorySnapshotEntry>;
 export declare class MemorySql {
     private tables;
+    /** 派生表 AST 缓存（同 innerSql 不重复 parse——执行路径热缓存） */
+    private derivedAstCache;
     /** 标签模板 → 参数化 SQL（values 顺序即 $1..$n） */
     tag(strings: TemplateStringsArray, values: unknown[]): Promise<Row[]>;
     unsafe(sql: string, params?: unknown[]): Promise<Row[]>;
@@ -19,10 +35,10 @@ export declare class MemorySql {
     getColumnType(table: string, col: string): string | undefined;
     /** PG 服务器 Parse：INSERT VALUES 列序 → 类型列表 */
     getColumnTypes(table: string): string[];
-    /** 事务快照（服务器 ROLLBACK 撤销事务内写入——内存自动提交的对偶） */
-    snapshot(): Map<string, Row[]>;
-    /** 恢复快照（ROLLBACK）——rows 替换为快照副本（保留元数据/约束） */
-    restore(snap: Map<string, Row[]>): void;
+    /** 事务快照（服务器 ROLLBACK 撤销事务内写入——内存自动提交的对偶；含元数据） */
+    snapshot(): MemorySnapshot;
+    /** 恢复快照（ROLLBACK）——全量还原（含复活事务内 DROP 掉的表）；快照后新建的表清空 */
+    restore(snap: MemorySnapshot): void;
     /** DDL 执行（parser 产出 DdlQuery）——约束提取到表元数据 */
     private executeDdl;
 }

package/dist/server/db/postgres-server.d.ts

@@ -16,6 +16,8 @@ export declare class MemoryPostgresServer implements DBServer {
     private closed;
     private queryLog;
     private txSnap;
+    /** 存活连接（close 时全量销毁——server.close 只停 accept，不等存量连接） */
+    private sockets;
     /** 命名 prepared statement 缓存（客户端复用——同 sql 不发 Parse） */
     private statements;
     /** portal → statement 绑定（Bind 创建、Execute 按 portal 执行——客户端 portal 通常空名） */

package/dist/server/db/query.d.ts

@@ -10,6 +10,8 @@ export type WhereScalar = string | number | boolean | null;
 export interface ColOps {
     /** 列引用（非字面量）：`{ 'u.email': { col: 'o.user_id' } }` → u.email = o.user_id */
     col?: string;
+    /** 等值（同列合并形态：scalar 进 ColOps——parser 同列 = 合并 / builder scalar×ops 合并产出） */
+    eq?: WhereScalar;
     gt?: WhereScalar;
     gte?: WhereScalar;
     lt?: WhereScalar;
@@ -24,6 +26,11 @@ export interface ColOps {
     between?: [WhereScalar, WhereScalar];
 }
 export type WhereField = WhereScalar | WhereScalar[] | RawSql | ColOps;
+/**
+ * WHERE 表达式：列条件 AND 连接。
+ * 结构键：`or: WhereExpr[]`（OR 组——组间 AND）、`and: WhereExpr[]`（AND 组——
+ * where 合并不可对象级合并时包装——AND 语义不丢）。
+ */
 export interface WhereExpr {
     [col: string]: WhereField | WhereExpr[];
 }
@@ -186,4 +193,18 @@ export declare function compileUpdate(q: UpdateQuery): Compiled;
 export declare function compileDelete(q: DeleteQuery): Compiled;
 /** 统一编译入口 */
 export declare function compileQuery(q: Query): Compiled;
+/**
+ * 同列条件对象级合并（AND 语义）。不可合并返回 null（调用方 and 包装）：
+ *   ColOps × ColOps → 不相交操作符键 spread（{gt:15}+{lt:35} 并存）
+ *   scalar × ColOps → { eq: scalar, ...ops }（eq 登记——编译/执行双端认识）
+ *   数组（IN）/ raw / scalar × scalar / 同键冲突 / null 标量 → null
+ */
+export declare function mergeWhereField(prev: WhereField, next: WhereField): WhereField | null;
+/**
+ * 向 WhereExpr 追加同列条件（AND 语义）。不可对象级合并 → and 包装
+ * （既有条件保留 + 新条件入 and 组——不覆盖不静默丢弃）。
+ */
+export declare function addWhereCond(expr: WhereExpr, col: string, field: WhereField): void;
+/** where 表达式合并（builder 链式追加——AND 语义，不覆盖） */
+export declare function mergeWhere(prev: WhereExpr, next: WhereExpr): WhereExpr;
 export {};

package/dist/server/db/redis-server.d.ts

@@ -12,8 +12,8 @@ export declare class MemoryRedisServer implements DBServer {
     url: string;
     private server;
     private engine;
-    private sockets;
-    private subChannels;
+    private conns;
+    /** BLPOP 等待者（全局队列——LPUSH 跨连接唤醒；owner 回溯连接清理） */
     private blpopWaiters;
     private nextId;
     private opts;
@@ -21,6 +21,8 @@ export declare class MemoryRedisServer implements DBServer {
     constructor(options?: RedisServerOptions);
     start(): Promise<void>;
     close(): Promise<void>;
+    /** 释放某连接全部 BLPOP waiter（resolve null → dispatch 返回 null → 跳过写） */
+    private releaseWaiters;
     /** 测试辅助：断开发送端 socket（模拟 CLIENT KILL / 网络中断） */
     killSocket(socketId: number): void;
     /** 测试辅助：当前连接数 */

package/dist/server/db/sql-parser.d.ts

@@ -19,5 +19,6 @@
  */
 import type { Query, WhereExpr } from './query.ts';
 export declare function parseSqlToAst(sql: string, params?: unknown[]): Query;
-/** WHERE 子句 → Query Language WhereExpr（OR 拆分 → AND 组合 → 条件） */
+/** WHERE 子句 → Query Language WhereExpr（OR 拆分 → AND 组合 → 条件）
+ *  同列多条件走 addWhereCond（对象级合并 / and 包装——不覆盖不静默丢弃） */
 export declare function parseWhereToExpr(clause: string, params: unknown[], alias?: string): WhereExpr;

package/dist/server/email/index.d.ts

@@ -45,6 +45,8 @@ export interface EmailOptions {
         baseUrl?: string;
     };
     smtp?: SmtpConfig;
+    /** E3：resend 适配器 HTTP 超时 ms（SMTP 用 smtp.timeoutMs——默认 30s）。默认 10_000 */
+    timeoutMs?: number;
 }
 export interface EmailInjected {
     email: Mailer;

package/dist/server/index.d.ts

@@ -9,6 +9,8 @@ export type { WebSocketHandler } from './core/ws.ts';
 export type { WebSocket } from './types.ts';
 export { cors } from './middleware/cors.ts';
 export type { CORSOptions } from './middleware/cors.ts';
+export { compress } from './middleware/compress.ts';
+export type { CompressOptions } from './middleware/compress.ts';
 export { serveStatic } from './middleware/static.ts';
 export type { ServeStaticOptions } from './middleware/static.ts';
 export { rateLimit } from './middleware/rate-limit.ts';
@@ -20,9 +22,10 @@ export { sendSmtp } from './email/smtp.ts';
 export type { SmtpConfig } from './email/smtp.ts';
 export { userSystem } from './user/index.ts';
 export { hashPassword, verifyPassword } from './user/password.ts';
+export { signToken, verifyToken, generateRefreshToken } from './user/token.ts';
 export { messager } from './messager/index.ts';
 export type { UserSystemOptions, UserInjected, AuthApi, RegisterInput } from './user/index.ts';
-export type { MessagerOptions, MessagerInjected, MessagerClient, MessagerSystem, Message, Conversation } from './messager/index.ts';
+export type { MessagerOptions, MessagerInjected, MessagerClient, MessagerSystem, MessagerHandlerOptions, Message, Conversation } from './messager/index.ts';
 export { queue } from './queue/index.ts';
 export { scheduler } from './scheduler/index.ts';
 export type { QueueOptions, QueueClient, QueueInjected, QueueWorker, WorkerOptions, AddOptions, Job } from './queue/index.ts';