weifuwu 0.25.2 → 0.27.0

package/queue/types.ts

@@ -0,0 +1,60 @@
+import type { Redis, Context, Middleware, Closeable } from '../types.ts'
+
+declare module '../types.ts' {
+  interface Context {
+    queue: Queue
+  }
+}
+
+export interface QueueJob<T = unknown> {
+  id: string
+  type: string
+  payload: T
+  createdAt: number
+  runAt: number
+  schedule?: string
+}
+
+export interface QueueOptions {
+  /** Backend store. Default: 'memory'. */
+  store?: 'memory' | 'pg' | 'redis'
+  redis?: Redis
+  url?: string
+  prefix?: string
+  pollInterval?: number
+  /** PostgreSQL client (required when store: 'pg'). */
+  pg?: { sql: import('../types.ts').SqlClient }
+}
+
+export interface QueueInjected {
+  queue: Queue
+}
+
+export interface QueueJobWithError<T = unknown> extends QueueJob<T> {
+  error: string
+  failedAt: number
+}
+
+export interface Queue extends Middleware<Context, Context & QueueInjected>, Closeable {
+  /** Register a cron job. Uses queue's backend (memory/pg/redis) for execution. */
+  cron(pattern: string, handler: () => void | Promise<void>): { stop: () => void }
+  add<T>(type: string, payload: T, opts?: { delay?: number; schedule?: string }): Promise<string>
+  process<T>(type: string, handler: (job: QueueJob<T>) => Promise<void>): void
+  run(): Promise<void>
+  stats(): {
+    running: boolean
+    inflight: number
+    processed: number
+    failed: number
+    handlers: number
+    maxConcurrent: number
+  }
+  jobs(limit?: number): Promise<QueueJob[]>
+  failedJobs(limit?: number): Promise<QueueJobWithError[]>
+  retryFailed(jobId: string): Promise<boolean>
+  retryAllFailed(type?: string): Promise<number>
+  dashboard(): import('../core/router.ts').Router
+  /** Create the jobs table (PG mode only; safe to call multiple times). */
+  migrate?(): Promise<void>
+  close(): Promise<void>
+}

package/redis/client.ts

@@ -0,0 +1,24 @@
+/* eslint-disable no-console */
+import { Redis as IORedis } from 'ioredis'
+import type { Context, Handler } from '../types.ts'
+import type { RedisOptions, RedisClient } from './types.ts'
+
+export function redis(opts?: string | RedisOptions): RedisClient {
+  const options: RedisOptions = typeof opts === 'string' ? { url: opts } : (opts ?? {})
+
+  const url = options.url ?? process.env.REDIS_URL ?? 'redis://localhost:6379'
+  const client = new IORedis(url, options)
+
+  client.on('error', (err: Error) => console.error('[redis]', err.message))
+
+  const mw = ((req: Request, ctx: Context, next: Handler) => {
+    ctx.redis = client
+    return next(req, ctx)
+  }) as unknown as RedisClient
+
+  mw.__meta = { injects: ['redis'], depends: [] }
+  mw.redis = client
+  mw.close = () => client.quit() as unknown as Promise<void>
+
+  return mw
+}

package/{dist/redis/index.d.ts → redis/index.ts}

@@ -1,2 +1,2 @@
-export { redis } from './client.ts';
-export type { RedisOptions, RedisClient, RedisInjected } from './types.ts';
+export { redis } from './client.ts'
+export type { RedisOptions, RedisClient, RedisInjected } from './types.ts'

package/redis/types.ts

@@ -0,0 +1,28 @@
+import type {
+  Redis,
+  RedisOptions as IORedisOptions,
+  Context,
+  Middleware,
+  Closeable,
+} from '../types.ts'
+
+declare module '../types.ts' {
+  interface Context {
+    redis: Redis
+  }
+}
+
+export type { Redis }
+
+export type RedisOptions = IORedisOptions & {
+  url?: string
+}
+
+export interface RedisInjected {
+  redis: Redis
+}
+
+export interface RedisClient extends Middleware<Context, Context & RedisInjected>, Closeable {
+  redis: Redis
+  close: () => Promise<void>
+}

package/types.ts

