@h-ai/kit 1.0.0-beta.2 → 1.0.0-beta.21

package/dist/index.d.ts

@@ -1,23 +1,17 @@
-import { c as createKitClient, a as createKitAuthActions, i as installBrowserTransport, b as installBrowserTransportFetch, l as login, f as loginWithOtp, g as loginWithLdap, h as loginWithApiKey, r as registerAndLogin, j as logout, s as setBrowserToken, d as clearBrowserToken } from './kit-client-auth-BnhrkzZF.js';
-export { C as ClientTransportConfig, K as KitClient, e as KitClientConfig } from './kit-client-auth-BnhrkzZF.js';
-import { d as defineCrud, s as setAllModulesLocale } from './kit-i18n-EBzZKYN-.js';
-export { C as CrudApiDef, b as CrudFieldDef, c as CrudFieldOption, e as CrudFieldOptions, f as CrudFieldType, g as CrudFieldValidation, h as CrudFilterParams, i as CrudOperations, j as CrudPaginatedResult, k as CrudPaginationParams, l as CrudResourceDef, m as CrudTableColumn, n as CrudText, K as KitConfigSchema, r as resolveKitConfig, a as resolveKitTransportConfig, o as resolveOptions, p as resolveText } from './kit-i18n-EBzZKYN-.js';
-import { S as SessionData, r as SessionLike, h as HandleConfig, s as rateLimitMiddleware, t as createCacheRateLimitStore, u as createMemoryRateLimitStore } from './kit-types-BkNdyKj8.js';
-export { A as ApiResponse, a as AuthOperations, b as AuthOperationsProvider, C as CorsConfig, F as FormError, c as FormValidationResult, G as GuardConfig, d as GuardResult, H as HaiRequestEvent, e as HandleA2AConfig, f as HandleA2AOperations, g as HandleAuthConfig, i as HookCryptoConfig, K as KitConfig, j as KitConfigInput, k as KitPublicConfig, l as KitServerConfig, m as KitServerConfigInput, n as KitTransportConfig, o as KitTransportConfigInput, v as MemoryRateLimitStore, M as Middleware, p as MiddlewareContext, w as RateLimitCache, R as RateLimitConfig, x as RateLimitEntry, y as RateLimitStore, q as RouteGuard, T as TransportEncryptionOptions } from './kit-types-BkNdyKj8.js';
+import { S as SessionData, z as KitFunctions } from './kit-types-Cr1cnB3M.js';
+export { A as ApiResponse, D as AuthCookieWriter, a as AuthOperations, b as AuthOperationsProvider, B as BrowserKitFunctions, C as ClientTransportConfig, c as CorsConfig, E as CrudApiDef, I as CrudFieldDef, J as CrudFieldOption, L as CrudFieldOptions, N as CrudFieldType, O as CrudFieldValidation, P as CrudFilterParams, Q as CrudOperations, U as CrudPaginatedResult, V as CrudPaginationParams, W as CrudResourceDef, X as CrudTableColumn, Y as CrudText, Z as FeedbackHandlerOptions, F as FormError, d as FormValidationResult, G as GuardConfig, e as GuardResult, H as HaiRequestEvent, f as HandleA2AConfig, g as HandleA2AOperations, h as HandleAuthConfig, i as HandleConfig, j as HookCryptoConfig, _ as IdParamSchema, K as KitClient, k as KitClientConfig, l as KitConfig, m as KitConfigInput, n as KitPublicConfig, o as KitServerConfig, p as KitServerConfigInput, q as KitTransportConfig, r as KitTransportConfigInput, $ as MemoryRateLimitStore, M as Middleware, s as MiddlewareContext, a0 as PaginationQuerySchema, a1 as PermissionGuardConfig, a2 as RateLimitCache, R as RateLimitConfig, a3 as RateLimitEntry, a4 as RateLimitStore, t as RouteGuard, u as SessionLike, T as TransportEncryptionOptions, a5 as defineCrud, a6 as matchPermission, a7 as resolveOptions, a8 as resolveText } from './kit-types-Cr1cnB3M.js';
 import { CryptoFunctions } from '@h-ai/crypto';
 export { EncryptedPayload, TransportEncryptionManager, TransportKeyPair } from '@h-ai/crypto';
