weifuwu 0.61.2 → 0.63.0

package/dist/layout/weifuwu-layout.css

@@ -1014,7 +1014,11 @@ code {
 .wf-app-shell {
   display: grid;
   grid-template-columns: var(--wf-sidebar-width, 240px) minmax(0, 1fr);
-  min-height: 100vh;
+  /* 固定视口高度（非 min-height）：内部页面（聊天等）依赖 height: 100% 链实现
+     容器内滚动——min-height 会让壳随内容长高，聊天消息区永远无法内部滚动
+     （scrollTop 赋值无效果，页面滚动条不跟随消息到底） */
+  height: 100vh;
+  overflow: hidden;
 }
 
 /* ── 侧边栏 ── */
@@ -1115,6 +1119,9 @@ code {
 .wf-main {
   padding: var(--wf-space-lg);
   min-width: 0;
+  min-height: 0;
+  /* 内容高于视口时在主区内滚动（壳固定视口高度后的唯一滚动出口） */
+  overflow-y: auto;
   background: var(--wf-color-bg);
 }
 
@@ -1129,6 +1136,8 @@ code {
 @media (max-width: 767.98px) {
   .wf-app-shell {
     grid-template-columns: 1fr;
+    height: auto;          /* 恢复文档流滚动（侧边栏堆叠在顶部） */
+    overflow: visible;
   }
   .wf-sidebar {
     position: static;
@@ -1138,6 +1147,7 @@ code {
   }
   .wf-main {
     padding: var(--wf-space-md);
+    overflow: visible;
   }
 }
 }

package/dist/postgres/types.d.ts

@@ -33,7 +33,8 @@ export interface PostgresOptions {
     /** 语句超时 ms（慢查询保护，会话级 SET statement_timeout）。默认 0 = 禁用。 */
     statementTimeoutMs?: number;
     /** 查询观测钩子（慢查询日志/审计） */
-    onQuery?: (query: string, durationMs: number, rowCount: number) => void;
+    /** 查询观测钩子（慢查询日志/审计）；第 4 参数为请求级 traceId（x-trace-id 头，无则 undefined） */
+    onQuery?: (query: string, durationMs: number, rowCount: number, traceId?: string) => void;
     /** postgres.js 兼容名（= max） */
     poolSize?: number;
     /** postgres.js 兼容名（= statementTimeoutMs） */

package/dist/redis/types.d.ts

@@ -14,6 +14,12 @@ export type RedisOptions = {
     keyPrefix?: string;
     /** 未连接时命令是否入队等待。默认 true。 */
     enableOfflineQueue?: boolean;
+    /** 命令超时 ms（服务器慢/挂起时 reject；阻塞命令 resolve(null)）。默认 0 = 禁用。 */
+    commandTimeoutMs?: number;
+    /** socket 响应超时 ms（僵尸自愈：有 pending 且超时无数据 → 主动断开重连）。默认 0 = 禁用。 */
+    socketTimeoutMs?: number;
+    /** 命令观测钩子（慢命令日志/审计）；第 4 参数为请求级 traceId（x-trace-id 头，无则 undefined） */
+    onCommand?: (command: string, args: (string | number)[], durationMs: number, traceId?: string) => void;
 };
 export interface RedisInjected {
     redis: RedisPool;

package/dist/scheduler/cron.d.ts

@@ -0,0 +1,26 @@
+/**
+ * cron 表达式解析器（零依赖，5 字段）
+ *
+ * 字段：分(0-59) 时(0-23) 日(1-31) 月(1-12) 周(0-6, 0=周日)
+ * 语法：* | 星号斜杠 n（步进） | a,b,c | a-b
+ * 裁剪：秒/年字段、别名(@daily)、L/W/#、? —— 非法抛错（诚实裁剪，不静默降级）
+ */
+export interface CronField {
+    /** 匹配的取值集合（已展开；空 = 匹配任意） */
+    values: Set<number> | null;
+}
+export interface CronExpr {
+    fields: [CronField, CronField, CronField, CronField, CronField];
+    /** 日/周是否都显式指定（都非 * 时取 OR 语义） */
+    domExplicit: boolean;
+    dowExplicit: boolean;
+}
+/** 解析完整 cron 表达式（5 字段，空格分隔） */
+export declare function parseCron(expr: string): CronExpr;
+/**
+ * 计算下一个触发时间（严格晚于 from）
+ *
+ * 经典按字段进位算法：从 from 的下一分钟开始，逐级检查
+ * 分 → 时 → 日/月 → 月，不匹配则跳到下一级边界。
+ */
+export declare function nextRun(expr: CronExpr, from: Date): Date;

package/dist/scheduler/index.d.ts

@@ -0,0 +1,69 @@
+/**
+ * scheduler 中间件 — 延时任务（迭代 2）
+ *
+ * ctx.schedule(name, data, { delayMs | when }) → ZSET（score=触发时间戳）
+ * → 守护循环（独立连接 + 定时扫描）到期 ZREM（原子抢占，多实例安全）
+ * → queue.add（复用 queue 可靠执行）
+ *
+ * 依赖：queue（参数传入——触发后入队执行）
+ */
+import type { Context, Middleware } from '../types.ts';
+import type { QueueClientModule } from '../queue/index.ts';
+export interface SchedulerOptions {
+    /** Redis 连接串（默认 REDIS_URL） */
+    url?: string;
+    /** key 前缀。默认 'wf:sched:'。 */
+    prefix?: string;
+    /** 守护循环扫描间隔 ms。默认 1000（延时任务精度上限）。 */
+    tickMs?: number;
+    /** queue 模块（触发后入队）——应用已 `const q = queue()` 时传入复用 */
+    queue: QueueClientModule;
+}
+export interface ScheduleOptions {
+    /** 延迟 ms（>=0，0 = 尽快，下一 tick 触发） */
+    delayMs?: number;
+    /** 指定触发时间（Date） */
+    when?: Date;
+}
+export interface SchedulerClient {
+    /**
+     * 延时任务（单次）：delayMs 或 when 指定触发时间。
+     * 到期自动入队（name）——由 queue.worker 消费。
+     */
+    schedule: (name: string, data: unknown, opts?: ScheduleOptions) => Promise<{
+        id: string;
+    }>;
+    /**
+     * cron 定时任务（重复）：到点自动入队（name）。
+     * 同 name 重复注册 = 覆盖更新（改表达式/数据直接重新注册，旧定义不残留）。
+     * 定义持久化在 HASH——进程重启后守护循环恢复即继续触发（无需重新注册）。
+     */
+    cron: (expr: string, name: string, data?: unknown) => Promise<void>;
+    /** 取消 cron：删除定义 + 清理 ZSET 中该 cron 的 pending 触发点（不再触发） */
+    cancelCron: (name: string) => Promise<boolean>;
+    /** 取消未到期的延时任务（按 id；已到期入队/已执行的不受影响） */
+    cancelSchedule: (id: string) => Promise<boolean>;
+}
+export interface SchedulerInjected {
+    schedule: SchedulerClient['schedule'];
+    cron: SchedulerClient['cron'];
+    cancelCron: SchedulerClient['cancelCron'];
+    cancelSchedule: SchedulerClient['cancelSchedule'];
+}
+declare module '../types.ts' {
+    interface Context {
+        schedule?: SchedulerClient['schedule'];
+        cron?: SchedulerClient['cron'];
+        cancelCron?: SchedulerClient['cancelCron'];
+        cancelSchedule?: SchedulerClient['cancelSchedule'];
+    }
+}
+export interface SchedulerClientModule extends Middleware<Context, Context & SchedulerInjected> {
+    schedule: SchedulerClient['schedule'];
+    cron: SchedulerClient['cron'];
+    cancelCron: SchedulerClient['cancelCron'];
+    cancelSchedule: SchedulerClient['cancelSchedule'];
+    /** 关闭守护循环 + 连接 */
+    close: () => Promise<void>;
+}
+export declare function scheduler(options: SchedulerOptions): SchedulerClientModule;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "weifuwu",
   "type": "module",
-  "version": "0.61.2",
+  "version": "0.63.0",
   "description": "AI SaaS framework — (req, ctx) => Response",
   "exports": {
     ".": {
@@ -36,9 +36,7 @@
     "pretest": "docker compose up -d --wait postgres redis 2>/dev/null; sleep 1",
     "test": "node --env-file=.env --test 'src/test/**/*.test.ts' 'src/components/**/*.test.ts' 'src/db/**/*.test.ts'",
     "release": "node scripts/release.mjs",
-    "release:dry": "node scripts/release.mjs --dry-run",
-    "demo": "node --import weifuwu/dev --env-file=.env apps/demo/server.ts",
-    "demo:build": "node apps/demo/scripts/build.mjs"
+    "release:dry": "node scripts/release.mjs --dry-run"
   },
   "dependencies": {
     "esbuild": "^0.28.1",