@kosdev-code/kos-ui-sdk 2.0.43 → 2.0.45

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 (445) hide show
  1. package/common/events/eventBus.d.ts +30 -0
  2. package/common/events/eventBus.d.ts.map +1 -1
  3. package/common/events/eventBus.functional.d.ts +48 -0
  4. package/common/events/eventBus.functional.d.ts.map +1 -1
  5. package/common/events/eventBus.state.d.ts +33 -0
  6. package/common/events/eventBus.state.d.ts.map +1 -1
  7. package/core/constants/model-constants.d.ts +9 -0
  8. package/core/constants/model-constants.d.ts.map +1 -0
  9. package/core/core/companion-instantiator.d.ts +71 -0
  10. package/core/core/companion-instantiator.d.ts.map +1 -0
  11. package/core/core/decorators/fsm-injection-utils.d.ts +16 -0
  12. package/core/core/decorators/fsm-injection-utils.d.ts.map +1 -0
  13. package/core/core/decorators/index.d.ts +11 -0
  14. package/core/core/decorators/index.d.ts.map +1 -1
  15. package/core/core/decorators/kos-child.d.ts +2 -0
  16. package/core/core/decorators/kos-child.d.ts.map +1 -1
  17. package/core/core/decorators/kos-companion.d.ts +158 -8
  18. package/core/core/decorators/kos-companion.d.ts.map +1 -1
  19. package/core/core/decorators/kos-container-aware.d.ts +619 -0
  20. package/core/core/decorators/kos-container-aware.d.ts.map +1 -0
  21. package/core/core/decorators/kos-context.d.ts +6 -0
  22. package/core/core/decorators/kos-context.d.ts.map +1 -1
  23. package/core/core/decorators/kos-execution-context.d.ts +63 -0
  24. package/core/core/decorators/kos-execution-context.d.ts.map +1 -0
  25. package/core/core/decorators/kos-future-aware.d.ts +162 -0
  26. package/core/core/decorators/kos-future-aware.d.ts.map +1 -0
  27. package/core/core/decorators/kos-http-decorators.d.ts +15 -0
  28. package/core/core/decorators/kos-http-decorators.d.ts.map +1 -1
  29. package/core/core/decorators/kos-log.d.ts +4 -0
  30. package/core/core/decorators/kos-log.d.ts.map +1 -1
  31. package/core/core/decorators/kos-logger-aware.d.ts +105 -0
  32. package/core/core/decorators/kos-logger-aware.d.ts.map +1 -0
  33. package/core/core/decorators/kos-model-effect.d.ts +9 -0
  34. package/core/core/decorators/kos-model-effect.d.ts.map +1 -1
  35. package/core/core/decorators/kos-multiple-future-aware.d.ts +217 -0
  36. package/core/core/decorators/kos-multiple-future-aware.d.ts.map +1 -0
  37. package/core/core/decorators/kos-parent.d.ts +4 -0
  38. package/core/core/decorators/kos-parent.d.ts.map +1 -1
  39. package/core/core/decorators/kos-reference.d.ts +9 -0
  40. package/core/core/decorators/kos-reference.d.ts.map +1 -1
  41. package/core/core/decorators/kos-service-request-helpers.d.ts +60 -0
  42. package/core/core/decorators/kos-service-request-helpers.d.ts.map +1 -0
  43. package/core/core/decorators/kos-service-request.d.ts +498 -0
  44. package/core/core/decorators/kos-service-request.d.ts.map +1 -0
  45. package/core/core/decorators/kos-state-machine.d.ts +534 -0
  46. package/core/core/decorators/kos-state-machine.d.ts.map +1 -0
  47. package/core/core/decorators/kos-topic-handler-flow-control.d.ts +17 -1
  48. package/core/core/decorators/kos-topic-handler-flow-control.d.ts.map +1 -1
  49. package/core/core/decorators/kos-trouble-aware.d.ts +77 -0
  50. package/core/core/decorators/kos-trouble-aware.d.ts.map +1 -0
  51. package/core/core/decorators/kos-view-model.d.ts +176 -0
  52. package/core/core/decorators/kos-view-model.d.ts.map +1 -0
  53. package/core/core/decorators/kosDependency.d.ts +4 -1
  54. package/core/core/decorators/kosDependency.d.ts.map +1 -1
  55. package/core/core/decorators/kosModel.d.ts +17 -2
  56. package/core/core/decorators/kosModel.d.ts.map +1 -1
  57. package/core/core/decorators/kosSubscribe.d.ts +9 -0
  58. package/core/core/decorators/kosSubscribe.d.ts.map +1 -1
  59. package/core/core/decorators/kosTopicHandler.d.ts +87 -5
  60. package/core/core/decorators/kosTopicHandler.d.ts.map +1 -1
  61. package/core/core/decorators/propKeys.d.ts +14 -0
  62. package/core/core/decorators/propKeys.d.ts.map +1 -1
  63. package/core/core/decorators/resolve-parameters.d.ts.map +1 -1
  64. package/core/core/extension/extension-manager.d.ts +64 -4
  65. package/core/core/extension/extension-manager.d.ts.map +1 -1
  66. package/core/core/extension/initialize-extension.d.ts +24 -0
  67. package/core/core/extension/initialize-extension.d.ts.map +1 -1
  68. package/core/core/extension/plugin-extension-manager.d.ts +11 -0
  69. package/core/core/extension/plugin-extension-manager.d.ts.map +1 -1
  70. package/core/core/kos-container-model.d.ts +188 -0
  71. package/core/core/kos-container-model.d.ts.map +1 -1
  72. package/core/core/kos-data-container.d.ts +93 -1
  73. package/core/core/kos-data-container.d.ts.map +1 -1
  74. package/core/core/kos-registration.d.ts.map +1 -1
  75. package/core/core/kos-singleton-registration.d.ts.map +1 -1
  76. package/core/core/kosCore.d.ts.map +1 -1
  77. package/core/core/kosModel.d.ts +55 -1
  78. package/core/core/kosModel.d.ts.map +1 -1
  79. package/core/core/kosModelManager.d.ts +11 -1
  80. package/core/core/kosModelManager.d.ts.map +1 -1
  81. package/core/core/log/log.d.ts.map +1 -1
  82. package/core/core/model/apply-kos-dev-tool-support.d.ts.map +1 -1
  83. package/core/core/model/kos-model-component-factory.d.ts +4 -0
  84. package/core/core/model/kos-model-component-factory.d.ts.map +1 -1
  85. package/core/core/model/kos-offline-queue.d.ts +78 -1
  86. package/core/core/model/kos-offline-queue.d.ts.map +1 -1
  87. package/core/core/model/kos-service-request-manager.d.ts +102 -0
  88. package/core/core/model/kos-service-request-manager.d.ts.map +1 -0
  89. package/core/core/model/kos-subscription-manager.d.ts +20 -0
  90. package/core/core/model/kos-subscription-manager.d.ts.map +1 -1
  91. package/core/core/model/model-introspection-utils.d.ts +1 -0
  92. package/core/core/model/model-introspection-utils.d.ts.map +1 -1
  93. package/core/core/model/service-response-store.d.ts +164 -0
  94. package/core/core/model/service-response-store.d.ts.map +1 -0
  95. package/core/core/model-instantiator.d.ts +19 -0
  96. package/core/core/model-instantiator.d.ts.map +1 -1
  97. package/core/core/registration/index.d.ts +1 -0
  98. package/core/core/registration/index.d.ts.map +1 -1
  99. package/core/core/services/browser-router.d.ts.map +1 -1
  100. package/core/core/transport/webSocketTransport.d.ts +2 -1
  101. package/core/core/transport/webSocketTransport.d.ts.map +1 -1
  102. package/core/core/types/registration.d.ts +7 -0
  103. package/core/core/types/registration.d.ts.map +1 -1
  104. package/core/index.d.ts +2 -1
  105. package/core/index.d.ts.map +1 -1
  106. package/core/types/index.d.ts +1 -0
  107. package/core/types/index.d.ts.map +1 -1
  108. package/core/types/kos-dependency.d.ts +48 -1
  109. package/core/types/kos-dependency.d.ts.map +1 -1
  110. package/core/types/service-response-store.d.ts +162 -0
  111. package/core/types/service-response-store.d.ts.map +1 -0
  112. package/core/types/utils/kos-fetch.d.ts +121 -0
  113. package/core/types/utils/kos-fetch.d.ts.map +1 -1
  114. package/core/util/ancestor-path-visitor.d.ts +60 -0
  115. package/core/util/ancestor-path-visitor.d.ts.map +1 -0
  116. package/core/util/api-request-id.d.ts +4 -0
  117. package/core/util/api-request-id.d.ts.map +1 -1
  118. package/core/util/apply-mixins.d.ts +4 -0
  119. package/core/util/apply-mixins.d.ts.map +1 -1
  120. package/core/util/array-utils.d.ts +4 -0
  121. package/core/util/array-utils.d.ts.map +1 -1
  122. package/core/util/container-utils.d.ts +264 -11
  123. package/core/util/container-utils.d.ts.map +1 -1
  124. package/core/util/date-utils.d.ts +29 -0
  125. package/core/util/date-utils.d.ts.map +1 -1
  126. package/core/util/debounce.d.ts +3 -0
  127. package/core/util/debounce.d.ts.map +1 -1
  128. package/core/util/error-logger.d.ts +16 -0
  129. package/core/util/error-logger.d.ts.map +1 -0
  130. package/core/util/feature-flags.d.ts +19 -0
  131. package/core/util/feature-flags.d.ts.map +1 -1
  132. package/core/util/get-query-params.d.ts +4 -0
  133. package/core/util/get-query-params.d.ts.map +1 -1
  134. package/core/util/hsl-to-hex.d.ts +16 -0
  135. package/core/util/hsl-to-hex.d.ts.map +1 -1
  136. package/core/util/index.d.ts +3 -0
  137. package/core/util/index.d.ts.map +1 -1
  138. package/core/util/kos-config-init.d.ts +37 -0
  139. package/core/util/kos-config-init.d.ts.map +1 -1
  140. package/core/util/kos-data-mapper-utils.d.ts +9 -0
  141. package/core/util/kos-data-mapper-utils.d.ts.map +1 -1
  142. package/core/util/kos-fetch.d.ts +12 -0
  143. package/core/util/kos-fetch.d.ts.map +1 -1
  144. package/core/util/kos-message-utils.d.ts +88 -0
  145. package/core/util/kos-message-utils.d.ts.map +1 -1
  146. package/core/util/kos-model-utils.d.ts +46 -0
  147. package/core/util/kos-model-utils.d.ts.map +1 -1
  148. package/core/util/kos-model-visitor.d.ts +2 -0
  149. package/core/util/kos-model-visitor.d.ts.map +1 -1
  150. package/core/util/kos-service-request.d.ts +43 -3
  151. package/core/util/kos-service-request.d.ts.map +1 -1
  152. package/core/util/log-utils.d.ts +12 -0
  153. package/core/util/log-utils.d.ts.map +1 -1
  154. package/core/util/middleware.d.ts +15 -0
  155. package/core/util/middleware.d.ts.map +1 -1
  156. package/core/util/model-attribute-utils.d.ts +7 -0
  157. package/core/util/model-attribute-utils.d.ts.map +1 -1
  158. package/core/util/model-error-utils.d.ts +61 -0
  159. package/core/util/model-error-utils.d.ts.map +1 -0
  160. package/core/util/model-factory.d.ts +4 -0
  161. package/core/util/model-factory.d.ts.map +1 -1
  162. package/core/util/model-registration-utils.d.ts +8 -0
  163. package/core/util/model-registration-utils.d.ts.map +1 -1
  164. package/core/util/model-transition-utils.d.ts +41 -0
  165. package/core/util/model-transition-utils.d.ts.map +1 -0
  166. package/core/util/model-type-guards.d.ts +26 -0
  167. package/core/util/model-type-guards.d.ts.map +1 -0
  168. package/core/util/model-utils.d.ts +40 -29
  169. package/core/util/model-utils.d.ts.map +1 -1
  170. package/core/util/observable-proxy-map.d.ts +11 -0
  171. package/core/util/observable-proxy-map.d.ts.map +1 -1
  172. package/core/util/paired-client-heartbeat.d.ts +2 -0
  173. package/core/util/paired-client-heartbeat.d.ts.map +1 -1
  174. package/core/util/pipe.d.ts +4 -0
  175. package/core/util/pipe.d.ts.map +1 -1
  176. package/core/util/promise-utils.d.ts +58 -0
  177. package/core/util/promise-utils.d.ts.map +1 -0
  178. package/core/util/retry-with-exponential-backoff.d.ts +3 -0
  179. package/core/util/retry-with-exponential-backoff.d.ts.map +1 -1
  180. package/core/util/service-factory.d.ts +10 -0
  181. package/core/util/service-factory.d.ts.map +1 -1
  182. package/core/util/service-request-error.d.ts +60 -0
  183. package/core/util/service-request-error.d.ts.map +1 -0
  184. package/core/util/service-response.d.ts +125 -0
  185. package/core/util/service-response.d.ts.map +1 -0
  186. package/core/util/session-utils.d.ts +8 -0
  187. package/core/util/session-utils.d.ts.map +1 -1
  188. package/core/util/wait-for-request.d.ts +16 -0
  189. package/core/util/wait-for-request.d.ts.map +1 -1
  190. package/core/util/when-ready.d.ts +3 -0
  191. package/core/util/when-ready.d.ts.map +1 -1
  192. package/index.cjs +26904 -118
  193. package/index.cjs.map +1 -1
  194. package/index.d.cts +6 -3
  195. package/index.d.ts +6 -3
  196. package/index.d.ts.map +1 -1
  197. package/index.js +25298 -13441
  198. package/index.js.map +1 -1
  199. package/kos-models.json +426 -0
  200. package/models/constants/index.d.ts +3 -1
  201. package/models/constants/index.d.ts.map +1 -1
  202. package/models/decorators/future-service.d.ts +27 -2
  203. package/models/decorators/future-service.d.ts.map +1 -1
  204. package/models/models/browser-router/browser-router-model.d.ts +80 -1
  205. package/models/models/browser-router/browser-router-model.d.ts.map +1 -1
  206. package/models/models/browser-router/types/index.d.ts +26 -1
  207. package/models/models/canvas-dispatcher/types/index.d.ts +5 -0
  208. package/models/models/canvas-renderer/types/index.d.ts +5 -0
  209. package/models/models/config-bean/config-bean-model-builder.d.ts +4 -2
  210. package/models/models/config-bean/config-bean-model-builder.d.ts.map +1 -1
  211. package/models/models/config-bean/config-bean-model.d.ts +117 -13
  212. package/models/models/config-bean/config-bean-model.d.ts.map +1 -1
  213. package/models/models/config-bean/config-bean-types.d.ts +6 -3
  214. package/models/models/config-bean/config-bean-types.d.ts.map +1 -1
  215. package/models/models/config-bean/types/index.d.ts +34 -0
  216. package/models/models/config-bean-prop/config-bean-prop-model.d.ts +112 -1
  217. package/models/models/config-bean-prop/config-bean-prop-model.d.ts.map +1 -1
  218. package/models/models/config-bean-prop/types/index.d.ts +301 -19
  219. package/models/models/device/device-model.d.ts +219 -9
  220. package/models/models/device/device-model.d.ts.map +1 -1
  221. package/models/models/device/device-registration.d.ts +61 -48
  222. package/models/models/device/device-registration.d.ts.map +1 -1
  223. package/models/models/device/types/index.d.ts +42 -0
  224. package/models/models/future/future-aware.d.ts +82 -0
  225. package/models/models/future/future-aware.d.ts.map +1 -1
  226. package/models/models/future/future-model.d.ts +34 -5
  227. package/models/models/future/future-model.d.ts.map +1 -1
  228. package/models/models/future/future-types.d.ts +202 -9
  229. package/models/models/future/future-types.d.ts.map +1 -1
  230. package/models/models/future-container/future-container-model.d.ts +2 -2
  231. package/models/models/gpio-chip/gpio-chip-container-model.d.ts +25 -0
  232. package/models/models/gpio-chip/gpio-chip-container-model.d.ts.map +1 -0
  233. package/models/models/gpio-chip/gpio-chip-model.d.ts +30 -0
  234. package/models/models/gpio-chip/gpio-chip-model.d.ts.map +1 -0
  235. package/models/models/gpio-chip/index.d.ts +7 -0
  236. package/models/models/gpio-chip/index.d.ts.map +1 -0
  237. package/models/models/gpio-chip/services/gpio-chip-services.d.ts +86 -0
  238. package/models/models/gpio-chip/services/gpio-chip-services.d.ts.map +1 -0
  239. package/models/models/gpio-chip/services/index.d.ts +2 -0
  240. package/models/models/gpio-chip/services/index.d.ts.map +1 -0
  241. package/models/models/gpio-chip/types/index.d.ts +24 -0
  242. package/models/models/gpio-pin/gpio-pin-container-model.d.ts +23 -0
  243. package/models/models/gpio-pin/gpio-pin-container-model.d.ts.map +1 -0
  244. package/models/models/gpio-pin/gpio-pin-model.d.ts +26 -0
  245. package/models/models/gpio-pin/gpio-pin-model.d.ts.map +1 -0
  246. package/models/models/gpio-pin/index.d.ts +6 -0
  247. package/models/models/gpio-pin/index.d.ts.map +1 -0
  248. package/models/models/gpio-pin/types/index.d.ts +23 -0
  249. package/models/models/index.d.ts +1 -0
  250. package/models/models/index.d.ts.map +1 -1
  251. package/models/models/key-value/index.d.ts +4 -0
  252. package/models/models/key-value/index.d.ts.map +1 -1
  253. package/models/models/key-value/key-value-model.d.ts +111 -0
  254. package/models/models/key-value/key-value-model.d.ts.map +1 -1
  255. package/models/models/key-value/services/key-value-services.d.ts +124 -2
  256. package/models/models/key-value/services/key-value-services.d.ts.map +1 -1
  257. package/models/models/key-value/types/index.d.ts +57 -0
  258. package/models/models/kos-expression-evaluator/index.d.ts +4 -0
  259. package/models/models/kos-expression-evaluator/index.d.ts.map +1 -0
  260. package/models/models/kos-expression-evaluator/kos-expression-evaluator-model.d.ts +209 -0
  261. package/models/models/kos-expression-evaluator/kos-expression-evaluator-model.d.ts.map +1 -0
  262. package/models/models/kos-expression-evaluator/services/index.d.ts +6 -0
  263. package/models/models/kos-expression-evaluator/services/index.d.ts.map +1 -0
  264. package/models/models/kos-expression-evaluator/services/kos-expression-evaluator-services.d.ts +15 -0
  265. package/models/models/kos-expression-evaluator/services/kos-expression-evaluator-services.d.ts.map +1 -0
  266. package/models/models/kos-expression-evaluator/types/index.d.ts +6 -0
  267. package/models/models/kos-log-manager/kos-log-manager-model.d.ts +61 -14
  268. package/models/models/kos-log-manager/kos-log-manager-model.d.ts.map +1 -1
  269. package/models/models/kos-log-manager/types/index.d.ts +191 -0
  270. package/models/models/kos-time/kos-time-model.d.ts +64 -0
  271. package/models/models/kos-time/kos-time-model.d.ts.map +1 -1
  272. package/models/models/kos-time/types/index.d.ts +83 -0
  273. package/models/models/log-block/log-block-container-model.d.ts +132 -0
  274. package/models/models/log-block/log-block-container-model.d.ts.map +1 -1
  275. package/models/models/log-block/log-block-model.d.ts +185 -0
  276. package/models/models/log-block/log-block-model.d.ts.map +1 -1
  277. package/models/models/log-block/types/index.d.ts +133 -0
  278. package/models/models/log-stream/index.d.ts +6 -2
  279. package/models/models/log-stream/index.d.ts.map +1 -1
  280. package/models/models/log-stream/log-stream-container-model.d.ts +62 -0
  281. package/models/models/log-stream/log-stream-container-model.d.ts.map +1 -1
  282. package/models/models/log-stream/log-stream-model.d.ts +55 -0
  283. package/models/models/log-stream/log-stream-model.d.ts.map +1 -1
  284. package/models/models/log-stream/services/log-stream-services.d.ts +2 -1
  285. package/models/models/log-stream/services/log-stream-services.d.ts.map +1 -1
  286. package/models/models/log-stream/types/index.d.ts +79 -0
  287. package/models/models/network-interface/index.d.ts +6 -2
  288. package/models/models/network-interface/index.d.ts.map +1 -1
  289. package/models/models/network-interface/network-interface-container-model.d.ts +62 -0
  290. package/models/models/network-interface/network-interface-container-model.d.ts.map +1 -1
  291. package/models/models/network-interface/network-interface-container-registration.d.ts +2 -1
  292. package/models/models/network-interface/network-interface-container-registration.d.ts.map +1 -1
  293. package/models/models/network-interface/network-interface-model.d.ts +77 -0
  294. package/models/models/network-interface/network-interface-model.d.ts.map +1 -1
  295. package/models/models/network-interface/network-interface-registration.d.ts +2 -1
  296. package/models/models/network-interface/network-interface-registration.d.ts.map +1 -1
  297. package/models/models/network-interface/services/network-interface-services.d.ts +54 -0
  298. package/models/models/network-interface/services/network-interface-services.d.ts.map +1 -1
  299. package/models/models/network-interface/types/index.d.ts +22 -0
  300. package/models/models/ota/ota-model.d.ts +82 -3
  301. package/models/models/ota/ota-model.d.ts.map +1 -1
  302. package/models/models/ota/types/index.d.ts +177 -0
  303. package/models/models/region-info/region-info-model.d.ts +8 -3
  304. package/models/models/region-info/region-info-model.d.ts.map +1 -1
  305. package/models/models/region-info/services/region-info-services.d.ts +2 -2
  306. package/models/models/region-info/services/region-info-services.d.ts.map +1 -1
  307. package/models/models/region-info/types/index.d.ts +191 -13
  308. package/models/models/region-info/types/index.d.ts.map +1 -1
  309. package/models/models/region-info/utils/unit-system-utils.d.ts.map +1 -1
  310. package/models/models/software-info/services/software-info-services.d.ts.map +1 -1
  311. package/models/models/software-info/software-info-model.d.ts +74 -2
  312. package/models/models/software-info/software-info-model.d.ts.map +1 -1
  313. package/models/models/software-info/types/index.d.ts +52 -17
  314. package/models/models/state-bean/state-bean-model.d.ts +86 -9
  315. package/models/models/state-bean/state-bean-model.d.ts.map +1 -1
  316. package/models/models/state-bean/types/index.d.ts +117 -6
  317. package/models/models/state-prop/state-prop-model.d.ts +78 -1
  318. package/models/models/state-prop/state-prop-model.d.ts.map +1 -1
  319. package/models/models/state-prop/types/index.d.ts +57 -7
  320. package/models/models/storage-device/services/storage-device-services.d.ts +1 -0
  321. package/models/models/storage-device/services/storage-device-services.d.ts.map +1 -1
  322. package/models/models/storage-device/storage-device-container-model.d.ts +289 -2
  323. package/models/models/storage-device/storage-device-container-model.d.ts.map +1 -1
  324. package/models/models/storage-device/storage-device-model.d.ts +84 -2
  325. package/models/models/storage-device/storage-device-model.d.ts.map +1 -1
  326. package/models/models/storage-device/types/index.d.ts +114 -0
  327. package/models/models/studio-properties/studio-properties-model.d.ts +75 -0
  328. package/models/models/studio-properties/studio-properties-model.d.ts.map +1 -1
  329. package/models/models/studio-properties/types/index.d.ts +29 -0
  330. package/models/models/translation/services/translation-services.d.ts +128 -2
  331. package/models/models/translation/services/translation-services.d.ts.map +1 -1
  332. package/models/models/translation/translation-container-model.d.ts +100 -10
  333. package/models/models/translation/translation-container-model.d.ts.map +1 -1
  334. package/models/models/translation/translation-container-registration.d.ts +2 -1
  335. package/models/models/translation/translation-container-registration.d.ts.map +1 -1
  336. package/models/models/translation/translation-context.d.ts +1 -16
  337. package/models/models/translation/translation-context.d.ts.map +1 -1
  338. package/models/models/translation/translation-model.d.ts +113 -1
  339. package/models/models/translation/translation-model.d.ts.map +1 -1
  340. package/models/models/translation/types/index.d.ts +343 -0
  341. package/models/models/trouble/index.d.ts +2 -1
  342. package/models/models/trouble/index.d.ts.map +1 -1
  343. package/models/models/trouble/services/trouble-services.d.ts +6 -4
  344. package/models/models/trouble/services/trouble-services.d.ts.map +1 -1
  345. package/models/models/trouble/trouble-model.d.ts +4 -1
  346. package/models/models/trouble/trouble-model.d.ts.map +1 -1
  347. package/models/models/trouble/types/index.d.ts +34 -93
  348. package/models/models/trouble/utils/is-trouble-aware.d.ts +2 -2
  349. package/models/models/trouble/utils/is-trouble-aware.d.ts.map +1 -1
  350. package/models/models/trouble-container/index.d.ts +4 -3
  351. package/models/models/trouble-container/index.d.ts.map +1 -1
  352. package/models/models/trouble-container/trouble-container-model.d.ts +10 -5
  353. package/models/models/trouble-container/trouble-container-model.d.ts.map +1 -1
  354. package/models/models/trouble-container/types/index.d.ts +6 -14
  355. package/models/models/usb-update/types/index.d.ts +10 -0
  356. package/models/services/config-bean/index.d.ts +2 -2
  357. package/models/services/config-bean/index.d.ts.map +1 -1
  358. package/models/utils/client.d.ts +16 -12
  359. package/models/utils/client.d.ts.map +1 -1
  360. package/models/utils/core-registration-manager.d.ts +1 -1
  361. package/models/utils/core-registration-manager.d.ts.map +1 -1
  362. package/models/utils/extension-manager.d.ts +54 -13
  363. package/models/utils/extension-manager.d.ts.map +1 -1
  364. package/models/utils/get-kos-connection-id.d.ts +2 -0
  365. package/models/utils/get-kos-connection-id.d.ts.map +1 -0
  366. package/models/utils/index.d.ts +3 -2
  367. package/models/utils/index.d.ts.map +1 -1
  368. package/models/utils/openapi-index.d.ts +3 -0
  369. package/models/utils/openapi-index.d.ts.map +1 -0
  370. package/models/utils/service-accessor.d.ts +86 -0
  371. package/models/utils/service-accessor.d.ts.map +1 -0
  372. package/models/utils/service.d.ts +91 -13
  373. package/models/utils/service.d.ts.map +1 -1
  374. package/models/utils/services/kos/1.6.5/openapi.d.ts +3809 -0
  375. package/models/utils/services/kos/1.6.5/service.d.ts +124 -0
  376. package/models/utils/services/kos/1.6.5/service.d.ts.map +1 -0
  377. package/models/utils/services/kos/1.8.1/openapi.d.ts +4344 -0
  378. package/models/utils/services/kos/1.8.1/service.d.ts +124 -0
  379. package/models/utils/services/kos/1.8.1/service.d.ts.map +1 -0
  380. package/models/utils/services/kos/1.9.x/openapi.d.ts +4597 -0
  381. package/models/utils/services/kos/1.9.x/service.d.ts +124 -0
  382. package/models/utils/services/kos/1.9.x/service.d.ts.map +1 -0
  383. package/models/utils/services/kos/daily/openapi.d.ts +4349 -0
  384. package/models/utils/services/kos/daily/service.d.ts +124 -0
  385. package/models/utils/services/kos/daily/service.d.ts.map +1 -0
  386. package/models/utils/services/vfs/1.6.5/openapi.d.ts +51 -0
  387. package/models/utils/services/vfs/1.6.5/service.d.ts +124 -0
  388. package/models/utils/services/vfs/1.6.5/service.d.ts.map +1 -0
  389. package/models/utils/services/vfs/1.8.1/openapi.d.ts +51 -0
  390. package/models/utils/services/vfs/1.8.1/service.d.ts +124 -0
  391. package/models/utils/services/vfs/1.8.1/service.d.ts.map +1 -0
  392. package/models/utils/services/vfs/1.9.x/openapi.d.ts +51 -0
  393. package/models/utils/services/vfs/1.9.x/service.d.ts +124 -0
  394. package/models/utils/services/vfs/1.9.x/service.d.ts.map +1 -0
  395. package/models/utils/services/vfs/daily/openapi.d.ts +51 -0
  396. package/models/utils/services/vfs/daily/service.d.ts +124 -0
  397. package/models/utils/services/vfs/daily/service.d.ts.map +1 -0
  398. package/models/utils/services-index.d.ts +9 -0
  399. package/models/utils/services-index.d.ts.map +1 -0
  400. package/package.json +16 -2
  401. package/ui/contexts/state-bean/state-bean-provider.d.ts.map +1 -1
  402. package/ui/hooks/device/use-device.d.ts +6 -0
  403. package/ui/hooks/device/use-device.d.ts.map +1 -1
  404. package/ui/hooks/index.d.ts +1 -0
  405. package/ui/hooks/index.d.ts.map +1 -1
  406. package/ui/hooks/kos-time/use-kos-time.d.ts +6 -0
  407. package/ui/hooks/kos-time/use-kos-time.d.ts.map +1 -1
  408. package/ui/hooks/network-interface-container/use-network-interface-container.d.ts +6 -0
  409. package/ui/hooks/network-interface-container/use-network-interface-container.d.ts.map +1 -1
  410. package/ui/hooks/ota/use-ota.d.ts +6 -0
  411. package/ui/hooks/ota/use-ota.d.ts.map +1 -1
  412. package/ui/hooks/software-info/use-software-info.d.ts +6 -0
  413. package/ui/hooks/software-info/use-software-info.d.ts.map +1 -1
  414. package/ui/hooks/state-bean/use-state-bean.d.ts +2 -2
  415. package/ui/hooks/state-bean/use-state-bean.d.ts.map +1 -1
  416. package/ui/hooks/state-bean/with-state-bean.d.ts.map +1 -1
  417. package/ui/hooks/storage-device-container/use-storage-device-container.d.ts +6 -0
  418. package/ui/hooks/storage-device-container/use-storage-device-container.d.ts.map +1 -1
  419. package/ui/hooks/translation-container/trans.d.ts +6 -0
  420. package/ui/hooks/translation-container/trans.d.ts.map +1 -1
  421. package/ui/hooks/translation-container/use-translation-container.d.ts +10 -33
  422. package/ui/hooks/translation-container/use-translation-container.d.ts.map +1 -1
  423. package/ui/hooks/translation-container/use-translation.d.ts +7 -0
  424. package/ui/hooks/translation-container/use-translation.d.ts.map +1 -1
  425. package/ui/hooks/translation-container/with-translation-container.d.ts +6 -0
  426. package/ui/hooks/translation-container/with-translation-container.d.ts.map +1 -1
  427. package/ui/hooks/usb-update-container/use-usb-update-container.d.ts +6 -0
  428. package/ui/hooks/usb-update-container/use-usb-update-container.d.ts.map +1 -1
  429. package/ui/hooks/use-config-bean.d.ts +6 -0
  430. package/ui/hooks/use-config-bean.d.ts.map +1 -1
  431. package/ui/hooks/use-config-property.d.ts +6 -0
  432. package/ui/hooks/use-config-property.d.ts.map +1 -1
  433. package/ui/hooks/use-kos-model.d.ts +7 -0
  434. package/ui/hooks/use-kos-model.d.ts.map +1 -1
  435. package/ui/hooks/use-kos-regions.d.ts.map +1 -1
  436. package/ui/hooks/view-model/index.d.ts +2 -0
  437. package/ui/hooks/view-model/index.d.ts.map +1 -0
  438. package/ui/hooks/view-model/use-view-model.d.ts +80 -0
  439. package/ui/hooks/view-model/use-view-model.d.ts.map +1 -0
  440. package/models/models/trouble-container/trouble-container-registration.d.ts +0 -5
  441. package/models/models/trouble-container/trouble-container-registration.d.ts.map +0 -1
  442. package/models/utils/kosmodel-compatible-future-mixin.d.ts +0 -142
  443. package/models/utils/kosmodel-compatible-future-mixin.d.ts.map +0 -1
  444. package/models/utils/kosmodel-interface-companion-mixin.d.ts +0 -83
  445. package/models/utils/kosmodel-interface-companion-mixin.d.ts.map +0 -1
