@spottoai/types-package 1.0.2-beta.99 → 1.0.2-dev1138.12

package/dist/azure/reportDailySpend.d.ts

@@ -0,0 +1,48 @@
+import type { ReportSpendAmounts } from './reportSpend';
+/** Maximum span of the current month and two preceding complete calendar months. */
+export declare const REPORT_DAILY_SPEND_MAX_DAYS = 92;
+export interface ReportDailySpendEntry {
+    /** Billing-calendar date, YYYY-MM-DD. Entries must be unique and ordered oldest first. */
+    date: string;
+    /** Billed actual total. Omit unless the entire day's actual evidence is covered. Credits may be negative. */
+    cost?: number;
+    /** Amortized actual total; never substitute cost when amortized evidence is absent. */
+    costAmortized?: number;
+    /**
+     * Optional explicit composition and retail benchmark. Complete actual components must also populate
+     * the matching legacy numeric field with the same amount; partial/unknown actuals must omit it.
+     */
+    financials?: ReportSpendAmounts;
+}
+export interface ReportDailySpendCoverage {
+    status: 'complete' | 'partial' | 'unavailable';
+    /** Dates with a confirmed total for this basis, including explicitly confirmed zero-cost days. */
+    coveredDayCount: number;
+}
+/**
+ * Compact actual billing history for one subscription, inheriting the containing pack's scope.
+ * Estimates and retail are allowed only in financials; they never enter legacy actual fields or coverage.
+ * No resource breakdowns or currency conversion. Missing dates/amounts are not zero.
+ * Consumers select the same cost basis and currency for daily charts and monthly headlines.
+ */
+export interface ReportDailySpend {
+    /** Inclusive requested coverage window, at most REPORT_DAILY_SPEND_MAX_DAYS calendar dates. */
+    startDate: string;
+    endDate: string;
+    dateBasis: 'billing-calendar';
+    /** Resolved uppercase three-letter currency code for every amount. */
+    currency: string;
+    /** UTC ISO timestamp when this projection was built. */
+    generatedAt: string;
+    /** Oldest verification timestamp of contributing sources, required when entries exist. */
+    sourceObservedAt?: string;
+    /** Freshness does not establish completeness. Retained complete periods can still be stale. */
+    freshness: 'current' | 'stale' | 'unavailable';
+    coverage: {
+        billed: ReportDailySpendCoverage;
+        amortized: ReportDailySpendCoverage;
+    };
+    /** At least one legacy amount or available financial component per entry. Zero requires confirmed coverage. */
+    entries: ReportDailySpendEntry[];
+}
+//# sourceMappingURL=reportDailySpend.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reportDailySpend.d.ts","sourceRoot":"","sources":["../../src/azure/reportDailySpend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAExD,oFAAoF;AACpF,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAE9C,MAAM,WAAW,qBAAqB;IACpC,0FAA0F;IAC1F,IAAI,EAAE,MAAM,CAAC;IACb,6GAA6G;IAC7G,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uFAAuF;IACvF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,UAAU,CAAC,EAAE,kBAAkB,CAAC;CACjC;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,aAAa,CAAC;IAC/C,kGAAkG;IAClG,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+FAA+F;IAC/F,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,kBAAkB,CAAC;IAC9B,sEAAsE;IACtE,QAAQ,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,0FAA0F;IAC1F,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,+FAA+F;IAC/F,SAAS,EAAE,SAAS,GAAG,OAAO,GAAG,aAAa,CAAC;IAC/C,QAAQ,EAAE;QACR,MAAM,EAAE,wBAAwB,CAAC;QACjC,SAAS,EAAE,wBAAwB,CAAC;KACrC,CAAC;IACF,+GAA+G;IAC/G,OAAO,EAAE,qBAAqB,EAAE,CAAC;CAClC"}

package/dist/azure/reportDailySpend.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REPORT_DAILY_SPEND_MAX_DAYS = void 0;
+/** Maximum span of the current month and two preceding complete calendar months. */
+exports.REPORT_DAILY_SPEND_MAX_DAYS = 92;
+//# sourceMappingURL=reportDailySpend.js.map

package/dist/azure/reportDailySpend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reportDailySpend.js","sourceRoot":"","sources":["../../src/azure/reportDailySpend.ts"],"names":[],"mappings":";;;AAEA,oFAAoF;AACvE,QAAA,2BAA2B,GAAG,EAAE,CAAC"}