@@ -0,0 +1,78 @@
+import type postgres from 'postgres'
+
+/** Untyped postgres.js SQL client. Use typed `Sql<{ table: { col: type } }>` for schemas. */
+export type SqlClient = postgres.Sql<Record<string, unknown>>
+
+/** Re-export for downstream usage. */
+export type { Sql } from 'postgres'
+export type { WebSocket } from 'ws'
+export type { Redis, RedisOptions } from 'ioredis'
+
+// Context — extensible via module augmentation.
+// Built-in middleware modules declare additional properties here.
+// e.g. postgres/types.ts → `declare module '../types.ts' { interface Context { sql: SqlClient } }`
+export interface Context {
+  params: Record<string, string>
+  query: Record<string, string>
+  mountPath?: string
+  [key: string]: unknown // allow arbitrary middleware-injected data
+}
+
+// Generic handler — T extends Context so middleware-injected properties are visible.
+// Default T = Context means no generics needed for simple cases.
+export type Handler<T extends Context = Context> = (
+  req: Request,
+  ctx: T,
+) => 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[]
+}
+
+// Generic middleware — In receives accumulated context from previous middlewares,
+// Out adds new properties. next receives the enriched Out type.
+// Default In = Out = Context means backward-compatible.
+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).
+ * All stateful modules implement this.
+ */
+export interface Closeable {
+  /** Release all resources. Call once when shutting down. */
+  close(): Promise<void>
+}
+
+/**
+ * HTTP error with an explicit status code.
+ * Throw from a handler or middleware to return a non-200 response.
+ *
+ * ```ts
+ * if (!resource) throw new HttpError('Not found', 404)
+ * serve() catches it and returns the status code.
+ * ```
+ */
+export class HttpError extends Error {
+  status: number
+  constructor(message: string, status: number) {
+    super(message)
+    this.name = 'HttpError'
+    this.status = status
+  }
+}

package/cli/template/app.ts

@@ -1,22 +0,0 @@
-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(async (req, ctx, next) => {
-  ctx.loaderData = {
-    features: [
-      { title: 'SSR + HMR', desc: 'State-preserving hot reload' },
-      { title: 'i18n', desc: 'Built-in internationalization' },
-      { title: 'Theme', desc: 'Light/dark mode toggle' },
-    ],
-  }
-  return next(req, ctx)
-})
-app.get('/api/ping', () => Response.json({ pong: true, time: new Date().toISOString() }))
-app.ws('/ws/echo', {
-  message(ws, _ctx, data) {
-    ws.send(`echo: ${data}`)
-  },
-})

package/cli/template/index.ts

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

package/cli/template/locales/en.json

@@ -1,13 +0,0 @@
-{
-  "nav": { "home": "Home", "docs": "Docs", "api": "API" },
-  "hero": { "title": "Build Faster", "subtitle": "A modern web framework for Node.js" },
-  "cta": { "start": "Get Started", "learn": "Learn More" },
-  "demo": {
-    "title": "WebSocket Demo",
-    "placeholder": "Type a message...",
-    "send": "Send",
-    "echo": "Echo"
-  },
-  "ws": { "connected": "Connected", "connecting": "Connecting...", "disconnected": "Disconnected" },
-  "footer": { "privacy": "Privacy", "terms": "Terms" }
-}

package/cli/template/locales/zh-CN.json

@@ -1,13 +0,0 @@
-{
-  "nav": { "home": "首页", "docs": "文档", "api": "API" },
-  "hero": { "title": "更快地构建", "subtitle": "一个现代的 Node.js Web 框架" },
-  "cta": { "start": "开始使用", "learn": "了解更多" },
-  "demo": {
-    "title": "WebSocket 演示",
-    "placeholder": "输入消息...",
-    "send": "发送",
-    "echo": "回声"
-  },
-  "ws": { "connected": "已连接", "connecting": "连接中...", "disconnected": "未连接" },
-  "footer": { "privacy": "隐私", "terms": "条款" }
-}

package/cli/template/locales/zh-TW.json

@@ -1,13 +0,0 @@
-{
-  "nav": { "home": "首頁", "docs": "文件", "api": "API" },
-  "hero": { "title": "更快構建", "subtitle": "一個現代的 Node.js Web 框架" },
-  "cta": { "start": "開始使用", "learn": "了解更多" },
-  "demo": {
-    "title": "WebSocket 演示",
-    "placeholder": "輸入訊息...",
-    "send": "發送",
-    "echo": "回聲"
-  },
-  "ws": { "connected": "已連線", "connecting": "連線中...", "disconnected": "未連線" },
-  "footer": { "privacy": "隱私", "terms": "條款" }
-}

package/cli/template/locales/zh.json

