@jayfong/x-server 2.119.0 → 3.0.0

package/lib/core/http_method.d.mts

@@ -0,0 +1,3 @@
+import { XHandler } from "./types.mjs";
+import { HTTPMethods } from "fastify";
+export declare const HandlerMethodToHttpMethod: Record<XHandler.Method, HTTPMethods>;

package/lib/core/http_method.mjs

@@ -0,0 +1,10 @@
+// src/core/http_method.ts
+const HandlerMethodToHttpMethod = {
+	GET: "GET",
+	POST: "POST",
+	FILE: "POST",
+	WS: "GET",
+	XML: "POST",
+	ANY: "POST"
+};
+export { HandlerMethodToHttpMethod };

package/lib/core/http_redirect.d.mts

@@ -0,0 +1,5 @@
+export declare class HttpRedirect {
+  url: string;
+  permanently?: boolean | undefined;
+  constructor(url: string, permanently?: boolean | undefined);
+}

package/lib/core/http_redirect.mjs

@@ -0,0 +1,10 @@
+// src/core/http_redirect.ts
+var HttpRedirect = class {
+	url;
+	permanently;
+	constructor(url, permanently) {
+		this.url = url;
+		this.permanently = permanently;
+	}
+};
+export { HttpRedirect };

package/lib/core/server.d.mts

@@ -0,0 +1,20 @@
+import { XServer } from "./types.mjs";
+export declare class Server {
+  readonly options: XServer.Options;
+  private fastify;
+  private routes;
+  static options: XServer.Options;
+  constructor(options: XServer.Options);
+  start(): Promise<void>;
+  close(): Promise<void>;
+  private prepareFastify;
+  private startFastify;
+  private prepareRoutes;
+  private applyHooks;
+  private applyServices;
+  private applyPlugins;
+  private applyRoutes;
+  private applyStatic;
+  private startCrons;
+  private applyAutoClose;
+}

package/lib/core/server.mjs

