ibm-cloud-sdk-core 5.0.2 → 5.1.1

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 (299) hide show
  1. package/.secrets.baseline +118 -14
  2. package/Authentication.md +146 -21
  3. package/CHANGELOG.md +14 -0
  4. package/README.md +4 -3
  5. package/auth/authenticators/authenticator.d.ts +1 -0
  6. package/auth/authenticators/authenticator.js +1 -0
  7. package/auth/authenticators/container-authenticator.d.ts +6 -0
  8. package/auth/authenticators/container-authenticator.js +8 -0
  9. package/auth/authenticators/iam-assume-authenticator.d.ts +82 -0
  10. package/auth/authenticators/iam-assume-authenticator.js +92 -0
  11. package/auth/authenticators/iam-authenticator.d.ts +6 -0
  12. package/auth/authenticators/iam-authenticator.js +8 -0
  13. package/auth/authenticators/iam-request-based-authenticator-immutable.d.ts +64 -0
  14. package/auth/authenticators/iam-request-based-authenticator-immutable.js +74 -0
  15. package/auth/authenticators/iam-request-based-authenticator.d.ts +19 -47
  16. package/auth/authenticators/iam-request-based-authenticator.js +28 -36
  17. package/auth/authenticators/index.d.ts +4 -1
  18. package/auth/authenticators/index.js +3 -1
  19. package/auth/authenticators/token-request-based-authenticator-immutable.d.ts +71 -0
  20. package/auth/authenticators/token-request-based-authenticator-immutable.js +91 -0
  21. package/auth/authenticators/token-request-based-authenticator.d.ts +4 -42
  22. package/auth/authenticators/token-request-based-authenticator.js +5 -43
  23. package/auth/token-managers/container-token-manager.d.ts +6 -0
  24. package/auth/token-managers/container-token-manager.js +18 -50
  25. package/auth/token-managers/iam-assume-token-manager.d.ts +101 -0
  26. package/auth/token-managers/iam-assume-token-manager.js +220 -0
  27. package/auth/token-managers/iam-request-based-token-manager.d.ts +3 -9
  28. package/auth/token-managers/iam-request-based-token-manager.js +0 -8
  29. package/auth/token-managers/iam-token-manager.d.ts +8 -2
  30. package/auth/token-managers/iam-token-manager.js +10 -2
  31. package/auth/token-managers/index.d.ts +4 -2
  32. package/auth/token-managers/index.js +6 -3
  33. package/auth/utils/get-authenticator-from-environment.js +3 -0
  34. package/auth/utils/helpers.d.ts +18 -23
  35. package/auth/utils/helpers.js +50 -30
  36. package/build/docs/ibm-cloud-sdk-core.atleastone.md +55 -0
  37. package/build/docs/ibm-cloud-sdk-core.atmostone.md +55 -0
  38. package/build/docs/ibm-cloud-sdk-core.authenticator._constructor_.md +18 -0
  39. package/build/docs/ibm-cloud-sdk-core.authenticator.authenticate.md +57 -0
  40. package/build/docs/ibm-cloud-sdk-core.authenticator.authenticationtype.md +19 -0
  41. package/build/docs/ibm-cloud-sdk-core.authenticator.authtype_basic.md +13 -0
  42. package/build/docs/ibm-cloud-sdk-core.authenticator.authtype_bearertoken.md +11 -0
  43. package/build/docs/ibm-cloud-sdk-core.authenticator.authtype_container.md +11 -0
  44. package/build/docs/ibm-cloud-sdk-core.authenticator.authtype_cp4d.md +11 -0
  45. package/build/docs/ibm-cloud-sdk-core.authenticator.authtype_iam.md +11 -0
  46. package/build/docs/ibm-cloud-sdk-core.authenticator.authtype_iam_assume.md +11 -0
  47. package/build/docs/ibm-cloud-sdk-core.authenticator.authtype_mcsp.md +11 -0
  48. package/build/docs/ibm-cloud-sdk-core.authenticator.authtype_noauth.md +11 -0
  49. package/build/docs/ibm-cloud-sdk-core.authenticator.authtype_unknown.md +11 -0
  50. package/build/docs/ibm-cloud-sdk-core.authenticator.authtype_vpc.md +11 -0
  51. package/build/docs/ibm-cloud-sdk-core.authenticator.md +313 -0
  52. package/build/docs/ibm-cloud-sdk-core.authenticatorinterface.authenticate.md +53 -0
  53. package/build/docs/ibm-cloud-sdk-core.authenticatorinterface.authenticationtype.md +17 -0
  54. package/build/docs/ibm-cloud-sdk-core.authenticatorinterface.md +50 -0
  55. package/build/docs/ibm-cloud-sdk-core.baseservice._constructor_.md +49 -0
  56. package/build/docs/ibm-cloud-sdk-core.baseservice.baseoptions.md +11 -0
  57. package/build/docs/ibm-cloud-sdk-core.baseservice.configureservice.md +53 -0
  58. package/build/docs/ibm-cloud-sdk-core.baseservice.convertmodel.md +85 -0
  59. package/build/docs/ibm-cloud-sdk-core.baseservice.createrequest.md +55 -0
  60. package/build/docs/ibm-cloud-sdk-core.baseservice.createrequestanddeserializeresponse.md +87 -0
  61. package/build/docs/ibm-cloud-sdk-core.baseservice.default_service_name.md +11 -0
  62. package/build/docs/ibm-cloud-sdk-core.baseservice.default_service_url.md +11 -0
  63. package/build/docs/ibm-cloud-sdk-core.baseservice.disableretries.md +17 -0
  64. package/build/docs/ibm-cloud-sdk-core.baseservice.enableretries.md +53 -0
  65. package/build/docs/ibm-cloud-sdk-core.baseservice.getauthenticator.md +19 -0
  66. package/build/docs/ibm-cloud-sdk-core.baseservice.gethttpclient.md +17 -0
  67. package/build/docs/ibm-cloud-sdk-core.baseservice.md +313 -0
  68. package/build/docs/ibm-cloud-sdk-core.baseservice.setdefaultheaders.md +53 -0
  69. package/build/docs/ibm-cloud-sdk-core.baseservice.setenablegzipcompression.md +53 -0
  70. package/build/docs/ibm-cloud-sdk-core.baseservice.setserviceurl.md +53 -0
  71. package/build/docs/ibm-cloud-sdk-core.basicauthenticator._constructor_.md +54 -0
  72. package/build/docs/ibm-cloud-sdk-core.basicauthenticator.authenticate.md +55 -0
  73. package/build/docs/ibm-cloud-sdk-core.basicauthenticator.authenticationtype.md +19 -0
  74. package/build/docs/ibm-cloud-sdk-core.basicauthenticator.authheader.md +13 -0
  75. package/build/docs/ibm-cloud-sdk-core.basicauthenticator.md +165 -0
  76. package/build/docs/ibm-cloud-sdk-core.basicauthenticator.requiredoptions.md +11 -0
  77. package/build/docs/ibm-cloud-sdk-core.bearertokenauthenticator._constructor_.md +54 -0
  78. package/build/docs/ibm-cloud-sdk-core.bearertokenauthenticator.authenticate.md +55 -0
  79. package/build/docs/ibm-cloud-sdk-core.bearertokenauthenticator.authenticationtype.md +19 -0
  80. package/build/docs/ibm-cloud-sdk-core.bearertokenauthenticator.md +160 -0
  81. package/build/docs/ibm-cloud-sdk-core.bearertokenauthenticator.requiredoptions.md +11 -0
  82. package/build/docs/ibm-cloud-sdk-core.bearertokenauthenticator.setbearertoken.md +53 -0
  83. package/build/docs/ibm-cloud-sdk-core.buildrequestfileobject.md +55 -0
  84. package/build/docs/ibm-cloud-sdk-core.checkcredentials.md +71 -0
  85. package/build/docs/ibm-cloud-sdk-core.cloudpakfordataauthenticator._constructor_.md +54 -0
  86. package/build/docs/ibm-cloud-sdk-core.cloudpakfordataauthenticator.authenticationtype.md +19 -0
  87. package/build/docs/ibm-cloud-sdk-core.cloudpakfordataauthenticator.md +149 -0
  88. package/build/docs/ibm-cloud-sdk-core.cloudpakfordataauthenticator.requiredoptions.md +11 -0
  89. package/build/docs/ibm-cloud-sdk-core.cloudpakfordataauthenticator.tokenmanager.md +11 -0
  90. package/build/docs/ibm-cloud-sdk-core.computebasicauthheader.md +71 -0
  91. package/build/docs/ibm-cloud-sdk-core.constructfilepath.md +49 -0
  92. package/build/docs/ibm-cloud-sdk-core.constructserviceurl.md +87 -0
  93. package/build/docs/ibm-cloud-sdk-core.containerauthenticator._constructor_.md +54 -0
  94. package/build/docs/ibm-cloud-sdk-core.containerauthenticator.authenticationtype.md +19 -0
  95. package/build/docs/ibm-cloud-sdk-core.containerauthenticator.getrefreshtoken.md +19 -0
  96. package/build/docs/ibm-cloud-sdk-core.containerauthenticator.md +186 -0
  97. package/build/docs/ibm-cloud-sdk-core.containerauthenticator.setcrtokenfilename.md +53 -0
  98. package/build/docs/ibm-cloud-sdk-core.containerauthenticator.setiamprofileid.md +53 -0
  99. package/build/docs/ibm-cloud-sdk-core.containerauthenticator.setiamprofilename.md +53 -0
  100. package/build/docs/ibm-cloud-sdk-core.containerauthenticator.tokenmanager.md +11 -0
  101. package/build/docs/ibm-cloud-sdk-core.containertokenmanager._constructor_.md +54 -0
  102. package/build/docs/ibm-cloud-sdk-core.containertokenmanager.getcrtoken.md +19 -0
  103. package/build/docs/ibm-cloud-sdk-core.containertokenmanager.getrefreshtoken.md +19 -0
  104. package/build/docs/ibm-cloud-sdk-core.containertokenmanager.md +156 -0
  105. package/build/docs/ibm-cloud-sdk-core.containertokenmanager.requesttoken.md +17 -0
  106. package/build/docs/ibm-cloud-sdk-core.containertokenmanager.setcrtokenfilename.md +53 -0
  107. package/build/docs/ibm-cloud-sdk-core.containertokenmanager.setiamprofileid.md +53 -0
  108. package/build/docs/ibm-cloud-sdk-core.containertokenmanager.setiamprofilename.md +53 -0
  109. package/build/docs/ibm-cloud-sdk-core.contenttype.md +14 -0
  110. package/build/docs/ibm-cloud-sdk-core.cp4dtokenmanager._constructor_.md +54 -0
  111. package/build/docs/ibm-cloud-sdk-core.cp4dtokenmanager.md +128 -0
  112. package/build/docs/ibm-cloud-sdk-core.cp4dtokenmanager.requesttoken.md +15 -0
  113. package/build/docs/ibm-cloud-sdk-core.cp4dtokenmanager.requiredoptions.md +11 -0
  114. package/build/docs/ibm-cloud-sdk-core.fileexistsatpath.md +49 -0
  115. package/build/docs/ibm-cloud-sdk-core.fileobject.md +80 -0
  116. package/build/docs/ibm-cloud-sdk-core.fileobject.options.md +11 -0
  117. package/build/docs/ibm-cloud-sdk-core.fileobject.value.md +11 -0
  118. package/build/docs/ibm-cloud-sdk-core.fileoptions.contenttype.md +11 -0
  119. package/build/docs/ibm-cloud-sdk-core.fileoptions.filename.md +11 -0
  120. package/build/docs/ibm-cloud-sdk-core.fileoptions.md +74 -0
  121. package/build/docs/ibm-cloud-sdk-core.filestream.md +54 -0
  122. package/build/docs/ibm-cloud-sdk-core.filestream.path.md +11 -0
  123. package/build/docs/ibm-cloud-sdk-core.filewithmetadata.contenttype.md +11 -0
  124. package/build/docs/ibm-cloud-sdk-core.filewithmetadata.data.md +11 -0
  125. package/build/docs/ibm-cloud-sdk-core.filewithmetadata.filename.md +11 -0
  126. package/build/docs/ibm-cloud-sdk-core.filewithmetadata.md +87 -0
  127. package/build/docs/ibm-cloud-sdk-core.getauthenticatorfromenvironment.md +55 -0
  128. package/build/docs/ibm-cloud-sdk-core.getcontenttype.md +55 -0
  129. package/build/docs/ibm-cloud-sdk-core.getcurrenttime.md +19 -0
  130. package/build/docs/ibm-cloud-sdk-core.getformat.md +69 -0
  131. package/build/docs/ibm-cloud-sdk-core.getmissingparams.md +73 -0
  132. package/build/docs/ibm-cloud-sdk-core.getnewlogger.md +59 -0
  133. package/build/docs/ibm-cloud-sdk-core.getqueryparam.md +71 -0
  134. package/build/docs/ibm-cloud-sdk-core.iamassumeauthenticator._constructor_.md +54 -0
  135. package/build/docs/ibm-cloud-sdk-core.iamassumeauthenticator.authenticationtype.md +19 -0
  136. package/build/docs/ibm-cloud-sdk-core.iamassumeauthenticator.md +130 -0
  137. package/build/docs/ibm-cloud-sdk-core.iamassumeauthenticator.tokenmanager.md +11 -0
  138. package/build/docs/ibm-cloud-sdk-core.iamassumetokenmanager._constructor_.md +54 -0
  139. package/build/docs/ibm-cloud-sdk-core.iamassumetokenmanager.md +200 -0
  140. package/build/docs/ibm-cloud-sdk-core.iamassumetokenmanager.requesttoken.md +17 -0
  141. package/build/docs/ibm-cloud-sdk-core.iamassumetokenmanager.requiredoptions.md +11 -0
  142. package/build/docs/ibm-cloud-sdk-core.iamassumetokenmanager.savetokeninfo.md +53 -0
  143. package/build/docs/ibm-cloud-sdk-core.iamassumetokenmanager.setclientidandsecret.md +69 -0
  144. package/build/docs/ibm-cloud-sdk-core.iamassumetokenmanager.setdisablesslverification.md +53 -0
  145. package/build/docs/ibm-cloud-sdk-core.iamassumetokenmanager.setheaders.md +53 -0
  146. package/build/docs/ibm-cloud-sdk-core.iamassumetokenmanager.setscope.md +53 -0
  147. package/build/docs/ibm-cloud-sdk-core.iamauthenticator._constructor_.md +54 -0
  148. package/build/docs/ibm-cloud-sdk-core.iamauthenticator.authenticationtype.md +19 -0
  149. package/build/docs/ibm-cloud-sdk-core.iamauthenticator.getrefreshtoken.md +19 -0
  150. package/build/docs/ibm-cloud-sdk-core.iamauthenticator.md +163 -0
  151. package/build/docs/ibm-cloud-sdk-core.iamauthenticator.requiredoptions.md +11 -0
  152. package/build/docs/ibm-cloud-sdk-core.iamauthenticator.tokenmanager.md +11 -0
  153. package/build/docs/ibm-cloud-sdk-core.iamrequestbasedauthenticator.md +90 -0
  154. package/build/docs/ibm-cloud-sdk-core.iamrequestbasedauthenticator.setclientidandsecret.md +69 -0
  155. package/build/docs/ibm-cloud-sdk-core.iamrequestbasedauthenticator.setdisablesslverification.md +53 -0
  156. package/build/docs/ibm-cloud-sdk-core.iamrequestbasedauthenticator.setheaders.md +53 -0
  157. package/build/docs/ibm-cloud-sdk-core.iamrequestbasedauthenticator.setscope.md +53 -0
  158. package/build/docs/ibm-cloud-sdk-core.iamrequestbasedtokenmanager._constructor_.md +54 -0
  159. package/build/docs/ibm-cloud-sdk-core.iamrequestbasedtokenmanager.clientid.md +11 -0
  160. package/build/docs/ibm-cloud-sdk-core.iamrequestbasedtokenmanager.clientsecret.md +11 -0
  161. package/build/docs/ibm-cloud-sdk-core.iamrequestbasedtokenmanager.formdata.md +11 -0
  162. package/build/docs/ibm-cloud-sdk-core.iamrequestbasedtokenmanager.istokenexpired.md +19 -0
  163. package/build/docs/ibm-cloud-sdk-core.iamrequestbasedtokenmanager.md +264 -0
  164. package/build/docs/ibm-cloud-sdk-core.iamrequestbasedtokenmanager.refreshtoken.md +11 -0
  165. package/build/docs/ibm-cloud-sdk-core.iamrequestbasedtokenmanager.requesttoken.md +19 -0
  166. package/build/docs/ibm-cloud-sdk-core.iamrequestbasedtokenmanager.savetokeninfo.md +53 -0
  167. package/build/docs/ibm-cloud-sdk-core.iamrequestbasedtokenmanager.scope.md +11 -0
  168. package/build/docs/ibm-cloud-sdk-core.iamrequestbasedtokenmanager.setclientidandsecret.md +69 -0
  169. package/build/docs/ibm-cloud-sdk-core.iamrequestbasedtokenmanager.setscope.md +53 -0
  170. package/build/docs/ibm-cloud-sdk-core.iamrequestoptions.clientid.md +11 -0
  171. package/build/docs/ibm-cloud-sdk-core.iamrequestoptions.clientsecret.md +11 -0
  172. package/build/docs/ibm-cloud-sdk-core.iamrequestoptions.md +96 -0
  173. package/build/docs/ibm-cloud-sdk-core.iamrequestoptions.scope.md +11 -0
  174. package/build/docs/ibm-cloud-sdk-core.iamtokenmanager._constructor_.md +54 -0
  175. package/build/docs/ibm-cloud-sdk-core.iamtokenmanager.getrefreshtoken.md +19 -0
  176. package/build/docs/ibm-cloud-sdk-core.iamtokenmanager.md +126 -0
  177. package/build/docs/ibm-cloud-sdk-core.iamtokenmanager.requiredoptions.md +11 -0
  178. package/build/docs/ibm-cloud-sdk-core.isemptyobject.md +49 -0
  179. package/build/docs/ibm-cloud-sdk-core.isfiledata.md +49 -0
  180. package/build/docs/ibm-cloud-sdk-core.isfilewithmetadata.md +49 -0
  181. package/build/docs/ibm-cloud-sdk-core.ishtml.md +55 -0
  182. package/build/docs/ibm-cloud-sdk-core.isjsonmimetype.md +55 -0
  183. package/build/docs/ibm-cloud-sdk-core.jwttokenmanager._constructor_.md +49 -0
  184. package/build/docs/ibm-cloud-sdk-core.jwttokenmanager.md +163 -0
  185. package/build/docs/ibm-cloud-sdk-core.jwttokenmanager.requesttoken.md +19 -0
  186. package/build/docs/ibm-cloud-sdk-core.jwttokenmanager.savetokeninfo.md +53 -0
  187. package/build/docs/ibm-cloud-sdk-core.jwttokenmanager.tokeninfo.md +11 -0
  188. package/build/docs/ibm-cloud-sdk-core.jwttokenmanager.tokenname.md +11 -0
  189. package/build/docs/ibm-cloud-sdk-core.jwttokenmanageroptions.md +15 -0
  190. package/build/docs/ibm-cloud-sdk-core.mcspauthenticator._constructor_.md +54 -0
  191. package/build/docs/ibm-cloud-sdk-core.mcspauthenticator.authenticationtype.md +19 -0
  192. package/build/docs/ibm-cloud-sdk-core.mcspauthenticator.md +145 -0
  193. package/build/docs/ibm-cloud-sdk-core.mcspauthenticator.requiredoptions.md +11 -0
  194. package/build/docs/ibm-cloud-sdk-core.mcspauthenticator.tokenmanager.md +11 -0
  195. package/build/docs/ibm-cloud-sdk-core.mcsptokenmanager._constructor_.md +54 -0
  196. package/build/docs/ibm-cloud-sdk-core.mcsptokenmanager.md +128 -0
  197. package/build/docs/ibm-cloud-sdk-core.mcsptokenmanager.requesttoken.md +15 -0
  198. package/build/docs/ibm-cloud-sdk-core.mcsptokenmanager.requiredoptions.md +11 -0
  199. package/build/docs/ibm-cloud-sdk-core.md +820 -0
  200. package/build/docs/ibm-cloud-sdk-core.noauthauthenticator.authenticate.md +49 -0
  201. package/build/docs/ibm-cloud-sdk-core.noauthauthenticator.authenticationtype.md +19 -0
  202. package/build/docs/ibm-cloud-sdk-core.noauthauthenticator.md +60 -0
  203. package/build/docs/ibm-cloud-sdk-core.onlyone.md +55 -0
  204. package/build/docs/ibm-cloud-sdk-core.qs.md +21 -0
  205. package/build/docs/ibm-cloud-sdk-core.readcredentialsfile.md +17 -0
  206. package/build/docs/ibm-cloud-sdk-core.readcrtokenfile.md +49 -0
  207. package/build/docs/ibm-cloud-sdk-core.readexternalsources.md +55 -0
  208. package/build/docs/ibm-cloud-sdk-core.removesuffix.md +71 -0
  209. package/build/docs/ibm-cloud-sdk-core.sdklogger.debug.md +11 -0
  210. package/build/docs/ibm-cloud-sdk-core.sdklogger.error.md +11 -0
  211. package/build/docs/ibm-cloud-sdk-core.sdklogger.info.md +11 -0
  212. package/build/docs/ibm-cloud-sdk-core.sdklogger.md +121 -0
  213. package/build/docs/ibm-cloud-sdk-core.sdklogger.verbose.md +11 -0
  214. package/build/docs/ibm-cloud-sdk-core.sdklogger.warn.md +11 -0
  215. package/build/docs/ibm-cloud-sdk-core.streamtopromise.md +55 -0
  216. package/build/docs/ibm-cloud-sdk-core.striptrailingslash.md +55 -0
  217. package/build/docs/ibm-cloud-sdk-core.tokenmanager._constructor_.md +49 -0
  218. package/build/docs/ibm-cloud-sdk-core.tokenmanager.accesstoken.md +11 -0
  219. package/build/docs/ibm-cloud-sdk-core.tokenmanager.disablesslverification.md +11 -0
  220. package/build/docs/ibm-cloud-sdk-core.tokenmanager.expiretime.md +11 -0
  221. package/build/docs/ibm-cloud-sdk-core.tokenmanager.gettoken.md +17 -0
  222. package/build/docs/ibm-cloud-sdk-core.tokenmanager.headers.md +11 -0
  223. package/build/docs/ibm-cloud-sdk-core.tokenmanager.istokenexpired.md +17 -0
  224. package/build/docs/ibm-cloud-sdk-core.tokenmanager.md +352 -0
  225. package/build/docs/ibm-cloud-sdk-core.tokenmanager.pacedrequesttoken.md +19 -0
  226. package/build/docs/ibm-cloud-sdk-core.tokenmanager.refreshtime.md +11 -0
  227. package/build/docs/ibm-cloud-sdk-core.tokenmanager.requesttoken.md +19 -0
  228. package/build/docs/ibm-cloud-sdk-core.tokenmanager.requestwrapperinstance.md +11 -0
  229. package/build/docs/ibm-cloud-sdk-core.tokenmanager.savetokeninfo.md +53 -0
  230. package/build/docs/ibm-cloud-sdk-core.tokenmanager.setdisablesslverification.md +53 -0
  231. package/build/docs/ibm-cloud-sdk-core.tokenmanager.setheaders.md +53 -0
  232. package/build/docs/ibm-cloud-sdk-core.tokenmanager.url.md +11 -0
  233. package/build/docs/ibm-cloud-sdk-core.tokenmanager.useragent.md +11 -0
  234. package/build/docs/ibm-cloud-sdk-core.tokenmanageroptions.md +18 -0
  235. package/build/docs/ibm-cloud-sdk-core.tokenrequestbasedauthenticator.md +66 -0
  236. package/build/docs/ibm-cloud-sdk-core.tokenrequestbasedauthenticator.setdisablesslverification.md +53 -0
  237. package/build/docs/ibm-cloud-sdk-core.tokenrequestbasedauthenticator.setheaders.md +53 -0
  238. package/build/docs/ibm-cloud-sdk-core.tolowerkeys.md +55 -0
  239. package/build/docs/ibm-cloud-sdk-core.useroptions.authenticator.md +13 -0
  240. package/build/docs/ibm-cloud-sdk-core.useroptions.disablesslverification.md +13 -0
  241. package/build/docs/ibm-cloud-sdk-core.useroptions.headers.md +13 -0
  242. package/build/docs/ibm-cloud-sdk-core.useroptions.jar.md +13 -0
  243. package/build/docs/ibm-cloud-sdk-core.useroptions.md +171 -0
  244. package/build/docs/ibm-cloud-sdk-core.useroptions.serviceurl.md +13 -0
  245. package/build/docs/ibm-cloud-sdk-core.useroptions.url.md +13 -0
  246. package/build/docs/ibm-cloud-sdk-core.useroptions.version.md +13 -0
  247. package/build/docs/ibm-cloud-sdk-core.validateinput.md +73 -0
  248. package/build/docs/ibm-cloud-sdk-core.validateparams.md +89 -0
  249. package/build/docs/ibm-cloud-sdk-core.vpcinstanceauthenticator._constructor_.md +54 -0
  250. package/build/docs/ibm-cloud-sdk-core.vpcinstanceauthenticator.authenticationtype.md +19 -0
  251. package/build/docs/ibm-cloud-sdk-core.vpcinstanceauthenticator.md +158 -0
  252. package/build/docs/ibm-cloud-sdk-core.vpcinstanceauthenticator.setiamprofilecrn.md +53 -0
  253. package/build/docs/ibm-cloud-sdk-core.vpcinstanceauthenticator.setiamprofileid.md +53 -0
  254. package/build/docs/ibm-cloud-sdk-core.vpcinstanceauthenticator.tokenmanager.md +11 -0
  255. package/build/docs/ibm-cloud-sdk-core.vpcinstancetokenmanager._constructor_.md +54 -0
  256. package/build/docs/ibm-cloud-sdk-core.vpcinstancetokenmanager.istokenexpired.md +19 -0
  257. package/build/docs/ibm-cloud-sdk-core.vpcinstancetokenmanager.md +126 -0
  258. package/build/docs/ibm-cloud-sdk-core.vpcinstancetokenmanager.requesttoken.md +15 -0
  259. package/build/docs/ibm-cloud-sdk-core.vpcinstancetokenmanager.setiamprofilecrn.md +53 -0
  260. package/build/docs/ibm-cloud-sdk-core.vpcinstancetokenmanager.setiamprofileid.md +53 -0
  261. package/build/docs/index.md +29 -0
  262. package/docs/ibm-cloud-sdk-core.api.json +787 -404
  263. package/es/auth/authenticators/authenticator.d.ts +1 -0
  264. package/es/auth/authenticators/authenticator.js +1 -0
  265. package/es/auth/authenticators/container-authenticator.d.ts +6 -0
  266. package/es/auth/authenticators/container-authenticator.js +8 -0
  267. package/es/auth/authenticators/iam-assume-authenticator.d.ts +82 -0
  268. package/es/auth/authenticators/iam-assume-authenticator.js +70 -0
  269. package/es/auth/authenticators/iam-authenticator.d.ts +6 -0
  270. package/es/auth/authenticators/iam-authenticator.js +8 -0
  271. package/es/auth/authenticators/iam-request-based-authenticator-immutable.d.ts +64 -0
  272. package/es/auth/authenticators/iam-request-based-authenticator-immutable.js +51 -0
  273. package/es/auth/authenticators/iam-request-based-authenticator.d.ts +19 -47
  274. package/es/auth/authenticators/iam-request-based-authenticator.js +26 -35
  275. package/es/auth/authenticators/index.d.ts +4 -1
  276. package/es/auth/authenticators/index.js +1 -0
  277. package/es/auth/authenticators/token-request-based-authenticator-immutable.d.ts +71 -0
  278. package/es/auth/authenticators/token-request-based-authenticator-immutable.js +65 -0
  279. package/es/auth/authenticators/token-request-based-authenticator.d.ts +4 -42
  280. package/es/auth/authenticators/token-request-based-authenticator.js +3 -39
  281. package/es/auth/token-managers/container-token-manager.d.ts +6 -0
  282. package/es/auth/token-managers/container-token-manager.js +18 -24
  283. package/es/auth/token-managers/iam-assume-token-manager.d.ts +101 -0
  284. package/es/auth/token-managers/iam-assume-token-manager.js +164 -0
  285. package/es/auth/token-managers/iam-request-based-token-manager.d.ts +3 -9
  286. package/es/auth/token-managers/iam-request-based-token-manager.js +0 -8
  287. package/es/auth/token-managers/iam-token-manager.d.ts +8 -2
  288. package/es/auth/token-managers/iam-token-manager.js +10 -2
  289. package/es/auth/token-managers/index.d.ts +4 -2
  290. package/es/auth/token-managers/index.js +4 -2
  291. package/es/auth/utils/get-authenticator-from-environment.js +4 -1
  292. package/es/auth/utils/helpers.d.ts +18 -23
  293. package/es/auth/utils/helpers.js +35 -27
  294. package/es/tsdoc-metadata.json +11 -0
  295. package/etc/ibm-cloud-sdk-core.api.md +46 -28
  296. package/ibm-cloud-sdk-core.d.ts +264 -68
  297. package/package.json +2 -2
  298. package/temp/ibm-cloud-sdk-core.api.json +8646 -0
  299. package/temp/ibm-cloud-sdk-core.api.md +505 -0
