weifuwu 0.24.0 → 0.24.2

package/dist/cli.js

@@ -28,7 +28,12 @@ async function cmdInit(name, opts) {
   const targetDir = resolve(process.cwd(), name);
   const pkg = await readPkg();
   const v = pkg.version;
-  const depVer = (depName) => `^${(pkg.devDependencies?.[depName] || "0.0.0").replace(/^\^/, "")}`;
+  const typeVersions = {
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "@types/node": "^22"
+  };
+  const depVer = (depName) => typeVersions[depName] || `^${(pkg.devDependencies?.[depName] || "0.0.0").replace(/^\^/, "")}`;
   await mkdir(targetDir, { recursive: true });
   const templateDir = join(pkgRoot, "cli", "template");
   await cp(templateDir, targetDir, { recursive: true });
@@ -53,23 +58,29 @@ async function cmdInit(name, opts) {
       await rmrf(join(targetDir, "locales"));
     } catch {
     }
-    await writeFile(join(targetDir, "app.ts"), [
-      `import { Router } from 'weifuwu'`,
-      ``,
-      `export const app = new Router()`,
-      ``,
-      `app.get('/', () => new Response('Hello from ${name}!'))`,
-      `app.get('/api/ping', () => Response.json({ pong: true, time: new Date().toISOString() }))`,
-      ``
-    ].join("\n"));
-    await writeFile(join(targetDir, "index.ts"), [
-      `import { serve } from 'weifuwu'`,
-      `import { app } from './app.ts'`,
-      ``,
-      `const port = Number(process.env.PORT) || 3000`,
-      `serve(app.handler(), { port })`,
-      ``
-    ].join("\n"));
+    await writeFile(
+      join(targetDir, "app.ts"),
+      [
+        `import { Router } from 'weifuwu'`,
+        ``,
+        `export const app = new Router()`,
+        ``,
+        `app.get('/', () => new Response('Hello from ${name}!'))`,
+        `app.get('/api/ping', () => Response.json({ pong: true, time: new Date().toISOString() }))`,
+        ``
+      ].join("\n")
+    );
+    await writeFile(
+      join(targetDir, "index.ts"),
+      [
+        `import { serve } from 'weifuwu'`,
+        `import { app } from './app.ts'`,
+        ``,
+        `const port = Number(process.env.PORT) || 3000`,
+        `serve(app.handler(), { port })`,
+        ``
+      ].join("\n")
+    );
   }
   const deps = { weifuwu: `^${v}` };
   const devDeps = {};
@@ -81,55 +92,74 @@ async function cmdInit(name, opts) {
     devDeps["@types/react-dom"] = depVer("@types/react-dom");
   }
   devDeps["@types/node"] = depVer("@types/node");
-  await writeFile(join(targetDir, "package.json"), JSON.stringify({
-    name,
-    type: "module",
-    scripts: {
-      dev: "NODE_ENV=development node --watch index.ts",
-      start: "node index.ts"
-    },
-    dependencies: deps,
-    devDependencies: devDeps
-  }, null, 2) + "\n");
+  await writeFile(
+    join(targetDir, "package.json"),
+    JSON.stringify(
+      {
+        name,
+        type: "module",
+        scripts: {
+          dev: "NODE_ENV=development node --watch index.ts",
+          start: "node index.ts"
+        },
+        dependencies: deps,
+        devDependencies: devDeps
+      },
+      null,
+      2
+    ) + "\n"
+  );
   const include = opts.minimal ? ["*.ts"] : ["*.ts", "ui/**/*.ts", "ui/**/*.tsx"];
-  await writeFile(join(targetDir, "tsconfig.json"), JSON.stringify({
-    compilerOptions: {
-      target: "ESNext",
-      module: "NodeNext",
-      moduleResolution: "NodeNext",
-      strict: true,
-      jsx: "react-jsx",
-      skipLibCheck: true,
-      noEmit: true,
-      allowImportingTsExtensions: true
-    },
-    include
-  }, null, 2) + "\n");
+  await writeFile(
+    join(targetDir, "tsconfig.json"),
+    JSON.stringify(
+      {
+        compilerOptions: {
+          target: "ESNext",
+          module: "NodeNext",
+          moduleResolution: "NodeNext",
+          strict: true,
+          jsx: "react-jsx",
+          skipLibCheck: true,
+          noEmit: true,
+          allowImportingTsExtensions: true
+        },
+        include
+      },
+      null,
+      2
+    ) + "\n"
+  );
   await writeFile(join(targetDir, ".gitignore"), "node_modules\ndist\n.env\n.sessions\n.weifuwu\n");
   await writeFile(join(targetDir, ".env"), "PORT=3000\n");
