weifuwu 0.25.1 → 0.25.2

package/cli/template/index.ts

@@ -5,6 +5,6 @@ loadEnv()
 const port = Number(process.env.PORT) || 3000
 const srv = serve(app.handler(), { port, websocket: app.websocketHandler(), shutdown: false })
 process.on('SIGINT', () => {
-  srv.stop()
+  srv.close()
   process.exit(0)
 })

package/dist/agent/run.d.ts

@@ -5,9 +5,9 @@ import type { AIProvider } from '../ai/provider.ts';
 import type { RunParams, RunResult, KnowledgeDoc } from './types.ts';
 interface RunnerDeps {
     sql: SqlClient;
-    agents: BoundTable<any>;
-    runs: BoundTable<any>;
-    knowledge: BoundTable<any>;
+    agents: BoundTable<Record<string, unknown>>;
+    runs: BoundTable<Record<string, unknown>>;
+    knowledge: BoundTable<Record<string, unknown>>;
     provider: AIProvider;
     modelName?: string;
     userTools?: Record<string, Tool>;

package/dist/analytics.d.ts

@@ -1,13 +1,22 @@
 import type { Middleware, Closeable } from './types.ts';
 import { Router } from './router.ts';
+/** Tagged-template SQL function from the postgres.js library. */
+type PgSql = (strings: TemplateStringsArray, ...values: unknown[]) => Promise<unknown[]>;
+/** Schema table builder callback. */
+type PgTable = (name: string, cols: Record<string, unknown>) => {
+    create(): Promise<void>;
+    createIndex(cols: string[], opts: {
+        unique: boolean;
+    }): Promise<void>;
+};
 /** Options for {@link analytics}. */
 export interface AnalyticsOptions {
     /** Path prefixes to exclude from analytics (default: `['/__analytics', '/__wfw', '/static']`). */
     excluded?: string[];
     /** PostgreSQL client for persistent storage. Required for production use. */
     pg?: {
-        sql: (strings: TemplateStringsArray, ...values: any[]) => Promise<any[]>;
-        table: (name: string, cols: any) => any;
+        sql: PgSql;
+        table: PgTable;
     };
 }
 /** Analytics module returned by {@link analytics}. */
@@ -33,3 +42,4 @@ export interface AnalyticsModule extends Router, Closeable {
  * ```
  */
 export declare function analytics(options?: AnalyticsOptions): AnalyticsModule;
+export {};

package/dist/compile.d.ts

@@ -13,5 +13,3 @@ export declare function compile(path: string): Promise<any>;
 export declare let vendorHash: string;
 /** Build a single vendor bundle containing all needed vendor modules */
 export declare function compileVendorBundle(): Promise<string>;
-/** Clean up esbuild's internal worker pool. Call when you're done compiling. */
-export declare function closeCompile(): Promise<void>;

package/dist/csrf.d.ts

@@ -8,6 +8,8 @@ export interface CsrfInjected {
     token: string;
 }
 /** Options for {@link csrf}. */
+/** CSRF protection module — a {@link Middleware} that injects `ctx.csrf`. */
+export type CsrfModule = Middleware<Context, Context & CsrfInjected>;
 export interface CsrfOptions {
     /** Cookie name for CSRF token (default: `'_csrf'`). */
     cookie?: string;

package/dist/flash.d.ts

@@ -29,6 +29,8 @@ declare module './types.ts' {
         flash: FlashInjected;
     }
 }
+/** Flash message module — a {@link Middleware} that injects `ctx.flash`. */
+export type FlashModule = Middleware<Context, Context & FlashInjected>;
 /** Options for {@link flash}. */
 export interface FlashOptions {
     /**

package/dist/index.d.ts

@@ -15,11 +15,11 @@ export type { CORSOptions } from './cors.ts';
 export { serveStatic } from './static.ts';
 export type { ServeStaticOptions } from './static.ts';
 export { validate } from './validate.ts';
-export type { ValidationSchemas } from './validate.ts';
+export type { ValidationSchemas, ValidateModule } from './validate.ts';
 export { getCookies, setCookie, deleteCookie } from './cookie.ts';
 export type { CookieOptions } from './cookie.ts';
 export { upload } from './upload.ts';
-export type { UploadOptions, UploadedFile } from './upload.ts';
+export type { UploadOptions, UploadedFile, UploadModule } from './upload.ts';
 export { rateLimit } from './rate-limit.ts';
 export type { RateLimitOptions } from './rate-limit.ts';
 export { compress } from './compress.ts';
@@ -27,7 +27,7 @@ export type { CompressOptions } from './compress.ts';
 export { helmet } from './helmet.ts';
 export type { HelmetOptions } from './helmet.ts';
 export { requestId } from './request-id.ts';
-export type { RequestIdOptions } from './request-id.ts';
+export type { RequestIdOptions, RequestIdModule } from './request-id.ts';
 export { createSSEStream, formatSSE, formatSSEData } from './sse.ts';
 export type { SSEEvent } from './sse.ts';
 export { testApp, TestApp, TestRequest, createTestDb, withTestDb } from './test-utils.ts';
@@ -70,13 +70,13 @@ export type { ThemeOptions, ThemeInjected } from './theme.ts';
 export { i18n } from './i18n.ts';
 export type { I18nOptions, I18nInjected } from './i18n.ts';
 export { flash } from './flash.ts';
-export type { FlashOptions, FlashInjected } from './flash.ts';
+export type { FlashOptions, FlashInjected, FlashModule } from './flash.ts';
 export { seo, seoMiddleware, seoTags } from './seo.ts';
 export type { SeoOptions, RobotsRule, SitemapUrl, SitemapConfig, SeoHeadersConfig, SeoTagsConfig, } from './seo.ts';
 export { mailer } from './mailer.ts';
 export type { MailerOptions, MailOptions, Mailer } from './mailer.ts';
 export { csrf } from './csrf.ts';
-export type { CsrfOptions, CsrfInjected } from './csrf.ts';
+export type { CsrfOptions, CsrfInjected, CsrfModule } from './csrf.ts';
 export { logdb } from './logdb/index.ts';
 export type { LogdbOptions, LogdbModule, LogEntry, LogEntryInput } from './logdb/types.ts';
 export { iii, createWorker, registerWorker } from './iii/index.ts';

package/dist/index.js

@@ -256,6 +256,7 @@ function serve(handler, options) {
       resolveReady();
       return {
         stop: () => Promise.resolve(),
+        close: () => Promise.resolve(),
         ready,
         get port() {
           return 0;
@@ -289,30 +290,29 @@ function serve(handler, options) {
     const displayHost = _cachedHostname === "0.0.0.0" ? "localhost" : _cachedHostname || "localhost";
     console.log(`weifuwu listening on http://${displayHost}:${_cachedPort}`);
   });
