node-opcua-address-space 2.70.3 → 2.71.0

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 (369) hide show
  1. package/dist/source/address_space_ts.d.ts +118 -118
  2. package/dist/source/address_space_ts.js +17 -17
  3. package/dist/source/continuation_points/continuation_point_manager.d.ts +32 -32
  4. package/dist/source/continuation_points/continuation_point_manager.js +195 -195
  5. package/dist/source/helpers/adjust_browse_direction.d.ts +5 -5
  6. package/dist/source/helpers/adjust_browse_direction.js +11 -11
  7. package/dist/source/helpers/argument_list.d.ts +34 -34
  8. package/dist/source/helpers/argument_list.js +285 -285
  9. package/dist/source/helpers/call_helpers.d.ts +6 -6
  10. package/dist/source/helpers/call_helpers.js +70 -70
  11. package/dist/source/helpers/check_event_clause.d.ts +17 -17
  12. package/dist/source/helpers/check_event_clause.js +52 -52
  13. package/dist/source/helpers/coerce_enum_value.d.ts +6 -6
  14. package/dist/source/helpers/coerce_enum_value.js +33 -33
  15. package/dist/source/helpers/dump_tools.d.ts +14 -14
  16. package/dist/source/helpers/dump_tools.js +78 -78
  17. package/dist/source/helpers/ensure_secure_access.d.ts +9 -9
  18. package/dist/source/helpers/ensure_secure_access.js +76 -76
  19. package/dist/source/helpers/make_optionals_map.d.ts +21 -21
  20. package/dist/source/helpers/make_optionals_map.js +29 -29
  21. package/dist/source/helpers/multiform_func.d.ts +11 -11
  22. package/dist/source/helpers/multiform_func.js +73 -73
  23. package/dist/source/helpers/resolve_opaque_on_address_space.d.ts +3 -3
  24. package/dist/source/helpers/resolve_opaque_on_address_space.js +36 -36
  25. package/dist/source/index.d.ts +40 -40
  26. package/dist/source/index.js +66 -66
  27. package/dist/source/interfaces/alarms_and_conditions/condition_info_i.d.ts +12 -12
  28. package/dist/source/interfaces/alarms_and_conditions/condition_info_i.js +2 -2
  29. package/dist/source/interfaces/alarms_and_conditions/ua_condition_base_i.d.ts +23 -0
  30. package/dist/source/interfaces/alarms_and_conditions/ua_condition_base_i.js +3 -0
  31. package/dist/source/interfaces/alarms_and_conditions/ua_condition_base_i.js.map +1 -0
  32. package/dist/source/interfaces/data_access/ua_discrete_item.d.ts +6 -0
  33. package/dist/source/interfaces/data_access/ua_discrete_item.js +3 -0
  34. package/dist/source/interfaces/data_access/ua_discrete_item.js.map +1 -0
  35. package/dist/source/interfaces/data_access/ua_multistate_discrete.d.ts +25 -0
  36. package/dist/source/interfaces/data_access/ua_multistate_discrete.js +3 -0
  37. package/dist/source/interfaces/data_access/ua_multistate_discrete.js.map +1 -0
  38. package/dist/source/interfaces/data_access/ua_multistate_discrete_ex.d.ts +21 -21
  39. package/dist/source/interfaces/data_access/ua_multistate_discrete_ex.js +2 -2
  40. package/dist/source/interfaces/data_access/ua_multistate_value_discrete.d.ts +27 -0
  41. package/dist/source/interfaces/data_access/ua_multistate_value_discrete.js +3 -0
  42. package/dist/source/interfaces/data_access/ua_multistate_value_discrete.js.map +1 -0
  43. package/dist/source/interfaces/data_access/ua_multistate_value_discrete_ex.d.ts +24 -24
  44. package/dist/source/interfaces/data_access/ua_multistate_value_discrete_ex.js +2 -2
  45. package/dist/source/interfaces/data_access/ua_two_state_discrete.d.ts +17 -0
  46. package/dist/source/interfaces/data_access/ua_two_state_discrete.js +3 -0
  47. package/dist/source/interfaces/data_access/ua_two_state_discrete.js.map +1 -0
  48. package/dist/source/interfaces/data_access/ua_two_state_discrete_ex.d.ts +12 -12
  49. package/dist/source/interfaces/data_access/ua_two_state_discrete_ex.js +2 -2
  50. package/dist/source/interfaces/data_access/ua_y_array_item.d.ts +19 -0
  51. package/dist/source/interfaces/data_access/ua_y_array_item.js +3 -0
  52. package/dist/source/interfaces/data_access/ua_y_array_item.js.map +1 -0
  53. package/dist/source/interfaces/data_access/ua_y_array_item_ex.d.ts +8 -8
  54. package/dist/source/interfaces/data_access/ua_y_array_item_ex.js +2 -2
  55. package/dist/source/interfaces/state_machine/exclusive_limit_state_machine.d.ts +11 -0
  56. package/dist/source/interfaces/state_machine/exclusive_limit_state_machine.js +3 -0
  57. package/dist/source/interfaces/state_machine/exclusive_limit_state_machine.js.map +1 -0
  58. package/dist/source/interfaces/state_machine/finite_state_machine.d.ts +70 -0
  59. package/dist/source/interfaces/state_machine/finite_state_machine.js +3 -0
  60. package/dist/source/interfaces/state_machine/finite_state_machine.js.map +1 -0
  61. package/dist/source/interfaces/state_machine/program_finite_state_machine.d.ts +74 -0
  62. package/dist/source/interfaces/state_machine/program_finite_state_machine.js +3 -0
  63. package/dist/source/interfaces/state_machine/program_finite_state_machine.js.map +1 -0
  64. package/dist/source/interfaces/state_machine/state_machine.d.ts +342 -0
  65. package/dist/source/interfaces/state_machine/state_machine.js +3 -0
  66. package/dist/source/interfaces/state_machine/state_machine.js.map +1 -0
  67. package/dist/source/interfaces/state_machine/ua_exclusive_limit_state_machine_type_ex.d.ts +12 -12
  68. package/dist/source/interfaces/state_machine/ua_exclusive_limit_state_machine_type_ex.js +2 -2
  69. package/dist/source/interfaces/state_machine/ua_finite_state_machine_type.d.ts +49 -49
  70. package/dist/source/interfaces/state_machine/ua_finite_state_machine_type.js +2 -2
  71. package/dist/source/interfaces/state_machine/ua_finite_state_variable.d.ts +18 -0
  72. package/dist/source/interfaces/state_machine/ua_finite_state_variable.js +3 -0
  73. package/dist/source/interfaces/state_machine/ua_finite_state_variable.js.map +1 -0
  74. package/dist/source/interfaces/state_machine/ua_program_state_machine_type.d.ts +11 -11
  75. package/dist/source/interfaces/state_machine/ua_program_state_machine_type.js +2 -2
  76. package/dist/source/interfaces/state_machine/ua_state_machine_type.d.ts +222 -222
  77. package/dist/source/interfaces/state_machine/ua_state_machine_type.js +2 -2
  78. package/dist/source/interfaces/state_machine/ua_state_variable.d.ts +29 -0
  79. package/dist/source/interfaces/state_machine/ua_state_variable.js +3 -0
  80. package/dist/source/interfaces/state_machine/ua_state_variable.js.map +1 -0
  81. package/dist/source/interfaces/state_machine/ua_transition_ex.d.ts +6 -6
  82. package/dist/source/interfaces/state_machine/ua_transition_ex.js +2 -2
  83. package/dist/source/interfaces/state_machine/ua_two_state_variable.d.ts +26 -0
  84. package/dist/source/interfaces/state_machine/ua_two_state_variable.js +3 -0
  85. package/dist/source/interfaces/state_machine/ua_two_state_variable.js.map +1 -0
  86. package/dist/source/interfaces/subscription_diagnostics_variable.d.ts +41 -0
  87. package/dist/source/interfaces/subscription_diagnostics_variable.js +3 -0
  88. package/dist/source/interfaces/subscription_diagnostics_variable.js.map +1 -0
  89. package/dist/source/interfaces/ua_subscription_diagnostics_variable_ex.d.ts +8 -8
  90. package/dist/source/interfaces/ua_subscription_diagnostics_variable_ex.js +2 -2
  91. package/dist/source/loader/decode_xml_extension_object.d.ts +6 -6
  92. package/dist/source/loader/decode_xml_extension_object.js +71 -71
  93. package/dist/source/loader/ensure_datatype_extracted.d.ts +5 -5
  94. package/dist/source/loader/ensure_datatype_extracted.js +45 -45
  95. package/dist/source/loader/generateAddressSpaceRaw.d.ts +10 -10
  96. package/dist/source/loader/generateAddressSpaceRaw.js +45 -45
  97. package/dist/source/loader/load_nodeset2.d.ts +16 -16
  98. package/dist/source/loader/load_nodeset2.js +1464 -1464
  99. package/dist/source/loader/make_xml_extension_object_parser.d.ts +28 -28
  100. package/dist/source/loader/make_xml_extension_object_parser.js +315 -315
  101. package/dist/source/loader/namespace_post_step.d.ts +6 -6
  102. package/dist/source/loader/namespace_post_step.js +47 -47
  103. package/dist/source/loader/register_node_promoter.d.ts +3 -3
  104. package/dist/source/loader/register_node_promoter.js +9 -9
  105. package/dist/source/namespace.d.ts +6 -6
  106. package/dist/source/namespace.js +2 -2
  107. package/dist/source/namespace_alarm_and_condition.d.ts +24 -24
  108. package/dist/source/namespace_alarm_and_condition.js +2 -2
  109. package/dist/source/namespace_data_access.d.ts +42 -42
  110. package/dist/source/namespace_data_access.js +2 -2
  111. package/dist/source/namespace_machine_state.d.ts +7 -7
  112. package/dist/source/namespace_machine_state.js +2 -2
  113. package/dist/source/pseudo_session.d.ts +55 -55
  114. package/dist/source/pseudo_session.js +203 -203
  115. package/dist/source/session_context.d.ts +111 -111
  116. package/dist/source/session_context.js +265 -265
  117. package/dist/source/set_namespace_meta_data.d.ts +2 -2
  118. package/dist/source/set_namespace_meta_data.js +59 -59
  119. package/dist/source/ua_root_folder.d.ts +9 -9
  120. package/dist/source/ua_root_folder.js +2 -2
  121. package/dist/source/ua_two_state_variable_ex.d.ts +23 -23
  122. package/dist/source/ua_two_state_variable_ex.js +2 -2
  123. package/dist/source/xml_writer.d.ts +9 -9
  124. package/dist/source/xml_writer.js +2 -2
  125. package/dist/src/address_space.d.ts +392 -392
  126. package/dist/src/address_space.js +1387 -1387
  127. package/dist/src/address_space_change_event_tools.d.ts +6 -6
  128. package/dist/src/address_space_change_event_tools.js +149 -149
  129. package/dist/src/address_space_private.d.ts +43 -43
  130. package/dist/src/address_space_private.js +2 -2
  131. package/dist/src/alarms_and_conditions/base_event_type.d.ts +26 -0
  132. package/dist/src/alarms_and_conditions/base_event_type.js +41 -0
  133. package/dist/src/alarms_and_conditions/base_event_type.js.map +1 -0
  134. package/dist/src/alarms_and_conditions/check_where_clause.d.ts +4 -4
  135. package/dist/src/alarms_and_conditions/check_where_clause.js +109 -109
  136. package/dist/src/alarms_and_conditions/condition.d.ts +5 -5
  137. package/dist/src/alarms_and_conditions/condition.js +80 -80
  138. package/dist/src/alarms_and_conditions/condition_info.d.ts +27 -27
  139. package/dist/src/alarms_and_conditions/condition_info.js +54 -54
  140. package/dist/src/alarms_and_conditions/condition_snapshot.d.ts +233 -233
  141. package/dist/src/alarms_and_conditions/condition_snapshot.js +666 -666
  142. package/dist/src/alarms_and_conditions/deviation_alarm_helper.d.ts +21 -21
  143. package/dist/src/alarms_and_conditions/deviation_alarm_helper.js +46 -46
  144. package/dist/src/alarms_and_conditions/extract_event_fields.d.ts +10 -10
  145. package/dist/src/alarms_and_conditions/extract_event_fields.js +89 -89
  146. package/dist/src/alarms_and_conditions/index.d.ts +18 -18
  147. package/dist/src/alarms_and_conditions/index.js +34 -34
  148. package/dist/src/alarms_and_conditions/shelving_state_machine.d.ts +22 -0
  149. package/dist/src/alarms_and_conditions/shelving_state_machine.js +241 -0
  150. package/dist/src/alarms_and_conditions/shelving_state_machine.js.map +1 -0
  151. package/dist/src/alarms_and_conditions/trip_alarm.d.ts +16 -0
  152. package/dist/src/alarms_and_conditions/trip_alarm.js +21 -0
  153. package/dist/src/alarms_and_conditions/trip_alarm.js.map +1 -0
  154. package/dist/src/alarms_and_conditions/ua_acknowledgeable_condition_base.d.ts +54 -0
  155. package/dist/src/alarms_and_conditions/ua_acknowledgeable_condition_base.js +255 -0
  156. package/dist/src/alarms_and_conditions/ua_acknowledgeable_condition_base.js.map +1 -0
  157. package/dist/src/alarms_and_conditions/ua_acknowledgeable_condition_impl.d.ts +62 -62
  158. package/dist/src/alarms_and_conditions/ua_acknowledgeable_condition_impl.js +244 -244
  159. package/dist/src/alarms_and_conditions/ua_alarm_condition_base.d.ts +138 -0
  160. package/dist/src/alarms_and_conditions/ua_alarm_condition_base.js +460 -0
  161. package/dist/src/alarms_and_conditions/ua_alarm_condition_base.js.map +1 -0
  162. package/dist/src/alarms_and_conditions/ua_alarm_condition_impl.d.ts +118 -118
  163. package/dist/src/alarms_and_conditions/ua_alarm_condition_impl.js +416 -416
  164. package/dist/src/alarms_and_conditions/ua_base_event_impl.d.ts +29 -29
  165. package/dist/src/alarms_and_conditions/ua_base_event_impl.js +38 -38
  166. package/dist/src/alarms_and_conditions/ua_certificate_expiration_alarm.d.ts +35 -0
  167. package/dist/src/alarms_and_conditions/ua_certificate_expiration_alarm.js +32 -0
  168. package/dist/src/alarms_and_conditions/ua_certificate_expiration_alarm.js.map +1 -0
  169. package/dist/src/alarms_and_conditions/ua_certificate_expiration_alarm_impl.d.ts +21 -21
  170. package/dist/src/alarms_and_conditions/ua_certificate_expiration_alarm_impl.js +25 -25
  171. package/dist/src/alarms_and_conditions/ua_condition_base.d.ts +191 -0
  172. package/dist/src/alarms_and_conditions/ua_condition_base.js +1029 -0
  173. package/dist/src/alarms_and_conditions/ua_condition_base.js.map +1 -0
  174. package/dist/src/alarms_and_conditions/ua_condition_impl.d.ts +182 -182
  175. package/dist/src/alarms_and_conditions/ua_condition_impl.js +1022 -1022
  176. package/dist/src/alarms_and_conditions/ua_discrete_alarm.d.ts +11 -0
  177. package/dist/src/alarms_and_conditions/ua_discrete_alarm.js +58 -0
  178. package/dist/src/alarms_and_conditions/ua_discrete_alarm.js.map +1 -0
  179. package/dist/src/alarms_and_conditions/ua_discrete_alarm_impl.d.ts +17 -17
  180. package/dist/src/alarms_and_conditions/ua_discrete_alarm_impl.js +57 -57
  181. package/dist/src/alarms_and_conditions/ua_exclusive_deviation_alarm.d.ts +24 -0
  182. package/dist/src/alarms_and_conditions/ua_exclusive_deviation_alarm.js +59 -0
  183. package/dist/src/alarms_and_conditions/ua_exclusive_deviation_alarm.js.map +1 -0
  184. package/dist/src/alarms_and_conditions/ua_exclusive_deviation_alarm_impl.d.ts +27 -27
  185. package/dist/src/alarms_and_conditions/ua_exclusive_deviation_alarm_impl.js +56 -56
  186. package/dist/src/alarms_and_conditions/ua_exclusive_level_alarm.d.ts +14 -0
  187. package/dist/src/alarms_and_conditions/ua_exclusive_level_alarm.js +17 -0
  188. package/dist/src/alarms_and_conditions/ua_exclusive_level_alarm.js.map +1 -0
  189. package/dist/src/alarms_and_conditions/ua_exclusive_level_alarm_impl.d.ts +9 -9
  190. package/dist/src/alarms_and_conditions/ua_exclusive_level_alarm_impl.js +11 -11
  191. package/dist/src/alarms_and_conditions/ua_exclusive_limit_alarm.d.ts +22 -0
  192. package/dist/src/alarms_and_conditions/ua_exclusive_limit_alarm.js +87 -0
  193. package/dist/src/alarms_and_conditions/ua_exclusive_limit_alarm.js.map +1 -0
  194. package/dist/src/alarms_and_conditions/ua_exclusive_limit_alarm_impl.d.ts +38 -38
  195. package/dist/src/alarms_and_conditions/ua_exclusive_limit_alarm_impl.js +86 -86
  196. package/dist/src/alarms_and_conditions/ua_exclusive_rate_of_change_alarm.d.ts +6 -0
  197. package/dist/src/alarms_and_conditions/ua_exclusive_rate_of_change_alarm.js +11 -0
  198. package/dist/src/alarms_and_conditions/ua_exclusive_rate_of_change_alarm.js.map +1 -0
  199. package/dist/src/alarms_and_conditions/ua_exclusive_rate_of_change_alarm_impl.d.ts +10 -10
  200. package/dist/src/alarms_and_conditions/ua_exclusive_rate_of_change_alarm_impl.js +7 -7
  201. package/dist/src/alarms_and_conditions/ua_limit_alarm.d.ts +76 -0
  202. package/dist/src/alarms_and_conditions/ua_limit_alarm.js +237 -0
  203. package/dist/src/alarms_and_conditions/ua_limit_alarm.js.map +1 -0
  204. package/dist/src/alarms_and_conditions/ua_limit_alarm_impl.d.ts +97 -97
  205. package/dist/src/alarms_and_conditions/ua_limit_alarm_impl.js +250 -250
  206. package/dist/src/alarms_and_conditions/ua_non_exclusive_deviation_alarm.d.ts +27 -0
  207. package/dist/src/alarms_and_conditions/ua_non_exclusive_deviation_alarm.js +62 -0
  208. package/dist/src/alarms_and_conditions/ua_non_exclusive_deviation_alarm.js.map +1 -0
  209. package/dist/src/alarms_and_conditions/ua_non_exclusive_deviation_alarm_impl.d.ts +28 -28
  210. package/dist/src/alarms_and_conditions/ua_non_exclusive_deviation_alarm_impl.js +50 -50
  211. package/dist/src/alarms_and_conditions/ua_non_exclusive_limit_alarm.d.ts +49 -0
  212. package/dist/src/alarms_and_conditions/ua_non_exclusive_limit_alarm.js +176 -0
  213. package/dist/src/alarms_and_conditions/ua_non_exclusive_limit_alarm.js.map +1 -0
  214. package/dist/src/alarms_and_conditions/ua_non_exclusive_limit_alarm_impl.d.ts +25 -25
  215. package/dist/src/alarms_and_conditions/ua_non_exclusive_limit_alarm_impl.js +162 -162
  216. package/dist/src/alarms_and_conditions/ua_off_normal_alarm.d.ts +47 -0
  217. package/dist/src/alarms_and_conditions/ua_off_normal_alarm.js +151 -0
  218. package/dist/src/alarms_and_conditions/ua_off_normal_alarm.js.map +1 -0
  219. package/dist/src/alarms_and_conditions/ua_off_normal_alarm_impl.d.ts +39 -39
  220. package/dist/src/alarms_and_conditions/ua_off_normal_alarm_impl.js +135 -135
  221. package/dist/src/alarms_and_conditions/ua_system_off_normal_alarm.d.ts +16 -0
  222. package/dist/src/alarms_and_conditions/ua_system_off_normal_alarm.js +18 -0
  223. package/dist/src/alarms_and_conditions/ua_system_off_normal_alarm.js.map +1 -0
  224. package/dist/src/alarms_and_conditions/ua_system_off_normal_alarm_impl.d.ts +16 -16
  225. package/dist/src/alarms_and_conditions/ua_system_off_normal_alarm_impl.js +17 -17
  226. package/dist/src/apply_condition_refresh.d.ts +6 -6
  227. package/dist/src/apply_condition_refresh.js +27 -27
  228. package/dist/src/base_node.d.ts +270 -0
  229. package/dist/src/base_node.js +1299 -0
  230. package/dist/src/base_node.js.map +1 -0
  231. package/dist/src/base_node_impl.d.ts +281 -281
  232. package/dist/src/base_node_impl.js +1395 -1395
  233. package/dist/src/base_node_private.d.ts +61 -61
  234. package/dist/src/base_node_private.js +705 -705
  235. package/dist/src/data_access/add_dataItem_stuff.d.ts +11 -11
  236. package/dist/src/data_access/add_dataItem_stuff.js +61 -61
  237. package/dist/src/data_access/check_variant_compatibility_ua_analog_item.d.ts +1 -1
  238. package/dist/src/data_access/check_variant_compatibility_ua_analog_item.js +34 -34
  239. package/dist/src/data_access/ua_analog_item.d.ts +13 -0
  240. package/dist/src/data_access/ua_analog_item.js +37 -0
  241. package/dist/src/data_access/ua_analog_item.js.map +1 -0
  242. package/dist/src/data_access/ua_data_item.d.ts +16 -0
  243. package/dist/src/data_access/ua_data_item.js +66 -0
  244. package/dist/src/data_access/ua_data_item.js.map +1 -0
  245. package/dist/src/data_access/ua_multistate_discrete.d.ts +24 -0
  246. package/dist/src/data_access/ua_multistate_discrete.js +132 -0
  247. package/dist/src/data_access/ua_multistate_discrete.js.map +1 -0
  248. package/dist/src/data_access/ua_multistate_discrete_impl.d.ts +32 -32
  249. package/dist/src/data_access/ua_multistate_discrete_impl.js +130 -130
  250. package/dist/src/data_access/ua_multistate_value_discrete.d.ts +51 -51
  251. package/dist/src/data_access/ua_multistate_value_discrete.js +249 -249
  252. package/dist/src/data_access/ua_two_state_discrete.d.ts +25 -25
  253. package/dist/src/data_access/ua_two_state_discrete.js +153 -153
  254. package/dist/src/event_data.d.ts +29 -29
  255. package/dist/src/event_data.js +95 -95
  256. package/dist/src/extension_object_array_node.d.ts +61 -61
  257. package/dist/src/extension_object_array_node.js +276 -276
  258. package/dist/src/historical_access/address_space_historical_data_node.d.ts +26 -26
  259. package/dist/src/historical_access/address_space_historical_data_node.js +630 -630
  260. package/dist/src/index_current.d.ts +45 -45
  261. package/dist/src/index_current.js +77 -77
  262. package/dist/src/namespace.d.ts +472 -0
  263. package/dist/src/namespace.js +1759 -0
  264. package/dist/src/namespace.js.map +1 -0
  265. package/dist/src/namespace_impl.d.ts +457 -457
  266. package/dist/src/namespace_impl.js +1733 -1733
  267. package/dist/src/namespace_private.d.ts +21 -21
  268. package/dist/src/namespace_private.js +32 -32
  269. package/dist/src/nodeid_manager.d.ts +36 -36
  270. package/dist/src/nodeid_manager.js +197 -197
  271. package/dist/src/nodeset_tools/adjust_namespace_array.d.ts +2 -2
  272. package/dist/src/nodeset_tools/adjust_namespace_array.js +13 -13
  273. package/dist/src/nodeset_tools/construct_namespace_dependency.d.ts +2 -2
  274. package/dist/src/nodeset_tools/construct_namespace_dependency.js +83 -83
  275. package/dist/src/nodeset_tools/nodeset_to_xml.d.ts +2 -2
  276. package/dist/src/nodeset_tools/nodeset_to_xml.js +1143 -1143
  277. package/dist/src/nodeset_tools/typedictionary_to_xml.d.ts +2 -2
  278. package/dist/src/nodeset_tools/typedictionary_to_xml.js +154 -154
  279. package/dist/src/reference.d.ts +43 -0
  280. package/dist/src/reference.js +138 -0
  281. package/dist/src/reference.js.map +1 -0
  282. package/dist/src/reference_impl.d.ts +43 -43
  283. package/dist/src/reference_impl.js +139 -139
  284. package/dist/src/role_permissions.d.ts +2 -2
  285. package/dist/src/role_permissions.js +10 -10
  286. package/dist/src/session_context.d.ts +4 -0
  287. package/dist/src/session_context.js +9 -0
  288. package/dist/src/session_context.js.map +1 -0
  289. package/dist/src/state_machine/finite_state_machine.d.ts +67 -67
  290. package/dist/src/state_machine/finite_state_machine.js +353 -353
  291. package/dist/src/state_machine/ua_shelving_state_machine_ex.d.ts +34 -34
  292. package/dist/src/state_machine/ua_shelving_state_machine_ex.js +250 -250
  293. package/dist/src/state_machine/ua_two_state_variable.d.ts +61 -61
  294. package/dist/src/state_machine/ua_two_state_variable.js +331 -331
  295. package/dist/src/tool_isSupertypeOf.d.ts +17 -17
  296. package/dist/src/tool_isSupertypeOf.js +108 -108
  297. package/dist/src/ua_condition_type.d.ts +8 -8
  298. package/dist/src/ua_condition_type.js +2 -2
  299. package/dist/src/ua_data_type.d.ts +81 -0
  300. package/dist/src/ua_data_type.js +259 -0
  301. package/dist/src/ua_data_type.js.map +1 -0
  302. package/dist/src/ua_data_type_impl.d.ts +93 -93
  303. package/dist/src/ua_data_type_impl.js +368 -368
  304. package/dist/src/ua_method.d.ts +33 -0
  305. package/dist/src/ua_method.js +194 -0
  306. package/dist/src/ua_method.js.map +1 -0
  307. package/dist/src/ua_method_impl.d.ts +41 -41
  308. package/dist/src/ua_method_impl.js +208 -208
  309. package/dist/src/ua_object.d.ts +27 -0
  310. package/dist/src/ua_object.js +153 -0
  311. package/dist/src/ua_object.js.map +1 -0
  312. package/dist/src/ua_object_impl.d.ts +33 -33
  313. package/dist/src/ua_object_impl.js +156 -156
  314. package/dist/src/ua_object_type.d.ts +49 -0
  315. package/dist/src/ua_object_type.js +123 -0
  316. package/dist/src/ua_object_type.js.map +1 -0
  317. package/dist/src/ua_object_type_impl.d.ts +48 -48
  318. package/dist/src/ua_object_type_impl.js +124 -124
  319. package/dist/src/ua_reference_type.d.ts +31 -0
  320. package/dist/src/ua_reference_type.js +108 -0
  321. package/dist/src/ua_reference_type.js.map +1 -0
  322. package/dist/src/ua_reference_type_impl.d.ts +43 -43
  323. package/dist/src/ua_reference_type_impl.js +139 -139
  324. package/dist/src/ua_variable.d.ts +346 -0
  325. package/dist/src/ua_variable.js +1651 -0
  326. package/dist/src/ua_variable.js.map +1 -0
  327. package/dist/src/ua_variable_impl.d.ts +351 -351
  328. package/dist/src/ua_variable_impl.js +1604 -1604
  329. package/dist/src/ua_variable_impl_ext_obj.d.ts +17 -17
  330. package/dist/src/ua_variable_impl_ext_obj.js +437 -437
  331. package/dist/src/ua_variable_type.d.ts +57 -0
  332. package/dist/src/ua_variable_type.js +530 -0
  333. package/dist/src/ua_variable_type.js.map +1 -0
  334. package/dist/src/ua_variable_type_impl.d.ts +62 -62
  335. package/dist/src/ua_variable_type_impl.js +570 -564
  336. package/dist/src/ua_variable_type_impl.js.map +1 -1
  337. package/dist/src/ua_view.d.ts +16 -0
  338. package/dist/src/ua_view.js +41 -0
  339. package/dist/src/ua_view.js.map +1 -0
  340. package/dist/src/ua_view_impl.d.ts +15 -15
  341. package/dist/src/ua_view_impl.js +36 -36
  342. package/distHelpers/add_event_generator_object.d.ts +3 -3
  343. package/distHelpers/add_event_generator_object.js +65 -65
  344. package/distHelpers/alarms_and_conditions_demo.d.ts +10 -10
  345. package/distHelpers/alarms_and_conditions_demo.js +114 -114
  346. package/distHelpers/assertHasMatchingReference.d.ts +19 -19
  347. package/distHelpers/assertHasMatchingReference.js +40 -40
  348. package/distHelpers/boiler_system.d.ts +113 -113
  349. package/distHelpers/boiler_system.js +395 -395
  350. package/distHelpers/create_minimalist_address_space_nodeset.d.ts +5 -5
  351. package/distHelpers/create_minimalist_address_space_nodeset.js +171 -171
  352. package/distHelpers/date_utils.d.ts +3 -3
  353. package/distHelpers/date_utils.js +9 -9
  354. package/distHelpers/dump_statemachine.js +127 -127
  355. package/distHelpers/get_address_space_fixture.d.ts +1 -1
  356. package/distHelpers/get_address_space_fixture.js +30 -30
  357. package/distHelpers/get_mini_address_space.d.ts +7 -7
  358. package/distHelpers/get_mini_address_space.js +36 -36
  359. package/distHelpers/index.d.ts +12 -12
  360. package/distHelpers/index.js +28 -28
  361. package/distHelpers/mock_session.d.ts +14 -14
  362. package/distHelpers/mock_session.js +25 -25
  363. package/distNodeJS/generate_address_space.d.ts +4 -4
  364. package/distNodeJS/generate_address_space.js +41 -41
  365. package/distNodeJS/index.d.ts +1 -1
  366. package/distNodeJS/index.js +17 -17
  367. package/package.json +38 -38
  368. package/src/ua_variable_type_impl.ts +11 -4
  369. package/test_helpers/test_fixtures/eurange_issue.xml +73 -0
