@carlonicora/nestjs-neo4jsonapi 1.117.0 → 1.119.0

package/dist/foundations/tokenusage/controllers/tokenusage.admin.controller.d.ts

@@ -0,0 +1,27 @@
+import { FastifyReply } from "fastify";
+import { TokenUsageAdminService } from "../services/tokenusage.admin.service";
+/**
+ * Platform-wide token-usage reporting. Every route is administrator-only:
+ * JwtAuthGuard._validateRoles enforces @Roles and always admits the
+ * Administrator role, so a non-administrator receives 401.
+ *
+ * Mounted at /tokenusages/administration/* — no overlap with the consuming
+ * app's own /tokenusages, /tokenusages/summary and /tokenusages/aggregated
+ * routes, so importing TokenUsageModule cannot duplicate a Fastify route.
+ *
+ * Enum-valued query params are validated against a closed allowlist here rather
+ * than in a DTO: DTOs are body validation for POST/PUT/PATCH, and GET filters
+ * use bare @Query() params. The allowlist matters — the repository interpolates
+ * granularity and dimension into Cypher (they select a clause, they are not
+ * values), so an unvalidated string would be an injection vector.
+ */
+export declare class TokenUsageAdminController {
+    private readonly service;
+    constructor(service: TokenUsageAdminService);
+    getSummary(reply: FastifyReply, from?: string, to?: string, companyId?: string): Promise<void>;
+    getTimeline(reply: FastifyReply, from?: string, to?: string, granularity?: string, stackBy?: string, companyId?: string): Promise<void>;
+    getBreakdown(reply: FastifyReply, from?: string, to?: string, dimension?: string, scope?: string, companyId?: string, limit?: string): Promise<void>;
+    private _oneOf;
+    private _range;
+}
+//# sourceMappingURL=tokenusage.admin.controller.d.ts.map

package/dist/foundations/tokenusage/controllers/tokenusage.admin.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenusage.admin.controller.d.ts","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/controllers/tokenusage.admin.controller.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAKvC,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAU9E;;;;;;;;;;;;;;GAcG;AACH,qBAEa,yBAAyB;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,sBAAsB;IAItD,UAAU,CACP,KAAK,EAAE,YAAY,EACX,IAAI,CAAC,EAAE,MAAM,EACf,EAAE,CAAC,EAAE,MAAM,EACJ,SAAS,CAAC,EAAE,MAAM;IAQlC,WAAW,CACR,KAAK,EAAE,YAAY,EACX,IAAI,CAAC,EAAE,MAAM,EACf,EAAE,CAAC,EAAE,MAAM,EACF,WAAW,CAAC,EAAE,MAAM,EACxB,OAAO,CAAC,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM;IAelC,YAAY,CACT,KAAK,EAAE,YAAY,EACX,IAAI,CAAC,EAAE,MAAM,EACf,EAAE,CAAC,EAAE,MAAM,EACJ,SAAS,CAAC,EAAE,MAAM,EACtB,KAAK,CAAC,EAAE,MAAM,EACV,SAAS,CAAC,EAAE,MAAM,EACtB,KAAK,CAAC,EAAE,MAAM;IAkBhC,OAAO,CAAC,MAAM;IAOd,OAAO,CAAC,MAAM;CAWf"}

package/dist/foundations/tokenusage/controllers/tokenusage.admin.controller.js

