@virid/express 0.1.0 → 0.1.2

package/README.md

@@ -1 +1,265 @@
-todo
+
+
+# **@virid/express**
+
+`@virid/express` is an adapter for Express responsible for converting incoming HTTP request messages into Virid’s `HttpRequestMessage`. It also provides a set of dependency injection features similar to NestJS, making the handling of HTTP requests as seamless as processing local Messages.
+
+## 🌟 Core Design Philosophy
+
+In `@virid/express`, Express serves merely as a standard I/O layer. Its role is to convert HTTP requests into corresponding Messages and deliver them into the Virid scheduler. Additionally, `@virid/express` provides a set of NestJS-like decorators, allowing HTTP request components—such as the **body** and **query**—to be injected directly into the System.
+
+- **HTTP Request to Message:** All HTTP requests are instantiated as specific Messages and dispatched to the scheduler. By using decorators, the Message declaration itself becomes the API definition.
+- **Semantic Return Values:** You can use factory functions like `Ok()`, `NotFound()`, or `StreamFile()` within a System. These are automatically converted into the appropriate HTTP status codes to terminate the request. Alternatively, returning a new `HttpRequestMessage` enables internal request forwarding.
+- **Lifecycle Reference Counting:** To support internal forwarding and redirection, `@virid/express` implements reference-counted lifecycle tracking for every HTTP request. If a request has not been responded to after all Systems finish execution, `@virid/express` will automatically close the connection and throw an error to prevent the request from hanging.
+
+## 🔌Enable plugins
+
+```ts
+import { createVirid } from '@virid/core'
+import { ExpressPlugin } from '@virid/express'
+import express from 'express'
+
+const server = express()
+const virid = createVirid()
+  .use(ExpressPlugin, { server: server })
+```
+
+## 🛠️ @virid/express Core API Overview
+
+### **HttpContext**
+
+- **Function:** `@virid/express` maintains an `HttpContext` for every HTTP request, containing critical metadata. Whenever a corresponding `System` finishes execution, the Reference Count (**RC**) is automatically decremented by 1. If the RC reaches 0 and the HTTP request has not yet received a response, `@virid/express` will automatically close the connection and log an error message.
+- **Logic:** You can use the `@Ctx()` decorator within a `System` to retrieve the `HttpContext` of the current request.
+- **Example:**
+
+```ts
+export class HttpContext {
+  public rc: number = 0;
+  public isClosed: boolean = false;
+
+  constructor(
+    public readonly id: number,
+    public readonly req: Request,
+    public readonly res: Response,
+    public readonly timestamp: number,
+    public readonly route: string,
+  ) {}
+}
+```
+
+------
+
+### **HttpRequestMessage & @HttpRoute()**
+
+- **Function:** `HttpRequestMessage` is a specialized Message type. Every incoming HTTP request is automatically converted into a message of this type. The `@HttpRoute` decorator marks the routing metadata for the `HttpRequestMessage`, including the **path** and **method**.
+- **Logic:** `@HttpRoute` and `HttpRequestMessage` are designed to be used as a pair; `@HttpRoute` can only be applied to classes extending `HttpRequestMessage`. Each `HttpRequestMessage` comes with a `RequestId` type ID, serving as the unique identifier for the current request.
+- **Example:**
+
+```ts
+import { HttpRoute, HttpRequestMessage } from '@virid/express';
+
+@HttpRoute({
+  path: '/api/login/qr/check',
+  method: 'post'
+})
+export class LoginQrCheckRequestMessage extends HttpRequestMessage {}
+```
+
+### **@HttpSystem()**
+
+- **Function:** `@HttpSystem()` differs from the standard `@System()` found in `@virid/core`. It can only be triggered by messages of type `HttpRequestMessage` and supports specialized decorators such as `@Body`, `@Query`, etc.
+- **Logic:** If an error is thrown within an `@HttpSystem`, it is automatically caught and converted into an `InternalServerError()`. Furthermore, `@HttpSystem` supports returning factory functions like `Ok()` or `NotFound()` to directly set response headers and HTTP status codes. It also allows returning a new `HttpRequestMessage` to achieve "request relay" (internal forwarding).
+
+#### **Example 1: Parameter Injection**
+
+You can inject various HTTP parameters directly into the system method.
+
+```ts
+import { Body, Cookies, Headers, HttpSystem, Ok } from '@virid/express'
+
+export class LoginQrCheckSystem {
+  @HttpSystem({
+    messageClass: LoginQrCheckRequestMessage
+  })
+  // Directly inject various HTTP parameters into the system
+  public static async checkQrStatus(
+    @Body() body: LoginQrCheckRequest,
+    @Cookies() cookies: Record<string, string>,
+    @Headers() headers: Record<string, string>
+  ) {
+    const { unikey } = body
+
+    const answer = await createRequest({
+      url: '/login/qrcode/client/login',
+      data: {
+        key: unikey,
+        type: 3
+      },
+      cookies,
+      headers
+    })
+    
+    // Returns a 200 OK with data and custom headers
+    return Ok(answer.data as LoginQrCheckResponse, {
+      'Set-Cookie': answer.cookies
+    })
+  }
+}
+```
+
+#### **Example 2: Request Relay and Flow Control**
+
+This example demonstrates how an HTTP request can flow between different `HttpSystems` using internal message types.
+
+```ts
+// Internal message types used for request flow/relay
+class DataFromLocalMessage extends HttpRequestMessage {
+  constructor(
+    requestId: RequestId,
+    public songId: number
+  ) {
+    super(requestId)
+  }
+}
+
+class DataFromCacheMessage extends HttpRequestMessage {
+  constructor(
+    requestId: RequestId,
+    public cachePath: string
+  ) {
+    super(requestId)
+  }
+}
+
+// Route Registration
+@HttpRoute({
+  path: '/cache/songs/data',
+  method: 'get'
+})
+class CacheSongDataRequestMessage extends HttpRequestMessage {}
+
+export class CacheSongDataSystem {
+  @HttpSystem()
+  public static async songData(
+    @Message(CacheSongDataRequestMessage) message: CacheSongDataRequestMessage,
+    @Query('id') id: number,
+    @Query('md5') md5: string,
+    @Query('source') source: 'net' | 'local',
+    @Headers() headers: Record<string, string>,
+  ) {
+    const requestId = message.requestId
+    
+    // Relay the request to local logic by returning a new Message
+    if (source === 'local') return new DataFromLocalMessage(requestId, id)
+    
+    // Relay to cache logic if a local path exists
+    if (localPath) return new DataFromCacheMessage(requestId, localPath)
+
+    // Otherwise, return a web stream directly
+    return Stream(webStream)
+  }
+
+  @HttpSystem()
+  public static async songDataFromLocal(
+    @Message(DataFromLocalMessage) _message: DataFromLocalMessage,
+    dbComponent: DatabaseComponent
+  ) {
+    // Read file from local storage and return as a file stream
+    return StreamFile(absolutePath, {
+      dotfiles: 'allow'
+    })
+  }
+
+  @HttpSystem()
+  public static async songDataFromCache(
+    @Message(DataFromCacheMessage) message: DataFromCacheMessage,
+    @Query('id') id: number,
+    @Query('md5') md5: string,
+    dbComponent: DatabaseComponent
+  ) {
+    // Read from cache file and return as a file stream
+    return StreamFile(absolutePath, {
+      dotfiles: 'allow'
+    })
+  }
+```
+
+### **@Body(), @Query(), and Parameter Decorators**
+
+- **Function:** Automatically extracts various information from the incoming request and injects it as arguments into the `HttpSystem` method. This behavior is similar to NestJS decorators.
+- **Example:**
+
+```ts
+export class LoginQrCheckSystem {
+  @HttpSystem({
+    messageClass: LoginQrCheckRequestMessage
+  })
+  // You can directly inject various HTTP parameters into the system
+  public static async checkQrStatus(
+    @Body() body: LoginQrCheckBody,
+    @Cookies() cookies: Record<string, string>,
+    @Headers() headers: Record<string, string>,
+    @Query() id: number,
+    @Params() params: LoginQrCheckParams,
+    @Req() req: Request,
+    @Res() res: Response, 
+    @Ctx() ctx: HttpContext,
+  ) {
+    // ....
+    return Ok();
+  }
+}
+```
+
+------
+
+### **Pipes**
+
+- **Function:** `@virid/express` supports lightweight pipe processing and automatic type conversion. It also allows for custom transformation logic for specific types.
+- **Logic:** When using `@Query()`, `@virid/express` performs automatic type casting. For instance, `@Query() id: number` will automatically be converted to a `number` type. You can also register custom pipes for your own specific types.
+- **Example:**
+
+```ts
+import { addAutoPipe } from '@virid/express';
+
+// Register a global transformation for YourType
+addAutoPipe(YourType, (data: any) => { 
+    // Perform transformation logic here
+    return newData; 
+});
+```
+
+------
+
+### 🛜 **Other Response Types**
+
+The following factory functions can be used within a System to return standardized HTTP responses:
+
+- **`Ok(data, headers)`**: `200 OK`.
+- **`Created(data, headers)`**: `201 Created`.
+- **`NoContent()`**: `204 No Content`.
+- **`BadRequest(msg)`**: `400 Bad Request`.
+- **`Unauthorized(msg)`**: `401 Unauthorized`.
+- **`Forbidden(msg)`**: `403 Forbidden`.
+- **`NotFound(msg)`**: `404 Not Found`.
+- **`InternalServerError(msg)`**: `500 Internal Server Error`.
+- **`CustomResponse(status, data, headers)`**: Returns a response with a custom status code.
+- **`StreamFile(path, options)`**: Sends a local file, automatically handling **Range** requests and **206 Partial Content**.
+- **`Stream(stream, options)`**: Sends a raw `Readable` stream response.
+
+#### **Error Handling**
+
+The `HttpError` class can be thrown within a system to trigger a specific HTTP status response automatically:
+
+TypeScript
+
+```
+export class HttpError extends Error {
+  constructor(
+    public readonly status: number,
+    public readonly message: string,
+  ) {
+    super(message);
+  }
+}
+```

