@spottoai/types-package 1.0.2-beta.413 → 1.0.2-beta.415

package/dist/azure/reportSpend.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REPORT_SPEND_LIMITS = void 0;
+exports.REPORT_SPEND_LIMITS = { periods: 14, servicesPerPeriod: 100, periodDays: 92, assumptions: 10, textLength: 500 };
+//# sourceMappingURL=reportSpend.js.map

package/dist/azure/reportSpend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reportSpend.js","sourceRoot":"","sources":["../../src/azure/reportSpend.ts"],"names":[],"mappings":";;;AAGa,QAAA,mBAAmB,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,iBAAiB,EAAE,GAAG,EAAE,UAAU,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,EAAW,CAAC"}

package/dist/azure/reportSpendValidation.d.ts

@@ -0,0 +1,7 @@
+import { type ReportSavingsBasis, type ReportSpendAmounts, type ReportSpendProjection } from './reportSpend';
+export declare const isReportSavingsBasis: (value: unknown) => value is ReportSavingsBasis;
+export declare function isReportSpendAmounts(value: unknown, currency?: string, generatedAt?: string): value is ReportSpendAmounts;
+export declare const hasReportSpendValue: (value: ReportSpendAmounts) => boolean;
+/** Dates, population completeness and actual/estimated selection remain independent checks. */
+export declare const isReportSpendProjection: (value: unknown) => value is ReportSpendProjection;
+//# sourceMappingURL=reportSpendValidation.d.ts.map

package/dist/azure/reportSpendValidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reportSpendValidation.d.ts","sourceRoot":"","sources":["../../src/azure/reportSpendValidation.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAE3B,MAAM,eAAe,CAAC;AASvB,eAAO,MAAM,oBAAoB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,kBACqC,CAAC;AAuCrG,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,KAAK,IAAI,kBAAkB,CAyDzH;AAED,eAAO,MAAM,mBAAmB,GAAI,OAAO,kBAAkB,KAAG,OAI7D,CAAC;AAEJ,+FAA+F;AAC/F,eAAO,MAAM,uBAAuB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,qBAmEjE,CAAC"}

package/dist/azure/reportSpendValidation.js

