weifuwu 0.25.2 → 0.27.0

package/dist/deploy/types.d.ts

@@ -1,53 +0,0 @@
-import type { IncomingMessage } from 'node:http';
-import type { Duplex } from 'node:stream';
-import type { Handler, Closeable } from '../types.ts';
-export interface DeployConfig {
-    domain?: string;
-    port?: number;
-    deployToken?: string;
-    defaultApp?: string;
-    apps: Record<string, AppConfig>;
-}
-export interface AppConfig {
-    dir?: string;
-    port?: number;
-    entry?: string;
-    path?: string;
-    env?: Record<string, string>;
-    healthEndpoint?: string;
-    buildCommand?: string;
-    ports?: [number, number];
-}
-export interface AppStatus {
-    name: string;
-    status: 'starting' | 'running' | 'stopped' | 'error';
-    port: number;
-    path?: string;
-    pid?: number;
-    uptime?: number;
-    error?: string;
-}
-export interface DeployServer extends Closeable {
-    close(): Promise<void>;
-    ready: Promise<void>;
-    url: string;
-    apps: {
-        list(): AppStatus[];
-        status(name: string): AppStatus | undefined;
-        deploy(name: string): Promise<void>;
-        restart(name: string): Promise<void>;
-        stop(name: string): Promise<void>;
-        start(name: string): Promise<void>;
-    };
-}
-export interface GatewayResult {
-    handler: Handler;
-    wsHandler: (req: IncomingMessage, socket: Duplex, head: Buffer) => void;
-}
-declare module '../types.ts' {
-    interface Context {
-        deploy?: {
-            appName?: string;
-        };
-    }
-}

package/dist/env.d.ts

@@ -1,69 +0,0 @@
-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).
- *
- * Used by modules that need to resolve package-internal files differently
- * depending on whether they are compiled (published npm package) or raw TS.
- */
-export declare function isBundled(): boolean;
-/**
- * Whether `NODE_ENV` is explicitly set to `'development'`.
- *
- * Used for dev-only features: HMR, livereload, React `createRoot` (not hydrate).
- * **Not** the opposite of {@link isProd} — when `NODE_ENV` is unset, both return `false`.
- */
-export declare function isDev(): boolean;
-/**
- * Whether `NODE_ENV` is explicitly set to `'production'`.
- *
- * Used for production-only behavior: plain-text 404, suppressed warnings, minified output.
- */
-export declare function isProd(): boolean;
-/**
- * Load environment variables from a `.env` file into `process.env`.
- *
- * Does **not** override existing `process.env` values.
- * Supports quoted values and inline comments.
- *
- * @param path - Path to `.env` file (default: `'.env'` relative to cwd).
- *
- * ```ts
- * import { loadEnv } from 'weifuwu'
- * loadEnv()
- * console.log(process.env.PORT)
- * ```
- */
-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/error-boundary.d.ts

@@ -1,2 +0,0 @@
-import type { Middleware } from './types.ts';
-export declare function errorBoundary(errorPath: string): Middleware;

package/dist/flash.d.ts

