@carlonicora/nestjs-neo4jsonapi 2.6.0 → 2.7.1

package/dist/foundations/tokenusage/common/tokenusage.target-labels.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOKEN_USAGE_TARGET_LABELS = void 0;
+exports.normaliseTargetLabel = normaliseTargetLabel;
+exports.buildTargetGrouping = buildTargetGrouping;
+/**
+ * The Neo4j labels a consuming application allows the token-usage breakdown to
+ * group by through the polymorphic USED_FOR edge.
+ *
+ * The label SELECTS A CYPHER CLAUSE — it is not a bound value — so it can never
+ * be taken from the request unchecked. The repository matches the requested
+ * label against this allowlist and throws BadRequestException on a miss; nothing
+ * that did not come from here ever reaches the query text.
+ *
+ * Supplied by the app from a @Global() module, mirroring
+ * ASSISTANT_SEED_CONTEXT_PROVIDERS: the library's TokenUsageModule cannot import
+ * an application feature module, and consumes this with
+ * @Optional() @Inject(TOKEN_USAGE_TARGET_LABELS). Absent → [] → dimension=target
+ * is rejected, which is the correct default for an app that has not opted in.
+ */
+exports.TOKEN_USAGE_TARGET_LABELS = Symbol("TOKEN_USAGE_TARGET_LABELS");
+/**
+ * Neo4j labels and relationship types are identifiers, not values, so they
+ * cannot be parameterised. Everything interpolated into a query is checked
+ * against this first — a second lock behind the allowlist, so a typo or a
+ * careless app config fails loudly instead of producing arbitrary Cypher.
+ */
+const SAFE_IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;
+/** Applies the defaults and rejects anything that is not a plain identifier. */
+function normaliseTargetLabel(entry) {
+    const resolved = typeof entry === "string"
+        ? { label: entry, via: [], maxDepth: 0 }
+        : { label: entry.label, via: entry.via ?? [], maxDepth: entry.maxDepth ?? 1 };
+    if (!SAFE_IDENTIFIER.test(resolved.label))
+        throw new Error(`TOKEN_USAGE_TARGET_LABELS: "${resolved.label}" is not a valid Neo4j label`);
+    for (const relationship of resolved.via)
+        if (!SAFE_IDENTIFIER.test(relationship))
+            throw new Error(`TOKEN_USAGE_TARGET_LABELS: "${relationship}" is not a valid relationship type`);
+    return resolved;
+}
+/**
+ * The Cypher that binds `grp` to the entity a usage row is attributed to.
+ *
+ * Lives here rather than in either repository because the administrative and
+ * the self-service breakdowns must group identically — two copies of this
+ * traversal would drift, and the two surfaces would then report different
+ * totals for the same window.
+ *
+ * With no rollup it is the original direct match. With one, the traversal is
+ * `*0..maxDepth`: depth zero keeps rows that already point at the target label,
+ * so a campaign named directly and a campaign reached through its session land
+ * in the same bucket.
+ *
+ * `head(collect(...))` is deliberate. An entity reachable from two targets would
+ * otherwise multiply its row and be counted once per path, inflating the totals;
+ * collapsing to one target per usage record keeps the column summing to the same
+ * figure the by-operation panel reports. Ordering by id makes the pick stable
+ * across requests rather than dependent on traversal order.
+ *
+ * @param carried the variables that must survive into the grouping, in order —
+ *   the admin query carries its company node, the report query does not.
+ */
+function buildTargetGrouping(params) {
+    const { target, nodeName, carried } = params;
+    const carry = [nodeName, ...carried].join(", ");
+    if (target.via.length === 0 || target.maxDepth === 0)
+        return `MATCH (${nodeName})-[:USED_FOR]->(grp:${target.label})\n      WITH ${carry}, grp`;
+    // One leading colon, then bare types: `:A|B`. Neo4j rejects the repeated-colon
+    // form `:A|:B` whenever a variable length is attached, which this always has.
+    const relationships = `:${target.via.join("|")}`;
+    return [
+        `MATCH (${nodeName})-[:USED_FOR]->(usageTarget)`,
+        `      OPTIONAL MATCH (usageTarget)-[${relationships}*0..${target.maxDepth}]->(rollup:${target.label})`,
+        `      WITH ${carry}, usageTarget, rollup ORDER BY rollup.id`,
+        `      WITH ${carry}, head(collect(rollup)) AS grp`,
+        `      WHERE grp IS NOT NULL`,
+    ].join("\n");
+}
+//# sourceMappingURL=tokenusage.target-labels.js.map