@@ -0,0 +1,197 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isReportSpendProjection = exports.hasReportSpendValue = exports.isReportSavingsBasis = void 0;
+exports.isReportSpendAmounts = isReportSpendAmounts;
+const costComposition_1 = require("./costComposition");
+const reportEvidenceValidationHelpers_1 = require("./reportEvidenceValidationHelpers");
+const reportSpend_1 = require("./reportSpend");
+const reportSpendValidationHelpers_1 = require("./reportSpendValidationHelpers");
+const bases = ['billed', 'amortized'];
+const coverageStates = new Set(['complete', 'partial', 'unavailable']);
+const exactFields = (value, required, optional = []) => required.every(key => Object.prototype.hasOwnProperty.call(value, key)) &&
+    Object.keys(value).every(key => [...required, ...optional].includes(key));
+const isReportSavingsBasis = (value) => typeof value === 'string' && ['billed', 'amortized', 'retail', 'mixed', 'unknown'].includes(value);
+exports.isReportSavingsBasis = isReportSavingsBasis;
+const amountOf = (value) => value.status === 'available' ? (0, reportSpendValidationHelpers_1.reportMoneyUnits)(value.component.amount) : undefined;
+function isBasisConsistent(basis, coverage, lens) {
+    if (!(0, reportEvidenceValidationHelpers_1.isRecord)(coverage) || !exactFields(coverage, ['actual', 'estimated', 'combined']))
+        return false;
+    const components = { actual: basis.actual.availability, estimated: basis.estimated.availability, combined: basis.combined };
+    for (const key of ['actual', 'estimated', 'combined']) {
+        if (!coverageStates.has(coverage[key]))
+            return false;
+        const available = components[key].status === 'available';
+        if (available !== (coverage[key] !== 'unavailable'))
+            return false;
+        if (available && amountOf(components[key]) === undefined)
+            return false;
+        if (key !== 'combined' && available && basis[key].support !== 'supported')
+            return false;
+    }
+    const actual = amountOf(components.actual);
+    const estimated = amountOf(components.estimated);
+    const expectedStatus = actual !== undefined
+        ? estimated !== undefined
+            ? 'actual-plus-estimated'
+            : 'actual-only'
+        : estimated !== undefined
+            ? 'estimated-only'
+            : 'unavailable';
+    if (basis.status !== expectedStatus)
+        return false;
+    const combined = amountOf(basis.combined);
+    // Reconciliation may withhold the combined amount even when individual components are available.
+    if (combined === undefined)
+        return true;
+    if (lens === 'actual-only')
+        return actual === combined && coverage.combined === coverage.actual;
+    if (lens === 'estimates-only')
+        return estimated === combined && coverage.combined === coverage.estimated;
+    if (actual === undefined && estimated === undefined)
+        return false;
+    if (combined !== (actual ?? 0n) + (estimated ?? 0n))
+        return false;
+    // A single partial component cannot become a complete combined total. Two components require producer coverage proof.
+    if (actual === undefined)
+        return coverage.combined === coverage.estimated;
+    if (estimated === undefined)
+        return coverage.combined === coverage.actual;
+    return true;
+}
+function isReportSpendAmounts(value, currency, generatedAt) {
+    if (!(0, reportEvidenceValidationHelpers_1.isRecord)(value) || !exactFields(value, ['composition', 'coverage', 'retail'], ['estimates']) || !(0, costComposition_1.isPublicCostComposition)(value.composition))
+        return false;
+    if (!(0, reportEvidenceValidationHelpers_1.isRecord)(value.coverage) || !exactFields(value.coverage, [...bases]))
+        return false;
+    if (currency !== undefined && !(0, reportSpendValidationHelpers_1.isReportCurrency)(currency))
+        return false;
+    if (generatedAt !== undefined && !(0, reportSpendValidationHelpers_1.isReportUtcTimestamp)(generatedAt))
+        return false;
+    if (value.estimates !== undefined && (!(0, reportEvidenceValidationHelpers_1.isRecord)(value.estimates) || !exactFields(value.estimates, [], [...bases])))
+        return false;
+    const currencies = new Set();
+    if (currency)
+        currencies.add(currency);
+    for (const key of bases) {
+        const basis = value.composition[key];
+        if (!isBasisConsistent(basis, value.coverage[key], value.composition.selectedLens))
+            return false;
+        for (const item of [basis.actual.availability, basis.estimated.availability, basis.combined]) {
+            if (item.status === 'available') {
+                if (!(0, reportSpendValidationHelpers_1.isReportCurrency)(item.component.currencyCode))
+                    return false;
+                currencies.add(item.component.currencyCode);
+            }
+        }
+        const estimate = (0, reportEvidenceValidationHelpers_1.isRecord)(value.estimates) ? value.estimates[key] : undefined;
+        if (basis.estimated.availability.status === 'available') {
+            if (!(0, reportEvidenceValidationHelpers_1.isRecord)(estimate) ||
+                !exactFields(estimate, ['reason', 'method', 'observedAt']) ||
+                !['billing-lag', 'billing-unavailable-sponsorship', 'other'].includes(estimate.reason) ||
+                !(0, reportSpendValidationHelpers_1.isReportText)(estimate.method) ||
+                !(0, reportSpendValidationHelpers_1.isReportUtcTimestamp)(estimate.observedAt) ||
+                (generatedAt !== undefined && Date.parse(estimate.observedAt) > Date.parse(generatedAt)))
+                return false;
+        }
+        else if (estimate !== undefined)
+            return false;
+    }
+    const retail = value.retail;
+    if (!(0, reportEvidenceValidationHelpers_1.isRecord)(retail))
+        return false;
+    if (retail.status === 'unavailable') {
+        if (!exactFields(retail, ['status']))
+            return false;
+    }
+    else {
+        if (retail.status !== 'available' ||
+            !exactFields(retail, ['status', 'component', 'coverage', 'scopeDescription', 'pricingSource', 'pricedAt', 'assumptions']) ||
+            !(0, reportEvidenceValidationHelpers_1.isRecord)(retail.component) ||
+            !exactFields(retail.component, ['amount', 'currencyCode']) ||
+            !(0, reportSpendValidationHelpers_1.isReportCurrency)(retail.component.currencyCode) ||
+            !['complete', 'partial'].includes(retail.coverage) ||
+            !(0, reportSpendValidationHelpers_1.isReportText)(retail.scopeDescription) ||
+            !(0, reportSpendValidationHelpers_1.isReportText)(retail.pricingSource) ||
+            !(0, reportSpendValidationHelpers_1.isReportUtcTimestamp)(retail.pricedAt) ||
+            (generatedAt !== undefined && Date.parse(retail.pricedAt) > Date.parse(generatedAt)) ||
+            !Array.isArray(retail.assumptions) ||
+            retail.assumptions.length > reportSpend_1.REPORT_SPEND_LIMITS.assumptions ||
+            !retail.assumptions.every(reportSpendValidationHelpers_1.isReportText))
+            return false;
+        const amount = (0, reportSpendValidationHelpers_1.reportMoneyUnits)(retail.component.amount);
+        if (amount === undefined || amount < 0n)
+            return false;
+        currencies.add(retail.component.currencyCode);
+    }
+    return currencies.size <= 1;
+}
+const hasReportSpendValue = (value) => value.retail.status === 'available' ||
+    bases.some(key => value.composition[key].actual.availability.status === 'available' || value.composition[key].estimated.availability.status === 'available');
+exports.hasReportSpendValue = hasReportSpendValue;
+/** Dates, population completeness and actual/estimated selection remain independent checks. */
+const isReportSpendProjection = (value) => {
+    if (!(0, reportEvidenceValidationHelpers_1.isRecord)(value) ||
+        !exactFields(value, ['currency', 'dateBasis', 'generatedAt', 'freshness', 'periods'], ['sourceObservedAt']) ||
+        !(0, reportSpendValidationHelpers_1.isReportCurrency)(value.currency) ||
+        value.dateBasis !== 'billing-calendar' ||
+        !(0, reportSpendValidationHelpers_1.isReportUtcTimestamp)(value.generatedAt) ||
+        !['current', 'stale', 'unavailable'].includes(value.freshness) ||
+        !Array.isArray(value.periods) ||
+        value.periods.length > reportSpend_1.REPORT_SPEND_LIMITS.periods)
+        return false;
+    if (value.sourceObservedAt !== undefined &&
+        (!(0, reportSpendValidationHelpers_1.isReportUtcTimestamp)(value.sourceObservedAt) || Date.parse(value.sourceObservedAt) > Date.parse(value.generatedAt)))
+        return false;
+    const seen = new Set();
+    let rollingCount = 0;
+    let historicalCount = 0;
+    let available = false;
+    for (const period of value.periods) {
+        if (!(0, reportEvidenceValidationHelpers_1.isRecord)(period) ||
+            !exactFields(period, ['kind', 'startDate', 'endDate', 'amounts'], ['services']) ||
+            !['calendar-month', 'billing-period', 'rolling-30-days'].includes(period.kind) ||
+            !(0, reportSpendValidationHelpers_1.isReportCalendarDate)(period.startDate) ||
+            !(0, reportSpendValidationHelpers_1.isReportCalendarDate)(period.endDate))
+            return false;
+        const days = (Date.parse(period.endDate) - Date.parse(period.startDate)) / 86400000 + 1;
+        if (days < 1 || days > reportSpend_1.REPORT_SPEND_LIMITS.periodDays)
+            return false;
+        if (period.kind === 'calendar-month') {
+            const following = new Date(Date.parse(period.endDate) + 86400000).toISOString().slice(0, 10);
+            if (!period.startDate.endsWith('-01') || period.startDate.slice(0, 7) !== period.endDate.slice(0, 7) || !following.endsWith('-01'))
+                return false;
+        }
+        if (period.kind === 'rolling-30-days') {
+            if (days !== 30 || ++rollingCount > 1)
+                return false;
+        }
+        else if (++historicalCount > 13)
+            return false;
+        const key = `${period.kind}:${period.startDate}:${period.endDate}`;
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        if (!isReportSpendAmounts(period.amounts, value.currency, value.generatedAt))
+            return false;
+        available || (available = (0, exports.hasReportSpendValue)(period.amounts));
+        if (period.services !== undefined) {
+            const serviceKeys = new Set();
+            if (!(0, reportEvidenceValidationHelpers_1.isBoundedRows)(period.services, reportSpend_1.REPORT_SPEND_LIMITS.servicesPerPeriod, (row) => {
+                if (!(0, reportEvidenceValidationHelpers_1.isRecord)(row) ||
+                    !exactFields(row, ['serviceKey', 'name', 'amounts']) ||
+                    !(0, reportSpendValidationHelpers_1.isReportText)(row.serviceKey) ||
+                    !(0, reportSpendValidationHelpers_1.isReportText)(row.name) ||
+                    serviceKeys.has(row.serviceKey) ||
+                    !isReportSpendAmounts(row.amounts, value.currency, value.generatedAt))
+                    return false;
+                serviceKeys.add(row.serviceKey);
+                available || (available = (0, exports.hasReportSpendValue)(row.amounts));
+                return true;
+            }))
+                return false;
+        }
+    }
+    return available ? value.sourceObservedAt !== undefined && value.freshness !== 'unavailable' : value.freshness === 'unavailable';
+};
+exports.isReportSpendProjection = isReportSpendProjection;
+//# sourceMappingURL=reportSpendValidation.js.map

