feat: Add log query API endpoint and enhance log filtering logic

api.yml

@@ -666,7 +666,6 @@ components:
       required: 
         - gid
         - token
-        - archiver_key
         - title
         - title_jpn
         - category
@@ -784,6 +783,70 @@ components:
           const: 2
         - title: Keep
           const: 3
+    LogEntry:
+      description: Log entry
+      type: object
+      required: [id, time, message, level, type]
+      properties:
+        id:
+          type: integer
+          format: int64
+          description: Log entry ID
+        time:
+          type: string
+          format: date-time
+          description: Time of the log entry
+          example: '2025-01-01T00:00:00.000Z'
+        message:
+          type: string
+          description: Log message
+        level:
+          $ref: "#/components/schemas/LogLevel"
+        type:
+          type: string
+          description: Log type
+        stack:
+          type: string
+          description: Stack trace
+    LogEntries:
+      description: Log entries
+      type: object
+      required: [datas]
+      properties:
+        datas:
+          type: array
+          description: Log entries
+          items:
+            $ref: "#/components/schemas/LogEntry"
+        count:
+          type: integer
+          format: int64
+          description: Total counts of log entries. Only available when pagination is requested.
+    LogEntriesApiResult:
+      description: Api response for queryLog
+      allOf:
+        - $ref: "#/components/schemas/ApiResponse"
+        - type: object
+          required: [data]
+          properties:
+            data:
+              $ref: "#/components/schemas/LogEntries"
+    LogLevel:
+      description: Log level
+      type: integer
+      oneOf:
+      - title: Trace
+        const: 1
+      - title: Debug
+        const: 2
+      - title: Log
+        const: 3
+      - title: Info
+        const: 4
+      - title: Warn
+        const: 5
+      - title: Error
+        const: 6
     SharedToken:
       description: Shared token
       type: object
@@ -2530,6 +2593,65 @@ paths:
             application/json:
               schema:
                 $ref: "#/components/schemas/ApiResponseTrue"
+  /log:
+    get:
+      operationId: queryLog
+      summary: Query log
+      parameters:
+        - name: page
+          in: query
+          schema:
+            type: integer
+          description: Page number
+        - name: limit
+          in: query
+          schema:
+            type: integer
+          description: Number of entries per page
+        - name: offset
+          in: query
+          schema:
+            type: integer
+          description: Offset for pagination
+        - name: type
+          in: query
+          schema:
+            type: string
+          description: Log type filter
+        - name: min_level
+          in: query
+          schema:
+            $ref: "#/components/schemas/LogLevel"
+          description: Minimum log level filter
+        - name: allowed_level
+          in: query
+          schema:
+            type: array
+            items:
+              type: integer
+          description: List of allowed log levels
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/LogEntriesApiResult"
+        "401":
+          description: Authorization information is missing or invalid
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ApiResponseError"
+              example: { "ok": false, "status": 401, "error": "Unauthorized" }
+        "403":
+          description: Permission denied
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ApiResponseError"
+              example:
+                { "ok": false, "status": 403, "error": "Permission denied." }
   /shared_token:
     delete: 
       operationId: deleteSharedToken

routes/api/log.ts

@@ -19,13 +19,16 @@ export const handler: Handlers = {
         const limit = await parse_int(params.get("limit"), 50);
         const offset = await parse_int(params.get("offset"), 0);
         const type = params.get("type");
-        const min_level = await parse_int(
+        let min_level = await parse_int(
             params.get("min_level"),
-            LogLevel.Log,
+            null,
         );
         const allowed_level = params.get("allowed_level")?.split(",").map((x) =>
             parseInt(x)
         ).filter((x) => !isNaN(x));
+        if (!allowed_level && min_level === null) {
+            min_level = LogLevel.Log;
+        }
         const datas = page === null
             ? base_logger.list(offset, limit, type, min_level, allowed_level)
             : base_logger.list_page(

utils/logger.ts

@@ -166,7 +166,11 @@ class BaseLogger {
             };
         });
     }
-    count(type?: string | null, min_level?: number, allowed_level?: number[]) {
+    count(
+        type?: string | null,
+        min_level?: number | null,
+        allowed_level?: number[],
+    ) {
         if (!this.db) return 0;
         const where = [];
         const args: QueryParameterSet = [];
@@ -246,7 +250,7 @@ class BaseLogger {
         offset: number = 0,
         limit: number = 50,
         type?: string | null,
-        min_level?: number,
+        min_level?: number | null,
         allowed_level?: number[],
     ) {
         if (!this.db) return [];
@@ -278,7 +282,7 @@ class BaseLogger {
         page: number = 0,
         page_size: number = 50,
         type?: string | null,
-        min_level?: number,
+        min_level?: number | null,
         allowed_level?: number[],
     ) {
         if (!this.db) return [];