mirakurun 4.0.0-beta.9 → 4.1.1

package/CHANGELOG.md

@@ -2,10 +2,179 @@
 
 see [Commit Logs](https://github.com/Chinachu/Mirakurun/commits/master) to check all.
 
-## 4.0.0-beta.9 (2025-03-16)
+## 4.1.1 (2026-06-15)
+
+動作環境やユースケースを鑑みて、このバージョンから、このプロジェクトは基本的に日本語を使用します。ドキュメントや UI 等も順次日本語となります。何卒ご了承下さい 🙏
+
+### Known Issues
+
+- **UI**
+  - Home: 旧 UI からの仮移植です。表示崩れや余白不足、局ロゴの見切れがあります。
+
+### Docker
+
+- 🆙 ベースイメージを `node:22.14.0-bookworm` → `node:24.16.0-bookworm` に更新
+
+### Server
+
+- 🆙 Node.js エンジン要件: `^18 || ^20 || ^22` → `^22 || ^24`
+- 👾 Config: allowPNA の型チェックを修正 (*bug*)
+
+### UI
+
+- ✨ Fluent UI から Blueprint へ UI ベースコンポーネントを変更し、UI を刷新
+- 🆕 ライトテーマ / ダークテーマ の切り替え
+- 🆕 EPG, 番組検索, 番組詳細表示
+
+## About 4.0.0
 
 **Important Notice**: Mirakurun 4.0.0 includes significant performance improvements, enhanced EPG processing, asynchronous file I/O operations, and new features. As announced in 3.9.0, the experimental Win32 support has been completely removed.
 
+## 4.0.0-beta.17 (2025-04-11)
+
+### Server Changes
+
+- **Service**:
+  - Fixed a bug in the loading services.
+
+## 4.0.0-beta.17 (2025-04-10)
+
+### Server Changes
+
+- **Server**:
+  - Allow access to the Web UI through the allowOrigins setting.
+- **Channel**:
+  - Fixed a bug in the readyFn of EPG gatherer job.
+- **Tuner**:
+  - Improved readyForJob logic for better tuner selection.
+  - Added logging for tuner selection process.
+- **TunerDevice**:
+  - Added channel type to command template replacement.
+
+## 4.0.0-beta.16 (2025-04-01)
+
+### Server Changes
+
+- **Job**:
+  - Jobs can now be rerun.
+  - Maximum number of runs can now be set.
+- **Config**:
+  - Added: `jobMaxRunning`, `jobMaxStandby` server configs.
+- **API**:
+  - Added: `rerunJob` operations.
+- **UI**:
+  - **JobsView**: Added support to rerun Job.
+  - **ServerConfigurator**: Added job settings.
+
+## 4.0.0-beta.15 (2025-03-30)
+
+Bugfix of `@4.0.0-beta.14`.
+
+## 4.0.0-beta.14 (2025-03-30)
+
+### Key Changes
+
+- **Job/Queue**: Improved background job mechanism for like EPG updates.
+  - **Users can now request EPG updates at any time.**
+  - Job execution schedules can now be set in a **cron-like format**.
+  - <u>Jobs are now executed in parallel</u> according to the number of CPU cores and resource availability.
+  - At the moment, the number of parallel executions is `Math.max(1, Math.floor(os.cpus().length / 2))`, but it will be made configurable in the ~~future~~. → `@4.0.0-beta.16`
+
+### Server Changes
+
+- **Config**:
+  - Added: `programGCJobSchedule`, `epgGatheringJobSchedule` server configs.
+  - Removed: `programGCInterval`, `epgGatheringInterval` server configs. (*breaking change*)
+  - Settings are not migrated. If you have customized, you must re-configure them in cron-like format, which can be changed from the Web UI.
+  - see: [Configuration](doc/Configuration.md) ([日本語](doc/Configuration.ja.md))
+- **API**:
+  - Added: `runJobSchedule`, `abortJob` operations.
+- **UI**:
+  - **JobsView**: added.
+  - **ServerConfigurator**: updated.
+
+## 4.0.0-beta.13 (2025-03-29)
+
+### Docker Changes
+
+- Added `DISABLE_PCSCD` environment variable to disable pcscd service.
+- Added `DISABLE_B25_TEST` environment variable to disable B25 test decoder installation.
+- Updated `docker-compose.yml` - For testing purposes, all devices can be accessed without setting "devices" by default.
+  - **The previous default setting required a restart of the container when the card reader's USB was unplugged and plugged in, but the new default setting restores it automatically.** please check the [docker-compose.yml](docker/docker-compose.yml).
+  - **以前のデフォルト設定では、カードリーダーの USB を抜き差しすると、コンテナの再起動が必要でしたが、今回のデフォルト設定では、自動的に復旧するようになりました。** 設定例は [docker-compose.yml](docker/docker-compose.yml) をご確認ください。
+
+## 4.0.0-beta.12 (2025-03-21)
+
+### Server Changes
+
+- **Server**:
+  - Wait the LISTEN until finishes loading the program and service db at startup.
+- **UI**:
+  - **TunersManager**: packet counter is now hidden when stream info is empty
+
+## 4.0.0-beta.11 (2025-03-20)
+
+### Key Changes
+
+- **Channel Configuration**: Added new `commandVars` property to replace and extend the previous tuner command options
+  - Supports any custom command variables (not limited to predefined keys)
+  - Added support for arguments containing whitespace using quotes
+  - Previous options (`satellite`, `space`, `freq`, `polarity`) are now soft-deprecated but still work - Automatically migrates existing configurations to the new format
+
+  ```yaml
+  # Tuner Device Item Configuration
+  - name: Example-Tuner
+    types:
+      - GR
+    ...
+    command: cmd <channel> --arg1 --arg2 <exampleArg1> <exampleArg2> "<exampleArg3>" -
+
+  # Channel Item Configuration
+  - name: Example-Ch
+    type: GR
+    channel: '123'
+    ...
+    commandVars: # new
+      exampleArg1: -arg0 -arg1=example
+      exampleArg2: -arg2 "whitespace is now supported using quote"
+      exampleArg3: white space
+      ...
+  ```
+  - This implementation is inspired by the [extra-args already implemented in mirakc](https://github.com/mirakc/mirakc/blob/1fbbd9875bcb2de9143e2dc73be8ac6d54ed0965/docs/config.md#channels), but in a different way. This is so that appropriate arguments can be defined even in an environment where different tuner commands are mixed.
+
+### Server Changes
+
+- **API**:
+  - Deprecated several channel configuration properties in favor of the new `commandVars` property
+- **Channel**:
+  - Improved handling of tuner command parameters with expanded configuration options
+  - Migrated from hardcoded parameters to flexible variable substitution
+- **TunerDevice**:
+  - Enhanced command string handling with support for quoted arguments containing whitespace
+  - Improved command template variable substitution
+- **UI**:
+  - **ChannelsConfigurator**: Significantly improved the channel configuration interface
+    - Added visual editor for command arguments with dynamic add/remove capability
+    - Removed column headers for cleaner interface
+    - Automatically migrates deprecated configuration properties to the new format
+
+## 4.0.0-beta.10 (2025-03-17)
+
+### Server Changes
+
+- **Server**:
+  - Added test mode support for unit/integration testing
+  - Added deinit method (not used yet)
+  - Improved server init with proper async handling
+- **API**:
+  - **getTuner**: Fixed 500 error on not found (*bug*)
+
+### Client Changes
+
+- **getDocs**: Added to get API spec docs
+
+## 4.0.0-beta.9 (2025-03-16)
+
 ### Server Changes
 
 - **UI**:

package/README.ja.md

@@ -0,0 +1,125 @@
+[![Mirakurun](https://gist.githubusercontent.com/kanreisa/0ab27d7771e97edce5a24cc81b9b8ce6/raw/8e08d3d91390794b139ed593e3a834a8b41f651c/logo-mirakurun_2025-03-29.svg)](https://github.com/Chinachu/Mirakurun)
+
+# Mirakurun
+
+"Air" (開発中アプリのコードネーム) のために設計された日本のデジタルテレビチューナー API サーバーです。
+
+[![npm version][npm-img]][npm-url]
+[![npm downloads][downloads-image]][downloads-url]
+[![Linux Build][azure-pipelines-img]][azure-pipelines-url]
+[![tip for next commit](https://tip4commit.com/projects/43158.svg)](https://tip4commit.com/github/Chinachu/Mirakurun)
+[![Backers on Open Collective](https://opencollective.com/Mirakurun/backers/badge.svg)](#backers)
+[![Sponsors on Open Collective](https://opencollective.com/Mirakurun/sponsors/badge.svg)](#sponsors)
+
+[**CHANGELOG**](CHANGELOG.md) | [**環境構築**](doc/Platforms.ja.md) | [**設定**](doc/Configuration.ja.md)
+
+[**English**](README.md) | [**日本語**](README.ja.md)
+
+## Docker
+
+[![dockeri.co](https://dockeri.co/image/chinachu/mirakurun)][docker-url]
+
+参照: 利用可能な[タグ一覧](https://hub.docker.com/r/chinachu/mirakurun/tags) (Docker Hub)
+
+## 特徴
+
+- HTTP RESTful API (Swagger / Open API 2.0)
+- 高度なチューナープロセス管理
+- 単一チューニングでの複数ストリーム配信
+- ストリーム優先度
+- MPEG-2 TS パーサー、フィルター
+- リアルタイム EPG パーサー
+- 様々なチューナーデバイスと混合環境に対応 (chardev, DVB / ISDB-T, ISDB-S, DVB-S2)
+- 自動チャンネルスキャン
+- Web UI
+- IPTV サーバー (M3U8 プレイリスト, XMLTV)
+
+#### 図: MPEG-2 TS ストリーム API の多様性
+
+![](https://gist.githubusercontent.com/kanreisa/0ab27d7771e97edce5a24cc81b9b8ce6/raw/7409e229648e00b55404f9e8342dccb58bbb4ac4/mirakurun-fig-api-variety2.svg)
+
+#### 図: ストリームフロー
+
+![](https://gist.githubusercontent.com/kanreisa/0ab27d7771e97edce5a24cc81b9b8ce6/raw/7409e229648e00b55404f9e8342dccb58bbb4ac4/mirakurun-fig-flow-stream2.svg)
+
+## 環境構築
+
+👉 [**環境構築**](doc/Platforms.ja.md)
+
+## 設定
+
+👉 [**設定**](doc/Configuration.ja.md)
+
+## Web UI
+
+```sh
+# 管理 UI
+http://_your_mirakurun_ip_:40772/
+
+# Swagger UI
+http://_your_mirakurun_ip_:40772/api/debug
+```
+
+## クライアント実装
+
+- [Rivarun](https://github.com/Chinachu/Rivarun)
+- [BonDriver_Mirakurun](https://github.com/Chinachu/BonDriver_Mirakurun)
+- Mirakurun クライアント ([組み込み](https://github.com/Chinachu/Mirakurun/blob/master/src/client.ts))
+  - "Air" (開発コードネーム)
+  - [Chinachu γ](https://github.com/Chinachu/Chinachu/wiki/Gamma-Installation-V2)
+  - [EPGStation](https://github.com/l3tnun/EPGStation)
+
+## 貢献
+
+- [CONTRIBUTING.md](CONTRIBUTING.md)
+
+## 寄付
+
+- [Tip4Commit](https://tip4commit.com/github/Chinachu/Mirakurun) (BTC) - すべてのコミッターへ分配されます
+- [Open Collective](https://opencollective.com/Mirakurun) (USD) - プール (使途未定)
+
+## Discord コミュニティ
+
+- 招待リンク: https://discord.gg/X7KU5W9
+
+## Contributors
+
+このプロジェクトは貢献してくださるすべての方々のおかげで成り立っています。
+<a href="https://github.com/Chinachu/Mirakurun/graphs/contributors"><img src="https://opencollective.com/Mirakurun/contributors.svg?width=890&button=false" /></a>
+
+## Backers
+
+すべての Backer の皆様、ありがとうございます！ 🙏 [[Backer になる](https://opencollective.com/Mirakurun#backer)]
+
+<a href="https://opencollective.com/Mirakurun#backers" target="_blank"><img src="https://opencollective.com/Mirakurun/backers.svg?width=890"></a>
+
+## Sponsors
+
+スポンサーになってこのプロジェクトをサポートしてください。あなたのロゴがウェブサイトへのリンクとともにここに表示されます。 [[スポンサーになる](https://opencollective.com/Mirakurun#sponsor)]
+
+<a href="https://opencollective.com/Mirakurun/sponsor/0/website" target="_blank"><img src="https://opencollective.com/Mirakurun/sponsor/0/avatar.svg"></a>
+<a href="https://opencollective.com/Mirakurun/sponsor/1/website" target="_blank"><img src="https://opencollective.com/Mirakurun/sponsor/1/avatar.svg"></a>
+<a href="https://opencollective.com/Mirakurun/sponsor/2/website" target="_blank"><img src="https://opencollective.com/Mirakurun/sponsor/2/avatar.svg"></a>
+<a href="https://opencollective.com/Mirakurun/sponsor/3/website" target="_blank"><img src="https://opencollective.com/Mirakurun/sponsor/3/avatar.svg"></a>
+<a href="https://opencollective.com/Mirakurun/sponsor/4/website" target="_blank"><img src="https://opencollective.com/Mirakurun/sponsor/4/avatar.svg"></a>
+<a href="https://opencollective.com/Mirakurun/sponsor/5/website" target="_blank"><img src="https://opencollective.com/Mirakurun/sponsor/5/avatar.svg"></a>
+<a href="https://opencollective.com/Mirakurun/sponsor/6/website" target="_blank"><img src="https://opencollective.com/Mirakurun/sponsor/6/avatar.svg"></a>
+<a href="https://opencollective.com/Mirakurun/sponsor/7/website" target="_blank"><img src="https://opencollective.com/Mirakurun/sponsor/7/avatar.svg"></a>
+<a href="https://opencollective.com/Mirakurun/sponsor/8/website" target="_blank"><img src="https://opencollective.com/Mirakurun/sponsor/8/avatar.svg"></a>
+<a href="https://opencollective.com/Mirakurun/sponsor/9/website" target="_blank"><img src="https://opencollective.com/Mirakurun/sponsor/9/avatar.svg"></a>
+
+## 著作権 / ライセンス
+
+&copy; 2016- [kanreisa](https://github.com/kanreisa).
+
+- コード: [Apache License, Version 2.0](LICENSE)
+- ドキュメント: [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/)
+- ロゴ: [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/)
+
+[npm-img]: https://img.shields.io/npm/v/mirakurun.svg
+[npm-url]: https://npmjs.org/package/mirakurun
+[downloads-image]: https://img.shields.io/npm/dm/mirakurun.svg?style=flat
+[downloads-url]: https://npmjs.org/package/mirakurun
+[azure-pipelines-img]: https://dev.azure.com/chinachu/Mirakurun/_apis/build/status/Chinachu.Mirakurun?branchName=master
+[azure-pipelines-url]: https://dev.azure.com/chinachu/Mirakurun/_build/latest?definitionId=1&branchName=master
+[docker-url]: https://hub.docker.com/r/chinachu/mirakurun

package/README.md

@@ -1,8 +1,8 @@
-[![Mirakurun](https://gist.githubusercontent.com/kanreisa/0ab27d7771e97edce5a24cc81b9b8ce6/raw/e50683f1c4e7d1a13e9ef468f8cc945b0dbc853c/logo-mirakurun.svg)](https://github.com/Chinachu/Mirakurun)
+[![Mirakurun](https://gist.githubusercontent.com/kanreisa/0ab27d7771e97edce5a24cc81b9b8ce6/raw/8e08d3d91390794b139ed593e3a834a8b41f651c/logo-mirakurun_2025-03-29.svg)](https://github.com/Chinachu/Mirakurun)
 
 # Mirakurun
 
-DVR Tuner Server for Japanese TV which designed for the "Air" (in development codename).
+A Japanese digital TV tuner API server specifically designed for "Air" (code name of the app in development).
 
 [![npm version][npm-img]][npm-url]
 [![npm downloads][downloads-image]][downloads-url]
@@ -11,59 +11,44 @@ DVR Tuner Server for Japanese TV which designed for the "Air" (in development co
 [![Backers on Open Collective](https://opencollective.com/Mirakurun/backers/badge.svg)](#backers)
 [![Sponsors on Open Collective](https://opencollective.com/Mirakurun/sponsors/badge.svg)](#sponsors)
 
-## Docker
-
-[![dockeri.co](https://dockeri.co/image/chinachu/mirakurun)][docker-url]
+[**CHANGELOG**](CHANGELOG.md) | [**Setup Guide**](doc/Platforms.md) | [**Configuration**](doc/Configuration.md)
 
-see: available [Tags](https://hub.docker.com/r/chinachu/mirakurun/tags) (Docker Hub)
+[**English**](README.md) | [**日本語**](README.ja.md)
 
-### Quick Install
+## Docker
 
-```sh
-mkdir ~/mirakurun/
-cd ~/mirakurun/
-wget https://raw.githubusercontent.com/Chinachu/Mirakurun/refs/heads/release/4.0.0/docker/docker-compose.yml
-docker compose pull
-docker compose run --rm -e SETUP=true mirakurun
-docker compose up -d
-```
+[![dockeri.co](https://dockeri.co/image/chinachu/mirakurun)][docker-url]
 
-see: [doc/Platforms.md](doc/Platforms.md)
+Reference: List of available [tags](https://hub.docker.com/r/chinachu/mirakurun/tags) (Docker Hub)
 
 ## Features
 
-* RESTful API (Open API) - has designed like HTTP version of Spinel
-* Unix Sockets / TCP
-* Advanced Tuner Process Management
-* Priority Management
-* Tuner Device Pooling
-* Integrated MPEG-2 TS Parser, Filter
-* Realtime EPG Parser
-* Supports most Tuner Devices (chardev, DVB / ISDB-T, ISDB-S, DVB-S2)
-* Channel Scan
-* IPv6 Support
-* [Multiplexing Mirakuruns](doc/Mirakuruns.md)
-* Web UI
-* IPTV Server (M3U8 Playlist, XMLTV)
+- HTTP RESTful API (Swagger / Open API 2.0)
+- Advanced tuner process management
+- Multiple stream broadcasting from a single tuning
+- Stream priority
+- MPEG-2 TS parser, filter
+- Real-time EPG parser
+- Support for various tuner devices and hybrid environments (chardev, DVB / ISDB-T, ISDB-S, DVB-S2)
+- Automatic channel scanning
+- Web UI
+- IPTV server (M3U8 playlist, XMLTV)
 
 #### Figure: Variety of the MPEG-2 TS Stream API
 
-![](https://gist.githubusercontent.com/kanreisa/0ab27d7771e97edce5a24cc81b9b8ce6/raw/e50683f1c4e7d1a13e9ef468f8cc945b0dbc853c/mirakurun-fig-api-variety.svg)
+![](https://gist.githubusercontent.com/kanreisa/0ab27d7771e97edce5a24cc81b9b8ce6/raw/7409e229648e00b55404f9e8342dccb58bbb4ac4/mirakurun-fig-api-variety2.svg)
 
 #### Figure: Stream Flow
 
-![](https://gist.githubusercontent.com/kanreisa/0ab27d7771e97edce5a24cc81b9b8ce6/raw/e50683f1c4e7d1a13e9ef468f8cc945b0dbc853c/mirakurun-fig-flow-stream.svg)
-
-## Requirements / Supported Platforms
+![](https://gist.githubusercontent.com/kanreisa/0ab27d7771e97edce5a24cc81b9b8ce6/raw/7409e229648e00b55404f9e8342dccb58bbb4ac4/mirakurun-fig-flow-stream2.svg)
 
-* [Node.js](http://nodejs.org/) 18, 20, 22
-* Linux w/ [Docker](https://hub.docker.com/r/chinachu/mirakurun)
+## Setup Guide
 
-see: [doc/Platforms.md](doc/Platforms.md)
+👉 [**Setup Guide**](doc/Platforms.md)
 
-## **Install / Update / Uninstall / CLI**
+## Configuration
 
-see: [doc/Platforms.md](doc/Platforms.md)
+👉 [**Configuration**](doc/Configuration.md)
 
 ## Web UI
 
@@ -75,28 +60,27 @@ http://_your_mirakurun_ip_:40772/
 http://_your_mirakurun_ip_:40772/api/debug
 ```
 
-
 ## Client Implementations
 
-* [Rivarun](https://github.com/Chinachu/Rivarun)
-* [BonDriver_Mirakurun](https://github.com/Chinachu/BonDriver_Mirakurun)
-* Mirakurun Client ([Built-in](https://github.com/Chinachu/Mirakurun/blob/master/src/client.ts))
-  * "Air" (in development codename)
-  * [Chinachu γ](https://github.com/Chinachu/Chinachu/wiki/Gamma-Installation-V2)
-  * [EPGStation](https://github.com/l3tnun/EPGStation)
+- [Rivarun](https://github.com/Chinachu/Rivarun)
+- [BonDriver_Mirakurun](https://github.com/Chinachu/BonDriver_Mirakurun)
+- Mirakurun Client ([Built-in](https://github.com/Chinachu/Mirakurun/blob/master/src/client.ts))
+  - "Air" (in development codename)
+  - [Chinachu γ](https://github.com/Chinachu/Chinachu/wiki/Gamma-Installation-V2)
+  - [EPGStation](https://github.com/l3tnun/EPGStation)
 
 ## Contributing
 
-[CONTRIBUTING.md](CONTRIBUTING.md)
+- [CONTRIBUTING.md](CONTRIBUTING.md)
 
-## Supporting
+## Donations
 
-* [Tip4Commit](https://tip4commit.com/github/Chinachu/Mirakurun) (BTC) - to Every Committers
-* [Open Collective](https://opencollective.com/Mirakurun) (USD) - Pool (TBD)
+- [Tip4Commit](https://tip4commit.com/github/Chinachu/Mirakurun) (BTC) - Distributed to all committers
+- [Open Collective](https://opencollective.com/Mirakurun) (USD) - Pool (purpose undecided)
 
 ## Discord Community
 
-* Invitation: https://discord.gg/X7KU5W9
+- Invitation: https://discord.gg/X7KU5W9
 
 ## Contributors
 
@@ -128,11 +112,9 @@ Support this project by becoming a sponsor. Your logo will show up here with a l
 
 © 2016- [kanreisa](https://github.com/kanreisa).
 
-* Code: [Apache License, Version 2.0](LICENSE)
-* Docs: [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/)
-* Logo: [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/)
-
-**Commercial License / Support** is provided by [Pixely LLC](https://pixely.jp/).
+- Code: [Apache License, Version 2.0](LICENSE)
+- Docs: [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/)
+- Logo: [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/)
 
 [npm-img]: https://img.shields.io/npm/v/mirakurun.svg
 [npm-url]: https://npmjs.org/package/mirakurun

package/api.d.ts

@@ -42,10 +42,6 @@ export interface Channel {
     type: ChannelType;
     channel: string;
     name?: string;
-    satellite?: string;
-    space?: number;
-    freq?: number;
-    polarity?: "H" | "V";
     services?: Service[];
 }
 
@@ -77,12 +73,7 @@ export interface Program {
     name?: string;
     description?: string;
     genres?: ProgramGenre[];
-    video?: {
-        type: ProgramVideoType;
-        resolution: ProgramVideoResolution;
-        streamContent: number;
-        componentType: number;
-    }
+    video?: ProgramVideo;
     audios?: ProgramAudio[];
 
     series?: ProgramSeries;
@@ -101,6 +92,13 @@ export interface ProgramGenre {
     un2: number;
 }
 
+export interface ProgramVideo {
+    type: ProgramVideoType;
+    resolution: ProgramVideoResolution;
+    streamContent: number;
+    componentType: number;
+}
+
 export type ProgramVideoType = "mpeg2" | "h.264" | "h.265";
 
 export type ProgramVideoResolution = (
@@ -220,14 +218,46 @@ export interface TunerProcess {
     pid: number;
 }
 
-export interface Event {
+export interface JobScheduleItem {
+    key: string;
+    schedule: string;
+    job: Pick<JobItem, "key" | "name">;
+}
+
+export interface JobItem {
+    key: string;
+    name: string;
+    id: string;
+    status: "queued" | "standby" | "running" | "finished";
+    retryCount: number;
+
+    isRerunnable?: boolean;
+    retryOnAbort?: boolean;
+    retryOnFail?: boolean;
+    retryMax?: number;
+    retryDelay?: number;
+
+    isAborting: boolean;
+    hasAborted?: boolean;
+    hasSkipped?: boolean;
+    hasFailed?: boolean;
+    error?: string;
+
+    createdAt: number;
+    updatedAt: number;
+    startedAt?: number;
+    finishedAt?: number;
+    duration?: number;
+}
+
+export interface Event<T = any> {
     resource: EventResource;
     type: EventType;
-    data: any;
+    data: T;
     time: UnixtimeMS;
 }
 
-export type EventResource = "program" | "service" | "tuner";
+export type EventResource = "program" | "service" | "tuner" | "job" | "job_schedule";
 
 export type EventType = "create" | "update" | "remove";
 
@@ -238,10 +268,12 @@ export interface ConfigServer {
     disableIPv6?: boolean;
     logLevel?: LogLevel;
     maxLogHistory?: number;
+    jobMaxRunning?: number;
+    jobMaxStandby?: number;
     maxBufferBytesBeforeReady?: number;
     eventEndTimeout?: number;
-    programGCInterval?: number;
-    epgGatheringInterval?: number;
+    programGCJobSchedule?: string;
+    epgGatheringJobSchedule?: string;
     epgRetrievalTime?: number;
     logoDataInterval?: number;
     disableEITParsing?: boolean;
@@ -292,15 +324,25 @@ export interface ConfigChannelsItem {
     type: ChannelType;
     /** passed to tuning command */
     channel: string;
-    satellite?: string;
     serviceId?: number;
-    space?: number;
-    freq?: number;
-    polarity?: "H" | "V";
+    /** TSMF (MPEG-TS Multi Frame) relative TS number config for CATV */
     tsmfRelTs?: number;
+    /**
+     * passed to tuning command variables.
+     * @example { "freq": 123456, "polarity": "H", "space": 6, "extra-args": "..." }
+     */
+    commandVars?: Record<string, string | number>;
     isDisabled?: boolean;
-    /** @deprecated */
+    /** @deprecated typo of "satellite". */
     readonly satelite?: string;
+    /** @deprecated from 4.0.0, use `commandVars` instead. */
+    readonly satellite?: string;
+    /** @deprecated from 4.0.0, use `commandVars` instead. */
+    readonly space?: number;
+    /** @deprecated from 4.0.0, use `commandVars` instead. */
+    readonly freq?: number;
+    /** @deprecated from 4.0.0, use `commandVars` instead. */
+    readonly polarity?: "H" | "V";
 }
 
 export interface ChannelScanStatus {