@spottoai/types-package 1.0.2-dev1138.1 → 1.0.2-dev1138.12

package/dist/esm/azure/financialChargePolicy.js

@@ -0,0 +1,473 @@
+export const AZURE_CLOUD_SERVICES_EXCLUDING_MARKETPLACE_POLICY_REF_V1 = 'azure-cloud-services-excluding-marketplace/v1';
+const UNKNOWN_REASON_CODES = new Set(['publisher-type-missing', 'publisher-type-unsupported', 'publisher-type-unrecognized']);
+const CHARGEABLE_UNAVAILABLE_REASON_CODES = new Set([
+    'partial-source-coverage',
+    'policy-mismatch',
+    'generation-mismatch',
+    'coordinate-mismatch',
+    'mixed-currency',
+    'source-unavailable',
+    'reconciliation-failed',
+]);
+const ISO_DATE_PATTERN = /^\d{4}-\d{2}-\d{2}$/u;
+const ISO_CURRENCY_PATTERN = /^[A-Z]{3}$/u;
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+const hasExactFields = (value, required, optional = []) => {
+    const allowed = new Set([...required, ...optional]);
+    return required.every(field => Object.prototype.hasOwnProperty.call(value, field)) && Object.keys(value).every(field => allowed.has(field));
+};
+const isNonEmptyTrimmedString = (value) => typeof value === 'string' && value.length > 0 && value === value.trim();
+const isSafeInteger = (value) => typeof value === 'number' && Number.isSafeInteger(value);
+const isNonNegativeSafeInteger = (value) => isSafeInteger(value) && value >= 0;
+const isIsoDate = (value) => {
+    if (typeof value !== 'string' || !ISO_DATE_PATTERN.test(value))
+        return false;
+    const [year, month, day] = value.split('-').map(Number);
+    const parsed = new Date(`${value}T00:00:00.000Z`);
+    return !Number.isNaN(parsed.getTime()) && parsed.getUTCFullYear() === year && parsed.getUTCMonth() + 1 === month && parsed.getUTCDate() === day;
+};
+const MONEY_UNAVAILABLE_REASONS = new Set(['billing-unavailable', 'not-produced', 'currency-unresolved', 'coverage-unproven']);
+const checkedSafeIntegerSum = (values) => {
+    let total = 0;
+    for (const value of values) {
+        const nextTotal = total + value;
+        if (!Number.isSafeInteger(nextTotal))
+            return undefined;
+        total = nextTotal;
+    }
+    return total;
+};
+const isSpendBasisTotals = (value) => {
+    if (!isRecord(value))
+        return false;
+    if (value.status === 'unavailable') {
+        return hasExactFields(value, ['status', 'reasonCode']) && typeof value.reasonCode === 'string' && MONEY_UNAVAILABLE_REASONS.has(value.reasonCode);
+    }
+    if (value.status !== 'available' ||
+        !hasExactFields(value, ['status', 'totalMinorUnits', 'billingBackedMinorUnits', 'estimatedMinorUnits']) ||
+        !isSafeInteger(value.totalMinorUnits) ||
+        !isSafeInteger(value.billingBackedMinorUnits) ||
+        !isSafeInteger(value.estimatedMinorUnits)) {
+        return false;
+    }
+    return checkedSafeIntegerSum([value.billingBackedMinorUnits, value.estimatedMinorUnits]) === value.totalMinorUnits;
+};
+const isSpendSourceTotals = (value) => isRecord(value) && hasExactFields(value, ['billed', 'amortized']) && isSpendBasisTotals(value.billed) && isSpendBasisTotals(value.amortized);
+const isSpendSubject = (value) => {
+    if (!isRecord(value) || (value.kind !== 'provider-scope' && value.kind !== 'resource'))
+        return false;
+    if (value.kind === 'provider-scope') {
+        return hasExactFields(value, ['kind', 'providerScopeId']) && isNonEmptyTrimmedString(value.providerScopeId);
+    }
+    return (hasExactFields(value, ['kind', 'providerScopeId', 'resourceId']) &&
+        isNonEmptyTrimmedString(value.providerScopeId) &&
+        isNonEmptyTrimmedString(value.resourceId));
+};
+const isUnknownMaterial = (value) => isRecord(value) &&
+    hasExactFields(value, ['nonZeroRowCount', 'billedAbsoluteMinorUnits', 'amortizedAbsoluteMinorUnits']) &&
+    isNonNegativeSafeInteger(value.nonZeroRowCount) &&
+    isNonNegativeSafeInteger(value.billedAbsoluteMinorUnits) &&
+    isNonNegativeSafeInteger(value.amortizedAbsoluteMinorUnits);
+/** Exact validator for one rolling all-charge/Azure-native/Marketplace/unknown partition. */
+export const isAzureFinancialChargeSpendBreakdownV1 = (value) => {
+    if (!isRecord(value) ||
+        !hasExactFields(value, [
+            'contractVersion',
+            'policyRef',
+            'generationId',
+            'subject',
+            'period',
+            'currencyCode',
+            'minorUnitScale',
+            'status',
+            'allCharge',
+            'azureNative',
+            'marketplace',
+            'unknown',
+            'unknownMaterial',
+        ]) ||
+        value.contractVersion !== 'financial-charge-spend/v1' ||
+        value.policyRef !== AZURE_CLOUD_SERVICES_EXCLUDING_MARKETPLACE_POLICY_REF_V1 ||
+        !isNonEmptyTrimmedString(value.generationId) ||
+        !isSpendSubject(value.subject) ||
+        !isRecord(value.period) ||
+        !hasExactFields(value.period, ['startDate', 'endDateExclusive']) ||
+        !isIsoDate(value.period.startDate) ||
+        !isIsoDate(value.period.endDateExclusive) ||
+        value.period.startDate >= value.period.endDateExclusive ||
+        typeof value.currencyCode !== 'string' ||
+        !ISO_CURRENCY_PATTERN.test(value.currencyCode) ||
+        !isNonNegativeSafeInteger(value.minorUnitScale) ||
+        value.minorUnitScale > 6 ||
+        (value.status !== 'complete' && value.status !== 'partial') ||
+        !isSpendSourceTotals(value.allCharge) ||
+        !isSpendSourceTotals(value.azureNative) ||
+        !isSpendSourceTotals(value.marketplace) ||
+        !isSpendSourceTotals(value.unknown) ||
+        !isUnknownMaterial(value.unknownMaterial)) {
+        return false;
+    }
+    const breakdown = value;
+    const sources = [breakdown.azureNative, breakdown.marketplace, breakdown.unknown];
+    for (const basis of ['billed', 'amortized']) {
+        const partitions = [breakdown.allCharge[basis], ...sources.map(source => source[basis])];
+        if (!partitions.every(partition => partition.status === partitions[0].status))
+            return false;
+        if (partitions[0].status === 'unavailable')
+            continue;
+        for (const key of ['totalMinorUnits', 'billingBackedMinorUnits', 'estimatedMinorUnits']) {
+            const sourceValues = sources.map(source => {
+                const sourceBasis = source[basis];
+                return sourceBasis.status === 'available' ? sourceBasis[key] : undefined;
+            });
+            if (sourceValues.some(sourceValue => sourceValue === undefined))
+                return false;
+            const sourceTotal = checkedSafeIntegerSum(sourceValues);
+            const allChargeBasis = breakdown.allCharge[basis];
+            if (sourceTotal === undefined || allChargeBasis.status !== 'available' || allChargeBasis[key] !== sourceTotal)
+                return false;
+        }
+    }
+    const materialUnknown = breakdown.unknownMaterial.nonZeroRowCount > 0;
+    if (materialUnknown) {
+        if (breakdown.status !== 'partial')
+            return false;
+        if (breakdown.unknownMaterial.billedAbsoluteMinorUnits === 0 && breakdown.unknownMaterial.amortizedAbsoluteMinorUnits === 0)
+            return false;
+    }
+    else if (breakdown.status !== 'complete' ||
+        breakdown.unknownMaterial.billedAbsoluteMinorUnits !== 0 ||
+        breakdown.unknownMaterial.amortizedAbsoluteMinorUnits !== 0) {
+        return false;
+    }
+    const unknownAbsoluteByBasis = {
+        billed: breakdown.unknownMaterial.billedAbsoluteMinorUnits,
+        amortized: breakdown.unknownMaterial.amortizedAbsoluteMinorUnits,
+    };
+    return ['billed', 'amortized'].every(basis => {
+        const unknownBasis = breakdown.unknown[basis];
+        return unknownBasis.status === 'unavailable' || Math.abs(unknownBasis.totalMinorUnits) <= unknownAbsoluteByBasis[basis];
+    });
+};
+export const isAzureProviderScopeFinancialChargeSpendBreakdownV1 = (value) => isAzureFinancialChargeSpendBreakdownV1(value) && value.subject.kind === 'provider-scope';
+export const isAzureResourceFinancialChargeSpendBreakdownV1 = (value) => isAzureFinancialChargeSpendBreakdownV1(value) && value.subject.kind === 'resource';
+/** Validates both the resource-level shape and its binding to the enclosing resource ID. */
+export const isAzureResourceFinancialChargeSpendBreakdownForResourceV1 = (value, resourceId) => isNonEmptyTrimmedString(resourceId) &&
+    isAzureResourceFinancialChargeSpendBreakdownV1(value) &&
+    value.subject.resourceId.toLowerCase().replace(/\/+$/u, '') === resourceId.toLowerCase().replace(/\/+$/u, '');
+const areStringArraysEqual = (left, right) => left.length === right.length && left.every((value, index) => value === right[index]);
+const isSortedUniqueStringArray = (value, allowedValues) => {
+    if (!Array.isArray(value) || value.length === 0 || !value.every(item => typeof item === 'string' && allowedValues.has(item)))
+        return false;
+    const canonical = [...new Set(value)].sort();
+    return areStringArraysEqual(value, canonical);
+};
+/** Exact validator for publisher evidence retained from an Azure billing source. */
+export const isAzurePublisherTypeEvidenceV1 = (value) => {
+    if (!isRecord(value) || (value.status !== 'available' && value.status !== 'unavailable'))
+        return false;
+    if (value.status === 'available') {
+        return (hasExactFields(value, ['status', 'publisherType'], ['publisherName']) &&
+            isNonEmptyTrimmedString(value.publisherType) &&
+            (value.publisherName === undefined || isNonEmptyTrimmedString(value.publisherName)));
+    }
+    return (hasExactFields(value, ['status', 'reasonCode']) &&
+        (value.reasonCode === 'publisher-type-missing' || value.reasonCode === 'publisher-type-unsupported'));
+};
+/** Exact validator for the authoritative classification of one billing component. */
+export const isAzureFinancialChargeClassificationV1 = (value) => {
+    if (!isRecord(value) || (value.source !== 'azure-native' && value.source !== 'marketplace' && value.source !== 'unknown'))
+        return false;
+    const publisherNameIsValid = value.publisherName === undefined || isNonEmptyTrimmedString(value.publisherName);
+    if (!publisherNameIsValid)
+        return false;
+    if (value.source === 'azure-native' || value.source === 'marketplace') {
+        if (!hasExactFields(value, ['source', 'publisherType'], ['publisherName']) || !isNonEmptyTrimmedString(value.publisherType)) {
+            return false;
+        }
+        const publisherType = value.publisherType.toLowerCase();
+        return value.source === 'marketplace' ? publisherType === 'marketplace' : publisherType === 'azure' || publisherType === 'microsoft';
+    }
+    if (!hasExactFields(value, ['source', 'reasonCode'], ['publisherType', 'publisherName']) ||
+        typeof value.reasonCode !== 'string' ||
+        !UNKNOWN_REASON_CODES.has(value.reasonCode)) {
+        return false;
+    }
+    if (value.reasonCode === 'publisher-type-unrecognized') {
+        if (!isNonEmptyTrimmedString(value.publisherType))
+            return false;
+        const publisherType = value.publisherType.toLowerCase();
+        return publisherType !== 'azure' && publisherType !== 'microsoft' && publisherType !== 'marketplace';
+    }
+    return value.publisherType === undefined;
+};
+export const isAzureFinancialCoordinateV1 = (value) => {
+    if (!isRecord(value) ||
+        !hasExactFields(value, ['generationId', 'providerName', 'providerScopeId', 'basis', 'period', 'currencyCode', 'minorUnitScale'])) {
+        return false;
+    }
+    if (!isNonEmptyTrimmedString(value.generationId) ||
+        value.providerName !== 'azure' ||
+        !isNonEmptyTrimmedString(value.providerScopeId) ||
+        (value.basis !== 'billed' && value.basis !== 'amortized') ||
+        typeof value.currencyCode !== 'string' ||
+        !ISO_CURRENCY_PATTERN.test(value.currencyCode) ||
+        !isNonNegativeSafeInteger(value.minorUnitScale) ||
+        value.minorUnitScale > 6 ||
+        !isRecord(value.period) ||
+        !hasExactFields(value.period, ['startDate', 'endDateExclusive']) ||
+        !isIsoDate(value.period.startDate) ||
+        !isIsoDate(value.period.endDateExclusive)) {
+        return false;
+    }
+    return value.period.startDate < value.period.endDateExclusive;
+};
+const isSourceTotals = (value) => {
+    if (!isRecord(value) ||
+        !hasExactFields(value, [
+            'allChargeMinorUnits',
+            'azureNativeMinorUnits',
+            'marketplaceMinorUnits',
+            'unknownMinorUnits',
+            'unknownAbsoluteMinorUnits',
+            'rowCount',
+            'azureNativeRowCount',
+            'marketplaceRowCount',
+            'unknownRowCount',
+            'unknownNonZeroRowCount',
+        ])) {
+        return false;
+    }
+    const signedValues = [value.allChargeMinorUnits, value.azureNativeMinorUnits, value.marketplaceMinorUnits, value.unknownMinorUnits];
+    const countValues = [
+        value.unknownAbsoluteMinorUnits,
+        value.rowCount,
+        value.azureNativeRowCount,
+        value.marketplaceRowCount,
+        value.unknownRowCount,
+        value.unknownNonZeroRowCount,
+    ];
+    if (!signedValues.every(isSafeInteger) || !countValues.every(isNonNegativeSafeInteger))
+        return false;
+    const totals = value;
+    return (totals.unknownNonZeroRowCount <= totals.unknownRowCount &&
+        totals.rowCount === totals.azureNativeRowCount + totals.marketplaceRowCount + totals.unknownRowCount &&
+        totals.allChargeMinorUnits === totals.azureNativeMinorUnits + totals.marketplaceMinorUnits + totals.unknownMinorUnits);
+};
+const isUnknownObject = (value) => isRecord(value) &&
+    hasExactFields(value, [
+        'objectKey',
+        'name',
+        'resourceType',
+        'billableComponentKey',
+        'signedCostMinorUnits',
+        'absoluteCostMinorUnits',
+        'rowCount',
+        'nonZeroRowCount',
+        'reasonCodes',
+    ], ['resourceId']) &&
+    isNonEmptyTrimmedString(value.objectKey) &&
+    isNonEmptyTrimmedString(value.name) &&
+    isNonEmptyTrimmedString(value.resourceType) &&
+    (value.resourceId === undefined || isNonEmptyTrimmedString(value.resourceId)) &&
+    isNonEmptyTrimmedString(value.billableComponentKey) &&
+    isSafeInteger(value.signedCostMinorUnits) &&
+    isNonNegativeSafeInteger(value.absoluteCostMinorUnits) &&
+    isNonNegativeSafeInteger(value.rowCount) &&
+    value.rowCount > 0 &&
+    isNonNegativeSafeInteger(value.nonZeroRowCount) &&
+    value.nonZeroRowCount > 0 &&
+    value.nonZeroRowCount <= value.rowCount &&
+    isSortedUniqueStringArray(value.reasonCodes, UNKNOWN_REASON_CODES);
+const coordinatesEqual = (left, right) => left.generationId === right.generationId &&
+    left.providerName === right.providerName &&
+    left.providerScopeId === right.providerScopeId &&
+    left.basis === right.basis &&
+    left.period.startDate === right.period.startDate &&
+    left.period.endDateExclusive === right.period.endDateExclusive &&
+    left.currencyCode === right.currencyCode &&
+    left.minorUnitScale === right.minorUnitScale;
+export const isAzureFinancialChargeCoverageV1 = (value) => {
+    if (!isRecord(value) ||
+        !hasExactFields(value, ['contractVersion', 'policyRef', 'coordinate', 'status', 'sourceTotals', 'unknownObjects']) ||
+        value.contractVersion !== 'financial-charge-policy/v1' ||
+        value.policyRef !== AZURE_CLOUD_SERVICES_EXCLUDING_MARKETPLACE_POLICY_REF_V1 ||
+        !isAzureFinancialCoordinateV1(value.coordinate) ||
+        (value.status !== 'complete' && value.status !== 'partial') ||
+        !isSourceTotals(value.sourceTotals) ||
+        !Array.isArray(value.unknownObjects) ||
+        !value.unknownObjects.every(isUnknownObject)) {
+        return false;
+    }
+    const objectKeys = value.unknownObjects.map(item => item.objectKey);
+    if (!areStringArraysEqual(objectKeys, [...new Set(objectKeys)].sort()))
+        return false;
+    const objectSignedTotal = value.unknownObjects.reduce((total, item) => total + item.signedCostMinorUnits, 0);
+    const objectAbsoluteTotal = value.unknownObjects.reduce((total, item) => total + item.absoluteCostMinorUnits, 0);
+    const objectNonZeroRows = value.unknownObjects.reduce((total, item) => total + item.nonZeroRowCount, 0);
+    if (!Number.isSafeInteger(objectSignedTotal) ||
+        !Number.isSafeInteger(objectAbsoluteTotal) ||
+        !Number.isSafeInteger(objectNonZeroRows) ||
+        objectSignedTotal !== value.sourceTotals.unknownMinorUnits ||
+        objectAbsoluteTotal !== value.sourceTotals.unknownAbsoluteMinorUnits ||
+        objectNonZeroRows !== value.sourceTotals.unknownNonZeroRowCount) {
+        return false;
+    }
+    const hasMaterialUnknown = value.sourceTotals.unknownNonZeroRowCount > 0;
+    if (value.status === 'complete') {
+        return !hasMaterialUnknown && value.sourceTotals.unknownAbsoluteMinorUnits === 0 && value.unknownObjects.length === 0;
+    }
+    return hasMaterialUnknown && value.unknownObjects.length > 0;
+};
+const isCanonicalSavingsAggregateV2 = (value, coordinate) => {
+    if (!isRecord(value) ||
+        !hasExactFields(value, ['contractVersion', 'generationId', 'scopeKey', 'scope', 'allocationCount', 'totals']) ||
+        value.contractVersion !== 'savings/v2' ||
+        value.generationId !== coordinate.generationId ||
+        !isNonEmptyTrimmedString(value.scopeKey) ||
+        !isNonNegativeSafeInteger(value.allocationCount) ||
+        !isRecord(value.scope) ||
+        !hasExactFields(value.scope, ['kind', 'providerName', 'providerScopeId', 'filterFingerprint']) ||
+        value.scope.kind !== 'subscription-full' ||
+        value.scope.providerName !== 'azure' ||
+        value.scope.providerScopeId !== coordinate.providerScopeId ||
+        !isNonEmptyTrimmedString(value.scope.filterFingerprint) ||
+        !isRecord(value.totals) ||
+        !hasExactFields(value.totals, ['currency', 'minorUnitScale', 'currentMonthlyMinorUnits', 'minSavingsMinorUnits', 'maxSavingsMinorUnits']) ||
+        value.totals.currency !== coordinate.currencyCode ||
+        value.totals.minorUnitScale !== coordinate.minorUnitScale ||
+        !isNonNegativeSafeInteger(value.totals.currentMonthlyMinorUnits) ||
+        !isNonNegativeSafeInteger(value.totals.minSavingsMinorUnits) ||
+        !isNonNegativeSafeInteger(value.totals.maxSavingsMinorUnits)) {
+        return false;
+    }
+    return value.totals.minSavingsMinorUnits <= value.totals.maxSavingsMinorUnits;
+};
+export const isAzurePolicyBoundSavingsAggregateV1 = (value) => {
+    if (!isRecord(value) ||
+        !hasExactFields(value, ['contractVersion', 'policyRef', 'coordinate', 'coverage', 'savingsAggregate']) ||
+        value.contractVersion !== 'financial-charge-policy/v1' ||
+        value.policyRef !== AZURE_CLOUD_SERVICES_EXCLUDING_MARKETPLACE_POLICY_REF_V1 ||
+        !isAzureFinancialCoordinateV1(value.coordinate) ||
+        !isAzureFinancialChargeCoverageV1(value.coverage) ||
+        !coordinatesEqual(value.coordinate, value.coverage.coordinate)) {
+        return false;
+    }
+    return isCanonicalSavingsAggregateV2(value.savingsAggregate, value.coordinate);
+};
+export const isAzureChargeableSavingsV1 = (value) => {
+    if (!isRecord(value) ||
+        value.contractVersion !== 'financial-charge-policy/v1' ||
+        value.policyRef !== AZURE_CLOUD_SERVICES_EXCLUDING_MARKETPLACE_POLICY_REF_V1 ||
+        !isAzureFinancialCoordinateV1(value.coordinate) ||
+        !isAzureFinancialChargeCoverageV1(value.coverage) ||
+        !coordinatesEqual(value.coordinate, value.coverage.coordinate)) {
+        return false;
+    }
+    if (value.status === 'available') {
+        return (hasExactFields(value, [
+            'contractVersion',
+            'policyRef',
+            'coordinate',
+            'status',
+            'coverage',
+            'savingsAggregate',
+            'chargeableMaxSavingsMinorUnits',
+        ]) &&
+            value.coverage.status === 'complete' &&
+            isCanonicalSavingsAggregateV2(value.savingsAggregate, value.coordinate) &&
+            isNonNegativeSafeInteger(value.chargeableMaxSavingsMinorUnits) &&
+            value.chargeableMaxSavingsMinorUnits === value.savingsAggregate.totals.maxSavingsMinorUnits);
+    }
+    return (value.status === 'unavailable' &&
+        hasExactFields(value, ['contractVersion', 'policyRef', 'coordinate', 'status', 'coverage', 'reasonCodes']) &&
+        isSortedUniqueStringArray(value.reasonCodes, CHARGEABLE_UNAVAILABLE_REASON_CODES));
+};
+const COMPANY_CHARGEABLE_UNAVAILABLE_REASON_CODES = new Set([
+    ...CHARGEABLE_UNAVAILABLE_REASON_CODES,
+    'no-provider-scopes',
+    'scope-unavailable',
+    'mixed-minor-unit-scale',
+]);
+/** Exact boundary validator for the company-level billing projection. */
+export const isAzureCompanyChargeableSavingsResponseV1 = (value) => {
+    if (!isRecord(value) ||
+        !hasExactFields(value, ['contractVersion', 'policyRef', 'companyId', 'scopeResults', 'companyTotal']) ||
+        value.contractVersion !== 'financial-charge-policy/v1' ||
+        value.policyRef !== AZURE_CLOUD_SERVICES_EXCLUDING_MARKETPLACE_POLICY_REF_V1 ||
+        !isNonEmptyTrimmedString(value.companyId) ||
+        !Array.isArray(value.scopeResults) ||
+        !isRecord(value.companyTotal)) {
+        return false;
+    }
+    const providerScopeIds = new Set();
+    for (const scopeResult of value.scopeResults) {
+        if (!isRecord(scopeResult) || !isNonEmptyTrimmedString(scopeResult.providerScopeId))
+            return false;
+        const normalizedScopeId = scopeResult.providerScopeId.toLowerCase();
+        if (providerScopeIds.has(normalizedScopeId))
+            return false;
+        providerScopeIds.add(normalizedScopeId);
+        if (scopeResult.status === 'available') {
+            if (!hasExactFields(scopeResult, [
+                'providerScopeId',
+                'status',
+                'generationId',
+                'basis',
+                'period',
+                'currencyCode',
+                'minorUnitScale',
+                'chargeableMaxSavingsMinorUnits',
+            ]) ||
+                !isNonEmptyTrimmedString(scopeResult.generationId) ||
+                (scopeResult.basis !== 'billed' && scopeResult.basis !== 'amortized') ||
+                !isRecord(scopeResult.period) ||
+                !hasExactFields(scopeResult.period, ['startDate', 'endDateExclusive']) ||
+                !isIsoDate(scopeResult.period.startDate) ||
+                !isIsoDate(scopeResult.period.endDateExclusive) ||
+                scopeResult.period.startDate >= scopeResult.period.endDateExclusive ||
+                typeof scopeResult.currencyCode !== 'string' ||
+                !ISO_CURRENCY_PATTERN.test(scopeResult.currencyCode) ||
+                !isNonNegativeSafeInteger(scopeResult.minorUnitScale) ||
+                scopeResult.minorUnitScale > 6 ||
+                !isNonNegativeSafeInteger(scopeResult.chargeableMaxSavingsMinorUnits)) {
+                return false;
+            }
+            continue;
+        }
+        if (scopeResult.status !== 'unavailable' ||
+            !hasExactFields(scopeResult, ['providerScopeId', 'status', 'reasonCodes']) ||
+            !isSortedUniqueStringArray(scopeResult.reasonCodes, COMPANY_CHARGEABLE_UNAVAILABLE_REASON_CODES)) {
+            return false;
+        }
+    }
+    if (value.companyTotal.status === 'available') {
+        if (!hasExactFields(value.companyTotal, ['status', 'basis', 'period', 'currencyCode', 'minorUnitScale', 'chargeableMaxSavingsMinorUnits']) ||
+            (value.companyTotal.basis !== 'billed' && value.companyTotal.basis !== 'amortized') ||
+            !isRecord(value.companyTotal.period) ||
+            !hasExactFields(value.companyTotal.period, ['startDate', 'endDateExclusive']) ||
+            !isIsoDate(value.companyTotal.period.startDate) ||
+            !isIsoDate(value.companyTotal.period.endDateExclusive) ||
+            value.companyTotal.period.startDate >= value.companyTotal.period.endDateExclusive ||
+            typeof value.companyTotal.currencyCode !== 'string' ||
+            !ISO_CURRENCY_PATTERN.test(value.companyTotal.currencyCode) ||
+            !isNonNegativeSafeInteger(value.companyTotal.minorUnitScale) ||
+            !isNonNegativeSafeInteger(value.companyTotal.chargeableMaxSavingsMinorUnits) ||
+            value.scopeResults.some(scopeResult => scopeResult.status !== 'available')) {
+            return false;
+        }
+        const availableScopes = value.scopeResults.filter((scopeResult) => scopeResult.status === 'available');
+        const companyTotal = value.companyTotal;
+        const total = availableScopes.reduce((sum, scopeResult) => sum + scopeResult.chargeableMaxSavingsMinorUnits, 0);
+        return (Number.isSafeInteger(total) &&
+            total === companyTotal.chargeableMaxSavingsMinorUnits &&
+            availableScopes.every(scopeResult => scopeResult.basis === companyTotal.basis &&
+                scopeResult.period.startDate === companyTotal.period.startDate &&
+                scopeResult.period.endDateExclusive === companyTotal.period.endDateExclusive &&
+                scopeResult.currencyCode === companyTotal.currencyCode &&
+                scopeResult.minorUnitScale === companyTotal.minorUnitScale));
+    }
+    return (value.companyTotal.status === 'unavailable' &&
+        hasExactFields(value.companyTotal, ['status', 'reasonCodes']) &&
+        isSortedUniqueStringArray(value.companyTotal.reasonCodes, COMPANY_CHARGEABLE_UNAVAILABLE_REASON_CODES));
+};

