@monterosa/sdk-core 0.17.1-rc.6

package/dist/index.esm5.js

@@ -0,0 +1,395 @@
+import { v4 } from 'uuid';
+import { checkAvailability, getItem, setItem } from '@monterosa/sdk-util';
+
+var version = "0.17.1";
+
+/**
+ * @license
+ * constants.ts
+ * core
+ *
+ * Created by Rygor Kharytanovich <rygor@monterosa.co.uk> on 2023-03-21
+ * Copyright © 2023 Monterosa. All rights reserved.
+ *
+ * More details on the license can be found at https://www.monterosa.co/sdk/license
+ */
+/**
+ * Default sdk name.
+ *
+ * @internal
+ */
+var DEFAULT_SDK_NAME = '[DEFAULT]';
+/**
+ * The current SDK version.
+ *
+ * @public
+ */
+var VERSION = version;
+/**
+ * Device ID storage key name
+ *
+ * @internal
+ */
+var DEVICE_ID_KEY = 'device_id';
+
+/*! *****************************************************************************
+Copyright (c) Microsoft Corporation.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+***************************************************************************** */
+
+var __assign = function() {
+    __assign = Object.assign || function __assign(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p)) t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+
+function __spreadArray(to, from) {
+    for (var i = 0, il = from.length, j = to.length; i < il; i++, j++)
+        to[j] = from[i];
+    return to;
+}
+
+/**
+ * @license
+ * sdk.ts
+ * core
+ *
+ * Created by Rygor Kharytanovich <rygor@monterosa.co.uk> on 2021-09-23
+ * Copyright © 2022 Monterosa. All rights reserved.
+ *
+ * More details on the license can be found at https://www.monterosa.co/sdk/license
+ */
+/**
+ * @internal
+ */
+var Sdk = /** @class */ (function () {
+    function Sdk(options, name) {
+        this._isDestroyed = false;
+        this._options = __assign({}, options);
+        this._name = name;
+        this._kits = new Map();
+    }
+    Object.defineProperty(Sdk.prototype, "name", {
+        get: function () {
+            this.checkDestroyed();
+            return this._name;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(Sdk.prototype, "options", {
+        get: function () {
+            this.checkDestroyed();
+            return this._options;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(Sdk.prototype, "isDestroyed", {
+        get: function () {
+            return this._isDestroyed;
+        },
+        set: function (value) {
+            this._isDestroyed = value;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(Sdk.prototype, "kits", {
+        get: function () {
+            return this._kits;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Sdk.prototype.deleteKits = function () {
+        var _this = this;
+        this.kits.forEach(function (kit, name) {
+            _this.kits.delete(name);
+            kit.delete();
+        });
+    };
+    Sdk.prototype.checkDestroyed = function () {
+        if (this.isDestroyed) {
+            throw new Error("SDK named " + this.name + " destroyed");
+        }
+    };
+    return Sdk;
+}());
+/**
+ * @internal
+ */
+function addKit(sdk, name, kit) {
+    sdk.kits.set(name, kit);
+}
+/**
+ * @internal
+ */
+function getKit(sdk, name) {
+    return sdk.kits.get(name);
+}
+/**
+ * @internal
+ */
+function deleteKit(sdk, name) {
+    sdk.kits.delete(name);
+}
+
+/**
+ * @license
+ * api.ts
+ * core
+ *
+ * Created by Rygor Kharytanovich <rygor@monterosa.co.uk> on 2022-02-15
+ * Copyright © 2022 Monterosa. All rights reserved.
+ *
+ * More details on the license can be found at https://www.monterosa.co/sdk/license
+ */
+var sdks = new Map();
+var DEVICE_ID;
+/**
+ * An array of all configured sdks.
+ *
+ * @public
+ */
+function getSdks() {
+    return Array.from(sdks.values());
+}
+/**
+ * Retrieves an SDK instance by its name.
+ *
+ * @example
+ * ```javascript
+ * const sdk = getSdk('my-sdk');
+ * ```
+ *
+ * @param name - Optional name of the sdk to initialise.
+ *   If name is not provided, the default is "[DEFAULT]"
+ *
+ * @public
+ */
+function getSdk(name) {
+    if (name === void 0) { name = DEFAULT_SDK_NAME; }
+    var sdk = sdks.get(name);
+    if (!sdk) {
+        throw new Error("No Monterosa Sdk \"" + name + "\" has been configured.\n        You need to call configure() first");
+    }
+    return sdk;
+}
+/**
+ * @internal
+ */
+function getDeviceId() {
+    if (DEVICE_ID !== undefined) {
+        return DEVICE_ID;
+    }
+    if (!checkAvailability()) {
+        DEVICE_ID = v4();
+        return DEVICE_ID;
+    }
+    var value = getItem(DEVICE_ID_KEY);
+    if (value === null) {
+        DEVICE_ID = v4();
+        setItem(DEVICE_ID_KEY, DEVICE_ID);
+    }
+    else {
+        DEVICE_ID = value;
+    }
+    return DEVICE_ID;
+}
+/**
+ * Creates an SDK instance.
+ *
+ * @example
+ *
+ * Configure default sdk with host and project id
+ *
+ * ```javascript
+ * configure({
+ *   host: "...",
+ *   projectId: "..."
+ * });
+ * ```
+ *
+ * @param options - Studio host
+ * @param name - Optional name of the sdk to initialise.
+ *   If name is not provided, the default is "[DEFAULT]"
+ *
+ * @returns Configured SDK instance.
+ *
+ * @public
+ */
+function configure(options, name) {
+    if (name === void 0) { name = DEFAULT_SDK_NAME; }
+    var existingSdk = sdks.get(name);
+    if (existingSdk) {
+        return existingSdk;
+    }
+    var sdk = new Sdk(options, name);
+    sdks.set(name, sdk);
+    return sdk;
+}
+/**
+ * Destroy initialised sdk
+ *
+ * @example
+ * ```javascript
+ * const sdk = configure(...);
+ *
+ * destroy(sdk);
+ * ```
+ *
+ * @param sdk - sdk instance
+ */
+function destroy(sdk) {
+    var name = sdk.name;
+    sdks.delete(name);
+    sdk.deleteKits();
+    sdk.isDestroyed = true;
+}
+
+/**
+ * @license
+ * logger.ts
+ * core
+ *
+ * Created by Rygor Kharytanovich <rygor@monterosa.co.uk> on 2022-05-31
+ * Copyright © 2022 Monterosa. All rights reserved.
+ *
+ * More details on the license can be found at https://www.monterosa.co/sdk/license
+ */
+var _a;
+/* eslint-disable no-console */
+/**
+ * Represents the possible log levels.
+ */
+var LogLevel;
+(function (LogLevel) {
+    /**
+     * Verbose level. Provides detailed and extensive logging.
+     */
+    LogLevel[LogLevel["Verbose"] = 0] = "Verbose";
+    /**
+     * Debug level. Used for debugging and development purposes.
+     */
+    LogLevel[LogLevel["Debug"] = 1] = "Debug";
+    /**
+     * Info level. Used to provide general information about the system's state.
+     */
+    LogLevel[LogLevel["Info"] = 2] = "Info";
+    /**
+     * Warn level. Indicates potential issues or situations that might cause problems in the future.
+     */
+    LogLevel[LogLevel["Warn"] = 3] = "Warn";
+    /**
+     * Error level. Indicates critical errors and issues that require immediate attention.
+     */
+    LogLevel[LogLevel["Error"] = 4] = "Error";
+    /**
+     * Silent level. No logs will be output.
+     */
+    LogLevel[LogLevel["Silent"] = 5] = "Silent";
+})(LogLevel || (LogLevel = {}));
+var Methods = (_a = {},
+    _a[LogLevel.Verbose] = 'log',
+    // `console.debug` is not shown in Chrome and Edge by default. It must be
+    // enabled manually. To avoid hassle for developers with settings debug
+    // messages are sent to `console.log`
+    _a[LogLevel.Debug] = 'log',
+    _a[LogLevel.Info] = 'info',
+    _a[LogLevel.Warn] = 'warn',
+    _a[LogLevel.Error] = 'error',
+    _a);
+var logHandler = function (logger, logLevel) {
+    var args = [];
+    for (var _i = 2; _i < arguments.length; _i++) {
+        args[_i - 2] = arguments[_i];
+    }
+    if (logger.logLevel > logLevel) {
+        return;
+    }
+    var method = Methods[logLevel];
+    console[method].apply(console, __spreadArray([new Date().toISOString().replace(/[TZ]/gi, ' ').trim(), LogLevel[logLevel] + "/" + logger.name + ":"], args));
+};
+/** @internal */
+var Logger = /** @class */ (function () {
+    function Logger(name) {
+        this.name = name;
+        this._logLevel = LogLevel.Warn;
+        this._logHandler = logHandler;
+    }
+    Object.defineProperty(Logger.prototype, "logLevel", {
+        get: function () {
+            return this._logLevel;
+        },
+        set: function (level) {
+            this._logLevel = level;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(Logger.prototype, "logHandler", {
+        get: function () {
+            return this._logHandler;
+        },
+        set: function (handler) {
+            this.logHandler = handler;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Logger.prototype.log = function () {
+        var args = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            args[_i] = arguments[_i];
+        }
+        this.logHandler.apply(this, __spreadArray([this, LogLevel.Verbose], args));
+    };
+    Logger.prototype.debug = function () {
+        var args = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            args[_i] = arguments[_i];
+        }
+        this.logHandler.apply(this, __spreadArray([this, LogLevel.Debug], args));
+    };
+    Logger.prototype.info = function () {
+        var args = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            args[_i] = arguments[_i];
+        }
+        this.logHandler.apply(this, __spreadArray([this, LogLevel.Info], args));
+    };
+    Logger.prototype.warn = function () {
+        var args = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            args[_i] = arguments[_i];
+        }
+        this.logHandler.apply(this, __spreadArray([this, LogLevel.Warn], args));
+    };
+    Logger.prototype.error = function () {
+        var args = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            args[_i] = arguments[_i];
+        }
+        this.logHandler.apply(this, __spreadArray([this, LogLevel.Error], args));
+    };
+    return Logger;
+}());
+
+export { DEFAULT_SDK_NAME, DEVICE_ID_KEY, LogLevel, Logger, Sdk, VERSION, addKit, configure, deleteKit, destroy, getDeviceId, getKit, getSdk, getSdks };
+//# sourceMappingURL=index.esm5.js.map

package/dist/index.esm5.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm5.js","sources":["../src/constants.ts","../src/sdk.ts","../src/api.ts","../src/utils/logger.ts"],"sourcesContent":["/**\n * @license\n * constants.ts\n * core\n *\n * Created by Rygor Kharytanovich <rygor@monterosa.co.uk> on 2023-03-21\n * Copyright © 2023 Monterosa. All rights reserved.\n *\n * More details on the license can be found at https://www.monterosa.co/sdk/license\n */\n\nimport { version } from '../package.json';\n\n/**\n * Default sdk name.\n *\n * @internal\n */\nexport const DEFAULT_SDK_NAME = '[DEFAULT]';\n\n/**\n * The current SDK version.\n *\n * @public\n */\nexport const VERSION = version;\n\n/**\n * Device ID storage key name\n *\n * @internal\n */\nexport const DEVICE_ID_KEY = 'device_id';\n","/**\n * @license\n * sdk.ts\n * core\n *\n * Created by Rygor Kharytanovich <rygor@monterosa.co.uk> on 2021-09-23\n * Copyright © 2022 Monterosa. All rights reserved.\n *\n * More details on the license can be found at https://www.monterosa.co/sdk/license\n */\n\nimport { MonterosaSdk, MonterosaKit, Kits, SdkOptions } from './types';\n\n/**\n * @internal\n */\nexport class Sdk implements MonterosaSdk {\n  private readonly _options: SdkOptions;\n  private readonly _name: string;\n  private _isDestroyed: boolean = false;\n  private _kits: Kits;\n\n  constructor(options: SdkOptions, name: string) {\n    this._options = { ...options };\n    this._name = name;\n    this._kits = new Map();\n  }\n\n  get name(): string {\n    this.checkDestroyed();\n    return this._name;\n  }\n\n  get options(): SdkOptions {\n    this.checkDestroyed();\n    return this._options;\n  }\n\n  get isDestroyed(): boolean {\n    return this._isDestroyed;\n  }\n\n  get kits(): Kits {\n    return this._kits;\n  }\n\n  set isDestroyed(value: boolean) {\n    this._isDestroyed = value;\n  }\n\n  public deleteKits() {\n    this.kits.forEach((kit, name) => {\n      this.kits.delete(name);\n      kit.delete();\n    });\n  }\n\n  private checkDestroyed(): void {\n    if (this.isDestroyed) {\n      throw new Error(`SDK named ${this.name} destroyed`);\n    }\n  }\n}\n\n/**\n * @internal\n */\nexport function addKit(sdk: MonterosaSdk, name: string, kit: MonterosaKit) {\n  sdk.kits.set(name, kit);\n}\n\n/**\n * @internal\n */\nexport function getKit(\n  sdk: MonterosaSdk,\n  name: string,\n): MonterosaKit | undefined {\n  return sdk.kits.get(name);\n}\n\n/**\n * @internal\n */\nexport function deleteKit(sdk: MonterosaSdk, name: string): void {\n  sdk.kits.delete(name);\n}\n","/**\n * @license\n * api.ts\n * core\n *\n * Created by Rygor Kharytanovich <rygor@monterosa.co.uk> on 2022-02-15\n * Copyright © 2022 Monterosa. All rights reserved.\n *\n * More details on the license can be found at https://www.monterosa.co/sdk/license\n */\n\nimport { v4 as uuidv4 } from 'uuid';\nimport {\n  getItem as getStorageItem,\n  setItem as setStorageItem,\n  checkAvailability as checkStorageAvailability,\n} from '@monterosa/sdk-util';\n\nimport { MonterosaSdk, SdkOptions } from './types';\nimport { DEFAULT_SDK_NAME, DEVICE_ID_KEY } from './constants';\nimport { Sdk } from './sdk';\n\nconst sdks = new Map<string, MonterosaSdk>();\n\nlet DEVICE_ID: string;\n\n/**\n * An array of all configured sdks.\n *\n * @public\n */\nexport function getSdks(): MonterosaSdk[] {\n  return Array.from(sdks.values());\n}\n\n/**\n * Retrieves an SDK instance by its name.\n *\n * @example\n * ```javascript\n * const sdk = getSdk('my-sdk');\n * ```\n *\n * @param name - Optional name of the sdk to initialise.\n *   If name is not provided, the default is \"[DEFAULT]\"\n *\n * @public\n */\nexport function getSdk(name: string = DEFAULT_SDK_NAME): MonterosaSdk {\n  const sdk = sdks.get(name);\n\n  if (!sdk) {\n    throw new Error(\n      `No Monterosa Sdk \"${name}\" has been configured.\n        You need to call configure() first`,\n    );\n  }\n\n  return sdk;\n}\n\n/**\n * @internal\n */\nexport function getDeviceId() {\n  if (DEVICE_ID !== undefined) {\n    return DEVICE_ID;\n  }\n\n  if (!checkStorageAvailability()) {\n    DEVICE_ID = uuidv4();\n\n    return DEVICE_ID;\n  }\n\n  const value = getStorageItem(DEVICE_ID_KEY);\n\n  if (value === null) {\n    DEVICE_ID = uuidv4();\n\n    setStorageItem(DEVICE_ID_KEY, DEVICE_ID);\n  } else {\n    DEVICE_ID = value;\n  }\n\n  return DEVICE_ID;\n}\n\n/**\n * Creates an SDK instance.\n *\n * @example\n *\n * Configure default sdk with host and project id\n *\n * ```javascript\n * configure({\n *   host: \"...\",\n *   projectId: \"...\"\n * });\n * ```\n *\n * @param options - Studio host\n * @param name - Optional name of the sdk to initialise.\n *   If name is not provided, the default is \"[DEFAULT]\"\n *\n * @returns Configured SDK instance.\n *\n * @public\n */\nexport function configure(\n  options: SdkOptions,\n  name: string = DEFAULT_SDK_NAME,\n): MonterosaSdk {\n  const existingSdk = sdks.get(name);\n\n  if (existingSdk) {\n    return existingSdk;\n  }\n\n  const sdk = new Sdk(options, name);\n\n  sdks.set(name, sdk);\n\n  return sdk;\n}\n\n/**\n * Destroy initialised sdk\n *\n * @example\n * ```javascript\n * const sdk = configure(...);\n *\n * destroy(sdk);\n * ```\n *\n * @param sdk - sdk instance\n */\nexport function destroy(sdk: MonterosaSdk) {\n  const { name } = sdk;\n\n  sdks.delete(name);\n  sdk.deleteKits();\n  sdk.isDestroyed = true;\n}\n","/**\n * @license\n * logger.ts\n * core\n *\n * Created by Rygor Kharytanovich <rygor@monterosa.co.uk> on 2022-05-31\n * Copyright © 2022 Monterosa. All rights reserved.\n *\n * More details on the license can be found at https://www.monterosa.co/sdk/license\n */\n\n/* eslint-disable no-console */\n\n/**\n * Represents the possible log levels.\n */\nexport enum LogLevel {\n  /**\n   * Verbose level. Provides detailed and extensive logging.\n   */\n  Verbose,\n  /**\n   * Debug level. Used for debugging and development purposes.\n   */\n  Debug,\n  /**\n   * Info level. Used to provide general information about the system's state.\n   */\n  Info,\n  /**\n   * Warn level. Indicates potential issues or situations that might cause problems in the future.\n   */\n  Warn,\n  /**\n   * Error level. Indicates critical errors and issues that require immediate attention.\n   */\n  Error,\n  /**\n   * Silent level. No logs will be output.\n   */\n  Silent,\n}\n\n/** @internal */\nexport type LogHandler = (\n  logger: Logger,\n  logType: LogLevel,\n  ...args: unknown[]\n) => void;\n\nconst Methods = {\n  [LogLevel.Verbose]: 'log',\n  // `console.debug` is not shown in Chrome and Edge by default. It must be\n  // enabled manually. To avoid hassle for developers with settings debug\n  // messages are sent to `console.log`\n  [LogLevel.Debug]: 'log',\n  [LogLevel.Info]: 'info',\n  [LogLevel.Warn]: 'warn',\n  [LogLevel.Error]: 'error',\n} as const;\n\nconst logHandler: LogHandler = (logger, logLevel, ...args) => {\n  if (logger.logLevel > logLevel) {\n    return;\n  }\n\n  const method = Methods[logLevel as keyof typeof Methods];\n\n  console[method](\n    new Date().toISOString().replace(/[TZ]/gi, ' ').trim(),\n    `${LogLevel[logLevel]}/${logger.name}:`,\n    ...args,\n  );\n};\n\n/** @internal */\nexport class Logger {\n  private _logLevel: LogLevel = LogLevel.Warn;\n  private _logHandler: LogHandler = logHandler;\n\n  constructor(public name: string) {}\n\n  get logLevel(): LogLevel {\n    return this._logLevel;\n  }\n\n  set logLevel(level: LogLevel) {\n    this._logLevel = level;\n  }\n\n  get logHandler(): LogHandler {\n    return this._logHandler;\n  }\n\n  set logHandler(handler: LogHandler) {\n    this.logHandler = handler;\n  }\n\n  log(...args: unknown[]) {\n    this.logHandler(this, LogLevel.Verbose, ...args);\n  }\n\n  debug(...args: unknown[]) {\n    this.logHandler(this, LogLevel.Debug, ...args);\n  }\n\n  info(...args: unknown[]) {\n    this.logHandler(this, LogLevel.Info, ...args);\n  }\n\n  warn(...args: unknown[]) {\n    this.logHandler(this, LogLevel.Warn, ...args);\n  }\n\n  error(...args: unknown[]) {\n    this.logHandler(this, LogLevel.Error, ...args);\n  }\n}\n"],"names":["checkStorageAvailability","uuidv4","getStorageItem","setStorageItem"],"mappings":"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"}

package/dist/src/api.d.ts

@@ -0,0 +1,71 @@
+/**
+ * @license
+ * api.ts
+ * core
+ *
+ * Created by Rygor Kharytanovich <rygor@monterosa.co.uk> on 2022-02-15
+ * Copyright © 2022 Monterosa. All rights reserved.
+ *
+ * More details on the license can be found at https://www.monterosa.co/sdk/license
+ */
+import { MonterosaSdk, SdkOptions } from './types';
+/**
+ * An array of all configured sdks.
+ *
+ * @public
+ */
+export declare function getSdks(): MonterosaSdk[];
+/**
+ * Retrieves an SDK instance by its name.
+ *
+ * @example
+ * ```javascript
+ * const sdk = getSdk('my-sdk');
+ * ```
+ *
+ * @param name - Optional name of the sdk to initialise.
+ *   If name is not provided, the default is "[DEFAULT]"
+ *
+ * @public
+ */
+export declare function getSdk(name?: string): MonterosaSdk;
+/**
+ * @internal
+ */
+export declare function getDeviceId(): string;
+/**
+ * Creates an SDK instance.
+ *
+ * @example
+ *
+ * Configure default sdk with host and project id
+ *
+ * ```javascript
+ * configure({
+ *   host: "...",
+ *   projectId: "..."
+ * });
+ * ```
+ *
+ * @param options - Studio host
+ * @param name - Optional name of the sdk to initialise.
+ *   If name is not provided, the default is "[DEFAULT]"
+ *
+ * @returns Configured SDK instance.
+ *
+ * @public
+ */
+export declare function configure(options: SdkOptions, name?: string): MonterosaSdk;
+/**
+ * Destroy initialised sdk
+ *
+ * @example
+ * ```javascript
+ * const sdk = configure(...);
+ *
+ * destroy(sdk);
+ * ```
+ *
+ * @param sdk - sdk instance
+ */
+export declare function destroy(sdk: MonterosaSdk): void;

package/dist/src/constants.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @license
+ * constants.ts
+ * core
+ *
+ * Created by Rygor Kharytanovich <rygor@monterosa.co.uk> on 2023-03-21
+ * Copyright © 2023 Monterosa. All rights reserved.
+ *
+ * More details on the license can be found at https://www.monterosa.co/sdk/license
+ */
+/**
+ * Default sdk name.
+ *
+ * @internal
+ */
+export declare const DEFAULT_SDK_NAME = "[DEFAULT]";
+/**
+ * The current SDK version.
+ *
+ * @public
+ */
+export declare const VERSION: string;
+/**
+ * Device ID storage key name
+ *
+ * @internal
+ */
+export declare const DEVICE_ID_KEY = "device_id";

package/dist/src/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @license
+ * index.ts
+ * core
+ *
+ * Created by Rygor Kharytanovich <rygor@monterosa.co.uk> on 2021-09-23
+ * Copyright © 2022 Monterosa. All rights reserved.
+ *
+ * More details on the license can be found at https://www.monterosa.co/sdk/license
+ */
+/**
+ * Monterosa SDK / Core
+ *
+ * @packageDocumentation
+ */
+export * from './constants';
+export * from './api';
+export * from './sdk';
+export * from './types';
+export * from './utils/logger';

package/dist/src/sdk.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @license
+ * sdk.ts
+ * core
+ *
+ * Created by Rygor Kharytanovich <rygor@monterosa.co.uk> on 2021-09-23
+ * Copyright © 2022 Monterosa. All rights reserved.
+ *
+ * More details on the license can be found at https://www.monterosa.co/sdk/license
+ */
+import { MonterosaSdk, MonterosaKit, Kits, SdkOptions } from './types';
+/**
+ * @internal
+ */
+export declare class Sdk implements MonterosaSdk {
+    private readonly _options;
+    private readonly _name;
+    private _isDestroyed;
+    private _kits;
+    constructor(options: SdkOptions, name: string);
+    get name(): string;
+    get options(): SdkOptions;
+    get isDestroyed(): boolean;
+    get kits(): Kits;
+    set isDestroyed(value: boolean);
+    deleteKits(): void;
+    private checkDestroyed;
+}
+/**
+ * @internal
+ */
+export declare function addKit(sdk: MonterosaSdk, name: string, kit: MonterosaKit): void;
+/**
+ * @internal
+ */
+export declare function getKit(sdk: MonterosaSdk, name: string): MonterosaKit | undefined;
+/**
+ * @internal
+ */
+export declare function deleteKit(sdk: MonterosaSdk, name: string): void;

package/dist/src/types.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @license
+ * types.ts
+ * core
+ *
+ * Created by Rygor Kharytanovich <rygor@monterosa.co.uk> on 2021-09-23
+ * Copyright © 2022 Monterosa. All rights reserved.
+ *
+ * More details on the license can be found at https://www.monterosa.co/sdk/license
+ */
+/** @internal */
+export declare type Kits = Map<string, MonterosaKit>;
+/**
+ * Configuration object that used to initialise SDK and kits. Required values
+ * can be found in Monterosa / Interaction Cloud under
+ * {@link https://products.monterosa.co/mic/producer-guide/studio/project-settings | Project Settings tab}.
+ */
+export interface SdkOptions {
+    /**
+     * Studio instance host
+     */
+    readonly host: string;
+    /**
+     * Unique identifier for the Studio project
+     */
+    readonly projectId: string;
+}
+/**
+ * Monterosa SDK holds the information about the initialised SDK
+ */
+export interface MonterosaSdk {
+    /**
+     * SDK options
+     */
+    readonly options: SdkOptions;
+    /**
+     * SDK name
+     */
+    readonly name: string;
+    /**
+     * @internal
+     */
+    isDestroyed: boolean;
+    /**
+     * @internal
+     */
+    kits: Kits;
+    /**
+     * @internal
+     */
+    deleteKits(): void;
+}
+/** @internal */
+export interface MonterosaKit {
+    delete(): void;
+}

package/dist/src/utils/logger.d.ts

@@ -0,0 +1,57 @@
+/**
+ * @license
+ * logger.ts
+ * core
+ *
+ * Created by Rygor Kharytanovich <rygor@monterosa.co.uk> on 2022-05-31
+ * Copyright © 2022 Monterosa. All rights reserved.
+ *
+ * More details on the license can be found at https://www.monterosa.co/sdk/license
+ */
+/**
+ * Represents the possible log levels.
+ */
+export declare enum LogLevel {
+    /**
+     * Verbose level. Provides detailed and extensive logging.
+     */
+    Verbose = 0,
+    /**
+     * Debug level. Used for debugging and development purposes.
+     */
+    Debug = 1,
+    /**
+     * Info level. Used to provide general information about the system's state.
+     */
+    Info = 2,
+    /**
+     * Warn level. Indicates potential issues or situations that might cause problems in the future.
+     */
+    Warn = 3,
+    /**
+     * Error level. Indicates critical errors and issues that require immediate attention.
+     */
+    Error = 4,
+    /**
+     * Silent level. No logs will be output.
+     */
+    Silent = 5
+}
+/** @internal */
+export declare type LogHandler = (logger: Logger, logType: LogLevel, ...args: unknown[]) => void;
+/** @internal */
+export declare class Logger {
+    name: string;
+    private _logLevel;
+    private _logHandler;
+    constructor(name: string);
+    get logLevel(): LogLevel;
+    set logLevel(level: LogLevel);
+    get logHandler(): LogHandler;
+    set logHandler(handler: LogHandler);
+    log(...args: unknown[]): void;
+    debug(...args: unknown[]): void;
+    info(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+}