@@ -0,0 +1,136 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokenUsageAdminController = void 0;
+const common_1 = require("@nestjs/common");
+const system_roles_1 = require("../../../common/constants/system.roles");
+const roles_decorator_1 = require("../../../common/decorators/roles.decorator");
+const jwt_auth_guard_1 = require("../../../common/guards/jwt.auth.guard");
+const tokenusage_meta_1 = require("../entities/tokenusage.meta");
+const tokenusage_admin_service_1 = require("../services/tokenusage.admin.service");
+const GRANULARITIES = ["day", "week", "month"];
+const STACK_BY = ["scope", "type", "company"];
+const DIMENSIONS = ["company", "user", "operation"];
+const SCOPES = ["customer", "platform"];
+const DEFAULT_WINDOW_DAYS = 30;
+const ONE_DAY_MS = 24 * 60 * 60 * 1000;
+/**
+ * Platform-wide token-usage reporting. Every route is administrator-only:
+ * JwtAuthGuard._validateRoles enforces @Roles and always admits the
+ * Administrator role, so a non-administrator receives 401.
+ *
+ * Mounted at /tokenusages/administration/* — no overlap with the consuming
+ * app's own /tokenusages, /tokenusages/summary and /tokenusages/aggregated
+ * routes, so importing TokenUsageModule cannot duplicate a Fastify route.
+ *
+ * Enum-valued query params are validated against a closed allowlist here rather
+ * than in a DTO: DTOs are body validation for POST/PUT/PATCH, and GET filters
+ * use bare @Query() params. The allowlist matters — the repository interpolates
+ * granularity and dimension into Cypher (they select a clause, they are not
+ * values), so an unvalidated string would be an injection vector.
+ */
+let TokenUsageAdminController = class TokenUsageAdminController {
+    constructor(service) {
+        this.service = service;
+    }
+    async getSummary(reply, from, to, companyId) {
+        const range = this._range(from, to);
+        reply.send(await this.service.getSummary({ ...range, companyId }));
+    }
+    async getTimeline(reply, from, to, granularity, stackBy, companyId) {
+        const range = this._range(from, to);
+        reply.send(await this.service.getTimeline({
+            ...range,
+            granularity: this._oneOf(granularity, GRANULARITIES, "day"),
+            stackBy: this._oneOf(stackBy, STACK_BY, "scope"),
+            companyId,
+        }));
+    }
+    async getBreakdown(reply, from, to, dimension, scope, companyId, limit) {
+        const range = this._range(from, to);
+        const parsedLimit = limit === undefined ? 10 : Number(limit);
+        if (!Number.isInteger(parsedLimit) || parsedLimit < 1 || parsedLimit > 100)
+            throw new common_1.BadRequestException("limit must be an integer between 1 and 100");
+        reply.send(await this.service.getBreakdown({
+            ...range,
+            dimension: this._oneOf(dimension, DIMENSIONS, "company"),
+            scope: this._oneOf(scope, SCOPES, "customer"),
+            companyId,
+            limit: parsedLimit,
+        }));
+    }
+    _oneOf(value, allowed, fallback) {
+        if (value === undefined)
+            return fallback;
+        if (!allowed.includes(value))
+            throw new common_1.BadRequestException(`Expected one of ${allowed.join(", ")}, received "${value}"`);
+        return value;
+    }
+    _range(from, to) {
+        const toDate = to ? new Date(to) : new Date();
+        if (Number.isNaN(toDate.getTime()))
+            throw new common_1.BadRequestException("`to` is not a valid date");
+        const fromDate = from ? new Date(from) : new Date(toDate.getTime() - DEFAULT_WINDOW_DAYS * ONE_DAY_MS);
+        if (Number.isNaN(fromDate.getTime()))
+            throw new common_1.BadRequestException("`from` is not a valid date");
+        if (fromDate > toDate)
+            throw new common_1.BadRequestException("`from` must not be later than `to`");
+        return { from: fromDate.toISOString(), to: toDate.toISOString() };
+    }
+};
+exports.TokenUsageAdminController = TokenUsageAdminController;
+__decorate([
+    (0, common_1.Get)(`${tokenusage_meta_1.tokenUsageMeta.endpoint}/administration/summary`),
+    (0, roles_decorator_1.Roles)(system_roles_1.SystemRoles.Administrator),
+    __param(0, (0, common_1.Res)()),
+    __param(1, (0, common_1.Query)("from")),
+    __param(2, (0, common_1.Query)("to")),
+    __param(3, (0, common_1.Query)("companyId")),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, String, String, String]),
+    __metadata("design:returntype", Promise)
+], TokenUsageAdminController.prototype, "getSummary", null);
+__decorate([
+    (0, common_1.Get)(`${tokenusage_meta_1.tokenUsageMeta.endpoint}/administration/timeline`),
+    (0, roles_decorator_1.Roles)(system_roles_1.SystemRoles.Administrator),
+    __param(0, (0, common_1.Res)()),
+    __param(1, (0, common_1.Query)("from")),
+    __param(2, (0, common_1.Query)("to")),
+    __param(3, (0, common_1.Query)("granularity")),
+    __param(4, (0, common_1.Query)("stackBy")),
+    __param(5, (0, common_1.Query)("companyId")),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, String, String, String, String, String]),
+    __metadata("design:returntype", Promise)
+], TokenUsageAdminController.prototype, "getTimeline", null);
+__decorate([
+    (0, common_1.Get)(`${tokenusage_meta_1.tokenUsageMeta.endpoint}/administration/breakdown`),
+    (0, roles_decorator_1.Roles)(system_roles_1.SystemRoles.Administrator),
+    __param(0, (0, common_1.Res)()),
+    __param(1, (0, common_1.Query)("from")),
+    __param(2, (0, common_1.Query)("to")),
+    __param(3, (0, common_1.Query)("dimension")),
+    __param(4, (0, common_1.Query)("scope")),
+    __param(5, (0, common_1.Query)("companyId")),
+    __param(6, (0, common_1.Query)("limit")),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, String, String, String, String, String, String]),
+    __metadata("design:returntype", Promise)
+], TokenUsageAdminController.prototype, "getBreakdown", null);
+exports.TokenUsageAdminController = TokenUsageAdminController = __decorate([
+    (0, common_1.UseGuards)(jwt_auth_guard_1.JwtAuthGuard),
+    (0, common_1.Controller)(),
+    __metadata("design:paramtypes", [tokenusage_admin_service_1.TokenUsageAdminService])
+], TokenUsageAdminController);
+//# sourceMappingURL=tokenusage.admin.controller.js.map

