@compassdigital/sdk.typescript 3.0.0-beta.10 → 3.0.0-beta.12

package/README.md

@@ -8,31 +8,131 @@ Compass Digital Labs TypeScript SDK
 $ npm install --save @compassdigital/sdk.typescript@latest
 ```
 
+## Example Server Usage
+
+``` typescript
+import Provider from "@compassdigital/provider";
+import { GetTaskRequest, GetTaskResponse } from "@compassdigital/sdk.typescript/task";
+
+const provider = new Provider({ type: "payment" });
+
+provider.on<GetTaskRequest, GetTaskResponse>("get_task", function (req, next): void {
+    // ...
+})
+```
+
 ## Example Client Usage
 
+**Instanciate Client:**
+
 ``` typescript
 import { ServiceClient } from "@compassdigital/sdk.typescript";
 
 const api = new ServiceClient({ stage: "dev" });
+```
+
+**Basic Request:**
+
+``` typescript
+const task = await api.get_task(id);
+```
+
+**Request Options:**
+
+* These options may be passed to any request.
 
-async function main() {
-    const task = await api.get_task(task_id);
+``` typescript
+interface RequestOptions {
+  // environment to make requests to
+  stage?: string;
+  // authentication token
+  token?: string;
+  // additional headers
+  headers?: Record<string, string>;
+  // log all requests and responses
+  debug?: boolean;
+  // the number of times to retry a request
+  retry?: number;
+  // make requests against this base url
+  // note: the stage property is ignored if base_url is set
+  base_url?: string;
+  // intercept outgoing http requests
+  intercept?: InterceptFn;
 }
 ```
 
-## Example Server Usage
+* The `RequestOptions` can be provided to the `ServiceClient` constructor or at the request call site.
+* The options provided at the call site will overide options passed to the constructor.
 
 ``` typescript
-import Provider from "@compassdigital/provider";
-import { GetTaskRequest, GetTaskResponse } from "@compassdigital/sdk.typescript/task";
 
-const provider = new Provider({ type: "payment" });
+const api = new ServiceClient({
+    token: "<token>",
+    retry: 2,
+})
 
