@pc-nexus/storage 0.0.1-next.1 → 0.0.1-next.2

package/README.md

@@ -0,0 +1,3 @@
+# Nexus Storage API
+
+API methods exposed during runtime in Nexus apps.

package/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./lib/ces/type.js";
+export * from "./lib/ces/condition-builder/index.js";
+export * from "./lib/ces/index.js";
+export * from "./lib/kvs/index.js";
+export * from "./lib/os/index.js";
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,sCAAsC,CAAC;AACrD,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC"}

package/index.js

@@ -1,4 +1,5 @@
 export * from "./lib/ces/type.js";
+export * from "./lib/ces/condition-builder/index.js";
 export * from "./lib/ces/index.js";
 export * from "./lib/kvs/index.js";
 export * from "./lib/os/index.js";

package/lib/ces/condition-builder/condition-builder.d.ts

@@ -0,0 +1,45 @@
+import type { CurrentLevelType, EqOptions, InOptions, KeyChains, LogicalLevelType, Query, Condition, ConditionBuilderOptions, QueryOperatorCondition$in, RangeOptions, RootLevelType, TypeAtKeyChain, ValueAlternativeType } from "./type.js";
+import { QueryOperator } from "./type.js";
+export declare class ConditionBuilder<Schema = any, FieldChain extends KeyChains<Schema> = never, CurrentLevel extends CurrentLevelType<Schema> = RootLevelType<Schema>, FieldChains extends KeyChains<Schema> = KeyChains<Schema>, V = TypeAtKeyChain<Schema, FieldChain>> {
+    private _field;
+    private baseOptions;
+    private get currentField();
+    private set currentField(value);
+    private root;
+    private currentLevel;
+    static create<Schema>(options?: ConditionBuilderOptions): ConditionBuilder<Schema>;
+    constructor(options?: ConditionBuilderOptions);
+    done(reset?: boolean): Condition;
+    reset(this: ConditionBuilder<Schema, never, CurrentLevelType<Schema>>): ConditionBuilder<Schema>;
+    private getRawQuery;
+    merge(queryOrBuilder: Query<Schema> | ConditionBuilder<Schema, any, CurrentLevelType<Schema>>, override?: CurrentLevel extends RootLevelType<Schema> ? boolean : never): this;
+    clone(): this;
+    private isAtRootLevel;
+    private assertAtRootLevel;
+    private assertAtLogicalLevel;
+    private logicalClosure;
+    private logicalOpen;
+    private logicalClose;
+    and(closure: (andBuilder: ConditionBuilder<Schema, never, LogicalLevelType<Schema>>) => void): ConditionBuilder<Schema, FieldChain, CurrentLevel, FieldChains, V>;
+    or(closure: (orBuilder: ConditionBuilder<Schema, never, LogicalLevelType<Schema>>) => void): ConditionBuilder<Schema, FieldChain, CurrentLevel, FieldChains, V>;
+    private shouldReserveValue;
+    private updateQuery;
+    field<FieldChain extends FieldChains>(field: FieldChain): ConditionBuilder<Schema, FieldChain, CurrentLevel>;
+    resetFieldConditions(): this;
+    eq<OP extends QueryOperator.eq | QueryOperator.ne | QueryOperator.gt | QueryOperator.gte | QueryOperator.lte | QueryOperator.lt = QueryOperator.eq>(value: ValueAlternativeType<V>, { queryOperator, ...options }?: EqOptions<OP>): this;
+    ne(value: ValueAlternativeType<V>, options?: Omit<EqOptions, "queryOperator">): this;
+    range(values: Partial<Record<"gte" | "lte" | "gt" | "lt", ValueAlternativeType<V>>>, { ...options }?: RangeOptions): this;
+    gte(value: ValueAlternativeType<V>, { ...options }?: RangeOptions): this;
+    gt(value: ValueAlternativeType<V>, { ...options }?: RangeOptions): this;
+    lte(value: ValueAlternativeType<V>, { ...options }?: RangeOptions): this;
+    lt(value: ValueAlternativeType<V>, { ...options }?: RangeOptions): this;
+    in(value: QueryOperatorCondition$in<V>, { queryOperator, ...options }?: InOptions): this;
+    nin(value: QueryOperatorCondition$in<V>, options?: Omit<InOptions, "queryOperator">): this;
+    exists(exists?: boolean): this;
+    private toAST;
+    private mapLogicalKey;
+    private convertTopLevelObject;
+    private convertFieldEntry;
+}
+export type ConditionBuilderApi<Schema = any> = Omit<ConditionBuilder<Schema>, "done">;
+//# sourceMappingURL=condition-builder.d.ts.map