package/dist/foundations/tokenusage/controllers/tokenusage.admin.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenusage.admin.controller.js","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/controllers/tokenusage.admin.controller.ts"],"names":[],"mappings":"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"}

package/dist/foundations/tokenusage/entities/tokenusage-admin-breakdown.d.ts

@@ -0,0 +1,26 @@
+import { Entity } from "../../../common/abstracts/entity";
+/**
+ * One ranked row of a breakdown. The same shape serves all three dimensions —
+ * company, user and operation — which is why the three "by-X" endpoints
+ * collapse into a single `breakdown?dimension=` route.
+ *
+ * `activeUsers` / `monthlyCredits` / `availableMonthlyCredits` are populated
+ * only for `dimension=company`; they are absent on user and operation rows.
+ *
+ * NOT a Neo4j node — serialisation shape only (see the summary descriptor).
+ */
+export type TokenUsageAdminBreakdownEntity = Entity & {
+    label: string;
+    sublabel?: string;
+    cost: number;
+    credits: number;
+    tokensIn: number;
+    tokensOut: number;
+    cached: number;
+    calls: number;
+    activeUsers?: number;
+    monthlyCredits?: number;
+    availableMonthlyCredits?: number;
+};
+export declare const TokenUsageAdminBreakdownDescriptor: import("../../..").EntityDescriptor<TokenUsageAdminBreakdownEntity, {}>;
+//# sourceMappingURL=tokenusage-admin-breakdown.d.ts.map

package/dist/foundations/tokenusage/entities/tokenusage-admin-breakdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenusage-admin-breakdown.d.ts","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/entities/tokenusage-admin-breakdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAI1D;;;;;;;;;GASG;AACH,MAAM,MAAM,8BAA8B,GAAG,MAAM,GAAG;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC,CAAC;AAEF,eAAO,MAAM,kCAAkC,yEAoB7C,CAAC"}

package/dist/foundations/tokenusage/entities/tokenusage-admin-breakdown.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokenUsageAdminBreakdownDescriptor = void 0;
+const define_entity_1 = require("../../../common/helpers/define-entity");
+const tokenusage_admin_breakdown_meta_1 = require("./tokenusage-admin-breakdown.meta");
+exports.TokenUsageAdminBreakdownDescriptor = (0, define_entity_1.defineEntity)()({
+    ...tokenusage_admin_breakdown_meta_1.tokenUsageAdminBreakdownMeta,
+    isCompanyScoped: false,
+    fields: {
+        label: { type: "string", required: true },
+        sublabel: { type: "string" },
+        cost: { type: "number", required: true },
+        credits: { type: "number", required: true },
+        tokensIn: { type: "number", required: true },
+        tokensOut: { type: "number", required: true },
+        cached: { type: "number", required: true },
+        calls: { type: "number", required: true },
+        activeUsers: { type: "number" },
+        monthlyCredits: { type: "number" },
+        availableMonthlyCredits: { type: "number" },
+    },
+    relationships: {},
+});
+//# sourceMappingURL=tokenusage-admin-breakdown.js.map

package/dist/foundations/tokenusage/entities/tokenusage-admin-breakdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenusage-admin-breakdown.js","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/entities/tokenusage-admin-breakdown.ts"],"names":[],"mappings":";;;AACA,yEAAqE;AACrE,uFAAiF;AA0BpE,QAAA,kCAAkC,GAAG,IAAA,4BAAY,GAAkC,CAAC;IAC/F,GAAG,8DAA4B;IAE/B,eAAe,EAAE,KAAK;IAEtB,MAAM,EAAE;QACN,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QACzC,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC5B,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QACxC,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC3C,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC5C,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC7C,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC1C,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QACzC,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC/B,cAAc,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAClC,uBAAuB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAC5C;IAED,aAAa,EAAE,EAAE;CAClB,CAAC,CAAC"}

package/dist/foundations/tokenusage/entities/tokenusage-admin-breakdown.meta.d.ts

@@ -0,0 +1,3 @@
+import { DataMeta } from "../../../common/interfaces/datamodel.interface";
+export declare const tokenUsageAdminBreakdownMeta: DataMeta;
+//# sourceMappingURL=tokenusage-admin-breakdown.meta.d.ts.map

package/dist/foundations/tokenusage/entities/tokenusage-admin-breakdown.meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenusage-admin-breakdown.meta.d.ts","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/entities/tokenusage-admin-breakdown.meta.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AAE1E,eAAO,MAAM,4BAA4B,EAAE,QAK1C,CAAC"}

package/dist/foundations/tokenusage/entities/tokenusage-admin-breakdown.meta.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tokenUsageAdminBreakdownMeta = void 0;
+exports.tokenUsageAdminBreakdownMeta = {
+    type: "tokenusage-admin-breakdowns",
+    endpoint: "tokenusages/administration/breakdown",
+    nodeName: "tokenUsageAdminBreakdown",
+    labelName: "TokenUsageAdminBreakdown",
+};
+//# sourceMappingURL=tokenusage-admin-breakdown.meta.js.map