package/README.zh.md

@@ -1 +1,270 @@
-todo
+#  @virid/express
+
+`@virid/express` 是 ` express` 的适配器，负责来自`http`请求的消息转换为`virid`中的`HttpRequestMessage`。并且提供了一组类似`Nestjs`的依赖注入功能。使得处理`http`请求可以像处理本地`Message`一样简单。
+
+## 🌟 核心设计理念
+
+在 `@virid/express` 中，`express`仅充当普通的io层，负责将`http`请求转换为对应的`Message`并投递进入`virid`调度中。`@virid/express`还提供了一组类`Nestjs`的装饰器，使得`http`请求体的`body`、`query`等也可以被注入到`system`中。
+
+- **http请求转Message**：所有的`http`请求将被实例化为特定的`Message`并投递进入调度器。使用装饰器实现`Message`声明即API定义。
+- **语义返回值**：可以使用`Ok()`、`NotFound()`、`StreamFile()`等工厂函数从`System`中返回，即可自动转化为相应的`HttpCode`响应并结束`http`请求，或者返回一个新的`HttpRequestMessage`实现请求的内部转发。
+- **生命周期计数**：为了支持消息的内部转发与重定向，`@virid/express`为每个`http`请求实现了引用计数的生命周期跟踪功能。当所有的`System`执行完成后如果`http`请求还未响应，`@virid/express`将自动关闭连接并抛出错误，防止请求挂起。
+
+## 🔌启用插件
+
+```ts
+import { createVirid } from '@virid/core'
+import { ExpressPlugin } from '@virid/express'
+import express from 'express'
+
+const server = express()
+const virid = createVirid()
+  .use(ExpressPlugin, { server: server })
+```
+
+## 🛠️ @virid/express 核心 API 概览
+
+### HttpContext
+
+- **功能**：`@virid/express`将会每一个`http`请求维护一个`HttpContext`，包含一些重要信息，每当对应的`System`执行完，`rc`将会自动-1,当`rc`减为0时若`http`请求还未响应，`@virid/express`将自动关闭连接并打印错误信息。
+- **逻辑**：你可以使用`@Ctx()`装饰器在System中以获得当前请求的`HttpContext`
+- **示例：**
+
+```ts
+export class HttpContext {
+  public rc: number = 0;
+  public isClosed: boolean = false;
+
+  constructor(
+    public readonly id: number,
+    public readonly req: Request,
+    public readonly res: Response,
+    public readonly timestamp: number,
+    public readonly route: string,
+  ) {}
+}
+```
+
+### `HttpRequestMessage与@HttpRoute()`
+
+- **功能**：`HttpRequestMessage`是一种特殊的`Message`类型，每个http请求将被自动转变为一个`HttpRequestMessage`类型的消息。`HttpRoute`则标记了当前`HttpRequestMessage`的路由元信息，包含`path`与`method`等。
+- **逻辑**：`HttpRoute`与`HttpRequestMessage`是成对使用的，`HttpRoute`只能在`HttpRequestMessage`上使用。每个`HttpRequestMessage`将自带一个`RequestId`类型的Id，用以作为当前请求的唯一标记。
+- **示例：**
+
+```ts
+import { HttpRoute, HttpRequestMessage } from '@virid/express'
+@HttpRoute({
+  path: '/api/login/qr/check',
+  method: 'post'
+})
+export class LoginQrCheckRequestMessage extends HttpRequestMessage {}
+```
+
+### `@HttpSystem（）`
+
+- **功能**：`@HttpSystem()`与`@virid/core`中的`@System()`不同。`@HttpSystem()`只能被`HttpRequestMessage`类型的小消息触发，且支持`@Body`、`@Query`等装饰器。
+- **逻辑**：`@HttpSystem()`类型的System中抛出错误后，将自动转换为`InternalServerError()`。且`@HttpSystem()`支持直接返回`OK()`、`NotFound()`等等直接来设置响应头和`HttpCode`，也支持返回新的`HttpRequestMessage`来实现请求接力。
+- **示例：**
+
+```ts
+import { Body, Cookies, Headers, HttpSystem, Ok } from '@virid/express'
+
+export class LoginQrCheckSystem {
+  @HttpSystem({
+    messageClass: LoginQrCheckRequestMessage
+  })
+  // 可以直接在system中注入各种http参数
+  public static async checkQrStatus(
+    @Body() body: LoginQrCheckRequest,
+    @Cookies() cookies: Record<string, string>,
+    @Headers() headers: Record<string, string>
+  ) {
+    const { unikey } = body
+
+    const answer = await createRequest({
+      url: '/login/qrcode/client/login',
+      data: {
+        key: unikey,
+        type: 3
+      },
+      cookies,
+      headers
+    })
+    return Ok(answer.data as LoginQrCheckResponse, {
+      'Set-Cookie': answer.cookies
+    })
+  }
+}
+
+```
+
+```ts
+// 这个示例展示了http请求如何在不同的HttpSystem之间流转
+// 内部的两个用于流转的消息类型
+class DataFromLocalMessage extends HttpRequestMessage {
+  constructor(
+    requestId: RequestId,
+    public songId: number
+  ) {
+    super(requestId)
+  }
+}
+class DataFromCacheMessage extends HttpRequestMessage {
+  constructor(
+    requestId: RequestId,
+    public cachePath: string
+  ) {
+    super(requestId)
+  }
+}
+// 注册路由
+@HttpRoute({
+  path: '/cache/songs/data',
+  method: 'get'
+})
+class CacheSongDataRequestMessage extends HttpRequestMessage {}
+
+export class CacheSongDataSystem {
+  @HttpSystem()
+  public static async songData(
+    @Message(CacheSongDataRequestMessage) message: CacheSongDataRequestMessage,
+    @Query('id') id: number,
+    @Query('md5') md5: string,
+    @Query('source') source: 'net' | 'local',
+    @Headers() headers: Record<string, string>,
+  ) {
+    // 如果是本地歌曲的url，转发http请求
+    const requestId = message.requestId
+    if (source == 'local') return new DataFromLocalMessage(requestId, id)
+    // ...
+   	//  如果有缓存，走缓存
+    if (localPath) return new DataFromCacheMessage(requestId, localPath)
+	// ....
+    // 返回流对象
+    return Stream(webStream)
+  }
+
+  @HttpSystem()
+  public static async songDataFromLocal(
+    @Message(DataFromLocalMessage) _message: DataFromLocalMessage,
+    dbComponent: DatabaseComponent
+  ) {
+    // ...
+    // 从本地读取文件并返回
+    return StreamFile(absolutePath, {
+      dotfiles: 'allow'
+    })
+  }
+
+  @HttpSystem()
+  public static async songDataFromCache(
+    @Message(DataFromCacheMessage) message: DataFromCacheMessage,
+    @Query('id') id: number,
+    @Query('md5') md5: string,
+    dbComponent: DatabaseComponent
+  ) {
+   	// ....
+    // 从缓存文件中读取并返回
+    return StreamFile(absolutePath, {
+      dotfiles: 'allow'
+    })
+  }
+}
+```
+
+### `@Body（）/@Query等`
+
+- **功能**：自动将请求的各种信息提取并作为`HttpSystem`的参数注入，与`Nestjs`的装饰器相似。
+- **逻辑**：
+- **示例：**
+
+```ts
+export class LoginQrCheckSystem {
+  @HttpSystem({
+    messageClass: LoginQrCheckRequestMessage
+  })
+  // 可以直接在system中注入各种http参数
+  public static async checkQrStatus(
+    @Body() body: LoginQrCheckBody,
+    @Cookies() cookies: Record<string, string>,
+    @Headers() headers: Record<string, string>,
+    @Query() id:number,
+    @Params() id:LoginQrCheckParams,
+    @Req() req:Request,
+    @Res() res:Response, 
+    @Ctx() ctx: HttpContext,
+  ) {
+   	//....
+    return Ok()
+  }
+}
+```
+
+### Pipe
+
+- **功能**：`@virid/express`支持简单的pipe处理和自动转换，也支持自定义使用特定类型的pipe转换注册。
+- **逻辑**：在使用`@Query()`时，`@virid/express`支持一些自动的转换，例如 `@Query() id:number`将自动转换为number类型，或者也可以为自己的类型设置相应的`pipe`转换。
+- **示例**:
+
+```ts
+import { addAutoPipe } from '@virid/express'
+addAutoPipe(YourType,(data:YourType)=>{return newData})
+```
+
+## 🛜其他响应类型
+
+```ts
+
+/** 200 OK */
+export const Ok = (data: any, headers: HttpHeaders = {}) =>
+  new OkResponse(data, headers);
+
+/** 201 Created */
+export const Created = (data: any, headers: HttpHeaders = {}) =>
+  new CreatedResponse(data, headers);
+
+/** 204 No Content */
+export const NoContent = () => new NoContentResponse();
+
+/** 400 Bad Request */
+export const BadRequest = (msg = "Bad Request") => new BadRequestResponse(msg);
+
+/** 401 Unauthorized */
+export const Unauthorized = (msg = "Unauthorized") =>
+  new UnauthorizedResponse(msg);
+
+/** 403 Forbidden */
+export const Forbidden = (msg = "Forbidden") => new ForbiddenResponse(msg);
+
+/** 404 Not Found */
+export const NotFound = (msg = "Not Found") => new NotFoundResponse(msg);
+
+/** 500 Internal Error */
+export const InternalServerError = (msg = "Internal Server Error") =>
+  new InternalServerErrorResponse(msg);
+
+export const CustomResponse = (
+  status: number,
+  data: any,
+  headers: HttpHeaders = {},
+) => new CustomResponseResponse(status, data, headers);
+
+/** 发送本地文件 (自动处理 Range/206) */
+export const StreamFile = (path: string, options?: StreamFileOptions) =>
+  new StreamFileResponse(path, options);
+/**
+ * 发送流响应
+ */
+export const Stream = (stream: Readable, options?: StreamResponse["options"]) =>
+  new StreamResponse(stream, options);
+
+export class HttpError extends Error {
+  constructor(
+    public readonly status: number,
+    public readonly message: string,
+  ) {
+    super(message);
+  }
+}
+```
+