@@ -1,90 +0,0 @@
-/**
- * Flash message middleware.
- *
- * Provides a cookie-based flash message system:
- * - Read: `ctx.flash.value` parses the incoming flash cookie
- * - Write: `ctx.flash.set(data, location)` sets a new flash and redirects
- * - Auto-clear: after reading, the flash cookie is cleared from the response
- *
- * ```ts
- * import { flash } from 'weifuwu'
- *
- * app.use(flash())
- *
- * // Read flash
- * app.get('/', (req, ctx) => {
- *   const msg = ctx.flash.value  // e.g. { type: 'success', text: 'Saved!' }
- * })
- *
- * // Set flash + redirect
- * app.post('/save', async (req, ctx) => {
- *   await save()
- *   return ctx.flash.set({ type: 'success', text: 'Saved!' }, '/articles')
- * })
- * ```
- */
-import type { Context, Middleware } from './types.ts';
-declare module './types.ts' {
-    interface Context {
-        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 {
-    /**
-     * Cookie name to store the flash message.
-     * @default 'flash'
-     */
-    name?: string;
-}
-/**
- * Flash message object injected into `ctx.flash`.
- *
- * Access the current flash with `.value`, or set a new flash with `.set()`.
- * The `.value` is automatically cleared after being read.
- */
-export interface FlashInjected {
-    /**
-     * The flash value read from the incoming cookie.
-     * `undefined` if no flash cookie is present.
-     * Automatically cleared after the response is sent.
-     */
-    value: unknown;
-    /**
-     * Set a flash message and return a 302 redirect response.
-     *
-     * @param data - Any JSON-serializable value to store as the flash message.
-     * @param location - Redirect location (defaults to the `Referer` header).
-     * @returns A 302 Response with a `Set-Cookie` header.
-     *
-     * ```ts
-     * return ctx.flash.set({ type: 'success', text: 'Saved!' }, '/articles')
-     * ```
-     */
-    set: (data: unknown, location?: string) => Response;
-}
-/**
- * Flash message middleware — injects `ctx.flash`.
- *
- * @param options - Cookie name configuration.
- * @returns Middleware that injects `ctx.flash` (`FlashInjected`).
- *
- * ```ts
- * app.use(flash())
- *
- * // Read
- * app.get('/', (req, ctx) => {
- *   const msg = ctx.flash.value
- * })
- *
- * // Write + redirect
- * app.post('/save', async (req, ctx) => {
- *   return ctx.flash.set({ type: 'success', text: 'Saved!' }, '/articles')
- * })
- * ```
- */
-export declare function flash(options?: FlashOptions): Middleware<Context, Context & {
-    flash: FlashInjected;
-}>;

package/dist/fts.d.ts

@@ -1,36 +0,0 @@
-import type { SqlClient } from './vendor.ts';
-import type { BoundTable } from './postgres/schema/index.ts';
-export interface FTSSearchResult {
-    /** Primary key value */
-    id: unknown;
-    /** Relevance score (0–1) */
-    rank: number;
-    /** The row data (all columns) */
-    row: Record<string, unknown>;
-    /** ts_headline highlighted snippet, if requested */
-    headline?: string;
-}
-export interface FTSCreateIndexOptions {
-    language?: string;
-    indexName?: string;
-    indexType?: 'gin' | 'gist';
-}
-export interface FTSSearchOptions {
-    fields?: string[];
-    limit?: number;
-    offset?: number;
-    headline?: boolean;
-    language?: string;
-    rankColumn?: string;
-    minRank?: number;
-}
-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: 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;
-}): Promise<string[]>;

package/dist/graphql.d.ts

@@ -1,16 +0,0 @@
-import { type GraphQLSchema } from 'graphql';
-import type { Context } from './types.ts';
-import { Router } from './router.ts';
-export interface GraphQLOptions {
-    schema: string | GraphQLSchema;
-    rootValue?: any;
-    resolvers?: any;
-    context?: (req: Request, ctx: Context) => Record<string, any> | Promise<Record<string, any>>;
-    graphiql?: boolean;
-    /** Max query depth (nesting). Default: 10. Set 0 to disable. */
-    maxDepth?: number;
-    /** Execution timeout in ms. Default: 30_000. */
-    timeout?: number;
-}
-export type GraphQLHandler = (req: Request, ctx: Context) => GraphQLOptions | Promise<GraphQLOptions>;
-export declare function graphql(handler: GraphQLHandler): Router;

package/dist/head.d.ts

@@ -1,6 +0,0 @@
-import { type ReactNode } from 'react';
-export declare function Head({ children }: {
-    children: ReactNode;
-}): import("react").DetailedReactHTMLElement<{
-    id: string;
-}, HTMLElement>;

package/dist/health.d.ts

@@ -1,24 +0,0 @@
-import { Router } from './router.ts';
-/** Options for {@link health}. */
-export interface HealthOptions {
-    /** Health check endpoint path (default: `'/__health'`). */
-    path?: string;
-    /** Async function that throws if the service is unhealthy. Called on each request. */
-    check?: () => Promise<void>;
-}
-/**
- * Health check endpoint.
- *
- * Returns 200 with `'OK'` if the check passes, 503 if it fails.
- *
- * ```ts
- * import { health } from 'weifuwu'
- *
- * app.use(health({
- *   check: async () => {
- *     await db.query('SELECT 1')
- *   },
- * }))
- * ```
- */
-export declare function health(options?: HealthOptions): Router;

