weifuwu 0.23.4 → 0.24.1

package/cli.ts

@@ -92,6 +92,9 @@ async function cmdInit(name: string, opts: { minimal?: boolean; skipInstall?: bo
   const deps: Record<string, string> = { weifuwu: `^${v}` }
   const devDeps: Record<string, string> = {}
   if (!opts.minimal) {
+    deps['react'] = '^19'
+    deps['react-dom'] = '^19'
+    deps['tailwindcss'] = '^4'
     devDeps['@types/react'] = depVer('@types/react')
     devDeps['@types/react-dom'] = depVer('@types/react-dom')
   }

package/dist/agent/types.d.ts

@@ -1,6 +1,7 @@
 import type { Router } from '../router.ts';
 import type { LanguageModel, EmbeddingModel, Tool } from 'ai';
 import type { AIProvider } from '../ai/provider.ts';
+import type { Closeable } from '../types.ts';
 export interface AgentConfig {
     id: number;
     tenant_id: string | null;
@@ -46,7 +47,7 @@ export interface AgentOptions {
     embeddingDimension?: number;
     tools?: Record<string, Tool>;
 }
-export interface AgentModule extends Router {
+export interface AgentModule extends Router, Closeable {
     migrate: () => Promise<void>;
     run: (agentId: number, params: RunParams) => Promise<RunResult>;
     addKnowledge: (agentId: number, title: string, content: string) => Promise<KnowledgeDoc>;

package/dist/ai/provider.d.ts

@@ -1,4 +1,13 @@
+import type { Context, Middleware } from '../types.ts';
 import { generateText as aiGenerateText, streamText as aiStreamText, type LanguageModel, type EmbeddingModel } from 'ai';
+declare module '../types.ts' {
+    interface Context {
+        ai: AIProvider;
+    }
+}
+export interface AIProviderInjected {
+    ai: AIProvider;
+}
 export interface AIProviderOptions {
     /** API base URL (default: OPENAI_BASE_URL env or http://localhost:11434/v1). */
     baseURL?: string;
@@ -33,4 +42,4 @@ export interface AIProvider {
      */
     streamText(params: Omit<Parameters<typeof aiStreamText>[0], 'model'>): ReturnType<typeof aiStreamText>;
 }
-export declare function aiProvider(options?: AIProviderOptions): AIProvider;
+export declare function aiProvider(options?: AIProviderOptions): Middleware<Context, Context & AIProviderInjected> & AIProvider;

package/dist/analytics.d.ts

@@ -1,4 +1,4 @@
-import type { Middleware } from './types.ts';
+import type { Middleware, Closeable } from './types.ts';
 import { Router } from './router.ts';
 /** Options for {@link analytics}. */
 export interface AnalyticsOptions {
@@ -11,7 +11,7 @@ export interface AnalyticsOptions {
     };
 }
 /** Analytics module returned by {@link analytics}. */
-export interface AnalyticsModule extends Router {
+export interface AnalyticsModule extends Router, Closeable {
     /** Middleware that records page views. */
     middleware: () => Middleware;
     /** Create/update the analytics database tables. */

package/dist/cache.d.ts

@@ -1,4 +1,4 @@
-import type { Context, Middleware } from './types.ts';
+import type { Context, Middleware, Closeable } from './types.ts';
 import type { Redis } from './vendor.ts';
 export interface CachedResponse {
     status: number;
@@ -33,13 +33,13 @@ export interface CacheOptions {
     /** Maximum number of bytes per cached body. Default: 1MB. Larger bodies are skipped. */
     maxBodySize?: number;
 }
-export interface CacheMiddleware extends Middleware {
+export interface CacheMiddleware extends Middleware, Closeable {
     /** Invalidate all entries with a given tag. */
     invalidate(tag: string): Promise<void>;
     /** Flush all cached entries. */
     flush(): Promise<void>;
     /** Cleanup. */
-    close(): void;
+    close(): Promise<void>;
     /** Store reference (for testing). */
     store: CacheStore;
 }
@@ -54,7 +54,7 @@ export declare class MemoryCache implements CacheStore {
     invalidate(tag: string): Promise<void>;
     flush(): Promise<void>;
     private cleanup;
-    close(): void;
+    close(): Promise<void>;
     /** Testing only. */
     get size(): number;
 }

package/dist/cli.js

@@ -74,6 +74,9 @@ async function cmdInit(name, opts) {
   const deps = { weifuwu: `^${v}` };
   const devDeps = {};
   if (!opts.minimal) {
+    deps["react"] = "^19";
+    deps["react-dom"] = "^19";
+    deps["tailwindcss"] = "^4";
     devDeps["@types/react"] = depVer("@types/react");
     devDeps["@types/react-dom"] = depVer("@types/react-dom");
   }

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/csrf.d.ts

@@ -1,4 +1,12 @@
 import type { Context, Middleware } from './types.ts';
+declare module './types.ts' {
+    interface Context {
+        csrf: CsrfInjected;
+    }
+}
+export interface CsrfInjected {
+    token: string;
+}
 /** Options for {@link csrf}. */
 export interface CsrfOptions {
     /** Cookie name for CSRF token (default: `'_csrf'`). */
@@ -17,7 +25,7 @@ export interface CsrfOptions {
  * in a cookie. On other methods, validates the token from header or body
  * against the cookie.
  *
- * Injects `ctx.csrfToken` for use in forms.
+ * Injects `ctx.csrf.token` for use in forms.
  *
  * ```ts
  * import { csrf } from 'weifuwu'
@@ -27,13 +35,11 @@ export interface CsrfOptions {
  * app.get('/form', (req, ctx) => {
  *   return new Response(`
  *     <form method="POST">
- *       <input type="hidden" name="_csrf" value="${ctx.csrfToken}" />
+ *       <input type="hidden" name="_csrf" value="${ctx.csrf.token}" />
  *       <input type="submit" />
  *     </form>
  *   `, { headers: { 'content-type': 'text/html' } })
  * })
  * ```
  */
-export declare function csrf(options?: CsrfOptions): Middleware<Context, Context & {
-    csrfToken: string;
-}>;
+export declare function csrf(options?: CsrfOptions): Middleware<Context, Context & CsrfInjected>;

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/env.d.ts

@@ -1,3 +1,19 @@
+import type { Context, Middleware } from './types.ts';
+/**
+ * Get all public environment variables (those prefixed with `WEIFUWU_PUBLIC_`),
+ * with the prefix stripped.
+ *
+ * ```ts
+ * const pub = getPublicEnv()
+ * // WEIFUWU_PUBLIC_API_URL=http://api.example.com → { API_URL: 'http://api.example.com' }
+ * ```
+ */
+export declare function getPublicEnv(): Record<string, string>;
+declare module './types.ts' {
+    interface Context {
+        env?: Record<string, string>;
+    }
+}
 /**
  * Whether this code is running from the compiled `dist/index.js` bundle.
  * `false` when running TypeScript source directly (dev workflow in weifuwu repo).
@@ -34,3 +50,20 @@ export declare function isProd(): boolean;
  * ```
  */
 export declare function loadEnv(path?: string): void;
+/**
+ * Public env middleware.
+ *
+ * Injects `ctx.env` with all environment variables prefixed with `WEIFUWU_PUBLIC_`,
+ * with the prefix stripped. Safe to expose to the client.
+ *
+ * ```ts
+ * import { env } from 'weifuwu'
+ * app.use(env())
+ *
+ * // .env:  WEIFUWU_PUBLIC_API_URL=https://api.example.com
+ * // ctx:   ctx.env.API_URL === 'https://api.example.com'
+ * ```
+ */
+export declare function env(): Middleware<Context, Context & {
+    env: Record<string, string>;
+}>;

package/dist/flash.d.ts

@@ -24,6 +24,11 @@
  * ```
  */
 import type { Context, Middleware } from './types.ts';
+declare module './types.ts' {
+    interface Context {
+        flash: FlashInjected;
+    }
+}
 /** Options for {@link flash}. */
 export interface FlashOptions {
     /**

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/i18n.d.ts

@@ -1,4 +1,16 @@
-import type { Middleware } from './types.ts';
+import type { Context, Middleware } from './types.ts';
+import { Router } from './router.ts';
+declare module './types.ts' {
+    interface Context {
+        i18n: I18nInjected;
+    }
+}
+export interface I18nInjected {
+    locale: string;
+    messages?: Record<string, unknown>;
+    t: (key: string, params?: Record<string, string>, fallback?: string) => string;
+    set?: (value: string, loc?: string) => Response;
+}
 export interface I18nOptions {
     /** Default locale (default: 'en'). */
     default?: string;
@@ -11,4 +23,17 @@ export interface I18nOptions {
     /** Whether to detect locale from Accept-Language header (default: true). */
     fromAcceptLanguage?: boolean;
 }
-export declare function i18n(options?: I18nOptions): Middleware;
+/**
+ * i18n module. Returns a Router with an attached `.middleware()` method.
+ *
+ * ```ts
+ * const l = i18n({ dir: './locales' })
+ * app.use(l.middleware())  // → ctx.i18n = { locale, t, set }
+ * app.use('/', l)          // → GET /__lang/:locale (switch route)
+ * ```
+ */
+export interface I18nModule extends Router {
+    /** Middleware that injects `ctx.i18n = { locale, t, set }`. */
+    middleware: () => Middleware<Context, Context & I18nInjected>;
+}
+export declare function i18n(options?: I18nOptions): I18nModule;

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,7 +40,7 @@ export interface IIIModule extends Router {
     listFunctions: () => FunctionInfo[];
     listTriggers: () => TriggerInfo[];
     migrate: () => Promise<void>;
-    shutdown: () => Promise<void>;
+    close: () => Promise<void>;
 }
 export interface WorkerInfo {
     id: string;
@@ -85,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

@@ -1,7 +1,7 @@
 export type { Context, Handler, Middleware, ErrorHandler } from './types.ts';
-export { currentTraceId, currentTrace, runWithTrace, traceElapsed } from './trace.ts';
-export type { TraceContext } from './trace.ts';
-export { loadEnv, isDev, isProd, isBundled } from './env.ts';
+export { currentTraceId, currentTrace, runWithTrace, traceElapsed, trace } from './trace.ts';
+export type { TraceContext, TraceInjected, TraceOptions } from './trace.ts';
+export { loadEnv, isDev, isProd, isBundled, getPublicEnv, env } from './env.ts';
 export { serve, createTestServer, DEFAULT_MAX_BODY } from './serve.ts';
 export type { ServeOptions, Server } from './serve.ts';
 export { Router } from './router.ts';
@@ -11,8 +11,6 @@ export { logger } from './logger.ts';
 export type { LoggerOptions } from './logger.ts';
 export { cors } from './cors.ts';
 export type { CORSOptions } from './cors.ts';
-export { auth } from './auth.ts';
-export type { AuthOptions } from './auth.ts';
 export { serveStatic } from './static.ts';
 export type { ServeStaticOptions } from './static.ts';
 export { validate } from './validate.ts';
@@ -39,7 +37,7 @@ export { aiStream } from './ai.ts';
 export type { AIHandler } from './ai.ts';
 export { runWorkflow } from './ai/workflow.ts';
 export { aiProvider } from './ai/provider.ts';
-export type { AIProvider, AIProviderOptions } from './ai/provider.ts';
+export type { AIProvider, AIProviderOptions, AIProviderInjected } from './ai/provider.ts';
 export { streamText, generateText, generateObject, streamObject, tool, embed, embedMany, smoothStream, openai, createOpenAI, } from './ai-sdk.ts';
 export { postgres, MIGRATIONS_TABLE } from './postgres/index.ts';
 export type { PostgresOptions, PostgresClient, PostgresInjected } from './postgres/types.ts';
@@ -67,17 +65,17 @@ export type { HealthOptions } from './health.ts';
 export { analytics } from './analytics.ts';
 export type { AnalyticsOptions, AnalyticsModule } from './analytics.ts';
 export { theme } from './theme.ts';
-export type { ThemeOptions } from './theme.ts';
+export type { ThemeOptions, ThemeInjected } from './theme.ts';
 export { i18n } from './i18n.ts';
-export type { I18nOptions } from './i18n.ts';
+export type { I18nOptions, I18nInjected } from './i18n.ts';
 export { flash } from './flash.ts';
-export type { FlashOptions } from './flash.ts';
+export type { FlashOptions, FlashInjected } 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 } 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 { iii, createWorker, registerWorker } from './iii/index.ts';