-import { FeedbackFunctions, FeedbackContext } from '@h-ai/feedback';
-import * as _sveltejs_kit from '@sveltejs/kit';
-import { RequestEvent, Handle, RequestHandler } from '@sveltejs/kit';
-import * as _h_ai_core from '@h-ai/core';
-import { HaiError } from '@h-ai/core';
-import * as zod_v4_core from 'zod/v4/core';
-import * as zod from 'zod';
-import { z } from 'zod';
-import { IamFunctions } from '@h-ai/iam';
-export { A as A2AApiKeyAuthConfig, K as KitA2AHandlerConfig, R as ResolvedA2AConfig } from './kit-a2a-types-4dapztu2.js';
-export { C as CryptoCsrfConfig, a as CryptoServiceLike, E as EncryptedCookieConfig, T as TransportEncryptionConfig, W as WebhookVerifyConfig } from './kit-crypto-types-CXr888wf.js';
+export { A as A2AApiKeyAuthConfig, K as KitA2AHandlerConfig, R as ResolvedA2AConfig } from './kit-a2a-types-sw7sI-ZT.js';
+export { T as TransportEncryptionConfig } from './kit-crypto-types-CqFENBqm.js';
+export { K as KitConfigSchema, r as resolveKitConfig, a as resolveKitTransportConfig } from './kit-config-BQKQnu8Y.js';
+import '@h-ai/core';
+import '@h-ai/iam';
+import '@sveltejs/kit';
 import '@h-ai/api-contract';
+import '@sveltejs/kit/hooks';
+import '@h-ai/feedback';
+import 'zod';
 
 /**
  * @h-ai/kit — 认证守卫
@@ -61,87 +55,6 @@ interface SessionGuardConfig {
     apiMode?: boolean;
 }
 
-/**
- * @h-ai/kit — 权限守卫
- *
- * 验证用户是否具有指定权限。
- * @module kit-permission
- */
-
-/**
- * 权限守卫配置
- * @example
- * ```ts
- * import type { PermissionGuardConfig } from '@h-ai/kit'
- *
- * const value: PermissionGuardConfig = { permissions: ['article:read'] }
- * void value
- * ```
- */
-interface PermissionGuardConfig {
-    /** 需要的权限列表（默认 OR 逻辑，满足任一即通过） */
-    permissions: string[];
-    /** 为 `true` 时要求用户拥有 **全部** 权限（AND 逻辑） */
-    requireAll?: boolean;
-    /** 无权限时重定向 URL（默认 `'/403'`） */
-    forbiddenUrl?: string;
-    /** 为 `true` 时返回 JSON 403 而非重定向 */
-    apiMode?: boolean;
-}
-/**
- * 匹配权限
- *
- * 支持通配符：
- * - `admin:*` 匹配 `admin:read`、`admin:write` 等
- * - `*` 匹配所有权限
- *
- * @param required - 需要的权限码
- * @param userPermissions - 用户已有的权限列表
- * @returns 是否匹配
- * @example
- * ```ts
- * import { matchPermission } from '@h-ai/kit'
- *
- * const allowed = matchPermission('article:read', ['article:*'])
- * void allowed
- * ```
- */
-declare function matchPermission(required: string, userPermissions: string[]): boolean;
-/**
- * 检查会话是否具有指定权限（布尔判断）
- *
- * 适用于条件分支场景（如菜单过滤、按钮显示等）。
- *
- * @param session - 当前会话数据，null/undefined 视为无权限
- * @param permission - 需要的权限码，如 `user:read`
- * @returns 是否拥有权限
- * @example
- * ```ts
- * import { kit } from '@h-ai/kit'
- *
- * const allowed = kit.guard.check({ userId: 'user_1', roles: ['editor'], permissions: ['article:read'] }, 'article:read')
- * void allowed
- * ```
- */
-declare function hasPermission(session: SessionLike | null | undefined, permission: string): boolean;
-/**
- * 要求会话具有指定权限，不满足时 throw Response
- *
- * throw 的 Response 对象由 kit.handler 捕获并直接作为 API 响应返回。
- * 搭配 `kit.handler()` 使用时，无需手动检查返回值。
- *
- * @param session - 当前会话数据，null/undefined 视为未认证
- * @param permission - 需要的权限码，如 `user:create`
- * @throws Response - 未认证 401 / 无权限 403
- * @example
- * ```ts
- * import { kit } from '@h-ai/kit'
- *
- * kit.guard.require({ userId: 'user_1', roles: ['editor'], permissions: ['article:read'] }, 'article:read') // 拒绝时抛出 Response，由 kit.handler 传递。
- * ```
- */
-declare function requirePermission(session: SessionLike | null | undefined, permission: string): void;
-
 /**
  * @h-ai/kit — 角色守卫
  *
@@ -170,35 +83,10 @@ interface RoleGuardConfig {
     apiMode?: boolean;
 }
 
-/** 可选敏感操作再鉴别；由操作入口在现有权限/资源检查之后调用。 */
-
-/**
- * 要求选定操作携带短期单次再鉴别票据；失败抛出 Response，由 kit.handler 返回。
- * 不替代已有认证、权限与资源范围守卫；操作 ID 必须由服务端指定。
- * @param iam - 已初始化的 IAM 服务。
- * @param event - 当前请求与 Cookie，不能跨请求保存。
- * @param operation - 当前服务端操作 ID。
- * @returns 策略关闭、未选操作或证明校验成功时无返回值。
- * @example
- * ```ts
- * import { iam } from '@h-ai/iam'
- * import type { SessionLike } from '@h-ai/kit'
- * import type { RequestEvent } from '@sveltejs/kit'
- * import { kit } from '@h-ai/kit'
- * // session 由应用在当前请求完成鉴别后传入，不在跨请求闭包中保存。
- * async function remove(event: Pick<RequestEvent, 'request' | 'cookies'>, session: SessionLike) {
- *   kit.guard.require(session, 'user:delete')
- *   await kit.guard.requireSensitive(iam, event, 'iam.users.delete')
- *   return kit.response.ok({ allowed: true })
- * }
- * ```
- */
-declare function requireSensitiveOperation(iam: IamFunctions, event: Pick<RequestEvent, 'request' | 'cookies'>, operation: string): Promise<void>;
-
 /**
  * @h-ai/kit — Cookie 加密代理
  *
- * 通过 Proxy 拦截 SvelteKit Cookies 对象的 get/set 方法， 对指定名称的 Cookie 自动进行 SM4-CBC 加解密。
+ * 通过 Proxy 对指定 Cookie 进行 SM4-CBC 加密和 HMAC-SHA256 认证，先验真再解密。
  * @module kit-cookie-proxy
  */
 