package/lib/ces/condition-builder/condition-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"condition-builder.d.ts","sourceRoot":"","sources":["../../../../src/lib/ces/condition-builder/condition-builder.ts"],"names":[],"mappings":"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"}

package/lib/ces/condition-builder/condition-builder.js

@@ -0,0 +1,333 @@
+import { LogicalOperator, logicalOpSymbol, parentLevelSymbol, QueryOperator } from "./type.js";
+import _ from "lodash";
+export class ConditionBuilder {
+    _field;
+    baseOptions = { ignoreUndefined: false, keepNaN: false };
+    get currentField() {
+        if (!this._field) {
+            throw new Error("field not set. please set by field()");
+        }
+        return this._field;
+    }
+    set currentField(field) {
+        this._field = field;
+    }
+    root;
+    currentLevel;
+    static create(options) {
+        return new ConditionBuilder(options);
+    }
+    constructor(options = {}) {
+        Object.assign(this.baseOptions, options);
+        this.reset();
+    }
+    done(reset = true) {
+        this.assertAtRootLevel();
+        const ast = this.toAST(this.root);
+        if (reset) {
+            this.reset();
+        }
+        return ast;
+    }
+    reset() {
+        const root = {};
+        this.currentLevel = this.root = root;
+        this.currentField = undefined;
+        return this;
+    }
+    getRawQuery(clone = true) {
+        return clone ? _.cloneDeep(this.root) : this.root;
+    }
+    merge(queryOrBuilder, override) {
+        const query = queryOrBuilder instanceof ConditionBuilder ? queryOrBuilder.getRawQuery(true) : _.cloneDeep(queryOrBuilder);
+        if (this.isAtRootLevel()) {
+            const { root } = this;
+            const mergeArgs = override ? [root, query] : [query, root];
+            this.currentLevel = this.root = _.mergeWith(...mergeArgs, (targetValue, srcValue, key) => {
+                if (key in LogicalOperator) {
+                    return (targetValue || []).concat(srcValue || []);
+                }
+                else if (key in QueryOperator) {
+                    return srcValue;
+                }
+            });
+        }
+        else {
+            this.assertAtLogicalLevel();
+            this.currentLevel.push(query);
+        }
+        return this;
+    }
+    clone() {
+        return _.cloneDeep(this);
+    }
+    isAtRootLevel() {
+        const isRootLevel = _.isNil(this.currentLevel[logicalOpSymbol]);
+        return isRootLevel;
+    }
+    assertAtRootLevel() {
+        if (!this.isAtRootLevel()) {
+            const logicalOp = this.currentLevel[logicalOpSymbol];
+            throw new Error(`there is still remaining "${logicalOp}" logical operator opened`);
+        }
+    }
+    assertAtLogicalLevel(expect) {
+        const logicalOp = this.currentLevel[logicalOpSymbol];
+        const isRootLevel = _.isNil(logicalOp);
+        if (expect) {
+            if (logicalOp !== expect) {
+                throw new Error(`there is no "${expect}" logical operator opened`);
+            }
+        }
+        else if (isRootLevel) {
+            throw new Error(`there is no any logical operator opened`);
+        }
+    }
+    logicalClosure(logicalOp, closure) {
+        const logicalQB = new ConditionBuilder(this.baseOptions).logicalOpen(logicalOp);
+        closure(logicalQB);
+        logicalQB.logicalClose(logicalOp);
+        if (this.isAtRootLevel()) {
+            this.merge(logicalQB.getRawQuery(true), true);
+        }
+        else {
+            this.merge(logicalQB.getRawQuery(true));
+        }
+        return this;
+    }
+    logicalOpen(logicalOp) {
+        const parentLevel = this.currentLevel;
+        const currentLevel = [];
+        currentLevel[logicalOpSymbol] = logicalOp;
+        currentLevel[parentLevelSymbol] = parentLevel;
+        const that = this;
+        that.currentLevel = currentLevel;
+        return that;
+    }
+    logicalClose(logicalOp) {
+        this.assertAtLogicalLevel(logicalOp);
+        const currentLevel = this.currentLevel;
+        const that = this;
+        that.currentLevel = currentLevel[parentLevelSymbol];
+        const currentLogicalOp = currentLevel[logicalOpSymbol];
+        const logicalCondition = [...currentLevel];
+        if (!_.isEmpty(logicalCondition)) {
+            that.updateQuery(currentLogicalOp, logicalCondition);
+        }
+        return that;
+    }
+    and(closure) {
+        return this.logicalClosure(LogicalOperator.and, closure);
+    }
+    or(closure) {
+        return this.logicalClosure(LogicalOperator.or, closure);
+    }
+    shouldReserveValue(value, options) {
+        options = { ...this.baseOptions, ...options };
+        if (options.ignoreUndefined && value === undefined) {
+            return false;
+        }
+        if (!options.keepNaN && Number.isNaN(value)) {
+            return false;
+        }
+        return true;
+    }
+    updateQuery(field, condition) {
+        if (this.isAtRootLevel()) {
+            if (field in LogicalOperator && _.isArray(condition)) {
+                const currentLevel = this.currentLevel;
+                const logicalOp = field;
+                const c = condition;
+                currentLevel[logicalOp] = [...(currentLevel[logicalOp] || []), ...c];
+            }
+            else {
+                const currentLevel = this.currentLevel;
+                const f = field;
+                const c = condition;
+                if (_.isPlainObject(currentLevel[f])) {
+                    Object.assign(currentLevel[f], c);
+                }
+                else {
+                    currentLevel[f] = c;
+                }
+            }
+        }
+        else {
+            const currentLevel = this.currentLevel;
+            const entry = { [field]: condition };
+            currentLevel.push(entry);
+        }
+    }
+    field(field) {
+        this.currentField = field;
+        return this;
+    }
+    resetFieldConditions() {
+        if (this.isAtRootLevel()) {
+            delete this.currentLevel[this.currentField];
+        }
+        else {
+            const currentLevel = this.currentLevel;
+            let i = currentLevel.length;
+            while (--i >= 0) {
+                const ele = currentLevel[i];
+                if (ele && this.currentField in ele) {
+                    currentLevel.splice(i, 1);
+                }
+            }
+        }
+        return this;
+    }
+    eq(value, { queryOperator = QueryOperator.eq, ...options } = {}) {
+        const field = this.currentField;
+        if (!this.shouldReserveValue(value, options)) {
+            return this;
+        }
+        this.updateQuery(field, { [queryOperator]: value });
+        return this;
+    }
+    ne(value, options = {}) {
+        return this.eq(value, { ...options, queryOperator: QueryOperator.ne });
+    }
+    range(values, { ...options } = {}) {
+        const condition = {};
+        const setCondition = (key, value) => {
+            if (value !== undefined && this.shouldReserveValue(value, options)) {
+                condition[key] = value;
+            }
+        };
+        setCondition("gte", values.gte);
+        setCondition("gt", values.gt);
+        setCondition("lte", values.lte);
+        setCondition("lt", values.lt);
+        if (!_.isEmpty(condition)) {
+            this.updateQuery(this.currentField, condition);
+        }
+        return this;
+    }
+    gte(value, { ...options } = {}) {
+        this.eq(value, { queryOperator: QueryOperator.gte, ...options });
+        return this;
+    }
+    gt(value, { ...options } = {}) {
+        this.eq(value, { queryOperator: QueryOperator.gt, ...options });
+        return this;
+    }
+    lte(value, { ...options } = {}) {
+        this.eq(value, { queryOperator: QueryOperator.lte, ...options });
+        return this;
+    }
+    lt(value, { ...options } = {}) {
+        this.eq(value, { queryOperator: QueryOperator.lt, ...options });
+        return this;
+    }
+    in(value, { queryOperator = QueryOperator.in, ...options } = {}) {
+        const field = this.currentField;
+        if (value === undefined) {
+            if (this.shouldReserveValue(value, options)) {
+                throw new Error(`${queryOperator} needs an array`);
+            }
+            else {
+                return this;
+            }
+        }
+        else if (!_.isArray(value)) {
+            throw new Error(`${queryOperator} needs an array`);
+        }
+        if (options.ignoreEmpty && _.isEmpty(value)) {
+            return this;
+        }
+        this.updateQuery(field, {
+            [queryOperator]: value.filter((ele) => this.shouldReserveValue(ele, options)),
+        });
+        return this;
+    }
+    nin(value, options = {}) {
+        return this.in(value, { ...options, queryOperator: QueryOperator.nin });
+    }
+    exists(exists = true) {
+        const field = this.currentField;
+        this.updateQuery(field, { [QueryOperator.exists]: !!exists });
+        return this;
+    }
+    toAST(query) {
+        const nodes = [];
+        const entries = Object.entries(query);
+        for (const [key, value] of entries) {
+            if (key in LogicalOperator) {
+                const group = {
+                    kind: "group",
+                    op: this.mapLogicalKey(key),
+                    nodes: [],
+                };
+                const arr = value;
+                for (const ele of arr) {
+                    const subNodes = this.convertTopLevelObject(ele);
+                    group.nodes.push(...subNodes);
+                }
+                if (group.nodes.length > 0) {
+                    nodes.push(group);
+                }
+            }
+            else {
+                const fieldNodes = this.convertFieldEntry(key, value);
+                if (fieldNodes.length > 0)
+                    nodes.push(...fieldNodes);
+            }
+        }
+        if (nodes.length === 1) {
+            return nodes[0];
+        }
+        return { kind: "group", op: LogicalOperator.and, nodes };
+    }
+    mapLogicalKey(key) {
+        return key;
+    }
+    convertTopLevelObject(obj) {
+        const out = [];
+        for (const [k, v] of Object.entries(obj)) {
+            if (k in LogicalOperator) {
+                const group = {
+                    kind: "group",
+                    op: this.mapLogicalKey(k),
+                    nodes: [],
+                };
+                for (const ele of v) {
+                    group.nodes.push(...this.convertTopLevelObject(ele));
+                }
+                out.push(group);
+            }
+            else {
+                const fieldNodes = this.convertFieldEntry(k, v);
+                out.push(...fieldNodes);
+            }
+        }
+        return out;
+    }
+    convertFieldEntry(field, condition) {
+        const out = [];
+        if (_.isPlainObject(condition) && !_.isRegExp(condition)) {
+            const supported = {
+                [QueryOperator.eq]: true,
+                [QueryOperator.ne]: true,
+                [QueryOperator.gt]: true,
+                [QueryOperator.gte]: true,
+                [QueryOperator.lt]: true,
+                [QueryOperator.lte]: true,
+                [QueryOperator.in]: true,
+                [QueryOperator.nin]: true,
+                [QueryOperator.exists]: true,
+            };
+            for (const [k, val] of Object.entries(condition)) {
+                const op = k;
+                if (!supported[op])
+                    continue;
+                out.push({ kind: "field", field, op, value: op === QueryOperator.exists ? !!val : val });
+            }
+        }
+        else {
+            out.push({ kind: "field", field, op: QueryOperator.eq, value: condition });
+        }
+        return out;
+    }
+}

