@carlonicora/nestjs-neo4jsonapi 1.116.0 → 1.118.0

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":";;;;;;;;;;;;;;;AAAA,2CAA6F;AAE7F,yEAAqE;AACrE,gFAAmE;AACnE,0EAAqE;AACrE,iEAA6D;AAC7D,mFAA8E;AAE9E,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAU,CAAC;AACxD,MAAM,QAAQ,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAU,CAAC;AACvD,MAAM,UAAU,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAU,CAAC;AAC7D,MAAM,MAAM,GAAG,CAAC,UAAU,EAAE,UAAU,CAAU,CAAC;AAEjD,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAC/B,MAAM,UAAU,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAEvC;;;;;;;;;;;;;;GAcG;AAGI,IAAM,yBAAyB,GAA/B,MAAM,yBAAyB;IACpC,YAA6B,OAA+B;QAA/B,YAAO,GAAP,OAAO,CAAwB;IAAG,CAAC;IAI1D,AAAN,KAAK,CAAC,UAAU,CACP,KAAmB,EACX,IAAa,EACf,EAAW,EACJ,SAAkB;QAEtC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;IACrE,CAAC;IAIK,AAAN,KAAK,CAAC,WAAW,CACR,KAAmB,EACX,IAAa,EACf,EAAW,EACF,WAAoB,EACxB,OAAgB,EACd,SAAkB;QAEtC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACpC,KAAK,CAAC,IAAI,CACR,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;YAC7B,GAAG,KAAK;YACR,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,aAAa,EAAE,KAAK,CAAC;YAC3D,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC;YAChD,SAAS;SACV,CAAC,CACH,CAAC;IACJ,CAAC;IAIK,AAAN,KAAK,CAAC,YAAY,CACT,KAAmB,EACX,IAAa,EACf,EAAW,EACJ,SAAkB,EACtB,KAAc,EACV,SAAkB,EACtB,KAAc;QAE9B,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACpC,MAAM,WAAW,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC7D,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,WAAW,GAAG,CAAC,IAAI,WAAW,GAAG,GAAG;YACxE,MAAM,IAAI,4BAAmB,CAAC,4CAA4C,CAAC,CAAC;QAE9E,KAAK,CAAC,IAAI,CACR,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC;YAC9B,GAAG,KAAK;YACR,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,UAAU,EAAE,SAAS,CAAC;YACxD,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC;YAC7C,SAAS;YACT,KAAK,EAAE,WAAW;SACnB,CAAC,CACH,CAAC;IACJ,CAAC;IAEO,MAAM,CAA8B,KAAyB,EAAE,OAAU,EAAE,QAAmB;QACpG,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,QAAQ,CAAC;QACzC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;YAC1B,MAAM,IAAI,4BAAmB,CAAC,mBAAmB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,KAAK,GAAG,CAAC,CAAC;QAC9F,OAAO,KAAkB,CAAC;IAC5B,CAAC;IAEO,MAAM,CAAC,IAAa,EAAE,EAAW;QACvC,MAAM,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;QAC9C,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAAE,MAAM,IAAI,4BAAmB,CAAC,0BAA0B,CAAC,CAAC;QAE9F,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,mBAAmB,GAAG,UAAU,CAAC,CAAC;QACvG,IAAI,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YAAE,MAAM,IAAI,4BAAmB,CAAC,4BAA4B,CAAC,CAAC;QAElG,IAAI,QAAQ,GAAG,MAAM;YAAE,MAAM,IAAI,4BAAmB,CAAC,oCAAoC,CAAC,CAAC;QAE3F,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,WAAW,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;IACpE,CAAC;CACF,CAAA;AAjFY,8DAAyB;AAK9B;IAFL,IAAA,YAAG,EAAC,GAAG,gCAAc,CAAC,QAAQ,yBAAyB,CAAC;IACxD,IAAA,uBAAK,EAAC,0BAAW,CAAC,aAAa,CAAC;IAE9B,WAAA,IAAA,YAAG,GAAE,CAAA;IACL,WAAA,IAAA,cAAK,EAAC,MAAM,CAAC,CAAA;IACb,WAAA,IAAA,cAAK,EAAC,IAAI,CAAC,CAAA;IACX,WAAA,IAAA,cAAK,EAAC,WAAW,CAAC,CAAA;;;;2DAIpB;AAIK;IAFL,IAAA,YAAG,EAAC,GAAG,gCAAc,CAAC,QAAQ,0BAA0B,CAAC;IACzD,IAAA,uBAAK,EAAC,0BAAW,CAAC,aAAa,CAAC;IAE9B,WAAA,IAAA,YAAG,GAAE,CAAA;IACL,WAAA,IAAA,cAAK,EAAC,MAAM,CAAC,CAAA;IACb,WAAA,IAAA,cAAK,EAAC,IAAI,CAAC,CAAA;IACX,WAAA,IAAA,cAAK,EAAC,aAAa,CAAC,CAAA;IACpB,WAAA,IAAA,cAAK,EAAC,SAAS,CAAC,CAAA;IAChB,WAAA,IAAA,cAAK,EAAC,WAAW,CAAC,CAAA;;;;4DAWpB;AAIK;IAFL,IAAA,YAAG,EAAC,GAAG,gCAAc,CAAC,QAAQ,2BAA2B,CAAC;IAC1D,IAAA,uBAAK,EAAC,0BAAW,CAAC,aAAa,CAAC;IAE9B,WAAA,IAAA,YAAG,GAAE,CAAA;IACL,WAAA,IAAA,cAAK,EAAC,MAAM,CAAC,CAAA;IACb,WAAA,IAAA,cAAK,EAAC,IAAI,CAAC,CAAA;IACX,WAAA,IAAA,cAAK,EAAC,WAAW,CAAC,CAAA;IAClB,WAAA,IAAA,cAAK,EAAC,OAAO,CAAC,CAAA;IACd,WAAA,IAAA,cAAK,EAAC,WAAW,CAAC,CAAA;IAClB,WAAA,IAAA,cAAK,EAAC,OAAO,CAAC,CAAA;;;;6DAgBhB;oCA7DU,yBAAyB;IAFrC,IAAA,kBAAS,EAAC,6BAAY,CAAC;IACvB,IAAA,mBAAU,GAAE;qCAE2B,iDAAsB;GADjD,yBAAyB,CAiFrC"}

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/entities/tokenusage.d.ts

