ibm-cloud-sdk-core 3.1.0 → 3.2.1

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+## [3.2.1](https://github.com/IBM/node-sdk-core/compare/v3.2.0...v3.2.1) (2022-10-21)
+
+
+### Bug Fixes
+
+* allow for synchronous building of file requests ([#211](https://github.com/IBM/node-sdk-core/issues/211)) ([dcce4ea](https://github.com/IBM/node-sdk-core/commit/dcce4ea78189e4619cde2d736436a30128cf4b59))
+
+# [3.2.0](https://github.com/IBM/node-sdk-core/compare/v3.1.0...v3.2.0) (2022-10-12)
+
+
+### Features
+
+* add method `getNewLogger` to public API ([#210](https://github.com/IBM/node-sdk-core/issues/210)) ([07b99de](https://github.com/IBM/node-sdk-core/commit/07b99def47a0eb5fcb1ab3d88b2eb3bd271b8819))
+
 # [3.1.0](https://github.com/IBM/node-sdk-core/compare/v3.0.1...v3.1.0) (2022-07-28)
 
 

package/build/docs/ibm-cloud-sdk-core.getnewlogger.md

@@ -0,0 +1,30 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [ibm-cloud-sdk-core](./ibm-cloud-sdk-core.md) &gt; [getNewLogger](./ibm-cloud-sdk-core.getnewlogger.md)
+
+## getNewLogger() function
+
+Return a new logger, formatted with a particular name. The logging functions, in order of increasing verbosity, are: `error`<!-- -->, `warn`<!-- -->, `info`<!-- -->, `verbose`<!-- -->, and `debug`<!-- -->.
+
+The logger will be an instance of the `debug` package and utilizes its support for configuration with environment variables.
+
+Additionally, the logger will be turned on automatically if the "NODE\_DEBUG" environment variable is set to "axios".
+
+<b>Signature:</b>
+
+```typescript
+export declare function getNewLogger(moduleName: string): SDKLogger;
+```
+
+## Parameters
+
+|  Parameter | Type | Description |
+|  --- | --- | --- |
+|  moduleName | string | the namespace for the logger. The name will appear in the logs and it will be the name used for configuring the log level. |
+
+<b>Returns:</b>
+
+[SDKLogger](./ibm-cloud-sdk-core.sdklogger.md)
+
+{<!-- -->SDKLogger<!-- -->} the new logger
+

package/build/docs/ibm-cloud-sdk-core.md

@@ -44,6 +44,7 @@
 |  [getCurrentTime()](./ibm-cloud-sdk-core.getcurrenttime.md) | Get the current time |
 |  [getFormat(params, formats)](./ibm-cloud-sdk-core.getformat.md) | Returns the first match from formats that is key the params map otherwise null |
 |  [getMissingParams(params, requires)](./ibm-cloud-sdk-core.getmissingparams.md) | Validates that all required params are provided |
+|  [getNewLogger(moduleName)](./ibm-cloud-sdk-core.getnewlogger.md) | Return a new logger, formatted with a particular name. The logging functions, in order of increasing verbosity, are: <code>error</code>, <code>warn</code>, <code>info</code>, <code>verbose</code>, and <code>debug</code>.<!-- -->The logger will be an instance of the <code>debug</code> package and utilizes its support for configuration with environment variables.<!-- -->Additionally, the logger will be turned on automatically if the "NODE\_DEBUG" environment variable is set to "axios". |
 |  [getQueryParam(urlStr, param)](./ibm-cloud-sdk-core.getqueryparam.md) | Return a query parameter value from a URL |
 |  [isEmptyObject(obj)](./ibm-cloud-sdk-core.isemptyobject.md) |  |
 |  [isFileData(obj)](./ibm-cloud-sdk-core.isfiledata.md) |  |
@@ -70,6 +71,7 @@
 |  [FileStream](./ibm-cloud-sdk-core.filestream.md) |  |
 |  [FileWithMetadata](./ibm-cloud-sdk-core.filewithmetadata.md) |  |
 |  [IamRequestOptions](./ibm-cloud-sdk-core.iamrequestoptions.md) | Configuration options for IAM token retrieval. |
+|  [SDKLogger](./ibm-cloud-sdk-core.sdklogger.md) |  |
 |  [UserOptions](./ibm-cloud-sdk-core.useroptions.md) | Configuration values for a service. |
 
 ## Namespaces

package/build/docs/ibm-cloud-sdk-core.sdklogger.debug.md

@@ -0,0 +1,11 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [ibm-cloud-sdk-core](./ibm-cloud-sdk-core.md) &gt; [SDKLogger](./ibm-cloud-sdk-core.sdklogger.md) &gt; [debug](./ibm-cloud-sdk-core.sdklogger.debug.md)
+
+## SDKLogger.debug property
+
+<b>Signature:</b>
+
+```typescript
+debug: Debugger;
+```

package/build/docs/ibm-cloud-sdk-core.sdklogger.error.md

@@ -0,0 +1,11 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [ibm-cloud-sdk-core](./ibm-cloud-sdk-core.md) &gt; [SDKLogger](./ibm-cloud-sdk-core.sdklogger.md) &gt; [error](./ibm-cloud-sdk-core.sdklogger.error.md)
+
+## SDKLogger.error property
+
+<b>Signature:</b>
+
+```typescript
+error: Debugger;
+```

package/build/docs/ibm-cloud-sdk-core.sdklogger.info.md

@@ -0,0 +1,11 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [ibm-cloud-sdk-core](./ibm-cloud-sdk-core.md) &gt; [SDKLogger](./ibm-cloud-sdk-core.sdklogger.md) &gt; [info](./ibm-cloud-sdk-core.sdklogger.info.md)
+
+## SDKLogger.info property
+
+<b>Signature:</b>
+
+```typescript
+info: Debugger;
+```

package/build/docs/ibm-cloud-sdk-core.sdklogger.md

@@ -0,0 +1,22 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [ibm-cloud-sdk-core](./ibm-cloud-sdk-core.md) &gt; [SDKLogger](./ibm-cloud-sdk-core.sdklogger.md)
+
+## SDKLogger interface
+
+<b>Signature:</b>
+
+```typescript
+export interface SDKLogger 
+```
+
+## Properties
+
+|  Property | Type | Description |
+|  --- | --- | --- |
+|  [debug](./ibm-cloud-sdk-core.sdklogger.debug.md) | Debugger |  |
+|  [error](./ibm-cloud-sdk-core.sdklogger.error.md) | Debugger |  |
+|  [info](./ibm-cloud-sdk-core.sdklogger.info.md) | Debugger |  |
+|  [verbose](./ibm-cloud-sdk-core.sdklogger.verbose.md) | Debugger |  |
+|  [warn](./ibm-cloud-sdk-core.sdklogger.warn.md) | Debugger |  |
+

package/build/docs/ibm-cloud-sdk-core.sdklogger.verbose.md

@@ -0,0 +1,11 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [ibm-cloud-sdk-core](./ibm-cloud-sdk-core.md) &gt; [SDKLogger](./ibm-cloud-sdk-core.sdklogger.md) &gt; [verbose](./ibm-cloud-sdk-core.sdklogger.verbose.md)
+
+## SDKLogger.verbose property
+
+<b>Signature:</b>
+
+```typescript
+verbose: Debugger;
+```

package/build/docs/ibm-cloud-sdk-core.sdklogger.warn.md

@@ -0,0 +1,11 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [ibm-cloud-sdk-core](./ibm-cloud-sdk-core.md) &gt; [SDKLogger](./ibm-cloud-sdk-core.sdklogger.md) &gt; [warn](./ibm-cloud-sdk-core.sdklogger.warn.md)
+
+## SDKLogger.warn property
+
+<b>Signature:</b>
+
+```typescript
+warn: Debugger;
+```

package/docs/ibm-cloud-sdk-core.api.json

@@ -3402,6 +3402,51 @@
           ],
           "name": "getMissingParams"
         },
+        {
+          "kind": "Function",
+          "canonicalReference": "ibm-cloud-sdk-core!getNewLogger:function(1)",
+          "docComment": "/**\n * Return a new logger, formatted with a particular name. The logging functions, in order of increasing verbosity, are: `error`, `warn`, `info`, `verbose`, and `debug`.\n *\n * The logger will be an instance of the `debug` package and utilizes its support for configuration with environment variables.\n *\n * Additionally, the logger will be turned on automatically if the \"NODE_DEBUG\" environment variable is set to \"axios\".\n *\n * @param moduleName - the namespace for the logger. The name will appear in the logs and it will be the name used for configuring the log level.\n *\n * @returns {SDKLogger} the new logger\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function getNewLogger(moduleName: "
+            },
+            {
+              "kind": "Content",
+              "text": "string"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Reference",
+              "text": "SDKLogger",
+              "canonicalReference": "ibm-cloud-sdk-core!SDKLogger:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "returnTypeTokenRange": {
+            "startIndex": 3,
+            "endIndex": 4
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "moduleName",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isOptional": false
+            }
+          ],
+          "name": "getNewLogger"
+        },
         {
           "kind": "Function",
           "canonicalReference": "ibm-cloud-sdk-core!getQueryParam:function(1)",
@@ -5243,6 +5288,157 @@
           ],
           "name": "removeSuffix"
         },