package/dist/foundations/tokenusage/common/tokenusage.target-labels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenusage.target-labels.js","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/common/tokenusage.target-labels.ts"],"names":[],"mappings":";;;AA4EA,oDAcC;AAwBD,kDAsBC;AAxID;;;;;;;;;;;;;;GAcG;AACU,QAAA,yBAAyB,GAAG,MAAM,CAAC,2BAA2B,CAAC,CAAC;AAoD7E;;;;;GAKG;AACH,MAAM,eAAe,GAAG,0BAA0B,CAAC;AAEnD,gFAAgF;AAChF,SAAgB,oBAAoB,CAAC,KAA4B;IAC/D,MAAM,QAAQ,GACZ,OAAO,KAAK,KAAK,QAAQ;QACvB,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE;QACxC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,CAAC,EAAE,CAAC;IAElF,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,+BAA+B,QAAQ,CAAC,KAAK,8BAA8B,CAAC,CAAC;IAE/F,KAAK,MAAM,YAAY,IAAI,QAAQ,CAAC,GAAG;QACrC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,YAAY,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,+BAA+B,YAAY,oCAAoC,CAAC,CAAC;IAErG,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,SAAgB,mBAAmB,CAAC,MAInC;IACC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IAC7C,MAAM,KAAK,GAAG,CAAC,QAAQ,EAAE,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEhD,IAAI,MAAM,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC;QAClD,OAAO,UAAU,QAAQ,uBAAuB,MAAM,CAAC,KAAK,iBAAiB,KAAK,OAAO,CAAC;IAE5F,+EAA+E;IAC/E,8EAA8E;IAC9E,MAAM,aAAa,GAAG,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IAEjD,OAAO;QACL,UAAU,QAAQ,8BAA8B;QAChD,uCAAuC,aAAa,OAAO,MAAM,CAAC,QAAQ,cAAc,MAAM,CAAC,KAAK,GAAG;QACvG,cAAc,KAAK,0CAA0C;QAC7D,cAAc,KAAK,gCAAgC;QACnD,6BAA6B;KAC9B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

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

@@ -20,7 +20,7 @@ export declare class TokenUsageAdminController {
     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>;
+    getBreakdown(reply: FastifyReply, from?: string, to?: string, dimension?: string, scope?: string, companyId?: string, limit?: string, targetLabel?: string): Promise<void>;
     private _oneOf;
     private _range;
 }

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

@@ -1 +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"}
+{"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,EACR,WAAW,CAAC,EAAE,MAAM;IAsB5C,OAAO,CAAC,MAAM;IAOd,OAAO,CAAC,MAAM;CAWf"}

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

@@ -21,7 +21,7 @@ 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 DIMENSIONS = ["company", "user", "operation", "target"];
 const SCOPES = ["customer", "platform"];
 const DEFAULT_WINDOW_DAYS = 30;
 const ONE_DAY_MS = 24 * 60 * 60 * 1000;
@@ -57,7 +57,7 @@ let TokenUsageAdminController = class TokenUsageAdminController {
             companyId,
         }));
     }