package/lib/ces/condition-builder/index.d.ts

@@ -0,0 +1,3 @@
+export { ConditionBuilder, type ConditionBuilderApi } from "./condition-builder.js";
+export * from "./type.js";
+//# sourceMappingURL=index.d.ts.map

package/lib/ces/condition-builder/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/ces/condition-builder/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,KAAK,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACpF,cAAc,WAAW,CAAC"}

package/lib/ces/condition-builder/index.js

@@ -0,0 +1,2 @@
+export { ConditionBuilder } from "./condition-builder.js";
+export * from "./type.js";

package/lib/ces/condition-builder/type.d.ts

@@ -0,0 +1,81 @@
+export type NestedPathsIterator<Type, WalkedType> = Required<NonNullable<Type>> extends Required<WalkedType> ? [] | (string | (WalkedType extends readonly unknown[] ? ArrayIndexes : never))[] : Type extends (...args: any[]) => any ? never : Type extends string | number | boolean | Date | RegExp | Buffer | Uint8Array | {
+    _bsontype: string;
+} ? [] : Type extends readonly (infer EleType)[] ? [ArrayIndexes<Type>, ...NestedPathsIterator<EleType, WalkedType | Type>] | [...NestedPathsIterator<EleType, WalkedType | Type>] : Type extends object ? {
+    [Key in Extract<keyof Type, string>]: [Key, ...NestedPathsIterator<Type[Key], WalkedType | Type>];
+}[Extract<keyof Type, string>] | [] : [];
+export type NestedPaths<Type> = NestedPathsIterator<Type, never>;
+export type KeyChains<T> = Exclude<NestedPaths<T>, []> extends infer Paths ? Paths extends readonly (string | number)[] ? Paths extends readonly [infer First, ...infer Rest] ? First extends string | number ? Rest extends readonly (string | number)[] ? `${First}${Rest extends readonly [] ? "" : "."}${KeyChainsJoin<Rest>}` : never : never : "" : never : never;
+type KeyChainsJoin<Paths extends readonly (string | number)[]> = Paths extends readonly [infer First, ...infer Rest] ? First extends string | number ? Rest extends readonly (string | number)[] ? `${First}${Rest extends readonly [] ? "" : "."}${KeyChainsJoin<Rest>}` : never : never : "";
+export type IntegerListAsc<Len extends number = 10, Result extends readonly number[] = []> = Result["length"] extends Len ? Result : IntegerListAsc<Len, [...Result, Result["length"]]>;
+export type Integer = IntegerListAsc[number];
+export type ArrayIndexes<Array extends readonly any[] = readonly any[]> = number extends any[]["length"] ? Integer : any[] extends [infer Ele, ...infer RestArray] ? ArrayIndexes<RestArray> | RestArray["length"] : never;
+export type Document = Record<string, any>;
+export declare const parentLevelSymbol: unique symbol;
+export declare const logicalOpSymbol: unique symbol;
+export declare enum QueryOperator {
+    eq = "eq",
+    ne = "ne",
+    gt = "gt",
+    gte = "gte",
+    lt = "lt",
+    lte = "lte",
+    in = "in",
+    nin = "nin",
+    exists = "exists"
+}
+export type MaybeRegExp<T> = T extends string ? RegExp | T : T;
+export type ValueAlternativeType<V> = V extends (infer E)[] ? MaybeRegExp<E> | V : MaybeRegExp<V>;
+export type QueryOperatorCondition$in<V> = readonly ValueAlternativeType<V>[];
+export type QueryOperatorConditions<V> = Partial<Record<QueryOperator.eq | QueryOperator.ne | QueryOperator.gt | QueryOperator.gte | QueryOperator.lt | QueryOperator.lte, ValueAlternativeType<V>>> & Partial<Record<QueryOperator.in | QueryOperator.nin, QueryOperatorCondition$in<V>>> & {
+    [QueryOperator.exists]?: boolean;
+};
+export type QueryConditions<Schema> = {
+    [KeyChain in KeyChains<Schema>]?: QueryOperatorConditions<TypeAtKeyChain<Schema, KeyChain>> | ValueAlternativeType<TypeAtKeyChain<Schema, KeyChain>>;
+};
+export declare enum LogicalOperator {
+    and = "and",
+    or = "or"
+}
+export type LogicalCondition<Schema> = (QueryConditions<Schema> | LogicalConditions<Schema>)[];
+export type LogicalConditions<Schema> = Record<LogicalOperator, LogicalCondition<Schema>>;
+export type Query<Schema> = QueryConditions<Schema> & LogicalConditions<Schema>;
+export type LogicalLevelType<Schema> = {
+    [logicalOpSymbol]: LogicalOperator;
+    [parentLevelSymbol]: CurrentLevelType<Schema>;
+} & LogicalCondition<Schema>;
+export type RootLevelType<Schema> = {
+    [logicalOpSymbol]?: never;
+} & Query<Schema>;
+export type CurrentLevelType<Schema> = RootLevelType<Schema> | LogicalLevelType<Schema>;
+export interface ConditionBuilderOptions {
+    ignoreUndefined?: boolean;
+    keepNaN?: boolean;
+}
+export type RangeOptions = ConditionBuilderOptions;
+export type EqOptions<OP extends QueryOperator = QueryOperator.eq> = {
+    queryOperator?: OP;
+} & ConditionBuilderOptions;
+export type InOptions = {
+    queryOperator?: QueryOperator.in | QueryOperator.nin;
+    ignoreEmpty?: boolean;
+} & ConditionBuilderOptions;
+export type TryConvertToInt<T extends string> = T extends `${Integer}` ? IntegerListAsc[T] : T extends `${number}` ? number : T;
+export type TypeAtKey<T extends Document | readonly unknown[], K> = T extends readonly unknown[] ? K extends number ? T[K] : never : K extends keyof T ? T[K] : never;
+export type ParseKeyChainToPath<KeyChain extends string, Separator extends string = "."> = KeyChain extends `${infer Key}${Separator}${infer Rest}` ? [TryConvertToInt<Key>, ...ParseKeyChainToPath<Rest>] : [TryConvertToInt<KeyChain>];
+export type TypeAtKeyPath<T, KeyPath> = KeyPath extends (string | ArrayIndexes)[] ? KeyPath extends [infer Key, ...infer RestKeyPath] ? T extends readonly (infer E)[] ? Key extends ArrayIndexes<T> ? TypeAtKeyPath<TypeAtKey<T, Key>, RestKeyPath> : TypeAtKeyPath<E, KeyPath> : T extends Document ? TypeAtKeyPath<TypeAtKey<T, Key>, RestKeyPath> : never : T : never;
+export type TypeAtKeyChain<T, KeyChain extends string, Separator extends string = "."> = TypeAtKeyPath<T, ParseKeyChainToPath<KeyChain, Separator>>;
+export interface ConditionFieldNode {
+    kind: "field";
+    field: string;
+    op: QueryOperator;
+    value: any;
+}
+export interface ConditionGroupNode {
+    kind: "group";
+    op: LogicalOperator;
+    nodes: ConditionNode[];
+}
+export type ConditionNode = ConditionFieldNode | ConditionGroupNode;
+export type Condition = ConditionNode;
+export {};
+//# sourceMappingURL=type.d.ts.map