-provider.on<GetTaskRequest, GetTaskResponse>("get_task", function (req, next): void {
-    // ...
+const location = await api.get_location(id, {
+    token: "<token>",
+    retry: 2,
 })
 ```
 
+**Error Handling:**
+
+* non-200 responses are rejected with a `ServiceError`.
+
+``` typescript
+try {
+    const shoppingcart = await api.get_shoppingcart(id);
+} catch (err) {
+    // Since the error type is `unknown` we must type assert before
+    // accessing the properties.
+    if (err instanceof ServiceError) {
+        console.log(err.status, err.code, err.message);
+    }
+
+    // There are helpers for accessing the status and code
+    if (ServiceError.code(err) === 400.31) {
+        console.log("Failed to get menu");
+    }
+}
+```
+
+* There is a `ignore` convinience method for ignoring specific status & error codes.
+
+``` typescript
+const issue: OrderIssue = { items: [] };
+await api.post_order_issue(id, issue).ignore(400.18, 400.21);
+```
+
+* There is a `combine` convinience method for returning an object which contains the response or error.
+
+``` typescript
+const res = await api.get_task(id).combine();
+
+if (res.ok) {
+  console.log("task", res.body);
+} else {
+  console.log("error", res.err);
+}
+```
+
+**Testing:**
+
+* You can register an `intercept` function which will recieve all request.
+
+``` typescript
+
+import { ServiceClient, RequestData, ResponseData, FetchFn } from "@compassdigital/sdk.typescript";
+
+async function intercept(req: RequestData, fetch: FetchFn): Promise<ResponseData> {
+    expect(req.name).toBe("get_shoppingcart");
+    return { ok: true, status: 200, body: JSON.stringify({}) }
+}
+
+const api = new ServiceClient({ intercept });
+```
+
 ## Code Gen
 
 1. Add new services to `manifest.json`.

package/gen.ts

@@ -60,10 +60,11 @@ const operationIDs : Record<string, string> = {
   "get /promo":                                   "get_promos",
   "get /schedule":                                "get_schedules",
   "get /brand":                                   "get_brands",
-  "get /announcement/resource":                   "get_resources"
+  "get /announcement/resource":                   "get_resources",
+  "get /order/location/brand/{id}":               "get_order_location_brand",
 };
 
-class CodeGenerator {
+export class CodeGenerator {
 
   private imports: ClientImport[] = [];
   private methods: ClientMethod[] = [];
@@ -249,7 +250,7 @@ class CodeGenerator {
    * Infer the operation name from the method and parameter.
    * These are a bunch of dirty hacks to make the generated names consistent.
    */
-  private inferName(op: OperationDetails, service: ManifestService): OperationName {
+  inferName(op: OperationDetails, service: ManifestService): OperationName {
     let { method, path } = op;
     let path_segments: string[] = [];
     // use the operationId from our collection if we have one.
@@ -350,4 +351,10 @@ async function main() {
   await gen.generate(manifest);
 }
 
-main();
+/**
+ * Only generate if --run flag was passed
+ */
+const args = process.argv.splice(2);
+if (args[0] === "--run") {
+  main();
+}

package/lib/base.d.ts

@@ -7,6 +7,10 @@ export interface RequestOptions {
     base_url?: string;
     intercept?: InterceptFn;
 }
+/**
+ * The request data provided to intercept
+ * functions.
+ */
 export interface RequestData {
     name: string;
     service: string;
@@ -15,41 +19,139 @@ export interface RequestData {
     headers: Record<string, string>;
     body?: string;
 }
+/**
+ * The response data expected from
+ * intercept functions.
+ */
 export interface ResponseData {
     ok: boolean;
     status: number;
     body: string;
 }
+/**
+ * A function that performs an https request.
+ */
 export declare type FetchFn = (req: RequestData) => Promise<ResponseData>;
+/**
+ * A function that intercepts an http request and returns a response.
+ */
 export declare type InterceptFn = (req: RequestData, fetch: FetchFn) => Promise<ResponseData>;
-export declare type ServiceRequestOptions = Omit<RequestOptions, "allow">;
-export interface ServiceClientOptions extends ServiceRequestOptions {
-    services?: Record<string, ServiceRequestOptions>;
-    methods?: Record<string, ServiceRequestOptions>;
+/**
+ * We have to re-implement the promise methods instead of just existing
+ * the existing Promise class due to: https://github.com/microsoft/TypeScript/issues/15202
+ */
+export declare class ResponsePromise<T> implements Promise<T> {
+    private promise;
+    /**
+     * Implements Promise interface.
+     */
+    [Symbol.toStringTag]: string;
+    constructor(promise: Promise<T>);
+    /**
+     * Implements Promise interface.
+     */
+    then<TResult1 = T, TResult2 = never>(onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | null): ResponsePromise<TResult1 | TResult2>;
+    /**
+     * Implements Promise interface.
+     */
+    catch<TResult = never>(onrejected?: ((reason: any) => TResult | PromiseLike<TResult>) | null): ResponsePromise<T | TResult>;
+    /**
+     * Implements Promise interface.
+     */
+    finally(onfinally?: (() => void) | null): ResponsePromise<T>;
+    /**
+     * Returns a promise that resolves to null if http status code
+     * or service error code matches one of the provided codes.
+     * If no codes are specified, all codes are ignored.
+     */
+    ignore(...codes: number[]): ResponsePromise<T | null>;
+    /**
+     * Returns a promise that resolves to either the response body
+     * or a ServiceError.
+     */
+    combine(): Promise<EitherResponse<T>>;
 }
+/**
+ * Either a response body or a service error.
+ */
+declare type EitherResponse<T> = {
+    ok: true;
+    body: T;
+    err?: ServiceError;
+} | {
+    ok: false;
+    body?: T;
+    err: ServiceError;
+};
+/**
+ * An error returned from an api service.
+ */
 export declare class ServiceError extends Error {
     status: number;
     code: number;
     constructor(status: number, // http status
     code: number, // service error code
     message: string);
+    /**
+     * Returns the http status code from err.
+     * If err isn't an instance of ServiceError, -1 is returned.
+     */
     static status(err: any): number;
+    /**
+     * Returns the service error code from err.
+     * If err isn't an instance of ServiceError, -1 is returned.
+     */
     static code(err: any): number;
+    /**
+     * Returns a promise that resolves to null if http status code
+     * or service error code matches one of the provided codes.
+     * If no codes are specified, all codes are ignored.
+     */
     static ignore<T>(codes: number[], response: Promise<T>): Promise<T | null>;
+    /**
+     * Returns a promise that resolves to either T or a ServiceError.
+     */
+    static combine<T>(response: Promise<T>): Promise<EitherResponse<T>>;
+    /**
+     * Constructs a ServiceError from the provided response data.
+     */
     static from_res(res: ResponseData): ServiceError;
 }
+/**
+ * BaseServiceClient contains the logic for executing http requests.
+ * This class is meant to be extended by the generated code.
+ */
 export declare abstract class BaseServiceClient {
     private options;
-    constructor(options?: ServiceClientOptions);
+    constructor(options?: RequestOptions);
     /**
      * Combine the route and query parameters into a full url.
      */
     private build_url;
+    /**
+     * Perform the http request or pass it to the intercept function
+     * if one was configured.
+     */
     private fetch;
+    /**
+     * Returns true if the response status was a 4xx error.
+     */
     private is_4xx;
+    /**
+     * Returns the merged options.
+     */
     private get_options;
+    /**
+     * A delegate to _request that wraps the response in a ResponsePromise.
+     */
     protected request(service: string, name: string, method: string, route: string, body: any, options?: {
         query?: any;
-    } & RequestOptions): Promise<any>;
+    } & RequestOptions): ResponsePromise<any>;
+    /**
+     * The main logic for fulfilling a request as perscribed by
+     * the request options.
+     */
+    private _request;
 }
+export {};
 //# sourceMappingURL=base.d.ts.map

package/lib/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../src/base.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,cAAc;IAE7B,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,KAAK,CAAC,EAAE,MAAM,CAAC;IAGf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,SAAS,CAAC,EAAE,WAAW,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,oBAAY,OAAO,GAAG,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;AAElE,oBAAY,WAAW,GAAG,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;AAEtF,oBAAY,qBAAqB,GAAG,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;AAElE,MAAM,WAAW,oBAAqB,SAAQ,qBAAqB;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;CACjD;AAED,qBAAa,YAAa,SAAQ,KAAK;IAE5B,MAAM,EAAE,MAAM;IACd,IAAI,EAAE,MAAM;gBADZ,MAAM,EAAE,MAAM,EAAE,cAAc;IAC9B,IAAI,EAAE,MAAM,EAAI,qBAAqB;IAC5C,OAAO,EAAE,MAAM;IASjB,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM;IAO/B,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM;WAOhB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAehF,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,YAAY,GAAG,YAAY;CAYjD;AAED,8BAAsB,iBAAiB;IACrC,OAAO,CAAC,OAAO,CAAuB;gBAE1B,OAAO,CAAC,EAAE,oBAAoB;IAI1C;;OAEG;IACH,OAAO,CAAC,SAAS;YAoBH,KAAK;IAgBnB,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,WAAW;cAiBH,OAAO,CACrB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,GAAG,EACT,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,GAAG,CAAA;KAAE,GAAG,cAAmB,GAC7C,OAAO,CAAC,GAAG,CAAC;CAkChB"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../src/base.ts"],"names":[],"mappings":"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"}

package/lib/base.js

@@ -64,9 +64,66 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
+var _a;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BaseServiceClient = exports.ServiceError = void 0;
+exports.BaseServiceClient = exports.ServiceError = exports.ResponsePromise = void 0;
 var cross_fetch_1 = __importDefault(require("cross-fetch"));
+/**
+ * We have to re-implement the promise methods instead of just existing
+ * the existing Promise class due to: https://github.com/microsoft/TypeScript/issues/15202
+ */
+var ResponsePromise = /** @class */ (function () {
+    function ResponsePromise(promise) {
+        this.promise = promise;
+        /**
+         * Implements Promise interface.
+         */
+        this[_a] = "[object ResponsePromise]";
+    }
+    /**
+     * Implements Promise interface.
+     */
+    ResponsePromise.prototype.then = function (onfulfilled, onrejected) {
+        return new ResponsePromise(this.promise.then(onfulfilled, onrejected));
+    };
+    /**
+     * Implements Promise interface.
+     */
+    ResponsePromise.prototype.catch = function (onrejected) {
+        return new ResponsePromise(this.promise.catch(onrejected));
+    };
+    /**
+     * Implements Promise interface.
+     */
+    ResponsePromise.prototype.finally = function (onfinally) {
+        return new ResponsePromise(this.promise.finally(onfinally));
+    };
+    /**
+     * Returns a promise that resolves to null if http status code
+     * or service error code matches one of the provided codes.
+     * If no codes are specified, all codes are ignored.
+     */
+    ResponsePromise.prototype.ignore = function () {
+        var codes = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            codes[_i] = arguments[_i];
+        }
+        return new ResponsePromise(ServiceError.ignore(codes, this.promise));
+    };
+    /**
+     * Returns a promise that resolves to either the response body
+     * or a ServiceError.
+     */
+    ResponsePromise.prototype.combine = function () {
+        return new ResponsePromise(ServiceError.combine(this.promise));
+    };
+    return ResponsePromise;
+}());
+exports.ResponsePromise = ResponsePromise;
+_a = Symbol.toStringTag;
+/**
+ * An error returned from an api service.
+ */
 var ServiceError = /** @class */ (function (_super) {
     __extends(ServiceError, _super);
     function ServiceError(status, // http status
@@ -81,30 +138,46 @@ var ServiceError = /** @class */ (function (_super) {
         Object.setPrototypeOf(_this, ServiceError.prototype);
         return _this;
     }
+    /**
+     * Returns the http status code from err.
+     * If err isn't an instance of ServiceError, -1 is returned.
+     */
     ServiceError.status = function (err) {
         if (err instanceof ServiceError) {
             return err.status;
         }
         return -1;
     };
+    /**
+     * Returns the service error code from err.
+     * If err isn't an instance of ServiceError, -1 is returned.
+     */
     ServiceError.code = function (err) {
         if (err instanceof ServiceError) {
             return err.code;
         }
         return -1;
     };
+    /**
+     * Returns a promise that resolves to null if http status code
+     * or service error code matches one of the provided codes.
+     * If no codes are specified, all codes are ignored.
+     */
     ServiceError.ignore = function (codes, response) {
         return __awaiter(this, void 0, void 0, function () {
             var err_1, _i, codes_1, code;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
+            return __generator(this, function (_b) {
+                switch (_b.label) {
                     case 0:
-                        _a.trys.push([0, 2, , 3]);
+                        _b.trys.push([0, 2, , 3]);
                         return [4 /*yield*/, response];
-                    case 1: return [2 /*return*/, _a.sent()];
+                    case 1: return [2 /*return*/, _b.sent()];
                     case 2:
-                        err_1 = _a.sent();
+                        err_1 = _b.sent();
                         if (err_1 instanceof ServiceError) {
+                            if (codes.length === 0) {
+                                return [2 /*return*/, null];
+                            }
                             for (_i = 0, codes_1 = codes; _i < codes_1.length; _i++) {
                                 code = codes_1[_i];
                                 if (err_1.status === code || err_1.code === code) {
@@ -118,6 +191,34 @@ var ServiceError = /** @class */ (function (_super) {
             });
         });
     };
+    /**
+     * Returns a promise that resolves to either T or a ServiceError.
+     */
+    ServiceError.combine = function (response) {
+        return __awaiter(this, void 0, void 0, function () {
+            var body, err_2;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0:
+                        _b.trys.push([0, 2, , 3]);
+                        return [4 /*yield*/, response];
+                    case 1:
+                        body = _b.sent();
+                        return [2 /*return*/, { ok: true, body: body }];
+                    case 2:
+                        err_2 = _b.sent();
+                        if (err_2 instanceof ServiceError) {
+                            return [2 /*return*/, { ok: false, err: err_2 }];
+                        }
+                        throw err_2;
+                    case 3: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /**
+     * Constructs a ServiceError from the provided response data.
+     */
     ServiceError.from_res = function (res) {
         var message = res.body;
         var code = res.status;
@@ -134,6 +235,10 @@ var ServiceError = /** @class */ (function (_super) {
     return ServiceError;
 }(Error));
 exports.ServiceError = ServiceError;
+/**
+ * BaseServiceClient contains the logic for executing http requests.
+ * This class is meant to be extended by the generated code.
+ */
 var BaseServiceClient = /** @class */ (function () {
     function BaseServiceClient(options) {
         this.options = options !== null && options !== void 0 ? options : {};
@@ -141,8 +246,8 @@ var BaseServiceClient = /** @class */ (function () {
     /**
      * Combine the route and query parameters into a full url.
      */
-    BaseServiceClient.prototype.build_url = function (route, _a, params) {
-        var base_url = _a.base_url, _b = _a.stage, stage = _b === void 0 ? "dev" : _b;
+    BaseServiceClient.prototype.build_url = function (route, _b, params) {
+        var base_url = _b.base_url, _c = _b.stage, stage = _c === void 0 ? "dev" : _c;
         var url = "https://api.compassdigital.org/" + stage + route;
         // use the base url if one was provided.
         if (base_url) {
@@ -153,8 +258,8 @@ var BaseServiceClient = /** @class */ (function () {
         }
         // add query parameters.
         var query = [];
-        for (var _i = 0, _c = Object.entries(params); _i < _c.length; _i++) {
-            var _d = _c[_i], name_1 = _d[0], value = _d[1];
+        for (var _i = 0, _d = Object.entries(params); _i < _d.length; _i++) {
+            var _e = _d[_i], name_1 = _e[0], value = _e[1];
             query.push(encodeURIComponent(name_1) + "=" + encodeURIComponent(value));
         }
         if (query.length > 0) {
@@ -162,12 +267,16 @@ var BaseServiceClient = /** @class */ (function () {
         }
         return url;
     };
+    /**
+     * Perform the http request or pass it to the intercept function
+     * if one was configured.
+     */
     BaseServiceClient.prototype.fetch = function (req, options) {
         return __awaiter(this, void 0, void 0, function () {
             var res;
-            var _a;
-            return __generator(this, function (_b) {
-                switch (_b.label) {
+            var _b;
+            return __generator(this, function (_c) {
+                switch (_c.label) {
                     case 0:
                         if (options === null || options === void 0 ? void 0 : options.intercept) {
                             return [2 /*return*/, options.intercept(req, this.fetch.bind(this))];
@@ -178,37 +287,52 @@ var BaseServiceClient = /** @class */ (function () {
                                 headers: req.headers,
                             })];
                     case 1:
-                        res = _b.sent();
-                        _a = {
+                        res = _c.sent();
+                        _b = {
                             ok: res.ok,
                             status: res.status
                         };
                         return [4 /*yield*/, res.text()];
-                    case 2: return [2 /*return*/, (_a.body = _b.sent(),
-                            _a)];
+                    case 2: return [2 /*return*/, (_b.body = _c.sent(),
+                            _b)];
                 }
             });
         });
     };
+    /**
+     * Returns true if the response status was a 4xx error.
+     */
     BaseServiceClient.prototype.is_4xx = function (res) {
         return 400 <= res.status && res.status < 500;
     };
-    BaseServiceClient.prototype.get_options = function (service, name, options) {
-        var _a, _b;
-        var service_options = (_a = this.options.services) === null || _a === void 0 ? void 0 : _a[service];
-        var method_options = (_b = this.options.methods) === null || _b === void 0 ? void 0 : _b[name];
-        return __assign(__assign(__assign(__assign(__assign({}, this.options), service_options), method_options), options), { headers: __assign(__assign(__assign(__assign({}, this.options.headers), method_options === null || method_options === void 0 ? void 0 : method_options.headers), service_options === null || service_options === void 0 ? void 0 : service_options.headers), options.headers) });
+    /**
+     * Returns the merged options.
+     */
+    BaseServiceClient.prototype.get_options = function (options) {
+        return __assign(__assign(__assign({}, this.options), options), { headers: __assign(__assign({}, this.options.headers), options.headers) });
     };
+    /**
+     * A delegate to _request that wraps the response in a ResponsePromise.
+     */
     BaseServiceClient.prototype.request = function (service, name, method, route, body, options) {
-        var _a;
+        if (options === void 0) { options = {}; }
+        var promise = this._request(service, name, method, route, body, options);
+        return new ResponsePromise(promise);
+    };
+    /**
+     * The main logic for fulfilling a request as perscribed by
+     * the request options.
+     */
+    BaseServiceClient.prototype._request = function (service, name, method, route, body, options) {
+        var _b;
         if (options === void 0) { options = {}; }
         return __awaiter(this, void 0, void 0, function () {
             var url, headers, req, res, err, data;
-            return __generator(this, function (_b) {
-                switch (_b.label) {
+            return __generator(this, function (_c) {
+                switch (_c.label) {
                     case 0:
-                        options = this.get_options(service, name, options);
-                        url = this.build_url(route, options, (_a = options.query) !== null && _a !== void 0 ? _a : {});
+                        options = this.get_options(options);
+                        url = this.build_url(route, options, (_b = options.query) !== null && _b !== void 0 ? _b : {});
                         headers = Object.assign({
                             "User-Agent": "CDL/ServiceClient"
                         }, options.headers);
@@ -224,7 +348,7 @@ var BaseServiceClient = /** @class */ (function () {
                         }
                         return [4 /*yield*/, this.fetch(req, options)];
                     case 1:
-                        res = _b.sent();
+                        res = _c.sent();
                         if (!res.ok) {
                             err = ServiceError.from_res(res);
                             if (options.debug) {

package/lib/base.js.map

@@ -1 +1 @@
-{"version":3,"file":"base.js","sourceRoot":"","sources":["../src/base.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../src/base.ts"],"names":[],"mappings":"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"}