-    async getBreakdown(reply, from, to, dimension, scope, companyId, limit) {
+    async getBreakdown(reply, from, to, dimension, scope, companyId, limit, targetLabel) {
         const range = this._range(from, to);
         const parsedLimit = limit === undefined ? 10 : Number(limit);
         if (!Number.isInteger(parsedLimit) || parsedLimit < 1 || parsedLimit > 100)
@@ -65,6 +65,10 @@ let TokenUsageAdminController = class TokenUsageAdminController {
         reply.send(await this.service.getBreakdown({
             ...range,
             dimension: this._oneOf(dimension, DIMENSIONS, "company"),
+            // Passed through raw on purpose: the allowlist is application-specific
+            // and injected into the repository, which is the single place that
+            // validates it. Do not add a second allowlist here.
+            targetLabel,
             scope: this._oneOf(scope, SCOPES, "customer"),
             companyId,
             limit: parsedLimit,
@@ -124,8 +128,9 @@ __decorate([
     __param(4, (0, common_1.Query)("scope")),
     __param(5, (0, common_1.Query)("companyId")),
     __param(6, (0, common_1.Query)("limit")),
+    __param(7, (0, common_1.Query)("targetLabel")),
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", [Object, String, String, String, String, String, String]),
+    __metadata("design:paramtypes", [Object, String, String, String, String, String, String, String]),
     __metadata("design:returntype", Promise)
 ], TokenUsageAdminController.prototype, "getBreakdown", null);
 exports.TokenUsageAdminController = TokenUsageAdminController = __decorate([

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

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

@@ -0,0 +1,35 @@
+import { FastifyReply } from "fastify";
+import { TokenUsageReportService } from "../services/tokenusage.report.service";
+/**
+ * Self-service token-usage reporting: the caller's own company only.
+ *
+ * NO @Roles decorator anywhere — any authenticated user may read their own
+ * company's usage. Scoping is the repository's job (buildDefaultMatch injects
+ * the CLS company), and no route here accepts a companyId, so there is nothing
+ * for a caller to point at somebody else's data.
+ *
+ * `metric` is allowlisted to credits and tokens: COST IS DELIBERATELY ABSENT.
+ * Customers are billed in credits, and exposing the platform's monetary cost
+ * would leak margin — enforcing that only in the UI would leave it one query
+ * string away, so the boundary refuses it.
+ *
+ * Mounted at /tokenusages/reports/* — no overlap with /tokenusages,
+ * /tokenusages/summary, /tokenusages/aggregated (a consuming app's own routes)
+ * or /tokenusages/administration/*, so importing TokenUsageModule cannot
+ * duplicate a Fastify route.
+ *
+ * Enum query params are validated against closed allowlists here rather than in
+ * a DTO: DTOs are body validation for POST/PUT/PATCH, and GET filters use bare
+ * @Query params. The allowlist matters — granularity and dimension select a
+ * Cypher clause, they are not bound values.
+ */
+export declare class TokenUsageReportController {
+    private readonly service;
+    constructor(service: TokenUsageReportService);
+    getSummary(reply: FastifyReply, from?: string, to?: string): Promise<void>;
+    getTimeline(reply: FastifyReply, from?: string, to?: string, granularity?: string): Promise<void>;
+    getBreakdown(reply: FastifyReply, from?: string, to?: string, dimension?: string, targetLabel?: string, metric?: string, limit?: string): Promise<void>;
+    private _oneOf;
+    private _range;
+}
+//# sourceMappingURL=tokenusage.report.controller.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tokenusage.report.controller.d.ts","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/controllers/tokenusage.report.controller.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAGvC,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAShF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAEa,0BAA0B;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,uBAAuB;IAGvD,UAAU,CAAQ,KAAK,EAAE,YAAY,EAAiB,IAAI,CAAC,EAAE,MAAM,EAAe,EAAE,CAAC,EAAE,MAAM;IAK7F,WAAW,CACR,KAAK,EAAE,YAAY,EACX,IAAI,CAAC,EAAE,MAAM,EACf,EAAE,CAAC,EAAE,MAAM,EACF,WAAW,CAAC,EAAE,MAAM;IActC,YAAY,CACT,KAAK,EAAE,YAAY,EACX,IAAI,CAAC,EAAE,MAAM,EACf,EAAE,CAAC,EAAE,MAAM,EACJ,SAAS,CAAC,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,MAAM,EACzB,MAAM,CAAC,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,MAAM;IAiBhC,OAAO,CAAC,MAAM;IAOd,OAAO,CAAC,MAAM;CAWf"}

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

@@ -0,0 +1,133 @@
+"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.TokenUsageReportController = void 0;
+const common_1 = require("@nestjs/common");
+const jwt_auth_guard_1 = require("../../../common/guards/jwt.auth.guard");
+const tokenusage_meta_1 = require("../entities/tokenusage.meta");
+const tokenusage_report_service_1 = require("../services/tokenusage.report.service");
+const GRANULARITIES = ["day", "week", "month"];
+const DIMENSIONS = ["operation", "target"];
+const METRICS = ["credits", "tokens"];
+const DEFAULT_WINDOW_DAYS = 30;
+const ONE_DAY_MS = 24 * 60 * 60 * 1000;
+/**
+ * Self-service token-usage reporting: the caller's own company only.
+ *
+ * NO @Roles decorator anywhere — any authenticated user may read their own
+ * company's usage. Scoping is the repository's job (buildDefaultMatch injects
+ * the CLS company), and no route here accepts a companyId, so there is nothing
+ * for a caller to point at somebody else's data.
+ *
+ * `metric` is allowlisted to credits and tokens: COST IS DELIBERATELY ABSENT.
+ * Customers are billed in credits, and exposing the platform's monetary cost
+ * would leak margin — enforcing that only in the UI would leave it one query
+ * string away, so the boundary refuses it.
+ *
+ * Mounted at /tokenusages/reports/* — no overlap with /tokenusages,
+ * /tokenusages/summary, /tokenusages/aggregated (a consuming app's own routes)
+ * or /tokenusages/administration/*, so importing TokenUsageModule cannot
+ * duplicate a Fastify route.
+ *
+ * Enum query params are validated against closed allowlists here rather than in
+ * a DTO: DTOs are body validation for POST/PUT/PATCH, and GET filters use bare
+ * @Query params. The allowlist matters — granularity and dimension select a
+ * Cypher clause, they are not bound values.
+ */
+let TokenUsageReportController = class TokenUsageReportController {
+    constructor(service) {
+        this.service = service;
+    }
+    async getSummary(reply, from, to) {
+        reply.send(await this.service.getSummary(this._range(from, to)));
+    }
+    async getTimeline(reply, from, to, granularity) {
+        reply.send(await this.service.getTimeline({
+            ...this._range(from, to),
+            granularity: this._oneOf(granularity, GRANULARITIES, "day"),
+            // Pinned, not accepted: scope and company stacking are meaningless
+            // inside a single tenant, so "type" is the only series this surface has.
+            stackBy: "type",
+        }));
+    }
+    async getBreakdown(reply, from, to, dimension, targetLabel, metric, limit) {
+        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({
+            ...this._range(from, to),
+            dimension: this._oneOf(dimension, DIMENSIONS, "operation"),
+            targetLabel,
+            metric: this._oneOf(metric, METRICS, "credits"),
+            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.TokenUsageReportController = TokenUsageReportController;
+__decorate([
+    (0, common_1.Get)(`${tokenusage_meta_1.tokenUsageMeta.endpoint}/reports/summary`),
+    __param(0, (0, common_1.Res)()),
+    __param(1, (0, common_1.Query)("from")),
+    __param(2, (0, common_1.Query)("to")),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, String, String]),
+    __metadata("design:returntype", Promise)
+], TokenUsageReportController.prototype, "getSummary", null);
+__decorate([
+    (0, common_1.Get)(`${tokenusage_meta_1.tokenUsageMeta.endpoint}/reports/timeline`),
+    __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")),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, String, String, String]),
+    __metadata("design:returntype", Promise)
+], TokenUsageReportController.prototype, "getTimeline", null);
+__decorate([
+    (0, common_1.Get)(`${tokenusage_meta_1.tokenUsageMeta.endpoint}/reports/breakdown`),
+    __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)("targetLabel")),
+    __param(5, (0, common_1.Query)("metric")),
+    __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)
+], TokenUsageReportController.prototype, "getBreakdown", null);
+exports.TokenUsageReportController = TokenUsageReportController = __decorate([
+    (0, common_1.UseGuards)(jwt_auth_guard_1.JwtAuthGuard),
+    (0, common_1.Controller)(),
+    __metadata("design:paramtypes", [tokenusage_report_service_1.TokenUsageReportService])
+], TokenUsageReportController);
+//# sourceMappingURL=tokenusage.report.controller.js.map

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

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

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

@@ -1,4 +1,5 @@
 import { Entity } from "../../../common/abstracts/entity";
+import { UsageMetrics } from "./usage-metric.fields";
 /**
  * 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
@@ -12,15 +13,9 @@ import { Entity } from "../../../common/abstracts/entity";
 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;
-};
+} & UsageMetrics;
 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

@@ -1 +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"}
+{"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;AAG1D,OAAO,EAAqB,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAExE;;;;;;;;;GASG;AACH,MAAM,MAAM,8BAA8B,GAAG,MAAM,GAAG;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC,GAAG,YAAY,CAAC;AAEjB,eAAO,MAAM,kCAAkC,yEAe7C,CAAC"}

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

@@ -3,18 +3,14 @@ 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");
+const usage_metric_fields_1 = require("./usage-metric.fields");
 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 },
+        ...usage_metric_fields_1.usageMetricFields,
         activeUsers: { type: "number" },
         monthlyCredits: { type: "number" },
         availableMonthlyCredits: { type: "number" },

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

@@ -1 +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"}
+{"version":3,"file":"tokenusage-admin-breakdown.js","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/entities/tokenusage-admin-breakdown.ts"],"names":[],"mappings":";;;AACA,yEAAqE;AACrE,uFAAiF;AACjF,+DAAwE;AAoB3D,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,GAAG,uCAAiB;QACpB,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-summary.d.ts

@@ -1,4 +1,5 @@
 import { Entity } from "../../../common/abstracts/entity";
+import { UsageMetrics } from "./usage-metric.fields";
 /**
  * One row of the admin summary: a cost centre observed over one time window.
  *
@@ -13,12 +14,6 @@ import { Entity } from "../../../common/abstracts/entity";
 export type TokenUsageAdminSummaryEntity = Entity & {
     scope: string;
     window: string;
-    cost: number;
-    credits: number;
-    tokensIn: number;
-    tokensOut: number;
-    cached: number;
-    calls: number;
-};
+} & UsageMetrics;
 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

@@ -1 +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"}
+{"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;AAG1D,OAAO,EAAqB,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAExE;;;;;;;;;;GAUG;AACH,MAAM,MAAM,4BAA4B,GAAG,MAAM,GAAG;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,YAAY,CAAC;AAEjB,eAAO,MAAM,gCAAgC,uEAY3C,CAAC"}

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

@@ -3,18 +3,14 @@ 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");
+const usage_metric_fields_1 = require("./usage-metric.fields");
 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 },
+        ...usage_metric_fields_1.usageMetricFields,
     },
     relationships: {},
 });

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

@@ -1 +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"}
+{"version":3,"file":"tokenusage-admin-summary.js","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/entities/tokenusage-admin-summary.ts"],"names":[],"mappings":";;;AACA,yEAAqE;AACrE,mFAA6E;AAC7E,+DAAwE;AAkB3D,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,GAAG,uCAAiB;KACrB;IAED,aAAa,EAAE,EAAE;CAClB,CAAC,CAAC"}

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

@@ -1,4 +1,5 @@
 import { Entity } from "../../../common/abstracts/entity";
+import { UsageMetrics } from "./usage-metric.fields";
 /**
  * One (bucket, series) cell of the usage-over-time chart. Rows are flat; the
  * frontend pivots them into stacked columns.
@@ -11,12 +12,6 @@ import { Entity } from "../../../common/abstracts/entity";
 export type TokenUsageAdminTimelineEntity = Entity & {
     bucket: string;
     series: string;
-    cost: number;
-    credits: number;
-    tokensIn: number;
-    tokensOut: number;
-    cached: number;
-    calls: number;
-};
+} & UsageMetrics;
 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

@@ -1 +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"}
+{"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;AAG1D,OAAO,EAAqB,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAExE;;;;;;;;GAQG;AACH,MAAM,MAAM,6BAA6B,GAAG,MAAM,GAAG;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,YAAY,CAAC;AAEjB,eAAO,MAAM,iCAAiC,wEAY5C,CAAC"}

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

@@ -3,18 +3,14 @@ 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");
+const usage_metric_fields_1 = require("./usage-metric.fields");
 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 },
+        ...usage_metric_fields_1.usageMetricFields,
     },
     relationships: {},
 });

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

@@ -1 +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"}
+{"version":3,"file":"tokenusage-admin-timeline.js","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/entities/tokenusage-admin-timeline.ts"],"names":[],"mappings":";;;AACA,yEAAqE;AACrE,qFAA+E;AAC/E,+DAAwE;AAgB3D,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,GAAG,uCAAiB;KACrB;IAED,aAAa,EAAE,EAAE;CAClB,CAAC,CAAC"}

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

@@ -0,0 +1,20 @@
+import { Entity } from "../../../common/abstracts/entity";
+import { UsageMetrics } from "./usage-metric.fields";
+/**
+ * One ranked row of a self-service breakdown. The same shape serves both
+ * dimensions — operation and target — which is why the two "by-X" panels
+ * collapse into a single `breakdown?dimension=` route.
+ *
+ * Deliberately WITHOUT the administrative breakdown's activeUsers /
+ * monthlyCredits / availableMonthlyCredits: those exist for the company
+ * dimension only, and the self-service page reads the caller's own balances from
+ * CurrentUserContext instead.
+ *
+ * NOT a Neo4j node — serialisation shape only.
+ */
+export type TokenUsageReportBreakdownEntity = Entity & {
+    label: string;
+    sublabel?: string;
+} & UsageMetrics;
+export declare const TokenUsageReportBreakdownDescriptor: import("../../..").EntityDescriptor<TokenUsageReportBreakdownEntity, {}>;
+//# sourceMappingURL=tokenusage-report-breakdown.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tokenusage-report-breakdown.d.ts","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/entities/tokenusage-report-breakdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAG1D,OAAO,EAAqB,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAExE;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,+BAA+B,GAAG,MAAM,GAAG;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,YAAY,CAAC;AAEjB,eAAO,MAAM,mCAAmC,0EAY9C,CAAC"}

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

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokenUsageReportBreakdownDescriptor = void 0;
+const define_entity_1 = require("../../../common/helpers/define-entity");
+const tokenusage_report_breakdown_meta_1 = require("./tokenusage-report-breakdown.meta");
+const usage_metric_fields_1 = require("./usage-metric.fields");
+exports.TokenUsageReportBreakdownDescriptor = (0, define_entity_1.defineEntity)()({
+    ...tokenusage_report_breakdown_meta_1.tokenUsageReportBreakdownMeta,
+    isCompanyScoped: false,
+    fields: {
+        label: { type: "string", required: true },
+        sublabel: { type: "string" },
+        ...usage_metric_fields_1.usageMetricFields,
+    },
+    relationships: {},
+});
+//# sourceMappingURL=tokenusage-report-breakdown.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tokenusage-report-breakdown.js","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/entities/tokenusage-report-breakdown.ts"],"names":[],"mappings":";;;AACA,yEAAqE;AACrE,yFAAmF;AACnF,+DAAwE;AAmB3D,QAAA,mCAAmC,GAAG,IAAA,4BAAY,GAAmC,CAAC;IACjG,GAAG,gEAA6B;IAEhC,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,GAAG,uCAAiB;KACrB;IAED,aAAa,EAAE,EAAE;CAClB,CAAC,CAAC"}

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

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

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

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

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

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tokenUsageReportBreakdownMeta = void 0;
+exports.tokenUsageReportBreakdownMeta = {
+    type: "tokenusage-report-breakdowns",
+    endpoint: "tokenusages/reports/breakdown",
+    nodeName: "tokenUsageReportBreakdown",
+    labelName: "TokenUsageReportBreakdown",
+};
+//# sourceMappingURL=tokenusage-report-breakdown.meta.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tokenusage-report-breakdown.meta.js","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/entities/tokenusage-report-breakdown.meta.ts"],"names":[],"mappings":";;;AAEa,QAAA,6BAA6B,GAAa;IACrD,IAAI,EAAE,8BAA8B;IACpC,QAAQ,EAAE,+BAA+B;IACzC,QAAQ,EAAE,2BAA2B;IACrC,SAAS,EAAE,2BAA2B;CACvC,CAAC"}

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

@@ -0,0 +1,19 @@
+import { Entity } from "../../../common/abstracts/entity";
+import { UsageMetrics } from "./usage-metric.fields";
+/**
+ * One row of the self-service summary: the caller's own company observed over
+ * one time window.
+ *
+ * TWO rows are returned per request — window "current" and "previous" — which is
+ * what lets the KPI tile render both the value and its delta without a second
+ * call. There is no `scope` field: the administrative customer/platform split is
+ * meaningless inside a single tenant.
+ *
+ * NOT a Neo4j node: there is no TokenUsageReportSummary label. It is a
+ * serialisation shape only, exactly like TokenUsageAdminSummaryDescriptor.
+ */
+export type TokenUsageReportSummaryEntity = Entity & {
+    window: string;
+} & UsageMetrics;
+export declare const TokenUsageReportSummaryDescriptor: import("../../..").EntityDescriptor<TokenUsageReportSummaryEntity, {}>;
+//# sourceMappingURL=tokenusage-report-summary.d.ts.map