+        {
+          "kind": "Interface",
+          "canonicalReference": "ibm-cloud-sdk-core!SDKLogger:interface",
+          "docComment": "",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface SDKLogger "
+            }
+          ],
+          "releaseTag": "Public",
+          "name": "SDKLogger",
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "ibm-cloud-sdk-core!SDKLogger#debug:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "debug: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Debugger",
+                  "canonicalReference": "@types/debug!~debug.Debugger:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "debug",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "ibm-cloud-sdk-core!SDKLogger#error:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "error: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Debugger",
+                  "canonicalReference": "@types/debug!~debug.Debugger:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "error",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "ibm-cloud-sdk-core!SDKLogger#info:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "info: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Debugger",
+                  "canonicalReference": "@types/debug!~debug.Debugger:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "info",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "ibm-cloud-sdk-core!SDKLogger#verbose:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "verbose: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Debugger",
+                  "canonicalReference": "@types/debug!~debug.Debugger:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "verbose",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "ibm-cloud-sdk-core!SDKLogger#warn:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "warn: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Debugger",
+                  "canonicalReference": "@types/debug!~debug.Debugger:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "warn",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
         {
           "kind": "Function",
           "canonicalReference": "ibm-cloud-sdk-core!streamToPromise:function(1)",

package/es/index.d.ts

@@ -24,3 +24,4 @@ export { default as qs } from './lib/querystring';
 export { default as contentType } from './lib/content-type';
 export * from './lib/stream-to-promise';
 export { unitTestUtils };
+export { getNewLogger, SDKLogger } from './lib/get-new-logger';

package/es/index.js

@@ -24,3 +24,4 @@ export { default as qs } from './lib/querystring';
 export { default as contentType } from './lib/content-type';
 export * from './lib/stream-to-promise';
 export { unitTestUtils };
+export { getNewLogger } from './lib/get-new-logger';

package/es/lib/get-new-logger.d.ts

@@ -0,0 +1,39 @@
+/**
+ * (C) Copyright IBM Corp. 2022.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { Debugger } from 'debug';
+export interface SDKLogger {
+    error: Debugger;
+    warn: Debugger;
+    info: Debugger;
+    verbose: Debugger;
+    debug: Debugger;
+}
+/**
+ * Return a new logger, formatted with a particular name. The logging functions, in
+ * order of increasing verbosity, are: `error`, `warn`, `info`, `verbose`, and `debug`.
+ *
+ * The logger will be an instance of the `debug` package and utilizes its support for
+ * configuration with environment variables.
+ *
+ * Additionally, the logger will be turned on automatically if the "NODE_DEBUG"
+ * environment variable is set to "axios".
+ *
+ * @param {string} moduleName - the namespace for the logger. The name will appear in
+ * the logs and it will be the name used for configuring the log level.
+ *
+ * @returns {SDKLogger} the new logger
+ */
+export declare function getNewLogger(moduleName: string): SDKLogger;

package/es/lib/get-new-logger.js

@@ -0,0 +1,62 @@
+/**
+ * (C) Copyright IBM Corp. 2022.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import logger from 'debug';
+/**
+ * Return a new logger, formatted with a particular name. The logging functions, in
+ * order of increasing verbosity, are: `error`, `warn`, `info`, `verbose`, and `debug`.
+ *
+ * The logger will be an instance of the `debug` package and utilizes its support for
+ * configuration with environment variables.
+ *
+ * Additionally, the logger will be turned on automatically if the "NODE_DEBUG"
+ * environment variable is set to "axios".
+ *
+ * @param {string} moduleName - the namespace for the logger. The name will appear in
+ * the logs and it will be the name used for configuring the log level.
+ *
+ * @returns {SDKLogger} the new logger
+ */
+export function getNewLogger(moduleName) {
+    const debug = logger(`${moduleName}:debug`);
+    const error = logger(`${moduleName}:error`);
+    const info = logger(`${moduleName}:info`);
+    const verbose = logger(`${moduleName}:verbose`);
+    const warn = logger(`${moduleName}:warning`);
+    // enable loggers if axios flag is set & mimic log levels severity
+    if (process.env.NODE_DEBUG === 'axios') {
+        debug.enabled = true;
+    }
+    if (debug.enabled) {
+        verbose.enabled = true;
+    }
+    if (verbose.enabled) {
+        info.enabled = true;
+    }
+    if (info.enabled) {
+        warn.enabled = true;
+    }
+    if (warn.enabled) {
+        error.enabled = true;
+    }
+    const newLogger = {
+        debug,
+        error,
+        info,
+        verbose,
+        warn,
+    };
+    return newLogger;
+}

package/es/lib/logger.d.ts

@@ -1,5 +1,5 @@
 /**
- * (C) Copyright IBM Corp. 2019, 2021.
+ * (C) Copyright IBM Corp. 2019, 2022.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -13,12 +13,5 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import logger from 'debug';
-declare const _default: {
-    debug: logger.Debugger;
-    error: logger.Debugger;
-    info: logger.Debugger;
-    verbose: logger.Debugger;
-    warn: logger.Debugger;
-};
+declare const _default: import("./get-new-logger").SDKLogger;
 export default _default;

package/es/lib/logger.js

@@ -1,5 +1,5 @@
 /**
- * (C) Copyright IBM Corp. 2019, 2021.
+ * (C) Copyright IBM Corp. 2019, 2022.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -13,33 +13,5 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import logger from 'debug';
-const debug = logger('ibm-cloud-sdk-core:debug');
-const error = logger('ibm-cloud-sdk-core:error');
-const info = logger('ibm-cloud-sdk-core:info');
-const verbose = logger('ibm-cloud-sdk-core:verbose');
-const warn = logger('ibm-cloud-sdk-core:warning');
-// enable loggers if axios flag is set & mimic log levels severity
-if (process.env.NODE_DEBUG === 'axios') {
-    debug.enabled = true;
-}
-if (debug.enabled) {
-    verbose.enabled = true;
-}
-if (verbose.enabled) {
-    info.enabled = true;
-}
-if (info.enabled) {
-    warn.enabled = true;
-}
-if (warn.enabled) {
-    error.enabled = true;
-}
-// export loggers;
-export default {
-    debug,
-    error,
-    info,
-    verbose,
-    warn,
-};
+import { getNewLogger } from './get-new-logger';
+export default getNewLogger('ibm-cloud-sdk-core');

package/es/lib/request-wrapper.js

@@ -130,29 +130,27 @@ export class RequestWrapper {
             const multipartForm = new FormData();
             // Form params
             if (formData) {
-                Object.keys(formData).forEach((key) => {
-                    const values = Array.isArray(formData[key]) ? formData[key] : [formData[key]];
+                for (const key of Object.keys(formData)) { // eslint-disable-line
+                    let values = Array.isArray(formData[key]) ? formData[key] : [formData[key]];
                     // Skip keys with undefined/null values or empty object value
-                    values
-                        .filter((v) => v != null && !isEmptyObject(v))
-                        .forEach((value) => __awaiter(this, void 0, void 0, function* () {
-                        // Special case of empty file object
-                        if (Object.prototype.hasOwnProperty.call(value, 'contentType') &&
-                            !Object.prototype.hasOwnProperty.call(value, 'data')) {
-                            return;
-                        }
-                        if (isFileWithMetadata(value)) {
-                            const fileObj = yield buildRequestFileObject(value);
-                            multipartForm.append(key, fileObj.value, fileObj.options);
-                        }
-                        else {
-                            if (typeof value === 'object' && !isFileData(value)) {
-                                value = JSON.stringify(value);
+                    values = values.filter((v) => v != null && !isEmptyObject(v));
+                    for (let value of values) { // eslint-disable-line
+                        // Ignore special case of empty file object
+                        if (!Object.prototype.hasOwnProperty.call(value, 'contentType') ||
+                            Object.prototype.hasOwnProperty.call(value, 'data')) {
+                            if (isFileWithMetadata(value)) {
+                                const fileObj = yield buildRequestFileObject(value); // eslint-disable-line
+                                multipartForm.append(key, fileObj.value, fileObj.options);
+                            }
+                            else {
+                                if (typeof value === 'object' && !isFileData(value)) {
+                                    value = JSON.stringify(value);
+                                }
+                                multipartForm.append(key, value);
                             }
-                            multipartForm.append(key, value);
                         }
-                    }));
-                });
+                    }
+                }
             }
             // Path params
             url = parsePath(url, path);

package/etc/ibm-cloud-sdk-core.api.md

@@ -8,6 +8,7 @@
 
 import { AxiosInstance } from 'axios';
 import type { CookieJar } from 'tough-cookie';
+import { Debugger } from 'debug';
 import { OutgoingHttpHeaders } from 'http';
 import { Stream } from 'stream';
 
@@ -227,6 +228,9 @@ export function getMissingParams(params: {
     [key: string]: any;
 }, requires: string[]): null | Error;
 
+// @public
+export function getNewLogger(moduleName: string): SDKLogger;
+
 // @public
 function getOptions(createRequestMock: any): any;
 
@@ -346,6 +350,20 @@ export function readExternalSources(serviceName: string): any;
 // @public
 export function removeSuffix(str: string, suffix: string): string;
 
+// @public (undocumented)
+export interface SDKLogger {
+    // (undocumented)
+    debug: Debugger;
+    // (undocumented)
+    error: Debugger;
+    // (undocumented)
+    info: Debugger;
+    // (undocumented)
+    verbose: Debugger;
+    // (undocumented)
+    warn: Debugger;
+}
+
 // @public
 export function streamToPromise(stream: Stream): Promise<any>;
 

package/ibm-cloud-sdk-core.d.ts

@@ -2,6 +2,7 @@
 
 import { AxiosInstance } from 'axios';
 import type { CookieJar } from 'tough-cookie';
+import { Debugger } from 'debug';
 import { OutgoingHttpHeaders } from 'http';
 import { Stream } from 'stream';
 
@@ -719,6 +720,23 @@ export declare class BaseService {
                         [key: string]: any;
                     }, requires: string[]): null | Error;
 
+                    /**
+                     * Return a new logger, formatted with a particular name. The logging functions, in
+                     * order of increasing verbosity, are: `error`, `warn`, `info`, `verbose`, and `debug`.
+                     *
+                     * The logger will be an instance of the `debug` package and utilizes its support for
+                     * configuration with environment variables.
+                     *
+                     * Additionally, the logger will be turned on automatically if the "NODE_DEBUG"
+                     * environment variable is set to "axios".
+                     *
+                     * @param {string} moduleName - the namespace for the logger. The name will appear in
+                     * the logs and it will be the name used for configuring the log level.
+                     *
+                     * @returns {SDKLogger} the new logger
+                     */
+                    export declare function getNewLogger(moduleName: string): SDKLogger;
+
                     /**
                      * This method extracts the `options` property from the object passed into `createRequest`. This property is
                      * an object containing all of the SDK method-specific information (like `path` and `body`) used to build a request.
@@ -1234,6 +1252,14 @@ export declare class BaseService {
                                             maxRetryInterval?: number;
                                         }
 
+                                        export declare interface SDKLogger {
+                                            error: Debugger;
+                                            warn: Debugger;
+                                            info: Debugger;
+                                            verbose: Debugger;
+                                            debug: Debugger;
+                                        }
+
                                         /**
                                          * Helper method that can be bound to a stream - it captures all of the results, and returns a promise that resolves to the final buffer
                                          * or array of text chunks

package/index.d.ts

@@ -24,3 +24,4 @@ export { default as qs } from './lib/querystring';
 export { default as contentType } from './lib/content-type';
 export * from './lib/stream-to-promise';
 export { unitTestUtils };
+export { getNewLogger, SDKLogger } from './lib/get-new-logger';

package/index.js

@@ -39,3 +39,5 @@ exports.qs = querystring_1.default;
 var content_type_1 = require("./lib/content-type");
 exports.contentType = content_type_1.default;
 __export(require("./lib/stream-to-promise"));
+var get_new_logger_1 = require("./lib/get-new-logger");
+exports.getNewLogger = get_new_logger_1.getNewLogger;

package/lib/get-new-logger.d.ts

@@ -0,0 +1,39 @@
+/**
+ * (C) Copyright IBM Corp. 2022.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { Debugger } from 'debug';
+export interface SDKLogger {
+    error: Debugger;
+    warn: Debugger;
+    info: Debugger;
+    verbose: Debugger;
+    debug: Debugger;
+}
+/**
+ * Return a new logger, formatted with a particular name. The logging functions, in
+ * order of increasing verbosity, are: `error`, `warn`, `info`, `verbose`, and `debug`.
+ *
+ * The logger will be an instance of the `debug` package and utilizes its support for
+ * configuration with environment variables.
+ *
+ * Additionally, the logger will be turned on automatically if the "NODE_DEBUG"
+ * environment variable is set to "axios".
+ *
+ * @param {string} moduleName - the namespace for the logger. The name will appear in
+ * the logs and it will be the name used for configuring the log level.
+ *
+ * @returns {SDKLogger} the new logger
+ */
+export declare function getNewLogger(moduleName: string): SDKLogger;

package/lib/get-new-logger.js

@@ -0,0 +1,68 @@
+"use strict";
+/**
+ * (C) Copyright IBM Corp. 2022.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+var debug_1 = __importDefault(require("debug"));
+/**
+ * Return a new logger, formatted with a particular name. The logging functions, in
+ * order of increasing verbosity, are: `error`, `warn`, `info`, `verbose`, and `debug`.
+ *
+ * The logger will be an instance of the `debug` package and utilizes its support for
+ * configuration with environment variables.
+ *
+ * Additionally, the logger will be turned on automatically if the "NODE_DEBUG"
+ * environment variable is set to "axios".
+ *
+ * @param {string} moduleName - the namespace for the logger. The name will appear in
+ * the logs and it will be the name used for configuring the log level.
+ *
+ * @returns {SDKLogger} the new logger
+ */
+function getNewLogger(moduleName) {
+    var debug = debug_1.default(moduleName + ":debug");
+    var error = debug_1.default(moduleName + ":error");
+    var info = debug_1.default(moduleName + ":info");
+    var verbose = debug_1.default(moduleName + ":verbose");
+    var warn = debug_1.default(moduleName + ":warning");
+    // enable loggers if axios flag is set & mimic log levels severity
+    if (process.env.NODE_DEBUG === 'axios') {
+        debug.enabled = true;
+    }
+    if (debug.enabled) {
+        verbose.enabled = true;
+    }
+    if (verbose.enabled) {
+        info.enabled = true;
+    }
+    if (info.enabled) {
+        warn.enabled = true;
+    }
+    if (warn.enabled) {
+        error.enabled = true;
+    }
+    var newLogger = {
+        debug: debug,
+        error: error,
+        info: info,
+        verbose: verbose,
+        warn: warn,
+    };
+    return newLogger;
+}
+exports.getNewLogger = getNewLogger;

package/lib/logger.d.ts

@@ -1,5 +1,5 @@
 /**
- * (C) Copyright IBM Corp. 2019, 2021.
+ * (C) Copyright IBM Corp. 2019, 2022.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -13,12 +13,5 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import logger from 'debug';
-declare const _default: {
-    debug: logger.Debugger;
-    error: logger.Debugger;
-    info: logger.Debugger;
-    verbose: logger.Debugger;
-    warn: logger.Debugger;
-};
+declare const _default: import("./get-new-logger").SDKLogger;
 export default _default;

package/lib/logger.js

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * (C) Copyright IBM Corp. 2019, 2021.
+ * (C) Copyright IBM Corp. 2019, 2022.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -14,37 +14,6 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-var debug_1 = __importDefault(require("debug"));
-var debug = debug_1.default('ibm-cloud-sdk-core:debug');
-var error = debug_1.default('ibm-cloud-sdk-core:error');
-var info = debug_1.default('ibm-cloud-sdk-core:info');
-var verbose = debug_1.default('ibm-cloud-sdk-core:verbose');
-var warn = debug_1.default('ibm-cloud-sdk-core:warning');
-// enable loggers if axios flag is set & mimic log levels severity
-if (process.env.NODE_DEBUG === 'axios') {
-    debug.enabled = true;
-}
-if (debug.enabled) {
-    verbose.enabled = true;
-}
-if (verbose.enabled) {
-    info.enabled = true;
-}
-if (info.enabled) {
-    warn.enabled = true;
-}
-if (warn.enabled) {
-    error.enabled = true;
-}
-// export loggers;
-exports.default = {
-    debug: debug,
-    error: error,
-    info: info,
-    verbose: verbose,
-    warn: warn,
-};
+var get_new_logger_1 = require("./get-new-logger");
+exports.default = get_new_logger_1.getNewLogger('ibm-cloud-sdk-core');

package/lib/request-wrapper.js

@@ -175,50 +175,50 @@ var RequestWrapper = /** @class */ (function () {
      */
     RequestWrapper.prototype.sendRequest = function (parameters) {
         return __awaiter(this, void 0, void 0, function () {
-            var options, path, body, form, formData, qs, method, serviceUrl, headers, url, multipartForm, data, requestParams;
+            var options, path, body, form, formData, qs, method, serviceUrl, headers, url, multipartForm, _i, _a, key, values, _b, values_1, value, fileObj, data, requestParams;
             var _this = this;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
+            return __generator(this, function (_c) {
+                switch (_c.label) {
                     case 0:
                         options = extend_1.default(true, {}, parameters.defaultOptions, parameters.options);
                         path = options.path, body = options.body, form = options.form, formData = options.formData, qs = options.qs, method = options.method, serviceUrl = options.serviceUrl;
                         headers = options.headers, url = options.url;
                         multipartForm = new form_data_1.default();
-                        // Form params
-                        if (formData) {
-                            Object.keys(formData).forEach(function (key) {
-                                var values = Array.isArray(formData[key]) ? formData[key] : [formData[key]];
-                                // Skip keys with undefined/null values or empty object value
-                                values
-                                    .filter(function (v) { return v != null && !helper_1.isEmptyObject(v); })
-                                    .forEach(function (value) { return __awaiter(_this, void 0, void 0, function () {
-                                    var fileObj;
-                                    return __generator(this, function (_a) {
-                                        switch (_a.label) {
-                                            case 0:
-                                                // Special case of empty file object
-                                                if (Object.prototype.hasOwnProperty.call(value, 'contentType') &&
-                                                    !Object.prototype.hasOwnProperty.call(value, 'data')) {
-                                                    return [2 /*return*/];
-                                                }
-                                                if (!helper_1.isFileWithMetadata(value)) return [3 /*break*/, 2];
-                                                return [4 /*yield*/, helper_1.buildRequestFileObject(value)];
-                                            case 1:
-                                                fileObj = _a.sent();
-                                                multipartForm.append(key, fileObj.value, fileObj.options);
-                                                return [3 /*break*/, 3];
-                                            case 2:
-                                                if (typeof value === 'object' && !helper_1.isFileData(value)) {
-                                                    value = JSON.stringify(value);
-                                                }
-                                                multipartForm.append(key, value);
-                                                _a.label = 3;
-                                            case 3: return [2 /*return*/];
-                                        }
-                                    });
-                                }); });
-                            });
+                        if (!formData) return [3 /*break*/, 7];
+                        _i = 0, _a = Object.keys(formData);
+                        _c.label = 1;
+                    case 1:
+                        if (!(_i < _a.length)) return [3 /*break*/, 7];
+                        key = _a[_i];
+                        values = Array.isArray(formData[key]) ? formData[key] : [formData[key]];
+                        // Skip keys with undefined/null values or empty object value
+                        values = values.filter(function (v) { return v != null && !helper_1.isEmptyObject(v); });
+                        _b = 0, values_1 = values;
+                        _c.label = 2;
+                    case 2:
+                        if (!(_b < values_1.length)) return [3 /*break*/, 6];
+                        value = values_1[_b];
+                        if (!(!Object.prototype.hasOwnProperty.call(value, 'contentType') ||
+                            Object.prototype.hasOwnProperty.call(value, 'data'))) return [3 /*break*/, 5];
+                        if (!helper_1.isFileWithMetadata(value)) return [3 /*break*/, 4];
+                        return [4 /*yield*/, helper_1.buildRequestFileObject(value)];
+                    case 3:
+                        fileObj = _c.sent();
+                        multipartForm.append(key, fileObj.value, fileObj.options);
+                        return [3 /*break*/, 5];
+                    case 4:
+                        if (typeof value === 'object' && !helper_1.isFileData(value)) {
+                            value = JSON.stringify(value);
                         }
+                        multipartForm.append(key, value);
+                        _c.label = 5;
+                    case 5:
+                        _b++;
+                        return [3 /*break*/, 2];
+                    case 6:
+                        _i++;
+                        return [3 /*break*/, 1];
+                    case 7:
                         // Path params
                         url = parsePath(url, path);
                         // Headers
@@ -248,12 +248,12 @@ var RequestWrapper = /** @class */ (function () {
                         }
                         // accept gzip encoded responses if Accept-Encoding is not already set
                         headers['Accept-Encoding'] = headers['Accept-Encoding'] || 'gzip';
-                        if (!this.compressRequestData) return [3 /*break*/, 2];
+                        if (!this.compressRequestData) return [3 /*break*/, 9];
                         return [4 /*yield*/, this.gzipRequestBody(data, headers)];
-                    case 1:
-                        data = _a.sent();
-                        _a.label = 2;
-                    case 2:
+                    case 8:
+                        data = _c.sent();
+                        _c.label = 9;
+                    case 9:
                         requestParams = {
                             url: url,
                             method: method,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ibm-cloud-sdk-core",
-  "version": "3.1.0",
+  "version": "3.2.1",
   "description": "Core functionality to support SDKs generated with IBM's OpenAPI SDK Generator.",
   "main": "index.js",
   "typings": "./es/index.d.ts",

package/temp/ibm-cloud-sdk-core.api.json

@@ -3402,6 +3402,51 @@
           ],
           "name": "getMissingParams"
         },
+        {
+          "kind": "Function",
+          "canonicalReference": "ibm-cloud-sdk-core!getNewLogger:function(1)",
+          "docComment": "/**\n * Return a new logger, formatted with a particular name. The logging functions, in order of increasing verbosity, are: `error`, `warn`, `info`, `verbose`, and `debug`.\n *\n * The logger will be an instance of the `debug` package and utilizes its support for configuration with environment variables.\n *\n * Additionally, the logger will be turned on automatically if the \"NODE_DEBUG\" environment variable is set to \"axios\".\n *\n * @param moduleName - the namespace for the logger. The name will appear in the logs and it will be the name used for configuring the log level.\n *\n * @returns {SDKLogger} the new logger\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function getNewLogger(moduleName: "
+            },
+            {
+              "kind": "Content",
+              "text": "string"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Reference",
+              "text": "SDKLogger",
+              "canonicalReference": "ibm-cloud-sdk-core!SDKLogger:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "returnTypeTokenRange": {
+            "startIndex": 3,
+            "endIndex": 4
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "moduleName",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isOptional": false
+            }
+          ],
+          "name": "getNewLogger"
+        },
         {
           "kind": "Function",
           "canonicalReference": "ibm-cloud-sdk-core!getQueryParam:function(1)",
@@ -5243,6 +5288,157 @@
           ],
           "name": "removeSuffix"
         },
+        {
+          "kind": "Interface",
+          "canonicalReference": "ibm-cloud-sdk-core!SDKLogger:interface",
+          "docComment": "",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface SDKLogger "
+            }
+          ],
+          "releaseTag": "Public",
+          "name": "SDKLogger",
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "ibm-cloud-sdk-core!SDKLogger#debug:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "debug: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Debugger",
+                  "canonicalReference": "@types/debug!~debug.Debugger:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "debug",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "ibm-cloud-sdk-core!SDKLogger#error:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "error: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Debugger",
+                  "canonicalReference": "@types/debug!~debug.Debugger:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "error",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "ibm-cloud-sdk-core!SDKLogger#info:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "info: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Debugger",
+                  "canonicalReference": "@types/debug!~debug.Debugger:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "info",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "ibm-cloud-sdk-core!SDKLogger#verbose:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "verbose: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Debugger",
+                  "canonicalReference": "@types/debug!~debug.Debugger:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "verbose",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "ibm-cloud-sdk-core!SDKLogger#warn:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "warn: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Debugger",
+                  "canonicalReference": "@types/debug!~debug.Debugger:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "warn",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
         {
           "kind": "Function",
           "canonicalReference": "ibm-cloud-sdk-core!streamToPromise:function(1)",

package/temp/ibm-cloud-sdk-core.api.md

@@ -8,6 +8,7 @@
 
 import { AxiosInstance } from 'axios';
 import type { CookieJar } from 'tough-cookie';
+import { Debugger } from 'debug';
 import { OutgoingHttpHeaders } from 'http';
 import { Stream } from 'stream';
 
@@ -227,6 +228,9 @@ export function getMissingParams(params: {
     [key: string]: any;
 }, requires: string[]): null | Error;
 
+// @public
+export function getNewLogger(moduleName: string): SDKLogger;
+
 // @public
 function getOptions(createRequestMock: any): any;
 
@@ -346,6 +350,20 @@ export function readExternalSources(serviceName: string): any;
 // @public
 export function removeSuffix(str: string, suffix: string): string;
 
+// @public (undocumented)
+export interface SDKLogger {
+    // (undocumented)
+    debug: Debugger;
+    // (undocumented)
+    error: Debugger;
+    // (undocumented)
+    info: Debugger;
+    // (undocumented)
+    verbose: Debugger;
+    // (undocumented)
+    warn: Debugger;
+}
+
 // @public
 export function streamToPromise(stream: Stream): Promise<any>;