@carlonicora/nestjs-neo4jsonapi 1.116.0 → 1.118.0

package/dist/foundations/tokenusage/repositories/tokenusage.repository.js

@@ -27,17 +27,41 @@ const tokenusage_meta_1 = require("../../tokenusage/entities/tokenusage.meta");
  * never by a registry lookup: Nest constructs providers long before
  * `onModuleInit`, where models are registered.
  *
- * `onModuleInit` is INHERITED rather than declared: `AbstractRepository.onModuleInit`
- * emits `CREATE CONSTRAINT tokenusage_id IF NOT EXISTS FOR (tokenusage:TokenUsage)
+ * `onModuleInit` DELEGATES to `AbstractRepository.onModuleInit` first, which emits
+ * `CREATE CONSTRAINT tokenusage_id IF NOT EXISTS FOR (tokenusage:TokenUsage)
  * REQUIRE tokenusage.id IS UNIQUE` from `descriptor.constraints` — byte-identical to
  * the constraint this repository used to declare by hand — plus the FULLTEXT index
- * derived from the descriptor's string fields.
+ * derived from the descriptor's string fields. It then adds the one index the
+ * descriptor cannot express; see the override below.
  */
 let TokenUsageRepository = class TokenUsageRepository extends abstract_repository_1.AbstractRepository {
     constructor(neo4j, securityService, clsService) {
         super(neo4j, securityService, clsService);
         this.descriptor = tokenusage_1.TokenUsageDescriptor;
     }
+    /**
+     * Adds the range index every date-filtered finder here depends on —
+     * findByCompany, findAggregatedByDateAndType, findUsageSummary, and the
+     * cross-tenant admin queries in TokenUsageAdminRepository. Without it each of
+     * them scans the whole :TokenUsage label, which is the fastest-growing label
+     * in the database.
+     *
+     * There is no declarative way to express a non-FULLTEXT index via
+     * defineEntity(): EntityDescriptor.indexes is hard-coded to the string-field
+     * fulltext index, and AbstractRepository.onModuleInit only acts on
+     * type === "FULLTEXT". Hence the explicit override — same pattern, and same
+     * stated reason, as UserActivityRepository.
+     *
+     * super.onModuleInit() MUST be called first: it creates the descriptor-derived
+     * id constraint and fulltext index. Dropping it would silently remove both.
+     */
+    async onModuleInit() {
+        await super.onModuleInit();
+        const { nodeName, labelName } = this.descriptor.model;
+        await this.neo4j.writeOne({
+            query: `CREATE INDEX ${nodeName}_createdAt IF NOT EXISTS FOR (${nodeName}:${labelName}) ON (${nodeName}.createdAt)`,
+        });
+    }
     /**
      * Custom create (KEPT — "non-standard relationships" rule): USED_FOR's target is
      * polymorphic (any entity label — Content, Chunk, Conversation, ...), which the
@@ -59,7 +83,9 @@ let TokenUsageRepository = class TokenUsageRepository extends abstract_repositor
             cachedInputTokens: params.cachedInputTokens ?? 0,
             relationshipId: params.relationshipId,
             cost: params.cost ?? 0,
+            credits: params.credits ?? 0,
         };
+        // Guarded: initQuery() binds this variable only when the id is in CLS; an unbound CREATE target creates an orphan node.
         query.query += `
       CREATE (${tokenusage_meta_1.tokenUsageMeta.nodeName}:${tokenusage_meta_1.tokenUsageMeta.labelName} {
         id: $id,
@@ -68,17 +94,141 @@ let TokenUsageRepository = class TokenUsageRepository extends abstract_repositor
         outputTokens: $outputTokens,
         cachedInputTokens: $cachedInputTokens,
         cost: $cost,
+        credits: $credits,
         createdAt: datetime(),
         updatedAt: datetime()
       })