@@ -0,0 +1,186 @@
+import { x } from "../x.mjs";
+import { HttpError } from "./http_error.mjs";
+import { HandlerMethodToHttpMethod } from "./http_method.mjs";
+import { base64UrlDecode, castArray, keyBy, noop, rot13 } from "vtils";
+import process from "node:process";
+import Fastify from "fastify";
+import { cuid2 } from "vtils/x";
+// src/core/server.ts
+var Server = class Server {
+	options;
+	fastify;
+	routes = [];
+	static options = {};
+	constructor(options) {
+		this.options = options;
+		Server.options = options;
+		process.on("unhandledRejection", (reason, promise) => {
+			console.error("未捕获的错误", reason, promise);
+		});
+	}
+	async start() {
+		this.applyServices();
+		await this.prepareFastify();
+		this.applyPlugins();
+		await this.prepareRoutes();
+		await this.applyRoutes();
+		await this.applyHooks();
+		await this.startFastify();
+		await this.startCrons();
+		await this.applyAutoClose();
+	}
+	async close() {
+		await this.fastify?.close();
+	}
+	async prepareFastify() {
+		this.fastify = await Fastify({
+			logger: process.env.NODE_ENV === "development" ? { transport: { target: "pino-pretty" } } : false,
+			trustProxy: true,
+			...this.options.fastifyOptions
+		});
+	}
+	async startFastify() {
+		await this.fastify.listen({
+			host: this.options.host || "0.0.0.0",
+			port: this.options.port
+		});
+	}
+	async prepareRoutes() {
+		const { routes } = await import("@a/x/routes");
+		this.routes = routes;
+	}
+	async applyHooks() {
+		await import("@a/x/hooks");
+	}
+	applyServices() {
+		x.register(...this.options.services || []);
+	}
+	applyPlugins() {
+		const plugins = this.options.plugins || [];
+		for (const plugin of plugins) plugin.register(this.fastify);
+	}
+	async applyRoutes() {
+		await this.fastify.register(async (fastify) => {
+			const appUrl = x.env.APP_URL.replace(/\/+$/, "");
+			const routeMap = keyBy(this.routes, (item) => item.path);
+			const handleRoute = async (item, req, res, path) => {
+				const handlerMethod = item.handler.options.requestMethod || "POST";
+				const isWS = handlerMethod === "WS";
+				const url = `${appUrl}${path ?? (isWS ? res.url : req.url)}`;
+				if (isWS) {
+					await item.handler.handle(void 0, {
+						traceId: cuid2(),
+						url,
+						headers: res.headers,
+						setHeader: noop,
+						redirect: noop,
+						ws: req,
+						req: res,
+						res: {}
+					});
+					return;
+				}
+				let files = {};
+				if (handlerMethod === "FILE") {
+					const part = await req.file();
+					files = Object.keys(part.fields).reduce((res, name) => {
+						res[name] = castArray(part.fields[name]).map((item) => item.file ? item : item.value)[0];
+						return res;
+					}, {});
+				}
+				return await item.handler.handle(handlerMethod === "ANY" ? {} : {
+					...req.params,
+					...req.query,
+					...req.body,
+					...files
+				}, {
+					traceId: cuid2(),
+					url,
+					headers: req.headers,
+					setHeader: (k, v) => res.header(k, v),
+					redirect: (url, permanently) => res.redirect(url, permanently ? 301 : 302),
+					ws: void 0,
+					req,
+					res
+				});
+			};
+			for (const item of this.routes) {
+				const handlerOptions = item.handler.options;
+				const handlerMethod = handlerOptions.requestMethod || "POST";
+				const isWS = handlerMethod === "WS";
+				const serverMethod = isWS ? "GET" : HandlerMethodToHttpMethod[handlerMethod];
+				fastify.route({
+					method: handlerMethod === "ANY" ? [
+						"GET",
+						"HEAD",
+						"TRACE",
+						"DELETE",
+						"OPTIONS",
+						"PATCH",
+						"PUT",
+						"POST"
+					] : serverMethod,
+					url: item.path,
+					constraints: handlerOptions.requestHost ? { host: handlerOptions.requestHost } : void 0,
+					websocket: isWS,
+					handler: (req, res) => handleRoute(item, req, res)
+				});
+			}
+			this.applyStatic();
+			fastify.route({
+				method: "POST",
+				url: "/@",
+				handler: async (req, res) => {
+					let requestPath = req.headers["x-path"] || "";
+					if (!requestPath.startsWith("/")) {
+						const [_requestPath, _time] = base64UrlDecode(rot13(requestPath)).split("#");
+						if (!_time || Date.now() / 1e3 - Number(_time) > 300) throw new HttpError.Forbidden();
+						requestPath = _requestPath;
+					}
+					if (!requestPath || !routeMap[requestPath]) throw new HttpError.NotFound();
+					return handleRoute(routeMap[requestPath], req, res, requestPath);
+				}
+			});
+			fastify.route({
+				method: "POST",
+				url: "/$",
+				handler: async (req) => {
+					const payload = req.body;
+					if (payload && typeof payload === "object" && x.env.APP_TOKEN && payload.token === x.env.APP_TOKEN) {
+						if (payload.type === "ping") return "ping:success";
+						else if (payload.type === "updateEnv") {
+							Object.assign(x.env, payload.data);
+							this.applyStatic();
+						}
+					}
+				}
+			});
+		});
+	}
+	async applyStatic() {
+		if (Array.isArray(x.env.APP_STATIC_CONTENT)) {
+			const staticContent = x.env.APP_STATIC_CONTENT;
+			for (const item of staticContent) {
+				const methods = castArray(item.method);
+				if (!methods.some((method) => this.fastify.hasRoute({
+					method,
+					url: item.path
+				}))) this.fastify.route({
+					method: methods,
+					url: item.path,
+					handler: async (_req, res) => {
+						if (!item.contentType && typeof item.content === "string") res.header("Content-Type", "plain/text");
+						return item.content;
+					}
+				});
+			}
+		}
+	}
+	async startCrons() {
+		await import("@a/x/crons");
+	}
+	async applyAutoClose() {
+		x.dispose.add(() => this.close());
+	}
+};
+export { Server };

package/lib/core/types.d.mts

