@cloudbase/database 1.4.2 → 1.4.3-alpha.0

package/dist/esm/serializer/query.js

@@ -0,0 +1,251 @@
+import { isQueryCommand, isComparisonCommand, QUERY_COMMANDS_LITERAL } from '../commands/query';
+import { isLogicCommand, LOGIC_COMMANDS_LITERAL } from '../commands/logic';
+import { SYMBOL_UNSET_FIELD_NAME, SYMBOL_GEO_POINT } from '../helper/symbol';
+import { getType, isObject, isArray, isRegExp, isDate } from '../utils/type';
+import { operatorToString } from '../operator-map';
+import { flattenQueryObject, isConversionRequired, encodeInternalDataType } from './common';
+import { stringifyByEJSON } from '../utils/utils';
+import { Validate } from '../validate';
+export class QuerySerializer {
+    constructor() { }
+    static encode(query) {
+        const encoder = new QueryEncoder();
+        return encoder.encodeQuery(query);
+    }
+    static encodeEJSON(query, raw) {
+        const encoder = new QueryEncoder();
+        return stringifyByEJSON(raw ? query : encoder.encodeQuery(query));
+    }
+}
+class QueryEncoder {
+    encodeQuery(query, key) {
+        if (isConversionRequired(query)) {
+            if (isLogicCommand(query)) {
+                return this.encodeLogicCommand(query);
+            }
+            else if (isQueryCommand(query)) {
+                return this.encodeQueryCommand(query);
+            }
+            else if (isRegExp(query)) {
+                return { [key]: this.encodeRegExp(query) };
+            }
+            else if (isDate(query)) {
+                return { [key]: query };
+            }
+            else {
+                return { [key]: this.encodeQueryObject(query) };
+            }
+        }
+        else {
+            if (isObject(query)) {
+                return this.encodeQueryObject(query);
+            }
+            else {
+                return query;
+            }
+        }
+    }
+    encodeRegExp(query) {
+        return {
+            $regularExpression: {
+                pattern: query.source,
+                options: query.flags
+            }
+        };
+    }
+    encodeLogicCommand(query) {
+        switch (query.operator) {
+            case LOGIC_COMMANDS_LITERAL.NOR:
+            case LOGIC_COMMANDS_LITERAL.AND:
+            case LOGIC_COMMANDS_LITERAL.OR: {
+                const $op = operatorToString(query.operator);
+                const subqueries = query.operands.map((oprand) => this.encodeQuery(oprand, query.fieldName));
+                return {
+                    [$op]: subqueries
+                };
+            }
+            case LOGIC_COMMANDS_LITERAL.NOT: {
+                const $op = operatorToString(query.operator);
+                const operatorExpression = query.operands[0];
+                if (isRegExp(operatorExpression)) {
+                    return {
+                        [query.fieldName]: {
+                            [$op]: this.encodeRegExp(operatorExpression)
+                        }
+                    };
+                }
+                else {
+                    const subqueries = this.encodeQuery(operatorExpression)[query.fieldName];
+                    return {
+                        [query.fieldName]: {
+                            [$op]: subqueries
+                        }
+                    };
+                }
+            }
+            default: {
+                const $op = operatorToString(query.operator);
+                if (query.operands.length === 1) {
+                    const subquery = this.encodeQuery(query.operands[0]);
+                    return {
+                        [$op]: subquery
+                    };
+                }
+                else {
+                    const subqueries = query.operands.map(this.encodeQuery.bind(this));
+                    return {
+                        [$op]: subqueries
+                    };
+                }
+            }
+        }
+    }
+    encodeQueryCommand(query) {
+        if (isComparisonCommand(query)) {
+            return this.encodeComparisonCommand(query);
+        }
+        else {
+            return this.encodeComparisonCommand(query);
+        }
+    }
+    encodeComparisonCommand(query) {
+        if (query.fieldName === SYMBOL_UNSET_FIELD_NAME) {
+            throw new Error('Cannot encode a comparison command with unset field name');
+        }
+        const $op = operatorToString(query.operator);
+        switch (query.operator) {
+            case QUERY_COMMANDS_LITERAL.EQ:
+            case QUERY_COMMANDS_LITERAL.NEQ:
+            case QUERY_COMMANDS_LITERAL.LT:
+            case QUERY_COMMANDS_LITERAL.LTE:
+            case QUERY_COMMANDS_LITERAL.GT:
+            case QUERY_COMMANDS_LITERAL.GTE:
+            case QUERY_COMMANDS_LITERAL.ELEM_MATCH:
+            case QUERY_COMMANDS_LITERAL.EXISTS:
+            case QUERY_COMMANDS_LITERAL.SIZE:
+            case QUERY_COMMANDS_LITERAL.MOD: {
+                return {
+                    [query.fieldName]: {
+                        [$op]: encodeInternalDataType(query.operands[0])
+                    }
+                };
+            }
+            case QUERY_COMMANDS_LITERAL.IN:
+            case QUERY_COMMANDS_LITERAL.NIN:
+            case QUERY_COMMANDS_LITERAL.ALL: {
+                return {
+                    [query.fieldName]: {
+                        [$op]: encodeInternalDataType(query.operands)
+                    }
+                };
+            }
+            case QUERY_COMMANDS_LITERAL.GEO_NEAR: {
+                const options = query.operands[0];
+                return {
+                    [query.fieldName]: {
+                        $nearSphere: {
+                            $geometry: options.geometry.toJSON(),
+                            $maxDistance: options.maxDistance,
+                            $minDistance: options.minDistance
+                        }
+                    }
+                };
+            }
+            case QUERY_COMMANDS_LITERAL.GEO_WITHIN: {
+                const options = query.operands[0];
+                if (options.centerSphere) {
+                    Validate.isCentersPhere(options.centerSphere);
+                    const centerSphere = options.centerSphere;
+                    if (centerSphere[0]._internalType === SYMBOL_GEO_POINT) {
+                        return {
+                            [query.fieldName]: {
+                                $geoWithin: {
+                                    $centerSphere: [centerSphere[0].toJSON().coordinates, centerSphere[1]]
+                                }
+                            }
+                        };
+                    }
+                    return {
+                        [query.fieldName]: {
+                            $geoWithin: {
+                                $centerSphere: options.centerSphere
+                            }
+                        }
+                    };
+                }
+                return {
+                    [query.fieldName]: {
+                        $geoWithin: {
+                            $geometry: options.geometry.toJSON()
+                        }
+                    }
+                };
+            }
+            case QUERY_COMMANDS_LITERAL.GEO_INTERSECTS: {
+                const options = query.operands[0];
+                return {
+                    [query.fieldName]: {
+                        $geoIntersects: {
+                            $geometry: options.geometry.toJSON()
+                        }
+                    }
+                };
+            }
+            default: {
+                return {
+                    [query.fieldName]: {
+                        [$op]: encodeInternalDataType(query.operands[0])
+                    }
+                };
+            }
+        }
+    }
+    encodeQueryObject(query) {
+        const flattened = flattenQueryObject(query);
+        for (const key in flattened) {
+            const val = flattened[key];
+            if (isLogicCommand(val)) {
+                flattened[key] = val._setFieldName(key);
+                const condition = this.encodeLogicCommand(flattened[key]);
+                this.mergeConditionAfterEncode(flattened, condition, key);
+            }
+            else if (isComparisonCommand(val)) {
+                flattened[key] = val._setFieldName(key);
+                const condition = this.encodeComparisonCommand(flattened[key]);
+                this.mergeConditionAfterEncode(flattened, condition, key);
+            }
+            else if (isConversionRequired(val)) {
+                flattened[key] = encodeInternalDataType(val);
+            }
+        }
+        return flattened;
+    }
+    mergeConditionAfterEncode(query, condition, key) {
+        if (!condition[key]) {
+            delete query[key];
+        }
+        for (const conditionKey in condition) {
+            if (query[conditionKey]) {
+                if (isArray(query[conditionKey])) {
+                    query[conditionKey] = query[conditionKey].concat(condition[conditionKey]);
+                }
+                else if (isObject(query[conditionKey])) {
+                    if (isObject(condition[conditionKey])) {
+                        Object.assign(query, condition);
+                    }
+                    else {
+                        console.warn(`unmergable condition, query is object but condition is ${getType(condition)}, can only overwrite`, condition, key);
+                        query[conditionKey] = condition[conditionKey];
+                    }
+                }
+                else {
+                    console.warn(`to-merge query is of type ${getType(query)}, can only overwrite`, query, condition, key);
+                    query[conditionKey] = condition[conditionKey];
+                }
+            }
+            else {
+                query[conditionKey] = condition[conditionKey];
+            }
+        }
+    }
+}

