@spottoai/types-package 1.0.2-dev1138.2 → 1.0.2-dev1138.5

package/dist/esm/azure/financialAnalyticsValidation.js

@@ -30,6 +30,7 @@ const comparableCoordinate = (value) => ({
     estimateLens: value.estimateLens,
     requestedCurrencyCode: value.requestedCurrencyCode,
     accountingCurrency: value.accountingCurrency,
+    chargeInclusionPolicyRef: value.chargeInclusionPolicyRef,
 });
 const hasSameFinancialDimensions = (left, right) => canonicalizeFinancialDataflowJsonV1(comparableCoordinate(left)) === canonicalizeFinancialDataflowJsonV1(comparableCoordinate(right));
 const hasComparableTrendPeriods = (current, comparison) => {
@@ -105,16 +106,47 @@ const isInputIdentity = (value) => {
             return false;
         }
         dates.add(point.date);
+        const pointForecastFields = [
+            point.forecastEligibleAmount,
+            point.oneTimeAmount,
+            point.unknownRecurrenceAmount,
+        ];
+        if (!pointForecastFields.every(amount => isCanonicalExactMoney({ amount, currencyCode: coordinate.accountingCurrency.currencyCode })) ||
+            (point.forecastStatus !== 'available' && point.forecastStatus !== 'partial') ||
+            (point.forecastStatus === 'available'
+                ? point.forecastReasonCodes !== undefined || point.unknownRecurrenceAmount !== '0'
+                : !isReasonCodes(point.forecastReasonCodes))) {
+            return false;
+        }
         if (point.status === 'available') {
-            if (!hasFinancialDataflowExactFieldsV1(point, ['date', 'compositionId', 'status', 'amount']) ||
-                !isCanonicalExactMoney({ amount: point.amount, currencyCode: 'AUD' }))
+            if (!hasFinancialDataflowExactFieldsV1(point, [
+                'date',
+                'compositionId',
+                'status',
+                'amount',
+                'forecastEligibleAmount',
+                'oneTimeAmount',
+                'unknownRecurrenceAmount',
+                'forecastStatus',
+            ], ['forecastReasonCodes']) ||
+                !isCanonicalExactMoney({ amount: point.amount, currencyCode: coordinate.accountingCurrency.currencyCode }))
                 return false;
             availableDayCount += 1;
         }
         else {
             if (point.status !== 'partial' ||
-                !hasFinancialDataflowExactFieldsV1(point, ['date', 'compositionId', 'status', 'knownAmount', 'reasonCodes']) ||
-                !isCanonicalExactMoney({ amount: point.knownAmount, currencyCode: 'AUD' }) ||
+                !hasFinancialDataflowExactFieldsV1(point, [
+                    'date',
+                    'compositionId',
+                    'status',
+                    'knownAmount',
+                    'reasonCodes',
+                    'forecastEligibleAmount',
+                    'oneTimeAmount',
+                    'unknownRecurrenceAmount',
+                    'forecastStatus',
+                ], ['forecastReasonCodes']) ||
+                !isCanonicalExactMoney({ amount: point.knownAmount, currencyCode: coordinate.accountingCurrency.currencyCode }) ||
                 !isReasonCodes(point.reasonCodes))
                 return false;
             partialDayCount += 1;
@@ -174,7 +206,13 @@ export const canonicalizeFinancialAnalyticsInputIdentityV1 = (value) => {
         referenceCompositions: [...value.referenceCompositions].sort((left, right) => left.compositionId.localeCompare(right.compositionId)),
         points: [...value.points]
             .sort((left, right) => left.date.localeCompare(right.date))
-            .map(point => (point.status === 'partial' ? { ...point, reasonCodes: [...point.reasonCodes].sort() } : point)),
+            .map(point => ({
+            ...point,
+            ...(point.status === 'partial' ? { reasonCodes: [...point.reasonCodes].sort() } : {}),
+            ...(point.forecastReasonCodes === undefined
+                ? {}
+                : { forecastReasonCodes: [...point.forecastReasonCodes].sort() }),
+        })),
         gaps: [...value.gaps]
             .sort((left, right) => `${left.startDate}\u0000${left.endDateExclusive}`.localeCompare(`${right.startDate}\u0000${right.endDateExclusive}`))
             .map(gap => ({ ...gap, reasonCodes: [...gap.reasonCodes].sort() })),
@@ -191,6 +229,18 @@ export const isFinancialAnalyticsInputSeriesV1 = (value) => {
 };
 const nextCalendarDate = (value) => new Date(Date.parse(`${value}T00:00:00.000Z`) + 86400000).toISOString().slice(0, 10);
 const hasSameReasonCodes = (left, right) => left.length === right.length && left.every(reasonCode => right.includes(reasonCode));
+const hasSameForecastSlice = (point, composition) => {
+    const selection = composition.chargeSelection;
+    return selection !== undefined &&
+        point.forecastEligibleAmount === selection.forecastEligibleAmount &&
+        point.oneTimeAmount === selection.oneTimeAmount &&
+        point.unknownRecurrenceAmount === selection.unknownRecurrenceAmount &&
+        point.forecastStatus === selection.forecastStatus &&
+        (point.forecastReasonCodes === undefined
+            ? selection.forecastReasonCodes === undefined
+            : selection.forecastReasonCodes !== undefined &&
+                hasSameReasonCodes(point.forecastReasonCodes, selection.forecastReasonCodes));
+};
 /** Proves that every analytics point is an exact projection of its referenced daily composition. */
 export const isFinancialAnalyticsInputSeriesCompatibleV1 = (input, dailyCompositions) => {
     if (!isFinancialAnalyticsInputSeriesV1(input) ||
@@ -206,6 +256,7 @@ export const isFinancialAnalyticsInputSeriesCompatibleV1 = (input, dailyComposit
     return input.points.every(point => {
         const composition = compositionById.get(point.compositionId);
         if (composition === undefined ||
+            composition.amount.status === 'unavailable' ||
             composition.coordinate.periodRole !== 'current-spend' ||
             composition.coordinate.period.windowKind !== 'daily' ||
             composition.coordinate.period.requested.startDate !== point.date ||
@@ -214,11 +265,14 @@ export const isFinancialAnalyticsInputSeriesCompatibleV1 = (input, dailyComposit
             return false;
         }
         if (point.status === 'available') {
-            return composition.amount.status === 'available' && point.amount === composition.amount.amount;
+            return (composition.amount.status === 'available' &&
+                point.amount === composition.amount.amount &&
+                hasSameForecastSlice(point, composition));
         }
         return (composition.amount.status === 'partial' &&
             point.knownAmount === composition.amount.knownAmount &&
-            hasSameReasonCodes(point.reasonCodes, composition.amount.reasonCodes));
+            hasSameReasonCodes(point.reasonCodes, composition.amount.reasonCodes) &&
+            hasSameForecastSlice(point, composition));
     });
 };
 const isResult = (value, currency) => {

package/dist/esm/azure/financialAuthorityProjectionKernel.js

@@ -0,0 +1,159 @@
+import { FINANCIAL_AUTHORITY_RESOURCE_PROJECTION_CONTRACT_VERSION_V1, } from './financialAuthorityView.js';
+import { FINANCIAL_SAVINGS_RESOURCE_PROJECTION_CONTRACT_VERSION_V1, } from './financialSavingsAuthority.js';
+const normalize = (value) => value.trim().toLowerCase().replace(/\/+$/, '');
+/** Derives one compact, non-additive resource view from a validated canonical authority. */
+export const projectFinancialAuthorityResourceV1 = (authority, resourceType, scopeId) => {
+    const normalizedType = normalize(resourceType);
+    const normalizedScopeId = normalize(scopeId);
+    const coverage = authority.scopeCoverage.find(entry => normalize(entry.resourceType) === normalizedType && entry.scopeIds.some(candidate => normalize(candidate) === normalizedScopeId));
+    if (!coverage)
+        return undefined;
+    const coordinates = authority.coordinates.map(coordinate => {
+        const owners = coordinate.ownerBaselines.filter(baseline => normalize(baseline.scopeId) === normalizedScopeId);
+        const ownerBaseline = owners[0];
+        if (owners.length !== 1 || !ownerBaseline)
+            throw new TypeError('Financial authority resource owner is missing or ambiguous.');
+        const chargeComposition = ownerBaseline.status === 'available' && ownerBaseline.baselineKind === 'owner'
+            ? coordinate.chargeCompositions.find(composition => composition.baselineId === ownerBaseline.baselineId)
+            : undefined;
+        if (ownerBaseline.status === 'available' && ownerBaseline.baselineKind === 'owner' && !chargeComposition) {
+            throw new TypeError('Financial authority resource charge composition is missing.');
+        }
+        const displayRollups = coordinate.displayRollups.filter(rollup => normalize(rollup.displayScopeId) === normalizedScopeId);
+        const displayMemberships = new Set(displayRollups.flatMap(rollup => rollup.members.map(member => `${member.baselineId}\u0000${member.componentId}`)));
+        return {
+            coordinateId: coordinate.coordinateId,
+            periodRole: coordinate.periodRole,
+            period: coordinate.period,
+            costBasis: coordinate.costBasis,
+            estimateLens: coordinate.estimateLens,
+            ...(coordinate.requestedCurrencyCode === undefined ? {} : { requestedCurrencyCode: coordinate.requestedCurrencyCode }),
+            ownerBaseline,
+            ...(chargeComposition === undefined ? {} : { chargeComposition }),
+            componentDescriptors: coordinate.componentDescriptors.filter(descriptor => displayMemberships.has(`${descriptor.baselineId}\u0000${descriptor.componentId}`)),
+            displayRollups,
+            projections: coordinate.projections.filter(projection => normalize(projection.scopeId) === normalizedScopeId),
+        };
+    });
+    const firstCoordinate = coordinates[0];
+    if (!firstCoordinate)
+        throw new TypeError('Financial authority resource projection has no coordinates.');
+    const assessmentIds = new Set();
+    const bundleIds = new Set();
+    coordinates.forEach(coordinate => {
+        assessmentIds.add(coordinate.ownerBaseline.assessmentId);
+        if (coordinate.ownerBaseline.status === 'available' && coordinate.ownerBaseline.baselineKind === 'owner') {
+            bundleIds.add(coordinate.ownerBaseline.evidenceBundleId);
+        }
+        coordinate.projections.forEach(projection => {
+            if (projection.targetAssessmentId)
+                assessmentIds.add(projection.targetAssessmentId);
+            if (projection.targetEvidenceBundleId)
+                bundleIds.add(projection.targetEvidenceBundleId);
+        });
+    });
+    const evidenceAssessments = authority.evidenceAssessments.filter(assessment => assessmentIds.has(assessment.assessmentId));
+    evidenceAssessments.forEach(assessment => {
+        if (assessment.evidenceBundleId)
+            bundleIds.add(assessment.evidenceBundleId);
+    });
+    return {
+        contractVersion: FINANCIAL_AUTHORITY_RESOURCE_PROJECTION_CONTRACT_VERSION_V1,
+        authorityId: authority.authorityId,
+        provider: authority.provider,
+        providerAccountRefs: authority.providerAccountRefs,
+        artifactGeneration: authority.artifactGeneration,
+        billingGenerationId: authority.billingGenerationId,
+        resourceType: coverage.resourceType,
+        financialRole: coverage.financialRole,
+        scopeId: normalizedScopeId,
+        evidenceBundles: authority.evidenceBundles.filter(bundle => bundleIds.has(bundle.bundleId)),
+        evidenceAssessments,
+        coordinates: [firstCoordinate, ...coordinates.slice(1)],
+    };
+};
+/** Derives the matching compact savings view for one canonical resource owner. */
+export const projectFinancialSavingsResourceV1 = (savingsAuthority, financialProjection, financialAuthority) => {
+    if (savingsAuthority.financialAuthorityId !== financialProjection.authorityId ||
+        savingsAuthority.artifactGeneration.runId !== financialProjection.artifactGeneration.runId ||
+        savingsAuthority.artifactGeneration.generatedAt !== financialProjection.artifactGeneration.generatedAt) {
+        throw new TypeError('Financial savings authority is not bound to the resource Financial Authority projection.');
+    }
+    if (financialAuthority !== undefined &&
+        (financialAuthority.authorityId !== financialProjection.authorityId ||
+            financialAuthority.artifactGeneration.runId !== financialProjection.artifactGeneration.runId ||
+            financialAuthority.artifactGeneration.generatedAt !== financialProjection.artifactGeneration.generatedAt)) {
+        throw new TypeError('Full Financial Authority is not bound to the resource projection.');
+    }
+    const normalizedScopeId = normalize(financialProjection.scopeId);
+    const financialCoordinateIds = new Set(financialProjection.coordinates.map(coordinate => coordinate.coordinateId));
+    const savingsByCoordinateId = new Map(savingsAuthority.coordinates.map(coordinate => [coordinate.coordinateId, coordinate]));
+    if (financialCoordinateIds.size !== financialProjection.coordinates.length ||
+        savingsAuthority.coordinates.length !== financialProjection.coordinates.length ||
+        savingsAuthority.coordinates.some(coordinate => !financialCoordinateIds.has(coordinate.coordinateId))) {
+        throw new TypeError('Financial savings coordinates do not match the resource Financial Authority projection.');
+    }
+    const coordinates = financialProjection.coordinates.map(financialCoordinate => {
+        const coordinate = savingsByCoordinateId.get(financialCoordinate.coordinateId);
+        if (!coordinate)
+            throw new TypeError('Financial savings coordinate is missing.');
+        if (coordinate.status === 'unavailable')
+            return { ...coordinate };
+        const resourceContributions = coordinate.resourceContributions.filter(contribution => normalize(contribution.ownerScopeId) === normalizedScopeId);
+        if (resourceContributions.length > 1)
+            throw new TypeError('Financial savings resource contribution is ambiguous.');
+        const recommendationContributions = coordinate.recommendationContributions.filter(contribution => normalize(contribution.ownerScopeId) === normalizedScopeId);
+        const resourceContribution = resourceContributions[0];
+        const recommendationSavings = recommendationContributions.reduce((total, contribution) => {
+            const next = total + contribution.savingsMinorUnits;
+            if (!Number.isSafeInteger(next))
+                throw new TypeError('Financial savings recommendation contribution overflows safe minor units.');
+            return next;
+        }, 0);
+        if ((resourceContribution?.savingsMinorUnits ?? 0) !== recommendationSavings) {
+            throw new TypeError('Financial savings recommendation contributions do not reconcile to the resource contribution.');
+        }
+        const unavailableActivationIds = new Set(coordinate.status === 'partial'
+            ? coordinate.activations.filter(activation => activation.result === 'unavailable').map(activation => activation.scenarioId)
+            : []);
+        const authorityCoordinate = financialAuthority?.coordinates.find(candidate => candidate.coordinateId === financialCoordinate.coordinateId);
+        if (financialAuthority !== undefined && !authorityCoordinate) {
+            throw new TypeError('Full Financial Authority coordinate is missing for the resource projection.');
+        }
+        const unavailableScenarioIds = [...unavailableActivationIds]
+            .filter(scenarioId => {
+            if (!authorityCoordinate) {
+                // Without the full authority there is no proof that an absent target
+                // projection belongs elsewhere. Preserve the gap on this resource.
+                return true;
+            }
+            const scenarioProjections = authorityCoordinate.projections.filter(projection => projection.scenarioId === scenarioId);
+            return (scenarioProjections.length === 0 ||
+                scenarioProjections.some(projection => normalize(projection.scopeId) === normalizedScopeId));
+        })
+            .sort();
+        const composed = {
+            coordinateId: coordinate.coordinateId,
+            currentAggregateBaselineId: coordinate.currentAggregateBaselineId,
+            accountingCurrencyCode: coordinate.accountingCurrencyCode,
+            minorUnitScale: coordinate.minorUnitScale,
+            roundingMode: coordinate.roundingMode,
+            ...(resourceContribution === undefined ? {} : { resourceContribution }),
+            recommendationContributions,
+        };
+        return unavailableScenarioIds.length > 0
+            ? { ...composed, status: 'partial', unavailableScenarioIds: unavailableScenarioIds }
+            : { ...composed, status: 'available' };
+    });
+    const firstCoordinate = coordinates[0];
+    if (!firstCoordinate)
+        throw new TypeError('Financial savings resource projection has no coordinates.');
+    return {
+        contractVersion: FINANCIAL_SAVINGS_RESOURCE_PROJECTION_CONTRACT_VERSION_V1,
+        savingsAuthorityId: savingsAuthority.savingsAuthorityId,
+        financialAuthorityId: savingsAuthority.financialAuthorityId,
+        artifactGeneration: savingsAuthority.artifactGeneration,
+        scopeId: normalizedScopeId,
+        coordinates: [firstCoordinate, ...coordinates.slice(1)],
+    };
+};

package/dist/esm/azure/financialAuthorityViewValidation.js

@@ -5,6 +5,8 @@ import { isFinancialEvidenceAssessmentV1 } from './financialEvidenceAssessmentVa
 import { formatExactDecimalValue, multiplyExactDecimalValues, parseCanonicalDecimal, sumCanonicalDecimals } from '../common/exactDecimal.js';
 import { isFinancialBaselinePeriodV2, isFinancialEvidenceBundleV1, isFinancialScopeBaselineEnvelopeV2 } from './financialScopeBaselineValidation.js';
 import { isFinancialAuthorityComponentDescriptorV1, isFinancialDisplayRollupV1 } from './financialDisplayRollupValidation.js';
+import { AZURE_BILLED_ALL_CHARGES_POLICY_V1 } from './financialChargeComposition.js';
+import { isFinancialChargeCompositionV1 } from './financialChargeCompositionValidation.js';
 const SHA256_ID = /^sha256:[0-9a-f]{64}$/;
 const CURRENCY = /^[A-Z]{3}$/;
 const AZURE_RESOURCE_TYPE = /^[a-z0-9.-]+\/[a-z0-9._/-]+$/;
@@ -55,6 +57,7 @@ const canonicalCoordinatePreimage = (value) => ({
     ownerBaselines: [...value.ownerBaselines].sort((left, right) => left.scopeId.localeCompare(right.scopeId)),
     residualBaseline: value.residualBaseline,
     aggregateBaseline: value.aggregateBaseline,
+    chargeCompositions: [...value.chargeCompositions].sort((left, right) => left.baselineId.localeCompare(right.baselineId)),
     componentDescriptors: [...value.componentDescriptors].sort((left, right) => `${left.baselineId}\u0000${left.componentId}`.localeCompare(`${right.baselineId}\u0000${right.componentId}`)),
     displayRollups: [...value.displayRollups].sort((left, right) => left.displayRollupId.localeCompare(right.displayRollupId)),
     projections: [...value.projections].sort((left, right) => left.scenarioId.localeCompare(right.scenarioId)),
@@ -95,6 +98,7 @@ const isCoordinate = (value, coveredScopeIds, financialRoleByScope, providerAcco
             'ownerBaselines',
             'residualBaseline',
             'aggregateBaseline',
+            'chargeCompositions',
             'componentDescriptors',
             'displayRollups',
             'projections',
@@ -113,6 +117,9 @@ const isCoordinate = (value, coveredScopeIds, financialRoleByScope, providerAcco
         !value.ownerBaselines.every(isFinancialScopeBaselineEnvelopeV2) ||
         !isFinancialScopeBaselineEnvelopeV2(value.residualBaseline) ||
         !isFinancialScopeBaselineEnvelopeV2(value.aggregateBaseline) ||
+        !Array.isArray(value.chargeCompositions) ||
+        value.chargeCompositions.length > 20001 ||
+        !value.chargeCompositions.every(isFinancialChargeCompositionV1) ||
         !Array.isArray(value.componentDescriptors) ||
         value.componentDescriptors.length > 20000 ||
         !value.componentDescriptors.every(isFinancialAuthorityComponentDescriptorV1) ||
@@ -173,6 +180,38 @@ const isCoordinate = (value, coveredScopeIds, financialRoleByScope, providerAcco
     }
     if (coordinate.residualBaseline.status === 'available' && !bundleIds.has(coordinate.residualBaseline.evidenceBundleId))
         return false;
+    const composableBaselines = [...coordinate.ownerBaselines, coordinate.residualBaseline].filter((baseline) => baseline.status === 'available' && baseline.baselineKind === 'owner');
+    const chargeCompositionByBaselineId = new Map(coordinate.chargeCompositions.map(composition => [composition.baselineId, composition]));
+    if (chargeCompositionByBaselineId.size !== coordinate.chargeCompositions.length ||
+        coordinate.chargeCompositions.length !== composableBaselines.length)
+        return false;
+    for (const baseline of composableBaselines) {
+        const composition = chargeCompositionByBaselineId.get(baseline.baselineId);
+        if (composition === undefined ||
+            canonicalText(baseline.chargeInclusionPolicyRef) !== canonicalText(AZURE_BILLED_ALL_CHARGES_POLICY_V1.policyRef) ||
+            composition.ownerScopeId !== baseline.scopeId ||
+            periodText(composition.period) !== periodText(baseline.period) ||
+            composition.costBasis !== baseline.costBasis ||
+            composition.estimateLens !== baseline.estimateLens ||
+            composition.accountingCurrencyCode !== baseline.total.currencyCode ||
+            composition.reconciliation.sourceTotal !== baseline.total.amount)
+            return false;
+        const baselineComponentById = new Map(baseline.components.map(component => [component.componentId, component]));
+        const partitionedComponentIds = composition.buckets.flatMap(bucket => bucket.componentIds);
+        if (partitionedComponentIds.length !== baseline.components.length ||
+            new Set(partitionedComponentIds).size !== partitionedComponentIds.length ||
+            partitionedComponentIds.some(componentId => !baselineComponentById.has(componentId)))
+            return false;
+        for (const bucket of composition.buckets) {
+            try {
+                if (formatExactDecimalValue(sumCanonicalDecimals(bucket.componentIds.map(componentId => baselineComponentById.get(componentId).amount))) !== bucket.amount)
+                    return false;
+            }
+            catch {
+                return false;
+            }
+        }
+    }
     const financialOwnerBaselines = coordinate.ownerBaselines.filter(baseline => financialRoleByScope.get(baseline.scopeId) === 'owner');
     const availableMembers = [...financialOwnerBaselines, coordinate.residualBaseline]
         .filter(baseline => baseline.status === 'available')
@@ -256,7 +295,7 @@ const isCoordinate = (value, coveredScopeIds, financialRoleByScope, providerAcco
             (projection.targetEvidenceBundleId !== undefined && !bundleIds.has(projection.targetEvidenceBundleId)) ||
             (targetAssessment !== undefined &&
                 (targetAssessment.request.scopeId !== projection.scopeId ||
-                    targetAssessment.result !== 'available' ||
+                    (projection.status === 'available' && targetAssessment.result !== 'available') ||
                     targetAssessment.evidenceBundleId !== projection.targetEvidenceBundleId)) ||
             (projection.baselineId !== undefined && (owner.status !== 'available' || projection.baselineId !== owner.baselineId)) ||
             (projection.status === 'available' && owner.status !== 'available'))
@@ -328,6 +367,15 @@ const isCoordinate = (value, coveredScopeIds, financialRoleByScope, providerAcco
                             return false;
                         continue;
                     }
+                    if (projection.operationKind === 'replace-quantity-and-rate') {
+                        if (!('targetQuantity' in applied) || !('targetRate' in applied))
+                            return false;
+                        if (applied.targetQuantity.unit !== applied.targetRate.quantityUnit ||
+                            applied.targetRate.currencyCode !== projection.accountingCurrencyCode ||
+                            formatExactDecimalValue(multiplyExactDecimalValues(parseCanonicalDecimal(applied.targetQuantity.amount), parseCanonicalDecimal(applied.targetRate.amount))) !== applied.targetAmount)
+                            return false;
+                        continue;
+                    }
                     if (!('sourceRate' in applied) || !('targetQuantity' in applied) || component.effectiveRate === undefined)
                         return false;
                     if (applied.sourceRate.amount !== component.effectiveRate.amount ||
@@ -495,3 +543,158 @@ export const isFinancialAuthorityViewV1 = (value) => {
 export const isFinancialAuthorityViewBoundToArtifactGenerationV1 = (value, expected) => isFinancialAuthorityViewV1(value) &&
     value.artifactGeneration.runId === expected.runId &&
     value.artifactGeneration.generatedAt === expected.generatedAt;
+const isSameProviderAccountSet = (left, right) => {
+    if (left.length !== right.length)
+        return false;
+    const sortedLeft = [...left].sort();
+    const sortedRight = [...right].sort();
+    return sortedLeft.every((value, index) => value === sortedRight[index]);
+};
+const isResourceProjectionCoordinate = (value, projection, assessmentById, bundleIds) => {
+    if (!isRecord(value) ||
+        !hasExactFields(value, [
+            'coordinateId',
+            'periodRole',
+            'period',
+            'costBasis',
+            'estimateLens',
+            'ownerBaseline',
+            'componentDescriptors',
+            'displayRollups',
+            'projections',
+        ], ['requestedCurrencyCode', 'chargeComposition']) ||
+        !isHash(value.coordinateId) ||
+        (value.periodRole !== 'current' && value.periodRole !== 'previous') ||
+        !isFinancialBaselinePeriodV2(value.period) ||
+        typeof value.costBasis !== 'string' ||
+        !COST_BASES.has(value.costBasis) ||
+        typeof value.estimateLens !== 'string' ||
+        !ESTIMATE_LENSES.has(value.estimateLens) ||
+        (value.requestedCurrencyCode !== undefined && (typeof value.requestedCurrencyCode !== 'string' || !CURRENCY.test(value.requestedCurrencyCode))) ||
+        !isFinancialScopeBaselineEnvelopeV2(value.ownerBaseline) ||
+        (value.chargeComposition !== undefined && !isFinancialChargeCompositionV1(value.chargeComposition)) ||
+        !Array.isArray(value.componentDescriptors) ||
+        value.componentDescriptors.length > 20000 ||
+        !value.componentDescriptors.every(isFinancialAuthorityComponentDescriptorV1) ||
+        !Array.isArray(value.displayRollups) ||
+        value.displayRollups.length > 20000 ||
+        !value.displayRollups.every(isFinancialDisplayRollupV1) ||
+        !Array.isArray(value.projections) ||
+        value.projections.length > 20000 ||
+        !value.projections.every(isFinancialProjectionEnvelopeV1))
+        return false;
+    const coordinate = value;
+    const baseline = coordinate.ownerBaseline;
+    const assessment = assessmentById.get(baseline.assessmentId);
+    if (normalizeScopeId(baseline.scopeId) !== projection.scopeId ||
+        baseline.costBasis !== coordinate.costBasis ||
+        baseline.estimateLens !== coordinate.estimateLens ||
+        periodText(baseline.period) !== periodText(coordinate.period) ||
+        baseline.requestedCurrencyCode !== coordinate.requestedCurrencyCode ||
+        !isSameProviderAccountSet(baseline.providerAccountRefs, projection.providerAccountRefs) ||
+        !assessment ||
+        assessment.request.scopeId !== baseline.scopeId ||
+        assessment.request.scopeKind !== baseline.scopeKind ||
+        assessment.result !== baseline.status)
+        return false;
+    if (projection.financialRole === 'display-only' && (baseline.status !== 'unavailable' || baseline.unavailableReason !== 'unsupported-scope')) {
+        return false;
+    }
+    if (projection.financialRole === 'unclassified' && (baseline.status !== 'unavailable' || baseline.unavailableReason !== 'ownership-unresolved')) {
+        return false;
+    }
+    if (baseline.status !== 'available' || baseline.baselineKind !== 'owner') {
+        return (coordinate.chargeComposition === undefined &&
+            coordinate.componentDescriptors.length === 0 &&
+            coordinate.displayRollups.length === 0 &&
+            coordinate.projections.every(projectionValue => normalizeScopeId(projectionValue.scopeId) === projection.scopeId) &&
+            new Set(coordinate.projections.map(projectionValue => projectionValue.scenarioId)).size === coordinate.projections.length);
+    }
+    if (baseline.scopeKind !== 'canonical-resource-owner' && baseline.scopeKind !== 'composite-resource')
+        return false;
+    if (!bundleIds.has(baseline.evidenceBundleId) || assessment.evidenceBundleId !== baseline.evidenceBundleId)
+        return false;
+    const composition = coordinate.chargeComposition;
+    if (!composition ||
+        composition.baselineId !== baseline.baselineId ||
+        normalizeScopeId(composition.ownerScopeId) !== projection.scopeId ||
+        periodText(composition.period) !== periodText(baseline.period) ||
+        composition.costBasis !== baseline.costBasis ||
+        composition.estimateLens !== baseline.estimateLens ||
+        composition.accountingCurrencyCode !== baseline.total.currencyCode ||
+        composition.reconciliation.sourceTotal !== baseline.total.amount)
+        return false;
+    const componentKeys = new Set(baseline.components.map(component => `${baseline.baselineId}\u0000${component.componentId}`));
+    const descriptorKeys = coordinate.componentDescriptors.map(descriptor => `${descriptor.baselineId}\u0000${descriptor.componentId}`);
+    if (descriptorKeys.length !== componentKeys.size ||
+        new Set(descriptorKeys).size !== descriptorKeys.length ||
+        descriptorKeys.some(key => !componentKeys.has(key)) ||
+        coordinate.displayRollups.some(rollup => normalizeScopeId(rollup.displayScopeId) !== projection.scopeId ||
+            rollup.members.some(member => !componentKeys.has(`${member.baselineId}\u0000${member.componentId}`))) ||
+        coordinate.projections.some(projectionValue => normalizeScopeId(projectionValue.scopeId) !== projection.scopeId))
+        return false;
+    const rolledUpKeys = coordinate.displayRollups.flatMap(rollup => rollup.members.map(member => `${member.baselineId}\u0000${member.componentId}`));
+    return (rolledUpKeys.length === componentKeys.size &&
+        new Set(rolledUpKeys).size === rolledUpKeys.length &&
+        rolledUpKeys.every(key => componentKeys.has(key)) &&
+        new Set(coordinate.projections.map(projectionValue => projectionValue.scenarioId)).size === coordinate.projections.length);
+};
+/** Strictly validates one bounded, non-additive resource projection without requiring the full authority ledger. */
+export const isFinancialAuthorityResourceProjectionV1 = (value) => {
+    if (!isRecord(value) ||
+        !hasExactFields(value, [
+            'contractVersion',
+            'authorityId',
+            'provider',
+            'providerAccountRefs',
+            'artifactGeneration',
+            'billingGenerationId',
+            'resourceType',
+            'financialRole',
+            'scopeId',
+            'evidenceBundles',
+            'evidenceAssessments',
+            'coordinates',
+        ]) ||
+        value.contractVersion !== 'financial-authority-resource-projection/v1' ||
+        !isHash(value.authorityId) ||
+        value.provider !== 'azure' ||
+        !Array.isArray(value.providerAccountRefs) ||
+        value.providerAccountRefs.length === 0 ||
+        value.providerAccountRefs.length > 64 ||
+        !value.providerAccountRefs.every(isIdentity) ||
+        new Set(value.providerAccountRefs).size !== value.providerAccountRefs.length ||
+        !isRecord(value.artifactGeneration) ||
+        !hasExactFields(value.artifactGeneration, ['runId', 'generatedAt']) ||
+        !isIdentity(value.artifactGeneration.runId) ||
+        !isIsoInstant(value.artifactGeneration.generatedAt) ||
+        !isIdentity(value.billingGenerationId) ||
+        typeof value.resourceType !== 'string' ||
+        !AZURE_RESOURCE_TYPE.test(value.resourceType) ||
+        value.resourceType !== normalizeScopeId(value.resourceType) ||
+        (value.financialRole !== 'owner' && value.financialRole !== 'display-only' && value.financialRole !== 'unclassified') ||
+        !isIdentity(value.scopeId) ||
+        value.scopeId !== normalizeScopeId(value.scopeId) ||
+        !Array.isArray(value.evidenceBundles) ||
+        value.evidenceBundles.length > 20000 ||
+        !value.evidenceBundles.every(isFinancialEvidenceBundleV1) ||
+        !Array.isArray(value.evidenceAssessments) ||
+        value.evidenceAssessments.length > 20000 ||
+        !value.evidenceAssessments.every(isFinancialEvidenceAssessmentV1) ||
+        !Array.isArray(value.coordinates) ||
+        value.coordinates.length === 0 ||
+        value.coordinates.length > 128)
+        return false;
+    const projection = value;
+    const bundleIds = new Set(projection.evidenceBundles.map(bundle => bundle.bundleId));
+    const assessmentById = new Map(projection.evidenceAssessments.map(assessment => [assessment.assessmentId, assessment]));
+    if (bundleIds.size !== projection.evidenceBundles.length || assessmentById.size !== projection.evidenceAssessments.length)
+        return false;
+    if (projection.evidenceAssessments.some(assessment => (assessment.evidenceBundleId !== undefined && !bundleIds.has(assessment.evidenceBundleId)) ||
+        !isSameProviderAccountSet(assessment.request.providerAccountRefs, projection.providerAccountRefs) ||
+        normalizeScopeId(assessment.request.scopeId) !== projection.scopeId) ||
+        !projection.coordinates.every(coordinate => isResourceProjectionCoordinate(coordinate, projection, assessmentById, bundleIds)) ||
+        new Set(projection.coordinates.map(coordinate => coordinate.coordinateId)).size !== projection.coordinates.length)
+        return false;
+    return true;
+};

package/dist/esm/azure/financialChargeComposition.js

@@ -0,0 +1,36 @@
+import { sha256Utf8 } from '../common/sha256.js';
+export const FINANCIAL_CHARGE_COMPOSITION_SCHEMA_VERSION_V1 = 1;
+export const FINANCIAL_CHARGE_COMPOSITION_CONTRACT_VERSION_V1 = 'financial-charge-composition/v1';
+export const FINANCIAL_CHARGE_INCLUSION_POLICY_CONTRACT_VERSION_V1 = 'financial-charge-inclusion-policy/v1';
+const createRegisteredPolicy = (definition) => {
+    const { policyId, ...policy } = definition;
+    const registered = {
+        ...policy,
+        includeSources: Object.freeze([...policy.includeSources]),
+        excludeSources: Object.freeze([...policy.excludeSources]),
+        withholdSources: Object.freeze([...policy.withholdSources]),
+        policyRef: Object.freeze({ policyId, policyDigest: `sha256:${sha256Utf8(JSON.stringify(definition))}` }),
+    };
+    return Object.freeze(registered);
+};
+export const AZURE_BILLED_ALL_CHARGES_POLICY_V1 = createRegisteredPolicy({
+    schemaVersion: 1,
+    contractVersion: FINANCIAL_CHARGE_INCLUSION_POLICY_CONTRACT_VERSION_V1,
+    policyId: 'azure-billed-all-charges/v1',
+    includeSources: ['azure-native', 'marketplace', 'unknown'],
+    excludeSources: [],
+    withholdSources: [],
+});
+export const AZURE_CLOUD_SERVICES_EXCLUDING_MARKETPLACE_POLICY_V1 = createRegisteredPolicy({
+    schemaVersion: 1,
+    contractVersion: FINANCIAL_CHARGE_INCLUSION_POLICY_CONTRACT_VERSION_V1,
+    policyId: 'azure-cloud-services-excluding-marketplace/v1',
+    includeSources: ['azure-native'],
+    excludeSources: ['marketplace'],
+    withholdSources: ['unknown'],
+});
+export const FINANCIAL_CHARGE_INCLUSION_POLICIES_V1 = Object.freeze([
+    AZURE_BILLED_ALL_CHARGES_POLICY_V1,
+    AZURE_CLOUD_SERVICES_EXCLUDING_MARKETPLACE_POLICY_V1,
+]);
+export const resolveFinancialChargeInclusionPolicyV1 = (policyRef) => policyRef !== null && typeof policyRef === 'object' && FINANCIAL_CHARGE_INCLUSION_POLICIES_V1.find(policy => policy.policyRef.policyId === policyRef.policyId && policy.policyRef.policyDigest === policyRef.policyDigest) || undefined;

package/dist/esm/azure/financialChargeCompositionKernel.js

@@ -0,0 +1,48 @@
+import { formatExactDecimalValue, sumCanonicalDecimals } from '../common/exactDecimal.js';
+import { FINANCIAL_CHARGE_COMPOSITION_CONTRACT_VERSION_V1, FINANCIAL_CHARGE_COMPOSITION_SCHEMA_VERSION_V1, } from './financialChargeComposition.js';
+import { createFinancialChargeCompositionIdV1 } from './financialChargeCompositionValidation.js';
+const bucketKey = (component) => `${component.chargeSource}\u0000${component.chargeRecurrence}\u0000${component.chargeClassification}`;
+export const createFinancialChargeCompositionV1 = (request) => {
+    if (!Array.isArray(request.components) || request.components.length === 0 || request.components.length > 20000) {
+        throw new TypeError('Financial charge composition requires a bounded non-empty component collection.');
+    }
+    if (new Set(request.components.map(component => component.componentId)).size !== request.components.length) {
+        throw new TypeError('Financial charge composition cannot classify one component more than once.');
+    }
+    const groups = new Map();
+    for (const component of request.components) {
+        const key = bucketKey(component);
+        const group = groups.get(key);
+        if (group)
+            group.push(component);
+        else
+            groups.set(key, [component]);
+    }
+    const buckets = [...groups.values()]
+        .map(group => ({
+        chargeSource: group[0].chargeSource,
+        chargeRecurrence: group[0].chargeRecurrence,
+        chargeClassification: group[0].chargeClassification,
+        amount: formatExactDecimalValue(sumCanonicalDecimals(group.map(component => component.amount))),
+        componentIds: [...new Set(group.map(component => component.componentId))].sort(),
+        evidenceRefIds: [...new Set(group.flatMap(component => component.evidenceRefIds))].sort(),
+    }))
+        .sort((left, right) => `${left.chargeSource}\u0000${left.chargeRecurrence}\u0000${left.chargeClassification}`.localeCompare(`${right.chargeSource}\u0000${right.chargeRecurrence}\u0000${right.chargeClassification}`));
+    const bucketTotal = formatExactDecimalValue(sumCanonicalDecimals(buckets.map(bucket => bucket.amount)));
+    if (bucketTotal !== request.sourceTotal)
+        throw new TypeError('Financial charge composition does not reconcile to its source total.');
+    const identity = {
+        schemaVersion: FINANCIAL_CHARGE_COMPOSITION_SCHEMA_VERSION_V1,
+        contractVersion: FINANCIAL_CHARGE_COMPOSITION_CONTRACT_VERSION_V1,
+        baselineId: request.baselineId,
+        ownerScopeId: request.ownerScopeId,
+        period: request.period,
+        costBasis: request.costBasis,
+        estimateLens: request.estimateLens,
+        accountingCurrencyCode: request.accountingCurrencyCode,
+        buckets,
+        reconciliation: { status: 'reconciled', bucketTotal, sourceTotal: request.sourceTotal, difference: '0' },
+        algorithmVersion: request.algorithmVersion,
+    };
+    return { ...identity, chargeCompositionId: createFinancialChargeCompositionIdV1(identity) };
+};