@ubean/shared 0.4.5 → 0.4.6

package/dist/index.d.ts

@@ -7,19 +7,19 @@ import { StandardSchemaV1 } from "@standard-schema/spec";
  * 基础路由元数据,由 @ubean/scan 使用。
  * 扩展的 RouteMeta 在此处定义,增加了 rateLimit 和 cache 字段。
  */
-interface BaseRouteMeta {
+export interface BaseRouteMeta {
   requiresAuth?: boolean;
   [key: string]: unknown;
 }
-interface RateLimitMeta {
+export interface RateLimitMeta {
   maxRequests: number;
   windowSeconds: number;
 }
-interface CacheMeta {
+export interface CacheMeta {
   ttl: number;
   swr?: boolean;
 }
-interface RouteMeta extends BaseRouteMeta {
+export interface RouteMeta extends BaseRouteMeta {
   rateLimit?: RateLimitMeta;
   cache?: CacheMeta;
 }
@@ -30,7 +30,7 @@ interface RouteMeta extends BaseRouteMeta {
  * - 对象形式可显式指定 `swr` 启用 stale-while-revalidate 语义
  *   (返回过期内容 + 后台异步重新生成)
  */
-interface IsrRule {
+export interface IsrRule {
   /** 缓存有效期(秒)。过期后下次请求触发重新生成 */
   ttl: number;
   /** 是否启用 stale-while-revalidate:过期时先返回旧内容,后台异步刷新 */
@@ -59,7 +59,7 @@ interface IsrRule {
  * `prerender: true` 的路由会被 `collectPrerenderRoutes` 加入队列(受
  * `PrerenderConfig.exclude` 过滤)。`ppr: true` 隐含 `prerender: true`。
  */
-interface RouteRule {
+export interface RouteRule {
   cache?: {
     ttl?: number;
     swr?: boolean;
@@ -99,31 +99,31 @@ interface RouteRule {
    */
   ppr?: boolean;
 }
-type SpanStatus = 'ok' | 'error' | 'cancelled';
-interface SpanAttributes {
+export type SpanStatus = 'ok' | 'error' | 'cancelled';
+export interface SpanAttributes {
   [key: string]: string | number | boolean | undefined | null;
 }
-interface SpanContext {
+export interface SpanContext {
   traceId: string;
   spanId: string;
   parentSpanId?: string;
 }
-interface SpanEndOptions {
+export interface SpanEndOptions {
   status?: SpanStatus;
   error?: Error;
   attributes?: SpanAttributes;
 }
-interface SpanEvent {
+export interface SpanEvent {
   name: string;
   timestamp: number;
   attributes?: SpanAttributes;
 }
-interface SpanOptions {
+export interface SpanOptions {
   name: string;
   attributes?: SpanAttributes;
   parent?: Span | SpanContext;
 }
-interface Span {
+export interface Span {
   readonly name: string;
   readonly context: SpanContext;
   readonly startTime: number;
@@ -140,7 +140,7 @@ interface Span {
   isRecording(): boolean;
   duration(): number | undefined;
 }
-interface PageHead {
+export interface PageHead {
   title?: string;
   meta?: Array<Record<string, string>>;
   link?: Array<Record<string, string>>;
@@ -148,7 +148,7 @@ interface PageHead {
   htmlAttrs?: Record<string, string>;
   bodyAttrs?: Record<string, string>;
 }
-interface UbeanVariables extends RequestIdVariables {
+export interface UbeanVariables extends RequestIdVariables {
   route: {
     meta: RouteMeta;
     path: string;
@@ -164,14 +164,14 @@ interface UbeanVariables extends RequestIdVariables {
    */
   routeRule?: RouteRule;
 }
-interface UbeanBindings {}
-interface UbeanEnv extends Env {
+export interface UbeanBindings {}
+export interface UbeanEnv extends Env {
   Variables: UbeanVariables;
   Bindings: UbeanBindings;
 }
-type UbeanContext = Context<UbeanEnv>;
-type Input = Input$1;
-interface GenericSchema<O = unknown> {
+export type UbeanContext = Context<UbeanEnv>;
+export type Input = Input$1;
+export interface GenericSchema<O = unknown> {
   safeParse?(value: unknown): {
     success: boolean;
     data?: O;
@@ -184,9 +184,9 @@ interface GenericSchema<O = unknown> {
   parse?(value: unknown): O;
   _output?: O;
 }
-type UbeanMiddleware<I extends Input = {}> = MiddlewareHandler<UbeanEnv, any, I>;
-type UbeanHandler<I extends Input = {}, R extends HandlerResponse<any> = HandlerResponse<any>> = Handler<UbeanEnv, any, I, R>;
-type ComposedHandler = MiddlewareHandler<UbeanEnv>;
+export type UbeanMiddleware<I extends Input = {}> = MiddlewareHandler<UbeanEnv, any, I>;
+export type UbeanHandler<I extends Input = {}, R extends HandlerResponse<any> = HandlerResponse<any>> = Handler<UbeanEnv, any, I, R>;
+export type ComposedHandler = MiddlewareHandler<UbeanEnv>;
 /**
  * Action ID — a stable string identifier for a server action.
  *
@@ -194,7 +194,7 @@ type ComposedHandler = MiddlewareHandler<UbeanEnv>;
  * the client and server sides agree on the same ID without runtime
  * coordination. Format: `<base32(sha1(relPath:exportName))>`.
  */
-type ActionId = string;
+export type ActionId = string;
 /**
  * Context passed to every server action handler.
  *
@@ -202,7 +202,7 @@ type ActionId = string;
  * - `context`: the Hono context (for `c.set`, `c.get`, `c.req`, etc.)
  * - `params`: route params extracted from the URL (for page-level actions)
  */
-interface ActionContext {
+export interface ActionContext {
   request: Request;
   context: Context<UbeanEnv>;
   params: Record<string, string>;
@@ -221,7 +221,7 @@ interface ActionContext {
  * Either `data` (success), `error`/`errors` (failure), or `response`
  * (passthrough) is set; never more than one.
  */
-interface ActionResult<T = unknown> {
+export interface ActionResult<T = unknown> {
   data?: T;
   error?: {
     message: string;
@@ -242,7 +242,7 @@ interface ActionResult<T = unknown> {
  * The handler may return any serializable value, throw an `ActionError`,
  * or call `fail()` to return field-level validation errors.
  */
-type ActionHandler<TInput = unknown, TOutput = unknown> = (input: TInput, ctx: ActionContext) => Promise<TOutput | ActionFailure> | TOutput | ActionFailure;
+export type ActionHandler<TInput = unknown, TOutput = unknown> = (input: TInput, ctx: ActionContext) => Promise<TOutput | ActionFailure> | TOutput | ActionFailure;
 /**
  * Field-level validation failure (SvelteKit-style).
  *
@@ -250,7 +250,7 @@ type ActionHandler<TInput = unknown, TOutput = unknown> = (input: TInput, ctx: A
  * back to the form without throwing. The page can read `result.errors` to
  * display per-field messages.
  */
-interface ActionFailure<T = Record<string, string>> {
+export interface ActionFailure<T = Record<string, string>> {
   __actionFailure: true;
   status: number;
   errors: T;
@@ -261,7 +261,7 @@ interface ActionFailure<T = Record<string, string>> {
  * Any Standard Schema (`safeParse`/`parse`) or a function
  * `(value: unknown) => { success: true; data } | { success: false; error }`.
  */
-interface ActionSchema<TOutput = unknown> {
+export interface ActionSchema<TOutput = unknown> {
   safeParse?(value: unknown): {
     success: boolean;
     data?: TOutput;
@@ -293,7 +293,7 @@ interface ActionSchema<TOutput = unknown> {
  * The function is callable server-side (direct invocation with typed input)
  * and is replaced by an RPC stub on the client (POST to `/__actions`).
  */
-interface ServerAction<TInput = unknown, TOutput = unknown> {
+export interface ServerAction<TInput = unknown, TOutput = unknown> {
   /** Stable action ID (file path + export name hash). */
   id: ActionId;
   /** The handler that runs server-side. */
@@ -308,18 +308,18 @@ interface ServerAction<TInput = unknown, TOutput = unknown> {
 /**
  * Brand used to identify a server action at runtime (`Symbol`).
  */
-declare const ACTION_BRAND: unique symbol;
+export declare const ACTION_BRAND: unique symbol;
 /**
  * Type guard: is the value a registered `ServerAction`?
  */
-declare function isServerAction(value: unknown): value is ServerAction;
+export declare function isServerAction(value: unknown): value is ServerAction;
 /**
  * Error thrown by action handlers to signal a user-facing error.
  *
  * The `code` field can be used for programmatic error handling on the client
  * (e.g. `err.code === 'INVALID_CREDENTIALS'`).
  */
-declare class ActionError extends Error {
+export declare class ActionError extends Error {
   code?: string;
   status: number;
   constructor(message: string, opts?: {
@@ -340,42 +340,42 @@ declare class ActionError extends Error {
  * });
  * ```
  */
-declare function fail<T extends Record<string, string>>(status: number, errors: T): ActionFailure<T>;
+export declare function fail<T extends Record<string, string>>(status: number, errors: T): ActionFailure<T>;
 /**
  * Type guard: is the value an `ActionFailure` (returned by `fail()`)?
  */
-declare function isActionFailure(value: unknown): value is ActionFailure;
+export declare function isActionFailure(value: unknown): value is ActionFailure;
 //#endregion
 //#region src/error.d.ts
-declare class UbeanError extends Error {
+export declare class UbeanError extends Error {
   statusCode: number;
   statusMessage: string;
   data?: unknown;
   constructor(statusCode: number, statusMessage?: string, data?: unknown);
 }
-declare function createError(options: {
+export declare function createError(options: {
   statusCode: number;
   statusMessage?: string;
   data?: unknown;
   message?: string;
 }): UbeanError;
-declare function isUbeanError(err: unknown): err is UbeanError;
-declare function errorToResponse(c: unknown, err?: unknown): Response;
+export declare function isUbeanError(err: unknown): err is UbeanError;
+export declare function errorToResponse(c: unknown, err?: unknown): Response;
 //#endregion
 //#region src/env.d.ts
-type EnvSchema = Record<string, StandardSchemaV1 | GenericSchema | {
+export type EnvSchema = Record<string, StandardSchemaV1 | GenericSchema | {
   type: StringConstructor | NumberConstructor | BooleanConstructor;
   default?: unknown;
   required?: boolean;
 }>;
-type InferEnvOutput<S extends EnvSchema> = { [K in keyof S]: S[K] extends StandardSchemaV1 ? StandardSchemaV1.InferOutput<S[K]> : S[K] extends GenericSchema<infer O> ? O : S[K] extends {
+export type InferEnvOutput<S extends EnvSchema> = { [K in keyof S]: S[K] extends StandardSchemaV1 ? StandardSchemaV1.InferOutput<S[K]> : S[K] extends GenericSchema<infer O> ? O : S[K] extends {
   type: StringConstructor;
 } ? string : S[K] extends {
   type: NumberConstructor;
 } ? number : S[K] extends {
   type: BooleanConstructor;
 } ? boolean : string; };
-interface EnvConfig<S extends EnvSchema = EnvSchema> {
+export interface EnvConfig<S extends EnvSchema = EnvSchema> {
   /** Server-only env variables (not exposed to client) */
   server?: S;
   /** Public env variables (exposed to client via import.meta.env) */
@@ -383,7 +383,7 @@ interface EnvConfig<S extends EnvSchema = EnvSchema> {
   /** Validation mode - 'warn' logs errors, 'throw' throws on validation failure */
   mode?: 'warn' | 'throw';
 }
-interface DefineEnvResult<S extends EnvSchema> {
+export interface DefineEnvResult<S extends EnvSchema> {
   readonly env: InferEnvOutput<S>;
   validate(source?: Record<string, string | undefined>): {
     success: boolean;
@@ -391,40 +391,40 @@ interface DefineEnvResult<S extends EnvSchema> {
     data: InferEnvOutput<S>;
   };
 }
-interface EnvValidationError {
+export interface EnvValidationError {
   key: string;
   message: string;
   value: unknown;
 }
-declare function defineEnv<S extends EnvSchema>(config: EnvConfig<S>): DefineEnvResult<S>;
-declare function setRuntimeEnv(env: Record<string, unknown>): void;
-declare function useRuntimeEnv<T = string>(key: string, defaultValue?: T): T;
+export declare function defineEnv<S extends EnvSchema>(config: EnvConfig<S>): DefineEnvResult<S>;
+export declare function setRuntimeEnv(env: Record<string, unknown>): void;
+export declare function useRuntimeEnv<T = string>(key: string, defaultValue?: T): T;
 //#endregion
 //#region src/path.d.ts
 /**
  * 标准化路径：替换反斜杠、去除首尾多余斜杠、合并连续斜杠。
  */
-declare function normalizePath(path: string): string;
+export declare function normalizePath(path: string): string;
 /**
  * 获取路径的目录部分（不含文件名）。
  */
-declare function getDirname(path: string): string;
+export declare function getDirname(path: string): string;
 /**
  * 获取路径的文件名部分（含扩展名）。
  */
-declare function getBasename(path: string): string;
+export declare function getBasename(path: string): string;
 /**
  * 获取文件名的扩展名（小写，不含点）。
  */
-declare function getExtension(filename: string): string;
+export declare function getExtension(filename: string): string;
 /**
  * 获取文件名（不含扩展名）。
  */
-declare function getStem(filename: string): string;
+export declare function getStem(filename: string): string;
 /**
  * 将文件路径转换为人类可读的标题。
  */
-declare function pathToTitle(path: string): string;
+export declare function pathToTitle(path: string): string;
 //#endregion
 //#region src/glob.d.ts
 /**
@@ -435,16 +435,15 @@ declare function pathToTitle(path: string): string;
  *
  * 提取自 `@ubean/prerender`,供 SSR exclude / prerender / 其他需要 glob 匹配的模块共享。
  */
-declare function matchGlob(route: string, pattern: string): boolean;
+export declare function matchGlob(route: string, pattern: string): boolean;
 /**
  * 检查 route 是否匹配任意一个 patterns。
  */
-declare function matchAnyGlob(route: string, patterns: string[]): boolean;
+export declare function matchAnyGlob(route: string, patterns: string[]): boolean;
 //#endregion
 //#region src/string.d.ts
 /**
  * 将字符串首字母大写。
  */
-declare function capitalize(str: string): string;
-//#endregion
-export { ACTION_BRAND, ActionContext, ActionError, ActionFailure, ActionHandler, ActionId, ActionResult, ActionSchema, BaseRouteMeta, CacheMeta, ComposedHandler, DefineEnvResult, EnvConfig, EnvSchema, EnvValidationError, GenericSchema, InferEnvOutput, Input, IsrRule, PageHead, RateLimitMeta, RouteMeta, RouteRule, ServerAction, Span, SpanAttributes, SpanContext, SpanEndOptions, SpanEvent, SpanOptions, SpanStatus, UbeanBindings, UbeanContext, UbeanEnv, UbeanError, UbeanHandler, UbeanMiddleware, UbeanVariables, capitalize, createError, defineEnv, errorToResponse, fail, getBasename, getDirname, getExtension, getStem, isActionFailure, isServerAction, isUbeanError, matchAnyGlob, matchGlob, normalizePath, pathToTitle, setRuntimeEnv, useRuntimeEnv };
+export declare function capitalize(str: string): string;
+//#endregion

package/dist/logger/hono.d.ts

@@ -20,6 +20,5 @@ import { MiddlewareHandler } from "hono";
  * }));
  * ```
  */
-declare function createRequestLoggerMiddleware(options?: RequestLoggerOptions): MiddlewareHandler;
-//#endregion
-export { createRequestLoggerMiddleware };
+export declare function createRequestLoggerMiddleware(options?: RequestLoggerOptions): MiddlewareHandler;
+//#endregion

package/dist/logger/index.d.ts

@@ -15,9 +15,9 @@ import { i as UbeanLoggerOptions, n as RequestLoggerOptions, r as UbeanLogger, t
  * log.info({ port: 3000 }, 'server started');
  * ```
  */
-declare function createUbeanLogger(options?: UbeanLoggerOptions): UbeanLogger;
+export declare function createUbeanLogger(options?: UbeanLoggerOptions): UbeanLogger;
 /** ubean 全局默认 logger(供应用侧 `import { logger } from 'ubean'` 使用) */
-declare const logger: UbeanLogger;
+export declare const logger: UbeanLogger;
 /**
  * 获取命名(scope)logger。
  *
@@ -31,7 +31,7 @@ declare const logger: UbeanLogger;
  * cli.info('building...');
  * ```
  */
-declare function getLogger(scope?: string, options?: UbeanLoggerOptions): UbeanLogger;
+export declare function getLogger(scope?: string, options?: UbeanLoggerOptions): UbeanLogger;
 /**
  * 切换 debug 日志模式,对所有已创建的 logger 实例(含子 logger)即时生效:
  * - `true`:输出详细日志(日期 + 等级 + 调用位置 + logger 名)
@@ -44,6 +44,6 @@ declare function getLogger(scope?: string, options?: UbeanLoggerOptions): UbeanL
  * setDebugLogging(process.argv.includes('--debug'));
  * ```
  */
-declare function setDebugLogging(enabled: boolean): void;
+export declare function setDebugLogging(enabled: boolean): void;
 //#endregion
-export { type LogLevelName, type RequestLoggerOptions, type UbeanLogger, type UbeanLoggerOptions, createUbeanLogger, getLogger, logger, setDebugLogging };
+export type { LogLevelName, RequestLoggerOptions, UbeanLogger, UbeanLoggerOptions };

package/dist/node.d.ts

@@ -1,5 +1,5 @@
 //#region src/port.d.ts
-interface FindPortOptions {
+export interface FindPortOptions {
   host?: string;
   strictPort?: boolean;
 }
@@ -12,8 +12,8 @@ interface FindPortOptions {
  * when not in strict mode). Rejects with the original error when the port is
  * in use and `strictPort` is true, or for any non-EADDRINUSE error.
  */
-declare function findAvailablePort(port: number, options?: FindPortOptions): Promise<number>;
-interface WaitForPortOptions {
+export declare function findAvailablePort(port: number, options?: FindPortOptions): Promise<number>;
+export interface WaitForPortOptions {
   host?: string;
   retries?: number;
   delay?: number;
@@ -24,18 +24,17 @@ interface WaitForPortOptions {
  *
  * Rejects when the port does not become available within `retries` attempts.
  */
-declare function waitForPort(port: number, options?: WaitForPortOptions): Promise<void>;
+export declare function waitForPort(port: number, options?: WaitForPortOptions): Promise<void>;
 /**
  * Returns true when something is actively listening on `port` at `host`.
  */
-declare function isPortReachable(port: number, host: string): Promise<boolean>;
-declare function sleep(ms: number): Promise<void>;
+export declare function isPortReachable(port: number, host: string): Promise<boolean>;
+export declare function sleep(ms: number): Promise<void>;
 //#endregion
 //#region src/vite-config.d.ts
 /**
  * 检测项目根目录下是否存在 vite 配置文件。
  * 返回找到的第一个文件的完整路径,如果都不存在则返回 null。
  */
-declare function findUserViteConfig(cwd: string): string | null;
-//#endregion
-export { FindPortOptions, WaitForPortOptions, findAvailablePort, findUserViteConfig, isPortReachable, sleep, waitForPort };
+export declare function findUserViteConfig(cwd: string): string | null;
+//#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ubean/shared",
-  "version": "0.4.5",
+  "version": "0.4.6",
   "description": "Shared protocol types, errors, env and universal utilities for ubean",
   "files": [
     "dist"
@@ -37,8 +37,8 @@
   },
   "devDependencies": {
     "@types/node": "^26.5.0",
-    "typescript": "7.0.2",
-    "vite-plus": "0.3.0"
+    "typescript": "npm:typescript-native-bridge@latest",
+    "vite-plus": "0.3.1"
   },
   "scripts": {
     "build": "vp pack",