-  await writeFile(join(targetDir, "AGENTS.md"), [
-    `# ${name}`,
-    "",
-    `This is a [weifuwu](https://weifuwu.io) application \u2014 pure Node.js, no build step.`,
-    "",
-    "## Commands",
-    "",
-    "- `npm run dev` \u2014 start dev server with hot reload",
-    "- `npm start` \u2014 start production server",
-    "- `npm install` \u2014 install dependencies",
-    "- `npx tsc --noEmit` \u2014 type-check",
-    "",
-    "## API Reference",
-    "",
-    "See `node_modules/weifuwu/README.md` for the full documentation.",
-    ""
-  ].join("\n"));
+  await writeFile(
+    join(targetDir, "AGENTS.md"),
+    [
+      `# ${name}`,
+      "",
+      `This is a [weifuwu](https://weifuwu.io) application \u2014 pure Node.js, no build step.`,
+      "",
+      "## Commands",
+      "",
+      "- `npm run dev` \u2014 start dev server with hot reload",
+      "- `npm start` \u2014 start production server",
+      "- `npm install` \u2014 install dependencies",
+      "- `npx tsc --noEmit` \u2014 type-check",
+      "",
+      "## API Reference",
+      "",
+      "See `node_modules/weifuwu/README.md` for the full documentation.",
+      ""
+    ].join("\n")
+  );
   if (!opts.skipInstall) {
     console.log("\nInstalling dependencies...");
     execSync("npm install", { cwd: targetDir, stdio: "inherit" });
   }