package/dist/foundations/tokenusage/entities/tokenusage-admin-breakdown.meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenusage-admin-breakdown.meta.js","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/entities/tokenusage-admin-breakdown.meta.ts"],"names":[],"mappings":";;;AAEa,QAAA,4BAA4B,GAAa;IACpD,IAAI,EAAE,6BAA6B;IACnC,QAAQ,EAAE,sCAAsC;IAChD,QAAQ,EAAE,0BAA0B;IACpC,SAAS,EAAE,0BAA0B;CACtC,CAAC"}

package/dist/foundations/tokenusage/entities/tokenusage-admin-summary.d.ts

@@ -0,0 +1,24 @@
+import { Entity } from "../../../common/abstracts/entity";
+/**
+ * One row of the admin summary: a cost centre observed over one time window.
+ *
+ * Six rows are returned per request — scope ("customer" | "platform" | "total")
+ * crossed with window ("current" | "previous") — which is what lets the KPI
+ * tiles render both the value and its delta without a second call.
+ *
+ * NOT a Neo4j node: there is no TokenUsageAdminSummary label and no repository
+ * for this descriptor. It is a serialisation shape only, exactly like
+ * `ReferralStatsDescriptor`.
+ */
+export type TokenUsageAdminSummaryEntity = Entity & {
+    scope: string;
+    window: string;
+    cost: number;
+    credits: number;
+    tokensIn: number;
+    tokensOut: number;
+    cached: number;
+    calls: number;
+};
+export declare const TokenUsageAdminSummaryDescriptor: import("../../..").EntityDescriptor<TokenUsageAdminSummaryEntity, {}>;
+//# sourceMappingURL=tokenusage-admin-summary.d.ts.map

package/dist/foundations/tokenusage/entities/tokenusage-admin-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenusage-admin-summary.d.ts","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/entities/tokenusage-admin-summary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAI1D;;;;;;;;;;GAUG;AACH,MAAM,MAAM,4BAA4B,GAAG,MAAM,GAAG;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,eAAO,MAAM,gCAAgC,uEAiB3C,CAAC"}

package/dist/foundations/tokenusage/entities/tokenusage-admin-summary.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokenUsageAdminSummaryDescriptor = void 0;
+const define_entity_1 = require("../../../common/helpers/define-entity");
+const tokenusage_admin_summary_meta_1 = require("./tokenusage-admin-summary.meta");
+exports.TokenUsageAdminSummaryDescriptor = (0, define_entity_1.defineEntity)()({
+    ...tokenusage_admin_summary_meta_1.tokenUsageAdminSummaryMeta,
+    isCompanyScoped: false,
+    fields: {
+        scope: { type: "string", required: true },
+        window: { type: "string", required: true },
+        cost: { type: "number", required: true },
+        credits: { type: "number", required: true },
+        tokensIn: { type: "number", required: true },
+        tokensOut: { type: "number", required: true },
+        cached: { type: "number", required: true },
+        calls: { type: "number", required: true },
+    },
+    relationships: {},
+});
+//# sourceMappingURL=tokenusage-admin-summary.js.map

package/dist/foundations/tokenusage/entities/tokenusage-admin-summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenusage-admin-summary.js","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/entities/tokenusage-admin-summary.ts"],"names":[],"mappings":";;;AACA,yEAAqE;AACrE,mFAA6E;AAwBhE,QAAA,gCAAgC,GAAG,IAAA,4BAAY,GAAgC,CAAC;IAC3F,GAAG,0DAA0B;IAE7B,eAAe,EAAE,KAAK;IAEtB,MAAM,EAAE;QACN,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QACzC,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC1C,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QACxC,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC3C,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC5C,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC7C,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC1C,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;KAC1C;IAED,aAAa,EAAE,EAAE;CAClB,CAAC,CAAC"}

package/dist/foundations/tokenusage/entities/tokenusage-admin-summary.meta.d.ts

@@ -0,0 +1,3 @@
+import { DataMeta } from "../../../common/interfaces/datamodel.interface";
+export declare const tokenUsageAdminSummaryMeta: DataMeta;
+//# sourceMappingURL=tokenusage-admin-summary.meta.d.ts.map

package/dist/foundations/tokenusage/entities/tokenusage-admin-summary.meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenusage-admin-summary.meta.d.ts","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/entities/tokenusage-admin-summary.meta.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AAE1E,eAAO,MAAM,0BAA0B,EAAE,QAKxC,CAAC"}

package/dist/foundations/tokenusage/entities/tokenusage-admin-summary.meta.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tokenUsageAdminSummaryMeta = void 0;
+exports.tokenUsageAdminSummaryMeta = {
+    type: "tokenusage-admin-summaries",
+    endpoint: "tokenusages/administration/summary",
+    nodeName: "tokenUsageAdminSummary",
+    labelName: "TokenUsageAdminSummary",
+};
+//# sourceMappingURL=tokenusage-admin-summary.meta.js.map