@@ -0,0 +1,256 @@
+import { BasePlugin } from "../plugins/base.mjs";
+import { BaseService } from "../services/base.mjs";
+import { DisposeService } from "../services/dispose.mjs";
+import { Handler } from "./handler.mjs";
+import { CronJob } from "cron";
+import { MsValue } from "vtils";
+import * as vae from "vtils/vae";
+import { FastifyReply, FastifyRequest, FastifyServerOptions } from "fastify";
+import { Queue } from "bull";
+import { MultipartFile } from "@fastify/multipart";
+import { AsyncOrSync, LiteralUnion, OneOrMore, RequiredDeep } from "vtils/types";
+import { IncomingHttpHeaders } from "node:http";
+import { WebSocket } from "ws";
+export declare namespace XServer {
+  type Mode = 'development' | 'production';
+  interface Route {
+    /**
+     * 路径
+     */
+    path: string;
+    /**
+     * 处理器
+     */
+    handler: Handler;
+  }
+  interface Options {
+    /**
+     * 监听主机
+     */
+    host?: string;
+    /**
+     * 监听端口
+     */
+    port: number;
+    /**
+     * 响应加密算法
+     */
+    responseEncryptAlgorithm?: 'simple';
+    /**
+     * 响应加密密钥
+     */
+    responseEncryptKey?: string;
+    /**
+     * 是否使用异步上下文
+     *
+     * @default false
+     */
+    useAsyncContext?: boolean;
+    /**
+     * 透传给 Fastify 的选项
+     */
+    fastifyOptions?: FastifyServerOptions;
+    /**
+     * 服务列表
+     */
+    services?: BaseService[];
+    /**
+     * 插件列表
+     */
+    plugins?: BasePlugin[];
+  }
+}
+export declare namespace XHandler {
+  type Method = 'GET' | 'POST' | 'FILE' | 'WS' | 'XML' | 'ANY';
+  interface ExtraContext {}
+  interface Context extends ExtraContext {
+    /**
+     * 当前请求的跟踪 ID
+     */
+    traceId: string;
+    /**
+     * 当前请求的地址
+     */
+    url: string;
+    /**
+     * 请求头
+     */
+    headers: IncomingHttpHeaders;
+    /**
+     * 设置响应头
+     */
+    setHeader: (key: string, value: string) => void;
+    /**
+     * HTTP 跳转
+     *
+     * 默认是临时跳转，状态码是 302，
+     * 可将第二个参数设为 true 表示永久跳转，状态码是 301
+     */
+    redirect: (url: string, permanently?: boolean) => void;
+    /**
+     * WS
+     */
+    ws: WebSocket;
+    /**
+     * Fastify Request
+     */
+    req: FastifyRequest;
+    /**
+     * Fastify Response
+     */
+    res: FastifyReply;
+  }
+  type Handle<TReqData extends any = void, TResData extends any = void, TReqMethod extends Method = Method> = (
+  /**
+   * 请求数据，WS 时为一个处理函数
+   */
+  data: TReqMethod extends 'WS' ? <T extends keyof TReqData>(type: T, fn: (payload: {
+    data: TReqData[T]['request'];
+    send: (data: TReqData[T]['response']) => void;
+    dispose: DisposeService;
+  }) => any) => void : TReqData,
+  /**
+   * 请求上下文
+   */
+  ctx: Context) => AsyncOrSync<TResData>;
+  interface ExtraOptions {}
+  interface Options<TReqData extends any = void, TResData extends any = void, TReqMethod extends Method = Method, TReqDataRequired = RequiredDeep<TReqData>> extends ExtraOptions {
+    /**
+     * 请求方法
+     *
+     * @default POST
+     */
+    requestMethod?: TReqMethod;
+    /**
+     * 请求 Host
+     */
+    requestHost?: string | RegExp;
+    /**
+     * 请求路径
+     */
+    requestPath?: OneOrMore<string>;
+    /**
+     * 解析请求数据
+     */
+    parseRequestData?: (data: any, ctx: Context) => any;
+    /**
+     * 是否打包返回数据
+     *
+     * @default false
+     */
+    responseDataPack?: boolean;
+    /**
+     * 是否混淆返回数据
+     *
+     * @default false
+     */
+    responseDataObfuscate?: boolean;
+    responseDataEncrypt?: boolean;
+    /**
+     * 响应的 Content-Type 头
+     */
+    responseContentType?: LiteralUnion<'text/html', string>;
+    /**
+     * 请求数据验证结构(vae)
+     */
+    requestDataSchemaVae?: vae.VaeSchemaOf<TReqDataRequired> | ((_: vae.VaeSchemaBuilder<TReqDataRequired>) => vae.VaeSchemaOf<TReqDataRequired> | vae.VaeObjectSchemaShapeOf<TReqDataRequired>);
+    /**
+     * 是否使用异步上下文
+     *
+     * @default 默认为服务的设置
+     */
+    useAsyncContext?: boolean;
+    /**
+     * 并发控制
+     */
+    concurrency?: number | {
+      /** 并发数量 */
+      count?: number;
+      /** 分组函数 */
+      groupBy?: (data: TReqData, ctx: Context) => string;
+    };
+    /**
+     * 处理器
+     */
+    handle: Handle<TReqData, TResData, TReqMethod>;
+  }
+  type Hook = (options: Options, ...args: Parameters<Handle>) => AsyncOrSync<void>;
+}
+export declare namespace XTask {
+  interface TaskOptions<T> {
+    /**
+     * 任务名称
+     */
+    name: string;
+    /**
+     * 并发数量
+     *
+     * @default 1
+     */
+    concurrency?: number;
+    /**
+     * 处理器
+     */
+    handle: (data: T) => any;
+  }
+  interface Task<T> extends Queue<T> {}
+  type SliceTaskOptions<T, K> = {
+    /**
+     * 任务名称
+     */
+    name: string;
+    /**
+     * 持续时长
+     */
+    duration?: MsValue | ((key: K) => MsValue);
+    /**
+     * 阈值数量
+     */
+    threshold?: number | ((key: K) => number);
+    /**
+     * 阈值数量超时时间
+     */
+    thresholdTimeout?: MsValue | ((key: K) => MsValue);
+    /**
+     * 处理器
+     */
+    handle: (data: T[], key: K) => any;
+  };
+  interface SliceTaskNoKey<T> {
+    add: (data: T, options?: {
+      duration?: MsValue;
+      threshold?: number;
+      thresholdTimeout?: MsValue;
+    }) => Promise<void>;
+  }
+  interface SliceTask<T, K> {
+    add: (data: T, options: {
+      key: K;
+      duration?: MsValue;
+      threshold?: number;
+      thresholdTimeout?: MsValue;
+      delay?: MsValue;
+    }) => Promise<void>;
+  }
+}
+export declare namespace XCron {
+  interface Options {
+    /**
+     * 定时语法
+     *
+     * @see https://crontab.guru/
+     * @see https://crontab.cronhub.io/
+     */
+    expression: string;
+    /**
+     * 是否初始化后执行一次
+     */
+    runOnInit?: boolean;
+    /**
+     * 处理器
+     */
+    handle: () => any;
+  }
+  interface Cron extends CronJob {}
+}
+export type XFile = MultipartFile;