-      CREATE (${tokenusage_meta_1.tokenUsageMeta.nodeName})-[:BELONGS_TO]->(company)
-      CREATE (${tokenusage_meta_1.tokenUsageMeta.nodeName})-[:TRIGGERED_BY]->(currentUser)
+      ${query.queryParams.companyId ? `CREATE (${tokenusage_meta_1.tokenUsageMeta.nodeName})-[:BELONGS_TO]->(company)` : ``}
+      ${query.queryParams.currentUserId ? `CREATE (${tokenusage_meta_1.tokenUsageMeta.nodeName})-[:TRIGGERED_BY]->(currentUser)` : ``}
       WITH ${tokenusage_meta_1.tokenUsageMeta.nodeName}
       MATCH (relEntity:${params.relationshipType} {id: $relationshipId})
       CREATE (${tokenusage_meta_1.tokenUsageMeta.nodeName})-[:USED_FOR]->(relEntity)
     `;
         await this.neo4j.writeOne(query);
     }
+    /**
+     * Custom list (KEPT — date-range + tokenUsageType filtering is not expressible via the
+     * inherited descriptor-driven find()). Reuses buildDefaultMatch()/buildReturnStatement()
+     * for company scoping and security consistency.
+     */
+    async findByCompany(params) {
+        const query = this.neo4j.initQuery({ serialiser: tokenusage_1.TokenUsageDescriptor.model, cursor: params.cursor });
+        if (params.startDate) {
+            query.queryParams = { ...query.queryParams, startDate: params.startDate };
+        }
+        if (params.endDate) {
+            query.queryParams = { ...query.queryParams, endDate: params.endDate };
+        }
+        if (params.tokenUsageType) {
+            query.queryParams = { ...query.queryParams, tokenUsageType: params.tokenUsageType };
+        }
+        query.query += `
+      ${this.buildDefaultMatch()}
+      ${this.securityService.userHasAccess({ validator: () => this.buildUserHasAccess() })}
+      ${params.startDate ? `WHERE ${tokenusage_meta_1.tokenUsageMeta.nodeName}.createdAt >= datetime($startDate)` : ""}
+      ${params.endDate ? `${params.startDate ? "AND" : "WHERE"} ${tokenusage_meta_1.tokenUsageMeta.nodeName}.createdAt <= datetime($endDate)` : ""}
+      ${params.tokenUsageType ? `${params.startDate || params.endDate ? "AND" : "WHERE"} ${tokenusage_meta_1.tokenUsageMeta.nodeName}.tokenUsageType = $tokenUsageType` : ""}
+
+      ORDER BY ${tokenusage_meta_1.tokenUsageMeta.nodeName}.createdAt DESC
+      {CURSOR}
+
+      ${this.buildReturnStatement()}
+    `;
+        return this.neo4j.readMany(query);
+    }
+    /**
+     * Aggregation query (KEPT — "aggregations" rule): returns grouped totals, not
+     * TokenUsage entities, so it intentionally bypasses readMany()/the serialiser — there
+     * is nothing to map onto the entity type.
+     */
+    async findAggregatedByDateAndType(params) {
+        const query = this.neo4j.initQuery();
+        if (params.startDate) {
+            query.queryParams = { ...query.queryParams, startDate: params.startDate };
+        }
+        if (params.endDate) {
+            query.queryParams = { ...query.queryParams, endDate: params.endDate };
+        }
+        query.query += `
+      ${this.buildDefaultMatch()}
+      ${params.startDate ? `WHERE ${tokenusage_meta_1.tokenUsageMeta.nodeName}.createdAt >= datetime($startDate)` : ""}
+      ${params.endDate ? `${params.startDate ? "AND" : "WHERE"} ${tokenusage_meta_1.tokenUsageMeta.nodeName}.createdAt <= datetime($endDate)` : ""}
+
+      WITH date(${tokenusage_meta_1.tokenUsageMeta.nodeName}.createdAt) as usageDate,
+           ${tokenusage_meta_1.tokenUsageMeta.nodeName}.tokenUsageType as usageType,
+           ${tokenusage_meta_1.tokenUsageMeta.nodeName}
+
+      RETURN toString(usageDate) as date,
+             usageType as tokenUsageType,
+             round(sum(toFloat(${tokenusage_meta_1.tokenUsageMeta.nodeName}.credits)), 2) as totalCredits,
+             sum(toInteger(${tokenusage_meta_1.tokenUsageMeta.nodeName}.inputTokens)) as totalInputTokens,
+             sum(toInteger(${tokenusage_meta_1.tokenUsageMeta.nodeName}.outputTokens)) as totalOutputTokens,
+             sum(toFloat(${tokenusage_meta_1.tokenUsageMeta.nodeName}.cost)) as totalCost,
+             count(${tokenusage_meta_1.tokenUsageMeta.nodeName}) as count
+      ORDER BY date DESC, tokenUsageType
+    `;
+        const result = await this.neo4j.read(query.query, query.queryParams); // nja-lint-ignore: buildDefaultMatch()-scoped scalar aggregation — non-entity shape
+        return result.records.map((record) => ({
+            // nja-lint-ignore: aggregation rows, not entity nodes
+            date: record.get("date"),
+            tokenUsageType: record.get("tokenUsageType"),
+            totalCredits: this.toNumber(record.get("totalCredits")),
+            totalInputTokens: this.toNumber(record.get("totalInputTokens")),
+            totalOutputTokens: this.toNumber(record.get("totalOutputTokens")),
+            totalCost: this.toNumber(record.get("totalCost")),
+            count: this.toNumber(record.get("count")),
+        }));
+    }
+    /**
+     * Aggregation query (KEPT — see findAggregatedByDateAndType above), single-row totals.
+     */
+    async findUsageSummary(params) {
+        const query = this.neo4j.initQuery();
+        if (params.startDate) {
+            query.queryParams = { ...query.queryParams, startDate: params.startDate };
+        }
+        if (params.endDate) {
+            query.queryParams = { ...query.queryParams, endDate: params.endDate };
+        }
+        query.query += `
+      ${this.buildDefaultMatch()}
+      ${params.startDate ? `WHERE ${tokenusage_meta_1.tokenUsageMeta.nodeName}.createdAt >= datetime($startDate)` : ""}
+      ${params.endDate ? `${params.startDate ? "AND" : "WHERE"} ${tokenusage_meta_1.tokenUsageMeta.nodeName}.createdAt <= datetime($endDate)` : ""}
+
+      RETURN round(sum(toFloat(${tokenusage_meta_1.tokenUsageMeta.nodeName}.credits)), 2) as totalCredits,
+             sum(toInteger(${tokenusage_meta_1.tokenUsageMeta.nodeName}.inputTokens)) as totalInputTokens,
+             sum(toInteger(${tokenusage_meta_1.tokenUsageMeta.nodeName}.outputTokens)) as totalOutputTokens,
+             sum(toFloat(${tokenusage_meta_1.tokenUsageMeta.nodeName}.cost)) as totalCost,
+             count(${tokenusage_meta_1.tokenUsageMeta.nodeName}) as count
+    `;
+        const result = await this.neo4j.read(query.query, query.queryParams); // nja-lint-ignore: buildDefaultMatch()-scoped scalar aggregation — non-entity shape
+        if (result.records.length === 0) {
+            return {
+                totalCredits: 0,
+                totalInputTokens: 0,
+                totalOutputTokens: 0,
+                totalCost: 0,
+                count: 0,
+            };
+        }
+        const record = result.records[0];
+        return {
+            totalCredits: this.toNumber(record.get("totalCredits")),
+            totalInputTokens: this.toNumber(record.get("totalInputTokens")),
+            totalOutputTokens: this.toNumber(record.get("totalOutputTokens")),
+            totalCost: this.toNumber(record.get("totalCost")),
+            count: this.toNumber(record.get("count")),
+        };
+    }
+    toNumber(value) {
+        if (value === null || value === undefined)
+            return 0;
+        if (typeof value === "number")
+            return value;
+        if (typeof value.toNumber === "function")
+            return value.toNumber();
+        return Number(value) || 0;
+    }
 };
 exports.TokenUsageRepository = TokenUsageRepository;
 exports.TokenUsageRepository = TokenUsageRepository = __decorate([

package/dist/foundations/tokenusage/repositories/tokenusage.repository.js.map

@@ -1 +1 @@
-{"version":3,"file":"tokenusage.repository.js","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/repositories/tokenusage.repository.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,2CAAwC;AACxC,2FAAuF;AACvF,8EAA0E;AAC1E,uFAAmF;AACnF,qEAAwF;AACxF,+EAA2E;AAE3E;;;;;;;;;;;;;;;GAeG;AAEI,IAAM,oBAAoB,GAA1B,MAAM,oBAAqB,SAAQ,wCAAyE;IAGjH,YAAY,KAAmB,EAAE,eAAgC,EAAE,UAAsB;QACvF,KAAK,CAAC,KAAK,EAAE,eAAe,EAAE,UAAU,CAAC,CAAC;QAHzB,eAAU,GAAG,iCAAoB,CAAC;IAIrD,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,MAAM,CAAC,MASZ;QACC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;QAErC,KAAK,CAAC,WAAW,GAAG;YAClB,GAAG,KAAK,CAAC,WAAW;YACpB,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,IAAI,CAAC;YAChD,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC;SACvB,CAAC;QAEF,KAAK,CAAC,KAAK,IAAI;gBACH,gCAAc,CAAC,QAAQ,IAAI,gCAAc,CAAC,SAAS;;;;;;;;;;gBAUnD,gCAAc,CAAC,QAAQ;gBACvB,gCAAc,CAAC,QAAQ;aAC1B,gCAAc,CAAC,QAAQ;yBACX,MAAM,CAAC,gBAAgB;gBAChC,gCAAc,CAAC,QAAQ;KAClC,CAAC;QAEF,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;CACF,CAAA;AA5DY,oDAAoB;+BAApB,oBAAoB;IADhC,IAAA,mBAAU,GAAE;qCAIQ,4BAAY,EAAmB,kCAAe,EAAc,uBAAU;GAH9E,oBAAoB,CA4DhC"}
+{"version":3,"file":"tokenusage.repository.js","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/repositories/tokenusage.repository.ts"],"names":[],"mappings":"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"}

package/dist/foundations/tokenusage/services/tokenusage.admin.service.d.ts

@@ -0,0 +1,50 @@
+import { ClsService } from "nestjs-cls";
+import { JsonApiService } from "../../../core/jsonapi/services/jsonapi.service";
+import { AbstractService } from "../../../core/neo4j/abstracts/abstract.service";
+import { TokenUsage, TokenUsageDescriptor } from "../entities/tokenusage";
+import { TokenUsageAdminRepository } from "../repositories/tokenusage.admin.repository";
+/**
+ * Serialises the cross-tenant reporting rollups as JSON:API documents.
+ *
+ * Extends AbstractService with the same generics, descriptor and super()
+ * argument order as its sibling TokenUsageService in this folder, so both
+ * services in the tokenusage foundation are wired identically. The inherited
+ * generic CRUD (find / findById / create / put / patch / delete) is not reachable
+ * from any route on TokenUsageAdminController — the three reporting endpoints are
+ * the whole surface — but is available to a consuming app that mounts its own
+ * controller, exactly as the docblock on TokenUsageService already notes.
+ *
+ * `descriptor` and the inherited `model` are the TokenUsage entity: that is what
+ * the repository reads and what the base class needs to be coherent. The three
+ * methods below deliberately serialise with the AGGREGATE descriptors' models
+ * instead, because their return shapes are rollups, not TokenUsage nodes.
+ *
+ * JSON:API documents are built exclusively by the framework — nothing here
+ * hand-assembles a { data: { type, attributes } } object.
+ */
+export declare class TokenUsageAdminService extends AbstractService<TokenUsage, typeof TokenUsageDescriptor.relationships> {
+    protected readonly tokenUsageAdminRepository: TokenUsageAdminRepository;
+    protected readonly descriptor: import("../../..").EntityDescriptor<TokenUsage, {}>;
+    constructor(jsonApiService: JsonApiService, tokenUsageAdminRepository: TokenUsageAdminRepository, clsService: ClsService);
+    getSummary(params: {
+        from: string;
+        to: string;
+        companyId?: string;
+    }): Promise<any>;
+    getTimeline(params: {
+        from: string;
+        to: string;
+        granularity: "day" | "week" | "month";
+        stackBy: "scope" | "type" | "company";
+        companyId?: string;
+    }): Promise<any>;
+    getBreakdown(params: {
+        from: string;
+        to: string;
+        dimension: "company" | "user" | "operation";
+        scope: "customer" | "platform";
+        companyId?: string;
+        limit: number;
+    }): Promise<any>;
+}
+//# sourceMappingURL=tokenusage.admin.service.d.ts.map

package/dist/foundations/tokenusage/services/tokenusage.admin.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenusage.admin.service.d.ts","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/services/tokenusage.admin.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAI1E,OAAO,EAAE,yBAAyB,EAAE,MAAM,6CAA6C,CAAC;AAExF;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBACa,sBAAuB,SAAQ,eAAe,CAAC,UAAU,EAAE,OAAO,oBAAoB,CAAC,aAAa,CAAC;IAK9G,SAAS,CAAC,QAAQ,CAAC,yBAAyB,EAAE,yBAAyB;IAJzE,SAAS,CAAC,QAAQ,CAAC,UAAU,sDAAwB;gBAGnD,cAAc,EAAE,cAAc,EACX,yBAAyB,EAAE,yBAAyB,EACvE,UAAU,EAAE,UAAU;IAKlB,UAAU,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC;IAUlF,WAAW,CAAC,MAAM,EAAE;QACxB,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,WAAW,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;QACtC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;QACtC,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,GAAG,CAAC;IAYV,YAAY,CAAC,MAAM,EAAE;QACzB,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,SAAS,EAAE,SAAS,GAAG,MAAM,GAAG,WAAW,CAAC;QAC5C,KAAK,EAAE,UAAU,GAAG,UAAU,CAAC;QAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;KACf,GAAG,OAAO,CAAC,GAAG,CAAC;CAYjB"}

package/dist/foundations/tokenusage/services/tokenusage.admin.service.js

@@ -0,0 +1,84 @@
+"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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokenUsageAdminService = void 0;
+const common_1 = require("@nestjs/common");
+const nestjs_cls_1 = require("nestjs-cls");
+const jsonapi_service_1 = require("../../../core/jsonapi/services/jsonapi.service");
+const abstract_service_1 = require("../../../core/neo4j/abstracts/abstract.service");
+const tokenusage_1 = require("../entities/tokenusage");
+const tokenusage_admin_breakdown_1 = require("../entities/tokenusage-admin-breakdown");
+const tokenusage_admin_summary_1 = require("../entities/tokenusage-admin-summary");
+const tokenusage_admin_timeline_1 = require("../entities/tokenusage-admin-timeline");
+const tokenusage_admin_repository_1 = require("../repositories/tokenusage.admin.repository");
+/**
+ * Serialises the cross-tenant reporting rollups as JSON:API documents.
+ *
+ * Extends AbstractService with the same generics, descriptor and super()
+ * argument order as its sibling TokenUsageService in this folder, so both
+ * services in the tokenusage foundation are wired identically. The inherited
+ * generic CRUD (find / findById / create / put / patch / delete) is not reachable
+ * from any route on TokenUsageAdminController — the three reporting endpoints are
+ * the whole surface — but is available to a consuming app that mounts its own
+ * controller, exactly as the docblock on TokenUsageService already notes.
+ *
+ * `descriptor` and the inherited `model` are the TokenUsage entity: that is what
+ * the repository reads and what the base class needs to be coherent. The three
+ * methods below deliberately serialise with the AGGREGATE descriptors' models
+ * instead, because their return shapes are rollups, not TokenUsage nodes.
+ *
+ * JSON:API documents are built exclusively by the framework — nothing here
+ * hand-assembles a { data: { type, attributes } } object.
+ */
+let TokenUsageAdminService = class TokenUsageAdminService extends abstract_service_1.AbstractService {
+    constructor(jsonApiService, tokenUsageAdminRepository, clsService) {
+        super(jsonApiService, tokenUsageAdminRepository, clsService, tokenusage_1.TokenUsageDescriptor.model);
+        this.tokenUsageAdminRepository = tokenUsageAdminRepository;
+        this.descriptor = tokenusage_1.TokenUsageDescriptor;
+    }
+    async getSummary(params) {
+        const rows = await this.tokenUsageAdminRepository.findSummary({
+            from: params.from,
+            to: params.to,
+            companyId: params.companyId,
+        });
+        return this.jsonApiService.buildList(tokenusage_admin_summary_1.TokenUsageAdminSummaryDescriptor.model, rows);
+    }
+    async getTimeline(params) {
+        const rows = await this.tokenUsageAdminRepository.findTimeline({
+            from: params.from,
+            to: params.to,
+            granularity: params.granularity,
+            stackBy: params.stackBy,
+            companyId: params.companyId,
+        });
+        return this.jsonApiService.buildList(tokenusage_admin_timeline_1.TokenUsageAdminTimelineDescriptor.model, rows);
+    }
+    async getBreakdown(params) {
+        const rows = await this.tokenUsageAdminRepository.findBreakdown({
+            from: params.from,
+            to: params.to,
+            dimension: params.dimension,
+            scope: params.scope,
+            companyId: params.companyId,
+            limit: params.limit,
+        });
+        return this.jsonApiService.buildList(tokenusage_admin_breakdown_1.TokenUsageAdminBreakdownDescriptor.model, rows);
+    }
+};
+exports.TokenUsageAdminService = TokenUsageAdminService;
+exports.TokenUsageAdminService = TokenUsageAdminService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [jsonapi_service_1.JsonApiService,
+        tokenusage_admin_repository_1.TokenUsageAdminRepository,
+        nestjs_cls_1.ClsService])
+], TokenUsageAdminService);
+//# sourceMappingURL=tokenusage.admin.service.js.map

package/dist/foundations/tokenusage/services/tokenusage.admin.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenusage.admin.service.js","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/services/tokenusage.admin.service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,2CAAwC;AACxC,oFAAgF;AAChF,qFAAiF;AACjF,uDAA0E;AAC1E,uFAA4F;AAC5F,mFAAwF;AACxF,qFAA0F;AAC1F,6FAAwF;AAExF;;;;;;;;;;;;;;;;;;GAkBG;AAEI,IAAM,sBAAsB,GAA5B,MAAM,sBAAuB,SAAQ,kCAAsE;IAGhH,YACE,cAA8B,EACX,yBAAoD,EACvE,UAAsB;QAEtB,KAAK,CAAC,cAAc,EAAE,yBAAyB,EAAE,UAAU,EAAE,iCAAoB,CAAC,KAAK,CAAC,CAAC;QAHtE,8BAAyB,GAAzB,yBAAyB,CAA2B;QAJtD,eAAU,GAAG,iCAAoB,CAAC;IAQrD,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAwD;QACvE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,yBAAyB,CAAC,WAAW,CAAC;YAC5D,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,SAAS,EAAE,MAAM,CAAC,SAAS;SAC5B,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,2DAAgC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACrF,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,MAMjB;QACC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,yBAAyB,CAAC,YAAY,CAAC;YAC7D,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,SAAS,EAAE,MAAM,CAAC,SAAS;SAC5B,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,6DAAiC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACtF,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,MAOlB;QACC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,yBAAyB,CAAC,aAAa,CAAC;YAC9D,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;SACpB,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,+DAAkC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACvF,CAAC;CACF,CAAA;AA1DY,wDAAsB;iCAAtB,sBAAsB;IADlC,IAAA,mBAAU,GAAE;qCAKO,gCAAc;QACgB,uDAAyB;QAC3D,uBAAU;GANb,sBAAsB,CA0DlC"}

package/dist/foundations/tokenusage/services/tokenusage.service.d.ts

@@ -7,7 +7,7 @@ import { TokenUsageInterface } from "../../../common/interfaces/token.usage.inte
 import { JsonApiService } from "../../../core/jsonapi/services/jsonapi.service";
 import { AbstractService } from "../../../core/neo4j/abstracts/abstract.service";
 import { TokenUsage, TokenUsageDescriptor } from "../../tokenusage/entities/tokenusage";
-import { TokenUsageRepository } from "../../tokenusage/repositories/tokenusage.repository";
+import { TokenUsageAggregated, TokenUsageRepository, TokenUsageSummary } from "../../tokenusage/repositories/tokenusage.repository";
 import { ModelWeight } from "../../../core/llm/enums/model.weight";
 /**
  * TokenUsage service.
@@ -49,6 +49,12 @@ export declare class TokenUsageService extends AbstractService<TokenUsage, typeo
         useVisionCosts?: boolean;
         modelWeight?: ModelWeight;
     }): number;
+    /**
+     * Persists one usage record and converts its monetary cost into billing
+     * credits: `credits = max(minCreditsPerRecord, round2(cost / creditCost))`.
+     * `creditCost` absent or 0 disables credits entirely (records store 0 and no
+     * balance is deducted), so consumers without a `credits` config are unaffected.
+     */
     recordTokenUsage(params: {
         tokens: TokenUsageInterface;
         type: string;
@@ -56,6 +62,36 @@ export declare class TokenUsageService extends AbstractService<TokenUsage, typeo
         relationshipType: string;
         useVisionCosts?: boolean;
         modelWeight?: ModelWeight;
+        /** When false the per-record credits floor (`minCreditsPerRecord`) is skipped — sub-cent calls (embeddings) must not be floored. Defaults to true. */
+        applyMinimum?: boolean;
+        /** Pre-computed cost in euros; when provided `computeCost` is skipped (embeddings: estimated tokens × the embedder rate). */
+        costOverride?: number;
     }): Promise<void>;
+    /**
+     * KEPT (custom filtering not covered by inherited find()): date-range + tokenUsageType
+     * filtering. Backs GET /tokenusages in consuming apps.
+     */
+    findByCompany(params: {
+        query: any;
+        startDate?: string;
+        endDate?: string;
+        tokenUsageType?: string;
+    }): Promise<any>;
+    /**
+     * KEPT (raw aggregation, not JSON:API entities — inherited find()/findById() can't
+     * produce this shape). Backs GET /tokenusages/aggregated in consuming apps.
+     */
+    getUsageByDateAndType(params: {
+        startDate?: string;
+        endDate?: string;
+    }): Promise<TokenUsageAggregated[]>;
+    /**
+     * KEPT (raw aggregation — see getUsageByDateAndType above). Backs GET
+     * /tokenusages/summary in consuming apps.
+     */
+    getUsageSummary(params: {
+        startDate?: string;
+        endDate?: string;
+    }): Promise<TokenUsageSummary>;
 }
 //# sourceMappingURL=tokenusage.service.d.ts.map

package/dist/foundations/tokenusage/services/tokenusage.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tokenusage.service.d.ts","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/services/tokenusage.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpF,OAAO,EAAE,mBAAmB,EAAE,MAAM,kDAAkD,CAAC;AACvF,OAAO,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AACxF,OAAO,EAAE,oBAAoB,EAAE,MAAM,qDAAqD,CAAC;AAC3F,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AAGnE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBACa,iBAAkB,SAAQ,eAAe,CAAC,UAAU,EAAE,OAAO,oBAAoB,CAAC,aAAa,CAAC;IAOzG,SAAS,CAAC,QAAQ,CAAC,oBAAoB,EAAE,oBAAoB;IAE7D,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,mBAAmB,CAAC;IACpE,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,aAAa;IAThD,SAAS,CAAC,QAAQ,CAAC,UAAU,sDAAwB;IAErD,SAAS,CAAC,QAAQ,CAAC,MAAM,SAAsC;gBAG7D,cAAc,EAAE,cAAc,EACX,oBAAoB,EAAE,oBAAoB,EAC7D,UAAU,EAAE,UAAU,EACH,aAAa,EAAE,aAAa,CAAC,mBAAmB,CAAC,EACjD,YAAY,EAAE,aAAa;IAKhD,SAAS,KAAK,QAAQ,IAAI,iBAAiB,CAE1C;IAED,SAAS,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,WAAW;IAW9C;;;;OAIG;IACH,WAAW,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,mBAAmB,CAAC;QAAC,cAAc,CAAC,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,MAAM;IAY3G,gBAAgB,CAAC,MAAM,EAAE;QAC7B,MAAM,EAAE,mBAAmB,CAAC;QAC5B,IAAI,EAAE,MAAM,CAAC;QACb,cAAc,EAAE,MAAM,CAAC;QACvB,gBAAgB,EAAE,MAAM,CAAC;QACzB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,WAAW,CAAC,EAAE,WAAW,CAAC;KAC3B,GAAG,OAAO,CAAC,IAAI,CAAC;CAiClB"}
+{"version":3,"file":"tokenusage.service.d.ts","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/services/tokenusage.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAA0B,MAAM,4BAA4B,CAAC;AAC5G,OAAO,EAAE,mBAAmB,EAAE,MAAM,kDAAkD,CAAC;AAEvF,OAAO,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AACxF,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,qDAAqD,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AAGnE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBACa,iBAAkB,SAAQ,eAAe,CAAC,UAAU,EAAE,OAAO,oBAAoB,CAAC,aAAa,CAAC;IAOzG,SAAS,CAAC,QAAQ,CAAC,oBAAoB,EAAE,oBAAoB;IAE7D,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,mBAAmB,CAAC;IACpE,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,aAAa;IAThD,SAAS,CAAC,QAAQ,CAAC,UAAU,sDAAwB;IAErD,SAAS,CAAC,QAAQ,CAAC,MAAM,SAAsC;gBAG7D,cAAc,EAAE,cAAc,EACX,oBAAoB,EAAE,oBAAoB,EAC7D,UAAU,EAAE,UAAU,EACH,aAAa,EAAE,aAAa,CAAC,mBAAmB,CAAC,EACjD,YAAY,EAAE,aAAa;IAKhD,SAAS,KAAK,QAAQ,IAAI,iBAAiB,CAE1C;IAED,SAAS,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,WAAW;IAW9C;;;;OAIG;IACH,WAAW,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,mBAAmB,CAAC;QAAC,cAAc,CAAC,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,MAAM;IAYjH;;;;;OAKG;IACG,gBAAgB,CAAC,MAAM,EAAE;QAC7B,MAAM,EAAE,mBAAmB,CAAC;QAC5B,IAAI,EAAE,MAAM,CAAC;QACb,cAAc,EAAE,MAAM,CAAC;QACvB,gBAAgB,EAAE,MAAM,CAAC;QACzB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,WAAW,CAAC,EAAE,WAAW,CAAC;QAC1B,sJAAsJ;QACtJ,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,6HAA6H;QAC7H,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,GAAG,OAAO,CAAC,IAAI,CAAC;IA8CjB;;;OAGG;IACG,aAAa,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,GAAG,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE;IAezG;;;OAGG;IACG,qBAAqB,CAAC,MAAM,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAO9G;;;OAGG;IACG,eAAe,CAAC,MAAM,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAMpG"}

package/dist/foundations/tokenusage/services/tokenusage.service.js

@@ -16,6 +16,7 @@ const config_1 = require("@nestjs/config");
 const event_emitter_1 = require("@nestjs/event-emitter");
 const crypto_1 = require("crypto");
 const nestjs_cls_1 = require("nestjs-cls");
+const jsonapi_paginator_1 = require("../../../core/jsonapi/serialisers/jsonapi.paginator");
 const jsonapi_service_1 = require("../../../core/jsonapi/services/jsonapi.service");
 const abstract_service_1 = require("../../../core/neo4j/abstracts/abstract.service");
 const tokenusage_1 = require("../../tokenusage/entities/tokenusage");
@@ -81,12 +82,26 @@ let TokenUsageService = TokenUsageService_1 = class TokenUsageService extends ab
         const cost = uncachedInput * inputRate + cached * cachedRate + params.tokens.output * outputRate;
         return cost / 1_000_000;
     }
+    /**
+     * Persists one usage record and converts its monetary cost into billing
+     * credits: `credits = max(minCreditsPerRecord, round2(cost / creditCost))`.
+     * `creditCost` absent or 0 disables credits entirely (records store 0 and no
+     * balance is deducted), so consumers without a `credits` config are unaffected.
+     */
     async recordTokenUsage(params) {
-        const cost = this.computeCost({
-            tokens: params.tokens,
-            useVisionCosts: params.useVisionCosts,
-            modelWeight: params.modelWeight,
-        });
+        const cost = params.costOverride ??
+            this.computeCost({
+                tokens: params.tokens,
+                useVisionCosts: params.useVisionCosts,
+                modelWeight: params.modelWeight,
+            });
+        const creditsConfig = this.configService.get("credits");
+        let credits = 0;
+        if (creditsConfig && creditsConfig.creditCost > 0) {
+            credits = Math.round((cost / creditsConfig.creditCost) * 100) / 100;
+            if (params.applyMinimum !== false)
+                credits = Math.max(creditsConfig.minCreditsPerRecord, credits);
+        }
         await this.tokenUsageRepository.create({
             id: (0, crypto_1.randomUUID)(),
             tokenUsageType: params.type,
@@ -94,6 +109,7 @@ let TokenUsageService = TokenUsageService_1 = class TokenUsageService extends ab
             outputTokens: params.tokens.output,
             cachedInputTokens: params.tokens.cached ?? 0,
             cost: cost,
+            credits: credits,
             relationshipId: params.relationshipId,
             relationshipType: params.relationshipType,
         });
@@ -104,6 +120,8 @@ let TokenUsageService = TokenUsageService_1 = class TokenUsageService extends ab
             const payload = {
                 input: params.tokens.input,
                 output: params.tokens.output,
+                cost: cost,
+                credits: credits,
             };
             this.eventEmitter.emit(tokenusage_events_1.TOKEN_USAGE_RECORDED_EVENT, payload);
         }
@@ -111,6 +129,39 @@ let TokenUsageService = TokenUsageService_1 = class TokenUsageService extends ab
             this.logger.warn(`Failed to emit ${tokenusage_events_1.TOKEN_USAGE_RECORDED_EVENT}: ${error instanceof Error ? error.message : String(error)}`);
         }
     }
+    /**
+     * KEPT (custom filtering not covered by inherited find()): date-range + tokenUsageType
+     * filtering. Backs GET /tokenusages in consuming apps.
+     */
+    async findByCompany(params) {
+        const paginator = new jsonapi_paginator_1.JsonApiPaginator(params.query);
+        return this.jsonApiService.buildList(tokenusage_1.TokenUsageDescriptor.model, await this.tokenUsageRepository.findByCompany({
+            startDate: params.startDate,
+            endDate: params.endDate,
+            tokenUsageType: params.tokenUsageType,
+            cursor: paginator.generateCursor(),
+        }), paginator);
+    }
+    /**
+     * KEPT (raw aggregation, not JSON:API entities — inherited find()/findById() can't
+     * produce this shape). Backs GET /tokenusages/aggregated in consuming apps.
+     */
+    async getUsageByDateAndType(params) {
+        return this.tokenUsageRepository.findAggregatedByDateAndType({
+            startDate: params.startDate,
+            endDate: params.endDate,
+        });
+    }
+    /**
+     * KEPT (raw aggregation — see getUsageByDateAndType above). Backs GET
+     * /tokenusages/summary in consuming apps.
+     */
+    async getUsageSummary(params) {
+        return this.tokenUsageRepository.findUsageSummary({
+            startDate: params.startDate,
+            endDate: params.endDate,
+        });
+    }
 };
 exports.TokenUsageService = TokenUsageService;
 exports.TokenUsageService = TokenUsageService = TokenUsageService_1 = __decorate([

package/dist/foundations/tokenusage/services/tokenusage.service.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"tokenusage.module.d.ts","sourceRoot":"","sources":["../../../src/foundations/tokenusage/tokenusage.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAMtD,qBAMa,gBAAiB,YAAW,YAAY;IACnD,YAAY;CAGb"}
+{"version":3,"file":"tokenusage.module.d.ts","sourceRoot":"","sources":["../../../src/foundations/tokenusage/tokenusage.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAYtD,qBAea,gBAAiB,YAAW,YAAY;IACnD,YAAY;CAMb"}

package/dist/foundations/tokenusage/tokenusage.module.js

@@ -9,20 +9,38 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.TokenUsageModule = void 0;
 const common_1 = require("@nestjs/common");
 const registry_1 = require("../../common/registries/registry");
+const tokenusage_admin_controller_1 = require("./controllers/tokenusage.admin.controller");
 const tokenusage_1 = require("./entities/tokenusage");
+const tokenusage_admin_breakdown_1 = require("./entities/tokenusage-admin-breakdown");
+const tokenusage_admin_summary_1 = require("./entities/tokenusage-admin-summary");
+const tokenusage_admin_timeline_1 = require("./entities/tokenusage-admin-timeline");
+const tokenusage_admin_repository_1 = require("./repositories/tokenusage.admin.repository");
 const tokenusage_repository_1 = require("./repositories/tokenusage.repository");
+const tokenusage_admin_service_1 = require("./services/tokenusage.admin.service");
 const tokenusage_service_1 = require("./services/tokenusage.service");
 let TokenUsageModule = class TokenUsageModule {
     onModuleInit() {
         registry_1.modelRegistry.register(tokenusage_1.TokenUsageDescriptor.model);
+        registry_1.modelRegistry.register(tokenusage_admin_summary_1.TokenUsageAdminSummaryDescriptor.model);
+        registry_1.modelRegistry.register(tokenusage_admin_timeline_1.TokenUsageAdminTimelineDescriptor.model);
+        registry_1.modelRegistry.register(tokenusage_admin_breakdown_1.TokenUsageAdminBreakdownDescriptor.model);
     }
 };
 exports.TokenUsageModule = TokenUsageModule;
 exports.TokenUsageModule = TokenUsageModule = __decorate([
     (0, common_1.Module)({
-        controllers: [],
-        providers: [tokenusage_1.TokenUsageDescriptor.model.serialiser, tokenusage_repository_1.TokenUsageRepository, tokenusage_service_1.TokenUsageService],
-        exports: [tokenusage_service_1.TokenUsageService],
+        controllers: [tokenusage_admin_controller_1.TokenUsageAdminController],
+        providers: [
+            tokenusage_1.TokenUsageDescriptor.model.serialiser,
+            tokenusage_admin_summary_1.TokenUsageAdminSummaryDescriptor.model.serialiser,
+            tokenusage_admin_timeline_1.TokenUsageAdminTimelineDescriptor.model.serialiser,
+            tokenusage_admin_breakdown_1.TokenUsageAdminBreakdownDescriptor.model.serialiser,
+            tokenusage_repository_1.TokenUsageRepository,
+            tokenusage_admin_repository_1.TokenUsageAdminRepository,
+            tokenusage_service_1.TokenUsageService,
+            tokenusage_admin_service_1.TokenUsageAdminService,
+        ],
+        exports: [tokenusage_service_1.TokenUsageService, tokenusage_admin_service_1.TokenUsageAdminService],
         imports: [],
     })
 ], TokenUsageModule);

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

@@ -1 +1 @@
-{"version":3,"file":"tokenusage.module.js","sourceRoot":"","sources":["../../../src/foundations/tokenusage/tokenusage.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAsD;AACtD,+DAAiE;AACjE,sDAA6D;AAC7D,gFAA4E;AAC5E,sEAAkE;AAQ3D,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;IAC3B,YAAY;QACV,wBAAa,CAAC,QAAQ,CAAC,iCAAoB,CAAC,KAAK,CAAC,CAAC;IACrD,CAAC;CACF,CAAA;AAJY,4CAAgB;2BAAhB,gBAAgB;IAN5B,IAAA,eAAM,EAAC;QACN,WAAW,EAAE,EAAE;QACf,SAAS,EAAE,CAAC,iCAAoB,CAAC,KAAK,CAAC,UAAU,EAAE,4CAAoB,EAAE,sCAAiB,CAAC;QAC3F,OAAO,EAAE,CAAC,sCAAiB,CAAC;QAC5B,OAAO,EAAE,EAAE;KACZ,CAAC;GACW,gBAAgB,CAI5B"}
+{"version":3,"file":"tokenusage.module.js","sourceRoot":"","sources":["../../../src/foundations/tokenusage/tokenusage.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAsD;AACtD,+DAAiE;AACjE,2FAAsF;AACtF,sDAA6D;AAC7D,sFAA2F;AAC3F,kFAAuF;AACvF,oFAAyF;AACzF,4FAAuF;AACvF,gFAA4E;AAC5E,kFAA6E;AAC7E,sEAAkE;AAiB3D,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;IAC3B,YAAY;QACV,wBAAa,CAAC,QAAQ,CAAC,iCAAoB,CAAC,KAAK,CAAC,CAAC;QACnD,wBAAa,CAAC,QAAQ,CAAC,2DAAgC,CAAC,KAAK,CAAC,CAAC;QAC/D,wBAAa,CAAC,QAAQ,CAAC,6DAAiC,CAAC,KAAK,CAAC,CAAC;QAChE,wBAAa,CAAC,QAAQ,CAAC,+DAAkC,CAAC,KAAK,CAAC,CAAC;IACnE,CAAC;CACF,CAAA;AAPY,4CAAgB;2BAAhB,gBAAgB;IAf5B,IAAA,eAAM,EAAC;QACN,WAAW,EAAE,CAAC,uDAAyB,CAAC;QACxC,SAAS,EAAE;YACT,iCAAoB,CAAC,KAAK,CAAC,UAAU;YACrC,2DAAgC,CAAC,KAAK,CAAC,UAAU;YACjD,6DAAiC,CAAC,KAAK,CAAC,UAAU;YAClD,+DAAkC,CAAC,KAAK,CAAC,UAAU;YACnD,4CAAoB;YACpB,uDAAyB;YACzB,sCAAiB;YACjB,iDAAsB;SACvB;QACD,OAAO,EAAE,CAAC,sCAAiB,EAAE,iDAAsB,CAAC;QACpD,OAAO,EAAE,EAAE;KACZ,CAAC;GACW,gBAAgB,CAO5B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@carlonicora/nestjs-neo4jsonapi",
-  "version": "1.116.0",
+  "version": "1.118.0",
   "description": "NestJS foundation package with JSON:API, Neo4j, Redis, LangChain agents, and common utilities",
   "author": "Carlo Nicora",
   "license": "GPL-3.0-or-later",
@@ -107,6 +107,7 @@
     "gray-matter": "^4.0.3",
     "handlebars": "^4.7.9",
     "ioredis": "^5.11.1",
+    "js-tiktoken": "^1.0.21",
     "js-yaml": "^5.2.2",
     "jszip": "^3.10.1",
     "langsmith": "^0.8.8",