package/dist/esm/serializer/update.d.ts

@@ -0,0 +1,16 @@
+import { UpdateCommand } from '../commands/update';
+import { LogicCommand } from '../commands/logic';
+export declare type IQueryCondition = Record<string, any> | LogicCommand;
+export interface IUpdateCondition {
+    [key: string]: any;
+}
+export declare class UpdateSerializer {
+    private constructor();
+    static encode(query: IQueryCondition | UpdateCommand): IUpdateCondition;
+    static encodeEJSON(query: IQueryCondition | UpdateCommand, raw: boolean): string;
+    encodeUpdate(query: IQueryCondition | UpdateCommand): IUpdateCondition;
+    encodeUpdateCommand(query: UpdateCommand): IQueryCondition;
+    encodeFieldUpdateCommand(query: UpdateCommand): IQueryCondition;
+    encodeArrayUpdateCommand(query: UpdateCommand): IQueryCondition;
+    encodeUpdateObject(query: Record<string, any>): IQueryCondition;
+}

package/dist/esm/serializer/update.js

@@ -0,0 +1,139 @@
+import { UpdateCommand, isUpdateCommand, UPDATE_COMMANDS_LITERAL } from '../commands/update';
+import { SYMBOL_UNSET_FIELD_NAME } from '../helper/symbol';
+import { getType, isArray } from '../utils/type';
+import { operatorToString } from '../operator-map';
+import { flattenQueryObject, encodeInternalDataType, mergeConditionAfterEncode } from './common';
+import { stringifyByEJSON } from '../utils/utils';
+export class UpdateSerializer {
+    constructor() { }
+    static encode(query) {
+        const stringifier = new UpdateSerializer();
+        return stringifier.encodeUpdate(query);
+    }
+    static encodeEJSON(query, raw) {
+        const stringifier = new UpdateSerializer();
+        return stringifyByEJSON(raw ? query : stringifier.encodeUpdate(query));
+    }
+    encodeUpdate(query) {
+        if (isUpdateCommand(query)) {
+            return this.encodeUpdateCommand(query);
+        }
+        else if (getType(query) === 'object') {
+            return this.encodeUpdateObject(query);
+        }
+        else {
+            return query;
+        }
+    }
+    encodeUpdateCommand(query) {
+        if (query.fieldName === SYMBOL_UNSET_FIELD_NAME) {
+            throw new Error('Cannot encode a comparison command with unset field name');
+        }
+        switch (query.operator) {
+            case UPDATE_COMMANDS_LITERAL.PUSH:
+            case UPDATE_COMMANDS_LITERAL.PULL:
+            case UPDATE_COMMANDS_LITERAL.PULL_ALL:
+            case UPDATE_COMMANDS_LITERAL.POP:
+            case UPDATE_COMMANDS_LITERAL.SHIFT:
+            case UPDATE_COMMANDS_LITERAL.UNSHIFT:
+            case UPDATE_COMMANDS_LITERAL.ADD_TO_SET: {
+                return this.encodeArrayUpdateCommand(query);
+            }
+            default: {
+                return this.encodeFieldUpdateCommand(query);
+            }
+        }
+    }
+    encodeFieldUpdateCommand(query) {
+        const $op = operatorToString(query.operator);
+        switch (query.operator) {
+            case UPDATE_COMMANDS_LITERAL.REMOVE: {
+                return {
+                    [$op]: {
+                        [query.fieldName]: ''
+                    }
+                };
+            }
+            default: {
+                return {
+                    [$op]: {
+                        [query.fieldName]: query.operands[0]
+                    }
+                };
+            }
+        }
+    }
+    encodeArrayUpdateCommand(query) {
+        const $op = operatorToString(query.operator);
+        switch (query.operator) {
+            case UPDATE_COMMANDS_LITERAL.PUSH: {
+                let modifiers;
+                if (isArray(query.operands)) {
+                    modifiers = {
+                        $each: query.operands.map(encodeInternalDataType)
+                    };
+                }
+                else {
+                    modifiers = query.operands;
+                }
+                return {
+                    [$op]: {
+                        [query.fieldName]: modifiers
+                    }
+                };
+            }
+            case UPDATE_COMMANDS_LITERAL.UNSHIFT: {
+                const modifiers = {
+                    $each: query.operands.map(encodeInternalDataType),
+                    $position: 0
+                };
+                return {
+                    [$op]: {
+                        [query.fieldName]: modifiers
+                    }
+                };
+            }
+            case UPDATE_COMMANDS_LITERAL.POP: {
+                return {
+                    [$op]: {
+                        [query.fieldName]: 1
+                    }
+                };
+            }
+            case UPDATE_COMMANDS_LITERAL.SHIFT: {
+                return {
+                    [$op]: {
+                        [query.fieldName]: -1
+                    }
+                };
+            }
+            default: {
+                return {
+                    [$op]: {
+                        [query.fieldName]: encodeInternalDataType(query.operands)
+                    }
+                };
+            }
+        }
+    }
+    encodeUpdateObject(query) {
+        const flattened = flattenQueryObject(query);
+        for (const key in flattened) {
+            if (/^\$/.test(key))
+                continue;
+            let val = flattened[key];
+            if (isUpdateCommand(val)) {
+                flattened[key] = val._setFieldName(key);
+                const condition = this.encodeUpdateCommand(flattened[key]);
+                mergeConditionAfterEncode(flattened, condition, key);
+            }
+            else {
+                flattened[key] = val = encodeInternalDataType(val);
+                const $setCommand = new UpdateCommand(UPDATE_COMMANDS_LITERAL.SET, [val], key);
+                const condition = this.encodeUpdateCommand($setCommand);
+                mergeConditionAfterEncode(flattened, condition, key);
+            }
+        }
+        return flattened;
+    }
+}

