velocious 1.0.107 → 1.0.109

package/dist/src/database/query/delete-base.js

@@ -0,0 +1,15 @@
+// @ts-check
+import QueryBase from "./base.js";
+export default class VelociousDatabaseQueryDeleteBase extends QueryBase {
+    /**
+     * @param {object} args
+     * @param {Record<string, any>} args.conditions
+     * @param {import("../drivers/base.js").default} args.driver
+     * @param {string} args.tableName
+     */
+    constructor({ conditions, driver, tableName }) {
+        super({ driver });
+        this.conditions = conditions;
+        this.tableName = tableName;
+    }
+}

package/dist/src/database/query/drop-table-base.d.ts

@@ -0,0 +1,20 @@
+export default class VelociousDatabaseQueryDropTableBase extends QueryBase {
+    /**
+     * @param {object} args
+     * @param {boolean} [args.cascade]
+     * @param {import("./../drivers/base.js").default} args.driver
+     * @param {boolean} [args.ifExists]
+     * @param {string} args.tableName
+     */
+    constructor({ cascade, driver, ifExists, tableName, ...restArgs }: {
+        cascade?: boolean;
+        driver: import("./../drivers/base.js").default;
+        ifExists?: boolean;
+        tableName: string;
+    });
+    cascade: boolean;
+    ifExists: boolean;
+    tableName: string;
+}
+import QueryBase from "./base.js";
+//# sourceMappingURL=drop-table-base.d.ts.map

package/dist/src/database/query/drop-table-base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drop-table-base.d.ts","sourceRoot":"","sources":["../../../../src/database/query/drop-table-base.js"],"names":[],"mappings":"AAKA;IACE;;;;;;OAMG;IACH,mEALG;QAAuB,OAAO,GAAtB,OAAO;QACsC,MAAM,EAAnD,OAAO,sBAAsB,EAAE,OAAO;QACvB,QAAQ,GAAvB,OAAO;QACM,SAAS,EAAtB,MAAM;KAChB,EASA;IAHC,iBAAsB;IACtB,kBAAwB;IACxB,kBAA0B;CAmC7B;sBArDqB,WAAW"}

package/dist/src/database/query/drop-table-base.js

@@ -0,0 +1,44 @@
+// @ts-check
+import QueryBase from "./base.js";
+import restArgsError from "../../utils/rest-args-error.js";
+export default class VelociousDatabaseQueryDropTableBase extends QueryBase {
+    /**
+     * @param {object} args
+     * @param {boolean} [args.cascade]
+     * @param {import("./../drivers/base.js").default} args.driver
+     * @param {boolean} [args.ifExists]
+     * @param {string} args.tableName
+     */
+    constructor({ cascade, driver, ifExists, tableName, ...restArgs }) {
+        super({ driver });
+        restArgsError(restArgs);
+        this.cascade = cascade;
+        this.ifExists = ifExists;
+        this.tableName = tableName;
+    }
+    /**
+     * @returns {Promise<string[]>}
+     */
+    async toSQLs() {
+        const databaseType = this.getDatabaseType();
+        const options = this.getOptions();
+        const { cascade, ifExists, tableName } = this;
+        const sqls = [];
+        let sql = "";
+        if (databaseType == "mssql" && ifExists) {
+            sql += `IF EXISTS(SELECT * FROM [sysobjects] WHERE [name] = ${options.quote(tableName)} AND [xtype] = 'U') BEGIN `;
+        }
+        sql += "DROP TABLE";
+        if (databaseType != "mssql" && ifExists)
+            sql += " IF EXISTS";
+        sql += ` ${options.quoteTableName(tableName)}`;
+        if (cascade && databaseType == "pgsql") {
+            sql += " cascade";
+        }
+        if (databaseType == "mssql" && ifExists) {
+            sql += " END";
+        }
+        sqls.push(sql);
+        return sqls;
+    }
+}

package/dist/src/database/query/from-base.d.ts