package/lib/ces/condition-builder/type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../../../../src/lib/ces/condition-builder/type.ts"],"names":[],"mappings":"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"}

package/lib/ces/condition-builder/type.js

@@ -0,0 +1,19 @@
+export const parentLevelSymbol = Symbol("parentLevel");
+export const logicalOpSymbol = Symbol("logicalOp");
+export var QueryOperator;
+(function (QueryOperator) {
+    QueryOperator["eq"] = "eq";
+    QueryOperator["ne"] = "ne";
+    QueryOperator["gt"] = "gt";
+    QueryOperator["gte"] = "gte";
+    QueryOperator["lt"] = "lt";
+    QueryOperator["lte"] = "lte";
+    QueryOperator["in"] = "in";
+    QueryOperator["nin"] = "nin";
+    QueryOperator["exists"] = "exists";
+})(QueryOperator || (QueryOperator = {}));
+export var LogicalOperator;
+(function (LogicalOperator) {
+    LogicalOperator["and"] = "and";
+    LogicalOperator["or"] = "or";
+})(LogicalOperator || (LogicalOperator = {}));

package/lib/ces/entity-storage.d.ts

@@ -0,0 +1,50 @@
+import { type ConditionBuilderApi } from "./condition-builder/condition-builder.js";
+import type { InsertOptions, FindOptions, UpdateOptions, DeleteOptions } from "./type.js";
+/**
+ * Entity storage API implementation, provides CRUD operations for entities via CES hook
+ * @template T Entity type extending Entity
+ */
+export declare class CustomEntityStorage<T> {
+    private readonly entityName;
+    /**
+     * @param entityName Entity name defined in manifest
+     */
+    constructor(entityName: string);
+    /**
+     * Insert records
+     * @param value Entity or entities to insert
+     * @param options Insert options, e.g. ordered for insert order
+     * @returns Inserted entity or entities
+     */
+    insert(value: T[], options?: InsertOptions): Promise<T[]>;
+    insert(value: T, options?: InsertOptions): Promise<T>;
+    /**
+     * Find records matching the condition
+     * @param condition Query condition
+     * @param options Find options, e.g. projection, hint, includes
+     * @returns Matching entities
+     */
+    find(condition: (conditionBuilder: ConditionBuilderApi<T>) => void, options?: FindOptions): Promise<T[]>;
+    /**
+     * Update all records matching the condition
+     * @param condition Query condition
+     * @param value Update content, if value is null or undefined, it will clear the record property
+     * @param options Update options, e.g. returnValue, upsert, hint
+     * @returns void
+     */
+    update(condition: (conditionBuilder: ConditionBuilderApi<T>) => void, value?: Partial<T>, options?: UpdateOptions): Promise<void>;
+    /**
+     * Count records matching the condition
+     * @param condition Query condition
+     * @returns Record count
+     */
+    count(condition: (conditionBuilder: ConditionBuilderApi<T>) => void): Promise<number>;
+    /**
+     * Delete records matching the condition (soft delete)
+     * @param condition Query condition
+     * @param options Delete options, e.g. justOne
+     * @returns void
+     */
+    delete(condition: (conditionBuilder: ConditionBuilderApi<T>) => void, options?: DeleteOptions): Promise<void>;
+}
+//# sourceMappingURL=entity-storage.d.ts.map