-  console.log(`
-\u2705 Created ${name}/ \u2014 cd ${name} && ${opts.skipInstall ? "npm install && " : ""}npm run dev`);
+  console.log(
+    `
+\u2705 Created ${name}/ \u2014 cd ${name} && ${opts.skipInstall ? "npm install && " : ""}npm run dev`
+  );
 }
 async function cmdDev() {
   const entry = existsSync("index.ts") ? "index.ts" : existsSync("app.ts") ? "app.ts" : null;
@@ -152,43 +182,49 @@ async function cmdGenerate(type, name) {
     process.exit(1);
   }
   await mkdir(dir, { recursive: true });
-  await writeFile(join(dir, "index.ts"), [
-    `import type { Middleware } from 'weifuwu'`,
-    ``,
-    `export interface ${capitalize(name)}Options {`,
-    `  // Add your options here`,
-    `}`,
-    ``,
-    `export function ${name}(opts?: ${capitalize(name)}Options): Middleware {`,
-    `  return async (req, ctx, next) => {`,
-    `    // Your middleware logic here`,
-    `    return next(req, ctx)`,
-    `  }`,
-    `}`,
-    ``
-  ].join("\n"));
+  await writeFile(
+    join(dir, "index.ts"),
+    [
+      `import type { Middleware } from 'weifuwu'`,
+      ``,
+      `export interface ${capitalize(name)}Options {`,
+      `  // Add your options here`,
+      `}`,
+      ``,
+      `export function ${name}(opts?: ${capitalize(name)}Options): Middleware {`,
+      `  return async (req, ctx, next) => {`,
+      `    // Your middleware logic here`,
+      `    return next(req, ctx)`,
+      `  }`,
+      `}`,
+      ``
+    ].join("\n")
+  );
   await mkdir(join(dir, "..", "test"), { recursive: true });
-  await writeFile(join(dir, "..", "test", `${name}.test.ts`), [
-    `import { describe, it } from 'node:test'`,
-    `import assert from 'node:assert/strict'`,
-    `import { ${name} } from '../${name}/index.ts'`,
-    `import { Router } from 'weifuwu'`,
-    ``,
-    `describe('${name}', () => {`,
-    `  it('works as middleware', async () => {`,
-    `    const app = new Router()`,
-    `    app.use(${name}())`,
-    `    app.get('/', () => new Response('ok'))`,
-    ``,
-    `    const res = await app.handler()(`,
-    `      new Request('http://localhost/'),`,
-    `      { params: {}, query: {} } as any,`,
-    `    )`,
-    `    assert.equal(res.status, 200)`,
-    `  })`,
-    `})`,
-    ``
-  ].join("\n"));
+  await writeFile(
+    join(dir, "..", "test", `${name}.test.ts`),
+    [
+      `import { describe, it } from 'node:test'`,
+      `import assert from 'node:assert/strict'`,
+      `import { ${name} } from '../${name}/index.ts'`,
+      `import { Router } from 'weifuwu'`,
+      ``,
+      `describe('${name}', () => {`,
+      `  it('works as middleware', async () => {`,
+      `    const app = new Router()`,
+      `    app.use(${name}())`,
+      `    app.get('/', () => new Response('ok'))`,
+      ``,
+      `    const res = await app.handler()(`,
+      `      new Request('http://localhost/'),`,
+      `      { params: {}, query: {} } as any,`,
+      `    )`,
+      `    assert.equal(res.status, 200)`,
+      `  })`,
+      `})`,
+      ``
+    ].join("\n")
+  );
   console.log(`\u2705 Created module ${name}/ with index.ts and test/${name}.test.ts`);
 }
 function capitalize(s) {
@@ -242,7 +278,9 @@ if (cmd === "version" || cmd === "-v" || cmd === "--version") {
     console.error("Usage: npx weifuwu init <name> [--minimal] [--skip-install]");
     process.exit(1);
   }
-  cmdInit(name, { minimal: !!values.minimal, skipInstall: !!values["skip-install"] }).catch(console.error);
+  cmdInit(name, { minimal: !!values.minimal, skipInstall: !!values["skip-install"] }).catch(
+    console.error
+  );
 } else if (cmd === "dev") {
   cmdDev();
 } else if (cmd === "generate" || cmd === "g") {

package/dist/cookie.d.ts

@@ -1,3 +1,4 @@
+/** Options for setting a cookie. All fields map to standard Set-Cookie attributes. */
 export interface CookieOptions {
     domain?: string;
     path?: string;
@@ -7,6 +8,29 @@ export interface CookieOptions {
     secure?: boolean;
     sameSite?: 'strict' | 'lax' | 'none';
 }
+/** Parse cookies from a Request's `Cookie` header.
+ *
+ * @example
+ * ```ts
+ * const cookies = getCookies(req)
+ * console.log(cookies.session_id) // value or undefined
+ * ``` */
 export declare function getCookies(req: Request): Record<string, string>;
+/** Set a cookie on a Response.
+ *
+ * Appends a `Set-Cookie` header to the existing response headers.
+ * Returns a new Response with the added header.
+ *
+ * @example
+ * ```ts
+ * const res = new Response('ok')
+ * return setCookie(res, 'session', token, { httpOnly: true, path: '/' })
+ * ``` */
 export declare function setCookie(res: Response, name: string, value: string, options?: CookieOptions): Response;
+/** Delete a cookie by setting `Max-Age=0`.
+ *
+ * @example
+ * ```ts
+ * return deleteCookie(res, 'session')
+ * ``` */
 export declare function deleteCookie(res: Response, name: string, options?: Omit<CookieOptions, 'maxAge'>): Response;

package/dist/cors.d.ts

@@ -1,4 +1,4 @@
-import type { Middleware } from './types.ts';
+import type { Middleware, Context } from './types.ts';
 /** Options for {@link cors}. */
 export interface CORSOptions {
     /** Allowed origin(s). Default `'*'`. If `credentials: true`, reflects the request origin. */
@@ -22,4 +22,4 @@ export interface CORSOptions {
  * app.use(cors({ origin: 'https://myapp.com', credentials: true }))
  * ```
  */
-export declare function cors(options?: CORSOptions): Middleware;
+export declare function cors(options?: CORSOptions): Middleware<Context, Context>;

package/dist/deploy/types.d.ts

@@ -1,6 +1,6 @@
 import type { IncomingMessage } from 'node:http';
 import type { Duplex } from 'node:stream';
-import type { Handler } from '../types.ts';
+import type { Handler, Closeable } from '../types.ts';
 export interface DeployConfig {
     domain?: string;
     port?: number;
@@ -27,7 +27,7 @@ export interface AppStatus {
     uptime?: number;
     error?: string;
 }
-export interface DeployServer {
+export interface DeployServer extends Closeable {
     close(): Promise<void>;
     ready: Promise<void>;
     url: string;

package/dist/fts.d.ts

@@ -1,4 +1,4 @@
-import type { Sql } from './vendor.ts';
+import type { SqlClient } from './vendor.ts';
 import type { BoundTable } from './postgres/schema/index.ts';
 export interface FTSSearchResult {
     /** Primary key value */
@@ -24,12 +24,12 @@ export interface FTSSearchOptions {
     rankColumn?: string;
     minRank?: number;
 }
-export declare function createIndex(sql: Sql<{}>, table: BoundTable<any>, fields: string[], options?: FTSCreateIndexOptions): Promise<void>;
-export declare function dropIndex(sql: Sql<{}>, table: BoundTable<any>, options?: {
+export declare function createIndex(sql: SqlClient, table: BoundTable<any>, fields: string[], options?: FTSCreateIndexOptions): Promise<void>;
+export declare function dropIndex(sql: SqlClient, table: BoundTable<any>, options?: {
     indexName?: string;
 }): Promise<void>;
-export declare function search<T extends Record<string, unknown>>(sql: Sql<{}>, table: BoundTable<T>, query: string, options?: FTSSearchOptions): Promise<FTSSearchResult[]>;
-export declare function suggest(sql: Sql<{}>, table: BoundTable<any>, prefix: string, options?: {
+export declare function search<T extends Record<string, unknown>>(sql: SqlClient, table: BoundTable<T>, query: string, options?: FTSSearchOptions): Promise<FTSSearchResult[]>;
+export declare function suggest(sql: SqlClient, table: BoundTable<any>, prefix: string, options?: {
     field?: string;
     language?: string;
     limit?: number;

package/dist/helmet.d.ts

@@ -1,4 +1,4 @@
-import type { Middleware } from './types.ts';
+import type { Middleware, Context } from './types.ts';
 /** Options for {@link helmet}. Set any header to `false` to omit it. */
 export interface HelmetOptions {
     /** `Content-Security-Policy` header value. */
@@ -30,4 +30,4 @@ export interface HelmetOptions {
     /** `Permissions-Policy` header value. */
     permissionsPolicy?: string | false;
 }
-export declare function helmet(options?: HelmetOptions): Middleware;
+export declare function helmet(options?: HelmetOptions): Middleware<Context, Context>;

package/dist/hub.d.ts

@@ -1,4 +1,5 @@
 import type { Redis, WebSocket } from './vendor.ts';
+import type { Closeable } from './types.ts';
 /** Options for {@link createHub}. */
 export interface HubOptions {
     /** Optional Redis client for cross-process pub/sub broadcast. */
@@ -10,7 +11,7 @@ export interface HubOptions {
  * In-memory (and optionally Redis-backed) pub/sub hub for WebSocket rooms.
  *
  * Used internally by the WebSocket handler to implement `ctx.ws.join()` / `ctx.ws.sendRoom()`. */
-export interface Hub {
+export interface Hub extends Closeable {
     /** Subscribe a WebSocket to a room/group. */
     join(key: string, ws: WebSocket): void;
     /** Unsubscribe a WebSocket from all rooms. */

package/dist/iii/index.d.ts

@@ -1,4 +1,4 @@
 export { iii } from './client.ts';
 export { createWorker } from './worker.ts';
 export { registerWorker } from './register-worker.ts';
-export type { IIIModule, IIIOptions, Worker, WorkerInfo, FunctionInfo, TriggerInfo, FunctionHandler, FunctionContext, TriggerInput, RemoteWorker } from './types.ts';
+export type { IIIModule, IIIOptions, Worker, WorkerInfo, FunctionInfo, TriggerInfo, FunctionHandler, FunctionContext, TriggerInput, RemoteWorker, } from './types.ts';

package/dist/iii/register-worker.d.ts

@@ -6,5 +6,5 @@ export declare function registerWorker(url: string): {
     unregisterTrigger(functionId: string): void;
     trigger(request: TriggerRequest): Promise<unknown>;
     onStream(handler: (data: any) => void): void;
-    shutdown(): void;
+    close(): void;
 };

package/dist/iii/types.d.ts

@@ -1,4 +1,5 @@
 import type { Router } from '../router.ts';
+import type { Closeable } from '../types.ts';
 import type { Redis } from '../vendor.ts';
 import type { PostgresClient } from '../postgres/types.ts';
 export type FunctionHandler = (payload: unknown, ctx: FunctionContext) => unknown | Promise<unknown>;
@@ -30,7 +31,7 @@ export interface TriggerOptions {
     action?: 'sync' | 'void';
     timeout_ms?: number;
 }
-export interface IIIModule extends Router {
+export interface IIIModule extends Router, Closeable {
     wsHandler: () => any;
     addWorker: (worker: Worker) => void;
     trigger: (request: TriggerRequest) => Promise<unknown>;
@@ -39,8 +40,6 @@ export interface IIIModule extends Router {
     listFunctions: () => FunctionInfo[];
     listTriggers: () => TriggerInfo[];
     migrate: () => Promise<void>;
-    shutdown: () => Promise<void>;
-    /** Alias for shutdown(). */
     close: () => Promise<void>;
 }
 export interface WorkerInfo {
@@ -87,7 +86,8 @@ export interface RemoteWorker {
     registerTrigger: (input: TriggerInput) => void;
     unregisterTrigger: (functionId: string) => void;
     trigger: (request: TriggerRequest) => Promise<unknown>;
-    shutdown: () => void;
+    /** Cleanup worker resources. */
+    close: () => void;
 }
 export interface FunctionRegistration {
     id: string;

package/dist/index.d.ts

@@ -57,7 +57,7 @@ export type { AgentOptions, AgentModule, AgentConfig, RunParams, RunResult, Know
 export { messager } from './messager/index.ts';
 export type { MessagerOptions, MessagerModule, Channel, ChannelMember, Message, } from './messager/types.ts';
 export { deploy, defineConfig } from './deploy/index.ts';
-export type { DeployConfig, AppConfig, DeployServer, AppStatus, } from './deploy/types.ts';
+export type { DeployConfig, AppConfig, DeployServer, AppStatus } from './deploy/types.ts';
 export { opencode } from './opencode/index.ts';
 export type { OpencodeOptions, OpencodeModule, SkillDef, OpencodePermissions, Session as OpencodeSession, } from './opencode/types.ts';
 export { health } from './health.ts';
@@ -77,20 +77,20 @@ export type { MailerOptions, MailOptions, Mailer } from './mailer.ts';
 export { csrf } from './csrf.ts';
 export type { CsrfOptions, CsrfInjected } from './csrf.ts';
 export { logdb } from './logdb/index.ts';
-export type { LogdbOptions, LogdbModule, LogEntry, LogEntryInput, } from './logdb/types.ts';
+export type { LogdbOptions, LogdbModule, LogEntry, LogEntryInput } from './logdb/types.ts';
 export { iii, createWorker, registerWorker } from './iii/index.ts';
 export type { IIIModule, IIIOptions, WorkerInfo, FunctionInfo, TriggerInfo, FunctionHandler, FunctionContext, TriggerInput, RemoteWorker, TriggerRequest, } from './iii/types.ts';
 export { ssr } from './ssr.ts';
 export { session, MemoryStore, RedisStore } from './session.ts';
-export type { Session, SessionOptions, SessionStore, SessionData, SessionInjected } from './session.ts';
+export type { Session, SessionOptions, SessionStore, SessionData, SessionInjected, } from './session.ts';
 export { cache, MemoryCache, RedisCache } from './cache.ts';
 export type { CacheOptions, CacheStore, CacheMiddleware, CachedResponse } from './cache.ts';
 export { webhook } from './webhook.ts';
-export type { WebhookOptions, WebhookModule, WebhookEvent, WebhookHandler, PlatformConfig, CustomVerifierConfig } from './webhook.ts';
+export type { WebhookOptions, WebhookModule, WebhookEvent, WebhookHandler, PlatformConfig, CustomVerifierConfig, } from './webhook.ts';
 export * as fts from './fts.ts';
 export { s3 } from './s3.ts';
 export type { S3Options, S3PutOptions, S3UrlOptions, S3Module, S3Body } from './s3.ts';
 export { knowledgeBase } from './kb/index.ts';
-export type { KBOptions, KBIngestOptions, KBSearchResult, KBSearchOptions, KBListEntry, KBModule } from './kb/types.ts';
+export type { KBOptions, KBIngestOptions, KBSearchResult, KBSearchOptions, KBListEntry, KBModule, } from './kb/types.ts';
 export { permissions } from './permissions.ts';
 export type { PermissionsOptions, PermissionsModule } from './permissions.ts';