package/dist/azure/reportSpendValidation.js.map

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

package/dist/azure/reportSpendValidationHelpers.d.ts

@@ -0,0 +1,7 @@
+export declare const isReportCalendarDate: (value: unknown) => value is string;
+export declare const isReportUtcTimestamp: (value: unknown) => value is string;
+export declare const isReportCurrency: (value: unknown) => value is string;
+export declare const isReportText: (value: unknown) => value is string;
+/** Bounded exact arithmetic avoids binary floating point and pathological decimal-string input. */
+export declare const reportMoneyUnits: (value: unknown) => bigint | undefined;
+//# sourceMappingURL=reportSpendValidationHelpers.d.ts.map

package/dist/azure/reportSpendValidationHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reportSpendValidationHelpers.d.ts","sourceRoot":"","sources":["../../src/azure/reportSpendValidationHelpers.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,oBAAoB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAI9D,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAKgC,CAAC;AAEhG,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAA+D,CAAC;AAC3H,eAAO,MAAM,YAAY,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MACiD,CAAC;AAEzG,mGAAmG;AACnG,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,KAAG,MAAM,GAAG,SAK1D,CAAC"}

package/dist/azure/reportSpendValidationHelpers.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reportMoneyUnits = exports.isReportText = exports.isReportCurrency = exports.isReportUtcTimestamp = exports.isReportCalendarDate = void 0;
+const reportSpend_1 = require("./reportSpend");
+const isReportCalendarDate = (value) => {
+    if (typeof value !== 'string' || !/^\d{4}-\d{2}-\d{2}$/.test(value))
+        return false;
+    const time = Date.parse(`${value}T00:00:00.000Z`);
+    return Number.isFinite(time) && new Date(time).toISOString().slice(0, 10) === value;
+};
+exports.isReportCalendarDate = isReportCalendarDate;
+const isReportUtcTimestamp = (value) => typeof value === 'string' &&
+    /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{3})?Z$/.test(value) &&
+    (0, exports.isReportCalendarDate)(value.slice(0, 10)) &&
+    Number.isFinite(Date.parse(value)) &&
+    new Date(value).toISOString() === (value.length === 20 ? value.replace('Z', '.000Z') : value);
+exports.isReportUtcTimestamp = isReportUtcTimestamp;
+const isReportCurrency = (value) => typeof value === 'string' && /^[A-Z]{3}$/.test(value);
+exports.isReportCurrency = isReportCurrency;
+const isReportText = (value) => typeof value === 'string' && value.trim().length > 0 && value.length <= reportSpend_1.REPORT_SPEND_LIMITS.textLength;
+exports.isReportText = isReportText;
+/** Bounded exact arithmetic avoids binary floating point and pathological decimal-string input. */
+const reportMoneyUnits = (value) => {
+    if (typeof value !== 'string' || value.length > 25 || !/^-?(?:0|[1-9]\d{0,14})(?:\.\d{1,8})?$/.test(value))
+        return undefined;
+    const [whole, fraction = ''] = value.replace(/^-/, '').split('.');
+    const amount = BigInt(whole) * 100000000n + BigInt(fraction.padEnd(8, '0'));
+    return value.startsWith('-') ? -amount : amount;
+};
+exports.reportMoneyUnits = reportMoneyUnits;
+//# sourceMappingURL=reportSpendValidationHelpers.js.map