package/dist/foundations/tokenusage/entities/tokenusage-admin-summary.meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenusage-admin-summary.meta.js","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/entities/tokenusage-admin-summary.meta.ts"],"names":[],"mappings":";;;AAEa,QAAA,0BAA0B,GAAa;IAClD,IAAI,EAAE,4BAA4B;IAClC,QAAQ,EAAE,oCAAoC;IAC9C,QAAQ,EAAE,wBAAwB;IAClC,SAAS,EAAE,wBAAwB;CACpC,CAAC"}

package/dist/foundations/tokenusage/entities/tokenusage-admin-timeline.d.ts

@@ -0,0 +1,22 @@
+import { Entity } from "../../../common/abstracts/entity";
+/**
+ * One (bucket, series) cell of the usage-over-time chart. Rows are flat; the
+ * frontend pivots them into stacked columns.
+ *
+ * `bucket` is a calendar day/week/month start with no time component, so it is
+ * `type: "date"` — never `"string"`. See references/date-handling.md rule 1.
+ *
+ * NOT a Neo4j node — serialisation shape only (see the summary descriptor).
+ */
+export type TokenUsageAdminTimelineEntity = Entity & {
+    bucket: string;
+    series: string;
+    cost: number;
+    credits: number;
+    tokensIn: number;
+    tokensOut: number;
+    cached: number;
+    calls: number;
+};
+export declare const TokenUsageAdminTimelineDescriptor: import("../../..").EntityDescriptor<TokenUsageAdminTimelineEntity, {}>;
+//# sourceMappingURL=tokenusage-admin-timeline.d.ts.map

package/dist/foundations/tokenusage/entities/tokenusage-admin-timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenusage-admin-timeline.d.ts","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/entities/tokenusage-admin-timeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAI1D;;;;;;;;GAQG;AACH,MAAM,MAAM,6BAA6B,GAAG,MAAM,GAAG;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,eAAO,MAAM,iCAAiC,wEAiB5C,CAAC"}

package/dist/foundations/tokenusage/entities/tokenusage-admin-timeline.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokenUsageAdminTimelineDescriptor = void 0;
+const define_entity_1 = require("../../../common/helpers/define-entity");
+const tokenusage_admin_timeline_meta_1 = require("./tokenusage-admin-timeline.meta");
+exports.TokenUsageAdminTimelineDescriptor = (0, define_entity_1.defineEntity)()({
+    ...tokenusage_admin_timeline_meta_1.tokenUsageAdminTimelineMeta,
+    isCompanyScoped: false,
+    fields: {
+        bucket: { type: "date", required: true },
+        series: { type: "string", required: true },
+        cost: { type: "number", required: true },
+        credits: { type: "number", required: true },
+        tokensIn: { type: "number", required: true },
+        tokensOut: { type: "number", required: true },
+        cached: { type: "number", required: true },
+        calls: { type: "number", required: true },
+    },
+    relationships: {},
+});
+//# sourceMappingURL=tokenusage-admin-timeline.js.map

package/dist/foundations/tokenusage/entities/tokenusage-admin-timeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenusage-admin-timeline.js","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/entities/tokenusage-admin-timeline.ts"],"names":[],"mappings":";;;AACA,yEAAqE;AACrE,qFAA+E;AAsBlE,QAAA,iCAAiC,GAAG,IAAA,4BAAY,GAAiC,CAAC;IAC7F,GAAG,4DAA2B;IAE9B,eAAe,EAAE,KAAK;IAEtB,MAAM,EAAE;QACN,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE;QACxC,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC1C,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QACxC,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC3C,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC5C,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC7C,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC1C,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;KAC1C;IAED,aAAa,EAAE,EAAE;CAClB,CAAC,CAAC"}

package/dist/foundations/tokenusage/entities/tokenusage-admin-timeline.meta.d.ts

@@ -0,0 +1,3 @@
+import { DataMeta } from "../../../common/interfaces/datamodel.interface";
+export declare const tokenUsageAdminTimelineMeta: DataMeta;
+//# sourceMappingURL=tokenusage-admin-timeline.meta.d.ts.map

package/dist/foundations/tokenusage/entities/tokenusage-admin-timeline.meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenusage-admin-timeline.meta.d.ts","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/entities/tokenusage-admin-timeline.meta.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AAE1E,eAAO,MAAM,2BAA2B,EAAE,QAKzC,CAAC"}

package/dist/foundations/tokenusage/entities/tokenusage-admin-timeline.meta.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tokenUsageAdminTimelineMeta = void 0;
+exports.tokenUsageAdminTimelineMeta = {
+    type: "tokenusage-admin-timelines",
+    endpoint: "tokenusages/administration/timeline",
+    nodeName: "tokenUsageAdminTimeline",
+    labelName: "TokenUsageAdminTimeline",
+};
+//# sourceMappingURL=tokenusage-admin-timeline.meta.js.map