package/dist/index.cjs

@@ -1,5 +1,5 @@
 /**
- *  @virid/express v0.0.1
+ *  @virid/express v0.1.1
  *  Add express functionality to virid
  */
 var Y=Object.defineProperty;var At=Object.getOwnPropertyDescriptor;var Ct=Object.getOwnPropertyNames;var Rt=Object.prototype.hasOwnProperty;var $t=(r,e,t)=>e in r?Y(r,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):r[e]=t;var i=(r,e)=>Y(r,"name",{value:e,configurable:!0});var kt=(r,e)=>{for(var t in e)Y(r,t,{get:e[t],enumerable:!0})},Tt=(r,e,t,s)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of Ct(e))!Rt.call(r,n)&&n!==t&&Y(r,n,{get:()=>e[n],enumerable:!(s=At(e,n))||s.enumerable});return r};var Ht=r=>Tt(Y({},"__esModule",{value:!0}),r);var y=(r,e,t)=>$t(r,typeof e!="symbol"?e+"":e,t);var br={};kt(br,{BadRequest:()=>It,BadRequestResponse:()=>ae,Body:()=>hr,ConflictResponse:()=>Se,Cookies:()=>gr,Created:()=>Vt,CreatedResponse:()=>ne,Ctx:()=>xr,CustomResponse:()=>qt,CustomResponseResponse:()=>ue,ExpressPlugin:()=>Sr,Forbidden:()=>Bt,ForbiddenResponse:()=>ce,Headers:()=>fr,HttpContext:()=>K,HttpError:()=>C,HttpRequestMessage:()=>te,HttpResponse:()=>M,HttpRoute:()=>ur,HttpSystem:()=>pr,InternalServerError:()=>pe,InternalServerErrorResponse:()=>de,NoContent:()=>Pt,NoContentResponse:()=>ie,NotFound:()=>Nt,NotFoundResponse:()=>le,Ok:()=>Ot,OkResponse:()=>se,Params:()=>Er,ParseBoolPipe:()=>mt,ParseIntPipe:()=>gt,Query:()=>Mr,Req:()=>mr,Res:()=>yr,Stream:()=>jt,StreamFile:()=>_t,StreamFileResponse:()=>H,StreamResponse:()=>O,Unauthorized:()=>Dt,UnauthorizedResponse:()=>oe,UnprocessableEntityResponse:()=>be,addAutoPipe:()=>lr,getAutoPipe:()=>ye,parseRawCookie:()=>Ue});module.exports=Ht(br);var Et=require("@virid/core");var Me=require("@virid/core");var $=require("@virid/core");var Ge=require("@virid/core");var Ae=class Ae{constructor(e,t,s,n,o){y(this,"id");y(this,"req");y(this,"res");y(this,"timestamp");y(this,"route");y(this,"rc",0);y(this,"isClosed",!1);this.id=e,this.req=t,this.res=s,this.timestamp=n,this.route=o}inc(){this.rc++}dec(){this.rc--,this.rc===0&&this.tryFinalize()}tryFinalize(){if(this.res.writableEnded||this.isClosed)return;this.isClosed=!0;let e=`[Virid Express] Request Orphaned: The connection was closed because all systems finished execution without sending a response. 

package/dist/index.js

@@ -1,5 +1,5 @@
 /**
- *  @virid/express v0.0.1
+ *  @virid/express v0.1.1
  *  Add express functionality to virid
  */
 var Qe=Object.defineProperty;var xt=(r,e,t)=>e in r?Qe(r,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):r[e]=t;var n=(r,e)=>Qe(r,"name",{value:e,configurable:!0});var y=(r,e,t)=>xt(r,typeof e!="symbol"?e+"":e,t);import{MessageWriter as zt}from"@virid/core";import{MessageRegistry as Ut,MessageWriter as Lt}from"@virid/core";import{BaseMessage as Et,MessageWriter as ee}from"@virid/core";import{MessageWriter as Mt}from"@virid/core";var Ee=class Ee{constructor(e,t,s,i,o){y(this,"id");y(this,"req");y(this,"res");y(this,"timestamp");y(this,"route");y(this,"rc",0);y(this,"isClosed",!1);this.id=e,this.req=t,this.res=s,this.timestamp=i,this.route=o}inc(){this.rc++}dec(){this.rc--,this.rc===0&&this.tryFinalize()}tryFinalize(){if(this.res.writableEnded||this.isClosed)return;this.isClosed=!0;let e=`[Virid Express] Request Orphaned: The connection was closed because all systems finished execution without sending a response. 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@virid/express",
   "type": "module",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Add express functionality to virid",
   "author": "Ailrid",
   "license": "Apache 2.0",
@@ -12,7 +12,7 @@
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/ArisuYuki/virid.git"
+    "url": "git+https://github.com/Ailrid/virid.git"
   },
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -35,7 +35,7 @@
   "peerDependencies": {
     "express": "^4.17.1 || ^5.0.0",
     "@types/express": "^5.0.6",
-    "@virid/core": "0.1.0"
+    "@virid/core": "0.1.2"
   },
   "scripts": {
     "build": "tsup --config tsup.config.ts",