@@ -224,477 +112,11 @@ interface CookieProxyConfig {
 }
 
 /**
- * @h-ai/kit — SvelteKit Handle Hook
- *
- * 创建 SvelteKit Handle Hook，集成请求 ID 生成、会话验证、Cookie 加密代理、
- * 路由守卫、中间件链与可选传输加密；同时提供 `sequence()` 组合多个 Handle。
- * @module kit-handle
- */
-
-/**
- * 创建 hai handle hook
- *
- * 整合会话解析、路由守卫、中间件链与统一错误处理的 SvelteKit Handle 工厂。
- *
- * 执行顺序：
- * 1. 生成 `requestId` 并写入 `event.locals`
- * 2. 根据 `auth` 配置从 Bearer / Cookie 解析会话
- * 3. 根据 `auth.protectedPaths` 自动执行路由守卫 + 额外自定义守卫
- * 4. 构建中间件链（内置 logging / rateLimit + 自定义）并执行
- * 5. 调用 `resolve(event)` 获取业务响应
- * 6. 附加 `X-Request-Id` 响应头
- *
- * @param config - Handle 配置（均有合理默认值，可零配置使用）
- * @returns SvelteKit Handle 函数
- * @example
- * ```ts
- * import { kit } from '@h-ai/kit'
- *
- * const handle = kit.createHandle({ auth: { verifyToken: async () => null, protectedPaths: ['/admin/**'] } })
- * void handle
- * ```
- */
-declare function createHandle(config?: HandleConfig): Handle;
-/**
- * 组合多个 SvelteKit handle 为单一 handle
- *
- * 洋葱模型：`sequence(a, b, c)` 执行顺序为 a → b → c → resolve → c → b → a。
- *
- * @param handles - 待组合的 handle 函数列表
- * @returns 组合后的单一 Handle 函数
- * @example
- * ```ts
- * import { kit } from '@h-ai/kit'
- *
- * const handle = kit.sequence(kit.createHandle({ logging: true }), kit.createHandle())
- * void handle
- * ```
- */
-declare function sequence(...handles: Handle[]): Handle;
-
-/** 可直接挂到 SvelteKit catch-all 路由的反馈适配，无 serv 或 Svelte UI 依赖。 */
-
-/**
- * 反馈服务及可信范围解析。resolveContext 必须使用已验证 session/宿主策略。
- * @example
- * ```ts
- * import type { FeedbackHandlerOptions } from '@h-ai/kit'
- * import { feedback } from '@h-ai/feedback'
- * const options: FeedbackHandlerOptions = { feedback, resolveContext: () => null }
- * // 应用实现真实 session 映射；null 拒绝访问，不能从 JSON 取得身份。
- * ```
- */
-interface FeedbackHandlerOptions {
-    readonly feedback: FeedbackFunctions;
-    readonly resolveContext: (event: RequestEvent) => FeedbackContext | null | Promise<FeedbackContext | null>;
-    readonly basePath?: string;
-}
-/**
- * 装配反馈 REST 路由；默认路径 /api/feedback，由宿主 handle 保持 CSRF、认证和传输加密。
- * @param options - 已初始化服务与可信范围映射。
- * @returns 可赋值给 catch-all 路由 GET/POST/PATCH 的同一 handler。
- * @example
- * ```ts
- * import { kit } from '@h-ai/kit'
- * import { feedback } from '@h-ai/feedback'
- * const handler = kit.createFeedbackHandler({ feedback, resolveContext: () => null })
- * // 路由 export const GET = handler；真实应用从受信 session 返回范围，null 默认拒绝。
- * ```
- */
-declare function createFeedbackHandler(options: FeedbackHandlerOptions): RequestHandler;
-
-/**
- * 应用路由直接导出对应 handler；认证 ops 仍由 createHandle 注入。
- * @param iam - 已由应用初始化的 IAM 服务对象。
- * @returns 标准认证端点的 RequestHandler 集合。
- * @example 模块内部上下文
- * ```ts
- * function build(iam: IamFunctions) {
- *   return createAuthApi(iam) // 调用方负责初始化 IAM；工厂只装配 handler。
- * }
- * ```
- */
-declare function createAuthApi(iam: IamFunctions): {
-    closeSession: _sveltejs_kit.RequestHandler;
-    createCaptcha: _sveltejs_kit.RequestHandler;
-    reauthenticate: _sveltejs_kit.RequestHandler;
-    publicConfig: _sveltejs_kit.RequestHandler;
-    renewPassword: _sveltejs_kit.RequestHandler;
-    login: _sveltejs_kit.RequestHandler;
-    loginWithLdap: _sveltejs_kit.RequestHandler;
-    loginWithOtp: _sveltejs_kit.RequestHandler;
-    register: _sveltejs_kit.RequestHandler;
-    sendOtp: _sveltejs_kit.RequestHandler;
-    requestPasswordReset: _sveltejs_kit.RequestHandler;
-    confirmPasswordReset: _sveltejs_kit.RequestHandler;
-};
-
-/**
- * @h-ai/kit — API Handler 包装器
- *
- * 统一封装 SvelteKit API Handler 的错误处理逻辑。
- * @module kit-handler
- */
-
-/**
- * 创建 API Handler 包装器
- *
- * 将业务逻辑包裹在统一的异常边界中：
- * 1. 正常执行 `fn(event)` 返回 Response
- * 2. 若 `fn` throw 了 `Response`（如 `kit.guard.require` / `kit.validate.body`），直接返回该 Response
- * 3. 若 `fn` throw 了 SvelteKit 控制流（`redirect()` / `error()`），继续抛出
- * 4. 其他异常：记录日志 → 返回 `kit.response.internalError()`
- *
- * @param fn - 业务处理函数
- * @returns SvelteKit RequestHandler
- * @example
- * ```ts
- * import { kit } from '@h-ai/kit'
- *
- * const GET = kit.handler(() => kit.response.ok({ healthy: true }))
- * void GET
- * ```
- */
-declare function handler(fn: (event: RequestEvent) => Promise<Response> | Response): RequestHandler;
-
-/**
- * @h-ai/kit — API 响应工具
- *
- * 标准化 API 响应工具集，统一 `{ success, data?, error?, requestId? }` 结构。
- * 提供成功响应（ok / created / noContent）、错误响应
- * （badRequest / unauthorized / forbidden / notFound / conflict / validationError / internalError）
- * 以及重定向响应。
- * @module kit-response
- */
-
-/**
- * 创建 200 成功响应
- *
- * @param data - 响应数据，序列化为 JSON
- * @param requestId - 可选请求 ID，用于链路追踪
- * @returns `{ success: true, data, requestId }` 格式的 JSON Response
- * @example
- * ```ts
- * import { kit } from '@h-ai/kit'
- *
- * const response = kit.response.ok({ id: 'article_1' })
- * void response.status
- * ```
- */
-declare function ok<T>(data: T, requestId?: string): Response;
-/**
- * 创建 201 资源创建成功响应
- *
- * @param data - 新创建的资源数据
- * @param requestId - 可选请求 ID
- * @returns `{ success: true, data }` 格式的 JSON Response（status 201）
- * @example
- * ```ts
- * import { kit } from '@h-ai/kit'
- *
- * const response = kit.response.created({ id: 'article_1' })
- * void response.status
- * ```
- */
-declare function created<T>(data: T, requestId?: string): Response;
-/**
- * 创建 204 无内容响应
- *
- * 通常用于 DELETE 成功或无返回值的更新操作。
- *
- * @returns 空 body、status 204 的 Response
- * @example
- * ```ts
- * import { kit } from '@h-ai/kit'
- *
- * const response = kit.response.noContent()
- * void response.status
- * ```
- */
-declare function noContent(): Response;
-/**
- * 创建自定义错误响应
- *
- * @param code - 错误码（如 `'CUSTOM_ERROR'`）
- * @param message - 人可读错误消息
- * @param status - HTTP 状态码，默认 400
- * @param requestId - 可选请求 ID
- * @param details - 可选额外详情
- * @returns `{ success: false, error: { code, message, details } }` 格式的 JSON Response
- * @example
- * ```ts
- * import { kit } from '@h-ai/kit'
- *
- * const response = kit.response.error('ARTICLE_MISSING', 'Article missing', 404)
- * void response.status
- * ```
- */
-declare function error(code: string, message: string, status?: number, requestId?: string, details?: unknown): Response;
-/**
- * 创建 400 Bad Request 响应
- *
- * @param message - 错误消息
- * @param requestId - 可选请求 ID
- * @param details - 可选额外详情
- * @returns error code 为 `'BAD_REQUEST'` 的 JSON Response
- * @example
- * ```ts
- * import { kit } from '@h-ai/kit'
- *
- * const response = kit.response.badRequest('Invalid article')
- * void response.status
- * ```
- */
-declare function badRequest(message: string, requestId?: string, details?: unknown): Response;
-/**
- * 创建 401 Unauthorized 响应
- *
- * @param message - 错误消息，默认 `'Authentication required'`
- * @param requestId - 可选请求 ID
- * @returns error code 为 `'UNAUTHORIZED'` 的 JSON Response
- * @example
- * ```ts
- * import { kit } from '@h-ai/kit'
- *
- * const response = kit.response.unauthorized()
- * void response.status
- * ```
- */
-declare function unauthorized(message?: string, requestId?: string): Response;
-/**
- * 创建 403 Forbidden 响应
- *
- * @param message - 错误消息，默认 `'Access denied'`
- * @param requestId - 可选请求 ID
- * @returns error code 为 `'FORBIDDEN'` 的 JSON Response
- * @example
- * ```ts
- * import { kit } from '@h-ai/kit'
- *
- * const response = kit.response.forbidden()
- * void response.status
- * ```
- */
-declare function forbidden(message?: string, requestId?: string): Response;
-/**
- * 创建 404 Not Found 响应
- *
- * @param message - 错误消息，默认 `'Resource not found'`
- * @param requestId - 可选请求 ID
- * @returns error code 为 `'NOT_FOUND'` 的 JSON Response
- * @example
- * ```ts
- * import { kit } from '@h-ai/kit'
- *
- * const response = kit.response.notFound()
- * void response.status
- * ```
- */
-declare function notFound(message?: string, requestId?: string): Response;
-/**
- * 创建 409 Conflict 响应
- *
- * @param message - 冲突描述（如重复创建等）
- * @param requestId - 可选请求 ID
- * @returns error code 为 `'CONFLICT'` 的 JSON Response
- * @example
- * ```ts
- * import { kit } from '@h-ai/kit'
- *
- * const response = kit.response.conflict('Already updated')
- * void response.status
- * ```
- */
-declare function conflict(message: string, requestId?: string): Response;
-/**
- * 创建 422 Unprocessable Entity 响应（验证错误）
- *
- * @param errors - 字段级别的验证错误列表
- * @param requestId - 可选请求 ID
- * @returns error code 为 `'VALIDATION_ERROR'`，details 包含 `errors` 数组
- * @example
- * ```ts
- * import { kit } from '@h-ai/kit'
- *
- * const response = kit.response.validationError([{ field: 'title', message: 'Title is required' }])
- * void response.status
- * ```
- */
-declare function validationError(errors: Array<{
-    field: string;
-    message: string;
-}>, requestId?: string): Response;
-/**
- * 创建 500 Internal Server Error 响应
- *
- * @param message - 错误消息，默认 `'Internal server error'`
- * @param requestId - 可选请求 ID
- * @returns error code 为 `'INTERNAL_ERROR'` 的 JSON Response
- * @example
- * ```ts
- * import { kit } from '@h-ai/kit'
- *
- * const response = kit.response.internalError()
- * void response.status
- * ```
- */
-declare function internalError(message?: string, requestId?: string): Response;
-/**
- * 创建重定向响应
- *
- * @param url - 目标 URL
- * @param status - HTTP 状态码，默认 302；常用 303（POST 后重定向）
- * @returns 带 `Location` 头的空 body Response
- * @example
- * ```ts
- * import { kit } from '@h-ai/kit'
- *
- * const response = kit.response.redirect('/articles', 303)
- * void response.status
- * ```
- */
-declare function redirect(url: string, status?: 301 | 302 | 303 | 307 | 308): Response;
-/**
- * 将 HaiResult<T> 转换为标准 API Response
- *
- * 成功时返回 200 ok(data)，失败时从 error 对象中提取 code、message，
- * 并根据 httpStatusMap 映射 HTTP 状态码（未命中时默认 400）。
- *
- * @param result - core HaiResult 对象（{ success, data } 或 { success: false, error }）
- * @param httpStatusMap - 模块导出的错误码 → HTTP 状态码映射表（如 IamErrorHttpStatus）
- * @param requestId - 可选请求 ID，用于链路追踪
- * @returns 标准化 JSON Response
- * @example
- * ```ts
- * import { kit } from '@h-ai/kit'
- *
- * const response = kit.response.fromResult({ success: true, data: { id: 'article_1' } })
- * void response.status
- * ```
- */
-declare function fromResult<T>(result: {
-    success: true;
-    data: T;
-} | {
-    success: false;
-    error: {
-        code: number | string;
-        message: string;
-        [key: string]: unknown;
-    };
-}, httpStatusMap?: Record<number | string, number>, requestId?: string): Response;
-/**
- * 按模块错误的 HTTP 状态构建安全的统一 API 错误响应。
- * @param haiError - 包含 code、message 和可选 httpStatus 的模块错误。
- * @param requestId - 可选的请求追踪标识。
- * @returns 包含统一错误结构和对应 HTTP 状态的 Response。
- * @example
- * ```ts
- * import { kit } from '@h-ai/kit'
- *
- * const response = kit.response.fromError({ code: 'app:articles:001', message: 'Article missing', httpStatus: 404 })
- * void response.status
- * ```
- */
-declare function fromError(haiError: HaiError, requestId?: string): Response;
-
-/**
- * @h-ai/kit — 请求数据验证
+ * @h-ai/kit — 服务对象主入口
  *
- * 基于 Zod 的请求数据验证工具，支持表单/JSON Body、URL 查询参数与路由参数。
- * Zod 默认错误消息的本地化规则委托给 `core.zodValidation`，避免 kit / serv
- * 等模块重复维护同一套 issue 解析与消息映射逻辑；模块前缀映射也统一交给
- * `core.zodValidation.createPrefixedZodMessageGetter()` 处理。
- * 每种数据源都提供两类 API：
- * - 安全返回：`FormValidationResult`
- * - 失败抛出：`OrFail`（抛出 `Response`，由 kit.handler 作为 API 控制流处理）
- * @module kit-validation
- */
-
-/**
- * 从 Request 解析并验证表单数据，失败时 throw Response
- *
- * 与 `validateForm` 功能相同，但校验失败时 throw 400 Response（SvelteKit 控制流），
- * 搭配 `kit.handler()` 使用可精简 handler 代码。
- *
- * @param request - SvelteKit 请求对象
- * @param schema - Zod Schema
- * @returns 校验通过的数据（类型安全）
- * @throws Response - 400 BadRequest（含首条错误消息）
- * @example 模块内部上下文
- * ```ts
- * const schema = zod.object({ title: zod.string().min(1) })
- * const result = await validateFormOrFail(new Request('https://app.example.com/api', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ title: 'Example' }) }), schema)
- * // 校验失败抛出 Response，由框架错误边界透传。
- * void result.title
- * ```
- */
-declare function validateFormOrFail<T extends z.ZodType>(request: Request, schema: T): Promise<z.infer<T>>;
-/**
- * 从 URL 查询参数验证，失败时 throw Response
- *
- * @param url - 请求 URL 对象
- * @param schema - Zod Schema
- * @returns 校验通过的数据
- * @throws Response - 400 BadRequest
- * @example 模块内部上下文
- * ```ts
- * const schema = zod.object({ title: zod.string().min(1) })
- * const result = validateQueryOrFail(new URL('https://app.example.com/articles?title=Example'), schema)
- * // 校验失败抛出 Response，由框架错误边界透传。
- * void result.title
- * ```
- */
-declare function validateQueryOrFail<T extends z.ZodType>(url: URL, schema: T): z.infer<T>;
-/**
- * 验证路径参数，失败时 throw Response
- *
- * @param params - SvelteKit 路由参数
- * @param schema - Zod Schema
- * @returns 校验通过的数据
- * @throws Response - 400 BadRequest
- * @example 模块内部上下文
- * ```ts
- * const schema = zod.object({ title: zod.string().min(1) })
- * const result = validateParamsOrFail({ title: 'Example' }, schema)
- * // 校验失败抛出 Response，由框架错误边界透传。
- * void result.title
- * ```
- */
-declare function validateParamsOrFail<T extends z.ZodType>(params: Record<string, string>, schema: T): z.infer<T>;
-/**
- * 路径参数 id 校验 Schema
- *
- * 验证 `event.params.id` 为非空字符串。
- * @example
- * ```ts
- * import { IdParamSchema } from '@h-ai/kit'
- *
- * const value = IdParamSchema.parse({ id: 'article_1' })
- * void value
- * ```
- */
-declare const IdParamSchema: z.ZodObject<{
-    id: z.ZodString;
-}, z.core.$strip>;
-/**
- * 通用分页查询参数 Schema
- *
- * 包含 page（默认 1）、pageSize（默认 20，上限 100）、search（可选）。
- * 可通过 `.extend()` 扩展业务字段。
- * @example
- * ```ts
- * import { PaginationQuerySchema } from '@h-ai/kit'
- *
- * const value = PaginationQuerySchema.parse({ page: '1', pageSize: '20' })
- * void value
- * ```
+ * SvelteKit 集成模块的统一命名空间出口。 所有功能通过 kit 对象访问：
+ * @module kit-main
  */