package/dist/foundations/tokenusage/entities/tokenusage-admin-timeline.meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenusage-admin-timeline.meta.js","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/entities/tokenusage-admin-timeline.meta.ts"],"names":[],"mappings":";;;AAEa,QAAA,2BAA2B,GAAa;IACnD,IAAI,EAAE,4BAA4B;IAClC,QAAQ,EAAE,qCAAqC;IAC/C,QAAQ,EAAE,yBAAyB;IACnC,SAAS,EAAE,yBAAyB;CACrC,CAAC"}

package/dist/foundations/tokenusage/index.d.ts

@@ -5,4 +5,13 @@ export { TOKEN_USAGE_RECORDED_EVENT, TokenUsageRecordedPayload } from "./events/
 export { TokenUsageAggregated, TokenUsageRepository, TokenUsageSummary } from "./repositories/tokenusage.repository";
 export { TokenUsageService } from "./services/tokenusage.service";
 export { TokenUsageModule } from "./tokenusage.module";
+export { TokenUsageAdminBreakdownDescriptor, TokenUsageAdminBreakdownEntity, } from "./entities/tokenusage-admin-breakdown";
+export { tokenUsageAdminBreakdownMeta } from "./entities/tokenusage-admin-breakdown.meta";
+export { TokenUsageAdminSummaryDescriptor, TokenUsageAdminSummaryEntity } from "./entities/tokenusage-admin-summary";
+export { tokenUsageAdminSummaryMeta } from "./entities/tokenusage-admin-summary.meta";
+export { TokenUsageAdminTimelineDescriptor, TokenUsageAdminTimelineEntity } from "./entities/tokenusage-admin-timeline";
+export { tokenUsageAdminTimelineMeta } from "./entities/tokenusage-admin-timeline.meta";
+export { TokenUsageAdminRepository } from "./repositories/tokenusage.admin.repository";
+export { TokenUsageAdminService } from "./services/tokenusage.admin.service";
+export { TokenUsageAdminController } from "./controllers/tokenusage.admin.controller";
 //# sourceMappingURL=index.d.ts.map

package/dist/foundations/tokenusage/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/foundations/tokenusage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,0BAA0B,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACnG,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AACrH,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/foundations/tokenusage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,0BAA0B,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACnG,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AACrH,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EACL,kCAAkC,EAClC,8BAA8B,GAC/B,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,4BAA4B,EAAE,MAAM,4CAA4C,CAAC;AAC1F,OAAO,EAAE,gCAAgC,EAAE,4BAA4B,EAAE,MAAM,qCAAqC,CAAC;AACrH,OAAO,EAAE,0BAA0B,EAAE,MAAM,0CAA0C,CAAC;AACtF,OAAO,EAAE,iCAAiC,EAAE,6BAA6B,EAAE,MAAM,sCAAsC,CAAC;AACxH,OAAO,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAC;AACxF,OAAO,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAC;AACvF,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,OAAO,EAAE,yBAAyB,EAAE,MAAM,2CAA2C,CAAC"}

package/dist/foundations/tokenusage/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TokenUsageModule = exports.TokenUsageService = exports.TokenUsageRepository = exports.TOKEN_USAGE_RECORDED_EVENT = exports.TokenUsageType = exports.tokenUsageMeta = exports.TokenUsageDescriptor = void 0;
+exports.TokenUsageAdminController = exports.TokenUsageAdminService = exports.TokenUsageAdminRepository = exports.tokenUsageAdminTimelineMeta = exports.TokenUsageAdminTimelineDescriptor = exports.tokenUsageAdminSummaryMeta = exports.TokenUsageAdminSummaryDescriptor = exports.tokenUsageAdminBreakdownMeta = exports.TokenUsageAdminBreakdownDescriptor = exports.TokenUsageModule = exports.TokenUsageService = exports.TokenUsageRepository = exports.TOKEN_USAGE_RECORDED_EVENT = exports.TokenUsageType = exports.tokenUsageMeta = exports.TokenUsageDescriptor = void 0;
 var tokenusage_1 = require("./entities/tokenusage");
 Object.defineProperty(exports, "TokenUsageDescriptor", { enumerable: true, get: function () { return tokenusage_1.TokenUsageDescriptor; } });
 var tokenusage_meta_1 = require("./entities/tokenusage.meta");
@@ -15,4 +15,22 @@ var tokenusage_service_1 = require("./services/tokenusage.service");
 Object.defineProperty(exports, "TokenUsageService", { enumerable: true, get: function () { return tokenusage_service_1.TokenUsageService; } });
 var tokenusage_module_1 = require("./tokenusage.module");
 Object.defineProperty(exports, "TokenUsageModule", { enumerable: true, get: function () { return tokenusage_module_1.TokenUsageModule; } });