package/dist/esm/azure/financialCurrentSpendSurfaceProjection.js

@@ -0,0 +1,2 @@
+export const FINANCIAL_CURRENT_SPEND_SURFACE_PROJECTION_SCHEMA_VERSION_V1 = 1;
+export const FINANCIAL_CURRENT_SPEND_SURFACE_PROJECTION_CONTRACT_VERSION_V1 = 'financial-current-spend-surface-projection/v1';

package/dist/esm/azure/financialCurrentSpendSurfaceProjectionValidation.js

@@ -0,0 +1,184 @@
+import { sha256Utf8 } from '../common/sha256.js';
+import { isFinancialChargeInclusionPolicyRefV1 } from './financialChargeCompositionValidation.js';
+import { FINANCIAL_CURRENT_SPEND_SURFACE_PROJECTION_CONTRACT_VERSION_V1, FINANCIAL_CURRENT_SPEND_SURFACE_PROJECTION_SCHEMA_VERSION_V1, } from './financialCurrentSpendSurfaceProjection.js';
+import { canonicalizeFinancialSavingsJsonValue, hasExactFinancialSavingsFields, isFinancialSavingsHash, isFinancialSavingsIdentity, isFinancialSavingsIsoInstant, isFinancialSavingsRecord, } from './financialSavingsAuthorityValidationPrimitives.js';
+import { isCanonicalExactMoney } from './financialValidationPrimitives.js';
+const CURRENCIES = /^[A-Z]{3}$/;
+const CALENDAR_DATE = /^\d{4}-\d{2}-\d{2}$/;
+const WINDOW_KINDS = new Set([
+    'rolling-30-days',
+    'calendar-month',
+    'provider-billing-period',
+    'stable-billing-window',
+    'analytics-history',
+    'daily',
+]);
+const PERIOD_ROLES = new Set(['current-spend', 'comparison', 'analytics-input', 'projection-target']);
+const COST_BASES = new Set(['billed', 'amortized']);
+const ESTIMATE_LENSES = new Set(['billing-only', 'include-estimates', 'estimates-only']);
+const SCOPE_KINDS = new Set(['subscription', 'resource-group', 'tag-scope', 'multi-subscription']);
+const MAX_COORDINATES = 128;
+const MAX_REASONS = 64;
+const isCurrency = (value) => typeof value === 'string' && CURRENCIES.test(value);
+const isCalendarDate = (value) => {
+    if (typeof value !== 'string' || !CALENDAR_DATE.test(value))
+        return false;
+    const date = new Date(`${value}T00:00:00.000Z`);
+    return Number.isFinite(date.getTime()) && date.toISOString().slice(0, 10) === value;
+};
+const isInterval = (value) => isFinancialSavingsRecord(value) &&
+    hasExactFinancialSavingsFields(value, ['startDate', 'endDateExclusive', 'dateBasis'], ['timeZone']) &&
+    isCalendarDate(value.startDate) &&
+    isCalendarDate(value.endDateExclusive) &&
+    value.startDate < value.endDateExclusive &&
+    (value.dateBasis === 'utc' || value.dateBasis === 'billing-calendar' || value.dateBasis === 'company-local') &&
+    (value.timeZone === undefined || isFinancialSavingsIdentity(value.timeZone));
+export const isFinancialSurfacePeriodV1 = (value) => {
+    if (!isFinancialSavingsRecord(value) ||
+        !hasExactFinancialSavingsFields(value, ['windowKind', 'requested'], ['observed', 'providerBillingPeriodId']) ||
+        typeof value.windowKind !== 'string' ||
+        !WINDOW_KINDS.has(value.windowKind) ||
+        !isInterval(value.requested) ||
+        (value.observed !== undefined && !isInterval(value.observed)) ||
+        (value.providerBillingPeriodId !== undefined && !isFinancialSavingsIdentity(value.providerBillingPeriodId)))
+        return false;
+    if (value.observed === undefined)
+        return true;
+    const requested = value.requested;
+    const observed = value.observed;
+    return observed.startDate >= requested.startDate && observed.endDateExclusive <= requested.endDateExclusive;
+};
+export const canonicalizeFinancialSurfaceCoordinateIdentityV1 = (value) => JSON.stringify(canonicalizeFinancialSavingsJsonValue(value));
+export const createFinancialSurfaceCoordinateIdV1 = (value) => `sha256:${sha256Utf8(canonicalizeFinancialSurfaceCoordinateIdentityV1(value))}`;
+export const isFinancialSurfaceCoordinateDefinitionV1 = (value) => {
+    if (!isFinancialSavingsRecord(value) ||
+        !hasExactFinancialSavingsFields(value, ['coordinateId', 'periodRole', 'period', 'costBasis', 'estimateLens', 'chargeInclusionPolicyRef'], ['requestedCurrencyCode']) ||
+        !isFinancialSavingsHash(value.coordinateId) ||
+        typeof value.periodRole !== 'string' ||
+        !PERIOD_ROLES.has(value.periodRole) ||
+        !isFinancialSurfacePeriodV1(value.period) ||
+        typeof value.costBasis !== 'string' ||
+        !COST_BASES.has(value.costBasis) ||
+        typeof value.estimateLens !== 'string' ||
+        !ESTIMATE_LENSES.has(value.estimateLens) ||
+        !isFinancialChargeInclusionPolicyRefV1(value.chargeInclusionPolicyRef) ||
+        (value.requestedCurrencyCode !== undefined && !isCurrency(value.requestedCurrencyCode)))
+        return false;
+    const coordinate = value;
+    const { coordinateId: _coordinateId, ...identity } = coordinate;
+    return coordinate.coordinateId === createFinancialSurfaceCoordinateIdV1(identity);
+};
+const isReasonCodes = (value) => Array.isArray(value) &&
+    value.length > 0 &&
+    value.length <= MAX_REASONS &&
+    value.every(isFinancialSavingsIdentity) &&
+    new Set(value).size === value.length;
+const isExactAmount = (amount, currencyCode) => isCurrency(currencyCode) && isCanonicalExactMoney({ amount, currencyCode });
+const isNonNegativeExactAmount = (amount, currencyCode) => isExactAmount(amount, currencyCode) && typeof amount === 'string' && !amount.startsWith('-');
+export const isFinancialSurfaceMoneyV1 = (value, requestedCurrencyCode) => {
+    if (!isFinancialSavingsRecord(value))
+        return false;
+    if (value.status === 'available') {
+        return (hasExactFinancialSavingsFields(value, [
+            'status',
+            'amount',
+            'currencyCode',
+            'completeness',
+            'excludedAmount',
+            'withheldAmount',
+        ]) &&
+            value.completeness === 'complete' &&
+            isExactAmount(value.amount, value.currencyCode) &&
+            isNonNegativeExactAmount(value.excludedAmount, value.currencyCode) &&
+            isNonNegativeExactAmount(value.withheldAmount, value.currencyCode) &&
+            (requestedCurrencyCode === undefined || value.currencyCode === requestedCurrencyCode));
+    }
+    if (value.status === 'partial') {
+        return (hasExactFinancialSavingsFields(value, [
+            'status',
+            'knownAmount',
+            'currencyCode',
+            'completeness',
+            'excludedAmount',
+            'withheldAmount',
+            'reasonCodes',
+        ]) &&
+            value.completeness === 'partial' &&
+            isExactAmount(value.knownAmount, value.currencyCode) &&
+            isNonNegativeExactAmount(value.excludedAmount, value.currencyCode) &&
+            isNonNegativeExactAmount(value.withheldAmount, value.currencyCode) &&
+            isReasonCodes(value.reasonCodes) &&
+            (requestedCurrencyCode === undefined || value.currencyCode === requestedCurrencyCode));
+    }
+    return (value.status === 'unavailable' &&
+        hasExactFinancialSavingsFields(value, ['status', 'completeness', 'reasonCodes']) &&
+        value.completeness === 'unavailable' &&
+        isReasonCodes(value.reasonCodes));
+};
+const canonicalizeMoney = (value) => value.status === 'available' ? value : { ...value, reasonCodes: [...value.reasonCodes].sort() };
+export const canonicalizeFinancialCurrentSpendSurfaceProjectionIdentityV1 = (value) => JSON.stringify(canonicalizeFinancialSavingsJsonValue({
+    ...value,
+    providerAccountRefs: [...value.providerAccountRefs].sort(),
+    coordinates: [...value.coordinates]
+        .sort((left, right) => left.coordinateId.localeCompare(right.coordinateId))
+        .map(coordinate => ({ ...coordinate, value: canonicalizeMoney(coordinate.value) })),
+}));
+export const createFinancialCurrentSpendSurfaceProjectionIdV1 = (value) => `sha256:${sha256Utf8(canonicalizeFinancialCurrentSpendSurfaceProjectionIdentityV1(value))}`;
+export const isFinancialCurrentSpendSurfaceProjectionV1 = (value) => {
+    if (!isFinancialSavingsRecord(value) ||
+        !hasExactFinancialSavingsFields(value, [
+            'schemaVersion',
+            'contractVersion',
+            'projectionId',
+            'provider',
+            'providerAccountRefs',
+            'artifactGeneration',
+            'financialAuthorityId',
+            'scope',
+            'coordinates',
+        ]) ||
+        value.schemaVersion !== FINANCIAL_CURRENT_SPEND_SURFACE_PROJECTION_SCHEMA_VERSION_V1 ||
+        value.contractVersion !== FINANCIAL_CURRENT_SPEND_SURFACE_PROJECTION_CONTRACT_VERSION_V1 ||
+        !isFinancialSavingsHash(value.projectionId) ||
+        value.provider !== 'azure' ||
+        !Array.isArray(value.providerAccountRefs) ||
+        value.providerAccountRefs.length === 0 ||
+        value.providerAccountRefs.length > 64 ||
+        !value.providerAccountRefs.every(isFinancialSavingsIdentity) ||
+        new Set(value.providerAccountRefs).size !== value.providerAccountRefs.length ||
+        !isFinancialSavingsRecord(value.artifactGeneration) ||
+        !hasExactFinancialSavingsFields(value.artifactGeneration, ['runId', 'generatedAt']) ||
+        !isFinancialSavingsIdentity(value.artifactGeneration.runId) ||
+        !isFinancialSavingsIsoInstant(value.artifactGeneration.generatedAt) ||
+        !isFinancialSavingsHash(value.financialAuthorityId) ||
+        !isFinancialSavingsRecord(value.scope) ||
+        !hasExactFinancialSavingsFields(value.scope, ['kind', 'scopeId', 'scopeFingerprint']) ||
+        typeof value.scope.kind !== 'string' ||
+        !SCOPE_KINDS.has(value.scope.kind) ||
+        !isFinancialSavingsIdentity(value.scope.scopeId) ||
+        !isFinancialSavingsHash(value.scope.scopeFingerprint) ||
+        !Array.isArray(value.coordinates) ||
+        value.coordinates.length === 0 ||
+        value.coordinates.length > MAX_COORDINATES)
+        return false;
+    const coordinates = value.coordinates;
+    if (!coordinates.every(coordinate => isFinancialSavingsRecord(coordinate) &&
+        hasExactFinancialSavingsFields(coordinate, [
+            'coordinateId',
+            'periodRole',
+            'period',
+            'costBasis',
+            'estimateLens',
+            'chargeInclusionPolicyRef',
+            'currentSpendCompositionId',
+            'value',
+        ], ['requestedCurrencyCode']) &&
+        isFinancialSavingsHash(coordinate.currentSpendCompositionId) &&
+        isFinancialSurfaceCoordinateDefinitionV1(Object.fromEntries(Object.entries(coordinate).filter(([key]) => key !== 'value' && key !== 'currentSpendCompositionId'))) &&
+        isFinancialSurfaceMoneyV1(coordinate.value, coordinate.requestedCurrencyCode)) ||
+        new Set(coordinates.map(coordinate => coordinate.coordinateId)).size !== coordinates.length)
+        return false;
+    const projection = value;
+    const { projectionId: _projectionId, ...identity } = projection;
+    return projection.projectionId === createFinancialCurrentSpendSurfaceProjectionIdV1(identity);
+};