-declare const PaginationQuerySchema: z.ZodObject<{
-    page: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
-    pageSize: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
-    search: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
 
 /**
  * Kit 模块统一出口。
@@ -709,123 +131,7 @@ declare const PaginationQuerySchema: z.ZodObject<{
  * void handle
  * ```
  */
-declare const kit: {
-    /** 创建反馈的受控 catch-all HTTP handler，身份范围由宿主解析。 */
-    createFeedbackHandler: typeof createFeedbackHandler;
-    /** 原子限流工厂；共享store生命周期由应用管理。 */
-    middleware: {
-        rateLimit: typeof rateLimitMiddleware;
-        createCacheRateLimitStore: typeof createCacheRateLimitStore;
-        createMemoryRateLimitStore: typeof createMemoryRateLimitStore;
-    };
-    /** 创建 SvelteKit Handle Hook（含 auth / logging / rateLimit 内置配置） */
-    createHandle: typeof createHandle;
-    /** 组合多个 Handle */
-    sequence: typeof sequence;
-    /** API Handler 包装器（自动错误边界） */
-    handler: typeof handler;
-    guard: {
-        /** 选定敏感操作要求单次再鉴别；先调用现有权限与资源守卫。 */
-        requireSensitive: typeof requireSensitiveOperation;
-        /** 要求权限，不满足时 throw Response（SvelteKit 控制流） */
-        require: typeof requirePermission;
-        /** 检查会话是否具有指定权限（布尔） */
-        check: typeof hasPermission;
-    };
-    response: {
-        /** 200 成功 */
-        ok: typeof ok;
-        /** 201 创建成功 */
-        created: typeof created;
-        /** 204 无内容 */
-        noContent: typeof noContent;
-        /** 自定义错误响应 */
-        error: typeof error;
-        /** 400 BadRequest */
-        badRequest: typeof badRequest;
-        /** 401 Unauthorized */
-        unauthorized: typeof unauthorized;
-        /** 403 Forbidden */
-        forbidden: typeof forbidden;
-        /** 404 NotFound */
-        notFound: typeof notFound;
-        /** 409 Conflict */
-        conflict: typeof conflict;
-        /** 422 验证错误 */
-        validationError: typeof validationError;
-        /** 500 InternalError */
-        internalError: typeof internalError;
-        /** 重定向 */
-        redirect: typeof redirect;
-        /** 将 HaiResult<T> 转为标准 API Response（支持 httpStatusMap） */
-        fromResult: typeof fromResult;
-        /** 将模块错误码映射为标准 HTTP Response */
-        fromError: typeof fromError;
-    };
-    validate: {
-        /** 验证请求体（JSON/表单），失败 throw Response */
-        body: typeof validateFormOrFail;
-        /** 验证查询参数，失败 throw Response */
-        query: typeof validateQueryOrFail;
-        /** 验证路径参数，失败 throw Response */
-        params: typeof validateParamsOrFail;
-        /** 路径参数 id Schema（{id: string}） */
-        IdParamSchema: zod.ZodObject<{
-            id: zod.ZodString;
-        }, zod_v4_core.$strip>;
-        /** 通用分页查询 Schema（page / pageSize / search） */
-        PaginationQuerySchema: zod.ZodObject<{
-            page: zod.ZodDefault<zod.ZodCoercedNumber<unknown>>;
-            pageSize: zod.ZodDefault<zod.ZodCoercedNumber<unknown>>;
-            search: zod.ZodOptional<zod.ZodString>;
-        }, zod_v4_core.$strip>;
-    };
-    client: {
-        /** 创建统一客户端（CSRF + 传输加密透明合并） */
-        create: typeof createKitClient;
-        /** 标准认证表单动作（Cookie 模式）。 */
-        createAuthActions: typeof createKitAuthActions;
-        /**
-         * 用解析后的 {@link KitConfig} 一键安装浏览器端传输加密
-         * （应用层推荐入口；内部预热 crypto 并调用 installBrowserTransportFetch）
-         */
-        installBrowserTransport: typeof installBrowserTransport;
-        /** 底层入口：直接传 transport 配置安装浏览器全局 fetch 包装 */
-        installBrowserTransportFetch: typeof installBrowserTransportFetch;
-    };
-    auth: {
-        /** 标准匿名认证端点白名单。 */
-        publicPaths: string[];
-        /** 标准配置/登录/注册/验证码/重置 handler 集合。 */
-        createApi: typeof createAuthApi;
-        /** 服务端登录（密码）：内部调用 iam.auth.login + 自动写入 Token Cookie */
-        login: typeof login;
-        /** 服务端登录（OTP 验证码）：内部调用 iam.auth.loginWithOtp + 自动写入 Token Cookie */
-        loginWithOtp: typeof loginWithOtp;
-        /** 服务端登录（LDAP）：内部调用 iam.auth.loginWithLdap + 自动写入 Token Cookie */
-        loginWithLdap: typeof loginWithLdap;
-        /** 服务端登录（API Key）：内部调用 iam.auth.loginWithApiKey + 自动写入 Token Cookie */
-        loginWithApiKey: typeof loginWithApiKey;
-        /** 服务端注册并登录：内部调用 iam.auth.registerAndLogin + 自动写入 Token Cookie */
-        registerAndLogin: typeof registerAndLogin;
-        /** 服务端登出：内部调用 iam.auth.logout + 清除 Token Cookie */
-        logout: typeof logout;
-        /** 写入浏览器端 Access Token（客户端 login/register 用） */
-        setBrowserToken: typeof setBrowserToken;
-        /** 清除浏览器端 Access Token（客户端 logout 用） */
-        clearBrowserToken: typeof clearBrowserToken;
-    };
-    crud: {
-        /** 定义 CRUD 资源（声明式配置 → 操作对象） */
-        define: typeof defineCrud;
-    };
-    i18n: {
-        /** 统一设置所有 hai 模块的默认语言 */
-        setLocale: typeof setAllModulesLocale;
-        /** 请求/SSR 语言隔离；异步处理使用同一请求上下文。 */
-        runWithLocale: <T>(locale: _h_ai_core.Locale, operation: () => T) => T;
-    };
-};
+declare const kit: KitFunctions;
 
 /**
  * @h-ai/kit — 日志中间件
@@ -854,4 +160,5 @@ interface LoggingMiddlewareConfig {
     redactFields?: string[];
 }
 
-export { type AuthGuardConfig, type CookieProxyConfig, type FeedbackHandlerOptions, HandleConfig, IdParamSchema, type LoggingMiddlewareConfig, PaginationQuerySchema, type PermissionGuardConfig, type RoleGuardConfig, SessionData, type SessionGuardConfig, SessionLike, defineCrud, kit, matchPermission };
+export { KitFunctions, SessionData, kit };
+export type { AuthGuardConfig, CookieProxyConfig, LoggingMiddlewareConfig, RoleGuardConfig, SessionGuardConfig };