backendless 6.4.0 → 6.5.1

package/backendless.d.ts

@@ -3,6 +3,8 @@
  * @namespace Backendless
  */
 declare module Backendless {
+    type JSONValue = string | number | boolean | { [x: string]: JSONValue } | Array<JSONValue>
+
     let debugMode: boolean;
     let useTableClassesFromGlobalScope: boolean;
     let serverURL: string;
@@ -277,6 +279,340 @@ declare module Backendless {
         function mapTableToClass(clientClass: Function): void;
     }
 
+    /**
+     * @public
+     * @type: Function
+     **/
+    function Hive(hiveName: string): Backendless.Hive.DataHive;
+
+    /**
+     * @public
+     * @namespace Backendless.Hive
+     */
+    namespace Hive {
+        /**
+         * @public
+         * @type: Function
+         */
+        function getNames(): Array<string>
+
+        /**
+         * @public
+         * @class Backendless.Hive.DataHive
+         * @constructor
+         */
+        class DataHive {
+            constructor(hiveName: string, appContext: object);
+
+            create(): Promise<void>
+
+            delete(): Promise<void>
+
+            rename(newName: string): Promise<void>
+
+            KeyValueStore: KeyValueStore;
+            ListStore: ListStore;
+            MapStore: MapStore;
+            SetStore: SetStore;
+            SortedSetStore: SortedSetStore;
+        }
+
+        interface StoreKeysOptionsI {
+            filterPattern?: string;
+            cursor?: number;
+            pageSize?: number;
+        }
+
+        interface StoreKeysResultI {
+            keys: string[];
+            cursorId: string;
+        }
+
+        /**
+         * @private
+         */
+        interface HiveStore {
+            keys(options?: StoreKeysOptionsI): Promise<StoreKeysResultI>;
+
+            delete(keys: Array<string>): Promise<void>;
+
+            exists(keys: Array<string>): Promise<number>;
+
+            touch(keys: Array<string>): Promise<void>;
+        }
+
+        /**
+         * @private
+         */
+        interface hiveStore {
+
+            delete(): Promise<number>;
+
+            rename(newKeyName: string, overwrite?: boolean): Promise<void>;
+
+            exists(): Promise<boolean>;
+
+            getExpiration(): Promise<number>;
+
+            clearExpiration(): Promise<void>;
+
+            touch(): Promise<void>;
+
+            secondsSinceLastOperation(): Promise<number>;
+
+            expireAfter(ttl: number): Promise<void>;
+
+            expireAt(timestamp: number): Promise<void>;
+        }
+
+        interface KeyValueSetKeyOptionsI {
+            ttl?: Number; // in seconds
+            expireAt?: Number; // timestamp
+            condition?: 'IfExists' | 'IfNotExists' | 'Always'; //if not provided set anyway
+        }
+
+        /**
+         * @public
+         */
+        interface KeyValueStore extends HiveStore {
+            (keyName: string): keyValueStore
+
+            get(keys: Array<string>): Promise<object>;
+
+            set(key: string, value: JSONValue, options?: KeyValueSetKeyOptionsI): Promise<boolean>;
+
+            set(keysMap: object): Promise<boolean>;
+        }
+
+        /**
+         * @public
+         */
+        interface keyValueStore extends hiveStore {
+            get(): Promise<JSONValue | null>;
+
+            set(value: JSONValue, options?: KeyValueSetKeyOptionsI): Promise<boolean>;
+
+            increment(value: number): Promise<number>;
+
+            decrement(value: number): Promise<number>;
+        }
+
+        /**
+         * @public
+         */
+        interface ListStore extends HiveStore {
+            (keyName: string): listStore
+        }
+
+        /**
+         * @public
+         */
+        interface listStore extends hiveStore {
+            get(): Promise<Array<JSONValue>>
+
+            get(index: number): Promise<JSONValue | null>
+
+            get(indexFrom: number, indexTo: number): Promise<Array<JSONValue>>
+
+            set(values: Array<string>): Promise<number>;
+
+            set(value: string, index: number): Promise<void>;
+
+            insertBefore(valueToInsert: JSONValue, anchorValue: JSONValue): Promise<number>;
+
+            insertAfter(valueToInsert: JSONValue, anchorValue: JSONValue): Promise<number>;
+
+            length(): Promise<number>;
+
+            addFirstValue(value: JSONValue): Promise<number>
+
+            addFirstValues(values: Array<JSONValue>): Promise<number>
+
+            addLastValue(value: JSONValue): Promise<number>
+
+            addLastValues(values: Array<JSONValue>): Promise<number>
+
+            deleteFirst(): Promise<Array<JSONValue>>
+
+            deleteFirst(count: number): Promise<Array<JSONValue>>
+
+            deleteLast(): Promise<Array<JSONValue>>
+
+            deleteLast(count: number): Promise<Array<JSONValue>>
+
+            deleteValue(value: JSONValue, count?: number): Promise<number>
+        }
+
+        /**
+         * @public
+         */
+        interface MapStore extends HiveStore {
+            (keyName: string): mapStore
+        }
+
+        /**
+         * @public
+         */
+        interface mapStore extends hiveStore {
+
+            get(): Promise<object>;
+
+            get(key: string): Promise<object>;
+
+            get(keys: Array<string>): Promise<object>;
+
+            getValue(key: string): Promise<JSONValue | null>;
+
+            keyExists(key: string): Promise<boolean>;
+
+            length(): Promise<number>;
+
+            keys(): Promise<Array<string>>;
+
+            values(): Promise<Array<JSONValue>>;
+
+            set(data: object): Promise<number>;
+
+            set(key: string, value: JSONValue): Promise<boolean>;
+
+            setWithOverwrite(key: string, value: JSONValue, overwrite?: boolean): Promise<boolean>;
+
+            add(data: object): Promise<number>;
+
+            increment(key: string, count?: number): Promise<number>;
+
+            decrement(key: string, count?: number): Promise<number>;
+
+            deleteKeys(key: string): Promise<number>;
+
+            deleteKeys(keys: Array<string>): Promise<number>;
+        }
+
+        /**
+         * @public
+         */
+        interface SetStore extends HiveStore {
+            (keyName: string): setStore;
+
+            difference(storeKeys: Array<string>): Promise<Array<JSONValue>>;
+
+            intersection(storeKeys: Array<string>): Promise<Array<JSONValue>>;
+
+            union(storeKeys: Array<string>): Promise<Array<JSONValue>>;
+        }
+
+        /**
+         * @public
+         */
+        interface setStore extends hiveStore {
+
+            get(): Promise<Array<JSONValue>>;
+
+            getRandom(count?: number): Promise<Array<JSONValue>>;
+
+            getRandomAndDelete(count?: number): Promise<Array<JSONValue>>;
+
+            setValue(value: JSONValue): Promise<number>;
+
+            setValues(values: Array<JSONValue>): Promise<number>;
+
+            addValue(value: JSONValue): Promise<number>;
+
+            addValues(values: Array<JSONValue>): Promise<number>;
+
+            deleteValue(value: JSONValue): Promise<number>;
+
+            deleteValues(values: Array<JSONValue>): Promise<number>;
+
+            isValueMember(value: JSONValue): Promise<Array<boolean>>;
+
+            isValuesMembers(values: Array<JSONValue>): Promise<Array<boolean>>;
+
+            length(): Promise<number>;
+        }
+
+        type SortedSetItem = [number, JSONValue]
+        type SortedSetBound = 'Include' | 'Exclude' | 'Infinity'
+
+        interface SortedSetItemOptionsI {
+            duplicateBehaviour?: 'OnlyUpdate' | 'AlwaysAdd';
+            scoreUpdateMode?: 'Greater' | 'Less';
+            resultType?: 'NewAdded' | 'TotalChanged';
+        }
+
+        interface SortedSetFilterI {
+            minScore?: number,
+            maxScore?: number,
+            minBound?: SortedSetBound,
+            maxBound?: SortedSetBound,
+        }
+
+        /**
+         * @public
+         */
+        interface SortedSetStore extends HiveStore {
+            (keyName: string): sortedSetStore
+
+            difference(storeKeys: Array<string>): Promise<Array<JSONValue>>;
+
+            intersection(storeKeys: Array<string>): Promise<Array<JSONValue>>;
+
+            union(storeKeys: Array<string>): Promise<Array<JSONValue>>;
+        }
+
+        /**
+         * @public
+         */
+        interface sortedSetStore extends hiveStore {
+
+            add(items: Array<SortedSetItem>, options?: SortedSetItemOptionsI): Promise<number>
+
+            set(items: Array<SortedSetItem>, options?: SortedSetItemOptionsI): Promise<number>
+
+            incrementScore(value: JSONValue, scoreValue: number): Promise<number>
+
+            decrementScore(value: JSONValue, scoreValue: number): Promise<number>
+
+            getAndDeleteMaxScore(count?: number): Promise<Array<SortedSetItem>>
+
+            getAndDeleteMinScore(count?: number): Promise<Array<SortedSetItem>>
+
+            getRandom<T = SortedSetItem | JSONValue>(options?: { count?: number, withScores?: boolean }): Promise<Array<T>>
+
+            getScore(value: JSONValue): Promise<number | null>
+
+            getRank(value: JSONValue, reverse?: boolean): Promise<number | null>
+
+            getRangeByRank<T = SortedSetItem | JSONValue>(startRank: number, stopRank: number, options?: {
+                reverse?: boolean,
+                withScores?: boolean
+            }): Promise<Array<T>>
+
+            getRangeByScore<T = SortedSetItem | JSONValue>(options?: {
+                minScore?: number,
+                maxScore?: number,
+                minBound?: SortedSetBound,
+                maxBound?: SortedSetBound,
+                offset?: number,
+                count?: number
+                reverse?: boolean,
+                withScores?: boolean
+            }): Promise<Array<T>>
+
+            deleteValue(value: JSONValue): Promise<number>;
+
+            deleteValues(values: Array<JSONValue>): Promise<number>;
+
+            deleteValuesByRank(startRank: number, stopRank: number): Promise<number>;
+
+            deleteValuesByScore(options?: SortedSetFilterI): Promise<number>;
+
+            length(): Promise<number>;
+
+            countBetweenScores(options?: SortedSetFilterI): Promise<number>;
+        }
+    }
+
     /**
      * @public
      * @namespace Backendless.UserService