package/dist/esm/serverDate/index.d.ts

@@ -0,0 +1,13 @@
+export declare class ServerDate {
+    readonly offset: number;
+    constructor({ offset }?: {
+        offset?: number;
+    });
+    readonly _internalType: import("../utils/symbol").InternalSymbol;
+    parse(): {
+        $tcb_server_date: {
+            offset: number;
+        };
+    };
+}
+export declare function ServerDateConstructor(opt: any): ServerDate;

package/dist/esm/serverDate/index.js

@@ -0,0 +1,19 @@
+import { SYMBOL_SERVER_DATE } from '../helper/symbol';
+export class ServerDate {
+    constructor({ offset = 0 } = {}) {
+        this.offset = offset;
+    }
+    get _internalType() {
+        return SYMBOL_SERVER_DATE;
+    }
+    parse() {
+        return {
+            $tcb_server_date: {
+                offset: this.offset
+            }
+        };
+    }
+}
+export function ServerDateConstructor(opt) {
+    return new ServerDate(opt);
+}

package/dist/esm/transaction/collection.d.ts

@@ -0,0 +1,7 @@
+import { DocumentReference } from './document';
+import { Query } from './query';
+export declare class CollectionReference extends Query {
+    readonly name: string;
+    doc(docID?: string | number): DocumentReference;
+    add(data: any): Promise<any>;
+}

