@carlonicora/nestjs-neo4jsonapi 2.5.2 → 2.7.0

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

@@ -0,0 +1,286 @@
+"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.TokenUsageReportRepository = void 0;
+const common_1 = require("@nestjs/common");
+const nestjs_cls_1 = require("nestjs-cls");
+const abstract_repository_1 = require("../../../core/neo4j/abstracts/abstract.repository");
+const neo4j_service_1 = require("../../../core/neo4j/services/neo4j.service");
+const security_service_1 = require("../../../core/security/services/security.service");
+const tokenusage_target_labels_1 = require("../common/tokenusage.target-labels");
+const tokenusage_1 = require("../entities/tokenusage");
+const tokenusage_meta_1 = require("../entities/tokenusage.meta");
+const NODE = tokenusage_meta_1.tokenUsageMeta.nodeName; // "tokenusage"
+/**
+ * The date.truncate units this repository may emit, keyed by granularity. A
+ * lookup rather than an interpolation of the caller's string: nothing that did
+ * not come from this table can ever reach the query text.
+ */
+const TRUNCATION_UNITS = {
+    week: "week",
+    month: "month",
+};
+/** The metric column each breakdown orders by. Same closed-lookup rule. */
+const ORDER_COLUMNS = {
+    credits: "credits",
+    tokens: "tokens",
+};
+/**
+ * Self-service token-usage reporting: the caller's OWN company, nothing else.
+ *
+ * This is the deliberate mirror image of TokenUsageAdminRepository. That class
+ * carries a file-level lint-ignore and omits buildDefaultMatch() because a
+ * platform-wide dashboard must not be scoped to the caller. THIS class must be
+ * scoped, so every query below goes through buildDefaultMatch(), which injects
+ * the CLS company filter. There is deliberately no file-level ignore header
+ * here, and no companyId parameter anywhere in this file: a self-service caller
+ * cannot name a company, so there is nothing to spoof.
+ *
+ * Rollup RETURNs are scalar columns, not graph nodes, so readOne()/readMany()
+ * cannot map them - entityFactory.createGraphList expects nodes. Same shape and
+ * same rationale as TokenUsageRepository.findAggregatedByDateAndType in this
+ * folder, which is the canonical company-scoped aggregation.
+ *
+ * EVERY traversal constrains its target label. The company traversal inherits
+ * the label constraint from Neo4jService.initQuery()'s preamble, which binds
+ * (company:Company {id: $companyId}); the target traversal below constrains
+ * (grp:<AllowlistedLabel>). The write bug fixed in tokenusage.repository.ts left
+ * label-less nodes on exactly these relationships, and an unconstrained match
+ * returns them.
+ *
+ * It does NOT override onModuleInit: the :TokenUsage indexes belong to
+ * TokenUsageRepository, and duplicating the CREATE INDEX would be a second
+ * writer for one schema object.
+ */
+let TokenUsageReportRepository = class TokenUsageReportRepository extends abstract_repository_1.AbstractRepository {
+    constructor(neo4j, securityService, clsService, targetLabels = []) {
+        super(neo4j, securityService, clsService);
+        this.targetLabels = targetLabels;
+        this.descriptor = tokenusage_1.TokenUsageDescriptor;
+    }
+    /**
+     * Two rows: the requested window and the equal-length span immediately
+     * preceding it, which is what the KPI tile's delta is measured against.
+     *
+     * Both rows are ALWAYS returned, zero-filled when the database has nothing —
+     * the tiles then never have to branch on a missing window.
+     */
+    async findSummary(params) {
+        const span = new Date(params.to).getTime() - new Date(params.from).getTime();
+        const previousFrom = new Date(new Date(params.from).getTime() - span).toISOString();
+        const query = this.neo4j.initQuery();
+        query.queryParams = { ...query.queryParams, from: params.from, to: params.to, previousFrom };
+        query.query += `
+      ${this.buildDefaultMatch()}
+      WHERE ${NODE}.createdAt >= datetime($previousFrom) AND ${NODE}.createdAt <= datetime($to)
+
+      WITH ${NODE},
+           CASE WHEN ${NODE}.createdAt >= datetime($from) THEN 'current' ELSE 'previous' END AS window
+
+      RETURN window                                       AS window,
+             ${this._metricProjection()}
+    `;
+        const result = await this.neo4j.read(query.query, query.queryParams); // nja-lint-ignore: buildDefaultMatch()-scoped scalar aggregation — non-entity shape
+        const found = new Map();
+        for (const record of result.records) {
+            // nja-lint-ignore: aggregation rows, not entity nodes
+            const window = record.get("window");
+            found.set(window, { id: window, window, ...this._metrics(record) });
+        }
+        return ["current", "previous"].map((window) => found.get(window) ??
+            {
+                id: window,
+                window,
+                cost: 0,
+                credits: 0,
+                tokensIn: 0,
+                tokensOut: 0,
+                cached: 0,
+                calls: 0,
+            });
+    }
+    /**
+     * One row per (bucket, operation type). `stackBy` is accepted for signature
+     * parity with the administrative timeline but only "type" is meaningful inside
+     * a single tenant, so it is not interpolated anywhere.
+     */
+    async findTimeline(params) {
+        const query = this.neo4j.initQuery();
+        query.queryParams = { ...query.queryParams, from: params.from, to: params.to };
+        const unit = params.granularity === "day" ? undefined : TRUNCATION_UNITS[params.granularity];
+        const bucketExpression = unit ? `date.truncate('${unit}', date(${NODE}.createdAt))` : `date(${NODE}.createdAt)`;
+        query.query += `
+      ${this.buildDefaultMatch()}
+      WHERE ${NODE}.createdAt >= datetime($from) AND ${NODE}.createdAt <= datetime($to)
+
+      WITH ${NODE},
+           ${bucketExpression}          AS bucket,
+           ${NODE}.tokenUsageType       AS series
+
+      RETURN toString(bucket)                             AS bucket,
+             series                                       AS series,
+             ${this._metricProjection()}
+      ORDER BY bucket ASC, series ASC
+    `;
+        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
+            const bucket = record.get("bucket");
+            const series = record.get("series");
+            return {
+                id: `${bucket}|${series}`,
+                bucket,
+                series,
+                ...this._metrics(record),
+            };
+        });
+    }
+    /**
+     * Ranked rows for one dimension, ordered by the SELECTED metric.
+     *
+     * Ordering by the selected metric rather than unconditionally by cost is not
+     * cosmetic: credits are max(minCreditsPerRecord, round4(cost / creditCost)),
+     * and that floor breaks proportionality for cheap calls — so a credits panel
+     * ranked by cost is visibly mis-ordered whenever the two diverge.
+     *
+     * Everything past `limit` is folded into a single "other" row so the shares
+     * still sum to 100 percent.
+     */
+    async findBreakdown(params) {
+        let grouping;
+        let projection;
+        if (params.dimension === "target") {
+            // Label and relationship types come from the allowlist, not the request —
+            // see _resolveTarget and normaliseTargetLabel.
+            grouping = (0, tokenusage_target_labels_1.buildTargetGrouping)({
+                target: this._resolveTarget(params.targetLabel),
+                nodeName: NODE,
+                carried: [],
+            });
+            projection = `
+             grp.id                        AS id,
+             coalesce(grp.name, grp.title) AS label,
+             null                          AS sublabel,`;
+        }
+        else {
+            grouping = `WITH ${NODE}, ${NODE}.tokenUsageType AS grp`;
+            projection = `
+             grp                           AS id,
+             grp                           AS label,
+             null                          AS sublabel,`;
+        }
+        const query = this.neo4j.initQuery();
+        query.queryParams = { ...query.queryParams, from: params.from, to: params.to };
+        query.query += `
+      ${this.buildDefaultMatch()}
+      WHERE ${NODE}.createdAt >= datetime($from) AND ${NODE}.createdAt <= datetime($to)
+      ${grouping}
+
+      RETURN ${projection}
+             ${this._metricProjection()}
+      ORDER BY ${ORDER_COLUMNS[params.metric]} DESC
+    `;
+        const result = await this.neo4j.read(query.query, query.queryParams); // nja-lint-ignore: buildDefaultMatch()-scoped scalar aggregation — non-entity shape
+        const all = result.records.map((record) => {
+            // nja-lint-ignore: aggregation rows, not entity nodes
+            const sublabel = record.get("sublabel");
+            return {
+                id: record.get("id") ?? "unknown",
+                label: record.get("label") ?? record.get("id") ?? "unknown",
+                ...(sublabel ? { sublabel: sublabel } : {}),
+                ...this._metrics(record),
+            };
+        });
+        if (all.length <= params.limit)
+            return all;
+        const kept = all.slice(0, params.limit);
+        const folded = all.slice(params.limit);
+        kept.push({
+            id: "other",
+            label: "other",
+            cost: folded.reduce((sum, row) => sum + row.cost, 0),
+            credits: folded.reduce((sum, row) => sum + row.credits, 0),
+            tokensIn: folded.reduce((sum, row) => sum + row.tokensIn, 0),
+            tokensOut: folded.reduce((sum, row) => sum + row.tokensOut, 0),
+            cached: folded.reduce((sum, row) => sum + row.cached, 0),
+            calls: folded.reduce((sum, row) => sum + row.calls, 0),
+        });
+        return kept;
+    }
+    /**
+     * The six metric columns, identical in all three queries.
+     *
+     * `tokens` is projected as a column of its own so ORDER BY can name it — a
+     * Cypher ORDER BY cannot reference an expression built from two aggregates
+     * unless that expression is itself projected.
+     */
+    _metricProjection() {
+        return `
+             sum(toFloat(${NODE}.cost))                  AS cost,
+             sum(toFloat(${NODE}.credits))               AS credits,
+             sum(toInteger(${NODE}.inputTokens))         AS tokensIn,
+             sum(toInteger(${NODE}.outputTokens))        AS tokensOut,
+             sum(toInteger(${NODE}.cachedInputTokens))   AS cached,
+             count(${NODE})                              AS calls,
+             sum(toInteger(${NODE}.inputTokens)) + sum(toInteger(${NODE}.outputTokens)) AS tokens`;
+    }
+    _metrics(record) {
+        return {
+            cost: this.toNumber(record.get("cost")),
+            credits: this.toNumber(record.get("credits")),
+            tokensIn: this.toNumber(record.get("tokensIn")),
+            tokensOut: this.toNumber(record.get("tokensOut")),
+            cached: this.toNumber(record.get("cached")),
+            calls: this.toNumber(record.get("calls")),
+        };
+    }
+    /**
+     * Resolves the requested label against the host application's allowlist and
+     * returns the ALLOWLIST'S OWN string, never the caller's. An empty allowlist
+     * means the app never opted in, so every target request is refused.
+     */
+    _resolveTarget(requested) {
+        const available = this.targetLabels.map(tokenusage_target_labels_1.normaliseTargetLabel);
+        const match = available.find((target) => target.label === requested);
+        if (!match)
+            throw new common_1.BadRequestException(available.length === 0
+                ? "dimension=target is not enabled for this application"
+                : `targetLabel must be one of ${available.map((target) => target.label).join(", ")}`);
+        return match;
+    }
+    /**
+     * Neo4j hands integers back as driver Integer objects. Same helper, same
+     * shape, as TokenUsageRepository.toNumber — AbstractRepository does not
+     * provide one, and the aggregation path is the only place that needs it.
+     */
+    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.TokenUsageReportRepository = TokenUsageReportRepository;
+exports.TokenUsageReportRepository = TokenUsageReportRepository = __decorate([
+    (0, common_1.Injectable)(),
+    __param(3, (0, common_1.Optional)()),
+    __param(3, (0, common_1.Inject)(tokenusage_target_labels_1.TOKEN_USAGE_TARGET_LABELS)),
+    __metadata("design:paramtypes", [neo4j_service_1.Neo4jService,
+        security_service_1.SecurityService,
+        nestjs_cls_1.ClsService, Array])
+], TokenUsageReportRepository);
+//# sourceMappingURL=tokenusage.report.repository.js.map

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

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

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