+var tokenusage_admin_breakdown_1 = require("./entities/tokenusage-admin-breakdown");
+Object.defineProperty(exports, "TokenUsageAdminBreakdownDescriptor", { enumerable: true, get: function () { return tokenusage_admin_breakdown_1.TokenUsageAdminBreakdownDescriptor; } });
+var tokenusage_admin_breakdown_meta_1 = require("./entities/tokenusage-admin-breakdown.meta");
+Object.defineProperty(exports, "tokenUsageAdminBreakdownMeta", { enumerable: true, get: function () { return tokenusage_admin_breakdown_meta_1.tokenUsageAdminBreakdownMeta; } });
+var tokenusage_admin_summary_1 = require("./entities/tokenusage-admin-summary");
+Object.defineProperty(exports, "TokenUsageAdminSummaryDescriptor", { enumerable: true, get: function () { return tokenusage_admin_summary_1.TokenUsageAdminSummaryDescriptor; } });
+var tokenusage_admin_summary_meta_1 = require("./entities/tokenusage-admin-summary.meta");
+Object.defineProperty(exports, "tokenUsageAdminSummaryMeta", { enumerable: true, get: function () { return tokenusage_admin_summary_meta_1.tokenUsageAdminSummaryMeta; } });
+var tokenusage_admin_timeline_1 = require("./entities/tokenusage-admin-timeline");
+Object.defineProperty(exports, "TokenUsageAdminTimelineDescriptor", { enumerable: true, get: function () { return tokenusage_admin_timeline_1.TokenUsageAdminTimelineDescriptor; } });
+var tokenusage_admin_timeline_meta_1 = require("./entities/tokenusage-admin-timeline.meta");
+Object.defineProperty(exports, "tokenUsageAdminTimelineMeta", { enumerable: true, get: function () { return tokenusage_admin_timeline_meta_1.tokenUsageAdminTimelineMeta; } });
+var tokenusage_admin_repository_1 = require("./repositories/tokenusage.admin.repository");
+Object.defineProperty(exports, "TokenUsageAdminRepository", { enumerable: true, get: function () { return tokenusage_admin_repository_1.TokenUsageAdminRepository; } });
+var tokenusage_admin_service_1 = require("./services/tokenusage.admin.service");
+Object.defineProperty(exports, "TokenUsageAdminService", { enumerable: true, get: function () { return tokenusage_admin_service_1.TokenUsageAdminService; } });
+var tokenusage_admin_controller_1 = require("./controllers/tokenusage.admin.controller");
+Object.defineProperty(exports, "TokenUsageAdminController", { enumerable: true, get: function () { return tokenusage_admin_controller_1.TokenUsageAdminController; } });
 //# sourceMappingURL=index.js.map

package/dist/foundations/tokenusage/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/foundations/tokenusage/index.ts"],"names":[],"mappings":";;;AAAA,oDAAyE;AAApD,kHAAA,oBAAoB,OAAA;AACzC,8DAA4D;AAAnD,iHAAA,cAAc,OAAA;AACvB,2DAAyD;AAAhD,iHAAA,cAAc,OAAA;AACvB,gEAAmG;AAA1F,+HAAA,0BAA0B,OAAA;AACnC,8EAAqH;AAAtF,6HAAA,oBAAoB,OAAA;AACnD,oEAAkE;AAAzD,uHAAA,iBAAiB,OAAA;AAC1B,yDAAuD;AAA9C,qHAAA,gBAAgB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/foundations/tokenusage/index.ts"],"names":[],"mappings":";;;AAAA,oDAAyE;AAApD,kHAAA,oBAAoB,OAAA;AACzC,8DAA4D;AAAnD,iHAAA,cAAc,OAAA;AACvB,2DAAyD;AAAhD,iHAAA,cAAc,OAAA;AACvB,gEAAmG;AAA1F,+HAAA,0BAA0B,OAAA;AACnC,8EAAqH;AAAtF,6HAAA,oBAAoB,OAAA;AACnD,oEAAkE;AAAzD,uHAAA,iBAAiB,OAAA;AAC1B,yDAAuD;AAA9C,qHAAA,gBAAgB,OAAA;AACzB,oFAG+C;AAF7C,gJAAA,kCAAkC,OAAA;AAGpC,8FAA0F;AAAjF,+IAAA,4BAA4B,OAAA;AACrC,gFAAqH;AAA5G,4IAAA,gCAAgC,OAAA;AACzC,0FAAsF;AAA7E,2IAAA,0BAA0B,OAAA;AACnC,kFAAwH;AAA/G,8IAAA,iCAAiC,OAAA;AAC1C,4FAAwF;AAA/E,6IAAA,2BAA2B,OAAA;AACpC,0FAAuF;AAA9E,wIAAA,yBAAyB,OAAA;AAClC,gFAA6E;AAApE,kIAAA,sBAAsB,OAAA;AAC/B,yFAAsF;AAA7E,wIAAA,yBAAyB,OAAA"}

package/dist/foundations/tokenusage/repositories/tokenusage.admin.repository.d.ts

