weifuwu 0.22.3 → 0.23.0

package/cli/template/.weifuwu/ssr/2e3a7e60.js

@@ -0,0 +1,112 @@
+// cli/template/ui/app/page.tsx
+import { useState } from "react";
+import { useWebsocket, useLoaderData, useLocale, useTheme } from "weifuwu/react";
+
+// cli/template/ui/components/Greeting.tsx
+import { jsxs } from "react/jsx-runtime";
+function Greeting({ name }) {
+  return /* @__PURE__ */ jsxs("span", { className: "text-red-500 font-bold", children: [
+    name,
+    "!"
+  ] });
+}
+
+// cli/template/ui/app/page.tsx
+import { jsx, jsxs as jsxs2 } from "react/jsx-runtime";
+function Home() {
+  const [input, setInput] = useState("");
+  const { send, lastMessage, readyState } = useWebsocket("/ws/echo");
+  const { locale, t, setLocale } = useLocale();
+  const { theme, resolvedTheme, setTheme } = useTheme();
+  const ld = useLoaderData();
+  return /* @__PURE__ */ jsxs2("div", { className: "min-h-screen bg-white dark:bg-gray-950 text-gray-900 dark:text-gray-100", children: [
+    /* @__PURE__ */ jsx("header", { className: "border-b dark:border-gray-800", children: /* @__PURE__ */ jsxs2("div", { className: "max-w-5xl mx-auto flex items-center justify-between h-14 px-4", children: [
+      /* @__PURE__ */ jsx("span", { className: "font-bold text-lg", children: "weifuwu" }),
+      /* @__PURE__ */ jsxs2("nav", { className: "hidden sm:flex gap-6 text-sm", children: [
+        /* @__PURE__ */ jsx("span", { className: "hover:text-blue-600 transition cursor-pointer", children: t("nav.home") }),
+        /* @__PURE__ */ jsx("span", { className: "hover:text-blue-600 transition cursor-pointer", children: t("nav.docs") }),
+        /* @__PURE__ */ jsx("span", { className: "hover:text-blue-600 transition cursor-pointer", children: t("nav.api") })
+      ] }),
+      /* @__PURE__ */ jsxs2("div", { className: "flex items-center gap-2 text-sm", children: [
+        /* @__PURE__ */ jsx(
+          "button",
+          {
+            onClick: () => setLocale(locale === "en" ? "zh-CN" : "en"),
+            className: "px-2 py-1 rounded border dark:border-gray-700 hover:bg-gray-100 dark:hover:bg-gray-800 transition",
+            children: locale === "en" ? "\u4E2D\u6587" : "EN"
+          }
+        ),
+        /* @__PURE__ */ jsx(
+          "button",
+          {
+            onClick: () => setTheme(resolvedTheme === "light" ? "dark" : "light"),
+            className: "px-2 py-1 rounded border dark:border-gray-700 hover:bg-gray-100 dark:hover:bg-gray-800 transition",
+            children: resolvedTheme === "light" ? "\u{1F319}" : "\u2600\uFE0F"
+          }
+        )
+      ] })
+    ] }) }),
+    /* @__PURE__ */ jsxs2("section", { className: "text-center py-20 px-4", children: [
+      /* @__PURE__ */ jsx("h1", { className: "text-5xl font-bold mb-4", children: t("hero.title") }),
+      /* @__PURE__ */ jsx("p", { className: "text-xl text-gray-500 dark:text-gray-400 mb-8", children: t("hero.subtitle") }),
+      /* @__PURE__ */ jsx(Greeting, { name: "Weifuwu" }),
+      /* @__PURE__ */ jsxs2("div", { className: "flex justify-center gap-4 mt-8", children: [
+        /* @__PURE__ */ jsx("a", { href: "#", className: "px-6 py-2.5 bg-blue-600 text-white rounded-lg hover:bg-blue-700 transition font-medium", children: t("cta.start") }),
+        /* @__PURE__ */ jsx("a", { href: "#", className: "px-6 py-2.5 border dark:border-gray-700 rounded-lg hover:bg-gray-100 dark:hover:bg-gray-800 transition font-medium", children: t("cta.learn") })
+      ] })
+    ] }),
+    ld.features && /* @__PURE__ */ jsx("section", { className: "max-w-4xl mx-auto grid grid-cols-1 md:grid-cols-3 gap-6 px-4 pb-20", children: ld.features.map((f, i) => /* @__PURE__ */ jsxs2("div", { className: "p-6 rounded-xl border dark:border-gray-800 bg-gray-50 dark:bg-gray-900", children: [
+      /* @__PURE__ */ jsx("h3", { className: "font-semibold mb-2", children: f.title }),
+      /* @__PURE__ */ jsx("p", { className: "text-sm text-gray-500 dark:text-gray-400", children: f.desc })
+    ] }, i)) }),
+    /* @__PURE__ */ jsx("section", { className: "max-w-xl mx-auto px-4 pb-20", children: /* @__PURE__ */ jsxs2("div", { className: "border dark:border-gray-800 rounded-xl p-6 bg-gray-50 dark:bg-gray-900 space-y-4", children: [
+      /* @__PURE__ */ jsx("h2", { className: "font-semibold", children: t("demo.title") }),
+      /* @__PURE__ */ jsx("p", { className: "text-sm text-gray-500 dark:text-gray-400", children: readyState === 1 ? t("ws.connected") : readyState === 0 ? t("ws.connecting") : t("ws.disconnected") }),
+      /* @__PURE__ */ jsxs2("div", { className: "flex gap-2", children: [
+        /* @__PURE__ */ jsx(
+          "input",
+          {
+            value: input,
+            onChange: (e) => setInput(e.target.value),
+            onKeyDown: (e) => {
+              if (e.key === "Enter") {
+                send(input);
+                setInput("");
+              }
+            },
+            placeholder: t("demo.placeholder"),
+            className: "flex-1 border dark:border-gray-700 rounded px-3 py-2 text-sm bg-white dark:bg-gray-950 outline-none focus:border-blue-500 transition"
+          }
+        ),
+        /* @__PURE__ */ jsx(
+          "button",
+          {
+            onClick: () => {
+              send(input);
+              setInput("");
+            },
+            className: "px-4 py-2 bg-blue-600 text-white rounded text-sm hover:bg-blue-700 transition font-medium",
+            children: t("demo.send")
+          }
+        )
+      ] }),
+      lastMessage && /* @__PURE__ */ jsxs2("p", { className: "text-sm text-gray-600 dark:text-gray-400", children: [
+        /* @__PURE__ */ jsxs2("span", { className: "font-medium", children: [
+          t("demo.echo"),
+          ":"
+        ] }),
+        " ",
+        lastMessage
+      ] })
+    ] }) }),
+    /* @__PURE__ */ jsxs2("footer", { className: "border-t dark:border-gray-800 py-8 text-center text-sm text-gray-500", children: [
+      "\xA9 2026 MyApp \xB7 ",
+      t("footer.privacy"),
+      " \xB7 ",
+      t("footer.terms")
+    ] })
+  ] });
+}
+export {
+  Home as default
+};