package/lib/exports.d.mts

@@ -0,0 +1,46 @@
+import { ctxStorage } from "./core/ctx_storage.mjs";
+import { defineBus } from "./core/define_bus.mjs";
+import { defineCron } from "./core/define_cron.mjs";
+import { defineHandler, defineHandlerANY, defineHandlerFILE, defineHandlerGET, defineHandlerXML } from "./core/define_handler.mjs";
+import { defineHook } from "./core/define_hook.mjs";
+import { defineServer } from "./core/define_server.mjs";
+import { defineSliceTask, defineTask } from "./core/define_task.mjs";
+import { getHandlerUrl } from "./core/get_handler_url.mjs";
+import { Handler, HandlerMethodMap, HandlerPath, HandlerPayloadMap, HandlerResultMap } from "./core/handler.mjs";
+import { HttpError } from "./core/http_error.mjs";
+import { HttpRequestHeader, HttpResponseHeader } from "./core/http_header.mjs";
+import { HandlerMethodToHttpMethod } from "./core/http_method.mjs";
+import { HttpRedirect } from "./core/http_redirect.mjs";
+import { Server } from "./core/server.mjs";
+import { XCron, XFile, XHandler, XServer, XTask } from "./core/types.mjs";
+import { BasePlugin } from "./plugins/base.mjs";
+import { CompressPlugin, CompressPluginOptions } from "./plugins/compress.mjs";
+import { CookiePlugin, CookiePluginOptions } from "./plugins/cookie.mjs";
+import { CorsPlugin, CorsPluginOptions } from "./plugins/cors.mjs";
+import { FileParserPlugin, FileParserPluginOptions, MultipartFile } from "./plugins/file_parser.mjs";
+import { FormBodyParserPlugin, FormBodyParserPluginOptions } from "./plugins/form_body_parser.mjs";
+import { WsParserPlugin, WsParserPluginOptions } from "./plugins/ws_parser.mjs";
+import { XmlParserPlugin, XmlParserPluginOptions } from "./plugins/xml_parser.mjs";
+import { AiService, AiServiceAskPayload, AiServiceAskResult, AiServiceOptions } from "./services/ai.mjs";
+import { BaseService } from "./services/base.mjs";
+import { CacheSerializer, CacheService, CacheServiceOptions } from "./services/cache.mjs";
+import { CaptchaService, CaptchaServiceGenerateCharset, CaptchaServiceGenerateDataUrlResult, CaptchaServiceGenerateImageResult, CaptchaServiceGeneratePayload, CaptchaServiceGenerateResult, CaptchaServiceVerifyOptions } from "./services/captcha.mjs";
+import { CryptoService } from "./services/crypto.mjs";
+import { DbValueService, DbValueServiceJsonObjectOptions, DbValueServiceSimpleArrayOptions } from "./services/db_value.mjs";
+import { DingtalkService, DingtalkServiceOptions, DingtalkServiceSendOptions } from "./services/dingtalk.mjs";
+import { DisposeService, DisposeServiceOptions } from "./services/dispose.mjs";
+import { EmojiService } from "./services/emoji.mjs";
+import { FileStoreService, FileStoreServiceGetUploadUrlPayload, FileStoreServiceGetUploadUrlResult, FileStoreServiceOptions, FileStoreServiceUploadPayload, FileStoreServiceUploadResult } from "./services/file_store.mjs";
+import { HtmlService } from "./services/html.mjs";
+import { JwtService, JwtServiceJwtPayload, JwtServiceOptions } from "./services/jwt.mjs";
+import { LogService, LogServiceDesc, LogServiceLevel, LogServiceLogItem, LogServicePayload, LogServiceWriter } from "./services/log.mjs";
+import { MailService, MailServiceOptions, MailServiceSendOptions } from "./services/mail.mjs";
+import { PayService, PayServiceGetOrderInfoPayload, PayServiceGetOrderInfoResult, PayServiceOptions, PayServicePrepareAlipayOptions, PayServicePrepareAlipayResult, PayServicePrepareWepayOptions, PayServicePrepareWepayResult, PayServiceVerifyNotifyDataResult } from "./services/pay.mjs";
+import { RandomService } from "./services/random.mjs";
+import { RateLimitService, RateLimitServiceLimitByCountOptions, RateLimitServiceLimitByCountOrFailOptions, RateLimitServiceLimitByManyCountOptions, RateLimitServiceLimitByManyCountOrFailOptions } from "./services/rate_limit.mjs";
+import { RedisService, RedisServiceOptions } from "./services/redis.mjs";
+import { SensitiveWordsService, SensitiveWordsServiceOptions } from "./services/sensitive_words.mjs";
+import { SmsService, SmsServiceErrorType, SmsServiceOptions, SmsServiceProvider, SmsServiceSendPayload, SmsServiceSendResult } from "./services/sms.mjs";
+import { MakeDtoExclude, MakeDtoExcludeWithPartial, MakeDtoExcludeWithRequired, MakeDtoExcludeWithRequiredAndPartial, MakeDtoInclude, MakeDtoIncludeWithPartial, MakeDtoIncludeWithRequired, MakeDtoIncludeWithRequiredAndPartial, MakeDtoPartial, MakeDtoPartialByExclude, MakeDtoRequired, MakeDtoRequiredByExclude, MakeDtoWithPagination } from "./types/dto.mjs";
+import { X, x } from "./x.mjs";
+export { AiService, AiServiceAskPayload, AiServiceAskResult, AiServiceOptions, BasePlugin, BaseService, CacheSerializer, CacheService, CacheServiceOptions, CaptchaService, CaptchaServiceGenerateCharset, CaptchaServiceGenerateDataUrlResult, CaptchaServiceGenerateImageResult, CaptchaServiceGeneratePayload, CaptchaServiceGenerateResult, CaptchaServiceVerifyOptions, CompressPlugin, CompressPluginOptions, CookiePlugin, CookiePluginOptions, CorsPlugin, CorsPluginOptions, CryptoService, DbValueService, DbValueServiceJsonObjectOptions, DbValueServiceSimpleArrayOptions, DingtalkService, DingtalkServiceOptions, DingtalkServiceSendOptions, DisposeService, DisposeServiceOptions, EmojiService, FileParserPlugin, FileParserPluginOptions, FileStoreService, FileStoreServiceGetUploadUrlPayload, FileStoreServiceGetUploadUrlResult, FileStoreServiceOptions, FileStoreServiceUploadPayload, FileStoreServiceUploadResult, FormBodyParserPlugin, FormBodyParserPluginOptions, Handler, type HandlerMethodMap, HandlerMethodToHttpMethod, type HandlerPath, type HandlerPayloadMap, type HandlerResultMap, HtmlService, HttpError, HttpRedirect, HttpRequestHeader, HttpResponseHeader, JwtService, JwtServiceJwtPayload, JwtServiceOptions, LogService, LogServiceDesc, LogServiceLevel, LogServiceLogItem, LogServicePayload, LogServiceWriter, MailService, MailServiceOptions, MailServiceSendOptions, MakeDtoExclude, MakeDtoExcludeWithPartial, MakeDtoExcludeWithRequired, MakeDtoExcludeWithRequiredAndPartial, MakeDtoInclude, MakeDtoIncludeWithPartial, MakeDtoIncludeWithRequired, MakeDtoIncludeWithRequiredAndPartial, MakeDtoPartial, MakeDtoPartialByExclude, MakeDtoRequired, MakeDtoRequiredByExclude, MakeDtoWithPagination, type MultipartFile, PayService, PayServiceGetOrderInfoPayload, PayServiceGetOrderInfoResult, PayServiceOptions, PayServicePrepareAlipayOptions, PayServicePrepareAlipayResult, PayServicePrepareWepayOptions, PayServicePrepareWepayResult, PayServiceVerifyNotifyDataResult, RandomService, RateLimitService, RateLimitServiceLimitByCountOptions, RateLimitServiceLimitByCountOrFailOptions, RateLimitServiceLimitByManyCountOptions, RateLimitServiceLimitByManyCountOrFailOptions, RedisService, RedisServiceOptions, SensitiveWordsService, SensitiveWordsServiceOptions, Server, SmsService, SmsServiceErrorType, SmsServiceOptions, SmsServiceProvider, SmsServiceSendPayload, SmsServiceSendResult, WsParserPlugin, WsParserPluginOptions, X, XCron, XFile, XHandler, XServer, XTask, XmlParserPlugin, XmlParserPluginOptions, ctxStorage, defineBus, defineCron, defineHandler, defineHandlerANY, defineHandlerFILE, defineHandlerGET, defineHandlerXML, defineHook, defineServer, defineSliceTask, defineTask, getHandlerUrl, x };

