arui-scripts 0.0.0-beta-20260824133302

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (247) hide show
  1. package/.eslintignore +2 -0
  2. package/.eslintrc.js +17 -0
  3. package/.prettierignore +2 -0
  4. package/.turbo/turbo-build.log +0 -0
  5. package/.turbo/turbo-test.log +23 -0
  6. package/CHANGELOG.md +1976 -0
  7. package/README.md +59 -0
  8. package/bin/build.sh +2 -0
  9. package/build/bin/index.d.ts +2 -0
  10. package/build/bin/index.js +26 -0
  11. package/build/commands/archive-build/index.d.ts +1 -0
  12. package/build/commands/archive-build/index.js +15 -0
  13. package/build/commands/build/build-wrapper.d.ts +8 -0
  14. package/build/commands/build/build-wrapper.js +40 -0
  15. package/build/commands/build/client.d.ts +1 -0
  16. package/build/commands/build/client.js +54 -0
  17. package/build/commands/build/index.d.ts +1 -0
  18. package/build/commands/build/index.js +11 -0
  19. package/build/commands/build/server.d.ts +1 -0
  20. package/build/commands/build/server.js +29 -0
  21. package/build/commands/bundle-analyze/index.d.ts +1 -0
  22. package/build/commands/bundle-analyze/index.js +62 -0
  23. package/build/commands/changelog/index.d.ts +5 -0
  24. package/build/commands/changelog/index.js +141 -0
  25. package/build/commands/docker-build/index.d.ts +1 -0
  26. package/build/commands/docker-build/index.js +15 -0
  27. package/build/commands/docker-build-compiled/index.d.ts +1 -0
  28. package/build/commands/docker-build-compiled/index.js +15 -0
  29. package/build/commands/ensure-yarn/index.d.ts +1 -0
  30. package/build/commands/ensure-yarn/index.js +8 -0
  31. package/build/commands/start/client.d.ts +1 -0
  32. package/build/commands/start/client.js +7 -0
  33. package/build/commands/start/index.d.ts +1 -0
  34. package/build/commands/start/index.js +13 -0
  35. package/build/commands/start/print-compiler-output.d.ts +2 -0
  36. package/build/commands/start/print-compiler-output.js +16 -0
  37. package/build/commands/start/server.d.ts +1 -0
  38. package/build/commands/start/server.js +7 -0
  39. package/build/commands/start-prod/client.d.ts +1 -0
  40. package/build/commands/start-prod/client.js +7 -0
  41. package/build/commands/start-prod/index.d.ts +1 -0
  42. package/build/commands/start-prod/index.js +13 -0
  43. package/build/commands/start-prod/server.d.ts +1 -0
  44. package/build/commands/start-prod/server.js +7 -0
  45. package/build/commands/test/get-config.d.ts +1 -0
  46. package/build/commands/test/get-config.js +83 -0
  47. package/build/commands/test/index.d.ts +1 -0
  48. package/build/commands/test/index.js +68 -0
  49. package/build/commands/test-vitest/index.d.ts +1 -0
  50. package/build/commands/test-vitest/index.js +15 -0
  51. package/build/commands/util/artifacts-config.d.ts +25 -0
  52. package/build/commands/util/artifacts-config.js +119 -0
  53. package/build/commands/util/artifacts-deprecations.d.ts +9 -0
  54. package/build/commands/util/artifacts-deprecations.js +65 -0
  55. package/build/commands/util/arui-scripts-artifacts.d.ts +16 -0
  56. package/build/commands/util/arui-scripts-artifacts.js +29 -0
  57. package/build/commands/util/client-assets-sizes.d.ts +2 -0
  58. package/build/commands/util/client-assets-sizes.js +71 -0
  59. package/build/commands/util/docker-build.d.ts +35 -0
  60. package/build/commands/util/docker-build.js +76 -0
  61. package/build/commands/util/exec.d.ts +1 -0
  62. package/build/commands/util/exec.js +6 -0
  63. package/build/commands/util/format-webpack-messages.d.ts +5 -0
  64. package/build/commands/util/format-webpack-messages.js +95 -0
  65. package/build/commands/util/get-local-ident.d.ts +6 -0
  66. package/build/commands/util/get-local-ident.js +29 -0
  67. package/build/commands/util/load-browserslist.d.ts +1 -0
  68. package/build/commands/util/load-browserslist.js +15 -0
  69. package/build/commands/util/make-tmp-dir.d.ts +5 -0
  70. package/build/commands/util/make-tmp-dir.js +29 -0
  71. package/build/commands/util/print-build-error.d.ts +1 -0
  72. package/build/commands/util/print-build-error.js +32 -0
  73. package/build/commands/util/run-artifacts-cli.d.ts +7 -0
  74. package/build/commands/util/run-artifacts-cli.js +60 -0
  75. package/build/commands/util/run-client-dev-server.d.ts +2 -0
  76. package/build/commands/util/run-client-dev-server.js +47 -0
  77. package/build/commands/util/run-compilers.d.ts +1 -0
  78. package/build/commands/util/run-compilers.js +37 -0
  79. package/build/commands/util/run-server-watch-compiler.d.ts +2 -0
  80. package/build/commands/util/run-server-watch-compiler.js +17 -0
  81. package/build/commands/util/run-vitest.d.ts +7 -0
  82. package/build/commands/util/run-vitest.js +41 -0
  83. package/build/commands/util/tsc.d.ts +1 -0
  84. package/build/commands/util/tsc.js +13 -0
  85. package/build/commands/util/yarn.d.ts +10 -0
  86. package/build/commands/util/yarn.js +25 -0
  87. package/build/configs/app-configs/calculate-dependent-config.d.ts +9 -0
  88. package/build/configs/app-configs/calculate-dependent-config.js +55 -0
  89. package/build/configs/app-configs/get-defaults.d.ts +5 -0
  90. package/build/configs/app-configs/get-defaults.js +151 -0
  91. package/build/configs/app-configs/index.d.ts +5 -0
  92. package/build/configs/app-configs/index.js +25 -0
  93. package/build/configs/app-configs/read-config-file.d.ts +2 -0
  94. package/build/configs/app-configs/read-config-file.js +28 -0
  95. package/build/configs/app-configs/types.d.ts +146 -0
  96. package/build/configs/app-configs/types.js +2 -0
  97. package/build/configs/app-configs/update-with-config-file.d.ts +2 -0
  98. package/build/configs/app-configs/update-with-config-file.js +17 -0
  99. package/build/configs/app-configs/update-with-env.d.ts +2 -0
  100. package/build/configs/app-configs/update-with-env.js +23 -0
  101. package/build/configs/app-configs/update-with-package.d.ts +2 -0
  102. package/build/configs/app-configs/update-with-package.js +13 -0
  103. package/build/configs/app-configs/update-with-presets.d.ts +3 -0
  104. package/build/configs/app-configs/update-with-presets.js +41 -0
  105. package/build/configs/app-configs/validate-config.d.ts +2 -0
  106. package/build/configs/app-configs/validate-config.js +8 -0
  107. package/build/configs/app-configs/validate-settings-keys.d.ts +7 -0
  108. package/build/configs/app-configs/validate-settings-keys.js +16 -0
  109. package/build/configs/app-configs/warn-about-deprecations.d.ts +2 -0
  110. package/build/configs/app-configs/warn-about-deprecations.js +22 -0
  111. package/build/configs/babel-client.d.ts +31 -0
  112. package/build/configs/babel-client.js +69 -0
  113. package/build/configs/babel-dependencies.d.ts +14 -0
  114. package/build/configs/babel-dependencies.js +36 -0
  115. package/build/configs/babel-server.d.ts +26 -0
  116. package/build/configs/babel-server.js +45 -0
  117. package/build/configs/client-env-config/add-env-to-html-template.d.ts +1 -0
  118. package/build/configs/client-env-config/add-env-to-html-template.js +7 -0
  119. package/build/configs/client-env-config/client-config-plugin.d.ts +5 -0
  120. package/build/configs/client-env-config/client-config-plugin.js +26 -0
  121. package/build/configs/client-env-config/constants.d.ts +1 -0
  122. package/build/configs/client-env-config/constants.js +4 -0
  123. package/build/configs/client-env-config/get-env-config.d.ts +2 -0
  124. package/build/configs/client-env-config/get-env-config.js +28 -0
  125. package/build/configs/client-env-config/index.d.ts +3 -0
  126. package/build/configs/client-env-config/index.js +9 -0
  127. package/build/configs/config-extras/minimizers/imagemin/imagemin.d.ts +28 -0
  128. package/build/configs/config-extras/minimizers/imagemin/imagemin.js +65 -0
  129. package/build/configs/config-extras/minimizers/imagemin/index.d.ts +1 -0
  130. package/build/configs/config-extras/minimizers/imagemin/index.js +17 -0
  131. package/build/configs/config-extras/minimizers/index.d.ts +1 -0
  132. package/build/configs/config-extras/minimizers/index.js +17 -0
  133. package/build/configs/dev-server.d.ts +2 -0
  134. package/build/configs/dev-server.js +78 -0
  135. package/build/configs/jest/babel-transform.d.ts +2 -0
  136. package/build/configs/jest/babel-transform.js +6 -0
  137. package/build/configs/jest/css-mock.d.ts +1 -0
  138. package/build/configs/jest/css-mock.js +2 -0
  139. package/build/configs/jest/file-transform.d.ts +3 -0
  140. package/build/configs/jest/file-transform.js +11 -0
  141. package/build/configs/jest/settings.d.ts +21 -0
  142. package/build/configs/jest/settings.js +58 -0
  143. package/build/configs/modules.d.ts +17 -0
  144. package/build/configs/modules.js +181 -0
  145. package/build/configs/mq.css +22 -0
  146. package/build/configs/postcss.config.d.ts +35 -0
  147. package/build/configs/postcss.config.js +65 -0
  148. package/build/configs/postcss.d.ts +6 -0
  149. package/build/configs/postcss.js +21 -0
  150. package/build/configs/process-assets-plugin-output.d.ts +2 -0
  151. package/build/configs/process-assets-plugin-output.js +45 -0
  152. package/build/configs/server-externals-exemptions.d.ts +1 -0
  153. package/build/configs/server-externals-exemptions.js +18 -0
  154. package/build/configs/stats-options.d.ts +2 -0
  155. package/build/configs/stats-options.js +46 -0
  156. package/build/configs/supporting-browsers.d.ts +1 -0
  157. package/build/configs/supporting-browsers.js +5 -0
  158. package/build/configs/supporting-node.d.ts +1 -0
  159. package/build/configs/supporting-node.js +5 -0
  160. package/build/configs/swc.d.ts +4 -0
  161. package/build/configs/swc.js +30 -0
  162. package/build/configs/util/apply-overrides.d.ts +87 -0
  163. package/build/configs/util/apply-overrides.js +56 -0
  164. package/build/configs/util/check-node-version.d.ts +1 -0
  165. package/build/configs/util/check-node-version.js +7 -0
  166. package/build/configs/util/compress-with-dcb.d.ts +2 -0
  167. package/build/configs/util/compress-with-dcb.js +28 -0
  168. package/build/configs/util/compression-plugins-for-dictionaries.d.ts +2 -0
  169. package/build/configs/util/compression-plugins-for-dictionaries.js +78 -0
  170. package/build/configs/util/create-watch-ignore-regex.d.ts +1 -0
  171. package/build/configs/util/create-watch-ignore-regex.js +16 -0
  172. package/build/configs/util/dcb-compression-plugin.d.ts +21 -0
  173. package/build/configs/util/dcb-compression-plugin.js +130 -0
  174. package/build/configs/util/find-loader.d.ts +2 -0
  175. package/build/configs/util/find-loader.js +24 -0
  176. package/build/configs/util/find-plugin.d.ts +78 -0
  177. package/build/configs/util/find-plugin.js +21 -0
  178. package/build/configs/util/get-entry.d.ts +8 -0
  179. package/build/configs/util/get-entry.js +22 -0
  180. package/build/configs/util/get-polyfills.d.ts +2 -0
  181. package/build/configs/util/get-polyfills.js +13 -0
  182. package/build/configs/util/get-webpack-cache-dependencies.d.ts +1 -0
  183. package/build/configs/util/get-webpack-cache-dependencies.js +15 -0
  184. package/build/configs/util/install-sourcemap-support.d.ts +1 -0
  185. package/build/configs/util/install-sourcemap-support.js +10 -0
  186. package/build/configs/util/node-assets-ignore.d.ts +1 -0
  187. package/build/configs/util/node-assets-ignore.js +34 -0
  188. package/build/configs/util/noop.d.ts +1 -0
  189. package/build/configs/util/noop.js +2 -0
  190. package/build/configs/util/register-ts-node.d.ts +1 -0
  191. package/build/configs/util/register-ts-node.js +18 -0
  192. package/build/configs/util/resolve.d.ts +14 -0
  193. package/build/configs/util/resolve.js +29 -0
  194. package/build/configs/vitest/config.d.ts +2 -0
  195. package/build/configs/vitest/config.js +5 -0
  196. package/build/configs/vitest/settings.d.ts +30 -0
  197. package/build/configs/vitest/settings.js +77 -0
  198. package/build/configs/webpack.client.d.ts +10 -0
  199. package/build/configs/webpack.client.dev.d.ts +1 -0
  200. package/build/configs/webpack.client.dev.js +12 -0
  201. package/build/configs/webpack.client.js +508 -0
  202. package/build/configs/webpack.client.prod.d.ts +1 -0
  203. package/build/configs/webpack.client.prod.js +12 -0
  204. package/build/configs/webpack.server.d.ts +2 -0
  205. package/build/configs/webpack.server.dev.d.ts +1 -0
  206. package/build/configs/webpack.server.dev.js +8 -0
  207. package/build/configs/webpack.server.js +283 -0
  208. package/build/configs/webpack.server.prod.d.ts +1 -0
  209. package/build/configs/webpack.server.prod.js +8 -0
  210. package/build/index.d.ts +19 -0
  211. package/build/index.js +35 -0
  212. package/build/plugins/arui-runtime/arui-runtime-module.d.ts +7 -0
  213. package/build/plugins/arui-runtime/arui-runtime-module.js +20 -0
  214. package/build/plugins/arui-runtime/index.d.ts +11 -0
  215. package/build/plugins/arui-runtime/index.js +47 -0
  216. package/build/plugins/postcss-global-variables/postcss-global-variables.d.ts +6 -0
  217. package/build/plugins/postcss-global-variables/postcss-global-variables.js +38 -0
  218. package/build/plugins/postcss-global-variables/utils/utils.d.ts +7 -0
  219. package/build/plugins/postcss-global-variables/utils/utils.js +91 -0
  220. package/build/plugins/postcss-prefix-selector.d.ts +6 -0
  221. package/build/plugins/postcss-prefix-selector.js +65 -0
  222. package/build/plugins/reload-server-plugin.d.ts +10 -0
  223. package/build/plugins/reload-server-plugin.js +46 -0
  224. package/build/plugins/turn-off-split-remote-entry.d.ts +11 -0
  225. package/build/plugins/turn-off-split-remote-entry.js +71 -0
  226. package/build/plugins/watch-missing-node-modules-plugin.d.ts +6 -0
  227. package/build/plugins/watch-missing-node-modules-plugin.js +20 -0
  228. package/build/templates/html.template.d.ts +1 -0
  229. package/build/templates/html.template.js +22 -0
  230. package/docs/artifact.md +62 -0
  231. package/docs/caveats.md +41 -0
  232. package/docs/client-only.md +77 -0
  233. package/docs/commands.md +159 -0
  234. package/docs/compilers.md +18 -0
  235. package/docs/compression-dictionary.md +130 -0
  236. package/docs/examples.md +100 -0
  237. package/docs/modules.md +834 -0
  238. package/docs/overrides.md +175 -0
  239. package/docs/presets.md +65 -0
  240. package/docs/settings.md +336 -0
  241. package/jest-preset.js +5 -0
  242. package/package.json +215 -0
  243. package/stylelint.config.js +11 -0
  244. package/tsconfig-local.json +17 -0
  245. package/tsconfig-local.tsbuildinfo +1 -0
  246. package/tsconfig.eslint.json +5 -0
  247. package/tsconfig.json +29 -0
