@pori15/logixlysia 6.0.1 → 6.0.3

package/dist/index.d.ts

@@ -36,10 +36,87 @@ declare class ProblemError extends Error {
 	constructor(type: string | undefined, title: string, status: number, detail?: string, instance?: string, extensions?: Record<string, unknown>);
 	toJSON(): ProblemDocument;
 }
-declare const HttpError: {};
+declare class BadRequest extends ProblemError {
+	constructor(detail?: string, extensions?: Record<string, any>);
+}
+declare class Unauthorized extends ProblemError {
+	constructor(detail?: string, extensions?: Record<string, any>);
+}
+declare class Forbidden extends ProblemError {
+	constructor(detail?: string, extensions?: Record<string, any>);
+}
+declare class NotFound extends ProblemError {
+	constructor(detail?: string, extensions?: Record<string, any>);
+}
+declare class Conflict extends ProblemError {
+	constructor(detail?: string, extensions?: Record<string, any>);
+}
+declare class PaymentRequired extends ProblemError {
+	constructor(detail?: string, extensions?: Record<string, any>);
+}
+declare class MethodNotAllowed extends ProblemError {
+	constructor(detail?: string, extensions?: Record<string, any>);
+}
+declare class NotAcceptable extends ProblemError {
+	constructor(detail?: string, extensions?: Record<string, any>);
+}
+declare class InternalServerError extends ProblemError {
+	constructor(detail?: string, extensions?: Record<string, any>);
+}
+declare class NotImplemented extends ProblemError {
+	constructor(detail?: string, extensions?: Record<string, any>);
+}
+declare class BadGateway extends ProblemError {
+	constructor(detail?: string, extensions?: Record<string, any>);
+}
+declare class ServiceUnavailable extends ProblemError {
+	constructor(detail?: string, extensions?: Record<string, any>);
+}
+declare class GatewayTimeout extends ProblemError {
+	constructor(detail?: string, extensions?: Record<string, any>);
+}
+interface HttpErrorConstructor {
+	BadRequest: typeof BadRequest;
+	Unauthorized: typeof Unauthorized;
+	PaymentRequired: typeof PaymentRequired;
+	Forbidden: typeof Forbidden;
+	NotFound: typeof NotFound;
+	MethodNotAllowed: typeof MethodNotAllowed;
+	NotAcceptable: typeof NotAcceptable;
+	Conflict: typeof Conflict;
+	InternalServerError: typeof InternalServerError;
+	NotImplemented: typeof NotImplemented;
+	BadGateway: typeof BadGateway;
+	ServiceUnavailable: typeof ServiceUnavailable;
+	GatewayTimeout: typeof GatewayTimeout;
+}
+declare const HttpError: HttpErrorConstructor;
 type Code = number | "PROBLEM_ERROR" | "UNKNOWN" | "VALIDATION" | "NOT_FOUND" | "PARSE" | "INTERNAL_SERVER_ERROR" | "INVALID_COOKIE_SIGNATURE" | "INVALID_FILE_TYPE";
+interface ErrorContext {
+	request: Request;
+	path: string;
+	code: string | number;
+	error: unknown;
+}
+interface HttpProblemJsonOptions {
+	/**
+	* 自定义错误类型的 Base URL
+	* @example "https://api.mysite.com/errors"
+	*/
+	typeBaseUrl?: string;
+	/**
+	* 🪝 Transform Hook
+	* 将未知错误转换为 HttpError。
+	* 返回 undefined/null 表示不处理（走默认逻辑）。
+	*/
+	transform?: (error: unknown, context: ErrorContext) => ProblemError | undefined | null;
+	/**
+	* 📢 Listen Hook
+	* 在响应发送前触发（用于日志）。
+	*/
+	onBeforeRespond?: (problem: ProblemError, context: ErrorContext) => void | Promise<void>;
+}
 type Pino = PinoLogger<never, boolean>;
-type Request2 = Request2;
 type LogLevel = "DEBUG" | "INFO" | "WARNING" | "ERROR";
 interface StoreData {
 	beforeTime: bigint;
@@ -103,23 +180,25 @@ interface Options {
 		};
 	};
 	transform?: (error: unknown, context: {
-		request: Request2;
+		request: Request;
 		code: Code;
+		path: string;
 	}) => ProblemError | unknown;
 }
 interface Logger {
 	pino: Pino;
-	log: (level: LogLevel, request: Request2, data: Record<string, unknown>, store: StoreData) => void;
-	handleHttpError: (request: Request2, error: ProblemError, store: StoreData, options: Options) => void;
-	debug: (request: Request2, message: string, context?: Record<string, unknown>) => void;
-	info: (request: Request2, message: string, context?: Record<string, unknown>) => void;
-	warn: (request: Request2, message: string, context?: Record<string, unknown>) => void;
-	error: (request: Request2, message: string, context?: Record<string, unknown>) => void;
+	log: (level: LogLevel, request: Request, data: Record<string, unknown>, store: StoreData) => void;
+	handleHttpError: (request: Request, error: ProblemError, store: StoreData, options: Options) => void;
+	debug: (request: Request, message: string, context?: Record<string, unknown>) => void;
+	info: (request: Request, message: string, context?: Record<string, unknown>) => void;
+	warn: (request: Request, message: string, context?: Record<string, unknown>) => void;
+	error: (request: Request, message: string, context?: Record<string, unknown>) => void;
 }
 interface LogixlysiaContext {
-	request: Request2;
+	request: Request;
 	store: LogixlysiaStore;
 }
+declare const normalizeToProblem: (error: any, code: Code, path: string, typeBaseUrl?: string) => ProblemError;
 interface ProblemJson {
 	type?: string;
 	title: string;
@@ -156,4 +235,4 @@ type Logixlysia = Elysia<"Logixlysia", SingletonBase & {
 	store: LogixlysiaStore;
 }>;
 declare const logixlysia: (options?: Options) => Logixlysia;
-export { toProblemJson, logixlysia, formatProblemJsonLog, logixlysia as default, Transport, StoreData, ProblemJson, Pino, Options, LogixlysiaStore, LogixlysiaContext, Logixlysia, Logger, LogLevel, HttpError };
+export { toProblemJson, normalizeToProblem, logixlysia, formatProblemJsonLog, logixlysia as default, Transport, StoreData, ProblemJsonOptions, ProblemJson, ProblemError, ProblemDocument, Pino, Options, LogixlysiaStore, LogixlysiaContext, Logixlysia, Logger, LogLevel, HttpProblemJsonOptions, HttpErrorConstructor, HttpError, ErrorContext, Code };