package/lib/exports.mjs

@@ -0,0 +1,46 @@
+import { ctxStorage } from "./core/ctx_storage.mjs";
+import { defineBus } from "./core/define_bus.mjs";
+import { defineCron } from "./core/define_cron.mjs";
+import { defineHandler, defineHandlerANY, defineHandlerFILE, defineHandlerGET, defineHandlerXML } from "./core/define_handler.mjs";
+import { defineHook } from "./core/define_hook.mjs";
+import { defineServer } from "./core/define_server.mjs";
+import { defineSliceTask, defineTask } from "./core/define_task.mjs";
+import { getHandlerUrl } from "./core/get_handler_url.mjs";
+import { Handler } from "./core/handler.mjs";
+import { HttpError } from "./core/http_error.mjs";
+import { HttpRequestHeader, HttpResponseHeader } from "./core/http_header.mjs";
+import { HandlerMethodToHttpMethod } from "./core/http_method.mjs";
+import { HttpRedirect } from "./core/http_redirect.mjs";
+import { Server } from "./core/server.mjs";
+import "./core/types.mjs";
+import "./plugins/base.mjs";
+import { CompressPlugin } from "./plugins/compress.mjs";
+import { CookiePlugin } from "./plugins/cookie.mjs";
+import { CorsPlugin } from "./plugins/cors.mjs";
+import { FileParserPlugin } from "./plugins/file_parser.mjs";
+import { FormBodyParserPlugin } from "./plugins/form_body_parser.mjs";
+import { WsParserPlugin } from "./plugins/ws_parser.mjs";
+import { XmlParserPlugin } from "./plugins/xml_parser.mjs";
+import { AiService } from "./services/ai.mjs";
+import "./services/base.mjs";
+import { CacheService } from "./services/cache.mjs";
+import { CaptchaService } from "./services/captcha.mjs";
+import { CryptoService } from "./services/crypto.mjs";
+import { DbValueService } from "./services/db_value.mjs";
+import { DingtalkService } from "./services/dingtalk.mjs";
+import { DisposeService } from "./services/dispose.mjs";
+import { EmojiService } from "./services/emoji.mjs";
+import { FileStoreService } from "./services/file_store.mjs";
+import { HtmlService } from "./services/html.mjs";
+import { JwtService } from "./services/jwt.mjs";
+import { LogService } from "./services/log.mjs";
+import { MailService } from "./services/mail.mjs";
+import { PayService } from "./services/pay.mjs";
+import { RandomService } from "./services/random.mjs";
+import { RateLimitService } from "./services/rate_limit.mjs";
+import { RedisService } from "./services/redis.mjs";
+import { SensitiveWordsService } from "./services/sensitive_words.mjs";
+import { SmsService } from "./services/sms.mjs";
+import "./types/dto.mjs";
+import { x } from "./x.mjs";
+export { AiService, CacheService, CaptchaService, CompressPlugin, CookiePlugin, CorsPlugin, CryptoService, DbValueService, DingtalkService, DisposeService, EmojiService, FileParserPlugin, FileStoreService, FormBodyParserPlugin, Handler, HandlerMethodToHttpMethod, HtmlService, HttpError, HttpRedirect, HttpRequestHeader, HttpResponseHeader, JwtService, LogService, MailService, PayService, RandomService, RateLimitService, RedisService, SensitiveWordsService, Server, SmsService, WsParserPlugin, XmlParserPlugin, ctxStorage, defineBus, defineCron, defineHandler, defineHandlerANY, defineHandlerFILE, defineHandlerGET, defineHandlerXML, defineHook, defineServer, defineSliceTask, defineTask, getHandlerUrl, x };