@@ -0,0 +1,73 @@
+import { ClsService } from "nestjs-cls";
+import { AbstractRepository } from "../../../core/neo4j/abstracts/abstract.repository";
+import { Neo4jService } from "../../../core/neo4j/services/neo4j.service";
+import { SecurityService } from "../../../core/security/services/security.service";
+import { TokenUsageAdminBreakdownEntity } from "../entities/tokenusage-admin-breakdown";
+import { TokenUsageAdminSummaryEntity } from "../entities/tokenusage-admin-summary";
+import { TokenUsageAdminTimelineEntity } from "../entities/tokenusage-admin-timeline";
+import { TokenUsage, TokenUsageDescriptor } from "../entities/tokenusage";
+/**
+ * Cross-tenant reporting queries behind /tokenusages/administration/*.
+ *
+ * Extends AbstractRepository for the shared Neo4j/security/CLS plumbing and the
+ * descriptor typing; none of the inherited finders are used, for the reasons in
+ * the file header, and it deliberately does NOT override onModuleInit — the
+ * :TokenUsage indexes belong to TokenUsageRepository.
+ *
+ * EVERY traversal constrains its target label — `->(:Company)`, `->(:User)`.
+ * The write bug fixed in tokenusage.repository.ts left 12,237 label-less nodes
+ * on exactly these two relationships; an unconstrained match returns them.
+ */
+export declare class TokenUsageAdminRepository extends AbstractRepository<TokenUsage, typeof TokenUsageDescriptor.relationships> {
+    protected readonly descriptor: import("../../..").EntityDescriptor<TokenUsage, {}>;
+    constructor(neo4j: Neo4jService, securityService: SecurityService, clsService: ClsService);
+    /**
+     * Six rows: {customer, platform, total} × {current, previous}. The previous
+     * window is the equal-length span immediately preceding `from`, which is what
+     * the KPI tiles' deltas are computed against.
+     */
+    findSummary(params: {
+        from: string;
+        to: string;
+        companyId?: string;
+    }): Promise<TokenUsageAdminSummaryEntity[]>;
+    findTimeline(params: {
+        from: string;
+        to: string;
+        granularity: "day" | "week" | "month";
+        stackBy: "scope" | "type" | "company";
+        companyId?: string;
+    }): Promise<TokenUsageAdminTimelineEntity[]>;
+    /**
+     * Ranked rows, descending by cost, truncated to `limit` with the exact
+     * remainder folded into a single "other" row. The full ordered set is fetched
+     * and sliced in JS so the remainder is exact rather than a second query's
+     * approximation. Above ~1000 companies, move the LIMIT into Cypher and take
+     * the remainder from findSummary() instead.
+     */
+    findBreakdown(params: {
+        from: string;
+        to: string;
+        dimension: "company" | "user" | "operation";
+        scope: "customer" | "platform";
+        companyId?: string;
+        limit: number;
+    }): Promise<TokenUsageAdminBreakdownEntity[]>;
+    /** Scalar rollup split by cost centre for one window. */
+    private _scopeTotals;
+    /**
+     * Guarantees both cost centres are present (zero-filled when a window has no
+     * rows) and appends their sum as the "total" scope, so the tiles never have to
+     * branch on a missing row.
+     */
+    private _withTotal;
+    /** The equal-length span immediately preceding `from`. */
+    private _previousWindow;
+    /**
+     * Resolves a granularity to the `date.truncate` unit it may emit. Throws
+     * rather than interpolating anything the table does not know about.
+     */
+    private _truncationUnit;
+    private _metrics;
+}
+//# sourceMappingURL=tokenusage.admin.repository.d.ts.map

package/dist/foundations/tokenusage/repositories/tokenusage.admin.repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenusage.admin.repository.d.ts","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/repositories/tokenusage.admin.repository.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mDAAmD,CAAC;AACvF,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,kDAAkD,CAAC;AACnF,OAAO,EAAE,8BAA8B,EAAE,MAAM,wCAAwC,CAAC;AACxF,OAAO,EAAE,4BAA4B,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,EAEL,6BAA6B,EAC9B,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAuC1E;;;;;;;;;;;GAWG;AACH,qBACa,yBAA0B,SAAQ,kBAAkB,CAC/D,UAAU,EACV,OAAO,oBAAoB,CAAC,aAAa,CAC1C;IACC,SAAS,CAAC,QAAQ,CAAC,UAAU,sDAAwB;gBAEzC,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU;IAIzF;;;;OAIG;IACG,WAAW,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,4BAA4B,EAAE,CAAC;IAW9G,YAAY,CAAC,MAAM,EAAE;QACzB,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,WAAW,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;QACtC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;QACtC,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,6BAA6B,EAAE,CAAC;IA+D5C;;;;;;OAMG;IACG,aAAa,CAAC,MAAM,EAAE;QAC1B,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,SAAS,EAAE,SAAS,GAAG,MAAM,GAAG,WAAW,CAAC;QAC5C,KAAK,EAAE,UAAU,GAAG,UAAU,CAAC;QAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;KACf,GAAG,OAAO,CAAC,8BAA8B,EAAE,CAAC;IAqH7C,yDAAyD;YAC3C,YAAY;IAkC1B;;;;OAIG;IACH,OAAO,CAAC,UAAU;IA8BlB,0DAA0D;IAC1D,OAAO,CAAC,eAAe;IAOvB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,QAAQ;CAUjB"}