kuzzle 2.31.0-elasticsearch-8.2 → 2.31.0

package/lib/api/controllers/authController.d.ts

@@ -1,4 +1,3 @@
-import Bluebird from "bluebird";
 import { KuzzleRequest } from "../request";
 import { NativeController } from "./baseController";
 export declare class AuthController extends NativeController {
@@ -79,7 +78,7 @@ export declare class AuthController extends NativeController {
      * @param {KuzzleRequest} request
      * @returns {Promise<Object>}
      */
-    getCurrentUser(request: any): Bluebird<any>;
+    getCurrentUser(request: any): any;
     /**
      * Returns the rights of the user identified by the given jwt token
      *
@@ -116,7 +115,7 @@ export declare class AuthController extends NativeController {
      *
      * @returns {Promise.<string[]>}
      */
-    getStrategies(): Bluebird<any>;
+    getStrategies(): any;
     /**
      * @param {KuzzleRequest} request
      * @returns {Promise.<Object>}

package/lib/api/controllers/memoryStorageController.js

@@ -267,11 +267,15 @@ function initMapping() {
           kassert.assertBodyAttributeType(request, "entries", "array");
 
           val.forEach((v) => {
-            if (typeof v !== "object" || !v.field || !v.value) {
+            if (
+              typeof v !== "object" ||
+              !v.field ||
+              (!v.value && v.value !== 0)
+            ) {
               throw kerror.get(
                 "invalid_argument",
                 "entries",
-                "<array of object>",
+                "<array of objects>",
               );
             }
 
@@ -348,7 +352,11 @@ function initMapping() {
           kassert.assertBodyHasAttribute(request, "entries");
           kassert.assertBodyAttributeType(request, "entries", "array");
           val.forEach((entry) => {
-            if (typeof entry !== "object" || !entry.key || !entry.value) {
+            if (
+              typeof entry !== "object" ||
+              !entry.key ||
+              (!entry.value && entry.value !== 0)
+            ) {
               throw kerror.get(
                 "invalid_argument",
                 "entries",

package/lib/api/funnel.js

@@ -753,6 +753,9 @@ class Funnel {
    */
   async executePluginRequest(request) {
     try {
+      if (request.input.triggerEvents) {
+        return await this.processRequest(request);
+      }
       return await doAction(this.getController(request), request);
     } catch (e) {
       this.handleErrorDump(e);

package/lib/api/request/requestInput.d.ts

@@ -135,6 +135,8 @@ export declare class RequestInput {
      */
     get action(): string | null;
     set action(str: string);
+    get triggerEvents(): boolean | undefined;
+    set triggerEvents(bool: boolean);
     /**
      * Request body.
      * In Http it's the request body parsed.

package/lib/api/request/requestInput.js

@@ -54,6 +54,7 @@ const _body = "body\u200b";
 const _headers = "headers\u200b";
 const _controller = "controller\u200b";
 const _action = "action\u200b";
+const _triggerEvents = "triggerEvents\u200b";
 // any property not listed here will be copied into
 // RequestInput.args
 const resourceProperties = new Set([
@@ -126,6 +127,7 @@ class RequestInput {
         this[_body] = null;
         this[_controller] = null;
         this[_action] = null;
+        this[_triggerEvents] = null;
         // default value to null for former "resources" to avoid breaking
         this.args = {};
         this.resource = new RequestResource(this.args);
@@ -147,6 +149,7 @@ class RequestInput {
         this.body = data.body;
         this.controller = data.controller;
         this.action = data.action;
+        this.triggerEvents = data.triggerEvents;
     }
     /**
      * Authentication token.
@@ -223,6 +226,12 @@ class RequestInput {
             this[_action] = assert.assertString("action", str);
         }
     }
+    get triggerEvents() {
+        return this[_triggerEvents];
+    }
+    set triggerEvents(bool) {
+        this[_triggerEvents] = bool === true ? true : undefined;
+    }
     /**
      * Request body.
      * In Http it's the request body parsed.

package/lib/config/default.config.js

@@ -275,7 +275,6 @@ const defaultConfig = {
             bootstrapLockTimeout: 60000,
         },
         storageEngine: {
-            majorVersion: "7",
             aliases: ["storageEngine"],
             backend: "elasticsearch",
             client: {

package/lib/core/backend/backendStorage.d.ts

@@ -1,17 +1,19 @@
-import { ApplicationManager } from "./index";
+import { Client } from "@elastic/elasticsearch";
+import { ApplicationManager, Backend } from "./index";
 export declare class BackendStorage extends ApplicationManager {
     private _client;
     private _Client;
+    constructor(application: Backend);
     /**
      * Storage client constructor.
      * (Currently Elasticsearch)
      *
      * @param clientConfig Overload configuration for the underlaying storage client
      */
-    get StorageClient(): new (clientConfig?: any) => any;
+    get StorageClient(): new (clientConfig?: any) => Client;
     /**
      * Access to the underlaying storage engine client.
      * (Currently Elasticsearch)
      */
-    get storageClient(): any;
+    get storageClient(): Client;
 }

package/lib/core/backend/backendStorage.js

@@ -19,13 +19,16 @@
  * 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 });
 exports.BackendStorage = void 0;
-const Elasticsearch_1 = require("../../service/storage/Elasticsearch");
+const elasticsearch_1 = __importDefault(require("../../service/storage/elasticsearch"));
 const index_1 = require("./index");
 class BackendStorage extends index_1.ApplicationManager {
-    constructor() {
-        super(...arguments);
+    constructor(application) {
+        super(application);
         this._client = null;
         this._Client = null;
     }
@@ -36,13 +39,13 @@ class BackendStorage extends index_1.ApplicationManager {
      * @param clientConfig Overload configuration for the underlaying storage client
      */
     get StorageClient() {
-        const kuzzle = this._kuzzle;
         if (!this._Client) {
+            const kuzzle = this._kuzzle;
             this._Client = function ESClient(clientConfig = {}) {
-                return Elasticsearch_1.Elasticsearch.buildClient({
+                return elasticsearch_1.default.buildClient({
                     ...kuzzle.config.services.storageEngine.client,
                     ...clientConfig,
-                }, kuzzle.config.services.storageEngine.majorVersion);
+                });
             };
         }
         return this._Client;
@@ -52,9 +55,8 @@ class BackendStorage extends index_1.ApplicationManager {
      * (Currently Elasticsearch)
      */
     get storageClient() {
-        const kuzzle = this._kuzzle;
         if (!this._client) {
-            this._client = Elasticsearch_1.Elasticsearch.buildClient(kuzzle.config.services.storageEngine.client, kuzzle.config.services.storageEngine.majorVersion);
+            this._client = elasticsearch_1.default.buildClient(this._kuzzle.config.services.storageEngine.client);
         }
         return this._client;
     }

package/lib/core/plugin/pluginContext.d.ts

@@ -1,5 +1,6 @@
-import { Koncorde } from "../shared/KoncordeWrapper";
+import { Client } from "@elastic/elasticsearch";
 import { JSONObject } from "kuzzle-sdk";
+import { Koncorde } from "../shared/KoncordeWrapper";
 import { KuzzleRequest, RequestContext, RequestInput } from "../../../index";
 import { Mutex } from "../../util/mutex";
 import { BackendCluster } from "../backend";
@@ -121,7 +122,7 @@ export declare class PluginContext {
         /**
          * Constructor for Elasticsearch SDK Client
          */
-        ESClient: new () => any;
+        ESClient: typeof Client;
     };
     /**
      * @deprecated import directly: `import { BadRequestError, ... } from 'kuzzle'`

package/lib/core/plugin/pluginContext.js

@@ -52,7 +52,7 @@ const KoncordeWrapper_1 = require("../shared/KoncordeWrapper");
 const index_1 = require("../../../index");
 const kerror = __importStar(require("../../kerror"));
 const errors_1 = require("../../kerror/errors");
-const Elasticsearch_1 = require("../../service/storage/Elasticsearch");
+const elasticsearch_1 = __importDefault(require("../../service/storage/elasticsearch"));
 const mutex_1 = require("../../util/mutex");
 const promback_1 = __importDefault(require("../../util/promback"));
 const safeObject_1 = require("../../util/safeObject");
@@ -111,8 +111,9 @@ class PluginContext {
                 update: (...args) => pluginRepository.update(...args),
             };
         }
+        // eslint-disable-next-line no-inner-declarations
         function PluginContextESClient() {
-            return Elasticsearch_1.Elasticsearch.buildClient(global.kuzzle.config.services.storageEngine.client);
+            return elasticsearch_1.default.buildClient(global.kuzzle.config.services.storageEngine.client);
         }
         this.constructors = {
             BaseValidationType: require("../validation/baseType"),
@@ -251,10 +252,7 @@ function instantiateRequest(request, data, options = {}) {
             target.input.jwt = _request.input.jwt;
         }
         if (_data) {
-            target.input.volatile = {
-                ..._request.input.volatile,
-                ..._data.volatile,
-            };
+            target.input.volatile = Object.assign({}, _request.input.volatile, _data.volatile);
         }
         else {
             target.input.volatile = _request.input.volatile;

package/lib/core/security/profileRepository.d.ts

@@ -29,7 +29,6 @@ type UpdateOptions = {
  */
 export declare class ProfileRepository extends ObjectRepository<Profile> {
     private module;
-    private profiles;
     /**
      * @constructor
      */
@@ -42,7 +41,9 @@ export declare class ProfileRepository extends ObjectRepository<Profile> {
      * @returns {Promise.<Promise>}
      * @throws {NotFoundError} If the corresponding profile doesn't exist
      */
-    load(id: string): Promise<Profile>;
+    load(id: string, options?: {
+        key?: string;
+    }): Promise<Profile>;
     /**
      * Loads a Profile object given its id.
      * Stores the promise of the profile being loaded in the memcache
@@ -140,16 +141,6 @@ export declare class ProfileRepository extends ObjectRepository<Profile> {
      * @returns {Promise<Profile>}
      */
     fromDTO(dto: JSONObject): Promise<Profile>;
-    /**
-     * @override
-     */
-    truncate(opts: JSONObject): Promise<void>;
-    /**
-     * Invalidate the cache entries for the given profile. If none is provided,
-     * the entire cache is emptied.
-     * @param {string} [profileId]
-     */
-    invalidate(profileId?: string): void;
     /**
      * Optimize each policy to get a O(1) index access time
      * and a O(log(n)) collection search time.
@@ -168,8 +159,8 @@ export declare class ProfileRepository extends ObjectRepository<Profile> {
      * @param policy
      */
     private optimizePolicy;
-    toDTO(dto: Profile): Promise<JSONObject>;
-    deleteFromDatabase(id: string, options: JSONObject): Promise<any>;
+    toDTO(dto: Profile): JSONObject;
+    deleteFromDatabase(id: string, options: JSONObject): any;
     search(searchBody: JSONObject, options: JSONObject): Promise<{
         aggregations: any;
         hits: any[];

package/lib/core/security/profileRepository.js

@@ -51,7 +51,6 @@ const bluebird_1 = __importDefault(require("bluebird"));
 const lodash_1 = require("lodash");
 const kerror = __importStar(require("../../kerror"));
 const profile_1 = require("../../model/security/profile");
-const cacheDbEnum_1 = require("../cache/cacheDbEnum");
 const ObjectRepository_1 = require("../shared/ObjectRepository");
 /**
  * @class ProfileRepository
@@ -62,12 +61,8 @@ class ProfileRepository extends ObjectRepository_1.ObjectRepository {
      * @constructor
      */
     constructor(securityModule) {
-        super({
-            cache: cacheDbEnum_1.cacheDbEnum.NONE,
-            store: global.kuzzle.internalIndex,
-        });
+        super({ store: global.kuzzle.internalIndex });
         this.module = securityModule;
-        this.profiles = new Map();
         this.collection = "profiles";
         this.ObjectConstructor = profile_1.Profile;
     }
@@ -111,7 +106,7 @@ class ProfileRepository extends ObjectRepository_1.ObjectRepository {
          *
          * @param  {String} [id] - profile identifier
          */
-        global.kuzzle.onAsk("core:security:profile:invalidate", (id) => this.invalidate(id));
+        global.kuzzle.onAsk("core:security:profile:invalidate", (id) => this.deleteFromCache(id));
         /**
          * Gets multiple profiles
          * @param  {Array} ids
@@ -156,13 +151,18 @@ class ProfileRepository extends ObjectRepository_1.ObjectRepository {
      * @returns {Promise.<Promise>}
      * @throws {NotFoundError} If the corresponding profile doesn't exist
      */
-    async load(id) {
-        if (this.profiles.has(id)) {
-            return this.profiles.get(id);
+    async load(id, options = {}) {
+        const profile = await this.loadFromCache(id, options);
+        if (profile === null) {
+            const profileFromDatabase = await this.loadOneFromDatabase(id);
+            if (profileFromDatabase !== null) {
+                await this.persistToCache(profileFromDatabase);
+                profileFromDatabase.optimizedPolicies = this.optimizePolicies(profileFromDatabase.policies);
+            }
+            return profileFromDatabase;
         }
-        const profile = await super.load(id);
         profile.optimizedPolicies = this.optimizePolicies(profile.policies);
-        this.profiles.set(id, profile);
+        await this.refreshCacheTTL(profile);
         return profile;
     }
     /**
@@ -185,14 +185,7 @@ class ProfileRepository extends ObjectRepository_1.ObjectRepository {
             throw kerror.get("api", "assert", "invalid_type", "profileIds", "string[]");
         }
         for (const id of profileIds) {
-            let profile = this.profiles.get(id);
-            if (!profile) {
-                profile = this.loadOneFromDatabase(id).then((p) => {
-                    p.optimizedPolicies = this.optimizePolicies(p.policies);
-                    this.profiles.set(id, p);
-                    return p;
-                });
-            }
+            const profile = this.load(id);
             profiles.push(profile);
         }
         return bluebird_1.default.all(profiles);
@@ -342,7 +335,7 @@ class ProfileRepository extends ObjectRepository_1.ObjectRepository {
             }
         }
         await this.deleteFromDatabase(profile._id, { refresh });
-        this.profiles.delete(profile._id);
+        await this.deleteFromCache(profile._id);
     }
     /**
      * From a Profile object, returns a serialized object ready to be persisted
@@ -384,9 +377,9 @@ class ProfileRepository extends ObjectRepository_1.ObjectRepository {
             retryOnConflict,
         });
         const updatedProfile = await this.loadOneFromDatabase(profile._id);
+        await this.persistToCache(updatedProfile);
         // Recompute optimized policies based on new policies
         updatedProfile.optimizedPolicies = this.optimizePolicies(updatedProfile.policies);
-        this.profiles.set(profile._id, updatedProfile);
         return updatedProfile;
     }
     /**
@@ -410,32 +403,6 @@ class ProfileRepository extends ObjectRepository_1.ObjectRepository {
         }
         return profile;
     }
-    /**
-     * @override
-     */
-    async truncate(opts) {
-        try {
-            await super.truncate(opts);
-        }
-        finally {
-            // always clear the RAM cache: even if truncate fails in the middle of it,
-            // some of the cached profiles might not be valid anymore
-            this.invalidate();
-        }
-    }
-    /**
-     * Invalidate the cache entries for the given profile. If none is provided,
-     * the entire cache is emptied.
-     * @param {string} [profileId]
-     */
-    invalidate(profileId) {
-        if (!profileId) {
-            this.profiles.clear();
-        }
-        else {
-            this.profiles.delete(profileId);
-        }
-    }
     /**
      * Optimize each policy to get a O(1) index access time
      * and a O(log(n)) collection search time.
@@ -496,10 +463,10 @@ class ProfileRepository extends ObjectRepository_1.ObjectRepository {
     // Every method described after are for testing purpose only
     // Otherwise we cannot stub them
     // ============================================
-    async toDTO(dto) {
+    toDTO(dto) {
         return super.toDTO(dto);
     }
-    async deleteFromDatabase(id, options) {
+    deleteFromDatabase(id, options) {
         return super.deleteFromDatabase(id, options);
     }
     async search(searchBody, options) {

package/lib/core/security/roleRepository.js

@@ -43,7 +43,7 @@ class RoleRepository extends ObjectRepository {
    */
   constructor(securityModule) {
     super({
-      cache: cacheDbEnum.NONE,
+      cache: cacheDbEnum.INTERNAL,
       store: global.kuzzle.internalIndex,
     });
 

package/lib/core/shared/ObjectRepository.js

@@ -127,7 +127,7 @@ class ObjectRepository {
         let response;
         try {
             response = await global.kuzzle.ask(`core:cache:${this.cacheDb}:get`, key);
-            if (response === null) {
+            if (response === null || response === undefined) {
                 return null;
             }
             return await this.fromDTO({ ...JSON.parse(response) });

package/lib/core/storage/clientAdapter.js

@@ -21,7 +21,7 @@
 
 "use strict";
 
-const { Elasticsearch } = require("../../service/storage/Elasticsearch");
+const Elasticsearch = require("../../service/storage/elasticsearch");
 const { IndexCache } = require("./indexCache");
 const { isPlainObject } = require("../../util/safeObject");
 const kerror = require("../../kerror");
@@ -38,17 +38,16 @@ class ClientAdapter {
    * @param {storeScopeEnum} scope
    */
   constructor(scope) {
-    this.es = new Elasticsearch(
+    this.client = new Elasticsearch(
       global.kuzzle.config.services.storageEngine,
       scope,
     );
-    this.client = this.es.client;
     this.scope = scope;
     this.cache = new IndexCache();
   }
 
   async init() {
-    await this.es.init();
+    await this.client.init();
     await this.populateCache();
 
     this.registerCollectionEvents();
@@ -203,7 +202,6 @@ class ClientAdapter {
      * @return {Promise}
      * @throws
      */
-
     global.kuzzle.onAsk(
       `core:storage:${this.scope}:collection:create`,
       (index, collection, opts, creationOptions) =>
@@ -456,7 +454,7 @@ class ClientAdapter {
      * @param {string} collection
      * @param {Object} query
      * @param {Object} [opts] -- see Elasticsearch "deleteByQuery" options
-     * @returns {Promise.<{ documents, total, deleted, failures: [ id, reason ] }>}
+     * @returns {Promise.<{ documents, total, deleted, failures: [ _shardId, reason ] }>}
      */
     global.kuzzle.onAsk(
       `core:storage:${this.scope}:document:deleteByQuery`,

package/lib/core/storage/storageEngine.js

@@ -21,6 +21,8 @@
 
 "use strict";
 
+const Bluebird = require("bluebird");
+
 const kerror = require("../../kerror").wrap("services", "storage");
 const ClientAdapter = require("./clientAdapter");
 const { storeScopeEnum } = require("./storeScopeEnum");
@@ -40,12 +42,11 @@ class StorageEngine {
    * @returns {Promise}
    */
   async init() {
-    await Promise.all([this.public.init(), this.private.init()]);
+    await Bluebird.all([this.public.init(), this.private.init()]);
 
-    const privateIndexes = this.private.cache.listIndexes();
-    const publicIndexes = this.public.cache.listIndexes();
+    const privateIndexes = await this.private.cache.listIndexes();
 
-    for (const publicIndex of publicIndexes) {
+    for (const publicIndex of await this.public.cache.listIndexes()) {
       if (privateIndexes.includes(publicIndex)) {
         throw kerror.get("index_already_exists", "public", publicIndex);
       }

package/lib/kuzzle/kuzzle.js

@@ -240,7 +240,7 @@ class Kuzzle extends kuzzleEventEmitter_1.default {
      * @returns {Promise<void>}
      */
     async install(installations) {
-        if (!installations?.length) {
+        if (!installations || !installations.length) {
             return;
         }
         const mutex = new mutex_1.Mutex("backend:installations");

package/lib/service/storage/{7/elasticsearch.d.ts → elasticsearch.d.ts}

@@ -1,18 +1,19 @@
 import _ from "lodash";
-import { RequestParams, Client } from "sdk-es7";
-import { TypeMapping } from "sdk-es7/api/types";
-import { JSONObject, KRequestBody, KRequestParams } from "../../../types/storage/7/Elasticsearch";
+import { RequestParams, Client as StorageClient } from "@elastic/elasticsearch";
+import { JSONObject, KRequestBody, KRequestParams } from "../../types/storage/Elasticsearch";
+import { TypeMapping } from "@elastic/elasticsearch/api/types";
+import { storeScopeEnum } from "../../core/storage/storeScopeEnum";
+import Service from "../service";
 import ESWrapper from "./esWrapper";
-import QueryTranslator from "../commons/queryTranslator";
-import { storeScopeEnum } from "../../../core/storage/storeScopeEnum";
+import QueryTranslator from "./queryTranslator";
 /**
  * @param {Kuzzle} kuzzle kuzzle instance
  * @param {Object} config Service configuration
  * @param {storeScopeEnum} scope
  * @constructor
  */
-export declare class ES7 {
-    _client: Client;
+export default class ElasticSearch extends Service {
+    _client: StorageClient;
     _scope: storeScopeEnum;
     _indexPrefix: string;
     _esWrapper: ESWrapper;
@@ -24,6 +25,12 @@ export declare class ES7 {
     maxScrollDuration: number;
     scrollTTL: number;
     _config: any;
+    /**
+     * Returns a new elasticsearch client instance
+     *
+     * @returns {Object}
+     */
+    static buildClient(config: any): StorageClient;
     constructor(config: any, scope?: storeScopeEnum);
     get scope(): storeScopeEnum;
     /**
@@ -70,15 +77,7 @@ export declare class ES7 {
         scrollTTL?: string;
     }): Promise<{
         aggregations: any;
-        hits: {
-            _id: any;
-            _score: any;
-            _source: any;
-            collection: any;
-            highlight: any;
-            index: any;
-            inner_hits: {};
-        }[];
+        hits: any;
         remaining: any;
         scrollId: any;
         suggest: any;
@@ -105,15 +104,7 @@ export declare class ES7 {
         scroll?: string;
     }): Promise<{
         aggregations: any;
-        hits: {
-            _id: any;
-            _score: any;
-            _source: any;
-            collection: any;
-            highlight: any;
-            index: any;
-            inner_hits: {};
-        }[];
+        hits: any;
         remaining: any;
         scrollId: any;
         suggest: any;
@@ -128,15 +119,7 @@ export declare class ES7 {
     _mapTargetsToAlias(targets: any): {};
     _formatSearchResult(body: any, searchInfo?: any): Promise<{
         aggregations: any;
-        hits: {
-            _id: any;
-            _score: any;
-            _source: any;
-            collection: any;
-            highlight: any;
-            index: any;
-            inner_hits: {};
-        }[];
+        hits: any;
         remaining: any;
         scrollId: any;
         suggest: any;
@@ -204,7 +187,7 @@ export declare class ES7 {
         _version: any;
     }>;
     /**
-     * Creates a new document to Elasticsearch, or replace it if it already exist
+     * Creates a new document to ElasticSearch, or replace it if it already exist
      *
      * @param {String} index - Index name
      * @param {String} collection - Collection name
@@ -270,7 +253,7 @@ export declare class ES7 {
         created: boolean;
     }>;
     /**
-     * Replaces a document to Elasticsearch
+     * Replaces a document to ElasticSearch
      *
      * @param {String} index - Index name
      * @param {String} collection - Collection name
@@ -576,7 +559,7 @@ export declare class ES7 {
      *
      * @returns {Promise.<String[]>}
      */
-    deleteIndexes(indexes?: string[]): Promise<any[]>;
+    deleteIndexes(indexes?: string[]): Promise<any>;
     /**
      * Deletes an index
      *
@@ -847,7 +830,7 @@ export declare class ES7 {
      * @returns {String} Alias name (eg: '@&nepali.liia')
      * @throws If there is not exactly one alias associated that is prefixed with @
      */
-    _getAliasFromIndice(indice: string): Promise<string[]>;
+    _getAliasFromIndice(indice: any): Promise<string[]>;
     /**
      * Check for each indice whether it has an alias or not.
      * When the latter is missing, create one based on the indice name.
@@ -887,7 +870,7 @@ export declare class ES7 {
      *
      * @returns {Object.<String, String[]>} Indexes as key and an array of their collections as value
      */
-    _extractSchema(aliases: string[], { includeHidden }?: {
+    _extractSchema(aliases: any, { includeHidden }?: {
         includeHidden?: boolean;
     }): {};
     /**
@@ -970,5 +953,4 @@ export declare class ES7 {
     _checkDynamicProperty(mappings: any): void;
     _setLastActionToKuzzleMeta(esRequest: JSONObject, alias: string, kuzzleMeta: JSONObject): void;
     _setLastActionToKuzzleMetaUpdate(item: JSONObject, kuzzleMeta: JSONObject): void;
-    _getRandomNumber(number: number): number;
 }