package/dist/helmet.d.ts

@@ -1,33 +0,0 @@
-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. */
-    contentSecurityPolicy?: string | false;
-    /** `Cross-Origin-Embedder-Policy` header value. */
-    crossOriginEmbedderPolicy?: string | false;
-    /** `Cross-Origin-Opener-Policy` header value. */
-    crossOriginOpenerPolicy?: string | false;
-    /** `Cross-Origin-Resource-Policy` header value. */
-    crossOriginResourcePolicy?: string | false;
-    /** `Origin-Agent-Cluster` header value. */
-    originAgentCluster?: string | false;
-    /** `Referrer-Policy` header value. */
-    referrerPolicy?: string | false;
-    /** `Strict-Transport-Security` header value. */
-    strictTransportSecurity?: string | false;
-    /** `X-Content-Type-Options` header value. */
-    xContentTypeOptions?: string | false;
-    /** `X-DNS-Prefetch-Control` header value. */
-    xDnsPrefetchControl?: string | false;
-    /** `X-Download-Options` header value. */
-    xDownloadOptions?: string | false;
-    /** `X-Frame-Options` header value. */
-    xFrameOptions?: string | false;
-    /** `X-Permitted-Cross-Domain-Policies` header value. */
-    xPermittedCrossDomainPolicies?: string | false;
-    /** `X-XSS-Protection` header value. */
-    xXssProtection?: string | false;
-    /** `Permissions-Policy` header value. */
-    permissionsPolicy?: string | false;
-}
-export declare function helmet(options?: HelmetOptions): Middleware<Context, Context>;

package/dist/html-shell.d.ts

@@ -1 +0,0 @@
-export declare function buildHtmlShell(title: string, bodyElement: any, layoutComponents: any[]): any;

package/dist/hub.d.ts

@@ -1,37 +0,0 @@
-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. */
-    redis?: Redis;
-    /** Key prefix for Redis channels (default: `'hub:'`). */
-    prefix?: string;
-}
-/**
- * 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 extends Closeable {
-    /** Subscribe a WebSocket to a room/group. */
-    join(key: string, ws: WebSocket): void;
-    /** Unsubscribe a WebSocket from all rooms. */
-    leave(ws: WebSocket): void;
-    /** Send a JSON message to all members of a room. */
-    broadcast(key: string, data: unknown): void;
-    /** Close the hub, disconnect Redis subscribers, clear all rooms. */
-    close(): Promise<void>;
-}
-/**
- * Create a pub/sub hub for WebSocket room management.
- *
- * In-memory by default. Pass `redis` to enable cross-process broadcasting.
- *
- * ```ts
- * import { createHub } from 'weifuwu'
- *
- * const hub = createHub()
- * hub.join('room:general', ws)
- * hub.broadcast('room:general', { type: 'chat', text: 'Hello' })
- * ```
- */
-export declare function createHub(opts?: HubOptions): Hub;

package/dist/i18n.d.ts

