ibm-cloud-sdk-core 3.0.1 → 3.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,3 +1,10 @@
1
+ # [3.1.0](https://github.com/IBM/node-sdk-core/compare/v3.0.1...v3.1.0) (2022-07-28)
2
+
3
+
4
+ ### Features
5
+
6
+ * add `setDefaultHeaders` method on base service class ([#207](https://github.com/IBM/node-sdk-core/issues/207)) ([29bec13](https://github.com/IBM/node-sdk-core/commit/29bec13b67ea08071be488af62b919899f21ec50))
7
+
1
8
  ## [3.0.1](https://github.com/IBM/node-sdk-core/compare/v3.0.0...v3.0.1) (2022-07-28)
2
9
 
3
10
 
@@ -38,6 +38,7 @@ export declare class BaseService
38
38
  | [enableRetries(retryOptions)](./ibm-cloud-sdk-core.baseservice.enableretries.md) | | Enable retries for unfulfilled requests. |
39
39
  | [getAuthenticator()](./ibm-cloud-sdk-core.baseservice.getauthenticator.md) | | Get the instance of the authenticator set on the service. |
40
40
  | [getHttpClient()](./ibm-cloud-sdk-core.baseservice.gethttpclient.md) | | Get the Axios instance set on the service. All requests will be made using this instance. |
41
+ | [setDefaultHeaders(headers)](./ibm-cloud-sdk-core.baseservice.setdefaultheaders.md) | | Set the HTTP headers to be sent in every request. |
41
42
  | [setEnableGzipCompression(setting)](./ibm-cloud-sdk-core.baseservice.setenablegzipcompression.md) | | Turn request body compression on or off. |
42
43
  | [setServiceUrl(url)](./ibm-cloud-sdk-core.baseservice.setserviceurl.md) | | Set the service URL to send requests to. |
43
44
 
@@ -0,0 +1,24 @@
1
+ <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
+
3
+ [Home](./index.md) &gt; [ibm-cloud-sdk-core](./ibm-cloud-sdk-core.md) &gt; [BaseService](./ibm-cloud-sdk-core.baseservice.md) &gt; [setDefaultHeaders](./ibm-cloud-sdk-core.baseservice.setdefaultheaders.md)
4
+
5
+ ## BaseService.setDefaultHeaders() method
6
+
7
+ Set the HTTP headers to be sent in every request.
8
+
9
+ <b>Signature:</b>
10
+
11
+ ```typescript
12
+ setDefaultHeaders(headers: OutgoingHttpHeaders): void;
13
+ ```
14
+
15
+ ## Parameters
16
+
17
+ | Parameter | Type | Description |
18
+ | --- | --- | --- |
19
+ | headers | OutgoingHttpHeaders | The map of headers to include in requests. |
20
+
21
+ <b>Returns:</b>
22
+
23
+ void
24
+
@@ -1088,6 +1088,53 @@
1088
1088
  "parameters": [],
1089
1089
  "name": "getHttpClient"
1090
1090
  },
1091
+ {
1092
+ "kind": "Method",
1093
+ "canonicalReference": "ibm-cloud-sdk-core!BaseService#setDefaultHeaders:member(1)",
1094
+ "docComment": "/**\n * Set the HTTP headers to be sent in every request.\n *\n * @param headers - The map of headers to include in requests.\n */\n",
1095
+ "excerptTokens": [
1096
+ {
1097
+ "kind": "Content",
1098
+ "text": "setDefaultHeaders(headers: "
1099
+ },
1100
+ {
1101
+ "kind": "Reference",
1102
+ "text": "OutgoingHttpHeaders",
1103
+ "canonicalReference": "!\"\\\"http\\\"\".OutgoingHttpHeaders:interface"
1104
+ },
1105
+ {
1106
+ "kind": "Content",
1107
+ "text": "): "
1108
+ },
1109
+ {
1110
+ "kind": "Content",
1111
+ "text": "void"
1112
+ },
1113
+ {
1114
+ "kind": "Content",
1115
+ "text": ";"
1116
+ }
1117
+ ],
1118
+ "isOptional": false,
1119
+ "isStatic": false,
1120
+ "returnTypeTokenRange": {
1121
+ "startIndex": 3,
1122
+ "endIndex": 4
1123
+ },
1124
+ "releaseTag": "Public",
1125
+ "overloadIndex": 1,
1126
+ "parameters": [
1127
+ {
1128
+ "parameterName": "headers",
1129
+ "parameterTypeTokenRange": {
1130
+ "startIndex": 1,
1131
+ "endIndex": 2
1132
+ },
1133
+ "isOptional": false
1134
+ }
1135
+ ],
1136
+ "name": "setDefaultHeaders"
1137
+ },
1091
1138
  {
1092
1139
  "kind": "Method",
1093
1140
  "canonicalReference": "ibm-cloud-sdk-core!BaseService#setEnableGzipCompression:member(1)",
@@ -87,6 +87,12 @@ export declare class BaseService {
87
87
  * @param {string} url The base URL for the service.
88
88
  */
89
89
  setServiceUrl(url: string): void;
90
+ /**
91
+ * Set the HTTP headers to be sent in every request.
92
+ *
93
+ * @param {OutgoingHttpHeaders} headers The map of headers to include in requests.
94
+ */
95
+ setDefaultHeaders(headers: OutgoingHttpHeaders): void;
90
96
  /**
91
97
  * Turn request body compression on or off.
92
98
  *
@@ -90,6 +90,18 @@ export class BaseService {
90
90
  this.baseOptions.serviceUrl = stripTrailingSlash(url);
91
91
  }
92
92
  }
93
+ /**
94
+ * Set the HTTP headers to be sent in every request.
95
+ *
96
+ * @param {OutgoingHttpHeaders} headers The map of headers to include in requests.
97
+ */
98
+ setDefaultHeaders(headers) {
99
+ if (typeof headers !== 'object') {
100
+ // do nothing, for now
101
+ return;
102
+ }
103
+ this.baseOptions.headers = headers;
104
+ }
93
105
  /**
94
106
  * Turn request body compression on or off.
95
107
  *
@@ -64,6 +64,7 @@ export class BaseService {
64
64
  enableRetries(retryOptions?: RetryOptions): void;
65
65
  getAuthenticator(): any;
66
66
  getHttpClient(): AxiosInstance;
67
+ setDefaultHeaders(headers: OutgoingHttpHeaders): void;
67
68
  setEnableGzipCompression(setting: boolean): void;
68
69
  setServiceUrl(url: string): void;
69
70
  }
@@ -158,6 +158,12 @@ export declare class BaseService {
158
158
  * @param {string} url The base URL for the service.
159
159
  */
160
160
  setServiceUrl(url: string): void;
161
+ /**
162
+ * Set the HTTP headers to be sent in every request.
163
+ *
164
+ * @param {OutgoingHttpHeaders} headers The map of headers to include in requests.
165
+ */
166
+ setDefaultHeaders(headers: OutgoingHttpHeaders): void;
161
167
  /**
162
168
  * Turn request body compression on or off.
163
169
  *
@@ -87,6 +87,12 @@ export declare class BaseService {
87
87
  * @param {string} url The base URL for the service.
88
88
  */
89
89
  setServiceUrl(url: string): void;
90
+ /**
91
+ * Set the HTTP headers to be sent in every request.
92
+ *
93
+ * @param {OutgoingHttpHeaders} headers The map of headers to include in requests.
94
+ */
95
+ setDefaultHeaders(headers: OutgoingHttpHeaders): void;
90
96
  /**
91
97
  * Turn request body compression on or off.
92
98
  *
@@ -106,6 +106,18 @@ var BaseService = /** @class */ (function () {
106
106
  this.baseOptions.serviceUrl = helper_1.stripTrailingSlash(url);
107
107
  }
108
108
  };
109
+ /**
110
+ * Set the HTTP headers to be sent in every request.
111
+ *
112
+ * @param {OutgoingHttpHeaders} headers The map of headers to include in requests.
113
+ */
114
+ BaseService.prototype.setDefaultHeaders = function (headers) {
115
+ if (typeof headers !== 'object') {
116
+ // do nothing, for now
117
+ return;
118
+ }
119
+ this.baseOptions.headers = headers;
120
+ };
109
121
  /**
110
122
  * Turn request body compression on or off.
111
123
  *
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "ibm-cloud-sdk-core",
3
- "version": "3.0.1",
3
+ "version": "3.1.0",
4
4
  "description": "Core functionality to support SDKs generated with IBM's OpenAPI SDK Generator.",
5
5
  "main": "index.js",
6
6
  "typings": "./es/index.d.ts",
@@ -1088,6 +1088,53 @@
1088
1088
  "parameters": [],
1089
1089
  "name": "getHttpClient"
1090
1090
  },
1091
+ {
1092
+ "kind": "Method",
1093
+ "canonicalReference": "ibm-cloud-sdk-core!BaseService#setDefaultHeaders:member(1)",
1094
+ "docComment": "/**\n * Set the HTTP headers to be sent in every request.\n *\n * @param headers - The map of headers to include in requests.\n */\n",
1095
+ "excerptTokens": [
1096
+ {
1097
+ "kind": "Content",
1098
+ "text": "setDefaultHeaders(headers: "
1099
+ },
1100
+ {
1101
+ "kind": "Reference",
1102
+ "text": "OutgoingHttpHeaders",
1103
+ "canonicalReference": "!\"\\\"http\\\"\".OutgoingHttpHeaders:interface"
1104
+ },
1105
+ {
1106
+ "kind": "Content",
1107
+ "text": "): "
1108
+ },
1109
+ {
1110
+ "kind": "Content",
1111
+ "text": "void"
1112
+ },
1113
+ {
1114
+ "kind": "Content",
1115
+ "text": ";"
1116
+ }
1117
+ ],
1118
+ "isOptional": false,
1119
+ "isStatic": false,
1120
+ "returnTypeTokenRange": {
1121
+ "startIndex": 3,
1122
+ "endIndex": 4
1123
+ },
1124
+ "releaseTag": "Public",
1125
+ "overloadIndex": 1,
1126
+ "parameters": [
1127
+ {
1128
+ "parameterName": "headers",
1129
+ "parameterTypeTokenRange": {
1130
+ "startIndex": 1,
1131
+ "endIndex": 2
1132
+ },
1133
+ "isOptional": false
1134
+ }
1135
+ ],
1136
+ "name": "setDefaultHeaders"
1137
+ },
1091
1138
  {
1092
1139
  "kind": "Method",
1093
1140
  "canonicalReference": "ibm-cloud-sdk-core!BaseService#setEnableGzipCompression:member(1)",
@@ -64,6 +64,7 @@ export class BaseService {
64
64
  enableRetries(retryOptions?: RetryOptions): void;
65
65
  getAuthenticator(): any;
66
66
  getHttpClient(): AxiosInstance;
67
+ setDefaultHeaders(headers: OutgoingHttpHeaders): void;
67
68
  setEnableGzipCompression(setting: boolean): void;
68
69
  setServiceUrl(url: string): void;
69
70
  }