package/core/index.d.ts CHANGED
@@ -15,9 +15,10 @@ export * from './core/kosModel';
15
15
  export * from './core/kosModelManager';
16
16
  export { KosModelEvents, KosModelState } from './core/lifecycle';
17
17
  export * from './core/log';
18
+ export { KosLoggerFactory } from './core/model/kos-logger-factory';
18
19
  export * from './core/models';
19
20
  export { default as KosToken } from './core/models/kos-token';
20
- export { KosModelRegistrationFactory, preloadKosModel, registerCompanionModel, registerKosModel, registerLegacyModel, RegistrationManager, SingletonKosModelRegistrationFactory, type RegistrationResult, } from './core/registration';
21
+ export { KosModelRegistrationFactory, preloadKosModel, registerCompanionModel, registerKosModel, registerLegacyModel, RegistrationManager, SingletonKosModelRegistrationFactory, type KosModelRegistrationType, type RegistrationResult, } from './core/registration';
21
22
  export * from './core/services';
22
23
  export * from './core/transport';
23
24
  export * from './core/types';
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/sdk/kos-ui-sdk/src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EAEP,kBAAkB,EAClB,cAAc,EAEd,QAAQ,EACR,WAAW,EACX,IAAI,EACL,MAAM,MAAM,CAAC;AACd,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mCAAmC,CAAC;AAClD,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjE,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EACL,2BAA2B,EAC3B,eAAe,EACf,sBAAsB,EACtB,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,oCAAoC,EACpC,KAAK,kBAAkB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,OAAO,EACL,SAAS,EACT,aAAa,EACb,WAAW,EACX,SAAS,EACT,aAAa,EACb,OAAO,EACP,kBAAkB,EAClB,cAAc,GACf,CAAC;AAEF;;;GAGG;AACH,QAAA,MAAM,OAAO,aAAO,CAAC;AAErB;;;GAGG;AACH,QAAA,MAAM,WAAW,iCAAW,CAAC;AAC7B;;;GAGG;AACH,QAAA,MAAM,SAAS,oBAAc,CAAC;AAE9B;;;;;;;GAOG;AACH,QAAA,MAAM,aAAa,gBAAU,CAAC;AAE9B;;;GAGG;AACH,QAAA,MAAM,SAAS,iBAAW,CAAC;AAE3B;;;GAGG;AACH,QAAA,MAAM,aAAa,mCAAa,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/sdk/kos-ui-sdk/src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EAEP,kBAAkB,EAClB,cAAc,EAEd,QAAQ,EACR,WAAW,EACX,IAAI,EACL,MAAM,MAAM,CAAC;AACd,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mCAAmC,CAAC;AAClD,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjE,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EACL,2BAA2B,EAC3B,eAAe,EACf,sBAAsB,EACtB,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,oCAAoC,EACpC,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,OAAO,EACL,SAAS,EACT,aAAa,EACb,WAAW,EACX,SAAS,EACT,aAAa,EACb,OAAO,EACP,kBAAkB,EAClB,cAAc,GACf,CAAC;AAEF;;;GAGG;AACH,QAAA,MAAM,OAAO,aAAO,CAAC;AAErB;;;GAGG;AACH,QAAA,MAAM,WAAW,iCAAW,CAAC;AAC7B;;;GAGG;AACH,QAAA,MAAM,SAAS,oBAAc,CAAC;AAE9B;;;;;;;GAOG;AACH,QAAA,MAAM,aAAa,gBAAU,CAAC;AAE9B;;;GAGG;AACH,QAAA,MAAM,SAAS,iBAAW,CAAC;AAE3B;;;GAGG;AACH,QAAA,MAAM,aAAa,mCAAa,CAAC"}
@@ -1,4 +1,5 @@
1
1
  export * from './model';