package/lib/ces/entity-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-storage.d.ts","sourceRoot":"","sources":["../../../src/lib/ces/entity-storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AACtG,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAG1F;;;GAGG;AACH,qBAAa,mBAAmB,CAAC,CAAC;IAIX,OAAO,CAAC,QAAQ,CAAC,UAAU;IAH9C;;OAEG;gBACiC,UAAU,EAAE,MAAM;IAEtD;;;;;OAKG;IACU,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IACzD,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC;IAOlE;;;;;OAKG;IACU,IAAI,CAAC,SAAS,EAAE,CAAC,gBAAgB,EAAE,mBAAmB,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IASrH;;;;;;OAMG;IACU,MAAM,CACf,SAAS,EAAE,CAAC,gBAAgB,EAAE,mBAAmB,CAAC,CAAC,CAAC,KAAK,IAAI,EAC7D,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAClB,OAAO,CAAC,EAAE,aAAa,GACxB,OAAO,CAAC,IAAI,CAAC;IAOhB;;;;OAIG;IACU,KAAK,CAAC,SAAS,EAAE,CAAC,gBAAgB,EAAE,mBAAmB,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC;IASlG;;;;;OAKG;IACU,MAAM,CAAC,SAAS,EAAE,CAAC,gBAAgB,EAAE,mBAAmB,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;CAM7H"}

