retell-sdk 1.1.1 → 1.12.1

package/dist/internal/utils/requestbody.js

@@ -0,0 +1,328 @@
+"use strict";
+/*
+ * Code generated by Speakeasy (https://speakeasyapi.dev). DO NOT EDIT.
+ */
+var __read = (this && this.__read) || function (o, n) {
+    var m = typeof Symbol === "function" && o[Symbol.iterator];
+    if (!m) return o;
+    var i = m.call(o), r, ar = [], e;
+    try {
+        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
+    }
+    catch (error) { e = { error: error }; }
+    finally {
+        try {
+            if (r && !r.done && (m = i["return"])) m.call(i);
+        }
+        finally { if (e) throw e.error; }
+    }
+    return ar;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serializeRequestBody = exports.requestMetadataKey = void 0;
+var utils_1 = require("./utils");
+var form_data_1 = __importDefault(require("form-data"));
+var types_1 = require("../../sdk/types");
+var class_transformer_1 = require("class-transformer");
+exports.requestMetadataKey = "request";
+var mpFormMetadataKey = "multipart_form";
+function serializeRequestBody(request, requestFieldName, serializationMethod) {
+    if (request !== Object(request) || !request.hasOwnProperty(requestFieldName)) {
+        return serializeContentType(utils_1.SerializationMethodToContentType[serializationMethod], request);
+    }
+    var requestBodyAnn = Reflect.getMetadata(exports.requestMetadataKey, request, requestFieldName);
+    if (!requestBodyAnn) {
+        throw new Error("invalid request type");
+    }
+    var requestDecorator = parseRequestDecorator(requestBodyAnn);
+    return serializeContentType(requestDecorator.MediaType, request[requestFieldName]);
+}
+exports.serializeRequestBody = serializeRequestBody;
+var serializeContentType = function (contentType, reqBody) {
+    var _a, _b, _c;
+    var _d = __read([{}, {}], 2), requestHeaders = _d[0], requestBody = _d[1];
+    switch (contentType) {
+        case "multipart/form-data":
+            requestBody = encodeMultipartFormData(reqBody);
+            break;
+        case "multipart/mixed":
+            requestBody = encodeMultipartFormData(reqBody);
+            requestHeaders = requestBody.getHeaders();
+            break;
+        case "application/x-www-form-urlencoded":
+            _a = __read([
+                { "Content-Type": "".concat(contentType) },
+                encodeFormUrlEncodedData(reqBody),
+            ], 2), requestHeaders = _a[0], requestBody = _a[1];
+            break;
+        case "application/json":
+            _b = __read([
+                { "Content-Type": "".concat(contentType) },
+                (0, class_transformer_1.classToPlain)(reqBody, { exposeUnsetFields: false }),
+            ], 2), requestHeaders = _b[0], requestBody = _b[1];
+            break;
+        case "text/json":
+            _c = __read([{ "Content-Type": "".concat(contentType) }, reqBody], 2), requestHeaders = _c[0], requestBody = _c[1];
+            break;
+        default: {
+            requestBody = reqBody;
+            var requestBodyType = typeof requestBody;
+            if (requestBodyType === "string" ||
+                requestBody instanceof String ||
+                requestBody instanceof Uint8Array)
+                requestHeaders = { "Content-Type": "".concat(contentType) };
+            else
+                throw new Error("invalid request body type ".concat(requestBodyType, " for mediaType ").concat(contentType));
+        }
+    }
+    return [requestHeaders, requestBody];
+};
+var encodeFormUrlEncodedData = function (data) {
+    var fieldNames = Object.getOwnPropertyNames(data);
+    var urlencoded = "";
+    var amp = "";
+    var appendPair = function (key, value) {
+        urlencoded += "".concat(amp).concat(encodeURIComponent(key), "=").concat(encodeURIComponent(value));
+        amp = "&";
+    };
+    if ((0, utils_1.isNumberRecord)(data) || (0, utils_1.isBooleanRecord)(data) || (0, utils_1.isStringRecord)(data)) {
+        fieldNames.forEach(function (fname) {
+            var _a, _b;
+            var formAnn = Reflect.getMetadata("form", data, fname);
+            var name = fname;
+            if (formAnn) {
+                var formDecorator = parseFormDecorator(formAnn);
+                name = (_a = formDecorator.Name) !== null && _a !== void 0 ? _a : fname;
+            }
+            appendPair(name, (_b = data[fname]) === null || _b === void 0 ? void 0 : _b.toString());
+        });
+    }
+    else {
+        fieldNames.forEach(function (fname) {
+            var _a, _b;
+            var formAnn = Reflect.getMetadata("form", data, fname);
+            if (formAnn === null) {
+                return;
+            }
+            var formDecorator = parseFormDecorator(formAnn);
+            if (formDecorator.JSON) {
+                var name = (_a = formDecorator.Name) !== null && _a !== void 0 ? _a : fname;
+                var val = JSON.stringify(data[fname]);
+                appendPair(name, val);
+            }
+            else if (formDecorator.Style === "form") {
+                var parsed_1;
+                var name = (_b = formDecorator.Name) !== null && _b !== void 0 ? _b : fname;
+                if (formDecorator.Explode === true) {
+                    parsed_1 = formExplode(name, data[fname]);
+                }
+                else {
+                    parsed_1 = formNotExplode(name, data[fname]);
+                }
+                Object.keys(parsed_1).forEach(function (key) {
+                    parsed_1[key].forEach(function (v) { return appendPair(key, v); });
+                });
+                return;
+            }
+        });
+    }
+    return urlencoded;
+};
+var formExplode = function (fname, data) {
+    var exploded = {};
+    if (Array.isArray(data)) {
+        data.forEach(function (value) {
+            if (!exploded[fname]) {
+                exploded[fname] = [];
+            }
+            exploded[fname].push(value);
+        });
+    }
+    else if (typeof data === "object") {
+        if (data instanceof Date || data instanceof types_1.RFCDate) {
+            if (!exploded[fname]) {
+                exploded[fname] = [];
+            }
+            exploded[fname].push((0, utils_1.valToString)(data));
+        }
+        else {
+            Object.keys(data).forEach(function (key) {
+                if (!exploded[key]) {
+                    exploded[key] = [];
+                }
+                exploded[key].push(data[key]);
+            });
+        }
+    }
+    else {
+        if (!exploded[fname]) {
+            exploded[fname] = [];
+        }
+        exploded[fname].push((0, utils_1.valToString)(data));
+    }
+    return exploded;
+};
+var formNotExplode = function (fname, data) {
+    var notExploded = {};
+    if (Array.isArray(data)) {
+        if (!notExploded[fname]) {
+            notExploded[fname] = [];
+        }
+        notExploded[fname].push(data.map(function (item) { return item.toString(); }).join(","));
+    }
+    else if (typeof data === "object") {
+        if (data instanceof Date || data instanceof types_1.RFCDate) {
+            if (!notExploded[fname]) {
+                notExploded[fname] = [];
+            }
+            notExploded[fname].push((0, utils_1.valToString)(data));
+        }
+        else {
+            Object.keys(data).forEach(function (key) {
+                if (!notExploded[key]) {
+                    notExploded[key] = [];
+                }
+                notExploded[fname].push("".concat(key, "=").concat(data[key]));
+            });
+        }
+    }
+    else {
+        if (!notExploded[fname]) {
+            notExploded[fname] = [];
+        }
+        notExploded[fname].push((0, utils_1.valToString)(data));
+    }
+    return notExploded;
+};
+function parseFormDecorator(formAnn) {
+    var formDecorator = new FormDecorator("", "form", false, false);
+    formAnn.split(";").forEach(function (formAnnPart) {
+        var _a = __read(formAnnPart.split("="), 2), formKey = _a[0], formVal = _a[1];
+        switch (formKey) {
+            case "name":
+                formDecorator.Name = formVal;
+                break;
+            case "style":
+                formDecorator.Style = formVal;
+                break;
+            case "explode":
+                formDecorator.Explode = formVal === "true";
+                break;
+            case "json":
+                formDecorator.JSON = formVal === "true";
+                break;
+        }
+    });
+    return formDecorator;
+}
+var FormDecorator = /** @class */ (function () {
+    function FormDecorator(Name, Style, Explode, JSON) {
+        this.Name = Name;
+        this.Style = Style;
+        this.Explode = Explode;
+        this.JSON = JSON;
+    }
+    return FormDecorator;
+}());
+function encodeMultipartFormData(form) {
+    var formData = new form_data_1.default();
+    var fieldNames = Object.getOwnPropertyNames(form);
+    fieldNames.forEach(function (fname) {
+        var mpFormAnn = Reflect.getMetadata(mpFormMetadataKey, form, fname);
+        if (mpFormAnn == null)
+            return;
+        var mpFormDecorator = parseMultipartFormDecorator(mpFormAnn);
+        if (mpFormDecorator.File)
+            return encodeMultipartFormDataFile(formData, form[fname]);
+        else if (mpFormDecorator.JSON) {
+            formData.append(mpFormDecorator.Name, JSON.stringify(form[fname]));
+        }
+        else {
+            if (Array.isArray(form[fname])) {
+                form[fname].forEach(function (val) {
+                    formData.append(mpFormDecorator.Name + "[]", (0, utils_1.valToString)(val));
+                });
+            }
+            else {
+                formData.append(mpFormDecorator.Name, (0, utils_1.valToString)(form[fname]));
+            }
+        }
+    });
+    return formData;
+}
+function encodeMultipartFormDataFile(formData, file) {
+    if (typeof file !== "object" || Array.isArray(file) || file == null) {
+        throw new Error("invalid type for multipart/form-data file");
+    }
+    var content = null;
+    var fileName = "";
+    var mpFormDecoratorName = "";
+    var fieldNames = Object.getOwnPropertyNames(file);
+    fieldNames.forEach(function (fname) {
+        var mpFormAnn = Reflect.getMetadata(mpFormMetadataKey, file, fname);
+        if (mpFormAnn == null)
+            return;
+        var mpFormDecorator = parseMultipartFormDecorator(mpFormAnn);
+        if (!mpFormDecorator.Content && mpFormDecorator.Name == "")
+            return;
+        if (mpFormDecorator.Content)
+            content = file[fname];
+        else {
+            mpFormDecoratorName = mpFormDecorator.Name;
+            fileName = file[fname];
+        }
+    });
+    if (mpFormDecoratorName === "" || fileName === "" || content == null) {
+        throw new Error("invalid multipart/form-data file");
+    }
+    formData.append(mpFormDecoratorName, Buffer.from(content), fileName);
+    return formData;
+}
+function parseMultipartFormDecorator(mpFormAnn) {
+    // example "name=file"
+    var mpFormDecorator = new MultipartFormDecorator(false, false, false, "");
+    mpFormAnn.split(";").forEach(function (mpFormAnnPart) {
+        var _a = __read(mpFormAnnPart.split("="), 2), mpFormKey = _a[0], mpFormVal = _a[1];
+        switch (mpFormKey) {
+            case "file":
+                mpFormDecorator.File = mpFormVal == "true";
+                break;
+            case "content":
+                mpFormDecorator.Content = mpFormVal == "true";
+                break;
+            case "name":
+                mpFormDecorator.Name = mpFormVal;
+                break;
+            case "json":
+                mpFormDecorator.JSON = mpFormVal == "true";
+                break;
+        }
+    });
+    return mpFormDecorator;
+}
+var MultipartFormDecorator = /** @class */ (function () {
+    function MultipartFormDecorator(File, Content, JSON, Name) {
+        this.File = File;
+        this.Content = Content;
+        this.JSON = JSON;
+        this.Name = Name;
+    }
+    return MultipartFormDecorator;
+}());
+function parseRequestDecorator(requestAnn) {
+    // example "media_type=multipart/form-data"
+    var requestDecorator = new RequestDecorator("application/octet-stream");
+    var _a = __read(requestAnn.split("="), 2), mediaTypeKey = _a[0], mediaTypeVal = _a[1];
+    if (mediaTypeKey === "media_type")
+        requestDecorator.MediaType = mediaTypeVal;
+    return requestDecorator;
+}
+var RequestDecorator = /** @class */ (function () {
+    function RequestDecorator(MediaType) {
+        this.MediaType = MediaType;
+    }
+    return RequestDecorator;
+}());

package/dist/internal/utils/retries.d.ts

@@ -0,0 +1,20 @@
+import { AxiosResponse } from "axios";
+export declare class BackoffStrategy {
+    initialInterval: number;
+    maxInterval: number;
+    exponent: number;
+    maxElapsedTime: number;
+    constructor(initialInterval: number, maxInterval: number, exponent: number, maxElapsedTime: number);
+}
+export declare class RetryConfig {
+    strategy: "backoff" | "none";
+    backoff?: BackoffStrategy;
+    retryConnectionErrors: boolean;
+    constructor(strategy: "backoff" | "none", backoff?: BackoffStrategy, retryConnectionErrors?: boolean);
+}
+export declare class Retries {
+    config: RetryConfig;
+    statusCodes: string[];
+    constructor(config: RetryConfig, statusCodes: string[]);
+}
+export declare function Retry(fn: () => Promise<AxiosResponse<any, any>>, retries: Retries): Promise<AxiosResponse<any, any>>;

package/dist/internal/utils/retries.js

@@ -0,0 +1,250 @@
+"use strict";
+/*
+ * Code generated by Speakeasy (https://speakeasyapi.dev). DO NOT EDIT.
+ */
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+var __values = (this && this.__values) || function(o) {
+    var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
+    if (m) return m.call(o);
+    if (o && typeof o.length === "number") return {
+        next: function () {
+            if (o && i >= o.length) o = void 0;
+            return { value: o && o[i++], done: !o };
+        }
+    };
+    throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Retry = exports.Retries = exports.RetryConfig = exports.BackoffStrategy = void 0;
+var axios_1 = require("axios");
+var BackoffStrategy = /** @class */ (function () {
+    function BackoffStrategy(initialInterval, maxInterval, exponent, maxElapsedTime) {
+        this.initialInterval = initialInterval;
+        this.maxInterval = maxInterval;
+        this.exponent = exponent;
+        this.maxElapsedTime = maxElapsedTime;
+    }
+    return BackoffStrategy;
+}());
+exports.BackoffStrategy = BackoffStrategy;
+var RetryConfig = /** @class */ (function () {
+    function RetryConfig(strategy, backoff, retryConnectionErrors) {
+        if (retryConnectionErrors === void 0) { retryConnectionErrors = true; }
+        this.strategy = strategy;
+        this.backoff = backoff;
+        this.retryConnectionErrors = retryConnectionErrors;
+    }
+    return RetryConfig;
+}());
+exports.RetryConfig = RetryConfig;
+var Retries = /** @class */ (function () {
+    function Retries(config, statusCodes) {
+        this.config = config;
+        this.statusCodes = statusCodes;
+    }
+    return Retries;
+}());
+exports.Retries = Retries;
+var PermanentError = /** @class */ (function (_super) {
+    __extends(PermanentError, _super);
+    function PermanentError(inner) {
+        var _this = _super.call(this, "Permanent error") || this;
+        _this.inner = inner;
+        Object.setPrototypeOf(_this, PermanentError.prototype);
+        return _this;
+    }
+    return PermanentError;
+}(Error));
+var TemporaryError = /** @class */ (function (_super) {
+    __extends(TemporaryError, _super);
+    function TemporaryError(res) {
+        var _this = _super.call(this, "Temporary error") || this;
+        _this.res = res;
+        Object.setPrototypeOf(_this, TemporaryError.prototype);
+        return _this;
+    }
+    return TemporaryError;
+}(Error));
+function Retry(fn, retries) {
+    var _a, _b, _c, _d, _e, _f, _g, _h;
+    return __awaiter(this, void 0, void 0, function () {
+        var _j;
+        var _this = this;
+        return __generator(this, function (_k) {
+            switch (_k.label) {
+                case 0:
+                    _j = retries.config.strategy;
+                    switch (_j) {
+                        case "backoff": return [3 /*break*/, 1];
+                    }
+                    return [3 /*break*/, 2];
+                case 1: return [2 /*return*/, retryBackoff(function () { return __awaiter(_this, void 0, void 0, function () {
+                        var res, err_1;
+                        return __generator(this, function (_a) {
+                            switch (_a.label) {
+                                case 0:
+                                    _a.trys.push([0, 2, , 3]);
+                                    return [4 /*yield*/, fn()];
+                                case 1:
+                                    res = _a.sent();
+                                    if (isRetryableResponse(res, retries.statusCodes)) {
+                                        throw new TemporaryError(res);
+                                    }
+                                    return [2 /*return*/, res];
+                                case 2:
+                                    err_1 = _a.sent();
+                                    if (err_1 instanceof axios_1.AxiosError) {
+                                        if (err_1.response) {
+                                            if (isRetryableResponse(err_1.response, retries.statusCodes)) {
+                                                throw err_1;
+                                            }
+                                            throw new PermanentError(err_1);
+                                        }
+                                        else if (err_1.request) {
+                                            throw err_1;
+                                        }
+                                        else {
+                                            throw new PermanentError(err_1);
+                                        }
+                                    }
+                                    else if (err_1 instanceof TemporaryError) {
+                                        throw err_1;
+                                    }
+                                    throw new PermanentError(err_1);
+                                case 3: return [2 /*return*/];
+                            }
+                        });
+                    }); }, (_b = (_a = retries.config.backoff) === null || _a === void 0 ? void 0 : _a.initialInterval) !== null && _b !== void 0 ? _b : 500, (_d = (_c = retries.config.backoff) === null || _c === void 0 ? void 0 : _c.maxInterval) !== null && _d !== void 0 ? _d : 60000, (_f = (_e = retries.config.backoff) === null || _e === void 0 ? void 0 : _e.exponent) !== null && _f !== void 0 ? _f : 1.5, (_h = (_g = retries.config.backoff) === null || _g === void 0 ? void 0 : _g.maxElapsedTime) !== null && _h !== void 0 ? _h : 3600000)];
+                case 2: return [4 /*yield*/, fn()];
+                case 3: return [2 /*return*/, _k.sent()];
+            }
+        });
+    });
+}
+exports.Retry = Retry;
+function isRetryableResponse(res, statusCodes) {
+    var e_1, _a;
+    try {
+        for (var statusCodes_1 = __values(statusCodes), statusCodes_1_1 = statusCodes_1.next(); !statusCodes_1_1.done; statusCodes_1_1 = statusCodes_1.next()) {
+            var code = statusCodes_1_1.value;
+            if (code.toUpperCase().includes("X")) {
+                var codeRange = parseInt(code[0]);
+                if (isNaN(codeRange)) {
+                    throw new Error("Invalid status code range");
+                }
+                var s = res.status / 100;
+                if (s >= codeRange && s < codeRange + 1) {
+                    return true;
+                }
+            }
+            else if (res.status == parseInt(code)) {
+                return true;
+            }
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (statusCodes_1_1 && !statusCodes_1_1.done && (_a = statusCodes_1.return)) _a.call(statusCodes_1);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    return false;
+}
+function retryBackoff(fn, initialInterval, maxInterval, exponent, maxElapsedTime) {
+    return __awaiter(this, void 0, void 0, function () {
+        var start, x, err_2, now, d;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    start = Date.now();
+                    x = 0;
+                    _a.label = 1;
+                case 1:
+                    if (!true) return [3 /*break*/, 7];
+                    _a.label = 2;
+                case 2:
+                    _a.trys.push([2, 4, , 6]);
+                    return [4 /*yield*/, fn()];
+                case 3: return [2 /*return*/, _a.sent()];
+                case 4:
+                    err_2 = _a.sent();
+                    if (err_2 instanceof PermanentError) {
+                        throw err_2.inner;
+                    }
+                    now = Date.now();
+                    if (now - start > maxElapsedTime) {
+                        if (err_2 instanceof TemporaryError) {
+                            return [2 /*return*/, err_2.res];
+                        }
+                        throw err_2;
+                    }
+                    d = Math.min(initialInterval * Math.pow(x, exponent) + Math.random() * 1000, maxInterval);
+                    return [4 /*yield*/, delay(d)];
+                case 5:
+                    _a.sent();
+                    x++;
+                    return [3 /*break*/, 6];
+                case 6: return [3 /*break*/, 1];
+                case 7: return [2 /*return*/];
+            }
+        });
+    });
+}
+function delay(delay) {
+    return __awaiter(this, void 0, void 0, function () {
+        return __generator(this, function (_a) {
+            return [2 /*return*/, new Promise(function (resolve) { return setTimeout(resolve, delay); })];
+        });
+    });
+}

package/dist/internal/utils/security.d.ts

@@ -0,0 +1,5 @@
+export type SecurityProperties = {
+    params: Record<string, string>;
+    headers: Record<string, string>;
+};
+export declare function parseSecurityProperties(security: any): SecurityProperties;