@carlonicora/nestjs-neo4jsonapi 2.5.2 → 2.7.0

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"tokenusage-report-summary.d.ts","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/entities/tokenusage-report-summary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAG1D,OAAO,EAAqB,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAExE;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,6BAA6B,GAAG,MAAM,GAAG;IACnD,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,YAAY,CAAC;AAEjB,eAAO,MAAM,iCAAiC,wEAW5C,CAAC"}

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

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokenUsageReportSummaryDescriptor = void 0;
+const define_entity_1 = require("../../../common/helpers/define-entity");
+const tokenusage_report_summary_meta_1 = require("./tokenusage-report-summary.meta");
+const usage_metric_fields_1 = require("./usage-metric.fields");
+exports.TokenUsageReportSummaryDescriptor = (0, define_entity_1.defineEntity)()({
+    ...tokenusage_report_summary_meta_1.tokenUsageReportSummaryMeta,
+    isCompanyScoped: false,
+    fields: {
+        window: { type: "string", required: true },
+        ...usage_metric_fields_1.usageMetricFields,
+    },
+    relationships: {},
+});
+//# sourceMappingURL=tokenusage-report-summary.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tokenusage-report-summary.js","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/entities/tokenusage-report-summary.ts"],"names":[],"mappings":";;;AACA,yEAAqE;AACrE,qFAA+E;AAC/E,+DAAwE;AAkB3D,QAAA,iCAAiC,GAAG,IAAA,4BAAY,GAAiC,CAAC;IAC7F,GAAG,4DAA2B;IAE9B,eAAe,EAAE,KAAK;IAEtB,MAAM,EAAE;QACN,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-summary.meta.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"tokenusage-report-summary.meta.d.ts","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/entities/tokenusage-report-summary.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-report-summary.meta.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tokenUsageReportSummaryMeta = void 0;
+exports.tokenUsageReportSummaryMeta = {
+    type: "tokenusage-report-summaries",
+    endpoint: "tokenusages/reports/summary",
+    nodeName: "tokenUsageReportSummary",
+    labelName: "TokenUsageReportSummary",
+};
+//# sourceMappingURL=tokenusage-report-summary.meta.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tokenusage-report-summary.meta.js","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/entities/tokenusage-report-summary.meta.ts"],"names":[],"mappings":";;;AAEa,QAAA,2BAA2B,GAAa;IACnD,IAAI,EAAE,6BAA6B;IACnC,QAAQ,EAAE,6BAA6B;IACvC,QAAQ,EAAE,yBAAyB;IACnC,SAAS,EAAE,yBAAyB;CACrC,CAAC"}

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

@@ -0,0 +1,17 @@
+import { Entity } from "../../../common/abstracts/entity";
+import { UsageMetrics } from "./usage-metric.fields";
+/**
+ * One (bucket, series) cell of the self-service usage-over-time chart. Rows are
+ * flat; the frontend pivots them into stacked columns.
+ *
+ * `bucket` is a calendar day 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.
+ */
+export type TokenUsageReportTimelineEntity = Entity & {
+    bucket: string;
+    series: string;
+} & UsageMetrics;
+export declare const TokenUsageReportTimelineDescriptor: import("../../..").EntityDescriptor<TokenUsageReportTimelineEntity, {}>;
+//# sourceMappingURL=tokenusage-report-timeline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tokenusage-report-timeline.d.ts","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/entities/tokenusage-report-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,8BAA8B,GAAG,MAAM,GAAG;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,YAAY,CAAC;AAEjB,eAAO,MAAM,kCAAkC,yEAY7C,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"tokenusage-report-timeline.js","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/entities/tokenusage-report-timeline.ts"],"names":[],"mappings":";;;AACA,yEAAqE;AACrE,uFAAiF;AACjF,+DAAwE;AAgB3D,QAAA,kCAAkC,GAAG,IAAA,4BAAY,GAAkC,CAAC;IAC/F,GAAG,8DAA4B;IAE/B,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-timeline.meta.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"tokenusage-report-timeline.meta.d.ts","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/entities/tokenusage-report-timeline.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-report-timeline.meta.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tokenUsageReportTimelineMeta = void 0;
+exports.tokenUsageReportTimelineMeta = {
+    type: "tokenusage-report-timelines",
+    endpoint: "tokenusages/reports/timeline",
+    nodeName: "tokenUsageReportTimeline",
+    labelName: "TokenUsageReportTimeline",
+};
+//# sourceMappingURL=tokenusage-report-timeline.meta.js.map

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

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

package/dist/foundations/tokenusage/entities/usage-metric.fields.d.ts

@@ -0,0 +1,48 @@
+/**
+ * The six metric fields every token-usage reporting resource exposes.
+ *
+ * Declared once and spread into all six descriptors (three administrative,
+ * three self-service) so the two surfaces cannot drift apart. Spreading a shared
+ * `fields` object is an established pattern in this codebase — a consuming app's
+ * ExtendedTokenUsageDescriptor already does `fields: { ...TokenUsageDescriptor.fields }`.
+ *
+ * The `as const` is per FIELD, not on the whole object: it pins `type` to a
+ * string literal (which defineEntity needs to infer the entity shape) while
+ * leaving each field object mutable, which a whole-object `as const` would not.
+ */
+export declare const usageMetricFields: {
+    cost: {
+        type: "number";
+        required: boolean;
+    };
+    credits: {
+        type: "number";
+        required: boolean;
+    };
+    tokensIn: {
+        type: "number";
+        required: boolean;
+    };
+    tokensOut: {
+        type: "number";
+        required: boolean;
+    };
+    cached: {
+        type: "number";
+        required: boolean;
+    };
+    calls: {
+        type: "number";
+        required: boolean;
+    };
+};
+/** The metric half of every reporting entity type. */
+export type UsageMetrics = {
+    cost: number;
+    credits: number;
+    tokensIn: number;
+    tokensOut: number;
+    cached: number;
+    calls: number;
+};
+//# sourceMappingURL=usage-metric.fields.d.ts.map