@@ -0,0 +1,130 @@
1
+ # Compression dictionary transport
2
+
3
+ ## Настройки
4
+
5
+ ### `dictionaryCompression.dictionaryPath`
6
+ **Тип:** `string[]`
7
+ **По умолчанию:** `[]`
8
+ **Описание:** Массив путей до предыдущих версий ассетов или готовых словарей для сжатия бандла приложения.
9
+
10
+ - Поддерживает как абсолютные, так и относительные пути (относительно корня проекта)
11
+ - Может содержать как файлы (готовые словари), так и директории (предыдущие версии приложения)
12
+ - Словари будут скопированы в директорию сборки
13
+ - Директории используются для создания DCB-файлов из предыдущих версий
14
+
15
+ ### `dictionaryCompression.enablePreviousVersionHeaders`
16
+ **Тип:** `boolean`
17
+ **По умолчанию:** `false`
18
+ **Описание:** Включает автоматическую простановку заголовка `brotli_auto_dictionary on;` в конфигурации nginx для использования ресурсов приложения как словарей.
19
+
20
+ ## Пример конфигурации
21
+
22
+ ```ts
23
+ import { PackageSettings } from 'arui-scripts';
24
+
25
+ const settings: PackageSettings = {
26
+ dictionaryCompression: {
27
+ dictionaryPath: [
28
+ './build-v1.0', // Предыдущая версия (директория)
29
+ './custom.dict' // Готовый словарь (файл)
30
+ ],
31
+ enablePreviousVersionHeaders: true
32
+ }
33
+ };
34
+
35
+ export default settings;
36
+ ```
37
+
38
+ ## Общее описание механизма
39
+
40
+ Механизм [compression dictionary transport](https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/Compression_dictionary_transport)
41
+ позволяет использовать кастомные словари для сжатия ресурсов приложения.
42
+
43
+ На данный момент arui-scripts поддерживает два механизма работы со словарями:
44
+ 1. Использование вашего собственного словаря для сжатия ресурсов приложения
45
+ 2. Использование одной версии вашего приложения для сжатия ресурсов другой версии.
46
+
47
+ Оба механизма работают только для prod сборки приложения при использовании базового docker образа, поставляемого с arui-scripts.
48
+
49
+ ### Использование вашего словаря
50
+
51
+ По умолчанию brotli использует встроенный в него словарь для более эффективного сжатия. Встроенный в brotli словарь подготовлен
52
+ на основании данных из всего интернета. Если сделать словарь персонально под ваши ресурсы - можно получить более эффективное сжатие, даже
53
+ учитывая дополнительные затраты на загрузку словаря на клиент.
54
+
55
+ #### Создание персонального словаря
56
+ Для создания персонального словаря вы можете использовать утилиту [brotli-dict](https://www.npmjs.com/package/brotli-dict).
57
+
58
+ ```shell
59
+ npx brotli-dict generate file1.js file2.js file3.css -o dictionary.dict -s 200000
60
+ ```
61
+
62
+ Здесь:
63
+ - `file1.js`, `file2.js`, `file3.css` - произвольные текстовые файлы которые вы хотите использовать для создания словаря
64
+ - `dictionary.dict` - имя файла для создаваемого словаря
65
+ - `-s 200000` - ограничивает максимальную длину словаря в 200000. Имейте в виду, что словарь после создания так же можно сжать, поэтому по сети будет передаваться меньше данных.
66
+
67
+ Рекомендуется создать 1 словарь на всю систему, живущую на одном домене. Вы можете взять ресурсы с самых посещаемых страниц и использовать их как исходники для словаря.
68
+ Обновлять их при изменении приложений не обязательно - словари скорее всего не будут содержать сильно специфичного для конкретной версии контента.
69
+
70
+ #### Выбор идентификатора для словаря
71
+
72
+ Для корректной работы со словарем у него должен быть идентификатор. Он будет:
73
+ - использоваться как имя файла для словаря
74
+ - использоваться как суффикс имени сжатых словарем ассетов
75
+ - использоваться в заголовке `Use-As-Dictionary`.
76
+
77
+ В дальнейших примерах я буду использовать идентификатор `dict-id`.
78
+
79
+ #### Загрузка словаря на клиент
80
+ Для того чтобы браузер начал использовать словари их нужно как то загрузить на клиент.
81
+ Это можно сделать 3 способами:
82
+
83
+ - Указав заголовок `Link '</assets/dict-id.dict>; rel="compression-dictionary"';` в ответе на запрос за любым документом
84
+ - Добавив тег `<link rel="compression-dictionary" href="./assets/dict-id.dict" />` в html вашего приложения
85
+ - Сделав `fetch` адреса словаря из вашего кода (`fetch('./assets/dict-id.dict')`).
86
+
87
+ В независимости от метода, в ответ браузер **должен** получить помимо контента словаря так же заголовок `Use-As-Dictionary`, например:
88
+ ```
89
+ Use-As-Dictionary: 'match="/assets/*", id="dict-id"'
90
+ ```
91
+
92
+ Вы можете добиться этого добавив такие строки в nginx.conf:
93
+
94
+ ```
95
+ location /assets/dict-id.dict {
96
+ expires max;
97
+ add_header Use-As-Dictionary 'match="/assets/*", id="dict-id"';
98
+ root /src/.build;
99
+ }
100
+ ```
101
+
102
+ Про то, как корректно настраивать заголовок `Use-As-Dictionary` можно прочитать в [mdn](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Use-As-Dictionary).
103
+
104
+ ### Использование предыдущих версий приложения
105
+
106
+ Если ваше приложение часто обновляется, а пользователи все время возвращаются - можно использовать механизм сжатия с помощью предыдущих версий.
107
+ Он может давать очень высокий коэффицент сжатия если у пользователя есть предыдущая версия приложения в кеше.
108
+
109
+ #### Настройка
110
+
111
+ ```ts
112
+ const settings: PackageSettings = {
113
+ dictionaryCompression: {
114
+ dictionaryPath: [
115
+ './previous-builds/v1.0/assets',
116
+ './previous-builds/v1.1/assets'
117
+ ],
118
+ enablePreviousVersionHeaders: true
119
+ }
120
+ };
121
+ ```
122
+
123
+ При такой конфигурации:
124
+ 1. **arui-scripts** найдёт все `.js` и `.css` файлы в указанных директориях
125
+ 2. Создаст DCB-файлы (Dictionary Compressed Brotli) для каждого файла текущей сборки, используя соответствующие файлы из предыдущих версий как словари
126
+ 3. Nginx будет настроен с `brotli_auto_dictionary on;` для автоматического использования этих словарей
127
+
128
+ Соответствие файлов определяется по их имени. Считаем что файлы в сборке используют формат вида `{stable-name}.{hash}.{ext}`. Соответствующими считаются файлы с одинаковым
129
+ `{stable-name}` и `{ext}`.
130
+ DCB файлы будут иметь название `{stable-name}.{hash}.{ext}.{dict hash}.dcb`.
@@ -0,0 +1,100 @@
1
+ Примеры входных точек для сервера и клиента
2
+ ===
3
+
4
+ ## Клиент
5
+ Для корректной работы hot-module-replacement на клиенте вам надо добавить примерно такой код:
6
+
7
+ _./src/index.tsx_
8
+ ```tsx
9
+ import React from 'react';
10
+ import ReactDOM from 'react-dom';
11
+ import { App } from './components/app';
12
+
13
+ const targetElement = document.getElementById('react-app');
14
+
15
+ ReactDOM.render(
16
+ <App />,
17
+ targetElement
18
+ );
19
+
20
+ if (process.env.NODE_ENV !== 'production' && module.hot) {
21
+ module.hot.accept('./components/app', () => {
22
+ let NextAppAssignments = require('./components/app').App;
23
+
24
+ ReactDOM.render(
25
+ <NextAppAssignments />,
26
+ targetElement
27
+ );
28
+ });
29
+ }
30
+ ```
31
+
32
+ ## Сервер
33
+
34
+ ### Использование hot-module-replacement
35
+ По умолчанию серверная часть приложения будет просто перезапускаться после каждого изменения кода,
36
+ для использования hot module replacement на сервере можно использовать настройку [`useServerHMR`](settings.md#useserverhmr).
37
+
38
+ Ваша входная точка сервера должна выглядеть примерно так (на примере hapi):
39
+
40
+ _./src/server/index.ts_
41
+ ```ts
42
+ import server from './server';
43
+
44
+ let currentServer = server;
45
+
46
+ async function startServer() {
47
+ try {
48
+ await currentServer.start();
49
+ } catch (error) {
50
+ console.error('Failed to start server', error);
51
+ process.exit(1);
52
+ }
53
+ }
54
+
55
+ startServer();
56
+
57
+ if (module.hot) {
58
+ module.hot.accept(['./server'], async () => {
59
+ try {
60
+ await currentServer.stop();
61
+
62
+ currentServer = server; // импорт из сервера заменится самостоятельно
63
+ await startServer();
64
+ } catch (error) {
65
+ console.log('Failed to update server. You probably need to restart application', error);
66
+ }
67
+ });
68
+ }
69
+ ```
70
+
71
+ _./src/server/server.ts_
72
+ ```ts
73
+ import hapi from 'hapi';
74
+ const server = new hapi.Server();
75
+
76
+ server.ext('onPostStart', (_, done) => {
77
+ console.log(`Server is running: ${server.info.uri}`);
78
+ done();
79
+ });
80
+
81
+ (async () => {
82
+ server.connection({ port: 3000 });
83
+
84
+ // ...
85
+ // конфигурация вашего сервера
86
+ // ...
87
+ })();
88
+
89
+ export default server;
90
+ ```
91
+
92
+ Таким образом после изменения кода сервер не будет полностью пререзагружаться, что во многих случаях быстрее.
93
+ В случае изменения входной точки сервера при использовании HMR вам надо будет перезапускать сервер вручную.
94
+
95
+ ### Формирование html для серверного рендеринга
96
+
97
+ Для того чтобы корректно формировать html вам нужно знать имена чанков, которые будут сгенерированы вебпаком.
98
+ Для этого рекомендуется использовать метод `readAssetsManifest` из `@alfalab/scripts-server`, который возвращает объект с именами чанков.
99
+
100
+ Документация по `readAssetsManifest` доступна [здесь](../../arui-scripts-server/README.md#readassetsmanifest).