@@ -13,6 +13,7 @@ export type TokenUsage = Entity & {
     outputTokens: number;
     cachedInputTokens?: number;
     cost?: number;
+    credits?: number;
     tokenUsageType: string;
     company: Company;
 };

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

@@ -1 +1 @@
-{"version":3,"file":"tokenusage.d.ts","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/entities/tokenusage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAE1D,OAAO,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AAGzD;;;;;;;GAOG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IAEvB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,oBAAoB,qDAmC/B,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,OAAO,oBAAoB,CAAC"}
+{"version":3,"file":"tokenusage.d.ts","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/entities/tokenusage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAE1D,OAAO,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AAGzD;;;;;;;GAOG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IAEvB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,oBAAoB,qDAwC/B,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,OAAO,oBAAoB,CAAC"}

package/dist/foundations/tokenusage/entities/tokenusage.js

@@ -53,6 +53,10 @@ exports.TokenUsageDescriptor = (0, define_entity_1.defineEntity)()({
             type: "number",
             description: "The computed monetary cost of this LLM call, derived from the configured per-million-token input/cached-input/output rates of the tier the call used. Absent or 0 when cost tracking is disabled (rates set to 0).",
         },
+        credits: {
+            type: "number",
+            description: "The number of billing credits this call consumed: max(minCreditsPerRecord, round2(cost / creditCost)). 0 when credits tracking is disabled. Fractional (2 decimals).",
+        },
         tokenUsageType: {
             type: "string",
             required: true,

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

@@ -1 +1 @@
-{"version":3,"file":"tokenusage.js","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/entities/tokenusage.ts"],"names":[],"mappings":";;;AACA,yEAAqE;AAErE,uDAAmD;AAoBnD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACU,QAAA,oBAAoB,GAAG,IAAA,4BAAY,GAAc,CAAC;IAC7D,GAAG,gCAAc;IAEjB,eAAe,EAAE,IAAI;IAErB,MAAM,EAAE;QACN,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,gEAAgE;SAC9E;QACD,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,qEAAqE;SACnF;QACD,iBAAiB,EAAE;YACjB,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,kPAAkP;SACrP;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,oNAAoN;SACvN;QACD,cAAc,EAAE;YACd,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,IAAI;YACd,WAAW,EACT,4KAA4K;SAC/K;KACF;IAED,aAAa,EAAE,EAAE;CAClB,CAAC,CAAC"}
+{"version":3,"file":"tokenusage.js","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/entities/tokenusage.ts"],"names":[],"mappings":";;;AACA,yEAAqE;AAErE,uDAAmD;AAqBnD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACU,QAAA,oBAAoB,GAAG,IAAA,4BAAY,GAAc,CAAC;IAC7D,GAAG,gCAAc;IAEjB,eAAe,EAAE,IAAI;IAErB,MAAM,EAAE;QACN,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,gEAAgE;SAC9E;QACD,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,qEAAqE;SACnF;QACD,iBAAiB,EAAE;YACjB,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,kPAAkP;SACrP;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,oNAAoN;SACvN;QACD,OAAO,EAAE;YACP,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,sKAAsK;SACzK;QACD,cAAc,EAAE;YACd,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,IAAI;YACd,WAAW,EACT,4KAA4K;SAC/K;KACF;IAED,aAAa,EAAE,EAAE;CAClB,CAAC,CAAC"}

