jsgui3-server 0.0.121 → 0.0.123

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 (282) hide show
  1. package/.vscode/settings.json +6 -0
  2. package/README.md +10 -10
  3. package/controls/Active_HTML_Document.js +116 -116
  4. package/controls/README.md +7 -7
  5. package/controls/page/admin.js +74 -74
  6. package/controls/panel/admin.js +11 -11
  7. package/examples/_css/basic.css +913 -913
  8. package/examples/_css/database-control.css +51 -51
  9. package/examples/_css/jsgui.css +66 -66
  10. package/examples/_css/multi-layout.css +23 -23
  11. package/examples/_css/style.css +1669 -1669
  12. package/examples/_css/top-and-bottom-bars.css +54 -54
  13. package/examples/box/1) square box/client.js +188 -188
  14. package/examples/box/1) square box/server.js +112 -112
  15. package/examples/box/2) twenty square boxes/css flex wrap/client.js +112 -248
  16. package/examples/box/2) twenty square boxes/css flex wrap/server.js +39 -112
  17. package/examples/box/3) twenty selectable square boxes/css flex wrap/client.js +129 -0
  18. package/examples/{controls/15) window, text field → box/3) twenty selectable square boxes/css flex wrap}/server.js +38 -38
  19. package/examples/boxes/square_boxes.js +45 -48
  20. package/examples/boxes/square_boxes_client.js +132 -136
  21. package/examples/client-side-popup-menu-button.html +93 -93
  22. package/examples/color_palette.js +51 -51
  23. package/examples/color_palette_client.js +95 -95
  24. package/examples/controls/1) window/client.js +186 -186
  25. package/examples/controls/1) window/server.js +117 -117
  26. package/examples/controls/10) window, mirrored text inputs/client.js +118 -320
  27. package/examples/controls/10) window, mirrored text inputs/server.js +37 -117
  28. package/examples/controls/11) window, mirrored text fields/client.js +493 -251
  29. package/examples/controls/11) window, mirrored text fields/server.js +117 -117
  30. package/examples/controls/11b) window, shared Data_Object model mirrored text fields/client.js +613 -331
  31. package/examples/controls/11b) window, shared Data_Object model mirrored text fields/server.js +117 -117
  32. package/examples/controls/11c) window, shared Data_Value model mirrored text fields/client.js +617 -617
  33. package/examples/controls/11c) window, shared Data_Value model mirrored text fields/server.js +117 -117
  34. package/examples/controls/11d) window, shared model mirrored integer text fields/client.js +611 -280
  35. package/examples/controls/11d) window, shared model mirrored integer text fields/server.js +134 -22
  36. package/examples/controls/12) window, Select_Options control/client.js +66 -452
  37. package/examples/controls/12) window, Select_Options control/server.js +19 -117
  38. package/examples/controls/13) window, Dropdown_Menu control/client.js +66 -0
  39. package/examples/controls/13) window, Dropdown_Menu control/server.js +20 -0
  40. package/examples/controls/2) two windows/client.js +193 -193
  41. package/examples/controls/2) two windows/server.js +113 -113
  42. package/examples/controls/3) five windows/client.js +217 -217
  43. package/examples/controls/3) five windows/server.js +116 -115
  44. package/examples/controls/4) window, tabbed panel/client.js +54 -225
  45. package/examples/controls/4) window, tabbed panel/server.js +17 -117
  46. package/examples/controls/5) window, grid/client.js +204 -484
  47. package/examples/controls/5) window, grid/server.js +117 -119
  48. package/examples/controls/6) window, color_palette/client.js +68 -204
  49. package/examples/controls/6) window, color_palette/server.js +117 -117
  50. package/examples/controls/7) window, month_view/client.js +40 -231
  51. package/examples/controls/7) window, month_view/server.js +117 -117
  52. package/examples/controls/8) window, checkbox/client.js +33 -209
  53. package/examples/controls/8) window, checkbox/server.js +117 -117
  54. package/examples/controls/9) window, date picker/client.js +76 -303
  55. package/examples/controls/9) window, date picker/server.js +117 -117
  56. package/examples/controls/9b) window, shared data.model mirrored date pickers/README.md +51 -0
  57. package/examples/controls/9b) window, shared data.model mirrored date pickers/client.js +83 -398
  58. package/examples/controls/9b) window, shared data.model mirrored date pickers/server.js +117 -117
  59. package/examples/controls/__old/_html-server-color-palette.js +114 -114
  60. package/examples/controls/__old/html-server-combo-box.js +104 -104
  61. package/examples/controls/__old/html-server-list.js +98 -98
  62. package/examples/controls/__old/html-server-popup-menu-button.js +114 -114
  63. package/examples/controls/__old/html-server-start-stop-toggle-button.js +146 -146
  64. package/examples/controls/__old/scs-arrow-button.js +36 -36
  65. package/examples/controls/__old/scs-date-picker.js +157 -157
  66. package/examples/controls/__old/scs-file-browser.js +82 -82
  67. package/examples/controls/__old/scs-item.js +159 -159
  68. package/examples/controls/__old/scs-month-arrow-selector.js +126 -126
  69. package/examples/controls/__old/scs-month-view.js +94 -94
  70. package/examples/controls/__old/scs-start-stop-toggle-button.js +40 -40
  71. package/examples/controls/__old/scs-tree.js +49 -49
  72. package/examples/controls/__old/scs-year-arrow-selector.js +127 -127
  73. package/examples/demos/date-picker.js +119 -119
  74. package/examples/demos/explain-encapsulation.js +9 -9
  75. package/examples/demos/resizing.js +35 -35
  76. package/examples/demos/server_time.js +6 -6
  77. package/examples/grids/grid_1.js +45 -45
  78. package/examples/grids/grid_1_client.js +329 -329
  79. package/examples/html-rendering.js +20 -20
  80. package/examples/html-server.js +105 -105
  81. package/examples/introducing jsgui3/server.js +110 -110
  82. package/examples/mx_display/mx_display_1.js +45 -45
  83. package/examples/mx_display/mx_display_1_client.js +444 -444
  84. package/fs2.js +1836 -1836
  85. package/http/responders/HTTP_Responder.js +15 -15
  86. package/http/responders/static/Static_Route_HTTP_Responder.js +105 -105
  87. package/module.js +34 -34
  88. package/old/_single-control-server.js +418 -418
  89. package/old/single-control-server.js +368 -368
  90. package/old/single-page-app.js +131 -131
  91. package/package.json +42 -42
  92. package/page-context.js +92 -92
  93. package/publishers/helpers/assigners/Assigner.js +10 -10
  94. package/publishers/helpers/assigners/static-compressed-response-buffers/Single_Control_Webpage_Server_Static_Compressed_Response_Buffers_Assigner.js +150 -150
  95. package/publishers/helpers/assigners/static-headers/Single_Control_Webpage_Server_Static_Headers_Assigner.js +109 -109
  96. package/publishers/helpers/assigners/static-routes/Single_Control_Webpage_Server_Static_Routes_Assigner.js +91 -91
  97. package/publishers/helpers/assigners/static-uncompressed-response-buffers/Single_Control_Webpage_Server_Static_Uncompressed_Response_Buffers_Assigner.js +104 -104
  98. package/publishers/helpers/preparers/static/bundle/Ready_To_Serve_Preparer.js +18 -18
  99. package/publishers/helpers/preparers/static/bundle/Static_Routes_Responses_Webpage_Bundle_Preparer.js +44 -44
  100. package/publishers/http-function-publisher.js +212 -212
  101. package/publishers/http-html-page-publisher.js +5 -5
  102. package/publishers/http-html-publisher.js +24 -24
  103. package/publishers/http-js-publisher.js +135 -135
  104. package/publishers/http-observable-publisher.js +124 -124
  105. package/publishers/http-publisher.js +53 -53
  106. package/publishers/http-resource-publisher.js +325 -325
  107. package/publishers/http-webpage-publisher.js +659 -658
  108. package/publishers/http-webpageorsite-publisher.js +343 -343
  109. package/publishers/http-website-publisher.js +640 -640
  110. package/publishers/notes.md +9 -9
  111. package/resources/README.md +16 -16
  112. package/resources/_old_website-javascript-resource.js +994 -994
  113. package/resources/_old_website-resource.js +507 -507
  114. package/resources/compile/server-resource-compilation.js +43 -43
  115. package/resources/data-resource.js +118 -118
  116. package/resources/fs-resource.js +146 -146
  117. package/resources/jsbuilder/Abstract_Single_Declaration.js +105 -105
  118. package/resources/jsbuilder/Abstract_Single_Declaration_Sequence.js +42 -42
  119. package/resources/jsbuilder/JS_AST/JS_AST_Abstract_Node.js +61 -61
  120. package/resources/jsbuilder/JS_AST/JS_AST_Abstract_Node_Group.js +41 -41
  121. package/resources/jsbuilder/JS_AST/JS_AST_Group_Shared.js +61 -61
  122. package/resources/jsbuilder/JS_AST/JS_AST_Node.js +93 -93
  123. package/resources/jsbuilder/JS_AST/JS_AST_Node_0-Core.js +253 -253
  124. package/resources/jsbuilder/JS_AST/JS_AST_Node_1-Babel.js +337 -337
  125. package/resources/jsbuilder/JS_AST/JS_AST_Node_10-Changing.js +39 -39
  126. package/resources/jsbuilder/JS_AST/JS_AST_Node_2.1.1-Child.js +96 -96
  127. package/resources/jsbuilder/JS_AST/JS_AST_Node_2.1.2-Parent.js +37 -37
  128. package/resources/jsbuilder/JS_AST/JS_AST_Node_2.1.3-Ancestor.js +61 -61
  129. package/resources/jsbuilder/JS_AST/JS_AST_Node_2.2-Inner.js +43 -43
  130. package/resources/jsbuilder/JS_AST/JS_AST_Node_2.3-All.js +72 -72
  131. package/resources/jsbuilder/JS_AST/JS_AST_Node_2.4-Sibling.js +92 -92
  132. package/resources/jsbuilder/JS_AST/JS_AST_Node_2.5-Available_In_Scope.js +29 -29
  133. package/resources/jsbuilder/JS_AST/JS_AST_Node_2.9-Signature.js +116 -116
  134. package/resources/jsbuilder/JS_AST/JS_AST_Node_3-Basics.js +159 -159
  135. package/resources/jsbuilder/JS_AST/JS_AST_Node_3.0.0-Basics_First.js +178 -178
  136. package/resources/jsbuilder/JS_AST/JS_AST_Node_3.0.1-Basics_Second.js +87 -87
  137. package/resources/jsbuilder/JS_AST/JS_AST_Node_3.0.99-Basics_Last.js +91 -91
  138. package/resources/jsbuilder/JS_AST/JS_AST_Node_3.1-Basics_Each.js +136 -136
  139. package/resources/jsbuilder/JS_AST/JS_AST_Node_3.1.5-Basics_Count.js +73 -73
  140. package/resources/jsbuilder/JS_AST/JS_AST_Node_3.2-Basics_Filter.js +39 -39
  141. package/resources/jsbuilder/JS_AST/JS_AST_Node_3.3-Basics_Collect.js +85 -85
  142. package/resources/jsbuilder/JS_AST/JS_AST_Node_3.4-Basics_Select.js +42 -42
  143. package/resources/jsbuilder/JS_AST/JS_AST_Node_3.5-Basics_Find.js +40 -40
  144. package/resources/jsbuilder/JS_AST/JS_AST_Node_3.6-Basics_Callmap.js +54 -54
  145. package/resources/jsbuilder/JS_AST/JS_AST_Node_4.0-Index_Indexes.js +45 -45
  146. package/resources/jsbuilder/JS_AST/JS_AST_Node_4.1-Index.js +343 -343
  147. package/resources/jsbuilder/JS_AST/JS_AST_Node_5.0-Category.js +38 -38
  148. package/resources/jsbuilder/JS_AST/JS_AST_Node_5.1-Category_Identifier.js +30 -30
  149. package/resources/jsbuilder/JS_AST/JS_AST_Node_5.2-Category_Literal.js +28 -28
  150. package/resources/jsbuilder/JS_AST/JS_AST_Node_5.3-Category_Expression.js +26 -26
  151. package/resources/jsbuilder/JS_AST/JS_AST_Node_5.4-Category_Pattern.js +8 -8
  152. package/resources/jsbuilder/JS_AST/JS_AST_Node_5.5-Category_Declaration.js +43 -43
  153. package/resources/jsbuilder/JS_AST/JS_AST_Node_5.6-Category_Statement.js +21 -21
  154. package/resources/jsbuilder/JS_AST/JS_AST_Node_6.0-Type.js +89 -89
  155. package/resources/jsbuilder/JS_AST/JS_AST_Node_6.1-Type_Class_Declaration.js +8 -8
  156. package/resources/jsbuilder/JS_AST/JS_AST_Node_6.2-Type_Variable_Declaration.js +27 -27
  157. package/resources/jsbuilder/JS_AST/JS_AST_Node_6.3-Type_Variable_Declarator.js +28 -28
  158. package/resources/jsbuilder/JS_AST/JS_AST_Node_7-Query.js +736 -736
  159. package/resources/jsbuilder/JS_AST/JS_AST_Node_8-Features.js +64 -64
  160. package/resources/jsbuilder/JS_AST/JS_AST_Node_9-Planning.js +31 -31
  161. package/resources/jsbuilder/JS_AST/JS_AST_Node_Arrangement.js +15 -15
  162. package/resources/jsbuilder/JS_AST/JS_AST_Node_Feature/JS_AST_Node_Declared_Object.js +305 -305
  163. package/resources/jsbuilder/JS_AST/JS_AST_Node_Feature/JS_AST_Node_Feature.js +77 -77
  164. package/resources/jsbuilder/JS_AST/JS_AST_Node_Feature/JS_AST_Node_Feature_Declaration.js +248 -248
  165. package/resources/jsbuilder/JS_AST/JS_AST_Node_Feature/JS_AST_Node_Feature_Declarator.js +138 -138
  166. package/resources/jsbuilder/JS_AST/JS_AST_Node_Feature/JS_AST_Root_Node_Feature/JS_AST_Root_Node_Feature.js +10 -10
  167. package/resources/jsbuilder/JS_AST/JS_AST_Node_Feature/JS_AST_Root_Node_Feature/JS_AST_Root_Node_Feature_Exported.js +100 -100
  168. package/resources/jsbuilder/JS_AST/JS_AST_Node_Feature/JS_AST_Root_Node_Feature/JS_AST_Root_Node_Feature_Exports.js +60 -60
  169. package/resources/jsbuilder/JS_AST/JS_AST_Node_Feature/JS_AST_Root_Node_Feature/JS_AST_Root_Node_Interpreted.js +179 -179
  170. package/resources/jsbuilder/JS_AST/JS_AST_Node_Feature/JS_AST_Root_Node_Feature/_JSGUI_Root_Node_Interpreted.js +43 -43
  171. package/resources/jsbuilder/JS_AST/JS_AST_Node_Feature/JS_AST_Root_Node_Feature/special_case_objectassign_to_object.js +12 -12
  172. package/resources/jsbuilder/JS_AST/JS_AST_Node_Group.js +35 -35
  173. package/resources/jsbuilder/JS_AST/JS_AST_Operation.js +11 -11
  174. package/resources/jsbuilder/JS_AST/JS_AST_Operation_On_Relationship.js +31 -31
  175. package/resources/jsbuilder/JS_AST/JS_AST_Ordered_Relationship_Node_To_Group.js +37 -37
  176. package/resources/jsbuilder/JS_AST/JS_AST_Ordinal.js +39 -39
  177. package/resources/jsbuilder/JS_AST/JS_AST_Ordinal_Relationship.js +25 -25
  178. package/resources/jsbuilder/JS_AST/JS_AST_Relationship_Node_To_Group.js +200 -200
  179. package/resources/jsbuilder/JS_AST/JS_AST_Relationship_Node_Within_Group_To_Node.js +43 -43
  180. package/resources/jsbuilder/JS_AST/_JS_AST_Node_3.8-Query_Features.js +76 -76
  181. package/resources/jsbuilder/JS_AST/query/enable_array_as_queryable.js +227 -227
  182. package/resources/jsbuilder/JS_AST/query/find_object_keys.js +404 -404
  183. package/resources/jsbuilder/JS_AST/query/node_queries.js +8 -8
  184. package/resources/jsbuilder/JS_AST/query/root_query_identidy.js +11 -11
  185. package/resources/jsbuilder/JS_AST_Node_Extended/JSGUI_Singular_Declaration.js +85 -85
  186. package/resources/jsbuilder/JS_AST_Node_Extended/JS_AST_Node_Declaration.js +123 -123
  187. package/resources/jsbuilder/JS_AST_Node_Extended/JS_AST_Node_Extended.js +87 -87
  188. package/resources/jsbuilder/JS_AST_Node_Extended/JS_AST_Node_Extended_0-Core.js +10 -10
  189. package/resources/jsbuilder/JS_Builder.js +10 -10
  190. package/resources/jsbuilder/JS_File/Feature/JS_File_Declared_Object.js +31 -31
  191. package/resources/jsbuilder/JS_File/Feature/JS_File_Exported_Object_Info.js +25 -25
  192. package/resources/jsbuilder/JS_File/Feature/JS_File_Exports.js +78 -78
  193. package/resources/jsbuilder/JS_File/Feature/JS_File_Feature.js +17 -17
  194. package/resources/jsbuilder/JS_File/Feature/JS_File_Imported_Object_Info.js +25 -25
  195. package/resources/jsbuilder/JS_File/Feature/JS_File_Imports.js +8 -8
  196. package/resources/jsbuilder/JS_File/JS_File.js +12 -12
  197. package/resources/jsbuilder/JS_File/JS_File_0-Core.js +202 -202
  198. package/resources/jsbuilder/JS_File/JS_File_1-Early_Parse.js +175 -175
  199. package/resources/jsbuilder/JS_File/JS_File_2-Babel.js +81 -81
  200. package/resources/jsbuilder/JS_File/JS_File_3-JS_AST_Node.js +86 -86
  201. package/resources/jsbuilder/JS_File/JS_File_4-Query.js +413 -413
  202. package/resources/jsbuilder/JS_File/JS_File_4.1-Query_Features.js +414 -414
  203. package/resources/jsbuilder/JS_File/JS_File_5-Planning.js +59 -59
  204. package/resources/jsbuilder/JS_File/JS_File_6-Changing.js +24 -24
  205. package/resources/jsbuilder/JS_File/JS_File_Export_Reference.js +12 -12
  206. package/resources/jsbuilder/JS_File/JS_File_Import_Reference.js +23 -23
  207. package/resources/jsbuilder/JS_File/JS_File_Import_References.js +31 -31
  208. package/resources/jsbuilder/JS_File/JS_File_Processor.js +16 -16
  209. package/resources/jsbuilder/JS_File/JS_Files.js +15 -15
  210. package/resources/jsbuilder/Module.js +14 -14
  211. package/resources/jsbuilder/Platform.js +13 -13
  212. package/resources/jsbuilder/Platforms.js +69 -69
  213. package/resources/jsbuilder/Project.js +109 -109
  214. package/resources/jsbuilder/Reference.js +1 -1
  215. package/resources/jsbuilder/Reference_Sequence.js +16 -16
  216. package/resources/jsbuilder/Scope.js +29 -29
  217. package/resources/jsbuilder/Variable_Name_Provider.js +42 -42
  218. package/resources/jsbuilder/_JS_File.js +225 -225
  219. package/resources/jsbuilder/ast_query.js +20 -20
  220. package/resources/jsbuilder/babel/babel_consts.js +162 -162
  221. package/resources/jsbuilder/babel/babel_node_tools.js +541 -541
  222. package/resources/jsbuilder/babel/deep_iterate/deep_iterate_babel.js +923 -904
  223. package/resources/jsbuilder/build.js +16 -16
  224. package/resources/jsbuilder/platform_notes.md +66 -66
  225. package/resources/jsbuilder/test/test_ast_node.js +381 -381
  226. package/resources/jsbuilder/test/test_js_file.js +303 -303
  227. package/resources/jsbuilder/test/test_project.js +157 -157
  228. package/resources/local-server-info-resource.js +96 -96
  229. package/resources/notes.txt +10 -10
  230. package/resources/old/website-image-resource.js +1185 -1185
  231. package/resources/process-js.js +498 -498
  232. package/resources/processors/bundlers/bundle.js +29 -29
  233. package/resources/processors/bundlers/bundler.js +23 -23
  234. package/resources/processors/bundlers/css-bundler.js +234 -234
  235. package/resources/processors/bundlers/js/JS_Bundler.js +51 -51
  236. package/resources/processors/bundlers/js/esbuild/Advanced_JS_Bundler_Using_ESBuild.js +388 -391
  237. package/resources/processors/bundlers/js/esbuild/Bundler_Using_ESBuild.js +8 -8
  238. package/resources/processors/bundlers/js/esbuild/Core_JS_Non_Minifying_Bundler_Using_ESBuild.js +188 -188
  239. package/resources/processors/bundlers/js/esbuild/Core_JS_Single_File_Minifying_Bundler_Using_ESBuild.js +191 -192
  240. package/resources/processors/bundlers/js/esbuild/_Old_CSS_Extractor.js +239 -239
  241. package/resources/processors/bundlers/js-bundler.js +263 -263
  242. package/resources/processors/bundlers/test_ast.js +73 -73
  243. package/resources/processors/bundlers/webpage-bundler.js +404 -404
  244. package/resources/processors/bundlers/website-bundler.js +22 -22
  245. package/resources/processors/extractors/Extractor.js +9 -11
  246. package/resources/processors/extractors/js/css_and_js/AST_Node/CSS_And_JS_From_JS_String_Using_AST_Node_Extractor.js +239 -254
  247. package/resources/processors/extractors/js/css_and_js/CSS_And_JS_From_JS_String_Extractor.js +3 -3
  248. package/resources/processors/extractors/string/Pos_Span_String_Extractor.js +93 -93
  249. package/resources/server-installed-tools.js +28 -28
  250. package/resources/server-resource-pool.js +41 -41
  251. package/resources/website-audio-resource.js +735 -735
  252. package/resources/website-css-resource.js +411 -411
  253. package/resources/website-image-resource.js +412 -412
  254. package/resources/website-javascript-resource-processor.js +908 -908
  255. package/resources/website-javascript-resource.js +874 -874
  256. package/resources/website-resource-processor.js +10 -10
  257. package/resources/website-resource.js +164 -164
  258. package/resources/website-static-html-resource.js +199 -199
  259. package/resources/website-template-html-resource.js +231 -231
  260. package/roadmap.md +75 -75
  261. package/server.js +609 -573
  262. package/static-page-context.js +13 -13
  263. package/website/webpage.js +81 -81
  264. package/website/website-group.js +15 -15
  265. package/website/website.js +260 -260
  266. package/examples/controls/11d) window, shared model mirrored integer text fields/both.js +0 -17
  267. package/examples/controls/13) window, shared model mirrored lat_long/client.js +0 -933
  268. package/examples/controls/13) window, shared model mirrored lat_long/server.js +0 -50
  269. package/examples/controls/14) window, control compositional model/client.js +0 -328
  270. package/examples/controls/14) window, control compositional model/server.js +0 -118
  271. package/examples/controls/14a) window, control spec has compositional model/client.js +0 -440
  272. package/examples/controls/14a) window, control spec has compositional model/server.js +0 -118
  273. package/examples/controls/15) window, text field/client.js +0 -256
  274. package/examples/controls/16) Window([Text_Input])/client.js +0 -266
  275. package/examples/controls/16) Window([Text_Input])/server.js +0 -109
  276. package/examples/controls/16a) Window([Text_Input]) Integer data.model.data_type/client.js +0 -494
  277. package/examples/controls/16a) Window([Text_Input]) Integer data.model.data_type/isomorphic.js +0 -24
  278. package/examples/controls/16a) Window([Text_Input]) Integer data.model.data_type/server.js +0 -73
  279. package/examples/controls/2b) two window, context menus/client.js +0 -193
  280. package/examples/controls/2b) two window, context menus/server.js +0 -114
  281. package/examples/controls/4a) window, tabbed panel with various controls inside/client.js +0 -233
  282. package/examples/controls/4a) window, tabbed panel with various controls inside/server.js +0 -118