package/lib/ces/entity-storage.js

@@ -0,0 +1,72 @@
+import { ConditionBuilder } from "./condition-builder/condition-builder.js";
+import { hook } from "@pc-nexus/core";
+/**
+ * Entity storage API implementation, provides CRUD operations for entities via CES hook
+ * @template T Entity type extending Entity
+ */
+export class CustomEntityStorage {
+    entityName;
+    /**
+     * @param entityName Entity name defined in manifest
+     */
+    constructor(entityName) {
+        this.entityName = entityName;
+    }
+    async insert(value, options) {
+        const response = await hook("storage/ces").insert(this.entityName, value, options);
+        const result = await response.json();
+        return result;
+    }
+    /**
+     * Find records matching the condition
+     * @param condition Query condition
+     * @param options Find options, e.g. projection, hint, includes
+     * @returns Matching entities
+     */
+    async find(condition, options) {
+        const conditionBuilder = new ConditionBuilder();
+        condition(conditionBuilder);
+        const ast = conditionBuilder.done();
+        const response = await hook("storage/ces").find(this.entityName, ast, options);
+        const result = await response.json();
+        return result;
+    }
+    /**
+     * Update all records matching the condition
+     * @param condition Query condition
+     * @param value Update content, if value is null or undefined, it will clear the record property
+     * @param options Update options, e.g. returnValue, upsert, hint
+     * @returns void
+     */
+    async update(condition, value, options) {
+        const conditionBuilder = new ConditionBuilder();
+        condition(conditionBuilder);
+        const ast = conditionBuilder.done();
+        await hook("storage/ces").update(this.entityName, ast, value, options);
+    }
+    /**
+     * Count records matching the condition
+     * @param condition Query condition
+     * @returns Record count
+     */
+    async count(condition) {
+        const conditionBuilder = new ConditionBuilder();
+        condition(conditionBuilder);
+        const ast = conditionBuilder.done();
+        const response = await hook("storage/ces").count(this.entityName, ast);
+        const result = await response.json();
+        return result;
+    }
+    /**
+     * Delete records matching the condition (soft delete)
+     * @param condition Query condition
+     * @param options Delete options, e.g. justOne
+     * @returns void
+     */
+    async delete(condition, options) {
+        const conditionBuilder = new ConditionBuilder();
+        condition(conditionBuilder);
+        const ast = conditionBuilder.done();
+        await hook("storage/ces").delete(this.entityName, ast, options);
+    }
+}