@@ -0,0 +1,19 @@
+export default class VelociousDatabaseQueryFromBase {
+    /** @type {import("./index.js").default  | null} */
+    query: import("./index.js").default | null;
+    /**
+     * @param {import("./index.js").default} query
+     * @returns {void}
+     */
+    setQuery(query: import("./index.js").default): void;
+    /**
+     * @returns {import("../query-parser/options.js").default}
+     */
+    getOptions(): import("../query-parser/options.js").default;
+    /**
+     * @abstract
+     * @returns {string[]}
+     */
+    toSql(): string[];
+}
+//# sourceMappingURL=from-base.d.ts.map

package/dist/src/database/query/from-base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"from-base.d.ts","sourceRoot":"","sources":["../../../../src/database/query/from-base.js"],"names":[],"mappings":"AAEA;IACE,mDAAmD;IACnD,OADW,OAAO,YAAY,EAAE,OAAO,GAAI,IAAI,CACnC;IAEZ;;;OAGG;IACH,gBAHW,OAAO,YAAY,EAAE,OAAO,GAC1B,IAAI,CAIhB;IAED;;OAEG;IACH,cAFa,OAAO,4BAA4B,EAAE,OAAO,CAMxD;IAED;;;OAGG;IACH,SAFa,MAAM,EAAE,CAIpB;CACF"}

package/dist/src/database/query/from-base.js

@@ -0,0 +1,27 @@
+// @ts-check
+export default class VelociousDatabaseQueryFromBase {
+    /** @type {import("./index.js").default  | null} */
+    query = null;
+    /**
+     * @param {import("./index.js").default} query
+     * @returns {void}
+     */
+    setQuery(query) {
+        this.query = query;
+    }
+    /**
+     * @returns {import("../query-parser/options.js").default}
+     */
+    getOptions() {
+        if (!this.query)
+            throw new Error("'query' hasn't been set");
+        return this.query.getOptions();
+    }
+    /**
+     * @abstract
+     * @returns {string[]}
+     */
+    toSql() {
+        throw new Error("'toSql' wasn't implemented");
+    }
+}

package/dist/src/database/query/from-plain.d.ts

@@ -0,0 +1,9 @@
+export default class VelociousDatabaseQueryFromPlain extends FromBase {
+    /**
+     * @param {string} plain
+     */
+    constructor(plain: string);
+    plain: string;
+}
+import FromBase from "./from-base.js";
+//# sourceMappingURL=from-plain.d.ts.map

package/dist/src/database/query/from-plain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"from-plain.d.ts","sourceRoot":"","sources":["../../../../src/database/query/from-plain.js"],"names":[],"mappings":"AAIA;IACE;;OAEG;IACH,mBAFW,MAAM,EAKhB;IADC,cAAkB;CAIrB;qBAZoB,gBAAgB"}

package/dist/src/database/query/from-plain.js

@@ -0,0 +1,12 @@
+// @ts-check
+import FromBase from "./from-base.js";
+export default class VelociousDatabaseQueryFromPlain extends FromBase {
+    /**
+     * @param {string} plain
+     */
+    constructor(plain) {
+        super();
+        this.plain = plain;
+    }
+    toSql() { return [this.plain]; }
+}

package/dist/src/database/query/from-table.d.ts

@@ -0,0 +1,9 @@
+export default class VelociousDatabaseQueryFromTable extends FromBase {
+    /**
+     * @param {string} tableName
+     */
+    constructor(tableName: string);
+    tableName: string;
+}
+import FromBase from "./from-base.js";
+//# sourceMappingURL=from-table.d.ts.map

package/dist/src/database/query/from-table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"from-table.d.ts","sourceRoot":"","sources":["../../../../src/database/query/from-table.js"],"names":[],"mappings":"AAIA;IACE;;OAEG;IACH,uBAFW,MAAM,EAKhB;IADC,kBAA0B;CAM7B;qBAdoB,gBAAgB"}

package/dist/src/database/query/from-table.js