@@ -1,13 +0,0 @@
-{
-  "nav": { "home": "首页", "docs": "文档", "api": "API" },
-  "hero": { "title": "更快地构建", "subtitle": "一个现代的 Node.js Web 框架" },
-  "cta": { "start": "开始使用", "learn": "了解更多" },
-  "demo": {
-    "title": "WebSocket 演示",
-    "placeholder": "输入消息...",
-    "send": "发送",
-    "echo": "回声"
-  },
-  "ws": { "connected": "已连接", "connecting": "连接中...", "disconnected": "未连接" },
-  "footer": { "privacy": "隐私", "terms": "条款" }
-}

package/cli/template/ui/app/globals.css

@@ -1,2 +0,0 @@
-@import 'tailwindcss';
-@variant dark (&:where([data-theme="dark"] *));

package/cli/template/ui/app/layout.tsx

@@ -1,15 +0,0 @@
-import { ReactNode } from 'react'
-
-export default function RootLayout({ children }: { children: ReactNode }) {
-  return (
-    <html lang="en">
-      <head>
-        <meta charSet="utf-8" />
-        <meta name="viewport" content="width=device-width, initial-scale=1" />
-      </head>
-      <body>
-        <main>{children}</main>
-      </body>
-    </html>
-  )
-}

package/cli/template/ui/app/page.tsx

@@ -1,124 +0,0 @@
-import { useState } from 'react'
-import { useWebsocket, useLoaderData, useLocale, useTheme } from '../../../../react.ts'
-import Greeting from '../components/Greeting.tsx'
-
-export default function Home() {
-  const [input, setInput] = useState('')
-  const { send, lastMessage, readyState } = useWebsocket('/ws/echo')
-  const { locale, t, setLocale } = useLocale()
-  const { resolvedTheme, setTheme } = useTheme()
-  const ld = useLoaderData<{ features?: { title: string; desc: string }[] }>()
-
-  return (
-    <div className="min-h-screen bg-white dark:bg-gray-950 text-gray-900 dark:text-gray-100">
-      {/* Navbar */}
-      <header className="border-b dark:border-gray-800">
-        <div className="max-w-5xl mx-auto flex items-center justify-between h-14 px-4">
-          <span className="font-bold text-lg">weifuwu</span>
-          <nav className="hidden sm:flex gap-6 text-sm">
-            <span className="hover:text-blue-600 transition cursor-pointer">{t('nav.home')}</span>
-            <span className="hover:text-blue-600 transition cursor-pointer">{t('nav.docs')}</span>
-            <span className="hover:text-blue-600 transition cursor-pointer">{t('nav.api')}</span>
-          </nav>
-          <div className="flex items-center gap-2 text-sm">
-            <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"
-            >
-              {locale === 'en' ? '中文' : 'EN'}
-            </button>
-            <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"
-            >
-              {resolvedTheme === 'light' ? '🌙' : '☀️'}
-            </button>
-          </div>
-        </div>
-      </header>
-
-      {/* Hero */}
-      <section className="text-center py-20 px-4">
-        <h1 className="text-5xl font-bold mb-4">{t('hero.title')}</h1>
-        <p className="text-xl text-gray-500 dark:text-gray-400 mb-8">{t('hero.subtitle')}</p>
-        <Greeting name="Weifuwu" />
-        <div className="flex justify-center gap-4 mt-8">
-          <a
-            href="#"
-            className="px-6 py-2.5 bg-blue-600 text-white rounded-lg hover:bg-blue-700 transition font-medium"
-          >
-            {t('cta.start')}
-          </a>
-          <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"
-          >
-            {t('cta.learn')}
-          </a>
-        </div>
-      </section>
-
-      {/* Features */}
-      {ld.features && (
-        <section className="max-w-4xl mx-auto grid grid-cols-1 md:grid-cols-3 gap-6 px-4 pb-20">
-          {ld.features.map((f, i) => (
-            <div
-              key={i}
-              className="p-6 rounded-xl border dark:border-gray-800 bg-gray-50 dark:bg-gray-900"
-            >
-              <h3 className="font-semibold mb-2">{f.title}</h3>
-              <p className="text-sm text-gray-500 dark:text-gray-400">{f.desc}</p>
-            </div>
-          ))}
-        </section>
-      )}
-
-      {/* WebSocket demo */}
-      <section className="max-w-xl mx-auto px-4 pb-20">
-        <div className="border dark:border-gray-800 rounded-xl p-6 bg-gray-50 dark:bg-gray-900 space-y-4">
-          <h2 className="font-semibold">{t('demo.title')}</h2>
-          <p className="text-sm text-gray-500 dark:text-gray-400">
-            {readyState === 1
-              ? t('ws.connected')
-              : readyState === 0
-                ? t('ws.connecting')
-                : t('ws.disconnected')}
-          </p>
-          <div className="flex gap-2">
-            <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"
-            />
-            <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"
-            >
-              {t('demo.send')}
-            </button>
-          </div>
-          {lastMessage && (
-            <p className="text-sm text-gray-600 dark:text-gray-400">
-              <span className="font-medium">{t('demo.echo')}:</span> {lastMessage}
-            </p>
-          )}
-        </div>
-      </section>
-
-      {/* Footer */}
-      <footer className="border-t dark:border-gray-800 py-8 text-center text-sm text-gray-500">
-        © 2026 MyApp · {t('footer.privacy')} · {t('footer.terms')}
-      </footer>
-    </div>
-  )
-}

