remult 3.4.0-next.5 → 3.4.0-next.7

package/internals.d.ts

@@ -14,6 +14,8 @@ export declare const actionInfo: {
 };
 export { isOfType } from './src/isOfType.js';
 export type { ClassType } from './classType.js';
+export type { SubscriptionServerRouteApi, SubscriptionServerRouteHandlerArgs, } from './server/remult-api-server.js';
+export type { DataApiResponse } from './src/data-api.js';
 export { flags } from './src/remult3/remult3.js';
 export { SseSubscriptionClient } from './src/live-query/SseSubscriptionClient.js';
 export { DataProviderPromiseWrapper } from './src/data-interfaces.js';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "remult",
-    "version": "3.4.0-next.5",
+    "version": "3.4.0-next.7",
     "description": "A CRUD framework for full-stack TypeScript",
     "homepage": "https://remult.dev",
     "repository": {

package/remult-mongo.js

@@ -228,6 +228,8 @@ var MongoEntityDataProvider = /** @class */ (function () {
         try {
             for (var _b = tslib_1.__values(this.entity.fields), _c = _b.next(); !_c.done; _c = _b.next()) {
                 var col = _c.value;
+                if (col.dbReadOnly || col.isServerExpression)
+                    continue;
                 var val = toDb(col, row[col.key]);
                 if (val === null)
                     val = NULL;
@@ -494,7 +496,7 @@ var MongoEntityDataProvider = /** @class */ (function () {
                                 f_1 = _c.value;
                                 if (!f_1.dbReadOnly && !f_1.isServerExpression) {
                                     if (keys.includes(f_1.key)) {
-                                        newR[f_1.key] = toDb(f_1, data[f_1.key]);
+                                        newR[e.$dbNameOf(f_1)] = toDb(f_1, data[f_1.key]);
                                     }
                                 }
                             }
@@ -797,27 +799,32 @@ var FilterConsumerBridgeToMongo = /** @class */ (function () {
         this.add(col, val, '$lt');
     };
     FilterConsumerBridgeToMongo.prototype.containsCaseInsensitive = function (col, val) {
-        this.add(col, val, '$regex', { $options: 'i' });
+        this.addRegex(col, val);
     };
     FilterConsumerBridgeToMongo.prototype.notContainsCaseInsensitive = function (col, val) {
-        var _this = this;
-        this.result.push(function () {
-            var _a;
-            return (_a = {},
-                _a[_this.nameProvider.$dbNameOf(col)] = {
-                    $not: {
-                        $regex: isNull(val) ? val : toDb(col, val),
-                        $options: 'i',
-                    },
-                },
-                _a);
-        });
+        this.addRegex(col, val, '', '', true);
     };
     FilterConsumerBridgeToMongo.prototype.startsWithCaseInsensitive = function (col, val) {
-        this.add(col, "^".concat(val), '$regex', { $options: 'i' });
+        this.addRegex(col, val, '^');
     };
     FilterConsumerBridgeToMongo.prototype.endsWithCaseInsensitive = function (col, val) {
-        this.add(col, "".concat(val, "$"), '$regex', { $options: 'i' });
+        this.addRegex(col, val, '', '$');
+    };
+    FilterConsumerBridgeToMongo.prototype.addRegex = function (col, val, start, end, negate) {
+        var _this = this;
+        if (start === void 0) { start = ''; }
+        if (end === void 0) { end = ''; }
+        if (negate === void 0) { negate = false; }
+        this.result.push(function () {
+            var _a;
+            var regex = {
+                $regex: start + toDb(col, val).replace(/[.*+?^${}()|[\]\\]/g, '\\$&') + end,
+                $options: 'i',
+            };
+            return _a = {},
+                _a[_this.nameProvider.$dbNameOf(col)] = negate ? { $not: regex } : regex,
+                _a;
+        });
     };
     FilterConsumerBridgeToMongo.prototype.add = function (col, val, operator, moreOptions) {
         var _this = this;

package/server/remult-api-server.d.ts

@@ -1,6 +1,7 @@
 import type { ClassType } from '../classType.js';
 import type { Allowed, UserInfo } from '../src/context.js';
 import { Remult } from '../src/context.js';
+import type { DataApiResponse } from '../src/data-api.js';
 import type { DataProvider } from '../src/data-interfaces.js';
 import type { LiveQueryStorage, SubscriptionServer } from '../src/live-query/SubscriptionServer.js';
 import { IdEntity } from '../src/remult3/IdEntity.js';
@@ -167,6 +168,17 @@ export interface GenericResponse {
     status(statusCode: number): GenericResponse;
     end(): void;
 }
+export interface SubscriptionServerRouteApi {
+    rootPath: string;
+    addRoute(relativePath: string, method: 'get' | 'post', handler: (args: SubscriptionServerRouteHandlerArgs) => Promise<void>): void;
+}
+export interface SubscriptionServerRouteHandlerArgs {
+    remult: Remult;
+    res: DataApiResponse;
+    req: GenericRequestInfo;
+    origRes: GenericResponse;
+    getBody(): Promise<any>;
+}
 export interface queuedJobInfo {
     info: queuedJobInfoResponse;
     userId: string;

package/server/remult-api-server.js

@@ -441,45 +441,25 @@ var RemultServerImplementation = /** @class */ (function () {
             r.route(this.options.rootPath + '/me').get(this.process(function (remult, req, res) { return tslib_1.__awaiter(_this, void 0, void 0, function () { var _a; return tslib_1.__generator(this, function (_b) {
                 return [2 /*return*/, res.success((_a = remult.user) !== null && _a !== void 0 ? _a : null)];
             }); }); }));
-            if (this.options.subscriptionServer instanceof SseSubscriptionServer_js_1.SseSubscriptionServer) {
-                var streamPath = this.options.rootPath + '/' + SubscriptionChannel_js_1.streamUrl;
-                r.route(streamPath).get(this.process(function (remult, req, res, origReq, origRes) { return tslib_1.__awaiter(_this, void 0, void 0, function () {
-                    return tslib_1.__generator(this, function (_a) {
-                        ;
-                        remult.subscriptionServer.openHttpServerStream(origReq, origRes);
-                        return [2 /*return*/];
-                    });
-                }); }));
-                r.route(streamPath + '/subscribe').post(this.process(function (remult, _2, res, _, _1, origReq) { return tslib_1.__awaiter(_this, void 0, void 0, function () {
-                    var body, _a, _b;
-                    return tslib_1.__generator(this, function (_c) {
-                        switch (_c.label) {
-                            case 0:
-                                _b = (_a = remult.subscriptionServer).subscribeToChannel;
-                                return [4 /*yield*/, this.coreOptions.getRequestBody(origReq)];
-                            case 1:
-                                body = _b.apply(_a, [_c.sent(), res,
-                                    remult]);
-                                return [2 /*return*/];
-                        }
-                    });
-                }); }));
-                r.route(streamPath + '/unsubscribe').post(this.process(function (remult, req, res, reqInfo, origRes, origReq) { return tslib_1.__awaiter(_this, void 0, void 0, function () {
-                    var _a, _b;
-                    return tslib_1.__generator(this, function (_c) {
-                        switch (_c.label) {
-                            case 0:
-                                ;
-                                _b = (_a = remult.subscriptionServer).subscribeToChannel;
-                                return [4 /*yield*/, this.coreOptions.getRequestBody(origReq)];
-                            case 1:
-                                _b.apply(_a, [_c.sent(), res,
-                                    remult,
-                                    true]);
-                                return [2 /*return*/];
-                        }
-                    });
-                }); }));
+            var subscriptionServer = this.options.subscriptionServer;
+            if (subscriptionServer === null || subscriptionServer === void 0 ? void 0 : subscriptionServer.initApiServer) {
+                subscriptionServer.initApiServer({
+                    rootPath: this.options.rootPath,
+                    addRoute: function (relativePath, method, handler) {
+                        r.route(_this.options.rootPath + relativePath)[method](_this.process(function (remult, _, res, req, origRes, origReq) { return tslib_1.__awaiter(_this, void 0, void 0, function () {
+                            var _this = this;
+                            return tslib_1.__generator(this, function (_a) {
+                                return [2 /*return*/, handler({
+                                        remult: remult,
+                                        res: res,
+                                        req: req,
+                                        origRes: origRes,
+                                        getBody: function () { return _this.coreOptions.getRequestBody(origReq); },
+                                    })];
+                            });
+                        }); }));
+                    },
+                });
             }
             r.route(this.options.rootPath + '/' + SubscriptionChannel_js_1.liveQueryKeepAliveRoute).post(this.process(function (remult, req, res, reqInfo, origRes, origReq) { return tslib_1.__awaiter(_this, void 0, void 0, function () {
                 var body, queryIds, result;

package/src/column-interfaces.d.ts

@@ -58,7 +58,11 @@ export interface FieldOptions<entityType = unknown, valueType = unknown> {
      * @type {AllowedForInstance<entityType>}
      */
     allowApiUpdate?: AllowedForInstance<entityType>;
-    /** An arrow function that'll be used to perform validations on it
+    /** An arrow function that'll be used to perform validations on it.
+     *
+     * `validate` from several option objects is additive: each one is appended.
+     * A function option is the only way to replace validators already set, including a built-in one:
+     * `(options) => { options.validate = ... }`.
      * @example
      * @Fields.string({
      *   validate: Validators.required

package/src/data-api.d.ts

@@ -5,13 +5,10 @@ export declare class DataApi<T = unknown> {
     private repository;
     private remult;
     constructor(repository: Repository<T>, remult: Remult);
-    httpGet(res: DataApiResponse, req: DataApiRequest, serializeContext: () => Promise<any>): void | Promise<void>;
+    httpGet(res: DataApiResponse, req: DataApiRequest, serializeContext: () => Promise<any>): Promise<void>;
     httpPost(res: DataApiResponse, req: DataApiRequest, body: any, serializeContext: () => Promise<any>): Promise<void>;
     upsertMany(response: DataApiResponse, request: DataApiRequest, body: any): Promise<void>;
-    query(response: DataApiResponse, request: DataApiRequest, body: any): Promise<{
-        items: any[];
-        aggregates: import("./remult3/remult3.js").GroupByResult<T, any[], any[], any[], any[], any[], any[]>;
-    } | undefined>;
+    query(response: DataApiResponse, request: DataApiRequest, body: any): Promise<void>;
     static defaultGetLimit: number;
     get(response: DataApiResponse, id: any): Promise<void>;
     count(response: DataApiResponse, request: DataApiRequest, body?: any): Promise<void>;

package/src/data-api.js

@@ -17,25 +17,39 @@ var DataApi = /** @class */ (function () {
         this.remult = remult;
     }
     DataApi.prototype.httpGet = function (res, req, serializeContext) {
-        try {
-            var action = req === null || req === void 0 ? void 0 : req.get('__action');
-            if (action === null || action === void 0 ? void 0 : action.startsWith(rest_data_provider_js_1.liveQueryAction))
-                return this.liveQuery(res, req, undefined, serializeContext, action.substring(rest_data_provider_js_1.liveQueryAction.length));
-            switch (action) {
-                case 'get':
-                case 'count':
-                    return this.count(res, req, undefined);
-                case 'groupBy':
-                    return res.success(this.groupBy(req, undefined));
-            }
-            return this.getArray(res, req, undefined);
-        }
-        catch (err) {
-            if (err.isForbiddenError)
-                res.forbidden(err);
-            else
-                res.error(err, this.repository.metadata);
-        }
+        return tslib_1.__awaiter(this, void 0, void 0, function () {
+            var action, _a, _b, _c, err_1;
+            return tslib_1.__generator(this, function (_d) {
+                switch (_d.label) {
+                    case 0:
+                        _d.trys.push([0, 5, , 6]);
+                        action = req === null || req === void 0 ? void 0 : req.get('__action');
+                        if (action === null || action === void 0 ? void 0 : action.startsWith(rest_data_provider_js_1.liveQueryAction))
+                            return [2 /*return*/, this.liveQuery(res, req, undefined, serializeContext, action.substring(rest_data_provider_js_1.liveQueryAction.length))];
+                        _a = action;
+                        switch (_a) {
+                            case 'get': return [3 /*break*/, 1];
+                            case 'count': return [3 /*break*/, 1];
+                            case 'groupBy': return [3 /*break*/, 2];
+                        }
+                        return [3 /*break*/, 4];
+                    case 1: return [2 /*return*/, this.count(res, req, undefined)];
+                    case 2:
+                        _c = (_b = res).success;
+                        return [4 /*yield*/, this.groupBy(req, undefined)];
+                    case 3: return [2 /*return*/, _c.apply(_b, [_d.sent()])];
+                    case 4: return [2 /*return*/, this.getArray(res, req, undefined)];
+                    case 5:
+                        err_1 = _d.sent();
+                        if (err_1.isForbiddenError)
+                            res.forbidden(err_1.message);
+                        else
+                            res.error(err_1, this.repository.metadata);
+                        return [3 /*break*/, 6];
+                    case 6: return [2 /*return*/];
+                }
+            });
+        });
     };
     DataApi.prototype.httpPost = function (res, req, body, serializeContext) {
         return tslib_1.__awaiter(this, void 0, void 0, function () {
@@ -47,14 +61,14 @@ var DataApi = /** @class */ (function () {
                     };
                 }
             }
-            var action, _a, _b, _c, _d, _e, _f, _g, err_1;
-            return tslib_1.__generator(this, function (_h) {
-                switch (_h.label) {
+            var action, _a, _b, _c, _d, _e, err_2;
+            return tslib_1.__generator(this, function (_f) {
+                switch (_f.label) {
                     case 0:
                         action = req === null || req === void 0 ? void 0 : req.get('__action');
-                        _h.label = 1;
+                        _f.label = 1;
                     case 1:
-                        _h.trys.push([1, 16, , 17]);
+                        _f.trys.push([1, 15, , 16]);
                         if (action === null || action === void 0 ? void 0 : action.startsWith(rest_data_provider_js_1.liveQueryAction)) {
                             validateWhereInBody();
                             return [2 /*return*/, this.liveQuery(res, req, body, serializeContext, action.substring(rest_data_provider_js_1.liveQueryAction.length))];
@@ -70,7 +84,7 @@ var DataApi = /** @class */ (function () {
                             case 'endLiveQuery': return [3 /*break*/, 9];
                             case 'query': return [3 /*break*/, 11];
                         }
-                        return [3 /*break*/, 13];
+                        return [3 /*break*/, 12];
                     case 2:
                         validateWhereInBody();
                         return [2 /*return*/, this.getArray(res, req, body)];
@@ -80,7 +94,7 @@ var DataApi = /** @class */ (function () {
                     case 4:
                         _c = (_b = res).success;
                         return [4 /*yield*/, this.groupBy(req, body)];
-                    case 5: return [2 /*return*/, _c.apply(_b, [_h.sent()])];
+                    case 5: return [2 /*return*/, _c.apply(_b, [_f.sent()])];
                     case 6:
                         validateWhereInBody();
                         return [2 /*return*/, this.deleteMany(res, req, body)];
@@ -90,26 +104,23 @@ var DataApi = /** @class */ (function () {
                     case 8: return [2 /*return*/, this.upsertMany(res, req, body)];
                     case 9: return [4 /*yield*/, this.remult.liveQueryStorage.remove(body.id)];
                     case 10:
-                        _h.sent();
+                        _f.sent();
                         res.success('ok');
                         return [2 /*return*/];
-                    case 11:
-                        _e = (_d = res).success;
-                        return [4 /*yield*/, this.query(res, req, body)];
-                    case 12: return [2 /*return*/, _e.apply(_d, [_h.sent()])];
-                    case 13:
-                        _g = (_f = res).created;
+                    case 11: return [2 /*return*/, this.query(res, req, body)];
+                    case 12:
+                        _e = (_d = res).created;
                         return [4 /*yield*/, this.post(body, req)];
-                    case 14: return [2 /*return*/, _g.apply(_f, [_h.sent()])];
-                    case 15: return [3 /*break*/, 17];
-                    case 16:
-                        err_1 = _h.sent();
-                        if (err_1.isForbiddenError)
-                            res.forbidden(err_1.message);
+                    case 13: return [2 /*return*/, _e.apply(_d, [_f.sent()])];
+                    case 14: return [3 /*break*/, 16];
+                    case 15:
+                        err_2 = _f.sent();
+                        if (err_2.isForbiddenError)
+                            res.forbidden(err_2.message);
                         else
-                            res.error(err_1, this.repository.metadata);
-                        return [3 /*break*/, 17];
-                    case 17: return [2 /*return*/];
+                            res.error(err_2, this.repository.metadata);
+                        return [3 /*break*/, 16];
+                    case 16: return [2 /*return*/];
                 }
             });
         });
@@ -187,7 +198,7 @@ var DataApi = /** @class */ (function () {
     };
     DataApi.prototype.query = function (response, request, body) {
         return tslib_1.__awaiter(this, void 0, void 0, function () {
-            var aggregate, rest, aggregateRequest, _a, r, _b, aggregates, err_2;
+            var aggregate, rest, aggregateRequest, _a, r, _b, aggregates, err_3;
             return tslib_1.__generator(this, function (_c) {
                 switch (_c.label) {
                     case 0:
@@ -215,16 +226,16 @@ var DataApi = /** @class */ (function () {
                             ])];
                     case 2:
                         _a = tslib_1.__read.apply(void 0, [_c.sent(), 2]), r = _a[0].r, _b = tslib_1.__read(_a[1], 1), aggregates = _b[0];
-                        return [2 /*return*/, {
+                        return [2 /*return*/, response.success({
                                 items: r,
                                 aggregates: aggregates,
-                            }];
+                            })];
                     case 3:
-                        err_2 = _c.sent();
-                        if (err_2.isForbiddenError)
+                        err_3 = _c.sent();
+                        if (err_3.isForbiddenError)
                             response.forbidden();
                         else
-                            response.error(err_2, this.repository.metadata);
+                            response.error(err_3, this.repository.metadata);
                         return [3 /*break*/, 4];
                     case 4: return [2 /*return*/];
                 }
@@ -253,7 +264,7 @@ var DataApi = /** @class */ (function () {
     };
     DataApi.prototype.count = function (response, request, body) {
         return tslib_1.__awaiter(this, void 0, void 0, function () {
-            var _a, _b, _c, _d, err_3;
+            var _a, _b, _c, _d, err_4;
             var _e;
             return tslib_1.__generator(this, function (_f) {
                 switch (_f.label) {
@@ -275,8 +286,8 @@ var DataApi = /** @class */ (function () {
                                 _e)]);
                         return [3 /*break*/, 5];
                     case 4:
-                        err_3 = _f.sent();
-                        response.error(err_3, this.repository.metadata);
+                        err_4 = _f.sent();
+                        response.error(err_4, this.repository.metadata);
                         return [3 /*break*/, 5];
                     case 5: return [2 /*return*/];
                 }
@@ -285,7 +296,7 @@ var DataApi = /** @class */ (function () {
     };
     DataApi.prototype.deleteMany = function (response, request, body) {
         return tslib_1.__awaiter(this, void 0, void 0, function () {
-            var deleted_1, where_1, err_4;
+            var deleted_1, where_1, err_5;
             var _this = this;
             return tslib_1.__generator(this, function (_a) {
                 switch (_a.label) {
@@ -347,8 +358,8 @@ var DataApi = /** @class */ (function () {
                             }); })];
                     case 2: return [2 /*return*/, _a.sent()];
                     case 3:
-                        err_4 = _a.sent();
-                        response.error(err_4, this.repository.metadata);
+                        err_5 = _a.sent();
+                        response.error(err_5, this.repository.metadata);
                         return [3 /*break*/, 4];
                     case 4: return [2 /*return*/];
                 }
@@ -635,7 +646,7 @@ var DataApi = /** @class */ (function () {
     };
     DataApi.prototype.getArray = function (response, request, body) {
         return tslib_1.__awaiter(this, void 0, void 0, function () {
-            var r, err_5;
+            var r, err_6;
             return tslib_1.__generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
@@ -652,11 +663,11 @@ var DataApi = /** @class */ (function () {
                         response.success(r);
                         return [3 /*break*/, 4];
                     case 3:
-                        err_5 = _a.sent();
-                        if (err_5.isForbiddenError)
-                            response.forbidden(err_5.message);
+                        err_6 = _a.sent();
+                        if (err_6.isForbiddenError)
+                            response.forbidden(err_6.message);
                         else
-                            response.error(err_5, this.repository.metadata);
+                            response.error(err_6, this.repository.metadata);
                         return [3 /*break*/, 4];
                     case 4: return [2 /*return*/];
                 }
@@ -665,7 +676,7 @@ var DataApi = /** @class */ (function () {
     };
     DataApi.prototype.liveQuery = function (response, request, body, serializeContext, queryChannel) {
         return tslib_1.__awaiter(this, void 0, void 0, function () {
-            var r, data, err_6;
+            var r, data, err_7;
             var _a;
             var _this = this;
             return tslib_1.__generator(this, function (_b) {
@@ -699,11 +710,11 @@ var DataApi = /** @class */ (function () {
                         response.success(r.r);
                         return [3 /*break*/, 6];
                     case 5:
-                        err_6 = _b.sent();
-                        if (err_6.isForbiddenError)
+                        err_7 = _b.sent();
+                        if (err_7.isForbiddenError)
                             response.forbidden();
                         else
-                            response.error(err_6, this.repository.metadata);
+                            response.error(err_7, this.repository.metadata);
                         return [3 /*break*/, 6];
                     case 6: return [2 /*return*/];
                 }
@@ -766,7 +777,7 @@ var DataApi = /** @class */ (function () {
     };
     DataApi.prototype.doOnId = function (response, id, what) {
         return tslib_1.__awaiter(this, void 0, void 0, function () {
-            var where, _a, _b, err_7;
+            var where, _a, _b, err_8;
             var _this = this;
             return tslib_1.__generator(this, function (_c) {
                 switch (_c.label) {
@@ -816,8 +827,8 @@ var DataApi = /** @class */ (function () {
                         _c.sent();
                         return [3 /*break*/, 6];
                     case 5:
-                        err_7 = _c.sent();
-                        response.error(err_7, this.repository.metadata);
+                        err_8 = _c.sent();
+                        response.error(err_8, this.repository.metadata);
                         return [3 /*break*/, 6];
                     case 6: return [2 /*return*/];
                 }
@@ -841,7 +852,7 @@ var DataApi = /** @class */ (function () {
     };
     DataApi.prototype.updateManyImplementation = function (response, request, body) {
         return tslib_1.__awaiter(this, void 0, void 0, function () {
-            var where_2, err_8;
+            var where_2, err_9;
             var _this = this;
             return tslib_1.__generator(this, function (_a) {
                 switch (_a.label) {
@@ -905,8 +916,8 @@ var DataApi = /** @class */ (function () {
                             }); })];
                     case 2: return [2 /*return*/, _a.sent()];
                     case 3:
-                        err_8 = _a.sent();
-                        response.error(err_8, this.repository.metadata);
+                        err_9 = _a.sent();
+                        response.error(err_9, this.repository.metadata);
                         return [3 /*break*/, 4];
                     case 4: return [2 /*return*/];
                 }

package/src/data-providers/sql-database.d.ts

@@ -1,7 +1,8 @@
-import type { DataProvider, EntityDataProvider, EntityDataProviderGroupByOptions } from '../data-interfaces.js';
+import type { DataProvider, EntityDataProvider, EntityDataProviderGroupByOptions, EntityDataProviderFindOptions } from '../data-interfaces.js';
 import type { HasWrapIdentifier, SqlCommand, SqlCommandFactory, SqlCommandWithParameters, SqlImplementation, SqlResult } from '../sql-command.js';
+import type { FieldMetadata } from '../column-interfaces.js';
 import type { CustomSqlFilterBuilderFunction, EntityDbNamesBase } from '../filter/filter-consumer-bridge-to-sql-request.js';
-import { type EntityFilter, type EntityMetadata } from '../remult3/remult3.js';
+import { type EntityFilter, type EntityMetadata, type FindOptions, type GroupByOptions, type GroupByResult, type MembersOnly, type NumericKeys } from '../remult3/remult3.js';
 import type { RepositoryOverloads } from '../remult3/RepositoryImplementation.js';
 import type { CanBuildMigrations, MigrationBuilder, MigrationCode } from '../../migrations/migration-types.js';
 /**
@@ -67,6 +68,24 @@ export declare class SqlDatabase implements DataProvider, HasWrapIdentifier, Can
      
      */
     static filterToRaw<entityType>(repo: RepositoryOverloads<entityType>, condition: EntityFilter<entityType>, sqlCommand?: SqlCommandWithParameters, dbNames?: EntityDbNamesBase, wrapIdentifier?: (name: string) => string): Promise<string>;
+    /**
+     * Builds the select that `repo.groupBy` would run, without running it - for a statement remult cannot run on its own, such as one `UNION ALL` over several databases.
+     * @returns `sql`, and `toResult`, which maps a result row (read by column alias) to the shape `groupBy` returns.
+     * @see [Building a select with remult](https://remult.dev/docs/running-sql-on-the-server#building-a-select-with-remult)
+     */
+    static groupByToRaw<entityType, groupByFields extends (keyof MembersOnly<entityType>)[] | undefined = undefined, sumFields extends NumericKeys<entityType>[] | undefined = undefined, averageFields extends NumericKeys<entityType>[] | undefined = undefined, minFields extends (keyof MembersOnly<entityType>)[] | undefined = undefined, maxFields extends (keyof MembersOnly<entityType>)[] | undefined = undefined, distinctCountFields extends (keyof MembersOnly<entityType>)[] | undefined = undefined>(repo: RepositoryOverloads<entityType>, options: GroupByOptions<entityType, groupByFields extends undefined ? never : groupByFields, sumFields extends undefined ? never : sumFields, averageFields extends undefined ? never : averageFields, minFields extends undefined ? never : minFields, maxFields extends undefined ? never : maxFields, distinctCountFields extends undefined ? never : distinctCountFields>, sql?: RawSelectOptions): Promise<{
+        sql: string;
+        toResult: (row: Record<string, any>) => GroupByResult<entityType, groupByFields extends undefined ? never : groupByFields, sumFields extends undefined ? never : sumFields, averageFields extends undefined ? never : averageFields, minFields extends undefined ? never : minFields, maxFields extends undefined ? never : maxFields, distinctCountFields extends undefined ? never : distinctCountFields>;
+    }>;
+    /**
+     * Builds the select that `repo.find` would run, without running it. Columns are aliased by field key; no default order is added, so the sql can be a branch of a `UNION`.
+     * @returns `sql`, and `toResult`, which maps a result row (read by column alias) to the fields' values.
+     * @see [Building a select with remult](https://remult.dev/docs/running-sql-on-the-server#building-a-select-with-remult)
+     */
+    static selectToRaw<entityType>(repo: RepositoryOverloads<entityType>, options?: FindOptions<entityType>, sql?: RawSelectOptions): Promise<{
+        sql: string;
+        toResult: (row: Record<string, any>) => Partial<MembersOnly<entityType>>;
+    }>;
     /**
      * `false` _(default)_ - No logging
      *
@@ -94,5 +113,30 @@ export declare class SqlDatabase implements DataProvider, HasWrapIdentifier, Can
     private createdEntities;
     end: () => Promise<void>;
 }
+/** Where a raw select is built: the command that collects its parameters, the names it addresses the table and columns by, and the dialect's paging syntax. */
+export interface RawSelectOptions {
+    sqlCommand?: SqlCommandWithParameters;
+    /** Replace `$entityName` here to address another database or an alias: `{ ...await dbNamesOf(Task), $entityName: '[other].dbo.tasks' }`. */
+    dbNames?: EntityDbNamesBase;
+    wrapIdentifier?: (name: string) => string;
+    /** Required only with `limit`: `(limit, offset) => 'limit 10 offset 20'`. */
+    limitSyntax?: (limit: number, offset: number) => string;
+}
 export declare function getRowAfterUpdate<entityType>(meta: EntityMetadata<entityType>, dataProvider: EntityDataProvider, data: any, id: any, operation: string): any;
+/** The select that `find` runs, and the mapping of one result row to field values. With `aliasColumns`, every column is aliased through `wrapIdentifier`, so a row can be read by alias as well as by position. */
+export declare function buildFindSql(entity: EntityMetadata, options: EntityDataProviderFindOptions | undefined, e: EntityDbNamesBase, r: SqlCommandWithParameters, orderByNullsFirst: boolean | undefined, limitSyntax: (limit: number, offset: number) => string, { aliasColumns, defaultOrderBy }?: {
+    aliasColumns?: boolean | undefined;
+    defaultOrderBy?: boolean | undefined;
+}): Promise<{
+    select: string;
+    colKeys: FieldMetadata<unknown, unknown>[];
+    /** `valueAt` reads one column of a result row, by its position in the select or by its alias (the field key). */
+    toResult(valueAt: (indexInSelect: number, alias: string) => any): any;
+}>;
 export declare function groupByImpl(options: EntityDataProviderGroupByOptions | undefined, e: EntityDbNamesBase, r: SqlCommand, orderByNullFirst: boolean | undefined, limitSyntax: (limit: number, offset: number) => string): Promise<any[]>;
+/** The select that `groupBy` runs, and the mapping of one result row back to a `GroupByResult`. Every column is aliased through `wrapIdentifier`, so a row can be read by alias as well as by position. */
+export declare function buildGroupBySql(options: EntityDataProviderGroupByOptions | undefined, e: EntityDbNamesBase, r: SqlCommandWithParameters, orderByNullFirst: boolean | undefined, limitSyntax: (limit: number, offset: number) => string): Promise<{
+    select: string;
+    /** `valueAt` reads one column of a result row, by its position in the select or by its alias. */
+    toResult(valueAt: (indexInSelect: number, alias: string) => any): any;
+}>;