@@ -0,0 +1,14 @@
+// @ts-check
+import FromBase from "./from-base.js";
+export default class VelociousDatabaseQueryFromTable extends FromBase {
+    /**
+     * @param {string} tableName
+     */
+    constructor(tableName) {
+        super();
+        this.tableName = tableName;
+    }
+    toSql() {
+        return [this.getOptions().quoteTableName(this.tableName)];
+    }
+}

package/dist/src/database/query/index.d.ts

@@ -0,0 +1,219 @@
+/**
+ * A generic query over some model type.
+ */
+export default class VelociousDatabaseQuery {
+    /**
+     * @param {object} args
+     * @param {import("../drivers/base.js").default} args.driver
+     * @param {Array<import("./from-base.js").default>} [args.froms]
+     * @param {string[]} [args.groups]
+     * @param {Array<import("./join-base.js").default>} [args.joins]
+     * @param {import("../handler.js").default} args.handler
+     * @param {number | null} [args.limit]
+     * @param {typeof import("../record/index.js").default} [args.modelClass]
+     * @param {number | null} [args.offset]
+     * @param {Array<import("./order-base.js").default>} [args.orders]
+     * @param {number | null} [args.page]
+     * @param {number} [args.perPage]
+     * @param {NestedPreloadRecord} [args.preload]
+     * @param {Array<import("./select-base.js").default>} [args.selects]
+     * @param {Array<import("./where-base.js").default>} [args.wheres]
+     */
+    constructor({ driver, froms, groups, joins, handler, limit, modelClass, offset, orders, page, perPage, preload, selects, wheres, ...restArgs }: {
+        driver: import("../drivers/base.js").default;
+        froms?: Array<import("./from-base.js").default>;
+        groups?: string[];
+        joins?: Array<import("./join-base.js").default>;
+        handler: import("../handler.js").default;
+        limit?: number | null;
+        modelClass?: typeof import("../record/index.js").default;
+        offset?: number | null;
+        orders?: Array<import("./order-base.js").default>;
+        page?: number | null;
+        perPage?: number;
+        preload?: NestedPreloadRecord;
+        selects?: Array<import("./select-base.js").default>;
+        wheres?: Array<import("./where-base.js").default>;
+    });
+    driver: import("../drivers/base.js").default;
+    handler: import("../handler.js").default;
+    logger: Logger;
+    modelClass: typeof import("../record/index.js").default;
+    _froms: import("./from-base.js").default[];
+    _groups: string[];
+    _joins: import("./join-base.js").default[];
+    _limit: number;
+    _offset: number;
+    _orders: import("./order-base.js").default[];
+    _page: number;
+    _perPage: number;
+    _preload: NestedPreloadRecord;
+    _selects: SelectBase[];
+    /** @type {import("./where-base.js").default[]} */
+    _wheres: import("./where-base.js").default[];
+    /**
+     * @returns {VelociousDatabaseQuery}
+     */
+    clone(): VelociousDatabaseQuery;
+    /**
+     * @returns {Promise<number>}
+     */
+    count(): Promise<number>;
+    /**
+     * @returns {import("./from-base.js").default[]}
+     */
+    getFroms(): import("./from-base.js").default[];
+    /**
+     * @returns {string[]}
+     */
+    getGroups(): string[];
+    /**
+     * @returns {typeof import("../record/index.js").default}
+     */
+    getModelClass(): typeof import("../record/index.js").default;
+    /**
+     * @returns {import("../query-parser/options.js").default}
+     */
+    getOptions(): import("../query-parser/options.js").default;
+    /**
+     * @returns {Array<import("./select-base.js").default>}
+     */
+    getSelects(): Array<import("./select-base.js").default>;
+    /**
+     * @returns {Promise<void>}
+     */
+    destroyAll(): Promise<void>;
+    /**
+     * @param {number|string} recordId
+     * @returns {Promise<import("../record/index.js").default>}
+     */
+    find(recordId: number | string): Promise<import("../record/index.js").default>;
+    /**
+     * @param {{[key: string]: any}} conditions
+     * @returns {Promise<import("../record/index.js").default|null>}
+     */
+    findBy(conditions: {
+        [key: string]: any;
+    }): Promise<import("../record/index.js").default | null>;
+    /**
+     * @param {{[key: string]: any}} conditions
+     * @param {function() : void} callback
+     * @returns {Promise<import("../record/index.js").default>}
+     */
+    findOrCreateBy(conditions: {
+        [key: string]: any;
+    }, callback: () => void): Promise<import("../record/index.js").default>;
+    /**
+     * @param {{[key: string]: any}} conditions
+     * @returns {Promise<import("../record/index.js").default>}
+     */
+    findByOrFail(conditions: {
+        [key: string]: any;
+    }): Promise<import("../record/index.js").default>;
+    /**
+     * @param {object} conditions
+     * @param {function(import("../record/index.js").default) : void} callback
+     * @returns {Promise<import("../record/index.js").default>}
+     */
+    findOrInitializeBy(conditions: object, callback: (arg0: import("../record/index.js").default) => void): Promise<import("../record/index.js").default>;
+    /**
+     * @returns {Promise<import("../record/index.js").default>}
+     */
+    first(): Promise<import("../record/index.js").default>;
+    /**
+     * @param {string|import("./from-base.js").default} from
+     * @returns {this}
+     */
+    from(from: string | import("./from-base.js").default): this;
+    /**
+     * @param {string} group
+     * @returns {this}
+     */
+    group(group: string): this;
+    /**
+     * @param {string|{[key: string]: any}} join
+     * @returns {this}
+     */
+    joins(join: string | {
+        [key: string]: any;
+    }): this;
+    /**
+     * @returns {Promise<import("../record/index.js").default>}
+     */
+    last(): Promise<import("../record/index.js").default>;
+    /**
+     * @param {number} value
+     * @returns {this}
+     */
+    limit(value: number): this;
+    /**
+     * @param {number} value
+     * @returns {this}
+     */
+    offset(value: number): this;
+    /**
+     * @param {string | number} order
+     * @returns {this}
+     */
+    order(order: string | number): this;
+    /**
+     * @param {number} pageNumber
+     * @returns {this}
+     */
+    page(pageNumber: number): this;
+    /**
+     * @param {number} perPage
+     * @returns {this}
+     */
+    perPage(perPage: number): this;
+    /**
+     * @param {NestedPreloadRecord} data
+     * @returns {this}
+     */
+    preload(data: NestedPreloadRecord): this;
+    /**
+     * @param {string | number} order
+     * @returns {this}
+     */
+    reorder(order: string | number): this;
+    /**
+     * @returns {this}
+     */
+    reverseOrder(): this;
+    /**
+     * @param {SelectArgumentType} select
+     * @returns {this}
+     */
+    select(select: SelectArgumentType): this;
+    /**
+     * @returns {Promise<Array<object>>} Array of results from the database
+     */
+    _executeQuery(): Promise<Array<object>>;
+    /**
+     * @returns {Promise<Array<object>>} Array of results from the database
+     */
+    results(): Promise<Array<object>>;
+    /**
+     * Converts query results to array of model instances
+     * @returns {Promise<Array<import("../record/index.js").default>>}
+     */
+    toArray(): Promise<Array<import("../record/index.js").default>>;
+    /**
+     * Generates SQL string representing this query
+     * @returns {string} SQL string representing this query
+     */
+    toSql(): string;
+    /**
+     * @param {WhereArgumentType} where
+     * @returns {VelociousDatabaseQuery} This query instance
+     */
+    where(where: WhereArgumentType): VelociousDatabaseQuery;
+}
+export type NestedPreloadRecord = {
+    [key: string]: boolean | NestedPreloadRecord;
+};
+export type SelectArgumentType = string | string[] | import("./select-base.js").default | import("./select-base.js").default[];
+export type WhereArgumentType = object | string;
+import { Logger } from "../../logger.js";
+import SelectBase from "./select-base.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/database/query/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/database/query/index.js"],"names":[],"mappings":"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"}