package/dist/foundations/tokenusage/enums/tokenusage.type.d.ts

@@ -1,4 +1,4 @@
-export type TokenUsageType = "graph_creator" | "counterpart_identificator" | "summariser" | "responder" | "ethicist" | "analyser" | "strategy" | "text_generation";
+export type TokenUsageType = "graph_creator" | "counterpart_identificator" | "summariser" | "responder" | "ethicist" | "analyser" | "strategy" | "text_generation" | "embedding";
 export declare const TokenUsageType: {
     readonly GraphCreator: "graph_creator";
     readonly CounterpartIdentificator: "counterpart_identificator";
@@ -8,5 +8,6 @@ export declare const TokenUsageType: {
     readonly Analyser: "analyser";
     readonly Strategy: "strategy";
     readonly TextGeneration: "text_generation";
+    readonly Embedding: "embedding";
 };
 //# sourceMappingURL=tokenusage.type.d.ts.map

package/dist/foundations/tokenusage/enums/tokenusage.type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tokenusage.type.d.ts","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/enums/tokenusage.type.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GACtB,eAAe,GACf,2BAA2B,GAC3B,YAAY,GACZ,WAAW,GACX,UAAU,GACV,UAAU,GACV,UAAU,GACV,iBAAiB,CAAC;AAEtB,eAAO,MAAM,cAAc;;;;;;;;;CASjB,CAAC"}
+{"version":3,"file":"tokenusage.type.d.ts","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/enums/tokenusage.type.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GACtB,eAAe,GACf,2BAA2B,GAC3B,YAAY,GACZ,WAAW,GACX,UAAU,GACV,UAAU,GACV,UAAU,GACV,iBAAiB,GACjB,WAAW,CAAC;AAEhB,eAAO,MAAM,cAAc;;;;;;;;;;CAUjB,CAAC"}

package/dist/foundations/tokenusage/enums/tokenusage.type.js

@@ -10,5 +10,6 @@ exports.TokenUsageType = {
     Analyser: "analyser",
     Strategy: "strategy",
     TextGeneration: "text_generation",
+    Embedding: "embedding",
 };
 //# sourceMappingURL=tokenusage.type.js.map

package/dist/foundations/tokenusage/enums/tokenusage.type.js.map

@@ -1 +1 @@
-{"version":3,"file":"tokenusage.type.js","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/enums/tokenusage.type.ts"],"names":[],"mappings":";;;AAUa,QAAA,cAAc,GAAG;IAC5B,YAAY,EAAE,eAAe;IAC7B,wBAAwB,EAAE,2BAA2B;IACrD,UAAU,EAAE,YAAY;IACxB,SAAS,EAAE,WAAW;IACtB,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;IACpB,cAAc,EAAE,iBAAiB;CACzB,CAAC"}
+{"version":3,"file":"tokenusage.type.js","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/enums/tokenusage.type.ts"],"names":[],"mappings":";;;AAWa,QAAA,cAAc,GAAG;IAC5B,YAAY,EAAE,eAAe;IAC7B,wBAAwB,EAAE,2BAA2B;IACrD,UAAU,EAAE,YAAY;IACxB,SAAS,EAAE,WAAW;IACtB,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;IACpB,cAAc,EAAE,iBAAiB;IACjC,SAAS,EAAE,WAAW;CACd,CAAC"}

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

@@ -9,5 +9,7 @@ export declare const TOKEN_USAGE_RECORDED_EVENT = "tokenusage.recorded";
 export interface TokenUsageRecordedPayload {
     input: number;
     output: number;
+    cost: number;
+    credits: number;
 }
 //# sourceMappingURL=tokenusage.events.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"tokenusage.events.d.ts","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/events/tokenusage.events.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,wBAAwB,CAAC;AAEhE,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB"}
+{"version":3,"file":"tokenusage.events.d.ts","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/events/tokenusage.events.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,wBAAwB,CAAC;AAEhE,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB"}

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

@@ -2,7 +2,16 @@ export { TokenUsage, TokenUsageDescriptor } from "./entities/tokenusage";
 export { tokenUsageMeta } from "./entities/tokenusage.meta";
 export { TokenUsageType } from "./enums/tokenusage.type";
 export { TOKEN_USAGE_RECORDED_EVENT, TokenUsageRecordedPayload } from "./events/tokenusage.events";
-export { TokenUsageRepository } from "./repositories/tokenusage.repository";
+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,MAAM,sCAAsC,CAAC;AAC5E,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,8EAA4E;AAAnE,6HAAA,oBAAoB,OAAA;AAC7B,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"}