package/dist/azure/reportSpendValidationHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reportSpendValidationHelpers.js","sourceRoot":"","sources":["../../src/azure/reportSpendValidationHelpers.ts"],"names":[],"mappings":";;;AAAA,+CAAoD;AAE7C,MAAM,oBAAoB,GAAG,CAAC,KAAc,EAAmB,EAAE;IACtE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAClF,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,KAAK,gBAAgB,CAAC,CAAC;IAClD,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,CAAC;AACtF,CAAC,CAAC;AAJW,QAAA,oBAAoB,wBAI/B;AAEK,MAAM,oBAAoB,GAAG,CAAC,KAAc,EAAmB,EAAE,CACtE,OAAO,KAAK,KAAK,QAAQ;IACzB,oDAAoD,CAAC,IAAI,CAAC,KAAK,CAAC;IAChE,IAAA,4BAAoB,EAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACxC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAClC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AALnF,QAAA,oBAAoB,wBAK+D;AAEzF,MAAM,gBAAgB,GAAG,CAAC,KAAc,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAA9G,QAAA,gBAAgB,oBAA8F;AACpH,MAAM,YAAY,GAAG,CAAC,KAAc,EAAmB,EAAE,CAC9D,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,IAAI,iCAAmB,CAAC,UAAU,CAAC;AAD5F,QAAA,YAAY,gBACgF;AAEzG,mGAAmG;AAC5F,MAAM,gBAAgB,GAAG,CAAC,KAAc,EAAsB,EAAE;IACrE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE,IAAI,CAAC,uCAAuC,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC7H,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,EAAE,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IAC5E,OAAO,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;AAClD,CAAC,CAAC;AALW,QAAA,gBAAgB,oBAK3B"}

package/dist/esm/azure/reportDailySpendValidation.js

@@ -1,17 +1,8 @@
 import { REPORT_DAILY_SPEND_MAX_DAYS } from './reportDailySpend.js';
 import { isCount, isFiniteNumber, isRecord } from './reportEvidenceValidationHelpers.js';
+import { hasReportSpendValue, isReportSpendAmounts } from './reportSpendValidation.js';
+import { isReportCalendarDate as isCalendarDate, isReportUtcTimestamp as isUtcTimestamp } from './reportSpendValidationHelpers.js';
 const DAY_MS = 86400000;