@@ -1,6 +1,7 @@
 import { ClsService } from "nestjs-cls";
 import { JsonApiService } from "../../../core/jsonapi/services/jsonapi.service";
 import { AbstractService } from "../../../core/neo4j/abstracts/abstract.service";
+import { TokenUsageDimension } from "../common/tokenusage.target-labels";
 import { TokenUsage, TokenUsageDescriptor } from "../entities/tokenusage";
 import { TokenUsageAdminRepository } from "../repositories/tokenusage.admin.repository";
 /**
@@ -41,7 +42,8 @@ export declare class TokenUsageAdminService extends AbstractService<TokenUsage,
     getBreakdown(params: {
         from: string;
         to: string;
-        dimension: "company" | "user" | "operation";
+        dimension: TokenUsageDimension;
+        targetLabel?: string;
         scope: "customer" | "platform";
         companyId?: string;
         limit: number;

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

@@ -1 +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"}
+{"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,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,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,mBAAmB,CAAC;QAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,EAAE,UAAU,GAAG,UAAU,CAAC;QAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;KACf,GAAG,OAAO,CAAC,GAAG,CAAC;CAajB"}

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

@@ -67,6 +67,7 @@ let TokenUsageAdminService = class TokenUsageAdminService extends abstract_servi
             from: params.from,
             to: params.to,
             dimension: params.dimension,
+            targetLabel: params.targetLabel,
             scope: params.scope,
             companyId: params.companyId,
             limit: params.limit,

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

@@ -1 +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"}
+{"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;AAEjF,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,MAQlB;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,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,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;AA5DY,wDAAsB;iCAAtB,sBAAsB;IADlC,IAAA,mBAAU,GAAE;qCAKO,gCAAc;QACgB,uDAAyB;QAC3D,uBAAU;GANb,sBAAsB,CA4DlC"}

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

@@ -0,0 +1,43 @@
+import { ClsService } from "nestjs-cls";
+import { JsonApiService } from "../../../core/jsonapi/services/jsonapi.service";
+import { AbstractService } from "../../../core/neo4j/abstracts/abstract.service";
+import { TokenUsageReportDimension, TokenUsageReportMetric } from "../common/tokenusage.target-labels";
+import { TokenUsage, TokenUsageDescriptor } from "../entities/tokenusage";
+import { TokenUsageReportRepository } from "../repositories/tokenusage.report.repository";
+/**
+ * Serialises the self-service reporting rollups as JSON:API documents.
+ *
+ * Same generics, descriptor and super() argument order as its two siblings in
+ * this folder, so all three tokenusage services are wired identically.
+ * `descriptor` and the inherited `model` are the TokenUsage entity — that is
+ * what the repository reads and what the base class needs to be coherent — while
+ * the three methods below serialise with the AGGREGATE descriptors' models,
+ * 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 TokenUsageReportService extends AbstractService<TokenUsage, typeof TokenUsageDescriptor.relationships> {
+    protected readonly tokenUsageReportRepository: TokenUsageReportRepository;
+    protected readonly descriptor: import("../../..").EntityDescriptor<TokenUsage, {}>;
+    constructor(jsonApiService: JsonApiService, tokenUsageReportRepository: TokenUsageReportRepository, clsService: ClsService);
+    getSummary(params: {
+        from: string;
+        to: string;
+    }): Promise<any>;
+    getTimeline(params: {
+        from: string;
+        to: string;
+        granularity: "day" | "week" | "month";
+        stackBy: "type";
+    }): Promise<any>;
+    getBreakdown(params: {
+        from: string;
+        to: string;
+        dimension: TokenUsageReportDimension;
+        targetLabel?: string;
+        metric: TokenUsageReportMetric;
+        limit: number;
+    }): Promise<any>;
+}
+//# sourceMappingURL=tokenusage.report.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tokenusage.report.service.d.ts","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/services/tokenusage.report.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,yBAAyB,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AACvG,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAI1E,OAAO,EAAE,0BAA0B,EAAE,MAAM,8CAA8C,CAAC;AAE1F;;;;;;;;;;;;GAYG;AACH,qBACa,uBAAwB,SAAQ,eAAe,CAAC,UAAU,EAAE,OAAO,oBAAoB,CAAC,aAAa,CAAC;IAK/G,SAAS,CAAC,QAAQ,CAAC,0BAA0B,EAAE,0BAA0B;IAJ3E,SAAS,CAAC,QAAQ,CAAC,UAAU,sDAAwB;gBAGnD,cAAc,EAAE,cAAc,EACX,0BAA0B,EAAE,0BAA0B,EACzE,UAAU,EAAE,UAAU;IAKlB,UAAU,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC;IAM9D,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,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,GAAG,CAAC;IAWV,YAAY,CAAC,MAAM,EAAE;QACzB,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,SAAS,EAAE,yBAAyB,CAAC;QACrC,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,sBAAsB,CAAC;QAC/B,KAAK,EAAE,MAAM,CAAC;KACf,GAAG,OAAO,CAAC,GAAG,CAAC;CAYjB"}

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

@@ -0,0 +1,73 @@
+"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.TokenUsageReportService = 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_report_breakdown_1 = require("../entities/tokenusage-report-breakdown");
+const tokenusage_report_summary_1 = require("../entities/tokenusage-report-summary");
+const tokenusage_report_timeline_1 = require("../entities/tokenusage-report-timeline");
+const tokenusage_report_repository_1 = require("../repositories/tokenusage.report.repository");
+/**
+ * Serialises the self-service reporting rollups as JSON:API documents.
+ *
+ * Same generics, descriptor and super() argument order as its two siblings in
+ * this folder, so all three tokenusage services are wired identically.
+ * `descriptor` and the inherited `model` are the TokenUsage entity — that is
+ * what the repository reads and what the base class needs to be coherent — while
+ * the three methods below serialise with the AGGREGATE descriptors' models,
+ * 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 TokenUsageReportService = class TokenUsageReportService extends abstract_service_1.AbstractService {
+    constructor(jsonApiService, tokenUsageReportRepository, clsService) {
+        super(jsonApiService, tokenUsageReportRepository, clsService, tokenusage_1.TokenUsageDescriptor.model);
+        this.tokenUsageReportRepository = tokenUsageReportRepository;
+        this.descriptor = tokenusage_1.TokenUsageDescriptor;
+    }
+    async getSummary(params) {
+        const rows = await this.tokenUsageReportRepository.findSummary({ from: params.from, to: params.to });
+        return this.jsonApiService.buildList(tokenusage_report_summary_1.TokenUsageReportSummaryDescriptor.model, rows);
+    }
+    async getTimeline(params) {
+        const rows = await this.tokenUsageReportRepository.findTimeline({
+            from: params.from,
+            to: params.to,
+            granularity: params.granularity,
+            stackBy: params.stackBy,
+        });
+        return this.jsonApiService.buildList(tokenusage_report_timeline_1.TokenUsageReportTimelineDescriptor.model, rows);
+    }
+    async getBreakdown(params) {
+        const rows = await this.tokenUsageReportRepository.findBreakdown({
+            from: params.from,
+            to: params.to,
+            dimension: params.dimension,
+            targetLabel: params.targetLabel,
+            metric: params.metric,
+            limit: params.limit,
+        });
+        return this.jsonApiService.buildList(tokenusage_report_breakdown_1.TokenUsageReportBreakdownDescriptor.model, rows);
+    }
+};
+exports.TokenUsageReportService = TokenUsageReportService;
+exports.TokenUsageReportService = TokenUsageReportService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [jsonapi_service_1.JsonApiService,
+        tokenusage_report_repository_1.TokenUsageReportRepository,
+        nestjs_cls_1.ClsService])
+], TokenUsageReportService);
+//# sourceMappingURL=tokenusage.report.service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tokenusage.report.service.js","sourceRoot":"","sources":["../../../../src/foundations/tokenusage/services/tokenusage.report.service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,2CAAwC;AACxC,oFAAgF;AAChF,qFAAiF;AAEjF,uDAA0E;AAC1E,yFAA8F;AAC9F,qFAA0F;AAC1F,uFAA4F;AAC5F,+FAA0F;AAE1F;;;;;;;;;;;;GAYG;AAEI,IAAM,uBAAuB,GAA7B,MAAM,uBAAwB,SAAQ,kCAAsE;IAGjH,YACE,cAA8B,EACX,0BAAsD,EACzE,UAAsB;QAEtB,KAAK,CAAC,cAAc,EAAE,0BAA0B,EAAE,UAAU,EAAE,iCAAoB,CAAC,KAAK,CAAC,CAAC;QAHvE,+BAA0B,GAA1B,0BAA0B,CAA4B;QAJxD,eAAU,GAAG,iCAAoB,CAAC;IAQrD,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAoC;QACnD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,0BAA0B,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;QAErG,OAAO,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,6DAAiC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACtF,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,MAKjB;QACC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,0BAA0B,CAAC,YAAY,CAAC;YAC9D,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,+DAAkC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACvF,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,MAOlB;QACC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,0BAA0B,CAAC,aAAa,CAAC;YAC/D,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,KAAK,EAAE,MAAM,CAAC,KAAK;SACpB,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,iEAAmC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACxF,CAAC;CACF,CAAA;AApDY,0DAAuB;kCAAvB,uBAAuB;IADnC,IAAA,mBAAU,GAAE;qCAKO,gCAAc;QACiB,yDAA0B;QAC7D,uBAAU;GANb,uBAAuB,CAoDnC"}

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;AAYtD,qBAea,gBAAiB,YAAW,YAAY;IACnD,YAAY;CAMb"}
+{"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;AAkBtD,qBAoBa,gBAAiB,YAAW,YAAY;IACnD,YAAY;CASb"}

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

@@ -10,13 +10,19 @@ 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_report_controller_1 = require("./controllers/tokenusage.report.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_report_breakdown_1 = require("./entities/tokenusage-report-breakdown");
+const tokenusage_report_summary_1 = require("./entities/tokenusage-report-summary");
+const tokenusage_report_timeline_1 = require("./entities/tokenusage-report-timeline");
 const tokenusage_admin_repository_1 = require("./repositories/tokenusage.admin.repository");
+const tokenusage_report_repository_1 = require("./repositories/tokenusage.report.repository");
 const tokenusage_repository_1 = require("./repositories/tokenusage.repository");
 const tokenusage_admin_service_1 = require("./services/tokenusage.admin.service");
+const tokenusage_report_service_1 = require("./services/tokenusage.report.service");
 const tokenusage_service_1 = require("./services/tokenusage.service");
 let TokenUsageModule = class TokenUsageModule {
     onModuleInit() {
@@ -24,23 +30,31 @@ let TokenUsageModule = class TokenUsageModule {
         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);
+        registry_1.modelRegistry.register(tokenusage_report_summary_1.TokenUsageReportSummaryDescriptor.model);
+        registry_1.modelRegistry.register(tokenusage_report_timeline_1.TokenUsageReportTimelineDescriptor.model);
+        registry_1.modelRegistry.register(tokenusage_report_breakdown_1.TokenUsageReportBreakdownDescriptor.model);
     }
 };
 exports.TokenUsageModule = TokenUsageModule;
 exports.TokenUsageModule = TokenUsageModule = __decorate([
     (0, common_1.Module)({
-        controllers: [tokenusage_admin_controller_1.TokenUsageAdminController],
+        controllers: [tokenusage_admin_controller_1.TokenUsageAdminController, tokenusage_report_controller_1.TokenUsageReportController],
         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_report_summary_1.TokenUsageReportSummaryDescriptor.model.serialiser,
+            tokenusage_report_timeline_1.TokenUsageReportTimelineDescriptor.model.serialiser,
+            tokenusage_report_breakdown_1.TokenUsageReportBreakdownDescriptor.model.serialiser,
             tokenusage_repository_1.TokenUsageRepository,
             tokenusage_admin_repository_1.TokenUsageAdminRepository,
+            tokenusage_report_repository_1.TokenUsageReportRepository,
             tokenusage_service_1.TokenUsageService,
             tokenusage_admin_service_1.TokenUsageAdminService,
+            tokenusage_report_service_1.TokenUsageReportService,
         ],
-        exports: [tokenusage_service_1.TokenUsageService, tokenusage_admin_service_1.TokenUsageAdminService],
+        exports: [tokenusage_service_1.TokenUsageService, tokenusage_admin_service_1.TokenUsageAdminService, tokenusage_report_service_1.TokenUsageReportService],
         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,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"}
+{"version":3,"file":"tokenusage.module.js","sourceRoot":"","sources":["../../../src/foundations/tokenusage/tokenusage.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAsD;AACtD,+DAAiE;AACjE,2FAAsF;AACtF,6FAAwF;AACxF,sDAA6D;AAC7D,sFAA2F;AAC3F,kFAAuF;AACvF,oFAAyF;AACzF,wFAA6F;AAC7F,oFAAyF;AACzF,sFAA2F;AAC3F,4FAAuF;AACvF,8FAAyF;AACzF,gFAA4E;AAC5E,kFAA6E;AAC7E,oFAA+E;AAC/E,sEAAkE;AAsB3D,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;QACjE,wBAAa,CAAC,QAAQ,CAAC,6DAAiC,CAAC,KAAK,CAAC,CAAC;QAChE,wBAAa,CAAC,QAAQ,CAAC,+DAAkC,CAAC,KAAK,CAAC,CAAC;QACjE,wBAAa,CAAC,QAAQ,CAAC,iEAAmC,CAAC,KAAK,CAAC,CAAC;IACpE,CAAC;CACF,CAAA;AAVY,4CAAgB;2BAAhB,gBAAgB;IApB5B,IAAA,eAAM,EAAC;QACN,WAAW,EAAE,CAAC,uDAAyB,EAAE,yDAA0B,CAAC;QACpE,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,6DAAiC,CAAC,KAAK,CAAC,UAAU;YAClD,+DAAkC,CAAC,KAAK,CAAC,UAAU;YACnD,iEAAmC,CAAC,KAAK,CAAC,UAAU;YACpD,4CAAoB;YACpB,uDAAyB;YACzB,yDAA0B;YAC1B,sCAAiB;YACjB,iDAAsB;YACtB,mDAAuB;SACxB;QACD,OAAO,EAAE,CAAC,sCAAiB,EAAE,iDAAsB,EAAE,mDAAuB,CAAC;QAC7E,OAAO,EAAE,EAAE;KACZ,CAAC;GACW,gBAAgB,CAU5B"}

package/dist/foundations/user/repositories/user.repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"user.repository.d.ts","sourceRoot":"","sources":["../../../../src/foundations/user/repositories/user.repository.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"user.repository.d.ts","sourceRoot":"","sources":["../../../../src/foundations/user/repositories/user.repository.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,EAAE,sBAAsB,EAAE,MAAM,2DAA2D,CAAC;AACnG,OAAO,EAAE,kBAAkB,EAAE,MAAM,mDAAmD,CAAC;AACvF,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,kDAAkD,CAAC;AAYnF,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAEhE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAE5E;;;;;;;;;;;;;;GAcG;AACH,qBACa,cAAe,SAAQ,kBAAkB,CAAC,IAAI,EAAE,OAAO,cAAc,CAAC,aAAa,CAAC;IAO7F,SAAS,CAAC,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB;IANzD,SAAS,CAAC,QAAQ,CAAC,UAAU;;;;;;;;;;;;;;;;;;;;;;OAAkB;gBAG7C,KAAK,EAAE,YAAY,EACnB,eAAe,EAAE,eAAe,EAChC,UAAU,EAAE,UAAU,EACH,iBAAiB,EAAE,iBAAiB;IAKzD;;;;;;;OAOG;IACG,YAAY;IAQZ,gBAAgB,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;IAmB9D,eAAe,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBhE;;;;OAIG;IACG,qBAAqB,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BhE,YAAY,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAsDvD,YAAY,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA0B3E,WAAW,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAgC/E,UAAU,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBnD,QAAQ,CAAC,MAAM,EAAE;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,MAAM,CAAC,EAAE,sBAAsB,CAAC;KACjC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAsCb,oBAAoB,CAAC,MAAM,EAAE;QACjC,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,cAAc,CAAC,EAAE,OAAO,CAAC;KAC1B,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAuBb,iBAAiB,CAAC,MAAM,EAAE;QAC9B,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,MAAM,CAAC,EAAE,sBAAsB,CAAC;KACjC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAoBb,UAAU,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,sBAAsB,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IA0BtG,aAAa,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,sBAAsB,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IA+BzG,UAAU,CAAC,MAAM,EAAE;QACvB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;KAC7B,GAAG,OAAO,CAAC,IAAI,CAAC;IAyDX,SAAS,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBpD,OAAO,CAAC,MAAM,EAAE;QACpB,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,cAAc,CAAC,EAAE,OAAO,CAAC;KAC1B,GAAG,OAAO,CAAC,IAAI,CAAC;IA2DX,YAAY,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBxE,UAAU,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBrD,SAAS,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBlE,WAAW,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBtE,UAAU,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBrD,aAAa,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BxE,kBAAkB,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBnF;;;OAGG;IACG,0BAA0B,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAiBnD;;;OAGG;IACG,mCAAmC,CAAC,MAAM,EAAE;QAAE,gBAAgB,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IA0BhG;;;OAGG;IACG,qBAAqB,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;CAmB5E"}

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

@@ -267,8 +267,12 @@ let UserRepository = class UserRepository extends abstract_repository_1.Abstract
         query.query += `
       {CURSOR}
 
+      // The company is what makes the platform-wide list readable: an
+      // administrator browsing every user needs to see which company each one
+      // belongs to. OPTIONAL, because a system administrator belongs to none.
+      OPTIONAL MATCH (${user_meta_1.userMeta.nodeName})-[:BELONGS_TO]->(${user_meta_1.userMeta.nodeName}_${company_meta_1.companyMeta.nodeName}:${company_meta_1.companyMeta.labelName})
       ${(0, membership_query_1.membershipRoleMatch)({ userAlias: user_meta_1.userMeta.nodeName, roleAlias: `${user_meta_1.userMeta.nodeName}_role` })}
-      RETURN ${user_meta_1.userMeta.nodeName}, ${user_meta_1.userMeta.nodeName}_role
+      RETURN ${user_meta_1.userMeta.nodeName}, ${user_meta_1.userMeta.nodeName}_role, ${user_meta_1.userMeta.nodeName}_${company_meta_1.companyMeta.nodeName}
     `;
         return this.neo4j.readMany(query);
     }