-  return {
-    stop: (timeoutMs = 1e4) => {
-      if (shutdownHandler) {
-        process.off("SIGTERM", shutdownHandler);
-        process.off("SIGINT", shutdownHandler);
-        shutdownHandler = null;
-      }
-      return new Promise((resolve16) => {
-        if (!server.listening) {
-          resolve16();
-          return;
-        }
-        server.close();
-        server.closeIdleConnections();
-        const timer = setTimeout(() => {
-          server.closeAllConnections();
-          resolve16();
-        }, timeoutMs);
-        server.on("close", () => {
-          clearTimeout(timer);
-          resolve16();
-        });
+  async function stop(timeoutMs = 1e4) {
+    if (shutdownHandler) {
+      process.off("SIGTERM", shutdownHandler);
+      process.off("SIGINT", shutdownHandler);
+      shutdownHandler = null;
+    }
+    if (!server.listening) return;
+    server.close();
+    server.closeIdleConnections();
+    return new Promise((resolve16) => {
+      const timer = setTimeout(() => {
+        server.closeAllConnections();
+        resolve16();
+      }, timeoutMs);
+      server.on("close", () => {
+        clearTimeout(timer);
+        resolve16();
       });
-    },
+    });
+  }
+  return {
+    close: stop,
+    stop,
     ready,
     get port() {
       if (!server.listening) return 0;
@@ -519,7 +519,7 @@ var Router = class _Router {
    * ```
    */
   _checkMiddlewareMeta(mw, location) {
-    const meta = mw.__meta ?? mw.middleware?.().__meta;
+    const meta = mw.__meta ?? (typeof mw === "object" && mw && "middleware" in mw ? mw.middleware().__meta : void 0);
     if (!meta) return;
     for (const dep of meta.depends) {
       if (!this._ctxFields.has(dep)) {
@@ -1771,7 +1771,7 @@ function createSSEStream(iterable, opts) {
             controller.enqueue(encoder.encode(text2));
           }
         } catch (e) {
-          if (e.name !== "AbortError") {
+          if (e instanceof Error && e.name !== "AbortError") {
             controller.enqueue(encoder.encode(formatSSE("error", { error: e.message })));
           }
         } finally {
@@ -2008,7 +2008,7 @@ var TestApp = class {
     }
     this.wsConnections = [];
     if (this.wsServer) {
-      this.wsServer.stop();
+      this.wsServer.close();
       this.wsServer = null;
     }
   }
@@ -2422,7 +2422,16 @@ async function getStreamObject() {
 async function aiStream(handler, provider) {
   const r = new Router();
   r.post("/", async (req, ctx) => {
-    const options = await handler(req, ctx);
+    let options;
+    try {
+      options = await handler(req, ctx);
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      return new Response(JSON.stringify({ error: message }), {
+        status: 500,
+        headers: { "Content-Type": "application/json" }
+      });
+    }
     if (provider && !options.model) {
       options.model = provider.model();
     }
@@ -3758,7 +3767,6 @@ var BUILTIN_PROVIDERS = {
     tokenUrl: "https://oauth2.googleapis.com/token",
     userUrl: "https://www.googleapis.com/oauth2/v2/userinfo",
     scope: "openid email profile",
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     parseUser: (data) => ({
       id: data.id,
       email: data.email,
@@ -3771,7 +3779,6 @@ var BUILTIN_PROVIDERS = {
     tokenUrl: "https://github.com/login/oauth/access_token",
     userUrl: "https://api.github.com/user",
     scope: "read:user user:email",
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     parseUser: (data) => ({
       id: String(data.id),
       email: data.email ?? "",
@@ -3830,7 +3837,8 @@ function registerOAuthLoginRoutes(router, deps, providers) {
     if (email) {
       const existingUser = await deps.findUserByEmail(email);
       if (existingUser) {
-        await linkProvider(existingUser.id, provider, providerId, email, name, avatarUrl);
+        const uid = existingUser.id;
+        await linkProvider(uid, provider, providerId, email, name, avatarUrl);
         return existingUser;
       }
     }
@@ -3838,7 +3846,8 @@ function registerOAuthLoginRoutes(router, deps, providers) {
       email || `${provider}_${providerId}@oauth.local`,
       name || provider
     );
-    await linkProvider(newUser.id, provider, providerId, email, name, avatarUrl);
+    const userId2 = newUser.id;
+    await linkProvider(userId2, provider, providerId, email, name, avatarUrl);
     return newUser;
   }
   function getProviderMeta(providerName) {
@@ -6314,7 +6323,6 @@ function chunkContent(content, chunkSize, overlap) {
 // agent/run.ts
 function hasKnowledgeDocs(sql2, agentId) {
   return sql2`SELECT 1 FROM "_knowledge_documents" WHERE agent_id = ${agentId} LIMIT 1`.then(
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     (r) => r.length > 0
   );
 }
@@ -7375,7 +7383,7 @@ async function deploy(config) {
           await stopProcess({ child: app.process, port: app.currentPort });
         }
       }
-      httpServer?.stop();
+      httpServer?.close();
     },
     ready: httpServer.ready,
     url: `http://localhost:${config.port}/`,
@@ -8076,7 +8084,6 @@ function moduleServer(opts) {
   _setImportRoots(roots);
   const router = new Router();
   router.get("/__wfw/m/*", (async (req, ctx) => {
-    const reqUrl = new URL(req.url);
     const filePath = (ctx.params["*"] || "").split("?")[0];
     const ext = filePath.split(".").pop();
     if (ext !== "tsx" && ext !== "ts") {
@@ -8646,25 +8653,22 @@ async function getSession(sql2, id2) {
 }
 async function listSessions(sql2, userId2) {
   const opts = { orderBy: { updated_at: "desc" } };
-  if (userId2 !== void 0) {
-    const { data: rows2 } = await sessions.readMany(
-      sql2,
-      { user_id: userId2, active: true },
-      opts
-    );
-    return rows2;
-  }
-  const { data: rows } = await sessions.readMany(sql2, { active: true }, opts);
+  const filter = userId2 !== void 0 ? { user_id: userId2, active: true } : { active: true };
+  const { data: rows } = await sessions.readMany(sql2, filter, opts);
   return rows;
 }
 async function deleteSession(sql2, id2) {
   await sessions.update(sql2, id2, { active: false, updated_at: sql`NOW()` });
 }
 async function getHistory(sql2, sessionId, limit = 50) {
-  const { data: rows } = await messages.readMany(sql2, { session_id: sessionId }, {
-    orderBy: { created_at: "asc" },
-    limit
-  });
+  const { data: rows } = await messages.readMany(
+    sql2,
+    { session_id: sessionId },
+    {
+      orderBy: { created_at: "asc" },
+      limit
+    }
+  );
   return rows;
 }
 async function addTextMessage(sql2, sessionId, role, content, tokensIn = 0, tokensOut = 0) {
@@ -8865,7 +8869,7 @@ function createBashTool(ctx) {
 // opencode/tools/read.ts
 import { tool as tool4 } from "ai";
 import { z as z6 } from "zod";
-import { readFileSync as readFileSync7 } from "node:fs";
+import { readFileSync as readFileSync6 } from "node:fs";
 import { resolve as resolve9 } from "node:path";
 function createReadTool(ctx) {
   return tool4({
@@ -8880,7 +8884,7 @@ function createReadTool(ctx) {
       if (!isPathAllowed(resolved, ctx.workspace, ctx.permissions.permissions)) {
         return { error: "Path not allowed", content: null, totalLines: 0 };
       }
-      const content = readFileSync7(resolved, "utf-8");
+      const content = readFileSync6(resolved, "utf-8");
       const lines = content.split("\n");
       const totalLines = lines.length;
       if (offset !== void 0) {
@@ -8931,7 +8935,7 @@ function createWriteTool(ctx) {
 // opencode/tools/edit.ts
 import { tool as tool6 } from "ai";
 import { z as z8 } from "zod";
-import { readFileSync as readFileSync8, writeFileSync as writeFileSync3 } from "node:fs";
+import { readFileSync as readFileSync7, writeFileSync as writeFileSync3 } from "node:fs";
 import { resolve as resolve11 } from "node:path";
 function createEditTool(ctx) {
   return tool6({
@@ -8947,7 +8951,7 @@ function createEditTool(ctx) {
       if (!isPathAllowed(resolved, ctx.workspace, ctx.permissions.permissions)) {
         return { error: "Path not allowed" };
       }
-      const content = readFileSync8(resolved, "utf-8");
+      const content = readFileSync7(resolved, "utf-8");
       if (replaceAll) {
         if (!content.includes(oldString)) {
           return { error: "oldString not found in file", replaced: 0 };

package/dist/module-server.d.ts

@@ -1,6 +1,5 @@
 import { Router } from './router.ts';
 export declare function clearModuleCache(filePath?: string): void;
-export declare function _setImportRoots(roots: string[]): void;
 export declare function transformModule(absPath: string, root: string, mountPath?: string): Promise<{
     url: string;
     code: string;

package/dist/request-id.d.ts

@@ -5,6 +5,10 @@ declare module './types.ts' {
     }
 }
 /** Options for {@link requestId}. */
+/** Request ID module — a {@link Middleware} that injects `ctx.requestId`. */
+export type RequestIdModule = Middleware<Context, Context & {
+    requestId: string;
+}>;
 export interface RequestIdOptions {
     /** Header name for request ID (default: `'X-Request-ID'`). */
     header?: string;

package/dist/router.d.ts

@@ -10,24 +10,6 @@ export type WebSocketHandler = {
     error?: (ws: WebSocket, ctx: Context, error: Error) => void | Promise<void>;
 };
 type WsUpgradeHandler = (req: IncomingMessage, socket: Duplex, head: Buffer) => void;
-/**
- * Middleware metadata for dependency checking.
- * Middleware factories can attach this to their return value for runtime validation.
- *
- * ```ts
- * function postgres(): PostgresClient {
- *   const mw = async (req, ctx, next) => { ... }
- *   mw.__meta = { injects: ['sql'], depends: [] }
- *   return Object.assign(mw, { sql, migrate, close })
- * }
- * ```
- */
-export interface MiddlewareMeta {
-    /** Fields this middleware injects into ctx. */
-    injects: string[];
-    /** Fields this middleware depends on (must be injected earlier). */
-    depends: string[];
-}
 export declare class Router<T extends Context = Context> {
     private root;
     private wsRoot;

package/dist/serve.d.ts

@@ -18,6 +18,8 @@ export interface ServeOptions {
 }
 export interface Server {
     stop: (timeoutMs?: number) => Promise<void>;
+    /** Alias for `stop()`. Prefer this for consistency with other modules. */
+    close: (timeoutMs?: number) => Promise<void>;
     readonly port: number;
     readonly hostname: string;
     ready: Promise<void>;

package/dist/server-registry.d.ts

@@ -8,5 +8,3 @@ export declare function getServerModule(absPath: string): any;
  * Otherwise clear all modules.
  */
 export declare function clearServerModule(absPath?: string): void;
-/** Release resources. Call when shutting down. */
-export declare function closeRegistry(): void;

package/dist/ssr.d.ts

@@ -1,13 +1,4 @@
 import { Router } from './router.ts';
-interface ResolvedRoute {
-    routePath: string;
-    pageFile: string;
-    layoutFiles: string[];
-    errorFiles: string[];
-    notFoundFile: string | null;
-}
-/** Clear route cache (called by HMR watcher in dev mode). */
-export declare function clearRouteCache(cache: Map<string, ResolvedRoute | null>): void;
 export interface RouteEntry {
     path: string;
     file: string;
@@ -18,4 +9,3 @@ export declare function ssr(opts: {
     close?: () => void;
     pages?: () => RouteEntry[];
 };
-export {};

package/dist/tenant/utils.d.ts

@@ -5,6 +5,5 @@ export declare function sqlTypeForField(field: FieldDef): string;
 export declare function validateSlug(slug: string): string | null;
 export declare function validateFieldDefs(fields: FieldDef[]): string[];
 export declare function formatDefault(field: FieldDef): string;
-export declare function mapFieldToZod(field: FieldDef): string;
 export declare function getRelationFields(fields: FieldDef[]): FieldDef[];
 export declare function findRelation(fields: FieldDef[], targetSlug: string): FieldDef | undefined;

package/dist/types.d.ts

@@ -4,12 +4,25 @@ export interface Context {
     mountPath?: string;
     layoutStack?: {
         path: string;
-        component: any;
+        component: unknown;
     }[];
     [key: string]: unknown;
 }
 export type Handler<T extends Context = Context> = (req: Request, ctx: T) => Response | Promise<Response>;
-export type Middleware<In extends Context = Context, Out extends In = In> = (req: Request, ctx: In, next: Handler<Out>) => Response | Promise<Response>;
+/**
+ * Metadata for middleware dependency checking.
+ * Middleware factories attach this for runtime validation.
+ */
+export interface MiddlewareMeta {
+    /** Fields this middleware injects into ctx. */
+    injects: string[];
+    /** Fields this middleware depends on (must be injected earlier). */
+    depends: string[];
+}
+export type Middleware<In extends Context = Context, Out extends In = In> = {
+    (req: Request, ctx: In, next: Handler<Out>): Response | Promise<Response>;
+    __meta?: MiddlewareMeta;
+};
 export type ErrorHandler<T extends Context = Context> = (error: Error, req: Request, ctx: T) => Response | Promise<Response>;
 /**
  * Interface for resources that require explicit cleanup (connections, pools, timers).

package/dist/upload.d.ts

@@ -4,6 +4,10 @@ declare module './types.ts' {
         parsed: Record<string, unknown>;
     }
 }
+/** Upload middleware — a {@link Middleware} that injects `ctx.parsed` with file fields. */
+export type UploadModule = Middleware<Context, Context & {
+    parsed: Record<string, unknown>;
+}>;
 /** A parsed file from a multipart upload. */
 export interface UploadedFile {
     /** Original filename from the client. */

package/dist/user/oauth-login.d.ts

@@ -9,13 +9,13 @@ interface OAuthLoginDeps {
     /** Table for provider-user link, derived from usersTable. */
     providerTable: string;
     redirectUrl: string;
-    signToken: (user: any) => string;
+    signToken: (user: Record<string, unknown>) => string;
     /** Create a placeholder user for OAuth login (no password). */
-    createPlaceholderUser: (email: string, name: string) => Promise<any>;
+    createPlaceholderUser: (email: string, name: string) => Promise<Record<string, unknown>>;
     /** Find user by internal ID. */
-    findUserById: (id: number) => Promise<any | undefined>;
+    findUserById: (id: number) => Promise<Record<string, unknown> | undefined>;
     /** Find user by email. */
-    findUserByEmail: (email: string) => Promise<any | undefined>;
+    findUserByEmail: (email: string) => Promise<Record<string, unknown> | undefined>;
 }
 export declare function registerOAuthLoginRoutes(router: Router, deps: OAuthLoginDeps, providers: Record<string, OAuthProviderConfig>): void;
 export {};

package/dist/validate.d.ts

@@ -5,6 +5,8 @@ declare module './types.ts' {
         parsed: Record<string, unknown>;
     }
 }
+/** Validation middleware — a {@link Middleware} that injects `ctx.parsed` with validated data. */
+export type ValidateModule = Middleware;
 export interface ValidationSchemas {
     body?: ZodSchema;
     query?: ZodSchema;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "weifuwu",
   "type": "module",
-  "version": "0.25.1",
+  "version": "0.25.2",
   "description": "Web-standard HTTP framework for Node.js — (req, ctx) => Response",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -31,8 +31,9 @@
     "lint": "eslint --ext .ts,.tsx .",
     "test": "node --test 'test/**/*.test.ts'",
     "test:coverage": "node --experimental-test-coverage --test 'test/**/*.test.ts'",
-    "test:unit": "bash scripts/test-unit.sh",
-    "test:ci": "node --test 'test/**/*.test.ts'",
+    "test:typecheck": "npx tsc -p tsconfig.test.json --noEmit",
+    "test:quick": "bash scripts/test-quick.sh",
+    "test:ci": "node --test --test-force-exit --test-timeout=60000 'test/**/*.test.ts'",
     "prepare": "husky"
   },
   "dependencies": {