-const isCalendarDate = (value) => {
-    if (typeof value !== 'string' || !/^\d{4}-\d{2}-\d{2}$/.test(value))
-        return false;
-    const time = Date.parse(`${value}T00:00:00.000Z`);
-    return Number.isFinite(time) && new Date(time).toISOString().slice(0, 10) === value;
-};
-const isUtcTimestamp = (value) => typeof value === 'string' &&
-    /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{3})?Z$/.test(value) &&
-    isCalendarDate(value.slice(0, 10)) &&
-    Number.isFinite(Date.parse(value)) &&
-    new Date(value).toISOString() === (value.length === 20 ? value.replace('Z', '.000Z') : value);
 const isCoverage = (value, covered, expected) => {
     const status = covered === expected ? 'complete' : covered === 0 ? 'unavailable' : 'partial';
     return isRecord(value) && isCount(value.coveredDayCount) && value.coveredDayCount === covered && value.status === status;
@@ -45,10 +36,27 @@ export const isReportDailySpend = (value) => {
             entry.date <= previousDate ||
             entry.date < value.startDate ||
             entry.date > value.endDate ||
-            (entry.cost === undefined && entry.costAmortized === undefined) ||
+            (entry.cost === undefined && entry.costAmortized === undefined && entry.financials === undefined) ||
             (entry.cost !== undefined && !isFiniteNumber(entry.cost)) ||
             (entry.costAmortized !== undefined && !isFiniteNumber(entry.costAmortized)))
             return false;
+        if (entry.financials !== undefined) {
+            if (!isReportSpendAmounts(entry.financials, value.currency, value.generatedAt) || !hasReportSpendValue(entry.financials))
+                return false;
+            for (const [basis, field] of [
+                ['billed', 'cost'],
+                ['amortized', 'costAmortized'],
+            ]) {
+                const actual = entry.financials.composition[basis].actual.availability;
+                const complete = entry.financials.coverage[basis].actual === 'complete';
+                if (actual.status === 'available' && complete) {
+                    if (entry[field] !== Number(actual.component.amount))
+                        return false;
+                }
+                else if (entry[field] !== undefined)
+                    return false;
+            }
+        }
         previousDate = entry.date;
         if (entry.cost !== undefined)
             billedDays++;

package/dist/esm/azure/reportEvidenceCatalogueValidation.js

@@ -1,14 +1,18 @@
 import { REPORT_EVIDENCE_LIMITS } from './reportEvidence.js';
+import { isReportSavingsBasis } from './reportSpendValidation.js';
 import { isRecord, isString, isOptionalString, isOptionalFiniteNumber, isOptionalBoolean, isFiniteNumber, isCount, isBoundedRows, hasOptionalStrings, hasOptionalNumbers, } from './reportEvidenceValidationHelpers.js';
 const isCompactRecommendationResource = (value) => isRecord(value) &&
     isString(value.id) &&
     ['name', 'type', 'resourceGroup', 'location', 'currency', 'currencySymbol'].every(key => isOptionalString(value[key])) &&
     ['spend', 'spendAmortized'].every(key => isOptionalFiniteNumber(value[key])) &&
+    (value.savingsBasis === undefined || isReportSavingsBasis(value.savingsBasis)) &&
     (value.savings === undefined ||
         (isRecord(value.savings) && isOptionalFiniteNumber(value.savings.minAmount) && isOptionalFiniteNumber(value.savings.maxAmount)));
 export const isCompactRecommendation = (value) => {
     if (!isRecord(value) || !isRecord(value.recommendation) || !Array.isArray(value.resources))
         return false;
+    if (value.savingsBasis !== undefined && !isReportSavingsBasis(value.savingsBasis))
+        return false;
     const recommendation = value.recommendation;
     const assessment = recommendation.securityAssessmentSummary;
     if (assessment !== undefined &&

package/dist/esm/azure/reportEvidenceValidation.js

@@ -1,5 +1,6 @@
 import { isCompactRecommendation, isInventoryCatalogueResource } from './reportEvidenceCatalogueValidation.js';
 import { isReportDailySpend } from './reportDailySpendValidation.js';
+import { isReportSavingsBasis, isReportSpendProjection } from './reportSpendValidation.js';
 import { REPORT_EVIDENCE_LIMITS, } from './reportEvidence.js';
 import { countTotal, hasOptionalNumbers, hasOptionalStrings, hasRequiredRecords, isBoundedRows, isCommitmentExpirySummary, isCostSummary, isCount, isCountRecord, isDateTime, isEvidenceReference, isFiniteNumber, isOptionalBoolean, isOptionalFiniteNumber, isOptionalString, isProjectionRows, isRecommendationSummary, isRecord, isResourceSummary, isRetirementSummary, isSourceFileStatus, isString, isStringArray, isTagCoverage, } from './reportEvidenceValidationHelpers.js';
 export const isReportSecureScoreEvidence = (value) => {
@@ -15,6 +16,7 @@ export const isReportSecureScoreEvidence = (value) => {
     return true;
 };
 const isCostSavingsCategory = (value) => isRecord(value) &&
+    (value.savingsBasis === undefined || isReportSavingsBasis(value.savingsBasis)) &&
     isString(value.key) &&
     isString(value.label) &&
     isCount(value.recommendationCount) &&
@@ -64,7 +66,10 @@ const isRecommendationPortfolio = (value) => {
     }
     if (value.costSavings === undefined)
         return true;
-    if (!isRecord(value.costSavings) || !isString(value.costSavings.currency) || !isCount(value.costSavings.contributingRecommendationCount)) {
+    if (!isRecord(value.costSavings) ||
+        !isString(value.costSavings.currency) ||
+        !isCount(value.costSavings.contributingRecommendationCount) ||
+        (value.costSavings.savingsBasis !== undefined && !isReportSavingsBasis(value.costSavings.savingsBasis))) {
         return false;
     }
     const monthly = value.costSavings.monthly;
@@ -166,6 +171,8 @@ const isReportingProjection = (value) => {
         return false;
     if (value.dailySpend !== undefined && !isReportDailySpend(value.dailySpend))
         return false;
+    if (value.spend !== undefined && !isReportSpendProjection(value.spend))
+        return false;
     const subscription = isRecord(value.dashboard.subscription) ? value.dashboard.subscription : undefined;
     const properties = subscription && isRecord(subscription.properties) ? subscription.properties : undefined;
     if (properties?.secureScoreEvidence !== undefined && !isReportSecureScoreEvidence(properties.secureScoreEvidence))
@@ -269,11 +276,18 @@ export const isSubscriptionReportEvidencePack = (value) => {
     const dailySpend = value.reporting.dailySpend;
     if (dailySpend && value.scope.currency !== undefined && dailySpend.currency !== value.scope.currency)
         return false;
+    const spend = value.reporting.spend;
+    if (spend &&
+        ((value.scope.currency !== undefined && spend.currency !== value.scope.currency) ||
+            (dailySpend && spend.currency !== dailySpend.currency) ||
+            Date.parse(spend.generatedAt) > Date.parse(value.generatedAt)))
+        return false;
     return (value.reliability.relationshipGraph === undefined ||
         (isRecord(value.reliability.relationshipGraph) &&
             hasOptionalNumbers(value.reliability.relationshipGraph, ['totalNodes', 'totalEdges', 'unresolvedCount', 'buildMs'])));
 };
 const isRecommendationFingerprint = (value) => isRecord(value) &&
+    (value.savingsBasis === undefined || isReportSavingsBasis(value.savingsBasis)) &&
     isString(value.id) &&
     isString(value.title) &&
     hasOptionalStrings(value, ['category', 'impact', 'severity', 'currency']) &&

package/dist/esm/azure/reportSpend.js

@@ -0,0 +1 @@
+export const REPORT_SPEND_LIMITS = { periods: 14, servicesPerPeriod: 100, periodDays: 92, assumptions: 10, textLength: 500 };

package/dist/esm/azure/reportSpendValidation.js

@@ -0,0 +1,189 @@
+import { isPublicCostComposition } from './costComposition.js';
+import { isBoundedRows, isRecord } from './reportEvidenceValidationHelpers.js';
+import { REPORT_SPEND_LIMITS, } from './reportSpend.js';
+import { isReportCalendarDate, isReportCurrency, isReportText, isReportUtcTimestamp, reportMoneyUnits } from './reportSpendValidationHelpers.js';
+const bases = ['billed', 'amortized'];
+const coverageStates = new Set(['complete', 'partial', 'unavailable']);
+const exactFields = (value, required, optional = []) => required.every(key => Object.prototype.hasOwnProperty.call(value, key)) &&
+    Object.keys(value).every(key => [...required, ...optional].includes(key));
+export const isReportSavingsBasis = (value) => typeof value === 'string' && ['billed', 'amortized', 'retail', 'mixed', 'unknown'].includes(value);
+const amountOf = (value) => value.status === 'available' ? reportMoneyUnits(value.component.amount) : undefined;
+function isBasisConsistent(basis, coverage, lens) {
+    if (!isRecord(coverage) || !exactFields(coverage, ['actual', 'estimated', 'combined']))
+        return false;
+    const components = { actual: basis.actual.availability, estimated: basis.estimated.availability, combined: basis.combined };
+    for (const key of ['actual', 'estimated', 'combined']) {
+        if (!coverageStates.has(coverage[key]))
+            return false;
+        const available = components[key].status === 'available';
+        if (available !== (coverage[key] !== 'unavailable'))
+            return false;
+        if (available && amountOf(components[key]) === undefined)
+            return false;
+        if (key !== 'combined' && available && basis[key].support !== 'supported')
+            return false;
+    }
+    const actual = amountOf(components.actual);
+    const estimated = amountOf(components.estimated);
+    const expectedStatus = actual !== undefined
+        ? estimated !== undefined
+            ? 'actual-plus-estimated'
+            : 'actual-only'
+        : estimated !== undefined
+            ? 'estimated-only'
+            : 'unavailable';
+    if (basis.status !== expectedStatus)
+        return false;
+    const combined = amountOf(basis.combined);
+    // Reconciliation may withhold the combined amount even when individual components are available.
+    if (combined === undefined)
+        return true;
+    if (lens === 'actual-only')
+        return actual === combined && coverage.combined === coverage.actual;
+    if (lens === 'estimates-only')
+        return estimated === combined && coverage.combined === coverage.estimated;
+    if (actual === undefined && estimated === undefined)
+        return false;
+    if (combined !== (actual ?? 0n) + (estimated ?? 0n))
+        return false;
+    // A single partial component cannot become a complete combined total. Two components require producer coverage proof.
+    if (actual === undefined)
+        return coverage.combined === coverage.estimated;
+    if (estimated === undefined)
+        return coverage.combined === coverage.actual;
+    return true;
+}
+export function isReportSpendAmounts(value, currency, generatedAt) {
+    if (!isRecord(value) || !exactFields(value, ['composition', 'coverage', 'retail'], ['estimates']) || !isPublicCostComposition(value.composition))
+        return false;
+    if (!isRecord(value.coverage) || !exactFields(value.coverage, [...bases]))
+        return false;
+    if (currency !== undefined && !isReportCurrency(currency))
+        return false;
+    if (generatedAt !== undefined && !isReportUtcTimestamp(generatedAt))
+        return false;
+    if (value.estimates !== undefined && (!isRecord(value.estimates) || !exactFields(value.estimates, [], [...bases])))
+        return false;
+    const currencies = new Set();
+    if (currency)
+        currencies.add(currency);
+    for (const key of bases) {
+        const basis = value.composition[key];
+        if (!isBasisConsistent(basis, value.coverage[key], value.composition.selectedLens))
+            return false;
+        for (const item of [basis.actual.availability, basis.estimated.availability, basis.combined]) {
+            if (item.status === 'available') {
+                if (!isReportCurrency(item.component.currencyCode))
+                    return false;
+                currencies.add(item.component.currencyCode);
+            }
+        }
+        const estimate = isRecord(value.estimates) ? value.estimates[key] : undefined;
+        if (basis.estimated.availability.status === 'available') {
+            if (!isRecord(estimate) ||
+                !exactFields(estimate, ['reason', 'method', 'observedAt']) ||
+                !['billing-lag', 'billing-unavailable-sponsorship', 'other'].includes(estimate.reason) ||
+                !isReportText(estimate.method) ||
+                !isReportUtcTimestamp(estimate.observedAt) ||
+                (generatedAt !== undefined && Date.parse(estimate.observedAt) > Date.parse(generatedAt)))
+                return false;
+        }
+        else if (estimate !== undefined)
+            return false;
+    }
+    const retail = value.retail;
+    if (!isRecord(retail))
+        return false;
+    if (retail.status === 'unavailable') {
+        if (!exactFields(retail, ['status']))
+            return false;
+    }
+    else {
+        if (retail.status !== 'available' ||
+            !exactFields(retail, ['status', 'component', 'coverage', 'scopeDescription', 'pricingSource', 'pricedAt', 'assumptions']) ||
+            !isRecord(retail.component) ||
+            !exactFields(retail.component, ['amount', 'currencyCode']) ||
+            !isReportCurrency(retail.component.currencyCode) ||
+            !['complete', 'partial'].includes(retail.coverage) ||
+            !isReportText(retail.scopeDescription) ||
+            !isReportText(retail.pricingSource) ||
+            !isReportUtcTimestamp(retail.pricedAt) ||
+            (generatedAt !== undefined && Date.parse(retail.pricedAt) > Date.parse(generatedAt)) ||
+            !Array.isArray(retail.assumptions) ||
+            retail.assumptions.length > REPORT_SPEND_LIMITS.assumptions ||
+            !retail.assumptions.every(isReportText))
+            return false;
+        const amount = reportMoneyUnits(retail.component.amount);
+        if (amount === undefined || amount < 0n)
+            return false;
+        currencies.add(retail.component.currencyCode);
+    }
+    return currencies.size <= 1;
+}
+export const hasReportSpendValue = (value) => value.retail.status === 'available' ||
+    bases.some(key => value.composition[key].actual.availability.status === 'available' || value.composition[key].estimated.availability.status === 'available');
+/** Dates, population completeness and actual/estimated selection remain independent checks. */
+export const isReportSpendProjection = (value) => {
+    if (!isRecord(value) ||
+        !exactFields(value, ['currency', 'dateBasis', 'generatedAt', 'freshness', 'periods'], ['sourceObservedAt']) ||
+        !isReportCurrency(value.currency) ||
+        value.dateBasis !== 'billing-calendar' ||
+        !isReportUtcTimestamp(value.generatedAt) ||
+        !['current', 'stale', 'unavailable'].includes(value.freshness) ||
+        !Array.isArray(value.periods) ||
+        value.periods.length > REPORT_SPEND_LIMITS.periods)
+        return false;
+    if (value.sourceObservedAt !== undefined &&
+        (!isReportUtcTimestamp(value.sourceObservedAt) || Date.parse(value.sourceObservedAt) > Date.parse(value.generatedAt)))
+        return false;
+    const seen = new Set();
+    let rollingCount = 0;
+    let historicalCount = 0;
+    let available = false;
+    for (const period of value.periods) {
+        if (!isRecord(period) ||
+            !exactFields(period, ['kind', 'startDate', 'endDate', 'amounts'], ['services']) ||
+            !['calendar-month', 'billing-period', 'rolling-30-days'].includes(period.kind) ||
+            !isReportCalendarDate(period.startDate) ||
+            !isReportCalendarDate(period.endDate))
+            return false;
+        const days = (Date.parse(period.endDate) - Date.parse(period.startDate)) / 86400000 + 1;
+        if (days < 1 || days > REPORT_SPEND_LIMITS.periodDays)
+            return false;
+        if (period.kind === 'calendar-month') {
+            const following = new Date(Date.parse(period.endDate) + 86400000).toISOString().slice(0, 10);
+            if (!period.startDate.endsWith('-01') || period.startDate.slice(0, 7) !== period.endDate.slice(0, 7) || !following.endsWith('-01'))
+                return false;
+        }
+        if (period.kind === 'rolling-30-days') {
+            if (days !== 30 || ++rollingCount > 1)
+                return false;
+        }
+        else if (++historicalCount > 13)
+            return false;
+        const key = `${period.kind}:${period.startDate}:${period.endDate}`;
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        if (!isReportSpendAmounts(period.amounts, value.currency, value.generatedAt))
+            return false;
+        available || (available = hasReportSpendValue(period.amounts));
+        if (period.services !== undefined) {
+            const serviceKeys = new Set();
+            if (!isBoundedRows(period.services, REPORT_SPEND_LIMITS.servicesPerPeriod, (row) => {
+                if (!isRecord(row) ||
+                    !exactFields(row, ['serviceKey', 'name', 'amounts']) ||
+                    !isReportText(row.serviceKey) ||
+                    !isReportText(row.name) ||
+                    serviceKeys.has(row.serviceKey) ||
+                    !isReportSpendAmounts(row.amounts, value.currency, value.generatedAt))
+                    return false;
+                serviceKeys.add(row.serviceKey);
+                available || (available = hasReportSpendValue(row.amounts));
+                return true;
+            }))
+                return false;
+        }
+    }
+    return available ? value.sourceObservedAt !== undefined && value.freshness !== 'unavailable' : value.freshness === 'unavailable';
+};

package/dist/esm/azure/reportSpendValidationHelpers.js

@@ -0,0 +1,22 @@
+import { REPORT_SPEND_LIMITS } from './reportSpend.js';
+export const isReportCalendarDate = (value) => {
+    if (typeof value !== 'string' || !/^\d{4}-\d{2}-\d{2}$/.test(value))
+        return false;
+    const time = Date.parse(`${value}T00:00:00.000Z`);
+    return Number.isFinite(time) && new Date(time).toISOString().slice(0, 10) === value;
+};
+export const isReportUtcTimestamp = (value) => typeof value === 'string' &&
+    /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{3})?Z$/.test(value) &&
+    isReportCalendarDate(value.slice(0, 10)) &&
+    Number.isFinite(Date.parse(value)) &&
+    new Date(value).toISOString() === (value.length === 20 ? value.replace('Z', '.000Z') : value);
+export const isReportCurrency = (value) => typeof value === 'string' && /^[A-Z]{3}$/.test(value);
+export const isReportText = (value) => typeof value === 'string' && value.trim().length > 0 && value.length <= REPORT_SPEND_LIMITS.textLength;
+/** Bounded exact arithmetic avoids binary floating point and pathological decimal-string input. */
+export const reportMoneyUnits = (value) => {
+    if (typeof value !== 'string' || value.length > 25 || !/^-?(?:0|[1-9]\d{0,14})(?:\.\d{1,8})?$/.test(value))
+        return undefined;
+    const [whole, fraction = ''] = value.replace(/^-/, '').split('.');
+    const amount = BigInt(whole) * 100000000n + BigInt(fraction.padEnd(8, '0'));
+    return value.startsWith('-') ? -amount : amount;
+};