package/lib/ces/index.d.ts

@@ -0,0 +1,9 @@
+import { CustomEntityStorage } from "./entity-storage.js";
+/** Pre-created CES storage instance */
+export declare const ces: {
+    /**
+     * @param entityName Entity name defined in manifest
+     */
+    entity<T>(entityName: string): CustomEntityStorage<T>;
+};
+//# sourceMappingURL=index.d.ts.map

package/lib/ces/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/ces/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D,uCAAuC;AACvC,eAAO,MAAM,GAAG;IACZ;;OAEG;WACI,CAAC,cAAc,MAAM,GAAG,mBAAmB,CAAC,CAAC,CAAC;CAGxD,CAAC"}

package/lib/ces/index.js

@@ -0,0 +1,10 @@
+import { CustomEntityStorage } from "./entity-storage.js";
+/** Pre-created CES storage instance */
+export const ces = {
+    /**
+     * @param entityName Entity name defined in manifest
+     */
+    entity(entityName) {
+        return new CustomEntityStorage(entityName);
+    },
+};

package/lib/ces/type.d.ts

@@ -0,0 +1,46 @@
+export type Projection = string[];
+export interface InsertOptions {
+    /** Whether to insert in order, default is false */
+    ordered?: boolean;
+}
+/**
+ * Options for entity().updateOne or entity().updateMany
+ */
+export interface UpdateOptions {
+}
+/**
+ * Options for entity().delete
+ */
+export interface DeleteOptions {
+}
+/**
+ * Options for find operations that return multiple records
+ * @template T Entity type extending Entity
+ */
+export interface FindOptions {
+    /** Number of records to skip */
+    skip?: number;
+    /** Maximum number of records to return */
+    limit?: number;
+    /** Sort order specification, multiple sort properties are supported */
+    sort?: SortProperty[];
+    /** Index hint for query optimization */
+    hint?: string;
+    /** Fields to include or exclude in the result */
+    projection?: Projection;
+    /** Whether to include metadata in the result
+     * 1: default is false not include metadata
+     * 2: true include metadata [_created_by, _created_at, _is_deleted,_updated_by, _updated_at, _deleted_by, _deleted_at] */
+    includes?: {
+        metadata: boolean;
+    };
+}
+export interface SortProperty {
+    propertyKey: string;
+    order: Direction;
+}
+export declare enum Direction {
+    ascending = 1,
+    descending = -1
+}
+//# sourceMappingURL=type.d.ts.map