@@ -1,39 +0,0 @@
-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;
-    /** 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;
-}
-/**
- * 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/client.d.ts

@@ -1,2 +0,0 @@
-import type { IIIModule, IIIOptions } from './types.ts';
-export declare function iii(_opts?: IIIOptions): IIIModule;

package/dist/iii/index.d.ts

@@ -1,4 +0,0 @@
-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';

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

@@ -1,9 +0,0 @@
-import type { FunctionHandler, TriggerInput, TriggerRequest } from './types.ts';
-export declare function registerWorker(url: string): {
-    registerFunction(id: string, handler: FunctionHandler): void;
-    unregisterFunction(id: string): void;
-    registerTrigger(input: TriggerInput): void;
-    unregisterTrigger(functionId: string): void;
-    trigger(request: TriggerRequest): Promise<unknown>;
-    close(): void;
-};

package/dist/iii/rest.d.ts

@@ -1,3 +0,0 @@
-import { Router } from '../router.ts';
-import type { IIIModule } from './types.ts';
-export declare function buildRouter(engine: IIIModule, wsHandler: any): Router;

package/dist/iii/stream.d.ts

@@ -1,82 +0,0 @@
-import type { Redis } from '../vendor.ts';
-import type { PostgresClient } from '../postgres/types.ts';
-import type { StreamUpdateOp, StreamSubscription } from './types.ts';
-export declare function createStream(opts?: {
-    pg?: PostgresClient;
-    redis?: Redis;
-    streamTTL?: number;
-}): {
-    subscribe(ws: WebSocket, sub: StreamSubscription): void;
-    unsubscribe(ws: WebSocket): void;
-    migrate(): Promise<void>;
-    close(): Promise<void>;
-    set(stream: string, group: string, item: string, data: unknown): Promise<{
-        old_value: null;
-        new_value: unknown;
-    }>;
-    get(stream: string, group: string, item: string): Promise<{
-        value: any;
-    }>;
-    delete(stream: string, group: string, item: string): Promise<{
-        old_value: any;
-    }>;
-    list(stream: string, group: string): Promise<{
-        items: {
-            item_id: any;
-            data: any;
-        }[];
-    }>;
-    list_groups(stream: string): Promise<{
-        groups: any[];
-    }>;
-    list_all(): Promise<{
-        streams: {
-            stream_name: any;
-            group_count: number;
-            item_count: number;
-        }[];
-        count: number;
-    }>;
-    send(stream: string, group: string, type: string, data: unknown, id?: string): Promise<void>;
-    update(stream: string, group: string, item: string, ops: StreamUpdateOp[]): Promise<{
-        old_value: any;
-        new_value: any;
-    }>;
-} | {
-    subscribe(ws: WebSocket, sub: StreamSubscription): void;
-    unsubscribe(ws: WebSocket): void;
-    migrate(): Promise<void>;
-    close(): Promise<void>;
-    set(stream: string, group: string, item: string, data: unknown): Promise<{
-        old_value: unknown;
-        new_value: unknown;
-    }>;
-    get(stream: string, group: string, item: string): Promise<{
-        value: any;
-    }>;
-    delete(stream: string, group: string, item: string): Promise<{
-        old_value: any;
-    }>;
-    list(stream: string, group: string): Promise<{
-        items: {
-            item_id: string;
-            data: any;
-        }[];
-    }>;
-    list_groups(stream: string): Promise<{
-        groups: string[];
-    }>;
-    list_all(): Promise<{
-        streams: {
-            stream_name: string;
-            group_count: number;
-            item_count: number;
-        }[];
-        count: number;
-    }>;
-    send(stream: string, group: string, type: string, data: unknown, id?: string): Promise<void>;
-    update(stream: string, group: string, item: string, ops: StreamUpdateOp[]): Promise<{
-        old_value: any;
-        new_value: any;
-    }>;
-};

package/dist/iii/types.d.ts

@@ -1,121 +0,0 @@
-import type { Router } from '../router.ts';
-import type { Closeable } from '../types.ts';
-import type { PostgresClient } from '../postgres/types.ts';
-/** A function handler receives a payload and returns a result. */
-export type FunctionHandler = (payload: unknown, ctx: FunctionContext) => unknown | Promise<unknown>;
-export interface FunctionContext {
-    engine: IIIModule;
-    functionId: string;
-    workerName: string;
-    user?: unknown;
-}
-/** Optional metadata for a trigger — iii does NOT schedule triggers, just stores them for reference. */
-export interface TriggerInput {
-    type: string;
-    function_id: string;
-    config: Record<string, unknown>;
-}
-export interface IIIOptions {
-    pg?: PostgresClient;
-}
-export interface TriggerRequest {
-    function_id: string;
-    payload: unknown;
-    action?: 'sync' | 'void';
-    timeout_ms?: number;
-}
-/** III (跨进程函数调用) module — register remote workers and call functions across processes. */
-export interface IIIModule extends Router, Closeable {
-    wsHandler: () => any;
-    /** Register a local worker. Its functions become callable via trigger(). */
-    addWorker: (worker: Worker) => void;
-    /** Call a function by ID. Returns the function's result. */
-    trigger: (request: TriggerRequest) => Promise<unknown>;
-    /** Remove a previously registered worker. */
-    removeWorker: (worker: Worker) => void;
-    /** List all registered workers. */
-    listWorkers: () => WorkerInfo[];
-    /** List all registered functions. */
-    listFunctions: () => FunctionInfo[];
-    /** List all registered trigger metadata. */
-    listTriggers: () => TriggerInfo[];
-    /** Create the database tables (currently no-op, kept for API compatibility). */
-    migrate: () => Promise<void>;
-    /** Shutdown — reject pending invocations, disconnect all workers. */
-    close: () => Promise<void>;
-}
-export interface WorkerInfo {
-    id: string;
-    name: string;
-    status: 'connected' | 'disconnected';
-    connectedAt: number;
-    functionCount: number;
-    triggerCount: number;
-}
-export interface FunctionInfo {
-    id: string;
-    workerId: string;
-    workerName: string;
-    triggers: string[];
-}
-export interface TriggerInfo {
-    id: string;
-    type: string;
-    function_id: string;
-    config: Record<string, unknown>;
-    workerId: string;
-}
-/** A worker — a group of related functions. */
-export interface Worker {
-    readonly name: string;
-    /** Register a function that can be called remotely. */
-    registerFunction: (id: string, handler: FunctionHandler, opts?: {
-        description?: string;
-    }) => Worker;
-    /** Unregister a function. */
-    unregisterFunction: (id: string) => Worker;
-    /** Attach metadata (the module does NOT schedule — it's stored for introspection). */
-    registerTrigger: (input: TriggerInput) => Worker;
-    /** Remove trigger metadata. */
-    unregisterTrigger: (functionId: string) => Worker;
-    /** Get all registered functions. */
-    getFunctions: () => {
-        id: string;
-        handler: FunctionHandler;
-    }[];
-    /** Get all registered trigger metadata. */
-    getTriggers: () => {
-        id: string;
-        input: TriggerInput;
-    }[];
-}
-/** A handle to interact with a remote worker from the client side. */
-export interface RemoteWorker {
-    registerFunction: (id: string, handler: FunctionHandler) => void;
-    unregisterFunction: (id: string) => void;
-    registerTrigger: (input: TriggerInput) => void;
-    unregisterTrigger: (functionId: string) => void;
-    trigger: (request: TriggerRequest) => Promise<unknown>;
-    close: () => void;
-}
-export interface FunctionRegistration {
-    id: string;
-    handler: FunctionHandler;
-    workerId: string;
-    workerName: string;
-    triggers: string[];
-}
-export interface TriggerRegistration {
-    id: string;
-    type: string;
-    function_id: string;
-    config: Record<string, unknown>;
-    workerId: string;
-}
-export interface WorkerRegistration {
-    id: string;
-    name: string;
-    ws?: WebSocket;
-    functions: FunctionRegistration[];
-    triggers: TriggerRegistration[];
-}