@@ -1,150 +1,150 @@
1
-
2
-
3
- // Making such specific classes with such long names seems kind of silly, but will help to keep the higher level code
4
- // both explicit and easy to follow.
5
-
6
- // These classes will do specific things, to specific things (in specific ways)
7
-
8
- // Basically middleware that the app dev should not need to pay much attention to usually.
9
-
10
-
11
-
12
-
13
- // And likely will have some other class (system), maybe assigners, to set the routes on the server / server router.
14
- // Or within the website resource???
15
-
16
- // So everything (main) that the server does will be done using various interchangable classes.
17
- // Some classes will cover some very specific use cases.
18
-
19
- const zlib = require('zlib');
20
-
21
-
22
-
23
- const Assigner = require('../Assigner');
24
-
25
- const {is_array} = require('lang-tools');
26
-
27
- // And will have some very or less specific assigners for some other things.
28
- // Like the compressed (text?) response headers.
29
-
30
-
31
- const { promisify } = require('node:util');
32
-
33
- // deflate, unzip
34
-
35
- const gzip_compress = promisify(zlib.gzip);
36
- const br_compress = promisify(zlib.brotliCompress);
37
-
38
-
39
- // zlib.gzip(buffer[, options], callback)
40
-
41
-
42
- class Single_Control_Webpage_Server_Static_Compressed_Response_Buffers_Assigner extends Assigner {
43
-
44
- constructor(spec = {}) {
45
- super(spec);
46
- }
47
-
48
- // assign to bundle....
49
- // or array would be better.
50
-
51
- // assign to (bundle) items in array.
52
-
53
-
54
- // These assign functions should (all probably) be async
55
-
56
- async assign(arr_bundled_items) {
57
- // go through them....
58
-
59
- // Maybe check that the correct items are in the bundle.
60
-
61
- // Perhaps check for 1 of each js, css, html
62
- // And could use a specific other class to assign these.
63
-
64
- // Should be OK to make classes for really specific things.
65
- // At this part of the system / API, it's not necessary / important to limit complexity in that way.
66
-
67
- // The goal is to provide a very simple high level interface. Powerful too.
68
-
69
- // Could assign a static_route property to the items in the bundles.
70
-
71
-
72
-
73
-
74
-
75
- if (is_array(arr_bundled_items)) {
76
-
77
- for (const item of arr_bundled_items) {
78
- //console.log('item', item);
79
-
80
- const {type} = item;
81
-
82
- // And need to create the uncompressed response buffer.
83
-
84
- // // response_buffers.identity I think....
85
-
86
- if (item.text) {
87
-
88
- // Async compression definitely seems much better here.
89
-
90
-
91
- const buf_gzipped = await gzip_compress(item.response_buffers.identity);
92
-
93
- item.response_buffers.gzip = buf_gzipped;
94
-
95
- // Maybe should be 11 in many cases.
96
- // Seems right when publishing static JS resources.???
97
- // Compromise with 10 for the moment.
98
-
99
- const buf_br = await br_compress(item.response_buffers.identity, {
100
- params: {
101
- //[zlib.constants.BROTLI_PARAM_MODE]: zlib.constants.BROTLI_MODE_TEXT,
102
- [zlib.constants.BROTLI_PARAM_QUALITY]: 10,
103
- [zlib.constants.BROTLI_PARAM_SIZE_HINT]: item.response_buffers.identity.length,
104
- }
105
- });
106
-
107
- item.response_buffers.br = buf_br;
108
-
109
-
110
- // The gzip response
111
- // The brotli response
112
-
113
- // promisifying these calls would help.
114
-
115
-
116
- /*
117
-
118
-
119
- const buf_identity_response = Buffer.from(item.text, 'utf-8');
120
-
121
- item.response_buffers = item.response_buffers || {};
122
- item.response_buffers.identity = buf_identity_response;
123
- */
124
- } else {
125
-
126
- }
127
-
128
-
129
-
130
- //console.trace();
131
- //throw 'stop';
132
- }
133
-
134
- } else {
135
- console.trace();
136
- throw 'stop';
137
- }
138
-
139
-
140
-
141
-
142
- }
143
-
144
-
145
- }
146
-
147
-
148
- module.exports = Single_Control_Webpage_Server_Static_Compressed_Response_Buffers_Assigner;
149
-
150
-
1
+
2
+
3
+ // Making such specific classes with such long names seems kind of silly, but will help to keep the higher level code
4
+ // both explicit and easy to follow.
5
+
6
+ // These classes will do specific things, to specific things (in specific ways)
7
+
8
+ // Basically middleware that the app dev should not need to pay much attention to usually.
9
+
10
+
11
+
12
+
13
+ // And likely will have some other class (system), maybe assigners, to set the routes on the server / server router.
14
+ // Or within the website resource???
15
+
16
+ // So everything (main) that the server does will be done using various interchangable classes.
17
+ // Some classes will cover some very specific use cases.
18
+
19
+ const zlib = require('zlib');
20
+
21
+
22
+
23
+ const Assigner = require('../Assigner');
24
+
25
+ const {is_array} = require('lang-tools');
26
+
27
+ // And will have some very or less specific assigners for some other things.
28
+ // Like the compressed (text?) response headers.
29
+
30
+
31
+ const { promisify } = require('node:util');
32
+
33
+ // deflate, unzip
34
+
35
+ const gzip_compress = promisify(zlib.gzip);
36
+ const br_compress = promisify(zlib.brotliCompress);
37
+
38
+
39
+ // zlib.gzip(buffer[, options], callback)
40
+
41
+
42
+ class Single_Control_Webpage_Server_Static_Compressed_Response_Buffers_Assigner extends Assigner {
43
+
44
+ constructor(spec = {}) {
45
+ super(spec);
46
+ }
47
+
48
+ // assign to bundle....
49
+ // or array would be better.
50
+
51
+ // assign to (bundle) items in array.
52
+
53
+
54
+ // These assign functions should (all probably) be async
55
+
56
+ async assign(arr_bundled_items) {
57
+ // go through them....
58
+
59
+ // Maybe check that the correct items are in the bundle.
60
+
61
+ // Perhaps check for 1 of each js, css, html
62
+ // And could use a specific other class to assign these.
63
+
64
+ // Should be OK to make classes for really specific things.
65
+ // At this part of the system / API, it's not necessary / important to limit complexity in that way.
66
+
67
+ // The goal is to provide a very simple high level interface. Powerful too.
68
+
69
+ // Could assign a static_route property to the items in the bundles.
70
+
71
+
72
+
73
+
74
+
75
+ if (is_array(arr_bundled_items)) {
76
+
77
+ for (const item of arr_bundled_items) {
78
+ //console.log('item', item);
79
+
80
+ const {type} = item;
81
+
82
+ // And need to create the uncompressed response buffer.
83
+
84
+ // // response_buffers.identity I think....
85
+
86
+ if (item.text) {
87
+
88
+ // Async compression definitely seems much better here.
89
+
90
+
91
+ const buf_gzipped = await gzip_compress(item.response_buffers.identity);
92
+
93
+ item.response_buffers.gzip = buf_gzipped;
94
+
95
+ // Maybe should be 11 in many cases.
96
+ // Seems right when publishing static JS resources.???
97
+ // Compromise with 10 for the moment.
98
+
99
+ const buf_br = await br_compress(item.response_buffers.identity, {
100
+ params: {
101
+ //[zlib.constants.BROTLI_PARAM_MODE]: zlib.constants.BROTLI_MODE_TEXT,
102
+ [zlib.constants.BROTLI_PARAM_QUALITY]: 10,
103
+ [zlib.constants.BROTLI_PARAM_SIZE_HINT]: item.response_buffers.identity.length,
104
+ }
105
+ });
106
+
107
+ item.response_buffers.br = buf_br;
108
+
109
+
110
+ // The gzip response
111
+ // The brotli response
112
+
113
+ // promisifying these calls would help.
114
+
115
+
116
+ /*
117
+
118
+
119
+ const buf_identity_response = Buffer.from(item.text, 'utf-8');
120
+
121
+ item.response_buffers = item.response_buffers || {};
122
+ item.response_buffers.identity = buf_identity_response;
123
+ */
124
+ } else {
125
+
126
+ }
127
+
128
+
129
+
130
+ //console.trace();
131
+ //throw 'stop';
132
+ }
133
+
134
+ } else {
135
+ console.trace();
136
+ throw 'stop';
137
+ }
138
+
139
+
140
+
141
+
142
+ }
143
+
144
+
145
+ }
146
+
147
+
148
+ module.exports = Single_Control_Webpage_Server_Static_Compressed_Response_Buffers_Assigner;
149
+
150
+
@@ -1,110 +1,110 @@
1
-
2
-
3
- const Assigner = require('../Assigner');
4
-
5
- const {is_array, each} = require('lang-tools');
6
-
7
- // And will have some very or less specific assigners for some other things.
8
- // Like the compressed (text?) response headers.
9
-
10
-
11
-
12
-
13
- class Single_Control_Webpage_Server_Static_Headers_Assigner extends Assigner {
14
-
15
- constructor(spec = {}) {
16
- super(spec);
17
- }
18
-
19
- // assign to bundle....
20
- // or array would be better.
21
-
22
- // assign to (bundle) items in array.
23
-
24
- async assign(arr_bundled_items) {
25
- // go through them....
26
-
27
- // Maybe check that the correct items are in the bundle.
28
-
29
- // Perhaps check for 1 of each js, css, html
30
- // And could use a specific other class to assign these.
31
-
32
- // Should be OK to make classes for really specific things.
33
- // At this part of the system / API, it's not necessary / important to limit complexity in that way.
34
-
35
- // The goal is to provide a very simple high level interface. Powerful too.
36
-
37
- // Could assign a static_route property to the items in the bundles.
38
-
39
-
40
- if (is_array(arr_bundled_items)) {
41
-
42
- for (const item of arr_bundled_items) {
43
- //console.log('item', item);
44
-
45
- item.response_headers = item.response_headers || {};
46
-
47
- let str_content_type;
48
-
49
- if (item.type === 'JavaScript') {
50
- str_content_type = 'text/javascript; charset=utf-8';
51
- } else if (item.type === 'CSS') {
52
- str_content_type = 'text/css; charset=utf-8';
53
- } else if (item.type === 'HTML') {
54
- str_content_type = 'text/html; charset=utf-8';
55
- }
56
-
57
-
58
-
59
- // Different headers depending on the returned (ie accepted) content encoding types.
60
-
61
- // item.response_buffers.identity / gzip / br
62
-
63
- // go through the item.response_buffers
64
-
65
- each(item.response_buffers, (buf, content_encoding_name) => {
66
-
67
- //console.log('content_encoding_name', content_encoding_name);
68
-
69
- const headers_for_content_encoding = item.response_headers[content_encoding_name] = item.response_headers[content_encoding_name] || {};
70
- headers_for_content_encoding['Content-Length'] = buf.length;
71
-
72
-
73
- if (str_content_type) {
74
- headers_for_content_encoding['Content-Type'] = str_content_type;
75
- }
76
-
77
- if (content_encoding_name === 'identity') {
78
-
79
- } else {
80
- headers_for_content_encoding['Content-Encoding'] = content_encoding_name;
81
-
82
-
83
- }
84
-
85
-
86
-
87
- });
88
-
89
- // And setting the content types too...
90
-
91
-
92
- //console.trace();
93
- //throw 'stop';
94
- }
95
-
96
- } else {
97
- console.trace();
98
- throw 'stop';
99
- }
100
-
101
-
102
-
103
-
104
- }
105
-
106
-
107
- }
108
-
109
-
1
+
2
+
3
+ const Assigner = require('../Assigner');
4
+
5
+ const {is_array, each} = require('lang-tools');
6
+
7
+ // And will have some very or less specific assigners for some other things.
8
+ // Like the compressed (text?) response headers.
9
+
10
+
11
+
12
+
13
+ class Single_Control_Webpage_Server_Static_Headers_Assigner extends Assigner {
14
+
15
+ constructor(spec = {}) {
16
+ super(spec);
17
+ }
18
+
19
+ // assign to bundle....
20
+ // or array would be better.
21
+
22
+ // assign to (bundle) items in array.
23
+
24
+ async assign(arr_bundled_items) {
25
+ // go through them....
26
+
27
+ // Maybe check that the correct items are in the bundle.
28
+
29
+ // Perhaps check for 1 of each js, css, html
30
+ // And could use a specific other class to assign these.
31
+
32
+ // Should be OK to make classes for really specific things.
33
+ // At this part of the system / API, it's not necessary / important to limit complexity in that way.
34
+
35
+ // The goal is to provide a very simple high level interface. Powerful too.
36
+
37
+ // Could assign a static_route property to the items in the bundles.
38
+
39
+
40
+ if (is_array(arr_bundled_items)) {
41
+
42
+ for (const item of arr_bundled_items) {
43
+ //console.log('item', item);
44
+
45
+ item.response_headers = item.response_headers || {};
46
+
47
+ let str_content_type;
48
+
49
+ if (item.type === 'JavaScript') {
50
+ str_content_type = 'text/javascript; charset=utf-8';
51
+ } else if (item.type === 'CSS') {
52
+ str_content_type = 'text/css; charset=utf-8';
53
+ } else if (item.type === 'HTML') {
54
+ str_content_type = 'text/html; charset=utf-8';
55
+ }
56
+
57
+
58
+
59
+ // Different headers depending on the returned (ie accepted) content encoding types.
60
+
61
+ // item.response_buffers.identity / gzip / br
62
+
63
+ // go through the item.response_buffers
64
+
65
+ each(item.response_buffers, (buf, content_encoding_name) => {
66
+
67
+ //console.log('content_encoding_name', content_encoding_name);
68
+
69
+ const headers_for_content_encoding = item.response_headers[content_encoding_name] = item.response_headers[content_encoding_name] || {};
70
+ headers_for_content_encoding['Content-Length'] = buf.length;
71
+
72
+
73
+ if (str_content_type) {
74
+ headers_for_content_encoding['Content-Type'] = str_content_type;
75
+ }
76
+
77
+ if (content_encoding_name === 'identity') {
78
+
79
+ } else {
80
+ headers_for_content_encoding['Content-Encoding'] = content_encoding_name;
81
+
82
+
83
+ }
84
+
85
+
86
+
87
+ });
88
+
89
+ // And setting the content types too...
90
+
91
+
92
+ //console.trace();
93
+ //throw 'stop';
94
+ }
95
+
96
+ } else {
97
+ console.trace();
98
+ throw 'stop';
99
+ }
100
+
101
+
102
+
103
+
104
+ }
105
+
106
+
107
+ }
108
+
109
+
110
110
  module.exports = Single_Control_Webpage_Server_Static_Headers_Assigner;