@@ -0,0 +1,505 @@
1
+ ## API Report File for "ibm-cloud-sdk-core"
2
+
3
+ > Do not edit this file. It is a report generated by [API Extractor](https://api-extractor.com/).
4
+
5
+ ```ts
6
+
7
+ /// <reference types="node" />
8
+
9
+ import { AxiosInstance } from 'axios';
10
+ import type { CookieJar } from 'tough-cookie';
11
+ import { Debugger } from 'debug';
12
+ import { OutgoingHttpHeaders } from 'http';
13
+ import { Stream } from 'stream';
14
+
15
+ // @public
16
+ export function atLeastOne(...args: any): boolean;
17
+
18
+ // @public
19
+ export function atMostOne(...args: any): boolean;
20
+
21
+ // @public
22
+ export class Authenticator implements AuthenticatorInterface {
23
+ constructor();
24
+ // Warning: (ae-forgotten-export) The symbol "AuthenticateOptions" needs to be exported by the entry point index.d.ts
25
+ authenticate(requestOptions: AuthenticateOptions): Promise<void>;
26
+ authenticationType(): string;
27
+ static AUTHTYPE_BASIC: string;
28
+ // (undocumented)
29
+ static AUTHTYPE_BEARERTOKEN: string;
30
+ // (undocumented)
31
+ static AUTHTYPE_CONTAINER: string;
32
+ // (undocumented)
33
+ static AUTHTYPE_CP4D: string;
34
+ // (undocumented)
35
+ static AUTHTYPE_IAM: string;
36
+ // (undocumented)
37
+ static AUTHTYPE_IAM_ASSUME: string;
38
+ // (undocumented)
39
+ static AUTHTYPE_MCSP: string;
40
+ // (undocumented)
41
+ static AUTHTYPE_NOAUTH: string;
42
+ // (undocumented)
43
+ static AUTHTYPE_UNKNOWN: string;
44
+ // (undocumented)
45
+ static AUTHTYPE_VPC: string;
46
+ }
47
+
48
+ // @public
49
+ export interface AuthenticatorInterface {
50
+ authenticate(requestOptions: AuthenticateOptions): Promise<void>;
51
+ authenticationType(): string;
52
+ }
53
+
54
+ // @public
55
+ export class BaseService {
56
+ constructor(userOptions: UserOptions);
57
+ // Warning: (ae-forgotten-export) The symbol "BaseServiceOptions" needs to be exported by the entry point index.d.ts
58
+ //
59
+ // (undocumented)
60
+ protected baseOptions: BaseServiceOptions;
61
+ protected configureService(serviceName: string): void;
62
+ static convertModel(input: any, converterFn: any, isMap?: boolean): any;
63
+ protected createRequest(parameters: any): Promise<any>;
64
+ protected createRequestAndDeserializeResponse(parameters: any, deserializerFn: (any: any) => any, isMap?: boolean): Promise<any>;
65
+ // (undocumented)
66
+ static DEFAULT_SERVICE_NAME: string;
67
+ // (undocumented)
68
+ static DEFAULT_SERVICE_URL: string;
69
+ disableRetries(): void;
70
+ // Warning: (ae-forgotten-export) The symbol "RetryOptions" needs to be exported by the entry point index.d.ts
71
+ enableRetries(retryOptions?: RetryOptions): void;
72
+ getAuthenticator(): any;
73
+ getHttpClient(): AxiosInstance;
74
+ setDefaultHeaders(headers: OutgoingHttpHeaders): void;
75
+ setEnableGzipCompression(setting: boolean): void;
76
+ setServiceUrl(url: string): void;
77
+ }
78
+
79
+ // @public
80
+ export class BasicAuthenticator extends Authenticator {
81
+ // Warning: (ae-forgotten-export) The symbol "Options" needs to be exported by the entry point index.d.ts
82
+ constructor(options: Options);
83
+ authenticate(requestOptions: AuthenticateOptions): Promise<void>;
84
+ authenticationType(): string;
85
+ // (undocumented)
86
+ protected authHeader: {
87
+ Authorization: string;
88
+ };
89
+ // (undocumented)
90
+ protected requiredOptions: string[];
91
+ }
92
+
93
+ // @public
94
+ export class BearerTokenAuthenticator extends Authenticator {
95
+ // Warning: (ae-forgotten-export) The symbol "Options_2" needs to be exported by the entry point index.d.ts
96
+ constructor(options: Options_2);
97
+ authenticate(requestOptions: AuthenticateOptions): Promise<void>;
98
+ authenticationType(): string;
99
+ // (undocumented)
100
+ protected requiredOptions: string[];
101
+ setBearerToken(bearerToken: string): void;
102
+ }
103
+
104
+ // @public
105
+ export function buildRequestFileObject(fileParam: FileWithMetadata): Promise<FileObject>;
106
+
107
+ // @public
108
+ export function checkCredentials(obj: any, credsToCheck: string[]): Error | null;
109
+
110
+ // @public
111
+ export class CloudPakForDataAuthenticator extends TokenRequestBasedAuthenticator {
112
+ // Warning: (ae-forgotten-export) The symbol "Options_4" needs to be exported by the entry point index.d.ts
113
+ constructor(options: Options_4);
114
+ authenticationType(): string;
115
+ // (undocumented)
116
+ protected requiredOptions: string[];
117
+ // (undocumented)
118
+ protected tokenManager: Cp4dTokenManager;
119
+ }
120
+
121
+ // @public
122
+ export function computeBasicAuthHeader(username: string, password: string): string;
123
+
124
+ // @public (undocumented)
125
+ export function constructFilepath(filepath: string): string;
126
+
127
+ // @public
128
+ export function constructServiceUrl(parameterizedUrl: string, defaultUrlVariables: Map<string, string>, providedUrlVariables: Map<string, string> | null): string;
129
+
130
+ // @public
131
+ export class ContainerAuthenticator extends IamRequestBasedAuthenticator {
132
+ // Warning: (ae-forgotten-export) The symbol "Options_8" needs to be exported by the entry point index.d.ts
133
+ constructor(options: Options_8);
134
+ authenticationType(): string;
135
+ getRefreshToken(): string;
136
+ setCrTokenFilename(crTokenFilename: string): void;
137
+ setIamProfileId(iamProfileId: string): void;
138
+ setIamProfileName(iamProfileName: string): void;
139
+ // (undocumented)
140
+ protected tokenManager: ContainerTokenManager;
141
+ }
142
+
143
+ // @public
144
+ export class ContainerTokenManager extends IamRequestBasedTokenManager {
145
+ // Warning: (ae-forgotten-export) The symbol "Options_7" needs to be exported by the entry point index.d.ts
146
+ constructor(options: Options_7);
147
+ protected getCrToken(): string;
148
+ getRefreshToken(): string;
149
+ protected requestToken(): Promise<any>;
150
+ setCrTokenFilename(crTokenFilename: string): void;
151
+ setIamProfileId(iamProfileId: string): void;
152
+ setIamProfileName(iamProfileName: string): void;
153
+ }
154
+
155
+ // @public (undocumented)
156
+ export const contentType: {
157
+ fromFilename: (file: String | File | FileObject | NodeJS.ReadableStream | Buffer) => string;
158
+ fromHeader: (buffer: Buffer) => string;
159
+ };
160
+
161
+ // @public
162
+ export class Cp4dTokenManager extends JwtTokenManager {
163
+ // Warning: (ae-forgotten-export) The symbol "Options_3" needs to be exported by the entry point index.d.ts
164
+ constructor(options: Options_3);
165
+ // (undocumented)
166
+ protected requestToken(): Promise<any>;
167
+ // (undocumented)
168
+ protected requiredOptions: string[];
169
+ }
170
+
171
+ // @public (undocumented)
172
+ export function fileExistsAtPath(filepath: string): boolean;
173
+
174
+ // @public
175
+ export interface FileObject {
176
+ // (undocumented)
177
+ options?: FileOptions;
178
+ // (undocumented)
179
+ value: NodeJS.ReadableStream | Buffer | string;
180
+ }
181
+
182
+ // @public (undocumented)
183
+ export interface FileOptions {
184
+ // (undocumented)
185
+ contentType?: string;
186
+ // (undocumented)
187
+ filename?: string;
188
+ }
189
+
190
+ // @public (undocumented)
191
+ export interface FileStream extends NodeJS.ReadableStream {
192
+ // (undocumented)
193
+ path: string | Buffer;
194
+ }
195
+
196
+ // @public (undocumented)
197
+ export interface FileWithMetadata {
198
+ // (undocumented)
199
+ contentType: string;
200
+ // (undocumented)
201
+ data: NodeJS.ReadableStream | Buffer;
202
+ // (undocumented)
203
+ filename: string;
204
+ }
205
+
206
+ // @public
207
+ export function getAuthenticatorFromEnvironment(serviceName: string): Authenticator;
208
+
209
+ // @public
210
+ export function getContentType(inputData: NodeJS.ReadableStream | Buffer): Promise<string>;
211
+
212
+ // @public
213
+ export function getCurrentTime(): number;
214
+
215
+ // @public
216
+ export function getFormat(params: {
217
+ [key: string]: any;
218
+ }, formats: string[]): string;
219
+
220
+ // @public
221
+ export function getMissingParams(params: {
222
+ [key: string]: any;
223
+ }, requires: string[]): null | Error;
224
+
225
+ // @public
226
+ export function getNewLogger(moduleName: string): SDKLogger;
227
+
228
+ // @public
229
+ export function getQueryParam(urlStr: string, param: string): string;
230
+
231
+ // Warning: (ae-forgotten-export) The symbol "IamRequestBasedAuthenticatorImmutable" needs to be exported by the entry point index.d.ts
232
+ //
233
+ // @public
234
+ export class IamAssumeAuthenticator extends IamRequestBasedAuthenticatorImmutable {
235
+ // Warning: (ae-forgotten-export) The symbol "Options_14" needs to be exported by the entry point index.d.ts
236
+ constructor(options: Options_14);
237
+ authenticationType(): string;
238
+ // (undocumented)
239
+ protected tokenManager: IamAssumeTokenManager;
240
+ }
241
+
242
+ // @public
243
+ export class IamAssumeTokenManager extends IamRequestBasedTokenManager {
244
+ // Warning: (ae-forgotten-export) The symbol "Options_13" needs to be exported by the entry point index.d.ts
245
+ constructor(options: Options_13);
246
+ protected requestToken(): Promise<any>;
247
+ // (undocumented)
248
+ protected requiredOptions: string[];
249
+ protected saveTokenInfo(tokenResponse: any): void;
250
+ setClientIdAndSecret(clientId: string, clientSecret: string): void;
251
+ setDisableSslVerification(value: boolean): void;
252
+ setHeaders(headers: OutgoingHttpHeaders): void;
253
+ setScope(scope: string): void;
254
+ }
255
+
256
+ // @public
257
+ export class IamAuthenticator extends IamRequestBasedAuthenticator {
258
+ // Warning: (ae-forgotten-export) The symbol "Options_6" needs to be exported by the entry point index.d.ts
259
+ constructor(options: Options_6);
260
+ authenticationType(): string;
261
+ getRefreshToken(): string;
262
+ // (undocumented)
263
+ protected requiredOptions: string[];
264
+ // (undocumented)
265
+ protected tokenManager: IamTokenManager;
266
+ }
267
+
268
+ // @public
269
+ export class IamRequestBasedAuthenticator extends IamRequestBasedAuthenticatorImmutable {
270
+ setClientIdAndSecret(clientId: string, clientSecret: string): void;
271
+ setDisableSslVerification(value: boolean): void;
272
+ setHeaders(headers: OutgoingHttpHeaders): void;
273
+ setScope(scope: string): void;
274
+ }
275
+
276
+ // @public
277
+ export class IamRequestBasedTokenManager extends JwtTokenManager {
278
+ constructor(options: IamRequestOptions);
279
+ // (undocumented)
280
+ protected clientId: string;
281
+ // (undocumented)
282
+ protected clientSecret: string;
283
+ // (undocumented)
284
+ protected formData: any;
285
+ protected isTokenExpired(): boolean;
286
+ // (undocumented)
287
+ protected refreshToken: string;
288
+ protected requestToken(): Promise<any>;
289
+ protected saveTokenInfo(tokenResponse: any): void;
290
+ // (undocumented)
291
+ protected scope: string;
292
+ setClientIdAndSecret(clientId: string, clientSecret: string): void;
293
+ setScope(scope: string): void;
294
+ }
295
+
296
+ // @public
297
+ export interface IamRequestOptions extends JwtTokenManagerOptions {
298
+ // (undocumented)
299
+ clientId?: string;
300
+ // (undocumented)
301
+ clientSecret?: string;
302
+ // (undocumented)
303
+ scope?: string;
304
+ }
305
+
306
+ // @public
307
+ export class IamTokenManager extends IamRequestBasedTokenManager {
308
+ // Warning: (ae-forgotten-export) The symbol "Options_5" needs to be exported by the entry point index.d.ts
309
+ constructor(options: Options_5);
310
+ getRefreshToken(): string;
311
+ // (undocumented)
312
+ protected requiredOptions: string[];
313
+ }
314
+
315
+ // @public (undocumented)
316
+ export function isEmptyObject(obj: any): boolean;
317
+
318
+ // @public (undocumented)
319
+ export function isFileData(obj: any): obj is NodeJS.ReadableStream | Buffer;
320
+
321
+ // @public (undocumented)
322
+ export function isFileWithMetadata(obj: any): obj is FileWithMetadata;
323
+
324
+ // @public
325
+ export function isHTML(text: string): boolean;
326
+
327
+ // @public
328
+ export function isJsonMimeType(mimeType: string): boolean;
329
+
330
+ // @public
331
+ export class JwtTokenManager extends TokenManager {
332
+ constructor(options: JwtTokenManagerOptions);
333
+ protected requestToken(): Promise<any>;
334
+ protected saveTokenInfo(tokenResponse: any): void;
335
+ // (undocumented)
336
+ protected tokenInfo: any;
337
+ // (undocumented)
338
+ protected tokenName: string;
339
+ }
340
+
341
+ // @public
342
+ export type JwtTokenManagerOptions = TokenManagerOptions;
343
+
344
+ // @public
345
+ export class McspAuthenticator extends TokenRequestBasedAuthenticator {
346
+ // Warning: (ae-forgotten-export) The symbol "Options_12" needs to be exported by the entry point index.d.ts
347
+ constructor(options: Options_12);
348
+ authenticationType(): string;
349
+ // (undocumented)
350
+ protected requiredOptions: string[];
351
+ // (undocumented)
352
+ protected tokenManager: McspTokenManager;
353
+ }
354
+
355
+ // @public
356
+ export class McspTokenManager extends JwtTokenManager {
357
+ // Warning: (ae-forgotten-export) The symbol "Options_11" needs to be exported by the entry point index.d.ts
358
+ constructor(options: Options_11);
359
+ // (undocumented)
360
+ protected requestToken(): Promise<any>;
361
+ // (undocumented)
362
+ protected requiredOptions: string[];
363
+ }
364
+
365
+ // @public
366
+ export class NoAuthAuthenticator extends Authenticator {
367
+ // (undocumented)
368
+ authenticate(requestOptions: AuthenticateOptions): Promise<void>;
369
+ authenticationType(): string;
370
+ }
371
+
372
+ // @public
373
+ export function onlyOne(...args: any): boolean;
374
+
375
+ // @public
376
+ export const qs: {
377
+ stringify: (queryParams: Object) => string;
378
+ };
379
+
380
+ // @public
381
+ export function readCredentialsFile(): any;
382
+
383
+ // @public (undocumented)
384
+ export function readCrTokenFile(filepath: string): string;
385
+
386
+ // @public
387
+ export function readExternalSources(serviceName: string): any;
388
+
389
+ // @public
390
+ export function removeSuffix(str: string, suffix: string): string;
391
+
392
+ // @public (undocumented)
393
+ export interface SDKLogger {
394
+ // (undocumented)
395
+ debug: Debugger;
396
+ // (undocumented)
397
+ error: Debugger;
398
+ // (undocumented)
399
+ info: Debugger;
400
+ // (undocumented)
401
+ verbose: Debugger;
402
+ // (undocumented)
403
+ warn: Debugger;
404
+ }
405
+
406
+ // @public
407
+ export function streamToPromise(stream: Stream): Promise<any>;
408
+
409
+ // @public
410
+ export function stripTrailingSlash(url: string): string;
411
+
412
+ // @public
413
+ export class TokenManager {
414
+ constructor(options: TokenManagerOptions);
415
+ // (undocumented)
416
+ protected accessToken: string;
417
+ // (undocumented)
418
+ protected disableSslVerification: boolean;
419
+ // (undocumented)
420
+ protected expireTime: number;
421
+ getToken(): Promise<any>;
422
+ // (undocumented)
423
+ protected headers: OutgoingHttpHeaders;
424
+ protected isTokenExpired(): boolean;
425
+ protected pacedRequestToken(): Promise<any>;
426
+ // (undocumented)
427
+ protected refreshTime: number;
428
+ protected requestToken(): Promise<any>;
429
+ // Warning: (ae-forgotten-export) The symbol "RequestWrapper" needs to be exported by the entry point index.d.ts
430
+ //
431
+ // (undocumented)
432
+ protected requestWrapperInstance: RequestWrapper;
433
+ protected saveTokenInfo(tokenResponse: any): void;
434
+ setDisableSslVerification(value: boolean): void;
435
+ setHeaders(headers: OutgoingHttpHeaders): void;
436
+ // (undocumented)
437
+ protected url: string;
438
+ // (undocumented)
439
+ protected userAgent: string;
440
+ }
441
+
442
+ // @public
443
+ export type TokenManagerOptions = {
444
+ url?: string;
445
+ headers?: OutgoingHttpHeaders;
446
+ disableSslVerification?: boolean;
447
+ [propName: string]: any;
448
+ };
449
+
450
+ // Warning: (ae-forgotten-export) The symbol "TokenRequestBasedAuthenticatorImmutable" needs to be exported by the entry point index.d.ts
451
+ //
452
+ // @public
453
+ export class TokenRequestBasedAuthenticator extends TokenRequestBasedAuthenticatorImmutable {
454
+ setDisableSslVerification(value: boolean): void;
455
+ setHeaders(headers: OutgoingHttpHeaders): void;
456
+ }
457
+
458
+ // @public
459
+ export function toLowerKeys(obj: Object): Object;
460
+
461
+ // @public
462
+ export interface UserOptions {
463
+ [propName: string]: any;
464
+ authenticator?: AuthenticatorInterface;
465
+ disableSslVerification?: boolean;
466
+ headers?: OutgoingHttpHeaders;
467
+ jar?: CookieJar | boolean;
468
+ serviceUrl?: string;
469
+ url?: string;
470
+ version?: string;
471
+ }
472
+
473
+ // @public
474
+ export function validateInput(options: any, requiredOptions: string[]): void;
475
+
476
+ // @public
477
+ export function validateParams(params: {
478
+ [key: string]: any;
479
+ }, requiredParams: string[], allParams: string[]): null | Error;
480
+
481
+ // @public
482
+ export class VpcInstanceAuthenticator extends TokenRequestBasedAuthenticator {
483
+ // Warning: (ae-forgotten-export) The symbol "Options_10" needs to be exported by the entry point index.d.ts
484
+ constructor(options: Options_10);
485
+ authenticationType(): string;
486
+ setIamProfileCrn(iamProfileCrn: string): void;
487
+ setIamProfileId(iamProfileId: string): void;
488
+ // (undocumented)
489
+ protected tokenManager: VpcInstanceTokenManager;
490
+ }
491
+
492
+ // @public
493
+ export class VpcInstanceTokenManager extends JwtTokenManager {
494
+ // Warning: (ae-forgotten-export) The symbol "Options_9" needs to be exported by the entry point index.d.ts
495
+ constructor(options: Options_9);
496
+ protected isTokenExpired(): boolean;
497
+ // (undocumented)
498
+ protected requestToken(): Promise<any>;
499
+ setIamProfileCrn(iamProfileCrn: string): void;
500
+ setIamProfileId(iamProfileId: string): void;
501
+ }
502
+
503
+ // (No @packageDocumentation comment for this package)
504
+
505
+ ```