2
2
  export * from './utils/kos-fetch';
3
3
  export * from './kos-dependency';
4
+ export * from './service-response-store';
4
5
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC"}
@@ -1,3 +1,6 @@
1
+ /**
2
+ * @kosService core.dependency
3
+ */
1
4
  export declare enum DependencyLifecycle {
2
5
  INIT = "init",
3
6
  LOAD = "load",
@@ -5,9 +8,41 @@ export declare enum DependencyLifecycle {
5
8
  ACTIVATE = "activate",
6
9
  ONLINE = "online"
7
10
  }
11
+ /**
12
+ * Policy for handling dependency resolution failures.
13
+ *
14
+ * @kosService core.dependency
15
+ *
16
+ * All policies follow a lookup-first approach: The framework first checks if a model
17
+ * with the specified ID already exists. If found and the type matches, it returns the
18
+ * existing instance. Only if no existing model is found does the framework apply the
19
+ * resolution policy below.
20
+ */
21
+ export declare enum DependencyResolutionPolicy {
22
+ /**
23
+ * CREATE (default) - After lookup fails, attempt to create a new instance of the model.
24
+ * If the model requires options (via optionsRequired flag) and none are provided,
25
+ * it will fail with an exception.
26
+ */
27
+ CREATE = "create",
28
+ /**
29
+ * CONTINUE - After lookup fails, do not attempt to create a new instance.
30
+ * The property will be set to undefined. Log the failure but allow execution to continue.
31
+ * Use for optional dependencies that can degrade gracefully.
32
+ */
33
+ CONTINUE = "continue",
34
+ /**
35
+ * FAIL - After lookup fails, throw an exception with detailed diagnostic logging.
36
+ * Use for critical dependencies where failure should halt execution.
37
+ */
38
+ FAIL = "fail"
39
+ }
8
40
  /**
9
41
  * The parameters for the kosDependency decorator.
10
- * */
42
+ *
43
+ * @kosService core.dependency
44
+ * @kosApiLevel 2
45
+ */
11
46
  export interface KosDependencyParams<Options = unknown> {
12
47
  /** The type of the model to be injected. */
13
48
  modelType: string;
@@ -17,5 +52,17 @@ export interface KosDependencyParams<Options = unknown> {
17
52
  options?: Options;
18
53
  /** The lifecycle at which the dependency should be injected. */
19
54
  lifecycle?: DependencyLifecycle;
55
+ /**
56
+ * Policy for handling dependency resolution failures.
57
+ *
58
+ * All policies first attempt to look up an existing model instance. If found and the type
59
+ * matches, the existing instance is returned. Only if lookup fails does the policy apply:
60
+ *
61
+ * - CREATE (default): Attempts to create model instance after lookup fails
62
+ * - CONTINUE: Returns undefined after lookup fails, allows graceful degradation
63
+ * - FAIL: Throws exception with detailed logging after lookup fails
64
+ * @kosApiLevel 16
65
+ */
66
+ resolutionPolicy?: DependencyResolutionPolicy;
20
67
  }
21
68
  //# sourceMappingURL=kos-dependency.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"kos-dependency.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/types/kos-dependency.ts"],"names":[],"mappings":"AAAA,oBAAY,mBAAmB;IAC7B,IAAI,SAAS;IACb,IAAI,SAAS;IACb,KAAK,UAAU;IACf,QAAQ,aAAa;IACrB,MAAM,WAAW;CAClB;AAED;;KAEK;AACL,MAAM,WAAW,mBAAmB,CAAC,OAAO,GAAG,OAAO;IACpD,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,yDAAyD;IACzD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gEAAgE;IAChE,SAAS,CAAC,EAAE,mBAAmB,CAAC;CACjC"}
1
+ {"version":3,"file":"kos-dependency.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/types/kos-dependency.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,mBAAmB;IAC7B,IAAI,SAAS;IACb,IAAI,SAAS;IACb,KAAK,UAAU;IACf,QAAQ,aAAa;IACrB,MAAM,WAAW;CAClB;AAED;;;;;;;;;GASG;AACH,oBAAY,0BAA0B;IACpC;;;;OAIG;IACH,MAAM,WAAW;IACjB;;;;OAIG;IACH,QAAQ,aAAa;IACrB;;;OAGG;IACH,IAAI,SAAS;CACd;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB,CAAC,OAAO,GAAG,OAAO;IACpD,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,yDAAyD;IACzD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gEAAgE;IAChE,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC;;;;;;;;;;OAUG;IACH,gBAAgB,CAAC,EAAE,0BAA0B,CAAC;CAC/C"}
@@ -0,0 +1,162 @@
1
+ /**
2
+ * Response retention policies for ServiceResponseStore
3
+ * Controls how long service responses are cached and when they're cleaned up
4
+ *
5
+ * @kosService core.service-request
6
+ */
7
+ export declare enum ResponseRetention {
8
+ /**
9
+ * Clear immediately after handler completes
10
+ * Use for one-time operations with no caching needs
11
+ *
12
+ * Note: Response remains available during handler execution (including async handlers).
13
+ * Cleanup happens AFTER the handler returns/resolves via ServiceRequestManager.
14
+ */
15
+ IMMEDIATE = "immediate",
16
+ /**
17
+ * Keep until next response for same path
18
+ * Default behavior - previous response replaced on new request
19
+ */
20
+ SINGLE = "single",
21
+ /**
22
+ * Keep for specified duration (ms)
23
+ * Automatic cleanup after TTL expires
24
+ */
25
+ TTL = "ttl",
26
+ /**
27
+ * Keep until model is destroyed
28
+ * Use for data needed throughout model lifetime
29
+ */
30
+ PERMANENT = "permanent",
31
+ /**
32
+ * Keep until explicitly cleared
33
+ * Manual cleanup required via clearServiceResponse()
34
+ */
35
+ MANUAL = "manual"
36
+ }
37
+ /**
38
+ * Configuration for response caching behavior
39
+ *
40
+ * @kosService core.service-request
41
+ * @kosApiLevel 15
42
+ */
43
+ export interface ResponseCacheConfig {
44
+ /**
45
+ * Retention policy determining when response is cleaned up
46
+ */
47
+ retention: ResponseRetention;
48
+ /**
49
+ * Time-to-live in milliseconds (required for TTL retention)
50
+ */
51
+ ttl?: number;
52
+ /**
53
+ * For TTL retention: extend TTL instead of replacing data on new request
54
+ *
55
+ * When false (default): New request clears old data and stores new data with fresh TTL
56
+ * When true: If cached data exists and hasn't expired, extend TTL without replacing data
57
+ *
58
+ * Use extendOnRefresh=true to avoid re-running expensive operations when cached data is still valid.
59
+ *
60
+ * @default false
61
+ *
62
+ * @example
63
+ * // Replace on each request (default)
64
+ * cache: { retention: ResponseRetention.TTL, ttl: 5 * 60 * 1000 }
65
+ *
66
+ * @example
67
+ * // Extend TTL on refresh - avoid re-fetching if cache valid
68
+ * cache: { retention: ResponseRetention.TTL, ttl: 5 * 60 * 1000, extendOnRefresh: true }
69
+ */
70
+ extendOnRefresh?: boolean;
71
+ /**
72
+ * Maximum number of responses to cache per path (future use)
73
+ */
74
+ maxSize?: number;
75
+ }
76
+ /**
77
+ * Replay strategy for baseline-delta race condition handling
78
+ * Determines which queued events to replay after baseline loads
79
+ *
80
+ * @kosService core.topic-handler
81
+ */
82
+ export declare enum ReplayStrategy {
83
+ /**
84
+ * Replay all queued events
85
+ * Use for: State machines, audit trails requiring complete event history
86
+ */
87
+ ALL = "all",
88
+ /**
89
+ * Replay events received at or after baseline request was sent
90
+ * Use for: High-frequency idempotent updates (quantities, sensor readings, status)
91
+ */
92
+ AFTER_REQUEST = "after-request",
93
+ /**
94
+ * Replay events received at or after baseline response was received
95
+ * Use for: Low-frequency config where baseline likely includes recent changes
96
+ */
97
+ AFTER_RESPONSE = "after-response",
98
+ /**
99
+ * Discard all queued events
100
+ * Use for: Baseline is always complete source of truth
101
+ */
102
+ NONE = "none"
103
+ }
104
+ /**
105
+ * Baseline dependency configuration for topic handlers
106
+ *
107
+ * @kosService core.topic-handler
108
+ * @kosApiLevel 15
109
+ */
110
+ export interface BaselineDependency {
111
+ /**
112
+ * API path of the baseline request this handler depends on
113
+ */
114
+ path: string;
115
+ /**
116
+ * HTTP method of the baseline request
117
+ * @default 'get'
118
+ */
119
+ method?: string;
120
+ /**
121
+ * Strategy for replaying queued events after baseline loads
122
+ * @default ReplayStrategy.AFTER_REQUEST
123
+ */
124
+ replayStrategy?: ReplayStrategy;
125
+ }
126
+ /**
127
+ * Cached response with metadata
128
+ */
129
+ export interface CachedResponse<T = unknown> {
130
+ /**
131
+ * The response data
132
+ */
133
+ data: T;
134
+ /**
135
+ * When the response was cached (timestamp)
136
+ * @deprecated Use requestedAt or receivedAt for temporal comparisons
137
+ */
138
+ timestamp: number;
139
+ /**
140
+ * When the HTTP request was sent (timestamp)
141
+ * Used for baseline-delta temporal filtering
142
+ */
143
+ requestedAt: number;
144
+ /**
145
+ * When the HTTP response was received (timestamp)
146
+ * Used for baseline-delta temporal filtering
147
+ */
148
+ receivedAt: number;
149
+ /**
150
+ * The API path this response came from
151
+ */
152
+ path: string;
153
+ /**
154
+ * The HTTP method used
155
+ */
156
+ method: string;
157
+ /**
158
+ * When this response expires (for TTL retention)
159
+ */
160
+ expiresAt?: number;
161
+ }
162
+ //# sourceMappingURL=service-response-store.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"service-response-store.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/types/service-response-store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,oBAAY,iBAAiB;IAC3B;;;;;;OAMG;IACH,SAAS,cAAc;IAEvB;;;OAGG;IACH,MAAM,WAAW;IAEjB;;;OAGG;IACH,GAAG,QAAQ;IAEX;;;OAGG;IACH,SAAS,cAAc;IAEvB;;;OAGG;IACH,MAAM,WAAW;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,SAAS,EAAE,iBAAiB,CAAC;IAE7B;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;;;;;;;;;;;;;;;OAiBG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,oBAAY,cAAc;IACxB;;;OAGG;IACH,GAAG,QAAQ;IAEX;;;OAGG;IACH,aAAa,kBAAkB;IAE/B;;;OAGG;IACH,cAAc,mBAAmB;IAEjC;;;OAGG;IACH,IAAI,SAAS;CACd;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IACzC;;OAEG;IACH,IAAI,EAAE,CAAC,CAAC;IAER;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}
@@ -1,3 +1,7 @@
1
+ /**
2
+ * @kosService core.fetch
3
+ * @kosApiLevel 1
4
+ */
1
5
  export declare enum KosFetchMethods {
2
6
  GET = "GET",
3
7
  PUT = "PUT",
@@ -5,6 +9,10 @@ export declare enum KosFetchMethods {
5
9
  DELETE = "DELETE"
6
10
  }
7
11
  type FetchMethodStrings = keyof typeof KosFetchMethods;
12
+ /**
13
+ * @kosService core.fetch
14
+ * @kosApiLevel 2
15
+ */
8
16
  export interface Headers {
9
17
  append(name: string, value: string): void;
10
18
  delete(name: string): void;
@@ -22,6 +30,10 @@ interface Body {
22
30
  json<T = any>(): Promise<T | null>;
23
31
  text(): Promise<string>;
24
32
  }
33
+ /**
34
+ * @kosService core.fetch
35
+ * @kosApiLevel 2
36
+ */
25
37
  export interface Response extends Body {
26
38
  readonly headers: Headers;
27
39
  readonly ok: boolean;
@@ -32,8 +44,65 @@ export interface Response extends Body {
32
44
  readonly url: string;
33
45
  clone(): Response;
34
46
  }
47
+ /**
48
+ * Configuration for automatic retry with exponential backoff.
49
+ *
50
+ * @kosService core.fetch
51
+ *
52
+ * When `retry` is set to `true` on {@link KosFetchOptions}, these defaults apply.
53
+ * When set to a partial `RetryConfig`, unspecified fields use these defaults:
54
+ * - `maxAttempts`: 3
55
+ * - `baseDelayMs`: 350
56
+ * - `backoffFactor`: 2
57
+ * - `retryMutations`: false (POST, PUT, DELETE, PATCH are NOT retried)
58
+ * - `retryOn`: retries on any error (return `true` to retry, `false` to stop)
59
+ *
60
+ * @example
61
+ * ```typescript
62
+ * // Use all defaults
63
+ * retry: true
64
+ *
65
+ * // Custom config
66
+ * retry: {
67
+ * maxAttempts: 5,
68
+ * retryOn: (response) => response.status === 503 || response.status === 429,
69
+ * }
70
+ * ```
71
+ *
72
+ * @category Service Request
73
+ * @kosApiLevel 22
74
+ */
75
+ export interface RetryConfig {
76
+ /** Maximum number of attempts (including the initial request). @default 3 */
77
+ maxAttempts?: number;
78
+ /** Base delay in milliseconds before the first retry. @default 350 */
79
+ baseDelayMs?: number;
80
+ /** Multiplier applied to the delay after each attempt. @default 2 */
81
+ backoffFactor?: number;
82
+ /**
83
+ * Whether to retry mutating methods (POST, PUT, DELETE, PATCH).
84
+ * Set to `true` only if the endpoint is idempotent.
85
+ * @default false
86
+ */
87
+ retryMutations?: boolean;
88
+ /**
89
+ * Predicate called with the {@link Response} to decide if a failed request
90
+ * should be retried. Return `true` to retry, `false` to stop immediately.
91
+ *
92
+ * If not provided, all errors are retried (up to `maxAttempts`).
93
+ *
94
+ * @example
95
+ * ```typescript
96
+ * retryOn: (response) => response.status >= 500
97
+ * ```
98
+ */
99
+ retryOn?: (response: Response) => boolean;
100
+ }
35
101
  /**
36
102
  * Represents the configuration options for performing a Kos WebSocket fetch operation.
103
+ *
104
+ * @kosService core.fetch
105
+ * @kosApiLevel 2
37
106
  */
38
107
  export interface KosFetchOptions {
39
108
  /**
@@ -73,16 +142,37 @@ export interface KosFetchOptions {
73
142
  */
74
143
  bridge?: boolean;
75
144
  timeout?: number;
145
+ /**
146
+ * @kosApiLevel 5
147
+ */
76
148
  headers?: Record<string, string>;
77
149
  /**
78
150
  * Enable streaming mode for large responses
151
+ * @kosApiLevel 11
79
152
  */
80
153
  stream?: boolean;
81
154
  /**
82
155
  * Response type hint for binary data handling
156
+ * @kosApiLevel 11
83
157
  */
84
158
  responseType?: "text" | "json" | "arraybuffer" | "blob";
159
+ /**
160
+ * Retry configuration for transient failures.
161
+ *
162
+ * - `true`: enable retry with all defaults
163
+ * - `RetryConfig`: partial overrides (unspecified fields use defaults)
164
+ * - `undefined` / omitted: no retry (current behavior)
165
+ *
166
+ * Mutating methods (POST, PUT, DELETE, PATCH) are NOT retried by default.
167
+ * Set `retryMutations: true` to opt in.
168
+ * @kosApiLevel 22
169
+ */
170
+ retry?: boolean | RetryConfig;
85
171
  }
172
+ /**
173
+ * @kosService core.fetch
174
+ * @kosApiLevel 2
175
+ */
86
176
  export interface KosFetchResponse {
87
177
  headers: Headers;
88
178
  status: string | number | boolean;
@@ -90,6 +180,10 @@ export interface KosFetchResponse {
90
180
  json: <T = Record<string | number | symbol, string | number | symbol>>() => Promise<T>;
91
181
  body: ReadableStream<Uint8Array> | null;
92
182
  }
183
+ /**
184
+ * @kosService core.fetch
185
+ * @kosApiLevel 2
186
+ */
93
187
  export interface KosFetchReqeust {
94
188
  path: string;
95
189
  requestId: string;
@@ -98,21 +192,40 @@ export interface KosFetchReqeust {
98
192
  ordered?: boolean;
99
193
  tracker?: string;
100
194
  bridge?: boolean;
195
+ /**
196
+ * @kosApiLevel 5
197
+ */
101
198
  headers?: Record<string, string | number | boolean>;
102
199
  }
200
+ /**
201
+ * @kosService core.fetch
202
+ * @kosApiLevel 2
203
+ */
103
204
  export interface KosMessageRequest extends Omit<KosFetchReqeust, "method" | "path" | "requestId"> {
104
205
  requestType: string;
105
206
  requestId?: string;
106
207
  headers?: Record<string, string>;
107
208
  }
209
+ /**
210
+ * @kosService core.fetch
211
+ * @kosApiLevel 2
212
+ */
108
213
  export interface KosBroadcastRequest {
109
214
  topic: string;
110
215
  }
216
+ /**
217
+ * @kosService core.fetch
218
+ * @kosApiLevel 2
219
+ */
111
220
  export interface KosMessageOptions extends KosBroadcastRequest {
112
221
  destinationAddress?: string;
113
222
  responseId?: string;
114
223
  type?: string;
115
224
  }
225
+ /**
226
+ * @kosService core.fetch
227
+ * @kosApiLevel 2
228
+ */
116
229
  export interface KosHttpMessageOptions {
117
230
  destinationAddress: string;
118
231
  sourceAddress: string;
@@ -121,12 +234,20 @@ export interface KosHttpMessageOptions {
121
234
  type: string;
122
235
  contentType?: string;
123
236
  }
237
+ /**
238
+ * @kosService core.fetch
239
+ * @kosApiLevel 2
240
+ */
124
241
  export interface KosFetchResponseParams {
125
242
  path: string;
126
243
  responseId?: string;
127
244
  destinationAddress: string;
128
245
  status: string | number | boolean;
129
246
  }
247
+ /**
248
+ * @kosService core.fetch
249
+ * @kosApiLevel 2
250
+ */
130
251
  export interface KosFetchPostReqeust extends KosFetchReqeust {
131
252
  body?: string;
132
253
  }
@@ -1 +1 @@
1
- {"version":3,"file":"kos-fetch.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/core/types/utils/kos-fetch.ts"],"names":[],"mappings":"AAAA,oBAAY,eAAe;IACzB,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,MAAM,WAAW;CAClB;AAED,KAAK,kBAAkB,GAAG,MAAM,OAAO,eAAe,CAAC;AAEvD,MAAM,WAAW,OAAO;IACtB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACjC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,OAAO,CACL,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,EACjE,OAAO,CAAC,EAAE,GAAG,GACZ,IAAI,CAAC;CACT;AAED,UAAU,IAAI;IACZ,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;IACjD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;IACpC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC9B,IAAI,CAAC,CAAC,GAAG,GAAG,KAAK,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACnC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,QAAS,SAAQ,IAAI;IACpC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,KAAK,IAAI,QAAQ,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,MAAM,EAAE,kBAAkB,CAAC;IAE3B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,GAAG,QAAQ,GAAG,UAAU,CAAC;IAE3D;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IAErB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IAEd;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,aAAa,GAAG,MAAM,CAAC;CACzD;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAClC,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,CACJ,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,OACzD,OAAO,CAAC,CAAC,CAAC,CAAC;IAClB,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,iBACf,SAAQ,IAAI,CAAC,eAAe,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IAC9D,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AACD,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAkB,SAAQ,mBAAmB;IAC5D,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,mBAAoB,SAAQ,eAAe;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}
1
+ {"version":3,"file":"kos-fetch.d.ts","sourceRoot":"","sources":["../../../../../../../packages/sdk/kos-ui-sdk/src/core/types/utils/kos-fetch.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,60 @@
1
+ import { KosModelVisitor } from './kos-model-visitor';
2
+ import { IKosDataModel, IKosModel } from '../core/kosModel';
3
+
4
+ /**
5
+ * Generic visitor that finds the ancestor path to a target item.
6
+ * Works with any KOS model hierarchy that implements the visitor pattern.
7
+ *
8
+ * Uses depth-first traversal, tracking the path as it goes.
9
+ * When the target is found, the accumulated path IS the ancestor list.
10
+ *
11
+ * Backtracking logic is entirely self-contained - no model changes needed.
12
+ * Works well for Studio's typical model sizes (dozens to ~100 items).
13
+ *
14
+ * @example
15
+ * ```typescript
16
+ * const visitor = new AncestorPathVisitor('target-item-id');
17
+ * visitor.start(rootContainerModel);
18
+ * const ancestors = visitor.getAncestorPath(); // ['root', 'parent', 'grandparent']
19
+ * ```
20
+ *
21
+ * @category Core
22
+ * @kosService core.utils
23
+ * @kosApiLevel 20
24
+ */
25
+ export declare class AncestorPathVisitor extends KosModelVisitor {
26
+ private targetId;
27
+ private currentPath;
28
+ private foundPath;
29
+ constructor(targetId: string);
30
+ /**
31
+ * Override visit() to wrap the entire visit lifecycle with path tracking.
32
+ *
33
+ * Flow:
34
+ * 1. Check cycle detection (skip if already visited)
35
+ * 2. Push model to path
36
+ * 3. Call visitModel() to check if this is target
37
+ * 4. If not target, visit children
38
+ * 5. Pop from path if target not found in this subtree (backtrack)
39
+ *
40
+ * Note: We inline the base class logic rather than calling super.visit()
41
+ * because we need to control exactly when push/pop happens relative to
42
+ * the cycle detection and child traversal.
43
+ */
44
+ visit(model: IKosModel): void;
45
+ /**
46
+ * Called for each model during traversal.
47
+ * Returns true to stop traversal when target is found.
48
+ */
49
+ visitModel<T extends IKosDataModel>(model: T): boolean | void;
50
+ /**
51
+ * Get the ancestor path (IDs from root to parent, not including target).
52
+ * Returns empty array if target not found or target is at root level.
53
+ */
54
+ getAncestorPath(): string[];
55
+ /**
56
+ * Check if target was found during traversal.
57
+ */
58
+ wasFound(): boolean;
59
+ }
60
+ //# sourceMappingURL=ancestor-path-visitor.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ancestor-path-visitor.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/ancestor-path-visitor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,mBAAoB,SAAQ,eAAe;IACtD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,SAAS,CAAyB;gBAE9B,QAAQ,EAAE,MAAM;IAK5B;;;;;;;;;;;;;OAaG;IACM,KAAK,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAgCtC;;;OAGG;IACH,UAAU,CAAC,CAAC,SAAS,aAAa,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,GAAG,IAAI;IAY7D;;;OAGG;IACH,eAAe,IAAI,MAAM,EAAE;IAI3B;;OAEG;IACH,QAAQ,IAAI,OAAO;CAGpB"}
@@ -1,2 +1,6 @@
1
+ /**
2
+ * @kosService core.fetch
3
+ * @kosApiLevel 2
4
+ */
1
5
  export declare function uuid(): string;
2
6
  //# sourceMappingURL=api-request-id.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"api-request-id.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/api-request-id.ts"],"names":[],"mappings":"AAAA,wBAAgB,IAAI,WAMnB"}
1
+ {"version":3,"file":"api-request-id.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/api-request-id.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,IAAI,WAMnB"}
@@ -1,2 +1,6 @@
1
+ /**
2
+ * @kosService core.kos-model
3
+ * @kosApiLevel 2
4
+ */
1
5
  export declare function applyMixins(derivedCtor: any, baseCtors: any[]): void;
2
6
  //# sourceMappingURL=apply-mixins.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"apply-mixins.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/apply-mixins.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,WAAW,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,QAc7D"}
1
+ {"version":3,"file":"apply-mixins.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/apply-mixins.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,QAc7D"}
@@ -1,2 +1,6 @@
1
+ /**
2
+ * @kosService core.utils
3
+ * @kosApiLevel 5
4
+ */
1
5
  export declare function arraysEqual(_a?: any[], _b?: any[]): boolean;
2
6
  //# sourceMappingURL=array-utils.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"array-utils.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/array-utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,OAAO,CAK3D"}
1
+ {"version":3,"file":"array-utils.d.ts","sourceRoot":"","sources":["../../../../../../packages/sdk/kos-ui-sdk/src/core/util/array-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,OAAO,CAK3D"}