@remnawave/backend-contract 2.9.21 → 2.9.23

package/build/backend/api/controllers/system.d.ts

@@ -5,6 +5,7 @@ export declare const SYSTEM_ROUTES: {
         readonly BANDWIDTH_STATS: "stats/bandwidth";
         readonly NODES_STATS: "stats/nodes";
         readonly RECAP: "stats/recap";
+        readonly DIGEST: "stats/digest";
         readonly NODES_METRICS: "nodes/metrics";
         readonly HTTP: "stats/http";
     };

package/build/backend/api/controllers/system.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../../../api/controllers/system.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,EAAG,QAAiB,CAAC;AAEnD,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;CAiBhB,CAAC"}
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../../../api/controllers/system.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,EAAG,QAAiB,CAAC;AAEnD,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;CAkBhB,CAAC"}

package/build/backend/api/controllers/system.js

@@ -8,6 +8,7 @@ exports.SYSTEM_ROUTES = {
         BANDWIDTH_STATS: 'stats/bandwidth',
         NODES_STATS: 'stats/nodes',
         RECAP: 'stats/recap',
+        DIGEST: 'stats/digest',
         NODES_METRICS: 'nodes/metrics',
         HTTP: 'stats/http',
     },

package/build/backend/api/routes.d.ts

@@ -131,6 +131,7 @@ export declare const REST_API: {
             readonly NODES_STATS: "/api/system/stats/nodes";
             readonly NODES_METRICS: "/api/system/nodes/metrics";
             readonly RECAP: "/api/system/stats/recap";
+            readonly DIGEST: "/api/system/stats/digest";
             readonly HTTP: "/api/system/stats/http";
         };
         readonly TOOLS: {

package/build/backend/api/routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../api/routes.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,IAAI,EAAG,MAAe,CAAC;AACpC,eAAO,MAAM,YAAY,EAAG,UAAmB,CAAC;AAChD,eAAO,MAAM,WAAW,EAAG,SAAkB,CAAC;AAE9C,eAAO,MAAM,kBAAkB,EAAG,gBAAyB,CAAC;AAC5D,eAAO,MAAM,cAAc,EAAG,uBAAgC,CAAC;AAC/D,eAAO,MAAM,YAAY,EAAG,wBAAiC,CAAC;AAC9D,eAAO,MAAM,WAAW,EAAG,uBAAgC,CAAC;AAE5D,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;gCAyBE,MAAM;;;;;;;;;;;qCAcD,MAAM;;gCAGX,MAAM;;;;;oCAOF,MAAM;qCAIL,MAAM;qCAIN,MAAM;;2CAKA,MAAM;;;;;;;;;;;;;;kCAkBf,MAAM;qCAGH,MAAM;4CAEC,MAAM;wDAEM,MAAM;;uCAMvB,MAAM;sCAIP,MAAM;6CAIC,MAAM;mDAIA,MAAM;sDAIH,MAAM;;;6CAMf,MAAM;0CAIT,MAAM;;;;;;;;;;;;;;;;;;;;;;kCAyBd,MAAM;uCAED,MAAM;;;;;;qCASR,MAAM;gCAEX,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BAoCT,MAAM;;gCAKH,MAAM;;;;;;;;;;;;;;iDAiBW,MAAM;;;;;;;;;0CAYb,MAAM;6CAIH,MAAM;iDAIF,MAAM;kCAIrB,MAAM;;;6CAMK,MAAM;;0DAKO,MAAM;;;;;;qCAS3B,MAAM;gCAIX,MAAM;sDAIgB,MAAM;6DAIC,MAAM;;;;;;;;;;qCAa9B,MAAM;gCAIX,MAAM;0CAII,MAAM;;uCAKT,MAAM;0CAEH,MAAM;4CAEJ,MAAM;+CAEH,MAAM;;;;;;;;;;yCAWZ,MAAM;8CAED,MAAM;;;;6CAMP,MAAM;;;gDAKH,MAAM;;;;;;;;;;;;;;;;qCAiBjB,MAAM;gCAIX,MAAM;;uCAKC,MAAM;0CAEH,MAAM;;;;;;;;;;;6BAYnB,MAAM;;;gCAIH,MAAM;;;;;;;;6BAST,MAAM;;;gCAIH,MAAM;;;;;;;;;;;;;;;;;uCAkBC,MAAM;;;;;yCAMJ,MAAM;;;uCAIR,MAAM;6CAEA,MAAM,UAAU,MAAM;;;;+CAKpB,MAAM;qDAEA,MAAM;6CAEd,MAAM;qDAEE,MAAM;;;;;iCAM1B,MAAM;oCAEH,MAAM;;;mCAIP,MAAM;sCAEH,MAAM;;;CAIzB,CAAC"}
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../api/routes.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,IAAI,EAAG,MAAe,CAAC;AACpC,eAAO,MAAM,YAAY,EAAG,UAAmB,CAAC;AAChD,eAAO,MAAM,WAAW,EAAG,SAAkB,CAAC;AAE9C,eAAO,MAAM,kBAAkB,EAAG,gBAAyB,CAAC;AAC5D,eAAO,MAAM,cAAc,EAAG,uBAAgC,CAAC;AAC/D,eAAO,MAAM,YAAY,EAAG,wBAAiC,CAAC;AAC9D,eAAO,MAAM,WAAW,EAAG,uBAAgC,CAAC;AAE5D,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;gCAyBE,MAAM;;;;;;;;;;;qCAcD,MAAM;;gCAGX,MAAM;;;;;oCAOF,MAAM;qCAIL,MAAM;qCAIN,MAAM;;2CAKA,MAAM;;;;;;;;;;;;;;kCAkBf,MAAM;qCAGH,MAAM;4CAEC,MAAM;wDAEM,MAAM;;uCAMvB,MAAM;sCAIP,MAAM;6CAIC,MAAM;mDAIA,MAAM;sDAIH,MAAM;;;6CAMf,MAAM;0CAIT,MAAM;;;;;;;;;;;;;;;;;;;;;;kCAyBd,MAAM;uCAED,MAAM;;;;;;qCASR,MAAM;gCAEX,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BAqCT,MAAM;;gCAKH,MAAM;;;;;;;;;;;;;;iDAiBW,MAAM;;;;;;;;;0CAYb,MAAM;6CAIH,MAAM;iDAIF,MAAM;kCAIrB,MAAM;;;6CAMK,MAAM;;0DAKO,MAAM;;;;;;qCAS3B,MAAM;gCAIX,MAAM;sDAIgB,MAAM;6DAIC,MAAM;;;;;;;;;;qCAa9B,MAAM;gCAIX,MAAM;0CAII,MAAM;;uCAKT,MAAM;0CAEH,MAAM;4CAEJ,MAAM;+CAEH,MAAM;;;;;;;;;;yCAWZ,MAAM;8CAED,MAAM;;;;6CAMP,MAAM;;;gDAKH,MAAM;;;;;;;;;;;;;;;;qCAiBjB,MAAM;gCAIX,MAAM;;uCAKC,MAAM;0CAEH,MAAM;;;;;;;;;;;6BAYnB,MAAM;;;gCAIH,MAAM;;;;;;;;6BAST,MAAM;;;gCAIH,MAAM;;;;;;;;;;;;;;;;;uCAkBC,MAAM;;;;;yCAMJ,MAAM;;;uCAIR,MAAM;6CAEA,MAAM,UAAU,MAAM;;;;+CAKpB,MAAM;qDAEA,MAAM;6CAEd,MAAM;qDAEE,MAAM;;;;;iCAM1B,MAAM;oCAEH,MAAM;;;mCAIP,MAAM;sCAEH,MAAM;;;CAIzB,CAAC"}

package/build/backend/api/routes.js

@@ -168,6 +168,7 @@ exports.REST_API = {
             NODES_STATS: `${exports.ROOT}/${CONTROLLERS.SYSTEM_CONTROLLER}/${CONTROLLERS.SYSTEM_ROUTES.STATS.NODES_STATS}`,
             NODES_METRICS: `${exports.ROOT}/${CONTROLLERS.SYSTEM_CONTROLLER}/${CONTROLLERS.SYSTEM_ROUTES.STATS.NODES_METRICS}`,
             RECAP: `${exports.ROOT}/${CONTROLLERS.SYSTEM_CONTROLLER}/${CONTROLLERS.SYSTEM_ROUTES.STATS.RECAP}`,
+            DIGEST: `${exports.ROOT}/${CONTROLLERS.SYSTEM_CONTROLLER}/${CONTROLLERS.SYSTEM_ROUTES.STATS.DIGEST}`,
             HTTP: `${exports.ROOT}/${CONTROLLERS.SYSTEM_CONTROLLER}/${CONTROLLERS.SYSTEM_ROUTES.STATS.HTTP}`,
         },
         TOOLS: {

package/build/backend/commands/remnawave-settings/get-remnawave-settings.command.d.ts

@@ -21,6 +21,7 @@ export declare namespace GetRemnawaveSettingsCommand {
                     enabled: z.ZodBoolean;
                     clientId: z.ZodNullable<z.ZodString>;
                     clientSecret: z.ZodNullable<z.ZodString>;
+                    frontendDomain: z.ZodNullable<z.ZodString>;
                     plainDomain: z.ZodNullable<z.ZodString>;
                     allowedEmails: z.ZodArray<z.ZodString>;
                 }, z.core.$strip>;

package/build/backend/commands/remnawave-settings/get-remnawave-settings.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-remnawave-settings.command.d.ts","sourceRoot":"","sources":["../../../../commands/remnawave-settings/get-remnawave-settings.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,yBAAiB,2BAA2B,CAAC;IAClC,MAAM,GAAG,4BAAmC,CAAC;IAC7C,MAAM,OAAO,4BAAM,CAAC;IAEpB,MAAM,eAAe,2CAK3B,CAAC;IAEK,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAEzB,CAAC;IAEH,KAAY,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;CACzD"}
+{"version":3,"file":"get-remnawave-settings.command.d.ts","sourceRoot":"","sources":["../../../../commands/remnawave-settings/get-remnawave-settings.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,yBAAiB,2BAA2B,CAAC;IAClC,MAAM,GAAG,4BAAmC,CAAC;IAC7C,MAAM,OAAO,4BAAM,CAAC;IAEpB,MAAM,eAAe,2CAK3B,CAAC;IAEK,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAEzB,CAAC;IAEH,KAAY,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;CACzD"}

package/build/backend/commands/remnawave-settings/update-remnawave-settings.command.d.ts

@@ -20,6 +20,7 @@ export declare namespace UpdateRemnawaveSettingsCommand {
                 enabled: z.ZodBoolean;
                 clientId: z.ZodNullable<z.ZodString>;
                 clientSecret: z.ZodNullable<z.ZodString>;
+                frontendDomain: z.ZodNullable<z.ZodString>;
                 plainDomain: z.ZodNullable<z.ZodString>;
                 allowedEmails: z.ZodArray<z.ZodString>;
             }, z.core.$strip>;
@@ -82,6 +83,7 @@ export declare namespace UpdateRemnawaveSettingsCommand {
                     enabled: z.ZodBoolean;
                     clientId: z.ZodNullable<z.ZodString>;
                     clientSecret: z.ZodNullable<z.ZodString>;
+                    frontendDomain: z.ZodNullable<z.ZodString>;
                     plainDomain: z.ZodNullable<z.ZodString>;
                     allowedEmails: z.ZodArray<z.ZodString>;
                 }, z.core.$strip>;

package/build/backend/commands/remnawave-settings/update-remnawave-settings.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-remnawave-settings.command.d.ts","sourceRoot":"","sources":["../../../../commands/remnawave-settings/update-remnawave-settings.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB,yBAAiB,8BAA8B,CAAC;IACrC,MAAM,GAAG,4BAAsC,CAAC;IAChD,MAAM,OAAO,4BAAM,CAAC;IAEpB,MAAM,eAAe,2CAK3B,CAAC;IAEK,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAK5B,CAAC;IAEI,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAEzB,CAAC;IAEH,KAAY,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;IAC5D,KAAY,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;CACzD"}
+{"version":3,"file":"update-remnawave-settings.command.d.ts","sourceRoot":"","sources":["../../../../commands/remnawave-settings/update-remnawave-settings.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB,yBAAiB,8BAA8B,CAAC;IACrC,MAAM,GAAG,4BAAsC,CAAC;IAChD,MAAM,OAAO,4BAAM,CAAC;IAEpB,MAAM,eAAe,2CAK3B,CAAC;IAEK,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAK5B,CAAC;IAEI,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAEzB,CAAC;IAEH,KAAY,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;IAC5D,KAAY,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;CACzD"}

package/build/backend/commands/system/get-stats-digest.command.d.ts

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+export declare namespace GetStatsDigestCommand {
+    const url: "/api/system/stats/digest";
+    const TSQ_url: "/api/system/stats/digest";
+    const endpointDetails: import("../../constants").EndpointDetails;
+    const RequestQuerySchema: z.ZodObject<{
+        start: z.ZodISODateTime;
+        end: z.ZodISODateTime;
+    }, z.core.$strip>;
+    const ResponseSchema: z.ZodObject<{
+        response: z.ZodObject<{
+            users: z.ZodObject<{
+                createdCount: z.ZodNumber;
+                expiredCount: z.ZodNumber;
+            }, z.core.$strip>;
+            traffic: z.ZodObject<{
+                totalBytes: z.ZodString;
+                byUsersCreatedInRangeBytes: z.ZodString;
+            }, z.core.$strip>;
+            hwidDevices: z.ZodObject<{
+                createdCount: z.ZodNumber;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+    type RequestQuery = z.infer<typeof RequestQuerySchema>;
+    type Response = z.infer<typeof ResponseSchema>;
+}
+//# sourceMappingURL=get-stats-digest.command.d.ts.map

package/build/backend/commands/system/get-stats-digest.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-stats-digest.command.d.ts","sourceRoot":"","sources":["../../../../commands/system/get-stats-digest.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,yBAAiB,qBAAqB,CAAC;IAC5B,MAAM,GAAG,4BAA+B,CAAC;IACzC,MAAM,OAAO,4BAAM,CAAC;IAEpB,MAAM,eAAe,2CAM3B,CAAC;IAEK,MAAM,kBAAkB;;;qBAW7B,CAAC;IAEI,MAAM,cAAc;;;;;;;;;;;;;;qBAczB,CAAC;IAEH,KAAY,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;IAC9D,KAAY,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;CACzD"}

package/build/backend/commands/system/get-stats-digest.command.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetStatsDigestCommand = void 0;
+const zod_1 = require("zod");
+const api_1 = require("../../api");
+const constants_1 = require("../../constants");
+var GetStatsDigestCommand;
+(function (GetStatsDigestCommand) {
+    GetStatsDigestCommand.url = api_1.REST_API.SYSTEM.STATS.DIGEST;
+    GetStatsDigestCommand.TSQ_url = GetStatsDigestCommand.url;
+    GetStatsDigestCommand.endpointDetails = (0, constants_1.getEndpointDetails)(api_1.SYSTEM_ROUTES.STATS.DIGEST, 'get', 'Get Stats Digest', { scope: 'digest', kind: 'read' }, 'Aggregated statistics for a datetime range [start, end): created and expired users, total traffic, traffic spent by users created within the range and new HWID devices. Per-user traffic history is stored with daily granularity (UTC), so the "traffic by new users" metric snaps to whole days at the range edges.');
+    GetStatsDigestCommand.RequestQuerySchema = zod_1.z.object({
+        start: zod_1.z.iso
+            .datetime({ offset: true })
+            .describe('Start of the range, ISO 8601 datetime with timezone (e.g. 2026-07-15T00:00:00Z). Inclusive.'),
+        end: zod_1.z.iso
+            .datetime({ offset: true })
+            .describe('End of the range, ISO 8601 datetime with timezone (e.g. 2026-07-16T00:00:00Z). Exclusive.'),
+    });
+    GetStatsDigestCommand.ResponseSchema = zod_1.z.object({
+        response: zod_1.z.object({
+            users: zod_1.z.object({
+                createdCount: zod_1.z.number(),
+                expiredCount: zod_1.z.number(),
+            }),
+            traffic: zod_1.z.object({
+                totalBytes: zod_1.z.string(),
+                byUsersCreatedInRangeBytes: zod_1.z.string(),
+            }),
+            hwidDevices: zod_1.z.object({
+                createdCount: zod_1.z.number(),
+            }),
+        }),
+    });
+})(GetStatsDigestCommand || (exports.GetStatsDigestCommand = GetStatsDigestCommand = {}));

package/build/backend/commands/system/index.d.ts

@@ -3,6 +3,7 @@ export * from './get-metadata.command';
 export * from './get-nodes-metrics.command';
 export * from './get-nodes-statistics';
 export * from './get-recap.command';
+export * from './get-stats-digest.command';
 export * from './get-remnawave-health.command';
 export * from './get-stats.command';
 export * from './testers';

package/build/backend/commands/system/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../commands/system/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qBAAqB,CAAC;AACpC,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../commands/system/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qBAAqB,CAAC;AACpC,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,0BAA0B,CAAC"}

package/build/backend/commands/system/index.js

@@ -19,6 +19,7 @@ __exportStar(require("./get-metadata.command"), exports);
 __exportStar(require("./get-nodes-metrics.command"), exports);
 __exportStar(require("./get-nodes-statistics"), exports);
 __exportStar(require("./get-recap.command"), exports);
+__exportStar(require("./get-stats-digest.command"), exports);
 __exportStar(require("./get-remnawave-health.command"), exports);
 __exportStar(require("./get-stats.command"), exports);
 __exportStar(require("./testers"), exports);

package/build/backend/constants/errors/errors.d.ts

@@ -1199,5 +1199,15 @@ export declare const ERRORS: {
         readonly message: "Remove many users from internal squad error";
         readonly httpCode: 500;
     };
+    readonly GET_STATS_DIGEST_INVALID_RANGE: {
+        readonly code: "A235";
+        readonly message: "Start date must be before or equal to end date";
+        readonly httpCode: 400;
+    };
+    readonly GET_STATS_DIGEST_ERROR: {
+        readonly code: "A236";
+        readonly message: "Get stats digest error";
+        readonly httpCode: 500;
+    };
 };
 //# sourceMappingURL=errors.d.ts.map

package/build/backend/constants/errors/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../constants/errors/errors.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wCAwJY,MAAM;;;;;;;;;;wCAUN,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wCA4IN,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wCAsqBN,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wCA0KN,MAAM;;;;;;;;;;;;;;;;;;;;;CAqB3B,CAAC"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../constants/errors/errors.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wCAwJY,MAAM;;;;;;;;;;wCAUN,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wCA4IN,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wCAsqBN,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wCA0KN,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+B3B,CAAC"}

package/build/backend/constants/errors/errors.js

@@ -1170,4 +1170,14 @@ exports.ERRORS = {
         message: 'Remove many users from internal squad error',
         httpCode: 500,
     },
+    GET_STATS_DIGEST_INVALID_RANGE: {
+        code: 'A235',
+        message: 'Start date must be before or equal to end date',
+        httpCode: 400,
+    },
+    GET_STATS_DIGEST_ERROR: {
+        code: 'A236',
+        message: 'Get stats digest error',
+        httpCode: 500,
+    },
 };

package/build/backend/models/remnawave-settings/oauth2-settings.schema.d.ts

@@ -10,6 +10,7 @@ export declare const Oauth2SettingsSchema: z.ZodObject<{
         enabled: z.ZodBoolean;
         clientId: z.ZodNullable<z.ZodString>;
         clientSecret: z.ZodNullable<z.ZodString>;
+        frontendDomain: z.ZodNullable<z.ZodString>;
         plainDomain: z.ZodNullable<z.ZodString>;
         allowedEmails: z.ZodArray<z.ZodString>;
     }, z.core.$strip>;

package/build/backend/models/remnawave-settings/oauth2-settings.schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"oauth2-settings.schema.d.ts","sourceRoot":"","sources":["../../../../models/remnawave-settings/oauth2-settings.schema.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA+J/B,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}
+{"version":3,"file":"oauth2-settings.schema.d.ts","sourceRoot":"","sources":["../../../../models/remnawave-settings/oauth2-settings.schema.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA+K/B,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/build/backend/models/remnawave-settings/oauth2-settings.schema.js

@@ -16,6 +16,15 @@ exports.Oauth2SettingsSchema = zod_1.default.object({
         enabled: zod_1.default.boolean(),
         clientId: zod_1.default.nullable(zod_1.default.string()),
         clientSecret: zod_1.default.nullable(zod_1.default.string()),
+        frontendDomain: zod_1.default.nullable(zod_1.default.string().refine((val) => {
+            const fqdnRegex = /(?=^.{4,253}$)(^((?!-)[a-zA-Z0-9-]{0,62}[a-zA-Z0-9]\.)+[a-zA-Z]{2,63}$)/;
+            if (fqdnRegex.test(val)) {
+                return true;
+            }
+            return false;
+        }, {
+            message: 'Must be a valid fully qualified domain name (FQDN), e.g. "docs.rw"',
+        })),
         plainDomain: zod_1.default.nullable(zod_1.default.string().refine((val) => {
             const fqdnRegex = /(?=^.{4,253}$)(^((?!-)[a-zA-Z0-9-]{0,62}[a-zA-Z0-9]\.)+[a-zA-Z]{2,63}$)/;
             if (fqdnRegex.test(val)) {

package/build/backend/models/remnawave-settings/remnawave-settings.schema.d.ts

@@ -16,6 +16,7 @@ export declare const RemnawaveSettingsSchema: z.ZodObject<{
             enabled: z.ZodBoolean;
             clientId: z.ZodNullable<z.ZodString>;
             clientSecret: z.ZodNullable<z.ZodString>;
+            frontendDomain: z.ZodNullable<z.ZodString>;
             plainDomain: z.ZodNullable<z.ZodString>;
             allowedEmails: z.ZodArray<z.ZodString>;
         }, z.core.$strip>;

package/build/backend/models/remnawave-settings/remnawave-settings.schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"remnawave-settings.schema.d.ts","sourceRoot":"","sources":["../../../../models/remnawave-settings/remnawave-settings.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAKlC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}
+{"version":3,"file":"remnawave-settings.schema.d.ts","sourceRoot":"","sources":["../../../../models/remnawave-settings/remnawave-settings.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAKlC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}

package/build/frontend/api/controllers/system.js

@@ -8,6 +8,7 @@ exports.SYSTEM_ROUTES = {
         BANDWIDTH_STATS: 'stats/bandwidth',
         NODES_STATS: 'stats/nodes',
         RECAP: 'stats/recap',
+        DIGEST: 'stats/digest',
         NODES_METRICS: 'nodes/metrics',
         HTTP: 'stats/http',
     },

package/build/frontend/api/routes.js

@@ -168,6 +168,7 @@ exports.REST_API = {
             NODES_STATS: `${exports.ROOT}/${CONTROLLERS.SYSTEM_CONTROLLER}/${CONTROLLERS.SYSTEM_ROUTES.STATS.NODES_STATS}`,
             NODES_METRICS: `${exports.ROOT}/${CONTROLLERS.SYSTEM_CONTROLLER}/${CONTROLLERS.SYSTEM_ROUTES.STATS.NODES_METRICS}`,
             RECAP: `${exports.ROOT}/${CONTROLLERS.SYSTEM_CONTROLLER}/${CONTROLLERS.SYSTEM_ROUTES.STATS.RECAP}`,
+            DIGEST: `${exports.ROOT}/${CONTROLLERS.SYSTEM_CONTROLLER}/${CONTROLLERS.SYSTEM_ROUTES.STATS.DIGEST}`,
             HTTP: `${exports.ROOT}/${CONTROLLERS.SYSTEM_CONTROLLER}/${CONTROLLERS.SYSTEM_ROUTES.STATS.HTTP}`,
         },
         TOOLS: {

package/build/frontend/commands/system/get-stats-digest.command.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetStatsDigestCommand = void 0;
+const zod_1 = require("zod");
+const api_1 = require("../../api");
+const constants_1 = require("../../constants");
+var GetStatsDigestCommand;
+(function (GetStatsDigestCommand) {
+    GetStatsDigestCommand.url = api_1.REST_API.SYSTEM.STATS.DIGEST;
+    GetStatsDigestCommand.TSQ_url = GetStatsDigestCommand.url;
+    GetStatsDigestCommand.endpointDetails = (0, constants_1.getEndpointDetails)(api_1.SYSTEM_ROUTES.STATS.DIGEST, 'get', 'Get Stats Digest', { scope: 'digest', kind: 'read' }, 'Aggregated statistics for a datetime range [start, end): created and expired users, total traffic, traffic spent by users created within the range and new HWID devices. Per-user traffic history is stored with daily granularity (UTC), so the "traffic by new users" metric snaps to whole days at the range edges.');
+    GetStatsDigestCommand.RequestQuerySchema = zod_1.z.object({
+        start: zod_1.z.iso
+            .datetime({ offset: true })
+            .describe('Start of the range, ISO 8601 datetime with timezone (e.g. 2026-07-15T00:00:00Z). Inclusive.'),
+        end: zod_1.z.iso
+            .datetime({ offset: true })
+            .describe('End of the range, ISO 8601 datetime with timezone (e.g. 2026-07-16T00:00:00Z). Exclusive.'),
+    });
+    GetStatsDigestCommand.ResponseSchema = zod_1.z.object({
+        response: zod_1.z.object({
+            users: zod_1.z.object({
+                createdCount: zod_1.z.number(),
+                expiredCount: zod_1.z.number(),
+            }),
+            traffic: zod_1.z.object({
+                totalBytes: zod_1.z.string(),
+                byUsersCreatedInRangeBytes: zod_1.z.string(),
+            }),
+            hwidDevices: zod_1.z.object({
+                createdCount: zod_1.z.number(),
+            }),
+        }),
+    });
+})(GetStatsDigestCommand || (exports.GetStatsDigestCommand = GetStatsDigestCommand = {}));

package/build/frontend/commands/system/index.js

@@ -19,6 +19,7 @@ __exportStar(require("./get-metadata.command"), exports);
 __exportStar(require("./get-nodes-metrics.command"), exports);
 __exportStar(require("./get-nodes-statistics"), exports);
 __exportStar(require("./get-recap.command"), exports);
+__exportStar(require("./get-stats-digest.command"), exports);
 __exportStar(require("./get-remnawave-health.command"), exports);
 __exportStar(require("./get-stats.command"), exports);
 __exportStar(require("./testers"), exports);

package/build/frontend/constants/errors/errors.js

@@ -1170,4 +1170,14 @@ exports.ERRORS = {
         message: 'Remove many users from internal squad error',
         httpCode: 500,
     },
+    GET_STATS_DIGEST_INVALID_RANGE: {
+        code: 'A235',
+        message: 'Start date must be before or equal to end date',
+        httpCode: 400,
+    },
+    GET_STATS_DIGEST_ERROR: {
+        code: 'A236',
+        message: 'Get stats digest error',
+        httpCode: 500,
+    },
 };

package/build/frontend/models/remnawave-settings/oauth2-settings.schema.js

@@ -16,6 +16,15 @@ exports.Oauth2SettingsSchema = zod_1.default.object({
         enabled: zod_1.default.boolean(),
         clientId: zod_1.default.nullable(zod_1.default.string()),
         clientSecret: zod_1.default.nullable(zod_1.default.string()),
+        frontendDomain: zod_1.default.nullable(zod_1.default.string().refine((val) => {
+            const fqdnRegex = /(?=^.{4,253}$)(^((?!-)[a-zA-Z0-9-]{0,62}[a-zA-Z0-9]\.)+[a-zA-Z]{2,63}$)/;
+            if (fqdnRegex.test(val)) {
+                return true;
+            }
+            return false;
+        }, {
+            message: 'Must be a valid fully qualified domain name (FQDN), e.g. "docs.rw"',
+        })),
         plainDomain: zod_1.default.nullable(zod_1.default.string().refine((val) => {
             const fqdnRegex = /(?=^.{4,253}$)(^((?!-)[a-zA-Z0-9-]{0,62}[a-zA-Z0-9]\.)+[a-zA-Z]{2,63}$)/;
             if (fqdnRegex.test(val)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remnawave/backend-contract",
-  "version": "2.9.21",
+  "version": "2.9.23",
   "description": "A contract library for Remnawave Backend. It can be used in backend and frontend.",
   "keywords": [],
   "homepage": "https://github.com/remnawave",