package/dist/azure/reportDailySpendValidation.d.ts

@@ -0,0 +1,3 @@
+import { type ReportDailySpend } from './reportDailySpend';
+export declare const isReportDailySpend: (value: unknown) => value is ReportDailySpend;
+//# sourceMappingURL=reportDailySpendValidation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reportDailySpendValidation.d.ts","sourceRoot":"","sources":["../../src/azure/reportDailySpendValidation.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAYxF,eAAO,MAAM,kBAAkB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,gBA0D5D,CAAC"}

package/dist/azure/reportDailySpendValidation.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isReportDailySpend = void 0;
+const reportDailySpend_1 = require("./reportDailySpend");
+const reportEvidenceValidationHelpers_1 = require("./reportEvidenceValidationHelpers");
+const reportSpendValidation_1 = require("./reportSpendValidation");
+const reportSpendValidationHelpers_1 = require("./reportSpendValidationHelpers");
+const DAY_MS = 86400000;
+const isCoverage = (value, covered, expected) => {
+    const status = covered === expected ? 'complete' : covered === 0 ? 'unavailable' : 'partial';
+    return (0, reportEvidenceValidationHelpers_1.isRecord)(value) && (0, reportEvidenceValidationHelpers_1.isCount)(value.coveredDayCount) && value.coveredDayCount === covered && value.status === status;
+};
+const isReportDailySpend = (value) => {
+    if (!(0, reportEvidenceValidationHelpers_1.isRecord)(value) ||
+        !(0, reportSpendValidationHelpers_1.isReportCalendarDate)(value.startDate) ||
+        !(0, reportSpendValidationHelpers_1.isReportCalendarDate)(value.endDate) ||
+        value.dateBasis !== 'billing-calendar' ||
+        typeof value.currency !== 'string' ||
+        !/^[A-Z]{3}$/.test(value.currency) ||
+        !(0, reportSpendValidationHelpers_1.isReportUtcTimestamp)(value.generatedAt) ||
+        !['current', 'stale', 'unavailable'].includes(value.freshness) ||
+        !(0, reportEvidenceValidationHelpers_1.isRecord)(value.coverage) ||
+        !Array.isArray(value.entries) ||
+        value.entries.length > reportDailySpend_1.REPORT_DAILY_SPEND_MAX_DAYS)
+        return false;
+    const expected = (Date.parse(value.endDate) - Date.parse(value.startDate)) / DAY_MS + 1;
+    if (expected < 1 || expected > reportDailySpend_1.REPORT_DAILY_SPEND_MAX_DAYS)
+        return false;
+    if ((value.sourceObservedAt !== undefined &&
+        (!(0, reportSpendValidationHelpers_1.isReportUtcTimestamp)(value.sourceObservedAt) || Date.parse(value.sourceObservedAt) > Date.parse(value.generatedAt))) ||
+        (value.entries.length > 0 && (value.sourceObservedAt === undefined || value.freshness === 'unavailable')))
+        return false;
+    let previousDate = '';
+    let billedDays = 0;
+    let amortizedDays = 0;
+    for (const entry of value.entries) {
+        if (!(0, reportEvidenceValidationHelpers_1.isRecord)(entry) ||
+            !(0, reportSpendValidationHelpers_1.isReportCalendarDate)(entry.date) ||
+            entry.date <= previousDate ||
+            entry.date < value.startDate ||
+            entry.date > value.endDate ||
+            (entry.cost === undefined && entry.costAmortized === undefined && entry.financials === undefined) ||
+            (entry.cost !== undefined && !(0, reportEvidenceValidationHelpers_1.isFiniteNumber)(entry.cost)) ||
+            (entry.costAmortized !== undefined && !(0, reportEvidenceValidationHelpers_1.isFiniteNumber)(entry.costAmortized)))
+            return false;
+        if (entry.financials !== undefined) {
+            if (!(0, reportSpendValidation_1.isReportSpendAmounts)(entry.financials, value.currency, value.generatedAt) || !(0, reportSpendValidation_1.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++;
+        if (entry.costAmortized !== undefined)
+            amortizedDays++;
+    }
+    return isCoverage(value.coverage.billed, billedDays, expected) && isCoverage(value.coverage.amortized, amortizedDays, expected);
+};
+exports.isReportDailySpend = isReportDailySpend;
+//# sourceMappingURL=reportDailySpendValidation.js.map

package/dist/azure/reportDailySpendValidation.js.map

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