mirror of
https://github.com/clusterio/clusterio.git
synced 2026-11-19 15:33:12 +09:00
Compare commits
131
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
464d588b5e | ||
|
|
0ddc1899fa | ||
|
|
4e1116ae2d | ||
|
|
3cf9f96233 | ||
|
|
c37fe0f438 | ||
|
|
8831b33c01 | ||
|
|
56124574fb | ||
|
|
9b416583f0 | ||
|
|
b885e37b5b | ||
|
|
7e7e763517 | ||
|
|
811c4f7127 | ||
|
|
f0fb471ea1 | ||
|
|
79c1a2dc99 | ||
|
|
a8ce8e7cc0 | ||
|
|
50687515fa | ||
|
|
6f81216e7c | ||
|
|
3423e0a30c | ||
|
|
8fbdb5dfab | ||
|
|
7625fd82e3 | ||
|
|
5dcc66034b | ||
|
|
a66b1af454 | ||
|
|
3adfcf0a29 | ||
|
|
9a4241e4cd | ||
|
|
8dcb2197d6 | ||
|
|
a168f7db5e | ||
|
|
283aba70df | ||
|
|
62abfa903b | ||
|
|
b7fec4c700 | ||
|
|
ec19d5456e | ||
|
|
e5d82dcfde | ||
|
|
a68bb9c0a8 | ||
|
|
2075814ed1 | ||
|
|
f07ee22969 | ||
|
|
a70490648f | ||
|
|
e3abf8ba33 | ||
|
|
46309ce5b8 | ||
|
|
f392b258f7 | ||
|
|
1afee2ede5 | ||
|
|
0b2fcdcec4 | ||
|
|
735faf4b2c | ||
|
|
d2775e4db9 | ||
|
|
b3fc278b2c | ||
|
|
5f85c0575e | ||
|
|
cf2b3db20d | ||
|
|
a9c6430531 | ||
|
|
8a580a66be | ||
|
|
8ae5e11021 | ||
|
|
fac04adc6f | ||
|
|
d8f1d8a3e2 | ||
|
|
abcbf3fddc | ||
|
|
e5a4d51c86 | ||
|
|
97e615fc21 | ||
|
|
e990134b70 | ||
|
|
c2af8a2377 | ||
|
|
c9609259db | ||
|
|
3cddd2b9f8 | ||
|
|
8879f8dd80 | ||
|
|
4aca5050b9 | ||
|
|
89919f7a89 | ||
|
|
e2da9ac03d | ||
|
|
e8d9eb6916 | ||
|
|
8865509011 | ||
|
|
bcda88710e | ||
|
|
d6b0e88dda | ||
|
|
1021e29c98 | ||
|
|
96082e32b7 | ||
|
|
f70b4f74b1 | ||
|
|
ebb93ada94 | ||
|
|
597d080d71 | ||
|
|
e4f90b3480 | ||
|
|
8c4d2db192 | ||
|
|
152eb7d454 | ||
|
|
8e5d581b9b | ||
|
|
99990c7a0d | ||
|
|
ffd61b961d | ||
|
|
dcf216ca09 | ||
|
|
6bf2bf51f2 | ||
|
|
44b0a8ff83 | ||
|
|
d3f8c993b1 | ||
|
|
535e43b527 | ||
|
|
2df67e32da | ||
|
|
6b85567bc6 | ||
|
|
2e25831b4d | ||
|
|
021af793fc | ||
|
|
7ba14f7433 | ||
|
|
40f5a6ab7c | ||
|
|
48c31b4825 | ||
|
|
520007c8d1 | ||
|
|
c2b6a6e1c0 | ||
|
|
f5255d6f76 | ||
|
|
7d6eac6558 | ||
|
|
6732397061 | ||
|
|
2020024b68 | ||
|
|
499e973db9 | ||
|
|
e3cfc090d3 | ||
|
|
38dcff2225 | ||
|
|
a1109b9354 | ||
|
|
2a57ddb02e | ||
|
|
847945cfdd | ||
|
|
58231cc02c | ||
|
|
ab88955111 | ||
|
|
fc5701f243 | ||
|
|
256b455315 | ||
|
|
2916dcc58c | ||
|
|
b9a2d6b7bd | ||
|
|
224a451bbd | ||
|
|
b222f6dcb1 | ||
|
|
9b0293501f | ||
|
|
2733f2e3c5 | ||
|
|
96bd5fb1c2 | ||
|
|
123148e277 | ||
|
|
d7edae99c5 | ||
|
|
de00a043c3 | ||
|
|
396e2c59c7 | ||
|
|
c3b2c846b7 | ||
|
|
be8bba8ff8 | ||
|
|
c81d2b61a6 | ||
|
|
534dc14221 | ||
|
|
51fe6c9519 | ||
|
|
e0161114e7 | ||
|
|
2872faab98 | ||
|
|
1d1e80fbf0 | ||
|
|
3d7c11a8b6 | ||
|
|
72264f0c53 | ||
|
|
d6d6c052aa | ||
|
|
901ce4e08e | ||
|
|
5fdc585212 | ||
|
|
0aa330561b | ||
|
|
fcf174376d | ||
|
|
0e68596fbd | ||
|
|
9bcbc1e7f3 |
No files matched your search
+17
-2
@@ -35,6 +35,7 @@ module.exports = {
|
|||||||
"rules": {
|
"rules": {
|
||||||
"prefer-arrow-callback": "off",
|
"prefer-arrow-callback": "off",
|
||||||
"no-invalid-this": "off",
|
"no-invalid-this": "off",
|
||||||
|
"valid-jsdoc": "off",
|
||||||
"node/no-unpublished-import": "off",
|
"node/no-unpublished-import": "off",
|
||||||
"node/no-unpublished-require": "off",
|
"node/no-unpublished-require": "off",
|
||||||
},
|
},
|
||||||
@@ -43,6 +44,7 @@ module.exports = {
|
|||||||
"files": [
|
"files": [
|
||||||
"packages/web_ui/src/**/*.ts?(x)",
|
"packages/web_ui/src/**/*.ts?(x)",
|
||||||
"packages/lib/browser.ts",
|
"packages/lib/browser.ts",
|
||||||
|
"packages/create/templates/*/web/**/*.{t,j}s?(x)",
|
||||||
"{packages,plugins}/*/web/**/*.ts?(x)",
|
"{packages,plugins}/*/web/**/*.ts?(x)",
|
||||||
],
|
],
|
||||||
"env": {
|
"env": {
|
||||||
@@ -93,6 +95,19 @@ module.exports = {
|
|||||||
"node/shebang": "off",
|
"node/shebang": "off",
|
||||||
},
|
},
|
||||||
},
|
},
|
||||||
|
{
|
||||||
|
"files": [
|
||||||
|
"packages/create/templates/**/*.{t,j}s?(x)",
|
||||||
|
],
|
||||||
|
"rules": {
|
||||||
|
"node/no-missing-require": "off",
|
||||||
|
"node/no-missing-import": "off",
|
||||||
|
"spaced-comment": "off",
|
||||||
|
"comma-spacing": "off",
|
||||||
|
"max-len": "off",
|
||||||
|
"indent": "off",
|
||||||
|
},
|
||||||
|
},
|
||||||
],
|
],
|
||||||
|
|
||||||
"rules": {
|
"rules": {
|
||||||
@@ -319,7 +334,7 @@ module.exports = {
|
|||||||
"semi-style": "off",
|
"semi-style": "off",
|
||||||
"sort-imports": "off",
|
"sort-imports": "off",
|
||||||
"sort-keys": "off",
|
"sort-keys": "off",
|
||||||
"sort-vars": "error",
|
"sort-vars": "off",
|
||||||
"space-before-blocks": "error",
|
"space-before-blocks": "error",
|
||||||
"space-before-function-paren": "off",
|
"space-before-function-paren": "off",
|
||||||
"space-in-parens": ["error", "never"],
|
"space-in-parens": ["error", "never"],
|
||||||
@@ -390,7 +405,7 @@ module.exports = {
|
|||||||
"node/process-exit-as-throw": "error",
|
"node/process-exit-as-throw": "error",
|
||||||
"node/shebang": ["error", {
|
"node/shebang": ["error", {
|
||||||
"convertPath": {
|
"convertPath": {
|
||||||
"*.ts": ["^(.+)\\.ts$", "dist/$1.js"],
|
"*.ts": ["^(.+)\\.ts$", "dist/node/$1.js"],
|
||||||
},
|
},
|
||||||
}],
|
}],
|
||||||
},
|
},
|
||||||
|
|||||||
+105
@@ -1,5 +1,110 @@
|
|||||||
# Changelog
|
# Changelog
|
||||||
|
|
||||||
|
<!-- Template for entries. Add sections that apply as changes are made.
|
||||||
|
## Version 2.0.0-alpha.xx
|
||||||
|
|
||||||
|
### Major Features
|
||||||
|
|
||||||
|
- Major additions and/or major improvements to managing clusters.
|
||||||
|
|
||||||
|
### Features
|
||||||
|
|
||||||
|
- New features added.
|
||||||
|
|
||||||
|
### Changes
|
||||||
|
|
||||||
|
- Bugfixes and small changes to existing behaviour.
|
||||||
|
|
||||||
|
### Breaking Changes
|
||||||
|
|
||||||
|
- Changes which break backwards compatibility with older hosts or plugins code.
|
||||||
|
|
||||||
|
Many thanks to the following for contributing to this release:
|
||||||
|
[@username](https://github.com/username)
|
||||||
|
-->
|
||||||
|
|
||||||
|
## Version 2.0.0-alpha.18
|
||||||
|
|
||||||
|
### Features
|
||||||
|
|
||||||
|
- Added logging of HTTP requests and errors on the controller [#556](https://github.com/clusterio/clusterio/pull/556).
|
||||||
|
- Added caching of data parsed from mods to speed up startup time [#606](https://github.com/clusterio/clusterio/pull/606).
|
||||||
|
- Added command to installer to generate the code for making a new plugin [#570](https://github.com/clusterio/clusterio/pull/570).
|
||||||
|
|
||||||
|
### Changes
|
||||||
|
|
||||||
|
- Fixed Inventory Sync reporting a negative database size [#598](https://github.com/clusterio/clusterio/pull/598).
|
||||||
|
- Fixed plugin events being invoked while a host connection was in an invalid state.
|
||||||
|
- Suppresed bogus warning about event listener leak in the browser's console [#600](https://github.com/clusterio/clusterio/pull/600).
|
||||||
|
- Fixed installer breaking on Windows after Node.js released a security fix [#614](https://github.com/clusterio/clusterio/pull/614).
|
||||||
|
- During a data export the mod settings in mod packs will now be corrected to the type of the settings prototype if the type is incorrect.
|
||||||
|
- Fixed missing color setting causing the Mod Pack view in the Web UI to show an error [#609](https://github.com/clusterio/clusterio/issues/609).
|
||||||
|
|
||||||
|
Many thanks to the following for contributing to this release:
|
||||||
|
[@Cooldude2606](https://github.com/Cooldude2606)
|
||||||
|
[@Danielv123](https://github.com/Danielv123)
|
||||||
|
[@Hornwitser](https://github.com/Hornwitser)
|
||||||
|
|
||||||
|
|
||||||
|
## Version 2.0.0-alpha.17
|
||||||
|
|
||||||
|
### Features
|
||||||
|
|
||||||
|
- Made the host an instance is assigned to link to the host page for that host in the Web UI [#587](https://github.com/clusterio/clusterio/pull/587).
|
||||||
|
- Added pagination to the saves list.
|
||||||
|
|
||||||
|
### Changes
|
||||||
|
|
||||||
|
- Fixed an unhandled error in Subspace Storage crashing the host.
|
||||||
|
- Fixed an unhandled rejection in disconnect logic crashing the host.
|
||||||
|
- Fixed instance screen in Web UI not updating when an instance was reassigned.
|
||||||
|
- Fixed an error thrown in the rendering of one page in the Web UI causing all pages to become inaccessible.
|
||||||
|
- Fixed Web UI not showing instance saves when the permission to list and subscribe the saves is granted but the user is not a cluster admin.
|
||||||
|
- Similarly fixed Web UI not showing the mod pack create, delete, list and host revoke token actions if the user is not a cluster admin.
|
||||||
|
- Fixed Research Sync applying progress of a previous techology level to the level on the controller when it's the active research during instance startup.
|
||||||
|
- Fixed data export with a mod using shorthand notation for the default value of a color-setting causing the ModPack data to be set to invalid data.
|
||||||
|
- Fixed per user per instance player stats not being deleted when the instance it's for is deleted.
|
||||||
|
- Fixed mods setting the item prototype icons property to an object mapping instead of an array breaking the data export.
|
||||||
|
- Fixed a bad mod in the host's mods folder causing instance start to fail instead of the host re-downloading the mod.
|
||||||
|
|
||||||
|
### Breaking Changes
|
||||||
|
|
||||||
|
- Renamed the permission `core.instance.save.list.subscribe` to `core.instance.save.subscribe`.
|
||||||
|
|
||||||
|
Many thanks to the following for contributing to this release:
|
||||||
|
[@Cooldude2606](https://github.com/Cooldude2606)
|
||||||
|
[@Danielv123](https://github.com/Danielv123)
|
||||||
|
[@Hornwitser](https://github.com/Hornwitser)
|
||||||
|
|
||||||
|
|
||||||
|
## Version 2.0.0-alpha.16
|
||||||
|
|
||||||
|
### Changes
|
||||||
|
|
||||||
|
- Fixed message sequences not being renumbered when forwarded between links causing reconnects to send duplicated messages.
|
||||||
|
|
||||||
|
|
||||||
|
## Version 2.0.0-alpha.15
|
||||||
|
|
||||||
|
### Features
|
||||||
|
|
||||||
|
- Added support for `color-settings` Mod settings [#568](https://github.com/clusterio/clusterio/issues/568).
|
||||||
|
- Added `clusterio_controller_pending_requests` and `clusterio_host_pending_requests` metrics.
|
||||||
|
|
||||||
|
### Changes
|
||||||
|
|
||||||
|
- Fixed generated systemd file for clusteriohost not enabling source maps.
|
||||||
|
- Fixed ctl not exporting types used for adding commands to ctl plugins.
|
||||||
|
- Fixed controller only plugins throwing an error about missing a config field on startup out when added to hosts.
|
||||||
|
- Fixed installer incorrectly claiming the options --factorio-dir and --no-download-headless conflicts with each other.
|
||||||
|
- Fixed a memory leak on every request sent over the WebSocket.
|
||||||
|
- Fixed assertion error on closing or invalidating a link with messages forwarded from a virtual link.
|
||||||
|
- Fixed host hanging if stopped while an instance is in the process of creating a save during startup.
|
||||||
|
- Fixed `instance.auto_start` option.
|
||||||
|
- Fixed host log spammed with errors when plugins broadcast messages to instances with the plugin disabled.
|
||||||
|
- Fixed properties of object config fields not being possible to remove.
|
||||||
|
|
||||||
|
|
||||||
## Version 2.0.0-alpha.14
|
## Version 2.0.0-alpha.14
|
||||||
|
|
||||||
This release does not retain backwards compatibility with 2.0.0-alpha.13 meaning all parts of the cluster needs to updated at the same time.
|
This release does not retain backwards compatibility with 2.0.0-alpha.13 meaning all parts of the cluster needs to updated at the same time.
|
||||||
|
|||||||
@@ -39,6 +39,7 @@ If you are starting a new cluster, it's highly recommended to use the 2.0 alpha.
|
|||||||
* [Running Clusterio](#running-clusterio)
|
* [Running Clusterio](#running-clusterio)
|
||||||
* [Setting up remote hosts](#setting-up-remote-hosts)
|
* [Setting up remote hosts](#setting-up-remote-hosts)
|
||||||
* [Setting up clusterioctl](#setting-up-clusterioctl)
|
* [Setting up clusterioctl](#setting-up-clusterioctl)
|
||||||
|
* [Known issues](#known-issues)
|
||||||
* [Common problems](#Common-problems)
|
* [Common problems](#Common-problems)
|
||||||
|
|
||||||
|
|
||||||
@@ -265,6 +266,24 @@ If you want to use a different user for the command line interface, you can gene
|
|||||||
npx clusteriocontroller bootstrap generate-user-token <username>
|
npx clusteriocontroller bootstrap generate-user-token <username>
|
||||||
|
|
||||||
|
|
||||||
|
## Known Issues
|
||||||
|
|
||||||
|
- When the `server_select` plugin is installed you may see `[error] Unhandled event server_select:UpdateInstancesEvent` logged when starting an instance.
|
||||||
|
This should be ignored as it does not indicate an error occured.
|
||||||
|
- After updating Factorio you may get the error `Error: Expected empty response but got "Cannot execute command. Error: [string "clusterio_private.update_instance(..."]:1: attempt to index global 'clusterio_private' (a nil value)?` on instance start.
|
||||||
|
This is due to Factorio applying a migration replacing the patched content of the save with the original scenario, attempting to start the instance again should resolve the issue.
|
||||||
|
- In the mod pack view of the web interface the "base" mod is displayed with an error complaining about the mod being missing from the controller storage.
|
||||||
|
This is due to the "base" mod currently not being connectly handled as a built-in mod to Factorio in the web interface, this error message should be ignored.
|
||||||
|
- After migrating from Alpha 13 to Alpha 14 running an instance data export fails with the error `Upload failed: 401 Unauthorized` due to the host token being issued to a slave.
|
||||||
|
To workaround this find the id of the host in the host config and generate a new host token with the same id.
|
||||||
|
Stop the host and replace the value of the `host.controller_token` field in `config-host.json` with the new host token before starting it up again.
|
||||||
|
- After migrating from Alpha 13 to Alpha 14 you get kicked out from the web interface due to the master to controller rename.
|
||||||
|
If you don't have the authentication token readily available you can manually migrate the token by opening the Inspect/Developer Tools on the page and running the following piece of JavaScript in the Console:
|
||||||
|
```
|
||||||
|
localStorage.controller_token = localStorage.master_token
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
## Common problems
|
## Common problems
|
||||||
|
|
||||||
### EACCESS [...] LISTEN 443
|
### EACCESS [...] LISTEN 443
|
||||||
|
|||||||
@@ -0,0 +1,6 @@
|
|||||||
|
coverage:
|
||||||
|
status:
|
||||||
|
project:
|
||||||
|
default:
|
||||||
|
if_ci_failed: success
|
||||||
|
informational: true
|
||||||
@@ -81,6 +81,9 @@ Note that to use `clusterioctl` you will have to create a control config first:
|
|||||||
|
|
||||||
Once you've set up the cluster you can use `node packages/controller run` to run the controller and `node packages/host run` to run the host which connects to the controller.
|
Once you've set up the cluster you can use `node packages/controller run` to run the controller and `node packages/host run` to run the host which connects to the controller.
|
||||||
|
|
||||||
|
When editing TypeScript files ran by Node.js you need to run `pnpm build` to compile the files to JavaScript before restarting the controller/host/ctl for changes take effect.
|
||||||
|
To have TypeScript watch for changes and rebuild immediadly you may run `pnpm watch` instead.
|
||||||
|
|
||||||
For web development on the controller there are also the following flags:
|
For web development on the controller there are also the following flags:
|
||||||
|
|
||||||
`--dev` - Recompile the `web_ui` package on the fly providing live reloading of it.
|
`--dev` - Recompile the `web_ui` package on the fly providing live reloading of it.
|
||||||
@@ -316,6 +319,6 @@ You will need commit access to the repository as well publish access to the @clu
|
|||||||
4. Publish the packages.
|
4. Publish the packages.
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
# Warning: Double check your current working directory is the repository before running this
|
rm -r ./{plugins,packages}/*/dist
|
||||||
pnpm -r --filter='!./external_plugins/**' publish
|
pnpm -r --filter='./{plugins,packages}/*' publish
|
||||||
```
|
```
|
||||||
@@ -78,7 +78,7 @@ import { BaseInstancePlugin } from "@clusterio/host";
|
|||||||
|
|
||||||
Previously the info of a plugin would be loaded by requiring `./plugin_dir/info`, this has been changed to require `./plugin_dir` which in turn means that `info.js` is no longer the default entrypoint.
|
Previously the info of a plugin would be loaded by requiring `./plugin_dir/info`, this has been changed to require `./plugin_dir` which in turn means that `info.js` is no longer the default entrypoint.
|
||||||
To solve this you can either add `"main": "info.js",` to package.json or rename `info.js` to `index.js` (the rest of this guide assumes the entrypoint was renamed to `index.js`).
|
To solve this you can either add `"main": "info.js",` to package.json or rename `info.js` to `index.js` (the rest of this guide assumes the entrypoint was renamed to `index.js`).
|
||||||
The motivation behind this change was to allow TypeScript to output its build to a sub-folder of the plugin, if you're using TypeScript you'll likely have the entrypoint be located in `dist/index.js` instead.
|
The motivation behind this change was to allow TypeScript to output its build to a sub-folder of the plugin, if you're using TypeScript you'll likely have the entrypoint be located in `dist/node/index.js` instead.
|
||||||
|
|
||||||
The expected place where the declaration of a plugin is exported has also changed from `module.exports` to `module.exports.plugin`:
|
The expected place where the declaration of a plugin is exported has also changed from `module.exports` to `module.exports.plugin`:
|
||||||
|
|
||||||
|
|||||||
@@ -17,6 +17,8 @@ Mod Pack strings looks something like this:
|
|||||||
|
|
||||||
If you have multiple mod configuration create a mod pack string for each and note them down.
|
If you have multiple mod configuration create a mod pack string for each and note them down.
|
||||||
|
|
||||||
|
Double check that you are on a supported version of Node.js by running `node --version`, the version should be v18 or later, if not you will need to update Node.js before continuing.
|
||||||
|
|
||||||
|
|
||||||
## Migrate installations
|
## Migrate installations
|
||||||
|
|
||||||
@@ -24,7 +26,7 @@ If you have multiple mod configuration create a mod pack string for each and not
|
|||||||
|
|
||||||
Shutdown all slaves and the master server and then migrate each installations by running the following command:
|
Shutdown all slaves and the master server and then migrate each installations by running the following command:
|
||||||
|
|
||||||
npm exec @clusterio/create --migrate-rename --log-level=verbose
|
npm exec @clusterio/create -y -- --migrate-rename --log-level=verbose
|
||||||
|
|
||||||
This will convert the existing installation's usage of the master and slave names in packages, configs, database and logs to the new controller and host terms and update the installed packages.
|
This will convert the existing installation's usage of the master and slave names in packages, configs, database and logs to the new controller and host terms and update the installed packages.
|
||||||
|
|
||||||
|
|||||||
+113
-138
@@ -12,8 +12,6 @@ The plugin classes have pre-defined hooks that are called during various stages
|
|||||||
- [Plugin Configuration](#plugin-configuration)
|
- [Plugin Configuration](#plugin-configuration)
|
||||||
- [Communicating with Factorio](#communicating-with-factorio)
|
- [Communicating with Factorio](#communicating-with-factorio)
|
||||||
- [Defining Link Messages](#defining-link-messages)
|
- [Defining Link Messages](#defining-link-messages)
|
||||||
- [Defining Events](#defining-events)
|
|
||||||
- [Defining Requests](#defining-requests)
|
|
||||||
- [Sending Link Messages](#sending-link-messages)
|
- [Sending Link Messages](#sending-link-messages)
|
||||||
- [Handling connection events](#handling-connection-events)
|
- [Handling connection events](#handling-connection-events)
|
||||||
- [Collecting Statistics](#collecting-statistics)
|
- [Collecting Statistics](#collecting-statistics)
|
||||||
@@ -41,6 +39,7 @@ The usual guides for creating such packages apply.
|
|||||||
At minimum the `package.json` file must contain a version entry.
|
At minimum the `package.json` file must contain a version entry.
|
||||||
|
|
||||||
A possible workflow for developing plugins is to place the plugin in a sub-directory of where clusterio has been installed, and rely on Node.js searching up the folder heirarchy for it to find `@clusterio/lib`.
|
A possible workflow for developing plugins is to place the plugin in a sub-directory of where clusterio has been installed, and rely on Node.js searching up the folder heirarchy for it to find `@clusterio/lib`.
|
||||||
|
After creating a directory for your plugin, the boilerplate can be generated automaticlly from a set of tempaltes using `npm exec @clusterio/create -y -- --plugin-template` after which you will be asked which areas your plugin will interact with and your plugin's name.
|
||||||
To add it to `plugin-list.json` so that it gets loaded use the `plugin add <path>` sub-command to either clusteriocontroller, clusteriohost or clusterioctl.
|
To add it to `plugin-list.json` so that it gets loaded use the `plugin add <path>` sub-command to either clusteriocontroller, clusteriohost or clusterioctl.
|
||||||
Note that it's important that the path starts with ./ or ../ (use .\ or ..\ on Windows).
|
Note that it's important that the path starts with ./ or ../ (use .\ or ..\ on Windows).
|
||||||
|
|
||||||
@@ -302,6 +301,20 @@ local clusterio_api = require("modules/clusterio/api")
|
|||||||
clusterio_api.send_json("my_plugin_foo", { data = 123 })
|
clusterio_api.send_json("my_plugin_foo", { data = 123 })
|
||||||
```
|
```
|
||||||
|
|
||||||
|
For convience a helper function is exposed on server specifically for handling IPC events.
|
||||||
|
|
||||||
|
```js
|
||||||
|
async init() {
|
||||||
|
this.instance.server.handle("my_plugin_foo", this.handleFoo.bind(this));
|
||||||
|
}
|
||||||
|
|
||||||
|
async handleFoo(content) {
|
||||||
|
// Do stuff with content
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**Note:** This only handles IPC events, all other events must use `on`. You should not include the `ipc-` prefix when using this method. Error logging is handled for you, if you want custom error handling use `on`.
|
||||||
|
|
||||||
It's recommended to either use the plugin name as the channel name or to prefix the channel name with the name of the plugin if you need multiple channels.
|
It's recommended to either use the plugin name as the channel name or to prefix the channel name with the name of the plugin if you need multiple channels.
|
||||||
It's also important to catch any errors that might occur as they will otherwise be propogated to the instance code and kill the server.
|
It's also important to catch any errors that might occur as they will otherwise be propogated to the instance code and kill the server.
|
||||||
|
|
||||||
@@ -325,175 +338,137 @@ Events are simple one-way notifications that invoke a handler on the target it's
|
|||||||
Requests are pairs of request and response messages where the request is sent to the target and the response is the reply back from the target.
|
Requests are pairs of request and response messages where the request is sent to the target and the response is the reply back from the target.
|
||||||
The requests are similar to HTTP requests, except both parties of a link may initiate one.
|
The requests are similar to HTTP requests, except both parties of a link may initiate one.
|
||||||
|
|
||||||
|
Messages are defined as items of the `plugin.messages` array exported by `index.js`.
|
||||||
### Defining Events
|
|
||||||
|
|
||||||
Events are defined as properties of the messages object exported on `plugin` that map to instances of the `Event` class from `lib/link`.
|
|
||||||
The name of the property correspond to the handler invoked on the plugin class.
|
|
||||||
The Event constructor takes an object of properties that define the event, for example the following could be defined in `plugin`:
|
|
||||||
|
|
||||||
```js
|
|
||||||
messages: {
|
|
||||||
startFrobnication: new lib.Event({
|
|
||||||
type: "foo_frobber:start_frobnication",
|
|
||||||
links: ["controller-host", "host-instance"],
|
|
||||||
forwardTo: "instance",
|
|
||||||
eventRequired: ["frobnication_type"],
|
|
||||||
eventProperties: {
|
|
||||||
"frobnication_type": { type: "string" },
|
|
||||||
"urgent": { type: "boolean" },
|
|
||||||
},
|
|
||||||
}),
|
|
||||||
},
|
|
||||||
```
|
|
||||||
|
|
||||||
This specifies an event that can be sent from the controller to a host, and from a host to an instance.
|
|
||||||
It also specifies that the event must contain the property `frobnication_type`, with a string value in the data payload and that it may optionally contain a boolean `urgent` property.
|
|
||||||
It will also be forwarded by hosts to a specific instance.
|
|
||||||
|
|
||||||
The following properties are recognized by the Event constructor:
|
|
||||||
|
|
||||||
#### type
|
|
||||||
|
|
||||||
The message type sent over the wire.
|
|
||||||
This must start with the name of the plugin followed by colon and and be unique for the plugin.
|
|
||||||
The type of the message sent over the socket will have the suffix `_event` appended to it.
|
|
||||||
|
|
||||||
#### links
|
|
||||||
|
|
||||||
An array of strings describing which links this event can be sent over.
|
|
||||||
Direction matters, `"controller-host"` means the event can be sent from the controller to the host, but can't be sent back the other way, unless `"host-controller"` is also present in the links array.
|
|
||||||
|
|
||||||
The available endpoints are `controller`, `host`, `instance`, and `control`.
|
|
||||||
Controller talks with host and control, and host talks to instance.
|
|
||||||
The full chain must be specified as the individual links in order for a message to travers multiple hops, (i.e., for a message to go from controller to instance it must have both `"controller-host"` and `"host-instance"` in the links array).
|
|
||||||
See `forwardTo` and `broadcastTo` for ways to forward an event to the next link in a chain.
|
|
||||||
|
|
||||||
#### forwardTo
|
|
||||||
|
|
||||||
Target to forward an event to.
|
|
||||||
Can either be `"controller"`, to indicate a host should forward it to the controller, or `"instance"`, to indicate it should be forwarded to the instances specified by the `instance_id` event property.
|
|
||||||
This works by using a default handler for the event at the links that forward it.
|
|
||||||
|
|
||||||
#### broadcastTo
|
|
||||||
|
|
||||||
Target to broadcast this message towards.
|
|
||||||
A value of "instance" means the event will be broadcast to all instances downstream of the target it's sent to, but not back from where it came from.
|
|
||||||
Currently, only "instance" is supported.
|
|
||||||
This means that sending the event to a host from an instance will cause it to be broadcast to all instances of that host except for the instance it came from.
|
|
||||||
|
|
||||||
#### eventRequired
|
|
||||||
|
|
||||||
By default all properties defined in `eventProperties` are required to be present in the payload for the event.
|
|
||||||
This can be overriden by specifying an array of properties which are required here.
|
|
||||||
This is equivalent to using the `required` keyword in JSON schema.
|
|
||||||
|
|
||||||
#### eventProperties
|
|
||||||
|
|
||||||
Object with properties mapping to a JSON schema of that property that specifies what's valid to send in the event.
|
|
||||||
This is equivalent to using the `properties` keyword in JSON schema, except that the properties specified are by default required and additional properties are not allowed.
|
|
||||||
See [this guide][guide] for an introduction to writing JSON schemas.
|
|
||||||
|
|
||||||
The forwardTo and broadcastTo can be combined such that specifying `"controller"` as the forwardTo value and `"instance"` as the broadcastTo value will cause the event to be broadcast to all instances in the cluster.
|
|
||||||
For this to work, you will need to specify `instance-host`, `host-controller`, `controller-host`, and `host-instance` as the links.
|
|
||||||
|
|
||||||
Keep in mind when forwarding events that if the target an event is being forwarded to is not online, the event will be dropped.
|
|
||||||
Use a request if you need a confirmation that the message was received.
|
|
||||||
|
|
||||||
### Definining Requests
|
|
||||||
|
|
||||||
Requests are defined as properties of the messages object exported by `plugin` that map to instances of the `Request` class from `lib/link`.
|
|
||||||
The name of the property corresponds to the handler invoked on the plugin class.
|
|
||||||
The Request constructor takes an object of properties that define the event.
|
|
||||||
For example, the following could be defined in `plugin`:
|
For example, the following could be defined in `plugin`:
|
||||||
|
|
||||||
```js
|
```js
|
||||||
messages: {
|
messages: [
|
||||||
reportFrobnication: new lib.Request({
|
class Frobnicate {
|
||||||
type: "foo_frobber:report_frobnication",
|
static plugin = "foo_frobber"; // Plugin name
|
||||||
links: ["controller-host", "host-instance"],
|
static type = "request";
|
||||||
forwardTo: "instance",
|
static src = "controller";
|
||||||
requestRequired: ["verbosity"],
|
static dst = "instance";
|
||||||
requestProperties: {
|
static jsonSchema = {
|
||||||
"verbosity": { type: "integer" },
|
type: "object",
|
||||||
"special": { type: "boolean" },
|
properties: {
|
||||||
},
|
"verbosity": { type: "integer" },
|
||||||
responseProperties: {
|
"special": { type: "boolean" },
|
||||||
"report": {
|
|
||||||
type: "array",
|
|
||||||
items: { type: "string" },
|
|
||||||
},
|
},
|
||||||
},
|
required: ["verbosity"],
|
||||||
}),
|
additionalProperties: false,
|
||||||
},
|
};
|
||||||
|
constructor(json) {
|
||||||
|
this.verbosity = json.verbosity;
|
||||||
|
this.special = json.special;
|
||||||
|
}
|
||||||
|
static fromJSON(json) {
|
||||||
|
return new Frobnicate(json);
|
||||||
|
}
|
||||||
|
toJSON() {
|
||||||
|
return {
|
||||||
|
verbosity: this.verbosity,
|
||||||
|
special: this.special,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
static Response = {
|
||||||
|
jsonSchema: {
|
||||||
|
type: "object",
|
||||||
|
properties: {
|
||||||
|
"report": {
|
||||||
|
type: "array",
|
||||||
|
items: { type: "string" },
|
||||||
|
},
|
||||||
|
},
|
||||||
|
},
|
||||||
|
fromJSON(json) {
|
||||||
|
return json
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
]
|
||||||
```
|
```
|
||||||
|
|
||||||
This specifies a request that can be sent from the controller to a host, and from a host to an instance.
|
This specifies a request that can be sent from the controller to an instance, being routed through the correct host behind the scenes.
|
||||||
The request data must contain the property `verbosity` with an integer number as the value, as well as the `instance_id` property (implied by `forwardTo: "instance"`) and it may also contain a boolean `special` property.
|
The request data must contain the property `verbosity` with an integer number as the value, and it may also contain a boolean `special` property.
|
||||||
It also defines that the response sent must contain a `report` property mapping to an array of strings.
|
It also defines that the response sent may contain a `report` property mapping to an array of strings.
|
||||||
When received by a host, it will also be forwarded to the instance specified by `instance_id`.
|
|
||||||
|
|
||||||
The following properties are recognized by the Request constructor:
|
The following properties are recognized as part of a message class:
|
||||||
|
|
||||||
#### type
|
#### static plugin
|
||||||
|
|
||||||
The message type sent over the wire.
|
Must contain the name of the plugin this message is defined by.
|
||||||
This must start with the name of the plugin followed by colon and and be unique for the plugin.
|
This property is not used in core messages.
|
||||||
The type of the message sent over the socket will have the suffix `_request` appended to it for the request and `_response` appended to it for the response.
|
|
||||||
|
|
||||||
#### links
|
#### static type
|
||||||
|
|
||||||
An array of strings describing which links this request can be sent over.
|
A string describing the message type sent over the wire.
|
||||||
Direction matters; `"controller-host"` means the request can be sent from the controller to the host and the host can reply to the controller, but the host can't send a request to the controller unless `"host-controller"` is also present in the links array.
|
This can be either `"request"` or `"event"`.
|
||||||
|
The primary difference is whether they allow for a response.
|
||||||
|
|
||||||
The available endpoints are `controller`, `host`, `instance`, and `control`.
|
#### static src
|
||||||
Controller talks with host and control, and host talks to instance.
|
|
||||||
The full chain must be specified as the individual links in order for a message to travers multiple hops, (i.e., for a message to go from controller to instance it must have both `"controller-host"` and `"host-instance"` in the links array).
|
|
||||||
See `forwardTo` for ways to forward a request to the next link in a chain.
|
|
||||||
|
|
||||||
#### forwardTo
|
A string or an array of strings describing where this message is allowed to originate from.
|
||||||
|
The available endpoints are `"controller"`, `"host"`, `"instance"`, or `"control"`.
|
||||||
|
Messages sent from a different source will be rejected.
|
||||||
|
|
||||||
Target to forward the request to.
|
#### static dst
|
||||||
Can either be `"controller"` to indicate a host should forward it to the controller when receiving it from an instance, or `"instance"` to indicate it should be forwarded to the instances specified by the `instance_id` request property.
|
|
||||||
This works by using a default handler for the request by the links that forward it.
|
|
||||||
|
|
||||||
#### requestRequired
|
A string or array of strings describing where this message may be addressed to.
|
||||||
|
The available endpoints are `"controller"`, `"host"`, `"instance"`, or `"control"`.
|
||||||
|
If the target is multiple hops away it the message will be forwarded towards its destination by the intermediaries.
|
||||||
|
For example a message sent from a control connection an instance will be forwarded by the controller to the relevant host and from the host to the correct instance.
|
||||||
|
Messages sent to a different destination will be rejected.
|
||||||
|
|
||||||
By default all properties defined in `requestProperties` are required to be present in the payload for the request.
|
#### static jsonSchema
|
||||||
This can be overriden by specifying an array of properties which are required here.
|
|
||||||
This is equivalent to using the `required` keyword in JSON schema.
|
|
||||||
|
|
||||||
#### requestProperties
|
A JSON schema that specifies what's valid to send in the message.
|
||||||
|
|
||||||
Object with properties mapping to a JSON schema of that property that specifies what's valid to send in the request.
|
#### toJSON
|
||||||
This is equivalent to using the `properties` keyword in JSON schema, except that the properties specified are by default required and additional properties are not allowed.
|
|
||||||
See [this guide][guide] for an introduction to writing JSON schemas
|
|
||||||
|
|
||||||
#### responseRequired
|
Optional method to serialize an instance of the class to a JSON object, see the [documentation for `JSON.stringify()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#description) for the semantics of this method.
|
||||||
|
This should return an object that's valid according to `jsonSchema` and accepted by `fromJSON`, and may be omitted if the default serialisation by `JSON.stringify()` already does this.
|
||||||
|
|
||||||
Same as the requestRequired only for the response sent back by the target.
|
#### static fromJSON
|
||||||
|
|
||||||
#### responseProperties
|
Required function to restore the class from a JSON object.
|
||||||
|
This function is called when the message reaches its destination and is expected to return an identical instance of the class.
|
||||||
|
I.e. the result of `fromJSON(JSON.parse(JSON.stringify(instance)))` should be a complete copy of the message.
|
||||||
|
|
||||||
Same as the requestProperties only for the response sent back by the target.
|
#### static Response
|
||||||
|
|
||||||
|
Optional [JSON sterilisable class](/docs/devs/json-serialisable-classes.md) that specifies the response to the request.
|
||||||
|
Required properties are `jsonSchema` and `fromJSON`.
|
||||||
|
|
||||||
## Sending Link Messages
|
## Sending Link Messages
|
||||||
|
|
||||||
Link messages are sent by calling the `.send()` method on the Event/Request instance with the link you want to send it over and the data to send.
|
Link messages are sent by calling the `.sendTo()` method on a connection object with the destination and the data you want to send, where the data is an instance of one of the defined message classes in plugin.messages.
|
||||||
For `InstancePlugin` code the link to the host is the `instance` itself, which is accessible through the `.instance` property of the `InstancePlugin`.
|
For example:
|
||||||
The `.info` property of the plugin class exposes the data exported from the plugin's `plugin` export.
|
|
||||||
In other words:
|
|
||||||
|
|
||||||
```js
|
```js
|
||||||
// In an InstancePlugin class
|
// In an InstancePlugin class
|
||||||
async frobnicate() {
|
async frobnicate() {
|
||||||
this.info.messages.exampleEvent.send(this.instance, { foo: "bar" });
|
const response = await this.instance.sendTo("controller", new messages.Frobnicate({
|
||||||
|
verbosity: 2,
|
||||||
|
special: false,
|
||||||
|
}));
|
||||||
|
console.log(response); // { report: [...] }
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
For the Request class the send method is async and returns the response data received from the target it was sent to, or throws an error if the request failed.
|
For classes with `static type = "request"` the send method is async and returns a promise that resolves to the response data received from the target it was sent to, or rejects with an error if the request failed.
|
||||||
|
The destination specification can either be the ID of a particular control, host or instance, or one of the keywords used to send to multiple targets at once.
|
||||||
|
|
||||||
|
Example destinations:
|
||||||
|
|
||||||
|
```js
|
||||||
|
sendTo("controller", message);
|
||||||
|
sendTo("allHosts", message);
|
||||||
|
sendTo("allControls", message);
|
||||||
|
sendTo("allInstances", message);
|
||||||
|
sendTo({ hostId: 123 }, message);
|
||||||
|
sendTo({ instanceId: 123 }, message);
|
||||||
|
sendTo({ controlId: 123 }, message);
|
||||||
|
```
|
||||||
|
|
||||||
### Handling connection events
|
### Handling connection events
|
||||||
|
|
||||||
@@ -508,7 +483,7 @@ For example the sending of an event from an `InstancePlugin` class can be stoppe
|
|||||||
|
|
||||||
```js
|
```js
|
||||||
if (this.host.connected) {
|
if (this.host.connected) {
|
||||||
this.info.messages.frobnicate.send(this.instance, { foo: "bar" });
|
this.instance.sendTo("controller", new messages.Frobnicate({ foo: "bar" }));
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|||||||
+3
-1
@@ -3,7 +3,8 @@
|
|||||||
"private": true,
|
"private": true,
|
||||||
"scripts": {
|
"scripts": {
|
||||||
"build": "tsc --build",
|
"build": "tsc --build",
|
||||||
"test": "pnpm run build && mocha --check-leaks -R spec --recursive test \"plugins/*/test/**\"",
|
"watch": "tsc --build --watch",
|
||||||
|
"test": "pnpm run build && mocha --check-leaks -R spec --recursive test \"plugins/*/test/**\" --exclude \"test/manual/**\"",
|
||||||
"fast-test": "FAST_TEST=y pnpm test",
|
"fast-test": "FAST_TEST=y pnpm test",
|
||||||
"cover": "nyc pnpm test",
|
"cover": "nyc pnpm test",
|
||||||
"fast-cover": "FAST_TEST=y nyc pnpm test",
|
"fast-cover": "FAST_TEST=y nyc pnpm test",
|
||||||
@@ -27,6 +28,7 @@
|
|||||||
"@clusterio/ctl": "workspace:*",
|
"@clusterio/ctl": "workspace:*",
|
||||||
"@clusterio/host": "workspace:*",
|
"@clusterio/host": "workspace:*",
|
||||||
"@clusterio/lib": "workspace:*",
|
"@clusterio/lib": "workspace:*",
|
||||||
|
"@swc/core": "^1.4.0",
|
||||||
"@typescript-eslint/eslint-plugin": "^6.4.1",
|
"@typescript-eslint/eslint-plugin": "^6.4.1",
|
||||||
"@typescript-eslint/parser": "^6.4.1",
|
"@typescript-eslint/parser": "^6.4.1",
|
||||||
"eslint": "^8.45.0",
|
"eslint": "^8.45.0",
|
||||||
|
|||||||
@@ -1,2 +1,2 @@
|
|||||||
webpack.config.js
|
webpack.config.js
|
||||||
dist/web/build
|
dist/browser
|
||||||
@@ -37,6 +37,24 @@ import { version } from "./package.json";
|
|||||||
// globals
|
// globals
|
||||||
let controller: Controller;
|
let controller: Controller;
|
||||||
|
|
||||||
|
void new lib.Gauge(
|
||||||
|
"clusterio_controller_pending_requests",
|
||||||
|
"Count of pending link requests currently waiting in memory on the controller.",
|
||||||
|
{
|
||||||
|
callback: (gauge) => {
|
||||||
|
let count = 0;
|
||||||
|
if (controller) {
|
||||||
|
for (const host of controller.wsServer.hostConnections.values()) {
|
||||||
|
count += host.pendingRequestCount;
|
||||||
|
}
|
||||||
|
for (const control of controller.wsServer.controlConnections.values()) {
|
||||||
|
count += control.pendingRequestCount;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
gauge.set(count);
|
||||||
|
},
|
||||||
|
}
|
||||||
|
);
|
||||||
|
|
||||||
void new lib.Gauge(
|
void new lib.Gauge(
|
||||||
"clusterio_controller_host_mapping",
|
"clusterio_controller_host_mapping",
|
||||||
|
|||||||
@@ -1,7 +1,9 @@
|
|||||||
import { bootstrap } from "./controller";
|
import { bootstrap } from "./controller";
|
||||||
export { default as Controller } from "./src/Controller";
|
export { default as Controller } from "./src/Controller";
|
||||||
export { default as ControllerUser } from "./src/ControllerUser";
|
export { default as ControllerUser } from "./src/ControllerUser";
|
||||||
|
export { default as ControllerRouter } from "./src/ControllerRouter";
|
||||||
export { default as ControlConnection } from "./src/ControlConnection";
|
export { default as ControlConnection } from "./src/ControlConnection";
|
||||||
|
export { default as HostConnection } from "./src/HostConnection";
|
||||||
export { default as InstanceInfo } from "./src/InstanceInfo";
|
export { default as InstanceInfo } from "./src/InstanceInfo";
|
||||||
export { default as BaseControllerPlugin } from "./src/BaseControllerPlugin";
|
export { default as BaseControllerPlugin } from "./src/BaseControllerPlugin";
|
||||||
export { default as UserManager } from "./src/UserManager";
|
export { default as UserManager } from "./src/UserManager";
|
||||||
|
|||||||
@@ -3,14 +3,14 @@
|
|||||||
"description": "Implementation of Clusterio controller",
|
"description": "Implementation of Clusterio controller",
|
||||||
"author": "Hornwitser",
|
"author": "Hornwitser",
|
||||||
"license": "MIT",
|
"license": "MIT",
|
||||||
"version": "2.0.0-alpha.14",
|
"version": "2.0.0-alpha.18",
|
||||||
"main": "dist/index.js",
|
"main": "dist/node/index.js",
|
||||||
"scripts": {
|
"scripts": {
|
||||||
"prepare": "tsc --build && webpack-cli --env production",
|
"prepare": "tsc --build && webpack-cli --env production",
|
||||||
"test": "echo \"Error: no test specified\" && exit 1"
|
"test": "echo \"Error: no test specified\" && exit 1"
|
||||||
},
|
},
|
||||||
"bin": {
|
"bin": {
|
||||||
"clusteriocontroller": "./dist/controller.js"
|
"clusteriocontroller": "./dist/node/controller.js"
|
||||||
},
|
},
|
||||||
"keywords": [
|
"keywords": [
|
||||||
"factorio"
|
"factorio"
|
||||||
@@ -19,11 +19,12 @@
|
|||||||
"node": ">=18"
|
"node": ">=18"
|
||||||
},
|
},
|
||||||
"dependencies": {
|
"dependencies": {
|
||||||
"@clusterio/lib": "^2.0.0-alpha.14",
|
"@clusterio/lib": "^2.0.0-alpha.18",
|
||||||
"@sinclair/typebox": "^0.30.4",
|
"@sinclair/typebox": "^0.30.4",
|
||||||
"busboy": "^1.6.0",
|
"busboy": "^1.6.0",
|
||||||
"compression": "^1.7.4",
|
"compression": "^1.7.4",
|
||||||
"express": "^4.18.2",
|
"express": "^4.18.2",
|
||||||
|
"finalhandler": "^1.2.0",
|
||||||
"fs-extra": "^11.1.1",
|
"fs-extra": "^11.1.1",
|
||||||
"jsonwebtoken": "^9.0.1",
|
"jsonwebtoken": "^9.0.1",
|
||||||
"jszip": "^3.10.1",
|
"jszip": "^3.10.1",
|
||||||
@@ -35,10 +36,12 @@
|
|||||||
"yargs": "^17.7.2"
|
"yargs": "^17.7.2"
|
||||||
},
|
},
|
||||||
"devDependencies": {
|
"devDependencies": {
|
||||||
"@clusterio/web_ui": "^2.0.0-alpha.14",
|
"@clusterio/web_ui": "^2.0.0-alpha.18",
|
||||||
|
"@swc/core": "^1.4.0",
|
||||||
"@types/busboy": "^1.5.0",
|
"@types/busboy": "^1.5.0",
|
||||||
"@types/compression": "^1.7.2",
|
"@types/compression": "^1.7.2",
|
||||||
"@types/express": "^4.17.17",
|
"@types/express": "^4.17.17",
|
||||||
|
"@types/finalhandler": "^1.2.0",
|
||||||
"@types/fs-extra": "^11.0.1",
|
"@types/fs-extra": "^11.0.1",
|
||||||
"@types/jsonwebtoken": "^9.0.2",
|
"@types/jsonwebtoken": "^9.0.2",
|
||||||
"@types/node": "^20.4.5",
|
"@types/node": "^20.4.5",
|
||||||
|
|||||||
@@ -6,7 +6,6 @@ import type WsServerConnector from "./WsServerConnector";
|
|||||||
|
|
||||||
import * as lib from "@clusterio/lib";
|
import * as lib from "@clusterio/lib";
|
||||||
const { logger } = lib;
|
const { logger } = lib;
|
||||||
import ControllerRouter from "./ControllerRouter";
|
|
||||||
import * as routes from "./routes";
|
import * as routes from "./routes";
|
||||||
|
|
||||||
|
|
||||||
@@ -24,7 +23,7 @@ export default class BaseConnection extends lib.Link {
|
|||||||
public _controller: Controller
|
public _controller: Controller
|
||||||
) {
|
) {
|
||||||
super(connector);
|
super(connector);
|
||||||
this.router = new ControllerRouter(this._controller);
|
this.router = _controller.router;
|
||||||
for (let [Request, handler] of this._controller._registeredRequests) { this.handle(Request, handler); }
|
for (let [Request, handler] of this._controller._registeredRequests) { this.handle(Request, handler); }
|
||||||
for (let [Request, handler] of this._controller._fallbackedRequests) { this.fallbackRequest(Request, handler); }
|
for (let [Request, handler] of this._controller._fallbackedRequests) { this.fallbackRequest(Request, handler); }
|
||||||
for (let [Event, handler] of this._controller._registeredEvents) { this.handle(Event, handler); }
|
for (let [Event, handler] of this._controller._registeredEvents) { this.handle(Event, handler); }
|
||||||
|
|||||||
@@ -3,6 +3,7 @@ import { BlockList, type AddressInfo, isIPv4, isIPv6 } from "net";
|
|||||||
import type { ControllerArgs } from "../controller";
|
import type { ControllerArgs } from "../controller";
|
||||||
import express, { type Request, type Response, type NextFunction, type Application } from "express";
|
import express, { type Request, type Response, type NextFunction, type Application } from "express";
|
||||||
import type { Static } from "@sinclair/typebox";
|
import type { Static } from "@sinclair/typebox";
|
||||||
|
import finalhandler from "finalhandler";
|
||||||
|
|
||||||
import compression from "compression";
|
import compression from "compression";
|
||||||
import events, { EventEmitter } from "events";
|
import events, { EventEmitter } from "events";
|
||||||
@@ -26,6 +27,7 @@ import WsServer from "./WsServer";
|
|||||||
import HostConnection from "./HostConnection";
|
import HostConnection from "./HostConnection";
|
||||||
import HostInfo from "./HostInfo";
|
import HostInfo from "./HostInfo";
|
||||||
import BaseControllerPlugin from "./BaseControllerPlugin";
|
import BaseControllerPlugin from "./BaseControllerPlugin";
|
||||||
|
import ControllerRouter from "./ControllerRouter";
|
||||||
|
|
||||||
const endpointDurationSummary = new Summary(
|
const endpointDurationSummary = new Summary(
|
||||||
"clusterio_controller_http_endpoint_duration_seconds",
|
"clusterio_controller_http_endpoint_duration_seconds",
|
||||||
@@ -74,6 +76,7 @@ export default class Controller {
|
|||||||
|
|
||||||
/** WebSocket server */
|
/** WebSocket server */
|
||||||
wsServer: WsServer;
|
wsServer: WsServer;
|
||||||
|
router = new ControllerRouter(this);
|
||||||
trustedProxies: BlockList;
|
trustedProxies: BlockList;
|
||||||
debugEvents: events.EventEmitter = new events.EventEmitter();
|
debugEvents: events.EventEmitter = new events.EventEmitter();
|
||||||
private _events: events.EventEmitter = new events.EventEmitter();
|
private _events: events.EventEmitter = new events.EventEmitter();
|
||||||
@@ -272,7 +275,7 @@ export default class Controller {
|
|||||||
Controller.addAppRoutes(this.app, this.pluginInfos);
|
Controller.addAppRoutes(this.app, this.pluginInfos);
|
||||||
|
|
||||||
if (!args.dev) {
|
if (!args.dev) {
|
||||||
let manifestPath = path.join(__dirname, "..", "web", "manifest.json");
|
let manifestPath = path.join(__dirname, "..", "..", "web", "manifest.json");
|
||||||
|
|
||||||
let manifest = await Controller.loadJsonObject(manifestPath);
|
let manifest = await Controller.loadJsonObject(manifestPath);
|
||||||
if (!manifest["main.js"]) {
|
if (!manifest["main.js"]) {
|
||||||
@@ -284,6 +287,26 @@ export default class Controller {
|
|||||||
// Load plugins
|
// Load plugins
|
||||||
await this.loadPlugins();
|
await this.loadPlugins();
|
||||||
|
|
||||||
|
// Log all express errors from middleware or routes (app.use is missing the type overload)
|
||||||
|
this.app.use((err: Error, req: express.Request, res: express.Response, next: express.NextFunction): void => {
|
||||||
|
logger.log({
|
||||||
|
level: "error",
|
||||||
|
message: "Error while handling HTTP" +
|
||||||
|
`${req.httpVersion} ${req.method} ${req.originalUrl}:\n${err.stack}`,
|
||||||
|
meta: {
|
||||||
|
method: req.method,
|
||||||
|
url: req.originalUrl,
|
||||||
|
httpVersion: req.httpVersion,
|
||||||
|
headers: req.headers,
|
||||||
|
query: req.query,
|
||||||
|
},
|
||||||
|
});
|
||||||
|
|
||||||
|
// Create and call the final handler, this is the same method used by express
|
||||||
|
// This is used instead of next(err) to stop express from logging the error to the console
|
||||||
|
finalhandler(req, res, { env: this.app.get("env") })(err);
|
||||||
|
});
|
||||||
|
|
||||||
this.wsServer = new WsServer(this);
|
this.wsServer = new WsServer(this);
|
||||||
|
|
||||||
// Only start listening for connections after all plugins have loaded
|
// Only start listening for connections after all plugins have loaded
|
||||||
@@ -331,7 +354,7 @@ export default class Controller {
|
|||||||
|
|
||||||
if (args.dev) {
|
if (args.dev) {
|
||||||
// eslint-disable-next-line node/no-missing-require
|
// eslint-disable-next-line node/no-missing-require
|
||||||
webpackConfigs.push(require("../../webpack.config")({})); // Path outside of build
|
webpackConfigs.push(require("../../../webpack.config")({})); // Path outside of build
|
||||||
}
|
}
|
||||||
if (args.devPlugin) {
|
if (args.devPlugin) {
|
||||||
let devPlugins = new Map();
|
let devPlugins = new Map();
|
||||||
@@ -719,14 +742,29 @@ export default class Controller {
|
|||||||
|
|
||||||
static addAppRoutes(app: Application, pluginInfos: any[]) {
|
static addAppRoutes(app: Application, pluginInfos: any[]) {
|
||||||
app.use((req: Request, res: Response, next) => {
|
app.use((req: Request, res: Response, next) => {
|
||||||
let startNs = process.hrtime.bigint();
|
const startNs = process.hrtime.bigint();
|
||||||
stream.finished(res, () => {
|
stream.finished(res, () => {
|
||||||
let routePath = "static";
|
let routePath = "static";
|
||||||
if (req.route && req.route.path) {
|
if (req.route && req.route.path) {
|
||||||
routePath = req.route.path;
|
routePath = req.route.path;
|
||||||
}
|
}
|
||||||
let endNs = process.hrtime.bigint();
|
const endNs = process.hrtime.bigint();
|
||||||
endpointDurationSummary.labels(routePath).observe(Number(endNs - startNs) / 1e9);
|
const durationMs = (Number(endNs - startNs) / 1e6);
|
||||||
|
endpointDurationSummary.labels(routePath).observe(durationMs / 1e3);
|
||||||
|
logger.log({
|
||||||
|
level: "http",
|
||||||
|
message: `HTTP${req.httpVersion} ${req.method} ${req.originalUrl}` +
|
||||||
|
` (Status ${res.statusCode} in ${durationMs}ms)`,
|
||||||
|
meta: {
|
||||||
|
method: req.method,
|
||||||
|
url: req.originalUrl,
|
||||||
|
statusCode: res.statusCode,
|
||||||
|
responseTime: durationMs,
|
||||||
|
httpVersion: req.httpVersion,
|
||||||
|
headers: req.headers,
|
||||||
|
query: req.query,
|
||||||
|
},
|
||||||
|
});
|
||||||
});
|
});
|
||||||
next();
|
next();
|
||||||
});
|
});
|
||||||
@@ -735,7 +773,7 @@ export default class Controller {
|
|||||||
// Set folder to serve static content from (the website)
|
// Set folder to serve static content from (the website)
|
||||||
const staticOptions = { immutable: true, maxAge: 1000 * 86400 * 365 };
|
const staticOptions = { immutable: true, maxAge: 1000 * 86400 * 365 };
|
||||||
app.use("/static",
|
app.use("/static",
|
||||||
express.static(path.join(__dirname, "..", "..", "dist", "web", "static"), staticOptions)
|
express.static(path.join(__dirname, "..", "..", "web", "static"), staticOptions)
|
||||||
);
|
);
|
||||||
app.use("/static", express.static("static", staticOptions)); // Used for data export files
|
app.use("/static", express.static("static", staticOptions)); // Used for data export files
|
||||||
|
|
||||||
@@ -874,9 +912,11 @@ export default class Controller {
|
|||||||
*/
|
*/
|
||||||
clearSavesOfInstance(instanceId: number) {
|
clearSavesOfInstance(instanceId: number) {
|
||||||
const updates = [];
|
const updates = [];
|
||||||
|
const now = Date.now();
|
||||||
for (const [id, save] of this.saves) {
|
for (const [id, save] of this.saves) {
|
||||||
if (save.instanceId === instanceId) {
|
if (save.instanceId === instanceId) {
|
||||||
save.isDeleted = true;
|
save.isDeleted = true;
|
||||||
|
save.updatedAtMs = now;
|
||||||
updates.push(save);
|
updates.push(save);
|
||||||
this.saves.delete(id);
|
this.saves.delete(id);
|
||||||
}
|
}
|
||||||
@@ -937,9 +977,9 @@ export default class Controller {
|
|||||||
);
|
);
|
||||||
} else {
|
} else {
|
||||||
instance.status = "unassigned";
|
instance.status = "unassigned";
|
||||||
instance.updatedAtMs = Date.now();
|
|
||||||
this.instanceDetailsUpdated([instance]);
|
|
||||||
}
|
}
|
||||||
|
instance.updatedAtMs = Date.now();
|
||||||
|
this.instanceDetailsUpdated([instance]);
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -960,6 +1000,7 @@ export default class Controller {
|
|||||||
this.instancesDirty = true;
|
this.instancesDirty = true;
|
||||||
|
|
||||||
this.clearSavesOfInstance(instanceId);
|
this.clearSavesOfInstance(instanceId);
|
||||||
|
this.userManager.clearStatsOfInstance(instanceId);
|
||||||
|
|
||||||
let prev = instance.status;
|
let prev = instance.status;
|
||||||
instance.status = "deleted";
|
instance.status = "deleted";
|
||||||
@@ -1222,7 +1263,7 @@ export default class Controller {
|
|||||||
mainBundle = stats.toJson().assetsByChunkName["main"];
|
mainBundle = stats.toJson().assetsByChunkName["main"];
|
||||||
}
|
}
|
||||||
|
|
||||||
fs.readFile(path.join(__dirname, "..", "..", "web", "index.html"), "utf8").then((content) => {
|
fs.readFile(path.join(__dirname, "..", "..", "..", "web", "index.html"), "utf8").then((content) => {
|
||||||
res.type("text/html");
|
res.type("text/html");
|
||||||
res.send(content
|
res.send(content
|
||||||
.replace(/__CLUSTER_NAME__/g, res.app.locals.controller.config.get("controller.name"))
|
.replace(/__CLUSTER_NAME__/g, res.app.locals.controller.config.get("controller.name"))
|
||||||
@@ -1374,7 +1415,11 @@ export default class Controller {
|
|||||||
}
|
}
|
||||||
|
|
||||||
} else if (dst.id === lib.Address.instance || dst.id === lib.Address.host) {
|
} else if (dst.id === lib.Address.instance || dst.id === lib.Address.host) {
|
||||||
|
const plugin = event.constructor.plugin;
|
||||||
for (let hostConnection of this.wsServer.hostConnections.values()) {
|
for (let hostConnection of this.wsServer.hostConnections.values()) {
|
||||||
|
if (plugin && !hostConnection.plugins.has(plugin)) {
|
||||||
|
continue;
|
||||||
|
}
|
||||||
hostConnection.sendEvent(event, dst);
|
hostConnection.sendEvent(event, dst);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
@@ -7,8 +7,6 @@ import ControlConnection from "./ControlConnection";
|
|||||||
const { logger } = lib;
|
const { logger } = lib;
|
||||||
|
|
||||||
export default class ControllerRouter {
|
export default class ControllerRouter {
|
||||||
pendingRequests: Map<any, any> = new Map();
|
|
||||||
|
|
||||||
constructor(
|
constructor(
|
||||||
public controller: Controller
|
public controller: Controller
|
||||||
) {}
|
) {}
|
||||||
@@ -16,12 +14,14 @@ export default class ControllerRouter {
|
|||||||
/**
|
/**
|
||||||
* @param origin - Source link of the message.
|
* @param origin - Source link of the message.
|
||||||
* @param message - Link the message originated from.
|
* @param message - Link the message originated from.
|
||||||
|
* @param entry - message entry if message is a request or an event.
|
||||||
* @param hasFallback - true if fallback handling is available.
|
* @param hasFallback - true if fallback handling is available.
|
||||||
* @returns true if the message was handled
|
* @returns true if the message was handled
|
||||||
*/
|
*/
|
||||||
forwardMessage(
|
forwardMessage(
|
||||||
origin: ControlConnection | HostConnection,
|
origin: ControlConnection | HostConnection,
|
||||||
message: lib.MessageRoutable,
|
message: lib.MessageRoutable,
|
||||||
|
entry: lib.RequestEntry | lib.EventEntry | undefined,
|
||||||
hasFallback: boolean
|
hasFallback: boolean
|
||||||
): boolean {
|
): boolean {
|
||||||
if (!["request", "response", "responseError", "event"].includes(message.type)) {
|
if (!["request", "response", "responseError", "event"].includes(message.type)) {
|
||||||
@@ -32,7 +32,7 @@ export default class ControllerRouter {
|
|||||||
let nextHop: ControlConnection | HostConnection | undefined;
|
let nextHop: ControlConnection | HostConnection | undefined;
|
||||||
let msg: string = "";
|
let msg: string = "";
|
||||||
if (dst.type === lib.Address.broadcast) {
|
if (dst.type === lib.Address.broadcast) {
|
||||||
this.broadcastMessage(origin, message);
|
this.broadcastMessage(origin, message, entry as lib.EventEntry);
|
||||||
return true;
|
return true;
|
||||||
} else if (dst.type === lib.Address.host) {
|
} else if (dst.type === lib.Address.host) {
|
||||||
nextHop = this.controller.wsServer.hostConnections.get(dst.id);
|
nextHop = this.controller.wsServer.hostConnections.get(dst.id);
|
||||||
@@ -84,7 +84,7 @@ export default class ControllerRouter {
|
|||||||
if (message.type === "request") {
|
if (message.type === "request") {
|
||||||
nextHop.forwardRequest(message as lib.MessageRequest, origin);
|
nextHop.forwardRequest(message as lib.MessageRequest, origin);
|
||||||
} else {
|
} else {
|
||||||
nextHop.connector.send(message);
|
nextHop.connector.forward(message);
|
||||||
}
|
}
|
||||||
} else {
|
} else {
|
||||||
this.warnUnrouted(message, msg);
|
this.warnUnrouted(message, msg);
|
||||||
@@ -96,20 +96,24 @@ export default class ControllerRouter {
|
|||||||
broadcastMessage(
|
broadcastMessage(
|
||||||
origin: lib.Link,
|
origin: lib.Link,
|
||||||
message: lib.MessageRoutable,
|
message: lib.MessageRoutable,
|
||||||
|
entry: lib.EventEntry,
|
||||||
) {
|
) {
|
||||||
let dst = message.dst;
|
let dst = message.dst;
|
||||||
if (message.type !== "event") {
|
if (message.type !== "event") {
|
||||||
this.warnUnrouted(message, `Unexpected broadcast of ${message.type}`);
|
this.warnUnrouted(message, `Unexpected broadcast of ${message.type}`);
|
||||||
} else if (dst.id === lib.Address.host || dst.id === lib.Address.instance) {
|
return;
|
||||||
|
}
|
||||||
|
const plugin = entry.Event.plugin;
|
||||||
|
if (dst.id === lib.Address.host || dst.id === lib.Address.instance) {
|
||||||
for (let hostConnection of this.controller.wsServer.hostConnections.values()) {
|
for (let hostConnection of this.controller.wsServer.hostConnections.values()) {
|
||||||
if (hostConnection !== origin) {
|
if (hostConnection !== origin && (!plugin || hostConnection.plugins.has(plugin))) {
|
||||||
hostConnection.connector.send(message);
|
hostConnection.connector.forward(message);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
} else if (dst.id === lib.Address.control) {
|
} else if (dst.id === lib.Address.control) {
|
||||||
for (let controlConnection of this.controller.wsServer.controlConnections.values()) {
|
for (let controlConnection of this.controller.wsServer.controlConnections.values()) {
|
||||||
if (controlConnection !== origin) {
|
if (controlConnection !== origin) {
|
||||||
controlConnection.connector.send(message);
|
controlConnection.connector.forward(message);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
} else {
|
} else {
|
||||||
@@ -126,5 +130,3 @@ export default class ControllerRouter {
|
|||||||
logger.warn(msg ? `${baseMsg}: ${msg}.` : `${baseMsg}.`);
|
logger.warn(msg ? `${baseMsg}: ${msg}.` : `${baseMsg}.`);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
module.exports = ControllerRouter;
|
|
||||||
@@ -178,7 +178,10 @@ export default class HostConnection extends BaseConnection {
|
|||||||
// changed. Hosts also send status updates on assignInstance which
|
// changed. Hosts also send status updates on assignInstance which
|
||||||
// for hacky reason is also used to push config changes and
|
// for hacky reason is also used to push config changes and
|
||||||
// restablish status after a connection loss.
|
// restablish status after a connection loss.
|
||||||
if (instance.status === request.status) {
|
if (
|
||||||
|
instance.status === request.status
|
||||||
|
&& instance.gamePort === request.gamePort
|
||||||
|
) {
|
||||||
return;
|
return;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
@@ -113,4 +113,13 @@ export default class UserManager {
|
|||||||
this.onlineUsers.delete(user);
|
this.onlineUsers.delete(user);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
clearStatsOfInstance(instanceId: number) {
|
||||||
|
for (const user of this.users.values()) {
|
||||||
|
this.notifyLeave(user, instanceId);
|
||||||
|
user.instanceStats.delete(instanceId);
|
||||||
|
user.recalculatePlayerStats();
|
||||||
|
}
|
||||||
|
this.dirty = true;
|
||||||
|
}
|
||||||
}
|
}
|
||||||
@@ -284,7 +284,9 @@ ${err.stack}`
|
|||||||
);
|
);
|
||||||
}
|
}
|
||||||
|
|
||||||
connection = new HostConnection(data, connector, this.controller, this.remoteAddr(req));
|
// Handle close before HostConnection does. This avoids a host
|
||||||
|
// connection event happening between the connection breaking and
|
||||||
|
// it being removed from the host connections list.
|
||||||
connector.on("close", () => {
|
connector.on("close", () => {
|
||||||
if (this.hostConnections.get(data.id) === connection) {
|
if (this.hostConnections.get(data.id) === connection) {
|
||||||
this.hostConnections.delete(data.id);
|
this.hostConnections.delete(data.id);
|
||||||
@@ -292,6 +294,8 @@ ${err.stack}`
|
|||||||
logger.warn("Unlisted HostConnection closed");
|
logger.warn("Unlisted HostConnection closed");
|
||||||
}
|
}
|
||||||
});
|
});
|
||||||
|
|
||||||
|
connection = new HostConnection(data, connector, this.controller, this.remoteAddr(req));
|
||||||
this.hostConnections.set(data.id, connection);
|
this.hostConnections.set(data.id, connection);
|
||||||
let src = new lib.Address(lib.Address.host, data.id);
|
let src = new lib.Address(lib.Address.host, data.id);
|
||||||
connector.ready(socket, src, sessionToken, undefined);
|
connector.ready(socket, src, sessionToken, undefined);
|
||||||
@@ -331,10 +335,10 @@ ${err.stack}`
|
|||||||
let [connector, sessionToken] = this.createSession(new lib.Address(lib.Address.control, id));
|
let [connector, sessionToken] = this.createSession(new lib.Address(lib.Address.control, id));
|
||||||
|
|
||||||
logger.verbose(`WsServer | registered control ${id} from ${this.remoteAddr(req)}`);
|
logger.verbose(`WsServer | registered control ${id} from ${this.remoteAddr(req)}`);
|
||||||
let connection = new ControlConnection(data, connector, this.controller, user, id);
|
|
||||||
connector.on("close", () => {
|
connector.on("close", () => {
|
||||||
this.controlConnections.delete(id);
|
this.controlConnections.delete(id);
|
||||||
});
|
});
|
||||||
|
let connection = new ControlConnection(data, connector, this.controller, user, id);
|
||||||
this.controlConnections.set(id, connection);
|
this.controlConnections.set(id, connection);
|
||||||
let account = new lib.AccountDetails(
|
let account = new lib.AccountDetails(
|
||||||
user.name,
|
user.name,
|
||||||
|
|||||||
@@ -0,0 +1,12 @@
|
|||||||
|
{
|
||||||
|
"extends": "../../tsconfig.browser.json",
|
||||||
|
"references": [
|
||||||
|
{ "path": "../lib/tsconfig.browser.json" },
|
||||||
|
{ "path": "../web_ui/tsconfig.browser.json" },
|
||||||
|
],
|
||||||
|
"include": [ "web/**/*.tsx", "web/**/*.ts", "package.json" ],
|
||||||
|
"compilerOptions": {
|
||||||
|
"rootDir": "..",
|
||||||
|
"outDir": "dist/browser",
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -1,10 +1,7 @@
|
|||||||
{
|
{
|
||||||
"extends": "../../tsconfig.node.json",
|
"files": [],
|
||||||
"references": [
|
"references": [
|
||||||
{ "path": "../lib" },
|
{ "path": "./tsconfig.node.json" },
|
||||||
|
{ "path": "./tsconfig.browser.json" },
|
||||||
],
|
],
|
||||||
"include": ["index.ts", "controller.ts", "package.json", "src/**/*.ts"],
|
|
||||||
"compilerOptions": {
|
|
||||||
"outDir": "dist",
|
|
||||||
},
|
|
||||||
}
|
}
|
||||||
@@ -0,0 +1,10 @@
|
|||||||
|
{
|
||||||
|
"extends": "../../tsconfig.node.json",
|
||||||
|
"references": [
|
||||||
|
{ "path": "../lib/tsconfig.node.json" },
|
||||||
|
],
|
||||||
|
"include": ["index.ts", "controller.ts", "package.json", "src/**/*.ts"],
|
||||||
|
"compilerOptions": {
|
||||||
|
"outDir": "dist/node",
|
||||||
|
},
|
||||||
|
}
|
||||||
@@ -1,12 +0,0 @@
|
|||||||
{
|
|
||||||
"extends": "../../tsconfig.web.json",
|
|
||||||
"references": [
|
|
||||||
{ "path": "../lib/tsconfig.web.json" },
|
|
||||||
{ "path": "../web_ui/tsconfig.web.json" },
|
|
||||||
],
|
|
||||||
"include": [ "web/**/*.tsx", "web/**/*.ts", "package.json" ],
|
|
||||||
"compilerOptions": {
|
|
||||||
"rootDir": "..",
|
|
||||||
"outDir": "dist/web/build",
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -12,10 +12,23 @@ const util = require("util");
|
|||||||
const yargs = require("yargs");
|
const yargs = require("yargs");
|
||||||
|
|
||||||
const { levels, logger, setLogLevel } = require("./logging");
|
const { levels, logger, setLogLevel } = require("./logging");
|
||||||
|
const { copyPluginTemplates } = require("./template");
|
||||||
let dev = false;
|
let dev = false;
|
||||||
const scriptExt = process.platform === "win32" ? ".cmd" : "";
|
const scriptExt = process.platform === "win32" ? ".cmd" : "";
|
||||||
const finished = util.promisify(stream.finished);
|
const finished = util.promisify(stream.finished);
|
||||||
|
|
||||||
|
// I hate this, there is a bug with rl.close on windows that was meant to have been fixed in Node14.4
|
||||||
|
// See nodejs/node#21771 and nodejs/node#30701 for the apparent fix that was applied
|
||||||
|
// One option is to not call rl.close: SBoudrias/Inquirer.js#767
|
||||||
|
// But this comes with its own issues: SBoudrias/Inquirer.js#899
|
||||||
|
// The solution below was adapted from aws-amplify/amplify-cli#12347
|
||||||
|
if (process.platform === "win32") {
|
||||||
|
const _inquirer_close = inquirer.ui.Prompt.prototype.close;
|
||||||
|
inquirer.ui.Prompt.prototype.close = function() {
|
||||||
|
this.rl.terminal = false;
|
||||||
|
_inquirer_close.call(this);
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
const availablePlugins = [
|
const availablePlugins = [
|
||||||
{ name: "Global Chat", value: "@clusterio/plugin-global_chat" },
|
{ name: "Global Chat", value: "@clusterio/plugin-global_chat" },
|
||||||
@@ -95,7 +108,7 @@ async function safeOutputFile(file, data, options={}) {
|
|||||||
async function execFile(cmd, args) {
|
async function execFile(cmd, args) {
|
||||||
logger.verbose(`executing ${cmd} ${args.join(" ")}`);
|
logger.verbose(`executing ${cmd} ${args.join(" ")}`);
|
||||||
return new Promise((resolve, reject) => {
|
return new Promise((resolve, reject) => {
|
||||||
let child = child_process.execFile(cmd, args, (err, stdout, stderr) => {
|
let child = child_process.execFile(cmd, args, { shell: true }, (err, stdout, stderr) => {
|
||||||
if (err) {
|
if (err) {
|
||||||
reject(err);
|
reject(err);
|
||||||
} else {
|
} else {
|
||||||
@@ -488,6 +501,7 @@ Group=${await groupIdToName(os.userInfo().gid)}
|
|||||||
WorkingDirectory=${process.cwd()}
|
WorkingDirectory=${process.cwd()}
|
||||||
KillMode=mixed
|
KillMode=mixed
|
||||||
KillSignal=SIGINT
|
KillSignal=SIGINT
|
||||||
|
Environment=NODE_OPTIONS=--enable-source-maps
|
||||||
ExecStart=${process.cwd()}/node_modules/.bin/clusteriohost run --log-level=warn --can-restart
|
ExecStart=${process.cwd()}/node_modules/.bin/clusteriohost run --log-level=warn --can-restart
|
||||||
Restart=on-failure
|
Restart=on-failure
|
||||||
RestartPreventExitStatus=8
|
RestartPreventExitStatus=8
|
||||||
@@ -504,6 +518,7 @@ WantedBy=multi-user.target
|
|||||||
async function inquirerMissingArgs(args) {
|
async function inquirerMissingArgs(args) {
|
||||||
let answers = {};
|
let answers = {};
|
||||||
if (args.mode) { answers.mode = args.mode; }
|
if (args.mode) { answers.mode = args.mode; }
|
||||||
|
if (args["plugin-template"]) { answers.mode = "plugin-template"; }
|
||||||
answers = await inquirer.prompt([
|
answers = await inquirer.prompt([
|
||||||
{
|
{
|
||||||
type: "list",
|
type: "list",
|
||||||
@@ -516,6 +531,7 @@ async function inquirerMissingArgs(args) {
|
|||||||
{ name: "Host only", value: "host" },
|
{ name: "Host only", value: "host" },
|
||||||
{ name: "Ctl only", value: "ctl" },
|
{ name: "Ctl only", value: "ctl" },
|
||||||
{ name: "Plugins only", value: "plugins" },
|
{ name: "Plugins only", value: "plugins" },
|
||||||
|
{ name: "Plugin template", value: "plugin-template" },
|
||||||
],
|
],
|
||||||
},
|
},
|
||||||
], answers);
|
], answers);
|
||||||
@@ -611,7 +627,7 @@ async function inquirerMissingArgs(args) {
|
|||||||
},
|
},
|
||||||
], answers);
|
], answers);
|
||||||
|
|
||||||
if (answers.downloadHeadless) {
|
if (!answers.factorioDir && answers.downloadHeadless) {
|
||||||
answers.factorioDir = "factorio";
|
answers.factorioDir = "factorio";
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -643,6 +659,38 @@ async function inquirerMissingArgs(args) {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
if (answers.mode === "plugin-template") {
|
||||||
|
if (args["plugin-template"] && args["plugin-template"].length > 0) {
|
||||||
|
answers.pluginTemplate = args["plugin-template"];
|
||||||
|
}
|
||||||
|
if (args["plugin-name"]) {
|
||||||
|
answers.pluginName = args["plugin-name"];
|
||||||
|
}
|
||||||
|
answers.plugins = [];
|
||||||
|
answers = await inquirer.prompt([
|
||||||
|
{
|
||||||
|
type: "checkbox",
|
||||||
|
name: "pluginTemplate",
|
||||||
|
message: "Plugin templates to use",
|
||||||
|
choices: [
|
||||||
|
{ name: "Controller", value: "controller" },
|
||||||
|
{ name: "Host", value: "host" },
|
||||||
|
{ name: "Instance", value: "instance" },
|
||||||
|
{ name: "Lua Module", value: "module" },
|
||||||
|
{ name: "Command Line", value: "ctl" },
|
||||||
|
{ name: "Web UI", value: "web" },
|
||||||
|
{ name: "No Typescript", value: "js" },
|
||||||
|
],
|
||||||
|
},
|
||||||
|
{
|
||||||
|
type: "input",
|
||||||
|
name: "pluginName",
|
||||||
|
message: "Name of your new plugin",
|
||||||
|
default: path.basename(path.resolve()),
|
||||||
|
},
|
||||||
|
], answers);
|
||||||
|
}
|
||||||
|
|
||||||
if (dev) {
|
if (dev) {
|
||||||
answers.plugins = [];
|
answers.plugins = [];
|
||||||
} else if (args.plugins) {
|
} else if (args.plugins) {
|
||||||
@@ -719,7 +767,7 @@ async function main() {
|
|||||||
})
|
})
|
||||||
.option("mode", {
|
.option("mode", {
|
||||||
nargs: 1, describe: "Operating mode to install",
|
nargs: 1, describe: "Operating mode to install",
|
||||||
choices: ["standalone", "controller", "host", "ctl", "plugins"],
|
choices: ["standalone", "controller", "host", "ctl", "plugins", "plugin-template"],
|
||||||
})
|
})
|
||||||
.option("migrate-rename", {
|
.option("migrate-rename", {
|
||||||
nargs: 0, describe: "Migrate from before slave/master rename", default: false, type: "boolean",
|
nargs: 0, describe: "Migrate from before slave/master rename", default: false, type: "boolean",
|
||||||
@@ -745,6 +793,12 @@ async function main() {
|
|||||||
.option("plugins", {
|
.option("plugins", {
|
||||||
array: true, describe: "Plugins to install", type: "string",
|
array: true, describe: "Plugins to install", type: "string",
|
||||||
})
|
})
|
||||||
|
.option("plugin-template", {
|
||||||
|
array: true, describe: "Plugin template to use [plugin-template]", type: "string",
|
||||||
|
})
|
||||||
|
.option("plugin-name", {
|
||||||
|
nargs: 1, describe: "Name of your new plugin [plugin-template]", type: "string",
|
||||||
|
})
|
||||||
.strict()
|
.strict()
|
||||||
;
|
;
|
||||||
|
|
||||||
@@ -759,7 +813,7 @@ async function main() {
|
|||||||
"Can be set to false using --no-download-headless.",
|
"Can be set to false using --no-download-headless.",
|
||||||
type: "boolean",
|
type: "boolean",
|
||||||
})
|
})
|
||||||
.conflicts("factorio-dir", "download-headless");
|
;
|
||||||
}
|
}
|
||||||
|
|
||||||
args = args.argv;
|
args = args.argv;
|
||||||
@@ -778,11 +832,19 @@ async function main() {
|
|||||||
}
|
}
|
||||||
|
|
||||||
let answers = await inquirerMissingArgs(args);
|
let answers = await inquirerMissingArgs(args);
|
||||||
if (answers.downloadHeadless) {
|
logger.verbose(JSON.stringify(answers));
|
||||||
await downloadLinuxServer();
|
|
||||||
|
if (answers.pluginTemplate) {
|
||||||
|
await copyPluginTemplates(answers.pluginName, answers.pluginTemplate);
|
||||||
|
return;
|
||||||
}
|
}
|
||||||
|
|
||||||
logger.verbose(JSON.stringify(answers));
|
if (answers.downloadHeadless) {
|
||||||
|
if (answers.factorioDir !== "factorio") {
|
||||||
|
throw new InstallError("--download-headless option requires --factorio-dir to be set to factorio");
|
||||||
|
}
|
||||||
|
await downloadLinuxServer();
|
||||||
|
}
|
||||||
|
|
||||||
if (!dev) {
|
if (!dev) {
|
||||||
await installClusterio(answers.mode, answers.plugins);
|
await installClusterio(answers.mode, answers.plugins);
|
||||||
|
|||||||
@@ -3,7 +3,7 @@
|
|||||||
"description": "Installer for clusterio",
|
"description": "Installer for clusterio",
|
||||||
"author": "Hornwitser",
|
"author": "Hornwitser",
|
||||||
"license": "MIT",
|
"license": "MIT",
|
||||||
"version": "2.0.0-alpha.14",
|
"version": "2.0.0-alpha.18",
|
||||||
"main": "create.js",
|
"main": "create.js",
|
||||||
"bin": {
|
"bin": {
|
||||||
"clusteriocreate": "./create.js"
|
"clusteriocreate": "./create.js"
|
||||||
|
|||||||
@@ -0,0 +1,171 @@
|
|||||||
|
"use strict";
|
||||||
|
const { logger } = require("./logging");
|
||||||
|
const fs = require("fs-extra");
|
||||||
|
const path = require("path");
|
||||||
|
|
||||||
|
async function copyTemplateFile(src, dst, properties) {
|
||||||
|
logger.verbose(`Writing ${dst} from template ${src}`);
|
||||||
|
|
||||||
|
// Closure, get the property value or throw
|
||||||
|
function getProperty(property) {
|
||||||
|
if (!properties.hasOwnProperty(property)) {
|
||||||
|
throw new Error(`Unknown property (${property}) found in template file ${src}`);
|
||||||
|
}
|
||||||
|
|
||||||
|
return properties[property];
|
||||||
|
}
|
||||||
|
|
||||||
|
// Closure, Get the boolean conjunction of a set of properties
|
||||||
|
function propertyConjunction(props) {
|
||||||
|
for (const property of props) {
|
||||||
|
if (property.startsWith("!")) {
|
||||||
|
if (Boolean(getProperty(property.slice(1)))) {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
} else if (!Boolean(getProperty(property))) {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Process the the template file
|
||||||
|
const badChars = /[\(\)-+/*<>=]/;
|
||||||
|
const templateData = await fs.readFile(src, "utf8");
|
||||||
|
const outputData = templateData
|
||||||
|
// match preprocessor comments: //%//
|
||||||
|
.replace(/^\/\/%\/\/.*\n/gm, "")
|
||||||
|
// match preprocessor insert: __property__
|
||||||
|
.replace(/__([a-zA-Z][a-zA-Z0-9_]*?[a-zA-Z0-9]?)__/gm, (_, property) => getProperty(property))
|
||||||
|
// match preprocessor conditionals: //%if <CONDITION> [// COMMENT]\n <CONTENT> \n//%endif [COMMENT]\n
|
||||||
|
.replace(/^\/\/%if ([^\n\/]*)(?:\/\/.*?)?\n((?:.|\n)*?)\/\/%endif.*\n/gm, (_, condition, content) => {
|
||||||
|
let include = false;
|
||||||
|
const conjunctions = condition.split("|");
|
||||||
|
for (const conjunct of conjunctions) {
|
||||||
|
if (badChars.test(conjunct)) {
|
||||||
|
throw new Error("Preprocessor condition can only contain logical operators" +
|
||||||
|
"such as & | or ! it can not have arithmetic, comparisons or parenthesis"
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
const property_names = conjunct.split("&").map(s => s.trim());
|
||||||
|
if (propertyConjunction(property_names)) {
|
||||||
|
include = true;
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return include ? content : "";
|
||||||
|
});
|
||||||
|
|
||||||
|
// Attempt to write the output file, warn if it already exists
|
||||||
|
try {
|
||||||
|
await fs.outputFile(dst, outputData, { flag: "wx" });
|
||||||
|
} catch (err) {
|
||||||
|
if (err.code === "EEXIST") {
|
||||||
|
logger.warn(`Could not create file ${dst} because it already exists`);
|
||||||
|
} else {
|
||||||
|
throw err;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
async function copyPluginTemplates(pluginName, templates) {
|
||||||
|
logger.info(`Please wait, coping templates for ${templates.join(", ")}`);
|
||||||
|
const files = new Map();
|
||||||
|
const prepare = [];
|
||||||
|
|
||||||
|
const javascriptOnly = templates.includes("js");
|
||||||
|
const webpack = templates.includes("controller") || templates.includes("web");
|
||||||
|
|
||||||
|
// Get the file extension and path to the templates
|
||||||
|
const ext = javascriptOnly ? "js" : "ts";
|
||||||
|
const templatePath = path.resolve(__dirname, javascriptOnly ? "./templates/plugin-js" : "./templates/plugin-ts");
|
||||||
|
const commonPath = path.resolve(__dirname, "./templates/common");
|
||||||
|
|
||||||
|
// Files included in all templates
|
||||||
|
files.set(".gitignore", path.join(commonPath, ".gitignore"));
|
||||||
|
files.set(".npmignore", path.join(commonPath, ".npmignore"));
|
||||||
|
files.set("package.json", path.join(commonPath, "package.json"));
|
||||||
|
files.set(`messages.${ext}`, path.join(templatePath, `messages.${ext}`));
|
||||||
|
files.set(`index.${ext}`, path.join(templatePath, `index.${ext}`));
|
||||||
|
|
||||||
|
// Files and dependencies to support typescript
|
||||||
|
if (!javascriptOnly) {
|
||||||
|
prepare.push("tsc --build");
|
||||||
|
files.set("tsconfig.json", path.join(templatePath, "tsconfig.json"));
|
||||||
|
files.set("tsconfig.node.json", path.join(templatePath, "tsconfig.node.json"));
|
||||||
|
if (webpack) {
|
||||||
|
files.set("tsconfig.browser.json", path.join(templatePath, "tsconfig.browser.json"));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Files and dependences to support webpack
|
||||||
|
if (webpack) {
|
||||||
|
prepare.push("webpack-cli --env production");
|
||||||
|
files.set("webpack.config.js", path.join(commonPath, "webpack.config.js"));
|
||||||
|
files.set(`web/index.${ext}x`, path.join(templatePath,
|
||||||
|
templates.includes("web") ? `web/plugin.${ext}x` : `web/no_plugin.${ext}x`
|
||||||
|
));
|
||||||
|
}
|
||||||
|
|
||||||
|
// Files for the controller
|
||||||
|
if (templates.includes("controller")) {
|
||||||
|
files.set(`controller.${ext}`, path.join(templatePath, `controller.${ext}`));
|
||||||
|
}
|
||||||
|
|
||||||
|
// Files for hosts
|
||||||
|
if (templates.includes("host")) {
|
||||||
|
files.set(`host.${ext}`, path.join(templatePath, `host.${ext}`));
|
||||||
|
}
|
||||||
|
|
||||||
|
// Files for instances
|
||||||
|
if (templates.includes("instance")) {
|
||||||
|
files.set(`instance.${ext}`, path.join(templatePath, `instance.${ext}`));
|
||||||
|
}
|
||||||
|
|
||||||
|
// Files for lua modules
|
||||||
|
if (templates.includes("module")) {
|
||||||
|
files.set(".luacheckrc", path.join(commonPath, ".luacheckrc"));
|
||||||
|
files.set("module/module.json", path.join(commonPath, "module/module.json"));
|
||||||
|
files.set("module/control.lua", path.join(commonPath, "module/control.lua"));
|
||||||
|
files.set("module/module_exports.lua", path.join(commonPath, "module/module_exports.lua"));
|
||||||
|
if (templates.includes("instance")) {
|
||||||
|
files.set("module/globals.lua", path.join(commonPath, "module/globals.lua"));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Files for the control tool
|
||||||
|
if (templates.includes("ctl")) {
|
||||||
|
files.set(`ctl.${ext}`, path.join(templatePath, `ctl.${ext}`));
|
||||||
|
}
|
||||||
|
|
||||||
|
// Properties that will control the replacements in the templates
|
||||||
|
const properties = {
|
||||||
|
typescript: !javascriptOnly,
|
||||||
|
controller: templates.includes("controller"),
|
||||||
|
host: templates.includes("host"),
|
||||||
|
instance: templates.includes("instance"),
|
||||||
|
module: templates.includes("module"),
|
||||||
|
ctl: templates.includes("ctl"),
|
||||||
|
web: templates.includes("web"),
|
||||||
|
plugin_name: pluginName,
|
||||||
|
prepare: prepare.join(" && "),
|
||||||
|
ext: ext,
|
||||||
|
};
|
||||||
|
|
||||||
|
// Write all the template files
|
||||||
|
const writes = [];
|
||||||
|
for (let [dst, src] of files) {
|
||||||
|
writes.push(copyTemplateFile(src, dst, properties));
|
||||||
|
}
|
||||||
|
|
||||||
|
// Wait for writes to complete
|
||||||
|
await Promise.all(writes);
|
||||||
|
logger.info("Successfully wrote all template files");
|
||||||
|
}
|
||||||
|
|
||||||
|
module.exports = {
|
||||||
|
copyPluginTemplates,
|
||||||
|
};
|
||||||
@@ -0,0 +1,3 @@
|
|||||||
|
dist/
|
||||||
|
node_modules/
|
||||||
|
package-lock.json
|
||||||
File diff suppressed because it is too large.
Load diff
@@ -0,0 +1,3 @@
|
|||||||
|
webpack.config.js
|
||||||
|
dist/web/build
|
||||||
|
dist/browser
|
||||||
@@ -0,0 +1,54 @@
|
|||||||
|
local clusterio_api = require("modules/clusterio/api")
|
||||||
|
|
||||||
|
--- Top level module table, contains event handlers and public methods
|
||||||
|
local MyModule = {
|
||||||
|
events = {},
|
||||||
|
on_nth_tick = {},
|
||||||
|
}
|
||||||
|
|
||||||
|
--- global is 'synced' between players, you should use your plugin name to avoid conflicts
|
||||||
|
-- setupGlobalData should either be removed or called during clusterio_api.events.on_server_startup
|
||||||
|
local globalData = {}
|
||||||
|
local function setupGlobalData()
|
||||||
|
if global["__plugin_name__"] == nil then
|
||||||
|
global["__plugin_name__"] = {
|
||||||
|
-- starting values go here
|
||||||
|
}
|
||||||
|
end
|
||||||
|
globalData = global["__plugin_name__"]
|
||||||
|
end
|
||||||
|
|
||||||
|
--- Public methods should be available though your top level module table
|
||||||
|
function MyModule.foo()
|
||||||
|
game.print("foo")
|
||||||
|
end
|
||||||
|
|
||||||
|
--- Private methods should be local to the file, this will prevent others from calling it
|
||||||
|
local function bar()
|
||||||
|
game.print("bar")
|
||||||
|
end
|
||||||
|
|
||||||
|
--- Clusterio provides a few custom events, on_server_startup is the most useful and should be used in place of on_load
|
||||||
|
MyModule.events[clusterio_api.events.on_server_startup] = function(event)
|
||||||
|
setupGlobalData()
|
||||||
|
game.print(game.table_to_json(event))
|
||||||
|
end
|
||||||
|
|
||||||
|
--- Factorio events are accessible through defines.events, you can have one handler per event per module
|
||||||
|
MyModule.events[defines.events.on_player_crafted_item] = function(event)
|
||||||
|
game.print(game.table_to_json(event))
|
||||||
|
//%if instance
|
||||||
|
clusterio_api.send_json("__plugin_name__-plugin_example_ipc", {
|
||||||
|
tick = game.tick, player_name = game.get_player(event.player_index).name
|
||||||
|
})
|
||||||
|
//%endif
|
||||||
|
end
|
||||||
|
|
||||||
|
--- Nth tick is a special case that requires its own table, the index represents the time period between calls in ticks
|
||||||
|
MyModule.on_nth_tick[300] = function()
|
||||||
|
game.print(game.tick)
|
||||||
|
bar()
|
||||||
|
end
|
||||||
|
|
||||||
|
--- Always return the top level module table from control, this is how clusterio will access your event handlers
|
||||||
|
return MyModule
|
||||||
@@ -0,0 +1,3 @@
|
|||||||
|
--- Expose any globals here, typically just your control file if you want to access it through rcon or commands
|
||||||
|
-- luacheck: globals __plugin_name__
|
||||||
|
__plugin_name__ = require("modules/__plugin_name__/control")
|
||||||
@@ -0,0 +1,14 @@
|
|||||||
|
{
|
||||||
|
"name": "__plugin_name__",
|
||||||
|
"load": [
|
||||||
|
"control.lua"
|
||||||
|
],
|
||||||
|
"require": [
|
||||||
|
//%if instance
|
||||||
|
"globals.lua"
|
||||||
|
//%endif
|
||||||
|
],
|
||||||
|
"dependencies": {
|
||||||
|
"clusterio": "*"
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,3 @@
|
|||||||
|
--- Can contain anything you want to allow other plugins to have access to, this example exposes the control file
|
||||||
|
-- Access the exports from other modules using require("modules/__plugin_name__")
|
||||||
|
return require("modules/__plugin_name__/control")
|
||||||
@@ -0,0 +1,53 @@
|
|||||||
|
{
|
||||||
|
"name": "__plugin_name__",
|
||||||
|
"version": "0.1.0",
|
||||||
|
"description": "Example Description. Package. Change me in package.json",
|
||||||
|
//%if typescript
|
||||||
|
"main": "dist/node/index.js",
|
||||||
|
//%endif
|
||||||
|
//%if !typescript
|
||||||
|
"main": "index.js",
|
||||||
|
//%endif
|
||||||
|
"scripts": {
|
||||||
|
"prepare": "__prepare__"
|
||||||
|
},
|
||||||
|
"engines": {
|
||||||
|
"node": ">=18"
|
||||||
|
},
|
||||||
|
"peerDependencies": {
|
||||||
|
"@clusterio/lib": "^2.0.0-alpha.17"
|
||||||
|
},
|
||||||
|
"devDependencies": {
|
||||||
|
//%// Typescript and type declarations
|
||||||
|
//%if typescript
|
||||||
|
"typescript": "^5.1.6",
|
||||||
|
"@types/node": "^20.4.5",
|
||||||
|
//%endif
|
||||||
|
//%if typescript & web
|
||||||
|
"@types/react": "^18.2.21",
|
||||||
|
//%endif
|
||||||
|
//%// Everything else
|
||||||
|
//%if web
|
||||||
|
"antd": "^5.13.0",
|
||||||
|
"react": "^18.2.0",
|
||||||
|
"react-dom": "^18.2.0",
|
||||||
|
//%endif
|
||||||
|
//%if web | controller // The controller uses webpack even when there is no plugin code
|
||||||
|
"webpack": "^5.88.2",
|
||||||
|
"webpack-cli": "^5.1.4",
|
||||||
|
"webpack-merge": "^5.9.0",
|
||||||
|
"@clusterio/web_ui": "^2.0.0-alpha.17",
|
||||||
|
//%endif
|
||||||
|
"@clusterio/lib": "^2.0.0-alpha.17"
|
||||||
|
},
|
||||||
|
"dependencies": {
|
||||||
|
"@sinclair/typebox": "^0.30.4"
|
||||||
|
},
|
||||||
|
"publishConfig": {
|
||||||
|
"access": "public"
|
||||||
|
},
|
||||||
|
"keywords": [
|
||||||
|
"clusterio",
|
||||||
|
"factorio"
|
||||||
|
]
|
||||||
|
}
|
||||||
@@ -0,0 +1,36 @@
|
|||||||
|
"use strict";
|
||||||
|
const path = require("path");
|
||||||
|
const webpack = require("webpack");
|
||||||
|
const { merge } = require("webpack-merge");
|
||||||
|
|
||||||
|
const common = require("@clusterio/web_ui/webpack.common");
|
||||||
|
|
||||||
|
module.exports = (env = {}) => merge(common(env), {
|
||||||
|
context: __dirname,
|
||||||
|
entry: "./web/index.__ext__x",
|
||||||
|
output: {
|
||||||
|
path: path.resolve(__dirname, "dist", "web"),
|
||||||
|
},
|
||||||
|
plugins: [
|
||||||
|
new webpack.container.ModuleFederationPlugin({
|
||||||
|
name: "__plugin_name__",
|
||||||
|
library: { type: "window", name: "plugin___plugin_name__" },
|
||||||
|
exposes: {
|
||||||
|
"./": "./index.__ext__",
|
||||||
|
"./package.json": "./package.json",
|
||||||
|
//%if web
|
||||||
|
"./web": "./web/index.__ext__x",
|
||||||
|
//%endif
|
||||||
|
},
|
||||||
|
shared: {
|
||||||
|
"@clusterio/lib": { import: false },
|
||||||
|
"@clusterio/web_ui": { import: false },
|
||||||
|
//%if web
|
||||||
|
"antd": { import: false },
|
||||||
|
"react": { import: false },
|
||||||
|
"react-dom": { import: false },
|
||||||
|
//%endif
|
||||||
|
},
|
||||||
|
}),
|
||||||
|
],
|
||||||
|
});
|
||||||
@@ -0,0 +1,73 @@
|
|||||||
|
"use strict";
|
||||||
|
const lib = require("@clusterio/lib");
|
||||||
|
const { BaseControllerPlugin } = require("@clusterio/controller");
|
||||||
|
|
||||||
|
const {
|
||||||
|
PluginExampleEvent, PluginExampleRequest,
|
||||||
|
//%if controller & web // Subscribing requires web content and the controller
|
||||||
|
ExampleSubscribableUpdate, ExampleSubscribableValue,
|
||||||
|
//%endif
|
||||||
|
} = require("./messages");
|
||||||
|
|
||||||
|
class ControllerPlugin extends BaseControllerPlugin {
|
||||||
|
//%if controller & web // Subscribing requires web content and the controller
|
||||||
|
exampleDatabase;
|
||||||
|
storageDirty = false;
|
||||||
|
|
||||||
|
//%endif
|
||||||
|
async init() {
|
||||||
|
this.controller.handle(PluginExampleEvent, this.handlePluginExampleEvent.bind(this));
|
||||||
|
this.controller.handle(PluginExampleRequest, this.handlePluginExampleRequest.bind(this));
|
||||||
|
//%if controller & web // Subscribing requires web content and the controller
|
||||||
|
this.controller.subscriptions.handle(ExampleSubscribableUpdate, this.handleExampleSubscription.bind(this));
|
||||||
|
this.exampleDatabase = new Map(); // If needed, replace with loading from database file
|
||||||
|
//%endif
|
||||||
|
}
|
||||||
|
|
||||||
|
async onControllerConfigFieldChanged(field, curr, prev) {
|
||||||
|
this.logger.info(`controller::onControllerConfigFieldChanged ${field}`);
|
||||||
|
}
|
||||||
|
//%if instance
|
||||||
|
|
||||||
|
async onInstanceConfigFieldChanged(instance, field, curr, prev) {
|
||||||
|
this.logger.info(`controller::onInstanceConfigFieldChanged ${instance.id} ${field}`);
|
||||||
|
}
|
||||||
|
//%endif
|
||||||
|
|
||||||
|
async onSaveData() {
|
||||||
|
this.logger.info("controller::onSaveData");
|
||||||
|
}
|
||||||
|
|
||||||
|
async onShutdown() {
|
||||||
|
this.logger.info("controller::onShutdown");
|
||||||
|
}
|
||||||
|
|
||||||
|
async onPlayerEvent(instance, event) {
|
||||||
|
this.logger.info(`controller::onPlayerEvent ${instance.id} ${JSON.stringify(event)}`);
|
||||||
|
}
|
||||||
|
|
||||||
|
async handlePluginExampleEvent(event) {
|
||||||
|
this.logger.info(JSON.stringify(event));
|
||||||
|
}
|
||||||
|
|
||||||
|
async handlePluginExampleRequest(request) {
|
||||||
|
this.logger.info(JSON.stringify(request));
|
||||||
|
return {
|
||||||
|
myResponseString: request.myString,
|
||||||
|
myResponseNumbers: request.myNumberArray,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
//%if controller & web // Subscribing requires web content and the controller
|
||||||
|
|
||||||
|
async handleExampleSubscription(request) {
|
||||||
|
const values = [...this.exampleDatabase.values()].filter(
|
||||||
|
value => value.updatedAtMs > request.lastRequestTimeMs,
|
||||||
|
);
|
||||||
|
return values.length ? new ExampleSubscribableUpdate(values) : null;
|
||||||
|
}
|
||||||
|
//%endif
|
||||||
|
}
|
||||||
|
|
||||||
|
module.exports = {
|
||||||
|
ControllerPlugin,
|
||||||
|
};
|
||||||
@@ -0,0 +1,31 @@
|
|||||||
|
"use strict";
|
||||||
|
const { BaseCtlPlugin } = require("@clusterio/ctl");
|
||||||
|
const { CommandTree, Command } = require("@clusterio/lib");
|
||||||
|
const { PluginExampleEvent, PluginExampleRequest } = require("./messages");
|
||||||
|
/* eslint-disable no-console */
|
||||||
|
|
||||||
|
const pluginCommands = new CommandTree({
|
||||||
|
name: "__plugin_name__", description: "The default description I forgot to change",
|
||||||
|
});
|
||||||
|
|
||||||
|
pluginCommands.add(new Command({
|
||||||
|
definition: ["my-command <foo>", "My command description that I really should change", (yargs) => {
|
||||||
|
yargs.positional("foo", { describe: "foo is foo!", type: "string" });
|
||||||
|
}],
|
||||||
|
handler: async function(args, control) {
|
||||||
|
const response = await control.sendTo("controller", new PluginExampleRequest(args.foo, [1, 2, 3]));
|
||||||
|
console.log(response);
|
||||||
|
console.log(args);
|
||||||
|
},
|
||||||
|
}));
|
||||||
|
|
||||||
|
/* eslint-enable no-console */
|
||||||
|
class CtlPlugin extends BaseCtlPlugin {
|
||||||
|
async addCommands(rootCommand) {
|
||||||
|
rootCommand.add(pluginCommands);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
module.exports = {
|
||||||
|
CtlPlugin,
|
||||||
|
};
|
||||||
@@ -0,0 +1,35 @@
|
|||||||
|
"use strict";
|
||||||
|
const lib = require("@clusterio/lib");
|
||||||
|
const { BaseHostPlugin } = require("@clusterio/host");
|
||||||
|
const { PluginExampleEvent, PluginExampleRequest } = require("./messages");
|
||||||
|
|
||||||
|
class HostPlugin extends BaseHostPlugin {
|
||||||
|
async init() {
|
||||||
|
this.host.handle(PluginExampleEvent, this.handlePluginExampleEvent.bind(this));
|
||||||
|
this.host.handle(PluginExampleRequest, this.handlePluginExampleRequest.bind(this));
|
||||||
|
}
|
||||||
|
|
||||||
|
async onHostConfigFieldChanged(field, curr, prev) {
|
||||||
|
this.logger.info(`host::onInstanceConfigFieldChanged ${field}`);
|
||||||
|
}
|
||||||
|
|
||||||
|
async onShutdown() {
|
||||||
|
this.logger.info("host::onShutdown");
|
||||||
|
}
|
||||||
|
|
||||||
|
async handlePluginExampleEvent(event) {
|
||||||
|
this.logger.info(JSON.stringify(event));
|
||||||
|
}
|
||||||
|
|
||||||
|
async handlePluginExampleRequest(request) {
|
||||||
|
this.logger.info(JSON.stringify(request));
|
||||||
|
return {
|
||||||
|
myResponseString: request.myString,
|
||||||
|
myResponseNumbers: request.myNumberArray,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
module.exports = {
|
||||||
|
HostPlugin,
|
||||||
|
};
|
||||||
@@ -0,0 +1,109 @@
|
|||||||
|
"use strict";
|
||||||
|
const lib = require("@clusterio/lib");
|
||||||
|
const Messages = require("./messages");
|
||||||
|
|
||||||
|
lib.definePermission({
|
||||||
|
name: "__plugin_name__.example.permission.event",
|
||||||
|
title: "Example permission event",
|
||||||
|
description: "Example Description. Event. Change me in index.js",
|
||||||
|
});
|
||||||
|
|
||||||
|
lib.definePermission({
|
||||||
|
name: "__plugin_name__.example.permission.request",
|
||||||
|
title: "Example permission request",
|
||||||
|
description: "Example Description. Request. Change me in index.js",
|
||||||
|
});
|
||||||
|
//%if controller & web // Subscribing requires web content and the controller
|
||||||
|
|
||||||
|
lib.definePermission({
|
||||||
|
name: "__plugin_name__.example.permission.subscribe",
|
||||||
|
title: "Example permission subscribe",
|
||||||
|
description: "Example Description. Subscribe. Change me in index.js",
|
||||||
|
});
|
||||||
|
//%endif
|
||||||
|
//%if web
|
||||||
|
|
||||||
|
lib.definePermission({
|
||||||
|
name: "__plugin_name__.page.view",
|
||||||
|
title: "Example page view permission",
|
||||||
|
description: "Example Description. View. Change me in index.js",
|
||||||
|
});
|
||||||
|
//%endif
|
||||||
|
|
||||||
|
const plugin = {
|
||||||
|
name: "__plugin_name__",
|
||||||
|
title: "__plugin_name__",
|
||||||
|
description: "Example Description. Plugin. Change me in index.js",
|
||||||
|
//%if controller
|
||||||
|
|
||||||
|
controllerEntrypoint: "./controller",
|
||||||
|
controllerConfigFields: {
|
||||||
|
"__plugin_name__.myControllerField": {
|
||||||
|
title: "My Controller Field",
|
||||||
|
description: "This should be removed from index.js",
|
||||||
|
type: "string",
|
||||||
|
initialValue: "Remove Me",
|
||||||
|
},
|
||||||
|
},
|
||||||
|
//%endif
|
||||||
|
//%if host
|
||||||
|
|
||||||
|
hostEntrypoint: "./host",
|
||||||
|
hostConfigFields: {
|
||||||
|
"__plugin_name__.myHostField": {
|
||||||
|
title: "My Host Field",
|
||||||
|
description: "This should be removed from index.js",
|
||||||
|
type: "string",
|
||||||
|
initialValue: "Remove Me",
|
||||||
|
},
|
||||||
|
},
|
||||||
|
//%endif
|
||||||
|
//%if instance
|
||||||
|
|
||||||
|
instanceEntrypoint: "./instance",
|
||||||
|
instanceConfigFields: {
|
||||||
|
"__plugin_name__.myInstanceField": {
|
||||||
|
title: "My Instance Field",
|
||||||
|
description: "This should be removed from index.js",
|
||||||
|
type: "string",
|
||||||
|
initialValue: "Remove Me",
|
||||||
|
},
|
||||||
|
},
|
||||||
|
//%endif
|
||||||
|
//%if ctl
|
||||||
|
|
||||||
|
ctlEntrypoint: "./ctl",
|
||||||
|
controlConfigFields: {
|
||||||
|
"__plugin_name__.myControlField": {
|
||||||
|
title: "My Control Field",
|
||||||
|
description: "This should be removed from index.js",
|
||||||
|
type: "string",
|
||||||
|
initialValue: "Remove Me",
|
||||||
|
},
|
||||||
|
},
|
||||||
|
//%endif
|
||||||
|
|
||||||
|
messages: [
|
||||||
|
Messages.PluginExampleEvent,
|
||||||
|
Messages.PluginExampleRequest,
|
||||||
|
//%if controller & web // Subscribing requires web content and the controller
|
||||||
|
Messages.ExampleSubscribableUpdate,
|
||||||
|
//%endif
|
||||||
|
],
|
||||||
|
//%if web // Web content template has an example route which is the plugin name
|
||||||
|
|
||||||
|
webEntrypoint: "./web",
|
||||||
|
routes: [
|
||||||
|
"/__plugin_name__",
|
||||||
|
],
|
||||||
|
//%endif
|
||||||
|
//%if controller & !web // The controller always includes web entry even if there is no content
|
||||||
|
|
||||||
|
webEntrypoint: "./web",
|
||||||
|
routes: [],
|
||||||
|
//%endif
|
||||||
|
};
|
||||||
|
|
||||||
|
module.exports = {
|
||||||
|
plugin,
|
||||||
|
};
|
||||||
@@ -0,0 +1,55 @@
|
|||||||
|
"use strict";
|
||||||
|
const lib = require("@clusterio/lib");
|
||||||
|
const { BaseInstancePlugin } = require("@clusterio/host");
|
||||||
|
const { PluginExampleEvent, PluginExampleRequest } = require("./messages");
|
||||||
|
|
||||||
|
class InstancePlugin extends BaseInstancePlugin {
|
||||||
|
async init() {
|
||||||
|
this.instance.handle(PluginExampleEvent, this.handlePluginExampleEvent.bind(this));
|
||||||
|
this.instance.handle(PluginExampleRequest, this.handlePluginExampleRequest.bind(this));
|
||||||
|
//%if module
|
||||||
|
this.instance.server.handle("__plugin_name__-plugin_example_ipc", this.handlePluginExampleIPC.bind(this));
|
||||||
|
//%endif
|
||||||
|
}
|
||||||
|
|
||||||
|
async onInstanceConfigFieldChanged(field, curr, prev) {
|
||||||
|
this.logger.info(`instance::onInstanceConfigFieldChanged ${field}`);
|
||||||
|
}
|
||||||
|
|
||||||
|
async onStart() {
|
||||||
|
this.logger.info("instance::onStart");
|
||||||
|
}
|
||||||
|
|
||||||
|
async onStop() {
|
||||||
|
this.logger.info("instance::onStop");
|
||||||
|
}
|
||||||
|
|
||||||
|
async onPlayerEvent(event) {
|
||||||
|
this.logger.info(`onPlayerEvent::onPlayerEvent ${JSON.stringify(event)}`);
|
||||||
|
}
|
||||||
|
|
||||||
|
async handlePluginExampleEvent(event) {
|
||||||
|
this.logger.info(JSON.stringify(event));
|
||||||
|
//%if module
|
||||||
|
this.sendRcon("/sc __plugin_name__.foo()");
|
||||||
|
//%endif
|
||||||
|
}
|
||||||
|
|
||||||
|
async handlePluginExampleRequest(request) {
|
||||||
|
this.logger.info(JSON.stringify(request));
|
||||||
|
return {
|
||||||
|
myResponseString: request.myString,
|
||||||
|
myResponseNumbers: request.myNumberArray,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
//%if module
|
||||||
|
|
||||||
|
async handlePluginExampleIPC(event) {
|
||||||
|
this.logger.info(JSON.stringify(event));
|
||||||
|
}
|
||||||
|
//%endif
|
||||||
|
}
|
||||||
|
|
||||||
|
module.exports = {
|
||||||
|
InstancePlugin,
|
||||||
|
};
|
||||||
@@ -0,0 +1,101 @@
|
|||||||
|
"use strict";
|
||||||
|
const { plainJson, jsonArray, JsonBoolean, JsonNumber, JsonString, StringEnum } = require("@clusterio/lib");
|
||||||
|
const { Type } = require("@sinclair/typebox");
|
||||||
|
|
||||||
|
class PluginExampleEvent {
|
||||||
|
static type = "event";
|
||||||
|
static src = ["host", "control"];
|
||||||
|
static dst = ["controller", "host", "instance"];
|
||||||
|
static plugin = "__plugin_name__";
|
||||||
|
static permission = "__plugin_name__.example.permission.event";
|
||||||
|
|
||||||
|
constructor(myString, myNumberArray) {
|
||||||
|
this.myString = myString;
|
||||||
|
this.myNumberArray = myNumberArray;
|
||||||
|
}
|
||||||
|
|
||||||
|
static jsonSchema = Type.Object({
|
||||||
|
"myString": Type.String(),
|
||||||
|
"myNumberArray": Type.Array(Type.Number()),
|
||||||
|
});
|
||||||
|
|
||||||
|
static fromJSON(json) {
|
||||||
|
return new PluginExampleEvent(json.myString, json.myNumberArray);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
class PluginExampleRequest {
|
||||||
|
static type = "request";
|
||||||
|
static src = ["host", "control"];
|
||||||
|
static dst = ["controller", "host", "instance"];
|
||||||
|
static plugin = "__plugin_name__";
|
||||||
|
static permission = "__plugin_name__.example.permission.request";
|
||||||
|
|
||||||
|
constructor(myString, myNumberArray) {
|
||||||
|
this.myString = myString;
|
||||||
|
this.myNumberArray = myNumberArray;
|
||||||
|
}
|
||||||
|
|
||||||
|
static jsonSchema = Type.Object({
|
||||||
|
"myString": Type.String(),
|
||||||
|
"myNumberArray": Type.Array(Type.Number()),
|
||||||
|
});
|
||||||
|
|
||||||
|
static fromJSON(json) {
|
||||||
|
return new PluginExampleRequest(json.myString, json.myNumberArray);
|
||||||
|
}
|
||||||
|
|
||||||
|
static Response = plainJson(Type.Object({
|
||||||
|
"myResponseString": Type.String(),
|
||||||
|
"myResponseNumbers": Type.Array(Type.Number()),
|
||||||
|
}));
|
||||||
|
}
|
||||||
|
//%if controller & web // Subscribing requires web content and the controller
|
||||||
|
|
||||||
|
class ExampleSubscribableValue {
|
||||||
|
constructor(id, updatedAtMs, isDeleted) {
|
||||||
|
this.id = id;
|
||||||
|
this.updatedAtMs = updatedAtMs;
|
||||||
|
this.isDeleted = isDeleted;
|
||||||
|
}
|
||||||
|
|
||||||
|
static jsonSchema = Type.Object({
|
||||||
|
id: Type.String(),
|
||||||
|
updatedAtMs: Type.Number(),
|
||||||
|
isDeleted: Type.Boolean(),
|
||||||
|
});
|
||||||
|
|
||||||
|
static fromJSON(json) {
|
||||||
|
return new this(json.id, json.updatedAtMs, json.isDeleted);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
class ExampleSubscribableUpdate {
|
||||||
|
static type = "event";
|
||||||
|
static src = "controller";
|
||||||
|
static dst = "control";
|
||||||
|
static plugin = "__plugin_name__";
|
||||||
|
static permission = "__plugin_name__.example.permission.subscribe";
|
||||||
|
|
||||||
|
constructor(updates) {
|
||||||
|
this.updates = updates;
|
||||||
|
}
|
||||||
|
|
||||||
|
static jsonSchema = Type.Object({
|
||||||
|
"updates": Type.Array(ExampleSubscribableValue.jsonSchema),
|
||||||
|
});
|
||||||
|
|
||||||
|
static fromJSON(json) {
|
||||||
|
return new this(json.updates.map(update => ExampleSubscribableValue.fromJSON(update)));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
//%endif
|
||||||
|
|
||||||
|
module.exports = {
|
||||||
|
PluginExampleEvent,
|
||||||
|
PluginExampleRequest,
|
||||||
|
//%if controller & web // Subscribing requires web content and the controller
|
||||||
|
ExampleSubscribableValue,
|
||||||
|
ExampleSubscribableUpdate,
|
||||||
|
//%endif
|
||||||
|
};
|
||||||
Whitespace-only changes.
@@ -0,0 +1,78 @@
|
|||||||
|
import React, {
|
||||||
|
useContext, useEffect, useState,
|
||||||
|
//%if controller & web // Subscribing requires web content and the controller
|
||||||
|
useCallback, useSyncExternalStore,
|
||||||
|
//%endif
|
||||||
|
} from "react";
|
||||||
|
|
||||||
|
// import {
|
||||||
|
//
|
||||||
|
// } from "antd";
|
||||||
|
|
||||||
|
import {
|
||||||
|
BaseWebPlugin, PageLayout, Control, ControlContext, notifyErrorHandler,
|
||||||
|
} from "@clusterio/web_ui";
|
||||||
|
|
||||||
|
import {
|
||||||
|
PluginExampleEvent, PluginExampleRequest,
|
||||||
|
//%if controller & web // Subscribing requires web content and the controller
|
||||||
|
ExampleSubscribableUpdate,
|
||||||
|
//%endif
|
||||||
|
} from "../messages";
|
||||||
|
|
||||||
|
import * as lib from "@clusterio/lib";
|
||||||
|
|
||||||
|
function MyTemplatePage() {
|
||||||
|
let control = useContext(ControlContext);
|
||||||
|
//%if controller & web // Subscribing requires web content and the controller
|
||||||
|
const plugin = control.plugins.get("__plugin_name__");
|
||||||
|
const [subscribableData, synced] = plugin.useSubscribableData();
|
||||||
|
//%endif
|
||||||
|
|
||||||
|
return <PageLayout nav={[{ name: "__plugin_name__" }]}>
|
||||||
|
<h2>__plugin_name__</h2>
|
||||||
|
//%if controller & web // Subscribing requires web content and the controller
|
||||||
|
Synced: {String(synced)} Data: {JSON.stringify([...subscribableData.values()])}
|
||||||
|
//%endif
|
||||||
|
</PageLayout>;
|
||||||
|
}
|
||||||
|
|
||||||
|
export class WebPlugin extends BaseWebPlugin {
|
||||||
|
//%if controller & web // Subscribing requires web content and the controller
|
||||||
|
subscribableData = new lib.EventSubscriber(ExampleSubscribableUpdate, this.control);
|
||||||
|
|
||||||
|
//%endif
|
||||||
|
async init() {
|
||||||
|
this.pages = [
|
||||||
|
{
|
||||||
|
path: "/__plugin_name__",
|
||||||
|
sidebarName: "__plugin_name__",
|
||||||
|
permission: "__plugin_name__.page.view",
|
||||||
|
content: <MyTemplatePage/>,
|
||||||
|
},
|
||||||
|
];
|
||||||
|
|
||||||
|
this.control.handle(PluginExampleEvent, this.handlePluginExampleEvent.bind(this));
|
||||||
|
this.control.handle(PluginExampleRequest, this.handlePluginExampleRequest.bind(this));
|
||||||
|
}
|
||||||
|
//%if controller & web // Subscribing requires web content and the controller
|
||||||
|
|
||||||
|
useSubscribableData() {
|
||||||
|
const control = useContext(ControlContext);
|
||||||
|
const subscribe = useCallback((callback) => this.subscribableData.subscribe(callback), [control]);
|
||||||
|
return useSyncExternalStore(subscribe, () => this.subscribableData.getSnapshot());
|
||||||
|
}
|
||||||
|
//%endif
|
||||||
|
|
||||||
|
async handlePluginExampleEvent(event) {
|
||||||
|
this.logger.info(JSON.stringify(event));
|
||||||
|
}
|
||||||
|
|
||||||
|
async handlePluginExampleRequest(request) {
|
||||||
|
this.logger.info(JSON.stringify(request));
|
||||||
|
return {
|
||||||
|
myResponseString: request.myString,
|
||||||
|
myResponseNumbers: request.myNumberArray,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,68 @@
|
|||||||
|
import * as lib from "@clusterio/lib";
|
||||||
|
import { BaseControllerPlugin, InstanceInfo } from "@clusterio/controller";
|
||||||
|
|
||||||
|
import {
|
||||||
|
PluginExampleEvent, PluginExampleRequest,
|
||||||
|
//%if controller & web // Subscribing requires web content and the controller
|
||||||
|
ExampleSubscribableUpdate, ExampleSubscribableValue,
|
||||||
|
//%endif
|
||||||
|
} from "./messages";
|
||||||
|
|
||||||
|
export class ControllerPlugin extends BaseControllerPlugin {
|
||||||
|
//%if controller & web // Subscribing requires web content and the controller
|
||||||
|
exampleDatabase!: Map<string, ExampleSubscribableValue>;
|
||||||
|
storageDirty = false;
|
||||||
|
|
||||||
|
//%endif
|
||||||
|
async init() {
|
||||||
|
this.controller.handle(PluginExampleEvent, this.handlePluginExampleEvent.bind(this));
|
||||||
|
this.controller.handle(PluginExampleRequest, this.handlePluginExampleRequest.bind(this));
|
||||||
|
//%if controller & web // Subscribing requires web content and the controller
|
||||||
|
this.controller.subscriptions.handle(ExampleSubscribableUpdate, this.handleExampleSubscription.bind(this));
|
||||||
|
this.exampleDatabase = new Map(); // If needed, replace with loading from database file
|
||||||
|
//%endif
|
||||||
|
}
|
||||||
|
|
||||||
|
async onControllerConfigFieldChanged(field: string, curr: unknown, prev: unknown) {
|
||||||
|
this.logger.info(`controller::onControllerConfigFieldChanged ${field}`);
|
||||||
|
}
|
||||||
|
//%if instance
|
||||||
|
|
||||||
|
async onInstanceConfigFieldChanged(instance: InstanceInfo, field: string, curr: unknown, prev: unknown) {
|
||||||
|
this.logger.info(`controller::onInstanceConfigFieldChanged ${instance.id} ${field}`);
|
||||||
|
}
|
||||||
|
//%endif
|
||||||
|
|
||||||
|
async onSaveData() {
|
||||||
|
this.logger.info("controller::onSaveData");
|
||||||
|
}
|
||||||
|
|
||||||
|
async onShutdown() {
|
||||||
|
this.logger.info("controller::onShutdown");
|
||||||
|
}
|
||||||
|
|
||||||
|
async onPlayerEvent(instance: InstanceInfo, event: lib.PlayerEvent) {
|
||||||
|
this.logger.info(`controller::onPlayerEvent ${instance.id} ${JSON.stringify(event)}`);
|
||||||
|
}
|
||||||
|
|
||||||
|
async handlePluginExampleEvent(event: PluginExampleEvent) {
|
||||||
|
this.logger.info(JSON.stringify(event));
|
||||||
|
}
|
||||||
|
|
||||||
|
async handlePluginExampleRequest(request: PluginExampleRequest) {
|
||||||
|
this.logger.info(JSON.stringify(request));
|
||||||
|
return {
|
||||||
|
myResponseString: request.myString,
|
||||||
|
myResponseNumbers: request.myNumberArray,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
//%if controller & web // Subscribing requires web content and the controller
|
||||||
|
|
||||||
|
async handleExampleSubscription(request: lib.SubscriptionRequest) {
|
||||||
|
const values = [...this.exampleDatabase.values()].filter(
|
||||||
|
value => value.updatedAtMs > request.lastRequestTimeMs,
|
||||||
|
);
|
||||||
|
return values.length ? new ExampleSubscribableUpdate(values) : null;
|
||||||
|
}
|
||||||
|
//%endif
|
||||||
|
}
|
||||||
@@ -0,0 +1,27 @@
|
|||||||
|
type Control = any; // import type { Control } from "@clusterio/ctl";
|
||||||
|
import { BaseCtlPlugin } from "@clusterio/ctl";
|
||||||
|
import { CommandTree, Command } from "@clusterio/lib";
|
||||||
|
import { PluginExampleEvent, PluginExampleRequest } from "./messages";
|
||||||
|
/* eslint-disable no-console */
|
||||||
|
|
||||||
|
const pluginCommands = new CommandTree({
|
||||||
|
name: "__plugin_name__", description: "The default description I forgot to change",
|
||||||
|
});
|
||||||
|
|
||||||
|
pluginCommands.add(new Command({
|
||||||
|
definition: ["my-command <foo>", "My command description that I really should change", (yargs) => {
|
||||||
|
yargs.positional("foo", { describe: "foo is foo!", type: "string" });
|
||||||
|
}],
|
||||||
|
handler: async function(args: { foo: string }, control: Control) {
|
||||||
|
const response = await control.sendTo("controller", new PluginExampleRequest(args.foo, [1, 2, 3]));
|
||||||
|
console.log(response);
|
||||||
|
console.log(args);
|
||||||
|
},
|
||||||
|
}));
|
||||||
|
|
||||||
|
/* eslint-enable no-console */
|
||||||
|
export class CtlPlugin extends BaseCtlPlugin {
|
||||||
|
async addCommands(rootCommand: CommandTree) {
|
||||||
|
rootCommand.add(pluginCommands);
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,30 @@
|
|||||||
|
import * as lib from "@clusterio/lib";
|
||||||
|
import { BaseHostPlugin } from "@clusterio/host";
|
||||||
|
import { PluginExampleEvent, PluginExampleRequest } from "./messages";
|
||||||
|
|
||||||
|
export class HostPlugin extends BaseHostPlugin {
|
||||||
|
async init() {
|
||||||
|
this.host.handle(PluginExampleEvent, this.handlePluginExampleEvent.bind(this));
|
||||||
|
this.host.handle(PluginExampleRequest, this.handlePluginExampleRequest.bind(this));
|
||||||
|
}
|
||||||
|
|
||||||
|
async onHostConfigFieldChanged(field: string, curr: unknown, prev: unknown) {
|
||||||
|
this.logger.info(`host::onInstanceConfigFieldChanged ${field}`);
|
||||||
|
}
|
||||||
|
|
||||||
|
async onShutdown() {
|
||||||
|
this.logger.info("host::onShutdown");
|
||||||
|
}
|
||||||
|
|
||||||
|
async handlePluginExampleEvent(event: PluginExampleEvent) {
|
||||||
|
this.logger.info(JSON.stringify(event));
|
||||||
|
}
|
||||||
|
|
||||||
|
async handlePluginExampleRequest(request: PluginExampleRequest) {
|
||||||
|
this.logger.info(JSON.stringify(request));
|
||||||
|
return {
|
||||||
|
myResponseString: request.myString,
|
||||||
|
myResponseNumbers: request.myNumberArray,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,127 @@
|
|||||||
|
import * as lib from "@clusterio/lib";
|
||||||
|
import * as Messages from "./messages";
|
||||||
|
|
||||||
|
lib.definePermission({
|
||||||
|
name: "__plugin_name__.example.permission.event",
|
||||||
|
title: "Example permission event",
|
||||||
|
description: "Example Description. Event. Change me in index.ts",
|
||||||
|
});
|
||||||
|
|
||||||
|
lib.definePermission({
|
||||||
|
name: "__plugin_name__.example.permission.request",
|
||||||
|
title: "Example permission request",
|
||||||
|
description: "Example Description. Request. Change me in index.ts",
|
||||||
|
});
|
||||||
|
//%if controller & web // Subscribing requires web content and the controller
|
||||||
|
|
||||||
|
lib.definePermission({
|
||||||
|
name: "__plugin_name__.example.permission.subscribe",
|
||||||
|
title: "Example permission subscribe",
|
||||||
|
description: "Example Description. Subscribe. Change me in index.ts",
|
||||||
|
});
|
||||||
|
//%endif
|
||||||
|
//%if web
|
||||||
|
|
||||||
|
lib.definePermission({
|
||||||
|
name: "__plugin_name__.page.view",
|
||||||
|
title: "Example page view permission",
|
||||||
|
description: "Example Description. View. Change me in index.ts",
|
||||||
|
});
|
||||||
|
//%endif
|
||||||
|
|
||||||
|
declare module "@clusterio/lib" {
|
||||||
|
//%if controller
|
||||||
|
export interface ControllerConfigFields {
|
||||||
|
"__plugin_name__.myControllerField": string;
|
||||||
|
}
|
||||||
|
//%endif
|
||||||
|
//%if host
|
||||||
|
export interface HostConfigFields {
|
||||||
|
"__plugin_name__.myHostField": string;
|
||||||
|
}
|
||||||
|
//%endif
|
||||||
|
//%if instance
|
||||||
|
export interface InstanceConfigFields {
|
||||||
|
"__plugin_name__.myInstanceField": string;
|
||||||
|
}
|
||||||
|
//%endif
|
||||||
|
//%if ctl
|
||||||
|
export interface ControlConfigFields {
|
||||||
|
"__plugin_name__.myControlField": string;
|
||||||
|
}
|
||||||
|
//%endif
|
||||||
|
}
|
||||||
|
|
||||||
|
export const plugin: lib.PluginDeclaration = {
|
||||||
|
name: "__plugin_name__",
|
||||||
|
title: "__plugin_name__",
|
||||||
|
description: "Example Description. Plugin. Change me in index.ts",
|
||||||
|
//%if controller
|
||||||
|
|
||||||
|
controllerEntrypoint: "./dist/node/controller",
|
||||||
|
controllerConfigFields: {
|
||||||
|
"__plugin_name__.myControllerField": {
|
||||||
|
title: "My Controller Field",
|
||||||
|
description: "This should be removed from index.js",
|
||||||
|
type: "string",
|
||||||
|
initialValue: "Remove Me",
|
||||||
|
},
|
||||||
|
},
|
||||||
|
//%endif
|
||||||
|
//%if host
|
||||||
|
|
||||||
|
hostEntrypoint: "./dist/node/host",
|
||||||
|
hostConfigFields: {
|
||||||
|
"__plugin_name__.myHostField": {
|
||||||
|
title: "My Host Field",
|
||||||
|
description: "This should be removed from index.js",
|
||||||
|
type: "string",
|
||||||
|
initialValue: "Remove Me",
|
||||||
|
},
|
||||||
|
},
|
||||||
|
//%endif
|
||||||
|
//%if instance
|
||||||
|
|
||||||
|
instanceEntrypoint: "./dist/node/instance",
|
||||||
|
instanceConfigFields: {
|
||||||
|
"__plugin_name__.myInstanceField": {
|
||||||
|
title: "My Instance Field",
|
||||||
|
description: "This should be removed from index.js",
|
||||||
|
type: "string",
|
||||||
|
initialValue: "Remove Me",
|
||||||
|
},
|
||||||
|
},
|
||||||
|
//%endif
|
||||||
|
//%if ctl
|
||||||
|
|
||||||
|
ctlEntrypoint: "./dist/node/ctl",
|
||||||
|
controlConfigFields: {
|
||||||
|
"__plugin_name__.myControlField": {
|
||||||
|
title: "My Control Field",
|
||||||
|
description: "This should be removed from index.js",
|
||||||
|
type: "string",
|
||||||
|
initialValue: "Remove Me",
|
||||||
|
},
|
||||||
|
},
|
||||||
|
//%endif
|
||||||
|
|
||||||
|
messages: [
|
||||||
|
Messages.PluginExampleEvent,
|
||||||
|
Messages.PluginExampleRequest,
|
||||||
|
//%if controller & web // Subscribing requires web content and the controller
|
||||||
|
Messages.ExampleSubscribableUpdate,
|
||||||
|
//%endif
|
||||||
|
],
|
||||||
|
//%if web // Web content template has an example route which is the plugin name
|
||||||
|
|
||||||
|
webEntrypoint: "./web",
|
||||||
|
routes: [
|
||||||
|
"/__plugin_name__",
|
||||||
|
],
|
||||||
|
//%endif
|
||||||
|
//%if controller & !web // The controller always includes web entry even if there is no content
|
||||||
|
|
||||||
|
webEntrypoint: "./web",
|
||||||
|
routes: [],
|
||||||
|
//%endif
|
||||||
|
};
|
||||||
@@ -0,0 +1,57 @@
|
|||||||
|
import * as lib from "@clusterio/lib";
|
||||||
|
import { BaseInstancePlugin } from "@clusterio/host";
|
||||||
|
import { PluginExampleEvent, PluginExampleRequest } from "./messages";
|
||||||
|
//%if module
|
||||||
|
|
||||||
|
type PuginExampleIPC = {
|
||||||
|
tick: number,
|
||||||
|
player_name: string,
|
||||||
|
};
|
||||||
|
//%endif
|
||||||
|
|
||||||
|
export class InstancePlugin extends BaseInstancePlugin {
|
||||||
|
async init() {
|
||||||
|
this.instance.handle(PluginExampleEvent, this.handlePluginExampleEvent.bind(this));
|
||||||
|
this.instance.handle(PluginExampleRequest, this.handlePluginExampleRequest.bind(this));
|
||||||
|
//%if module
|
||||||
|
this.instance.server.handle("__plugin_name__-plugin_example_ipc", this.handlePluginExampleIPC.bind(this));
|
||||||
|
//%endif
|
||||||
|
}
|
||||||
|
|
||||||
|
async onInstanceConfigFieldChanged(field: string, curr: unknown, prev: unknown) {
|
||||||
|
this.logger.info(`instance::onInstanceConfigFieldChanged ${field}`);
|
||||||
|
}
|
||||||
|
|
||||||
|
async onStart() {
|
||||||
|
this.logger.info("instance::onStart");
|
||||||
|
}
|
||||||
|
|
||||||
|
async onStop() {
|
||||||
|
this.logger.info("instance::onStop");
|
||||||
|
}
|
||||||
|
|
||||||
|
async onPlayerEvent(event: lib.PlayerEvent) {
|
||||||
|
this.logger.info(`onPlayerEvent::onPlayerEvent ${JSON.stringify(event)}`);
|
||||||
|
//%if module
|
||||||
|
this.sendRcon("/sc __plugin_name__.foo()");
|
||||||
|
//%endif
|
||||||
|
}
|
||||||
|
|
||||||
|
async handlePluginExampleEvent(event: PluginExampleEvent) {
|
||||||
|
this.logger.info(JSON.stringify(event));
|
||||||
|
}
|
||||||
|
|
||||||
|
async handlePluginExampleRequest(request: PluginExampleRequest) {
|
||||||
|
this.logger.info(JSON.stringify(request));
|
||||||
|
return {
|
||||||
|
myResponseString: request.myString,
|
||||||
|
myResponseNumbers: request.myNumberArray,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
//%if module
|
||||||
|
|
||||||
|
async handlePluginExampleIPC(event: PuginExampleIPC) {
|
||||||
|
this.logger.info(JSON.stringify(event));
|
||||||
|
}
|
||||||
|
//%endif
|
||||||
|
}
|
||||||
@@ -0,0 +1,97 @@
|
|||||||
|
import { plainJson, jsonArray, JsonBoolean, JsonNumber, JsonString, StringEnum } from "@clusterio/lib";
|
||||||
|
import { Type, Static } from "@sinclair/typebox";
|
||||||
|
|
||||||
|
export class PluginExampleEvent {
|
||||||
|
declare ["constructor"]: typeof PluginExampleEvent;
|
||||||
|
static type = "event" as const;
|
||||||
|
static src = ["host", "control"] as const;
|
||||||
|
static dst = ["controller", "host", "instance"] as const;
|
||||||
|
static plugin = "__plugin_name__" as const;
|
||||||
|
static permission = "__plugin_name__.example.permission.event";
|
||||||
|
|
||||||
|
constructor(
|
||||||
|
public myString: string,
|
||||||
|
public myNumberArray: number[],
|
||||||
|
) {
|
||||||
|
}
|
||||||
|
|
||||||
|
static jsonSchema = Type.Object({
|
||||||
|
"myString": Type.String(),
|
||||||
|
"myNumberArray": Type.Array(Type.Number()),
|
||||||
|
});
|
||||||
|
|
||||||
|
static fromJSON(json: Static<typeof PluginExampleEvent.jsonSchema>) {
|
||||||
|
return new PluginExampleEvent(json.myString, json.myNumberArray);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
export class PluginExampleRequest {
|
||||||
|
declare ["constructor"]: typeof PluginExampleRequest;
|
||||||
|
static type = "request" as const;
|
||||||
|
static src = ["host", "control"] as const;
|
||||||
|
static dst = ["controller", "host", "instance"] as const;
|
||||||
|
static plugin = "__plugin_name__" as const;
|
||||||
|
static permission = "__plugin_name__.example.permission.request";
|
||||||
|
|
||||||
|
constructor(
|
||||||
|
public myString: string,
|
||||||
|
public myNumberArray: number[],
|
||||||
|
) {
|
||||||
|
}
|
||||||
|
|
||||||
|
static jsonSchema = Type.Object({
|
||||||
|
"myString": Type.String(),
|
||||||
|
"myNumberArray": Type.Array(Type.Number()),
|
||||||
|
});
|
||||||
|
|
||||||
|
static fromJSON(json: Static<typeof PluginExampleRequest.jsonSchema>) {
|
||||||
|
return new PluginExampleRequest(json.myString, json.myNumberArray);
|
||||||
|
}
|
||||||
|
|
||||||
|
static Response = plainJson(Type.Object({
|
||||||
|
"myResponseString": Type.String(),
|
||||||
|
"myResponseNumbers": Type.Array(Type.Number()),
|
||||||
|
}));
|
||||||
|
}
|
||||||
|
//%if controller & web // Subscribing requires web content and the controller
|
||||||
|
|
||||||
|
export class ExampleSubscribableValue {
|
||||||
|
constructor(
|
||||||
|
public id: string,
|
||||||
|
public updatedAtMs: number,
|
||||||
|
public isDeleted: boolean,
|
||||||
|
) {
|
||||||
|
}
|
||||||
|
|
||||||
|
static jsonSchema = Type.Object({
|
||||||
|
id: Type.String(),
|
||||||
|
updatedAtMs: Type.Number(),
|
||||||
|
isDeleted: Type.Boolean(),
|
||||||
|
});
|
||||||
|
|
||||||
|
static fromJSON(json: Static<typeof this.jsonSchema>) {
|
||||||
|
return new this(json.id, json.updatedAtMs, json.isDeleted);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
export class ExampleSubscribableUpdate {
|
||||||
|
declare ["constructor"]: typeof ExampleSubscribableUpdate;
|
||||||
|
static type = "event" as const;
|
||||||
|
static src = "controller" as const;
|
||||||
|
static dst = "control" as const;
|
||||||
|
static plugin = "__plugin_name__" as const;
|
||||||
|
static permission = "__plugin_name__.example.permission.subscribe";
|
||||||
|
|
||||||
|
constructor(
|
||||||
|
public updates: ExampleSubscribableValue[],
|
||||||
|
) { }
|
||||||
|
|
||||||
|
static jsonSchema = Type.Object({
|
||||||
|
"updates": Type.Array(ExampleSubscribableValue.jsonSchema),
|
||||||
|
});
|
||||||
|
|
||||||
|
static fromJSON(json: Static<typeof this.jsonSchema>) {
|
||||||
|
return new this(json.updates.map(update => ExampleSubscribableValue.fromJSON(update)));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
//%endif
|
||||||
@@ -0,0 +1,11 @@
|
|||||||
|
{
|
||||||
|
"extends": "../../tsconfig.browser.json",
|
||||||
|
"references": [
|
||||||
|
{ "path": "../../packages/lib/tsconfig.browser.json" },
|
||||||
|
{ "path": "../../packages/web_ui/tsconfig.browser.json" },
|
||||||
|
],
|
||||||
|
"include": [ "web/**/*.tsx", "web/**/*.ts", "messages.ts", "package.json" ],
|
||||||
|
"compilerOptions": {
|
||||||
|
"outDir": "dist/browser",
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,9 @@
|
|||||||
|
{
|
||||||
|
"files": [],
|
||||||
|
"references": [
|
||||||
|
//%if web
|
||||||
|
{ "path": "./tsconfig.browser.json" },
|
||||||
|
//%endif
|
||||||
|
{ "path": "./tsconfig.node.json" }
|
||||||
|
]
|
||||||
|
}
|
||||||
@@ -0,0 +1,11 @@
|
|||||||
|
{
|
||||||
|
"extends": "../../tsconfig.node.json",
|
||||||
|
"references": [
|
||||||
|
{ "path": "../../packages/lib/tsconfig.node.json" },
|
||||||
|
],
|
||||||
|
"include": ["./**/*.ts"],
|
||||||
|
"exclude": ["test/*", "./dist/*"],
|
||||||
|
"compilerOptions": {
|
||||||
|
"outDir": "dist/node",
|
||||||
|
},
|
||||||
|
}
|
||||||
Whitespace-only changes.
@@ -0,0 +1,85 @@
|
|||||||
|
import React, {
|
||||||
|
useContext, useEffect, useState,
|
||||||
|
//%if controller & web // Subscribing requires web content and the controller
|
||||||
|
useCallback, useSyncExternalStore,
|
||||||
|
//%endif
|
||||||
|
} from "react";
|
||||||
|
|
||||||
|
// import {
|
||||||
|
//
|
||||||
|
// } from "antd";
|
||||||
|
|
||||||
|
import {
|
||||||
|
BaseWebPlugin, PageLayout, Control, ControlContext, notifyErrorHandler,
|
||||||
|
} from "@clusterio/web_ui";
|
||||||
|
|
||||||
|
import {
|
||||||
|
PluginExampleEvent, PluginExampleRequest,
|
||||||
|
//%if controller & web // Subscribing requires web content and the controller
|
||||||
|
ExampleSubscribableUpdate,
|
||||||
|
//%endif
|
||||||
|
} from "../messages";
|
||||||
|
|
||||||
|
import * as lib from "@clusterio/lib";
|
||||||
|
|
||||||
|
function MyTemplatePage() {
|
||||||
|
const control = useContext(ControlContext);
|
||||||
|
//%if controller & web // Subscribing requires web content and the controller
|
||||||
|
const plugin = control.plugins.get("__plugin_name__") as WebPlugin;
|
||||||
|
const [subscribableData, synced] = plugin.useSubscribableData();
|
||||||
|
//%endif
|
||||||
|
|
||||||
|
return <PageLayout nav={[{ name: "__plugin_name__" }]}>
|
||||||
|
<h2>__plugin_name__</h2>
|
||||||
|
//%if controller & web // Subscribing requires web content and the controller
|
||||||
|
Synced: {String(synced)} Data: {JSON.stringify([...subscribableData.values()])}
|
||||||
|
//%endif
|
||||||
|
</PageLayout>;
|
||||||
|
}
|
||||||
|
|
||||||
|
export class WebPlugin extends BaseWebPlugin {
|
||||||
|
//%if controller & web // Subscribing requires web content and the controller
|
||||||
|
subscribableData = new lib.EventSubscriber(ExampleSubscribableUpdate, this.control);
|
||||||
|
|
||||||
|
//%endif
|
||||||
|
async init() {
|
||||||
|
this.pages = [
|
||||||
|
{
|
||||||
|
path: "/__plugin_name__",
|
||||||
|
sidebarName: "__plugin_name__",
|
||||||
|
// This permission is client side only, so it must match the permission string of a resource request to be secure
|
||||||
|
// An undefined value means that the page will always be visible
|
||||||
|
//%if controller & web // Subscribing requires web content and the controller
|
||||||
|
permission: "__plugin_name__.example.permission.subscribe",
|
||||||
|
//%endif
|
||||||
|
//%if !controller | !web
|
||||||
|
permission: undefined, // "__plugin_name__.example.permission.request",
|
||||||
|
//%endif
|
||||||
|
content: <MyTemplatePage/>,
|
||||||
|
},
|
||||||
|
];
|
||||||
|
|
||||||
|
this.control.handle(PluginExampleEvent, this.handlePluginExampleEvent.bind(this));
|
||||||
|
this.control.handle(PluginExampleRequest, this.handlePluginExampleRequest.bind(this));
|
||||||
|
}
|
||||||
|
//%if controller & web // Subscribing requires web content and the controller
|
||||||
|
|
||||||
|
useSubscribableData() {
|
||||||
|
const control = useContext(ControlContext);
|
||||||
|
const subscribe = useCallback((callback: () => void) => this.subscribableData.subscribe(callback), [control]);
|
||||||
|
return useSyncExternalStore(subscribe, () => this.subscribableData.getSnapshot());
|
||||||
|
}
|
||||||
|
//%endif
|
||||||
|
|
||||||
|
async handlePluginExampleEvent(event: PluginExampleEvent) {
|
||||||
|
this.logger.info(JSON.stringify(event));
|
||||||
|
}
|
||||||
|
|
||||||
|
async handlePluginExampleRequest(request: PluginExampleRequest) {
|
||||||
|
this.logger.info(JSON.stringify(request));
|
||||||
|
return {
|
||||||
|
myResponseString: request.myString,
|
||||||
|
myResponseNumbers: request.myNumberArray,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,114 @@
|
|||||||
|
# Templates
|
||||||
|
|
||||||
|
Create has the ability to create new plugins from templates to avoid needing to manually copy lots of boiler plate. This folder contains all those templates for both Javascript and Typescript plugins. These templates have custom preprocessor instructions that can be used to alter a template based on developer input, this syntax is described below.
|
||||||
|
|
||||||
|
- [The Basics](#the-basics)
|
||||||
|
- [Insert Instruction](#insert-instruction) (`__variable__`)
|
||||||
|
- [Conditional Instruction](#conditional-instruction) (`//%if` `//%endif`)
|
||||||
|
- [Available Variables](#available-variables)
|
||||||
|
|
||||||
|
## The Basics
|
||||||
|
|
||||||
|
All files can contain preprocessor instructions whether json, js, lua, or anything else. All instructions use the same syntax although it has been designed to work well with js and ts files.
|
||||||
|
|
||||||
|
Except for the insert instruction, all preprocessors use a `//%` prefix and must be on their own line. These lines are never included in the output. Parsing is stopped when `//` is encountered to allow for comments on preprocessors. Eg. `//%if foo // this is a comment`.
|
||||||
|
|
||||||
|
Empty instructions, aka just comments, can be inserted into templates using `//%//` and are not included in the output file.
|
||||||
|
|
||||||
|
`templates/plugin-js` contains all the files which will be used by a javascript only plugin.
|
||||||
|
`templates/plugin-ts` contains all the files which will be used by a plugin that supports typescript.
|
||||||
|
`templates/common` contains files used by both types of plugins, this is mostly lua code or root files like `package.json`
|
||||||
|
|
||||||
|
Files are not copied via wildcards and instead are explicitly listed within `template.js` so any new templates will need to be added there.
|
||||||
|
|
||||||
|
## Insert Instruction
|
||||||
|
|
||||||
|
There are a number of template variables available to be inserted into templates. All variables are raw string values, that is they are inserted directly into the output file without any modifications. To signify a place to insert a variable you need only surround its identifier with double underscores, examples below.
|
||||||
|
|
||||||
|
Example Variables:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
my_number=1
|
||||||
|
my_string=foo
|
||||||
|
my_property=bar: "baz"
|
||||||
|
```
|
||||||
|
|
||||||
|
Example Template:
|
||||||
|
|
||||||
|
```ts
|
||||||
|
const __my_string__: number = __my_number__;
|
||||||
|
console.log(__my_string__);
|
||||||
|
|
||||||
|
console.log({
|
||||||
|
foo: "Hello, __my_string__!",
|
||||||
|
__my_property__,
|
||||||
|
my_property: __my_string__,
|
||||||
|
});
|
||||||
|
```
|
||||||
|
|
||||||
|
Example Output:
|
||||||
|
|
||||||
|
```ts
|
||||||
|
const foo: number = 1;
|
||||||
|
console.log(foo);
|
||||||
|
|
||||||
|
console.log({
|
||||||
|
foo: "Hello, foo!",
|
||||||
|
bar: "baz",
|
||||||
|
my_property: foo,
|
||||||
|
});
|
||||||
|
```
|
||||||
|
|
||||||
|
## Conditional Instruction
|
||||||
|
|
||||||
|
Conditionals allow for code to be included/omitted based on the value of template variables. Currently only boolean logic in [disjunctive normal form](https://en.wikipedia.org/wiki/Disjunctive_normal_form) is supported and any variables that are not booleans are evaluated with the [Boolean constructor](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean).
|
||||||
|
|
||||||
|
Variables used in condition statements do not require double underscores. Their values can be inverted using `!`. Arithmetic and comparison operations are not supported. Parentheses are also not supported, conditions must be in DNF.
|
||||||
|
|
||||||
|
Conversion to DNF:
|
||||||
|
`A & (B | !C)` -> `A & B | A & !C` evaluated as `(A and B) or (A and not C)`
|
||||||
|
|
||||||
|
Example Variables:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
my_string=foo
|
||||||
|
say_hello=true
|
||||||
|
say_done=true
|
||||||
|
verbose=false
|
||||||
|
```
|
||||||
|
|
||||||
|
Example Template:
|
||||||
|
|
||||||
|
```ts
|
||||||
|
//%if verbose
|
||||||
|
console.log("Starting...");
|
||||||
|
//%endif
|
||||||
|
//%if say_hello & my_string
|
||||||
|
console.log("Hello, __my_string__!");
|
||||||
|
//%endif
|
||||||
|
//%if say_done | verbose
|
||||||
|
console.log("Done.");
|
||||||
|
//%endif
|
||||||
|
```
|
||||||
|
|
||||||
|
Example Output:
|
||||||
|
|
||||||
|
```ts
|
||||||
|
console.log("Hello, foo!");
|
||||||
|
console.log("Done.");
|
||||||
|
```
|
||||||
|
|
||||||
|
## Available Variables
|
||||||
|
|
||||||
|
| Identifier | Example | Description |
|
||||||
|
| - | - | - |
|
||||||
|
| typescript | `true` / `false` | `true` if typescript templates are included |
|
||||||
|
| controller | `true` / `false` | `true` if controller templates are included |
|
||||||
|
| host | `true` / `false` | `true` if host templates are included |
|
||||||
|
| instance | `true` / `false` | `true` if instance templates are included |
|
||||||
|
| module | `true` / `false` | `true` if module templates are included |
|
||||||
|
| ctl | `true` / `false` | `true` if control templates are included |
|
||||||
|
| web | `true` / `false` | `true` if web templates are included |
|
||||||
|
| plugin_name | `my_plugin` | name of the plugin |
|
||||||
|
| prepare | `tsc --build` | commands to run for the prepare script |
|
||||||
|
| ext | `ts` / `js` | file extension of source files |
|
||||||
@@ -1,4 +1,5 @@
|
|||||||
import { bootstrap } from "./ctl";
|
import { bootstrap } from "./ctl";
|
||||||
|
export * from "./ctl";
|
||||||
export { default as BaseCtlPlugin } from "./src/BaseCtlPlugin";
|
export { default as BaseCtlPlugin } from "./src/BaseCtlPlugin";
|
||||||
|
|
||||||
if (module === require.main) {
|
if (module === require.main) {
|
||||||
|
|||||||
@@ -3,14 +3,14 @@
|
|||||||
"description": "Clusterio command line management tool",
|
"description": "Clusterio command line management tool",
|
||||||
"author": "Hornwitser",
|
"author": "Hornwitser",
|
||||||
"license": "MIT",
|
"license": "MIT",
|
||||||
"version": "2.0.0-alpha.14",
|
"version": "2.0.0-alpha.18",
|
||||||
"main": "dist/index.js",
|
"main": "dist/node/index.js",
|
||||||
"scripts": {
|
"scripts": {
|
||||||
"prepare": "tsc --build",
|
"prepare": "tsc --build",
|
||||||
"test": "echo \"Error: no test specified\" && exit 1"
|
"test": "echo \"Error: no test specified\" && exit 1"
|
||||||
},
|
},
|
||||||
"bin": {
|
"bin": {
|
||||||
"clusterioctl": "./dist/ctl.js"
|
"clusterioctl": "./dist/node/ctl.js"
|
||||||
},
|
},
|
||||||
"keywords": [
|
"keywords": [
|
||||||
"factorio"
|
"factorio"
|
||||||
@@ -19,7 +19,7 @@
|
|||||||
"node": ">=18"
|
"node": ">=18"
|
||||||
},
|
},
|
||||||
"dependencies": {
|
"dependencies": {
|
||||||
"@clusterio/lib": "^2.0.0-alpha.14",
|
"@clusterio/lib": "^2.0.0-alpha.18",
|
||||||
"as-table": "^1.0.55",
|
"as-table": "^1.0.55",
|
||||||
"fs-extra": "^11.1.1",
|
"fs-extra": "^11.1.1",
|
||||||
"phin": "^3.7.0",
|
"phin": "^3.7.0",
|
||||||
|
|||||||
@@ -1097,7 +1097,13 @@ modPackCommands.add(new lib.Command({
|
|||||||
|
|
||||||
function setModPackSettings(
|
function setModPackSettings(
|
||||||
modPack: lib.ModPack,
|
modPack: lib.ModPack,
|
||||||
args: { boolSetting?: string[], intSetting?: string[], doubleSetting?: string[], stringSetting?: string[] },
|
args: {
|
||||||
|
boolSetting?: string[],
|
||||||
|
intSetting?: string[],
|
||||||
|
doubleSetting?: string[],
|
||||||
|
stringSetting?: string[],
|
||||||
|
colorSetting?: string[],
|
||||||
|
},
|
||||||
) {
|
) {
|
||||||
function doSettings(settings: string[], cast: (value: string) => (string | number | boolean)) {
|
function doSettings(settings: string[], cast: (value: string) => (string | number | boolean)) {
|
||||||
for (let i = 0; i + 2 < settings.length; i += 3) {
|
for (let i = 0; i + 2 < settings.length; i += 3) {
|
||||||
@@ -1134,6 +1140,13 @@ function setModPackSettings(
|
|||||||
return number;
|
return number;
|
||||||
});
|
});
|
||||||
doSettings(args.stringSetting || [], value => value);
|
doSettings(args.stringSetting || [], value => value);
|
||||||
|
doSettings(args.colorSetting || [], value => {
|
||||||
|
let color = JSON.parse(value);
|
||||||
|
if (typeof color !== "object" || color === null) {
|
||||||
|
throw new lib.CommandError("color value must be a JSON object with r, g, b, a properties");
|
||||||
|
}
|
||||||
|
return color;
|
||||||
|
});
|
||||||
}
|
}
|
||||||
|
|
||||||
function setModPackMods(modPack: lib.ModPack, mods: string[] | undefined) {
|
function setModPackMods(modPack: lib.ModPack, mods: string[] | undefined) {
|
||||||
@@ -1173,6 +1186,7 @@ modPackCommands.add(new lib.Command({
|
|||||||
"int-setting": { describe: "Set int setting", array: true, nargs: 3, type: "string" },
|
"int-setting": { describe: "Set int setting", array: true, nargs: 3, type: "string" },
|
||||||
"double-setting": { describe: "Set double setting", array: true, nargs: 3, type: "string" },
|
"double-setting": { describe: "Set double setting", array: true, nargs: 3, type: "string" },
|
||||||
"string-setting": { describe: "Set string setting", array: true, nargs: 3, type: "string" },
|
"string-setting": { describe: "Set string setting", array: true, nargs: 3, type: "string" },
|
||||||
|
"color-setting": { describe: "Set color setting", array: true, nargs: 3, type: "string" },
|
||||||
});
|
});
|
||||||
}],
|
}],
|
||||||
handler: async function(
|
handler: async function(
|
||||||
@@ -1186,6 +1200,7 @@ modPackCommands.add(new lib.Command({
|
|||||||
intSetting?: string[],
|
intSetting?: string[],
|
||||||
doubleSetting?: string[],
|
doubleSetting?: string[],
|
||||||
stringSetting?: string[],
|
stringSetting?: string[],
|
||||||
|
colorSetting?: string[],
|
||||||
},
|
},
|
||||||
control: Control,
|
control: Control,
|
||||||
) {
|
) {
|
||||||
@@ -1244,6 +1259,7 @@ modPackCommands.add(new lib.Command({
|
|||||||
"int-setting": { describe: "Set int setting", array: true, nargs: 3, type: "string" },
|
"int-setting": { describe: "Set int setting", array: true, nargs: 3, type: "string" },
|
||||||
"double-setting": { describe: "Set double setting", array: true, nargs: 3, type: "string" },
|
"double-setting": { describe: "Set double setting", array: true, nargs: 3, type: "string" },
|
||||||
"string-setting": { describe: "Set string setting", array: true, nargs: 3, type: "string" },
|
"string-setting": { describe: "Set string setting", array: true, nargs: 3, type: "string" },
|
||||||
|
"color-setting": { describe: "Set color setting", array: true, nargs: 3, type: "string" },
|
||||||
"remove-setting": { describe: "Remove a setting", array: true, nargs: 2, type: "string" },
|
"remove-setting": { describe: "Remove a setting", array: true, nargs: 2, type: "string" },
|
||||||
});
|
});
|
||||||
}],
|
}],
|
||||||
@@ -1261,6 +1277,7 @@ modPackCommands.add(new lib.Command({
|
|||||||
intSetting?: string[],
|
intSetting?: string[],
|
||||||
doubleSetting?: string[],
|
doubleSetting?: string[],
|
||||||
stringSetting?: string[],
|
stringSetting?: string[],
|
||||||
|
colorSetting?: string[],
|
||||||
removeSetting?: string[],
|
removeSetting?: string[],
|
||||||
},
|
},
|
||||||
control: Control,
|
control: Control,
|
||||||
|
|||||||
@@ -1,10 +1,6 @@
|
|||||||
{
|
{
|
||||||
"extends": "../../tsconfig.node.json",
|
"files": [],
|
||||||
"references": [
|
"references": [
|
||||||
{ "path": "../lib" },
|
{ "path": "./tsconfig.node.json" },
|
||||||
],
|
],
|
||||||
"include": ["index.ts", "package.json", "ctl.ts", "src/**/*.ts"],
|
|
||||||
"compilerOptions": {
|
|
||||||
"outDir": "dist",
|
|
||||||
},
|
|
||||||
}
|
}
|
||||||
@@ -0,0 +1,10 @@
|
|||||||
|
{
|
||||||
|
"extends": "../../tsconfig.node.json",
|
||||||
|
"references": [
|
||||||
|
{ "path": "../lib/tsconfig.node.json" },
|
||||||
|
],
|
||||||
|
"include": ["index.ts", "package.json", "ctl.ts", "src/**/*.ts"],
|
||||||
|
"compilerOptions": {
|
||||||
|
"outDir": "dist/node",
|
||||||
|
},
|
||||||
|
}
|
||||||
+26
-5
@@ -26,6 +26,27 @@ import { ConsoleTransport, levels, logger } from "@clusterio/lib";
|
|||||||
|
|
||||||
import Host from "./src/Host";
|
import Host from "./src/Host";
|
||||||
|
|
||||||
|
let host: Host | undefined;
|
||||||
|
|
||||||
|
void new lib.Gauge(
|
||||||
|
"clusterio_host_pending_requests",
|
||||||
|
"Count of pending link requests currently waiting in memory on the host.",
|
||||||
|
{
|
||||||
|
labels: ["host_id"],
|
||||||
|
callback: (gauge) => {
|
||||||
|
if (!host) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
let count = host.pendingRequestCount;
|
||||||
|
for (const connection of host.instanceConnections.values()) {
|
||||||
|
count += connection.pendingRequestCount;
|
||||||
|
count += connection.instance.pendingRequestCount;
|
||||||
|
}
|
||||||
|
gauge.labels(String(host.config.get("host.id"))).set(count);
|
||||||
|
},
|
||||||
|
}
|
||||||
|
);
|
||||||
|
|
||||||
export class HostConnector extends lib.WebSocketClientConnector {
|
export class HostConnector extends lib.WebSocketClientConnector {
|
||||||
constructor(
|
constructor(
|
||||||
@@ -205,7 +226,7 @@ async function startHost() {
|
|||||||
}
|
}
|
||||||
|
|
||||||
let hostConnector = new HostConnector(hostConfig, tlsCa, pluginInfos);
|
let hostConnector = new HostConnector(hostConfig, tlsCa, pluginInfos);
|
||||||
let host = new Host(
|
host = new Host(
|
||||||
hostConnector,
|
hostConnector,
|
||||||
args.config,
|
args.config,
|
||||||
hostConfig,
|
hostConfig,
|
||||||
@@ -227,7 +248,7 @@ async function startHost() {
|
|||||||
|
|
||||||
secondSigint = true;
|
secondSigint = true;
|
||||||
logger.info("Caught interrupt signal, shutting down");
|
logger.info("Caught interrupt signal, shutting down");
|
||||||
host.shutdown();
|
host!.shutdown();
|
||||||
});
|
});
|
||||||
let secondSigterm = false;
|
let secondSigterm = false;
|
||||||
process.on("SIGTERM", () => {
|
process.on("SIGTERM", () => {
|
||||||
@@ -240,11 +261,11 @@ async function startHost() {
|
|||||||
|
|
||||||
secondSigterm = true;
|
secondSigterm = true;
|
||||||
logger.info("Caught termination signal, shutting down");
|
logger.info("Caught termination signal, shutting down");
|
||||||
host.shutdown();
|
host!.shutdown();
|
||||||
});
|
});
|
||||||
process.on("SIGHUP", () => {
|
process.on("SIGHUP", () => {
|
||||||
logger.info("Terminal closed, shutting down");
|
logger.info("Terminal closed, shutting down");
|
||||||
host.shutdown();
|
host!.shutdown();
|
||||||
});
|
});
|
||||||
|
|
||||||
try {
|
try {
|
||||||
@@ -255,7 +276,7 @@ async function startHost() {
|
|||||||
}
|
}
|
||||||
|
|
||||||
hostConnector.once("connect", () => {
|
hostConnector.once("connect", () => {
|
||||||
logger.add(new lib.LinkTransport({ link: host }));
|
logger.add(new lib.LinkTransport({ link: host! }));
|
||||||
});
|
});
|
||||||
|
|
||||||
await hostConnector.connect();
|
await hostConnector.connect();
|
||||||
|
|||||||
@@ -1,6 +1,9 @@
|
|||||||
import { bootstrap } from "./host";
|
import { bootstrap } from "./host";
|
||||||
export { default as BaseHostPlugin } from "./src/BaseHostPlugin";
|
export { default as BaseHostPlugin } from "./src/BaseHostPlugin";
|
||||||
export { default as BaseInstancePlugin } from "./src/BaseInstancePlugin";
|
export { default as BaseInstancePlugin } from "./src/BaseInstancePlugin";
|
||||||
|
export { default as Host, HostRouter } from "./src/Host";
|
||||||
|
export { default as Instance } from "./src/Instance";
|
||||||
|
export { default as InstanceConnection } from "./src/InstanceConnection";
|
||||||
|
|
||||||
if (module === require.main) {
|
if (module === require.main) {
|
||||||
bootstrap();
|
bootstrap();
|
||||||
|
|||||||
@@ -3,14 +3,14 @@
|
|||||||
"description": "Implementation of Clusterio host server",
|
"description": "Implementation of Clusterio host server",
|
||||||
"author": "Hornwitser",
|
"author": "Hornwitser",
|
||||||
"license": "MIT",
|
"license": "MIT",
|
||||||
"version": "2.0.0-alpha.14",
|
"version": "2.0.0-alpha.18",
|
||||||
"main": "dist/index.js",
|
"main": "dist/node/index.js",
|
||||||
"scripts": {
|
"scripts": {
|
||||||
"prepare": "tsc --build",
|
"prepare": "tsc --build",
|
||||||
"test": "echo \"Error: no test specified\" && exit 1"
|
"test": "echo \"Error: no test specified\" && exit 1"
|
||||||
},
|
},
|
||||||
"bin": {
|
"bin": {
|
||||||
"clusteriohost": "./dist/host.js"
|
"clusteriohost": "./dist/node/host.js"
|
||||||
},
|
},
|
||||||
"keywords": [
|
"keywords": [
|
||||||
"factorio"
|
"factorio"
|
||||||
@@ -19,7 +19,7 @@
|
|||||||
"node": ">=18"
|
"node": ">=18"
|
||||||
},
|
},
|
||||||
"dependencies": {
|
"dependencies": {
|
||||||
"@clusterio/lib": "^2.0.0-alpha.14",
|
"@clusterio/lib": "^2.0.0-alpha.18",
|
||||||
"@sinclair/typebox": "^0.30.4",
|
"@sinclair/typebox": "^0.30.4",
|
||||||
"fs-extra": "^11.1.1",
|
"fs-extra": "^11.1.1",
|
||||||
"jimp": "^0.22.8",
|
"jimp": "^0.22.8",
|
||||||
|
|||||||
+36
-17
@@ -82,7 +82,7 @@ const instanceStartingMessages = new Set([
|
|||||||
lib.InstanceExportDataRequest.name,
|
lib.InstanceExportDataRequest.name,
|
||||||
]);
|
]);
|
||||||
|
|
||||||
class HostRouter {
|
export class HostRouter {
|
||||||
constructor(
|
constructor(
|
||||||
public host: Host
|
public host: Host
|
||||||
) { }
|
) { }
|
||||||
@@ -93,16 +93,22 @@ class HostRouter {
|
|||||||
* @param origin -
|
* @param origin -
|
||||||
* Link the message originated from.
|
* Link the message originated from.
|
||||||
* @param message - Message to process.
|
* @param message - Message to process.
|
||||||
|
* @param entry - message entry if message is a request or an event.
|
||||||
* @param hasFallback - is fallback available
|
* @param hasFallback - is fallback available
|
||||||
* @returns true if the message was handled, false if fallback
|
* @returns true if the message was handled, false if fallback
|
||||||
* is requested
|
* is requested
|
||||||
*/
|
*/
|
||||||
forwardMessage(origin: lib.Link, message: lib.MessageRoutable, hasFallback: boolean) {
|
forwardMessage(
|
||||||
|
origin: lib.Link,
|
||||||
|
message: lib.MessageRoutable,
|
||||||
|
entry: lib.RequestEntry | lib.EventEntry | undefined,
|
||||||
|
hasFallback: boolean,
|
||||||
|
) {
|
||||||
let dst = message.dst;
|
let dst = message.dst;
|
||||||
let nextHop: lib.Link | undefined;
|
let nextHop: lib.Link | undefined;
|
||||||
let msg: string | undefined;
|
let msg: string | undefined;
|
||||||
if (dst.type === lib.Address.broadcast) {
|
if (dst.type === lib.Address.broadcast) {
|
||||||
this.broadcastMessage(origin, message);
|
this.broadcastMessage(origin, message, entry as lib.EventEntry);
|
||||||
return true;
|
return true;
|
||||||
} else if (
|
} else if (
|
||||||
dst.type === lib.Address.controller
|
dst.type === lib.Address.controller
|
||||||
@@ -153,27 +159,36 @@ class HostRouter {
|
|||||||
return true;
|
return true;
|
||||||
}
|
}
|
||||||
|
|
||||||
broadcastMessage(origin: lib.Link, message: lib.MessageRoutable) {
|
broadcastMessage(
|
||||||
|
origin: lib.Link,
|
||||||
|
message: lib.MessageRoutable,
|
||||||
|
entry: lib.EventEntry,
|
||||||
|
) {
|
||||||
let dst = message.dst;
|
let dst = message.dst;
|
||||||
if (message.type !== "event") {
|
if (message.type !== "event") {
|
||||||
this.warnUnrouted(message, `Unexpected broadcast of ${message.type}`);
|
this.warnUnrouted(message, `Unexpected broadcast of ${message.type}`);
|
||||||
} else if (dst.id === lib.Address.host || dst.id === lib.Address.instance) {
|
return;
|
||||||
|
}
|
||||||
|
const plugin = entry.Event.plugin;
|
||||||
|
if (dst.id === lib.Address.instance) {
|
||||||
for (let instanceConnection of this.host.instanceConnections.values()) {
|
for (let instanceConnection of this.host.instanceConnections.values()) {
|
||||||
if (instanceConnection !== origin) {
|
if (instanceConnection !== origin && (!plugin || instanceConnection.plugins.has(plugin))) {
|
||||||
instanceConnection.connector.send(message);
|
instanceConnection.connector.forward(message);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
if (this.host !== origin) {
|
if (this.host !== origin && (!plugin || this.host.serverPlugins.has(plugin))) {
|
||||||
this.host.connector.send(message);
|
this.host.connector.forward(message);
|
||||||
}
|
}
|
||||||
} else if (dst.id === lib.Address.control) {
|
} else if (dst.id === lib.Address.control) {
|
||||||
if (this.host !== origin) {
|
if (this.host !== origin) {
|
||||||
this.host.connector.send(message);
|
if (!plugin || this.host.serverPlugins.has(plugin)) {
|
||||||
|
this.host.connector.forward(message);
|
||||||
|
}
|
||||||
} else {
|
} else {
|
||||||
logger.warn(`Received control broadcast of ${(message as lib.MessageEvent).name} from master.`);
|
logger.warn(`Received control broadcast of ${(message as lib.MessageEvent).name} from controller.`);
|
||||||
}
|
}
|
||||||
} else {
|
} else {
|
||||||
this.warnUnrouted(message, `Unexpected broacdast target ${dst.id}`);
|
this.warnUnrouted(message, `Unexpected broadcast target ${dst.id}`);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -193,7 +208,7 @@ class HostRouter {
|
|||||||
}
|
}
|
||||||
|
|
||||||
this.host._connectInstance(dst.id).then(instanceConnection => {
|
this.host._connectInstance(dst.id).then(instanceConnection => {
|
||||||
instanceConnection.connector.send(message);
|
instanceConnection.connector.forward(message);
|
||||||
}).catch(err => {
|
}).catch(err => {
|
||||||
logger.error(`Error starting instance:\n${err.stack}`, this.host.instanceLogMeta(dst.id));
|
logger.error(`Error starting instance:\n${err.stack}`, this.host.instanceLogMeta(dst.id));
|
||||||
origin.connector.sendResponseError(
|
origin.connector.sendResponseError(
|
||||||
@@ -207,7 +222,7 @@ class HostRouter {
|
|||||||
if (message.type === "request") {
|
if (message.type === "request") {
|
||||||
nextHop.forwardRequest(message as lib.MessageRequest, origin);
|
nextHop.forwardRequest(message as lib.MessageRequest, origin);
|
||||||
} else {
|
} else {
|
||||||
nextHop.connector.send(message);
|
nextHop.connector.forward(message);
|
||||||
}
|
}
|
||||||
} catch (err: any) {
|
} catch (err: any) {
|
||||||
if (message.type === "request") {
|
if (message.type === "request") {
|
||||||
@@ -377,7 +392,10 @@ export default class Host extends lib.Link {
|
|||||||
|
|
||||||
async loadPlugins() {
|
async loadPlugins() {
|
||||||
for (let pluginInfo of this.pluginInfos) {
|
for (let pluginInfo of this.pluginInfos) {
|
||||||
if (!this.config.get(`${pluginInfo.name}.load_plugin` as keyof lib.HostConfigFields)) {
|
if (
|
||||||
|
!pluginInfo.hostEntrypoint && !pluginInfo.instanceEntrypoint
|
||||||
|
|| !this.config.get(`${pluginInfo.name}.load_plugin` as keyof lib.HostConfigFields)
|
||||||
|
) {
|
||||||
continue;
|
continue;
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -582,8 +600,9 @@ export default class Host extends lib.Link {
|
|||||||
try {
|
try {
|
||||||
modInfo = await this.modStore.loadMod(mod.name, mod.version);
|
modInfo = await this.modStore.loadMod(mod.name, mod.version);
|
||||||
} catch (err: any) {
|
} catch (err: any) {
|
||||||
|
// A broken zip file may have been left in the mods folder
|
||||||
if (err.code !== "ENOENT") {
|
if (err.code !== "ENOENT") {
|
||||||
throw err;
|
logger.error(`Error loading mod ${mod.name} ${mod.version}: ${err.message}`);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
if (modInfo && (!mod.sha1 || mod.sha1 === modInfo.sha1)) {
|
if (modInfo && (!mod.sha1 || mod.sha1 === modInfo.sha1)) {
|
||||||
@@ -1053,7 +1072,7 @@ export default class Host extends lib.Link {
|
|||||||
if (instanceInfo.config.get("instance.auto_start")) {
|
if (instanceInfo.config.get("instance.auto_start")) {
|
||||||
try {
|
try {
|
||||||
let instanceConnection = await this._connectInstance(instanceId);
|
let instanceConnection = await this._connectInstance(instanceId);
|
||||||
await instanceConnection.send(new lib.InstanceStartRequest());
|
await instanceConnection.instance.handleInstanceStartRequest(new lib.InstanceStartRequest());
|
||||||
} catch (err: any) {
|
} catch (err: any) {
|
||||||
logger.error(
|
logger.error(
|
||||||
`Error during auto startup for ${instanceInfo.config.get("instance.name")}:\n${err.stack}`,
|
`Error during auto startup for ${instanceInfo.config.get("instance.name")}:\n${err.stack}`,
|
||||||
|
|||||||
@@ -800,7 +800,7 @@ rcon.print(game.table_to_json(players))`.replace(/\r?\n/g, " ");
|
|||||||
|
|
||||||
// Find stand alone modules to load
|
// Find stand alone modules to load
|
||||||
// XXX for now only the included clusterio module is loaded
|
// XXX for now only the included clusterio module is loaded
|
||||||
let modulesDirectory = path.join(__dirname, "..", "..", "modules");
|
let modulesDirectory = path.join(__dirname, "..", "..", "..", "modules");
|
||||||
for (let entry of await fs.readdir(modulesDirectory, { withFileTypes: true })) {
|
for (let entry of await fs.readdir(modulesDirectory, { withFileTypes: true })) {
|
||||||
if (entry.isDirectory()) {
|
if (entry.isDirectory()) {
|
||||||
if (modules.has(entry.name)) {
|
if (modules.has(entry.name)) {
|
||||||
@@ -955,6 +955,11 @@ rcon.print(game.table_to_json(players))`.replace(/\r?\n/g, " ");
|
|||||||
await lib.invokeHook(this.plugins, "onStop");
|
await lib.invokeHook(this.plugins, "onStop");
|
||||||
await this.server.stop();
|
await this.server.stop();
|
||||||
await this.sendSaveListUpdate();
|
await this.sendSaveListUpdate();
|
||||||
|
} else if (
|
||||||
|
this.server._state === "stopping"
|
||||||
|
|| this.server._state === "create"
|
||||||
|
) {
|
||||||
|
await this.server.kill();
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
+19
-13
@@ -5,7 +5,7 @@ import Jimp from "jimp";
|
|||||||
import JSZip from "jszip";
|
import JSZip from "jszip";
|
||||||
|
|
||||||
import * as lib from "@clusterio/lib";
|
import * as lib from "@clusterio/lib";
|
||||||
import * as libBuildMod from "@clusterio/lib/dist/build_mod";
|
import * as libBuildMod from "@clusterio/lib/dist/node/build_mod";
|
||||||
import type { FactorioServer } from "./server";
|
import type { FactorioServer } from "./server";
|
||||||
|
|
||||||
interface Prototype {
|
interface Prototype {
|
||||||
@@ -18,11 +18,10 @@ interface SimpleIconSpecification {
|
|||||||
icon_size: number;
|
icon_size: number;
|
||||||
icon_mipmaps?: number;
|
icon_mipmaps?: number;
|
||||||
}
|
}
|
||||||
type Color = { r: number, g: number, b: number, a: number };
|
|
||||||
interface IconLayer {
|
interface IconLayer {
|
||||||
icon: string;
|
icon: string;
|
||||||
icon_size: number;
|
icon_size: number;
|
||||||
tint?: Color,
|
tint?: lib.FactorioColor,
|
||||||
shift?: [number, number],
|
shift?: [number, number],
|
||||||
scale?: number,
|
scale?: number,
|
||||||
icon_mipmaps?: number,
|
icon_mipmaps?: number,
|
||||||
@@ -62,7 +61,7 @@ async function generateExportMod(server: FactorioServer) {
|
|||||||
clean: false,
|
clean: false,
|
||||||
build: true,
|
build: true,
|
||||||
pack: true,
|
pack: true,
|
||||||
sourceDir: path.join(__dirname, "..", "..", "lua", "export"),
|
sourceDir: path.join(__dirname, "..", "..", "..", "lua", "export"),
|
||||||
outputDir: server.writePath("mods"),
|
outputDir: server.writePath("mods"),
|
||||||
bumpPatch: false,
|
bumpPatch: false,
|
||||||
factorioVersion: server.version.replace(/\.\d+$/, ""),
|
factorioVersion: server.version.replace(/\.\d+$/, ""),
|
||||||
@@ -202,15 +201,9 @@ async function loadLayeredIcon(
|
|||||||
|
|
||||||
iconLayer = iconLayer.clone();
|
iconLayer = iconLayer.clone();
|
||||||
|
|
||||||
let tint: Color;
|
let tint: lib.Color;
|
||||||
if (layer.tint) {
|
if (layer.tint) {
|
||||||
let divisor = (layer.tint.r > 1 || layer.tint.g > 1 || layer.tint.b > 1) ? 255 : 1;
|
tint = lib.normalizeColor(layer.tint);
|
||||||
tint = {
|
|
||||||
r: (layer.tint.r || 0) / divisor,
|
|
||||||
g: (layer.tint.g || 0) / divisor,
|
|
||||||
b: (layer.tint.b || 0) / divisor,
|
|
||||||
a: layer.tint.a || 1,
|
|
||||||
};
|
|
||||||
} else {
|
} else {
|
||||||
tint = { r: 1, b: 1, g: 1, a: 1 };
|
tint = { r: 1, b: 1, g: 1, a: 1 };
|
||||||
}
|
}
|
||||||
@@ -252,6 +245,18 @@ async function loadLayeredIcon(
|
|||||||
return icon;
|
return icon;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
function fixIcons(item: ItemPrototype) {
|
||||||
|
const icons = item.icons;
|
||||||
|
if (typeof icons === "object" && !(icons instanceof Array) && icons !== null) {
|
||||||
|
// It's possible to specify icons as an object with arbitrary keys
|
||||||
|
// and the game will still accept it, cast the value to array if
|
||||||
|
// this is the case.
|
||||||
|
item = { ...item };
|
||||||
|
item.icons = Object.values(icons);
|
||||||
|
}
|
||||||
|
return item;
|
||||||
|
}
|
||||||
|
|
||||||
const itemTypes = new Set([
|
const itemTypes = new Set([
|
||||||
"item",
|
"item",
|
||||||
"ammo",
|
"ammo",
|
||||||
@@ -284,7 +289,8 @@ const itemTypes = new Set([
|
|||||||
function filterItems(prototypes: Prototypes): ItemPrototype[] {
|
function filterItems(prototypes: Prototypes): ItemPrototype[] {
|
||||||
return Object.entries(prototypes)
|
return Object.entries(prototypes)
|
||||||
.filter(([type, _]) => itemTypes.has(type))
|
.filter(([type, _]) => itemTypes.has(type))
|
||||||
.flatMap(([_, typePrototypes]) => Object.values(typePrototypes)) as ItemPrototype[]
|
.flatMap(([_, typePrototypes]) => Object.values(typePrototypes) as ItemPrototype[])
|
||||||
|
.map(fixIcons)
|
||||||
;
|
;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
@@ -77,9 +77,16 @@ export class SaveModule {
|
|||||||
|
|
||||||
static async fromSave(json: Static<typeof SaveModule.jsonSchema>, root: JSZip) {
|
static async fromSave(json: Static<typeof SaveModule.jsonSchema>, root: JSZip) {
|
||||||
const module = new this(lib.ModuleInfo.fromJSON(json));
|
const module = new this(lib.ModuleInfo.fromJSON(json));
|
||||||
module.files = new Map(
|
module.files = new Map(await Promise.all(json.files
|
||||||
await Promise.all(json.files.map(async f => [f, await root.file(f)!.async("nodebuffer")] as const))
|
.map(filename => ({filename, file: root.file(filename)}))
|
||||||
);
|
.filter(({filename, file}) => {
|
||||||
|
if (file === null) {
|
||||||
|
lib.logger.warn(`Missing file ${filename} in save`);
|
||||||
|
}
|
||||||
|
return file !== null;
|
||||||
|
})
|
||||||
|
.map(async ({filename, file}) => [filename, await file!.async("nodebuffer")] as const)
|
||||||
|
));
|
||||||
return module;
|
return module;
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -395,8 +402,11 @@ export async function patch(savePath: string, modules: SaveModule[]) {
|
|||||||
}
|
}
|
||||||
} else {
|
} else {
|
||||||
for (let module of patchInfo.modules) {
|
for (let module of patchInfo.modules) {
|
||||||
for (let file of module.files.keys()) {
|
for (let filepath of module.files.keys()) {
|
||||||
zip.remove(root.file(file)!.name);
|
const file = root.file(filepath);
|
||||||
|
if (file !== null) {
|
||||||
|
zip.remove(file.name);
|
||||||
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
patchInfo.modules = [];
|
patchInfo.modules = [];
|
||||||
|
|||||||
@@ -562,6 +562,13 @@ export class FactorioServer extends events.EventEmitter {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// TODO at the moment this is just a helper function, it has the potential for schema checking
|
||||||
|
handle<Event>(eventName: string, handler: (event: Event) => Promise<void>) {
|
||||||
|
this.on(`ipc-${eventName}`, (event) => handler(event).catch(err => {
|
||||||
|
this._logger.error(`Error handling ipc event:\n${err.stack}`);
|
||||||
|
}));
|
||||||
|
}
|
||||||
|
|
||||||
async _handleIpc(line: Buffer) {
|
async _handleIpc(line: Buffer) {
|
||||||
let channelEnd = line.indexOf("?");
|
let channelEnd = line.indexOf("?");
|
||||||
if (channelEnd === -1) {
|
if (channelEnd === -1) {
|
||||||
@@ -865,7 +872,9 @@ export class FactorioServer extends events.EventEmitter {
|
|||||||
|
|
||||||
try {
|
try {
|
||||||
let [code, signal] = await events.once(this._server, "exit");
|
let [code, signal] = await events.once(this._server, "exit");
|
||||||
void signal;
|
if (signal) {
|
||||||
|
throw new Error(`Factorio exited with signal ${signal}`);
|
||||||
|
}
|
||||||
if (code !== 0) {
|
if (code !== 0) {
|
||||||
throw new Error(`Factorio exited with status ${code}`);
|
throw new Error(`Factorio exited with status ${code}`);
|
||||||
}
|
}
|
||||||
@@ -1092,7 +1101,7 @@ export class FactorioServer extends events.EventEmitter {
|
|||||||
* process.
|
* process.
|
||||||
*/
|
*/
|
||||||
async kill(unexpected = false) {
|
async kill(unexpected = false) {
|
||||||
this._check(["running", "stopping"]);
|
this._check(["running", "stopping", "create"]);
|
||||||
this._killed = true;
|
this._killed = true;
|
||||||
if (!unexpected) {
|
if (!unexpected) {
|
||||||
this._state = "stopping";
|
this._state = "stopping";
|
||||||
|
|||||||
@@ -1,10 +1,6 @@
|
|||||||
{
|
{
|
||||||
"extends": "../../tsconfig.node.json",
|
"files": [],
|
||||||
"references": [
|
"references": [
|
||||||
{ "path": "../lib" },
|
{ "path": "./tsconfig.node.json" },
|
||||||
],
|
],
|
||||||
"include": ["index.ts", "host.ts", "package.json", "src/**/*.ts", "src/**/*.js"],
|
|
||||||
"compilerOptions": {
|
|
||||||
"outDir": "dist",
|
|
||||||
},
|
|
||||||
}
|
}
|
||||||
@@ -0,0 +1,10 @@
|
|||||||
|
{
|
||||||
|
"extends": "../../tsconfig.node.json",
|
||||||
|
"references": [
|
||||||
|
{ "path": "../lib/tsconfig.node.json" },
|
||||||
|
],
|
||||||
|
"include": ["index.ts", "host.ts", "package.json", "src/**/*.ts", "src/**/*.js"],
|
||||||
|
"compilerOptions": {
|
||||||
|
"outDir": "dist/node",
|
||||||
|
},
|
||||||
|
}
|
||||||
@@ -1 +1 @@
|
|||||||
dist/web/build
|
dist/browser
|
||||||
@@ -6,6 +6,7 @@ export * from "./src/factorio/exchange_string";
|
|||||||
export * from "./src/helpers";
|
export * from "./src/helpers";
|
||||||
export * from "./src/ini";
|
export * from "./src/ini";
|
||||||
export * from "./src/link";
|
export * from "./src/link";
|
||||||
|
export * from "./src/lua_tools";
|
||||||
export * from "./src/logging";
|
export * from "./src/logging";
|
||||||
export * from "./src/permissions";
|
export * from "./src/permissions";
|
||||||
export * from "./src/plugin";
|
export * from "./src/plugin";
|
||||||
|
|||||||
@@ -1,14 +1,14 @@
|
|||||||
{
|
{
|
||||||
"name": "@clusterio/lib",
|
"name": "@clusterio/lib",
|
||||||
"description": "Shared library for Clusterio",
|
"description": "Shared library for Clusterio",
|
||||||
"version": "2.0.0-alpha.14",
|
"version": "2.0.0-alpha.18",
|
||||||
"repository": "https://github.com/clusterio/clusterio",
|
"repository": "https://github.com/clusterio/clusterio",
|
||||||
"license": "MIT",
|
"license": "MIT",
|
||||||
"scripts": {
|
"scripts": {
|
||||||
"prepare": "tsc --build && pnpm run compile_validator",
|
"prepare": "tsc --build && pnpm run compile_validator",
|
||||||
"compile_validator": "node scripts/compile_validator.js"
|
"compile_validator": "node scripts/compile_validator.js"
|
||||||
},
|
},
|
||||||
"main": "dist/index.js",
|
"main": "dist/node/index.js",
|
||||||
"browser": "browser.ts",
|
"browser": "browser.ts",
|
||||||
"keywords": [
|
"keywords": [
|
||||||
"factorio"
|
"factorio"
|
||||||
|
|||||||
@@ -7,9 +7,9 @@ const standaloneCode = require("ajv/dist/standalone").default;
|
|||||||
/* eslint-disable node/no-sync */
|
/* eslint-disable node/no-sync */
|
||||||
|
|
||||||
// Provide an empty file for message_core to load
|
// Provide an empty file for message_core to load
|
||||||
fs.outputFileSync(path.join(__dirname, "../dist/src/data/message_validate.js"), "");
|
fs.outputFileSync(path.join(__dirname, "../dist/node/src/data/message_validate.js"), "");
|
||||||
|
|
||||||
const { Message } = require("../dist/src/data/messages_core");
|
const { Message } = require("../dist/node/src/data/messages_core");
|
||||||
|
|
||||||
const ajv = new Ajv({
|
const ajv = new Ajv({
|
||||||
allowUnionTypes: true,
|
allowUnionTypes: true,
|
||||||
@@ -28,5 +28,5 @@ function write(output) {
|
|||||||
`// generated by scripts/compile_validator.js\n// @ts-nocheck\n/* eslint-disable */\n${moduleCode}`
|
`// generated by scripts/compile_validator.js\n// @ts-nocheck\n/* eslint-disable */\n${moduleCode}`
|
||||||
);
|
);
|
||||||
}
|
}
|
||||||
write("../dist/src/data/message_validate.js");
|
write("../dist/node/src/data/message_validate.js");
|
||||||
write("../src/data/message_validate.js");
|
write("../src/data/message_validate.js");
|
||||||
@@ -1,8 +1,10 @@
|
|||||||
import fs from "fs-extra";
|
import fs from "fs-extra";
|
||||||
import path from "path";
|
import path from "path";
|
||||||
|
import { Static } from "@sinclair/typebox";
|
||||||
import { logger } from "./logging";
|
import { logger } from "./logging";
|
||||||
import { ModInfo } from "./data";
|
import { ModInfo } from "./data";
|
||||||
import TypedEventEmitter from "./TypedEventEmitter";
|
import TypedEventEmitter from "./TypedEventEmitter";
|
||||||
|
import { safeOutputFile } from "./file_ops";
|
||||||
|
|
||||||
export interface ModStoreEvents {
|
export interface ModStoreEvents {
|
||||||
/** A stored mod was created, updated or deleted */
|
/** A stored mod was created, updated or deleted */
|
||||||
@@ -74,6 +76,21 @@ export default class ModStore extends TypedEventEmitter<keyof ModStoreEvents, Mo
|
|||||||
}
|
}
|
||||||
|
|
||||||
static async fromDirectory(modsDirectory: string) {
|
static async fromDirectory(modsDirectory: string) {
|
||||||
|
type ModInfoCache = Static<typeof ModInfo.jsonSchema>[];
|
||||||
|
const cacheFilename = path.join(modsDirectory, "mod-info-cache.json");
|
||||||
|
let cache = new Map<string, ModInfo>();
|
||||||
|
try {
|
||||||
|
const content = await fs.readFile(cacheFilename, "utf8");
|
||||||
|
cache = new Map((JSON.parse(content) as ModInfoCache).map(item => {
|
||||||
|
const mod = ModInfo.fromJSON(item);
|
||||||
|
return [mod.filename, mod];
|
||||||
|
}));
|
||||||
|
} catch (err: any) {
|
||||||
|
if (err.code !== "ENOENT") {
|
||||||
|
logger.warn(`Error loading ${cacheFilename}:\n${err.stack}`);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
const files = new Map<string, ModInfo>();
|
const files = new Map<string, ModInfo>();
|
||||||
for (let entry of await fs.readdir(modsDirectory, { withFileTypes: true })) {
|
for (let entry of await fs.readdir(modsDirectory, { withFileTypes: true })) {
|
||||||
if (entry.isDirectory()) {
|
if (entry.isDirectory()) {
|
||||||
@@ -81,10 +98,23 @@ export default class ModStore extends TypedEventEmitter<keyof ModStoreEvents, Mo
|
|||||||
continue;
|
continue;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
if (!entry.name.toLowerCase().endsWith(".zip")) {
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
if (entry.name.toLowerCase().endsWith(".tmp.zip")) {
|
if (entry.name.toLowerCase().endsWith(".tmp.zip")) {
|
||||||
continue;
|
continue;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
const cachedModInfo = cache.get(entry.name);
|
||||||
|
if (cachedModInfo) {
|
||||||
|
const stat = await fs.stat(path.join(modsDirectory, entry.name));
|
||||||
|
if (cachedModInfo.mtimeMs === stat.mtimeMs) {
|
||||||
|
files.set(cachedModInfo.filename, cachedModInfo);
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
logger.info(`Loading info for Mod ${entry.name}`);
|
logger.info(`Loading info for Mod ${entry.name}`);
|
||||||
let modInfo: ModInfo;
|
let modInfo: ModInfo;
|
||||||
try {
|
try {
|
||||||
@@ -96,6 +126,12 @@ export default class ModStore extends TypedEventEmitter<keyof ModStoreEvents, Mo
|
|||||||
files.set(modInfo.filename, modInfo);
|
files.set(modInfo.filename, modInfo);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
if (files.size) {
|
||||||
|
logger.info(`Loaded info for ${files.size} mods`);
|
||||||
|
const content: ModInfoCache = [...files.values()].map(mod => mod.toJSON());
|
||||||
|
await safeOutputFile(cacheFilename, JSON.stringify(content));
|
||||||
|
}
|
||||||
|
|
||||||
return new this(modsDirectory, files);
|
return new this(modsDirectory, files);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -459,7 +459,7 @@ export class Config<
|
|||||||
setProp<Field extends keyof Fields & string>(
|
setProp<Field extends keyof Fields & string>(
|
||||||
name: Field,
|
name: Field,
|
||||||
prop: string,
|
prop: string,
|
||||||
value: unknown,
|
value?: unknown,
|
||||||
location = this.location,
|
location = this.location,
|
||||||
) {
|
) {
|
||||||
let def = this.constructor.fieldDefinitions[name];
|
let def = this.constructor.fieldDefinitions[name];
|
||||||
|
|||||||
@@ -116,6 +116,11 @@ export default class ModInfo {
|
|||||||
*/
|
*/
|
||||||
size = 0;
|
size = 0;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Last modification time of the file.
|
||||||
|
*/
|
||||||
|
mtimeMs = 0;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* SHA1 hash of this mod
|
* SHA1 hash of this mod
|
||||||
*/
|
*/
|
||||||
@@ -147,6 +152,7 @@ export default class ModInfo {
|
|||||||
static jsonSchema = Type.Object({
|
static jsonSchema = Type.Object({
|
||||||
...this.infoJsonSchema.properties,
|
...this.infoJsonSchema.properties,
|
||||||
"size": Type.Optional(Type.Integer()),
|
"size": Type.Optional(Type.Integer()),
|
||||||
|
"mtime_ms": Type.Optional(Type.Number()),
|
||||||
"sha1": Type.Optional(Type.String()),
|
"sha1": Type.Optional(Type.String()),
|
||||||
"updated_at_ms": Type.Optional(Type.Number()),
|
"updated_at_ms": Type.Optional(Type.Number()),
|
||||||
"is_deleted": Type.Optional(Type.Boolean()),
|
"is_deleted": Type.Optional(Type.Boolean()),
|
||||||
@@ -170,6 +176,7 @@ export default class ModInfo {
|
|||||||
|
|
||||||
// Additional data
|
// Additional data
|
||||||
if (json.size) { modInfo.size = json.size; }
|
if (json.size) { modInfo.size = json.size; }
|
||||||
|
if (json.mtime_ms) { modInfo.mtimeMs = json.mtime_ms; }
|
||||||
if (json.sha1) { modInfo.sha1 = json.sha1; }
|
if (json.sha1) { modInfo.sha1 = json.sha1; }
|
||||||
if (json.updated_at_ms) { modInfo.updatedAtMs = json.updated_at_ms; }
|
if (json.updated_at_ms) { modInfo.updatedAtMs = json.updated_at_ms; }
|
||||||
if (json.is_deleted) { modInfo.isDeleted = json.is_deleted; }
|
if (json.is_deleted) { modInfo.isDeleted = json.is_deleted; }
|
||||||
@@ -192,6 +199,7 @@ export default class ModInfo {
|
|||||||
json.dependencies = this.dependencies;
|
json.dependencies = this.dependencies;
|
||||||
}
|
}
|
||||||
if (this.size) { json.size = this.size; }
|
if (this.size) { json.size = this.size; }
|
||||||
|
if (this.mtimeMs) { json.mtime_ms = this.mtimeMs; }
|
||||||
if (this.sha1) { json.sha1 = this.sha1; }
|
if (this.sha1) { json.sha1 = this.sha1; }
|
||||||
if (this.updatedAtMs) { json.updated_at_ms = this.updatedAtMs; }
|
if (this.updatedAtMs) { json.updated_at_ms = this.updatedAtMs; }
|
||||||
if (this.isDeleted) { json.is_deleted = this.isDeleted; }
|
if (this.isDeleted) { json.is_deleted = this.isDeleted; }
|
||||||
@@ -229,6 +237,7 @@ export default class ModInfo {
|
|||||||
|
|
||||||
size: stat.size,
|
size: stat.size,
|
||||||
sha1: await libHash.hashFile(modPath),
|
sha1: await libHash.hashFile(modPath),
|
||||||
|
mtime_ms: stat.mtimeMs,
|
||||||
updated_at_ms: stat.mtimeMs,
|
updated_at_ms: stat.mtimeMs,
|
||||||
is_deleted: false,
|
is_deleted: false,
|
||||||
});
|
});
|
||||||
|
|||||||
@@ -2,22 +2,31 @@ import zlib from "zlib";
|
|||||||
import { Type, Static } from "@sinclair/typebox";
|
import { Type, Static } from "@sinclair/typebox";
|
||||||
|
|
||||||
import * as libSchema from "../schema";
|
import * as libSchema from "../schema";
|
||||||
|
import * as libLuaTools from "../lua_tools";
|
||||||
|
|
||||||
import ExportManifest from "./ExportManifest";
|
import ExportManifest from "./ExportManifest";
|
||||||
import { integerFactorioVersion } from "./version";
|
import { integerFactorioVersion } from "./version";
|
||||||
import type { Logger } from "../logging";
|
import type { Logger } from "../logging";
|
||||||
|
|
||||||
|
|
||||||
|
export const ModSettingColor = Type.Object({
|
||||||
|
r: Type.Number(),
|
||||||
|
g: Type.Number(),
|
||||||
|
b: Type.Number(),
|
||||||
|
a: Type.Number(),
|
||||||
|
});
|
||||||
|
export type ModSettingColor = Static<typeof ModSettingColor>;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* A setting for a mod.
|
* A setting for a mod.
|
||||||
*/
|
*/
|
||||||
export interface ModSetting {
|
export interface ModSetting {
|
||||||
/** Value of the given mod setting. */
|
/** Value of the given mod setting. */
|
||||||
value: boolean | number | string;
|
value: boolean | number | string | ModSettingColor;
|
||||||
}
|
}
|
||||||
|
|
||||||
const ModSettingJsonSchema = Type.Object({
|
const ModSettingJsonSchema = Type.Object({
|
||||||
"value": Type.Union([Type.Boolean(), Type.Number(), Type.String()]),
|
"value": Type.Union([Type.Boolean(), Type.Number(), Type.String(), ModSettingColor]),
|
||||||
});
|
});
|
||||||
|
|
||||||
const ModSettingsJsonSchema = Type.Record(Type.String(), ModSettingJsonSchema);
|
const ModSettingsJsonSchema = Type.Record(Type.String(), ModSettingJsonSchema);
|
||||||
@@ -325,17 +334,18 @@ export default class ModPack {
|
|||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Fill in missing settings with their default values
|
* Fill in missing and incorrect settings with their default values
|
||||||
*
|
*
|
||||||
* Uses the provided setting prototypes to add any missing mod settings
|
* Uses the provided setting prototypes to correct any missing and or
|
||||||
* in the mod pack with the default value from the prototype.
|
* incorrect mod settings in the mod pack with the default value from
|
||||||
|
* the prototype.
|
||||||
*
|
*
|
||||||
* @param settingPrototypes -
|
* @param settingPrototypes -
|
||||||
* Setting prototypes exported from the game.
|
* Setting prototypes exported from the game.
|
||||||
* @param logger - Logger used to report warnings on.
|
* @param logger - Logger used to report warnings on.
|
||||||
*/
|
*/
|
||||||
fillDefaultSettings(settingPrototypes: Record<string, object>, logger: Logger) {
|
fillDefaultSettings(settingPrototypes: Record<string, object>, logger: Logger) {
|
||||||
const knownTypes = ["bool-setting", "int-setting", "double-setting", "string-setting"];
|
const knownTypes = ["bool-setting", "int-setting", "double-setting", "string-setting", "color-setting"];
|
||||||
let prototypes = Object.entries(settingPrototypes)
|
let prototypes = Object.entries(settingPrototypes)
|
||||||
.filter(([type, _]) => knownTypes.includes(type))
|
.filter(([type, _]) => knownTypes.includes(type))
|
||||||
.flatMap(([_, settings]) => Object.values(settings))
|
.flatMap(([_, settings]) => Object.values(settings))
|
||||||
@@ -351,11 +361,25 @@ export default class ModPack {
|
|||||||
logger.warn(`Ignoring ${prototype.name} with missing default_value`);
|
logger.warn(`Ignoring ${prototype.name} with missing default_value`);
|
||||||
continue;
|
continue;
|
||||||
}
|
}
|
||||||
if (this.settings[settingType].get(prototype.name)) {
|
let value = this.settings[settingType].get(prototype.name)?.value ?? prototype.default_value;
|
||||||
continue;
|
const type = prototype.type;
|
||||||
|
if (
|
||||||
|
type === "bool-setting" && typeof value !== "boolean"
|
||||||
|
|| type === "color-setting" && typeof value !== "object"
|
||||||
|
|| (type === "int-setting" || type === "double-setting") && typeof value !== "number"
|
||||||
|
) {
|
||||||
|
value = prototype.default_value;
|
||||||
}
|
}
|
||||||
|
if (type === "string-setting" && typeof value !== "string") {
|
||||||
this.settings[settingType].set(prototype.name, { value: prototype.default_value });
|
value = typeof value === "object" ? prototype.default_value : String(value ?? "");
|
||||||
|
}
|
||||||
|
if (type === "color-setting") {
|
||||||
|
if (typeof value !== "object") {
|
||||||
|
value = prototype.default_value;
|
||||||
|
}
|
||||||
|
value = libLuaTools.normalizeColor(value as object);
|
||||||
|
}
|
||||||
|
this.settings[settingType].set(prototype.name, { value });
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -19,12 +19,20 @@ export default class Role {
|
|||||||
permissions: Type.Array(Type.String()),
|
permissions: Type.Array(Type.String()),
|
||||||
});
|
});
|
||||||
|
|
||||||
|
static remapPermission(permission: string) {
|
||||||
|
// migrate: core.instance.save.list.subscribe was renamed in alpha 17
|
||||||
|
if (permission === "core.instance.save.list.subscribe") {
|
||||||
|
return "core.instance.save.subscribe";
|
||||||
|
}
|
||||||
|
return permission;
|
||||||
|
}
|
||||||
|
|
||||||
static fromJSON(json: Static<typeof this.jsonSchema>) {
|
static fromJSON(json: Static<typeof this.jsonSchema>) {
|
||||||
return new this(
|
return new this(
|
||||||
json.id,
|
json.id,
|
||||||
json.name,
|
json.name,
|
||||||
json.description,
|
json.description,
|
||||||
new Set(json.permissions),
|
new Set(json.permissions.map(this.remapPermission)),
|
||||||
);
|
);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
@@ -5,7 +5,7 @@
|
|||||||
*/
|
*/
|
||||||
export { default as ExportManifest } from "./ExportManifest";
|
export { default as ExportManifest } from "./ExportManifest";
|
||||||
export { default as ModInfo } from "./ModInfo";
|
export { default as ModInfo } from "./ModInfo";
|
||||||
export { default as ModPack, ModSetting, ModRecord } from "./ModPack";
|
export { default as ModPack, ModSetting, ModSettingColor, ModRecord } from "./ModPack";
|
||||||
export { default as ModuleInfo } from "./ModuleInfo";
|
export { default as ModuleInfo } from "./ModuleInfo";
|
||||||
export { default as Permission } from "./Permission";
|
export { default as Permission } from "./Permission";
|
||||||
export { default as PlayerStats } from "./PlayerStats";
|
export { default as PlayerStats } from "./PlayerStats";
|
||||||
|
|||||||
@@ -87,7 +87,7 @@ export class Address {
|
|||||||
}
|
}
|
||||||
|
|
||||||
toString() {
|
toString() {
|
||||||
const typeMap = ["controller", "instance", "host", "control"];
|
const typeMap = ["controller", "host", "instance", "control"];
|
||||||
const type = typeMap[this.type] || this.type;
|
const type = typeMap[this.type] || this.type;
|
||||||
if (this.type === Address.broadcast) {
|
if (this.type === Address.broadcast) {
|
||||||
return `[Address ${type}:${typeMap[this.id] || this.id}]`;
|
return `[Address ${type}:${typeMap[this.id] || this.id}]`;
|
||||||
|
|||||||
@@ -208,7 +208,7 @@ export class InstanceConfigSetPropRequest {
|
|||||||
"instanceId": Type.Integer(),
|
"instanceId": Type.Integer(),
|
||||||
"field": Type.String(),
|
"field": Type.String(),
|
||||||
"prop": Type.String(),
|
"prop": Type.String(),
|
||||||
"value": Type.Unknown(),
|
"value": Type.Optional(Type.Unknown()),
|
||||||
});
|
});
|
||||||
|
|
||||||
static fromJSON(json: Static<typeof this.jsonSchema>) {
|
static fromJSON(json: Static<typeof this.jsonSchema>) {
|
||||||
@@ -361,7 +361,7 @@ export class InstanceSaveDetailsUpdatesEvent {
|
|||||||
static type = "event" as const;
|
static type = "event" as const;
|
||||||
static src = ["instance", "host", "controller"] as const;
|
static src = ["instance", "host", "controller"] as const;
|
||||||
static dst = ["controller", "control"] as const;
|
static dst = ["controller", "control"] as const;
|
||||||
static permission = "core.instance.save.list.subscribe" as const;
|
static permission = "core.instance.save.subscribe" as const;
|
||||||
|
|
||||||
constructor(
|
constructor(
|
||||||
public updates: SaveDetails[],
|
public updates: SaveDetails[],
|
||||||
@@ -385,7 +385,7 @@ export class InstanceSaveDetailsUpdatesEvent {
|
|||||||
export class InstanceCreateSaveRequest {
|
export class InstanceCreateSaveRequest {
|
||||||
declare ["constructor"]: typeof InstanceCreateSaveRequest;
|
declare ["constructor"]: typeof InstanceCreateSaveRequest;
|
||||||
static type = "request" as const;
|
static type = "request" as const;
|
||||||
static src = "control" as const;
|
static src = ["control", "controller"] as const;
|
||||||
static dst = "instance" as const;
|
static dst = "instance" as const;
|
||||||
static permission = "core.instance.save.create" as const;
|
static permission = "core.instance.save.create" as const;
|
||||||
|
|
||||||
@@ -596,7 +596,7 @@ export class InstancePushSaveRequest {
|
|||||||
export class InstanceLoadScenarioRequest {
|
export class InstanceLoadScenarioRequest {
|
||||||
declare ["constructor"]: typeof InstanceLoadScenarioRequest;
|
declare ["constructor"]: typeof InstanceLoadScenarioRequest;
|
||||||
static type = "request" as const;
|
static type = "request" as const;
|
||||||
static src = "control" as const;
|
static src = ["control", "controller"] as const;
|
||||||
static dst = "instance" as const;
|
static dst = "instance" as const;
|
||||||
static permission = "core.instance.load_scenario" as const;
|
static permission = "core.instance.load_scenario" as const;
|
||||||
|
|
||||||
@@ -622,7 +622,7 @@ export class InstanceLoadScenarioRequest {
|
|||||||
export class InstanceExportDataRequest {
|
export class InstanceExportDataRequest {
|
||||||
declare ["constructor"]: typeof InstanceExportDataRequest;
|
declare ["constructor"]: typeof InstanceExportDataRequest;
|
||||||
static type = "request" as const;
|
static type = "request" as const;
|
||||||
static src = "control" as const;
|
static src = ["control", "controller"] as const;
|
||||||
static dst = "instance" as const;
|
static dst = "instance" as const;
|
||||||
static permission = "core.instance.export_data" as const;
|
static permission = "core.instance.export_data" as const;
|
||||||
}
|
}
|
||||||
@@ -630,7 +630,7 @@ export class InstanceExportDataRequest {
|
|||||||
export class InstanceExtractPlayersRequest {
|
export class InstanceExtractPlayersRequest {
|
||||||
declare ["constructor"]: typeof InstanceExtractPlayersRequest;
|
declare ["constructor"]: typeof InstanceExtractPlayersRequest;
|
||||||
static type = "request" as const;
|
static type = "request" as const;
|
||||||
static src = "control" as const;
|
static src = ["control", "controller"] as const;
|
||||||
static dst = "instance" as const;
|
static dst = "instance" as const;
|
||||||
static permission = "core.instance.extract_players" as const;
|
static permission = "core.instance.extract_players" as const;
|
||||||
}
|
}
|
||||||
@@ -638,7 +638,7 @@ export class InstanceExtractPlayersRequest {
|
|||||||
export class InstanceStopRequest {
|
export class InstanceStopRequest {
|
||||||
declare ["constructor"]: typeof InstanceStopRequest;
|
declare ["constructor"]: typeof InstanceStopRequest;
|
||||||
static type = "request" as const;
|
static type = "request" as const;
|
||||||
static src = "control" as const;
|
static src = ["control", "controller"] as const;
|
||||||
static dst = "instance" as const;
|
static dst = "instance" as const;
|
||||||
static permission = "core.instance.stop" as const;
|
static permission = "core.instance.stop" as const;
|
||||||
}
|
}
|
||||||
@@ -646,7 +646,7 @@ export class InstanceStopRequest {
|
|||||||
export class InstanceKillRequest {
|
export class InstanceKillRequest {
|
||||||
declare ["constructor"]: typeof InstanceKillRequest;
|
declare ["constructor"]: typeof InstanceKillRequest;
|
||||||
static type = "request" as const;
|
static type = "request" as const;
|
||||||
static src = "control" as const;
|
static src = ["control", "controller"] as const;
|
||||||
static dst = "instance" as const;
|
static dst = "instance" as const;
|
||||||
static permission = "core.instance.kill" as const;
|
static permission = "core.instance.kill" as const;
|
||||||
}
|
}
|
||||||
@@ -693,7 +693,7 @@ export class InstanceDeleteInternalRequest {
|
|||||||
export class InstanceSendRconRequest {
|
export class InstanceSendRconRequest {
|
||||||
declare ["constructor"]: typeof InstanceSendRconRequest;
|
declare ["constructor"]: typeof InstanceSendRconRequest;
|
||||||
static type = "request" as const;
|
static type = "request" as const;
|
||||||
static src = "control" as const;
|
static src = ["control", "controller"] as const;
|
||||||
static dst = "instance" as const;
|
static dst = "instance" as const;
|
||||||
static permission = "core.instance.send_rcon" as const;
|
static permission = "core.instance.send_rcon" as const;
|
||||||
|
|
||||||
|
|||||||
@@ -33,7 +33,30 @@ export abstract class BaseConnector extends events.EventEmitter {
|
|||||||
this._seq = 1;
|
this._seq = 1;
|
||||||
}
|
}
|
||||||
|
|
||||||
abstract send(message: libData.Message): void;
|
protected abstract send(message: libData.MessageRoutable): void;
|
||||||
|
|
||||||
|
forward(message: libData.MessageRoutable) {
|
||||||
|
const seq = this._seq;
|
||||||
|
this._seq += 1;
|
||||||
|
// The message type currently can't be inferred like a tagged union
|
||||||
|
// TODO fix typing of message so it can be deduced from .type
|
||||||
|
if (message.type === "request") {
|
||||||
|
const request = message as libData.MessageRequest;
|
||||||
|
this.send(new libData.MessageRequest(seq, request.src, request.dst, request.name, request.data));
|
||||||
|
} else if (message.type === "response") {
|
||||||
|
const response = message as libData.MessageResponse;
|
||||||
|
this.send(new libData.MessageResponse(seq, response.src, response.dst, response.data));
|
||||||
|
} else if (message.type === "responseError") {
|
||||||
|
const error = message as libData.MessageResponseError;
|
||||||
|
this.send(new libData.MessageResponseError(seq, error.src, error.dst, error.data));
|
||||||
|
} else if (message.type === "event") {
|
||||||
|
const event = message as libData.MessageEvent;
|
||||||
|
this.send(new libData.MessageEvent(seq, event.src, event.dst, event.name, event.data));
|
||||||
|
} else {
|
||||||
|
throw new Error(`Cannot forward message type ${(message as any).type}`);
|
||||||
|
}
|
||||||
|
return seq;
|
||||||
|
}
|
||||||
|
|
||||||
sendRequest<Req, Res>(
|
sendRequest<Req, Res>(
|
||||||
request: Request<Req, Res>,
|
request: Request<Req, Res>,
|
||||||
@@ -242,7 +265,7 @@ export abstract class WebSocketBaseConnector extends BaseConnector {
|
|||||||
*
|
*
|
||||||
* @param message - Message to send.
|
* @param message - Message to send.
|
||||||
*/
|
*/
|
||||||
send(message: libData.MessageRoutable) {
|
protected send(message: libData.MessageRoutable) {
|
||||||
if (!["connected", "resuming"].includes(this._state)) {
|
if (!["connected", "resuming"].includes(this._state)) {
|
||||||
throw new libErrors.SessionLost("No session");
|
throw new libErrors.SessionLost("No session");
|
||||||
}
|
}
|
||||||
@@ -295,6 +318,13 @@ export abstract class WebSocketBaseConnector extends BaseConnector {
|
|||||||
await this.close(1000, "Disconnect");
|
await this.close(1000, "Disconnect");
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Notify other end that the link is ready to disconnect
|
||||||
|
*/
|
||||||
|
sendDisconnectReady() {
|
||||||
|
this._sendInternal(new libData.MessageDisconnect("ready"));
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* True if the connection is established and active
|
* True if the connection is established and active
|
||||||
*/
|
*/
|
||||||
|
|||||||
@@ -72,7 +72,12 @@ export type RequestHandler<Req, Res> = (request: Req, src: libData.Address, dst:
|
|||||||
export type EventHandler<T> = (event: T, src: libData.Address, dst: libData.Address) => Promise<void>;
|
export type EventHandler<T> = (event: T, src: libData.Address, dst: libData.Address) => Promise<void>;
|
||||||
|
|
||||||
interface Router {
|
interface Router {
|
||||||
forwardMessage(origin: Link, message: MessageRoutable, fallback: boolean): boolean,
|
forwardMessage(
|
||||||
|
origin: Link,
|
||||||
|
message: MessageRoutable,
|
||||||
|
entry: RequestEntry | EventEntry | undefined,
|
||||||
|
fallback: boolean,
|
||||||
|
): boolean,
|
||||||
}
|
}
|
||||||
|
|
||||||
// Some definitions for the terminology used here:
|
// Some definitions for the terminology used here:
|
||||||
@@ -102,6 +107,9 @@ export class Link {
|
|||||||
) {
|
) {
|
||||||
this.handle(libData.PingRequest, async () => {});
|
this.handle(libData.PingRequest, async () => {});
|
||||||
|
|
||||||
|
// Prevent warnings about possible memory leak due to large number of event listeners
|
||||||
|
connector.setMaxListeners(20);
|
||||||
|
|
||||||
// Process messages received by the connector
|
// Process messages received by the connector
|
||||||
connector.on("message", payload => {
|
connector.on("message", payload => {
|
||||||
try {
|
try {
|
||||||
@@ -121,15 +129,15 @@ export class Link {
|
|||||||
});
|
});
|
||||||
|
|
||||||
connector.on("disconnectPrepare", () => {
|
connector.on("disconnectPrepare", () => {
|
||||||
this.prepareDisconnect().catch(
|
this.prepareDisconnect().finally(() => {
|
||||||
err => {
|
// Only WebSocket connectors issue disconnection events.
|
||||||
logger.error(`Unexpected error preparing disconnect:\n${err.stack}`);
|
const webSocketConnector = this.connector as WebSocketBaseConnector;
|
||||||
|
if (webSocketConnector.hasSession) {
|
||||||
|
webSocketConnector.sendDisconnectReady();
|
||||||
}
|
}
|
||||||
).finally(
|
}).catch(err => {
|
||||||
() => {
|
logger.error(`Unexpected error preparing disconnect:\n${err.stack}`);
|
||||||
this.connector.send(new libData.MessageDisconnect("ready"));
|
});
|
||||||
},
|
|
||||||
);
|
|
||||||
});
|
});
|
||||||
|
|
||||||
connector.on("invalidate", () => {
|
connector.on("invalidate", () => {
|
||||||
@@ -141,17 +149,30 @@ export class Link {
|
|||||||
});
|
});
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Count of requests currently waiting for a response on this link
|
||||||
|
*/
|
||||||
|
get pendingRequestCount() {
|
||||||
|
return this._pendingRequests.size + this._forwardedRequests.size;
|
||||||
|
}
|
||||||
|
|
||||||
_clearPendingRequests(err: Error & { code?: string }) {
|
_clearPendingRequests(err: Error & { code?: string }) {
|
||||||
for (let pending of this._pendingRequests.values()) {
|
for (let pending of this._pendingRequests.values()) {
|
||||||
pending.reject(err);
|
pending.reject(err);
|
||||||
}
|
}
|
||||||
for (let pending of this._forwardedRequests.values()) {
|
for (let pending of this._forwardedRequests.values()) {
|
||||||
assert(pending.origin.connector instanceof WebSocketBaseConnector);
|
// Drop response if the origin is a WebSocket and the session
|
||||||
if (pending.origin.connector.hasSession) {
|
// has expired. The other end of the link will have sent an
|
||||||
pending.origin.connector.sendResponseError(
|
// error response to the request in this case.
|
||||||
new libData.ResponseError(err.message, err.code), pending.src, pending.dst
|
if (
|
||||||
);
|
pending.origin.connector instanceof WebSocketBaseConnector
|
||||||
|
&& !pending.origin.connector.hasSession
|
||||||
|
) {
|
||||||
|
continue;
|
||||||
}
|
}
|
||||||
|
pending.origin.connector.sendResponseError(
|
||||||
|
new libData.ResponseError(err.message, err.code), pending.src, pending.dst
|
||||||
|
);
|
||||||
}
|
}
|
||||||
this._pendingRequests.clear();
|
this._pendingRequests.clear();
|
||||||
this._forwardedRequests.clear();
|
this._forwardedRequests.clear();
|
||||||
@@ -330,7 +351,7 @@ export class Link {
|
|||||||
let fallback =
|
let fallback =
|
||||||
message.type === "request" ? this._requestFallbacks.get((entry as RequestEntry).Request) : undefined
|
message.type === "request" ? this._requestFallbacks.get((entry as RequestEntry).Request) : undefined
|
||||||
;
|
;
|
||||||
if (this.router.forwardMessage(this, message, Boolean(fallback))) {
|
if (this.router.forwardMessage(this, message, entry, Boolean(fallback))) {
|
||||||
return;
|
return;
|
||||||
}
|
}
|
||||||
if (!fallback) {
|
if (!fallback) {
|
||||||
@@ -421,6 +442,7 @@ export class Link {
|
|||||||
throw new libErrors.InvalidMessage(`Received reply from ${message.src} for message sent to ${pending.dst}`);
|
throw new libErrors.InvalidMessage(`Received reply from ${message.src} for message sent to ${pending.dst}`);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
this._pendingRequests.delete(message.dst.requestId!);
|
||||||
try {
|
try {
|
||||||
pending.resolve(pending.request.responseFromJSON(message.data));
|
pending.resolve(pending.request.responseFromJSON(message.data));
|
||||||
} catch (err: any) {
|
} catch (err: any) {
|
||||||
@@ -437,6 +459,7 @@ export class Link {
|
|||||||
);
|
);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
this._pendingRequests.delete(message.dst.requestId!);
|
||||||
pending.reject(new libErrors.RequestError(message.data.message, message.data.code, message.data.stack));
|
pending.reject(new libErrors.RequestError(message.data.message, message.data.code, message.data.stack));
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -541,7 +564,7 @@ export class Link {
|
|||||||
dst: message.dst,
|
dst: message.dst,
|
||||||
};
|
};
|
||||||
this._forwardedRequests.set(message.src.index(), pending);
|
this._forwardedRequests.set(message.src.index(), pending);
|
||||||
this.connector.send(message);
|
this.connector.forward(message);
|
||||||
}
|
}
|
||||||
|
|
||||||
sendEvent<T>(event: Event<T>, dst: libData.Address) {
|
sendEvent<T>(event: Event<T>, dst: libData.Address) {
|
||||||
|
|||||||
@@ -8,8 +8,9 @@ export const levels = Object.freeze({
|
|||||||
warn: 2,
|
warn: 2,
|
||||||
audit: 3,
|
audit: 3,
|
||||||
info: 4,
|
info: 4,
|
||||||
server: 5,
|
http: 5,
|
||||||
verbose: 6,
|
server: 6,
|
||||||
|
verbose: 7,
|
||||||
});
|
});
|
||||||
|
|
||||||
export const colors = {
|
export const colors = {
|
||||||
@@ -18,6 +19,7 @@ export const colors = {
|
|||||||
warn: "bold brightYellow",
|
warn: "bold brightYellow",
|
||||||
audit: "bold brightGreen",
|
audit: "bold brightGreen",
|
||||||
info: "bold brightBlue",
|
info: "bold brightBlue",
|
||||||
|
http: "bold",
|
||||||
server: "bold",
|
server: "bold",
|
||||||
verbose: "bold grey",
|
verbose: "bold grey",
|
||||||
} as const;
|
} as const;
|
||||||
@@ -73,7 +75,7 @@ export class WebConsoleFormat {
|
|||||||
transform(info: any, _options: object) {
|
transform(info: any, _options: object) {
|
||||||
let src = " ";
|
let src = " ";
|
||||||
if (info.host_id !== undefined) {
|
if (info.host_id !== undefined) {
|
||||||
src += `s:${info.host_name} - `;
|
src += `h:${info.host_name} - `;
|
||||||
}
|
}
|
||||||
if (info.instance_id !== undefined) {
|
if (info.instance_id !== undefined) {
|
||||||
src += `i:${info.instance_name}`;
|
src += `i:${info.instance_name}`;
|
||||||
@@ -163,7 +165,7 @@ export const logger = winston.createLogger({
|
|||||||
// Who in their right mind thought that log levels should be hard coded
|
// Who in their right mind thought that log levels should be hard coded
|
||||||
// into the type when you can define custom levels you want to support?
|
// into the type when you can define custom levels you want to support?
|
||||||
export type Logger = Omit<winston.Logger,
|
export type Logger = Omit<winston.Logger,
|
||||||
"error" | "warn" | "help" | "data" | "info" | "debug" | "prompt" | "http" | "verbose" | "input" | "silly" |
|
"error" | "warn" | "help" | "data" | "info" | "debug" | "prompt" | "verbose" | "input" | "silly" |
|
||||||
"emerg" | "alert" | "crit" | "warning" | "notice" |
|
"emerg" | "alert" | "crit" | "warning" | "notice" |
|
||||||
"child"
|
"child"
|
||||||
> & {
|
> & {
|
||||||
@@ -172,6 +174,7 @@ export type Logger = Omit<winston.Logger,
|
|||||||
warn: winston.LeveledLogMethod,
|
warn: winston.LeveledLogMethod,
|
||||||
audit: winston.LeveledLogMethod,
|
audit: winston.LeveledLogMethod,
|
||||||
info: winston.LeveledLogMethod,
|
info: winston.LeveledLogMethod,
|
||||||
|
http: winston.LeveledLogMethod,
|
||||||
server: winston.LeveledLogMethod,
|
server: winston.LeveledLogMethod,
|
||||||
verbose: winston.LeveledLogMethod,
|
verbose: winston.LeveledLogMethod,
|
||||||
child(options: object): Logger,
|
child(options: object): Logger,
|
||||||
|
|||||||
@@ -163,7 +163,7 @@ export class TerminalFormat {
|
|||||||
src += `i:${info.instance_name} `;
|
src += `i:${info.instance_name} `;
|
||||||
|
|
||||||
} else if (info.host_name) {
|
} else if (info.host_name) {
|
||||||
src += `s:${info.host_name} `;
|
src += `h:${info.host_name} `;
|
||||||
}
|
}
|
||||||
if (info.plugin) {
|
if (info.plugin) {
|
||||||
src += `${info.plugin}: `;
|
src += `${info.plugin}: `;
|
||||||
|
|||||||
@@ -3,6 +3,54 @@
|
|||||||
* @module lib/lua_tools
|
* @module lib/lua_tools
|
||||||
*/
|
*/
|
||||||
|
|
||||||
|
/**
|
||||||
|
* A colour as it may originate from Factorio Lua code, see
|
||||||
|
* https://lua-api.factorio.com/latest/types/Color.html
|
||||||
|
*/
|
||||||
|
export type FactorioColor = { r?: number, g?: number, b?: number, a?: number } | [number, number, number, number?];
|
||||||
|
|
||||||
|
export type Color = { r: number, g: number, b: number, a: number };
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Normalise a color as it may appear in Factorio Lua code to be an object
|
||||||
|
* with r, g, b, a properties in the range 0 to 1.
|
||||||
|
*
|
||||||
|
* @param color -
|
||||||
|
* A colour that may be specified with left out components or as an
|
||||||
|
* array and have the range 1 to 0 or 255 to 0.
|
||||||
|
* @returns
|
||||||
|
* Normalised colour where all 4 components are present as properties in
|
||||||
|
* the range 0 to 1.
|
||||||
|
*/
|
||||||
|
export function normalizeColor(color: FactorioColor) {
|
||||||
|
let r, g, b, a;
|
||||||
|
if (color instanceof Array) {
|
||||||
|
([r, g, b, a] = color);
|
||||||
|
} else {
|
||||||
|
({ r, g, b, a } = color);
|
||||||
|
}
|
||||||
|
|
||||||
|
r ??= NaN;
|
||||||
|
g ??= NaN;
|
||||||
|
b ??= NaN;
|
||||||
|
a ??= NaN;
|
||||||
|
|
||||||
|
// Note NaN > 1 is false and NaN / 255 is NaN
|
||||||
|
if (r > 1 || g > 1 || b > 1 || a > 1) {
|
||||||
|
r /= 255;
|
||||||
|
g /= 255;
|
||||||
|
b /= 255;
|
||||||
|
a /= 255;
|
||||||
|
}
|
||||||
|
|
||||||
|
return {
|
||||||
|
r: Number.isNaN(r) ? 0 : r,
|
||||||
|
g: Number.isNaN(g) ? 0 : g,
|
||||||
|
b: Number.isNaN(b) ? 0 : b,
|
||||||
|
a: Number.isNaN(a) ? 1 : a,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Escapes a string for inclusion into a lua string
|
* Escapes a string for inclusion into a lua string
|
||||||
*
|
*
|
||||||
|
|||||||
@@ -239,11 +239,11 @@ definePermission({
|
|||||||
definePermission({
|
definePermission({
|
||||||
name: "core.instance.save.list",
|
name: "core.instance.save.list",
|
||||||
title: "List saves",
|
title: "List saves",
|
||||||
description: "List the saves currently on the instance.",
|
description: "List the saves currently on instances.",
|
||||||
});
|
});
|
||||||
definePermission({
|
definePermission({
|
||||||
name: "core.instance.save.list.subscribe",
|
name: "core.instance.save.subscribe",
|
||||||
title: "Subscribe to save list updatess",
|
title: "Subscribe to save updates",
|
||||||
description: "Subscribe to be notifed on updates to the list of saves of instances.",
|
description: "Subscribe to be notifed on updates to the list of saves of instances.",
|
||||||
});
|
});
|
||||||
definePermission({
|
definePermission({
|
||||||
|
|||||||
@@ -2,6 +2,7 @@ import { Type, Static } from "@sinclair/typebox";
|
|||||||
import { Link, Event, EventClass, RequestHandler, WebSocketClientConnector, WebSocketBaseConnector } from "./link";
|
import { Link, Event, EventClass, RequestHandler, WebSocketClientConnector, WebSocketBaseConnector } from "./link";
|
||||||
import { logger } from "./logging";
|
import { logger } from "./logging";
|
||||||
import { Address, MessageRequest, IControllerUser } from "./data";
|
import { Address, MessageRequest, IControllerUser } from "./data";
|
||||||
|
import isDeepStrictEqual from "./is_deep_strict_equal";
|
||||||
|
|
||||||
export type SubscriptionRequestHandler<T> = RequestHandler<SubscriptionRequest, Event<T> | null>;
|
export type SubscriptionRequestHandler<T> = RequestHandler<SubscriptionRequest, Event<T> | null>;
|
||||||
export type EventSubscriberCallback<T> = (updates: T[], synced: boolean) => void
|
export type EventSubscriberCallback<T> = (updates: T[], synced: boolean) => void
|
||||||
@@ -204,6 +205,14 @@ export class EventSubscriber<
|
|||||||
async _handle(event: EventSubscribable<T, V>) {
|
async _handle(event: EventSubscribable<T, V>) {
|
||||||
for (const value of event.updates) {
|
for (const value of event.updates) {
|
||||||
this.lastResponseTimeMs = Math.max(this.lastResponseTimeMs, value.updatedAtMs);
|
this.lastResponseTimeMs = Math.max(this.lastResponseTimeMs, value.updatedAtMs);
|
||||||
|
// Warn about updates which changes content but don't update updatedAtMs
|
||||||
|
const existing = this.values.get(value.id as K);
|
||||||
|
if (existing && existing.updatedAtMs === value.updatedAtMs && !isDeepStrictEqual(existing, value)) {
|
||||||
|
logger.warn(
|
||||||
|
`${this.Event.name} contains update for value with id ${value.id} that has an identical ` +
|
||||||
|
"updatedAtMs timestamp but differing content"
|
||||||
|
);
|
||||||
|
}
|
||||||
if (value.isDeleted) {
|
if (value.isDeleted) {
|
||||||
this.values.delete(value.id as K);
|
this.values.delete(value.id as K);
|
||||||
} else {
|
} else {
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
{
|
{
|
||||||
"extends": "../../tsconfig.web.json",
|
"extends": "../../tsconfig.browser.json",
|
||||||
"include": [
|
"include": [
|
||||||
"browser.ts",
|
"browser.ts",
|
||||||
"package.json",
|
"package.json",
|
||||||
@@ -12,6 +12,7 @@
|
|||||||
"./src/hash.ts",
|
"./src/hash.ts",
|
||||||
"./src/ini.ts",
|
"./src/ini.ts",
|
||||||
"./src/link/*.ts",
|
"./src/link/*.ts",
|
||||||
|
"./src/lua_tools.ts",
|
||||||
"./src/logging.ts",
|
"./src/logging.ts",
|
||||||
"./src/permissions.ts",
|
"./src/permissions.ts",
|
||||||
"./src/prometheus.ts",
|
"./src/prometheus.ts",
|
||||||
@@ -25,6 +26,6 @@
|
|||||||
],
|
],
|
||||||
"compilerOptions": {
|
"compilerOptions": {
|
||||||
"rootDir": ".",
|
"rootDir": ".",
|
||||||
"outDir": "dist/web/build",
|
"outDir": "dist/browser",
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -1,8 +1,7 @@
|
|||||||
{
|
{
|
||||||
"extends": "../../tsconfig.node.json",
|
"files": [],
|
||||||
"include": ["index.ts", "browser.ts", "build_mod.js", "src/**/*.ts", "src/**/*.js"],
|
"references": [
|
||||||
"compilerOptions": {
|
{ "path": "./tsconfig.node.json" },
|
||||||
"outDir": "dist",
|
{ "path": "./tsconfig.browser.json" },
|
||||||
"allowJs": true,
|
],
|
||||||
},
|
|
||||||
}
|
}
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
{
|
||||||
|
"extends": "../../tsconfig.node.json",
|
||||||
|
"include": ["index.ts", "browser.ts", "build_mod.js", "src/**/*.ts", "src/**/*.js"],
|
||||||
|
"compilerOptions": {
|
||||||
|
"outDir": "dist/node",
|
||||||
|
"allowJs": true,
|
||||||
|
},
|
||||||
|
}
|
||||||
@@ -3,9 +3,9 @@
|
|||||||
"description": "Clusterio web interface implementation",
|
"description": "Clusterio web interface implementation",
|
||||||
"author": "Hornwitser",
|
"author": "Hornwitser",
|
||||||
"license": "MIT",
|
"license": "MIT",
|
||||||
"version": "2.0.0-alpha.14",
|
"version": "2.0.0-alpha.18",
|
||||||
"browser": "src/index.ts",
|
"browser": "src/index.ts",
|
||||||
"main": "dist/src/index.js",
|
"main": "dist/browser/src/index.js",
|
||||||
"scripts": {
|
"scripts": {
|
||||||
"test": "echo \"Error: no test specified\" && exit 1"
|
"test": "echo \"Error: no test specified\" && exit 1"
|
||||||
},
|
},
|
||||||
@@ -17,12 +17,10 @@
|
|||||||
},
|
},
|
||||||
"dependencies": {
|
"dependencies": {
|
||||||
"@ant-design/icons": "^5.1.4",
|
"@ant-design/icons": "^5.1.4",
|
||||||
"@babel/core": "^7.22.9",
|
"@clusterio/lib": "^2.0.0-alpha.18",
|
||||||
"@babel/preset-react": "^7.22.5",
|
"@swc/core": "^1.4.0",
|
||||||
"@clusterio/lib": "^2.0.0-alpha.14",
|
|
||||||
"antd": "^5.13.0",
|
"antd": "^5.13.0",
|
||||||
"assert": "^2.0.0",
|
"assert": "^2.0.0",
|
||||||
"babel-loader": "^9.1.3",
|
|
||||||
"browserify-zlib": "^0.2.0",
|
"browserify-zlib": "^0.2.0",
|
||||||
"buffer": "^6.0.3",
|
"buffer": "^6.0.3",
|
||||||
"clean-webpack-plugin": "^4.0.0",
|
"clean-webpack-plugin": "^4.0.0",
|
||||||
@@ -39,8 +37,8 @@
|
|||||||
"react-router-dom": "^6.14.2",
|
"react-router-dom": "^6.14.2",
|
||||||
"stream-browserify": "^3.0.0",
|
"stream-browserify": "^3.0.0",
|
||||||
"style-loader": "^3.3.3",
|
"style-loader": "^3.3.3",
|
||||||
|
"swc-loader": "^0.2.6",
|
||||||
"terser-webpack-plugin": "^5.3.9",
|
"terser-webpack-plugin": "^5.3.9",
|
||||||
"ts-loader": "^9.4.4",
|
|
||||||
"typescript": "^5.1.6",
|
"typescript": "^5.1.6",
|
||||||
"util": "^0.12.5",
|
"util": "^0.12.5",
|
||||||
"webpack": "^5.88.2",
|
"webpack": "^5.88.2",
|
||||||
|
|||||||
@@ -104,16 +104,16 @@ export default function App(props: AppProps) {
|
|||||||
}
|
}
|
||||||
|
|
||||||
return (
|
return (
|
||||||
<ErrorBoundary Component={ErrorCard}>
|
<ConfigProvider
|
||||||
<ConfigProvider
|
theme={{ algorithm: theme.darkAlgorithm }}
|
||||||
theme={{ algorithm: theme.darkAlgorithm }}
|
>
|
||||||
>
|
<ErrorBoundary Component={ErrorCard}>
|
||||||
<ControlContext.Provider value={props.control}>
|
<ControlContext.Provider value={props.control}>
|
||||||
<BrowserRouter basename={webRoot}>
|
<BrowserRouter basename={webRoot}>
|
||||||
{page}
|
{page}
|
||||||
</BrowserRouter>
|
</BrowserRouter>
|
||||||
</ControlContext.Provider>
|
</ControlContext.Provider>
|
||||||
</ConfigProvider>
|
</ErrorBoundary>
|
||||||
</ErrorBoundary>
|
</ConfigProvider>
|
||||||
);
|
);
|
||||||
}
|
}
|
||||||
@@ -27,6 +27,8 @@ export default function ControllerConfigTree() {
|
|||||||
} catch (err) {
|
} catch (err) {
|
||||||
return;
|
return;
|
||||||
}
|
}
|
||||||
|
} else {
|
||||||
|
value = undefined;
|
||||||
}
|
}
|
||||||
await control.send(new lib.ControllerConfigSetPropRequest(field, prop, value));
|
await control.send(new lib.ControllerConfigSetPropRequest(field, prop, value));
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -24,6 +24,8 @@ export default function HostConfigTree(props: { id: number, available: boolean }
|
|||||||
} catch (err) {
|
} catch (err) {
|
||||||
return;
|
return;
|
||||||
}
|
}
|
||||||
|
} else {
|
||||||
|
value = undefined;
|
||||||
}
|
}
|
||||||
await control.sendTo({ hostId: props.id }, new lib.HostConfigSetPropRequest(field, prop, value));
|
await control.sendTo({ hostId: props.id }, new lib.HostConfigSetPropRequest(field, prop, value));
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -48,7 +48,7 @@ export default function HostViewPage() {
|
|||||||
|
|
||||||
let hostButtons = <Space>
|
let hostButtons = <Space>
|
||||||
{
|
{
|
||||||
account.hasPermission("core.host.revoke_access")
|
account.hasPermission("core.host.revoke_token")
|
||||||
&& <Popconfirm
|
&& <Popconfirm
|
||||||
title={`Revoke tokens of ${host.name}?`}
|
title={`Revoke tokens of ${host.name}?`}
|
||||||
placement="bottomRight"
|
placement="bottomRight"
|
||||||
|
|||||||
@@ -28,6 +28,8 @@ export default function InstanceConfigTree(props: InstanceConfigTreeProps) {
|
|||||||
} catch (err) {
|
} catch (err) {
|
||||||
return;
|
return;
|
||||||
}
|
}
|
||||||
|
} else {
|
||||||
|
value = undefined;
|
||||||
}
|
}
|
||||||
await control.send(new lib.InstanceConfigSetPropRequest(props.id, field, prop, value));
|
await control.send(new lib.InstanceConfigSetPropRequest(props.id, field, prop, value));
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
import React from "react";
|
import React from "react";
|
||||||
import { useNavigate } from "react-router-dom";
|
import { useNavigate } from "react-router-dom";
|
||||||
import { message, Button, Space, Table } from "antd";
|
import { message, Button, Space, Table, Typography } from "antd";
|
||||||
import CopyOutlined from "@ant-design/icons/CopyOutlined";
|
import CopyOutlined from "@ant-design/icons/CopyOutlined";
|
||||||
import type { SizeType } from "antd/es/config-provider/SizeContext";
|
import type { SizeType } from "antd/es/config-provider/SizeContext";
|
||||||
import type { ColumnsType } from "antd/es/table";
|
import type { ColumnsType } from "antd/es/table";
|
||||||
@@ -10,6 +10,7 @@ import { useHosts } from "../model/host";
|
|||||||
import InstanceStatusTag from "./InstanceStatusTag";
|
import InstanceStatusTag from "./InstanceStatusTag";
|
||||||
import StartStopInstanceButton from "./StartStopInstanceButton";
|
import StartStopInstanceButton from "./StartStopInstanceButton";
|
||||||
import { InstanceDetails } from "@clusterio/lib";
|
import { InstanceDetails } from "@clusterio/lib";
|
||||||
|
import Link from "./Link";
|
||||||
|
|
||||||
const strcmp = new Intl.Collator(undefined, { numeric: true, sensitivity: "base" }).compare;
|
const strcmp = new Intl.Collator(undefined, { numeric: true, sensitivity: "base" }).compare;
|
||||||
|
|
||||||
@@ -55,7 +56,12 @@ export default function InstanceList(props: InstanceListProps) {
|
|||||||
{
|
{
|
||||||
title: "Assigned Host",
|
title: "Assigned Host",
|
||||||
key: "assignedHost",
|
key: "assignedHost",
|
||||||
render: (_, instance) => hostName(instance.assignedHost),
|
render: (_, instance) => <Link
|
||||||
|
to={`/hosts/${instance.assignedHost}/view`}
|
||||||
|
onClick={e => e.stopPropagation()}
|
||||||
|
>
|
||||||
|
{hostName(instance.assignedHost)}
|
||||||
|
</Link>,
|
||||||
sorter: (a, b) => strcmp(hostName(a.assignedHost), hostName(b.assignedHost)),
|
sorter: (a, b) => strcmp(hostName(a.assignedHost), hostName(b.assignedHost)),
|
||||||
responsive: ["sm"],
|
responsive: ["sm"],
|
||||||
},
|
},
|
||||||
@@ -68,10 +74,10 @@ export default function InstanceList(props: InstanceListProps) {
|
|||||||
{publicAddress}
|
{publicAddress}
|
||||||
<Button
|
<Button
|
||||||
type="text"
|
type="text"
|
||||||
icon={<CopyOutlined/>}
|
icon={<CopyOutlined />}
|
||||||
onClick={(e) => {
|
onClick={(e) => {
|
||||||
e.stopPropagation();
|
e.stopPropagation();
|
||||||
navigator.clipboard.writeText(publicAddress??"");
|
navigator.clipboard.writeText(publicAddress ?? "");
|
||||||
message.success("Copied public address!");
|
message.success("Copied public address!");
|
||||||
}}
|
}}
|
||||||
/>
|
/>
|
||||||
|
|||||||
Loaded 100 of 192 files, more files were not shown because too many files have changed in this diff.
Show more
Reference in new issue
Block a user