package/dist/iii/worker.d.ts

@@ -1,2 +0,0 @@
-import type { Worker } from './types.ts';
-export declare function createWorker(name: string): Worker;

package/dist/iii/ws.d.ts

@@ -1,22 +0,0 @@
-import type { Context } from '../types.ts';
-interface WsHandlerDeps {
-    registerRemoteWorker: (ws: WebSocket, name: string) => string;
-    unregisterRemoteWorker: (workerId: string) => void;
-    registerRemoteFunction: (workerId: string, id: string) => void;
-    unregisterRemoteFunction: (workerId: string, id: string) => void;
-    registerRemoteTrigger: (workerId: string, input: {
-        type: string;
-        function_id: string;
-        config: Record<string, unknown>;
-    }) => void;
-    unregisterRemoteTrigger: (workerId: string, functionId: string) => void;
-    handleInvokeResult: (invocationId: string, result: unknown) => void;
-    handleInvokeError: (invocationId: string, error: string) => void;
-    handleInvoke: (ws: WebSocket, invocationId: string, functionId: string, payload: unknown) => void;
-}
-export declare function createWsHandler(deps: WsHandlerDeps): {
-    open(_ws: WebSocket, _ctx: Context): void;
-    message(ws: WebSocket, ctx: Context, data: string | Buffer): Promise<void>;
-    close(ws: WebSocket): void;
-};
-export {};