package/lib/index.d.mts

@@ -0,0 +1,48 @@
+import { BasePlugin } from "./plugins/base.mjs";
+import { BaseService } from "./services/base.mjs";
+import { DisposeService, DisposeServiceOptions } from "./services/dispose.mjs";
+import { Handler, HandlerMethodMap, HandlerPath, HandlerPayloadMap, HandlerResultMap } from "./core/handler.mjs";
+import { XCron, XFile, XHandler, XServer, XTask } from "./core/types.mjs";
+import { ctxStorage } from "./core/ctx_storage.mjs";
+import { defineBus } from "./core/define_bus.mjs";
+import { defineCron } from "./core/define_cron.mjs";
+import { defineHandler, defineHandlerANY, defineHandlerFILE, defineHandlerGET, defineHandlerXML } from "./core/define_handler.mjs";
+import { defineHook } from "./core/define_hook.mjs";
+import { Server } from "./core/server.mjs";
+import { defineServer } from "./core/define_server.mjs";
+import { defineSliceTask, defineTask } from "./core/define_task.mjs";
+import { getHandlerUrl } from "./core/get_handler_url.mjs";
+import { HttpError } from "./core/http_error.mjs";
+import { HttpRequestHeader, HttpResponseHeader } from "./core/http_header.mjs";
+import { HandlerMethodToHttpMethod } from "./core/http_method.mjs";
+import { HttpRedirect } from "./core/http_redirect.mjs";
+import { CompressPlugin, CompressPluginOptions } from "./plugins/compress.mjs";
+import { CookiePlugin, CookiePluginOptions } from "./plugins/cookie.mjs";
+import { CorsPlugin, CorsPluginOptions } from "./plugins/cors.mjs";
+import { FileParserPlugin, FileParserPluginOptions, MultipartFile } from "./plugins/file_parser.mjs";
+import { FormBodyParserPlugin, FormBodyParserPluginOptions } from "./plugins/form_body_parser.mjs";
+import { WsParserPlugin, WsParserPluginOptions } from "./plugins/ws_parser.mjs";
+import { XmlParserPlugin, XmlParserPluginOptions } from "./plugins/xml_parser.mjs";
+import { AiService, AiServiceAskPayload, AiServiceAskResult, AiServiceOptions } from "./services/ai.mjs";
+import { CacheSerializer, CacheService, CacheServiceOptions } from "./services/cache.mjs";
+import { CaptchaService, CaptchaServiceGenerateCharset, CaptchaServiceGenerateDataUrlResult, CaptchaServiceGenerateImageResult, CaptchaServiceGeneratePayload, CaptchaServiceGenerateResult, CaptchaServiceVerifyOptions } from "./services/captcha.mjs";
+import { CryptoService } from "./services/crypto.mjs";
+import { DbValueService, DbValueServiceJsonObjectOptions, DbValueServiceSimpleArrayOptions } from "./services/db_value.mjs";
+import { DingtalkService, DingtalkServiceOptions, DingtalkServiceSendOptions } from "./services/dingtalk.mjs";
+import { EmojiService } from "./services/emoji.mjs";
+import { FileStoreService, FileStoreServiceGetUploadUrlPayload, FileStoreServiceGetUploadUrlResult, FileStoreServiceOptions, FileStoreServiceUploadPayload, FileStoreServiceUploadResult } from "./services/file_store.mjs";
+import { HtmlService } from "./services/html.mjs";
+import { JwtService, JwtServiceJwtPayload, JwtServiceOptions } from "./services/jwt.mjs";
+import { LogService, LogServiceDesc, LogServiceLevel, LogServiceLogItem, LogServicePayload, LogServiceWriter } from "./services/log.mjs";
+import { MailService, MailServiceOptions, MailServiceSendOptions } from "./services/mail.mjs";
+import { PayService, PayServiceGetOrderInfoPayload, PayServiceGetOrderInfoResult, PayServiceOptions, PayServicePrepareAlipayOptions, PayServicePrepareAlipayResult, PayServicePrepareWepayOptions, PayServicePrepareWepayResult, PayServiceVerifyNotifyDataResult } from "./services/pay.mjs";
+import { RandomService } from "./services/random.mjs";
+import { RateLimitService, RateLimitServiceLimitByCountOptions, RateLimitServiceLimitByCountOrFailOptions, RateLimitServiceLimitByManyCountOptions, RateLimitServiceLimitByManyCountOrFailOptions } from "./services/rate_limit.mjs";
+import { RedisService, RedisServiceOptions } from "./services/redis.mjs";
+import { SensitiveWordsService, SensitiveWordsServiceOptions } from "./services/sensitive_words.mjs";
+import { SmsService, SmsServiceErrorType, SmsServiceOptions, SmsServiceProvider, SmsServiceSendPayload, SmsServiceSendResult } from "./services/sms.mjs";
+import { MakeDtoExclude, MakeDtoExcludeWithPartial, MakeDtoExcludeWithRequired, MakeDtoExcludeWithRequiredAndPartial, MakeDtoInclude, MakeDtoIncludeWithPartial, MakeDtoIncludeWithRequired, MakeDtoIncludeWithRequiredAndPartial, MakeDtoPartial, MakeDtoPartialByExclude, MakeDtoRequired, MakeDtoRequiredByExclude, MakeDtoWithPagination } from "./types/dto.mjs";
+import { X, x } from "./x.mjs";
+import "./exports.mjs";
+export * from "@a/x/models";
+export { AiService, AiServiceAskPayload, AiServiceAskResult, AiServiceOptions, BasePlugin, BaseService, CacheSerializer, CacheService, CacheServiceOptions, CaptchaService, CaptchaServiceGenerateCharset, CaptchaServiceGenerateDataUrlResult, CaptchaServiceGenerateImageResult, CaptchaServiceGeneratePayload, CaptchaServiceGenerateResult, CaptchaServiceVerifyOptions, CompressPlugin, CompressPluginOptions, CookiePlugin, CookiePluginOptions, CorsPlugin, CorsPluginOptions, CryptoService, DbValueService, DbValueServiceJsonObjectOptions, DbValueServiceSimpleArrayOptions, DingtalkService, DingtalkServiceOptions, DingtalkServiceSendOptions, DisposeService, DisposeServiceOptions, EmojiService, FileParserPlugin, FileParserPluginOptions, FileStoreService, FileStoreServiceGetUploadUrlPayload, FileStoreServiceGetUploadUrlResult, FileStoreServiceOptions, FileStoreServiceUploadPayload, FileStoreServiceUploadResult, FormBodyParserPlugin, FormBodyParserPluginOptions, Handler, type HandlerMethodMap, HandlerMethodToHttpMethod, type HandlerPath, type HandlerPayloadMap, type HandlerResultMap, HtmlService, HttpError, HttpRedirect, HttpRequestHeader, HttpResponseHeader, JwtService, JwtServiceJwtPayload, JwtServiceOptions, LogService, LogServiceDesc, LogServiceLevel, LogServiceLogItem, LogServicePayload, LogServiceWriter, MailService, MailServiceOptions, MailServiceSendOptions, MakeDtoExclude, MakeDtoExcludeWithPartial, MakeDtoExcludeWithRequired, MakeDtoExcludeWithRequiredAndPartial, MakeDtoInclude, MakeDtoIncludeWithPartial, MakeDtoIncludeWithRequired, MakeDtoIncludeWithRequiredAndPartial, MakeDtoPartial, MakeDtoPartialByExclude, MakeDtoRequired, MakeDtoRequiredByExclude, MakeDtoWithPagination, type MultipartFile, PayService, PayServiceGetOrderInfoPayload, PayServiceGetOrderInfoResult, PayServiceOptions, PayServicePrepareAlipayOptions, PayServicePrepareAlipayResult, PayServicePrepareWepayOptions, PayServicePrepareWepayResult, PayServiceVerifyNotifyDataResult, RandomService, RateLimitService, RateLimitServiceLimitByCountOptions, RateLimitServiceLimitByCountOrFailOptions, RateLimitServiceLimitByManyCountOptions, RateLimitServiceLimitByManyCountOrFailOptions, RedisService, RedisServiceOptions, SensitiveWordsService, SensitiveWordsServiceOptions, Server, SmsService, SmsServiceErrorType, SmsServiceOptions, SmsServiceProvider, SmsServiceSendPayload, SmsServiceSendResult, WsParserPlugin, WsParserPluginOptions, X, XCron, XFile, XHandler, XServer, XTask, XmlParserPlugin, XmlParserPluginOptions, ctxStorage, defineBus, defineCron, defineHandler, defineHandlerANY, defineHandlerFILE, defineHandlerGET, defineHandlerXML, defineHook, defineServer, defineSliceTask, defineTask, getHandlerUrl, x };