elysia 2.0.0-exp.11 → 2.0.0-exp.12

package/dist/adapter/bun/index.d.ts

@@ -6,7 +6,7 @@ import { AnyElysia } from "../../base.js";
 declare function collectStaticRoutes(app: AnyElysia): readonly [Record<string, Record<string, Response>>, Promise<void>[]] | undefined;
 declare const BunAdapter: {
   parse: {
-    default: (context: Context, contentType: string) => string | Record<string, unknown> | unknown[] | ArrayBuffer | Promise<unknown[] | Record<string | number | symbol, undefined>> | Promise<ArrayBuffer> | Promise<Record<string, unknown>> | Promise<string> | undefined;
+    default: (context: Context, contentType: string) => string | unknown[] | ArrayBuffer | Record<string, unknown> | Promise<unknown[] | Record<string | number | symbol, undefined>> | Promise<ArrayBuffer> | Promise<Record<string, unknown>> | Promise<string> | undefined;
     json: (context: Context) => MaybePromise<Record<keyof any, undefined> | unknown[]>;
     text: (context: Context) => MaybePromise<string>;
     urlencoded: (context: Context) => MaybePromise<Record<string, string | string[]>>;

package/dist/adapter/bun/index.js

@@ -47,6 +47,8 @@ const BunAdapter = require_adapter_index.createAdapter({
 		const hasWs = app["~hasWS"];
 		if (!serve.fetch) serve.fetch = (request, server) => app.fetch(request, server);
 		app.server = Bun.serve(serve);
+		const onSetup = app["~ext"]?.setup;
+		if (onSetup) for (let i = 0; i < onSetup.length; i++) onSetup[i](app);
 		if (!hasWs) callback?.(app.server);
 		queueMicrotask(() => {
 			if (!app.pending) serve.fetch = app.fetch;

package/dist/adapter/bun/index.mjs

@@ -46,6 +46,8 @@ const BunAdapter = createAdapter({
 		const hasWs = app["~hasWS"];
 		if (!serve.fetch) serve.fetch = (request, server) => app.fetch(request, server);
 		app.server = Bun.serve(serve);
+		const onSetup = app["~ext"]?.setup;
+		if (onSetup) for (let i = 0; i < onSetup.length; i++) onSetup[i](app);
 		if (!hasWs) callback?.(app.server);
 		queueMicrotask(() => {
 			if (!app.pending) serve.fetch = app.fetch;

package/dist/adapter/constants.d.ts

@@ -5,7 +5,7 @@ import { AnyElysia } from "../base.js";
 //#region src/adapter/constants.d.ts
 declare const defaultAdapter: {
   parse: {
-    default: (context: Context, contentType: string) => string | Record<string, unknown> | unknown[] | ArrayBuffer | Promise<unknown[] | Record<string | number | symbol, undefined>> | Promise<ArrayBuffer> | Promise<Record<string, unknown>> | Promise<string> | undefined;
+    default: (context: Context, contentType: string) => string | unknown[] | ArrayBuffer | Record<string, unknown> | Promise<unknown[] | Record<string | number | symbol, undefined>> | Promise<ArrayBuffer> | Promise<Record<string, unknown>> | Promise<string> | undefined;
     json: (context: Context) => MaybePromise<Record<keyof any, undefined> | unknown[]>;
     text: (context: Context) => MaybePromise<string>;
     urlencoded: (context: Context) => MaybePromise<Record<string, string | string[]>>;

package/dist/adapter/index.d.ts

@@ -7,7 +7,7 @@ import { AnyElysia } from "../base.js";
 //#region src/adapter/index.d.ts
 declare function createAdapter(adapter: ElysiaAdapterOptions): {
   parse: {
-    default: (context: Context, contentType: string) => string | Record<string, unknown> | unknown[] | ArrayBuffer | Promise<unknown[] | Record<string | number | symbol, undefined>> | Promise<ArrayBuffer> | Promise<Record<string, unknown>> | Promise<string> | undefined;
+    default: (context: Context, contentType: string) => string | unknown[] | ArrayBuffer | Record<string, unknown> | Promise<unknown[] | Record<string | number | symbol, undefined>> | Promise<ArrayBuffer> | Promise<Record<string, unknown>> | Promise<string> | undefined;
     json: (context: Context) => MaybePromise<Record<keyof any, undefined> | unknown[]>;
     text: (context: Context) => MaybePromise<string>;
     urlencoded: (context: Context) => MaybePromise<Record<string, string | string[]>>;

package/dist/adapter/web-standard/index.d.ts

@@ -5,7 +5,7 @@ import { AnyElysia } from "../../base.js";
 //#region src/adapter/web-standard/index.d.ts
 declare const WebStandardAdapter: {
   parse: {
-    default: (context: Context, contentType: string) => string | Record<string, unknown> | unknown[] | ArrayBuffer | Promise<unknown[] | Record<string | number | symbol, undefined>> | Promise<ArrayBuffer> | Promise<Record<string, unknown>> | Promise<string> | undefined;
+    default: (context: Context, contentType: string) => string | unknown[] | ArrayBuffer | Record<string, unknown> | Promise<unknown[] | Record<string | number | symbol, undefined>> | Promise<ArrayBuffer> | Promise<Record<string, unknown>> | Promise<string> | undefined;
     json: (context: Context) => MaybePromise<Record<keyof any, undefined> | unknown[]>;
     text: (context: Context) => MaybePromise<string>;
     urlencoded: (context: Context) => MaybePromise<Record<string, string | string[]>>;

package/dist/base.d.ts

@@ -1,7 +1,7 @@
 import { ElysiaStatus } from "./error.js";
 import { TraceHandler } from "./trace.js";
 import { ListenCallback, Serve, Server } from "./universal/server.js";
-import { AddRoute, AddWSRoute, AfterHandler, AfterResponseHandler, AnyErrorConstructor, AnyLocalHook, BodyHandler, CompiledHandler, CreateEden, DefaultEphemeral, DefaultMetadata, DefaultSingleton, DefinitionBase, DocumentDecoration, ElysiaConfig, ElysiaHandlerToResponseSchemaAmbiguous, EphemeralType, ErrorDefinitionEntry, ErrorHandler, EventScope, ExcludeElysiaResponse, ExtractErrorFromHandle, GuardLocalHook, HTTPMethod, InlineHandler, InlineHandlerNonMacro, InputSchema, InputSchemaKey, InternalRoute, IntersectIfObjectSchema, JoinPath, LocalHook, Macro, MacroToContext, MacroToProperty, MapResponse, MaybeArray, MaybePromise, MergeElysiaInstances, MergeSchema, MergeScopedSchemas, MetadataBase, NonResolvableMacroKey, ObjectMacroDefs, OptionalHandler, PreHandler, Prettify, PublicRoute, ResolveRouteErrors, RouteBase, SingletonBase, TransformHandler, UnionResponseStatus, UnwrapRoute, WrapFn } from "./types.js";
+import { AddRoute, AddWSRoute, AfterHandler, AfterResponseHandler, AnyErrorConstructor, AnyLocalHook, BodyHandler, CompiledHandler, CreateEden, DefaultEphemeral, DefaultMetadata, DefaultSingleton, DefinitionBase, DocumentDecoration, ElysiaConfig, ElysiaHandlerToResponseSchemaAmbiguous, EphemeralType, ErrorDefinitionEntry, ErrorHandler, EventScope, ExcludeElysiaResponse, ExtractErrorFromHandle, GracefulHandler, GuardLocalHook, HTTPMethod, InlineHandler, InlineHandlerNonMacro, InputSchema, InputSchemaKey, InternalRoute, IntersectIfObjectSchema, JoinPath, LocalHook, Macro, MacroToContext, MacroToProperty, MapResponse, MaybeArray, MaybePromise, MergeElysiaInstances, MergeSchema, MergeScopedSchemas, MetadataBase, NonResolvableMacroKey, ObjectMacroDefs, OptionalHandler, PreHandler, Prettify, PublicRoute, ResolveRouteErrors, RouteBase, SingletonBase, TransformHandler, UnionResponseStatus, UnwrapRoute, WrapFn } from "./types.js";
 import { AnySchema } from "./type/types.js";
 import { ChainNode } from "./utils.js";
 import { Context, ErrorContext, LifecycleContext } from "./context.js";
@@ -34,6 +34,8 @@ declare class Elysia<const in out BasePath extends string = '', const in out Sco
     error?: Map<AnyErrorConstructor, string>;
     parser?: Record<string, BodyHandler<any, any>>;
     hoc?: WrapFn<any>[];
+    setup?: GracefulHandler<any>[];
+    cleanup?: GracefulHandler<any>[];
   };
   '~hookChain'?: ChainNode;
   server?: Server;
@@ -175,8 +177,21 @@ declare class Elysia<const in out BasePath extends string = '', const in out Sco
     parser: Metadata['parser'] & { [name in Name]: BodyHandler<any, any> };
     response: Metadata['response'];
   }, Routes, Ephemeral, Volatile>;
-  onStart(_listener?: unknown): this;
-  onStop(_listener?: unknown): this;
+  /**
+   * ### setup | Life cycle event
+   * Called after server is ready for serving
+   *
+   * ---
+   * @example
+   * ```typescript
+   * new Elysia()
+   *     .setup(({ server }) => {
+   *         console.log("Running at ${server?.url}:${server?.port}")
+   *     })
+   *     .listen(3000)
+   * ```
+   */
+  setup(handler: MaybeArray<GracefulHandler<this>>): this;
   transform(fn: MaybeArray<TransformHandler<MergeSchema<{}, {}, BasePath>, Singleton & {
     derive: Ephemeral['derive'] & Volatile['derive'];
   }>>): this;
@@ -990,7 +1005,22 @@ declare class Elysia<const in out BasePath extends string = '', const in out Sco
   listen(options: string | number | Partial<Serve>, callback?: ListenCallback): this;
   wrap<T extends (...params: any) => MaybePromise<Response> = (request: Request, ...rest: any[]) => MaybePromise<Response>>(callback: WrapFn<T>): this;
   /**
-   * Stop the underlying server (if any). Mirrors `Server.stop()`.
+   * ### cleanup | Life cycle event
+   * Called after server stop serving request
+   *
+   * ---
+   * @example
+   * ```typescript
+   * new Elysia()
+   *     .cleanup((app) => {
+   *         closeDatabase()
+   *     })
+   * ```
+   */
+  cleanup(handler: MaybeArray<GracefulHandler<this>>): this;
+  /**
+   * Stop the underlying server (if any), running every `cleanup` handler once
+   * it has stopped. Mirrors `Server.stop()`.
    *
    * @param closeActiveConnections Pass `true` to terminate in-flight
    *   requests and WebSocket connections immediately. Defaults to

package/dist/base.js

@@ -173,10 +173,24 @@ var Elysia = class Elysia {
 		parsers[name] = fn;
 		return this;
 	}
-	onStart(_listener) {
-		return this;
-	}
-	onStop(_listener) {
+	/**
+	* ### setup | Life cycle event
+	* Called after server is ready for serving
+	*
+	* ---
+	* @example
+	* ```typescript
+	* new Elysia()
+	*     .setup(({ server }) => {
+	*         console.log("Running at ${server?.url}:${server?.port}")
+	*     })
+	*     .listen(3000)
+	* ```
+	*/
+	setup(handler) {
+		const arr = this.#ext.setup ??= [];
+		if (Array.isArray(handler)) arr.push(...handler);
+		else arr.push(handler);
 		return this;
 	}
 	transform(scopeOrFn, fn) {
@@ -518,7 +532,7 @@ var Elysia = class Elysia {
 		}
 		const hookChain = app["~hookChain"];
 		if (app["~ext"]) {
-			const { decorator, store, headers, models, parser, macro, error, hoc } = app["~ext"];
+			const { decorator, store, headers, models, parser, macro, error, hoc, setup, cleanup } = app["~ext"];
 			const ext = this["~ext"] ??= require_utils.nullObject();
 			if (decorator) {
 				const cloned = require_utils.clonePlainDecorators(decorator);
@@ -540,6 +554,12 @@ var Elysia = class Elysia {
 			if (hoc) if (ext.hoc) {
 				for (const fn of hoc) if (!ext.hoc.includes(fn)) ext.hoc.push(fn);
 			} else ext.hoc = hoc.slice();
+			if (setup) if (ext.setup) {
+				for (const fn of setup) if (!ext.setup.includes(fn)) ext.setup.push(fn);
+			} else ext.setup = setup.slice();
+			if (cleanup) if (ext.cleanup) {
+				for (const fn of cleanup) if (!ext.cleanup.includes(fn)) ext.cleanup.push(fn);
+			} else ext.cleanup = cleanup.slice();
 		}
 		if (app.#hasPlugin || app.#hasGlobal || hookChain) {
 			let pluginEvents;
@@ -1014,7 +1034,27 @@ var Elysia = class Elysia {
 		return this;
 	}
 	/**
-	* Stop the underlying server (if any). Mirrors `Server.stop()`.
+	* ### cleanup | Life cycle event
+	* Called after server stop serving request
+	*
+	* ---
+	* @example
+	* ```typescript
+	* new Elysia()
+	*     .cleanup((app) => {
+	*         closeDatabase()
+	*     })
+	* ```
+	*/
+	cleanup(handler) {
+		const arr = this.#ext.cleanup ??= [];
+		if (Array.isArray(handler)) arr.push(...handler);
+		else arr.push(handler);
+		return this;
+	}
+	/**
+	* Stop the underlying server (if any), running every `cleanup` handler once
+	* it has stopped. Mirrors `Server.stop()`.
 	*
 	* @param closeActiveConnections Pass `true` to terminate in-flight
 	*   requests and WebSocket connections immediately. Defaults to
@@ -1025,6 +1065,12 @@ var Elysia = class Elysia {
 		if (!server) return;
 		const r = server.stop?.(closeActiveConnections);
 		this.server = void 0;
+		const handlers = this["~ext"]?.cleanup;
+		const fire = handlers ? () => {
+			for (let i = 0; i < handlers.length; i++) handlers[i](this);
+		} : void 0;
+		if (r && typeof r.then === "function") return fire ? r.then(fire) : r;
+		fire?.();
 		return r;
 	}
 };

package/dist/base.mjs

@@ -170,10 +170,24 @@ var Elysia = class Elysia {
 		parsers[name] = fn;
 		return this;
 	}
-	onStart(_listener) {
-		return this;
-	}
-	onStop(_listener) {
+	/**
+	* ### setup | Life cycle event
+	* Called after server is ready for serving
+	*
+	* ---
+	* @example
+	* ```typescript
+	* new Elysia()
+	*     .setup(({ server }) => {
+	*         console.log("Running at ${server?.url}:${server?.port}")
+	*     })
+	*     .listen(3000)
+	* ```
+	*/
+	setup(handler) {
+		const arr = this.#ext.setup ??= [];
+		if (Array.isArray(handler)) arr.push(...handler);
+		else arr.push(handler);
 		return this;
 	}
 	transform(scopeOrFn, fn) {
@@ -515,7 +529,7 @@ var Elysia = class Elysia {
 		}
 		const hookChain = app["~hookChain"];
 		if (app["~ext"]) {
-			const { decorator, store, headers, models, parser, macro, error, hoc } = app["~ext"];
+			const { decorator, store, headers, models, parser, macro, error, hoc, setup, cleanup } = app["~ext"];
 			const ext = this["~ext"] ??= nullObject();
 			if (decorator) {
 				const cloned = clonePlainDecorators(decorator);
@@ -537,6 +551,12 @@ var Elysia = class Elysia {
 			if (hoc) if (ext.hoc) {
 				for (const fn of hoc) if (!ext.hoc.includes(fn)) ext.hoc.push(fn);
 			} else ext.hoc = hoc.slice();
+			if (setup) if (ext.setup) {
+				for (const fn of setup) if (!ext.setup.includes(fn)) ext.setup.push(fn);
+			} else ext.setup = setup.slice();
+			if (cleanup) if (ext.cleanup) {
+				for (const fn of cleanup) if (!ext.cleanup.includes(fn)) ext.cleanup.push(fn);
+			} else ext.cleanup = cleanup.slice();
 		}
 		if (app.#hasPlugin || app.#hasGlobal || hookChain) {
 			let pluginEvents;
@@ -1011,7 +1031,27 @@ var Elysia = class Elysia {
 		return this;
 	}
 	/**
-	* Stop the underlying server (if any). Mirrors `Server.stop()`.
+	* ### cleanup | Life cycle event
+	* Called after server stop serving request
+	*
+	* ---
+	* @example
+	* ```typescript
+	* new Elysia()
+	*     .cleanup((app) => {
+	*         closeDatabase()
+	*     })
+	* ```
+	*/
+	cleanup(handler) {
+		const arr = this.#ext.cleanup ??= [];
+		if (Array.isArray(handler)) arr.push(...handler);
+		else arr.push(handler);
+		return this;
+	}
+	/**
+	* Stop the underlying server (if any), running every `cleanup` handler once
+	* it has stopped. Mirrors `Server.stop()`.
 	*
 	* @param closeActiveConnections Pass `true` to terminate in-flight
 	*   requests and WebSocket connections immediately. Defaults to
@@ -1022,6 +1062,12 @@ var Elysia = class Elysia {
 		if (!server) return;
 		const r = server.stop?.(closeActiveConnections);
 		this.server = void 0;
+		const handlers = this["~ext"]?.cleanup;
+		const fire = handlers ? () => {
+			for (let i = 0; i < handlers.length; i++) handlers[i](this);
+		} : void 0;
+		if (r && typeof r.then === "function") return fire ? r.then(fire) : r;
+		fire?.();
 		return r;
 	}
 };

package/dist/type/index.d.ts

@@ -3,9 +3,11 @@ import { FileTypeDetector, fileType, setFileTypeDetector } from "./elysia/file-t
 import { exports_d_exports } from "./exports.js";
 import { setupTypebox } from "./compat.js";
 import { TypeBoxValidator } from "./validator/index.js";
+import * as TypeBoxType from "typebox/type";
 import { System as TypeSystem } from "typebox/system";
 
 //#region src/type/index.d.ts
-declare const t: typeof exports_d_exports;
+type TypeBuilder = Omit<typeof TypeBoxType, keyof typeof exports_d_exports> & typeof exports_d_exports;
+declare const t: TypeBuilder;
 //#endregion
 export { type AnySchema, type BaseSchema, type FileTypeDetector, type StandardJSONSchemaV1Like, type StandardSchemaV1Like, type TypeBoxSchema, TypeBoxValidator, TypeSystem, fileType, setFileTypeDetector, setupTypebox, t };

package/dist/type/types.d.ts

@@ -1,9 +1,9 @@
 import { ELYSIA_TYPES } from "./constants.js";
 import { CookieOptions } from "../cookie/types.js";
 import { MaybeArray } from "../types.js";
+import { Validator } from "typebox/schema";
 import { TObjectOptions, TSchemaOptions } from "typebox";
 import { TLocalizedValidationError } from "typebox/error";
-import { Validator } from "typebox/schema";
 
 //#region src/type/types.d.ts
 type FileUnit = number | `${number}${'k' | 'm'}`;

package/dist/type/validator/index.d.ts

@@ -2,8 +2,8 @@ import { MaybePromise } from "../../types.js";
 import { Validator as Validator$1, ValidatorOptions } from "../../validator/index.js";
 import { TypeBoxValidatorCache } from "./validator-cache.js";
 import { Static, StaticDecode, StaticEncode, TAny, TSchema } from "typebox/type";
-import { TLocalizedValidationError } from "typebox/error";
 import { Validator } from "typebox/schema";
+import { TLocalizedValidationError } from "typebox/error";
 
 //#region src/type/validator/index.d.ts
 declare function shallowMergeObjects(members: any[]): TSchema | null;

package/dist/types.d.ts

@@ -10,8 +10,8 @@ import { ChainNode } from "./utils.js";
 import { Context, ErrorContext, LifecycleContext, PreContext } from "./context.js";
 import { WebSocketHandler } from "./ws/types.js";
 import { AnyElysia, Elysia } from "./base.js";
-import { Static, StaticDecode, StaticEncode, TIntersect, TObject, TSchema } from "typebox";
 import { Instruction } from "exact-mirror";
+import { Static, StaticDecode, StaticEncode, TIntersect, TObject, TSchema } from "typebox";
 import { OpenAPIV3 } from "openapi-types";
 
 //#region src/types.d.ts

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "elysia",
 	"description": "Ergonomic Framework for Human",
-	"version": "2.0.0-exp.11",
+	"version": "2.0.0-exp.12",
 	"author": {
 		"name": "saltyAom",
 		"url": "https://github.com/SaltyAom",