@@ -1,565 +1,571 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.initialize_properties_and_components = exports.assertUnusedChildBrowseName = exports.UAVariableTypeImpl = exports.topMostParentIsObjectTypeOrVariableType = void 0;
4
- /**
5
- * @module node-opcua-address-space
6
- */
7
- // tslint:disable:max-classes-per-file
8
- // tslint:disable:no-console
9
- const chalk = require("chalk");
10
- const node_opcua_assert_1 = require("node-opcua-assert");
11
- const node_opcua_constants_1 = require("node-opcua-constants");
12
- const node_opcua_data_model_1 = require("node-opcua-data-model");
13
- const node_opcua_data_value_1 = require("node-opcua-data-value");
14
- const node_opcua_debug_1 = require("node-opcua-debug");
15
- const node_opcua_nodeid_1 = require("node-opcua-nodeid");
16
- const node_opcua_status_code_1 = require("node-opcua-status-code");
17
- const node_opcua_utils_1 = require("node-opcua-utils");
18
- const node_opcua_variant_1 = require("node-opcua-variant");
19
- const session_context_1 = require("../source/session_context");
20
- const make_optionals_map_1 = require("../source/helpers/make_optionals_map");
21
- const base_node_impl_1 = require("./base_node_impl");
22
- const base_node_private_1 = require("./base_node_private");
23
- const tools = require("./tool_isSupertypeOf");
24
- const tool_isSupertypeOf_1 = require("./tool_isSupertypeOf");
25
- const tool_isSupertypeOf_2 = require("./tool_isSupertypeOf");
26
- const debugLog = (0, node_opcua_debug_1.make_debugLog)(__filename);
27
- const doDebug = (0, node_opcua_debug_1.checkDebugFlag)(__filename);
28
- const warningLog = (0, node_opcua_debug_1.make_warningLog)(__filename);
29
- const errorLog = (0, node_opcua_debug_1.make_errorLog)(__filename);
30
- // eslint-disable-next-line prefer-const
31
- let doTrace = (0, node_opcua_debug_1.checkDebugFlag)("INSTANTIATE");
32
- const traceLog = errorLog;
33
- function topMostParentIsObjectTypeOrVariableType(addressSpace, options) {
34
- var _a;
35
- if (options.modellingRule) {
36
- return true;
37
- }
38
- const parent = options.propertyOf || options.componentOf;
39
- if (!parent) {
40
- return false;
41
- }
42
- const parentNode = addressSpace._coerceNode(parent);
43
- if (!parentNode) {
44
- return false;
45
- }
46
- let currentNode = parentNode;
47
- while (currentNode) {
48
- const nodeClass = parentNode.nodeClass;
49
- if (nodeClass === node_opcua_data_model_1.NodeClass.ObjectType || nodeClass === node_opcua_data_model_1.NodeClass.VariableType) {
50
- return true;
51
- }
52
- if (nodeClass === node_opcua_data_model_1.NodeClass.Object || nodeClass === node_opcua_data_model_1.NodeClass.Variable || nodeClass === node_opcua_data_model_1.NodeClass.Method) {
53
- /** */
54
- }
55
- currentNode = (_a = currentNode.findReferencesEx("HasChild", node_opcua_data_model_1.BrowseDirection.Inverse)[0]) === null || _a === void 0 ? void 0 : _a.node;
56
- }
57
- return false;
58
- }
59
- exports.topMostParentIsObjectTypeOrVariableType = topMostParentIsObjectTypeOrVariableType;
60
- class UAVariableTypeImpl extends base_node_impl_1.BaseNodeImpl {
61
- constructor(options) {
62
- super(options);
63
- this.nodeClass = node_opcua_data_model_1.NodeClass.VariableType;
64
- this.isSupertypeOf = tools.construct_isSupertypeOf(UAVariableTypeImpl);
65
- (0, node_opcua_variant_1.verifyRankAndDimensions)(options);
66
- this.valueRank = options.valueRank || -1;
67
- this.arrayDimensions = options.arrayDimensions || null;
68
- this.minimumSamplingInterval = 0;
69
- this.historizing = (0, node_opcua_utils_1.isNullOrUndefined)(options.historizing) ? false : options.historizing;
70
- this.isAbstract = (0, node_opcua_utils_1.isNullOrUndefined)(options.isAbstract) ? false : options.isAbstract;
71
- this.value = options.value; // optional default value for instances of this UAVariableType
72
- this.dataType = (0, node_opcua_nodeid_1.coerceNodeId)(options.dataType); // DataType (NodeId)
73
- if (options.value) {
74
- this.value = new node_opcua_variant_1.Variant(options.value);
75
- }
76
- }
77
- get subtypeOf() {
78
- return tool_isSupertypeOf_2.get_subtypeOf.call(this);
79
- }
80
- get subtypeOfObj() {
81
- return tool_isSupertypeOf_1.get_subtypeOfObj.call(this);
82
- }
83
- readAttribute(context, attributeId) {
84
- (0, node_opcua_assert_1.assert)(!context || context instanceof session_context_1.SessionContext);
85
- const options = {};
86
- switch (attributeId) {
87
- case node_opcua_data_model_1.AttributeIds.IsAbstract:
88
- options.value = { dataType: node_opcua_variant_1.DataType.Boolean, value: this.isAbstract ? true : false };
89
- options.statusCode = node_opcua_status_code_1.StatusCodes.Good;
90
- break;
91
- case node_opcua_data_model_1.AttributeIds.Value:
92
- if (Object.prototype.hasOwnProperty.call(this, "value") && this.value !== undefined) {
93
- (0, node_opcua_assert_1.assert)(this.value.schema.name === "Variant");
94
- options.value = this.value;
95
- options.statusCode = node_opcua_status_code_1.StatusCodes.Good;
96
- }
97
- else {
98
- debugLog(" warning Value not implemented");
99
- options.value = { dataType: node_opcua_variant_1.DataType.UInt32, value: 0 };
100
- options.statusCode = node_opcua_status_code_1.StatusCodes.BadAttributeIdInvalid;
101
- }
102
- break;
103
- case node_opcua_data_model_1.AttributeIds.DataType:
104
- (0, node_opcua_assert_1.assert)(this.dataType instanceof node_opcua_nodeid_1.NodeId);
105
- options.value = { dataType: node_opcua_variant_1.DataType.NodeId, value: this.dataType };
106
- options.statusCode = node_opcua_status_code_1.StatusCodes.Good;
107
- break;
108
- case node_opcua_data_model_1.AttributeIds.ValueRank:
109
- options.value = { dataType: node_opcua_variant_1.DataType.Int32, value: this.valueRank };
110
- options.statusCode = node_opcua_status_code_1.StatusCodes.Good;
111
- break;
112
- case node_opcua_data_model_1.AttributeIds.ArrayDimensions:
113
- (0, node_opcua_assert_1.assert)(Array.isArray(this.arrayDimensions) || this.arrayDimensions === null);
114
- options.value = {
115
- arrayType: node_opcua_variant_1.VariantArrayType.Array,
116
- dataType: node_opcua_variant_1.DataType.UInt32,
117
- value: this.arrayDimensions
118
- };
119
- options.statusCode = node_opcua_status_code_1.StatusCodes.Good;
120
- break;
121
- default:
122
- return super.readAttribute(context, attributeId);
123
- }
124
- return new node_opcua_data_value_1.DataValue(options);
125
- }
126
- toString() {
127
- const options = new base_node_private_1.ToStringBuilder();
128
- base_node_private_1.UAVariableType_toString.call(this, options);
129
- return options.toString();
130
- }
131
- /**
132
- * instantiate an object of this UAVariableType
133
- * The instantiation takes care of object type inheritance when constructing inner properties
134
-
135
- * Note : HasComponent usage scope
136
- *
137
- * ```text
138
- * Source | Destination
139
- * -------------------+---------------------------
140
- * Object | Object, Variable,Method
141
- * ObjectType |
142
- * -------------------+---------------------------
143
- * DataVariable | Variable
144
- * DataVariableType |
145
- * ```
146
- *
147
- * see : OPCUA 1.03 page 44 $6.4 Instances of ObjectTypes and VariableTypes
148
- */
149
- instantiate(options) {
150
- const addressSpace = this.addressSpace;
151
- // xx assert(!this.isAbstract, "cannot instantiate abstract UAVariableType");
152
- (0, node_opcua_assert_1.assert)(options, "missing option object");
153
- (0, node_opcua_assert_1.assert)(typeof options.browseName === "string" || (options.browseName !== null && typeof options.browseName === "object"), "expecting a browse name");
154
- (0, node_opcua_assert_1.assert)(!Object.prototype.hasOwnProperty.call(options, "propertyOf"), "Use addressSpace#addVariable({ propertyOf: xxx}); to add a property");
155
- assertUnusedChildBrowseName(addressSpace, options);
156
- const baseVariableType = addressSpace.findVariableType("BaseVariableType");
157
- (0, node_opcua_assert_1.assert)(baseVariableType, "BaseVariableType must be defined in the address space");
158
- let dataType = options.dataType !== undefined ? options.dataType : this.dataType;
159
- // may be required (i.e YArrayItemType )
160
- dataType = this.resolveNodeId(dataType); // DataType (NodeId)
161
- (0, node_opcua_assert_1.assert)(dataType instanceof node_opcua_nodeid_1.NodeId);
162
- const valueRank = options.valueRank !== undefined ? options.valueRank : this.valueRank;
163
- const arrayDimensions = options.arrayDimensions !== undefined ? options.arrayDimensions : this.arrayDimensions;
164
- // istanbul ignore next
165
- if (!dataType || dataType.isEmpty()) {
166
- warningLog(" options.dataType", options.dataType ? options.dataType.toString() : "<null>");
167
- warningLog(" this.dataType", this.dataType ? this.dataType.toString() : "<null>");
168
- throw new Error(" A valid dataType must be specified");
169
- }
170
- const copyAlsoModellingRules = topMostParentIsObjectTypeOrVariableType(addressSpace, options);
171
- const opts = {
172
- arrayDimensions,
173
- browseName: options.browseName,
174
- componentOf: options.componentOf,
175
- dataType,
176
- description: options.description || this.description,
177
- displayName: options.displayName || "",
178
- eventSourceOf: options.eventSourceOf,
179
- minimumSamplingInterval: options.minimumSamplingInterval,
180
- modellingRule: options.modellingRule,
181
- nodeId: options.nodeId,
182
- notifierOf: options.notifierOf,
183
- organizedBy: options.organizedBy,
184
- typeDefinition: this.nodeId,
185
- value: options.value,
186
- valueRank
187
- };
188
- const namespace = options.namespace || addressSpace.getOwnNamespace();
189
- const instance = namespace.addVariable(opts);
190
- // xx assert(instance.minimumSamplingInterval === options.minimumSamplingInterval);
191
- initialize_properties_and_components(instance, baseVariableType, this, copyAlsoModellingRules, options.optionals);
192
- // if VariableType is a type of Structure DataType
193
- // we need to instantiate a dataValue
194
- // and create a bidirectional binding with the individual properties of this type
195
- instance.bindExtensionObject(options.extensionObject);
196
- (0, node_opcua_assert_1.assert)(instance.typeDefinition.toString() === this.nodeId.toString());
197
- instance.install_extra_properties();
198
- if (this._postInstantiateFunc) {
199
- this._postInstantiateFunc(instance, this);
200
- }
201
- return instance;
202
- }
203
- }
204
- exports.UAVariableTypeImpl = UAVariableTypeImpl;
205
- /**
206
- * return true if node is a mandatory child or a requested optional
207
- * @method MandatoryChildOrRequestedOptionalFilter
208
- * @param instance
209
- * @param optionalsMap
210
- * @return {Boolean}
211
- */
212
- class MandatoryChildOrRequestedOptionalFilter {
213
- constructor(instance, optionalsMap) {
214
- // should we clone the node to be a component or propertyOf of a instance
215
- (0, node_opcua_assert_1.assert)(optionalsMap !== null && typeof optionalsMap === "object");
216
- (0, node_opcua_assert_1.assert)(null !== instance);
217
- this.optionalsMap = optionalsMap;
218
- this.instance = instance;
219
- this.references = instance.allReferences();
220
- }
221
- shouldKeep(node) {
222
- var _a;
223
- const addressSpace = node.addressSpace;
224
- const alreadyIn = this.references.filter((r) => {
225
- const n = addressSpace.findNode(r.nodeId);
226
- // istanbul ignore next
227
- if (!n) {
228
- warningLog(" cannot find node ", r.nodeId.toString());
229
- return false;
230
- }
231
- return n.browseName.name.toString() === node.browseName.name.toString();
232
- });
233
- if (alreadyIn.length > 0) {
234
- (0, node_opcua_assert_1.assert)(alreadyIn.length === 1, "Duplication found ?");
235
- // a child with the same browse name has already been install
236
- // probably from a SuperClass, we should ignore this.
237
- return false; // ignore
238
- }
239
- const modellingRule = node.modellingRule;
240
- switch (modellingRule) {
241
- case null:
242
- case undefined:
243
- debugLog("node ", node.browseName.toString(), node.nodeId.toString(), " has no modellingRule ", (_a = node.parentNodeId) === null || _a === void 0 ? void 0 : _a.toString());
244
- /**
245
- * in some badly generated NodeSet2.xml file, the modellingRule is not specified
246
- *
247
- * but in some other NodeSet2.xml, this means that the data are only attached to the Type node and shall not be
248
- * instantiate in the corresponding instance (example is the state variable of a finite state machine that are only
249
- * defined in the Type node)
250
- *
251
- * we should not consider it as an error, and treat it as not present
252
- */
253
- return false;
254
- case "Mandatory":
255
- return true; // keep;
256
- case "Optional":
257
- // only if in requested optionals
258
- return node.browseName.name in this.optionalsMap;
259
- case "OptionalPlaceholder":
260
- return false; // ignored
261
- default:
262
- return false; // ignored
263
- }
264
- }
265
- filterFor(childInstance) {
266
- const browseName = childInstance.browseName.name;
267
- let map = {};
268
- if (browseName in this.optionalsMap) {
269
- map = this.optionalsMap[browseName];
270
- }
271
- const newFilter = new MandatoryChildOrRequestedOptionalFilter(childInstance, map);
272
- return newFilter;
273
- }
274
- }
275
- /*
276
- * @function _get_parent_as_VariableOrObjectType
277
- * @param originalObject
278
- * @return {null|BaseNode}
279
- * @private
280
- */
281
- function _get_parent_as_VariableOrObjectType(originalObject) {
282
- if (originalObject.nodeClass === node_opcua_data_model_1.NodeClass.Method) {
283
- return null;
284
- }
285
- const addressSpace = originalObject.addressSpace;
286
- const parents = originalObject.findReferencesEx("HasChild", node_opcua_data_model_1.BrowseDirection.Inverse);
287
- // istanbul ignore next
288
- if (parents.length > 1) {
289
- warningLog(" object ", originalObject.browseName.toString(), " has more than one parent !");
290
- warningLog(originalObject.toString());
291
- warningLog(" parents : ");
292
- for (const parent of parents) {
293
- warningLog(" ", parent.toString(), addressSpace.findNode(parent.nodeId).browseName.toString());
294
- }
295
- return null;
296
- }
297
- (0, node_opcua_assert_1.assert)(parents.length === 0 || parents.length === 1);
298
- if (parents.length === 0) {
299
- return null;
300
- }
301
- const theParent = addressSpace.findNode(parents[0].nodeId);
302
- if (theParent && (theParent.nodeClass === node_opcua_data_model_1.NodeClass.VariableType || theParent.nodeClass === node_opcua_data_model_1.NodeClass.ObjectType)) {
303
- return theParent;
304
- }
305
- return null;
306
- }
307
- class CloneHelper {
308
- constructor() {
309
- this.level = 0;
310
- this.mapOrgToClone = new Map();
311
- }
312
- pad() {
313
- return " ".padEnd(this.level * 2, " ");
314
- }
315
- registerClonedObject(objInType, clonedObj) {
316
- this.mapOrgToClone.set(objInType.nodeId.toString(), {
317
- cloned: clonedObj,
318
- original: objInType
319
- });
320
- //
321
- // /-----------------------------\
322
- // | AcknowledgeableConditionType |
323
- // \-----------------------------/
324
- // ^ |
325
- // | +---------------------|- (EnabledState) (shadow element)
326
- // |
327
- // /-----------------------------\
328
- // | AlarmConditionType |
329
- // \-----------------------------/
330
- // |
331
- // +-------------------------------|- EnabledState <
332
- //
333
- // find also child object with the same browse name that are
334
- // overridden in the SuperType
335
- //
336
- const origParent = _get_parent_as_VariableOrObjectType(objInType);
337
- if (origParent) {
338
- let base = origParent.subtypeOfObj;
339
- while (base) {
340
- const shadowChild = base.getChildByName(objInType.browseName);
341
- if (shadowChild) {
342
- this.mapOrgToClone.set(shadowChild.nodeId.toString(), {
343
- cloned: clonedObj,
344
- original: shadowChild
345
- });
346
- }
347
- base = base.subtypeOfObj;
348
- }
349
- }
350
- // find subTypeOf
351
- }
352
- }
353
- // install properties and components on a instantiated Object
354
- //
355
- // based on their ModelingRule
356
- // => Mandatory => Installed
357
- // => Optional => Not Installed , unless it appear in optionals array
358
- // => OptionalPlaceHolder => Not Installed
359
- // => null (no modelling rule ) => Not Installed
360
- //
361
- function _initialize_properties_and_components(instance, topMostType, typeDefinitionNode, copyAlsoModellingRules, optionalsMap, extraInfo) {
362
- if (doDebug) {
363
- debugLog("instance browseName =", instance.browseName.toString());
364
- debugLog("typeNode =", typeDefinitionNode.browseName.toString());
365
- debugLog("optionalsMap =", Object.keys(optionalsMap).join(" "));
366
- const c = typeDefinitionNode.findReferencesEx("Aggregates");
367
- debugLog("typeDefinition aggregates =", c.map((x) => x.node.browseName.toString()).join(" "));
368
- }
369
- optionalsMap = optionalsMap || {};
370
- if ((0, node_opcua_nodeid_1.sameNodeId)(topMostType.nodeId, typeDefinitionNode.nodeId)) {
371
- return; // nothing to do
372
- }
373
- const filter = new MandatoryChildOrRequestedOptionalFilter(instance, optionalsMap);
374
- doTrace &&
375
- traceLog(chalk.cyan(extraInfo.pad(), "cloning relevant member of typeDefinition class"), typeDefinitionNode.browseName.toString());
376
- const browseNameMap = new Set();
377
- (0, base_node_private_1._clone_children_references)(typeDefinitionNode, instance, copyAlsoModellingRules, filter, extraInfo, browseNameMap);
378
- // now apply recursion on baseTypeDefinition to get properties and components from base class
379
- const baseTypeDefinitionNodeId = typeDefinitionNode.subtypeOf;
380
- const baseTypeDefinition = typeDefinitionNode.subtypeOfObj;
381
- doTrace &&
382
- traceLog(chalk.cyan(extraInfo.pad(), "now apply recursion on baseTypeDefinition to get properties and components from base class"), baseTypeDefinition.browseName.toString());
383
- // istanbul ignore next
384
- if (!baseTypeDefinition) {
385
- throw new Error(chalk.red("Cannot find object with nodeId ") + baseTypeDefinitionNodeId);
386
- }
387
- extraInfo.level++;
388
- _initialize_properties_and_components(instance, topMostType, baseTypeDefinition, copyAlsoModellingRules, optionalsMap, extraInfo);
389
- extraInfo.level--;
390
- }
391
- /**
392
- * @method hasChildWithBrowseName
393
- * returns true if the parent object has a child with the provided browseName
394
- * @param parent
395
- * @param childBrowseName
396
- */
397
- function hasChildWithBrowseName(parent, childBrowseName) {
398
- if (!parent) {
399
- throw Error("Internal error");
400
- }
401
- // extract children
402
- const children = parent.findReferencesAsObject("HasChild", true);
403
- return (children.filter((child) => {
404
- var _a, _b;
405
- return ((_a = child.browseName.name) === null || _a === void 0 ? void 0 : _a.toString()) === ((_b = childBrowseName.name) === null || _b === void 0 ? void 0 : _b.toString());
406
- }).length > 0);
407
- }
408
- function getParent(addressSpace, options) {
409
- const parent = options.componentOf || options.organizedBy;
410
- if (parent instanceof node_opcua_nodeid_1.NodeId) {
411
- return addressSpace.findNode(parent);
412
- }
413
- return parent;
414
- }
415
- function assertUnusedChildBrowseName(addressSpace, options) {
416
- const resolveOptionalObject = (node) => node ? addressSpace._coerceNode(node) || undefined : undefined;
417
- options.componentOf = resolveOptionalObject(options.componentOf);
418
- options.organizedBy = resolveOptionalObject(options.organizedBy);
419
- (0, node_opcua_assert_1.assert)(!(options.componentOf && options.organizedBy));
420
- const parent = getParent(addressSpace, options);
421
- if (!parent) {
422
- return;
423
- }
424
- (0, node_opcua_assert_1.assert)(parent !== null && typeof parent === "object");
425
- if (!(parent instanceof base_node_impl_1.BaseNodeImpl)) {
426
- throw new Error("Invalid parent parent is " + parent.constructor.name);
427
- }
428
- // istanbul ignore next
429
- // verify that no components already exists in parent
430
- if (parent && hasChildWithBrowseName(parent, (0, node_opcua_data_model_1.coerceQualifiedName)(options.browseName))) {
431
- throw new Error("object " +
432
- parent.browseName.name.toString() +
433
- " have already a child with browseName " +
434
- options.browseName.toString());
435
- }
436
- }
437
- exports.assertUnusedChildBrowseName = assertUnusedChildBrowseName;
438
- exports.assertUnusedChildBrowseName = assertUnusedChildBrowseName;
439
- exports.initialize_properties_and_components = initialize_properties_and_components;
440
- const hasTypeDefinitionNodeId = (0, node_opcua_nodeid_1.makeNodeId)(node_opcua_constants_1.ReferenceTypeIds.HasTypeDefinition);
441
- const hasModellingRuleNodeId = (0, node_opcua_nodeid_1.makeNodeId)(node_opcua_constants_1.ReferenceTypeIds.HasModellingRule);
442
- /**
443
- * remove unwanted reference such as HasTypeDefinition and HasModellingRule
444
- * from the list
445
- */
446
- function _remove_unwanted_ref(references) {
447
- // filter out HasTypeDefinition (i=40) , HasModellingRule (i=37);
448
- references = references.filter((reference) => !(0, node_opcua_nodeid_1.sameNodeId)(reference.referenceType, hasTypeDefinitionNodeId) &&
449
- !(0, node_opcua_nodeid_1.sameNodeId)(reference.referenceType, hasModellingRuleNodeId));
450
- return references;
451
- }
452
- /**
453
- *
454
- */
455
- function findNonHierarchicalReferences(originalObject) {
456
- // todo: MEMOIZE this method
457
- const addressSpace = originalObject.addressSpace;
458
- const referenceId = addressSpace.findReferenceType("NonHierarchicalReferences");
459
- if (!referenceId) {
460
- return [];
461
- }
462
- (0, node_opcua_assert_1.assert)(referenceId);
463
- // we need to explore the non hierarchical references backwards
464
- let references = originalObject.findReferencesEx("NonHierarchicalReferences", node_opcua_data_model_1.BrowseDirection.Inverse);
465
- references = [].concat(references, originalObject.findReferencesEx("HasEventSource", node_opcua_data_model_1.BrowseDirection.Inverse));
466
- const parent = _get_parent_as_VariableOrObjectType(originalObject);
467
- if (parent && parent.subtypeOfObj) {
468
- // parent is a ObjectType or VariableType and is not a root type
469
- (0, node_opcua_assert_1.assert)(parent.nodeClass === node_opcua_data_model_1.NodeClass.VariableType || parent.nodeClass === node_opcua_data_model_1.NodeClass.ObjectType);
470
- // let investigate the same child base child
471
- const child = parent.subtypeOfObj.getChildByName(originalObject.browseName);
472
- if (child) {
473
- const baseRef = findNonHierarchicalReferences(child);
474
- references = [].concat(references, baseRef);
475
- }
476
- }
477
- // perform some cleanup
478
- references = _remove_unwanted_ref(references);
479
- return references;
480
- }
481
- function reconstructNonHierarchicalReferences(extraInfo) {
482
- const findImplementedObject = (ref) => extraInfo.mapOrgToClone.get(ref.nodeId.toString()) || null;
483
- // navigate through original objects to find those that are being references by node that
484
- // have been cloned .
485
- // this could be node organized by some FunctionalGroup
486
- //
487
- for (const { original, cloned } of extraInfo.mapOrgToClone.values()) {
488
- // find NonHierarchical References on original object
489
- const originalNonHierarchical = findNonHierarchicalReferences(original);
490
- if (originalNonHierarchical.length === 0) {
491
- continue;
492
- }
493
- // istanbul ignore next
494
- if (doDebug) {
495
- debugLog(" investigation ", original.browseName.toString(), cloned.nodeClass.toString(), original.nodeClass.toString(), original.nodeId.toString(), cloned.nodeId.toString());
496
- }
497
- for (const ref of originalNonHierarchical) {
498
- const info = findImplementedObject(ref);
499
- // if the object pointed by this reference is also cloned ...
500
- if (info) {
501
- const originalDest = info.original;
502
- const cloneDest = info.cloned;
503
- // istanbul ignore next
504
- if (doDebug) {
505
- debugLog(chalk.cyan(" adding reference "), ref.referenceType, " from cloned ", cloned.nodeId.toString(), cloned.browseName.toString(), " to cloned ", cloneDest.nodeId.toString(), cloneDest.browseName.toString());
506
- }
507
- // restore reference
508
- cloned.addReference({
509
- isForward: false,
510
- nodeId: cloneDest.nodeId,
511
- referenceType: ref.referenceType
512
- });
513
- }
514
- }
515
- }
516
- }
517
- /**
518
- * recreate functional group types according to type definition
519
- *
520
- * @method reconstructFunctionalGroupType
521
- * @param baseType
522
- */
523
- /* @example:
524
- *
525
- * MyDeviceType
526
- * |
527
- * +----------|- ParameterSet(BaseObjectType)
528
- * | |
529
- * | +-----------------|- Parameter1
530
- * | ^
531
- * +----------|- Config(FunctionalGroupType) |
532
- * | |
533
- * +-------- Organizes---+
534
- */
535
- function reconstructFunctionalGroupType(extraInfo) {
536
- // navigate through original objects to find those that are being organized by some FunctionalGroup
537
- for (const { original, cloned } of extraInfo.mapOrgToClone.values()) {
538
- const organizedByArray = original.findReferencesEx("Organizes", node_opcua_data_model_1.BrowseDirection.Inverse);
539
- for (const ref of organizedByArray) {
540
- const info = extraInfo.mapOrgToClone.get(ref.nodeId.toString());
541
- if (!info)
542
- continue;
543
- const folder = info.original;
544
- (0, node_opcua_assert_1.assert)(folder.typeDefinitionObj.browseName.name.toString() === "FunctionalGroupType");
545
- // now create the same reference with the instantiated function group
546
- const destFolder = info.cloned;
547
- (0, node_opcua_assert_1.assert)(ref.referenceType);
548
- destFolder.addReference({
549
- isForward: !ref.isForward,
550
- nodeId: cloned.nodeId,
551
- referenceType: ref.referenceType
552
- });
553
- }
554
- }
555
- }
556
- function initialize_properties_and_components(instance, topMostType, nodeType, copyAlsoModellingRules, optionals) {
557
- const extraInfo = new CloneHelper();
558
- extraInfo.registerClonedObject(nodeType, instance);
559
- const optionalsMap = (0, make_optionals_map_1.makeOptionalsMap)(optionals);
560
- _initialize_properties_and_components(instance, topMostType, nodeType, copyAlsoModellingRules, optionalsMap, extraInfo);
561
- reconstructFunctionalGroupType(extraInfo);
562
- reconstructNonHierarchicalReferences(extraInfo);
563
- }
564
- exports.initialize_properties_and_components = initialize_properties_and_components;
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.initialize_properties_and_components = exports.assertUnusedChildBrowseName = exports.UAVariableTypeImpl = exports.topMostParentIsObjectTypeOrVariableType = void 0;
4
+ /**
5
+ * @module node-opcua-address-space
6
+ */
7
+ // tslint:disable:max-classes-per-file
8
+ // tslint:disable:no-console
9
+ const chalk = require("chalk");
10
+ const node_opcua_assert_1 = require("node-opcua-assert");
11
+ const node_opcua_constants_1 = require("node-opcua-constants");
12
+ const node_opcua_data_model_1 = require("node-opcua-data-model");
13
+ const node_opcua_data_value_1 = require("node-opcua-data-value");
14
+ const node_opcua_debug_1 = require("node-opcua-debug");
15
+ const node_opcua_nodeid_1 = require("node-opcua-nodeid");
16
+ const node_opcua_status_code_1 = require("node-opcua-status-code");
17
+ const node_opcua_utils_1 = require("node-opcua-utils");
18
+ const node_opcua_variant_1 = require("node-opcua-variant");
19
+ const session_context_1 = require("../source/session_context");
20
+ const make_optionals_map_1 = require("../source/helpers/make_optionals_map");
21
+ const base_node_impl_1 = require("./base_node_impl");
22
+ const base_node_private_1 = require("./base_node_private");
23
+ const tools = require("./tool_isSupertypeOf");
24
+ const tool_isSupertypeOf_1 = require("./tool_isSupertypeOf");
25
+ const tool_isSupertypeOf_2 = require("./tool_isSupertypeOf");
26
+ const debugLog = (0, node_opcua_debug_1.make_debugLog)(__filename);
27
+ const doDebug = (0, node_opcua_debug_1.checkDebugFlag)(__filename);
28
+ const warningLog = (0, node_opcua_debug_1.make_warningLog)(__filename);
29
+ const errorLog = (0, node_opcua_debug_1.make_errorLog)(__filename);
30
+ // eslint-disable-next-line prefer-const
31
+ let doTrace = (0, node_opcua_debug_1.checkDebugFlag)("INSTANTIATE");
32
+ const traceLog = errorLog;
33
+ function topMostParentIsObjectTypeOrVariableType(addressSpace, options) {
34
+ var _a;
35
+ if (options.modellingRule) {
36
+ return true;
37
+ }
38
+ const parent = options.propertyOf || options.componentOf;
39
+ if (!parent) {
40
+ return false;
41
+ }
42
+ const parentNode = addressSpace._coerceNode(parent);
43
+ if (!parentNode) {
44
+ return false;
45
+ }
46
+ let currentNode = parentNode;
47
+ while (currentNode) {
48
+ const nodeClass = parentNode.nodeClass;
49
+ if (nodeClass === node_opcua_data_model_1.NodeClass.ObjectType || nodeClass === node_opcua_data_model_1.NodeClass.VariableType) {
50
+ return true;
51
+ }
52
+ if (nodeClass === node_opcua_data_model_1.NodeClass.Object || nodeClass === node_opcua_data_model_1.NodeClass.Variable || nodeClass === node_opcua_data_model_1.NodeClass.Method) {
53
+ /** */
54
+ }
55
+ currentNode = (_a = currentNode.findReferencesEx("HasChild", node_opcua_data_model_1.BrowseDirection.Inverse)[0]) === null || _a === void 0 ? void 0 : _a.node;
56
+ }
57
+ return false;
58
+ }
59
+ exports.topMostParentIsObjectTypeOrVariableType = topMostParentIsObjectTypeOrVariableType;
60
+ class UAVariableTypeImpl extends base_node_impl_1.BaseNodeImpl {
61
+ constructor(options) {
62
+ super(options);
63
+ this.nodeClass = node_opcua_data_model_1.NodeClass.VariableType;
64
+ this.isSupertypeOf = tools.construct_isSupertypeOf(UAVariableTypeImpl);
65
+ (0, node_opcua_variant_1.verifyRankAndDimensions)(options);
66
+ this.valueRank = options.valueRank || -1;
67
+ this.arrayDimensions = options.arrayDimensions || null;
68
+ this.minimumSamplingInterval = 0;
69
+ this.historizing = (0, node_opcua_utils_1.isNullOrUndefined)(options.historizing) ? false : options.historizing;
70
+ this.isAbstract = (0, node_opcua_utils_1.isNullOrUndefined)(options.isAbstract) ? false : options.isAbstract;
71
+ this.value = options.value; // optional default value for instances of this UAVariableType
72
+ this.dataType = (0, node_opcua_nodeid_1.coerceNodeId)(options.dataType); // DataType (NodeId)
73
+ if (options.value) {
74
+ this.value = new node_opcua_variant_1.Variant(options.value);
75
+ }
76
+ }
77
+ get subtypeOf() {
78
+ return tool_isSupertypeOf_2.get_subtypeOf.call(this);
79
+ }
80
+ get subtypeOfObj() {
81
+ return tool_isSupertypeOf_1.get_subtypeOfObj.call(this);
82
+ }
83
+ readAttribute(context, attributeId) {
84
+ (0, node_opcua_assert_1.assert)(!context || context instanceof session_context_1.SessionContext);
85
+ const options = {};
86
+ switch (attributeId) {
87
+ case node_opcua_data_model_1.AttributeIds.IsAbstract:
88
+ options.value = { dataType: node_opcua_variant_1.DataType.Boolean, value: this.isAbstract ? true : false };
89
+ options.statusCode = node_opcua_status_code_1.StatusCodes.Good;
90
+ break;
91
+ case node_opcua_data_model_1.AttributeIds.Value:
92
+ if (Object.prototype.hasOwnProperty.call(this, "value") && this.value !== undefined) {
93
+ (0, node_opcua_assert_1.assert)(this.value.schema.name === "Variant");
94
+ options.value = this.value;
95
+ options.statusCode = node_opcua_status_code_1.StatusCodes.Good;
96
+ }
97
+ else {
98
+ debugLog(" warning Value not implemented");
99
+ options.value = { dataType: node_opcua_variant_1.DataType.Null };
100
+ options.statusCode = node_opcua_status_code_1.StatusCodes.BadAttributeIdInvalid;
101
+ }
102
+ break;
103
+ case node_opcua_data_model_1.AttributeIds.DataType:
104
+ (0, node_opcua_assert_1.assert)(this.dataType instanceof node_opcua_nodeid_1.NodeId);
105
+ options.value = { dataType: node_opcua_variant_1.DataType.NodeId, value: this.dataType };
106
+ options.statusCode = node_opcua_status_code_1.StatusCodes.Good;
107
+ break;
108
+ case node_opcua_data_model_1.AttributeIds.ValueRank:
109
+ options.value = { dataType: node_opcua_variant_1.DataType.Int32, value: this.valueRank };
110
+ options.statusCode = node_opcua_status_code_1.StatusCodes.Good;
111
+ break;
112
+ case node_opcua_data_model_1.AttributeIds.ArrayDimensions:
113
+ (0, node_opcua_assert_1.assert)(Array.isArray(this.arrayDimensions) || this.arrayDimensions === null);
114
+ options.value = {
115
+ arrayType: node_opcua_variant_1.VariantArrayType.Array,
116
+ dataType: node_opcua_variant_1.DataType.UInt32,
117
+ value: this.arrayDimensions
118
+ };
119
+ options.statusCode = node_opcua_status_code_1.StatusCodes.Good;
120
+ break;
121
+ default:
122
+ return super.readAttribute(context, attributeId);
123
+ }
124
+ return new node_opcua_data_value_1.DataValue(options);
125
+ }
126
+ toString() {
127
+ const options = new base_node_private_1.ToStringBuilder();
128
+ base_node_private_1.UAVariableType_toString.call(this, options);
129
+ return options.toString();
130
+ }
131
+ /**
132
+ * instantiate an object of this UAVariableType
133
+ * The instantiation takes care of object type inheritance when constructing inner properties
134
+
135
+ * Note : HasComponent usage scope
136
+ *
137
+ * ```text
138
+ * Source | Destination
139
+ * -------------------+---------------------------
140
+ * Object | Object, Variable,Method
141
+ * ObjectType |
142
+ * -------------------+---------------------------
143
+ * DataVariable | Variable
144
+ * DataVariableType |
145
+ * ```
146
+ *
147
+ * see : OPCUA 1.03 page 44 $6.4 Instances of ObjectTypes and VariableTypes
148
+ */
149
+ instantiate(options) {
150
+ const addressSpace = this.addressSpace;
151
+ // xx assert(!this.isAbstract, "cannot instantiate abstract UAVariableType");
152
+ (0, node_opcua_assert_1.assert)(options, "missing option object");
153
+ (0, node_opcua_assert_1.assert)(typeof options.browseName === "string" || (options.browseName !== null && typeof options.browseName === "object"), "expecting a browse name");
154
+ (0, node_opcua_assert_1.assert)(!Object.prototype.hasOwnProperty.call(options, "propertyOf"), "Use addressSpace#addVariable({ propertyOf: xxx}); to add a property");
155
+ assertUnusedChildBrowseName(addressSpace, options);
156
+ const baseVariableType = addressSpace.findVariableType("BaseVariableType");
157
+ (0, node_opcua_assert_1.assert)(baseVariableType, "BaseVariableType must be defined in the address space");
158
+ let dataType = options.dataType !== undefined ? options.dataType : this.dataType;
159
+ // may be required (i.e YArrayItemType )
160
+ dataType = this.resolveNodeId(dataType); // DataType (NodeId)
161
+ (0, node_opcua_assert_1.assert)(dataType instanceof node_opcua_nodeid_1.NodeId);
162
+ const valueRank = options.valueRank !== undefined ? options.valueRank : this.valueRank;
163
+ const arrayDimensions = options.arrayDimensions !== undefined ? options.arrayDimensions : this.arrayDimensions;
164
+ // istanbul ignore next
165
+ if (!dataType || dataType.isEmpty()) {
166
+ warningLog(" options.dataType", options.dataType ? options.dataType.toString() : "<null>");
167
+ warningLog(" this.dataType", this.dataType ? this.dataType.toString() : "<null>");
168
+ throw new Error(" A valid dataType must be specified");
169
+ }
170
+ const copyAlsoModellingRules = topMostParentIsObjectTypeOrVariableType(addressSpace, options);
171
+ const defaultDataType = this.dataType;
172
+ // BadAttributeIdInvalid
173
+ const defaultDataValue = this.readAttribute(null, node_opcua_data_model_1.AttributeIds.Value);
174
+ const defaultValue = (defaultDataType.namespace === 0 && defaultDataType.value == 0) || defaultDataValue.statusCode !== node_opcua_status_code_1.StatusCodes.Good
175
+ ? undefined
176
+ : defaultDataValue.value;
177
+ const opts = {
178
+ arrayDimensions,
179
+ browseName: options.browseName,
180
+ componentOf: options.componentOf,
181
+ dataType,
182
+ description: options.description || this.description,
183
+ displayName: options.displayName || "",
184
+ eventSourceOf: options.eventSourceOf,
185
+ minimumSamplingInterval: options.minimumSamplingInterval,
186
+ modellingRule: options.modellingRule,
187
+ nodeId: options.nodeId,
188
+ notifierOf: options.notifierOf,
189
+ organizedBy: options.organizedBy,
190
+ typeDefinition: this.nodeId,
191
+ value: options.value || defaultValue,
192
+ valueRank
193
+ };
194
+ const namespace = options.namespace || addressSpace.getOwnNamespace();
195
+ const instance = namespace.addVariable(opts);
196
+ // xx assert(instance.minimumSamplingInterval === options.minimumSamplingInterval);
197
+ initialize_properties_and_components(instance, baseVariableType, this, copyAlsoModellingRules, options.optionals);
198
+ // if VariableType is a type of Structure DataType
199
+ // we need to instantiate a dataValue
200
+ // and create a bidirectional binding with the individual properties of this type
201
+ instance.bindExtensionObject(options.extensionObject);
202
+ (0, node_opcua_assert_1.assert)(instance.typeDefinition.toString() === this.nodeId.toString());
203
+ instance.install_extra_properties();
204
+ if (this._postInstantiateFunc) {
205
+ this._postInstantiateFunc(instance, this);
206
+ }
207
+ return instance;
208
+ }
209
+ }
210
+ exports.UAVariableTypeImpl = UAVariableTypeImpl;
211
+ /**
212
+ * return true if node is a mandatory child or a requested optional
213
+ * @method MandatoryChildOrRequestedOptionalFilter
214
+ * @param instance
215
+ * @param optionalsMap
216
+ * @return {Boolean}
217
+ */
218
+ class MandatoryChildOrRequestedOptionalFilter {
219
+ constructor(instance, optionalsMap) {
220
+ // should we clone the node to be a component or propertyOf of a instance
221
+ (0, node_opcua_assert_1.assert)(optionalsMap !== null && typeof optionalsMap === "object");
222
+ (0, node_opcua_assert_1.assert)(null !== instance);
223
+ this.optionalsMap = optionalsMap;
224
+ this.instance = instance;
225
+ this.references = instance.allReferences();
226
+ }
227
+ shouldKeep(node) {
228
+ var _a;
229
+ const addressSpace = node.addressSpace;
230
+ const alreadyIn = this.references.filter((r) => {
231
+ const n = addressSpace.findNode(r.nodeId);
232
+ // istanbul ignore next
233
+ if (!n) {
234
+ warningLog(" cannot find node ", r.nodeId.toString());
235
+ return false;
236
+ }
237
+ return n.browseName.name.toString() === node.browseName.name.toString();
238
+ });
239
+ if (alreadyIn.length > 0) {
240
+ (0, node_opcua_assert_1.assert)(alreadyIn.length === 1, "Duplication found ?");
241
+ // a child with the same browse name has already been install
242
+ // probably from a SuperClass, we should ignore this.
243
+ return false; // ignore
244
+ }
245
+ const modellingRule = node.modellingRule;
246
+ switch (modellingRule) {
247
+ case null:
248
+ case undefined:
249
+ debugLog("node ", node.browseName.toString(), node.nodeId.toString(), " has no modellingRule ", (_a = node.parentNodeId) === null || _a === void 0 ? void 0 : _a.toString());
250
+ /**
251
+ * in some badly generated NodeSet2.xml file, the modellingRule is not specified
252
+ *
253
+ * but in some other NodeSet2.xml, this means that the data are only attached to the Type node and shall not be
254
+ * instantiate in the corresponding instance (example is the state variable of a finite state machine that are only
255
+ * defined in the Type node)
256
+ *
257
+ * we should not consider it as an error, and treat it as not present
258
+ */
259
+ return false;
260
+ case "Mandatory":
261
+ return true; // keep;
262
+ case "Optional":
263
+ // only if in requested optionals
264
+ return node.browseName.name in this.optionalsMap;
265
+ case "OptionalPlaceholder":
266
+ return false; // ignored
267
+ default:
268
+ return false; // ignored
269
+ }
270
+ }
271
+ filterFor(childInstance) {
272
+ const browseName = childInstance.browseName.name;
273
+ let map = {};
274
+ if (browseName in this.optionalsMap) {
275
+ map = this.optionalsMap[browseName];
276
+ }
277
+ const newFilter = new MandatoryChildOrRequestedOptionalFilter(childInstance, map);
278
+ return newFilter;
279
+ }
280
+ }
281
+ /*
282
+ * @function _get_parent_as_VariableOrObjectType
283
+ * @param originalObject
284
+ * @return {null|BaseNode}
285
+ * @private
286
+ */
287
+ function _get_parent_as_VariableOrObjectType(originalObject) {
288
+ if (originalObject.nodeClass === node_opcua_data_model_1.NodeClass.Method) {
289
+ return null;
290
+ }
291
+ const addressSpace = originalObject.addressSpace;
292
+ const parents = originalObject.findReferencesEx("HasChild", node_opcua_data_model_1.BrowseDirection.Inverse);
293
+ // istanbul ignore next
294
+ if (parents.length > 1) {
295
+ warningLog(" object ", originalObject.browseName.toString(), " has more than one parent !");
296
+ warningLog(originalObject.toString());
297
+ warningLog(" parents : ");
298
+ for (const parent of parents) {
299
+ warningLog(" ", parent.toString(), addressSpace.findNode(parent.nodeId).browseName.toString());
300
+ }
301
+ return null;
302
+ }
303
+ (0, node_opcua_assert_1.assert)(parents.length === 0 || parents.length === 1);
304
+ if (parents.length === 0) {
305
+ return null;
306
+ }
307
+ const theParent = addressSpace.findNode(parents[0].nodeId);
308
+ if (theParent && (theParent.nodeClass === node_opcua_data_model_1.NodeClass.VariableType || theParent.nodeClass === node_opcua_data_model_1.NodeClass.ObjectType)) {
309
+ return theParent;
310
+ }
311
+ return null;
312
+ }
313
+ class CloneHelper {
314
+ constructor() {
315
+ this.level = 0;
316
+ this.mapOrgToClone = new Map();
317
+ }
318
+ pad() {
319
+ return " ".padEnd(this.level * 2, " ");
320
+ }
321
+ registerClonedObject(objInType, clonedObj) {
322
+ this.mapOrgToClone.set(objInType.nodeId.toString(), {
323
+ cloned: clonedObj,
324
+ original: objInType
325
+ });
326
+ //
327
+ // /-----------------------------\
328
+ // | AcknowledgeableConditionType |
329
+ // \-----------------------------/
330
+ // ^ |
331
+ // | +---------------------|- (EnabledState) (shadow element)
332
+ // |
333
+ // /-----------------------------\
334
+ // | AlarmConditionType |
335
+ // \-----------------------------/
336
+ // |
337
+ // +-------------------------------|- EnabledState <
338
+ //
339
+ // find also child object with the same browse name that are
340
+ // overridden in the SuperType
341
+ //
342
+ const origParent = _get_parent_as_VariableOrObjectType(objInType);
343
+ if (origParent) {
344
+ let base = origParent.subtypeOfObj;
345
+ while (base) {
346
+ const shadowChild = base.getChildByName(objInType.browseName);
347
+ if (shadowChild) {
348
+ this.mapOrgToClone.set(shadowChild.nodeId.toString(), {
349
+ cloned: clonedObj,
350
+ original: shadowChild
351
+ });
352
+ }
353
+ base = base.subtypeOfObj;
354
+ }
355
+ }
356
+ // find subTypeOf
357
+ }
358
+ }
359
+ // install properties and components on a instantiated Object
360
+ //
361
+ // based on their ModelingRule
362
+ // => Mandatory => Installed
363
+ // => Optional => Not Installed , unless it appear in optionals array
364
+ // => OptionalPlaceHolder => Not Installed
365
+ // => null (no modelling rule ) => Not Installed
366
+ //
367
+ function _initialize_properties_and_components(instance, topMostType, typeDefinitionNode, copyAlsoModellingRules, optionalsMap, extraInfo) {
368
+ if (doDebug) {
369
+ debugLog("instance browseName =", instance.browseName.toString());
370
+ debugLog("typeNode =", typeDefinitionNode.browseName.toString());
371
+ debugLog("optionalsMap =", Object.keys(optionalsMap).join(" "));
372
+ const c = typeDefinitionNode.findReferencesEx("Aggregates");
373
+ debugLog("typeDefinition aggregates =", c.map((x) => x.node.browseName.toString()).join(" "));
374
+ }
375
+ optionalsMap = optionalsMap || {};
376
+ if ((0, node_opcua_nodeid_1.sameNodeId)(topMostType.nodeId, typeDefinitionNode.nodeId)) {
377
+ return; // nothing to do
378
+ }
379
+ const filter = new MandatoryChildOrRequestedOptionalFilter(instance, optionalsMap);
380
+ doTrace &&
381
+ traceLog(chalk.cyan(extraInfo.pad(), "cloning relevant member of typeDefinition class"), typeDefinitionNode.browseName.toString());
382
+ const browseNameMap = new Set();
383
+ (0, base_node_private_1._clone_children_references)(typeDefinitionNode, instance, copyAlsoModellingRules, filter, extraInfo, browseNameMap);
384
+ // now apply recursion on baseTypeDefinition to get properties and components from base class
385
+ const baseTypeDefinitionNodeId = typeDefinitionNode.subtypeOf;
386
+ const baseTypeDefinition = typeDefinitionNode.subtypeOfObj;
387
+ doTrace &&
388
+ traceLog(chalk.cyan(extraInfo.pad(), "now apply recursion on baseTypeDefinition to get properties and components from base class"), baseTypeDefinition.browseName.toString());
389
+ // istanbul ignore next
390
+ if (!baseTypeDefinition) {
391
+ throw new Error(chalk.red("Cannot find object with nodeId ") + baseTypeDefinitionNodeId);
392
+ }
393
+ extraInfo.level++;
394
+ _initialize_properties_and_components(instance, topMostType, baseTypeDefinition, copyAlsoModellingRules, optionalsMap, extraInfo);
395
+ extraInfo.level--;
396
+ }
397
+ /**
398
+ * @method hasChildWithBrowseName
399
+ * returns true if the parent object has a child with the provided browseName
400
+ * @param parent
401
+ * @param childBrowseName
402
+ */
403
+ function hasChildWithBrowseName(parent, childBrowseName) {
404
+ if (!parent) {
405
+ throw Error("Internal error");
406
+ }
407
+ // extract children
408
+ const children = parent.findReferencesAsObject("HasChild", true);
409
+ return (children.filter((child) => {
410
+ var _a, _b;
411
+ return ((_a = child.browseName.name) === null || _a === void 0 ? void 0 : _a.toString()) === ((_b = childBrowseName.name) === null || _b === void 0 ? void 0 : _b.toString());
412
+ }).length > 0);
413
+ }
414
+ function getParent(addressSpace, options) {
415
+ const parent = options.componentOf || options.organizedBy;
416
+ if (parent instanceof node_opcua_nodeid_1.NodeId) {
417
+ return addressSpace.findNode(parent);
418
+ }
419
+ return parent;
420
+ }
421
+ function assertUnusedChildBrowseName(addressSpace, options) {
422
+ const resolveOptionalObject = (node) => node ? addressSpace._coerceNode(node) || undefined : undefined;
423
+ options.componentOf = resolveOptionalObject(options.componentOf);
424
+ options.organizedBy = resolveOptionalObject(options.organizedBy);
425
+ (0, node_opcua_assert_1.assert)(!(options.componentOf && options.organizedBy));
426
+ const parent = getParent(addressSpace, options);
427
+ if (!parent) {
428
+ return;
429
+ }
430
+ (0, node_opcua_assert_1.assert)(parent !== null && typeof parent === "object");
431
+ if (!(parent instanceof base_node_impl_1.BaseNodeImpl)) {
432
+ throw new Error("Invalid parent parent is " + parent.constructor.name);
433
+ }
434
+ // istanbul ignore next
435
+ // verify that no components already exists in parent
436
+ if (parent && hasChildWithBrowseName(parent, (0, node_opcua_data_model_1.coerceQualifiedName)(options.browseName))) {
437
+ throw new Error("object " +
438
+ parent.browseName.name.toString() +
439
+ " have already a child with browseName " +
440
+ options.browseName.toString());
441
+ }
442
+ }
443
+ exports.assertUnusedChildBrowseName = assertUnusedChildBrowseName;
444
+ exports.assertUnusedChildBrowseName = assertUnusedChildBrowseName;
445
+ exports.initialize_properties_and_components = initialize_properties_and_components;
446
+ const hasTypeDefinitionNodeId = (0, node_opcua_nodeid_1.makeNodeId)(node_opcua_constants_1.ReferenceTypeIds.HasTypeDefinition);
447
+ const hasModellingRuleNodeId = (0, node_opcua_nodeid_1.makeNodeId)(node_opcua_constants_1.ReferenceTypeIds.HasModellingRule);
448
+ /**
449
+ * remove unwanted reference such as HasTypeDefinition and HasModellingRule
450
+ * from the list
451
+ */
452
+ function _remove_unwanted_ref(references) {
453
+ // filter out HasTypeDefinition (i=40) , HasModellingRule (i=37);
454
+ references = references.filter((reference) => !(0, node_opcua_nodeid_1.sameNodeId)(reference.referenceType, hasTypeDefinitionNodeId) &&
455
+ !(0, node_opcua_nodeid_1.sameNodeId)(reference.referenceType, hasModellingRuleNodeId));
456
+ return references;
457
+ }
458
+ /**
459
+ *
460
+ */
461
+ function findNonHierarchicalReferences(originalObject) {
462
+ // todo: MEMOIZE this method
463
+ const addressSpace = originalObject.addressSpace;
464
+ const referenceId = addressSpace.findReferenceType("NonHierarchicalReferences");
465
+ if (!referenceId) {
466
+ return [];
467
+ }
468
+ (0, node_opcua_assert_1.assert)(referenceId);
469
+ // we need to explore the non hierarchical references backwards
470
+ let references = originalObject.findReferencesEx("NonHierarchicalReferences", node_opcua_data_model_1.BrowseDirection.Inverse);
471
+ references = [].concat(references, originalObject.findReferencesEx("HasEventSource", node_opcua_data_model_1.BrowseDirection.Inverse));
472
+ const parent = _get_parent_as_VariableOrObjectType(originalObject);
473
+ if (parent && parent.subtypeOfObj) {
474
+ // parent is a ObjectType or VariableType and is not a root type
475
+ (0, node_opcua_assert_1.assert)(parent.nodeClass === node_opcua_data_model_1.NodeClass.VariableType || parent.nodeClass === node_opcua_data_model_1.NodeClass.ObjectType);
476
+ // let investigate the same child base child
477
+ const child = parent.subtypeOfObj.getChildByName(originalObject.browseName);
478
+ if (child) {
479
+ const baseRef = findNonHierarchicalReferences(child);
480
+ references = [].concat(references, baseRef);
481
+ }
482
+ }
483
+ // perform some cleanup
484
+ references = _remove_unwanted_ref(references);
485
+ return references;
486
+ }
487
+ function reconstructNonHierarchicalReferences(extraInfo) {
488
+ const findImplementedObject = (ref) => extraInfo.mapOrgToClone.get(ref.nodeId.toString()) || null;
489
+ // navigate through original objects to find those that are being references by node that
490
+ // have been cloned .
491
+ // this could be node organized by some FunctionalGroup
492
+ //
493
+ for (const { original, cloned } of extraInfo.mapOrgToClone.values()) {
494
+ // find NonHierarchical References on original object
495
+ const originalNonHierarchical = findNonHierarchicalReferences(original);
496
+ if (originalNonHierarchical.length === 0) {
497
+ continue;
498
+ }
499
+ // istanbul ignore next
500
+ if (doDebug) {
501
+ debugLog(" investigation ", original.browseName.toString(), cloned.nodeClass.toString(), original.nodeClass.toString(), original.nodeId.toString(), cloned.nodeId.toString());
502
+ }
503
+ for (const ref of originalNonHierarchical) {
504
+ const info = findImplementedObject(ref);
505
+ // if the object pointed by this reference is also cloned ...
506
+ if (info) {
507
+ const originalDest = info.original;
508
+ const cloneDest = info.cloned;
509
+ // istanbul ignore next
510
+ if (doDebug) {
511
+ debugLog(chalk.cyan(" adding reference "), ref.referenceType, " from cloned ", cloned.nodeId.toString(), cloned.browseName.toString(), " to cloned ", cloneDest.nodeId.toString(), cloneDest.browseName.toString());
512
+ }
513
+ // restore reference
514
+ cloned.addReference({
515
+ isForward: false,
516
+ nodeId: cloneDest.nodeId,
517
+ referenceType: ref.referenceType
518
+ });
519
+ }
520
+ }
521
+ }
522
+ }
523
+ /**
524
+ * recreate functional group types according to type definition
525
+ *
526
+ * @method reconstructFunctionalGroupType
527
+ * @param baseType
528
+ */
529
+ /* @example:
530
+ *
531
+ * MyDeviceType
532
+ * |
533
+ * +----------|- ParameterSet(BaseObjectType)
534
+ * | |
535
+ * | +-----------------|- Parameter1
536
+ * | ^
537
+ * +----------|- Config(FunctionalGroupType) |
538
+ * | |
539
+ * +-------- Organizes---+
540
+ */
541
+ function reconstructFunctionalGroupType(extraInfo) {
542
+ // navigate through original objects to find those that are being organized by some FunctionalGroup
543
+ for (const { original, cloned } of extraInfo.mapOrgToClone.values()) {
544
+ const organizedByArray = original.findReferencesEx("Organizes", node_opcua_data_model_1.BrowseDirection.Inverse);
545
+ for (const ref of organizedByArray) {
546
+ const info = extraInfo.mapOrgToClone.get(ref.nodeId.toString());
547
+ if (!info)
548
+ continue;
549
+ const folder = info.original;
550
+ (0, node_opcua_assert_1.assert)(folder.typeDefinitionObj.browseName.name.toString() === "FunctionalGroupType");
551
+ // now create the same reference with the instantiated function group
552
+ const destFolder = info.cloned;
553
+ (0, node_opcua_assert_1.assert)(ref.referenceType);
554
+ destFolder.addReference({
555
+ isForward: !ref.isForward,
556
+ nodeId: cloned.nodeId,
557
+ referenceType: ref.referenceType
558
+ });
559
+ }
560
+ }
561
+ }
562
+ function initialize_properties_and_components(instance, topMostType, nodeType, copyAlsoModellingRules, optionals) {
563
+ const extraInfo = new CloneHelper();
564
+ extraInfo.registerClonedObject(nodeType, instance);
565
+ const optionalsMap = (0, make_optionals_map_1.makeOptionalsMap)(optionals);
566
+ _initialize_properties_and_components(instance, topMostType, nodeType, copyAlsoModellingRules, optionalsMap, extraInfo);
567
+ reconstructFunctionalGroupType(extraInfo);
568
+ reconstructNonHierarchicalReferences(extraInfo);
569
+ }
570
+ exports.initialize_properties_and_components = initialize_properties_and_components;
565
571
  //# sourceMappingURL=ua_variable_type_impl.js.map