package/cli/template/ui/components/Greeting.tsx

@@ -1,3 +0,0 @@
-export default function Greeting({ name }: { name: string }) {
-  return <span className="text-red-500 font-bold">{name}!</span>
-}

package/dist/agent/client.d.ts

@@ -1,2 +0,0 @@
-import type { AgentOptions, AgentModule } from './types.ts';
-export declare function agent(options: AgentOptions): AgentModule;

package/dist/agent/index.d.ts

@@ -1,2 +0,0 @@
-export { agent } from './client.ts';
-export type { AgentOptions, AgentModule, AgentConfig, RunParams, RunResult } from './types.ts';

package/dist/agent/rest.d.ts

@@ -1,14 +0,0 @@
-import { Router } from '../router.ts';
-import { type BoundTable } from '../postgres/schema/index.ts';
-import type { RunParams } from './types.ts';
-interface RestDeps {
-    agents: BoundTable<any>;
-    runs: BoundTable<any>;
-    knowledge: BoundTable<any>;
-    runner: {
-        run: (agentId: number, params: RunParams) => Promise<any>;
-        addKnowledge: (agentId: number, title: string, content: string) => Promise<any>;
-    };
-}
-export declare function buildRouter(deps: RestDeps): Router;
-export {};

package/dist/agent/run.d.ts

@@ -1,19 +0,0 @@
-import { type Tool } from 'ai';
-import type { SqlClient } 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: SqlClient;
-    agents: BoundTable<Record<string, unknown>>;
-    runs: BoundTable<Record<string, unknown>>;
-    knowledge: BoundTable<Record<string, unknown>>;
-    provider: AIProvider;
-    modelName?: string;
-    userTools?: Record<string, Tool>;
-}
-export declare function createRunner(deps: RunnerDeps): {
-    run: (agentId: number, params: RunParams) => Promise<RunResult>;
-    addKnowledge: (agentId: number, title: string, content: string) => Promise<KnowledgeDoc>;
-};
-export {};

package/dist/agent/types.d.ts

@@ -1,55 +0,0 @@
-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;
-    name: string;
-    description: string;
-    type: 'chat' | 'tool-use';
-    model: string;
-    system_prompt: string;
-    owner_id: number;
-    active: boolean;
-    created_at: string;
-    updated_at: string;
-}
-export interface KnowledgeDoc {
-    id: number;
-    agent_id: number;
-    title: string;
-    content: string;
-    embedding?: number[];
-    metadata: Record<string, unknown>;
-    created_at: string;
-}
-export interface RunParams {
-    input: string;
-    stream?: boolean;
-    messages?: Array<{
-        role: string;
-        content: string;
-    }>;
-}
-export type RunResult = {
-    output: string;
-    elapsed: number;
-} | {
-    stream: ReadableStream<Uint8Array>;
-};
-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;
-    tools?: Record<string, Tool>;
-}
-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>;
-    close: () => Promise<void>;
-}

package/dist/ai/provider.d.ts

@@ -1,45 +0,0 @@
-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;
-    /** 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): Middleware<Context, Context & AIProviderInjected> & AIProvider;

package/dist/ai/utils.d.ts

@@ -1,5 +0,0 @@
-/**
- * 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,17 +0,0 @@
-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;
-    nodes?: any[];
-}, {
-    result: unknown;
-    nodeOutputs: {
-        [k: string]: unknown;
-    };
-}>;

package/dist/ai-sdk.d.ts

@@ -1,2 +0,0 @@
-export { streamText, generateText, generateObject, streamObject, tool, embed, embedMany, smoothStream, } from 'ai';
-export { openai, createOpenAI } from '@ai-sdk/openai';

package/dist/ai.d.ts

@@ -1,13 +0,0 @@
-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>;
-/**
- * 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>;