package/dist/esm/transaction/collection.js

@@ -0,0 +1,44 @@
+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 (b.hasOwnProperty(p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+import { DocumentReference } from './document';
+import { Query } from './query';
+var CollectionReference = (function (_super) {
+    __extends(CollectionReference, _super);
+    function CollectionReference(transaction, coll) {
+        return _super.call(this, transaction, coll) || this;
+    }
+    Object.defineProperty(CollectionReference.prototype, "name", {
+        get: function () {
+            return this._coll;
+        },
+        enumerable: true,
+        configurable: true
+    });
+    CollectionReference.prototype.doc = function (docID) {
+        if (typeof docID !== 'string' && typeof docID !== 'number') {
+            throw new Error('docId必须为字符串或数字');
+        }
+        return new DocumentReference(this._transaction, this._coll, docID);
+    };
+    CollectionReference.prototype.add = function (data) {
+        var docID;
+        if (data._id !== undefined) {
+            docID = data._id;
+        }
+        var docRef = new DocumentReference(this._transaction, this._coll, docID);
+        return docRef.create(data);
+    };
+    return CollectionReference;
+}(Query));
+export { CollectionReference };

package/dist/esm/transaction/document.d.ts

@@ -0,0 +1,27 @@
+interface GetResult {
+    requestId: string;
+    data: any;
+}
+interface UpdateResult {
+    requestId: string;
+    updated: number;
+}
+declare type JsonString = string;
+interface SetResult extends UpdateResult {
+    upserted: JsonString;
+}
+interface DeleteResult {
+    requestId: string;
+    deleted: number | string;
+}
+export declare class DocumentReference {
+    readonly id: string | number;
+    private _transaction;
+    private _transactionId;
+    create(data: any): Promise<any>;
+    get(): Promise<GetResult>;
+    set(data: Object): Promise<SetResult>;
+    update(data: Object): Promise<UpdateResult>;
+    delete(): Promise<DeleteResult>;
+}
+export {};