package/lib/ces/type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../../../src/lib/ces/type.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,MAAM,EAAE,CAAC;AAElC,MAAM,WAAW,aAAa;IAC1B,mDAAmD;IACnD,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;CAAG;AAEjC;;GAEG;AACH,MAAM,WAAW,aAAa;CAAG;AAEjC;;;GAGG;AACH,MAAM,WAAW,WAAW;IACxB,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,IAAI,CAAC,EAAE,YAAY,EAAE,CAAC;IACtB,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;6HAEyH;IACzH,QAAQ,CAAC,EAAE;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;CACpC;AAED,MAAM,WAAW,YAAY;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,SAAS,CAAC;CACpB;AAED,oBAAY,SAAS;IACjB,SAAS,IAAI;IACb,UAAU,KAAK;CAClB"}

package/lib/ces/type.js

@@ -0,0 +1,5 @@
+export var Direction;
+(function (Direction) {
+    Direction[Direction["ascending"] = 1] = "ascending";
+    Direction[Direction["descending"] = -1] = "descending";
+})(Direction || (Direction = {}));

package/lib/kvs/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Key-Value Store (KVS)
+ */
+export declare const kvs: {};
+//# sourceMappingURL=index.d.ts.map

package/lib/kvs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/kvs/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,GAAG,IAAK,CAAC"}

package/lib/kvs/index.js

@@ -0,0 +1,4 @@
+/**
+ * Key-Value Store (KVS)
+ */
+export const kvs = {};

package/lib/os/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * EAP (Early Access Program)
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/lib/os/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/os/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,CAAC"}

package/lib/os/index.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,10 +1,12 @@
 {
   "name": "@pc-nexus/storage",
-  "version": "0.0.1-next.1",
+  "version": "0.0.1-next.2",
   "description": "",
   "main": "index.js",
   "scripts": {
     "build": "tsc",
+    "pretest": "npm run build",
+    "test": "NODE_OPTIONS=\"--experimental-vm-modules --loader ts-node/esm\" jest",
     "pub:alpha": "cd dist && npm publish --access public --tag alpha",
     "pub": "cd dist && npm publish --access public --tag latest",
     "pub-next": "cd dist && npm publish --access public --tag next"
@@ -19,9 +21,6 @@
     "test": "test",
     "lib": "dist"
   },
-  "files": [
-    "dist"
-  ],
   "types": "index.d.ts",
   "exports": {
     ".": {
@@ -30,7 +29,9 @@
     }
   },
   "type": "module",
-  "dependencies": {},
+  "dependencies": {
+    "lodash": "^4.17.21"
+  },
   "devDependencies": {},
   "peerDependencies": {}
 }