package/cli/template/app.ts

@@ -1,8 +1,9 @@
-import { Router, ssr, preferences } from '../../index.ts'
+import { Router, ssr, theme, i18n } from '../../index.ts'
 
 export const app = new Router()
+app.use(theme())
+app.use(i18n({ dir: './locales' }))
 app.use('/', ssr({ dir: './ui' }))
-app.use(preferences({ dir: './locales', locale: { default: 'en' }, theme: { default: 'system' } }))
 app.use(async (req, ctx, next) => {
   ctx.loaderData = {
     features: [

package/cli/template/index.ts

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

package/dist/agent/run.d.ts

@@ -1,14 +1,15 @@
-import { type LanguageModel, type EmbeddingModel, type Tool } from 'ai';
+import { type Tool } from 'ai';
 import type { Sql } from '../vendor.ts';
 import type { BoundTable } from '../postgres/schema/index.ts';
+import type { AIProvider } from '../ai/provider.ts';
 import type { RunParams, RunResult, KnowledgeDoc } from './types.ts';
 interface RunnerDeps {
     sql: Sql<{}>;
     agents: BoundTable<any>;
     runs: BoundTable<any>;
     knowledge: BoundTable<any>;
-    getModel: () => LanguageModel;
-    getEmbeddingModel: () => EmbeddingModel;
+    provider: AIProvider;
+    modelName?: string;
     userTools?: Record<string, Tool>;
 }
 export declare function createRunner(deps: RunnerDeps): {

package/dist/agent/types.d.ts

@@ -1,5 +1,6 @@
 import type { Router } from '../router.ts';
 import type { LanguageModel, EmbeddingModel, Tool } from 'ai';
+import type { AIProvider } from '../ai/provider.ts';
 export interface AgentConfig {
     id: number;
     tenant_id: string | null;
@@ -38,6 +39,8 @@ export type RunResult = {
 };
 export interface AgentOptions {
     pg: import('../postgres/types.ts').PostgresClient;
+    /** AI provider for model and embedding resolution. Overridden by explicit model/embeddingModel. */
+    provider?: AIProvider;
     model?: LanguageModel;
     embeddingModel?: EmbeddingModel;
     embeddingDimension?: number;

package/dist/ai/provider.d.ts

@@ -0,0 +1,36 @@
+import { generateText as aiGenerateText, streamText as aiStreamText, type LanguageModel, type EmbeddingModel } from 'ai';
+export interface AIProviderOptions {
+    /** API base URL (default: OPENAI_BASE_URL env or http://localhost:11434/v1). */
+    baseURL?: string;
+    /** API key (default: OPENAI_API_KEY env or 'ollama'). */
+    apiKey?: string;
+    /** Chat model name (default: OPENAI_MODEL env or 'qwen3:0.6b'). */
+    model?: string;
+    /** Embedding model name (default: OPENAI_EMBEDDING_MODEL env or 'qwen3-embedding:0.6b'). */
+    embeddingModel?: string;
+    /** Vector dimension (default: EMBEDDING_DIMENSION env or 1024). */
+    embeddingDimension?: number;
+}
+export interface AIProvider {
+    /** Get the language model. Caches by default; pass a name to override. */
+    model(name?: string): LanguageModel;
+    /** Get the embedding model. Caches by default; pass a name to override. */
+    embeddingModel(name?: string): EmbeddingModel;
+    /** Embed a single text string into a vector. */
+    embed(text: string): Promise<number[]>;
+    /** Embed multiple text strings in batch. */
+    embedMany(texts: string[]): Promise<number[][]>;
+    /** The configured vector dimension. */
+    readonly dimension: number;
+    /**
+     * Generate text using the configured model.
+     * All options are passed through to the AI SDK's `generateText`, with `model` auto-injected.
+     */
+    generateText(params: Omit<Parameters<typeof aiGenerateText>[0], 'model'>): ReturnType<typeof aiGenerateText>;
+    /**
+     * Stream text using the configured model.
+     * All options are passed through to the AI SDK's `streamText`, with `model` auto-injected.
+     */
+    streamText(params: Omit<Parameters<typeof aiStreamText>[0], 'model'>): ReturnType<typeof aiStreamText>;
+}
+export declare function aiProvider(options?: AIProviderOptions): AIProvider;

package/dist/ai/utils.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Split text into chunks by paragraphs, respecting a max chunk size with overlap.
+ * Used by both knowledge base and agent modules.
+ */
+export declare function chunkContent(content: string, chunkSize: number, overlap: number): string[];

package/dist/ai/workflow.d.ts

@@ -1,7 +1,10 @@
 import type { LanguageModel } from 'ai';
+import type { AIProvider } from './provider.ts';
 export declare function runWorkflow(opts?: {
     tools?: Record<string, any>;
     model?: LanguageModel;
+    /** AI provider — `provider.model()` is used as fallback if no explicit `model` is set. */
+    provider?: AIProvider;
     maxSteps?: number;
 }): import("ai").Tool<{
     goal: string;

package/dist/ai.d.ts

@@ -1,5 +1,13 @@
 import type { Context } from './types.ts';
 import { Router } from './router.ts';
+import type { AIProvider } from './ai/provider.ts';
 export type AIHandler = (req: Request, ctx: Context) => Record<string, unknown> | Promise<Record<string, unknown>>;
 export declare const _ai: Record<string, any>;
-export declare function aiStream(handler: AIHandler): Promise<Router>;
+/**
+ * Create a streaming AI endpoint.
+ *
+ * @param handler - Returns options for `streamText` or `streamObject` (if `schema` is present).
+ * @param provider - Optional AI provider. If provided and the handler does not return a `model`,
+ *                   `provider.model()` is used as the default.
+ */
+export declare function aiStream(handler: AIHandler, provider?: AIProvider): Promise<Router>;

package/dist/client-locale.d.ts

@@ -1,5 +1,5 @@
 export declare function useLocale(): {
-    locale: string;
+    locale: string | undefined;
     setLocale: (locale: string) => Promise<void>;
     t: (key: string, params?: Record<string, string>, fallback?: string) => string;
 };

package/dist/client-router.d.ts

@@ -11,10 +11,12 @@ interface LinkProps extends Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>,
 }
 export declare function Link({ href, children, onClick, prefetch, ...props }: LinkProps): import("react").DetailedReactHTMLElement<{
     type?: string | undefined | undefined;
+    title?: string | undefined | undefined;
     id?: string | undefined | undefined;
+    onError?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
+    onAbort?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
     slot?: string | undefined | undefined;
     style?: import("react").CSSProperties | undefined;
-    title?: string | undefined | undefined;
     dir?: string | undefined | undefined;
     property?: string | undefined | undefined;
     download?: any;
@@ -158,7 +160,6 @@ export declare function Link({ href, children, onClick, prefetch, ...props }: Li
     onInvalidCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
     onLoad?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
     onLoadCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
-    onError?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
     onErrorCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
     onKeyDown?: import("react").KeyboardEventHandler<HTMLAnchorElement> | undefined;
     onKeyDownCapture?: import("react").KeyboardEventHandler<HTMLAnchorElement> | undefined;
@@ -166,7 +167,6 @@ export declare function Link({ href, children, onClick, prefetch, ...props }: Li
     onKeyPressCapture?: import("react").KeyboardEventHandler<HTMLAnchorElement> | undefined;
     onKeyUp?: import("react").KeyboardEventHandler<HTMLAnchorElement> | undefined;
     onKeyUpCapture?: import("react").KeyboardEventHandler<HTMLAnchorElement> | undefined;
-    onAbort?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
     onAbortCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
     onCanPlay?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;
     onCanPlayCapture?: import("react").ReactEventHandler<HTMLAnchorElement> | undefined;

package/dist/client-theme.d.ts

@@ -1,6 +1,6 @@
 declare function applyTheme(theme: string): void;
 export declare function useTheme(): {
-    theme: string;
+    theme: any;
     resolvedTheme: string;
     setTheme: (t: string) => Promise<void>;
 };

package/dist/compile.d.ts

@@ -1,3 +1,4 @@
+export declare const OUT_DIR = ".weifuwu/ssr";
 export declare function id(s: string): string;
 export declare function clearCompileCache(): void;
 export declare function compileTsx(path: string): Promise<any>;
@@ -5,8 +6,13 @@ export declare function compileTsx(path: string): Promise<any>;
 export declare function compileTsxDev(path: string): Promise<any>;
 /** Auto-select dev (vm) or prod (ESM + import) compilation */
 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>;
+/** Compile page component for browser (served at /__ssr/[hash].js).
+ *  The weifuwu source modules are externalized — they come from the vendor
+ *  bundle at runtime via importmap, ensuring store is shared. */
+export declare function compileBrowser(path: string, outDir?: string): Promise<string>;
 /** Hot-reload: ESM bundle, calls __WFW_REFRESH on import */
 export declare function compileHotComponent(path: string): Promise<{
     hash: string;

package/dist/cron-utils.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Shared cron expression parsing utilities.
+ * Used by both queue (Redis-backed) and in-memory scheduler.
+ */
+export declare function parseField(field: string, min: number, max: number): Set<number>;
+export declare function parsePattern(pattern: string): Set<number>[];
+export declare function matches(fields: Set<number>[], date: Date): boolean;
+export declare function cronNext(expr: string, from?: Date): number;

package/dist/flash.d.ts

@@ -0,0 +1,24 @@
+import type { Middleware } from './types.ts';
+export interface FlashOptions {
+    /** Cookie name (default: 'flash'). */
+    name?: string;
+}
+/**
+ * Flash message middleware.
+ *
+ * ```ts
+ * app.use(flash())
+ *
+ * // Read flash
+ * app.get('/', (req, ctx) => {
+ *   const msg = ctx.flash.value  // { type: 'success', text: 'Saved!' }
+ * })
+ *
+ * // Set flash + redirect
+ * app.post('/save', async (req, ctx) => {
+ *   await save()
+ *   return ctx.flash.set({ type: 'success', text: 'Saved!' }, '/articles')
+ * })
+ * ```
+ */
+export declare function flash(options?: FlashOptions): Middleware;

package/dist/i18n.d.ts

@@ -0,0 +1,14 @@
+import type { Middleware } from './types.ts';
+export interface I18nOptions {
+    /** Default locale (default: 'en'). */
+    default?: string;
+    /** Directory containing `{locale}.json` translation files. */
+    dir?: string;
+    /** Inline translation messages keyed by locale. */
+    messages?: Record<string, Record<string, unknown>>;
+    /** Cookie name for locale (default: 'locale'). Set empty to disable. */
+    cookie?: string;
+    /** Whether to detect locale from Accept-Language header (default: true). */
+    fromAcceptLanguage?: boolean;
+}
+export declare function i18n(options?: I18nOptions): Middleware;

package/dist/index.d.ts

@@ -13,8 +13,6 @@ export { cors } from './cors.ts';
 export type { CORSOptions } from './cors.ts';
 export { auth } from './auth.ts';
 export type { AuthOptions } from './auth.ts';
-export { oauthClient } from './oauth-client.ts';
-export type { OAuthClientOptions, OAuthProviderConfig } from './oauth-client.ts';
 export { serveStatic } from './static.ts';
 export type { ServeStaticOptions } from './static.ts';
 export { validate } from './validate.ts';
@@ -40,11 +38,13 @@ export type { GraphQLOptions, GraphQLHandler } from './graphql.ts';
 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 { 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';
 export { user } from './user/index.ts';
-export type { UserOptions, UserData, UserModule, OAuth2Client, } from './user/types.ts';
+export type { UserOptions, UserData, UserModule, OAuth2Client, OAuthProviderConfig, } from './user/types.ts';
 export type { UserInjected } from './user/types.ts';
 export { redis } from './redis/index.ts';
 export type { RedisOptions, RedisClient, RedisInjected } from './redis/types.ts';
@@ -66,8 +66,12 @@ export { health } from './health.ts';
 export type { HealthOptions } from './health.ts';
 export { analytics } from './analytics.ts';
 export type { AnalyticsOptions, AnalyticsModule } from './analytics.ts';
-export { preferences } from './preferences.ts';
-export type { PrefOptions } from './preferences.ts';
+export { theme } from './theme.ts';
+export type { ThemeOptions } from './theme.ts';
+export { i18n } from './i18n.ts';
+export type { I18nOptions } from './i18n.ts';
+export { flash } from './flash.ts';
+export type { FlashOptions } 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';
@@ -88,5 +92,7 @@ export type { WebhookOptions, WebhookModule, WebhookEvent, WebhookHandler, Platf
 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.ts';
-export type { KBOptions, KBIngestOptions, KBSearchResult, KBSearchOptions, KBListEntry, KBModule } from './kb.ts';
+export { knowledgeBase } from './kb/index.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';